agentic-orchestrator 0.1.0

package/dist/apps/control-plane/supervisor/run-coordinator.js

@@ -0,0 +1,162 @@
+import { STATUS, TOOLS } from '../core/constants.js';
+import { NOOP_WORKER_DECISION_RUNNER } from './worker-decision-loop.js';
+export class RunCoordinator {
+    kernel;
+    provider;
+    toolCaller;
+    state;
+    sessionOrchestrator;
+    planningWaveExecutor;
+    buildWaveExecutor;
+    qaWaveExecutor;
+    leaseHeartbeatService;
+    maxActiveFeatures;
+    maxParallelGateRuns;
+    maxIterationsPerPhase;
+    takeoverStaleRun;
+    providerConfigRefHash;
+    workerDecisionRunner;
+    static TERMINAL_STATUSES = new Set([STATUS.MERGED, STATUS.FAILED]);
+    constructor(dependencies) {
+        this.kernel = dependencies.kernel;
+        this.provider = dependencies.provider;
+        this.toolCaller = dependencies.toolCaller;
+        this.state = dependencies.state;
+        this.sessionOrchestrator = dependencies.sessionOrchestrator;
+        this.planningWaveExecutor = dependencies.planningWaveExecutor;
+        this.buildWaveExecutor = dependencies.buildWaveExecutor;
+        this.qaWaveExecutor = dependencies.qaWaveExecutor;
+        this.leaseHeartbeatService = dependencies.leaseHeartbeatService;
+        this.maxActiveFeatures = dependencies.maxActiveFeatures;
+        this.maxParallelGateRuns = dependencies.maxParallelGateRuns;
+        this.maxIterationsPerPhase = dependencies.maxIterationsPerPhase;
+        this.takeoverStaleRun = dependencies.takeoverStaleRun;
+        this.providerConfigRefHash = dependencies.providerConfigRefHash;
+        this.workerDecisionRunner = dependencies.workerDecisionRunner ?? NOOP_WORKER_DECISION_RUNNER;
+    }
+    async start(features) {
+        await this.kernel.ensureLoaded();
+        await this.kernel.recoverFromState();
+        const leaseResult = await this.kernel.acquireRunLease({
+            run_id: this.state.runId,
+            owner_instance_id: this.state.ownerInstanceId,
+            provider: this.provider.selection.provider,
+            model: this.provider.selection.model,
+            provider_config_ref_hash: this.providerConfigRefHash(),
+            takeover_stale_run: this.takeoverStaleRun
+        });
+        this.state.runMetadata.took_over_stale = Boolean(leaseResult.data.took_over_stale);
+        await this.sessionOrchestrator.ensureGlobalOrchestratorSession();
+        const sorted = [...features].sort((a, b) => a.feature_id.localeCompare(b.feature_id));
+        const scopedFeatureIds = sorted.map((item) => item.feature_id);
+        this.state.queue = sorted;
+        let activeFeatureIds = [];
+        await this.sessionOrchestrator.cleanupOrphanWorkerSessions(scopedFeatureIds);
+        await this.kernel.pruneFeatureSessionAssignments({
+            run_id: this.state.runId,
+            owner_instance_id: this.state.ownerInstanceId,
+            active_feature_ids: scopedFeatureIds
+        });
+        activeFeatureIds = await this.rebalanceActiveFeatures(activeFeatureIds);
+        for (let iteration = 0; iteration < this.maxIterationsPerPhase; iteration += 1) {
+            if (activeFeatureIds.length === 0 && this.state.queue.length === 0) {
+                break;
+            }
+            await this.leaseHeartbeatService.renew();
+            activeFeatureIds = await this.applyOrchestratorPrioritization(activeFeatureIds, iteration + 1);
+            await this.planningWaveExecutor.run(activeFeatureIds);
+            await this.buildWaveExecutor.run(activeFeatureIds, this.maxParallelGateRuns);
+            await this.qaWaveExecutor.run(activeFeatureIds, this.maxParallelGateRuns);
+            await this.planningWaveExecutor.runPostQaReconciliation(activeFeatureIds, iteration + 1);
+            activeFeatureIds = await this.rebalanceActiveFeatures(activeFeatureIds);
+        }
+        const dashboard = await this.toolCaller.callTool('orchestrator', TOOLS.REPORT_DASHBOARD, {});
+        const runtimeSessions = await this.kernel.getRuntimeSessions();
+        return {
+            status: 'running',
+            dashboard: dashboard.data,
+            queue_depth: this.state.queue.length,
+            run_metadata: {
+                ...this.state.runMetadata,
+                runtime_sessions: runtimeSessions
+            }
+        };
+    }
+    async rebalanceActiveFeatures(currentActiveFeatureIds) {
+        const survivingActiveFeatureIds = [];
+        const sortedCurrent = [...currentActiveFeatureIds].sort((a, b) => a.localeCompare(b));
+        for (const featureId of sortedCurrent) {
+            const status = await this.readFeatureStatus(featureId);
+            if (status && RunCoordinator.TERMINAL_STATUSES.has(status)) {
+                await this.sessionOrchestrator.closeFeatureCluster(featureId);
+                continue;
+            }
+            survivingActiveFeatureIds.push(featureId);
+        }
+        while (survivingActiveFeatureIds.length < this.maxActiveFeatures && this.state.queue.length > 0) {
+            const nextFeature = this.state.queue.shift();
+            if (!nextFeature) {
+                break;
+            }
+            const status = await this.readFeatureStatus(nextFeature.feature_id);
+            if (status && RunCoordinator.TERMINAL_STATUSES.has(status)) {
+                await this.sessionOrchestrator.closeFeatureCluster(nextFeature.feature_id);
+                continue;
+            }
+            await this.sessionOrchestrator.initializeFeatureCluster(nextFeature.feature_id);
+            survivingActiveFeatureIds.push(nextFeature.feature_id);
+        }
+        const activeFeatureIds = [...new Set(survivingActiveFeatureIds)].sort((a, b) => a.localeCompare(b));
+        const scopedFeatureIds = [...activeFeatureIds, ...this.state.queue.map((item) => item.feature_id)].sort((a, b) => a.localeCompare(b));
+        await this.sessionOrchestrator.reconcileQueuedFeatures(this.state.queue);
+        await this.sessionOrchestrator.enforceActiveFeatureInvariant(activeFeatureIds);
+        await this.kernel.pruneFeatureSessionAssignments({
+            run_id: this.state.runId,
+            owner_instance_id: this.state.ownerInstanceId,
+            active_feature_ids: scopedFeatureIds
+        });
+        return activeFeatureIds;
+    }
+    async readFeatureStatus(featureId) {
+        try {
+            const state = await this.toolCaller.callTool('orchestrator', TOOLS.FEATURE_STATE_GET, {
+                feature_id: featureId
+            });
+            const status = state.data.front_matter.status;
+            return typeof status === 'string' ? status : null;
+        }
+        catch (_error) {
+            return null;
+        }
+    }
+    async applyOrchestratorPrioritization(activeFeatureIds, iteration) {
+        if (activeFeatureIds.length < 2) {
+            return activeFeatureIds;
+        }
+        const decision = await this.workerDecisionRunner.execute({
+            role: 'orchestrator',
+            featureId: 'global',
+            contextBundle: {
+                iteration,
+                active_feature_ids: activeFeatureIds,
+                queued_feature_ids: this.state.queue.map((item) => item.feature_id)
+            },
+            instructions: 'Decide per-iteration prioritization. Emit REQUEST action=prioritize with feature_order to reprioritize active features.'
+        });
+        if (decision.priorityOrder.length === 0) {
+            return activeFeatureIds;
+        }
+        const activeSet = new Set(activeFeatureIds);
+        const prioritized = [];
+        for (const featureId of decision.priorityOrder) {
+            if (!activeSet.has(featureId)) {
+                continue;
+            }
+            activeSet.delete(featureId);
+            prioritized.push(featureId);
+        }
+        const remaining = [...activeSet].sort((a, b) => a.localeCompare(b));
+        return [...prioritized, ...remaining];
+    }
+}
+//# sourceMappingURL=run-coordinator.js.map

