hardness 1.0.0 → 1.1.2

package/packages/cli/dist/generators/prd-generator.d.ts

@@ -0,0 +1,14 @@
+import type { InterviewState } from '../interview/types.js';
+export interface PrdGeneratorOptions {
+    /** Absolute path to write PRD.md. Defaults to cwd/PRD.md. */
+    outputPath?: string;
+    /** ISO date string to stamp in the header. Defaults to today. */
+    date?: string;
+    /** Override templates dir (for testing). */
+    templatesDir?: string;
+}
+/**
+ * Renders PRD.md from an InterviewState and writes it to disk.
+ * Returns the rendered markdown string.
+ */
+export declare function generatePrd(state: InterviewState, options?: PrdGeneratorOptions): string;

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

@@ -0,0 +1,164 @@
+import fs from 'fs';
+import path from 'path';
+// ---------------------------------------------------------------------------
+// Helper: resolve the templates/ directory relative to this package
+// ---------------------------------------------------------------------------
+function findTemplatesDir() {
+    // When running from dist/, go up to the package root then to templates/
+    // In source (tests): packages/cli/src/generators/ → up 3 → project root
+    // In dist: packages/cli/dist/generators/ → up 3 → project root
+    const candidates = [];
+    // Walk up from __filename looking for templates/PRD-TEMPLATE.md
+    let dir = path.dirname(new URL(import.meta.url).pathname);
+    // On Windows, pathname starts with /D:/...; normalize
+    if (process.platform === 'win32' && dir.startsWith('/')) {
+        dir = dir.slice(1);
+    }
+    for (let i = 0; i < 6; i++) {
+        const candidate = path.join(dir, 'templates', 'PRD-TEMPLATE.md');
+        if (fs.existsSync(candidate)) {
+            candidates.push(path.join(dir, 'templates'));
+            break;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    if (candidates.length > 0)
+        return candidates[0];
+    // Fallback: use HARDNESS_ROOT if set, then cwd
+    const envRoot = process.env.HARDNESS_ROOT ?? process.cwd();
+    return path.join(envRoot, 'templates');
+}
+// ---------------------------------------------------------------------------
+// Technical level label
+// ---------------------------------------------------------------------------
+const TECH_LEVEL_LABELS = {
+    '1': 'Non-technical',
+    '2': 'Semi-technical',
+    '3': 'Technical',
+    'Non-technical': 'Non-technical',
+    'Semi-technical': 'Semi-technical',
+    'Technical': 'Technical',
+};
+// ---------------------------------------------------------------------------
+// Priority label
+// ---------------------------------------------------------------------------
+const PRIORITY_LABELS = {
+    '1': 'must',
+    '2': 'should',
+    '3': 'nice-to-have',
+};
+/**
+ * Renders PRD.md from an InterviewState and writes it to disk.
+ * Returns the rendered markdown string.
+ */
+export function generatePrd(state, options = {}) {
+    const date = options.date ?? new Date().toISOString().slice(0, 10);
+    const outputPath = options.outputPath ?? path.join(process.cwd(), 'PRD.md');
+    // Read template (for structure validation; we render our own content)
+    const templatesDir = options.templatesDir ?? findTemplatesDir();
+    const templatePath = path.join(templatesDir, 'PRD-TEMPLATE.md');
+    if (!fs.existsSync(templatePath)) {
+        throw new Error(`PRD-TEMPLATE.md not found at: ${templatePath}`);
+    }
+    const projectName = state.answers['q1.1'] ?? 'Unnamed Project';
+    const oneLiner = state.answers['q1.2'] ?? '';
+    const problem = state.answers['q1.3'] ?? '';
+    const primaryPersona = state.answers['q2.1'] ?? 'user';
+    const secondaryPersonas = state.answers['q2.2'] ?? '';
+    const techLevelRaw = state.answers['q2.3'] ?? '2';
+    const techLevel = TECH_LEVEL_LABELS[techLevelRaw.split(/[\s—]/)[0].trim()] ?? techLevelRaw;
+    const features = state.answers['q3.1'];
+    const priorityRaw = state.answers['q3.2'] ?? '1';
+    const priorityKey = priorityRaw.split(/[\s—]/)[0].trim();
+    const priority = PRIORITY_LABELS[priorityKey] ?? 'must';
+    const acceptance = state.answers['q3.3'] ?? '';
+    const stack = state.detectedStack.label;
+    const database = state.answers['q4.3'] ?? 'N/A';
+    const auth = state.answers['q4.4'] ?? 'N/A';
+    const scale = state.answers['q4.5'] ?? 'N/A';
+    const deploy = state.answers['q4.6'] ?? 'N/A';
+    const performance = state.answers['q4.7'] ?? 'N/A';
+    const observability = state.answers['q4.8'] ?? 'N/A';
+    const outOfScope = state.answers['q5.1'];
+    const assumptions = state.answers['q5.2'] ?? '';
+    const risks = state.answers['q5.3'] ?? '';
+    // --- Sections ---
+    const problemText = Array.isArray(problem) ? problem.join('\n') : problem;
+    // Functional requirements
+    const featureList = Array.isArray(features) ? features : [features];
+    const frLines = featureList
+        .filter(Boolean)
+        .map((f, idx) => `- **FR-${String(idx + 1).padStart(3, '0')}** (${priority}): ${f}`)
+        .join('\n');
+    const acceptanceLine = acceptance
+        ? `  - Acceptance: ${acceptance}`
+        : '';
+    // Out of scope
+    const scopeList = Array.isArray(outOfScope) ? outOfScope : [outOfScope];
+    const scopeLines = scopeList
+        .filter(Boolean)
+        .map((s) => `- ${s}`)
+        .join('\n');
+    // Personas table
+    const personaRows = [
+        `| ${primaryPersona} | ${techLevel} | Core product needs |`,
+    ];
+    if (secondaryPersonas) {
+        secondaryPersonas.split(',').forEach((p) => {
+            const name = p.trim();
+            if (name)
+                personaRows.push(`| ${name} | Technical | Support / maintenance |`);
+        });
+    }
+    const md = `# PRD — ${projectName}
+
+> Generated by \`hardness discover\` on ${date}.
+> This document is the input for \`hardness spec\`.
+
+## 1. Overview
+
+${oneLiner}
+
+${problemText}
+
+## 2. Personas
+
+| Persona | Description | Needs |
+|---|---|---|
+${personaRows.join('\n')}
+
+## 3. Functional Requirements
+
+${frLines}
+${acceptanceLine ? acceptanceLine : ''}
+
+## 4. Non-Functional Requirements
+
+- **NFR-001**: Stack — ${stack}
+- **NFR-002**: Database — ${database}
+- **NFR-003**: Authentication — ${auth}
+- **NFR-004**: Scale — ${scale}
+- **NFR-005**: Deployment — ${deploy}
+- **NFR-006**: Performance — ${performance}
+- **NFR-007**: Observability — ${observability}
+
+## 5. Out of Scope (v1.0)
+
+${scopeLines || '- (none specified)'}
+
+## 6. Product Acceptance Criteria
+
+- [ ] ${acceptance || 'All core features work end-to-end without errors and are covered by tests.'}
+
+## 7. Assumptions and Risks
+
+- **Assumptions**: ${assumptions || 'Standard runtime environment.'}
+- **Risks**: ${risks || 'Scope may grow — strict sprint discipline required.'} — Mitigate with clear acceptance criteria per feature.
+`;
+    fs.writeFileSync(outputPath, md, 'utf-8');
+    return md;
+}
+//# sourceMappingURL=prd-generator.js.map

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

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

package/packages/cli/dist/generators/spec-generator.d.ts

@@ -0,0 +1,35 @@
+export interface ParsedPrd {
+    projectName: string;
+    overview: string;
+    personas: string[];
+    functionalReqs: Array<{
+        id: string;
+        priority: string;
+        description: string;
+    }>;
+    nfrStack: string;
+    nfrDatabase: string;
+    nfrAuth: string;
+    nfrScale: string;
+    nfrDeploy: string;
+    nfrPerf: string;
+    nfrObs: string;
+    outOfScope: string[];
+    acceptanceCriteria: string[];
+    assumptions: string;
+    risks: string;
+}
+export declare function parsePrd(content: string): ParsedPrd;
+export interface SpecGeneratorOptions {
+    /** Absolute path to write SPEC.md. Defaults to cwd/SPEC.md. */
+    outputPath?: string;
+    /** ISO date string. Defaults to today. */
+    date?: string;
+    /** Override templates dir (for testing). */
+    templatesDir?: string;
+}
+/**
+ * Reads PRD.md content, parses it, and renders SPEC.md.
+ * Returns the rendered markdown string.
+ */
+export declare function generateSpec(prdContent: string, options?: SpecGeneratorOptions): string;

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

@@ -0,0 +1,245 @@
+import fs from 'fs';
+import path from 'path';
+// ---------------------------------------------------------------------------
+// Template resolution (same pattern as prd-generator)
+// ---------------------------------------------------------------------------
+function findTemplatesDir() {
+    let dir = path.dirname(new URL(import.meta.url).pathname);
+    if (process.platform === 'win32' && dir.startsWith('/'))
+        dir = dir.slice(1);
+    for (let i = 0; i < 6; i++) {
+        const candidate = path.join(dir, 'templates', 'SPEC-TEMPLATE.md');
+        if (fs.existsSync(candidate))
+            return path.join(dir, 'templates');
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    const envRoot = process.env.HARDNESS_ROOT ?? process.cwd();
+    return path.join(envRoot, 'templates');
+}
+export function parsePrd(content) {
+    const lines = content.split('\n');
+    // Project name from h1
+    const h1Line = lines.find((l) => l.startsWith('# PRD —'));
+    const projectName = h1Line ? h1Line.replace('# PRD —', '').trim() : 'Unknown Project';
+    // Helper: extract a section's content (between two ## headers)
+    function extractSection(header) {
+        const startIdx = lines.findIndex((l) => l.startsWith(`## ${header}`));
+        if (startIdx === -1)
+            return [];
+        const result = [];
+        for (let i = startIdx + 1; i < lines.length; i++) {
+            if (lines[i].startsWith('## '))
+                break;
+            result.push(lines[i]);
+        }
+        return result;
+    }
+    // Overview
+    const overviewLines = extractSection('1. Overview').filter((l) => l.trim());
+    const overview = overviewLines.join('\n').trim();
+    // Personas (extract from table rows, skip header and separator)
+    const personaLines = extractSection('2. Personas')
+        .filter((l) => l.startsWith('|') && !l.includes('---|'))
+        .slice(1); // skip column header
+    const personas = personaLines
+        .map((l) => l.split('|')[1]?.trim())
+        .filter(Boolean);
+    // Functional Requirements
+    const frLines = extractSection('3. Functional Requirements').filter((l) => l.startsWith('- **FR-'));
+    const functionalReqs = frLines.map((l) => {
+        const match = l.match(/\*\*(FR-\d+)\*\*\s*\(([^)]+)\):\s*(.*)/);
+        if (match)
+            return { id: match[1], priority: match[2], description: match[3].trim() };
+        return { id: 'FR-???', priority: 'must', description: l };
+    });
+    // NFRs
+    const nfrLines = extractSection('4. Non-Functional Requirements');
+    const getNfr = (key) => {
+        const line = nfrLines.find((l) => l.includes(key));
+        if (!line)
+            return 'N/A';
+        const idx = line.indexOf('—');
+        return idx !== -1 ? line.slice(idx + 1).trim() : line.replace(/.*:/, '').trim();
+    };
+    const nfrStack = getNfr('Stack');
+    const nfrDatabase = getNfr('Database');
+    const nfrAuth = getNfr('Authentication');
+    const nfrScale = getNfr('Scale');
+    const nfrDeploy = getNfr('Deployment');
+    const nfrPerf = getNfr('Performance');
+    const nfrObs = getNfr('Observability');
+    // Out of scope
+    const outOfScope = extractSection('5. Out of Scope')
+        .filter((l) => l.startsWith('- '))
+        .map((l) => l.slice(2).trim());
+    // Acceptance criteria
+    const acceptanceCriteria = extractSection('6. Product Acceptance Criteria')
+        .filter((l) => l.startsWith('- [ ]'))
+        .map((l) => l.replace('- [ ]', '').trim());
+    // Assumptions + risks
+    const assRiskLines = extractSection('7. Assumptions and Risks');
+    const assumptionsLine = assRiskLines.find((l) => l.startsWith('- **Assumptions**'));
+    const risksLine = assRiskLines.find((l) => l.startsWith('- **Risks**'));
+    const assumptions = assumptionsLine
+        ? assumptionsLine.replace('- **Assumptions**:', '').trim()
+        : '';
+    const risks = risksLine ? risksLine.replace('- **Risks**:', '').trim() : '';
+    return {
+        projectName,
+        overview,
+        personas,
+        functionalReqs,
+        nfrStack,
+        nfrDatabase,
+        nfrAuth,
+        nfrScale,
+        nfrDeploy,
+        nfrPerf,
+        nfrObs,
+        outOfScope,
+        acceptanceCriteria,
+        assumptions,
+        risks,
+    };
+}
+// ---------------------------------------------------------------------------
+// FR → technical requirement mapping
+// ---------------------------------------------------------------------------
+function mapFrToTechReqs(fr) {
+    // Each FR becomes at least one tech requirement.
+    // Must-have FRs get an implementation + test requirement.
+    const reqs = [];
+    let idx = 1;
+    for (const f of fr) {
+        reqs.push(`${idx}. Implement **${f.id}** (${f.priority}): ${f.description}`);
+        idx++;
+        if (f.priority === 'must') {
+            reqs.push(`${idx}. Write tests for ${f.id}: cover happy path, edge cases, and error handling`);
+            idx++;
+        }
+    }
+    return reqs;
+}
+/**
+ * Reads PRD.md content, parses it, and renders SPEC.md.
+ * Returns the rendered markdown string.
+ */
+export function generateSpec(prdContent, options = {}) {
+    const date = options.date ?? new Date().toISOString().slice(0, 10);
+    const outputPath = options.outputPath ?? path.join(process.cwd(), 'SPEC.md');
+    // Validate that the template exists
+    const templatesDir = options.templatesDir ?? findTemplatesDir();
+    const templatePath = path.join(templatesDir, 'SPEC-TEMPLATE.md');
+    if (!fs.existsSync(templatePath)) {
+        throw new Error(`SPEC-TEMPLATE.md not found at: ${templatePath}`);
+    }
+    const prd = parsePrd(prdContent);
+    const techReqs = mapFrToTechReqs(prd.functionalReqs);
+    // Detect stack profile from NFRs
+    const stackLine = prd.nfrStack.toLowerCase();
+    const isNode = stackLine.includes('node') || stackLine.includes('typescript');
+    const isPython = stackLine.includes('python');
+    const isGo = stackLine.includes('go');
+    const isRust = stackLine.includes('rust');
+    const testFramework = isNode
+        ? 'Vitest'
+        : isPython
+            ? 'pytest'
+            : isGo
+                ? 'go test'
+                : isRust
+                    ? 'cargo test'
+                    : 'Unit tests';
+    // Personas section
+    const personaRows = prd.personas.length
+        ? prd.personas.map((p) => `| ${p} | Core persona | Product requirements |`).join('\n')
+        : '| user | Primary user | Core functionality |';
+    // Module table: one row per must-have FR
+    const mustFrs = prd.functionalReqs.filter((f) => f.priority === 'must');
+    const moduleRows = mustFrs.length
+        ? mustFrs
+            .map((f) => `| \`${f.description.split(' ').slice(0, 3).join('-').toLowerCase()}\` | ${f.description} |`)
+            .join('\n')
+        : '| `core` | Core module |';
+    // Out of scope
+    const outLines = prd.outOfScope.length
+        ? prd.outOfScope.map((s) => `- ${s}`).join('\n')
+        : '- (none specified)';
+    // Technical requirements numbered list
+    const techReqsBlock = techReqs.join('\n');
+    const md = `# SPEC — ${prd.projectName}
+
+> Generated by \`hardness spec\` on ${date} from PRD.md.
+> This document is the input for \`hardness plan\`. The \`specLines\` in each feature reference lines from this file.
+
+## 1. Architectural Vision
+
+${prd.overview || 'See PRD.md for the product vision.'}
+
+\`\`\`
+${prd.projectName}
++-- Core features: ${mustFrs.map((f) => f.description).join(', ')}
++-- Stack: ${prd.nfrStack}
+\`\`\`
+
+## 2. Tech Stack
+
+- **Language / Runtime**: ${prd.nfrStack}
+- **Tests**: ${testFramework}
+- **Database**: ${prd.nfrDatabase}
+- **Authentication**: ${prd.nfrAuth}
+- **Deployment**: ${prd.nfrDeploy}
+- **Scale**: ${prd.nfrScale}
+- **Performance**: ${prd.nfrPerf}
+- **Observability**: ${prd.nfrObs}
+
+## 3. Modules / Packages
+
+| Module | Responsibility |
+|---|---|
+${moduleRows}
+
+## 4. Data Model
+
+${prd.personas.length ? `Personas: ${prd.personas.join(', ')}.` : 'See PRD.md for personas.'}
+
+${prd.functionalReqs.length
+        ? `Entities implied by functional requirements:\n${prd.functionalReqs
+            .filter((f) => f.priority === 'must')
+            .map((f) => `- **${f.id}**: ${f.description}`)
+            .join('\n')}`
+        : ''}
+
+## 5. Main Flows
+
+${prd.functionalReqs
+        .filter((f) => f.priority === 'must')
+        .map((f, i) => `### 5.${i + 1} ${f.description}
+1. Trigger the ${f.description.toLowerCase()} flow
+2. Validate inputs and apply business rules
+3. Persist changes and return result`)
+        .join('\n\n')}
+
+## 6. Integration Contracts
+
+- **Out of scope (v1.0)**: ${prd.outOfScope.join('; ') || 'None specified'}
+- **Assumptions**: ${prd.assumptions || 'Standard runtime environment'}
+- **Risks**: ${prd.risks || 'See PRD.md'}
+
+## 7. Detailed Technical Requirements
+
+(The lines below will be referenced by \`specLines\` in the sprints.)
+
+${techReqsBlock}
+
+### Out of Scope
+
+${outLines}
+`;
+    fs.writeFileSync(outputPath, md, 'utf-8');
+    return md;
+}
+//# sourceMappingURL=spec-generator.js.map

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

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

package/packages/cli/dist/generators/sprint-generator.d.ts

@@ -0,0 +1,51 @@
+export interface TechRequirement {
+    /** 1-indexed position in section 7 */
+    index: number;
+    /** Full text of the requirement (without leading "N. ") */
+    text: string;
+}
+export declare function parseSpec(content: string): {
+    projectName: string;
+    techReqs: TechRequirement[];
+    stack: string;
+};
+export interface GeneratedFeature {
+    id: string;
+    title: string;
+    description: string;
+    specLines: string;
+    status: 'pending';
+    files: string[];
+    acceptanceCriteria: string[];
+    hints: string[];
+    verification: {
+        typecheck: boolean;
+        smoke: {
+            command: string;
+            executedBy: string;
+            timeoutSeconds: number;
+        };
+    };
+}
+export interface GeneratedSprint {
+    index: number;
+    name: string;
+    status: 'pending';
+    description: string;
+    crossCutting: string[];
+    features: GeneratedFeature[];
+}
+export interface SprintGeneratorOptions {
+    /** Directory where sprint JSON files will be written. Defaults to .hardness/sprints/ relative to root. */
+    sprintsDir?: string;
+    /** Project root to locate .hardness/. */
+    root?: string;
+    /** Dry run — return sprints without writing files. */
+    dryRun?: boolean;
+}
+export interface SprintGeneratorResult {
+    sprints: GeneratedSprint[];
+    indexJson: object;
+    sprintFiles: string[];
+}
+export declare function generateSprints(specContent: string, options?: SprintGeneratorOptions): SprintGeneratorResult;