@ijfw/install 1.5.5 → 1.6.0

package/dist/ijfw.js

@@ -389,7 +389,7 @@ __export(psscriptanalyzer_exports, {
   severity: () => severity4
 });
 import { spawnSync as spawnSync4 } from "node:child_process";
-import { readFileSync, readdirSync as readdirSync2, statSync as statSync2 } from "node:fs";
+import { readFileSync, readdirSync as readdirSync2, statSync as statSync2, existsSync } from "node:fs";
 import { join as join3 } from "node:path";
 function findPs1Files(dir, acc = []) {
   let entries;
@@ -539,11 +539,13 @@ async function run4(ctx) {
   if (moduleCheck.status !== 0) {
     return runFallback(files, t0, "PSScriptAnalyzer module unavailable");
   }
+  const psSettings = join3(ctx.repoRoot, "PSScriptAnalyzerSettings.psd1");
+  const invoke = existsSync(psSettings) ? `Invoke-ScriptAnalyzer -Path $f -Settings '${psSettings.replace(/'/g, "''")}' -ErrorAction SilentlyContinue` : "Invoke-ScriptAnalyzer -Path $f -Severity Warning -ErrorAction SilentlyContinue";
   const script = `
 $files = @(${files.map((f) => `'${f.replace(/'/g, "''")}'`).join(",")})
 $found = $false
 foreach ($f in $files) {
-  $results = Invoke-ScriptAnalyzer -Path $f -Severity Warning -ErrorAction SilentlyContinue
+  $results = ${invoke}
   if ($results) {
     $found = $true
     foreach ($r in $results) {
@@ -861,14 +863,14 @@ var init_gate_result_schema = __esm({
 });
 
 // ../mcp-server/src/scan-resume.js
-import { existsSync, mkdirSync, readFileSync as readFileSync2, writeFileSync as writeFileSync2, renameSync, unlinkSync, copyFileSync } from "fs";
+import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync as writeFileSync2, renameSync, unlinkSync, copyFileSync } from "fs";
 import { join as join4 } from "path";
 function statePath(projectRoot) {
   return join4(String(projectRoot), ".ijfw", STATE_FILE);
 }
 function loadScanState(projectRoot) {
   const path = statePath(projectRoot);
-  if (!existsSync(path)) return null;
+  if (!existsSync2(path)) return null;
   try {
     const raw = readFileSync2(path, "utf8");
     const parsed = JSON.parse(raw);
@@ -879,7 +881,7 @@ function loadScanState(projectRoot) {
 }
 function writeScanState(projectRoot, state) {
   const dir = join4(String(projectRoot), ".ijfw");
-  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  if (!existsSync2(dir)) mkdirSync(dir, { recursive: true });
   const finalPath = statePath(projectRoot);
   const tmpPath = `${finalPath}.tmp.${process.pid}.${Date.now()}`;
   const safe = {
@@ -925,7 +927,7 @@ function isPidAlive(pid) {
   }
 }
 function reclaimIfStale(lp) {
-  if (!existsSync(lp)) return;
+  if (!existsSync2(lp)) return;
   let raw;
   try {
     raw = readFileSync2(lp, "utf8");
@@ -944,7 +946,7 @@ function reclaimIfStale(lp) {
 }
 function acquireScanLock(projectRoot) {
   const dir = join4(String(projectRoot), ".ijfw");
-  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  if (!existsSync2(dir)) mkdirSync(dir, { recursive: true });
   const lp = lockPath(projectRoot);
   reclaimIfStale(lp);
   const payload = String(process.pid) + "\n" + String(Date.now()) + "\n";
@@ -980,7 +982,7 @@ function shouldResume(state) {
 }
 function clearScanState(projectRoot) {
   const path = statePath(projectRoot);
-  if (existsSync(path)) {
+  if (existsSync2(path)) {
     try {
       unlinkSync(path);
     } catch {
@@ -1002,7 +1004,7 @@ var init_scan_resume = __esm({
 import {
   readFileSync as readFileSync3,
   writeFileSync as writeFileSync3,
-  existsSync as existsSync2,
+  existsSync as existsSync3,
   readdirSync as readdirSync3,
   statSync as statSync3,
   renameSync as renameSync2,
@@ -1154,7 +1156,7 @@ function finalize({ primary, secondary, score, signals, scanIncomplete, fallback
   return out;
 }
 function readFrontmatterType(path) {
-  if (!existsSync2(path)) return null;
+  if (!existsSync3(path)) return null;
   let src;
   try {
     src = readFileSync3(path, "utf8");
@@ -1406,7 +1408,7 @@ function fileTreeHash(paths) {
 function branchHash(root) {
   try {
     const dotGit = join5(root, ".git");
-    if (!existsSync2(dotGit)) return "";
+    if (!existsSync3(dotGit)) return "";
     let headPath = null;
     let st;
     try {
@@ -1426,7 +1428,7 @@ function branchHash(root) {
     } else {
       return "";
     }
-    if (!headPath || !existsSync2(headPath)) return "";
+    if (!headPath || !existsSync3(headPath)) return "";
     const head = readFileSync3(headPath, "utf8").trim();
     const m2 = head.match(/^ref:\s*(.+)$/);
     const branch = m2 ? m2[1] : head;
@@ -1440,7 +1442,7 @@ function isC9AvailableSync() {
   try {
     const here = fileURLToPath(import.meta.url);
     const fts5Path = join5(dirname(here), "compute", "fts5.js");
-    _c9AvailableCache = existsSync2(fts5Path);
+    _c9AvailableCache = existsSync3(fts5Path);
   } catch {
     _c9AvailableCache = false;
   }
@@ -1775,30 +1777,32 @@ async function run7(ctx) {
         timeout: 6e4
       }
     );
-    const output = (res.stdout || "") + (res.stderr || "");
-    const report = parseAuditReport(output);
+    const report = parseAuditReport(res.stdout || "");
     const highCritical = highCriticalCount(report);
-    return { dir, status: res.status, output, report, highCritical };
+    return { dir, status: res.status, output: (res.stdout || "") + (res.stderr || ""), report, highCritical };
   });
   const durationMs = Date.now() - t0;
-  const failed = runs.filter((r) => !r.report || r.highCritical > 0);
-  const status = failed.length === 0 ? "PASS" : "FAIL";
-  const message = status === "PASS" ? "audit-ci: no high/critical vulnerabilities in installer or mcp-server" : "audit-ci: high or critical vulnerabilities found";
+  const realVulns = runs.filter((r) => r.report && r.highCritical > 0);
+  const unparseable = runs.filter((r) => !r.report);
+  const status = realVulns.length > 0 ? "FAIL" : unparseable.length > 0 ? "WARN" : "PASS";
+  const message = status === "FAIL" ? "audit-ci: high or critical vulnerabilities found" : status === "WARN" ? "audit-ci: audit could not be completed for some package(s); no high/critical in the rest" : "audit-ci: no high/critical vulnerabilities in installer or mcp-server";
   let details;
   if (status === "PASS") {
     details = runs.map((r) => `${r.dir}: pass`);
-  } else {
+  } else if (status === "FAIL") {
     const lines = [];
-    for (const r of failed) {
-      if (!r.report) {
-        lines.push(`${r.dir}: audit report unavailable`);
-        lines.push(...r.output.split("\n").filter(Boolean).slice(0, 10));
-        continue;
-      }
+    for (const r of realVulns) {
       lines.push(`${r.dir}: ${r.highCritical} high/critical advisory item(s)`);
       lines.push(...vulnerableNames(r.report).slice(0, 10));
     }
     details = lines.slice(0, 20);
+  } else {
+    const lines = [];
+    for (const r of unparseable) {
+      lines.push(`${r.dir}: audit report unavailable (non-blocking)`);
+      lines.push(...r.output.split("\n").filter(Boolean).slice(0, 6));
+    }
+    details = lines.slice(0, 20);
   }
   try {
     const block = await emitGateResult(
@@ -1952,7 +1956,7 @@ __export(pack_smoke_exports, {
   severity: () => severity10
 });
 import { spawnSync as spawnSync10 } from "node:child_process";
-import { mkdtempSync as mkdtempSync2, rmSync as rmSync2, mkdirSync as mkdirSync3, writeFileSync as writeFileSync4, readdirSync as readdirSync4, existsSync as existsSync3 } from "node:fs";
+import { mkdtempSync as mkdtempSync2, rmSync as rmSync2, mkdirSync as mkdirSync3, writeFileSync as writeFileSync4, readdirSync as readdirSync4, existsSync as existsSync4 } from "node:fs";
 import { join as join9, resolve } from "node:path";
 import { tmpdir as tmpdir2 } from "node:os";
 async function run10(ctx) {
@@ -2034,7 +2038,7 @@ async function run10(ctx) {
     ];
     let binPath = null;
     for (const c2 of binCandidates) {
-      if (existsSync3(c2)) {
+      if (existsSync4(c2)) {
         binPath = c2;
         break;
       }
@@ -2110,7 +2114,7 @@ __export(upgrade_smoke_exports, {
   severity: () => severity11
 });
 import { spawnSync as spawnSync11 } from "node:child_process";
-import { mkdtempSync as mkdtempSync3, rmSync as rmSync3, mkdirSync as mkdirSync4, writeFileSync as writeFileSync5, readFileSync as readFileSync4, existsSync as existsSync4, cpSync } from "node:fs";
+import { mkdtempSync as mkdtempSync3, rmSync as rmSync3, mkdirSync as mkdirSync4, writeFileSync as writeFileSync5, readFileSync as readFileSync4, existsSync as existsSync5, cpSync } from "node:fs";
 import { join as join10, resolve as resolve2 } from "node:path";
 import { tmpdir as tmpdir3 } from "node:os";
 async function run11(ctx) {
@@ -2185,7 +2189,7 @@ async function run11(ctx) {
     ];
     let installerBin = null;
     for (const c2 of binCandidates) {
-      if (existsSync4(c2)) {
+      if (existsSync5(c2)) {
         installerBin = c2;
         break;
       }
@@ -2203,12 +2207,12 @@ async function run11(ctx) {
     mkdirSync4(targetIjfwHome, { recursive: true });
     for (const sub of ["claude", "mcp-server"]) {
       const src = join10(ctx.repoRoot, sub);
-      if (existsSync4(src)) {
+      if (existsSync5(src)) {
         cpSync(src, join10(targetIjfwHome, sub), { recursive: true });
       }
     }
     const installerPkgSrc = join10(ctx.repoRoot, "installer", "package.json");
-    if (existsSync4(installerPkgSrc)) {
+    if (existsSync5(installerPkgSrc)) {
       mkdirSync4(join10(targetIjfwHome, "installer"), { recursive: true });
       cpSync(installerPkgSrc, join10(targetIjfwHome, "installer", "package.json"));
     }
@@ -2252,7 +2256,7 @@ async function run11(ctx) {
       };
     }
     const settingsPath = join10(claudeDir, "settings.json");
-    if (!existsSync4(settingsPath)) {
+    if (!existsSync5(settingsPath)) {
       return {
         name: "upgrade-smoke",
         status: "FAIL",
@@ -2289,7 +2293,7 @@ async function run11(ctx) {
       };
     }
     const marketplaceSrc = join10(installerDir, "src", "marketplace.js");
-    if (existsSync4(marketplaceSrc)) {
+    if (existsSync5(marketplaceSrc)) {
       const src = readFileSync4(marketplaceSrc, "utf8");
       const registersCorrectKey = src.includes("'ijfw@ijfw'") || src.includes('"ijfw@ijfw"');
       const registersWrongKey = /enabledPlugins\[['"]ijfw-core@ijfw['"]\]\s*=\s*true/.test(src);
@@ -2345,7 +2349,7 @@ var preflight_exports = {};
 __export(preflight_exports, {
   runPreflightCommand: () => runPreflightCommand
 });
-import { readFileSync as readFileSync5, existsSync as existsSync5 } from "node:fs";
+import { readFileSync as readFileSync5, existsSync as existsSync6 } from "node:fs";
 import { join as join11, dirname as dirname3, resolve as resolve3 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 function printHelp() {
@@ -2387,7 +2391,7 @@ function loadVersions(repoRoot2) {
     join11(repoRoot2, ".ijfw", "preflight-versions.json")
   ];
   for (const f of candidates) {
-    if (existsSync5(f)) {
+    if (existsSync6(f)) {
       try {
         return JSON.parse(readFileSync5(f, "utf8"));
       } catch {
@@ -2448,7 +2452,7 @@ async function runPreflightCommand(argv, repoRoot2) {
 function defaultRepoRoot() {
   let dir = __dirname;
   for (let i = 0; i < 8; i++) {
-    if (existsSync5(join11(dir, "package.json")) && existsSync5(join11(dir, "mcp-server"))) return dir;
+    if (existsSync6(join11(dir, "package.json")) && existsSync6(join11(dir, "mcp-server"))) return dir;
     const next = resolve3(dir, "..");
     if (next === dir) break;
     dir = next;
@@ -3728,7 +3732,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
 // src/ijfw.js
 import { dirname as dirname4, join as join12, resolve as resolve4, basename as basename2 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
-import { existsSync as existsSync6, mkdirSync as mkdirSync5, copyFileSync as copyFileSync3, readdirSync as readdirSync5, rmSync as rmSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync6 } from "node:fs";
+import { existsSync as existsSync7, mkdirSync as mkdirSync5, copyFileSync as copyFileSync3, readdirSync as readdirSync5, rmSync as rmSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync6 } from "node:fs";
 import { homedir, platform } from "node:os";
 import { spawnSync as spawnSync12 } from "node:child_process";
 
@@ -3929,6 +3933,26 @@ var COMMAND_REGISTRY = Object.freeze([
     since: "1.4.0",
     status: "active"
   },
+  {
+    name: "personalize",
+    tier: "coordination",
+    owner: "orchestrator",
+    description: "Control the profile-bus learning feature (on|off|status|forget)",
+    aliases: [],
+    since: "1.6.0",
+    status: "active",
+    notes: 'Opt-in injection control. `on`/`off` toggle whether your learned style is added to prompts; `status` shows flags + what was inferred; `forget` deletes inferences. Capture is always local; injection defaults to "ask".'
+  },
+  {
+    name: "checkpoint",
+    tier: "coordination",
+    owner: "orchestrator",
+    description: "Snapshot swarm/memory state (alias for `memory checkpoint`)",
+    aliases: [],
+    since: "1.6.0",
+    status: "active",
+    notes: "Thin top-level alias forwarding to `ijfw memory checkpoint <label>`. Added so the documented bare verb routes instead of returning Unknown."
+  },
   {
     name: "design",
     tier: "coordination",
@@ -4002,6 +4026,16 @@ var COMMAND_REGISTRY = Object.freeze([
     since: "1.5.0",
     status: "active"
   },
+  {
+    name: "worktree",
+    tier: "plumbing",
+    owner: "orchestrator",
+    description: "Manage swarm task worktrees (alias for `swarm worktree`)",
+    aliases: [],
+    since: "1.6.0",
+    status: "active",
+    notes: "Thin top-level alias forwarding to `ijfw swarm worktree \u2026`. Added so the documented bare verb routes instead of returning Unknown."
+  },
   {
     name: "--purge-receipts",
     tier: "plumbing",
@@ -4194,10 +4228,52 @@ function commandsByTier() {
 
 // src/ijfw.js
 var __dirname2 = dirname4(fileURLToPath3(import.meta.url));
+var LAUNCHER_VERB_REDIRECTS = {
+  on: "Did you mean:  ijfw install   \xB7   or  ijfw personalize on",
+  marketplace: "Not available in this release \u2014 install via `ijfw install` or your agent's native plugin marketplace UI.",
+  cluster: "Multi-machine cluster mode is a design milestone, not shipped in this release.",
+  "wave-status": "Did you mean:  ijfw swarm status",
+  "worktree-drain": "Did you mean:  ijfw worktree cleanup <task-id>"
+};
+function launcherEditDistance(a, b2) {
+  a = String(a);
+  b2 = String(b2);
+  const m2 = a.length, n = b2.length;
+  if (!m2) return n;
+  if (!n) return m2;
+  let prev = Array.from({ length: n + 1 }, (_2, j2) => j2);
+  const cur = Array.from({ length: n + 1 });
+  for (let i = 1; i <= m2; i++) {
+    cur[0] = i;
+    for (let j2 = 1; j2 <= n; j2++) {
+      const cost = a[i - 1] === b2[j2 - 1] ? 0 : 1;
+      cur[j2] = Math.min(prev[j2] + 1, cur[j2 - 1] + 1, prev[j2 - 1] + cost);
+    }
+    prev = cur.slice();
+  }
+  return prev[n];
+}
+function launcherSuggest(raw) {
+  const q2 = String(raw || "").toLowerCase();
+  if (Object.prototype.hasOwnProperty.call(LAUNCHER_VERB_REDIRECTS, q2)) {
+    return LAUNCHER_VERB_REDIRECTS[q2];
+  }
+  const candidates = [...ALL_COMMAND_NAMES, ...ORCHESTRATOR_COMMAND_NAMES, ...INSTALLER_DIRECT_COMMAND_NAMES].filter((c2) => c2 && !c2.startsWith("--"));
+  let best = null, bestD = Infinity;
+  for (const c2 of candidates) {
+    const d = launcherEditDistance(q2, c2.toLowerCase());
+    if (d < bestD) {
+      bestD = d;
+      best = c2;
+    }
+  }
+  const tol = Math.max(2, Math.floor(0.4 * Math.max(q2.length, (best || "").length)));
+  return best && bestD <= tol ? `Did you mean:  ijfw ${best}` : null;
+}
 function repoRoot() {
   let dir = __dirname2;
   for (let i = 0; i < 6; i++) {
-    if (existsSync6(join12(dir, "package.json")) && existsSync6(join12(dir, ".git"))) return dir;
+    if (existsSync7(join12(dir, "package.json")) && existsSync7(join12(dir, ".git"))) return dir;
     dir = resolve4(dir, "..");
   }
   return process.cwd();
@@ -4206,7 +4282,7 @@ function findInternalAsset(...rel) {
   const root = repoRoot();
   const ijfwHome = join12(homedir(), ".ijfw");
   const candidates = [join12(root, ...rel), join12(ijfwHome, ...rel)];
-  return candidates.find((p) => existsSync6(p)) || null;
+  return candidates.find((p) => existsSync7(p)) || null;
 }
 function readDashboardPort() {
   const portFile = join12(homedir(), ".ijfw", "dashboard.port");
@@ -4266,7 +4342,7 @@ function findCli() {
     join12(repoRoot(), "mcp-server", "src", "cross-orchestrator-cli.js"),
     join12(homedir(), ".ijfw", "mcp-server", "src", "cross-orchestrator-cli.js")
   ];
-  return candidates.find((p) => existsSync6(p)) || null;
+  return candidates.find((p) => existsSync7(p)) || null;
 }
 function delegateToCli(argTail) {
   const cli = findCli();
@@ -4425,7 +4501,7 @@ async function main() {
             console.error("Design companion accepts standalone .html files.");
             process.exit(1);
           }
-          if (!existsSync6(abs)) {
+          if (!existsSync7(abs)) {
             console.error(`File not found: ${abs}`);
             process.exit(1);
           }
@@ -4453,9 +4529,9 @@ async function main() {
         resolve4(__dirname2, "..", "docs", "GUIDE.md"),
         join12(homedir(), ".ijfw", "docs", "GUIDE.md")
       ];
-      const guidePath = candidates.find((p) => existsSync6(p));
+      const guidePath = candidates.find((p) => existsSync7(p));
       if (!guidePath) {
-        console.error("[ijfw] Guide not found. Run `ijfw install` to fetch the full guide, or visit https://gitlab.com/therealseandonahoe/ijfw/-/blob/main/docs/GUIDE.md");
+        console.error("[ijfw] Guide not found. Run `ijfw install` to fetch the full guide, or visit https://github.com/FerroxLabs/ijfw/blob/main/docs/GUIDE.md");
         process.exit(1);
       }
       if (wantsBrowser) {
@@ -4463,7 +4539,7 @@ async function main() {
         const assetsSrc = join12(dirname4(guidePath), "guide", "assets");
         const outDir = join12(homedir(), ".ijfw", "guide");
         mkdirSync5(join12(outDir, "assets"), { recursive: true });
-        if (existsSync6(assetsSrc)) {
+        if (existsSync7(assetsSrc)) {
           for (const f of readdirSync5(assetsSrc)) {
             copyFileSync3(join12(assetsSrc, f), join12(outDir, "assets", f));
           }
@@ -4516,8 +4592,10 @@ async function main() {
       break;
     }
     default: {
-      console.error(`Unknown subcommand: ${sub}`);
-      printHelp2();
+      console.error(`Unknown command: ${sub}`);
+      const hint = launcherSuggest(sub);
+      if (hint) console.error(hint);
+      console.error("Run `ijfw --help` for the user-facing command list, or `ijfw commands` for the full surface.");
       process.exit(1);
     }
   }

package/dist/install.js

@@ -61,6 +61,44 @@ function nativePath(p) {
   if (p == null) return p;
   return normalize(String(p));
 }
+function isProjectWritable(cwd, home) {
+  if (!cwd || typeof cwd !== "string") return false;
+  let candReal;
+  try {
+    candReal = realpathSync(cwd);
+  } catch {
+    try {
+      candReal = resolve3(cwd);
+    } catch {
+      return false;
+    }
+  }
+  if (!candReal || candReal === "/" || candReal === sep) return false;
+  const rawHome = home && typeof home === "string" && home.length > 0 ? home : homedir2();
+  if (!rawHome) return false;
+  let homeRealPath;
+  try {
+    homeRealPath = realpathSync(rawHome);
+  } catch {
+    try {
+      homeRealPath = resolve3(rawHome);
+    } catch {
+      return false;
+    }
+  }
+  if (!homeRealPath) return false;
+  if (candReal === homeRealPath) return false;
+  return true;
+}
+function guardProjectWrite(cwd, home, opts = {}) {
+  if (isProjectWritable(cwd, home)) return true;
+  const label = opts.platformLabel || "project rules";
+  const info = opts.log && typeof opts.log.info === "function" ? opts.log.info : printInfo;
+  info(
+    `Run \`ijfw install\` from a project directory to install ${label}; skipped (cwd is your home directory).`
+  );
+  return false;
+}
 function writeAtomic(path3, contents, opts = {}) {
   const mode = opts.mode ?? 384;
   mkdirSync2(dirname3(path3), { recursive: true });
@@ -847,7 +885,10 @@ async function installCodex(ctx) {
     copyIfAbsent(f.path, join4(userCommands, f.name));
   }
   const cwd = ctx.cwd || process.cwd();
-  if (existsSync4(join4(cwd, ".codex", "config.toml")) || existsSync4(join4(cwd, ".ijfw"))) {
+  if (guardProjectWrite(cwd, ctx.home, {
+    platformLabel: "Codex project skills/commands",
+    log: ctx.log
+  }) && (existsSync4(join4(cwd, ".codex", "config.toml")) || existsSync4(join4(cwd, ".ijfw")))) {
     const projSkills = join4(cwd, ".codex", "skills");
     ensureDir(projSkills);
     for (const sd of listSubdirs(repoSkills)) {
@@ -942,9 +983,9 @@ async function installWayland(ctx) {
       "Custom-dir install -- skipping ~/.wayland/ merges."
     );
   }
-  const dst = join4(ctx.home, ".wayland", "config.yaml");
-  ensureDir(dirname4(dst));
-  mergeYamlMcp(dst, ctx.serverJsNative);
+  const pluginToml = join4(ctx.home, ".wayland", "plugins", "ijfw", "plugin.toml");
+  ensureDir(dirname4(pluginToml));
+  writeFileSync3(pluginToml, renderWaylandPluginToml(ctx), { encoding: "utf8" });
   ensureDir(join4(ctx.home, ".wayland"));
   copyIfAbsent(
     join4(ctx.repoRoot, "wayland", "WAYLAND.md"),
@@ -955,56 +996,61 @@ async function installWayland(ctx) {
   for (const sd of listSubdirs(sharedSkills)) {
     copyDirIfAbsent(sd.path, join4(ctx.home, ".wayland", "skills", sd.name));
   }
-  const pluginSrc = join4(ctx.repoRoot, "wayland", "plugins", "ijfw");
-  if (existsSync4(pluginSrc)) {
-    const pluginDst = join4(ctx.home, ".wayland", "plugins", "ijfw");
-    ensureDir(pluginDst);
-    let entries;
-    let readdirErr = null;
-    try {
-      entries = readdirSync(pluginSrc);
-    } catch (err) {
-      entries = [];
-      readdirErr = err;
-    }
-    if (readdirErr) {
-      ctx.log.warn(`Wayland plugin tree readdir failed: ${readdirErr.message || readdirErr}`);
-    }
-    const srcNames = new Set(entries.filter((n) => n !== "__pycache__"));
-    let dstEntries = [];
-    try {
-      dstEntries = readdirSync(pluginDst);
-    } catch {
-    }
-    for (const name of dstEntries) {
-      if (name === "__pycache__") continue;
-      if (!srcNames.has(name)) {
-        try {
-          rmSync(join4(pluginDst, name), { recursive: true, force: true });
-        } catch (err) {
-          ctx.log.warn(`Wayland plugin: could not remove stale ${name}: ${err.message || err}`);
-        }
-      }
-    }
-    for (const name of entries) {
-      if (name === "__pycache__") continue;
-      const src = join4(pluginSrc, name);
-      const dstEntry = join4(pluginDst, name);
-      try {
-        const st = statSync2(src);
-        if (st.isDirectory()) {
-          cpSync(src, dstEntry, { recursive: true, force: true });
-        } else if (st.isFile()) {
-          copyFileSync2(src, dstEntry);
-        }
-      } catch {
-      }
-    }
-  }
-  mergeYamlHook(dst, "plugins/ijfw/hooks/pre_tool_use_extension_check.py", ctx.ts);
-  ctx.log.ok("Installed Wayland bundle: MCP + WAYLAND.md + skills + plugin + tier-2 hook");
+  ctx.log.ok("Installed Wayland bundle: declarative plugin.toml + WAYLAND.md + skills");
   return { status: "ok" };
 }
+function ijfwVersion(ctx) {
+  try {
+    const pkg = JSON.parse(
+      readFileSync3(join4(ctx.repoRoot, "installer", "package.json"), "utf8")
+    );
+    if (pkg && typeof pkg.version === "string" && pkg.version) return pkg.version;
+  } catch {
+  }
+  return "0.0.0";
+}
+function tomlBasicString(value) {
+  return String(value).replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+function renderWaylandPluginToml(ctx) {
+  const serverJs = tomlBasicString(ctx.serverJsNative);
+  const version = tomlBasicString(ijfwVersion(ctx));
+  return [
+    "[plugin]",
+    'name = "wayland-ijfw"',
+    `version = "${version}"`,
+    'description = "IJFW memory + lifecycle hooks for Wayland Core"',
+    'license = "MIT"',
+    "",
+    "[permissions]",
+    "register_hooks = true",
+    "register_mcp_server = true",
+    "",
+    "[runtime]",
+    'kind = "declarative"',
+    "",
+    "[mcp_server]",
+    'name = "ijfw-memory"',
+    "",
+    "[mcp_server.transport]",
+    'kind = "stdio"',
+    'command = "node"',
+    `args = ["${serverJs}"]`,
+    "",
+    // Only session_start and pre_prompt dispatch in Wayland today; the
+    // post_tool_use / session_end / pre_compact phases are registered-but-
+    // log-only on the Wayland side, so they are intentionally omitted. Add
+    // them here once Wayland wires those phases.
+    "[[hooks]]",
+    'phase = "session_start"',
+    'tool = "ijfw_memory_prelude"',
+    "",
+    "[[hooks]]",
+    'phase = "pre_prompt"',
+    'tool = "ijfw_memory_recall"',
+    ""
+  ].join("\n");
+}
 async function installHermes(ctx) {
   if (ctx.ijfwCustomDir) {
     return customDirNoop(
@@ -1093,6 +1139,13 @@ async function installCursor(ctx) {
     );
   }
   const cwd = ctx.cwd || process.cwd();
+  if (!guardProjectWrite(cwd, ctx.home, {
+    platformLabel: "Cursor project rules",
+    log: ctx.log
+  })) {
+    ctx.log.ok("Cursor: real platform config left untouched.");
+    return { status: "noop" };
+  }
   const dst = join4(cwd, ".cursor", "mcp.json");
   ensureDir(dirname4(dst));
   mergeJson(dst, ctx.serverJsNative);
@@ -1121,6 +1174,13 @@ async function installWindsurf(ctx) {
   ensureDir(dirname4(dst));
   mergeJson(dst, ctx.serverJsNative);
   const cwd = ctx.cwd || process.cwd();
+  if (!guardProjectWrite(cwd, ctx.home, {
+    platformLabel: "Windsurf project rules (.windsurfrules)",
+    log: ctx.log
+  })) {
+    ctx.log.ok(`Merged MCP into ${dst}`);
+    return { status: "ok" };
+  }
   const projectRules = join4(cwd, ".windsurfrules");
   const repoRules = join4(ctx.repoRoot, "windsurf", ".windsurfrules");
   let installedRules = false;
@@ -1181,10 +1241,18 @@ function installCopilot(ctx) {
     printOk("Copilot: source tree left untouched.");
     return { status: "noop" };
   }
-  const dst = path.join(process.cwd(), ".vscode", "mcp.json");
+  const cwd = ctx.cwd || process.cwd();
+  if (!guardProjectWrite(cwd, ctx.home, {
+    platformLabel: "Copilot project rules",
+    log: ctx.log
+  })) {
+    printOk("Copilot: real platform config left untouched.");
+    return { status: "noop" };
+  }
+  const dst = path.join(cwd, ".vscode", "mcp.json");
   ensureDir2(path.dirname(dst));
   mergeJson(dst, ctx.serverJsNative || ctx.serverJs);
-  const rulesDst = path.join(process.cwd(), ".github", "copilot-instructions.md");
+  const rulesDst = path.join(cwd, ".github", "copilot-instructions.md");
   const rulesSrc = path.join(ctx.repoRoot, "copilot", "copilot-instructions.md");
   const wroteRules = copyIfMissing(rulesSrc, rulesDst);
   if (wroteRules) {
@@ -1302,6 +1370,18 @@ function installAntigravity(ctx) {
   printOk(`Merged MCP into ${ideDst} + ${cliDst} (Antigravity IDE + CLI)`);
   return { status: "ok" };
 }
+function installPi(ctx) {
+  if (ctx.ijfwCustomDir) {
+    printInfo("Custom-dir install -- skipping Pi merges.");
+    printOk("Pi: real platform config left untouched.");
+    return { status: "noop" };
+  }
+  const agentsSrc = path.join(ctx.repoRoot, "pi", "AGENTS.md");
+  const agentsDst = path.join(ctx.home, ".pi", "agent", "AGENTS.md");
+  copyIfMissing(agentsSrc, agentsDst);
+  printOk("Pi: rules-only install (~/.pi/agent/AGENTS.md). No MCP -- Pi has no native MCP client (extension bridge required for memory).");
+  return { status: "ok" };
+}
 var init_install_targets_8_14 = __esm({
   "src/install-targets-8-14.js"() {
     init_install_helpers();
@@ -1931,7 +2011,8 @@ var init_install_flow = __esm({
       "kimi",
       "openclaw",
       "aider",
-      "antigravity"
+      "antigravity",
+      "pi"
     ];
     TARGET_FNS = {
       claude: installClaude,
@@ -1948,7 +2029,8 @@ var init_install_flow = __esm({
       kimi: installKimi,
       openclaw: installOpenclaw,
       aider: installAider,
-      antigravity: installAntigravity
+      antigravity: installAntigravity,
+      pi: installPi
     };
     install_flow_default = { runInstall, CANONICAL_ORDER };
   }

package/dist/uninstall.js

@@ -2,9 +2,10 @@
 
 // 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 { resolve as resolve2, join as join2, dirname as dirname2 } 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";
@@ -95,6 +96,30 @@ function unmergeMarketplace(settingsPath = claudeSettingsPath()) {
 }
 
 // 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.
+    join2(root, "aider", name),
+    // (a') repo root with staged templates under installer/.
+    join2(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 (existsSync2(c)) return c;
+    } catch {
+    }
+  }
+  return "";
+}
 function writeAtomic(target, content) {
   const tmp = `${target}.tmp.${process.pid}.${Date.now()}`;
   writeFileSync2(tmp, content);
@@ -160,6 +185,54 @@ function backupFile(p) {
   }
   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 (!existsSync2(p)) return null;
+    let text;
+    try {
+      text = readFileSync2(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;
   backupFile(p);
@@ -195,6 +268,82 @@ function removeJsonMcpEntry(p) {
   }
   return changed;
 }
+function removeNestedMcpEntry(p, keyPath) {
+  try {
+    if (!existsSync2(p)) return false;
+    let doc;
+    try {
+      doc = JSON.parse(readFileSync2(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 || join2(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")
+    ];
+  } else if (process.platform === "win32") {
+    userDirs = [
+      join2(APPDATA, "Code", "User"),
+      join2(APPDATA, "Code - Insiders", "User"),
+      join2(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")
+    ];
+  }
+  for (const d of userDirs) {
+    const settings = join2(d, "globalStorage", ext, "settings", "cline_mcp_settings.json");
+    if (existsSync2(settings)) return settings;
+  }
+  return null;
+}
+function removeAiderFileIfPristine(installedPath, templatePath) {
+  try {
+    if (!existsSync2(installedPath)) return "absent";
+    if (!existsSync2(templatePath)) return "kept-modified";
+    let a, b;
+    try {
+      a = readFileSync2(installedPath);
+      b = readFileSync2(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;
   let doc;
@@ -322,60 +471,174 @@ function removeCodexCommands(dir) {
   }
   return count;
 }
-function cleanPlatforms() {
+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 (removeTomlSection(join2(home, ".codex", "config.toml"))) {
     removed.push("~/.codex/config.toml  (removed [mcp_servers.ijfw-memory])");
   }
-  if (removeCodexHooks(join2(HOME, ".codex", "hooks.json"))) {
+  if (removeCodexHooks(join2(home, ".codex", "hooks.json"))) {
     removed.push("~/.codex/hooks.json  (removed IJFW hook entries)");
   }
-  const codexSkills = removeIjfwSkills(join2(HOME, ".codex", "skills"));
+  const codexSkills = removeIjfwSkills(join2(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(join2(home, ".codex", "commands"));
   if (codexCommands > 0) removed.push(`~/.codex/commands  (removed ${codexCommands} IJFW command aliases)`);
-  const codexMd = join2(HOME, ".codex", "IJFW.md");
+  const codexMd = join2(home, ".codex", "IJFW.md");
   if (existsSync2(codexMd)) {
     rmSync(codexMd, { force: true });
     removed.push("~/.codex/IJFW.md");
   }
-  if (removeJsonMcpEntry(join2(HOME, ".gemini", "settings.json"))) {
+  if (removeJsonMcpEntry(join2(home, ".gemini", "settings.json"))) {
     removed.push("~/.gemini/settings.json  (removed ijfw-memory)");
   }
-  const geminiExt = join2(HOME, ".gemini", "extensions", "ijfw");
+  const geminiExt = join2(home, ".gemini", "extensions", "ijfw");
   if (existsSync2(geminiExt)) {
     rmSync(geminiExt, { recursive: true, force: true });
     removed.push("~/.gemini/extensions/ijfw/");
   }
-  const cursorMcp = join2(".cursor", "mcp.json");
+  const cursorMcp = join2(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(join2(home, ".codeium", "windsurf", "mcp_config.json"))) {
     removed.push("~/.codeium/windsurf/mcp_config.json  (removed ijfw-memory)");
   }
-  const vscodeMcp = join2(".vscode", "mcp.json");
+  const vscodeMcp = join2(cwd, ".vscode", "mcp.json");
   if (removeJsonMcpEntry(vscodeMcp)) removed.push(".vscode/mcp.json  (removed ijfw-memory)");
-  if (removeYamlMcpEntry(join2(HOME, ".hermes", "config.yaml"))) {
+  if (removeYamlMcpEntry(join2(home, ".hermes", "config.yaml"))) {
     removed.push("~/.hermes/config.yaml  (removed ijfw-memory)");
   }
-  const hermesSkills = removeIjfwSkills(join2(HOME, ".hermes", "skills"));
+  const hermesSkills = removeIjfwSkills(join2(home, ".hermes", "skills"));
   if (hermesSkills > 0) removed.push(`~/.hermes/skills/ijfw-*  (removed ${hermesSkills} skill dirs)`);
-  const hermesMd = join2(HOME, ".hermes", "HERMES.md");
+  const hermesMd = join2(home, ".hermes", "HERMES.md");
   if (existsSync2(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 waylandPluginDir = join2(home, ".wayland", "plugins", "ijfw");
+  if (existsSync2(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(join2(home, ".wayland", "config.yaml"))) {
+    removed.push("~/.wayland/config.yaml  (removed legacy ijfw-memory)");
+  }
+  const waylandSkills = removeIjfwSkills(join2(home, ".wayland", "skills"));
   if (waylandSkills > 0) removed.push(`~/.wayland/skills/ijfw-*  (removed ${waylandSkills} skill dirs)`);
-  const waylandMd = join2(HOME, ".wayland", "WAYLAND.md");
+  const waylandMd = join2(home, ".wayland", "WAYLAND.md");
   if (existsSync2(waylandMd)) {
     rmSync(waylandMd, { force: true });
     removed.push("~/.wayland/WAYLAND.md");
   }
+  if (removeJsonMcpEntry(join2(home, ".qwen", "settings.json"))) {
+    removed.push("~/.qwen/settings.json  (removed ijfw-memory)");
+  }
+  if (removeJsonMcpEntry(join2(home, ".kimi", "mcp.json"))) {
+    removed.push("~/.kimi/mcp.json  (removed ijfw-memory)");
+  }
+  if (removeJsonMcpEntry(join2(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"))) {
+    removed.push("~/.gemini/config/mcp_config.json  (removed ijfw-memory)");
+  }
+  if (removeNestedMcpEntry(join2(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"])) {
+    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 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(
+    join2(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(
+    join2(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 (!existsSync2(registryPath)) return [];
+    const raw = readFileSync2(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 || join2(home, ".ijfw", "registry.md");
+  const results = [];
+  for (const projPath of parseRegistryPaths(registryPath)) {
+    let dirExists = false;
+    try {
+      dirExists = existsSync2(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) });
+      if (status) results.push(status);
+    }
+  }
+  try {
+    const cursorRule = join2(cwd, ".cursor", "rules", "ijfw.mdc");
+    if (existsSync2(cursorRule)) {
+      backupFile(cursorRule);
+      rmSync(cursorRule, { force: true });
+      results.push(".cursor/rules/ijfw.mdc  (removed -- wholly IJFW-authored)");
+    }
+  } catch {
+  }
+  const windsurfStatus = stripMarkerFile(join2(cwd, ".windsurfrules"), {
+    label: ".windsurfrules",
+    deleteIfEmpty: true
+  });
+  if (windsurfStatus) results.push(windsurfStatus);
+  const copilotStatus = stripMarkerFile(join2(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);
@@ -433,13 +696,32 @@ 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}`);
+    }
   } 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
+};

package/docs/GUIDE.md

@@ -232,11 +232,30 @@ Every command ships in three forms: a shell command, a Claude Code slash command
 | Command | Purpose |
 |---------|---------|
 | `ijfw memory checkpoint "<text>"` | Snapshot a decision, pattern, or note to local memory. |
+| `ijfw checkpoint "<text>"` | Top-level shortcut for `ijfw memory checkpoint`. |
 | `ijfw memory search "<query>"` | BM25 ranked search over local memory. Add `--scope all` to search every registered IJFW project. |
 | `ijfw import claude-mem` | Absorb existing claude-mem SQLite memory into IJFW markdown. |
 | `ijfw import claude-mem --all` | Discover projects automatically, import in bulk. |
 | `ijfw import claude-mem --dry-run` | Show what would happen first. |
 
+### Personalize (profile-bus learning)
+
+IJFW can learn your low-sensitivity interaction *style* (verbosity, formality,
+code-vs-prose) locally and — only if you opt in — include a short brief in
+prompts so agents match it. Capture is always local and never includes raw
+text. Injection is **off until you turn it on**.
+
+| Command | Purpose |
+|---------|---------|
+| `ijfw personalize status` | Show the current flags plus a summary of what was inferred. |
+| `ijfw personalize on` | Enable injecting the learned low-sensitivity style brief into prompts. |
+| `ijfw personalize off` | Disable injection. Capture continues locally. |
+| `ijfw personalize forget [pattern]` | Delete inferences (no pattern = forget all). |
+| `ijfw personalize share-sensitive on\|off` | Allow/deny medium+high-sensitivity prefs to allowlisted hosts. Default off. |
+
+Hard override: set `IJFW_PROFILE_KILL=1` to force-disable all injection
+regardless of these settings.
+
 ### Multi-AI Trident
 
 | Command | Purpose |
@@ -521,7 +540,7 @@ Runtime: zero npm dependencies. Tokens: the cross-AI Trident uses your existing
 Yes, and verifiable in your own metrics. Sources: right-model dispatch (a cheaper tier when adequate, the heavyweight when needed), prompt cache discipline, output rules that cut padding, context discipline that stops re-pasting. Typical observed: 25 percent or more output reduction versus unmanaged baseline. The log is in your project.
 
 **Can I turn it off?**
-Yes. `ijfw off` disables the core skill. Each command is isolated. The MCP server can be unregistered per platform. Backups are timestamped. Nothing is sticky.
+Yes. `ijfw off` removes what IJFW added: it unregisters the MCP server across all 15 platforms, deletes IJFW skill/command/context files, and strips IJFW's managed marker regions out of every project `CLAUDE.md` / `AGENTS.md` it ever touched -- your own content in those files is preserved. Every file it edits is backed up with a timestamped `.bak` first. Your memory at `~/.ijfw/memory/` is kept (delete by hand, or `ijfw off --purge` to remove it too). Files it can't prove were IJFW-authored (e.g. hand-edited Aider rules) are left in place and called out so you can remove them yourself.
 
 **What about my existing memory in claude-mem or other tools?**
 `ijfw import claude-mem` round-trips the SQLite store into IJFW markdown. Idempotent. Safe to rerun. `--dry-run` shows what would happen first.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ijfw/install",
-  "version": "1.5.5",
+  "version": "1.6.0",
   "description": "One-command installer for IJFW -- the AI efficiency layer. One install, every AI coding agent, zero config.",
   "type": "module",
   "bin": {
@@ -13,6 +13,7 @@
     "src/install.ps1",
     "docs/GUIDE.md",
     "docs/guide/assets",
+    "templates/aider/**",
     "scripts/pack-hub-extension.js",
     "scripts/hub-extension/**",
     "README.md",
@@ -21,8 +22,9 @@
   ],
   "scripts": {
     "build": "node scripts/build.js",
-    "test": "node --test test.js",
+    "test": "node --test test.js test/uninstall-completeness.test.mjs test/project-write-guard.test.mjs",
     "test:hub-extension": "node --test test/test-pack-hub-extension.js",
+    "test:uninstall-completeness": "node --test test/uninstall-completeness.test.mjs",
     "preflight": "node dist/ijfw.js preflight",
     "pack:check": "npm pack --dry-run",
     "pack:hub-extension": "node scripts/pack-hub-extension.js",

package/src/install.ps1

@@ -6,7 +6,7 @@
 #   -> merge marketplace into %USERPROFILE%\.claude\settings.json -> summary.
 #
 # Usage:
-#   Invoke-Expression (iwr https://gitlab.com/therealseandonahoe/ijfw/-/raw/main/installer/src/install.ps1).Content
+#   Invoke-Expression (iwr https://raw.githubusercontent.com/FerroxLabs/ijfw/main/installer/src/install.ps1).Content
 #   or:
 #   .\install.ps1 -Dir C:\Users\me\.ijfw -Branch main
 
@@ -19,7 +19,7 @@ param(
 )
 
 $ErrorActionPreference = "Stop"
-$DEFAULT_REPO = "https://gitlab.com/therealseandonahoe/ijfw.git"
+$DEFAULT_REPO = "https://github.com/FerroxLabs/ijfw.git"
 
 function Write-Ok($msg) { Write-Host "  [ok] $msg" -ForegroundColor Green }
 function Write-Info($msg) { Write-Host "  ... $msg" -ForegroundColor Gray }
@@ -101,7 +101,11 @@ function Invoke-CloneOrPull($target, $branch) {
       $currentOrigin = ($currentOriginRaw | Out-String).Trim()
       $stalePatterns = @(
         '^https://github\.com/seandonahoe/ijfw(\.git)?/?$',
-        '^https://github\.com/therealseandonahoe/ijfw(\.git)?/?$'
+        '^https://github\.com/therealseandonahoe/ijfw(\.git)?/?$',
+        # V155 rebrand: GitLab was canonical through v1.5.4; Windows users who
+        # installed from gitlab.com need their origin migrated forward to
+        # FerroxLabs/ijfw on GitHub. Mirrors install.js STALE_PATTERNS.
+        '^https://gitlab\.com/therealseandonahoe/ijfw(\.git)?/?$'
       )
       $isStale = $false
       foreach ($pat in $stalePatterns) {
@@ -278,7 +282,7 @@ function Remove-StalePosixLaunchers {
         $removed++
       }
     } catch {
-      # Best-effort: keep going on locked / inaccessible files.
+      $null = $_  # best-effort: keep going on locked / inaccessible files
     }
   }
   if ($removed -gt 0) {
@@ -319,7 +323,7 @@ function Provision-Plugin {
     }
     Copy-Item $srcItem.FullName $dstItem -Force
     # Preserve source mtime so next install doesn't mistake our copy for a user edit.
-    try { (Get-Item $dstItem -ErrorAction Stop).LastWriteTime = $srcItem.LastWriteTime } catch {}
+    try { (Get-Item $dstItem -ErrorAction Stop).LastWriteTime = $srcItem.LastWriteTime } catch { $null = $_ }
   }
 }
 

package/templates/aider/CONVENTIONS.md

@@ -0,0 +1,54 @@
+# IJFW Conventions for Aider
+
+<!-- Aider MCP support last verified: 2026-05-06 against https://aider.chat/docs/.
+     If Aider adds a native MCP client, regenerate this file and the rules-only
+     section in scripts/install.sh:aider). -->
+
+Aider doesn't have native MCP, so IJFW's memory + cross-audit tools aren't
+available inside Aider sessions. These conventions carry the IJFW spirit
+(disciplined workflow, terse output, no scope creep) into the Aider chat.
+
+## Workflow
+
+- One question at a time. Don't dump multi-step plans before user signs off.
+- Lead with the answer. No restating the question.
+- For multi-file changes, propose the plan in chat FIRST. Wait for user "go".
+
+## 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.
+- Default to writing no comments. Only add WHEN the WHY is non-obvious.
+
+## Memory + cross-audit
+
+Aider sessions don't see IJFW's persistent memory. After significant work:
+
+- Run `ijfw cross audit <file>` in your terminal to get Trident review.
+- Use `ijfw_memory_store` from Claude/Codex/Gemini sessions to persist
+  decisions Aider makes -- they won't survive otherwise.
+
+## Scope
+
+Stay in the lane the user asked for. If you spot adjacent issues, mention them
+in chat -- don't fix them silently.
+
+## DESIGN picker
+
+If the user asks for a design contract and no `DESIGN.md` exists, suggest one
+of the 12 IJFW curated templates (alphabetical):
+
+bento-grid, brutalist-luxe, cinematic-dark, data-dense-dashboard,
+editorial-warm, glassmorphic, magazine-editorial, maximalist-vibrant,
+neo-swiss-tech, swiss-minimal, terminal-native, warm-organic.
+
+Aider has no MCP client, so it cannot fetch the template body itself. Ask the
+user to run this in any MCP-capable sibling CLI on their machine (Claude Code
+/ Codex / Gemini / Cursor / Windsurf / Copilot / Hermes / Wayland / OpenCode /
+Qwen / Kimi / OpenClaw) and paste the output back into the Aider chat:
+
+    ijfw_memory_recall({ context_hint: "design_template:<name>" })
+
+Once the user pastes the body, Aider writes `DESIGN.md` at the project root
+and picks it up automatically on the next turn.

package/templates/aider/aider.conf.yml

@@ -0,0 +1,23 @@
+# IJFW-shipped Aider config. Aider has no native MCP client (1.1.7 status);
+# this file scaffolds project conventions + auto-loads CONVENTIONS.md so
+# IJFW principles travel into Aider sessions.
+#
+# Edit freely -- IJFW only writes this file if absent.
+
+# Auto-load IJFW conventions on every Aider session.
+read:
+  - ~/CONVENTIONS.md
+
+# Default model -- override per-session with --model or per-project.
+# model: gpt-4o
+# weak-model: gpt-4o-mini
+
+# Auto-commits OFF by default. Aider's auto-commit can produce noisy
+# history; IJFW workflow prefers atomic commits at gate boundaries.
+auto-commits: false
+
+# Show diffs in the chat for transparency.
+show-diffs: true
+
+# Subtree-only -- don't grep the entire monorepo every turn.
+subtree-only: true

package/dist/hub-index-snippet.json

@@ -1,49 +0,0 @@
-{
-  "name": "ijfw",
-  "displayName": "IJFW — AI Efficiency Layer",
-  "version": "1.5.5",
-  "description": "One install, every AI coding agent, zero config. Unifies 15 CLIs under a shared MCP memory layer so context follows you across Claude, Codex, Gemini, Cursor, Windsurf, and 10 more.",
-  "author": "Sean Donahoe",
-  "icon": "assets/ijfw-logo.svg",
-  "dist": {
-    "tarball": "extensions/ijfw-1.5.5.zip",
-    "integrity": "sha512-vm3ot0+GhXYy0/HcStB/xmFjZhSXWG7jzSLuIPe43/Dla8qhyR9gsCwBI/8+RsUJqMXiPgc0GuxrgwW2f5DDWA==",
-    "unpackedSize": 3312
-  },
-  "engines": {
-    "wayland": ">=0.6.0"
-  },
-  "hubs": [
-    "acpAdapters",
-    "mcpServers"
-  ],
-  "contributes": {
-    "acpAdapters": [
-      "claude",
-      "codex",
-      "gemini",
-      "cursor",
-      "windsurf",
-      "copilot",
-      "hermes",
-      "wayland",
-      "aider",
-      "opencode",
-      "qwencode",
-      "cline",
-      "kimicode",
-      "openclaw",
-      "antigravity"
-    ],
-    "mcpServers": [
-      "ijfw-memory"
-    ]
-  },
-  "tags": [
-    "ai",
-    "coding",
-    "mcp",
-    "memory",
-    "multi-agent"
-  ]
-}