@entelligentsia/forgecli 1.0.25 → 1.0.40

package/dist/extensions/forgecli/orchestrators/common/orchestrator-entry.js

@@ -0,0 +1,85 @@
+// orchestrator-entry.ts — shared "common concerns" for orchestrator entry.
+//
+// Three helpers used by all three orchestrator handlers:
+//   - gatherModelValidationInputs: the byte-identical persona/pipeline/model
+//     catalogue snippet (run-task, fix-bug, run-sprint).
+//   - resolveOrchestratorEntry: discover the Forge config, fail-and-clear-status
+//     when absent, sweep orphaned transcripts, return resolved tool paths.
+//   - runPipelinePreflight: layered-config schema check + full model-config
+//     validation (used by run-task and fix-bug; run-sprint keeps its own inline
+//     sprint-entry validation per the N-H-D boundary).
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadLayeredConfig } from "../../config/config-layer.js";
+import { readPersonaDir, readPipelineNames } from "../../lib/catalog-helpers.js";
+import { discoverForgeConfigCached } from "../../lib/forge-config.js";
+import { sweepProjectTranscripts } from "../../transcript-archive.js";
+import { runOrchestratorPreflight } from "../orchestrator-preflight.js";
+/** Gather the model-validation inputs shared by every orchestrator entry: the
+ *  bundled persona catalogue, the project pipeline names, and the session model
+ *  registry. The persona dir is resolved relative to this module's dist
+ *  location (orchestrators/common → four levels up to dist/forge-payload). */
+export function gatherModelValidationInputs(cwd, ctx) {
+    const personasDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "..", "..", "forge-payload", ".base-pack", "personas");
+    const personaCatalogue = readPersonaDir(personasDir);
+    const forgeCfgPath = path.join(cwd, ".forge", "config.json");
+    const pipelineCatalogue = readPipelineNames(forgeCfgPath);
+    const availableModels = (ctx.modelRegistry?.getAvailable?.() ?? []).map((m) => ({ provider: m.provider, id: m.id }));
+    return { personaCatalogue, pipelineCatalogue, availableModels };
+}
+/** Discover the Forge config at cwd. On success, sweep orphaned project
+ *  transcripts and return the resolved tool paths. On failure, notify and clear
+ *  the status line, then return null (caller returns immediately). */
+export function resolveOrchestratorEntry(opts) {
+    const { cwd, notify } = opts;
+    const forgeConfig = discoverForgeConfigCached(cwd);
+    if (!forgeConfig) {
+        notify.error("no Forge project found at cwd. Run /forge:init first.");
+        notify.clearStatus();
+        return null;
+    }
+    const forgeRoot = forgeConfig.forgeRoot;
+    // Best-effort transcript-archive sweep: adopt any project-local runs not yet
+    // in the central index (crash recovery + pre-existing history). Runs BEFORE
+    // any pipeline creates its own transcript writer, so in-flight runs are
+    // never swept half-written.
+    sweepProjectTranscripts(cwd);
+    return {
+        forgeRoot,
+        storeCli: path.join(forgeRoot, "tools", "store-cli.cjs"),
+        preflightGate: path.join(forgeRoot, "tools", "preflight-gate.cjs"),
+    };
+}
+/** Layered-config schema check followed by full model-config validation.
+ *  Surfaces schema/validation errors via the notifier (matching the legacy
+ *  inline strings) and returns the merged routing config on success. */
+export function runPipelinePreflight(opts) {
+    const { cwd, ctx, notify } = opts;
+    // N-B-E: surface schema errors to caller (Decision 9 — orchestrators
+    // fail-fast). See doc/decisions/layered-config-error-policy.md.
+    const { merged: modelRoutingConfig, errors: layeredConfigErrors } = loadLayeredConfig(cwd);
+    if (layeredConfigErrors.length > 0) {
+        for (const e of layeredConfigErrors) {
+            notify.error(`forge-cli config schema error: ${e}`);
+        }
+        return { proceed: false, lastError: `forge-cli config schema errors: ${layeredConfigErrors.join("; ")}` };
+    }
+    const inputs = gatherModelValidationInputs(cwd, ctx);
+    const preflightResult = runOrchestratorPreflight({
+        mode: "task",
+        ctx,
+        notifyPrefix: notify.label,
+        personaCatalogue: inputs.personaCatalogue,
+        pipelineCatalogue: inputs.pipelineCatalogue,
+        modelRoutingConfig,
+        availableModels: inputs.availableModels,
+    });
+    if (!preflightResult.proceed) {
+        return {
+            proceed: false,
+            lastError: preflightResult.result.lastError ?? "model config validation failed",
+        };
+    }
+    return { proceed: true, modelRoutingConfig };
+}
+//# sourceMappingURL=orchestrator-entry.js.map

