agentic-orchestrator 0.1.0

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

@@ -0,0 +1,81 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { ERROR_CODES } from '../core/error-codes.js';
+import { TOOLS } from '../core/constants.js';
+import { callCliTool } from './tooling.js';
+async function readMarkdownFilesRecursive(folder) {
+    const results = [];
+    async function walk(current) {
+        const entries = await fs.readdir(current, { withFileTypes: true });
+        entries.sort((a, b) => a.name.localeCompare(b.name));
+        for (const entry of entries) {
+            const absolute = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                await walk(absolute);
+                continue;
+            }
+            if (entry.isFile() && entry.name.toLowerCase().endsWith('.md')) {
+                results.push(absolute);
+            }
+        }
+    }
+    await walk(folder);
+    results.sort((a, b) => a.localeCompare(b));
+    return results;
+}
+export class SpecInputResolver {
+    repoRoot;
+    toolClient;
+    runId;
+    constructor(repoRoot, toolClient, runId) {
+        this.repoRoot = repoRoot;
+        this.toolClient = toolClient;
+        this.runId = runId;
+    }
+    async resolve(options) {
+        if (options.file_input && options.folder_input) {
+            const error = new Error(ERROR_CODES.INVALID_CLI_ARGS);
+            error.code = ERROR_CODES.INVALID_CLI_ARGS;
+            error.details = { reason: '-fi and -fl are mutually exclusive' };
+            throw error;
+        }
+        if (options.file_input) {
+            const absolute = path.resolve(this.repoRoot, options.file_input);
+            const stat = await fs.stat(absolute).catch(() => null);
+            if (!stat || !stat.isFile()) {
+                const error = new Error(ERROR_CODES.INPUT_PATH_NOT_FOUND);
+                error.code = ERROR_CODES.INPUT_PATH_NOT_FOUND;
+                error.details = { path: options.file_input };
+                throw error;
+            }
+            return [absolute];
+        }
+        if (options.folder_input) {
+            const absolute = path.resolve(this.repoRoot, options.folder_input);
+            const stat = await fs.stat(absolute).catch(() => null);
+            if (!stat || !stat.isDirectory()) {
+                const error = new Error(ERROR_CODES.INPUT_PATH_NOT_FOUND);
+                error.code = ERROR_CODES.INPUT_PATH_NOT_FOUND;
+                error.details = { path: options.folder_input };
+                throw error;
+            }
+            const markdownFiles = await readMarkdownFilesRecursive(absolute);
+            if (markdownFiles.length === 0) {
+                const error = new Error(ERROR_CODES.NO_SPECS_FOUND);
+                error.code = ERROR_CODES.NO_SPECS_FOUND;
+                error.details = { folder: options.folder_input };
+                throw error;
+            }
+            return markdownFiles;
+        }
+        const discovered = await callCliTool(this.toolClient, this.runId, TOOLS.FEATURE_DISCOVER_SPECS, {});
+        const specs = discovered.data.specs ?? [];
+        if (specs.length === 0) {
+            const error = new Error(ERROR_CODES.NO_SPECS_FOUND);
+            error.code = ERROR_CODES.NO_SPECS_FOUND;
+            throw error;
+        }
+        return specs.map((item) => path.join(this.repoRoot, item.spec_path));
+    }
+}
+//# sourceMappingURL=spec-input-resolver.js.map

package/dist/apps/control-plane/cli/spec-input-resolver.js.map

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

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

@@ -0,0 +1,3 @@
+export declare function canonicalFeatureIdFromPath(inputPath: string): string;
+export declare function isCanonicalSpecPath(repoRoot: string, candidate: string): string | null;
+export declare function isLegacyCanonicalSpecPath(repoRoot: string, candidate: string): string | null;

package/dist/apps/control-plane/cli/spec-utils.js

