agentic-orchestrator 0.1.0

package/dist/apps/control-plane/application/services/reporting-service.js

@@ -0,0 +1,90 @@
+import { detectPlanCollisions } from '../../core/collisions.js';
+import { pathExists, stableHash } from '../../core/fs.js';
+function normalizeSet(array) {
+    return [...new Set(array)].sort((a, b) => a.localeCompare(b));
+}
+function readHeldLocks(frontMatter) {
+    const locks = frontMatter?.locks && typeof frontMatter.locks === 'object' ? frontMatter.locks : {};
+    const held = Array.isArray(locks.held) ? locks.held : [];
+    return held.filter((item) => typeof item === 'string');
+}
+function createCollisionFingerprint(collisions) {
+    return stableHash(JSON.stringify(collisions));
+}
+export class ReportingService {
+    port;
+    constructor(port) {
+        this.port = port;
+    }
+    async collisionsScan() {
+        const plans = await this.port.collectAcceptedPlans();
+        const matrix = [];
+        for (let i = 0; i < plans.length; i += 1) {
+            for (let j = i + 1; j < plans.length; j += 1) {
+                const candidatePlan = plans[i];
+                const comparisonPlan = plans[j];
+                const result = detectPlanCollisions(candidatePlan, [comparisonPlan], this.port.getPolicySnapshot());
+                if (result.hasCollisions) {
+                    matrix.push({
+                        feature_id: candidatePlan.feature_id,
+                        with_feature_id: comparisonPlan.feature_id,
+                        collisions: result.collisions,
+                        fingerprint: createCollisionFingerprint(result.collisions)
+                    });
+                }
+            }
+        }
+        return {
+            data: {
+                collisions: matrix
+            }
+        };
+    }
+    async reportDashboard() {
+        const index = await this.port.readIndex();
+        const featureIds = normalizeSet([
+            ...index.active,
+            ...index.blocked,
+            ...index.merged,
+            ...Object.values(index.locks).filter(Boolean)
+        ]);
+        const features = [];
+        for (const featureId of featureIds) {
+            const statePath = this.port.statePath(featureId);
+            if (!(await pathExists(statePath))) {
+                continue;
+            }
+            const state = await this.port.readState(featureId);
+            features.push({
+                feature_id: featureId,
+                status: state.frontMatter.status,
+                locks: readHeldLocks(state.frontMatter),
+                gate_profile: state.frontMatter.gate_profile,
+                gates: state.frontMatter.gates,
+                last_updated: state.frontMatter.last_updated
+            });
+        }
+        return {
+            data: {
+                index,
+                features
+            }
+        };
+    }
+    async reportFeatureSummary(featureId) {
+        const state = await this.port.featureStateGet(featureId);
+        const bundle = await this.port.repoDiffBundle(featureId);
+        const qa = await this.port.qaTestIndexGet(featureId);
+        return {
+            data: {
+                feature_id: featureId,
+                state: state.data.front_matter,
+                diff_stat: bundle.data.diff_stat,
+                touched_files: bundle.data.touched_files,
+                last_gate_summary: bundle.data.last_gate_summary,
+                qa_summary: qa.data.summary
+            }
+        };
+    }
+}
+//# sourceMappingURL=reporting-service.js.map

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

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

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

