@entelligentsia/forgecli 0.21.0 → 1.0.3

package/dist/extensions/forgecli/store-query.js

@@ -14,14 +14,14 @@ import { promisify } from "node:util";
 import { resolveToolDir } from "./store-resolver.js";
 const execFileAsync = promisify(execFile);
 // ── Usage message ─────────────────────────────────────────────────────────────
-const USAGE = `Usage: /forge:store-query <intent or flags>
+const USAGE = `Usage: /forge:search <intent or flags>
 
 Examples:
-  /forge:store-query open bugs in S12
-  /forge:store-query FORGE-BUG-047
-  /forge:store-query --sprint FORGE-S12 --status in-progress
-  /forge:store-query --keyword auth
-  /forge:store-query schema`;
+  /forge:search open bugs in S12
+  /forge:search FORGE-BUG-047
+  /forge:search --sprint FORGE-S12 --status in-progress
+  /forge:search --keyword auth
+  /forge:search schema`;
 /**
  * Run store-cli in query or nlp mode.
  * - Args starting with "--" → query branch: `store-cli query ...flags`
@@ -73,7 +73,7 @@ export async function runStoreQuery(args, forgeRoot, cwd) {
  * forgeRoot is nullable — null means we're outside a Forge project.
  */
 export function registerStoreQuery(pi, opts) {
-    pi.registerCommand("forge:store-query", {
+    pi.registerCommand("forge:search", {
         description: "Query the Forge store by natural language or exact flags. " +
             "Use flags (--sprint, --task, --keyword) for exact queries; " +
             "use plain text for NLP intent queries.",
@@ -81,7 +81,7 @@ export function registerStoreQuery(pi, opts) {
             const cwd = process.cwd();
             // Outside-project guard
             if (!opts.forgeRoot) {
-                ctx.ui.notify("× forge:store-query — not inside a Forge project. Run /forge:init first.", "error");
+                ctx.ui.notify("× forge:search — not inside a Forge project. Run /forge:init first.", "error");
                 return;
             }
             const trimmed = args.trim();
@@ -89,11 +89,11 @@ export function registerStoreQuery(pi, opts) {
                 ctx.ui.notify(USAGE, "info");
                 return;
             }
-            ctx.ui.setStatus?.("forge:store-query", "Querying store…");
+            ctx.ui.setStatus?.("forge:search", "Querying store…");
             const result = await runStoreQuery(trimmed, opts.forgeRoot, cwd);
-            ctx.ui.setStatus?.("forge:store-query", undefined);
+            ctx.ui.setStatus?.("forge:search", undefined);
             if (!result.ok && result.errorMessage) {
-                ctx.ui.notify(`× forge:store-query — ${result.errorMessage}`, "error");
+                ctx.ui.notify(`× forge:search — ${result.errorMessage}`, "error");
                 // Still show partial stdout if available
                 if (result.stdout.trim()) {
                     ctx.ui.notify(result.stdout.trim(), "info");

package/dist/extensions/forgecli/store-query.js.map

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

package/dist/extensions/forgecli/store-repair.js

@@ -58,7 +58,7 @@ export function parseStoreRepairArgs(rawArgs, cwd) {
 }
 export function composeStoreRepairKickoff(opts) {
     const { commandMd, parsed } = opts;
-    const sections = ["# /forge:store-repair", ""];
+    const sections = ["# /forge:repair", ""];
     sections.push("## Dispatch", "");
     sections.push("Diagnose and repair the Forge JSON store. Run the repair workflow below. Specifically:");
     sections.push("");
@@ -80,15 +80,15 @@ export function composeStoreRepairKickoff(opts) {
 // ── Registration ──────────────────────────────────────────────────────────
 const COMMAND_NAME = "store-repair";
 export function registerStoreRepair(pi, options) {
-    pi.registerCommand("forge:store-repair", {
+    pi.registerCommand("forge:repair", {
         description: "Diagnose and repair corrupted Forge store records. " +
-            "Usage: /forge:store-repair [--dry-run]. " +
+            "Usage: /forge:repair [--dry-run]. " +
             "--dry-run shows what would be repaired without making changes.",
         async handler(args, ctx) {
             const { forgeRoot } = options;
             const cwd = options.cwd ?? process.cwd();
             if (!forgeRoot) {
-                ctx.ui.notify("× forge:store-repair — no Forge project at cwd; run /forge:init to bootstrap", "warning");
+                ctx.ui.notify("× forge:repair — no Forge project at cwd; run /forge:init to bootstrap", "warning");
                 return;
             }
             const commandPath = path.join(forgeRoot, "commands", `${COMMAND_NAME}.md`);
@@ -99,10 +99,10 @@ export function registerStoreRepair(pi, options) {
             catch (err) {
                 const e = err;
                 if (e.code === "ENOENT") {
-                    ctx.ui.notify(`× forge:store-repair — command file not found at commands/${COMMAND_NAME}.md; run /forge:init or /forge:regenerate first.`, "error");
+                    ctx.ui.notify(`× forge:repair — command file not found at commands/${COMMAND_NAME}.md; run /forge:init or /forge:rebuild first.`, "error");
                 }
                 else {
-                    ctx.ui.notify(`× forge:store-repair — failed to read command file: ${e.message ?? "unknown error"}`, "error");
+                    ctx.ui.notify(`× forge:repair — failed to read command file: ${e.message ?? "unknown error"}`, "error");
                 }
                 return;
             }
@@ -112,7 +112,7 @@ export function registerStoreRepair(pi, options) {
             }
             catch (err) {
                 const e = err;
-                ctx.ui.notify(`× forge:store-repair — failed to parse args: ${e.message ?? "unknown"}`, "error");
+                ctx.ui.notify(`× forge:repair — failed to parse args: ${e.message ?? "unknown"}`, "error");
                 return;
             }
             const kickoff = composeStoreRepairKickoff({ commandMd, parsed });

package/dist/extensions/forgecli/store-repair.js.map

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

package/dist/extensions/forgecli/subagent/caller-context.d.ts

@@ -1,26 +1,50 @@
-/** Caller context of the current handler invocation. */
-export type CallerContext = "orchestrator" | "subagent";
+/**
+ * Canonical phase identifiers used by both `meta-orchestrate.md` and
+ * `meta-fix-bug.md` (the latter adds `triage`). When a subagent is
+ * dispatched, its phase tag MUST be one of these values — that lets the
+ * phase-ownership guard compare the caller's phase against the tool's
+ * named `--phase` argument.
+ */
+export type PhaseRole = "triage" | "plan" | "plan-fix" | "review-plan" | "implement" | "review-code" | "validate" | "approve" | "writeback" | "commit" | "finalize";
+/**
+ * Caller context of the current handler invocation. Discriminated union:
+ * orchestrator (default) or subagent + phase. Subagent context is set
+ * exclusively by `asSubagent(phase, fn)` — the single setter point in
+ * the per-phase orchestrator dispatch loop.
+ */
+export type CallerContext = {
+    kind: "orchestrator";
+} | {
+    kind: "subagent";
+    phase: PhaseRole;
+};
 /**
  * Singleton that tracks the caller context for the current handler turn.
  *
  * Usage:
- *   - Read with `CallerContextStore.get()` — used by `assertAudience()`.
- *   - Set with `CallerContextStore.set("subagent")` — used by T02/T03/T07 orchestrator handlers.
- *   - Use `CallerContextStore.asSubagent(fn)` / `asOrchestrator(fn)` for RAII-style scoping.
+ *   - Read with `CallerContextStore.get()` — used by `assertAudience()`
+ *     and `assertPhaseOwnership()`.
+ *   - Set with `CallerContextStore.set(...)` — used by orchestrator
+ *     handlers when RAII scoping is not viable (avoid where possible).
+ *   - Use `CallerContextStore.asSubagent(phase, fn)` /
+ *     `asOrchestrator(fn)` for RAII-style scoping. The async overload
+ *     accepts an `async () => Promise<T>` and awaits before restoring
+ *     prior context.
  */
 export declare const CallerContextStore: {
-    /** Get the current caller context. Defaults to "orchestrator". */
+    /** Get the current caller context. Defaults to `{ kind: "orchestrator" }`. */
     get(): CallerContext;
     /** Set the current caller context. */
     set(ctx: CallerContext): void;
     /**
-     * Execute fn with context set to "subagent"; restore prior context on
-     * return or throw.
+     * Execute fn with context set to `{ kind: "subagent", phase }`; restore
+     * prior context on return or throw. Supports sync and async fn — the
+     * return type is preserved so `await` works at the call site.
      */
-    asSubagent<T>(fn: () => T): T;
+    asSubagent<T>(phase: PhaseRole, fn: () => T): T;
     /**
-     * Execute fn with context set to "orchestrator"; restore prior context on
-     * return or throw.
+     * Execute fn with context set to `{ kind: "orchestrator" }`; restore prior
+     * context on return or throw.
      */
     asOrchestrator<T>(fn: () => T): T;
 };

package/dist/extensions/forgecli/subagent/caller-context.js

@@ -1,13 +1,19 @@
 // caller-context.ts — Tracks whether the current handler execution
-// is running in orchestrator or subagent context (FORGE-S21-T01).
+// is running in orchestrator or subagent context (FORGE-S21-T01),
+// and — when in subagent context — which phase is executing
+// (FORGE-BUG-040).
 //
-// Default: "orchestrator". Handlers in T02/T03/T07 orchestrators set
-// to "subagent" during sub-workflow dispatch to enable assertAudience
-// to refuse orchestrator-only workflows when invoked from a subagent chain.
+// Default: orchestrator. The fix-bug and run-task orchestrators wrap
+// per-phase runForgeSubagent dispatch in CallerContextStore.asSubagent(
+// phase.role, ...) 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 arguments. See
+// subagent/phase-guard.ts.
 //
 // Critical invariant: pi-runtime has NO caller-context API (confirmed by
 // FORGE-S21-T01 spike — see SPIKE-LESSONS.md). This singleton is the
-// ONLY mechanism for passing caller context into assertAudience.
+// ONLY mechanism for passing caller context into assertAudience and the
+// phase-ownership guard.
 //
 // Thread safety: Pi serialises agent turns; the RAII scopers (asSubagent /
 // asOrchestrator) restore prior state on return-or-throw, so interleaving
@@ -17,17 +23,22 @@
 //   IL1 — code only under forge-cli/src/extensions/forgecli/.
 //   IL7 — no silent continuation; all errors are thrown.
 //   No pi-runtime dependency: pure in-memory singleton.
-let _current = "orchestrator";
+let _current = { kind: "orchestrator" };
 /**
  * Singleton that tracks the caller context for the current handler turn.
  *
  * Usage:
- *   - Read with `CallerContextStore.get()` — used by `assertAudience()`.
- *   - Set with `CallerContextStore.set("subagent")` — used by T02/T03/T07 orchestrator handlers.
- *   - Use `CallerContextStore.asSubagent(fn)` / `asOrchestrator(fn)` for RAII-style scoping.
+ *   - Read with `CallerContextStore.get()` — used by `assertAudience()`
+ *     and `assertPhaseOwnership()`.
+ *   - Set with `CallerContextStore.set(...)` — used by orchestrator
+ *     handlers when RAII scoping is not viable (avoid where possible).
+ *   - Use `CallerContextStore.asSubagent(phase, fn)` /
+ *     `asOrchestrator(fn)` for RAII-style scoping. The async overload
+ *     accepts an `async () => Promise<T>` and awaits before restoring
+ *     prior context.
  */
 export const CallerContextStore = {
-    /** Get the current caller context. Defaults to "orchestrator". */
+    /** Get the current caller context. Defaults to `{ kind: "orchestrator" }`. */
     get() {
         return _current;
     },
@@ -36,31 +47,48 @@ export const CallerContextStore = {
         _current = ctx;
     },
     /**
-     * Execute fn with context set to "subagent"; restore prior context on
-     * return or throw.
+     * Execute fn with context set to `{ kind: "subagent", phase }`; restore
+     * prior context on return or throw. Supports sync and async fn — the
+     * return type is preserved so `await` works at the call site.
      */
-    asSubagent(fn) {
+    asSubagent(phase, fn) {
         const prev = _current;
-        _current = "subagent";
+        _current = { kind: "subagent", phase };
         try {
-            return fn();
+            const out = fn();
+            if (out instanceof Promise) {
+                return out.finally(() => {
+                    _current = prev;
+                });
+            }
+            _current = prev;
+            return out;
         }
-        finally {
+        catch (err) {
             _current = prev;
+            throw err;
         }
     },
     /**
-     * Execute fn with context set to "orchestrator"; restore prior context on
-     * return or throw.
+     * Execute fn with context set to `{ kind: "orchestrator" }`; restore prior
+     * context on return or throw.
      */
     asOrchestrator(fn) {
         const prev = _current;
-        _current = "orchestrator";
+        _current = { kind: "orchestrator" };
         try {
-            return fn();
+            const out = fn();
+            if (out instanceof Promise) {
+                return out.finally(() => {
+                    _current = prev;
+                });
+            }
+            _current = prev;
+            return out;
         }
-        finally {
+        catch (err) {
             _current = prev;
+            throw err;
         }
     },
 };

package/dist/extensions/forgecli/subagent/caller-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"caller-context.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/subagent/caller-context.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,kEAAkE;AAClE,EAAE;AACF,qEAAqE;AACrE,sEAAsE;AACtE,4EAA4E;AAC5E,EAAE;AACF,yEAAyE;AACzE,qEAAqE;AACrE,iEAAiE;AACjE,EAAE;AACF,2EAA2E;AAC3E,0EAA0E;AAC1E,mCAAmC;AACnC,EAAE;AACF,aAAa;AACb,8DAA8D;AAC9D,yDAAyD;AACzD,wDAAwD;AAKxD,IAAI,QAAQ,GAAkB,cAAc,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IACjC,kEAAkE;IAClE,GAAG;QACF,OAAO,QAAQ,CAAC;IACjB,CAAC;IACD,sCAAsC;IACtC,GAAG,CAAC,GAAkB;QACrB,QAAQ,GAAG,GAAG,CAAC;IAChB,CAAC;IACD;;;OAGG;IACH,UAAU,CAAI,EAAW;QACxB,MAAM,IAAI,GAAG,QAAQ,CAAC;QACtB,QAAQ,GAAG,UAAU,CAAC;QACtB,IAAI,CAAC;YACJ,OAAO,EAAE,EAAE,CAAC;QACb,CAAC;gBAAS,CAAC;YACV,QAAQ,GAAG,IAAI,CAAC;QACjB,CAAC;IACF,CAAC;IACD;;;OAGG;IACH,cAAc,CAAI,EAAW;QAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC;QACtB,QAAQ,GAAG,cAAc,CAAC;QAC1B,IAAI,CAAC;YACJ,OAAO,EAAE,EAAE,CAAC;QACb,CAAC;gBAAS,CAAC;YACV,QAAQ,GAAG,IAAI,CAAC;QACjB,CAAC;IACF,CAAC;CACD,CAAC"}
+{"version":3,"file":"caller-context.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/subagent/caller-context.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,kEAAkE;AAClE,4DAA4D;AAC5D,mBAAmB;AACnB,EAAE;AACF,qEAAqE;AACrE,wEAAwE;AACxE,0EAA0E;AAC1E,uEAAuE;AACvE,oEAAoE;AACpE,2BAA2B;AAC3B,EAAE;AACF,yEAAyE;AACzE,qEAAqE;AACrE,wEAAwE;AACxE,yBAAyB;AACzB,EAAE;AACF,2EAA2E;AAC3E,0EAA0E;AAC1E,mCAAmC;AACnC,EAAE;AACF,aAAa;AACb,8DAA8D;AAC9D,yDAAyD;AACzD,wDAAwD;AA8BxD,IAAI,QAAQ,GAAkB,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;AAEvD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IACjC,8EAA8E;IAC9E,GAAG;QACF,OAAO,QAAQ,CAAC;IACjB,CAAC;IACD,sCAAsC;IACtC,GAAG,CAAC,GAAkB;QACrB,QAAQ,GAAG,GAAG,CAAC;IAChB,CAAC;IACD;;;;OAIG;IACH,UAAU,CAAI,KAAgB,EAAE,EAAW;QAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC;QACtB,QAAQ,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QACvC,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,EAAE,EAAE,CAAC;YACjB,IAAI,GAAG,YAAY,OAAO,EAAE,CAAC;gBAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE;oBACvB,QAAQ,GAAG,IAAI,CAAC;gBACjB,CAAC,CAAiB,CAAC;YACpB,CAAC;YACD,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,GAAG,CAAC;QACZ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,GAAG,CAAC;QACX,CAAC;IACF,CAAC;IACD;;;OAGG;IACH,cAAc,CAAI,EAAW;QAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC;QACtB,QAAQ,GAAG,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QACpC,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,EAAE,EAAE,CAAC;YACjB,IAAI,GAAG,YAAY,OAAO,EAAE,CAAC;gBAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE;oBACvB,QAAQ,GAAG,IAAI,CAAC;gBACjB,CAAC,CAAiB,CAAC;YACpB,CAAC;YACD,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,GAAG,CAAC;QACZ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,GAAG,CAAC;QACX,CAAC;IACF,CAAC;CACD,CAAC"}

package/dist/extensions/forgecli/subagent/orchestrator-transcript.d.ts

@@ -0,0 +1,66 @@
+export type OrchestratorEvent = {
+    kind: "pipeline-start";
+    ts: string;
+    entityKind: "bug" | "task" | "sprint";
+    entityId: string;
+    sessionId?: string;
+} | {
+    kind: "phase-start";
+    ts: string;
+    phase: string;
+    phaseIndex: number;
+    phaseCount: number;
+    attempt: number;
+    workflowFile: string;
+    persona: string;
+} | {
+    kind: "phase-end";
+    ts: string;
+    phase: string;
+    phaseIndex: number;
+    attempt: number;
+    verdict: "approved" | "revision" | "n/a" | "error" | "cancelled" | "halted";
+    elapsedMs: number;
+    turns?: number;
+    toolCount?: number;
+    errCount?: number;
+    subagentTranscriptPath?: string;
+} | {
+    kind: "phase-loopback";
+    ts: string;
+    fromPhase: string;
+    toPhase: string;
+    fromPhaseIndex: number;
+    toPhaseIndex: number;
+    reason: string;
+} | {
+    kind: "pipeline-end";
+    ts: string;
+    outcome: "complete" | "halted" | "cancelled" | "error";
+    elapsedMs: number;
+    reason?: string;
+} | {
+    kind: "notify";
+    ts: string;
+    level: "info" | "warn" | "error" | "success";
+    message: string;
+};
+export interface OpenOrchestratorTranscriptOpts {
+    cwd: string;
+    entityKind: "bug" | "task" | "sprint";
+    entityId: string;
+    startedAt?: Date;
+    sessionId?: string;
+}
+export declare class OrchestratorTranscriptWriter {
+    readonly filePath: string;
+    readonly startedAt: Date;
+    private closed;
+    constructor(opts: OpenOrchestratorTranscriptOpts);
+    /**
+     * Append a single event to the JSONL log. Non-fatal on write failure —
+     * the orchestrator transcript is observability data, not load-bearing.
+     */
+    record(event: OrchestratorEvent): void;
+    close(outcome: "complete" | "halted" | "cancelled" | "error", reason?: string): void;
+}

package/dist/extensions/forgecli/subagent/orchestrator-transcript.js

@@ -0,0 +1,66 @@
+// orchestrator-transcript.ts — JSONL log of the orchestrator loop's own
+// activity (fix-bug, run-task, run-sprint). Sibling to the per-subagent
+// transcripts but captures what the orchestrator did between phases:
+// phase boundaries, verdicts, loop-backs, halt/cancel reasons.
+//
+// Filename mirrors the subagent-transcript scheme:
+//   .forge/transcripts/<entityId>/<ISO-compact>__<entityId>__orchestrator.jsonl
+//
+// JSONL (one JSON object per line) so we can append safely even if the
+// process crashes mid-stream. The reader stitches lines back together.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { formatTranscriptTimestamp } from "../forge-subagent.js";
+export class OrchestratorTranscriptWriter {
+    filePath;
+    startedAt;
+    closed = false;
+    constructor(opts) {
+        this.startedAt = opts.startedAt ?? new Date();
+        const base = path.join(opts.cwd, ".forge", "transcripts");
+        const sanitizedId = opts.entityId
+            .replace(/[^a-zA-Z0-9._-]/g, "_")
+            .replace(/\.{2,}/g, "_")
+            .slice(0, 80);
+        const dir = path.join(base, sanitizedId);
+        const ts = formatTranscriptTimestamp(this.startedAt);
+        const filename = `${ts}__${sanitizedId}__orchestrator.jsonl`;
+        this.filePath = path.join(dir, filename);
+        fs.mkdirSync(dir, { recursive: true });
+        this.record({
+            kind: "pipeline-start",
+            ts: this.startedAt.toISOString(),
+            entityKind: opts.entityKind,
+            entityId: opts.entityId,
+            sessionId: opts.sessionId,
+        });
+    }
+    /**
+     * Append a single event to the JSONL log. Non-fatal on write failure —
+     * the orchestrator transcript is observability data, not load-bearing.
+     */
+    record(event) {
+        if (this.closed)
+            return;
+        try {
+            fs.appendFileSync(this.filePath, `${JSON.stringify(event)}\n`, "utf-8");
+        }
+        catch (err) {
+            const e = err;
+            process.stderr.write(`[orchestrator-transcript] append failed (non-fatal): ${e.message ?? "unknown"}\n`);
+        }
+    }
+    close(outcome, reason) {
+        if (this.closed)
+            return;
+        this.record({
+            kind: "pipeline-end",
+            ts: new Date().toISOString(),
+            outcome,
+            elapsedMs: Date.now() - this.startedAt.getTime(),
+            reason,
+        });
+        this.closed = true;
+    }
+}
+//# sourceMappingURL=orchestrator-transcript.js.map

package/dist/extensions/forgecli/subagent/orchestrator-transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-transcript.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/subagent/orchestrator-transcript.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,wEAAwE;AACxE,qEAAqE;AACrE,+DAA+D;AAC/D,EAAE;AACF,mDAAmD;AACnD,gFAAgF;AAChF,EAAE;AACF,uEAAuE;AACvE,uEAAuE;AAEvE,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AA+CjE,MAAM,OAAO,4BAA4B;IAC/B,QAAQ,CAAS;IACjB,SAAS,CAAO;IACjB,MAAM,GAAG,KAAK,CAAC;IAEvB,YAAY,IAAoC;QAC/C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ;aAC/B,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC;aAChC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;aACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACzC,MAAM,EAAE,GAAG,yBAAyB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,GAAG,EAAE,KAAK,WAAW,sBAAsB,CAAC;QAC7D,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACzC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC;YACX,IAAI,EAAE,gBAAgB;YACtB,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;YAChC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;SACzB,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAwB;QAC9B,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC;YACJ,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,GAA2B,CAAC;YACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC,OAAO,IAAI,SAAS,IAAI,CAAC,CAAC;QAC1G,CAAC;IACF,CAAC;IAED,KAAK,CAAC,OAAsD,EAAE,MAAe;QAC5E,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,CAAC;YACX,IAAI,EAAE,cAAc;YACpB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,OAAO;YACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE;YAChD,MAAM;SACN,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACpB,CAAC;CACD"}

package/dist/extensions/forgecli/subagent/phase-guard.d.ts

@@ -0,0 +1,34 @@
+import type { PhaseRole } from "./caller-context.js";
+export declare class PhaseOwnershipError extends Error {
+    readonly toolName: string;
+    readonly callerPhase: PhaseRole | "orchestrator";
+    readonly attemptedPhase: string;
+    readonly hint: string;
+    constructor(toolName: string, callerPhase: PhaseRole | "orchestrator", attemptedPhase: string, hint?: string);
+}
+/**
+ * Assert that the calling subagent's phase context matches the phase
+ * named in the tool's arguments. From an orchestrator caller, this is
+ * a no-op. From a subagent caller with a mismatched phase, throws
+ * `PhaseOwnershipError`.
+ *
+ * @param toolName  Display name of the tool / subcommand for the error message.
+ * @param namedPhase The phase string passed to the tool (e.g. `--phase commit`
+ *                  or the `phase` positional arg of `set-bug-summary`).
+ */
+export declare function assertPhaseOwnership(toolName: string, namedPhase: string): void;
+/**
+ * Assert that a `forge_store update-status bug X status <statusValue>`
+ * call is permitted from the current caller context. Status transitions
+ * are owned by specific phases or by the orchestrator; calling outside
+ * the allowed set is rejected.
+ */
+export declare function assertBugStatusOwnership(toolName: string, statusValue: string): void;
+/**
+ * Phase-event emissions (`forge_store emit` with a phase token in the
+ * payload) are always orchestrator-owned per `meta-fix-bug.md § Iron
+ * Laws`. The orchestrator composes the canonical event from runtime
+ * telemetry plus the subagent's SUMMARY and emits it; subagents that
+ * call emit themselves hallucinate runtime facts.
+ */
+export declare function assertOrchestratorOnlyEmit(toolName: string): void;

package/dist/extensions/forgecli/subagent/phase-guard.js

@@ -0,0 +1,139 @@
+// phase-guard.ts — Defense-in-depth tool-layer enforcement that a
+// subagent only acts within its own phase (FORGE-BUG-040).
+//
+// Background: prior to the fix landed for FORGE-BUG-040, the triage
+// subagent received `fix_bug.md` (the orchestrator-only algorithm) as
+// its workflow body and silently executed the full lifecycle — preflight
+// for every phase, set-bug-summary for every phase, update-status bug
+// X status fixed. The root cause (forge-cli BUG_PHASES wiring + meta
+// source orchestrator-only-body) is fixed at those layers; this guard
+// catches future regressions of the same shape at the tool boundary
+// so they fail loudly with a structured error rather than silently
+// corrupting state.
+//
+// Rule (per BUG_FIX_PLAN.md § Per-tool guard rule):
+//   For any tool that names a phase (explicitly or implicitly), the
+//   tool's *named phase parameter* MUST equal the caller's `phase`
+//   tag when called from a subagent context. From an orchestrator
+//   context, the guard is a no-op.
+//
+// Phase ↔ summary-key mapping for set-bug-summary / set-summary is
+// imported from the canonical phase-summary-map.ts. The guard does NOT
+// duplicate the mapping inline — a divergence between the runtime guard
+// and the dispatcher's summary writes would be undetectable otherwise.
+//
+// Iron Laws:
+//   IL1 — code only under forge-cli/src/extensions/forgecli/.
+//   IL7 — every refusal path throws PhaseOwnershipError (no silent
+//         continuation past a guard failure).
+import { CallerContextStore } from "./caller-context.js";
+import { BUG_SUMMARY_KEY_BY_ROLE } from "./phase-summary-map.js";
+/**
+ * Bug-status transitions that may only be written by a specific phase
+ * (subagent caller) or by the orchestrator. Used by the guard for
+ * `forge_store update-status bug X status ...` calls.
+ */
+const BUG_STATUS_OWNERSHIP = {
+    // commit phase makes the git commit then transitions bug.status to fixed
+    fixed: { allowedSubagentPhases: ["commit"], orchestratorAllowed: true },
+    // triaged and in-progress are orchestrator-only transitions
+    triaged: { allowedSubagentPhases: [], orchestratorAllowed: true },
+    "in-progress": { allowedSubagentPhases: [], orchestratorAllowed: true },
+    // escalation paths — allowed from orchestrator OR the current phase
+    // (the calling subagent is in some phase; escalation is in-band)
+    escalated: { allowedSubagentPhases: [], orchestratorAllowed: true, anySubagent: true },
+    blocked: { allowedSubagentPhases: [], orchestratorAllowed: true, anySubagent: true },
+    abandoned: { allowedSubagentPhases: [], orchestratorAllowed: true, anySubagent: true },
+};
+export class PhaseOwnershipError extends Error {
+    toolName;
+    callerPhase;
+    attemptedPhase;
+    hint;
+    constructor(toolName, callerPhase, attemptedPhase, hint = "") {
+        super(`phase-ownership: subagent in phase '${callerPhase}' attempted ${toolName} for phase '${attemptedPhase}'` +
+            (hint ? ` — ${hint}` : ""));
+        this.name = "PhaseOwnershipError";
+        this.toolName = toolName;
+        this.callerPhase = callerPhase;
+        this.attemptedPhase = attemptedPhase;
+        this.hint = hint;
+    }
+}
+/**
+ * Assert that the calling subagent's phase context matches the phase
+ * named in the tool's arguments. From an orchestrator caller, this is
+ * a no-op. From a subagent caller with a mismatched phase, throws
+ * `PhaseOwnershipError`.
+ *
+ * @param toolName  Display name of the tool / subcommand for the error message.
+ * @param namedPhase The phase string passed to the tool (e.g. `--phase commit`
+ *                  or the `phase` positional arg of `set-bug-summary`).
+ */
+export function assertPhaseOwnership(toolName, namedPhase) {
+    const caller = CallerContextStore.get();
+    if (caller.kind === "orchestrator")
+        return;
+    // set-bug-summary / set-summary callers pass the legacy summary-key
+    // (e.g. "implementation") rather than the PhaseRole (e.g. "implement").
+    // Always route through the summary-key path for these tools — a
+    // direct-name match (caller.phase === namedPhase) would falsely allow
+    // a commit-phase caller to call `set-bug-summary <bug> commit ...` even
+    // though commit writes no summary at all.
+    const isSummaryTool = toolName.includes("set-bug-summary") || toolName.includes("set-summary");
+    if (!isSummaryTool && caller.phase === namedPhase)
+        return;
+    if (isSummaryTool) {
+        const expectedKey = BUG_SUMMARY_KEY_BY_ROLE[caller.phase];
+        if (expectedKey === null) {
+            throw new PhaseOwnershipError(toolName, caller.phase, namedPhase, `phase '${caller.phase}' writes no summary — set-bug-summary is forbidden from this phase`);
+        }
+        if (expectedKey === undefined) {
+            throw new PhaseOwnershipError(toolName, caller.phase, namedPhase, `phase '${caller.phase}' is not a recognised bug-mode phase`);
+        }
+        if (expectedKey !== namedPhase) {
+            throw new PhaseOwnershipError(toolName, caller.phase, namedPhase, `expected summary key '${expectedKey}' for caller phase`);
+        }
+        return;
+    }
+    throw new PhaseOwnershipError(toolName, caller.phase, namedPhase);
+}
+/**
+ * Assert that a `forge_store update-status bug X status <statusValue>`
+ * call is permitted from the current caller context. Status transitions
+ * are owned by specific phases or by the orchestrator; calling outside
+ * the allowed set is rejected.
+ */
+export function assertBugStatusOwnership(toolName, statusValue) {
+    const caller = CallerContextStore.get();
+    const rule = BUG_STATUS_OWNERSHIP[statusValue];
+    if (!rule) {
+        // Unknown status — let downstream schema validation reject it
+        // with its own (more informative) error.
+        return;
+    }
+    if (caller.kind === "orchestrator") {
+        if (rule.orchestratorAllowed)
+            return;
+        throw new PhaseOwnershipError(toolName, "orchestrator", `update-status bug ${statusValue}`, "this status transition is not orchestrator-allowed");
+    }
+    if (rule.anySubagent)
+        return;
+    if (rule.allowedSubagentPhases.includes(caller.phase))
+        return;
+    throw new PhaseOwnershipError(toolName, caller.phase, `update-status bug ${statusValue}`, `status '${statusValue}' may only be written from phase(s): ${rule.allowedSubagentPhases.join(", ") || "(orchestrator only)"}`);
+}
+/**
+ * Phase-event emissions (`forge_store emit` with a phase token in the
+ * payload) are always orchestrator-owned per `meta-fix-bug.md § Iron
+ * Laws`. The orchestrator composes the canonical event from runtime
+ * telemetry plus the subagent's SUMMARY and emits it; subagents that
+ * call emit themselves hallucinate runtime facts.
+ */
+export function assertOrchestratorOnlyEmit(toolName) {
+    const caller = CallerContextStore.get();
+    if (caller.kind === "orchestrator")
+        return;
+    throw new PhaseOwnershipError(toolName, caller.phase, "emit (phase event)", "phase event emission is orchestrator-only — subagents write SUMMARY files and return");
+}
+//# sourceMappingURL=phase-guard.js.map