grounder 0.0.1 → 0.0.2

package/dist/commands/handoff.js

@@ -0,0 +1,47 @@
+import { currentBranch } from "../connector/git.js";
+import { withHomeDir } from "../connector/home.js";
+import { resolveLogsDir } from "../connector/vault.js";
+import { flagString, parseArgs } from "../util/parse-args.js";
+import { writeHandoff } from "../vault/write-handoff.js";
+import { requireLinkedProject } from "./require-linked.js";
+/**
+ * CLI entry for `grounder handoff <text> [--title <slug>]`.
+ * @returns Exit code (`0` on success, `1` on usage or config errors).
+ */
+export async function runHandoff(argv) {
+    const { positional, flags } = parseArgs(argv);
+    const text = positional.join(" ").trim();
+    if (!text) {
+        process.stderr.write("Usage: grounder handoff <text>\n");
+        return 1;
+    }
+    return runHandoffWithOptions({
+        text,
+        title: flagString(flags, "title"),
+    });
+}
+/**
+ * Resolves the linked project, writes a new handoff under `logs/`, prints `Wrote <path>`.
+ * Same vault/link prerequisites as `grounder note`.
+ * @returns Exit code (`0` on success, `1` when vault/link is missing).
+ */
+export async function runHandoffWithOptions(options) {
+    return withHomeDir(options.homeDir, async () => {
+        const linked = await requireLinkedProject(options.cwd ?? process.cwd());
+        if (!linked) {
+            return 1;
+        }
+        const { home, repo, gitRoot } = linked;
+        const logsDir = resolveLogsDir(home, repo);
+        const branch = gitRoot ? await currentBranch(gitRoot) : undefined;
+        const writtenPath = await writeHandoff(logsDir, options.text, {
+            projectId: repo.projectId,
+            title: options.title,
+            branch,
+            now: options.now,
+        });
+        process.stdout.write(`Wrote ${writtenPath}\n`);
+        return 0;
+    });
+}
+//# sourceMappingURL=handoff.js.map

package/dist/commands/handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../../src/commands/handoff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAgB3D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAc;IAC7C,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACzD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,qBAAqB,CAAC;QAC3B,IAAI;QACJ,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC;KAClC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAuB;IACjE,OAAO,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QACvC,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClE,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;YAC5D,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM;YACN,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,WAAW,IAAI,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/note.d.ts

@@ -0,0 +1,10 @@
+export interface NoteOptions {
+    cwd?: string;
+    text: string;
+    title?: string;
+    homeDir?: string;
+    now?: Date;
+}
+export declare function runNote(argv: string[]): Promise<number>;
+export declare function runNoteWithOptions(options: NoteOptions): Promise<number>;
+//# sourceMappingURL=note.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"note.d.ts","sourceRoot":"","sources":["../../src/commands/note.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAa7D;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB9E"}

package/dist/commands/note.js

@@ -0,0 +1,33 @@
+import { withHomeDir } from "../connector/home.js";
+import { resolveNotesDir } from "../connector/vault.js";
+import { flagString, parseArgs } from "../util/parse-args.js";
+import { writeNote } from "../vault/write-note.js";
+import { requireLinkedProject } from "./require-linked.js";
+export async function runNote(argv) {
+    const { positional, flags } = parseArgs(argv);
+    const text = positional.join(" ").trim();
+    if (!text) {
+        process.stderr.write("Usage: grounder note <text>\n");
+        return 1;
+    }
+    return runNoteWithOptions({
+        text,
+        title: flagString(flags, "title"),
+    });
+}
+export async function runNoteWithOptions(options) {
+    return withHomeDir(options.homeDir, async () => {
+        const linked = await requireLinkedProject(options.cwd ?? process.cwd());
+        if (!linked) {
+            return 1;
+        }
+        const notesDir = resolveNotesDir(linked.home, linked.repo);
+        const writtenPath = await writeNote(notesDir, options.text, {
+            title: options.title,
+            now: options.now,
+        });
+        process.stdout.write(`Wrote ${writtenPath}\n`);
+        return 0;
+    });
+}
+//# sourceMappingURL=note.js.map

