openlore 2.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 openlore ... 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/drift/test-suggester.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Maps drift results to the test files that cover the affected domains.
+ * Scans test files for // openlore: {JSON} metadata tags (written by openlore test).
+ * No LLM required.
+ */
+import type { DriftResult } from '../../types/index.js';
+export interface DomainTestSuggestion {
+    domain: string;
+    testFiles: string[];
+    scenarioCount: number;
+}
+export interface TestSuggestion {
+    domains: DomainTestSuggestion[];
+    /** Flat list of all unique test files for easy copy-paste into a test runner */
+    allFiles: string[];
+}
+export declare function suggestTestsForDrift(driftResult: DriftResult, rootPath: string, testDirs?: string[]): Promise<TestSuggestion>;
+//# sourceMappingURL=test-suggester.d.ts.map

package/dist/core/drift/test-suggester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-suggester.d.ts","sourceRoot":"","sources":["../../../src/core/drift/test-suggester.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMxD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,gFAAgF;IAChF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAoDD,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,EAChB,QAAQ,WAAwB,GAC/B,OAAO,CAAC,cAAc,CAAC,CAoDzB"}

package/dist/core/drift/test-suggester.js

@@ -0,0 +1,107 @@
+/**
+ * Maps drift results to the test files that cover the affected domains.
+ * Scans test files for // openlore: {JSON} metadata tags (written by openlore test).
+ * No LLM required.
+ */
+import { readFile, readdir } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { fileExists } from '../../utils/command-helpers.js';
+// ============================================================================
+// INTERNALS
+// ============================================================================
+const TEST_FILE_EXTENSIONS = /\.(spec|test)\.[tj]sx?$|_test\.(py|cpp|cc)$|^test_.*\.py$/;
+const TAG_REGEX = /(?:\/\/|#)\s*openlore:\s*(\{[^\n]+\})/g;
+async function walkTestFiles(dir) {
+    const results = [];
+    if (!(await fileExists(dir)))
+        return results;
+    async function walk(current) {
+        let entries;
+        try {
+            entries = await readdir(current);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (['node_modules', '.git', 'dist', 'build'].includes(entry))
+                continue;
+            const full = join(current, entry);
+            if (TEST_FILE_EXTENSIONS.test(entry)) {
+                results.push(full);
+            }
+            else if (!entry.includes('.')) {
+                await walk(full);
+            }
+        }
+    }
+    await walk(dir);
+    return results;
+}
+async function scanDomainTags(absPath) {
+    let content;
+    try {
+        content = await readFile(absPath, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const domains = new Set();
+    TAG_REGEX.lastIndex = 0;
+    let m;
+    while ((m = TAG_REGEX.exec(content)) !== null) {
+        try {
+            const tag = JSON.parse(m[1]);
+            if (typeof tag.domain === 'string')
+                domains.add(tag.domain.toLowerCase());
+        }
+        catch { /* malformed tag */ }
+    }
+    return [...domains];
+}
+// ============================================================================
+// MAIN
+// ============================================================================
+export async function suggestTestsForDrift(driftResult, rootPath, testDirs = ['spec-tests', 'src']) {
+    const absRoot = resolve(rootPath);
+    // Extract the set of drifted domains from the drift result
+    const driftedDomains = new Set(driftResult.issues
+        .map((i) => i.domain)
+        .filter((d) => typeof d === 'string' && d.length > 0)
+        .map((d) => d.toLowerCase()));
+    if (driftedDomains.size === 0) {
+        return { domains: [], allFiles: [] };
+    }
+    // Walk test directories and collect all test files
+    const allTestFiles = [];
+    for (const dir of testDirs) {
+        const absDir = join(absRoot, dir);
+        allTestFiles.push(...(await walkTestFiles(absDir)));
+    }
+    // For each test file, check which domains it covers
+    const filesByDomain = new Map();
+    const scenarioCountByDomain = new Map();
+    await Promise.all(allTestFiles.map(async (absPath) => {
+        const coveredDomains = await scanDomainTags(absPath);
+        const relPath = absPath.replace(absRoot + '/', '');
+        for (const domain of coveredDomains) {
+            if (!driftedDomains.has(domain))
+                continue;
+            if (!filesByDomain.has(domain))
+                filesByDomain.set(domain, new Set());
+            filesByDomain.get(domain).add(relPath);
+            scenarioCountByDomain.set(domain, (scenarioCountByDomain.get(domain) ?? 0) + 1);
+        }
+    }));
+    // Build result, ordered by domain name
+    const domains = [...filesByDomain.entries()]
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([domain, files]) => ({
+        domain,
+        testFiles: [...files].sort(),
+        scenarioCount: scenarioCountByDomain.get(domain) ?? 0,
+    }));
+    const allFiles = [...new Set(domains.flatMap((d) => d.testFiles))];
+    return { domains, allFiles };
+}
+//# sourceMappingURL=test-suggester.js.map

package/dist/core/drift/test-suggester.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-suggester.js","sourceRoot":"","sources":["../../../src/core/drift/test-suggester.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"}