@supaku/agentfactory-nextjs 0.7.9 → 0.7.11

package/dist/src/index.d.ts

@@ -20,6 +20,7 @@ export { verifyCronAuth } from './middleware/cron-auth.js';
 export { verifyWorkerAuth, requireWorkerAuth, unauthorizedResponse, isWorkerAuthConfigured, } from './middleware/worker-auth.js';
 export { createWebhookHandler } from './webhook/processor.js';
 export { verifyWebhookSignature } from './webhook/signature.js';
+export { setGovernorEventBus, getGovernorEventBus, publishGovernorEvent } from './webhook/governor-bridge.js';
 export { createWorkerRegisterHandler } from './handlers/workers/register.js';
 export { createWorkerListHandler } from './handlers/workers/list.js';
 export { createWorkerGetHandler, createWorkerDeleteHandler } from './handlers/workers/get-delete.js';

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,YAAY,GACb,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAG9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAA;AACzE,YAAY,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAG/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAA;AACtE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAG7D,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,yBAAyB,CAAA;AAGhC,OAAO,EAAE,iCAAiC,EAAE,MAAM,6BAA6B,CAAA;AAC/E,YAAY,EAAE,iCAAiC,EAAE,MAAM,6BAA6B,CAAA;AAGpF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,6BAA6B,CAAA;AAGpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAG/D,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAK7G,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAA;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAA;AACpG,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAA;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AAGpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AACtE,YAAY,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAA;AACxE,OAAO,EAAE,8BAA8B,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAA;AAC7G,OAAO,EAAE,+BAA+B,EAAE,MAAM,qCAAqC,CAAA;AACrF,OAAO,EAAE,8BAA8B,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAA;AAChH,OAAO,EAAE,qCAAqC,EAAE,MAAM,2CAA2C,CAAA;AAGjG,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAA;AAC9E,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAA;AAClF,OAAO,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAA;AACvF,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAA;AAC9E,OAAO,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAA;AAGjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AACrE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,EAAE,+BAA+B,EAAE,MAAM,oCAAoC,CAAA;AACpF,YAAY,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAA;AAC/E,OAAO,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAA;AACtF,YAAY,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAA;AAGtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAG5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/src/index.js

@@ -21,6 +21,8 @@ export { verifyWorkerAuth, requireWorkerAuth, unauthorizedResponse, isWorkerAuth
 // Webhook
 export { createWebhookHandler } from './webhook/processor.js';
 export { verifyWebhookSignature } from './webhook/signature.js';
+// Governor bridge
+export { setGovernorEventBus, getGovernorEventBus, publishGovernorEvent } from './webhook/governor-bridge.js';
 // Individual handler factories (for custom wiring)
 // Worker handlers
 export { createWorkerRegisterHandler } from './handlers/workers/register.js';

package/dist/src/orchestrator/webhook-orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webhook-orchestrator.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/webhook-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA4BH,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACxB,2BAA2B,EAC5B,MAAM,YAAY,CAAA;AAyFnB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,CAAC,EAAE,yBAAyB,EAClC,KAAK,CAAC,EAAE,wBAAwB,GAC/B,2BAA2B,CA8O7B"}
+{"version":3,"file":"webhook-orchestrator.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/webhook-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoCH,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACxB,2BAA2B,EAC5B,MAAM,YAAY,CAAA;AAyFnB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,CAAC,EAAE,yBAAyB,EAClC,KAAK,CAAC,EAAE,wBAAwB,GAC/B,2BAA2B,CAwS7B"}

package/dist/src/orchestrator/webhook-orchestrator.js

@@ -10,7 +10,7 @@
  */
 import { createOrchestrator, } from '@supaku/agentfactory';
 import { withRetry, AgentSpawnError, isRetryableError, createAgentSession, createLinearAgentClient, } from '@supaku/agentfactory-linear';
-import { createLogger, generateIdempotencyKey, isWebhookProcessed, markWebhookProcessed, unmarkWebhookProcessed, storeSessionState, getSessionState, updateClaudeSessionId, updateSessionStatus, updateSessionCostData, } from '@supaku/agentfactory-server';
+import { createLogger, generateIdempotencyKey, isWebhookProcessed, markWebhookProcessed, unmarkWebhookProcessed, storeSessionState, getSessionState, updateClaudeSessionId, updateSessionStatus, updateSessionCostData, updateWorkflowState, recordPhaseAttempt, incrementCycleCount, appendFailureSummary, clearWorkflowState, extractFailureReason, } from '@supaku/agentfactory-server';
 import { formatErrorForComment } from './error-formatting.js';
 const log = createLogger('webhook-orchestrator');
 const DEFAULT_RETRY_CONFIG = {
@@ -143,6 +143,58 @@ export function createWebhookOrchestrator(config, hooks) {
                             outputTokens: agent.outputTokens,
                         }).catch((err) => log.error('Failed to persist cost data', { error: err }));
                     }
