hardness 1.0.0 → 1.1.2

package/packages/cli/dist/generators/sprint-generator.js

@@ -0,0 +1,162 @@
+import fs from 'fs';
+import path from 'path';
+export function parseSpec(content) {
+    const lines = content.split('\n');
+    // Project name from h1
+    const h1 = lines.find((l) => l.startsWith('# SPEC —'));
+    const projectName = h1 ? h1.replace('# SPEC —', '').trim() : 'Unknown Project';
+    // Stack from section 2
+    const stackLine = lines.find((l) => l.includes('**Language / Runtime**') || l.includes('**Language**'));
+    const stack = stackLine ? stackLine.replace(/.*?—/, '').trim() : 'Node.js / TypeScript';
+    // Technical requirements from section 7
+    const sec7Start = lines.findIndex((l) => l.startsWith('## 7. Detailed Technical Requirements'));
+    const techReqs = [];
+    if (sec7Start !== -1) {
+        let idx = 1;
+        for (let i = sec7Start + 1; i < lines.length; i++) {
+            const line = lines[i];
+            if (line.startsWith('## '))
+                break; // next section
+            // Match "N. text" or "N) text"
+            const match = line.match(/^\d+[.)]\s+(.+)/);
+            if (match) {
+                techReqs.push({ index: idx++, text: match[1].trim() });
+            }
+        }
+    }
+    return { projectName, techReqs, stack };
+}
+// ---------------------------------------------------------------------------
+// Sprint builder
+// ---------------------------------------------------------------------------
+/** How many features to group per sprint (2-4) */
+const FEATURES_PER_SPRINT = 3;
+function deriveFilesFromReq(text, projectName) {
+    // Heuristic: look for file paths in the requirement text
+    const files = [];
+    const fileMatch = text.match(/`([^`]+\.[a-z]+)`/g);
+    if (fileMatch) {
+        fileMatch.forEach((m) => files.push(m.replace(/`/g, '')));
+    }
+    if (files.length === 0) {
+        // Default: derive a plausible file from the requirement text
+        const slug = text
+            .toLowerCase()
+            .replace(/[^a-z0-9\s]/g, '')
+            .split(/\s+/)
+            .slice(0, 4)
+            .join('-');
+        files.push(`src/${slug}.ts`);
+    }
+    return [...new Set(files)];
+}
+function buildFeature(req, featId) {
+    const files = deriveFilesFromReq(req.text, '');
+    // Determine if this is a test requirement
+    const isTest = req.text.toLowerCase().includes('test') || req.text.toLowerCase().includes('write tests');
+    const acceptance = [
+        `${req.text} is implemented correctly`,
+        'npm run build compiles without errors',
+        'npm test passes',
+    ];
+    const hints = [
+        `Section 7, requirement ${req.index} in SPEC.md`,
+    ];
+    if (isTest) {
+        hints.push('Use HARDNESS_ROOT env var pattern for fixture directories in tests');
+        acceptance[0] = `Tests for ${req.text.replace(/^Write tests for\s*/i, '')} cover all edge cases`;
+    }
+    return {
+        id: featId,
+        title: req.text.length > 60 ? req.text.slice(0, 57) + '...' : req.text,
+        description: req.text,
+        specLines: `${req.index}`,
+        status: 'pending',
+        files,
+        acceptanceCriteria: acceptance,
+        hints,
+        verification: {
+            typecheck: true,
+            smoke: {
+                command: 'npm test',
+                executedBy: 'workflow',
+                timeoutSeconds: 60,
+            },
+        },
+    };
+}
+export function generateSprints(specContent, options = {}) {
+    const root = options.root ?? process.env.HARDNESS_ROOT ?? process.cwd();
+    const sprintsDir = options.sprintsDir ?? path.join(root, '.hardness', 'sprints');
+    const { projectName, techReqs, stack } = parseSpec(specContent);
+    if (techReqs.length === 0) {
+        throw new Error('No technical requirements found in SPEC.md section 7. ' +
+            'Make sure section 7 has numbered requirements (e.g. "1. ...").');
+    }
+    // Group requirements into sprints of FEATURES_PER_SPRINT each
+    const sprints = [];
+    const chunks = [];
+    for (let i = 0; i < techReqs.length; i += FEATURES_PER_SPRINT) {
+        chunks.push(techReqs.slice(i, i + FEATURES_PER_SPRINT));
+    }
+    const stackLabel = stack.toLowerCase().includes('node')
+        ? 'TypeScript strict mode, ESM, no console.log in production code'
+        : stack.toLowerCase().includes('python')
+            ? 'Python 3.10+, type hints required, no print() in production code'
+            : 'Strict types, no debug output in production code';
+    chunks.forEach((chunk, sprintIdx) => {
+        const sprintNum = String(sprintIdx + 1).padStart(2, '0');
+        const features = chunk.map((req, featIdx) => {
+            const featNum = String(sprintIdx * FEATURES_PER_SPRINT + featIdx + 1).padStart(3, '0');
+            return buildFeature(req, `feat-${featNum}`);
+        });
+        sprints.push({
+            index: sprintIdx,
+            name: `Sprint ${sprintNum} — ${chunk[0].text.slice(0, 40)}`,
+            status: 'pending',
+            description: `Technical requirements ${chunk[0].index}–${chunk[chunk.length - 1].index} from SPEC.md.`,
+            crossCutting: [
+                'All new code must have tests (vitest or equivalent)',
+                stackLabel,
+                'No new runtime dependencies without review',
+            ],
+            features,
+        });
+    });
+    // Build index.json
+    const indexJson = {
+        projectName,
+        specPath: 'SPEC.md',
+        totalSprints: sprints.length,
+        schemaVersion: 1,
+        description: `Sprint plan generated by \`hardness plan\` from SPEC.md.`,
+        sprints: sprints.map((s, i) => ({
+            index: i,
+            file: `${String(i + 1).padStart(2, '0')}-${s.name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/-+$/, '')}.json`,
+            name: s.name,
+            status: 'pending',
+            featuresCount: s.features.length,
+        })),
+    };
+    const sprintFiles = indexJson.sprints.map((e) => e.file);
+    if (!options.dryRun) {
+        // Ensure sprints dir exists
+        if (!fs.existsSync(sprintsDir)) {
+            fs.mkdirSync(sprintsDir, { recursive: true });
+        }
+        // Write each sprint file
+        sprints.forEach((sprint, i) => {
+            const fileName = sprintFiles[i];
+            const filePath = path.join(sprintsDir, fileName);
+            fs.writeFileSync(filePath, JSON.stringify(sprint, null, 2), 'utf-8');
+        });
+        // Write index
+        const indexPath = path.join(sprintsDir, '00-index.json');
+        fs.writeFileSync(indexPath, JSON.stringify(indexJson, null, 2), 'utf-8');
+        // Set current.txt to first sprint
+        const currentPath = path.join(path.dirname(sprintsDir), 'current.txt');
+        fs.writeFileSync(currentPath, sprintFiles[0], 'utf-8');
+    }
+    return { sprints, indexJson, sprintFiles };
+}
+//# sourceMappingURL=sprint-generator.js.map

