@entelligentsia/forgecli 1.0.21 → 1.0.36

package/dist/extensions/forgecli/claude-bootstrap/settings-merge.d.ts

@@ -0,0 +1,46 @@
+export interface MergeResult {
+    outcome: "created" | "merged" | "already-present" | "error";
+    warning?: string;
+}
+interface HookEntry {
+    type: "command";
+    command: string;
+    timeout: number;
+}
+interface SessionStartGroup {
+    hooks: HookEntry[];
+}
+interface MatcherGroup {
+    matcher: string;
+    hooks: HookEntry[];
+}
+export interface ForgeSettingsHooks {
+    SessionStart: SessionStartGroup[];
+    PreToolUse: MatcherGroup[];
+    PostToolUse: MatcherGroup[];
+    PermissionRequest: MatcherGroup[];
+}
+/**
+ * Returns the canonical Forge hooks block for project .claude/settings.json.
+ *
+ * All commands point at $CLAUDE_PROJECT_DIR/.forge/tools/hooks/<name>.cjs
+ * (CLAUDE_PROJECT_DIR is a Claude Code runtime env var; not resolved at build time).
+ *
+ * Hook list mirrors forge/forge/hooks/hooks.json, with commands re-targeted
+ * from ${CLAUDE_PLUGIN_ROOT}/hooks/ to $CLAUDE_PROJECT_DIR/.forge/tools/hooks/.
+ */
+export declare function buildForgeHooksBlock(): ForgeSettingsHooks;
+/**
+ * Merge Forge hooks into the project .claude/settings.json with merge-not-clobber semantics.
+ *
+ * Rules:
+ * 1. File absent → create with { "hooks": <forgeHooksBlock> }.
+ * 2. File present, valid JSON, no hooks key → add hooks key, preserve all other keys.
+ * 3. File present, valid JSON, hooks key with all Forge entries already present → "already-present" (no-op).
+ * 4. File present, valid JSON, hooks key with unrelated or missing Forge entries →
+ *    merge Forge entries, preserve all existing non-Forge entries.
+ * 5. File present, malformed JSON → "error", file never overwritten.
+ * 6. Write failure → "error" with descriptive warning.
+ */
+export declare function mergeForgeHooks(settingsPath: string): MergeResult;
+export {};

package/dist/extensions/forgecli/claude-bootstrap/settings-merge.js

