grounder 0.4.0 → 0.6.0

package/dist/commands/render-artifact-table.js

@@ -0,0 +1,232 @@
+/** For hook/runtime rows, still reported via the old imperative `ArtifactStatus` shape. */
+export function toRowStatus(status) {
+    switch (status) {
+        case "skipped":
+            return "current";
+        case "created":
+            return "create";
+        case "overwritten":
+            return "update";
+    }
+}
+/**
+ * Whole-file artifact rows come straight from the reconciler's own plan
+ * vocabulary. `forget` gets its own status, distinct from `noop`'s
+ * "current" — a forget entry always changes `state.json` (see
+ * `planChangesLedger`), even though it never touches the file itself, so
+ * folding it into "current"/"unchanged" would hide the one row that explains
+ * why the trailing state row says "updated".
+ */
+export function rowStatusFromPlanAction(action) {
+    switch (action) {
+        case "noop":
+            return "current";
+        case "forget":
+            return "forget";
+        case "create":
+            return "create";
+        case "update":
+            return "update";
+        case "delete":
+            return "delete";
+        case "conflict":
+            return "modified";
+    }
+}
+export function rowFromPlanEntry(target, entry) {
+    return {
+        status: rowStatusFromPlanAction(entry.action),
+        target,
+        path: entry.path,
+        forceAction: entry.blockedAction,
+    };
+}
+export const VERB = {
+    current: { dry: "current", real: "current" },
+    create: { dry: "create", real: "created" },
+    update: { dry: "update", real: "updated" },
+    delete: { dry: "delete", real: "deleted" },
+    forget: { dry: "forget", real: "forgotten" },
+    modified: { dry: "modified", real: "modified" },
+};
+/**
+ * Table cell label per status — the same word in dry-run and real, so the
+ * table asserts one outcome vocabulary instead of reconjugating per row
+ * (matching `kubectl apply`'s created/configured/unchanged). Dry-run-ness is
+ * already announced once above the table and in the summary sentence, which
+ * keeps its own tense (`VERB` above) since "would create" is a sentence
+ * construction, not a table cell.
+ *
+ * `modified` is deliberately not "modified" here: that word would read as
+ * Grounder having modified the file, when the row means the opposite — a
+ * local edit was found and Grounder left it untouched. "conflict" names that
+ * outcome without implying an action was taken (see the STATUS header below,
+ * not ACTION, for the same reason).
+ *
+ * `forget` is deliberately not "unchanged" here, even though the file itself
+ * is untouched: the ledger entry for it is dropped, which is exactly the
+ * "updated" the trailing state row reports — collapsing it into "unchanged"
+ * would leave that state-row change unexplained by any visible row.
+ */
+export const TABLE_LABEL = {
+    current: "unchanged",
+    create: "created",
+    update: "updated",
+    delete: "deleted",
+    forget: "forgotten",
+    modified: "conflict",
+};
+/**
+ * Runtime + per-agent whole-file/hook rows shared by `setup` and `migrate` —
+ * both callers add the trailing state/ledger row on top since that isn't
+ * part of `applyAgentInstalls`'s result. Tombstone retirement is already
+ * folded into each agent's own `plan`, so it lands right after that agent's
+ * own artifact rows with no separate grouping step needed.
+ */
+export function rowsFromApplyResult(applyResult) {
+    const rows = [];
+    if (applyResult.runtime) {
+        rows.push({
+            status: toRowStatus(applyResult.runtime.status),
+            target: "runtime",
+            path: applyResult.runtime.cliPath,
+        });
+    }
+    for (const agentResult of applyResult.agents) {
+        for (const entry of agentResult.plan) {
+            rows.push(rowFromPlanEntry(agentResult.agent.id, entry));
+        }
+        if (agentResult.hooks) {
+            for (const [path, status] of Object.entries(agentResult.hooks.artifacts)) {
+                rows.push({
+                    status: toRowStatus(status),
+                    // Distinguishes a hook artifact from that agent's command/skill
+                    // rows above — echoing (not textually identical to) the "hook
+                    // <path>" wording setup's pre-confirm preview list already uses.
+                    target: `${agentResult.agent.id} hook`,
+                    path,
+                    // No `forceAction` — hooks always-converge with no conflict/`--force`
+                    // gate (see `AgentAdapter#installHooks`'s own docs), so a hook row
+                    // never lands in RowStatus "modified".
+                });
+            }
+        }
+    }
+    return rows;
+}
+/**
+ * The trailing `state` row both `setup` and `migrate` append — same
+ * create/update/current rule either way, so the two callers can't drift on
+ * how a ledger write is reported. `ledgerChanged` is each caller's own
+ * computation; this only owns turning that bit plus prior-state nullness
+ * into a `Row`.
+ */
+export function stateRow(ledgerChanged, priorState, path) {
+    const status = !ledgerChanged ? "current" : !priorState ? "create" : "update";
+    return { status, target: "state", path };
+}
+export function plural(count, noun) {
+    return `${count} ${noun}${count === 1 ? "" : "s"}`;
+}
+export function renderTable(rows) {
+    const statusWidth = Math.max("STATUS".length, ...rows.map((r) => TABLE_LABEL[r.status].length)) + 1;
+    const targetWidth = Math.max("TARGET".length, ...rows.map((r) => r.target.length)) + 1;
+    process.stdout.write(`${"STATUS".padEnd(statusWidth)}${"TARGET".padEnd(targetWidth)}PATH\n`);
+    for (const row of rows) {
+        const verb = TABLE_LABEL[row.status];
+        process.stdout.write(`${verb.padEnd(statusWidth)}${row.target.padEnd(targetWidth)}${row.path}\n`);
+    }
+}
+export function renderSummary(rows, dryRun) {
+    const counts = {
+        current: 0,
+        create: 0,
+        update: 0,
+        delete: 0,
+        forget: 0,
+        modified: 0,
+    };
+    for (const row of rows) {
+        counts[row.status]++;
+    }
+    const acted = [];
+    for (const status of ["create", "update", "delete", "forget"]) {
+        if (counts[status] > 0) {
+            acted.push(`${VERB[status][dryRun ? "dry" : "real"]} ${counts[status]}`);
+        }
+    }
+    if (acted.length === 0 && counts.modified === 0) {
+        process.stdout.write(counts.current > 0
+            ? `Nothing to do — ${plural(counts.current, "file")} unchanged.\n`
+            : "Nothing to do.\n");
+        return;
+    }
+    // Conflicts get their own trailer here (in addition to the per-file detail
+    // in `renderModifiedNote`) so a run whose only pending work is a left-alone
+    // conflict never reports "Nothing to do" — see the `acted.length === 0`
+    // check above, which now only fires when there's truly nothing pending.
+    const trailers = [];
+    if (counts.current > 0) {
+        trailers.push(`${plural(counts.current, "file")} unchanged`);
+    }
+    if (counts.modified > 0) {
+        trailers.push(`${plural(counts.modified, "file")} left as ${counts.modified === 1 ? "a conflict" : "conflicts"}`);
+    }
+    let line;
+    if (dryRun) {
+        line = acted.length > 0 ? `Would ${acted.join(", ")}` : "Nothing to write";
+        for (const trailer of trailers) {
+            line += `, ${trailer}`;
+        }
+        line +=
+            acted.length > 0 ? ". Run without --dry-run to apply." : ". Run with --force to resolve.";
+    }
+    else {
+        line = acted.join(", ");
+        for (const trailer of trailers) {
+            line += line ? `, ${trailer}` : trailer;
+        }
+        line += ".";
+        line = (line[0]?.toUpperCase() ?? "") + line.slice(1);
+    }
+    process.stdout.write(`${line}\n`);
+}
+/**
+ * Per-agent hook failures `applyAgentInstalls` isolated (see
+ * `AgentApplyResult#error`) — printed after the table/summary so a failing
+ * agent's hook error doesn't obscure whether other agents (or this agent's
+ * own whole-file artifacts, already applied by this point) succeeded.
+ */
+export function renderAgentErrors(applyResult) {
+    const failed = applyResult.agents.filter((a) => a.error !== undefined);
+    if (failed.length === 0) {
+        return;
+    }
+    process.stderr.write(`\n${plural(failed.length, "agent")} hook install failed (its other artifacts above still applied):\n`);
+    for (const { agent, error } of failed) {
+        process.stderr.write(`  ${agent.id}: ${error}\n`);
+    }
+}
+/**
+ * @param forceCommand The command line (without `--force`) the reader should
+ * re-run to resolve conflicts. Both `setup` and `migrate` pass `"grounder
+ * migrate"` today — `setup --force` applies just as well, but pointing every
+ * conflict at one canonical command keeps the remediation message the same
+ * regardless of which command surfaced the conflict.
+ */
+export function renderModifiedNote(rows, forceCommand) {
+    const modified = rows.filter((r) => r.status === "modified");
+    if (modified.length === 0) {
+        return;
+    }
+    process.stdout.write(`\n${plural(modified.length, "file")} left alone — Grounder can't confirm ${modified.length === 1 ? "it's" : "they're"} unedited:\n`);
+    for (const row of modified) {
+        const action = row.forceAction === "delete" ? "would be deleted" : "would be overwritten";
+        process.stdout.write(`  ${row.path} (${action})\n`);
+    }
+    const hasOverwrite = modified.some((r) => r.forceAction !== "delete");
+    const hasDelete = modified.some((r) => r.forceAction === "delete");
+    const verb = hasOverwrite && hasDelete ? "overwrite or delete" : hasDelete ? "delete" : "overwrite";
+    process.stdout.write(`Run '${forceCommand} --force' to ${verb} ${modified.length === 1 ? "it" : "them"} (any local edits are lost).\n`);
+}
+//# sourceMappingURL=render-artifact-table.js.map

