@on-par/factory-cli 0.9.7-next.3 → 0.9.7-next.31

package/dist/cli/doctor-config.d.ts

@@ -0,0 +1,14 @@
+import type { DeclaredHarnessProbe } from '@on-par/factory-core';
+import type { ConfigLintInput } from '@on-par/factory-core/internal';
+import { type DoctorCheck } from './doctor.js';
+/** One doctor check per user-declared harness, from its `probe` result. */
+export declare function declaredHarnessChecks(probes: DeclaredHarnessProbe[]): DoctorCheck[];
+/** One failed check per models.registry entry whose harness is missing or unknown;
+ *  a single ok row when every entry is valid; nothing when there is no registry. */
+export declare function modelsRegistryChecks(configPath: string, registry: Readonly<Record<string, {
+    harness?: string;
+}>> | undefined, validHarnesses: readonly string[]): DoctorCheck[];
+/** `config` rows from the shared pre-PLAN lint (#2612): one failing row per finding, so doctor fails exactly when
+ *  the run preflight would escalate or park. A single ok row when clean. Read-only. */
+export declare function configLintChecks(input: ConfigLintInput, loadError?: string): DoctorCheck[];
+//# sourceMappingURL=doctor-config.d.ts.map

package/dist/cli/doctor-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-config.d.ts","sourceRoot":"","sources":["../../src/cli/doctor-config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAQrE,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,aAAa,CAAC;AAE7D,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,WAAW,EAAE,CAoBnF;AAID;oFACoF;AACpF,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,GAAG,SAAS,EACpE,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,WAAW,EAAE,CA0Bf;AAED;uFACuF;AACvF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CA4D1F"}

package/dist/cli/doctor-config.js

