@entelligentsia/forgecli 1.0.21 → 1.0.36

package/dist/extensions/forgecli/orchestrators/bug/bug-id.js

@@ -0,0 +1,140 @@
+// bug-id.ts — bug record read helper plus the bug-ID minting / capture
+// utilities (computeNextBugId, assignNextBugId, extractBugIdFromReportText,
+// preCreateBug, extractBugIdFromEvents). Extracted VERBATIM from fix-bug.ts
+// (FORGE-S31 file-size refactor); no logic changes.
+import { spawnSync } from "node:child_process";
+export function readBugRecord(bugId, storeCli, cwd) {
+    const result = spawnSync("node", [storeCli, "read", "bug", bugId], { cwd, encoding: "utf8" });
+    if (result.status !== 0)
+        return null;
+    try {
+        const raw = typeof result.stdout === "string" ? result.stdout : String(result.stdout);
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+// Pure helper: next <PREFIX>-BUG-NNN ID given the existing bug IDs.
+// Only same-prefix bugs participate in the increment — exported for tests.
+// The prefix is config-owned (project.prefix) and identifier-validated by
+// loadGovernorProjectConfig, so it is safe to splice into a RegExp.
+export function computeNextBugId(bugIds, prefix) {
+    const idPattern = new RegExp(`^${prefix}-BUG-(\\d+)$`);
+    let maxNum = 0;
+    for (const id of bugIds) {
+        const m = idPattern.exec(id);
+        if (m) {
+            const n = parseInt(m[1], 10);
+            if (n > maxNum)
+                maxNum = n;
+        }
+    }
+    return `${prefix}-BUG-${String(maxNum + 1).padStart(3, "0")}`;
+}
+// Pre-assigns a real <PREFIX>-BUG-NNN ID by listing existing bugs and
+// incrementing. Prefix comes from .forge/config.json project.prefix — the
+// hardcoded FORGE prefix minted phantom FORGE-BUG-* records in any project
+// with a different prefix (CART testbench incident, FORGE-BUG-043 class).
+export function assignNextBugId(storeCli, cwd, prefix = "FORGE") {
+    const result = spawnSync("node", [storeCli, "list", "bug", "--json"], { cwd, encoding: "utf8" });
+    let bugIds = [];
+    if (result.status === 0 && result.stdout) {
+        try {
+            const bugs = JSON.parse(result.stdout);
+            if (Array.isArray(bugs)) {
+                bugIds = bugs.map((b) => String(b.bugId ?? ""));
+            }
+        }
+        catch {
+            /* empty store — start from 1 */
+        }
+    }
+    return computeNextBugId(bugIds, prefix);
+}
+// Extracts the first canonical <PREFIX>-BUG-NNN referenced in a bug-report
+// text (e.g. the "**Bug ID**: CART-BUG-001" header line BUG_REPORT.md files
+// carry). Used by the @file intake path so /forge:fix-bug @BUG_REPORT.md
+// operates on the referenced store record instead of minting a duplicate.
+// Prefix is config-owned and identifier-validated (safe in a RegExp).
+export function extractBugIdFromReportText(text, prefix) {
+    const m = text.match(new RegExp(`\\b${prefix}-BUG-\\d+\\b`));
+    return m ? m[0] : null;
+}
+// Pre-creates a minimal bug record so the subagent has a real ID to work with.
+export function preCreateBug(bugId, title, storeCli, cwd) {
+    const data = {
+        bugId,
+        title,
+        severity: "minor",
+        status: "reported",
+        path: `engineering/bugs/${bugId}`,
+        reportedAt: new Date().toISOString(),
+    };
+    const result = spawnSync("node", [storeCli, "write", "bug", JSON.stringify(data)], { cwd, encoding: "utf8" });
+    return result.status === 0;
+}
+// ── BugId capture via tool_execution_end ──────────────────────────────────
+/**
+ * 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 function extractBugIdFromEvents(events, prefix = "FORGE") {
+    // Prefix is config-owned (project.prefix) and identifier-validated by
+    // loadGovernorProjectConfig — the previous hardcoded FORGE-BUG- pattern
+    // missed every capture in differently-prefixed projects (CART incident).
+    const idPattern = new RegExp(`${prefix}-BUG-\\d+`);
+    const idPrefix = `${prefix}-BUG-`;
+    let lastBugId = null;
+    for (const event of events) {
+        if (!event.toolName)
+            continue;
+        // Check for store-cli write bug calls (Claude Code runtime)
+        if (event.toolName === "store-cli") {
+            const result = event.result;
+            if (typeof result === "string") {
+                const match = result.match(idPattern);
+                if (match)
+                    lastBugId = match[0];
+            }
+            else if (result && typeof result === "object") {
+                const obj = result;
+                if (typeof obj.bugId === "string" && obj.bugId.startsWith(idPrefix)) {
+                    lastBugId = obj.bugId;
+                }
+            }
+        }
+        // Check for forge_store tool calls (pi runtime)
+        // The pi extension registers the tool as "forge_store", not "store-cli".
+        if (event.toolName === "forge_store" && event.result != null) {
+            const output = typeof event.result === "string" ? event.result : JSON.stringify(event.result);
+            const match = output.match(idPattern);
+            if (match)
+                lastBugId = match[0];
+        }
+        // Also check for write operations to .forge/store/bugs/
+        if (event.toolName === "write" && typeof event.result === "string") {
+            const match = event.result.match(idPattern);
+            if (match)
+                lastBugId = match[0];
+        }
+        // Bash events: subagents shelling out via Bash may run "store-cli write bug".
+        // Only match when output includes store-cli, write, and bug together
+        // to avoid false positives from unrelated Bash commands that happen to
+        // mention a bug ID in a different context.
+        if (event.toolName === "bash" && event.result != null) {
+            const output = typeof event.result === "string" ? event.result : JSON.stringify(event.result);
+            if (output.includes("store-cli") && output.includes("write") && output.includes("bug")) {
+                const match = output.match(idPattern);
+                if (match)
+                    lastBugId = match[0];
+            }
+        }
+    }
+    return lastBugId;
+}
+//# sourceMappingURL=bug-id.js.map

package/dist/extensions/forgecli/orchestrators/bug/bug-id.js.map

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

package/dist/extensions/forgecli/orchestrators/bug/bug-phase-dispatch.d.ts

@@ -0,0 +1,54 @@
+import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import type { MergedConfig } from "../../config/config-layer.js";
+import { type SubagentResult } from "../../forge-subagent.js";
+import { attachViewportObserver } from "../../viewport/events.js";
+import { type PhaseDescriptor } from "../run-task.js";
+import type { BugRecord } from "./bug-id.js";
+import type { RunBugPipelineOptions, RunBugPipelineResult } from "./run-bug-types.js";
+export interface BugPhaseDispatchParams {
+    opts: RunBugPipelineOptions;
+    phase: PhaseDescriptor;
+    bugId: string;
+    cwd: string;
+    ctx: ExtensionCommandContext;
+    storeCli: string;
+    currentPhaseIndex: number;
+    iterationCounts: Record<string, number>;
+    dispatchCounts: Record<string, number>;
+    modelRoutingConfig: MergedConfig;
+    registry: RunBugPipelineOptions["registry"];
+    /** Whether this is a new bug — only used to decide the triage-prefix body. */
+    isNewBug: boolean | undefined;
+    originalArg: string | undefined;
+    /** Raw sub-workflow markdown already loaded + marker/audience-checked by the caller. */
+    subWorkflowMd: string;
+    /** Bug record read before this phase (status used for compose + cache key). */
+    bugRecordBefore: BugRecord | null;
+    bugStatusBeforePhase: string | undefined;
+    /** True when bugId is still a PENDING- placeholder (triage of a new bug). */
+    pendingBugId: boolean;
+}
+export type BugPhaseDispatchOutcome = {
+    kind: "return";
+    result: RunBugPipelineResult;
+} | {
+    kind: "ok";
+    result: SubagentResult;
+    finishPhaseNode: (status: "completed" | "failed" | "escalated") => void;
+    observer: ReturnType<typeof attachViewportObserver>;
+    phaseStart: number;
+    writeDebug: (rec: Record<string, unknown>) => void;
+    toolExecutionEvents: Array<{
+        toolName?: string;
+        result?: unknown;
+    }>;
+    debugLogPath: string | null;
+    debugLogDisabled: boolean;
+};
+/**
+ * Run a single bug phase's subagent dispatch and classify the immediate outcome
+ * (persona-load failure, subagent throw, cancellation, or non-zero exit) into a
+ * discriminated result. On success returns `kind: "ok"` with the live locals the
+ * caller's loop needs for bugId capture / verdict / advance handling.
+ */
+export declare function dispatchBugPhase(p: BugPhaseDispatchParams): Promise<BugPhaseDispatchOutcome>;

package/dist/extensions/forgecli/orchestrators/bug/bug-phase-dispatch.js

@@ -0,0 +1,349 @@
+// bug-phase-dispatch.ts — per-phase subagent dispatch for the fix-bug pipeline:
+// persona load → bug-body compose → debug-log setup → viewport observer attach
+// → model resolution → runForgeSubagent (IL10) → post-subagent abort /
+// halt-on-failure detection. Extracted VERBATIM from fix-bug.ts's phase loop
+// (FORGE-S31 file-size refactor) with no logic changes — the inline
+// `return {...}` paths now return `{ kind: "return"; result }`, and the success
+// path returns `{ kind: "ok"; ... }` carrying the live locals the loop needs
+// (subagent result, finishPhaseNode closure, observer, phaseStart, writeDebug,
+// the captured tool_execution_end events, and the debug-log handle/flags so the
+// post-triage bugId-capture block can re-initialize the log under the real ID).
+//
+// IL10 — ALL LLM dispatch goes through runForgeSubagent (NO sendKickoff here).
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { CallerContextStore } from "../../audience-gate.js";
+import { resolveModelForPhase } from "../../config/model-resolver.js";
+import { loadForgePersona, runForgeSubagent } from "../../forge-subagent.js";
+import { getSubagentTools } from "../../forge-tools.js";
+import { getOrchestratorTree } from "../../orchestrator-tree.js";
+import { attachViewportObserver } from "../../viewport/events.js";
+import { buildSummariesBlock, emitIncompletePhaseEvent } from "../run-task.js";
+import { composeBugBody } from "./bug-body.js";
+import { writeBugState } from "./bug-state.js";
+const STATUS_KEY = "forge:fix-bug";
+/**
+ * Run a single bug phase's subagent dispatch and classify the immediate outcome
+ * (persona-load failure, subagent throw, cancellation, or non-zero exit) into a
+ * discriminated result. On success returns `kind: "ok"` with the live locals the
+ * caller's loop needs for bugId capture / verdict / advance handling.
+ */
+export async function dispatchBugPhase(p) {
+    const { opts, phase, bugId, cwd, ctx, storeCli, currentPhaseIndex, iterationCounts, dispatchCounts, modelRoutingConfig, registry, isNewBug, originalArg, subWorkflowMd, bugRecordBefore, bugStatusBeforePhase, pendingBugId, } = p;
+    const tree = getOrchestratorTree();
+    // ── Persona load ──────────────────────────────────────────────
+    let persona;
+    try {
+        persona = loadForgePersona(phase.personaNoun, cwd);
+    }
+    catch (err) {
+        const e = err;
+        ctx.ui.notify(`× forge:fix-bug — persona '${phase.personaNoun}' not found for phase ${phase.role}: ${e.message ?? "unknown"}. ` +
+            "Run /forge:regenerate to materialize persona files.", "error");
+        writeBugState(cwd, {
+            bugId,
+            phaseIndex: currentPhaseIndex,
+            iterationCounts,
+            halted: true,
+            lastError: `persona load failed: ${e.message ?? "unknown"}`,
+            savedAt: new Date().toISOString(),
+        });
+        return {
+            kind: "return",
+            result: {
+                status: "failed",
+                lastPhaseIndex: currentPhaseIndex,
+                iterationCounts,
+                lastError: `persona load failed: ${e.message ?? "unknown"}`,
+            },
+        };
+    }
+    // ── 4. Dispatch via runForgeSubagent (IL10) ───────────────────
+    // NEVER sendKickoff here — that would reproduce issue #30.
+    // Carry forward prior phase summaries (forge-cli#19).
+    const bugSummariesBlock = currentPhaseIndex > 0 ? buildSummariesBlock(bugRecordBefore?.summaries) || undefined : undefined;
+    let bugBody = composeBugBody(subWorkflowMd, bugId, phase.role, bugStatusBeforePhase, bugSummariesBlock);
+    // For new bugs in triage, prepend the original free-form text so the
+    // subagent knows the user-provided bug description to triage.
+    // The bug record already exists (pre-created with status "reported"),
+    // so the subagent should update it, not create a new one.
+    if (phase.role === "triage" && isNewBug && originalArg) {
+        bugBody = `Bug description: ${originalArg}\n\n---\n\n${bugBody}`;
+    }
+    // Phase-scoped progress counters
+    const phaseStart = Date.now();
+    // Track tool_execution_end events for bugId capture (Findings #1, #2).
+    const toolExecutionEvents = [];
+    // Stabilization debug log
+    // Skip for PENDING bugIds — create after real bugId is captured.
+    // Disable entirely with FORGE_DEBUG_LOG=0.
+    const debugLogDisabled = process.env.FORGE_DEBUG_LOG === "0";
+    let debugLogPath = null;
+    let writeDebug = () => { };
+    if (!pendingBugId && !debugLogDisabled) {
+        debugLogPath = path.join(cwd, ".forge", "cache", `fix-bug-debug-${bugId}.jsonl`);
+        writeDebug = (rec) => {
+            try {
+                fs.mkdirSync(path.dirname(debugLogPath), { recursive: true });
+                // Cap at 10 MB: truncate head when size exceeds the cap.
+                try {
+                    const st = fs.statSync(debugLogPath);
+                    if (st.size > 10 * 1024 * 1024) {
+                        const all = fs.readFileSync(debugLogPath, "utf8");
+                        const lines = all.split("\n");
+                        // Keep last 80% of lines
+                        const keep = Math.floor(lines.length * 0.8);
+                        fs.writeFileSync(debugLogPath, lines.slice(-keep).join("\n"), "utf8");
+                    }
+                }
+                catch {
+                    /* file may not exist yet */
+                }
+                fs.appendFileSync(debugLogPath, `${JSON.stringify({ ts: new Date().toISOString(), phase: phase.role, ...rec })}\n`, "utf8");
+            }
+            catch {
+                // non-fatal; debug log is best-effort
+            }
+        };
+    }
+    writeDebug({ kind: "phase_start", phaseIndex: currentPhaseIndex });
+    registry.startPhase(bugId, phase.role, currentPhaseIndex);
+    // Bridge: register phase in OrchestratorTree. Node identity is
+    // per-dispatch (see dispatchCounts above) — never reuse an ID for
+    // a re-dispatched role.
+    const iteration = (dispatchCounts[phase.role] = (dispatchCounts[phase.role] ?? 0) + 1);
+    const phaseNodeId = `${bugId}:${phase.role}:${iteration}`;
+    tree.startNode(phaseNodeId, {
+        parentId: bugId,
+        label: `${phase.role}:${iteration}`,
+        kind: "leaf",
+        // Full body — display clamping/expansion is the view's decision
+        // (the tree applies only a storage cap).
+        promptPreview: bugBody,
+    });
+    const refreshStatus = () => {
+        if (process.env.FORGE_VERBOSE !== "1")
+            return;
+        const elapsed = Math.floor((Date.now() - phaseStart) / 1000);
+        const tail = observer.state.lastTool ? ` · ${observer.state.lastTool}` : "";
+        ctx.ui.setStatus?.(STATUS_KEY, `fix-bug ${bugId}: ${phase.role} · t${observer.state.turn} · tools ${observer.state.toolCount}${observer.state.errCount ? ` · err ${observer.state.errCount}` : ""} · ${elapsed}s${tail}`);
+    };
+    const observer = attachViewportObserver({
+        registry,
+        sessionId: bugId,
+        phaseRole: phase.role,
+        nodeId: phaseNodeId,
+        beginHeader: `─── phase ${phase.role} begin ───`,
+        writeDebug,
+        notify: (msg, level) => ctx.ui.notify(msg, level),
+        setStatusVerbose: process.env.FORGE_VERBOSE === "1" ? (k, v) => ctx.ui.setStatus?.(k, v) : undefined,
+        verboseKeys: { messageKey: `${STATUS_KEY}:message` },
+        afterEach: refreshStatus,
+    });
+    // Wrap the observer's onEvent to also capture tool_execution_end events
+    // for bugId capture downstream (findings #1, #2), plus the first turn_end
+    // per phase (IL10 visibility — stream-observed model id).
+    let modelObservedLogged = false;
+    const onSubagentEvent = (event) => {
+        if (event?.type === "tool_execution_end") {
+            toolExecutionEvents.push({ toolName: event.toolName, result: event.result });
+        }
+        if (!modelObservedLogged && event?.type === "turn_end" && event.message?.model) {
+            modelObservedLogged = true;
+            writeDebug({
+                kind: "model_observed",
+                provider: event.message.provider ?? null,
+                model: event.message.model,
+            });
+        }
+        observer.onEvent(event);
+    };
+    // Per-phase model resolution. When config is absent or cascade bottoms
+    // out, resolves to inherit (model: undefined) — setModel is skipped and
+    // pi's current model is used. IL10 still holds: result.model below is
+    // the stream-observed runtime model, not whatever we requested here.
+    const modelResolution = resolveModelForPhase("fix-bug", phase.role, phase.personaNoun, modelRoutingConfig);
+    writeDebug({
+        kind: "requested_model",
+        requested: modelResolution.model ?? null,
+        source: modelResolution.source,
+        persona: phase.personaNoun,
+    });
+    let result;
+    try {
+        // FORGE-BUG-040: wrap the runForgeSubagent dispatch in the phase
+        // caller context so downstream tool calls (forge_preflight,
+        // forge_store update-status / set-bug-summary / set-summary / emit)
+        // can verify the caller's phase matches the phase named in the
+        // tool's arguments. This is the single setter of phase context
+        // for the bug pipeline; the audience-test wrap above is a
+        // short-lived test, not the canonical dispatch context.
+        result = await CallerContextStore.asSubagent(phase.role, () => runForgeSubagent({
+            persona,
+            task: bugBody,
+            cwd,
+            exportTag: `${bugId}__${phase.role}`,
+            tailLog: observer.state.tailLog,
+            // Sprint-scoped if the bug is attached to one, else bug-scoped.
+            // Keeps every phase of this bug-fix pipeline in a single cache
+            // namespace so the system-prompt + persona prefix stays warm
+            // across the ~10-minute phases.
+            cacheSessionId: typeof bugRecordBefore?.sprintId === "string"
+                ? `forge:${bugRecordBefore.sprintId}`
+                : `forge:bug:${bugId}`,
+            onEvent: onSubagentEvent,
+            requestedModel: modelResolution.model,
+            modelRegistry: ctx.modelRegistry,
+            signal: opts.signal,
+            customTools: opts.forgeToolDefs ? getSubagentTools(opts.forgeToolDefs, persona.name) : undefined,
+        }));
+    }
+    catch (err) {
+        const e = err;
+        ctx.ui.notify(`× forge:fix-bug — runForgeSubagent threw for phase ${phase.role}: ${e.message ?? "unknown"}`, "error");
+        tree.completeNode(phaseNodeId, "failed");
+        writeBugState(cwd, {
+            bugId,
+            phaseIndex: currentPhaseIndex,
+            iterationCounts,
+            halted: true,
+            lastError: `runForgeSubagent threw: ${e.message ?? "unknown"}`,
+            savedAt: new Date().toISOString(),
+        });
+        return {
+            kind: "return",
+            result: {
+                status: "failed",
+                lastPhaseIndex: currentPhaseIndex,
+                iterationCounts,
+                lastError: `runForgeSubagent threw: ${e.message ?? "unknown"}`,
+            },
+        };
+    }
+    // Close this dispatch's tree node with final usage/model — MUST be
+    // called on every exit path below (failure, halt, escalation,
+    // loopback, advance). A node left `running` keeps a live spinner
+    // in the dashboard forever AND absorbs the next same-role
+    // dispatch's telemetry via the observer's legacy role-prefix scan.
+    const finishPhaseNode = (status) => {
+        tree.setNodeUsage(phaseNodeId, {
+            input: result.usage.input,
+            output: result.usage.output,
+            cacheRead: result.usage.cacheRead,
+        });
+        if (result.model)
+            tree.setNodeModel(phaseNodeId, result.model, result.provider ?? "");
+        tree.completeNode(phaseNodeId, status);
+    };
+    // ── Post-subagent abort detection ─────────────────────────────────
+    if (result.stopReason === "aborted" || opts.signal?.aborted) {
+        ctx.ui.notify(`⊘ forge:fix-bug — ${bugId} phase ${phase.role} cancelled.`, "info");
+        registry.completePhase(bugId, phase.role, "cancelled");
+        tree.completeNode(phaseNodeId, "cancelled");
+        registry.confirmCancelled(bugId);
+        // Bug B parity with run-task: account billed tokens of the aborted attempt.
+        // sprintId "bugs" = routing key for bug events (matches success path).
+        // The optional `type` token is omitted — verdict carries the outcome.
+        emitIncompletePhaseEvent({
+            emitCtx: {
+                entityType: "bug",
+                bugId,
+                sprintId: "bugs",
+                phase,
+                iteration: (iterationCounts[phase.role] ?? 0) + 1,
+                startMs: phaseStart,
+                endMs: Date.now(),
+                model: result.model ?? "unknown",
+                provider: result.provider ?? "unknown",
+                usage: {
+                    input: result.usage.input,
+                    output: result.usage.output,
+                    cacheRead: result.usage.cacheRead,
+                    cacheWrite: result.usage.cacheWrite,
+                },
+                judgement: undefined,
+                storeCli,
+                cwd,
+            },
+            outcome: "aborted",
+            notes: result.errorMessage ?? result.stopReason ?? undefined,
+            onDebug: writeDebug,
+        });
+        // ADR-S21-01: preserve state file so cancelled runs are resumable
+        writeBugState(cwd, {
+            bugId,
+            phaseIndex: currentPhaseIndex,
+            iterationCounts,
+            halted: false,
+            status: "cancelled",
+            lastError: undefined,
+            savedAt: new Date().toISOString(),
+        });
+        return {
+            kind: "return",
+            result: { status: "cancelled", lastPhaseIndex: currentPhaseIndex, iterationCounts },
+        };
+    }
+    // ── Halt-on-failure ───────────────────────────────────────────
+    if (result.exitCode !== 0) {
+        ctx.ui.notify(`× forge:fix-bug — phase ${phase.role} failed (exit ${result.exitCode})` +
+            (result.errorMessage ? `: ${result.errorMessage}` : "") +
+            (result.stopReason ? ` [${result.stopReason}]` : ""), "error");
+        finishPhaseNode("failed");
+        // Bug B parity with run-task: account billed tokens of the failed attempt.
+        emitIncompletePhaseEvent({
+            emitCtx: {
+                entityType: "bug",
+                bugId,
+                sprintId: "bugs",
+                phase,
+                iteration: (iterationCounts[phase.role] ?? 0) + 1,
+                startMs: phaseStart,
+                endMs: Date.now(),
+                model: result.model ?? "unknown",
+                provider: result.provider ?? "unknown",
+                usage: {
+                    input: result.usage.input,
+                    output: result.usage.output,
+                    cacheRead: result.usage.cacheRead,
+                    cacheWrite: result.usage.cacheWrite,
+                },
+                judgement: undefined,
+                storeCli,
+                cwd,
+            },
+            outcome: "failed",
+            notes: result.errorMessage ?? result.stopReason ?? undefined,
+            onDebug: writeDebug,
+        });
+        writeBugState(cwd, {
+            bugId,
+            phaseIndex: currentPhaseIndex,
+            iterationCounts,
+            halted: true,
+            lastError: result.errorMessage ?? result.stopReason ?? "subagent exit non-zero",
+            savedAt: new Date().toISOString(),
+        });
+        return {
+            kind: "return",
+            result: {
+                status: "failed",
+                lastPhaseIndex: currentPhaseIndex,
+                iterationCounts,
+                lastError: result.errorMessage ?? result.stopReason ?? "subagent exit non-zero",
+            },
+        };
+    }
+    return {
+        kind: "ok",
+        result,
+        finishPhaseNode,
+        observer,
+        phaseStart,
+        writeDebug,
+        toolExecutionEvents,
+        debugLogPath,
+        debugLogDisabled,
+    };
+}
+//# sourceMappingURL=bug-phase-dispatch.js.map

package/dist/extensions/forgecli/orchestrators/bug/bug-phase-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bug-phase-dispatch.js","sourceRoot":"","sources":["../../../../../src/extensions/forgecli/orchestrators/bug/bug-phase-dispatch.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,+EAA+E;AAC/E,uEAAuE;AACvE,6EAA6E;AAC7E,oEAAoE;AACpE,gFAAgF;AAChF,6EAA6E;AAC7E,+EAA+E;AAC/E,gFAAgF;AAChF,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAE/E,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAIlC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAuB,MAAM,yBAAyB,CAAC;AAClG,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAwB,MAAM,gBAAgB,CAAC;AACrG,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,MAAM,UAAU,GAAG,eAAe,CAAC;AAwCnC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,CAAyB;IAC/D,MAAM,EACL,IAAI,EACJ,KAAK,EACL,KAAK,EACL,GAAG,EACH,GAAG,EACH,QAAQ,EACR,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,YAAY,GACZ,GAAG,CAAC,CAAC;IAEN,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;IAEnC,iEAAiE;IACjE,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACJ,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,GAA2B,CAAC;QACtC,GAAG,CAAC,EAAE,CAAC,MAAM,CACZ,8BAA8B,KAAK,CAAC,WAAW,yBAAyB,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,IAAI,SAAS,IAAI;YAChH,qDAAqD,EACtD,OAAO,CACP,CAAC;QACF,aAAa,CAAC,GAAG,EAAE;YAClB,KAAK;YACL,UAAU,EAAE,iBAAiB;YAC7B,eAAe;YACf,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,wBAAwB,CAAC,CAAC,OAAO,IAAI,SAAS,EAAE;YAC3D,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACjC,CAAC,CAAC;QACH,OAAO;YACN,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE;gBACP,MAAM,EAAE,QAAQ;gBAChB,cAAc,EAAE,iBAAiB;gBACjC,eAAe;gBACf,SAAS,EAAE,wBAAwB,CAAC,CAAC,OAAO,IAAI,SAAS,EAAE;aAC3D;SACD,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,2DAA2D;IAC3D,sDAAsD;IACtD,MAAM,iBAAiB,GACtB,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,eAAe,EAAE,SAAS,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAClG,IAAI,OAAO,GAAG,cAAc,CAAC,aAAa,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;IAExG,qEAAqE;IACrE,8DAA8D;IAC9D,sEAAsE;IACtE,0DAA0D;IAC1D,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;QACxD,OAAO,GAAG,oBAAoB,WAAW,cAAc,OAAO,EAAE,CAAC;IAClE,CAAC;IAED,iCAAiC;IACjC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE9B,uEAAuE;IACvE,MAAM,mBAAmB,GAAmD,EAAE,CAAC;IAE/E,0BAA0B;IAC1B,iEAAiE;IACjE,2CAA2C;IAC3C,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,GAAG,CAAC;IAC7D,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,IAAI,UAAU,GAA2C,GAAG,EAAE,GAAE,CAAC,CAAC;IAClE,IAAI,CAAC,YAAY,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,KAAK,QAAQ,CAAC,CAAC;QACjF,UAAU,GAAG,CAAC,GAA4B,EAAE,EAAE;YAC7C,IAAI,CAAC;gBACJ,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,YAAa,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC/D,yDAAyD;gBACzD,IAAI,CAAC;oBACJ,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAa,CAAC,CAAC;oBACtC,IAAI,EAAE,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;wBAChC,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAa,EAAE,MAAM,CAAC,CAAC;wBACnD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;wBAC9B,yBAAyB;wBACzB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;wBAC5C,EAAE,CAAC,aAAa,CAAC,YAAa,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;oBACxE,CAAC;gBACF,CAAC;gBAAC,MAAM,CAAC;oBACR,4BAA4B;gBAC7B,CAAC;gBACD,EAAE,CAAC,cAAc,CAChB,YAAa,EACb,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,GAAG,EAAE,CAAC,IAAI,EAClF,MAAM,CACN,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACR,sCAAsC;YACvC,CAAC;QACF,CAAC,CAAC;IACH,CAAC;IACD,UAAU,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACnE,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAE1D,+DAA+D;IAC/D,kEAAkE;IAClE,wBAAwB;IACxB,MAAM,SAAS,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvF,MAAM,WAAW,GAAG,GAAG,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC;IAC1D,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;QAC3B,QAAQ,EAAE,KAAK;QACf,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,SAAS,EAAE;QACnC,IAAI,EAAE,MAAM;QACZ,gEAAgE;QAChE,yCAAyC;QACzC,aAAa,EAAE,OAAO;KACtB,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,GAAG,EAAE;QAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,GAAG;YAAE,OAAO;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,CACjB,UAAU,EACV,WAAW,KAAK,KAAK,KAAK,CAAC,IAAI,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,YAAY,QAAQ,CAAC,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,OAAO,IAAI,IAAI,EAAE,CACzL,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,sBAAsB,CAAC;QACvC,QAAQ;QACR,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,aAAa,KAAK,CAAC,IAAI,YAAY;QAChD,UAAU;QACV,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC;QACjD,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QACpG,WAAW,EAAE,EAAE,UAAU,EAAE,GAAG,UAAU,UAAU,EAAE;QACpD,SAAS,EAAE,aAAa;KACxB,CAAC,CAAC;IAEH,wEAAwE;IACxE,0EAA0E;IAC1E,0DAA0D;IAC1D,IAAI,mBAAmB,GAAG,KAAK,CAAC;IAChC,MAAM,eAAe,GAAG,CAAC,KAAU,EAAE,EAAE;QACtC,IAAI,KAAK,EAAE,IAAI,KAAK,oBAAoB,EAAE,CAAC;YAC1C,mBAAmB,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,CAAC,mBAAmB,IAAI,KAAK,EAAE,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;YAChF,mBAAmB,GAAG,IAAI,CAAC;YAC3B,UAAU,CAAC;gBACV,IAAI,EAAE,gBAAgB;gBACtB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI;gBACxC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK;aAC1B,CAAC,CAAC;QACJ,CAAC;QACD,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,uEAAuE;IACvE,wEAAwE;IACxE,sEAAsE;IACtE,qEAAqE;IACrE,MAAM,eAAe,GAAG,oBAAoB,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;IAC3G,UAAU,CAAC;QACV,IAAI,EAAE,iBAAiB;QACvB,SAAS,EAAE,eAAe,CAAC,KAAK,IAAI,IAAI;QACxC,MAAM,EAAE,eAAe,CAAC,MAAM;QAC9B,OAAO,EAAE,KAAK,CAAC,WAAW;KAC1B,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACJ,iEAAiE;QACjE,4DAA4D;QAC5D,oEAAoE;QACpE,+DAA+D;QAC/D,+DAA+D;QAC/D,0DAA0D;QAC1D,wDAAwD;QACxD,MAAM,GAAG,MAAM,kBAAkB,CAAC,UAAU,CAAC,KAAK,CAAC,IAAiB,EAAE,GAAG,EAAE,CAC1E,gBAAgB,CAAC;YAChB,OAAO;YACP,IAAI,EAAE,OAAO;YACb,GAAG;YACH,SAAS,EAAE,GAAG,KAAK,KAAK,KAAK,CAAC,IAAI,EAAE;YACpC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO;YAC/B,gEAAgE;YAChE,+DAA+D;YAC/D,6DAA6D;YAC7D,gCAAgC;YAChC,cAAc,EACb,OAAO,eAAe,EAAE,QAAQ,KAAK,QAAQ;gBAC5C,CAAC,CAAC,SAAS,eAAe,CAAC,QAAQ,EAAE;gBACrC,CAAC,CAAC,aAAa,KAAK,EAAE;YACxB,OAAO,EAAE,eAAe;YACxB,cAAc,EAAE,eAAe,CAAC,KAAK;YACrC,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAChG,CAAC,CACF,CAAC;IACH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,GAA2B,CAAC;QACtC,GAAG,CAAC,EAAE,CAAC,MAAM,CACZ,sDAAsD,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,IAAI,SAAS,EAAE,EAC7F,OAAO,CACP,CAAC;QACF,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACzC,aAAa,CAAC,GAAG,EAAE;YAClB,KAAK;YACL,UAAU,EAAE,iBAAiB;YAC7B,eAAe;YACf,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,2BAA2B,CAAC,CAAC,OAAO,IAAI,SAAS,EAAE;YAC9D,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACjC,CAAC,CAAC;QACH,OAAO;YACN,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE;gBACP,MAAM,EAAE,QAAQ;gBAChB,cAAc,EAAE,iBAAiB;gBACjC,eAAe;gBACf,SAAS,EAAE,2BAA2B,CAAC,CAAC,OAAO,IAAI,SAAS,EAAE;aAC9D;SACD,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,8DAA8D;IAC9D,iEAAiE;IACjE,0DAA0D;IAC1D,mEAAmE;IACnE,MAAM,eAAe,GAAG,CAAC,MAA4C,EAAQ,EAAE;QAC9E,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE;YAC9B,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK;YACzB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;YAC3B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS;SACjC,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,KAAK;YAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QACtF,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC,CAAC;IAEF,qEAAqE;IACrE,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAC7D,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,qBAAqB,KAAK,UAAU,KAAK,CAAC,IAAI,aAAa,EAAE,MAAM,CAAC,CAAC;QACnF,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACvD,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC5C,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACjC,4EAA4E;QAC5E,uEAAuE;QACvE,sEAAsE;QACtE,wBAAwB,CAAC;YACxB,OAAO,EAAE;gBACR,UAAU,EAAE,KAAK;gBACjB,KAAK;gBACL,QAAQ,EAAE,MAAM;gBAChB,KAAK;gBACL,SAAS,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC;gBACjD,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE;gBACjB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS;gBAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,SAAS;gBACtC,KAAK,EAAE;oBACN,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK;oBACzB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;oBAC3B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS;oBACjC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU;iBACnC;gBACD,SAAS,EAAE,SAAS;gBACpB,QAAQ;gBACR,GAAG;aACH;YACD,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,IAAI,SAAS;YAC5D,OAAO,EAAE,UAAU;SACnB,CAAC,CAAC;QACH,kEAAkE;QAClE,aAAa,CAAC,GAAG,EAAE;YAClB,KAAK;YACL,UAAU,EAAE,iBAAiB;YAC7B,eAAe;YACf,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,WAAW;YACnB,SAAS,EAAE,SAAS;YACpB,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACjC,CAAC,CAAC;QACH,OAAO;YACN,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE;SACnF,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,EAAE,CAAC,MAAM,CACZ,2BAA2B,KAAK,CAAC,IAAI,iBAAiB,MAAM,CAAC,QAAQ,GAAG;YACvE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EACrD,OAAO,CACP,CAAC;QACF,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC1B,2EAA2E;QAC3E,wBAAwB,CAAC;YACxB,OAAO,EAAE;gBACR,UAAU,EAAE,KAAK;gBACjB,KAAK;gBACL,QAAQ,EAAE,MAAM;gBAChB,KAAK;gBACL,SAAS,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC;gBACjD,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE;gBACjB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS;gBAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,SAAS;gBACtC,KAAK,EAAE;oBACN,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK;oBACzB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;oBAC3B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS;oBACjC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU;iBACnC;gBACD,SAAS,EAAE,SAAS;gBACpB,QAAQ;gBACR,GAAG;aACH;YACD,OAAO,EAAE,QAAQ;YACjB,KAAK,EAAE,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,IAAI,SAAS;YAC5D,OAAO,EAAE,UAAU;SACnB,CAAC,CAAC;QACH,aAAa,CAAC,GAAG,EAAE;YAClB,KAAK;YACL,UAAU,EAAE,iBAAiB;YAC7B,eAAe;YACf,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,IAAI,wBAAwB;YAC/E,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACjC,CAAC,CAAC;QACH,OAAO;YACN,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE;gBACP,MAAM,EAAE,QAAQ;gBAChB,cAAc,EAAE,iBAAiB;gBACjC,eAAe;gBACf,SAAS,EAAE,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,IAAI,wBAAwB;aAC/E;SACD,CAAC;IACH,CAAC;IAED,OAAO;QACN,IAAI,EAAE,IAAI;QACV,MAAM;QACN,eAAe;QACf,QAAQ;QACR,UAAU;QACV,UAAU;QACV,mBAAmB;QACnB,YAAY;QACZ,gBAAgB;KAChB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { PhaseDescriptor } from "../task/task-phases.js";
+export declare const BUG_PHASES: PhaseDescriptor[];
+export declare const BUG_TYPE_TOKENS: Record<string, {
+    pass: string;
+    fail: string;
+}>;
+export declare const BUG_TERMINAL_STATES: Set<string>;
+export declare function postTriageTransitions(status: string | undefined): string[];

package/dist/extensions/forgecli/orchestrators/bug/bug-phases.js

@@ -0,0 +1,60 @@
+// bug-phases.ts — bug phase descriptor table, bug-event type tokens, terminal
+// states, and the orchestrator-owned post-triage status transitions. Extracted
+// VERBATIM from fix-bug.ts (FORGE-S31 file-size refactor); no logic changes.
+// ── Bug phase descriptor table ──────────────────────────────────────────────
+//
+// Decoded from .forge/workflows/fix_bug.md and the task prompt's BUG_PHASES.
+// triage / plan-fix / implement all read the same fix_bug.md body — the
+// workflow handles all three phases through prose.
+// FORGE-S25-T16: readPersonaDirBug / readPipelineNamesBug extracted to
+// lib/catalog-helpers.ts and imported above with aliases (H-4, N-H-G).
+export const BUG_PHASES = [
+    // FORGE-BUG-040: each phase points at its own phase-scoped subagent workflow.
+    // Previously triage/plan-fix/implement all pointed at fix_bug.md (the
+    // orchestrator-only body), which caused the triage subagent to execute
+    // the full lifecycle in a single invocation. plan-fix and implement reuse
+    // plan_task.md / implement_plan.md (bug-mode) per meta-fix-bug.md
+    // § Pipeline Phases — the bug-mode entity-kind detection is built into
+    // those workflows already.
+    { role: "triage", workflowFile: "triage", personaNoun: "bug-fixer", isReview: false, maxIterations: 1 },
+    { role: "plan-fix", workflowFile: "plan_task", personaNoun: "engineer", isReview: false, maxIterations: 1 },
+    { role: "review-plan", workflowFile: "review_plan", personaNoun: "supervisor", isReview: true, maxIterations: 3 },
+    { role: "implement", workflowFile: "implement_plan", personaNoun: "engineer", isReview: false, maxIterations: 1 },
+    { role: "review-code", workflowFile: "review_code", personaNoun: "supervisor", isReview: true, maxIterations: 3 },
+    { role: "approve", workflowFile: "architect_approve", personaNoun: "architect", isReview: true, maxIterations: 3 },
+    { role: "commit", workflowFile: "commit_task", personaNoun: "engineer", isReview: false, maxIterations: 1 },
+];
+// ── Bug-event type tokens ──────────────────────────────────────────────────
+// Explicit mapping per review finding #3. Non-review phases always emit the
+// pass token. Review phases select pass or fail based on ec.judgement.verdict.
+// The event-vocabulary contract test scans this literal block here.
+export const BUG_TYPE_TOKENS = {
+    triage: { pass: "bug-triaged", fail: "bug-triaged" },
+    "plan-fix": { pass: "fix-planned", fail: "fix-planned" },
+    "review-plan": { pass: "fix-review-passed", fail: "fix-review-failed" },
+    implement: { pass: "fix-implemented", fail: "fix-implemented" },
+    "review-code": { pass: "fix-code-review-passed", fail: "fix-code-review-failed" },
+    approve: { pass: "fix-approved", fail: "fix-revision-requested" },
+    commit: { pass: "bug-committed", fail: "bug-commit-failed" },
+};
+// ── Bug FSM transitions ────────────────────────────────────────────────────
+// Mirrors store-cli BUG_TRANSITIONS. Terminal: `fixed`.
+// `approved` and `verified` enum values were dropped in forge v0.44.0
+// (FORGE-BUG-002 trap). The canonical source is store-cli.cjs.
+export const BUG_TERMINAL_STATES = new Set(["fixed"]);
+// Post-triage status transitions the ORCHESTRATOR owns (meta-fix-bug.md
+// step 2: "On return, orchestrator transitions status: triaged then
+// in-progress" — a required two-step state-machine contract; the FSM
+// forbids the one-step reported → in-progress jump). First live firing of
+// commit-task.cjs exposed this as unimplemented: bugs reached the commit
+// phase still 'reported' and the terminal-status guard fired every run.
+// Returns the ordered list of statuses to write from the given status —
+// idempotent on resume (already in-progress / terminal → no-op).
+export function postTriageTransitions(status) {
+    if (status === "reported")
+        return ["triaged", "in-progress"];
+    if (status === "triaged")
+        return ["in-progress"];
+    return [];
+}
+//# sourceMappingURL=bug-phases.js.map