@bluewombat/implementer 0.1.0

package/dist/args/parse-args.js

@@ -0,0 +1,330 @@
+import { existsSync, statSync } from "node:fs";
+import { isAbsolute } from "node:path";
+const IMPLEMENTER_FLAGS = new Set([
+    "--id",
+    "--intention",
+    "--definition-of-done",
+    "--report",
+    "--report-from",
+    "--context",
+    "--stage",
+    "--workspace",
+    "--builder",
+    "--builder-timeout-ms",
+    "--repair-builder",
+    "--repair-builder-timeout-ms",
+    "--gate",
+    "--gate-timeout-ms",
+    "--max-attempts",
+    "--on-status",
+]);
+function isImplementerFlag(token) {
+    return IMPLEMENTER_FLAGS.has(token);
+}
+function takeValue(argv, index) {
+    const value = argv[index + 1];
+    if (value === undefined || value.startsWith("--")) {
+        return null;
+    }
+    return { value, next: index + 2 };
+}
+function takeCommandArgv(argv, start) {
+    if (argv[start] !== "--") {
+        return null;
+    }
+    const command = [];
+    let i = start + 1;
+    while (i < argv.length) {
+        const token = argv[i];
+        if (token !== undefined && isImplementerFlag(token)) {
+            break;
+        }
+        if (token !== undefined) {
+            command.push(token);
+        }
+        i += 1;
+    }
+    if (command.length === 0) {
+        return null;
+    }
+    return { command, next: i };
+}
+function parsePositiveInt(raw) {
+    if (!/^\d+$/.test(raw)) {
+        return null;
+    }
+    const value = Number(raw);
+    if (!Number.isSafeInteger(value) || value < 1) {
+        return null;
+    }
+    return value;
+}
+/**
+ * Parse Implementer CLI argv (without node/script). Malformed input → not ok.
+ */
+export function parseArgs(argv) {
+    let id;
+    let intention;
+    let definitionOfDone;
+    let report;
+    let reportFrom;
+    let context;
+    let stage;
+    let workspace;
+    let builderArgv;
+    let repairArgv;
+    let builderTimeoutMs;
+    let repairTimeoutMs;
+    const gates = [];
+    const seenGateIds = new Set();
+    let maxAttempts;
+    let gateTimeoutMs;
+    let onStatusArgv;
+    let i = 0;
+    while (i < argv.length) {
+        const token = argv[i];
+        if (token === undefined) {
+            break;
+        }
+        if (token === "--id") {
+            const taken = takeValue(argv, i);
+            if (!taken) {
+                return { ok: false, reason: "Missing value for --id." };
+            }
+            id = taken.value;
+            i = taken.next;
+            continue;
+        }
+        if (token === "--intention") {
+            const taken = takeValue(argv, i);
+            if (!taken) {
+                return { ok: false, reason: "Missing value for --intention." };
+            }
+            intention = taken.value;
+            i = taken.next;
+            continue;
+        }
+        if (token === "--definition-of-done") {
+            const taken = takeValue(argv, i);
+            if (!taken) {
+                return { ok: false, reason: "Missing value for --definition-of-done." };
+            }
+            definitionOfDone = taken.value;
+            i = taken.next;
+            continue;
+        }
+        if (token === "--report") {
+            const taken = takeValue(argv, i);
+            if (!taken) {
+                return { ok: false, reason: "Missing value for --report." };
+            }
+            report = taken.value;
+            i = taken.next;
+            continue;
+        }
+        if (token === "--report-from") {
+            const taken = takeValue(argv, i);
+            if (!taken) {
+                return { ok: false, reason: "Missing value for --report-from." };
+            }
+            reportFrom = taken.value;
+            i = taken.next;
+            continue;
+        }
+        if (token === "--stage") {
+            const taken = takeValue(argv, i);
+            if (!taken) {
+                return { ok: false, reason: "Missing value for --stage." };
+            }
+            if (taken.value !== "unit" && taken.value !== "assembly") {
+                return { ok: false, reason: `--stage is unit or assembly, not "${taken.value}".` };
+            }
+            stage = taken.value;
+            i = taken.next;
+            continue;
+        }
+        if (token === "--context") {
+            const taken = takeValue(argv, i);
+            if (!taken) {
+                return { ok: false, reason: "Missing value for --context." };
+            }
+            context = taken.value;
+            i = taken.next;
+            continue;
+        }
+        if (token === "--workspace") {
+            const taken = takeValue(argv, i);
+            if (!taken) {
+                return { ok: false, reason: "Missing value for --workspace." };
+            }
+            workspace = taken.value;
+            i = taken.next;
+            continue;
+        }
+        if (token === "--builder") {
+            const command = takeCommandArgv(argv, i + 1);
+            if (!command) {
+                return { ok: false, reason: "Missing non-empty Builder command after --builder --." };
+            }
+            builderArgv = command.command;
+            i = command.next;
+            continue;
+        }
+        if (token === "--gate") {
+            const idTaken = takeValue(argv, i);
+            if (!idTaken) {
+                return { ok: false, reason: "Missing Gate id after --gate." };
+            }
+            const gateId = idTaken.value;
+            if (seenGateIds.has(gateId)) {
+                return { ok: false, reason: `Duplicate Gate id "${gateId}".` };
+            }
+            const command = takeCommandArgv(argv, idTaken.next);
+            if (!command) {
+                return {
+                    ok: false,
+                    reason: `Missing non-empty Gate command after --gate ${gateId} --.`,
+                };
+            }
+            if (gateTimeoutMs === undefined) {
+                return {
+                    ok: false,
+                    reason: `Gate "${gateId}" has no --gate-timeout-ms. Nothing else would bound it.`,
+                };
+            }
+            seenGateIds.add(gateId);
+            gates.push({ id: gateId, argv: command.command, timeoutMs: gateTimeoutMs });
+            gateTimeoutMs = undefined;
+            i = command.next;
+            continue;
+        }
+        if (token === "--gate-timeout-ms") {
+            const taken = takeValue(argv, i);
+            if (!taken) {
+                return { ok: false, reason: "Missing value for --gate-timeout-ms." };
+            }
+            const value = parsePositiveInt(taken.value);
+            if (value === null) {
+                return { ok: false, reason: "--gate-timeout-ms must be a positive integer." };
+            }
+            // Applies to the next --gate, so one ceiling per Gate is one flag.
+            gateTimeoutMs = value;
+            i = taken.next;
+            continue;
+        }
+        if (token === "--max-attempts") {
+            const taken = takeValue(argv, i);
+            if (!taken) {
+                return { ok: false, reason: "Missing value for --max-attempts." };
+            }
+            const value = parsePositiveInt(taken.value);
+            if (value === null) {
+                return { ok: false, reason: "--max-attempts must be a positive integer." };
+            }
+            maxAttempts = value;
+            i = taken.next;
+            continue;
+        }
+        if (token === "--builder-timeout-ms" || token === "--repair-builder-timeout-ms") {
+            const taken = takeValue(argv, i);
+            if (!taken) {
+                return { ok: false, reason: `Missing value for ${token}.` };
+            }
+            const value = parsePositiveInt(taken.value);
+            if (value === null) {
+                return { ok: false, reason: `${token} must be a positive integer.` };
+            }
+            if (token === "--builder-timeout-ms") {
+                builderTimeoutMs = value;
+            }
+            else {
+                repairTimeoutMs = value;
+            }
+            i = taken.next;
+            continue;
+        }
+        if (token === "--repair-builder") {
+            const command = takeCommandArgv(argv, i + 1);
+            if (!command) {
+                return { ok: false, reason: "Missing non-empty command after --repair-builder --." };
+            }
+            repairArgv = command.command;
+            i = command.next;
+            continue;
+        }
+        if (token === "--on-status") {
+            const command = takeCommandArgv(argv, i + 1);
+            if (!command) {
+                return { ok: false, reason: "Missing non-empty command after --on-status --." };
+            }
+            onStatusArgv = command.command;
+            i = command.next;
+            continue;
+        }
+        return { ok: false, reason: `Unknown argument "${token}".` };
+    }
+    if (id === undefined) {
+        return { ok: false, reason: "Missing required --id." };
+    }
+    if (intention === undefined) {
+        return { ok: false, reason: "Missing required --intention." };
+    }
+    if (definitionOfDone === undefined) {
+        return { ok: false, reason: "Missing required --definition-of-done." };
+    }
+    if (workspace === undefined) {
+        return { ok: false, reason: "Missing required --workspace." };
+    }
+    if (maxAttempts === undefined) {
+        return { ok: false, reason: "Missing required --max-attempts." };
+    }
+    if (builderTimeoutMs === undefined) {
+        return { ok: false, reason: "Missing required --builder-timeout-ms." };
+    }
+    if (repairArgv !== undefined && builderArgv === undefined) {
+        return { ok: false, reason: "--repair-builder needs a --builder to fall back to." };
+    }
+    if (!isAbsolute(workspace)) {
+        return { ok: false, reason: "--workspace must be an absolute path." };
+    }
+    if (!existsSync(workspace)) {
+        return { ok: false, reason: `--workspace does not exist: ${workspace}` };
+    }
+    try {
+        if (!statSync(workspace).isDirectory()) {
+            return { ok: false, reason: `--workspace is not a directory: ${workspace}` };
+        }
+    }
+    catch {
+        return { ok: false, reason: `--workspace is not usable: ${workspace}` };
+    }
+    const invocation = {
+        id,
+        intention,
+        definitionOfDone,
+        workspace,
+        ...(builderArgv === undefined ? {} : { builderArgv }),
+        ...(repairArgv === undefined ? {} : { repairArgv }),
+        gates,
+        maxAttempts,
+        builderTimeoutMs,
+        ...(repairTimeoutMs === undefined ? {} : { repairTimeoutMs }),
+    };
+    if (report !== undefined) {
+        invocation.report = report;
+    }
+    if (reportFrom !== undefined) {
+        invocation.reportFrom = reportFrom;
+    }
+    if (context !== undefined) {
+        invocation.context = context;
+    }
+    if (stage !== undefined) {
+        invocation.stage = stage;
+    }
+    if (onStatusArgv !== undefined) {
+        invocation.onStatusArgv = onStatusArgv;
+    }
+    return { ok: true, invocation };
+}
+//# sourceMappingURL=parse-args.js.map

