@entelligentsia/forgecli 1.0.21 → 1.0.36

package/dist/extensions/forgecli/orchestrators/task/task-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-body.js","sourceRoot":"","sources":["../../../../../src/extensions/forgecli/orchestrators/task/task-body.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,yEAAyE;AACzE,0CAA0C;AAI1C,6EAA6E;AAE7E,MAAM,UAAU,oBAAoB,CAAC,MAAyB,EAAE,WAAmB;IAClF,KAAK,IAAI,CAAC,GAAG,WAAW,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ;YAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,CAAC,CAAC;AACV,CAAC;AAYD,+DAA+D;AAC/D,MAAM,WAAW,GAAsB,CAAC,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;AAE9G,MAAM,UAAU,mBAAmB,CAAC,SAA8C;IACjF,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,SAAS;QAC9C,MAAM,CAAC,GAAG,GAAmB,CAAC;QAC9B,MAAM,KAAK,GAAa,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,CAAC,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,CAAC,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC,WAAW,EAAE,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,CAAC,YAAY;YAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,OAAO,CAAC,0CAA0C,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,aAAqB,EAAE,MAAc,EAAE,cAAuB;IAC7F,MAAM,KAAK,GAAG,CAAC,mDAAmD,MAAM,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAC5F,IAAI,cAAc,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/extensions/forgecli/orchestrators/task/task-events.d.ts

@@ -0,0 +1,63 @@
+import { type PhaseDescriptor } from "./task-phases.js";
+import type { TaskRecord } from "./task-record.js";
+export declare function actionForRole(role: string): string;
+export interface OrchestratorEmitContext {
+    /** Entity identifier — required when entityType is "task". */
+    taskId?: string;
+    /** Entity identifier — required when entityType is "bug". */
+    bugId?: string;
+    /** Discriminator for entity-keyed event construction. */
+    entityType: "task" | "bug";
+    sprintId: string;
+    phase: PhaseDescriptor;
+    iteration: number;
+    startMs: number;
+    endMs: number;
+    model: string;
+    provider: string;
+    usage: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+    judgement: Record<string, unknown> | undefined;
+    storeCli: string;
+    cwd: string;
+}
+export declare function isoCompact(ms: number): string;
+export declare function buildPhaseEvent(ec: OrchestratorEmitContext): Record<string, unknown>;
+export declare function emitEvent(storeCli: string, cwd: string, sprintId: string, event: Record<string, unknown>): {
+    ok: boolean;
+    stderr: string;
+};
+/**
+ * Emit a phase event for an INCOMPLETE attempt (cancelled / failed) so its
+ * provider-billed tokens reach the store. Bug B: the cancel and halt-on-failure
+ * branches used to return without emitting, so collate's COST_REPORT
+ * under-counted real spend by exactly the aborted passes (CART-S02-T03
+ * baseline: 259,950 tokens across two aborted plan attempts, invisible).
+ *
+ * The event is the canonical phase event (schema-unchanged) with
+ * `verdict: "aborted" | "failed"` marking the outcome.
+ *
+ * Zero-token attempts are skipped — there is no spend to account, and a
+ * token-less event would be flagged as a husk by collate's ingestion-quality
+ * pass. Never throws: emission must not perturb the cancel/halt return paths.
+ *
+ * @param opts.decorate  Optional event mutation hook applied before emit
+ *                       (fix-bug uses it for the BUG_TYPE_TOKENS `type` field).
+ * @returns true when the event was emitted and store-cli accepted it.
+ */
+export declare function emitIncompletePhaseEvent(opts: {
+    emitCtx: OrchestratorEmitContext;
+    outcome: "aborted" | "failed";
+    notes?: string;
+    decorate?: (event: Record<string, unknown>) => void;
+    onDebug?: (rec: Record<string, unknown>) => void;
+}): boolean;
+export declare function judgementFromSummary(record: TaskRecord | null, phaseRole: string, summaryKeyByRole?: Record<string, string | null>): Record<string, unknown> | undefined;
+export declare function drainFrictionFile(frictionPath: string, ec: OrchestratorEmitContext): {
+    emitted: number;
+    failed: number;
+};

