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

package/LICENSE

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

package/README.md

@@ -1,3 +1,24 @@
-# Temporary Holding Version
+# @on-par/factory-cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The `factory` command: ships verified GitHub issues via boss-worker-checker orchestration.
+
+Part of [Software Factory](https://github.com/on-par/software-factory), a multi-agent factory that ships verified work autonomously. Most users want the CLI, [`@on-par/factory-cli`](https://www.npmjs.com/package/@on-par/factory-cli); the other packages are its building blocks.
+
+## Install
+
+```bash
+npm install -g @on-par/factory-cli
+factory --help
+```
+
+Requires Node.js >= 24, `git`, and an authenticated GitHub CLI (`gh`). See the [Quick Start](https://github.com/on-par/software-factory#quick-start-5-minutes) for model CLIs and first-run setup.
+
+## Documentation
+
+- [README and Quick Start](https://github.com/on-par/software-factory#readme)
+- [Architecture and package graph](https://github.com/on-par/software-factory/blob/main/docs/architecture.md)
+- [Changelog](https://github.com/on-par/software-factory/blob/main/CHANGELOG.md)
+
+## License
+
+MIT. See [LICENSE](./LICENSE).

package/dist/cli/admission.d.ts

@@ -0,0 +1,17 @@
+import { type AdmissionStateReader, type QueueCompatibilityVerdict, type QueueSnapshot } from '@on-par/factory-core/internal';
+export interface QueueAdmissionRow {
+    lane: string;
+    issue: number;
+    verdict: QueueCompatibilityVerdict;
+}
+export declare function admissionStateReaderFor(stateDir: string): AdmissionStateReader;
+export declare function formatQueueAdmissionReport(rows: readonly QueueAdmissionRow[]): string;
+export declare function runQueueReconcile(deps: {
+    readSnapshot: () => Promise<QueueSnapshot>;
+    reader: AdmissionStateReader;
+    lane?: string;
+}): Promise<{
+    report: string;
+    conflicts: number;
+}>;
+//# sourceMappingURL=admission.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"admission.d.ts","sourceRoot":"","sources":["../../src/cli/admission.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,aAAa,EACnB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,yBAAyB,CAAC;CACpC;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CAE9E;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,SAAS,iBAAiB,EAAE,GAAG,MAAM,CAgBrF;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,YAAY,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3C,MAAM,EAAE,oBAAoB,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBjD"}

package/dist/cli/admission.js

@@ -0,0 +1,37 @@
+// packages/cli/src/cli/admission.ts — Factory App admission-state reader wiring + `factory queue reconcile` (#1497).
+import { classifyQueueCompatibility, createFileAdmissionStateReader, formatAdmissionConflict, } from '@on-par/factory-core/internal';
+export function admissionStateReaderFor(stateDir) {
+    return createFileAdmissionStateReader({ stateDir });
+}
+export function formatQueueAdmissionReport(rows) {
+    const conflicts = rows.filter((row) => row.verdict.kind === 'refuse');
+    const lines = [`queue reconcile — ${rows.length} queued issue(s), ${conflicts.length} conflict(s)`];
+    if (conflicts.length === 0) {
+        lines.push('  no Factory App admission conflicts — the GitHub label queue is authoritative here');
+        return lines.join('\n');
+    }
+    for (const row of conflicts) {
+        const verdict = row.verdict;
+        const [head, ...rest] = formatAdmissionConflict(row.issue, verdict).split('\n');
+        lines.push(`  [${row.lane}] ${head}`, ...rest.map((line) => `  ${line}`));
+    }
+    return lines.join('\n');
+}
+export async function runQueueReconcile(deps) {
+    const snapshot = await deps.readSnapshot();
+    const entries = deps.lane === undefined ? snapshot.entries : snapshot.entries.filter((entry) => entry.lane === deps.lane);
+    const rows = [];
+    for (const entry of entries) {
+        let lookup;
+        try {
+            lookup = await deps.reader.read(entry.issue);
+        }
+        catch (err) {
+            lookup = { kind: 'unreadable', detail: err instanceof Error ? err.message : String(err) };
+        }
+        rows.push({ lane: entry.lane, issue: entry.issue, verdict: classifyQueueCompatibility(entry.issue, lookup) });
+    }
+    const conflicts = rows.filter((row) => row.verdict.kind === 'refuse').length;
+    return { report: formatQueueAdmissionReport(rows), conflicts };
+}
+//# sourceMappingURL=admission.js.map

package/dist/cli/admission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admission.js","sourceRoot":"","sources":["../../src/cli/admission.ts"],"names":[],"mappings":"AAAA,qHAAqH;AAErH,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,uBAAuB,GAIxB,MAAM,+BAA+B,CAAC;AAQvC,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,OAAO,8BAA8B,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAkC;IAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IACtE,MAAM,KAAK,GAAG,CAAC,qBAAqB,IAAI,CAAC,MAAM,qBAAqB,SAAS,CAAC,MAAM,cAAc,CAAC,CAAC;IAEpG,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,qFAAqF,CAAC,CAAC;QAClG,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAiE,CAAC;QACtF,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,uBAAuB,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAIvC;IACC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;IAC3C,MAAM,OAAO,GACX,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5G,MAAM,IAAI,GAAwB,EAAE,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,EAAE,IAAI,EAAE,YAAqB,EAAE,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACrG,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,0BAA0B,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAChH,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;IAC7E,OAAO,EAAE,MAAM,EAAE,0BAA0B,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;AACjE,CAAC"}

package/dist/cli/branch-prefix.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from 'commander';
+export declare const BRANCH_PREFIX_OPTION_DESCRIPTION = "Branch-name prefix for branches this command creates (default: factory)";
+export declare const BRANCH_PREFIX_MATCH_OPTION_DESCRIPTION = "Branch-name prefix of factory branches to act on; legacy ship-it/ branches are always included (default: factory)";
+export declare const INVALID_BRANCH_PREFIX_MESSAGE = "factory: --branch-prefix must contain at least one letter or digit";
+/** undefined -> resolveBranchPrefix(); otherwise the slug-normalized value; null when it has no [a-z0-9]. */
+export declare function resolveBranchPrefixOption(raw: string | undefined): string | null;
+export declare function addBranchPrefixOption(cmd: Command): Command;
+//# sourceMappingURL=branch-prefix.d.ts.map

package/dist/cli/branch-prefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-prefix.d.ts","sourceRoot":"","sources":["../../src/cli/branch-prefix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,eAAO,MAAM,gCAAgC,4EAC8B,CAAC;AAC5E,eAAO,MAAM,sCAAsC,sHAAsI,CAAC;AAC1L,eAAO,MAAM,6BAA6B,uEAAuE,CAAC;AAElH,6GAA6G;AAC7G,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAIhF;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE3D"}

package/dist/cli/branch-prefix.js

@@ -0,0 +1,16 @@
+import { LEGACY_BRANCH_PREFIX, branchPrefixSlug, resolveBranchPrefix, slugify } from '@on-par/factory-core/internal';
+export const BRANCH_PREFIX_OPTION_DESCRIPTION = 'Branch-name prefix for branches this command creates (default: factory)';
+export const BRANCH_PREFIX_MATCH_OPTION_DESCRIPTION = `Branch-name prefix of factory branches to act on; legacy ${LEGACY_BRANCH_PREFIX}/ branches are always included (default: factory)`;
+export const INVALID_BRANCH_PREFIX_MESSAGE = 'factory: --branch-prefix must contain at least one letter or digit';
+/** undefined -> resolveBranchPrefix(); otherwise the slug-normalized value; null when it has no [a-z0-9]. */
+export function resolveBranchPrefixOption(raw) {
+    if (raw === undefined)
+        return resolveBranchPrefix();
+    if (slugify(raw) === '')
+        return null;
+    return branchPrefixSlug(raw);
+}
+export function addBranchPrefixOption(cmd) {
+    return cmd.option('--branch-prefix <prefix>', BRANCH_PREFIX_OPTION_DESCRIPTION);
+}
+//# sourceMappingURL=branch-prefix.js.map

package/dist/cli/branch-prefix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-prefix.js","sourceRoot":"","sources":["../../src/cli/branch-prefix.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAErH,MAAM,CAAC,MAAM,gCAAgC,GAC3C,yEAAyE,CAAC;AAC5E,MAAM,CAAC,MAAM,sCAAsC,GAAG,4DAA4D,oBAAoB,mDAAmD,CAAC;AAC1L,MAAM,CAAC,MAAM,6BAA6B,GAAG,oEAAoE,CAAC;AAElH,6GAA6G;AAC7G,MAAM,UAAU,yBAAyB,CAAC,GAAuB;IAC/D,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,mBAAmB,EAAE,CAAC;IACpD,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,OAAO,GAAG,CAAC,MAAM,CAAC,0BAA0B,EAAE,gCAAgC,CAAC,CAAC;AAClF,CAAC"}

package/dist/cli/classifier-backtest.d.ts

@@ -0,0 +1,50 @@
+import { type DefectSourceClient, type FactoryEvent, type getFactoryPaths, type HumanSourceClient, type ModelRouter } from '@on-par/factory-core';
+import { type ReviewFloorRuleSet } from '@on-par/factory-core/internal';
+export interface ClassifierBacktestOptions {
+    since: string;
+    limit?: string;
+    labels?: string;
+    maxCost?: string;
+    json?: boolean;
+    branchPrefix?: string;
+}
+export interface ClassifierBacktestDeps {
+    repoRoot: string;
+    paths: ReturnType<typeof getFactoryPaths>;
+    owner: string;
+    repo: string;
+    octokit: HumanSourceClient & DefectSourceClient & {
+        rest: {
+            issues: {
+                get(params: {
+                    owner: string;
+                    repo: string;
+                    issue_number: number;
+                }): Promise<{
+                    data: any;
+                }>;
+            };
+        };
+    };
+    router: ModelRouter;
+    rules: ReviewFloorRuleSet;
+    modelPin?: string;
+    windowDays: number;
+    /** git, run in repoRoot. */
+    exec(cmd: string): Promise<{
+        stdout: string;
+    }>;
+    readFile(path: string): string;
+    appendFile(path: string, text: string): void;
+    ensureDir(path: string): void;
+    /** Reads the local events log; [] when it does not exist. */
+    readEvents(path: string): FactoryEvent[];
+    now(): string;
+    log(line: string): void;
+}
+/** Bad command-line input; the caller maps it to exit code 2. */
+export declare class ClassifierBacktestInputError extends Error {
+    constructor(message: string);
+}
+export declare function cmdClassifierBacktest(opts: ClassifierBacktestOptions, deps: ClassifierBacktestDeps): Promise<void>;
+//# sourceMappingURL=classifier-backtest.d.ts.map

package/dist/cli/classifier-backtest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier-backtest.d.ts","sourceRoot":"","sources":["../../src/cli/classifier-backtest.ts"],"names":[],"mappings":"AAIA,OAAO,EAQL,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAOL,KAAK,kBAAkB,EACxB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,iBAAiB,GACxB,kBAAkB,GAAG;QACnB,IAAI,EAAE;YAAE,MAAM,EAAE;gBAAE,GAAG,CAAC,MAAM,EAAE;oBAAE,KAAK,EAAE,MAAM,CAAC;oBAAC,IAAI,EAAE,MAAM,CAAC;oBAAC,YAAY,EAAE,MAAM,CAAA;iBAAE,GAAG,OAAO,CAAC;oBAAE,IAAI,EAAE,GAAG,CAAA;iBAAE,CAAC,CAAA;aAAE,CAAA;SAAE,CAAC;KAClH,CAAC;IACJ,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,6DAA6D;IAC7D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IACzC,GAAG,IAAI,MAAM,CAAC;IACd,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,iEAAiE;AACjE,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAkCD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,yBAAyB,EAC/B,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA8Ef"}

package/dist/cli/classifier-backtest.js

@@ -0,0 +1,112 @@
+// packages/cli/src/cli/classifier-backtest.ts — `factory classifier backtest`: replay the floor + shadow classifier over merged PRs (#1728)
+import { join } from 'node:path';
+import { styleText } from 'node:util';
+import { detectPostMergeDefects, fetchDefectSources, fetchHumanEventSources, formatClassifierReport, mergedPrRefs, reconstructHumanEvents, summarizeClassifierOutcomes, } from '@on-par/factory-core';
+import { backtestFileName, classifiedRecords, parseBacktestLabels, runClassifierBacktest, selectBacktestPrs, } from '@on-par/factory-core/internal';
+/** Bad command-line input; the caller maps it to exit code 2. */
+export class ClassifierBacktestInputError extends Error {
+    constructor(message) {
+        super(`factory: ${message}`);
+        this.name = 'ClassifierBacktestInputError';
+    }
+}
+const SHA_PATTERN = /^[0-9a-f]{7,40}$/i;
+function validateOptions(opts) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(opts.since) || Number.isNaN(Date.parse(opts.since))) {
+        throw new ClassifierBacktestInputError(`invalid --since '${opts.since}' — expected YYYY-MM-DD`);
+    }
+    let limit;
+    if (opts.limit !== undefined) {
+        limit = Number(opts.limit);
+        if (!/^\d+$/.test(opts.limit) || limit < 1) {
+            throw new ClassifierBacktestInputError(`invalid --limit '${opts.limit}' — expected a positive integer`);
+        }
+    }
+    let maxCost;
+    if (opts.maxCost !== undefined) {
+        maxCost = Number(opts.maxCost);
+        if (opts.maxCost.trim() === '' || !Number.isFinite(maxCost) || maxCost <= 0) {
+            throw new ClassifierBacktestInputError(`invalid --max-cost '${opts.maxCost}' — expected a number of USD > 0`);
+        }
+    }
+    return { limit, maxCost };
+}
+function loadLabels(opts, deps) {
+    if (opts.labels === undefined)
+        return new Map();
+    try {
+        return parseBacktestLabels(deps.readFile(opts.labels));
+    }
+    catch (err) {
+        throw new ClassifierBacktestInputError(`--labels ${opts.labels}: ${err?.message ?? err}`);
+    }
+}
+export async function cmdClassifierBacktest(opts, deps) {
+    const { limit, maxCost } = validateOptions(opts);
+    const labels = loadLabels(opts, deps);
+    const now = deps.now();
+    const { owner, repo, paths } = deps;
+    const sources = await fetchHumanEventSources(deps.octokit, owner, repo, null, opts.branchPrefix);
+    const selected = selectBacktestPrs(sources, { since: opts.since, limit });
+    if (selected.length === 0) {
+        deps.log(`No merged factory PRs since ${opts.since}.`);
+        return;
+    }
+    const local = deps.readEvents(paths.events);
+    let events = [...local, ...reconstructHumanEvents(selected, local)];
+    try {
+        const defectSources = await fetchDefectSources(deps.octokit, owner, repo, mergedPrRefs(selected), {
+            now,
+            windowDays: deps.windowDays,
+        });
+        events = [...events, ...detectPostMergeDefects(defectSources, events, { now, windowDays: deps.windowDays })];
+    }
+    catch (err) {
+        console.error(styleText('yellow', `factory: post-merge defect signals unavailable (${err?.message ?? err}) — heuristic defect labels omitted (hand labels still apply)`));
+    }
+    const file = join(paths.state, backtestFileName(now));
+    deps.ensureDir(paths.state);
+    const checkSha = (sha) => {
+        if (!SHA_PATTERN.test(sha))
+            throw new Error(`refusing unsafe merge commit sha '${sha}'`);
+        return sha;
+    };
+    const result = await runClassifierBacktest({ sources: selected, events, labels, rules: deps.rules, maxCostUsd: maxCost, now, windowDays: deps.windowDays }, {
+        numstat: async (sha) => (await deps.exec(`git diff --numstat --no-renames ${checkSha(sha)}^1 ${sha}`)).stdout,
+        diff: async (sha) => (await deps.exec(`git diff --no-renames ${checkSha(sha)}^1 ${sha}`)).stdout,
+        getIssue: async (n) => {
+            const { data } = await deps.octokit.rest.issues.get({ owner, repo, issue_number: n });
+            return { title: data.title ?? '', body: data.body ?? '' };
+        },
+        specPath: (issue) => join(paths.plans, `issue-${issue}.md`),
+        worktree: deps.repoRoot,
+        router: deps.router,
+        modelPin: deps.modelPin,
+        onRecord: (r) => deps.appendFile(file, `${JSON.stringify(r)}\n`),
+    });
+    const spent = `$${result.spentUsd.toFixed(2)} spent`;
+    const covered = result.records.length;
+    if (result.budgetReached) {
+        deps.log(`budget reached: covered ${covered} of ${result.candidates} PRs (${spent})`);
+    }
+    else {
+        const unpriced = result.unpricedCalls > 0 ? `, ${result.unpricedCalls} unpriced` : '';
+        deps.log(`covered ${covered} of ${result.candidates} PRs (${spent}${unpriced})`);
+    }
+    const report = summarizeClassifierOutcomes(classifiedRecords(result));
+    if (opts.json) {
+        deps.log(JSON.stringify({
+            file,
+            covered,
+            candidates: result.candidates,
+            spentUsd: result.spentUsd,
+            budgetReached: result.budgetReached,
+            report,
+        }));
+        return;
+    }
+    for (const line of formatClassifierReport(report))
+        deps.log(line);
+    deps.log(`Wrote ${file}`);
+}
+//# sourceMappingURL=classifier-backtest.js.map

package/dist/cli/classifier-backtest.js.map

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

package/dist/cli/cost-json.d.ts

@@ -0,0 +1,37 @@
+import { type CostEntry } from '@on-par/factory-core';
+/** One cost row in `factory cost --json` (#2269). CostEntry field names. */
+export interface CostRowJson {
+    ts: string;
+    issue: string;
+    task: string;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number | null;
+    cacheCreationTokens: number | null;
+    /** null when unpriced (ADR-0020); never 0 for an unpriced row. */
+    cost: number | null;
+}
+/** Per-model rollup over the (filtered) rows, first-seen model order. */
+export interface CostModelRowJson {
+    model: string;
+    tasks: number;
+    inputTokens: number;
+    outputTokens: number;
+    /** Sum of priced rows; null when every row for the model is unpriced. */
+    cost: number | null;
+    unpricedCount: number;
+}
+/** `factory cost --json` payload (#2269). Additive changes only; bump schemaVersion on a breaking change. */
+export interface CostJson {
+    schemaVersion: 1;
+    rows: CostRowJson[];
+    perModel: CostModelRowJson[];
+    total: {
+        cost: number | null;
+        unpricedCount: number;
+    };
+}
+/** Build the `factory cost --json` payload; `issue` keeps only that issue's rows. */
+export declare function buildCostJson(entries: CostEntry[], issue?: string): CostJson;
+//# sourceMappingURL=cost-json.d.ts.map

package/dist/cli/cost-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-json.d.ts","sourceRoot":"","sources":["../../src/cli/cost-json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtE,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,kEAAkE;IAClE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,6GAA6G;AAC7G,MAAM,WAAW,QAAQ;IACvB,aAAa,EAAE,CAAC,CAAC;IACjB,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CA8C5E"}

package/dist/cli/cost-json.js

@@ -0,0 +1,48 @@
+import { aggregateCosts } from '@on-par/factory-core';
+/** Build the `factory cost --json` payload; `issue` keeps only that issue's rows. */
+export function buildCostJson(entries, issue) {
+    const filtered = issue === undefined ? entries : entries.filter((e) => e.issue === String(issue));
+    const rows = [];
+    const models = new Map();
+    for (const e of filtered) {
+        const cost = e.unpriced === true || e.cost == null ? null : e.cost;
+        const inputTokens = e.inputTokens ?? 0;
+        const outputTokens = e.outputTokens ?? 0;
+        rows.push({
+            ts: e.ts,
+            issue: e.issue,
+            task: e.task,
+            model: e.model,
+            inputTokens,
+            outputTokens,
+            cacheReadTokens: e.cacheReadTokens ?? null,
+            cacheCreationTokens: e.cacheCreationTokens ?? null,
+            cost,
+        });
+        let m = models.get(e.model);
+        if (m === undefined) {
+            m = { tasks: 0, inputTokens: 0, outputTokens: 0, sum: 0, priced: 0, unpriced: 0 };
+            models.set(e.model, m);
+        }
+        m.tasks += 1;
+        m.inputTokens += inputTokens;
+        m.outputTokens += outputTokens;
+        if (cost === null)
+            m.unpriced += 1;
+        else {
+            m.sum += cost;
+            m.priced += 1;
+        }
+    }
+    const perModel = [...models].map(([model, m]) => ({
+        model,
+        tasks: m.tasks,
+        inputTokens: m.inputTokens,
+        outputTokens: m.outputTokens,
+        cost: m.priced === 0 && m.unpriced > 0 ? null : m.sum,
+        unpricedCount: m.unpriced,
+    }));
+    const t = aggregateCosts(filtered).total;
+    return { schemaVersion: 1, rows, perModel, total: { cost: t.cost, unpricedCount: t.unpricedCount } };
+}
+//# sourceMappingURL=cost-json.js.map

package/dist/cli/cost-json.js.map

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

package/dist/cli/daemon.d.ts

@@ -0,0 +1,113 @@
+import { type RepoState } from '@on-par/factory-core/internal';
+export declare const FACTORYD_LABEL = "com.onpar.factoryd";
+/** Expected daemon-control failure. index.ts's commander wrappers map it onto
+ *  CliExitError (importing CliExitError here would be circular — index.ts
+ *  imports this module). */
+export declare class DaemonCtlError extends Error {
+    readonly code: number;
+    constructor(message: string, code: number);
+}
+export type LaunchctlExec = (cmd: string, args: string[]) => Promise<{
+    code: number;
+    stdout: string;
+    stderr: string;
+}>;
+export interface DaemonCtlDeps {
+    /** Runs launchctl / ps without a shell. Default: promisified execFile that
+     *  never rejects on non-zero exit (resolves { code, stdout, stderr }). */
+    exec?: LaunchctlExec;
+    /** Default os.homedir(). Tests point this at a temp dir. */
+    home?: string;
+    /** Default process.getuid?.() ?? 0. */
+    uid?: number;
+    /** Default process.platform. */
+    platform?: NodeJS.Platform;
+    /** Default process.stdout. */
+    out?: {
+        write(s: string): unknown;
+    };
+    /** Default process.execPath. */
+    nodePath?: string;
+    /** Default realpathSync(process.argv[1]) — unwraps the bin symlink. */
+    cliScriptPath?: string;
+    /** Default defaultRegistryPath(). */
+    registryFile?: string;
+    /** Follow-mode poll interval; tests pass ~10. Default 250. */
+    pollMs?: number;
+}
+/** Where a given home directory keeps the LaunchAgent plist and the daemon log. */
+export declare function factorydFiles(home: string): {
+    launchAgentsDir: string;
+    plistPath: string;
+    logPath: string;
+};
+/** Resolved options for the foreground `factory daemon run` process. */
+export interface FactorydConfig {
+    /** Registry file served (default ~/.factory/registry.json). */
+    registryFile: string;
+    /** Port to bind on 127.0.0.1 (default DEFAULT_FACTORYD_PORT). */
+    port: number;
+    /** Opt-in auto-update (#2128). Off unless --auto-update was passed; nothing acts on it yet. */
+    autoUpdate: boolean;
+}
+/** Resolves `factory daemon run` options into a FactorydConfig. Throws
+ *  DaemonCtlError (code 2) on an invalid --port. */
+export declare function resolveFactorydConfig(opts: {
+    port?: string;
+    registry?: string;
+    autoUpdate?: boolean;
+}): FactorydConfig;
+/** Pure renderer for ~/Library/LaunchAgents/com.onpar.factoryd.plist. KeepAlive
+ *  relaunches factoryd after any exit; RunAtLoad starts it at login/bootstrap;
+ *  launchd redirects stdout+stderr to the daemon log. ProgramArguments invokes
+ *  the foreground `factory daemon run` command with its defaults. */
+export declare function renderFactorydPlist(opts: {
+    nodePath: string;
+    cliScriptPath: string;
+    logPath: string;
+}): string;
+/** Extracts the running pid from `launchctl print gui/<uid>/<label>` output. */
+/** `factory daemon status --json` payload (#2267). Additive changes only; bump schemaVersion on a breaking change. */
+export interface DaemonStatusJson {
+    schemaVersion: 1;
+    running: boolean;
+    pid: number | null;
+    uptimeSec: number | null;
+    plistInstalled: boolean;
+    repos: Array<{
+        slug: string;
+        checkoutPath: string;
+        state: RepoState;
+    }>;
+}
+/** ps `etime` ([[dd-]hh:]mm:ss) → whole seconds; null when empty or malformed. */
+export declare function parseEtime(etime: string): number | null;
+export declare function parseLaunchctlPid(printOutput: string): number | null;
+/** Last n lines of text, ignoring a trailing newline. */
+export declare function lastLines(text: string, n: number): string[];
+/** The production exec seam: execFile without a shell, resolving (never
+ *  rejecting) `{ code, stdout, stderr }` — a missing binary or non-numeric
+ *  error code becomes code 1. Exported for direct coverage in daemon.test.ts. */
+export declare function defaultExec(): LaunchctlExec;
+/** Install (or reinstall) and load the LaunchAgent. Always a full reinstall:
+ *  regenerate the plist, bootout (ignoring failure — handles both "already
+ *  loaded" and "not loaded"), then bootstrap into the gui domain so the daemon's
+ *  Claude workers keep login-keychain access (docs/runbooks/macos-keychain-launchagent.md). */
+export declare function cmdDaemonStart(deps?: DaemonCtlDeps): Promise<void>;
+/** Unload the LaunchAgent. Idempotent: a not-loaded agent is success. The plist
+ *  stays on disk so `factory daemon start` re-enables it. */
+export declare function cmdDaemonStop(deps?: DaemonCtlDeps): Promise<void>;
+/** Report running/not-loaded, pid + uptime, plist install state, and the
+ *  attached repos from the registry. Exit code 0 when running, 1 when not.
+ *  With `opts.json`, print one DaemonStatusJson object instead of text. */
+export declare function cmdDaemonStatus(deps?: DaemonCtlDeps, opts?: {
+    json?: boolean;
+}): Promise<void>;
+/** Print the last N lines of ~/.factory/daemon.log; with --follow, keep
+ *  streaming appended bytes until Ctrl-C (size-offset poll, like logs.ts's
+ *  followEvents — no `tail -f` child process). Works on any platform. */
+export declare function cmdDaemonLogs(opts: {
+    follow?: boolean;
+    lines?: string;
+}, deps?: DaemonCtlDeps): Promise<void>;
+//# sourceMappingURL=daemon.d.ts.map

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

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