@@ -0,0 +1,36 @@
+import path from 'node:path';
+import { ERROR_CODES } from '../core/error-codes.js';
+export function canonicalFeatureIdFromPath(inputPath) {
+    const basename = path.basename(inputPath);
+    let candidate = basename.replace(/\.[^.]+$/, '');
+    if (candidate.endsWith('.spec')) {
+        candidate = candidate.slice(0, -'.spec'.length);
+    }
+    else if (candidate.endsWith('-spec')) {
+        candidate = candidate.slice(0, -'-spec'.length);
+    }
+    if (!candidate || !/^[a-z0-9_][a-z0-9_-]*$/.test(candidate)) {
+        const error = new Error(ERROR_CODES.INVALID_FEATURE_SLUG);
+        error.code = ERROR_CODES.INVALID_FEATURE_SLUG;
+        error.details = { input_path: inputPath, derived_feature_id: candidate };
+        throw error;
+    }
+    return candidate;
+}
+export function isCanonicalSpecPath(repoRoot, candidate) {
+    const relative = path.relative(repoRoot, candidate).replaceAll('\\\\', '/');
+    const match = relative.match(/^\.aop\/features\/([a-z0-9_][a-z0-9_-]*)\/spec\.md$/);
+    if (!match) {
+        return null;
+    }
+    return match[1];
+}
+export function isLegacyCanonicalSpecPath(repoRoot, candidate) {
+    const relative = path.relative(repoRoot, candidate).replaceAll('\\\\', '/');
+    const match = relative.match(/^agentic\/features\/([a-z0-9_][a-z0-9_-]*)\/spec\.md$/);
+    if (!match) {
+        return null;
+    }
+    return match[1];
+}
+//# sourceMappingURL=spec-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec-utils.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/cli/spec-utils.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAC,WAAW,EAAC,MAAM,wBAAwB,CAAC;AAGnD,MAAM,UAAU,0BAA0B,CAAC,SAAiB;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACjD,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;SAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,CAAC,SAAS,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,oBAAoB,CAAa,CAAC;QACtE,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC,oBAAoB,CAAC;QAC9C,KAAK,CAAC,OAAO,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,kBAAkB,EAAE,SAAS,EAAE,CAAC;QACzE,MAAM,KAAK,CAAC;IACd,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,SAAiB;IACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACpF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,QAAgB,EAAE,SAAiB;IAC3E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;IACtF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

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

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

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

@@ -0,0 +1,14 @@
+import { TOOLS } from '../core/constants.js';
+import { callCliTool } from './tooling.js';
+export class StatusCommandHandler {
+    toolClient;
+    runId;
+    constructor(toolClient, runId) {
+        this.toolClient = toolClient;
+        this.runId = runId;
+    }
+    async execute() {
+        return await callCliTool(this.toolClient, this.runId, TOOLS.REPORT_DASHBOARD, {});
+    }
+}
+//# sourceMappingURL=status-command-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status-command-handler.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/cli/status-command-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,sBAAsB,CAAC;AAE3C,OAAO,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAEzC,MAAM,OAAO,oBAAoB;IACd,UAAU,CAAa;IACvB,KAAK,CAAS;IAE/B,YAAY,UAAsB,EAAE,KAAa;QAC/C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,MAAM,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACpF,CAAC;CACF"}

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

@@ -0,0 +1,3 @@
+export declare class StopCommandHandler {
+    execute(): Promise<unknown>;
+}

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

@@ -0,0 +1,6 @@
+export class StopCommandHandler {
+    execute() {
+        return Promise.resolve({ ok: true, data: { status: 'stop_not_implemented_yet' } });
+    }
+}
+//# sourceMappingURL=stop-command-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stop-command-handler.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/cli/stop-command-handler.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAkB;IAC7B,OAAO;QACL,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,0BAA0B,EAAE,EAAE,CAAC,CAAC;IACrF,CAAC;CACF"}

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

@@ -0,0 +1,4 @@
+import type { OkResponse, ToolResponse } from '../core/response.js';
+import { type ToolClient } from '../mcp/tool-client.js';
+export declare function assertOkResponse<TData extends Record<string, unknown>>(response: ToolResponse<TData>): OkResponse<TData>;
+export declare function callCliTool(toolClient: ToolClient, runId: string, toolName: string, args: Record<string, unknown>): Promise<OkResponse<Record<string, unknown>>>;

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

