agentic-orchestrator 0.1.0

package/dist/apps/control-plane/providers/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/providers/providers.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,13 @@
+import type { SupervisorToolCaller } from './types.js';
+import { type WorkerDecisionRunner } from './worker-decision-loop.js';
+interface BuildWaveExecutorDependencies {
+    toolCaller: SupervisorToolCaller;
+    workerDecisionRunner?: WorkerDecisionRunner;
+}
+export declare class BuildWaveExecutor {
+    private readonly toolCaller;
+    private readonly workerDecisionRunner;
+    constructor(dependencies: BuildWaveExecutorDependencies);
+    run(featureIds: string[], maxParallelGateRuns: number): Promise<void>;
+}
+export {};

package/dist/apps/control-plane/supervisor/build-wave-executor.js

@@ -0,0 +1,40 @@
+import { STATUS, TOOLS } from '../core/constants.js';
+import { NOOP_WORKER_DECISION_RUNNER } from './worker-decision-loop.js';
+export class BuildWaveExecutor {
+    toolCaller;
+    workerDecisionRunner;
+    constructor(dependencies) {
+        this.toolCaller = dependencies.toolCaller;
+        this.workerDecisionRunner = dependencies.workerDecisionRunner ?? NOOP_WORKER_DECISION_RUNNER;
+    }
+    async run(featureIds, maxParallelGateRuns) {
+        const batch = [];
+        for (const featureId of featureIds) {
+            const state = await this.toolCaller.callTool('builder', TOOLS.FEATURE_STATE_GET, {
+                feature_id: featureId
+            });
+            if (state.data.front_matter.status === STATUS.BUILDING) {
+                batch.push(featureId);
+            }
+        }
+        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
+            });
+            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.'
+            });
+        }
+        const executing = selected.map((featureId) => this.toolCaller.callTool('builder', TOOLS.GATES_RUN, {
+            feature_id: featureId,
+            profile: null,
+            mode: 'fast'
+        }));
+        await Promise.allSettled(executing);
+    }
+}
+//# sourceMappingURL=build-wave-executor.js.map

package/dist/apps/control-plane/supervisor/build-wave-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-wave-executor.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/supervisor/build-wave-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,2BAA2B,EAA6B,MAAM,2BAA2B,CAAC;AAOnG,MAAM,OAAO,iBAAiB;IACX,UAAU,CAAuB;IACjC,oBAAoB,CAAuB;IAE5D,YAAY,YAA2C;QACrD,IAAI,CAAC,UAAU,GAAG,YAAY,CAAC,UAAU,CAAC;QAC1C,IAAI,CAAC,oBAAoB,GAAG,YAAY,CAAC,oBAAoB,IAAI,2BAA2B,CAAC;IAC/F,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,UAAoB,EAAE,mBAA2B;QACzD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAsB,SAAS,EAAE,KAAK,CAAC,iBAAiB,EAAE;gBACpG,UAAU,EAAE,SAAS;aACtB,CAAC,CAAC;YAEH,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACvD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;QACrD,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,mBAAmB,EAAE;gBACnF,UAAU,EAAE,SAAS;aACtB,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC;gBACtC,IAAI,EAAE,SAAS;gBACf,SAAS;gBACT,aAAa,EAAE,OAAO,CAAC,IAAI;gBAC3B,YAAY,EACV,qHAAqH;aACxH,CAAC,CAAC;QACL,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAC3C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE;YACnD,UAAU,EAAE,SAAS;YACrB,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,MAAM;SACb,CAAC,CACH,CAAC;QAEF,MAAM,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/apps/control-plane/supervisor/lease-heartbeat-service.d.ts

@@ -0,0 +1,12 @@
+import type { FeatureOrchestrationPort, SupervisorRuntimeState } from './types.js';
+interface LeaseHeartbeatServiceDependencies {
+    kernel: FeatureOrchestrationPort;
+    state: SupervisorRuntimeState;
+}
+export declare class LeaseHeartbeatService {
+    private readonly kernel;
+    private readonly state;
+    constructor(dependencies: LeaseHeartbeatServiceDependencies);
+    renew(): Promise<void>;
+}
+export {};

package/dist/apps/control-plane/supervisor/lease-heartbeat-service.js