@@ -0,0 +1,74 @@
+import type { RuntimeSessionsSnapshot } from '../../core/runtime-sessions.js';
+export interface AcquireRunLeaseInput {
+    run_id: string;
+    owner_instance_id: string;
+    provider: string;
+    model: string;
+    provider_config_ref_hash: string;
+    takeover_stale_run?: boolean;
+}
+interface RuntimeFeatureSessionUpdateParams {
+    run_id: string;
+    owner_instance_id: string;
+    feature_id: string;
+    planner_session_id: string;
+    builder_session_id: string;
+    qa_session_id: string;
+}
+interface PruneFeatureSessionParams {
+    run_id: string;
+    owner_instance_id: string;
+    active_feature_ids: string[];
+}
+type IndexSnapshot = Record<string, any>;
+export interface RunLeaseServicePort {
+    runLeaseTtlSeconds(): number;
+    withIndexLock<T>(operation: () => Promise<T>): Promise<T>;
+    readIndex(): Promise<IndexSnapshot>;
+    writeIndex(index: IndexSnapshot): Promise<void>;
+    normalizeRuntimeSessions(value: unknown, at?: string): RuntimeSessionsSnapshot;
+    isRunLeaseFresh(runtimeSessions: RuntimeSessionsSnapshot): boolean;
+    emptyRuntimeSessions(at?: string): RuntimeSessionsSnapshot;
+}
+export declare class RunLeaseService {
+    private readonly port;
+    constructor(port: RunLeaseServicePort);
+    acquireRunLease(input: AcquireRunLeaseInput): Promise<{
+        data: {
+            runtime_sessions: RuntimeSessionsSnapshot;
+            took_over_stale: boolean;
+            reused_existing_owner: boolean;
+        };
+    }>;
+    renewRunLease(runId: string, ownerInstanceId: string): Promise<{
+        data: {
+            lease_expires_at: string;
+        };
+    }>;
+    releaseRunLease(runId: string, ownerInstanceId: string): Promise<{
+        data: {
+            released: boolean;
+        };
+    }>;
+    updateOrchestratorSession(params: {
+        run_id: string;
+        owner_instance_id: string;
+        orchestrator_session_id: string;
+        increment_epoch?: boolean;
+    }): Promise<{
+        data: {
+            runtime_sessions: RuntimeSessionsSnapshot;
+        };
+    }>;
+    updateFeatureSessionAssignment(params: RuntimeFeatureSessionUpdateParams): Promise<{
+        data: {
+            updated: boolean;
+        };
+    }>;
+    pruneFeatureSessionAssignments(params: PruneFeatureSessionParams): Promise<{
+        data: {
+            removed: string[];
+        };
+    }>;
+}
+export {};

package/dist/apps/control-plane/application/services/run-lease-service.js

