spec-gen-cli 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAGxD,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACnF,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClF,YAAY,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAClF,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,32 @@
+/**
+ * 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`);
+ * }
+ * ```
+ */
+// API functions
+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';
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC"}

package/dist/api/init.d.ts

@@ -0,0 +1,18 @@
+/**
+ * spec-gen init — programmatic API
+ *
+ * Detects project type and creates spec-gen configuration.
+ * No side effects (no process.exit, no console.log).
+ */
+import type { InitApiOptions, InitResult } from './types.js';
+/**
+ * Initialize spec-gen in a project directory.
+ *
+ * Creates `.spec-gen/config.json`, the `openspec/` directory structure,
+ * and updates `.gitignore`.
+ *
+ * @throws Error if openspec path is outside project root
+ * @throws Error if config exists and force is false
+ */
+export declare function specGenInit(options?: InitApiOptions): Promise<InitResult>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/api/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAoB,MAAM,YAAY,CAAC;AAM/E;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAgEnF"}

package/dist/api/init.js

@@ -0,0 +1,82 @@
+/**
+ * spec-gen init — programmatic API
+ *
+ * Detects project type and creates spec-gen configuration.
+ * No side effects (no process.exit, no console.log).
+ */
+import { resolve, relative } from 'node:path';
+import { detectProjectType, getProjectTypeName, } from '../core/services/project-detector.js';
+import { getDefaultConfig, writeSpecGenConfig, specGenConfigExists, openspecDirExists, createOpenSpecStructure, } from '../core/services/config-manager.js';
+import { gitignoreExists, isInGitignore, addToGitignore, } from '../core/services/gitignore-manager.js';
+function progress(onProgress, step, status, detail) {
+    onProgress?.({ phase: 'init', step, status, detail });
+}
+/**
+ * Initialize spec-gen in a project directory.
+ *
+ * Creates `.spec-gen/config.json`, the `openspec/` directory structure,
+ * and updates `.gitignore`.
+ *
+ * @throws Error if openspec path is outside project root
+ * @throws Error if config exists and force is false
+ */
+export async function specGenInit(options = {}) {
+    const rootPath = options.rootPath ?? process.cwd();
+    const openspecRelPath = options.openspecPath ?? './openspec';
+    const openspecFullPath = resolve(rootPath, openspecRelPath);
+    const force = options.force ?? false;
+    const { onProgress } = options;
+    // Validate path traversal
+    const relPath = relative(rootPath, openspecFullPath);
+    if (relPath.startsWith('..')) {
+        throw new Error('OpenSpec path must be within the project directory.');
+    }
+    // Detect project type
+    progress(onProgress, 'Detecting project type', 'start');
+    const detection = await detectProjectType(rootPath);
+    const projectType = getProjectTypeName(detection.projectType);
+    progress(onProgress, 'Detecting project type', 'complete', projectType);
+    // Check existing config
+    const configExists = await specGenConfigExists(rootPath);
+    if (configExists && !force) {
+        progress(onProgress, 'Configuration exists', 'skip');
+        return {
+            configPath: '.spec-gen/config.json',
+            openspecPath: openspecRelPath,
+            projectType,
+            created: false,
+        };
+    }
+    // Create config
+    progress(onProgress, 'Creating configuration', 'start');
+    const config = getDefaultConfig(detection.projectType, openspecRelPath);
+    await writeSpecGenConfig(rootPath, config);
+    progress(onProgress, 'Creating configuration', 'complete');
+    // Create openspec directory
+    const hasOpenspec = await openspecDirExists(openspecFullPath);
+    if (!hasOpenspec) {
+        progress(onProgress, 'Creating openspec directory', 'start');
+        await createOpenSpecStructure(openspecFullPath);
+        progress(onProgress, 'Creating openspec directory', 'complete');
+    }
+    else {
+        progress(onProgress, 'OpenSpec directory exists', 'skip');
+    }
+    // Update .gitignore
+    const hasGitignore = await gitignoreExists(rootPath);
+    if (hasGitignore) {
+        const alreadyIgnored = await isInGitignore(rootPath, '.spec-gen/');
+        if (!alreadyIgnored) {
+            progress(onProgress, 'Updating .gitignore', 'start');
+            await addToGitignore(rootPath, '.spec-gen/', 'spec-gen analysis artifacts');
+            progress(onProgress, 'Updating .gitignore', 'complete');
+        }
+    }
+    return {
+        configPath: '.spec-gen/config.json',
+        openspecPath: openspecRelPath,
+        projectType,
+        created: true,
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/api/init.js.map

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

package/dist/api/run.d.ts

@@ -0,0 +1,19 @@
+/**
+ * spec-gen 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 type { RunApiOptions, RunResult } from './types.js';
+/**
+ * Run the full spec-gen 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 declare function specGenRun(options?: RunApiOptions): Promise<RunResult>;
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/api/run.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+BH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAA+C,MAAM,YAAY,CAAC;AAexG;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,CA8RhF"}

package/dist/api/run.js

@@ -0,0 +1,291 @@
+/**
+ * spec-gen 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 { access, stat, readFile, mkdir, writeFile } from 'node:fs/promises';
+import { detectProjectType, getProjectTypeName, } from '../core/services/project-detector.js';
+import { getDefaultConfig, readSpecGenConfig, writeSpecGenConfig, specGenConfigExists, 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 } 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 });
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Run the full spec-gen 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 specGenRun(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 ?? 500;
+    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 specGenConfigExists(rootPath);
+    let specGenConfig = configExists ? await readSpecGenConfig(rootPath) : null;
+    if (configExists && !force) {
+        initResult = {
+            configPath: '.spec-gen/config.json',
+            openspecPath: specGenConfig?.openspecPath ?? './openspec',
+            projectType,
+            created: false,
+        };
+        progress(onProgress, 'Initialization', 'skip', 'Config exists');
+    }
+    else {
+        const openspecPath = './openspec';
+        specGenConfig = getDefaultConfig(detection.projectType, openspecPath);
+        await writeSpecGenConfig(rootPath, specGenConfig);
+        const fullOpenspecPath = join(rootPath, openspecPath);
+        if (!(await openspecDirExists(fullOpenspecPath))) {
+            await createOpenSpecStructure(fullOpenspecPath);
+        }
+        const hasGitignore = await gitignoreExists(rootPath);
+        if (hasGitignore) {
+            const alreadyIgnored = await isInGitignore(rootPath, '.spec-gen/');
+            if (!alreadyIgnored) {
+                await addToGitignore(rootPath, '.spec-gen/', 'spec-gen analysis artifacts');
+            }
+        }
+        initResult = {
+            configPath: '.spec-gen/config.json',
+            openspecPath: openspecPath,
+            projectType,
+            created: true,
+        };
+        progress(onProgress, 'Initialization', 'complete');
+    }
+    // Ensure we have config
+    if (!specGenConfig) {
+        specGenConfig = await readSpecGenConfig(rootPath);
+        if (!specGenConfig) {
+            throw new Error('Failed to load configuration');
+        }
+    }
+    // ========================================================================
+    // STEP 2: ANALYSIS
+    // ========================================================================
+    progress(onProgress, 'Analysis', 'start');
+    const analysisPath = join(rootPath, '.spec-gen', 'analysis');
+    let analyzeResult;
+    // Check for existing recent analysis
+    const repoStructurePath = join(analysisPath, 'repo-structure.json');
+    let useExisting = false;
+    if (await fileExists(repoStructurePath)) {
+        const stats = await stat(repoStructurePath);
+        const age = Date.now() - stats.mtime.getTime();
+        const oneHour = 60 * 60 * 1000;
+        if (age < oneHour && !reanalyze && !force) {
+            useExisting = true;
+        }
+    }
+    if (useExisting) {
+        const repoStructureContent = await readFile(repoStructurePath, 'utf-8');
+        const repoStructure = JSON.parse(repoStructureContent);
+        let depGraph;
+        const depGraphPath = join(analysisPath, 'dependency-graph.json');
+        if (await fileExists(depGraphPath)) {
+            const content = await readFile(depGraphPath, 'utf-8');
+            depGraph = JSON.parse(content);
+        }
+        analyzeResult = {
+            repoMap: repoStructure,
+            depGraph: depGraph ?? { nodes: [], edges: [], statistics: { nodeCount: 0, edgeCount: 0, clusterCount: 0, cycleCount: 0, avgDegree: 0 } },
+            artifacts: { 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, 'dependency-graph.json'), 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: 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: 0,
+            },
+            duration: Date.now() - startTime,
+        };
+    }
+    progress(onProgress, 'Generation', 'start');
+    // Check for API key
+    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.');
+    }
+    // Create LLM service
+    const provider = options.provider ?? (anthropicKey ? 'anthropic' : 'openai');
+    const model = options.model ?? 'claude-sonnet-4-20250514';
+    let llm;
+    try {
+        llm = createLLMService({
+            provider,
+            model,
+            apiBase: options.apiBase ?? specGenConfig.llm?.apiBase,
+            sslVerify: options.sslVerify ?? specGenConfig.llm?.sslVerify ?? true,
+            openaiCompatBaseUrl: options.openaiCompatBaseUrl,
+            enableLogging: true,
+            logDir: join(rootPath, '.spec-gen', 'logs'),
+        });
+    }
+    catch (error) {
+        throw new Error(`Failed to create LLM service: ${error.message}`);
+    }
+    // Load analysis data for pipeline
+    const llmContextPath = join(analysisPath, 'llm-context.json');
+    let llmContext;
+    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 },
+        };
+    }
+    const repoStructureContent = await readFile(repoStructurePath, 'utf-8');
+    const repoStructure = JSON.parse(repoStructureContent);
+    // Run pipeline
+    const pipeline = new SpecGenerationPipeline(llm, {
+        outputDir: join(rootPath, '.spec-gen', 'generation'),
+        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: specGenConfig.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: specGenConfig.version ?? '1.0.0',
+            includeMermaid: true,
+        });
+        const adrSpecs = adrGenerator.generateADRs(pipelineResult);
+        generatedSpecs.push(...adrSpecs);
+    }
+    const writer = new OpenSpecWriter({
+        rootPath,
+        writeMode: 'replace',
+        version: specGenConfig.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, '.spec-gen', 'runs');
+    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 @@
+/**
+ * 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 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 specGenGetSpecRequirements(options?: BaseOptions): Promise<{
+    generatedAt?: string;
+    requirements: Record<string, SpecRequirement>;
+}>;
+export default specGenGetSpecRequirements;
+//# 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;AAKH,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,0BAA0B,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC;IACnF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC/C,CAAC,CAoGD;AAED,eAAe,0BAA0B,CAAC"}