@@ -0,0 +1,14 @@
+export class LeaseHeartbeatService {
+    kernel;
+    state;
+    constructor(dependencies) {
+        this.kernel = dependencies.kernel;
+        this.state = dependencies.state;
+    }
+    async renew() {
+        const featureIds = [...this.state.sessionsByFeature.keys()];
+        await this.kernel.renewLeases(featureIds);
+        await this.kernel.renewRunLease(this.state.runId, this.state.ownerInstanceId);
+    }
+}
+//# sourceMappingURL=lease-heartbeat-service.js.map

package/dist/apps/control-plane/supervisor/lease-heartbeat-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease-heartbeat-service.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/supervisor/lease-heartbeat-service.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,qBAAqB;IACf,MAAM,CAA2B;IACjC,KAAK,CAAyB;IAE/C,YAAY,YAA+C;QACzD,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAChF,CAAC;CACF"}

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

@@ -0,0 +1,19 @@
+import type { InitialPlanGenerator, SupervisorToolCaller } from './types.js';
+import { type WorkerDecisionRunner } from './worker-decision-loop.js';
+interface PlanningWaveExecutorDependencies {
+    toolCaller: SupervisorToolCaller;
+    planGenerator: InitialPlanGenerator;
+    workerDecisionRunner?: WorkerDecisionRunner;
+}
+export declare class PlanningWaveExecutor {
+    private readonly toolCaller;
+    private readonly planGenerator;
+    private readonly workerDecisionRunner;
+    constructor(dependencies: PlanningWaveExecutorDependencies);
+    run(featureIds: string[]): Promise<void>;
+    runPostQaReconciliation(featureIds: string[], iteration: number): Promise<void>;
+    private evaluateReconciliationDecision;
+    private buildUpdatedPlan;
+    private appendDecisionLog;
+}
+export {};

package/dist/apps/control-plane/supervisor/planning-wave-executor.js

