nightralph 0.0.52 → 0.0.54

package/dist/review.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/review.ts"],
+  "sourcesContent": ["import { existsSync, readFileSync, writeFileSync } from 'node:fs'\nimport { basename, dirname, join, relative } from 'node:path'\nimport {\n    NOTES_PATH,\n    formatDate,\n    collectNotes,\n    ensureNotesIgnored,\n    appendEntry,\n} from './learnings.js'\nimport { runTestCmd } from './testcmd.js'\nimport { commitProgress } from './progress.js'\nimport { runWithRetries, type EffortLevel } from './retry.js'\nimport {\n    createNamedWorktree,\n    deleteBranch,\n    removeWorktree,\n    commitDirty,\n    hasNewCommits,\n    isDirty,\n    hasChangesOutside,\n    headCommit,\n    isAncestor,\n    mergeBase,\n} from './worktree.js'\nimport { mergeBranch } from './merge.js'\nimport type { AgentResult } from './orchestrator.js'\nimport {\n    readDocsRule,\n    installRule,\n    testGateRule,\n    LINT_RULE,\n    integrityRule,\n    CONFINEMENT_RULES,\n    commitRule,\n    notesRule,\n    agentsMdRule,\n} from './rules.js'\n\nexport const FINDINGS_FILE = 'findings.md'\nexport const FINDINGS_PATH = `${dirname(NOTES_PATH)}/${FINDINGS_FILE}`\nexport const NO_FINDINGS = 'No findings.'\n// Bookkeeping lives here (tickets, progress, learnings, the\n// review log), so the review never looks at it.\nexport const REVIEW_EXCLUDE = '.scratch'\n\nexport const REVIEW_MARKER = '---- REVIEW INSTRUCTIONS ----'\nexport const FIX_MARKER = '---- REVIEW FINDINGS ----'\n\n// The bookkeeping directory for a review log: the nearest ancestor\n// of reviewPath named .scratch, relative to the repo root, so a run\n// launched from a subdirectory excludes the right path. Falls back\n// to REVIEW_EXCLUDE when reviewPath is not under a .scratch.\nexport function reviewExcludeFor (\n    repoRoot:string,\n    reviewPath:string\n):string {\n    let dir = dirname(reviewPath)\n    while (dirname(dir) !== dir) {\n        if (basename(dir) === '.scratch') {\n            const rel = relative(repoRoot, dir)\n            if (rel && !rel.startsWith('..')) return rel\n            break\n        }\n        dir = dirname(dir)\n    }\n    return REVIEW_EXCLUDE\n}\n\nexport function reviewDiffCommand (\n    from:string,\n    to:string,\n    exclude:string = REVIEW_EXCLUDE\n):string {\n    return `git diff ${from}..${to} -- . ':(exclude)${exclude}'`\n}\n\nexport function renderReviewPrompt (opts:{\n    specBody:string\n    from:string\n    to:string\n    exclude?:string\n}):string {\n    return [\n        '---- SPEC CONTEXT ----',\n        opts.specBody,\n        '',\n        REVIEW_MARKER,\n        'You are reviewing work that autonomous agents merged ' +\n            'into this branch, one ticket at a time. Review the ' +\n            'combined change as a whole.',\n        '',\n        'The change to review:',\n        '',\n        `    ${reviewDiffCommand(opts.from, opts.to, opts.exclude)}`,\n        '',\n        'Follow these rules:',\n        '- Read any AGENTS.md in or above the directories the ' +\n            'change touches, plus CONTEXT.md and the relevant ' +\n            'docs/adr/ entries if they exist. Treat their ' +\n            'contracts and the spec above as the standard the ' +\n            'code must meet.',\n        '- Look for correctness bugs, missing or weak tests, ' +\n            'and code that breaks a documented contract. Ignore ' +\n            'style preferences.',\n        '- You may run the tests or the type checker to confirm ' +\n            'a suspicion.',\n        '- Do NOT edit, stage, or commit code. Anything you ' +\n            'change here is discarded.',\n        ...CONFINEMENT_RULES,\n        '',\n        `Write your findings to \\`${FINDINGS_PATH}\\` (create the ` +\n            'directory), most severe first, in exactly this form:',\n        '',\n        '- [ ] <one-line summary of the finding>',\n        '    <file:line, and a concrete input or state that goes ' +\n            'wrong>',\n        '',\n        'If you find nothing worth fixing, write the single line: ' +\n            NO_FINDINGS,\n        'Never git add or commit that file; the orchestrator ' +\n            'collects it.',\n        '',\n    ].join('\\n')\n}\n\nexport type FixFailure =\n    'install'|'exit'|'no-commits'|'tests'|'merge'\n\nexport const FIX_FAILURE_TEXT:Record<FixFailure, string> = {\n    install:'dependency install failed',\n    exit:'the agent exited with an error',\n    'no-commits':'the agent made no commits',\n    tests:'the test command failed after the agent finished',\n    merge:'the fix branch did not merge cleanly',\n}\n\nfunction findingLines (findings:ReadonlyArray<Finding>):string[] {\n    return findings.flatMap(f => [\n        `- [ ] ${f.summary}`,\n        ...(f.detail ?\n            f.detail.split('\\n').map(l => `    ${l}`) :\n            []),\n    ])\n}\n\nfunction previousBlock (\n    previous?:{ reason:FixFailure; notes:string|null }\n):string[] {\n    if (!previous) return []\n    return [\n        '---- PREVIOUS FIX ATTEMPT ----',\n        `It failed: ${FIX_FAILURE_TEXT[previous.reason]}.`,\n        previous.notes ?? 'It left no notes.',\n        '',\n    ]\n}\n\nexport function renderFixPrompt (opts:{\n    specBody:string\n    findings:ReadonlyArray<Finding>\n    testCmd:string\n    installCmd?:string\n    previous?:{ reason:FixFailure; notes:string|null }\n}):string {\n    return [\n        '---- SPEC CONTEXT ----',\n        opts.specBody,\n        '',\n        FIX_MARKER,\n        ...findingLines(opts.findings),\n        '',\n        ...previousBlock(opts.previous),\n        '---- AGENT INSTRUCTIONS ----',\n        'You are an autonomous coding agent. Fix the review ' +\n            'findings above using /tdd.',\n        '',\n        'Follow these rules:',\n        readDocsRule('findings'),\n        '- Fix ONLY the listed findings. Do not fix unrelated ' +\n            'problems you notice.',\n        ...installRule(opts.installCmd),\n        '- Use /tdd for every finding: write a failing test that ' +\n            'shows the problem, then write only enough code to ' +\n            'make it pass, then refactor.',\n        testGateRule(opts.testCmd, 'fix'),\n        LINT_RULE,\n        integrityRule('finding'),\n        ...CONFINEMENT_RULES,\n        commitRule('finding'),\n        notesRule('finding', 'fix'),\n        '- After fixing each finding, print a line: ' +\n            '[x] <finding summary> (matching the summary ' +\n            'text exactly).',\n        '- If a finding is wrong or cannot be fixed honestly, ' +\n            'leave it unchecked and explain why in your notes ' +\n            'file.',\n        agentsMdRule('fix'),\n        '',\n    ].join('\\n')\n}\n\nconst SENTINEL_PREFIX = '<!-- nightralph:review'\nconst SENTINEL_RE = /^<!-- nightralph:review (.*) -->$/\nconst SHA_RE = /^[0-9a-f]{4,64}$/\nconst FIX_HEADING = '### Fix'\nconst FINDING_RE = /^ ?[-*+]\\s+\\[([ xX])\\]\\s+(.+)$/\n\nexport const REVIEW_STATUSES = [\n    'clean', 'fixed', 'unresolved', 'review-failed',\n] as const\n\nexport type ReviewStatus = typeof REVIEW_STATUSES[number]\n\nexport type Finding = {\n    summary:string\n    detail:string\n    checked:boolean\n}\n\nexport type FixRecord = {\n    attempts:number\n    maxAttempts:number\n    effort?:string\n    exitCode:number|null\n    result:string\n    notes:string|null\n}\n\nexport type ReviewEntryInput = {\n    from:string\n    to:string\n    status:ReviewStatus\n    now:Date\n    findings:Finding[]\n    fix?:FixRecord\n}\n\nexport type ReviewEntry = {\n    from:string\n    to:string\n    status:ReviewStatus\n    findings:Finding[]\n    body:string\n}\n\nexport type ReviewOutcome = {\n    status:ReviewStatus|'skipped'\n    findings:number\n    fixed:number\n}\n\nfunction isReviewStatus (value:string):value is ReviewStatus {\n    return (REVIEW_STATUSES as readonly string[]).includes(value)\n}\n\nfunction collapse (s:string):string {\n    return s.replace(/\\s+/g, ' ').trim()\n}\n\nfunction normalize (s:string):string {\n    return collapse(s).toLowerCase()\n}\n\nfunction sanitize (text:string):string {\n    return text.replace(\n        new RegExp(SENTINEL_PREFIX, 'g'),\n        '<!-- nightralph-review'\n    )\n}\n\nfunction splitLines (text:string):string[] {\n    return text.split('\\n').map(line => {\n        return line.endsWith('\\r') ? line.slice(0, -1) : line\n    })\n}\n\n// The reviewer's checklist: `- [ ] summary` lines, each followed\n// by its detail lines. [] for an explicit \"No findings.\", null\n// when the text is neither, which fails the review attempt.\nexport function parseFindings (text:string):Finding[]|null {\n    const findings:Finding[] = []\n    const details:string[][] = []\n    for (const line of splitLines(text)) {\n        const m = line.match(FINDING_RE)\n        if (m) {\n            findings.push({\n                summary:collapse(m[2]),\n                detail:'',\n                checked:m[1] !== ' ',\n            })\n            details.push([])\n        } else if (findings.length > 0 && line.trim()) {\n            details[details.length - 1].push(line.trim())\n        }\n    }\n    if (findings.length > 0) {\n        return findings.map((f, i) => {\n            return { ...f, detail:details[i].join('\\n') }\n        })\n    }\n    const clean = splitLines(text).some(line => {\n        return normalize(line) === NO_FINDINGS.toLowerCase()\n    })\n    return clean ? [] : null\n}\n\n// Checks off the findings the fixer echoed as `[x] <summary>`,\n// compared loosely like ticket checklist items.\nexport function markFixed (\n    findings:ReadonlyArray<Finding>,\n    completedItems:ReadonlyArray<string>\n):Finding[] {\n    const done = new Set(completedItems.map(normalize))\n    return findings.map(f => {\n        return { ...f, checked:done.has(normalize(f.summary)) }\n    })\n}\n\nfunction headline (input:ReviewEntryInput):string {\n    const n = input.findings.length\n    const fixed = input.findings.filter(f => f.checked).length\n    switch (input.status) {\n        case 'clean': return 'no findings'\n        case 'fixed': return `${fixed} of ${n} fixed`\n        case 'unresolved':\n            return `${n} finding${n === 1 ? '' : 's'}, fix failed`\n        case 'review-failed': return 'review failed'\n        default: {\n            const _exhaustive:never = input.status\n            return _exhaustive\n        }\n    }\n}\n\nfunction renderFindings (input:ReviewEntryInput):string[] {\n    if (input.status === 'review-failed') {\n        return ['The reviewer left no usable findings file.']\n    }\n    if (input.findings.length === 0) return [NO_FINDINGS]\n    return input.findings.flatMap(f => {\n        const box = f.checked ? '[x]' : '[ ]'\n        const detail = f.detail ?\n            f.detail.split('\\n').map(l => `    ${sanitize(l)}`) :\n            []\n        return [`- ${box} ${sanitize(collapse(f.summary))}`, ...detail]\n    })\n}\n\nfunction renderFix (fix?:FixRecord):string[] {\n    if (!fix) return []\n    return [\n        '',\n        FIX_HEADING,\n        `- attempts: ${fix.attempts} of ${fix.maxAttempts}`,\n        ...(fix.effort ? [`- effort: ${fix.effort}`] : []),\n        `- agent exit code: ${fix.exitCode ?? 'none'}`,\n        `- result: ${sanitize(fix.result)}`,\n        '',\n        fix.notes ? sanitize(fix.notes) : 'The fixer left no notes.',\n    ]\n}\n\nexport function renderReviewEntry (input:ReviewEntryInput):string {\n    return [\n        `${SENTINEL_PREFIX} from=${input.from} to=${input.to} ` +\n            `status=${input.status} -->`,\n        `## ${formatDate(input.now)} -- review ` +\n            `${input.from.slice(0, 7)}..${input.to.slice(0, 7)} ` +\n            `-- ${headline(input)}`,\n        ...renderFindings(input),\n        ...renderFix(input.fix),\n        '---',\n        '',\n    ].join('\\n')\n}\n\nfunction parseEntry (\n    sentinel:string,\n    bodyLines:string[]\n):ReviewEntry|null {\n    const attrs:Record<string, string> = {}\n    for (const part of sentinel.split(/\\s+/).filter(Boolean)) {\n        const idx = part.indexOf('=')\n        if (idx > 0) attrs[part.slice(0, idx)] = part.slice(idx + 1)\n    }\n    const { from, to, status } = attrs\n    if (!from || !SHA_RE.test(from)) return null\n    if (!to || !SHA_RE.test(to)) return null\n    if (!status || !isReviewStatus(status)) return null\n\n    const lines = [...bodyLines]\n    while (lines.length > 0 && !lines[lines.length - 1].trim()) {\n        lines.pop()\n    }\n    if (lines[lines.length - 1] === '---') lines.pop()\n    const fixAt = lines.indexOf(FIX_HEADING)\n    const findingLines = fixAt === -1 ? lines : lines.slice(0, fixAt)\n    return {\n        from,\n        to,\n        status,\n        findings:parseFindings(findingLines.join('\\n')) ?? [],\n        body:lines.join('\\n').trim(),\n    }\n}\n\n// Malformed entries are dropped, not thrown; text before the\n// first sentinel is ignored.\nexport function parseReviewEntries (text:string):ReviewEntry[] {\n    const entries:ReviewEntry[] = []\n    let sentinel:string|null = null\n    let body:string[] = []\n    const flush = ():void => {\n        if (sentinel === null) return\n        const entry = parseEntry(sentinel, body)\n        if (entry) entries.push(entry)\n    }\n    for (const line of splitLines(text)) {\n        const m = line.match(SENTINEL_RE)\n        if (m) {\n            flush()\n            sentinel = m[1]\n            body = []\n        } else if (sentinel !== null) {\n            body.push(line)\n        }\n    }\n    flush()\n    return entries\n}\n\n// Where the review range starts: the last reviewed commit while\n// it is still on this branch, else the fork point from the\n// default branch, else the commit the run started from.\nexport function selectReviewBase (\n    entries:ReadonlyArray<ReviewEntry>,\n    opts:{\n        isAncestor:(sha:string) => boolean\n        forkPoint:string|null\n        launchCommit:string\n    }\n):string {\n    const last = [...entries].reverse().find(e => {\n        return e.status !== 'review-failed'\n    })\n    if (last && opts.isAncestor(last.to)) return last.to\n    return opts.forkPoint ?? opts.launchCommit\n}\n\n// One line for the finish summary; null when no review ran.\nexport function renderReviewSummary (\n    outcome:ReviewOutcome,\n    reviewPath:string\n):string|null {\n    const see = ` -- see ${reviewPath}`\n    const plural = outcome.findings === 1 ? '' : 's'\n    switch (outcome.status) {\n        case 'skipped': return null\n        case 'clean': return `Review: no findings${see}`\n        case 'fixed':\n            return `Review: ${outcome.findings} finding${plural}, ` +\n                `${outcome.fixed} fixed${see}`\n        case 'unresolved':\n            return `Review: ${outcome.findings} finding${plural}, ` +\n                `fix failed${see}`\n        case 'review-failed':\n            return `Review: the reviewer failed${see}`\n        default: {\n            const _exhaustive:never = outcome.status\n            return _exhaustive\n        }\n    }\n}\n\nexport type SpawnAgentFn = (opts:{\n    prompt:string\n    agentCmd:string\n    model:string|null\n    timeout:number\n    logPath:string\n    cwd?:string\n    label?:string\n    maxTurns?:number\n    effort?:EffortLevel\n    onLine?:(line:string) => void\n}) => Promise<AgentResult>\n\nexport type ReviewDeps = {\n    spawnAgent:SpawnAgentFn\n    // running child pids, so SIGINT also kills installs and tests\n    registry?:Set<number>\n}\n\nexport type ReviewPassOpts = {\n    repoRoot:string\n    repoName:string\n    // the branch the run merged into; the fix merges here too\n    baseBranch:string\n    reviewPath:string\n    // the default branch, when baseBranch is an integration branch\n    forkedFrom?:string\n    launchCommit:string\n    specBody:string\n    agentCmd:string\n    model:string|null\n    timeout:number\n    logsDir:string\n    testCmd:string\n    installCmd?:string\n    maxTurns?:number\n    effort?:EffortLevel\n    retries:number\n    retryDelay:number\n    log:(msg:string) => void\n    now?:() => Date\n}\n\n// Same naming as ticket logs: the first attempt keeps the plain\n// name, later attempts get their own file.\nfunction logPath (\n    logsDir:string,\n    stem:string,\n    attempt:number,\n    ext:string\n):string {\n    const suffix = attempt > 1 ? `.attempt${attempt}` : ''\n    return join(logsDir, `${stem}${suffix}${ext}`)\n}\n\n// Runs a shell step (install or tests) in a worktree, writing its\n// output to `path`; true only on exit 0.\nasync function runStep (\n    opts:ReviewPassOpts,\n    deps:ReviewDeps,\n    cmd:string,\n    cwd:string,\n    path:string\n):Promise<boolean> {\n    const result = await runTestCmd({\n        cmd,\n        cwd,\n        timeout:opts.timeout,\n        registry:deps.registry,\n    })\n    writeFileSync(path, result.output)\n    return result.exitCode === 0\n}\n\nasync function discardWorktree (\n    opts:ReviewPassOpts,\n    wt:{ worktreePath:string; branchName:string }\n):Promise<void> {\n    try {\n        await removeWorktree(wt.worktreePath, { force:true })\n        await deleteBranch(opts.repoRoot, wt.branchName)\n    } catch (err) {\n        opts.log(\n            `  Failed to remove ${wt.worktreePath}: ` +\n            (err instanceof Error ? err.message : String(err))\n        )\n    }\n}\n\n// Asks an agent to review from..to and returns its findings:\n// [] when clean, null when no attempt produced a usable findings\n// file. The worktree and anything the reviewer changed in it are\n// always discarded.\nexport async function runReviewer (\n    opts:ReviewPassOpts,\n    deps:ReviewDeps,\n    range:{ from:string; to:string }\n):Promise<Finding[]|null> {\n    return runWithRetries({\n        maxAttempts:opts.retries + 1,\n        retryDelay:opts.retryDelay,\n        agentCmd:opts.agentCmd,\n        effort:opts.effort,\n        label:'review',\n        log:opts.log,\n    }, async (attempt, effort) => {\n        const wt = await createNamedWorktree({\n            repoRoot:opts.repoRoot,\n            repoName:opts.repoName,\n            baseBranch:opts.baseBranch,\n            name:'review',\n        })\n        try {\n            if (opts.installCmd && !(await runStep(\n                opts, deps, opts.installCmd, wt.worktreePath,\n                logPath(opts.logsDir, 'review', attempt, '.install.log')\n            ))) {\n                opts.log('  review: install failed')\n                return { result:null, stop:false }\n            }\n            ensureNotesIgnored(wt.worktreePath)\n            await deps.spawnAgent({\n                prompt:renderReviewPrompt({\n                    specBody:opts.specBody,\n                    ...range,\n                    exclude:reviewExcludeFor(\n                        opts.repoRoot, opts.reviewPath\n                    ),\n                }),\n                agentCmd:opts.agentCmd,\n                model:opts.model,\n                timeout:opts.timeout,\n                logPath:logPath(opts.logsDir, 'review', attempt, '.log'),\n                cwd:wt.worktreePath,\n                label:'review',\n                maxTurns:opts.maxTurns,\n                effort,\n                onLine:opts.log,\n            })\n            const text = collectNotes(wt.worktreePath, FINDINGS_FILE)\n            const findings = text === null ? null : parseFindings(text)\n            if (findings === null) {\n                opts.log('  review: no usable findings file')\n            }\n            return { result:findings, stop:findings !== null }\n        } finally {\n            await discardWorktree(opts, wt)\n        }\n    })\n}\n\nexport type FixResult = {\n    merged:boolean\n    // checked per the fixer's [x] lines when merged; all\n    // unchecked otherwise\n    findings:Finding[]\n    attempts:number\n    effort?:EffortLevel\n    exitCode:number|null\n    result:string\n    notes:string|null\n}\n\n// Asks an agent to fix the findings in a fresh worktree off the\n// branch tip. Its work merges only after a green test gate;\n// every failure is retried like a ticket.\nexport async function runFixer (\n    opts:ReviewPassOpts,\n    deps:ReviewDeps,\n    findings:ReadonlyArray<Finding>\n):Promise<FixResult> {\n    const unchecked = findings.map(f => ({ ...f, checked:false }))\n    let previous:{ reason:FixFailure; notes:string|null }|undefined\n\n    return runWithRetries<FixResult>({\n        maxAttempts:opts.retries + 1,\n        retryDelay:opts.retryDelay,\n        agentCmd:opts.agentCmd,\n        effort:opts.effort,\n        label:'review fix',\n        log:opts.log,\n    }, async (attempt, effort) => {\n        const fail = (\n            reason:FixFailure,\n            exitCode:number|null,\n            notes:string|null\n        ) => {\n            previous = { reason, notes }\n            opts.log(`  review fix: ${FIX_FAILURE_TEXT[reason]}`)\n            return {\n                result:{\n                    merged:false,\n                    findings:unchecked,\n                    attempts:attempt,\n                    effort,\n                    exitCode,\n                    result:FIX_FAILURE_TEXT[reason],\n                    notes,\n                },\n                stop:false,\n            }\n        }\n\n        const wt = await createNamedWorktree({\n            repoRoot:opts.repoRoot,\n            repoName:opts.repoName,\n            baseBranch:opts.baseBranch,\n            name:'review-fix',\n        })\n        try {\n            if (opts.installCmd && !(await runStep(\n                opts, deps, opts.installCmd, wt.worktreePath,\n                logPath(\n                    opts.logsDir, 'review-fix', attempt,\n                    '.install.log'\n                )\n            ))) {\n                return fail('install', null, null)\n            }\n            ensureNotesIgnored(wt.worktreePath)\n            const agent = await deps.spawnAgent({\n                prompt:renderFixPrompt({\n                    specBody:opts.specBody,\n                    findings,\n                    testCmd:opts.testCmd,\n                    installCmd:opts.installCmd,\n                    previous,\n                }),\n                agentCmd:opts.agentCmd,\n                model:opts.model,\n                timeout:opts.timeout,\n                logPath:logPath(\n                    opts.logsDir, 'review-fix', attempt, '.log'\n                ),\n                cwd:wt.worktreePath,\n                label:'review-fix',\n                maxTurns:opts.maxTurns,\n                effort,\n                onLine:opts.log,\n            })\n            // Before any auto-commit, so notes never get committed\n            const notes = collectNotes(wt.worktreePath)\n\n            if (!agent.timedOut && agent.exitCode !== 0) {\n                return fail('exit', agent.exitCode, notes)\n            }\n            if (isDirty(wt.worktreePath)) {\n                await commitDirty(\n                    wt.worktreePath,\n                    'nightralph: auto-commit review fix ' +\n                    'remaining changes'\n                )\n            }\n            if (!hasNewCommits(\n                opts.repoRoot, opts.baseBranch, wt.branchName\n            )) {\n                return fail('no-commits', agent.exitCode, notes)\n            }\n            if (opts.testCmd === '') {\n                opts.log('  review fix: no test gate')\n            } else if (!(await runStep(\n                opts, deps, opts.testCmd, wt.worktreePath,\n                logPath(\n                    opts.logsDir, 'review-fix', attempt, '.test.log'\n                )\n            ))) {\n                return fail('tests', agent.exitCode, notes)\n            }\n            const merged = await mergeBranch(\n                opts.repoRoot, wt.branchName\n            )\n            if (!merged.success) {\n                return fail(\n                    'merge',\n                    agent.exitCode,\n                    [notes, merged.stderr].filter(Boolean)\n                        .join('\\n\\n') || null\n                )\n            }\n            opts.log('  review fix: merged')\n            return {\n                result:{\n                    merged:true,\n                    findings:markFixed(findings, agent.completedItems),\n                    attempts:attempt,\n                    effort,\n                    exitCode:agent.exitCode,\n                    result:'merged',\n                    notes,\n                },\n                stop:true,\n            }\n        } finally {\n            await discardWorktree(opts, wt)\n        }\n    })\n}\n\nexport function readReviewEntries (path:string):ReviewEntry[] {\n    if (!existsSync(path)) return []\n    return parseReviewEntries(readFileSync(path, 'utf8'))\n}\n\n// Reviews everything since the last reviewed commit, runs one fix\n// pass when there are findings, and appends and commits one entry\n// to the review log. Skips entirely when the range only touches\n// bookkeeping under REVIEW_EXCLUDE.\nexport async function runReviewPass (\n    opts:ReviewPassOpts,\n    deps:ReviewDeps\n):Promise<ReviewOutcome> {\n    const now = opts.now ?? (() => new Date())\n    const to = headCommit(opts.repoRoot)\n    const forkPoint = opts.forkedFrom ?\n        mergeBase(opts.repoRoot, opts.forkedFrom, to) :\n        null\n    const from = selectReviewBase(readReviewEntries(opts.reviewPath), {\n        isAncestor:sha => isAncestor(opts.repoRoot, sha, to),\n        forkPoint,\n        launchCommit:opts.launchCommit,\n    })\n    const exclude = reviewExcludeFor(opts.repoRoot, opts.reviewPath)\n    if (!hasChangesOutside(opts.repoRoot, from, to, exclude)) {\n        opts.log('\\nReview: nothing new to review')\n        return { status:'skipped', findings:0, fixed:0 }\n    }\n\n    opts.log(`\\nReviewing ${from.slice(0, 7)}..${to.slice(0, 7)}`)\n    const findings = await runReviewer(opts, deps, { from, to })\n\n    let entry:ReviewEntryInput\n    if (findings === null) {\n        entry = {\n            from,\n            to,\n            status:'review-failed',\n            now:now(),\n            findings:[]\n        }\n    } else if (findings.length === 0) {\n        entry = { from, to, status:'clean', now:now(), findings:[] }\n    } else {\n        opts.log(\n            `Review: ${findings.length} finding` +\n            `${findings.length === 1 ? '' : 's'}`\n        )\n        const fix = await runFixer(opts, deps, findings)\n        entry = {\n            from,\n            // A merged fix counts as reviewed\n            to:fix.merged ? headCommit(opts.repoRoot) : to,\n            status:fix.merged ? 'fixed' : 'unresolved',\n            now:now(),\n            findings:fix.findings,\n            fix:{\n                attempts:fix.attempts,\n                maxAttempts:opts.retries + 1,\n                effort:fix.effort,\n                exitCode:fix.exitCode,\n                result:fix.result,\n                notes:fix.notes,\n            },\n        }\n    }\n\n    appendEntry(opts.reviewPath, renderReviewEntry(entry))\n    await commitProgress(\n        opts.repoRoot, opts.reviewPath, 'nightralph: record review'\n    )\n    return {\n        status:entry.status,\n        findings:entry.findings.length,\n        fixed:entry.findings.filter(f => f.checked).length,\n    }\n}\n"],
+  "mappings": "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",
+  "names": ["findingLines"]
+}

package/dist/rules.js

@@ -0,0 +1,54 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { NOTES_PATH } from "./learnings.js";
+function readDocsRule(subject) {
+  return `- Read the files directly relevant to the ${subject} before writing code. Also read any AGENTS.md in or above the directories you will touch, plus CONTEXT.md and the relevant docs/adr/ entries if they exist. If they do not exist, proceed silently.`;
+}
+__name(readDocsRule, "readDocsRule");
+function installRule(installCmd) {
+  if (!installCmd) return [];
+  return [
+    `- Dependencies are already installed with \`${installCmd}\`. Do NOT reinstall them with any other command; to reinstall, run that same command. To add a dependency, use the package manager that command uses, so its lockfile stays in sync.`
+  ];
+}
+__name(installRule, "installRule");
+function testGateRule(testCmd, subject) {
+  if (testCmd === "") {
+    return `- Before each commit, run the tests relevant to what you changed. Do not commit with failing tests. The orchestrator runs no test command for this ${subject}.`;
+  }
+  return `- While iterating, run only the tests relevant to what you changed. Run \`${testCmd}\` in full once, as the final gate before your last commit. Do not commit with failing tests. The orchestrator runs the same command after you exit and rejects the ${subject} if it fails.`;
+}
+__name(testGateRule, "testGateRule");
+const LINT_RULE = "- If the project has a lint script, run it and fix what it reports.";
+function integrityRule(unit) {
+  return `- INTEGRITY: never delete, skip, weaken, or write tautological tests to force a green result. Only report a ${unit} done when its real tests genuinely pass. If an item cannot be completed honestly, leave it unchecked and record what blocked you in your notes file.`;
+}
+__name(integrityRule, "integrityRule");
+const CONFINEMENT_RULES = [
+  "- Do NOT read or modify files outside your current directory (the worktree).",
+  "- Do NOT run git push."
+];
+function commitRule(unit) {
+  return `- Commit after each ${unit}, and make sure everything is committed when finished, except your notes file.`;
+}
+__name(commitRule, "commitRule");
+function notesRule(unit, subject) {
+  return `- Keep notes for this attempt in \`${NOTES_PATH}\` (create the directory). Update it after each ${unit} and as soon as you hit a blocker, not only at the end. Record what you implemented, files changed, how you read any vague acceptance criteria, what blocked you, and anything the next attempt at this ${subject} should know. Never commit, git add, or delete this file; the orchestrator collects it.`;
+}
+__name(notesRule, "notesRule");
+function agentsMdRule(subject) {
+  return `- Before your final commit, record reusable learnings in the nearest AGENTS.md (in or above the directories you modified; prefer that over the repo root). Good additions: module conventions, gotchas, files that must change together, how to test that area, environment requirements. Do NOT add ${subject}-specific details or temporary debugging notes. Only write when you have knowledge that would help future work in that directory. Reusable patterns go in AGENTS.md; anything specific to this ${subject} goes in your notes file.`;
+}
+__name(agentsMdRule, "agentsMdRule");
+export {
+  CONFINEMENT_RULES,
+  LINT_RULE,
+  agentsMdRule,
+  commitRule,
+  installRule,
+  integrityRule,
+  notesRule,
+  readDocsRule,
+  testGateRule
+};
+//# sourceMappingURL=rules.js.map

package/dist/rules.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/rules.ts"],
+  "sourcesContent": ["import { NOTES_PATH } from './learnings.js'\n\n// Rule lines shared by the agent prompts. `unit` is what the agent\n// commits one at a time (\"checklist item\", \"finding\"); `subject` is\n// what the orchestrator accepts or rejects (\"ticket\", \"fix\").\n\nexport function readDocsRule (subject:string):string {\n    return '- Read the files directly relevant to the ' +\n        `${subject} before writing code. Also read any ` +\n        'AGENTS.md in or above the directories you ' +\n        'will touch, plus CONTEXT.md and the ' +\n        'relevant docs/adr/ entries if they exist. ' +\n        'If they do not exist, proceed silently.'\n}\n\n// The rule for agents in a worktree the orchestrator has\n// already installed dependencies into. Empty without one.\nexport function installRule (installCmd?:string):string[] {\n    if (!installCmd) return []\n    return [\n        '- Dependencies are already installed with ' +\n            `\\`${installCmd}\\`. Do NOT reinstall them ` +\n            'with any other command; to reinstall, run ' +\n            'that same command. To add a dependency, use ' +\n            'the package manager that command uses, so ' +\n            'its lockfile stays in sync.',\n    ]\n}\n\nexport function testGateRule (testCmd:string, subject:string):string {\n    if (testCmd === '') {\n        return '- Before each commit, run the tests relevant ' +\n            'to what you changed. Do not commit with failing ' +\n            'tests. The orchestrator runs no test command ' +\n            `for this ${subject}.`\n    }\n    return '- While iterating, run only the tests ' +\n        'relevant to what you changed. Run ' +\n        `\\`${testCmd}\\` in full once, as the ` +\n        'final gate before your last commit. Do ' +\n        'not commit with failing tests. The ' +\n        'orchestrator runs the same command after ' +\n        `you exit and rejects the ${subject} if it ` +\n        'fails.'\n}\n\nexport const LINT_RULE = '- If the project has a lint script, run it ' +\n    'and fix what it reports.'\n\nexport function integrityRule (unit:string):string {\n    return '- INTEGRITY: never delete, skip, weaken, or ' +\n        'write tautological tests to force a green ' +\n        `result. Only report a ${unit} done ` +\n        'when its real tests genuinely pass. If an ' +\n        'item cannot be completed honestly, leave ' +\n        'it unchecked and record what blocked you ' +\n        'in your notes file.'\n}\n\nexport const CONFINEMENT_RULES:string[] = [\n    '- Do NOT read or modify files outside ' +\n        'your current directory (the worktree).',\n    '- Do NOT run git push.',\n]\n\nexport function commitRule (unit:string):string {\n    return `- Commit after each ${unit}, and make ` +\n        'sure everything is committed when finished, ' +\n        'except your notes file.'\n}\n\nexport function notesRule (unit:string, subject:string):string {\n    return `- Keep notes for this attempt in \\`${NOTES_PATH}\\` ` +\n        '(create the directory). Update it after each ' +\n        `${unit} and as soon as you hit a ` +\n        'blocker, not only at the end. Record what you ' +\n        'implemented, files changed, how you read any ' +\n        'vague acceptance criteria, what blocked you, and ' +\n        `anything the next attempt at this ${subject} should ` +\n        'know. Never commit, git add, or delete this ' +\n        'file; the orchestrator collects it.'\n}\n\nexport function agentsMdRule (subject:string):string {\n    return '- Before your final commit, record reusable ' +\n        'learnings in the nearest AGENTS.md (in or ' +\n        'above the directories you modified; ' +\n        'prefer that over the repo root). Good ' +\n        'additions: module conventions, gotchas, ' +\n        'files that must change together, how to ' +\n        'test that area, environment requirements. ' +\n        `Do NOT add ${subject}-specific details or ` +\n        'temporary debugging notes. Only write ' +\n        'when you have knowledge that would help ' +\n        'future work in that directory. Reusable ' +\n        'patterns go in AGENTS.md; anything ' +\n        `specific to this ${subject} goes in your ` +\n        'notes file.'\n}\n"],
+  "mappings": ";;AAAA,SAAS,kBAAkB;AAMpB,SAAS,aAAc,SAAuB;AACjD,SAAO,6CACA,OAAO;AAKlB;AAPgB;AAWT,SAAS,YAAa,YAA6B;AACtD,MAAI,CAAC,WAAY,QAAO,CAAC;AACzB,SAAO;AAAA,IACH,+CACS,UAAU;AAAA,EAKvB;AACJ;AAVgB;AAYT,SAAS,aAAc,SAAgB,SAAuB;AACjE,MAAI,YAAY,IAAI;AAChB,WAAO,sJAGS,OAAO;AAAA,EAC3B;AACA,SAAO,6EAEE,OAAO,uKAIgB,OAAO;AAE3C;AAfgB;AAiBT,MAAM,YAAY;AAGlB,SAAS,cAAe,MAAoB;AAC/C,SAAO,+GAEsB,IAAI;AAKrC;AARgB;AAUT,MAAM,oBAA6B;AAAA,EACtC;AAAA,EAEA;AACJ;AAEO,SAAS,WAAY,MAAoB;AAC5C,SAAO,uBAAuB,IAAI;AAGtC;AAJgB;AAMT,SAAS,UAAW,MAAa,SAAuB;AAC3D,SAAO,sCAAsC,UAAU,mDAEhD,IAAI,2MAI8B,OAAO;AAGpD;AAVgB;AAYT,SAAS,aAAc,SAAuB;AACjD,SAAO,wSAOW,OAAO,kMAKD,OAAO;AAEnC;AAfgB;",
+  "names": []
+}

package/dist/src/display.d.ts

@@ -1,38 +1,46 @@
-export type TicketStatus = 'pending' | 'in-progress' | 'awaiting-merge' | 'done' | 'failed';
+export type TicketStatus = 'pending' | 'in-progress' | 'awaiting-merge' | 'done' | 'failed' | 'blocked';
 export type DisplayTicket = {
     readonly num: number;
     readonly filename: string;
     readonly feature?: string;
     status: TicketStatus;
+    blockedBy?: ReadonlyArray<string>;
+};
+export type TicketRef = {
+    readonly num: number;
+    readonly filename: string;
+    readonly feature?: string;
 };
 export type WaveState = {
     readonly waveNum: number;
     readonly totalWaves: number;
-    readonly tickets: Array<DisplayTicket>;
 };
 export type DisplayConfig = {
     readonly stream: NodeJS.WriteStream;
 };
 /**
  * Progress across the whole run, not just the current wave.
- * `completed` counts tickets done before the wave started;
- * tickets that finish during the wave are added on top.
+ * `completed` counts this run's tickets done before the wave
+ * started; `total` is the size of this run's ticket list. Only
+ * PlainDisplay prints it; StatusDisplay counts from its own list.
  */
 export type RunProgress = {
     readonly completed: number;
     readonly total: number;
 };
 export type Display = {
-    startWave(waveNum: number, totalWaves: number, tickets: ReadonlyArray<{
-        num: number;
-        filename: string;
-        feature?: string;
-    }>, progress?: RunProgress, remaining?: ReadonlyArray<{
-        num: number;
-        filename: string;
-        feature?: string;
-    }>): void;
+    /**
+     * Called once at the start of the run, fixes the ticket list
+     * for the entire session.
+     */
+    startRun(tickets: ReadonlyArray<TicketRef>): void;
+    startWave(waveNum: number, totalWaves: number, tickets: ReadonlyArray<TicketRef>, progress?: RunProgress): void;
     setTicketStatus(num: number, status: TicketStatus, feature?: string): void;
+    /**
+     * Mark a ticket as blocked; `blockedBy` holds display labels
+     * of the upstream tickets that failed or need a human.
+     */
+    setBlocked(num: number, feature: string | undefined, blockedBy: ReadonlyArray<string>): void;
     log(message: string): void;
     cleanup(): void;
 };
@@ -51,6 +59,11 @@ export declare const color: {
     readonly cyan: (text: string) => string;
     readonly dim: (text: string) => string;
 };
+export declare function ticketLabel(ticket: {
+    num: number;
+    filename: string;
+    feature?: string;
+}): string;
 /**
  * Clamp a line to `width` visible columns so it can never wrap.
  * A wrapped line occupies more terminal rows than `render`
@@ -67,8 +80,8 @@ export declare function wrapLine(line: string, width: number): Array<string>;
 export declare function renderDot(status: TicketStatus): string;
 export declare class StatusDisplay implements Display {
     private wave;
-    private progress;
-    private remaining;
+    private tickets;
+    private hasRun;
     private messages;
     private renderedLines;
     private config;
@@ -76,31 +89,20 @@ export declare class StatusDisplay implements Display {
     private resizeListener;
     constructor(config?: Readonly<Partial<DisplayConfig>>);
     private getAvailableRows;
-    startWave(waveNum: number, totalWaves: number, tickets: Array<Readonly<{
-        num: number;
-        filename: string;
-        feature?: string;
-    }>>, progress?: RunProgress, remaining?: ReadonlyArray<{
-        num: number;
-        filename: string;
-        feature?: string;
-    }>): void;
+    private findTicket;
+    startRun(tickets: ReadonlyArray<TicketRef>): void;
+    startWave(waveNum: number, totalWaves: number, tickets: ReadonlyArray<TicketRef>, _progress?: RunProgress): void;
     setTicketStatus(num: number, status: TicketStatus, feature?: string): void;
+    setBlocked(num: number, feature: string | undefined, blockedBy: ReadonlyArray<string>): void;
     log(message: string): void;
     cleanup(): void;
     private render;
 }
 export declare class PlainDisplay implements Display {
-    startWave(waveNum: number, _totalWaves: number, tickets: ReadonlyArray<{
-        num: number;
-        filename: string;
-        feature?: string;
-    }>, progress?: RunProgress, _remaining?: ReadonlyArray<{
-        num: number;
-        filename: string;
-        feature?: string;
-    }>): void;
+    startRun(_tickets: ReadonlyArray<TicketRef>): void;
+    startWave(waveNum: number, _totalWaves: number, tickets: ReadonlyArray<TicketRef>, progress?: RunProgress): void;
     setTicketStatus(_num: number, _status: TicketStatus, _feature?: string): void;
+    setBlocked(_num: number, _feature: string | undefined, _blockedBy: ReadonlyArray<string>): void;
     log(message: string): void;
     cleanup(): void;
 }

package/dist/src/display.d.ts.map

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

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAyBA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAgB,MAAM,cAAc,CAAA;AAG9E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AA4BA,OAAO,EACH,eAAe,EACf,gBAAgB,EAGnB,MAAM,cAAc,CAAA;AASrB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/src/learnings.d.ts

@@ -0,0 +1,68 @@
+export declare const MAX_OWN_ENTRIES = 4;
+export declare const MAX_ENTRY_CHARS = 4000;
+export declare const LOG_TAIL_LINES = 40;
+export declare const NOTES_PATH = ".nightralph/notes.md";
+export declare const TRUNCATED_MARKER = "[truncated]";
+export declare const LEARNING_OUTCOMES: readonly ["done", "exit", "tests", "install", "no-commits", "error", "merge"];
+export type LearningOutcome = typeof LEARNING_OUTCOMES[number];
+export type LearningEntry = {
+    key: string;
+    attempt: number;
+    outcome: LearningOutcome;
+    timedOut: boolean;
+    body: string;
+};
+type EntryBase = {
+    key: string;
+    label: string;
+    attempt: number;
+    now: Date;
+};
+export type AgentRunRecord = {
+    exitCode: number;
+    completedItems: string[];
+    timedOut: boolean;
+    notes: string | null;
+};
+type AgentFields = {
+    run: AgentRunRecord;
+    effort?: string;
+};
+type LogTail = {
+    logName: string;
+    logTail: string;
+};
+export type EntryInput = EntryBase & ((AgentFields & {
+    outcome: 'done' | 'exit' | 'no-commits';
+}) | (AgentFields & LogTail & {
+    outcome: 'tests';
+}) | (LogTail & {
+    outcome: 'install';
+}) | {
+    outcome: 'error';
+    error: string;
+} | {
+    outcome: 'merge';
+    stderr: string;
+});
+export type HistorySelection = {
+    own: LearningEntry[];
+    blockers: LearningEntry[];
+};
+export declare function formatDate(date: Date): string;
+export declare function isLearningOutcome(value: string): value is LearningOutcome;
+export declare function renderEntry(input: EntryInput): string;
+export declare function parseEntries(text: string): LearningEntry[];
+export declare function selectHistory(entries: LearningEntry[], opts: {
+    key: string;
+    blockerKeys: string[];
+}): HistorySelection;
+export declare function renderHistory(selection: HistorySelection): string;
+export declare function tailLines(text: string, n: number): string;
+export declare function learningsPathFor(progressPath: string): string;
+export declare function readEntries(path: string): LearningEntry[];
+export declare function appendEntry(path: string, text: string): void;
+export declare function collectNotes(worktreePath: string, file?: string): string | null;
+export declare function ensureNotesIgnored(worktreePath: string): void;
+export {};
+//# sourceMappingURL=learnings.d.ts.map

package/dist/src/learnings.d.ts.map

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

package/dist/src/orchestrator.d.ts

@@ -1,5 +1,7 @@
 import { type MergeConflictStrategy } from './merge.js';
 import { type Display } from './display.js';
+import { type EffortLevel } from './retry.js';
+export { EFFORT_LADDERS, ALL_EFFORT_LEVELS, escalateEffort, retryDelayFor, type EffortLevel, type ProviderName, } from './retry.js';
 export type Ticket = {
     num: number;
     slug: string;
@@ -21,6 +23,16 @@ export declare function parseBlockers(body: string): number[];
 export declare function scanTickets(dir: string, feature?: string): Ticket[];
 export declare function ticketKey(feature: string, num: number): string;
 export declare function findReadyTickets(tickets: ReadonlyArray<Ticket>): Ticket[];
+/**
+ * Tickets that cannot run this session because a ticket they
+ * depend on (directly or through a chain, within their own
+ * feature) is dead: in `failedKeys`, or in a status that is
+ * neither done nor ready-for-agent, e.g. ready-for-human.
+ * Returns ticketKey -> dead upstream ticketKeys. Only
+ * ready-for-agent tickets that have not failed are keys. A
+ * blocker number with no matching ticket is not dead.
+ */
+export declare function findBlockedTickets(tickets: ReadonlyArray<Ticket>, failedKeys: ReadonlySet<string>): Map<string, Array<string>>;
 export declare const COMPLETED_RE: RegExp;
 export declare const TOOL_USE_RE: RegExp;
 export declare function checkItems(ticket: Ticket, completedItems: string[]): void;
@@ -29,18 +41,13 @@ export declare function stripSpecSection(specBody: string, heading: string): str
 export declare function lookupSpec(specBodies: Map<string, string> | undefined, fallback: string, feature: string): string;
 export declare function renderPrompt(specBody: string, ticket: Ticket, opts: {
     testCmd: string;
+    installCmd?: string;
+    history?: string;
+}): string;
+export declare function renderMergePrompt(specBody: string, ticket: Ticket, opts?: {
+    installCmd?: string;
 }): string;
-export declare function renderMergePrompt(specBody: string, ticket: Ticket): string;
 export declare function getProviderArgs(cmd: string): string[];
-export declare const EFFORT_LADDERS: {
-    readonly pi: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
-    readonly claude: readonly ["low", "medium", "high", "xhigh", "max"];
-    readonly codex: readonly ["low", "medium", "high"];
-};
-export type ProviderName = keyof typeof EFFORT_LADDERS;
-export type EffortLevel = typeof EFFORT_LADDERS[ProviderName][number];
-export declare const ALL_EFFORT_LEVELS: EffortLevel[];
-export declare function escalateEffort(provider: ProviderName, level?: EffortLevel): EffortLevel;
 export declare function formatStreamLine(line: string): string | null;
 export type PiStreamFormatter = {
     process: (line: string) => string[];
@@ -74,6 +81,7 @@ export declare function dryRunIsolated(opts: {
     conflictStrategy: MergeConflictStrategy;
     progressPath: string;
     testCmd: string;
+    installCmd?: string;
     effort?: EffortLevel;
     retries?: number;
     retryDelay?: number;
@@ -83,7 +91,6 @@ export declare const DEFAULT_RETRIES = 3;
 export declare const DEFAULT_RETRY_DELAY = 30;
 export declare const DEFAULT_CONCURRENCY = 5;
 export declare function runPool<T, R>(items: T[], limit: number, fn: (item: T) => Promise<R>): Promise<PromiseSettledResult<R>[]>;
-export declare function retryDelayFor(base: number, attempt: number): number;
 export declare const HUMAN_STATUS = "ready-for-human";
 /**
  * The text logged when a run ends. The first line is the
@@ -108,13 +115,19 @@ export declare function runWavesIsolated(opts: {
     conflictStrategy: MergeConflictStrategy;
     display?: Display;
     testCmd: string;
+    installCmd?: string;
     maxTurns?: number;
     effort?: EffortLevel;
     retries?: number;
     retryDelay?: number;
     concurrency?: number;
     progressPaths?: Map<string, string>;
+    review?: {
+        reviewPath: string;
+        forkedFrom?: string;
+    };
 }): Promise<{
     allDone: boolean;
+    branch: string;
 }>;
 //# sourceMappingURL=orchestrator.d.ts.map

package/dist/src/orchestrator.d.ts.map

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

package/dist/src/preflight.d.ts

@@ -0,0 +1,6 @@
+export type ResolveExecutableOpts = {
+    path?: string;
+    cwd?: string;
+};
+export declare function resolveExecutable(cmd: string, opts?: ResolveExecutableOpts): string | null;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/src/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/preflight.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,qBAAqB,GAAG;IAEhC,IAAI,CAAC,EAAC,MAAM,CAAA;IAGZ,GAAG,CAAC,EAAC,MAAM,CAAA;CACd,CAAA;AAeD,wBAAgB,iBAAiB,CAC7B,GAAG,EAAC,MAAM,EACV,IAAI,GAAC,qBAA0B,GACjC,MAAM,GAAC,IAAI,CAcZ"}

package/dist/src/progress.d.ts

@@ -35,5 +35,5 @@ export declare function checkTicket(data: ProgressData, ticketNum: number, resul
     done?: boolean;
 }): void;
 export declare function writeProgress(progressPath: string, data: ProgressData): void;
-export declare function commitProgress(repoRoot: string, progressPath: string, message: string): Promise<boolean>;
+export declare function commitProgress(repoRoot: string, paths: string | string[], message: string): Promise<boolean>;
 //# sourceMappingURL=progress.d.ts.map

package/dist/src/progress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/progress.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAM/C,MAAM,MAAM,cAAc,GAAG;IACzB,GAAG,EAAC,MAAM,CAAA;IACV,IAAI,EAAC,MAAM,CAAA;IACX,QAAQ,EAAC,MAAM,CAAA;IACf,IAAI,EAAC,OAAO,CAAA;IACZ,MAAM,EAAC,MAAM,GAAC,IAAI,CAAA;IAClB,QAAQ,EAAC,MAAM,GAAC,IAAI,CAAA;IACpB,WAAW,EAAC,MAAM,GAAC,IAAI,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACvB,OAAO,EAAC,MAAM,CAAA;IACd,SAAS,EAAC,MAAM,CAAA;IAChB,OAAO,EAAC,KAAK,CAAC,cAAc,CAAC,CAAA;CAChC,CAAA;AAED,wBAAgB,gBAAgB,CAC5B,OAAO,EAAC,MAAM,EACd,OAAO,EAAC,aAAa,CAAC,MAAM,CAAC,GAC/B,YAAY,CAcb;AAED,wBAAgB,4BAA4B,CACxC,OAAO,EAAC,aAAa,CAAC,MAAM,CAAC,GAC/B,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAa1B;AAED,MAAM,MAAM,eAAe,GAAG;IAC1B,OAAO,EAAC,CAAC,OAAO,EAAC,MAAM,KAAK,YAAY,CAAA;IACxC,OAAO,EAAC,CAAC,OAAO,EAAC,MAAM,KAAK,MAAM,CAAA;CACrC,CAAA;AAED,wBAAgB,qBAAqB,CAAE,IAAI,EAAC;IACxC,aAAa,EAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,OAAO,EAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACjC,YAAY,EAAC,MAAM,CAAA;IACnB,YAAY,EAAC,YAAY,CAAA;CAC5B,GAAE,eAAe,CAWjB;AAED,wBAAgB,cAAc,CAC1B,YAAY,EAAC,MAAM,GACrB,OAAO,CAKR;AAED,wBAAgB,YAAY,CACxB,YAAY,EAAC,MAAM,GACrB,YAAY,GAAC,IAAI,CAwDlB;AAED,wBAAgB,aAAa,CACzB,KAAK,EAAC,YAAY,EAClB,QAAQ,EAAC,YAAY,GAAC,IAAI,GAC5B,YAAY,CAcb;AAED,wBAAgB,cAAc,CAAE,IAAI,EAAC,YAAY,GAAE,MAAM,CAgCxD;AAED,wBAAgB,WAAW,CACvB,IAAI,EAAC,YAAY,EACjB,SAAS,EAAC,MAAM,EAChB,MAAM,EAAC;IAAE,MAAM,EAAC,MAAM,CAAC;IAAC,QAAQ,EAAC,MAAM,CAAC;IAAC,IAAI,CAAC,EAAC,OAAO,CAAA;CAAE,GAC1D,IAAI,CAYL;AAED,wBAAgB,aAAa,CACzB,YAAY,EAAC,MAAM,EACnB,IAAI,EAAC,YAAY,GACnB,IAAI,CAKL;AAED,wBAAsB,cAAc,CAChC,QAAQ,EAAC,MAAM,EACf,YAAY,EAAC,MAAM,EACnB,OAAO,EAAC,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAwBjB"}
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/progress.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAM/C,MAAM,MAAM,cAAc,GAAG;IACzB,GAAG,EAAC,MAAM,CAAA;IACV,IAAI,EAAC,MAAM,CAAA;IACX,QAAQ,EAAC,MAAM,CAAA;IACf,IAAI,EAAC,OAAO,CAAA;IACZ,MAAM,EAAC,MAAM,GAAC,IAAI,CAAA;IAClB,QAAQ,EAAC,MAAM,GAAC,IAAI,CAAA;IACpB,WAAW,EAAC,MAAM,GAAC,IAAI,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACvB,OAAO,EAAC,MAAM,CAAA;IACd,SAAS,EAAC,MAAM,CAAA;IAChB,OAAO,EAAC,KAAK,CAAC,cAAc,CAAC,CAAA;CAChC,CAAA;AAED,wBAAgB,gBAAgB,CAC5B,OAAO,EAAC,MAAM,EACd,OAAO,EAAC,aAAa,CAAC,MAAM,CAAC,GAC/B,YAAY,CAcb;AAED,wBAAgB,4BAA4B,CACxC,OAAO,EAAC,aAAa,CAAC,MAAM,CAAC,GAC/B,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAa1B;AAED,MAAM,MAAM,eAAe,GAAG;IAC1B,OAAO,EAAC,CAAC,OAAO,EAAC,MAAM,KAAK,YAAY,CAAA;IACxC,OAAO,EAAC,CAAC,OAAO,EAAC,MAAM,KAAK,MAAM,CAAA;CACrC,CAAA;AAED,wBAAgB,qBAAqB,CAAE,IAAI,EAAC;IACxC,aAAa,EAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,OAAO,EAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACjC,YAAY,EAAC,MAAM,CAAA;IACnB,YAAY,EAAC,YAAY,CAAA;CAC5B,GAAE,eAAe,CAWjB;AAED,wBAAgB,cAAc,CAC1B,YAAY,EAAC,MAAM,GACrB,OAAO,CAKR;AAED,wBAAgB,YAAY,CACxB,YAAY,EAAC,MAAM,GACrB,YAAY,GAAC,IAAI,CAwDlB;AAED,wBAAgB,aAAa,CACzB,KAAK,EAAC,YAAY,EAClB,QAAQ,EAAC,YAAY,GAAC,IAAI,GAC5B,YAAY,CAcb;AAED,wBAAgB,cAAc,CAAE,IAAI,EAAC,YAAY,GAAE,MAAM,CAgCxD;AAED,wBAAgB,WAAW,CACvB,IAAI,EAAC,YAAY,EACjB,SAAS,EAAC,MAAM,EAChB,MAAM,EAAC;IAAE,MAAM,EAAC,MAAM,CAAC;IAAC,QAAQ,EAAC,MAAM,CAAC;IAAC,IAAI,CAAC,EAAC,OAAO,CAAA;CAAE,GAC1D,IAAI,CAYL;AAED,wBAAgB,aAAa,CACzB,YAAY,EAAC,MAAM,EACnB,IAAI,EAAC,YAAY,GACnB,IAAI,CAKL;AAED,wBAAsB,cAAc,CAChC,QAAQ,EAAC,MAAM,EACf,KAAK,EAAC,MAAM,GAAC,MAAM,EAAE,EACrB,OAAO,EAAC,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CA2BjB"}

package/dist/src/retry.d.ts

@@ -0,0 +1,26 @@
+export declare const EFFORT_LADDERS: {
+    readonly pi: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
+    readonly claude: readonly ["low", "medium", "high", "xhigh", "max"];
+    readonly codex: readonly ["low", "medium", "high"];
+};
+export type ProviderName = keyof typeof EFFORT_LADDERS;
+export type EffortLevel = typeof EFFORT_LADDERS[ProviderName][number];
+export declare const ALL_EFFORT_LEVELS: EffortLevel[];
+export declare function escalateEffort(provider: ProviderName, level?: EffortLevel): EffortLevel;
+export declare function retryDelayFor(base: number, attempt: number): number;
+export declare function sleep(ms: number): Promise<void>;
+export type AttemptStep<T> = {
+    result: T;
+    stop: boolean;
+};
+export type RetryOpts = {
+    maxAttempts: number;
+    retryDelay: number;
+    agentCmd: string;
+    effort?: EffortLevel;
+    label: string;
+    log: (msg: string) => void;
+    wait?: (ms: number) => Promise<void>;
+};
+export declare function runWithRetries<T>(opts: RetryOpts, run: (attempt: number, effort: EffortLevel | undefined) => Promise<AttemptStep<T>>): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/src/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/retry.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc;;;;CAMjB,CAAA;AAEV,MAAM,MAAM,YAAY,GACpB,MAAM,OAAO,cAAc,CAAA;AAE/B,MAAM,MAAM,WAAW,GACnB,OAAO,cAAc,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/C,eAAO,MAAM,iBAAiB,EAAC,WAAW,EAGzC,CAAA;AAKD,wBAAgB,cAAc,CAC1B,QAAQ,EAAC,YAAY,EACrB,KAAK,CAAC,EAAC,WAAW,GACpB,WAAW,CASZ;AAED,wBAAgB,aAAa,CAAE,IAAI,EAAC,MAAM,EAAE,OAAO,EAAC,MAAM,GAAE,MAAM,CAEjE;AAED,wBAAgB,KAAK,CAAE,EAAE,EAAC,MAAM,GAAE,OAAO,CAAC,IAAI,CAAC,CAE9C;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAAE,MAAM,EAAC,CAAC,CAAC;IAAC,IAAI,EAAC,OAAO,CAAA;CAAE,CAAA;AAEvD,MAAM,MAAM,SAAS,GAAG;IACpB,WAAW,EAAC,MAAM,CAAA;IAElB,UAAU,EAAC,MAAM,CAAA;IACjB,QAAQ,EAAC,MAAM,CAAA;IAEf,MAAM,CAAC,EAAC,WAAW,CAAA;IAEnB,KAAK,EAAC,MAAM,CAAA;IACZ,GAAG,EAAC,CAAC,GAAG,EAAC,MAAM,KAAK,IAAI,CAAA;IAExB,IAAI,CAAC,EAAC,CAAC,EAAE,EAAC,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACrC,CAAA;AAKD,wBAAsB,cAAc,CAAC,CAAC,EAClC,IAAI,EAAC,SAAS,EACd,GAAG,EAAC,CACA,OAAO,EAAC,MAAM,EACd,MAAM,EAAC,WAAW,GAAC,SAAS,KAC3B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC,CAgCX"}