@bradtaylorsf/alpha-loop 1.0.0

package/dist/lib/prerequisites.js

@@ -0,0 +1,54 @@
+import { commandExists, execAsync } from './shell.js';
+const AGENT_INSTALL_URLS = {
+    claude: 'https://claude.ai/code',
+    codex: 'https://github.com/openai/codex',
+    opencode: 'https://github.com/sst/opencode',
+};
+export class PrerequisiteError extends Error {
+    errors;
+    constructor(errors) {
+        super(errors.join('\n'));
+        this.errors = errors;
+        this.name = 'PrerequisiteError';
+    }
+}
+/**
+ * Verify required tools are installed: gh, git, and the configured agent CLI.
+ * Throws PrerequisiteError with all failures if any checks fail.
+ */
+export async function checkPrerequisites(config) {
+    const errors = [];
+    // Check git
+    if (!commandExists('git')) {
+        errors.push('git not found. Please install git.');
+    }
+    else {
+        // Check we're in a git repo
+        const gitCheck = await execAsync('git rev-parse --git-dir');
+        if (gitCheck.exitCode !== 0) {
+            errors.push('Not in a git repository.');
+        }
+    }
+    // Check gh CLI
+    if (!commandExists('gh')) {
+        errors.push('gh CLI not found. Install: https://cli.github.com/');
+    }
+    else {
+        // Check gh auth
+        const authCheck = await execAsync('gh auth status');
+        if (authCheck.exitCode !== 0) {
+            errors.push('gh not authenticated. Run: gh auth login');
+        }
+    }
+    // Check agent CLI
+    const agent = config.agent;
+    if (!commandExists(agent)) {
+        const installUrl = AGENT_INSTALL_URLS[agent] ?? '';
+        const installHint = installUrl ? ` Install: ${installUrl}` : '';
+        errors.push(`${agent} CLI not found.${installHint}`);
+    }
+    if (errors.length > 0) {
+        throw new PrerequisiteError(errors);
+    }
+}
+//# sourceMappingURL=prerequisites.js.map

package/dist/lib/prerequisites.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prerequisites.js","sourceRoot":"","sources":["../../src/lib/prerequisites.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAMtD,MAAM,kBAAkB,GAA2B;IACjD,MAAM,EAAE,wBAAwB;IAChC,KAAK,EAAE,iCAAiC;IACxC,QAAQ,EAAE,iCAAiC;CAC5C,CAAC;AAEF,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACd;IAA5B,YAA4B,MAAgB;QAC1C,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QADC,WAAM,GAAN,MAAM,CAAU;QAE1C,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAA0B;IACjE,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,YAAY;IACZ,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,4BAA4B;QAC5B,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,yBAAyB,CAAC,CAAC;QAC5D,IAAI,QAAQ,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,eAAe;IACf,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,gBAAgB;QAChB,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACpD,IAAI,SAAS,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACnD,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,aAAa,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,kBAAkB,WAAW,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/lib/prompts.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Prompt Builder — construct prompts for AI agents.
+ * Pure string template functions with no side effects.
+ */
+export type ImplementPromptOptions = {
+    issueNum: number;
+    title: string;
+    body: string;
+    visionContext?: string;
+    projectContext?: string;
+    previousResult?: string;
+    learningContext?: string;
+};
+export type ReviewPromptOptions = {
+    issueNum: number;
+    title: string;
+    body: string;
+    baseBranch: string;
+    visionContext?: string;
+};
+export type LearnPromptOptions = {
+    issueNum: number;
+    title: string;
+    status: string;
+    retries: number;
+    duration: number;
+    diff: string;
+    testOutput: string;
+    reviewOutput: string;
+    verifyOutput: string;
+    body?: string;
+};
+/**
+ * Build the implementation prompt for an AI agent.
+ */
+export declare function buildImplementPrompt(options: ImplementPromptOptions): string;
+/**
+ * Build the code review prompt for an AI agent.
+ */
+export declare function buildReviewPrompt(options: ReviewPromptOptions): string;
+/**
+ * Build the learning extraction prompt.
+ */
+export declare function buildLearnPrompt(options: LearnPromptOptions): string;

package/dist/lib/prompts.js

