Forge Platform

Handbook

Vertical demo — Self-Host Alpha (foundation + gap register)

Two allowlisted actions exercised on real forge-platform checkouts. Run with absolute --run-dir under …/.forge/runs// so selfhost_runner.py can infer --platform-root.

Vertical A — check_foundation

  1. Ensure a run directory exists (example: copy sprints/selfhost-alpha/fixtures/frun_selfhost_demo_001 to forge-platform/.forge/runs/frun_selfhost_demo_001).
  2. Approve local_runner:check_foundation in approvals/<appr_*.json> with state: approved.
  3. Execute:
cd /home/lzvyahin/Code/forge-platform
python3 scripts/selfhost_runner.py \
  --run-dir /home/lzvyahin/Code/forge-platform/.forge/runs/frun_selfhost_demo_001 \
  --approval-id appr_selfhost_demo_001 \
  --action-id check_foundation
python3 scripts/selfhost_import_evidence.py \
  --run-dir /home/lzvyahin/Code/forge-platform/.forge/runs/frun_selfhost_demo_001
  1. Lenses: set workspace to the parent of .forge (here: forge-platform), open Studio → Forge run frun_selfhost_demo_001 → confirm EvidencePacket and local-runner/result.json surfaced.

Vertical B — generate_contract_gap_register (S6 / architecture–BA follow-on)

  1. Fixture: sprints/selfhost-alpha/fixtures/frun_selfhost_gap_001 (approval appr_gap_register_001, action local_runner:generate_contract_gap_register). Copy to .forge/runs/frun_selfhost_gap_001.
  2. Run:
cd /home/lzvyahin/Code/forge-platform
python3 scripts/selfhost_runner.py \
  --run-dir /home/lzvyahin/Code/forge-platform/.forge/runs/frun_selfhost_gap_001 \
  --approval-id appr_gap_register_001 \
  --action-id generate_contract_gap_register
python3 scripts/selfhost_import_evidence.py \
  --run-dir /home/lzvyahin/Code/forge-platform/.forge/runs/frun_selfhost_gap_001
  1. Artifacts: local-runner/contract_gap_register.md plus updated evidence/evidence_packet.json and forge_run.json timestamps. Sparks: static packet lists SPARK-ARCH-GAP-TRIAGE and SPARK-BA-ACCEPTANCE-GAPS; importer appends SPARK-IMPORTED-FROM-RUN when merging runner result.

CI / static chain

  • Correlated samples: sprints/selfhost-alpha/samples/ validated by scripts/validate_selfhost_chain.py (invoked from check_foundation).