@autopilot-harness/port-runner 0.12.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Autopilot Harness contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli-driver.d.ts

@@ -0,0 +1,11 @@
+import type { RunnerConfig } from "./config.js";
+import type { AgentDriver, DriverResult, DriverRunInput } from "./driver.js";
+/**
+ * Spawn `runner.command` with `{prompt}` / `{prompt_file}` (shell: false).
+ */
+export declare class CliDriver implements AgentDriver {
+    private readonly config;
+    constructor(config: RunnerConfig);
+    run(input: DriverRunInput): Promise<DriverResult>;
+}
+//# sourceMappingURL=cli-driver.d.ts.map

package/dist/cli-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-driver.d.ts","sourceRoot":"","sources":["../src/cli-driver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOhD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7E;;GAEG;AACH,qBAAa,SAAU,YAAW,WAAW;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IAI3C,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;CA2CxD"}

package/dist/cli-driver.js

@@ -0,0 +1,59 @@
+import { spawn } from "node:child_process";
+import { assertRunnerCommand } from "./config.js";
+import { expandCommandTemplate, resolveRunnerCwd, unlinkPromptFile, } from "./command-template.js";
+/**
+ * Spawn `runner.command` with `{prompt}` / `{prompt_file}` (shell: false).
+ */
+export class CliDriver {
+    config;
+    constructor(config) {
+        this.config = config;
+        assertRunnerCommand(config);
+    }
+    async run(input) {
+        let promptFilePath;
+        try {
+            // Fail cwd before writing prompt files (avoid orphan files on bad config).
+            const cwd = resolveRunnerCwd(input.projectRoot, this.config.cwd);
+            const expanded = expandCommandTemplate(this.config, {
+                tip: input.prompt,
+                projectRoot: input.projectRoot,
+                conversationId: input.conversationId,
+                iteration: input.iteration,
+            });
+            promptFilePath = expanded.promptFilePath;
+            const env = {
+                ...process.env,
+                ...this.config.env,
+            };
+            return await new Promise((resolve, reject) => {
+                let settled = false;
+                const child = spawn(expanded.file, expanded.args, {
+                    cwd,
+                    env,
+                    shell: false,
+                    stdio: "inherit",
+                });
+                child.on("error", (err) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    reject(err);
+                });
+                child.on("close", (code, signal) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    resolve({
+                        exitCode: code,
+                        signal: signal ?? null,
+                    });
+                });
+            });
+        }
+        finally {
+            unlinkPromptFile(promptFilePath);
+        }
+    }
+}
+//# sourceMappingURL=cli-driver.js.map

package/dist/cli-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-driver.js","sourceRoot":"","sources":["../src/cli-driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAG/B;;GAEG;AACH,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;QAC/C,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAAqB;QAC7B,IAAI,cAAkC,CAAC;QACvC,IAAI,CAAC;YACH,2EAA2E;YAC3E,MAAM,GAAG,GAAG,gBAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE;gBAClD,GAAG,EAAE,KAAK,CAAC,MAAM;gBACjB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC,CAAC;YACH,cAAc,GAAG,QAAQ,CAAC,cAAc,CAAC;YACzC,MAAM,GAAG,GAAsB;gBAC7B,GAAG,OAAO,CAAC,GAAG;gBACd,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG;aACnB,CAAC;YAEF,OAAO,MAAM,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACzD,IAAI,OAAO,GAAG,KAAK,CAAC;gBACpB,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE;oBAChD,GAAG;oBACH,GAAG;oBACH,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,SAAS;iBACjB,CAAC,CAAC;gBACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;oBACxB,IAAI,OAAO;wBAAE,OAAO;oBACpB,OAAO,GAAG,IAAI,CAAC;oBACf,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC,CAAC,CAAC;gBACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;oBACjC,IAAI,OAAO;wBAAE,OAAO;oBACpB,OAAO,GAAG,IAAI,CAAC;oBACf,OAAO,CAAC;wBACN,QAAQ,EAAE,IAAI;wBACd,MAAM,EAAE,MAAM,IAAI,IAAI;qBACvB,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,gBAAgB,CAAC,cAAc,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;CACF"}

