phantom-pr 0.1.0

package/dist/core/process/exec.d.ts

@@ -0,0 +1,22 @@
+export type ExecResult = {
+    cmd: string;
+    args: string[];
+    cwd: string;
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+};
+export declare class ExecError extends Error {
+    readonly result: ExecResult;
+    constructor(message: string, result: ExecResult);
+}
+export declare function exec(cmd: string, args: string[], opts?: {
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    timeoutMs?: number;
+}): Promise<ExecResult>;
+export declare function execOrThrow(cmd: string, args: string[], opts?: {
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    timeoutMs?: number;
+}): Promise<ExecResult>;

package/dist/core/process/exec.js

@@ -0,0 +1,83 @@
+import { spawn } from 'node:child_process';
+export class ExecError extends Error {
+    result;
+    constructor(message, result) {
+        super(message);
+        this.name = 'ExecError';
+        this.result = result;
+    }
+}
+export async function exec(cmd, args, opts = { cwd: process.cwd() }) {
+    const cwd = opts.cwd;
+    const child = spawn(cmd, args, {
+        cwd,
+        env: opts.env ?? process.env,
+        shell: false,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        windowsHide: true,
+    });
+    // NOTE: Do not `unref()` this child process. If we unref the only active handles,
+    // Node's test runner can treat the event loop as idle and cancel pending tests.
+    // Do NOT unref stdout/stderr: keep the event loop alive until we settle and clean up.
+    let stdout = '';
+    let stderr = '';
+    child.stdout?.setEncoding('utf8');
+    child.stderr?.setEncoding('utf8');
+    const onStdout = (c) => (stdout += c);
+    const onStderr = (c) => (stderr += c);
+    child.stdout?.on('data', onStdout);
+    child.stderr?.on('data', onStderr);
+    return await new Promise((resolve) => {
+        let settled = false;
+        let timeoutTimer = null;
+        const cleanup = (onExit, onClose, onError) => {
+            if (timeoutTimer)
+                clearTimeout(timeoutTimer);
+            child.off('exit', onExit);
+            child.off('close', onClose);
+            child.off('error', onError);
+            child.stdout?.off?.('data', onStdout);
+            child.stderr?.off?.('data', onStderr);
+            try {
+                child.stdout?.destroy?.();
+            }
+            catch { }
+            try {
+                child.stderr?.destroy?.();
+            }
+            catch { }
+        };
+        const settleOnce = (exitCode, onExit, onClose, onError) => {
+            if (settled)
+                return;
+            settled = true;
+            cleanup(onExit, onClose, onError);
+            resolve({ cmd, args, cwd, exitCode, stdout, stderr });
+        };
+        const onExit = (code) => settleOnce(code, onExit, onClose, onError);
+        const onClose = (code) => settleOnce(code, onExit, onClose, onError);
+        const onError = () => settleOnce(null, onExit, onClose, onError);
+        child.once('exit', onExit);
+        child.once('close', onClose);
+        child.once('error', onError);
+        if (opts.timeoutMs != null) {
+            timeoutTimer = setTimeout(() => {
+                try {
+                    child.kill();
+                }
+                catch { }
+                // Settle immediately for determinism.
+                settleOnce(null, onExit, onClose, onError);
+            }, Math.max(1, opts.timeoutMs));
+            timeoutTimer.unref();
+        }
+    });
+}
+export async function execOrThrow(cmd, args, opts = { cwd: process.cwd() }) {
+    const r = await exec(cmd, args, opts);
+    if (r.exitCode !== 0) {
+        throw new ExecError(`Command failed: ${cmd} ${args.join(' ')}`, r);
+    }
+    return r;
+}
+//# sourceMappingURL=exec.js.map

package/dist/core/process/exec.js.map

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

package/dist/core/redact.d.ts

@@ -0,0 +1,6 @@
+export declare function redactText(input: string): string;
+export declare function truncateLine(line: string, maxLen: number): string;
+export declare function truncateText(input: string, opts: {
+    maxLineLen: number;
+    maxLines: number;
+}): string;

package/dist/core/redact.js

