agentic-orchestrator 0.1.6 → 0.1.8

package/apps/control-plane/src/cli/run-command-handler.ts

@@ -51,7 +51,7 @@ export class RunCommandHandler {
       kernel,
       toolClient,
       maxActiveFeatures,
-      maxParallelGateRuns
+      maxParallelGateRuns,
     } = context;
 
     if (options.batch && options.folder_input) {
@@ -67,7 +67,7 @@ export class RunCommandHandler {
     const selection = resolveProviderSelection({
       cli: options as unknown as Record<string, string | undefined>,
       env,
-      agentsConfig: kernel.getAgentsConfig()
+      agentsConfig: kernel.getAgentsConfig(),
     });
 
     const provider = new NullWorkerProvider(selection);
@@ -76,7 +76,7 @@ export class RunCommandHandler {
       max_parallel_gate_runs: maxParallelGateRuns ?? 3,
       run_id: runId,
       owner_instance_id: kernel.instanceId,
-      takeover_stale_run: options.takeover_stale_run
+      takeover_stale_run: options.takeover_stale_run,
     });
 
     const startResult = await supervisor.start(ingested as Array<{ feature_id: string }>);
@@ -90,8 +90,8 @@ export class RunCommandHandler {
         queue_depth: startResult.queue_depth,
         runtime_status: startResult.status,
         run_metadata: startResult.run_metadata,
-        dashboard: startResult.dashboard
-      }
+        dashboard: startResult.dashboard,
+      },
     };
   }
 
@@ -136,7 +136,11 @@ export class RunCommandHandler {
 
       if (activeBlocked.has(featureId)) {
         skipped++;
-        details.push({ feature_id: featureId, status: 'skipped', reason: 'already active/blocked' });
+        details.push({
+          feature_id: featureId,
+          status: 'skipped',
+          reason: 'already active/blocked',
+        });
         continue;
       }
 
@@ -162,8 +166,8 @@ export class RunCommandHandler {
         created,
         skipped,
         failed,
-        details
-      }
+        details,
+      },
     };
   }
 }

package/apps/control-plane/src/cli/send-command-handler.ts

@@ -30,14 +30,14 @@ export class SendCommandHandler {
     if (!featureId) {
       invalidCliArgs({
         reason: '--feature-id is required for send',
-        expected: '--feature-id <feature_id>'
+        expected: '--feature-id <feature_id>',
       });
     }
     if (!isValidFeatureId(featureId)) {
       invalidCliArgs({
         reason: 'Invalid --feature-id value',
         provided: featureId,
-        expected_pattern: '^[a-z0-9_][a-z0-9_-]*$'
+        expected_pattern: '^[a-z0-9_][a-z0-9_-]*$',
       });
     }
 
@@ -45,21 +45,21 @@ export class SendCommandHandler {
     if (!message || message.trim().length === 0) {
       invalidCliArgs({
         reason: '--message is required for send',
-        expected: '--message <message>'
+        expected: '--message <message>',
       });
     }
 
     const response = await callCliTool(this.toolClient, this.runId, TOOLS.FEATURE_SEND_MESSAGE, {
       feature_id: featureId,
-      message
+      message,
     });
 
     return {
       ok: true,
       data: {
         command: 'send',
-        ...(response.data ?? {})
-      }
+        ...(response.data ?? {}),
+      },
     };
   }
 }

package/apps/control-plane/src/cli/spec-ingestion-service.ts

@@ -7,7 +7,11 @@ import type { AppError } from '../providers/providers.js';
 import type { ToolClient } from '../mcp/tool-client.js';
 import type { FeatureStatePayload } from './types.js';
 import { callCliTool } from './tooling.js';