package/dist/extensions/forgecli/orchestrators/common/orchestrator-entry.js.map

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

package/dist/extensions/forgecli/orchestrators/common/orchestrator-misc.d.ts

@@ -0,0 +1,8 @@
+export declare function isNonInteractive(): boolean;
+/** Validate that an ID contains no path-traversal characters. */
+export declare function validateId(id: string): boolean;
+/**
+ * Format an ISO timestamp for human display in the user's local timezone.
+ * Falls back to the raw ISO string if parsing fails.
+ */
+export declare function formatLocalTime(iso: string): string;

package/dist/extensions/forgecli/orchestrators/common/orchestrator-misc.js

@@ -0,0 +1,37 @@
+// orchestrator-misc.ts — generic orchestrator helpers shared across the
+// task / sprint / bug pipelines. Extracted from run-task.ts (no logic changes)
+// so the per-file architectural line cap is satisfied; run-task.ts re-exports
+// these for backwards compatibility (fix-bug.ts and run-sprint.ts import them
+// from run-task today).
+// ── Non-interactive helpers ───────────────────────────────────────────────
+export function isNonInteractive() {
+    return process.env.FORGE_YES === "1" || process.env.FORGE_NON_INTERACTIVE === "1";
+}
+/** Validate that an ID contains no path-traversal characters. */
+export function validateId(id) {
+    return /^[A-Za-z0-9_-]+$/.test(id) && !id.includes("..");
+}
+/**
+ * Format an ISO timestamp for human display in the user's local timezone.
+ * Falls back to the raw ISO string if parsing fails.
+ */
+export function formatLocalTime(iso) {
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime()))
+        return iso;
+    const date = d.toLocaleString(undefined, {
+        year: "numeric",
+        month: "short",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        hour12: false,
+    });
+    // Append short timezone abbreviation for unambiguous reading.
+    const tz = new Intl.DateTimeFormat(undefined, { timeZoneName: "short" })
+        .formatToParts(d)
+        .find((p) => p.type === "timeZoneName")?.value ?? "";
+    return tz ? `${date} ${tz}` : date;
+}
+//# sourceMappingURL=orchestrator-misc.js.map

package/dist/extensions/forgecli/orchestrators/common/orchestrator-misc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-misc.js","sourceRoot":"","sources":["../../../../../src/extensions/forgecli/orchestrators/common/orchestrator-misc.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,+EAA+E;AAC/E,8EAA8E;AAC9E,8EAA8E;AAC9E,wBAAwB;AAExB,6EAA6E;AAE7E,MAAM,UAAU,gBAAgB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,GAAG,CAAC;AACnF,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,UAAU,CAAC,EAAU;IACpC,OAAO,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IAC1C,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,GAAG,CAAC;IAC1C,MAAM,IAAI,GAAG,CAAC,CAAC,cAAc,CAAC,SAAS,EAAE;QACxC,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,OAAO;QACd,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;KACb,CAAC,CAAC;IACH,8DAA8D;IAC9D,MAAM,EAAE,GACP,IAAI,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;SAC3D,aAAa,CAAC,CAAC,CAAC;SAChB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;IACvD,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACpC,CAAC"}

package/dist/extensions/forgecli/orchestrators/common/orchestrator-notify.d.ts

@@ -0,0 +1,28 @@
+import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+type NotifyLevel = Parameters<ExtensionCommandContext["ui"]["notify"]>[1];
+export interface OrchestratorNotifierOptions {
+    /** Command label, e.g. "forge:run-task" / "forge:fix-bug" / "forge:run-sprint". */
+    label: string;
+    /** ctx.ui status key for this command. */
+    statusKey: string;
+    /** Optional detail-message status key (absent for run-sprint). */
+    messageKey?: string;
+}
+export interface OrchestratorNotifier {
+    readonly label: string;
+    readonly statusKey: string;
+    /** Raw passthrough to the live ctx.ui.notify. */
+    notify(message: string, level?: NotifyLevel): void;
+    /** `× <label> — <msg>` at error level. */
+    error(msg: string): void;
+    /** `⚠ <label> — <msg>` at warning level. */
+    warn(msg: string): void;
+    /** `<label> — <msg>` at info level. */
+    info(msg: string): void;
+    /** Set the command status line. */
+    setStatus(text: string): void;
+    /** Clear the status key (and message key, if configured). */
+    clearStatus(): void;
+}
+export declare function createOrchestratorNotifier(ctx: ExtensionCommandContext, opts: OrchestratorNotifierOptions): OrchestratorNotifier;
+export {};

