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

package/dist/cli/logs.js

@@ -0,0 +1,52 @@
+// packages/cli/src/cli/logs.ts — `factory logs` [--follow] [--json] [--issue <n>]
+import { followEvents, readEvents } from '@on-par/factory-core';
+import { colorEnabled, formatEventLine } from '@on-par/factory-core/internal';
+export function eventMatchesIssue(e, issue) {
+    return !issue || e.issue === issue;
+}
+export function renderEvent(e, opts) {
+    if (opts.json)
+        return JSON.stringify(e);
+    return formatEventLine(e.type, e.issue, e.msg, { color: opts.color, lane: e.lane, ts: e.ts });
+}
+/** Print current events; with follow, keep tailing. Returns a stop() function (no-op stop for non-follow). */
+export function runLogs(eventsFile, opts, deps = {}) {
+    const out = deps.out ?? process.stdout;
+    const env = deps.env ?? process.env;
+    const color = colorEnabled(out, env) && !opts.json;
+    let delivered = 0;
+    const emit = (e) => {
+        delivered++;
+        if (!eventMatchesIssue(e, opts.issue))
+            return;
+        out.write(renderEvent(e, { json: opts.json, color }) + '\n');
+    };
+    if (!opts.follow) {
+        for (const e of readEvents(eventsFile))
+            emit(e);
+        return () => { };
+    }
+    const stopTailing = followEvents(eventsFile, emit, { fromStart: true, pollMs: deps.pollMs ?? 250 });
+    return () => {
+        stopTailing();
+        // Catch up on anything written in the poll window right before stop() (e.g. a
+        // Ctrl-C racing the final "build complete" event) so it isn't silently dropped.
+        for (const e of readEvents(eventsFile).slice(delivered))
+            emit(e);
+    };
+}
+/** Command entry point wired up to commander. Keeps the process alive until Ctrl-C in --follow mode. */
+export async function cmdLogs(opts, deps) {
+    const stop = runLogs(deps.eventsFile, opts, deps);
+    if (!opts.follow)
+        return;
+    const keepAlive = setInterval(() => { }, 60_000);
+    await new Promise((res) => {
+        const done = () => res();
+        process.once('SIGINT', done);
+        process.once('SIGTERM', done);
+    });
+    stop();
+    clearInterval(keepAlive);
+}
+//# sourceMappingURL=logs.js.map

package/dist/cli/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../src/cli/logs.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAGlF,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAe9E,MAAM,UAAU,iBAAiB,CAAC,CAAe,EAAE,KAAc;IAC/D,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAe,EAAE,IAAwC;IACnF,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO,eAAe,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChG,CAAC;AAED,8GAA8G;AAC9G,MAAM,UAAU,OAAO,CAAC,UAAkB,EAAE,IAAiB,EAAE,IAAI,GAAa,EAAE;IAChF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACpC,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAEnD,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,IAAI,GAAG,CAAC,CAAe,EAAQ,EAAE;QACrC,SAAS,EAAE,CAAC;QACZ,IAAI,CAAC,iBAAiB,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO;QAC9C,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/D,CAAC,CAAC;IAEF,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC;YAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAChD,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;IACpG,OAAO,GAAG,EAAE;QACV,WAAW,EAAE,CAAC;QACd,8EAA8E;QAC9E,gFAAgF;QAChF,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;YAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC;AACJ,CAAC;AAED,wGAAwG;AACxG,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAiB,EAAE,IAAuC;IACtF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAElD,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO;IAEzB,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,GAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,IAAI,OAAO,CAAO,CAAC,GAAG,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IACH,IAAI,EAAE,CAAC;IACP,aAAa,CAAC,SAAS,CAAC,CAAC;AAC3B,CAAC"}

package/dist/cli/merge-scope.d.ts

@@ -0,0 +1,7 @@
+/** The env vars that enable autonomous merge — honored by `factory run`/`factory land`,
+ *  never by `factory ship`, which always stops at a ready-for-review PR (#978). */
+export declare const MERGE_SCOPE_ENV_VARS: readonly ['FACTORY_MERGE', 'FACTORY_MERGE_ADMIN'];
+/** One advisory line when a merge env var is set for a command that cannot honor it,
+ *  or undefined when none is set. Pure: reads only the passed env bag. */
+export declare function mergeScopeNotice(env: NodeJS.ProcessEnv, issueNum: number): string | undefined;
+//# sourceMappingURL=merge-scope.d.ts.map

