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

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/state-root.d.ts

@@ -0,0 +1,5 @@
+/** The flag wins over the env var. A resolved root is written back to `env` as an absolute
+ *  path so every child process (lanes, CHECK) skips the git lookup and any cwd difference.
+ *  Invalid values throw. */
+export declare function applyStateRootOption(flag: string | undefined, repoRoot: string, env?: NodeJS.ProcessEnv): string | undefined;
+//# sourceMappingURL=state-root.d.ts.map

package/dist/cli/state-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-root.d.ts","sourceRoot":"","sources":["../../src/cli/state-root.ts"],"names":[],"mappings":"AAIA;;4BAE4B;AAC5B,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,SAAS,CAIpB"}

package/dist/cli/state-root.js

@@ -0,0 +1,12 @@
+// src/cli/state-root.ts — Applies the global `--state-root` flag / FACTORY_STATE_ROOT env (#2281).
+import { resolveStateRoot, STATE_ROOT_ENV } from '@on-par/factory-core/internal';
+/** The flag wins over the env var. A resolved root is written back to `env` as an absolute
+ *  path so every child process (lanes, CHECK) skips the git lookup and any cwd difference.
+ *  Invalid values throw. */
+export function applyStateRootOption(flag, repoRoot, env = process.env) {
+    const resolved = resolveStateRoot(flag ?? env[STATE_ROOT_ENV], { repoRoot });
+    if (resolved !== undefined)
+        env[STATE_ROOT_ENV] = resolved;
+    return resolved;
+}
+//# sourceMappingURL=state-root.js.map

package/dist/cli/state-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-root.js","sourceRoot":"","sources":["../../src/cli/state-root.ts"],"names":[],"mappings":"AAAA,mGAAmG;AAEnG,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEjF;;4BAE4B;AAC5B,MAAM,UAAU,oBAAoB,CAClC,IAAwB,EACxB,QAAgB,EAChB,GAAG,GAAsB,OAAO,CAAC,GAAG;IAEpC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,IAAI,GAAG,CAAC,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7E,IAAI,QAAQ,KAAK,SAAS;QAAE,GAAG,CAAC,cAAc,CAAC,GAAG,QAAQ,CAAC;IAC3D,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,49 @@
+import type { ActiveQueueClaim } from '@on-par/factory-core';
+import type { StatusUpdateJson } from './update-state.js';
+/** 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[];
+    /** factoryd self-update state (#2129, additive); null when no readable update-state.json exists. */
+    update: StatusUpdateJson | null;
+}
+/** 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'>>;
+    update: StatusUpdateJson | null;
+    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;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,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;IAC9B,oGAAoG;IACpG,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACjC;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,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,UAAU,CAoBb"}

package/dist/cli/status-json.js

@@ -0,0 +1,23 @@
+/** 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,
+        update: input.update,
+    };
+}
+//# 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":"AAsCA,iHAAiH;AACjH,MAAM,UAAU,eAAe,CAAC,KAQ/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;QACN,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,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"}

package/dist/cli/stop-sentinel.js

@@ -0,0 +1,61 @@
+// packages/cli/src/cli/stop-sentinel.ts — `.factory/STOP` presence as pure
+// state, shared by `factory run`'s skip-and-log path and `factory doctor`'s
+// explicit status row. STOP is never written or deleted from this module.
+import { existsSync, statSync } from 'node:fs';
+export function defaultStopFileDeps() {
+    return {
+        pathExists: (p) => existsSync(p),
+        statMtimeMs: (p) => statSync(p).mtimeMs,
+        now: () => Date.now(),
+    };
+}
+export function readStopFileStatus(paths, deps = {}) {
+    const { pathExists, statMtimeMs, now } = { ...defaultStopFileDeps(), ...deps };
+    if (!pathExists(paths.stop))
+        return { present: false };
+    try {
+        const mtimeMs = statMtimeMs(paths.stop);
+        return { present: true, ageMs: Math.max(0, now() - mtimeMs), writtenAt: new Date(mtimeMs).toISOString() };
+    }
+    catch {
+        return { present: true, ageMs: 0, writtenAt: 'unknown' };
+    }
+}
+/** Human-readable age like "3h 12m", "45s", or "820ms". */
+export function formatStopFileAge(ms) {
+    if (ms < 1000)
+        return `${Math.max(0, Math.round(ms))}ms`;
+    const s = Math.floor(ms / 1000);
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m ${s % 60}s`;
+    const h = Math.floor(m / 60);
+    return `${h}h ${m % 60}m`;
+}
+/** Message logged/printed by `factory run` when it skips a pass because STOP is present. */
+export function stopSentinelRunSkipMessage(status) {
+    if (!status.present)
+        return '';
+    return (`.factory/STOP present (age ${formatStopFileAge(status.ageMs)}, written ${status.writtenAt}) — ` +
+        `factory run is skipping this pass and claiming no new work. ` +
+        `Remove .factory/STOP (or run \`factory resume\`) to continue.`);
+}
+export function stopSentinelCheck(status) {
+    if (!status.present) {
+        return {
+            name: 'STOP sentinel',
+            ok: true,
+            detail: '.factory/STOP not present — factory run will claim work normally',
+        };
+    }
+    return {
+        name: 'STOP sentinel',
+        ok: false,
+        optional: true,
+        detail: `.factory/STOP present (age ${formatStopFileAge(status.ageMs)}, written ${status.writtenAt}) — repo is intentionally paused`,
+        fix: 'rm .factory/STOP, or run `factory resume`, to let factory run claim work again',
+    };
+}
+//# sourceMappingURL=stop-sentinel.js.map

