agentic-orchestrator 0.1.26 → 0.1.28

package/apps/control-plane/test/worktree-watchdog-service.spec.ts

@@ -0,0 +1,147 @@
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { describe, expect, it, vi } from 'vitest';
+import { runGit } from '../src/core/git.js';
+import { WorktreeWatchdogService } from '../src/application/services/worktree-watchdog-service.js';
+
+async function initGitRepo(prefix: string): Promise<string> {
+  const repoRoot = await fs.mkdtemp(path.join(os.tmpdir(), prefix));
+  await runGit(repoRoot, ['init']);
+  await runGit(repoRoot, ['config', 'user.email', 'test@example.com']);
+  await runGit(repoRoot, ['config', 'user.name', 'AOP Test']);
+  await fs.writeFile(path.join(repoRoot, 'tracked.txt'), 'initial\n', 'utf8');
+  await runGit(repoRoot, ['add', '.']);
+  await runGit(repoRoot, ['commit', '-m', 'init']);
+  return repoRoot;
+}
+
+async function waitForCondition(check: () => Promise<boolean>, timeoutMs = 2_000): Promise<void> {
+  const startedAt = Date.now();
+  while (Date.now() - startedAt <= timeoutMs) {
+    if (await check()) {
+      return;
+    }
+    await new Promise((resolve) => setTimeout(resolve, 25));
+  }
+  throw new Error('timeout waiting for condition');
+}
+
+describe('WorktreeWatchdogService', () => {
+  it('returns empty defaults for unknown features and handles missing watchers', async () => {
+    const service = new WorktreeWatchdogService();
+    await expect(service.stopWatching('missing-feature')).resolves.toBeUndefined();
+    service.resetChangeCount('missing-feature');
+    expect(service.getChangeCount('missing-feature')).toBe(0);
+    await expect(service.getChangedFiles('missing-feature')).resolves.toEqual([]);
+  });
+
+  it('detects changed files and emits threshold events', async () => {
+    const repoRoot = await initGitRepo('aop-watchdog-');
+    const service = new WorktreeWatchdogService();
+    const thresholdSpy = vi.fn();
+
+    try {
+      service.on('changeThreshold', thresholdSpy);
+      await service.startWatching({
+        featureId: 'feature_watchdog',
+        repoRoot,
+        worktreePath: repoRoot,
+        pollIntervalMs: 25,
+        maxUncommittedChanges: 1,
+      });
+
+      await fs.writeFile(path.join(repoRoot, 'tracked.txt'), 'updated\n', 'utf8');
+
+      await waitForCondition(async () => service.getChangeCount('feature_watchdog') > 0);
+      const changed = await service.getChangedFiles('feature_watchdog');
+
+      expect(changed).toContain('tracked.txt');
+      expect(thresholdSpy).toHaveBeenCalledWith('feature_watchdog');
+    } finally {
+      await service.stopWatching('feature_watchdog');
+      await fs.rm(repoRoot, { recursive: true, force: true });
+    }
+  });
+
+  it('resets tracked changes and stops cleanly', async () => {
+    const repoRoot = await initGitRepo('aop-watchdog-reset-');
+    const service = new WorktreeWatchdogService();
+
+    try {
+      await service.startWatching({
+        featureId: 'feature_reset',
+        repoRoot,
+        worktreePath: repoRoot,
+        pollIntervalMs: 25,
+        maxUncommittedChanges: 2,
+      });
+      await fs.writeFile(path.join(repoRoot, 'tracked.txt'), 'changed\n', 'utf8');
+      await waitForCondition(async () => service.getChangeCount('feature_reset') > 0);
+
+      service.resetChangeCount('feature_reset');
+      expect(service.getChangeCount('feature_reset')).toBe(0);
+
+      await service.stopWatching('feature_reset');
+      const changed = await service.getChangedFiles('feature_reset');
+      expect(changed).toEqual([]);
+    } finally {
+      await service.stopWatching('feature_reset');
+      await fs.rm(repoRoot, { recursive: true, force: true });
+    }
+  });
+
+  it('tracks rename paths and resets threshold after worktree is clean again', async () => {
+    const repoRoot = await initGitRepo('aop-watchdog-rename-');
+    const service = new WorktreeWatchdogService();
+    const thresholdSpy = vi.fn();
+
+    try {
+      service.on('changeThreshold', thresholdSpy);
+      await service.startWatching({
+        featureId: 'feature_rename',
+        repoRoot,
+        worktreePath: repoRoot,
+        pollIntervalMs: 25,
+        maxUncommittedChanges: 1,
+      });
+
+      await runGit(repoRoot, ['mv', 'tracked.txt', 'renamed.txt'], { cwd: repoRoot });
+      await waitForCondition(async () =>
+        (await service.getChangedFiles('feature_rename')).includes('renamed.txt'),
+      );
+      expect(thresholdSpy).toHaveBeenCalledTimes(1);
+
+      await runGit(repoRoot, ['reset', '--hard', 'HEAD'], { cwd: repoRoot });
+      await waitForCondition(async () => service.getChangeCount('feature_rename') === 0);
+
+      await fs.writeFile(path.join(repoRoot, 'tracked.txt'), 'again\\n', 'utf8');
+      await waitForCondition(async () => thresholdSpy.mock.calls.length >= 2);
+      expect(thresholdSpy.mock.calls.length).toBeGreaterThanOrEqual(2);
+    } finally {
+      await service.stopWatching('feature_rename');
+      await fs.rm(repoRoot, { recursive: true, force: true });
+    }
+  });
+
+  it('handles non-zero git status polls without throwing', async () => {
+    const repoRoot = await initGitRepo('aop-watchdog-nonzero-');
+    const service = new WorktreeWatchdogService();
+
+    try {
+      await service.startWatching({
+        featureId: 'feature_bad_status',
+        repoRoot,
+        worktreePath: path.join(repoRoot, '.missing-worktree'),
+        pollIntervalMs: -10,
+        maxUncommittedChanges: -5,
+      });
+
+      expect(service.getChangeCount('feature_bad_status')).toBe(0);
+      expect(await service.getChangedFiles('feature_bad_status')).toEqual([]);
+    } finally {
+      await service.stopWatching('feature_bad_status');
+      await fs.rm(repoRoot, { recursive: true, force: true });
+    }
+  });
+});

