@creator-notes/cnotes 0.16.11

package/dist/lib/install-hook.js

@@ -0,0 +1,168 @@
+/**
+ * Install a Claude Code SessionStart hook that captures the session id.
+ *
+ * The hook runs `cnotes claude-hook` at session start, which writes the current
+ * session id to a file (see lib/claude-session.ts). `cnotes operations begin` then
+ * stamps it on the operation row, so an agent run on the timeline can be traced
+ * back to — and resumed from — the conversation that produced it.
+ *
+ * Target: the USER-GLOBAL ~/.claude/settings.json (so capture works in every
+ * repo, not just one). We preserve all existing settings + other hooks, back up
+ * the file before writing, and are idempotent (a second install is a no-op).
+ *
+ * Unlike the MCP installer, a parse failure here ABORTS rather than starting
+ * fresh: settings.json holds the user's entire Claude Code config, so silently
+ * overwriting it would be destructive.
+ */
+import { readFileSync, writeFileSync, renameSync, mkdirSync, existsSync, copyFileSync, } from "fs";
+import { dirname, resolve } from "path";
+import { homedir } from "os";
+/** The user-global Claude Code settings file. */
+export const CLAUDE_SETTINGS_PATH = resolve(homedir(), ".claude", "settings.json");
+/** The command the hook runs when `cnotes` is on PATH (a global install). */
+export const SESSION_HOOK_COMMAND = "cnotes claude-hook";
+/**
+ * Fallback command for when `cnotes` won't be on PATH — e.g. the user ran
+ * `npx @creator-notes/cnotes init` without installing globally. Resolving the hook
+ * through npx keeps it working instead of failing `command not found` on every
+ * session start. Costs npx resolution latency per session, so we only use it
+ * when `cnotes` genuinely isn't available. `npx cnotes` does NOT resolve (the published
+ * package is @creator-notes/cnotes); detection tolerates this form for idempotency.
+ */
+export const SESSION_HOOK_COMMAND_NPX = "npx @creator-notes/cnotes claude-hook";
+/**
+ * A plain JSON object — the only shape a Claude Code settings.json can validly
+ * take. Arrays, `null`, and primitives parse as valid JSON but aren't a config
+ * we can safely merge into, so callers treat them like a parse failure rather
+ * than silently clobbering the file. Exported for direct unit testing.
+ */
+export function isPlainSettingsObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Identify our entry by the `claude-hook` command (tolerates both the `cnotes` and
+ * `npx …` forms). Exported for direct unit testing.
+ */
+export function groupHasSessionHook(group) {
+    return (Array.isArray(group.hooks) &&
+        group.hooks.some((h) => typeof h.command === "string" && h.command.includes("claude-hook")));
+}
+/** True when any SessionStart group already carries our hook. Exported for tests. */
+export function settingsHaveSessionHook(settings) {
+    const groups = settings.hooks?.SessionStart;
+    return Array.isArray(groups) && groups.some(groupHasSessionHook);
+}
+/**
+ * Rewrite any SessionStart hook that targets our `claude-hook` subcommand but
+ * isn't the command we're installing — e.g. a pre-rename `cn claude-hook` entry
+ * left dead once the `cn` binary was dropped — to `command`, in place. Returns
+ * true if anything changed. Exported for direct unit testing.
+ */
+export function upgradeStaleSessionHooks(settings, command) {
+    // Both shipped forms are valid and must be left alone — only a foreign
+    // claude-hook command (e.g. the dropped `cn claude-hook`) is rewritten.
+    const current = new Set([SESSION_HOOK_COMMAND, SESSION_HOOK_COMMAND_NPX]);
+    const groups = settings.hooks?.SessionStart;
+    if (!Array.isArray(groups))
+        return false;
+    let changed = false;
+    for (const group of groups) {
+        if (!Array.isArray(group.hooks))
+            continue;
+        for (const h of group.hooks) {
+            if (typeof h.command === "string" &&
+                h.command.includes("claude-hook") &&
+                !current.has(h.command)) {
+                h.command = command;
+                changed = true;
+            }
+        }
+    }
+    return changed;
+}
+/**
+ * True when a `cnotes claude-hook` SessionStart entry already exists. Read-only —
+ * lets callers skip prompting on re-runs without mutating anything. Returns
+ * false (rather than throwing) when the file is missing or unreadable.
+ */
+export function isClaudeSessionHookInstalled() {
+    try {
+        const settings = JSON.parse(readFileSync(CLAUDE_SETTINGS_PATH, "utf-8"));
+        return settingsHaveSessionHook(settings);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Idempotently add the SessionStart hook to ~/.claude/settings.json.
+ * Preserves existing settings + hooks, backs up an existing file first.
+ *
+ * @throws if an existing settings.json is present but not valid JSON — we will
+ *   not overwrite the user's whole config; the caller should surface the manual
+ *   install instructions instead.
+ */
+export function installClaudeSessionHook(command = SESSION_HOOK_COMMAND) {
+    const configPath = CLAUDE_SETTINGS_PATH;
+    const existed = existsSync(configPath);
+    let settings = {};
+    if (existed) {
+        const raw = readFileSync(configPath, "utf-8");
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            throw new Error(`${configPath} is not valid JSON — leaving it untouched. Add the SessionStart hook manually.`);
+        }
+        // Valid JSON but not an object (e.g. an array or a primitive) is a config
+        // we don't understand — refuse rather than reformat it into something that
+        // would silently drop the hook (and falsely report success).
+        if (!isPlainSettingsObject(parsed)) {
+            throw new Error(`${configPath} is not a JSON object — leaving it untouched. Add the SessionStart hook manually.`);
+        }
+        settings = parsed;
+    }
+    // Upgrade a pre-rename hook (e.g. a now-dead `cn claude-hook`) to the current
+    // command in place, so an existing install heals instead of keeping a broken
+    // SessionStart entry. A genuinely up-to-date hook needs no write.
+    const upgraded = upgradeStaleSessionHooks(settings, command);
+    if (existed && settingsHaveSessionHook(settings) && !upgraded) {
+        return { configPath, status: "already-present" };
+    }
+    // Back up an existing (valid) file before mutating it.
+    let backedUp;
+    if (existed) {
+        backedUp = configPath + ".bak";
+        try {
+            copyFileSync(configPath, backedUp);
+        }
+        catch {
+            backedUp = undefined;
+        }
+    }
+    // Append our hook only when none exists yet. If we just upgraded a stale
+    // entry, it's already present — we only need to persist the rewrite.
+    if (!settingsHaveSessionHook(settings)) {
+        if (!settings.hooks || typeof settings.hooks !== "object") {
+            settings.hooks = {};
+        }
+        const hooks = settings.hooks;
+        if (!Array.isArray(hooks.SessionStart)) {
+            hooks.SessionStart = [];
+        }
+        // Append a fresh group rather than mutating an existing one, so any
+        // user-defined SessionStart groups (with their own matchers) are untouched.
+        // No matcher → fires on every source (startup, resume, clear, compact); the
+        // session id is stable across those, so re-stamping just refreshes the file.
+        hooks.SessionStart.push({ hooks: [{ type: "command", command }] });
+    }
+    mkdirSync(dirname(configPath), { recursive: true });
+    // Write atomically (temp file + rename) so an interrupted write can never
+    // leave the user's whole Claude Code config truncated.
+    const tmpPath = configPath + ".tmp";
+    writeFileSync(tmpPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
+    renameSync(tmpPath, configPath);
+    return { configPath, status: existed ? "installed" : "created", backedUp };
+}
+//# sourceMappingURL=install-hook.js.map

package/dist/lib/install-hook.js.map

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

package/dist/lib/install-mcp.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Auto-install MCP server config into Claude Desktop or Codex config files.
+ *
+ * Reads existing config, merges the CN MCP server entry, writes back.
+ * Creates config file/directory if they don't exist.
+ */
+export interface McpInstallConfig {
+    serverUrl: string;
+    token: string;
+    workspaceId?: string;
+}
+export type McpTarget = "claude" | "codex";
+interface InstallResult {
+    configPath: string;
+    created: boolean;
+    backedUp?: string;
+}
+export declare function getConfigPath(target: McpTarget): string;
+export declare function installMcpConfig(target: McpTarget, cfg: McpInstallConfig): InstallResult;
+export {};
+//# sourceMappingURL=install-mcp.d.ts.map

package/dist/lib/install-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-mcp.d.ts","sourceRoot":"","sources":["../../src/lib/install-mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3C,UAAU,aAAa;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAuBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAEvD;AAwHD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,gBAAgB,GAAG,aAAa,CAExF"}

package/dist/lib/install-mcp.js

@@ -0,0 +1,133 @@
+/**
+ * Auto-install MCP server config into Claude Desktop or Codex config files.
+ *
+ * Reads existing config, merges the CN MCP server entry, writes back.
+ * Creates config file/directory if they don't exist.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync, copyFileSync } from "fs";
+import { dirname, resolve } from "path";
+import { homedir } from "os";
+import { fileURLToPath } from "url";
+// ── Path resolution ─────────────────────────────────────────
+function expandHome(p) {
+    return p.startsWith("~") ? resolve(homedir(), p.slice(2)) : p;
+}
+function getClaudeConfigPath() {
+    switch (process.platform) {
+        case "win32":
+            return resolve(process.env.APPDATA || resolve(homedir(), "AppData", "Roaming"), "Claude", "claude_desktop_config.json");
+        case "darwin":
+            return resolve(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
+        default:
+            return resolve(homedir(), ".config", "Claude", "claude_desktop_config.json");
+    }
+}
+function getCodexConfigPath() {
+    return expandHome("~/.codex/config.toml");
+}
+export function getConfigPath(target) {
+    return target === "claude" ? getClaudeConfigPath() : getCodexConfigPath();
+}
+// ── MCP server entry ────────────────────────────────────────
+function getMcpServerPath() {
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    return resolve(__dirname, "..", "mcp-server.js");
+}
+function buildMcpEntry(cfg) {
+    return {
+        command: "node",
+        args: [getMcpServerPath()],
+        env: {
+            CN_SERVER: cfg.serverUrl,
+            CN_TOKEN: cfg.token,
+            CN_WORKSPACE: cfg.workspaceId || "",
+        },
+    };
+}
+// ── Claude Desktop (JSON) ───────────────────────────────────
+function installClaude(cfg) {
+    const configPath = getClaudeConfigPath();
+    const dir = dirname(configPath);
+    mkdirSync(dir, { recursive: true });
+    let existing = {};
+    let created = true;
+    let backedUp;
+    if (existsSync(configPath)) {
+        created = false;
+        const raw = readFileSync(configPath, "utf-8");
+        try {
+            existing = JSON.parse(raw);
+        }
+        catch {
+            // Corrupt file — back it up and start fresh
+            backedUp = configPath + ".bak";
+            copyFileSync(configPath, backedUp);
+            existing = {};
+        }
+        // Back up valid files too (overwrite previous .bak)
+        if (!backedUp) {
+            backedUp = configPath + ".bak";
+            copyFileSync(configPath, backedUp);
+        }
+    }
+    // Merge — preserve other MCP servers
+    const mcpServers = existing.mcpServers || {};
+    delete mcpServers.cn; // drop the pre-rename server key if present
+    mcpServers.cnotes = buildMcpEntry(cfg);
+    existing.mcpServers = mcpServers;
+    writeFileSync(configPath, JSON.stringify(existing, null, 2) + "\n", "utf-8");
+    return { configPath, created, backedUp: created ? undefined : backedUp };
+}
+// ── Codex (TOML) ────────────────────────────────────────────
+/**
+ * Simple TOML merge: replaces or appends the [mcp_servers.cnotes] block.
+ * Avoids a TOML dependency by doing targeted string manipulation.
+ */
+function installCodex(cfg) {
+    const configPath = getCodexConfigPath();
+    const dir = dirname(configPath);
+    mkdirSync(dir, { recursive: true });
+    const entry = buildMcpEntry(cfg);
+    const block = [
+        `[mcp_servers.cnotes]`,
+        `command = "${entry.command}"`,
+        `args = [${entry.args.map(a => `"${a}"`).join(", ")}]`,
+        ``,
+        `[mcp_servers.cnotes.env]`,
+        `CN_SERVER = "${entry.env.CN_SERVER}"`,
+        `CN_TOKEN = "${entry.env.CN_TOKEN}"`,
+        `CN_WORKSPACE = "${entry.env.CN_WORKSPACE}"`,
+    ].join("\n");
+    let created = true;
+    let backedUp;
+    if (existsSync(configPath)) {
+        created = false;
+        backedUp = configPath + ".bak";
+        copyFileSync(configPath, backedUp);
+        let content = readFileSync(configPath, "utf-8");
+        // Remove existing [mcp_servers.cnotes] and [mcp_servers.cnotes.env] blocks
+        // Match from [mcp_servers.cnotes] up to the next [section] or end of file
+        const cnotesBlockPattern = /\[mcp_servers\.cnotes\][\s\S]*?(?=\n\[(?!mcp_servers\.cnotes[\].])|$)/g;
+        content = content.replace(cnotesBlockPattern, "");
+        // Also drop the pre-rename [mcp_servers.cn] / [mcp_servers.cn.env] blocks
+        // so a Codex user migrating from `cn` doesn't keep a duplicate server
+        // pointing at the same mcp-server.js (parity with the Claude path's
+        // `delete mcpServers.cn`).
+        const legacyBlockPattern = /\[mcp_servers\.cn\][\s\S]*?(?=\n\[(?!mcp_servers\.cn[\].])|$)/g;
+        content = content.replace(legacyBlockPattern, "");
+        // Clean up extra blank lines left behind
+        content = content.replace(/\n{3,}/g, "\n\n").trimEnd();
+        // Append the new block
+        content = content + "\n\n" + block + "\n";
+        writeFileSync(configPath, content, "utf-8");
+    }
+    else {
+        writeFileSync(configPath, block + "\n", "utf-8");
+    }
+    return { configPath, created, backedUp: created ? undefined : backedUp };
+}
+// ── Public API ──────────────────────────────────────────────
+export function installMcpConfig(target, cfg) {
+    return target === "claude" ? installClaude(cfg) : installCodex(cfg);
+}
+//# sourceMappingURL=install-mcp.js.map

package/dist/lib/install-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-mcp.js","sourceRoot":"","sources":["../../src/lib/install-mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACtF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAgBpC,+DAA+D;AAE/D,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,mBAAmB;IAC1B,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,4BAA4B,CAAC,CAAC;QAC1H,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,QAAQ,EAAE,4BAA4B,CAAC,CAAC;QACtG;YACE,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,4BAA4B,CAAC,CAAC;IACjF,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB;IACzB,OAAO,UAAU,CAAC,sBAAsB,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC7C,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC;AAC5E,CAAC;AAED,+DAA+D;AAE/D,SAAS,gBAAgB;IACvB,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,OAAO,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,aAAa,CAAC,GAAqB;IAC1C,OAAO;QACL,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,gBAAgB,EAAE,CAAC;QAC1B,GAAG,EAAE;YACH,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,QAAQ,EAAE,GAAG,CAAC,KAAK;YACnB,YAAY,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;SACpC;KACF,CAAC;AACJ,CAAC;AAED,+DAA+D;AAE/D,SAAS,aAAa,CAAC,GAAqB;IAC1C,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAC;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpC,IAAI,QAAQ,GAA4B,EAAE,CAAC;IAC3C,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,IAAI,QAA4B,CAAC;IAEjC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,OAAO,GAAG,KAAK,CAAC;QAChB,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;YAC5C,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;YAC/B,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YACnC,QAAQ,GAAG,EAAE,CAAC;QAChB,CAAC;QACD,oDAAoD;QACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;YAC/B,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,MAAM,UAAU,GAAI,QAAQ,CAAC,UAAsC,IAAI,EAAE,CAAC;IAC1E,OAAO,UAAU,CAAC,EAAE,CAAC,CAAC,4CAA4C;IAClE,UAAU,CAAC,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACvC,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;IAEjC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7E,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC3E,CAAC;AAED,+DAA+D;AAE/D;;;GAGG;AACH,SAAS,YAAY,CAAC,GAAqB;IACzC,MAAM,UAAU,GAAG,kBAAkB,EAAE,CAAC;IACxC,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpC,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG;QACZ,sBAAsB;QACtB,cAAc,KAAK,CAAC,OAAO,GAAG;QAC9B,WAAW,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QACtD,EAAE;QACF,0BAA0B;QAC1B,gBAAgB,KAAK,CAAC,GAAG,CAAC,SAAS,GAAG;QACtC,eAAe,KAAK,CAAC,GAAG,CAAC,QAAQ,GAAG;QACpC,mBAAmB,KAAK,CAAC,GAAG,CAAC,YAAY,GAAG;KAC7C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,IAAI,QAA4B,CAAC;IAEjC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,OAAO,GAAG,KAAK,CAAC;QAChB,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;QAC/B,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAEnC,IAAI,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAEhD,2EAA2E;QAC3E,0EAA0E;QAC1E,MAAM,kBAAkB,GAAG,wEAAwE,CAAC;QACpG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;QAElD,0EAA0E;QAC1E,sEAAsE;QACtE,oEAAoE;QACpE,2BAA2B;QAC3B,MAAM,kBAAkB,GAAG,gEAAgE,CAAC;QAC5F,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;QAElD,yCAAyC;QACzC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;QAEvD,uBAAuB;QACvB,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;QAC1C,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC3E,CAAC;AAED,+DAA+D;AAE/D,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,GAAqB;IACvE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;AACtE,CAAC"}

package/dist/lib/install-skill.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Auto-install the `cnotes` skill so coding agents auto-discover it.
+ *
+ * The same bundled skill feeds two targets:
+ *   - Claude Code  → ~/.claude/skills/cnotes/SKILL.md
+ *   - OpenAI Codex → ~/.codex/skills/cnotes/SKILL.md
+ *
+ * The skill ships inside the published package at <package>/skills/cnotes/SKILL.md.
+ * At runtime this file lives at <package>/dist/lib/install-skill.js, so the
+ * skill source is two directories up.
+ */
+/** The agents we ship a discoverable skill for. */
+export type SkillTarget = "claude" | "codex";
+export declare const SKILL_TARGETS: SkillTarget[];
+/** Human-facing label for a target (used in init/output messages). */
+export declare function skillTargetLabel(target: SkillTarget): string;
+export interface SkillInstallResult {
+    target: SkillTarget;
+    installed: boolean;
+    destPath: string;
+    alreadyUpToDate?: boolean;
+}
+/** Where the skill lives on disk inside the installed package. */
+export declare function getBundledSkillPath(): string;
+/** Where the skill should be copied to for a given agent. */
+export declare function getSkillDestPath(target?: SkillTarget): string;
+/** True if the user appears to use this agent (its config dir exists). */
+export declare function hasAgentConfigDir(target: SkillTarget): boolean;
+/** True if the destination skill already exists for a target. */
+export declare function skillAlreadyInstalled(target?: SkillTarget): boolean;
+/** True if a target still has the old `cn` skill installed. */
+export declare function legacySkillInstalled(target: SkillTarget): boolean;
+/**
+ * Refresh ALREADY-installed skill copies if the bundled copy has changed.
+ *
+ * Runs on every CLI invocation (cheap: one file compare per target). It never
+ * installs for an agent the user hasn't opted into — it only updates a skill
+ * that already exists, so a plain `npm update -g @creator-notes/cnotes` is enough
+ * to get the latest skill for both Claude and Codex without re-running
+ * `cnotes init`. Best-effort: per-target errors are swallowed so skill maintenance
+ * can never break a command.
+ */
+export declare function refreshInstalledSkills(): SkillInstallResult[];
+/**
+ * Copy the bundled skill into a target agent's skills dir.
+ * Caller is responsible for any prompting / confirmation.
+ */
+export declare function installSkill(target?: SkillTarget): SkillInstallResult;
+//# sourceMappingURL=install-skill.d.ts.map

package/dist/lib/install-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-skill.d.ts","sourceRoot":"","sources":["../../src/lib/install-skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,mDAAmD;AACnD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7C,eAAO,MAAM,aAAa,EAAE,WAAW,EAAwB,CAAC;AAEhE,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAE5D;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAOD,kEAAkE;AAClE,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,WAAsB,GAAG,MAAM,CAEvE;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAE9D;AAED,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,MAAM,GAAE,WAAsB,GAAG,OAAO,CAE7E;AAOD,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAEjE;AAoBD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,IAAI,kBAAkB,EAAE,CAc7D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,WAAsB,GAAG,kBAAkB,CAgB/E"}

package/dist/lib/install-skill.js

@@ -0,0 +1,113 @@
+/**
+ * Auto-install the `cnotes` skill so coding agents auto-discover it.
+ *
+ * The same bundled skill feeds two targets:
+ *   - Claude Code  → ~/.claude/skills/cnotes/SKILL.md
+ *   - OpenAI Codex → ~/.codex/skills/cnotes/SKILL.md
+ *
+ * The skill ships inside the published package at <package>/skills/cnotes/SKILL.md.
+ * At runtime this file lives at <package>/dist/lib/install-skill.js, so the
+ * skill source is two directories up.
+ */
+import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync } from "fs";
+import { dirname, resolve } from "path";
+import { homedir } from "os";
+import { fileURLToPath } from "url";
+export const SKILL_TARGETS = ["claude", "codex"];
+/** Human-facing label for a target (used in init/output messages). */
+export function skillTargetLabel(target) {
+    return target === "claude" ? "Claude Code" : "Codex";
+}
+/** The config dir each agent reads its skills from. */
+function agentConfigDir(target) {
+    return resolve(homedir(), target === "claude" ? ".claude" : ".codex");
+}
+/** Where the skill lives on disk inside the installed package. */
+export function getBundledSkillPath() {
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    return resolve(__dirname, "..", "..", "skills", "cnotes", "SKILL.md");
+}
+/** Where the skill should be copied to for a given agent. */
+export function getSkillDestPath(target = "claude") {
+    return resolve(agentConfigDir(target), "skills", "cnotes", "SKILL.md");
+}
+/** True if the user appears to use this agent (its config dir exists). */
+export function hasAgentConfigDir(target) {
+    return existsSync(agentConfigDir(target));
+}
+/** True if the destination skill already exists for a target. */
+export function skillAlreadyInstalled(target = "claude") {
+    return existsSync(getSkillDestPath(target));
+}
+/** The pre-rename skill location (`skills/cn/`), kept only to migrate away from it. */
+function getLegacySkillDir(target) {
+    return resolve(agentConfigDir(target), "skills", "cn");
+}
+/** True if a target still has the old `cn` skill installed. */
+export function legacySkillInstalled(target) {
+    return existsSync(resolve(getLegacySkillDir(target), "SKILL.md"));
+}
+/** Delete the pre-rename `cn` skill dir if present (best-effort, idempotent). */
+function removeLegacySkill(target) {
+    try {
+        const dir = getLegacySkillDir(target);
+        if (existsSync(dir))
+            rmSync(dir, { recursive: true, force: true });
+    }
+    catch {
+        /* ignore — a stale legacy skill is harmless; never fail a command over it */
+    }
+}
+function filesAreIdentical(a, b) {
+    try {
+        return readFileSync(a).equals(readFileSync(b));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Refresh ALREADY-installed skill copies if the bundled copy has changed.
+ *
+ * Runs on every CLI invocation (cheap: one file compare per target). It never
+ * installs for an agent the user hasn't opted into — it only updates a skill
+ * that already exists, so a plain `npm update -g @creator-notes/cnotes` is enough
+ * to get the latest skill for both Claude and Codex without re-running
+ * `cnotes init`. Best-effort: per-target errors are swallowed so skill maintenance
+ * can never break a command.
+ */
+export function refreshInstalledSkills() {
+    const results = [];
+    for (const target of SKILL_TARGETS) {
+        try {
+            // Refresh if the current skill is installed, OR migrate a target that
+            // still only has the pre-rename `cn` skill (installSkill removes it).
+            if (skillAlreadyInstalled(target) || legacySkillInstalled(target)) {
+                results.push(installSkill(target));
+            }
+        }
+        catch {
+            /* ignore this target — keep refreshing the others */
+        }
+    }
+    return results;
+}
+/**
+ * Copy the bundled skill into a target agent's skills dir.
+ * Caller is responsible for any prompting / confirmation.
+ */
+export function installSkill(target = "claude") {
+    const source = getBundledSkillPath();
+    const dest = getSkillDestPath(target);
+    if (!existsSync(source)) {
+        throw new Error(`Bundled skill not found at ${source}`);
+    }
+    if (existsSync(dest) && filesAreIdentical(source, dest)) {
+        return { target, installed: false, destPath: dest, alreadyUpToDate: true };
+    }
+    mkdirSync(dirname(dest), { recursive: true });
+    copyFileSync(source, dest);
+    removeLegacySkill(target); // drop the old `cn` skill once the new one is in place
+    return { target, installed: true, destPath: dest };
+}
+//# sourceMappingURL=install-skill.js.map

package/dist/lib/install-skill.js.map

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

package/dist/lib/output.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Output formatting utilities.
+ *
+ * JSON mode: raw API response.
+ * Human mode: formatted tables/text.
+ * Quiet mode: minimal output (IDs only).
+ */
+/**
+ * Project an object (or array of objects) down to a set of top-level fields.
+ * No-op when `fields` is empty/undefined. Lets agents trim list/get output to
+ * just the keys they need (e.g. `--fields displayId,title`) instead of paying
+ * for the full record in their context window.
+ */
+export declare function projectFields(data: unknown, fields?: string[]): unknown;
+export declare function outputJson(data: unknown, fields?: string[]): void;
+export declare function outputQuiet(value: string): void;
+/**
+ * Print a simple table with aligned columns.
+ */
+export declare function outputTable(headers: string[], rows: string[][]): void;
+/**
+ * Format a timestamp as relative time (e.g., "2h ago", "3d ago").
+ */
+export declare function timeAgo(timestamp: number | string): string;
+/**
+ * Truncate a string to a max length with ellipsis.
+ */
+export declare function truncate(str: string, max: number): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/lib/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAYvE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAEjE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,MAAM,EAAE,EAAE,GACf,IAAI,CAeN;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAa1D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGzD"}

package/dist/lib/output.js

@@ -0,0 +1,78 @@
+/**
+ * Output formatting utilities.
+ *
+ * JSON mode: raw API response.
+ * Human mode: formatted tables/text.
+ * Quiet mode: minimal output (IDs only).
+ */
+/**
+ * Project an object (or array of objects) down to a set of top-level fields.
+ * No-op when `fields` is empty/undefined. Lets agents trim list/get output to
+ * just the keys they need (e.g. `--fields displayId,title`) instead of paying
+ * for the full record in their context window.
+ */
+export function projectFields(data, fields) {
+    if (!fields || fields.length === 0)
+        return data;
+    const pick = (obj) => {
+        if (!obj || typeof obj !== "object" || Array.isArray(obj))
+            return obj;
+        const rec = obj;
+        const out = {};
+        for (const f of fields) {
+            if (f in rec)
+                out[f] = rec[f];
+        }
+        return out;
+    };
+    return Array.isArray(data) ? data.map(pick) : pick(data);
+}
+export function outputJson(data, fields) {
+    console.log(JSON.stringify(projectFields(data, fields), null, 2));
+}
+export function outputQuiet(value) {
+    console.log(value);
+}
+/**
+ * Print a simple table with aligned columns.
+ */
+export function outputTable(headers, rows) {
+    const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] || "").length)));
+    const headerLine = headers
+        .map((h, i) => h.padEnd(widths[i]))
+        .join("  ");
+    const separator = widths.map((w) => "-".repeat(w)).join("  ");
+    console.log(headerLine);
+    console.log(separator);
+    for (const row of rows) {
+        console.log(row.map((c, i) => (c || "").padEnd(widths[i])).join("  "));
+    }
+}
+/**
+ * Format a timestamp as relative time (e.g., "2h ago", "3d ago").
+ */
+export function timeAgo(timestamp) {
+    const ms = typeof timestamp === "string" ? new Date(timestamp).getTime() : timestamp;
+    const now = Date.now();
+    const diff = now - ms;
+    const seconds = Math.floor(diff / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0)
+        return `${days}d ago`;
+    if (hours > 0)
+        return `${hours}h ago`;
+    if (minutes > 0)
+        return `${minutes}m ago`;
+    return "just now";
+}
+/**
+ * Truncate a string to a max length with ellipsis.
+ */
+export function truncate(str, max) {
+    if (str.length <= max)
+        return str;
+    return str.slice(0, max - 1) + "\u2026";
+}
+//# sourceMappingURL=output.js.map

package/dist/lib/output.js.map

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

package/dist/lib/resolve-note.d.ts

@@ -0,0 +1,7 @@
+import { ApiClient } from "./api-client.js";
+/**
+ * Resolve a display ID (e.g., "MEETING-12") to a Convex note ID.
+ * Falls back to treating the input as a Convex ID directly.
+ */
+export declare function resolveNoteId(api: ApiClient, workspaceId: string, idOrDisplayId: string): Promise<string>;
+//# sourceMappingURL=resolve-note.d.ts.map

package/dist/lib/resolve-note.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-note.d.ts","sourceRoot":"","sources":["../../src/lib/resolve-note.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C;;;GAGG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAsBjB"}