@ijfw/install 1.6.0 → 1.6.1

package/dist/ijfw.js

@@ -3769,6 +3769,16 @@ var COMMAND_REGISTRY = Object.freeze([
     status: "active",
     helpGroup: "GET STARTED"
   },
+  {
+    name: "init",
+    tier: "primary",
+    owner: "orchestrator",
+    description: "Approve the current folder for codebase indexing",
+    aliases: [],
+    since: "1.6.1",
+    status: "active",
+    helpGroup: "GET STARTED"
+  },
   {
     name: "update",
     tier: "primary",

package/dist/install.js

@@ -1388,6 +1388,142 @@ var init_install_targets_8_14 = __esm({
   }
 });
 
+// src/install-ledger.js
+var install_ledger_exports = {};
+__export(install_ledger_exports, {
+  INSTALL_PLAN: () => INSTALL_PLAN,
+  PLATFORM_OWNED_DIRS: () => PLATFORM_OWNED_DIRS,
+  allOwnedDirs: () => allOwnedDirs,
+  isEmptyDir: () => isEmptyDir,
+  ledgerPath: () => ledgerPath,
+  readLedger: () => readLedger,
+  renderPlan: () => renderPlan,
+  snapshotPreExistingDirs: () => snapshotPreExistingDirs,
+  writeLedger: () => writeLedger
+});
+import { existsSync as existsSync5, readFileSync as readFileSync4, writeFileSync as writeFileSync4, mkdirSync as mkdirSync4, readdirSync as readdirSync2 } from "node:fs";
+import { join as join5 } from "node:path";
+function ledgerPath(ijfwHome) {
+  return join5(ijfwHome, "install-ledger.json");
+}
+function allOwnedDirs() {
+  const set = /* @__PURE__ */ new Set();
+  for (const dirs of Object.values(PLATFORM_OWNED_DIRS)) {
+    for (const d of dirs) set.add(d);
+  }
+  return [...set];
+}
+function snapshotPreExistingDirs(home) {
+  const pre = [];
+  for (const rel of allOwnedDirs()) {
+    if (existsSync5(join5(home, rel))) pre.push(rel);
+  }
+  return pre;
+}
+function writeLedger({ home, ijfwHome, preExisting }) {
+  const preSet = new Set(preExisting || []);
+  const created = [];
+  for (const rel of allOwnedDirs()) {
+    if (!preSet.has(rel) && existsSync5(join5(home, rel))) created.push(rel);
+  }
+  const ledger = { version: 1, createdDirs: created };
+  try {
+    mkdirSync4(ijfwHome, { recursive: true, mode: 448 });
+    writeFileSync4(ledgerPath(ijfwHome), JSON.stringify(ledger, null, 2) + "\n", { mode: 384 });
+  } catch {
+  }
+  return ledger;
+}
+function readLedger(ijfwHome) {
+  try {
+    const raw = readFileSync4(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 existsSync5(p) && readdirSync2(p).length === 0;
+  } catch {
+    return false;
+  }
+}
+function renderPlan(targetList) {
+  const lines = [];
+  lines.push("IJFW install plan (dry run) -- nothing will be written.");
+  lines.push("  legend: [m]=merge into existing file  [c]=create  [./]=project-scoped");
+  lines.push("");
+  const emit = (title, rows) => {
+    if (!rows || rows.length === 0) return;
+    lines.push(title);
+    for (const [path3, kind, note] of rows) lines.push(`    [${kind}] ${path3}  -- ${note}`);
+  };
+  emit("  shared:", INSTALL_PLAN.shared);
+  for (const t of targetList) {
+    if (INSTALL_PLAN[t]) emit(`  ${t}:`, INSTALL_PLAN[t]);
+  }
+  lines.push("");
+  lines.push("  Run without --dry-run to apply. Use `ijfw-uninstall --purge` to reverse.");
+  return lines.join("\n");
+}
+var PLATFORM_OWNED_DIRS, INSTALL_PLAN;
+var init_install_ledger = __esm({
+  "src/install-ledger.js"() {
+    PLATFORM_OWNED_DIRS = {
+      codex: [".codex"],
+      gemini: [".gemini"],
+      hermes: [".hermes"],
+      wayland: [".wayland"],
+      openclaw: [".openclaw"],
+      qwen: [".qwen"],
+      kimi: [".kimi"],
+      opencode: [".config/opencode"],
+      pi: [".pi"]
+    };
+    INSTALL_PLAN = {
+      shared: [
+        ["~/.ijfw/", "c", "IJFW home (server symlink, scripts, index, logs, settings, ledger)"]
+      ],
+      claude: [
+        ["~/.claude/settings.json", "m", "mcpServers.ijfw-memory + enabledPlugins + marketplace"],
+        ["~/.claude/plugins/known_marketplaces.json", "m", "ijfw marketplace entry"]
+      ],
+      codex: [
+        ["~/.codex/config.toml", "m", "[mcp_servers.ijfw-memory]"],
+        ["~/.codex/hooks.json", "m", "IJFW hook entries"],
+        ["~/.codex/hooks/*.sh", "c", "lifecycle hook scripts"],
+        ["~/.codex/IJFW.md", "c", "context file"],
+        ["~/.codex/skills/, commands/", "c", "skills + command aliases"]
+      ],
+      gemini: [
+        ["~/.gemini/settings.json", "m", "mcpServers.ijfw-memory"],
+        ["~/.gemini/extensions/ijfw/", "c", "extension (hooks, skills, commands, agents)"]
+      ],
+      hermes: [
+        ["~/.hermes/config.yaml", "m", "mcp_servers.ijfw-memory + plugin + hook"],
+        ["~/.hermes/HERMES.md, skills/, plugins/ijfw/", "c", "context + skills + plugin tree"]
+      ],
+      wayland: [
+        ["~/.wayland/plugins/ijfw/", "c", "plugin.toml (MCP + hooks)"],
+        ["~/.wayland/WAYLAND.md, skills/", "c", "context + skills"]
+      ],
+      openclaw: [["~/.openclaw/openclaw.json", "m", "mcp.servers.ijfw-memory"]],
+      qwen: [["~/.qwen/settings.json", "m", "mcpServers.ijfw-memory"]],
+      kimi: [["~/.kimi/mcp.json", "m", "mcpServers.ijfw-memory"]],
+      opencode: [["~/.config/opencode/opencode.json", "m", "mcp.ijfw-memory"]],
+      cursor: [["./.cursor/mcp.json + rules/ijfw.mdc", "mc", "project-scoped MCP + rule"]],
+      windsurf: [
+        ["~/.codeium/windsurf/mcp_config.json", "m", "mcpServers.ijfw-memory"],
+        ["./.windsurfrules", "c", "project-scoped rules"]
+      ],
+      copilot: [["./.vscode/mcp.json + .github/copilot-instructions.md", "mc", "project-scoped"]],
+      aider: [["~/.aider.conf.yml + ~/CONVENTIONS.md", "c", "home-level rule files"]]
+    };
+  }
+});
+
 // src/install-flow.js
 var install_flow_exports = {};
 __export(install_flow_exports, {
@@ -1927,6 +2063,7 @@ async function runInstall({
     });
   }
   pruneBackups({ home });
+  const preExistingDirs = snapshotPreExistingDirs(home);
   const live = [];
   const standby = [];
   const failed = [];
@@ -1981,6 +2118,7 @@ async function runInstall({
       standby.push(display);
     }
   }
+  writeLedger({ home, ijfwHome: resolvedIjfwHome, preExisting: preExistingDirs });
   printSummary({
     live,
     standby,
@@ -1996,6 +2134,7 @@ var init_install_flow = __esm({
     init_install_helpers();
     init_install_targets_1_7();
     init_install_targets_8_14();
+    init_install_ledger();
     CANONICAL_ORDER = [
       "claude",
       "codex",
@@ -2038,8 +2177,8 @@ var init_install_flow = __esm({
 
 // src/install.js
 import { spawnSync as spawnSync2 } from "node:child_process";
-import { existsSync as existsSync5, rmSync as rmSync2, mkdirSync as mkdirSync4, realpathSync as realpathSync2, renameSync as renameSync3, readdirSync as readdirSync2, cpSync as cpSync2 } from "node:fs";
-import { resolve as resolve4, join as join5, dirname as dirname5 } from "node:path";
+import { existsSync as existsSync6, rmSync as rmSync2, mkdirSync as mkdirSync5, realpathSync as realpathSync2, renameSync as renameSync3, readdirSync as readdirSync3, cpSync as cpSync2 } from "node:fs";
+import { resolve as resolve4, join as join6, dirname as dirname5 } from "node:path";
 import { homedir as homedir3, platform as platform2 } from "node:os";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
@@ -2201,7 +2340,7 @@ function triggerColdScan(projectRoot, options = {}) {
 var DEFAULT_REPO = "https://github.com/FerroxLabs/ijfw.git";
 var DEFAULT_BRANCH = "main";
 function parseArgs(argv) {
-  const out = { yes: false, dir: null, noMarketplace: false, branch: DEFAULT_BRANCH, branchExplicit: false, purge: false };
+  const out = { yes: false, dir: null, noMarketplace: false, branch: DEFAULT_BRANCH, branchExplicit: false, purge: false, dryRun: false };
   for (let i = 2; i < argv.length; i++) {
     const a = argv[i];
     if (a === "--yes" || a === "-y") out.yes = true;
@@ -2211,6 +2350,7 @@ function parseArgs(argv) {
       out.branch = argv[++i];
       out.branchExplicit = true;
     } else if (a === "--purge") out.purge = true;
+    else if (a === "--dry-run" || a === "--print-plan") out.dryRun = true;
     else if (a === "--help" || a === "-h") {
       printHelp();
       process.exit(0);
@@ -2257,10 +2397,11 @@ function resolveBranchOrTag({ branch, branchExplicit, _tagLookup, _logger } = {}
 }
 function printHelp() {
   console.log(`ijfw-install -- IJFW installer
-Usage: npx @ijfw/install [--dir <path>] [--branch <name>] [--no-marketplace] [--yes]
+Usage: npx @ijfw/install [--dir <path>] [--branch <name>] [--no-marketplace] [--yes] [--dry-run]
   --dir             install location (default: $IJFW_HOME or ~/.ijfw)
   --branch          git branch or tag (default: latest released tag)
   --no-marketplace  skip merging ~/.claude/settings.json
+  --dry-run         print every file/dir the install would touch, write nothing
   --yes             non-interactive
 `);
 }
@@ -2291,15 +2432,15 @@ function findBash() {
   const whereGit = spawnSync2("where", ["git"], { encoding: "utf8" });
   if (whereGit.status === 0) {
     const gitPath = (whereGit.stdout || "").split(/\r?\n/)[0].trim();
-    if (gitPath && existsSync5(gitPath)) {
+    if (gitPath && existsSync6(gitPath)) {
       const gitDir = dirname5(gitPath);
       const gitRoot = dirname5(gitDir);
       const candidates = [
-        join5(gitDir, "bash.exe"),
-        join5(gitRoot, "bin", "bash.exe"),
-        join5(gitRoot, "usr", "bin", "bash.exe")
+        join6(gitDir, "bash.exe"),
+        join6(gitRoot, "bin", "bash.exe"),
+        join6(gitRoot, "usr", "bin", "bash.exe")
       ];
-      for (const c of candidates) if (existsSync5(c)) return c;
+      for (const c of candidates) if (existsSync6(c)) return c;
     }
   }
   for (const c of [
@@ -2307,14 +2448,14 @@ function findBash() {
     "C:\\Program Files\\Git\\usr\\bin\\bash.exe",
     "C:\\Program Files (x86)\\Git\\bin\\bash.exe",
     "C:\\Program Files (x86)\\Git\\usr\\bin\\bash.exe"
-  ]) if (existsSync5(c)) return c;
+  ]) if (existsSync6(c)) return c;
   if (hasBin2("bash")) return "bash";
   return null;
 }
 function resolveTarget(opt) {
   if (opt.dir) return resolve4(opt.dir);
   if (process.env.IJFW_HOME) return resolve4(process.env.IJFW_HOME);
-  return join5(homedir3(), ".ijfw");
+  return join6(homedir3(), ".ijfw");
 }
 function runCheck(cmd, args, opts) {
   const r = spawnSync2(cmd, args, { encoding: "utf8", ...opts });
@@ -2322,20 +2463,20 @@ function runCheck(cmd, args, opts) {
 }
 function cloneOrPull(dir, branch) {
   if (skipNetwork()) {
-    if (existsSync5(dir)) {
+    if (existsSync6(dir)) {
       return "skipped-network";
     }
     throw new Error(
       `IJFW_SKIP_NETWORK=1 set but cloneOrPull needs network: target directory ${dir} does not exist. Pre-seed the directory before setting IJFW_SKIP_NETWORK, or unset the env var.`
     );
   }
-  if (!existsSync5(dir)) {
-    mkdirSync4(dir, { recursive: true });
+  if (!existsSync6(dir)) {
+    mkdirSync5(dir, { recursive: true });
     const r = spawnSync2("git", ["clone", "--depth", "1", "--branch", branch, DEFAULT_REPO, dir], { stdio: "inherit" });
     if (r.status !== 0) throw new Error(`IJFW repo fetch did not complete (exit ${r.status}) -- check network access and retry.`);
     return "cloned";
   }
-  const hasGit = existsSync5(join5(dir, ".git"));
+  const hasGit = existsSync6(join6(dir, ".git"));
   if (hasGit) {
     const { status: remoteStatus, stdout, stderr: remoteStderr, spawnError: remoteSpawnError, signal: remoteSignal } = runCheck("git", ["-C", dir, "remote", "get-url", "origin"]);
     if (remoteSpawnError) console.warn(`  git spawn error (${remoteSpawnError}) -- check git is on PATH`);
@@ -2392,10 +2533,10 @@ function cloneOrPull(dir, branch) {
     if (r.status !== 0) throw new Error(`IJFW repo fetch did not complete (exit ${r.status}) -- check network access and retry.`);
     let restoredCount = 0;
     for (const item of RESTORE_ALLOWLIST) {
-      const src = join5(backupDir, item);
-      if (existsSync5(src)) {
-        const dst = join5(dir, item);
-        if (existsSync5(dst)) rmSync2(dst, { recursive: true, force: true });
+      const src = join6(backupDir, item);
+      if (existsSync6(src)) {
+        const dst = join6(dir, item);
+        if (existsSync6(dst)) rmSync2(dst, { recursive: true, force: true });
         try {
           cpSync2(src, dst, { recursive: true, dereference: false });
           rmSync2(src, { recursive: true, force: true });
@@ -2410,7 +2551,7 @@ function cloneOrPull(dir, branch) {
     }
     let backupResidual = [];
     try {
-      backupResidual = readdirSync2(backupDir);
+      backupResidual = readdirSync3(backupDir);
     } catch {
     }
     if (backupResidual.length === 0) {
@@ -2422,13 +2563,13 @@ function cloneOrPull(dir, branch) {
     }
     return "updated";
   } catch (err) {
-    if (existsSync5(dir)) rmSync2(dir, { recursive: true, force: true });
+    if (existsSync6(dir)) rmSync2(dir, { recursive: true, force: true });
     renameSync3(backupDir, dir);
     throw err;
   }
 }
 async function runInstallScript(dir) {
-  const canonicalDir = join5(homedir3(), ".ijfw");
+  const canonicalDir = join6(homedir3(), ".ijfw");
   const isCustomDir = resolve4(dir) !== canonicalDir;
   const { runInstall: runInstall2 } = await Promise.resolve().then(() => (init_install_flow(), install_flow_exports));
   await runInstall2({
@@ -2449,9 +2590,17 @@ async function main() {
     process.exit(1);
   }
   const target = resolveTarget(opts);
-  const createdThisRun = !existsSync5(target);
+  if (opts.dryRun) {
+    const { CANONICAL_ORDER: CANONICAL_ORDER2 } = await Promise.resolve().then(() => (init_install_flow(), install_flow_exports));
+    const { renderPlan: renderPlan2 } = await Promise.resolve().then(() => (init_install_ledger(), install_ledger_exports));
+    console.log(`IJFW install target: ${target}`);
+    console.log("");
+    console.log(renderPlan2(CANONICAL_ORDER2));
+    process.exit(0);
+  }
+  const createdThisRun = !existsSync6(target);
   const sigint = () => {
-    if (createdThisRun && existsSync5(target)) {
+    if (createdThisRun && existsSync6(target)) {
       try {
         rmSync2(target, { recursive: true, force: true });
       } catch (err) {
@@ -2472,7 +2621,7 @@ async function main() {
   console.log(`  repo ${action}`);
   await runInstallScript(target);
   console.log("  platform configs applied");
-  const canonicalDir = join5(homedir3(), ".ijfw");
+  const canonicalDir = join6(homedir3(), ".ijfw");
   const isCustomDir = process.env.IJFW_CUSTOM_DIR === "1" || resolve4(target) !== canonicalDir;
   if (!opts.noMarketplace && !isCustomDir) {
     const settingsPath = claudeSettingsPath();

package/dist/uninstall.js

@@ -1,8 +1,8 @@
 #!/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, dirname as dirname2 } 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";
@@ -95,6 +95,29 @@ 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);
@@ -103,9 +126,9 @@ function resolveAiderTemplate(name, repoRoot) {
   const root = repoRoot || REPO_ROOT;
   const candidates = [
     // (a) git clone: top-level aider/ under the (injected) repo root.
-    join2(root, "aider", name),
+    join3(root, "aider", name),
     // (a') repo root with staged templates under installer/.
-    join2(root, "installer", "templates", "aider", name),
+    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>
@@ -114,7 +137,7 @@ function resolveAiderTemplate(name, repoRoot) {
   ];
   for (const c of candidates) {
     try {
-      if (existsSync2(c)) return c;
+      if (existsSync3(c)) return c;
     } catch {
     }
   }
@@ -122,7 +145,7 @@ function resolveAiderTemplate(name, repoRoot) {
 }
 function writeAtomic(target, content) {
   const tmp = `${target}.tmp.${process.pid}.${Date.now()}`;
-  writeFileSync2(tmp, content);
+  writeFileSync3(tmp, content);
   try {
     renameSync2(tmp, target);
   } catch (err) {
@@ -178,7 +201,7 @@ 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;
@@ -212,10 +235,10 @@ function hasIjfwMarker(text) {
 }
 function stripMarkerFile(p, opts = {}) {
   try {
-    if (!existsSync2(p)) return null;
+    if (!existsSync3(p)) return null;
     let text;
     try {
-      text = readFileSync2(p, "utf8");
+      text = readFileSync3(p, "utf8");
     } catch {
       return null;
     }
@@ -234,9 +257,9 @@ function stripMarkerFile(p, opts = {}) {
   }
 }
 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) {
@@ -251,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;
   }
@@ -270,10 +293,10 @@ function removeJsonMcpEntry(p) {
 }
 function removeNestedMcpEntry(p, keyPath) {
   try {
-    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;
     }
@@ -294,43 +317,43 @@ function removeNestedMcpEntry(p, keyPath) {
 }
 function resolveClineSettingsPath(home) {
   const H = home;
-  const APPDATA = process.env.APPDATA || join2(H, "AppData", "Roaming");
+  const APPDATA = process.env.APPDATA || join3(H, "AppData", "Roaming");
   const ext = "saoudrizwan.claude-dev";
   let userDirs;
   if (process.platform === "darwin") {
     userDirs = [
-      join2(H, "Library", "Application Support", "Code", "User"),
-      join2(H, "Library", "Application Support", "Code - Insiders", "User"),
-      join2(H, "Library", "Application Support", "VSCodium", "User")
+      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 = [
-      join2(APPDATA, "Code", "User"),
-      join2(APPDATA, "Code - Insiders", "User"),
-      join2(APPDATA, "VSCodium", "User")
+      join3(APPDATA, "Code", "User"),
+      join3(APPDATA, "Code - Insiders", "User"),
+      join3(APPDATA, "VSCodium", "User")
     ];
   } else {
     userDirs = [
-      join2(H, ".config", "Code", "User"),
-      join2(H, ".config", "VSCodium", "User"),
-      join2(H, ".var", "app", "com.visualstudio.code", "config", "Code", "User"),
-      join2(H, "snap", "code", "current", ".config", "Code", "User")
+      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 = join2(d, "globalStorage", ext, "settings", "cline_mcp_settings.json");
-    if (existsSync2(settings)) return settings;
+    const settings = join3(d, "globalStorage", ext, "settings", "cline_mcp_settings.json");
+    if (existsSync3(settings)) return settings;
   }
   return null;
 }
 function removeAiderFileIfPristine(installedPath, templatePath) {
   try {
-    if (!existsSync2(installedPath)) return "absent";
-    if (!existsSync2(templatePath)) return "kept-modified";
+    if (!existsSync3(installedPath)) return "absent";
+    if (!existsSync3(templatePath)) return "kept-modified";
     let a, b;
     try {
-      a = readFileSync2(installedPath);
-      b = readFileSync2(templatePath);
+      a = readFileSync3(installedPath);
+      b = readFileSync3(templatePath);
     } catch {
       return "kept-modified";
     }
@@ -345,10 +368,10 @@ function removeAiderFileIfPristine(installedPath, templatePath) {
   }
 }
 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;
   }
@@ -389,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
@@ -424,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++;
     }
   }
@@ -460,99 +545,177 @@ 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 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(cwd, ".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(cwd, ".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");
   }
-  const waylandPluginDir = join2(home, ".wayland", "plugins", "ijfw");
-  if (existsSync2(waylandPluginDir)) {
+  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)");
   }
-  if (removeYamlMcpEntry(join2(home, ".wayland", "config.yaml"))) {
+  if (removeYamlMcpEntry(join3(home, ".wayland", "config.yaml"))) {
     removed.push("~/.wayland/config.yaml  (removed legacy ijfw-memory)");
   }
-  const waylandSkills = removeIjfwSkills(join2(home, ".wayland", "skills"));
+  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(join2(home, ".qwen", "settings.json"))) {
+  if (removeJsonMcpEntry(join3(home, ".qwen", "settings.json"))) {
     removed.push("~/.qwen/settings.json  (removed ijfw-memory)");
   }
-  if (removeJsonMcpEntry(join2(home, ".kimi", "mcp.json"))) {
+  if (removeJsonMcpEntry(join3(home, ".kimi", "mcp.json"))) {
     removed.push("~/.kimi/mcp.json  (removed ijfw-memory)");
   }
-  if (removeJsonMcpEntry(join2(home, ".gemini", "antigravity", "mcp_config.json"))) {
+  if (removeJsonMcpEntry(join3(home, ".gemini", "antigravity", "mcp_config.json"))) {
     removed.push("~/.gemini/antigravity/mcp_config.json  (removed ijfw-memory)");
   }
-  if (removeJsonMcpEntry(join2(home, ".gemini", "config", "mcp_config.json"))) {
+  if (removeJsonMcpEntry(join3(home, ".gemini", "config", "mcp_config.json"))) {
     removed.push("~/.gemini/config/mcp_config.json  (removed ijfw-memory)");
   }
-  if (removeNestedMcpEntry(join2(home, ".config", "opencode", "opencode.json"), ["mcp"])) {
+  if (removeNestedMcpEntry(join3(home, ".config", "opencode", "opencode.json"), ["mcp"])) {
     removed.push("~/.config/opencode/opencode.json  (removed mcp.ijfw-memory)");
   }
-  if (removeNestedMcpEntry(join2(home, ".openclaw", "openclaw.json"), ["mcp", "servers"])) {
+  if (removeNestedMcpEntry(join3(home, ".openclaw", "openclaw.json"), ["mcp", "servers"])) {
     removed.push("~/.openclaw/openclaw.json  (removed mcp.servers.ijfw-memory)");
   }
-  const piStatus = stripMarkerFile(join2(home, ".pi", "agent", "AGENTS.md"), {
-    label: "~/.pi/agent/AGENTS.md"
-  });
-  if (piStatus) removed.push(piStatus);
+  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)) {
@@ -562,7 +725,7 @@ function cleanPlatforms(opts = {}) {
     removed.push("Cline: no globalStorage found -- if you use Cline, remove the ijfw-memory MCP entry manually.");
   }
   const confResult = removeAiderFileIfPristine(
-    join2(home, ".aider.conf.yml"),
+    join3(home, ".aider.conf.yml"),
     resolveAiderTemplate("aider.conf.yml", repoRoot)
   );
   if (confResult === "removed") {
@@ -571,7 +734,7 @@ function cleanPlatforms(opts = {}) {
     removed.push("~/.aider.conf.yml  (KEPT -- differs from shipped template; remove manually if it is IJFW-only)");
   }
   const convResult = removeAiderFileIfPristine(
-    join2(home, "CONVENTIONS.md"),
+    join3(home, "CONVENTIONS.md"),
     resolveAiderTemplate("CONVENTIONS.md", repoRoot)
   );
   if (convResult === "removed") {
@@ -583,8 +746,8 @@ function cleanPlatforms(opts = {}) {
 }
 function parseRegistryPaths(registryPath) {
   try {
-    if (!existsSync2(registryPath)) return [];
-    const raw = readFileSync2(registryPath, "utf8");
+    if (!existsSync3(registryPath)) return [];
+    const raw = readFileSync3(registryPath, "utf8");
     const paths = [];
     for (const line of raw.split("\n")) {
       const trimmed = line.trim();
@@ -602,37 +765,37 @@ function parseRegistryPaths(registryPath) {
 function stripRegisteredProjectBlocks(opts = {}) {
   const home = opts.home || HOME;
   const cwd = opts.cwd || process.cwd();
-  const registryPath = opts.registryPath || join2(home, ".ijfw", "registry.md");
+  const registryPath = opts.registryPath || join3(home, ".ijfw", "registry.md");
   const results = [];
   for (const projPath of parseRegistryPaths(registryPath)) {
     let dirExists = false;
     try {
-      dirExists = existsSync2(projPath);
+      dirExists = existsSync3(projPath);
     } catch {
       dirExists = false;
     }
     if (!dirExists) continue;
     for (const name of ["CLAUDE.md", "AGENTS.md"]) {
-      const filePath = join2(projPath, name);
-      const status = stripMarkerFile(filePath, { label: join2(projPath, name) });
+      const filePath = join3(projPath, name);
+      const status = stripMarkerFile(filePath, { label: join3(projPath, name) });
       if (status) results.push(status);
     }
   }
   try {
-    const cursorRule = join2(cwd, ".cursor", "rules", "ijfw.mdc");
-    if (existsSync2(cursorRule)) {
+    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(join2(cwd, ".windsurfrules"), {
+  const windsurfStatus = stripMarkerFile(join3(cwd, ".windsurfrules"), {
     label: ".windsurfrules",
     deleteIfEmpty: true
   });
   if (windsurfStatus) results.push(windsurfStatus);
-  const copilotStatus = stripMarkerFile(join2(cwd, ".github", "copilot-instructions.md"), {
+  const copilotStatus = stripMarkerFile(join3(cwd, ".github", "copilot-instructions.md"), {
     label: ".github/copilot-instructions.md",
     deleteIfEmpty: true
   });
@@ -642,11 +805,48 @@ function stripRegisteredProjectBlocks(opts = {}) {
 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).");
@@ -660,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 });
@@ -681,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}`);
     }
@@ -701,6 +903,13 @@ async function main() {
       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.`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ijfw/install",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "One-command installer for IJFW -- the AI efficiency layer. One install, every AI coding agent, zero config.",
   "type": "module",
   "bin": {
@@ -14,6 +14,7 @@
     "docs/GUIDE.md",
     "docs/guide/assets",
     "templates/aider/**",
+    "templates/pi/**",
     "scripts/pack-hub-extension.js",
     "scripts/hub-extension/**",
     "README.md",

package/templates/pi/AGENTS.md

@@ -0,0 +1,55 @@
+# IJFW Conventions for Pi
+
+<!-- Pi MCP support last verified: 2026-05-28 against https://pi.dev/.
+     Pi has no native MCP client (build as extension or skill). When Pi adds
+     native MCP, regenerate this file and consider promoting Pi from
+     rules-only to full-skill tier in installer/src/install-targets-8-14.js
+     and add the MCP wiring path. -->
+
+Pi has no native MCP, so IJFW's memory + cross-audit tools aren't available
+inside Pi sessions out of the box. These conventions carry the IJFW spirit
+(disciplined workflow, terse output, no scope creep, no half-shipping) into
+Pi's terminal harness. Pi loads this file at startup from `~/.pi/agent/`,
+parent directories, and the current working directory -- exactly where IJFW
+installs it.
+
+## Workflow
+
+- One question at a time. Don't dump multi-step plans before the user signs off.
+- Lead with the answer. No restating the question.
+- For multi-file changes, propose the plan in chat FIRST. Wait for the user "go".
+- Terse output. The diff is the deliverable, not your prose about the diff.
+
+## Code
+
+- Match existing style. Don't refactor adjacent code that wasn't asked for.
+- No speculative abstractions. Three similar lines beats a premature helper.
+- No error handling for impossible scenarios. Trust internal code; validate only at system boundaries.
+- Default to writing no comments. Only add when the WHY is non-obvious (a hidden constraint, a subtle invariant, a workaround for a specific bug).
+- Never write multi-paragraph docstrings. One short line max.
+
+## Memory + cross-audit
+
+Pi sessions don't see IJFW's persistent memory by default. After significant work:
+
+- Run `ijfw cross audit <file>` in a separate terminal to get a Trident review across two model families.
+- Use `ijfw_memory_store` from a Claude/Codex/Gemini session (where MCP is native) to persist decisions Pi makes -- they won't survive otherwise.
+- Or build a Pi extension that bridges to the IJFW MCP memory server (`~/.ijfw/mcp-server/src/server.js`). Pi's extension API supports tool registration; the bridge is the cleanest path to native parity.
+
+## Scope
+
+Stay in the lane the user asked for. If you spot adjacent issues, mention them in chat -- don't fix them silently. No drive-by refactors. No backwards-compatibility shims for code that isn't shipped yet.
+
+## DESIGN picker
+
+If the user asks for a design contract and no `DESIGN.md` exists in the project root, suggest one of the 12 IJFW curated templates (alphabetical):
+
+apple-glass, anthropic, bauhaus, brutalist, calm, dark-mode, document, editorial, glassmorphism, minimal, neo-brutalist, terminal
+
+Show 3 options matching the project's vibe; let the user pick. Then write `DESIGN.md` to project root. Every IJFW-connected agent reads the same visual contract -- you keep them consistent.
+
+## Executing actions with care
+
+Carefully consider blast radius before destructive ops. Local edits and tests are safe; check with the user before `rm -rf`, force pushes, dropping tables, sending messages, or anything visible to others or hard to reverse.
+
+When you hit an obstacle, find the root cause rather than bypassing safety checks (no `--no-verify`, no force-push to main). If you encounter unfamiliar state, investigate before deleting -- it may be the user's in-progress work.