@@ -0,0 +1,249 @@
+import { STATUS, TOOLS } from '../core/constants.js';
+import { NOOP_WORKER_DECISION_RUNNER } from './worker-decision-loop.js';
+function asRecord(value) {
+    return value && typeof value === 'object' ? value : {};
+}
+function asStringArray(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    const normalized = [];
+    for (const item of value) {
+        if (typeof item !== 'string') {
+            continue;
+        }
+        const trimmed = item.trim();
+        if (trimmed.length > 0) {
+            normalized.push(trimmed);
+        }
+    }
+    return normalized;
+}
+function normalizeList(values) {
+    const seen = new Set();
+    const normalized = [];
+    for (const value of values) {
+        const trimmed = value.trim();
+        if (trimmed.length === 0 || seen.has(trimmed)) {
+            continue;
+        }
+        seen.add(trimmed);
+        normalized.push(trimmed);
+    }
+    return normalized;
+}
+function readCount(summary, key) {
+    const raw = summary[key];
+    if (typeof raw !== 'number' || !Number.isFinite(raw) || raw < 0) {
+        return 0;
+    }
+    return Math.floor(raw);
+}
+function readStatus(value) {
+    return typeof value === 'string' ? value : 'unknown';
+}
+function deriveEdgeCaseChecklist(specText) {
+    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.'
+    ];
+    const normalizedSpec = specText.toLowerCase();
+    if (/(empty|null|missing|required)/.test(normalizedSpec)) {
+        checklist.push('Edge-case: empty/null/missing input handling is covered.');
+    }
+    if (/(timeout|retry|backoff|latency)/.test(normalizedSpec)) {
+        checklist.push('Edge-case: timeout, retry, and latency behavior is covered.');
+    }
+    if (/(concurrent|race|parallel|lock)/.test(normalizedSpec)) {
+        checklist.push('Edge-case: concurrent access and race-condition behavior are covered.');
+    }
+    if (/(permission|auth|unauthori|forbidden|denied)/.test(normalizedSpec)) {
+        checklist.push('Edge-case: authorization and permission-denied behavior is covered.');
+    }
+    return normalizeList(checklist);
+}
+function readPlanVersion(plan) {
+    const raw = plan.plan_version;
+    if (typeof raw !== 'number' || !Number.isFinite(raw) || raw < 1) {
+        return null;
+    }
+    return Math.floor(raw);
+}
+function isPostQaStatus(status) {
+    return status === STATUS.QA || status === STATUS.READY_TO_MERGE || status === STATUS.BLOCKED;
+}
+export class PlanningWaveExecutor {
+    toolCaller;
+    planGenerator;
+    workerDecisionRunner;
+    constructor(dependencies) {
+        this.toolCaller = dependencies.toolCaller;
+        this.planGenerator = dependencies.planGenerator;
+        this.workerDecisionRunner = dependencies.workerDecisionRunner ?? NOOP_WORKER_DECISION_RUNNER;
+    }
+    async run(featureIds) {
+        for (const featureId of featureIds) {
+            const context = await this.toolCaller.callTool('planner', TOOLS.FEATURE_GET_CONTEXT, {
+                feature_id: featureId
+            });
+            const state = context.data.state.front_matter;
+            if (state.status !== STATUS.PLANNING && state.status !== STATUS.BLOCKED) {
+                continue;
+            }
+            const existingPlan = context.data.plan;
+            const decision = await this.workerDecisionRunner.execute({
+                role: 'planner',
+                featureId,
+                contextBundle: asRecord(context.data),
+                instructions: 'Review feature context and emit PLAN_SUBMISSION/REQUEST/NOTE outputs to advance planning deterministically.'
+            });
+            if (decision.planSubmission || existingPlan) {
+                continue;
+            }
+            const plan = await this.planGenerator.generateInitialPlan(featureId);
+            await this.toolCaller.callTool('planner', TOOLS.PLAN_SUBMIT, {
+                feature_id: featureId,
+                plan_json: plan
+            });
+        }
+    }
+    async runPostQaReconciliation(featureIds, iteration) {
+        for (const featureId of featureIds) {
+            const context = await this.toolCaller.callTool('planner', TOOLS.FEATURE_GET_CONTEXT, {
+                feature_id: featureId
+            });
+            const frontMatter = asRecord(asRecord(context.data.state).front_matter);
+            const status = readStatus(frontMatter.status);
+            if (!isPostQaStatus(status)) {
+                continue;
+            }
+            const existingPlan = asRecord(context.data.plan);
+            if (Object.keys(existingPlan).length === 0) {
+                await this.appendDecisionLog(featureId, {
+                    phase: 'post_qa_reconciliation',
+                    iteration,
+                    decision: 'no_update',
+                    reasons: ['missing_plan'],
+                    status
+                });
+                continue;
+            }
+            const planVersion = readPlanVersion(existingPlan);
+            if (planVersion == null) {
+                await this.appendDecisionLog(featureId, {
+                    phase: 'post_qa_reconciliation',
+                    iteration,
+                    decision: 'no_update',
+                    reasons: ['existing_plan_version_invalid'],
+                    status
+                });
+                continue;
+            }
+            const decision = this.evaluateReconciliationDecision(context.data, existingPlan, status);
+            if (decision.action === 'no_update') {
+                await this.appendDecisionLog(featureId, {
+                    phase: 'post_qa_reconciliation',
+                    iteration,
+                    decision: 'no_update',
+                    status,
+                    reasons: decision.reasons,
+                    qa_summary: decision.qaSummary,
+                    latest_gate_overall: decision.latestGateOverall,
+                    edge_case_checklist: decision.edgeCaseChecklist
+                });
+                continue;
+            }
+            const nextPlan = this.buildUpdatedPlan(existingPlan, planVersion, decision);
+            await this.toolCaller.callTool('planner', TOOLS.PLAN_UPDATE, {
+                feature_id: featureId,
+                expected_plan_version: planVersion,
+                plan_json: nextPlan
+            });
+            await this.appendDecisionLog(featureId, {
+                phase: 'post_qa_reconciliation',
+                iteration,
+                decision: 'plan_update',
+                status,
+                expected_plan_version: planVersion,
+                next_plan_version: nextPlan.plan_version,
+                revision_reason: nextPlan.revision_reason,
+                reasons: decision.reasons,
+                qa_summary: decision.qaSummary,
+                latest_gate_overall: decision.latestGateOverall,
+                edge_case_checklist: decision.edgeCaseChecklist
+            });
+        }
+    }
+    evaluateReconciliationDecision(context, plan, status) {
+        const acceptanceCriteria = asStringArray(plan.acceptance_criteria);
+        const riskItems = asStringArray(plan.risk);
+        const specText = typeof context.spec === 'string' ? context.spec : '';
+        const edgeCaseChecklist = deriveEdgeCaseChecklist(specText);
+        const qaSummary = asRecord(asRecord(context.qa_test_index).summary);
+        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 reasons = [];
+        const acceptanceCriteriaAdditions = [];
+        const missingEdgeCases = edgeCaseChecklist.filter((item) => !riskItems.includes(item));
+        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.');
+        }
+        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.');
+            acceptanceCriteriaAdditions.push(qaCheckpoint);
+        }
+        if (reasons.length === 0) {
+            return {
+                action: 'no_update',
+                reasons: ['reconciled_no_gaps'],
+                acceptanceCriteriaAdditions: [],
+                edgeCaseChecklist,
+                qaSummary: {
+                    pending,
+                    failed,
+                    running
+                },
+                latestGateOverall
+            };
+        }
+        return {
+            action: 'update',
+            reasons,
+            acceptanceCriteriaAdditions: normalizeList(acceptanceCriteriaAdditions),
+            edgeCaseChecklist,
+            qaSummary: {
+                pending,
+                failed,
+                running
+            },
+            latestGateOverall
+        };
+    }
+    buildUpdatedPlan(plan, planVersion, decision) {
+        const nextPlan = structuredClone(plan);
+        const acceptanceCriteria = asStringArray(nextPlan.acceptance_criteria);
+        const riskItems = asStringArray(nextPlan.risk);
+        nextPlan.plan_version = planVersion + 1;
+        nextPlan.revision_of = planVersion;
+        nextPlan.revision_reason = decision.reasons.join('; ');
+        nextPlan.acceptance_criteria = normalizeList([...acceptanceCriteria, ...decision.acceptanceCriteriaAdditions]);
+        nextPlan.risk = normalizeList([...riskItems, ...decision.edgeCaseChecklist]);
+        return nextPlan;
+    }
+    async appendDecisionLog(featureId, note) {
+        await this.toolCaller.callTool('orchestrator', TOOLS.FEATURE_LOG_APPEND, {
+            feature_id: featureId,
+            note: JSON.stringify(note)
+        });
+    }
+}
+//# sourceMappingURL=planning-wave-executor.js.map

