@supaku/agentfactory-nextjs 0.7.8 → 0.7.10

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,11 @@ 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;
 }
 /**
  * Resolved webhook config with all defaults applied.

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":"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;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;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"}

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;AAuBtF,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,CA2vB9B"}

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

@@ -2,13 +2,15 @@
  * 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 { buildFailureContextBlock } from '@supaku/agentfactory-linear';
 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 { 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;
@@ -71,6 +73,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 +140,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 +241,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 +436,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 +486,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 +499,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.8",
+  "version": "0.7.10",
   "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.8",
-    "@supaku/agentfactory-server": "0.7.8",
-    "@supaku/agentfactory-linear": "0.7.8"
+    "@supaku/agentfactory": "0.7.10",
+    "@supaku/agentfactory-linear": "0.7.10",
+    "@supaku/agentfactory-server": "0.7.10"
   },
   "peerDependencies": {
     "next": ">=14.0.0"