@@ -0,0 +1,49 @@
+const RULES = [
+    // Generic key/value secrets (common in logs): token=..., password: ..., apiKey "...", etc.
+    {
+        name: 'kv-secrets',
+        pattern: /\b(token|access[_-]?token|refresh[_-]?token|password|passphrase|secret|api[_-]?key|private[_-]?key)\b\s*[:=]\s*([^\s'"]+|"(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*')/gi,
+        replacement: '$1=<redacted>',
+    },
+    // GitHub tokens
+    { name: 'ghp', pattern: /\bghp_[A-Za-z0-9]{20,}\b/g, replacement: 'ghp_<redacted>' },
+    {
+        name: 'github-pat',
+        pattern: /\bgithub_pat_[A-Za-z0-9_]{20,}\b/g,
+        replacement: 'github_pat_<redacted>',
+    },
+    // Slack tokens
+    { name: 'slack', pattern: /\bxox[baprs]-[A-Za-z0-9-]{10,}\b/g, replacement: 'xox<redacted>' },
+    // AWS access key id (best-effort; does not catch secret access key)
+    { name: 'aws-akid', pattern: /\bAKIA[0-9A-Z]{16}\b/g, replacement: 'AKIA<redacted>' },
+    // Private key blocks
+    {
+        name: 'pem',
+        pattern: /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g,
+        replacement: '-----BEGIN PRIVATE KEY-----<redacted>-----END PRIVATE KEY-----',
+    },
+];
+export function redactText(input) {
+    let out = input;
+    for (const rule of RULES) {
+        out = out.replace(rule.pattern, rule.replacement);
+    }
+    return out;
+}
+export function truncateLine(line, maxLen) {
+    if (maxLen <= 0)
+        return '';
+    if (line.length <= maxLen)
+        return line;
+    return `${line.slice(0, Math.max(0, maxLen - 14))}…[truncated]`;
+}
+export function truncateText(input, opts) {
+    const maxLines = Math.max(1, opts.maxLines);
+    const maxLineLen = Math.max(1, opts.maxLineLen);
+    const lines = input.split('\n');
+    const sliced = lines.slice(0, maxLines).map((l) => truncateLine(l, maxLineLen));
+    if (lines.length > maxLines)
+        sliced.push('…[truncated lines]');
+    return sliced.join('\n');
+}
+//# sourceMappingURL=redact.js.map

package/dist/core/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/core/redact.ts"],"names":[],"mappings":"AAEA,MAAM,KAAK,GAAiB;IAC1B,2FAA2F;IAC3F;QACE,IAAI,EAAE,YAAY;QAClB,OAAO,EACL,iKAAiK;QACnK,WAAW,EAAE,eAAe;KAC7B;IACD,gBAAgB;IAChB,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,2BAA2B,EAAE,WAAW,EAAE,gBAAgB,EAAE;IACpF;QACE,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,mCAAmC;QAC5C,WAAW,EAAE,uBAAuB;KACrC;IACD,eAAe;IACf,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,mCAAmC,EAAE,WAAW,EAAE,eAAe,EAAE;IAC7F,oEAAoE;IACpE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,gBAAgB,EAAE;IACrF,qBAAqB;IACrB;QACE,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,6EAA6E;QACtF,WAAW,EAAE,gEAAgE;KAC9E;CACF,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,MAAc;IACvD,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3B,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC,cAAc,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,IAA8C;IACxF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAEhD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IAChF,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ;QAAE,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC/D,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/core/repo/boundary.d.ts

@@ -0,0 +1,10 @@
+export type BoundaryKind = 'js' | 'py' | 'unknown';
+export type RepoBoundary = {
+    packageRootAbs: string;
+    kind: BoundaryKind;
+    boundaryFileRel: string | null;
+};
+export declare function findNearestRepoBoundary(opts: {
+    rootAbs: string;
+    targetPathOrDirAbs: string;
+}): RepoBoundary;

package/dist/core/repo/boundary.js

@@ -0,0 +1,58 @@
+import fs from 'node:fs';
+import path from 'node:path';
+function toPosix(p) {
+    return p.replace(/\\/g, '/');
+}
+function existsFile(dirAbs, name) {
+    const p = path.join(dirAbs, name);
+    try {
+        return fs.existsSync(p) && fs.statSync(p).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+const MARKERS = [
+    { name: 'package.json', kind: 'js' },
+    { name: 'pyproject.toml', kind: 'py' },
+    { name: 'pytest.ini', kind: 'py' },
+    { name: 'setup.cfg', kind: 'py' },
+];
+export function findNearestRepoBoundary(opts) {
+    const rootAbs = path.resolve(opts.rootAbs);
+    const startAbs = path.resolve(opts.targetPathOrDirAbs);
+    const startDirAbs = (() => {
+        try {
+            return fs.statSync(startAbs).isDirectory() ? startAbs : path.dirname(startAbs);
+        }
+        catch {
+            // If the path doesn't exist, assume it's a file path when it has an extension, otherwise a directory path.
+            return path.extname(startAbs) ? path.dirname(startAbs) : startAbs;
+        }
+    })();
+    let current = startDirAbs;
+    while (true) {
+        for (const m of MARKERS) {
+            if (!existsFile(current, m.name))
+                continue;
+            const boundaryFileAbs = path.join(current, m.name);
+            return {
+                packageRootAbs: current,
+                kind: m.kind,
+                boundaryFileRel: toPosix(path.relative(rootAbs, boundaryFileAbs)),
+            };
+        }
+        const parent = path.dirname(current);
+        if (current === rootAbs)
+            break;
+        if (parent === current)
+            break;
+        // Stop walking once we leave the repo root.
+        const rel = path.relative(rootAbs, parent);
+        if (rel.startsWith('..') || path.isAbsolute(rel))
+            break;
+        current = parent;
+    }
+    return { packageRootAbs: rootAbs, kind: 'unknown', boundaryFileRel: null };
+}
+//# sourceMappingURL=boundary.js.map

package/dist/core/repo/boundary.js.map

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

package/dist/core/stableJson.d.ts

@@ -0,0 +1 @@
+export declare function stableStringify(value: unknown): string;

package/dist/core/stableJson.js

@@ -0,0 +1,32 @@
+function isPlainObject(value) {
+    if (value == null || typeof value !== 'object')
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+function toStableJson(value) {
+    if (value == null)
+        return null;
+    if (typeof value === 'string' || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : null;
+    if (Array.isArray(value))
+        return value.map((v) => toStableJson(v));
+    if (isPlainObject(value)) {
+        const out = {};
+        const keys = Object.keys(value).sort((a, b) => a.localeCompare(b));
+        for (const key of keys) {
+            const v = value[key];
+            // Preserve explicit nulls; convert undefined to null for stable reporting.
+            out[key] = v === undefined ? null : toStableJson(v);
+        }
+        return out;
+    }
+    // Non-JSON values are not expected in config; stringify as a safe fallback.
+    return String(value);
+}
+export function stableStringify(value) {
+    return JSON.stringify(toStableJson(value), null, 2);
+}
+//# sourceMappingURL=stableJson.js.map

package/dist/core/stableJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stableJson.js","sourceRoot":"","sources":["../../src/core/stableJson.ts"],"names":[],"mappings":"AAQA,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AACtD,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC1E,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAE5E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnE,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,GAAG,GAAyB,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;YAClD,2EAA2E;YAC3E,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,4EAA4E;IAC5E,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/core/state/policy.d.ts

@@ -0,0 +1,20 @@
+export type PolicyFile = {
+    schemaVersion: 1;
+    workingTestCommand: string | null;
+    allowTestabilityEdits: boolean;
+    denyTestabilityPaths: string[];
+    notes: string[];
+};
+export declare function initPolicy(): PolicyFile;
+export declare function loadOrInitPolicy(opts?: {
+    root?: string;
+}): {
+    path: string;
+    policy: PolicyFile;
+};
+export declare function savePolicy(opts: {
+    root?: string;
+    policy: PolicyFile;
+}): {
+    path: string;
+};

package/dist/core/state/policy.js

@@ -0,0 +1,51 @@
+import path from 'node:path';
+import { getAgentPaths, readJsonIfExists, writeStableJson } from './storage.js';
+function isPlainObject(value) {
+    if (value == null || typeof value !== 'object')
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+export function initPolicy() {
+    return {
+        schemaVersion: 1,
+        workingTestCommand: null,
+        // Default allow; policy can deny specific path prefixes after observing PR outcomes.
+        allowTestabilityEdits: true,
+        denyTestabilityPaths: [],
+        notes: [],
+    };
+}
+function coercePolicyFile(value) {
+    if (!isPlainObject(value))
+        return initPolicy();
+    if (value.schemaVersion !== 1)
+        return initPolicy();
+    const workingTestCommand = typeof value.workingTestCommand === 'string' ? value.workingTestCommand : null;
+    const allowTestabilityEdits = typeof value.allowTestabilityEdits === 'boolean' ? value.allowTestabilityEdits : true;
+    const denyTestabilityPaths = Array.isArray(value.denyTestabilityPaths)
+        ? value.denyTestabilityPaths.filter((p) => typeof p === 'string' && p.trim() !== '')
+        : [];
+    const notes = Array.isArray(value.notes) ? value.notes.filter((n) => typeof n === 'string') : [];
+    return { schemaVersion: 1, workingTestCommand, allowTestabilityEdits, denyTestabilityPaths, notes };
+}
+export function loadOrInitPolicy(opts) {
+    const root = path.resolve(process.cwd(), opts?.root ?? '.');
+    const { policyPath } = getAgentPaths(root);
+    const existing = readJsonIfExists(policyPath);
+    if (existing == null) {
+        const policy = initPolicy();
+        writeStableJson(policyPath, policy);
+        return { path: policyPath, policy };
+    }
+    const policy = coercePolicyFile(existing);
+    return { path: policyPath, policy };
+}
+export function savePolicy(opts) {
+    const root = path.resolve(process.cwd(), opts.root ?? '.');
+    const { policyPath } = getAgentPaths(root);
+    const policy = { ...opts.policy, schemaVersion: 1 };
+    writeStableJson(policyPath, policy);
+    return { path: policyPath };
+}
+//# sourceMappingURL=policy.js.map

package/dist/core/state/policy.js.map

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

package/dist/core/state/state.d.ts

@@ -0,0 +1,67 @@
+export type TargetStatus = 'none' | 'open' | 'merged' | 'closed';
+export type TargetRun = {
+    atMs: number;
+    outcome: 'pass' | 'fail' | 'skipped';
+    notes?: string;
+};
+export type TargetState = {
+    id: string;
+    status: TargetStatus;
+    lastPr?: {
+        url: string;
+        id?: string;
+    };
+    prOpenedAtMs?: number;
+    stale?: boolean;
+    closedReason?: 'staleHours' | string;
+    runs: TargetRun[];
+    createdAtMs: number;
+    updatedAtMs: number;
+};
+export type CompanionStatus = 'none' | 'open' | 'merged' | 'closed';
+export type CompanionRun = {
+    atMs: number;
+    outcome: 'pass' | 'fail' | 'skipped';
+    notes?: string;
+};
+export type CompanionTargetState = {
+    key: string;
+    parentPrNumber: number;
+    parentHeadSha: string;
+    targetId: string;
+    status: CompanionStatus;
+    lastPr?: {
+        url: string;
+        id?: string;
+    };
+    runs: CompanionRun[];
+    createdAtMs: number;
+    updatedAtMs: number;
+};
+export type StateFile = {
+    schemaVersion: 2;
+    updatedAtMs: number;
+    scheduledTargets: Record<string, TargetState>;
+    companionTargets: Record<string, CompanionTargetState>;
+};
+export declare function makeCompanionKey(opts: {
+    parentPrNumber: number;
+    parentHeadSha: string;
+    targetId: string;
+}): string;
+export declare function hasCompanionWork(state: StateFile, key: string): boolean;
+export declare function initState(nowMs: number): StateFile;
+export declare function loadOrInitState(opts?: {
+    root?: string;
+    nowMs?: number;
+}): {
+    path: string;
+    state: StateFile;
+};
+export declare function saveState(opts: {
+    root?: string;
+    nowMs?: number;
+    state: StateFile;
+}): {
+    path: string;
+};

package/dist/core/state/state.js

@@ -0,0 +1,142 @@
+import path from 'node:path';
+import { getAgentPaths, readJsonIfExists, writeStableJson } from './storage.js';
+function isPlainObject(value) {
+    if (value == null || typeof value !== 'object')
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+function coerceScheduledTargets(value, nowMs) {
+    const targets = {};
+    if (!isPlainObject(value))
+        return targets;
+    for (const [k, v] of Object.entries(value)) {
+        if (!isPlainObject(v))
+            continue;
+        const id = typeof v.id === 'string' ? v.id : k;
+        const status = v.status === 'none' || v.status === 'open' || v.status === 'merged' || v.status === 'closed'
+            ? v.status
+            : 'none';
+        const createdAtMs = typeof v.createdAtMs === 'number' ? Math.trunc(v.createdAtMs) : nowMs;
+        const updatedAtMs = typeof v.updatedAtMs === 'number' ? Math.trunc(v.updatedAtMs) : createdAtMs;
+        const prOpenedAtMs = typeof v.prOpenedAtMs === 'number' ? Math.trunc(v.prOpenedAtMs) : undefined;
+        const lastPrRaw = v.lastPr;
+        const lastPr = isPlainObject(lastPrRaw) && typeof lastPrRaw.url === 'string'
+            ? (() => {
+                const url = String(lastPrRaw.url);
+                if (lastPrRaw.id === undefined)
+                    return { url };
+                return { url, id: String(lastPrRaw.id) };
+            })()
+            : undefined;
+        const stale = typeof v.stale === 'boolean' ? v.stale : undefined;
+        const closedReason = typeof v.closedReason === 'string' ? v.closedReason : undefined;
+        const runs = Array.isArray(v.runs)
+            ? v.runs
+                .filter((r) => isPlainObject(r))
+                .map((r) => {
+                const base = {
+                    atMs: typeof r.atMs === 'number' ? Math.trunc(r.atMs) : createdAtMs,
+                    outcome: r.outcome === 'pass' || r.outcome === 'fail' || r.outcome === 'skipped' ? r.outcome : 'fail',
+                };
+                const notes = typeof r.notes === 'string' ? r.notes : undefined;
+                return notes === undefined ? base : { ...base, notes };
+            })
+            : [];
+        const base = { id, status, runs, createdAtMs, updatedAtMs };
+        const withPr = lastPr ? { ...base, lastPr } : base;
+        const withPrTime = prOpenedAtMs !== undefined ? { ...withPr, prOpenedAtMs } : withPr;
+        const withStale = stale !== undefined ? { ...withPrTime, stale } : withPrTime;
+        targets[k] = closedReason !== undefined ? { ...withStale, closedReason } : withStale;
+    }
+    return targets;
+}
+function coerceCompanionTargets(value, nowMs) {
+    const out = {};
+    if (!isPlainObject(value))
+        return out;
+    for (const [k, v] of Object.entries(value)) {
+        if (!isPlainObject(v))
+            continue;
+        const key = typeof v.key === 'string' ? String(v.key) : k;
+        const parentPrNumber = typeof v.parentPrNumber === 'number' ? Math.trunc(v.parentPrNumber) : 0;
+        const parentHeadSha = typeof v.parentHeadSha === 'string' ? String(v.parentHeadSha) : '';
+        const targetId = typeof v.targetId === 'string' ? String(v.targetId) : '';
+        const statusRaw = v.status;
+        const status = statusRaw === 'none' || statusRaw === 'open' || statusRaw === 'merged' || statusRaw === 'closed' ? statusRaw : 'none';
+        const createdAtMs = typeof v.createdAtMs === 'number' ? Math.trunc(v.createdAtMs) : nowMs;
+        const updatedAtMs = typeof v.updatedAtMs === 'number' ? Math.trunc(v.updatedAtMs) : createdAtMs;
+        const lastPrRaw = v.lastPr;
+        const lastPr = isPlainObject(lastPrRaw) && typeof lastPrRaw.url === 'string'
+            ? (() => {
+                const url = String(lastPrRaw.url);
+                if (lastPrRaw.id === undefined)
+                    return { url };
+                return { url, id: String(lastPrRaw.id) };
+            })()
+            : undefined;
+        const runs = Array.isArray(v.runs)
+            ? v.runs
+                .filter((r) => isPlainObject(r))
+                .map((r) => {
+                const base = {
+                    atMs: typeof r.atMs === 'number' ? Math.trunc(r.atMs) : createdAtMs,
+                    outcome: r.outcome === 'pass' || r.outcome === 'fail' || r.outcome === 'skipped' ? r.outcome : 'fail',
+                };
+                const notes = typeof r.notes === 'string' ? r.notes : undefined;
+                return notes === undefined ? base : { ...base, notes };
+            })
+            : [];
+        out[k] = { key, parentPrNumber, parentHeadSha, targetId, status, runs, createdAtMs, updatedAtMs, ...(lastPr ? { lastPr } : {}) };
+    }
+    return out;
+}
+export function makeCompanionKey(opts) {
+    const pr = Math.max(0, Math.trunc(opts.parentPrNumber));
+    const sha = String(opts.parentHeadSha ?? '').trim().toLowerCase();
+    const tid = String(opts.targetId ?? '').trim();
+    return `cp_${pr}_${sha}_${tid}`;
+}
+export function hasCompanionWork(state, key) {
+    return !!state.companionTargets[key];
+}
+function coerceStateFile(value, nowMs) {
+    if (!isPlainObject(value))
+        return initState(nowMs);
+    const schemaVersion = value.schemaVersion;
+    const updatedAt = typeof value.updatedAtMs === 'number' ? Math.trunc(value.updatedAtMs) : nowMs;
+    if (schemaVersion === 1) {
+        const scheduledTargets = coerceScheduledTargets(value.targets, nowMs);
+        return { schemaVersion: 2, updatedAtMs: updatedAt, scheduledTargets, companionTargets: {} };
+    }
+    if (schemaVersion !== 2)
+        return initState(nowMs);
+    const scheduledTargets = coerceScheduledTargets(value.scheduledTargets, nowMs);
+    const companionTargets = coerceCompanionTargets(value.companionTargets, nowMs);
+    return { schemaVersion: 2, updatedAtMs: updatedAt, scheduledTargets, companionTargets };
+}
+export function initState(nowMs) {
+    return { schemaVersion: 2, updatedAtMs: nowMs, scheduledTargets: {}, companionTargets: {} };
+}
+export function loadOrInitState(opts) {
+    const root = path.resolve(process.cwd(), opts?.root ?? '.');
+    const nowMs = opts?.nowMs ?? Date.now();
+    const { statePath } = getAgentPaths(root);
+    const existing = readJsonIfExists(statePath);
+    if (existing == null) {
+        const state = initState(nowMs);
+        writeStableJson(statePath, state);
+        return { path: statePath, state };
+    }
+    const state = coerceStateFile(existing, nowMs);
+    return { path: statePath, state };
+}
+export function saveState(opts) {
+    const root = path.resolve(process.cwd(), opts.root ?? '.');
+    const nowMs = opts.nowMs ?? Date.now();
+    const { statePath } = getAgentPaths(root);
+    const state = { ...opts.state, schemaVersion: 2, updatedAtMs: nowMs };
+    writeStableJson(statePath, state);
+    return { path: statePath };
+}
+//# sourceMappingURL=state.js.map

package/dist/core/state/state.js.map

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

package/dist/core/state/storage.d.ts

@@ -0,0 +1,9 @@
+export type AgentFilePaths = {
+    dir: string;
+    statePath: string;
+    policyPath: string;
+};
+export declare function getAgentPaths(root: string): AgentFilePaths;
+export declare function ensureDir(dir: string): void;
+export declare function readJsonIfExists(filePath: string): unknown | null;
+export declare function writeStableJson(filePath: string, value: unknown): void;

package/dist/core/state/storage.js

@@ -0,0 +1,25 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { stableStringify } from '../stableJson.js';
+export function getAgentPaths(root) {
+    const dir = path.join(root, '.test-agent');
+    return {
+        dir,
+        statePath: path.join(dir, 'state.json'),
+        policyPath: path.join(dir, 'policy.json'),
+    };
+}
+export function ensureDir(dir) {
+    fs.mkdirSync(dir, { recursive: true });
+}
+export function readJsonIfExists(filePath) {
+    if (!fs.existsSync(filePath))
+        return null;
+    const raw = fs.readFileSync(filePath, 'utf8');
+    return JSON.parse(raw);
+}
+export function writeStableJson(filePath, value) {
+    ensureDir(path.dirname(filePath));
+    fs.writeFileSync(filePath, stableStringify(value) + '\n', 'utf8');
+}
+//# sourceMappingURL=storage.js.map

package/dist/core/state/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/core/state/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAQnD,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC3C,OAAO;QACL,GAAG;QACH,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC;QACvC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,KAAc;IAC9D,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,eAAe,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC"}