package/dist/cli/stop-sentinel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-sentinel.js","sourceRoot":"","sources":["../../src/cli/stop-sentinel.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,4EAA4E;AAC5E,0EAA0E;AAE1E,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAS/C,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAChC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO;QACvC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;AACJ,CAAC;AAID,MAAM,UAAU,kBAAkB,CAAC,KAAuB,EAAE,IAAI,GAA0B,EAAE;IAC1F,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,mBAAmB,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC;IAC/E,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACvD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;IAC5G,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC;IACzD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC;IAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC;AAC5B,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,0BAA0B,CAAC,MAA0B;IACnE,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAC/B,OAAO,CACL,8BAA8B,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,MAAM,CAAC,SAAS,MAAM;QAChG,8DAA8D;QAC9D,+DAA+D,CAChE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAA0B;IAC1D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,IAAI,EAAE,eAAe;YACrB,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,kEAAkE;SAC3E,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,EAAE,EAAE,KAAK;QACT,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,8BAA8B,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,MAAM,CAAC,SAAS,kCAAkC;QACpI,GAAG,EAAE,gFAAgF;KACtF,CAAC;AACJ,CAAC"}

package/dist/cli/sweep-heartbeat.d.ts

@@ -0,0 +1,33 @@
+import type { DoctorCheck } from './doctor.js';
+export interface SweepHeartbeatPolicy {
+    heartbeatFile?: string;
+    loopIntervalSeconds: number;
+    staleThresholdMultiplier: number;
+}
+export interface SweepHeartbeatDeps {
+    exists: (p: string) => boolean;
+    mtimeMs: (p: string) => number;
+    now: () => number;
+}
+export declare function defaultSweepHeartbeatDeps(): SweepHeartbeatDeps;
+export declare function resolveSweepHeartbeatFile(policy: SweepHeartbeatPolicy, env: NodeJS.ProcessEnv): string | undefined;
+export type SweepHeartbeatStatus = {
+    status: 'unconfigured';
+} | {
+    status: 'missing';
+    file: string;
+} | {
+    status: 'fresh';
+    file: string;
+    ageSeconds: number;
+    thresholdSeconds: number;
+} | {
+    status: 'stale';
+    file: string;
+    ageSeconds: number;
+    thresholdSeconds: number;
+};
+export declare function checkSweepHeartbeat(policy: SweepHeartbeatPolicy, env: NodeJS.ProcessEnv, deps: SweepHeartbeatDeps): SweepHeartbeatStatus;
+export declare function sweepHeartbeatCheck(status: SweepHeartbeatStatus): DoctorCheck | null;
+export declare function formatSweepHeartbeatStatusLine(status: SweepHeartbeatStatus): string;
+//# sourceMappingURL=sweep-heartbeat.d.ts.map

