agentic-orchestrator 0.1.6 → 0.1.8

package/dist/apps/control-plane/core/kernel.js

@@ -1,18 +1,18 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { ensureDir, pathExists, readJson, atomicWriteJson, atomicWriteFile, withFileLock, nowIso, stableHash } from './fs.js';
+import { ensureDir, pathExists, readJson, atomicWriteJson, atomicWriteFile, withFileLock, nowIso, stableHash, } from './fs.js';
 import { SchemaRegistry, loadAndValidateYaml } from './schemas.js';
 import { normalizeRepoPath } from './path-rules.js';
 import { parseFrontMatter, buildFrontMatter } from './frontmatter.js';
 import { runGit, runCommand } from './git.js';
 import { ERROR_CODES } from './error-codes.js';
 import { ok, fail, withSuggestedActions } from './response.js';
-import { ALLOWED_ACTORS, DEFAULT_CLUSTER, DEFAULT_ROLE_STATUS, GATE_RESULT, STATUS, TOOLS } from './constants.js';
+import { ALLOWED_ACTORS, DEFAULT_CLUSTER, DEFAULT_ROLE_STATUS, GATE_RESULT, STATUS, TOOLS, } from './constants.js';
 import { AopPathLayout, ensureAopRuntimeLayout } from './path-layout.js';
-import { applyWorktreeSymlinks, formatWorkspaceHookWarning, runWorktreePostCreate } from './workspace-hooks.js';
+import { applyWorktreeSymlinks, formatWorkspaceHookWarning, runWorktreePostCreate, } from './workspace-hooks.js';
 import { ToolRegistryLoader } from '../mcp/tool-registry-loader.js';
-import { ToolHandlerRegistry, ToolRouter } from '../application/tools/tool-router.js';
-import { RunLeaseService } from '../application/services/run-lease-service.js';
+import { ToolHandlerRegistry, ToolRouter, } from '../application/tools/tool-router.js';
+import { RunLeaseService, } from '../application/services/run-lease-service.js';
 import { LockService } from '../application/services/lock-service.js';
 import { ReportingService } from '../application/services/reporting-service.js';
 import { FeatureStateService } from '../application/services/feature-state-service.js';
@@ -23,11 +23,11 @@ import { GateService } from '../application/services/gate-service.js';
 import { QaIndexService } from '../application/services/qa-index-service.js';
 import { MergeService } from '../application/services/merge-service.js';
 import { CollisionQueueService } from '../application/services/collision-queue-service.js';
-import { FeatureDeletionService } from '../application/services/feature-deletion-service.js';
+import { FeatureDeletionService, } from '../application/services/feature-deletion-service.js';
 import { CostTrackingService } from '../application/services/cost-tracking-service.js';
-import { PerformanceAnalyticsService } from '../application/services/performance-analytics-service.js';
+import { PerformanceAnalyticsService, } from '../application/services/performance-analytics-service.js';
 import { loadComposedPolicy } from '../application/services/policy-loader-service.js';
-import { ACTIVITY_DETECTOR_SLOT, NOTIFICATION_CHANNEL_SLOT, SCM_PROVIDER_SLOT, globalAdapterRegistry } from '../application/adapters/adapter-registry.js';
+import { ACTIVITY_DETECTOR_SLOT, NOTIFICATION_CHANNEL_SLOT, SCM_PROVIDER_SLOT, globalAdapterRegistry, } from '../application/adapters/adapter-registry.js';
 function asArray(value) {
     return Array.isArray(value) ? value : [];
 }
