CLI Reference
Current release verification
git clone https://github.com/blackmore-technology-group/ENTITY.git cd ENTITY git checkout v3.4.3 python -m pip install -r requirements.txt python -m compileall -q src sdk protocol python -m unittest discover -s tests -v
The signed v3.4.3 tag resolves to release commit 528b70aabd05b1e930b77e4933f157731e47274f. For an immutable automation target, pin that tag or exact commit rather than moving main.
BTDU CLI
python tools/entity_btdu_cli.py \ --entity-state STATE \ --btdu-state BTDU_STATE \ --adam-root ADAM_ROOT \ --git-bin git \ COMMAND
| Command | Purpose |
|---|---|
init | Materialize primitive-byte universe and deep-verify BTDU state. |
status | Verify/report current BTDU state without mutation. |
ingest-repo PATH --provenance REF | Ingest a Git repository under an ENTITY-signed BTDU_WRITE authorization receipt and return a repository manifest. |
context OBJECT_REF | Project bounded context for a governed BTDU object. |
reconstruct OBJECT_REF OUTPUT | Reconstruct exact object bytes and report SHA-256. |
mirror-genesis | Mirror Genesis market lineage into BTDU without creating ownership/entitlement. |
Required arguments
--entity-state must contain the sovereign Entity manifest/key state used for authorization. --btdu-state is mutable BTDU/ADAM state. --adam-root points to the ADAM runtime. Operators should explicitly understand which Entity identity authorizes mutation.
Historical reproduction
Use git checkout v3.4.2 only when reproducing a specifically sealed v3.4.2 campaign or artifact. Do not use that historical checkout as the general current-runtime instruction.
Exit discipline
Treat authorization, signature, reconstruction or root mismatch as a failed operation. Do not “work around” a failed verifier during qualification.