> ## Documentation Index
> Fetch the complete documentation index at: https://docs.the40thieves.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Decisions index

> Resolves the ticket ids cited in source comments to public summaries.

This project tracks day-to-day planning work in Linear, a private issue tracker — source comments
and CHANGELOG entries routinely cite a `THE-xxx` ticket id as shorthand for "the discussion that
produced this." Those ids are not resolvable outside the maintainer team, which would otherwise
leave every outside contributor who hits one at a dead end. This index closes that gap: for every
`THE-xxx` cited under `packages/*/src`, it resolves the ticket to the best PUBLIC summary this
repo already has — the CHANGELOG entry that shipped it, or the design/ADR/spec doc that discusses
it — so the repository stays self-contained without anyone needing tracker access.

This page is **generated** at docs-build time and is not stored in git. Regenerate it with
`bun run docs:decisions-index`; `bun run docs:decisions-index:check` fails if the generator no
longer runs over the source tree (or if a copy is committed), and runs as part of the docs drift
gate in CI.

| Ticket | Summary | Where the substance lives | Referencing files |
| - | - | - | -: |
| THE-44 | Derive-don't-mutate access instrumentation + knowledge-health scorecard (THE-44, THE-46). | CHANGELOG.md (1.8.0) | 6 |
| THE-46 | Derive-don't-mutate access instrumentation + knowledge-health scorecard (THE-44, THE-46). | CHANGELOG.md (1.8.0) | 1 |
| THE-48 | Knowledge-gap detector (THE-48). | CHANGELOG.md (1.8.0) | 3 |
| THE-73 | *internal planning reference — see repo history* | — | 11 |
| THE-101 | `session_bootstrap` tool (THE-101). | CHANGELOG.md (1.4.0) | 3 |
| THE-132 | *internal planning reference — see repo history* | — | 3 |
| THE-134 | *internal planning reference — see repo history* | — | 2 |
| THE-135 | *internal planning reference — see repo history* | — | 2 |
| THE-136 | Anticipatory context prefetch (THE-136). | CHANGELOG.md (1.7.0) | 6 |
| THE-160 | *internal planning reference — see repo history* | — | 2 |
| THE-170 | *internal planning reference — see repo history* | — | 7 |
| THE-175 | Source-agnostic ambient-capture import format + Pensieve adapter, staged via `capture_queue` (#841, THE-175). | CHANGELOG.md (1.23.0) | 16 |
| THE-176 | *internal planning reference — see repo history* | — | 1 |
| THE-178 | *internal planning reference — see repo history* | — | 1 |
| THE-180 | *internal planning reference — see repo history* | — | 9 |
| THE-181 | *internal planning reference — see repo history* | — | 10 |
| THE-182 | *internal planning reference — see repo history* | — | 5 |
| THE-183 | *internal planning reference — see repo history* | — | 4 |
| THE-184 | *internal planning reference — see repo history* | — | 1 |
| THE-185 | *internal planning reference — see repo history* | — | 1 |
| THE-186 | *internal planning reference — see repo history* | — | 1 |
| THE-187 | *internal planning reference — see repo history* | — | 8 |
| THE-193 | *internal planning reference — see repo history* | — | 2 |
| THE-196 | *internal planning reference — see repo history* | — | 1 |
| THE-197 | Idempotency observability wired (THE-197). | CHANGELOG.md (1.3.0) | 4 |
| THE-198 | *internal planning reference — see repo history* | — | 3 |
| THE-202 | *internal planning reference — see repo history* | — | 1 |
| THE-207 | Templater expansion for periodic notes (THE-207). | CHANGELOG.md (1.3.0) | 3 |
| THE-208 | *internal planning reference — see repo history* | — | 3 |
| THE-209 | In-session tool-invocation tracing (THE-209). | CHANGELOG.md (1.3.0) | 5 |
| THE-210 | Dispatch-wide rate limiting (THE-210) | CHANGELOG.md (1.0.1) | 9 |
| THE-211 | *internal planning reference — see repo history* | — | 2 |
| THE-212 | *internal planning reference — see repo history* | — | 2 |
| THE-219 | Tool-visibility scoping (THE-219): | CHANGELOG.md (1.2.1) | 11 |
| THE-221 | Conditional temporal retrieval stream, flag-gated (THE-221 Phase 1). | CHANGELOG.md (1.6.0) | 5 |
| THE-222 | `reflect` — the third verb, as one callable operation (THE-222). | CHANGELOG.md (1.7.0) | 12 |
| THE-227 | The experiential tier is live (THE-227 family — Phase 2 of the converged-engine plan). | CHANGELOG.md (1.6.0) | 5 |
| THE-228 | *internal planning reference — see repo history* | — | 12 |
| THE-229 | *internal planning reference — see repo history* | — | 8 |
| THE-230 | *internal planning reference — see repo history* | — | 12 |
| THE-231 | Proactive lesson surfacing in vault\_context (THE-231). | CHANGELOG.md (1.7.0) | 4 |
| THE-232 | *internal planning reference — see repo history* | — | 3 |
| THE-233 | *internal planning reference — see repo history* | — | 27 |
| THE-235 | *internal planning reference — see repo history* | — | 4 |
| THE-237 | *internal planning reference — see repo history* | — | 2 |
| THE-238 | *internal planning reference — see repo history* | — | 11 |
| THE-239 | Dependency-aware deletion + hash-chained forget audit (THE-239). | CHANGELOG.md (1.8.0) | 8 |
| THE-249 | *internal planning reference — see repo history* | — | 2 |
| THE-250 | Per-caller tool-visibility filtering (THE-250): | CHANGELOG.md (1.2.1) | 4 |
| THE-251 | Terse search projection (THE-251). | CHANGELOG.md (1.3.0) | 2 |
| THE-252 | *internal planning reference — see repo history* | — | 2 |
| THE-255 | Headless VaultBackend, lean v1 (THE-255): | CHANGELOG.md (1.2.1) | 7 |
| THE-258 | *internal planning reference — see repo history* | — | 5 |
| THE-266 | Zero-copy `Float32Array` cosine on the native brute-force path (THE-266). | CHANGELOG.md (1.3.0) | 2 |
| THE-267 | HTTP tokens are now bound to a single vault (THE-267). | CHANGELOG.md (1.3.0) | 9 |
| THE-268 | Fail-closed ACL defaults (THE-268). | CHANGELOG.md (1.3.0) | 4 |
| THE-269 | Folder ACL checks are canonicalized through symlinks (THE-269). | CHANGELOG.md (1.3.0) | 2 |
| THE-270 | Bridge tools fail closed under a read whitelist (THE-270). | CHANGELOG.md (1.3.0) | 2 |
| THE-271 | DNS-rebinding / cross-origin protection on the HTTP transport (THE-271). | CHANGELOG.md (1.3.0) | 3 |
| THE-272 | Unicode-normalization-insensitive folder ACL (THE-272). | CHANGELOG.md (1.3.0) | 5 |
| THE-273 | SQLite per-connection baseline + prepared-statement cache (THE-273). | CHANGELOG.md (1.3.0) | 4 |
| THE-275 | Domain-verb facade mode (shipped under THE-275 — see correction). | CHANGELOG.md (1.3.0) | 3 |
| THE-277 | Parallelized the contradiction sweep (THE-277). | CHANGELOG.md (1.3.0) | 6 |
| THE-278 | Repo docs reconciled with reality (THE-278). | CHANGELOG.md (1.3.0) | 8 |
| THE-280 | Bases model realigned to shipped Obsidian 1.12 syntax, additive-with-deprecation (THE-280). | CHANGELOG.md (1.3.0) | 2 |
| THE-281 | Obsidian Bases expression DSL subset evaluator (THE-281). | CHANGELOG.md (1.3.0) | 2 |
| THE-282 | Companion installable-product hardening (THE-282). | CHANGELOG.md (1.3.0) | 7 |
| THE-284 | Obsidian-fit fixes (THE-284). | CHANGELOG.md (1.3.0) | 2 |
| THE-286 | Uniform symlink-canonical ACL enforcement (THE-286). | CHANGELOG.md (1.3.0) | 1 |
| THE-287 | Semantic search no longer crowds out ACL-visible hits (THE-287). | CHANGELOG.md (1.3.0) | 7 |
| THE-288 | `server_health` surfaces search-index degradation (THE-288). | CHANGELOG.md (1.3.0) | 7 |
| THE-289 | `execute_template` honors `overwrite` — no more silent clobber (THE-289). | CHANGELOG.md (1.3.0) | 2 |
| THE-291 | Metadata tools read the notes table (THE-291, part 3B-ii). | CHANGELOG.md (1.3.0) | 23 |
| THE-292 | Periodic cache.db maintenance sweep (THE-292). | CHANGELOG.md (1.3.0) | 5 |
| THE-293 | Compute-abuse budgets (THE-293). | CHANGELOG.md (1.3.0) | 11 |
| THE-294 | Dropped one payload serialization per tool call (THE-294). | CHANGELOG.md (1.3.0) | 3 |
| THE-295 | Per-vault ACL (THE-295). | CHANGELOG.md (1.3.0) | 8 |
| THE-296 | SleepTime plane scheduler wired (THE-296). | CHANGELOG.md (1.3.0) | 2 |
| THE-297 | Asymmetric JWT verification — RS256/ES256/EdDSA + JWKS + kid rotation (THE-297). | CHANGELOG.md (1.3.0) | 4 |
| THE-302 | `elicitTtlSeconds` now governs HITL token TTL (THE-302). | CHANGELOG.md (1.3.3) | 2 |
| THE-303 | *internal planning reference — see repo history* | — | 2 |
| THE-308 | Cohere query embeddings use the query encoding (THE-308). | CHANGELOG.md (1.3.5) | 2 |
| THE-309 | `knowledge_challenge` gives the judge tags + open contradictions (THE-309). | CHANGELOG.md (1.3.5) | 1 |
| THE-310 | Multi-vault GraphRAG edge isolation (THE-310). | CHANGELOG.md (1.3.5) | 6 |
| THE-316 | *internal planning reference — see repo history* | — | 3 |
| THE-374 | *internal planning reference — see repo history* | — | 7 |
| THE-375 | *internal planning reference — see repo history* | — | 1 |
| THE-376 | *internal planning reference — see repo history* | — | 3 |
| THE-378 | Obsidian Git + Remotely Save bridges (THE-378, THE-381). | CHANGELOG.md (1.8.0) | 3 |
| THE-379 | *internal planning reference — see repo history* | — | 1 |
| THE-380 | *internal planning reference — see repo history* | — | 1 |
| THE-381 | Obsidian Git + Remotely Save bridges (THE-378, THE-381). | CHANGELOG.md (1.8.0) | 2 |
| THE-383 | *internal planning reference — see repo history* | — | 1 |
| THE-387 | *internal planning reference — see repo history* | — | 6 |
| THE-388 | *internal planning reference — see repo history* | — | 12 |
| THE-390 | Embed batches no longer overrun a small provider context, and a rejected request no longer aborts the whole reindex (THE-390). | CHANGELOG.md (1.5.0) | 7 |
| THE-391 | *internal planning reference — see repo history* | — | 6 |
| THE-393 | *internal planning reference — see repo history* | — | 7 |
| THE-394 | *internal planning reference — see repo history* | — | 5 |
| THE-395 | Configurable `bge-m3` embeddings provider (THE-395). | CHANGELOG.md (1.5.0) | 3 |
| THE-397 | graph\_rrf fusion constant k: 60 → 10 (THE-397), config-exposed as `retrieval.rrfK`. | CHANGELOG.md (1.5.0) | 3 |
| THE-398 | Convex-combination fusion mode, flag-gated (THE-398). | CHANGELOG.md (1.5.0) | 4 |
| THE-400 | Z-margin confidence signal (THE-400). | CHANGELOG.md (1.5.0) | 4 |
| THE-401 | Smooth expansion scoring, flag-gated (THE-401). | CHANGELOG.md (1.5.0) | 3 |
| THE-403 | *internal planning reference — see repo history* | — | 1 |
| THE-405 | Asymmetric embedding prefixes, config-driven (THE-405). | CHANGELOG.md (1.5.0) | 4 |
| THE-406 | Contextual chunk enrichment, flag-gated (THE-406). | CHANGELOG.md (1.5.0) | 13 |
| THE-408 | chunk\_fts divergence-rebuild is enrichment-aware (THE-408). | CHANGELOG.md (1.6.0) | 4 |
| THE-413 | *internal planning reference — see repo history* | — | 2 |
| THE-414 | *internal planning reference — see repo history* | — | 7 |
| THE-415 | *internal planning reference — see repo history* | — | 6 |
| THE-417 | *internal planning reference — see repo history* | — | 36 |
| THE-418 | *internal planning reference — see repo history* | — | 1 |
| THE-420 | *internal planning reference — see repo history* | — | 4 |
| THE-421 | *internal planning reference — see repo history* | — | 1 |
| THE-424 | `experiential.activationRerank` now applies a ranking change (#762, THE-424 Part A, THE-535). | CHANGELOG.md (1.21.0) | 16 |
| THE-441 | *internal planning reference — see repo history* | — | 2 |
| THE-445 | *internal planning reference — see repo history* | — | 2 |
| THE-447 | *internal planning reference — see repo history* | — | 1 |
| THE-448 | *internal planning reference — see repo history* | — | 9 |
| THE-450 | *internal planning reference — see repo history* | — | 5 |
| THE-451 | *internal planning reference — see repo history* | — | 3 |
| THE-452 | *internal planning reference — see repo history* | — | 3 |
| THE-453 | *internal planning reference — see repo history* | — | 4 |
| THE-454 | *internal planning reference — see repo history* | — | 5 |
| THE-455 | *internal planning reference — see repo history* | — | 6 |
| THE-456 | *internal planning reference — see repo history* | — | 7 |
| THE-457 | *internal planning reference — see repo history* | — | 10 |
| THE-458 | THE-458 remainders closed | CHANGELOG.md (1.12.0) | 11 |
| THE-459 | *internal planning reference — see repo history* | — | 3 |
| THE-460 | *internal planning reference — see repo history* | — | 9 |
| THE-461 | *internal planning reference — see repo history* | — | 7 |
| THE-462 | *internal planning reference — see repo history* | — | 10 |
| THE-463 | *internal planning reference — see repo history* | — | 3 |
| THE-465 | *internal planning reference — see repo history* | — | 13 |
| THE-466 | *internal planning reference — see repo history* | — | 9 |
| THE-467 | *internal planning reference — see repo history* | — | 3 |
| THE-486 | *internal planning reference — see repo history* | — | 3 |
| THE-487 | *internal planning reference — see repo history* | — | 1 |
| THE-488 | *internal planning reference — see repo history* | — | 5 |
| THE-489 | *internal planning reference — see repo history* | — | 2 |
| THE-490 | *internal planning reference — see repo history* | — | 8 |
| THE-491 | *internal planning reference — see repo history* | — | 6 |
| THE-496 | *internal planning reference — see repo history* | — | 11 |
| THE-497 | *internal planning reference — see repo history* | — | 11 |
| THE-499 | *internal planning reference — see repo history* | — | 3 |
| THE-500 | *internal planning reference — see repo history* | — | 2 |
| THE-501 | *internal planning reference — see repo history* | — | 3 |
| THE-502 | *internal planning reference — see repo history* | — | 2 |
| THE-504 | *internal planning reference — see repo history* | — | 5 |
| THE-507 | *internal planning reference — see repo history* | — | 6 |
| THE-509 | *internal planning reference — see repo history* | — | 2 |
| THE-510 | Contributor tooling and an MCP client compatibility matrix (THE-624, THE-510, #567). | CHANGELOG.md (1.14.0) | 1 |
| THE-512 | *internal planning reference — see repo history* | — | 1 |
| THE-513 | *internal planning reference — see repo history* | — | 4 |
| THE-514 | *internal planning reference — see repo history* | — | 10 |
| THE-515 | *internal planning reference — see repo history* | — | 2 |
| THE-516 | *internal planning reference — see repo history* | — | 6 |
| THE-517 | *internal planning reference — see repo history* | — | 6 |
| THE-518 | *internal planning reference — see repo history* | — | 4 |
| THE-520 | *internal planning reference — see repo history* | — | 5 |
| THE-521 | *internal planning reference — see repo history* | — | 9 |
| THE-522 | *internal planning reference — see repo history* | — | 10 |
| THE-523 | *internal planning reference — see repo history* | — | 6 |
| THE-526 | *internal planning reference — see repo history* | — | 4 |
| THE-527 | *internal planning reference — see repo history* | — | 4 |
| THE-530 | *internal planning reference — see repo history* | — | 7 |
| THE-531 | *internal planning reference — see repo history* | — | 9 |
| THE-532 | *internal planning reference — see repo history* | — | 2 |
| THE-533 | *internal planning reference — see repo history* | — | 2 |
| THE-535 | `experiential.activationRerank` now applies a ranking change (#762, THE-424 Part A, THE-535). | CHANGELOG.md (1.21.0) | 3 |
| THE-536 | *internal planning reference — see repo history* | — | 2 |
| THE-537 | *internal planning reference — see repo history* | — | 8 |
| THE-538 | *internal planning reference — see repo history* | — | 10 |
| THE-543 | *internal planning reference — see repo history* | — | 5 |
| THE-545 | *internal planning reference — see repo history* | — | 1 |
| THE-546 | *internal planning reference — see repo history* | — | 1 |
| THE-548 | *internal planning reference — see repo history* | — | 3 |
| THE-561 | *internal planning reference — see repo history* | — | 2 |
| THE-562 | *internal planning reference — see repo history* | — | 14 |
| THE-563 | *internal planning reference — see repo history* | — | 14 |
| THE-564 | *internal planning reference — see repo history* | — | 3 |
| THE-565 | *internal planning reference — see repo history* | — | 4 |
| THE-567 | *internal planning reference — see repo history* | — | 4 |
| THE-568 | *internal planning reference — see repo history* | — | 8 |
| THE-569 | Reverse vault-kind gate: mutation of a docs/system vault is now refused (THE-569, closing the P1.5 boundary above) | CHANGELOG.md (1.11.0) | 3 |
| THE-571 | *internal planning reference — see repo history* | — | 4 |
| THE-572 | *internal planning reference — see repo history* | — | 15 |
| THE-573 | *internal planning reference — see repo history* | — | 2 |
| THE-577 | *internal planning reference — see repo history* | — | 2 |
| THE-578 | *internal planning reference — see repo history* | — | 3 |
| THE-579 | *internal planning reference — see repo history* | — | 3 |
| THE-582 | *internal planning reference — see repo history* | — | 4 |
| THE-583 | Request bodies are parsed once, not twice (THE-583, #553). | CHANGELOG.md (1.13.0) | 19 |
| THE-585 | *internal planning reference — see repo history* | — | 22 |
| THE-588 | *internal planning reference — see repo history* | — | 6 |
| THE-589 | `generate_uri`'s `vault` input is renamed `vault_name` (THE-589). | CHANGELOG.md (1.12.0) | 1 |
| THE-590 | *internal planning reference — see repo history* | — | 2 |
| THE-591 | *internal planning reference — see repo history* | — | 7 |
| THE-600 | *internal planning reference — see repo history* | — | 4 |
| THE-603 | *internal planning reference — see repo history* | — | 8 |
| THE-605 | *internal planning reference — see repo history* | — | 5 |
| THE-606 | `bearer_methods_supported` in Protected Resource Metadata, and a per-vault audit breakdown (THE-661, THE-606, THE-625, THE-614). | CHANGELOG.md (1.14.0) | 2 |
| THE-607 | `bun run map` and `check:boundaries` refuse to run against a stale `dist/` (THE-664, THE-607, THE-604). | CHANGELOG.md (1.14.0) | 1 |
| THE-609 | `forget` audit parity, including on a no-op (THE-609, #542). | CHANGELOG.md (1.13.0) | 1 |
| THE-610 | *internal planning reference — see repo history* | — | 7 |
| THE-611 | `gap_report` — a read-only MCP view over the gap-detector's last pass (THE-611, THE-616, THE-644 item 1). | CHANGELOG.md (1.14.0) | 8 |
| THE-612 | Durable episode amendment chain and two silent-failure signals (THE-654, THE-653, THE-645, THE-612, #563). | CHANGELOG.md (1.14.0) | 4 |
| THE-613 | A judge that did not ANSWER is no longer counted as one that answered unparseably (#732, #734, THE-717, THE-613). | CHANGELOG.md (1.20.0) | 7 |
| THE-615 | Gateway retry with backoff, and a liveness probe (THE-615, THE-617, #566). | CHANGELOG.md (1.14.0) | 2 |
| THE-616 | `gap_report` — a read-only MCP view over the gap-detector's last pass (THE-611, THE-616, THE-644 item 1). | CHANGELOG.md (1.14.0) | 9 |
| THE-617 | Gateway retry with backoff, and a liveness probe (THE-615, THE-617, #566). | CHANGELOG.md (1.14.0) | 4 |
| THE-618 | The ACL predicates no longer recompile a glob per rule per path (THE-618, #638). | CHANGELOG.md (1.14.0) | 4 |
| THE-619 | The poison-scan capture path is bounded, and the secret patterns cover more token shapes (THE-619). | CHANGELOG.md (1.14.0) | 3 |
| THE-620 | QueryCache expiry sweep, `via_edge` deep copy, and two smaller correctness fixes (THE-626, THE-620, THE-622, #565). | CHANGELOG.md (1.14.0) | 1 |
| THE-621 | The stage-2 judge fan-out is bounded and the kill switch has a floor (#703, THE-621). | CHANGELOG.md (1.20.0) | 3 |
| THE-622 | QueryCache expiry sweep, `via_edge` deep copy, and two smaller correctness fixes (THE-626, THE-620, THE-622, #565). | CHANGELOG.md (1.14.0) | 2 |
| THE-625 | `bearer_methods_supported` in Protected Resource Metadata, and a per-vault audit breakdown (THE-661, THE-606, THE-625, THE-614). | CHANGELOG.md (1.14.0) | 2 |
| THE-626 | QueryCache expiry sweep, `via_edge` deep copy, and two smaller correctness fixes (THE-626, THE-620, THE-622, #565). | CHANGELOG.md (1.14.0) | 1 |
| THE-627 | *internal planning reference — see repo history* | — | 8 |
| THE-628 | Note-level and cluster-level summary tiers, dark by default (#817, #818, THE-628). | CHANGELOG.md (1.22.0) | 19 |
| THE-629 | doctor: the entity tables have a writer (#702, THE-629); `job_schedule` orphans are pruned and the experiential charter is stated (#700, THE-715, THE-713). | CHANGELOG.md (1.20.0) | 2 |
| THE-630 | Federated multi-vault search with per-vault ACL (#809, THE-630). | CHANGELOG.md (1.22.0) | 9 |
| THE-631 | The episode amendment chain is exposed, and `graphSearch` reports coverage (THE-655, THE-631). | CHANGELOG.md (1.14.0) | 12 |
| THE-632 | The lexical and sparse arms filter by ACL at query time (THE-632, #644). | CHANGELOG.md (1.14.0) | 16 |
| THE-633 | *internal planning reference — see repo history* | — | 9 |
| THE-634 | Proactive advisory surfacing, off by default (#779, #810, THE-634). | CHANGELOG.md (1.22.0) | 16 |
| THE-635 | Point-in-time `since`/`until` retrieval filter (#824, THE-635). | CHANGELOG.md (1.22.0) | 9 |
| THE-636 | Vendor-neutral export/import of the derived plane (#808, THE-636). | CHANGELOG.md (1.22.0) | 10 |
| THE-639 | A sanctioned, poison-scanned path for agent-synthesised notes (#814, THE-639). | CHANGELOG.md (1.22.0) | 7 |
| THE-641 | *internal planning reference — see repo history* | — | 1 |
| THE-642 | `work_search` gains an opt-in `semantic` mode (#820, THE-642). | CHANGELOG.md (1.22.0) | 5 |
| THE-643 | Scheduled `note_quality` recompute (THE-643, THE-625 items 1-3). | CHANGELOG.md (1.14.0) | 14 |
| THE-644 | `gap_report` — a read-only MCP view over the gap-detector's last pass (THE-611, THE-616, THE-644 item 1). | CHANGELOG.md (1.14.0) | 14 |
| THE-645 | Durable episode amendment chain and two silent-failure signals (THE-654, THE-653, THE-645, THE-612, #563). | CHANGELOG.md (1.14.0) | 19 |
| THE-646 | `explain_answer` — the retrieval → chunk → citation → episode lineage chain (#705, THE-646 item 2). | CHANGELOG.md (1.20.0) | 6 |
| THE-647 | Differential `vault_context` and persona scoping (#811, THE-647). | CHANGELOG.md (1.22.0) | 17 |
| THE-648 | `snapshots.enabled` now defaults to `true` (THE-648, #569). | CHANGELOG.md (1.14.0) | 7 |
| THE-649 | *internal planning reference — see repo history* | — | 4 |
| THE-650 | Source-agnostic highlight-import format + Readwise adapter, staged via `capture_queue` (#839, THE-650). | CHANGELOG.md (1.23.0) | 13 |
| THE-653 | Durable episode amendment chain and two silent-failure signals (THE-654, THE-653, THE-645, THE-612, #563). | CHANGELOG.md (1.14.0) | 2 |
| THE-654 | Durable episode amendment chain and two silent-failure signals (THE-654, THE-653, THE-645, THE-612, #563). | CHANGELOG.md (1.14.0) | 1 |
| THE-655 | The episode amendment chain is exposed, and `graphSearch` reports coverage (THE-655, THE-631). | CHANGELOG.md (1.14.0) | 1 |
| THE-657 | The vault watcher is enabled on Windows (#715, THE-657). | CHANGELOG.md (1.20.0) | 5 |
| THE-658 | `obsidian-tc token mint` — reproducible, auditable bearer tokens (THE-658, #539). | CHANGELOG.md (1.13.0) | 8 |
| THE-659 | Enabling `observability.prometheus` no longer kills the MCP HTTP server under Bun (THE-659, #535). | CHANGELOG.md (1.12.1) | 3 |
| THE-661 | `bearer_methods_supported` in Protected Resource Metadata, and a per-vault audit breakdown (THE-661, THE-606, THE-625, THE-614). | CHANGELOG.md (1.14.0) | 1 |
| THE-663 | `vec0` is embedded in `--compile` release binaries (THE-663, #568). | CHANGELOG.md (1.14.0) | 3 |
| THE-665 | Every durable job enqueue was broken under Bun, the production runtime (THE-665). | CHANGELOG.md (1.14.0) | 4 |
| THE-666 | The scheduler's durable-persistence failures have an error channel (THE-666). | CHANGELOG.md (1.14.0) | 3 |
| THE-667 | The idempotency-claim release has an error channel (THE-667, #641). | CHANGELOG.md (1.14.0) | 2 |
| THE-672 | *internal planning reference — see repo history* | — | 3 |
| THE-673 | Preference counters are now deterministic over typed evidence (#805, THE-673). | CHANGELOG.md (1.22.0) | 7 |
| THE-674 | *internal planning reference — see repo history* | — | 1 |
| THE-675 | *internal planning reference — see repo history* | — | 1 |
| THE-677 | Pluggable embedding and rerank provider slots (THE-677, #628, #631). | CHANGELOG.md (1.14.0) | 2 |
| THE-678 | A credential error names the config block that actually holds the key (THE-680, THE-678, #633). | CHANGELOG.md (1.14.0) | 1 |
| THE-679 | `doctor` pre-detects an unbuildable reranker, and names the declared one (THE-679, THE-681, #632). | CHANGELOG.md (1.14.0) | 6 |
| THE-680 | A credential error names the config block that actually holds the key (THE-680, THE-678, #633). | CHANGELOG.md (1.14.0) | 3 |
| THE-681 | `doctor` pre-detects an unbuildable reranker, and names the declared one (THE-679, THE-681, #632). | CHANGELOG.md (1.14.0) | 1 |
| THE-683 | `RepresentationManifest` has a production producer, and `embeddings.pooling` now moves the index identity (THE-683, #636). | CHANGELOG.md (1.14.0) | 8 |
| THE-687 | *internal planning reference — see repo history* | — | 2 |
| THE-688 | `doctor` says "configured", not "ready", for the dense retrieval head (THE-688, #642). | CHANGELOG.md (1.14.0) | 11 |
| THE-691 | The query router's rare-term signal no longer leaks term existence across the ACL (THE-691, #645). | CHANGELOG.md (1.14.0) | 1 |
| THE-692 | `--max-per-cluster` in the eval harness (THE-692, #646). | CHANGELOG.md (1.14.0) | 2 |
| THE-693 | `retrieval.graphStream` config surface (THE-693, #650). | CHANGELOG.md (1.14.0) | 3 |
| THE-694 | The router's timing oracle is closed, and BM25 no longer leaks its result length (THE-694, THE-695, #649). | CHANGELOG.md (1.14.0) | 10 |
| THE-695 | The router's timing oracle is closed, and BM25 no longer leaks its result length (THE-694, THE-695, #649). | CHANGELOG.md (1.14.0) | 9 |
| THE-696 | `notes_fts` integrity is checkable, and repairable (THE-696, #648). | CHANGELOG.md (1.14.0) | 6 |
| THE-697 | Bun's 10-second default request timeout no longer kills long MCP calls (THE-697, #648). | CHANGELOG.md (1.14.0) | 3 |
| THE-698 | Scheduled episode evaluation (THE-698, #648). | CHANGELOG.md (1.14.0) | 7 |
| THE-699 | `--acl-allow` — the eval harness can finally vary ACL state (THE-699, #660). | CHANGELOG.md (1.15.0) | 2 |
| THE-700 | Every scheduled consolidation pass died on a serverless cold start, and one failure cost the whole period (THE-700, #659). | CHANGELOG.md (1.15.0) | 3 |
| THE-701 | The episode-eligibility judge (THE-701, #661). | CHANGELOG.md (1.15.0) | 7 |
| THE-705 | A bundled `local` cross-encoder reranker — `gatedRerank` with no gateway and no external service (#806, THE-705). | CHANGELOG.md (1.22.0) | 9 |
| THE-707 | THE-707 — experiential-tier benchmark applicability assessment (no adapter built). | CHANGELOG.md (1.23.0) | 1 |
| THE-709 | Consolidation jobs get a per-attempt gateway timeout (THE-709). | CHANGELOG.md (1.16.0) | 2 |
| THE-710 | `preference_profile` / `preference_deltas` are namespaced by vault (#675, THE-710). | CHANGELOG.md (1.17.0) | 7 |
| THE-711 | `chunk_fts` is contentless, keyed on the chunks rowid (#728, THE-711). | CHANGELOG.md (1.20.0) | 8 |
| THE-713 | doctor: the entity tables have a writer (#702, THE-629); `job_schedule` orphans are pruned and the experiential charter is stated (#700, THE-715, THE-713). | CHANGELOG.md (1.20.0) | 3 |
| THE-714 | *internal planning reference — see repo history* | — | 6 |
| THE-715 | doctor: the entity tables have a writer (#702, THE-629); `job_schedule` orphans are pruned and the experiential charter is stated (#700, THE-715, THE-713). | CHANGELOG.md (1.20.0) | 4 |
| THE-716 | `job_runs` was empty while 128 jobs had completed (#685, THE-716). | CHANGELOG.md (1.17.1) | 5 |
| THE-717 | A judge that did not ANSWER is no longer counted as one that answered unparseably (#732, #734, THE-717, THE-613). | CHANGELOG.md (1.20.0) | 25 |
| THE-718 | `record_retrieval_feedback` says when to call it (#678, THE-718). | CHANGELOG.md (1.17.0) | 15 |
| THE-719 | The coverage-gap sweep can be scheduled (#675, THE-719). | CHANGELOG.md (1.17.0) | 7 |
| THE-720 | *internal planning reference — see repo history* | — | 9 |
| THE-721 | *internal planning reference — see repo history* | — | 1 |
| THE-722 | `check:table-readers` — a CI gate for write-only tables (#683, THE-722). | CHANGELOG.md (1.17.1) | 5 |
| THE-723 | The plane re-ran its own completed once-per-period work on every tick (#687, THE-723). | CHANGELOG.md (1.18.0) | 3 |
| THE-725 | *internal planning reference — see repo history* | — | 2 |
| THE-726 | The HTTP transport can now carry a workspace session, and optionally opens one itself (#691, #692, #693, THE-726). | CHANGELOG.md (1.19.0) | 32 |
| THE-727 | Operation-aware authorization (#697, THE-727). | CHANGELOG.md (1.20.0) | 4 |
| THE-730 | *internal planning reference — see repo history* | — | 1 |
| THE-732 | *internal planning reference — see repo history* | — | 1 |
| THE-733 | Per-vault score calibration, and the confidence it makes possible (#711, THE-733, THE-631 item 1). | CHANGELOG.md (1.20.0) | 11 |
| THE-735 | *internal planning reference — see repo history* | — | 1 |
| THE-736 | `rerun` — re-run a recorded session against current vault state (#722, #721, #720, THE-645 item 3, THE-736, THE-737). | CHANGELOG.md (1.20.0) | 11 |
| THE-737 | `rerun` — re-run a recorded session against current vault state (#722, #721, #720, THE-645 item 3, THE-736, THE-737). | CHANGELOG.md (1.20.0) | 11 |
| THE-738 | Rerun hygiene: WAL staging, audit attribution, policy refusals, exit codes (#730, THE-738, THE-739, THE-740, THE-742). | CHANGELOG.md (1.20.0) | 3 |
| THE-739 | Rerun hygiene: WAL staging, audit attribution, policy refusals, exit codes (#730, THE-738, THE-739, THE-740, THE-742). | CHANGELOG.md (1.20.0) | 1 |
| THE-740 | Rerun hygiene: WAL staging, audit attribution, policy refusals, exit codes (#730, THE-738, THE-739, THE-740, THE-742). | CHANGELOG.md (1.20.0) | 1 |
| THE-741 | `rerun` reports `served_from_cache` for an idempotent replay instead of spurious divergence (#828, THE-741). | CHANGELOG.md (1.22.0) | 5 |
| THE-742 | Rerun hygiene: WAL staging, audit attribution, policy refusals, exit codes (#730, THE-738, THE-739, THE-740, THE-742). | CHANGELOG.md (1.20.0) | 2 |
| THE-743 | `ToolAnnotations.idempotentHint` (#733, THE-743). | CHANGELOG.md (1.20.0) | 2 |
| THE-744 | An invocation that plans zero passes now records that it ran (#733, THE-744). | CHANGELOG.md (1.20.0) | 6 |
| THE-745 | `busy_timeout` is installed before any pragma that can contend (#723, THE-745). | CHANGELOG.md (1.20.0) | 4 |
| THE-746 | Per-decision eligibility reasons (#733, THE-746). | CHANGELOG.md (1.20.0) | 5 |
| THE-747 | `reflect --max-judged` outlived the judge it capped (#724, THE-747). | CHANGELOG.md (1.20.0) | 2 |
| THE-748 | *internal planning reference — see repo history* | — | 1 |
| THE-749 | *internal planning reference — see repo history* | — | 1 |
| THE-750 | Read-only consumers refuse a stale `chunk_fts` instead of silently mis-joining it (#755, THE-750). | CHANGELOG.md (1.21.0) | 4 |
| THE-752 | A writer for `agent_episodes.summary` — Tier 0, deterministic (#819, THE-752). | CHANGELOG.md (1.22.0) | 4 |
| THE-804 | The coverage-gap sweep scopes its query source per vault (#776, THE-804). | CHANGELOG.md (1.22.0) | 2 |
| THE-805 | *internal planning reference — see repo history* | — | 1 |
| THE-806 | The eval harness's `--gated-rerank` flag now builds the SAME reranker and hardness gate production would (#812, THE-806 step 2). | CHANGELOG.md (1.22.0) | 5 |
| THE-822 | `plane.enabled: false` now also stops the per-index-write contradiction path (#788, THE-822). | CHANGELOG.md (1.22.0) | 3 |
| THE-823 | The three facade triad schemas (`find_capability`, `describe_capability`, `call_capability`) now reject an unrecognized envelope key instead of silently dropping it (#784, #789, THE-823). | CHANGELOG.md (1.22.0) | 9 |
| THE-824 | The 16 conditionally-gated tools now advertise their confirmation gate (#790, THE-824). | CHANGELOG.md (1.22.0) | 17 |
| THE-825 | `plane.enabled` now defaults to `false` (was `true`) — ambient sleep-time consolidation is opt-in (#797, THE-825, GH #786). | CHANGELOG.md (1.22.0) | 9 |
| THE-826 | `obsidian-tc elicit` — a way to satisfy the confirmation gate (#796, THE-826). | CHANGELOG.md (1.22.0) | 5 |
| THE-832 | A root `gateway` config block (`baseUrl`/`token`) (#792, THE-832). | CHANGELOG.md (1.22.0) | 3 |
| THE-833 | Memory entities get a lifecycle — retire, rename, unlink, delete (#795, THE-833). | CHANGELOG.md (1.22.0) | 8 |
| THE-837 | The shared embedding transport no longer names any vendor (THE-837). | CHANGELOG.md (1.22.0) | 8 |
| THE-838 | `end_session` now refuses to end a session belonging to another principal (#803, THE-838). | CHANGELOG.md (1.22.0) | 3 |
| THE-839 | `episode_type` is a structural value, not a rendered literal (#802, THE-839). | CHANGELOG.md (1.22.0) | 10 |
| THE-852 | The graph-walk ACL filter is now wired into every M7 surface and defaults on (#815, THE-852). | CHANGELOG.md (1.22.0) | 10 |
| THE-853 | The adaptive-RRF IDF path is ACL-partitioned, closing a cross-ACL term-presence oracle (#830, THE-853). | CHANGELOG.md (1.22.0) | 8 |
| THE-854 | Superseded `cluster_summary` rows are garbage-collected (#829, THE-854). | CHANGELOG.md (1.22.0) | 2 |
| THE-855 | Captured content is poison-scanned at enqueue, and at commit (#823, #827, THE-855, THE-858). | CHANGELOG.md (1.22.0) | 9 |
| THE-858 | Captured content is poison-scanned at enqueue, and at commit (#823, #827, THE-855, THE-858). | CHANGELOG.md (1.22.0) | 1 |
| THE-860 | `/makemd/spaces` no longer silently degrades to an empty list (#837, THE-860). | CHANGELOG.md (1.23.0) | 1 |
| THE-861 | Client identity now reaches `tools/call` handlers (#834, THE-861). | CHANGELOG.md (1.23.0) | 2 |
| THE-862 | `client-features.ts`'s `logging/setLevel` comment now matches what the SDK actually does under legacy (#835, THE-862). | CHANGELOG.md (1.23.0) | 2 |
| THE-891 | Per-key preference scoping — human vs caller (#846, THE-891 item 6). | CHANGELOG.md (1.23.0) | 33 |
| THE-906 | The boot ready line, `doctor`, the capability profile and `server_health` could all report `native=on` / "native acceleration module loaded" while actually running the pure-JS fallback (THE-906, #858). | CHANGELOG.md (1.23.2) | 4 |
| THE-922 | A TLS trust failure was reported as "reload the plugin inside Obsidian" — the bridge transport discarded `e.cause`, collapsing every fetch failure into one indistinguishable state (THE-922, #861). | CHANGELOG.md (1.23.3) | 4 |
| THE-923 | The fetch cause was preserved only at `doFetch`, so a TLS-untrusted companion still misdirected every other transport (THE-923, #865). | CHANGELOG.md (1.23.4) | 7 |
| THE-924 | Four introspection tools leaked cross-vault identifiers to a vault-bound HTTP caller (THE-924, #864). | CHANGELOG.md (1.23.4) | 6 |
| THE-925 | A note edit during a full `index_vault` reconcile could silently revert that note's index to stale content (THE-925, #866). | CHANGELOG.md (1.23.4) | 7 |
| THE-926 | Retrieval fan-out silently swallowed a deliberate index-integrity refusal, and a valid search regex could be rejected as a ReDoS (THE-926, #867). | CHANGELOG.md (1.23.4) | 10 |
| THE-932 | A point-in-time (`as_of`) retrieval query no longer reads chunk content it discards (#874, THE-932). | CHANGELOG.md (1.23.6) | 1 |
| THE-934 | `egress.excludePaths` withholds vault-relative folders from every gateway and embedding call the server makes, plus `obsidian-tc consolidate --once [--dry-run]` (#886, THE-934; issue #880). | CHANGELOG.md (1.25.0) | 58 |
| THE-935 | `db.busyTimeoutMs` reachable from config (#902, THE-935; issue #878). | CHANGELOG.md (1.27.0) | 14 |
| THE-936 | `call_capability` now echoes the envelope keys it received on validation failure (#901, THE-936; issue #876). | CHANGELOG.md (1.27.0) | 1 |
| THE-937 | Catalog discovery on the triad facade (#884, THE-937; issue #877). | CHANGELOG.md (1.25.0) | 5 |
| THE-939 | `doctor` warns on sync-service conflict copies in the install directory (#900, THE-939; issue #881). | CHANGELOG.md (1.27.0) | 5 |
| THE-943 | Companion plugin renamed to TC Bridge (#888, THE-943). | CHANGELOG.md (1.26.0) | 2 |
| THE-944 | Local reranker reachable without a source checkout (#891, THE-944). | CHANGELOG.md (1.26.0) | 10 |
| THE-963 | The four `import()` sites community.obsidian.md's automated review flagged as errors now carry scoped disables, and the plugin's release assets are attested (#909, THE-963). | CHANGELOG.md (1.28.0) | 3 |
| THE-1037 | `call_capability` never redeemed an `elicit_token` nested in its inner `args` (#931, GH #925, THE-1037). | CHANGELOG.md (1.29.0) | 3 |
| THE-1038 | `patch_note` heading anchor correctness, `read_note` section read, exact-string replace (#932, THE-1038, #922, #926, #927, #928). | CHANGELOG.md (1.29.0) | 4 |
| THE-1039 | The maintenance sweep now runs FTS5's own `'merge'` on `notes_fts`/`chunk_fts`, instead of relying on `PRAGMA optimize` (which explicitly excludes virtual tables) to do it (THE-1039, GH #929). | CHANGELOG.md (1.29.0) | 18 |
| THE-1040 | The frontmatter emitter now works on the original block's LINES, fixing a root flow mapping losing or duplicating keys, two broken removals and two lost-comment gaps (THE-1043; regressions of THE-1040, #937; #940). | CHANGELOG.md (1.30.0) | 1 |
| THE-1041 | `describe_capability` and `tools/list` advertised input schemas converted in zod's default `io:"output"` mode, diverging from what the server actually validates on 98 of 163 registered capabilities (GH #934, THE-1041, #938). | CHANGELOG.md (1.30.0) | 1 |
| THE-1042 | Validation errors now say the fix, not just the field (THE-1042, #939, GH #935). | CHANGELOG.md (1.30.0) | 5 |
| THE-1043 | The frontmatter emitter now works on the original block's LINES, fixing a root flow mapping losing or duplicating keys, two broken removals and two lost-comment gaps (THE-1043; regressions of THE-1040, #937; #940). | CHANGELOG.md (1.30.0) | 1 |
| THE-1044 | Frontmatter edits no longer leave a YAML alias dangling, and never trim a newly assigned string's trailing newlines (THE-1044, #941). | CHANGELOG.md (1.30.0) | 1 |
| THE-1045 | A frontmatter block whose colliding keys hid an anchor stopped round-tripping at all: the whole block was re-emitted by a plain stringify, losing every anchor, comment and byte of source formatting, and nothing said so (THE-1045, #943). | CHANGELOG.md (1.30.1) | 2 |
| THE-1073 | `index_vault` no longer aborts a whole vault's reconcile over one note with unparseable YAML frontmatter (THE-1073, PR #968). | CHANGELOG.md (1.31.4) | 13 |
| THE-1078 | TypeSafe Jev is now an opt-in judge provider for citation-inference's stage-2 verdict, beside the existing gateway chat judge (THE-1078, #950). | CHANGELOG.md (1.31.0) | 10 |
| THE-1079 | The local reranker's source-checkout resolution never actually worked from the BUILT server bundle, so its own doctor remedy was a no-op for every stdio install (THE-1079, #947, #949, #956). | CHANGELOG.md (1.31.1) | 5 |
| THE-1081 | A vault root reached through a symlinked ancestor (e.g. macOS `$TMPDIR` under `/var` -> `/private/var`) made the native addon refuse every read/write in that vault, while the JS fallback accepted it (THE-1081, #946, #955). | CHANGELOG.md (1.31.1) | 10 |
| THE-1082 | A client with no MCP elicitation support (Claude Code over stdio among them) had no way to clear an `elicit_required` gate at all (THE-1082, #945, #953). | CHANGELOG.md (1.31.1) | 6 |
| THE-1084 | `experiential.citationInfer.judge.baseUrl` can now be a plain `http://` URL when the operator explicitly opts in (THE-1084, #959). | CHANGELOG.md (1.31.2) | 4 |
| THE-1098 | Server instructions no longer name `record_retrieval_feedback` when the caller cannot call it (GH #964 part 1, THE-1098, PR #965). | CHANGELOG.md (1.31.4) | 6 |
| THE-1099 | `experiential.allowFeedbackInReadOnly` lets `record_retrieval_feedback` update derived telemetry under a read-only vault (GH #964 part 2, THE-1099, PR #966). | CHANGELOG.md (1.31.4) | 5 |
| THE-1106 | The `inputRequired` HITL round trip did nothing for the 16 handler-side-only conditionally-gated tools (`write_note` overwrite of a non-empty note, `move_note`/`copy_note`, `move_attachment`, `update_frontmatter` replace, `rewrite_link`, `prune_hub_links`, `restore_note`, `create_canvas`/`update_canvas`, `create_base`, `save_workspace`, `create_excalidraw`, `update_task`, `ocr_bulk`) — found in cross-vendor review of THE-1106 (GH #967), before it shipped. | CHANGELOG.md (1.31.4) | 11 |
| THE-1108 | An open explicit `start_session` session no longer absorbs a principal's traffic forever (THE-1108, PR #988). | CHANGELOG.md (1.31.5) | 19 |
| THE-1122 | Semantic search works out of the box: a bundled, fully offline local embedder is now the DEFAULT embeddings provider when the `embeddings` config block is absent (THE-1122, PR #980). | CHANGELOG.md (1.31.4) | 15 |
| THE-1123 | `toolFacade.mode` gains `"auto"` — picks the advertised tool surface per connecting client (THE-1123, PR #976). | CHANGELOG.md (1.31.4) | 15 |
| THE-1124 | `obsidian-tc memory import` and the "Memory you own" guide (THE-1124, PR #978). | CHANGELOG.md (1.31.4) | 12 |
| THE-1125 | Opt-in, anonymous usage telemetry (THE-1125, PR #982). | CHANGELOG.md (1.31.4) | 30 |
| THE-1130 | Validity intervals on memory observations — supersede instead of overwrite, and "what did we believe as\_of D" (THE-1130, PR #986). | CHANGELOG.md (1.31.4) | 15 |
| THE-1131 | New `toolFacade.profile` (`"full"` \| `"core"`, default `"full"`) — an OPT-IN, smaller curated tool surface; the default does not change (THE-1131, PR #984). | CHANGELOG.md (1.31.4) | 9 |
| THE-1133 | `@modelcontextprotocol/server` 2.0.0→2.1.0, dev `@modelcontextprotocol/sdk` 1.29.0→1.30.1 (THE-1133, PR 1). | CHANGELOG.md (1.31.4) | 1 |

376 distinct ticket(s) across 906 source file(s) under
`packages/*/src`; 222 resolved to a public summary, 154
fall back to the internal-reference placeholder above.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.