package/dist/extensions/forgecli/orchestrators/task/task-events.js

@@ -0,0 +1,185 @@
+// task-events.ts — orchestrator event composition + emission helpers.
+// Extracted from run-task.ts (no logic changes). run-task.ts re-exports these.
+import * as fs from "node:fs";
+import { spawnSync } from "node:child_process";
+import { SUMMARY_KEY_BY_ROLE } from "./task-phases.js";
+// Map phase.role → action token used in event.action / eventId.
+export function actionForRole(role) {
+    return role.replace(/-/g, "_");
+}
+export function isoCompact(ms) {
+    return new Date(ms)
+        .toISOString()
+        .replace(/[-:]/g, "")
+        .replace(/\.\d{3}Z$/, "Z");
+}
+export function buildPhaseEvent(ec) {
+    const action = actionForRole(ec.phase.role);
+    const entityId = ec.entityType === "bug" ? ec.bugId : ec.taskId;
+    const eventId = `${isoCompact(ec.startMs)}_${entityId}_${ec.phase.personaNoun}_${action}`;
+    const durationMs = Math.max(0, ec.endMs - ec.startMs);
+    const event = {
+        eventId,
+        sprintId: ec.sprintId,
+        role: ec.phase.role,
+        action: `/forge:${action.replace(/_/g, "-")}`,
+        phase: ec.phase.role,
+        iteration: ec.iteration,
+        startTimestamp: new Date(ec.startMs).toISOString(),
+        endTimestamp: new Date(ec.endMs).toISOString(),
+        durationMinutes: Math.round((durationMs / 60000) * 100) / 100,
+        model: ec.model,
+        provider: ec.provider,
+    };
+    if (ec.entityType === "bug") {
+        event.bugId = ec.bugId;
+    }
+    else {
+        event.taskId = ec.taskId;
+    }
+    if (ec.usage.input > 0 || ec.usage.output > 0 || ec.usage.cacheRead > 0 || ec.usage.cacheWrite > 0) {
+        event.inputTokens = ec.usage.input;
+        event.outputTokens = ec.usage.output;
+        event.cacheReadTokens = ec.usage.cacheRead;
+        event.cacheWriteTokens = ec.usage.cacheWrite;
+        event.tokenSource = "reported";
+    }
+    if (ec.judgement && typeof ec.judgement === "object") {
+        const j = ec.judgement;
+        if (typeof j.verdict === "string")
+            event.verdict = j.verdict;
+        if (typeof j.notes === "string")
+            event.notes = j.notes;
+    }
+    return event;
+}
+export function emitEvent(storeCli, cwd, sprintId, event) {
+    const result = spawnSync("node", [storeCli, "emit", sprintId, JSON.stringify(event)], {
+        cwd,
+        encoding: "utf8",
+    });
+    return { ok: result.status === 0, stderr: typeof result.stderr === "string" ? result.stderr : "" };
+}
+/**
+ * Emit a phase event for an INCOMPLETE attempt (cancelled / failed) so its
+ * provider-billed tokens reach the store. Bug B: the cancel and halt-on-failure
+ * branches used to return without emitting, so collate's COST_REPORT
+ * under-counted real spend by exactly the aborted passes (CART-S02-T03
+ * baseline: 259,950 tokens across two aborted plan attempts, invisible).
+ *
+ * The event is the canonical phase event (schema-unchanged) with
+ * `verdict: "aborted" | "failed"` marking the outcome.
+ *
+ * Zero-token attempts are skipped — there is no spend to account, and a
+ * token-less event would be flagged as a husk by collate's ingestion-quality
+ * pass. Never throws: emission must not perturb the cancel/halt return paths.
+ *
+ * @param opts.decorate  Optional event mutation hook applied before emit
+ *                       (fix-bug uses it for the BUG_TYPE_TOKENS `type` field).
+ * @returns true when the event was emitted and store-cli accepted it.
+ */
+export function emitIncompletePhaseEvent(opts) {
+    try {
+        const { emitCtx, outcome } = opts;
+        const u = emitCtx.usage;
+        if (u.input + u.output + u.cacheRead + u.cacheWrite <= 0) {
+            opts.onDebug?.({ kind: "incomplete_emit_skipped", reason: "no-tokens", outcome });
+            return false;
+        }
+        const judgement = { verdict: outcome };
+        if (opts.notes)
+            judgement.notes = opts.notes;
+        const event = buildPhaseEvent({ ...emitCtx, judgement });
+        opts.decorate?.(event);
+        const res = emitEvent(emitCtx.storeCli, emitCtx.cwd, emitCtx.sprintId, event);
+        opts.onDebug?.(res.ok
+            ? { kind: "incomplete_emit_ok", eventId: event.eventId, outcome }
+            : { kind: "incomplete_emit_failed", stderr: res.stderr, outcome });
+        return res.ok;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        opts.onDebug?.({ kind: "incomplete_emit_failed", stderr: msg, outcome: opts.outcome });
+        return false;
+    }
+}
+export function judgementFromSummary(record, phaseRole, summaryKeyByRole) {
+    if (!record || !record.summaries)
+        return undefined;
+    const keyMap = summaryKeyByRole ?? SUMMARY_KEY_BY_ROLE;
+    const summaryKey = keyMap[phaseRole];
+    if (!summaryKey)
+        return undefined;
+    const blob = record.summaries[summaryKey];
+    return blob && typeof blob === "object" ? blob : undefined;
+}
+// Drain .forge/cache/FRICTION-{phase}.jsonl: stamp each judgement-only record
+// with the subagent's runtime attribution and emit as event type "friction".
+// Truncate only after all emits succeed (Plan-11 open-question A.3).
+export function drainFrictionFile(frictionPath, ec) {
+    if (!fs.existsSync(frictionPath))
+        return { emitted: 0, failed: 0 };
+    const raw = fs.readFileSync(frictionPath, "utf8");
+    const lines = raw.split("\n").filter((l) => l.trim().length > 0);
+    if (lines.length === 0)
+        return { emitted: 0, failed: 0 };
+    let emitted = 0;
+    let failed = 0;
+    for (let i = 0; i < lines.length; i++) {
+        let judgement;
+        try {
+            judgement = JSON.parse(lines[i]);
+        }
+        catch {
+            failed++;
+            continue;
+        }
+        const action = actionForRole(ec.phase.role);
+        const entityId = ec.entityType === "bug" ? ec.bugId : ec.taskId;
+        const eventId = `${isoCompact(ec.startMs)}_${entityId}_${ec.phase.personaNoun}_friction_${i}`;
+        const event = {
+            eventId,
+            sprintId: ec.sprintId,
+            role: ec.phase.role,
+            action: `/forge:${action.replace(/_/g, "-")}`,
+            phase: ec.phase.role,
+            iteration: ec.iteration,
+            startTimestamp: new Date(ec.startMs).toISOString(),
+            endTimestamp: new Date(ec.endMs).toISOString(),
+            durationMinutes: Math.round(((ec.endMs - ec.startMs) / 60000) * 100) / 100,
+            model: ec.model,
+            provider: ec.provider,
+            type: "friction",
+            workflow: typeof judgement.workflow === "string" ? judgement.workflow : ec.phase.role,
+            persona: typeof judgement.persona === "string" ? judgement.persona : ec.phase.personaNoun,
+            issue: judgement.issue,
+        };
+        if (ec.entityType === "bug") {
+            event.bugId = ec.bugId;
+        }
+        else {
+            event.taskId = ec.taskId;
+        }
+        if (judgement.subkind !== undefined)
+            event.subkind = judgement.subkind;
+        if (judgement.evidence !== undefined)
+            event.evidence = judgement.evidence;
+        if (judgement.notes !== undefined)
+            event.notes = judgement.notes;
+        const r = emitEvent(ec.storeCli, ec.cwd, ec.sprintId, event);
+        if (r.ok)
+            emitted++;
+        else
+            failed++;
+    }
+    if (failed === 0) {
+        try {
+            fs.unlinkSync(frictionPath);
+        }
+        catch {
+            /* non-fatal */
+        }
+    }
+    return { emitted, failed };
+}
+//# sourceMappingURL=task-events.js.map

