agentic-orchestrator 0.1.0

package/dist/apps/control-plane/cli/cli-argument-parser.js

@@ -0,0 +1,109 @@
+import { ERROR_CODES } from '../core/error-codes.js';
+function parseOptionalBooleanToken(token) {
+    if (token === 'true') {
+        return true;
+    }
+    if (token === 'false') {
+        return false;
+    }
+    return null;
+}
+export class CliArgumentParser {
+    parse(argv) {
+        const [first, ...rest] = argv;
+        const command = first !== undefined && !first.startsWith('-') ? first : 'run';
+        const tokens = first !== undefined && !first.startsWith('-') ? rest : argv;
+        const options = {
+            command: command ?? 'run'
+        };
+        for (let index = 0; index < tokens.length; index += 1) {
+            const token = tokens[index];
+            const next = tokens[index + 1];
+            if (token === '-fi') {
+                options.file_input = next;
+                index += 1;
+                continue;
+            }
+            if (token === '-fl') {
+                options.folder_input = next;
+                index += 1;
+                continue;
+            }
+            if (token === '--agent-provider') {
+                options.agent_provider = next;
+                index += 1;
+                continue;
+            }
+            if (token === '--feature-id') {
+                options.feature_id = next;
+                index += 1;
+                continue;
+            }
+            if (token === '--dry-run') {
+                const parsed = parseOptionalBooleanToken(next);
+                if (parsed === null) {
+                    options.dry_run = true;
+                }
+                else {
+                    options.dry_run = parsed;
+                    index += 1;
+                }
+                continue;
+            }
+            if (token === '--yes') {
+                options.yes = true;
+                continue;
+            }
+            if (token === '--remove-worktree') {
+                const parsed = parseOptionalBooleanToken(next);
+                if (parsed === null) {
+                    options.remove_worktree = true;
+                }
+                else {
+                    options.remove_worktree = parsed;
+                    index += 1;
+                }
+                continue;
+            }
+            if (token === '--remove-branch') {
+                options.remove_branch = next;
+                index += 1;
+                continue;
+            }
+            if (token === '--agent-model') {
+                options.agent_model = next;
+                index += 1;
+                continue;
+            }
+            if (token === '--provider-config-env') {
+                options.provider_config_env = next;
+                index += 1;
+                continue;
+            }
+            if (token === '--transport') {
+                options.transport = next;
+                index += 1;
+                continue;
+            }
+            if (token === '--takeover-stale-run') {
+                options.takeover_stale_run = true;
+            }
+        }
+        return options;
+    }
+    resolveTransport(option) {
+        const raw = (option ?? 'mcp').toLowerCase();
+        if (raw === 'inprocess' || raw === 'mcp') {
+            return raw;
+        }
+        const error = new Error(ERROR_CODES.INVALID_CLI_ARGS);
+        error.code = ERROR_CODES.INVALID_CLI_ARGS;
+        error.details = {
+            reason: 'Invalid --transport value',
+            provided: option,
+            expected: ['inprocess', 'mcp']
+        };
+        throw error;
+    }
+}
+//# sourceMappingURL=cli-argument-parser.js.map

package/dist/apps/control-plane/cli/cli-argument-parser.js.map

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

package/dist/apps/control-plane/cli/delete-command-handler.d.ts

@@ -0,0 +1,8 @@
+import type { ToolClient } from '../mcp/tool-client.js';
+import type { CliOptions } from './types.js';
+export declare class DeleteCommandHandler {
+    private readonly toolClient;
+    private readonly runId;
+    constructor(toolClient: ToolClient, runId: string);
+    execute(options: CliOptions): Promise<unknown>;
+}

package/dist/apps/control-plane/cli/delete-command-handler.js

