artifacts/standard-named

J.0 Runbook

artifacts/standard-named/20260715__TELIC-FIELDS__RUNBOOK__WORKING__J-0__reference-implementation-and-pilot-harness.md

Rendered from markdown source. Open raw source on GitHub.

J.0 Runbook

Requirements

  • Python 3.11 or newer
  • jsonschema

Install:

python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt

Run the deterministic demonstration

./scripts/run_demo.sh

Outputs:

demo/run/pilot.sqlite3
exports/tf-mvi-1-witness.zip

Verify the witness independently

PYTHONPATH=src python3 -m telic_j0.cli verify exports/tf-mvi-1-witness.zip

Expected result:

valid: true
failed_gate: true
valid_action: true
consequence_return: true
correction_propagation: true
retirement_revocation: true

Run all tests

./scripts/run_tests.sh

This executes:

  • event identity and hash-chain tests;
  • reference-scenario integration tests;
  • participant-correction propagation tests;
  • external-gate tests;
  • local web-interface smoke tests;
  • ten cross-branch threat cases;
  • independent witness verification.

Run the local web interface

./scripts/serve_demo.sh

Open http://127.0.0.1:8765.

The page exposes stepwise controls for:

  • field seeding;
  • model summary;
  • participant correction;
  • route generation and gating;
  • authorized execution;
  • consequence observation;
  • retirement.

Read-only JSON endpoints:

/api/status
/api/events
/api/objects
/api/witness

Reset a demonstration

Remove the selected work directory:

rm -rf demo/run

Then rerun the demo.

Inspect the local state

PYTHONPATH=src python3 -m telic_j0.cli inspect --workdir demo/run

Safety boundary

Do not connect this reference package to production calendars, clinical systems, employment scheduling, benefits systems, financial accounts, or public decision infrastructure.