agentic-orchestrator 0.1.0

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

@@ -0,0 +1,81 @@
+type AnyRecord = Record<string, any>;
+type FeatureContext = {
+    actorType: string;
+    actorId: string;
+};
+export interface FeatureLifecycleServicePort {
+    getRepoRoot(): string;
+    getFeaturesDir(): string;
+    featurePath(featureId: string): string;
+    statePath(featureId: string): string;
+    qaIndexPath(featureId: string): string;
+    decisionsPath(featureId: string): string;
+    specPath(featureId: string): string;
+    ensureFeatureLayout(featureId: string): Promise<void>;
+    repoEnsureWorktree(featureId: string): Promise<{
+        data: {
+            worktree_path_abs: string;
+        };
+    }>;
+    makeDefaultState(featureId: string, branch: string, worktreePath: string): AnyRecord;
+    writeState(featureId: string, frontMatter: AnyRecord, body?: string): Promise<void>;
+    withIndexLock<T>(operation: () => Promise<T>): Promise<T>;
+    readIndex(): Promise<AnyRecord>;
+    writeIndex(index: AnyRecord): Promise<void>;
+    featureStateGet(featureId: string): Promise<{
+        data: {
+            front_matter: AnyRecord;
+            body: string;
+        };
+    }>;
+    planGet(featureId: string): Promise<{
+        data: {
+            plan: unknown;
+        };
+    }>;
+    qaTestIndexGet(featureId: string): Promise<{
+        data: unknown;
+    }>;
+    evidenceLatest(featureId: string): Promise<{
+        data: {
+            latest?: unknown | null;
+        };
+    }>;
+}
+export declare class FeatureLifecycleService {
+    private readonly port;
+    constructor(port: FeatureLifecycleServicePort);
+    featureDiscoverSpecs(): Promise<{
+        data: {
+            specs: Array<{
+                feature_id: string;
+                spec_path: string;
+            }>;
+        };
+    }>;
+    featureInit(featureId: string | null): Promise<{
+        data: {
+            feature_id: string | null;
+            initialized: boolean;
+            worktree_path: string;
+        };
+    }>;
+    featureGetContext(featureId: string): Promise<{
+        data: {
+            feature_id: string;
+            spec: string;
+            state: unknown;
+            plan: unknown;
+            qa_test_index: unknown;
+            latest_evidence: unknown;
+        };
+    }>;
+    featureLogAppend(featureId: string, note: string, context: FeatureContext): Promise<{
+        data: {
+            feature_id: string;
+            appended: boolean;
+            log_path: string;
+        };
+    }>;
+}
+export {};

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

