@jefuriiij/synthra 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -7,6 +7,36 @@ For older versions, see [GitHub Releases](https://github.com/jefuriiij/synthra/r
 
 ---
 
+## [0.14.0] — 2026-07-02
+
+### Added
+
+- **`syn remove [path]` — cleanly uninstall Synthra from a project.** Ran `syn .`
+  in the wrong folder, or just want Synthra out of a repo? `syn remove` reverses
+  the bootstrap: deletes `.synthra-graph/` and `.synthra/`, strips the policy
+  block from `CLAUDE.md`, Synthra's entries from `.gitignore`, its hooks from
+  `.claude/` — **your own content in those files survives**; a file is deleted
+  only when nothing else remains. Also deregisters the MCP entry (with a direct
+  `.mcp.json` fallback when the `claude` CLI isn't available) and removes the
+  project from the dashboard registry. Shows a summary and asks `[y/N]` first;
+  pass `--yes` to skip (required when not running in a terminal).
+
+---
+
+## [0.13.1] — 2026-06-24
+
+### Fixed
+
+- **Minified/bundle files are no longer indexed.** Committed vendored plugin JS
+  (`*.min.js`, `*.bundle.js`, `*.min.css`, …) has no readable symbols, so indexing
+  it only polluted retrieval and caused **useless Moat blocks** on markup-heavy
+  projects — a Grep for CSS classes like `nav|menu|toggle` would spuriously match a
+  symbol *inside* the minified library and get blocked, only for `graph_continue` to
+  then find nothing. The scanner now skips these files (cleaner retrieval, smaller
+  graph, no behavior change for real source).
+
+---
+
 ## [0.13.0] — 2026-06-24
 
 ### Added

package/README.md

@@ -108,6 +108,10 @@ syn . --resume <id>       # Resume a Claude session (requires --launch-cli).
 syn scan [path]           # Scan only — walk + parse + write graph.
 syn serve [path]          # Start the MCP server only.
 syn dashboard [path]      # Run only the token dashboard (standalone process).
+syn doctor [path]         # Diagnose this project's Synthra setup + environment.
+syn remove [path]         # Uninstall Synthra from a project (accidental `syn .`?
+                          # This reverses it). Asks [y/N]; --yes to skip. Your own
+                          # gitignore lines / CLAUDE.md content / hooks survive.
 ```
 
 ---

package/dist/cli/index.js

@@ -18,7 +18,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@jefuriiij/synthra",
-      version: "0.13.0",
+      version: "0.14.0",
       publishConfig: {
         access: "public"
       },
@@ -109,7 +109,7 @@ var init_package = __esm({
 // src/cli/index.ts
 init_package();
 import sade from "sade";
-import { resolve as resolve5 } from "path";
+import { resolve as resolve6 } from "path";
 
 // src/dashboard/server.ts
 init_package();
@@ -151,10 +151,10 @@ async function findFreePort(start = PORT_RANGE_START, end = PORT_RANGE_END) {
   throw new Error(`Synthra: no free port in ${start}-${end}`);
 }
 function isFree(port) {
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     const s = createServer();
-    s.once("error", () => resolve6(false));
-    s.once("listening", () => s.close(() => resolve6(true)));
+    s.once("error", () => resolve7(false));
+    s.once("listening", () => s.close(() => resolve7(true)));
     s.listen(port, "127.0.0.1");
   });
 }
@@ -436,8 +436,8 @@ function foldEvent(store, ev) {
 function effectiveScores(store, nowMs) {
   const hl = halfLifeMs();
   const out = /* @__PURE__ */ new Map();
-  for (const [path, stat6] of Object.entries(store.files)) {
-    const eff = stat6.decayed * decayFactor(stat6.lastTs, nowMs, hl);
+  for (const [path, stat7] of Object.entries(store.files)) {
+    const eff = stat7.decayed * decayFactor(stat7.lastTs, nowMs, hl);
     if (eff > 0.01) out.set(path, eff);
   }
   return out;
@@ -607,6 +607,23 @@ async function recordProject(projectRoot) {
   } catch {
   }
 }
+async function forgetProject(projectRoot, registryPath = REGISTRY_PATH) {
+  try {
+    const raw = await readFile3(registryPath, "utf8");
+    const parsed = JSON.parse(raw);
+    const projects = Array.isArray(parsed.projects) ? parsed.projects : [];
+    const filtered = projects.filter((p) => p.path !== projectRoot);
+    if (filtered.length === projects.length) return false;
+    const next = {
+      schema_version: parsed.schema_version ?? SCHEMA_VERSION,
+      projects: filtered
+    };
+    await writeFile2(registryPath, JSON.stringify(next, null, 2) + "\n", "utf8");
+    return true;
+  } catch {
+    return false;
+  }
+}
 async function listProjects() {
   const registry = await readRegistry();
   return registry.projects.slice().sort((a, b) => a.last_seen > b.last_seen ? -1 : a.last_seen < b.last_seen ? 1 : 0);
@@ -894,8 +911,8 @@ async function startDashboard(paths, preferredPort = 8901) {
     port,
     url: `http://127.0.0.1:${port}`,
     async stop() {
-      await new Promise((resolve6, reject) => {
-        nodeServer.close((err2) => err2 ? reject(err2) : resolve6());
+      await new Promise((resolve7, reject) => {
+        nodeServer.close((err2) => err2 ? reject(err2) : resolve7());
       });
     }
   };
@@ -905,6 +922,22 @@ async function startDashboard(paths, preferredPort = 8901) {
 import { mkdir as mkdir3, readFile as readFile5, writeFile as writeFile3 } from "fs/promises";
 import { dirname as dirname4, join as join4 } from "path";
 
+// src/hooks/hooks-config.ts
+var SYNTHRA_HOOK_MARKER = "synthra-hook=true";
+function stripOurHooks(config) {
+  if (!config.hooks) return config;
+  const next = {};
+  for (const [event, entries] of Object.entries(config.hooks)) {
+    const filtered = entries.map((entry) => ({
+      ...entry,
+      hooks: (entry.hooks ?? []).filter((h) => h.meta !== SYNTHRA_HOOK_MARKER)
+    })).filter((entry) => (entry.hooks?.length ?? 0) > 0);
+    if (filtered.length) next[event] = filtered;
+  }
+  config.hooks = next;
+  return config;
+}
+
 // src/hooks/scripts/pre-compact.ps1
 var pre_compact_default = '# PreCompact hook \u2014 Windows PowerShell.\n# Re-injects the primer after Claude auto-compacts. Same logic as prime.ps1.\n\n$ErrorActionPreference = "SilentlyContinue"\n\n$portFile = Join-Path $PWD ".synthra-graph\\mcp_port"\nif (-not (Test-Path $portFile)) { exit 0 }\n$port = (Get-Content -Path $portFile -Raw).Trim()\nif (-not $port) { exit 0 }\n\ntry {\n    $resp = Invoke-RestMethod -Uri "http://127.0.0.1:$port/prime" -Method GET -TimeoutSec 3\n    if ($resp.primer) { Write-Output $resp.primer }\n} catch {\n    # silent\n}\nexit 0\n';
 
@@ -1195,7 +1228,6 @@ var SCRIPTS = [
   { event: "PreCompact", baseName: "synthra-pre-compact", ps1: pre_compact_default, sh: pre_compact_default2 },
   { event: "Stop", baseName: "synthra-stop", ps1: stop_default, sh: stop_default2 }
 ];
-var SYNTHRA_HOOK_MARKER = "synthra-hook=true";
 function commandFor(scriptPath) {
   if (process.platform === "win32") {
     return `powershell.exe -ExecutionPolicy Bypass -NoProfile -File "${scriptPath}"`;
@@ -1216,19 +1248,6 @@ async function readSettings(path) {
     return {};
   }
 }
-function stripOurHooks(config) {
-  if (!config.hooks) return config;
-  const next = {};
-  for (const [event, entries] of Object.entries(config.hooks)) {
-    const filtered = entries.map((entry) => ({
-      ...entry,
-      hooks: (entry.hooks ?? []).filter((h) => h.meta !== SYNTHRA_HOOK_MARKER)
-    })).filter((entry) => (entry.hooks?.length ?? 0) > 0);
-    if (filtered.length) next[event] = filtered;
-  }
-  config.hooks = next;
-  return config;
-}
 function mergeOurHooks(config, paths) {
   const hooks = config.hooks = config.hooks ?? {};
   for (const s of SCRIPTS) {
@@ -2890,7 +2909,17 @@ var DEFAULT_IGNORE = [
   ".mypy_cache/",
   ".ruff_cache/",
   // .NET
-  "obj/"
+  "obj/",
+  // Generated / minified bundles — no readable symbols, so indexing them only
+  // pollutes retrieval (a markup query like `nav|menu|toggle` spuriously matches
+  // a symbol inside vendored plugin JS → a useless Moat block) and bloats the
+  // graph. Committed bootstrap/swiper-style plugin JS is the common offender.
+  "*.min.js",
+  "*.min.cjs",
+  "*.min.mjs",
+  "*.min.css",
+  "*.bundle.js",
+  "*-min.js"
 ];
 var BINARY_EXTS = /* @__PURE__ */ new Set([
   ".png",
@@ -3021,6 +3050,9 @@ var POLICY_VERSION = 8;
 var POLICY_BEGIN = `<!-- synthra-policy v${POLICY_VERSION} BEGIN -->`;
 var POLICY_END = `<!-- synthra-policy v${POLICY_VERSION} END -->`;
 var ANY_BLOCK_RE = /<!--\s*synthra-policy\s+v\d+\s+BEGIN\s*-->[\s\S]*?<!--\s*synthra-policy\s+v\d+\s+END\s*-->\s*/g;
+function stripPolicyBlock(content) {
+  return content.replace(ANY_BLOCK_RE, "");
+}
 function policyBlock() {
   return [
     POLICY_BEGIN,
@@ -4728,11 +4760,11 @@ function buildDepsFooter(symbol, graph, maxChars = loadConfig().readDepsMaxChars
       callerIds.push(e.from);
     }
   }
-  const resolve6 = (ids) => ids.map((id) => symById.get(id)).filter((n) => !!n);
-  const callees = resolve6(calleeIds).sort(
+  const resolve7 = (ids) => ids.map((id) => symById.get(id)).filter((n) => !!n);
+  const callees = resolve7(calleeIds).sort(
     (a, b) => a.file === b.file ? a.start_line - b.start_line : a.file < b.file ? -1 : 1
   );
-  const callers = resolve6(callerIds);
+  const callers = resolve7(callerIds);
   if (callees.length === 0 && callers.length === 0) return "";
   const lines = [];
   let used = 0;
@@ -4759,10 +4791,10 @@ function buildDepsFooter(symbol, graph, maxChars = loadConfig().readDepsMaxChars
     let cUsed = used + sep3 + head.length;
     for (const c of callers.slice(0, DEPS_MAX_CALLERS)) {
       const part = `${c.name} \u2192 ${c.file}`;
-      const join13 = shown.length > 0 ? 3 : 0;
-      if (cUsed + join13 + part.length > maxChars) break;
+      const join14 = shown.length > 0 ? 3 : 0;
+      if (cUsed + join14 + part.length > maxChars) break;
       shown.push(part);
-      cUsed += join13 + part.length;
+      cUsed += join14 + part.length;
     }
     if (lines.length > 0) lines.push("");
     if (shown.length > 0) {
@@ -5818,8 +5850,8 @@ async function startServer(paths, options = {}) {
       await fileWatcher.stop().catch(() => void 0);
       await gitWatcher.stop().catch(() => void 0);
       await ctx.learn?.flush().catch(() => void 0);
-      await new Promise((resolve6, reject) => {
-        nodeServer.close((err2) => err2 ? reject(err2) : resolve6());
+      await new Promise((resolve7, reject) => {
+        nodeServer.close((err2) => err2 ? reject(err2) : resolve7());
       });
     }
   };
@@ -6062,6 +6094,10 @@ async function doctorCommand(rawPath) {
   log.info("");
 }
 
+// src/cli/remove-command.ts
+import { readFile as readFile20, readdir as readdir4, rm, rmdir, stat as stat5, unlink, writeFile as writeFile13 } from "fs/promises";
+import { basename as basename6, join as join13, resolve as resolve4 } from "path";
+
 // src/cli/self-update.ts
 import { mkdir as mkdir15, readFile as readFile19, writeFile as writeFile12 } from "fs/promises";
 import { homedir as homedir4 } from "os";
@@ -6137,15 +6173,15 @@ async function writeLastSeen(version) {
   }
 }
 function npmGlobalRoot() {
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     const chunks = [];
     const proc = spawn2("npm", ["root", "-g"], { stdio: ["ignore", "pipe", "ignore"] });
     proc.stdout?.on("data", (c) => chunks.push(c));
-    proc.on("error", () => resolve6(null));
+    proc.on("error", () => resolve7(null));
     proc.on("exit", (code) => {
-      if (code !== 0) return resolve6(null);
+      if (code !== 0) return resolve7(null);
       const out = Buffer.concat(chunks).toString("utf8").trim();
-      resolve6(out || null);
+      resolve7(out || null);
     });
   });
 }
@@ -6208,12 +6244,12 @@ async function promptYesNo(question) {
   }
 }
 function runNpmUpdate() {
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     const proc = spawn2("npm", ["install", "-g", PKG_NAME + "@latest"], {
       stdio: "inherit"
     });
-    proc.on("error", () => resolve6(false));
-    proc.on("exit", (code) => resolve6(code === 0));
+    proc.on("error", () => resolve7(false));
+    proc.on("exit", (code) => resolve7(code === 0));
   });
 }
 async function promptForUpdateOrLog() {
@@ -6247,41 +6283,11 @@ async function promptForUpdateOrLog() {
   }
 }
 
-// src/cli/serve-command.ts
-import { resolve as resolve4 } from "path";
-import { stat as stat5 } from "fs/promises";
-async function serveCommand(rawPath) {
-  const projectRoot = resolve4(rawPath);
-  const paths = resolvePaths(projectRoot);
-  try {
-    await stat5(paths.infoGraph);
-  } catch {
-    log.error(`no graph found at ${paths.infoGraph}`);
-    log.error("run `syn scan` in this project first.");
-    process.exit(2);
-  }
-  const handle = await startServer(paths);
-  log.info(`MCP server listening on ${handle.url}`);
-  log.info(`port written to ${paths.mcpPort}`);
-  log.info("press Ctrl+C to stop.");
-  const shutdown = async (signal) => {
-    log.info(`received ${signal} \u2014 shutting down\u2026`);
-    try {
-      await handle.stop();
-    } catch (err2) {
-      log.error("shutdown error:", err2.message);
-    }
-    process.exit(0);
-  };
-  process.on("SIGINT", shutdown);
-  process.on("SIGTERM", shutdown);
-}
-
 // src/cli/start-claude.ts
 import spawn3 from "cross-spawn";
 var MCP_NAME = "synthra";
 function runClaude(bin, args, cwd, stdio = "pipe") {
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     const proc = spawn3(bin, args, {
       cwd,
       stdio: stdio === "inherit" ? "inherit" : ["ignore", "pipe", "pipe"]
@@ -6290,8 +6296,8 @@ function runClaude(bin, args, cwd, stdio = "pipe") {
     let stderr = "";
     proc.stdout?.on("data", (c) => stdout += String(c));
     proc.stderr?.on("data", (c) => stderr += String(c));
-    proc.on("error", () => resolve6({ code: -1, stdout, stderr: stderr || "claude not on PATH" }));
-    proc.on("exit", (code) => resolve6({ code: code ?? 0, stdout, stderr }));
+    proc.on("error", () => resolve7({ code: -1, stdout, stderr: stderr || "claude not on PATH" }));
+    proc.on("exit", (code) => resolve7({ code: code ?? 0, stdout, stderr }));
   });
 }
 async function registerMcp(bin, mcpPort, cwd) {
@@ -6325,6 +6331,233 @@ async function spawnClaude(bin, opts) {
   return result.code;
 }
 
+// src/cli/remove-command.ts
+var HOOK_BASENAMES = [
+  "synthra-prime",
+  "synthra-pre-tool-use",
+  "synthra-pre-compact",
+  "synthra-stop"
+];
+async function exists3(path) {
+  try {
+    await stat5(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function readIfExists(path) {
+  try {
+    return await readFile20(path, "utf8");
+  } catch {
+    return null;
+  }
+}
+function stripGitignoreEntries(content) {
+  const entries = new Set(GITIGNORE_ENTRIES.map((e) => e.entry));
+  const lines = content.split(/\r?\n/).filter((line) => {
+    const t = line.trim();
+    if (entries.has(t)) return false;
+    if (t.startsWith("# added by synthra")) return false;
+    return true;
+  });
+  return lines.join("\n");
+}
+async function removeSynthra(projectRootRaw) {
+  const projectRoot = resolve4(projectRootRaw);
+  const paths = resolvePaths(projectRoot);
+  const result = { removed: [], kept: [], skipped: [] };
+  for (const [label, dir] of [
+    [".synthra-graph/", paths.graphDir],
+    [".synthra/ (context store)", paths.contextDir]
+  ]) {
+    if (await exists3(dir)) {
+      await rm(dir, { recursive: true, force: true });
+      result.removed.push(label);
+    } else {
+      result.skipped.push(label);
+    }
+  }
+  const gitignore = await readIfExists(paths.gitignore);
+  if (gitignore === null) {
+    result.skipped.push(".gitignore");
+  } else {
+    const stripped = stripGitignoreEntries(gitignore);
+    if (stripped === gitignore) {
+      result.skipped.push(".gitignore (no synthra entries)");
+    } else if (stripped.trim().length === 0) {
+      await unlink(paths.gitignore);
+      result.removed.push(".gitignore (was synthra-only)");
+    } else {
+      await writeFile13(paths.gitignore, stripped.trimEnd() + "\n", "utf8");
+      result.kept.push(".gitignore (synthra entries stripped)");
+    }
+  }
+  const claudeMd = await readIfExists(paths.claudeMd);
+  if (claudeMd === null) {
+    result.skipped.push("CLAUDE.md");
+  } else {
+    const remainder = stripPolicyBlock(claudeMd);
+    if (remainder === claudeMd) {
+      result.skipped.push("CLAUDE.md (no synthra policy block)");
+    } else {
+      const pristine = onboardingSkeleton(basename6(projectRoot)).trim();
+      if (remainder.trim().length === 0 || remainder.trim() === pristine) {
+        await unlink(paths.claudeMd);
+        result.removed.push("CLAUDE.md (was synthra-generated)");
+      } else {
+        await writeFile13(paths.claudeMd, remainder.trimEnd() + "\n", "utf8");
+        result.kept.push("CLAUDE.md (policy block stripped, your content kept)");
+      }
+    }
+  }
+  let hooksRemoved = 0;
+  for (const base of HOOK_BASENAMES) {
+    for (const ext of [".ps1", ".sh"]) {
+      const p = join13(paths.claudeHooksDir, `${base}${ext}`);
+      if (await exists3(p)) {
+        await unlink(p);
+        hooksRemoved += 1;
+      }
+    }
+  }
+  if (hooksRemoved > 0) {
+    result.removed.push(`.claude/hooks/synthra-* (${hooksRemoved} script(s))`);
+    try {
+      if ((await readdir4(paths.claudeHooksDir)).length === 0) await rmdir(paths.claudeHooksDir);
+    } catch {
+    }
+  } else {
+    result.skipped.push(".claude/hooks/synthra-*");
+  }
+  const settingsRaw = await readIfExists(paths.claudeSettings);
+  if (settingsRaw === null) {
+    result.skipped.push(".claude/settings.local.json");
+  } else {
+    try {
+      const config = stripOurHooks(JSON.parse(settingsRaw));
+      if (config.hooks && Object.keys(config.hooks).length === 0) delete config.hooks;
+      if (Object.keys(config).length === 0) {
+        await unlink(paths.claudeSettings);
+        result.removed.push(".claude/settings.local.json (was synthra-only)");
+      } else {
+        await writeFile13(paths.claudeSettings, JSON.stringify(config, null, 2) + "\n", "utf8");
+        result.kept.push(".claude/settings.local.json (synthra hooks stripped)");
+      }
+    } catch {
+      result.skipped.push(".claude/settings.local.json (unparseable \u2014 left untouched)");
+    }
+  }
+  const mcpPath = join13(projectRoot, ".mcp.json");
+  const mcpRaw = await readIfExists(mcpPath);
+  if (mcpRaw === null) {
+    result.skipped.push(".mcp.json");
+  } else {
+    try {
+      const mcp = JSON.parse(mcpRaw);
+      const servers = mcp.mcpServers ?? {};
+      const hadSynthra = "synthra" in servers;
+      if (hadSynthra) delete servers.synthra;
+      const serversEmpty = Object.keys(servers).length === 0;
+      const onlyServersKey = Object.keys(mcp).length === 1 && "mcpServers" in mcp;
+      if (serversEmpty && onlyServersKey) {
+        await unlink(mcpPath);
+        result.removed.push(".mcp.json (was synthra-only)");
+      } else if (hadSynthra) {
+        await writeFile13(mcpPath, JSON.stringify(mcp, null, 2) + "\n", "utf8");
+        result.kept.push(".mcp.json (synthra entry removed)");
+      } else {
+        result.skipped.push(".mcp.json (no synthra entry)");
+      }
+    } catch {
+      result.skipped.push(".mcp.json (unparseable \u2014 left untouched)");
+    }
+  }
+  return result;
+}
+async function inventory(projectRoot, paths) {
+  const found = [];
+  if (await exists3(paths.graphDir)) found.push(".synthra-graph/  (graph + logs, machine-local)");
+  if (await exists3(paths.contextDir)) {
+    found.push(".synthra/  (context store \u2014 git-tracked project memory)");
+  }
+  const gitignore = await readIfExists(paths.gitignore);
+  if (gitignore?.includes("added by synthra")) found.push(".gitignore  (synthra entries)");
+  const claudeMd = await readIfExists(paths.claudeMd);
+  if (claudeMd?.includes("synthra-policy")) found.push("CLAUDE.md  (synthra policy block)");
+  const settings = await readIfExists(paths.claudeSettings);
+  if (settings?.includes("synthra-hook=true")) {
+    found.push(".claude/settings.local.json + hooks/synthra-*  (hooks)");
+  }
+  const mcp = await readIfExists(join13(projectRoot, ".mcp.json"));
+  if (mcp?.includes('"synthra"')) found.push(".mcp.json  (MCP registration)");
+  return found;
+}
+async function removeCommand(rawPath, opts = {}) {
+  const projectRoot = resolve4(rawPath);
+  const paths = resolvePaths(projectRoot);
+  const found = await inventory(projectRoot, paths);
+  if (found.length === 0) {
+    await forgetProject(projectRoot);
+    log.info(`nothing to remove \u2014 Synthra doesn't appear to be installed in ${projectRoot}`);
+    return;
+  }
+  log.info(`removing Synthra from ${projectRoot}`);
+  log.info("this will delete / strip:");
+  for (const f of found) log.info(`  \u2022 ${f}`);
+  if (!opts.yes) {
+    if (!process.stdin.isTTY) {
+      log.info("not a TTY \u2014 re-run with --yes to confirm removal.");
+      return;
+    }
+    const ok2 = await promptYesNo("[syn] Remove Synthra from this project? [y/N]: ");
+    if (!ok2) {
+      log.info("aborted \u2014 nothing was changed.");
+      return;
+    }
+  }
+  try {
+    await unregisterMcp(loadConfig().claudeBin, projectRoot);
+  } catch {
+  }
+  const result = await removeSynthra(projectRoot);
+  const forgot = await forgetProject(projectRoot);
+  for (const r of result.removed) log.info(`  removed  ${r}`);
+  for (const k of result.kept) log.info(`  kept     ${k}`);
+  if (forgot) log.info("  removed  dashboard registry entry");
+  log.info("done \u2014 Synthra is no longer installed in this project.");
+}
+
+// src/cli/serve-command.ts
+import { resolve as resolve5 } from "path";
+import { stat as stat6 } from "fs/promises";
+async function serveCommand(rawPath) {
+  const projectRoot = resolve5(rawPath);
+  const paths = resolvePaths(projectRoot);
+  try {
+    await stat6(paths.infoGraph);
+  } catch {
+    log.error(`no graph found at ${paths.infoGraph}`);
+    log.error("run `syn scan` in this project first.");
+    process.exit(2);
+  }
+  const handle = await startServer(paths);
+  log.info(`MCP server listening on ${handle.url}`);
+  log.info(`port written to ${paths.mcpPort}`);
+  log.info("press Ctrl+C to stop.");
+  const shutdown = async (signal) => {
+    log.info(`received ${signal} \u2014 shutting down\u2026`);
+    try {
+      await handle.stop();
+    } catch (err2) {
+      log.error("shutdown error:", err2.message);
+    }
+    process.exit(0);
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+}
+
 // src/cli/index.ts
 var VERSION2 = package_default.version;
 function printReadyBanner(info) {
@@ -6353,11 +6586,11 @@ function printReadyBanner(info) {
   log.info("");
 }
 function waitForSignal() {
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     const handler = (sig) => {
       process.off("SIGINT", handler);
       process.off("SIGTERM", handler);
-      resolve6(sig);
+      resolve7(sig);
     };
     process.on("SIGINT", handler);
     process.on("SIGTERM", handler);
@@ -6365,7 +6598,7 @@ function waitForSignal() {
 }
 async function defaultFlow(rawPath, opts) {
   const launchCli = opts["launch-cli"] === true;
-  const projectRoot = resolve5(rawPath);
+  const projectRoot = resolve6(rawPath);
   const paths = resolvePaths(projectRoot);
   const cfg = loadConfig();
   await runStartupChangelogCheck();
@@ -6433,6 +6666,12 @@ function buildProgram() {
   prog.command("doctor [path]", "Diagnose this project's Synthra setup + environment.").action(async (path) => {
     await doctorCommand(path ?? ".");
   });
+  prog.command(
+    "remove [path]",
+    "Remove Synthra from a project \u2014 deletes its state, strips hooks/policy/gitignore entries, deregisters MCP."
+  ).option("--yes", "Skip the confirmation prompt", false).action(async (path, opts) => {
+    await removeCommand(path ?? ".", { yes: opts.yes });
+  });
   return prog;
 }
 async function main(argv) {