package/dist/extensions/forgecli/orchestrators/common/orchestrator-notify.js

@@ -0,0 +1,45 @@
+// orchestrator-notify.ts — shared UI-notification facade for the orchestrator
+// pipelines (run-task, fix-bug, run-sprint).
+//
+// Owns the per-command label, the status/message keys, and the two highest-
+// frequency mechanical notification shapes:
+//
+//   error(msg)  → `× <label> — <msg>`   (level "error")
+//   warn(msg)   → `⚠ <label> — <msg>`   (level "warning")
+//   info(msg)   → `<label> — <msg>`     (level "info")
+//
+// The semantic-symbol lines (⊘ cancel, ⟳ loopback, 〇 complete, ✓ phase-done,
+// → phase-start, ▶ dispatch) stay inline at their call sites but are emitted
+// through `notify(...)` so they still hit the transcript recorder.
+//
+// IMPORTANT: every method reads `ctx.ui.notify` LIVE on each call (never a
+// captured/bound reference) so the transcript-recorder swap installed by
+// withOrchestratorTranscript is honored.
+export function createOrchestratorNotifier(ctx, opts) {
+    const { label, statusKey, messageKey } = opts;
+    return {
+        label,
+        statusKey,
+        notify(message, level) {
+            ctx.ui.notify(message, level);
+        },
+        error(msg) {
+            ctx.ui.notify(`× ${label} — ${msg}`, "error");
+        },
+        warn(msg) {
+            ctx.ui.notify(`⚠ ${label} — ${msg}`, "warning");
+        },
+        info(msg) {
+            ctx.ui.notify(`${label} — ${msg}`, "info");
+        },
+        setStatus(text) {
+            ctx.ui.setStatus?.(statusKey, text);
+        },
+        clearStatus() {
+            ctx.ui.setStatus?.(statusKey, undefined);
+            if (messageKey)
+                ctx.ui.setStatus?.(messageKey, undefined);
+        },
+    };
+}
+//# sourceMappingURL=orchestrator-notify.js.map

package/dist/extensions/forgecli/orchestrators/common/orchestrator-notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-notify.js","sourceRoot":"","sources":["../../../../../src/extensions/forgecli/orchestrators/common/orchestrator-notify.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6CAA6C;AAC7C,EAAE;AACF,4EAA4E;AAC5E,4CAA4C;AAC5C,EAAE;AACF,wDAAwD;AACxD,0DAA0D;AAC1D,uDAAuD;AACvD,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,mEAAmE;AACnE,EAAE;AACF,2EAA2E;AAC3E,yEAAyE;AACzE,yCAAyC;AAgCzC,MAAM,UAAU,0BAA0B,CACzC,GAA4B,EAC5B,IAAiC;IAEjC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAC9C,OAAO;QACN,KAAK;QACL,SAAS;QACT,MAAM,CAAC,OAAe,EAAE,KAAmB;YAC1C,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,KAAK,CAAC,GAAW;YAChB,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,MAAM,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,GAAW;YACf,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,MAAM,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,CAAC,GAAW;YACf,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,MAAM,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;QAC5C,CAAC;QACD,SAAS,CAAC,IAAY;YACrB,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;QACD,WAAW;YACV,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACzC,IAAI,UAAU;gBAAE,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAC3D,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/extensions/forgecli/orchestrators/common/orchestrator-transcript-session.d.ts

