spec-gen-cli 1.0.0

package/dist/core/drift/spec-mapper.js

@@ -0,0 +1,353 @@
+/**
+ * Spec-to-File Mapper
+ *
+ * Reads existing OpenSpec specs and builds a bidirectional mapping
+ * between spec domains and source files. This is the core data structure
+ * that enables drift detection.
+ */
+import { readFile, readdir } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import logger from '../../utils/logger.js';
+// ============================================================================
+// SPEC PARSING
+// ============================================================================
+/**
+ * Extract source files from the spec header line:
+ *   > Source files: src/foo.ts, src/bar.ts
+ */
+export function parseSpecHeader(content) {
+    const lines = content.split('\n');
+    const sourceFiles = [];
+    let generatedDate = null;
+    for (const line of lines) {
+        // Match "> Source files: ..." line
+        const sourceMatch = line.match(/^>\s*Source files?:\s*(.+)/i);
+        if (sourceMatch) {
+            const files = sourceMatch[1]
+                .split(',')
+                .map(f => f.trim().replace(/`/g, ''))
+                .filter(Boolean);
+            sourceFiles.push(...files);
+        }
+        // Match "> Generated by spec-gen ... on YYYY-MM-DD"
+        const dateMatch = line.match(/^>\s*Generated.*on\s+(\d{4}-\d{2}-\d{2})/i);
+        if (dateMatch) {
+            generatedDate = dateMatch[1];
+        }
+    }
+    return { sourceFiles, generatedDate };
+}
+/**
+ * Extract file references, requirements, and entities from spec body
+ */
+export function parseSpecReferences(content) {
+    const files = [];
+    const requirements = [];
+    const entities = [];
+    // Extract files from Technical Notes: **Implementation**: `file1`, `file2`
+    // Also handles multi-line formats where backtick-wrapped files continue on subsequent lines
+    const lines = content.split('\n');
+    let inImplBlock = false;
+    for (const line of lines) {
+        if (/\*\*Implementation\*\*:/.test(line)) {
+            inImplBlock = true;
+            // Extract backtick refs from this line
+            const fileRefs = line.match(/`([^`]+)`/g);
+            if (fileRefs) {
+                files.push(...fileRefs.filter(f => f !== '**Implementation**').map(f => f.replace(/`/g, '').trim()));
+            }
+        }
+        else if (inImplBlock) {
+            // Continue capturing backtick refs from continuation lines (indented, list items, etc.)
+            if (line.match(/^\s*[-*]?\s*`[^`]+`/) || line.match(/^\s+`[^`]+`/)) {
+                const fileRefs = line.match(/`([^`]+)`/g);
+                if (fileRefs) {
+                    files.push(...fileRefs.map(f => f.replace(/`/g, '').trim()));
+                }
+            }
+            else {
+                // Non-continuation line — stop scanning this Implementation block
+                inImplBlock = false;
+            }
+        }
+    }
+    // Extract requirement names: ### Requirement: Name
+    const reqMatches = content.matchAll(/^###\s+Requirement:\s*(.+)/gm);
+    for (const match of reqMatches) {
+        requirements.push(match[1].trim());
+    }
+    // Extract entity names from ## Entities section
+    // Look for ### headings that follow ## Entities
+    const entitySection = content.match(/## Entities\s*\n([\s\S]*?)(?=\n## |\n$)/);
+    if (entitySection) {
+        const entityMatches = entitySection[1].matchAll(/^###\s+(\w+)/gm);
+        for (const match of entityMatches) {
+            entities.push(match[1].trim());
+        }
+    }
+    return { files, requirements, entities };
+}
+/**
+ * Try to infer a domain for a file path based on directory structure.
+ * Uses word-boundary matching to avoid false positives (e.g., domain "auth"
+ * should match "auth-service.ts" but not "authorize.ts").
+ */
+export function inferDomainFromPath(filePath, knownDomains) {
+    const normalizedPath = filePath.toLowerCase();
+    const parts = normalizedPath.split('/');
+    // Sort domains by length (longest first) so more specific names match first
+    const sortedDomains = [...knownDomains].sort((a, b) => b.length - a.length);
+    for (const domain of sortedDomains) {
+        const normalizedDomain = domain.toLowerCase();
+        // Direct directory match: src/auth/... → auth
+        if (parts.some(p => p === normalizedDomain)) {
+            return domain;
+        }
+        // Word-boundary prefix match on filename: "auth-handler" or "auth_service" → auth
+        // Requires the domain name to be followed by a separator (-, _, .) or end of string.
+        // This prevents "auth" from matching "authorize" or "authentication".
+        const fileName = parts[parts.length - 1].replace(/\.[^.]+$/, '');
+        if (fileName === normalizedDomain) {
+            return domain;
+        }
+        // Check for word-boundary after domain name: auth-service, auth_handler, auth.utils
+        const afterDomain = fileName.slice(normalizedDomain.length);
+        if (fileName.startsWith(normalizedDomain) && afterDomain.length > 0 && /^[-_.]/.test(afterDomain)) {
+            return domain;
+        }
+    }
+    return null;
+}
+// ============================================================================
+// SPEC MAP BUILDER
+// ============================================================================
+/**
+ * Build a bidirectional map between spec domains and source files
+ */
+export async function buildSpecMap(options) {
+    const { rootPath, openspecPath } = options;
+    const specsDir = join(openspecPath, 'specs');
+    const byDomain = new Map();
+    const byFile = new Map();
+    // Read all spec domain directories
+    let entries;
+    try {
+        entries = await readdir(specsDir, { withFileTypes: true });
+    }
+    catch {
+        logger.debug('No specs directory found');
+        return { byDomain, byFile, domainCount: 0, totalMappedFiles: 0 };
+    }
+    // Skip meta-directories that aren't domain specs (overview/architecture are
+    // structural docs, not source-file-owning domains). Note: 'api' is NOT skipped
+    // because many projects legitimately have an api domain with source files.
+    const skipDomains = new Set(['overview', 'architecture']);
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const domain = String(entry.name);
+        const specPath = join(specsDir, domain, 'spec.md');
+        const relativeSpecPath = relative(rootPath, specPath);
+        let content;
+        try {
+            content = await readFile(specPath, 'utf-8');
+        }
+        catch {
+            logger.debug(`Could not read spec: ${specPath}`);
+            continue;
+        }
+        // Parse the spec for source files
+        const header = parseSpecHeader(content);
+        const refs = parseSpecReferences(content);
+        // Combine declared (header) and inferred (body) source files, deduplicated
+        const declaredSourceFiles = header.sourceFiles;
+        const inferredSourceFiles = refs.files.filter(f => !declaredSourceFiles.includes(f));
+        const allSourceFiles = [...new Set([...declaredSourceFiles, ...inferredSourceFiles])];
+        const mapping = {
+            domain,
+            specPath: relativeSpecPath,
+            declaredSourceFiles,
+            inferredSourceFiles,
+            allSourceFiles,
+            requirements: refs.requirements,
+            entities: refs.entities,
+        };
+        byDomain.set(domain, mapping);
+        // Build reverse map (skip meta-domains for file mapping)
+        if (!skipDomains.has(domain)) {
+            for (const file of allSourceFiles) {
+                const existing = byFile.get(file) ?? [];
+                if (!existing.includes(domain)) {
+                    existing.push(domain);
+                    byFile.set(file, existing);
+                }
+            }
+        }
+    }
+    // If repo-structure.json exists, enhance mapping with directory-based inference
+    if (options.repoStructurePath) {
+        try {
+            const repoContent = await readFile(options.repoStructurePath, 'utf-8');
+            const repoStructure = JSON.parse(repoContent);
+            if (repoStructure.domains && Array.isArray(repoStructure.domains)) {
+                for (const rsDomain of repoStructure.domains) {
+                    const domainName = rsDomain.name?.toLowerCase();
+                    if (!domainName || skipDomains.has(domainName))
+                        continue;
+                    const mapping = byDomain.get(domainName);
+                    if (mapping && rsDomain.files) {
+                        for (const file of rsDomain.files) {
+                            if (!mapping.allSourceFiles.includes(file)) {
+                                mapping.inferredSourceFiles.push(file);
+                                mapping.allSourceFiles.push(file);
+                            }
+                            const existing = byFile.get(file) ?? [];
+                            if (!existing.includes(domainName)) {
+                                existing.push(domainName);
+                                byFile.set(file, existing);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            logger.debug('Could not load repo-structure.json for enhanced mapping');
+        }
+    }
+    // Count total unique mapped files
+    const totalMappedFiles = byFile.size;
+    return {
+        byDomain,
+        byFile,
+        domainCount: byDomain.size,
+        totalMappedFiles,
+    };
+}
+/**
+ * Load spec content for a domain, reading the spec file from disk.
+ * Returns the markdown content truncated to maxChars, or null if unavailable.
+ */
+export async function getSpecContent(domain, specMap, rootPath, maxChars = 4000) {
+    const mapping = specMap.byDomain.get(domain);
+    if (!mapping)
+        return null;
+    try {
+        const fullPath = join(rootPath, mapping.specPath);
+        const content = await readFile(fullPath, 'utf-8');
+        return content.length > maxChars
+            ? content.slice(0, maxChars) + '\n... (truncated)'
+            : content;
+    }
+    catch {
+        logger.debug(`Could not read spec for domain: ${domain}`);
+        return null;
+    }
+}
+/**
+ * Find which domains a file maps to, using direct lookup + directory inference
+ */
+export function matchFileToDomains(filePath, specMap) {
+    // Direct lookup
+    const direct = specMap.byFile.get(filePath);
+    if (direct && direct.length > 0) {
+        return direct;
+    }
+    // Directory inference: try matching against known domain names
+    const knownDomains = [...specMap.byDomain.keys()];
+    const inferred = inferDomainFromPath(filePath, knownDomains);
+    if (inferred) {
+        return [inferred];
+    }
+    return [];
+}
+/**
+ * Parse the ## Related section from an ADR file to extract domains and layers.
+ */
+export function parseADRRelated(content) {
+    const domains = [];
+    const layers = [];
+    const domainsMatch = content.match(/\*\*Domains\*\*:\s*(.+)/);
+    if (domainsMatch) {
+        domains.push(...domainsMatch[1].split(',').map(d => d.trim()).filter(Boolean));
+    }
+    const layersMatch = content.match(/\*\*Layers\*\*:\s*(.+)/);
+    if (layersMatch) {
+        layers.push(...layersMatch[1].split(',').map(l => l.trim()).filter(Boolean));
+    }
+    return { domains, layers };
+}
+/**
+ * Parse ADR title and status from content.
+ */
+function parseADRHeader(content) {
+    let id = '';
+    let title = '';
+    let status = 'accepted';
+    // Parse title: # ADR-001: Some Title
+    const titleMatch = content.match(/^#\s+(ADR-\d+):\s*(.+)/m);
+    if (titleMatch) {
+        id = titleMatch[1];
+        title = titleMatch[2].trim();
+    }
+    // Parse status from ## Status section
+    const statusMatch = content.match(/## Status\s+(\w+)/);
+    if (statusMatch) {
+        status = statusMatch[1].toLowerCase();
+    }
+    return { id, title, status };
+}
+/**
+ * Build an ADR map by reading all ADR files from the decisions directory.
+ * Returns null if no decisions directory exists.
+ */
+export async function buildADRMap(options) {
+    const decisionsDir = join(options.openspecPath, 'decisions');
+    const byId = new Map();
+    const byDomain = new Map();
+    let entries;
+    try {
+        entries = await readdir(decisionsDir);
+    }
+    catch {
+        return null;
+    }
+    const adrFiles = entries.filter(f => f.startsWith('adr-') && f.endsWith('.md'));
+    if (adrFiles.length === 0)
+        return null;
+    for (const fileName of adrFiles) {
+        try {
+            const filePath = join(decisionsDir, fileName);
+            const content = await readFile(filePath, 'utf-8');
+            const { id, title, status } = parseADRHeader(content);
+            if (!id)
+                continue;
+            // Skip superseded/deprecated ADRs
+            if (status === 'superseded' || status === 'deprecated')
+                continue;
+            const { domains, layers } = parseADRRelated(content);
+            const adrPath = relative(options.rootPath, filePath);
+            const mapping = {
+                id,
+                title,
+                adrPath,
+                relatedDomains: domains,
+                relatedLayers: layers,
+                status,
+            };
+            byId.set(id, mapping);
+            for (const domain of domains) {
+                const existing = byDomain.get(domain) ?? [];
+                existing.push(id);
+                byDomain.set(domain, existing);
+            }
+        }
+        catch {
+            logger.debug(`Could not read ADR file: ${fileName}`);
+        }
+    }
+    if (byId.size === 0)
+        return null;
+    return { byId, byDomain };
+}
+//# sourceMappingURL=spec-mapper.js.map

package/dist/core/drift/spec-mapper.js.map

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

package/dist/core/generator/adr-generator.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ADR Generator
+ *
+ * Converts enriched Architecture Decision Records from the LLM pipeline
+ * into formatted markdown files following the standard ADR template.
+ */
+import type { PipelineResult } from './spec-pipeline.js';
+import type { GeneratedSpec } from './openspec-format-generator.js';
+export interface ADRGeneratorOptions {
+    /** Version string for headers */
+    version?: string;
+    /** Include Mermaid architecture diagrams */
+    includeMermaid?: boolean;
+}
+export declare class ADRGenerator {
+    private options;
+    constructor(options?: ADRGeneratorOptions);
+    /**
+     * Generate all ADR specs from pipeline results.
+     * Returns individual ADR files plus an index file.
+     */
+    generateADRs(result: PipelineResult): GeneratedSpec[];
+    /**
+     * Generate a single ADR markdown file.
+     */
+    private generateSingleADR;
+    /**
+     * Generate the ADR index file with a table of all decisions.
+     */
+    private generateADRIndex;
+}
+//# sourceMappingURL=adr-generator.d.ts.map

package/dist/core/generator/adr-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr-generator.d.ts","sourceRoot":"","sources":["../../../src/core/generator/adr-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAsC,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAMpE,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAsBD,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAgC;gBAEnC,OAAO,GAAE,mBAAwB;IAO7C;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,EAAE;IAcrD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmHzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CA2CzB"}

package/dist/core/generator/adr-generator.js

@@ -0,0 +1,192 @@
+/**
+ * ADR Generator
+ *
+ * Converts enriched Architecture Decision Records from the LLM pipeline
+ * into formatted markdown files following the standard ADR template.
+ */
+// ============================================================================
+// HELPERS
+// ============================================================================
+/**
+ * Convert a title to a kebab-case slug for file naming.
+ */
+function titleToSlug(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, '')
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+// ============================================================================
+// ADR GENERATOR
+// ============================================================================
+export class ADRGenerator {
+    options;
+    constructor(options = {}) {
+        this.options = {
+            version: options.version ?? '1.0.0',
+            includeMermaid: options.includeMermaid ?? true,
+        };
+    }
+    /**
+     * Generate all ADR specs from pipeline results.
+     * Returns individual ADR files plus an index file.
+     */
+    generateADRs(result) {
+        if (!result.adrs || result.adrs.length === 0)
+            return [];
+        const specs = [];
+        for (const adr of result.adrs) {
+            specs.push(this.generateSingleADR(adr, result.architecture));
+        }
+        specs.push(this.generateADRIndex(result.adrs));
+        return specs;
+    }
+    /**
+     * Generate a single ADR markdown file.
+     */
+    generateSingleADR(adr, architecture) {
+        const lines = [];
+        const date = new Date().toISOString().split('T')[0];
+        const slug = titleToSlug(adr.title);
+        const adrNum = adr.id.replace(/[^0-9]/g, '').padStart(4, '0');
+        // Defensive defaults for arrays that the LLM may omit from its response
+        const consequences = adr.consequences ?? [];
+        const alternatives = adr.alternatives ?? [];
+        const relatedLayers = adr.relatedLayers ?? [];
+        const relatedDomains = adr.relatedDomains ?? [];
+        // Header
+        lines.push(`# ${adr.id}: ${adr.title}`);
+        lines.push('');
+        lines.push(`> Generated by spec-gen v${this.options.version} on ${date}`);
+        lines.push('');
+        // Status
+        lines.push('## Status');
+        lines.push('');
+        lines.push(capitalize(adr.status));
+        lines.push('');
+        // Context
+        lines.push('## Context');
+        lines.push('');
+        lines.push(adr.context);
+        lines.push('');
+        // Decision
+        lines.push('## Decision');
+        lines.push('');
+        lines.push(adr.decision);
+        lines.push('');
+        // Consequences
+        lines.push('## Consequences');
+        lines.push('');
+        if (consequences.length > 0) {
+            for (const consequence of consequences) {
+                lines.push(`- ${consequence}`);
+            }
+        }
+        else {
+            lines.push('No consequences identified.');
+        }
+        lines.push('');
+        // Alternatives Considered
+        if (alternatives.length > 0) {
+            lines.push('## Alternatives Considered');
+            lines.push('');
+            for (const alt of alternatives) {
+                lines.push(`- ${alt}`);
+            }
+            lines.push('');
+        }
+        // Architecture Impact (Mermaid diagram)
+        if (this.options.includeMermaid && relatedLayers.length > 0 && architecture.layerMap.length > 0) {
+            lines.push('## Architecture Impact');
+            lines.push('');
+            lines.push('```mermaid');
+            lines.push('graph TB');
+            // Filter to affected layers
+            const affectedLayers = architecture.layerMap.filter(l => relatedLayers.some(rl => l.name.toLowerCase().includes(rl.toLowerCase())));
+            // Fall back to all layers if filter matched nothing
+            const layers = affectedLayers.length > 0 ? affectedLayers : architecture.layerMap;
+            for (let i = 0; i < layers.length; i++) {
+                const layer = layers[i];
+                const layerId = layer.name.replace(/\s+/g, '');
+                const isAffected = affectedLayers.length > 0;
+                lines.push(`    ${layerId}["${layer.name}"]`);
+                if (i < layers.length - 1) {
+                    const nextLayerId = layers[i + 1].name.replace(/\s+/g, '');
+                    lines.push(`    ${layerId} --> ${nextLayerId}`);
+                }
+                if (isAffected) {
+                    lines.push(`    style ${layerId} fill:#f9f,stroke:#333`);
+                }
+            }
+            lines.push('```');
+            lines.push('');
+        }
+        // Related
+        lines.push('## Related');
+        lines.push('');
+        if (relatedLayers.length > 0) {
+            lines.push(`- **Layers**: ${relatedLayers.join(', ')}`);
+        }
+        if (relatedDomains.length > 0) {
+            lines.push(`- **Domains**: ${relatedDomains.join(', ')}`);
+        }
+        if (relatedLayers.length === 0 && relatedDomains.length === 0) {
+            lines.push('No specific layers or domains identified.');
+        }
+        lines.push('');
+        return {
+            path: `openspec/decisions/adr-${adrNum}-${slug}.md`,
+            content: lines.join('\n'),
+            domain: 'decisions',
+            type: 'adr',
+        };
+    }
+    /**
+     * Generate the ADR index file with a table of all decisions.
+     */
+    generateADRIndex(adrs) {
+        const lines = [];
+        const date = new Date().toISOString().split('T')[0];
+        lines.push('# Architecture Decision Records');
+        lines.push('');
+        lines.push(`> Generated by spec-gen v${this.options.version} on ${date}`);
+        lines.push('');
+        lines.push('This directory contains Architecture Decision Records (ADRs) that document');
+        lines.push('the key architectural decisions observed in this codebase.');
+        lines.push('');
+        lines.push('## Decisions');
+        lines.push('');
+        lines.push('| ID | Decision | Status | Layers |');
+        lines.push('|----|----------|--------|--------|');
+        for (const adr of adrs) {
+            const adrNum = adr.id.replace(/[^0-9]/g, '').padStart(4, '0');
+            const slug = titleToSlug(adr.title);
+            const fileName = `adr-${adrNum}-${slug}.md`;
+            const layers = (adr.relatedLayers ?? []).join(', ') || '-';
+            lines.push(`| [${adr.id}](./${fileName}) | ${adr.title} | ${capitalize(adr.status)} | ${layers} |`);
+        }
+        lines.push('');
+        lines.push('## About ADRs');
+        lines.push('');
+        lines.push('Architecture Decision Records capture the *why* behind architectural choices.');
+        lines.push('Each ADR documents the context, decision, and consequences of a significant');
+        lines.push('technical decision. Unlike specifications (which describe *what* the system does),');
+        lines.push('ADRs explain *why* it was built that way.');
+        lines.push('');
+        lines.push('ADRs are **immutable records**. When a decision is reversed, the original ADR');
+        lines.push('is marked as "Superseded" and a new ADR is created referencing it.');
+        lines.push('');
+        return {
+            path: 'openspec/decisions/index.md',
+            content: lines.join('\n'),
+            domain: 'decisions',
+            type: 'adr',
+        };
+    }
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=adr-generator.js.map

package/dist/core/generator/adr-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr-generator.js","sourceRoot":"","sources":["../../../src/core/generator/adr-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;GAEG;AACH,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;SAC5B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,MAAM,OAAO,YAAY;IACf,OAAO,CAAgC;IAE/C,YAAY,UAA+B,EAAE;QAC3C,IAAI,CAAC,OAAO,GAAG;YACb,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO;YACnC,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;SAC/C,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,MAAsB;QACjC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAExD,MAAM,KAAK,GAAoB,EAAE,CAAC;QAElC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;QAC/D,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAE/C,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,GAAgB,EAAE,YAAmC;QAC7E,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAE9D,wEAAwE;QACxE,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;QAC5C,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;QAC5C,MAAM,aAAa,GAAG,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC;QAC9C,MAAM,cAAc,GAAG,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;QAEhD,SAAS;QACT,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,4BAA4B,IAAI,CAAC,OAAO,CAAC,OAAO,OAAO,IAAI,EAAE,CAAC,CAAC;QAC1E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,SAAS;QACT,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,UAAU;QACV,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,WAAW;QACX,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,eAAe;QACf,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;gBACvC,KAAK,CAAC,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC5C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,0BAA0B;QAC1B,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;YACzB,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,wCAAwC;QACxC,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChG,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAEvB,4BAA4B;YAC5B,MAAM,cAAc,GAAG,YAAY,CAAC,QAAQ,CAAC,MAAM,CACjD,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAC/E,CAAC;YAEF,oDAAoD;YACpD,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC;YAElF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBACxB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC/C,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC7C,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;gBAE9C,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1B,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBAC3D,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,QAAQ,WAAW,EAAE,CAAC,CAAC;gBAClD,CAAC;gBAED,IAAI,UAAU,EAAE,CAAC;oBACf,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,wBAAwB,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,UAAU;QACV,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,iBAAiB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,kBAAkB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9D,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC1D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,OAAO;YACL,IAAI,EAAE,0BAA0B,MAAM,IAAI,IAAI,KAAK;YACnD,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YACzB,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,KAAK;SACZ,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,IAAmB;QAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAEpD,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,4BAA4B,IAAI,CAAC,OAAO,CAAC,OAAO,OAAO,IAAI,EAAE,CAAC,CAAC;QAC1E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;QACzF,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QACzE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QAElD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAC9D,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,QAAQ,GAAG,OAAO,MAAM,IAAI,IAAI,KAAK,CAAC;YAC5C,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,OAAO,QAAQ,OAAO,GAAG,CAAC,KAAK,MAAM,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,MAAM,IAAI,CAAC,CAAC;QACtG,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;QAC5F,KAAK,CAAC,IAAI,CAAC,6EAA6E,CAAC,CAAC;QAC1F,KAAK,CAAC,IAAI,CAAC,oFAAoF,CAAC,CAAC;QACjG,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;QAC5F,KAAK,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,OAAO;YACL,IAAI,EAAE,6BAA6B;YACnC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YACzB,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,KAAK;SACZ,CAAC;IACJ,CAAC;CACF;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/core/generator/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generator module index
+ */
+export * from './spec-pipeline.js';
+export * from './openspec-format-generator.js';
+export { OpenSpecValidator, OpenSpecConfigManager, validateFullSpec, normalizeDomainName, buildDetectedContext, type OpenSpecConfig, type SpecGenMetadata, type DetectedContext, } from './openspec-compat.js';
+export * from './openspec-writer.js';
+export * from './adr-generator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/generator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/generator/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,OAAO,EAGL,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}

package/dist/core/generator/index.js

@@ -0,0 +1,12 @@
+/**
+ * Generator module index
+ */
+export * from './spec-pipeline.js';
+export * from './openspec-format-generator.js';
+export { 
+// Explicitly export from openspec-compat, excluding ValidationResult
+// which is already exported from openspec-format-generator
+OpenSpecValidator, OpenSpecConfigManager, validateFullSpec, normalizeDomainName, buildDetectedContext, } from './openspec-compat.js';
+export * from './openspec-writer.js';
+export * from './adr-generator.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/generator/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,OAAO;AACL,qEAAqE;AACrE,2DAA2D;AAC3D,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,GAIrB,MAAM,sBAAsB,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}