@blockspool/cli 0.4.0 → 0.4.1

package/dist/lib/exec.js

@@ -1,295 +0,0 @@
-/**
- * Node.js ExecRunner implementation
- *
- * Spawns commands, captures output to artifact files,
- * handles timeout/cancellation, and returns structured results.
- */
-import { spawn } from 'node:child_process';
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-/**
- * Configuration constants for ExecRunner
- */
-/** Maximum bytes to write per output stream (stdout/stderr). Prevents runaway disk usage. */
-const DEFAULT_MAX_LOG_BYTES = 200_000; // 200KB per stream
-/** Bytes to retain in memory for the tail buffer, used for fast UI display. */
-const DEFAULT_TAIL_BYTES = 16_384; // 16KB tail for fast UI
-/** Grace period in ms between SIGTERM and SIGKILL when killing a child process. */
-const DEFAULT_KILL_GRACE_MS = 1_500;
-/** Maximum length for sanitized file name segments. Prevents overly long artifact paths. */
-const MAX_FILE_SEGMENT_LENGTH = 64;
-function isProbablyAbsolute(p) {
-    return path.isAbsolute(p);
-}
-function sanitizeFileSegment(s) {
-    return s
-        .trim()
-        .toLowerCase()
-        .replace(/[^a-z0-9._-]+/g, '-')
-        .replace(/-+/g, '-')
-        .replace(/^-+|-+$/g, '')
-        .slice(0, MAX_FILE_SEGMENT_LENGTH) || 'step';
-}
-function pad2(n) {
-    return n < 10 ? `0${n}` : `${n}`;
-}
-function appendTail(current, chunk, tailBytes) {
-    if (tailBytes <= 0)
-        return Buffer.alloc(0);
-    if (chunk.length >= tailBytes) {
-        return Buffer.from(chunk.subarray(chunk.length - tailBytes));
-    }
-    if (current.length === 0)
-        return Buffer.from(chunk);
-    const combined = Buffer.concat([current, chunk]);
-    if (combined.length <= tailBytes)
-        return combined;
-    return Buffer.from(combined.subarray(combined.length - tailBytes));
-}
-async function ensureDir(absDir) {
-    await fs.promises.mkdir(absDir, { recursive: true });
-}
-function writeCapped(stream, chunk, state, maxBytes) {
-    if (maxBytes <= 0) {
-        state.truncated = true;
-        return;
-    }
-    if (state.truncated)
-        return;
-    const remaining = maxBytes - state.bytesWritten;
-    if (remaining <= 0) {
-        state.truncated = true;
-        return;
-    }
-    if (chunk.length <= remaining) {
-        stream.write(chunk);
-        state.bytesWritten += chunk.length;
-        return;
-    }
-    // partial write, then truncate
-    stream.write(chunk.subarray(0, remaining));
-    state.bytesWritten += remaining;
-    state.truncated = true;
-}
-function waitForStreamClose(stream) {
-    return new Promise((resolve, reject) => {
-        stream.once('close', () => resolve());
-        stream.once('error', (err) => reject(err));
-    });
-}
-export class NodeExecRunner {
-    defaultMaxLogBytes;
-    defaultTailBytes;
-    killGraceMs;
-    constructor(opts = {}) {
-        this.defaultMaxLogBytes = opts.defaultMaxLogBytes ?? DEFAULT_MAX_LOG_BYTES;
-        this.defaultTailBytes = opts.defaultTailBytes ?? DEFAULT_TAIL_BYTES;
-        this.killGraceMs = opts.killGraceMs ?? DEFAULT_KILL_GRACE_MS;
-    }
-    async run(spec) {
-        const startedAtMs = Date.now();
-        const maxLogBytes = spec.maxLogBytes ?? this.defaultMaxLogBytes;
-        const tailBytes = spec.tailBytes ?? this.defaultTailBytes;
-        const repoRoot = spec.repoRoot;
-        const artifactsDirAbs = isProbablyAbsolute(spec.artifactsDir)
-            ? spec.artifactsDir
-            : path.join(repoRoot, spec.artifactsDir);
-        // Layout: .blockspool/artifacts/<runId>/attempt-<n>/
-        const attemptDirAbs = path.join(artifactsDirAbs, spec.runId, `attempt-${spec.attempt}`);
-        await ensureDir(attemptDirAbs);
-        const safeName = sanitizeFileSegment(spec.stepName);
-        const base = `${pad2(spec.ordinal)}-${safeName}`;
-        const stdoutAbs = path.join(attemptDirAbs, `${base}.stdout.log`);
-        const stderrAbs = path.join(attemptDirAbs, `${base}.stderr.log`);
-        const stdoutPathDb = isProbablyAbsolute(spec.artifactsDir)
-            ? stdoutAbs
-            : path.join(spec.artifactsDir, spec.runId, `attempt-${spec.attempt}`, `${base}.stdout.log`);
-        const stderrPathDb = isProbablyAbsolute(spec.artifactsDir)
-            ? stderrAbs
-            : path.join(spec.artifactsDir, spec.runId, `attempt-${spec.attempt}`, `${base}.stderr.log`);
-        const stdoutStream = fs.createWriteStream(stdoutAbs, { flags: 'w' });
-        const stderrStream = fs.createWriteStream(stderrAbs, { flags: 'w' });
-        let stdoutTail = Buffer.alloc(0);
-        let stderrTail = Buffer.alloc(0);
-        const stdoutState = { bytesWritten: 0, truncated: false };
-        const stderrState = { bytesWritten: 0, truncated: false };
-        let timedOut = false;
-        let canceled = false;
-        let errorMessage;
-        let exitCode = null;
-        let signal = null;
-        let pid = null;
-        let timeoutHandle;
-        const endAndWaitStreams = async () => {
-            try {
-                stdoutStream.end();
-            }
-            catch { /* ignore */ }
-            try {
-                stderrStream.end();
-            }
-            catch { /* ignore */ }
-            await Promise.allSettled([
-                waitForStreamClose(stdoutStream),
-                waitForStreamClose(stderrStream),
-            ]);
-        };
-        const makeOutput = (stream) => {
-            const isStdout = stream === 'stdout';
-            const absPath = isStdout ? stdoutAbs : stderrAbs;
-            const pathDb = isStdout ? stdoutPathDb : stderrPathDb;
-            const bytes = isStdout ? stdoutState.bytesWritten : stderrState.bytesWritten;
-            const truncated = isStdout ? stdoutState.truncated : stderrState.truncated;
-            const tailBuf = isStdout ? stdoutTail : stderrTail;
-            return {
-                absPath,
-                path: pathDb,
-                bytes,
-                truncated,
-                tail: tailBuf.toString('utf8'),
-            };
-        };
-        const finalize = async (status) => {
-            const endedAtMs = Date.now();
-            await endAndWaitStreams();
-            return {
-                status,
-                exitCode,
-                signal,
-                errorMessage,
-                pid,
-                startedAtMs,
-                endedAtMs,
-                durationMs: Math.max(0, endedAtMs - startedAtMs),
-                stdout: makeOutput('stdout'),
-                stderr: makeOutput('stderr'),
-            };
-        };
-        let child;
-        const killChild = (_why) => {
-            if (!child || child.killed)
-                return;
-            try {
-                child.kill('SIGTERM');
-            }
-            catch { /* ignore */ }
-            // Escalate after grace period
-            setTimeout(() => {
-                if (!child || child.killed)
-                    return;
-                try {
-                    child.kill('SIGKILL');
-                }
-                catch { /* ignore */ }
-            }, this.killGraceMs);
-        };
-        const onAbort = () => {
-            canceled = true;
-            errorMessage = errorMessage ?? 'Canceled';
-            killChild('canceled');
-        };
-        // Shared cleanup: clears timeout, removes abort listener, then finalizes
-        const cleanupAndFinalize = async (status) => {
-            if (timeoutHandle)
-                clearTimeout(timeoutHandle);
-            if (spec.signal)
-                spec.signal.removeEventListener('abort', onAbort);
-            return await finalize(status);
-        };
-        try {
-            const env = { ...process.env, ...(spec.env ?? {}) };
-            const cwd = spec.cwd ?? repoRoot;
-            // If already aborted, short-circuit
-            if (spec.signal?.aborted) {
-                canceled = true;
-                errorMessage = 'Canceled (signal already aborted)';
-                return await finalize('canceled');
-            }
-            if (spec.signal) {
-                spec.signal.addEventListener('abort', onAbort, { once: true });
-            }
-            child = spawn(spec.cmd, {
-                cwd,
-                env,
-                shell: spec.shell ?? true,
-                stdio: ['ignore', 'pipe', 'pipe'],
-            });
-            pid = child.pid ?? null;
-            // Timeout handling
-            if (spec.timeoutMs && spec.timeoutMs > 0) {
-                timeoutHandle = setTimeout(() => {
-                    timedOut = true;
-                    errorMessage = errorMessage ?? `Timed out after ${spec.timeoutMs}ms`;
-                    killChild('timeout');
-                }, spec.timeoutMs);
-            }
-            // Stream piping + tail capture
-            if (child.stdout) {
-                child.stdout.on('data', (chunk) => {
-                    const buf = Buffer.from(chunk);
-                    spec.onStdoutChunk?.(buf);
-                    stdoutTail = appendTail(stdoutTail, buf, tailBytes);
-                    writeCapped(stdoutStream, buf, stdoutState, maxLogBytes);
-                });
-            }
-            if (child.stderr) {
-                child.stderr.on('data', (chunk) => {
-                    const buf = Buffer.from(chunk);
-                    spec.onStderrChunk?.(buf);
-                    stderrTail = appendTail(stderrTail, buf, tailBytes);
-                    writeCapped(stderrStream, buf, stderrState, maxLogBytes);
-                });
-            }
-            // Spawn error (ENOENT, permissions, etc.)
-            const spawnErrorPromise = new Promise((resolve) => {
-                child.once('error', async (err) => {
-                    errorMessage = errorMessage ?? err.message;
-                    exitCode = null;
-                    signal = null;
-                    killChild('error');
-                    resolve(await cleanupAndFinalize('failed'));
-                });
-            });
-            // Normal close path
-            const closePromise = new Promise((resolve) => {
-                child.once('close', async (code, sig) => {
-                    exitCode = code;
-                    signal = sig ?? null;
-                    let status;
-                    if (canceled)
-                        status = 'canceled';
-                    else if (timedOut)
-                        status = 'timeout';
-                    else if (code === 0)
-                        status = 'success';
-                    else
-                        status = 'failed';
-                    resolve(await cleanupAndFinalize(status));
-                });
-            });
-            // Write stream error (disk issue)
-            const writeErrorPromise = new Promise((resolve) => {
-                const onWriteError = async (err) => {
-                    errorMessage = errorMessage ?? `Artifact write error: ${err.message}`;
-                    killChild('error');
-                    resolve(await cleanupAndFinalize('failed'));
-                };
-                stdoutStream.once('error', onWriteError);
-                stderrStream.once('error', onWriteError);
-            });
-            // First one wins
-            return await Promise.race([spawnErrorPromise, closePromise, writeErrorPromise]);
-        }
-        catch (err) {
-            errorMessage = errorMessage ?? (err instanceof Error ? err.message : String(err));
-            return await cleanupAndFinalize('failed');
-        }
-    }
-}
-/**
- * Create a Node exec runner with default options
- */
-export function createExecRunner(opts) {
-    return new NodeExecRunner(opts);
-}
-//# sourceMappingURL=exec.js.map