@@ -0,0 +1,26 @@
+import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import type { OrchestratorResult, OrchestratorStatus } from "../../lib/orchestrator-types.js";
+import { OrchestratorTranscriptWriter } from "../../subagent/orchestrator-transcript.js";
+/** Map a pipeline status to the orchestrator-transcript outcome vocabulary.
+ *  Shared by run-task and fix-bug (same status union). */
+export declare function transcriptOutcomeFor(status: OrchestratorStatus): "complete" | "halted" | "cancelled" | "error";
+/** Handle passed to the inner pipeline loop — exposes the live transcript
+ *  writer for structured phase-boundary records. */
+export interface OrchestratorTranscriptSession {
+    readonly writer: OrchestratorTranscriptWriter;
+}
+export interface WithOrchestratorTranscriptOpts {
+    cwd: string;
+    entityKind: "bug" | "task" | "sprint";
+    entityId: string;
+    ctx: ExtensionCommandContext;
+}
+/**
+ * Create the orchestrator transcript writer, intercept ctx.ui.notify so every
+ * notification is recorded, run `inner(session)`, then close the writer with
+ * the result's mapped outcome and surface its path on the result. Restores the
+ * original ctx.ui.notify in a finally.
+ */
+export declare function withOrchestratorTranscript<T extends OrchestratorResult & {
+    orchestratorTranscriptPath?: string;
+}>(opts: WithOrchestratorTranscriptOpts, inner: (session: OrchestratorTranscriptSession) => Promise<T>): Promise<T>;

package/dist/extensions/forgecli/orchestrators/common/orchestrator-transcript-session.js

@@ -0,0 +1,75 @@
+// orchestrator-transcript-session.ts — shared transcript-writing concern for
+// the orchestrator pipelines (run-task, fix-bug).
+//
+// Collapses three byte-identical duplications that previously lived in both
+// run-task.ts and fix-bug.ts:
+//   1. the ctx.ui.notify interception that records every notify line into the
+//      orchestrator transcript,
+//   2. the pipeline-wrapper dance (create writer → run inner → close with the
+//      mapped outcome → surface the file path), and
+//   3. the status→outcome mapping (transcriptOutcomeFor).
+//
+// Behavior contract preserved exactly:
+//   - The writer is created INSIDE this helper, so callers must run their
+//     config/preflight early-returns BEFORE calling withOrchestratorTranscript
+//     (a failed preflight must not create a transcript file).
+//   - On a clean run the inner loop records its own "complete" pipeline-end;
+//     OrchestratorTranscriptWriter.record() marks the log closed, so the
+//     trailing close() here is an idempotent no-op. On cancel/halt/fail the
+//     inner returns without a pipeline-end and this close() is the guarantee
+//     that the run is archived with its true outcome.
+//   - ctx.ui.notify is restored in a finally, even if inner throws.
+import { getOrchestratorTree } from "../../orchestrator-tree.js";
+import { OrchestratorTranscriptWriter } from "../../subagent/orchestrator-transcript.js";
+/** Map a pipeline status to the orchestrator-transcript outcome vocabulary.
+ *  Shared by run-task and fix-bug (same status union). */
+export function transcriptOutcomeFor(status) {
+    switch (status) {
+        case "completed":
+            return "complete";
+        case "cancelled":
+            return "cancelled";
+        case "halted":
+        case "escalated":
+            return "halted";
+        case "failed":
+            return "error";
+    }
+}
+/**
+ * Create the orchestrator transcript writer, intercept ctx.ui.notify so every
+ * notification is recorded, run `inner(session)`, then close the writer with
+ * the result's mapped outcome and surface its path on the result. Restores the
+ * original ctx.ui.notify in a finally.
+ */
+export async function withOrchestratorTranscript(opts, inner) {
+    const { cwd, entityKind, entityId, ctx } = opts;
+    const writer = new OrchestratorTranscriptWriter({ cwd, entityKind, entityId });
+    const tree = getOrchestratorTree();
+    const origNotify = ctx.ui.notify.bind(ctx.ui);
+    ctx.ui.notify = ((msg, level) => {
+        origNotify(msg, level);
+        const text = typeof msg === "string" ? msg : String(msg);
+        writer.record({
+            kind: "notify",
+            ts: new Date().toISOString(),
+            level: (level ?? "info"),
+            message: text,
+        });
+        // Mirror the orchestrator's decision log onto its root node so the
+        // dashboard surfaces it. Leaf phase nodes carry subagent tool-call
+        // activity (via the viewport observer); this root node (entityId) carries
+        // the orchestrator's own narrative — gates, verdicts, escalations, halts.
+        tree.appendTail(entityId, text, level === "error" || level === "warning" ? { warning: true } : undefined);
+    });
+    try {
+        const result = await inner({ writer });
+        writer.close(transcriptOutcomeFor(result.status), result.lastError);
+        result.orchestratorTranscriptPath = writer.filePath;
+        return result;
+    }
+    finally {
+        ctx.ui.notify = origNotify;
+    }
+}
+//# sourceMappingURL=orchestrator-transcript-session.js.map

