@ijfw/install 1.5.6 → 1.6.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) {
@@ -1320,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, {
@@ -1859,6 +2063,7 @@ async function runInstall({
     });
   }
   pruneBackups({ home });
+  const preExistingDirs = snapshotPreExistingDirs(home);
   const live = [];
   const standby = [];
   const failed = [];
@@ -1913,6 +2118,7 @@ async function runInstall({
       standby.push(display);
     }
   }
+  writeLedger({ home, ijfwHome: resolvedIjfwHome, preExisting: preExistingDirs });
   printSummary({
     live,
     standby,
@@ -1928,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",
@@ -1970,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";
 
@@ -2133,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;
@@ -2143,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);
@@ -2189,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
 `);
 }
@@ -2223,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 [
@@ -2239,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 });
@@ -2254,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`);
@@ -2324,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 });
@@ -2342,7 +2551,7 @@ function cloneOrPull(dir, branch) {
     }
     let backupResidual = [];
     try {
-      backupResidual = readdirSync2(backupDir);
+      backupResidual = readdirSync3(backupDir);
     } catch {
     }
     if (backupResidual.length === 0) {
@@ -2354,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({
@@ -2381,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) {
@@ -2404,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();