package/dist/apps/control-plane/supervisor/planning-wave-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-wave-executor.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/supervisor/planning-wave-executor.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,9 @@
+import type { AgentPromptProvider, PromptBundle, RuntimeStateReader } from './types.js';
+export declare class PromptBundleLoader implements AgentPromptProvider {
+    private readonly runtimeStateReader;
+    private promptsCache;
+    constructor(runtimeStateReader: RuntimeStateReader);
+    loadRolePrompts(): Promise<PromptBundle>;
+    peekCache(): PromptBundle | null;
+    setCache(prompts: PromptBundle | null): void;
+}

package/dist/apps/control-plane/supervisor/prompt-bundle-loader.js

@@ -0,0 +1,53 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { ERROR_CODES } from '../core/error-codes.js';
+export class PromptBundleLoader {
+    runtimeStateReader;
+    promptsCache;
+    constructor(runtimeStateReader) {
+        this.runtimeStateReader = runtimeStateReader;
+        this.promptsCache = null;
+    }
+    async loadRolePrompts() {
+        if (this.promptsCache) {
+            return this.promptsCache;
+        }
+        const agentsConfig = this.runtimeStateReader.getAgentsConfig();
+        const roles = agentsConfig.roles ?? {};
+        const behavior = agentsConfig.missing_prompt_behavior ?? 'ignore';
+        const prompts = {
+            planner: null,
+            builder: null,
+            qa: null
+        };
+        for (const role of ['planner', 'builder', 'qa']) {
+            const configuredPath = roles[role]?.system_prompt_path;
+            if (!configuredPath) {
+                prompts[role] = null;
+                continue;
+            }
+            const absolute = path.join(this.runtimeStateReader.getRepoRoot(), configuredPath);
+            try {
+                prompts[role] = await fs.readFile(absolute, 'utf8');
+            }
+            catch {
+                if (behavior === 'error') {
+                    const error = new Error(ERROR_CODES.MISSING_ROLE_PROMPT);
+                    error.code = ERROR_CODES.MISSING_ROLE_PROMPT;
+                    error.details = { role, configured_path: configuredPath };
+                    throw error;
+                }
+                prompts[role] = null;
+            }
+        }
+        this.promptsCache = prompts;
+        return prompts;
+    }
+    peekCache() {
+        return this.promptsCache;
+    }
+    setCache(prompts) {
+        this.promptsCache = prompts;
+    }
+}
+//# sourceMappingURL=prompt-bundle-loader.js.map