package/dist/extensions/forgecli/orchestrators/task/task-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-events.js","sourceRoot":"","sources":["../../../../../src/extensions/forgecli/orchestrators/task/task-events.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,+EAA+E;AAE/E,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAwB,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG7E,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAChC,CAAC;AA2BD,MAAM,UAAU,UAAU,CAAC,EAAU;IACpC,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC;SACjB,WAAW,EAAE;SACb,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAA2B;IAC1D,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAO,CAAC;IAClE,MAAM,OAAO,GAAG,GAAG,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,QAAQ,IAAI,EAAE,CAAC,KAAK,CAAC,WAAW,IAAI,MAAM,EAAE,CAAC;IAC1F,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,KAAK,GAA4B;QACtC,OAAO;QACP,QAAQ,EAAE,EAAE,CAAC,QAAQ;QACrB,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI;QACnB,MAAM,EAAE,UAAU,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE;QAC7C,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI;QACpB,SAAS,EAAE,EAAE,CAAC,SAAS;QACvB,cAAc,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE;QAClD,YAAY,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE;QAC9C,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;QAC7D,KAAK,EAAE,EAAE,CAAC,KAAK;QACf,QAAQ,EAAE,EAAE,CAAC,QAAQ;KACrB,CAAC;IACF,IAAI,EAAE,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;QAC7B,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC;IACxB,CAAC;SAAM,CAAC;QACP,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;IAC1B,CAAC;IACD,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QACpG,KAAK,CAAC,WAAW,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;QACnC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;QACrC,KAAK,CAAC,eAAe,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;QAC3C,KAAK,CAAC,gBAAgB,GAAG,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;QAC7C,KAAK,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IACD,IAAI,EAAE,CAAC,SAAS,IAAI,OAAO,EAAE,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACtD,MAAM,CAAC,GAAG,EAAE,CAAC,SAAoC,CAAC;QAClD,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;YAAE,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;QAC7D,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;YAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IACxD,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,MAAM,UAAU,SAAS,CACxB,QAAgB,EAChB,GAAW,EACX,QAAgB,EAChB,KAA8B;IAE9B,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE;QACrF,GAAG;QACH,QAAQ,EAAE,MAAM;KAChB,CAAC,CAAC;IACH,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACpG,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAMxC;IACA,IAAI,CAAC;QACJ,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAClC,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;YAC1D,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;YAClF,OAAO,KAAK,CAAC;QACd,CAAC;QACD,MAAM,SAAS,GAA4B,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAChE,IAAI,IAAI,CAAC,KAAK;YAAE,SAAS,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAC7C,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;QACvB,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC9E,IAAI,CAAC,OAAO,EAAE,CACb,GAAG,CAAC,EAAE;YACL,CAAC,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE;YACjE,CAAC,CAAC,EAAE,IAAI,EAAE,wBAAwB,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAClE,CAAC;QACF,OAAO,GAAG,CAAC,EAAE,CAAC;IACf,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,wBAAwB,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACvF,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAED,MAAM,UAAU,oBAAoB,CACnC,MAAyB,EACzB,SAAiB,EACjB,gBAAgD;IAEhD,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACnD,MAAM,MAAM,GAAG,gBAAgB,IAAI,mBAAmB,CAAC;IACvD,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IACrC,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,MAAM,IAAI,GAAI,MAAM,CAAC,SAAqC,CAAC,UAAU,CAAC,CAAC;IACvE,OAAO,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAgC,CAAC,CAAC,CAAC,SAAS,CAAC;AACzF,CAAC;AAED,8EAA8E;AAC9E,6EAA6E;AAC7E,qEAAqE;AACrE,MAAM,UAAU,iBAAiB,CAChC,YAAoB,EACpB,EAA2B;IAE3B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACnE,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAEzD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,SAAkC,CAAC;QACvC,IAAI,CAAC;YACJ,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAA4B,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACR,MAAM,EAAE,CAAC;YACT,SAAS;QACV,CAAC;QACD,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAO,CAAC;QAClE,MAAM,OAAO,GAAG,GAAG,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,QAAQ,IAAI,EAAE,CAAC,KAAK,CAAC,WAAW,aAAa,CAAC,EAAE,CAAC;QAC9F,MAAM,KAAK,GAA4B;YACtC,OAAO;YACP,QAAQ,EAAE,EAAE,CAAC,QAAQ;YACrB,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI;YACnB,MAAM,EAAE,UAAU,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE;YAC7C,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI;YACpB,SAAS,EAAE,EAAE,CAAC,SAAS;YACvB,cAAc,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE;YAClD,YAAY,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE;YAC9C,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;YAC1E,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,QAAQ,EAAE,EAAE,CAAC,QAAQ;YACrB,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI;YACrF,OAAO,EAAE,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW;YACzF,KAAK,EAAE,SAAS,CAAC,KAAK;SACtB,CAAC;QACF,IAAI,EAAE,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;YAC7B,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC;QACxB,CAAC;aAAM,CAAC;YACP,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;QAC1B,CAAC;QACD,IAAI,SAAS,CAAC,OAAO,KAAK,SAAS;YAAE,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;QACvE,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS;YAAE,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;QAC1E,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;QACjE,MAAM,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC7D,IAAI,CAAC,CAAC,EAAE;YAAE,OAAO,EAAE,CAAC;;YACf,MAAM,EAAE,CAAC;IACf,CAAC;IAED,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;QAClB,IAAI,CAAC;YACJ,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACR,eAAe;QAChB,CAAC;IACF,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC"}

