@bradtaylorsf/alpha-loop 1.0.0

package/dist/lib/agent.js

@@ -0,0 +1,97 @@
+/**
+ * Agent Runner — spawn AI agents with real-time output streaming.
+ */
+import { spawn } from 'node:child_process';
+import { createWriteStream } from 'node:fs';
+import { log } from './logger.js';
+/**
+ * Build CLI command and args for a given agent type.
+ */
+export function buildAgentArgs(options) {
+    switch (options.agent) {
+        case 'claude': {
+            const args = [
+                '-p',
+                '--model', options.model,
+                '--dangerously-skip-permissions',
+                '--verbose',
+                '--output-format', 'text',
+            ];
+            // Note: --max-turns intentionally omitted. Let the agent finish naturally.
+            // The harness controls retry limits via maxTestRetries, not agent turn limits.
+            return { command: 'claude', args };
+        }
+        case 'codex': {
+            const args = [
+                '-q',
+                '--model', options.model,
+                '--auto-edit',
+            ];
+            return { command: 'codex', args };
+        }
+        case 'opencode': {
+            const args = [
+                'run',
+                '--model', options.model,
+            ];
+            return { command: 'opencode', args };
+        }
+        default:
+            throw new Error(`Unknown agent type: ${options.agent}`);
+    }
+}
+/**
+ * Spawn an AI agent with a prompt.
+ * Streams output to terminal in real-time while capturing it.
+ */
+export async function spawnAgent(options) {
+    const { command, args } = buildAgentArgs(options);
+    log.info(`Agent: ${options.agent} | Model: ${options.model} | CWD: ${options.cwd}`);
+    const startTime = Date.now();
+    const chunks = [];
+    let logStream;
+    if (options.logFile) {
+        logStream = createWriteStream(options.logFile, { flags: 'w' });
+    }
+    return new Promise((resolve) => {
+        const child = spawn(command, args, {
+            cwd: options.cwd,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        // Pipe prompt via stdin (like: echo "$prompt" | claude -p)
+        child.stdin.write(options.prompt);
+        child.stdin.end();
+        const handleData = (data) => {
+            const text = data.toString();
+            chunks.push(text);
+            // Stream to terminal only when verbose is enabled
+            if (options.verbose) {
+                process.stderr.write(data);
+            }
+            // Always write to log file if provided
+            if (logStream) {
+                logStream.write(data);
+            }
+        };
+        child.stdout.on('data', handleData);
+        child.stderr.on('data', handleData);
+        const finish = (exitCode, output) => {
+            const duration = Date.now() - startTime;
+            if (logStream) {
+                logStream.end(() => {
+                    resolve({ exitCode, output, duration });
+                });
+            }
+            else {
+                resolve({ exitCode, output, duration });
+            }
+        };
+        child.on('close', (code) => {
+            finish(code ?? 1, chunks.join(''));
+        });
+        child.on('error', (err) => {
+            finish(1, `Failed to spawn ${command}: ${err.message}`);
+        });
+    });
+}
+//# sourceMappingURL=agent.js.map

package/dist/lib/agent.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,35 @@
+export type Config = {
+    repo: string;
+    repoOwner: string;
+    project: number;
+    model: string;
+    reviewModel: string;
+    pollInterval: number;
+    dryRun: boolean;
+    baseBranch: string;
+    logDir: string;
+    labelReady: string;
+    maxTestRetries: number;
+    testCommand: string;
+    devCommand: string;
+    port: number;
+    skipTests: boolean;
+    skipReview: boolean;
+    skipInstall: boolean;
+    skipPreflight: boolean;
+    skipVerify: boolean;
+    skipLearn: boolean;
+    skipE2e: boolean;
+    maxIssues: number;
+    maxSessionDuration: number;
+    milestone: string;
+    autoMerge: boolean;
+    mergeTo: string;
+    autoCleanup: boolean;
+    runFull: boolean;
+    verbose: boolean;
+};
+/** Validate a string contains only safe shell characters. */
+export declare function assertSafeShellArg(value: string, name: string): string;
+export declare function detectRepo(): string | null;
+export declare function loadConfig(overrides?: Partial<Config>): Config;

package/dist/lib/config.js

@@ -0,0 +1,179 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { parse as parseYaml } from 'yaml';
+const DEFAULTS = {
+    repo: '',
+    repoOwner: '',
+    project: 2,
+    model: 'opus',
+    reviewModel: 'opus',
+    pollInterval: 60,
+    dryRun: false,
+    baseBranch: 'master',
+    logDir: 'logs',
+    labelReady: 'ready',
+    maxTestRetries: 3,
+    testCommand: 'pnpm test',
+    devCommand: 'pnpm dev',
+    port: 3000,
+    skipTests: false,
+    skipReview: false,
+    skipInstall: false,
+    skipPreflight: false,
+    skipVerify: false,
+    skipLearn: false,
+    skipE2e: false,
+    maxIssues: 0,
+    maxSessionDuration: 0,
+    milestone: '',
+    autoMerge: true,
+    mergeTo: '',
+    autoCleanup: true,
+    runFull: false,
+    verbose: false,
+};
+/** Map from YAML key (snake_case) to Config key (camelCase). */
+const YAML_KEY_MAP = {
+    repo: 'repo',
+    project: 'project',
+    model: 'model',
+    review_model: 'reviewModel',
+    poll_interval: 'pollInterval',
+    dry_run: 'dryRun',
+    base_branch: 'baseBranch',
+    log_dir: 'logDir',
+    label: 'labelReady',
+    max_test_retries: 'maxTestRetries',
+    test_command: 'testCommand',
+    dev_command: 'devCommand',
+    port: 'port',
+    skip_tests: 'skipTests',
+    skip_review: 'skipReview',
+    skip_install: 'skipInstall',
+    skip_preflight: 'skipPreflight',
+    skip_verify: 'skipVerify',
+    skip_learn: 'skipLearn',
+    skip_e2e: 'skipE2e',
+    max_issues: 'maxIssues',
+    max_session_duration: 'maxSessionDuration',
+    milestone: 'milestone',
+    auto_merge: 'autoMerge',
+    merge_to: 'mergeTo',
+    auto_cleanup: 'autoCleanup',
+    run_full: 'runFull',
+    verbose: 'verbose',
+};
+/** Map from env var name to Config key. */
+const ENV_KEY_MAP = {
+    REPO: 'repo',
+    PROJECT_NUM: 'project',
+    MODEL: 'model',
+    REVIEW_MODEL: 'reviewModel',
+    POLL_INTERVAL: 'pollInterval',
+    DRY_RUN: 'dryRun',
+    BASE_BRANCH: 'baseBranch',
+    LOG_DIR: 'logDir',
+    LABEL_READY: 'labelReady',
+    MAX_TEST_RETRIES: 'maxTestRetries',
+    TEST_COMMAND: 'testCommand',
+    DEV_COMMAND: 'devCommand',
+    PORT: 'port',
+    SKIP_TESTS: 'skipTests',
+    SKIP_REVIEW: 'skipReview',
+    SKIP_INSTALL: 'skipInstall',
+    SKIP_PREFLIGHT: 'skipPreflight',
+    SKIP_VERIFY: 'skipVerify',
+    SKIP_LEARN: 'skipLearn',
+    SKIP_E2E: 'skipE2e',
+    MAX_ISSUES: 'maxIssues',
+    MAX_SESSION_DURATION: 'maxSessionDuration',
+    MILESTONE: 'milestone',
+    AUTO_MERGE: 'autoMerge',
+    MERGE_TO: 'mergeTo',
+    AUTO_CLEANUP: 'autoCleanup',
+    RUN_FULL: 'runFull',
+    VERBOSE: 'verbose',
+};
+function coerce(value, current) {
+    if (typeof current === 'number')
+        return Number(value);
+    if (typeof current === 'boolean')
+        return value === 'true' || value === '1';
+    return value;
+}
+/** Validate a string contains only safe shell characters. */
+export function assertSafeShellArg(value, name) {
+    if (!/^[a-zA-Z0-9._\-/]+$/.test(value)) {
+        throw new Error(`Invalid ${name}: contains unsafe characters: ${value}`);
+    }
+    return value;
+}
+export function detectRepo() {
+    try {
+        const url = execSync('git remote get-url origin', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        // HTTPS: https://github.com/owner/repo.git
+        const https = url.match(/github\.com\/([^/]+)\/([^/.]+)/);
+        if (https)
+            return `${https[1]}/${https[2]}`;
+        // SSH: git@github.com:owner/repo.git
+        const ssh = url.match(/github\.com:([^/]+)\/([^/.]+)/);
+        if (ssh)
+            return `${ssh[1]}/${ssh[2]}`;
+    }
+    catch {
+        // Not a git repo or no remote
+    }
+    return null;
+}
+function loadYamlConfig(configPath) {
+    if (!existsSync(configPath))
+        return {};
+    const raw = readFileSync(configPath, 'utf-8');
+    const parsed = parseYaml(raw);
+    if (!parsed || typeof parsed !== 'object')
+        return {};
+    const result = {};
+    for (const [yamlKey, configKey] of Object.entries(YAML_KEY_MAP)) {
+        if (yamlKey in parsed) {
+            result[configKey] = parsed[yamlKey];
+        }
+    }
+    return result;
+}
+function loadEnvConfig() {
+    const result = {};
+    for (const [envKey, configKey] of Object.entries(ENV_KEY_MAP)) {
+        const val = process.env[envKey];
+        if (val !== undefined) {
+            result[configKey] = coerce(val, DEFAULTS[configKey]);
+        }
+    }
+    return result;
+}
+export function loadConfig(overrides) {
+    const yamlConfig = loadYamlConfig('.alpha-loop.yaml');
+    const envConfig = loadEnvConfig();
+    // Auto-detect repo if not set by any source
+    const detectedRepo = detectRepo();
+    const autoDetect = {};
+    if (detectedRepo) {
+        autoDetect.repo = detectedRepo;
+    }
+    // Precedence: overrides (CLI flags) > env vars > config file > auto-detect > defaults
+    const merged = {
+        ...DEFAULTS,
+        ...autoDetect,
+        ...yamlConfig,
+        ...envConfig,
+        ...overrides,
+    };
+    // Derive repoOwner from repo
+    if (merged.repo) {
+        merged.repoOwner = merged.repo.split('/')[0] ?? '';
+    }
+    return merged;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/context.d.ts

@@ -0,0 +1,17 @@
+import { type ExecResult } from './shell.js';
+/**
+ * Generate a fresh project context file by invoking the configured agent.
+ */
+export declare function generateProjectContext(projectDir: string, agentCommand: string, executor?: (cmd: string, cwd?: string) => Promise<ExecResult>): Promise<void>;
+/**
+ * Read the current project context, or null if it doesn't exist.
+ */
+export declare function getProjectContext(projectDir?: string): string | null;
+/**
+ * Check if context needs refreshing (older than 4 hours or doesn't exist).
+ */
+export declare function contextNeedsRefresh(projectDir?: string, now?: number): boolean;
+/**
+ * Update context after a successful run by appending a summary under ## Active State.
+ */
+export declare function updateContextAfterRun(issueNum: number, title: string, status: string, filesChanged: number, projectDir?: string): void;

package/dist/lib/context.js

@@ -0,0 +1,96 @@
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { execAsync } from './shell.js';
+import { log } from './logger.js';
+const CONTEXT_DIR = '.alpha-loop';
+const CONTEXT_FILE = join(CONTEXT_DIR, 'context.md');
+// Context expires after 4 hours
+const CONTEXT_MAX_AGE_MS = 4 * 60 * 60 * 1000;
+const SCAN_PROMPT = `Analyze this codebase and produce a concise project context file. Read the key files (package.json, entry points, config files, README, CLAUDE.md) and output ONLY this markdown structure:
+
+## Architecture
+- Entry points and how they connect (e.g., "Express server in src/server/index.ts mounts routes from routes/*.ts")
+- Database (type, schema location, how to query)
+- Key directories and what they contain
+
+## Conventions
+- Language, framework, coding patterns used
+- How tests are structured and run
+- How new features should be wired in (e.g., "new routes must be imported in index.ts")
+
+## Critical Rules
+- Files/directories that must not be deleted or modified without care
+- Integration points that break if not updated together
+- Common mistakes to avoid in this codebase
+
+## Active State
+- Test status: (will be filled in by the loop)
+- Recent changes: (will be filled in by the loop)
+
+Keep each section to 3-5 bullet points. Be specific to THIS codebase, not generic advice. Under 400 words total.`;
+/**
+ * Generate a fresh project context file by invoking the configured agent.
+ */
+export async function generateProjectContext(projectDir, agentCommand, executor = execAsync) {
+    const contextDir = join(projectDir, CONTEXT_DIR);
+    const contextFile = join(projectDir, CONTEXT_FILE);
+    if (!existsSync(contextDir)) {
+        mkdirSync(contextDir, { recursive: true });
+    }
+    const escapedPrompt = SCAN_PROMPT.replace(/'/g, "'\\''");
+    const cmd = `echo '${escapedPrompt}' | ${agentCommand} -p --output-format text 2>/dev/null`;
+    const result = await executor(cmd, projectDir);
+    if (result.exitCode !== 0 || !result.stdout.trim()) {
+        log.warn(`Project context generation failed (exit ${result.exitCode})`);
+        return;
+    }
+    writeFileSync(contextFile, result.stdout, 'utf-8');
+}
+/**
+ * Read the current project context, or null if it doesn't exist.
+ */
+export function getProjectContext(projectDir = '.') {
+    const contextFile = join(projectDir, CONTEXT_FILE);
+    if (!existsSync(contextFile)) {
+        return null;
+    }
+    return readFileSync(contextFile, 'utf-8');
+}
+/**
+ * Check if context needs refreshing (older than 4 hours or doesn't exist).
+ */
+export function contextNeedsRefresh(projectDir = '.', now = Date.now()) {
+    const contextFile = join(projectDir, CONTEXT_FILE);
+    if (!existsSync(contextFile)) {
+        return true;
+    }
+    const mtime = statSync(contextFile).mtimeMs;
+    return (now - mtime) >= CONTEXT_MAX_AGE_MS;
+}
+/**
+ * Update context after a successful run by appending a summary under ## Active State.
+ */
+export function updateContextAfterRun(issueNum, title, status, filesChanged, projectDir = '.') {
+    const contextFile = join(projectDir, CONTEXT_FILE);
+    if (!existsSync(contextFile)) {
+        return;
+    }
+    const timestamp = new Date().toISOString().replace(/\.\d+Z$/, '');
+    const entry = `- [${timestamp}] #${issueNum} ${title} (${status}) — ${filesChanged} files changed`;
+    const content = readFileSync(contextFile, 'utf-8');
+    const marker = '## Active State';
+    const markerIndex = content.indexOf(marker);
+    if (markerIndex === -1) {
+        return;
+    }
+    // Insert the entry on the line after the marker
+    const insertPos = content.indexOf('\n', markerIndex);
+    if (insertPos === -1) {
+        // Marker is at end of file
+        writeFileSync(contextFile, content + '\n' + entry + '\n', 'utf-8');
+        return;
+    }
+    const updated = content.slice(0, insertPos + 1) + entry + '\n' + content.slice(insertPos + 1);
+    writeFileSync(contextFile, updated, 'utf-8');
+}
+//# sourceMappingURL=context.js.map

package/dist/lib/context.js.map

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

package/dist/lib/github.d.ts

@@ -0,0 +1,61 @@
+export type Issue = {
+    number: number;
+    title: string;
+    body: string;
+    labels: string[];
+};
+export type Milestone = {
+    number: number;
+    title: string;
+    description: string;
+    openIssues: number;
+    closedIssues: number;
+    dueOn: string | null;
+    state: string;
+};
+/**
+ * List open milestones for a repository.
+ */
+export declare function listMilestones(repo: string): Milestone[];
+/**
+ * Fetch issues to process. When a project board is configured, reads from
+ * the board in display order (the order you set by dragging), filtered to
+ * "Todo" status. Falls back to label-based polling when no project is set.
+ *
+ * When a milestone is specified, only issues in that milestone are returned.
+ */
+export declare function pollIssues(repo: string, label: string, limit?: number, options?: {
+    project?: number;
+    repoOwner?: string;
+    milestone?: string;
+}): Issue[];
+/**
+ * Add/remove labels on an issue.
+ */
+export declare function labelIssue(repo: string, issueNum: number, addLabel: string, removeLabel?: string): void;
+/**
+ * Comment on an issue.
+ */
+export declare function commentIssue(repo: string, issueNum: number, body: string): void;
+export type CreatePROptions = {
+    repo: string;
+    base: string;
+    head: string;
+    title: string;
+    body: string;
+    cwd?: string;
+};
+/**
+ * Create a PR, or update an existing one if a PR already exists for the branch.
+ * Returns the PR URL.
+ */
+export declare function createPR(options: CreatePROptions): string;
+/**
+ * Merge a PR by branch name.
+ */
+export declare function mergePR(repo: string, head: string, method?: 'squash' | 'merge'): void;
+/**
+ * Update project board status for an issue.
+ * This is a multi-step operation using gh project commands.
+ */
+export declare function updateProjectStatus(repo: string, projectNum: number, owner: string, issueNum: number, status: string): void;