@@ -0,0 +1,24 @@
+import { ERROR_CODES } from '../core/error-codes.js';
+import { createOperationId } from '../mcp/tool-client.js';
+import { withOperationIdIfRequired } from '../application/tools/tool-metadata.js';
+export function assertOkResponse(response) {
+    if (!response.ok) {
+        const failed = response;
+        const error = new Error(failed.error.message ?? ERROR_CODES.INTERNAL_ERROR);
+        error.code = failed.error.code ?? ERROR_CODES.INTERNAL_ERROR;
+        error.details = failed.error.details ?? {};
+        throw error;
+    }
+    return response;
+}
+export async function callCliTool(toolClient, runId, toolName, args) {
+    const payload = withOperationIdIfRequired(toolName, args, createOperationId);
+    const response = await toolClient.call(toolName, payload, {
+        run_id: runId,
+        session_id: 'bootstrap:cli',
+        actor_type: 'system',
+        actor_id: 'cli:system'
+    });
+    return assertOkResponse(response);
+}
+//# sourceMappingURL=tooling.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tooling.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/cli/tooling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAmB,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAElF,MAAM,UAAU,gBAAgB,CAC9B,QAA6B;IAE7B,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,QAAwB,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,WAAW,CAAC,cAAc,CAAa,CAAC;QACxF,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,WAAW,CAAC,cAAc,CAAC;QAC7D,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;QAC3C,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAAsB,EACtB,KAAa,EACb,QAAgB,EAChB,IAA6B;IAE7B,MAAM,OAAO,GAAG,yBAAyB,CAAC,QAAQ,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAE7E,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE;QACxD,MAAM,EAAE,KAAK;QACb,UAAU,EAAE,eAAe;QAC3B,UAAU,EAAE,QAAQ;QACpB,QAAQ,EAAE,YAAY;KACvB,CAAC,CAAC;IAEH,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC"}

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

@@ -0,0 +1,31 @@
+export interface CliOptions {
+    command: string;
+    file_input?: string;
+    folder_input?: string;
+    feature_id?: string;
+    dry_run?: boolean;
+    yes?: boolean;
+    remove_worktree?: boolean;
+    remove_branch?: string;
+    agent_provider?: string;
+    agent_model?: string;
+    provider_config_env?: string;
+    transport?: string;
+    takeover_stale_run?: boolean;
+}
+export type RemoveBranchMode = 'none' | 'safe' | 'force';
+export interface RuntimeContext {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}
+export type ToolTransport = 'inprocess' | 'mcp';
+export interface FeatureStatePayload {
+    front_matter: {
+        version: number;
+    };
+}
+export interface DiscoveredSpecsPayload {
+    specs: Array<{
+        spec_path: string;
+    }>;
+}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/cli/types.ts"],"names":[],"mappings":""}

package/dist/apps/control-plane/core/collisions.d.ts

@@ -0,0 +1,39 @@
+interface PlanShape {
+    feature_id: string;
+    files?: {
+        create?: string[];
+        modify?: string[];
+        delete?: string[];
+    };
+    allowed_areas?: string[];
+    contracts?: {
+        openapi?: string;
+        events?: string;
+        db?: string;
+    };
+}
+interface PolicyShape {
+    exclusive_areas?: string[];
+    protected_areas?: string[];
+}
+export declare 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;
+        }>;
+    };
+    fingerprint: string | null;
+};
+export {};

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