package/dist/extensions/forgecli/orchestrators/task/task-gates.d.ts

@@ -0,0 +1,34 @@
+export type PreflightResult = "proceed" | "halt" | "escalate";
+/** Structured gate failure shape emitted by preflight-gate.cjs on stdout (exit 1). */
+export interface GateFailureData {
+    phase: string;
+    reasonCode: string;
+    detail: string;
+    remediation: string;
+}
+/** Extended result carrying the structured failure alongside the status enum. */
+export interface PreflightOutcome {
+    result: PreflightResult;
+    /** Parsed structured failure from stdout, or null on pass / escalate. */
+    gateFailure: GateFailureData | null;
+}
+export declare function runPreflightGate(preflightGate: string, role: string, taskId: string, cwd: string, entityType?: "task" | "bug"): PreflightResult;
+/**
+ * Run postflight-gate.cjs after a phase subagent returns, before FSM advance.
+ * Mirrors runPreflightGateWithData — same argv-array discipline, same structured-JSON
+ * parsing from stdout on exit 1.
+ *
+ * Returns:
+ *   "ok"          — gate passed (or no outputs block for this phase); advance may proceed.
+ *   "unsatisfied" — gate failed; do NOT advance FSM; halt and call runHaltAdvisor.
+ *   "error"       — gate binary missing or parse error; treat as pass-through (additive).
+ */
+export declare function runPostflightGate(postflightGate: string, role: string, taskId: string, cwd: string): {
+    result: "ok" | "unsatisfied" | "error";
+    gateFailure: GateFailureData | null;
+};
+/**
+ * Upgraded variant that returns structured failure data alongside the status enum.
+ * Callers that need the advisory data should use this function directly.
+ */
+export declare function runPreflightGateWithData(preflightGate: string, role: string, taskId: string, cwd: string, entityType?: "task" | "bug"): PreflightOutcome;

