grounder 0.5.0 → 0.6.0

package/dist/agents/install-command.js

@@ -1,65 +0,0 @@
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { readGrounderState, recordAgentInstall, recordedFileHash } from "../connector/state.js";
-import { VERSION } from "../index.js";
-import { fileExists } from "../util/fs.js";
-import { hashContent } from "../util/hash.js";
-import { runtimeInvocation } from "./hook-runtime.js";
-/**
- * Install one slash-command markdown file with chezmoi-style drift detection.
- *
- * When the file already exists and `--force` is off:
- * - on-disk hash matches the ledger → safe to refresh to the new template
- * - no ledger hash, or on-disk hash differs → treat as user-edited (`modified`)
- */
-export async function installCommandFile(opts) {
-    const dest = path.join(opts.commandsDir, opts.filename);
-    const existed = await fileExists(dest);
-    const template = await readFile(path.join(opts.templateDir, opts.filename), "utf8");
-    const rendered = template.replaceAll("{{GROUNDER_CLI}}", runtimeInvocation(opts.homeDir));
-    const renderedHash = hashContent(rendered);
-    if (existed && !opts.force) {
-        const onDisk = await readFile(dest, "utf8");
-        const onDiskHash = hashContent(onDisk);
-        const state = await readGrounderState(opts.homeDir);
-        const recorded = recordedFileHash(state, opts.agentId, dest);
-        if (recorded !== undefined && recorded === onDiskHash) {
-            // Untouched since Grounder last wrote it — safe to auto-update.
-            if (onDiskHash === renderedHash) {
-                return { dest, status: "skipped", hash: renderedHash };
-            }
-            if (!opts.dryRun) {
-                await writeFile(dest, rendered);
-            }
-            return { dest, status: "overwritten", hash: renderedHash };
-        }
-        // Legacy (no hash) or user-edited — protect content.
-        return { dest, status: "modified" };
-    }
-    if (!opts.dryRun) {
-        await mkdir(path.dirname(dest), { recursive: true });
-        await writeFile(dest, rendered);
-    }
-    return {
-        dest,
-        status: existed ? "overwritten" : "created",
-        hash: renderedHash,
-    };
-}
-/**
- * Persist per-file hashes after a command install. No-op when `files` is empty
- * or `dryRun` is set.
- */
-export async function recordCommandFileHashes(opts) {
-    if (opts.dryRun || Object.keys(opts.files).length === 0) {
-        return;
-    }
-    await recordAgentInstall({
-        agentId: opts.agentId,
-        commandsSchema: opts.commandsSchema,
-        files: opts.files,
-        grounderVersion: VERSION,
-        homeDir: opts.homeDir,
-    });
-}
-//# sourceMappingURL=install-command.js.map

package/dist/agents/install-command.js.map

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

package/dist/commands/apply-agent-installs.d.ts

@@ -1,34 +0,0 @@
-import type { AgentAdapter, AgentInstallResult, ArtifactStatus } from "../agents/types.js";
-export interface ApplyAgentInstallsOptions {
-    agents: AgentAdapter[];
-    force?: boolean;
-    /** Explicitly install/refresh session hooks (setup --hooks / migrate --hooks). */
-    hooks?: boolean;
-    /**
-     * When true (migrate), also refresh hooks that were previously recorded or
-     * already present on disk — without installing hooks for agents that never
-     * opted in.
-     */
-    refreshInstalledHooks?: boolean;
-    dryRun?: boolean;
-    homeDir?: string;
-}
-export interface AgentApplyResult {
-    agent: AgentAdapter;
-    commands: AgentInstallResult;
-    hooks?: AgentInstallResult;
-}
-export interface ApplyAgentInstallsResult {
-    runtime?: {
-        cliPath: string;
-        status: ArtifactStatus;
-        mode: "symlink" | "copy";
-    };
-    agents: AgentApplyResult[];
-}
-/**
- * Materialize runtime + install/refresh agent command (and optional hook)
- * artifacts. Shared by `grounder setup` and `grounder migrate`.
- */
-export declare function applyAgentInstalls(opts: ApplyAgentInstallsOptions): Promise<ApplyAgentInstallsResult>;
-//# sourceMappingURL=apply-agent-installs.d.ts.map

package/dist/commands/apply-agent-installs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"apply-agent-installs.d.ts","sourceRoot":"","sources":["../../src/commands/apply-agent-installs.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAS3F,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kFAAkF;IAClF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,cAAc,CAAC;QAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAA;KAAE,CAAC;IAChF,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AA+DD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,wBAAwB,CAAC,CA6FnC"}