package/dist/cli/merge-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-scope.d.ts","sourceRoot":"","sources":["../../src/cli/merge-scope.ts"],"names":[],"mappings":"AAEA;mFACmF;AACnF,eAAO,MAAM,oBAAoB,YAAI,eAAe,EAAE,qBAAqB,CAAU,CAAC;AAEtF;0EAC0E;AAC1E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO7F"}

package/dist/cli/merge-scope.js

@@ -0,0 +1,14 @@
+// packages/cli/src/cli/merge-scope.ts — warn when merge env vars are set for a command that ignores them
+/** The env vars that enable autonomous merge — honored by `factory run`/`factory land`,
+ *  never by `factory ship`, which always stops at a ready-for-review PR (#978). */
+export const MERGE_SCOPE_ENV_VARS = ['FACTORY_MERGE', 'FACTORY_MERGE_ADMIN'];
+/** One advisory line when a merge env var is set for a command that cannot honor it,
+ *  or undefined when none is set. Pure: reads only the passed env bag. */
+export function mergeScopeNotice(env, issueNum) {
+    const set = MERGE_SCOPE_ENV_VARS.filter((name) => env[name] === '1');
+    if (set.length === 0)
+        return undefined;
+    return (`factory: ${set.map((n) => `${n}=1`).join(', ')} ignored — factory ship always stops at ` +
+        `ready-for-review; use "factory land ${issueNum}" after review, or "factory run" to merge automatically`);
+}
+//# sourceMappingURL=merge-scope.js.map

package/dist/cli/merge-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-scope.js","sourceRoot":"","sources":["../../src/cli/merge-scope.ts"],"names":[],"mappings":"AAAA,yGAAyG;AAEzG;mFACmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,eAAe,EAAE,qBAAqB,CAAU,CAAC;AAEtF;0EAC0E;AAC1E,MAAM,UAAU,gBAAgB,CAAC,GAAsB,EAAE,QAAgB;IACvE,MAAM,GAAG,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACrE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvC,OAAO,CACL,YAAY,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,0CAA0C;QACzF,uCAAuC,QAAQ,yDAAyD,CACzG,CAAC;AACJ,CAAC"}

package/dist/cli/octokit.d.ts

@@ -0,0 +1,43 @@
+import { Octokit } from '@octokit/rest';
+/** Rate-limit retries per request. Bounded so a genuinely exhausted quota surfaces to the
+ *  caller instead of stalling a lane behind an unbounded backoff loop. */
+export declare const MAX_THROTTLE_RETRIES = 2;
+export declare function onRateLimit(_retryAfter: number, _options: {
+    method?: string;
+    url?: string;
+}, _octokit: unknown, retryCount: number): boolean;
+export declare function onSecondaryRateLimit(_retryAfter: number, _options: {
+    method?: string;
+    url?: string;
+}, _octokit: unknown, retryCount: number): boolean;
+/** One deprecated REST route, as reported by GitHub's Deprecation/Sunset/Link headers (#2218). */
+export interface GitHubApiDeprecation {
+    /** Upper-case, e.g. 'POST'. */
+    method: string;
+    /** Route template, e.g. '/repos/{owner}/{repo}/issues'. */
+    route: string;
+    /** Raw Sunset header, e.g. 'Fri, 10 Mar 2028 00:00:00 GMT'. */
+    sunset?: string;
+    /** 'YYYY-MM-DD' (UTC) when Sunset parses, e.g. '2028-03-10'. */
+    sunsetDate?: string;
+    /** The rel="deprecation" URL from the Link header. */
+    link?: string;
+}
+export interface FactoryOctokitOptions {
+    /** Receives each deprecated METHOD route once per client — shipIssue turns it into a github_api_deprecated event. */
+    log?: (deprecation: GitHubApiDeprecation) => void;
+    /** Where the short per-route line goes. Defaults to console.error. Injectable for tests. */
+    stderr?: (line: string) => void;
+}
+type ResponseHeaders = Record<string, string | number | undefined>;
+/** True for Octokit's raw `[@octokit/request] "…" is deprecated.` warn line. */
+export declare function isOctokitDeprecationWarning(message: string): boolean;
+/** Reads GitHub's deprecation headers (Octokit lower-cases header keys); undefined when not deprecated. */
+export declare function readDeprecation(method: string, route: string, headers: ResponseHeaders): GitHubApiDeprecation | undefined;
+export declare function formatDeprecation(d: GitHubApiDeprecation): string;
+/** The client every CLI GitHub call goes through. `@octokit/plugin-retry` handles transient
+ *  5xx/network failures with its default bounded backoff; the throttle handlers above cover
+ *  primary and secondary rate limits (#641). Deprecated routes are reported once per client (#2218). */
+export declare function createFactoryOctokit(token?: string, options?: FactoryOctokitOptions): Octokit;
+export {};
+//# sourceMappingURL=octokit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"octokit.d.ts","sourceRoot":"","sources":["../../src/cli/octokit.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC;0EAC0E;AAC1E,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAItC,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3C,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAET;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3C,QAAQ,EAAE,OAAO,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAET;AAED,kGAAkG;AAClG,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,qHAAqH;IACrH,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAClD,4FAA4F;IAC5F,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;AAEnE,gFAAgF;AAChF,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED,2GAA2G;AAC3G,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,GACvB,oBAAoB,GAAG,SAAS,CAWlC;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAEjE;AAED;;wGAEwG;AACxG,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CA2CjG"}