@@ -0,0 +1,117 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { atomicWriteJson, nowIso, pathExists, stableHash } from '../../core/fs.js';
+import { fail } from '../../core/response.js';
+import { ERROR_CODES } from '../../core/error-codes.js';
+function normalizeSet(array) {
+    return [...new Set(array)].sort((a, b) => a.localeCompare(b));
+}
+function normalizeRepoPathForState(repoRoot, absolutePath) {
+    const relative = path.relative(repoRoot, absolutePath).replaceAll('\\\\', '/');
+    if (!relative || relative === '.') {
+        return '.';
+    }
+    return relative;
+}
+export class FeatureLifecycleService {
+    port;
+    constructor(port) {
+        this.port = port;
+    }
+    async featureDiscoverSpecs() {
+        const discovered = [];
+        const repoRoot = this.port.getRepoRoot();
+        const featuresDir = this.port.getFeaturesDir();
+        if (!(await pathExists(featuresDir))) {
+            return { data: { specs: [] } };
+        }
+        const entries = await fs.readdir(featuresDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory()) {
+                continue;
+            }
+            const specPath = path.join(featuresDir, entry.name, 'spec.md');
+            if (await pathExists(specPath)) {
+                discovered.push({
+                    feature_id: entry.name,
+                    spec_path: normalizeRepoPathForState(repoRoot, specPath)
+                });
+            }
+        }
+        discovered.sort((a, b) => a.feature_id.localeCompare(b.feature_id));
+        return { data: { specs: discovered } };
+    }
+    async featureInit(featureId) {
+        if (!featureId) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.INVALID_ARGUMENT, 'feature_id is required', {
+                    retryable: false,
+                    requires_human: true
+                })
+            };
+        }
+        const repoRoot = this.port.getRepoRoot();
+        await this.port.ensureFeatureLayout(featureId);
+        const worktreeResult = await this.port.repoEnsureWorktree(featureId);
+        const stateFileExists = await pathExists(this.port.statePath(featureId));
+        if (!stateFileExists) {
+            const defaultState = this.port.makeDefaultState(featureId, featureId, worktreeResult.data.worktree_path_abs);
+            await this.port.writeState(featureId, defaultState, '## Activity\n\nInitialized feature.\n');
+        }
+        const qaIndexExists = await pathExists(this.port.qaIndexPath(featureId));
+        if (!qaIndexExists) {
+            await atomicWriteJson(this.port.qaIndexPath(featureId), {
+                feature_id: featureId,
+                version: 1,
+                source_diff_ref: stableHash('empty'),
+                items: []
+            });
+        }
+        await this.port.withIndexLock(async () => {
+            const index = await this.port.readIndex();
+            index.active = normalizeSet([...(index.active ?? []), featureId]);
+            index.blocked = normalizeSet((index.blocked ?? []).filter((id) => id !== featureId));
+            index.version += 1;
+            index.updated_at = nowIso();
+            await this.port.writeIndex(index);
+        });
+        return {
+            data: {
+                feature_id: featureId,
+                initialized: true,
+                worktree_path: normalizeRepoPathForState(repoRoot, worktreeResult.data.worktree_path_abs)
+            }
+        };
+    }
+    async featureGetContext(featureId) {
+        const state = await this.port.featureStateGet(featureId);
+        const plan = await this.port.planGet(featureId);
+        const qaIndex = await this.port.qaTestIndexGet(featureId);
+        const evidence = await this.port.evidenceLatest(featureId);
+        const specText = await fs.readFile(this.port.specPath(featureId), 'utf8').catch(() => '');
+        return {
+            data: {
+                feature_id: featureId,
+                spec: specText,
+                state: state.data,
+                plan: plan.data.plan,
+                qa_test_index: qaIndex.data,
+                latest_evidence: evidence.data?.latest ?? null
+            }
+        };
+    }
+    async featureLogAppend(featureId, note, context) {
+        const repoRoot = this.port.getRepoRoot();
+        const logPath = this.port.decisionsPath(featureId);
+        const line = `- ${nowIso()} [${context.actorType}:${context.actorId}] ${note}\n`;
+        await fs.appendFile(logPath, line, 'utf8');
+        return {
+            data: {
+                feature_id: featureId,
+                appended: true,
+                log_path: normalizeRepoPathForState(repoRoot, logPath)
+            }
+        };
+    }
+}
+//# sourceMappingURL=feature-lifecycle-service.js.map

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

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

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

@@ -0,0 +1,34 @@
+type AnyRecord = Record<string, any>;
+type StateReadResult = {
+    frontMatter: AnyRecord;
+    body: string;
+    raw?: string;
+};
+type StateUpdater = (frontMatter: AnyRecord, body: string) => Promise<{
+    frontMatter?: AnyRecord;
+    body?: string;
+}>;
+export interface FeatureStateServicePort {
+    withFeatureLock<T>(featureId: string, operation: () => Promise<T>): Promise<T>;
+    readState(featureId: string): Promise<StateReadResult>;
+    writeState(featureId: string, frontMatter: AnyRecord, body?: string): Promise<void>;
+}
+export declare class FeatureStateService {
+    private readonly port;
+    constructor(port: FeatureStateServicePort);
+    updateState(featureId: string, expectedVersion: number | null, updater: StateUpdater): Promise<AnyRecord>;
+    featureStateGet(featureId: string): Promise<{
+        data: {
+            front_matter: AnyRecord;
+            body: string;
+        };
+    }>;
+    featureStatePatch(featureId: string, expectedVersion: number | null, patch: AnyRecord | null | undefined): Promise<{
+        data: {
+            feature_id: string;
+            version: number;
+            status: string;
+        };
+    }>;
+}
+export {};

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