package/dist/commands/apply-agent-installs.js

@@ -1,137 +0,0 @@
-import { hookFileHasGrounderEntry, installHookRuntime, runtimeCliPath, } from "../agents/hook-runtime.js";
-import { recordAgentInstallState } from "../agents/index.js";
-import { assertAgentSchemasSupported, readGrounderState, recordedHooksSchema, statePath, } from "../connector/state.js";
-async function agentHasInstalledHooks(agent, homeDir) {
-    if (!agent.expectedHookArtifacts) {
-        return false;
-    }
-    const paths = agent.expectedHookArtifacts(homeDir);
-    for (const p of paths) {
-        if (await hookFileHasGrounderEntry(p)) {
-            return true;
-        }
-    }
-    return false;
-}
-async function shouldInstallHooks(agent, opts, state) {
-    if (!agent.installHooks) {
-        return false;
-    }
-    if (opts.hooks) {
-        return true;
-    }
-    if (!opts.refreshInstalledHooks) {
-        return false;
-    }
-    if (recordedHooksSchema(state, agent.id) > 0) {
-        return true;
-    }
-    return agentHasInstalledHooks(agent, opts.homeDir);
-}
-function commandLabel(status, artifactPath, dryRun) {
-    switch (status) {
-        case "skipped":
-            return dryRun ? "would skip (already current)" : "already current (skipped)";
-        case "modified":
-            return dryRun
-                ? `would skip locally modified (needs --force): ${artifactPath}`
-                : `locally modified (skipped — use --force): ${artifactPath}`;
-        case "created":
-            return dryRun ? `would install: ${artifactPath}` : `installed: ${artifactPath}`;
-        case "overwritten":
-            return dryRun ? `would update: ${artifactPath}` : `updated: ${artifactPath}`;
-    }
-}
-function hookLabel(status, artifactPath, dryRun) {
-    switch (status) {
-        case "skipped":
-            return dryRun ? "would skip (already current)" : "already exists (skipped)";
-        case "created":
-            return dryRun ? `would install: ${artifactPath}` : `installed: ${artifactPath}`;
-        case "overwritten":
-            return dryRun ? `would update: ${artifactPath}` : `updated: ${artifactPath}`;
-        case "modified":
-            return dryRun ? `would skip: ${artifactPath}` : `skipped: ${artifactPath}`;
-    }
-}
-/**
- * Materialize runtime + install/refresh agent command (and optional hook)
- * artifacts. Shared by `grounder setup` and `grounder migrate`.
- */
-export async function applyAgentInstalls(opts) {
-    const force = opts.force ?? false;
-    const dryRun = opts.dryRun ?? false;
-    const homeDir = opts.homeDir;
-    const agents = opts.agents;
-    const state = await readGrounderState(homeDir);
-    assertAgentSchemasSupported(state, agents);
-    let runtime;
-    if (agents.length > 0) {
-        if (dryRun) {
-            process.stdout.write(`✓ Grounder runtime would refresh: ${runtimeCliPath(homeDir)}\n`);
-        }
-        else {
-            runtime = await installHookRuntime({ homeDir });
-            const runtimeLabel = runtime.status === "skipped"
-                ? "already exists (skipped)"
-                : `installed (${runtime.mode}): ${runtime.cliPath}`;
-            process.stdout.write(`✓ Grounder runtime ${runtimeLabel}\n`);
-        }
-    }
-    const results = [];
-    for (const agent of agents) {
-        const commands = await agent.install({ force, dryRun, homeDir });
-        for (const [artifactPath, status] of Object.entries(commands.artifacts)) {
-            process.stdout.write(`✓ ${agent.name} command ${commandLabel(status, artifactPath, dryRun)}\n`);
-        }
-        if (Object.keys(commands.artifacts).length === 0) {
-            process.stdout.write(`✓ ${agent.name}: no artifacts to install yet\n`);
-        }
-        let hooksResult;
-        let hooksInstalled = false;
-        if (await shouldInstallHooks(agent, opts, state)) {
-            const installHooks = agent.installHooks;
-            if (installHooks) {
-                hooksResult = await installHooks({ force, dryRun, homeDir });
-                hooksInstalled = true;
-                for (const [artifactPath, status] of Object.entries(hooksResult.artifacts)) {
-                    process.stdout.write(`✓ ${agent.name} hook ${hookLabel(status, artifactPath, dryRun)}\n`);
-                }
-            }
-        }
-        if (!dryRun) {
-            const statuses = Object.values(commands.artifacts);
-            // Only bump the commands version in state when at least one file was
-            // written or already up to date. If every file was skipped as locally
-            // edited (or from before Grounder tracked hashes), do not mark state as
-            // current — otherwise plain migrate would silence doctor while leaving
-            // those old command files untouched.
-            const advanceCommandsSchema = statuses.length === 0 || statuses.some((status) => status !== "modified");
-            await recordAgentInstallState(agent, {
-                hooksInstalled,
-                homeDir,
-                advanceCommandsSchema,
-            });
-        }
-        results.push({ agent, commands, hooks: hooksResult });
-    }
-    if (agents.length > 0) {
-        const ledger = statePath(homeDir);
-        if (dryRun) {
-            process.stdout.write(state
-                ? `✓ Install state would update: ${ledger}\n`
-                : `✓ Install state would create: ${ledger}\n`);
-        }
-        else {
-            process.stdout.write(state ? `✓ Install state updated: ${ledger}\n` : `✓ Install state created: ${ledger}\n`);
-        }
-    }
-    const modifiedWithoutForce = !force &&
-        results.some((r) => Object.values(r.commands.artifacts).some((s) => s === "modified"));
-    if (modifiedWithoutForce) {
-        process.stdout.write("\nNote: some command files were left alone (local edits, or an install from before Grounder 0.3).\n" +
-            "  To refresh them: grounder migrate --force\n");
-    }
-    return { runtime, agents: results };
-}
-//# sourceMappingURL=apply-agent-installs.js.map