+                    // Track workflow state for result-sensitive work types
+                    try {
+                        const workType = agent.workType ?? 'development';
+                        const phaseMap = {
+                            development: 'development',
+                            qa: 'qa',
+                            'qa-coordination': 'qa',
+                            acceptance: 'acceptance',
+                            'acceptance-coordination': 'acceptance',
+                            refinement: 'refinement',
+                        };
+                        const phase = phaseMap[workType];
+                        if (phase) {
+                            // Ensure workflow state exists
+                            await updateWorkflowState(agent.issueId, {
+                                issueIdentifier: agent.identifier,
+                            });
+                            // Record the phase attempt
+                            await recordPhaseAttempt(agent.issueId, phase, {
+                                attempt: 1, // Will be refined by phase-specific logic
+                                sessionId: agent.sessionId,
+                                startedAt: agent.startedAt.getTime(),
+                                completedAt: agent.completedAt?.getTime(),
+                                result: agent.workResult ?? (phase === 'development' || phase === 'refinement' ? 'passed' : undefined),
+                                costUsd: agent.totalCostUsd,
+                            });
+                            // On QA/acceptance failure: increment cycle count and append failure summary
+                            const isResultSensitive = phase === 'qa' || phase === 'acceptance';
+                            if (isResultSensitive && agent.workResult === 'failed') {
+                                const state = await incrementCycleCount(agent.issueId);
+                                const failureReason = extractFailureReason(agent.resultMessage);
+                                const formattedFailure = `--- Cycle ${state.cycleCount}, ${phase} (${new Date().toISOString()}) ---\n${failureReason}`;
+                                await appendFailureSummary(agent.issueId, formattedFailure);
+                                log.info('Workflow state updated after failure', {
+                                    issueId: agent.issueId,
+                                    cycleCount: state.cycleCount,
+                                    strategy: state.strategy,
+                                    phase,
+                                });
+                            }
+                            // On acceptance pass: clear workflow state (issue is done)
+                            if (phase === 'acceptance' && agent.workResult === 'passed') {
+                                await clearWorkflowState(agent.issueId);
+                                log.info('Workflow state cleared after acceptance pass', {
+                                    issueId: agent.issueId,
+                                });
+                            }
+                        }
+                    }
+                    catch (err) {
+                        log.error('Failed to update workflow state', { error: err, issueId: agent.issueId });
+                    }
                     try {
                         await hooks?.onAgentComplete?.(agent);
                     }

package/dist/src/types.d.ts

@@ -49,6 +49,18 @@ export interface WebhookConfig extends RouteConfig {
     buildParentAcceptanceContext?: (identifier: string, subIssues: SubIssueStatus[]) => string;
     /** Linear project names this server handles. Empty/undefined = all projects. */
     projects?: string[];
+    /**
+     * Path to a directory containing custom workflow template YAML files.
+     * Templates in this directory override built-in defaults per work type.
+     */
+    templateDir?: string;
+    /**
+     * Governor integration mode:
+     * - 'direct' (default): Today's behavior -- webhooks dispatch work directly
+     * - 'event-bridge': Dual-write -- webhooks dispatch AND publish governor events
+     * - 'governor-only': Events only -- webhooks publish to governor, no direct dispatch
+     */
+    governorMode?: 'direct' | 'event-bridge' | 'governor-only';
 }
 /**
  * Resolved webhook config with all defaults applied.
@@ -64,6 +76,13 @@ export interface ResolvedWebhookConfig extends RouteConfig {
     buildParentAcceptanceContext?: (identifier: string, subIssues: SubIssueStatus[]) => string;
     /** Linear project names this server handles. Empty/undefined = all projects. */
     projects?: string[];