package/dist/cli/octokit.js

@@ -0,0 +1,87 @@
+// src/cli/octokit.ts — the shared GitHub client: retry + throttling on every call (#641),
+// deprecated-route detection once per route (#2218)
+import { styleText } from 'node:util';
+import { retry } from '@octokit/plugin-retry';
+import { throttling } from '@octokit/plugin-throttling';
+import { Octokit } from '@octokit/rest';
+/** Rate-limit retries per request. Bounded so a genuinely exhausted quota surfaces to the
+ *  caller instead of stalling a lane behind an unbounded backoff loop. */
+export const MAX_THROTTLE_RETRIES = 2;
+const FactoryOctokit = Octokit.plugin(retry, throttling);
+export function onRateLimit(_retryAfter, _options, _octokit, retryCount) {
+    return retryCount < MAX_THROTTLE_RETRIES;
+}
+export function onSecondaryRateLimit(_retryAfter, _options, _octokit, retryCount) {
+    return retryCount < MAX_THROTTLE_RETRIES;
+}
+/** True for Octokit's raw `[@octokit/request] "…" is deprecated.` warn line. */
+export function isOctokitDeprecationWarning(message) {
+    return /^\[@octokit\/request\] ".*" is deprecated\./.test(message);
+}
+/** Reads GitHub's deprecation headers (Octokit lower-cases header keys); undefined when not deprecated. */
+export function readDeprecation(method, route, headers) {
+    if (!('deprecation' in headers))
+        return undefined;
+    const deprecation = { method: method.toUpperCase(), route };
+    if (headers.sunset !== undefined) {
+        deprecation.sunset = String(headers.sunset);
+        const time = new Date(deprecation.sunset);
+        if (!Number.isNaN(time.getTime()))
+            deprecation.sunsetDate = time.toISOString().slice(0, 10);
+    }
+    const link = String(headers.link ?? '').match(/<([^<>]+)>; rel="deprecation"/)?.[1];
+    if (link !== undefined)
+        deprecation.link = link;
+    return deprecation;
+}
+export function formatDeprecation(d) {
+    return `GitHub API deprecated: ${d.method} ${d.route} — sunset ${d.sunsetDate ?? d.sunset ?? 'unknown'}${d.link ? ` (see ${d.link})` : ''}`;
+}
+/** The client every CLI GitHub call goes through. `@octokit/plugin-retry` handles transient
+ *  5xx/network failures with its default bounded backoff; the throttle handlers above cover
+ *  primary and secondary rate limits (#641). Deprecated routes are reported once per client (#2218). */
+export function createFactoryOctokit(token, options = {}) {
+    const seen = new Set();
+    const stderr = options.stderr ?? ((line) => console.error(line));
+    const log = {
+        debug: () => { },
+        info: () => { },
+        warn: (message) => {
+            if (!isOctokitDeprecationWarning(message))
+                console.warn(message);
+        },
+        error: (message) => console.error(message),
+    };
+    const octokit = new FactoryOctokit({
+        auth: token,
+        throttle: { onRateLimit, onSecondaryRateLimit },
+        log,
+        // @octokit/request reads its own `request.log` (default console), not the client's `log`.
+        request: { log },
+    });
+    const record = (opts, headers) => {
+        try {
+            if (!headers || !opts.method || !opts.url)
+                return;
+            const d = readDeprecation(opts.method, opts.url, headers);
+            if (!d)
+                return;
+            const key = `${d.method} ${d.route}`;
+            if (seen.has(key))
+                return;
+            seen.add(key);
+            stderr(styleText('yellow', formatDeprecation(d)));
+            options.log?.(d);
+        }
+        catch {
+            // observability only — never break the call
+        }
+    };
+    octokit.hook.after('request', (response, opts) => record(opts, response.headers));
+    octokit.hook.error('request', (error, opts) => {
+        record(opts, error.response?.headers);
+        throw error;
+    });
+    return octokit;
+}
+//# sourceMappingURL=octokit.js.map