@@ -0,0 +1,77 @@
+import { ERROR_CODES } from '../core/error-codes.js';
+import { TOOLS } from '../core/constants.js';
+import { callCliTool } from './tooling.js';
+function isValidFeatureId(value) {
+    return /^[a-z0-9_][a-z0-9_-]*$/.test(value);
+}
+function asRemoveBranchMode(value) {
+    if (value === undefined) {
+        return 'none';
+    }
+    if (value === 'none' || value === 'safe' || value === 'force') {
+        return value;
+    }
+    return null;
+}
+function invalidCliArgs(details) {
+    const error = new Error(ERROR_CODES.INVALID_CLI_ARGS);
+    error.code = ERROR_CODES.INVALID_CLI_ARGS;
+    error.details = details;
+    throw error;
+}
+export class DeleteCommandHandler {
+    toolClient;
+    runId;
+    constructor(toolClient, runId) {
+        this.toolClient = toolClient;
+        this.runId = runId;
+    }
+    async execute(options) {
+        const featureId = options.feature_id;
+        if (!featureId) {
+            invalidCliArgs({
+                reason: '--feature-id is required for delete',
+                expected: '--feature-id <feature_id>'
+            });
+        }
+        if (!isValidFeatureId(featureId)) {
+            invalidCliArgs({
+                reason: 'Invalid --feature-id value',
+                provided: featureId,
+                expected_pattern: '^[a-z0-9_][a-z0-9_-]*$'
+            });
+        }
+        const removeBranch = asRemoveBranchMode(options.remove_branch);
+        if (removeBranch === null) {
+            invalidCliArgs({
+                reason: 'Invalid --remove-branch value',
+                provided: options.remove_branch,
+                expected: ['none', 'safe', 'force']
+            });
+        }
+        if (options.yes !== true && options.dry_run === false) {
+            invalidCliArgs({
+                reason: 'Destructive delete requires --yes',
+                expected: 'Provide --yes or omit --dry-run=false'
+            });
+        }
+        const dryRun = options.yes === true ? (options.dry_run ?? false) : true;
+        const confirm = options.yes === true;
+        const removeWorktree = options.remove_worktree ?? true;
+        const response = await callCliTool(this.toolClient, this.runId, TOOLS.FEATURE_DELETE, {
+            feature_id: featureId,
+            dry_run: dryRun,
+            confirm,
+            remove_worktree: removeWorktree,
+            remove_branch: removeBranch
+        });
+        return {
+            ok: true,
+            data: {
+                command: 'delete',
+                ...(response.data ?? {})
+            }
+        };
+    }
+}
+//# sourceMappingURL=delete-command-handler.js.map

package/dist/apps/control-plane/cli/delete-command-handler.js.map

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

package/dist/apps/control-plane/cli/io.d.ts

@@ -0,0 +1,2 @@
+export declare function printPayload(payload: unknown): void;
+export declare function printError(code: string, message: string, details?: Record<string, unknown>): void;

package/dist/apps/control-plane/cli/io.js

@@ -0,0 +1,14 @@
+export function printPayload(payload) {
+    process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+}
+export function printError(code, message, details = {}) {
+    printPayload({
+        ok: false,
+        error: {
+            code,
+            message,
+            details
+        }
+    });
+}
+//# sourceMappingURL=io.js.map

package/dist/apps/control-plane/cli/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/cli/io.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAe,EAAE,UAAmC,EAAE;IAC7F,YAAY,CAAC;QACX,EAAE,EAAE,KAAK;QACT,KAAK,EAAE;YACL,IAAI;YACJ,OAAO;YACP,OAAO;SACR;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/apps/control-plane/cli/resume-command-handler.d.ts

@@ -0,0 +1,17 @@
+import type { AopKernel } from '../core/kernel.js';
+import type { ToolClient } from '../mcp/tool-client.js';
+import type { CliOptions, ToolTransport } from './types.js';
+export interface ResumeCommandContext {
+    repoRoot: string;
+    env: NodeJS.ProcessEnv;
+    runId: string;
+    transport: ToolTransport;
+    options: CliOptions;
+    kernel: AopKernel;
+    toolClient: ToolClient;
+}
+export declare class ResumeCommandHandler {
+    execute(context: ResumeCommandContext): Promise<unknown>;
+    private buildResumePlan;
+    private addSource;
+}

package/dist/apps/control-plane/cli/resume-command-handler.js