@@ -0,0 +1,263 @@
+import crypto from 'node:crypto';
+import { nowIso, stableHash } from '../../core/fs.js';
+import { fail } from '../../core/response.js';
+import { ERROR_CODES } from '../../core/error-codes.js';
+export class RunLeaseService {
+    port;
+    constructor(port) {
+        this.port = port;
+    }
+    async acquireRunLease(input) {
+        if (!input.run_id || !input.owner_instance_id) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.INVALID_ARGUMENT, 'run_id and owner_instance_id are required', {
+                    retryable: false,
+                    requires_human: true
+                })
+            };
+        }
+        const ttlMs = this.port.runLeaseTtlSeconds() * 1000;
+        const normalizedProviderHash = input.provider_config_ref_hash && input.provider_config_ref_hash.length > 0
+            ? input.provider_config_ref_hash
+            : stableHash('none');
+        return await this.port.withIndexLock(async () => {
+            const index = await this.port.readIndex();
+            const current = this.port.normalizeRuntimeSessions(index.runtime_sessions);
+            const hasLease = current.run_id !== 'none' && current.owner_instance_id !== 'none';
+            const fresh = hasLease && this.port.isRunLeaseFresh(current);
+            const sameOwner = current.run_id === input.run_id && current.owner_instance_id === input.owner_instance_id;
+            if (fresh && !sameOwner) {
+                throw {
+                    normalizedResponse: fail(ERROR_CODES.RUN_ALREADY_ACTIVE, 'Another active run already owns this repository', {
+                        active_run_id: current.run_id,
+                        owner_instance_id: current.owner_instance_id,
+                        lease_expires_at: current.lease_expires_at,
+                        stale: false,
+                        retryable: false,
+                        requires_human: true
+                    })
+                };
+            }
+            const staleOwnedByOther = hasLease && !fresh && !sameOwner;
+            if (staleOwnedByOther && !input.takeover_stale_run) {
+                throw {
+                    normalizedResponse: fail(ERROR_CODES.RUN_ALREADY_ACTIVE, 'A stale run lease exists; explicit takeover is required', {
+                        active_run_id: current.run_id,
+                        owner_instance_id: current.owner_instance_id,
+                        lease_expires_at: current.lease_expires_at,
+                        stale: true,
+                        requires_takeover: true,
+                        retryable: false,
+                        requires_human: true
+                    })
+                };
+            }
+            const now = nowIso();
+            const isInitialRun = !hasLease || current.run_id === 'none';
+            const claimed = {
+                ...current,
+                run_id: input.run_id,
+                owner_instance_id: input.owner_instance_id,
+                lease_id: crypto.randomUUID(),
+                provider: input.provider,
+                model: input.model,
+                provider_config_ref_hash: normalizedProviderHash,
+                started_at: sameOwner && current.started_at ? current.started_at : now,
+                last_heartbeat_at: now,
+                lease_expires_at: new Date(Date.now() + ttlMs).toISOString(),
+                orchestrator_epoch: isInitialRun ? 0 : Number(current.orchestrator_epoch ?? 0)
+            };
+            if (!sameOwner) {
+                claimed.orchestrator_session_id = 'unknown';
+                claimed.feature_sessions = {};
+            }
+            index.runtime_sessions = claimed;
+            index.version += 1;
+            index.updated_at = nowIso();
+            await this.port.writeIndex(index);
+            return {
+                data: {
+                    runtime_sessions: claimed,
+                    took_over_stale: staleOwnedByOther,
+                    reused_existing_owner: sameOwner
+                }
+            };
+        });
+    }
+    async renewRunLease(runId, ownerInstanceId) {
+        if (!runId || !ownerInstanceId) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.INVALID_ARGUMENT, 'runId and ownerInstanceId are required', {
+                    retryable: false,
+                    requires_human: true
+                })
+            };
+        }
+        const ttlMs = this.port.runLeaseTtlSeconds() * 1000;
+        return await this.port.withIndexLock(async () => {
+            const index = await this.port.readIndex();
+            const current = this.port.normalizeRuntimeSessions(index.runtime_sessions);
+            if (current.run_id !== runId || current.owner_instance_id !== ownerInstanceId) {
+                throw {
+                    normalizedResponse: fail(ERROR_CODES.RUN_LEASE_NOT_OWNED, 'Cannot renew a run lease not owned by this instance', {
+                        run_id: runId,
+                        owner_instance_id: ownerInstanceId,
+                        active_run_id: current.run_id,
+                        active_owner_instance_id: current.owner_instance_id,
+                        retryable: false,
+                        requires_human: true
+                    })
+                };
+            }
+            const updated = {
+                ...current,
+                last_heartbeat_at: nowIso(),
+                lease_expires_at: new Date(Date.now() + ttlMs).toISOString()
+            };
+            index.runtime_sessions = updated;
+            index.version += 1;
+            index.updated_at = nowIso();
+            await this.port.writeIndex(index);
+            return {
+                data: {
+                    lease_expires_at: updated.lease_expires_at
+                }
+            };
+        });
+    }
+    async releaseRunLease(runId, ownerInstanceId) {
+        return await this.port.withIndexLock(async () => {
+            const index = await this.port.readIndex();
+            const current = this.port.normalizeRuntimeSessions(index.runtime_sessions);
+            if (current.run_id !== runId || current.owner_instance_id !== ownerInstanceId) {
+                return { data: { released: false } };
+            }
+            index.runtime_sessions = this.port.emptyRuntimeSessions(nowIso());
+            index.version += 1;
+            index.updated_at = nowIso();
+            await this.port.writeIndex(index);
+            return { data: { released: true } };
+        });
+    }
+    async updateOrchestratorSession(params) {
+        const { run_id, owner_instance_id, orchestrator_session_id, increment_epoch = false } = params;
+        if (!run_id || !owner_instance_id || !orchestrator_session_id) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.INVALID_ARGUMENT, 'run_id, owner_instance_id, and orchestrator_session_id are required', {
+                    retryable: false,
+                    requires_human: true
+                })
+            };
+        }
+        return await this.port.withIndexLock(async () => {
+            const index = await this.port.readIndex();
+            const current = this.port.normalizeRuntimeSessions(index.runtime_sessions);
+            if (current.run_id !== run_id || current.owner_instance_id !== owner_instance_id) {
+                throw {
+                    normalizedResponse: fail(ERROR_CODES.RUN_LEASE_NOT_OWNED, 'Cannot update orchestrator session without run ownership', {
+                        run_id,
+                        owner_instance_id,
+                        active_run_id: current.run_id,
+                        active_owner_instance_id: current.owner_instance_id,
+                        retryable: false,
+                        requires_human: true
+                    })
+                };
+            }
+            const nextEpoch = increment_epoch
+                ? Number(current.orchestrator_epoch ?? 0) + 1
+                : Number(current.orchestrator_epoch ?? 0);
+            const updated = {
+                ...current,
+                orchestrator_session_id,
+                orchestrator_epoch: nextEpoch
+            };
+            index.runtime_sessions = updated;
+            index.version += 1;
+            index.updated_at = nowIso();
+            await this.port.writeIndex(index);
+            return {
+                data: {
+                    runtime_sessions: updated
+                }
+            };
+        });
+    }
+    async updateFeatureSessionAssignment(params) {
+        const { run_id, owner_instance_id, feature_id, planner_session_id, builder_session_id, qa_session_id } = params;
+        return await this.port.withIndexLock(async () => {
+            const index = await this.port.readIndex();
+            const current = this.port.normalizeRuntimeSessions(index.runtime_sessions);
+            if (current.run_id !== run_id || current.owner_instance_id !== owner_instance_id) {
+                throw {
+                    normalizedResponse: fail(ERROR_CODES.RUN_LEASE_NOT_OWNED, 'Cannot update feature sessions without run ownership', {
+                        run_id,
+                        owner_instance_id,
+                        active_run_id: current.run_id,
+                        active_owner_instance_id: current.owner_instance_id,
+                        retryable: false,
+                        requires_human: true
+                    })
+                };
+            }
+            const nextFeatureSessions = {
+                ...(current.feature_sessions ?? {}),
+                [feature_id]: {
+                    planner_session_id,
+                    builder_session_id,
+                    qa_session_id
+                }
+            };
+            index.runtime_sessions = {
+                ...current,
+                feature_sessions: nextFeatureSessions
+            };
+            index.version += 1;
+            index.updated_at = nowIso();
+            await this.port.writeIndex(index);
+            return { data: { updated: true } };
+        });
+    }
+    async pruneFeatureSessionAssignments(params) {
+        const active = new Set(params.active_feature_ids);
+        return await this.port.withIndexLock(async () => {
+            const index = await this.port.readIndex();
+            const current = this.port.normalizeRuntimeSessions(index.runtime_sessions);
+            if (current.run_id !== params.run_id || current.owner_instance_id !== params.owner_instance_id) {
+                throw {
+                    normalizedResponse: fail(ERROR_CODES.RUN_LEASE_NOT_OWNED, 'Cannot prune feature sessions without run ownership', {
+                        run_id: params.run_id,
+                        owner_instance_id: params.owner_instance_id,
+                        active_run_id: current.run_id,
+                        active_owner_instance_id: current.owner_instance_id,
+                        retryable: false,
+                        requires_human: true
+                    })
+                };
+            }
+            const existing = current.feature_sessions ?? {};
+            const kept = {};
+            const removed = [];
+            for (const [featureId, assignment] of Object.entries(existing)) {
+                if (active.has(featureId)) {
+                    kept[featureId] = assignment;
+                }
+                else {
+                    removed.push(featureId);
+                }
+            }
+            if (removed.length > 0) {
+                index.runtime_sessions = {
+                    ...current,
+                    feature_sessions: kept
+                };
+                index.version += 1;
+                index.updated_at = nowIso();
+                await this.port.writeIndex(index);
+            }
+            removed.sort((a, b) => a.localeCompare(b));
+            return { data: { removed } };
+        });
+    }
+}
+//# sourceMappingURL=run-lease-service.js.map

