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

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,41 @@
-# 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 for On PAR Dev's Software Factory.
+
+On PAR Dev's Software Factory is a local CLI that takes a GitHub issue through plan, build and check with AI agents, then opens a ready-for-review PR. You decide what merges.
+
+Built in TypeScript. Routes work across Claude and Codex, with experimental local models through Ollama, and logs cost per task.
+
+![On PAR Dev's Software Factory running a Sound Buddy lane (sped up)](https://raw.githubusercontent.com/on-par/software-factory/main/docs/assets/factory-run.gif)
+
+## Install
+
+```bash
+npm install -g @on-par/factory-cli
+factory --version
+factory doctor
+```
+
+Requires Node.js >= 24, `git`, Claude Code (`claude`) installed and signed in, and the GitHub CLI signed in with `gh auth login`. The factory reads `GITHUB_TOKEN`, then `GH_TOKEN`, and falls back to `gh auth token`. `factory doctor` checks all of this and prints a fix for anything missing.
+
+## Safety
+
+Agents run with their permission prompts off (Claude Code with `--permission-mode bypassPermissions`, Codex with `approval_policy=never`) in a separate git worktree, with your permissions and your GitHub token. Only point the factory at repos and issues you trust. It never merges by default: `factory run` and `factory supervise` merge only if you turn auto-merge on (`FACTORY_MERGE=1`, `run.merge.auto: true`, or `--auto-merge`), and `factory land` merges when you run it. Details are in the [Safety section](https://github.com/on-par/software-factory#safety) and [SECURITY.md](https://github.com/on-par/software-factory/blob/main/SECURITY.md).
+
+## Updating
+
+```bash
+npm install -g @on-par/factory-cli@latest
+```
+
+Automatic updates are planned: [#2354](https://github.com/on-par/software-factory/issues/2354), [#2355](https://github.com/on-par/software-factory/issues/2355).
+
+## 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/base-hold.d.ts

@@ -0,0 +1,63 @@
+/** A base SHA found broken by an environment pause (ADR-0141). */
+export interface BaseHold {
+    /** `owner/name` of the repo the hold applies to. */
+    repo: string;
+    baseSha: string;
+    failingChecks: string[];
+    /** ISO-8601 time the hold was recorded. */
+    since: string;
+}
+export declare function writeBaseHold(file: string, hold: BaseHold): void;
+/** Fails soft: a missing, unreadable, non-JSON, non-object or wrongly-typed file is no hold (null). */
+export declare function readBaseHold(file: string): BaseHold | null;
+export declare function deleteBaseHold(file: string): void;
+/** Why a hold ended (#2350). */
+export type BaseHoldClearReason = 'sha-changed' | 'ci-green';
+export interface BaseHoldCleared {
+    hold: BaseHold;
+    reason: BaseHoldClearReason;
+    /** origin/main SHA seen on the clearing poll. */
+    currentSha: string;
+}
+/** Deletes the hold only if it is still on `baseSha`; true only when this call deleted it. Fully
+ *  synchronous, so concurrent lanes in one process cannot both get true. */
+export declare function clearBaseHold(file: string, baseSha: string): boolean;
+export declare function formatBaseHoldCleared(c: BaseHoldCleared): string;
+/** `factory status` lines for an active hold (#2351). */
+export declare function formatBaseHoldStatus(hold: BaseHold): string[];
+export type BaseHoldDecision = {
+    kind: 'claim';
+} | {
+    kind: 'hold';
+    hold: BaseHold;
+};
+export interface BaseHoldGateDeps {
+    /** Current origin/main SHA; null (or a throw) means unknown. */
+    currentBaseSha: () => Promise<string | null>;
+    /** True only when main's CI on `sha` is green. */
+    baseCiGreen: (sha: string) => Promise<boolean>;
+    /** Called once, only by the poll that actually deleted the hold. A throw is swallowed. */
+    onCleared?: (cleared: BaseHoldCleared) => void;
+}
+/** Decides whether a lane may claim: hold only while origin/main is still at the held SHA and
+ *  its CI is not green. Unknown origin/main fails open; a failed CI lookup counts as not green.
+ *  Clears the hold when origin/main moved or its CI is green (#2350). */
+export declare function evaluateBaseHold(file: string, repo: string, deps: BaseHoldGateDeps): Promise<BaseHoldDecision>;
+/** Green = at least one check run, all completed, all on the ADR-0014 passing allow-list. */
+export declare function isGreenCheckRunSet(runs: ReadonlyArray<{
+    status: string | null;
+    conclusion: string | null;
+}>): boolean;
+/** SHA from the first line of `git ls-remote` output, or null when absent or malformed. */
+export declare function parseLsRemoteSha(stdout: string): string | null;
+export declare function createBaseHoldGate(opts: {
+    file: string;
+    repo: string;
+    git: (cmd: string) => Promise<string>;
+    listCheckRuns: (ref: string) => Promise<Array<{
+        status: string | null;
+        conclusion: string | null;
+    }>>;
+    onCleared?: (cleared: BaseHoldCleared) => void;
+}): () => Promise<BaseHoldDecision>;
+//# sourceMappingURL=base-hold.d.ts.map

package/dist/cli/base-hold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-hold.d.ts","sourceRoot":"","sources":["../../src/cli/base-hold.ts"],"names":[],"mappings":"AAWA,kEAAkE;AAClE,MAAM,WAAW,QAAQ;IACvB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAShE;AAED,uGAAuG;AACvG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAa1D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,gCAAgC;AAChC,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,UAAU,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;IAC5B,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;4EAC4E;AAC5E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAKpE;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAMhE;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAG7D;AAED,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEpF,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,kDAAkD;IAClD,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,0FAA0F;IAC1F,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;CAChD;AAED;;yEAEyE;AACzE,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+BpH;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,CAAC;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GAAG,OAAO,CAErH;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI9D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC,CAAC;IACrG,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;CAChD,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAOlC"}

package/dist/cli/base-hold.js

@@ -0,0 +1,122 @@
+// packages/cli/src/cli/base-hold.ts — base hold persisted when a lane pauses on a broken
+// base SHA (#2348), so a restarted supervisor remembers the pause. #2349 reads it back as the
+// claim gate: no claiming while origin/main is still at the held SHA and its CI is not green.
+// #2350 clears the hold once origin/main moves or its CI goes green. #2351 reads it for
+// `factory status`.
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { isPassingConclusion } from '@on-par/factory-core/internal';
+export function writeBaseHold(file, hold) {
+    mkdirSync(dirname(file), { recursive: true });
+    const record = {
+        repo: hold.repo,
+        baseSha: hold.baseSha,
+        failingChecks: [...hold.failingChecks],
+        since: hold.since,
+    };
+    writeFileSync(file, `${JSON.stringify(record, null, 2)}\n`);
+}
+/** Fails soft: a missing, unreadable, non-JSON, non-object or wrongly-typed file is no hold (null). */
+export function readBaseHold(file) {
+    if (!existsSync(file))
+        return null;
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(file, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+        return null;
+    const { repo, baseSha, failingChecks, since } = raw;
+    if (typeof repo !== 'string' || typeof baseSha !== 'string' || typeof since !== 'string')
+        return null;
+    if (!Array.isArray(failingChecks) || !failingChecks.every((c) => typeof c === 'string'))
+        return null;
+    return { repo, baseSha, failingChecks: [...failingChecks], since };
+}
+export function deleteBaseHold(file) {
+    rmSync(file, { force: true });
+}
+/** Deletes the hold only if it is still on `baseSha`; true only when this call deleted it. Fully
+ *  synchronous, so concurrent lanes in one process cannot both get true. */
+export function clearBaseHold(file, baseSha) {
+    const current = readBaseHold(file);
+    if (current === null || current.baseSha !== baseSha)
+        return false;
+    deleteBaseHold(file);
+    return true;
+}
+export function formatBaseHoldCleared(c) {
+    const held = c.hold.baseSha.slice(0, 8);
+    const now = c.currentSha.slice(0, 8);
+    return c.reason === 'sha-changed'
+        ? `base hold on ${held} cleared (reason: sha-changed): origin/main moved to ${now}`
+        : `base hold on ${held} cleared (reason: ci-green): main CI on ${now} is green`;
+}
+/** `factory status` lines for an active hold (#2351). */
+export function formatBaseHoldStatus(hold) {
+    const checks = hold.failingChecks.length > 0 ? hold.failingChecks.join(', ') : '(none recorded)';
+    return [`  repo: ${hold.repo}`, `  baseSha: ${hold.baseSha}`, `  failingChecks: ${checks}`, `  since: ${hold.since}`];
+}
+/** Decides whether a lane may claim: hold only while origin/main is still at the held SHA and
+ *  its CI is not green. Unknown origin/main fails open; a failed CI lookup counts as not green.
+ *  Clears the hold when origin/main moved or its CI is green (#2350). */
+export async function evaluateBaseHold(file, repo, deps) {
+    const hold = readBaseHold(file);
+    if (hold === null || hold.repo !== repo)
+        return { kind: 'claim' };
+    let sha;
+    try {
+        sha = await deps.currentBaseSha();
+    }
+    catch {
+        sha = null;
+    }
+    if (sha === null)
+        return { kind: 'claim' };
+    const clear = (reason, currentSha) => {
+        if (!clearBaseHold(file, hold.baseSha))
+            return;
+        try {
+            deps.onCleared?.({ hold, reason, currentSha });
+        }
+        catch {
+            // an observer failure must not change the decision
+        }
+    };
+    if (sha !== hold.baseSha) {
+        clear('sha-changed', sha);
+        return { kind: 'claim' };
+    }
+    let green = false;
+    try {
+        green = await deps.baseCiGreen(sha);
+    }
+    catch {
+        green = false;
+    }
+    if (!green)
+        return { kind: 'hold', hold };
+    clear('ci-green', sha);
+    return { kind: 'claim' };
+}
+/** Green = at least one check run, all completed, all on the ADR-0014 passing allow-list. */
+export function isGreenCheckRunSet(runs) {
+    return runs.length > 0 && runs.every((r) => r.status === 'completed' && isPassingConclusion(r.conclusion));
+}
+/** SHA from the first line of `git ls-remote` output, or null when absent or malformed. */
+export function parseLsRemoteSha(stdout) {
+    const line = stdout.split('\n').find((l) => l.trim() !== '');
+    const field = line?.trim().split(/\s+/)[0] ?? '';
+    return /^[0-9a-f]{40}$/i.test(field) ? field : null;
+}
+export function createBaseHoldGate(opts) {
+    return () => evaluateBaseHold(opts.file, opts.repo, {
+        currentBaseSha: async () => parseLsRemoteSha(await opts.git('git ls-remote origin refs/heads/main')),
+        baseCiGreen: async (sha) => isGreenCheckRunSet(await opts.listCheckRuns(sha)),
+        onCleared: opts.onCleared,
+    });
+}
+//# sourceMappingURL=base-hold.js.map

package/dist/cli/base-hold.js.map

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

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