Section 02 — consumer-shim-and-version-pin
Goal
Shrink the consumer-side /sync-from-orilang to a thin shim and add a consumer version pin (completes fixes B; mirrors the plan-corpus version-pin precedent).
Implementation Sketch
The shim carries NO engine logic. It resolves the canonical root (ORI_LANG_SOURCE env override -> default ~/projects/ori_lang, reusing the existing manifest canonical_source_env + the intel-query.sh MAIN_ROOT pattern) and delegates to harness_dist apply --target $PWD --root <root>. The pin records harness-schema vN @
Spec References
skill-control-contract.md (thin shim = tool role); state-discipline.md (consumer pin shape); plan-corpus-version.json precedent.
Work Items
- Author the thin consumer /sync-from-orilang shim (~5 lines): resolve ORI_LANG_SOURCE, exec
harness_dist apply --target $PWD --root <root>; no engine logic, no manifest, no regex. - version.py: stamp a harness-schema version + write the consumer pin (.claude/.sync-ref/harness-version.json) recording schema version + source SHA, mirroring plan-corpus-version.json.
- Schema-mismatch handling: the engine migrates or refuses on a stale pin; never silently half-applies.
- pytest: a fresh sync records sha+version; a mismatched pin refuses or migrates deterministically.
Fresh intel (regenerated)
{ “schema_version”: 1, “target”: { “kind”: “plan-section”, “ref”: “harness-distribution/s-dbe981cd” }, “generated_at”: “2026-06-22T15:10:13.630615+00:00”, “graph_state”: { “head_sha”: “6809a0f2”, “last_code_import_at”: “2026-06-22T14:30:10.18Z”, “embedding_stale”: true, “insights_stale”: false, “cpg_stale”: false }, “surfaces”: {}, “summary”: “intel-package[plan-section:harness-distribution/s-dbe981cd] agent-authored dossier”, “degraded”: false, “dossier”: { “objective_symbols”: [], “tiers”: {}, “agent_authored”: true, “difficulty”: { “class”: “routine”, “research_online”: false, “research_mode”: “auto”, “signals”: [], “plan_dir”: “/home/eric/projects/ori_lang/plans/harness-distribution” } } }
(full dossier: consumer-shim-and-version-pin—s-dbe981cd.intel.json)