@entelligentsia/forgecli 0.6.6 → 0.7.7

package/dist/extensions/forgecli/hook-dispatcher.d.ts

@@ -1,4 +1,56 @@
-import type { ExtensionAPI } from "@entelligentsia/pi-coding-agent";
+import type { ExtensionAPI, ExtensionCommandContext } from "@entelligentsia/pi-coding-agent";
+/** Payload for the init-complete synthetic event. */
+export interface InitCompleteEvent {
+    type: "init-complete";
+    /** Project prefix from .forge/config.json project.prefix */
+    projectPrefix: string;
+    /** Absolute path to the project root (process.cwd() at init time). */
+    cwd: string;
+}
+/**
+ * Payload for the sprint-collate-complete synthetic event (FORGE-S21-T05).
+ *
+ * Emitted by run-sprint.ts after the sprint's collate phase completes
+ * successfully. Consumed by hooks/post-sprint-hook.ts to trigger
+ * /forge:enhance --phase 2.
+ *
+ * Sprint-ID shape gate: `^[A-Z]+-S\d+$` — bug IDs (FORGE-BUG-015,
+ * BUG-031, etc.) are excluded so bug-fix collate runs do NOT trigger
+ * sprint-level enhancement. Parity with forge/forge/hooks/post-sprint.cjs
+ * trigger regex `\S*-S\d+`.
+ */
+export interface SprintCollateCompleteEvent {
+    type: "sprint-collate-complete";
+    /** Sprint ID — must match ^[A-Z]+-S\d+$ */
+    sprintId: string;
+    /** Absolute path to the project root (process.cwd() at emit time). */
+    cwd: string;
+}
+/** Union of all synthetic event payloads. Extend here as new events are added. */
+export type SyntheticEvent = InitCompleteEvent | SprintCollateCompleteEvent;
+/**
+ * Handler signature for synthetic events.
+ * ctx is the ExtensionCommandContext of the emitting phase — callers must
+ * forward the context object they received from pi at handler invocation time.
+ */
+export type SyntheticEventHandler<T extends SyntheticEvent = SyntheticEvent> = (event: T, ctx: ExtensionCommandContext) => void | Promise<void>;
+/**
+ * Register a handler for a synthetic event type.
+ * Handlers are called in registration order when emitSyntheticEvent fires.
+ * Exported for use by hooks/post-init-hook.ts and future hook modules.
+ */
+export declare function onSyntheticEvent<T extends SyntheticEvent>(eventType: T["type"], handler: SyntheticEventHandler<T>): void;
+/**
+ * Emit a synthetic event, invoking all registered handlers sequentially.
+ * Each handler error is caught and logged to stderr (fail-open) — a
+ * misbehaving hook MUST NOT block the emitting phase.
+ */
+export declare function emitSyntheticEvent(event: SyntheticEvent, ctx: ExtensionCommandContext): Promise<void>;
+/**
+ * Reset the synthetic handler registry.
+ * Exported for use in unit tests — do NOT call in production code.
+ */
+export declare function _resetSyntheticHandlers(): void;
 /** Parsed representation of a store-cli invocation intercepted from a bash command. */
 export interface StoreCLICall {
     /** Subcommand: write or update-status */

package/dist/extensions/forgecli/hook-dispatcher.js

@@ -1,10 +1,13 @@
-// Pi-runtime hook adapter — FORGE-S18-T02 / FORGE-S18-T03
+// Pi-runtime hook adapter — FORGE-S18-T02 / FORGE-S18-T03 / FORGE-S21-T04
 //
 // Wires Forge's hook semantics onto pi's tool_call / tool_result events.
 // T02: Provides audit-only observation scaffolding.
 // T03: Adds enforcement — validates store-cli write payloads via store-validator,
 //      checks status transitions via transition-guard, and blocks on violation
 //      by returning { block: true, reason } from the tool_call handler.
+// T04: Adds typed synthetic event taxonomy (InitCompleteEvent) with
+//      onSyntheticEvent / emitSyntheticEvent for in-process hook dispatch
+//      that bridges deterministic TS handler phases to registered hook handlers.
 //
 // Audit logging: set FORGE_HOOK_AUDIT=1 to write to .forge/logs/hooks.log.
 // In enforcement mode (default): violations are blocked.
@@ -19,6 +22,49 @@ import { isToolCallEventType } from "@entelligentsia/pi-coding-agent";
 import { checkTwoLayerBoundary } from "./hooks/two-layer-guard.js";
 import { validateStoreCLIPayload } from "./store-validator.js";
 import { checkTransition } from "./transition-guard.js";
+// Module-level registry. Pi extension processes are single-session; the
+// registry lives for the lifetime of the process.
+const _syntheticHandlers = new Map();
+/**
+ * Register a handler for a synthetic event type.
+ * Handlers are called in registration order when emitSyntheticEvent fires.
+ * Exported for use by hooks/post-init-hook.ts and future hook modules.
+ */
+export function onSyntheticEvent(eventType, handler) {
+    const existing = _syntheticHandlers.get(eventType) ?? [];
+    existing.push(handler);
+    _syntheticHandlers.set(eventType, existing);
+}
+/**
+ * Emit a synthetic event, invoking all registered handlers sequentially.
+ * Each handler error is caught and logged to stderr (fail-open) — a
+ * misbehaving hook MUST NOT block the emitting phase.
+ */
+export async function emitSyntheticEvent(event, ctx) {
+    const handlers = _syntheticHandlers.get(event.type) ?? [];
+    for (const handler of handlers) {
+        try {
+            await handler(event, ctx);
+        }
+        catch (err) {
+            // Fail-open: log to stderr, never propagate.
+            const msg = err instanceof Error ? err.message : String(err);
+            try {
+                process.stderr.write(`[hook-dispatcher] synthetic event handler error (${event.type}): ${msg}\n`);
+            }
+            catch {
+                // even stderr write failing should not crash the process
+            }
+        }
+    }
+}
+/**
+ * Reset the synthetic handler registry.
+ * Exported for use in unit tests — do NOT call in production code.
+ */
+export function _resetSyntheticHandlers() {
+    _syntheticHandlers.clear();
+}
 // ── Internal helpers ──────────────────────────────────────────────────────────
 function auditEnabled() {
     return process.env.FORGE_HOOK_AUDIT === "1";

package/dist/extensions/forgecli/hook-dispatcher.js.map

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

package/dist/extensions/forgecli/hooks/post-init-hook.d.ts

@@ -0,0 +1,15 @@
+import type { ExtensionAPI, ExtensionCommandContext } from "@entelligentsia/pi-coding-agent";
+import { type InitCompleteEvent } from "../hook-dispatcher.js";
+/** Payload for the init-complete synthetic event (alias for test imports). */
+export type InitCompleteEventPayload = InitCompleteEvent;
+/**
+ * Create the init-complete handler bound to the given pi ExtensionAPI.
+ * Exported for unit testing — production code calls registerPostInitHook.
+ */
+export declare function createPostInitHookHandler(pi: ExtensionAPI): (event: InitCompleteEvent, ctx: ExtensionCommandContext) => Promise<void>;
+/**
+ * Register the post-init hook handler on the `init-complete` synthetic event.
+ * MUST be called BEFORE registerForgeInit in index.ts to prevent the
+ * emit-before-consumer race described in SPRINT_REQUIREMENTS.md §Risks row 3.
+ */
+export declare function registerPostInitHook(pi: ExtensionAPI): void;

package/dist/extensions/forgecli/hooks/post-init-hook.js

@@ -0,0 +1,127 @@
+// hooks/post-init-hook.ts — Post-init enhancement auto-trigger (FORGE-S21-T04).
+//
+// Fires `/forge:enhance --phase 1 --auto` after each successful `/forge:init`
+// Phase 4 closure. The handler is registered on the synthetic `init-complete`
+// event emitted by forge-init.ts.
+//
+// Plugin parity reference: forge/forge/hooks/post-init.cjs (read-only — do NOT edit).
+//
+// Behaviour:
+//   1. Check idempotency sentinel `.forge/cache/post-init-fired-<prefix>.json`.
+//      If present: notify "already fired" and return.
+//   2. Load `.forge/workflows/enhance.md` and run the Pack-06 materialization
+//      marker check. If any marker is missing: notify "workflow regression" and
+//      return without dispatching (init already succeeded — this is post-init).
+//   3. assertAudience: meta-enhance is orchestrator-only. Because the hook runs
+//      from the init orchestrator context, CallerContextStore.get() returns
+//      "orchestrator" → check passes. If the check fails (future pi evolution),
+//      notify and return without dispatching.
+//   4. Write sentinel BEFORE dispatching (fail-open: if dispatch fails, the
+//      sentinel prevents re-fire flooding).
+//   5. sendKickoff "/forge:enhance --phase 1 --auto". If this throws: catch,
+//      notify error, do NOT re-throw (init must still report success).
+//
+// Iron Laws:
+//   IL1 — code only under forge-cli/src/extensions/forgecli/.
+//   IL6 — no shell-string interpolation; no spawn calls.
+//   IL7 — every failure path emits ctx.ui.notify and returns; no silent
+//         continuation past a gate failure.
+//   AC#8 — NO ctx.ui.input/select. NO raw fs.writeFile to .forge/store/.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { assertAudience } from "../audience-gate.js";
+import { sendKickoff } from "../kickoff.js";
+import { checkMaterialization } from "../enhance.js";
+import { onSyntheticEvent } from "../hook-dispatcher.js";
+import { loadWorkflow, WorkflowLoaderError } from "../loaders/workflow-loader.js";
+// ── Sentinel helpers ──────────────────────────────────────────────────────────
+function sentinelPath(cwd, projectPrefix) {
+    return path.join(cwd, ".forge", "cache", `post-init-fired-${projectPrefix}.json`);
+}
+function readSentinel(sentinel) {
+    return fs.existsSync(sentinel);
+}
+function writeSentinel(sentinel, projectPrefix) {
+    try {
+        const dir = path.dirname(sentinel);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(sentinel, JSON.stringify({ firedAt: new Date().toISOString(), projectPrefix }, null, 2) + "\n", "utf8");
+    }
+    catch {
+        // Non-fatal: if write fails the sentinel won't prevent re-fire.
+        // The worst case is a redundant enhance run — acceptable.
+    }
+}
+// ── Handler factory ───────────────────────────────────────────────────────────
+const WORKFLOW_REL_PATH = path.join(".forge", "workflows", "enhance.md");
+/**
+ * Create the init-complete handler bound to the given pi ExtensionAPI.
+ * Exported for unit testing — production code calls registerPostInitHook.
+ */
+export function createPostInitHookHandler(pi) {
+    return async function postInitHookHandler(event, ctx) {
+        const { projectPrefix, cwd } = event;
+        // 1. Idempotency sentinel
+        const sentinel = sentinelPath(cwd, projectPrefix);
+        if (readSentinel(sentinel)) {
+            ctx.ui.notify(`post-init already fired for ${projectPrefix}, skipping`, "info");
+            return;
+        }
+        // 2. Load and marker-check the enhance workflow
+        const workflowPath = path.join(cwd, WORKFLOW_REL_PATH);
+        let workflowMd;
+        let workflowAudience;
+        try {
+            const loaded = loadWorkflow(workflowPath);
+            workflowMd = loaded.rawMarkdown;
+            workflowAudience = loaded.audience;
+        }
+        catch (err) {
+            if (err instanceof WorkflowLoaderError && err.code === "missing_file") {
+                ctx.ui.notify(`× post-init hook: enhance workflow not found at ${WORKFLOW_REL_PATH}; ` +
+                    "run /forge:init or /forge:regenerate first. Skipping phase-1 enhance.", "info");
+            }
+            else {
+                const e = err;
+                ctx.ui.notify(`× post-init hook: failed to load enhance workflow: ${e.message ?? "unknown"}`, "error");
+            }
+            return;
+        }
+        const markerCheck = checkMaterialization(workflowPath, workflowMd);
+        if (!markerCheck.ok) {
+            for (const marker of markerCheck.missing) {
+                ctx.ui.notify(`× workflow regression: ${marker} not found in ${workflowPath}`, "error");
+            }
+            return;
+        }
+        // 3. Audience check — meta-enhance is orchestrator-only
+        // assertAudience reads CallerContextStore which defaults to "orchestrator"
+        // from the init handler context. Wrapped in CallerContextStore.asSubagent
+        // is NOT needed here — we ARE the orchestrator calling it, not a subagent.
+        if (!assertAudience({ workflowName: "enhance", audience: workflowAudience }, ctx)) {
+            // Error notification already emitted by assertAudience.
+            return;
+        }
+        // 4. Write sentinel BEFORE dispatch (fail-open on dispatch error)
+        writeSentinel(sentinel, projectPrefix);
+        // 5. Dispatch /forge:enhance --phase 1 --auto (best-effort, fail-open)
+        try {
+            sendKickoff(pi, "/forge:enhance --phase 1 --auto");
+        }
+        catch (err) {
+            const e = err;
+            ctx.ui.notify(`× post-init hook: failed to trigger /forge:enhance --phase 1 --auto: ${e.message ?? "unknown"}`, "error");
+            // Do NOT re-throw — /forge:init must still report success.
+        }
+    };
+}
+// ── Registration ──────────────────────────────────────────────────────────────
+/**
+ * Register the post-init hook handler on the `init-complete` synthetic event.
+ * MUST be called BEFORE registerForgeInit in index.ts to prevent the
+ * emit-before-consumer race described in SPRINT_REQUIREMENTS.md §Risks row 3.
+ */
+export function registerPostInitHook(pi) {
+    onSyntheticEvent("init-complete", createPostInitHookHandler(pi));
+}
+//# sourceMappingURL=post-init-hook.js.map

package/dist/extensions/forgecli/hooks/post-init-hook.js.map

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

package/dist/extensions/forgecli/hooks/post-sprint-hook.d.ts

@@ -0,0 +1,37 @@
+import type { ExtensionAPI, ExtensionCommandContext } from "@entelligentsia/pi-coding-agent";
+import { type SprintCollateCompleteEvent } from "../hook-dispatcher.js";
+/** Payload for the sprint-collate-complete synthetic event (alias for test imports). */
+export type SprintCollateCompleteEventPayload = SprintCollateCompleteEvent;
+/**
+ * Sprint-ID shape gate. Bug IDs like `FORGE-BUG-015` or `BUG-031` do NOT
+ * match — they lack the `-S\d+` suffix. Parity with plugin post-sprint.cjs.
+ *
+ * Pattern requires:
+ *   - One or more uppercase letters (e.g. FORGE, PROJECT)
+ *   - Literal `-S`
+ *   - One or more digits (sprint number)
+ *
+ * Examples:
+ *   FORGE-S21       → matches (sprint)
+ *   PROJECT-S3      → matches (sprint)
+ *   FORGE-BUG-015   → no match (bug ID)
+ *   BUG-031         → no match (bug ID — no uppercase prefix before -S)
+ *   FORGE-BUG-S21   → no match (segment before -S\d+ must be first after prefix)
+ *
+ * Note: plugin regex `\S*-S\d+` is anchored by the collate.cjs trigger context;
+ * in the synthetic event path we have the sprintId directly so we can apply a
+ * stricter full-string match.
+ */
+export declare const SPRINT_ID_REGEX: RegExp;
+export declare function isSprintId(id: string): boolean;
+/**
+ * Create the sprint-collate-complete handler bound to the given pi ExtensionAPI.
+ * Exported for unit testing — production code calls registerPostSprintHook.
+ */
+export declare function createPostSprintHookHandler(pi: ExtensionAPI): (event: SprintCollateCompleteEvent, ctx: ExtensionCommandContext) => Promise<void>;
+/**
+ * Register the post-sprint hook handler on the `sprint-collate-complete`
+ * synthetic event. MUST be called BEFORE registerRunSprint in index.ts to
+ * prevent the emit-before-consumer race.
+ */
+export declare function registerPostSprintHook(pi: ExtensionAPI): void;

package/dist/extensions/forgecli/hooks/post-sprint-hook.js

@@ -0,0 +1,166 @@
+// hooks/post-sprint-hook.ts — Post-sprint enhancement auto-trigger (FORGE-S21-T05).
+//
+// Fires `/forge:enhance --phase 2` after each successful sprint collate phase.
+// The handler is registered on the synthetic `sprint-collate-complete` event
+// emitted by run-sprint.ts after the sprint's collate completes.
+//
+// Plugin parity reference: forge/forge/hooks/post-sprint.cjs (read-only — do NOT edit).
+//
+// Parity contract:
+//   - Filter regex `^[A-Z]+-S\d+$` excludes bug IDs (FORGE-BUG-015, BUG-031, etc.)
+//     matching the plugin's trigger regex `\S*-S\d+` which also requires the
+//     sprint-ID shape. Bug-fix collate runs must NOT trigger sprint enhancement.
+//   - Idempotency sentinel per sprint: `.forge/cache/post-sprint-<id>-enhancement-triggered`
+//     (mirrors plugin sentinel naming).
+//   - Fail-open: error in any step → ctx.ui.notify, return without throwing.
+//
+// Behaviour:
+//   1. Validate sprint-ID regex gate `^[A-Z]+-S\d+$`. Bug IDs filtered out;
+//      handler notifies and returns without dispatching.
+//   2. Check idempotency sentinel `.forge/cache/post-sprint-<id>-enhancement-triggered`.
+//      If present: notify "already fired" and return.
+//   3. Load `.forge/workflows/enhance.md` and run the Pack-06 materialization
+//      marker check. If any marker is missing: notify "workflow regression" and
+//      return without dispatching.
+//   4. assertAudience: meta-enhance is orchestrator-only. Hook runs from the
+//      run-sprint orchestrator context → CallerContextStore returns "orchestrator"
+//      → check passes.
+//   5. Write sentinel BEFORE dispatching (fail-open: if dispatch fails, the
+//      sentinel prevents re-fire flooding).
+//   6. sendKickoff "/forge:enhance --phase 2". If this throws: catch, notify
+//      error, do NOT re-throw (sprint must still report success).
+//
+// Iron Laws:
+//   IL1 — code only under forge-cli/src/extensions/forgecli/.
+//   IL6 — no shell-string interpolation; no spawn calls.
+//   IL7 — every failure path emits ctx.ui.notify and returns; no silent
+//         continuation past a gate failure.
+//   AC#8 — NO ctx.ui.input/select. NO raw fs.writeFile to .forge/store/.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { assertAudience } from "../audience-gate.js";
+import { sendKickoff } from "../kickoff.js";
+import { checkMaterialization } from "../enhance.js";
+import { onSyntheticEvent } from "../hook-dispatcher.js";
+import { loadWorkflow, WorkflowLoaderError } from "../loaders/workflow-loader.js";
+// ── Sprint-ID regex gate ──────────────────────────────────────────────────────
+/**
+ * Sprint-ID shape gate. Bug IDs like `FORGE-BUG-015` or `BUG-031` do NOT
+ * match — they lack the `-S\d+` suffix. Parity with plugin post-sprint.cjs.
+ *
+ * Pattern requires:
+ *   - One or more uppercase letters (e.g. FORGE, PROJECT)
+ *   - Literal `-S`
+ *   - One or more digits (sprint number)
+ *
+ * Examples:
+ *   FORGE-S21       → matches (sprint)
+ *   PROJECT-S3      → matches (sprint)
+ *   FORGE-BUG-015   → no match (bug ID)
+ *   BUG-031         → no match (bug ID — no uppercase prefix before -S)
+ *   FORGE-BUG-S21   → no match (segment before -S\d+ must be first after prefix)
+ *
+ * Note: plugin regex `\S*-S\d+` is anchored by the collate.cjs trigger context;
+ * in the synthetic event path we have the sprintId directly so we can apply a
+ * stricter full-string match.
+ */
+export const SPRINT_ID_REGEX = /^[A-Z]+-S\d+$/;
+export function isSprintId(id) {
+    return SPRINT_ID_REGEX.test(id);
+}
+// ── Sentinel helpers ──────────────────────────────────────────────────────────
+function sentinelPath(cwd, sprintId) {
+    return path.join(cwd, ".forge", "cache", `post-sprint-${sprintId}-enhancement-triggered`);
+}
+function readSentinel(sentinel) {
+    return fs.existsSync(sentinel);
+}
+function writeSentinel(sentinel, sprintId) {
+    try {
+        const dir = path.dirname(sentinel);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(sentinel, JSON.stringify({ firedAt: new Date().toISOString(), sprintId }, null, 2) + "\n", "utf8");
+    }
+    catch {
+        // Non-fatal: if write fails the sentinel won't prevent re-fire.
+        // The worst case is a redundant enhance run — acceptable.
+    }
+}
+// ── Handler factory ───────────────────────────────────────────────────────────
+const WORKFLOW_REL_PATH = path.join(".forge", "workflows", "enhance.md");
+/**
+ * Create the sprint-collate-complete handler bound to the given pi ExtensionAPI.
+ * Exported for unit testing — production code calls registerPostSprintHook.
+ */
+export function createPostSprintHookHandler(pi) {
+    return async function postSprintHookHandler(event, ctx) {
+        const { sprintId, cwd } = event;
+        // 1. Sprint-ID regex gate — filter out bug IDs
+        if (!isSprintId(sprintId)) {
+            ctx.ui.notify(`post-sprint hook: sprintId "${sprintId}" does not match sprint-ID shape ` +
+                `(^[A-Z]+-S\\d+$); skipping enhance trigger (bug-fix collate, not sprint collate).`, "info");
+            return;
+        }
+        // 2. Idempotency sentinel
+        const sentinel = sentinelPath(cwd, sprintId);
+        if (readSentinel(sentinel)) {
+            ctx.ui.notify(`post-sprint already fired for ${sprintId}, skipping`, "info");
+            return;
+        }
+        // 3. Load and marker-check the enhance workflow
+        const workflowPath = path.join(cwd, WORKFLOW_REL_PATH);
+        let workflowMd;
+        let workflowAudience;
+        try {
+            const loaded = loadWorkflow(workflowPath);
+            workflowMd = loaded.rawMarkdown;
+            workflowAudience = loaded.audience;
+        }
+        catch (err) {
+            if (err instanceof WorkflowLoaderError && err.code === "missing_file") {
+                ctx.ui.notify(`× post-sprint hook: enhance workflow not found at ${WORKFLOW_REL_PATH}; ` +
+                    "run /forge:init or /forge:regenerate first. Skipping phase-2 enhance.", "info");
+            }
+            else {
+                const e = err;
+                ctx.ui.notify(`× post-sprint hook: failed to load enhance workflow: ${e.message ?? "unknown"}`, "error");
+            }
+            return;
+        }
+        const markerCheck = checkMaterialization(workflowPath, workflowMd);
+        if (!markerCheck.ok) {
+            for (const marker of markerCheck.missing) {
+                ctx.ui.notify(`× workflow regression: ${marker} not found in ${workflowPath}`, "error");
+            }
+            return;
+        }
+        // 4. Audience check — meta-enhance is orchestrator-only
+        // assertAudience reads CallerContextStore which defaults to "orchestrator"
+        // from the run-sprint orchestrator context.
+        if (!assertAudience({ workflowName: "enhance", audience: workflowAudience }, ctx)) {
+            // Error notification already emitted by assertAudience.
+            return;
+        }
+        // 5. Write sentinel BEFORE dispatch (fail-open on dispatch error)
+        writeSentinel(sentinel, sprintId);
+        // 6. Dispatch /forge:enhance --phase 2 (best-effort, fail-open)
+        try {
+            sendKickoff(pi, "/forge:enhance --phase 2");
+        }
+        catch (err) {
+            const e = err;
+            ctx.ui.notify(`× post-sprint hook: failed to trigger /forge:enhance --phase 2: ${e.message ?? "unknown"}`, "error");
+            // Do NOT re-throw — sprint must still report success.
+        }
+    };
+}
+// ── Registration ──────────────────────────────────────────────────────────────
+/**
+ * Register the post-sprint hook handler on the `sprint-collate-complete`
+ * synthetic event. MUST be called BEFORE registerRunSprint in index.ts to
+ * prevent the emit-before-consumer race.
+ */
+export function registerPostSprintHook(pi) {
+    onSyntheticEvent("sprint-collate-complete", createPostSprintHookHandler(pi));
+}
+//# sourceMappingURL=post-sprint-hook.js.map

package/dist/extensions/forgecli/hooks/post-sprint-hook.js.map

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

package/dist/extensions/forgecli/index.js

@@ -38,8 +38,18 @@ import { registerUsageHook } from "./usage-hook.js";
 import { registerReadCommand } from "./read-command.js";
 import { registerRunTask } from "./run-task.js";
 import { registerRunSprint } from "./run-sprint.js";
+import { registerFixBug } from "./fix-bug.js";
+import { registerReviewPlan } from "./review-plan.js";
+import { registerReviewCode } from "./review-code.js";
+import { registerApprove } from "./approve.js";
+import { registerCommit } from "./commit.js";
+import { registerValidate } from "./validate.js";
+import { registerCollate } from "./collate.js";
 import { registerTestOrchestrate } from "./test-orchestrate.js";
 import { registerThreadSwitcher } from "./thread-switcher.js";
+import { registerRunWorkflow } from "./wf-engine/register.js";
+import { registerPostInitHook } from "./hooks/post-init-hook.js";
+import { registerPostSprintHook } from "./hooks/post-sprint-hook.js";
 // Resolve the vendored prompts directory at module load. After build, this
 // file lives at <pkg>/dist/extensions/forgecli/index.js — go up three levels
 // to <pkg>/, then into prompts/. In the source tree (vitest runs raw .ts), the
@@ -94,6 +104,18 @@ export default async function forgecli(pi) {
             return { systemPrompt: `${orientation}\n${existing}` };
         });
     }