@@ -0,0 +1,102 @@
+/**
+ * Prompt Builder — construct prompts for AI agents.
+ * Pure string template functions with no side effects.
+ */
+/**
+ * Build the implementation prompt for an AI agent.
+ */
+export function buildImplementPrompt(options) {
+    const { issueNum, title, body, visionContext, projectContext, previousResult, learningContext } = options;
+    const sections = [
+        `Implement GitHub issue #${issueNum}: ${title}`,
+        '',
+        body,
+    ];
+    if (visionContext) {
+        sections.push('', '', '## Product Vision', visionContext);
+    }
+    if (projectContext) {
+        sections.push('', '', '## Technical Context', projectContext);
+    }
+    if (previousResult) {
+        sections.push('', '', previousResult);
+    }
+    if (learningContext) {
+        sections.push('', '', learningContext);
+    }
+    sections.push('', '## Before You Start', '1. Read the product vision and technical context above', '2. Make decisions that align with the target users and current priority', '3. Understand how your changes connect to existing code', "4. If you're creating new files, make sure they're wired into the appropriate entry points", '', '## After Implementing', '1. Write tests for your changes', '2. Run the test command to verify', `3. Commit with: git commit -m "feat: ${title} (closes #${issueNum})"`);
+    return sections.join('\n');
+}
+/**
+ * Build the code review prompt for an AI agent.
+ */
+export function buildReviewPrompt(options) {
+    const { issueNum, title, body, baseBranch, visionContext } = options;
+    const sections = [
+        `Review the code changes for issue #${issueNum}: ${title}`,
+        '',
+        `Run git diff origin/${baseBranch}...HEAD to see what changed. Then read the actual files that were modified.`,
+        '',
+        'Original requirements:',
+        body,
+    ];
+    if (visionContext) {
+        sections.push('', '', '## Product Vision (guide your review decisions)', visionContext);
+    }
+    sections.push('', '## Review Checklist', '', '### 1. Functional Completeness (MOST IMPORTANT)', '- Does the implementation FULLY address the issue requirements?', '- Are there any acceptance criteria that were NOT implemented?', '- If backend API endpoints were created, are they called from the frontend?', '- If frontend components were created, do they have working backend endpoints?', '- Are there any dead code paths (created but never wired in)?', '- Does the feature work end-to-end (data flows from UI → API → database → back to UI)?', '', '### 2. Integration Gaps', '- Are new routes/endpoints registered in the server entry point?', '- Are new components imported and rendered in the app?', '- Are new database tables/columns used by the API?', '- Are there missing imports, missing route registrations, or orphaned files?', '', '### 3. Code Quality', '- Security issues (injection, XSS, auth bypass)', '- Missing error handling for user-facing operations', '- Missing tests for new functionality', '- Code follows project conventions', '', '### 4. UX Review', '- Do UI changes match the target user profile?', '- Are error states handled (loading, empty, error)?', '- Is the feature discoverable (can users find it)?', '', '## Actions', '', 'For any issues you find:', `- CRITICAL (gaps, missing wiring, broken features): FIX THEM directly, run tests, commit with "fix: address review findings for #${issueNum}"`, '- WARNING (quality, security): FIX THEM directly if possible', '- INFO (suggestions, minor improvements): Note them in your report but don\'t block', '', 'After fixing, output a structured review report:', '', '### Findings Fixed', '- (list what you found and fixed)', '', '### Remaining Gaps', '- (anything you couldn\'t fix — these need human attention)', '', '### Verification Notes', '- (what a human should manually check)');
+    return sections.join('\n');
+}
+/**
+ * Build the learning extraction prompt.
+ */
+export function buildLearnPrompt(options) {
+    const { issueNum, title, status, retries, duration, diff, testOutput, reviewOutput, verifyOutput, body, } = options;
+    const today = new Date().toISOString().split('T')[0];
+    return `Analyze this completed development run. Output ONLY a markdown document with the exact structure below. Keep each section to 2-3 bullet points max. Be factual and concise -- no creative writing.
+
+## Run Info
+- Issue: #${issueNum} "${title}"
+- Status: ${status}
+- Retries: ${retries}
+- Duration: ${duration}s
+
+## Issue Requirements
+${body || '(no description)'}
+
+## Code Changes
+${diff || '(no diff available)'}
+
+## Test Results
+${testOutput || '(no test output)'}
+
+## Review Findings
+${reviewOutput || '(no review output)'}
+
+## Verification Results
+${verifyOutput || '(no verification output)'}
+
+Output ONLY this markdown structure, nothing else:
+
+---
+issue: ${issueNum}
+status: ${status}
+retries: ${retries}
+duration: ${duration}
+date: ${today}
+---
+## What Worked
+- (list what went well)
+
+## What Failed
+- (list what went wrong, or "Nothing" if all passed)
+
+## Patterns
+- (reusable patterns discovered)
+
+## Anti-Patterns
+- (mistakes to avoid in future)
+
+## Suggested Skill Updates
+- (specific skill file changes, or "None")`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/lib/prompts.js.map

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

package/dist/lib/session.d.ts

@@ -0,0 +1,28 @@
+import type { Config } from './config.js';
+import type { PipelineResult } from './pipeline.js';
+export type SessionContext = {
+    name: string;
+    branch: string;
+    resultsDir: string;
+    logsDir: string;
+    results: PipelineResult[];
+};
+/**
+ * Create a new session context with timestamp-based name.
+ * Optionally creates a session branch when autoMerge is enabled.
+ */
+export declare function createSession(config: Config): SessionContext;
+/**
+ * Save a pipeline result to the session directory as JSON.
+ */
+export declare function saveResult(session: SessionContext, result: PipelineResult): void;
+/**
+ * Get the previous issue result formatted for prompt context.
+ * Returns null if no previous results exist.
+ */
+export declare function getPreviousResult(session: SessionContext): string | null;
+/**
+ * Finalize session: commit learnings to session branch, create session PR.
+ * Only runs when autoMerge is enabled and issues were processed.
+ */
+export declare function finalizeSession(session: SessionContext, config: Config): Promise<string | null>;

package/dist/lib/session.js

@@ -0,0 +1,173 @@
+/**
+ * Session Management — create sessions, save results, finalize with PR.
+ */
+import { mkdirSync, writeFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { log } from './logger.js';
+import { exec, formatTimestamp } from './shell.js';
+import { createPR } from './github.js';
+/**
+ * Create a new session context with timestamp-based name.
+ * Optionally creates a session branch when autoMerge is enabled.
+ */
+export function createSession(config) {
+    const now = new Date();
+    const timestamp = formatTimestamp(now);
+    const name = `session/${timestamp}`;
+    const branch = config.mergeTo || name;
+    const projectDir = process.cwd();
+    const resultsDir = join(projectDir, '.alpha-loop', 'sessions', name);
+    const logsDir = join(resultsDir, 'logs');
+    mkdirSync(resultsDir, { recursive: true });
+    mkdirSync(logsDir, { recursive: true });
+    // Create session branch and draft PR if auto-merge is enabled
+    if (config.autoMerge && !config.dryRun) {
+        // Fetch latest to ensure we have remote refs
+        exec('git fetch origin', { cwd: projectDir });
+        const branchExists = exec(`git rev-parse --verify "${branch}"`, { cwd: projectDir });
+        if (branchExists.exitCode !== 0) {
+            // Create from remote base branch first, fall back to local
+            const fromRemote = exec(`git checkout -b "${branch}" "origin/${config.baseBranch}"`, { cwd: projectDir });
+            if (fromRemote.exitCode !== 0) {
+                exec(`git checkout -b "${branch}" "${config.baseBranch}"`, { cwd: projectDir });
+            }
+            // Push session branch to remote so PRs can target it
+            exec(`git push origin "${branch}"`, { cwd: projectDir });
+            // Switch back to the original branch
+            exec(`git checkout -`, { cwd: projectDir });
+            log.info(`Created session branch: ${branch}`);
+            // Create a draft PR immediately so the session is visible in GitHub
+            try {
+                const draftPR = createPR({
+                    repo: config.repo,
+                    base: config.baseBranch,
+                    head: branch,
+                    title: `Session: ${name}`,
+                    body: `## Session In Progress\n\n**Branch:** ${branch}\n**Started:** ${new Date().toISOString()}\n\nThis PR will be updated as issues are processed.\n\n---\n*Automated by alpha-loop*`,
+                    cwd: projectDir,
+                });
+                log.success(`Session PR (draft): ${draftPR}`);
+            }
+            catch {
+                // Non-fatal — PR can be created later during finalization
+                log.warn('Could not create draft session PR — will create during finalization');
+            }
+        }
+        else {
+            log.info(`Session branch already exists: ${branch}`);
+        }
+    }
+    return { name, branch, resultsDir, logsDir, results: [] };
+}
+/**
+ * Save a pipeline result to the session directory as JSON.
+ */
+export function saveResult(session, result) {
+    const filePath = join(session.resultsDir, `result-${result.issueNum}.json`);
+    writeFileSync(filePath, JSON.stringify(result, null, 2) + '\n');
+    log.info(`Session result saved: ${filePath}`);
+}
+/**
+ * Get the previous issue result formatted for prompt context.
+ * Returns null if no previous results exist.
+ */
+export function getPreviousResult(session) {
+    if (session.results.length === 0)
+        return null;
+    const prev = session.results[session.results.length - 1];
+    return `## Previous Issue in This Session
+- Issue #${prev.issueNum}: ${prev.title}
+- Status: ${prev.status}
+- Tests: ${prev.testsPassing ? 'PASSING' : 'FAILING'}
+- Files changed: ${prev.filesChanged}
+- Duration: ${prev.duration}s
+${prev.prUrl ? `- PR: ${prev.prUrl}` : ''}
+
+Build on what was already done. Avoid duplicating work.`;
+}
+/**
+ * Finalize session: commit learnings to session branch, create session PR.
+ * Only runs when autoMerge is enabled and issues were processed.
+ */
+export async function finalizeSession(session, config) {
+    if (!config.autoMerge)
+        return null;
+    if (session.branch === config.baseBranch)
+        return null;
+    if (session.results.length === 0)
+        return null;
+    if (config.dryRun) {
+        log.dry(`Would finalize session: ${session.branch} -> ${config.baseBranch}`);
+        return null;
+    }
+    log.step(`Finalizing session: ${session.branch}`);
+    const projectDir = process.cwd();
+    // Ensure we're on the session branch
+    exec('git fetch origin', { cwd: projectDir });
+    const checkout = exec(`git checkout "${session.branch}"`, { cwd: projectDir });
+    if (checkout.exitCode !== 0) {
+        log.warn('Could not checkout session branch for finalization');
+        return null;
+    }
+    // Stage learnings
+    const learningsDir = join(projectDir, '.alpha-loop', 'learnings');
+    if (existsSync(learningsDir)) {
+        exec('git add .alpha-loop/learnings/', { cwd: projectDir });
+    }
+    // Commit if there are staged changes
+    const diffResult = exec('git diff --cached --quiet', { cwd: projectDir });
+    if (diffResult.exitCode !== 0) {
+        const commitIssueCount = session.results.length;
+        exec(`git commit -m "chore: learnings from ${session.name}\n\nProcessed ${commitIssueCount} issue(s) in this session."`, { cwd: projectDir });
+        exec(`git push origin "${session.branch}"`, { cwd: projectDir });
+    }
+    // Create or update session PR
+    const issueCount = session.results.length;
+    const successCount = session.results.filter((r) => r.status === 'success').length;
+    const failureCount = issueCount - successCount;
+    const totalDuration = session.results.reduce((sum, r) => sum + r.duration, 0);
+    const prTitle = `Session: ${session.name} — ${successCount}/${issueCount} succeeded`;
+    const prBody = `## Session Summary
+
+**Branch:** ${session.branch}
+**Issues processed:** ${issueCount} (${successCount} succeeded, ${failureCount} failed)
+**Total duration:** ${Math.round(totalDuration / 60)} minutes
+**Completed:** ${new Date().toISOString()}
+
+### Issues
+${session.results.map((r) => `- #${r.issueNum}: ${r.title} — ${r.status === 'success' ? 'SUCCESS' : 'FAILURE'}${r.prUrl ? ` ([PR](${r.prUrl}))` : ''}`).join('\n')}
+
+---
+This PR collects all changes from this session for final review before merging to ${config.baseBranch}.
+
+Automated by alpha-loop`;
+    try {
+        const prUrl = createPR({
+            repo: config.repo,
+            base: config.baseBranch,
+            head: session.branch,
+            title: prTitle,
+            body: prBody,
+            cwd: projectDir,
+        });
+        log.success(`Session PR: ${prUrl}`);
+        return prUrl;
+    }
+    catch (err) {
+        // If createPR failed (e.g. nothing to compare), try creating via gh directly
+        log.warn(`createPR failed: ${err instanceof Error ? err.message : err}`);
+        try {
+            const fallback = exec(`gh pr create --repo "${config.repo}" --base "${config.baseBranch}" --head "${session.branch}" --title "${prTitle}" --body "Session finalization — see branch for details"`, { cwd: projectDir });
+            if (fallback.exitCode === 0 && fallback.stdout.trim()) {
+                log.success(`Session PR (fallback): ${fallback.stdout.trim()}`);
+                return fallback.stdout.trim();
+            }
+        }
+        catch {
+            // Fall through
+        }
+        log.warn('Could not create session PR — check branch manually');
+        return null;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/lib/session.js.map

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

package/dist/lib/shell.d.ts

@@ -0,0 +1,32 @@
+export type ExecResult = {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+};
+/**
+ * Execute a shell command synchronously and return structured result.
+ * Does not throw on non-zero exit — returns exitCode instead.
+ */
+export declare function exec(command: string, options?: {
+    cwd?: string;
+    env?: Record<string, string>;
+    timeout?: number;
+}): ExecResult;
+/**
+ * Run a shell command asynchronously. Does not throw on non-zero exit.
+ */
+export declare function execAsync(cmd: string, cwd?: string): Promise<ExecResult>;
+/** Run a command with streaming output. Returns exit code. */
+export declare function run(cmd: string, args: string[], options?: {
+    cwd?: string;
+    onStdout?: (line: string) => void;
+    onStderr?: (line: string) => void;
+}): Promise<number>;
+/**
+ * Check whether a command exists on the system PATH.
+ */
+/**
+ * Format a Date as YYYYMMDD-HHMMSS for filenames and session names.
+ */
+export declare function formatTimestamp(date: Date): string;
+export declare function commandExists(cmd: string): boolean;

package/dist/lib/shell.js

@@ -0,0 +1,95 @@
+/**
+ * Shell execution helpers.
+ */
+import { execSync as nodeExecSync, exec as nodeExec, spawn } from 'node:child_process';
+import * as readline from 'node:readline';
+/** Max buffer for async exec output (10 MB). */
+const EXEC_MAX_BUFFER = 10 * 1024 * 1024;
+/**
+ * Execute a shell command synchronously and return structured result.
+ * Does not throw on non-zero exit — returns exitCode instead.
+ */
+export function exec(command, options) {
+    try {
+        const stdout = nodeExecSync(command, {
+            cwd: options?.cwd,
+            env: options?.env ? { ...process.env, ...options.env } : undefined,
+            timeout: options?.timeout,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return { stdout: stdout.trim(), stderr: '', exitCode: 0 };
+    }
+    catch (err) {
+        const e = err;
+        return {
+            stdout: (e.stdout ?? '').toString().trim(),
+            stderr: (e.stderr ?? '').toString().trim(),
+            exitCode: e.status ?? 1,
+        };
+    }
+}
+/**
+ * Run a shell command asynchronously. Does not throw on non-zero exit.
+ */
+export async function execAsync(cmd, cwd) {
+    return new Promise((resolve) => {
+        nodeExec(cmd, { cwd, maxBuffer: EXEC_MAX_BUFFER }, (error, stdout, stderr) => {
+            let exitCode = 0;
+            if (error) {
+                const execErr = error;
+                exitCode = typeof execErr.code === 'number' ? execErr.code : 1;
+            }
+            resolve({
+                stdout: stdout?.toString() ?? '',
+                stderr: stderr?.toString() ?? '',
+                exitCode,
+            });
+        });
+    });
+}
+/** Run a command with streaming output. Returns exit code. */
+export function run(cmd, args, options) {
+    return new Promise((resolve) => {
+        const child = spawn(cmd, args, {
+            cwd: options?.cwd,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        if (child.stdout) {
+            const rl = readline.createInterface({ input: child.stdout });
+            rl.on('line', (line) => options?.onStdout?.(line));
+        }
+        if (child.stderr) {
+            const rl = readline.createInterface({ input: child.stderr });
+            rl.on('line', (line) => options?.onStderr?.(line));
+        }
+        child.on('close', (code) => resolve(code ?? 1));
+    });
+}
+/**
+ * Check whether a command exists on the system PATH.
+ */
+/**
+ * Format a Date as YYYYMMDD-HHMMSS for filenames and session names.
+ */
+export function formatTimestamp(date) {
+    const y = date.getFullYear();
+    const mo = String(date.getMonth() + 1).padStart(2, '0');
+    const d = String(date.getDate()).padStart(2, '0');
+    const h = String(date.getHours()).padStart(2, '0');
+    const mi = String(date.getMinutes()).padStart(2, '0');
+    const s = String(date.getSeconds()).padStart(2, '0');
+    return `${y}${mo}${d}-${h}${mi}${s}`;
+}
+export function commandExists(cmd) {
+    if (!/^[a-zA-Z0-9_-]+$/.test(cmd))
+        return false;
+    try {
+        nodeExecSync(`command -v "${cmd}"`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=shell.js.map

package/dist/lib/shell.js.map

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

package/dist/lib/testing.d.ts

@@ -0,0 +1,10 @@
+import type { Config } from './config.js';
+export type TestResult = {
+    passed: boolean;
+    output: string;
+};
+/**
+ * Run the configured test command in a worktree.
+ * Returns structured result instead of throwing.
+ */
+export declare function runTests(worktree: string, config: Config, logFile: string): TestResult;

package/dist/lib/testing.js

@@ -0,0 +1,51 @@
+/**
+ * Test Runner — execute tests in worktrees with retry support.
+ */
+import { appendFileSync } from 'node:fs';
+import { exec } from './shell.js';
+import { log } from './logger.js';
+/** Test runner timeout (5 minutes). */
+const TEST_TIMEOUT_MS = 300_000;
+/**
+ * Run the configured test command in a worktree.
+ * Returns structured result instead of throwing.
+ */
+export function runTests(worktree, config, logFile) {
+    if (config.skipTests) {
+        log.info('Tests skipped (skipTests=true)');
+        return { passed: true, output: 'Tests skipped' };
+    }
+    if (config.dryRun) {
+        log.dry('Would run tests in worktree');
+        return { passed: true, output: 'Tests skipped (dry run)' };
+    }
+    log.step(`Running tests: ${config.testCommand}`);
+    const env = {};
+    if (config.runFull) {
+        env.RECORD_FIXTURES = 'true';
+    }
+    const result = exec(config.testCommand, {
+        cwd: worktree,
+        env: Object.keys(env).length > 0 ? env : undefined,
+        timeout: TEST_TIMEOUT_MS,
+    });
+    // Append test output to log file
+    if (logFile) {
+        try {
+            appendFileSync(logFile, `\n--- Test Output ---\n${result.stdout}\n${result.stderr}\n`);
+        }
+        catch {
+            // Log file write failure is non-fatal
+        }
+    }
+    const output = result.stdout + (result.stderr ? `\n${result.stderr}` : '');
+    if (result.exitCode === 0) {
+        log.success('All tests passed');
+        return { passed: true, output };
+    }
+    log.warn(`Tests failed (exit code ${result.exitCode})`);
+    return { passed: false, output };
+}
+// Note: Live verification (playwright-cli) is in src/lib/verify.ts
+// This module only handles unit/integration test execution.
+//# sourceMappingURL=testing.js.map

package/dist/lib/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../src/lib/testing.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAGlC,uCAAuC;AACvC,MAAM,eAAe,GAAG,OAAO,CAAC;AAOhC;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,MAAc,EAAE,OAAe;IACxE,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,GAAG,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC3C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACnD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,GAAG,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QACvC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC;IAC7D,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAEjD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,GAAG,CAAC,eAAe,GAAG,MAAM,CAAC;IAC/B,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;QACtC,GAAG,EAAE,QAAQ;QACb,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;QAClD,OAAO,EAAE,eAAe;KACzB,CAAC,CAAC;IAEH,iCAAiC;IACjC,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,cAAc,CAAC,OAAO,EAAE,0BAA0B,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QACzF,CAAC;QAAC,MAAM,CAAC;YACP,sCAAsC;QACxC,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAE3E,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAChC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,2BAA2B,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;IACxD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACnC,CAAC;AAED,mEAAmE;AACnE,4DAA4D"}

package/dist/lib/verify.d.ts

@@ -0,0 +1,18 @@
+import type { Config } from './config.js';
+export type VerifyResult = {
+    passed: boolean;
+    output: string;
+};
+/**
+ * Run live verification using playwright-cli.
+ * Starts the app, sends agent to test it, returns result.
+ */
+export declare function runVerify(options: {
+    worktree: string;
+    logFile: string;
+    issueNum: number;
+    title: string;
+    body: string;
+    config: Config;
+    sessionDir: string;
+}): Promise<VerifyResult>;