package/dist/apps/control-plane/supervisor/prompt-bundle-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-bundle-loader.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/supervisor/prompt-bundle-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,MAAM,OAAO,kBAAkB;IACZ,kBAAkB,CAAqB;IAChD,YAAY,CAAsB;IAE1C,YAAY,kBAAsC;QAChD,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;QAC7C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,YAAY,CAAC;QAC3B,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,eAAe,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,YAAY,CAAC,uBAAuB,IAAI,QAAQ,CAAC;QAClE,MAAM,OAAO,GAAiB;YAC5B,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI;YACb,EAAE,EAAE,IAAI;SACT,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAU,EAAE,CAAC;YACzD,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC;YACvD,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,WAAW,EAAE,EAAE,cAAc,CAAC,CAAC;YAClF,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;oBACzB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,mBAAmB,CAAa,CAAC;oBACrE,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC,mBAAmB,CAAC;oBAC7C,KAAK,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC;oBAC1D,MAAM,KAAK,CAAC;gBACd,CAAC;gBAED,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YACvB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QAC5B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,QAAQ,CAAC,OAA4B;QACnC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;IAC9B,CAAC;CACF"}

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

@@ -0,0 +1,24 @@
+import type { WorkerProvider } from '../providers/providers.js';
+import type { AgentPromptProvider, FeatureClusterPatcher, FeatureOrchestrationPort, SupervisorRuntimeState, SupervisorToolCaller } from './types.js';
+import { type WorkerDecisionRunner } from './worker-decision-loop.js';
+interface QaWaveExecutorDependencies {
+    kernel: FeatureOrchestrationPort;
+    provider: WorkerProvider;
+    toolCaller: SupervisorToolCaller;
+    promptProvider: AgentPromptProvider;
+    featureClusterPatcher: FeatureClusterPatcher;
+    state: SupervisorRuntimeState;
+    workerDecisionRunner?: WorkerDecisionRunner;
+}
+export declare class QaWaveExecutor {
+    private readonly kernel;
+    private readonly provider;
+    private readonly toolCaller;
+    private readonly promptProvider;
+    private readonly featureClusterPatcher;
+    private readonly state;
+    private readonly workerDecisionRunner;
+    constructor(dependencies: QaWaveExecutorDependencies);
+    run(featureIds: string[], maxParallelGateRuns: number): Promise<void>;
+}
+export {};

package/dist/apps/control-plane/supervisor/qa-wave-executor.js