package/dist/command-template.d.ts

@@ -0,0 +1,42 @@
+import type { RunnerConfig, RunnerPromptMode } from "./config.js";
+export type PromptChannel = "argv" | "file";
+export interface ExpandedCommand {
+    file: string;
+    args: string[];
+    /** Set when a prompt file was written for this turn. */
+    promptFilePath?: string;
+    channel: PromptChannel;
+}
+/**
+ * Decide argv vs file channel (research §4 / §10).
+ * Long tips with only `{prompt}` still use argv as one element (shell:false).
+ */
+export declare function resolvePromptChannel(template: string, tip: string, mode: RunnerPromptMode): PromptChannel;
+/**
+ * Fail closed before writing prompt files when the template mixes channels
+ * that cannot both be satisfied for the chosen channel.
+ */
+export declare function assertTemplateMatchesChannel(template: string, channel: PromptChannel): void;
+/**
+ * Split template on whitespace; keep `{prompt}` / `{prompt_file}` atomic.
+ * No shell expansion — caller must spawn with `shell: false`.
+ */
+export declare function tokenizeCommandTemplate(template: string): string[];
+/** Best-effort cleanup after a turn. */
+export declare function unlinkPromptFile(filePath: string | undefined): void;
+/**
+ * Expand `runner.command` into spawn file + args for one tip.
+ */
+export declare function expandCommandTemplate(config: RunnerConfig, opts: {
+    tip: string;
+    projectRoot: string;
+    conversationId: string;
+    iteration: number;
+}): ExpandedCommand;
+/** Resolve cwd under project (or project root). */
+export declare function resolveRunnerCwd(projectRoot: string, cwd: string): string;
+/**
+ * Resolve a session checklist path under the project root (fail closed).
+ */
+export declare function resolveChecklistPathInProject(projectRoot: string, checklistPath: string): string | null;
+//# sourceMappingURL=command-template.d.ts.map

package/dist/command-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-template.d.ts","sourceRoot":"","sources":["../src/command-template.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAOlE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,aAAa,CAAC;CACxB;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,gBAAgB,GACrB,aAAa,CAyBf;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,GACrB,IAAI,CAsBN;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAwBlE;AA8BD,wCAAwC;AACxC,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAOnE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE;IACJ,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB,GACA,eAAe,CA8CjB;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,GACV,MAAM,CAqBR;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,MAAM,GAAG,IAAI,CAaf"}

package/dist/command-template.js

