@entelligentsia/forgecli 1.0.14 → 1.0.21

package/dist/extensions/forgecli/context-governor.js

@@ -0,0 +1,592 @@
+// Context Governor — FORGE-S30-T03 (substrate) / FORGE-S30-T04 (Mechanism A curation)
+//                   / FORGE-S30-T05 (Mechanism B — context budget meter + checkpoint steer)
+//                   / FORGE-S30-T06 (Mechanism C — checkpoint-and-shed against {PHASE}-SUMMARY.json)
+//                   / FORGE-S30-T09 (Mechanism E — proactive compactFn trigger at budget threshold).
+// Defines the phase-policy table (keyed by persona/phase), the ContextGovernor
+// interface wired into hook-dispatcher.ts tool_result/tool_call paths, and the
+// governor factories used by T04 (live curation) and as no-op defaults.
+//
+// Mechanism A curation rules (T04):
+//   Rule 1 — Dedup/reference-ize: repeated (tool, target) call returns a pointer.
+//   Rule 2 — Schema-trim: forge_store results trimmed to phase-declared residentFields
+//             + summaries.* + identity keys. Preserved fields are byte-identical.
+//   Rule 3 — Span-clamp: bash/grep/find output over toolBudget chars is truncated
+//             with "[N lines elided]" marker.
+//
+// Mechanism B (T05):
+//   Budget meter: per-turn ctx.getContextUsage() → ctx.ui.setStatus("forge:ctx-budget", "ctx: Nk / Wk (P%)")
+//   Steer: one-shot note at policy.steerThreshold, injected via steerFn (optional, injected at
+//   governor construction by registerHookDispatcher). Single-fire invariant: steerFired flag
+//   is never reset after first fire.
+//
+// Design notes:
+//   - The policy table is a TypeScript literal loaded at module init — no disk I/O,
+//     no .forge/store/ reads or writes (Pack 07 compliance).
+//   - contextWindow resolution: Mechanism B uses usage.contextWindow from
+//     ctx.getContextUsage() directly; when usage is unavailable the meter is
+//     cleared and no steer/compact decision is made that turn.
+//     No provider names, model-family strings, or tier logic appear here.
+//   - Phase/summary vocabulary (summary keys, {PHASE}-SUMMARY.json filenames)
+//     is imported from phase-vocab.ts — the single mirror of the plugin's
+//     artifact-kinds.cjs catalog (FORGE-BUG-043).
+//   - Governor methods MUST NOT throw; failures fall through to undefined (IL7).
+//   - IL10: registerHookDispatcher's public signature and orchestrator event paths
+//     are untouched. The third arg is optional; all existing callers unaffected.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { loadGovernorProjectConfig } from "./governor-config.js";
+import { summaryFilenameFor, summaryKeyFor } from "./phase-vocab.js";
+// ---------------------------------------------------------------------------
+// No-op governor (default before T04/T05/T06)
+// ---------------------------------------------------------------------------
+/**
+ * Returns a ContextGovernor whose methods are pure pass-throughs.
+ * Used as the default in registerHookDispatcher so existing callers that do
+ * not pass a governor see zero behavioural change.
+ */
+export function createNoOpGovernor() {
+    return {
+        applyToolResult(_event, _ctx) {
+            return undefined;
+        },
+        applyToolCall(_event, _ctx) {
+            return undefined;
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Governor factory helpers (Mechanism A)
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the policy key from the extension context.
+ * Probes ctx for persona/phase fields (not formally in ExtensionContext; best-effort).
+ * Falls back to "default" if not present — safe fallback per IL7 principle.
+ *
+ * NOTE: pi never populates persona/phase on ExtensionContext in production —
+ * this probe only matches in test harnesses. Production paths MUST inject the
+ * phaseKey at construction time (createGovernor's `phaseKey` param via
+ * buildGovernorFactory); this fallback resolving to "default" was the dormant-
+ * governor defect found benchmarking CART-S02-T03.
+ */
+function resolvePhaseKey(ctx) {
+    const persona = ctx.persona ?? "";
+    const phase = ctx.phase ?? "";
+    if (persona && phase)
+        return `${persona}/${phase}`;
+    return "default";
+}
+/**
+ * Read-like forge_store / forge_artifact commands eligible for dedup.
+ * Anything else (set-summary, write, update-status, emit, …) is a MUTATION —
+ * its result is a confirmation/failure report that must reach the agent
+ * verbatim. CART-S02-T04 friction: a forge_artifact WRITE confirmation was
+ * replaced by a pointer registered by an earlier READ of the same path; a
+ * failed write would have been silently masked (Iron Law 5 violation).
+ */
+const DEDUP_READ_COMMANDS = new Set([
+    "read",
+    "get",
+    "get-task",
+    "get-bug",
+    "get-sprint",
+    "get-summary",
+    "get-bug-summary",
+    "list",
+    "describe",
+    "template",
+]);
+/**
+ * Compute the dedup key for a tool result event.
+ * Returns null if dedup does not apply to this tool — including any
+ * forge_store/forge_artifact MUTATION command (reads-only rule).
+ * The command participates in the key so e.g. read vs list of the same
+ * entity never conflate. A missing command (legacy/test event shapes)
+ * is treated as read-like.
+ */
+function dedupKey(event) {
+    const input = event.input ?? {};
+    if (event.toolName === "forge_store" || event.toolName === "forge_artifact") {
+        const command = typeof input.command === "string" ? input.command : "";
+        if (command && !DEDUP_READ_COMMANDS.has(command))
+            return null; // mutation — never dedup
+        const target = input.entityId ??
+            input.path ??
+            input.artifact ??
+            "";
+        return `${event.toolName}:${command}:${target}`;
+    }
+    if (event.toolName === "read") {
+        const target = input.file_path ?? "";
+        return `read:${target}`;
+    }
+    return null;
+}
+/**
+ * Apply Rule 2 — schema-trim to a forge_store result.
+ * Trims top-level keys to residentFields ∪ {summaries} ∪ identity keys.
+ * Returns the trimmed JSON string, or the original string on parse failure (IL7).
+ */
+function applySchemaTrim(textContent, residentFields) {
+    let parsed;
+    try {
+        parsed = JSON.parse(textContent);
+    }
+    catch {
+        // Malformed JSON — pass through untouched (IL7)
+        return textContent;
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        return textContent;
+    }
+    // Identity fields always retained regardless of phase policy
+    const identityKeys = new Set(["taskId", "sprintId", "bugId", "featureId"]);
+    const residentSet = new Set(residentFields);
+    const trimmed = {};
+    for (const [key, value] of Object.entries(parsed)) {
+        const retain = identityKeys.has(key) || residentSet.has(key) || key === "summaries";
+        if (retain) {
+            trimmed[key] = value;
+        }
+    }
+    return JSON.stringify(trimmed);
+}
+/**
+ * Apply Rule 3 — span-clamp to a bash/grep/find/read result.
+ * Truncates to budgetTokens*4 chars and appends "[N lines elided]" marker.
+ * Under-budget results pass through untouched (AC#3).
+ */
+function applySpanClamp(textContent, budgetTokens) {
+    const budgetChars = Math.floor(budgetTokens * 4);
+    if (textContent.length <= budgetChars) {
+        return textContent;
+    }
+    const kept = textContent.slice(0, budgetChars);
+    const elided = textContent.slice(budgetChars);
+    const elidedLines = elided.split("\n").length;
+    return `${kept}\n[${elidedLines} lines elided]`;
+}
+// ---------------------------------------------------------------------------
+// Mechanism C helpers (module-internal — not exported; knip-safe)
+// ---------------------------------------------------------------------------
+/**
+ * Extract the entityId from a ToolResultEvent input payload.
+ * Returns an empty string if not present or not a string (safe fallback — IL7).
+ */
+function resolveEntityId(event) {
+    const input = event.input ?? {};
+    const entityId = input.entityId;
+    return typeof entityId === "string" ? entityId : "";
+}
+// ---------------------------------------------------------------------------
+// Mechanism B helpers (module-internal — not exported; knip-safe)
+// ---------------------------------------------------------------------------
+/**
+ * Build the one-shot steer message injected into the agent loop when the budget
+ * threshold is reached. Names the phase summary file (from phase-vocab, mirror
+ * of the plugin's artifact-kinds.cjs catalog) so the persona can act
+ * immediately. Phases without a summary artifact — and unknown phase keys
+ * (e.g. custom config.pipelines phases) — get generic checkpoint wording
+ * instead of a phantom or placeholder filename (FORGE-BUG-043).
+ * "Will not re-fire" note prevents the agent from waiting for a second prompt.
+ */
+function buildSteerMessage(phaseKey) {
+    const filename = summaryFilenameFor(phaseKey);
+    const checkpoint = filename
+        ? `Checkpoint your findings to ${filename} before reading further.`
+        : `Checkpoint your findings durably (phase summary artifact or store record) before reading further.`;
+    return (`[Forge context governor] Budget threshold reached (${phaseKey}).\n` +
+        `${checkpoint}\n` +
+        `This note will not re-fire.`);
+}
+// ---------------------------------------------------------------------------
+// Governor factory (contextWindow-aware, Mechanism A curation + Mechanism B meter)
+// ---------------------------------------------------------------------------
+/**
+ * Create a governor backed by the given policy table and model registry.
+ *
+ * Implements Mechanism A curation rules (T04):
+ *   Rule 1 — Dedup/reference-ize
+ *   Rule 2 — Schema-trim (forge_store results)
+ *   Rule 3 — Span-clamp (bash/grep/find/read results)
+ *
+ * Implements Mechanism B (T05):
+ *   Budget meter: per-turn ctx.getContextUsage() → ctx.ui.setStatus("forge:ctx-budget", ...)
+ *   Steer: one-shot note at policy.steerThreshold, injected via steerFn
+ *
+ * Implements Mechanism C (T06):
+ *   Checkpoint-and-shed: forge_store results for summarized entities are evicted
+ *   and replaced with an eviction pointer; unsummarized material is retained.
+ *   Shed criterion: summarySentinel(phaseKey, entityId) returns true.
+ *
+ * @param table     Phase-policy table (keyed by "persona/phase").
+ * @param _modelRegistry  Model registry (fallback contextWindow resolution only).
+ * @param steerFn   Optional callback injected at construction by registerHookDispatcher.
+ *                  Receives the steer message string; called at most once per governor
+ *                  instance (single-fire invariant). Callers that omit this see no steer.
+ * @param summarySentinel  Optional read-only probe injected at construction (Mechanism C / T06).
+ *                  Receives (phaseKey, entityId); returns true when a {PHASE}-SUMMARY.json
+ *                  has been durably written for that entity. When true, the forge_store result
+ *                  is replaced with an eviction pointer. Callers that omit this param see no
+ *                  shedding (backwards-compatible; undefined default).
+ *                  The sentinel MUST NOT write to .forge/store/ or the summary itself (Pack 07).
+ *                  Errors inside the sentinel are silently caught and cause retain, not eviction (IL7).
+ *
+ * contextWindow resolution (provider-neutral): usage.contextWindow from
+ * ctx.getContextUsage(), used directly when available; otherwise the budget
+ * meter is cleared for the turn and no steer/compact decision is made.
+ * @param compactFn  opt callback injected at construction (Mechanism E / T09).
+ *                  Called proactively once when fraction >= policy.steerThreshold,
+ *                  via a single-fire `compactFired` flag distinct from `steerFired`.
+ *                  Callers pass `compactFn = () => session.compact()`. Errors inside
+ *                  compactFn are caught and written to stderr (IL7). Omitting this
+ *                  param is backwards-compatible — no compact trigger fires.
+ * @param phaseKey  opt construction-time phase key override ("persona/role").
+ *                  Production paths MUST pass this (via buildGovernorFactory) —
+ *                  pi never populates persona/phase on ExtensionContext, so the
+ *                  ctx probe always resolves "default" at runtime. Omitting it
+ *                  preserves the legacy ctx-probe behaviour (test harnesses).
+ */
+export function createGovernor(table, _modelRegistry, steerFn, summarySentinel, compactFn, phaseKey) {
+    // Per-governor-instance dedup registry.
+    // Maps "${toolName}:${command}:${target}" → { turn, pointerServed }.
+    // pointerServed implements pointer ALTERNATION: serve the pointer at most
+    // once in a row per key, then honour the next identical call with full
+    // content (CART-S02-T04 friction: "re-query if needed" was impossible by
+    // construction — every re-query returned another pointer, driving agents
+    // to bash-cat workarounds).
+    const dedupRegistry = new Map();
+    let currentTurn = 0;
+    // Mechanism B: single-fire steer invariant
+    let steerFired = false;
+    // Mechanism E (T09): single-fire compact trigger — distinct from steerFired so
+    // proactive compact and steer can be enabled independently.
+    let compactFired = false;
+    return {
+        applyToolResult(event, ctx) {
+            try {
+                currentTurn++;
+                // Resolve phase key and policy (shared by Mechanism B meter and Mechanism A curation).
+                // Construction-time override wins — pi never sets persona/phase on ctx.
+                const resolvedPhaseKey = phaseKey ?? resolvePhaseKey(ctx);
+                const policy = table[resolvedPhaseKey] ??
+                    table["default"] ?? {
+                    residentFields: [],
+                    toolBudgets: {},
+                    steerThreshold: 0.9,
+                };
+                // ------------------------------------------------------------------
+                // Mechanism B — budget meter + steer (prefix, before Mechanism A)
+                // Wrapped in its own try/catch so any failure (e.g. missing ctx method
+                // in older mock environments) falls through silently and Mechanism A
+                // curation continues unaffected (IL7).
+                // ------------------------------------------------------------------
+                try {
+                    const statusKey = "forge:ctx-budget";
+                    const usage = ctx.getContextUsage();
+                    if (usage && usage.tokens !== null) {
+                        const fraction = usage.tokens / usage.contextWindow;
+                        const N = Math.round(usage.tokens / 1000);
+                        const W = Math.round(usage.contextWindow / 1000);
+                        const P = usage.percent ?? Math.round(fraction * 100);
+                        ctx.ui.setStatus(statusKey, `ctx: ${N}k / ${W}k (${P}%)`);
+                        if (fraction >= policy.steerThreshold && !steerFired && steerFn) {
+                            steerFired = true;
+                            steerFn(buildSteerMessage(resolvedPhaseKey));
+                        }
+                        // Mechanism E (T09): proactive compact trigger — single-fire, independent of steer.
+                        if (fraction >= policy.steerThreshold && !compactFired && compactFn) {
+                            compactFired = true;
+                            try {
+                                compactFn();
+                            }
+                            catch (compactErr) {
+                                const msg = compactErr instanceof Error ? compactErr.message : String(compactErr);
+                                process.stderr.write(`[context-governor] compactFn error (non-fatal): ${msg}\n`);
+                            }
+                        }
+                    }
+                    else {
+                        ctx.ui.setStatus(statusKey, undefined);
+                    }
+                }
+                catch {
+                    // IL7: Mechanism B failures are silent; Mechanism A continues.
+                }
+                // ------------------------------------------------------------------
+                // Mechanism A — curation (dedup / schema-trim / span-clamp)
+                // ------------------------------------------------------------------
+                // Error results bypass ALL curation: they are small, must reach the
+                // agent verbatim, and must never register or serve dedup pointers
+                // (CART-S02-T04 friction: pointers were served on errored re-reads,
+                // and errored first-reads poisoned the registry).
+                if (event.isError) {
+                    return undefined;
+                }
+                // Rule 1 — Dedup/reference-ize (reads-only; pointer alternation)
+                const key = dedupKey(event);
+                if (key !== null) {
+                    const entry = dedupRegistry.get(key);
+                    if (entry !== undefined) {
+                        if (!entry.pointerServed) {
+                            // Repeated read — replace with pointer (at most once in a row)
+                            entry.pointerServed = true;
+                            return {
+                                content: [
+                                    {
+                                        type: "text",
+                                        text: `[unchanged since turn ${entry.turn} — call again to re-fetch]`,
+                                    },
+                                ],
+                            };
+                        }
+                        // Agent called again right after a pointer — honour the re-fetch:
+                        // re-arm the pointer for later repeats and FALL THROUGH so the
+                        // re-fetched content still receives Mechanism C / Rules 2–3
+                        // curation (shed/trim/clamp), exactly like a first occurrence.
+                        entry.pointerServed = false;
+                    }
+                    else {
+                        // Register first occurrence
+                        dedupRegistry.set(key, { turn: currentTurn, pointerServed: false });
+                    }
+                }
+                // ------------------------------------------------------------------
+                // Mechanism C — checkpoint-and-shed (T06)
+                // Runs AFTER Rule 1 dedup registration so the first-occurrence key
+                // is always recorded. Only fires for forge_store events.
+                // Wrapped in its own try/catch (IL7): sentinel errors cause retain.
+                // The sentinel is a read-only probe — never writes .forge/store/ (Pack 07).
+                // ------------------------------------------------------------------
+                if (summarySentinel !== undefined && event.toolName === "forge_store") {
+                    try {
+                        const entityId = resolveEntityId(event);
+                        if (entityId && summarySentinel(resolvedPhaseKey, entityId)) {
+                            // summaryFilenameFor is null for phases without a summary artifact;
+                            // an injected sentinel may still fire there, so fall back to naming
+                            // the store record rather than a phantom file.
+                            const summaryRef = summaryFilenameFor(resolvedPhaseKey) ?? "the store record summaries";
+                            return {
+                                content: [
+                                    {
+                                        type: "text",
+                                        text: `[summarized — see ${summaryRef} for ${entityId}]`,
+                                    },
+                                ],
+                            };
+                        }
+                    }
+                    catch {
+                        // IL7: sentinel errors are silent; continue to Mechanism A.
+                    }
+                }
+                // Extract text content for Rules 2 and 3
+                const textBlocks = event.content.filter((c) => c.type === "text");
+                if (textBlocks.length === 0) {
+                    return undefined;
+                }
+                const fullText = textBlocks.map((b) => b.text).join("");
+                // Rule 2 — Schema-trim (forge_store results only)
+                if (event.toolName === "forge_store") {
+                    const trimmed = applySchemaTrim(fullText, policy.residentFields);
+                    if (trimmed !== fullText) {
+                        return { content: [{ type: "text", text: trimmed }] };
+                    }
+                    return undefined;
+                }
+                // Rule 3 — Span-clamp (bash/grep/find/read results)
+                const spannedTools = new Set(["bash", "grep", "find", "read"]);
+                if (spannedTools.has(event.toolName)) {
+                    const budget = policy.toolBudgets[event.toolName] ?? policy.toolBudgets["bash"];
+                    if (budget !== undefined) {
+                        const clamped = applySpanClamp(fullText, budget);
+                        if (clamped !== fullText) {
+                            return { content: [{ type: "text", text: clamped }] };
+                        }
+                    }
+                    return undefined;
+                }
+                return undefined;
+            }
+            catch (err) {
+                // IL7: never throw from the governor
+                const msg = err instanceof Error ? err.message : String(err);
+                process.stderr.write(`[context-governor] applyToolResult error: ${msg}\n`);
+                return undefined;
+            }
+        },
+        applyToolCall(event, _ctx) {
+            // T03/T04/T05/T06: no-op body for tool_call.
+            // T06 Mechanism C shed gate is implemented in applyToolResult above;
+            // applyToolCall remains no-op for Mechanism C.
+            void event;
+            return undefined;
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Default policy table (Mechanism D — ≥2 phases + safe default)
+// ---------------------------------------------------------------------------
+/**
+ * Load the built-in phase-policy table.
+ *
+ * Ships an entry for every governed run-task PHASE_PIPELINE key
+ * (`${personaNoun}/${role}` — engineer/plan, supervisor/review-plan,
+ * engineer/implement, supervisor/review-code, qa-engineer/validate,
+ * architect/approve) plus "default" for any unlisted persona/phase.
+ * writeback/commit intentionally stay on "default" — small phases whose
+ * git/store output must not be clamped.
+ *
+ * `read` budgets are deliberately more generous than `bash` — clamping file
+ * reads too tightly degrades implement/review quality (the agent cannot see
+ * whole files), while bash output (store-cli reads, test logs, greps) is the
+ * dominant context bloat observed in the CART-S02-T03 baseline.
+ *
+ * Legacy design-time keys ("architect/plan", "engineer/review") are retained
+ * for existing test fixtures; the pipeline never produces them.
+ *
+ * Values are conservative design-time decisions; a future task can promote
+ * specific fields to project config once per-project tuning evidence exists.
+ */
+export function loadDefaultPolicyTable() {
+    return {
+        // ── Real run-task PHASE_PIPELINE keys ──────────────────────────────
+        "engineer/plan": {
+            residentFields: ["status", "title", "dependencies", "description"],
+            toolBudgets: { forge_store: 2000, bash: 1000, read: 3000 },
+            steerThreshold: 0.8,
+        },
+        "supervisor/review-plan": {
+            residentFields: ["status", "summaries", "acceptanceCriteria"],
+            toolBudgets: { forge_store: 1500, bash: 800, read: 3000 },
+            steerThreshold: 0.75,
+        },
+        "engineer/implement": {
+            residentFields: ["status", "title", "description", "summaries"],
+            toolBudgets: { forge_store: 2000, bash: 1500, read: 4000 },
+            steerThreshold: 0.8,
+        },
+        "supervisor/review-code": {
+            residentFields: ["status", "summaries", "acceptanceCriteria"],
+            toolBudgets: { forge_store: 1500, bash: 800, read: 3000 },
+            steerThreshold: 0.75,
+        },
+        "qa-engineer/validate": {
+            residentFields: ["status", "summaries", "acceptanceCriteria"],
+            toolBudgets: { forge_store: 1500, bash: 2000, read: 3000 },
+            steerThreshold: 0.75,
+        },
+        "architect/approve": {
+            residentFields: ["status", "summaries", "acceptanceCriteria"],
+            toolBudgets: { forge_store: 1500, bash: 1000, read: 3000 },
+            steerThreshold: 0.75,
+        },
+        // ── Legacy design-time keys (test fixtures only) ───────────────────
+        "architect/plan": {
+            residentFields: ["status", "title", "dependencies", "description"],
+            toolBudgets: { forge_store: 2000, bash: 1000 },
+            steerThreshold: 0.8,
+        },
+        "engineer/review": {
+            residentFields: ["status", "summaries", "acceptanceCriteria"],
+            toolBudgets: { forge_store: 1500, bash: 800 },
+            steerThreshold: 0.75,
+        },
+        default: {
+            residentFields: [],
+            toolBudgets: {},
+            steerThreshold: 0.9,
+        },
+    };
+}
+/**
+ * Read-only Mechanism C sentinel: true when the store record for entityId
+ * already carries a summary for the given phase. Reads
+ * `<storePath>/{tasks,bugs}/<entityId>.json` directly (never writes — Pack 07).
+ * storePath comes from paths.store in .forge/config.json (default
+ * ".forge/store" — FORGE-BUG-043 PR 2). Any failure returns false → retain,
+ * never evict (IL7).
+ */
+function storeSummarySentinel(cwd, storePath, phaseKey, entityId) {
+    const summaryKey = summaryKeyFor(phaseKey);
+    if (!summaryKey)
+        return false;
+    for (const kind of ["tasks", "bugs"]) {
+        try {
+            const recordPath = path.join(cwd, storePath, kind, `${entityId}.json`);
+            const raw = fs.readFileSync(recordPath, "utf8");
+            const record = JSON.parse(raw);
+            const summary = record.summaries?.[summaryKey];
+            if (summary !== undefined && summary !== null)
+                return true;
+        }
+        catch {
+            // missing file / parse failure → try next kind, default retain (IL7)
+        }
+    }
+    return false;
+}
+/**
+ * Build an ExtensionFactory that registers a fully-wired context governor in a
+ * subagent session. Constructed per-phase by run-task.ts (which knows the
+ * persona/role) and passed via RunSubagentOptions.extensionFactories —
+ * the same injection channel as buildForgeCompactionFactory (Mechanism E).
+ *
+ * This is the production wiring the original FORGE-S30-T07 integration missed:
+ * registerHookDispatcher(pi, …, governor) in index.ts only governs the PARENT
+ * session, while every phase runs in an isolated createAgentSession subagent
+ * that the parent's hooks never see. The CART-S02-T03 benchmark confirmed the
+ * result: zero curation markers across a full FORGE_CTX_GOVERNOR=1 phase.
+ *
+ * Wiring supplied here:
+ *   phaseKey        — construction-time (Mechanism D policies finally reachable)
+ *   steerFn         — pi.sendUserMessage(msg, { deliverAs: "steer" }) (Mechanism B)
+ *   summarySentinel — storeSummarySentinel against .forge/store/ (Mechanism C)
+ *   compactFn       — ctx.compact() proactive trigger (Mechanism E)
+ *
+ * steer uses the session-scoped ExtensionAPI directly; compact rides the
+ * ExtensionContext captured at the start of each handler invocation — it only
+ * fires synchronously inside applyToolResult, so the captured ctx is always
+ * the live one. All callbacks are guarded: failures fall through silently
+ * (IL7); the factory never writes to .forge/store/ (Pack 07).
+ */
+export function buildGovernorFactory(opts) {
+    const { phaseKey, cwd } = opts;
+    // Project config (paths.store) loads ONCE at factory construction — never
+    // per tool event (FORGE-BUG-043 PR 2). IL7 defaults apply without a config.
+    const projectConfig = loadGovernorProjectConfig(cwd);
+    return (pi) => {
+        let currentCtx;
+        const steerFn = (message) => {
+            try {
+                pi.sendUserMessage(message, { deliverAs: "steer" });
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                process.stderr.write(`[context-governor] steerFn error (non-fatal): ${msg}\n`);
+            }
+        };
+        // createGovernor already wraps compactFn invocations in try/catch (IL7).
+        const compactFn = () => {
+            currentCtx?.compact();
+        };
+        const summarySentinel = (pk, entityId) => storeSummarySentinel(cwd, projectConfig.storePath, pk, entityId);
+        // Registration-time stub; per-turn contextWindow resolution uses
+        // ctx.getContextUsage()/ctx.modelRegistry inside the handler chain.
+        const stubRegistry = { find: () => undefined };
+        const governor = createGovernor(loadDefaultPolicyTable(), stubRegistry, steerFn, summarySentinel, compactFn, phaseKey);
+        // Return types mirror hook-dispatcher.ts's registrations: pi's typed
+        // on() overloads expect its internal result types; the governor's
+        // structurally-equivalent locals satisfy them at runtime.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        pi.on("tool_call", (event, ctx) => {
+            currentCtx = ctx;
+            return governor.applyToolCall(event, ctx);
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        pi.on("tool_result", (event, ctx) => {
+            currentCtx = ctx;
+            return governor.applyToolResult(event, ctx);
+        });
+    };
+}
+//# sourceMappingURL=context-governor.js.map

package/dist/extensions/forgecli/context-governor.js.map

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