package/packages/cli/dist/generators/sprint-generator.js.map

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

package/packages/cli/dist/index.js

@@ -18,7 +18,7 @@ export function buildCli() {
     program
         .name('hardness')
         .description('Hardness — Universal Agentic Development Harness')
-        .version('1.0.0');
+        .version('1.1.0');
     initCommand(program);
     validateCommand(program);
     scoreCommand(program);

package/packages/cli/dist/interview/evaluator-prompt.d.ts

@@ -0,0 +1,9 @@
+import type { UserLevel } from './types.js';
+import type { Question } from './questions.js';
+export declare function buildTranslationPrompt(locale: string, questions: Array<{
+    id: string;
+    prompt: string;
+    choices?: string[];
+}>): string;
+export declare function buildEvaluationPrompt(phase: string, userLevel: UserLevel, locale: string, answers: Record<string, string | string[]>, allQuestions: Question[], detectedStack: string): string;
+export declare function buildPrdGenerationPrompt(allAnswers: Record<string, string | string[]>, userLevel: UserLevel, locale: string, detectedStack: string, projectName: string): string;

package/packages/cli/dist/interview/evaluator-prompt.js

@@ -0,0 +1,192 @@
+// Evaluator prompts for the interview specialist agent.
+// These are sent to the user's LLM (via agentCommand) for:
+// 1. Translating questions to the user's locale
+// 2. Evaluating phase completeness and generating follow-up questions
+// 3. Generating the final PRD document
+// ---------------------------------------------------------------------------
+// Jargon-free language rules (embedded in all prompts that generate content
+// for beginners)
+// ---------------------------------------------------------------------------
+const BEGINNER_LANGUAGE_RULES = `
+CRITICAL LANGUAGE RULES FOR BEGINNER LEVEL:
+- Use ZERO technical jargon. No words like: frontend, backend, API, database,
+  deploy, framework, authentication, endpoint, container, serverless, OAuth,
+  throughput, observability, metrics, tracing, schema, migration, middleware,
+  SDK, repository, runtime, dependency, package, module, component, hook,
+  state management, CI/CD, DevOps, microservice, monolith, REST, GraphQL,
+  WebSocket, token, hash, encryption, SSL, DNS, load balancer, cache.
+- Write as if talking to someone who has never opened a code editor.
+- Explain concepts through their purpose, not their technical name.
+  Example: say "where your system saves information" instead of "database".
+  Example: say "how people sign in" instead of "authentication strategy".
+  Example: say "where your system will run so people can access it" instead of "deployment target".
+`;
+const INTERMEDIATE_LANGUAGE_RULES = `
+LANGUAGE RULES FOR INTERMEDIATE LEVEL:
+- Basic technical terms are allowed (e.g., "database", "login", "server", "hosting").
+- Avoid acronyms and specific tool names without context.
+  Example: say "a database like PostgreSQL or MongoDB" instead of just "PostgreSQL".
+  Example: say "hosting service like Heroku or Render" instead of "PaaS".
+`;
+const ADVANCED_LANGUAGE_RULES = `
+LANGUAGE RULES FOR ADVANCED LEVEL:
+- Use direct technical language. Name tools, frameworks, and concepts as they are.
+- Be concise. Skip explanations of well-known concepts.
+`;
+function languageRulesFor(level) {
+    switch (level) {
+        case 'beginner': return BEGINNER_LANGUAGE_RULES;
+        case 'intermediate': return INTERMEDIATE_LANGUAGE_RULES;
+        case 'advanced': return ADVANCED_LANGUAGE_RULES;
+    }
+}
+// ---------------------------------------------------------------------------
+// 1. Translation prompt
+// ---------------------------------------------------------------------------
+export function buildTranslationPrompt(locale, questions) {
+    return `You are a professional translator. Translate the following interview questions from English to the locale "${locale}".
+
+RULES:
+- Translate naturally, not word-for-word. Adapt idioms and phrasing to sound native.
+- Keep the same tone (friendly, conversational).
+- Preserve all placeholder markers like (?) and formatting instructions.
+- For choice questions, translate each choice option.
+- Do NOT translate question IDs.
+
+INPUT (JSON array of questions):
+${JSON.stringify(questions, null, 2)}
+
+OUTPUT FORMAT — return ONLY a valid JSON array with the same structure:
+[
+  {
+    "id": "<same id>",
+    "prompt": "<translated prompt>",
+    "choices": ["<translated choice 1>", "<translated choice 2>", ...]
+  }
+]
+
+Return ONLY the JSON array, no explanation, no markdown fences.`;
+}
+// ---------------------------------------------------------------------------
+// 2. Phase evaluation prompt
+// ---------------------------------------------------------------------------
+export function buildEvaluationPrompt(phase, userLevel, locale, answers, allQuestions, detectedStack) {
+    const langRules = languageRulesFor(userLevel);
+    return `You are a specialist PRD (Product Requirements Document) evaluator. Your job is to assess the quality and completeness of information collected during a product discovery interview.
+
+## Context
+- Current phase: "${phase}"
+- User level: "${userLevel}" (${userLevel === 'beginner' ? 'never programmed before' : userLevel === 'intermediate' ? 'some programming experience' : 'professional developer'})
+- User locale: "${locale}"
+- Detected stack: "${detectedStack}"
+
+## Answers collected so far
+${JSON.stringify(answers, null, 2)}
+
+## Questions asked in this phase
+${JSON.stringify(allQuestions.filter(q => q.phase === phase).map(q => ({ id: q.id, prompt: q.prompt })), null, 2)}
+
+## Your task
+
+1. **Score** the completeness of the specifications collected for this phase on a scale of 0-10:
+   - 0-3: Critical information is missing
+   - 4-6: Some important details are missing
+   - 7-8: Mostly complete, minor gaps
+   - 9-10: Excellent, all important aspects covered
+
+2. **Identify gaps**: What important information is still missing?
+
+3. **Generate follow-up questions** (ONLY if score < 9): Create 1-3 follow-up questions to fill the gaps.
+
+${langRules}
+
+## Follow-up question rules
+- Questions MUST be in the locale "${locale}" (translate if not English)
+- Questions MUST respect the user level language rules above
+- Each question must have a unique ID in the format "q{phase}.extra.{n}" (e.g., "q1.extra.1")
+- Each question must have a type: "string", "multiline", or "choice"
+- For "choice" type, provide a "choices" array
+
+## Output format — return ONLY valid JSON:
+{
+  "score": <number 0-10>,
+  "gaps": ["<gap description 1>", "<gap description 2>"],
+  "followUpQuestions": [
+    {
+      "id": "q${phase}.extra.1",
+      "prompt": "<question text in the user's locale>",
+      "type": "string" | "multiline" | "choice",
+      "choices": ["<option1>", "<option2>"] // only for type "choice"
+    }
+  ],
+  "reasoning": "<brief explanation of the score>"
+}
+
+Return ONLY the JSON object, no explanation, no markdown fences.`;
+}
+// ---------------------------------------------------------------------------
+// 3. PRD generation prompt
+// ---------------------------------------------------------------------------
+export function buildPrdGenerationPrompt(allAnswers, userLevel, locale, detectedStack, projectName) {
+    return `You are a specialist PRD (Product Requirements Document) writer. Generate a professional PRD document in Markdown format based on the interview answers provided.
+
+## CRITICAL RULES — FOLLOW EXACTLY
+1. Use ONLY information from the answers below. Do NOT invent features, personas, requirements, or technical details that were not mentioned.
+2. If information for a section is missing, write "To be determined." — do NOT make up content.
+3. The PRD must be in English regardless of the interview language.
+4. Follow the EXACT template structure below.
+5. Every Functional Requirement must have a priority: (must), (should), or (could).
+6. Non-Functional Requirements must be specific and measurable when possible.
+
+## Interview answers
+${JSON.stringify(allAnswers, null, 2)}
+
+## Additional context
+- Project name: "${projectName}"
+- User level: "${userLevel}"
+- Detected stack: "${detectedStack}"
+- Interview locale: "${locale}"
+
+## PRD Template — follow this structure EXACTLY
+
+# PRD — ${projectName}
+
+> Product Requirements Document for ${projectName}.
+> Generated by \`hardness discover\`.
+
+## 1. Overview
+
+<Write 2-3 paragraphs based on q0.1 (free text), q1.2 (one-liner), and q1.3 (problem statement). Synthesize into a coherent overview.>
+
+## 2. Personas
+
+| Persona | Description | Needs |
+|---|---|---|
+<One row per persona based on q2.1, q2.2, q2.3. Include the "Next AI agent" persona as the last row.>
+
+## 3. Functional Requirements
+
+<List each feature from q3.1 as a numbered FR with priority from q3.2. Format: "- **FR-NNN** (priority): description">
+
+## 4. Non-Functional Requirements
+
+<Derive from q4.1 through q4.8: stack, frontend, database, auth, scale, deploy, performance, observability. Format: "- **NFR-NNN**: description">
+
+## 5. Out of Scope
+
+<List items from q5.1, one per bullet.>
+
+## 6. Product Acceptance Criteria
+
+<Derive from q3.3 and the functional requirements. Each criterion must be a checkbox: "- [ ] criterion">
+
+## 7. Assumptions and Risks
+
+- **Assumptions**: <from q5.2>
+- **Risks**: <from q5.3>
+
+---
+
+Return ONLY the Markdown content of the PRD. No JSON wrapping, no code fences, no explanation.`;
+}
+//# sourceMappingURL=evaluator-prompt.js.map

package/packages/cli/dist/interview/evaluator-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator-prompt.js","sourceRoot":"","sources":["../../src/interview/evaluator-prompt.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,2DAA2D;AAC3D,gDAAgD;AAChD,sEAAsE;AACtE,uCAAuC;AAKvC,8EAA8E;AAC9E,4EAA4E;AAC5E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;CAa/B,CAAC;AAEF,MAAM,2BAA2B,GAAG;;;;;;CAMnC,CAAC;AAEF,MAAM,uBAAuB,GAAG;;;;CAI/B,CAAC;AAEF,SAAS,gBAAgB,CAAC,KAAgB;IACxC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,UAAU,CAAC,CAAC,OAAO,uBAAuB,CAAC;QAChD,KAAK,cAAc,CAAC,CAAC,OAAO,2BAA2B,CAAC;QACxD,KAAK,UAAU,CAAC,CAAC,OAAO,uBAAuB,CAAC;IAClD,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,UAAU,sBAAsB,CACpC,MAAc,EACd,SAAoE;IAEpE,OAAO,8GAA8G,MAAM;;;;;;;;;;EAU3H,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;;;;;;;;;;;gEAW4B,CAAC;AACjE,CAAC;AAED,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAE9E,MAAM,UAAU,qBAAqB,CACnC,KAAa,EACb,SAAoB,EACpB,MAAc,EACd,OAA0C,EAC1C,YAAwB,EACxB,aAAqB;IAErB,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAE9C,OAAO;;;oBAGW,KAAK;iBACR,SAAS,MAAM,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,SAAS,KAAK,cAAc,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,wBAAwB;kBAC5J,MAAM;qBACH,aAAa;;;EAGhC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;;;EAGhC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;;;;;;;;;;;;;;EAc/G,SAAS;;;qCAG0B,MAAM;;;;;;;;;;;;gBAY3B,KAAK;;;;;;;;;iEAS4C,CAAC;AAClE,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,MAAM,UAAU,wBAAwB,CACtC,UAA6C,EAC7C,SAAoB,EACpB,MAAc,EACd,aAAqB,EACrB,WAAmB;IAEnB,OAAO;;;;;;;;;;;EAWP,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;;;mBAGlB,WAAW;iBACb,SAAS;qBACL,aAAa;uBACX,MAAM;;;;UAInB,WAAW;;sCAEiB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+FAoC8C,CAAC;AAChG,CAAC"}

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

@@ -0,0 +1,46 @@
+import type { InterviewState, PhaseEvaluation } from './types.js';
+import type { Question } from './questions.js';
+export interface TranslatedQuestion {
+    id: string;
+    prompt: string;
+    choices?: string[];
+}
+export interface EvaluatorOptions {
+    /** The agent command template from config.json (e.g. 'claude -p "$(cat {context_file})"') */
+    agentCommand: string;
+    /** Project root directory */
+    projectRoot: string;
+    /** Timeout in seconds for LLM calls */
+    timeout?: number;
+}
+export declare class InterviewEvaluator {
+    private agentCommand;
+    private projectRoot;
+    private timeoutMs;
+    constructor(options: EvaluatorOptions);
+    /**
+     * Sends a prompt to the LLM via agentCommand and returns the raw response.
+     * Writes the prompt to a temp file, substitutes {context_file}, and captures stdout.
+     */
+    private invokeLlm;
+    /**
+     * Extracts JSON from LLM response, handling possible markdown fences.
+     */
+    private extractJson;
+    /**
+     * Translate all questions to the target locale via LLM.
+     */
+    translateQuestions(locale: string, questions: Array<{
+        id: string;
+        prompt: string;
+        choices?: string[];
+    }>): Promise<TranslatedQuestion[]>;
+    /**
+     * Evaluate the completeness of a phase and optionally generate follow-up questions.
+     */
+    evaluatePhase(phase: string, state: InterviewState, allQuestions: Question[]): Promise<PhaseEvaluation>;
+    /**
+     * Generate the final PRD document from all collected answers.
+     */
+    generatePrd(state: InterviewState): Promise<string>;
+}

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

@@ -0,0 +1,142 @@
+// Interview evaluator — invokes the user's LLM (via agentCommand) for:
+// 1. Translating questions to the user's locale
+// 2. Evaluating phase completeness and scoring
+// 3. Generating the final PRD
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { runChecked } from '@hardness/core';
+import { buildTranslationPrompt, buildEvaluationPrompt, buildPrdGenerationPrompt, } from './evaluator-prompt.js';
+// ---------------------------------------------------------------------------
+// Evaluator class
+// ---------------------------------------------------------------------------
+export class InterviewEvaluator {
+    agentCommand;
+    projectRoot;
+    timeoutMs;
+    constructor(options) {
+        this.agentCommand = options.agentCommand;
+        this.projectRoot = options.projectRoot;
+        this.timeoutMs = (options.timeout ?? 120) * 1000;
+    }
+    /**
+     * Sends a prompt to the LLM via agentCommand and returns the raw response.
+     * Writes the prompt to a temp file, substitutes {context_file}, and captures stdout.
+     */
+    async invokeLlm(prompt) {
+        const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'hardness-eval-'));
+        const promptFile = path.join(tmpDir, 'prompt.txt');
+        try {
+            fs.writeFileSync(promptFile, prompt, 'utf-8');
+            const normalizedPath = promptFile.split('\\').join('/');
+            const normalizedCwd = this.projectRoot.split('\\').join('/');
+            const command = this.agentCommand
+                .split('{context_file}').join(normalizedPath)
+                .split('{cwd}').join(normalizedCwd)
+                .split('{timeout}').join(String(Math.floor(this.timeoutMs / 1000)));
+            const result = await runChecked(command, {
+                cwd: this.projectRoot,
+                timeoutMs: this.timeoutMs,
+            });
+            if (result.error) {
+                throw new Error(`LLM invocation failed: ${result.error.message}`);
+            }
+            if (result.code !== 0) {
+                throw new Error(`LLM exited with code ${result.code}: ${result.stderr}`);
+            }
+            return result.stdout.trim();
+        }
+        finally {
+            try {
+                fs.rmSync(tmpDir, { recursive: true, force: true });
+            }
+            catch {
+                // best-effort cleanup
+            }
+        }
+    }
+    /**
+     * Extracts JSON from LLM response, handling possible markdown fences.
+     */
+    extractJson(raw) {
+        // Strip markdown code fences if present
+        const fenceMatch = raw.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+        if (fenceMatch) {
+            return fenceMatch[1].trim();
+        }
+        // Try to find JSON object or array directly
+        const jsonStart = raw.indexOf('{') !== -1 ? raw.indexOf('{') : raw.indexOf('[');
+        const jsonEnd = raw.lastIndexOf('}') !== -1 ? raw.lastIndexOf('}') : raw.lastIndexOf(']');
+        if (jsonStart !== -1 && jsonEnd !== -1 && jsonEnd > jsonStart) {
+            return raw.slice(jsonStart, jsonEnd + 1);
+        }
+        return raw;
+    }
+    /**
+     * Translate all questions to the target locale via LLM.
+     */
+    async translateQuestions(locale, questions) {
+        const prompt = buildTranslationPrompt(locale, questions);
+        const raw = await this.invokeLlm(prompt);
+        const json = this.extractJson(raw);
+        try {
+            const translated = JSON.parse(json);
+            if (!Array.isArray(translated)) {
+                throw new Error('Expected an array of translated questions');
+            }
+            return translated;
+        }
+        catch (e) {
+            throw new Error(`Failed to parse translation response: ${e.message}\nRaw: ${raw.slice(0, 500)}`);
+        }
+    }
+    /**
+     * Evaluate the completeness of a phase and optionally generate follow-up questions.
+     */
+    async evaluatePhase(phase, state, allQuestions) {
+        const prompt = buildEvaluationPrompt(phase, state.userLevel, state.locale, state.answers, allQuestions, state.detectedStack.label);
+        const raw = await this.invokeLlm(prompt);
+        const json = this.extractJson(raw);
+        try {
+            const evaluation = JSON.parse(json);
+            if (typeof evaluation.score !== 'number' || !Array.isArray(evaluation.gaps)) {
+                throw new Error('Invalid evaluation format');
+            }
+            // Ensure followUpQuestions is always an array
+            if (!Array.isArray(evaluation.followUpQuestions)) {
+                evaluation.followUpQuestions = [];
+            }
+            // Cap at 3 follow-up questions
+            evaluation.followUpQuestions = evaluation.followUpQuestions.slice(0, 3);
+            return evaluation;
+        }
+        catch (e) {
+            throw new Error(`Failed to parse evaluation response: ${e.message}\nRaw: ${raw.slice(0, 500)}`);
+        }
+    }
+    /**
+     * Generate the final PRD document from all collected answers.
+     */
+    async generatePrd(state) {
+        const projectName = state.answers['q1.1'] ?? 'Untitled Project';
+        const prompt = buildPrdGenerationPrompt(state.answers, state.userLevel, state.locale, state.detectedStack.label, projectName);
+        const raw = await this.invokeLlm(prompt);
+        // The response should be raw markdown (no JSON wrapping)
+        // Strip markdown fences if present
+        let prd = raw;
+        if (prd.startsWith('```markdown')) {
+            prd = prd.slice('```markdown'.length);
+        }
+        else if (prd.startsWith('```md')) {
+            prd = prd.slice('```md'.length);
+        }
+        else if (prd.startsWith('```')) {
+            prd = prd.slice(3);
+        }
+        if (prd.endsWith('```')) {
+            prd = prd.slice(0, -3);
+        }
+        return prd.trim();
+    }
+}
+//# sourceMappingURL=evaluator.js.map

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

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

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