package/dist/commands/apply-agent-installs.js.map

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

package/templates/agents/claude/commands/grounder-task-handoff.md

@@ -1,58 +0,0 @@
-Write a session handoff checkpoint to the markdown vault for this project.
-
-Summarize the session into a structured handoff — not a chat transcript.
-Do not dump tool traces, full conversation, or false starts.
-
-Build a markdown body with these sections (lean; roughly half a screen to one screen):
-
-```markdown
-# Handoff: <short label>
-
-## Done
-- …
-
-## Next
-1. …   # ordered; most important section for resume — required
-2. …
-
-## Blockers
-- None | …
-
-## Decisions
-- …    # include rejected alternatives / pitfalls when useful
-
-## Files
-- path/to/relevant.ts
-```
-
-Rules:
-- **Next is mandatory and ordered** — if only one section is read, this is it
-- Empty sections are OK (`Blockers: None` beats omission)
-- Few concrete file paths, not an exhaustive diff
-
-Then run from the linked project folder or any subdirectory beneath it:
-
-  {{GROUNDER_CLI}} handoff "<body>"
-
-Optional short title slug (filename + frontmatter):
-
-  {{GROUNDER_CLI}} handoff --title <slug> "<body>"
-
-Always include `--topics` with 3-5 comma-separated lowercase keywords that capture the session's core concepts (e.g. `--topics "auth,middleware,jwt,session"`). Pick terms a future search would use — concrete nouns and technical terms, not verbs or filler:
-
-  {{GROUNDER_CLI}} handoff --topics "keyword1,keyword2,keyword3" "<body>"
-
-For multi-line bodies, prefer a shell heredoc so quoting does not break:
-
-```bash
-{{GROUNDER_CLI}} handoff "$(cat <<'EOF'
-# Handoff: …
-…
-EOF
-)"
-```
-
-The vault is outside the workspace — grant shell permissions if Claude Code prompts you.
-
-Do not compute vault paths or write files yourself — the CLI handles it.
-Report the CLI output path from stdout to the user.

package/templates/agents/claude/commands/grounder-task.md

@@ -1,22 +0,0 @@
-Hydrate this session from the latest vault handoff and repo truth.
-
-Read-only — do not write to the vault. Do not invent vault paths.
-
-**Special case: the instruction asks to view existing handoffs, not hydrate** (`list`, `list 3 oldest`, `show handoffs`, etc.) → run `{{GROUNDER_CLI}} handoff list --limit <N> --markdown` (N = count named, else 5; ignore order words like "oldest" — output is always newest-first, never resort or relabel it) and stop — no hydrate, no `AGENTS.md`, no “start work.” Relay the CLI stdout as-is (it already includes the count header; title lines are clickable `[relativePath](fileUri)` links).
-
-Otherwise, from the linked project folder or any subdirectory beneath it:
-
-1. Get the current handoff (skips empty/unreadable files, same pick as the session-start teaser):
-
-   {{GROUNDER_CLI}} handoff list --head
-
-2. If empty: tell the user there are no handoffs yet, then read repo `AGENTS.md` only and proceed.
-
-3. Otherwise, read that file. If the user names a specific session instead: `{{GROUNDER_CLI}} handoff list --limit 5 --markdown` → match name/index to the indented absolute path in *this* listing (positional, not a stable id). Miss → once with `--limit 50 --markdown` (*that* listing only). Still miss → tell the user and stop — no guessed hydrate.
-
-4. Read repo `AGENTS.md` (project conventions and constraints).
-
-5. Summarize briefly what is next (from the handoff `## Next` section when present), then start work.
-
-The vault is outside the workspace — grant shell permissions if Claude Code prompts you.
-Use free-text after `/grounder-task` as optional focus (session name, index, or task hint).

