sverklo 0.26.1 → 0.28.0

package/dist/bin/sverklo.js

@@ -50,7 +50,7 @@ if (command && command !== "--help" && command !== "-h") {
     const wantsHelp = args.slice(1).some((a) => a === "--help" || a === "-h");
     if (wantsHelp) {
         const HELP_BLURBS = {
-            init: "Set up sverklo in your project (.mcp.json + CLAUDE.md, auto-detects Claude Code/Cursor/Windsurf/Antigravity).",
+            init: "Set up sverklo in your project (.mcp.json + CLAUDE.md, auto-detects Claude Code/Cursor/Windsurf/Antigravity). With --global: one-time-per-machine setup — write SVERKLO_SNIPPET to ~/.claude/CLAUDE.md and ~/.codex/AGENTS.md, register the project, gitignore .sverklo/, import memories. Skips per-project boilerplate.",
             doctor: "Diagnose MCP setup issues. Run after `init` to verify the agent can reach sverklo.",
             audit: "Run codebase audit and emit a graded report. Flags: --format markdown|html|json|graph|arch|obsidian, --output PATH, --open, --badge, --publish.",
             "audit-diff": "Incremental architectural quality gate. Audits `git diff` for new cycles + fan-in spikes. Flags: --against REF, --fan-in-threshold N, --format human|json, --show-existing, --verbose. Exits 1 on regression.",
@@ -68,7 +68,7 @@ if (command && command !== "--help" && command !== "-h") {
             wakeup: "Print compressed project context (for system-prompt injection in non-MCP clients).",
             digest: "5-line summary of what changed in this project. Flags: --since 7d, --format markdown|plain.",
             receipt: "Token-spend receipt for your recent Claude Code sessions. Shows where tokens went and projected yearly cost. Flags: --since 7d, --format plain|json.",
-            memory: "Manage the memory store. Subcommands: show, edit, export.",
+            memory: "Manage the memory store. Subcommands: show, edit, import, export.",
             grammars: "Manage tree-sitter grammars for the SVERKLO_PARSER=tree-sitter opt-in path. Subcommands: install.",
             weights: "Inspect .sverklo.yaml weight rules. Subcommands: explain <path> — show which glob matched and the effective weight.",
             "audit-prompt": "Print a ready-to-paste codebase-audit prompt (hybrid agent workflow).",
@@ -117,12 +117,24 @@ if (command === "--version" || command === "-v" || command === "-V") {
     process.exit(0);
 }
 if (command === "init") {
-    // Parse flags: --auto-capture, --mine-chats
+    // Parse flags: --auto-capture, --mine-chats, --global
     const flags = args.filter((a) => a.startsWith("--"));
     const positional = args.filter((a) => !a.startsWith("--"));
     const autoCapture = flags.includes("--auto-capture");
     const mineChats = flags.includes("--mine-chats");
+    const isGlobal = flags.includes("--global");
     const projectPath = resolve(positional[1] || process.cwd());
+    if (isGlobal) {
+        // Issue #72 — one-time-per-machine setup. Writes SVERKLO_SNIPPET to
+        // global agent-instruction locations (~/.claude/CLAUDE.md, ~/.codex/AGENTS.md),
+        // registers the project, gitignores .sverklo/, imports memories.
+        // Skips per-project boilerplate (.mcp.json, project AGENTS.md/CLAUDE.md,
+        // .claude/settings.local.json, skills, copilot/antigravity/codex configs,
+        // doctor).
+        const { initGlobal } = await import("../src/init-global.js");
+        await initGlobal(projectPath, { mineChats });
+        process.exit(0);
+    }
     const { initProject } = await import("../src/init.js");
     await initProject(projectPath, { autoCapture, mineChats });
     // Auto-register in the global registry
@@ -857,7 +869,7 @@ if (command === "telemetry") {
         console.log("  os          darwin / linux / win32");
         console.log("  node_major  the Node major version sverklo is running on");
         console.log("  event       one of 17 fixed event types");
-        console.log("  tool        sverklo_* tool name (when applicable)");
+        console.log("  tool        sverklo tool name (when applicable)");
         console.log("  outcome     ok / error / timeout");
         console.log("  duration_ms tool execution time");
         console.log("");
@@ -1072,7 +1084,7 @@ if (command === "profile") {
             console.log(`             ${tools.map((t) => t.replace(/^sverklo_/, "")).join(", ")}`);
             console.log();
         }
-        console.log("  full        36 tools  (all sverklo_* tools — default)");
+        console.log("  full        36 tools  (every first-party sverklo tool — default)");
         console.log("\n  Set with: SVERKLO_PROFILE=core sverklo init");
         console.log("  Or in .sverklo.yaml: profile: core");
         console.log("  See: https://sverklo.com/blog/we-already-shipped-mcp-code-mode/\n");
@@ -1100,8 +1112,14 @@ if (command === "profile") {
         // Structured doc — use it directly. The --days window doesn't apply
         // to cumulative stats; we use the full lifetime instead, and tell
         // the user when the doc started accumulating.
+        //
+        // v0.28.0: canonicalize legacy `sverklo_*` names in historical stats
+        // files so they collapse onto the new short names (`sverklo_search`
+        // + `search` → `search`). Without this, a long-running user's stats
+        // would show duplicate rows after the rename.
         for (const [tool, stat] of Object.entries(structuredStats.tools)) {
-            counts[tool] = stat.calls;
+            const canon = tool.startsWith("sverklo_") ? tool.slice("sverklo_".length) : tool;
+            counts[canon] = (counts[canon] || 0) + stat.calls;
         }
         total = structuredStats.totalCalls;
         const sinceStr = new Date(structuredStats.startedAt).toISOString().slice(0, 10);
@@ -1122,7 +1140,10 @@ if (command === "profile") {
             process.exit(0);
         }
         for (const c of calls) {
-            const tool = String(c.detail.tool);
+            const raw = String(c.detail.tool);
+            // v0.28.0: collapse legacy `sverklo_*` rows onto canonical names so
+            // upgraded users don't see split-personality stats.
+            const tool = raw.startsWith("sverklo_") ? raw.slice("sverklo_".length) : raw;
             counts[tool] = (counts[tool] || 0) + 1;
         }
         total = calls.length;
@@ -1135,8 +1156,7 @@ if (command === "profile") {
     console.log("  " + "-".repeat(70));
     for (const [tool, n] of ranked) {
         const pct = ((n / total) * 100).toFixed(1) + "%";
-        const display = tool.startsWith("sverklo_") ? tool : tool;
-        console.log("  " + display.padEnd(38) + String(n).padStart(10) + pct.padStart(10));
+        console.log("  " + tool.padEnd(38) + String(n).padStart(10) + pct.padStart(10));
     }
     console.log("  " + "-".repeat(70));
     // Compute coverage for every named profile so the user can see the
@@ -1145,6 +1165,15 @@ if (command === "profile") {
     // of real usage calls fall outside the profile.
     const profileOrder = ["core", "nav", "review", "lean", "research"];
     const fits = [];
+    // v0.28.0: first-party tools no longer carry a `sverklo_` prefix, so
+    // "missing from profile" is anyone-not-in-profile minus the Zilliz
+    // compat aliases (recorded but not first-party).
+    const COMPAT_ALIASES = new Set([
+        "index_codebase",
+        "search_code",
+        "clear_index",
+        "get_indexing_status",
+    ]);
     for (const name of profileOrder) {
         const profileTools = PROFILES[name];
         if (!profileTools)
@@ -1155,7 +1184,7 @@ if (command === "profile") {
         for (const [tool, n] of ranked) {
             if (profileSet.has(tool))
                 covered += n;
-            else if (tool.startsWith("sverklo_"))
+            else if (!COMPAT_ALIASES.has(tool))
                 missing.push(tool);
         }
         fits.push({ name, size: profileTools.length, coveragePct: covered / total, missing });
@@ -2051,20 +2080,76 @@ if (command === "memory") {
     //   show    — print memory rows as markdown to stdout
     //   edit    — open memory rows in $EDITOR; round-trip content edits back
     //             to SQLite. Never deletes by omission.
+    //   import  — scan CLAUDE.md / .cursorrules / ADRs / git log into the
+    //             memory store. Wraps `importExistingMemories()`; useful
+    //             after `sverklo init --global` to retroactively pull in
+    //             a project's existing knowledge.
     const sub = args[1];
-    if (sub !== "export" && sub !== "show" && sub !== "edit") {
-        console.log(`\nsverklo memory — read, edit, and export the memory store\n\n` +
+    if (sub !== "export" && sub !== "show" && sub !== "edit" && sub !== "import") {
+        console.log(`\nsverklo memory — read, edit, import, and export the memory store\n\n` +
             `Subcommands:\n` +
             `  show     print all memories as markdown to stdout\n` +
             `  edit     open memories in $EDITOR; round-trip text edits back\n` +
+            `  import   scan CLAUDE.md / .cursorrules / ADRs / git log into the store\n` +
             `  export   write per-category .md files / JSON / push to Notion\n\n` +
             `Usage:\n` +
             `  sverklo memory show [--include-invalidated]\n` +
             `  sverklo memory edit [--editor PATH]\n` +
+            `  sverklo memory import [path] [--mine-chats]\n` +
             `  sverklo memory export --format markdown|notion|json --to PATH [flags]\n\n` +
             `Run \`sverklo memory <subcommand> --help\` for the full flag list.\n`);
         process.exit(0);
     }
+    if (sub === "import") {
+        // Issue #72 follow-up (HaleTom 2026-05-25): standalone CLI entry to
+        // `importExistingMemories()`. Useful for users who did global setup
+        // elsewhere and just want to pull a project's existing notes into
+        // the memory store without running the kitchen-sink `sverklo init`.
+        const flags = args.slice(2);
+        if (flags.includes("--help") || flags.includes("-h")) {
+            console.log(`\nsverklo memory import — scan project sources into the memory store\n\n` +
+                `Scans (in priority order):\n` +
+                `  CLAUDE.md, AGENTS.md, .cursorrules, .windsurfrules\n` +
+                `  docs/ARCHITECTURE.md, CONTRIBUTING.md\n` +
+                `  docs/adr/, docs/decisions/, adr/, decisions/  (every .md becomes a memory)\n` +
+                `  git log (last 50 conventional commits)\n\n` +
+                `Idempotent: re-imports skip duplicates by content hash.\n\n` +
+                `Usage:\n` +
+                `  sverklo memory import [path]    (default: current directory)\n` +
+                `  sverklo memory import . --mine-chats   (also scan Claude Code chat transcripts)\n`);
+            process.exit(0);
+        }
+        const positional = flags.filter((a) => !a.startsWith("--"));
+        const mineChats = flags.includes("--mine-chats");
+        const projectPath = resolve(positional[0] || process.cwd());
+        const { getProjectConfig } = await import("../src/utils/config.js");
+        const { Indexer } = await import("../src/indexer/indexer.js");
+        const { importExistingMemories } = await import("../src/memory/import.js");
+        const config = getProjectConfig(projectPath);
+        const indexer = new Indexer(config);
+        try {
+            const result = await importExistingMemories(indexer, projectPath, { mineChats });
+            if (result.imported > 0) {
+                console.log(`Imported ${result.imported} memories from:`);
+                for (const src of result.sources) {
+                    console.log(`  · ${src}`);
+                }
+                if (result.skipped > 0) {
+                    console.log(`(${result.skipped} duplicates skipped)`);
+                }
+            }
+            else {
+                const hint = mineChats
+                    ? "No CLAUDE.md, .cursorrules, ADRs, or matching Claude Code chats found — nothing imported."
+                    : "No CLAUDE.md, .cursorrules, or ADRs found — nothing imported.";
+                console.log(hint);
+            }
+        }
+        finally {
+            indexer.close();
+        }
+        process.exit(0);
+    }
     if (sub === "show") {
         // Render every active memory as markdown to stdout. AI Edge's
         // "open Memory.md and read it" workflow, but driven by SQLite —