@entelligentsia/forgecli 1.0.25 → 1.0.40

package/dist/extensions/forgecli/orchestrators/common/summary-recovery.js

@@ -0,0 +1,37 @@
+// summary-recovery.ts — deterministic phase-completion recovery for the
+// orchestrator pipelines (forge-engineering#41).
+//
+// Failure mode: a phase's subagent finalizes in two steps —
+//   1. `forge_artifact write <phase>-summary` → writes the {PHASE}-SUMMARY.json
+//      sidecar to the record's path on disk, and
+//   2. `forge_store set-summary <id> <phaseKey>` → ingests that sidecar into
+//      `record.summaries.<phaseKey>`.
+// Under turn-budget pressure (or with a weaker model) the subagent stops after
+// step 1 with stopReason=stop, silently eliding step 2. The orchestrator then
+// reads the store, finds no verdict, and hard-fails the phase — forcing the
+// operator to rerun the whole task even though the work artifact is on disk.
+//
+// Recovery: the orchestrator registers the subagent's already-authored sidecar
+// itself by running step 2 (store-cli set-summary / set-bug-summary — the
+// sidecar is auto-resolved from record.path when the file arg is omitted), then
+// re-checks its gate. This does NOT fabricate a verdict (IL10): the verdict
+// content is the subagent's own sidecar; the orchestrator only registers it,
+// exactly as it already emits phase events on the subagent's behalf. When the
+// sidecar is genuinely absent, set-summary exits non-zero and the caller falls
+// through to the existing hard-fail + halt advisor.
+//
+// IL6 — external invocation via spawnSync argv array, no shell interpolation.
+import { spawnSync } from "node:child_process";
+/**
+ * Attempt to register a phase's already-written {PHASE}-SUMMARY.json sidecar
+ * into the store via store-cli. Returns ok=true only when the verb exits 0.
+ */
+export function recoverPhaseSummary(p) {
+    const verb = p.summaryVerb ?? "set-summary";
+    const r = spawnSync("node", [p.storeCli, verb, p.entityId, p.summaryKey], {
+        cwd: p.cwd,
+        encoding: "utf8",
+    });
+    return { attempted: true, ok: r.status === 0, stderr: (r.stderr ?? "").toString() };
+}
+//# sourceMappingURL=summary-recovery.js.map

package/dist/extensions/forgecli/orchestrators/common/summary-recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-recovery.js","sourceRoot":"","sources":["../../../../../src/extensions/forgecli/orchestrators/common/summary-recovery.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,iDAAiD;AACjD,EAAE;AACF,4DAA4D;AAC5D,gFAAgF;AAChF,iDAAiD;AACjD,6EAA6E;AAC7E,sCAAsC;AACtC,+EAA+E;AAC/E,8EAA8E;AAC9E,4EAA4E;AAC5E,6EAA6E;AAC7E,EAAE;AACF,+EAA+E;AAC/E,0EAA0E;AAC1E,gFAAgF;AAChF,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,+EAA+E;AAC/E,oDAAoD;AACpD,EAAE;AACF,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAuB/C;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,CAA4B;IAC/D,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,IAAI,aAAa,CAAC;IAC5C,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE;QACzE,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,QAAQ,EAAE,MAAM;KAChB,CAAC,CAAC;IACH,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;AACrF,CAAC"}

package/dist/extensions/forgecli/orchestrators/fix-bug.d.ts

@@ -1,94 +1,10 @@
-import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
-import { type ForgeToolDefs } from "../forge-tools.js";
-import { getSessionRegistry } from "../session-registry.js";
-import { type PhaseDescriptor } from "./run-task.js";
-export declare const BUG_PHASES: PhaseDescriptor[];
+export { BUG_PHASES, BUG_TYPE_TOKENS, postTriageTransitions } from "./bug/bug-phases.js";
+export { type RouteAfterTriageOutcome, type RouteAfterTriageParams, routeAfterTriage, } from "./bug/bug-triage-routing.js";
 export { BUG_SUMMARY_KEY_BY_ROLE } from "../subagent/phase-summary-map.js";