+    // ── post-init hook (FORGE-S21-T04) ───────────────────────────────────────
+    // Registered BEFORE registerForgeInit to prevent emit-before-consumer race.
+    // The hook fires after Phase 4 closure via the `init-complete` synthetic
+    // event and triggers /forge:enhance --phase 1 --auto with idempotency.
+    registerPostInitHook(pi);
+    // ── post-sprint hook (FORGE-S21-T05) ─────────────────────────────────────
+    // Registered BEFORE registerRunSprint to prevent emit-before-consumer race.
+    // The hook fires after sprint collate phase via the `sprint-collate-complete`
+    // synthetic event and triggers /forge:enhance --phase 2 with idempotency.
+    // Sprint-ID regex gate ^[A-Z]+-S\d+$ prevents bug-fix collate runs from
+    // triggering sprint-level enhancement.
+    registerPostSprintHook(pi);
     // ── Unconditional /forge:init (AC#4) ─────────────────────────────────────
     // Full 4-phase implementation — FORGE-S17-T02.
     // Banner suppression: outside-Forge banner below only fires when
@@ -113,15 +135,19 @@ export default async function forgecli(pi) {
     // Spawns an in-process pi AgentSession via runForgeSubagent and delegates
     // the user-supplied prompt. Multi-turn allowed. Status updates streamed.
     registerTestOrchestrate(pi);
-    // ── Ensure forge-dark is in ~/.pi/agent/themes/ (global custom theme dir) ─
+    // ── Install bundled themes into ~/.pi/agent/themes/ ──────────────────────
     // Themes in that directory are loaded by pi BEFORE initTheme() runs, so
-    // setTheme("forge-dark") will reliably find it by name in session_start.
-    const forgeDarkSrc = path.join(PKG_ROOT, "themes", "forge-dark.json");
+    // pi's /settings > theme picker lists them and setTheme(name) finds them
+    // by name in session_start. We ship one or more JSON themes under
+    // forge-cli/themes/ and copy each one into the global theme directory.
+    const bundledThemesDir = path.join(PKG_ROOT, "themes");
     const globalThemesDir = path.join(getAgentDir(), "themes");
-    const forgeDarkDest = path.join(globalThemesDir, "forge-dark.json");
     try {
         fs.mkdirSync(globalThemesDir, { recursive: true });
-        fs.copyFileSync(forgeDarkSrc, forgeDarkDest);
+        const themeFiles = fs.readdirSync(bundledThemesDir).filter((f) => f.endsWith(".json"));
+        for (const file of themeFiles) {
+            fs.copyFileSync(path.join(bundledThemesDir, file), path.join(globalThemesDir, file));
+        }
     }
     catch {
         // Non-fatal — theme install skipped, fall back to default
@@ -272,6 +298,31 @@ export default async function forgecli(pi) {
     // Registered BEFORE registerAllForgeCommands so the real handler takes
     // precedence over the auto-stub from the command .md.
     registerRunSprint(pi);
+    // ── /forge:fix-bug native Orchestrator handler (FORGE-S21-T07) ────
+    // Bug-level orchestrator: chains triage → plan-fix → review-plan →
+    // implement → review-code → approve → commit via runForgeSubagent (IL10).
+    // Registered BEFORE registerAllForgeCommands so the real handler takes
+    // precedence over the auto-stub from the command .md.
+    registerFixBug(pi);
+    // ── Chain sub-workflow Kickoff Shims (FORGE-S21-T10) ─────────────────────
+    // Six native kickoff handlers replacing auto-generated stubs. Each is a
+    // Kickoff Shim (Pack-04 + Pack-06): reads the materialized workflow, runs
+    // marker checks, assertAudience, then sendKickoff. Standalone invocations
+    // of subagent-only workflows (review-plan, review-code, approve, commit,
+    // validate) receive audience refusal — this IS the contract.
+    // Orchestrator chains (run-task, run-sprint, fix-bug) MUST NOT route
+    // through these handlers — they dispatch via runForgeSubagent directly (IL10).
+    // Registered BEFORE registerAllForgeCommands so real handlers take precedence.
+    registerReviewPlan(pi);
+    registerReviewCode(pi);
+    registerApprove(pi);
+    registerCommit(pi);
+    registerValidate(pi);
+    registerCollate(pi);
+    // ── /forge:run-workflow generic workflow engine (Plan 14) ────────────────
+    // Resolution order: CWD/workflows/<id> first (user-authored workflows),
+    // then bundled PKG_ROOT/workflows/<id> (shipped examples). Registered unconditionally.
+    registerRunWorkflow(pi, { cwd: process.cwd(), bundledWorkflowsDir: path.join(PKG_ROOT, "workflows") });
     // ── /forge:threads native handler ────────────────────────────────────────
     // Single-viewport thread switcher: one-row chip strip below the editor.
     // ↓ from the editor activates it; ←→ navigate, Enter focuses a chip into