@bradtaylorsf/alpha-loop 1.0.0

package/dist/commands/history.js

@@ -0,0 +1,185 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import YAML from 'yaml';
+import { log } from '../lib/logger.js';
+function formatDuration(seconds) {
+    if (!seconds || seconds <= 0)
+        return '';
+    const mins = Math.floor(seconds / 60);
+    const secs = seconds % 60;
+    if (mins > 0) {
+        return `${mins}m ${String(secs).padStart(2, '0')}s`;
+    }
+    return `${secs}s`;
+}
+function loadSession(yamlPath) {
+    try {
+        const raw = fs.readFileSync(yamlPath, 'utf-8');
+        return YAML.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export function historyList(sessionsDir) {
+    if (!fs.existsSync(sessionsDir)) {
+        console.log('No sessions found.');
+        return;
+    }
+    const entries = fs.readdirSync(sessionsDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory())
+        .map((d) => {
+        const yamlPath = path.join(sessionsDir, d.name, 'session.yaml');
+        if (!fs.existsSync(yamlPath))
+            return null;
+        return { dir: d.name, session: loadSession(yamlPath) };
+    })
+        .filter((e) => e !== null && e.session !== null);
+    if (entries.length === 0) {
+        console.log('No sessions found.');
+        return;
+    }
+    // Sort by date descending
+    entries.sort((a, b) => {
+        const da = a.session.started ?? '';
+        const db = b.session.started ?? '';
+        return db.localeCompare(da);
+    });
+    console.log('Sessions:');
+    for (const { session } of entries) {
+        const name = session.name ?? 'unknown';
+        const date = (session.started ?? '????-??-??').slice(0, 10);
+        const issues = session.issues ?? [];
+        const issueCount = issues.length;
+        const successCount = issues.filter((i) => i.status === 'success').length;
+        const failedCount = issues.filter((i) => i.status === 'failed').length;
+        const durStr = formatDuration(session.duration);
+        const issueWord = issueCount === 1 ? 'issue' : 'issues';
+        let statusParts = '';
+        if (successCount > 0)
+            statusParts += `${successCount} \u2713`;
+        if (failedCount > 0)
+            statusParts += ` ${failedCount} \u2717`;
+        console.log(`  ${name.padEnd(30)} ${date}  ${issueCount} ${issueWord.padEnd(7)} ${statusParts.padEnd(10)} ${durStr}`);
+    }
+}
+export function historyDetail(sessionsDir, sessionName) {
+    const yamlPath = path.join(sessionsDir, sessionName, 'session.yaml');
+    if (!fs.existsSync(yamlPath)) {
+        log.error(`Session not found: ${sessionName}`);
+        process.exitCode = 1;
+        return;
+    }
+    const session = loadSession(yamlPath);
+    if (!session) {
+        log.error(`Could not parse session: ${sessionName}`);
+        process.exitCode = 1;
+        return;
+    }
+    const dateDisplay = session.started
+        ? `${session.started.slice(0, 10)} ${session.started.slice(11, 16)}`
+        : '????-??-??';
+    const durStr = formatDuration(session.duration);
+    console.log(`Session: ${session.name ?? sessionName}`);
+    console.log(`Date:    ${dateDisplay}`);
+    if (session.repo)
+        console.log(`Repo:    ${session.repo}`);
+    if (session.model)
+        console.log(`Model:   ${session.model}`);
+    console.log(`Duration: ${durStr}`);
+    console.log('');
+    console.log('Issues:');
+    for (const issue of session.issues ?? []) {
+        let symbol;
+        let statusText;
+        switch (issue.status) {
+            case 'success':
+                symbol = '\u2713';
+                if (issue.pr_url) {
+                    const prNum = issue.pr_url.match(/(\d+)$/)?.[1] ?? '';
+                    statusText = `PR #${prNum}`;
+                }
+                else {
+                    statusText = 'SUCCESS';
+                }
+                break;
+            case 'failed':
+                symbol = '\u2717';
+                statusText = 'FAILED';
+                break;
+            default:
+                symbol = '\u2298';
+                statusText = 'SKIPPED';
+                break;
+        }
+        const issueDur = formatDuration(issue.duration);
+        let line = `  ${symbol} #${String(issue.number).padEnd(4)} ${statusText.padEnd(9)} (${issueDur})`;
+        if (issue.error) {
+            line += ` \u2014 ${issue.error}`;
+        }
+        console.log(line);
+    }
+    console.log('');
+    console.log(`QA Checklist: .alpha-loop/sessions/${sessionName}/qa-checklist.md`);
+    console.log(`Logs:         .alpha-loop/sessions/${sessionName}/logs/`);
+}
+export function historyQa(sessionsDir, sessionName) {
+    const qaPath = path.join(sessionsDir, sessionName, 'qa-checklist.md');
+    if (!fs.existsSync(qaPath)) {
+        log.error(`QA checklist not found for session: ${sessionName}`);
+        process.exitCode = 1;
+        return;
+    }
+    console.log(fs.readFileSync(qaPath, 'utf-8'));
+}
+export function historyClean(sessionsDir) {
+    if (!fs.existsSync(sessionsDir)) {
+        console.log('No sessions found.');
+        return;
+    }
+    const RETENTION_DAYS = 30;
+    const cutoff = Date.now() - RETENTION_DAYS * 24 * 60 * 60 * 1000;
+    let removed = 0;
+    const entries = fs.readdirSync(sessionsDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory());
+    for (const entry of entries) {
+        const yamlPath = path.join(sessionsDir, entry.name, 'session.yaml');
+        if (!fs.existsSync(yamlPath))
+            continue;
+        const session = loadSession(yamlPath);
+        if (!session?.started)
+            continue;
+        const sessionDate = new Date(session.started).getTime();
+        if (isNaN(sessionDate))
+            continue;
+        if (sessionDate < cutoff) {
+            fs.rmSync(path.join(sessionsDir, entry.name), { recursive: true });
+            console.log(`Removed: ${session.name ?? entry.name}`);
+            removed++;
+        }
+    }
+    if (removed === 0) {
+        console.log('No sessions older than 30 days found.');
+    }
+    else {
+        console.log(`Removed ${removed} session(s).`);
+    }
+}
+export function historyCommand(session, options) {
+    const sessionsDir = path.join(process.cwd(), '.alpha-loop', 'sessions');
+    if (options.clean) {
+        historyClean(sessionsDir);
+        return;
+    }
+    if (session) {
+        if (options.qa) {
+            historyQa(sessionsDir, session);
+        }
+        else {
+            historyDetail(sessionsDir, session);
+        }
+        return;
+    }
+    historyList(sessionsDir);
+}
+//# sourceMappingURL=history.js.map

package/dist/commands/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/commands/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAmBvC,SAAS,cAAc,CAAC,OAA2B;IACjD,IAAI,CAAC,OAAO,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,OAAO,GAAG,EAAE,CAAC;IAC1B,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;IACtD,CAAC;IACD,OAAO,GAAG,IAAI,GAAG,CAAC;AACpB,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC7C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACjE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAChE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;IACzD,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAA8C,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;IAE/F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO;IACT,CAAC;IAED,0BAA0B;IAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACpB,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACnC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACnC,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACzB,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,OAAO,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;QACvC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;QACjC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;QACzE,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;QACvE,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;QAExD,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,IAAI,YAAY,GAAG,CAAC;YAAE,WAAW,IAAI,GAAG,YAAY,SAAS,CAAC;QAC9D,IAAI,WAAW,GAAG,CAAC;YAAE,WAAW,IAAI,IAAI,WAAW,SAAS,CAAC;QAE7D,OAAO,CAAC,GAAG,CACT,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,IAAI,KAAK,UAAU,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,EAAE,CACzG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,WAAmB,EAAE,WAAmB;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;IACrE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,KAAK,CAAC,sBAAsB,WAAW,EAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,GAAG,CAAC,KAAK,CAAC,4BAA4B,WAAW,EAAE,CAAC,CAAC;QACrD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO;QACjC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE;QACpE,CAAC,CAAC,YAAY,CAAC;IACjB,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEhD,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,YAAY,WAAW,EAAE,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,IAAI;QAAE,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1D,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACzC,IAAI,MAAc,CAAC;QACnB,IAAI,UAAkB,CAAC;QAEvB,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;YACrB,KAAK,SAAS;gBACZ,MAAM,GAAG,QAAQ,CAAC;gBAClB,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;oBACjB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBACtD,UAAU,GAAG,OAAO,KAAK,EAAE,CAAC;gBAC9B,CAAC;qBAAM,CAAC;oBACN,UAAU,GAAG,SAAS,CAAC;gBACzB,CAAC;gBACD,MAAM;YACR,KAAK,QAAQ;gBACX,MAAM,GAAG,QAAQ,CAAC;gBAClB,UAAU,GAAG,QAAQ,CAAC;gBACtB,MAAM;YACR;gBACE,MAAM,GAAG,QAAQ,CAAC;gBAClB,UAAU,GAAG,SAAS,CAAC;gBACvB,MAAM;QACV,CAAC;QAED,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,IAAI,GAAG,KAAK,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,GAAG,CAAC;QAClG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,IAAI,WAAW,KAAK,CAAC,KAAK,EAAE,CAAC;QACnC,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,sCAAsC,WAAW,kBAAkB,CAAC,CAAC;IACjF,OAAO,CAAC,GAAG,CAAC,sCAAsC,WAAW,QAAQ,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,WAAmB,EAAE,WAAmB;IAChE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;IACtE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,KAAK,CAAC,uCAAuC,WAAW,EAAE,CAAC,CAAC;QAChE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO;IACT,CAAC;IAED,MAAM,cAAc,GAAG,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACjE,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACjE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAElC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACpE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,SAAS;QAEvC,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO,EAAE,OAAO;YAAE,SAAS;QAEhC,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;QACxD,IAAI,KAAK,CAAC,WAAW,CAAC;YAAE,SAAS;QAEjC,IAAI,WAAW,GAAG,MAAM,EAAE,CAAC;YACzB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACnE,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACtD,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;IACvD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,cAAc,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAA2B,EAC3B,OAA0C;IAE1C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;IAExE,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,YAAY,CAAC,WAAW,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;YACf,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,OAAO;IACT,CAAC;IAED,WAAW,CAAC,WAAW,CAAC,CAAC;AAC3B,CAAC"}

package/dist/commands/init.d.ts

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

package/dist/commands/init.js

@@ -0,0 +1,241 @@
+import { existsSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { detectRepo } from '../lib/config.js';
+import { exec } from '../lib/shell.js';
+import { log } from '../lib/logger.js';
+import { syncAgentAssets } from './sync.js';
+/**
+ * Find the templates directory shipped with alpha-loop.
+ * Works whether running from src/ (tsx) or dist/ (compiled) or as an npm package.
+ */
+function findTemplatesDir() {
+    // Walk up from this file's location to find the alpha-loop package root.
+    // src/commands/init.ts -> src/ -> package root (has templates/)
+    // dist/commands/init.js -> dist/ -> package root (has templates/)
+    const scriptDir = typeof __dirname !== 'undefined' ? __dirname : '';
+    const candidates = [];
+    // Walk up from script location
+    if (scriptDir) {
+        let dir = scriptDir;
+        for (let i = 0; i < 5; i++) {
+            candidates.push(join(dir, 'templates'));
+            const parent = join(dir, '..');
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    // Also check relative to the entry script (process.argv[1])
+    // e.g., npx tsx /path/to/alpha-loop/src/cli.ts → /path/to/alpha-loop/templates
+    if (process.argv[1]) {
+        let dir = join(process.argv[1], '..');
+        for (let i = 0; i < 5; i++) {
+            candidates.push(join(dir, 'templates'));
+            const parent = join(dir, '..');
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    return null;
+}
+const CONFIG_FILE = '.alpha-loop.yaml';
+const ISSUE_TEMPLATE = `name: Agent-Ready Task
+description: A well-structured task for the automated agent loop to implement
+title: ""
+labels: ["ready"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        This template creates issues that the automated agent loop can pick up and implement.
+        Be specific -- the agent will use these fields to plan, implement, and verify.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Clear description of what needs to be done
+      placeholder: Describe the change, feature, or fix...
+    validations:
+      required: true
+
+  - type: textarea
+    id: acceptance-criteria
+    attributes:
+      label: Acceptance Criteria
+      description: Specific, testable criteria that define "done"
+      placeholder: |
+        - [ ] Criterion 1
+        - [ ] Criterion 2
+        - [ ] Criterion 3
+    validations:
+      required: true
+
+  - type: textarea
+    id: test-requirements
+    attributes:
+      label: Test Requirements
+      description: What tests should be written or updated?
+      placeholder: |
+        - Unit tests for...
+        - E2E test for...
+
+  - type: textarea
+    id: affected-files
+    attributes:
+      label: Affected Files/Areas
+      description: Known files or areas of the codebase that will be touched
+      placeholder: |
+        - src/...
+        - tests/...
+
+  - type: dropdown
+    id: complexity
+    attributes:
+      label: Complexity
+      options:
+        - trivial (< 30 min)
+        - small (1-2 hours)
+        - medium (half day)
+        - large (full day)
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: Any background, constraints, or references the agent should know
+`;
+function configTemplate(repo) {
+    return `# Alpha Loop configuration
+repo: ${repo}
+model: opus
+review_model: opus
+label: ready
+base_branch: main
+test_command: pnpm test
+dev_command: pnpm dev
+port: 3000
+auto_merge: true
+
+# Safety limits (0 = unlimited)
+max_issues: 20
+max_session_duration: 7200  # 2 hours in seconds
+`;
+}
+/**
+ * Copy a directory recursively using the shell (simple and reliable).
+ */
+function copyDir(src, dest) {
+    mkdirSync(dest, { recursive: true });
+    exec(`cp -R "${src}/"* "${dest}/" 2>/dev/null || true`);
+}
+export function initCommand() {
+    // Create config if it doesn't exist
+    if (existsSync(CONFIG_FILE)) {
+        log.info(`${CONFIG_FILE} already exists — skipping config creation`);
+    }
+    else {
+        let repo = detectRepo();
+        if (repo) {
+            log.success(`Auto-detected repo: ${repo}`);
+        }
+        else {
+            repo = 'owner/repo';
+            log.warn('Could not auto-detect repo from git remote. Using placeholder.');
+        }
+        writeFileSync(CONFIG_FILE, configTemplate(repo));
+        log.success(`Created ${CONFIG_FILE}`);
+    }
+    // Everything below is idempotent — safe to re-run
+    // Install playwright-cli skills if playwright-cli is available
+    const which = exec('which playwright-cli');
+    if (which.exitCode === 0) {
+        log.info('Installing playwright-cli skills...');
+        const result = exec('playwright-cli install --skills');
+        if (result.exitCode === 0) {
+            log.success('Playwright CLI skills installed');
+            // playwright-cli installs to .claude/skills/ only.
+            // Copy to skills/ (source of truth) so our sync propagates to .agents/skills/ too.
+            const installed = join('.claude', 'skills', 'playwright-cli');
+            const sourceOfTruth = join('skills', 'playwright-cli');
+            if (existsSync(installed) && !existsSync(sourceOfTruth)) {
+                mkdirSync('skills', { recursive: true });
+                copyDir(installed, sourceOfTruth);
+                log.info('Copied playwright-cli skill to skills/ (source of truth)');
+            }
+        }
+        else {
+            log.warn('Could not install playwright-cli skills');
+        }
+    }
+    else {
+        log.info('playwright-cli not found — skipping skill install. Install with: npm install -g @playwright/cli@latest');
+    }
+    // Install base skills and agents from alpha-loop's templates
+    // These are the universal skills every project needs for the loop to work well
+    const templatesDir = findTemplatesDir();
+    if (templatesDir) {
+        // Install skills to skills/ (source of truth)
+        const templateSkills = join(templatesDir, 'skills');
+        if (existsSync(templateSkills)) {
+            const skillNames = exec(`ls "${templateSkills}"`).stdout.trim().split('\n').filter(Boolean);
+            let installed = 0;
+            for (const name of skillNames) {
+                const dest = join('skills', name);
+                if (!existsSync(dest)) {
+                    mkdirSync('skills', { recursive: true });
+                    copyDir(join(templateSkills, name), dest);
+                    installed++;
+                }
+            }
+            if (installed > 0) {
+                log.success(`Installed ${installed} base skill(s): ${skillNames.filter(n => !existsSync(join('skills', n)) || installed > 0).join(', ')}`);
+            }
+        }
+        // Install agents to agents/ (will be synced by AGENTS.md convention)
+        // Also install directly to .claude/agents/ and .codex/agents/ for immediate use
+        const templateAgents = join(templatesDir, 'agents');
+        if (existsSync(templateAgents)) {
+            const agentFiles = exec(`ls "${templateAgents}"`).stdout.trim().split('\n').filter(Boolean);
+            for (const file of agentFiles) {
+                // .claude/agents/ for Claude
+                const claudeDest = join('.claude', 'agents', file);
+                if (!existsSync(claudeDest)) {
+                    mkdirSync(join('.claude', 'agents'), { recursive: true });
+                    exec(`cp "${join(templateAgents, file)}" "${claudeDest}"`);
+                }
+                // .codex/agents/ for Codex (TOML format would be different, but .md works as fallback)
+                const codexDest = join('.codex', 'agents', file);
+                if (!existsSync(codexDest)) {
+                    mkdirSync(join('.codex', 'agents'), { recursive: true });
+                    exec(`cp "${join(templateAgents, file)}" "${codexDest}"`);
+                }
+            }
+            log.success(`Installed agent definitions: ${agentFiles.join(', ')}`);
+        }
+    }
+    else {
+        log.warn('Templates directory not found — skipping base skills/agents install');
+    }
+    // Install GitHub issue template for structured agent-ready issues
+    const templateDir = join('.github', 'ISSUE_TEMPLATE');
+    const templateFile = join(templateDir, 'agent-ready.yml');
+    if (!existsSync(templateFile)) {
+        mkdirSync(templateDir, { recursive: true });
+        writeFileSync(templateFile, ISSUE_TEMPLATE);
+        log.success('Created GitHub issue template: .github/ISSUE_TEMPLATE/agent-ready.yml');
+    }
+    // Sync agent assets so skills land in both .claude/skills/ and .agents/skills/
+    const syncResult = syncAgentAssets();
+    if (syncResult.synced) {
+        log.success('Agent assets synced across .claude/ and .agents/');
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/run.d.ts

@@ -0,0 +1,15 @@
+export type RunOptions = {
+    dryRun?: boolean;
+    model?: string;
+    milestone?: string;
+    skipTests?: boolean;
+    skipReview?: boolean;
+    skipLearn?: boolean;
+    autoMerge?: boolean;
+    mergeTo?: string;
+    verbose?: boolean;
+};
+/**
+ * Run the main loop: poll for issues, process them, finalize session.
+ */
+export declare function runCommand(options: RunOptions): Promise<void>;