package/dist/apps/control-plane/supervisor/run-coordinator.js.map

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

package/dist/apps/control-plane/supervisor/runtime.d.ts

@@ -0,0 +1,58 @@
+import type { WorkerProvider } from '../providers/providers.js';
+import { type ToolClient } from '../mcp/tool-client.js';
+import type { AgentPromptProvider, FeatureClusterPatcher, FeatureInput, InitialPlanGenerator, PromptBundle, RuntimeRole, SupervisorKernelPort, SupervisorOptions, SupervisorToolCaller, WorkerSessions } from './types.js';
+export declare class SupervisorRuntime implements SupervisorToolCaller, AgentPromptProvider, InitialPlanGenerator, FeatureClusterPatcher {
+    kernel: SupervisorKernelPort;
+    provider: WorkerProvider;
+    toolClient: ToolClient;
+    maxActiveFeatures: number;
+    maxParallelGateRuns: number;
+    maxIterationsPerPhase: number;
+    takeoverStaleRun: boolean;
+    private readonly state;
+    private readonly promptBundleLoader;
+    private readonly sessionOrchestrator;
+    private readonly planningWaveExecutor;
+    private readonly buildWaveExecutor;
+    private readonly qaWaveExecutor;
+    private readonly workerDecisionLoop;
+    private readonly leaseHeartbeatService;
+    private readonly runCoordinator;
+    private static readonly DEFAULT_MAX_ITERATIONS_PER_PHASE;
+    constructor(kernel: SupervisorKernelPort, provider: WorkerProvider, toolClient: ToolClient, options?: SupervisorOptions);
+    get runId(): string;
+    set runId(value: string);
+    get ownerInstanceId(): string;
+    set ownerInstanceId(value: string);
+    get orchestratorSessionId(): string | null;
+    set orchestratorSessionId(value: string | null);
+    get sessionsByFeature(): Map<string, WorkerSessions>;
+    set sessionsByFeature(value: Map<string, WorkerSessions>);
+    get queue(): FeatureInput[];
+    set queue(value: FeatureInput[]);
+    get runMetadata(): Record<string, unknown>;
+    set runMetadata(value: Record<string, unknown>);
+    get promptsCache(): PromptBundle | null;
+    set promptsCache(value: PromptBundle | null);
+    start(features: FeatureInput[]): Promise<Record<string, unknown>>;
+    providerConfigRefHash(): string;
+    private resolveMaxIterationsPerPhase;
+    ensureGlobalOrchestratorSession(): Promise<void>;
+    cleanupOrphanWorkerSessions(activeFeatureIds: string[]): Promise<void>;
+    initializeFeatureCluster(featureId: string): Promise<void>;
+    reconcileQueuedFeatures(): Promise<void>;
+    enforceActiveFeatureInvariant(activeFeatureIds: string[]): Promise<void>;
+    patchFeatureCluster(featureId: string, clusterPatch: Record<string, string>): Promise<void>;
+    loadRolePrompts(): Promise<PromptBundle>;
+    runPlanningWave(featureIds: string[]): Promise<void>;
+    runPostQaReconciliationWave(featureIds: string[], iteration: number): Promise<void>;
+    runBuildWave(featureIds: string[]): Promise<void>;
+    runQaWave(featureIds: string[]): Promise<void>;
+    renewLeaseHeartbeats(): Promise<void>;
+    generateInitialPlan(featureId: string): Promise<Record<string, unknown>>;
+    private resolveRoleSessionId;
+    callTool<TData = Record<string, unknown>>(role: RuntimeRole, toolName: string, args: Record<string, unknown>): Promise<{
+        ok: true;
+        data: TData;
+    }>;
+}