@@ -0,0 +1,90 @@
+import { nowIso } from '../../core/fs.js';
+import { fail } from '../../core/response.js';
+import { ERROR_CODES } from '../../core/error-codes.js';
+import { STATUS } from '../../core/constants.js';
+const LEGAL_TRANSITIONS = {
+    [STATUS.PLANNING]: [STATUS.BUILDING, STATUS.BLOCKED, STATUS.PLANNING],
+    [STATUS.BUILDING]: [STATUS.QA, STATUS.BLOCKED, STATUS.BUILDING],
+    [STATUS.QA]: [STATUS.READY_TO_MERGE, STATUS.BLOCKED, STATUS.QA],
+    [STATUS.READY_TO_MERGE]: [STATUS.MERGED, STATUS.BLOCKED, STATUS.READY_TO_MERGE],
+    [STATUS.BLOCKED]: [STATUS.PLANNING, STATUS.BUILDING, STATUS.QA, STATUS.BLOCKED],
+    [STATUS.MERGED]: [STATUS.MERGED],
+    [STATUS.FAILED]: [STATUS.FAILED, STATUS.BLOCKED]
+};
+function isTransitionLegal(from, to) {
+    const allowed = LEGAL_TRANSITIONS[from] ?? [];
+    return allowed.includes(to);
+}
+function readVersion(frontMatter) {
+    const raw = frontMatter.version;
+    if (typeof raw === 'number' && Number.isFinite(raw)) {
+        return raw;
+    }
+    return 0;
+}
+export class FeatureStateService {
+    port;
+    constructor(port) {
+        this.port = port;
+    }
+    async updateState(featureId, expectedVersion, updater) {
+        return await this.port.withFeatureLock(featureId, async () => {
+            const current = await this.port.readState(featureId);
+            if (expectedVersion != null && current.frontMatter.version !== expectedVersion) {
+                throw {
+                    normalizedResponse: fail(ERROR_CODES.VERSION_CONFLICT, 'state version conflict', {
+                        expected_version: expectedVersion,
+                        actual_version: current.frontMatter.version,
+                        retryable: true,
+                        requires_human: false
+                    })
+                };
+            }
+            const next = await updater(structuredClone(current.frontMatter), current.body);
+            const merged = {
+                ...current.frontMatter,
+                ...next.frontMatter,
+                version: readVersion(current.frontMatter) + 1,
+                last_updated: nowIso()
+            };
+            if (!isTransitionLegal(current.frontMatter.status, merged.status)) {
+                throw {
+                    normalizedResponse: fail(ERROR_CODES.INVALID_STATUS_TRANSITION, 'illegal state status transition', {
+                        from: current.frontMatter.status,
+                        to: merged.status,
+                        retryable: false,
+                        requires_human: true
+                    })
+                };
+            }
+            await this.port.writeState(featureId, merged, next.body ?? current.body);
+            return merged;
+        });
+    }
+    async featureStateGet(featureId) {
+        const state = await this.port.readState(featureId);
+        return {
+            data: {
+                front_matter: state.frontMatter,
+                body: state.body
+            }
+        };
+    }
+    async featureStatePatch(featureId, expectedVersion, patch) {
+        const updated = await this.updateState(featureId, expectedVersion, (frontMatter, body) => {
+            const nextFront = { ...frontMatter, ...(patch?.front_matter ?? {}) };
+            return Promise.resolve({
+                frontMatter: nextFront,
+                body: patch?.body ?? body
+            });
+        });
+        return {
+            data: {
+                feature_id: featureId,
+                version: updated.version,
+                status: updated.status
+            }
+        };
+    }
+}
+//# sourceMappingURL=feature-state-service.js.map

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

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

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