package/dist/commands/note.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"note.js","sourceRoot":"","sources":["../../src/commands/note.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAU3D,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAc;IAC1C,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACtD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,kBAAkB,CAAC;QACxB,IAAI;QACJ,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC;KAClC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAoB;IAC3D,OAAO,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,WAAW,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE;YAC1D,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,WAAW,IAAI,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/path/logs.d.ts

@@ -0,0 +1,7 @@
+export interface PathLogsOptions {
+    cwd?: string;
+    homeDir?: string;
+}
+export declare function runPathLogs(_argv: string[]): Promise<number>;
+export declare function runPathLogsWithOptions(options?: PathLogsOptions): Promise<number>;
+//# sourceMappingURL=logs.d.ts.map

package/dist/commands/path/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../../src/commands/path/logs.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAElE;AAED,wBAAsB,sBAAsB,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAU3F"}

package/dist/commands/path/logs.js

@@ -0,0 +1,17 @@
+import { withHomeDir } from "../../connector/home.js";
+import { resolveLogsDir } from "../../connector/vault.js";
+import { requireLinkedProject } from "../require-linked.js";
+export async function runPathLogs(_argv) {
+    return runPathLogsWithOptions({});
+}
+export async function runPathLogsWithOptions(options = {}) {
+    return withHomeDir(options.homeDir, async () => {
+        const linked = await requireLinkedProject(options.cwd ?? process.cwd());
+        if (!linked) {
+            return 1;
+        }
+        process.stdout.write(`${resolveLogsDir(linked.home, linked.repo)}\n`);
+        return 0;
+    });
+}
+//# sourceMappingURL=logs.js.map

package/dist/commands/path/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../src/commands/path/logs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAO5D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAe;IAC/C,OAAO,sBAAsB,CAAC,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,UAA2B,EAAE;IACxE,OAAO,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,CAAC;QACX,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtE,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/path/notes.d.ts

@@ -0,0 +1,7 @@
+export interface PathNotesOptions {
+    cwd?: string;
+    homeDir?: string;
+}
+export declare function runPathNotes(_argv: string[]): Promise<number>;
+export declare function runPathNotesWithOptions(options?: PathNotesOptions): Promise<number>;
+//# sourceMappingURL=notes.d.ts.map

package/dist/commands/path/notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.d.ts","sourceRoot":"","sources":["../../../src/commands/path/notes.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnE;AAED,wBAAsB,uBAAuB,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAU7F"}

package/dist/commands/path/notes.js

@@ -0,0 +1,17 @@
+import { withHomeDir } from "../../connector/home.js";
+import { resolveNotesDir } from "../../connector/vault.js";
+import { requireLinkedProject } from "../require-linked.js";
+export async function runPathNotes(_argv) {
+    return runPathNotesWithOptions({});
+}
+export async function runPathNotesWithOptions(options = {}) {
+    return withHomeDir(options.homeDir, async () => {
+        const linked = await requireLinkedProject(options.cwd ?? process.cwd());
+        if (!linked) {
+            return 1;
+        }
+        process.stdout.write(`${resolveNotesDir(linked.home, linked.repo)}\n`);
+        return 0;
+    });
+}
+//# sourceMappingURL=notes.js.map

package/dist/commands/path/notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.js","sourceRoot":"","sources":["../../../src/commands/path/notes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAO5D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAe;IAChD,OAAO,uBAAuB,CAAC,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,UAA4B,EAAE;IAC1E,OAAO,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,CAAC;QACX,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvE,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/repo/init.d.ts

@@ -0,0 +1,11 @@
+export interface RepoInitOptions {
+    cwd?: string;
+    yes?: boolean;
+    force?: boolean;
+    id?: string;
+    vault?: string;
+    homeDir?: string;
+}
+export declare function runRepoInit(argv: string[]): Promise<number>;
+export declare function runRepoInitWithOptions(options?: RepoInitOptions): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/repo/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/repo/init.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAQjE;AAED,wBAAsB,sBAAsB,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsE3F"}

package/dist/commands/repo/init.js

@@ -0,0 +1,78 @@
+import { mkdir } from "node:fs/promises";
+import path from "node:path";
+import { findGitRoot } from "../../connector/git.js";
+import { readHomeConfig, withHomeDir } from "../../connector/home.js";
+import { detectProjectId, formatProjectIdSource } from "../../connector/project-id.js";
+import { readRepoConfig, repoConfigPath, writeRepoConfig } from "../../connector/repo.js";
+import { resolveLogsDir, resolveNotesDir, resolveVaultRoot } from "../../connector/vault.js";
+import { flagBool, flagString, parseArgs } from "../../util/parse-args.js";
+import { resolveUserPath } from "../../util/path.js";
+import { confirm } from "../../util/prompt.js";
+export async function runRepoInit(argv) {
+    const { flags } = parseArgs(argv);
+    return runRepoInitWithOptions({
+        yes: flagBool(flags, "yes", "y"),
+        force: flagBool(flags, "force", "f"),
+        id: flagString(flags, "id"),
+        vault: flagString(flags, "vault"),
+    });
+}
+export async function runRepoInitWithOptions(options = {}) {
+    return withHomeDir(options.homeDir, async () => {
+        const cwd = path.resolve(options.cwd ?? process.cwd());
+        const yes = options.yes ?? false;
+        const force = options.force ?? false;
+        const gitRoot = await findGitRoot(cwd);
+        let home = await readHomeConfig();
+        if (!home) {
+            if (!options.vault) {
+                process.stderr.write("No vault configured. Run: grounder vault init <path>\n");
+                return 1;
+            }
+            home = { vaultRoot: resolveUserPath(options.vault) };
+        }
+        const vaultRoot = resolveVaultRoot(home, options.vault);
+        const detected = await detectProjectId(cwd, options.id, gitRoot);
+        const existingRepo = await readRepoConfig(cwd);
+        const projectConfig = { version: 1, projectId: detected.id };
+        const notesDir = resolveNotesDir(home, projectConfig, options.vault);
+        const logsDir = resolveLogsDir(home, projectConfig, options.vault);
+        process.stdout.write(`✓ Folder:   ${cwd}\n`);
+        if (gitRoot) {
+            process.stdout.write(`✓ Git repo: ${gitRoot}\n`);
+        }
+        process.stdout.write(`✓ Vault:    ${vaultRoot}\n`);
+        process.stdout.write(`✓ Project:  ${detected.id} (${formatProjectIdSource(detected.source)})\n\n`);
+        const notesDirRelative = path.relative(vaultRoot, notesDir);
+        const logsDirRelative = path.relative(vaultRoot, logsDir);
+        process.stdout.write("Will create:\n");
+        process.stdout.write(`  link   ${repoConfigPath(cwd)}\n`);
+        process.stdout.write(`  vault  ${notesDirRelative}/\n`);
+        process.stdout.write(`  vault  ${logsDirRelative}/\n`);
+        if (!yes) {
+            const proceed = await confirm("Proceed?");
+            if (!proceed) {
+                process.stdout.write("Aborted.\n");
+                return 0;
+            }
+        }
+        if (existingRepo && !force) {
+            if (existingRepo.projectId === detected.id) {
+                process.stdout.write("✓ Already linked (skipped)\n");
+                await mkdir(notesDir, { recursive: true });
+                await mkdir(logsDir, { recursive: true });
+                return 0;
+            }
+            process.stderr.write(`Folder already linked as ${existingRepo.projectId}. Use --force to overwrite.\n`);
+            return 1;
+        }
+        await writeRepoConfig(cwd, { version: 1, projectId: detected.id });
+        await mkdir(notesDir, { recursive: true });
+        await mkdir(logsDir, { recursive: true });
+        process.stdout.write("✓ Wrote .grounder.json\n");
+        process.stdout.write(`✓ Created notes folder: ${notesDir}\n`);
+        process.stdout.write(`✓ Created logs folder: ${logsDir}\n`);
+        return 0;
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/repo/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/commands/repo/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC7F,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAW/C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAc;IAC9C,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,sBAAsB,CAAC;QAC5B,GAAG,EAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC;QAChC,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC;QACpC,EAAE,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC;QAC3B,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC;KAClC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,UAA2B,EAAE;IACxE,OAAO,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,KAAK,CAAC;QACjC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QAEvC,IAAI,IAAI,GAAG,MAAM,cAAc,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;gBAC/E,OAAO,CAAC,CAAC;YACX,CAAC;YACD,IAAI,GAAG,EAAE,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,CAAC;QAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACjE,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,aAAa,GAAG,EAAE,OAAO,EAAE,CAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;QACtE,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAEnE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;QAC7C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,OAAO,IAAI,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,SAAS,IAAI,CAAC,CAAC;QACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,eAAe,QAAQ,CAAC,EAAE,KAAK,qBAAqB,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAC7E,CAAC;QACF,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC5D,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,gBAAgB,KAAK,CAAC,CAAC;QACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,eAAe,KAAK,CAAC,CAAC;QAEvD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;YAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;gBACnC,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QAED,IAAI,YAAY,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,YAAY,CAAC,SAAS,KAAK,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;gBACrD,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC3C,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC1C,OAAO,CAAC,CAAC;YACX,CAAC;YAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,4BAA4B,YAAY,CAAC,SAAS,+BAA+B,CAClF,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,eAAe,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QACnE,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACjD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,QAAQ,IAAI,CAAC,CAAC;QAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,OAAO,IAAI,CAAC,CAAC;QAC5D,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/require-linked.d.ts

@@ -0,0 +1,7 @@
+import { type LinkedProject } from "../connector/linked.js";
+/**
+ * Resolves the linked project for CLI commands.
+ * Writes the standard stderr hints and returns `null` on failure.
+ */
+export declare function requireLinkedProject(cwd: string): Promise<LinkedProject | null>;
+//# sourceMappingURL=require-linked.d.ts.map

package/dist/commands/require-linked.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-linked.d.ts","sourceRoot":"","sources":["../../src/commands/require-linked.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAwB,MAAM,wBAAwB,CAAC;AAElF;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAWrF"}

package/dist/commands/require-linked.js

@@ -0,0 +1,19 @@
+import { resolveLinkedProject } from "../connector/linked.js";
+/**
+ * Resolves the linked project for CLI commands.
+ * Writes the standard stderr hints and returns `null` on failure.
+ */
+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");
+        }
+        else {
+            process.stderr.write("Folder not linked. Run: grounder init\n");
+        }
+        return null;
+    }
+    return result.value;
+}
+//# sourceMappingURL=require-linked.js.map

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

@@ -0,0 +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"}

package/dist/commands/vault/init.d.ts

@@ -0,0 +1,11 @@
+export interface VaultInitOptions {
+    vaultPath: string;
+    yes?: boolean;
+    force?: 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

package/dist/commands/vault/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/vault/init.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBlE;AAED,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0DxF"}

package/dist/commands/vault/init.js

@@ -0,0 +1,73 @@
+import { mkdir } from "node:fs/promises";
+import { resolveAgents } from "../../agents/index.js";
+import { homeConfigPath, readHomeConfig, withHomeDir, writeHomeConfig, } from "../../connector/home.js";
+import { flagBool, flagStrings, parseArgs } from "../../util/parse-args.js";
+import { resolveUserPath } from "../../util/path.js";
+import { confirm } from "../../util/prompt.js";
+import { projectsParent } from "../../vault/layout.js";
+export async function runVaultInit(argv) {
+    const { positional, flags, repeated } = parseArgs(argv);
+    const vaultPathArg = positional[0];
+    const yes = flagBool(flags, "yes", "y");
+    const force = flagBool(flags, "force", "f");
+    const agents = flagStrings(repeated, "agent");
+    if (!vaultPathArg) {
+        process.stderr.write("Usage: grounder vault init <path>\n");
+        return 1;
+    }
+    return runVaultInitWithOptions({
+        vaultPath: vaultPathArg,
+        yes,
+        force,
+        agents: agents.length > 0 ? agents : undefined,
+    });
+}
+export async function runVaultInitWithOptions(options) {
+    return withHomeDir(options.homeDir, async () => {
+        const vaultRoot = resolveUserPath(options.vaultPath);
+        const yes = options.yes ?? false;
+        const force = options.force ?? false;
+        const homeDir = options.homeDir;
+        const existingHome = await readHomeConfig();
+        const projectsDir = projectsParent(vaultRoot);
+        const agents = await resolveAgents(options.agents);
+        if (existingHome && existingHome.vaultRoot !== vaultRoot && !force) {
+            process.stderr.write(`Home config already exists with vault ${existingHome.vaultRoot}. Use --force to overwrite.\n`);
+            return 1;
+        }
+        process.stdout.write(`Vault root: ${vaultRoot}\n`);
+        process.stdout.write("Will write:\n");
+        process.stdout.write(`  home   ${homeConfigPath(homeDir)}\n`);
+        process.stdout.write("  vault  10-Projects/ (if missing)\n");
+        for (const agent of agents) {
+            process.stdout.write(`  ${agent.id.padEnd(8)} (${agent.name} artifacts)\n`);
+        }
+        if (agents.length === 0) {
+            process.stdout.write("  (no supported agents detected — skipping agent artifacts)\n");
+        }
+        process.stdout.write("\n");
+        if (!yes) {
+            const proceed = await confirm("Proceed?");
+            if (!proceed) {
+                process.stdout.write("Aborted.\n");
+                return 0;
+            }
+        }
+        await writeHomeConfig({ vaultRoot });
+        await mkdir(projectsDir, { recursive: true });
+        process.stdout.write("✓ Wrote home config\n");
+        process.stdout.write(`✓ Vault scaffold: ${projectsDir}\n`);
+        for (const agent of agents) {
+            const result = await agent.install({ force, homeDir });
+            for (const [artifactPath, status] of Object.entries(result.artifacts)) {
+                const label = status === "skipped" ? "already exists (skipped)" : `installed: ${artifactPath}`;
+                process.stdout.write(`✓ ${agent.name} command ${label}\n`);
+            }
+            if (Object.keys(result.artifacts).length === 0) {
+                process.stdout.write(`✓ ${agent.name}: no artifacts to install yet\n`);
+            }
+        }
+        return 0;
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/vault/init.js.map

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

package/dist/connector/git.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Walks upward from `startDir` looking for a `.git` entry.
+ * @returns Absolute git root, or `null` if none is found.
+ */
+export declare function findGitRoot(startDir: string): Promise<string | null>;
+/**
+ * Best-effort branch name via `git rev-parse --abbrev-ref HEAD`.
+ * @returns Branch name, or `undefined` if git fails / output is empty
+ *   / detached HEAD (`abbrev-ref` prints `HEAD`), etc.
+ */
+export declare function currentBranch(gitRoot: string): Promise<string | undefined>;
+//# sourceMappingURL=git.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/connector/git.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAc1E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAchF"}

package/dist/connector/git.js

@@ -0,0 +1,53 @@
+import { execFile } from "node:child_process";
+import { access } from "node:fs/promises";
+import path from "node:path";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+async function isGitRoot(dir) {
+    try {
+        await access(path.join(dir, ".git"));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Walks upward from `startDir` looking for a `.git` entry.
+ * @returns Absolute git root, or `null` if none is found.
+ */
+export async function findGitRoot(startDir) {
+    let current = path.resolve(startDir);
+    while (true) {
+        if (await isGitRoot(current)) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+/**
+ * Best-effort branch name via `git rev-parse --abbrev-ref HEAD`.
+ * @returns Branch name, or `undefined` if git fails / output is empty
+ *   / detached HEAD (`abbrev-ref` prints `HEAD`), etc.
+ */
+export async function currentBranch(gitRoot) {
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
+            cwd: gitRoot,
+            encoding: "utf8",
+        });
+        const branch = String(stdout).trim();
+        if (!branch || branch === "HEAD") {
+            return undefined;
+        }
+        return branch;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/connector/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/connector/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,KAAK,UAAU,SAAS,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAErC,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,MAAM,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE;YACnF,GAAG,EAAE,OAAO;YACZ,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACjC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/connector/home.d.ts

@@ -0,0 +1,13 @@
+export interface HomeConfig {
+    vaultRoot: string;
+}
+export declare function resolveHomeDir(override?: string): string;
+export declare function homeConfigPath(homeDir?: string): string;
+/**
+ * Runs `fn` with home config resolved under `homeDir` (for tests/sandboxing).
+ * Sets `GROUNDER_HOME` for the call, then restores it. No-op if `homeDir` is unset.
+ */
+export declare function withHomeDir<T>(homeDir: string | undefined, fn: () => Promise<T>): Promise<T>;
+export declare function readHomeConfig(): Promise<HomeConfig | null>;
+export declare function writeHomeConfig(config: HomeConfig): Promise<void>;
+//# sourceMappingURL=home.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"home.d.ts","sourceRoot":"","sources":["../../src/connector/home.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAgBZ;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAYjE;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE"}

package/dist/connector/home.js

@@ -0,0 +1,52 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileExists } from "../util/fs.js";
+export function resolveHomeDir(override) {
+    if (override) {
+        return override;
+    }
+    return process.env.GROUNDER_HOME ?? os.homedir();
+}
+export function homeConfigPath(homeDir) {
+    return path.join(resolveHomeDir(homeDir), ".grounder", "config.json");
+}
+/**
+ * Runs `fn` with home config resolved under `homeDir` (for tests/sandboxing).
+ * Sets `GROUNDER_HOME` for the call, then restores it. No-op if `homeDir` is unset.
+ */
+export async function withHomeDir(homeDir, fn) {
+    if (!homeDir) {
+        return fn();
+    }
+    const previous = process.env.GROUNDER_HOME;
+    process.env.GROUNDER_HOME = homeDir;
+    try {
+        return await fn();
+    }
+    finally {
+        if (previous === undefined) {
+            delete process.env.GROUNDER_HOME;
+        }
+        else {
+            process.env.GROUNDER_HOME = previous;
+        }
+    }
+}
+export async function readHomeConfig() {
+    const configPath = homeConfigPath();
+    if (!(await fileExists(configPath))) {
+        return null;
+    }
+    const raw = JSON.parse(await readFile(configPath, "utf8"));
+    if (typeof raw.vaultRoot !== "string" || raw.vaultRoot.length === 0) {
+        throw new Error(`Invalid home config at ${configPath}: missing vaultRoot`);
+    }
+    return { vaultRoot: raw.vaultRoot };
+}
+export async function writeHomeConfig(config) {
+    const configPath = homeConfigPath();
+    await mkdir(path.dirname(configPath), { recursive: true });
+    await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+}
+//# sourceMappingURL=home.js.map

package/dist/connector/home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home.js","sourceRoot":"","sources":["../../src/connector/home.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAM3C,MAAM,UAAU,cAAc,CAAC,QAAiB;IAC9C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAA2B,EAC3B,EAAoB;IAEpB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,OAAO,CAAC;IACpC,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,QAAQ,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IACpC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAwB,CAAC;IAClF,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,0BAA0B,UAAU,qBAAqB,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAkB;IACtD,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IACpC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,SAAS,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9E,CAAC"}

package/dist/connector/linked.d.ts

@@ -0,0 +1,25 @@
+import { type HomeConfig } from "./home.js";
+import { type RepoConfig } from "./repo.js";
+/** Home config + linked repo marker resolved from a cwd. */
+export interface LinkedProject {
+    home: HomeConfig;
+    repo: RepoConfig;
+    /** Directory that contains `.grounder.json`. */
+    linkedRoot: string;
+    /** Nearest git root when present. */
+    gitRoot: string | null;
+}
+export type LinkedProjectError = "no-vault" | "not-linked";
+export type ResolveLinkedProjectResult = {
+    ok: true;
+    value: LinkedProject;
+} | {
+    ok: false;
+    error: LinkedProjectError;
+};
+/**
+ * Resolves home vault config and the linked project marker for `cwd`.
+ * Does not write to stderr — callers map {@link LinkedProjectError} to UX.
+ */
+export declare function resolveLinkedProject(cwd: string): Promise<ResolveLinkedProjectResult>;
+//# sourceMappingURL=linked.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linked.d.ts","sourceRoot":"","sources":["../../src/connector/linked.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAkB,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAsB,KAAK,UAAU,EAAkB,MAAM,WAAW,CAAC;AAEhF,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,YAAY,CAAC;AAE3D,MAAM,MAAM,0BAA0B,GAClC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAClC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAE7C;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAkB3F"}

package/dist/connector/linked.js

@@ -0,0 +1,24 @@
+import { findGitRoot } from "./git.js";
+import { readHomeConfig } from "./home.js";
+import { findLinkedRepoRoot, readRepoConfig } from "./repo.js";
+/**
+ * Resolves home vault config and the linked project marker for `cwd`.
+ * Does not write to stderr — callers map {@link LinkedProjectError} to UX.
+ */
+export async function resolveLinkedProject(cwd) {
+    const home = await readHomeConfig();
+    if (!home) {
+        return { ok: false, error: "no-vault" };
+    }
+    const gitRoot = await findGitRoot(cwd);
+    const linkedRoot = await findLinkedRepoRoot(cwd, gitRoot);
+    if (!linkedRoot) {
+        return { ok: false, error: "not-linked" };
+    }
+    const repo = await readRepoConfig(linkedRoot);
+    if (!repo) {
+        return { ok: false, error: "not-linked" };
+    }
+    return { ok: true, value: { home, repo, linkedRoot, gitRoot } };
+}
+//# sourceMappingURL=linked.js.map