package/dist/extensions/forgecli/orchestrators/task/task-gates.js

@@ -0,0 +1,78 @@
+// task-gates.ts — preflight / postflight gate execution helpers.
+// Extracted from run-task.ts (no logic changes). run-task.ts re-exports these.
+import * as fs from "node:fs";
+import { spawnSync } from "node:child_process";
+export function runPreflightGate(preflightGate, role, taskId, cwd, entityType) {
+    const outcome = runPreflightGateWithData(preflightGate, role, taskId, cwd, entityType);
+    return outcome.result;
+}
+/**
+ * Run postflight-gate.cjs after a phase subagent returns, before FSM advance.
+ * Mirrors runPreflightGateWithData — same argv-array discipline, same structured-JSON
+ * parsing from stdout on exit 1.
+ *
+ * Returns:
+ *   "ok"          — gate passed (or no outputs block for this phase); advance may proceed.
+ *   "unsatisfied" — gate failed; do NOT advance FSM; halt and call runHaltAdvisor.
+ *   "error"       — gate binary missing or parse error; treat as pass-through (additive).
+ */
+export function runPostflightGate(postflightGate, role, taskId, cwd) {
+    if (!fs.existsSync(postflightGate)) {
+        // postflight-gate.cjs not present in this forgeRoot — pass through (additive).
+        return { result: "ok", gateFailure: null };
+    }
+    const spawnResult = spawnSync("node", [postflightGate, "--phase", role, "--task", taskId], {
+        cwd,
+        encoding: "utf8",
+    });
+    if (spawnResult.status === 0)
+        return { result: "ok", gateFailure: null };
+    if (spawnResult.status === 2)
+        return { result: "error", gateFailure: null };
+    // Exit 1: parse structured JSON from stdout
+    let gateFailure = null;
+    try {
+        const stdout = typeof spawnResult.stdout === "string" ? spawnResult.stdout.trim() : "";
+        if (stdout) {
+            const parsed = JSON.parse(stdout);
+            if (parsed && typeof parsed.reasonCode === "string") {
+                gateFailure = parsed;
+            }
+        }
+    }
+    catch {
+        // stdout not valid JSON — gate failure but no structured data
+    }
+    return { result: "unsatisfied", gateFailure };
+}
+/**
+ * Upgraded variant that returns structured failure data alongside the status enum.
+ * Callers that need the advisory data should use this function directly.
+ */
+export function runPreflightGateWithData(preflightGate, role, taskId, cwd, entityType) {
+    const entityFlag = entityType === "bug" ? "--bug" : "--task";
+    const spawnResult = spawnSync("node", [preflightGate, "--phase", role, entityFlag, taskId], {
+        cwd,
+        encoding: "utf8",
+    });
+    if (spawnResult.status === 0)
+        return { result: "proceed", gateFailure: null };
+    if (spawnResult.status === 2)
+        return { result: "escalate", gateFailure: null };
+    // Exit 1: parse structured JSON from stdout
+    let gateFailure = null;
+    try {
+        const stdout = typeof spawnResult.stdout === "string" ? spawnResult.stdout.trim() : "";
+        if (stdout) {
+            const parsed = JSON.parse(stdout);
+            if (parsed && typeof parsed.reasonCode === "string") {
+                gateFailure = parsed;
+            }
+        }
+    }
+    catch {
+        // stdout not valid JSON — gate failure but no structured data
+    }
+    return { result: "halt", gateFailure };
+}
+//# sourceMappingURL=task-gates.js.map