@@ -0,0 +1,46 @@
+type AnyRecord = Record<string, any>;
+type StateUpdater = (frontMatter: AnyRecord, body: string) => Promise<{
+    frontMatter?: AnyRecord;
+    body?: string;
+}>;
+export interface GateServicePort {
+    getRepoRoot(): string;
+    getGatesConfig(): AnyRecord;
+    getPolicySnapshot(): AnyRecord;
+    readState(featureId: string): Promise<{
+        frontMatter: AnyRecord;
+    }>;
+    updateState(featureId: string, expectedVersion: number | null, updater: StateUpdater): Promise<AnyRecord>;
+    worktreePath(featureId: string): string;
+    logsPath(featureId: string): string;
+    evidencePath(featureId: string): string;
+}
+export declare class GateService {
+    private readonly port;
+    constructor(port: GateServicePort);
+    gatesList(profileName?: string | null): {
+        data: AnyRecord;
+    };
+    gateProfileAndMode(profileName: string, mode: string): AnyRecord;
+    gatesRun(featureId: string, profileName: string | null, mode: string): Promise<{
+        data: {
+            feature_id: string;
+            mode: string;
+            profile: string;
+            overall: string;
+            coverage: unknown;
+            evidence_path: string;
+        };
+        evidence: {
+            log_path: string;
+        };
+    }>;
+    evidenceLatest(featureId: string): Promise<{
+        data: {
+            feature_id: string;
+            latest: AnyRecord | null;
+            path?: string;
+        };
+    }>;
+}
+export {};

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

@@ -0,0 +1,160 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { pathExists } from '../../core/fs.js';
+import { runGateMode } from '../../core/gates.js';
+import { ERROR_CODES } from '../../core/error-codes.js';
+import { fail } from '../../core/response.js';
+import { GATE_RESULT, STATUS } from '../../core/constants.js';
+function normalizeRepoPathForState(repoRoot, absolutePath) {
+    const relative = path.relative(repoRoot, absolutePath).replaceAll('\\\\', '/');
+    if (!relative || relative === '.') {
+        return '.';
+    }
+    return relative;
+}
+function deriveStatusFromGateResult(currentStatus, mode, overall) {
+    if (overall === 'fail') {
+        return STATUS.BLOCKED;
+    }
+    if (currentStatus === STATUS.BUILDING && mode === 'fast' && overall === 'pass') {
+        return STATUS.QA;
+    }
+    if (currentStatus === STATUS.QA && mode === 'full' && overall === 'pass') {
+        return STATUS.READY_TO_MERGE;
+    }
+    return currentStatus;
+}
+export class GateService {
+    port;
+    constructor(port) {
+        this.port = port;
+    }
+    gatesList(profileName = null) {
+        const gatesConfig = this.port.getGatesConfig();
+        if (profileName) {
+            return {
+                data: {
+                    profile: profileName,
+                    config: gatesConfig.profiles[profileName] ?? null
+                }
+            };
+        }
+        return {
+            data: {
+                profiles: gatesConfig.profiles
+            }
+        };
+    }
+    gateProfileAndMode(profileName, mode) {
+        const profile = this.port.getGatesConfig().profiles[profileName];
+        if (!profile || !profile.modes?.[mode]) {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.UNKNOWN_GATE_PROFILE_OR_MODE, 'Unknown gate profile or mode', {
+                    profile: profileName,
+                    mode,
+                    retryable: false,
+                    requires_human: true
+                })
+            };
+        }
+        return profile;
+    }
+    async gatesRun(featureId, profileName, mode) {
+        const state = await this.port.readState(featureId);
+        const effectiveProfileName = profileName ?? state.frontMatter.gate_profile ?? 'default';
+        const profile = this.gateProfileAndMode(effectiveProfileName, mode);
+        const repoRoot = this.port.getRepoRoot();
+        const runResult = (await runGateMode({
+            featureId,
+            mode,
+            profileName: effectiveProfileName,
+            profile,
+            policy: this.port.getPolicySnapshot(),
+            worktreePath: this.port.worktreePath(featureId),
+            logDirectory: this.port.logsPath(featureId),
+            evidenceDirectory: this.port.evidencePath(featureId)
+        }));
+        const nextStateStatus = deriveStatusFromGateResult(state.frontMatter.status, mode, runResult.overall);
+        await this.port.updateState(featureId, state.frontMatter.version, (frontMatter, body) => Promise.resolve({
+            frontMatter: {
+                status: nextStateStatus,
+                status_reason: runResult.overall === 'fail' ? `Gate mode ${mode} failed` : frontMatter.status_reason,
+                gates: {
+                    ...frontMatter.gates,
+                    [mode]: runResult.overall === 'pass' ? GATE_RESULT.PASS : GATE_RESULT.FAIL
+                },
+                evidence: {
+                    last_gate_mode: mode,
+                    last_gate_evidence_path: normalizeRepoPathForState(repoRoot, runResult.evidence_path),
+                    coverage_status: runResult.coverage_status
+                }
+            },
+            body
+        }));
+        if (runResult.overall === 'fail' && runResult.coverage_status === 'fail') {
+            throw {
+                normalizedResponse: fail(ERROR_CODES.COVERAGE_BELOW_MINIMUM, 'Coverage thresholds not met', {
+                    feature_id: featureId,
+                    mode,
+                    coverage: runResult.coverage,
+                    thresholds: runResult.thresholds,
+                    retryable: true,
+                    requires_human: false
+                }, {
+                    log_path: normalizeRepoPathForState(repoRoot, runResult.latest_path)
+                })
+            };
+        }
+        return {
+            data: {
+                feature_id: featureId,
+                mode,
+                profile: effectiveProfileName,
+                overall: runResult.overall,
+                coverage: runResult.coverage,
+                evidence_path: normalizeRepoPathForState(repoRoot, runResult.evidence_path)
+            },
+            evidence: {
+                log_path: normalizeRepoPathForState(repoRoot, runResult.latest_path)
+            }
+        };
+    }
+    async evidenceLatest(featureId) {
+        const repoRoot = this.port.getRepoRoot();
+        const evidenceDir = this.port.evidencePath(featureId);
+        if (!(await pathExists(evidenceDir))) {
+            return {
+                data: {
+                    feature_id: featureId,
+                    latest: null
+                }
+            };
+        }
+        const files = (await fs.readdir(evidenceDir))
+            .filter((file) => file.endsWith('.json'))
+            .map((file) => path.join(evidenceDir, file));
+        if (files.length === 0) {
+            return {
+                data: {
+                    feature_id: featureId,
+                    latest: null
+                }
+            };
+        }
+        const withStats = await Promise.all(files.map(async (file) => {
+            const stat = await fs.stat(file);
+            return { file, mtimeMs: stat.mtimeMs };
+        }));
+        withStats.sort((a, b) => b.mtimeMs - a.mtimeMs);
+        const latestFile = withStats[0].file;
+        const latest = JSON.parse(await fs.readFile(latestFile, 'utf8'));
+        return {
+            data: {
+                feature_id: featureId,
+                latest,
+                path: normalizeRepoPathForState(repoRoot, latestFile)
+            }
+        };
+    }
+}
+//# sourceMappingURL=gate-service.js.map

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

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

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

