openlore 2.0.0

package/dist/api/run.js

@@ -0,0 +1,312 @@
+/**
+ * openlore run — programmatic API
+ *
+ * Runs the full pipeline: init → analyze → generate.
+ * Smart defaults skip unnecessary steps.
+ * No side effects (no process.exit, no console.log).
+ */
+import { join } from 'node:path';
+import { readFile, mkdir, writeFile } from 'node:fs/promises';
+import { DEFAULT_MAX_FILES, DEFAULT_ANTHROPIC_MODEL, DEFAULT_OPENAI_MODEL, DEFAULT_GEMINI_MODEL, DEFAULT_OPENAI_COMPAT_MODEL, DEFAULT_COPILOT_MODEL, OPENLORE_DIR, OPENLORE_ANALYSIS_SUBDIR, OPENLORE_LOGS_SUBDIR, OPENLORE_CONFIG_REL_PATH, OPENLORE_GENERATION_SUBDIR, OPENLORE_RUNS_SUBDIR, DEFAULT_OPENSPEC_PATH, ARTIFACT_REPO_STRUCTURE, ARTIFACT_DEPENDENCY_GRAPH, ARTIFACT_LLM_CONTEXT } from '../constants.js';
+import { fileExists, readJsonFile } from '../utils/command-helpers.js';
+import { isCacheFresh } from '../core/services/mcp-handlers/utils.js';
+import { detectProjectType, getProjectTypeName, } from '../core/services/project-detector.js';
+import { getDefaultConfig, readOpenLoreConfig, writeOpenLoreConfig, openloreConfigExists, openspecDirExists, createOpenSpecStructure, } from '../core/services/config-manager.js';
+import { gitignoreExists, isInGitignore, addToGitignore, } from '../core/services/gitignore-manager.js';
+import { createLLMService } from '../core/services/llm-service.js';
+import { RepositoryMapper } from '../core/analyzer/repository-mapper.js';
+import { DependencyGraphBuilder } from '../core/analyzer/dependency-graph.js';
+import { AnalysisArtifactGenerator, repoStructureToRepoMap } from '../core/analyzer/artifact-generator.js';
+import { SpecGenerationPipeline } from '../core/generator/spec-pipeline.js';
+import { OpenSpecFormatGenerator } from '../core/generator/openspec-format-generator.js';
+import { OpenSpecWriter } from '../core/generator/openspec-writer.js';
+import { ADRGenerator } from '../core/generator/adr-generator.js';
+function progress(onProgress, step, status, detail) {
+    onProgress?.({ phase: 'run', step, status, detail });
+}
+/**
+ * Load cached analysis artifacts from disk.
+ */
+async function loadCachedArtifacts(analysisPath, repoStructure) {
+    const llmContext = await readJsonFile(join(analysisPath, ARTIFACT_LLM_CONTEXT), ARTIFACT_LLM_CONTEXT) ?? { phase1_survey: { purpose: '', files: [] }, phase2_deep: { purpose: '', files: [] }, phase3_validation: { purpose: '', files: [] } };
+    let summaryMarkdown = '';
+    let dependencyDiagram = '';
+    try {
+        summaryMarkdown = await readFile(join(analysisPath, 'SUMMARY.md'), 'utf-8');
+    }
+    catch { /* optional */ }
+    try {
+        dependencyDiagram = await readFile(join(analysisPath, 'dependencies.mermaid'), 'utf-8');
+    }
+    catch { /* optional */ }
+    return { repoStructure, summaryMarkdown, dependencyDiagram, llmContext };
+}
+/**
+ * Run the full openlore pipeline: init → analyze → generate.
+ *
+ * Uses smart defaults to skip unnecessary steps (e.g., skips init
+ * if config exists, skips analysis if recent).
+ *
+ * @throws Error if no LLM API key found
+ * @throws Error if pipeline fails
+ */
+export async function openloreRun(options = {}) {
+    const startTime = Date.now();
+    const rootPath = options.rootPath ?? process.cwd();
+    const force = options.force ?? false;
+    const reanalyze = options.reanalyze ?? false;
+    const maxFiles = options.maxFiles ?? DEFAULT_MAX_FILES;
+    const adr = options.adr ?? false;
+    const { onProgress } = options;
+    // ========================================================================
+    // STEP 1: INITIALIZATION
+    // ========================================================================
+    progress(onProgress, 'Initialization', 'start');
+    const detection = await detectProjectType(rootPath);
+    const projectType = getProjectTypeName(detection.projectType);
+    let initResult;
+    const configExists = await openloreConfigExists(rootPath);
+    let openloreConfig = configExists ? await readOpenLoreConfig(rootPath) : null;
+    if (configExists && !force) {
+        initResult = {
+            configPath: OPENLORE_CONFIG_REL_PATH,
+            openspecPath: openloreConfig?.openspecPath ?? DEFAULT_OPENSPEC_PATH,
+            projectType,
+            created: false,
+        };
+        progress(onProgress, 'Initialization', 'skip', 'Config exists');
+    }
+    else {
+        const openspecPath = DEFAULT_OPENSPEC_PATH;
+        openloreConfig = getDefaultConfig(detection.projectType, openspecPath);
+        await writeOpenLoreConfig(rootPath, openloreConfig);
+        const fullOpenspecPath = join(rootPath, openspecPath);
+        if (!(await openspecDirExists(fullOpenspecPath))) {
+            await createOpenSpecStructure(fullOpenspecPath);
+        }
+        const hasGitignore = await gitignoreExists(rootPath);
+        if (hasGitignore) {
+            const alreadyIgnored = await isInGitignore(rootPath, `${OPENLORE_DIR}/`);
+            if (!alreadyIgnored) {
+                await addToGitignore(rootPath, `${OPENLORE_DIR}/`, 'openlore analysis artifacts');
+            }
+        }
+        initResult = {
+            configPath: OPENLORE_CONFIG_REL_PATH,
+            openspecPath: openspecPath,
+            projectType,
+            created: true,
+        };
+        progress(onProgress, 'Initialization', 'complete');
+    }
+    // Ensure we have config
+    if (!openloreConfig) {
+        openloreConfig = await readOpenLoreConfig(rootPath);
+        if (!openloreConfig) {
+            throw new Error('Failed to load configuration');
+        }
+    }
+    // ========================================================================
+    // STEP 2: ANALYSIS
+    // ========================================================================
+    progress(onProgress, 'Analysis', 'start');
+    const analysisPath = join(rootPath, OPENLORE_DIR, OPENLORE_ANALYSIS_SUBDIR);
+    let analyzeResult;
+    // Check for existing fresh analysis (content-hash or TTL)
+    const repoStructurePath = join(analysisPath, ARTIFACT_REPO_STRUCTURE);
+    let useExisting = false;
+    if (!reanalyze && !force && await fileExists(repoStructurePath) && await isCacheFresh(rootPath)) {
+        useExisting = true;
+    }
+    if (useExisting) {
+        const repoStructure = await readJsonFile(repoStructurePath, ARTIFACT_REPO_STRUCTURE);
+        if (!repoStructure) {
+            throw new Error(`Failed to load ${ARTIFACT_REPO_STRUCTURE} — run openlore analyze to regenerate`);
+        }
+        const depGraph = await readJsonFile(join(analysisPath, ARTIFACT_DEPENDENCY_GRAPH), ARTIFACT_DEPENDENCY_GRAPH) ?? undefined;
+        analyzeResult = {
+            repoMap: repoStructureToRepoMap(repoStructure),
+            depGraph: depGraph ?? {
+                nodes: [], edges: [], clusters: [], structuralClusters: [], cycles: [],
+                rankings: { byImportance: [], byConnectivity: [], clusterCenters: [], leafNodes: [], bridgeNodes: [], orphanNodes: [] },
+                statistics: { nodeCount: 0, edgeCount: 0, importEdgeCount: 0, httpEdgeCount: 0, avgDegree: 0, density: 0, clusterCount: 0, structuralClusterCount: 0, cycleCount: 0 },
+            },
+            artifacts: await loadCachedArtifacts(analysisPath, repoStructure),
+            duration: 0,
+        };
+        progress(onProgress, 'Analysis', 'skip', 'Recent analysis exists');
+    }
+    else {
+        await mkdir(analysisPath, { recursive: true });
+        const mapper = new RepositoryMapper(rootPath, { maxFiles });
+        const repoMap = await mapper.map();
+        const graphBuilder = new DependencyGraphBuilder({ rootDir: rootPath });
+        const depGraph = await graphBuilder.build(repoMap.allFiles);
+        const artifactGenerator = new AnalysisArtifactGenerator({
+            rootDir: rootPath,
+            outputDir: analysisPath,
+            maxDeepAnalysisFiles: Math.min(20, Math.ceil(repoMap.highValueFiles.length * 0.3)),
+            maxValidationFiles: 5,
+        });
+        const artifacts = await artifactGenerator.generateAndSave(repoMap, depGraph);
+        await writeFile(join(analysisPath, ARTIFACT_DEPENDENCY_GRAPH), JSON.stringify(depGraph, null, 2));
+        analyzeResult = {
+            repoMap,
+            depGraph,
+            artifacts,
+            duration: Date.now() - startTime,
+        };
+        progress(onProgress, 'Analysis', 'complete', `${repoMap.summary.analyzedFiles} files`);
+    }
+    // ========================================================================
+    // STEP 3: GENERATION
+    // ========================================================================
+    if (options.dryRun) {
+        progress(onProgress, 'Generation', 'skip', 'Dry run');
+        return {
+            init: initResult,
+            analysis: analyzeResult,
+            generation: {
+                report: {
+                    timestamp: new Date().toISOString(),
+                    openspecVersion: openloreConfig?.version ?? '1.0.0',
+                    openloreVersion: '1.0.0',
+                    filesWritten: [],
+                    filesSkipped: [],
+                    filesBackedUp: [],
+                    filesMerged: [],
+                    domainsRemoved: [],
+                    configUpdated: false,
+                    validationErrors: [],
+                    warnings: [],
+                    nextSteps: ['Run without --dry-run to generate specs'],
+                },
+                pipelineResult: {},
+                duration: 0,
+            },
+            duration: Date.now() - startTime,
+        };
+    }
+    progress(onProgress, 'Generation', 'start');
+    // Check for API key — support all four providers
+    const anthropicKey = process.env.ANTHROPIC_API_KEY;
+    const openaiKey = process.env.OPENAI_API_KEY;
+    const openaiCompatKey = process.env.OPENAI_COMPAT_API_KEY;
+    const geminiKey = process.env.GEMINI_API_KEY;
+    const noKeyProviders = ['claude-code', 'mistral-vibe', 'copilot', 'gemini-cli', 'cursor-agent'];
+    if (!noKeyProviders.includes(options.provider ?? '') && !anthropicKey && !openaiKey && !openaiCompatKey && !geminiKey) {
+        throw new Error('No LLM API key found. Set ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, OPENAI_COMPAT_API_KEY, or use provider "copilot".');
+    }
+    // Create LLM service
+    const envDetectedProvider = anthropicKey ? 'anthropic'
+        : geminiKey ? 'gemini'
+            : openaiCompatKey ? 'openai-compat'
+                : 'openai';
+    const provider = options.provider ?? envDetectedProvider;
+    const defaultModels = {
+        anthropic: DEFAULT_ANTHROPIC_MODEL,
+        gemini: DEFAULT_GEMINI_MODEL,
+        'openai-compat': DEFAULT_OPENAI_COMPAT_MODEL,
+        copilot: DEFAULT_COPILOT_MODEL,
+        openai: DEFAULT_OPENAI_MODEL,
+        'claude-code': 'claude-code',
+        'mistral-vibe': 'mistral-vibe',
+        'gemini-cli': 'gemini-cli',
+        'cursor-agent': 'cursor-agent',
+    };
+    const model = options.model ?? defaultModels[provider] ?? DEFAULT_ANTHROPIC_MODEL;
+    let llm;
+    try {
+        llm = createLLMService({
+            provider,
+            model,
+            apiBase: options.apiBase ?? openloreConfig.llm?.apiBase,
+            sslVerify: options.sslVerify ?? openloreConfig.llm?.sslVerify ?? true,
+            openaiCompatBaseUrl: options.openaiCompatBaseUrl,
+            timeout: options.timeout ?? openloreConfig.generation?.timeout,
+            enableLogging: true,
+            logDir: join(rootPath, OPENLORE_DIR, OPENLORE_LOGS_SUBDIR),
+        });
+    }
+    catch (error) {
+        throw new Error(`Failed to create LLM service: ${error.message}`);
+    }
+    // Load analysis data for pipeline
+    const llmContext = await readJsonFile(join(analysisPath, ARTIFACT_LLM_CONTEXT), ARTIFACT_LLM_CONTEXT) ?? {
+        phase1_survey: { purpose: 'Initial survey', files: [], estimatedTokens: 0 },
+        phase2_deep: { purpose: 'Deep analysis', files: [], totalTokens: 0 },
+        phase3_validation: { purpose: 'Validation', files: [], totalTokens: 0 },
+    };
+    const repoStructure = await readJsonFile(repoStructurePath, ARTIFACT_REPO_STRUCTURE);
+    if (!repoStructure) {
+        throw new Error(`Failed to load ${ARTIFACT_REPO_STRUCTURE} — run openlore analyze to regenerate`);
+    }
+    // Run pipeline
+    const pipeline = new SpecGenerationPipeline(llm, {
+        outputDir: join(rootPath, OPENLORE_DIR, OPENLORE_GENERATION_SUBDIR),
+        saveIntermediate: true,
+        generateADRs: adr,
+    });
+    let pipelineResult;
+    try {
+        pipelineResult = await pipeline.run(repoStructure, llmContext, analyzeResult.depGraph);
+    }
+    catch (error) {
+        await llm.saveLogs().catch(() => { });
+        throw new Error(`Pipeline failed: ${error.message}`);
+    }
+    // Format and write specs
+    const formatGenerator = new OpenSpecFormatGenerator({
+        version: openloreConfig.version ?? '1.0.0',
+        includeConfidence: true,
+        includeTechnicalNotes: true,
+    });
+    const generatedSpecs = formatGenerator.generateSpecs(pipelineResult);
+    if (adr && pipelineResult.adrs && pipelineResult.adrs.length > 0) {
+        const adrGenerator = new ADRGenerator({
+            version: openloreConfig.version ?? '1.0.0',
+            includeMermaid: true,
+        });
+        const adrSpecs = adrGenerator.generateADRs(pipelineResult);
+        generatedSpecs.push(...adrSpecs);
+    }
+    const writer = new OpenSpecWriter({
+        rootPath,
+        writeMode: 'replace',
+        version: openloreConfig.version ?? '1.0.0',
+        createBackups: true,
+        updateConfig: true,
+        validateBeforeWrite: true,
+    });
+    const report = await writer.writeSpecs(generatedSpecs, pipelineResult.survey);
+    // Save LLM logs
+    await llm.saveLogs().catch(() => { });
+    progress(onProgress, 'Generation', 'complete', `${report.filesWritten.length} specs written`);
+    // Save run metadata
+    const duration = Date.now() - startTime;
+    const runsDir = join(rootPath, OPENLORE_DIR, OPENLORE_RUNS_SUBDIR);
+    await mkdir(runsDir, { recursive: true });
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    await writeFile(join(runsDir, `${timestamp}.json`), JSON.stringify({
+        version: '1.0.0',
+        timestamp: new Date().toISOString(),
+        duration,
+        steps: {
+            init: { status: initResult.created ? 'completed' : 'skipped' },
+            analyze: { status: useExisting ? 'skipped' : 'completed' },
+            generate: { status: 'completed', specsGenerated: report.filesWritten.length },
+        },
+        result: 'success',
+    }, null, 2));
+    return {
+        init: initResult,
+        analysis: analyzeResult,
+        generation: {
+            report,
+            pipelineResult,
+            duration: Date.now() - startTime,
+        },
+        duration,
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/api/run.js.map

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

package/dist/api/specs.d.ts

@@ -0,0 +1,49 @@
+/**
+ * openlore API: spec requirements extractor
+ *
+ * Reads `.openlore/analysis/mapping.json` and extracts the exact requirement
+ * blocks from the spec files referenced by each mapping entry.
+ *
+ * The function returns a mapping from the mapping.requirement key to a
+ * structured object:
+ *
+ * {
+ *   title: string,       // requirement heading as found in the file
+ *   body: string,        // markdown body of the requirement (everything after the heading)
+ *   specFile?: string,   // spec file path exactly as referenced in mapping.json
+ *   domain?: string,     // domain from mapping
+ *   service?: string     // service from mapping
+ * }
+ *
+ * Behavior:
+ * - For each mapping entry we read the referenced spec file (exact path).
+ * - We attempt a deterministic (case-insensitive) equality match of the
+ *   requirement heading (the text right after "### Requirement:").
+ * - If found, we return the extracted body. If not found or the file cannot
+ *   be read, an empty body string is returned (the caller can interpret this
+ *   as "not available").
+ *
+ * This API intentionally avoids fuzzy heuristics — it uses the exact specFile
+ * path coming from mapping.json and only performs case-insensitive title
+ * equality checks.
+ */
+import type { BaseOptions } from './types.js';
+export type SpecRequirement = {
+    title: string;
+    body: string;
+    specFile?: string;
+    domain?: string;
+    service?: string;
+};
+/**
+ * Read spec requirements referenced in mapping.json.
+ *
+ * @param options.rootPath project root (default: process.cwd())
+ * @returns an object keyed by mapping.requirement with SpecRequirement values
+ */
+export declare function openloreGetSpecRequirements(options?: BaseOptions): Promise<{
+    generatedAt?: string;
+    requirements: Record<string, SpecRequirement>;
+}>;
+export default openloreGetSpecRequirements;
+//# sourceMappingURL=specs.d.ts.map

package/dist/api/specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../src/api/specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC/C,CAAC,CAoGD;AAED,eAAe,2BAA2B,CAAC"}

package/dist/api/specs.js

@@ -0,0 +1,137 @@
+/**
+ * openlore API: spec requirements extractor
+ *
+ * Reads `.openlore/analysis/mapping.json` and extracts the exact requirement
+ * blocks from the spec files referenced by each mapping entry.
+ *
+ * The function returns a mapping from the mapping.requirement key to a
+ * structured object:
+ *
+ * {
+ *   title: string,       // requirement heading as found in the file
+ *   body: string,        // markdown body of the requirement (everything after the heading)
+ *   specFile?: string,   // spec file path exactly as referenced in mapping.json
+ *   domain?: string,     // domain from mapping
+ *   service?: string     // service from mapping
+ * }
+ *
+ * Behavior:
+ * - For each mapping entry we read the referenced spec file (exact path).
+ * - We attempt a deterministic (case-insensitive) equality match of the
+ *   requirement heading (the text right after "### Requirement:").
+ * - If found, we return the extracted body. If not found or the file cannot
+ *   be read, an empty body string is returned (the caller can interpret this
+ *   as "not available").
+ *
+ * This API intentionally avoids fuzzy heuristics — it uses the exact specFile
+ * path coming from mapping.json and only performs case-insensitive title
+ * equality checks.
+ */
+import { readFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { OPENLORE_DIR, OPENLORE_ANALYSIS_SUBDIR, ARTIFACT_MAPPING } from '../constants.js';
+import { fileExists } from '../utils/command-helpers.js';
+/**
+ * Read spec requirements referenced in mapping.json.
+ *
+ * @param options.rootPath project root (default: process.cwd())
+ * @returns an object keyed by mapping.requirement with SpecRequirement values
+ */
+export async function openloreGetSpecRequirements(options = {}) {
+    const rootPath = options.rootPath ?? process.cwd();
+    const mappingPath = join(rootPath, OPENLORE_DIR, OPENLORE_ANALYSIS_SUBDIR, ARTIFACT_MAPPING);
+    const result = {};
+    let generatedAt = undefined;
+    if (!(await fileExists(mappingPath))) {
+        // No mapping available; return empty map
+        return { generatedAt, requirements: result };
+    }
+    try {
+        const mappingContent = await readFile(mappingPath, 'utf-8');
+        const mappingJson = JSON.parse(mappingContent);
+        generatedAt = mappingJson?.generatedAt;
+        const mappings = mappingJson?.mappings || [];
+        for (const m of mappings) {
+            // Use the mapping.requirement as the canonical key
+            const reqKey = m.requirement;
+            if (!reqKey)
+                continue;
+            // If we've already loaded this requirement, skip (first-wins)
+            if (Object.prototype.hasOwnProperty.call(result, reqKey))
+                continue;
+            const specFileRel = m.specFile;
+            if (!specFileRel) {
+                // No spec file recorded — create placeholder
+                result[reqKey] = {
+                    title: reqKey,
+                    body: '',
+                    domain: m.domain,
+                    service: m.service,
+                };
+                continue;
+            }
+            const specFileAbs = resolve(rootPath, specFileRel);
+            if (!(await fileExists(specFileAbs))) {
+                result[reqKey] = {
+                    title: reqKey,
+                    body: '',
+                    specFile: specFileRel,
+                    domain: m.domain,
+                    service: m.service,
+                };
+                continue;
+            }
+            try {
+                const content = await readFile(specFileAbs, 'utf-8');
+                // Split into "### Requirement:" sections and search for exact (case-insensitive) title match
+                const sections = content.split(/^###\s+Requirement:\s*/m);
+                let found = false;
+                for (let i = 1; i < sections.length; i++) {
+                    const lines = sections[i].split('\n');
+                    const rawTitle = lines[0].trim();
+                    if (!rawTitle)
+                        continue;
+                    if (rawTitle.toLowerCase() === reqKey.toLowerCase()) {
+                        const body = lines.slice(1).join('\n').trim();
+                        result[reqKey] = {
+                            title: rawTitle,
+                            body,
+                            specFile: specFileRel,
+                            domain: m.domain,
+                            service: m.service,
+                        };
+                        found = true;
+                        break;
+                    }
+                }
+                if (!found) {
+                    // Requirement heading not found in the referenced file — return placeholder
+                    result[reqKey] = {
+                        title: reqKey,
+                        body: '',
+                        specFile: specFileRel,
+                        domain: m.domain,
+                        service: m.service,
+                    };
+                }
+            }
+            catch {
+                // On read/parse error, store a placeholder so the caller knows we attempted to load it
+                result[reqKey] = {
+                    title: reqKey,
+                    body: '',
+                    specFile: specFileRel,
+                    domain: m.domain,
+                    service: m.service,
+                };
+            }
+        }
+    }
+    catch {
+        // If mapping.json cannot be read/parsed, return empty set
+        return { generatedAt, requirements: result };
+    }
+    return { generatedAt, requirements: result };
+}
+export default openloreGetSpecRequirements;
+//# sourceMappingURL=specs.js.map

package/dist/api/specs.js.map

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