+    /**
+     * Governor integration mode:
+     * - 'direct' (default): Today's behavior -- webhooks dispatch work directly
+     * - 'event-bridge': Dual-write -- webhooks dispatch AND publish governor events
+     * - 'governor-only': Events only -- webhooks publish to governor, no direct dispatch
+     */
+    governorMode?: 'direct' | 'event-bridge' | 'governor-only';
 }
 /**
  * Configuration for cron-authenticated routes.

package/dist/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAEnG;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,CAAA;CACnF;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,oBAAoB,CAAA;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,OAAO,CAAA;IACrB,oBAAoB,EAAE,OAAO,CAAA;IAC7B,wBAAwB,EAAE,OAAO,CAAA;IACjC,gCAAgC,EAAE,OAAO,CAAA;IACzC,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,sBAAsB,EAAE,MAAM,EAAE,CAAA;IAChC,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B,2BAA2B,EAAE,MAAM,EAAE,CAAA;CACtC;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IACjG,wBAAwB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,aAAa,GAAG,SAAS,CAAA;IACzG,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,MAAM,CAAA;IACjD,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAC/B,oBAAoB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,MAAM,CAAA;IAClF,4BAA4B,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,MAAM,CAAA;IAC1F,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,WAAW;IACxD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IAChG,wBAAwB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,aAAa,GAAG,SAAS,CAAA;IACzG,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,MAAM,CAAA;IACjD,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAC/B,oBAAoB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,MAAM,CAAA;IAClF,4BAA4B,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,MAAM,CAAA;IAC1F,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/src/webhook/governor-bridge.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Governor Bridge
+ *
+ * Connects webhook handlers to the GovernorEventBus. When configured,
+ * webhook handlers publish events to the bus in addition to (or instead of)
+ * their normal direct-dispatch behavior.
+ */
+import type { GovernorEventBus, GovernorEvent } from '@supaku/agentfactory';
+/**
+ * Configure the governor event bus for webhook bridging.
+ * Call this during server initialization when governorMode != 'direct'.
+ */
+export declare function setGovernorEventBus(bus: GovernorEventBus): void;
+/**
+ * Get the configured event bus, or null if not configured.
+ */
+export declare function getGovernorEventBus(): GovernorEventBus | null;
+/**
+ * Publish a GovernorEvent if a bus is configured.
+ * Returns the event ID if published, null if no bus is configured.
+ */
+export declare function publishGovernorEvent(event: GovernorEvent): Promise<string | null>;
+//# sourceMappingURL=governor-bridge.d.ts.map

package/dist/src/webhook/governor-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governor-bridge.d.ts","sourceRoot":"","sources":["../../../src/webhook/governor-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAI3E;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAE/D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAE7D;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQvF"}

package/dist/src/webhook/governor-bridge.js

@@ -0,0 +1,36 @@
+/**
+ * Governor Bridge
+ *
+ * Connects webhook handlers to the GovernorEventBus. When configured,
+ * webhook handlers publish events to the bus in addition to (or instead of)
+ * their normal direct-dispatch behavior.
+ */
+let _eventBus = null;
+/**
+ * Configure the governor event bus for webhook bridging.
+ * Call this during server initialization when governorMode != 'direct'.
+ */
+export function setGovernorEventBus(bus) {
+    _eventBus = bus;
+}
+/**
+ * Get the configured event bus, or null if not configured.
+ */
+export function getGovernorEventBus() {
+    return _eventBus;
+}
+/**
+ * Publish a GovernorEvent if a bus is configured.
+ * Returns the event ID if published, null if no bus is configured.
+ */
+export async function publishGovernorEvent(event) {
+    if (!_eventBus)
+        return null;
+    try {
+        return await _eventBus.publish(event);
+    }
+    catch (err) {
+        console.error('[governor-bridge] Failed to publish event:', err);
+        return null;
+    }
+}

package/dist/src/webhook/handlers/issue-updated.d.ts

@@ -2,8 +2,9 @@
  * Handle Issue update events — status transition triggers.
  *
  * Handles:
- * - Finished → auto-QA trigger
- * - Icebox → Backlog → auto-development trigger
+ * - Finished → auto-QA trigger (with circuit breaker)
+ * - → Rejected → escalation ladder (circuit breaker, decomposition, human escalation)
+ * - (Icebox|Rejected|Canceled) → Backlog → auto-development trigger (with circuit breaker)
  * - Finished → Delivered → auto-acceptance trigger
  */
 import { NextResponse } from 'next/server';