@@ -0,0 +1,245 @@
+// claude-bootstrap/settings-merge.ts — Forge hooks merge into .claude/settings.json (FORGE-S31-T03)
+//
+// Provides merge-not-clobber semantics for writing Forge's hook configuration into
+// a project's .claude/settings.json. Existing keys (including hooks from other tools)
+// are preserved byte-identical. Forge entries are only added where missing.
+//
+// Key contracts:
+//   - Never overwrites a file that does not parse as JSON
+//   - Running twice is idempotent: second run detects existing Forge entries and returns "already-present"
+//   - Pure fs operations: no shell-outs, no LLM, no network
+import * as fs from "node:fs";
+// ── Constants ─────────────────────────────────────────────────────────────────
+/** Sentinel string used to identify Forge hook commands for dedup detection. */
+const FORGE_HOOK_SENTINEL = ".forge/tools/hooks/";
+// ── buildForgeHooksBlock ──────────────────────────────────────────────────────
+/**
+ * Returns the canonical Forge hooks block for project .claude/settings.json.
+ *
+ * All commands point at $CLAUDE_PROJECT_DIR/.forge/tools/hooks/<name>.cjs
+ * (CLAUDE_PROJECT_DIR is a Claude Code runtime env var; not resolved at build time).
+ *
+ * Hook list mirrors forge/forge/hooks/hooks.json, with commands re-targeted
+ * from ${CLAUDE_PLUGIN_ROOT}/hooks/ to $CLAUDE_PROJECT_DIR/.forge/tools/hooks/.
+ */
+export function buildForgeHooksBlock() {
+    return {
+        SessionStart: [
+            {
+                hooks: [
+                    {
+                        type: "command",
+                        command: 'node "$CLAUDE_PROJECT_DIR/.forge/tools/hooks/check-update.cjs"',
+                        timeout: 10000,
+                    },
+                    {
+                        type: "command",
+                        command: 'node "$CLAUDE_PROJECT_DIR/.forge/tools/hooks/preflight-session.cjs"',
+                        timeout: 10000,
+                    },
+                ],
+            },
+        ],
+        PreToolUse: [
+            {
+                matcher: "Write|Edit|MultiEdit",
+                hooks: [
+                    {
+                        type: "command",
+                        command: 'node "$CLAUDE_PROJECT_DIR/.forge/tools/hooks/validate-write.cjs"',
+                        timeout: 5000,
+                    },
+                ],
+            },
+        ],
+        PostToolUse: [
+            {
+                matcher: "Bash",
+                hooks: [
+                    {
+                        type: "command",
+                        command: 'node "$CLAUDE_PROJECT_DIR/.forge/tools/hooks/triage-error.cjs"',
+                        timeout: 5000,
+                    },
+                    {
+                        // query-logger is a tool, not a hook script — the plugin's hooks.json
+                        // points it at tools/query-logger.cjs, vendored to .forge/tools/ by Step 3.
+                        type: "command",
+                        command: 'node "$CLAUDE_PROJECT_DIR/.forge/tools/query-logger.cjs"',
+                        timeout: 3000,
+                    },
+                    {
+                        type: "command",
+                        command: 'node "$CLAUDE_PROJECT_DIR/.forge/tools/hooks/post-init.cjs"',
+                        timeout: 10000,
+                    },
+                    {
+                        type: "command",
+                        command: 'node "$CLAUDE_PROJECT_DIR/.forge/tools/hooks/post-sprint.cjs"',
+                        timeout: 10000,
+                    },
+                ],
+            },
+        ],
+        PermissionRequest: [
+            {
+                matcher: "Bash|Write|Edit|MultiEdit|WebFetch",
+                hooks: [
+                    {
+                        type: "command",
+                        command: 'node "$CLAUDE_PROJECT_DIR/.forge/tools/hooks/forge-permissions.cjs"',
+                        timeout: 3000,
+                    },
+                ],
+            },
+        ],
+    };
+}
+// ── Private helpers ───────────────────────────────────────────────────────────
+/**
+ * Checks whether a hooks block already contains Forge entries by looking for
+ * the Forge hook sentinel string in any hook command.
+ */
+function hasForgeEntries(hooks) {
+    for (const eventGroups of Object.values(hooks)) {
+        if (!Array.isArray(eventGroups))
+            continue;
+        for (const group of eventGroups) {
+            const g = group;
+            if (!Array.isArray(g.hooks))
+                continue;
+            for (const hook of g.hooks) {
+                if (typeof hook.command === "string" && hook.command.includes(FORGE_HOOK_SENTINEL)) {
+                    return true;
+                }
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Merge Forge hooks into an existing hooks object.
+ * For each event type, Forge entries are appended only where no Forge entry already exists
+ * (detected by FORGE_HOOK_SENTINEL in command string).
+ */
+function mergeHooksIntoExisting(existing, forgeBlock) {
+    const merged = { ...existing };
+    const eventTypes = ["SessionStart", "PreToolUse", "PostToolUse", "PermissionRequest"];
+    for (const eventType of eventTypes) {
+        const forgeGroups = forgeBlock[eventType];
+        if (!forgeGroups || !Array.isArray(forgeGroups))
+            continue;
+        const existingGroups = Array.isArray(merged[eventType]) ? [...merged[eventType]] : [];
+        // Check if any existing group already has Forge entries for this event type
+        const alreadyHasForge = existingGroups.some((group) => {
+            const g = group;
+            return (Array.isArray(g.hooks) &&
+                g.hooks.some((h) => typeof h.command === "string" && h.command.includes(FORGE_HOOK_SENTINEL)));
+        });
+        if (!alreadyHasForge) {
+            // Append Forge groups for this event type
+            existingGroups.push(...forgeGroups);
+        }
+        merged[eventType] = existingGroups;
+    }
+    return merged;
+}
+// ── mergeForgeHooks ───────────────────────────────────────────────────────────
+/**
+ * Merge Forge hooks into the project .claude/settings.json with merge-not-clobber semantics.
+ *
+ * Rules:
+ * 1. File absent → create with { "hooks": <forgeHooksBlock> }.
+ * 2. File present, valid JSON, no hooks key → add hooks key, preserve all other keys.
+ * 3. File present, valid JSON, hooks key with all Forge entries already present → "already-present" (no-op).
+ * 4. File present, valid JSON, hooks key with unrelated or missing Forge entries →
+ *    merge Forge entries, preserve all existing non-Forge entries.
+ * 5. File present, malformed JSON → "error", file never overwritten.
+ * 6. Write failure → "error" with descriptive warning.
+ */
+export function mergeForgeHooks(settingsPath) {
+    const forgeBlock = buildForgeHooksBlock();
+    // ── Branch 1: File absent ─────────────────────────────────────────────────
+    if (!fs.existsSync(settingsPath)) {
+        try {
+            const content = JSON.stringify({ hooks: forgeBlock }, null, 2) + "\n";
+            fs.writeFileSync(settingsPath, content, "utf8");
+            return { outcome: "created" };
+        }
+        catch (err) {
+            const e = err;
+            return {
+                outcome: "error",
+                warning: `Could not write ${settingsPath}: ${e.message ?? String(err)}`,
+            };
+        }
+    }
+    // ── File present: read and parse ──────────────────────────────────────────
+    let rawContent;
+    try {
+        rawContent = fs.readFileSync(settingsPath, "utf8");
+    }
+    catch (err) {
+        const e = err;
+        return {
+            outcome: "error",
+            warning: `Could not read ${settingsPath}: ${e.message ?? String(err)}`,
+        };
+    }
+    // ── Branch 2 / 7: Empty or malformed JSON ────────────────────────────────
+    if (rawContent.trim() === "") {
+        return {
+            outcome: "error",
+            warning: `${settingsPath} is empty — cannot parse as JSON. Fix or delete the file and re-run.`,
+        };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(rawContent);
+    }
+    catch (err) {
+        const e = err;
+        return {
+            outcome: "error",
+            warning: `${settingsPath} contains malformed JSON — will not overwrite. Parse error: ${e.message ?? String(err)}`,
+        };
+    }
+    // ── Branch 3: Empty object {} (no hooks key) ──────────────────────────────
+    // ── Branch 4: Has other keys but no hooks key ─────────────────────────────
+    if (!("hooks" in parsed)) {
+        try {
+            const updated = { ...parsed, hooks: forgeBlock };
+            const content = JSON.stringify(updated, null, 2) + "\n";
+            fs.writeFileSync(settingsPath, content, "utf8");
+            return { outcome: "merged" };
+        }
+        catch (err) {
+            const e = err;
+            return {
+                outcome: "error",
+                warning: `Could not write ${settingsPath}: ${e.message ?? String(err)}`,
+            };
+        }
+    }
+    // ── Branch 6: Already has Forge entries ───────────────────────────────────
+    const existingHooks = parsed.hooks;
+    if (hasForgeEntries(existingHooks)) {
+        return { outcome: "already-present" };
+    }
+    // ── Branch 5: Has hooks key with unrelated entries — merge Forge in ───────
+    try {
+        const mergedHooks = mergeHooksIntoExisting(existingHooks, forgeBlock);
+        const updated = { ...parsed, hooks: mergedHooks };
+        const content = JSON.stringify(updated, null, 2) + "\n";
+        fs.writeFileSync(settingsPath, content, "utf8");
+        return { outcome: "merged" };
+    }
+    catch (err) {
+        const e = err;
+        return {
+            outcome: "error",
+            warning: `Could not write ${settingsPath}: ${e.message ?? String(err)}`,
+        };
+    }
+}
+//# sourceMappingURL=settings-merge.js.map

package/dist/extensions/forgecli/claude-bootstrap/settings-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-merge.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/claude-bootstrap/settings-merge.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,EAAE;AACF,mFAAmF;AACnF,sFAAsF;AACtF,4EAA4E;AAC5E,EAAE;AACF,iBAAiB;AACjB,0DAA0D;AAC1D,2GAA2G;AAC3G,4DAA4D;AAE5D,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAiC9B,iFAAiF;AAEjF,gFAAgF;AAChF,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAElD,iFAAiF;AAEjF;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB;IACnC,OAAO;QACN,YAAY,EAAE;YACb;gBACC,KAAK,EAAE;oBACN;wBACC,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,gEAAgE;wBACzE,OAAO,EAAE,KAAK;qBACd;oBACD;wBACC,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,qEAAqE;wBAC9E,OAAO,EAAE,KAAK;qBACd;iBACD;aACD;SACD;QACD,UAAU,EAAE;YACX;gBACC,OAAO,EAAE,sBAAsB;gBAC/B,KAAK,EAAE;oBACN;wBACC,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,kEAAkE;wBAC3E,OAAO,EAAE,IAAI;qBACb;iBACD;aACD;SACD;QACD,WAAW,EAAE;YACZ;gBACC,OAAO,EAAE,MAAM;gBACf,KAAK,EAAE;oBACN;wBACC,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,gEAAgE;wBACzE,OAAO,EAAE,IAAI;qBACb;oBACD;wBACC,sEAAsE;wBACtE,4EAA4E;wBAC5E,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,0DAA0D;wBACnE,OAAO,EAAE,IAAI;qBACb;oBACD;wBACC,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,6DAA6D;wBACtE,OAAO,EAAE,KAAK;qBACd;oBACD;wBACC,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,+DAA+D;wBACxE,OAAO,EAAE,KAAK;qBACd;iBACD;aACD;SACD;QACD,iBAAiB,EAAE;YAClB;gBACC,OAAO,EAAE,oCAAoC;gBAC7C,KAAK,EAAE;oBACN;wBACC,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,qEAAqE;wBAC9E,OAAO,EAAE,IAAI;qBACb;iBACD;aACD;SACD;KACD,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,SAAS,eAAe,CAAC,KAA8B;IACtD,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;YAAE,SAAS;QAC1C,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,KAAgD,CAAC;YAC3D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;gBAAE,SAAS;YACtC,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;gBAC5B,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;oBACpF,OAAO,IAAI,CAAC;gBACb,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAID;;;;GAIG;AACH,SAAS,sBAAsB,CAC9B,QAAiC,EACjC,UAA8B;IAE9B,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;IAE/B,MAAM,UAAU,GAAgB,CAAC,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,CAAC,CAAC;IAEnG,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;YAAE,SAAS;QAE1D,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAI,MAAM,CAAC,SAAS,CAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAErG,4EAA4E;QAC5E,MAAM,eAAe,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YACrD,MAAM,CAAC,GAAG,KAAgD,CAAC;YAC3D,OAAO,CACN,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;gBACtB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAC7F,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,eAAe,EAAE,CAAC;YACtB,0CAA0C;YAC1C,cAAc,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,CAAC,SAAS,CAAC,GAAG,cAAc,CAAC;IACpC,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC;AAED,iFAAiF;AAEjF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,YAAoB;IACnD,MAAM,UAAU,GAAG,oBAAoB,EAAE,CAAC;IAE1C,6EAA6E;IAC7E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;YACtE,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YAChD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,GAA2B,CAAC;YACtC,OAAO;gBACN,OAAO,EAAE,OAAO;gBAChB,OAAO,EAAE,mBAAmB,YAAY,KAAK,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE;aACvE,CAAC;QACH,CAAC;IACF,CAAC;IAED,6EAA6E;IAC7E,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACJ,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,GAA2B,CAAC;QACtC,OAAO;YACN,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,kBAAkB,YAAY,KAAK,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE;SACtE,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC9B,OAAO;YACN,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,GAAG,YAAY,sEAAsE;SAC9F,CAAC;IACH,CAAC;IAED,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAA4B,CAAC;IAC5D,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,GAA2B,CAAC;QACtC,OAAO;YACN,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,GAAG,YAAY,+DAA+D,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE;SACjH,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,6EAA6E;IAC7E,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,EAAE,CAAC;QAC1B,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;YACjD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;YACxD,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YAChD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,GAA2B,CAAC;YACtC,OAAO;gBACN,OAAO,EAAE,OAAO;gBAChB,OAAO,EAAE,mBAAmB,YAAY,KAAK,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE;aACvE,CAAC;QACH,CAAC;IACF,CAAC;IAED,6EAA6E;IAC7E,MAAM,aAAa,GAAG,MAAM,CAAC,KAAgC,CAAC;IAC9D,IAAI,eAAe,CAAC,aAAa,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;IACvC,CAAC;IAED,6EAA6E;IAC7E,IAAI,CAAC;QACJ,MAAM,WAAW,GAAG,sBAAsB,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;QACxD,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAChD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,GAA2B,CAAC;QACtC,OAAO;YACN,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,mBAAmB,YAAY,KAAK,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE;SACvE,CAAC;IACH,CAAC;AACF,CAAC"}

package/dist/extensions/forgecli/claude-bootstrap/uninstall.d.ts

@@ -0,0 +1,23 @@
+export interface UninstallOptions {
+    /** Target project root (absolute path). */
+    dir: string;
+    /** Absolute path to the dist/forge-payload/ directory (to re-derive vendored names). */
+    payloadRoot: string;
+    /**
+     * When true, ALSO remove user data: .forge/config.json and .forge/store/**,
+     * then the now-empty .forge/ itself. The KB folder is never auto-removed.
+     */
+    purge: boolean;
+}
+export interface UninstallResult {
+    ok: boolean;
+    /** True if a .forge/.bootstrap-manifest.json was found (a forge-bootstrapped project). */
+    bootstrapped: boolean;
+    /** Paths removed this run (files and dirs). */
+    removed: string[];
+    /** User-data paths deliberately preserved (only meaningful when purge=false). */
+    kept: string[];
+    /** Non-fatal issues encountered. */
+    warnings: string[];
+}
+export declare function uninstallClaudeProject(opts: UninstallOptions): UninstallResult;

package/dist/extensions/forgecli/claude-bootstrap/uninstall.js

@@ -0,0 +1,215 @@
+// claude-bootstrap/uninstall.ts — deterministic reverse of bootstrapClaudeProject.
+//
+// `4ge uninstall claude [dir]` removes what `4ge init claude` scaffolded:
+// the vendored Forge scaffold (tools, hooks, schemas, commands, forge-root
+// content, agents/skills, workflow drivers, bootstrap manifest), un-merges the
+// Forge hooks from .claude/settings.json, and un-appends the Forge block from
+// .gitignore. Pure fs; zero LLM tokens, zero network.
+//
+// Safety contract:
+//   - PRESERVES user data by default: .forge/config.json, .forge/store/** (the
+//     SDLC store — sprints/tasks/bugs/events), and the KB folder are NEVER
+//     touched unless `purge` is set.
+//   - REFUSES to act when no .forge/.bootstrap-manifest.json is present — that
+//     manifest is the proof a project was forge-bootstrapped. Without it we will
+//     not delete anything (avoids nuking a hand-built .claude/ or .forge/).
+//   - settings.json and .gitignore are EDITED (un-merge / un-append), never
+//     blindly deleted — they may carry non-Forge content.
+//   - Idempotent: a second run finds nothing to remove and reports cleanly.
+import * as fs from "node:fs";
+import * as path from "node:path";
+// ── Constants ─────────────────────────────────────────────────────────────────
+/** Sentinel identifying Forge hook commands in settings.json (mirrors settings-merge). */
+const FORGE_HOOK_SENTINEL = ".forge/tools/";
+/** Exact block appended to .gitignore by bootstrap (mirrors bootstrap.ts). */
+const GITIGNORE_APPEND_BLOCK = "\n# Forge — transient agent event logs (one file per phase, do not commit)\n.forge/store/events/\n";
+// ── Private helpers ───────────────────────────────────────────────────────────
+/** Remove a file or directory if it exists; record the path. Never throws. */
+function rmIfExists(target, removed, warnings) {
+    if (!fs.existsSync(target))
+        return;
+    try {
+        fs.rmSync(target, { recursive: true, force: true });
+        removed.push(target);
+    }
+    catch (err) {
+        const e = err;
+        warnings.push(`could not remove ${target}: ${e.message ?? String(err)}`);
+    }
+}
+/** Remove a directory only if it exists and is empty. Records if removed. */
+function rmDirIfEmpty(dirPath, removed) {
+    if (!fs.existsSync(dirPath))
+        return;
+    try {
+        if (fs.readdirSync(dirPath).length === 0) {
+            fs.rmdirSync(dirPath);
+            removed.push(dirPath);
+        }
+    }
+    catch {
+        // non-fatal — leave it
+    }
+}
+/** List immediate entry names in a payload subdir, or [] if absent. */
+function payloadEntryNames(payloadRoot, sub) {
+    const src = path.join(payloadRoot, sub);
+    if (!fs.existsSync(src))
+        return [];
+    try {
+        return fs.readdirSync(src);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Un-merge Forge hooks from .claude/settings.json.
+ * Removes hook entries whose command targets `.forge/tools/…`, drops groups and
+ * event-type keys that become empty, and deletes the file only if it is left
+ * with no keys at all (i.e. Forge created it). Never touches malformed JSON.
+ */
+function removeForgeHooks(settingsPath, removed, warnings) {
+    if (!fs.existsSync(settingsPath))
+        return;
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+    }
+    catch (err) {
+        const e = err;
+        warnings.push(`settings.json not valid JSON — left untouched: ${e.message ?? String(err)}`);
+        return;
+    }
+    const hooks = parsed.hooks;
+    if (!hooks || typeof hooks !== "object")
+        return;
+    let changed = false;
+    for (const [eventType, groupsRaw] of Object.entries(hooks)) {
+        if (!Array.isArray(groupsRaw))
+            continue;
+        const keptGroups = [];
+        for (const group of groupsRaw) {
+            const g = group;
+            if (Array.isArray(g.hooks)) {
+                const keptHooks = g.hooks.filter((h) => !(typeof h.command === "string" && h.command.includes(FORGE_HOOK_SENTINEL)));
+                if (keptHooks.length !== g.hooks.length)
+                    changed = true;
+                if (keptHooks.length === 0)
+                    continue; // drop emptied group
+                keptGroups.push({ ...g, hooks: keptHooks });
+            }
+            else {
+                keptGroups.push(group);
+            }
+        }
+        if (keptGroups.length === 0) {
+            delete hooks[eventType];
+            changed = true;
+        }
+        else {
+            hooks[eventType] = keptGroups;
+        }
+    }
+    if (!changed)
+        return;
+    // Drop an emptied hooks key, then delete the file if nothing else remains.
+    if (Object.keys(hooks).length === 0)
+        delete parsed.hooks;
+    if (Object.keys(parsed).length === 0) {
+        rmIfExists(settingsPath, removed, warnings);
+        return;
+    }
+    try {
+        fs.writeFileSync(settingsPath, JSON.stringify(parsed, null, 2) + "\n", "utf8");
+        removed.push(`${settingsPath} (Forge hooks un-merged)`);
+    }
+    catch (err) {
+        const e = err;
+        warnings.push(`could not rewrite ${settingsPath}: ${e.message ?? String(err)}`);
+    }
+}
+/** Remove the exact Forge block appended to .gitignore by bootstrap. */
+function removeGitignoreBlock(gitignorePath, removed, warnings) {
+    if (!fs.existsSync(gitignorePath))
+        return;
+    let content;
+    try {
+        content = fs.readFileSync(gitignorePath, "utf8");
+    }
+    catch {
+        return;
+    }
+    if (!content.includes(GITIGNORE_APPEND_BLOCK))
+        return;
+    try {
+        fs.writeFileSync(gitignorePath, content.replace(GITIGNORE_APPEND_BLOCK, ""), "utf8");
+        removed.push(`${gitignorePath} (Forge block un-appended)`);
+    }
+    catch (err) {
+        const e = err;
+        warnings.push(`could not rewrite ${gitignorePath}: ${e.message ?? String(err)}`);
+    }
+}
+// ── Main export ───────────────────────────────────────────────────────────────
+export function uninstallClaudeProject(opts) {
+    const { dir, payloadRoot, purge } = opts;
+    const removed = [];
+    const kept = [];
+    const warnings = [];
+    // ── Step 0: Require the bootstrap manifest (proof of a forge bootstrap) ───
+    const manifestPath = path.join(dir, ".forge", ".bootstrap-manifest.json");
+    if (!fs.existsSync(manifestPath)) {
+        warnings.push(`Not a forge-bootstrapped project: ${path.join(".forge", ".bootstrap-manifest.json")} not found in ${dir}. ` +
+            "Refusing to remove anything (run `4ge init claude` first, or remove files by hand).");
+        return { ok: false, bootstrapped: false, removed, kept, warnings };
+    }
+    const forgeDir = path.join(dir, ".forge");
+    const claudeDir = path.join(dir, ".claude");
+    // ── Step 1: Remove Forge-owned .forge/ scaffold (preserve config + store) ──
+    for (const sub of ["tools", "schemas", "init", ".base-pack", "meta", ".claude-plugin", "cache"]) {
+        rmIfExists(path.join(forgeDir, sub), removed, warnings);
+    }
+    rmIfExists(manifestPath, removed, warnings);
+    // ── Step 2: Remove Forge command surface ──────────────────────────────────
+    rmIfExists(path.join(claudeDir, "commands", "forge"), removed, warnings);
+    rmDirIfEmpty(path.join(claudeDir, "commands"), removed);
+    // ── Step 3: Remove workflow drivers (.claude/workflows is forge-exclusive) ─
+    rmIfExists(path.join(claudeDir, "workflows"), removed, warnings);
+    // ── Step 4: Remove vendored agents/skills — only the ones bootstrap added ──
+    // Re-derive the exact entry names from the payload so user-authored agents
+    // or skills sharing the directory are preserved.
+    for (const asset of ["agents", "skills"]) {
+        const assetDir = path.join(claudeDir, asset);
+        if (!fs.existsSync(assetDir))
+            continue;
+        for (const name of payloadEntryNames(payloadRoot, asset)) {
+            rmIfExists(path.join(assetDir, name), removed, warnings);
+        }
+        rmDirIfEmpty(assetDir, removed);
+    }
+    // ── Step 5: Un-merge settings hooks + un-append .gitignore (edit, not delete)
+    removeForgeHooks(path.join(claudeDir, "settings.json"), removed, warnings);
+    removeGitignoreBlock(path.join(dir, ".gitignore"), removed, warnings);
+    // ── Step 6: User data — preserve by default, remove only on --purge ───────
+    const configPath = path.join(forgeDir, "config.json");
+    const storePath = path.join(forgeDir, "store");
+    if (purge) {
+        rmIfExists(storePath, removed, warnings);
+        rmIfExists(configPath, removed, warnings);
+        // The KB folder (paths.engineering) is intentionally NOT auto-removed even
+        // under --purge: it is the user's generated documentation, not scaffold.
+        warnings.push("--purge removed .forge/store and .forge/config.json. The KB folder was left intact (remove it by hand if intended).");
+    }
+    else {
+        if (fs.existsSync(configPath))
+            kept.push(configPath);
+        if (fs.existsSync(storePath))
+            kept.push(storePath);
+    }
+    // ── Step 7: Tidy empty parents ────────────────────────────────────────────
+    rmDirIfEmpty(forgeDir, removed);
+    rmDirIfEmpty(claudeDir, removed);
+    return { ok: true, bootstrapped: true, removed, kept, warnings };
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/extensions/forgecli/claude-bootstrap/uninstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/claude-bootstrap/uninstall.ts"],"names":[],"mappings":"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"}

package/dist/extensions/forgecli/dashboard/component.js

@@ -31,7 +31,7 @@
 import { matchesKey, Key, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { getSessionRegistry } from "../session-registry.js";
 import { buildViewModel } from "./view-model.js";
-import { fmtTokenMeter, toDisplayLines } from "../viewport/renderer.js";
+import { fmtTokenFooter, toDisplayLines } from "../viewport/renderer.js";
 import { paintTailLine } from "../viewport/theme.js";
 import { cursor, nodeGlyph, statusLabel, dim, accentBold, warn, bold, border, collapseIndicator, promptExpandIcon, truncateLines, } from "./theme.js";
 // ── Word-wrap helper ───────────────────────────────────────────────────────────
@@ -662,17 +662,16 @@ export class DashboardComponent {
         const aggUsage = this.controller.getAggregateUsage();
         const aggCompression = this.controller.getAggregateCompression();
         const activeModel = this.controller.getActiveModel();
-        const meter = fmtTokenMeter(aggUsage);
-        const compSuffix = aggCompression.tokensSaved > 0 ? ` ⇌${aggCompression.tokensSaved}t` : "";
+        const meter = fmtTokenFooter(aggUsage, aggCompression.tokensSaved > 0 ? aggCompression : undefined);
         const modelLabel = activeModel?.provider && activeModel?.model
             ? `${activeModel.provider} ${activeModel.model}`
             : (activeModel?.provider ?? activeModel?.model ?? "");
         let footerLine = "";
         if (modelLabel && meter) {
-            footerLine = `${hintsBase}   ${dim(modelLabel, this.theme)}  Σ ${meter}${compSuffix}`;
+            footerLine = `${hintsBase}   ${dim(modelLabel, this.theme)}  Σ ${meter}`;
         }
         else if (meter) {
-            footerLine = `${hintsBase}   Σ ${meter}${compSuffix}`;
+            footerLine = `${hintsBase}   Σ ${meter}`;
         }
         else if (modelLabel) {
             footerLine = `${hintsBase}   ${dim(modelLabel, this.theme)}`;
@@ -800,7 +799,11 @@ export class DashboardComponent {
         // errors, newlines and all); ALL display normalization happens here:
         // toDisplayLines splits/sanitizes, wrapLine fits the pane width, and
         // long entries clamp to LOG_CLAMP_ROWS unless expanded (ctrl+o).
-        if (node.kind === "leaf" && node.tailBuffer.length > 0) {
+        // Rendered for ALL node kinds: leaf nodes carry subagent tool-call
+        // activity (via the viewport observer); orchestrator-kind root nodes
+        // carry the orchestrator's own decision log (gates, verdicts,
+        // escalations, halts) mirrored from its notify stream.
+        if (node.tailBuffer.length > 0) {
             const expanded = this.controller.getState().logExpanded;
             const total = node.tailBuffer.length;
             const modeHint = expanded ? "^o clamp" : "^o expand";
@@ -908,7 +911,7 @@ export class DashboardComponent {
     formatMetrics(node) {
         const parts = [];
         if (node.usage.input || node.usage.output || node.usage.cacheRead) {
-            parts.push(fmtTokenMeter(node.usage));
+            parts.push(fmtTokenFooter(node.usage));
         }
         if (node.metrics.toolCount) {
             parts.push(`${node.metrics.toolCount} tool${node.metrics.toolCount === 1 ? "" : "s"}`);