hardness 1.0.0 → 1.1.2

package/packages/cli/dist/interview/runner.js

@@ -0,0 +1,327 @@
+import readline from 'readline';
+import fs from 'fs';
+import path from 'path';
+import pc from 'picocolors';
+import { getProjectRoot } from '@hardness/core';
+import { detectStack } from './types.js';
+import { createSuggestionEngine } from './suggestions.js';
+import { QUESTIONS, getPromptForLevel, getChoicesForLevel } from './questions.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const PHASE_ORDER = [
+    'opening', 'vision', 'people', 'features', 'constraints', 'boundaries', 'review',
+];
+const PHASE_LABELS = {
+    opening: 'Phase 0 — Opening',
+    vision: 'Phase 1 — Vision',
+    people: 'Phase 2 — People',
+    features: 'Phase 3 — Features',
+    constraints: 'Phase 4 — Constraints',
+    boundaries: 'Phase 5 — Boundaries',
+    review: 'Phase 6 — Review',
+};
+const PROJECT_TYPE_CHOICES = {
+    '1': 'web-app',
+    '2': 'api',
+    '3': 'cli',
+    '4': 'library',
+    '5': 'desktop',
+    '6': 'mobile',
+    '7': 'other',
+    'web-app': 'web-app',
+    api: 'api',
+    cli: 'cli',
+    library: 'library',
+    desktop: 'desktop',
+    mobile: 'mobile',
+    other: 'other',
+    // Beginner-friendly choice mappings
+    'a website or web system that people use in the browser': 'web-app',
+    'a behind-the-scenes service that other programs talk to': 'api',
+    'a tool you run from the command line (terminal)': 'cli',
+    'a reusable piece of code that other developers can use': 'library',
+    'an app that runs on a computer (windows, mac, linux)': 'desktop',
+    'a phone app (ios, android)': 'mobile',
+    'something else': 'other',
+    // Intermediate mappings
+    'web application (frontend + backend)': 'web-app',
+    'api / backend service': 'api',
+    'cli tool': 'cli',
+    'library / sdk': 'library',
+    'desktop application': 'desktop',
+    'mobile application': 'mobile',
+};
+const USER_LEVEL_CHOICES = {
+    '1': 'beginner',
+    '2': 'intermediate',
+    '3': 'advanced',
+    beginner: 'beginner',
+    intermediate: 'intermediate',
+    advanced: 'advanced',
+};
+const MAX_EXTRA_QUESTIONS_PER_PHASE = 3;
+const MIN_EVALUATION_SCORE = 9;
+// ---------------------------------------------------------------------------
+// Line queue — collects all input lines upfront so we never block
+// ---------------------------------------------------------------------------
+class LineQueue {
+    lines = [];
+    resolvers = [];
+    closed = false;
+    push(line) {
+        if (this.resolvers.length > 0) {
+            const resolve = this.resolvers.shift();
+            resolve(line);
+        }
+        else {
+            this.lines.push(line);
+        }
+    }
+    close() {
+        this.closed = true;
+        while (this.resolvers.length > 0) {
+            const resolve = this.resolvers.shift();
+            resolve('');
+        }
+    }
+    next() {
+        if (this.lines.length > 0) {
+            return Promise.resolve(this.lines.shift());
+        }
+        if (this.closed) {
+            return Promise.resolve('');
+        }
+        return new Promise((resolve) => {
+            this.resolvers.push(resolve);
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function formatSuggestion(value) {
+    return Array.isArray(value) ? value.join(', ') : value;
+}
+function savePartialState(state, questionIndex, root) {
+    const hardnessDir = path.join(root, '.hardness');
+    try {
+        if (!fs.existsSync(hardnessDir)) {
+            fs.mkdirSync(hardnessDir, { recursive: true });
+        }
+        const sessionPath = path.join(hardnessDir, 'discover-session.json');
+        fs.writeFileSync(sessionPath, JSON.stringify({ questionIndex, state }, null, 2), 'utf-8');
+    }
+    catch {
+        // best-effort
+    }
+}
+function detectLocale() {
+    try {
+        return Intl.DateTimeFormat().resolvedOptions().locale;
+    }
+    catch {
+        return 'en-US';
+    }
+}
+export async function runInterview(options = {}) {
+    const root = options.root ?? getProjectRoot();
+    const detectedStack = detectStack(root);
+    const locale = options.locale ?? detectLocale();
+    const state = {
+        phase: 'opening',
+        answers: {},
+        detectedStack,
+        projectType: 'other',
+        userLevel: 'beginner',
+        locale,
+    };
+    const engine = createSuggestionEngine();
+    const evaluator = options.evaluator ?? null;
+    // Build a line queue from the rl interface
+    const queue = new LineQueue();
+    const rl = options.rl ??
+        readline.createInterface({
+            input: process.stdin,
+            output: undefined,
+            terminal: false,
+        });
+    rl.on('line', (line) => queue.push(line));
+    rl.on('close', () => queue.close());
+    let questionIndex = 0;
+    // Ctrl+C handler
+    rl.on('SIGINT', () => {
+        process.stdout.write('\n');
+        process.stdout.write(pc.yellow('Interview interrupted. Saving partial session...\n'));
+        savePartialState(state, questionIndex, root);
+        process.stdout.write(pc.dim('Session saved to .hardness/discover-session.json\n'));
+        process.stdout.write(pc.dim('Run `hardness discover` again to resume.\n'));
+        rl.close();
+        process.exit(0);
+    });
+    // Translate questions if locale is not English and evaluator is available
+    let translationMap = null;
+    if (evaluator && !locale.startsWith('en')) {
+        try {
+            const questionsToTranslate = QUESTIONS
+                .filter(q => q.type !== 'action')
+                .map(q => ({
+                id: q.id,
+                prompt: getPromptForLevel(q, state.userLevel),
+                choices: getChoicesForLevel(q, state.userLevel),
+            }));
+            const translated = await evaluator.translateQuestions(locale, questionsToTranslate);
+            translationMap = new Map(translated.map(t => [t.id, t]));
+        }
+        catch {
+            // Translation failed — fall back to English
+        }
+    }
+    // Helper to get the display prompt for a question
+    function getDisplayPrompt(question) {
+        if (translationMap?.has(question.id)) {
+            return translationMap.get(question.id).prompt;
+        }
+        return getPromptForLevel(question, state.userLevel);
+    }
+    function getDisplayChoices(question) {
+        if (translationMap?.has(question.id)) {
+            return translationMap.get(question.id).choices;
+        }
+        return getChoicesForLevel(question, state.userLevel);
+    }
+    // Ask a single question and collect the answer
+    async function askQuestion(question) {
+        const prompt = getDisplayPrompt(question);
+        const choices = getDisplayChoices(question);
+        process.stdout.write(`\n${pc.white(prompt)}\n`);
+        if (question.type === 'choice' && choices) {
+            for (const c of choices) {
+                process.stdout.write(`  ${pc.dim(c)}\n`);
+            }
+        }
+        process.stdout.write(pc.dim('(? for suggestion, Enter to use default)\n'));
+        process.stdout.write(`${pc.cyan('>')} `);
+        if (question.type === 'multiline') {
+            const collected = [];
+            for (;;) {
+                const line = await queue.next();
+                if (line.trim() === '')
+                    break;
+                collected.push(line);
+            }
+            if (collected.length === 0) {
+                const suggestion = engine.suggest(question.suggestionId, state);
+                state.answers[question.id] = Array.isArray(suggestion) ? suggestion : [suggestion];
+            }
+            else {
+                state.answers[question.id] = collected;
+            }
+            return;
+        }
+        // Single-line questions
+        const rawInput = await queue.next();
+        const trimmed = rawInput.trim();
+        if (trimmed === '?') {
+            const suggestion = engine.suggest(question.suggestionId, state);
+            const formatted = formatSuggestion(suggestion);
+            process.stdout.write(`${pc.yellow('Suggestion:')} ${formatted}\n`);
+            process.stdout.write(`${pc.cyan('>')} `);
+            const next = await queue.next();
+            state.answers[question.id] = next.trim() !== '' ? next.trim() : formatted;
+        }
+        else if (trimmed === '') {
+            const suggestion = engine.suggest(question.suggestionId, state);
+            const formatted = formatSuggestion(suggestion);
+            process.stdout.write(`${pc.dim(`Using suggestion: ${formatted}`)}\n`);
+            state.answers[question.id] = formatted;
+        }
+        else {
+            state.answers[question.id] = trimmed;
+        }
+    }
+    // Iterate through all phases
+    for (const phase of PHASE_ORDER) {
+        state.phase = phase;
+        // Print phase header
+        process.stdout.write(`\n${pc.bold(pc.blue(PHASE_LABELS[phase]))}\n`);
+        process.stdout.write(`${pc.dim('─'.repeat(40))}\n`);
+        // Get base questions for this phase (exclude actions)
+        const phaseQuestions = QUESTIONS.filter(q => q.phase === phase && q.type !== 'action');
+        // Ask base questions
+        for (const question of phaseQuestions) {
+            questionIndex++;
+            await askQuestion(question);
+            // Resolve user level after q0.2
+            if (question.id === 'q0.2') {
+                const raw = state.answers['q0.2'];
+                const key = raw.split(/[—\-]/)[0].trim().toLowerCase();
+                state.userLevel = USER_LEVEL_CHOICES[key] ?? 'beginner';
+                // Re-translate questions if needed (now we know the user level)
+                if (evaluator && translationMap && !locale.startsWith('en')) {
+                    try {
+                        const questionsToTranslate = QUESTIONS
+                            .filter(q => q.type !== 'action')
+                            .map(q => ({
+                            id: q.id,
+                            prompt: getPromptForLevel(q, state.userLevel),
+                            choices: getChoicesForLevel(q, state.userLevel),
+                        }));
+                        const translated = await evaluator.translateQuestions(locale, questionsToTranslate);
+                        translationMap = new Map(translated.map(t => [t.id, t]));
+                    }
+                    catch {
+                        // Fall back to existing translations
+                    }
+                }
+            }
+            // Resolve projectType after q1.4
+            if (question.id === 'q1.4') {
+                const raw = state.answers['q1.4'];
+                const key = raw.split(/[\s—]/)[0].trim().toLowerCase();
+                state.projectType = PROJECT_TYPE_CHOICES[key] ?? 'other';
+            }
+        }
+        // Evaluate phase completion via LLM (invisible to user)
+        // Skip evaluation for opening and review phases
+        if (evaluator && phase !== 'opening' && phase !== 'review') {
+            let extraAsked = 0;
+            for (let round = 0; round < MAX_EXTRA_QUESTIONS_PER_PHASE; round++) {
+                try {
+                    const evaluation = await evaluator.evaluatePhase(phase, state, QUESTIONS);
+                    if (evaluation.score >= MIN_EVALUATION_SCORE) {
+                        break;
+                    }
+                    // Ask follow-up questions
+                    const followUps = evaluation.followUpQuestions.slice(0, MAX_EXTRA_QUESTIONS_PER_PHASE - extraAsked);
+                    if (followUps.length === 0)
+                        break;
+                    for (const fq of followUps) {
+                        if (extraAsked >= MAX_EXTRA_QUESTIONS_PER_PHASE)
+                            break;
+                        const dynamicQuestion = {
+                            id: fq.id,
+                            phase,
+                            prompt: fq.prompt,
+                            type: fq.type,
+                            choices: fq.choices,
+                            suggestionId: fq.id,
+                        };
+                        questionIndex++;
+                        await askQuestion(dynamicQuestion);
+                        extraAsked++;
+                    }
+                }
+                catch {
+                    // Evaluation failed — continue without it
+                    break;
+                }
+            }
+        }
+    }
+    if (!options.rl) {
+        rl.close();
+    }
+    return state;
+}
+//# sourceMappingURL=runner.js.map

package/packages/cli/dist/interview/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/interview/runner.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAIlF,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,WAAW,GAAoB;IACnC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ;CACjF,CAAC;AAEF,MAAM,YAAY,GAAkC;IAClD,OAAO,EAAE,mBAAmB;IAC5B,MAAM,EAAE,kBAAkB;IAC1B,MAAM,EAAE,kBAAkB;IAC1B,QAAQ,EAAE,oBAAoB;IAC9B,WAAW,EAAE,uBAAuB;IACpC,UAAU,EAAE,sBAAsB;IAClC,MAAM,EAAE,kBAAkB;CAC3B,CAAC;AAEF,MAAM,oBAAoB,GAAgC;IACxD,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,OAAO;IACZ,SAAS,EAAE,SAAS;IACpB,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,oCAAoC;IACpC,wDAAwD,EAAE,SAAS;IACnE,yDAAyD,EAAE,KAAK;IAChE,iDAAiD,EAAE,KAAK;IACxD,wDAAwD,EAAE,SAAS;IACnE,sDAAsD,EAAE,SAAS;IACjE,4BAA4B,EAAE,QAAQ;IACtC,gBAAgB,EAAE,OAAO;IACzB,wBAAwB;IACxB,sCAAsC,EAAE,SAAS;IACjD,uBAAuB,EAAE,KAAK;IAC9B,UAAU,EAAE,KAAK;IACjB,eAAe,EAAE,SAAS;IAC1B,qBAAqB,EAAE,SAAS;IAChC,oBAAoB,EAAE,QAAQ;CAC/B,CAAC;AAEF,MAAM,kBAAkB,GAA8B;IACpD,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,UAAU;IACf,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;IAC5B,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF,MAAM,6BAA6B,GAAG,CAAC,CAAC;AACxC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAE/B,8EAA8E;AAC9E,kEAAkE;AAClE,8EAA8E;AAE9E,MAAM,SAAS;IACL,KAAK,GAAa,EAAE,CAAC;IACrB,SAAS,GAAkC,EAAE,CAAC;IAC9C,MAAM,GAAG,KAAK,CAAC;IAEvB,IAAI,CAAC,IAAY;QACf,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAG,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAG,CAAC;YACxC,OAAO,CAAC,EAAE,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;YACrC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,gBAAgB,CAAC,KAAwB;IAChD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACzD,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAqB,EAAE,aAAqB,EAAE,IAAY;IAClF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC;QACpE,EAAE,CAAC,aAAa,CACd,WAAW,EACX,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EACjD,OAAO,CACR,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,cAAc;IAChB,CAAC;AACH,CAAC;AAED,SAAS,YAAY;IACnB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAiBD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAyB,EAAE;IAC5D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,cAAc,EAAE,CAAC;IAC9C,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;IAEhD,MAAM,KAAK,GAAmB;QAC5B,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,EAAE;QACX,aAAa;QACb,WAAW,EAAE,OAAO;QACpB,SAAS,EAAE,UAAU;QACrB,MAAM;KACP,CAAC;IAEF,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;IACxC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;IAE5C,2CAA2C;IAC3C,MAAM,KAAK,GAAG,IAAI,SAAS,EAAE,CAAC;IAE9B,MAAM,EAAE,GACN,OAAO,CAAC,EAAE;QACV,QAAQ,CAAC,eAAe,CAAC;YACvB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;IAEL,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1C,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAEpC,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,iBAAiB;IACjB,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,oDAAoD,CAAC,CAAC,CAAC;QACtF,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;QAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC,CAAC;QACnF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC,CAAC;QAC3E,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,IAAI,cAAc,GAA2C,IAAI,CAAC;IAClE,IAAI,SAAS,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,MAAM,oBAAoB,GAAG,SAAS;iBACnC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;iBAChC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACT,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,MAAM,EAAE,iBAAiB,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;gBAC7C,OAAO,EAAE,kBAAkB,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;aAChD,CAAC,CAAC,CAAC;YAEN,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;YACpF,cAAc,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;QAC9C,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,SAAS,gBAAgB,CAAC,QAAkB;QAC1C,IAAI,cAAc,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACrC,OAAO,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAE,CAAC,MAAM,CAAC;QACjD,CAAC;QACD,OAAO,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;IAED,SAAS,iBAAiB,CAAC,QAAkB;QAC3C,IAAI,cAAc,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACrC,OAAO,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAE,CAAC,OAAO,CAAC;QAClD,CAAC;QACD,OAAO,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;IAED,+CAA+C;IAC/C,KAAK,UAAU,WAAW,CAAC,QAAkB;QAC3C,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAE5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEhD,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,EAAE,CAAC;YAC1C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC,CAAC;QAC3E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEzC,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,SAAS,CAAC;gBACR,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;gBAChC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;oBAAE,MAAM;gBAC9B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;gBAChE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;YACrF,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;YACzC,CAAC;YACD,OAAO;QACT,CAAC;QAED,wBAAwB;QACxB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEhC,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YACpB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAChE,MAAM,SAAS,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;YAC/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,SAAS,IAAI,CAAC,CAAC;YACnE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACzC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;YAChC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5E,CAAC;aAAM,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YAC1B,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAChE,MAAM,SAAS,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;YAC/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,qBAAqB,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;YACtE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC;QACvC,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QAEpB,qBAAqB;QACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAEpD,sDAAsD;QACtD,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAEvF,qBAAqB;QACrB,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;YACtC,aAAa,EAAE,CAAC;YAChB,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;YAE5B,gCAAgC;YAChC,IAAI,QAAQ,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAW,CAAC;gBAC5C,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBACvD,KAAK,CAAC,SAAS,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC;gBAExD,gEAAgE;gBAChE,IAAI,SAAS,IAAI,cAAc,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC5D,IAAI,CAAC;wBACH,MAAM,oBAAoB,GAAG,SAAS;6BACnC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;6BAChC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;4BACT,EAAE,EAAE,CAAC,CAAC,EAAE;4BACR,MAAM,EAAE,iBAAiB,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;4BAC7C,OAAO,EAAE,kBAAkB,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;yBAChD,CAAC,CAAC,CAAC;wBACN,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;wBACpF,cAAc,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC3D,CAAC;oBAAC,MAAM,CAAC;wBACP,qCAAqC;oBACvC,CAAC;gBACH,CAAC;YACH,CAAC;YAED,iCAAiC;YACjC,IAAI,QAAQ,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAW,CAAC;gBAC5C,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBACvD,KAAK,CAAC,WAAW,GAAG,oBAAoB,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC;YAC3D,CAAC;QACH,CAAC;QAED,wDAAwD;QACxD,gDAAgD;QAChD,IAAI,SAAS,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC3D,IAAI,UAAU,GAAG,CAAC,CAAC;YAEnB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,6BAA6B,EAAE,KAAK,EAAE,EAAE,CAAC;gBACnE,IAAI,CAAC;oBACH,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;oBAE1E,IAAI,UAAU,CAAC,KAAK,IAAI,oBAAoB,EAAE,CAAC;wBAC7C,MAAM;oBACR,CAAC;oBAED,0BAA0B;oBAC1B,MAAM,SAAS,GAAG,UAAU,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,6BAA6B,GAAG,UAAU,CAAC,CAAC;oBACpG,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;wBAAE,MAAM;oBAElC,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;wBAC3B,IAAI,UAAU,IAAI,6BAA6B;4BAAE,MAAM;wBAEvD,MAAM,eAAe,GAAa;4BAChC,EAAE,EAAE,EAAE,CAAC,EAAE;4BACT,KAAK;4BACL,MAAM,EAAE,EAAE,CAAC,MAAM;4BACjB,IAAI,EAAE,EAAE,CAAC,IAAI;4BACb,OAAO,EAAE,EAAE,CAAC,OAAO;4BACnB,YAAY,EAAE,EAAE,CAAC,EAAE;yBACpB,CAAC;wBAEF,aAAa,EAAE,CAAC;wBAChB,MAAM,WAAW,CAAC,eAAe,CAAC,CAAC;wBACnC,UAAU,EAAE,CAAC;oBACf,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,0CAA0C;oBAC1C,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAChB,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/packages/cli/dist/interview/suggestions.d.ts

@@ -0,0 +1,6 @@
+import type { InterviewState, SuggestionEngine } from './types.js';
+export declare class StaticSuggestionEngine implements SuggestionEngine {
+    suggest(questionId: string, state: InterviewState): string | string[];
+}
+/** Convenience factory */
+export declare function createSuggestionEngine(): SuggestionEngine;

package/packages/cli/dist/interview/suggestions.js

@@ -0,0 +1,230 @@
+// ---------------------------------------------------------------------------
+// Static suggestion table: (projectType) → (questionId → suggestion)
+// Stack-aware refinements are applied inside suggest() when needed.
+// ---------------------------------------------------------------------------
+const SUGGESTIONS = {
+    'web-app': {
+        'q0.1': 'I want to build a web application that helps users manage their tasks and projects through an intuitive browser-based interface.',
+        'q0.2': 'beginner',
+        'q1.1': 'my-web-app',
+        'q1.2': 'A web application that solves a specific business problem.',
+        'q1.3': 'Automates web workflows for end users, reducing manual effort and errors.',
+        'q1.4': 'web-app',
+        'q2.1': 'end user',
+        'q2.2': 'DevOps engineer, QA tester, product manager',
+        'q2.3': '1',
+        'q3.1': ['User authentication', 'Dashboard', 'Data visualization', 'REST API', 'Admin panel'],
+        'q3.2': '1',
+        'q3.3': 'The feature works end-to-end without errors and is covered by tests.',
+        'q4.1': '1',
+        'q4.2': 'React with Vite',
+        'q4.3': 'PostgreSQL',
+        'q4.4': 'Email/password + optional OAuth',
+        'q4.5': '1',
+        'q4.6': 'Docker + VPS',
+        'q4.7': 'API responses under 200ms p95. Static assets under 100ms.',
+        'q4.8': 'Logging + metrics',
+        'q5.1': ['Mobile native app', 'Internationalization (i18n)', 'Custom theme builder', 'Billing system'],
+        'q5.2': 'Users have Node.js 20+ installed. Network is available for external dependencies.',
+        'q5.3': 'Scope may grow — strict sprint discipline is required. External API rate limits may apply.',
+        'q6.1': '1',
+    },
+    api: {
+        'q0.1': 'I want to build an API service that exposes business data and logic for other applications to consume.',
+        'q0.2': 'intermediate',
+        'q1.1': 'my-api',
+        'q1.2': 'A REST API service that exposes data and business logic over HTTP.',
+        'q1.3': 'Provides a reliable and secure backend API for client applications.',
+        'q1.4': 'api',
+        'q2.1': 'backend developer',
+        'q2.2': 'DevOps engineer, QA engineer',
+        'q2.3': '3',
+        'q3.1': ['CRUD endpoints', 'Authentication', 'Rate limiting', 'Pagination', 'Error handling'],
+        'q3.2': '1',
+        'q3.3': 'The feature works end-to-end without errors and is covered by tests.',
+        'q4.1': '1',
+        'q4.2': 'No frontend (API only)',
+        'q4.3': 'PostgreSQL',
+        'q4.4': 'API keys / tokens',
+        'q4.5': '1',
+        'q4.6': 'Docker container',
+        'q4.7': 'API responses under 200ms p95.',
+        'q4.8': 'Logging + metrics',
+        'q5.1': ['GraphQL gateway', 'WebSocket streaming', 'Admin UI'],
+        'q5.2': 'Clients must supply a valid API key in each request.',
+        'q5.3': 'Scope may grow — strict sprint discipline is required. Third-party rate limits may apply.',
+        'q6.1': '1',
+    },
+    cli: {
+        'q0.1': 'I want to build a command-line tool that automates repetitive developer tasks.',
+        'q0.2': 'advanced',
+        'q1.1': 'my-cli',
+        'q1.2': 'A command-line tool that automates developer workflows.',
+        'q1.3': 'Eliminates repetitive manual tasks for developers by providing a reliable CLI.',
+        'q1.4': 'cli',
+        'q2.1': 'developer',
+        'q2.2': 'DevOps engineer, power user',
+        'q2.3': '3',
+        'q3.1': ['Init command', 'Config management', 'Run/execute', 'Output formatting', 'Help system'],
+        'q3.2': '1',
+        'q3.3': 'The feature works end-to-end without errors and is covered by tests.',
+        'q4.1': '1',
+        'q4.2': 'No frontend (API only)',
+        'q4.3': 'None needed',
+        'q4.4': 'API keys / tokens',
+        'q4.5': '1',
+        'q4.6': 'Distributed via npm (npx / global install)',
+        'q4.7': 'Commands complete in under 2 seconds for typical workloads.',
+        'q4.8': 'Logging only (console/file)',
+        'q5.1': ['GUI version', 'Auto-update mechanism', 'Plugin system'],
+        'q5.2': 'Users have the required runtime installed. No network required for core commands.',
+        'q5.3': 'Scope may grow — strict sprint discipline is required.',
+        'q6.1': '1',
+    },
+    library: {
+        'q0.1': 'I want to build a reusable library that other developers can use in their projects.',
+        'q0.2': 'advanced',
+        'q1.1': 'my-library',
+        'q1.2': 'A reusable library / SDK for developers.',
+        'q1.3': 'Provides well-tested building blocks that other projects can depend on.',
+        'q1.4': 'library',
+        'q2.1': 'developer',
+        'q2.2': 'Open-source contributors, QA engineer',
+        'q2.3': '3',
+        'q3.1': ['Core API', 'Type definitions', 'Documentation', 'Examples', 'Tests'],
+        'q3.2': '1',
+        'q3.3': 'The feature works end-to-end without errors and is covered by tests.',
+        'q4.1': '1',
+        'q4.2': 'No frontend (API only)',
+        'q4.3': 'None needed',
+        'q4.4': 'No authentication',
+        'q4.5': '1',
+        'q4.6': 'Distributed via npm / crates.io / PyPI',
+        'q4.7': 'Library calls complete in under 10ms for typical inputs.',
+        'q4.8': 'Logging only (console/file)',
+        'q5.1': ['CLI wrapper', 'GUI explorer', 'Cloud service integration'],
+        'q5.2': 'Consumers use a supported language / runtime version.',
+        'q5.3': 'API surface must remain stable — breaking changes require a major version bump.',
+        'q6.1': '1',
+    },
+    desktop: {
+        'q0.1': 'I want to build a desktop application that runs natively on Windows, Mac, or Linux.',
+        'q0.2': 'intermediate',
+        'q1.1': 'my-desktop-app',
+        'q1.2': 'A desktop application that runs natively on the user\'s machine.',
+        'q1.3': 'Delivers a rich native experience for power users who need offline capabilities.',
+        'q1.4': 'desktop',
+        'q2.1': 'end user',
+        'q2.2': 'IT administrator, support engineer',
+        'q2.3': '1',
+        'q3.1': ['Main window / UI', 'Data persistence', 'Settings', 'Auto-update', 'Help / docs'],
+        'q3.2': '1',
+        'q3.3': 'The feature works end-to-end without errors and is covered by tests.',
+        'q4.1': '1',
+        'q4.2': 'Static HTML / CSS',
+        'q4.3': 'SQLite (embedded)',
+        'q4.4': 'No authentication',
+        'q4.5': '1',
+        'q4.6': 'Packaged installer (Electron / Tauri)',
+        'q4.7': 'App launches in under 3 seconds.',
+        'q4.8': 'Logging only (console/file)',
+        'q5.1': ['Web version', 'Mobile companion app', 'Plugin marketplace'],
+        'q5.2': 'Target OS versions are Windows 10+, macOS 12+, Ubuntu 22+.',
+        'q5.3': 'Cross-platform packaging adds complexity — start with one OS if needed.',
+        'q6.1': '1',
+    },
+    mobile: {
+        'q0.1': 'I want to build a mobile app for phones that people can download and use on the go.',
+        'q0.2': 'intermediate',
+        'q1.1': 'my-mobile-app',
+        'q1.2': 'A mobile application for iOS and/or Android.',
+        'q1.3': 'Delivers a native mobile experience that users can access anywhere.',
+        'q1.4': 'mobile',
+        'q2.1': 'end user',
+        'q2.2': 'Product manager, QA engineer',
+        'q2.3': '1',
+        'q3.1': ['Onboarding', 'Core user flow', 'Push notifications', 'Settings', 'Offline support'],
+        'q3.2': '1',
+        'q3.3': 'The feature works end-to-end without errors and is covered by tests.',
+        'q4.1': '1',
+        'q4.2': 'No frontend (API only)',
+        'q4.3': 'PostgreSQL',
+        'q4.4': 'Email/password + optional OAuth',
+        'q4.5': '1',
+        'q4.6': 'App Store / Google Play',
+        'q4.7': 'Screens render in under 300ms. API calls under 500ms p95.',
+        'q4.8': 'Logging + metrics',
+        'q5.1': ['Tablet-specific layout', 'Wearable app', 'Desktop companion'],
+        'q5.2': 'Target: iOS 16+, Android 11+.',
+        'q5.3': 'App store review cycles add 1-2 week delays to releases.',
+        'q6.1': '1',
+    },
+    other: {
+        'q0.1': 'I want to build a software project that solves a specific problem.',
+        'q0.2': 'intermediate',
+        'q1.1': 'my-project',
+        'q1.2': 'A software project with a specific purpose.',
+        'q1.3': 'Solves a well-defined problem in a reliable and maintainable way.',
+        'q1.4': 'other',
+        'q2.1': 'user',
+        'q2.2': 'DevOps engineer, QA engineer',
+        'q2.3': '2',
+        'q3.1': ['Core feature', 'Configuration', 'Documentation', 'Tests'],
+        'q3.2': '1',
+        'q3.3': 'The feature works end-to-end without errors and is covered by tests.',
+        'q4.1': '1',
+        'q4.2': 'No frontend (API only)',
+        'q4.3': 'None needed',
+        'q4.4': 'No authentication',
+        'q4.5': '1',
+        'q4.6': 'On-premises',
+        'q4.7': 'Operations complete in reasonable time for the expected workload.',
+        'q4.8': 'Logging only (console/file)',
+        'q5.1': ['Unrelated future features'],
+        'q5.2': 'Required runtime is installed on the target environment.',
+        'q5.3': 'Scope may grow — strict sprint discipline is required.',
+        'q6.1': '1',
+    },
+};
+// ---------------------------------------------------------------------------
+// Stack-aware overrides applied on top of the base table
+// ---------------------------------------------------------------------------
+function applyStackOverrides(base, questionId, state) {
+    const { stackProfile } = state.detectedStack;
+    // Deployment suggestion adapts to detected stack
+    if (questionId === 'q4.6') {
+        if (stackProfile === 'typescript-node') {
+            if (state.projectType === 'cli' || state.projectType === 'library') {
+                return 'Distributed via npm (npx / global install)';
+            }
+            return 'Docker + VPS';
+        }
+        if (state.detectedStack.label === 'Python') {
+            if (state.projectType === 'cli' || state.projectType === 'library') {
+                return 'Distributed via PyPI (pip install)';
+            }
+        }
+        if (state.detectedStack.label === 'Rust') {
+            return 'Distributed via crates.io (cargo install)';
+        }
+        if (state.detectedStack.label === 'Go') {
+            return 'Compiled binary distributed via GitHub Releases';
+        }
+    }
+    return base;
+}
+// ---------------------------------------------------------------------------
+// Exported suggestion engine implementation
+// ---------------------------------------------------------------------------
+export class StaticSuggestionEngine {
+    suggest(questionId, state) {
+        const table = SUGGESTIONS[state.projectType] ?? SUGGESTIONS.other;
+        const base = table[questionId] ?? 'No suggestion available.';
+        return applyStackOverrides(base, questionId, state);
+    }
+}
+/** Convenience factory */
+export function createSuggestionEngine() {
+    return new StaticSuggestionEngine();
+}
+//# sourceMappingURL=suggestions.js.map

package/packages/cli/dist/interview/suggestions.js.map

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

package/packages/cli/dist/interview/types.d.ts

@@ -0,0 +1,46 @@
+export interface StackDetection {
+    manifest: string | null;
+    stackProfile: 'typescript-node' | 'generic';
+    label: string;
+    files: string[];
+}
+export declare const MANIFEST_MAP: Record<string, {
+    stackProfile: StackDetection['stackProfile'];
+    label: string;
+}>;
+export declare const SOURCE_EXTENSIONS: Set<string>;
+export declare function detectStack(root: string): StackDetection;
+export type ProjectType = 'web-app' | 'api' | 'cli' | 'library' | 'desktop' | 'mobile' | 'other';
+export type UserLevel = 'beginner' | 'intermediate' | 'advanced';
+export interface InterviewState {
+    /** Current interview phase */
+    phase: 'opening' | 'vision' | 'people' | 'features' | 'constraints' | 'boundaries' | 'review';
+    /** All collected answers keyed by question id */
+    answers: Record<string, string | string[]>;
+    /** Stack detected from the project directory */
+    detectedStack: StackDetection;
+    /** Project type resolved during the Vision phase */
+    projectType: ProjectType;
+    /** User's self-reported knowledge level (set during opening phase) */
+    userLevel: UserLevel;
+    /** Detected locale code (e.g. 'pt-BR', 'en-US') */
+    locale: string;
+}
+export interface PhaseEvaluation {
+    /** Quality score 0-10 for the specifications collected so far */
+    score: number;
+    /** Identified gaps in the collected information */
+    gaps: string[];
+    /** Follow-up questions generated by the LLM to fill the gaps */
+    followUpQuestions: Array<{
+        id: string;
+        prompt: string;
+        type: 'string' | 'multiline' | 'choice';
+        choices?: string[];
+    }>;
+    /** LLM's reasoning for the score */
+    reasoning: string;
+}
+export interface SuggestionEngine {
+    suggest(questionId: string, state: InterviewState): string | string[];
+}