@@ -0,0 +1,178 @@
+import { STATUS } from '../core/constants.js';
+import { resolveProviderSelection, NullWorkerProvider } from '../providers/providers.js';
+import { SupervisorRuntime } from '../supervisor/runtime.js';
+function asRecord(value) {
+    return value && typeof value === 'object' ? value : {};
+}
+function asStringArray(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    const normalized = [];
+    for (const item of value) {
+        if (typeof item !== 'string') {
+            continue;
+        }
+        const trimmed = item.trim();
+        if (trimmed.length > 0) {
+            normalized.push(trimmed);
+        }
+    }
+    return normalized;
+}
+function toResumePhase(status) {
+    if (status === STATUS.BUILDING) {
+        return STATUS.BUILDING;
+    }
+    if (status === STATUS.QA) {
+        return STATUS.QA;
+    }
+    if (status === STATUS.READY_TO_MERGE) {
+        return STATUS.READY_TO_MERGE;
+    }
+    return STATUS.PLANNING;
+}
+function phaseRank(phase) {
+    switch (phase) {
+        case STATUS.PLANNING:
+            return 0;
+        case STATUS.BUILDING:
+            return 1;
+        case STATUS.QA:
+            return 2;
+        case STATUS.READY_TO_MERGE:
+            return 3;
+        default:
+            return 99;
+    }
+}
+function isTerminalStatus(status) {
+    return status === STATUS.MERGED || status === STATUS.FAILED;
+}
+export class ResumeCommandHandler {
+    async execute(context) {
+        const { env, runId, transport, options, kernel, toolClient } = context;
+        const recovery = await kernel.recoverFromState();
+        const resumePlan = await this.buildResumePlan(kernel, runId);
+        if (resumePlan.features.length === 0) {
+            return {
+                ok: true,
+                data: {
+                    command: 'resume',
+                    transport,
+                    resumed: false,
+                    recovery: recovery.data,
+                    resume_plan: resumePlan
+                }
+            };
+        }
+        const selection = resolveProviderSelection({
+            cli: options,
+            env,
+            agentsConfig: kernel.getAgentsConfig()
+        });
+        const provider = new NullWorkerProvider(selection);
+        const supervisor = new SupervisorRuntime(kernel, provider, toolClient, {
+            max_active_features: 5,
+            max_parallel_gate_runs: 3,
+            run_id: resumePlan.run_id,
+            owner_instance_id: resumePlan.owner_instance_id,
+            takeover_stale_run: options.takeover_stale_run
+        });
+        const startResult = await supervisor.start(resumePlan.features.map((feature) => ({
+            feature_id: feature.feature_id
+        })));
+        return {
+            ok: true,
+            data: {
+                command: 'resume',
+                transport,
+                resumed: true,
+                resumed_features: resumePlan.features,
+                queue_depth: startResult.queue_depth,
+                runtime_status: startResult.status,
+                run_metadata: startResult.run_metadata,
+                dashboard: startResult.dashboard,
+                recovery: recovery.data
+            }
+        };
+    }
+    async buildResumePlan(kernel, fallbackRunId) {
+        const index = await kernel.readIndex();
+        const runtimeSessions = await kernel.getRuntimeSessions();
+        const discovered = await kernel.featureDiscoverSpecs();
+        const sourcesByFeature = new Map();
+        for (const featureId of asStringArray(index.active)) {
+            this.addSource(sourcesByFeature, featureId, 'index.active');
+        }
+        for (const featureId of asStringArray(index.blocked)) {
+            this.addSource(sourcesByFeature, featureId, 'index.blocked');
+        }
+        for (const [featureId] of Object.entries(asRecord(runtimeSessions.feature_sessions))) {
+            this.addSource(sourcesByFeature, featureId, 'runtime_sessions.feature_sessions');
+        }
+        const blockedQueue = Array.isArray(index.blocked_queue) ? index.blocked_queue : [];
+        for (const entry of blockedQueue) {
+            const featureId = asRecord(entry).feature_id;
+            if (typeof featureId === 'string' && featureId.length > 0) {
+                this.addSource(sourcesByFeature, featureId, 'index.blocked_queue');
+            }
+        }
+        const specs = Array.isArray(discovered.data?.specs) ? discovered.data.specs : [];
+        for (const item of specs) {
+            const featureId = asRecord(item).feature_id;
+            if (typeof featureId === 'string' && featureId.length > 0) {
+                this.addSource(sourcesByFeature, featureId, 'feature.discover_specs');
+            }
+        }
+        const resumable = [];
+        const sortedFeatureIds = [...sourcesByFeature.keys()].sort((a, b) => a.localeCompare(b));
+        for (const featureId of sortedFeatureIds) {
+            try {
+                const state = await kernel.featureStateGet(featureId);
+                const frontMatter = asRecord(state.data.front_matter);
+                const status = typeof frontMatter.status === 'string' ? frontMatter.status : STATUS.PLANNING;
+                if (isTerminalStatus(status)) {
+                    continue;
+                }
+                resumable.push({
+                    feature_id: featureId,
+                    status,
+                    resume_phase: toResumePhase(status),
+                    sources: [...(sourcesByFeature.get(featureId) ?? new Set())].sort((a, b) => a.localeCompare(b))
+                });
+            }
+            catch (_error) {
+                continue;
+            }
+        }
+        resumable.sort((a, b) => {
+            const phaseDelta = phaseRank(a.resume_phase) - phaseRank(b.resume_phase);
+            if (phaseDelta !== 0) {
+                return phaseDelta;
+            }
+            return a.feature_id.localeCompare(b.feature_id);
+        });
+        const resolvedRunId = runtimeSessions.run_id !== 'none' ? runtimeSessions.run_id : fallbackRunId;
+        const resolvedOwnerInstanceId = runtimeSessions.owner_instance_id !== 'none'
+            ? runtimeSessions.owner_instance_id
+            : `supervisor:${process.pid}:resume`;
+        return {
+            run_id: resolvedRunId,
+            owner_instance_id: resolvedOwnerInstanceId,
+            features: resumable
+        };
+    }
+    addSource(sourcesByFeature, featureId, source) {
+        if (!featureId) {
+            return;
+        }
+        const existing = sourcesByFeature.get(featureId);
+        if (existing) {
+            existing.add(source);
+            return;
+        }
+        sourcesByFeature.set(featureId, new Set([source]));
+    }
+}
+//# sourceMappingURL=resume-command-handler.js.map