package/dist/apps/control-plane/application/services/run-lease-service.js.map

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

package/dist/apps/control-plane/application/tools/tool-metadata.d.ts

@@ -0,0 +1,8 @@
+export interface ToolBehaviorMetadata {
+    mutating: boolean;
+    requires_operation_id: boolean;
+}
+export declare const TOOL_BEHAVIOR_METADATA: Readonly<Record<string, ToolBehaviorMetadata>>;
+export declare function isMutatingTool(toolName: string): boolean;
+export declare function toolRequiresOperationId(toolName: string): boolean;
+export declare function withOperationIdIfRequired(toolName: string, args: Record<string, unknown>, createOperationId: (toolName: string, featureId?: string) => string): Record<string, unknown>;

package/dist/apps/control-plane/application/tools/tool-metadata.js

@@ -0,0 +1,37 @@
+import { TOOLS } from '../../core/constants.js';
+const MUTATING_TOOLS = [
+    TOOLS.FEATURE_INIT,
+    TOOLS.FEATURE_STATE_PATCH,
+    TOOLS.FEATURE_LOG_APPEND,
+    TOOLS.PLAN_SUBMIT,
+    TOOLS.PLAN_UPDATE,
+    TOOLS.REPO_ENSURE_WORKTREE,
+    TOOLS.REPO_APPLY_PATCH,
+    TOOLS.GATES_RUN,
+    TOOLS.QA_TEST_INDEX_UPDATE,
+    TOOLS.LOCKS_ACQUIRE,
+    TOOLS.LOCKS_RELEASE,
+    TOOLS.FEATURE_READY_TO_MERGE,
+    TOOLS.FEATURE_DELETE
+];
+export const TOOL_BEHAVIOR_METADATA = Object.freeze(Object.fromEntries(MUTATING_TOOLS.map((name) => [name, { mutating: true, requires_operation_id: true }])));
+export function isMutatingTool(toolName) {
+    return TOOL_BEHAVIOR_METADATA[toolName]?.mutating ?? false;
+}
+export function toolRequiresOperationId(toolName) {
+    return TOOL_BEHAVIOR_METADATA[toolName]?.requires_operation_id ?? false;
+}
+export function withOperationIdIfRequired(toolName, args, createOperationId) {
+    if (!toolRequiresOperationId(toolName)) {
+        return { ...args };
+    }
+    if (typeof args.operation_id === 'string') {
+        return { ...args };
+    }
+    const featureId = typeof args.feature_id === 'string' ? args.feature_id : undefined;
+    return {
+        ...args,
+        operation_id: createOperationId(toolName, featureId)
+    };
+}
+//# sourceMappingURL=tool-metadata.js.map