@@ -0,0 +1,56 @@
+type AnyRecord = Record<string, any>;
+type StateUpdater = (frontMatter: AnyRecord, body: string) => Promise<{
+    frontMatter?: AnyRecord;
+    body?: string;
+}>;
+interface CollisionQueueDrivePort {
+    reDriveBlockedQueue(): Promise<{
+        data: {
+            processed: number;
+            retried: number;
+            still_blocked: number;
+        };
+    }>;
+}
+export interface LockServicePort {
+    withIndexLock<T>(operation: () => Promise<T>): Promise<T>;
+    readIndex(): Promise<AnyRecord>;
+    writeIndex(index: AnyRecord): Promise<void>;
+    updateState(featureId: string, expectedVersion: number | null, updater: StateUpdater): Promise<AnyRecord>;
+    statePath(featureId: string): string;
+    getPolicySnapshot(): AnyRecord;
+    collisionQueueService?: CollisionQueueDrivePort;
+}
+export declare class LockService {
+    private readonly port;
+    constructor(port: LockServicePort);
+    locksAcquire(resource: string | null, featureId: string | null, waitTimeoutSeconds?: number | null): Promise<{
+        data: {
+            resource: string;
+            feature_id: string;
+            lease_id: any;
+            expires_at: any;
+            stale_reclaimed: any;
+        };
+        evidence: {
+            code: "stale_lock_reclaimed";
+            message: string;
+        };
+    }>;
+    locksRelease(resource: string | null, featureId: string | null): Promise<{
+        data: {
+            resource: string;
+            feature_id: string;
+            released: boolean;
+        };
+    }>;
+    renewLeases(featureIds: string[]): Promise<void>;
+    recoverFromState(): Promise<{
+        data: {
+            recovered: boolean;
+            stale_features: string[];
+            active: unknown;
+        };
+    }>;
+}
+export {};