arborist/docs
russell@unturf.com 292e49e18f
docs(ticket-000001): append architectural review (Asia/Kuala_Lumpur, 2026-05-01)
Fox-supplied review expanding §2-§4 with axiomatic framing, CTI /
Merkle-AGI / PROMETHEUS-Σ interpretations, a concrete implementation
diff, and a strengthened test list. Captured verbatim as Appendix A.

Key refinements over the §2-§4 sketch:

- Splits retrieval-stage hash into retrieval_plan_hash +
  retrieval_result_hash + retrieval_stage_hash (plan vs result
  separation, axiomatically cleaner than embedding plan in the
  retrieval-stage payload directly).

- Adds two new audit events: retrieval_plan_built and
  retrieval_result_selected. Surfaces the retrieval inputs in the
  audit chain (not just the run_dag), so cache-hits also commit
  the plan via cache_hit_with_retrieval_plan.

- Distinguishes three keyword-handling cases for cache identity
  (Case A/B/C) and lays out a clean boundary rule: keywords stay
  in retrieval_plan unless they reach the model (then prompt_hash)
  or affect routing policy (then retrieval_policy_hash).

- Promotes 'the map must be committed, not only the territory
  reached' as a core principle. Operator-supplied maps (keywords,
  routing modes, ranking policies) become first-class clauses
  upstream of retrieval_result.

- Lists 12 concrete tests including the critical 'same sources,
  different keywords → different run_dag_root' assertion that
  proves the gap is closed.

Header note: Appendix A is authoritative when it disagrees with
§2-§4 above. The original §2-§4 sketch stays in place for
chronological context but is superseded by the appendix.
2026-05-01 12:22:16 -04:00
..
diagrams docs: mesh multiplayer protocol with dot diagrams 2026-04-28 12:54:36 -04:00
cti-architecture.md arch: layer-cake docs + verifier_policy_hash + old-maps principle 2026-05-01 12:10:29 -04:00
mesh-deploy.md docs: mesh-deploy runbook for two-host gossip setup 2026-04-28 17:24:37 -04:00
mesh.md docs: mesh multiplayer protocol with dot diagrams 2026-04-28 12:54:36 -04:00
naming-deferral.md arch: layer-cake docs + verifier_policy_hash + old-maps principle 2026-05-01 12:10:29 -04:00
qa-modes-bench-2026-04-30.md docs(qa): final stop-sequence bench row, day-journey net summary 2026-04-30 16:32:41 -04:00
self-reference-distillation-design.md arch: layer-cake docs + verifier_policy_hash + old-maps principle 2026-05-01 12:10:29 -04:00
self-reference-thought-chains-design.md qa: self-reference thought chains — STRICT-as-fact substrate 2026-05-01 10:16:47 -04:00
test-coverage-audit-2026-05-01.md arch: layer-cake docs + verifier_policy_hash + old-maps principle 2026-05-01 12:10:29 -04:00
ticket-000001-retrieval-keywords-audit-gap.md docs(ticket-000001): append architectural review (Asia/Kuala_Lumpur, 2026-05-01) 2026-05-01 12:22:16 -04:00
TICKETS.md docs: formalize ticket convention; rename retrieval-keywords gap to #000001 2026-05-01 12:09:00 -04:00
verifier-semantic-gap-design.md docs(qa): design proposal for verifier semantic-gap NLI sidecar 2026-04-30 19:50:05 -04:00