@@ -0,0 +1,219 @@
+import fs from "node:fs";
+import path from "node:path";
+import { isLexicallyInsideProject, isRealpathInsideProject, normalizeProjectRoot, } from "@autopilot-harness/core";
+import { RUNNER_PROMPT_FILE_THRESHOLD } from "./config.js";
+import { runnerConversationFileToken } from "./conversation-id.js";
+const PROMPT_TOKEN = "{prompt}";
+const PROMPT_FILE_TOKEN = "{prompt_file}";
+function templateHas(template, token) {
+    return template.includes(token);
+}
+/**
+ * Decide argv vs file channel (research §4 / §10).
+ * Long tips with only `{prompt}` still use argv as one element (shell:false).
+ */
+export function resolvePromptChannel(template, tip, mode) {
+    const hasFile = templateHas(template, PROMPT_FILE_TOKEN);
+    const hasArgv = templateHas(template, PROMPT_TOKEN);
+    if (mode === "file") {
+        if (!hasFile) {
+            throw new Error("prompt_mode=file requires {prompt_file} in runner.command");
+        }
+        return "file";
+    }
+    if (mode === "argv") {
+        if (!hasArgv) {
+            throw new Error("prompt_mode=argv requires {prompt} in runner.command");
+        }
+        return "argv";
+    }
+    // auto
+    if (hasFile && tip.length > RUNNER_PROMPT_FILE_THRESHOLD)
+        return "file";
+    if (hasFile && !hasArgv)
+        return "file";
+    if (hasArgv)
+        return "argv";
+    if (hasFile)
+        return "file";
+    throw new Error("runner.command must include {prompt} and/or {prompt_file}");
+}
+/**
+ * Fail closed before writing prompt files when the template mixes channels
+ * that cannot both be satisfied for the chosen channel.
+ */
+export function assertTemplateMatchesChannel(template, channel) {
+    const hasFile = templateHas(template, PROMPT_FILE_TOKEN);
+    const hasArgv = templateHas(template, PROMPT_TOKEN);
+    if (channel === "argv") {
+        if (!hasArgv) {
+            throw new Error("argv channel requires {prompt} in runner.command");
+        }
+        if (hasFile) {
+            throw new Error("runner.command has both {prompt} and {prompt_file}; use prompt_mode=file or remove {prompt_file}");
+        }
+        return;
+    }
+    if (!hasFile) {
+        throw new Error("file channel requires {prompt_file} in runner.command");
+    }
+    if (hasArgv) {
+        throw new Error("runner.command has both {prompt} and {prompt_file}; use prompt_mode=argv or remove {prompt}");
+    }
+}
+/**
+ * Split template on whitespace; keep `{prompt}` / `{prompt_file}` atomic.
+ * No shell expansion — caller must spawn with `shell: false`.
+ */
+export function tokenizeCommandTemplate(template) {
+    const trimmed = template.trim();
+    if (!trimmed)
+        return [];
+    const tokens = [];
+    let i = 0;
+    while (i < trimmed.length) {
+        while (i < trimmed.length && /\s/.test(trimmed[i]))
+            i += 1;
+        if (i >= trimmed.length)
+            break;
+        if (trimmed.startsWith(PROMPT_TOKEN, i)) {
+            tokens.push(PROMPT_TOKEN);
+            i += PROMPT_TOKEN.length;
+            continue;
+        }
+        if (trimmed.startsWith(PROMPT_FILE_TOKEN, i)) {
+            tokens.push(PROMPT_FILE_TOKEN);
+            i += PROMPT_FILE_TOKEN.length;
+            continue;
+        }
+        let j = i;
+        while (j < trimmed.length && !/\s/.test(trimmed[j]))
+            j += 1;
+        tokens.push(trimmed.slice(i, j));
+        i = j;
+    }
+    return tokens;
+}
+function writePromptFile(projectRoot, conversationId, iteration, tip) {
+    const root = normalizeProjectRoot(projectRoot);
+    if (!root)
+        throw new Error("Invalid project root for prompt file.");
+    const dir = path.join(root, ".autopilot", "runner-prompts");
+    fs.mkdirSync(dir, { recursive: true });
+    const name = `${runnerConversationFileToken(conversationId)}-${iteration}.txt`;
+    const filePath = path.join(dir, name);
+    // Lexical check before create — realpath fails on missing leaves.
+    if (!isLexicallyInsideProject(root, filePath)) {
+        throw new Error("prompt file path escaped project root");
+    }
+    fs.writeFileSync(filePath, tip, "utf8");
+    if (!isRealpathInsideProject(root, filePath)) {
+        try {
+            fs.unlinkSync(filePath);
+        }
+        catch {
+            /* ignore */
+        }
+        throw new Error("prompt file path escaped project root");
+    }
+    return filePath;
+}
+/** Best-effort cleanup after a turn. */
+export function unlinkPromptFile(filePath) {
+    if (!filePath)
+        return;
+    try {
+        fs.unlinkSync(filePath);
+    }
+    catch {
+        /* ignore */
+    }
+}
+/**
+ * Expand `runner.command` into spawn file + args for one tip.
+ */
+export function expandCommandTemplate(config, opts) {
+    const template = config.command.trim();
+    if (!template) {
+        throw new Error("runner.command is empty");
+    }
+    const channel = resolvePromptChannel(template, opts.tip, config.promptMode);
+    // Validate before writing any prompt file (avoid leaks on mixed templates).
+    assertTemplateMatchesChannel(template, channel);
+    let promptFilePath;
+    try {
+        if (channel === "file") {
+            promptFilePath = writePromptFile(opts.projectRoot, opts.conversationId, opts.iteration, opts.tip);
+        }
+        const tokens = tokenizeCommandTemplate(template);
+        if (tokens.length === 0) {
+            throw new Error("runner.command produced no argv");
+        }
+        const replaced = tokens.map((t) => {
+            if (t === PROMPT_TOKEN)
+                return opts.tip;
+            if (t === PROMPT_FILE_TOKEN) {
+                if (!promptFilePath) {
+                    throw new Error("{prompt_file} expansion missing path");
+                }
+                return promptFilePath;
+            }
+            return t;
+        });
+        const [file, ...args] = replaced;
+        if (!file)
+            throw new Error("runner.command missing executable");
+        return { file, args, promptFilePath, channel };
+    }
+    catch (err) {
+        unlinkPromptFile(promptFilePath);
+        throw err;
+    }
+}
+/** Resolve cwd under project (or project root). */
+export function resolveRunnerCwd(projectRoot, cwd) {
+    const root = normalizeProjectRoot(projectRoot);
+    if (!root)
+        throw new Error("Invalid project root for runner cwd.");
+    const absRoot = fs.realpathSync(root);
+    if (!cwd.trim())
+        return absRoot;
+    const abs = path.resolve(absRoot, cwd.trim());
+    // Lexical first so a missing path is not misreported as an escape.
+    if (!isLexicallyInsideProject(absRoot, abs)) {
+        throw new Error("runner.cwd must stay inside the project root");
+    }
+    if (!fs.existsSync(abs)) {
+        throw new Error(`runner.cwd does not exist: ${cwd.trim()}`);
+    }
+    if (!isRealpathInsideProject(absRoot, abs)) {
+        throw new Error("runner.cwd must stay inside the project root");
+    }
+    const real = fs.realpathSync(abs);
+    if (!fs.statSync(real).isDirectory()) {
+        throw new Error(`runner.cwd must be a directory: ${cwd.trim()}`);
+    }
+    return real;
+}
+/**
+ * Resolve a session checklist path under the project root (fail closed).
+ */
+export function resolveChecklistPathInProject(projectRoot, checklistPath) {
+    const root = normalizeProjectRoot(projectRoot);
+    if (!root || !checklistPath.trim())
+        return null;
+    const abs = path.isAbsolute(checklistPath)
+        ? checklistPath
+        : path.join(root, checklistPath);
+    try {
+        if (!fs.existsSync(abs))
+            return null;
+        if (!isRealpathInsideProject(root, abs))
+            return null;
+        return fs.realpathSync(abs);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=command-template.js.map

package/dist/command-template.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,46 @@
+/** Autopilot session / Stop platform id for the external runner. */
+export declare const RUNNER_PLATFORM = "runner";
+/** Default iteration budget (covers fix + confirm×5 headroom). */
+export declare const RUNNER_DEFAULT_MAX_ITERATIONS = 32;
+/** Soft lower bound for doctor WARN (below this, confirm×5 is risky). */
+export declare const RUNNER_MIN_RECOMMENDED_ITERATIONS = 8;
+/** Clamp range for max_iterations. */
+export declare const RUNNER_MAX_ITERATIONS_CLAMP: {
+    readonly min: 1;
+    readonly max: 500;
+};
+/** Tip length above which `auto` prefers `{prompt_file}` when the template allows it. */
+export declare const RUNNER_PROMPT_FILE_THRESHOLD = 4000;
+export type RunnerPromptMode = "argv" | "file" | "auto";
+/**
+ * Runner block under `.autopilot/config.yml` (normalized).
+ * `command` empty/omitted → CliDriver start must FAIL.
+ */
+export interface RunnerConfig {
+    /** Agent CLI template with `{prompt}` and/or `{prompt_file}`. */
+    command: string;
+    maxIterations: number;
+    /** Absolute cwd; empty → project root. */
+    cwd: string;
+    env: Readonly<Record<string, string>>;
+    promptMode: RunnerPromptMode;
+}
+export interface RunnerConfigInput {
+    command?: unknown;
+    max_iterations?: unknown;
+    maxIterations?: unknown;
+    cwd?: unknown;
+    env?: unknown;
+    prompt_mode?: unknown;
+    promptMode?: unknown;
+}
+/** Normalize untrusted YAML/flag input into a RunnerConfig. */
+export declare function normalizeRunnerConfig(input?: RunnerConfigInput | null): RunnerConfig;
+/** True when CliDriver has a usable command template. */
+export declare function hasRunnerCommand(config: RunnerConfig): boolean;
+/**
+ * Refuse start when command is missing (CliDriver path).
+ * MockDriver tests pass an explicit driver and skip this.
+ */
+export declare function assertRunnerCommand(config: RunnerConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC,kEAAkE;AAClE,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,yEAAyE;AACzE,eAAO,MAAM,iCAAiC,IAAI,CAAC;AAEnD,sCAAsC;AACtC,eAAO,MAAM,2BAA2B;;;CAAgC,CAAC;AAEzE,yFAAyF;AACzF,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtC,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA0BD,+DAA+D;AAC/D,wBAAgB,qBAAqB,CAAC,KAAK,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAAG,YAAY,CAkBpF;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE9D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAO9D"}

package/dist/config.js

@@ -0,0 +1,69 @@
+/** Autopilot session / Stop platform id for the external runner. */
+export const RUNNER_PLATFORM = "runner";
+/** Default iteration budget (covers fix + confirm×5 headroom). */
+export const RUNNER_DEFAULT_MAX_ITERATIONS = 32;
+/** Soft lower bound for doctor WARN (below this, confirm×5 is risky). */
+export const RUNNER_MIN_RECOMMENDED_ITERATIONS = 8;
+/** Clamp range for max_iterations. */
+export const RUNNER_MAX_ITERATIONS_CLAMP = { min: 1, max: 500 };
+/** Tip length above which `auto` prefers `{prompt_file}` when the template allows it. */
+export const RUNNER_PROMPT_FILE_THRESHOLD = 4000;
+function clampIterations(n) {
+    const { min, max } = RUNNER_MAX_ITERATIONS_CLAMP;
+    if (!Number.isFinite(n) || !Number.isInteger(n)) {
+        return RUNNER_DEFAULT_MAX_ITERATIONS;
+    }
+    return Math.min(max, Math.max(min, n));
+}
+function asStringMap(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(raw)) {
+        if (typeof k !== "string" || !k.trim())
+            continue;
+        if (typeof v === "string")
+            out[k] = v;
+        else if (typeof v === "number" || typeof v === "boolean")
+            out[k] = String(v);
+    }
+    return out;
+}
+function parsePromptMode(raw) {
+    if (raw === "argv" || raw === "file" || raw === "auto")
+        return raw;
+    return "auto";
+}
+/** Normalize untrusted YAML/flag input into a RunnerConfig. */
+export function normalizeRunnerConfig(input) {
+    const command = typeof input?.command === "string" ? input.command.trim() : "";
+    const maxRaw = input?.max_iterations ?? input?.maxIterations;
+    const maxIterations = typeof maxRaw === "number"
+        ? clampIterations(maxRaw)
+        : typeof maxRaw === "string" && maxRaw.trim()
+            ? clampIterations(Number(maxRaw.trim()))
+            : RUNNER_DEFAULT_MAX_ITERATIONS;
+    const cwd = typeof input?.cwd === "string" ? input.cwd.trim() : "";
+    return {
+        command,
+        maxIterations,
+        cwd,
+        env: asStringMap(input?.env),
+        promptMode: parsePromptMode(input?.prompt_mode ?? input?.promptMode),
+    };
+}
+/** True when CliDriver has a usable command template. */
+export function hasRunnerCommand(config) {
+    return Boolean(config.command.trim());
+}
+/**
+ * Refuse start when command is missing (CliDriver path).
+ * MockDriver tests pass an explicit driver and skip this.
+ */
+export function assertRunnerCommand(config) {
+    if (!hasRunnerCommand(config)) {
+        throw new Error("runner.command is required (set it in .autopilot/config.yml or --command). " +
+            "Init does not write a fake default command.");
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC;AAExC,kEAAkE;AAClE,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAEhD,yEAAyE;AACzE,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC;AAEnD,sCAAsC;AACtC,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAW,CAAC;AAEzE,yFAAyF;AACzF,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AA4BjD,SAAS,eAAe,CAAC,CAAS;IAChC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,2BAA2B,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,OAAO,6BAA6B,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,WAAW,CAAC,GAAY;IAC/B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACrE,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,EAAE,CAAC;QACpE,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;YAAE,SAAS;QACjD,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;aACjC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,eAAe,CAAC,GAAY;IACnC,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,GAAG,CAAC;IACnE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,qBAAqB,CAAC,KAAgC;IACpE,MAAM,OAAO,GACX,OAAO,KAAK,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,MAAM,MAAM,GAAG,KAAK,EAAE,cAAc,IAAI,KAAK,EAAE,aAAa,CAAC;IAC7D,MAAM,aAAa,GACjB,OAAO,MAAM,KAAK,QAAQ;QACxB,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC;QACzB,CAAC,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE;YAC3C,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACxC,CAAC,CAAC,6BAA6B,CAAC;IACtC,MAAM,GAAG,GAAG,OAAO,KAAK,EAAE,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,OAAO;QACL,OAAO;QACP,aAAa;QACb,GAAG;QACH,GAAG,EAAE,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC;QAC5B,UAAU,EAAE,eAAe,CAAC,KAAK,EAAE,WAAW,IAAI,KAAK,EAAE,UAAU,CAAC;KACrE,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACnD,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,6EAA6E;YAC3E,6CAA6C,CAChD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/conversation-id.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Stable conversation id for the project-scoped runner executor.
+ * `runner:` + first 16 hex of sha256(realpath(projectRoot)).
+ */
+export declare function stableRunnerConversationId(projectRoot: string): string;
+/** Hash fragment for prompt filenames (not the full conversation id). */
+export declare function runnerConversationFileToken(conversationId: string): string;
+//# sourceMappingURL=conversation-id.d.ts.map

package/dist/conversation-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-id.d.ts","sourceRoot":"","sources":["../src/conversation-id.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAatE;AAED,yEAAyE;AACzE,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAK1E"}

package/dist/conversation-id.js

@@ -0,0 +1,30 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import { normalizeProjectRoot } from "@autopilot-harness/core";
+/**
+ * Stable conversation id for the project-scoped runner executor.
+ * `runner:` + first 16 hex of sha256(realpath(projectRoot)).
+ */
+export function stableRunnerConversationId(projectRoot) {
+    const root = normalizeProjectRoot(projectRoot);
+    if (!root) {
+        throw new Error("Invalid project root for runner conversation id.");
+    }
+    let real;
+    try {
+        real = fs.realpathSync(root);
+    }
+    catch {
+        real = root;
+    }
+    const hex = createHash("sha256").update(real, "utf8").digest("hex").slice(0, 16);
+    return `runner:${hex}`;
+}
+/** Hash fragment for prompt filenames (not the full conversation id). */
+export function runnerConversationFileToken(conversationId) {
+    return createHash("sha256")
+        .update(conversationId, "utf8")
+        .digest("hex")
+        .slice(0, 16);
+}
+//# sourceMappingURL=conversation-id.js.map

package/dist/conversation-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-id.js","sourceRoot":"","sources":["../src/conversation-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,WAAmB;IAC5D,MAAM,IAAI,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjF,OAAO,UAAU,GAAG,EAAE,CAAC;AACzB,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,2BAA2B,CAAC,cAAsB;IAChE,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC;SAC9B,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/driver.d.ts

@@ -0,0 +1,19 @@
+/** Result of one agent turn (CLI spawn or mock). */
+export interface DriverResult {
+    /** Process exit code; null if killed by signal only. */
+    exitCode: number | null;
+    signal?: NodeJS.Signals | null;
+}
+export interface DriverRunInput {
+    prompt: string;
+    iteration: number;
+    conversationId: string;
+    projectRoot: string;
+}
+/** Pluggable agent backend for the Runner loop. */
+export interface AgentDriver {
+    run(input: DriverRunInput): Promise<DriverResult>;
+}
+/** Map spawn/mock outcome to ReviewEngine Stop status (research §7). */
+export declare function driverResultToStopStatus(result: DriverResult): "completed" | "error" | "aborted";
+//# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACnD;AAED,wEAAwE;AACxE,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,GACnB,WAAW,GAAG,OAAO,GAAG,SAAS,CAKnC"}

package/dist/driver.js

@@ -0,0 +1,10 @@
+/** Map spawn/mock outcome to ReviewEngine Stop status (research §7). */
+export function driverResultToStopStatus(result) {
+    const sig = result.signal;
+    if (sig === "SIGINT" || sig === "SIGTERM")
+        return "aborted";
+    if (result.exitCode === 0)
+        return "completed";
+    return "error";
+}
+//# sourceMappingURL=driver.js.map

package/dist/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAmBA,wEAAwE;AACxE,MAAM,UAAU,wBAAwB,CACtC,MAAoB;IAEpB,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1B,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5D,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IAC9C,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/first-turn-prompt.d.ts

@@ -0,0 +1,11 @@
+import type { ChecklistItem } from "@autopilot-harness/core";
+/** Condensed executing workflow (English stock; followups use ReviewEngine locale). */
+export declare const RUNNER_EXECUTING_SUMMARY = "Implement only the current unchecked checklist item (align with plan.md).\nWhen required, write .autopilot/verify-last.json with matching itemId (and ok: true for hand-written reports).\nEnd the turn by exiting the agent process so the Runner can inject the next fix/confirm/advance tip.\nDo not invent Advance/Done; do not commit/push unless an Advance/Done tip explicitly asks for a local commit.\nFollow only the next Runner-injected message for review lenses.";
+/**
+ * First-turn prompt after `--run` when there is no pending followup.
+ */
+export declare function buildFirstTurnPrompt(opts: {
+    slug: string;
+    item: ChecklistItem;
+}): string;
+//# sourceMappingURL=first-turn-prompt.d.ts.map

package/dist/first-turn-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-turn-prompt.d.ts","sourceRoot":"","sources":["../src/first-turn-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,uFAAuF;AACvF,eAAO,MAAM,wBAAwB,odAI2B,CAAC;AAEjE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC;CACrB,GAAG,MAAM,CAaT"}

package/dist/first-turn-prompt.js

@@ -0,0 +1,24 @@
+/** Condensed executing workflow (English stock; followups use ReviewEngine locale). */
+export const RUNNER_EXECUTING_SUMMARY = `Implement only the current unchecked checklist item (align with plan.md).
+When required, write .autopilot/verify-last.json with matching itemId (and ok: true for hand-written reports).
+End the turn by exiting the agent process so the Runner can inject the next fix/confirm/advance tip.
+Do not invent Advance/Done; do not commit/push unless an Advance/Done tip explicitly asks for a local commit.
+Follow only the next Runner-injected message for review lenses.`;
+/**
+ * First-turn prompt after `--run` when there is no pending followup.
+ */
+export function buildFirstTurnPrompt(opts) {
+    const title = opts.item.title?.trim() || opts.item.id;
+    return [
+        "[Autopilot Runner — executing]",
+        "",
+        `Track: ${opts.slug}`,
+        `Current item: ${opts.item.id} — ${title}`,
+        "",
+        RUNNER_EXECUTING_SUMMARY,
+        "",
+        "Rules: implement only this item; write verify-last.json when required; end the turn",
+        "(exit the agent process). Do not invent Advance/Done — wait for the next Runner inject.",
+    ].join("\n");
+}
+//# sourceMappingURL=first-turn-prompt.js.map

package/dist/first-turn-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-turn-prompt.js","sourceRoot":"","sources":["../src/first-turn-prompt.ts"],"names":[],"mappings":"AAEA,uFAAuF;AACvF,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;gEAIwB,CAAC;AAEjE;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAGpC;IACC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACtD,OAAO;QACL,gCAAgC;QAChC,EAAE;QACF,UAAU,IAAI,CAAC,IAAI,EAAE;QACrB,iBAAiB,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,EAAE;QAC1C,EAAE;QACF,wBAAwB;QACxB,EAAE;QACF,qFAAqF;QACrF,yFAAyF;KAC1F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}