@aperant/framework 0.6.4 → 0.6.5

package/dist/cli/ci-watch/lock.mjs

@@ -0,0 +1,172 @@
+/**
+ * ci-watch/lock.mjs — per-PR O_EXCL atomic lock (D-05).
+ *
+ * Mirrors Claude Code's `cronTasksLock.ts`: a per-PR `.aperant/ci-watches/{pr}.lock`
+ * file created with `openSync(..., 'wx')` (O_EXCL). Two concurrent callers
+ * cannot both create the file; the loser reads the existing lock and decides
+ * whether to declare BUSY or recover a stale lock.
+ *
+ * Stale-recovery (spec.md §8): a lock is recoverable iff
+ *   (a) holder PID is dead (`!isPidAlive`), AND
+ *   (b) `Date.now() - acquiredAt > ttl_seconds*1000`.
+ * Live PID alone is NEVER recoverable, even past TTL — TTL alone is not
+ * enough. Per D-05: PID-based stale recovery.
+ *
+ * Lock file shape (spec.md §8):
+ *   { sessionId, pid, acquiredAt, ttl_seconds }
+ *
+ * Return shapes:
+ *   acquireLock → { status: 'ok', lock: {...} }
+ *              OR { status: 'busy', holder: {...} }
+ *   releaseLock → boolean (true on release, false if owner mismatch / missing)
+ *   readLock   → lock object or null
+ */
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, unlinkSync, writeSync, } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { isPidAlive } from '../lock/pid.mjs';
+const TTL_SECONDS = 1800; // 30 min — D-05
+function watchesDir(root) {
+    return join(resolve(root), '.aperant', 'ci-watches');
+}
+function lockPath(root, pr) {
+    return join(watchesDir(root), `${pr}.lock`);
+}
+/**
+ * @param {string} root
+ * @param {number|string} pr
+ */
+export function readLock(root, pr) {
+    const path = lockPath(root, pr);
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        // A corrupted lock is treated as no lock — re-acquire will overwrite.
+        return null;
+    }
+}
+function writeLockFile(path, payload) {
+    mkdirSync(resolve(path, '..'), { recursive: true });
+    const fd = openSync(path, 'wx');
+    try {
+        writeSync(fd, `${JSON.stringify(payload, null, 2)}\n`, 0, 'utf-8');
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/**
+ * Try to acquire the per-PR lock. On EEXIST, parse the existing lock — if the
+ * holder PID is dead AND TTL has elapsed, unlink + retry once. Otherwise
+ * return `{status:'busy', holder}`.
+ *
+ * @param {string} root
+ * @param {number|string} pr
+ * @param {string} sessionId
+ * @param {number} [pid=process.pid]
+ */
+export function acquireLock(root, pr, sessionId, pid = process.pid) {
+    const path = lockPath(root, pr);
+    const payload = {
+        sessionId,
+        pid,
+        acquiredAt: new Date().toISOString(),
+        ttl_seconds: TTL_SECONDS,
+    };
+    try {
+        writeLockFile(path, payload);
+        return { status: 'ok', lock: payload };
+    }
+    catch (err) {
+        if (err.code !== 'EEXIST')
+            throw err;
+    }
+    // Lock file exists — inspect.
+    const existing = readLock(root, pr);
+    if (!existing) {
+        // Corrupted lock — treat as recoverable, unlink + retry once.
+        try {
+            unlinkSync(path);
+        }
+        catch {
+            /* race — another caller cleaned up */
+        }
+        try {
+            writeLockFile(path, payload);
+            return { status: 'ok', lock: payload };
+        }
+        catch (err) {
+            if (err.code === 'EEXIST') {
+                return { status: 'busy', holder: readLock(root, pr) };
+            }
+            throw err;
+        }
+    }
+    if (isStale(existing)) {
+        try {
+            unlinkSync(path);
+        }
+        catch {
+            /* race — another caller cleaned up */
+        }
+        try {
+            writeLockFile(path, payload);
+            return { status: 'ok', lock: payload };
+        }
+        catch (err) {
+            if (err.code === 'EEXIST') {
+                return { status: 'busy', holder: readLock(root, pr) };
+            }
+            throw err;
+        }
+    }
+    return { status: 'busy', holder: existing };
+}
+/**
+ * Release the per-PR lock. Owner must match (`sessionId` equality). Returns
+ * `true` if released, `false` if the lock is missing or owned by someone
+ * else.
+ *
+ * @param {string} root
+ * @param {number|string} pr
+ * @param {string} sessionId
+ */
+export function releaseLock(root, pr, sessionId) {
+    const path = lockPath(root, pr);
+    if (!existsSync(path))
+        return false;
+    const existing = readLock(root, pr);
+    if (!existing) {
+        // Corrupted — fail open (let next caller clean up).
+        return false;
+    }
+    if (existing.sessionId !== sessionId)
+        return false;
+    try {
+        unlinkSync(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Is the given lock stale (i.e., recoverable by a new caller)? Per D-05,
+ * BOTH conditions are required: dead PID AND past TTL.
+ *
+ * Exposed for unit tests; the orchestrator does not call this directly.
+ *
+ * @param {{ pid: number, acquiredAt: string, ttl_seconds: number }} lockData
+ */
+export function isStale(lockData) {
+    if (!lockData || typeof lockData !== 'object')
+        return false;
+    const ttlMs = (lockData.ttl_seconds || TTL_SECONDS) * 1000;
+    const age = Date.now() - new Date(lockData.acquiredAt).getTime();
+    if (age <= ttlMs)
+        return false;
+    return !isPidAlive(lockData.pid);
+}
+//# sourceMappingURL=lock.mjs.map

package/dist/cli/ci-watch/lock.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.mjs","sourceRoot":"","sources":["../../../src/cli/ci-watch/lock.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EACN,SAAS,EACT,UAAU,EACV,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,SAAS,GACT,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,MAAM,WAAW,GAAG,IAAI,CAAA,CAAC,gBAAgB;AAEzC,SAAS,UAAU,CAAC,IAAI;IACvB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,CAAA;AACrD,CAAC;AAED,SAAS,QAAQ,CAAC,IAAI,EAAE,EAAE;IACzB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAI,EAAE,EAAE;IAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAClC,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;IAC/C,CAAC;IAAC,MAAM,CAAC;QACR,sEAAsE;QACtE,OAAO,IAAI,CAAA;IACZ,CAAC;AACF,CAAC;AAED,SAAS,aAAa,CAAC,IAAI,EAAE,OAAO;IACnC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACnD,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAC/B,IAAI,CAAC;QACJ,SAAS,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,CAAA;IACnE,CAAC;YAAS,CAAC;QACV,SAAS,CAAC,EAAE,CAAC,CAAA;IACd,CAAC;AACF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG;IACjE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAC/B,MAAM,OAAO,GAAG;QACf,SAAS;QACT,GAAG;QACH,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,WAAW,EAAE,WAAW;KACxB,CAAA;IAED,IAAI,CAAC;QACJ,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAC5B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAA;IACrC,CAAC;IAED,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,8DAA8D;QAC9D,IAAI,CAAC;YACJ,UAAU,CAAC,IAAI,CAAC,CAAA;QACjB,CAAC;QAAC,MAAM,CAAC;YACR,sCAAsC;QACvC,CAAC;QACD,IAAI,CAAC;YACJ,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YAC5B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;QACvC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAA;YACtD,CAAC;YACD,MAAM,GAAG,CAAA;QACV,CAAC;IACF,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvB,IAAI,CAAC;YACJ,UAAU,CAAC,IAAI,CAAC,CAAA;QACjB,CAAC;QAAC,MAAM,CAAC;YACR,sCAAsC;QACvC,CAAC;QACD,IAAI,CAAC;YACJ,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YAC5B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;QACvC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAA;YACtD,CAAC;YACD,MAAM,GAAG,CAAA;QACV,CAAC;IACF,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AAC5C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,IAAI,EAAE,EAAE,EAAE,SAAS;IAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAA;IACnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,oDAAoD;QACpD,OAAO,KAAK,CAAA;IACb,CAAC;IACD,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IAClD,IAAI,CAAC;QACJ,UAAU,CAAC,IAAI,CAAC,CAAA;QAChB,OAAO,IAAI,CAAA;IACZ,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAA;IACb,CAAC;AACF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,QAAQ;IAC/B,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC3D,MAAM,KAAK,GAAG,CAAC,QAAQ,CAAC,WAAW,IAAI,WAAW,CAAC,GAAG,IAAI,CAAA;IAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAA;IAChE,IAAI,GAAG,IAAI,KAAK;QAAE,OAAO,KAAK,CAAA;IAC9B,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;AACjC,CAAC"}

package/dist/cli/ci-watch/state.d.mts

@@ -0,0 +1,36 @@
+/**
+ * Read the per-PR state file. Returns `null` when the file does not exist.
+ * Returns `{ error: 'corrupted', message }` when the file exists but is not
+ * parseable JSON — callers route that to the infra-backoff branch.
+ *
+ * @param {string} root
+ * @param {number|string} pr
+ */
+export function readState(root: string, pr: number | string): any;
+/**
+ * Atomically write the per-PR state file. Caller passes the full state object
+ * — this function does not merge, it overwrites. Use `readState` first if a
+ * merge is needed.
+ *
+ * @param {string} root
+ * @param {number|string} pr
+ * @param {object} state
+ */
+export function writeState(root: string, pr: number | string, state: object): void;
+/**
+ * Delete the per-PR state file. No-op when the file does not exist.
+ *
+ * @param {string} root
+ * @param {number|string} pr
+ */
+export function deleteState(root: string, pr: number | string): void;
+/**
+ * Enumerate every per-PR state file under `.aperant/ci-watches/`. Returns an
+ * array of parsed state objects in lexicographic filename order. Skips files
+ * whose name does not match `<pr>.json` and skips corrupted files (their
+ * presence does not block the rest of the listing).
+ *
+ * @param {string} root
+ */
+export function listWatches(root: string): any[];
+//# sourceMappingURL=state.d.mts.map

package/dist/cli/ci-watch/state.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.mts","sourceRoot":"","sources":["../../../src/cli/ci-watch/state.mjs"],"names":[],"mappings":"AAsCA;;;;;;;GAOG;AACH,gCAHW,MAAM,MACN,MAAM,GAAC,MAAM,OAUvB;AAED;;;;;;;;GAQG;AACH,iCAJW,MAAM,MACN,MAAM,GAAC,MAAM,SACb,MAAM,QAIhB;AAED;;;;;GAKG;AACH,kCAHW,MAAM,MACN,MAAM,GAAC,MAAM,QAKvB;AAED;;;;;;;GAOG;AACH,kCAFW,MAAM,SAgBhB"}

package/dist/cli/ci-watch/state.mjs

@@ -0,0 +1,103 @@
+/**
+ * ci-watch/state.mjs — per-PR state-file primitives for the /apt:watch-ci
+ * post-ship watcher (D-04).
+ *
+ * Storage shape (`.aperant/ci-watches/{pr}.json`), spec.md §8:
+ *
+ *   {
+ *     pr, task_id, host, scheduler_handle | null,
+ *     attempts, started_at, deadline, last_poll,
+ *     last_status | null, next_tick_interval_ms,
+ *     paused, auto_merge_on_green
+ *   }
+ *
+ * This module is pure read/write — classification logic lives in
+ * stop-matrix.mjs, the orchestrator lives in commands/ci-watch.mjs.
+ *
+ * Crash-safety: `writeState` goes through `atomicWriteJson` (tmp + fsync +
+ * rename). `readState` returns `null` for a missing file and never throws on
+ * a missing path — callers can distinguish "no watch yet" from "watch is
+ * corrupted".
+ *
+ * The corrupted-JSON branch returns a recoverable error envelope rather than
+ * throwing so the orchestrator can surface it without crashing the cron
+ * payload mid-tick.
+ */
+import { existsSync, readdirSync, readFileSync, unlinkSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { atomicWriteJson } from '../util/io.mjs';
+function watchesDir(root) {
+    return join(resolve(root), '.aperant', 'ci-watches');
+}
+function stateFile(root, pr) {
+    return join(watchesDir(root), `${pr}.json`);
+}
+/**
+ * Read the per-PR state file. Returns `null` when the file does not exist.
+ * Returns `{ error: 'corrupted', message }` when the file exists but is not
+ * parseable JSON — callers route that to the infra-backoff branch.
+ *
+ * @param {string} root
+ * @param {number|string} pr
+ */
+export function readState(root, pr) {
+    const path = stateFile(root, pr);
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch (err) {
+        return { error: 'corrupted', message: err.message };
+    }
+}
+/**
+ * Atomically write the per-PR state file. Caller passes the full state object
+ * — this function does not merge, it overwrites. Use `readState` first if a
+ * merge is needed.
+ *
+ * @param {string} root
+ * @param {number|string} pr
+ * @param {object} state
+ */
+export function writeState(root, pr, state) {
+    atomicWriteJson(stateFile(root, pr), state);
+}
+/**
+ * Delete the per-PR state file. No-op when the file does not exist.
+ *
+ * @param {string} root
+ * @param {number|string} pr
+ */
+export function deleteState(root, pr) {
+    const path = stateFile(root, pr);
+    if (existsSync(path))
+        unlinkSync(path);
+}
+/**
+ * Enumerate every per-PR state file under `.aperant/ci-watches/`. Returns an
+ * array of parsed state objects in lexicographic filename order. Skips files
+ * whose name does not match `<pr>.json` and skips corrupted files (their
+ * presence does not block the rest of the listing).
+ *
+ * @param {string} root
+ */
+export function listWatches(root) {
+    const dir = watchesDir(root);
+    if (!existsSync(dir))
+        return [];
+    const watches = [];
+    for (const f of readdirSync(dir).sort()) {
+        if (!/^\d+\.json$/.test(f))
+            continue;
+        try {
+            watches.push(JSON.parse(readFileSync(join(dir, f), 'utf-8')));
+        }
+        catch {
+            // Skip corrupted state files — listWatches is a read-only enumerator
+            // and must not throw on partial corruption.
+        }
+    }
+    return watches;
+}
+//# sourceMappingURL=state.mjs.map

package/dist/cli/ci-watch/state.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.mjs","sourceRoot":"","sources":["../../../src/cli/ci-watch/state.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAC3E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD,SAAS,UAAU,CAAC,IAAI;IACvB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,CAAA;AACrD,CAAC;AAED,SAAS,SAAS,CAAC,IAAI,EAAE,EAAE;IAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;AAC5C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,IAAI,EAAE,EAAE;IACjC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAChC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAClC,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAA;IACpD,CAAC;AACF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK;IACzC,eAAe,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAI,EAAE,EAAE;IACnC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAChC,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,UAAU,CAAC,IAAI,CAAC,CAAA;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,IAAI;IAC/B,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;IAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IAC/B,MAAM,OAAO,GAAG,EAAE,CAAA;IAClB,KAAK,MAAM,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACzC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,SAAQ;QACpC,IAAI,CAAC;YACJ,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;QAC9D,CAAC;QAAC,MAAM,CAAC;YACR,qEAAqE;YACrE,4CAA4C;QAC7C,CAAC;IACF,CAAC;IACD,OAAO,OAAO,CAAA;AACf,CAAC"}

package/dist/cli/ci-watch/stop-matrix.d.mts

@@ -0,0 +1,58 @@
+/**
+ * @typedef {Object} CheckRow
+ * @property {string} [name]
+ * @property {string} [conclusion] e.g. 'success' | 'failure' | 'cancelled' | 'timed_out' | 'neutral'
+ * @property {string} [state]
+ * @property {string} [bucket]
+ * @property {string} [failure_class] — optional pre-classified hint (test-only seam)
+ * @property {string} [log_fingerprint] — optional digest for identical-log detection
+ *
+ * @typedef {Object} ClassifyInput
+ * @property {CheckRow[]} checks
+ * @property {Object} state — per-PR state (see state.mjs §8)
+ * @property {Object} prMetadata — { state: 'OPEN'|'CLOSED'|'MERGED', reviewDecision?: string }
+ *
+ * @typedef {Object} ClassifyOutput
+ * @property {string} action
+ * @property {boolean} counts_toward_budget
+ * @property {string} reason
+ *
+ * @param {ClassifyInput} input
+ * @returns {ClassifyOutput}
+ */
+export function classify({ checks, state, prMetadata }: ClassifyInput): ClassifyOutput;
+export function isFailing(check: any): boolean;
+export type CheckRow = {
+    name?: string | undefined;
+    /**
+     * e.g. 'success' | 'failure' | 'cancelled' | 'timed_out' | 'neutral'
+     */
+    conclusion?: string | undefined;
+    state?: string | undefined;
+    bucket?: string | undefined;
+    /**
+     * — optional pre-classified hint (test-only seam)
+     */
+    failure_class?: string | undefined;
+    /**
+     * — optional digest for identical-log detection
+     */
+    log_fingerprint?: string | undefined;
+};
+export type ClassifyInput = {
+    checks: CheckRow[];
+    /**
+     * — per-PR state (see state.mjs §8)
+     */
+    state: Object;
+    /**
+     * — { state: 'OPEN'|'CLOSED'|'MERGED', reviewDecision?: string }
+     */
+    prMetadata: Object;
+};
+export type ClassifyOutput = {
+    action: string;
+    counts_toward_budget: boolean;
+    reason: string;
+};
+//# sourceMappingURL=stop-matrix.d.mts.map

package/dist/cli/ci-watch/stop-matrix.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-matrix.d.mts","sourceRoot":"","sources":["../../../src/cli/ci-watch/stop-matrix.mjs"],"names":[],"mappings":"AA8BA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wDAHW,aAAa,GACX,cAAc,CA6H1B;AAED,+CAGC;;;;;;;;;;;;;;;;;;;YA5Ia,QAAQ,EAAE;;;;WACV,MAAM;;;;gBACN,MAAM;;;YAGN,MAAM;0BACN,OAAO;YACP,MAAM"}

package/dist/cli/ci-watch/stop-matrix.mjs

@@ -0,0 +1,164 @@
+/**
+ * ci-watch/stop-matrix.mjs — pure stop-matrix classifier (D-06).
+ *
+ * `classify({checks, state, prMetadata})` returns
+ *   { action, counts_toward_budget, reason }
+ *
+ * No I/O, no fs, no gh CLI shell-outs — caller pre-fetches `checks` (the
+ * payload from `gh pr checks --json name,bucket,state,conclusion,detailsUrl`)
+ * and `prMetadata` (`gh pr view --json state,reviewDecision`) and passes them
+ * in. The orchestrator in commands/ci-watch.mjs handles the side effects
+ * implied by the action.
+ *
+ * Predicate order matters — short-circuits go first (merged/closed/green/cap
+ * fire before any per-check inspection). See spec.md §9 table for the full
+ * ordering.
+ *
+ * The 11 actions:
+ *   merged, closed, green, attempts-cap, wall-cap, reviewer-pause,
+ *   identical-log, flake-skip, infra-backoff, diverged-rebased,
+ *   diverged-bailed, fix
+ *
+ * `counts_toward_budget` is `true` for fix attempts (including rebase
+ * attempts and rebase-bail); `false` for flake-skip / infra-backoff; `false`
+ * (with a sentinel meaning "n/a") for terminal actions.
+ */
+const ATTEMPTS_CAP = 5;
+const INFRA_FAILURE_CLASSES = new Set(['runner-oom', 'runner-cancelled', 'gh-5xx', 'timeout']);
+/**
+ * @typedef {Object} CheckRow
+ * @property {string} [name]
+ * @property {string} [conclusion] e.g. 'success' | 'failure' | 'cancelled' | 'timed_out' | 'neutral'
+ * @property {string} [state]
+ * @property {string} [bucket]
+ * @property {string} [failure_class] — optional pre-classified hint (test-only seam)
+ * @property {string} [log_fingerprint] — optional digest for identical-log detection
+ *
+ * @typedef {Object} ClassifyInput
+ * @property {CheckRow[]} checks
+ * @property {Object} state — per-PR state (see state.mjs §8)
+ * @property {Object} prMetadata — { state: 'OPEN'|'CLOSED'|'MERGED', reviewDecision?: string }
+ *
+ * @typedef {Object} ClassifyOutput
+ * @property {string} action
+ * @property {boolean} counts_toward_budget
+ * @property {string} reason
+ *
+ * @param {ClassifyInput} input
+ * @returns {ClassifyOutput}
+ */
+export function classify({ checks, state, prMetadata }) {
+    const pr = prMetadata || {};
+    const st = state || {};
+    const rows = Array.isArray(checks) ? checks : [];
+    // 1. MERGED.
+    if (pr.state === 'MERGED') {
+        return { action: 'merged', counts_toward_budget: false, reason: 'pr is merged' };
+    }
+    // 2. CLOSED (not merged).
+    if (pr.state === 'CLOSED') {
+        return { action: 'closed', counts_toward_budget: false, reason: 'pr is closed unmerged' };
+    }
+    const failed = rows.filter((c) => isFailing(c));
+    const allGreen = rows.length > 0 && rows.every((c) => c.conclusion === 'success');
+    // 3. All checks green.
+    if (allGreen) {
+        return { action: 'green', counts_toward_budget: false, reason: 'all checks succeeded' };
+    }
+    // 3b. No checks registered yet — CI hasn't enqueued jobs. Wait without
+    // burning a fix attempt.
+    if (rows.length === 0) {
+        return { action: 'wait', counts_toward_budget: false, reason: 'no checks registered yet' };
+    }
+    // 4. Attempts cap (only when red present — otherwise green/merged/closed would have fired).
+    const attempts = st.attempts || 0;
+    if (attempts >= ATTEMPTS_CAP && failed.length > 0) {
+        return {
+            action: 'attempts-cap',
+            counts_toward_budget: false,
+            reason: `${attempts} fix attempts used; cap is ${ATTEMPTS_CAP}`,
+        };
+    }
+    // 5. Wall-clock cap.
+    if (st.deadline && Date.now() > new Date(st.deadline).getTime() && failed.length > 0) {
+        return {
+            action: 'wall-cap',
+            counts_toward_budget: false,
+            reason: 'past 4h deadline',
+        };
+    }
+    // 6. Reviewer asked for changes.
+    if (pr.reviewDecision === 'CHANGES_REQUESTED') {
+        return {
+            action: 'reviewer-pause',
+            counts_toward_budget: false,
+            reason: 'reviewer requested changes — pausing',
+        };
+    }
+    // 7. Identical-log → non-converging fixer.
+    // Compare aggregate fingerprints (same format as the write side in ci-watch.mjs).
+    if (attempts > 0 && st.last_status && failed.length > 0) {
+        const currentFingerprint = failed
+            .map((f) => `${f.name}:${f.log_fingerprint ?? ''}`)
+            .sort()
+            .join('|');
+        if (currentFingerprint === st.last_status) {
+            return {
+                action: 'identical-log',
+                counts_toward_budget: false,
+                reason: 'failed-check fingerprint identical to last attempt',
+            };
+        }
+    }
+    // 8. Flake-skip — same check failed then passed on rerun, no commit between.
+    // The classifier sees this as an explicit hint from the caller: failed rows
+    // classified as `bucket === 'flake'` or `failure_class === 'flake'` are the
+    // flaky-test variety and must not burn a fix attempt. Fires when EVERY
+    // remaining failure is a flake — if any non-flake failure is present, we
+    // fall through and the real failure governs.
+    if (failed.length > 0 &&
+        failed.every((c) => c.bucket === 'flake' || c.failure_class === 'flake')) {
+        return {
+            action: 'flake-skip',
+            counts_toward_budget: false,
+            reason: 'check transient — passed on rerun',
+        };
+    }
+    // 9. Infra failure class.
+    if (failed.some((c) => INFRA_FAILURE_CLASSES.has(c.failure_class))) {
+        return {
+            action: 'infra-backoff',
+            counts_toward_budget: false,
+            reason: 'infra-class failure — backoff and retry',
+        };
+    }
+    // 10. Diverged branch — caller has already done the fetch + dry-rebase and
+    // passes the outcome in `prMetadata.diverged`:
+    //   { rebased: true }   → action 'diverged-rebased' (counts)
+    //   { rebased: false }  → action 'diverged-bailed'  (counts)
+    if (pr.diverged && typeof pr.diverged === 'object') {
+        if (pr.diverged.rebased === true) {
+            return {
+                action: 'diverged-rebased',
+                counts_toward_budget: true,
+                reason: 'origin ahead; rebased successfully',
+            };
+        }
+        return {
+            action: 'diverged-bailed',
+            counts_toward_budget: true,
+            reason: 'origin ahead; rebase conflict',
+        };
+    }
+    // 11. Default red — go fix.
+    return {
+        action: 'fix',
+        counts_toward_budget: true,
+        reason: 'red checks present — attempting fix',
+    };
+}
+export function isFailing(check) {
+    const c = check.conclusion;
+    return c === 'failure' || c === 'cancelled' || c === 'timed_out' || c === 'action_required';
+}
+//# sourceMappingURL=stop-matrix.mjs.map

package/dist/cli/ci-watch/stop-matrix.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-matrix.mjs","sourceRoot":"","sources":["../../../src/cli/ci-watch/stop-matrix.mjs"],"names":[],"mappings":"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"}

package/dist/cli/cli-wrappers/ci-watch.d.mts

@@ -0,0 +1,2 @@
+export { cmdCiWatch as cliCiWatch } from "../commands/ci-watch.mjs";
+//# sourceMappingURL=ci-watch.d.mts.map

package/dist/cli/cli-wrappers/ci-watch.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-watch.d.mts","sourceRoot":"","sources":["../../../src/cli/cli-wrappers/ci-watch.mjs"],"names":[],"mappings":""}

package/dist/cli/cli-wrappers/ci-watch.mjs

@@ -0,0 +1,9 @@
+/**
+ * cli-wrappers/ci-watch.mjs — Layer 2 wrapper for the ci-watch cmd.
+ *
+ * Today this is a passthrough — DISPATCH calls wrap(cmdCiWatch) directly.
+ * Re-exporting under cliCiWatch keeps the file-per-cmd structural seam
+ * (mirrors task.mjs / pr-review.mjs).
+ */
+export { cmdCiWatch as cliCiWatch } from '../commands/ci-watch.mjs';
+//# sourceMappingURL=ci-watch.mjs.map

package/dist/cli/cli-wrappers/ci-watch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-watch.mjs","sourceRoot":"","sources":["../../../src/cli/cli-wrappers/ci-watch.mjs"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,IAAI,UAAU,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/cli/commands/adr.d.mts

@@ -0,0 +1,5 @@
+/**
+ * CLI entry: `apt-tools adr <subcommand> <project-dir> [flags]`.
+ */
+export function cmdAdr(subcommand: any, projectDir: any, extraArgs: any): import("../util/result.mjs").CommandResult;
+//# sourceMappingURL=adr.d.mts.map

package/dist/cli/commands/adr.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/adr.mjs"],"names":[],"mappings":"AAmIA;;GAEG;AACH,qHA4GC"}