package/dist/extensions/forgecli/orchestrators/common/orchestrator-transcript-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-transcript-session.js","sourceRoot":"","sources":["../../../../../src/extensions/forgecli/orchestrators/common/orchestrator-transcript-session.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,kDAAkD;AAClD,EAAE;AACF,4EAA4E;AAC5E,8BAA8B;AAC9B,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E;AAC9E,oDAAoD;AACpD,0DAA0D;AAC1D,EAAE;AACF,uCAAuC;AACvC,0EAA0E;AAC1E,+EAA+E;AAC/E,8DAA8D;AAC9D,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAC5E,6EAA6E;AAC7E,sDAAsD;AACtD,oEAAoE;AAKpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,2CAA2C,CAAC;AAEzF;0DAC0D;AAC1D,MAAM,UAAU,oBAAoB,CAAC,MAA0B;IAC9D,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,WAAW;YACf,OAAO,UAAU,CAAC;QACnB,KAAK,WAAW;YACf,OAAO,WAAW,CAAC;QACpB,KAAK,QAAQ,CAAC;QACd,KAAK,WAAW;YACf,OAAO,QAAQ,CAAC;QACjB,KAAK,QAAQ;YACZ,OAAO,OAAO,CAAC;IACjB,CAAC;AACF,CAAC;AAeD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAE9C,IAAoC,EAAE,KAA6D;IACpG,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,4BAA4B,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/E,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;IACnC,MAAM,UAAU,GAAyB,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpE,GAAG,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,GAAW,EAAE,KAAwC,EAAE,EAAE;QAC1E,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACvB,MAAM,IAAI,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzD,MAAM,CAAC,MAAM,CAAC;YACb,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,KAAK,EAAE,CAAC,KAAK,IAAI,MAAM,CAA0C;YACjE,OAAO,EAAE,IAAI;SACb,CAAC,CAAC;QACH,mEAAmE;QACnE,mEAAmE;QACnE,0EAA0E;QAC1E,0EAA0E;QAC1E,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3G,CAAC,CAAyB,CAAC;IAE3B,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACpE,MAAM,CAAC,0BAA0B,GAAG,MAAM,CAAC,QAAQ,CAAC;QACpD,OAAO,MAAM,CAAC;IACf,CAAC;YAAS,CAAC;QACV,GAAG,CAAC,EAAE,CAAC,MAAM,GAAG,UAAU,CAAC;IAC5B,CAAC;AACF,CAAC"}

package/dist/extensions/forgecli/orchestrators/common/recovery-menu.d.ts

@@ -0,0 +1,24 @@
+import { type ResetEntityKind, type ResetPipelineParams, type ResetPipelineResult } from "./reset-pipeline.js";
+export interface RecoveryUi {
+    select(title: string, options: string[], opts?: unknown): Promise<string | undefined>;
+    notify(message: string, level?: string): void;
+}
+export interface RecoveryMenuParams {
+    ui: RecoveryUi;
+    kind: ResetEntityKind;
+    id: string;
+    cwd: string;
+    storeCli: string;
+    /** Override interactivity detection (tests). */
+    interactive?: boolean;
+    /** Override the reset implementation (tests). */
+    reset?: (p: ResetPipelineParams) => ResetPipelineResult;
+}
+/** Ordered phase roles for the entity's pipeline. */
+export declare function phaseRolesFor(kind: ResetEntityKind): string[];
+/**
+ * Offer an interactive recovery menu at a halt. Returns the reset result if the
+ * operator chose to reset, otherwise undefined (declined / aborted / non-
+ * interactive). Never throws.
+ */
+export declare function offerRecoveryMenu(p: RecoveryMenuParams): Promise<ResetPipelineResult | undefined>;

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