@@ -109,7 +109,7 @@ export class AopKernel {
         this.performanceAnalyticsService = new PerformanceAnalyticsService(this);
         this.toolRouter = new ToolRouter(this.toolHandlers, (toolName) => Promise.resolve(fail(ERROR_CODES.INVALID_ARGUMENT, `Unknown tool ${toolName}`, {
             retryable: false,
-            requires_human: true
+            requires_human: true,
         })));
     }
     getRepoRoot() {
@@ -168,7 +168,7 @@ export class AopKernel {
             last_heartbeat_at: at,
             lease_expires_at: at,
             orchestrator_epoch: 0,
-            feature_sessions: {}
+            feature_sessions: {},
         };
     }
     normalizeRuntimeSessions(value, at = nowIso()) {
@@ -186,7 +186,7 @@ export class AopKernel {
             featureSessions[featureId] = {
                 planner_session_id: typeof typed.planner_session_id === 'string' ? typed.planner_session_id : 'unassigned',
                 builder_session_id: typeof typed.builder_session_id === 'string' ? typed.builder_session_id : 'unassigned',
-                qa_session_id: typeof typed.qa_session_id === 'string' ? typed.qa_session_id : 'unassigned'
+                qa_session_id: typeof typed.qa_session_id === 'string' ? typed.qa_session_id : 'unassigned',
             };
         }
         const epoch = typeof source.orchestrator_epoch === 'number' && Number.isFinite(source.orchestrator_epoch)
@@ -197,7 +197,9 @@ export class AopKernel {
             orchestrator_session_id: typeof source.orchestrator_session_id === 'string' && source.orchestrator_session_id
                 ? source.orchestrator_session_id
                 : fallback.orchestrator_session_id,
-            provider: typeof source.provider === 'string' && source.provider ? source.provider : fallback.provider,
+            provider: typeof source.provider === 'string' && source.provider
+                ? source.provider
+                : fallback.provider,
             model: typeof source.model === 'string' && source.model ? source.model : fallback.model,
             provider_config_ref_hash: typeof source.provider_config_ref_hash === 'string' && source.provider_config_ref_hash
                 ? source.provider_config_ref_hash
@@ -205,8 +207,12 @@ export class AopKernel {
             owner_instance_id: typeof source.owner_instance_id === 'string' && source.owner_instance_id
                 ? source.owner_instance_id
                 : fallback.owner_instance_id,
-            lease_id: typeof source.lease_id === 'string' && source.lease_id ? source.lease_id : fallback.lease_id,
-            started_at: typeof source.started_at === 'string' && source.started_at ? source.started_at : fallback.started_at,
+            lease_id: typeof source.lease_id === 'string' && source.lease_id
+                ? source.lease_id
+                : fallback.lease_id,
+            started_at: typeof source.started_at === 'string' && source.started_at
+                ? source.started_at
+                : fallback.started_at,
             last_heartbeat_at: typeof source.last_heartbeat_at === 'string' && source.last_heartbeat_at
                 ? source.last_heartbeat_at
                 : fallback.last_heartbeat_at,
@@ -214,14 +220,16 @@ export class AopKernel {
                 ? source.lease_expires_at
                 : fallback.lease_expires_at,
             orchestrator_epoch: epoch,
-            feature_sessions: featureSessions
+            feature_sessions: featureSessions,
         };
     }
     normalizeIndexShape(value) {
         const now = nowIso();
         const source = value && typeof value === 'object' ? value : {};
         return {
-            version: typeof source.version === 'number' && Number.isFinite(source.version) ? Math.max(1, Math.floor(source.version)) : 1,
+            version: typeof source.version === 'number' && Number.isFinite(source.version)
+                ? Math.max(1, Math.floor(source.version))
+                : 1,
             active: normalizeSet(asArray(source.active).filter((item) => typeof item === 'string')),
             blocked: normalizeSet(asArray(source.blocked).filter((item) => typeof item === 'string')),
             merged: normalizeSet(asArray(source.merged).filter((item) => typeof item === 'string')),
@@ -230,7 +238,7 @@ export class AopKernel {
             blocked_queue: asArray(source.blocked_queue).filter((item) => item && typeof item === 'object'),
             dep_blocked: asArray(source.dep_blocked).filter((item) => item && typeof item === 'object'),
             updated_at: typeof source.updated_at === 'string' && source.updated_at ? source.updated_at : now,
-            runtime_sessions: this.normalizeRuntimeSessions(source.runtime_sessions, now)
+            runtime_sessions: this.normalizeRuntimeSessions(source.runtime_sessions, now),
         };
     }
     isRunLeaseFresh(runtimeSessions) {
@@ -240,12 +248,23 @@ export class AopKernel {
         }
         return expiry > Date.now();
     }
+    async resolveDefaultConfigPath(fileName) {
+        const primary = path.join(this.pathLayout.orchestratorRoot, fileName);
+        if (await pathExists(primary)) {
+            return primary;
+        }
+        const legacy = path.join(this.pathLayout.legacyOrchestratorRoot, fileName);
+        if (await pathExists(legacy)) {
+            return legacy;
+        }
+        return primary;
+    }
     async load() {
         await ensureAopRuntimeLayout(this.pathLayout);
-        const gatesPath = this.configOverrides.gatesPath ?? path.join(this.orchestratorDir, 'gates.yaml');
-        const policyPath = this.configOverrides.policyPath ?? path.join(this.orchestratorDir, 'policy.yaml');
-        const agentsPath = this.configOverrides.agentsPath ?? path.join(this.orchestratorDir, 'agents.yaml');
-        const adaptersPath = this.configOverrides.adaptersPath ?? path.join(this.orchestratorDir, 'adapters.yaml');
+        const gatesPath = this.configOverrides.gatesPath ?? (await this.resolveDefaultConfigPath('gates.yaml'));
+        const policyPath = this.configOverrides.policyPath ?? (await this.resolveDefaultConfigPath('policy.yaml'));
+        const agentsPath = this.configOverrides.agentsPath ?? (await this.resolveDefaultConfigPath('agents.yaml'));
+        const adaptersPath = this.configOverrides.adaptersPath ?? (await this.resolveDefaultConfigPath('adapters.yaml'));
         const gates = await loadAndValidateYaml(this.schemaRegistry, 'gates.schema.json', gatesPath);
         if (!gates.validation.valid) {
             throw new Error(`invalid_gates_yaml:${JSON.stringify(gates.validation.errors)}`);
@@ -356,38 +375,38 @@ export class AopKernel {
         if (text.startsWith('path_out_of_bounds')) {
             return fail(ERROR_CODES.PATH_OUT_OF_BOUNDS, 'Path escapes repository root', {
                 retryable: false,
-                requires_human: true
+                requires_human: true,
             });
         }
         if (text.startsWith('lock_timeout:')) {
             return fail(ERROR_CODES.LOCK_CONFLICT, 'Timed out waiting for lock', {
                 retryable: true,
-                requires_human: false
+                requires_human: false,
             });
         }
         if (text.startsWith('unknown_gate_profile_or_mode:')) {
             return fail(ERROR_CODES.UNKNOWN_GATE_PROFILE_OR_MODE, 'Unknown gate profile or mode', {
                 value: text.split(':')[1],
                 retryable: false,
-                requires_human: true
+                requires_human: true,
             });
         }
         if (text.startsWith('unsupported_parser:')) {
             return fail(ERROR_CODES.UNSUPPORTED_PARSER, 'Gate parser type is not supported', {
                 parser: text.split(':')[1],
                 retryable: false,
-                requires_human: true
+                requires_human: true,
             });
         }
         if (text.includes('qa_index_version_conflict')) {
             return fail(ERROR_CODES.QA_INDEX_VERSION_CONFLICT, 'QA index expected_version did not match current version', {
                 retryable: true,
-                requires_human: false
+                requires_human: false,
             });
         }
         return fail(ERROR_CODES.INTERNAL_ERROR, text, {
             retryable: false,
-            requires_human: true
+            requires_human: true,
         });
     }
     async dispatchTool(toolName, args, context) {
@@ -486,19 +505,19 @@ export class AopKernel {
                 plan: GATE_RESULT.NA,
                 fast: GATE_RESULT.NA,
                 full: GATE_RESULT.NA,
-                merge: GATE_RESULT.NA
+                merge: GATE_RESULT.NA,
             },
             locks: {
-                held: []
+                held: [],
             },
             collisions: {
                 files: [],
                 areas: [],
-                contracts: []
+                contracts: [],
             },
             cluster: { ...DEFAULT_CLUSTER },
             role_status: { ...DEFAULT_ROLE_STATUS },
-            last_updated: nowIso()
+            last_updated: nowIso(),
         };
     }
     async readState(featureId) {
@@ -508,7 +527,7 @@ export class AopKernel {
         return {
             frontMatter: parsed.frontMatter,
             body: parsed.body,
-            raw
+            raw,
         };
     }
     async writeState(featureId, frontMatter, body = '') {
@@ -518,8 +537,8 @@ export class AopKernel {
                 normalizedResponse: fail(ERROR_CODES.STATE_VALIDATION_FAILED, 'state.md front matter failed schema validation', {
                     errors: validation.errors,
                     retryable: false,
-                    requires_human: true
-                })
+                    requires_human: true,
+                }),
             };
         }
         const markdown = buildFrontMatter(frontMatter, body);
@@ -527,12 +546,12 @@ export class AopKernel {
     }
     async withFeatureLock(featureId, operation) {
         return await withFileLock(this.featureLockPath(featureId), operation, {
-            timeoutMs: 30_000
+            timeoutMs: 30_000,
         });
     }
     async withIndexLock(operation) {
         return await withFileLock(this.indexLockPath, operation, {
-            timeoutMs: 30_000
+            timeoutMs: 30_000,
         });
     }
     async readIndex() {
@@ -552,8 +571,8 @@ export class AopKernel {
                 normalizedResponse: fail(ERROR_CODES.INDEX_VALIDATION_FAILED, 'index.json failed schema validation', {
                     errors: validation.errors,
                     retryable: false,
-                    requires_human: true
-                })
+                    requires_human: true,
+                }),
             };
         }
         await atomicWriteJson(this.indexPath, normalized);
@@ -658,8 +677,8 @@ export class AopKernel {
                     feature_id: featureId,
                     branch,
                     worktree_path_abs: worktree,
-                    existed: true
-                }
+                    existed: true,
+                },
             };
         }
         const baseBranch = this.policy.worktree.base_branch;
