@theglitchking/semantic-memory 1.1.0 → 1.2.0

package/dist/cli/index.js

@@ -3,8 +3,8 @@ import "../chunk-PZ5AY32C.js";
 
 // src/cli/index.ts
 import { program } from "commander";
-import { resolve as resolve2, join as join2, dirname, relative } from "path";
-import { existsSync as existsSync2, readFileSync, writeFileSync, rmSync } from "fs";
+import { resolve as resolve2, join as join3, dirname, relative } from "path";
+import { existsSync as existsSync3, readFileSync, writeFileSync, rmSync } from "fs";
 import { createRequire } from "module";
 import { spawnSync } from "child_process";
 import { registerUpdateCommands } from "@theglitchking/claude-plugin-runtime";
@@ -178,14 +178,106 @@ async function detectDrift(existing, toInstall) {
 }
 var SKILL_BUNDLER_AGENTS = ["claude", "codex", "copilot", "pi"];
 
+// src/cli/migrate-state.ts
+import { existsSync as existsSync2, mkdirSync, statSync, renameSync, unlinkSync } from "fs";
+import { join as join2 } from "path";
+var STATE_MIGRATIONS = [
+  { name: "mode", old: ".sidekick-mode", new: ".semantic-memory/mode" },
+  { name: "fingerprints", old: ".sidekick-fingerprints.json", new: ".semantic-memory/fingerprints.json" },
+  { name: "capture-pending", old: ".sidekick-capture-pending.json", new: ".semantic-memory/capture-pending.json" }
+];
+function migrateState(opts) {
+  const result = {
+    migrated: [],
+    skipped: [],
+    conflicts: []
+  };
+  const stateDir = join2(opts.projectRoot, ".claude", ".semantic-memory");
+  if (!opts.dryRun && !existsSync2(stateDir)) {
+    mkdirSync(stateDir, { recursive: true });
+  }
+  for (const m of STATE_MIGRATIONS) {
+    const oldPath = join2(opts.projectRoot, ".claude", m.old);
+    const newPath = join2(opts.projectRoot, ".claude", m.new);
+    const oldExists = existsSync2(oldPath);
+    const newExists = existsSync2(newPath);
+    if (!oldExists && !newExists) {
+      result.skipped.push({ name: m.name, status: "skipped-no-source", oldPath, newPath, detail: "neither path exists" });
+      continue;
+    }
+    if (!oldExists && newExists) {
+      result.skipped.push({ name: m.name, status: "skipped-already-migrated", oldPath, newPath, detail: "already at new path" });
+      continue;
+    }
+    if (oldExists && newExists) {
+      if (!opts.force) {
+        const oldMtime = safeMtime(oldPath);
+        const newMtime = safeMtime(newPath);
+        result.conflicts.push({
+          name: m.name,
+          status: "conflict",
+          oldPath,
+          newPath,
+          detail: `both paths exist (old: ${oldMtime}, new: ${newMtime}); pass --force to keep new and delete old`
+        });
+        continue;
+      }
+      if (!opts.dryRun) {
+        try {
+          unlinkSync(oldPath);
+        } catch (e) {
+          result.conflicts.push({ name: m.name, status: "conflict", oldPath, newPath, detail: `force-delete of old failed: ${e?.message ?? e}` });
+          continue;
+        }
+      }
+      result.migrated.push({
+        name: m.name,
+        status: "resolved-by-force",
+        oldPath,
+        newPath,
+        detail: opts.dryRun ? "dry-run: would delete old" : "old deleted; new preserved"
+      });
+      continue;
+    }
+    if (!opts.dryRun) {
+      try {
+        renameSync(oldPath, newPath);
+      } catch (e) {
+        result.conflicts.push({ name: m.name, status: "conflict", oldPath, newPath, detail: `rename failed: ${e?.message ?? e}` });
+        continue;
+      }
+    }
+    result.migrated.push({
+      name: m.name,
+      status: "migrated",
+      oldPath,
+      newPath,
+      detail: opts.dryRun ? "dry-run: would rename old to new" : "renamed"
+    });
+  }
+  return result;
+}
+function safeMtime(path) {
+  try {
+    return statSync(path).mtime.toISOString();
+  } catch {
+    return "unknown";
+  }
+}
+
 // src/cli/index.ts
 var require_ = createRequire(import.meta.url);
 var { version } = require_("../../package.json");