@@ -0,0 +1,70 @@
+import { STATUS, TOOLS } from '../core/constants.js';
+import { UNASSIGNED_SESSION_ID } from './types.js';
+import { NOOP_WORKER_DECISION_RUNNER } from './worker-decision-loop.js';
+export class QaWaveExecutor {
+    kernel;
+    provider;
+    toolCaller;
+    promptProvider;
+    featureClusterPatcher;
+    state;
+    workerDecisionRunner;
+    constructor(dependencies) {
+        this.kernel = dependencies.kernel;
+        this.provider = dependencies.provider;
+        this.toolCaller = dependencies.toolCaller;
+        this.promptProvider = dependencies.promptProvider;
+        this.featureClusterPatcher = dependencies.featureClusterPatcher;
+        this.state = dependencies.state;
+        this.workerDecisionRunner = dependencies.workerDecisionRunner ?? NOOP_WORKER_DECISION_RUNNER;
+    }
+    async run(featureIds, maxParallelGateRuns) {
+        const batch = [];
+        for (const featureId of featureIds) {
+            const state = await this.toolCaller.callTool('qa', TOOLS.FEATURE_STATE_GET, {
+                feature_id: featureId
+            });
+            if (state.data.front_matter.status === STATUS.QA) {
+                batch.push(featureId);
+            }
+        }
+        for (const featureId of batch.slice(0, maxParallelGateRuns)) {
+            const context = await this.toolCaller.callTool('qa', TOOLS.FEATURE_GET_CONTEXT, {
+                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.'
+            });
+            await this.toolCaller.callTool('qa', TOOLS.GATES_RUN, {
+                feature_id: featureId,
+                profile: null,
+                mode: 'full'
+            });
+            const sessions = this.state.sessionsByFeature.get(featureId);
+            if (sessions?.qa) {
+                await this.provider.closeSession(sessions.qa);
+            }
+            const prompts = await this.promptProvider.loadRolePrompts();
+            const newQa = await this.provider.createSession('qa', featureId, prompts.qa);
+            if (sessions) {
+                sessions.qa = newQa.session_id;
+            }
+            await this.kernel.updateFeatureSessionAssignment({
+                run_id: this.state.runId,
+                owner_instance_id: this.state.ownerInstanceId,
+                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
+            });
+            await this.featureClusterPatcher.patchFeatureCluster(featureId, {
+                orchestrator_session_id: this.state.orchestratorSessionId ?? 'unknown',
+                qa_session_id: newQa.session_id
+            });
+        }
+    }
+}
+//# sourceMappingURL=qa-wave-executor.js.map

package/dist/apps/control-plane/supervisor/qa-wave-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-wave-executor.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/supervisor/qa-wave-executor.ts"],"names":[],"mappings":"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"}

package/dist/apps/control-plane/supervisor/run-coordinator.d.ts

@@ -0,0 +1,49 @@
+import type { WorkerProvider } from '../providers/providers.js';
+import type { FeatureInput, FeatureOrchestrationPort, RuntimeStateReader, SupervisorRuntimeState, SupervisorToolCaller } from './types.js';
+import { type SessionOrchestrator } from './session-orchestrator.js';
+import { type PlanningWaveExecutor } from './planning-wave-executor.js';
+import { type BuildWaveExecutor } from './build-wave-executor.js';
+import { type QaWaveExecutor } from './qa-wave-executor.js';
+import { type LeaseHeartbeatService } from './lease-heartbeat-service.js';
+import { type WorkerDecisionRunner } from './worker-decision-loop.js';
+interface RunCoordinatorDependencies {
+    kernel: FeatureOrchestrationPort & RuntimeStateReader;
+    provider: WorkerProvider;
+    toolCaller: SupervisorToolCaller;
+    state: SupervisorRuntimeState;
+    sessionOrchestrator: SessionOrchestrator;
+    planningWaveExecutor: PlanningWaveExecutor;
+    buildWaveExecutor: BuildWaveExecutor;
+    qaWaveExecutor: QaWaveExecutor;
+    leaseHeartbeatService: LeaseHeartbeatService;
+    maxActiveFeatures: number;
+    maxParallelGateRuns: number;
+    maxIterationsPerPhase: number;
+    takeoverStaleRun: boolean;
+    providerConfigRefHash: () => string;
+    workerDecisionRunner?: WorkerDecisionRunner;
+}
+export declare class RunCoordinator {
+    private readonly kernel;
+    private readonly provider;
+    private readonly toolCaller;
+    private readonly state;
+    private readonly sessionOrchestrator;
+    private readonly planningWaveExecutor;
+    private readonly buildWaveExecutor;
+    private readonly qaWaveExecutor;
+    private readonly leaseHeartbeatService;
+    private readonly maxActiveFeatures;
+    private readonly maxParallelGateRuns;
+    private readonly maxIterationsPerPhase;
+    private readonly takeoverStaleRun;
+    private readonly providerConfigRefHash;
+    private readonly workerDecisionRunner;
+    private static readonly TERMINAL_STATUSES;
+    constructor(dependencies: RunCoordinatorDependencies);
+    start(features: FeatureInput[]): Promise<Record<string, unknown>>;
+    private rebalanceActiveFeatures;
+    private readFeatureStatus;
+    private applyOrchestratorPrioritization;
+}
+export {};