@@ -674,11 +693,11 @@ export class AopKernel {
                         feature_id: featureId,
                         stderr: branchCreate.stderr,
                         retryable: false,
-                        requires_human: true
+                        requires_human: true,
                     }, {
                         command: ['git', 'branch', branch, baseRef],
-                        exit_code: branchCreate.code
-                    })
+                        exit_code: branchCreate.code,
+                    }),
                 };
             }
         }
@@ -689,11 +708,11 @@ export class AopKernel {
                     feature_id: featureId,
                     stderr: addWorktree.stderr,
                     retryable: false,
-                    requires_human: true
+                    requires_human: true,
                 }, {
                     command: ['git', 'worktree', 'add', worktree, branch],
-                    exit_code: addWorktree.code
-                })
+                    exit_code: addWorktree.code,
+                }),
             };
         }
         const worktreeConfig = this.policy.worktree;
@@ -716,8 +735,8 @@ export class AopKernel {
                 feature_id: featureId,
                 branch,
                 worktree_path_abs: worktree,
-                existed: false
-            }
+                existed: false,
+            },
         };
     }
     async loadAcceptedPlan(featureId) {
@@ -732,28 +751,31 @@ export class AopKernel {
     async repoStatus(featureId) {
         const worktree = this.worktreePath(featureId);
         const status = await runGit(this.repoRoot, ['status', '--porcelain'], { cwd: worktree });
-        const branch = await runGit(this.repoRoot, ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: worktree });
+        const branch = await runGit(this.repoRoot, ['rev-parse', '--abbrev-ref', 'HEAD'], {
+            cwd: worktree,
+        });
         return {
             data: {
                 feature_id: featureId,
                 branch: branch.stdout.trim(),
-                status_porcelain: status.stdout.trim().split('\n').filter(Boolean)
-            }
+                status_porcelain: status.stdout.trim().split('\n').filter(Boolean),
+            },
         };
     }
     async repoDiff(featureId, options = []) {
         const safeOptions = asArray(options).filter((option) => typeof option === 'string' && option.startsWith('--'));
-        const diff = await runGit(this.repoRoot, ['diff', ...safeOptions], { cwd: this.worktreePath(featureId) });
+        const diff = await runGit(this.repoRoot, ['diff', ...safeOptions], {
+            cwd: this.worktreePath(featureId),
+        });
         return {
             data: {
                 feature_id: featureId,
-                diff: diff.stdout
-            }
+                diff: diff.stdout,
+            },
         };
     }
     async repoReadFile(featureId, filePath) {
-        const normalized = await normalizeRepoPath(this.repoRoot, path.join(this.worktreePath(featureId), filePath), this.policy.path_rules.allow_symlink_traversal)
-            .then((relative) => normalizeFromWorktree(this.worktreePath(featureId), this.repoRoot, relative));
+        const normalized = await normalizeRepoPath(this.repoRoot, path.join(this.worktreePath(featureId), filePath), this.policy.path_rules.allow_symlink_traversal).then((relative) => normalizeFromWorktree(this.worktreePath(featureId), this.repoRoot, relative));
         const absolute = path.join(this.repoRoot, normalized);
         const exists = await pathExists(absolute);
         if (!exists) {
@@ -761,8 +783,8 @@ export class AopKernel {
                 normalizedResponse: fail(ERROR_CODES.FILE_NOT_FOUND, 'File not found', {
                     path: normalized,
                     retryable: false,
-                    requires_human: false
-                })
+                    requires_human: false,
+                }),
             };
         }
         const content = await fs.readFile(absolute, 'utf8');