@@ -0,0 +1,78 @@
+import { stableHash } from './fs.js';
+function overlap(itemsA, itemsB) {
+    const setB = new Set(itemsB);
+    return itemsA.filter((item) => setB.has(item));
+}
+function areaOverlaps(areasA, areasB) {
+    const overlaps = [];
+    for (const a of areasA) {
+        for (const b of areasB) {
+            if (a === b || a.startsWith(`${b}/`) || b.startsWith(`${a}/`)) {
+                overlaps.push([a, b]);
+            }
+        }
+    }
+    return overlaps;
+}
+function collectPlanFiles(plan) {
+    return [
+        ...(plan.files?.create ?? []),
+        ...(plan.files?.modify ?? []),
+        ...(plan.files?.delete ?? [])
+    ];
+}
+export function detectPlanCollisions(candidate, acceptedPlans, policy) {
+    const collisions = {
+        files: [],
+        areas: [],
+        contracts: []
+    };
+    const candidateFiles = collectPlanFiles(candidate);
+    for (const plan of acceptedPlans) {
+        if (!plan || plan.feature_id === candidate.feature_id) {
+            continue;
+        }
+        const fileOverlap = overlap(candidateFiles, collectPlanFiles(plan));
+        if (fileOverlap.length > 0) {
+            collisions.files.push({
+                with_feature_id: plan.feature_id,
+                paths: fileOverlap
+            });
+        }
+        const areaOverlap = areaOverlaps(candidate.allowed_areas ?? [], plan.allowed_areas ?? []);
+        const exclusives = policy.exclusive_areas ?? [];
+        const protectedAreas = policy.protected_areas ?? [];
+        const relevant = areaOverlap.filter(([a, 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
+            });
+        }
+        for (const contract of ['openapi', 'events', 'db']) {
+            const candidateMode = candidate.contracts?.[contract] ?? 'none';
+            const otherMode = plan.contracts?.[contract] ?? 'none';
+            const candidateChanged = candidateMode !== 'none';
+            const otherChanged = otherMode !== 'none';
+            if (candidateChanged && otherChanged) {
+                collisions.contracts.push({
+                    with_feature_id: plan.feature_id,
+                    contract,
+                    candidate_mode: candidateMode,
+                    other_mode: otherMode
+                });
+            }
+        }
+    }
+    const hasCollisions = collisions.files.length > 0 || collisions.areas.length > 0 || collisions.contracts.length > 0;
+    const fingerprintInput = JSON.stringify({
+        feature_id: candidate.feature_id,
+        collisions
+    });
+    return {
+        hasCollisions,
+        collisions,
+        fingerprint: hasCollisions ? stableHash(fingerprintInput) : null
+    };
+}
+//# sourceMappingURL=collisions.js.map

package/dist/apps/control-plane/core/collisions.js.map

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

package/dist/apps/control-plane/core/constants.d.ts

@@ -0,0 +1,64 @@
+export declare const DEFAULT_FEATURE_STATUS: "planning";
+export declare const STATUS: {
+    readonly PLANNING: "planning";
+    readonly BUILDING: "building";
+    readonly QA: "qa";
+    readonly BLOCKED: "blocked";
+    readonly READY_TO_MERGE: "ready_to_merge";
+    readonly MERGED: "merged";
+    readonly FAILED: "failed";
+};
+export type FeatureStatus = (typeof STATUS)[keyof typeof STATUS];
+export declare const ROLE_STATUS: {
+    readonly READY: "ready";
+    readonly RUNNING: "running";
+    readonly BLOCKED: "blocked";
+    readonly DONE: "done";
+};
+export declare const TOOLS: {
+    readonly FEATURE_DISCOVER_SPECS: "feature.discover_specs";
+    readonly FEATURE_INIT: "feature.init";
+    readonly FEATURE_GET_CONTEXT: "feature.get_context";
+    readonly FEATURE_STATE_GET: "feature.state_get";
+    readonly FEATURE_STATE_PATCH: "feature.state_patch";
+    readonly FEATURE_LOG_APPEND: "feature.log_append";
+    readonly PLAN_SUBMIT: "plan.submit";
+    readonly PLAN_GET: "plan.get";
+    readonly PLAN_UPDATE: "plan.update";
+    readonly REPO_ENSURE_WORKTREE: "repo.ensure_worktree";
+    readonly REPO_APPLY_PATCH: "repo.apply_patch";
+    readonly REPO_STATUS: "repo.status";
+    readonly REPO_DIFF: "repo.diff";
+    readonly REPO_READ_FILE: "repo.read_file";
+    readonly REPO_SEARCH: "repo.search";
+    readonly REPO_DIFF_BUNDLE: "repo.diff_bundle";
+    readonly FEATURE_READY_TO_MERGE: "feature.ready_to_merge";
+    readonly FEATURE_DELETE: "feature.delete";
+    readonly GATES_LIST: "gates.list";
+    readonly GATES_RUN: "gates.run";
+    readonly EVIDENCE_LATEST: "evidence.latest";
+    readonly QA_TEST_INDEX_GET: "qa.test_index_get";
+    readonly QA_TEST_INDEX_UPDATE: "qa.test_index_update";
+    readonly LOCKS_ACQUIRE: "locks.acquire";
+    readonly LOCKS_RELEASE: "locks.release";
+    readonly COLLISIONS_SCAN: "collisions.scan";
+    readonly REPORT_DASHBOARD: "report.dashboard";
+    readonly REPORT_FEATURE_SUMMARY: "report.feature_summary";
+};
+export declare const DEFAULT_CLUSTER: {
+    orchestrator_session_id: string;
+    planner_session_id: string;
+    builder_session_id: string;
+    qa_session_id: string;
+};
+export declare const DEFAULT_ROLE_STATUS: {
+    planner: "ready";
+    builder: "ready";
+    qa: "ready";
+};
+export declare const GATE_RESULT: {
+    readonly PASS: "pass";
+    readonly FAIL: "fail";
+    readonly NA: "na";
+};
+export declare const ALLOWED_ACTORS: Set<string>;

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

