@aperant/framework 0.6.4 → 0.6.6

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

@@ -0,0 +1,465 @@
+/**
+ * commands/ci-watch.mjs — Layer 1 cmd for `/apt:watch-ci` (C28).
+ *
+ * Subcommands: start | stop | status | tick
+ *
+ * Layer 1 rule: cmdCiWatch returns `{envelope, exitCode}` and MUST NOT call
+ * output() / process.exit() / fail() directly. The Layer 2 wrapper in
+ * dispatch.mjs is responsible for transport.
+ *
+ * `tick` is single-execution per invocation (D-01). The recurring beat is
+ * delivered externally — by CC's CronCreate, Pi's pi-schedule-prompt, or by
+ * the user re-invoking `--tick` on non-cron hosts. The cmd MUST NOT enter a
+ * polling loop.
+ *
+ * Test seam: when `APT_TEST_GH_STUB` is set to a path on disk, the tick path
+ * reads the gh payload from that file instead of shelling out. The stub
+ * shape is `{ checks: [...], prMetadata: {...} }` — matches the classifier
+ * input contract in stop-matrix.mjs.
+ */
+import { randomBytes } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { acquireLock, releaseLock } from '../ci-watch/lock.mjs';
+import { deleteState, listWatches, readState, writeState } from '../ci-watch/state.mjs';
+import { classify, isFailing } from '../ci-watch/stop-matrix.mjs';
+import { parseFlags } from '../util/args.mjs';
+import { err, exitWith, ok } from '../util/result.mjs';
+const DEFAULT_TICK_INTERVAL_MS = 300_000; // 5 minutes
+const MAX_TICK_INTERVAL_MS = 30 * 60 * 1000; // 30 min
+const WALL_BUDGET_MS = 4 * 60 * 60 * 1000; // 4 hours
+function newSessionId() {
+    return randomBytes(8).toString('hex');
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+/**
+ * Validate `--pr` is a positive-integer string before it gets interpolated
+ * into a filesystem path. Without this guard, a value like `--pr ../escape`
+ * would write the per-PR state/lock file outside `.aperant/ci-watches/`
+ * (path traversal via `join(..., '../escape.json')`). PR numbers on GitHub
+ * are positive integers, so digits-only is the correct shape.
+ *
+ * Returns the validated PR string on success, or an err() CommandResult on
+ * failure — the caller returns it directly.
+ *
+ * @param {string|undefined} pr
+ * @returns {string | import('../util/result.mjs').CommandResult}
+ */
+function validatePr(pr) {
+    if (!pr)
+        return err('Required: --pr <N>');
+    if (!/^[1-9]\d*$/.test(pr)) {
+        return err(`Invalid --pr value: ${JSON.stringify(pr)}. Expected a positive integer.`);
+    }
+    return pr;
+}
+/**
+ * @param {string} subcommand
+ * @param {string} projectDir
+ * @param {string[]} extraArgs
+ */
+export function cmdCiWatch(subcommand, projectDir, extraArgs) {
+    if (!subcommand) {
+        return err('Usage: apt-tools ci-watch <start|stop|status|tick> <project-dir> [flags]');
+    }
+    if (!projectDir) {
+        return err(`Usage: apt-tools ci-watch ${subcommand} <project-dir> [flags]`);
+    }
+    const root = resolve(projectDir);
+    const flags = parseFlags(extraArgs);
+    switch (subcommand) {
+        case 'start':
+            return doStart(root, flags);
+        case 'stop':
+            return doStop(root, flags);
+        case 'status':
+            return doStatus(root, flags);
+        case 'tick':
+            return doTick(root, flags);
+        default:
+            return err(`Unknown ci-watch subcommand: ${subcommand}. Expected: start, stop, status, tick`);
+    }
+}
+// ---------------------------------------------------------------------------
+// start
+// ---------------------------------------------------------------------------
+function doStart(root, flags) {
+    const prCheck = validatePr(flags.get('pr'));
+    if (typeof prCheck !== 'string')
+        return prCheck;
+    const pr = prCheck;
+    const taskId = flags.get('task-id');
+    if (!taskId)
+        return err('Required: --task-id <id>');
+    const host = flags.get('host') || 'unknown';
+    // Refuse to start a second watcher for the same PR — exit 2 with a
+    // busy envelope so the caller knows the PR is already armed. The
+    // orchestrator skill prints the holder's session and exits.
+    const existingState = readState(root, pr);
+    if (existingState && !existingState.error) {
+        return exitWith({
+            status: 'busy',
+            command: 'ci-watch-start',
+            pr: Number(pr),
+            reason: 'already-armed',
+            existing: {
+                task_id: existingState.task_id,
+                host: existingState.host,
+                attempts: existingState.attempts,
+                started_at: existingState.started_at,
+                deadline: existingState.deadline,
+            },
+        }, 2);
+    }
+    const sessionId = newSessionId();
+    const lockResult = acquireLock(root, pr, sessionId);
+    if (lockResult.status !== 'ok') {
+        return exitWith({
+            status: 'busy',
+            command: 'ci-watch-start',
+            pr: Number(pr),
+            reason: 'lock-held',
+            holder: lockResult.holder,
+        }, 2);
+    }
+    try {
+        const existing = readState(root, pr);
+        const existingObj = existing && !existing.error ? existing : {};
+        const startedAt = existingObj.started_at || nowIso();
+        const deadline = existingObj.deadline || new Date(Date.now() + WALL_BUDGET_MS).toISOString();
+        // Snapshot auto_merge from config at start so config changes mid-watch don't
+        // surprise the orchestrator (spec.md §8).
+        const autoMergeFromConfig = readAutoMergeFromConfig(root);
+        const state = {
+            pr: Number(pr),
+            task_id: taskId,
+            host,
+            scheduler_handle: existingObj.scheduler_handle ?? null,
+            attempts: existingObj.attempts || 0,
+            started_at: startedAt,
+            deadline,
+            last_poll: existingObj.last_poll || nowIso(),
+            last_status: existingObj.last_status ?? null,
+            next_tick_interval_ms: existingObj.next_tick_interval_ms || DEFAULT_TICK_INTERVAL_MS,
+            paused: existingObj.paused || false,
+            auto_merge_on_green: autoMergeFromConfig,
+        };
+        writeState(root, pr, state);
+        return ok({
+            status: 'ok',
+            command: 'ci-watch-start',
+            pr: Number(pr),
+            host,
+            scheduler_handle: state.scheduler_handle,
+            deadline: state.deadline,
+        });
+    }
+    finally {
+        releaseLock(root, pr, sessionId);
+    }
+}
+// ---------------------------------------------------------------------------
+// stop
+// ---------------------------------------------------------------------------
+function doStop(root, flags) {
+    const prCheck = validatePr(flags.get('pr'));
+    if (typeof prCheck !== 'string')
+        return prCheck;
+    const pr = prCheck;
+    const reason = flags.get('reason') || 'user-stop';
+    const existing = readState(root, pr);
+    if (!existing || existing.error) {
+        // Idempotent — stopping a non-existent watch is a no-op.
+        return ok({
+            status: 'ok',
+            command: 'ci-watch-stop',
+            pr: Number(pr),
+            scheduler_handle_removed: false,
+            reason,
+        });
+    }
+    const schedulerHandle = existing.scheduler_handle ?? null;
+    deleteState(root, pr);
+    // Also remove any leftover lock file in case the watcher crashed mid-tick.
+    const stopSessionId = newSessionId();
+    const acq = acquireLock(root, pr, stopSessionId);
+    if (acq.status === 'ok') {
+        releaseLock(root, pr, stopSessionId);
+    }
+    return ok({
+        status: 'ok',
+        command: 'ci-watch-stop',
+        pr: Number(pr),
+        scheduler_handle_removed: schedulerHandle !== null,
+        reason,
+    });
+}
+// ---------------------------------------------------------------------------
+// status
+// ---------------------------------------------------------------------------
+function doStatus(root, flags) {
+    if (flags.has('pr')) {
+        const prCheck = validatePr(flags.get('pr'));
+        if (typeof prCheck !== 'string')
+            return prCheck;
+        const pr = prCheck;
+        const s = readState(root, pr);
+        if (!s || s.error) {
+            return ok({ status: 'ok', command: 'ci-watch-status', watches: [] });
+        }
+        return ok({
+            status: 'ok',
+            command: 'ci-watch-status',
+            watches: [summarize(s)],
+        });
+    }
+    const watches = listWatches(root).map(summarize);
+    return ok({ status: 'ok', command: 'ci-watch-status', watches });
+}
+function summarize(s) {
+    return {
+        pr: s.pr,
+        attempts: s.attempts,
+        last_status: s.last_status,
+        deadline: s.deadline,
+        last_poll: s.last_poll,
+        paused: s.paused,
+    };
+}
+// ---------------------------------------------------------------------------
+// tick
+// ---------------------------------------------------------------------------
+function doTick(root, flags) {
+    const prCheck = validatePr(flags.get('pr'));
+    if (typeof prCheck !== 'string')
+        return prCheck;
+    const pr = prCheck;
+    const sessionId = newSessionId();
+    const lockResult = acquireLock(root, pr, sessionId);
+    if (lockResult.status !== 'ok') {
+        return exitWith({
+            status: 'busy',
+            command: 'ci-watch-tick',
+            pr: Number(pr),
+            reason: 'lock-held',
+            holder: lockResult.holder,
+        }, 2);
+    }
+    try {
+        const state = readState(root, pr);
+        if (!state || state.error) {
+            return err(`No active watch for PR ${pr} — run \`ci-watch start\` first`);
+        }
+        if (state.paused) {
+            return ok({
+                status: 'stopped',
+                command: 'ci-watch-tick',
+                pr: Number(pr),
+                action: 'reviewer-pause',
+                attempts_used: state.attempts,
+                reason: 'watch is paused (reviewer-pause); resume with /apt:watch-ci --resume',
+            });
+        }
+        const payload = fetchGhPayload(pr);
+        if (payload.error) {
+            // gh CLI not available / auth failed → infra-backoff. Don't count it,
+            // double the next-tick interval (capped at MAX_TICK_INTERVAL_MS), and reschedule.
+            state.last_poll = nowIso();
+            state.next_tick_interval_ms = Math.min((state.next_tick_interval_ms || DEFAULT_TICK_INTERVAL_MS) * 2, MAX_TICK_INTERVAL_MS);
+            writeState(root, pr, state);
+            return ok({
+                status: 'ok',
+                command: 'ci-watch-tick',
+                pr: Number(pr),
+                action: 'infra-backoff',
+                attempts_used: state.attempts,
+                next_tick_at: nextTickAt(state),
+                reason: `gh payload fetch failed: ${payload.error}`,
+            });
+        }
+        const result = classify({
+            checks: payload.checks,
+            state,
+            prMetadata: payload.prMetadata,
+        });
+        const { action, counts_toward_budget, reason } = result;
+        // Apply action-specific state mutation.
+        if (action === 'green' || action === 'merged' || action === 'closed') {
+            // Terminal — delete state before releasing lock so no concurrent tick
+            // can slip in between the release and the delete.
+            deleteState(root, pr);
+            releaseLock(root, pr, sessionId);
+            return ok({
+                status: 'stopped',
+                command: 'ci-watch-tick',
+                pr: Number(pr),
+                action,
+                attempts_used: state.attempts,
+                reason,
+            });
+        }
+        if (action === 'attempts-cap' || action === 'wall-cap' || action === 'identical-log') {
+            deleteState(root, pr);
+            releaseLock(root, pr, sessionId);
+            return ok({
+                status: 'stopped',
+                command: 'ci-watch-tick',
+                pr: Number(pr),
+                action,
+                attempts_used: state.attempts,
+                reason,
+            });
+        }
+        if (action === 'reviewer-pause') {
+            state.paused = true;
+            state.last_poll = nowIso();
+            writeState(root, pr, state);
+            return ok({
+                status: 'stopped',
+                command: 'ci-watch-tick',
+                pr: Number(pr),
+                action,
+                attempts_used: state.attempts,
+                reason,
+            });
+        }
+        if (action === 'flake-skip') {
+            state.last_poll = nowIso();
+            // Reset interval on a clean (non-infra) tick.
+            state.next_tick_interval_ms = DEFAULT_TICK_INTERVAL_MS;
+            writeState(root, pr, state);
+            return ok({
+                status: 'ok',
+                command: 'ci-watch-tick',
+                pr: Number(pr),
+                action,
+                attempts_used: state.attempts,
+                next_tick_at: nextTickAt(state),
+                reason,
+            });
+        }
+        if (action === 'infra-backoff') {
+            state.last_poll = nowIso();
+            state.next_tick_interval_ms = Math.min((state.next_tick_interval_ms || DEFAULT_TICK_INTERVAL_MS) * 2, MAX_TICK_INTERVAL_MS);
+            writeState(root, pr, state);
+            return ok({
+                status: 'ok',
+                command: 'ci-watch-tick',
+                pr: Number(pr),
+                action,
+                attempts_used: state.attempts,
+                next_tick_at: nextTickAt(state),
+                reason,
+            });
+        }
+        if (action === 'wait') {
+            state.last_poll = nowIso();
+            state.next_tick_interval_ms = DEFAULT_TICK_INTERVAL_MS;
+            writeState(root, pr, state);
+            return ok({
+                status: 'ok',
+                command: 'ci-watch-tick',
+                pr: Number(pr),
+                action,
+                attempts_used: state.attempts,
+                next_tick_at: nextTickAt(state),
+                reason,
+            });
+        }
+        // fix / diverged-rebased / diverged-bailed — all count toward budget.
+        if (counts_toward_budget) {
+            state.attempts = (state.attempts || 0) + 1;
+        }
+        state.last_poll = nowIso();
+        state.next_tick_interval_ms = DEFAULT_TICK_INTERVAL_MS;
+        // Track the failed-check fingerprint aggregate for next-tick identical-log detection.
+        const failed = (payload.checks || []).filter(isFailing);
+        state.last_status =
+            failed.length === 0
+                ? null
+                : failed
+                    .map((f) => `${f.name}:${f.log_fingerprint ?? ''}`)
+                    .sort()
+                    .join('|');
+        writeState(root, pr, state);
+        return ok({
+            status: 'ok',
+            command: 'ci-watch-tick',
+            pr: Number(pr),
+            action,
+            attempts_used: state.attempts,
+            next_tick_at: nextTickAt(state),
+            reason,
+        });
+    }
+    finally {
+        // `try/finally` so every branch releases the lock — even thrown errors.
+        // The terminal branches above release explicitly before deleting state
+        // (releaseLock no-ops on a missing file, so calling it twice is safe).
+        releaseLock(root, pr, sessionId);
+    }
+}
+// ---------------------------------------------------------------------------
+// helpers
+// ---------------------------------------------------------------------------
+function nextTickAt(state) {
+    return new Date(Date.now() + (state.next_tick_interval_ms || DEFAULT_TICK_INTERVAL_MS)).toISOString();
+}
+/**
+ * Fetch the gh CLI payload OR read the test-stub JSON. Returns
+ *   { checks, prMetadata } on success
+ *   { error: '<message>' } when gh / stub failed.
+ *
+ * Note: this is a thin wrapper — the orchestrator skill is responsible for
+ * the actual `gh run view --log` + fix-CLI shell-out (spec.md §5.5). The
+ * cmd's tick only reads checks + classifies + updates state; the heavy
+ * fix-loop work happens in the skill body.
+ */
+function fetchGhPayload(_pr) {
+    const isTestRuntime = process.env.NODE_ENV === 'test' ||
+        process.env.VITEST != null ||
+        process.env.APT_INTERNAL_TEST != null;
+    const stub = isTestRuntime ? process.env.APT_TEST_GH_STUB : undefined;
+    if (stub) {
+        try {
+            if (!existsSync(stub)) {
+                return { error: 'APT_TEST_GH_STUB path not found' };
+            }
+            const data = JSON.parse(readFileSync(stub, 'utf-8'));
+            return {
+                checks: data.checks || [],
+                prMetadata: data.prMetadata || { state: 'OPEN' },
+            };
+        }
+        catch (_e) {
+            return { error: 'stub parse error' };
+        }
+    }
+    // Real gh shell-out lives in the skill body. The cmd's tick treats
+    // "no stub + no payload" as infra-backoff so unit tests can exercise the
+    // path without a live gh binary. The orchestrator skill is responsible
+    // for pre-fetching and re-invoking with APT_TEST_GH_STUB set, OR for
+    // passing real data via a future --payload-file flag (out of scope here).
+    return {
+        error: 'gh shell-out is the skill orchestrator boundary — set APT_TEST_GH_STUB for unit tests',
+    };
+}
+/**
+ * Read `ci_watch.auto_merge_on_green` from `.aperant/config.json` (default
+ * false). Best-effort — missing file or unparsable JSON returns false.
+ */
+function readAutoMergeFromConfig(root) {
+    try {
+        const path = resolve(root, '.aperant', 'config.json');
+        if (!existsSync(path))
+            return false;
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        return parsed?.ci_watch?.auto_merge_on_green === true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=ci-watch.mjs.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"commit.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/commit.mjs"],"names":[],"mappings":"AAUA,iFA4EC"}
+{"version":3,"file":"commit.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/commit.mjs"],"names":[],"mappings":"AAWA,iFA8FC"}