package/config/agentic/orchestrator/agents.yaml

@@ -10,6 +10,19 @@ missing_prompt_behavior: ignore
 runtime:
   default_provider: claude
   default_model: local-default
+  execution_mode: interactive
+  interactive:
+    watchdog_poll_interval_ms: 2000
+    checkpoint_interval_ms: 30000
+    max_uncommitted_changes: 50
+    validation_on_checkpoint: true
+    revert_on_violation: false
+    violation_severity: warning
+    shadow_workspace:
+      enabled: false
+      promotion_strategy: atomic
+      cleanup_on_failure: true
+      max_shadow_size_mb: 2048
   worker_provider_mode: live
   worker_response_timeout_ms: 1800000
   worker_spawn_timeout_ms: 15000

package/dist/apps/control-plane/application/configuration-service.d.ts

@@ -0,0 +1,19 @@
+import type { SchemaRegistry } from '../core/schemas.js';
+import type { AopPathLayout } from '../core/path-layout.js';
+import type { AnyRecord, KernelConfigOverrides, AgentsConfigSnapshot, PolicyConfigSnapshot } from '../core/kernel-types.js';
+export interface LoadedConfiguration {
+    gatesConfig: AnyRecord;
+    policy: PolicyConfigSnapshot;
+    agentsConfig: AgentsConfigSnapshot;
+    adaptersConfig: Record<string, unknown>;
+    toolRegistry: AnyRecord | null;
+}
+export declare class ConfigurationService {
+    private readonly repoRoot;
+    private readonly pathLayout;
+    private readonly schemaRegistry;
+    private readonly configOverrides;
+    constructor(repoRoot: string, pathLayout: AopPathLayout, schemaRegistry: SchemaRegistry, configOverrides: KernelConfigOverrides);
+    private resolveDefaultConfigPath;
+    loadAll(): Promise<LoadedConfiguration>;
+}

