agentic-orchestrator 0.1.0

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

@@ -0,0 +1,30 @@
+import YAML from 'yaml';
+export class StateMarkdownSerializer {
+    parse(markdown) {
+        const normalized = markdown.replace(/\r\n/g, '\n');
+        if (!normalized.startsWith('---\n')) {
+            return { frontMatter: {}, body: normalized };
+        }
+        const endMarker = '\n---\n';
+        const endIndex = normalized.indexOf(endMarker, 4);
+        if (endIndex === -1) {
+            return { frontMatter: {}, body: normalized };
+        }
+        const yamlSegment = normalized.slice(4, endIndex);
+        const body = normalized.slice(endIndex + endMarker.length);
+        const frontMatter = (YAML.parse(yamlSegment) ?? {});
+        return { frontMatter, body };
+    }
+    build(frontMatter, body = '') {
+        const yamlText = YAML.stringify(frontMatter).trimEnd();
+        return `---\n${yamlText}\n---\n${body.startsWith('\n') ? body.slice(1) : body}`;
+    }
+}
+export const stateMarkdownSerializer = new StateMarkdownSerializer();
+export function parseFrontMatter(markdown) {
+    return stateMarkdownSerializer.parse(markdown);
+}
+export function buildFrontMatter(frontMatter, body = '') {
+    return stateMarkdownSerializer.build(frontMatter, body);
+}
+//# sourceMappingURL=frontmatter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/core/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAOxB,MAAM,OAAO,uBAAuB;IAClC,KAAK,CAAC,QAAgB;QACpB,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAC/C,CAAC;QAED,MAAM,SAAS,GAAG,SAAS,CAAC;QAC5B,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAClD,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YACpB,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAC/C,CAAC;QAED,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QAC3D,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAA4B,CAAC;QAE/E,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,WAAoC,EAAE,IAAI,GAAG,EAAE;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;QACvD,OAAO,QAAQ,QAAQ,UAAU,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClF,CAAC;CACF;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,uBAAuB,EAAE,CAAC;AAErE,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,uBAAuB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,WAAoC,EAAE,IAAI,GAAG,EAAE;IAC9E,OAAO,uBAAuB,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AAC1D,CAAC"}

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

@@ -0,0 +1,33 @@
+export interface FileLockOptions {
+    timeoutMs?: number;
+    initialBackoffMs?: number;
+    maxBackoffMs?: number;
+}
+export declare class PathFsAdapter {
+    ensureDir(dirPath: string): Promise<void>;
+    pathExists(targetPath: string): Promise<boolean>;
+    readJson<T = unknown>(filePath: string, fallback?: T | null): Promise<T | null>;
+}
+export declare class AtomicFileWriter {
+    private readonly fsAdapter;
+    constructor(fsAdapter: PathFsAdapter);
+    writeFile(filePath: string, content: string): Promise<void>;
+    writeJson(filePath: string, value: unknown): Promise<void>;
+}
+export declare class FileLockManager {
+    private readonly fsAdapter;
+    constructor(fsAdapter: PathFsAdapter);
+    private sleep;
+    withFileLock<T>(lockPath: string, operation: () => Promise<T>, options?: FileLockOptions): Promise<T>;
+}
+export declare const pathFsAdapter: PathFsAdapter;
+export declare const atomicFileWriter: AtomicFileWriter;
+export declare const fileLockManager: FileLockManager;
+export declare function ensureDir(dirPath: string): Promise<void>;
+export declare function pathExists(targetPath: string): Promise<boolean>;
+export declare function readJson<T = unknown>(filePath: string, fallback?: T | null): Promise<T | null>;
+export declare function atomicWriteFile(filePath: string, content: string): Promise<void>;
+export declare function atomicWriteJson(filePath: string, value: unknown): Promise<void>;
+export declare function withFileLock<T>(lockPath: string, operation: () => Promise<T>, options?: FileLockOptions): Promise<T>;
+export declare function stableHash(input: string): string;
+export declare function nowIso(): string;

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