package/dist/apps/control-plane/cli/resume-command-handler.js.map

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

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

@@ -0,0 +1,15 @@
+import type { AopKernel } from '../core/kernel.js';
+import type { ToolClient } from '../mcp/tool-client.js';
+import type { CliOptions, ToolTransport } from './types.js';
+export interface RunCommandContext {
+    repoRoot: string;
+    env: NodeJS.ProcessEnv;
+    runId: string;
+    transport: ToolTransport;
+    options: CliOptions;
+    kernel: AopKernel;
+    toolClient: ToolClient;
+}
+export declare class RunCommandHandler {
+    execute(context: RunCommandContext): Promise<unknown>;
+}

package/dist/apps/control-plane/cli/run-command-handler.js

@@ -0,0 +1,39 @@
+import { resolveProviderSelection, NullWorkerProvider } from '../providers/providers.js';
+import { SupervisorRuntime } from '../supervisor/runtime.js';
+import { SpecInputResolver } from './spec-input-resolver.js';
+import { SpecIngestionService } from './spec-ingestion-service.js';
+export class RunCommandHandler {
+    async execute(context) {
+        const { repoRoot, env, runId, transport, options, kernel, toolClient } = context;
+        const specResolver = new SpecInputResolver(repoRoot, toolClient, runId);
+        const ingestionService = new SpecIngestionService(repoRoot, toolClient, runId);
+        const resolvedPaths = await specResolver.resolve(options);
+        const ingested = await ingestionService.ingest(resolvedPaths);
+        const selection = resolveProviderSelection({
+            cli: options,
+            env,
+            agentsConfig: kernel.getAgentsConfig()
+        });
+        const provider = new NullWorkerProvider(selection);
+        const supervisor = new SupervisorRuntime(kernel, provider, toolClient, {
+            max_active_features: 5,
+            max_parallel_gate_runs: 3,
+            run_id: runId,
+            takeover_stale_run: options.takeover_stale_run
+        });
+        const startResult = await supervisor.start(ingested);
+        return {
+            ok: true,
+            data: {
+                command: 'run',
+                transport,
+                active_features: ingested,
+                queue_depth: startResult.queue_depth,
+                runtime_status: startResult.status,
+                run_metadata: startResult.run_metadata,
+                dashboard: startResult.dashboard
+            }
+        };
+    }
+}
+//# sourceMappingURL=run-command-handler.js.map