package/dist/apps/control-plane/application/tools/tool-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-metadata.js","sourceRoot":"","sources":["../../../../../apps/control-plane/src/application/tools/tool-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAOhD,MAAM,cAAc,GAAG;IACrB,KAAK,CAAC,YAAY;IAClB,KAAK,CAAC,mBAAmB;IACzB,KAAK,CAAC,kBAAkB;IACxB,KAAK,CAAC,WAAW;IACjB,KAAK,CAAC,WAAW;IACjB,KAAK,CAAC,oBAAoB;IAC1B,KAAK,CAAC,gBAAgB;IACtB,KAAK,CAAC,SAAS;IACf,KAAK,CAAC,oBAAoB;IAC1B,KAAK,CAAC,aAAa;IACnB,KAAK,CAAC,aAAa;IACnB,KAAK,CAAC,sBAAsB;IAC5B,KAAK,CAAC,cAAc;CACZ,CAAC;AAEX,MAAM,CAAC,MAAM,sBAAsB,GAAmD,MAAM,CAAC,MAAM,CACjG,MAAM,CAAC,WAAW,CAChB,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAC,CACtF,CACF,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,sBAAsB,CAAC,QAAQ,CAAC,EAAE,QAAQ,IAAI,KAAK,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,OAAO,sBAAsB,CAAC,QAAQ,CAAC,EAAE,qBAAqB,IAAI,KAAK,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,QAAgB,EAChB,IAA6B,EAC7B,iBAAmE;IAEnE,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IACpF,OAAO;QACL,GAAG,IAAI;QACP,YAAY,EAAE,iBAAiB,CAAC,QAAQ,EAAE,SAAS,CAAC;KACrD,CAAC;AACJ,CAAC"}

package/dist/apps/control-plane/application/tools/tool-router.d.ts

