grounder 0.4.0 → 0.6.0

package/dist/connector/state.js

@@ -1,14 +1,27 @@
-import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { readFile } from "node:fs/promises";
 import path from "node:path";
-import { fileExists } from "../util/fs.js";
+import { fileExists, writeFileAtomic } from "../util/fs.js";
+import { packageVersionRelation } from "../util/semver.js";
 import { resolveHomeDir } from "./home.js";
+import { applyLedgerUpgrades, LEDGER_SCHEMA, MIN_SUPPORTED_LEDGER_SCHEMA, } from "./ledger-migrations.js";
 import { UnsupportedSchemaError } from "./unsupported-schema.js";
+export { LEDGER_SCHEMA, MIN_SUPPORTED_LEDGER_SCHEMA } from "./ledger-migrations.js";
 export function statePath(homeDir) {
     return path.join(resolveHomeDir(homeDir), ".grounder", "state.json");
 }
 /**
  * Read `~/.grounder/state.json`. Missing file → `null` (legacy / pre-ledger
- * install — callers should treat missing agent entries as schema 0).
+ * install). A `ledgerSchema` older than current (only v0.5.0's real shape —
+ * `commandsSchema`/`hooksSchema`, no `ledgerSchema` field — has ever existed
+ * on disk) is upgraded to the current shape in memory only; disk is untouched
+ * until a real ledger write (`setup`/`migrate`/`setLedgerFileHash`/etc).
+ * `status`, `doctor`, and `handoff peek` must never write `state.json` as a
+ * side effect of reading it.
+ *
+ * The gate runs immediately after `JSON.parse`, ahead of the
+ * `grounderVersion`/`agents` validation below: a schema-2 file that
+ * restructures `agents` must report "upgrade grounder", not "missing
+ * agents — fix or remove it".
  */
 export async function readGrounderState(homeDir) {
     const filePath = statePath(homeDir);
@@ -23,149 +36,194 @@ export async function readGrounderState(homeDir) {
         const detail = error instanceof Error ? error.message : String(error);
         throw new Error(`Invalid grounder state at ${filePath}: ${detail}. Fix or remove it, then run: grounder migrate --force`);
     }
-    if (typeof raw.grounderVersion !== "string" || raw.grounderVersion.length === 0) {
+    if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+        // Same "missing grounderVersion" message a non-object payload already
+        // gets further down (`raw.grounderVersion` on a boxed number/string
+        // reads as `undefined`, not a throw) — `null` is the one JSON value
+        // whose property access throws before reaching that check, so it's
+        // guarded here explicitly rather than falling through.
+        throw new Error(`Invalid grounder state at ${filePath}: missing grounderVersion. Fix or remove it, then run: grounder migrate --force`);
+    }
+    let ledgerSchema;
+    if (raw.ledgerSchema === undefined) {
+        ledgerSchema = 0;
+    }
+    else if (typeof raw.ledgerSchema === "number" && Number.isInteger(raw.ledgerSchema)) {
+        ledgerSchema = raw.ledgerSchema;
+    }
+    else {
+        // Deliberate tightening, not preserved behavior: previously a non-number
+        // silently became `0`.
+        throw new Error(`Invalid grounder state at ${filePath}: ledgerSchema must be an integer. Fix or remove it, then run: grounder migrate --force`);
+    }
+    if (ledgerSchema > LEDGER_SCHEMA) {
+        throw new UnsupportedSchemaError(`${filePath} requires ledger schema ${ledgerSchema}; this grounder supports ${LEDGER_SCHEMA}. Upgrade grounder.`);
+    }
+    if (ledgerSchema < MIN_SUPPORTED_LEDGER_SCHEMA) {
+        throw new Error(`Invalid grounder state at ${filePath}: ledger schema ${ledgerSchema} is older than this grounder supports (minimum ${MIN_SUPPORTED_LEDGER_SCHEMA}). Fix or remove it, then run: grounder migrate --force`);
+    }
+    const upgraded = applyLedgerUpgrades(raw, ledgerSchema);
+    if (typeof upgraded.grounderVersion !== "string" || upgraded.grounderVersion.length === 0) {
         throw new Error(`Invalid grounder state at ${filePath}: missing grounderVersion. Fix or remove it, then run: grounder migrate --force`);
     }
-    if (raw.agents === null || typeof raw.agents !== "object" || Array.isArray(raw.agents)) {
+    if (upgraded.agents === null ||
+        typeof upgraded.agents !== "object" ||
+        Array.isArray(upgraded.agents)) {
         throw new Error(`Invalid grounder state at ${filePath}: missing agents`);
     }
+    // Explicit field-by-field construction (not a spread of `upgraded`'s agent
+    // entries) so an upgraded-but-unknown key can never round-trip back to disk
+    // through `withUpdatedAgent`'s `...existing.agents` spread.
     const agents = {};
-    for (const [id, entry] of Object.entries(raw.agents)) {
+    for (const [id, entry] of Object.entries(upgraded.agents)) {
         if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
             throw new Error(`Invalid grounder state at ${filePath}: bad agent entry "${id}"`);
         }
-        const commandsSchema = entry.commandsSchema;
-        if (typeof commandsSchema !== "number" || !Number.isInteger(commandsSchema)) {
-            throw new Error(`Invalid grounder state at ${filePath}: agent "${id}" missing commandsSchema`);
+        const e = entry;
+        const filesRaw = e.files;
+        // Drop, rather than cast through, any file entry whose `hash` isn't a
+        // string — a corrupted or hand-edited `{ hash: 123 }` / `{}` entry would
+        // otherwise persist forever via `withUpdatedAgent`'s `...prev.files`
+        // spread and compare unequal to every real hash anyway.
+        const files = {};
+        if (filesRaw && typeof filesRaw === "object" && !Array.isArray(filesRaw)) {
+            for (const [entryPath, fileEntry] of Object.entries(filesRaw)) {
+                const hash = fileEntry?.hash;
+                if (typeof hash === "string") {
+                    files[entryPath] = { hash };
+                }
+            }
         }
-        const hooksSchema = entry.hooksSchema;
-        if (hooksSchema !== undefined &&
-            (typeof hooksSchema !== "number" || !Number.isInteger(hooksSchema))) {
-            throw new Error(`Invalid grounder state at ${filePath}: agent "${id}" has invalid hooksSchema`);
-        }
-        const filesRaw = entry.files;
-        const files = filesRaw && typeof filesRaw === "object" && !Array.isArray(filesRaw) ? { ...filesRaw } : {};
+        const hooksEnabled = typeof e.hooksEnabled === "boolean" ? e.hooksEnabled : undefined;
+        // Empty string treated as missing, not as a real (empty) override — a
+        // hand-edited `"lastInvocation": ""` would otherwise pass `?? ` in
+        // `desiredArtifacts()`'s override check and render with no interpreter
+        // baked in at all.
+        const lastInvocation = typeof e.lastInvocation === "string" && e.lastInvocation.length > 0
+            ? e.lastInvocation
+            : undefined;
         agents[id] = {
-            commandsSchema,
-            ...(hooksSchema !== undefined ? { hooksSchema } : {}),
             files,
+            ...(hooksEnabled !== undefined ? { hooksEnabled } : {}),
+            ...(lastInvocation !== undefined ? { lastInvocation } : {}),
         };
     }
-    return { grounderVersion: raw.grounderVersion, agents };
+    return { ledgerSchema: LEDGER_SCHEMA, grounderVersion: upgraded.grounderVersion, agents };
 }
+/** Atomic write — tmp file + rename, so a crash mid-write never leaves a truncated ledger. */
 export async function writeGrounderState(state, homeDir) {
-    const filePath = statePath(homeDir);
-    await mkdir(path.dirname(filePath), { recursive: true });
-    await writeFile(filePath, `${JSON.stringify(state, null, 2)}\n`, "utf8");
+    await writeFileAtomic(statePath(homeDir), `${JSON.stringify(state, null, 2)}\n`);
 }
-/** Recorded commands schema for an agent, or `0` when missing (legacy). */
-export function recordedCommandsSchema(state, agentId) {
-    return state?.agents[agentId]?.commandsSchema ?? 0;
+/** Last-recorded content hash for a managed file, or `undefined` if unknown. */
+export function recordedFileHash(state, agentId, filePath) {
+    return state?.agents[agentId]?.files[filePath]?.hash;
 }
-/** Hooks version stored for an agent, or `0` if missing (never stored / never installed). */
-export function recordedHooksSchema(state, agentId) {
-    return state?.agents[agentId]?.hooksSchema ?? 0;
+/** One agent's last-applied manifest, or `undefined` when this agent has no ledger entry at all. */
+export function ledgerFilesFor(state, agentId) {
+    return state?.agents[agentId]?.files;
 }
-/**
- * Merge one agent's install info into `~/.grounder/state.json`. Creates the
- * file when missing. Keeps other agents and merges any provided `files` over
- * this agent's existing map.
- */
-export async function recordAgentInstall(opts) {
-    const existing = await readGrounderState(opts.homeDir);
-    const prev = existing?.agents[opts.agentId];
-    const nextEntry = {
-        commandsSchema: opts.commandsSchema !== undefined ? opts.commandsSchema : (prev?.commandsSchema ?? 0),
-        files: {
-            ...(prev?.files ? { ...prev.files } : {}),
-            ...(opts.files ?? {}),
-        },
-    };
-    if (opts.hooksSchema !== undefined) {
-        nextEntry.hooksSchema = opts.hooksSchema;
-    }
-    else if (prev?.hooksSchema !== undefined) {
-        nextEntry.hooksSchema = prev.hooksSchema;
-    }
-    const next = {
-        grounderVersion: opts.grounderVersion,
+/** Tri-state hooks intent for an agent: `undefined` (never recorded) / `true` / `false`. */
+export function recordedHooksEnabled(state, agentId) {
+    return state?.agents[agentId]?.hooksEnabled;
+}
+/** The `{{GROUNDER_CLI}}` invocation used at this agent's last real install, or `undefined`. */
+export function recordedInvocation(state, agentId) {
+    return state?.agents[agentId]?.lastInvocation;
+}
+function withUpdatedAgent(existing, agentId, updateEntry, grounderVersion) {
+    const prevAgent = existing?.agents[agentId] ?? { files: {} };
+    return {
+        ledgerSchema: LEDGER_SCHEMA,
+        grounderVersion,
         agents: {
             ...(existing?.agents ?? {}),
-            [opts.agentId]: nextEntry,
+            [agentId]: updateEntry(prevAgent),
         },
     };
+}
+/**
+ * Persist one file's hash for one agent, right after that file's own write
+ * succeeds — per-artifact, not batched, so a mid-run crash leaves the ledger
+ * consistent with whatever actually completed. No-op if already current.
+ */
+export async function setLedgerFileHash(opts) {
+    const existing = await readGrounderState(opts.homeDir);
+    if (existing?.agents[opts.agentId]?.files[opts.filePath]?.hash === opts.hash) {
+        return;
+    }
+    const next = withUpdatedAgent(existing, opts.agentId, (prev) => ({ ...prev, files: { ...prev.files, [opts.filePath]: { hash: opts.hash } } }), opts.grounderVersion);
     await writeGrounderState(next, opts.homeDir);
-    return next;
 }
 /**
- * True when `state.json` says this machine's install is behind what this
- * Grounder version expects. Used by peek/status — they only read `state.json`,
- * they do not look at Cursor/Claude files on disk.
- *
- * If there is no state file, returns false (callers handle that separately).
- * Only agents listed in state are checked.
- *
- * Session hooks: if an agent has no `hooksSchema` in state, that means hooks
- * were never turned on for them. That is not "behind" — otherwise peek would
- * keep telling people who never enabled hooks to run migrate. Doctor verifies
- * on-disk command/hook drift via migrate dry-run, and also warns when files
- * already match but these ledger schema numbers still lag.
+ * Drop one path's ledger entry — for a file deleted outright (tombstone
+ * retirement), where there is no new hash to overwrite it with. No-op when
+ * there's no state, no such agent, or no recorded entry for that path.
  */
-export function isInstallSchemaStale(state, agents) {
-    if (!state) {
-        return false;
+export async function forgetLedgerFile(opts) {
+    const existing = await readGrounderState(opts.homeDir);
+    const prevAgent = existing?.agents[opts.agentId];
+    if (!existing || !prevAgent || !(opts.filePath in prevAgent.files)) {
+        return;
     }
-    for (const agent of agents) {
-        const entry = state.agents[agent.id];
-        if (!entry) {
-            continue;
-        }
-        if (entry.commandsSchema < agent.commandsSchema) {
-            return true;
-        }
-        if (agent.hooksSchema !== undefined &&
-            entry.hooksSchema !== undefined &&
-            entry.hooksSchema < agent.hooksSchema) {
-            return true;
-        }
+    const files = Object.fromEntries(Object.entries(prevAgent.files).filter(([p]) => p !== opts.filePath));
+    const next = withUpdatedAgent(existing, opts.agentId, (prev) => ({ ...prev, files }), opts.grounderVersion);
+    await writeGrounderState(next, opts.homeDir);
+}
+/** Persist an agent's hooks intent (tri-state). Setup/migrate only — never called from doctor. */
+export async function setHooksEnabled(opts) {
+    const existing = await readGrounderState(opts.homeDir);
+    if (existing?.agents[opts.agentId]?.hooksEnabled === opts.enabled) {
+        return;
     }
-    return false;
+    const next = withUpdatedAgent(existing, opts.agentId, (prev) => ({ ...prev, hooksEnabled: opts.enabled }), opts.grounderVersion);
+    await writeGrounderState(next, opts.homeDir);
 }
 /**
- * True when state says hooks are newer than this Grounder understands.
- * No stored hooks version is not "newer".
+ * Persist the exact invocation used for this agent's just-completed real
+ * install, so the cheap drift check can replay it later instead of the
+ * checking process's own `process.execPath`. No-op if already current.
  */
-export function isHooksSchemaAhead(recorded, expected) {
-    if (expected === undefined || recorded === undefined) {
-        return false;
+export async function setLedgerInvocation(opts) {
+    const existing = await readGrounderState(opts.homeDir);
+    if (existing?.agents[opts.agentId]?.lastInvocation === opts.invocation) {
+        return;
     }
-    return recorded > expected;
+    const next = withUpdatedAgent(existing, opts.agentId, (prev) => ({ ...prev, lastInvocation: opts.invocation }), opts.grounderVersion);
+    await writeGrounderState(next, opts.homeDir);
 }
-/** Last-recorded content hash for a managed file, or `undefined` if unknown. */
-export function recordedFileHash(state, agentId, filePath) {
-    return state?.agents[agentId]?.files[filePath]?.hash;
+/**
+ * Shared by `touchGrounderVersion`'s own no-op guard and `migrate`/`setup`'s
+ * reported "did the ledger change" row, so the two can't independently drift
+ * on the same comparison.
+ */
+export function ledgerVersionChanged(existing, grounderVersion) {
+    return existing?.grounderVersion !== grounderVersion;
+}
+/**
+ * Stamp `grounderVersion` unconditionally — the hook for an all-noop plan
+ * (nothing else in a per-artifact write loop touches it when every entry was
+ * `noop`), so the upgrade banner still clears on a fully-current machine.
+ */
+export async function touchGrounderVersion(grounderVersion, homeDir) {
+    const existing = await readGrounderState(homeDir);
+    if (!ledgerVersionChanged(existing, grounderVersion)) {
+        return;
+    }
+    await writeGrounderState({ ledgerSchema: LEDGER_SCHEMA, grounderVersion, agents: existing?.agents ?? {} }, homeDir);
 }
 /**
- * Hard stop when `state.json` has install versions newer than this Grounder
- * understands. Missing state or unknown agents are fine (older installs).
+ * Write-path-only hard stop (gap 2): an older binary reconciling a ledger
+ * written by a newer one must refuse to write, not silently overwrite newer
+ * skill files with older ones. Never called from `doctor`/`status`/`peek` —
+ * those keep today's warning and stay fully functional against a newer
+ * ledger (see `package-version-notice.ts`'s `"behind"` branch).
  */
-export function assertAgentSchemasSupported(state, agents) {
+export function assertVersionSupportsWrite(runningVersion, state) {
     if (!state) {
         return;
     }
-    for (const agent of agents) {
-        const recorded = state.agents[agent.id];
-        if (!recorded) {
-            continue;
-        }
-        if (recorded.commandsSchema > agent.commandsSchema) {
-            throw new UnsupportedSchemaError(`${agent.name} commands schema ${recorded.commandsSchema} is newer than this grounder supports (${agent.commandsSchema}). Upgrade grounder.`);
-        }
-        if (recorded.hooksSchema !== undefined &&
-            agent.hooksSchema !== undefined &&
-            recorded.hooksSchema > agent.hooksSchema) {
-            throw new UnsupportedSchemaError(`${agent.name} hooks schema ${recorded.hooksSchema} is newer than this grounder supports (${agent.hooksSchema}). Upgrade grounder.`);
-        }
+    if (packageVersionRelation(runningVersion, state.grounderVersion) === "behind") {
+        throw new UnsupportedSchemaError(`This Grounder (${runningVersion}) is older than your configuration (${state.grounderVersion}). Install a newer Grounder.`);
     }
 }
 //# sourceMappingURL=state.js.map

package/dist/connector/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/connector/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AA4BjE,MAAM,UAAU,SAAS,CAAC,OAAgB;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAgB;IACtD,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,GAA2B,CAAC;IAChC,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAA2B,CAAC;IAC/E,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,IAAI,KAAK,CACb,6BAA6B,QAAQ,KAAK,MAAM,wDAAwD,CACzG,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,eAAe,KAAK,QAAQ,IAAI,GAAG,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,KAAK,CACb,6BAA6B,QAAQ,iFAAiF,CACvH,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,kBAAkB,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,MAAM,GAA+B,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,sBAAsB,EAAE,GAAG,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,cAAc,GAAI,KAAoB,CAAC,cAAc,CAAC;QAC5D,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;YAC5E,MAAM,IAAI,KAAK,CACb,6BAA6B,QAAQ,YAAY,EAAE,0BAA0B,CAC9E,CAAC;QACJ,CAAC;QACD,MAAM,WAAW,GAAI,KAAoB,CAAC,WAAW,CAAC;QACtD,IACE,WAAW,KAAK,SAAS;YACzB,CAAC,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,EACnE,CAAC;YACD,MAAM,IAAI,KAAK,CACb,6BAA6B,QAAQ,YAAY,EAAE,2BAA2B,CAC/E,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAI,KAAoB,CAAC,KAAK,CAAC;QAC7C,MAAM,KAAK,GACT,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9F,MAAM,CAAC,EAAE,CAAC,GAAG;YACX,cAAc;YACd,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,KAAK;SACN,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,eAAe,EAAE,GAAG,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAoB,EAAE,OAAgB;IAC7E,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC3E,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,sBAAsB,CAAC,KAA2B,EAAE,OAAe;IACjF,OAAO,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,cAAc,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,mBAAmB,CAAC,KAA2B,EAAE,OAAe;IAC9E,OAAO,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,WAAW,IAAI,CAAC,CAAC;AAClD,CAAC;AAsBD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAA+B;IACtE,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAe;QAC5B,cAAc,EACZ,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,cAAc,IAAI,CAAC,CAAC;QACvF,KAAK,EAAE;YACL,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;SACtB;KACF,CAAC;IACF,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACnC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IAC3C,CAAC;SAAM,IAAI,IAAI,EAAE,WAAW,KAAK,SAAS,EAAE,CAAC;QAC3C,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IAC3C,CAAC;IAED,MAAM,IAAI,GAAkB;QAC1B,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,MAAM,EAAE;YACN,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC;YAC3B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,SAAS;SAC1B;KACF,CAAC;IACF,MAAM,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAA2B,EAC3B,MAAyC;IAEzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IACE,KAAK,CAAC,WAAW,KAAK,SAAS;YAC/B,KAAK,CAAC,WAAW,KAAK,SAAS;YAC/B,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,EACrC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAA4B,EAC5B,QAA4B;IAE5B,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,QAAQ,GAAG,QAAQ,CAAC;AAC7B,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAC9B,KAA2B,EAC3B,OAAe,EACf,QAAgB;IAEhB,OAAO,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAA2B,EAC3B,MAAyC;IAEzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;IACT,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,SAAS;QACX,CAAC;QAED,IAAI,QAAQ,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC;YACnD,MAAM,IAAI,sBAAsB,CAC9B,GAAG,KAAK,CAAC,IAAI,oBAAoB,QAAQ,CAAC,cAAc,0CAA0C,KAAK,CAAC,cAAc,sBAAsB,CAC7I,CAAC;QACJ,CAAC;QAED,IACE,QAAQ,CAAC,WAAW,KAAK,SAAS;YAClC,KAAK,CAAC,WAAW,KAAK,SAAS;YAC/B,QAAQ,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,EACxC,CAAC;YACD,MAAM,IAAI,sBAAsB,CAC9B,GAAG,KAAK,CAAC,IAAI,iBAAiB,QAAQ,CAAC,WAAW,0CAA0C,KAAK,CAAC,WAAW,sBAAsB,CACpI,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/connector/state.ts"],"names":[],"mappings":"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"}

package/dist/connector/vault.d.ts

@@ -7,6 +7,8 @@ import type { RepoConfig } from "./repo.js";
 export declare function resolveVaultRoot(home: HomeConfig, override?: string): string;
 /** Project notes directory under the effective vault root. */
 export declare function resolveNotesDir(home: HomeConfig, repo: RepoConfig, vaultOverride?: string): string;
+/** Project vault root directory under the effective vault root. */
+export declare function resolveProjectVaultRoot(home: HomeConfig, repo: RepoConfig, vaultOverride?: string): string;
 /** Project logs (handoff) directory under the effective vault root. */
 export declare function resolveLogsDir(home: HomeConfig, repo: RepoConfig, vaultOverride?: string): string;
 /** Project plans directory under the effective vault root. */

package/dist/connector/vault.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../../src/connector/vault.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ5E;AAED,8DAA8D;AAC9D,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,UAAU,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAGR;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAGjG;AAED,8DAA8D;AAC9D,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,UAAU,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAGR"}
+{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../../src/connector/vault.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ5E;AAED,8DAA8D;AAC9D,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,UAAU,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAGR;AAED,mEAAmE;AACnE,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,UAAU,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAGR;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAGjG;AAED,8DAA8D;AAC9D,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,UAAU,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAGR"}

package/dist/connector/vault.js

@@ -1,6 +1,6 @@
 // Config-aware vault resolution: effective vault root and artifact paths from connector state.
 import { resolveUserPath } from "../util/path.js";
-import { logsDir, notesDir, plansDir } from "../vault/layout.js";
+import { logsDir, notesDir, plansDir, projectDir } from "../vault/layout.js";
 /**
  * Effective vault root, in order: explicit `override`, `GROUNDER_VAULT`, then home config.
  * Expands a leading `~` so vault paths like `~/Documents/…` resolve to the user home.
@@ -19,6 +19,11 @@ export function resolveNotesDir(home, repo, vaultOverride) {
     const vaultRoot = resolveVaultRoot(home, vaultOverride);
     return notesDir(vaultRoot, repo.projectId);
 }
+/** Project vault root directory under the effective vault root. */
+export function resolveProjectVaultRoot(home, repo, vaultOverride) {
+    const vaultRoot = resolveVaultRoot(home, vaultOverride);
+    return projectDir(vaultRoot, repo.projectId);
+}
 /** Project logs (handoff) directory under the effective vault root. */
 export function resolveLogsDir(home, repo, vaultOverride) {
     const vaultRoot = resolveVaultRoot(home, vaultOverride);

package/dist/connector/vault.js.map

@@ -1 +1 @@
-{"version":3,"file":"vault.js","sourceRoot":"","sources":["../../src/connector/vault.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAE/F,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAIjE;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAgB,EAAE,QAAiB;IAClE,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAC/B,OAAO,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,eAAe,CAC7B,IAAgB,EAChB,IAAgB,EAChB,aAAsB;IAEtB,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACxD,OAAO,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAAC,IAAgB,EAAE,IAAgB,EAAE,aAAsB;IACvF,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACxD,OAAO,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,eAAe,CAC7B,IAAgB,EAChB,IAAgB,EAChB,aAAsB;IAEtB,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACxD,OAAO,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"vault.js","sourceRoot":"","sources":["../../src/connector/vault.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAE/F,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAI7E;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAgB,EAAE,QAAiB;IAClE,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAC/B,OAAO,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,eAAe,CAC7B,IAAgB,EAChB,IAAgB,EAChB,aAAsB;IAEtB,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACxD,OAAO,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,uBAAuB,CACrC,IAAgB,EAChB,IAAgB,EAChB,aAAsB;IAEtB,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACxD,OAAO,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;AAC/C,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAAC,IAAgB,EAAE,IAAgB,EAAE,aAAsB;IACvF,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACxD,OAAO,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,eAAe,CAC7B,IAAgB,EAChB,IAAgB,EAChB,aAAsB;IAEtB,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACxD,OAAO,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC"}

package/dist/help.d.ts

@@ -1,7 +1,7 @@
 /** Help tiers and command metadata for the grounder CLI. */
-export type HelpGroup = "Setup" | "Write" | "Paths" | "Maintain" | "Advanced";
+export type HelpGroup = "Setup" | "Write" | "Retrieve" | "Paths" | "Maintain" | "Advanced";
 export interface CommandMeta {
-    /** Canonical id (`note`, `handoff list`, `vault init`, …). */
+    /** Canonical id (`note`, `handoff list`, `setup`, …). */
     id: string;
     group: HelpGroup;
     /** One-line summary for synopsis / full command lists. */
@@ -24,7 +24,7 @@ export declare const COMMANDS: readonly CommandMeta[];
  * Command ids the CLI dispatches (including parent topics). Keep in sync with
  * `cli.ts` / `helpExitCode(...)` call sites — the invariant test locks this.
  */
-export declare const DISPATCHED_COMMAND_IDS: readonly ["vault", "vault init", "init", "note", "note list", "handoff", "handoff list", "handoff peek", "plan", "plan list", "path", "path notes", "path logs", "path plans", "status", "doctor", "migrate", "help"];
+export declare const DISPATCHED_COMMAND_IDS: readonly ["setup", "link", "note", "note list", "handoff", "handoff list", "handoff peek", "plan", "plan list", "search", "overview", "path", "path notes", "path logs", "path plans", "status", "doctor", "migrate", "help"];
 /** True when argv contains an exact `-h` or `--help` token. */
 export declare function wantsHelp(argv: string[]): boolean;
 /**

package/dist/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;AAE9E,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAaD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,WAAW,EAkM1C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,uNAmBzB,CAAC;AAIX,+DAA+D;AAC/D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAEjD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,GAAG,SAAS,CAY9E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CASxD;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAMrD;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM7E;AAgDD,8EAA8E;AAC9E,wBAAgB,aAAa,IAAI,IAAI,CAepC;AAED,sFAAsF;AACtF,wBAAgB,aAAa,IAAI,IAAI,CAepC;AAED,2DAA2D;AAC3D,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAe9C"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;AAE3F,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAaD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,WAAW,EA0O1C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,+NAoBzB,CAAC;AAIX,+DAA+D;AAC/D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAEjD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,GAAG,SAAS,CAY9E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CASxD;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAMrD;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM7E;AAkDD,8EAA8E;AAC9E,wBAAgB,aAAa,IAAI,IAAI,CAepC;AAED,sFAAsF;AACtF,wBAAgB,aAAa,IAAI,IAAI,CAepC;AAED,2DAA2D;AAC3D,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAe9C"}