package/dist/src/webhook/handlers/issue-updated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"issue-updated.d.ts","sourceRoot":"","sources":["../../../../src/webhook/handlers/issue-updated.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,oBAAoB,EAAiB,MAAM,6BAA6B,CAAA;AAsBtF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAQ3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE/D,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,oBAAoB,EAC7B,GAAG,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,GACnC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA+hB9B"}
+{"version":3,"file":"issue-updated.d.ts","sourceRoot":"","sources":["../../../../src/webhook/handlers/issue-updated.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,KAAK,EAAE,oBAAoB,EAAiB,MAAM,6BAA6B,CAAA;AA0BtF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAQ3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE/D,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,oBAAoB,EAC7B,GAAG,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,GACnC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAyxB9B"}

package/dist/src/webhook/handlers/issue-updated.js

@@ -2,13 +2,16 @@
  * Handle Issue update events — status transition triggers.
  *
  * Handles:
- * - Finished → auto-QA trigger
- * - Icebox → Backlog → auto-development trigger
+ * - Finished → auto-QA trigger (with circuit breaker)
+ * - → Rejected → escalation ladder (circuit breaker, decomposition, human escalation)
+ * - (Icebox|Rejected|Canceled) → Backlog → auto-development trigger (with circuit breaker)
  * - Finished → Delivered → auto-acceptance trigger
  */
 import { NextResponse } from 'next/server';
-import { checkIssueDeploymentStatus, formatFailedDeployments, } from '@supaku/agentfactory';
-import { generateIdempotencyKey, isWebhookProcessed, storeSessionState, getSessionStateByIssue, dispatchWork, wasAgentWorked, didJustFailQA, getQAAttemptCount, recordQAAttempt, clearQAFailed, didJustQueueDevelopment, markDevelopmentQueued, didJustQueueAcceptance, markAcceptanceQueued, } from '@supaku/agentfactory-server';
+import { buildFailureContextBlock } from '@supaku/agentfactory-linear';
+import { checkIssueDeploymentStatus, formatFailedDeployments, eventTimestamp, } from '@supaku/agentfactory';
+import { publishGovernorEvent } from '../governor-bridge.js';
+import { generateIdempotencyKey, isWebhookProcessed, storeSessionState, getSessionStateByIssue, dispatchWork, wasAgentWorked, didJustFailQA, getQAAttemptCount, recordQAAttempt, clearQAFailed, didJustQueueDevelopment, markDevelopmentQueued, didJustQueueAcceptance, markAcceptanceQueued, getWorkflowState, } from '@supaku/agentfactory-server';
 import { emitActivity, resolveStateName, isProjectAllowed, hasExcludedLabel, getAppUrl, } from '../utils.js';
 export async function handleIssueUpdated(config, payload, log) {
     const { data, updatedFrom, actor } = payload;
@@ -24,6 +27,33 @@ export async function handleIssueUpdated(config, payload, log) {
         return NextResponse.json({ success: true, skipped: true, reason: 'project_not_allowed' });
     }
     const autoTrigger = config.autoTrigger;
+    // --- Governor event bridge ---
+    if (currentStateName && updatedFrom?.stateId) {
+        const governorIssue = {
+            id: issueId,
+            identifier: issueIdentifier,
+            title: data.title ?? '',
+            description: data.description ?? undefined,
+            status: currentStateName,
+            labels: (data.labels ?? []).map(l => l.name),
+            createdAt: data.createdAt ? new Date(data.createdAt).getTime() : Date.now(),
+            parentId: data.parent?.id,
+            project: projectName,
+        };
+        await publishGovernorEvent({
+            type: 'issue-status-changed',
+            issueId,
+            issue: governorIssue,
+            previousStatus: updatedFrom.state?.name,
+            newStatus: currentStateName,
+            timestamp: eventTimestamp(),
+            source: 'webhook',
+        });
+    }
+    if (config.governorMode === 'governor-only') {
+        issueLog.info('Governor-only mode: skipping direct dispatch', { currentStateName });
+        return NextResponse.json({ success: true, governorMode: 'governor-only' });
+    }
     // === Handle Finished transition (auto-QA) ===
     if (currentStateName === 'Finished' && updatedFrom?.stateId) {
         issueLog.info('Issue transitioned to Finished', {
@@ -71,6 +101,20 @@ export async function handleIssueUpdated(config, payload, log) {
             issueLog.info('Issue in QA cooldown period, skipping');
             return NextResponse.json({ success: true, skipped: true, reason: 'qa_cooldown' });
         }
+        // Check workflow state for circuit breaker before QA
+        try {
+            const workflowState = await getWorkflowState(issueId);
+            if (workflowState?.strategy === 'escalate-human') {
+                issueLog.warn('Circuit breaker: escalate-human strategy, blocking QA', {
+                    cycleCount: workflowState.cycleCount,
+                    strategy: workflowState.strategy,
+                });
+                return NextResponse.json({ success: true, skipped: true, reason: 'circuit_breaker_escalate_human' });
+            }
+        }
+        catch (err) {
+            issueLog.warn('Failed to check workflow state for circuit breaker', { error: err });
+        }
         const attemptCount = await getQAAttemptCount(issueId);
         if (attemptCount >= 3) {
             issueLog.warn('QA attempt limit reached', { attemptCount });
@@ -124,6 +168,31 @@ export async function handleIssueUpdated(config, payload, log) {
         catch (err) {
             issueLog.warn('Failed to detect parent issue for QA routing', { error: err });
         }
+        // Enrich QA prompt with previous failure context
+        if (attemptCount > 0) {
+            try {
+                const workflowState = await getWorkflowState(issueId);
+                if (workflowState && workflowState.failureSummary) {
+                    const wfContext = {
+                        cycleCount: workflowState.cycleCount,
+                        strategy: workflowState.strategy,
+                        failureSummary: workflowState.failureSummary,
+                        qaAttemptCount: attemptCount,
+                    };
+                    const contextBlock = buildFailureContextBlock(qaWorkType, wfContext);
+                    if (contextBlock) {
+                        qaPrompt += contextBlock;
+                        issueLog.info('QA prompt enriched with failure context', {
+                            cycleCount: workflowState.cycleCount,
+                            attemptCount,
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                issueLog.warn('Failed to enrich QA prompt with failure context', { error: err });
+            }
+        }
         // Create Linear AgentSession for QA
         let qaSessionId;
         try {
@@ -200,17 +269,155 @@ export async function handleIssueUpdated(config, payload, log) {
             issueLog.error('Failed to queue QA work');
         }
     }
-    // === Handle Icebox → Backlog transition (auto-development) ===
+    // === Handle → Rejected transition (escalation ladder) ===
+    // When QA/acceptance fails, the orchestrator transitions the issue to Rejected.
+    // Check the escalation strategy and act accordingly.
+    if (currentStateName === 'Rejected' && updatedFrom?.stateId) {
+        try {
+            const workflowState = await getWorkflowState(issueId);
+            if (workflowState) {
+                const { strategy, cycleCount, failureSummary } = workflowState;
+                if (strategy === 'escalate-human') {
+                    issueLog.warn('Escalation ladder: escalate-human — creating blocker and stopping loop', {
+                        cycleCount,
+                        strategy,
+                    });
+                    const linearClient = await config.linearClient.getClient(payload.organizationId);
+                    // Post escalation summary comment
+                    const totalCostLine = workflowState.phases
+                        ? (() => {
+                            const allPhases = [
+                                ...workflowState.phases.development,
+                                ...workflowState.phases.qa,
+                                ...workflowState.phases.refinement,
+                                ...workflowState.phases.acceptance,
+                            ];
+                            const totalCost = allPhases.reduce((sum, p) => sum + (p.costUsd ?? 0), 0);
+                            return totalCost > 0 ? `\n**Total cost across all attempts:** $${totalCost.toFixed(2)}` : '';
+                        })()
+                        : '';
+                    try {
+                        await linearClient.createComment(issueId, `## Circuit Breaker: Human Intervention Required\n\n` +
+                            `This issue has gone through **${cycleCount} dev-QA-rejected cycles** without passing.\n` +
+                            `The automated system is stopping further attempts.\n` +
+                            totalCostLine +
+                            `\n\n### Failure History\n\n${failureSummary ?? 'No failure details recorded.'}\n\n` +
+                            `### Recommended Actions\n` +
+                            `1. Review the failure patterns above\n` +
+                            `2. Consider if the acceptance criteria need clarification\n` +
+                            `3. Investigate whether there's an architectural issue\n` +
+                            `4. Manually fix or decompose the issue before re-enabling automation`);
+                    }
+                    catch (err) {
+                        issueLog.error('Failed to post escalation comment', { error: err });
+                    }
+                    // Create a blocker issue in Icebox with 'Needs Human' label
+                    try {
+                        const issue = await linearClient.getIssue(issueId);
+                        const team = await issue.team;
+                        if (team) {
+                            const statuses = await linearClient.getTeamStatuses(team.id);
+                            const iceboxStateId = statuses['Icebox'];
+                            // Find 'Needs Human' label
+                            const allLabels = await linearClient.linearClient.issueLabels();
+                            const needsHumanLabel = allLabels.nodes.find((l) => l.name.toLowerCase() === 'needs human');
+                            const blockerTitle = `Human review needed: ${issueIdentifier} failed ${cycleCount} automated cycles`;
+                            const blockerDescription = [
+                                `This issue has failed **${cycleCount} automated dev-QA-rejected cycles** and requires human intervention.`,
+                                '',
+                                '### Failure History',
+                                failureSummary ?? 'No failure details recorded.',
+                                '',
+                                '---',
+                                `*Source issue: ${issueIdentifier}*`,
+                            ].join('\n');
+                            const createPayload = {
+                                title: blockerTitle,
+                                description: blockerDescription,
+                                teamId: team.id,
+                                ...(iceboxStateId && { stateId: iceboxStateId }),
+                                ...(needsHumanLabel && { labelIds: [needsHumanLabel.id] }),
+                            };
+                            // Add project if available
+                            const project = await issue.project;
+                            if (project) {
+                                createPayload.projectId = project.id;
+                            }
+                            const blockerIssue = await linearClient.createIssue(createPayload);
+                            // Create blocking relation: blocker blocks source issue
+                            await linearClient.createIssueRelation({
+                                issueId: blockerIssue.id,
+                                relatedIssueId: issueId,
+                                type: 'blocks',
+                            });
+                            issueLog.info('Escalation ladder: blocker issue created', {
+                                issueId,
+                                blockerIssueId: blockerIssue.id,
+                                blockerIdentifier: blockerIssue.identifier,
+                                cycleCount,
+                            });
+                        }
+                        else {
+                            issueLog.warn('Escalation ladder: could not resolve team for blocker creation', { issueId });
+                        }
+                    }
+                    catch (err) {
+                        issueLog.error('Failed to create blocker issue for escalation', { error: err });
+                    }
+                }
+                else if (strategy === 'decompose') {
+                    issueLog.info('Escalation ladder: decompose strategy — refinement will attempt decomposition', {
+                        cycleCount,
+                        strategy,
+                    });
+                    // The decomposition strategy will be handled via prompt enrichment (SUP-713)
+                    // by injecting decomposition instructions into the refinement prompt
+                }
+            }
+        }
+        catch (err) {
+            issueLog.warn('Failed to check workflow state for escalation ladder', { error: err });
+        }
+    }
+    // === Handle → Backlog transition (auto-development) ===
+    // Triggers from: Icebox → Backlog (new issues), Rejected → Backlog (post-refinement retries), etc.
     if (currentStateName === 'Backlog' && updatedFrom?.stateId) {
         const previousStateName = await resolveStateName(config, payload.organizationId, issueId, updatedFrom.stateId);
-        if (previousStateName !== 'Icebox') {
-            issueLog.debug('Issue transitioned to Backlog but not from Icebox', { previousStateName });
+        // Skip transitions from states that don't indicate readiness for development
+        // (e.g., Backlog → Backlog is a no-op, Started → Backlog means work was abandoned)
+        const allowedPreviousStates = ['Icebox', 'Rejected', 'Canceled'];
+        if (!allowedPreviousStates.includes(previousStateName ?? '')) {
+            issueLog.debug('Issue transitioned to Backlog from non-triggering state', { previousStateName });
         }
         else {
-            issueLog.info('Issue transitioned from Icebox to Backlog', {
+            const isRetry = previousStateName === 'Rejected';
+            issueLog.info('Issue transitioned to Backlog', {
                 previousStateName,
+                isRetry,
                 actorName: actor?.name,
             });
+            // Circuit breaker: check workflow state for escalate-human strategy
+            if (isRetry) {
+                try {
+                    const workflowState = await getWorkflowState(issueId);
+                    if (workflowState && workflowState.strategy === 'escalate-human') {
+                        issueLog.warn('Circuit breaker: issue at escalate-human strategy, skipping auto-development', {
+                            cycleCount: workflowState.cycleCount,
+                            strategy: workflowState.strategy,
+                        });
+                        return NextResponse.json({ success: true, skipped: true, reason: 'circuit_breaker_escalate_human' });
+                    }
+                    if (workflowState) {
+                        issueLog.info('Workflow state found for retry', {
+                            cycleCount: workflowState.cycleCount,
+                            strategy: workflowState.strategy,
+                        });
+                    }
+                }
+                catch (err) {
+                    issueLog.warn('Failed to check workflow state for circuit breaker', { error: err });
+                }
+            }
             const existingSession = await getSessionStateByIssue(issueId);
             if (existingSession && ['running', 'claimed', 'pending'].includes(existingSession.status)) {
                 issueLog.info('Session already active, skipping development trigger');
@@ -257,7 +464,31 @@ export async function handleIssueUpdated(config, payload, log) {
             catch (err) {
                 issueLog.warn('Failed to check if issue is parent', { error: err });
             }
-            const prompt = config.generatePrompt(issueIdentifier, workType);
+            let prompt = config.generatePrompt(issueIdentifier, workType);
+            // Enrich prompt with failure context for retries
+            if (isRetry) {
+                try {
+                    const workflowState = await getWorkflowState(issueId);
+                    if (workflowState && workflowState.cycleCount > 0) {
+                        const wfContext = {
+                            cycleCount: workflowState.cycleCount,
+                            strategy: workflowState.strategy,
+                            failureSummary: workflowState.failureSummary,
+                        };
+                        const contextBlock = buildFailureContextBlock(workType, wfContext);
+                        if (contextBlock) {
+                            prompt += contextBlock;
+                            issueLog.info('Development prompt enriched with failure context', {
+                                cycleCount: workflowState.cycleCount,
+                                strategy: workflowState.strategy,
+                            });
+                        }
+                    }
+                }
+                catch (err) {
+                    issueLog.warn('Failed to enrich development prompt with failure context', { error: err });
+                }
+            }
             await storeSessionState(devSessionId, {
                 issueId,
                 issueIdentifier,
@@ -283,7 +514,8 @@ export async function handleIssueUpdated(config, payload, log) {
             };
             const devResult = await dispatchWork(devWork);
             if (devResult.dispatched || devResult.parked) {
-                issueLog.info('Development work dispatched', { sessionId: devSessionId });
+                const retryLabel = isRetry ? ' (retry)' : '';
+                issueLog.info(`Development work dispatched${retryLabel}`, { sessionId: devSessionId });
                 try {
                     const appUrl = getAppUrl(config);
                     await linearClient.updateAgentSession({
@@ -295,7 +527,10 @@ export async function handleIssueUpdated(config, payload, log) {
                     issueLog.warn('Failed to update session externalUrl', { error: err });
                 }
                 try {
-                    await emitActivity(linearClient, devSessionId, 'thought', 'Development work queued. Waiting for an available worker...');
+                    const activityMsg = isRetry
+                        ? 'Development work queued (retry after refinement). Waiting for an available worker...'
+                        : 'Development work queued. Waiting for an available worker...';
+                    await emitActivity(linearClient, devSessionId, 'thought', activityMsg);
                 }
                 catch (err) {
                     issueLog.warn('Failed to emit queued activity', { error: err });

package/dist/src/webhook/handlers/session-created.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-created.d.ts","sourceRoot":"","sources":["../../../../src/webhook/handlers/session-created.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,oBAAoB,EAAiB,MAAM,6BAA6B,CAAA;AAiBtF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAS3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE/D,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,oBAAoB,EAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,GAAG,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,GACnC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAkT9B"}
+{"version":3,"file":"session-created.d.ts","sourceRoot":"","sources":["../../../../src/webhook/handlers/session-created.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,oBAAoB,EAAiB,MAAM,6BAA6B,CAAA;AAoBtF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAS3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE/D,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,oBAAoB,EAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,GAAG,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,GACnC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAyX9B"}

package/dist/src/webhook/handlers/session-created.js

@@ -2,8 +2,8 @@
  * Handle agent session 'create' events — new session initiated.
  */
 import { NextResponse } from 'next/server';
-import { TERMINAL_STATUSES, validateWorkTypeForStatus, WORK_TYPE_ALLOWED_STATUSES, STATUS_WORK_TYPE_MAP, getValidWorkTypesForStatus, } from '@supaku/agentfactory-linear';
-import { generateIdempotencyKey, isWebhookProcessed, storeSessionState, getSessionState, updateSessionStatus, dispatchWork, } from '@supaku/agentfactory-server';
+import { TERMINAL_STATUSES, validateWorkTypeForStatus, WORK_TYPE_ALLOWED_STATUSES, STATUS_WORK_TYPE_MAP, getValidWorkTypesForStatus, buildFailureContextBlock, } from '@supaku/agentfactory-linear';
+import { generateIdempotencyKey, isWebhookProcessed, storeSessionState, getSessionState, updateSessionStatus, dispatchWork, getWorkflowState, } from '@supaku/agentfactory-server';
 import { emitActivity, determineWorkType, isProjectAllowed, getAppUrl, getPriority, WORK_TYPE_MESSAGES, } from '../utils.js';
 export async function handleSessionCreated(config, payload, rawPayload, log) {
     const agentSession = rawPayload.agentSession;
@@ -194,6 +194,46 @@ export async function handleSessionCreated(config, payload, rawPayload, log) {
             });
         }
     }
+    // Extract PR info for QA/acceptance agents so they know which PRs to validate
+    let prContext = '';
+    const needsPrContext = workType === 'qa' ||
+        workType === 'acceptance' ||
+        workType === 'qa-coordination' ||
+        workType === 'acceptance-coordination';
+    if (needsPrContext) {
+        try {
+            const linearClient = await config.linearClient.getClient(payload.organizationId);
+            const issueForAttachments = await linearClient.getIssue(issueId);
+            const attachments = await issueForAttachments.attachments();
+            const prLinks = attachments.nodes
+                .filter((a) => a.url?.includes('github.com') && a.url?.includes('/pull/'))
+                .map((a) => {
+                const match = a.url.match(/\/pull\/(\d+)/);
+                return match ? { url: a.url, number: parseInt(match[1], 10), title: a.title ?? '' } : null;
+            })
+                .filter((pr) => pr !== null);
+            if (prLinks.length > 0) {
+                prContext = '\n\nLinked PRs:\n';
+                prContext += prLinks.map((pr) => `- PR #${pr.number}: ${pr.title} (${pr.url})`).join('\n');
+                if (prLinks.length > 1) {
+                    prContext +=
+                        '\n\nNote: Multiple PRs are linked. Check each PR state (open/merged/closed) and validate the most recent OPEN one.';
+                }
+            }
+            sessionLog.debug('Extracted PR context for QA/acceptance', {
+                prLinksCount: prLinks.length,
+                hasPrContext: prContext.length > 0,
+            });
+        }
+        catch (err) {
+            sessionLog.warn('Failed to extract PR info from issue attachments', { error: err });
+        }
+    }
+    const enhancedPromptContext = prContext
+        ? promptContext
+            ? promptContext + prContext
+            : prContext
+        : promptContext;
     const priority = getPriority(config, workType);
     await storeSessionState(sessionId, {
         issueId,
@@ -209,6 +249,31 @@ export async function handleSessionCreated(config, payload, rawPayload, log) {
         agentId,
         projectName,
     });
+    // Enrich prompt with workflow failure context for retries (refinement, development)
+    let workflowContextBlock = '';
+    if (workType === 'refinement' || (workType === 'development' && currentStatus === 'Backlog')) {
+        try {
+            const workflowState = await getWorkflowState(issueId);
+            if (workflowState && workflowState.cycleCount > 0) {
+                const wfContext = {
+                    cycleCount: workflowState.cycleCount,
+                    strategy: workflowState.strategy,
+                    failureSummary: workflowState.failureSummary,
+                };
+                workflowContextBlock = buildFailureContextBlock(workType, wfContext);
+                if (workflowContextBlock) {
+                    sessionLog.info('Prompt enriched with workflow failure context', {
+                        workType,
+                        cycleCount: workflowState.cycleCount,
+                        strategy: workflowState.strategy,
+                    });
+                }
+            }
+        }
+        catch (err) {
+            sessionLog.warn('Failed to enrich prompt with workflow context', { error: err });
+        }
+    }
     // Queue work
     const work = {
         sessionId,
@@ -217,7 +282,7 @@ export async function handleSessionCreated(config, payload, rawPayload, log) {
         priority,
         queuedAt: Date.now(),
         workType,
-        prompt: config.generatePrompt(issueIdentifier, workType, promptContext),
+        prompt: config.generatePrompt(issueIdentifier, workType, enhancedPromptContext) + workflowContextBlock,
         projectName,
     };
     const result = await dispatchWork(work);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supaku/agentfactory-nextjs",
-  "version": "0.7.9",
+  "version": "0.7.11",
   "type": "module",
   "description": "Next.js API route handlers for AgentFactory — webhook processor, worker/session management, public stats",
   "author": "Supaku (https://supaku.com)",
@@ -48,9 +48,9 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@supaku/agentfactory": "0.7.9",
-    "@supaku/agentfactory-server": "0.7.9",
-    "@supaku/agentfactory-linear": "0.7.9"
+    "@supaku/agentfactory": "0.7.11",
+    "@supaku/agentfactory-linear": "0.7.11",
+    "@supaku/agentfactory-server": "0.7.11"
   },
   "peerDependencies": {
     "next": ">=14.0.0"