@@ -0,0 +1,64 @@
+export const DEFAULT_FEATURE_STATUS = 'planning';
+export const STATUS = {
+    PLANNING: 'planning',
+    BUILDING: 'building',
+    QA: 'qa',
+    BLOCKED: 'blocked',
+    READY_TO_MERGE: 'ready_to_merge',
+    MERGED: 'merged',
+    FAILED: 'failed'
+};
+export const ROLE_STATUS = {
+    READY: 'ready',
+    RUNNING: 'running',
+    BLOCKED: 'blocked',
+    DONE: 'done'
+};
+export const TOOLS = {
+    FEATURE_DISCOVER_SPECS: 'feature.discover_specs',
+    FEATURE_INIT: 'feature.init',
+    FEATURE_GET_CONTEXT: 'feature.get_context',
+    FEATURE_STATE_GET: 'feature.state_get',
+    FEATURE_STATE_PATCH: 'feature.state_patch',
+    FEATURE_LOG_APPEND: 'feature.log_append',
+    PLAN_SUBMIT: 'plan.submit',
+    PLAN_GET: 'plan.get',
+    PLAN_UPDATE: 'plan.update',
+    REPO_ENSURE_WORKTREE: 'repo.ensure_worktree',
+    REPO_APPLY_PATCH: 'repo.apply_patch',
+    REPO_STATUS: 'repo.status',
+    REPO_DIFF: 'repo.diff',
+    REPO_READ_FILE: 'repo.read_file',
+    REPO_SEARCH: 'repo.search',
+    REPO_DIFF_BUNDLE: 'repo.diff_bundle',
+    FEATURE_READY_TO_MERGE: 'feature.ready_to_merge',
+    FEATURE_DELETE: 'feature.delete',
+    GATES_LIST: 'gates.list',
+    GATES_RUN: 'gates.run',
+    EVIDENCE_LATEST: 'evidence.latest',
+    QA_TEST_INDEX_GET: 'qa.test_index_get',
+    QA_TEST_INDEX_UPDATE: 'qa.test_index_update',
+    LOCKS_ACQUIRE: 'locks.acquire',
+    LOCKS_RELEASE: 'locks.release',
+    COLLISIONS_SCAN: 'collisions.scan',
+    REPORT_DASHBOARD: 'report.dashboard',
+    REPORT_FEATURE_SUMMARY: 'report.feature_summary'
+};
+export const DEFAULT_CLUSTER = {
+    orchestrator_session_id: 'unknown',
+    planner_session_id: 'unknown',
+    builder_session_id: 'unknown',
+    qa_session_id: 'unknown'
+};
+export const DEFAULT_ROLE_STATUS = {
+    planner: ROLE_STATUS.READY,
+    builder: ROLE_STATUS.READY,
+    qa: ROLE_STATUS.READY
+};
+export const GATE_RESULT = {
+    PASS: 'pass',
+    FAIL: 'fail',
+    NA: 'na'
+};
+export const ALLOWED_ACTORS = new Set(['orchestrator', 'planner', 'builder', 'qa', 'system']);
+//# sourceMappingURL=constants.js.map