-import { canonicalFeatureIdFromPath, isCanonicalSpecPath, isLegacyCanonicalSpecPath } from './spec-utils.js';
+import {
+  canonicalFeatureIdFromPath,
+  isCanonicalSpecPath,
+  isLegacyCanonicalSpecPath,
+} from './spec-utils.js';
 
 export class SpecIngestionService {
   private readonly repoRoot: string;
@@ -26,7 +30,9 @@ export class SpecIngestionService {
 
     for (const sourcePath of resolvedPaths) {
       const canonical = isCanonicalSpecPath(this.repoRoot, sourcePath);
-      const legacyCanonical = canonical ? null : isLegacyCanonicalSpecPath(this.repoRoot, sourcePath);
+      const legacyCanonical = canonical
+        ? null
+        : isLegacyCanonicalSpecPath(this.repoRoot, sourcePath);
       let featureId: string;
       let targetPath: string;
       if (canonical) {
@@ -59,7 +65,7 @@ export class SpecIngestionService {
       const sourceContent = await fs.readFile(sourcePath, 'utf8');
       const sourceHash = stableHash(sourceContent);
       const state = await callCliTool(this.toolClient, this.runId, TOOLS.FEATURE_STATE_GET, {
-        feature_id: featureId
+        feature_id: featureId,
       });
       const typedState = state.data as unknown as FeatureStatePayload;
 
@@ -70,16 +76,16 @@ export class SpecIngestionService {
           front_matter: {
             source: {
               path: path.relative(this.repoRoot, sourcePath).replaceAll('\\\\', '/'),
-              hash: sourceHash
-            }
-          }
-        }
+              hash: sourceHash,
+            },
+          },
+        },
       });
 
       items.push({
         feature_id: featureId,
         source_path: path.relative(this.repoRoot, sourcePath).replaceAll('\\\\', '/'),
-        canonical_spec_path: path.relative(this.repoRoot, targetPath).replaceAll('\\\\', '/')
+        canonical_spec_path: path.relative(this.repoRoot, targetPath).replaceAll('\\\\', '/'),
       });
     }
 

package/apps/control-plane/src/cli/spec-input-resolver.ts

@@ -82,7 +82,12 @@ export class SpecInputResolver {
       return markdownFiles;
     }
 
-    const discovered = await callCliTool(this.toolClient, this.runId, TOOLS.FEATURE_DISCOVER_SPECS, {});
+    const discovered = await callCliTool(
+      this.toolClient,
+      this.runId,
+      TOOLS.FEATURE_DISCOVER_SPECS,
+      {},
+    );
     const specs = (discovered.data as unknown as DiscoveredSpecsPayload).specs ?? [];
     if (specs.length === 0) {
       const error = new Error(ERROR_CODES.NO_SPECS_FOUND) as AppError;

package/apps/control-plane/src/cli/spec-utils.ts

@@ -1,6 +1,6 @@
 import path from 'node:path';
-import {ERROR_CODES} from '../core/error-codes.js';
-import type {AppError} from '../providers/providers.js';
+import { ERROR_CODES } from '../core/error-codes.js';
+import type { AppError } from '../providers/providers.js';
 
 export function canonicalFeatureIdFromPath(inputPath: string): string {
   const basename = path.basename(inputPath);

package/apps/control-plane/src/cli/status-command-handler.ts

@@ -1,6 +1,6 @@
-import {TOOLS} from '../core/constants.js';
-import type {ToolClient} from '../mcp/tool-client.js';
-import {callCliTool} from './tooling.js';
+import { TOOLS } from '../core/constants.js';
+import type { ToolClient } from '../mcp/tool-client.js';
+import { callCliTool } from './tooling.js';
 
 interface ProjectStatusEntry {
   name: string;
@@ -55,7 +55,8 @@ function computeFeatureActivity(feature: DashboardFeature): ExtendedActivityStat
     return feature.activity_state;
   }
 
-  const timestamp = feature.activity_last_event_at ?? feature.last_heartbeat_at ?? feature.last_run_at;
+  const timestamp =
+    feature.activity_last_event_at ?? feature.last_heartbeat_at ?? feature.last_run_at;
   if (!timestamp) {
     return 'unknown';
   }
@@ -78,8 +79,8 @@ export class StatusCommandHandler {
       return {
         ok: true,
         data: {
-          projects: options.projectStatuses
-        }
+          projects: options.projectStatuses,
+        },
       };
     }
 
@@ -94,9 +95,9 @@ export class StatusCommandHandler {
           summary: features.map((f) => ({
             feature_id: f.feature_id,
             status: f.status ?? 'unknown',
-            activity: computeFeatureActivity(f)
-          }))
-        }
+            activity: computeFeatureActivity(f),
+          })),
+        },
       };
     }
 
@@ -109,9 +110,9 @@ export class StatusCommandHandler {
         features: rawFeatures.map((f) => ({
           ...f,
           activity: computeFeatureActivity(f),
-          ...(f.pr !== undefined ? { pr_info: f.pr } : {})
-        }))
-      }
+          ...(f.pr !== undefined ? { pr_info: f.pr } : {}),
+        })),
+      },
     };
   }
 }

package/apps/control-plane/src/cli/tooling.ts

