openlore 2.0.0

package/dist/api/types.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Programmatic API types for openlore
+ *
+ * These types define the options and results for the openlore API functions.
+ * They are designed for programmatic consumers (like OpenSpec CLI) and are
+ * free of CLI-specific concerns (no process.exit, no console.log).
+ */
+import type { RepositoryMap as CoreRepositoryMap } from '../core/analyzer/repository-mapper.js';
+import type { DependencyGraphResult } from '../core/analyzer/dependency-graph.js';
+import type { AnalysisArtifacts } from '../core/analyzer/artifact-generator.js';
+import type { PipelineResult } from '../core/generator/spec-pipeline.js';
+import type { GenerationReport } from '../core/generator/openspec-writer.js';
+import type { VerificationReport } from '../core/verifier/verification-engine.js';
+import type { DriftResult, DriftSeverity } from '../types/index.js';
+export type { CoreRepositoryMap as RepositoryMap };
+export type { DependencyGraphResult };
+export type { AnalysisArtifacts };
+export type { PipelineResult };
+export type { GenerationReport };
+export type { VerificationReport };
+export type { DriftResult, DriftSeverity };
+/** Progress callback for consumers to show their own UI */
+export type ProgressCallback = (event: ProgressEvent) => void;
+export interface ProgressEvent {
+    /** Which phase is reporting: 'init' | 'analyze' | 'generate' | 'verify' | 'drift' */
+    phase: string;
+    /** Human-readable step description */
+    step: string;
+    /** Current status of this step */
+    status: 'start' | 'progress' | 'complete' | 'skip';
+    /** Optional extra detail */
+    detail?: string;
+}
+/** Base options shared by all API functions */
+export interface BaseOptions {
+    /** Project root path. Default: process.cwd() */
+    rootPath?: string;
+    /** Path to openlore config file. Default: '.openlore/config.json' */
+    configPath?: string;
+    /** Progress callback for status updates */
+    onProgress?: ProgressCallback;
+}
+export interface InitApiOptions extends BaseOptions {
+    /** Overwrite existing configuration */
+    force?: boolean;
+    /** Custom path for openspec/ output directory. Default: './openspec' */
+    openspecPath?: string;
+}
+export interface InitResult {
+    /** Path to the created config file */
+    configPath: string;
+    /** Path to the openspec directory */
+    openspecPath: string;
+    /** Detected project type */
+    projectType: string;
+    /** Whether a new config was created (false if already existed and !force) */
+    created: boolean;
+}
+export interface AnalyzeApiOptions extends BaseOptions {
+    /** Maximum files to analyze. Default: 500 */
+    maxFiles?: number;
+    /** Additional glob patterns to include */
+    includePatterns?: string[];
+    /** Additional glob patterns to exclude */
+    excludePatterns?: string[];
+    /** Force re-analysis even if recent analysis exists */
+    force?: boolean;
+    /** Output directory for analysis artifacts. Default: '.openlore/analysis/' */
+    outputPath?: string;
+}
+export interface AnalyzeResult {
+    repoMap: CoreRepositoryMap;
+    depGraph: DependencyGraphResult;
+    artifacts: AnalysisArtifacts;
+    duration: number;
+}
+export interface GenerateApiOptions extends BaseOptions {
+    /** LLM provider to use */
+    provider?: 'anthropic' | 'openai' | 'openai-compat' | 'copilot' | 'gemini' | 'gemini-cli' | 'claude-code' | 'mistral-vibe' | 'cursor-agent';
+    /** LLM model name */
+    model?: string;
+    /** Custom LLM API base URL */
+    apiBase?: string;
+    /** Enable/disable SSL certificate verification. Default: true */
+    sslVerify?: boolean;
+    /** OpenAI-compatible base URL (for Mistral, Groq, Ollama, etc.) */
+    openaiCompatBaseUrl?: string;
+    /** LLM request timeout in milliseconds. Default: 120000 (2 minutes) */
+    timeout?: number;
+    /** Only generate specific domains */
+    domains?: string[];
+    /** Write mode for existing specs */
+    writeMode?: 'replace' | 'merge' | 'skip';
+    /** Generate Architecture Decision Records */
+    adr?: boolean;
+    /** Only generate ADRs (skip spec generation) */
+    adrOnly?: boolean;
+    /** Generate requirement-to-function mapping */
+    mapping?: boolean;
+    /** Preview what would be generated without writing */
+    dryRun?: boolean;
+    /** Path to analysis directory. Default: '.openlore/analysis/' */
+    analysisPath?: string;
+    /** Force regeneration from scratch, ignoring any cached stage results on disk */
+    force?: boolean;
+}
+export interface GenerateResult {
+    report: GenerationReport;
+    pipelineResult: PipelineResult;
+    duration: number;
+}
+export interface VerifyApiOptions extends BaseOptions {
+    /** LLM provider to use */
+    provider?: 'anthropic' | 'openai' | 'openai-compat' | 'copilot' | 'gemini' | 'gemini-cli' | 'claude-code' | 'mistral-vibe' | 'cursor-agent';
+    /** LLM model name */
+    model?: string;
+    /** Custom LLM API base URL */
+    apiBase?: string;
+    /** Base URL for OpenAI-compatible endpoint (Ollama, Mistral, etc.) */
+    openaiCompatBaseUrl?: string;
+    /** Enable/disable SSL certificate verification. Default: true */
+    sslVerify?: boolean;
+    /** LLM request timeout in milliseconds. Default: 120000 (2 minutes) */
+    timeout?: number;
+    /** Number of files to sample for verification. Default: 5 */
+    samples?: number;
+    /** Minimum confidence score to pass. Default: 0.5 */
+    threshold?: number;
+    /** Only verify specific domains */
+    domains?: string[];
+}
+export interface VerifyResult {
+    report: VerificationReport;
+    duration: number;
+}
+export interface DriftApiOptions extends BaseOptions {
+    /** Git ref to compare against. Default: 'auto' (auto-detect main/master) */
+    baseRef?: string;
+    /** Specific files to check */
+    files?: string[];
+    /** Only check specific domains */
+    domains?: string[];
+    /** Use LLM for deeper semantic comparison */
+    llmEnhanced?: boolean;
+    /** LLM provider (required if llmEnhanced is true) */
+    provider?: 'anthropic' | 'openai' | 'openai-compat' | 'copilot' | 'gemini' | 'gemini-cli' | 'claude-code' | 'mistral-vibe' | 'cursor-agent';
+    /** LLM model name (used when llmEnhanced is true) */
+    model?: string;
+    /** Custom LLM API base URL */
+    apiBase?: string;
+    /** Base URL for OpenAI-compatible endpoint (Ollama, Mistral, etc.) */
+    openaiCompatBaseUrl?: string;
+    /** Enable/disable SSL certificate verification. Default: true */
+    sslVerify?: boolean;
+    /** LLM request timeout in milliseconds. Default: 120000 (2 minutes) */
+    timeout?: number;
+    /** Exit threshold severity. Default: 'warning' */
+    failOn?: DriftSeverity;
+    /** Maximum changed files to analyze. Default: 100 */
+    maxFiles?: number;
+}
+export interface RunApiOptions extends BaseOptions {
+    /** Reinitialize even if config exists */
+    force?: boolean;
+    /** Force fresh analysis even if recent exists */
+    reanalyze?: boolean;
+    /** LLM provider to use */
+    provider?: 'anthropic' | 'openai' | 'openai-compat' | 'copilot' | 'gemini' | 'gemini-cli' | 'claude-code' | 'mistral-vibe' | 'cursor-agent';
+    /** LLM model name */
+    model?: string;
+    /** Custom LLM API base URL */
+    apiBase?: string;
+    /** Enable/disable SSL certificate verification. Default: true */
+    sslVerify?: boolean;
+    /** OpenAI-compatible base URL */
+    openaiCompatBaseUrl?: string;
+    /** LLM request timeout in milliseconds. Default: 120000 (2 minutes) */
+    timeout?: number;
+    /** Maximum files to analyze. Default: 500 */
+    maxFiles?: number;
+    /** Generate Architecture Decision Records */
+    adr?: boolean;
+    /** Preview what would happen without changes */
+    dryRun?: boolean;
+}
+export interface RunResult {
+    init: InitResult;
+    analysis: AnalyzeResult;
+    generation: GenerateResult;
+    duration: number;
+}
+export interface AuditApiOptions extends BaseOptions {
+    /** Maximum uncovered functions to include in the report. Default: 50 */
+    maxUncovered?: number;
+    /** Minimum fanIn to flag a hub as a gap. Default: 5 */
+    hubThreshold?: number;
+    /** Save audit report to .openlore/analysis/audit-report.json. Default: true */
+    save?: boolean;
+}
+export type { AuditReport } from '../types/index.js';
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/api/types.js