package/dist/apps/control-plane/cli/run-command-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command-handler.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/cli/run-command-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAI7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAYnE,MAAM,OAAO,iBAAiB;IAC5B,KAAK,CAAC,OAAO,CAAC,OAA0B;QACtC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QACjF,MAAM,YAAY,GAAG,IAAI,iBAAiB,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QACxE,MAAM,gBAAgB,GAAG,IAAI,oBAAoB,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QAE/E,MAAM,aAAa,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAE9D,MAAM,SAAS,GAAG,wBAAwB,CAAC;YACzC,GAAG,EAAE,OAAwD;YAC7D,GAAG;YACH,YAAY,EAAE,MAAM,CAAC,eAAe,EAAE;SACvC,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,IAAI,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE;YACrE,mBAAmB,EAAE,CAAC;YACtB,sBAAsB,EAAE,CAAC;YACzB,MAAM,EAAE,KAAK;YACb,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;SAC/C,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,QAAyC,CAAC,CAAC;QAEtF,OAAO;YACL,EAAE,EAAE,IAAI;YACR,IAAI,EAAE;gBACJ,OAAO,EAAE,KAAK;gBACd,SAAS;gBACT,eAAe,EAAE,QAAQ;gBACzB,WAAW,EAAE,WAAW,CAAC,WAAW;gBACpC,cAAc,EAAE,WAAW,CAAC,MAAM;gBAClC,YAAY,EAAE,WAAW,CAAC,YAAY;gBACtC,SAAS,EAAE,WAAW,CAAC,SAAS;aACjC;SACF,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,8 @@
+import type { ToolClient } from '../mcp/tool-client.js';
+export declare class SpecIngestionService {
+    private readonly repoRoot;
+    private readonly toolClient;
+    private readonly runId;
+    constructor(repoRoot: string, toolClient: ToolClient, runId: string);
+    ingest(resolvedPaths: string[]): Promise<Array<Record<string, string>>>;
+}

package/dist/apps/control-plane/cli/spec-ingestion-service.js

@@ -0,0 +1,77 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { stableHash, ensureDir } from '../core/fs.js';
+import { ERROR_CODES } from '../core/error-codes.js';
+import { TOOLS } from '../core/constants.js';
+import { callCliTool } from './tooling.js';
+import { canonicalFeatureIdFromPath, isCanonicalSpecPath, isLegacyCanonicalSpecPath } from './spec-utils.js';
+export class SpecIngestionService {
+    repoRoot;
+    toolClient;
+    runId;
+    constructor(repoRoot, toolClient, runId) {
+        this.repoRoot = repoRoot;
+        this.toolClient = toolClient;
+        this.runId = runId;
+    }
+    async ingest(resolvedPaths) {
+        const featureIds = new Set();
+        const items = [];
+        for (const sourcePath of resolvedPaths) {
+            const canonical = isCanonicalSpecPath(this.repoRoot, sourcePath);
+            const legacyCanonical = canonical ? null : isLegacyCanonicalSpecPath(this.repoRoot, sourcePath);
+            let featureId;
+            let targetPath;
+            if (canonical) {
+                featureId = canonical;
+                targetPath = sourcePath;
+            }
+            else if (legacyCanonical) {
+                featureId = legacyCanonical;
+                targetPath = path.join(this.repoRoot, '.aop', 'features', featureId, 'spec.md');
+            }
+            else {
+                featureId = canonicalFeatureIdFromPath(sourcePath);
+                targetPath = path.join(this.repoRoot, '.aop', 'features', featureId, 'spec.md');
+            }
+            if (featureIds.has(featureId)) {
+                const error = new Error(ERROR_CODES.FEATURE_SLUG_COLLISION);
+                error.code = ERROR_CODES.FEATURE_SLUG_COLLISION;
+                error.details = { feature_id: featureId };
+                throw error;
+            }
+            featureIds.add(featureId);
+            if (!canonical) {
+                await ensureDir(path.dirname(targetPath));
+                const sourceContent = await fs.readFile(sourcePath, 'utf8');
+                await fs.writeFile(targetPath, sourceContent, 'utf8');
+            }
+            await callCliTool(this.toolClient, this.runId, TOOLS.FEATURE_INIT, { feature_id: featureId });
+            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
+            });
+            const typedState = state.data;
+            await callCliTool(this.toolClient, this.runId, TOOLS.FEATURE_STATE_PATCH, {
+                feature_id: featureId,
+                expected_version: typedState.front_matter.version,
+                patch: {
+                    front_matter: {
+                        source: {
+                            path: path.relative(this.repoRoot, sourcePath).replaceAll('\\\\', '/'),
+                            hash: sourceHash
+                        }
+                    }
+                }
+            });
+            items.push({
+                feature_id: featureId,
+                source_path: path.relative(this.repoRoot, sourcePath).replaceAll('\\\\', '/'),
+                canonical_spec_path: path.relative(this.repoRoot, targetPath).replaceAll('\\\\', '/')
+            });
+        }
+        return items;
+    }
+}
+//# sourceMappingURL=spec-ingestion-service.js.map