@@ -5,7 +5,7 @@ import { createOperationId, type ToolClient } from '../mcp/tool-client.js';
 import { withOperationIdIfRequired } from '../application/tools/tool-metadata.js';
 
 export function assertOkResponse<TData extends Record<string, unknown>>(
-  response: ToolResponse<TData>
+  response: ToolResponse<TData>,
 ): OkResponse<TData> {
   if (!response.ok) {
     const failed = response as FailResponse;
@@ -21,7 +21,7 @@ export async function callCliTool(
   toolClient: ToolClient,
   runId: string,
   toolName: string,
-  args: Record<string, unknown>
+  args: Record<string, unknown>,
 ): Promise<OkResponse<Record<string, unknown>>> {
   const payload = withOperationIdIfRequired(toolName, args, createOperationId);
 
@@ -29,7 +29,7 @@ export async function callCliTool(
     run_id: runId,
     session_id: 'bootstrap:cli',
     actor_type: 'system',
-    actor_id: 'cli:system'
+    actor_id: 'cli:system',
   });
 
   return assertOkResponse(response);

package/apps/control-plane/src/cli/types.ts

@@ -10,7 +10,7 @@ export enum CliCommand {
   Retry = 'retry',
   Send = 'send',
   Attach = 'attach',
-  Help = 'help'
+  Help = 'help',
 }
 
 export interface CliOptions {

package/apps/control-plane/src/core/collisions.ts

@@ -41,23 +41,37 @@ function collectPlanFiles(plan: PlanShape): string[] {
   return [
     ...(plan.files?.create ?? []),
     ...(plan.files?.modify ?? []),
-    ...(plan.files?.delete ?? [])
+    ...(plan.files?.delete ?? []),
   ];
 }
 
-export function detectPlanCollisions(candidate: PlanShape, acceptedPlans: PlanShape[], policy: PolicyShape): {
+export function detectPlanCollisions(
+  candidate: PlanShape,
+  acceptedPlans: PlanShape[],
+  policy: PolicyShape,
+): {
   hasCollisions: boolean;
   collisions: {
     files: Array<{ with_feature_id: string; paths: string[] }>;
     areas: Array<{ with_feature_id: string; overlaps: Array<[string, string]> }>;
-    contracts: Array<{ with_feature_id: string; contract: string; candidate_mode: string; other_mode: string }>;
+    contracts: Array<{
+      with_feature_id: string;
+      contract: string;
+      candidate_mode: string;
+      other_mode: string;
+    }>;
   };
   fingerprint: string | null;
 } {
   const collisions = {
     files: [] as Array<{ with_feature_id: string; paths: string[] }>,
     areas: [] as Array<{ with_feature_id: string; overlaps: Array<[string, string]> }>,
-    contracts: [] as Array<{ with_feature_id: string; contract: string; candidate_mode: string; other_mode: string }>
+    contracts: [] as Array<{
+      with_feature_id: string;
+      contract: string;
+      candidate_mode: string;
+      other_mode: string;
+    }>,
   };
 
   const candidateFiles = collectPlanFiles(candidate);
@@ -71,7 +85,7 @@ export function detectPlanCollisions(candidate: PlanShape, acceptedPlans: PlanSh
     if (fileOverlap.length > 0) {
       collisions.files.push({
         with_feature_id: plan.feature_id,
-        paths: fileOverlap
+        paths: fileOverlap,
       });
     }
 
@@ -80,12 +94,15 @@ export function detectPlanCollisions(candidate: PlanShape, acceptedPlans: PlanSh
     const protectedAreas = policy.protected_areas ?? [];
     const relevant = areaOverlap.filter(
       ([a, b]) =>
-        exclusives.includes(a) || exclusives.includes(b) || protectedAreas.includes(a) || protectedAreas.includes(b)
+        exclusives.includes(a) ||
+        exclusives.includes(b) ||
+        protectedAreas.includes(a) ||
+        protectedAreas.includes(b),
     );
     if (relevant.length > 0) {
       collisions.areas.push({
         with_feature_id: plan.feature_id,
-        overlaps: relevant
+        overlaps: relevant,
       });
     }
 
@@ -99,7 +116,7 @@ export function detectPlanCollisions(candidate: PlanShape, acceptedPlans: PlanSh
           with_feature_id: plan.feature_id,
           contract,
           candidate_mode: candidateMode,
-          other_mode: otherMode
+          other_mode: otherMode,
         });
       }
     }
@@ -110,12 +127,12 @@ export function detectPlanCollisions(candidate: PlanShape, acceptedPlans: PlanSh
 
   const fingerprintInput = JSON.stringify({
     feature_id: candidate.feature_id,
-    collisions
+    collisions,
   });
 
   return {
     hasCollisions,
     collisions,
-    fingerprint: hasCollisions ? stableHash(fingerprintInput) : null
+    fingerprint: hasCollisions ? stableHash(fingerprintInput) : null,
   };
 }

package/apps/control-plane/src/core/constants.ts

@@ -8,7 +8,7 @@ export const STATUS = {
   READY_TO_MERGE: 'ready_to_merge',
   MERGED: 'merged',
   FAILED: 'failed',
-  PAUSED_BUDGET: 'paused_budget'
+  PAUSED_BUDGET: 'paused_budget',
 } as const;
 
 export type FeatureStatus = (typeof STATUS)[keyof typeof STATUS];
@@ -17,7 +17,7 @@ export const ROLE_STATUS = {
   READY: 'ready',
   RUNNING: 'running',
   BLOCKED: 'blocked',
-  DONE: 'done'
+  DONE: 'done',
 } as const;
 
 export const TOOLS = {
@@ -53,26 +53,32 @@ export const TOOLS = {
   COST_RECORD: 'cost.record',
   COST_GET: 'cost.get',
   PERFORMANCE_RECORD_OUTCOME: 'performance.record_outcome',
-  PERFORMANCE_GET_ANALYTICS: 'performance.get_analytics'
+  PERFORMANCE_GET_ANALYTICS: 'performance.get_analytics',
 } as const;
 
 export const DEFAULT_CLUSTER = {
   orchestrator_session_id: 'unknown',
   planner_session_id: 'unknown',
   builder_session_id: 'unknown',
-  qa_session_id: 'unknown'
+  qa_session_id: 'unknown',
 };
 
 export const DEFAULT_ROLE_STATUS = {
   planner: ROLE_STATUS.READY,
   builder: ROLE_STATUS.READY,
-  qa: ROLE_STATUS.READY
+  qa: ROLE_STATUS.READY,
 };
 
 export const GATE_RESULT = {
   PASS: 'pass',
   FAIL: 'fail',
-  NA: 'na'
+  NA: 'na',
 } as const;
 
-export const ALLOWED_ACTORS = new Set<string>(['orchestrator', 'planner', 'builder', 'qa', 'system']);
+export const ALLOWED_ACTORS = new Set<string>([
+  'orchestrator',
+  'planner',
+  'builder',
+  'qa',
+  'system',
+]);

package/apps/control-plane/src/core/error-codes.ts

@@ -46,7 +46,7 @@ export const ERROR_CODES = {
   INVALID_ARGUMENT: 'invalid_argument',
   INTERNAL_ERROR: 'internal_error',
   DEPENDENCY_UNRESOLVED: 'dependency_unresolved',
-  DEPENDENCY_CIRCULAR: 'dependency_circular'
+  DEPENDENCY_CIRCULAR: 'dependency_circular',
 } as const;
 
 export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];

package/apps/control-plane/src/core/fs.ts

@@ -87,7 +87,7 @@ export class FileLockManager {
   async withFileLock<T>(
     lockPath: string,
     operation: () => Promise<T>,
-    options: FileLockOptions = {}
+    options: FileLockOptions = {},
   ): Promise<T> {
     const timeoutMs = options.timeoutMs ?? 30_000;
     const initialBackoffMs = options.initialBackoffMs ?? 30;
@@ -103,10 +103,13 @@ export class FileLockManager {
         const lockHandle = await fsp.open(
           lockPath,
           fs.constants.O_CREAT | fs.constants.O_EXCL | fs.constants.O_RDWR,
-          0o644
+          0o644,
         );
         try {
-          await lockHandle.writeFile(JSON.stringify({ pid: process.pid, at: new Date().toISOString() }), 'utf8');
+          await lockHandle.writeFile(
+            JSON.stringify({ pid: process.pid, at: new Date().toISOString() }),
+            'utf8',
+          );
           await lockHandle.sync();
         } finally {
           await lockHandle.close();
@@ -144,7 +147,10 @@ export async function pathExists(targetPath: string): Promise<boolean> {
   return await pathFsAdapter.pathExists(targetPath);
 }
 
-export async function readJson<T = unknown>(filePath: string, fallback: T | null = null): Promise<T | null> {
+export async function readJson<T = unknown>(
+  filePath: string,
+  fallback: T | null = null,
+): Promise<T | null> {
   return await pathFsAdapter.readJson(filePath, fallback);
 }
 
@@ -159,7 +165,7 @@ export async function atomicWriteJson(filePath: string, value: unknown): Promise
 export async function withFileLock<T>(
   lockPath: string,
   operation: () => Promise<T>,
-  options: FileLockOptions = {}
+  options: FileLockOptions = {},
 ): Promise<T> {
   return await fileLockManager.withFileLock(lockPath, operation, options);
 }