@@ -0,0 +1,126 @@
+// packages/cli/src/cli/doctor-config.ts — config and registry rows, moved out of doctor.ts (#2799)
+import { existsSync } from 'node:fs';
+import { findConfigSchemaErrors, isTemplateToken, lintFactoryConfig, listBuiltInCheckers, } from '@on-par/factory-core/internal';
+import { REPO_SECTION } from './doctor.js';
+/** One doctor check per user-declared harness, from its `probe` result. */
+export function declaredHarnessChecks(probes) {
+    return probes.map((p) => {
+        const name = `harness ${p.harness}`;
+        if (p.status === 'available')
+            return { name, ok: true, detail: `available (probe: ${p.probe})` };
+        if (p.status === 'unavailable') {
+            return {
+                name,
+                ok: false,
+                detail: `unavailable: probe \`${p.probe}\` failed: ${p.detail}`,
+                fix: 'install the agent CLI on PATH or fix the "probe" command in the models config harnesses section',
+            };
+        }
+        return {
+            name,
+            ok: false,
+            optional: true,
+            detail: 'unverified: no probe configured',
+            fix: 'add a "probe" command (exit 0 = reachable) to the harness in the models config',
+        };
+    });
+}
+const REGISTRY_CHECK = 'models.registry';
+/** One failed check per models.registry entry whose harness is missing or unknown;
+ *  a single ok row when every entry is valid; nothing when there is no registry. */
+export function modelsRegistryChecks(configPath, registry, validHarnesses) {
+    const entries = Object.entries(registry ?? {});
+    if (entries.length === 0)
+        return [];
+    const failed = [];
+    for (const [id, def] of entries) {
+        const field = `models.registry.${id}.harness`;
+        const name = `${REGISTRY_CHECK} ${id}`;
+        if (def.harness === undefined || def.harness.trim() === '') {
+            failed.push({
+                name,
+                ok: false,
+                detail: `${configPath}: ${field} is missing`,
+                fix: `set "harness" to one of: ${validHarnesses.join(', ')}`,
+            });
+        }
+        else if (!validHarnesses.includes(def.harness)) {
+            failed.push({
+                name,
+                ok: false,
+                detail: `${configPath}: ${field} '${def.harness}' is not a known harness (valid harnesses: ${validHarnesses.join(', ')})`,
+                fix: 'use a built-in harness id or declare it under "harnesses" in the models config',
+            });
+        }
+    }
+    if (failed.length > 0)
+        return failed;
+    const n = entries.length;
+    return [{ name: REGISTRY_CHECK, ok: true, detail: `${n} entr${n === 1 ? 'y' : 'ies'} valid (${configPath})` }];
+}
+/** `config` rows from the shared pre-PLAN lint (#2612): one failing row per finding, so doctor fails exactly when
+ *  the run preflight would escalate or park. A single ok row when clean. Read-only. */
+export function configLintChecks(input, loadError) {
+    const schemaRows = (input.configFile ? findConfigSchemaErrors(input.configFile) : []).map((f) => ({
+        name: 'config',
+        ok: false,
+        section: REPO_SECTION,
+        detail: `${f.file}${f.line ? `:${f.line}` : ''}: schema error at '${f.path}': ${f.message}`,
+        fix: f.fix,
+    }));
+    if (loadError !== undefined) {
+        return [
+            {
+                name: 'config',
+                ok: false,
+                section: REPO_SECTION,
+                detail: loadError,
+                fix: 'fix the constitution frontmatter YAML',
+            },
+            ...schemaRows,
+        ];
+    }
+    const { findings } = lintFactoryConfig(input);
+    if (findings.length > 0) {
+        const names = [...listBuiltInCheckers().map((c) => c.name), 'custom_*'].join(', ');
+        const lintRows = findings.map((f) => {
+            const where = `${f.file}${f.line ? `:${f.line}` : ''}`;
+            if (f.rule === 'unknown-checker') {
+                const kind = isTemplateToken(f.token) ? 'placeholder' : 'unknown';
+                return {
+                    name: 'config',
+                    ok: false,
+                    section: REPO_SECTION,
+                    detail: `${where}: ${kind} checker '${f.token}'`,
+                    fix: `replace '${f.token}' with a real checker name (${names}) or delete the line`,
+                };
+            }
+            return {
+                name: 'config',
+                ok: false,
+                section: REPO_SECTION,
+                detail: `${where}: unfilled template token '${f.token}'`,
+                fix: `replace '${f.token}' with a real value`,
+            };
+        });
+        return [...lintRows, ...schemaRows];
+    }
+    if (schemaRows.length > 0)
+        return schemaRows;
+    const scanned = [];
+    if (input.constitution?.repoInstance)
+        scanned.push(input.constitution.repoInstance.relPath);
+    if (input.configFile && existsSync(input.configFile.absPath))
+        scanned.push(input.configFile.relPath);
+    return [
+        {
+            name: 'config',
+            ok: true,
+            section: REPO_SECTION,
+            detail: scanned.length > 0
+                ? `no unfilled placeholders, unknown checkers or schema errors in ${scanned.join(', ')}`
+                : 'no constitution or config file to scan',
+        },
+    ];
+}
+//# sourceMappingURL=doctor-config.js.map

package/dist/cli/doctor-config.js.map

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

package/dist/cli/doctor-harness-view.d.ts

@@ -0,0 +1,18 @@
+import type { DoctorRuntime } from './doctor.js';
+/** The harness view doctor judges with: packaged harnesses merged with `.factory/config.yaml` (#2870). */
+export interface DoctorHarnessView {
+    /** `applyRepoConfig(...).harnesses`; undefined when loading or merging threw. */
+    merged?: Readonly<Record<string, {
+        command: string;
+        agentic: boolean;
+    }>>;
+    registry?: Readonly<Record<string, {
+        harness?: string;
+    }>>;
+    /** Packaged plus repo-declared harness ids, even when the merge threw. */
+    declaredIds: string[];
+    /** The applyRepoConfig error; undefined when it succeeded or when loading the repo config threw (the config row reports that). */
+    mergeError?: string;
+}
+export declare function resolveDoctorHarnesses(loaders: Pick<DoctorRuntime['configLoaders'], 'loadModelsConfig' | 'loadRepoConfig'>, repoRoot: string): DoctorHarnessView;
+//# sourceMappingURL=doctor-harness-view.d.ts.map