package/dist/apps/control-plane/application/configuration-service.js

@@ -0,0 +1,123 @@
+import path from 'node:path';
+import { pathExists } from '../core/fs.js';
+import { loadAndValidateYaml } from '../core/schemas.js';
+import { ensureAopRuntimeLayout } from '../core/path-layout.js';
+import { loadComposedPolicy } from './services/policy-loader-service.js';
+import { ACTIVITY_DETECTOR_SLOT, NOTIFICATION_CHANNEL_SLOT, SCM_PROVIDER_SLOT, globalAdapterRegistry, } from './adapters/adapter-registry.js';
+import { ToolRegistryLoader } from '../mcp/tool-registry-loader.js';
+import { ERROR_CODES } from '../core/error-codes.js';
+import { readStringField, readObjectField, readPositiveIntegerField, } from '../core/utils/field-readers.js';
+function validateAgentRuntimeTimeoutRelationships(agentsConfig) {
+    const runtime = readObjectField(agentsConfig, 'runtime');
+    if (Object.keys(runtime).length === 0) {
+        return;
+    }
+    const responseTimeoutMs = readPositiveIntegerField(runtime, 'worker_response_timeout_ms');
+    const spawnTimeoutMs = readPositiveIntegerField(runtime, 'worker_spawn_timeout_ms');
+    const idleTimeoutMs = readPositiveIntegerField(runtime, 'worker_idle_timeout_ms');
+    if (responseTimeoutMs != null && spawnTimeoutMs != null && spawnTimeoutMs >= responseTimeoutMs) {
+        throw new Error('invalid_agents_yaml:runtime.worker_spawn_timeout_ms must be less than runtime.worker_response_timeout_ms');
+    }
+    if (responseTimeoutMs != null && idleTimeoutMs != null && idleTimeoutMs > responseTimeoutMs) {
+        throw new Error('invalid_agents_yaml:runtime.worker_idle_timeout_ms must be less than or equal to runtime.worker_response_timeout_ms');
+    }
+}
+export class ConfigurationService {
+    repoRoot;
+    pathLayout;
+    schemaRegistry;
+    configOverrides;
+    constructor(repoRoot, pathLayout, schemaRegistry, configOverrides) {
+        this.repoRoot = repoRoot;
+        this.pathLayout = pathLayout;
+        this.schemaRegistry = schemaRegistry;
+        this.configOverrides = configOverrides;
+    }
+    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 loadAll() {
+        await ensureAopRuntimeLayout(this.pathLayout);
+        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)}`);
+        }
+        const { mergedPolicy } = await loadComposedPolicy(this.repoRoot, policyPath, this.schemaRegistry);
+        const parsedPolicy = mergedPolicy;
+        const implementation = readObjectField(parsedPolicy, 'implementation');
+        const testing = readObjectField(parsedPolicy, 'testing');
+        if (readStringField(implementation, 'workspace') !== 'nx') {
+            throw new Error(ERROR_CODES.INVALID_WORKSPACE_IMPLEMENTATION);
+        }
+        if (readStringField(testing, 'framework') !== 'vitest') {
+            throw new Error(ERROR_CODES.INVALID_WORKSPACE_IMPLEMENTATION);
+        }
+        const agentsExists = await pathExists(agentsPath);
+        let agents = { parsed: { version: 1, roles: {} }, validation: { valid: true, errors: [] } };
+        if (agentsExists) {
+            agents = await loadAndValidateYaml(this.schemaRegistry, 'agents.schema.json', agentsPath);
+            if (!agents.validation.valid) {
+                throw new Error(`invalid_agents_yaml:${JSON.stringify(agents.validation.errors)}`);
+            }
+            validateAgentRuntimeTimeoutRelationships(agents.parsed);
+        }
+        const adaptersExists = await pathExists(adaptersPath);
+        let adapters = { parsed: {}, validation: { valid: true, errors: [] } };
+        if (adaptersExists) {
+            adapters = await loadAndValidateYaml(this.schemaRegistry, 'adapters.schema.json', adaptersPath);
+            if (!adapters.validation.valid) {
+                throw new Error(`invalid_adapters_yaml:${JSON.stringify(adapters.validation.errors)}`);
+            }
+            const parsedAdapters = readObjectField(adapters, 'parsed');
+            const notificationChannel = readStringField(parsedAdapters, NOTIFICATION_CHANNEL_SLOT.name);
+            if (notificationChannel) {
+                try {
+                    globalAdapterRegistry.resolve(NOTIFICATION_CHANNEL_SLOT, notificationChannel, {});
+                }
+                catch {
+                    throw new Error(`adapter_not_found:${NOTIFICATION_CHANNEL_SLOT.name}:${notificationChannel}`);
+                }
+            }
+            const activityDetector = readStringField(parsedAdapters, ACTIVITY_DETECTOR_SLOT.name);
+            if (activityDetector) {
+                try {
+                    globalAdapterRegistry.resolve(ACTIVITY_DETECTOR_SLOT, activityDetector, {});
+                }
+                catch {
+                    throw new Error(`adapter_not_found:${ACTIVITY_DETECTOR_SLOT.name}:${activityDetector}`);
+                }
+            }
+            const scmProvider = readStringField(parsedAdapters, SCM_PROVIDER_SLOT.name);
+            if (scmProvider) {
+                try {
+                    globalAdapterRegistry.resolve(SCM_PROVIDER_SLOT, scmProvider, {});
+                }
+                catch {
+                    throw new Error(`adapter_not_found:${SCM_PROVIDER_SLOT.name}:${scmProvider}`);
+                }
+            }
+        }
+        const registryLoader = new ToolRegistryLoader(this.repoRoot);
+        const toolRegistry = await registryLoader.load();
+        return {
+            gatesConfig: gates.parsed,
+            policy: parsedPolicy,
+            agentsConfig: agents.parsed,
+            adaptersConfig: readObjectField(adapters, 'parsed'),
+            toolRegistry,
+        };
+    }
+}
+//# sourceMappingURL=configuration-service.js.map

package/dist/apps/control-plane/application/configuration-service.js.map

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

package/dist/apps/control-plane/application/kernel-tool-wiring.d.ts

@@ -0,0 +1,39 @@
+import type { ToolHandlerRegistry, ToolHandlerContext } from './tools/tool-router.js';
+type AnyRecord = Record<string, any>;
+export interface KernelToolFacade {
+    featureDiscoverSpecs(): Promise<unknown>;
+    featureInit(featureId: string | null): Promise<unknown>;
+    featureGetContext(featureId: string | null): Promise<unknown>;
+    featureStateGet(featureId: string | null): Promise<unknown>;
+    featureStatePatch(featureId: string | null, expectedVersion: number | null, patch: unknown): Promise<unknown>;
+    featureLogAppend(featureId: string | null, note: string | null, context: ToolHandlerContext): Promise<unknown>;
+    planSubmit(featureId: string | null, plan: unknown, expectedVersion: number | null): Promise<unknown>;
+    planGet(featureId: string | null): Promise<unknown>;
+    planUpdate(featureId: string | null, expectedPlanVersion: number | null, plan: unknown): Promise<unknown>;
+    repoEnsureWorktree(featureId: string | null): Promise<unknown>;
+    repoApplyPatch(featureId: string | null, unifiedDiff: string | null): Promise<unknown>;
+    repoStatus(featureId: string | null): Promise<unknown>;
+    repoDiff(featureId: string | null, options: string[]): Promise<unknown>;
+    repoReadFile(featureId: string | null, filePath: string | null): Promise<unknown>;
+    repoSearch(featureId: string | null, query: string | null): Promise<unknown>;
+    repoDiffBundle(featureId: string | null): Promise<unknown>;
+    featureReadyToMerge(featureId: string | null, commitMessage: string | null, mergeStrategy: string | null, userApprovalToken: string | null): Promise<unknown>;
+    featureDelete(featureId: string | null, dryRun: boolean | null, confirm: boolean | null, removeWorktree: boolean | null, removeBranch: string | null): Promise<unknown>;
+    gatesList(profileName: string | null): Promise<unknown>;
+    gatesRun(featureId: string | null, profileName: string | null, mode: string | null): Promise<unknown>;
+    evidenceLatest(featureId: string | null): Promise<unknown>;
+    qaTestIndexGet(featureId: string | null): Promise<unknown>;
+    qaTestIndexUpdate(featureId: string | null, expectedVersion: number | null, updates: unknown, evidenceRefs: unknown[]): Promise<unknown>;
+    locksAcquire(resource: string | null, featureId: string | null, waitTimeoutSeconds: number | null): Promise<unknown>;
+    locksRelease(resource: string | null, featureId: string | null): Promise<unknown>;
+    collisionsScan(): Promise<unknown>;
+    reportDashboard(): Promise<unknown>;
+    reportFeatureSummary(featureId: string | null): Promise<unknown>;
+    featureSendMessage(featureId: string | null, message: string | null): Promise<unknown>;
+    costRecord(featureId: string | null, tokensDelta: number, costUsdDelta: number): Promise<unknown>;
+    costGet(featureId: string | null): Promise<unknown>;
+    performanceRecordOutcome(args: AnyRecord): Promise<unknown>;
+    performanceGetAnalytics(provider: string | null, model: string | null): Promise<unknown>;
+}
+export declare function registerKernelTools(toolHandlers: ToolHandlerRegistry, kernel: KernelToolFacade): void;
+export {};

package/dist/apps/control-plane/application/kernel-tool-wiring.js

@@ -0,0 +1,38 @@
+import { TOOLS } from '../core/constants.js';
+import { readStringField, readNumberField, readBooleanField, asArray, } from '../core/utils/field-readers.js';
+export function registerKernelTools(toolHandlers, kernel) {
+    toolHandlers.register(TOOLS.FEATURE_DISCOVER_SPECS, async () => await kernel.featureDiscoverSpecs());
+    toolHandlers.register(TOOLS.FEATURE_INIT, async (args) => await kernel.featureInit(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.FEATURE_GET_CONTEXT, async (args) => await kernel.featureGetContext(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.FEATURE_STATE_GET, async (args) => await kernel.featureStateGet(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.FEATURE_STATE_PATCH, async (args) => await kernel.featureStatePatch(readStringField(args, 'feature_id'), readNumberField(args, 'expected_version'), args.patch));
+    toolHandlers.register(TOOLS.FEATURE_LOG_APPEND, async (args, context) => await kernel.featureLogAppend(readStringField(args, 'feature_id'), readStringField(args, 'note'), context));
+    toolHandlers.register(TOOLS.PLAN_SUBMIT, async (args) => await kernel.planSubmit(readStringField(args, 'feature_id'), args.plan_json, readNumberField(args, 'expected_version')));
+    toolHandlers.register(TOOLS.PLAN_GET, async (args) => await kernel.planGet(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.PLAN_UPDATE, async (args) => await kernel.planUpdate(readStringField(args, 'feature_id'), readNumberField(args, 'expected_plan_version'), args.plan_json));
+    toolHandlers.register(TOOLS.REPO_ENSURE_WORKTREE, async (args) => await kernel.repoEnsureWorktree(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.REPO_APPLY_PATCH, async (args) => await kernel.repoApplyPatch(readStringField(args, 'feature_id'), readStringField(args, 'unified_diff')));
+    toolHandlers.register(TOOLS.REPO_STATUS, async (args) => await kernel.repoStatus(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.REPO_DIFF, async (args) => await kernel.repoDiff(readStringField(args, 'feature_id'), asArray(args.options)));
+    toolHandlers.register(TOOLS.REPO_READ_FILE, async (args) => await kernel.repoReadFile(readStringField(args, 'feature_id'), readStringField(args, 'path')));
+    toolHandlers.register(TOOLS.REPO_SEARCH, async (args) => await kernel.repoSearch(readStringField(args, 'feature_id'), readStringField(args, 'query')));
+    toolHandlers.register(TOOLS.REPO_DIFF_BUNDLE, async (args) => await kernel.repoDiffBundle(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.FEATURE_READY_TO_MERGE, async (args) => await kernel.featureReadyToMerge(readStringField(args, 'feature_id'), readStringField(args, 'commit_message'), readStringField(args, 'merge_strategy'), readStringField(args, 'user_approval_token')));
+    toolHandlers.register(TOOLS.FEATURE_DELETE, async (args) => await kernel.featureDelete(readStringField(args, 'feature_id'), readBooleanField(args, 'dry_run'), readBooleanField(args, 'confirm'), readBooleanField(args, 'remove_worktree'), readStringField(args, 'remove_branch')));
+    toolHandlers.register(TOOLS.GATES_LIST, async (args) => await kernel.gatesList(readStringField(args, 'profile')));
+    toolHandlers.register(TOOLS.GATES_RUN, async (args) => await kernel.gatesRun(readStringField(args, 'feature_id'), readStringField(args, 'profile'), readStringField(args, 'mode')));
+    toolHandlers.register(TOOLS.EVIDENCE_LATEST, async (args) => await kernel.evidenceLatest(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.QA_TEST_INDEX_GET, async (args) => await kernel.qaTestIndexGet(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.QA_TEST_INDEX_UPDATE, async (args) => await kernel.qaTestIndexUpdate(readStringField(args, 'feature_id'), readNumberField(args, 'expected_version'), args.updates, asArray(args.evidence_refs)));
+    toolHandlers.register(TOOLS.LOCKS_ACQUIRE, async (args) => await kernel.locksAcquire(readStringField(args, 'resource'), readStringField(args, 'feature_id'), readNumberField(args, 'wait_timeout_seconds')));
+    toolHandlers.register(TOOLS.LOCKS_RELEASE, async (args) => await kernel.locksRelease(readStringField(args, 'resource'), readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.COLLISIONS_SCAN, async () => await kernel.collisionsScan());
+    toolHandlers.register(TOOLS.REPORT_DASHBOARD, async () => await kernel.reportDashboard());
+    toolHandlers.register(TOOLS.REPORT_FEATURE_SUMMARY, async (args) => await kernel.reportFeatureSummary(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.FEATURE_SEND_MESSAGE, async (args) => await kernel.featureSendMessage(readStringField(args, 'feature_id'), readStringField(args, 'message')));
+    toolHandlers.register(TOOLS.COST_RECORD, async (args) => await kernel.costRecord(readStringField(args, 'feature_id'), typeof args.tokens_used_delta === 'number' ? args.tokens_used_delta : 0, typeof args.estimated_cost_usd_delta === 'number' ? args.estimated_cost_usd_delta : 0));
+    toolHandlers.register(TOOLS.COST_GET, async (args) => await kernel.costGet(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.PERFORMANCE_RECORD_OUTCOME, async (args) => await kernel.performanceRecordOutcome(args));
+    toolHandlers.register(TOOLS.PERFORMANCE_GET_ANALYTICS, async (args) => await kernel.performanceGetAnalytics(readStringField(args, 'provider'), readStringField(args, 'model')));
+}
+//# sourceMappingURL=kernel-tool-wiring.js.map

package/dist/apps/control-plane/application/kernel-tool-wiring.js.map

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

package/dist/apps/control-plane/application/services/checkpoint-service.d.ts

@@ -0,0 +1,84 @@
+import { parseUnifiedDiff } from '../../core/patch.js';
+import type { PatchValidationResult } from './patch-service.js';
+import type { WorktreeWatchdogService } from './worktree-watchdog-service.js';
+export type ViolationSeverity = 'info' | 'warning' | 'error' | 'critical';
+export type CheckpointValidationStatus = 'valid' | 'invalid' | 'skipped';
+export interface InteractiveExecutionConfig {
+    checkpointIntervalMs: number;
+    watchdogPollIntervalMs: number;
+    maxUncommittedChanges: number;
+    validationOnCheckpoint: boolean;
+    revertOnViolation: boolean;
+    violationSeverity: ViolationSeverity;
+}
+export interface CreateCheckpointInput {
+    featureId: string;
+    sessionId?: string | null;
+    trigger: 'interval' | 'change_threshold' | 'final';
+}
+export interface CheckpointRecord {
+    checkpoint_id: string;
+    timestamp: string;
+    files_changed: string[];
+    validation_status: CheckpointValidationStatus;
+    violations: string[];
+    severity?: ViolationSeverity;
+    diff_snapshot: string;
+}
+interface UpdateStateFn {
+    (featureId: string, expectedVersion: number | null, updater: (frontMatter: Record<string, unknown>, body: string) => Promise<{
+        frontMatter?: Record<string, unknown>;
+        body?: string;
+    }>): Promise<Record<string, unknown>>;
+}
+interface CheckpointServiceDependencies {
+    repoRoot: string;
+    featurePathResolver: (featureId: string) => string;
+    worktreePathResolver: (featureId: string) => string;
+    validateDiff: (featureId: string, parsedDiff: ReturnType<typeof parseUnifiedDiff>) => Promise<PatchValidationResult>;
+    watchdog: WorktreeWatchdogService;
+    provider: CheckpointProviderPort;
+    readState: (featureId: string) => Promise<{
+        frontMatter: Record<string, unknown>;
+    }>;
+    updateState: UpdateStateFn;
+    config: InteractiveExecutionConfig;
+}
+/**
+ * Minimal provider contract used by checkpoint validation for agent notifications.
+ *
+ * This keeps application services decoupled from provider-layer runtime interfaces.
+ */
+export interface CheckpointProviderPort {
+    sendMessage?: (sessionId: string, message: string) => Promise<void>;
+}
+/**
+ * Captures and validates interactive-mode checkpoints against plan/policy/locks.
+ */
+export declare class CheckpointService {
+    private readonly repoRoot;
+    private readonly featurePathResolver;
+    private readonly worktreePathResolver;
+    private readonly validateDiff;
+    private readonly watchdog;
+    private readonly provider;
+    private readonly readState;
+    private readonly updateState;
+    private readonly config;
+    private readonly inFlightByFeature;
+    constructor(dependencies: CheckpointServiceDependencies);
+    createCheckpoint(input: CreateCheckpointInput): Promise<{
+        checkpoint: CheckpointRecord;
+        valid: boolean;
+        blockMerge: boolean;
+    }>;
+    getCheckpoints(featureId: string): Promise<CheckpointRecord[]>;
+    private notifyAgent;
+    private recordCheckpoint;
+    private readCheckpoints;
+    private interactiveMetricsPath;
+    private normalizeMetricsSnapshot;
+    private recordInteractiveMetrics;
+    private withFeatureLock;
+}
+export {};