package/dist/apps/control-plane/cli/spec-ingestion-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-ingestion-service.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/cli/spec-ingestion-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAI7C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE7G,MAAM,OAAO,oBAAoB;IACd,QAAQ,CAAS;IACjB,UAAU,CAAa;IACvB,KAAK,CAAS;IAE/B,YAAY,QAAgB,EAAE,UAAsB,EAAE,KAAa;QACjE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,aAAuB;QAClC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,MAAM,KAAK,GAAkC,EAAE,CAAC;QAEhD,KAAK,MAAM,UAAU,IAAI,aAAa,EAAE,CAAC;YACvC,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YACjE,MAAM,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YAChG,IAAI,SAAiB,CAAC;YACtB,IAAI,UAAkB,CAAC;YACvB,IAAI,SAAS,EAAE,CAAC;gBACd,SAAS,GAAG,SAAS,CAAC;gBACtB,UAAU,GAAG,UAAU,CAAC;YAC1B,CAAC;iBAAM,IAAI,eAAe,EAAE,CAAC;gBAC3B,SAAS,GAAG,eAAe,CAAC;gBAC5B,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YAClF,CAAC;iBAAM,CAAC;gBACN,SAAS,GAAG,0BAA0B,CAAC,UAAU,CAAC,CAAC;gBACnD,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YAClF,CAAC;YAED,IAAI,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC9B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,sBAAsB,CAAa,CAAC;gBACxE,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC,sBAAsB,CAAC;gBAChD,KAAK,CAAC,OAAO,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;gBAC1C,MAAM,KAAK,CAAC;YACd,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAE1B,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;gBAC1C,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;gBAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;YACxD,CAAC;YAED,MAAM,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;YAE9F,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAC5D,MAAM,UAAU,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;YAC7C,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,iBAAiB,EAAE;gBACpF,UAAU,EAAE,SAAS;aACtB,CAAC,CAAC;YACH,MAAM,UAAU,GAAG,KAAK,CAAC,IAAsC,CAAC;YAEhE,MAAM,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,mBAAmB,EAAE;gBACxE,UAAU,EAAE,SAAS;gBACrB,gBAAgB,EAAE,UAAU,CAAC,YAAY,CAAC,OAAO;gBACjD,KAAK,EAAE;oBACL,YAAY,EAAE;wBACZ,MAAM,EAAE;4BACN,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC;4BACtE,IAAI,EAAE,UAAU;yBACjB;qBACF;iBACF;aACF,CAAC,CAAC;YAEH,KAAK,CAAC,IAAI,CAAC;gBACT,UAAU,EAAE,SAAS;gBACrB,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC;gBAC7E,mBAAmB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC;aACtF,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

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

@@ -0,0 +1,9 @@
+import type { ToolClient } from '../mcp/tool-client.js';
+import type { CliOptions } from './types.js';
+export declare class SpecInputResolver {
+    private readonly repoRoot;
+    private readonly toolClient;
+    private readonly runId;
+    constructor(repoRoot: string, toolClient: ToolClient, runId: string);
+    resolve(options: CliOptions): Promise<string[]>;
+}