package/dist/args/parse-args.js.map

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

package/dist/child/parse-child-output.d.ts

@@ -0,0 +1,11 @@
+export type BuilderFailureJson = {
+    outcome: "fail-retryable" | "fail-blocking";
+    report: string;
+};
+export type GateVerdictJson = {
+    verdict: "pass" | "fail-retryable" | "fail-blocking";
+    report: string;
+};
+export declare function parseBuilderFailureJson(stdout: string): BuilderFailureJson | null;
+export declare function parseGateVerdictJson(stdout: string): GateVerdictJson | null;
+//# sourceMappingURL=parse-child-output.d.ts.map

package/dist/child/parse-child-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-child-output.d.ts","sourceRoot":"","sources":["../../src/child/parse-child-output.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,eAAe,CAAC;IACrD,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAwBF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAYjF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAW3E"}

package/dist/child/parse-child-output.js

@@ -0,0 +1,49 @@
+function firstJsonObject(text) {
+    const trimmed = text.trim();
+    if (trimmed.length === 0) {
+        return null;
+    }
+    // Prefer the last non-empty line (children may log before the JSON object).
+    const lines = trimmed.split(/\r?\n/).filter((line) => line.trim().length > 0);
+    const candidate = lines.length > 0 ? lines[lines.length - 1] : trimmed;
+    if (candidate === undefined) {
+        return null;
+    }
+    try {
+        return JSON.parse(candidate);
+    }
+    catch {
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+export function parseBuilderFailureJson(stdout) {
+    const value = firstJsonObject(stdout);
+    if (value === null || typeof value !== "object" || value === null) {
+        return null;
+    }
+    const record = value;
+    const outcome = record.outcome;
+    if (outcome !== "fail-retryable" && outcome !== "fail-blocking") {
+        return null;
+    }
+    const report = typeof record.report === "string" ? record.report : "";
+    return { outcome, report };
+}
+export function parseGateVerdictJson(stdout) {
+    const value = firstJsonObject(stdout);
+    if (value === null || typeof value !== "object") {
+        return null;
+    }
+    const record = value;
+    const verdict = record.verdict;
+    if (verdict !== "pass" && verdict !== "fail-retryable" && verdict !== "fail-blocking") {
+        return null;
+    }
+    return { verdict, report: typeof record.report === "string" ? record.report : "" };
+}
+//# sourceMappingURL=parse-child-output.js.map

package/dist/child/parse-child-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-child-output.js","sourceRoot":"","sources":["../../src/child/parse-child-output.ts"],"names":[],"mappings":"AAUA,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,4EAA4E;IAC5E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9E,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACvE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAY,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAClE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,OAAO,KAAK,gBAAgB,IAAI,OAAO,KAAK,eAAe,EAAE,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,gBAAgB,IAAI,OAAO,KAAK,eAAe,EAAE,CAAC;QACtF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACrF,CAAC"}

package/dist/child/run-builder.d.ts

@@ -0,0 +1,24 @@
+import type { BuilderResult, Invocation } from "../types.js";
+export type BuilderRunResult = {
+    result: BuilderResult;
+    /** Report for the next Builder, if this Attempt fails retryably. */
+    reportForRetry?: string;
+    /** Attempt ended without running Gates. */
+    attemptEnded?: "fail-retryable" | "fail-blocking" | "interrupted";
+};
+export declare function runBuilder(input: {
+    invocation: Invocation;
+    /**
+     * The producer for this pass. Chosen by the loop, not read off the
+     * invocation: which of the two commands runs depends on whether there is
+     * something to resolve, and only the loop knows that.
+     */
+    producerArgv: string[];
+    attempt: number;
+    previousReport: string | undefined;
+    /** Which Gate refused, when one did. Absent when the producer itself failed. */
+    previousRefusedBy: string | undefined;
+    timeoutMs: number;
+    shouldInterrupt: () => boolean;
+}): Promise<BuilderRunResult>;
+//# sourceMappingURL=run-builder.d.ts.map

package/dist/child/run-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-builder.d.ts","sourceRoot":"","sources":["../../src/child/run-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI7D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,aAAa,CAAC;IACtB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,gBAAgB,GAAG,eAAe,GAAG,aAAa,CAAC;CACnE,CAAC;AAEF,wBAAsB,UAAU,CAAC,KAAK,EAAE;IACtC,UAAU,EAAE,UAAU,CAAC;IACvB;;;;OAIG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,gFAAgF;IAChF,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,OAAO,CAAC;CAChC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwC5B"}

package/dist/child/run-builder.js

@@ -0,0 +1,92 @@
+import { parseBuilderFailureJson } from "./parse-child-output.js";
+import { combinedOutput, runChild } from "./run-child.js";
+export async function runBuilder(input) {
+    const { invocation, producerArgv, attempt, previousReport, previousRefusedBy, timeoutMs, shouldInterrupt, } = input;
+    const argv = [
+        ...producerArgv,
+        "--id",
+        invocation.id,
+        "--attempt",
+        String(attempt),
+        "--intention",
+        invocation.intention,
+        "--definition-of-done",
+        invocation.definitionOfDone,
+    ];
+    if (previousReport !== undefined) {
+        argv.push("--report", previousReport);
+    }
+    if (previousRefusedBy !== undefined) {
+        argv.push("--report-from", previousRefusedBy);
+    }
+    if (invocation.context !== undefined) {
+        argv.push("--context", invocation.context);
+    }
+    const outcome = await runChild({
+        argv,
+        cwd: invocation.workspace,
+        timeoutMs,
+        shouldInterrupt,
+    });
+    return interpretBuilderOutcome(outcome, timeoutMs);
+}
+function interpretBuilderOutcome(outcome, timeoutMs) {
+    if (outcome.kind === "spawn_error") {
+        return {
+            result: {
+                kind: "refused",
+                outcome: "fail-blocking",
+                detail: outcome.detail,
+            },
+            reportForRetry: outcome.detail,
+            attemptEnded: "fail-blocking",
+        };
+    }
+    if (outcome.kind === "interrupted") {
+        return {
+            result: { kind: "interrupted", detail: "stop signal" },
+            attemptEnded: "interrupted",
+        };
+    }
+    if (outcome.kind === "timed_out") {
+        const detail = `killed after ${timeoutMs}ms, its own ceiling`;
+        return {
+            result: {
+                kind: "timed_out",
+                outcome: "fail-retryable",
+                detail,
+            },
+            reportForRetry: detail,
+            attemptEnded: "fail-retryable",
+        };
+    }
+    // exited
+    if (outcome.exitCode === 0) {
+        return {
+            result: { kind: "completed" },
+        };
+    }
+    const failure = parseBuilderFailureJson(outcome.stdout);
+    if (failure) {
+        return {
+            result: {
+                kind: "failed",
+                outcome: failure.outcome,
+                detail: failure.report,
+            },
+            reportForRetry: failure.report,
+            attemptEnded: failure.outcome,
+        };
+    }
+    const detail = combinedOutput(outcome.stdout, outcome.stderr) || `exit ${outcome.exitCode}`;
+    return {
+        result: {
+            kind: "failed",
+            outcome: "fail-retryable",
+            detail,
+        },
+        reportForRetry: detail,
+        attemptEnded: "fail-retryable",
+    };
+}
+//# sourceMappingURL=run-builder.js.map

package/dist/child/run-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-builder.js","sourceRoot":"","sources":["../../src/child/run-builder.ts"],"names":[],"mappings":"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"}

package/dist/child/run-child.d.ts

@@ -0,0 +1,36 @@
+export type SpawnRequest = {
+    argv: string[];
+    /** Undefined lets the child inherit the caller's directory. */
+    cwd?: string | undefined;
+    /** Wall-clock budget for this child (ms). */
+    timeoutMs: number;
+    /** When true, treat kill as interrupted (stop signal). */
+    shouldInterrupt: () => boolean;
+    /** Undefined lets the child inherit the caller's environment. */
+    env?: NodeJS.ProcessEnv | undefined;
+};
+export type SpawnOutcome = {
+    kind: "exited";
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    stdout: string;
+    stderr: string;
+} | {
+    kind: "timed_out";
+    stdout: string;
+    stderr: string;
+} | {
+    kind: "interrupted";
+    stdout: string;
+    stderr: string;
+} | {
+    kind: "spawn_error";
+    detail: string;
+};
+/**
+ * Run one child with a wall-clock timeout. Does not inherit Implementer stdin.
+ */
+export declare function runChild(request: SpawnRequest): Promise<SpawnOutcome>;
+/** The fallback report of a child that left no contract line: its last words. */
+export declare function combinedOutput(stdout: string, stderr: string): string;
+//# sourceMappingURL=run-child.d.ts.map

package/dist/child/run-child.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-child.d.ts","sourceRoot":"","sources":["../../src/child/run-child.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAiBN;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAsHrE;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGrE"}