package/dist/apps/control-plane/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/core/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,UAAmB,CAAC;AAE1D,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,EAAE,EAAE,IAAI;IACR,OAAO,EAAE,SAAS;IAClB,cAAc,EAAE,gBAAgB;IAChC,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACR,CAAC;AAIX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;CACJ,CAAC;AAEX,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,sBAAsB,EAAE,wBAAwB;IAChD,YAAY,EAAE,cAAc;IAC5B,mBAAmB,EAAE,qBAAqB;IAC1C,iBAAiB,EAAE,mBAAmB;IACtC,mBAAmB,EAAE,qBAAqB;IAC1C,kBAAkB,EAAE,oBAAoB;IACxC,WAAW,EAAE,aAAa;IAC1B,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;IAC1B,oBAAoB,EAAE,sBAAsB;IAC5C,gBAAgB,EAAE,kBAAkB;IACpC,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,gBAAgB,EAAE,kBAAkB;IACpC,sBAAsB,EAAE,wBAAwB;IAChD,cAAc,EAAE,gBAAgB;IAChC,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,eAAe,EAAE,iBAAiB;IAClC,iBAAiB,EAAE,mBAAmB;IACtC,oBAAoB,EAAE,sBAAsB;IAC5C,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,eAAe,EAAE,iBAAiB;IAClC,gBAAgB,EAAE,kBAAkB;IACpC,sBAAsB,EAAE,wBAAwB;CACxC,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,uBAAuB,EAAE,SAAS;IAClC,kBAAkB,EAAE,SAAS;IAC7B,kBAAkB,EAAE,SAAS;IAC7B,aAAa,EAAE,SAAS;CACzB,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,OAAO,EAAE,WAAW,CAAC,KAAK;IAC1B,OAAO,EAAE,WAAW,CAAC,KAAK;IAC1B,EAAE,EAAE,WAAW,CAAC,KAAK;CACtB,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,IAAI;CACA,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAS,CAAC,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC"}

package/dist/apps/control-plane/core/error-codes.d.ts

@@ -0,0 +1,50 @@
+export declare const ERROR_CODES: {
+    readonly FORBIDDEN_TOOL_FOR_ROLE: "forbidden_tool_for_role";
+    readonly VERSION_CONFLICT: "version_conflict";
+    readonly INVALID_STATUS_TRANSITION: "invalid_status_transition";
+    readonly UNKNOWN_GATE_PROFILE_OR_MODE: "unknown_gate_profile_or_mode";
+    readonly UNSUPPORTED_PARSER: "unsupported_parser";
+    readonly GATE_TIMEOUT: "gate_timeout";
+    readonly TRANSIENT_EXEC_FAILURE: "transient_exec_failure";
+    readonly COVERAGE_BELOW_MINIMUM: "coverage_below_minimum";
+    readonly INVALID_OVERRIDE_PRECEDENCE: "invalid_override_precedence";
+    readonly PATH_OUT_OF_BOUNDS: "path_out_of_bounds";
+    readonly LOCK_NOT_HELD: "lock_not_held";
+    readonly LOCK_CONFLICT: "lock_conflict";
+    readonly STALE_LOCK_RECLAIMED: "stale_lock_reclaimed";
+    readonly RUN_ALREADY_ACTIVE: "run_already_active";
+    readonly RUN_LEASE_NOT_OWNED: "run_lease_not_owned";
+    readonly COLLISION_DETECTED: "collision_detected";
+    readonly BLOCKED_BY_COLLISION_POLICY: "blocked_by_collision_policy";
+    readonly COMMIT_DISABLED: "commit_disabled";
+    readonly MERGE_DISABLED: "merge_disabled";
+    readonly USER_APPROVAL_REQUIRED: "user_approval_required";
+    readonly MISSING_ROLE_PROMPT: "missing_role_prompt";
+    readonly QA_INDEX_VERSION_CONFLICT: "qa_index_version_conflict";
+    readonly INVALID_CLI_ARGS: "invalid_cli_args";
+    readonly INPUT_PATH_NOT_FOUND: "input_path_not_found";
+    readonly NO_SPECS_FOUND: "no_specs_found";
+    readonly SPEC_INGEST_FAILED: "spec_ingest_failed";
+    readonly INVALID_FEATURE_SLUG: "invalid_feature_slug";
+    readonly FEATURE_SLUG_COLLISION: "feature_slug_collision";
+    readonly INVALID_WORKSPACE_IMPLEMENTATION: "invalid_workspace_implementation";
+    readonly AGENT_PROVIDER_NOT_CONFIGURED: "agent_provider_not_configured";
+    readonly UNSUPPORTED_AGENT_PROVIDER: "unsupported_agent_provider";
+    readonly PROVIDER_AUTH_MISSING: "provider_auth_missing";
+    readonly UNAUTHENTICATED: "unauthenticated";
+    readonly INVALID_ACTOR_CLAIM: "invalid_actor_claim";
+    readonly OPERATION_ID_REQUIRED: "operation_id_required";
+    readonly OPERATION_ID_REUSE_MISMATCH: "operation_id_reuse_mismatch";
+    readonly LOCK_TIMEOUT: "lock_timeout";
+    readonly PLAN_REQUIRED: "plan_required";
+    readonly PLAN_VALIDATION_FAILED: "plan_validation_failed";
+    readonly STATE_VALIDATION_FAILED: "state_validation_failed";
+    readonly INDEX_VALIDATION_FAILED: "index_validation_failed";
+    readonly GIT_FAILURE: "git_failure";
+    readonly PATCH_POLICY_VIOLATION: "patch_policy_violation";
+    readonly FILE_NOT_FOUND: "file_not_found";
+    readonly INVALID_ARGUMENT: "invalid_argument";
+    readonly INTERNAL_ERROR: "internal_error";
+};
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+export declare function isErrorCode(value: unknown): value is ErrorCode;

