spec-gen-cli 1.0.0

package/dist/api/specs.js

@@ -0,0 +1,136 @@
+/**
+ * spec-gen API: spec requirements extractor
+ *
+ * Reads `.spec-gen/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 { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+/**
+ * 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 specGenGetSpecRequirements(options = {}) {
+    const rootPath = options.rootPath ?? process.cwd();
+    const mappingPath = join(rootPath, '.spec-gen', 'analysis', 'mapping.json');
+    const result = {};
+    let generatedAt = undefined;
+    if (!existsSync(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 (!existsSync(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 specGenGetSpecRequirements;
+//# 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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAW1C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,UAAuB,EAAE;IAIxE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACnD,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;IAE5E,MAAM,MAAM,GAAoC,EAAE,CAAC;IACnD,IAAI,WAAW,GAAuB,SAAS,CAAC;IAEhD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,yCAAyC;QACzC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC/C,WAAW,GAAG,WAAW,EAAE,WAAW,CAAC;QAEvC,MAAM,QAAQ,GAAG,WAAW,EAAE,QAAQ,IAAI,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,mDAAmD;YACnD,MAAM,MAAM,GAAW,CAAC,CAAC,WAAW,CAAC;YACrC,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,8DAA8D;YAC9D,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;gBAAE,SAAS;YAEnE,MAAM,WAAW,GAAG,CAAC,CAAC,QAAQ,CAAC;YAC/B,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,6CAA6C;gBAC7C,MAAM,CAAC,MAAM,CAAC,GAAG;oBACf,KAAK,EAAE,MAAM;oBACb,IAAI,EAAE,EAAE;oBACR,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,OAAO,EAAE,CAAC,CAAC,OAAO;iBACnB,CAAC;gBACF,SAAS;YACX,CAAC;YAED,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YACnD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,MAAM,CAAC,GAAG;oBACf,KAAK,EAAE,MAAM;oBACb,IAAI,EAAE,EAAE;oBACR,QAAQ,EAAE,WAAW;oBACrB,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,OAAO,EAAE,CAAC,CAAC,OAAO;iBACnB,CAAC;gBACF,SAAS;YACX,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;gBAErD,6FAA6F;gBAC7F,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;gBAC1D,IAAI,KAAK,GAAG,KAAK,CAAC;gBAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBACjC,IAAI,CAAC,QAAQ;wBAAE,SAAS;oBACxB,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;wBACpD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;wBAC9C,MAAM,CAAC,MAAM,CAAC,GAAG;4BACf,KAAK,EAAE,QAAQ;4BACf,IAAI;4BACJ,QAAQ,EAAE,WAAW;4BACrB,MAAM,EAAE,CAAC,CAAC,MAAM;4BAChB,OAAO,EAAE,CAAC,CAAC,OAAO;yBACnB,CAAC;wBACF,KAAK,GAAG,IAAI,CAAC;wBACb,MAAM;oBACR,CAAC;gBACH,CAAC;gBAED,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,4EAA4E;oBAC5E,MAAM,CAAC,MAAM,CAAC,GAAG;wBACf,KAAK,EAAE,MAAM;wBACb,IAAI,EAAE,EAAE;wBACR,QAAQ,EAAE,WAAW;wBACrB,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,OAAO,EAAE,CAAC,CAAC,OAAO;qBACnB,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,uFAAuF;gBACvF,MAAM,CAAC,MAAM,CAAC,GAAG;oBACf,KAAK,EAAE,MAAM;oBACb,IAAI,EAAE,EAAE;oBACR,QAAQ,EAAE,WAAW;oBACrB,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,OAAO,EAAE,CAAC,CAAC,OAAO;iBACnB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;QAC1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IAC/C,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;AAC/C,CAAC;AAED,eAAe,0BAA0B,CAAC"}

package/dist/api/types.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Programmatic API types for spec-gen
+ *
+ * These types define the options and results for the spec-gen 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 spec-gen config file. Default: '.spec-gen/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: '.spec-gen/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' | 'gemini';
+    /** 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;
+    /** 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: '.spec-gen/analysis/' */
+    analysisPath?: string;
+}
+export interface GenerateResult {
+    report: GenerationReport;
+    pipelineResult: PipelineResult;
+    duration: number;
+}
+export interface VerifyApiOptions extends BaseOptions {
+    /** LLM provider to use */
+    provider?: 'anthropic' | 'openai' | 'openai-compat' | 'gemini';
+    /** LLM model name */
+    model?: string;
+    /** Custom LLM API base URL */
+    apiBase?: string;
+    /** Enable/disable SSL certificate verification. Default: true */
+    sslVerify?: boolean;
+    /** Number of files to sample for verification. Default: 5 */
+    samples?: number;
+    /** Minimum confidence score to pass. Default: 0.7 */
+    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' | 'gemini';
+    /** Custom LLM API base URL */
+    apiBase?: string;
+    /** Enable/disable SSL certificate verification. Default: true */
+    sslVerify?: boolean;
+    /** 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' | 'gemini';
+    /** 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;
+    /** 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;
+}
+//# 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 spec-gen
+ *
+ * These types define the options and results for the spec-gen 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 @@
+/**
+ * spec-gen 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 spec-gen 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 specGenVerify(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;AAUH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAoB,MAAM,YAAY,CAAC;AAenF;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CA2FzF"}

package/dist/api/verify.js

@@ -0,0 +1,117 @@
+/**
+ * spec-gen 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 { access, readFile } from 'node:fs/promises';
+import { readSpecGenConfig } 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 });
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 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 spec-gen 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 specGenVerify(options = {}) {
+    const startTime = Date.now();
+    const rootPath = options.rootPath ?? process.cwd();
+    const samples = options.samples ?? 5;
+    const threshold = options.threshold ?? 0.7;
+    const { onProgress } = options;
+    // 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.');
+    }
+    // Load dependency graph
+    progress(onProgress, 'Loading analysis', 'start');
+    const analysisPath = join(rootPath, '.spec-gen', 'analysis');
+    const depGraphPath = join(analysisPath, 'dependency-graph.json');
+    if (!(await fileExists(depGraphPath))) {
+        throw new Error('No analysis found. Run specGenAnalyze() first.');
+    }
+    const depGraphContent = await readFile(depGraphPath, 'utf-8');
+    const depGraph = JSON.parse(depGraphContent);
+    // Load generation report
+    let generationContext = [];
+    const reportPath = join(rootPath, '.spec-gen', 'outputs', 'generation-report.json');
+    if (await fileExists(reportPath)) {
+        const reportContent = await readFile(reportPath, 'utf-8');
+        const genReport = JSON.parse(reportContent);
+        generationContext = genReport.filesWritten ?? [];
+    }
+    progress(onProgress, 'Loading analysis', 'complete');
+    // Create LLM service
+    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. Set ANTHROPIC_API_KEY or OPENAI_API_KEY.');
+    }
+    const provider = options.provider ?? (anthropicKey ? 'anthropic' : 'openai');
+    let llm;
+    try {
+        llm = createLLMService({
+            provider,
+            model: options.model,
+            apiBase: options.apiBase ?? specGenConfig.llm?.apiBase,
+            sslVerify: options.sslVerify ?? specGenConfig.llm?.sslVerify ?? true,
+            enableLogging: true,
+            logDir: join(rootPath, '.spec-gen', 'logs'),
+        });
+    }
+    catch (error) {
+        throw new Error(`Failed to create LLM service: ${error.message}`);
+    }
+    // Run verification
+    progress(onProgress, 'Selecting verification files', 'start');
+    const verificationDir = join(rootPath, '.spec-gen', 'verification');
+    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, specGenConfig.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,27 @@
+/**
+ * spec-gen 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;
+}
+/**
+ * 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;AAMpC,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;AAenD,UAAU,cAAc;IACtB,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAkED;;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,CAiEzB;AAMD,eAAO,MAAM,cAAc,SAwZvB,CAAC"}