arborist/docs
russell@unturf.com e391f1f01c
#000049: expand — where would the NLI weights live? (§2.4 provenance & distribution)
fox asked: JIT-trained, gossip-pulled, or repo-embedded?

Added §2.4 — three shapes, two dead ends:
- JIT-trained per deployment:  — GPU-hours over MNLI/SNLI/ANLI, not
  a per-deployment step; non-deterministic across runs → different
  audit_mode → breaks the verifier's reproducibility invariant.
  "Training" is a one-time act by someone; the distributed thing is
  the resulting fixed blob, not the recipe.
- Embedded in the git repo as data:  — a few-hundred-MB binary in
  .git blows the standing "fresh clone = python3.12 + venv + sqlite3"
  invariant; Git LFS adds a dep and still bloats; the repo is source
  + tiny fixtures + docs, not a model registry.
- One-time obtained, content-addressed, fetched on demand, mesh-
  distributable: ✓ — the repo carries a tiny manifest
  (arborist/qa/nli/manifest.json: {checkpoint_sha256, source_url,
  license, nli_model_version}); the weights live under
  ~/.arborist/models/nli/<hash>/, fetched on first use (make
  fetch-nli or auto-fetch on first --enable-nli query) with the
  sha256 verified fail-closed against the manifest; nli_model_version
  folds into governance_policy_hash (a swap stales the cache, like
  chunking_version / canonicalization_version), keeping audit_mode a
  deterministic function of (answer, source, policy, pinned hash);
  and once arborist's mesh grows blob-sync, a deployment with peers
  pulls the checkpoint from a peer (AXFR-style, like ClouDNS slaves
  pulling a zone, like a shard rehydrating from snapshot.db) instead
  of the origin URL — content-addressing makes peer-pull and
  origin-pull interchangeable, the mesh is the optimization not the
  canonical source, cold start falls back to origin. Source: a
  published off-the-shelf NLI checkpoint (MIT/Apache, recorded) or a
  one-time fox/blackops-trained-and-published one.

Bottom line: not JIT-trained, not repo-embedded weights — a
content-addressed hash-pinned checkpoint, manifest in the repo,
weights under ~/.arborist/, fetched on demand (origin or peer), hash
in governance_policy_hash. Precedents cited: the textbook manifest
(pointers + licenses not texts), the [vec] extra (fastembed's
bge-small fetched not committed — #000039), ~/.arborist/ operator-
state, docs/mesh.md + snapshot rehydrate. All presupposes the §2.2/§5
discipline call came back "yes" (is a fixed NLI model allowed in the
audit_mode path?); if "no", none of it builds. Also wired §2.2 con
(b)/(c), §3, §5, §6 to point at §2.4. Doc-only.
2026-05-12 12:36:09 -04:00
..
_source #000035 closed — v7 substrate spec into the repo; § 9.10 folded in 2026-05-11 17:06:19 -04:00
diagrams docs/diagrams: rename aborist-modules → arborist-modules (post-rename cleanup) 2026-05-08 07:50:28 -04:00
tickets #000049: expand — where would the NLI weights live? (§2.4 provenance & distribution) 2026-05-12 12:36:09 -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 ticket #000036 Tier-2: dav1d Option B (conservative B1 envelope) applied in v1 2026-05-11 07:06:50 -04:00
cti-architecture.md aborist/arborist 2026-05-07 09:31:49 -04:00
lexical-first-rationale.md docs: lexical-first-rationale.md — why the cheap retrieval path is the default 2026-05-12 09:23:50 -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 #000048 step 2.4 — parse_pointer_claims clause segmentation 2026-05-11 17:09:06 -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 docs/#000018 §9.2: mark resolved — φ_PRG = HMAC-SHA-512 (#000035 closed) 2026-05-11 17:20:48 -04:00
soft-hash-channel-t3-bound.md ticket #000036: add KAT-regen tooling + close 2026-05-11 08:02:25 -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: #000051 — add GPU-producer fast path (CUDA Embedder, minutes not days) 2026-05-12 12:18:27 -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 #000047 — close: delta_aggregator knob on ForkScore (Option D) 2026-05-11 08:27:38 -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