package/dist/lib/exec.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/lib/exec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAgBlC;;GAEG;AAEH,6FAA6F;AAC7F,MAAM,qBAAqB,GAAG,OAAO,CAAC,CAAC,mBAAmB;AAE1D,+EAA+E;AAC/E,MAAM,kBAAkB,GAAG,MAAM,CAAC,CAAC,wBAAwB;AAE3D,mFAAmF;AACnF,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAEpC,4FAA4F;AAC5F,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAEnC,SAAS,kBAAkB,CAAC,CAAS;IACnC,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,mBAAmB,CAAC,CAAS;IACpC,OAAO,CAAC;SACL,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,IAAI,MAAM,CAAC;AACjD,CAAC;AAED,SAAS,IAAI,CAAC,CAAS;IACrB,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,UAAU,CAAC,OAAe,EAAE,KAAa,EAAE,SAAiB;IACnE,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3C,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEpD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IACjD,IAAI,QAAQ,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,QAAQ,CAAC;IAClD,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,MAAc;IACrC,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,WAAW,CAClB,MAAsB,EACtB,KAAa,EACb,KAAmD,EACnD,QAAgB;IAEhB,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAClB,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;QACvB,OAAO;IACT,CAAC;IAED,IAAI,KAAK,CAAC,SAAS;QAAE,OAAO;IAE5B,MAAM,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC,YAAY,CAAC;IAChD,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACnB,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;QACvB,OAAO;IACT,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpB,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,MAAM,CAAC;QACnC,OAAO;IACT,CAAC;IAED,+BAA+B;IAC/B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAC3C,KAAK,CAAC,YAAY,IAAI,SAAS,CAAC;IAChC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;AACzB,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAsB;IAChD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,OAAO,cAAc;IACR,kBAAkB,CAAS;IAC3B,gBAAgB,CAAS;IACzB,WAAW,CAAS;IAErC,YAAY,OAA8B,EAAE;QAC1C,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,IAAI,qBAAqB,CAAC;QAC3E,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI,kBAAkB,CAAC;QACpE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,qBAAqB,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAc;QACtB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE/B,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,kBAAkB,CAAC;QAChE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,gBAAgB,CAAC;QAE1D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,MAAM,eAAe,GAAG,kBAAkB,CAAC,IAAI,CAAC,YAAY,CAAC;YAC3D,CAAC,CAAC,IAAI,CAAC,YAAY;YACnB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAE3C,qDAAqD;QACrD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACxF,MAAM,SAAS,CAAC,aAAa,CAAC,CAAC;QAE/B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,QAAQ,EAAE,CAAC;QAEjD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,IAAI,aAAa,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,IAAI,aAAa,CAAC,CAAC;QAEjE,MAAM,YAAY,GAAG,kBAAkB,CAAC,IAAI,CAAC,YAAY,CAAC;YACxD,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,aAAa,CAAC,CAAC;QAE9F,MAAM,YAAY,GAAG,kBAAkB,CAAC,IAAI,CAAC,YAAY,CAAC;YACxD,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,aAAa,CAAC,CAAC;QAE9F,MAAM,YAAY,GAAG,EAAE,CAAC,iBAAiB,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACrE,MAAM,YAAY,GAAG,EAAE,CAAC,iBAAiB,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAErE,IAAI,UAAU,GAAW,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,UAAU,GAAW,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAEzC,MAAM,WAAW,GAAG,EAAE,YAAY,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAC1D,MAAM,WAAW,GAAG,EAAE,YAAY,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAE1D,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,YAAgC,CAAC;QAErC,IAAI,QAAQ,GAAkB,IAAI,CAAC;QACnC,IAAI,MAAM,GAAkB,IAAI,CAAC;QACjC,IAAI,GAAG,GAAkB,IAAI,CAAC;QAE9B,IAAI,aAAyC,CAAC;QAE9C,MAAM,iBAAiB,GAAG,KAAK,IAAmB,EAAE;YAClD,IAAI,CAAC;gBAAC,YAAY,CAAC,GAAG,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YAClD,IAAI,CAAC;gBAAC,YAAY,CAAC,GAAG,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YAElD,MAAM,OAAO,CAAC,UAAU,CAAC;gBACvB,kBAAkB,CAAC,YAAY,CAAC;gBAChC,kBAAkB,CAAC,YAAY,CAAC;aACjC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,UAAU,GAAG,CAAC,MAA2B,EAAc,EAAE;YAC7D,MAAM,QAAQ,GAAG,MAAM,KAAK,QAAQ,CAAC;YACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;YACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;YACtD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC;YAC7E,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC;YAC3E,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;YAEnD,OAAO;gBACL,OAAO;gBACP,IAAI,EAAE,MAAM;gBACZ,KAAK;gBACL,SAAS;gBACT,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;aAC/B,CAAC;QACJ,CAAC,CAAC;QAEF,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAkB,EAAuB,EAAE;YACjE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,iBAAiB,EAAE,CAAC;YAE1B,OAAO;gBACL,MAAM;gBACN,QAAQ;gBACR,MAAM;gBACN,YAAY;gBACZ,GAAG;gBACH,WAAW;gBACX,SAAS;gBACT,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;gBAChD,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC;gBAC5B,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC;aAC7B,CAAC;QACJ,CAAC,CAAC;QAEF,IAAI,KAA2C,CAAC;QAEhD,MAAM,SAAS,GAAG,CAAC,IAAsC,EAAE,EAAE;YAC3D,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO;YAEnC,IAAI,CAAC;gBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YAExB,8BAA8B;YAC9B,UAAU,CAAC,GAAG,EAAE;gBACd,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM;oBAAE,OAAO;gBACnC,IAAI,CAAC;oBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACxB,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YAC1B,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACvB,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,QAAQ,GAAG,IAAI,CAAC;YAChB,YAAY,GAAG,YAAY,IAAI,UAAU,CAAC;YAC1C,SAAS,CAAC,UAAU,CAAC,CAAC;QACxB,CAAC,CAAC;QAEF,yEAAyE;QACzE,MAAM,kBAAkB,GAAG,KAAK,EAAE,MAAkB,EAAuB,EAAE;YAC3E,IAAI,aAAa;gBAAE,YAAY,CAAC,aAAa,CAAC,CAAC;YAC/C,IAAI,IAAI,CAAC,MAAM;gBAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACnE,OAAO,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,EAA4B,CAAC;YAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,QAAQ,CAAC;YAEjC,oCAAoC;YACpC,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBACzB,QAAQ,GAAG,IAAI,CAAC;gBAChB,YAAY,GAAG,mCAAmC,CAAC;gBACnD,OAAO,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAC;YACpC,CAAC;YAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACjE,CAAC;YAED,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;gBACtB,GAAG;gBACH,GAAG;gBACH,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;gBACzB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;aAClC,CAAC,CAAC;YAEH,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;YAExB,mBAAmB;YACnB,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;gBACzC,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC9B,QAAQ,GAAG,IAAI,CAAC;oBAChB,YAAY,GAAG,YAAY,IAAI,mBAAmB,IAAI,CAAC,SAAS,IAAI,CAAC;oBACrE,SAAS,CAAC,SAAS,CAAC,CAAC;gBACvB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACrB,CAAC;YAED,+BAA+B;YAC/B,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;oBAChC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBAC/B,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC;oBAC1B,UAAU,GAAG,UAAU,CAAC,UAAU,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;oBACpD,WAAW,CAAC,YAAY,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;gBAC3D,CAAC,CAAC,CAAC;YACL,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;oBAChC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBAC/B,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC;oBAC1B,UAAU,GAAG,UAAU,CAAC,UAAU,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;oBACpD,WAAW,CAAC,YAAY,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;gBAC3D,CAAC,CAAC,CAAC;YACL,CAAC;YAED,0CAA0C;YAC1C,MAAM,iBAAiB,GAAG,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,EAAE;gBAC5D,KAAM,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,GAAU,EAAE,EAAE;oBACxC,YAAY,GAAG,YAAY,IAAI,GAAG,CAAC,OAAO,CAAC;oBAC3C,QAAQ,GAAG,IAAI,CAAC;oBAChB,MAAM,GAAG,IAAI,CAAC;oBACd,SAAS,CAAC,OAAO,CAAC,CAAC;oBACnB,OAAO,CAAC,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC9C,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,oBAAoB;YACpB,MAAM,YAAY,GAAG,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,EAAE;gBACvD,KAAM,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAmB,EAAE,GAA0B,EAAE,EAAE;oBAC7E,QAAQ,GAAG,IAAI,CAAC;oBAChB,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC;oBAErB,IAAI,MAAkB,CAAC;oBACvB,IAAI,QAAQ;wBAAE,MAAM,GAAG,UAAU,CAAC;yBAC7B,IAAI,QAAQ;wBAAE,MAAM,GAAG,SAAS,CAAC;yBACjC,IAAI,IAAI,KAAK,CAAC;wBAAE,MAAM,GAAG,SAAS,CAAC;;wBACnC,MAAM,GAAG,QAAQ,CAAC;oBAEvB,OAAO,CAAC,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC5C,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,kCAAkC;YAClC,MAAM,iBAAiB,GAAG,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,EAAE;gBAC5D,MAAM,YAAY,GAAG,KAAK,EAAE,GAAU,EAAE,EAAE;oBACxC,YAAY,GAAG,YAAY,IAAI,yBAAyB,GAAG,CAAC,OAAO,EAAE,CAAC;oBACtE,SAAS,CAAC,OAAO,CAAC,CAAC;oBACnB,OAAO,CAAC,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC9C,CAAC,CAAC;gBAEF,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;gBACzC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YAC3C,CAAC,CAAC,CAAC;YAEH,iBAAiB;YACjB,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAClF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,GAAG,YAAY,IAAI,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClF,OAAO,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAA4B;IAC3D,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/dist/lib/formulas.d.ts