@@ -0,0 +1,134 @@
+import fs from 'node:fs';
+import fsp from 'node:fs/promises';
+import path from 'node:path';
+import crypto from 'node:crypto';
+export class PathFsAdapter {
+    async ensureDir(dirPath) {
+        await fsp.mkdir(dirPath, { recursive: true });
+    }
+    async pathExists(targetPath) {
+        try {
+            await fsp.access(targetPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async readJson(filePath, fallback = null) {
+        try {
+            const content = await fsp.readFile(filePath, 'utf8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            const typed = error;
+            if (typed.code === 'ENOENT') {
+                return fallback;
+            }
+            throw error;
+        }
+    }
+}
+export class AtomicFileWriter {
+    fsAdapter;
+    constructor(fsAdapter) {
+        this.fsAdapter = fsAdapter;
+    }
+    async writeFile(filePath, content) {
+        const directory = path.dirname(filePath);
+        await this.fsAdapter.ensureDir(directory);
+        const tempFile = path.join(directory, `.tmp-${path.basename(filePath)}-${crypto.randomUUID()}`);
+        const fileHandle = await fsp.open(tempFile, 'w', 0o644);
+        try {
+            await fileHandle.writeFile(content, 'utf8');
+            await fileHandle.sync();
+        }
+        finally {
+            await fileHandle.close();
+        }
+        await fsp.rename(tempFile, filePath);
+        const dirHandle = await fsp.open(directory, 'r');
+        try {
+            await dirHandle.sync();
+        }
+        finally {
+            await dirHandle.close();
+        }
+    }
+    async writeJson(filePath, value) {
+        const content = `${JSON.stringify(value, null, 2)}\n`;
+        await this.writeFile(filePath, content);
+    }
+}
+export class FileLockManager {
+    fsAdapter;
+    constructor(fsAdapter) {
+        this.fsAdapter = fsAdapter;
+    }
+    async sleep(ms) {
+        await new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    async withFileLock(lockPath, operation, options = {}) {
+        const timeoutMs = options.timeoutMs ?? 30_000;
+        const initialBackoffMs = options.initialBackoffMs ?? 30;
+        const maxBackoffMs = options.maxBackoffMs ?? 750;
+        await this.fsAdapter.ensureDir(path.dirname(lockPath));
+        const started = Date.now();
+        let backoff = initialBackoffMs;
+        while (Date.now() - started <= timeoutMs) {
+            try {
+                const lockHandle = await fsp.open(lockPath, fs.constants.O_CREAT | fs.constants.O_EXCL | fs.constants.O_RDWR, 0o644);
+                try {
+                    await lockHandle.writeFile(JSON.stringify({ pid: process.pid, at: new Date().toISOString() }), 'utf8');
+                    await lockHandle.sync();
+                }
+                finally {
+                    await lockHandle.close();
+                }
+                try {
+                    return await operation();
+                }
+                finally {
+                    await fsp.rm(lockPath, { force: true });
+                }
+            }
+            catch (error) {
+                const typed = error;
+                if (typed.code !== 'EEXIST') {
+                    throw error;
+                }
+            }
+            await this.sleep(backoff);
+            backoff = Math.min(maxBackoffMs, backoff * 2);
+        }
+        throw new Error(`lock_timeout:${lockPath}`);
+    }
+}
+export const pathFsAdapter = new PathFsAdapter();
+export const atomicFileWriter = new AtomicFileWriter(pathFsAdapter);
+export const fileLockManager = new FileLockManager(pathFsAdapter);
+export async function ensureDir(dirPath) {
+    await pathFsAdapter.ensureDir(dirPath);
+}
+export async function pathExists(targetPath) {
+    return await pathFsAdapter.pathExists(targetPath);
+}
+export async function readJson(filePath, fallback = null) {
+    return await pathFsAdapter.readJson(filePath, fallback);
+}
+export async function atomicWriteFile(filePath, content) {
+    await atomicFileWriter.writeFile(filePath, content);
+}
+export async function atomicWriteJson(filePath, value) {
+    await atomicFileWriter.writeJson(filePath, value);
+}
+export async function withFileLock(lockPath, operation, options = {}) {
+    return await fileLockManager.withFileLock(lockPath, operation, options);
+}
+export function stableHash(input) {
+    return crypto.createHash('sha256').update(input).digest('hex');
+}
+export function nowIso() {
+    return new Date().toISOString();
+}
+//# sourceMappingURL=fs.js.map

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

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

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

@@ -0,0 +1,88 @@
+export interface CoverageMetrics {
+    line: number;
+    branch: number;
+    details: Record<string, number>;
+}
+export interface ParserConfig {
+    type: 'none' | 'lcov' | 'junit_xml' | 'jacoco_xml' | 'cobertura_xml' | string;
+    path?: string;
+}
+export interface GateThresholds {
+    coverage_line_min: number;
+    coverage_branch_min: number;
+    coverage_line_target: number;
+    coverage_branch_target: number;
+}
+export interface GateStep {
+    name: string;
+    cmd: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    timeout_seconds?: number;
+}
+export interface GateProfile {
+    modes?: Record<string, GateStep[]>;
+    parsers?: {
+        coverage?: ParserConfig;
+    };
+    thresholds?: Partial<GateThresholds>;
+}
+export interface PolicyShape {
+    execution: {
+        retry_policy: {
+            transient_max_retries: number;
+            transient_error_codes: number[];
+        };
+        env_allowlist: string[];
+        default_step_timeout_seconds: number;
+    };
+    testing: {
+        coverage: {
+            minimums: {
+                line: number;
+                branch: number;
+            };
+            targets: {
+                line: number;
+                branch: number;
+            };
+        };
+    };
+}
+export interface CoverageParserStrategy {
+    readonly type: string;
+    parse(content: string): CoverageMetrics;
+}
+export declare class CoverageParserRegistry {
+    private readonly strategies;
+    constructor(strategies: CoverageParserStrategy[]);
+    parse(parserConfig: ParserConfig | undefined, content: string): CoverageMetrics | null;
+}
+export declare class CoverageThresholdPolicy {
+    merge(policy: PolicyShape, profileThresholds?: Partial<GateThresholds>): GateThresholds;
+}
+export declare function parseCoverage(parserConfig: ParserConfig | undefined, worktreePath: string): Promise<CoverageMetrics | null>;
+export declare class GateExecutionService {
+    private readonly thresholdPolicy;
+    constructor(thresholdPolicy: CoverageThresholdPolicy);
+    runMode({ featureId, mode, profileName, profile, policy, worktreePath, logDirectory, evidenceDirectory }: {
+        featureId: string;
+        mode: string;
+        profileName: string;
+        profile: GateProfile;
+        policy: PolicyShape;
+        worktreePath: string;
+        logDirectory: string;
+        evidenceDirectory: string;
+    }): Promise<Record<string, unknown>>;
+}
+export declare function runGateMode({ featureId, mode, profileName, profile, policy, worktreePath, logDirectory, evidenceDirectory }: {
+    featureId: string;
+    mode: string;
+    profileName: string;
+    profile: GateProfile;
+    policy: PolicyShape;
+    worktreePath: string;
+    logDirectory: string;
+    evidenceDirectory: string;
+}): Promise<Record<string, unknown>>;

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

@@ -0,0 +1,229 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { runCommand } from './git.js';
+import { ensureDir, nowIso } from './fs.js';
+class LcovCoverageParser {
+    type = 'lcov';
+    parse(content) {
+        const linesFound = Number(content.match(/^LF:(\d+)/m)?.[1] ?? 0);
+        const linesHit = Number(content.match(/^LH:(\d+)/m)?.[1] ?? 0);
+        const branchesFound = Number(content.match(/^BRF:(\d+)/m)?.[1] ?? 0);
+        const branchesHit = Number(content.match(/^BRH:(\d+)/m)?.[1] ?? 0);
+        return {
+            line: linesFound > 0 ? linesHit / linesFound : 1,
+            branch: branchesFound > 0 ? branchesHit / branchesFound : 1,
+            details: { linesFound, linesHit, branchesFound, branchesHit }
+        };
+    }
+}
+class JunitXmlCoverageParser {
+    type = 'junit_xml';
+    parse(content) {
+        const tests = Number(content.match(/tests="(\d+)"/)?.[1] ?? 0);
+        const failures = Number(content.match(/failures="(\d+)"/)?.[1] ?? 0);
+        const errors = Number(content.match(/errors="(\d+)"/)?.[1] ?? 0);
+        const passRate = tests > 0 ? (tests - failures - errors) / tests : 1;
+        return { line: passRate, branch: passRate, details: { tests, failures, errors } };
+    }
+}
+class JacocoXmlCoverageParser {
+    type = 'jacoco_xml';
+    parse(content) {
+        const lineMatch = content.match(/<counter type="LINE" missed="(\d+)" covered="(\d+)"/);
+        const branchMatch = content.match(/<counter type="BRANCH" missed="(\d+)" covered="(\d+)"/);
+        const lineMissed = Number(lineMatch?.[1] ?? 0);
+        const lineCovered = Number(lineMatch?.[2] ?? 0);
+        const branchMissed = Number(branchMatch?.[1] ?? 0);
+        const branchCovered = Number(branchMatch?.[2] ?? 0);
+        return {
+            line: lineCovered + lineMissed > 0 ? lineCovered / (lineCovered + lineMissed) : 1,
+            branch: branchCovered + branchMissed > 0 ? branchCovered / (branchCovered + branchMissed) : 1,
+            details: { lineMissed, lineCovered, branchMissed, branchCovered }
+        };
+    }
+}
+class CoberturaXmlCoverageParser {
+    type = 'cobertura_xml';
+    parse(content) {
+        const lineRate = Number(content.match(/line-rate="([0-9.]+)"/)?.[1] ?? 1);
+        const branchRate = Number(content.match(/branch-rate="([0-9.]+)"/)?.[1] ?? 1);
+        return {
+            line: lineRate,
+            branch: branchRate,
+            details: { lineRate, branchRate }
+        };
+    }
+}
+export class CoverageParserRegistry {
+    strategies;
+    constructor(strategies) {
+        this.strategies = new Map(strategies.map((strategy) => [strategy.type, strategy]));
+    }
+    parse(parserConfig, content) {
+        if (!parserConfig || parserConfig.type === 'none') {
+            return null;
+        }
+        const strategy = this.strategies.get(parserConfig.type);
+        if (!strategy) {
+            throw new Error(`unsupported_parser:${parserConfig.type}`);
+        }
+        return strategy.parse(content);
+    }
+}
+export class CoverageThresholdPolicy {
+    merge(policy, profileThresholds = {}) {
+        return {
+            coverage_line_min: Math.max(policy.testing.coverage.minimums.line, profileThresholds.coverage_line_min ?? 0),
+            coverage_branch_min: Math.max(policy.testing.coverage.minimums.branch, profileThresholds.coverage_branch_min ?? 0),
+            coverage_line_target: Math.max(policy.testing.coverage.targets.line, profileThresholds.coverage_line_target ?? 0),
+            coverage_branch_target: Math.max(policy.testing.coverage.targets.branch, profileThresholds.coverage_branch_target ?? 0)
+        };
+    }
+}
+function pickAllowedEnv(envAllowlist = []) {
+    const env = {};
+    for (const key of envAllowlist) {
+        if (Object.prototype.hasOwnProperty.call(process.env, key)) {
+            env[key] = process.env[key];
+        }
+    }
+    return env;
+}
+export async function parseCoverage(parserConfig, worktreePath) {
+    if (!parserConfig || parserConfig.type === 'none') {
+        return null;
+    }
+    const coveragePath = path.join(worktreePath, parserConfig.path ?? '');
+    const content = await fs.readFile(coveragePath, 'utf8');
+    return defaultCoverageParserRegistry.parse(parserConfig, content);
+}
+export class GateExecutionService {
+    thresholdPolicy;
+    constructor(thresholdPolicy) {
+        this.thresholdPolicy = thresholdPolicy;
+    }
+    async runMode({ featureId, mode, profileName, profile, policy, worktreePath, logDirectory, evidenceDirectory }) {
+        const modeSteps = profile.modes?.[mode];
+        if (!Array.isArray(modeSteps)) {
+            throw new Error(`unknown_gate_profile_or_mode:${profileName}/${mode}`);
+        }
+        await ensureDir(logDirectory);
+        await ensureDir(evidenceDirectory);
+        const retryPolicy = policy.execution.retry_policy;
+        const env = pickAllowedEnv(policy.execution.env_allowlist);
+        const stepResults = [];
+        let overall = 'pass';
+        for (const step of modeSteps) {
+            const timeoutSeconds = Number(step.timeout_seconds ?? policy.execution.default_step_timeout_seconds);
+            const stepLogPath = path.join(logDirectory, `${Date.now()}-${mode}-${step.name.replaceAll(/[^a-zA-Z0-9_-]/g, '_')}.log`);
+            let attempts = 0;
+            let lastResult = { code: 1, signal: null, stdout: '', stderr: '', timeout: false };
+            const maxAttempts = retryPolicy.transient_max_retries + 1;
+            while (attempts < maxAttempts) {
+                attempts += 1;
+                const result = await runCommand(step.cmd[0], step.cmd.slice(1), {
+                    cwd: step.cwd ? path.join(worktreePath, step.cwd) : worktreePath,
+                    env: { ...env, ...step.env },
+                    timeoutMs: timeoutSeconds * 1000
+                });
+                lastResult = result;
+                const logText = [
+                    `# feature=${featureId} mode=${mode} step=${step.name} attempt=${attempts}`,
+                    `# cmd=${JSON.stringify(step.cmd)}`,
+                    `# exit=${result.code} timeout=${result.timeout}`,
+                    '',
+                    '## stdout',
+                    result.stdout,
+                    '',
+                    '## stderr',
+                    result.stderr
+                ].join('\n');
+                await fs.writeFile(stepLogPath, `${logText}\n`, 'utf8');
+                if (result.timeout || result.code === 0) {
+                    break;
+                }
+                const isTransient = retryPolicy.transient_error_codes.includes(result.code);
+                if (!isTransient) {
+                    break;
+                }
+            }
+            const stepState = {
+                name: step.name,
+                cmd: step.cmd,
+                attempts,
+                exit_code: lastResult.code,
+                timeout: lastResult.timeout,
+                log_path: stepLogPath
+            };
+            stepResults.push(stepState);
+            if (lastResult.timeout || lastResult.code !== 0) {
+                overall = 'fail';
+                break;
+            }
+        }
+        const coverage = await parseCoverage(profile.parsers?.coverage, worktreePath).catch(() => null);
+        const thresholds = this.thresholdPolicy.merge(policy, profile.thresholds);
+        let coverageStatus = 'na';
+        let coverageFailure = null;
+        if (coverage) {
+            if (coverage.line < thresholds.coverage_line_min || coverage.branch < thresholds.coverage_branch_min) {
+                coverageStatus = 'fail';
+                overall = 'fail';
+                coverageFailure = {
+                    line: coverage.line,
+                    branch: coverage.branch,
+                    min_line: thresholds.coverage_line_min,
+                    min_branch: thresholds.coverage_branch_min
+                };
+            }
+            else {
+                coverageStatus = 'pass';
+            }
+        }
+        const evidence = {
+            feature_id: featureId,
+            mode,
+            profile: profileName,
+            overall,
+            coverage_status: coverageStatus,
+            coverage,
+            coverage_failure: coverageFailure,
+            thresholds,
+            step_results: stepResults,
+            finished_at: nowIso()
+        };
+        const evidencePath = path.join(evidenceDirectory, `gate-${mode}-${Date.now()}.json`);
+        await fs.writeFile(evidencePath, `${JSON.stringify(evidence, null, 2)}\n`, 'utf8');
+        const latestPath = path.join(evidenceDirectory, `latest-${mode}.json`);
+        await fs.writeFile(latestPath, `${JSON.stringify(evidence, null, 2)}\n`, 'utf8');
+        return {
+            overall,
+            step_results: stepResults,
+            coverage,
+            coverage_status: coverageStatus,
+            evidence_path: evidencePath,
+            latest_path: latestPath,
+            thresholds
+        };
+    }
+}
+const defaultCoverageParserRegistry = new CoverageParserRegistry([
+    new LcovCoverageParser(),
+    new JunitXmlCoverageParser(),
+    new JacocoXmlCoverageParser(),
+    new CoberturaXmlCoverageParser()
+]);
+const defaultGateExecutionService = new GateExecutionService(new CoverageThresholdPolicy());
+export async function runGateMode({ featureId, mode, profileName, profile, policy, worktreePath, logDirectory, evidenceDirectory }) {
+    return await defaultGateExecutionService.runMode({
+        featureId,
+        mode,
+        profileName,
+        profile,
+        policy,
+        worktreePath,
+        logDirectory,
+        evidenceDirectory
+    });
+}
+//# sourceMappingURL=gates.js.map

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

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

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

@@ -0,0 +1,31 @@
+export interface RunCommandOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    stdin?: string;
+    timeoutMs?: number;
+}
+export interface CommandResult {
+    code: number;
+    signal: NodeJS.Signals | null;
+    stdout: string;
+    stderr: string;
+    timeout: boolean;
+}
+export interface CommandRunner {
+    run(cmd: string, args: string[], options?: RunCommandOptions): Promise<CommandResult>;
+}
+export interface GitClient {
+    runGit(repoRoot: string, args: string[], options?: RunCommandOptions): Promise<CommandResult>;
+}
+export declare class NodeCommandRunner implements CommandRunner {
+    run(cmd: string, args: string[], options?: RunCommandOptions): Promise<CommandResult>;
+}
+export declare class NodeGitClient implements GitClient {
+    private readonly commandRunner;
+    constructor(commandRunner: CommandRunner);
+    runGit(repoRoot: string, args: string[], options?: RunCommandOptions): Promise<CommandResult>;
+}
+export declare const commandRunner: CommandRunner;
+export declare const gitClient: GitClient;
+export declare function runCommand(cmd: string, args: string[], options?: RunCommandOptions): Promise<CommandResult>;
+export declare function runGit(repoRoot: string, args: string[], options?: RunCommandOptions): Promise<CommandResult>;

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

@@ -0,0 +1,79 @@
+import { spawn } from 'node:child_process';
+export class NodeCommandRunner {
+    async run(cmd, args, options = {}) {
+        return await new Promise((resolve) => {
+            let child;
+            let spawnError = null;
+            try {
+                child = spawn(cmd, args, {
+                    cwd: options.cwd,
+                    env: options.env,
+                    stdio: ['pipe', 'pipe', 'pipe']
+                });
+            }
+            catch (err) {
+                spawnError = err;
+                return resolve({
+                    code: 127,
+                    signal: null,
+                    stdout: '',
+                    stderr: spawnError.message,
+                    timeout: false
+                });
+            }
+            let stdout = '';
+            let stderr = '';
+            let killedByTimeout = false;
+            child.stdout.on('data', (chunk) => {
+                stdout += chunk.toString();
+            });
+            child.stderr.on('data', (chunk) => {
+                stderr += chunk.toString();
+            });
+            child.on('error', (err) => {
+                stderr += err.message;
+            });
+            if (options.stdin) {
+                child.stdin.write(options.stdin);
+            }
+            child.stdin.end();
+            let timeoutHandle;
+            if (options.timeoutMs) {
+                timeoutHandle = setTimeout(() => {
+                    killedByTimeout = true;
+                    child.kill('SIGKILL');
+                }, options.timeoutMs);
+            }
+            child.on('close', (code, signal) => {
+                if (timeoutHandle) {
+                    clearTimeout(timeoutHandle);
+                }
+                resolve({
+                    code: code ?? (killedByTimeout ? 124 : 1),
+                    signal,
+                    stdout,
+                    stderr,
+                    timeout: killedByTimeout
+                });
+            });
+        });
+    }
+}
+export class NodeGitClient {
+    commandRunner;
+    constructor(commandRunner) {
+        this.commandRunner = commandRunner;
+    }
+    async runGit(repoRoot, args, options = {}) {
+        return await this.commandRunner.run('git', args, { ...options, cwd: options.cwd ?? repoRoot });
+    }
+}
+export const commandRunner = new NodeCommandRunner();
+export const gitClient = new NodeGitClient(commandRunner);
+export function runCommand(cmd, args, options = {}) {
+    return commandRunner.run(cmd, args, options);
+}
+export async function runGit(repoRoot, args, options = {}) {
+    return await gitClient.runGit(repoRoot, args, options);
+}
+//# sourceMappingURL=git.js.map

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

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