-export declare const BUG_TYPE_TOKENS: Record<string, {
-    pass: string;
-    fail: string;
-}>;
-export declare function postTriageTransitions(status: string | undefined): string[];
-export interface RunBugState {
-    bugId: string;
-    phaseIndex: number;
-    iterationCounts: Record<string, number>;
-    halted: boolean;
-    /** Set on cancellation so the resume prompt says "cancelled" vs "halted". */
-    status?: "cancelled" | "halted" | "running";
-    lastError?: string;
-    savedAt: string;
-}
-export declare function readBugState(cwd: string, bugId: string, sessionId?: string): RunBugState | null;
-export declare function writeBugState(cwd: string, state: RunBugState): void;
-export declare function deleteBugState(cwd: string, bugId: string): void;
-export declare function isBugStateStale(state: RunBugState): boolean;
-export interface BugRecord {
-    bugId?: string;
-    status?: string;
-    summaries?: Record<string, unknown>;
-    [key: string]: unknown;
-}
-export declare function readBugRecord(bugId: string, storeCli: string, cwd: string): BugRecord | null;
-export declare function computeNextBugId(bugIds: string[], prefix: string): string;
-export declare function assignNextBugId(storeCli: string, cwd: string, prefix?: string): string;
-export declare function extractBugIdFromReportText(text: string, prefix: string): string | null;
-export declare function preCreateBug(bugId: string, title: string, storeCli: string, cwd: string): boolean;
-type BugVerdict = "approved" | "revision" | "n/a" | "missing";
-export declare function readBugVerdict(bugRecord: BugRecord | null, phaseRole: string, summaryKeyByRole: Record<string, string | null>): BugVerdict;
-export declare function composeBugBody(subWorkflowMd: string, bugId: string, phaseRole: string, bugStatusBeforePhase?: string, summariesBlock?: string): string;
-/**
- * Scan tool_execution_end events to extract the bugId written by a triage
- * subagent. Returns the LAST matching tool call's bugId, or null if none found.
- *
- * In pi runtime, the forge_store tool is registered as "forge_store" (not
- * "store-cli"). In Claude Code runtime, subagents may shell out via Bash.
- * This function covers all three paths.
- */
-export declare function extractBugIdFromEvents(events: Array<{
-    toolName?: string;
-    result?: unknown;
-}>, prefix?: string): string | null;
-export type RunBugPipelineStatus = "completed" | "halted" | "escalated" | "failed" | "cancelled";
-export interface RunBugPipelineResult {
-    status: RunBugPipelineStatus;
-    lastPhaseIndex: number;
-    iterationCounts: Record<string, number>;
-    lastError?: string;
-    model?: string;
-    provider?: string;
-    /**
-     * Project-local orchestrator JSONL path for this run. Callers hand it to
-     * archiveRun() to mirror the run into the central transcript archive.
-     * Unset only when the pipeline returned before the writer was created.
-     */
-    orchestratorTranscriptPath?: string;
-}
-export interface RunBugPipelineOptions {
-    bugId: string;
-    /** Original free-form text argument when creating a new bug (not a FORGE-BUG-NNN ID).
-     *  Passed to triage-phase subagent so it can create the bug with a meaningful description. */
-    originalArg?: string;
-    /** Whether this is a new bug (free-form text) vs. an existing FORGE-BUG-NNN ID. */
-    isNewBug?: boolean;
-    cwd: string;
-    ctx: ExtensionCommandContext;
-    forgeRoot: string;
-    storeCli: string;
-    preflightGate: string;
-    registry: ReturnType<typeof getSessionRegistry>;
-    resumeFromState?: RunBugState;
-    /**
-     * Optional AbortSignal from SessionRegistry. When provided, the pipeline
-     * checks signal.aborted between phases and passes the signal to
-     * runForgeSubagent so in-flight subagents can be aborted.
-     */
-    signal?: AbortSignal;
-    forgeToolDefs?: ForgeToolDefs;
-}
-export declare function runBugPipeline(opts: RunBugPipelineOptions): Promise<RunBugPipelineResult>;
-export interface RegisterFixBugOptions {
-    cwd?: string;
-    forgeToolDefs?: ForgeToolDefs;
-}
-export declare function registerFixBug(pi: ExtensionAPI, options?: RegisterFixBugOptions): void;
+export { deleteBugState, isBugStateStale, readBugState, type RunBugState, writeBugState, } from "./bug/bug-state.js";
+export { assignNextBugId, type BugRecord, computeNextBugId, extractBugIdFromEvents, extractBugIdFromReportText, preCreateBug, readBugRecord, } from "./bug/bug-id.js";
+export { readBugVerdict } from "./bug/bug-verdict.js";
+export { composeBugBody } from "./bug/bug-body.js";
+export { type RunBugPipelineOptions, type RunBugPipelineResult, type RunBugPipelineStatus, } from "./bug/run-bug-types.js";
+export { runBugPipeline } from "./bug/run-bug-pipeline.js";
+export { type RegisterFixBugOptions, registerFixBug } from "./bug/run-bug-command.js";