obsidian-tc 1.20.0 → 1.22.0

package/README.md

@@ -9,7 +9,7 @@ See the [repo root README](../../README.md) for project overview and the
 
 ## Status
 
-✅ **Shipped — v1.20.0.** The full tool surface (159 tools across 31 domains, milestones
+✅ **Shipped — v1.22.0.** The full tool surface (163 tools across 31 domains, milestones
 M0–M7) is implemented and released. Built on Bun + Hono with Zod 4 schemas; runs under
 Node `>=24` (the test suite runs vitest under Node for `node:sqlite`).
 
@@ -38,3 +38,5 @@ config + caches (no server needed):
 | `metrics [--since ms] [--until ms] [--json f]` | Knowledge-health scorecard from the derive layer |
 | `gaps --queries <f> / --calibrate <golden.yaml>` | Knowledge-gap detector / threshold calibration |
 | `forget (--episode <id> \| --note <rel>) [--erase] / --verify` | Dependency-aware deletion + hash-chained audit |
+| `context-export --out <f> [--vault id]` | Export the derived plane (preferences, episodes, note_quality, retrieval feedback, forget_log) as a versioned, vendor-neutral JSON bundle |
+| `context-import <bundle> [--vault id] [--dry-run]` | Import a context-export bundle. `--vault` remaps the bundle's vault-scoped rows to the target vault (refuses a multi-source-vault bundle); forget always wins over import |

package/SKILLS.md

@@ -163,13 +163,17 @@ want to do. Counts are approximate; the surface is 143 tools / 31 domains.
 
 These are the skills that set obsidian-tc apart. Teach your agent to prefer them.
 
-**Measured retrieval, not asserted.** Every ranking change is gated by an n=136
+**Measured retrieval, not asserted.** Every ranking change is gated by an n=250
 multi-hop golden set with a statistical ship rule (paired permutation, BH-FDR,
-a ΔnDCG ≥ 0.010 cost gate). The live champion: graph nDCG@10 **0.786**, recall@10
-**0.871**, bridge recall **0.831**. Contextual chunk enrichment measured **+0.223
-nDCG** and defaults on. The practical takeaway for an agent: **trust the default
-retrieval**, it is the measured optimum for this vault, and experimental streams
-that did not beat it ship *dark* behind flags (see below).
+a ΔnDCG ≥ 0.010 cost gate). Named "champion" figures previously quoted here were
+**withdrawn on 2026-08-07** (THE-748) as unreproducible; see
+[`docs/EVALUATION.md`](./docs/EVALUATION.md) for what is measured and how.
+Contextual chunk enrichment measured **+0.223 nDCG** and defaults on. The
+practical takeaway for an agent is narrower than it used to read: **the defaults
+are the measured configuration**, and experimental streams that did not beat
+their control ship *dark* behind flags (see below). There is currently **no
+published figure** for how the graph walk compares to plain dense retrieval on
+this corpus (THE-748) — do not quote one.
 
 **`vault_context`, the one-call context primitive.** Instead of hand-orchestrating
 search + graph + rerank, call `get_context(query, token_budget)` and get a
@@ -180,7 +184,8 @@ retrieval skill; reach for it first when answering from the vault.
 (retrieval events + dispatch episodes) into `experiential.db`, physically separate
 from your notes, with a pre-ingest secret/poison scanner and an outcome axis. By
 default it records the *action* axis only (tool, status, sizes, hashes, **no
-payloads**); `experiential.captureContent` opts into secret-scanned args. This is
+payloads**); `experiential.captureContent` adds secret-scanned args, on under the
+trusted-local posture and off under `hardened`. This is
 the substrate for a knowledge flywheel (`metrics`, `gaps`, `activation-recompute`),
 not something an agent reads as if it were authored content.
 
@@ -344,7 +349,7 @@ The complete option surface (every field, default, env var, and CLI command) is
 | `auth.mode` | `none` | `jwt` for anything non-loopback (required by the interlock). |
 | `toolFacade.mode` | `triad` | `flat` if your client prefers the full list. |
 | `transports.http.enabled` | false | Many-client / remote (then set auth). |
-| `experiential.captureContent` | false | Opt into storing (scanned) call args. |
+| `experiential.captureContent` | true | Stores (scanned) call args. `securityProfile: "hardened"` turns it off. |
 | `OBSIDIAN_TC_GATEWAY_URL` (env) | unset | Enable the generative tier (`reflect`, `densify-llm`, `plane`). |
 
 **Gotchas that bite new users**