package/dist/commands/render-artifact-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-artifact-table.js","sourceRoot":"","sources":["../../src/commands/render-artifact-table.ts"],"names":[],"mappings":"AAiBA,2FAA2F;AAC3F,MAAM,UAAU,WAAW,CAAC,MAAsB;IAChD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,QAAQ,CAAC;QAClB,KAAK,aAAa;YAChB,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAkB;IACxD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,SAAS,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;IACtB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,KAAgB;IAC/D,OAAO;QACL,MAAM,EAAE,uBAAuB,CAAC,KAAK,CAAC,MAAM,CAAC;QAC7C,MAAM;QACN,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,aAAa;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAqD;IACpE,OAAO,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;IAC5C,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;IAC1C,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;IAC1C,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;IAC1C,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE;IAC5C,QAAQ,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;CAChD,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD,OAAO,EAAE,WAAW;IACpB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,WAAW;IACnB,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAqC;IACvE,MAAM,IAAI,GAAU,EAAE,CAAC;IACvB,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC;YACR,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;YAC/C,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO;SAClC,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,WAAW,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;QAC7C,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YACtB,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;gBACzE,IAAI,CAAC,IAAI,CAAC;oBACR,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;oBAC3B,gEAAgE;oBAChE,8DAA8D;oBAC9D,iEAAiE;oBACjE,MAAM,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,OAAO;oBACtC,IAAI;oBACJ,sEAAsE;oBACtE,mEAAmE;oBACnE,uCAAuC;iBACxC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CACtB,aAAsB,EACtB,UAAgC,EAChC,IAAY;IAEZ,MAAM,MAAM,GAAc,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IACzF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAa,EAAE,IAAY;IAChD,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAW;IACrC,MAAM,WAAW,GACf,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;IAClF,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;IACvF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC7F,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,CAC5E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAW,EAAE,MAAe;IACxD,MAAM,MAAM,GAA8B;QACxC,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,CAAC;QACT,QAAQ,EAAE,CAAC;KACZ,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;IACvB,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAU,EAAE,CAAC;QACvE,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,MAAM,CAAC,OAAO,GAAG,CAAC;YAChB,CAAC,CAAC,mBAAmB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,eAAe;YAClE,CAAC,CAAC,kBAAkB,CACvB,CAAC;QACF,OAAO;IACT,CAAC;IAED,2EAA2E;IAC3E,4EAA4E;IAC5E,wEAAwE;IACxE,wEAAwE;IACxE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CACX,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,YAAY,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,EAAE,CACnG,CAAC;IACJ,CAAC;IAED,IAAI,IAAY,CAAC;IACjB,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC;QAC3E,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACzB,CAAC;QACD,IAAI;YACF,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,gCAAgC,CAAC;IAC9F,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1C,CAAC;QACD,IAAI,IAAI,GAAG,CAAC;QACZ,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAqC;IACrE,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,CACtC,CAAC,CAAC,EAAqC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAChE,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,mEAAmE,CACvG,CAAC;IACF,KAAK,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,MAAM,EAAE,CAAC;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAW,EAAE,YAAoB;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;IAC7D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,wCAClC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SACnC,cAAc,CACf,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,sBAAsB,CAAC;QAC1F,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,MAAM,KAAK,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC;IACnE,MAAM,IAAI,GACR,YAAY,IAAI,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC;IACzF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,QAAQ,YAAY,gBAAgB,IAAI,IACtC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MACjC,gCAAgC,CACjC,CAAC;AACJ,CAAC"}

