agentic-orchestrator 0.1.6 → 0.1.8

package/apps/control-plane/src/supervisor/build-wave-executor.ts

@@ -1,7 +1,10 @@
 import { GATE_RESULT, STATUS, TOOLS } from '../core/constants.js';
 import type { FeatureStatePayload, SupervisorToolCaller } from './types.js';
 import { NOOP_WORKER_DECISION_RUNNER, type WorkerDecisionRunner } from './worker-decision-loop.js';
-import type { GateRepairContext, ReactionsService } from '../application/services/reactions-service.js';
+import type {
+  GateRepairContext,
+  ReactionsService,
+} from '../application/services/reactions-service.js';
 
 interface GatesRunData {
   overall?: string;
@@ -28,9 +31,13 @@ export class BuildWaveExecutor {
   async run(featureIds: string[], maxParallelGateRuns: number): Promise<void> {
     const batch: string[] = [];
     for (const featureId of featureIds) {
-      const state = await this.toolCaller.callTool<FeatureStatePayload>('builder', TOOLS.FEATURE_STATE_GET, {
-        feature_id: featureId
-      });
+      const state = await this.toolCaller.callTool<FeatureStatePayload>(
+        'builder',
+        TOOLS.FEATURE_STATE_GET,
+        {
+          feature_id: featureId,
+        },
+      );
 
       if (state.data.front_matter.status === STATUS.BUILDING) {
         batch.push(featureId);
@@ -40,21 +47,25 @@ export class BuildWaveExecutor {
     const selected = batch.slice(0, maxParallelGateRuns);
     for (const featureId of selected) {
       const context = await this.toolCaller.callTool('builder', TOOLS.FEATURE_GET_CONTEXT, {
-        feature_id: featureId
+        feature_id: featureId,
       });
       await this.workerDecisionRunner.execute({
         role: 'builder',
         featureId,
         contextBundle: context.data,
         instructions:
-          'Emit PATCH outputs for code changes, NOTE outputs for progress context, and REQUEST outputs for lock/context needs.'
+          'Emit PATCH outputs for code changes, NOTE outputs for progress context, and REQUEST outputs for lock/context needs.',
       });
     }
 
     const executing = selected.map(async (featureId) => {
-      const stateForRetry = await this.toolCaller.callTool<FeatureStatePayload>('builder', TOOLS.FEATURE_STATE_GET, {
-        feature_id: featureId
-      });
+      const stateForRetry = await this.toolCaller.callTool<FeatureStatePayload>(
+        'builder',
+        TOOLS.FEATURE_STATE_GET,
+        {
+          feature_id: featureId,
+        },
+      );
       const initialRetryCount = stateForRetry.data.front_matter.gate_retry_count ?? 0;
 
       let gateOverall: string;
@@ -64,11 +75,15 @@ export class BuildWaveExecutor {
       const failureHistory: GateRepairContext['failureHistory'] = [];
 
       try {
-        const gateResult = await this.toolCaller.callTool<GatesRunData>('builder', TOOLS.GATES_RUN, {
-          feature_id: featureId,
-          profile: null,
-          mode: 'fast'
-        });
+        const gateResult = await this.toolCaller.callTool<GatesRunData>(
+          'builder',
+          TOOLS.GATES_RUN,
+          {
+            feature_id: featureId,
+            profile: null,
+            mode: 'fast',
+          },
+        );
         gateOverall = gateResult.data.overall ?? GATE_RESULT.PASS;
         gateExitCode = gateOverall === GATE_RESULT.FAIL ? 1 : 0;
         gateEvidencePath = gateResult.data.evidence_path ?? '';
@@ -87,13 +102,13 @@ export class BuildWaveExecutor {
           evidence_summary: gateEvidencePath,
           logs_excerpt: gateLogs.slice(0, 800),
           failed_at: new Date().toISOString(),
-          retry_delay_ms: this.reactionsService?.retryDelayMs()
+          retry_delay_ms: this.reactionsService?.retryDelayMs(),
         });
       }
 
       if (this.reactionsService && gateOverall === GATE_RESULT.FAIL) {
         const context = await this.toolCaller.callTool('builder', TOOLS.FEATURE_GET_CONTEXT, {
-          feature_id: featureId
+          feature_id: featureId,
         });
         let retryCount = initialRetryCount;
         const retryDelayMs = this.reactionsService.retryDelayMs();
@@ -109,22 +124,26 @@ export class BuildWaveExecutor {
             logs: gateLogs,
             evidenceSummary: gateEvidencePath,
             retryCount,
-            failureHistory
+            failureHistory,
           };
           const repairPrompt = this.reactionsService.buildRepairPrompt(ctx);
           await this.workerDecisionRunner.execute({
             role: 'builder',
             featureId,
             contextBundle: context.data,
-            instructions: repairPrompt
+            instructions: repairPrompt,
           });
 
           try {
-            const retryResult = await this.toolCaller.callTool<GatesRunData>('builder', TOOLS.GATES_RUN, {
-              feature_id: featureId,
-              profile: null,
-              mode: 'fast'
-            });
+            const retryResult = await this.toolCaller.callTool<GatesRunData>(
+              'builder',
+              TOOLS.GATES_RUN,
+              {
+                feature_id: featureId,
+                profile: null,
+                mode: 'fast',
+              },
+            );
             gateOverall = retryResult.data.overall ?? GATE_RESULT.PASS;
             gateExitCode = gateOverall === GATE_RESULT.FAIL ? 1 : 0;
             gateEvidencePath = retryResult.data.evidence_path ?? gateEvidencePath;
@@ -147,7 +166,7 @@ export class BuildWaveExecutor {
               evidence_summary: gateEvidencePath,
               logs_excerpt: gateLogs.slice(0, 800),
               failed_at: new Date().toISOString(),
-              retry_delay_ms: retryDelayMs
+              retry_delay_ms: retryDelayMs,
             });
           }
 
@@ -164,7 +183,7 @@ export class BuildWaveExecutor {
             logs: gateLogs,
             evidenceSummary: gateEvidencePath,
             retryCount,
-            failureHistory
+            failureHistory,
           };
           await this.reactionsService.notifyEscalation(featureId, escalateCtx);
         }

package/apps/control-plane/src/supervisor/planning-wave-executor.ts

@@ -1,9 +1,5 @@
 import { STATUS, TOOLS } from '../core/constants.js';
-import type {
-  FeatureContextPayload,
-  InitialPlanGenerator,
-  SupervisorToolCaller
-} from './types.js';
+import type { FeatureContextPayload, InitialPlanGenerator, SupervisorToolCaller } from './types.js';
 import { NOOP_WORKER_DECISION_RUNNER, type WorkerDecisionRunner } from './worker-decision-loop.js';
 
 type AnyRecord = Record<string, unknown>;
@@ -78,7 +74,7 @@ function deriveEdgeCaseChecklist(specText: string): string[] {
   const checklist = [
     'Edge-case: boundary values and size limits are covered.',
     'Edge-case: negative-path input validation and error handling are covered.',
-    'Edge-case: dependency failure and retry behavior are covered.'
+    'Edge-case: dependency failure and retry behavior are covered.',
   ];
 
   const normalizedSpec = specText.toLowerCase();
@@ -123,9 +119,13 @@ export class PlanningWaveExecutor {
 
   async run(featureIds: string[]): Promise<void> {
     for (const featureId of featureIds) {
-      const context = await this.toolCaller.callTool<FeatureContextPayload>('planner', TOOLS.FEATURE_GET_CONTEXT, {
-        feature_id: featureId
-      });
+      const context = await this.toolCaller.callTool<FeatureContextPayload>(
+        'planner',
+        TOOLS.FEATURE_GET_CONTEXT,
+        {
+          feature_id: featureId,
+        },
+      );
 
       const state = context.data.state.front_matter;
       if (state.status !== STATUS.PLANNING && state.status !== STATUS.BLOCKED) {
@@ -138,7 +138,7 @@ export class PlanningWaveExecutor {
         featureId,
         contextBundle: asRecord(context.data),
         instructions:
-          'Review feature context and emit PLAN_SUBMISSION/REQUEST/NOTE outputs to advance planning deterministically.'
+          'Review feature context and emit PLAN_SUBMISSION/REQUEST/NOTE outputs to advance planning deterministically.',
       });
 
       if (decision.planSubmission || existingPlan) {
@@ -148,16 +148,20 @@ export class PlanningWaveExecutor {
       const plan = await this.planGenerator.generateInitialPlan(featureId);
       await this.toolCaller.callTool('planner', TOOLS.PLAN_SUBMIT, {
         feature_id: featureId,
-        plan_json: plan
+        plan_json: plan,
       });
     }
   }
 
   async runPostQaReconciliation(featureIds: string[], iteration: number): Promise<void> {
     for (const featureId of featureIds) {
-      const context = await this.toolCaller.callTool<FeatureContextPayload>('planner', TOOLS.FEATURE_GET_CONTEXT, {
-        feature_id: featureId
-      });
+      const context = await this.toolCaller.callTool<FeatureContextPayload>(
+        'planner',
+        TOOLS.FEATURE_GET_CONTEXT,
+        {
+          feature_id: featureId,
+        },
+      );
 
       const frontMatter = asRecord(asRecord(context.data.state).front_matter);
       const status = readStatus(frontMatter.status);
@@ -172,7 +176,7 @@ export class PlanningWaveExecutor {
           iteration,
           decision: 'no_update',
           reasons: ['missing_plan'],
-          status
+          status,
         });
         continue;
       }
@@ -184,7 +188,7 @@ export class PlanningWaveExecutor {
           iteration,
           decision: 'no_update',
           reasons: ['existing_plan_version_invalid'],
-          status
+          status,
         });
         continue;
       }
@@ -199,7 +203,7 @@ export class PlanningWaveExecutor {
           reasons: decision.reasons,
           qa_summary: decision.qaSummary,
           latest_gate_overall: decision.latestGateOverall,
-          edge_case_checklist: decision.edgeCaseChecklist
+          edge_case_checklist: decision.edgeCaseChecklist,
         });
         continue;
       }
@@ -208,7 +212,7 @@ export class PlanningWaveExecutor {
       await this.toolCaller.callTool('planner', TOOLS.PLAN_UPDATE, {
         feature_id: featureId,
         expected_plan_version: planVersion,
-        plan_json: nextPlan
+        plan_json: nextPlan,
       });
 
       await this.appendDecisionLog(featureId, {
@@ -222,7 +226,7 @@ export class PlanningWaveExecutor {
         reasons: decision.reasons,
         qa_summary: decision.qaSummary,
         latest_gate_overall: decision.latestGateOverall,
-        edge_case_checklist: decision.edgeCaseChecklist
+        edge_case_checklist: decision.edgeCaseChecklist,
       });
     }
   }
@@ -230,7 +234,7 @@ export class PlanningWaveExecutor {
   private evaluateReconciliationDecision(
     context: FeatureContextPayload,
     plan: AnyRecord,
-    status: string
+    status: string,
   ): ReconciliationDecision {
     const acceptanceCriteria = asStringArray(plan.acceptance_criteria);
     const riskItems = asStringArray(plan.risk);
@@ -240,9 +244,10 @@ export class PlanningWaveExecutor {
     const pending = readCount(qaSummary, 'pending');
     const failed = readCount(qaSummary, 'failed');
     const running = readCount(qaSummary, 'running');
-    const latestGateOverall = typeof asRecord(context.latest_evidence).overall === 'string'
-      ? String(asRecord(context.latest_evidence).overall)
-      : null;
+    const latestGateOverall =
+      typeof asRecord(context.latest_evidence).overall === 'string'
+        ? String(asRecord(context.latest_evidence).overall)
+        : null;
 
     const reasons: string[] = [];
     const acceptanceCriteriaAdditions: string[] = [];
@@ -251,16 +256,17 @@ export class PlanningWaveExecutor {
     if (missingEdgeCases.length > 0) {
       reasons.push(`edge_case_checklist_missing:${missingEdgeCases.length}`);
       acceptanceCriteriaAdditions.push(
-        'Planner edge-case checklist has been reviewed and incorporated into the execution plan.'
+        'Planner edge-case checklist has been reviewed and incorporated into the execution plan.',
       );
     }
 
-    const hasQaSignals = status === STATUS.BLOCKED || failed > 0 || pending > 0 || latestGateOverall === 'fail';
+    const hasQaSignals =
+      status === STATUS.BLOCKED || failed > 0 || pending > 0 || latestGateOverall === 'fail';
     const qaCheckpoint = `Planner reconciliation checkpoint [status=${status};failed=${failed};pending=${pending};latest=${latestGateOverall ?? 'unknown'}]`;
     if (hasQaSignals && !acceptanceCriteria.includes(qaCheckpoint)) {
       reasons.push(`qa_signals_detected:${status}:failed=${failed}:pending=${pending}`);
       acceptanceCriteriaAdditions.push(
-        'Reconcile QA/gate findings against plan scope and apply corrective updates before merge.'
+        'Reconcile QA/gate findings against plan scope and apply corrective updates before merge.',
       );
       acceptanceCriteriaAdditions.push(qaCheckpoint);
     }
@@ -274,9 +280,9 @@ export class PlanningWaveExecutor {
         qaSummary: {
           pending,
           failed,
-          running
+          running,
         },
-        latestGateOverall
+        latestGateOverall,
       };
     }
 
@@ -288,13 +294,17 @@ export class PlanningWaveExecutor {
       qaSummary: {
         pending,
         failed,
-        running
+        running,
       },
-      latestGateOverall
+      latestGateOverall,
     };
   }
 
-  private buildUpdatedPlan(plan: AnyRecord, planVersion: number, decision: ReconciliationDecision): AnyRecord {
+  private buildUpdatedPlan(
+    plan: AnyRecord,
+    planVersion: number,
+    decision: ReconciliationDecision,
+  ): AnyRecord {
     const nextPlan = structuredClone(plan);
     const acceptanceCriteria = asStringArray(nextPlan.acceptance_criteria);
     const riskItems = asStringArray(nextPlan.risk);
@@ -302,7 +312,10 @@ export class PlanningWaveExecutor {
     nextPlan.plan_version = planVersion + 1;
     nextPlan.revision_of = planVersion;
     nextPlan.revision_reason = decision.reasons.join('; ');
-    nextPlan.acceptance_criteria = normalizeList([...acceptanceCriteria, ...decision.acceptanceCriteriaAdditions]);
+    nextPlan.acceptance_criteria = normalizeList([
+      ...acceptanceCriteria,
+      ...decision.acceptanceCriteriaAdditions,
+    ]);
     nextPlan.risk = normalizeList([...riskItems, ...decision.edgeCaseChecklist]);
     return nextPlan;
   }
@@ -310,7 +323,7 @@ export class PlanningWaveExecutor {
   private async appendDecisionLog(featureId: string, note: AnyRecord): Promise<void> {
     await this.toolCaller.callTool('orchestrator', TOOLS.FEATURE_LOG_APPEND, {
       feature_id: featureId,
-      note: JSON.stringify(note)
+      note: JSON.stringify(note),
     });
   }
 }

package/apps/control-plane/src/supervisor/prompt-bundle-loader.ts

@@ -23,7 +23,7 @@ export class PromptBundleLoader implements AgentPromptProvider {
     const prompts: PromptBundle = {
       planner: null,
       builder: null,
-      qa: null
+      qa: null,
     };
 
     for (const role of ['planner', 'builder', 'qa'] as const) {

package/apps/control-plane/src/supervisor/qa-wave-executor.ts

@@ -6,11 +6,14 @@ import type {
   FeatureOrchestrationPort,
   FeatureStatePayload,
   SupervisorRuntimeState,
-  SupervisorToolCaller
+  SupervisorToolCaller,
 } from './types.js';
 import { UNASSIGNED_SESSION_ID } from './types.js';
 import { NOOP_WORKER_DECISION_RUNNER, type WorkerDecisionRunner } from './worker-decision-loop.js';
-import type { GateRepairContext, ReactionsService } from '../application/services/reactions-service.js';
+import type {
+  GateRepairContext,
+  ReactionsService,
+} from '../application/services/reactions-service.js';
 
 interface GatesRunData {
   overall?: string;
@@ -52,9 +55,13 @@ export class QaWaveExecutor {
   async run(featureIds: string[], maxParallelGateRuns: number): Promise<void> {
     const batch: string[] = [];
     for (const featureId of featureIds) {
-      const state = await this.toolCaller.callTool<FeatureStatePayload>('qa', TOOLS.FEATURE_STATE_GET, {
-        feature_id: featureId
-      });
+      const state = await this.toolCaller.callTool<FeatureStatePayload>(
+        'qa',
+        TOOLS.FEATURE_STATE_GET,
+        {
+          feature_id: featureId,
+        },
+      );
 
       if (state.data.front_matter.status === STATUS.QA) {
         batch.push(featureId);
@@ -63,19 +70,23 @@ export class QaWaveExecutor {
 
     for (const featureId of batch.slice(0, maxParallelGateRuns)) {
       const context = await this.toolCaller.callTool('qa', TOOLS.FEATURE_GET_CONTEXT, {
-        feature_id: featureId
+        feature_id: featureId,
       });
       await this.workerDecisionRunner.execute({
         role: 'qa',
         featureId,
         contextBundle: context.data,
         instructions:
-          'Emit PATCH outputs for deterministic QA remediations, NOTE outputs for findings, and REQUEST outputs for lock/context needs.'
+          'Emit PATCH outputs for deterministic QA remediations, NOTE outputs for findings, and REQUEST outputs for lock/context needs.',
       });
 
-      const stateForRetry = await this.toolCaller.callTool<FeatureStatePayload>('qa', TOOLS.FEATURE_STATE_GET, {
-        feature_id: featureId
-      });
+      const stateForRetry = await this.toolCaller.callTool<FeatureStatePayload>(
+        'qa',
+        TOOLS.FEATURE_STATE_GET,
+        {
+          feature_id: featureId,
+        },
+      );
       const initialRetryCount = stateForRetry.data.front_matter.gate_retry_count ?? 0;
 
       let gateOverall: string;
@@ -88,7 +99,7 @@ export class QaWaveExecutor {
         const gateResult = await this.toolCaller.callTool<GatesRunData>('qa', TOOLS.GATES_RUN, {
           feature_id: featureId,
           profile: null,
-          mode: 'full'
+          mode: 'full',
         });
         gateOverall = gateResult.data.overall ?? GATE_RESULT.PASS;
         gateExitCode = gateOverall === GATE_RESULT.FAIL ? 1 : 0;
@@ -108,7 +119,7 @@ export class QaWaveExecutor {
           evidence_summary: gateEvidencePath,
           logs_excerpt: gateLogs.slice(0, 800),
           failed_at: new Date().toISOString(),
-          retry_delay_ms: this.reactionsService?.retryDelayMs()
+          retry_delay_ms: this.reactionsService?.retryDelayMs(),
         });
       }
 
@@ -127,22 +138,26 @@ export class QaWaveExecutor {
             logs: gateLogs,
             evidenceSummary: gateEvidencePath,
             retryCount,
-            failureHistory
+            failureHistory,
           };
           const repairPrompt = this.reactionsService.buildRepairPrompt(ctx);
           await this.workerDecisionRunner.execute({
             role: 'qa',
             featureId,
             contextBundle: context.data,
-            instructions: repairPrompt
+            instructions: repairPrompt,
           });
 
           try {
-            const retryResult = await this.toolCaller.callTool<GatesRunData>('qa', TOOLS.GATES_RUN, {
-              feature_id: featureId,
-              profile: null,
-              mode: 'full'
-            });
+            const retryResult = await this.toolCaller.callTool<GatesRunData>(
+              'qa',
+              TOOLS.GATES_RUN,
+              {
+                feature_id: featureId,
+                profile: null,
+                mode: 'full',
+              },
+            );
             gateOverall = retryResult.data.overall ?? GATE_RESULT.PASS;
             gateExitCode = gateOverall === GATE_RESULT.FAIL ? 1 : 0;
             gateEvidencePath = retryResult.data.evidence_path ?? gateEvidencePath;
@@ -165,7 +180,7 @@ export class QaWaveExecutor {
               evidence_summary: gateEvidencePath,
               logs_excerpt: gateLogs.slice(0, 800),
               failed_at: new Date().toISOString(),
-              retry_delay_ms: retryDelayMs
+              retry_delay_ms: retryDelayMs,
             });
           }
 
@@ -182,7 +197,7 @@ export class QaWaveExecutor {
             logs: gateLogs,
             evidenceSummary: gateEvidencePath,
             retryCount,
-            failureHistory
+            failureHistory,
           };
           await this.reactionsService.notifyEscalation(featureId, escalateCtx);
         }
@@ -205,12 +220,12 @@ export class QaWaveExecutor {
         feature_id: featureId,
         planner_session_id: sessions?.planner ?? UNASSIGNED_SESSION_ID,
         builder_session_id: sessions?.builder ?? UNASSIGNED_SESSION_ID,
-        qa_session_id: newQa.session_id
+        qa_session_id: newQa.session_id,
       });
 
       await this.featureClusterPatcher.patchFeatureCluster(featureId, {
         orchestrator_session_id: this.state.orchestratorSessionId ?? 'unknown',
-        qa_session_id: newQa.session_id
+        qa_session_id: newQa.session_id,
       });
     }
   }