@@ -0,0 +1,58 @@
+// recovery-menu.ts — FEAT-009 (halt-recovery UX): interactive recovery menu
+// offered at a pipeline halt, on top of the deterministic remediation + the
+// `4ge reset` hint. Lets the operator rewind the pipeline with two keystrokes
+// (pick "reset", pick a phase) instead of recalling the command.
+//
+// Best-effort and non-blocking: in non-interactive mode it is a no-op (the
+// printed remediation + 4ge reset hint stand on their own); any error is
+// swallowed so it can never mask the primary halt.
+import { isNonInteractive } from "./orchestrator-misc.js";
+import { resetPipelineState, } from "./reset-pipeline.js";
+import { BUG_PHASES } from "../bug/bug-phases.js";
+import { PHASES } from "../task/task-phases.js";
+const RESET_LABEL = "Reset to a phase and resume later";
+const ABORT_LABEL = "Leave it halted";
+/** Ordered phase roles for the entity's pipeline. */
+export function phaseRolesFor(kind) {
+    return (kind === "bug" ? BUG_PHASES : PHASES).map((p) => p.role);
+}
+/**
+ * Offer an interactive recovery menu at a halt. Returns the reset result if the
+ * operator chose to reset, otherwise undefined (declined / aborted / non-
+ * interactive). Never throws.
+ */
+export async function offerRecoveryMenu(p) {
+    const interactive = p.interactive ?? !isNonInteractive();
+    if (!interactive)
+        return undefined;
+    try {
+        const choice = await p.ui.select(`Halt recovery — ${p.id}`, [RESET_LABEL, ABORT_LABEL]);
+        if (choice !== RESET_LABEL)
+            return undefined;
+        const phase = await p.ui.select(`Reset ${p.id} to which phase?`, phaseRolesFor(p.kind));
+        if (!phase)
+            return undefined;
+        const reset = p.reset ?? resetPipelineState;
+        const result = reset({
+            kind: p.kind,
+            cwd: p.cwd,
+            id: p.id,
+            toPhase: phase,
+            storeCli: p.storeCli,
+        });
+        if (result.ok) {
+            const resumeCmd = p.kind === "bug" ? `/forge:fix-bug ${p.id}` : `/forge:run-task ${p.id}`;
+            p.ui.notify(`〇 reset ${p.id} → '${result.role}' (status → ${result.preStatus}). Resume with: ${resumeCmd}`, "info");
+        }
+        else {
+            p.ui.notify(`⚠ reset ${p.id} failed: ${result.detail ?? "unknown"}`, "warning");
+        }
+        return result;
+    }
+    catch (err) {
+        const e = err;
+        p.ui.notify(`⚠ recovery menu unavailable (non-fatal): ${e.message ?? "unknown"}`, "warning");
+        return undefined;
+    }
+}
+//# sourceMappingURL=recovery-menu.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-menu.js","sourceRoot":"","sources":["../../../../../src/extensions/forgecli/orchestrators/common/recovery-menu.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,4EAA4E;AAC5E,8EAA8E;AAC9E,iEAAiE;AACjE,EAAE;AACF,2EAA2E;AAC3E,yEAAyE;AACzE,mDAAmD;AAEnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAIN,kBAAkB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAoBhD,MAAM,WAAW,GAAG,mCAAmC,CAAC;AACxD,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAEtC,qDAAqD;AACrD,MAAM,UAAU,aAAa,CAAC,IAAqB;IAClD,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,CAAqB;IAErB,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACzD,IAAI,CAAC,WAAW;QAAE,OAAO,SAAS,CAAC;IAEnC,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;QACxF,IAAI,MAAM,KAAK,WAAW;YAAE,OAAO,SAAS,CAAC;QAE7C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,kBAAkB,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACxF,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAE7B,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,kBAAkB,CAAC;QAC5C,MAAM,MAAM,GAAG,KAAK,CAAC;YACpB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACpB,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,EAAE,EAAE,CAAC;YAC1F,CAAC,CAAC,EAAE,CAAC,MAAM,CACV,WAAW,CAAC,CAAC,EAAE,OAAO,MAAM,CAAC,IAAI,eAAe,MAAM,CAAC,SAAS,mBAAmB,SAAS,EAAE,EAC9F,MAAM,CACN,CAAC;QACH,CAAC;aAAM,CAAC;YACP,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,YAAY,MAAM,CAAC,MAAM,IAAI,SAAS,EAAE,EAAE,SAAS,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,GAA2B,CAAC;QACtC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,4CAA4C,CAAC,CAAC,OAAO,IAAI,SAAS,EAAE,EAAE,SAAS,CAAC,CAAC;QAC7F,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC"}

package/dist/extensions/forgecli/orchestrators/common/reset-pipeline.d.ts