package/dist/apps/control-plane/core/error-codes.js

@@ -0,0 +1,52 @@
+export const ERROR_CODES = {
+    FORBIDDEN_TOOL_FOR_ROLE: 'forbidden_tool_for_role',
+    VERSION_CONFLICT: 'version_conflict',
+    INVALID_STATUS_TRANSITION: 'invalid_status_transition',
+    UNKNOWN_GATE_PROFILE_OR_MODE: 'unknown_gate_profile_or_mode',
+    UNSUPPORTED_PARSER: 'unsupported_parser',
+    GATE_TIMEOUT: 'gate_timeout',
+    TRANSIENT_EXEC_FAILURE: 'transient_exec_failure',
+    COVERAGE_BELOW_MINIMUM: 'coverage_below_minimum',
+    INVALID_OVERRIDE_PRECEDENCE: 'invalid_override_precedence',
+    PATH_OUT_OF_BOUNDS: 'path_out_of_bounds',
+    LOCK_NOT_HELD: 'lock_not_held',
+    LOCK_CONFLICT: 'lock_conflict',
+    STALE_LOCK_RECLAIMED: 'stale_lock_reclaimed',
+    RUN_ALREADY_ACTIVE: 'run_already_active',
+    RUN_LEASE_NOT_OWNED: 'run_lease_not_owned',
+    COLLISION_DETECTED: 'collision_detected',
+    BLOCKED_BY_COLLISION_POLICY: 'blocked_by_collision_policy',
+    COMMIT_DISABLED: 'commit_disabled',
+    MERGE_DISABLED: 'merge_disabled',
+    USER_APPROVAL_REQUIRED: 'user_approval_required',
+    MISSING_ROLE_PROMPT: 'missing_role_prompt',
+    QA_INDEX_VERSION_CONFLICT: 'qa_index_version_conflict',
+    INVALID_CLI_ARGS: 'invalid_cli_args',
+    INPUT_PATH_NOT_FOUND: 'input_path_not_found',
+    NO_SPECS_FOUND: 'no_specs_found',
+    SPEC_INGEST_FAILED: 'spec_ingest_failed',
+    INVALID_FEATURE_SLUG: 'invalid_feature_slug',
+    FEATURE_SLUG_COLLISION: 'feature_slug_collision',
+    INVALID_WORKSPACE_IMPLEMENTATION: 'invalid_workspace_implementation',
+    AGENT_PROVIDER_NOT_CONFIGURED: 'agent_provider_not_configured',
+    UNSUPPORTED_AGENT_PROVIDER: 'unsupported_agent_provider',
+    PROVIDER_AUTH_MISSING: 'provider_auth_missing',
+    UNAUTHENTICATED: 'unauthenticated',
+    INVALID_ACTOR_CLAIM: 'invalid_actor_claim',
+    OPERATION_ID_REQUIRED: 'operation_id_required',
+    OPERATION_ID_REUSE_MISMATCH: 'operation_id_reuse_mismatch',
+    LOCK_TIMEOUT: 'lock_timeout',
+    PLAN_REQUIRED: 'plan_required',
+    PLAN_VALIDATION_FAILED: 'plan_validation_failed',
+    STATE_VALIDATION_FAILED: 'state_validation_failed',
+    INDEX_VALIDATION_FAILED: 'index_validation_failed',
+    GIT_FAILURE: 'git_failure',
+    PATCH_POLICY_VIOLATION: 'patch_policy_violation',
+    FILE_NOT_FOUND: 'file_not_found',
+    INVALID_ARGUMENT: 'invalid_argument',
+    INTERNAL_ERROR: 'internal_error'
+};
+export function isErrorCode(value) {
+    return typeof value === 'string' && Object.values(ERROR_CODES).includes(value);
+}
+//# sourceMappingURL=error-codes.js.map