package/dist/cli/sweep-heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sweep-heartbeat.d.ts","sourceRoot":"","sources":["../../src/cli/sweep-heartbeat.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/B,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/B,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAED,wBAAgB,yBAAyB,IAAI,kBAAkB,CAM9D;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,SAAS,CAElH;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,GAC1B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,GAC/E;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,oBAAoB,EAC5B,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,IAAI,EAAE,kBAAkB,GACvB,oBAAoB,CAWtB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,GAAG,WAAW,GAAG,IAAI,CA0BpF;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAWnF"}

package/dist/cli/sweep-heartbeat.js

@@ -0,0 +1,65 @@
+// packages/cli/src/cli/sweep-heartbeat.ts — detect a dead auto-merge-sweep loop from its
+// heartbeat file's mtime, so `factory doctor`/`status` catch it instead of it rotting silently.
+import { existsSync, statSync } from 'node:fs';
+export function defaultSweepHeartbeatDeps() {
+    return {
+        exists: (p) => existsSync(p),
+        mtimeMs: (p) => statSync(p).mtimeMs,
+        now: () => Date.now(),
+    };
+}
+export function resolveSweepHeartbeatFile(policy, env) {
+    return policy.heartbeatFile || env.HEARTBEAT_FILE || undefined;
+}
+export function checkSweepHeartbeat(policy, env, deps) {
+    const file = resolveSweepHeartbeatFile(policy, env);
+    if (!file)
+        return { status: 'unconfigured' };
+    if (!deps.exists(file))
+        return { status: 'missing', file };
+    const ageSeconds = Math.max(0, Math.round((deps.now() - deps.mtimeMs(file)) / 1000));
+    const thresholdSeconds = Math.round(policy.loopIntervalSeconds * policy.staleThresholdMultiplier);
+    return ageSeconds > thresholdSeconds
+        ? { status: 'stale', file, ageSeconds, thresholdSeconds }
+        : { status: 'fresh', file, ageSeconds, thresholdSeconds };
+}
+export function sweepHeartbeatCheck(status) {
+    const NAME = 'auto-merge sweep heartbeat';
+    switch (status.status) {
+        case 'unconfigured':
+            return null;
+        case 'missing':
+            return {
+                name: NAME,
+                ok: false,
+                detail: `${status.file} not found — the sweep has never written a heartbeat`,
+                fix: 'confirm the sweep loop is running and HEARTBEAT_FILE / sweep.heartbeatFile point at the right path',
+            };
+        case 'stale':
+            return {
+                name: NAME,
+                ok: false,
+                detail: `${status.file} last updated ${status.ageSeconds}s ago (> ${status.thresholdSeconds}s threshold) — the sweep looks dead`,
+                fix: 'check the sweep loop / launchd job (see docs/runbooks/sweep-heartbeat.md) and restart it',
+            };
+        case 'fresh':
+            return {
+                name: NAME,
+                ok: true,
+                detail: `${status.file} updated ${status.ageSeconds}s ago (threshold ${status.thresholdSeconds}s)`,
+            };
+    }
+}
+export function formatSweepHeartbeatStatusLine(status) {
+    switch (status.status) {
+        case 'unconfigured':
+            return 'not configured (sweep.heartbeatFile / HEARTBEAT_FILE unset)';
+        case 'missing':
+            return `MISSING — ${status.file} not found`;
+        case 'stale':
+            return `STALE — ${status.file}, last updated ${status.ageSeconds}s ago (threshold ${status.thresholdSeconds}s)`;
+        case 'fresh':
+            return `OK — ${status.file}, last updated ${status.ageSeconds}s ago (threshold ${status.thresholdSeconds}s)`;
+    }
+}
+//# sourceMappingURL=sweep-heartbeat.js.map

package/dist/cli/sweep-heartbeat.js.map

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

package/dist/cli/unpark.d.ts