package/dist/apps/control-plane/supervisor/runtime.js

@@ -0,0 +1,270 @@
+import crypto from 'node:crypto';
+import { stableHash } from '../core/fs.js';
+import { createOperationId } from '../mcp/tool-client.js';
+import { withOperationIdIfRequired } from '../application/tools/tool-metadata.js';
+import { PromptBundleLoader } from './prompt-bundle-loader.js';
+import { SessionOrchestrator } from './session-orchestrator.js';
+import { PlanningWaveExecutor } from './planning-wave-executor.js';
+import { BuildWaveExecutor } from './build-wave-executor.js';
+import { QaWaveExecutor } from './qa-wave-executor.js';
+import { LeaseHeartbeatService } from './lease-heartbeat-service.js';
+import { RunCoordinator } from './run-coordinator.js';
+import { WorkerDecisionLoop } from './worker-decision-loop.js';
+export class SupervisorRuntime {
+    kernel;
+    provider;
+    toolClient;
+    maxActiveFeatures;
+    maxParallelGateRuns;
+    maxIterationsPerPhase;
+    takeoverStaleRun;
+    state;
+    promptBundleLoader;
+    sessionOrchestrator;
+    planningWaveExecutor;
+    buildWaveExecutor;
+    qaWaveExecutor;
+    workerDecisionLoop;
+    leaseHeartbeatService;
+    runCoordinator;
+    static DEFAULT_MAX_ITERATIONS_PER_PHASE = 6;
+    constructor(kernel, provider, toolClient, options = {}) {
+        this.kernel = kernel;
+        this.provider = provider;
+        this.toolClient = toolClient;
+        this.maxActiveFeatures = options.max_active_features ?? 5;
+        this.maxParallelGateRuns = options.max_parallel_gate_runs ?? 2;
+        this.maxIterationsPerPhase = this.resolveMaxIterationsPerPhase(options.max_iterations_per_phase);
+        this.takeoverStaleRun = Boolean(options.takeover_stale_run);
+        const runId = options.run_id ?? `run:${Date.now()}`;
+        const ownerInstanceId = options.owner_instance_id ?? `supervisor:${process.pid}:${crypto.randomUUID()}`;
+        this.state = {
+            runId,
+            ownerInstanceId,
+            orchestratorSessionId: null,
+            sessionsByFeature: new Map(),
+            queue: [],
+            runMetadata: {
+                started_at: new Date().toISOString(),
+                owner_instance_id: ownerInstanceId,
+                takeover_stale_run: this.takeoverStaleRun,
+                resolved_provider: provider.selection
+            }
+        };
+        this.promptBundleLoader = new PromptBundleLoader(this.kernel);
+        this.sessionOrchestrator = new SessionOrchestrator({
+            kernel: this.kernel,
+            runtimeStateReader: this.kernel,
+            provider: this.provider,
+            promptProvider: this,
+            toolCaller: this,
+            state: this.state
+        });
+        this.workerDecisionLoop = new WorkerDecisionLoop({
+            provider: this.provider,
+            toolCaller: this
+        });
+        this.planningWaveExecutor = new PlanningWaveExecutor({
+            toolCaller: this,
+            planGenerator: this,
+            workerDecisionRunner: this.workerDecisionLoop
+        });
+        this.buildWaveExecutor = new BuildWaveExecutor({
+            toolCaller: this,
+            workerDecisionRunner: this.workerDecisionLoop
+        });
+        this.qaWaveExecutor = new QaWaveExecutor({
+            kernel: this.kernel,
+            provider: this.provider,
+            toolCaller: this,
+            promptProvider: this,
+            featureClusterPatcher: this,
+            state: this.state,
+            workerDecisionRunner: this.workerDecisionLoop
+        });
+        this.leaseHeartbeatService = new LeaseHeartbeatService({
+            kernel: this.kernel,
+            state: this.state
+        });
+        this.runCoordinator = new RunCoordinator({
+            kernel: this.kernel,
+            provider: this.provider,
+            toolCaller: this,
+            state: this.state,
+            sessionOrchestrator: this.sessionOrchestrator,
+            planningWaveExecutor: this.planningWaveExecutor,
+            buildWaveExecutor: this.buildWaveExecutor,
+            qaWaveExecutor: this.qaWaveExecutor,
+            leaseHeartbeatService: this.leaseHeartbeatService,
+            maxActiveFeatures: this.maxActiveFeatures,
+            maxParallelGateRuns: this.maxParallelGateRuns,
+            maxIterationsPerPhase: this.maxIterationsPerPhase,
+            takeoverStaleRun: this.takeoverStaleRun,
+            providerConfigRefHash: () => this.providerConfigRefHash(),
+            workerDecisionRunner: this.workerDecisionLoop
+        });
+    }
+    get runId() {
+        return this.state.runId;
+    }
+    set runId(value) {
+        this.state.runId = value;
+    }
+    get ownerInstanceId() {
+        return this.state.ownerInstanceId;
+    }
+    set ownerInstanceId(value) {
+        this.state.ownerInstanceId = value;
+    }
+    get orchestratorSessionId() {
+        return this.state.orchestratorSessionId;
+    }
+    set orchestratorSessionId(value) {
+        this.state.orchestratorSessionId = value;
+    }
+    get sessionsByFeature() {
+        return this.state.sessionsByFeature;
+    }
+    set sessionsByFeature(value) {
+        this.state.sessionsByFeature = value;
+    }
+    get queue() {
+        return this.state.queue;
+    }
+    set queue(value) {
+        this.state.queue = value;
+    }
+    get runMetadata() {
+        return this.state.runMetadata;
+    }
+    set runMetadata(value) {
+        this.state.runMetadata = value;
+    }
+    get promptsCache() {
+        return this.promptBundleLoader.peekCache();
+    }
+    set promptsCache(value) {
+        this.promptBundleLoader.setCache(value);
+    }
+    async start(features) {
+        return await this.runCoordinator.start(features);
+    }
+    providerConfigRefHash() {
+        return stableHash(this.provider.selection.provider_config_ref ?? 'none');
+    }
+    resolveMaxIterationsPerPhase(cliOverride) {
+        if (typeof cliOverride === 'number' && Number.isFinite(cliOverride) && cliOverride >= 0) {
+            return Math.floor(cliOverride);
+        }
+        const policy = this.kernel.getPolicySnapshot();
+        const supervisor = policy.supervisor && typeof policy.supervisor === 'object'
+            ? policy.supervisor
+            : null;
+        const configured = supervisor?.max_iterations_per_phase;
+        if (typeof configured === 'number' && Number.isFinite(configured) && configured >= 0) {
+            return Math.floor(configured);
+        }
+        return SupervisorRuntime.DEFAULT_MAX_ITERATIONS_PER_PHASE;
+    }
+    async ensureGlobalOrchestratorSession() {
+        await this.sessionOrchestrator.ensureGlobalOrchestratorSession();
+    }
+    async cleanupOrphanWorkerSessions(activeFeatureIds) {
+        await this.sessionOrchestrator.cleanupOrphanWorkerSessions(activeFeatureIds);
+    }
+    async initializeFeatureCluster(featureId) {
+        await this.sessionOrchestrator.initializeFeatureCluster(featureId);
+    }
+    async reconcileQueuedFeatures() {
+        await this.sessionOrchestrator.reconcileQueuedFeatures(this.state.queue);
+    }
+    async enforceActiveFeatureInvariant(activeFeatureIds) {
+        await this.sessionOrchestrator.enforceActiveFeatureInvariant(activeFeatureIds);
+    }
+    async patchFeatureCluster(featureId, clusterPatch) {
+        await this.sessionOrchestrator.patchFeatureCluster(featureId, clusterPatch);
+    }
+    async loadRolePrompts() {
+        return await this.promptBundleLoader.loadRolePrompts();
+    }
+    async runPlanningWave(featureIds) {
+        await this.planningWaveExecutor.run(featureIds);
+    }
+    async runPostQaReconciliationWave(featureIds, iteration) {
+        await this.planningWaveExecutor.runPostQaReconciliation(featureIds, iteration);
+    }
+    async runBuildWave(featureIds) {
+        await this.buildWaveExecutor.run(featureIds, this.maxParallelGateRuns);
+    }
+    async runQaWave(featureIds) {
+        await this.qaWaveExecutor.run(featureIds, this.maxParallelGateRuns);
+    }
+    async renewLeaseHeartbeats() {
+        await this.leaseHeartbeatService.renew();
+    }
+    async generateInitialPlan(featureId) {
+        const baseRef = await this.kernel.repoDiff(featureId, ['--stat']).then(() => 'HEAD').catch(() => 'HEAD');
+        return {
+            feature_id: featureId,
+            plan_version: 1,
+            summary: `Initial implementation plan for ${featureId}`,
+            allowed_areas: ['apps/control-plane', `.aop/features/${featureId}`],
+            forbidden_areas: [],
+            base_ref: baseRef,
+            files: {
+                create: [],
+                modify: [],
+                delete: []
+            },
+            contracts: {
+                openapi: 'none',
+                events: 'none',
+                db: 'none'
+            },
+            acceptance_criteria: ['Feature has deterministic plan and passes configured gate profile.'],
+            gate_profile: 'default'
+        };
+    }
+    resolveRoleSessionId(role, payload) {
+        if (role === 'orchestrator') {
+            return this.state.orchestratorSessionId;
+        }
+        const featureId = typeof payload.feature_id === 'string' ? payload.feature_id : null;
+        if (!featureId) {
+            return null;
+        }
+        const session = this.state.sessionsByFeature.get(featureId);
+        if (!session) {
+            return null;
+        }
+        switch (role) {
+            case 'planner':
+                return session.planner;
+            case 'builder':
+                return session.builder;
+            case 'qa':
+                return session.qa;
+            default:
+                return null;
+        }
+    }
+    async callTool(role, toolName, args) {
+        const payload = withOperationIdIfRequired(toolName, args, createOperationId);
+        const roleSessionId = this.resolveRoleSessionId(role, payload);
+        const response = await this.toolClient.call(toolName, payload, {
+            run_id: this.state.runId,
+            session_id: roleSessionId ?? `bootstrap:${role}`,
+            actor_type: role,
+            actor_id: `supervisor:${role}`
+        });
+        if (response.ok === false) {
+            const normalized = (response).error;
+            const error = new Error(normalized.message);
+            error.code = normalized.code;
+            error.details = normalized.details;
+            throw error;
+        }
+        return { ok: true, data: response.data };
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/apps/control-plane/supervisor/runtime.js.map

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

package/dist/apps/control-plane/supervisor/session-orchestrator.d.ts

@@ -0,0 +1,29 @@
+import type { WorkerProvider } from '../providers/providers.js';
+import type { AgentPromptProvider, FeatureInput, RuntimeStateReader, SupervisorKernelPort, SupervisorRuntimeState, SupervisorToolCaller } from './types.js';
+interface SessionOrchestratorDependencies {
+    kernel: SupervisorKernelPort;
+    runtimeStateReader: RuntimeStateReader;
+    provider: WorkerProvider;
+    promptProvider: AgentPromptProvider;
+    toolCaller: SupervisorToolCaller;
+    state: SupervisorRuntimeState;
+}
+export declare class SessionOrchestrator {
+    private readonly kernel;
+    private readonly runtimeStateReader;
+    private readonly provider;
+    private readonly promptProvider;
+    private readonly toolCaller;
+    private readonly state;
+    constructor(dependencies: SessionOrchestratorDependencies);
+    ensureGlobalOrchestratorSession(): Promise<void>;
+    private attemptReattach;
+    private markOrphanSession;
+    cleanupOrphanWorkerSessions(scopedFeatureIds: string[]): Promise<void>;
+    initializeFeatureCluster(featureId: string): Promise<void>;
+    closeFeatureCluster(featureId: string): Promise<void>;
+    reconcileQueuedFeatures(queue?: FeatureInput[]): Promise<void>;
+    enforceActiveFeatureInvariant(activeFeatureIds: string[]): Promise<void>;
+    patchFeatureCluster(featureId: string, clusterPatch: Record<string, string>): Promise<void>;
+}
+export {};