package/dist/cli/doctor-harness-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-harness-view.d.ts","sourceRoot":"","sources":["../../src/cli/doctor-harness-view.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,0GAA0G;AAC1G,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAC;IACzE,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC1D,0EAA0E;IAC1E,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kIAAkI;IAClI,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,EAAE,kBAAkB,GAAG,gBAAgB,CAAC,EACpF,QAAQ,EAAE,MAAM,GACf,iBAAiB,CAgBnB"}

package/dist/cli/doctor-harness-view.js

@@ -0,0 +1,21 @@
+import { applyRepoConfig } from '@on-par/factory-core';
+export function resolveDoctorHarnesses(loaders, repoRoot) {
+    let models;
+    let repo;
+    try {
+        models = loaders.loadModelsConfig();
+        repo = loaders.loadRepoConfig(repoRoot);
+    }
+    catch {
+        return { declaredIds: [] };
+    }
+    const registry = repo?.models?.registry;
+    const declaredIds = [...new Set([...Object.keys(models.harnesses ?? {}), ...Object.keys(repo?.harnesses ?? {})])];
+    try {
+        return { merged: applyRepoConfig(models, repo).harnesses, registry, declaredIds };
+    }
+    catch (err) {
+        return { registry, declaredIds, mergeError: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=doctor-harness-view.js.map

package/dist/cli/doctor-harness-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-harness-view.js","sourceRoot":"","sources":["../../src/cli/doctor-harness-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAevD,MAAM,UAAU,sBAAsB,CACpC,OAAoF,EACpF,QAAgB;IAEhB,IAAI,MAAmD,CAAC;IACxD,IAAI,IAA+C,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;QACpC,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAC7B,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC;IACxC,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAClH,IAAI,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IACpF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACjG,CAAC;AACH,CAAC"}

package/dist/cli/doctor-health.d.ts

@@ -0,0 +1,73 @@
+import type { DoctorCheck } from './doctor.js';
+export interface LeaseHealthRow {
+    worktreeId: string;
+    branch: string;
+    port: number;
+    pid: number;
+    alive: boolean;
+    reason?: 'dead-pid' | 'missing-worktree';
+    portSquatted?: boolean;
+}
+export declare function leaseChecks(rows: LeaseHealthRow[]): DoctorCheck[];
+export interface EventLogIntegrity {
+    total: number;
+    unparseable: number;
+}
+export declare function analyzeEventLog(content: string): EventLogIntegrity;
+export declare function eventLogCheck(integrity: EventLogIntegrity | null): DoctorCheck;
+export interface ReapRow {
+    name: string;
+    removed: boolean;
+    detail: string;
+}
+export declare function orphanContainerChecks(names: readonly string[]): DoctorCheck[];
+export declare function orphanMicroVmChecks(names: readonly string[]): DoctorCheck[];
+export declare function formatContainerReconcileReport(reaped: ReapRow[]): string;
+export declare function formatMicroVmReconcileReport(reaped: ReapRow[]): string;
+export declare function formatReconcileReport(reaped: Array<{
+    lease: {
+        worktreeId: string;
+        port: number;
+    };
+    reason: string;
+}>): string;
+/** One worktree the reconcile pass removed. Structurally the subset of core's `GcCandidate`
+ *  that the report renders — kept local so `doctor.ts` stays dependency-free and unit-testable. */
+export interface ReconciledWorktree {
+    path: string;
+    branch: string | null;
+    reason: string;
+    branchDeleted: boolean;
+}
+export declare function formatWorktreeReconcileReport(removed: ReconciledWorktree[]): string;
+/** One claim the reconcile pass put back in the queue. Structurally the subset of core's
+ *  `StaleClaimRelease` that the report renders — kept local so `doctor.ts` stays
+ *  dependency-free and unit-testable. */
+export interface ReleasedClaim {
+    issue: number;
+    expiresAt: number;
+    released: boolean;
+    detail?: string;
+}
+export declare function formatClaimReconcileReport(released: ReleasedClaim[]): string;
+/** One green-and-ready PR nobody merged. Structurally the subset of core's `UnmergedGreenPr`
+ *  the report renders — kept local so `doctor.ts` stays dependency-free and unit-testable. */
+export interface UnmergedGreenPrRow {
+    number: number;
+    branch: string;
+    issue: number | null;
+    ageHours: number;
+}
+/** Outcome of the green-PR scan: it ran, it was skipped (no repo/token), or it failed. */
+export type GreenPrScanResult = {
+    status: 'ok';
+    rows: UnmergedGreenPrRow[];
+} | {
+    status: 'skipped';
+    detail: string;
+} | {
+    status: 'failed';
+    detail: string;
+};
+export declare function unmergedGreenPrChecks(result: GreenPrScanResult): DoctorCheck[];
+//# sourceMappingURL=doctor-health.d.ts.map

package/dist/cli/doctor-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-health.d.ts","sourceRoot":"","sources":["../../src/cli/doctor-health.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,UAAU,GAAG,kBAAkB,CAAC;IACzC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,WAAW,EAAE,CAwBjE;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAWlE;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI,GAAG,WAAW,CAuB9E;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,EAAE,CAU7E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,EAAE,CAU3E;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CASxE;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAStE;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7E,MAAM,CAMR;AAED;mGACmG;AACnG,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAUnF;AAED;;yCAEyC;AACzC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,CAU5E;AAED;8FAC8F;AAC9F,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,0FAA0F;AAC1F,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,kBAAkB,EAAE,CAAA;CAAE,GAC5C;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAIzC,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,EAAE,CAyB9E"}

package/dist/cli/doctor-health.js

@@ -0,0 +1,156 @@
+// packages/cli/src/cli/doctor-health.ts — runtime-health rows and reconcile reports, moved out of doctor.ts (#2799)
+export function leaseChecks(rows) {
+    if (rows.length === 0) {
+        return [{ name: 'port leases', ok: true, optional: true, detail: 'no active leases' }];
+    }
+    return rows.map((row) => {
+        if (row.alive) {
+            return {
+                name: `port lease :${row.port}`,
+                ok: true,
+                optional: true,
+                detail: `${row.worktreeId}: port ${row.port}, pid ${row.pid}, live`,
+            };
+        }
+        const squatted = row.portSquatted ? '; port still in use by another process' : '';
+        return {
+            name: `port lease :${row.port}`,
+            ok: false,
+            optional: true,
+            detail: `${row.worktreeId}: port ${row.port}, pid ${row.pid}, stale (${row.reason})${squatted}`,
+            fix: 'run `factory doctor --reconcile` to reclaim stale leases',
+        };
+    });
+}
+export function analyzeEventLog(content) {
+    const lines = content.split('\n').filter((l) => l.trim() !== '');
+    let unparseable = 0;
+    for (const line of lines) {
+        try {
+            JSON.parse(line);
+        }
+        catch {
+            unparseable++;
+        }
+    }
+    return { total: lines.length, unparseable };
+}
+export function eventLogCheck(integrity) {
+    if (integrity === null) {
+        return { name: 'event log integrity', ok: true, optional: true, detail: 'no events.ndjson yet' };
+    }
+    if (integrity.total === 0) {
+        return { name: 'event log integrity', ok: true, optional: true, detail: 'events.ndjson is empty' };
+    }
+    const pct = ((integrity.unparseable / integrity.total) * 100).toFixed(1);
+    if (integrity.unparseable === 0) {
+        return {
+            name: 'event log integrity',
+            ok: true,
+            optional: true,
+            detail: `${integrity.total} lines, 0 unparseable (0.0%)`,
+        };
+    }
+    return {
+        name: 'event log integrity',
+        ok: false,
+        optional: true,
+        detail: `${integrity.unparseable} of ${integrity.total} lines unparseable (${pct}%)`,
+        fix: 'historical corruption from pre-lock parallel writes; appends are now serialized; metrics over this file carry this error bar',
+    };
+}
+export function orphanContainerChecks(names) {
+    if (names.length === 0) {
+        return [{ name: 'orphan containers', ok: true, detail: 'no orphan sf-job-*/factory.managed containers' }];
+    }
+    return names.map((name) => ({
+        name: `orphan container ${name}`,
+        ok: false,
+        detail: `${name} is stopped and not tied to any running job`,
+        fix: 'run `factory doctor --reconcile` to remove it and its anonymous volumes',
+    }));
+}
+export function orphanMicroVmChecks(names) {
+    if (names.length === 0) {
+        return [{ name: 'orphan sbx VMs', ok: true, detail: 'no orphan factory-* sbx VMs' }];
+    }
+    return names.map((name) => ({
+        name: `orphan sbx VM ${name}`,
+        ok: false,
+        detail: `${name} has no active lane holding its worktree`,
+        fix: 'run `factory doctor --reconcile` to remove it via `sbx rm --force`',
+    }));
+}
+export function formatContainerReconcileReport(reaped) {
+    if (reaped.length === 0)
+        return 'reconcile: no orphan containers';
+    return reaped
+        .map((r) => r.removed
+        ? `reconcile: removed container ${r.name}`
+        : `reconcile: failed to remove container ${r.name}: ${r.detail}`)
+        .join('\n');
+}
+export function formatMicroVmReconcileReport(reaped) {
+    if (reaped.length === 0)
+        return 'reconcile: no orphan sbx VMs';
+    return reaped
+        .map((r) => r.removed
+        ? `reconcile: removed sbx VM ${r.name} (sbx rm --force)`
+        : `reconcile: failed to remove sbx VM ${r.name}: ${r.detail}`)
+        .join('\n');
+}
+export function formatReconcileReport(reaped) {
+    if (reaped.length === 0)
+        return 'reconcile: no stale leases';
+    return reaped
+        .map((r) => `reconcile: freed port ${r.lease.port} (worktree ${r.lease.worktreeId}, reason ${r.reason})`)
+        .join('\n');
+}
+export function formatWorktreeReconcileReport(removed) {
+    if (removed.length === 0)
+        return 'reconcile: no dead-run worktrees';
+    return removed
+        .map((w) => {
+        const branchLabel = w.branch ?? 'detached';
+        const deleted = w.branchDeleted ? `, deleted branch ${w.branch}` : '';
+        return `reconcile: removed worktree ${w.path} (branch ${branchLabel}, reason ${w.reason})${deleted}`;
+    })
+        .join('\n');
+}
+export function formatClaimReconcileReport(released) {
+    if (released.length === 0)
+        return 'reconcile: no stale claims';
+    return released
+        .map((c) => c.released
+        ? `reconcile: released issue #${c.issue} back to factory:queued (lease expired at ${c.expiresAt})`
+        : `reconcile: failed to release issue #${c.issue} (lease expired at ${c.expiresAt}): ${c.detail ?? 'unknown error'}`)
+        .join('\n');
+}
+const GREEN_PR_CHECK = 'green PRs awaiting merge';
+export function unmergedGreenPrChecks(result) {
+    if (result.status === 'skipped') {
+        return [{ name: GREEN_PR_CHECK, ok: true, optional: true, detail: result.detail }];
+    }
+    if (result.status === 'failed') {
+        return [
+            {
+                name: GREEN_PR_CHECK,
+                ok: false,
+                optional: true,
+                detail: `scan failed: ${result.detail}`,
+                fix: 'check `gh auth status` and network access, then re-run `factory doctor`',
+            },
+        ];
+    }
+    if (result.rows.length === 0) {
+        return [{ name: GREEN_PR_CHECK, ok: true, optional: true, detail: 'no green-and-ready PRs awaiting merge' }];
+    }
+    return result.rows.map((row) => ({
+        name: `green PR #${row.number}`,
+        ok: false,
+        optional: true,
+        detail: `${row.issue === null ? 'owning issue unknown' : `issue #${row.issue}`}: green and ready on ${row.branch}, open ${row.ageHours}h, not merged`,
+        fix: `review and merge #${row.number} (or close it); the factory never auto-merges an orphaned PR`,
+    }));
+}
+//# sourceMappingURL=doctor-health.js.map

package/dist/cli/doctor-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-health.js","sourceRoot":"","sources":["../../src/cli/doctor-health.ts"],"names":[],"mappings":"AAAA,oHAAoH;AAcpH,MAAM,UAAU,WAAW,CAAC,IAAsB;IAChD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACtB,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YACd,OAAO;gBACL,IAAI,EAAE,eAAe,GAAG,CAAC,IAAI,EAAE;gBAC/B,EAAE,EAAE,IAAI;gBACR,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,UAAU,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,GAAG,QAAQ;aACpE,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,wCAAwC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,OAAO;YACL,IAAI,EAAE,eAAe,GAAG,CAAC,IAAI,EAAE;YAC/B,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,UAAU,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC,MAAM,IAAI,QAAQ,EAAE;YAC/F,GAAG,EAAE,0DAA0D;SAChE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAOD,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjE,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,WAAW,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAmC;IAC/D,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACnG,CAAC;IACD,IAAI,SAAS,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACrG,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,WAAW,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACzE,IAAI,SAAS,CAAC,WAAW,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,qBAAqB;YAC3B,EAAE,EAAE,IAAI;YACR,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,GAAG,SAAS,CAAC,KAAK,8BAA8B;SACzD,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,EAAE,EAAE,KAAK;QACT,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,GAAG,SAAS,CAAC,WAAW,OAAO,SAAS,CAAC,KAAK,uBAAuB,GAAG,IAAI;QACpF,GAAG,EAAE,8HAA8H;KACpI,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,qBAAqB,CAAC,KAAwB;IAC5D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,+CAA+C,EAAE,CAAC,CAAC;IAC5G,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,oBAAoB,IAAI,EAAE;QAChC,EAAE,EAAE,KAAK;QACT,MAAM,EAAE,GAAG,IAAI,6CAA6C;QAC5D,GAAG,EAAE,yEAAyE;KAC/E,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAwB;IAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,6BAA6B,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,iBAAiB,IAAI,EAAE;QAC7B,EAAE,EAAE,KAAK;QACT,MAAM,EAAE,GAAG,IAAI,0CAA0C;QACzD,GAAG,EAAE,oEAAoE;KAC1E,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAAiB;IAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,iCAAiC,CAAC;IAClE,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,CAAC,CAAC,OAAO;QACP,CAAC,CAAC,gCAAgC,CAAC,CAAC,IAAI,EAAE;QAC1C,CAAC,CAAC,yCAAyC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,CACnE;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,8BAA8B,CAAC;IAC/D,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,CAAC,CAAC,OAAO;QACP,CAAC,CAAC,6BAA6B,CAAC,CAAC,IAAI,mBAAmB;QACxD,CAAC,CAAC,sCAAsC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,CAChE;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAA8E;IAE9E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,4BAA4B,CAAC;IAE7D,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,yBAAyB,CAAC,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,CAAC,KAAK,CAAC,UAAU,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC;SACxG,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAWD,MAAM,UAAU,6BAA6B,CAAC,OAA6B;IACzE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,kCAAkC,CAAC;IAEpE,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,IAAI,UAAU,CAAC;QAC3C,MAAM,OAAO,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,OAAO,+BAA+B,CAAC,CAAC,IAAI,YAAY,WAAW,YAAY,CAAC,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC;IACvG,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAYD,MAAM,UAAU,0BAA0B,CAAC,QAAyB;IAClE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,4BAA4B,CAAC;IAE/D,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,CAAC,CAAC,QAAQ;QACR,CAAC,CAAC,8BAA8B,CAAC,CAAC,KAAK,6CAA6C,CAAC,CAAC,SAAS,GAAG;QAClG,CAAC,CAAC,uCAAuC,CAAC,CAAC,KAAK,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,MAAM,IAAI,eAAe,EAAE,CACvH;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAiBD,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAElD,MAAM,UAAU,qBAAqB,CAAC,MAAyB;IAC7D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO;YACL;gBACE,IAAI,EAAE,cAAc;gBACpB,EAAE,EAAE,KAAK;gBACT,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,gBAAgB,MAAM,CAAC,MAAM,EAAE;gBACvC,GAAG,EAAE,yEAAyE;aAC/E;SACF,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,uCAAuC,EAAE,CAAC,CAAC;IAC/G,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC/B,IAAI,EAAE,aAAa,GAAG,CAAC,MAAM,EAAE;QAC/B,EAAE,EAAE,KAAK;QACT,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,KAAK,EAAE,wBAAwB,GAAG,CAAC,MAAM,UAAU,GAAG,CAAC,QAAQ,eAAe;QACrJ,GAAG,EAAE,qBAAqB,GAAG,CAAC,MAAM,8DAA8D;KACnG,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/cli/doctor-queue-reconcile.d.ts

@@ -0,0 +1,7 @@
+import type { Octokit } from '@octokit/rest';
+import type { CliDeps } from './index.js';
+type QueueOps = Required<Pick<CliDeps, 'releaseStaleClaims' | 'pollBlockedParks'>>;
+/** Never throws: each step prints its own failure line. */
+export declare function reconcileQueue(ops: QueueOps, ghRepo: string | undefined, octokit: Octokit | undefined, eventsFile: string): Promise<void>;
+export {};
+//# sourceMappingURL=doctor-queue-reconcile.d.ts.map

package/dist/cli/doctor-queue-reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-queue-reconcile.d.ts","sourceRoot":"","sources":["../../src/cli/doctor-queue-reconcile.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAK7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,KAAK,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,oBAAoB,GAAG,kBAAkB,CAAC,CAAC,CAAC;AAInF,2DAA2D;AAC3D,wBAAsB,cAAc,CAClC,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA2Cf"}

package/dist/cli/doctor-queue-reconcile.js

@@ -0,0 +1,55 @@
+// packages/cli/src/cli/doctor-queue-reconcile.ts — `doctor --reconcile` queue steps: stale claims (#999) and blocked parks (#2318)
+import { createLogger } from '@on-par/factory-core';
+import { createOctokitBlockedParkStore, createOctokitQueueClient } from '@on-par/factory-core/internal';
+import { formatClaimReconcileReport } from './doctor-health.js';
+const errMessage = (err) => err?.message ?? String(err);
+/** Never throws: each step prints its own failure line. */
+export async function reconcileQueue(ops, ghRepo, octokit, eventsFile) {
+    const [owner, repo] = ghRepo?.split('/') ?? [];
+    // Stale claim reap (#999): factory:in-progress claims naming a dead local pid go back to
+    // factory:queued so the next run can claim them with no manual label surgery.
+    try {
+        if (ghRepo && octokit) {
+            const released = await ops.releaseStaleClaims({ client: createOctokitQueueClient(octokit), owner, repo });
+            console.log(formatClaimReconcileReport(released));
+        }
+        else {
+            console.log('reconcile: skipping stale claims: no GitHub repo or token');
+        }
+    }
+    catch (err) {
+        console.log(`reconcile: stale claim release failed: ${errMessage(err)}`);
+    }
+    // Blocked-park poll (#2318): parents parked `blocked` resume once their blockers close.
+    try {
+        if (ghRepo && octokit) {
+            const results = await ops.pollBlockedParks({
+                client: createOctokitQueueClient(octokit),
+                owner,
+                repo,
+                store: createOctokitBlockedParkStore(octokit, ghRepo),
+                logEvent: (kind, issue, msg) => {
+                    const log = createLogger(eventsFile, { issue }, { out: { write: () => true } });
+                    if (kind === 'warn')
+                        log.warn('warn', msg);
+                    else
+                        log.info('issue_unparked', msg);
+                },
+            });
+            const count = (o) => results.filter((r) => r.outcome === o).length;
+            console.log(`reconcile: blocked parks: ${count('unparked')} unparked, ${count('held')} held, ${count('capped')} capped, ${count('waiting')} waiting`);
+            for (const r of results) {
+                if (r.outcome === 'waiting' || r.outcome === 'skipped')
+                    continue;
+                console.log(`reconcile:   #${r.issue} ${r.outcome}${r.detail ? ` — ${r.detail}` : ''}`);
+            }
+        }
+        else {
+            console.log('reconcile: skipping blocked parks: no GitHub repo or token');
+        }
+    }
+    catch (err) {
+        console.log(`reconcile: blocked park poll failed: ${errMessage(err)}`);
+    }
+}
+//# sourceMappingURL=doctor-queue-reconcile.js.map

package/dist/cli/doctor-queue-reconcile.js.map

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