package/templates/agents/cursor/commands/grounder-task-handoff.md

@@ -1,58 +0,0 @@
-Write a session handoff checkpoint to the markdown vault for this project.
-
-Summarize the session into a structured handoff — not a chat transcript.
-Do not dump tool traces, full conversation, or false starts.
-
-Build a markdown body with these sections (lean; roughly half a screen to one screen):
-
-```markdown
-# Handoff: <short label>
-
-## Done
-- …
-
-## Next
-1. …   # ordered; most important section for resume — required
-2. …
-
-## Blockers
-- None | …
-
-## Decisions
-- …    # include rejected alternatives / pitfalls when useful
-
-## Files
-- path/to/relevant.ts
-```
-
-Rules:
-- **Next is mandatory and ordered** — if only one section is read, this is it
-- Empty sections are OK (`Blockers: None` beats omission)
-- Few concrete file paths, not an exhaustive diff
-
-Then run from the linked project folder or any subdirectory beneath it:
-
-  {{GROUNDER_CLI}} handoff "<body>"
-
-Optional short title slug (filename + frontmatter):
-
-  {{GROUNDER_CLI}} handoff --title <slug> "<body>"
-
-Always include `--topics` with 3-5 comma-separated lowercase keywords that capture the session's core concepts (e.g. `--topics "auth,middleware,jwt,session"`). Pick terms a future search would use — concrete nouns and technical terms, not verbs or filler:
-
-  {{GROUNDER_CLI}} handoff --topics "keyword1,keyword2,keyword3" "<body>"
-
-For multi-line bodies, prefer a shell heredoc so quoting does not break:
-
-```bash
-{{GROUNDER_CLI}} handoff "$(cat <<'EOF'
-# Handoff: …
-…
-EOF
-)"
-```
-
-Run {{GROUNDER_CLI}} with `required_permissions: ["all"]` (vault is outside the workspace).
-
-Do not compute vault paths or write files yourself — the CLI handles it.
-Report the CLI output path from stdout to the user.

package/templates/agents/cursor/commands/grounder-task.md

@@ -1,22 +0,0 @@
-Hydrate this session from the latest vault handoff and repo truth.
-
-Read-only — do not write to the vault. Do not invent vault paths.
-
-**Special case: the instruction asks to view existing handoffs, not hydrate** (`list`, `list 3 oldest`, `show handoffs`, etc.) → run `{{GROUNDER_CLI}} handoff list --limit <N> --markdown` (N = count named, else 5; ignore order words like "oldest" — output is always newest-first, never resort or relabel it) and stop — no hydrate, no `AGENTS.md`, no “start work.” Relay the CLI stdout as-is (it already includes the count header; title lines are clickable `[relativePath](fileUri)` links).
-
-Otherwise, from the linked project folder or any subdirectory beneath it:
-
-1. Get the current handoff (skips empty/unreadable files, same pick as the session-start teaser):
-
-   {{GROUNDER_CLI}} handoff list --head
-
-2. If empty: tell the user there are no handoffs yet, then read repo `AGENTS.md` only and proceed.
-
-3. Otherwise, read that file. If the user names a specific session instead: `{{GROUNDER_CLI}} handoff list --limit 5 --markdown` → match name/index to the indented absolute path in *this* listing (positional, not a stable id). Miss → once with `--limit 50 --markdown` (*that* listing only). Still miss → tell the user and stop — no guessed hydrate.
-
-4. Read repo `AGENTS.md` (project conventions and constraints).
-
-5. Summarize briefly what is next (from the handoff `## Next` section when present), then start work.
-
-Run {{GROUNDER_CLI}} with `required_permissions: ["all"]` (vault is outside the workspace).
-Use free-text after `/grounder-task` as optional focus (session name, index, or task hint).