spec-gen-cli 1.0.0

package/dist/api/analyze.d.ts

@@ -0,0 +1,17 @@
+/**
+ * spec-gen analyze — programmatic API
+ *
+ * Runs static analysis on the codebase (no LLM required).
+ * No side effects (no process.exit, no console.log).
+ */
+import type { AnalyzeApiOptions, AnalyzeResult } from './types.js';
+/**
+ * Run static analysis on the codebase.
+ *
+ * Scans the repository, builds a dependency graph, and generates
+ * analysis artifacts. No LLM involvement.
+ *
+ * @throws Error if no spec-gen configuration found
+ */
+export declare function specGenAnalyze(options?: AnalyzeApiOptions): Promise<AnalyzeResult>;
+//# sourceMappingURL=analyze.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/api/analyze.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAmC,MAAM,YAAY,CAAC;AAepG;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC,CAwF5F"}

package/dist/api/analyze.js

@@ -0,0 +1,109 @@
+/**
+ * spec-gen analyze — programmatic API
+ *
+ * Runs static analysis on the codebase (no LLM required).
+ * No side effects (no process.exit, no console.log).
+ */
+import { join } from 'node:path';
+import { access, stat, mkdir, writeFile } from 'node:fs/promises';
+import { readSpecGenConfig } from '../core/services/config-manager.js';
+import { RepositoryMapper } from '../core/analyzer/repository-mapper.js';
+import { DependencyGraphBuilder } from '../core/analyzer/dependency-graph.js';
+import { AnalysisArtifactGenerator } from '../core/analyzer/artifact-generator.js';
+function progress(onProgress, step, status, detail) {
+    onProgress?.({ phase: 'analyze', step, status, detail });
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Run static analysis on the codebase.
+ *
+ * Scans the repository, builds a dependency graph, and generates
+ * analysis artifacts. No LLM involvement.
+ *
+ * @throws Error if no spec-gen configuration found
+ */
+export async function specGenAnalyze(options = {}) {
+    const startTime = Date.now();
+    const rootPath = options.rootPath ?? process.cwd();
+    const maxFiles = options.maxFiles ?? 500;
+    const excludePatterns = options.excludePatterns ?? [];
+    const force = options.force ?? false;
+    const outputRelPath = options.outputPath ?? '.spec-gen/analysis/';
+    const outputPath = join(rootPath, outputRelPath);
+    const { onProgress } = options;
+    // Validate config exists
+    const specGenConfig = await readSpecGenConfig(rootPath);
+    if (!specGenConfig) {
+        throw new Error('No spec-gen configuration found. Run specGenInit() first.');
+    }
+    // Check for existing recent analysis
+    if (!force) {
+        const repoStructurePath = join(outputPath, 'repo-structure.json');
+        if (await fileExists(repoStructurePath)) {
+            const stats = await stat(repoStructurePath);
+            const age = Date.now() - stats.mtime.getTime();
+            const oneHour = 60 * 60 * 1000;
+            if (age < oneHour) {
+                progress(onProgress, 'Recent analysis exists', 'skip', `${Math.floor(age / 60000)} minutes old`);
+                // Load and return existing analysis
+                const { readFile } = await import('node:fs/promises');
+                const repoStructureContent = await readFile(repoStructurePath, 'utf-8');
+                const repoStructure = JSON.parse(repoStructureContent);
+                const depGraphPath = join(outputPath, 'dependency-graph.json');
+                let depGraph;
+                if (await fileExists(depGraphPath)) {
+                    const depGraphContent = await readFile(depGraphPath, 'utf-8');
+                    depGraph = JSON.parse(depGraphContent);
+                }
+                return {
+                    repoMap: repoStructure,
+                    depGraph: depGraph ?? {
+                        nodes: [], edges: [], clusters: [], cycles: [],
+                        rankings: { byImportance: [], byConnectivity: [], clusterCenters: [], leafNodes: [], bridgeNodes: [], orphanNodes: [] },
+                        statistics: { nodeCount: 0, edgeCount: 0, clusterCount: 0, cycleCount: 0, avgDegree: 0, density: 0 },
+                    },
+                    artifacts: { repoStructure },
+                    duration: Date.now() - startTime,
+                };
+            }
+        }
+    }
+    // Ensure output directory exists
+    await mkdir(outputPath, { recursive: true });
+    // Phase 1: Repository Mapping
+    progress(onProgress, 'Scanning directory structure', 'start');
+    const mapper = new RepositoryMapper(rootPath, {
+        maxFiles,
+        excludePatterns: excludePatterns.length > 0 ? excludePatterns : undefined,
+    });
+    const repoMap = await mapper.map();
+    progress(onProgress, 'Scanning directory structure', 'complete', `${repoMap.summary.analyzedFiles} files`);
+    // Phase 2: Dependency Graph
+    progress(onProgress, 'Building dependency graph', 'start');
+    const graphBuilder = new DependencyGraphBuilder({ rootDir: rootPath });
+    const depGraph = await graphBuilder.build(repoMap.allFiles);
+    progress(onProgress, 'Building dependency graph', 'complete', `${depGraph.statistics.nodeCount} nodes, ${depGraph.statistics.edgeCount} edges`);
+    // Phase 3: Generate Artifacts
+    progress(onProgress, 'Generating analysis artifacts', 'start');
+    const artifactGenerator = new AnalysisArtifactGenerator({
+        rootDir: rootPath,
+        outputDir: outputPath,
+        maxDeepAnalysisFiles: Math.min(20, Math.ceil(repoMap.highValueFiles.length * 0.3)),
+        maxValidationFiles: 5,
+    });
+    const artifacts = await artifactGenerator.generateAndSave(repoMap, depGraph);
+    // Save dependency graph
+    await writeFile(join(outputPath, 'dependency-graph.json'), JSON.stringify(depGraph, null, 2));
+    progress(onProgress, 'Generating analysis artifacts', 'complete');
+    const duration = Date.now() - startTime;
+    return { repoMap, depGraph, artifacts, duration };
+}
+//# sourceMappingURL=analyze.js.map

package/dist/api/analyze.js.map

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

package/dist/api/drift.d.ts

@@ -0,0 +1,21 @@
+/**
+ * spec-gen drift — programmatic API
+ *
+ * Detects spec drift: finds code changes not reflected in specs.
+ * No side effects (no process.exit, no console.log).
+ */
+import type { DriftResult } from '../types/index.js';
+import type { DriftApiOptions } from './types.js';
+/**
+ * Detect spec drift in a project.
+ *
+ * Compares code changes against existing OpenSpec specifications
+ * and reports gaps, stale specs, uncovered files, and orphaned specs.
+ *
+ * @throws Error if not a git repository
+ * @throws Error if no spec-gen configuration found
+ * @throws Error if no specs found
+ * @throws Error if LLM enhanced mode requested but no API key
+ */
+export declare function specGenDrift(options?: DriftApiOptions): Promise<DriftResult>;
+//# sourceMappingURL=drift.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drift.d.ts","sourceRoot":"","sources":["../../src/api/drift.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,YAAY,CAAC;AAepE;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CAwHtF"}

package/dist/api/drift.js

@@ -0,0 +1,145 @@
+/**
+ * spec-gen drift — programmatic API
+ *
+ * Detects spec drift: finds code changes not reflected in specs.
+ * No side effects (no process.exit, no console.log).
+ */
+import { join } from 'node:path';
+import { access } from 'node:fs/promises';
+import { readSpecGenConfig } from '../core/services/config-manager.js';
+import { getChangedFiles, isGitRepository, buildSpecMap, buildADRMap, detectDrift, } from '../core/drift/index.js';
+import { createLLMService } from '../core/services/llm-service.js';
+function progress(onProgress, step, status, detail) {
+    onProgress?.({ phase: 'drift', step, status, detail });
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Detect spec drift in a project.
+ *
+ * Compares code changes against existing OpenSpec specifications
+ * and reports gaps, stale specs, uncovered files, and orphaned specs.
+ *
+ * @throws Error if not a git repository
+ * @throws Error if no spec-gen configuration found
+ * @throws Error if no specs found
+ * @throws Error if LLM enhanced mode requested but no API key
+ */
+export async function specGenDrift(options = {}) {
+    const startTime = Date.now();
+    const rootPath = options.rootPath ?? process.cwd();
+    const baseRef = options.baseRef ?? 'auto';
+    const files = options.files ?? [];
+    const domains = options.domains ?? [];
+    const llmEnhanced = options.llmEnhanced ?? false;
+    const failOn = options.failOn ?? 'warning';
+    const maxFiles = options.maxFiles ?? 100;
+    const { onProgress } = options;
+    // Validate git repo
+    if (!(await isGitRepository(rootPath))) {
+        throw new Error('Not a git repository. Drift detection requires git.');
+    }
+    // Load config
+    const specGenConfig = await readSpecGenConfig(rootPath);
+    if (!specGenConfig) {
+        throw new Error('No spec-gen configuration found. Run specGenInit() first.');
+    }
+    // Check specs exist
+    const openspecPath = join(rootPath, specGenConfig.openspecPath ?? 'openspec');
+    const specsPath = join(openspecPath, 'specs');
+    if (!(await fileExists(specsPath))) {
+        throw new Error('No specs found. Run specGenGenerate() first.');
+    }
+    // Create LLM service if needed
+    let llm;
+    if (llmEnhanced) {
+        const anthropicKey = process.env.ANTHROPIC_API_KEY;
+        const openaiKey = process.env.OPENAI_API_KEY;
+        if (!anthropicKey && !openaiKey) {
+            throw new Error('No LLM API key found. LLM-enhanced drift requires ANTHROPIC_API_KEY or OPENAI_API_KEY.');
+        }
+        const provider = options.provider ?? (anthropicKey ? 'anthropic' : 'openai');
+        llm = createLLMService({
+            provider,
+            apiBase: options.apiBase ?? specGenConfig.llm?.apiBase,
+            sslVerify: options.sslVerify ?? specGenConfig.llm?.sslVerify ?? true,
+            enableLogging: true,
+            logDir: join(rootPath, '.spec-gen', 'logs'),
+        });
+    }
+    // Get changed files
+    progress(onProgress, 'Analyzing git changes', 'start');
+    const gitResult = await getChangedFiles({
+        rootPath,
+        baseRef,
+        pathFilter: files.length > 0 ? files : undefined,
+        includeUnstaged: true,
+    });
+    progress(onProgress, 'Analyzing git changes', 'complete', `${gitResult.files.length} changed files`);
+    if (gitResult.files.length === 0) {
+        return {
+            timestamp: new Date().toISOString(),
+            baseRef: gitResult.resolvedBase,
+            totalChangedFiles: 0,
+            specRelevantFiles: 0,
+            issues: [],
+            summary: { gaps: 0, stale: 0, uncovered: 0, orphanedSpecs: 0, adrGaps: 0, adrOrphaned: 0, total: 0 },
+            hasDrift: false,
+            duration: Date.now() - startTime,
+            mode: 'static',
+        };
+    }
+    // Apply max-files limit
+    const actualChangedFiles = gitResult.files.length;
+    if (gitResult.files.length > maxFiles) {
+        gitResult.files = gitResult.files.slice(0, maxFiles);
+    }
+    // Build spec map
+    progress(onProgress, 'Loading spec mappings', 'start');
+    const repoStructurePath = join(rootPath, '.spec-gen', 'analysis', 'repo-structure.json');
+    const hasRepoStructure = await fileExists(repoStructurePath);
+    const specMap = await buildSpecMap({
+        rootPath,
+        openspecPath,
+        repoStructurePath: hasRepoStructure ? repoStructurePath : undefined,
+    });
+    // Build ADR map
+    const adrMap = await buildADRMap({
+        rootPath,
+        openspecPath,
+        repoStructurePath: hasRepoStructure ? repoStructurePath : undefined,
+    });
+    progress(onProgress, 'Loading spec mappings', 'complete', `${specMap.domainCount} domains`);
+    // Detect drift
+    progress(onProgress, 'Detecting drift', 'start');
+    const result = await detectDrift({
+        rootPath,
+        specMap,
+        changedFiles: gitResult.files,
+        failOn,
+        domainFilter: domains.length > 0 ? domains : undefined,
+        openspecRelPath: specGenConfig.openspecPath ?? 'openspec',
+        llm,
+        baseRef: gitResult.resolvedBase,
+        adrMap: adrMap ?? undefined,
+    });
+    result.baseRef = gitResult.resolvedBase;
+    result.totalChangedFiles = actualChangedFiles;
+    progress(onProgress, 'Detecting drift', 'complete', `${result.summary.total} issues`);
+    // Save LLM logs if applicable
+    if (llm) {
+        try {
+            await llm.saveLogs();
+        }
+        catch { /* best-effort */ }
+    }
+    return result;
+}
+//# sourceMappingURL=drift.js.map

package/dist/api/drift.js.map

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

package/dist/api/generate.d.ts

@@ -0,0 +1,18 @@
+/**
+ * spec-gen generate — programmatic API
+ *
+ * Generates OpenSpec specification files from analysis results using LLM.
+ * No side effects (no process.exit, no console.log).
+ */
+import type { GenerateApiOptions, GenerateResult } from './types.js';
+/**
+ * Generate OpenSpec specification files from analysis results using LLM.
+ *
+ * @throws Error if no spec-gen configuration found
+ * @throws Error if no analysis found
+ * @throws Error if no LLM API key found
+ * @throws Error if LLM API connectivity fails
+ * @throws Error if pipeline fails
+ */
+export declare function specGenGenerate(options?: GenerateApiOptions): Promise<GenerateResult>;
+//# sourceMappingURL=generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/api/generate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAoB,MAAM,YAAY,CAAC;AAqDvF;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC,CA8M/F"}

package/dist/api/generate.js

@@ -0,0 +1,251 @@
+/**
+ * spec-gen generate — programmatic API
+ *
+ * Generates OpenSpec specification files from analysis results using LLM.
+ * No side effects (no process.exit, no console.log).
+ */
+import { join } from 'node:path';
+import { access, readFile } from 'node:fs/promises';
+import { readSpecGenConfig, readOpenSpecConfig, } from '../core/services/config-manager.js';
+import { createLLMService } from '../core/services/llm-service.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';
+import { MappingGenerator } from '../core/generator/mapping-generator.js';
+function progress(onProgress, step, status, detail) {
+    onProgress?.({ phase: 'generate', step, status, detail });
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function loadAnalysisData(analysisPath) {
+    const repoStructurePath = join(analysisPath, 'repo-structure.json');
+    if (!(await fileExists(repoStructurePath))) {
+        return null;
+    }
+    const repoStructureContent = await readFile(repoStructurePath, 'utf-8');
+    const repoStructure = JSON.parse(repoStructureContent);
+    let llmContext;
+    const llmContextPath = join(analysisPath, 'llm-context.json');
+    if (await fileExists(llmContextPath)) {
+        const content = await readFile(llmContextPath, 'utf-8');
+        llmContext = JSON.parse(content);
+    }
+    else {
+        llmContext = {
+            phase1_survey: { purpose: 'Initial survey', files: [], estimatedTokens: 0 },
+            phase2_deep: { purpose: 'Deep analysis', files: [], totalTokens: 0 },
+            phase3_validation: { purpose: 'Validation', files: [], totalTokens: 0 },
+        };
+    }
+    let depGraph;
+    const depGraphPath = join(analysisPath, 'dependency-graph.json');
+    if (await fileExists(depGraphPath)) {
+        const content = await readFile(depGraphPath, 'utf-8');
+        depGraph = JSON.parse(content);
+    }
+    return { repoStructure, llmContext, depGraph };
+}
+/**
+ * Generate OpenSpec specification files from analysis results using LLM.
+ *
+ * @throws Error if no spec-gen configuration found
+ * @throws Error if no analysis found
+ * @throws Error if no LLM API key found
+ * @throws Error if LLM API connectivity fails
+ * @throws Error if pipeline fails
+ */
+export async function specGenGenerate(options = {}) {
+    const startTime = Date.now();
+    const rootPath = options.rootPath ?? process.cwd();
+    const analysisRelPath = options.analysisPath ?? '.spec-gen/analysis/';
+    const analysisPath = join(rootPath, analysisRelPath);
+    const { onProgress } = options;
+    // Load config
+    progress(onProgress, 'Loading configuration', 'start');
+    const specGenConfig = await readSpecGenConfig(rootPath);
+    if (!specGenConfig) {
+        throw new Error('No spec-gen configuration found. Run specGenInit() first.');
+    }
+    const openspecRelPath = specGenConfig.openspecPath ?? 'openspec';
+    const fullOpenspecPath = join(rootPath, openspecRelPath);
+    await readOpenSpecConfig(fullOpenspecPath); // Ensure it's readable
+    progress(onProgress, 'Loading configuration', 'complete');
+    // Load analysis
+    progress(onProgress, 'Loading analysis', 'start');
+    const analysisData = await loadAnalysisData(analysisPath);
+    if (!analysisData) {
+        throw new Error('No analysis found. Run specGenAnalyze() first.');
+    }
+    const { repoStructure, llmContext, depGraph } = analysisData;
+    progress(onProgress, 'Loading analysis', 'complete', `${repoStructure.statistics.analyzedFiles} files`);
+    // Resolve provider
+    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 effectiveProvider = options.provider ?? specGenConfig.generation.provider ?? envDetectedProvider;
+    const defaultModels = {
+        anthropic: 'claude-sonnet-4-20250514',
+        gemini: 'gemini-2.0-flash',
+        'openai-compat': 'mistral-large-latest',
+        openai: 'gpt-4o',
+    };
+    const effectiveModel = options.model || specGenConfig.generation.model || defaultModels[effectiveProvider];
+    const rootConfig = specGenConfig;
+    const effectiveBaseUrl = options.openaiCompatBaseUrl
+        ?? process.env.OPENAI_COMPAT_BASE_URL
+        ?? specGenConfig.generation.openaiCompatBaseUrl
+        ?? rootConfig['openaiCompatBaseUrl'];
+    // Apply SSL verification setting
+    const sslVerify = options.sslVerify ?? specGenConfig.llm?.sslVerify ?? true;
+    if (!sslVerify || specGenConfig.generation.skipSslVerify || specGenConfig.embedding?.skipSslVerify) {
+        process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0';
+    }
+    // Create LLM service
+    progress(onProgress, 'Creating LLM service', 'start');
+    let llm;
+    try {
+        llm = createLLMService({
+            provider: effectiveProvider,
+            model: effectiveModel,
+            openaiCompatBaseUrl: effectiveBaseUrl,
+            apiBase: options.apiBase ?? specGenConfig.llm?.apiBase,
+            sslVerify,
+            enableLogging: true,
+            logDir: join(rootPath, '.spec-gen', 'logs'),
+        });
+    }
+    catch (error) {
+        throw new Error(`Failed to create LLM service: ${error.message}`);
+    }
+    progress(onProgress, 'Creating LLM service', 'complete', `${effectiveProvider}/${effectiveModel}`);
+    // Dry run — return empty result
+    if (options.dryRun) {
+        progress(onProgress, 'Dry run complete', 'complete');
+        return {
+            report: {
+                timestamp: new Date().toISOString(),
+                openspecVersion: specGenConfig.version ?? '1.0.0',
+                specGenVersion: '1.0.0',
+                filesWritten: [],
+                filesSkipped: [],
+                filesBackedUp: [],
+                filesMerged: [],
+                configUpdated: false,
+                validationErrors: [],
+                warnings: [],
+                nextSteps: ['Run without --dry-run to generate specs'],
+            },
+            pipelineResult: {},
+            duration: Date.now() - startTime,
+        };
+    }
+    // Run pipeline
+    progress(onProgress, 'Running LLM generation pipeline', 'start');
+    const adr = options.adr ?? false;
+    const adrOnly = options.adrOnly ?? false;
+    const pipeline = new SpecGenerationPipeline(llm, {
+        outputDir: join(rootPath, '.spec-gen', 'generation'),
+        saveIntermediate: true,
+        generateADRs: adr || adrOnly,
+    });
+    let pipelineResult;
+    try {
+        pipelineResult = await pipeline.run(repoStructure, llmContext, depGraph);
+    }
+    catch (error) {
+        await llm.saveLogs().catch(() => { });
+        throw new Error(`Pipeline failed: ${error.message}`);
+    }
+    progress(onProgress, 'Running LLM generation pipeline', 'complete');
+    // Format specs
+    progress(onProgress, 'Formatting specifications', 'start');
+    const formatGenerator = new OpenSpecFormatGenerator({
+        version: specGenConfig.version,
+        includeConfidence: true,
+        includeTechnicalNotes: true,
+    });
+    let generatedSpecs = adrOnly ? [] : formatGenerator.generateSpecs(pipelineResult);
+    // Filter by domains
+    if (!adrOnly && options.domains && options.domains.length > 0) {
+        const domainSet = new Set(options.domains.map(d => d.toLowerCase()));
+        generatedSpecs = generatedSpecs.filter(spec => spec.type === 'overview' || spec.type === 'architecture' || domainSet.has(spec.domain.toLowerCase()));
+    }
+    // Generate ADRs
+    if (adr || adrOnly) {
+        const adrGenerator = new ADRGenerator({
+            version: specGenConfig.version,
+            includeMermaid: true,
+        });
+        const adrSpecs = adrGenerator.generateADRs(pipelineResult);
+        generatedSpecs.push(...adrSpecs);
+    }
+    progress(onProgress, 'Formatting specifications', 'complete', `${generatedSpecs.length} files`);
+    // Write specs
+    progress(onProgress, 'Writing OpenSpec files', 'start');
+    const writeMode = options.writeMode ?? 'replace';
+    const writer = new OpenSpecWriter({
+        rootPath,
+        writeMode,
+        version: specGenConfig.version,
+        createBackups: true,
+        updateConfig: true,
+        validateBeforeWrite: true,
+    });
+    const report = await writer.writeSpecs(generatedSpecs, pipelineResult.survey);
+    progress(onProgress, 'Writing OpenSpec files', 'complete', `${report.filesWritten.length} written`);
+    // Generate mapping artifact
+    if ((options.mapping ?? true) && depGraph) {
+        try {
+            let semanticSearch;
+            const analysisDir = join(rootPath, '.spec-gen', 'analysis');
+            const { VectorIndex } = await import('../core/analyzer/vector-index.js');
+            if (VectorIndex.exists(analysisDir)) {
+                const { EmbeddingService } = await import('../core/analyzer/embedding-service.js');
+                let embedSvc;
+                try {
+                    embedSvc = EmbeddingService.fromEnv();
+                }
+                catch { /* no env config */ }
+                if (!embedSvc) {
+                    const svc = EmbeddingService.fromConfig(specGenConfig);
+                    if (svc)
+                        embedSvc = svc;
+                }
+                if (embedSvc) {
+                    const svc = embedSvc;
+                    semanticSearch = (query, limit) => VectorIndex.search(analysisDir, query, svc, { limit });
+                }
+            }
+            const mapper = new MappingGenerator(rootPath, openspecRelPath, semanticSearch);
+            await mapper.generate(pipelineResult, depGraph);
+            progress(onProgress, 'Generating mapping artifact', 'complete');
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+    // Save LLM logs
+    await llm.saveLogs().catch(() => { });
+    return {
+        report,
+        pipelineResult,
+        duration: Date.now() - startTime,
+    };
+}
+//# sourceMappingURL=generate.js.map

package/dist/api/generate.js.map

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

package/dist/api/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * spec-gen Programmatic API
+ *
+ * This is the public API surface for spec-gen. Consumers (like OpenSpec CLI)
+ * can import these functions to use spec-gen as a library.
+ *
+ * @example
+ * ```typescript
+ * import { specGenRun, specGenDrift } from 'spec-gen';
+ *
+ * // Run the full pipeline
+ * const result = await specGenRun({
+ *   rootPath: '/path/to/project',
+ *   onProgress: (event) => console.log(event.step),
+ * });
+ *
+ * // Check for drift
+ * const drift = await specGenDrift({ rootPath: '/path/to/project' });
+ * if (drift.hasDrift) {
+ *   console.warn(`${drift.summary.total} drift issues found`);
+ * }
+ * ```
+ */
+export { specGenInit } from './init.js';
+export { specGenAnalyze } from './analyze.js';
+export { specGenGenerate } from './generate.js';
+export { specGenVerify } from './verify.js';
+export { specGenDrift } from './drift.js';
+export { specGenRun } from './run.js';
+export { specGenGetSpecRequirements } from './specs.js';
+export type { ProgressCallback, ProgressEvent, BaseOptions, InitApiOptions, InitResult, AnalyzeApiOptions, AnalyzeResult, GenerateApiOptions, GenerateResult, VerifyApiOptions, VerifyResult, DriftApiOptions, RunApiOptions, RunResult, } from './types.js';
+export type { DriftResult, DriftSeverity, SpecGenConfig } from '../types/index.js';
+export type { RepositoryMap } from './types.js';
+export type { DependencyGraphResult } from '../core/analyzer/dependency-graph.js';
+export type { PipelineResult } from '../core/generator/spec-pipeline.js';
+export type { GenerationReport } from '../core/generator/openspec-writer.js';
+export type { VerificationReport } from '../core/verifier/verification-engine.js';
+export type { SpecRequirement } from './specs.js';
+//# sourceMappingURL=index.d.ts.map