grounder 0.0.1 → 0.1.0

package/dist/connector/repo.js

@@ -0,0 +1,41 @@
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileExists } from "../util/fs.js";
+const REPO_MARKER_FILE = ".grounder.json";
+export function repoConfigPath(repoRoot) {
+    return path.join(repoRoot, REPO_MARKER_FILE);
+}
+export async function findLinkedRepoRoot(cwd, gitRoot = null) {
+    let current = path.resolve(cwd);
+    const stopAtGitRoot = gitRoot ? path.resolve(gitRoot) : null;
+    while (true) {
+        if (await fileExists(repoConfigPath(current))) {
+            return current;
+        }
+        if (stopAtGitRoot && current === stopAtGitRoot) {
+            break;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    return null;
+}
+export async function readRepoConfig(repoRoot) {
+    const configPath = repoConfigPath(repoRoot);
+    if (!(await fileExists(configPath))) {
+        return null;
+    }
+    const raw = JSON.parse(await readFile(configPath, "utf8"));
+    if (raw.version !== 1 || typeof raw.projectId !== "string" || raw.projectId.length === 0) {
+        throw new Error(`Invalid repo config at ${configPath}`);
+    }
+    return { version: 1, projectId: raw.projectId };
+}
+export async function writeRepoConfig(repoRoot, config) {
+    const configPath = repoConfigPath(repoRoot);
+    await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+}
+//# sourceMappingURL=repo.js.map

package/dist/connector/repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.js","sourceRoot":"","sources":["../../src/connector/repo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAO3C,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAE1C,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAW,EACX,UAAyB,IAAI;IAE7B,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE7D,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,MAAM,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,aAAa,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;YAC/C,MAAM;QACR,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,MAAM;QACR,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,MAAM,UAAU,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC5C,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,GAAG,CAAC,OAAO,KAAK,CAAC,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzF,MAAM,IAAI,KAAK,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,MAAkB;IACxE,MAAM,UAAU,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC5C,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/vault.d.ts

@@ -0,0 +1,12 @@
+import type { HomeConfig } from "./home.js";
+import type { RepoConfig } from "./repo.js";
+/**
+ * Effective vault root, in order: explicit `override`, `GROUNDER_VAULT`, then home config.
+ * Expands a leading `~` so vault paths like `~/Documents/…` resolve to the user home.
+ */
+export declare function resolveVaultRoot(home: HomeConfig, override?: string): string;
+/** Project notes directory under the effective vault root. */
+export declare function resolveNotesDir(home: HomeConfig, repo: RepoConfig, vaultOverride?: string): string;
+/** Project logs (handoff) directory under the effective vault root. */
+export declare function resolveLogsDir(home: HomeConfig, repo: RepoConfig, vaultOverride?: string): string;
+//# sourceMappingURL=vault.d.ts.map

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

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

package/dist/connector/vault.js

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

package/dist/connector/vault.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION: string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,OAAO,QAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const pkg = JSON.parse(readFileSync(path.join(pkgRoot, "package.json"), "utf8"));
+export const VERSION = pkg.version;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACjF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAE9E,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC"}

package/dist/util/fs.d.ts

@@ -0,0 +1,8 @@
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Creates a new markdown file under `dir`; never overwrites.
+ * Tries `basename.md`, then `basename_02.md`, `_03`, … with `wx` (O_EXCL)
+ * so concurrent writers cannot clobber each other.
+ */
+export declare function writeUniqueMarkdown(dir: string, basename: string, content: string): Promise<string>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/util/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/util/fs.ts"],"names":[],"mappings":"AAIA,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAgBjB"}

package/dist/util/fs.js

@@ -0,0 +1,36 @@
+import { access, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { collisionSuffix } from "./timestamp-slug.js";
+export async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Creates a new markdown file under `dir`; never overwrites.
+ * Tries `basename.md`, then `basename_02.md`, `_03`, … with `wx` (O_EXCL)
+ * so concurrent writers cannot clobber each other.
+ */
+export async function writeUniqueMarkdown(dir, basename, content) {
+    let n = 0;
+    for (;;) {
+        const stem = n === 0 ? basename : `${basename}${collisionSuffix(n)}`;
+        const filePath = path.join(dir, `${stem}.md`);
+        try {
+            await writeFile(filePath, content, { encoding: "utf8", flag: "wx" });
+            return filePath;
+        }
+        catch (error) {
+            if (error.code === "EEXIST") {
+                n = n === 0 ? 2 : n + 1;
+                continue;
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/util/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/util/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAW,EACX,QAAgB,EAChB,OAAe;IAEf,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACrE,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBACxB,SAAS;YACX,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/util/parse-args.d.ts

@@ -0,0 +1,12 @@
+export interface ParsedArgs {
+    positional: string[];
+    flags: Map<string, string | boolean>;
+    /** Raw repeated flag values, e.g. --agent=cursor --agent=claude → ["cursor","claude"] */
+    repeated: Map<string, string[]>;
+}
+export declare function parseArgs(argv: string[]): ParsedArgs;
+export declare function flagBool(flags: Map<string, string | boolean>, ...keys: string[]): boolean;
+export declare function flagString(flags: Map<string, string | boolean>, key: string): string | undefined;
+/** Collect all values from a repeated flag, e.g. --agent cursor --agent claude → ["cursor","claude"]. */
+export declare function flagStrings(repeated: Map<string, string[]>, key: string): string[];
+//# sourceMappingURL=parse-args.d.ts.map

package/dist/util/parse-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.d.ts","sourceRoot":"","sources":["../../src/util/parse-args.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACrC,yFAAyF;IACzF,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACjC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA6BpD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAQzF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGhG;AAED,yGAAyG;AACzG,wBAAgB,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAElF"}

package/dist/util/parse-args.js

@@ -0,0 +1,49 @@
+export function parseArgs(argv) {
+    const positional = [];
+    const flags = new Map();
+    const repeated = new Map();
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith("--")) {
+            const key = arg.slice(2);
+            const next = argv[i + 1];
+            if (next !== undefined && !next.startsWith("-")) {
+                flags.set(key, next);
+                const arr = repeated.get(key) ?? [];
+                arr.push(next);
+                repeated.set(key, arr);
+                i++;
+            }
+            else {
+                flags.set(key, true);
+            }
+        }
+        else if (arg.startsWith("-") && arg.length > 1) {
+            for (const char of arg.slice(1)) {
+                flags.set(char, true);
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { positional, flags, repeated };
+}
+export function flagBool(flags, ...keys) {
+    for (const key of keys) {
+        const value = flags.get(key);
+        if (value === true || value === "true") {
+            return true;
+        }
+    }
+    return false;
+}
+export function flagString(flags, key) {
+    const value = flags.get(key);
+    return typeof value === "string" ? value : undefined;
+}
+/** Collect all values from a repeated flag, e.g. --agent cursor --agent claude → ["cursor","claude"]. */
+export function flagStrings(repeated, key) {
+    return repeated.get(key) ?? [];
+}
+//# sourceMappingURL=parse-args.js.map

package/dist/util/parse-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.js","sourceRoot":"","sources":["../../src/util/parse-args.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzB,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACrB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBACpC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACf,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBACvB,CAAC,EAAE,CAAC;YACN,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjD,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAoC,EAAE,GAAG,IAAc;IAC9E,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAoC,EAAE,GAAW;IAC1E,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,WAAW,CAAC,QAA+B,EAAE,GAAW;IACtE,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC"}

package/dist/util/path.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Expand a leading `~` / `~/…` to the user home directory.
+ * Leaves other paths unchanged (including a mid-path `~`, which is not home).
+ */
+export declare function expandHome(input: string): string;
+/**
+ * Expand a leading `~`, then resolve to an absolute path (relative to `cwd` if given).
+ */
+export declare function resolveUserPath(input: string, cwd?: string): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/util/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/util/path.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CAElF"}

package/dist/util/path.js

@@ -0,0 +1,22 @@
+import os from "node:os";
+import path from "node:path";
+/**
+ * Expand a leading `~` / `~/…` to the user home directory.
+ * Leaves other paths unchanged (including a mid-path `~`, which is not home).
+ */
+export function expandHome(input) {
+    if (input === "~") {
+        return os.homedir();
+    }
+    if (input.startsWith("~/") || input.startsWith(`~${path.sep}`)) {
+        return path.join(os.homedir(), input.slice(2));
+    }
+    return input;
+}
+/**
+ * Expand a leading `~`, then resolve to an absolute path (relative to `cwd` if given).
+ */
+export function resolveUserPath(input, cwd = process.cwd()) {
+    return path.resolve(cwd, expandHome(input));
+}
+//# sourceMappingURL=path.js.map

package/dist/util/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/util/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;IACtB,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IACxE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/util/project-id.d.ts

@@ -0,0 +1,2 @@
+export declare function sanitizeProjectId(value: string): string;
+//# sourceMappingURL=project-id.d.ts.map

package/dist/util/project-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-id.d.ts","sourceRoot":"","sources":["../../src/util/project-id.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMvD"}

package/dist/util/project-id.js

@@ -0,0 +1,8 @@
+export function sanitizeProjectId(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .replace(/-{2,}/g, "-");
+}
+//# sourceMappingURL=project-id.js.map

package/dist/util/project-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-id.js","sourceRoot":"","sources":["../../src/util/project-id.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AAC5B,CAAC"}

package/dist/util/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare function confirm(message: string, defaultYes?: boolean): Promise<boolean>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/util/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/util/prompt.ts"],"names":[],"mappings":"AAEA,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBlF"}

package/dist/util/prompt.js

@@ -0,0 +1,19 @@
+import readline from "node:readline/promises";
+export async function confirm(message, defaultYes = true) {
+    const hint = defaultYes ? "[Y/n]" : "[y/N]";
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    try {
+        const answer = (await rl.question(`${message} ${hint} `)).trim().toLowerCase();
+        if (answer === "") {
+            return defaultYes;
+        }
+        return answer === "y" || answer === "yes";
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=prompt.js.map

package/dist/util/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/util/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,wBAAwB,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAe,EAAE,UAAU,GAAG,IAAI;IAC9D,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5C,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,OAAO,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC/E,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;YAClB,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,KAAK,CAAC;IAC5C,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/util/timestamp-slug.d.ts

@@ -0,0 +1,38 @@
+export declare const MAX_SLUG_LENGTH = 20;
+/**
+ * Builds a short filesystem-safe slug from text.
+ * Uses only the first line, truncated to {@link MAX_SLUG_LENGTH}.
+ */
+export declare function slugifyText(text: string): string;
+/** Local-time prefix `YYYY-MM-DD-HHmm` (legacy minute precision). */
+export declare function dateMinutePrefix(date: Date): string;
+/** Local-time prefix `YYYY-MM-DD-HHmmss` for sortable filenames. */
+export declare function dateSecondPrefix(date: Date): string;
+/**
+ * @deprecated Prefer {@link dateSecondPrefix} (hyphenated date + time).
+ * Legacy `YYYY-MM-DD-HH-mm-ss` form.
+ */
+export declare function timestampSlug(date?: Date): string;
+/**
+ * Filename stem: `YYYY-MM-DD-HHmmss` plus optional slug from `title`, else from `text`.
+ * Returns the date prefix alone when the slug is empty.
+ */
+export declare function timestampedBasename(text: string, options?: {
+    title?: string;
+    now?: Date;
+}): string;
+/**
+ * @deprecated Alias of {@link timestampedBasename} (always second precision).
+ */
+export declare function timestampedBasenameWithSeconds(text: string, options?: {
+    title?: string;
+    now?: Date;
+}): string;
+/**
+ * Numeric collision suffix for a basename that already exists.
+ * Uses `_` so `base_02.md` sorts after `base.md` lexicographically
+ * (`_` > `.`), keeping filename-desc “newest first” correct.
+ * Zero-padded to 2 digits so `_02` < `_10`.
+ */
+export declare function collisionSuffix(n: number): string;
+//# sourceMappingURL=timestamp-slug.d.ts.map

package/dist/util/timestamp-slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp-slug.d.ts","sourceRoot":"","sources":["../../src/util/timestamp-slug.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,KAAK,CAAC;AAIlC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD;AAUD,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEnD;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,OAAa,GAAG,MAAM,CASvD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAA;CAAO,GAC3C,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAA;CAAO,GAC3C,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/util/timestamp-slug.js

@@ -0,0 +1,66 @@
+import { sanitizeProjectId } from "./project-id.js";
+export const MAX_SLUG_LENGTH = 20;
+const pad = (n) => String(n).padStart(2, "0");
+/**
+ * Builds a short filesystem-safe slug from text.
+ * Uses only the first line, truncated to {@link MAX_SLUG_LENGTH}.
+ */
+export function slugifyText(text) {
+    const firstLine = text.trim().split(/\r?\n/)[0] ?? "";
+    return sanitizeProjectId(firstLine.trim().slice(0, MAX_SLUG_LENGTH));
+}
+function datePrefix(date, includeSeconds) {
+    const y = date.getFullYear();
+    const m = pad(date.getMonth() + 1);
+    const d = pad(date.getDate());
+    const time = `${pad(date.getHours())}${pad(date.getMinutes())}${includeSeconds ? pad(date.getSeconds()) : ""}`;
+    return `${y}-${m}-${d}-${time}`;
+}
+/** Local-time prefix `YYYY-MM-DD-HHmm` (legacy minute precision). */
+export function dateMinutePrefix(date) {
+    return datePrefix(date, false);
+}
+/** Local-time prefix `YYYY-MM-DD-HHmmss` for sortable filenames. */
+export function dateSecondPrefix(date) {
+    return datePrefix(date, true);
+}
+/**
+ * @deprecated Prefer {@link dateSecondPrefix} (hyphenated date + time).
+ * Legacy `YYYY-MM-DD-HH-mm-ss` form.
+ */
+export function timestampSlug(date = new Date()) {
+    return [
+        date.getFullYear(),
+        pad(date.getMonth() + 1),
+        pad(date.getDate()),
+        pad(date.getHours()),
+        pad(date.getMinutes()),
+        pad(date.getSeconds()),
+    ].join("-");
+}
+/**
+ * Filename stem: `YYYY-MM-DD-HHmmss` plus optional slug from `title`, else from `text`.
+ * Returns the date prefix alone when the slug is empty.
+ */
+export function timestampedBasename(text, options = {}) {
+    const now = options.now ?? new Date();
+    const shortSlug = options.title ? slugifyText(options.title) : slugifyText(text);
+    const prefix = dateSecondPrefix(now);
+    return shortSlug ? `${prefix}-${shortSlug}` : prefix;
+}
+/**
+ * @deprecated Alias of {@link timestampedBasename} (always second precision).
+ */
+export function timestampedBasenameWithSeconds(text, options = {}) {
+    return timestampedBasename(text, options);
+}
+/**
+ * Numeric collision suffix for a basename that already exists.
+ * Uses `_` so `base_02.md` sorts after `base.md` lexicographically
+ * (`_` > `.`), keeping filename-desc “newest first” correct.
+ * Zero-padded to 2 digits so `_02` < `_10`.
+ */
+export function collisionSuffix(n) {
+    return `_${String(n).padStart(2, "0")}`;
+}
+//# sourceMappingURL=timestamp-slug.js.map

package/dist/util/timestamp-slug.js.map

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

package/dist/util/yaml.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Double-quote a YAML scalar and escape `\`, `"`, and newlines.
+ * Always quoted so values with `:`, `#`, leading spaces, etc. stay valid.
+ */
+export declare function yamlDoubleQuoted(value: string): string;
+//# sourceMappingURL=yaml.d.ts.map

package/dist/util/yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../src/util/yaml.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOtD"}

package/dist/util/yaml.js

@@ -0,0 +1,13 @@
+/**
+ * Double-quote a YAML scalar and escape `\`, `"`, and newlines.
+ * Always quoted so values with `:`, `#`, leading spaces, etc. stay valid.
+ */
+export function yamlDoubleQuoted(value) {
+    const escaped = value
+        .replace(/\\/g, "\\\\")
+        .replace(/"/g, '\\"')
+        .replace(/\r/g, "\\r")
+        .replace(/\n/g, "\\n");
+    return `"${escaped}"`;
+}
+//# sourceMappingURL=yaml.js.map

package/dist/util/yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../src/util/yaml.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,OAAO,GAAG,KAAK;SAClB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACzB,OAAO,IAAI,OAAO,GAAG,CAAC;AACxB,CAAC"}

package/dist/vault/layout.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Pure vault layout: path segments only — no config files or env overrides.
+ */
+export declare const PROJECTS_DIR = "10-Projects";
+/** `<vault>/10-Projects` — parent of all project folders. */
+export declare function projectsParent(vaultRoot: string): string;
+/** `<vault>/10-Projects/{projectId}`. */
+export declare function projectDir(vaultRoot: string, projectId: string): string;
+/** `<vault>/10-Projects/{projectId}/notes`. */
+export declare function notesDir(vaultRoot: string, projectId: string): string;
+/** `<vault>/10-Projects/{projectId}/logs` — session handoffs. */
+export declare function logsDir(vaultRoot: string, projectId: string): string;
+//# sourceMappingURL=layout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/vault/layout.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,eAAO,MAAM,YAAY,gBAAgB,CAAC;AAE1C,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,yCAAyC;AACzC,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,+CAA+C;AAC/C,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,iEAAiE;AACjE,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpE"}

package/dist/vault/layout.js

@@ -0,0 +1,22 @@
+/**
+ * Pure vault layout: path segments only — no config files or env overrides.
+ */
+import path from "node:path";
+export const PROJECTS_DIR = "10-Projects";
+/** `<vault>/10-Projects` — parent of all project folders. */
+export function projectsParent(vaultRoot) {
+    return path.join(vaultRoot, PROJECTS_DIR);
+}
+/** `<vault>/10-Projects/{projectId}`. */
+export function projectDir(vaultRoot, projectId) {
+    return path.join(vaultRoot, PROJECTS_DIR, projectId);
+}
+/** `<vault>/10-Projects/{projectId}/notes`. */
+export function notesDir(vaultRoot, projectId) {
+    return path.join(vaultRoot, PROJECTS_DIR, projectId, "notes");
+}
+/** `<vault>/10-Projects/{projectId}/logs` — session handoffs. */
+export function logsDir(vaultRoot, projectId) {
+    return path.join(vaultRoot, PROJECTS_DIR, projectId, "logs");
+}
+//# sourceMappingURL=layout.js.map

package/dist/vault/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/vault/layout.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;AAE1C,6DAA6D;AAC7D,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAC5C,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,UAAU,CAAC,SAAiB,EAAE,SAAiB;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;AACvD,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,QAAQ,CAAC,SAAiB,EAAE,SAAiB;IAC3D,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,OAAO,CAAC,SAAiB,EAAE,SAAiB;IAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC"}

package/dist/vault/list-handoffs.d.ts

@@ -0,0 +1,10 @@
+export interface ListHandoffsOptions {
+    /** Max paths to return (newest first). Omit to return all. */
+    limit?: number;
+}
+/**
+ * Lists handoff markdown files under `logsDir`, newest filename first.
+ * Returns absolute paths. Missing or empty dirs yield `[]`.
+ */
+export declare function listHandoffs(logsDir: string, options?: ListHandoffsOptions): Promise<string[]>;
+//# sourceMappingURL=list-handoffs.d.ts.map

package/dist/vault/list-handoffs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-handoffs.d.ts","sourceRoot":"","sources":["../../src/vault/list-handoffs.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBnB"}

package/dist/vault/list-handoffs.js

@@ -0,0 +1,30 @@
+import { readdir } from "node:fs/promises";
+import path from "node:path";
+/**
+ * Lists handoff markdown files under `logsDir`, newest filename first.
+ * Returns absolute paths. Missing or empty dirs yield `[]`.
+ */
+export async function listHandoffs(logsDir, options = {}) {
+    let entries;
+    try {
+        entries = await readdir(logsDir);
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return [];
+        }
+        throw error;
+    }
+    const paths = entries
+        .filter((name) => name.endsWith(".md"))
+        .sort((a, b) => (a < b ? 1 : a > b ? -1 : 0))
+        .map((name) => path.join(logsDir, name));
+    if (options.limit === undefined) {
+        return paths;
+    }
+    if (options.limit <= 0) {
+        return [];
+    }
+    return paths.slice(0, options.limit);
+}
+//# sourceMappingURL=list-handoffs.js.map

package/dist/vault/list-handoffs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-handoffs.js","sourceRoot":"","sources":["../../src/vault/list-handoffs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,UAA+B,EAAE;IAEjC,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,OAAO;SAClB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SACtC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAC5C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAE3C,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/vault/write-handoff.d.ts

@@ -0,0 +1,21 @@
+/** Options for {@link writeHandoff}. */
+export interface WriteHandoffOptions {
+    /** Project id written into YAML frontmatter. */
+    projectId: string;
+    /** Optional title slug for the filename and frontmatter. */
+    title?: string;
+    /** Git branch when known; omitted from frontmatter if unset. */
+    branch?: string;
+    /** Timestamp for filename prefix and `created` (default: now). */
+    now?: Date;
+}
+/**
+ * Writes a new handoff markdown file under `logsDir` (created if missing).
+ * Prepends YAML frontmatter (`project`, optional `branch`/`title`, `created`)
+ * ahead of `body`. Never overwrites — exclusive create with `_NN` on collision.
+ * @param logsDir - Absolute project logs directory.
+ * @param body - Agent-supplied markdown (sections such as Done / Next); not validated here.
+ * @returns Absolute path of the written file.
+ */
+export declare function writeHandoff(logsDir: string, body: string, options: WriteHandoffOptions): Promise<string>;
+//# sourceMappingURL=write-handoff.d.ts.map

package/dist/vault/write-handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-handoff.d.ts","sourceRoot":"","sources":["../../src/vault/write-handoff.ts"],"names":[],"mappings":"AAKA,wCAAwC;AACxC,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAoBD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAiBjB"}