@bradtaylorsf/alpha-loop 1.0.0

package/dist/commands/run.js

@@ -0,0 +1,321 @@
+/**
+ * Run Command — the main loop: poll issues, process them, finalize session.
+ */
+import { join } from 'node:path';
+import * as readline from 'node:readline';
+import { log } from '../lib/logger.js';
+import { exec } from '../lib/shell.js';
+import { loadConfig } from '../lib/config.js';
+import { pollIssues, listMilestones } from '../lib/github.js';
+import { processIssue } from '../lib/pipeline.js';
+import { createSession, finalizeSession } from '../lib/session.js';
+import { cleanupWorktree } from '../lib/worktree.js';
+import { generateSessionSummary } from '../lib/learning.js';
+import { hasVision } from '../lib/vision.js';
+import { contextNeedsRefresh } from '../lib/context.js';
+import { runPreflight, runPortCheck } from '../lib/preflight.js';
+import { syncAgentAssets } from './sync.js';
+/**
+ * Check that required CLI tools are installed.
+ */
+function checkPrerequisites() {
+    const tools = [
+        { name: 'gh', message: 'GitHub CLI not found. Install: https://cli.github.com/' },
+        { name: 'git', message: 'git not found.' },
+        { name: 'claude', message: 'Claude CLI not found. Install: npm install -g @anthropic-ai/claude-code' },
+    ];
+    for (const tool of tools) {
+        const result = exec(`command -v "${tool.name}"`);
+        if (result.exitCode !== 0) {
+            log.error(tool.message);
+            process.exit(1);
+        }
+    }
+}
+/**
+ * Print the startup banner showing all configuration.
+ */
+function printBanner(config, session) {
+    const BOLD = '\x1b[1m';
+    const CYAN = '\x1b[0;36m';
+    const NC = '\x1b[0m';
+    console.error('');
+    console.error(`${BOLD}${CYAN}=====================================${NC}`);
+    console.error(`${BOLD}${CYAN}  Alpha Loop${NC}`);
+    console.error(`${BOLD}${CYAN}=====================================${NC}`);
+    console.error('');
+    console.error(`  Repo:           ${BOLD}${config.repo}${NC}`);
+    console.error(`  Project:        ${BOLD}#${config.project} (${config.repoOwner})${NC}`);
+    console.error(`  Model:          ${BOLD}${config.model}${NC}`);
+    console.error(`  Review Model:   ${BOLD}${config.reviewModel}${NC}`);
+    console.error(`  Base Branch:    ${BOLD}${config.baseBranch}${NC}`);
+    console.error(`  Label:          ${BOLD}${config.labelReady}${NC}`);
+    console.error(`  Dry Run:        ${BOLD}${config.dryRun}${NC}`);
+    console.error(`  Skip Tests:     ${BOLD}${config.skipTests}${NC}`);
+    console.error(`  Skip Review:    ${BOLD}${config.skipReview}${NC}`);
+    console.error(`  Skip Learn:     ${BOLD}${config.skipLearn}${NC}`);
+    console.error(`  Verbose:        ${BOLD}${config.verbose}${NC}`);
+    console.error(`  Test Retries:   ${BOLD}${config.maxTestRetries}${NC}`);
+    console.error(`  Max Issues:     ${BOLD}${config.maxIssues || 'unlimited'}${NC}`);
+    console.error(`  Max Duration:   ${BOLD}${config.maxSessionDuration ? config.maxSessionDuration + 's' : 'unlimited'}${NC}`);
+    console.error(`  Auto Merge:     ${BOLD}${config.autoMerge}${NC}`);
+    console.error(`  Session:        ${BOLD}${session.branch}${NC}`);
+    console.error('');
+}
+function askYesNo(prompt) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() !== 'n');
+        });
+    });
+}
+function askChoice(prompt, max) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl.question(prompt, (answer) => {
+            rl.close();
+            const num = parseInt(answer.trim(), 10);
+            if (isNaN(num) || num < 0 || num > max) {
+                resolve(-1); // invalid
+            }
+            else {
+                resolve(num);
+            }
+        });
+    });
+}
+/**
+ * Show open milestones and let the user pick one, or choose "all in order".
+ * Returns the milestone title to filter by, or empty string for all issues.
+ */
+async function pickMilestone(repo) {
+    const milestones = listMilestones(repo);
+    if (milestones.length === 0) {
+        log.info('No open milestones found — processing all ready issues');
+        return '';
+    }
+    const BOLD = '\x1b[1m';
+    const DIM = '\x1b[2m';
+    const NC = '\x1b[0m';
+    console.error('');
+    console.error(`${BOLD}  Open Milestones${NC}`);
+    console.error('');
+    console.error(`  ${BOLD}0${NC}  All issues (no milestone filter)`);
+    for (let i = 0; i < milestones.length; i++) {
+        const m = milestones[i];
+        const progress = m.openIssues + m.closedIssues > 0
+            ? `${m.closedIssues}/${m.openIssues + m.closedIssues} done`
+            : 'empty';
+        const due = m.dueOn ? ` · due ${m.dueOn.split('T')[0]}` : '';
+        console.error(`  ${BOLD}${i + 1}${NC}  ${m.title} ${DIM}(${m.openIssues} open, ${progress}${due})${NC}`);
+    }
+    console.error('');
+    const choice = await askChoice(`  Select milestone [0-${milestones.length}]: `, milestones.length);
+    if (choice <= 0) {
+        log.info('Processing all ready issues (no milestone filter)');
+        return '';
+    }
+    const selected = milestones[choice - 1];
+    log.success(`Milestone selected: ${selected.title} (${selected.openIssues} open issues)`);
+    return selected.title;
+}
+/**
+ * Run the main loop: poll for issues, process them, finalize session.
+ */
+export async function runCommand(options) {
+    // Build config from YAML + env + CLI flags
+    const overrides = {};
+    if (options.dryRun)
+        overrides.dryRun = true;
+    if (options.model)
+        overrides.model = options.model;
+    if (options.skipTests)
+        overrides.skipTests = true;
+    if (options.skipReview)
+        overrides.skipReview = true;
+    if (options.skipLearn)
+        overrides.skipLearn = true;
+    if (options.milestone)
+        overrides.milestone = options.milestone;
+    if (options.autoMerge)
+        overrides.autoMerge = true;
+    if (options.mergeTo)
+        overrides.mergeTo = options.mergeTo;
+    if (options.verbose)
+        overrides.verbose = true;
+    const config = loadConfig(overrides);
+    if (!config.repo) {
+        log.error('No repository configured. Run "alpha-loop init" or set repo in .alpha-loop.yaml');
+        process.exit(1);
+    }
+    // Create session
+    const session = createSession(config);
+    // Print startup banner
+    printBanner(config, session);
+    // Check prerequisites
+    checkPrerequisites();
+    // Track active worktree for cleanup on signal
+    let activeIssueNum = null;
+    // Handle Ctrl+C gracefully
+    const cleanup = async () => {
+        log.info('');
+        log.info('Shutting down...');
+        // Clean up active worktree if any
+        if (activeIssueNum !== null) {
+            log.info(`Cleaning up worktree for issue #${activeIssueNum}...`);
+            try {
+                await cleanupWorktree({
+                    issueNum: activeIssueNum,
+                    projectDir: process.cwd(),
+                    autoCleanup: true,
+                });
+            }
+            catch {
+                // Best effort cleanup
+            }
+        }
+        // Finalize session
+        try {
+            await finalizeSession(session, config);
+        }
+        catch (err) {
+            log.error(`Session finalization failed: ${err instanceof Error ? err.message : err}`);
+        }
+        const issueCount = session.results.length;
+        const successCount = session.results.filter((r) => r.status === 'success').length;
+        log.info(`Session complete: ${successCount}/${issueCount} issues succeeded`);
+        process.exit(0);
+    };
+    process.on('SIGINT', () => { void cleanup(); });
+    process.on('SIGTERM', () => { void cleanup(); });
+    // Sync agent assets (AGENTS.md → CLAUDE.md, skills/ → .agents/skills/ + .claude/skills/)
+    const syncResult = syncAgentAssets();
+    if (syncResult.synced) {
+        log.success('Agent assets synced before run');
+    }
+    // Milestone selection (interactive or from config/CLI flag)
+    let activeMilestone = config.milestone;
+    if (!activeMilestone && !config.dryRun && process.stdin.isTTY) {
+        activeMilestone = await pickMilestone(config.repo);
+    }
+    if (activeMilestone) {
+        log.info(`Filtering issues by milestone: ${activeMilestone}`);
+    }
+    // Pre-flight port check
+    if (config.port) {
+        log.step('Checking for port conflicts...');
+        runPortCheck(config.port);
+    }
+    // Pre-flight test validation
+    log.step('Running pre-flight test validation...');
+    const preflightResult = await runPreflight({
+        testCommand: config.testCommand,
+        skipPreflight: config.skipPreflight,
+        skipTests: config.skipTests,
+        dryRun: config.dryRun,
+    });
+    if (preflightResult.passed) {
+        if (!config.skipPreflight && !config.skipTests && !config.dryRun) {
+            log.success('Pre-flight tests passed');
+        }
+    }
+    else {
+        log.warn(`Pre-flight: ${preflightResult.preExistingFailures.length} pre-existing failure(s) will be ignored`);
+        for (const f of preflightResult.preExistingFailures) {
+            log.warn(`  ${f}`);
+        }
+    }
+    // Prompt for project vision if it doesn't exist (interactive only)
+    if (!hasVision() && process.stdin.isTTY) {
+        log.warn('No project vision found. The agent will make better decisions with one.');
+        const answer = await askYesNo('Set up project vision now? [Y/n]: ');
+        if (answer) {
+            const { visionCommand } = await import('./vision.js');
+            await visionCommand();
+        }
+    }
+    // Generate or refresh project context if needed
+    if (contextNeedsRefresh()) {
+        log.info('Project context is stale or missing. Generating...');
+        const { scanCommand } = await import('./scan.js');
+        scanCommand();
+    }
+    else {
+        log.info('Project context is fresh');
+    }
+    // If vision or context were created/updated, commit them so worktrees get them
+    if (!config.dryRun) {
+        const statusResult = exec('git status --porcelain .alpha-loop/ AGENTS.md CLAUDE.md');
+        if (statusResult.stdout.trim()) {
+            log.info('New files generated — committing so worktrees include them...');
+            exec('git add .alpha-loop/ AGENTS.md CLAUDE.md 2>/dev/null || true');
+            const diffCheck = exec('git diff --cached --quiet');
+            if (diffCheck.exitCode !== 0) {
+                exec('git commit -m "chore: add project vision and context for alpha-loop"');
+                exec(`git push origin "${config.baseBranch}"`);
+                log.success('Vision and context committed to ' + config.baseBranch);
+            }
+        }
+    }
+    // Fetch all matching issues
+    const milestoneMsg = activeMilestone ? ` in milestone '${activeMilestone}'` : '';
+    log.info(`Fetching issues${milestoneMsg}...`);
+    const issues = pollIssues(config.repo, config.labelReady, 100, {
+        project: config.project,
+        repoOwner: config.repoOwner,
+        milestone: activeMilestone || undefined,
+    });
+    if (issues.length === 0) {
+        log.info('No issues found. Nothing to do.');
+    }
+    else {
+        const issueLimit = config.maxIssues > 0 ? Math.min(issues.length, config.maxIssues) : issues.length;
+        const issuesToProcess = issues.slice(0, issueLimit);
+        if (config.maxIssues > 0 && issues.length > config.maxIssues) {
+            log.info(`Found ${issues.length} issue(s), processing first ${issueLimit} (max_issues=${config.maxIssues})`);
+        }
+        else {
+            log.info(`Found ${issuesToProcess.length} issue(s) to process`);
+        }
+        const sessionStartTime = Date.now();
+        for (const issue of issuesToProcess) {
+            // Check duration limit before each issue
+            if (config.maxSessionDuration > 0) {
+                const elapsed = Math.round((Date.now() - sessionStartTime) / 1000);
+                if (elapsed >= config.maxSessionDuration) {
+                    log.info(`Stopping: max_session_duration reached (${elapsed}s / ${config.maxSessionDuration}s)`);
+                    break;
+                }
+            }
+            log.info('==========================================');
+            log.info(`Processing issue #${issue.number}: ${issue.title}`);
+            log.info('==========================================');
+            activeIssueNum = issue.number;
+            try {
+                const result = await processIssue(issue.number, issue.title, issue.body, config, session);
+                session.results.push(result);
+            }
+            catch (err) {
+                log.error(`Failed to process issue #${issue.number}: ${err}`);
+            }
+            activeIssueNum = null;
+        }
+    }
+    // Generate session summary (aggregates learnings across all issues)
+    if (session.results.length > 0) {
+        const learningsDir = join(process.cwd(), '.alpha-loop', 'learnings');
+        await generateSessionSummary({
+            sessionName: session.name,
+            results: session.results,
+            learningsDir,
+            config,
+        });
+    }
+    // Finalize session
+    await finalizeSession(session, config);
+    const successCount = session.results.filter((r) => r.status === 'success').length;
+    log.info(`Session complete: ${successCount}/${session.results.length} issues succeeded`);
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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

package/dist/commands/scan.d.ts

@@ -0,0 +1 @@
+export declare function scanCommand(): void;

package/dist/commands/scan.js

@@ -0,0 +1,50 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { exec } from '../lib/shell.js';
+import { log } from '../lib/logger.js';
+import { assertSafeShellArg, loadConfig } from '../lib/config.js';
+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.`;
+export function scanCommand() {
+    const projectDir = process.cwd();
+    const contextDir = path.join(projectDir, '.alpha-loop');
+    const contextFile = path.join(contextDir, 'context.md');
+    const config = loadConfig();
+    fs.mkdirSync(contextDir, { recursive: true });
+    log.step('Scanning codebase for project context...');
+    const model = assertSafeShellArg(config.model ?? 'opus', 'model');
+    const result = exec(`echo ${JSON.stringify(SCAN_PROMPT)} | claude -p --model ${model} --dangerously-skip-permissions --output-format text 2>/dev/null`, { cwd: projectDir });
+    if (result.exitCode === 0 && result.stdout) {
+        fs.writeFileSync(contextFile, result.stdout + '\n');
+        log.success(`Project context saved to ${contextFile}`);
+    }
+    else if (result.stdout) {
+        fs.writeFileSync(contextFile, result.stdout + '\n');
+        log.warn('Claude exited with errors but produced output');
+        log.success(`Project context saved to ${contextFile}`);
+    }
+    else {
+        log.error(`Project context generation failed: ${result.stderr || 'empty output'}`);
+    }
+}
+//# sourceMappingURL=scan.js.map

package/dist/commands/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../src/commands/scan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAElE,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;iHAqB6F,CAAC;AAElH,MAAM,UAAU,WAAW;IACzB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IACxD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9C,GAAG,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IAErD,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,EAAE,OAAO,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,IAAI,CACjB,QAAQ,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,wBAAwB,KAAK,kEAAkE,EAClI,EAAE,GAAG,EAAE,UAAU,EAAE,CACpB,CAAC;IAEF,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAC3C,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QACpD,GAAG,CAAC,OAAO,CAAC,4BAA4B,WAAW,EAAE,CAAC,CAAC;IACzD,CAAC;SAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACzB,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAC1D,GAAG,CAAC,OAAO,CAAC,4BAA4B,WAAW,EAAE,CAAC,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,KAAK,CAAC,sCAAsC,MAAM,CAAC,MAAM,IAAI,cAAc,EAAE,CAAC,CAAC;IACrF,CAAC;AACH,CAAC"}

package/dist/commands/sync.d.ts

@@ -0,0 +1,20 @@
+export type SyncResult = {
+    synced: boolean;
+    docSynced: boolean;
+    skillsDirs: string[];
+};
+/**
+ * Sync agent assets: AGENTS.md → CLAUDE.md, skills/ → .agents/skills/ + .claude/skills/
+ *
+ * Returns what was synced. If check=true, only reports drift without writing.
+ */
+export declare function syncAgentAssets(options?: {
+    check?: boolean;
+    projectDir?: string;
+}): SyncResult;
+/**
+ * CLI command handler for `alpha-loop sync`.
+ */
+export declare function syncCommand(options?: {
+    check?: boolean;
+}): void;

package/dist/commands/sync.js

@@ -0,0 +1,149 @@
+/**
+ * Sync Command — keep agent docs and skills in sync across CLI tool formats.
+ *
+ * Source of truth:
+ *   - AGENTS.md       → copied to CLAUDE.md
+ *   - skills/         → copied to .agents/skills/ and .claude/skills/
+ *
+ * This ensures both Claude and Codex (and any future agent) can find
+ * the same instructions and skills in their native locations.
+ */
+import { existsSync, copyFileSync, mkdirSync, readdirSync, statSync, readFileSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { log } from '../lib/logger.js';
+const SOURCE_DOC = 'AGENTS.md';
+const TARGET_DOC = 'CLAUDE.md';
+const SOURCE_SKILLS = 'skills';
+const TARGET_SKILL_DIRS = ['.agents/skills', '.claude/skills'];
+/**
+ * Recursively copy a directory, deleting files in target that don't exist in source.
+ */
+function syncDir(src, dest) {
+    mkdirSync(dest, { recursive: true });
+    const srcEntries = new Set(readdirSync(src));
+    // Delete files in dest that don't exist in src
+    if (existsSync(dest)) {
+        for (const entry of readdirSync(dest)) {
+            if (!srcEntries.has(entry)) {
+                const destPath = join(dest, entry);
+                rmSync(destPath, { recursive: true, force: true });
+            }
+        }
+    }
+    // Copy from src to dest
+    for (const entry of srcEntries) {
+        const srcPath = join(src, entry);
+        const destPath = join(dest, entry);
+        const stat = statSync(srcPath);
+        if (stat.isDirectory()) {
+            syncDir(srcPath, destPath);
+        }
+        else {
+            copyFileSync(srcPath, destPath);
+        }
+    }
+}
+/**
+ * Check if two files have identical content.
+ */
+function filesMatch(a, b) {
+    if (!existsSync(a) || !existsSync(b))
+        return false;
+    return readFileSync(a).equals(readFileSync(b));
+}
+/**
+ * Recursively check if two directories have identical content.
+ */
+function dirsMatch(src, dest) {
+    if (!existsSync(src) || !existsSync(dest))
+        return false;
+    const srcEntries = readdirSync(src).sort();
+    const destEntries = readdirSync(dest).sort();
+    if (srcEntries.length !== destEntries.length)
+        return false;
+    if (srcEntries.join(',') !== destEntries.join(','))
+        return false;
+    for (const entry of srcEntries) {
+        const srcPath = join(src, entry);
+        const destPath = join(dest, entry);
+        const stat = statSync(srcPath);
+        if (stat.isDirectory()) {
+            if (!dirsMatch(srcPath, destPath))
+                return false;
+        }
+        else {
+            if (!filesMatch(srcPath, destPath))
+                return false;
+        }
+    }
+    return true;
+}
+/**
+ * Sync agent assets: AGENTS.md → CLAUDE.md, skills/ → .agents/skills/ + .claude/skills/
+ *
+ * Returns what was synced. If check=true, only reports drift without writing.
+ */
+export function syncAgentAssets(options = {}) {
+    const { check = false, projectDir = process.cwd() } = options;
+    const sourceDoc = join(projectDir, SOURCE_DOC);
+    const targetDoc = join(projectDir, TARGET_DOC);
+    const sourceSkills = join(projectDir, SOURCE_SKILLS);
+    const result = { synced: false, docSynced: false, skillsDirs: [] };
+    // Sync AGENTS.md → CLAUDE.md
+    if (existsSync(sourceDoc)) {
+        if (!filesMatch(sourceDoc, targetDoc)) {
+            if (check) {
+                log.warn(`Drift: ${TARGET_DOC} differs from ${SOURCE_DOC}`);
+            }
+            else {
+                copyFileSync(sourceDoc, targetDoc);
+                log.info(`Synced ${SOURCE_DOC} → ${TARGET_DOC}`);
+            }
+            result.docSynced = true;
+            result.synced = true;
+        }
+    }
+    // Sync skills/ → target dirs
+    if (existsSync(sourceSkills)) {
+        for (const targetDir of TARGET_SKILL_DIRS) {
+            const targetPath = join(projectDir, targetDir);
+            if (!dirsMatch(sourceSkills, targetPath)) {
+                if (check) {
+                    log.warn(`Drift: ${targetDir} differs from ${SOURCE_SKILLS}/`);
+                }
+                else {
+                    syncDir(sourceSkills, targetPath);
+                    log.info(`Synced ${SOURCE_SKILLS}/ → ${targetDir}/`);
+                }
+                result.skillsDirs.push(targetDir);
+                result.synced = true;
+            }
+        }
+    }
+    return result;
+}
+/**
+ * CLI command handler for `alpha-loop sync`.
+ */
+export function syncCommand(options = {}) {
+    const projectDir = process.cwd();
+    const sourceDoc = join(projectDir, SOURCE_DOC);
+    const sourceSkills = join(projectDir, SOURCE_SKILLS);
+    if (!existsSync(sourceDoc) && !existsSync(sourceSkills)) {
+        log.warn(`No ${SOURCE_DOC} or ${SOURCE_SKILLS}/ found. Nothing to sync.`);
+        log.info(`Create ${SOURCE_DOC} (agent instructions) and/or ${SOURCE_SKILLS}/ (skill definitions) first.`);
+        return;
+    }
+    const result = syncAgentAssets({ check: options.check, projectDir });
+    if (!result.synced) {
+        log.success('Agent assets are in sync.');
+    }
+    else if (options.check) {
+        log.error('Drift detected. Run "alpha-loop sync" to resolve.');
+        process.exit(1);
+    }
+    else {
+        log.success('Agent assets synced.');
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

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

package/dist/commands/vision.d.ts

@@ -0,0 +1 @@
+export declare function visionCommand(): Promise<void>;