@@ -0,0 +1,16 @@
+export interface ToolHandlerContext {
+    actorType: string;
+    actorId: string;
+}
+export type ToolHandler = (args: Record<string, unknown>, context: ToolHandlerContext) => Promise<unknown>;
+export declare class ToolHandlerRegistry {
+    private readonly handlers;
+    register(toolName: string, handler: ToolHandler): void;
+    lookup(toolName: string): ToolHandler | undefined;
+}
+export declare class ToolRouter {
+    private readonly registry;
+    private readonly unknownToolHandler;
+    constructor(registry: ToolHandlerRegistry, unknownToolHandler: (toolName: string) => Promise<unknown>);
+    route(toolName: string, args: Record<string, unknown>, context: ToolHandlerContext): Promise<unknown>;
+}

package/dist/apps/control-plane/application/tools/tool-router.js

@@ -0,0 +1,25 @@
+export class ToolHandlerRegistry {
+    handlers = new Map();
+    register(toolName, handler) {
+        this.handlers.set(toolName, handler);
+    }
+    lookup(toolName) {
+        return this.handlers.get(toolName);
+    }
+}
+export class ToolRouter {
+    registry;
+    unknownToolHandler;
+    constructor(registry, unknownToolHandler) {
+        this.registry = registry;
+        this.unknownToolHandler = unknownToolHandler;
+    }
+    async route(toolName, args, context) {
+        const handler = this.registry.lookup(toolName);
+        if (!handler) {
+            return await this.unknownToolHandler(toolName);
+        }
+        return await handler(args, context);
+    }
+}
+//# sourceMappingURL=tool-router.js.map

package/dist/apps/control-plane/application/tools/tool-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-router.js","sourceRoot":"","sources":["../../../../../apps/control-plane/src/application/tools/tool-router.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,mBAAmB;IACb,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE3D,QAAQ,CAAC,QAAgB,EAAE,OAAoB;QAC7C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,QAAgB;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,UAAU;IACJ,QAAQ,CAAsB;IAC9B,kBAAkB,CAAyC;IAE5E,YAAY,QAA6B,EAAE,kBAA0D;QACnG,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,KAAK,CACT,QAAgB,EAChB,IAA6B,EAC7B,OAA2B;QAE3B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,MAAM,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,MAAM,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF"}

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

@@ -0,0 +1,5 @@
+#!/usr/bin/env -S tsx
+import type { RuntimeContext } from './types.js';
+export declare function main(argv?: string[], runtime?: RuntimeContext): Promise<number>;
+export declare function isDirectExecution(importMetaUrl: string, argv1: string | undefined): boolean;
+export declare function runAsEntrypoint(importMetaUrl: string, argv1: string | undefined, executeMain?: () => Promise<number>): boolean;

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

@@ -0,0 +1,19 @@
+#!/usr/bin/env -S tsx
+import { runCli } from '../interfaces/cli/bootstrap.js';
+export async function main(argv = process.argv.slice(2), runtime = { cwd: process.cwd(), env: process.env }) {
+    return await runCli(argv, runtime);
+}
+export function isDirectExecution(importMetaUrl, argv1) {
+    return importMetaUrl === `file://${argv1 ?? ''}`;
+}
+export function runAsEntrypoint(importMetaUrl, argv1, executeMain = () => main()) {
+    if (!isDirectExecution(importMetaUrl, argv1)) {
+        return false;
+    }
+    void executeMain().then((exitCode) => {
+        process.exitCode = exitCode;
+    });
+    return true;
+}
+runAsEntrypoint(import.meta.url, process.argv[1]);
+//# sourceMappingURL=aop.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aop.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/cli/aop.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAGxD,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,OAAiB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EACtC,UAA0B,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;IAElE,OAAO,MAAM,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,aAAqB,EAAE,KAAyB;IAChF,OAAO,aAAa,KAAK,UAAU,KAAK,IAAI,EAAE,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,aAAqB,EACrB,KAAyB,EACzB,cAAqC,GAAG,EAAE,CAAC,IAAI,EAAE;IAEjD,IAAI,CAAC,iBAAiB,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;QACnC,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC9B,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC;AAED,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/apps/control-plane/cli/cli-argument-parser.d.ts

@@ -0,0 +1,5 @@
+import type { CliOptions, ToolTransport } from './types.js';
+export declare class CliArgumentParser {
+    parse(argv: string[]): CliOptions;
+    resolveTransport(option: string | undefined): ToolTransport;
+}