@@ -1,78 +0,0 @@
-/**
- * Formulas - User-defined repeatable sweep recipes
- *
- * A formula is a YAML config that defines what an auto run should
- * look for and how to fix it. Formulas live in .blockspool/formulas/
- * and can be invoked with --formula <name>.
- *
- * Example:
- *   blockspool solo auto --formula security-audit
- */
-import type { ProposalCategory } from '@blockspool/core/scout';
-export interface Formula {
-    /** Unique name (derived from filename) */
-    name: string;
-    /** Human-readable description */
-    description: string;
-    /** Scope glob pattern (e.g., "src/") */
-    scope?: string;
-    /** Proposal categories to include */
-    categories?: ProposalCategory[];
-    /** Minimum confidence threshold (0-100) */
-    minConfidence?: number;
-    /** Custom prompt for the scout — tells the AI what to look for */
-    prompt?: string;
-    /** Max PRs to create */
-    maxPrs?: number;
-    /** Max time for the run (e.g., "2h", "30m") */
-    maxTime?: string;
-    /** Focus areas for guided mode */
-    focusAreas?: string[];
-    /** Patterns to exclude */
-    exclude?: string[];
-    /** Whether to use roadmap mode (default: true) */
-    useRoadmap?: boolean;
-    /** Tags for organizing formulas */
-    tags?: string[];
-    /** Model to use for scouting */
-    model?: 'haiku' | 'sonnet' | 'opus';
-}
-export declare const BUILTIN_FORMULAS: Formula[];
-/**
- * Load a formula by name.
- *
- * Search order:
- * 1. .blockspool/formulas/<name>.yaml (or .yml)
- * 2. Built-in formulas
- *
- * @returns The formula, or null if not found
- */
-export declare function loadFormula(name: string, repoPath?: string): Formula | null;
-/**
- * List all available formulas (built-in + user-defined)
- */
-export declare function listFormulas(repoPath?: string): Formula[];
-/**
- * Apply a formula's settings to auto options.
- * Formula values override defaults but CLI flags take precedence.
- */
-export declare function applyFormula(formula: Formula, cliOptions: {
-    scope?: string;
-    types?: ProposalCategory[];
-    minConfidence?: number;
-    maxPrs?: number;
-    maxTime?: string;
-    exclude?: string[];
-    noRoadmap?: boolean;
-}): {
-    scope: string;
-    types?: ProposalCategory[];
-    minConfidence?: number;
-    maxPrs?: number;
-    maxTime?: string;
-    exclude?: string[];
-    noRoadmap?: boolean;
-    prompt?: string;
-    focusAreas?: string[];
-};
-//# sourceMappingURL=formulas.d.ts.map

package/dist/lib/formulas.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"formulas.d.ts","sourceRoot":"","sources":["../../src/lib/formulas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM/D,MAAM,WAAW,OAAO;IACtB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IAEb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qCAAqC;IACrC,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEhC,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,kDAAkD;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,gCAAgC;IAChC,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrC;AAMD,eAAO,MAAM,gBAAgB,EAAE,OAAO,EAwGrC,CAAC;AAMF;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAO3E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAQzD;AA0ID;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE;IACV,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GACA;IACD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAcA"}