claude-memory-explorer 0.1.0

package/dist/cli/commands/tui.js

@@ -0,0 +1,60 @@
+// `memex tui` — interactive three-pane browser.
+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 "--help":
+            case "-h":
+                out.help = true;
+                break;
+            default:
+                throw new Error(`unknown flag: ${a}`);
+        }
+    }
+    return out;
+}
+const HELP = `memex tui — interactive three-pane browser
+
+Usage:
+  memex tui [--root PATH]
+
+Keybindings (shown also via ? in-app):
+  ↑/↓        Navigate within a pane
+  Tab / ←/→  Switch pane
+  /          Search across all memories
+  d          Dedupe view (cross-project duplicate clusters)
+  l          Lint view (structural issues)
+  ?          Help
+  Esc        Back to browse
+  q          Quit
+
+Read-only by design. Mutating actions (merge, promote, undo) stay on
+the CLI, where they have dry-run + journal + undo by default.
+`;
+export async function runTui(argv) {
+    let args;
+    try {
+        args = parseArgs(argv);
+    }
+    catch (err) {
+        process.stderr.write(`memex tui: ${err instanceof Error ? err.message : String(err)}\n\n${HELP}`);
+        return 2;
+    }
+    if (args.help) {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    // Lazy-import ink so the rest of memex doesn't pay the React startup cost
+    // when running CLI subcommands.
+    const { render } = await import("ink");
+    const { App } = await import("../tui/App.js");
+    const { createElement } = await import("react");
+    const instance = render(createElement(App, { projectsRoot: args.root }));
+    await instance.waitUntilExit();
+    return 0;
+}
+//# sourceMappingURL=tui.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tui.js","sourceRoot":"","sources":["../../../src/cli/commands/tui.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAOhD,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,GAAG,GAAY,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACrC,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,QAAQ;gBACX,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACrB,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;;;;;;;;;;;;;;;;;CAiBZ,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAc;IACzC,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAClG,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,0EAA0E;IAC1E,gCAAgC;IAChC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IAC9C,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;IAEhD,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACzE,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;IAC/B,OAAO,CAAC,CAAC;AACX,CAAC"}

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

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

package/dist/cli/commands/undo.js

@@ -0,0 +1,157 @@
+// `memex undo` — revert the most-recent applied plan, or list the journal.
+//
+// Exit codes:
+//   0  success (or nothing to undo, with informative message)
+//   1  undo failed mid-flight
+//   2  bad usage
+import { homedir } from "node:os";
+import { relative } from "node:path";
+import { listJournal, latestJournalEntry } from "../../core/journal.js";
+import { undoPlan } from "../../core/apply.js";
+function parseArgs(argv) {
+    const out = { list: false, json: false, dryRun: false, help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        switch (a) {
+            case "--list":
+                out.list = true;
+                break;
+            case "--json":
+                out.json = true;
+                break;
+            case "--id":
+                out.id = argv[++i];
+                break;
+            case "--journal-dir":
+                out.journalDir = argv[++i];
+                break;
+            case "--dry-run":
+                out.dryRun = true;
+                break;
+            case "--help":
+            case "-h":
+                out.help = true;
+                break;
+            default:
+                throw new Error(`unknown flag: ${a}`);
+        }
+    }
+    return out;
+}
+const HELP = `memex undo — revert the most recent applied plan
+
+Usage:
+  memex undo                Revert the most recent applied plan
+  memex undo --id <plan-id> Revert a specific plan (warn if not most recent)
+  memex undo --dry-run      Print what would be undone, change nothing
+  memex undo --list         Show the journal (newest first)
+  memex undo --list --json  Journal as JSON
+
+Flags:
+  --id <plan-id>      Revert a specific plan instead of the latest
+  --dry-run           Print what would change, write nothing
+  --list              Show the journal (newest first)
+  --json              (with --list) emit journal as JSON
+  --journal-dir PATH  Override journal location (default: ~/.claude/.memex/log/)
+
+Exit codes:
+  0   success, or nothing to undo (informative message)
+  1   undo failed mid-flight (run --list to see state)
+  2   bad usage
+
+Journal location: ~/.claude/.memex/log/
+`;
+function shortPath(p) {
+    const home = homedir();
+    if (p.startsWith(home))
+        return "~" + p.slice(home.length);
+    try {
+        const r = relative(process.cwd(), p);
+        return r.length < p.length ? r : p;
+    }
+    catch {
+        return p;
+    }
+}
+function summarizeEntry(e) {
+    const opCount = e.plan.ops.length;
+    const ok = e.ops.filter((a) => a.result === "success").length;
+    const fail = e.ops.filter((a) => a.result === "failure").length;
+    const undoMark = e.undoOf ? `  (undo of ${e.undoOf})` : "";
+    return `${e.plan.id}  ${e.status.padEnd(8)}  ${e.plan.label.padEnd(28)}  ${opCount} ops (${ok}✓ ${fail}✗)${undoMark}`;
+}
+export function runUndo(argv) {
+    let args;
+    try {
+        args = parseArgs(argv);
+    }
+    catch (err) {
+        process.stderr.write(`memex undo: ${err instanceof Error ? err.message : String(err)}\n\n${HELP}`);
+        return 2;
+    }
+    if (args.help) {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    const journalOpts = args.journalDir ? { journalDir: args.journalDir } : {};
+    // --list mode
+    if (args.list) {
+        const entries = listJournal(journalOpts);
+        if (args.json) {
+            process.stdout.write(`${JSON.stringify(entries, null, 2)}\n`);
+            return 0;
+        }
+        if (entries.length === 0) {
+            process.stdout.write("(journal is empty)\n");
+            return 0;
+        }
+        process.stdout.write("Journal (newest first):\n");
+        for (const e of entries)
+            process.stdout.write(`  ${summarizeEntry(e)}\n`);
+        return 0;
+    }
+    // Find target entry
+    const target = args.id ? null : latestJournalEntry(journalOpts);
+    if (!args.id && !target) {
+        process.stdout.write("Nothing to undo — journal is empty.\n");
+        return 0;
+    }
+    // Dry-run shows what would happen without writing.
+    if (args.dryRun) {
+        const t = args.id
+            ? listJournal(journalOpts).find((e) => e.plan.id === args.id)
+            : target;
+        if (!t) {
+            process.stderr.write(`memex undo: no journal entry with id "${args.id}"\n`);
+            return 2;
+        }
+        process.stdout.write(`Would undo: ${t.plan.label} (${t.plan.id})\n`);
+        const successOps = t.ops.filter((a) => a.result === "success");
+        process.stdout.write(`  ${successOps.length} successful op(s) would be reversed:\n`);
+        for (const a of successOps.slice().reverse()) {
+            const inv = a.inverse;
+            const pathInfo = "path" in inv ? `  ${shortPath(inv.path)}` : "";
+            process.stdout.write(`    ${inv.kind}${pathInfo}\n`);
+        }
+        return 0;
+    }
+    const { undone, newEntry } = undoPlan(args.id ?? "latest", {
+        ...journalOpts,
+        onProgress: (m) => process.stdout.write(`${m}\n`),
+    });
+    if (!undone) {
+        process.stderr.write(`memex undo: no journal entry with id "${args.id}"\n`);
+        return 2;
+    }
+    if (!newEntry) {
+        process.stdout.write(`Plan ${undone.plan.id} had no successful ops — nothing to reverse.\n`);
+        return 0;
+    }
+    if (newEntry.status === "complete") {
+        process.stdout.write(`✓ Undone: ${undone.plan.label} (was ${undone.plan.id}; recorded ${newEntry.plan.id})\n`);
+        return 0;
+    }
+    process.stderr.write(`✗ Undo failed mid-flight. Journal at ~/.claude/.memex/log/ — run \`memex undo --list\` for state.\n`);
+    return 1;
+}
+//# sourceMappingURL=undo.js.map

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

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

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+// Entrypoint for the `memex` CLI. Dispatches subcommands to keep the bin small.
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, "..", "..", "package.json"), "utf8"));
+const HELP = `memex ${pkg.version} — Claude Code memory curator
+
+Usage:
+  memex <command> [options]
+
+Commands:
+  list            List memories across all projects
+  lint            Report structural problems with memory files
+  doctor          Health snapshot of your memory tree (run weekly)
+  dedupe          Find duplicate memories across projects
+  merge           Collapse a duplicate cluster down to its representative
+  promote         Promote a memory to ~/.claude/CLAUDE.md as a managed block
+  undo            Revert the most recent applied plan (memex's mutation log)
+  tui             Interactive three-pane browser
+  mcp             Run as an MCP server over stdio (for Claude Code plugins)
+  --version       Print version
+  --help          Show this help
+`;
+async function main(argv) {
+    const [cmd, ...rest] = argv;
+    if (!cmd || cmd === "--help" || cmd === "-h" || cmd === "help") {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    if (cmd === "--version" || cmd === "-v") {
+        process.stdout.write(`${pkg.version}\n`);
+        return 0;
+    }
+    if (cmd === "list") {
+        const { runList } = await import("./commands/list.js");
+        return runList(rest);
+    }
+    if (cmd === "lint") {
+        const { runLint } = await import("./commands/lint.js");
+        return runLint(rest);
+    }
+    if (cmd === "doctor") {
+        const { runDoctorCli } = await import("./commands/doctor.js");
+        return runDoctorCli(rest);
+    }
+    if (cmd === "dedupe") {
+        const { runDedupe } = await import("./commands/dedupe.js");
+        return runDedupe(rest);
+    }
+    if (cmd === "undo") {
+        const { runUndo } = await import("./commands/undo.js");
+        return runUndo(rest);
+    }
+    if (cmd === "merge") {
+        const { runMerge } = await import("./commands/merge.js");
+        return runMerge(rest);
+    }
+    if (cmd === "promote") {
+        const { runPromote } = await import("./commands/promote.js");
+        return runPromote(rest);
+    }
+    if (cmd === "tui") {
+        const { runTui } = await import("./commands/tui.js");
+        return runTui(rest);
+    }
+    if (cmd === "mcp") {
+        const { runMcp } = await import("./commands/mcp.js");
+        return runMcp(rest);
+    }
+    process.stderr.write(`memex: unknown command "${cmd}"\n\n${HELP}`);
+    return 2;
+}
+// Setting process.exitCode (instead of calling process.exit) lets Node drain
+// stdout/stderr buffers before the process terminates. Calling process.exit()
+// with a piped stdout truncates output mid-write — broke `memex list --json |
+// jq` on large outputs (~275 KB stress fixture).
+main(process.argv.slice(2)).then((code) => {
+    process.exitCode = code;
+}, (err) => {
+    process.stderr.write(`memex: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

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

@@ -0,0 +1,8 @@
+import type { ProjectMemoryDir } from "../../core/types.js";
+interface AppProps {
+    projectsRoot?: string;
+    /** Initial data injection — used by tests to avoid disk reads. */
+    initialProjects?: ProjectMemoryDir[];
+}
+export declare function App({ projectsRoot, initialProjects }: AppProps): import("react/jsx-runtime").JSX.Element;
+export {};