Core Quickstart

This guide gets a developer from a clean machine to a working DigiEmu Core CLI.

1. Clone Core

git clone https://github.com/DigiEmu/core.git
Set-Location .\core

go version

go test ./...

Do not continue with a local build if the test suite fails.

go build -o digiemu.exe ./cmd/digiemu

Confirm that the executable exists:

Get-Item .\digiemu.exe

.\digiemu.exe --help

The stable v1 verification interface accepts an explicit bundle path:

.\digiemu.exe verify `
    --bundle "<bundle-path>" `
    --json

A verification JSON result exposes fields including:

ok
ref
expected
got
hash_alg
canonical_scope
trace
message

.\digiemu.exe replay `
    --bundle "<bundle-path>" `
    --json

For the same fixed bundle, replay is intended to preserve deterministic state reconstruction and deterministic trace ordering.

This step is optional and uses experimental functionality.

go run ./cmd/digiemu `
    experimental conformance run `
    testdata/core_2_conformance

Expected summary:

Conformance run summary: total=11 passed=11 failed=0

JSON:

go run ./cmd/digiemu `
    experimental conformance run `
    testdata/core_2_conformance `
    --json

At this point you have: