@on-par/factory-cli 0.0.0-stage → 0.9.0

package/dist/cli/ready-check.js

@@ -0,0 +1,169 @@
+// packages/cli/src/cli/ready-check.ts — read-only `factory check <issue>` report (#1729)
+import { findIssueDependencies, formatCostTotal, gradeIssueCriteria, gradeIssueInvest, scoreIssueReadiness, } from '@on-par/factory-core';
+import { buildDecompositionPrompt, buildReadinessGapPrompt, parseDecompositionOutput, parseReadinessGapOutput, } from '@on-par/factory-core/internal';
+/** Backs `--deep` with a router; captures the call's cost without writing costs.jsonl. */
+export function createDeepModelRunner(router, worktree) {
+    let lastCost = null;
+    router.setCostSink((entry) => {
+        lastCost = entry.cost;
+    });
+    return async (task, prompt) => {
+        lastCost = null;
+        const r = await router.run(task, prompt, { worktree, timeoutSeconds: 600 });
+        return { model: r.model, output: r.output, cost: lastCost };
+    };
+}
+export class DeepCheckError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DeepCheckError';
+    }
+}
+export function buildIssueCheckReport(issue, readiness, criteria = null, invest = null) {
+    const wouldSplit = readiness.sizeOk === false;
+    const size = wouldSplit
+        ? { verdict: 'would-split', reason: readiness.sizeReason ?? 'too big' }
+        : { verdict: 'runs-as-is' };
+    const notReady = !readiness.pass || (criteria !== null && !criteria.pass);
+    const reasons = readiness.missing.map((field) => `missing: ${field}`);
+    reasons.push(...(criteria?.problems ?? []));
+    if (size.reason)
+        reasons.push(size.reason);
+    return {
+        issue,
+        template: readiness.template,
+        score: Math.round(readiness.score * 100),
+        fields: { pass: readiness.pass, missing: [...readiness.missing] },
+        criteria,
+        size,
+        invest,
+        reasons,
+        exitCode: notReady ? 1 : wouldSplit ? 3 : 0,
+    };
+}
+export function formatIssueCheckLines(report) {
+    const lines = [];
+    const state = report.exitCode === 1 ? 'is not factory-ready' : 'is factory-ready';
+    lines.push(`issue #${report.issue} ${state} (${report.template}, score ${report.score}%)`);
+    for (const field of report.fields.missing)
+        lines.push(`  missing: ${field}`);
+    if (report.criteria) {
+        lines.push('criteria:');
+        for (const f of report.criteria.findings) {
+            lines.push(`  ${f.index}. ${f.grade}${f.text ? ` — ${f.text}` : ''}${f.note ? ` (${f.note})` : ''}`);
+        }
+        for (const problem of report.criteria.problems) {
+            if (!/^criterion \d+ is empty$/.test(problem))
+                lines.push(`  ${problem}`);
+        }
+    }
+    lines.push(report.size.verdict === 'would-split' ? `size: would split — ${report.size.reason}` : 'size: runs as-is');
+    if (report.invest) {
+        lines.push('invest:');
+        for (const f of report.invest.findings)
+            lines.push(`  ${f.letter}: ${f.status} — ${f.reason}`);
+    }
+    return lines;
+}
+export function formatGapCriterion(c) {
+    return `${c.name} (When: ${c.when.join('; ')} — Then: ${c.then.join('; ')})`;
+}
+export async function runDeepCheck(input, runModel) {
+    const task = input.wouldSplit ? 'decompose' : 'triage';
+    const prompt = input.wouldSplit
+        ? buildDecompositionPrompt({ title: input.title, body: input.body })
+        : buildReadinessGapPrompt({ title: input.title, body: input.body });
+    let result;
+    try {
+        result = await runModel(task, prompt);
+    }
+    catch (err) {
+        throw new DeepCheckError(`model call failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const unpriced = result.cost === null;
+    if (input.wouldSplit) {
+        const parsed = parseDecompositionOutput(result.output);
+        if (!parsed.ok)
+            throw new DeepCheckError(`model returned invalid output: ${parsed.reason}`);
+        const children = parsed.decomposition.stories.map((s) => ({
+            title: s.title,
+            acceptanceCriteria: s.acceptanceCriteria.map(formatGapCriterion),
+        }));
+        return { kind: 'split', model: result.model, cost: result.cost, unpriced, children };
+    }
+    const parsed = parseReadinessGapOutput(result.output);
+    if (!parsed.ok)
+        throw new DeepCheckError(`model returned invalid output: ${parsed.reason}`);
+    return { kind: 'gaps', model: result.model, cost: result.cost, unpriced, gaps: parsed.gaps };
+}
+export function formatDeepCheckLines(deep) {
+    const lines = [];
+    if (deep.kind === 'split') {
+        lines.push(`deep: proposed split (preview only — nothing filed), ${deep.children.length} child stories`);
+        deep.children.forEach((child, i) => {
+            lines.push(`  ${i + 1}. ${child.title}`);
+            for (const c of child.acceptanceCriteria)
+                lines.push(`     - ${c}`);
+        });
+    }
+    else {
+        lines.push('deep: suggested missing criteria');
+        if (deep.gaps.missingCriteria.length === 0)
+            lines.push('  (none)');
+        for (const c of deep.gaps.missingCriteria)
+            lines.push(`  - ${formatGapCriterion(c)}`);
+        const sections = [
+            ['unclear scope:', deep.gaps.unclearScope],
+            ['negotiable:', deep.gaps.negotiable],
+            ['estimable:', deep.gaps.estimable],
+        ];
+        for (const [label, items] of sections) {
+            if (items.length === 0)
+                continue;
+            lines.push(label);
+            for (const item of items)
+                lines.push(`  - ${item}`);
+        }
+    }
+    lines.push(`model: ${deep.model}, cost: ${formatCostTotal(deep.cost, deep.unpriced ? 1 : 0)}`);
+    return lines;
+}
+export async function runIssueCheck(issue, opts, deps) {
+    const { title, body } = await deps.getIssue(issue);
+    const readiness = scoreIssueReadiness({ title, body: body ?? '' });
+    const criteria = readiness.template === 'factory-task' ? gradeIssueCriteria(body ?? '') : null;
+    let invest = null;
+    if (readiness.template === 'factory-task') {
+        const states = new Map();
+        await Promise.all(findIssueDependencies(body ?? '').map(async (n) => {
+            let state = 'unknown';
+            try {
+                if (deps.getIssueState)
+                    state = await deps.getIssueState(n);
+            }
+            catch {
+                // a failed lookup is advisory only — leave the dependency 'unknown'
+            }
+            states.set(n, state);
+        }));
+        invest = gradeIssueInvest(body ?? '', states);
+    }
+    const report = buildIssueCheckReport(issue, readiness, criteria, invest);
+    if (opts.deep) {
+        if (!deps.runModel)
+            throw new DeepCheckError('no model runner configured');
+        report.deep = await runDeepCheck({ title, body: body ?? '', wouldSplit: report.size.verdict === 'would-split' }, deps.runModel);
+    }
+    if (opts.json) {
+        deps.log(JSON.stringify(report));
+    }
+    else {
+        for (const line of formatIssueCheckLines(report))
+            deps.log(line);
+        if (report.deep)
+            for (const line of formatDeepCheckLines(report.deep))
+                deps.log(line);
+    }
+    return report;
+}
+//# sourceMappingURL=ready-check.js.map

package/dist/cli/ready-check.js.map

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

package/dist/cli/reset.d.ts

@@ -0,0 +1,40 @@
+import { type PortLease } from '@on-par/factory-core';
+export interface ResetDeps {
+    repoRoot: string;
+    /** process.cwd() in prod — the worktree containing it is never removed. */
+    cwd: string;
+    paths: {
+        plans: string;
+        runs: string;
+        logs: string;
+        reworkHistory: string;
+        laneFiles: string;
+    };
+    branchPrefix?: string;
+    /** Runs a shell command in repoRoot and returns stdout; throws on failure. */
+    git: (cmd: string) => Promise<string>;
+    removeWorktree: (path: string) => Promise<void>;
+    readLeases: () => PortLease[];
+    releaseLease: (worktreeId: string) => Promise<void>;
+    /** Runs a command (cwd defaults to repoRoot in prod); used for the read-only dirty/unpushed probes. */
+    runCommand: (cmd: string, opts?: {
+        cwd?: string;
+    }) => Promise<{
+        stdout: string;
+    }>;
+    /** Preview only: discover and report, never mutate. */
+    dryRun?: boolean;
+    /** Remove worktrees and branches even when dirty or unpushed (#1789). */
+    force?: boolean;
+}
+export interface ResetResult {
+    issue: number;
+    removed: string[];
+    kept: string[];
+    dryRun?: boolean;
+}
+export declare function parseResetIssues(raw: string[]): number[];
+export declare function resetIssue(issue: number, deps: ResetDeps): Promise<ResetResult>;
+export declare function formatResetLine(r: ResetResult): string;
+export declare function runReset(issues: number[], deps: ResetDeps): Promise<string[]>;
+//# sourceMappingURL=reset.d.ts.map

package/dist/cli/reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.d.ts","sourceRoot":"","sources":["../../src/cli/reset.ts"],"names":[],"mappings":"AAMA,OAAO,EAAoC,KAAK,SAAS,EAAiB,MAAM,sBAAsB,CAAC;AAQvG,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,UAAU,EAAE,MAAM,SAAS,EAAE,CAAC;IAC9B,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,uGAAuG;IACvG,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClF,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAQxD;AAeD,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAmJrF;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAOtD;AAED,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAInF"}

package/dist/cli/reset.js

@@ -0,0 +1,215 @@
+// packages/cli/src/cli/reset.ts — `factory reset <issue...>`: remove an issue's local factory state (#1787);
+// dirty/unpushed worktrees and branches are kept unless --force (#1789).
+import { existsSync, rmSync } from 'node:fs';
+import { join, resolve, sep } from 'node:path';
+import { LaneFileGuard, phaseSnapshotFile, ReworkHistory } from '@on-par/factory-core';
+import { countUnpushedCommits, factoryBranchIssue, isWorktreeClean, parseWorktreeList, } from '@on-par/factory-core/internal';
+export function parseResetIssues(raw) {
+    const out = [];
+    for (const v of raw) {
+        if (!/^\d+$/.test(v) || Number(v) <= 0)
+            throw new Error(`factory reset: "${v}" is not an issue number`);
+        const n = Number(v);
+        if (!out.includes(n))
+            out.push(n);
+    }
+    return out;
+}
+const errText = (err) => (err instanceof Error ? err.message : String(err));
+const shellQuote = (s) => `'${s.replace(/'/g, `'\\''`)}'`;
+/** Why removing this worktree/branch would lose work, or null when it is safe (same probes as `worktree gc`). */
+async function unsafeReason(deps, path, rev) {
+    if (path !== null && !(await isWorktreeClean(deps.runCommand, path)))
+        return 'uncommitted changes';
+    if (rev === null)
+        return 'could not verify it is pushed';
+    const n = await countUnpushedCommits(deps.runCommand, deps.repoRoot, rev);
+    if (n === null)
+        return 'could not verify it is pushed';
+    return n > 0 ? `${n} unpushed commit(s)` : null;
+}
+export async function resetIssue(issue, deps) {
+    const { paths, branchPrefix } = deps;
+    const dry = deps.dryRun === true;
+    const removed = [];
+    const kept = [];
+    const protectedBranches = new Map();
+    const removedWorktrees = new Set();
+    // 1. Worktrees
+    try {
+        const entries = parseWorktreeList(await deps.git('git worktree list --porcelain'));
+        for (const entry of entries) {
+            if (entry.branch === null || factoryBranchIssue(entry.branch, branchPrefix) !== issue)
+                continue;
+            const isMain = resolve(entry.path) === resolve(deps.repoRoot);
+            const hasCwd = deps.cwd === entry.path || deps.cwd.startsWith(entry.path + sep);
+            if (isMain || hasCwd) {
+                kept.push(`worktree ${entry.path} (current checkout)`);
+                protectedBranches.set(entry.branch, entry.path);
+                continue;
+            }
+            if (!deps.force) {
+                const why = await unsafeReason(deps, entry.path, entry.head ?? entry.branch);
+                if (why !== null) {
+                    kept.push(`worktree ${entry.path} (${why}; pass --force to remove)`);
+                    protectedBranches.set(entry.branch, entry.path);
+                    continue;
+                }
+            }
+            try {
+                if (!dry)
+                    await deps.removeWorktree(entry.path);
+                removed.push(`worktree ${entry.path}`);
+                removedWorktrees.add(entry.path);
+            }
+            catch (err) {
+                kept.push(`worktree ${entry.path} (${errText(err)})`);
+                protectedBranches.set(entry.branch, entry.path);
+            }
+        }
+    }
+    catch (err) {
+        kept.push(`worktrees (git worktree list failed: ${errText(err)})`);
+    }
+    // 2. Local branches
+    try {
+        const refs = await deps.git("git for-each-ref --format='%(refname:short)' refs/heads/");
+        const branches = refs
+            .split('\n')
+            .map((b) => b.trim())
+            .filter((b) => b && factoryBranchIssue(b, branchPrefix) === issue);
+        for (const b of branches) {
+            const where = protectedBranches.get(b);
+            if (where !== undefined) {
+                kept.push(`branch ${b} (checked out in ${where})`);
+                continue;
+            }
+            if (!deps.force) {
+                const why = await unsafeReason(deps, null, b);
+                if (why !== null) {
+                    kept.push(`branch ${b} (${why}; pass --force to remove)`);
+                    continue;
+                }
+            }
+            try {
+                if (!dry)
+                    await deps.git(`git branch -D ${shellQuote(b)}`);
+                removed.push(`branch ${b}`);
+            }
+            catch (err) {
+                kept.push(`branch ${b} (${errText(err)})`);
+            }
+        }
+    }
+    catch (err) {
+        kept.push(`branches (${errText(err)})`);
+    }
+    // 3. Plan files
+    try {
+        let count = 0;
+        for (const ext of ['md', 'design.json', 'design.md', 'adr.json']) {
+            const file = join(paths.plans, `issue-${issue}.${ext}`);
+            if (!existsSync(file))
+                continue;
+            if (dry)
+                removed.push(`plan file ${file}`);
+            else
+                rmSync(file, { force: true });
+            count++;
+        }
+        if (!dry && count > 0)
+            removed.push(`plan files (${count})`);
+    }
+    catch (err) {
+        kept.push(`plan files (${errText(err)})`);
+    }
+    // 4. Phase file
+    try {
+        const file = phaseSnapshotFile(paths.runs, issue);
+        if (existsSync(file)) {
+            if (!dry)
+                rmSync(file, { force: true });
+            removed.push(dry ? `phase file ${file}` : 'phase file');
+        }
+    }
+    catch (err) {
+        kept.push(`phase file (${errText(err)})`);
+    }
+    // 5. Rework history
+    try {
+        const history = new ReworkHistory(paths.reworkHistory);
+        if (dry) {
+            if ((await history.priorSignature(issue)) !== undefined)
+                removed.push(`rework history entry #${issue}`);
+        }
+        else if (await history.clear(issue))
+            removed.push('rework history');
+    }
+    catch (err) {
+        kept.push(`rework history (${errText(err)})`);
+    }
+    // 6. Logs
+    try {
+        const dir = join(paths.logs, `issue-${issue}`);
+        if (existsSync(dir)) {
+            if (!dry)
+                rmSync(dir, { recursive: true, force: true });
+            removed.push(dry ? `logs ${dir}` : 'logs');
+        }
+    }
+    catch (err) {
+        kept.push(`logs (${errText(err)})`);
+    }
+    // 7. Lane-file claim
+    try {
+        const guard = new LaneFileGuard(paths.laneFiles);
+        if (dry) {
+            for (const c of await guard.claimsForIssue(issue))
+                removed.push(`lane-file claim ${c.repo}#${c.issue}`);
+        }
+        else if (await guard.releaseIssue(issue))
+            removed.push('lane-file claim');
+    }
+    catch (err) {
+        kept.push(`lane-file claim (${errText(err)})`);
+    }
+    // 8. Port leases — never for a kept worktree
+    try {
+        const keptPaths = new Set(protectedBranches.values());
+        for (const lease of deps.readLeases()) {
+            if (keptPaths.has(lease.worktreeId))
+                continue;
+            if (!removedWorktrees.has(lease.worktreeId) && factoryBranchIssue(lease.branch, branchPrefix) !== issue)
+                continue;
+            try {
+                if (!dry)
+                    await deps.releaseLease(lease.worktreeId);
+                removed.push(`port lease ${lease.port}`);
+            }
+            catch (err) {
+                kept.push(`port lease ${lease.port} (${errText(err)})`);
+            }
+        }
+    }
+    catch (err) {
+        kept.push(`port leases (${errText(err)})`);
+    }
+    return { issue, removed, kept, ...(dry ? { dryRun: true } : {}) };
+}
+export function formatResetLine(r) {
+    if (r.dryRun) {
+        if (r.removed.length === 0 && r.kept.length === 0)
+            return `#${r.issue} (dry run): nothing to reset`;
+        return `#${r.issue} (dry run): would remove ${r.removed.join(', ') || 'nothing'}; would keep ${r.kept.join(', ') || 'nothing'}`;
+    }
+    if (r.removed.length === 0 && r.kept.length === 0)
+        return `#${r.issue}: nothing to reset`;
+    return `#${r.issue}: removed ${r.removed.join(', ') || 'nothing'}; kept ${r.kept.join(', ') || 'nothing'}`;
+}
+export async function runReset(issues, deps) {
+    const lines = [];
+    for (const issue of issues)
+        lines.push(formatResetLine(await resetIssue(issue, deps)));
+    return lines;
+}
+//# sourceMappingURL=reset.js.map

package/dist/cli/reset.js.map

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

package/dist/cli/run-children.d.ts

@@ -0,0 +1,24 @@
+/** One decomposed child's outcome. `ready` means its PR is open and ready for review. */
+export interface ChildRunResult {
+    issue: number;
+    status: 'ready' | 'failed' | 'not-run' | 'skipped' | 'decomposed';
+    prNumber?: number;
+    /** Failure detail for `failed`; the skip reason for `skipped`; why it did not start for `not-run`. */
+    detail?: string;
+    /** Child issues filed when this child was itself decomposed (`decomposed` only). */
+    children?: number[];
+}
+/** Runs children strictly one at a time in the given (build) order. A child that decomposes again
+ *  is replaced in place by its fresh children, which run before the remaining siblings; issues in
+ *  the seen set (`alreadySeen`, the initial children, anything already expanded) never run twice.
+ *  A `skipped` or `failed` child does not stop the sequence: failures are recorded and the next
+ *  child still runs. A `runChild` that throws is recorded as `failed` with the error message.
+ *  `shouldStop` is consulted before each child starts; once it returns true that child and every
+ *  later one are marked `not-run` and never run. A child already running is never interrupted. */
+export declare function runChildrenInOrder(children: readonly number[], runChild: (issue: number) => Promise<ChildRunResult>, alreadySeen?: Iterable<number>, shouldStop?: (nextIssue: number) => boolean): Promise<ChildRunResult[]>;
+/** True when every child that ran reached ready-for-review, was skipped as closed, or was
+ *  replaced by its own children. */
+export declare function childRunSucceeded(results: readonly ChildRunResult[]): boolean;
+/** Renders the per-child summary lines; the caller colours and prints them. */
+export declare function formatChildRunSummary(parent: number, results: readonly ChildRunResult[]): string[];
+//# sourceMappingURL=run-children.d.ts.map

package/dist/cli/run-children.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-children.d.ts","sourceRoot":"","sources":["../../src/cli/run-children.ts"],"names":[],"mappings":"AAEA,yFAAyF;AACzF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sGAAsG;IACtG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAID;;;;;;kGAMkG;AAClG,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,EACpD,WAAW,GAAE,QAAQ,CAAC,MAAM,CAAM,EAClC,UAAU,GAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAqB,GACvD,OAAO,CAAC,cAAc,EAAE,CAAC,CA0B3B;AAED;oCACoC;AACpC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO,CAE7E;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,EAAE,CAwBlG"}

package/dist/cli/run-children.js

@@ -0,0 +1,73 @@
+// Sequencing and summary for `run-issue --run-children` (#1747, #1748).
+const STOP_DETAIL = '.factory/STOP present';
+/** Runs children strictly one at a time in the given (build) order. A child that decomposes again
+ *  is replaced in place by its fresh children, which run before the remaining siblings; issues in
+ *  the seen set (`alreadySeen`, the initial children, anything already expanded) never run twice.
+ *  A `skipped` or `failed` child does not stop the sequence: failures are recorded and the next
+ *  child still runs. A `runChild` that throws is recorded as `failed` with the error message.
+ *  `shouldStop` is consulted before each child starts; once it returns true that child and every
+ *  later one are marked `not-run` and never run. A child already running is never interrupted. */
+export async function runChildrenInOrder(children, runChild, alreadySeen = [], shouldStop = () => false) {
+    const queue = [...children];
+    const seen = new Set([...alreadySeen, ...children]);
+    const results = [];
+    let stopped = false;
+    for (let i = 0; i < queue.length; i++) {
+        const issue = queue[i];
+        if (!stopped && shouldStop(issue))
+            stopped = true;
+        if (stopped) {
+            results.push({ issue, status: 'not-run', detail: STOP_DETAIL });
+            continue;
+        }
+        let result;
+        try {
+            result = await runChild(issue);
+        }
+        catch (err) {
+            result = { issue, status: 'failed', detail: err instanceof Error ? err.message : String(err) };
+        }
+        results.push(result);
+        if (result.status === 'decomposed') {
+            const fresh = (result.children ?? []).filter((n) => !seen.has(n));
+            for (const n of fresh)
+                seen.add(n);
+            queue.splice(i + 1, 0, ...fresh);
+        }
+    }
+    return results;
+}
+/** True when every child that ran reached ready-for-review, was skipped as closed, or was
+ *  replaced by its own children. */
+export function childRunSucceeded(results) {
+    return results.every((r) => r.status === 'ready' || r.status === 'skipped' || r.status === 'decomposed');
+}
+/** Renders the per-child summary lines; the caller colours and prints them. */
+export function formatChildRunSummary(parent, results) {
+    const lines = [`Children of #${parent}:`];
+    for (const r of results) {
+        if (r.status === 'ready') {
+            lines.push(r.prNumber !== undefined
+                ? `  #${r.issue} → PR #${r.prNumber} ready for review`
+                : `  #${r.issue} → ready (no PR number)`);
+        }
+        else if (r.status === 'failed') {
+            lines.push(r.detail ? `  #${r.issue} → failed: ${r.detail}` : `  #${r.issue} → failed`);
+        }
+        else if (r.status === 'skipped') {
+            lines.push(r.detail ? `  #${r.issue} → skipped: ${r.detail}` : `  #${r.issue} → skipped`);
+        }
+        else if (r.status === 'decomposed') {
+            lines.push(`  #${r.issue} → decomposed into ${(r.children ?? []).map((n) => `#${n}`).join(', ')}`);
+        }
+        else {
+            lines.push(r.detail ? `  #${r.issue} → not run: ${r.detail}` : `  #${r.issue} → not run`);
+        }
+    }
+    const leaf = results.filter((r) => r.status !== 'decomposed');
+    const ready = leaf.filter((r) => r.status === 'ready').length;
+    const skipped = leaf.filter((r) => r.status === 'skipped').length;
+    lines.push(`${ready}/${leaf.length} children ready for review${skipped > 0 ? `, ${skipped} skipped` : ''}`);
+    return lines;
+}
+//# sourceMappingURL=run-children.js.map

package/dist/cli/run-children.js.map

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

package/dist/cli/run-flags.d.ts

@@ -0,0 +1,14 @@
+/** Flags an operator supplied explicitly on this invocation. `undefined` = not supplied. */
+export interface RunFlagOverrides {
+    autoMerge?: boolean;
+    /** `--pr-classifier` / `--no-pr-classifier` (#1724). */
+    prClassifier?: boolean;
+}
+/** Read the recorded overrides. Fails soft: a missing, unreadable, non-JSON, non-object,
+ *  or wrongly-typed file reads as "no override" rather than throwing, so a corrupt state
+ *  file can never break `factory status` or a run. */
+export declare function readRunFlagOverrides(file: string): RunFlagOverrides;
+/** Record the overrides for this invocation. Writing an all-`undefined` set removes the
+ *  file, so a flag from an earlier run can never leak into a later flagless one. */
+export declare function writeRunFlagOverrides(file: string, overrides: RunFlagOverrides): void;
+//# sourceMappingURL=run-flags.d.ts.map

package/dist/cli/run-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-flags.d.ts","sourceRoot":"","sources":["../../src/cli/run-flags.ts"],"names":[],"mappings":"AAMA,4FAA4F;AAC5F,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wDAAwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;sDAEsD;AACtD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAcnE;AAED;oFACoF;AACpF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAUrF"}

package/dist/cli/run-flags.js

@@ -0,0 +1,43 @@
+// packages/cli/src/cli/run-flags.ts — per-invocation CLI flag overrides, recorded so a
+// separate `factory status` process can attribute a run's policy to the flag (#1400).
+import { existsSync, mkdirSync, rmSync, writeFileSync, readFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+/** Read the recorded overrides. Fails soft: a missing, unreadable, non-JSON, non-object,
+ *  or wrongly-typed file reads as "no override" rather than throwing, so a corrupt state
+ *  file can never break `factory status` or a run. */
+export function readRunFlagOverrides(file) {
+    if (!existsSync(file))
+        return {};
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(file, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+        return {};
+    const { autoMerge, prClassifier } = raw;
+    const overrides = {};
+    if (typeof autoMerge === 'boolean')
+        overrides.autoMerge = autoMerge;
+    if (typeof prClassifier === 'boolean')
+        overrides.prClassifier = prClassifier;
+    return overrides;
+}
+/** Record the overrides for this invocation. Writing an all-`undefined` set removes the
+ *  file, so a flag from an earlier run can never leak into a later flagless one. */
+export function writeRunFlagOverrides(file, overrides) {
+    const recorded = {};
+    if (overrides.autoMerge !== undefined)
+        recorded.autoMerge = overrides.autoMerge;
+    if (overrides.prClassifier !== undefined)
+        recorded.prClassifier = overrides.prClassifier;
+    if (Object.keys(recorded).length === 0) {
+        rmSync(file, { force: true });
+        return;
+    }
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, `${JSON.stringify(recorded, null, 2)}\n`);
+}
+//# sourceMappingURL=run-flags.js.map

package/dist/cli/run-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-flags.js","sourceRoot":"","sources":["../../src/cli/run-flags.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,sFAAsF;AAEtF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC;;sDAEsD;AACtD,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7E,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,GAAsD,CAAC;IAC3F,MAAM,SAAS,GAAqB,EAAE,CAAC;IACvC,IAAI,OAAO,SAAS,KAAK,SAAS;QAAE,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC;IACpE,IAAI,OAAO,YAAY,KAAK,SAAS;QAAE,SAAS,CAAC,YAAY,GAAG,YAAY,CAAC;IAC7E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;oFACoF;AACpF,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,SAA2B;IAC7E,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS;QAAE,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;IAChF,IAAI,SAAS,CAAC,YAAY,KAAK,SAAS;QAAE,QAAQ,CAAC,YAAY,GAAG,SAAS,CAAC,YAAY,CAAC;IACzF,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IACD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC"}