grounder 0.0.1 → 0.0.2

package/dist/connector/linked.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked.js","sourceRoot":"","sources":["../../src/connector/linked.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAmB,cAAc,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAmB,cAAc,EAAE,MAAM,WAAW,CAAC;AAkBhF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAW;IACpD,MAAM,IAAI,GAAG,MAAM,cAAc,EAAE,CAAC;IACpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;AAClE,CAAC"}

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

@@ -0,0 +1,17 @@
+export type ProjectIdSource = "flag" | "package.json" | "git-remote" | "basename";
+export interface DetectedProjectId {
+    id: string;
+    source: ProjectIdSource;
+}
+/**
+ * Detects the project id for a given link root.
+ * Tries to detect it from the package.json, git remote, and folder name.
+ *
+ * @param linkRoot - The root directory of the link.
+ * @param override - An optional project id to use instead of detecting one.
+ * @param gitRoot - An optional git root to use instead of detecting one.
+ * @returns The detected project id.
+ */
+export declare function detectProjectId(linkRoot: string, override?: string, gitRoot?: string | null): Promise<DetectedProjectId>;
+export declare function formatProjectIdSource(source: ProjectIdSource): string;
+//# sourceMappingURL=project-id.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-id.d.ts","sourceRoot":"","sources":["../../src/connector/project-id.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,cAAc,GAAG,YAAY,GAAG,UAAU,CAAC;AAElF,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,eAAe,CAAC;CACzB;AAkDD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAmC5B;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAWrE"}

package/dist/connector/project-id.js

@@ -0,0 +1,102 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { sanitizeProjectId } from "../util/project-id.js";
+async function readPackageName(repoRoot) {
+    const packagePath = path.join(repoRoot, "package.json");
+    try {
+        const raw = JSON.parse(await readFile(packagePath, "utf8"));
+        return typeof raw.name === "string" && raw.name.length > 0 ? raw.name : null;
+    }
+    catch {
+        return null;
+    }
+}
+function parseRemoteSlug(url) {
+    const trimmed = url.trim();
+    const scpMatch = /^[^@]+@[^:]+:(.+)$/.exec(trimmed);
+    const rawPath = scpMatch ? scpMatch[1] : trimmed.replace(/^[^:]+:\/\//, "");
+    const lastSegment = rawPath.split("/").filter(Boolean).pop();
+    if (!lastSegment) {
+        return null;
+    }
+    return lastSegment.replace(/\.git$/i, "");
+}
+async function readGitRemoteSlug(repoRoot) {
+    const configPath = path.join(repoRoot, ".git", "config");
+    try {
+        const contents = await readFile(configPath, "utf8");
+        const lines = contents.split("\n");
+        let inOrigin = false;
+        for (const line of lines) {
+            const section = /^\[remote "(.+)"\]$/.exec(line.trim());
+            if (section) {
+                inOrigin = section[1] === "origin";
+                continue;
+            }
+            if (inOrigin) {
+                const urlMatch = /^\s*url\s*=\s*(.+)$/.exec(line);
+                if (urlMatch) {
+                    return parseRemoteSlug(urlMatch[1]);
+                }
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+/**
+ * Detects the project id for a given link root.
+ * Tries to detect it from the package.json, git remote, and folder name.
+ *
+ * @param linkRoot - The root directory of the link.
+ * @param override - An optional project id to use instead of detecting one.
+ * @param gitRoot - An optional git root to use instead of detecting one.
+ * @returns The detected project id.
+ */
+export async function detectProjectId(linkRoot, override, gitRoot) {
+    if (override) {
+        const id = sanitizeProjectId(override);
+        if (!id) {
+            throw new Error(`Invalid project id: ${override}`);
+        }
+        return { id, source: "flag" };
+    }
+    const packageName = await readPackageName(linkRoot);
+    if (packageName) {
+        const id = sanitizeProjectId(packageName);
+        if (id) {
+            return { id, source: "package.json" };
+        }
+    }
+    if (gitRoot !== null) {
+        const remoteRoot = gitRoot ?? linkRoot;
+        const remoteSlug = await readGitRemoteSlug(remoteRoot);
+        if (remoteSlug) {
+            const id = sanitizeProjectId(remoteSlug);
+            if (id) {
+                return { id, source: "git-remote" };
+            }
+        }
+    }
+    const basename = path.basename(linkRoot);
+    const id = sanitizeProjectId(basename);
+    if (!id) {
+        throw new Error("Could not detect a valid project id");
+    }
+    return { id, source: "basename" };
+}
+export function formatProjectIdSource(source) {
+    switch (source) {
+        case "flag":
+            return "from --id";
+        case "package.json":
+            return "from package.json";
+        case "git-remote":
+            return "from git remote";
+        case "basename":
+            return "from folder name";
+    }
+}
+//# sourceMappingURL=project-id.js.map

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

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

package/dist/connector/repo.d.ts

@@ -0,0 +1,9 @@
+export interface RepoConfig {
+    version: 1;
+    projectId: string;
+}
+export declare function repoConfigPath(repoRoot: string): string;
+export declare function findLinkedRepoRoot(cwd: string, gitRoot?: string | null): Promise<string | null>;
+export declare function readRepoConfig(repoRoot: string): Promise<RepoConfig | null>;
+export declare function writeRepoConfig(repoRoot: string, config: RepoConfig): Promise<void>;
+//# sourceMappingURL=repo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/connector/repo.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAM,GAAG,IAAW,GAC5B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmBxB;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAYjF;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzF"}

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"}