claude-memory-explorer 0.1.0

package/dist/cli/commands/lint.js

@@ -0,0 +1,139 @@
+// `memex lint` — report structural problems with memory files.
+//
+// Exit codes:
+//   0  — no issues, or only `info`/`warn` (unless --strict is set)
+//   1  — at least one `error` issue (or any issue if --strict)
+//   2  — bad usage
+import { lintAll } from "../../core/lint.js";
+import { relative } from "node:path";
+import { homedir } from "node:os";
+function parseArgs(argv) {
+    const out = { json: false, strict: false, verbose: false, help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        switch (a) {
+            case "--project":
+                out.project = argv[++i];
+                break;
+            case "--root":
+                out.root = argv[++i];
+                break;
+            case "--json":
+                out.json = true;
+                break;
+            case "--strict":
+                out.strict = true;
+                break;
+            case "--verbose":
+            case "-v":
+                out.verbose = true;
+                break;
+            case "--help":
+            case "-h":
+                out.help = true;
+                break;
+            default:
+                throw new Error(`unknown flag: ${a}`);
+        }
+    }
+    return out;
+}
+const HELP = `memex lint — find structural problems in your memory tree
+
+Usage:
+  memex lint [--project SUBSTR] [--json] [--strict] [--verbose] [--root PATH]
+
+Flags:
+  --project SUBSTR  Filter projects whose slug contains SUBSTR
+  --json            Output JSON instead of human-readable lines
+  --strict          Exit 1 on any issue (default: only error issues)
+  --verbose, -v     Show scan-level warnings on stderr
+  --root PATH       Override projects root (default: ~/.claude/projects)
+
+Severities:
+  error             Confirmed problem (data loss, unusable file)
+  warn              Likely problem (broken link, missing index)
+  info              Informational (untyped file, orphan with pointer index)
+
+Exit codes:
+  0   no issues (or only warn/info without --strict)
+  1   one or more error issues (or any issue with --strict)
+  2   bad usage
+`;
+const SEV_LABEL = {
+    error: "ERROR",
+    warn: "WARN ",
+    info: "INFO ",
+};
+function shortPath(p) {
+    if (!p)
+        return "";
+    const home = homedir();
+    if (p.startsWith(home))
+        return "~" + p.slice(home.length);
+    try {
+        const rel = relative(process.cwd(), p);
+        return rel.length < p.length ? rel : p;
+    }
+    catch {
+        return p;
+    }
+}
+function formatIssue(issue) {
+    const lines = [
+        `[${SEV_LABEL[issue.severity]}] ${issue.code}  (${issue.projectSlug})`,
+        `  ${issue.message}`,
+    ];
+    if (issue.filePath) {
+        lines.push(`  at: ${shortPath(issue.filePath)}`);
+    }
+    if (issue.hint) {
+        lines.push(`  hint: ${issue.hint}`);
+    }
+    return lines.join("\n");
+}
+export function runLint(argv) {
+    let args;
+    try {
+        args = parseArgs(argv);
+    }
+    catch (err) {
+        process.stderr.write(`memex lint: ${err instanceof Error ? err.message : String(err)}\n\n${HELP}`);
+        return 2;
+    }
+    if (args.help) {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    const result = lintAll({
+        projectsRoot: args.root,
+        projectFilter: args.project,
+        onWarning: args.verbose ? (m) => process.stderr.write(`${m}\n`) : undefined,
+    });
+    if (args.json) {
+        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    }
+    else {
+        if (result.issues.length === 0) {
+            process.stdout.write(`✓ No issues across ${result.projectsScanned} projects (${result.filesScanned} memory files scanned).\n`);
+        }
+        else {
+            for (const issue of result.issues) {
+                process.stdout.write(`${formatIssue(issue)}\n\n`);
+            }
+            const counts = { error: 0, warn: 0, info: 0 };
+            for (const i of result.issues)
+                counts[i.severity]++;
+            process.stdout.write(`${result.issues.length} issue(s): ` +
+                `${counts.error} error, ${counts.warn} warn, ${counts.info} info ` +
+                `across ${result.projectsScanned} projects (${result.filesScanned} files).\n`);
+        }
+    }
+    const hasError = result.issues.some((i) => i.severity === "error");
+    if (hasError)
+        return 1;
+    if (args.strict && result.issues.length > 0)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=lint.js.map

package/dist/cli/commands/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../../src/cli/commands/lint.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,cAAc;AACd,mEAAmE;AACnE,+DAA+D;AAC/D,mBAAmB;AAEnB,OAAO,EAAE,OAAO,EAAiC,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAWlC,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,GAAG,GAAa,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAClF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,QAAQ,CAAC,EAAE,CAAC;YACV,KAAK,WAAW;gBACd,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACxB,MAAM;YACR,KAAK,QAAQ;gBACX,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACrB,MAAM;YACR,KAAK,QAAQ;gBACX,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,KAAK,UAAU;gBACb,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC;gBAClB,MAAM;YACR,KAAK,WAAW,CAAC;YACjB,KAAK,IAAI;gBACP,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;gBACnB,MAAM;YACR,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;CAqBZ,CAAC;AAEF,MAAM,SAAS,GAA6B;IAC1C,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,OAAO;CACd,CAAC;AAEF,SAAS,SAAS,CAAC,CAAqB;IACtC,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAClB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QACvC,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAgB;IACnC,MAAM,KAAK,GAAG;QACZ,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,WAAW,GAAG;QACtE,KAAK,KAAK,CAAC,OAAO,EAAE;KACrB,CAAC;IACF,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAc;IACpC,IAAI,IAAc,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,eAAe,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAC7E,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC;QACrB,YAAY,EAAE,IAAI,CAAC,IAAI;QACvB,aAAa,EAAE,IAAI,CAAC,OAAO;QAC3B,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KAC5E,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACN,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,sBAAsB,MAAM,CAAC,eAAe,cAAc,MAAM,CAAC,YAAY,2BAA2B,CACzG,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,MAAM,GAA6B,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACxE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM;gBAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,aAAa;gBAClC,GAAG,MAAM,CAAC,KAAK,WAAW,MAAM,CAAC,IAAI,UAAU,MAAM,CAAC,IAAI,QAAQ;gBAClE,UAAU,MAAM,CAAC,eAAe,cAAc,MAAM,CAAC,YAAY,YAAY,CAChF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IACnE,IAAI,QAAQ;QAAE,OAAO,CAAC,CAAC;IACvB,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACtD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/commands/list.d.ts

@@ -0,0 +1 @@
+export declare function runList(argv: string[]): number;

package/dist/cli/commands/list.js

@@ -0,0 +1,97 @@
+// `memex list` — read-only view of memories across all projects.
+//
+// Flags:
+//   --type <user|feedback|project|reference|untyped>   filter by type
+//   --project <substring>                              filter by slug substring
+//   --json                                             machine output
+//   --root <path>                                      override projects root (testing)
+import { scanAll, allMemories } from "../../core/scan.js";
+import { MEMORY_TYPES } from "../../core/types.js";
+const VALID_TYPES = new Set([...MEMORY_TYPES, "untyped"]);
+function parseArgs(argv) {
+    const out = { json: false, verbose: false };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        switch (a) {
+            case "--type":
+                out.type = argv[++i];
+                break;
+            case "--project":
+                out.project = argv[++i];
+                break;
+            case "--root":
+                out.root = argv[++i];
+                break;
+            case "--json":
+                out.json = true;
+                break;
+            case "--verbose":
+            case "-v":
+                out.verbose = true;
+                break;
+            case "--help":
+            case "-h":
+                out.type = "__help__";
+                return out;
+            default:
+                throw new Error(`unknown flag: ${a}`);
+        }
+    }
+    return out;
+}
+const HELP = `memex list — list memories across projects
+
+Usage:
+  memex list [--type TYPE] [--project SUBSTR] [--json] [--verbose] [--root PATH]
+
+Flags:
+  --type TYPE        Filter: user, feedback, project, reference, untyped
+  --project SUBSTR   Filter projects whose slug contains SUBSTR
+  --json             Output JSON instead of human-readable lines
+  --verbose, -v      Show scan-level warnings on stderr (broken frontmatter, etc.)
+  --root PATH        Override projects root (default: ~/.claude/projects)
+`;
+function formatLine(m) {
+    const desc = m.description ?? "(no description)";
+    return `[${m.type.padEnd(9)}] ${m.id}\n  ${desc}\n`;
+}
+export function runList(argv) {
+    let args;
+    try {
+        args = parseArgs(argv);
+    }
+    catch (err) {
+        process.stderr.write(`memex list: ${err instanceof Error ? err.message : String(err)}\n\n${HELP}`);
+        return 2;
+    }
+    if (args.type === "__help__") {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    if (args.type && !VALID_TYPES.has(args.type)) {
+        process.stderr.write(`memex list: --type must be one of: ${[...VALID_TYPES].join(", ")}\n`);
+        return 2;
+    }
+    const projects = scanAll({
+        projectsRoot: args.root,
+        onWarning: args.verbose ? (m) => process.stderr.write(`${m}\n`) : undefined,
+    });
+    const filteredProjects = args.project
+        ? projects.filter((p) => p.slug.includes(args.project))
+        : projects;
+    const memories = allMemories(filteredProjects).filter((m) => !args.type || m.type === args.type);
+    if (args.json) {
+        process.stdout.write(`${JSON.stringify(memories, null, 2)}\n`);
+        return 0;
+    }
+    if (memories.length === 0) {
+        process.stdout.write("(no memories found)\n");
+        return 0;
+    }
+    for (const m of memories) {
+        process.stdout.write(`${formatLine(m)}\n`);
+    }
+    process.stdout.write(`${memories.length} memories across ${filteredProjects.length} projects\n`);
+    return 0;
+}
+//# sourceMappingURL=list.js.map

package/dist/cli/commands/list.js.map

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

package/dist/cli/commands/mcp.d.ts

@@ -0,0 +1 @@
+export declare function runMcp(argv: string[]): Promise<number>;

package/dist/cli/commands/mcp.js

@@ -0,0 +1,105 @@
+// `memex mcp` — run as an MCP server over stdio.
+//
+// Wire-up in Claude Code:
+//   claude mcp add --transport stdio memex -- npx -y memex mcp
+//
+// Or in .mcp.json:
+//   {
+//     "mcpServers": {
+//       "memex": {
+//         "type": "stdio",
+//         "command": "npx",
+//         "args": ["-y", "memex", "mcp"]
+//       }
+//     }
+//   }
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+function parseArgs(argv) {
+    const out = { help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        switch (a) {
+            case "--root":
+                out.root = argv[++i];
+                break;
+            case "--claude-md":
+                out.claudeMd = argv[++i];
+                break;
+            case "--journal-dir":
+                out.journalDir = argv[++i];
+                break;
+            case "--help":
+            case "-h":
+                out.help = true;
+                break;
+            default:
+                throw new Error(`unknown flag: ${a}`);
+        }
+    }
+    return out;
+}
+const HELP = `memex mcp — run as an MCP server over stdio
+
+Usage:
+  memex mcp [--root PATH] [--claude-md PATH] [--journal-dir PATH]
+
+This subcommand does not produce normal stdout — it implements the MCP
+JSON-RPC protocol on stdin/stdout. Use it from Claude Code (or any
+MCP client) by configuring:
+
+  claude mcp add --transport stdio memex -- npx -y memex mcp
+
+Exposed tools:
+  list_memories        — read-only, returns Memory[]
+  find_duplicates      — read-only, returns cluster summary
+  lint                 — read-only, structural issues
+  doctor               — read-only, full health report
+  plan_merge           — build a Plan to collapse a duplicate cluster
+  plan_promote_memory  — build a Plan to promote one memory to CLAUDE.md
+  plan_promote_cluster — build a Plan to promote whole cluster + delete copies
+  apply_plan           — execute a previously-built Plan (journaled, undoable)
+  undo                 — reverse the most recent applied plan
+  journal_list         — list all journal entries (newest first)
+  journal_latest       — return the most recent journal entry
+
+Flags (mainly for testing):
+  --root PATH         Override projects root
+  --claude-md PATH    Override CLAUDE.md target for promote
+  --journal-dir PATH  Override journal dir
+`;
+const __dirname = dirname(fileURLToPath(import.meta.url));
+function readVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(join(__dirname, "..", "..", "..", "package.json"), "utf8"));
+        return pkg.version;
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+export async function runMcp(argv) {
+    let args;
+    try {
+        args = parseArgs(argv);
+    }
+    catch (err) {
+        process.stderr.write(`memex mcp: ${err instanceof Error ? err.message : String(err)}\n\n${HELP}`);
+        return 2;
+    }
+    if (args.help) {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    // Lazy-import so the rest of the CLI doesn't pay the MCP SDK startup cost.
+    const { runMcpServerStdio } = await import("../../mcp/server.js");
+    await runMcpServerStdio({
+        version: readVersion(),
+        projectsRoot: args.root,
+        claudeMdPath: args.claudeMd,
+        journalDir: args.journalDir,
+    });
+    return 0;
+}
+//# sourceMappingURL=mcp.js.map

package/dist/cli/commands/mcp.js.map

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

package/dist/cli/commands/merge.d.ts

@@ -0,0 +1 @@
+export declare function runMerge(argv: string[]): number;

package/dist/cli/commands/merge.js

@@ -0,0 +1,111 @@
+// `memex merge` — collapse a duplicate cluster down to its representative.
+//
+// Default is dry-run (prints the plan, writes nothing). `--apply` actually
+// commits via Phase 5's applyPlan. The mutation is journaled and reversible
+// via `memex undo`.
+import { findDuplicates } from "../../core/dedupe.js";
+import { buildMergePlan } from "../../core/merge.js";
+import { applyPlan } from "../../core/apply.js";
+import { describePlan } from "../../core/plan.js";
+function parseArgs(argv) {
+    const out = { apply: false, skipIndexUpdate: false, help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        switch (a) {
+            case "--cluster":
+                out.cluster = argv[++i];
+                break;
+            case "--keep":
+                out.keep = argv[++i];
+                break;
+            case "--apply":
+                out.apply = true;
+                break;
+            case "--skip-index-update":
+                out.skipIndexUpdate = true;
+                break;
+            case "--root":
+                out.root = argv[++i];
+                break;
+            case "--journal-dir":
+                out.journalDir = argv[++i];
+                break;
+            case "--help":
+            case "-h":
+                out.help = true;
+                break;
+            default:
+                throw new Error(`unknown flag: ${a}`);
+        }
+    }
+    return out;
+}
+const HELP = `memex merge — collapse a duplicate cluster down to its representative
+
+Usage:
+  memex merge --cluster <id> [--apply] [--keep <memory-id>]
+              [--skip-index-update] [--root PATH]
+
+Flags:
+  --cluster <id>           Cluster id from \`memex dedupe\` (e.g. c1)
+  --keep <memory-id>       Override which member to keep (default: cluster's
+                           representative — longest body, most recent mtime)
+  --apply                  Actually execute the plan (default is dry-run)
+  --skip-index-update      Don't modify MEMORY.md (leaves dangling refs;
+                           \`memex lint\` will catch them)
+  --root PATH              Override projects root
+  --journal-dir PATH       Override journal dir (testing)
+
+The plan is fully undoable via \`memex undo\`.
+`;
+export function runMerge(argv) {
+    let args;
+    try {
+        args = parseArgs(argv);
+    }
+    catch (err) {
+        process.stderr.write(`memex merge: ${err instanceof Error ? err.message : String(err)}\n\n${HELP}`);
+        return 2;
+    }
+    if (args.help) {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    if (!args.cluster) {
+        process.stderr.write(`memex merge: --cluster <id> is required\n\n${HELP}`);
+        return 2;
+    }
+    const dedupeResult = findDuplicates({ projectsRoot: args.root });
+    const cluster = dedupeResult.clusters.find((c) => c.id === args.cluster);
+    if (!cluster) {
+        process.stderr.write(`memex merge: cluster "${args.cluster}" not found. Run \`memex dedupe\` to list current clusters.\n`);
+        return 2;
+    }
+    let plan;
+    try {
+        ({ plan } = buildMergePlan(cluster, {
+            keepId: args.keep,
+            skipIndexUpdate: args.skipIndexUpdate,
+        }));
+    }
+    catch (err) {
+        process.stderr.write(`memex merge: ${err instanceof Error ? err.message : String(err)}\n`);
+        return 2;
+    }
+    if (!args.apply) {
+        process.stdout.write(`${describePlan(plan)}\n\n(dry run — pass --apply to execute)\n`);
+        return 0;
+    }
+    const journalOpts = args.journalDir ? { journalDir: args.journalDir } : {};
+    const entry = applyPlan(plan, {
+        ...journalOpts,
+        onProgress: (m) => process.stdout.write(`${m}\n`),
+    });
+    if (entry.status === "complete") {
+        process.stdout.write(`\n✓ Merge complete (plan ${plan.id}). Run \`memex undo\` to reverse.\n`);
+        return 0;
+    }
+    process.stderr.write(`\n✗ Merge ${entry.status}. Some ops failed — \`memex undo --list\` shows state.\n`);
+    return 1;
+}
+//# sourceMappingURL=merge.js.map

package/dist/cli/commands/merge.js.map

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

package/dist/cli/commands/promote.d.ts

@@ -0,0 +1 @@
+export declare function runPromote(argv: string[]): number;

package/dist/cli/commands/promote.js

@@ -0,0 +1,157 @@
+// `memex promote` — move a memory (or whole cluster) into
+// `~/.claude/CLAUDE.md` as a managed block.
+//
+// Default is dry-run. `--apply` actually executes. All mutations go through
+// Phase 5's plan/apply/journal and are reversible via `memex undo`.
+import { readFileSync } from "node:fs";
+import { findDuplicates } from "../../core/dedupe.js";
+import { buildPromoteMemoryPlan, buildPromoteClusterPlan } from "../../core/promote.js";
+import { applyPlan } from "../../core/apply.js";
+import { describePlan } from "../../core/plan.js";
+import { scanAll } from "../../core/scan.js";
+function parseArgs(argv) {
+    const out = { apply: false, skipIndexUpdate: false, help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        switch (a) {
+            case "--memory":
+                out.memory = argv[++i];
+                break;
+            case "--cluster":
+                out.cluster = argv[++i];
+                break;
+            case "--apply":
+                out.apply = true;
+                break;
+            case "--skip-index-update":
+                out.skipIndexUpdate = true;
+                break;
+            case "--claude-md":
+                out.claudeMd = argv[++i];
+                break;
+            case "--root":
+                out.root = argv[++i];
+                break;
+            case "--journal-dir":
+                out.journalDir = argv[++i];
+                break;
+            case "--help":
+            case "-h":
+                out.help = true;
+                break;
+            default:
+                throw new Error(`unknown flag: ${a}`);
+        }
+    }
+    return out;
+}
+const HELP = `memex promote — promote a memory to ~/.claude/CLAUDE.md
+
+Usage:
+  memex promote --memory <id> [--apply]
+  memex promote --cluster <id> [--apply]
+
+Either --memory or --cluster must be set.
+
+  --memory <id>         Memory id from \`memex list --json\` (slug/filename)
+  --cluster <id>        Cluster id from \`memex dedupe\` — promotes the
+                        representative AND deletes every cluster member
+                        (the global block replaces all copies)
+  --apply               Actually execute the plan (default is dry-run)
+  --skip-index-update   Don't modify MEMORY.md (leaves dangling refs)
+  --claude-md PATH      Override destination (default: ~/.claude/CLAUDE.md)
+  --root PATH           Override projects root
+  --journal-dir PATH    Override journal dir (testing)
+
+The destination uses memex-managed marker blocks:
+  <!-- memex:start:<slug> -->
+  ## <heading>
+  <body>
+  <!-- memex:end:<slug> -->
+
+Content outside markers is never touched. Re-promoting the same slug
+replaces the block in place (idempotent).
+`;
+export function runPromote(argv) {
+    let args;
+    try {
+        args = parseArgs(argv);
+    }
+    catch (err) {
+        process.stderr.write(`memex promote: ${err instanceof Error ? err.message : String(err)}\n\n${HELP}`);
+        return 2;
+    }
+    if (args.help) {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    if (!args.memory && !args.cluster) {
+        process.stderr.write(`memex promote: one of --memory or --cluster is required\n\n${HELP}`);
+        return 2;
+    }
+    if (args.memory && args.cluster) {
+        process.stderr.write(`memex promote: --memory and --cluster are mutually exclusive\n`);
+        return 2;
+    }
+    let plan;
+    if (args.memory) {
+        const projects = scanAll({ projectsRoot: args.root });
+        const memory = projects.flatMap((p) => p.memories).find((m) => m.id === args.memory);
+        if (!memory) {
+            process.stderr.write(`memex promote: memory "${args.memory}" not found. Run \`memex list\` to see available ids.\n`);
+            return 2;
+        }
+        ({ plan } = buildPromoteMemoryPlan(memory, {
+            claudeMdPath: args.claudeMd,
+            skipIndexUpdate: args.skipIndexUpdate,
+        }));
+    }
+    else {
+        const dedupeResult = findDuplicates({ projectsRoot: args.root });
+        const cluster = dedupeResult.clusters.find((c) => c.id === args.cluster);
+        if (!cluster) {
+            process.stderr.write(`memex promote: cluster "${args.cluster}" not found. Run \`memex dedupe\` to list.\n`);
+            return 2;
+        }
+        const rep = cluster.members.find((m) => m.id === cluster.representative.id);
+        let repBody = "";
+        try {
+            const raw = readFileSync(rep.filePath, "utf8");
+            // Strip frontmatter if present — body is everything after the closing ---.
+            repBody = stripFrontmatter(raw).trim();
+        }
+        catch (err) {
+            process.stderr.write(`memex promote: cannot read representative ${rep.filePath}: ${err instanceof Error ? err.message : String(err)}\n`);
+            return 2;
+        }
+        ({ plan } = buildPromoteClusterPlan(cluster, repBody, {
+            claudeMdPath: args.claudeMd,
+            skipIndexUpdate: args.skipIndexUpdate,
+        }));
+    }
+    if (!args.apply) {
+        process.stdout.write(`${describePlan(plan)}\n\n(dry run — pass --apply to execute)\n`);
+        return 0;
+    }
+    const journalOpts = args.journalDir ? { journalDir: args.journalDir } : {};
+    const entry = applyPlan(plan, {
+        ...journalOpts,
+        onProgress: (m) => process.stdout.write(`${m}\n`),
+    });
+    if (entry.status === "complete") {
+        process.stdout.write(`\n✓ Promote complete (plan ${plan.id}). Run \`memex undo\` to reverse.\n`);
+        return 0;
+    }
+    process.stderr.write(`\n✗ Promote ${entry.status}. \`memex undo --list\` shows state.\n`);
+    return 1;
+}
+function stripFrontmatter(raw) {
+    if (!raw.startsWith("---"))
+        return raw;
+    // Find the closing --- on its own line after the opening.
+    const m = raw.match(/^---\n[\s\S]*?\n---\n?/);
+    if (!m)
+        return raw;
+    return raw.slice(m[0].length);
+}
+//# sourceMappingURL=promote.js.map

package/dist/cli/commands/promote.js.map

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

package/dist/cli/commands/tui.d.ts

@@ -0,0 +1 @@
+export declare function runTui(argv: string[]): Promise<number>;