grounder 0.0.1 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Grounder contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,205 @@
-# grounder
+# Grounder
 
-Setting up Git connections for Obsidian vaults to play nice with AI agents.
+[![npm version](https://img.shields.io/npm/v/grounder.svg)](https://www.npmjs.com/package/grounder)
+[![license](https://img.shields.io/npm/l/grounder.svg)](../../LICENSE)
+
+AI coding agents forget everything between sessions. Grounder gives them persistent memory in a personal Obsidian vault — notes and handoffs live outside the repo, under your control, and never get committed.
+
+- **Private by default** — vault notes live outside the project tree; only a small `projectId` marker is safe to commit
+- **Built for agents** — installs `/grounder-note`, `/grounder-task`, `/grounder-task-handoff` slash commands in Cursor and Claude Code
+- **Structured handoffs** — end a session with a Done/Next/Blockers/Decisions checkpoint; resume next time by hydrating from it
+- **Zero per-project install** — slash commands shell out via `npx`; nothing to add to the repo besides the marker file
+
+**Requirements:** Node.js 18+ and an Obsidian vault on disk. Git is optional but used when present (project id detection and link lookup bounds).
+
+**Contents:** [Install](#install) · [Quickstart](#quickstart) · [Setup overview](#setup-overview) · [Commands](#commands) · [Configuration](#configuration) · [Agents](#agents) · [Troubleshooting](#troubleshooting)
+
+## Install
+
+```bash
+npm install -g grounder
+```
+
+Or run without installing:
+
+```bash
+npx grounder --help
+```
+
+`grounder -h` prints the full reference; `grounder -v` prints the installed version.
+
+## Quickstart
+
+**1. One-time setup:**
+
+```bash
+# Once per machine — set vault location + install agent slash commands
+grounder vault init <path-to-your-vault>
+
+# Once per project folder — link project id to vault notes/ + logs/
+cd your-project
+grounder init
+```
+
+Both commands preview what they'll write and ask to confirm; add `--yes` to skip the prompt (e.g. in scripts).
+
+**2. Daily use — from your agent's chat:**
+
+```text
+> /grounder-task
+
+  Reading latest handoff… (logs/2026-07-21-091500-auth-middleware.md)
+  Done: mapped middleware order.
+  Next: 1. Add tests for 401 path
+  Starting on tests for the 401 path now.
+
+> ...you work with the agent...
+
+> /grounder-task-handoff
+
+  Wrote handoff → <vault>/10-Projects/your-project/logs/2026-07-28-143200-auth-middleware.md
+```
+
+`/grounder-task` hydrates the agent from the newest handoff plus `AGENTS.md`; `/grounder-task-handoff` writes the next checkpoint when you close the session. Behind the scenes these run `grounder handoff list` and `grounder handoff <text>` for you — see [Session loop](#session-loop).
+
+No agent, or want to write by hand? The same actions are plain CLI commands:
+
+```bash
+grounder note "Investigate auth middleware"      # ad-hoc note
+grounder handoff "# Handoff: ...\n\n## Next\n1. ..."  # session checkpoint
+grounder handoff list                            # newest handoffs, for manual hydrate
+```
+
+Notes land in `<vault>/10-Projects/{projectId}/notes/`.  
+Handoffs land in `<vault>/10-Projects/{projectId}/logs/` (one file per close; newest wins).
+
+Inspect or debug setup any time with `grounder status` / `grounder doctor` — see [Troubleshooting](#troubleshooting).
+
+### Session loop
+
+```text
+/grounder-task → work → /grounder-task-handoff → next /grounder-task
+```
+
+| Slash command | CLI | Role |
+| --- | --- | --- |
+| `/grounder-note` | `grounder note` | Ad-hoc vault note |
+| `/grounder-task-handoff` | `grounder handoff` | Write session checkpoint to `logs/` |
+| `/grounder-task` | `grounder handoff list` + read newest | Read-only hydrate from newest handoff + `AGENTS.md` |
+
+## Setup overview
+
+- **`grounder vault init <path>`** (once per machine) writes `~/.grounder/config.json`, creates `<vault>/10-Projects/`, and installs slash commands for detected agents (Cursor → `~/.cursor/commands/`, Claude Code → `~/.claude/commands/`; override with `--agent=<id>`).
+- **`grounder init`** (once per project folder) writes `.grounder.json` (`projectId` — safe to commit) and creates `<vault>/10-Projects/{projectId}/notes/` and `logs/`.
+- **Daily use** — notes, handoffs, and recall via CLI or slash commands; no further install.
+
+Nothing is written into the repo except the small `.grounder.json` marker. Agent artifacts stay under the user’s home directory; vault notes stay outside the project tree.
+
+## Commands
+
+```text
+grounder vault init <path>   Initialize vault + home config (once per machine)
+grounder init                Connect the current folder to your vault
+grounder note <text>         Write a note to the vault
+grounder handoff <text>      Write a session handoff to vault logs/
+grounder handoff list        Print recent handoff paths (newest first)
+grounder path notes          Print resolved notes directory
+grounder path logs           Print resolved logs directory
+grounder status              Snapshot of machine + project link + resolved paths
+grounder doctor              Health checks with fix hints
+```
+
+### Init flags
+
+| Flag | Commands | Description |
+| --- | --- | --- |
+| `--yes` | `vault init`, `init` | Skip confirmation prompts |
+| `--force` | `vault init`, `init` | Overwrite existing generated files |
+| `--id <id>` | `init` | Override detected project id |
+| `--vault <path>` | `init` | Override home vault root for this run |
+| `--agent <id>` | `vault init` | Install for a specific agent (repeatable; default: auto-detect). Supported: `cursor`, `claude` |
+
+### Note / handoff flags
+
+| Flag | Commands | Description |
+| --- | --- | --- |
+| `--title <slug>` | `note`, `handoff` | Filename slug (default: slugified text / first line) |
+| `--limit <n>` | `handoff list` | Max paths to print (default: 5) |
+
+### Doctor flags
+
+| Flag | Description |
+| --- | --- |
+| `--global` | Machine-only checks (skip project/link checks) |
+
+Run `grounder --help` for the full reference.
+
+### Status vs doctor
+
+| Command | Job | When to use |
+| --- | --- | --- |
+| `grounder status` | Snapshot of Machine (home config + vault path) and Project (link, id, notes/logs, git) | “Am I wired?” — see paths and link state |
+| `grounder doctor` | Health checklist (`ok` / `fail` / `warn`) with fix hints; exit `1` on any fail | “Why isn’t memory working?” — verify setup |
+
+Both are read-only. `status` exits `0` even when unlinked; `doctor` fails when checks fail. Use `doctor --global` to check the machine without a project link.
+
+## Configuration
+
+**Machine config** — `~/.grounder/config.json`:
+
+```json
+{ "vaultRoot": "/path/to/your/vault" }
+```
+
+Written by `grounder vault init`. Holds the vault path for this machine only.
+
+**Link marker** — `.grounder.json` in the folder where you run `grounder init` (safe to commit):
+
+```json
+{ "version": 1, "projectId": "your-project" }
+```
+
+Written by `grounder init` in the **current working directory**. Project id detection (when `--id` is omitted): `package.json` name in that folder → git `origin` remote (if inside a git repo) → folder basename.
+
+`grounder note`, `grounder handoff`, and `grounder path *` walk up from the current directory to find the nearest `.grounder.json`, stopping at the git root when one exists (or at the filesystem root otherwise).
+
+**Environment variables**
+
+| Variable | Description |
+| --- | --- |
+| `GROUNDER_VAULT` | Override vault root for the current session |
+| `GROUNDER_HOME` | Override home directory (default: `~`) for config resolution |
+
+## Agents
+
+The vault layout is agent-agnostic. `grounder vault init` installs thin glue artifacts per detected agent via a pluggable adapter registry (`src/agents/`).
+
+| Agent | Detection | Artifacts |
+| --- | --- | --- |
+| Cursor | `~/.cursor` exists | `~/.cursor/commands/grounder-{note,task,task-handoff}.md` |
+| Claude Code | `~/.claude` exists | `~/.claude/commands/grounder-{note,task,task-handoff}.md` |
+
+No `--agent` flag: auto-detect installed agents. Explicit install:
+
+```bash
+grounder vault init <path-to-your-vault> --agent=cursor --agent=claude
+```
+
+Slash commands tell the agent to run `npx grounder …` from the linked project folder (no global install required). Re-run with `--force` to refresh existing installs.
+
+Templates live under `templates/agents/{id}/`. Adding another agent means one adapter file + one template directory — `vault init` stays agent-blind.
+
+## Troubleshooting
+
+| Symptom | Try |
+| --- | --- |
+| Not sure if this folder is linked | `grounder status` — check Project `Linked:` and paths |
+| Notes / handoffs fail or slash commands missing | `grounder doctor` — follow fix hints |
+| Machine setup only (no project yet) | `grounder doctor --global` |
+| Home config / vault missing | `grounder vault init <path>` |
+| No `.grounder.json` / notes dirs | `grounder init` |
+| Agent slash commands stale or partial | `grounder vault init <path> --force` (or `--agent=<id>`) |
+
+## Development
+
+Source, tests, and contribution workflow live in the [Grounder monorepo](https://github.com/andrej-kolic/grounder).

package/dist/agents/claude.d.ts

@@ -0,0 +1,8 @@
+import type { AgentAdapter } from "./types.js";
+export declare function claudeCommandsDir(homeDir?: string): string;
+export declare function grounderNoteCommandPath(homeDir?: string): string;
+export declare function grounderTaskHandoffCommandPath(homeDir?: string): string;
+export declare function grounderTaskCommandPath(homeDir?: string): string;
+export declare function expectedArtifacts(homeDir?: string): string[];
+export declare const claude: AgentAdapter;
+//# sourceMappingURL=claude.d.ts.map

package/dist/agents/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/agents/claude.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,YAAY,CAAC;AAOpB,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,8BAA8B,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAE5D;AAkBD,eAAO,MAAM,MAAM,EAAE,YAkBpB,CAAC"}

package/dist/agents/claude.js

@@ -0,0 +1,50 @@
+import { copyFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolveHomeDir } from "../connector/home.js";
+import { fileExists } from "../util/fs.js";
+const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+const templateDir = path.join(pkgRoot, "templates", "agents", "claude", "commands");
+const COMMANDS = ["grounder-note.md", "grounder-task-handoff.md", "grounder-task.md"];
+export function claudeCommandsDir(homeDir) {
+    return path.join(resolveHomeDir(homeDir), ".claude", "commands");
+}
+export function grounderNoteCommandPath(homeDir) {
+    return path.join(claudeCommandsDir(homeDir), "grounder-note.md");
+}
+export function grounderTaskHandoffCommandPath(homeDir) {
+    return path.join(claudeCommandsDir(homeDir), "grounder-task-handoff.md");
+}
+export function grounderTaskCommandPath(homeDir) {
+    return path.join(claudeCommandsDir(homeDir), "grounder-task.md");
+}
+export function expectedArtifacts(homeDir) {
+    return COMMANDS.map((filename) => path.join(claudeCommandsDir(homeDir), filename));
+}
+async function installCommand(filename, opts) {
+    const dest = path.join(claudeCommandsDir(opts.homeDir), filename);
+    const existed = await fileExists(dest);
+    if (existed && !opts.force) {
+        return { dest, status: "skipped" };
+    }
+    await mkdir(path.dirname(dest), { recursive: true });
+    await copyFile(path.join(templateDir, filename), dest);
+    return { dest, status: existed ? "overwritten" : "created" };
+}
+export const claude = {
+    id: "claude",
+    name: "Claude Code",
+    async isInstalled() {
+        return fileExists(path.join(resolveHomeDir(), ".claude"));
+    },
+    expectedArtifacts,
+    async install(opts) {
+        const artifacts = {};
+        for (const filename of COMMANDS) {
+            const { dest, status } = await installCommand(filename, opts);
+            artifacts[dest] = status;
+        }
+        return { artifacts };
+    },
+};
+//# sourceMappingURL=claude.js.map

package/dist/agents/claude.js.map

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

package/dist/agents/cursor.d.ts

@@ -0,0 +1,8 @@
+import type { AgentAdapter } from "./types.js";
+export declare function cursorCommandsDir(homeDir?: string): string;
+export declare function grounderNoteCommandPath(homeDir?: string): string;
+export declare function grounderTaskHandoffCommandPath(homeDir?: string): string;
+export declare function grounderTaskCommandPath(homeDir?: string): string;
+export declare function expectedArtifacts(homeDir?: string): string[];
+export declare const cursor: AgentAdapter;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/agents/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/agents/cursor.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,YAAY,CAAC;AAOpB,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,8BAA8B,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAE5D;AAkBD,eAAO,MAAM,MAAM,EAAE,YAkBpB,CAAC"}

package/dist/agents/cursor.js

@@ -0,0 +1,50 @@
+import { copyFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolveHomeDir } from "../connector/home.js";
+import { fileExists } from "../util/fs.js";
+const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+const templateDir = path.join(pkgRoot, "templates", "agents", "cursor", "commands");
+const COMMANDS = ["grounder-note.md", "grounder-task-handoff.md", "grounder-task.md"];
+export function cursorCommandsDir(homeDir) {
+    return path.join(resolveHomeDir(homeDir), ".cursor", "commands");
+}
+export function grounderNoteCommandPath(homeDir) {
+    return path.join(cursorCommandsDir(homeDir), "grounder-note.md");
+}
+export function grounderTaskHandoffCommandPath(homeDir) {
+    return path.join(cursorCommandsDir(homeDir), "grounder-task-handoff.md");
+}
+export function grounderTaskCommandPath(homeDir) {
+    return path.join(cursorCommandsDir(homeDir), "grounder-task.md");
+}
+export function expectedArtifacts(homeDir) {
+    return COMMANDS.map((filename) => path.join(cursorCommandsDir(homeDir), filename));
+}
+async function installCommand(filename, opts) {
+    const dest = path.join(cursorCommandsDir(opts.homeDir), filename);
+    const existed = await fileExists(dest);
+    if (existed && !opts.force) {
+        return { dest, status: "skipped" };
+    }
+    await mkdir(path.dirname(dest), { recursive: true });
+    await copyFile(path.join(templateDir, filename), dest);
+    return { dest, status: existed ? "overwritten" : "created" };
+}
+export const cursor = {
+    id: "cursor",
+    name: "Cursor",
+    async isInstalled() {
+        return fileExists(path.join(resolveHomeDir(), ".cursor"));
+    },
+    expectedArtifacts,
+    async install(opts) {
+        const artifacts = {};
+        for (const filename of COMMANDS) {
+            const { dest, status } = await installCommand(filename, opts);
+            artifacts[dest] = status;
+        }
+        return { artifacts };
+    },
+};
+//# sourceMappingURL=cursor.js.map

package/dist/agents/cursor.js.map

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

package/dist/agents/index.d.ts

@@ -0,0 +1,11 @@
+import type { AgentAdapter } from "./types.js";
+export { claude } from "./claude.js";
+export { cursor } from "./cursor.js";
+export type { AgentAdapter, AgentInstallOptions, AgentInstallResult, ArtifactStatus, } from "./types.js";
+/**
+ * Resolve which adapters to run:
+ *  - If `ids` is provided, return those adapters (throws on unknown id).
+ *  - Otherwise, auto-detect by checking isInstalled() for each adapter.
+ */
+export declare function resolveAgents(ids?: string[]): Promise<AgentAdapter[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,GACf,MAAM,YAAY,CAAC;AAIpB;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAc3E"}

package/dist/agents/index.js

@@ -0,0 +1,23 @@
+import { claude } from "./claude.js";
+import { cursor } from "./cursor.js";
+export { claude } from "./claude.js";
+export { cursor } from "./cursor.js";
+const ALL_ADAPTERS = [cursor, claude];
+/**
+ * Resolve which adapters to run:
+ *  - If `ids` is provided, return those adapters (throws on unknown id).
+ *  - Otherwise, auto-detect by checking isInstalled() for each adapter.
+ */
+export async function resolveAgents(ids) {
+    if (ids && ids.length > 0) {
+        const found = ALL_ADAPTERS.filter((a) => ids.includes(a.id));
+        const unknown = ids.filter((id) => !ALL_ADAPTERS.some((a) => a.id === id));
+        if (unknown.length > 0) {
+            throw new Error(`Unknown agent id(s): ${unknown.join(", ")}`);
+        }
+        return found;
+    }
+    const results = await Promise.all(ALL_ADAPTERS.map(async (a) => ({ adapter: a, ok: await a.isInstalled() })));
+    return results.filter((r) => r.ok).map((r) => r.adapter);
+}
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAQrC,MAAM,YAAY,GAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAc;IAChD,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAC3E,CAAC;IACF,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAC3D,CAAC"}

package/dist/agents/types.d.ts

@@ -0,0 +1,22 @@
+export type ArtifactStatus = "created" | "skipped" | "overwritten";
+export interface AgentInstallOptions {
+    force?: boolean;
+    homeDir?: string;
+}
+export interface AgentInstallResult {
+    /** Map of installed file path → what happened to it. */
+    artifacts: Record<string, ArtifactStatus>;
+}
+export interface AgentAdapter {
+    /** Stable lowercase id used in config and flags, e.g. "cursor". */
+    readonly id: string;
+    /** Human-readable display name, e.g. "Cursor". */
+    readonly name: string;
+    /** Returns true when this agent appears to be installed on the machine. */
+    isInstalled(): Promise<boolean>;
+    /** Absolute paths of artifacts this adapter installs (read-only inspect). */
+    expectedArtifacts(homeDir?: string): string[];
+    /** Install all agent-specific artifacts (commands, rules, etc.). */
+    install(opts: AgentInstallOptions): Promise<AgentInstallResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,6EAA6E;IAC7E,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9C,oEAAoE;IACpE,OAAO,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACjE"}

package/dist/agents/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":""}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { runDoctor } from "./commands/doctor.js";
+import { runHandoffList } from "./commands/handoff/list.js";
+import { runHandoff } from "./commands/handoff.js";
+import { runNote } from "./commands/note.js";
+import { runPathLogs } from "./commands/path/logs.js";
+import { runPathNotes } from "./commands/path/notes.js";
+import { runRepoInit } from "./commands/repo/init.js";
+import { runStatus } from "./commands/status.js";
+import { runVaultInit } from "./commands/vault/init.js";
+const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const pkg = JSON.parse(readFileSync(path.join(pkgRoot, "package.json"), "utf8"));
+const USAGE = `grounder — connect git projects to Obsidian dev vaults for AI agents
+
+Usage:
+  grounder vault init <path>   Initialize vault + home config (once per machine)
+  grounder init                Connect the current repo to your vault
+  grounder note <text>         Write a note to the vault
+  grounder handoff <text>      Write a session handoff to vault logs/
+  grounder handoff list        Print recent handoff paths (newest first)
+  grounder path notes          Print resolved notes directory
+  grounder path logs           Print resolved logs directory
+  grounder status              Snapshot of machine + project link + resolved paths
+  grounder doctor              Health checks with fix hints
+
+Options:
+  -h, --help     Show this help
+  -v, --version  Show version
+
+Init flags:
+  --yes          Skip confirmation prompts
+  --force        Overwrite existing generated files
+  --id <id>      Override detected project id (grounder init)
+  --vault <path> Override home vault root for this run (grounder init)
+  --agent <id>   Install for a specific agent (repeatable; default: auto-detect)
+                 Supported: cursor, claude
+
+Doctor flags:
+  --global       Machine-only checks (skip project/link checks)
+
+Note / handoff flags:
+  --title <slug> Short slug in filename (default: slugified first line)
+  --limit <n>    Max paths for handoff list (default: 5)
+
+Quickstart:
+  grounder vault init ~/Documents/obsidian/dev
+  grounder init
+  grounder note "my first note"
+  grounder handoff "# Handoff\\n\\n## Next\\n1. …"
+  grounder handoff list
+`;
+function printHelp() {
+    process.stdout.write(USAGE);
+}
+function printVersion() {
+    process.stdout.write(`${pkg.version}\n`);
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args[0] === "-h" || args[0] === "--help") {
+        printHelp();
+        process.exit(0);
+    }
+    if (args[0] === "-v" || args[0] === "--version") {
+        printVersion();
+        return;
+    }
+    const [command, ...rest] = args;
+    if (command === "vault" && rest[0] === "init") {
+        process.exit(await runVaultInit(rest.slice(1)));
+    }
+    if (command === "init") {
+        process.exit(await runRepoInit(rest));
+    }
+    if (command === "note") {
+        process.exit(await runNote(rest));
+    }
+    if (command === "handoff" && rest[0] === "list") {
+        process.exit(await runHandoffList(rest.slice(1)));
+    }
+    if (command === "handoff") {
+        process.exit(await runHandoff(rest));
+    }
+    if (command === "path" && rest[0] === "notes") {
+        process.exit(await runPathNotes(rest.slice(1)));
+    }
+    if (command === "path" && rest[0] === "logs") {
+        process.exit(await runPathLogs(rest.slice(1)));
+    }
+    if (command === "status") {
+        process.exit(await runStatus(rest));
+    }
+    if (command === "doctor") {
+        process.exit(await runDoctor(rest));
+    }
+    process.stderr.write(`Unknown command: ${args.join(" ")}\n\n`);
+    printHelp();
+    process.exit(1);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/check.d.ts

@@ -0,0 +1,13 @@
+/** Shared result shape for doctor (and similar) health checks. */
+export type CheckLevel = "ok" | "fail" | "warn";
+export interface CheckResult {
+    id: string;
+    level: CheckLevel;
+    message: string;
+    /** Actionable fix hint when level is not `"ok"`. */
+    fix?: string;
+}
+export declare function okCheck(id: string, message: string): CheckResult;
+export declare function failCheck(id: string, message: string, fix?: string): CheckResult;
+export declare function warnCheck(id: string, message: string, fix?: string): CheckResult;
+//# sourceMappingURL=check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAEhE;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAOhF;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAOhF"}

package/dist/commands/check.js

@@ -0,0 +1,21 @@
+/** Shared result shape for doctor (and similar) health checks. */
+export function okCheck(id, message) {
+    return { id, level: "ok", message };
+}
+export function failCheck(id, message, fix) {
+    return {
+        id,
+        level: "fail",
+        message,
+        ...(fix !== undefined ? { fix } : {}),
+    };
+}
+export function warnCheck(id, message, fix) {
+    return {
+        id,
+        level: "warn",
+        message,
+        ...(fix !== undefined ? { fix } : {}),
+    };
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAYlE,MAAM,UAAU,OAAO,CAAC,EAAU,EAAE,OAAe;IACjD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAU,EAAE,OAAe,EAAE,GAAY;IACjE,OAAO;QACL,EAAE;QACF,KAAK,EAAE,MAAM;QACb,OAAO;QACP,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAU,EAAE,OAAe,EAAE,GAAY;IACjE,OAAO;QACL,EAAE;QACF,KAAK,EAAE,MAAM;QACb,OAAO;QACP,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtC,CAAC;AACJ,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,9 @@
+export interface DoctorOptions {
+    cwd?: string;
+    homeDir?: string;
+    /** Machine-only checks (skip project/link checks). */
+    global?: boolean;
+}
+export declare function runDoctor(argv: string[]): Promise<number>;
+export declare function runDoctorWithOptions(options?: DoctorOptions): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA2OD,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAG/D;AAED,wBAAsB,oBAAoB,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBvF"}