package/dist/apps/control-plane/core/error-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/core/error-codes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,uBAAuB,EAAE,yBAAyB;IAClD,gBAAgB,EAAE,kBAAkB;IACpC,yBAAyB,EAAE,2BAA2B;IACtD,4BAA4B,EAAE,8BAA8B;IAC5D,kBAAkB,EAAE,oBAAoB;IACxC,YAAY,EAAE,cAAc;IAC5B,sBAAsB,EAAE,wBAAwB;IAChD,sBAAsB,EAAE,wBAAwB;IAChD,2BAA2B,EAAE,6BAA6B;IAC1D,kBAAkB,EAAE,oBAAoB;IACxC,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,oBAAoB,EAAE,sBAAsB;IAC5C,kBAAkB,EAAE,oBAAoB;IACxC,mBAAmB,EAAE,qBAAqB;IAC1C,kBAAkB,EAAE,oBAAoB;IACxC,2BAA2B,EAAE,6BAA6B;IAC1D,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;IAChC,sBAAsB,EAAE,wBAAwB;IAChD,mBAAmB,EAAE,qBAAqB;IAC1C,yBAAyB,EAAE,2BAA2B;IACtD,gBAAgB,EAAE,kBAAkB;IACpC,oBAAoB,EAAE,sBAAsB;IAC5C,cAAc,EAAE,gBAAgB;IAChC,kBAAkB,EAAE,oBAAoB;IACxC,oBAAoB,EAAE,sBAAsB;IAC5C,sBAAsB,EAAE,wBAAwB;IAChD,gCAAgC,EAAE,kCAAkC;IACpE,6BAA6B,EAAE,+BAA+B;IAC9D,0BAA0B,EAAE,4BAA4B;IACxD,qBAAqB,EAAE,uBAAuB;IAC9C,eAAe,EAAE,iBAAiB;IAClC,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,2BAA2B,EAAE,6BAA6B;IAC1D,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;IAC9B,sBAAsB,EAAE,wBAAwB;IAChD,uBAAuB,EAAE,yBAAyB;IAClD,uBAAuB,EAAE,yBAAyB;IAClD,WAAW,EAAE,aAAa;IAC1B,sBAAsB,EAAE,wBAAwB;IAChD,cAAc,EAAE,gBAAgB;IAChC,gBAAgB,EAAE,kBAAkB;IACpC,cAAc,EAAE,gBAAgB;CACxB,CAAC;AAIX,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,MAAM,CAAC,MAAM,CAAC,WAAW,CAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/F,CAAC"}

package/dist/apps/control-plane/core/frontmatter.d.ts

@@ -0,0 +1,11 @@
+export interface FrontMatterParseResult {
+    frontMatter: Record<string, unknown>;
+    body: string;
+}
+export declare class StateMarkdownSerializer {
+    parse(markdown: string): FrontMatterParseResult;
+    build(frontMatter: Record<string, unknown>, body?: string): string;
+}
+export declare const stateMarkdownSerializer: StateMarkdownSerializer;
+export declare function parseFrontMatter(markdown: string): FrontMatterParseResult;
+export declare function buildFrontMatter(frontMatter: Record<string, unknown>, body?: string): string;