package/dist/extensions/forgecli/orchestrators/task/task-gates.js.map

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

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

@@ -0,0 +1,42 @@
+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 "./task-phases.js";
+import { type TaskRecord } from "./task-record.js";
+import type { RunTaskPipelineOptions, RunTaskPipelineResult } from "./run-task-types.js";
+export interface PhaseDispatchParams {
+    opts: RunTaskPipelineOptions;
+    phase: PhaseDescriptor;
+    taskId: string;
+    cwd: string;
+    ctx: ExtensionCommandContext;
+    storeCli: string;
+    currentPhaseIndex: number;
+    iterationCounts: Record<string, number>;
+    dispatchCounts: Record<string, number>;
+    modelRoutingConfig: MergedConfig;
+    registry: RunTaskPipelineOptions["registry"];
+    cacheSessionId: string;
+    taskRecordAtStart: TaskRecord | null;
+    /** Raw sub-workflow markdown already loaded + marker-checked by the caller. */
+    subWorkflowMd: string;
+}
+export type PhaseDispatchOutcome = {
+    kind: "return";
+    result: RunTaskPipelineResult;
+} | {
+    kind: "ok";
+    result: SubagentResult;
+    finishPhaseNode: (status: "completed" | "failed" | "escalated") => void;
+    observer: ReturnType<typeof attachViewportObserver>;
+    phaseStart: number;
+    writeDebug: (rec: Record<string, unknown>) => void;
+};
+/**
+ * Run a single 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 verdict/postflight handling and advance.
+ */
+export declare function dispatchPhase(p: PhaseDispatchParams): Promise<PhaseDispatchOutcome>;