engineering/arborist
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
arborist/docs
History
russell@unturf.com 21c634b422
docs: clear phantom-doc refs in TICKETS.md + CLAUDE.md (bb6a89c cleanup propagation) 
fox's commit `bb6a89c` (2026-05-09, "30% reduction") deleted
seven docs but the indexes weren't updated to remove the dangling
references. End-of-session sweep caught + cleared:

== Phantom refs in TICKETS.md "Distinction from other docs" ==

5 dangling references to deleted docs:

  - concept-relations-design.md  → deleted in bb6a89c
  - mesh-deploy.md               → deleted in bb6a89c
  - self-reference-design.md     → deleted in bb6a89c
  - verifier-semantic-gap-design.md → deleted in bb6a89c
  - qa-modes-bench-2026-04-30.md → deleted in bb6a89c

Replaced with the high-value arch docs fox's bb6a89c commit
message explicitly named as kept:

  - seven-point-program.md (north-star directive)
  - cti-architecture.md (kept)
  - mesh.md (mesh-deploy removed; mesh.md kept)
  - benchmarks.md (operational; kept per commit message)
  - bench-maxing.md (operational; kept)
  - qa-modes-bench.md (rolling addenda — distinct from the
    dated -2026-04-30 file that was deleted)
  - soft-hash-channel-analysis.md (#000018 closure)
  - soft-hash-channel-t3-bound.md (#000036 derivation)
  - tool-action-dag-design.md (already present; kept)

== Phantom refs in CLAUDE.md `## Docs index` ==

5 dangling references (one of them duplicated — fox typo'd
self-reference-design.md on two consecutive lines with the
same description):

  - mesh-deploy.md
  - qa-modes-bench-2026-04-30.md
  - bench-emergent-design.md
  - verifier-semantic-gap-design.md
  - self-reference-design.md (duplicate entry)

Replaced with current arch docs:

  - mesh.md (mesh wire + group-key)
  - soft-hash-channel-analysis.md + soft-hash-channel-t3-bound.md
  - calculator-test-patterns.md (#000044 sister discipline)
  - spec-methodology.md (#000019)
  - v7w-frontier-catalog.md (#000013)
  - v8-fork-score.md (#000012)
  - pi-star-composition.md (#000015)

== Inline ref in CLAUDE.md §"Retrieval pipeline" ==

L328 cited `docs/concept-relations-design.md` for the
1.6%-storage-tax rationale. Doc deleted; rationale now lives
inline in `arborist/concepts/extract.py` + the data is
self-describing. Updated the prose to note the deletion +
where the design now lives.

== Why this matters ==

A phantom doc reference is the doc-index equivalent of a stale
phase descriptor — it sends future readers to a file that
doesn't exist. Same root cause as today's §-status drift
(in-progress prose freezing while load-bearing surface updates).
The bb6a89c commit was thorough about deletion but didn't
sweep the indexes; this commit closes that loop.

Hygiene: doc-only commit, no schema, no tests touched. Full
suite 2347 passed + 37 skipped earlier; 60 active AUTOCOUNT
claims still clean (3 passed in 2.80s).
2026-05-10 19:44:23 -04:00
..
_source #000012 Phase 1b: Merkle-AGI v8 consensus paper landed 2026-05-10 16:12:00 -04:00
diagrams docs/diagrams: rename aborist-modules → arborist-modules (post-rename cleanup) 2026-05-08 07:50:28 -04:00
tickets docs: #000045 §4 sweep-swap closure + cookbook prometheus_audit 22→25 2026-05-10 19:37:20 -04:00
bench-maxing.md aborist/arborist 2026-05-07 09:31:49 -04:00
benchmarks.md aborist/arborist 2026-05-07 09:31:49 -04:00
calculator-test-patterns.md docs/calculator-test-patterns: 3 new patterns from π* kernel work + 4 exemplar files 2026-05-10 16:33:19 -04:00
cti-architecture.md aborist/arborist 2026-05-07 09:31:49 -04:00
mesh.md aborist/arborist 2026-05-07 09:31:49 -04:00
pi-star-composition.md pi_star: land ticket #000015 (π* domain library + composition algebra) 2026-05-07 16:51:33 -04:00
qa-modes-bench.md aborist/arborist 2026-05-07 09:31:49 -04:00
seven-point-program.md tests/doc_counts: regression test for numeric claims in docs/ (4x drift fix) 2026-05-10 16:15:52 -04:00
soft-hash-channel-analysis.md tests/doc_counts: regression test for numeric claims in docs/ (4x drift fix) 2026-05-10 16:15:52 -04:00
soft-hash-channel-t3-bound.md soft-hash T3 bound: pre-review polish pass for external cryptographer 2026-05-10 15:59:16 -04:00
spec-methodology.md docs: land ticket #000019 (spec methodology for π*, V, policy fields) 2026-05-07 16:53:28 -04:00
TICKETS.md docs: clear phantom-doc refs in TICKETS.md + CLAUDE.md (bb6a89c cleanup propagation) 2026-05-10 19:44:23 -04:00
tool-action-dag-design.md docs: add tool-action-dag-design.md research path (pre-ticket) 2026-05-07 19:47:50 -04:00
v7w-frontier-catalog.md #000013 closed: v7-W spatial-temporal substrate paper + namespace 2026-05-09 15:00:05 -04:00
v8-fork-score.md CLI: arborist v8 score → arborist substrate score 2026-05-10 09:12:34 -04:00
warrant-substrate-cookbook.md docs: #000045 §4 sweep-swap closure + cookbook prometheus_audit 22→25 2026-05-10 19:37:20 -04:00
zk-frontier-bench.md #000016 parked: ZK frontier-proof bench plan + wire protocol 2026-05-09 15:05:08 -04:00
zk-wire-protocol.md #000016 parked: ZK frontier-proof bench plan + wire protocol 2026-05-09 15:05:08 -04:00