package/dist/cli/commands/commit.mjs

@@ -3,7 +3,8 @@
  *
  * Layer 1 (post-CLI-layering refactor, subtask 14).
  */
-import { execSync } from 'node:child_process';
+import { execFileSync } from 'node:child_process';
+import { maybeAutoEmitPlanReady } from '../coordination/auto-emit-artifact-ready.mjs';
 import { evaluatePostcondition } from '../risk/postcondition.mjs';
 import { err, ok } from '../util/result.mjs';
 export function cmdCommit(args) {
@@ -30,19 +31,35 @@ export function cmdCommit(args) {
     let sha = null;
     try {
         // Stage specified files
-        execSync(`git add ${files.map((f) => `"${f}"`).join(' ')}`, {
-            encoding: 'utf-8',
-            stdio: 'pipe',
-        });
+        execFileSync('git', ['add', '--', ...files], { encoding: 'utf-8', stdio: 'pipe' });
         // Commit with co-author
         const fullMessage = `${message}\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>`;
-        execSync(`git commit -m ${JSON.stringify(fullMessage)}`, { encoding: 'utf-8', stdio: 'pipe' });
+        execFileSync('git', ['commit', '-m', fullMessage], { encoding: 'utf-8', stdio: 'pipe' });
         // Get the commit sha
-        sha = execSync('git rev-parse HEAD', { encoding: 'utf-8' }).trim();
+        sha = execFileSync('git', ['rev-parse', 'HEAD'], { encoding: 'utf-8' }).trim();
     }
     catch (e) {
         return err(`Commit failed: ${e.message}`);
     }
+    // Conductor v2 (post live verification 2026-05-15) — auto-emit
+    // `artifact.ready{kind:'plan'}` when the commit landed a fresh
+    // `implementation_plan.json` under .aperant/tasks/{id}/ AND the
+    // process runs under a Conductor PTY (APERANT_TERMINAL_ID set).
+    // Code-enforced replacement for the markdown-discipline emit step
+    // that QUICK-track tasks correctly skipped per Fast Path Guarantee.
+    // Best-effort: emit failures do NOT roll back the commit.
+    try {
+        const emitResult = maybeAutoEmitPlanReady({ files, projectRoot: process.cwd() });
+        if (emitResult.emitted) {
+            // Surface via stderr so apt-tools' structured JSON stdout stays
+            // machine-parseable for the caller.
+            process.stderr.write(`[apt-tools commit] auto-emitted artifact.ready for task ${emitResult.envelope.task}\n`);
+        }
+    }
+    catch {
+        // Non-fatal — the commit succeeded. The Conductor will fall back
+        // to filesystem polling (slightly higher latency, same outcome).
+    }
     // R3: Postcondition gate — atomic with the commit. If the predicate fails,
     // we roll back the commit (--soft preserves working tree so the executor
     // can fix-and-retry without losing work).
@@ -58,7 +75,7 @@ export function cmdCommit(args) {
         const result = evaluatePostcondition(pc, process.cwd());
         if (!result.ok) {
             try {
-                execSync('git reset --soft HEAD~1', { stdio: 'pipe' });
+                execFileSync('git', ['reset', '--soft', 'HEAD~1'], { stdio: 'pipe' });
             }
             catch {
                 /* rollback best-effort */

package/dist/cli/commands/commit.mjs.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * CLI entry: `apt-tools context <subcommand> <project-dir> [flags]`.
+ *
+ * Only `write` is supported in v1; other subcommands return a usage error.
+ */
+export function cmdContext(subcommand: any, projectDir: any, extraArgs: any): import("../util/result.mjs").CommandResult;
+//# sourceMappingURL=context.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.mts","sourceRoot":"","sources":["../../../src/cli/commands/context.mjs"],"names":[],"mappings":"AAmJA;;;;GAIG;AACH,yHA2FC"}