@thynameisjayvee/alpha-cli 0.1.0

package/dist/core/stack/index.js

@@ -0,0 +1,243 @@
+#!/usr/bin/env node
+import { logger, emit } from '../../utils/logger.js';
+import { writeFile, ensureDir, readJsonFile } from '../../utils/file-system.js';
+import { getAlphaDir } from '../../utils/paths.js';
+import { readInputJson } from '../../utils/input.js';
+/**
+ * Reference stack templates. These are *not* an automatic decision — they are
+ * candidate data the calling LLM (or human) can choose from or ignore entirely.
+ */
+const STACK_TEMPLATES = {
+    'fullstack-nextjs': {
+        stack: {
+            frontend: ['Next.js 14', 'React', 'TypeScript', 'Tailwind CSS'],
+            backend: ['Next.js API Routes', 'Server Actions'],
+            database: ['PostgreSQL', 'Prisma ORM'],
+            infrastructure: ['Vercel'],
+            tools: ['Turborepo', 'ESLint', 'Prettier'],
+        },
+        pros: [
+            'Excellent developer experience',
+            'Great for content-heavy sites',
+            'Built-in SSR and SSG',
+            'Zero config deployment on Vercel',
+        ],
+        cons: [
+            'Vendor lock-in with Vercel',
+            'Limited backend complexity support',
+            'Cold starts on serverless',
+        ],
+        rationale: 'Best for marketing sites, blogs, and content-driven applications',
+        confidence: 0.85,
+    },
+    'enterprise-nestjs': {
+        stack: {
+            frontend: ['React', 'TypeScript', 'Tailwind CSS', 'shadcn/ui'],
+            backend: ['NestJS', 'TypeScript', 'Node.js'],
+            database: ['PostgreSQL', 'Prisma ORM'],
+            infrastructure: ['Docker', 'Kubernetes', 'AWS/GCP'],
+            tools: ['Jest', 'ESLint', 'Prettier', 'Husky'],
+        },
+        pros: [
+            'Enterprise-grade architecture',
+            'Strong typing end-to-end',
+            'Scalable microservices-ready',
+            'Rich ecosystem',
+        ],
+        cons: [
+            'Steeper learning curve',
+            'More boilerplate',
+            'Requires infrastructure management',
+        ],
+        rationale: 'Ideal for complex enterprise applications with multiple teams',
+        confidence: 0.9,
+    },
+    'rapid-prototype': {
+        stack: {
+            frontend: ['Vue 3', 'Nuxt UI', 'Tailwind CSS'],
+            backend: ['Hono', 'Bun'],
+            database: ['SQLite', 'Drizzle ORM'],
+            infrastructure: ['Railway', 'Render'],
+            tools: ['Vite', 'ESLint'],
+        },
+        pros: [
+            'Extremely fast development',
+            'Minimal configuration',
+            'Low resource usage',
+            'Great for MVPs',
+        ],
+        cons: [
+            'Smaller ecosystem',
+            'May need to migrate for scale',
+            'Limited enterprise patterns',
+        ],
+        rationale: 'Perfect for rapid prototyping and MVP development',
+        confidence: 0.8,
+    },
+    'data-intensive': {
+        stack: {
+            frontend: ['React', 'TypeScript', 'TanStack Query', 'AG Grid'],
+            backend: ['FastAPI', 'Python'],
+            database: ['PostgreSQL', 'Redis', 'ClickHouse'],
+            infrastructure: ['Docker', 'AWS'],
+            tools: ['Pandas', 'NumPy', 'Celery'],
+        },
+        pros: [
+            'Excellent for data processing',
+            'Rich ML/AI ecosystem',
+            'High performance analytics',
+            'Scalable async processing',
+        ],
+        cons: [
+            'Python GIL limitations',
+            'Higher memory usage',
+            'More complex deployment',
+        ],
+        rationale: 'Optimized for data-heavy applications and analytics',
+        confidence: 0.88,
+    },
+    'tauri-desktop': {
+        stack: {
+            frontend: ['React', 'TypeScript', 'Tailwind CSS'],
+            backend: ['Tauri v2', 'Rust'],
+            database: ['SQLite', 'Dexie.js'],
+            infrastructure: ['AppImage', 'DMG', 'MSI'],
+            tools: ['Vite', 'ESLint', 'Prettier'],
+        },
+        pros: [
+            'Small bundle sizes',
+            'Native performance',
+            'Cross-platform support',
+            'Strong security model',
+        ],
+        cons: ['Rust learning curve', 'Limited mobile support', 'Younger ecosystem'],
+        rationale: 'Best for cross-platform desktop applications',
+        confidence: 0.87,
+    },
+};
+async function loadProjectContext() {
+    try {
+        const contextPath = `${getAlphaDir()}/project-context.json`;
+        return await readJsonFile(contextPath);
+    }
+    catch {
+        return null;
+    }
+}
+async function saveStackDecision(context, recommendation) {
+    const alphaDir = getAlphaDir();
+    await ensureDir(alphaDir);
+    if (context) {
+        const updatedContext = { ...context, techStack: recommendation.stack };
+        await writeFile(`${alphaDir}/project-context.json`, JSON.stringify(updatedContext, null, 2));
+    }
+    await writeFile(`${alphaDir}/tech-stack.json`, JSON.stringify(recommendation, null, 2));
+    logger.success('Tech stack decision saved!');
+}
+/**
+ * Normalise flexible input into a StackRecommendation. Accepts a full
+ * recommendation, a bare TechStack, or `{ template: "<key>" }`.
+ */
+function buildRecommendation(raw) {
+    if (raw.template && STACK_TEMPLATES[raw.template]) {
+        return STACK_TEMPLATES[raw.template];
+    }
+    const stack = raw.stack ? raw.stack : raw;
+    return {
+        stack: {
+            frontend: stack.frontend,
+            backend: stack.backend,
+            database: stack.database,
+            infrastructure: stack.infrastructure,
+            tools: stack.tools,
+        },
+        pros: Array.isArray(raw.pros) ? raw.pros : [],
+        cons: Array.isArray(raw.cons) ? raw.cons : [],
+        rationale: raw.rationale || 'Stack selected by caller',
+        confidence: typeof raw.confidence === 'number' ? raw.confidence : 1,
+    };
+}
+function renderTemplates(context) {
+    const lines = [
+        `# Tech Stack Selection`,
+        ``,
+    ];
+    if (context) {
+        lines.push(`Project: ${context.name}`, context.description ? `Description: ${context.description}` : '', ``);
+    }
+    else {
+        lines.push(`(No project context found — run \`alpha gather\` first for richer guidance.)`, ``);
+    }
+    lines.push(`Choose or adapt one of the reference stacks below, then submit your`, `decision:`, ``, '```bash', `alpha stack --input stack.json`, `# or: echo '{ "template": "enterprise-nestjs" }' | alpha stack --input -`, '```', ``, `Input may be a template key, a bare TechStack, or a full recommendation.`, ``, `## Reference stacks`, ``);
+    for (const [key, rec] of Object.entries(STACK_TEMPLATES)) {
+        lines.push(`### \`${key}\``, rec.rationale, '', `- Frontend: ${(rec.stack.frontend || []).join(', ')}`, `- Backend: ${(rec.stack.backend || []).join(', ')}`, `- Database: ${(rec.stack.database || []).join(', ')}`, ``);
+    }
+    return lines.filter((l) => l !== undefined).join('\n');
+}
+async function stackInteractive(context) {
+    const inquirer = (await import('inquirer')).default;
+    const chalk = (await import('chalk')).default;
+    const templateEntries = Object.entries(STACK_TEMPLATES);
+    const { selection } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'selection',
+            message: chalk.cyan('Which tech stack would you like to use?'),
+            choices: [
+                ...templateEntries.map(([key, rec]) => ({
+                    name: `${key} — ${rec.rationale}`,
+                    value: key,
+                })),
+                { name: 'Custom stack', value: '__custom__' },
+            ],
+        },
+    ]);
+    if (selection !== '__custom__') {
+        await saveStackDecision(context, STACK_TEMPLATES[selection]);
+        return STACK_TEMPLATES[selection];
+    }
+    const custom = await inquirer.prompt([
+        { type: 'input', name: 'frontend', message: chalk.cyan('Frontend (comma-separated):') },
+        { type: 'input', name: 'backend', message: chalk.cyan('Backend (comma-separated):') },
+        { type: 'input', name: 'database', message: chalk.cyan('Database (comma-separated):') },
+    ]);
+    const recommendation = buildRecommendation({
+        stack: {
+            frontend: custom.frontend.split(',').map((s) => s.trim()).filter(Boolean),
+            backend: custom.backend.split(',').map((s) => s.trim()).filter(Boolean),
+            database: custom.database.split(',').map((s) => s.trim()).filter(Boolean),
+        },
+        rationale: 'Custom stack based on user preferences',
+    });
+    await saveStackDecision(context, recommendation);
+    return recommendation;
+}
+export async function adviseStack(options = {}) {
+    try {
+        const context = await loadProjectContext();
+        const inputData = await readInputJson(options.input);
+        if (options.interactive) {
+            const recommendation = await stackInteractive(context);
+            emit('stack', recommendation);
+            return recommendation;
+        }
+        if (inputData) {
+            const recommendation = buildRecommendation(inputData);
+            await saveStackDecision(context, recommendation);
+            emit('stack', recommendation);
+            return recommendation;
+        }
+        emit('stack', { mode: 'templates', context, templates: STACK_TEMPLATES }, renderTemplates(context));
+        return null;
+    }
+    catch (error) {
+        logger.error(`Stack advice failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        process.exitCode = 1;
+        return null;
+    }
+}
+// CLI entry point
+if (process.argv[1]?.endsWith('advisor.ts')) {
+    adviseStack();
+}
+//# sourceMappingURL=index.js.map

package/dist/core/stack/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/stack/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAOrD;;;GAGG;AACH,MAAM,eAAe,GAAwC;IAC3D,kBAAkB,EAAE;QAClB,KAAK,EAAE;YACL,QAAQ,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,CAAC;YAC/D,OAAO,EAAE,CAAC,oBAAoB,EAAE,gBAAgB,CAAC;YACjD,QAAQ,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC;YACtC,cAAc,EAAE,CAAC,QAAQ,CAAC;YAC1B,KAAK,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC;SAC3C;QACD,IAAI,EAAE;YACJ,gCAAgC;YAChC,+BAA+B;YAC/B,sBAAsB;YACtB,kCAAkC;SACnC;QACD,IAAI,EAAE;YACJ,4BAA4B;YAC5B,oCAAoC;YACpC,2BAA2B;SAC5B;QACD,SAAS,EACP,kEAAkE;QACpE,UAAU,EAAE,IAAI;KACjB;IACD,mBAAmB,EAAE;QACnB,KAAK,EAAE;YACL,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,CAAC;YAC9D,OAAO,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAC;YAC5C,QAAQ,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC;YACtC,cAAc,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAC;YACnD,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC;SAC/C;QACD,IAAI,EAAE;YACJ,+BAA+B;YAC/B,0BAA0B;YAC1B,8BAA8B;YAC9B,gBAAgB;SACjB;QACD,IAAI,EAAE;YACJ,wBAAwB;YACxB,kBAAkB;YAClB,oCAAoC;SACrC;QACD,SAAS,EAAE,+DAA+D;QAC1E,UAAU,EAAE,GAAG;KAChB;IACD,iBAAiB,EAAE;QACjB,KAAK,EAAE;YACL,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC;YAC9C,OAAO,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;YACxB,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC;YACnC,cAAc,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;YACrC,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;SAC1B;QACD,IAAI,EAAE;YACJ,4BAA4B;YAC5B,uBAAuB;YACvB,oBAAoB;YACpB,gBAAgB;SACjB;QACD,IAAI,EAAE;YACJ,mBAAmB;YACnB,+BAA+B;YAC/B,6BAA6B;SAC9B;QACD,SAAS,EAAE,mDAAmD;QAC9D,UAAU,EAAE,GAAG;KAChB;IACD,gBAAgB,EAAE;QAChB,KAAK,EAAE;YACL,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,SAAS,CAAC;YAC9D,OAAO,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;YAC9B,QAAQ,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,YAAY,CAAC;YAC/C,cAAc,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;YACjC,KAAK,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC;SACrC;QACD,IAAI,EAAE;YACJ,+BAA+B;YAC/B,sBAAsB;YACtB,4BAA4B;YAC5B,2BAA2B;SAC5B;QACD,IAAI,EAAE;YACJ,wBAAwB;YACxB,qBAAqB;YACrB,yBAAyB;SAC1B;QACD,SAAS,EAAE,qDAAqD;QAChE,UAAU,EAAE,IAAI;KACjB;IACD,eAAe,EAAE;QACf,KAAK,EAAE;YACL,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,cAAc,CAAC;YACjD,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;YAC7B,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;YAChC,cAAc,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC;YAC1C,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC;SACtC;QACD,IAAI,EAAE;YACJ,oBAAoB;YACpB,oBAAoB;YACpB,wBAAwB;YACxB,uBAAuB;SACxB;QACD,IAAI,EAAE,CAAC,qBAAqB,EAAE,wBAAwB,EAAE,mBAAmB,CAAC;QAC5E,SAAS,EAAE,8CAA8C;QACzD,UAAU,EAAE,IAAI;KACjB;CACF,CAAC;AASF,KAAK,UAAU,kBAAkB;IAC/B,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,GAAG,WAAW,EAAE,uBAAuB,CAAC;QAC5D,OAAO,MAAM,YAAY,CAAiB,WAAW,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,OAA8B,EAC9B,cAAmC;IAEnC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE1B,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,cAAc,GAAG,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC,KAAK,EAAE,CAAC;QACvE,MAAM,SAAS,CACb,GAAG,QAAQ,uBAAuB,EAClC,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CACxC,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,CACb,GAAG,QAAQ,kBAAkB,EAC7B,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CACxC,CAAC;IAEF,MAAM,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAAC,GAAwB;IACnD,IAAI,GAAG,CAAC,QAAQ,IAAI,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,OAAO,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,KAAK,GAAc,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;IAErD,OAAO;QACL,KAAK,EAAE;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB;QACD,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;QAC7C,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;QAC7C,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,0BAA0B;QACtD,UAAU,EAAE,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;KACpE,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,OAA8B;IACrD,MAAM,KAAK,GAAa;QACtB,wBAAwB;QACxB,EAAE;KACH,CAAC;IAEF,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CACR,YAAY,OAAO,CAAC,IAAI,EAAE,EAC1B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,gBAAgB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAChE,EAAE,CACH,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CACR,8EAA8E,EAC9E,EAAE,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CACR,qEAAqE,EACrE,WAAW,EACX,EAAE,EACF,SAAS,EACT,gCAAgC,EAChC,0EAA0E,EAC1E,KAAK,EACL,EAAE,EACF,0EAA0E,EAC1E,EAAE,EACF,qBAAqB,EACrB,EAAE,CACH,CAAC;IAEF,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QACzD,KAAK,CAAC,IAAI,CACR,SAAS,GAAG,IAAI,EAChB,GAAG,CAAC,SAAS,EACb,EAAE,EACF,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACtD,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACpD,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACtD,EAAE,CACH,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,OAA8B;IAE9B,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;IACpD,MAAM,KAAK,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAE9C,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAExD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QAC1C;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC;YAC9D,OAAO,EAAE;gBACP,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;oBACtC,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE;oBACjC,KAAK,EAAE,GAAG;iBACX,CAAC,CAAC;gBACH,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE;aAC9C;SACF;KACF,CAAC,CAAC;IAEH,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;QAC/B,MAAM,iBAAiB,CAAC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7D,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACnC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,EAAE;QACvF,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,EAAE;QACrF,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,EAAE;KACxF,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,mBAAmB,CAAC;QACzC,KAAK,EAAE;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YACjF,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YAC/E,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;SAClF;QACD,SAAS,EAAE,wCAAwC;KACpD,CAAC,CAAC;IAEH,MAAM,iBAAiB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IACjD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAAwB,EAAE;IAE1B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,kBAAkB,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,MAAM,aAAa,CAAsB,OAAO,CAAC,KAAK,CAAC,CAAC;QAE1E,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,MAAM,cAAc,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACvD,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YAC9B,OAAO,cAAc,CAAC;QACxB,CAAC;QAED,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,cAAc,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;YACtD,MAAM,iBAAiB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACjD,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YAC9B,OAAO,cAAc,CAAC;QACxB,CAAC;QAED,IAAI,CACF,OAAO,EACP,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,EAC1D,eAAe,CAAC,OAAO,CAAC,CACzB,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CACV,wBACE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAC3C,EAAE,CACH,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,kBAAkB;AAClB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;IAC5C,WAAW,EAAE,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @thynameisjayvee/alpha-cli - AI development assistive harness
+ *
+ * Programmatic entry point. Alpha never edits code and never spawns agents;
+ * the calling LLM drives these functions and acts on their emitted output.
+ *
+ * @example
+ * ```typescript
+ * import { Alpha } from '@thynameisjayvee/alpha-cli';
+ *
+ * const alpha = await Alpha.open();
+ * const review = await alpha.review({ target: 'src/' });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { Alpha } from './core/alpha.js';
+export { runInit, type InitOptions, type AgentTarget } from './core/init/index.js';
+export { gatherRequirements, type GatherOptions } from './core/requirements/index.js';
+export { adviseStack, type StackOptions } from './core/stack/index.js';
+export { generateSpec, type SpecOptions } from './core/generator/index.js';
+export { runReview, type ReviewOptions } from './core/reviewer/index.js';
+export { runImplementation, type ImplementOptions, } from './core/implementation/index.js';
+export { buildProgram, run } from './cli.js';
+export type { ProjectContext, TechStack, StackRecommendation, Specification, AcceptanceCriterion, Dependency, ImplementationOption, ReviewReport, ReviewFinding, RecommendationOption, ClarifyingQuestion, SubAgentTask, SubAgentResult, } from './types/index.js';
+export { getProjectRoot, getAlphaDir, getSpecsDir, getReportsDir, ensureAlphaDir, getConfigPath, } from './utils/paths.js';
+export { writeFile, readFile, fileExists, deleteFile, readJsonFile, writeJsonFile, listDirectory, ensureDir, } from './utils/file-system.js';
+export { logger, emit, emitError, setJsonMode, isJsonMode, } from './utils/logger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAGxC,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EACL,iBAAiB,EACjB,KAAK,gBAAgB,GACtB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAG7C,YAAY,EACV,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,SAAS,EACT,QAAQ,EACR,UAAU,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACb,SAAS,GACV,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,MAAM,EACN,IAAI,EACJ,SAAS,EACT,WAAW,EACX,UAAU,GACX,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+/**
+ * @thynameisjayvee/alpha-cli - AI development assistive harness
+ *
+ * Programmatic entry point. Alpha never edits code and never spawns agents;
+ * the calling LLM drives these functions and acts on their emitted output.
+ *
+ * @example
+ * ```typescript
+ * import { Alpha } from '@thynameisjayvee/alpha-cli';
+ *
+ * const alpha = await Alpha.open();
+ * const review = await alpha.review({ target: 'src/' });
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Main Alpha class (programmatic API)
+export { Alpha } from './core/alpha.js';
+// Core modules (can be used independently)
+export { runInit } from './core/init/index.js';
+export { gatherRequirements } from './core/requirements/index.js';
+export { adviseStack } from './core/stack/index.js';
+export { generateSpec } from './core/generator/index.js';
+export { runReview } from './core/reviewer/index.js';
+export { runImplementation, } from './core/implementation/index.js';
+// CLI (for embedding/testing)
+export { buildProgram, run } from './cli.js';
+// Utility exports
+export { getProjectRoot, getAlphaDir, getSpecsDir, getReportsDir, ensureAlphaDir, getConfigPath, } from './utils/paths.js';
+export { writeFile, readFile, fileExists, deleteFile, readJsonFile, writeJsonFile, listDirectory, ensureDir, } from './utils/file-system.js';
+export { logger, emit, emitError, setJsonMode, isJsonMode, } from './utils/logger.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,sCAAsC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,2CAA2C;AAC3C,OAAO,EAAE,OAAO,EAAsC,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAsB,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,WAAW,EAAqB,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAoB,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAsB,MAAM,0BAA0B,CAAC;AACzE,OAAO,EACL,iBAAiB,GAElB,MAAM,gCAAgC,CAAC;AAExC,8BAA8B;AAC9B,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAmB7C,kBAAkB;AAClB,OAAO,EACL,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,SAAS,EACT,QAAQ,EACR,UAAU,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACb,SAAS,GACV,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,MAAM,EACN,IAAI,EACJ,SAAS,EACT,WAAW,EACX,UAAU,GACX,MAAM,mBAAmB,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Core type definitions for Project Alpha
+ */
+export interface ProjectContext {
+    name: string;
+    description: string;
+    intent: string;
+    goals: string[];
+    constraints: string[];
+    techStack?: TechStack;
+}
+export interface TechStack {
+    frontend?: string[];
+    backend?: string[];
+    database?: string[];
+    infrastructure?: string[];
+    tools?: string[];
+}
+export interface StackRecommendation {
+    stack: TechStack;
+    pros: string[];
+    cons: string[];
+    rationale: string;
+    confidence: number;
+}
+export interface Specification {
+    id: string;
+    title: string;
+    type: 'feature' | 'bugfix' | 'refactor' | 'enhancement';
+    description: string;
+    acceptanceCriteria: AcceptanceCriterion[];
+    dependencies: Dependency[];
+    implementationOptions: ImplementationOption[];
+    metadata: SpecMetadata;
+}
+export interface AcceptanceCriterion {
+    id: string;
+    description: string;
+    layer: 'unit' | 'integration' | 'e2e' | 'manual';
+    priority: 'must' | 'should' | 'could';
+}
+export interface Dependency {
+    id: string;
+    name: string;
+    type: 'file' | 'module' | 'service' | 'external' | 'skill';
+    path?: string;
+    description: string;
+    status: 'exists' | 'needs-creation' | 'needs-modification';
+}
+export interface ImplementationOption {
+    id: string;
+    title: string;
+    description: string;
+    approach: string;
+    pros: string[];
+    cons: string[];
+    estimatedEffort: 'low' | 'medium' | 'high';
+    risks: string[];
+    recommended?: boolean;
+}
+export interface SpecMetadata {
+    createdAt: string;
+    updatedAt: string;
+    version: string;
+    status: 'draft' | 'finalized' | 'implemented' | 'deprecated';
+    codebasePath?: string;
+}
+export interface ReviewFinding {
+    id: string;
+    title: string;
+    description: string;
+    severity: 'critical' | 'high' | 'medium' | 'low' | 'info';
+    location?: {
+        file?: string;
+        line?: number;
+        function?: string;
+    };
+    dependencies: Dependency[];
+    recommendationOptions: RecommendationOption[];
+}
+export interface RecommendationOption {
+    id: string;
+    title: string;
+    description: string;
+    implementationSteps: string[];
+    estimatedEffort: 'low' | 'medium' | 'high';
+    risks: string[];
+    recommended?: boolean;
+}
+export interface ReviewReport {
+    id: string;
+    title: string;
+    reviewTarget: string;
+    findings: ReviewFinding[];
+    summary: {
+        totalFindings: number;
+        critical: number;
+        high: number;
+        medium: number;
+        low: number;
+        info: number;
+    };
+    createdAt: string;
+    status: 'pending-review' | 'ready-for-implementation' | 'implemented' | 'dismissed';
+}
+export interface ClarifyingQuestion {
+    id: string;
+    question: string;
+    category: 'intent' | 'scope' | 'constraints' | 'preferences' | 'technical';
+    required: boolean;
+    options?: string[];
+    followUpQuestions?: ClarifyingQuestion[];
+}
+export interface SubAgentTask {
+    id: string;
+    type: 'spec-analysis' | 'code-review' | 'implementation' | 'testing';
+    prompt: string;
+    dependencies?: string[];
+    timeout?: number;
+}
+export interface SubAgentResult {
+    taskId: string;
+    success: boolean;
+    output?: string;
+    error?: string;
+    duration: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * Core type definitions for Project Alpha
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/config.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Configuration loader with zod validation
+ *
+ * Loads and validates .alpha/config.json with type-safe defaults
+ */
+import { z } from 'zod';
+/**
+ * Configuration schema with defaults
+ */
+declare const ConfigSchema: z.ZodDefault<z.ZodObject<{
+    version: z.ZodDefault<z.ZodString>;
+    output: z.ZodDefault<z.ZodObject<{
+        alphaDir: z.ZodDefault<z.ZodString>;
+        specsDir: z.ZodDefault<z.ZodString>;
+        reportsDir: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        alphaDir: string;
+        specsDir: string;
+        reportsDir: string;
+    }, {
+        alphaDir?: string | undefined;
+        specsDir?: string | undefined;
+        reportsDir?: string | undefined;
+    }>>;
+    review: z.ZodDefault<z.ZodObject<{
+        defaultChecks: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        autoSelectRecommended: z.ZodDefault<z.ZodBoolean>;
+        maxFiles: z.ZodDefault<z.ZodNumber>;
+        timeout: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        defaultChecks: string[];
+        autoSelectRecommended: boolean;
+        maxFiles: number;
+        timeout: number;
+    }, {
+        defaultChecks?: string[] | undefined;
+        autoSelectRecommended?: boolean | undefined;
+        maxFiles?: number | undefined;
+        timeout?: number | undefined;
+    }>>;
+    implementation: z.ZodDefault<z.ZodObject<{
+        autoVerify: z.ZodDefault<z.ZodBoolean>;
+        cleanupOnVerify: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        autoVerify: boolean;
+        cleanupOnVerify: boolean;
+    }, {
+        autoVerify?: boolean | undefined;
+        cleanupOnVerify?: boolean | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    output: {
+        alphaDir: string;
+        specsDir: string;
+        reportsDir: string;
+    };
+    review: {
+        defaultChecks: string[];
+        autoSelectRecommended: boolean;
+        maxFiles: number;
+        timeout: number;
+    };
+    implementation: {
+        autoVerify: boolean;
+        cleanupOnVerify: boolean;
+    };
+}, {
+    version?: string | undefined;
+    output?: {
+        alphaDir?: string | undefined;
+        specsDir?: string | undefined;
+        reportsDir?: string | undefined;
+    } | undefined;
+    review?: {
+        defaultChecks?: string[] | undefined;
+        autoSelectRecommended?: boolean | undefined;
+        maxFiles?: number | undefined;
+        timeout?: number | undefined;
+    } | undefined;
+    implementation?: {
+        autoVerify?: boolean | undefined;
+        cleanupOnVerify?: boolean | undefined;
+    } | undefined;
+}>>;
+export type Config = z.infer<typeof ConfigSchema>;
+/**
+ * Load configuration from .alpha/config.json
+ * Falls back to defaults if file doesn't exist
+ */
+export declare function loadConfig(): Promise<Config>;
+/**
+ * Save configuration to .alpha/config.json
+ */
+export declare function saveConfig(config: Partial<Config>): Promise<void>;
+/**
+ * Get configuration with overrides
+ */
+export declare function getConfigWithOverrides(overrides?: Partial<Config>): Promise<Config>;
+/**
+ * Initialize default configuration file
+ */
+export declare function initializeConfig(): Promise<Config>;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;GAEG;AACH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiBJ,CAAC;AAEf,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AASlD;;;GAGG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CA4BlD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAczF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAWxD"}