@ijfw/install 1.5.6 → 1.6.1

package/dist/uninstall.js

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
 
 // src/uninstall.js
-import { existsSync as existsSync2, rmSync, cpSync, mkdtempSync, readFileSync as readFileSync2, writeFileSync as writeFileSync2, renameSync as renameSync2, unlinkSync as unlinkSync2, readdirSync } from "node:fs";
-import { resolve as resolve2, join as join2 } from "node:path";
+import { existsSync as existsSync3, rmSync, cpSync, mkdtempSync, readFileSync as readFileSync3, writeFileSync as writeFileSync3, renameSync as renameSync2, unlinkSync as unlinkSync2, readdirSync as readdirSync2, realpathSync } from "node:fs";
+import { resolve as resolve2, join as join3, dirname as dirname2, basename } from "node:path";
 import { homedir as homedir2, tmpdir } from "node:os";
 import { spawnSync } from "node:child_process";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 // src/marketplace.js
 import { readFileSync, writeFileSync, renameSync, unlinkSync, existsSync, mkdirSync } from "node:fs";
@@ -94,10 +95,57 @@ function unmergeMarketplace(settingsPath = claudeSettingsPath()) {
   return settings;
 }
 
+// src/install-ledger.js
+import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2, readdirSync } from "node:fs";
+import { join as join2 } from "node:path";
+function ledgerPath(ijfwHome) {
+  return join2(ijfwHome, "install-ledger.json");
+}
+function readLedger(ijfwHome) {
+  try {
+    const raw = readFileSync2(ledgerPath(ijfwHome), "utf8");
+    const doc = JSON.parse(raw);
+    if (doc && Array.isArray(doc.createdDirs)) return doc;
+  } catch {
+  }
+  return { version: 1, createdDirs: [] };
+}
+function isEmptyDir(p) {
+  try {
+    return existsSync2(p) && readdirSync(p).length === 0;
+  } catch {
+    return false;
+  }
+}
+
 // src/uninstall.js
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname2(__filename);
+var REPO_ROOT = resolve2(__dirname, "..", "..");
+function resolveAiderTemplate(name, repoRoot) {
+  const root = repoRoot || REPO_ROOT;
+  const candidates = [
+    // (a) git clone: top-level aider/ under the (injected) repo root.
+    join3(root, "aider", name),
+    // (a') repo root with staged templates under installer/.
+    join3(root, "installer", "templates", "aider", name),
+    // (b) tarball/dist fallback: templates staged next to the package root.
+    //   dist/uninstall.js -> __dirname=<pkg>/dist -> <pkg>/templates/aider/<name>
+    //   src/uninstall.js  -> __dirname=<pkg>/src  -> <pkg>/templates/aider/<name>
+    //   (__dirname's parent is the package root in both layouts)
+    resolve2(__dirname, "..", "templates", "aider", name)
+  ];
+  for (const c of candidates) {
+    try {
+      if (existsSync3(c)) return c;
+    } catch {
+    }
+  }
+  return "";
+}
 function writeAtomic(target, content) {
   const tmp = `${target}.tmp.${process.pid}.${Date.now()}`;
-  writeFileSync2(tmp, content);
+  writeFileSync3(tmp, content);
   try {
     renameSync2(tmp, target);
   } catch (err) {
@@ -153,17 +201,65 @@ function confirm(question) {
 var HOME = homedir2();
 var TS = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").replace("T", "_").slice(0, 19);
 function backupFile(p) {
-  if (existsSync2(p)) {
+  if (existsSync3(p)) {
     const bak = p + ".bak." + TS;
     cpSync(p, bak);
     return bak;
   }
   return null;
 }
+function stripIjfwRegions(src) {
+  if (typeof src !== "string") return { text: src, changed: false };
+  const before = src;
+  let out = src;
+  const esc = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const regions = [
+    ["<!-- IJFW-MEMORY-START", "<!-- IJFW-MEMORY-END -->"],
+    ["<!-- IJFW-ROUTING-START", "<!-- IJFW-ROUTING-END -->"],
+    ["<!-- IJFW-AGENTS-START", "<!-- IJFW-AGENTS-END -->"],
+    ["<!-- IJFW-BLACKBOARD-START", "<!-- IJFW-BLACKBOARD-END -->"],
+    ["<!-- IJFW-DISCIPLINE-START", "<!-- IJFW-DISCIPLINE-END -->"]
+  ];
+  for (const [start, end] of regions) {
+    const re = new RegExp("\\n*" + esc(start) + "[\\s\\S]*?" + esc(end) + "[^\\n]*", "g");
+    out = out.replace(re, "");
+  }
+  out = out.replace(/\n*<!-- Auto-generated by IJFW from repo scan\.[^\n]*-->/g, "");
+  out = out.replace(/\n*(?:Four|Five) IJFW-managed regions live in this file\.[\s\S]*?IJFW will never touch it\./g, "");
+  out = out.replace(/\n{3,}/g, "\n\n").replace(/\s+$/, "");
+  if (out.length) out += "\n";
+  return { text: out, changed: out !== before };
+}
+function hasIjfwMarker(text) {
+  return /IJFW-MEMORY-START|IJFW-ROUTING-START|IJFW-AGENTS-START|IJFW-BLACKBOARD-START|IJFW-DISCIPLINE-START/.test(text);
+}
+function stripMarkerFile(p, opts = {}) {
+  try {
+    if (!existsSync3(p)) return null;
+    let text;
+    try {
+      text = readFileSync3(p, "utf8");
+    } catch {
+      return null;
+    }
+    if (!hasIjfwMarker(text)) return null;
+    const { text: stripped, changed } = stripIjfwRegions(text);
+    if (!changed) return null;
+    backupFile(p);
+    if (opts.deleteIfEmpty && stripped.trim() === "") {
+      rmSync(p, { force: true });
+      return `${opts.label || p}  (removed -- became empty after IJFW region strip)`;
+    }
+    writeAtomic(p, stripped);
+    return `${opts.label || p}  (stripped IJFW marker regions, user content preserved)`;
+  } catch {
+    return null;
+  }
+}
 function removeTomlSection(p) {
-  if (!existsSync2(p)) return false;
+  if (!existsSync3(p)) return false;
   backupFile(p);
-  const lines = readFileSync2(p, "utf8").split("\n");
+  const lines = readFileSync3(p, "utf8").split("\n");
   const out = [];
   let skip = false;
   for (const line of lines) {
@@ -178,10 +274,10 @@ function removeTomlSection(p) {
   return true;
 }
 function removeJsonMcpEntry(p) {
-  if (!existsSync2(p)) return false;
+  if (!existsSync3(p)) return false;
   let doc;
   try {
-    doc = JSON.parse(readFileSync2(p, "utf8"));
+    doc = JSON.parse(readFileSync3(p, "utf8"));
   } catch {
     return false;
   }
@@ -195,11 +291,87 @@ function removeJsonMcpEntry(p) {
   }
   return changed;
 }
+function removeNestedMcpEntry(p, keyPath) {
+  try {
+    if (!existsSync3(p)) return false;
+    let doc;
+    try {
+      doc = JSON.parse(readFileSync3(p, "utf8"));
+    } catch {
+      return false;
+    }
+    if (!doc || typeof doc !== "object") return false;
+    let node = doc;
+    for (const k of keyPath) {
+      if (!node[k] || typeof node[k] !== "object") return false;
+      node = node[k];
+    }
+    if (!node["ijfw-memory"]) return false;
+    backupFile(p);
+    delete node["ijfw-memory"];
+    writeAtomic(p, JSON.stringify(doc, null, 2) + "\n");
+    return true;
+  } catch {
+    return false;
+  }
+}
+function resolveClineSettingsPath(home) {
+  const H = home;
+  const APPDATA = process.env.APPDATA || join3(H, "AppData", "Roaming");
+  const ext = "saoudrizwan.claude-dev";
+  let userDirs;
+  if (process.platform === "darwin") {
+    userDirs = [
+      join3(H, "Library", "Application Support", "Code", "User"),
+      join3(H, "Library", "Application Support", "Code - Insiders", "User"),
+      join3(H, "Library", "Application Support", "VSCodium", "User")
+    ];
+  } else if (process.platform === "win32") {
+    userDirs = [
+      join3(APPDATA, "Code", "User"),
+      join3(APPDATA, "Code - Insiders", "User"),
+      join3(APPDATA, "VSCodium", "User")
+    ];
+  } else {
+    userDirs = [
+      join3(H, ".config", "Code", "User"),
+      join3(H, ".config", "VSCodium", "User"),
+      join3(H, ".var", "app", "com.visualstudio.code", "config", "Code", "User"),
+      join3(H, "snap", "code", "current", ".config", "Code", "User")
+    ];
+  }
+  for (const d of userDirs) {
+    const settings = join3(d, "globalStorage", ext, "settings", "cline_mcp_settings.json");
+    if (existsSync3(settings)) return settings;
+  }
+  return null;
+}
+function removeAiderFileIfPristine(installedPath, templatePath) {
+  try {
+    if (!existsSync3(installedPath)) return "absent";
+    if (!existsSync3(templatePath)) return "kept-modified";
+    let a, b;
+    try {
+      a = readFileSync3(installedPath);
+      b = readFileSync3(templatePath);
+    } catch {
+      return "kept-modified";
+    }
+    if (a.equals(b)) {
+      backupFile(installedPath);
+      rmSync(installedPath, { force: true });
+      return "removed";
+    }
+    return "kept-modified";
+  } catch {
+    return "kept-modified";
+  }
+}
 function removeCodexHooks(p) {
-  if (!existsSync2(p)) return false;
+  if (!existsSync3(p)) return false;
   let doc;
   try {
-    doc = JSON.parse(readFileSync2(p, "utf8"));
+    doc = JSON.parse(readFileSync3(p, "utf8"));
   } catch {
     return false;
   }
@@ -240,8 +412,8 @@ function removeCodexHooks(p) {
   return false;
 }
 function removeYamlMcpEntry(p) {
-  if (!existsSync2(p)) return false;
-  const raw = readFileSync2(p, "utf8");
+  if (!existsSync3(p)) return false;
+  const raw = readFileSync3(p, "utf8");
   if (!/\bijfw-memory\b/.test(raw)) return false;
   const py = spawnSync("python3", ["-c", `
 import sys, yaml
@@ -275,12 +447,74 @@ import os; os.replace(p + ".tmp", p)
   writeAtomic(p, stripped);
   return true;
 }
+function resolveShippedTemplate(rel, repoRoot) {
+  const root = repoRoot || REPO_ROOT;
+  const candidates = [
+    join3(root, rel),
+    join3(root, "installer", "templates", rel),
+    resolve2(__dirname, "..", "templates", rel)
+  ];
+  for (const c of candidates) {
+    try {
+      if (existsSync3(c)) return c;
+    } catch {
+    }
+  }
+  return "";
+}
+function removeHermesIjfwWiring(p) {
+  if (!existsSync3(p)) return false;
+  const raw = readFileSync3(p, "utf8");
+  if (!/\bijfw\b/i.test(raw)) return false;
+  const py = spawnSync("python3", ["-c", `
+import sys, yaml
+p = sys.argv[1]
+with open(p) as f: raw = f.read()
+doc = yaml.safe_load(raw) if raw.strip() else {}
+if not isinstance(doc, dict): sys.exit(2)
+changed = False
+srv = doc.get('mcp_servers')
+if isinstance(srv, dict) and 'ijfw-memory' in srv:
+    del srv['ijfw-memory']; changed = True
+    if not srv: del doc['mcp_servers']
+pl = doc.get('plugins')
+if isinstance(pl, dict) and isinstance(pl.get('enabled'), list) and 'ijfw' in pl['enabled']:
+    pl['enabled'] = [x for x in pl['enabled'] if x != 'ijfw']; changed = True
+    if not pl['enabled']: del pl['enabled']
+    if not pl: del doc['plugins']
+hk = doc.get('hooks')
+if isinstance(hk, dict):
+    for ev in list(hk.keys()):
+        items = hk[ev]
+        if isinstance(items, list):
+            new = [it for it in items if not (isinstance(it, dict) and 'ijfw' in str(it.get('script','')))]
+            if len(new) != len(items):
+                changed = True
+                if new: hk[ev] = new
+                else: del hk[ev]
+    if isinstance(doc.get('hooks'), dict) and not doc['hooks']: del doc['hooks']
+if not changed: sys.exit(3)
+with open(p + '.tmp', 'w') as f:
+    if doc: yaml.safe_dump(doc, f, sort_keys=False, default_flow_style=False)
+    else: f.write('')
+import os; os.replace(p + '.tmp', p)
+`, p], { encoding: "utf8" });
+  if (py.status === 0) {
+    backupFile(p);
+    return true;
+  }
+  const out = raw.replace(/# IJFW-MCP-BEGIN ijfw-memory\n[\s\S]*?# IJFW-MCP-END ijfw-memory\n/g, "").replace(/# IJFW-PLUGINS-BEGIN\n[\s\S]*?# IJFW-PLUGINS-END\n/g, "").replace(/# IJFW-HOOK-BEGIN pre_tool_use\n[\s\S]*?# IJFW-HOOK-END pre_tool_use\n/g, "").replace(/^[ \t]*-[ \t]+ijfw[ \t]*\n/gm, "").replace(/^[ \t]*-[ \t]+script:[ \t]*["']?plugins\/ijfw\/[^\n]*\n/gm, "");
+  if (out === raw) return false;
+  backupFile(p);
+  writeAtomic(p, out);
+  return true;
+}
 function removeIjfwSkills(dir) {
-  if (!existsSync2(dir)) return 0;
+  if (!existsSync3(dir)) return 0;
   let count = 0;
-  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+  for (const entry of readdirSync2(dir, { withFileTypes: true })) {
     if (entry.isDirectory() && entry.name.startsWith("ijfw-")) {
-      rmSync(join2(dir, entry.name), { recursive: true, force: true });
+      rmSync(join3(dir, entry.name), { recursive: true, force: true });
       count++;
     }
   }
@@ -311,79 +545,308 @@ var CODEX_COMMAND_FILES = [
   "workflow.md"
 ];
 function removeCodexCommands(dir) {
-  if (!existsSync2(dir)) return 0;
+  if (!existsSync3(dir)) return 0;
   let count = 0;
   for (const name of CODEX_COMMAND_FILES) {
-    const path = join2(dir, name);
-    if (existsSync2(path)) {
+    const path = join3(dir, name);
+    if (existsSync3(path)) {
       rmSync(path, { force: true });
       count++;
     }
   }
   return count;
 }
-function cleanPlatforms() {
+function removeCodexHookFiles(hooksDir) {
+  if (!existsSync3(hooksDir)) return 0;
+  let count = 0;
+  const scriptsDir = join3(hooksDir, "scripts");
+  if (existsSync3(scriptsDir)) {
+    rmSync(scriptsDir, { recursive: true, force: true });
+    count++;
+  }
+  let entries = [];
+  try {
+    entries = readdirSync2(hooksDir, { withFileTypes: true });
+  } catch {
+    return count;
+  }
+  for (const e of entries) {
+    if (!e.isFile() || !e.name.endsWith(".sh")) continue;
+    const p = join3(hooksDir, e.name);
+    let body = "";
+    try {
+      body = readFileSync3(p, "utf8");
+    } catch {
+      continue;
+    }
+    if (/\bIJFW\b/.test(body) || /\bijfw\b/.test(body)) {
+      rmSync(p, { force: true });
+      count++;
+    }
+  }
+  return count;
+}
+function removeKnownMarketplacesEntry(p) {
+  if (!existsSync3(p)) return false;
+  let doc;
+  try {
+    doc = JSON.parse(readFileSync3(p, "utf8"));
+  } catch {
+    return false;
+  }
+  if (!doc || typeof doc !== "object") return false;
+  let changed = false;
+  if (doc.ijfw) {
+    delete doc.ijfw;
+    changed = true;
+  }
+  if (doc.extraKnownMarketplaces && typeof doc.extraKnownMarketplaces === "object" && doc.extraKnownMarketplaces.ijfw) {
+    delete doc.extraKnownMarketplaces.ijfw;
+    if (Object.keys(doc.extraKnownMarketplaces).length === 0) delete doc.extraKnownMarketplaces;
+    changed = true;
+  }
+  if (!changed) return false;
+  backupFile(p);
+  writeAtomic(p, JSON.stringify(doc, null, 2) + "\n");
+  return true;
+}
+function cleanPlatforms(opts = {}) {
+  const home = opts.home || HOME;
+  const cwd = opts.cwd || process.cwd();
+  const repoRoot = opts.repoRoot || REPO_ROOT;
   const removed = [];
-  if (removeTomlSection(join2(HOME, ".codex", "config.toml"))) {
+  if (removeJsonMcpEntry(join3(home, ".claude", "settings.json"))) {
+    removed.push("~/.claude/settings.json  (removed ijfw-memory mcp entry)");
+  }
+  if (removeKnownMarketplacesEntry(join3(home, ".claude", "plugins", "known_marketplaces.json"))) {
+    removed.push("~/.claude/plugins/known_marketplaces.json  (removed ijfw entry)");
+  }
+  if (removeTomlSection(join3(home, ".codex", "config.toml"))) {
     removed.push("~/.codex/config.toml  (removed [mcp_servers.ijfw-memory])");
   }
-  if (removeCodexHooks(join2(HOME, ".codex", "hooks.json"))) {
+  if (removeCodexHooks(join3(home, ".codex", "hooks.json"))) {
     removed.push("~/.codex/hooks.json  (removed IJFW hook entries)");
   }
-  const codexSkills = removeIjfwSkills(join2(HOME, ".codex", "skills"));
+  const codexSkills = removeIjfwSkills(join3(home, ".codex", "skills"));
   if (codexSkills > 0) removed.push(`~/.codex/skills/ijfw-*  (removed ${codexSkills} skill dirs)`);
-  const codexCommands = removeCodexCommands(join2(HOME, ".codex", "commands"));
+  const codexCommands = removeCodexCommands(join3(home, ".codex", "commands"));
   if (codexCommands > 0) removed.push(`~/.codex/commands  (removed ${codexCommands} IJFW command aliases)`);
-  const codexMd = join2(HOME, ".codex", "IJFW.md");
-  if (existsSync2(codexMd)) {
+  const codexMd = join3(home, ".codex", "IJFW.md");
+  if (existsSync3(codexMd)) {
     rmSync(codexMd, { force: true });
     removed.push("~/.codex/IJFW.md");
   }
-  if (removeJsonMcpEntry(join2(HOME, ".gemini", "settings.json"))) {
+  const codexHookFiles = removeCodexHookFiles(join3(home, ".codex", "hooks"));
+  if (codexHookFiles > 0) removed.push(`~/.codex/hooks/  (removed ${codexHookFiles} IJFW hook scripts)`);
+  if (removeJsonMcpEntry(join3(home, ".gemini", "settings.json"))) {
     removed.push("~/.gemini/settings.json  (removed ijfw-memory)");
   }
-  const geminiExt = join2(HOME, ".gemini", "extensions", "ijfw");
-  if (existsSync2(geminiExt)) {
+  const geminiExt = join3(home, ".gemini", "extensions", "ijfw");
+  if (existsSync3(geminiExt)) {
     rmSync(geminiExt, { recursive: true, force: true });
     removed.push("~/.gemini/extensions/ijfw/");
   }
-  const cursorMcp = join2(".cursor", "mcp.json");
+  const cursorMcp = join3(cwd, ".cursor", "mcp.json");
   if (removeJsonMcpEntry(cursorMcp)) removed.push(".cursor/mcp.json  (removed ijfw-memory)");
-  if (removeJsonMcpEntry(join2(HOME, ".codeium", "windsurf", "mcp_config.json"))) {
+  if (removeJsonMcpEntry(join3(home, ".codeium", "windsurf", "mcp_config.json"))) {
     removed.push("~/.codeium/windsurf/mcp_config.json  (removed ijfw-memory)");
   }
-  const vscodeMcp = join2(".vscode", "mcp.json");
+  const vscodeMcp = join3(cwd, ".vscode", "mcp.json");
   if (removeJsonMcpEntry(vscodeMcp)) removed.push(".vscode/mcp.json  (removed ijfw-memory)");
-  if (removeYamlMcpEntry(join2(HOME, ".hermes", "config.yaml"))) {
-    removed.push("~/.hermes/config.yaml  (removed ijfw-memory)");
+  if (removeHermesIjfwWiring(join3(home, ".hermes", "config.yaml"))) {
+    removed.push("~/.hermes/config.yaml  (removed ijfw-memory + plugin + hook wiring)");
   }
-  const hermesSkills = removeIjfwSkills(join2(HOME, ".hermes", "skills"));
+  const hermesSkills = removeIjfwSkills(join3(home, ".hermes", "skills"));
   if (hermesSkills > 0) removed.push(`~/.hermes/skills/ijfw-*  (removed ${hermesSkills} skill dirs)`);
-  const hermesMd = join2(HOME, ".hermes", "HERMES.md");
-  if (existsSync2(hermesMd)) {
+  const hermesMd = join3(home, ".hermes", "HERMES.md");
+  if (existsSync3(hermesMd)) {
     rmSync(hermesMd, { force: true });
     removed.push("~/.hermes/HERMES.md");
   }
-  if (removeYamlMcpEntry(join2(HOME, ".wayland", "config.yaml"))) {
-    removed.push("~/.wayland/config.yaml  (removed ijfw-memory)");
+  const hermesPlugin = join3(home, ".hermes", "plugins", "ijfw");
+  if (existsSync3(hermesPlugin)) {
+    rmSync(hermesPlugin, { recursive: true, force: true });
+    removed.push("~/.hermes/plugins/ijfw/  (removed plugin tree)");
+  }
+  const waylandPluginDir = join3(home, ".wayland", "plugins", "ijfw");
+  if (existsSync3(waylandPluginDir)) {
+    rmSync(waylandPluginDir, { recursive: true, force: true });
+    removed.push("~/.wayland/plugins/ijfw/  (removed plugin.toml + hooks + MCP)");
   }
-  const waylandSkills = removeIjfwSkills(join2(HOME, ".wayland", "skills"));
+  if (removeYamlMcpEntry(join3(home, ".wayland", "config.yaml"))) {
+    removed.push("~/.wayland/config.yaml  (removed legacy ijfw-memory)");
+  }
+  const waylandSkills = removeIjfwSkills(join3(home, ".wayland", "skills"));
   if (waylandSkills > 0) removed.push(`~/.wayland/skills/ijfw-*  (removed ${waylandSkills} skill dirs)`);
-  const waylandMd = join2(HOME, ".wayland", "WAYLAND.md");
-  if (existsSync2(waylandMd)) {
+  const waylandMd = join3(home, ".wayland", "WAYLAND.md");
+  if (existsSync3(waylandMd)) {
     rmSync(waylandMd, { force: true });
     removed.push("~/.wayland/WAYLAND.md");
   }
+  if (removeJsonMcpEntry(join3(home, ".qwen", "settings.json"))) {
+    removed.push("~/.qwen/settings.json  (removed ijfw-memory)");
+  }
+  if (removeJsonMcpEntry(join3(home, ".kimi", "mcp.json"))) {
+    removed.push("~/.kimi/mcp.json  (removed ijfw-memory)");
+  }
+  if (removeJsonMcpEntry(join3(home, ".gemini", "antigravity", "mcp_config.json"))) {
+    removed.push("~/.gemini/antigravity/mcp_config.json  (removed ijfw-memory)");
+  }
+  if (removeJsonMcpEntry(join3(home, ".gemini", "config", "mcp_config.json"))) {
+    removed.push("~/.gemini/config/mcp_config.json  (removed ijfw-memory)");
+  }
+  if (removeNestedMcpEntry(join3(home, ".config", "opencode", "opencode.json"), ["mcp"])) {
+    removed.push("~/.config/opencode/opencode.json  (removed mcp.ijfw-memory)");
+  }
+  if (removeNestedMcpEntry(join3(home, ".openclaw", "openclaw.json"), ["mcp", "servers"])) {
+    removed.push("~/.openclaw/openclaw.json  (removed mcp.servers.ijfw-memory)");
+  }
+  const piPath = join3(home, ".pi", "agent", "AGENTS.md");
+  const piStatus = stripMarkerFile(piPath, { label: "~/.pi/agent/AGENTS.md" });
+  if (piStatus) {
+    removed.push(piStatus);
+  } else {
+    const piPristine = removeAiderFileIfPristine(
+      piPath,
+      resolveShippedTemplate(join3("pi", "AGENTS.md"), repoRoot)
+    );
+    if (piPristine === "removed") {
+      removed.push("~/.pi/agent/AGENTS.md  (removed -- matched shipped template)");
+    } else if (piPristine === "kept-modified") {
+      removed.push("~/.pi/agent/AGENTS.md  (KEPT -- differs from shipped template; remove manually if it is IJFW-only)");
+    }
+  }
+  const clineSettings = resolveClineSettingsPath(home);
+  if (clineSettings) {
+    if (removeJsonMcpEntry(clineSettings)) {
+      removed.push(`${clineSettings}  (removed ijfw-memory)`);
+    }
+  } else {
+    removed.push("Cline: no globalStorage found -- if you use Cline, remove the ijfw-memory MCP entry manually.");
+  }
+  const confResult = removeAiderFileIfPristine(
+    join3(home, ".aider.conf.yml"),
+    resolveAiderTemplate("aider.conf.yml", repoRoot)
+  );
+  if (confResult === "removed") {
+    removed.push("~/.aider.conf.yml  (removed -- matched shipped template)");
+  } else if (confResult === "kept-modified") {
+    removed.push("~/.aider.conf.yml  (KEPT -- differs from shipped template; remove manually if it is IJFW-only)");
+  }
+  const convResult = removeAiderFileIfPristine(
+    join3(home, "CONVENTIONS.md"),
+    resolveAiderTemplate("CONVENTIONS.md", repoRoot)
+  );
+  if (convResult === "removed") {
+    removed.push("~/CONVENTIONS.md  (removed -- matched shipped template)");
+  } else if (convResult === "kept-modified") {
+    removed.push("~/CONVENTIONS.md  (KEPT -- differs from shipped template; remove manually if it is IJFW-only)");
+  }
   return removed;
 }
+function parseRegistryPaths(registryPath) {
+  try {
+    if (!existsSync3(registryPath)) return [];
+    const raw = readFileSync3(registryPath, "utf8");
+    const paths = [];
+    for (const line of raw.split("\n")) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      const first = trimmed.split("|")[0].trim();
+      if (!first) continue;
+      if (!first.startsWith("/") && !/^[A-Za-z]:[\\/]/.test(first)) continue;
+      paths.push(first);
+    }
+    return paths;
+  } catch {
+    return [];
+  }
+}
+function stripRegisteredProjectBlocks(opts = {}) {
+  const home = opts.home || HOME;
+  const cwd = opts.cwd || process.cwd();
+  const registryPath = opts.registryPath || join3(home, ".ijfw", "registry.md");
+  const results = [];
+  for (const projPath of parseRegistryPaths(registryPath)) {
+    let dirExists = false;
+    try {
+      dirExists = existsSync3(projPath);
+    } catch {
+      dirExists = false;
+    }
+    if (!dirExists) continue;
+    for (const name of ["CLAUDE.md", "AGENTS.md"]) {
+      const filePath = join3(projPath, name);
+      const status = stripMarkerFile(filePath, { label: join3(projPath, name) });
+      if (status) results.push(status);
+    }
+  }
+  try {
+    const cursorRule = join3(cwd, ".cursor", "rules", "ijfw.mdc");
+    if (existsSync3(cursorRule)) {
+      backupFile(cursorRule);
+      rmSync(cursorRule, { force: true });
+      results.push(".cursor/rules/ijfw.mdc  (removed -- wholly IJFW-authored)");
+    }
+  } catch {
+  }
+  const windsurfStatus = stripMarkerFile(join3(cwd, ".windsurfrules"), {
+    label: ".windsurfrules",
+    deleteIfEmpty: true
+  });
+  if (windsurfStatus) results.push(windsurfStatus);
+  const copilotStatus = stripMarkerFile(join3(cwd, ".github", "copilot-instructions.md"), {
+    label: ".github/copilot-instructions.md",
+    deleteIfEmpty: true
+  });
+  if (copilotStatus) results.push(copilotStatus);
+  return results;
+}
 function resolveTarget(opt) {
   if (opt.dir) return resolve2(opt.dir);
   if (process.env.IJFW_HOME) return resolve2(process.env.IJFW_HOME);
-  return join2(homedir2(), ".ijfw");
+  return join3(homedir2(), ".ijfw");
+}
+function assertSafePurgeTarget(target) {
+  let real = target;
+  try {
+    real = realpathSync(target);
+  } catch {
+  }
+  let home = homedir2();
+  try {
+    home = realpathSync(home);
+  } catch {
+  }
+  if (!real || real === "/" || real === home) {
+    throw new Error(`refusing to delete '${target}': it resolves to the home or filesystem root.`);
+  }
+  if (real.split("/").filter(Boolean).length < 2) {
+    throw new Error(`refusing to delete shallow path '${real}'.`);
+  }
+  const looksIjfw = basename(real) === ".ijfw" || existsSync3(join3(real, "state.json")) || existsSync3(join3(real, "install-method")) || existsSync3(join3(real, "install-ledger.json")) || existsSync3(join3(real, "mcp-server")) || existsSync3(join3(real, "memory"));
+  if (!looksIjfw) {
+    throw new Error(`refusing to delete '${target}': it does not look like an IJFW install (no state.json / install-method / mcp-server). Aborting.`);
+  }
+}
+function removeCreatedDirs(home, createdDirs) {
+  const removed = [];
+  for (const rel of createdDirs || []) {
+    const abs = join3(home, rel);
+    if (isEmptyDir(abs)) {
+      try {
+        rmSync(abs, { recursive: false, force: true });
+        removed.push(`~/${rel}  (IJFW-created, now empty)`);
+      } catch {
+      }
+    }
+  }
+  return removed;
 }
 async function main() {
   const opts = parseArgs(process.argv);
   const target = resolveTarget(opts);
+  const ledgerCreatedDirs = existsSync3(target) ? readLedger(target).createdDirs : [];
   console.log("This will remove IJFW configuration. Your memory at ~/.ijfw/memory/ will be preserved. Delete manually if desired.");
   if (opts.purge) {
     console.log("WARNING: --purge will also DELETE ~/.ijfw/memory/ (project memory cannot be recovered).");
@@ -397,16 +860,18 @@ async function main() {
     }
     console.log("");
   }
-  if (!existsSync2(target)) {
+  if (!existsSync3(target)) {
     console.log(`IJFW directory absent (${target}); platform cleanup only.`);
   } else if (opts.purge) {
+    assertSafePurgeTarget(target);
     rmSync(target, { recursive: true, force: true });
     console.log(`  removed ${target} (purged).`);
   } else {
-    const memDir = join2(target, "memory");
+    assertSafePurgeTarget(target);
+    const memDir = join3(target, "memory");
     let stash = null;
-    if (existsSync2(memDir)) {
-      stash = mkdtempSync(join2(tmpdir(), "ijfw-memory-"));
+    if (existsSync3(memDir)) {
+      stash = mkdtempSync(join3(tmpdir(), "ijfw-memory-"));
       cpSync(memDir, stash, { recursive: true });
     }
     rmSync(target, { recursive: true, force: true });
@@ -418,11 +883,11 @@ async function main() {
       console.log("  memory/ was not present; nothing to preserve");
     }
   }
-  const canonicalDir = join2(HOME, ".ijfw");
+  const canonicalDir = join3(HOME, ".ijfw");
   const isCanonical = target === canonicalDir;
   if (isCanonical && !opts.noMarketplace) {
     const settingsPath = claudeSettingsPath();
-    if (existsSync2(settingsPath)) {
+    if (existsSync3(settingsPath)) {
       unmergeMarketplace(settingsPath);
       console.log(`  marketplace removed from ${settingsPath}`);
     }
@@ -433,13 +898,39 @@ async function main() {
       console.log("  platform configs cleaned:");
       for (const line of cleaned) console.log(`    ${line}`);
     }
+    const projectCleaned = stripRegisteredProjectBlocks();
+    if (projectCleaned.length > 0) {
+      console.log("  project blocks cleaned:");
+      for (const line of projectCleaned) console.log(`    ${line}`);
+    }
+    if (opts.purge) {
+      const dirsRemoved = removeCreatedDirs(HOME, ledgerCreatedDirs);
+      if (dirsRemoved.length > 0) {
+        console.log("  IJFW-created dirs removed:");
+        for (const line of dirsRemoved) console.log(`    ${line}`);
+      }
+    }
   } else {
     console.log(`  custom-dir uninstall (${target}) -- platform configs in your real home left untouched.`);
   }
   console.log("\nIJFW uninstalled. Thanks for trying it.");
   process.exit(0);
 }
-main().catch((e) => {
-  console.error(e.message || String(e));
-  process.exit(1);
-});
+var isDirectRun = process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;
+if (isDirectRun) {
+  main().catch((e) => {
+    console.error(e.message || String(e));
+    process.exit(1);
+  });
+}
+export {
+  cleanPlatforms,
+  parseRegistryPaths,
+  removeAiderFileIfPristine,
+  removeNestedMcpEntry,
+  resolveAiderTemplate,
+  resolveClineSettingsPath,
+  stripIjfwRegions,
+  stripMarkerFile,
+  stripRegisteredProjectBlocks
+};