superspec 0.1.0

package/dist/core/parsers/spec-parser.js

@@ -0,0 +1,322 @@
+/**
+ * Spec Parser Module
+ *
+ * Parses spec documents into structured data.
+ */
+import matter from 'gray-matter';
+/**
+ * Parse a spec document into structured data
+ */
+export function parseSpec(content) {
+    const { data, content: body } = matter(content);
+    const lines = body.split('\n');
+    const spec = {
+        title: '',
+        requirements: [],
+        metadata: data,
+    };
+    let currentRequirement = null;
+    let currentScenario = null;
+    let inDescription = false;
+    let descriptionLines = [];
+    for (const line of lines) {
+        // Title
+        const titleMatch = line.match(/^# (.+)$/);
+        if (titleMatch?.[1]) {
+            spec.title = titleMatch[1].replace(/\s*Specification\s*$/i, '').trim();
+            continue;
+        }
+        // Purpose
+        const purposeMatch = line.match(/^## Purpose\s*$/);
+        if (purposeMatch) {
+            inDescription = false;
+            continue;
+        }
+        // Requirements section
+        if (line.match(/^## Requirements\s*$/)) {
+            inDescription = false;
+            continue;
+        }
+        // Requirement
+        const reqMatch = line.match(/^### Requirement: (.+)$/);
+        if (reqMatch?.[1]) {
+            // Save previous
+            if (currentRequirement) {
+                if (currentScenario) {
+                    currentRequirement.scenarios.push(currentScenario);
+                }
+                currentRequirement.description = descriptionLines.join('\n').trim();
+                spec.requirements.push(currentRequirement);
+            }
+            currentRequirement = {
+                name: reqMatch[1],
+                description: '',
+                scenarios: [],
+            };
+            currentScenario = null;
+            inDescription = true;
+            descriptionLines = [];
+            continue;
+        }
+        // Scenario
+        const scenarioMatch = line.match(/^#### Scenario: (.+)$/);
+        if (scenarioMatch?.[1]) {
+            // Save previous scenario
+            if (currentScenario && currentRequirement) {
+                currentRequirement.scenarios.push(currentScenario);
+            }
+            if (currentRequirement && inDescription) {
+                currentRequirement.description = descriptionLines.join('\n').trim();
+                inDescription = false;
+            }
+            currentScenario = {
+                name: scenarioMatch[1],
+                when: '',
+                then: [],
+                and: [],
+            };
+            continue;
+        }
+        // WHEN
+        const whenMatch = line.match(/^\s*-\s*\*\*WHEN\*\*\s*(.+)$/);
+        if (whenMatch?.[1] && currentScenario) {
+            currentScenario.when = whenMatch[1];
+            continue;
+        }
+        // THEN
+        const thenMatch = line.match(/^\s*-\s*\*\*THEN\*\*\s*(.+)$/);
+        if (thenMatch?.[1] && currentScenario) {
+            currentScenario.then.push(thenMatch[1]);
+            continue;
+        }
+        // AND
+        const andMatch = line.match(/^\s*-\s*\*\*AND\*\*\s*(.+)$/);
+        if (andMatch?.[1] && currentScenario) {
+            currentScenario.and.push(andMatch[1]);
+            continue;
+        }
+        // Description lines
+        if (inDescription && line.trim()) {
+            descriptionLines.push(line);
+        }
+    }
+    // Don't forget the last ones
+    if (currentRequirement) {
+        if (currentScenario) {
+            currentRequirement.scenarios.push(currentScenario);
+        }
+        if (inDescription) {
+            currentRequirement.description = descriptionLines.join('\n').trim();
+        }
+        spec.requirements.push(currentRequirement);
+    }
+    return spec;
+}
+/**
+ * Parse a delta spec document
+ */
+export function parseDeltaSpec(content) {
+    const delta = {
+        added: [],
+        modified: [],
+        removed: [],
+        renamed: [],
+    };
+    const lines = content.split('\n');
+    let currentSection = null;
+    let currentRequirement = null;
+    let currentScenario = null;
+    let currentRemoved = null;
+    // Helper to save current state before section change
+    const saveCurrentState = () => {
+        if (currentRequirement) {
+            if (currentScenario) {
+                currentRequirement.scenarios.push(currentScenario);
+                currentScenario = null;
+            }
+            if (currentSection === 'added') {
+                delta.added.push(currentRequirement);
+            }
+            else if (currentSection === 'modified') {
+                delta.modified.push(currentRequirement);
+            }
+            currentRequirement = null;
+        }
+        if (currentRemoved) {
+            delta.removed.push(currentRemoved);
+            currentRemoved = null;
+        }
+    };
+    for (const line of lines) {
+        // Section headers - save state before changing section
+        if (line.match(/^## ADDED Requirements/i)) {
+            saveCurrentState();
+            currentSection = 'added';
+            continue;
+        }
+        if (line.match(/^## MODIFIED Requirements/i)) {
+            saveCurrentState();
+            currentSection = 'modified';
+            continue;
+        }
+        if (line.match(/^## REMOVED Requirements/i)) {
+            saveCurrentState();
+            currentSection = 'removed';
+            continue;
+        }
+        if (line.match(/^## RENAMED Requirements/i)) {
+            saveCurrentState();
+            currentSection = 'renamed';
+            continue;
+        }
+        // Requirement
+        const reqMatch = line.match(/^### Requirement: (.+)$/);
+        if (reqMatch?.[1] && currentSection) {
+            // Save previous
+            if (currentRequirement && (currentSection === 'added' || currentSection === 'modified')) {
+                if (currentScenario) {
+                    currentRequirement.scenarios.push(currentScenario);
+                }
+                if (currentSection === 'added') {
+                    delta.added.push(currentRequirement);
+                }
+                else {
+                    delta.modified.push(currentRequirement);
+                }
+            }
+            if (currentRemoved && currentSection === 'removed') {
+                delta.removed.push(currentRemoved);
+            }
+            if (currentSection === 'removed') {
+                currentRemoved = { name: reqMatch[1] };
+                currentRequirement = null;
+            }
+            else {
+                currentRequirement = {
+                    name: reqMatch[1],
+                    description: '',
+                    scenarios: [],
+                };
+                currentRemoved = null;
+            }
+            currentScenario = null;
+            continue;
+        }
+        // Reason/Migration for removed
+        if (currentSection === 'removed' && currentRemoved) {
+            const reasonMatch = line.match(/^\*\*Reason\*\*:\s*(.+)$/);
+            if (reasonMatch?.[1]) {
+                currentRemoved.reason = reasonMatch[1];
+                continue;
+            }
+            const migrationMatch = line.match(/^\*\*Migration\*\*:\s*(.+)$/);
+            if (migrationMatch?.[1]) {
+                currentRemoved.migration = migrationMatch[1];
+                continue;
+            }
+        }
+        // Renamed
+        if (currentSection === 'renamed') {
+            const fromMatch = line.match(/^- FROM:.*`### Requirement: (.+)`/);
+            const toMatch = line.match(/^- TO:.*`### Requirement: (.+)`/);
+            if (fromMatch?.[1]) {
+                delta.renamed.push({ from: fromMatch[1], to: '' });
+            }
+            if (toMatch?.[1] && delta.renamed.length > 0) {
+                const last = delta.renamed[delta.renamed.length - 1];
+                if (last) {
+                    last.to = toMatch[1];
+                }
+            }
+            continue;
+        }
+        // Scenario (for added/modified)
+        const scenarioMatch = line.match(/^#### Scenario: (.+)$/);
+        if (scenarioMatch?.[1] && currentRequirement) {
+            if (currentScenario) {
+                currentRequirement.scenarios.push(currentScenario);
+            }
+            currentScenario = {
+                name: scenarioMatch[1],
+                when: '',
+                then: [],
+                and: [],
+            };
+            continue;
+        }
+        // WHEN/THEN/AND
+        if (currentScenario) {
+            const whenMatch = line.match(/^\s*-\s*\*\*WHEN\*\*\s*(.+)$/);
+            if (whenMatch?.[1]) {
+                currentScenario.when = whenMatch[1];
+                continue;
+            }
+            const thenMatch = line.match(/^\s*-\s*\*\*THEN\*\*\s*(.+)$/);
+            if (thenMatch?.[1]) {
+                currentScenario.then.push(thenMatch[1]);
+                continue;
+            }
+            const andMatch = line.match(/^\s*-\s*\*\*AND\*\*\s*(.+)$/);
+            if (andMatch?.[1]) {
+                currentScenario.and.push(andMatch[1]);
+                continue;
+            }
+        }
+    }
+    // Don't forget the last ones
+    if (currentRequirement) {
+        if (currentScenario) {
+            currentRequirement.scenarios.push(currentScenario);
+        }
+        if (currentSection === 'added') {
+            delta.added.push(currentRequirement);
+        }
+        else if (currentSection === 'modified') {
+            delta.modified.push(currentRequirement);
+        }
+    }
+    if (currentRemoved && currentSection === 'removed') {
+        delta.removed.push(currentRemoved);
+    }
+    return delta;
+}
+/**
+ * Serialize a spec back to markdown
+ */
+export function serializeSpec(spec) {
+    const lines = [];
+    // Title
+    lines.push(`# ${spec.title} Specification`);
+    lines.push('');
+    // Purpose
+    if (spec.purpose) {
+        lines.push('## Purpose');
+        lines.push('');
+        lines.push(spec.purpose);
+        lines.push('');
+    }
+    // Requirements
+    lines.push('## Requirements');
+    lines.push('');
+    for (const req of spec.requirements) {
+        lines.push(`### Requirement: ${req.name}`);
+        lines.push('');
+        if (req.description) {
+            lines.push(req.description);
+            lines.push('');
+        }
+        for (const scenario of req.scenarios) {
+            lines.push(`#### Scenario: ${scenario.name}`);
+            lines.push(`- **WHEN** ${scenario.when}`);
+            for (const then of scenario.then) {
+                lines.push(`- **THEN** ${then}`);
+            }
+            for (const and of scenario.and) {
+                lines.push(`- **AND** ${and}`);
+            }
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=spec-parser.js.map

package/dist/core/parsers/spec-parser.js.map

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

package/dist/core/validation/spec-validator.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Spec Validation Module
+ *
+ * Validates spec documents for structure, content, consistency, and completeness.
+ */
+export interface ValidationIssue {
+    type: 'error' | 'warning';
+    code: string;
+    message: string;
+    line?: number;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+    stats: {
+        requirements: number;
+        scenarios: number;
+    };
+}
+/**
+ * Validate a spec document
+ */
+export declare function validateSpec(content: string, name: string, isDelta?: boolean): ValidationResult;
+/**
+ * Validate multiple specs for cross-spec consistency
+ */
+export declare function validateSpecSet(specs: Map<string, string>): {
+    valid: boolean;
+    issues: ValidationIssue[];
+};
+//# sourceMappingURL=spec-validator.d.ts.map

package/dist/core/validation/spec-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-validator.d.ts","sourceRoot":"","sources":["../../../src/core/validation/spec-validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,OAAe,GACvB,gBAAgB,CAyMlB;AAgCD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACzB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAyB/C"}

package/dist/core/validation/spec-validator.js

@@ -0,0 +1,242 @@
+/**
+ * Spec Validation Module
+ *
+ * Validates spec documents for structure, content, consistency, and completeness.
+ */
+/**
+ * Validate a spec document
+ */
+export function validateSpec(content, name, isDelta = false) {
+    const errors = [];
+    const warnings = [];
+    const lines = content.split('\n');
+    let requirementCount = 0;
+    let scenarioCount = 0;
+    let currentRequirement = null;
+    let currentScenario = null;
+    let hasWhen = false;
+    let hasThen = false;
+    const seenRequirements = new Set();
+    const seenScenarios = new Set();
+    // Check header
+    const hasTitle = lines.some(l => l.match(/^# .+/));
+    if (!hasTitle && !isDelta) {
+        errors.push({
+            type: 'error',
+            code: 'MISSING_TITLE',
+            message: 'Spec must have a title (# header)',
+        });
+    }
+    // Check Purpose section (not required for delta)
+    const hasPurpose = content.includes('## Purpose');
+    if (!hasPurpose && !isDelta) {
+        warnings.push({
+            type: 'warning',
+            code: 'MISSING_PURPOSE',
+            message: 'Spec should have a Purpose section',
+        });
+    }
+    // Parse line by line
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? '';
+        const lineNum = i + 1;
+        // Check for requirement
+        const reqMatch = line.match(/^### Requirement: (.+)$/);
+        if (reqMatch?.[1]) {
+            // Save previous scenario state
+            if (currentScenario && !hasWhen) {
+                errors.push({
+                    type: 'error',
+                    code: 'MISSING_WHEN',
+                    message: `Scenario "${currentScenario}" is missing WHEN clause`,
+                });
+            }
+            if (currentScenario && !hasThen) {
+                errors.push({
+                    type: 'error',
+                    code: 'MISSING_THEN',
+                    message: `Scenario "${currentScenario}" is missing THEN clause`,
+                });
+            }
+            // Check for duplicate requirement
+            if (seenRequirements.has(reqMatch[1])) {
+                errors.push({
+                    type: 'error',
+                    code: 'DUPLICATE_REQUIREMENT',
+                    message: `Duplicate requirement name: "${reqMatch[1]}"`,
+                    line: lineNum,
+                });
+            }
+            seenRequirements.add(reqMatch[1]);
+            currentRequirement = reqMatch[1];
+            currentScenario = null;
+            hasWhen = false;
+            hasThen = false;
+            requirementCount++;
+            continue;
+        }
+        // Check for scenario
+        const scenarioMatch = line.match(/^#### Scenario: (.+)$/);
+        if (scenarioMatch?.[1]) {
+            // Save previous scenario state
+            if (currentScenario && !hasWhen) {
+                errors.push({
+                    type: 'error',
+                    code: 'MISSING_WHEN',
+                    message: `Scenario "${currentScenario}" is missing WHEN clause`,
+                });
+            }
+            if (currentScenario && !hasThen) {
+                errors.push({
+                    type: 'error',
+                    code: 'MISSING_THEN',
+                    message: `Scenario "${currentScenario}" is missing THEN clause`,
+                });
+            }
+            // Check if scenario is under a requirement
+            if (!currentRequirement && !isDelta) {
+                errors.push({
+                    type: 'error',
+                    code: 'ORPHAN_SCENARIO',
+                    message: `Scenario "${scenarioMatch[1]}" is not under a Requirement`,
+                    line: lineNum,
+                });
+            }
+            // Check for duplicate scenario
+            const scenarioKey = `${currentRequirement}/${scenarioMatch[1]}`;
+            if (seenScenarios.has(scenarioKey)) {
+                errors.push({
+                    type: 'error',
+                    code: 'DUPLICATE_SCENARIO',
+                    message: `Duplicate scenario name: "${scenarioMatch[1]}" under "${currentRequirement}"`,
+                    line: lineNum,
+                });
+            }
+            seenScenarios.add(scenarioKey);
+            currentScenario = scenarioMatch[1];
+            hasWhen = false;
+            hasThen = false;
+            scenarioCount++;
+            continue;
+        }
+        // Check for WHEN
+        if (line.match(/^\s*-\s*\*\*WHEN\*\*/)) {
+            if (!currentScenario) {
+                errors.push({
+                    type: 'error',
+                    code: 'ORPHAN_WHEN',
+                    message: 'WHEN clause found outside of a Scenario',
+                    line: lineNum,
+                });
+            }
+            hasWhen = true;
+            continue;
+        }
+        // Check for THEN
+        if (line.match(/^\s*-\s*\*\*THEN\*\*/)) {
+            if (!currentScenario) {
+                errors.push({
+                    type: 'error',
+                    code: 'ORPHAN_THEN',
+                    message: 'THEN clause found outside of a Scenario',
+                    line: lineNum,
+                });
+            }
+            hasThen = true;
+            continue;
+        }
+        // Check for weak language in requirements
+        if (currentRequirement && !currentScenario) {
+            if (line.match(/\bshould\b/i) && !line.match(/\bSHOULD\b/)) {
+                warnings.push({
+                    type: 'warning',
+                    code: 'WEAK_LANGUAGE',
+                    message: 'Consider using SHALL/MUST for mandatory behavior',
+                    line: lineNum,
+                });
+            }
+        }
+    }
+    // Check final scenario
+    if (currentScenario && !hasWhen) {
+        errors.push({
+            type: 'error',
+            code: 'MISSING_WHEN',
+            message: `Scenario "${currentScenario}" is missing WHEN clause`,
+        });
+    }
+    if (currentScenario && !hasThen) {
+        errors.push({
+            type: 'error',
+            code: 'MISSING_THEN',
+            message: `Scenario "${currentScenario}" is missing THEN clause`,
+        });
+    }
+    // Check for requirements without scenarios
+    if (!isDelta) {
+        // This requires more complex parsing, skip for now
+    }
+    // Validate delta-specific rules
+    if (isDelta) {
+        validateDeltaSpec(content, errors, warnings);
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        stats: {
+            requirements: requirementCount,
+            scenarios: scenarioCount,
+        },
+    };
+}
+function validateDeltaSpec(content, errors, warnings) {
+    // Check delta sections
+    const hasDeltaSections = content.includes('## ADDED') ||
+        content.includes('## MODIFIED') ||
+        content.includes('## REMOVED') ||
+        content.includes('## RENAMED');
+    // If has MODIFIED section, warn about exact name matching
+    if (content.includes('## MODIFIED')) {
+        // Could add validation against main spec here
+    }
+    // If has REMOVED section, check for reason
+    if (content.includes('## REMOVED')) {
+        const removedSection = content.match(/## REMOVED Requirements[\s\S]*?(?=## |$)/);
+        if (removedSection?.[0] && !removedSection[0].includes('**Reason**')) {
+            warnings.push({
+                type: 'warning',
+                code: 'REMOVED_NO_REASON',
+                message: 'REMOVED requirements should include a Reason',
+            });
+        }
+    }
+}
+/**
+ * Validate multiple specs for cross-spec consistency
+ */
+export function validateSpecSet(specs) {
+    const issues = [];
+    const allRequirements = new Map();
+    for (const [name, content] of specs) {
+        // Check for duplicate requirements across specs
+        const reqMatches = content.matchAll(/^### Requirement: (.+)$/gm);
+        for (const match of reqMatches) {
+            if (match[1]) {
+                if (allRequirements.has(match[1])) {
+                    issues.push({
+                        type: 'error',
+                        code: 'CROSS_SPEC_DUPLICATE',
+                        message: `Requirement "${match[1]}" exists in both "${allRequirements.get(match[1])}" and "${name}"`,
+                    });
+                }
+                allRequirements.set(match[1], name);
+            }
+        }
+    }
+    return {
+        valid: issues.filter(i => i.type === 'error').length === 0,
+        issues,
+    };
+}
+//# sourceMappingURL=spec-validator.js.map

package/dist/core/validation/spec-validator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * SuperSpec - Unified Spec-Driven Development Framework
+ *
+ * Core Principle:
+ * Every Scenario becomes a test, every test traces to a Scenario.
+ *
+ * @module superspec
+ */
+export { validateSpec, validateSpecSet } from './core/validation/spec-validator.js';
+export type { ValidationResult, ValidationIssue } from './core/validation/spec-validator.js';
+export { parseSpec, parseDeltaSpec, serializeSpec } from './core/parsers/spec-parser.js';
+export type { Spec, DeltaSpec, Requirement, Scenario } from './core/parsers/spec-parser.js';
+export { loadProjectConfig, getDefaultConfig, serializeConfig } from './core/config/project-config.js';
+export type { ProjectConfig } from './core/config/project-config.js';
+/**
+ * SuperSpec version
+ */
+export declare const VERSION = "0.1.0";
+/**
+ * Core principles (Iron Laws)
+ */
+export declare const IRON_LAWS: {
+    readonly TDD: "NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST";
+    readonly SPECS: "SPECS ARE TRUTH. CHANGES ARE PROPOSALS.";
+    readonly SUPERSPEC: "EVERY SCENARIO BECOMES A TEST. EVERY TEST TRACES TO A SCENARIO.";
+};
+/**
+ * Workflow phases
+ */
+export declare const WORKFLOW_PHASES: readonly ["brainstorm", "plan", "execute", "verify", "archive"];
+/**
+ * Brainstorm sub-phases
+ */
+export declare const BRAINSTORM_PHASES: readonly ["explore", "propose", "design", "spec"];
+//# 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;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACpF,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE7F,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACzF,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE5F,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvG,YAAY,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE;;GAEG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B;;GAEG;AACH,eAAO,MAAM,SAAS;;;;CAIZ,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe,iEAMlB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB,mDAKpB,CAAC"}