@@ -0,0 +1,28 @@
+import type { QueueGitHubClient } from '@on-par/factory-core/internal';
+export type UnparkErrorCode = 'not-parked' | 'lane-required' | 'unpark-failed';
+export declare class UnparkError extends Error {
+    readonly code: UnparkErrorCode;
+    constructor(code: UnparkErrorCode, message: string);
+}
+/** `factory unpark --json` payload (#2277). Additive changes only; bump schemaVersion on a breaking change. */
+export interface UnparkJson {
+    schemaVersion: 1;
+    ok: true;
+    action: 'unpark';
+    issue: number;
+    /** Slug actually routed to (the factory:lane:<slug> suffix). */
+    lane: string;
+    /** The one order position assigned. */
+    order: number;
+    labelsBefore: string[];
+    labelsAfter: string[];
+}
+export interface UnparkInput {
+    client: QueueGitHubClient;
+    owner: string;
+    repo: string;
+    issue: number;
+    lane?: string;
+}
+export declare function runUnpark(input: UnparkInput): Promise<UnparkJson>;
+//# sourceMappingURL=unpark.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unpark.d.ts","sourceRoot":"","sources":["../../src/cli/unpark.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AASvE,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,eAAe,GAAG,eAAe,CAAC;AAE/E,qBAAa,WAAY,SAAQ,KAAK;IAElC,QAAQ,CAAC,IAAI,EAAE,eAAe;IADhC,YACW,IAAI,EAAE,eAAe,EAC9B,OAAO,EAAE,MAAM,EAIhB;CACF;AAED,+GAA+G;AAC/G,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,CAAC,CAAC;IACjB,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,wBAAsB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAwDvE"}

package/dist/cli/unpark.js

@@ -0,0 +1,68 @@
+import { createGithubQueue, LANE_LABEL_PREFIX, laneLabel, PARKED_LABEL, QUEUE_ORDER_LABEL_PREFIX, } from '@on-par/factory-core/internal';
+export class UnparkError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'UnparkError';
+    }
+}
+function message(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+export async function runUnpark(input) {
+    const { client, owner, repo, issue } = input;
+    const ref = { owner, repo, issue_number: issue };
+    try {
+        const labelsBefore = await client.getIssueLabels(ref);
+        if (!labelsBefore.includes(PARKED_LABEL)) {
+            throw new UnparkError('not-parked', `#${issue} is not labelled ${PARKED_LABEL}`);
+        }
+        const existing = labelsBefore
+            .filter((l) => l.startsWith(LANE_LABEL_PREFIX))
+            .map((l) => l.slice(LANE_LABEL_PREFIX.length))
+            .filter((s) => s !== '');
+        let lane;
+        if (input.lane !== undefined && input.lane.trim() !== '') {
+            lane = laneLabel(input.lane.trim()).slice(LANE_LABEL_PREFIX.length);
+        }
+        else if (existing.length === 1) {
+            lane = existing[0];
+        }
+        else if (existing.length === 0) {
+            throw new UnparkError('lane-required', `#${issue} has no ${LANE_LABEL_PREFIX}* label; pass --lane <lane>`);
+        }
+        else {
+            throw new UnparkError('lane-required', `#${issue} has several lane labels (${existing.join(', ')}); pass --lane <lane>`);
+        }
+        const keepLane = laneLabel(lane);
+        for (const name of labelsBefore) {
+            if (name.startsWith(QUEUE_ORDER_LABEL_PREFIX) || (name.startsWith(LANE_LABEL_PREFIX) && name !== keepLane)) {
+                await client.removeLabel({ ...ref, name });
+            }
+        }
+        const [r] = await createGithubQueue({ client, owner, repo }).enqueue(lane, [issue]);
+        if (r === undefined || r.outcome !== 'queued' || r.position === undefined) {
+            throw new UnparkError('unpark-failed', r?.detail ?? `enqueue returned ${r?.outcome}`);
+        }
+        // Remove the parked label last so a failed run can simply be repeated.
+        await client.removeLabel({ ...ref, name: PARKED_LABEL });
+        const labelsAfter = await client.getIssueLabels(ref);
+        return {
+            schemaVersion: 1,
+            ok: true,
+            action: 'unpark',
+            issue,
+            lane,
+            order: r.position,
+            labelsBefore: [...labelsBefore],
+            labelsAfter,
+        };
+    }
+    catch (err) {
+        if (err instanceof UnparkError)
+            throw err;
+        throw new UnparkError('unpark-failed', message(err));
+    }
+}
+//# sourceMappingURL=unpark.js.map

package/dist/cli/unpark.js.map

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