npm - @treeseed/dsh-chapters - Versions diffs - 0.1.2 → 0.1.4 - Mend

@treeseed/dsh-chapters 0.1.2 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/README.md CHANGED Viewed

@@ -1,231 +1,59 @@
 # dsh-chapters
-**A [DeepSeek Harness](https://www.deepseek.com) plugin for lossless context relief and a shared
-project knowledge layer.** Published on npm as [`@treeseed/dsh-chapters`](https://www.npmjs.com/package/@treeseed/dsh-chapters);
-source lives at [treeseed-ai/dsh-chapters](https://github.com/treeseed-ai/dsh-chapters).
+**Long memory for local AI: a [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)
+plugin that archives agent conversations as verbatim chapters, continues sessions from a Table of
+Contents at zero inference-token cost, and turns that archive into a shared, searchable knowledge
+pool.** Published on npm as [`@treeseed/dsh-chapters`](https://www.npmjs.com/package/@treeseed/dsh-chapters);
+source at [treeseed-ai/dsh-chapters](https://github.com/treeseed-ai/dsh-chapters).
-When a long conversation gets expensive, dsh-chapters archives it as **verbatim Markdown chapters** in
-a project store and opens a **new session whose entire content is a Table of Contents** of that
-archive. The model reloads any chapter on demand with the ordinary `read` tool. The original
-conversation is never rewritten, its prompt cache stays intact, and the index costs **zero model
-tokens** — chapters are written from the session log (a file copy), not summarized by an LLM.
+> **All documentation lives on the documentation site — this README is a doorway, not a duplicate.**
+> ### 📖 https://treeseed-ai.github.io/dsh-chapters/
-Archived knowledge is not stranded per-machine: link the store to a shared upstream — a **git pool**
-or a **TreeDX** service — and every linked workspace gets a two-layer derived index, topic
-vocabulary, cross-machine search (`chapters_search`), and a per-machine rules ledger.
+## Install (the whole setup)
----
-## Purpose — what it fixes, and what it does not claim
-The two things that actually hurt on long sessions, especially with local models and slow prefill:
-1. **Lossy memory.** A compaction summary drops the exact flag, the line number, the error text —
-   and leaves the model no handle to go get them back.
-2. **The summarization tax.** Producing a summary prefills the whole history into one auxiliary
-   call — minutes of wall-clock on local hardware, *again every time the window fills*.
-dsh-chapters removes the summarization step from the critical path entirely. Measured on a
-32K-capped model: ~102 tokens of index where the equivalent transcript ran ~2,476, and zero
-inference spent producing it.
-**Be clear about what this does not buy you:** it is not cheaper caching. The continuation session
-pays one cold prefill (system prompt + TOC + handoff note), the same cost class a post-compaction
-request pays. What you gain instead is *verbatim* archive (a reload returns real text, not a
-paraphrase), an *untouched* parent session that keeps its cache and stays usable, reversibility
-(abandon the child, keep working in the parent), and branchable history.
-**This is not a fork.** DSH's native fork copies the parent's log into the child; this plugin does
-the opposite — it creates an *unseeded* session that cites an archive. The whole design discipline
-traces back to that distinction.
-## Architecture
-```
-agent turn ──► chapters_segment ──► chapter ranges (the model picks ranges; never writes bodies)
-                                          │
-              chapters_continue(title, handoffNote, chapters[])
-                                          │
-        ┌─────────────────────────────────┼──────────────────────────────┐
-        ▼                                 ▼                              ▼
- render bodies from log          defer oversized tool results     preflight the budget
- (verbatim, per range)           to content-addressed             TOC + note vs remainder
- artifacts/ files                        │                                 │
-        └─────────────► chapter .md files ◄───────────────────────────────┘
-                                          │ refuse loudly if over budget
-                                          ▼
-      new session seeded with ONE message: the cumulative Table of Contents
-```
-The four rules the design never breaks:
-- **Never rewrite the durable session log.** Append-only; nothing is edited or deleted, ever.
-- **Never seed a continuation from the parent's events.** The child starts from one synthetic TOC
-  notice; history grows by citation, never by copying.
-- **Never contribute to the shared system prompt.** Per-continuation notices only — enabling the
-  plugin changes what *your sessions* can do, not what every other session in the profile sees.
-- **Never let the model author chapter bodies.** The model chooses ranges; the plugin renders the
-  text from the log. Model-typed "lossless" is the failure mode this design exists to avoid.
-Supporting machinery, each with a chapter in [docs/architecture.md](docs/architecture.md):
-- **Oversized tool results** (file reads, command output) are deferred to a content-addressed
-  `artifacts/` store and referenced from the chapter — the model can still pull them back via the
-  `chapters_artifact` tool (toc / search / read modes). Hence the honest guarantee: **every byte
-  remains retrievable**, not "every byte is in the chapter".
-- **Continuation budget, not a handoff cap:** TOC + note must fit a share of the window *remaining
-  after the header*; over budget the plugin **refuses with the numbers** — it never clips a handoff
-  note.
-- **Ancestry is a DAG, flattened for the model:** the child's notice lists every chapter on the
-  ancestor path chronologically, with explicit back-links. Reading order is causal order; the model
-  never traverses a graph.
-- **The compaction seam:** when the `chapters` agent preset is mounted, in-place compaction (manual
-  `/compact` and automatic pressure) runs through the plugin's deterministic engine — the same
-  log-only, zero-summarization discipline inside a session rather than across sessions.
-- **Enrichment (P2)**: after pushes, an idle/deferred ladder annotates archived chapters (topics,
-  summaries) — with validation before commit and a body-hash guard making enrichment the *only*
-  sanctioned mutation of a chapter file, and even that provenance-chained.
-- **Rules (P3)**: a write-once ledger of proposed project rules; approval is a **per-machine
-  curation fact** (never a shared-file rewrite), and the active core rules ride verbatim into every
-  continuation notice within a budget that refuses rather than clips.
-Storage map: chapter bodies and artifacts live **in the workspace** under `.dsh-chapters/<root>/…`
-(so the `read` tool reaches them); ancestry, numbering and hashes live in the harness's durable
-storage domain (`dsh_chapters`); your upstream credentials live under the **DSH home** with 0600
-permissions — never inside the project directory, never committed, never pushed.
-## Installation (users)
-Node ≥ 24 and a DSH host you install plugins into. From npm:
-```
-dsh plugin add @treeseed/dsh-chapters
+```bash
+dsh plugin --profile web add @treeseed/dsh-chapters      # install into your harness profile
+dsh plugin --profile web update @treeseed/dsh-chapters   # keep current — restart `dsh web` after
 ```
-(or pin the version: `@treeseed/dsh-chapters@0.1.1`). Restart your `dsh web` afterwards so the
-bundle, presets and client plane reload. What activating the plugin does:
-- **Registers the model tools** (`chapters_segment`, `chapters_continue`, `chapters_fork`,
-  `chapters_search`, `chapters_artifact`, `chapters_rule_propose`) — available to agents.
-- **Registers the composer commands** listed below — available to you.
-- **Adds a "Fork with chapters" action** to every assistant message in the web UI.
-- **Installs the `chapters` agent preset** into your DSH home at boot (`.agent-presets/`;
-  write-once — your edits are never clobbered). Pick it in the agent-preset menu to get the
-  chapter-form compaction engine; the plugin's own `fallbackPreset` covers children it creates.
+`--profile <name>` is required on every `dsh plugin` command (`web` = the browser harness profile).
+After restart you have the fork button, six agent tools, four `/chapters-*` commands — and the
+optional `chapters` preset that routes `/compact` through the zero-token engine.
-Configure it from your profile's plugin entry. The **complete key reference with defaults is the
-comment header of the shipped `cordis.patch.yml`** (`node_modules/@treeseed/dsh-chapters/cordis.patch.yml`)
-— it mirrors the live config schema, which is enforced. The knobs users reach for most:
+## Find the right page for your question
-| Key | What it governs |
+| You want to… | Go to |
 |---|---|
-| `harnessId` | this machine's identity in the shared knowledge (author of edits, rule approvals) |
-| `knowledgeRemote` | pre-bind an upstream at config time (else `/chapters-link`) |
-| `syncDebounceMs` | how quickly archives push upstream (default 30000) |
-| `enrichmentEnabled` / `enrichmentModel` | the P2 annotator (off = pure no-op) |
-| `vocabApply` | shadow (default) vs git-visible topic-alias curation |
-| `coreRulesBudgetTokens` / `rulesCoreBonus` | the rules block in notices and its search bonus |
-| `toolResultDeferFloorTokens` | the archive-time inline/defer floor |
-| `continuationBudgetRatio` | how much of the remaining window a continuation may add |
-## Supported commands
-Typed in the composer **inside a session** (a brand-new draft screen sends text as a message, not a
-command — start the session first). Every command answers with honest numbers; nothing degrades
-silently.
-| Command | Meaning |
-|---|---|
-| `/chapters-link` | show the current upstream and mirror state |
-| `/chapters-link <local-path>` | bind a shared local git repo (bare or worktree) — needs no credentials |
-| `/chapters-link <https-url> <token>` | bind a networked git pool over smart-HTTP; token stored 0600 under the DSH home |
-| `/chapters-link treedx+<url>/<repo> <token>` | bind a TreeDX service (token required — it is a bearer API) |
-| `/chapters-status` | last sync with its steps: cloned / published n new / index / pushed, or the local-only reason |
-| `/chapters-enrich run` \| `model <provider/model \| clear>` \| `report` | drive the enrichment ladder and choose its model (default: the conversation route) |
-| `/chapters-rule add <category> <text>` \| `list [--all \| --proposed \| --category <c>]` \| `approve <id>` \| `revoke <id>` | the rules ledger; approve/revoke are per-machine facts |
-| `/compact` (host command) | with the `chapters` preset mounted, this routes through the deterministic chapter engine |
-The agent-side tools you'll see in transcripts: **`chapters_segment`** (propose archive ranges),
-**`chapters_continue`** (open the TOC-seeded continuation), **`chapters_fork`** (same machinery,
-mid-conversation branch), **`chapters_search`** (query the shared index), **`chapters_artifact`**
-(retrieve deferred tool results), **`chapters_rule_propose`** (submit a rule candidate). The
-**Fork with chapters** button on an assistant message performs the archive-and-continue in one
-click and switches the UI to the new session.
-## Backend providers
-Transport is a **provider seam** (design record: [docs/knowledge-repo.md](docs/knowledge-repo.md) §15;
-contract: [docs/provider.md](docs/provider.md)): six verbs — clone/pull/push/commit/list/fetch — and
-two shipped backends. Search, rules and the index all read the materialized **mirror**; they are
-identical under either provider.
-|  | **`git` (default)** | **`treedx`** |
-|---|---|---|
-| Address form | `https://…/pool.git` (+ token) or a local path | `treedx+<url>/<repo>` (+ bearer token) |
-| Transport | git smart-HTTP via isomorphic-git; plain repositories, browsable with any git client | TreeDX service API: workspace → overlay writes → commit, lease-managed |
-| Credentials | per-project token in the DSH home (0600); local paths need none | bearer token, same home treatment |
-| Contention | push rejected → ff-pull retry → divergence routes through **rebuild-from-the-store** | lease contention maps onto the same rejected→pull→diverged ladder |
-| Mirror memory | cloned mirror directory under the workspace store | `.treedx-state.json` remembers the served head |
-| Layout on the wire | identical: `chapters/`, `artifacts/`, `rules/`, derived `index/`, `collections/`, `topics/vocabulary.json` | identical (the service stores the same tree) |
-Shared honesty rules both backends implement (measured, pinned by tests): every sync-path failure
-**degrades to `local-only` with the reason**, never a silent loss — the mirror stays current and the
-push lands when the remote returns; an unreachable-vs-auth-rejected distinction survives into the
-status; divergence resolves by rebuilding from the store (the store is the truth, transport is
-expendable); corpus listings page to the end. `kind` defaults to `git` for every record written
-before providers existed — upgrading is zero migration.
-## Development process
-Everything runs from a clone with plain **npm** (this is a single package, not a monorepo):
-```
-npm ci
-npm run typecheck && npm run build
-npm test                      # unit + integration
-npm run coverage:ci           # c8 gate: ≥85% statements/branches/functions/lines
-```
-The browser acceptance suite runs against **model tapes** — recorded LLM exchanges replayed by a
-local proxy, so it needs no model, no key and no GPU, and passes or fails *loudly* on a miss:
-```
-npm ci --prefix dev/dsh-host-lock           # the pinned, hermetic DSH host for e2e boots
-export PATH="$PWD/dev/dsh-host-lock/node_modules/.bin:$PATH"
-npm run test:e2e:replay                     # all seven segments, ~6 min
-bash scripts/bootstrap-dev-profile.sh --home .dshdev-local   # scratch dev home, built via npm
-```
-Tapes live in `tests/fixtures/model-tape/<project>/`; `E2E_MODEL=record` distills them against a
-local llama.cpp endpoint (dev-only — CI never touches the model). When **product prompts change**
-(persona, tool descriptions, notice text, thresholds) re-record the affected projects; documentation
-edits are free. Agent-facing rules (the four invariants, the tape discipline, the coverage ledgers)
-live in [AGENTS.md](AGENTS.md); the workflow loop in [docs/development.md](docs/development.md);
-verification checklists in [docs/verify.md](docs/verify.md). Hosted CI
-(`.github/workflows/ci.yml`) runs the gate plus the full tape-replay chain on every push;
-releases publish automatically from a bare-semver tag via **npm trusted publishing (OIDC)** with
-provenance attestations — no deploy secrets.
-## Contributing
-- **Start with an issue** for anything that changes behavior; the design record in
-  `docs/knowledge-repo.md` explains *why* things are shaped as they are, and amendments are human
-  decisions recorded in git.
-- **Keep the four invariants inviolable** (never rewrite the log; never seed from the parent's
-  events; never touch the shared system prompt; never let the model author bodies). A PR that
-  trades one of these for convenience will be closed, not merged.
-- **CI defines "done"**: deterministic suite green, coverage gate green, and — if your change moves
-  a model-visible prompt — the tape-replay chain re-recorded and green. Refuse-with-numbers beats
-  silent fallback everywhere in this codebase; follow that doctrine in new code too.
-- **Test what you touch, and say how**: measured claims (this README's numbers are measured),
-  cited failure modes, no speculative generality.
-- **Never commit credentials** or machine paths into fixtures; tokens belong to the DSH home only.
-- Releases are maintainer-driven: bump `version`, land to `main`, push the tag — CI publishes.
-License: see [LICENSE](LICENSE) (Copyright 2026 Fractal Synapse Labs).
-> **On the name.** The package ships as `@treeseed/dsh-chapters` (npm scope `treeseed`; the GitHub
-> org is `treeseed-ai`). Earlier candidates — `dsh-chapter-fork`, anything with "compact" — were
-> rejected because they claimed something false: in DSH, *fork* means copying the parent's history,
-> the one operation this plugin must never perform. The name names the artifact instead. Reasoning:
-> [docs/architecture.md § Naming](docs/architecture.md#naming).
+| understand what this is / why (the ten benefits) | [Home → “What it gives you”](https://treeseed-ai.github.io/dsh-chapters/) |
+| install, upgrade, uninstall, verify provenance | [§23 Install, upgrade, provenance](https://treeseed-ai.github.io/dsh-chapters/operations/install/) |
+| run your first compaction/continuation | [§1 Quickstart](https://treeseed-ai.github.io/dsh-chapters/start/quickstart/) → [§2 Your first continuation](https://treeseed-ai.github.io/dsh-chapters/start/first-continuation/) |
+| link a shared knowledge pool (git or TreeDX) | [§3 Link a knowledge pool](https://treeseed-ai.github.io/dsh-chapters/start/link-pool/) · [§10 The pool](https://treeseed-ai.github.io/dsh-chapters/knowledge/pool/) |
+| run any command — exact syntax, scope, outputs | [§15 Commands](https://treeseed-ai.github.io/dsh-chapters/reference/commands/) |
+| know what the agent-facing tools do | [§16 Agent tools](https://treeseed-ai.github.io/dsh-chapters/reference/tools/) |
+| tune a threshold, budget, or trigger | [§17 Configuration](https://treeseed-ai.github.io/dsh-chapters/reference/configuration/) |
+| understand *why not summaries* / the economics | [§5 Why not summaries?](https://treeseed-ai.github.io/dsh-chapters/concepts/why-not-summaries/) |
+| read the design rules the system won't break | [§6 The four invariants](https://treeseed-ai.github.io/dsh-chapters/concepts/invariants/) |
+| the theory behind retrieval-over-compression (RLM) | [§8 Recursive context theory](https://treeseed-ai.github.io/dsh-chapters/concepts/recursive-context/) |
+| propose/approve rules for agents | [§13 Rules & governance](https://treeseed-ai.github.io/dsh-chapters/knowledge/rules/) |
+| debug something (“seems broken, is it?”) | [§4 FAQ & troubleshooting](https://treeseed-ai.github.io/dsh-chapters/start/faq/) |
+| prompt-cache / llama.cpp behavior | [§21 Cache behavior on llama.cpp](https://treeseed-ai.github.io/dsh-chapters/evidence/llamacpp-cache/) |
+| see measured results (production run + benchmarks) | [§19 Benchmarks](https://treeseed-ai.github.io/dsh-chapters/evidence/benchmarks/) · [§20 Field study](https://treeseed-ai.github.io/dsh-chapters/evidence/field-study/) |
+| compare with other memory approaches | [§22 The alternatives, compared](https://treeseed-ai.github.io/dsh-chapters/evidence/comparison/) |
+| check security/privacy boundaries | [§27 Security & privacy](https://treeseed-ai.github.io/dsh-chapters/operations/security/) |
+| release history & known-fixed incidents | [§26 Changelog](https://treeseed-ai.github.io/dsh-chapters/operations/changelog/) |
+| **develop the plugin itself** | [§24 Developing](https://treeseed-ai.github.io/dsh-chapters/operations/development/) → the engineering specs below |
+## Developing / contributing
+The site's Part VI covers the daily loop; the repository itself holds the engineering truth for agents:
+- **[`AGENTS.md`](AGENTS.md)** — working spec for AI agents developing this repo (invariants, budget, hard rules)
+- **[`docs/`](docs/)** — deep specs: `contract.md` (host API facts), `architecture.md` (mechanics), `development.md` (build/test loop + tape system), `verify.md` (every claim's procedure), `knowledge-repo.md` (design record), `host-compaction-seam.md`, `provider.md`
+- **benchmarks**: `npm run bench` — three arms, local model, never CI ([protocol](benchmarks/README.md))
+Feature requests and bugs: [open an issue](https://github.com/treeseed-ai/dsh-chapters/issues) —
+measured reports get measured answers.
+## License
+Apache-2.0 — see [LICENSE](LICENSE). Your conversations, chapters, and knowledge pools stay yours.

package/cordis.patch.yml CHANGED Viewed

@@ -2,7 +2,9 @@
 # plugin's composition patch, applied when a profile adds the plugin. The YAML
 # below the comment block is functional; everything in this comment is the
 # complete configuration reference (kept in sync with src/index.ts and
-# src/engine.ts — verified 2026-09-20 against both schemas).
+# src/engine.ts — verified 2026-10-01 against both schemas, including the
+# 2026-09-21 transport keys). The site's §17 (Configuration) is the readable
+# authority; this header mirrors it.
 # Scratch-profile install: DSH_HOME=$PWD/.dshdev dsh plugin --profile web add "link:$(pwd)"
 #
 # Two planes, two surfaces:
@@ -73,6 +75,16 @@
 #                                  # THIS machine (approval = per-machine
 #                                  # curation fact, record §15)
 #
+#   # ---- transport (2026-09-21 provider-seam amendment) -------------------
+#   knowledgeProvider: 'auto'      # 'auto' | 'git' | 'treedx'; 'auto' dispatches
+#                                  # on the remote scheme (treedx+ → TreeDX),
+#                                  # an explicit value must match the scheme or
+#                                  # the link refuses — never a silent fallback
+#   treedxFetchTimeoutMs: 15000    # TreeDX HTTP timeout per call
+#   treedxWorkspaceTtlSeconds: 900 # TreeDX workspace lease TTL
+#   treedxLeaseRetries: 3          # pull-retry budget when the lease is held
+#   treedxLeaseRetryDelayMs: 1000  # delay between lease retries
+#
 # Realm-row-only keys (in the preset's engine row, not this patch):
 #   thresholdRatio, retainRatio, retainTokens, maxTokens, compactionRetries,
 #   maxOverflowRetries, auto, summarizationProvider/summarizationModel (legacy

package/docs/development.md CHANGED Viewed

@@ -69,8 +69,8 @@ scripts/bootstrap-dev-profile.sh --with-probe   # scripted rounds only (probe se
 | unit | `npm test` (`tests/unit`) | node --test, no build, no network | pure core: registry, render, archive, notice, engine-core, tools, commands |
 | integration | (today: probe rounds — see spikes/probe/README pattern) | boots real hosts in scratch homes | host wiring, realm mounts, provider economics |
 | e2e (tape — the default loop) | `npm run test:e2e:replay` | same boots with `E2E_MODEL=replay`; model turns answered from `tests/fixtures/model-tape/<project>` via the record/replay proxy (`tests/e2e/model-proxy.ts`) — seconds, deterministic |
-| e2e (distillation — occasional) | `npm run test:e2e:record` | `E2E_MODEL=record`: forwards every exchange to the real Local model and appends the tape. Run once per scenario; wipe `var/model-tape` first for a clean corpus; tapes are isolated per project (suite/heavy/arrival); re-record when scenarios, prompts, or thresholds change. The GPU model is the DISTILLER, never the test oracle (user directive 2026-09-19) |
-| e2e | `npm run test:e2e` (`tests/e2e`, THREE projects: suite/heavy/arrival) | Playwright + workspace-cached chromium vs a throwaway `var/e2e-home-<port>` rebuilt per boot (port-keyed so no boot can stomp another's state) (isolated from live agents — see FINDINGS 2026-09-19) | the browser: identity, fork button + switch, knowledge loop end-to-end, the oversized turn (mid-turn compactions), the subagent fan-out, arrival-time artifacting (low-floor project) |
+| e2e (distillation — occasional) | `npm run test:e2e:record` | `E2E_MODEL=record`: forwards every exchange to the real Local model and appends the tape. Run once per scenario; wipe `var/model-tape` first for a clean corpus; tapes are isolated per project (seven: suite/heavy/arrival/fanout/enrich/rules/fork); re-record when scenarios, prompts, or thresholds change. The GPU model is the DISTILLER, never the test oracle (user directive 2026-09-19) |
+| e2e | `npm run test:e2e` (`tests/e2e`, SEVEN projects: suite/heavy/arrival/fanout/enrich/rules/fork) | Playwright + workspace-cached chromium vs a throwaway `var/e2e-home-<port>` rebuilt per boot (port-keyed so no boot can stomp another's state) (isolated from live agents — see FINDINGS 2026-09-19) | the browser: identity, fork button + switch, knowledge loop end-to-end, the oversized turn (mid-turn compactions), the subagent fan-out, arrival-time artifacting (low-floor project) |
 The e2e layer exists because client-plane facts were being GUESSED (services, methods, tooltips,
 switching) and every guess cost the user a browser round-trip. Playwright answers those in seconds
@@ -82,14 +82,14 @@ activation, `fork-button.spec.ts` proves the click end-to-end on durable + visib
 heavy specs pin their claims to DURABLE facts (own-log turn/end, registry chapters, coverage) —
 never to model verbosity. ACCEPTANCE DEFAULTS TO THE TAPE (`test:e2e:replay`, model turns served
 from `tests/fixtures/model-tape/<project>` in seconds — explore: 14.7 s replayed vs 1.7 min live); the live
-chain remains the distiller (`test:e2e:record`) and the ultimate witness. The one honest
-limit of AGENTS-BLIND masking (measured 2026-09-23): it keys on the `instructions from:` /
-`<system-reminder>` delimiters, so it strips injected instruction blocks — but when a
-near-threshold session compacts, the harness's own checkpoint summary re-emits the doc as
-free prose at msg[1], which no delimiter mask reaches. Effect: `heavy` and `fanout` tapes
-carry the live AGENTS.md text, so an AGENTS.md edit means re-recording THOSE two projects
-(suite/enrich/rules carry too little to compact and stay doc-independent). Rule: finalize
-doc edits, then distill — never the reverse.
+chain remains the distiller (`test:e2e:record`) and the ultimate witness. AGENTS-BLIND
+masking (user decision 2026-09-20, reaffirmed 2026-10-01 with no exceptions): the tapes
+stand in for ANOTHER project — a workspace docs edit (AGENTS.md, skill catalogs) NEVER
+requires a re-record. The delimiter mask strips injected doc blocks from matching on both
+sides, and a compaction summary that paraphrases doc prose (observed 2026-09-23 in
+`heavy`/`fanout`) rides the tape as recorded model output — replay-side requests never
+regenerate it, so committed tapes stay green across doc edits. Never gate a doc edit on
+a distillation.
 Re-record discipline (learned the hard way 2026-09-22/23):
 - **A tape records the CONTEXT it was distilled in.** A spec replayed in a different
@@ -97,6 +97,14 @@ Re-record discipline (learned the hard way 2026-09-22/23):
   injected presence and misses. Re-record the whole project, not a single spec, when specs
   share a boot — and never run two GPU-consuming suites concurrently (RR2=137 + timeout
   cascades: a fanout that passes alone failed at 1.1 h while a heal chain shared the server).
+  **Home freshness is part of the context** (measured 2026-09-29): the host injects
+  skill-catalog-changed and runtime-context snapshot notices on the FIRST boot against a
+  fresh/absent throwaway home. Distilling against a stale home produced a tape without those
+  messages that a pristine replay then demanded — structural message-count divergence, which
+  no content mask can bridge. Discipline: `rm -rf var/e2e-home-<port>` before RECORD and
+  before the verifying REPLAY, so both sides saw the same boot world. Hosted CI is inherently
+  pristine: a locally-distilled tape that passes only on an accumulated home is a red flag,
+  not a pass.
 - **Ports are parameterized end to end**: the model proxy derives `E2E_PROXY_PORT = boot port
   + 1000` (a hard-coded 41799 turned one killed run's orphan into EADDRINUSE for every later
   boot), and `boot.ts` fails FAST with a named-port message when the boot port is already

package/docs/verify.md CHANGED Viewed

@@ -127,7 +127,7 @@ readability judgment.
 | T11 | Git-plane auth honesty | a rejected credential (401/403) classifies as `auth`, never `network` — clone/pull/push carry it and the degrade-to-local-only status says `credentials rejected … re-link with /chapters-link`, not the unreachable-ghost (the TreeDX live lesson applied to git) | `git-auth-classification.test.ts` (5) over a REAL smart-HTTP remote with a token gate; classifier unit rows included |
 | T12 | Corpus listing is complete | `paths/list` paginates (limit 100, base64 offset cursor) — `corpusPaths` follows `nextCursor` to the end; a second machine materializes EVERY file past a page boundary | `treedx-sync.test.ts` pagination row (150 files over the paginating stub); the live container (>100 paths) proves it at the real service |
 | T13 | The human entry surface | `/chapters-link` all four modes incl. refusals (no-token non-loopback, junk target), `/chapters-status` renders each fact ONCE (a duplicate-`Provider:` line was caught here), `/chapters-enrich` verbs, legacy workspace-token migration to the DSH home (0600, old file deleted) | `link-git-commands.test.ts` (11), `token-migration.test.ts` (4) |
-| COV | Both coverage ledgers are statement-grade and run | `npm run coverage:ci` — the GATED deterministic ledger (c8 over all unit+integration, `--check-coverage` at 85% statements/branches/functions/lines; enforced in hosted CI, which is GREEN end to end 2026-09-25) — currently **97.98% stmts / 85.61% branch / 93.62% funcs @ 451 tests, zero skips**. `npm run coverage:e2e` — six-project replay under E2E_COVERAGE=1; boots run lib/*.js with REAL source maps (tsconfig `sourceMap`) remapped by c8/v8-to-istanbul; first ledger **80% stmts / 62% branches / 74% funcs** — it corrected the earlier line-range estimate honestly (tools.ts 99% lines → 72% statements). The 2026-09-23 audit then closed most of that gap at the DETERMINISTIC plane: the engine's construction/listeners/degraded-summarize/plot-elicit/finalize-guard paths (`engine-lifecycle.test.ts` — real cordis `Context()`, real base engine, injected llm/tokenMeter fakes: engine.ts 40→91% stmts), every tool wrapper's success/refusal/missing-caller surface (`tools-surface` + `tools-branches` + `tools-deep-branches`), the TreeDX error taxonomy via one-shot stub faults (`treedx-provider-branches`) and parser-shape drift via injected `fetchImpl` (`treedx-parser-branches`), the local-path git transport arms (`gitops-branches`), host-command error arms (`host-command-branches`), and the pure planners (vocabulary/enrich/indexing/search/arrival/archive — `rules-vocab-branches`, `enrich-planner-branches`, `indexing-branches`, `notice-search-rules-branches`, `render-archive-ladder-branches`, `pure-branches`). It also caught one REAL bug on the way: `canonicalizeRemote` carried embedded `user:token@` credentials into the project key (pasting a remote with and without creds forked the pool — now stripped, pinned in `pure-branches.test.ts`). Gotchas pinned in the script header: c8 filters include/exclude BEFORE remapping (`--include=src/**` against lib-path profiles zeroes the report). Neither ledger alone is the claim; the e2e one makes index/render-in-browser paths that no deterministic test can see accountable |
+| COV | Both coverage ledgers are statement-grade and run | `npm run coverage:ci` — the GATED deterministic ledger (c8 over all unit+integration, `--check-coverage` at 85% statements/branches/functions/lines; enforced in hosted CI, which is GREEN end to end 2026-09-25) — currently **97.98% stmts / 85.61% branch / 93.62% funcs @ 464 tests, zero skips**. `npm run coverage:e2e` — seven-project replay under E2E_COVERAGE=1; boots run lib/*.js with REAL source maps (tsconfig `sourceMap`) remapped by c8/v8-to-istanbul; first ledger **80% stmts / 62% branches / 74% funcs** — it corrected the earlier line-range estimate honestly (tools.ts 99% lines → 72% statements). The 2026-09-23 audit then closed most of that gap at the DETERMINISTIC plane: the engine's construction/listeners/degraded-summarize/plot-elicit/finalize-guard paths (`engine-lifecycle.test.ts` — real cordis `Context()`, real base engine, injected llm/tokenMeter fakes: engine.ts 40→91% stmts), every tool wrapper's success/refusal/missing-caller surface (`tools-surface` + `tools-branches` + `tools-deep-branches`), the TreeDX error taxonomy via one-shot stub faults (`treedx-provider-branches`) and parser-shape drift via injected `fetchImpl` (`treedx-parser-branches`), the local-path git transport arms (`gitops-branches`), host-command error arms (`host-command-branches`), and the pure planners (vocabulary/enrich/indexing/search/arrival/archive — `rules-vocab-branches`, `enrich-planner-branches`, `indexing-branches`, `notice-search-rules-branches`, `render-archive-ladder-branches`, `pure-branches`). It also caught one REAL bug on the way: `canonicalizeRemote` carried embedded `user:token@` credentials into the project key (pasting a remote with and without creds forked the pool — now stripped, pinned in `pure-branches.test.ts`). Gotchas pinned in the script header: c8 filters include/exclude BEFORE remapping (`--include=src/**` against lib-path profiles zeroes the report). Neither ledger alone is the claim; the e2e one makes index/render-in-browser paths that no deterministic test can see accountable |
 | H1 | Corpus carries no project instructions | host-injected context (instruction files, runtime snapshot, skill catalog, our own TOC notice — event-level AND `<system-reminder>` spans inside human messages) renders as a countable `⟦omitted:host-injected …⟧` marker, never bytes; conversation survives verbatim and byte-identical | unit `injections.test.ts` (15) + `render.test.ts` rows; integration `corpus-hygiene.test.ts` (archive→sync→remote→pull→search sentinel-absence, and legacy-store-publishes-unchanged anti-migration guard); e2e stays AGENTS-BLIND (tape masking) |
 ## The Cache Metric, Before You Trust a Number
@@ -157,7 +157,7 @@ that still need a running chapter engine:
 | E1 | Zero-inference summarization | the `compaction/summary` event carries **no `usage` field** and no provider call appears in the round (proved with a stub at r12/r13; must re-prove with the real TOC `summarize()`) |
 | E2 | Archive honesty after automatic compaction | every `shadowedSeq` of a landed compaction resolves (via durable log + `sourceEventSeqs`) into a written chapter file whose hash matches the registry |
 | E3 | Header cache across a compaction — **CLOSED by r23 (measured, per-machine)** | cloud: `cacheReadTokens` held at **7,424 on both post-replacement turns** while uncached refill fell 13,658 → ~7,000. Local llama.cpp (r28-era probes): reuses NOTHING across a head replacement (0 cached) but steady-state turns cost only the new content. **Never quote one machine's number for the other.** |
-| E2E-TAPE | Acceptance without the GPU | `test:e2e:replay` serves every model turn from `var/model-tape/<project>` (isolated per boot) (proxy smoke: exact + prefix hit, loud 503 miss with journal). Usage fields ride the tape, so the token meter and compaction thresholds fire at identical steps under replay. Tapes are committed test DATA under `tests/fixtures/model-tape/` (the rest of `var/` stays ignored) — CI replays them via `scripts/ci-replay.sh` with no local model; regenerate via `test:e2e:record` (local GPU) when PRODUCT prompts change. The local model remains the distiller and ultimate witness. STATUS 2026-09-23: pipeline current (escape/whitespace classes, volatile rules incl. HOSTPORT-BLIND + derived-count collapses for `(N est tokens)` and host-injected char counts, tool bytes matched out); SIX-project replay chain (suite, fanout, heavy, arrival, enrich, rules). Doc-edit cost is honest, not free: the delimiter mask keeps AGENTS/skill bytes out of ordinary matching, but the harness's own checkpoint summary embeds the doc as model-visible prose in the compaction scenarios, so `heavy`/`fanout` re-record after an AGENTS.md change (finalize docs, THEN distill). The e2e is the integration witness that the deterministic layers cannot replace — it found two real product bugs (the enrich body-hash anchor mismatch and the missing host-plane route) that had been invisible behind the host logger |
+| E2E-TAPE | Acceptance without the GPU | `test:e2e:replay` serves every model turn from `var/model-tape/<project>` (isolated per boot) (proxy smoke: exact + prefix hit, loud 503 miss with journal). Usage fields ride the tape, so the token meter and compaction thresholds fire at identical steps under replay. Tapes are committed test DATA under `tests/fixtures/model-tape/` (the rest of `var/` stays ignored) — CI replays them via `scripts/ci-replay.sh` with no local model; regenerate via `test:e2e:record` (local GPU) when PRODUCT prompts change. The local model remains the distiller and ultimate witness. STATUS 2026-09-23: pipeline current (escape/whitespace classes, volatile rules incl. HOSTPORT-BLIND + derived-count collapses for `(N est tokens)` and host-injected char counts, tool bytes matched out); SEVEN-project replay chain (suite, fanout, heavy, arrival, enrich, rules, fork). Doc edits are ALWAYS free (user decision 2026-10-01, no exceptions): the tapes stand in for ANOTHER project — injected doc bytes are masked from matching, and compaction summaries that paraphrase doc prose ride the tape as recorded model output, so no doc edit ever requires a re-record. The e2e is the integration witness that the deterministic layers cannot replace — it found two real product bugs (the enrich body-hash anchor mismatch and the missing host-plane route) that had been invisible behind the host logger |
 | E9 | P2 enrichment + vocabulary, two-machine grade | `node --test tests/integration/two-machine-enrich.test.ts` + `--project=enrich` tape replay | **green 2026-09-20** — enriched frontmatter/provenance cross the pool byte-exact; B honors A’s aliases and dedupes its own vocab pass; caught+fixed r37 (modifications invisible to commits). Four-project replay chain green, 0 misses |
 | CACHE | **Cache hit rates rise over time; nothing poisons the prefix silently** | Three nets, all born of the 2026-09-25 machine deep-dive (user report: "hit rates FALL over time"). The decoded truth — timeline first, because the first attribution got it wrong twice: a parent session's provider cacheRead rode 11,386→29,656 (hit .997) for seven warm requests, then COLLAPSED to a pinned 9,613 at request seq 78 — BEFORE any compaction event (those land at seq 105). Cause: KV-CAPACITY EVICTION — parent + three fan-out children + a live agent session sharing one 65,536-token llama.cpp pool (total_slots 1 per /props); prefix lookup kept doing exactly its job, returning the shared 9,613-token header for every divergent chain. The engine's pressure compaction then fired CORRECTLY at the meter's number (~66,700 ≥ 0.9×64,000) — the meter is provider baseline + 4-chars/token estimate of content added since the last request, so its trigger point is invisible in provider usage numbers (29,656 looked early; it was not). After the children quiesced the parent RE-WARMED (req 121: read 21,969, hit .97). **Deterministic net 1**: `tape-prefix-stability.test.ts` — every mid-chain tape request must extend its predecessor byte-for-byte (only the two documented replacement points may break a chain); message mutation mid-session — the general cache-poison class — fails this ledger with the offending entry; all seven projects pass. **Deterministic net 2**: `context-hygiene.test.ts` — no context-window literal may ship in src/ or presets/, no preset may pin a window key: the threshold math (floor(configured window × ratio)) can only follow adapter config. **Physical net** (opt-in, live): `npm run test:e2e:cache` serial — asserts the warm curve (no collapse <50% of best cacheRead, ≥50% of prompt growth landing cached, final hit ≥0.90, no compaction in-window; full ledger on failure; first run: 0%→99.7% monotonic). `E2E_CACHE_CONCURRENCY=N` adds N-1 live tenant chains firing per round — VALIDATED at CONCUR=3 (17.6 min): the probe chain still finished hit 0.997 with zero tenant errors, while the interleaved tenants showed the textbook capacity signature the user's log had (cacheRead pinned at 9,617, hit ~0.50 when their turns alternated on the single slot, recovering to 0.998 the moment they got two contiguous turns). Proves the collapse is capacity/interleaving, not the plugin: the same server, same slot, a chain left alone still warms to .997; pass measures this server holding N warm chains, pinned-header/queue-starvation measures the capacity cliff; run it while your own agent sessions are few, and read the ledger SHAPE (collapse-and-stay vs flat-pin vs dip-and-recover) before believing any single attribution | Host-capacity epilogue (2026-09-26, measured on the dev box): single-slot llama.cpp pins interleaved chains to the shared-prefix LCP (9,617 tokens in every experiment); unified KV (--kv-unified, auto slots) crashed b10920 on hybrid-GDN models (Qwen3-Next class; llama.cpp #23210/#21401) — RETESTED WINNING on b11176 (2026-09-27): contention probe CONCUR=3 passed, every chain at 0.997-0.998 with tails restoring one turn after a collision, zero crashes; keep auto slots (1), never force N_PARALLEL>1, re-run scripts/prefix-swap-test.mjs + the contention probe after any image upgrade — one trap measured: LLAMA_ARG_CTX_CHECKPOINTS=0 looks like a saving (upstream invalidates them for the recurrent layers) but on b10920 it deletes ALL cross-request prefix reuse (cached_tokens flat 0); keep the default 32 |
 | E2E | The fork BUTTON, browser journey | **green (2026-09-19, 7 specs / three projects — suite@0.75-of-32K + heavy@0.5-floor-off + arrival@0.9-floor-500 — on port-keyed throwaway homes)**: specs CREATE their sessions through the UI ('New session' + one real Local-model turn; turn-complete = the session's OWN `turn/end` in its own log — the global registry count false-passed twice and was retired). Fixture-free by design after the R29-era rows aged out of the 90-session sidebar. The suite also caught the 'Internal Testing Notice' focus trap and the re-link origin bug (see FINDINGS). |

package/lib/artifact-query.d.ts CHANGED Viewed

@@ -51,3 +51,12 @@ export declare function loadArtifact(absPath: string): {
     bytes: number;
     lines: number;
 };
+/**
+ * Store-first, mirror-second resolution (measured 2026-09-28, treeseed pool
+ * audit): chapters cite 'artifacts/aa/<sha>.txt' — on another machine the blob
+ * lives in the knowledge MIRROR (artifacts/<projectKey>/aa/<sha>.txt, one dir
+ * per linked project), not the local store. Returns the absolute path of the
+ * first existing match, or null. Containment holds on BOTH roots; '..' can
+ * never escape.
+ */
+export declare function resolveArtifactWithMirror(storeDir: string, ref: string, mirrorDir: string): string | null;

package/lib/artifact-query.js CHANGED Viewed

@@ -127,4 +127,41 @@ export function loadArtifact(absPath) {
     const st = fs.statSync(absPath);
     return { text: fs.readFileSync(absPath, 'utf8'), bytes: st.size, lines: 0 };
 }
+/**
+ * Store-first, mirror-second resolution (measured 2026-09-28, treeseed pool
+ * audit): chapters cite 'artifacts/aa/<sha>.txt' — on another machine the blob
+ * lives in the knowledge MIRROR (artifacts/<projectKey>/aa/<sha>.txt, one dir
+ * per linked project), not the local store. Returns the absolute path of the
+ * first existing match, or null. Containment holds on BOTH roots; '..' can
+ * never escape.
+ */
+export function resolveArtifactWithMirror(storeDir, ref, mirrorDir) {
+    const primary = resolveArtifactPath(storeDir, ref); // still throws on escapes
+    if (fs.existsSync(primary))
+        return primary;
+    const clean = ref.trim();
+    // tail = the aa/<sha>.txt portion under artifacts/, whatever the ref form
+    const tail = /^[0-9a-f]{64}$/.test(clean)
+        ? path.join(clean.slice(0, 2), `${clean}.txt`)
+        : (() => {
+            const m = clean.replace(/^\.\//, '').match(/artifacts[/\\](.+\.txt)$/);
+            return m?.[1] ?? null;
+        })();
+    if (tail === null || tail.split(/[\\/]/).includes('..'))
+        return null;
+    const artRoot = path.join(mirrorDir, 'artifacts');
+    if (!fs.existsSync(artRoot))
+        return null;
+    for (const key of fs.readdirSync(artRoot, { withFileTypes: true })) {
+        if (!key.isDirectory())
+            continue;
+        const cand = path.join(artRoot, key.name, tail);
+        const root = path.resolve(artRoot);
+        if (path.resolve(cand) !== root && !path.resolve(cand).startsWith(root + path.sep))
+            continue;
+        if (fs.existsSync(cand))
+            return cand;
+    }
+    return null;
+}
 //# sourceMappingURL=artifact-query.js.map

package/lib/artifact-query.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"artifact-query.js","sourceRoot":"","sources":["../src/artifact-query.ts"],"names":[],"mappings":"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"}
1	+ {"version":3,"file":"artifact-query.js","sourceRoot":"","sources":["../src/artifact-query.ts"],"names":[],"mappings":"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"}

package/lib/engine.js CHANGED Viewed

@@ -433,16 +433,32 @@ export class ChaptersCompactionEngine extends BasicCompactionEngine {
                 && typeof cfg.summarizationModel === 'string' && cfg.summarizationModel !== '')
                 ? { provider: cfg.summarizationProvider, model: cfg.summarizationModel } : null;
             const route = legacy ?? (shared !== null && shared.provider !== '' && shared.model !== '' ? shared : this.lastRoute);
-            if (route === null)
+            if (route === null) {
+                // Loud, not silent: an empty plot section is a legitimate outcome, but
+                // SILENTLY skipping is how the treeseed run's early child checkpoints
+                // lost their plots without a trace (2026-09-27 audit).
+                this.#diagnostic('dsh-chapters: plot elicitation skipped — no route resolved (lastRoute unset, no aux route)');
                 return null;
-            const text = await this.#auxComplete(instruction, route, 220, signal, session.id);
+            }
+            // 600, not 220: reasoning tokens count against the budget on reasoning
+            // models (measured: the elicit prompt alone used 155 of 220 with a SHORT
+            // excerpt — real 8K-char excerpts invite more thinking and starved the
+            // content to nothing). Malformed replies are now logged with a snippet.
+            const text = await this.#auxComplete(instruction, route, 600, signal, session.id);
             const at = text.indexOf('PLOT:');
-            if (at === -1)
+            if (at === -1) {
+                this.#diagnostic(`dsh-chapters: plot elicitation reply carried no PLOT line (${text.length} chars): ${JSON.stringify(text.slice(0, 80))}`);
                 return null;
+            }
             const para = text.slice(at + 5).split(/\n\s*\n/)[0].trim();
-            return para.length === 0 ? null : para.slice(0, 900);
+            if (para.length === 0) {
+                this.#diagnostic('dsh-chapters: plot elicitation reply had an empty PLOT line');
+                return null;
+            }
+            return para.slice(0, 900);
         }
-        catch {
+        catch (error) {
+            this.#diagnostic(`dsh-chapters: plot elicitation failed (${String(error?.message ?? error).slice(0, 120)}) — continuing without a plot`);
             return null;
         }
     }
@@ -509,18 +525,25 @@ export class ChaptersCompactionEngine extends BasicCompactionEngine {
             await this.#finalizeAllOutstanding(session);
         }
         catch (error) {
-            const message = `dsh-chapters: chapter finalization deferred (session ${session.id}): ${String(error?.stack ?? error)}`;
-            this.ctx.logger?.warn?.(message);
-            // Headless profiles route ctx.logger where the operator cannot see it
-            // (measured r19: every useful warn vanished). Mirror engine failures to
-            // an append file when the operator opts in — diagnostics seam, not a tunable.
-            const sink = process.env.DSH_CHAPTERS_ENGINE_ERRORS;
-            if (sink !== undefined) {
-                try {
-                    appendFileSync(sink, `[${new Date().toISOString()}] ${message}\n`);
-                }
-                catch { /* diagnostics must never mask the real failure */ }
+            this.#diagnostic(`dsh-chapters: chapter finalization deferred (session ${session.id}): ${String(error?.stack ?? error)}`);
+        }
+    }
+    /**
+     * The operator-visible warn channel (r19: headless profiles route ctx.logger
+     * where nobody can see it; measured again 2026-09-27: even the in-process
+     * logger surface is unassertable on this node build). Warn + mirror to the
+     * DSH_CHAPTERS_ENGINE_ERRORS append file when opted in — diagnostics seam,
+     * not a tunable. Any degradation that leaves the user wondering "did the
+     * feature run?" belongs here.
+     */
+    #diagnostic(message) {
+        this.ctx.logger?.warn?.(message);
+        const sink = process.env.DSH_CHAPTERS_ENGINE_ERRORS;
+        if (sink !== undefined) {
+            try {
+                appendFileSync(sink, `[${new Date().toISOString()}] ${message}\n`);
             }
+            catch { /* diagnostics must never mask the real failure */ }
         }
     }
     /** Every provider-tagged summary without a finalized manifest, oldest first. */