package/dist/commands/require-linked.js

@@ -7,10 +7,10 @@ export async function requireLinkedProject(cwd) {
     const result = await resolveLinkedProject(cwd);
     if (!result.ok) {
         if (result.error === "no-vault") {
-            process.stderr.write("No vault configured. Run: grounder vault init <path>\n");
+            process.stderr.write("No vault configured. Run: grounder setup <path>\n");
         }
         else {
-            process.stderr.write("Folder not linked. Run: grounder init\n");
+            process.stderr.write("Folder not linked. Run: grounder link\n");
         }
         return null;
     }

package/dist/commands/require-linked.js.map

@@ -1 +1 @@
-{"version":3,"file":"require-linked.js","sourceRoot":"","sources":["../../src/commands/require-linked.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAElF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAW;IACpD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC"}
+{"version":3,"file":"require-linked.js","sourceRoot":"","sources":["../../src/commands/require-linked.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAElF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAW;IACpD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QAC5E,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC"}

package/dist/commands/search.d.ts

@@ -0,0 +1,23 @@
+/** Options for {@link runSearchWithOptions} (CLI parsing and tests). */
+export interface SearchCommandOptions {
+    cwd?: string;
+    homeDir?: string;
+    query: string;
+    terms?: string[];
+    limit?: number;
+    maxHits?: number;
+    context?: number;
+    since?: Date;
+    markdown?: boolean;
+    json?: boolean;
+}
+/**
+ * CLI entry for `grounder search <query>`.
+ * @returns Exit code (`0` on success, `1` on usage or config errors).
+ */
+export declare function runSearch(argv: string[]): Promise<number>;
+/**
+ * Resolves the linked project, searches its vault root, prints formatted hits.
+ */
+export declare function runSearchWithOptions(options: SearchCommandOptions): Promise<number>;
+//# sourceMappingURL=search.d.ts.map

package/dist/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAUA,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAmND;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAuE/D;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkCzF"}

package/dist/commands/search.js

@@ -0,0 +1,288 @@
+import path from "node:path";
+import { withHomeDir } from "../connector/home.js";
+import { resolveProjectVaultRoot } from "../connector/vault.js";
+import { helpExitCode } from "../help.js";
+import { fileExists } from "../util/fs.js";
+import { flagBool, flagString, parseArgs } from "../util/parse-args.js";
+import { formatMarkdownFileLink, toFileUri, vaultRelativePath } from "../util/path.js";
+import { searchVault } from "../vault/search.js";
+import { requireLinkedProject } from "./require-linked.js";
+const USAGE = "Usage: grounder search <query> [--terms <csv>] [--limit <n>] [--max-hits <n>] [--context <n>] [--since <date>] [--markdown] [--json]\n";
+function usageError() {
+    process.stderr.write(USAGE);
+    return 1;
+}
+function parseIntFlag(raw, label, min) {
+    if (raw === undefined) {
+        return null;
+    }
+    if (typeof raw !== "string") {
+        return null;
+    }
+    const trimmed = raw.trim();
+    const parsed = Number.parseInt(trimmed, 10);
+    const desc = min === 0 ? "a non-negative integer" : "a positive integer";
+    if (!/^\d+$/.test(trimmed) || Number.isNaN(parsed) || parsed < min) {
+        process.stderr.write(`Invalid ${label}: must be ${desc}.\n`);
+        return null;
+    }
+    return parsed;
+}
+/**
+ * Parses `--since` / `--after`: calendar date (`2026-08-01` = local midnight),
+ * ISO datetime, or relative (`7d`, `30d`). Returns `null` on invalid input
+ * (after writing an error message).
+ */
+function parseSinceDate(raw) {
+    if (raw === undefined) {
+        return undefined;
+    }
+    if (typeof raw !== "string") {
+        process.stderr.write("Invalid --since: expected a date string.\n");
+        return null;
+    }
+    const trimmed = raw.trim();
+    const relMatch = /^(\d+)d$/i.exec(trimmed);
+    if (relMatch) {
+        const days = Number.parseInt(relMatch[1], 10);
+        const d = new Date();
+        d.setDate(d.getDate() - days);
+        d.setHours(0, 0, 0, 0);
+        return d;
+    }
+    const isoDay = /^(\d{4})-(\d{2})-(\d{2})$/.exec(trimmed);
+    if (isoDay) {
+        const year = Number.parseInt(isoDay[1], 10);
+        const month = Number.parseInt(isoDay[2], 10);
+        const day = Number.parseInt(isoDay[3], 10);
+        const parsed = new Date(year, month - 1, day);
+        if (parsed.getFullYear() !== year ||
+            parsed.getMonth() !== month - 1 ||
+            parsed.getDate() !== day) {
+            process.stderr.write(`Invalid --since: "${trimmed}" is not a valid date (use YYYY-MM-DD or Nd).\n`);
+            return null;
+        }
+        parsed.setHours(0, 0, 0, 0);
+        return parsed;
+    }
+    const parsed = new Date(trimmed);
+    if (Number.isNaN(parsed.getTime())) {
+        process.stderr.write(`Invalid --since: "${trimmed}" is not a valid date (use YYYY-MM-DD or Nd).\n`);
+        return null;
+    }
+    return parsed;
+}
+function parseTermsCsv(raw) {
+    if (!raw) {
+        return [];
+    }
+    return raw
+        .split(",")
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0);
+}
+function fileStem(filePath) {
+    return path.basename(filePath, ".md");
+}
+function formatSummary(outcome) {
+    if (outcome.totalMatchCount === 0) {
+        return `No matches for "${outcome.query}".`;
+    }
+    if (outcome.truncated) {
+        return `Found ${outcome.totalMatchCount} matches in ${outcome.totalFileCount} files (showing ${outcome.files.length}).`;
+    }
+    return `Found ${outcome.totalMatchCount} matches in ${outcome.totalFileCount} files.`;
+}
+function writePlainOutput(outcome) {
+    process.stdout.write(`${formatSummary(outcome)}\n`);
+    if (outcome.totalMatchCount === 0) {
+        return;
+    }
+    if (outcome.truncated) {
+        process.stdout.write(`Showing top ${outcome.files.length} of ${outcome.totalFileCount} files.\n`);
+    }
+    process.stdout.write("\n");
+    outcome.files.forEach((file, index) => {
+        if (index > 0) {
+            process.stdout.write("\n");
+        }
+        const label = fileStem(file.filePath);
+        const topicTag = file.topicsMatch ? " [topics]" : "";
+        process.stdout.write(`${index + 1}. ${label}${topicTag}  \n  ${file.filePath}\n`);
+        if (file.hits.length === 0) {
+            // Filename-only match (2026-09-07): no body line to quote — say so
+            // instead of printing a bare file with no evidence of why it matched.
+            process.stdout.write(`  (matched by filename: ${file.matchedTerms.join(", ")})\n`);
+            return;
+        }
+        for (const hit of file.hits) {
+            const snippet = hit.snippet.replace(/\s+/g, " ").trim();
+            process.stdout.write(`  L${hit.line} (${hit.matchedTerm}): ${snippet}\n`);
+        }
+    });
+}
+function formatSnippetBlock(snippet) {
+    let fence = "```";
+    while (snippet.includes(fence)) {
+        fence += "`";
+    }
+    return `${fence}\n${snippet}\n${fence}\n`;
+}
+function writeMarkdownOutput(outcome) {
+    process.stdout.write(`${formatSummary(outcome)}\n`);
+    if (outcome.totalMatchCount === 0) {
+        return;
+    }
+    if (outcome.truncated) {
+        process.stdout.write(`Showing top ${outcome.files.length} of ${outcome.totalFileCount} files.\n`);
+    }
+    process.stdout.write("\n");
+    for (const file of outcome.files) {
+        const label = fileStem(file.filePath);
+        process.stdout.write(`### ${formatMarkdownFileLink(label, file.filePath)}\n\n`);
+        if (file.hits.length === 0) {
+            // Filename-only match (2026-09-07): no body line to quote.
+            process.stdout.write(`(matched by filename: ${file.matchedTerms.join(", ")})\n\n`);
+            continue;
+        }
+        for (const hit of file.hits) {
+            process.stdout.write(`L${hit.line} (${hit.matchedTerm}):\n\n`);
+            process.stdout.write(formatSnippetBlock(hit.snippet));
+            process.stdout.write("\n");
+        }
+    }
+}
+function alsoMatchedHint(filePath, matchedTerms) {
+    const stem = fileStem(filePath);
+    return `${stem} — ${matchedTerms.slice(0, 2).join(", ")}`;
+}
+function writeJsonOutput(outcome, rootDir) {
+    const payload = {
+        query: outcome.query,
+        terms: outcome.terms,
+        termHitCounts: outcome.termHitCounts,
+        summary: formatSummary(outcome),
+        truncated: outcome.truncated,
+        totalMatchCount: outcome.totalMatchCount,
+        totalFileCount: outcome.totalFileCount,
+        vaultRoot: rootDir,
+        vaultRootUri: toFileUri(rootDir),
+        hits: outcome.files.map((file) => ({
+            file: file.filePath,
+            relativePath: vaultRelativePath(rootDir, file.filePath),
+            fileUri: toFileUri(file.filePath),
+            alsoMatchedHint: alsoMatchedHint(file.filePath, file.matchedTerms),
+            mtimeMs: file.mtimeMs,
+            topicsMatch: file.topicsMatch,
+            matches: file.hits.map((hit) => ({
+                line: hit.line,
+                term: hit.matchedTerm,
+                snippet: hit.snippet,
+            })),
+        })),
+    };
+    process.stdout.write(`${JSON.stringify(payload)}\n`);
+}
+/**
+ * CLI entry for `grounder search <query>`.
+ * @returns Exit code (`0` on success, `1` on usage or config errors).
+ */
+export async function runSearch(argv) {
+    const helpCode = helpExitCode(argv, "search");
+    if (helpCode !== null) {
+        return helpCode;
+    }
+    const { positional, flags } = parseArgs(argv);
+    if (positional.length === 0) {
+        return usageError();
+    }
+    const allowedFlags = new Set([
+        "terms",
+        "limit",
+        "max-hits",
+        "context",
+        "since",
+        "after",
+        "markdown",
+        "json",
+    ]);
+    for (const key of flags.keys()) {
+        if (!allowedFlags.has(key)) {
+            return usageError();
+        }
+    }
+    const markdown = flagBool(flags, "markdown");
+    const json = flagBool(flags, "json");
+    if (markdown && json) {
+        process.stderr.write("Use only one of --markdown or --json.\n");
+        return 1;
+    }
+    const limit = parseIntFlag(flags.get("limit"), "--limit", 1);
+    if (limit === null && flags.has("limit")) {
+        return 1;
+    }
+    const maxHits = parseIntFlag(flags.get("max-hits"), "--max-hits", 1);
+    if (maxHits === null && flags.has("max-hits")) {
+        return 1;
+    }
+    const context = parseIntFlag(flags.get("context"), "--context", 0);
+    if (context === null && flags.has("context")) {
+        return 1;
+    }
+    const sinceRaw = flags.get("since") ?? flags.get("after");
+    const since = parseSinceDate(sinceRaw);
+    if (since === null) {
+        return 1;
+    }
+    const query = positional.join(" ").trim();
+    if (!query) {
+        return usageError();
+    }
+    return runSearchWithOptions({
+        query,
+        terms: parseTermsCsv(flagString(flags, "terms")),
+        limit: limit ?? undefined,
+        maxHits: maxHits ?? undefined,
+        context: context ?? undefined,
+        since: since ?? undefined,
+        markdown,
+        json,
+    });
+}
+/**
+ * Resolves the linked project, searches its vault root, prints formatted hits.
+ */
+export async function runSearchWithOptions(options) {
+    return withHomeDir(options.homeDir, async () => {
+        const linked = await requireLinkedProject(options.cwd ?? process.cwd());
+        if (!linked) {
+            return 1;
+        }
+        const rootDir = resolveProjectVaultRoot(linked.home, linked.repo);
+        if (!(await fileExists(rootDir))) {
+            process.stderr.write(`Project vault root not found: ${rootDir}\n`);
+            process.stderr.write("Run: grounder setup <vault-path>\n");
+            return 1;
+        }
+        const outcome = await searchVault({
+            rootDir,
+            query: options.query,
+            terms: options.terms,
+            ...(options.limit !== undefined ? { limit: options.limit } : {}),
+            ...(options.maxHits !== undefined ? { maxHits: options.maxHits } : {}),
+            ...(options.context !== undefined ? { context: options.context } : {}),
+            ...(options.since !== undefined ? { since: options.since } : {}),
+        });
+        if (options.json) {
+            writeJsonOutput(outcome, rootDir);
+        }
+        else if (options.markdown) {
+            writeMarkdownOutput(outcome);
+        }
+        else {
+            writePlainOutput(outcome);
+        }
+        return 0;
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

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

package/dist/commands/{vault/init.d.ts → setup.d.ts}

@@ -1,13 +1,14 @@
-export interface VaultInitOptions {
+export interface SetupOptions {
     vaultPath: string;
     yes?: boolean;
     force?: boolean;
     /** Also install session-start teaser hooks for adapters that support them. */
     hooks?: boolean;
+    dryRun?: boolean;
     homeDir?: string;
     /** Agent ids to install for. Defaults to auto-detecting installed agents. */
     agents?: string[];
 }
-export declare function runVaultInit(argv: string[]): Promise<number>;
-export declare function runVaultInitWithOptions(options: VaultInitOptions): Promise<number>;
-//# sourceMappingURL=init.d.ts.map
+export declare function runSetup(argv: string[]): Promise<number>;
+export declare function runSetupWithOptions(options: SetupOptions): Promise<number>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAkCA,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAyBD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B9D;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAmKhF"}