-var PKG_NAME = "@theglitchking/semantic-sidekick";
+var PKG_NAME = "@theglitchking/semantic-memory";
+var LEGACY_PKG_NAME = "@theglitchking/semantic-sidekick";
 function runRelink(cwd) {
-  const linker = join2(cwd, "node_modules", "@theglitchking", "semantic-sidekick", "scripts", "link-skills.js");
-  const script = existsSync2(linker) ? linker : resolve2(process.cwd(), "scripts", "link-skills.js");
-  if (!existsSync2(script)) {
+  const candidates = [
+    join3(cwd, "node_modules", "@theglitchking", "semantic-memory", "scripts", "link-skills.js"),
+    join3(cwd, "node_modules", "@theglitchking", "semantic-sidekick", "scripts", "link-skills.js"),
+    resolve2(process.cwd(), "scripts", "link-skills.js")
+  ];
+  const script = candidates.find((p) => existsSync3(p));
+  if (!script) {
     console.error("link-skills.js not found \u2014 is the package installed?");
     return;
   }
@@ -196,8 +288,14 @@ function runRelink(cwd) {
   });
 }
 function findLocalBin(cwd) {
-  const p = join2(cwd, "node_modules", "@theglitchking", "semantic-sidekick", "bin", "semantic-sidekick");
-  return existsSync2(p) ? p : null;
+  const candidates = [
+    join3(cwd, "node_modules", "@theglitchking", "semantic-memory", "bin", "semantic-memory"),
+    join3(cwd, "node_modules", "@theglitchking", "semantic-sidekick", "bin", "semantic-sidekick")
+  ];
+  for (const p of candidates) {
+    if (existsSync3(p)) return p;
+  }
+  return null;
 }
 function localBinArg(cwd) {
   const abs = findLocalBin(cwd);
@@ -217,7 +315,9 @@ function isNpxForm(entry) {
   if (!entry || typeof entry !== "object") return false;
   const cmd = entry.command;
   const args = Array.isArray(entry.args) ? entry.args : [];
-  return cmd === "npx" && args.some((a) => typeof a === "string" && a.includes(PKG_NAME));
+  return cmd === "npx" && args.some(
+    (a) => typeof a === "string" && (a.includes(PKG_NAME) || a.includes(LEGACY_PKG_NAME))
+  );
 }
 function extractNotesPath(entry) {
   const args = Array.isArray(entry?.args) ? entry.args : [];
@@ -390,7 +490,7 @@ var TOOL_CATEGORIES = {
 function printToolList() {
   console.log("\nSemantic Pages \u2014 21 MCP Tools\n");
   console.log("Usage: These tools are available via MCP when the server is running.");
-  console.log("       Run `semantic-sidekick tools <name>` for details on a specific tool.\n");
+  console.log("       Run `semantic-memory tools <name>` for details on a specific tool.\n");
   for (const [category, tools] of Object.entries(TOOL_CATEGORIES)) {
     console.log(`  ${category}:`);
     for (const name of tools) {
@@ -399,13 +499,13 @@ function printToolList() {
     }
     console.log();
   }
-  console.log("Run `semantic-sidekick tools <tool-name>` for arguments and examples.");
+  console.log("Run `semantic-memory tools <tool-name>` for arguments and examples.");
 }
 function printToolDetail(name) {
   const tool = TOOL_HELP[name];
   if (!tool) {
     console.error(`Unknown tool: ${name}`);
-    console.error(`Run \`semantic-sidekick tools\` to see all available tools.`);
+    console.error(`Run \`semantic-memory tools\` to see all available tools.`);
     process.exit(1);
   }
   console.log(`
@@ -508,7 +608,7 @@ program.command("tools [name]").description("List all MCP tools, or show details
 });
 program.command("serve", { isDefault: true }).description("Start the MCP server (default command)").requiredOption("--notes <path>", "Path to markdown notes directory").option("--reindex", "Force full reindex and exit").option("--stats", "Show vault statistics and exit").option("--wait-for-ready", "Block startup until index is fully built before serving (default: index in background; tools return 'Indexing in progress' until ready)").option("--read-only", "Suppress write tools (create_note, update_note, delete_note, move_note, update_frontmatter, manage_tags, rename_tag) \u2014 use for shared docs vaults owned by another tool").option("--model <name>", "Embedding model to use (default: all-MiniLM-L6-v2, fast; use nomic-ai/nomic-embed-text-v1.5 for higher quality)").option("--workers <n>", "Number of worker threads for parallel embedding", parseInt).option("--batch-size <n>", "Texts per ONNX forward pass (default: 8)", parseInt).option("--no-quantized", "Use full-precision model instead of quantized (slower, slightly higher quality)").option("--no-watch", "Disable file watcher").action(async (opts) => {
   const notesPath = resolve2(opts.notes);
-  if (!existsSync2(notesPath)) {
+  if (!existsSync3(notesPath)) {
     console.error(`Error: notes directory not found: ${notesPath}`);
     process.exit(1);
   }
@@ -552,16 +652,16 @@ program.command("serve", { isDefault: true }).description("Start the MCP server
 });
 registerUpdateCommands(program, {
   packageName: PKG_NAME,
-  pluginName: "semantic-sidekick",
-  configFile: "semantic-sidekick.json",
+  pluginName: "semantic-memory",
+  configFile: "semantic-memory.json",
   onAfterUpdate: (cwd) => runRelink(cwd)
 });
 program.command("normalize-config").description(
   "Rewrite fragile `npx @latest` entries in .mcp.json to the stable node-against-node_modules form (with backup and validation)"
 ).option("--dry-run", "print the proposed changes but don't write").action((opts) => {
   const cwd = process.cwd();
-  const mcpPath = join2(cwd, ".mcp.json");
-  if (!existsSync2(mcpPath)) {
+  const mcpPath = join3(cwd, ".mcp.json");
+  if (!existsSync3(mcpPath)) {
     console.log("no .mcp.json in current directory \u2014 nothing to do");
     process.exit(0);
   }
@@ -573,8 +673,8 @@ program.command("normalize-config").description(
   const bin = localBinArg(cwd);
   if (!bin) {
     console.error(
-      `no local install found at ./node_modules/@theglitchking/semantic-sidekick/bin/semantic-sidekick.
-run 'npm install --save @theglitchking/semantic-sidekick' first, then re-run this command.`
+      `no local install found at ./node_modules/@theglitchking/semantic-memory/bin/semantic-memory (or the legacy semantic-sidekick path).
+run 'npm install --save @theglitchking/semantic-memory' first, then re-run this command.`
     );
     process.exit(1);
   }
@@ -601,7 +701,7 @@ run 'npm install --save @theglitchking/semantic-sidekick' first, then re-run thi
     console.log("--- (dry-run; no changes written)");
     process.exit(0);
   }
-  const bakPath = join2(dirname(mcpPath), ".mcp.json.bak");
+  const bakPath = join3(dirname(mcpPath), ".mcp.json.bak");
   try {
     writeFileSync(bakPath, readFileSync(mcpPath, "utf8"));
     console.log(`backup written: ${bakPath}`);
@@ -627,12 +727,12 @@ program.command("healthcheck").description(
   const cwd = process.cwd();
   const bin = findLocalBin(cwd);
   if (!bin) {
-    console.error(`no local install at ./node_modules/@theglitchking/semantic-sidekick/bin/semantic-sidekick`);
-    console.error(`run 'npm install --save @theglitchking/semantic-sidekick' to install.`);
+    console.error(`no local install at ./node_modules/@theglitchking/semantic-memory/bin/semantic-memory (or legacy semantic-sidekick path)`);
+    console.error(`run 'npm install --save @theglitchking/semantic-memory' to install.`);
     process.exit(1);
   }
-  const mcpPath = join2(cwd, ".mcp.json");
-  if (existsSync2(mcpPath)) {
+  const mcpPath = join3(cwd, ".mcp.json");
+  if (existsSync3(mcpPath)) {
     const data = readJsonSafe(mcpPath);
     const entries = data?.mcpServers && typeof data.mcpServers === "object" ? Object.entries(data.mcpServers) : [];
     const fragile = entries.filter(([, e]) => isNpxForm(e)).map(([k]) => k);
@@ -641,7 +741,7 @@ program.command("healthcheck").description(
         `\u26A0\uFE0F  .mcp.json uses the fragile npx-@latest form for: ${fragile.join(", ")}`
       );
       console.warn(`   Rewrite to the stable form:`);
-      console.warn(`     npx --no @theglitchking/semantic-sidekick normalize-config`);
+      console.warn(`     npx --no @theglitchking/semantic-memory normalize-config`);
     }
   }
   const r = spawnSync("node", [bin, "--version"], { cwd, stdio: "pipe", timeout: 15e3 });
@@ -678,10 +778,10 @@ ${r2.stderr?.toString() || ""}`);
 });
 var driftHealthcheckActionPostprocess = async (opts) => {
   try {
-    const { runHealthcheck, formatDriftBanner } = await import("../healthcheck-DCFGPI7M.js");
+    const { runHealthcheck, formatDriftBanner } = await import("../healthcheck-7YOPNDXN.js");
     const projectRoot = process.cwd();
-    const vaultCandidate = join2(projectRoot, ".claude", ".vault");
-    const vaultPath = existsSync2(vaultCandidate) ? vaultCandidate : void 0;
+    const vaultCandidate = join3(projectRoot, ".claude", ".vault");
+    const vaultPath = existsSync3(vaultCandidate) ? vaultCandidate : void 0;
     const result = await runHealthcheck({
       projectRoot,
       vaultPath,
@@ -728,8 +828,8 @@ function parseScope(input) {
 }
 function findSourceRoot() {
   for (const pkg of ["semantic-memory", "semantic-sidekick"]) {
-    const installed = join2(process.cwd(), "node_modules", "@theglitchking", pkg);
-    if (existsSync2(installed)) return installed;
+    const installed = join3(process.cwd(), "node_modules", "@theglitchking", pkg);
+    if (existsSync3(installed)) return installed;
   }
   const dev = resolve2(new URL("../../", import.meta.url).pathname);
   return dev;
@@ -778,5 +878,26 @@ skillsCmd.command("list").description("List the skill bundles shipped with this
   const shipped = await listShippedSkills(sourceRoot);
   console.log(JSON.stringify(shipped.map((s) => s.name), null, 2));
 });
+program.command("migrate-state").description(
+  "Move legacy .claude/.sidekick-* state files to .claude/.semantic-memory/. Idempotent. Conflicts (both paths exist) require --force. Pass --dry-run to preview without changes."
+).option("--dry-run", "Print the planned migration without renaming any files.", false).option(
+  "--force",
+  "When both old and new paths exist, prefer the new path and delete the old one.",
+  false
+).option("--project <path>", "Project root (default: cwd)", process.cwd()).action((opts) => {
+  const result = migrateState({
+    projectRoot: opts.project,
+    dryRun: opts.dryRun === true,
+    force: opts.force === true
+  });
+  console.log(JSON.stringify(result, null, 2));
+  if (result.conflicts.length > 0 && !opts.force && !opts.dryRun) {
+    console.error(
+      `
+${result.conflicts.length} conflict${result.conflicts.length === 1 ? "" : "s"} detected. Re-run with --force to resolve (keeps new path, deletes old).`
+    );
+    process.exit(1);
+  }
+});
 program.parse();
 //# sourceMappingURL=index.js.map