@@ -770,23 +792,23 @@ export class AopKernel {
             data: {
                 feature_id: featureId,
                 path: normalized,
-                content
-            }
+                content,
+            },
         };
     }
     async repoSearch(featureId, query) {
         const worktree = this.worktreePath(featureId);
         const rgResult = await runCommand('rg', ['-n', '--no-heading', query, '.'], {
             cwd: worktree,
-            timeoutMs: 30_000
+            timeoutMs: 30_000,
         });
         if (rgResult.code === 127) {
             throw {
                 normalizedResponse: fail(ERROR_CODES.GIT_FAILURE, 'ripgrep (rg) not found - required for search functionality', {
                     stderr: rgResult.stderr,
                     retryable: false,
-                    requires_human: true
-                })
+                    requires_human: true,
+                }),
             };
         }
         if (rgResult.code !== 0 && rgResult.code !== 1) {
@@ -794,8 +816,8 @@ export class AopKernel {
                 normalizedResponse: fail(ERROR_CODES.GIT_FAILURE, 'Search failed', {
                     stderr: rgResult.stderr,
                     retryable: true,
-                    requires_human: false
-                })
+                    requires_human: false,
+                }),
             };
         }
         const matches = rgResult.stdout
@@ -811,30 +833,37 @@ export class AopKernel {
             return {
                 path: line.slice(0, firstColon),
                 line: Number(line.slice(firstColon + 1, secondColon)),
-                snippet: line.slice(secondColon + 1)
+                snippet: line.slice(secondColon + 1),
             };
         });
         return {
             data: {
                 feature_id: featureId,
                 query,
-                matches
-            }
+                matches,
+            },
         };
     }
     async repoDiffBundle(featureId) {
-        const stat = await runGit(this.repoRoot, ['diff', '--stat'], { cwd: this.worktreePath(featureId) });
+        const stat = await runGit(this.repoRoot, ['diff', '--stat'], {
+            cwd: this.worktreePath(featureId),
+        });
         const full = await runGit(this.repoRoot, ['diff'], { cwd: this.worktreePath(featureId) });
-        const names = await runGit(this.repoRoot, ['diff', '--name-only'], { cwd: this.worktreePath(featureId) });
+        const names = await runGit(this.repoRoot, ['diff', '--name-only'], {
+            cwd: this.worktreePath(featureId),
+        });
         const latest = await this.evidenceLatest(featureId);
         return {
             data: {
                 feature_id: featureId,
                 diff_stat: stat.stdout,
                 diff: full.stdout,
-                touched_files: names.stdout.split('\n').map((x) => x.trim()).filter(Boolean),
-                last_gate_summary: latest.data?.latest ?? null
-            }
+                touched_files: names.stdout
+                    .split('\n')
+                    .map((x) => x.trim())
+                    .filter(Boolean),
+                last_gate_summary: latest.data?.latest ?? null,
+            },
         };
     }
     async gatesList(profileName = null) {
@@ -878,7 +907,7 @@ export class AopKernel {
             dryRun: dryRun ?? undefined,
             confirm: confirm ?? undefined,
             removeWorktree: removeWorktree ?? undefined,
-            removeBranch: removeBranch ?? undefined
+            removeBranch: removeBranch ?? undefined,
         });
     }
     async renewLeases(featureIds) {
@@ -906,15 +935,27 @@ export class AopKernel {
     }
     async featureSendMessage(featureId, message) {
         if (!featureId) {
-            throw { normalizedResponse: fail(ERROR_CODES.INVALID_ARGUMENT, 'feature_id is required', { retryable: false, requires_human: false }) };
+            throw {
+                normalizedResponse: fail(ERROR_CODES.INVALID_ARGUMENT, 'feature_id is required', {
+                    retryable: false,
+                    requires_human: false,
+                }),
+            };
         }
         if (!message) {
-            throw { normalizedResponse: fail(ERROR_CODES.INVALID_ARGUMENT, 'message is required and must not be empty', { retryable: false, requires_human: false }) };
+            throw {
+                normalizedResponse: fail(ERROR_CODES.INVALID_ARGUMENT, 'message is required and must not be empty', { retryable: false, requires_human: false }),
+            };
         }
         const runtimeSessions = await this.getRuntimeSessions();
         const featureSession = runtimeSessions.feature_sessions?.[featureId];
         if (!featureSession) {
-            throw { normalizedResponse: { ok: false, error: { code: 'session_not_found', message: 'No active session cluster for feature' } } };
+            throw {
+                normalizedResponse: {
+                    ok: false,
+                    error: { code: 'session_not_found', message: 'No active session cluster for feature' },
+                },
+            };
         }
         const state = await this.readState(featureId);
         const status = typeof state.frontMatter.status === 'string' ? state.frontMatter.status : '';
@@ -950,7 +991,12 @@ export class AopKernel {
             targetSessionId = runtimeSessions.orchestrator_session_id;
         }
         if (!this.provider?.sendMessage) {
-            throw { normalizedResponse: { ok: false, error: { code: 'provider_unsupported', message: 'Provider does not support sendMessage' } } };
+            throw {
+                normalizedResponse: {
+                    ok: false,
+                    error: { code: 'provider_unsupported', message: 'Provider does not support sendMessage' },
+                },
+            };
         }
         await this.waitForSessionToBecomeActive(targetSessionId);
         await this.provider.sendMessage(targetSessionId, message);
@@ -959,7 +1005,7 @@ export class AopKernel {
             session_id: targetSessionId,
             target_role: targetRole,
             status,
-            delivered: true
+            delivered: true,
         };
     }
     async costRecord(featureId, tokensDelta, costUsdDelta) {
@@ -983,7 +1029,7 @@ export class AopKernel {
             retry_count: typeof args.retry_count === 'number' ? args.retry_count : 0,
             duration_ms: typeof args.duration_ms === 'number' ? args.duration_ms : 0,
             cost_usd: typeof args.cost_usd === 'number' ? args.cost_usd : 0,
-            recorded_at: nowIso()
+            recorded_at: nowIso(),
         };
         const snapshot = await this.performanceAnalyticsService.recordOutcome(outcome);
         return { ok: true, data: { total_outcomes: snapshot.outcomes.length } };
@@ -992,7 +1038,14 @@ export class AopKernel {
         if (provider || model) {
             const stats = await this.performanceAnalyticsService.getProviderStats(provider ?? undefined, model ?? undefined);
             const snapshot = await this.performanceAnalyticsService.getAnalytics();
-            return { ok: true, data: { outcomes: snapshot.outcomes, aggregates: stats, generated_at: snapshot.generated_at } };
+            return {
+                ok: true,
+                data: {
+                    outcomes: snapshot.outcomes,
+                    aggregates: stats,
+                    generated_at: snapshot.generated_at,
+                },
+            };
         }
         const snapshot = await this.performanceAnalyticsService.getAnalytics();
         return { ok: true, data: snapshot };