@ijfw/install 1.1.0

package/dist/install.js

@@ -0,0 +1,279 @@
+#!/usr/bin/env node
+
+// src/install.js
+import { spawnSync } from "node:child_process";
+import { existsSync as existsSync2, rmSync, mkdirSync as mkdirSync2, realpathSync, renameSync as renameSync2 } from "node:fs";
+import { resolve, join as join2 } from "node:path";
+import { homedir as homedir2, platform } from "node:os";
+import { fileURLToPath } from "node:url";
+
+// src/marketplace.js
+import { readFileSync, writeFileSync, renameSync, existsSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+function claudeSettingsPath() {
+  return join(homedir(), ".claude", "settings.json");
+}
+function stripJsoncComments(raw) {
+  if (raw.charCodeAt(0) === 65279) raw = raw.slice(1);
+  let out = "";
+  let i = 0;
+  const n = raw.length;
+  const isLineBreak = (code) => code === 10 || code === 13 || code === 8232 || code === 8233;
+  while (i < n) {
+    const c = raw[i];
+    const c2 = raw[i + 1];
+    if (c === '"') {
+      out += c;
+      i++;
+      while (i < n) {
+        const k = raw[i];
+        out += k;
+        if (k === "\\" && i + 1 < n) {
+          out += raw[i + 1];
+          i += 2;
+          continue;
+        }
+        i++;
+        if (k === '"') break;
+      }
+      continue;
+    }
+    if (c === "/" && c2 === "/") {
+      i += 2;
+      while (i < n && !isLineBreak(raw.charCodeAt(i))) i++;
+      continue;
+    }
+    if (c === "/" && c2 === "*") {
+      i += 2;
+      while (i < n && !(raw[i] === "*" && raw[i + 1] === "/")) i++;
+      if (i < n) i += 2;
+      continue;
+    }
+    out += c;
+    i++;
+  }
+  return out;
+}
+function tolerantJsonParse(raw, filepath) {
+  try {
+    return JSON.parse(raw);
+  } catch {
+  }
+  const stripped = stripJsoncComments(raw).replace(/,(\s*[}\]])/g, "$1");
+  try {
+    return JSON.parse(stripped);
+  } catch (e) {
+    const err = new Error(`settings.json at ${filepath} is not valid JSON or recoverable JSONC: ${e.message}`);
+    err.code = "IJFW_SETTINGS_UNPARSEABLE";
+    throw err;
+  }
+}
+function mergeMarketplace(settingsPath = claudeSettingsPath()) {
+  let settings = {};
+  if (existsSync(settingsPath)) {
+    const raw = readFileSync(settingsPath, "utf8");
+    settings = tolerantJsonParse(raw, settingsPath);
+  } else {
+    mkdirSync(dirname(settingsPath), { recursive: true });
+  }
+  settings.extraKnownMarketplaces = settings.extraKnownMarketplaces || {};
+  settings.extraKnownMarketplaces.ijfw = {
+    source: { source: "github", repo: "TheRealSeanDonahoe/ijfw" }
+  };
+  settings.enabledPlugins = settings.enabledPlugins || {};
+  if ("ijfw-core@ijfw" in settings.enabledPlugins) {
+    delete settings.enabledPlugins["ijfw-core@ijfw"];
+  }
+  settings.enabledPlugins["ijfw@ijfw"] = true;
+  const tmp = settingsPath + ".tmp";
+  writeFileSync(tmp, JSON.stringify(settings, null, 2) + "\n");
+  renameSync(tmp, settingsPath);
+  return settings;
+}
+
+// src/install.js
+var DEFAULT_REPO = "https://github.com/TheRealSeanDonahoe/ijfw.git";
+var DEFAULT_BRANCH = "main";
+function parseArgs(argv) {
+  const out = { yes: false, dir: null, noMarketplace: false, branch: DEFAULT_BRANCH, branchExplicit: false, purge: false };
+  for (let i = 2; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--yes" || a === "-y") out.yes = true;
+    else if (a === "--dir") out.dir = argv[++i];
+    else if (a === "--no-marketplace") out.noMarketplace = true;
+    else if (a === "--branch") {
+      out.branch = argv[++i];
+      out.branchExplicit = true;
+    } else if (a === "--purge") out.purge = true;
+    else if (a === "--help" || a === "-h") {
+      printHelp();
+      process.exit(0);
+    }
+  }
+  return out;
+}
+function latestTagFromGithub() {
+  try {
+    const res = spawnSync("git", ["ls-remote", "--tags", "--refs", "--sort=-v:refname", DEFAULT_REPO], {
+      encoding: "utf8",
+      timeout: 1e4
+    });
+    if (res.status !== 0) return null;
+    const first = (res.stdout || "").split("\n")[0] || "";
+    const m = first.match(/refs\/tags\/(v[0-9][^\s]*)$/);
+    return m ? m[1] : null;
+  } catch {
+    return null;
+  }
+}
+function resolveBranchOrTag({ branch, branchExplicit, _tagLookup } = {}) {
+  if (branchExplicit) return branch;
+  const lookup = _tagLookup || latestTagFromGithub;
+  let tag = null;
+  try {
+    tag = lookup();
+  } catch {
+    tag = null;
+  }
+  return tag || branch || DEFAULT_BRANCH;
+}
+function printHelp() {
+  console.log(`ijfw-install -- IJFW installer
+Usage: npx @ijfw/install [--dir <path>] [--branch <name>] [--no-marketplace] [--yes]
+  --dir             install location (default: $IJFW_HOME or ~/.ijfw)
+  --branch          git branch or tag (default: latest released tag)
+  --no-marketplace  skip merging ~/.claude/settings.json
+  --yes             non-interactive
+`);
+}
+function preflight() {
+  const issues = [];
+  const [major] = process.versions.node.split(".").map(Number);
+  if (major < 18) issues.push(`IJFW needs Node >=18 -- current: ${process.versions.node}. Upgrade Node, then retry.`);
+  if (!hasBin("git")) issues.push("IJFW needs git on PATH -- install git (https://git-scm.com), then retry.");
+  if (!hasBin("bash")) {
+    if (platform() === "win32") {
+      issues.push("IJFW on Windows needs Git Bash. Install Git for Windows (https://git-scm.com/download/win), or run the PowerShell installer: irm https://raw.githubusercontent.com/TheRealSeanDonahoe/ijfw/main/installer/src/install.ps1 | iex");
+    } else {
+      issues.push("IJFW needs bash on PATH -- install bash, then retry.");
+    }
+  }
+  return issues;
+}
+function hasBin(bin) {
+  const res = spawnSync(bin, ["--version"], { stdio: "ignore" });
+  return res.status === 0 || res.status === null ? res.error ? false : true : false;
+}
+function resolveTarget(opt) {
+  if (opt.dir) return resolve(opt.dir);
+  if (process.env.IJFW_HOME) return resolve(process.env.IJFW_HOME);
+  return join2(homedir2(), ".ijfw");
+}
+function runCheck(cmd, args, opts) {
+  const r = spawnSync(cmd, args, { encoding: "utf8", ...opts });
+  return { status: r.status, stdout: r.stdout || "" };
+}
+function cloneOrPull(dir, branch) {
+  if (!existsSync2(dir)) {
+    mkdirSync2(dir, { recursive: true });
+    const r = spawnSync("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 = existsSync2(join2(dir, ".git"));
+  if (hasGit) {
+    const { status: remoteStatus } = runCheck("git", ["-C", dir, "remote", "get-url", "origin"]);
+    if (remoteStatus === 0) {
+      const fetch = spawnSync("git", ["-C", dir, "fetch", "--depth", "1", "origin", branch], { stdio: "inherit" });
+      if (fetch.status !== 0) throw new Error(`IJFW fetch did not complete (exit ${fetch.status}) -- check network access and retry.`);
+      const co = spawnSync("git", ["-C", dir, "checkout", "-f", "FETCH_HEAD"], { stdio: "inherit" });
+      if (co.status !== 0) throw new Error(`IJFW checkout did not complete (exit ${co.status}) -- run ijfw doctor to check prerequisites.`);
+      return "updated";
+    }
+  }
+  const backupDir = dir + ".bak." + Date.now();
+  renameSync2(dir, backupDir);
+  try {
+    const r = spawnSync("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.`);
+    for (const item of ["memory", "sessions", "install.log", ".session-counter"]) {
+      const src = join2(backupDir, item);
+      if (existsSync2(src)) {
+        const dst = join2(dir, item);
+        if (existsSync2(dst)) rmSync(dst, { recursive: true, force: true });
+        renameSync2(src, dst);
+      }
+    }
+    rmSync(backupDir, { recursive: true, force: true });
+    return "updated";
+  } catch (err) {
+    if (existsSync2(dir)) rmSync(dir, { recursive: true, force: true });
+    renameSync2(backupDir, dir);
+    throw err;
+  }
+}
+function runInstallScript(dir) {
+  const script = join2(dir, "scripts", "install.sh");
+  if (!existsSync2(script)) throw new Error(`IJFW install script not found at ${script} -- re-run the installer to restore it.`);
+  const env = { ...process.env, IJFW_NONINTERACTIVE: process.env.CI ? "1" : process.env.IJFW_NONINTERACTIVE ?? "" };
+  const r = spawnSync("bash", ["scripts/install.sh"], { cwd: dir, stdio: "inherit", env });
+  if (r.status !== 0) throw new Error(`IJFW platform config step did not complete (exit ${r.status}) -- run ijfw doctor to see what to fix.`);
+}
+async function main() {
+  const opts = parseArgs(process.argv);
+  const issues = preflight();
+  if (issues.length) {
+    console.error("IJFW needs a couple of things first -- fix these and re-run:");
+    for (const i of issues) console.error("  - " + i);
+    process.exit(1);
+  }
+  const target = resolveTarget(opts);
+  const createdThisRun = !existsSync2(target);
+  const sigint = () => {
+    if (createdThisRun && existsSync2(target)) {
+      try {
+        rmSync(target, { recursive: true, force: true });
+      } catch {
+      }
+    }
+    process.exit(130);
+  };
+  process.on("SIGINT", sigint);
+  const ref = resolveBranchOrTag({ branch: opts.branch, branchExplicit: opts.branchExplicit });
+  console.log(`IJFW install target: ${target}`);
+  console.log(`  version: ${ref}`);
+  const action = cloneOrPull(target, ref);
+  console.log(`  repo ${action}`);
+  runInstallScript(target);
+  console.log("  platform configs applied");
+  if (!opts.noMarketplace) {
+    const settingsPath = claudeSettingsPath();
+    mergeMarketplace(settingsPath);
+    console.log(`  marketplace registered in ${settingsPath}`);
+  }
+  console.log("");
+  console.log("IJFW now active across 7 platforms -- one memory layer, all your AIs, zero config.");
+  console.log("  Run `ijfw demo` to see the Trident in action.");
+  console.log("  Run `ijfw doctor` to confirm which auditors are reachable.");
+  console.log("  Privacy: everything stays local. See NO_TELEMETRY.md.");
+  process.exit(0);
+}
+function isDirectRun() {
+  try {
+    const entry = process.argv[1] && realpathSync(process.argv[1]);
+    const self = fileURLToPath(import.meta.url);
+    return entry === self;
+  } catch {
+    return false;
+  }
+}
+if (isDirectRun()) {
+  main().catch((e) => {
+    console.error(e.message || String(e));
+    process.exit(1);
+  });
+}
+export {
+  resolveBranchOrTag
+};

package/dist/uninstall.js

@@ -0,0 +1,259 @@
+#!/usr/bin/env node
+
+// src/uninstall.js
+import { existsSync as existsSync2, rmSync, cpSync, mkdtempSync, readFileSync as readFileSync2, writeFileSync as writeFileSync2, readdirSync } from "node:fs";
+import { resolve, join as join2 } from "node:path";
+import { homedir as homedir2, tmpdir } from "node:os";
+
+// src/marketplace.js
+import { readFileSync, writeFileSync, renameSync, existsSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+function claudeSettingsPath() {
+  return join(homedir(), ".claude", "settings.json");
+}
+function stripJsoncComments(raw) {
+  if (raw.charCodeAt(0) === 65279) raw = raw.slice(1);
+  let out = "";
+  let i = 0;
+  const n = raw.length;
+  const isLineBreak = (code) => code === 10 || code === 13 || code === 8232 || code === 8233;
+  while (i < n) {
+    const c = raw[i];
+    const c2 = raw[i + 1];
+    if (c === '"') {
+      out += c;
+      i++;
+      while (i < n) {
+        const k = raw[i];
+        out += k;
+        if (k === "\\" && i + 1 < n) {
+          out += raw[i + 1];
+          i += 2;
+          continue;
+        }
+        i++;
+        if (k === '"') break;
+      }
+      continue;
+    }
+    if (c === "/" && c2 === "/") {
+      i += 2;
+      while (i < n && !isLineBreak(raw.charCodeAt(i))) i++;
+      continue;
+    }
+    if (c === "/" && c2 === "*") {
+      i += 2;
+      while (i < n && !(raw[i] === "*" && raw[i + 1] === "/")) i++;
+      if (i < n) i += 2;
+      continue;
+    }
+    out += c;
+    i++;
+  }
+  return out;
+}
+function tolerantJsonParse(raw, filepath) {
+  try {
+    return JSON.parse(raw);
+  } catch {
+  }
+  const stripped = stripJsoncComments(raw).replace(/,(\s*[}\]])/g, "$1");
+  try {
+    return JSON.parse(stripped);
+  } catch (e) {
+    const err = new Error(`settings.json at ${filepath} is not valid JSON or recoverable JSONC: ${e.message}`);
+    err.code = "IJFW_SETTINGS_UNPARSEABLE";
+    throw err;
+  }
+}
+function unmergeMarketplace(settingsPath = claudeSettingsPath()) {
+  if (!existsSync(settingsPath)) return null;
+  const settings = tolerantJsonParse(readFileSync(settingsPath, "utf8"), settingsPath);
+  if (settings.extraKnownMarketplaces?.ijfw) delete settings.extraKnownMarketplaces.ijfw;
+  if (settings.enabledPlugins) {
+    if ("ijfw-core@ijfw" in settings.enabledPlugins) delete settings.enabledPlugins["ijfw-core@ijfw"];
+    if ("ijfw@ijfw" in settings.enabledPlugins) delete settings.enabledPlugins["ijfw@ijfw"];
+  }
+  const tmp = settingsPath + ".tmp";
+  writeFileSync(tmp, JSON.stringify(settings, null, 2) + "\n");
+  renameSync(tmp, settingsPath);
+  return settings;
+}
+
+// src/uninstall.js
+function parseArgs(argv) {
+  const out = { dir: null, purge: false, noMarketplace: false };
+  for (let i = 2; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--dir") out.dir = argv[++i];
+    else if (a === "--purge") out.purge = true;
+    else if (a === "--no-marketplace") out.noMarketplace = true;
+    else if (a === "--help" || a === "-h") {
+      printHelp();
+      process.exit(0);
+    }
+  }
+  return out;
+}
+function printHelp() {
+  console.log(`ijfw-uninstall -- reverse IJFW install
+Usage: ijfw-uninstall [--dir <path>] [--purge] [--no-marketplace]
+  --purge           also remove memory/ (destructive)
+  --no-marketplace  skip ~/.claude/settings.json edits
+`);
+}
+var HOME = homedir2();
+var TS = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").replace("T", "_").slice(0, 19);
+function backupFile(p) {
+  if (existsSync2(p)) {
+    const bak = p + ".bak." + TS;
+    cpSync(p, bak);
+    return bak;
+  }
+  return null;
+}
+function removeTomlSection(p) {
+  if (!existsSync2(p)) return false;
+  backupFile(p);
+  const lines = readFileSync2(p, "utf8").split("\n");
+  const out = [];
+  let skip = false;
+  for (const line of lines) {
+    if (/^\[mcp_servers\.ijfw-memory\]\s*$/.test(line)) {
+      skip = true;
+      continue;
+    }
+    if (skip && line.startsWith("[") && !line.startsWith("[mcp_servers.ijfw-memory]")) skip = false;
+    if (!skip) out.push(line);
+  }
+  writeFileSync2(p, out.join("\n"));
+  return true;
+}
+function removeJsonMcpEntry(p) {
+  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 changed = false;
+  if (doc.mcpServers && doc.mcpServers["ijfw-memory"]) {
+    backupFile(p);
+    delete doc.mcpServers["ijfw-memory"];
+    writeFileSync2(p, JSON.stringify(doc, null, 2) + "\n");
+    changed = true;
+  }
+  return changed;
+}
+function removeCodexHooks(p) {
+  if (!existsSync2(p)) return false;
+  let doc;
+  try {
+    doc = JSON.parse(readFileSync2(p, "utf8"));
+  } catch {
+    return false;
+  }
+  if (!Array.isArray(doc.hooks)) return false;
+  const before = doc.hooks.length;
+  doc.hooks = doc.hooks.filter((h) => !h._ijfw);
+  if (doc.hooks.length === before) return false;
+  backupFile(p);
+  writeFileSync2(p, JSON.stringify(doc, null, 2) + "\n");
+  return true;
+}
+function removeIjfwSkills(dir) {
+  if (!existsSync2(dir)) return 0;
+  let count = 0;
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    if (entry.isDirectory() && entry.name.startsWith("ijfw-")) {
+      rmSync(join2(dir, entry.name), { recursive: true, force: true });
+      count++;
+    }
+  }
+  return count;
+}
+function cleanPlatforms() {
+  const removed = [];
+  if (removeTomlSection(join2(HOME, ".codex", "config.toml"))) {
+    removed.push("~/.codex/config.toml  (removed [mcp_servers.ijfw-memory])");
+  }
+  if (removeCodexHooks(join2(HOME, ".codex", "hooks.json"))) {
+    removed.push("~/.codex/hooks.json  (removed IJFW hook entries)");
+  }
+  const codexSkills = removeIjfwSkills(join2(HOME, ".codex", "skills"));
+  if (codexSkills > 0) removed.push(`~/.codex/skills/ijfw-*  (removed ${codexSkills} skill dirs)`);
+  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"))) {
+    removed.push("~/.gemini/settings.json  (removed ijfw-memory)");
+  }
+  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");
+  if (removeJsonMcpEntry(cursorMcp)) removed.push(".cursor/mcp.json  (removed ijfw-memory)");
+  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");
+  if (removeJsonMcpEntry(vscodeMcp)) removed.push(".vscode/mcp.json  (removed ijfw-memory)");
+  return removed;
+}
+function resolveTarget(opt) {
+  if (opt.dir) return resolve(opt.dir);
+  if (process.env.IJFW_HOME) return resolve(process.env.IJFW_HOME);
+  return join2(homedir2(), ".ijfw");
+}
+async function main() {
+  const opts = parseArgs(process.argv);
+  const target = resolveTarget(opts);
+  console.log("This will remove IJFW configuration. Your memory at ~/.ijfw/memory/ will be preserved. Delete manually if desired.");
+  console.log("");
+  if (!existsSync2(target)) {
+    console.log(`IJFW directory absent (${target}); platform cleanup only.`);
+  } else if (opts.purge) {
+    rmSync(target, { recursive: true, force: true });
+    console.log(`  removed ${target} (purged).`);
+  } else {
+    const memDir = join2(target, "memory");
+    let stash = null;
+    if (existsSync2(memDir)) {
+      stash = mkdtempSync(join2(tmpdir(), "ijfw-memory-"));
+      cpSync(memDir, stash, { recursive: true });
+    }
+    rmSync(target, { recursive: true, force: true });
+    if (stash) {
+      cpSync(stash, memDir, { recursive: true });
+      rmSync(stash, { recursive: true, force: true });
+      console.log(`  memory/ preserved at ${memDir}`);
+    } else {
+      console.log("  memory/ was not present; nothing to preserve");
+    }
+  }
+  if (!opts.noMarketplace) {
+    const settingsPath = claudeSettingsPath();
+    if (existsSync2(settingsPath)) {
+      unmergeMarketplace(settingsPath);
+      console.log(`  marketplace removed from ${settingsPath}`);
+    }
+  }
+  const cleaned = cleanPlatforms();
+  if (cleaned.length > 0) {
+    console.log("  platform configs cleaned:");
+    for (const line of cleaned) console.log(`    ${line}`);
+  }
+  console.log("\nIJFW uninstalled. Thanks for trying it.");
+  process.exit(0);
+}
+main().catch((e) => {
+  console.error(e.message || String(e));
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@ijfw/install",
+  "version": "1.1.0",
+  "description": "One-command installer for IJFW -- the AI efficiency layer. One install, every AI coding agent, zero config.",
+  "type": "module",
+  "bin": {
+    "ijfw": "dist/ijfw.js",
+    "ijfw-install": "dist/install.js",
+    "ijfw-uninstall": "dist/uninstall.js"
+  },
+  "files": [
+    "dist",
+    "src/install.ps1",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "esbuild src/install.js src/uninstall.js src/ijfw.js --bundle --platform=node --target=node18 --outdir=dist --format=esm --banner:js='#!/usr/bin/env node' && chmod +x dist/install.js dist/uninstall.js dist/ijfw.js",
+    "test": "node --test test.js",
+    "preflight": "node dist/ijfw.js preflight",
+    "pack:check": "npm pack --dry-run",
+    "prepublishOnly": "npm run build && npm run preflight"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "esbuild": "^0.25.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "ijfw",
+    "claude-code",
+    "codex",
+    "gemini-cli",
+    "cursor",
+    "windsurf",
+    "copilot",
+    "mcp",
+    "ai-agents",
+    "memory",
+    "installer"
+  ],
+  "license": "MIT",
+  "author": "Sean Donahoe",
+  "homepage": "https://github.com/TheRealSeanDonahoe/ijfw",
+  "bugs": {
+    "url": "https://github.com/TheRealSeanDonahoe/ijfw/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TheRealSeanDonahoe/ijfw.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}