@@ -0,0 +1,9 @@
+/**
+ * Programmatic API types for openlore
+ *
+ * These types define the options and results for the openlore API functions.
+ * They are designed for programmatic consumers (like OpenSpec CLI) and are
+ * free of CLI-specific concerns (no process.exit, no console.log).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/api/verify.d.ts

@@ -0,0 +1,20 @@
+/**
+ * openlore verify — programmatic API
+ *
+ * Tests generated spec accuracy against actual source code.
+ * No side effects (no process.exit, no console.log).
+ */
+import type { VerifyApiOptions, VerifyResult } from './types.js';
+/**
+ * Verify generated specs against actual source code.
+ *
+ * Samples files and validates that specs accurately describe behavior
+ * using an LLM to predict behavior from specs and compare against code.
+ *
+ * @throws Error if no openlore configuration found
+ * @throws Error if no specs or analysis found
+ * @throws Error if no LLM API key found
+ * @throws Error if no verification candidates found
+ */
+export declare function openloreVerify(options?: VerifyApiOptions): Promise<VerifyResult>;
+//# sourceMappingURL=verify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/api/verify.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAoB,MAAM,YAAY,CAAC;AAMnF;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAyG1F"}

package/dist/api/verify.js

@@ -0,0 +1,117 @@
+/**
+ * openlore verify — programmatic API
+ *
+ * Tests generated spec accuracy against actual source code.
+ * No side effects (no process.exit, no console.log).
+ */
+import { join } from 'node:path';
+import { OPENLORE_DIR, OPENLORE_ANALYSIS_SUBDIR, OPENLORE_LOGS_SUBDIR, OPENLORE_OUTPUTS_SUBDIR, OPENLORE_VERIFICATION_SUBDIR, OPENSPEC_DIR, OPENSPEC_SPECS_SUBDIR, ARTIFACT_DEPENDENCY_GRAPH, ARTIFACT_GENERATION_REPORT, DEFAULT_ANTHROPIC_MODEL, DEFAULT_OPENAI_MODEL, DEFAULT_GEMINI_MODEL, DEFAULT_OPENAI_COMPAT_MODEL } from '../constants.js';
+import { fileExists, readJsonFile } from '../utils/command-helpers.js';
+import { readOpenLoreConfig } from '../core/services/config-manager.js';
+import { createLLMService } from '../core/services/llm-service.js';
+import { SpecVerificationEngine } from '../core/verifier/verification-engine.js';
+function progress(onProgress, step, status, detail) {
+    onProgress?.({ phase: 'verify', step, status, detail });
+}
+/**
+ * Verify generated specs against actual source code.
+ *
+ * Samples files and validates that specs accurately describe behavior
+ * using an LLM to predict behavior from specs and compare against code.
+ *
+ * @throws Error if no openlore configuration found
+ * @throws Error if no specs or analysis found
+ * @throws Error if no LLM API key found
+ * @throws Error if no verification candidates found
+ */
+export async function openloreVerify(options = {}) {
+    const startTime = Date.now();
+    const rootPath = options.rootPath ?? process.cwd();
+    const samples = options.samples ?? 5;
+    const threshold = options.threshold ?? 0.5;
+    const { onProgress } = options;
+    // Load config
+    const openloreConfig = await readOpenLoreConfig(rootPath);
+    if (!openloreConfig) {
+        throw new Error('No openlore configuration found. Run openloreInit() first.');
+    }
+    // Check specs exist
+    const openspecPath = join(rootPath, openloreConfig.openspecPath ?? OPENSPEC_DIR);
+    const specsPath = join(openspecPath, OPENSPEC_SPECS_SUBDIR);
+    if (!(await fileExists(specsPath))) {
+        throw new Error('No specs found. Run openloreGenerate() first.');
+    }
+    // Load dependency graph
+    progress(onProgress, 'Loading analysis', 'start');
+    const analysisPath = join(rootPath, OPENLORE_DIR, OPENLORE_ANALYSIS_SUBDIR);
+    const depGraph = await readJsonFile(join(analysisPath, ARTIFACT_DEPENDENCY_GRAPH), ARTIFACT_DEPENDENCY_GRAPH);
+    if (!depGraph) {
+        throw new Error('No analysis found. Run openloreAnalyze() first.');
+    }
+    // Load generation report
+    const genReport = await readJsonFile(join(rootPath, OPENLORE_DIR, OPENLORE_OUTPUTS_SUBDIR, ARTIFACT_GENERATION_REPORT), ARTIFACT_GENERATION_REPORT);
+    const generationContext = genReport?.filesWritten ?? [];
+    progress(onProgress, 'Loading analysis', 'complete');
+    // Create LLM service — 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;
+    if (!anthropicKey && !openaiKey && !openaiCompatKey && !geminiKey) {
+        throw new Error('No LLM API key found. Set ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, or OPENAI_COMPAT_API_KEY.');
+    }
+    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,
+        openai: DEFAULT_OPENAI_MODEL,
+    };
+    const effectiveModel = options.model ?? defaultModels[provider] ?? DEFAULT_ANTHROPIC_MODEL;
+    let llm;
+    try {
+        llm = createLLMService({
+            provider,
+            model: effectiveModel,
+            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}`);
+    }
+    // Run verification
+    progress(onProgress, 'Selecting verification files', 'start');
+    const verificationDir = join(rootPath, OPENLORE_DIR, OPENLORE_VERIFICATION_SUBDIR);
+    const engine = new SpecVerificationEngine(llm, {
+        rootPath,
+        openspecPath,
+        outputDir: verificationDir,
+        filesPerDomain: Math.ceil(samples / 4),
+        passThreshold: threshold,
+        generationContext,
+    });
+    const candidates = engine.selectCandidates(depGraph);
+    if (candidates.length === 0) {
+        throw new Error('No suitable verification candidates found.');
+    }
+    progress(onProgress, 'Selecting verification files', 'complete', `${Math.min(candidates.length, samples)} candidates`);
+    progress(onProgress, 'Verifying specs against codebase', 'start');
+    const report = await engine.verify(depGraph, openloreConfig.version);
+    progress(onProgress, 'Verifying specs against codebase', 'complete', `${(report.overallConfidence * 100).toFixed(0)}% confidence`);
+    // Save LLM logs
+    await llm.saveLogs().catch(() => { });
+    return {
+        report,
+        duration: Date.now() - startTime,
+    };
+}
+//# sourceMappingURL=verify.js.map

package/dist/api/verify.js.map

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

package/dist/cli/commands/analyze.d.ts

@@ -0,0 +1,30 @@
+/**
+ * openlore analyze command
+ *
+ * Runs static analysis on the codebase without LLM involvement.
+ * Outputs repository map, dependency graph, and file significance scores.
+ */
+import { Command } from 'commander';
+import { type RepositoryMap } from '../../core/analyzer/repository-mapper.js';
+import { type DependencyGraphResult } from '../../core/analyzer/dependency-graph.js';
+import { type AnalysisArtifacts } from '../../core/analyzer/artifact-generator.js';
+interface AnalysisResult {
+    repoMap: RepositoryMap;
+    depGraph: DependencyGraphResult;
+    artifacts: AnalysisArtifacts;
+    duration: number;
+}
+/**
+ * Check if analysis exists and return its age
+ */
+/**
+ * Run the complete analysis pipeline
+ */
+export declare function runAnalysis(rootPath: string, outputPath: string, options: {
+    maxFiles: number;
+    include: string[];
+    exclude: string[];
+}): Promise<AnalysisResult>;
+export declare const analyzeCommand: Command;
+export {};
+//# sourceMappingURL=analyze.d.ts.map

package/dist/cli/commands/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/analyze.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAEhG,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,2CAA2C,CAAC;AAyBnD,UAAU,cAAc;IACtB,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAaD;;GAEG;AAMH;;GAEG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GACA,OAAO,CAAC,cAAc,CAAC,CA4FzB;AAMD,eAAO,MAAM,cAAc,SAyhBvB,CAAC"}