@@ -0,0 +1,29 @@
+import type { UserLevel } from './types.js';
+export type QuestionPhase = 'opening' | 'vision' | 'people' | 'features' | 'constraints' | 'boundaries' | 'review';
+export type QuestionType = 'string' | 'multiline' | 'choice' | 'action';
+export interface PromptByLevel {
+    beginner: string;
+    intermediate: string;
+    advanced: string;
+}
+export interface Question {
+    id: string;
+    phase: QuestionPhase;
+    prompt: string;
+    type: QuestionType;
+    /** Only for type === 'choice' */
+    choices?: string[];
+    /** Choices adapted per level (only for type === 'choice') */
+    choicesByLevel?: Record<UserLevel, string[]>;
+    /** Key into the SuggestionEngine (used to call suggest(suggestionId, state)) */
+    suggestionId: string;
+    /** Prompt text adapted per user level. Falls back to `prompt` if not set. */
+    promptByLevel?: PromptByLevel;
+}
+/** Get the prompt for a question based on user level */
+export declare function getPromptForLevel(question: Question, level: UserLevel): string;
+/** Get the choices for a question based on user level */
+export declare function getChoicesForLevel(question: Question, level: UserLevel): string[] | undefined;
+export declare const QUESTIONS: Question[];
+/** Questions grouped by phase for easy iteration */
+export declare function questionsByPhase(phase: QuestionPhase): Question[];