@ironbee-ai/cli 0.11.3 → 0.12.0

package/dist/lib/install-snapshots.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * IronBee — Install Snapshots (raw CRUD)
+ *
+ * Backs up the slice of host state that `ironbee install` overwrites, so
+ * `uninstall` can restore the user's pre-install setup exactly. Today the
+ * only consumer is the statusline integration: when the user already has a
+ * `statusLine` in the layer IronBee writes its wrapper to
+ * (`.claude/settings.local.json`), installing destroys that single command
+ * slot — so we snapshot the original block here first, chain to it at
+ * runtime, and write it back on uninstall.
+ *
+ * Storage: `~/.ironbee/install-snapshots.json` — a per-developer global file
+ * (NOT under the project's gitignored `.ironbee/`, which `git clean` could
+ * wipe; NOT in `projects.json`, which stays pure inventory; NOT in
+ * `config.json`, which is user-editable config — this is install-derived
+ * state). Atomic write (temp + rename) to survive concurrent installs.
+ *
+ *   {
+ *     "version": 1,
+ *     "projects": {
+ *       "/abs/canonical/project": {
+ *         "claude": {
+ *           "statusLine": { "type": "command", "command": "~/.claude/orig.sh", "padding": 2 }
+ *         }
+ *       }
+ *     }
+ *   }
+ *
+ * Errors are non-fatal: a corrupt file returns empty and is overwritten on
+ * the next successful upsert. Snapshot maintenance MUST NEVER break
+ * `install` / `uninstall`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.snapshotsPath = snapshotsPath;
+exports.loadInstallSnapshots = loadInstallSnapshots;
+exports.readStatusLineSnapshot = readStatusLineSnapshot;
+exports.upsertStatusLineSnapshot = upsertStatusLineSnapshot;
+exports.clearStatusLineSnapshot = clearStatusLineSnapshot;
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const projects_registry_1 = require("./projects-registry");
+const logger_1 = require("./logger");
+const SNAPSHOTS_VERSION = 1;
+function snapshotsDir() {
+    return (0, path_1.join)((0, os_1.homedir)(), ".ironbee");
+}
+function snapshotsPath() {
+    return (0, path_1.join)(snapshotsDir(), "install-snapshots.json");
+}
+function emptySnapshots() {
+    return { version: SNAPSHOTS_VERSION, projects: {} };
+}
+/**
+ * Read the snapshots file. Returns empty when missing, unreadable,
+ * malformed, or carrying an unexpected schema version. Never throws.
+ */
+function loadInstallSnapshots() {
+    const path = snapshotsPath();
+    if (!(0, fs_1.existsSync)(path)) {
+        return emptySnapshots();
+    }
+    try {
+        const raw = (0, fs_1.readFileSync)(path, "utf-8");
+        if (raw.trim().length === 0) {
+            return emptySnapshots();
+        }
+        const parsed = JSON.parse(raw);
+        if (parsed === null || typeof parsed !== "object") {
+            logger_1.logger.debug(`install-snapshots: ${path} is not a JSON object — ignoring`);
+            return emptySnapshots();
+        }
+        const obj = parsed;
+        if (obj.version !== SNAPSHOTS_VERSION) {
+            logger_1.logger.debug(`install-snapshots: unexpected schema version ${String(obj.version)} — ignoring`);
+            return emptySnapshots();
+        }
+        if (obj.projects === null || typeof obj.projects !== "object" || Array.isArray(obj.projects)) {
+            return emptySnapshots();
+        }
+        return { version: SNAPSHOTS_VERSION, projects: obj.projects };
+    }
+    catch (e) {
+        logger_1.logger.debug(`install-snapshots: failed to read ${path}: ${e instanceof Error ? e.message : e}`);
+        return emptySnapshots();
+    }
+}
+/**
+ * Atomic write: serialize → temp → rename. The rename is atomic on POSIX so
+ * a crash mid-write can't leave a half-written file. Same lost-update caveat
+ * as `projects-registry` (no cross-process lock) — acceptable for the
+ * one-shot CLI install path.
+ */
+function writeSnapshots(file) {
+    const dir = snapshotsDir();
+    (0, fs_1.mkdirSync)(dir, { recursive: true });
+    const path = snapshotsPath();
+    const tmpPath = `${path}.tmp.${process.pid}.${Date.now()}`;
+    const body = JSON.stringify(file, null, 2) + "\n";
+    try {
+        (0, fs_1.writeFileSync)(tmpPath, body);
+        (0, fs_1.renameSync)(tmpPath, path);
+    }
+    catch (e) {
+        try {
+            if ((0, fs_1.existsSync)(tmpPath)) {
+                (0, fs_1.unlinkSync)(tmpPath);
+            }
+        }
+        catch {
+            // best-effort cleanup
+        }
+        throw e;
+    }
+}
+/** Read the statusLine snapshot for a project + client, if any. */
+function readStatusLineSnapshot(projectDir, client) {
+    const canonical = (0, projects_registry_1.canonicalizePath)(projectDir);
+    const file = loadInstallSnapshots();
+    return file.projects[canonical]?.[client]?.statusLine;
+}
+/**
+ * Store the user's original statusLine block for a project + client. Only the
+ * FIRST install should call this (the snapshot is the pre-install state) —
+ * callers must guard against overwriting an existing snapshot on re-install.
+ * Failures are swallowed + logged: snapshot maintenance must not break install.
+ */
+function upsertStatusLineSnapshot(projectDir, client, block) {
+    try {
+        const canonical = (0, projects_registry_1.canonicalizePath)(projectDir);
+        const file = loadInstallSnapshots();
+        const existing = file.projects[canonical] ?? {};
+        existing[client] = { ...existing[client], statusLine: block };
+        file.projects[canonical] = existing;
+        writeSnapshots(file);
+    }
+    catch (e) {
+        logger_1.logger.debug(`install-snapshots: upsert failed for ${projectDir}/${client}: ${e instanceof Error ? e.message : e}`);
+    }
+}
+/**
+ * Remove the statusLine snapshot for a project + client. Drops the client
+ * entry when it has no other snapshots, and the project entry when it has no
+ * clients left. Idempotent — soft no-op when nothing matches.
+ */
+function clearStatusLineSnapshot(projectDir, client) {
+    try {
+        const canonical = (0, projects_registry_1.canonicalizePath)(projectDir);
+        const file = loadInstallSnapshots();
+        const clients = file.projects[canonical];
+        if (!clients || !clients[client]) {
+            return;
+        }
+        delete clients[client].statusLine;
+        if (Object.keys(clients[client]).length === 0) {
+            delete clients[client];
+        }
+        if (Object.keys(clients).length === 0) {
+            delete file.projects[canonical];
+        }
+        writeSnapshots(file);
+    }
+    catch (e) {
+        logger_1.logger.debug(`install-snapshots: clear failed for ${projectDir}/${client}: ${e instanceof Error ? e.message : e}`);
+    }
+}
+//# sourceMappingURL=install-snapshots.js.map

package/dist/lib/install-snapshots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-snapshots.js","sourceRoot":"","sources":["../../src/lib/install-snapshots.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ironbee-ai/cli",
-  "version": "0.11.3",
+  "version": "0.12.0",
   "description": "The CLI for IronBee — Verification and Intelligence Layer for Agentic Development",
   "main": "dist/index.js",
   "bin": {