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

package/dist/cli/runs-diffstat.d.ts

@@ -0,0 +1,43 @@
+/** One changed file. `added`/`deleted` are null for binary files. */
+export interface RunDiffstatFileJson {
+    path: string;
+    added: number | null;
+    deleted: number | null;
+}
+export interface RunDiffstatTotalsJson {
+    files: number;
+    added: number;
+    deleted: number;
+}
+export type RunDiffstatReason = 'branch-missing' | 'base-missing' | 'no-branch';
+/**
+ * Machine-readable output of `factory runs --json --diffstat <issue>`.
+ * Additive changes only; bump schemaVersion on a breaking change.
+ * `files`/`totals` are null (with a `reason`) when the diff cannot be computed.
+ */
+export interface RunDiffstatJson {
+    schemaVersion: 1;
+    issue: number;
+    branch: string | null;
+    base: string;
+    files: RunDiffstatFileJson[] | null;
+    totals: RunDiffstatTotalsJson | null;
+    reason: RunDiffstatReason | null;
+}
+/** Runs `git <args>` in cwd without a shell. Resolves stdout; rejects on nonzero exit. */
+export type DiffstatGit = (args: readonly string[], cwd: string) => Promise<string>;
+/** Thrown when the issue has no readable run state. cmdRuns maps it to exit 1. */
+export declare class NoRunError extends Error {
+}
+/** Parse the `--diffstat <issue>` value: a positive integer, else throw. */
+export declare function parseDiffstatIssue(raw: string): number;
+/** Parse `git diff --numstat -z --no-renames` output into file rows, in git's order. */
+export declare function parseNumstat(raw: string): RunDiffstatFileJson[];
+export declare function buildRunDiffstatJson(opts: {
+    runsDir: string;
+    repoRoot: string;
+    issue: number;
+    git?: DiffstatGit;
+    resolveBase?: (repoRoot: string) => Promise<string>;
+}): Promise<RunDiffstatJson>;
+//# sourceMappingURL=runs-diffstat.d.ts.map

package/dist/cli/runs-diffstat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs-diffstat.d.ts","sourceRoot":"","sources":["../../src/cli/runs-diffstat.ts"],"names":[],"mappings":"AAKA,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,cAAc,GAAG,WAAW,CAAC;AAEhF;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,CAAC,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAAC;IACpC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACrC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAClC;AAED,0FAA0F;AAC1F,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEpF,kFAAkF;AAClF,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAmBxC,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAe/D;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACrD,GAAG,OAAO,CAAC,eAAe,CAAC,CA4C3B"}

package/dist/cli/runs-diffstat.js