package/dist/cli/octokit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"octokit.js","sourceRoot":"","sources":["../../src/cli/octokit.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,oDAAoD;AAEpD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC;0EAC0E;AAC1E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAEtC,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AAEzD,MAAM,UAAU,WAAW,CACzB,WAAmB,EACnB,QAA2C,EAC3C,QAAiB,EACjB,UAAkB;IAElB,OAAO,UAAU,GAAG,oBAAoB,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,WAAmB,EACnB,QAA2C,EAC3C,QAAiB,EACjB,UAAkB;IAElB,OAAO,UAAU,GAAG,oBAAoB,CAAC;AAC3C,CAAC;AAyBD,gFAAgF;AAChF,MAAM,UAAU,2BAA2B,CAAC,OAAe;IACzD,OAAO,6CAA6C,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACrE,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,KAAa,EACb,OAAwB;IAExB,IAAI,CAAC,CAAC,aAAa,IAAI,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAClD,MAAM,WAAW,GAAyB,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC;IAClF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAAE,WAAW,CAAC,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpF,IAAI,IAAI,KAAK,SAAS;QAAE,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC;IAChD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,CAAuB;IACvD,OAAO,0BAA0B,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,MAAM,IAAI,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC9I,CAAC;AAED;;wGAEwG;AACxG,MAAM,UAAU,oBAAoB,CAAC,KAAc,EAAE,OAAO,GAA0B,EAAE;IACtF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACzE,MAAM,GAAG,GAAG;QACV,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;QACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;QACd,IAAI,EAAE,CAAC,OAAe,EAAE,EAAE;YACxB,IAAI,CAAC,2BAA2B,CAAC,OAAO,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;KACnD,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;QACjC,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,EAAE,WAAW,EAAE,oBAAoB,EAAE;QAC/C,GAAG;QACH,0FAA0F;QAC1F,OAAO,EAAE,EAAE,GAAG,EAAE;KACjB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,CAAC,IAAuC,EAAE,OAAoC,EAAQ,EAAE;QACrG,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG;gBAAE,OAAO;YAClD,MAAM,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC1D,IAAI,CAAC,CAAC;gBAAE,OAAO;YACf,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO;YAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;QAC9C,CAAC;IACH,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAC/C,MAAM,CAAC,IAAyC,EAAE,QAAQ,CAAC,OAA0B,CAAC,CACvF,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC5C,MAAM,CACJ,IAAyC,EACxC,KAAsD,CAAC,QAAQ,EAAE,OAAO,CAC1E,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/cli/queue-add-json.d.ts

@@ -0,0 +1,25 @@
+import type { EnqueueOutcome, EnqueueResult } from '@on-par/factory-core/internal';
+/** One issue in `factory queue add --json` (#2275). */
+export interface QueueAddIssueJson {
+    number: number;
+    outcome: EnqueueOutcome;
+    /** 1-based order position; null when failed or the existing order label is unparsable. */
+    order: number | null;
+    labelsAdded: string[];
+    /** Set only when outcome === 'failed'. */
+    detail?: string;
+}
+/** `factory queue add --json` payload (#2275). Additive changes only; bump schemaVersion on a breaking change. */
+export interface QueueAddJson {
+    schemaVersion: 1;
+    /** False when any issue failed. */
+    ok: boolean;
+    action: 'queue-add';
+    lane: string;
+    /** Input order (deduped). */
+    issues: QueueAddIssueJson[];
+    /** Union of per-result labelsCreated, first-seen order, deduped. */
+    labelsCreated: string[];
+}
+export declare function buildQueueAddJson(lane: string, results: readonly EnqueueResult[]): QueueAddJson;
+//# sourceMappingURL=queue-add-json.d.ts.map

package/dist/cli/queue-add-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-add-json.d.ts","sourceRoot":"","sources":["../../src/cli/queue-add-json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnF,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,CAAC;IACxB,0FAA0F;IAC1F,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kHAAkH;AAClH,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,CAAC,CAAC;IACjB,mCAAmC;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,oEAAoE;IACpE,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,YAAY,CAqB/F"}

package/dist/cli/queue-add-json.js

@@ -0,0 +1,24 @@
+export function buildQueueAddJson(lane, results) {
+    const created = new Set();
+    const issues = results.map((r) => {
+        for (const name of r.labelsCreated ?? [])
+            created.add(name);
+        const failed = r.outcome === 'failed';
+        return {
+            number: r.issue,
+            outcome: r.outcome,
+            order: failed ? null : (r.position ?? null),
+            labelsAdded: failed ? [] : [...(r.labelsAdded ?? [])],
+            ...(failed ? { detail: r.detail ?? '' } : {}),
+        };
+    });
+    return {
+        schemaVersion: 1,
+        ok: !results.some((r) => r.outcome === 'failed'),
+        action: 'queue-add',
+        lane,
+        issues,
+        labelsCreated: [...created],
+    };
+}
+//# sourceMappingURL=queue-add-json.js.map

package/dist/cli/queue-add-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-add-json.js","sourceRoot":"","sources":["../../src/cli/queue-add-json.ts"],"names":[],"mappings":"AA0BA,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,OAAiC;IAC/E,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAqB,EAAE;QAClD,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,aAAa,IAAI,EAAE;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC;QACtC,OAAO;YACL,MAAM,EAAE,CAAC,CAAC,KAAK;YACf,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC;YAC3C,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;YACrD,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC;QAChD,MAAM,EAAE,WAAW;QACnB,IAAI;QACJ,MAAM;QACN,aAAa,EAAE,CAAC,GAAG,OAAO,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/cli/queue-clear.d.ts

@@ -0,0 +1,15 @@
+import type { QueueClearPreview, QueueClearResult } from '@on-par/factory-core/internal';
+export declare function formatQueueClearPreview(preview: QueueClearPreview): string;
+export declare function formatQueueClearResult(result: QueueClearResult): string;
+export declare function runQueueClear(deps: {
+    previewClear: () => Promise<QueueClearPreview>;
+    clear: () => Promise<QueueClearResult>;
+    dryRun?: boolean;
+    yes?: boolean;
+    lane?: string;
+}): Promise<{
+    report: string;
+    exitCode: 0 | 1 | 2;
+    message?: string;
+}>;
+//# sourceMappingURL=queue-clear.d.ts.map

package/dist/cli/queue-clear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-clear.d.ts","sourceRoot":"","sources":["../../src/cli/queue-clear.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEzF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAW1E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAUvE;AAQD,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,YAAY,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC/C,KAAK,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA4BrE"}

package/dist/cli/queue-clear.js

@@ -0,0 +1,58 @@
+// packages/cli/src/cli/queue-clear.ts — `factory queue clear`: preview (#1693), `--yes` clear (#1694), `--lane` (#1695).
+export function formatQueueClearPreview(preview) {
+    const lines = preview.entries.map((entry) => {
+        const lane = entry.lanes.length > 0 ? entry.lanes.join(',') : '(none)';
+        const reason = entry.action === 'would-skip' && entry.reason !== undefined ? ` — ${entry.reason}` : '';
+        const title = entry.title ? ` — ${entry.title}` : '';
+        return `  #${entry.issue} [lane ${lane}] ${entry.action}${reason}${title}`;
+    });
+    lines.push(`${preview.entries.length} queued issue(s): ${preview.wouldClear} would-clear, ${preview.wouldSkip} would-skip`);
+    return lines.join('\n');
+}
+export function formatQueueClearResult(result) {
+    const lines = result.entries.map((entry) => {
+        const lane = entry.lanes.length > 0 ? entry.lanes.join(',') : '(none)';
+        const reason = entry.reason !== undefined ? ` — ${entry.reason}` : '';
+        const title = entry.title ? ` — ${entry.title}` : '';
+        return `  #${entry.issue} [lane ${lane}] ${entry.outcome}${reason}${title}`;
+    });
+    const failed = result.failed > 0 ? `, ${result.failed} failed` : '';
+    lines.push(`${result.entries.length} queued issue(s): ${result.cleared} cleared, ${result.skipped} skipped${failed}`);
+    return lines.join('\n');
+}
+function emptyQueueReport(lane) {
+    return lane === undefined
+        ? 'queue is already empty — no open factory:queued issues'
+        : `queue is already empty for lane ${lane} — no open factory:queued issues in factory:lane:${lane}`;
+}
+export async function runQueueClear(deps) {
+    const laneSuffix = deps.lane === undefined ? '' : ` (lane ${deps.lane})`;
+    if (deps.yes && !deps.dryRun) {
+        const result = await deps.clear();
+        if (result.entries.length === 0)
+            return { report: emptyQueueReport(deps.lane), exitCode: 0 };
+        const report = `queue clear${laneSuffix}\n${formatQueueClearResult(result)}`;
+        if (result.failed > 0) {
+            return {
+                report,
+                exitCode: 1,
+                message: `factory: queue clear failed for ${result.failed} issue(s); see the lines above`,
+            };
+        }
+        return { report, exitCode: 0 };
+    }
+    const preview = await deps.previewClear();
+    if (preview.entries.length === 0) {
+        return { report: emptyQueueReport(deps.lane), exitCode: 0 };
+    }
+    const body = formatQueueClearPreview(preview);
+    if (deps.dryRun) {
+        return { report: `dry run — queue clear preview${laneSuffix}\n${body}\nno GitHub labels changed`, exitCode: 0 };
+    }
+    return {
+        report: `queue clear preview${laneSuffix}\n${body}`,
+        exitCode: 2,
+        message: 'factory: queue clear needs --yes to proceed (or --dry-run to preview); no GitHub labels changed',
+    };
+}
+//# sourceMappingURL=queue-clear.js.map

package/dist/cli/queue-clear.js.map

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

package/dist/cli/queue-list.d.ts

@@ -0,0 +1,24 @@
+import type { QueueSnapshot } from '@on-par/factory-core/internal';
+/** One item in `factory queue list --json` (#2268). */
+export interface QueueListItemJson {
+    issue: number;
+    title?: string;
+    status: 'queued' | 'in-progress' | 'parked';
+    /** 1-based position within the lane, in order-label order. */
+    order: number;
+    claimedBy: string | null;
+}
+/** `factory queue list --json` payload (#2268). Additive changes only; bump schemaVersion on a breaking change. */
+export interface QueueListJson {
+    schemaVersion: 1;
+    lanes: Array<{
+        lane: string;
+        items: QueueListItemJson[];
+    }>;
+}
+/**
+ * Group the reader's already-sorted entries by lane (lane order preserved) and
+ * rank each item 1-based within its lane. `lane` keeps only that lane.
+ */
+export declare function buildQueueListJson(snapshot: QueueSnapshot, lane?: string): QueueListJson;
+//# sourceMappingURL=queue-list.d.ts.map

package/dist/cli/queue-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-list.d.ts","sourceRoot":"","sources":["../../src/cli/queue-list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,aAAa,GAAG,QAAQ,CAAC;IAC5C,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,mHAAmH;AACnH,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,CAAC,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAkBxF"}

package/dist/cli/queue-list.js

@@ -0,0 +1,25 @@
+/**
+ * Group the reader's already-sorted entries by lane (lane order preserved) and
+ * rank each item 1-based within its lane. `lane` keeps only that lane.
+ */
+export function buildQueueListJson(snapshot, lane) {
+    const byLane = new Map();
+    for (const entry of snapshot.entries) {
+        if (lane !== undefined && entry.lane !== lane)
+            continue;
+        let items = byLane.get(entry.lane);
+        if (items === undefined) {
+            items = [];
+            byLane.set(entry.lane, items);
+        }
+        items.push({
+            issue: entry.issue,
+            ...(entry.title === undefined ? {} : { title: entry.title }),
+            status: entry.status ?? 'queued',
+            order: items.length + 1,
+            claimedBy: entry.claimant ?? null,
+        });
+    }
+    return { schemaVersion: 1, lanes: [...byLane].map(([name, items]) => ({ lane: name, items })) };
+}
+//# sourceMappingURL=queue-list.js.map

package/dist/cli/queue-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-list.js","sourceRoot":"","sources":["../../src/cli/queue-list.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAuB,EAAE,IAAa;IACvE,MAAM,MAAM,GAAG,IAAI,GAAG,EAA+B,CAAC;IACtD,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;YAAE,SAAS;QACxD,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,GAAG,EAAE,CAAC;YACX,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC;YACT,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;YAC5D,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,QAAQ;YAChC,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC;YACvB,SAAS,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;SAClC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC;AAClG,CAAC"}

package/dist/cli/ready-check.d.ts

@@ -0,0 +1,98 @@
+import { type CriteriaReport, type IssueInvestReport, type ReadinessInfo, type ReadinessTemplate } from '@on-par/factory-core';
+import { type ReadinessGapReport } from '@on-par/factory-core/internal';
+export type IssueSizeVerdict = 'runs-as-is' | 'would-split';
+export type DeepCheckTask = 'decompose' | 'triage';
+export type DeepCheckModelRunner = (task: DeepCheckTask, prompt: string) => Promise<{
+    model: string;
+    output: string;
+    cost: number | null;
+}>;
+/** Proposed child story; acceptance criteria are already formatted via formatGapCriterion. */
+export interface DeepSplitChild {
+    title: string;
+    acceptanceCriteria: string[];
+}
+export type IssueDeepCheck = {
+    kind: 'split';
+    model: string;
+    cost: number | null;
+    unpriced: boolean;
+    children: DeepSplitChild[];
+} | {
+    kind: 'gaps';
+    model: string;
+    cost: number | null;
+    unpriced: boolean;
+    gaps: ReadinessGapReport;
+};
+/** Minimal router surface the deep check needs (a ModelRouter satisfies it). */
+export interface DeepCheckRouter {
+    setCostSink(sink: (entry: {
+        cost: number | null;
+    }) => void): void;
+    run(task: string, prompt: string, opts: {
+        worktree: string;
+        timeoutSeconds: number;
+    }): Promise<{
+        model: string;
+        output: string;
+    }>;
+}
+/** Backs `--deep` with a router; captures the call's cost without writing costs.jsonl. */
+export declare function createDeepModelRunner(router: DeepCheckRouter, worktree: string): DeepCheckModelRunner;
+export declare class DeepCheckError extends Error {
+    constructor(message: string);
+}
+export interface IssueCheckReport {
+    issue: number;
+    template: ReadinessTemplate;
+    /** 0..100, rounded. */
+    score: number;
+    fields: {
+        pass: boolean;
+        missing: string[];
+    };
+    /** Per-criterion findings for factory-task issues; null for epic/factory-bug. */
+    criteria: CriteriaReport | null;
+    size: {
+        verdict: IssueSizeVerdict;
+        reason?: string;
+    };
+    /** Advisory INVEST findings for factory-task issues; null for epic/factory-bug. Never affects exitCode. */
+    invest: IssueInvestReport | null;
+    /** Human-readable reasons the issue is not ready / would split; empty when exitCode is 0. */
+    reasons: string[];
+    exitCode: 0 | 1 | 3;
+    /** Present only when `--deep` was requested. */
+    deep?: IssueDeepCheck;
+}
+export interface IssueCheckDeps {
+    /** Read-only issue fetch — the only GitHub access this command has. */
+    getIssue(issue: number): Promise<{
+        title: string;
+        body: string | null;
+    }>;
+    /** Read-only state lookup for dependencies cited in the issue body. */
+    getIssueState?(issue: number): Promise<'open' | 'closed'>;
+    /** Single model call for `--deep`; absent otherwise. */
+    runModel?: DeepCheckModelRunner;
+    log(line: string): void;
+}
+export declare function buildIssueCheckReport(issue: number, readiness: ReadinessInfo, criteria?: CriteriaReport | null, invest?: IssueInvestReport | null): IssueCheckReport;
+export declare function formatIssueCheckLines(report: IssueCheckReport): string[];
+export declare function formatGapCriterion(c: {
+    name: string;
+    when: readonly string[];
+    then: readonly string[];
+}): string;
+export declare function runDeepCheck(input: {
+    title: string;
+    body: string;
+    wouldSplit: boolean;
+}, runModel: DeepCheckModelRunner): Promise<IssueDeepCheck>;
+export declare function formatDeepCheckLines(deep: IssueDeepCheck): string[];
+export declare function runIssueCheck(issue: number, opts: {
+    json?: boolean;
+    deep?: boolean;
+}, deps: IssueCheckDeps): Promise<IssueCheckReport>;
+//# sourceMappingURL=ready-check.d.ts.map

package/dist/cli/ready-check.d.ts.map

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