@@ -0,0 +1,53 @@
+export type ResetEntityKind = "task" | "bug";
+export interface ResetPlan {
+    role: string;
+    phaseIndex: number;
+    preStatus: string;
+}
+/**
+ * Pure planner: resolve the target phase to its index + pre-status for the given
+ * entity kind. Returns an `error` string for an unknown phase (no IO, fully
+ * unit-testable).
+ */
+export declare function planReset(kind: ResetEntityKind, toPhase: string): ResetPlan | {
+    error: string;
+};
+/** Result of a status-setter call. */
+export interface SetStatusResult {
+    ok: boolean;
+    /** Status the record held before the transition, if known. */
+    from?: string;
+    /** Error detail on failure. */
+    detail?: string;
+}
+export interface ResetPipelineParams {
+    /** Which pipeline's state to reset. */
+    kind: ResetEntityKind;
+    cwd: string;
+    /** Task or bug id. */
+    id: string;
+    /** Target phase role (e.g. "implement", "triage"). */
+    toPhase: string;
+    /** Absolute path to store-cli.cjs. */
+    storeCli: string;
+    /**
+     * Override the status-setter (tests inject a stub). Defaults to a
+     * force-transition via store-cli with FORGE_ALLOW_FORCE=1.
+     */
+    setStatus?: (status: string) => SetStatusResult;
+}
+export interface ResetPipelineResult {
+    ok: boolean;
+    role?: string;
+    phaseIndex?: number;
+    preStatus?: string;
+    detail?: string;
+}
+/**
+ * Force an entity's status to the target phase's pre-status and rewrite the
+ * resume-state cache so the pipeline re-enters at that phase. Returns
+ * `{ok:false, detail}` rather than throwing on a planning or status-set failure;
+ * the resume-state is written ONLY after the status transition succeeds, so a
+ * failed reset never leaves a half-rewound pipeline.
+ */
+export declare function resetPipelineState(p: ResetPipelineParams): ResetPipelineResult;

package/dist/extensions/forgecli/orchestrators/common/reset-pipeline.js

