@entelligentsia/forgecli 1.0.14 → 1.0.20

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

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

package/dist/extensions/forgecli/context-governor.d.ts

@@ -0,0 +1,173 @@
+import type { ExtensionContext, ExtensionFactory, ToolCallEvent, ToolCallEventResult, ToolResultEvent } from "@earendil-works/pi-coding-agent";
+import type { ModelRegistry } from "@earendil-works/pi-coding-agent";
+/**
+ * Return type for tool_result pi handlers — matches ToolResultEventResult from
+ * @earendil-works/pi-coding-agent (not exported from the package root).
+ * Structural equivalence is sufficient for TypeScript assignability.
+ */
+export interface ToolResultEventResult {
+    content?: Array<{
+        type: "text";
+        text: string;
+    } | {
+        type: "image";
+        source: unknown;
+    }>;
+    details?: unknown;
+    isError?: boolean;
+}
+/**
+ * Policy for a single persona/phase combination.
+ *
+ * residentFields — names of task/sprint record fields that are always retained
+ *   in context (not trimmed by Mechanism A).
+ * toolBudgets    — per-tool soft token budget caps (keyed by tool name).
+ *   T04 reads these when deciding how aggressively to trim tool_result content.
+ * steerThreshold — fraction of contextWindow at which Mechanism B fires a
+ *   budget-steer note (0–1; e.g. 0.80 = steer when 80% of window is used).
+ */
+export interface PhasePolicy {
+    residentFields: string[];
+    toolBudgets: Record<string, number>;
+    steerThreshold: number;
+}
+/**
+ * Lookup table keyed by `"${persona}/${phase}"` (e.g. `"architect/plan"`,
+ * `"engineer/review"`) plus a `"default"` entry for unknown combinations.
+ */
+export type PhasePolicyTable = Record<string, PhasePolicy>;
+/**
+ * Governor interface wired into hook-dispatcher.ts.
+ * T03: both methods return undefined/void (no-op). T04 supplies live curation
+ * logic via createGovernor.
+ *
+ * MUST NOT throw — IL7. Any internal failure must return undefined silently.
+ */
+export interface ContextGovernor {
+    /**
+     * Called after the triage-error block in the tool_result handler.
+     * Return a ToolResultEventResult to replace the event content, or undefined
+     * to pass through unchanged.
+     */
+    applyToolResult(event: ToolResultEvent, ctx: ExtensionContext): ToolResultEventResult | undefined;
+    /**
+     * Called at the tail of the tool_call handler (after all existing guards).
+     * Return a ToolCallEventResult to block or modify the call, or undefined/void
+     * to pass through unchanged.
+     */
+    applyToolCall(event: ToolCallEvent, ctx: ExtensionContext): ToolCallEventResult | void;
+}
+/**
+ * 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 declare function createNoOpGovernor(): ContextGovernor;
+/** Fallback context window when neither ctx.model nor modelRegistry can supply one. */
+export declare const DEFAULT_CONTEXT_WINDOW = 200000;
+/**
+ * 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 order (provider-neutral):
+ *   1. usage.contextWindow from ctx.getContextUsage() — direct, when available
+ *   2. ctx.model?.contextWindow — active model
+ *   3. ctx.modelRegistry.find(provider, modelId)?.contextWindow — registry backup
+ *   4. DEFAULT_CONTEXT_WINDOW (200_000) — conservative fallback
+ * @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 declare function createGovernor(table: PhasePolicyTable, _modelRegistry: ModelRegistry, steerFn?: (message: string) => void, summarySentinel?: (phaseKey: string, entityId: string) => boolean, compactFn?: () => void, phaseKey?: string): ContextGovernor;
+/**
+ * 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 declare function loadDefaultPolicyTable(): PhasePolicyTable;
+/** Options for buildGovernorFactory. */
+export interface GovernorFactoryOptions {
+    /**
+     * Pipeline phase key, `${personaNoun}/${role}` (e.g. "supervisor/review-code").
+     * Known to run-task.ts at dispatch time; injected here because pi never
+     * populates persona/phase on ExtensionContext.
+     */
+    phaseKey: string;
+    /** Project cwd — root containing `.forge/store/` (sentinel reads only). */
+    cwd: string;
+}
+/**
+ * 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 declare function buildGovernorFactory(opts: GovernorFactoryOptions): ExtensionFactory;