@@ -0,0 +1,91 @@
+import { execFile } from 'node:child_process';
+import { join } from 'node:path';
+import { defaultRemoteBase, readIssueRunState } from '@on-par/factory-core/internal';
+/** Thrown when the issue has no readable run state. cmdRuns maps it to exit 1. */
+export class NoRunError extends Error {
+}
+const defaultGit = (args, cwd) => new Promise((resolve, reject) => {
+    execFile('git', [...args], { cwd, timeout: 120_000, maxBuffer: 64 * 1024 * 1024, encoding: 'utf-8' }, (error, stdout, stderr) => {
+        if (error) {
+            const detail = String(stderr).trim();
+            reject(new Error(detail ? `${error.message}: ${detail}` : error.message));
+            return;
+        }
+        resolve(stdout);
+    });
+});
+/** Parse the `--diffstat <issue>` value: a positive integer, else throw. */
+export function parseDiffstatIssue(raw) {
+    const n = /^\d+$/.test(raw) ? Number(raw) : 0;
+    if (!Number.isSafeInteger(n) || n < 1) {
+        throw new Error(`invalid --diffstat '${raw}' — expected a positive issue number`);
+    }
+    return n;
+}
+/** Parse `git diff --numstat -z --no-renames` output into file rows, in git's order. */
+export function parseNumstat(raw) {
+    const files = [];
+    for (const token of raw.split('\0')) {
+        if (token === '')
+            continue;
+        const first = token.indexOf('\t');
+        const second = first === -1 ? -1 : token.indexOf('\t', first + 1);
+        if (second === -1)
+            continue;
+        const count = (s) => (s === '-' ? null : Number(s));
+        files.push({
+            path: token.slice(second + 1),
+            added: count(token.slice(0, first)),
+            deleted: count(token.slice(first + 1, second)),
+        });
+    }
+    return files;
+}
+export async function buildRunDiffstatJson(opts) {
+    const { runsDir, repoRoot, issue, git = defaultGit, resolveBase = defaultRemoteBase } = opts;
+    const state = await readIssueRunState(join(runsDir, `issue-${issue}.json`));
+    if (state === null)
+        throw new NoRunError(`no run for issue #${issue}`);
+    const base = await resolveBase(repoRoot);
+    const branch = typeof state.branch === 'string' && state.branch !== '' ? state.branch : null;
+    const unavailable = (reason) => ({
+        schemaVersion: 1,
+        issue,
+        branch,
+        base,
+        files: null,
+        totals: null,
+        reason,
+    });
+    if (branch === null)
+        return unavailable('no-branch');
+    const resolves = async (ref) => {
+        try {
+            await git(['rev-parse', '--verify', '-q', `${ref}^{commit}`], repoRoot);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    if (!(await resolves(base)))
+        return unavailable('base-missing');
+    let ref = null;
+    for (const candidate of [`refs/heads/${branch}`, `refs/remotes/origin/${branch}`]) {
+        if (await resolves(candidate)) {
+            ref = candidate;
+            break;
+        }
+    }
+    if (ref === null)
+        return unavailable('branch-missing');
+    const raw = await git(['diff', '--numstat', '-z', '--no-renames', '--no-ext-diff', `${base}...${ref}`], repoRoot);
+    const files = parseNumstat(raw);
+    const totals = { files: files.length, added: 0, deleted: 0 };
+    for (const f of files) {
+        totals.added += f.added ?? 0;
+        totals.deleted += f.deleted ?? 0;
+    }
+    return { schemaVersion: 1, issue, branch, base, files, totals, reason: null };
+}
+//# sourceMappingURL=runs-diffstat.js.map

package/dist/cli/runs-diffstat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs-diffstat.js","sourceRoot":"","sources":["../../src/cli/runs-diffstat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAmCrF,kFAAkF;AAClF,MAAM,OAAO,UAAW,SAAQ,KAAK;CAAG;AAExC,MAAM,UAAU,GAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAC5C,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IAC9B,QAAQ,CACN,KAAK,EACL,CAAC,GAAG,IAAI,CAAC,EACT,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EACzE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;QACxB,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAC1E,OAAO;QACT,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC,CACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEL,4EAA4E;AAC5E,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,sCAAsC,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,KAAK,GAA0B,EAAE,CAAC;IACxC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,KAAK,KAAK,EAAE;YAAE,SAAS;QAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAClE,IAAI,MAAM,KAAK,CAAC,CAAC;YAAE,SAAS;QAC5B,MAAM,KAAK,GAAG,CAAC,CAAS,EAAiB,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YAC7B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACnC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;SAC/C,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAM1C;IACC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,GAAG,UAAU,EAAE,WAAW,GAAG,iBAAiB,EAAE,GAAG,IAAI,CAAC;IAC7F,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC;IAC5E,IAAI,KAAK,KAAK,IAAI;QAAE,MAAM,IAAI,UAAU,CAAC,qBAAqB,KAAK,EAAE,CAAC,CAAC;IACvE,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7F,MAAM,WAAW,GAAG,CAAC,MAAyB,EAAmB,EAAE,CAAC,CAAC;QACnE,aAAa,EAAE,CAAC;QAChB,KAAK;QACL,MAAM;QACN,IAAI;QACJ,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,MAAM;KACP,CAAC,CAAC;IACH,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC;IAErD,MAAM,QAAQ,GAAG,KAAK,EAAE,GAAW,EAAoB,EAAE;QACvD,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,GAAG,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;YACxE,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,WAAW,CAAC,cAAc,CAAC,CAAC;IAEhE,IAAI,GAAG,GAAkB,IAAI,CAAC;IAC9B,KAAK,MAAM,SAAS,IAAI,CAAC,cAAc,MAAM,EAAE,EAAE,uBAAuB,MAAM,EAAE,CAAC,EAAE,CAAC;QAClF,IAAI,MAAM,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,GAAG,GAAG,SAAS,CAAC;YAChB,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAEvD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,EAAE,eAAe,EAAE,GAAG,IAAI,MAAM,GAAG,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IAClH,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,MAAM,GAA0B,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACpF,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAChF,CAAC"}

package/dist/cli/runs.d.ts

@@ -0,0 +1,36 @@
+import { type FailurePhase, type RunStatus } from '@on-par/factory-core/internal';
+/** Row cap when `--limit` is not given. */
+export declare const DEFAULT_RUNS_LIMIT = 50;
+/** One row of `factory runs --json` (#2271). Unknown values are null, never omitted. */
+export interface RunsRowJson {
+    issue: number;
+    lane: string | null;
+    repo: string | null;
+    status: RunStatus | null;
+    phase: FailurePhase | null;
+    branch: string | null;
+    prNumber: number | null;
+    model: string | null;
+    attempts: number | null;
+    startedAt: string | null;
+    updatedAt: string;
+}
+/** `factory runs --json` payload (#2271). Additive changes only; bump schemaVersion on a breaking change. */
+export interface RunsJson {
+    schemaVersion: 1;
+    runs: RunsRowJson[];
+}
+/** Parse `--limit`: absent → the default, otherwise a positive integer or an Error. */
+export declare function parseRunsLimit(raw: string | undefined): number;
+/**
+ * Merge `issue-<n>.json` (IssueRunState) and `issue-<n>.phase.json` (RunPhaseSnapshot)
+ * in `runsDir` into one row per issue, newest `updatedAt` first, capped at `limit`.
+ * A missing dir is an empty list; malformed files are skipped and named in `skipped`.
+ */
+export declare function buildRunsJson(runsDir: string, { limit }?: {
+    limit?: number;
+}): Promise<{
+    json: RunsJson;
+    skipped: string[];
+}>;
+//# sourceMappingURL=runs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/cli/runs.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,SAAS,EACf,MAAM,+BAA+B,CAAC;AAEvC,2CAA2C;AAC3C,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,wFAAwF;AACxF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6GAA6G;AAC7G,MAAM,WAAW,QAAQ;IACvB,aAAa,EAAE,CAAC,CAAC;IACjB,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI9D;AAUD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,EAAE,KAA0B,EAAE,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,OAAO,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA4EhD"}

package/dist/cli/runs.js

@@ -0,0 +1,102 @@
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { readPhaseSnapshot } from '@on-par/factory-core';
+import { readIssueRunState, } from '@on-par/factory-core/internal';
+/** Row cap when `--limit` is not given. */
+export const DEFAULT_RUNS_LIMIT = 50;
+/** Parse `--limit`: absent → the default, otherwise a positive integer or an Error. */
+export function parseRunsLimit(raw) {
+    if (raw === undefined)
+        return DEFAULT_RUNS_LIMIT;
+    if (/^\d+$/.test(raw) && Number(raw) >= 1)
+        return Number(raw);
+    throw new Error(`invalid --limit '${raw}' — expected a positive integer`);
+}
+const str = (v) => (typeof v === 'string' && v.length > 0 ? v : null);
+const num = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : null);
+function time(iso) {
+    const t = Date.parse(iso);
+    return Number.isNaN(t) ? -Infinity : t;
+}
+/**
+ * Merge `issue-<n>.json` (IssueRunState) and `issue-<n>.phase.json` (RunPhaseSnapshot)
+ * in `runsDir` into one row per issue, newest `updatedAt` first, capped at `limit`.
+ * A missing dir is an empty list; malformed files are skipped and named in `skipped`.
+ */
+export async function buildRunsJson(runsDir, { limit = DEFAULT_RUNS_LIMIT } = {}) {
+    let names;
+    try {
+        names = await readdir(runsDir);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return { json: { schemaVersion: 1, runs: [] }, skipped: [] };
+        throw err;
+    }
+    const byIssue = new Map();
+    for (const name of names) {
+        const phaseMatch = /^issue-(\d+)\.phase\.json$/.exec(name);
+        const runMatch = phaseMatch ? null : /^issue-(\d+)\.json$/.exec(name);
+        const match = phaseMatch ?? runMatch;
+        if (!match)
+            continue;
+        const issue = Number(match[1]);
+        const entry = byIssue.get(issue) ?? {};
+        if (phaseMatch)
+            entry.phase = name;
+        else
+            entry.run = name;
+        byIssue.set(issue, entry);
+    }
+    const issues = [...byIssue.keys()].sort((a, b) => a - b);
+    const skipped = [];
+    const rows = [];
+    const note = (name) => {
+        skipped.push(`factory: runs — skipped malformed ${name}`);
+    };
+    const loaded = await Promise.all(issues.map(async (issue) => {
+        const files = byIssue.get(issue) ?? {};
+        const bad = [];
+        let state = null;
+        let snapshot = null;
+        if (files.run !== undefined) {
+            state = await readIssueRunState(join(runsDir, files.run));
+            if (state === null || typeof state.updatedAt !== 'string') {
+                state = null;
+                bad.push(files.run);
+            }
+        }
+        if (files.phase !== undefined) {
+            snapshot = await readPhaseSnapshot(join(runsDir, files.phase));
+            if (snapshot === null)
+                bad.push(files.phase);
+        }
+        return { issue, state, snapshot, bad };
+    }));
+    for (const { issue, state, snapshot, bad } of loaded) {
+        bad.forEach(note);
+        if (state === null && snapshot === null)
+            continue;
+        const updatedAt = state !== null && snapshot !== null
+            ? time(snapshot.updatedAt) > time(state.updatedAt)
+                ? snapshot.updatedAt
+                : state.updatedAt
+            : (state?.updatedAt ?? snapshot?.updatedAt ?? '');
+        rows.push({
+            issue,
+            lane: str(state?.lane),
+            repo: str(state?.repo),
+            status: str(state?.status),
+            phase: snapshot?.phase ?? null,
+            branch: str(state?.branch),
+            prNumber: num(state?.prNumber),
+            model: str(state?.model),
+            attempts: num(state?.attempts),
+            startedAt: str(state?.startedAt),
+            updatedAt,
+        });
+    }
+    rows.sort((a, b) => time(b.updatedAt) - time(a.updatedAt) || b.issue - a.issue);
+    return { json: { schemaVersion: 1, runs: rows.slice(0, limit) }, skipped };
+}
+//# sourceMappingURL=runs.js.map

package/dist/cli/runs.js.map

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

package/dist/cli/staleness.d.ts

@@ -0,0 +1,30 @@
+export interface StalenessDeps {
+    exists: (p: string) => boolean;
+    readFile: (p: string) => string;
+    /** Absolute paths of all files under dir, recursive. */
+    listFiles: (dir: string) => string[];
+    mtimeMs: (p: string) => number;
+}
+export declare function defaultStalenessDeps(): StalenessDeps;
+export declare function findWorkspaceRoot(startDir: string, deps: StalenessDeps): string | undefined;
+export interface PackageStaleness {
+    pkg: string;
+    stale: boolean;
+    reason: string;
+}
+export declare function checkDistFreshness(rootDir: string, deps: StalenessDeps): PackageStaleness[];
+export declare function formatStaleDistMessage(stale: PackageStaleness[], rootDir: string): string;
+export interface StalenessGuardOpts {
+    entryUrl: string;
+    env: NodeJS.ProcessEnv;
+    argv: string[];
+    error: (msg: string) => void;
+    warn: (msg: string) => void;
+    deps?: StalenessDeps;
+}
+export declare function runStalenessGuard(opts: StalenessGuardOpts): number | null;
+export declare function distFreshnessProbe(entryUrl: string, deps?: StalenessDeps): (() => {
+    fresh: boolean;
+    detail: string;
+}) | undefined;
+//# sourceMappingURL=staleness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"staleness.d.ts","sourceRoot":"","sources":["../../src/cli/staleness.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,wDAAwD;IACxD,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAChC;AAED,wBAAgB,oBAAoB,IAAI,aAAa,CAUpD;AAID,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAgB3F;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAeD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,gBAAgB,EAAE,CAuC3F;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQzF;AAID,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAyBzE;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,aAAsC,GAC3C,CAAC,MAAM;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAexD"}

package/dist/cli/staleness.js

@@ -0,0 +1,132 @@
+// packages/cli/src/cli/staleness.ts — refuse to run from a dist/ older than src/
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { dirname, join, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+export function defaultStalenessDeps() {
+    return {
+        exists: (p) => existsSync(p),
+        readFile: (p) => readFileSync(p, 'utf-8'),
+        listFiles: (dir) => {
+            const entries = readdirSync(dir, { recursive: true, withFileTypes: true });
+            return entries.filter((e) => e.isFile()).map((e) => join(e.parentPath, e.name));
+        },
+        mtimeMs: (p) => statSync(p).mtimeMs,
+    };
+}
+const RUNTIME_PACKAGES = ['config', 'core', 'tui', 'cli'];
+export function findWorkspaceRoot(startDir, deps) {
+    let dir = resolve(startDir);
+    for (;;) {
+        const pkgJsonPath = join(dir, 'package.json');
+        if (deps.exists(pkgJsonPath)) {
+            try {
+                const parsed = JSON.parse(deps.readFile(pkgJsonPath));
+                if (parsed.workspaces !== undefined)
+                    return dir;
+            }
+            catch {
+                // malformed package.json — not a match, keep walking
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+function isComparableSrcFile(path) {
+    return (path.endsWith('.ts') || path.endsWith('.tsx')) && !path.includes('.test.');
+}
+function newestMtime(files, deps) {
+    let newest = -Infinity;
+    for (const f of files) {
+        const mtime = deps.mtimeMs(f);
+        if (mtime > newest)
+            newest = mtime;
+    }
+    return newest;
+}
+export function checkDistFreshness(rootDir, deps) {
+    const results = [];
+    for (const pkg of RUNTIME_PACKAGES) {
+        const srcDir = join(rootDir, 'packages', pkg, 'src');
+        const distDir = join(rootDir, 'packages', pkg, 'dist');
+        if (!deps.exists(srcDir))
+            continue;
+        const srcFiles = deps.listFiles(srcDir).filter(isComparableSrcFile);
+        if (srcFiles.length === 0)
+            continue;
+        const newestSrc = newestMtime(srcFiles, deps);
+        if (!deps.exists(distDir)) {
+            results.push({ pkg, stale: true, reason: `${pkg}: dist/ missing` });
+            continue;
+        }
+        const distFiles = deps.listFiles(distDir);
+        if (distFiles.length === 0) {
+            results.push({ pkg, stale: true, reason: `${pkg}: dist/ empty` });
+            continue;
+        }
+        const newestDist = newestMtime(distFiles, deps);
+        if (newestSrc > newestDist) {
+            results.push({
+                pkg,
+                stale: true,
+                reason: `${pkg}: src is ${new Date(newestSrc).toISOString()} but dist is ${new Date(newestDist).toISOString()}`,
+            });
+        }
+        else {
+            results.push({ pkg, stale: false, reason: `${pkg}: dist newer than src` });
+        }
+    }
+    return results;
+}
+export function formatStaleDistMessage(stale, rootDir) {
+    const lines = ['factory: compiled dist is stale — refusing to run old code'];
+    for (const s of stale) {
+        lines.push(`  - ${s.reason}`);
+    }
+    lines.push(`fix: run 'npm run build' in ${rootDir}`);
+    lines.push('override: FACTORY_ALLOW_STALE=1 (runs anyway, at your own risk)');
+    return lines.join('\n');
+}
+const BYPASS_COMMANDS = new Set(['doctor', '--help', '-h', '--version', '-V']);
+export function runStalenessGuard(opts) {
+    const deps = opts.deps ?? defaultStalenessDeps();
+    const entryPath = fileURLToPath(opts.entryUrl);
+    if (!entryPath.split(sep).includes('dist'))
+        return null;
+    const root = findWorkspaceRoot(dirname(entryPath), deps);
+    if (root === undefined)
+        return null;
+    const stale = checkDistFreshness(root, deps).filter((p) => p.stale);
+    if (stale.length === 0)
+        return null;
+    const message = formatStaleDistMessage(stale, root);
+    if (opts.env.FACTORY_ALLOW_STALE === '1') {
+        opts.warn(`factory: FACTORY_ALLOW_STALE=1 — running stale dist:\n${message}`);
+        return null;
+    }
+    if (opts.argv[2] !== undefined && BYPASS_COMMANDS.has(opts.argv[2])) {
+        opts.warn(message);
+        return null;
+    }
+    opts.error(message);
+    return 2;
+}
+export function distFreshnessProbe(entryUrl, deps = defaultStalenessDeps()) {
+    const entryPath = fileURLToPath(entryUrl);
+    if (!entryPath.split(sep).includes('dist'))
+        return undefined;
+    const root = findWorkspaceRoot(dirname(entryPath), deps);
+    if (root === undefined)
+        return undefined;
+    return () => {
+        const results = checkDistFreshness(root, deps);
+        const stale = results.filter((r) => r.stale);
+        if (stale.length === 0) {
+            return { fresh: true, detail: 'dist newer than src' };
+        }
+        return { fresh: false, detail: stale.map((s) => s.reason).join('; ') };
+    };
+}
+//# sourceMappingURL=staleness.js.map

package/dist/cli/staleness.js.map

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

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

@@ -0,0 +1,45 @@
+import type { ActiveQueueClaim } from '@on-par/factory-core';
+/** One open provider in `factory status --json` (#1101). */
+export interface StatusBreakerProviderJson {
+    provider: string;
+    reason: string;
+    openedAt: string;
+    remainingSec: number;
+}
+/** Provider breaker state (state/breaker.json). `open` is true iff any provider is still open. */
+export interface StatusBreakerJson {
+    open: boolean;
+    providers: StatusBreakerProviderJson[];
+}
+/** One fresh-heartbeat local queue claim. */
+export interface StatusActiveRowJson {
+    lane: string;
+    issue: number;
+    phase: string;
+    ageSec: number;
+}
+/** `factory status --json` payload (#1101). No queue (#2268) or usage (#2270) section.
+ *  Additive changes only; bump schemaVersion on a breaking change. */
+export interface StatusJson {
+    schemaVersion: 1;
+    repo: string;
+    product: string | null;
+    stop: boolean;
+    breaker: StatusBreakerJson;
+    active: StatusActiveRowJson[];
+}
+/** Builds the `factory status --json` payload. An unparsable `lastActivityAt` reports `ageSec: 0`, never NaN. */
+export declare function buildStatusJson(input: {
+    repo: string;
+    product: string | null;
+    stop: boolean;
+    breakers: ReadonlyArray<{
+        provider: string;
+        reason: string;
+        openedAt: string;
+        remainingMs: number;
+    }>;
+    active: ReadonlyArray<Pick<ActiveQueueClaim, 'lane' | 'issue' | 'phase' | 'lastActivityAt'>>;
+    now: number;
+}): StatusJson;
+//# sourceMappingURL=status-json.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status-json.d.ts","sourceRoot":"","sources":["../../src/cli/status-json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,4DAA4D;AAC5D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,kGAAkG;AAClG,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,yBAAyB,EAAE,CAAC;CACxC;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;sEACsE;AACtE,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,CAAC,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED,iHAAiH;AACjH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,aAAa,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrG,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAC7F,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,UAAU,CAmBb"}

package/dist/cli/status-json.js

@@ -0,0 +1,22 @@
+/** Builds the `factory status --json` payload. An unparsable `lastActivityAt` reports `ageSec: 0`, never NaN. */
+export function buildStatusJson(input) {
+    const providers = input.breakers.map((b) => ({
+        provider: b.provider,
+        reason: b.reason,
+        openedAt: b.openedAt,
+        remainingSec: Math.ceil(b.remainingMs / 1000),
+    }));
+    const active = input.active.map((c) => {
+        const ageSec = Math.floor((input.now - Date.parse(c.lastActivityAt)) / 1000);
+        return { lane: c.lane, issue: c.issue, phase: c.phase, ageSec: Number.isFinite(ageSec) ? Math.max(0, ageSec) : 0 };
+    });
+    return {
+        schemaVersion: 1,
+        repo: input.repo,
+        product: input.product,
+        stop: input.stop,
+        breaker: { open: providers.length > 0, providers },
+        active,
+    };
+}
+//# sourceMappingURL=status-json.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status-json.js","sourceRoot":"","sources":["../../src/cli/status-json.ts"],"names":[],"mappings":"AAmCA,iHAAiH;AACjH,MAAM,UAAU,eAAe,CAAC,KAO/B;IACC,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3C,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC;KAC9C,CAAC,CAAC,CAAC;IACJ,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7E,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrH,CAAC,CAAC,CAAC;IACH,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,SAAS,EAAE;QAClD,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/cli/stop-resume-json.d.ts

@@ -0,0 +1,18 @@
+/** `factory stop|resume --json` payload (#2276). Additive changes only; bump schemaVersion on a breaking change. */
+export interface StopResumeJson {
+    schemaVersion: 1;
+    ok: true;
+    action: 'stop' | 'resume';
+    repo: string;
+    stopFlag: {
+        before: boolean;
+        after: boolean;
+    };
+}
+export declare function buildStopResumeJson(input: {
+    action: 'stop' | 'resume';
+    repo: string;
+    before: boolean;
+    after: boolean;
+}): StopResumeJson;
+//# sourceMappingURL=stop-resume-json.d.ts.map

package/dist/cli/stop-resume-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-resume-json.d.ts","sourceRoot":"","sources":["../../src/cli/stop-resume-json.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,CAAC,CAAC;IACjB,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CAC/C;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,cAAc,CAQjB"}

package/dist/cli/stop-resume-json.js

@@ -0,0 +1,10 @@
+export function buildStopResumeJson(input) {
+    return {
+        schemaVersion: 1,
+        ok: true,
+        action: input.action,
+        repo: input.repo,
+        stopFlag: { before: input.before, after: input.after },
+    };
+}
+//# sourceMappingURL=stop-resume-json.js.map

package/dist/cli/stop-resume-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-resume-json.js","sourceRoot":"","sources":["../../src/cli/stop-resume-json.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,mBAAmB,CAAC,KAKnC;IACC,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,EAAE,EAAE,IAAI;QACR,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;KACvD,CAAC;AACJ,CAAC"}

package/dist/cli/stop-sentinel.d.ts

@@ -0,0 +1,23 @@
+import type { DoctorCheck } from './doctor.js';
+export interface StopFileDeps {
+    pathExists: (p: string) => boolean;
+    statMtimeMs: (p: string) => number;
+    now: () => number;
+}
+export declare function defaultStopFileDeps(): StopFileDeps;
+export type StopSentinelStatus = {
+    present: false;
+} | {
+    present: true;
+    ageMs: number;
+    writtenAt: string;
+};
+export declare function readStopFileStatus(paths: {
+    stop: string;
+}, deps?: Partial<StopFileDeps>): StopSentinelStatus;
+/** Human-readable age like "3h 12m", "45s", or "820ms". */
+export declare function formatStopFileAge(ms: number): string;
+/** Message logged/printed by `factory run` when it skips a pass because STOP is present. */
+export declare function stopSentinelRunSkipMessage(status: StopSentinelStatus): string;
+export declare function stopSentinelCheck(status: StopSentinelStatus): DoctorCheck;
+//# sourceMappingURL=stop-sentinel.d.ts.map

package/dist/cli/stop-sentinel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-sentinel.d.ts","sourceRoot":"","sources":["../../src/cli/stop-sentinel.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAED,wBAAgB,mBAAmB,IAAI,YAAY,CAMlD;AAED,MAAM,MAAM,kBAAkB,GAAG;IAAE,OAAO,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1G,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,kBAAkB,CAShH;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAQpD;AAED,4FAA4F;AAC5F,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAO7E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,WAAW,CAezE"}