@@ -0,0 +1,131 @@
+// reset-pipeline.ts — FEAT-009 (halt-recovery UX): guardrailed pipeline-state
+// reset for the run-task AND fix-bug pipelines.
+//
+// Encapsulates exactly the manual recovery an operator otherwise performs by
+// hand after a halt: force the entity to the status a target phase expects, and
+// rewrite the resume-state cache to re-enter at that phase. Deterministic and
+// store-aware:
+//   - the target phase must be a known phase for the entity's pipeline;
+//   - the status it sets is the phase's documented pre-status, which lies within
+//     that phase's own step-0b allowed-states set, so the phase guard accepts it
+//     on resume;
+//   - the FSM transition is applied via store-cli with the operator-gated
+//     --force escape hatch (FORGE_ALLOW_FORCE=1), because terminal states
+//     (blocked / fixed / escalated) are otherwise un-exitable by design.
+//
+// Sprint reset is intentionally NOT handled here: a sprint runs member tasks in
+// dependency waves, so resetting it means rewinding the wave pointer and
+// cascade-resetting member tasks coherently — a cross-entity, referential-
+// integrity-sensitive operation that belongs in the guardrailed /forge:reset
+// (FEAT-009 T03), not this single-entity deterministic helper.
+//
+// IL6 — store-cli is invoked via spawnSync argv array, never shell-string
+// interpolation. The status-setter is injectable so unit tests need not spawn.
+import { spawnSync } from "node:child_process";
+import { BUG_PHASE_PRE_STATUS, bugPhaseIndexByRole } from "../bug/bug-phases.js";
+import { deleteBugState, writeBugState } from "../bug/bug-state.js";
+import { PHASE_PRE_STATUS, phaseIndexByRole } from "../task/task-phases.js";
+import { writeState } from "../task/task-state.js";
+const PROFILES = {
+    task: {
+        preStatus: PHASE_PRE_STATUS,
+        indexOf: phaseIndexByRole,
+        storeEntity: "task",
+        writeResume(cwd, id, phaseIndex) {
+            // Leave `status` unset: with halted:false and no status, the resume
+            // prompt labels it "interrupted" and offers to resume from this phase.
+            writeState(cwd, {
+                taskId: id,
+                phaseIndex,
+                iterationCounts: {},
+                halted: false,
+                savedAt: new Date().toISOString(),
+            });
+        },
+    },
+    bug: {
+        preStatus: BUG_PHASE_PRE_STATUS,
+        indexOf: bugPhaseIndexByRole,
+        storeEntity: "bug",
+        writeResume(cwd, id, phaseIndex) {
+            // Bug state files are session-suffixed (fix-bug-state-<id>-<session>);
+            // clear every session's file first so resume globs exactly one fresh
+            // state, then write the rewound state.
+            deleteBugState(cwd, id);
+            writeBugState(cwd, {
+                bugId: id,
+                phaseIndex,
+                iterationCounts: {},
+                halted: false,
+                savedAt: new Date().toISOString(),
+            });
+        },
+    },
+};
+/**
+ * Pure planner: resolve the target phase to its index + pre-status for the given
+ * entity kind. Returns an `error` string for an unknown phase (no IO, fully
+ * unit-testable).
+ */
+export function planReset(kind, toPhase) {
+    const profile = PROFILES[kind];
+    const role = toPhase.trim();
+    const phaseIndex = profile.indexOf(role);
+    if (phaseIndex < 0) {
+        const known = Object.keys(profile.preStatus).join(", ");
+        return { error: `Unknown ${kind} phase '${role}'. Known phases: ${known}` };
+    }
+    const preStatus = profile.preStatus[role];
+    if (!preStatus) {
+        return { error: `No pre-status mapping for ${kind} phase '${role}'` };
+    }
+    return { role, phaseIndex, preStatus };
+}
+/**
+ * Force an entity's status to the target phase's pre-status and rewrite the
+ * resume-state cache so the pipeline re-enters at that phase. Returns
+ * `{ok:false, detail}` rather than throwing on a planning or status-set failure;
+ * the resume-state is written ONLY after the status transition succeeds, so a
+ * failed reset never leaves a half-rewound pipeline.
+ */
+export function resetPipelineState(p) {
+    const plan = planReset(p.kind, p.toPhase);
+    if ("error" in plan) {
+        return { ok: false, detail: plan.error };
+    }
+    const profile = PROFILES[p.kind];
+    const setStatus = p.setStatus ?? defaultForceSetStatus(p.storeCli, profile.storeEntity, p.id, p.cwd);
+    const setResult = setStatus(plan.preStatus);
+    if (!setResult.ok) {
+        return {
+            ok: false,
+            role: plan.role,
+            phaseIndex: plan.phaseIndex,
+            preStatus: plan.preStatus,
+            detail: setResult.detail ?? `failed to set status to ${plan.preStatus}`,
+        };
+    }
+    profile.writeResume(p.cwd, p.id, plan.phaseIndex);
+    return { ok: true, role: plan.role, phaseIndex: plan.phaseIndex, preStatus: plan.preStatus };
+}
+/**
+ * Default status-setter: force-transition the entity via store-cli. Uses the
+ * operator-gated --force escape hatch (FORGE_ALLOW_FORCE=1) so terminal states
+ * (blocked / fixed / escalated) can be recovered. Argv array — no shell
+ * interpolation.
+ */
+function defaultForceSetStatus(storeCli, storeEntity, id, cwd) {
+    return (status) => {
+        const r = spawnSync("node", [storeCli, "update-status", storeEntity, id, "status", status, "--force"], {
+            cwd,
+            encoding: "utf8",
+            env: { ...process.env, FORGE_ALLOW_FORCE: "1" },
+        });
+        if (r.status === 0) {
+            return { ok: true };
+        }
+        const detail = (r.stderr || r.stdout || "").trim() || `store-cli exited ${r.status}`;
+        return { ok: false, detail };
+    };
+}
+//# sourceMappingURL=reset-pipeline.js.map

package/dist/extensions/forgecli/orchestrators/common/reset-pipeline.js.map

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

package/dist/extensions/forgecli/orchestrators/common/summary-recovery.d.ts

@@ -0,0 +1,24 @@
+export interface SummaryRecoveryResult {
+    /** Always true — the recovery was attempted (caller decides when to call). */
+    attempted: boolean;
+    /** True only when set-summary exited 0 (sidecar present + schema-valid). */
+    ok: boolean;
+    /** Captured stderr for debug logging. */
+    stderr: string;
+}
+export interface RecoverPhaseSummaryParams {
+    /** Absolute path to the project's store-cli.cjs. */
+    storeCli: string;
+    /** Task or bug record id whose summary is being registered. */
+    entityId: string;
+    /** Canonical `summaries.*` store key (e.g. "plan", "code_review"). */
+    summaryKey: string;
+    cwd: string;
+    /** "set-summary" (task, default) or "set-bug-summary" (bug). */
+    summaryVerb?: "set-summary" | "set-bug-summary";
+}
+/**
+ * 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 declare function recoverPhaseSummary(p: RecoverPhaseSummaryParams): SummaryRecoveryResult;