spec-gen-cli 1.0.0

package/dist/core/generator/stages/stage2-entities.js

@@ -0,0 +1,67 @@
+/**
+ * Stage 2: Entity Extraction
+ *
+ * Extracts core data models/entities from schema files.
+ */
+import logger from '../../../utils/logger.js';
+import { PROMPTS } from '../prompts.js';
+export async function runStage2(pipeline, survey, schemaFiles, onFile) {
+    const startTime = Date.now();
+    const systemPrompt = PROMPTS.stage2_entities(survey.projectCategory, survey.frameworks);
+    const allEntities = [];
+    const seenNames = new Set();
+    for (const [idx, file] of schemaFiles.entries()) {
+        onFile?.(idx + 1, schemaFiles.length, file.path);
+        const chunks = pipeline.chunkContent(file.content, 8000);
+        const isLargeFile = chunks.length > 1;
+        const graphSection = pipeline.graphPromptFor(file.path, file.content);
+        if (isLargeFile && !graphSection) {
+            logger.warning(`Stage 2: ${file.path} too large (${chunks.length} parts) — entity spec may be incomplete`);
+        }
+        const entitiesFromFile = [];
+        // Use graph-based prompt for large files when call graph is available
+        const fileChunks = graphSection ? [graphSection] : chunks;
+        for (let i = 0; i < fileChunks.length; i++) {
+            const chunkNote = !graphSection && isLargeFile ? ` (part ${i + 1}/${fileChunks.length})` : '';
+            const userPrompt = `Analyze this schema/model file and extract entities:\n\n=== ${file.path}${chunkNote} ===\n${fileChunks[i]}`;
+            try {
+                const result = await pipeline.llm.completeJSON({
+                    systemPrompt,
+                    userPrompt,
+                    temperature: 0.3,
+                    maxTokens: 4000,
+                });
+                if (Array.isArray(result)) {
+                    for (const entity of result) {
+                        if (!seenNames.has(entity.name)) {
+                            seenNames.add(entity.name);
+                            entity.location = file.path; // always use the actual file, not the LLM's guess
+                            entitiesFromFile.push(entity);
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                logger.warning(`Stage 2: failed to analyze ${file.path}${chunkNote}: ${error.message}`);
+            }
+        }
+        if (isLargeFile && !graphSection) {
+            for (const entity of entitiesFromFile) {
+                entity.description = `[PARTIAL SPEC — file too large to fully analyze (${chunks.length} parts)] ${entity.description}`;
+            }
+        }
+        allEntities.push(...entitiesFromFile);
+    }
+    const stageResult = {
+        stage: 'entities',
+        success: true,
+        data: allEntities,
+        tokens: pipeline.llm.getTokenUsage().totalTokens,
+        duration: Date.now() - startTime,
+    };
+    if (pipeline.options.saveIntermediate) {
+        await pipeline.saveResult('stage2-entities', stageResult);
+    }
+    return stageResult;
+}
+//# sourceMappingURL=stage2-entities.js.map

package/dist/core/generator/stages/stage2-entities.js.map

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

package/dist/core/generator/stages/stage3-services.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Stage 3: Service Analysis
+ *
+ * Extracts services/modules from business logic files.
+ */
+import type { ExtractedEntity, ExtractedService, StageResult, PipelineContext, ProjectSurveyResult } from '../../../types/pipeline.js';
+export declare function runStage3(pipeline: PipelineContext, survey: ProjectSurveyResult, entities: ExtractedEntity[], serviceFiles: Array<{
+    path: string;
+    content: string;
+}>, onFile?: (i: number, total: number, file: string) => void): Promise<StageResult<ExtractedService[]>>;
+//# sourceMappingURL=stage3-services.d.ts.map

package/dist/core/generator/stages/stage3-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage3-services.d.ts","sourceRoot":"","sources":["../../../../src/core/generator/stages/stage3-services.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEvI,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,eAAe,EAAE,EAC3B,YAAY,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EACtD,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GACxD,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAyE1C"}

package/dist/core/generator/stages/stage3-services.js

@@ -0,0 +1,75 @@
+/**
+ * Stage 3: Service Analysis
+ *
+ * Extracts services/modules from business logic files.
+ */
+import logger from '../../../utils/logger.js';
+import { PROMPTS } from '../prompts.js';
+export async function runStage3(pipeline, survey, entities, serviceFiles, onFile) {
+    const startTime = Date.now();
+    const entityNames = entities.map(e => e.name);
+    const systemPrompt = PROMPTS.stage3_services(survey.projectCategory, entityNames, survey.suggestedDomains ?? []);
+    const allServices = [];
+    const seenNames = new Set();
+    for (const [idx, file] of serviceFiles.entries()) {
+        onFile?.(idx + 1, serviceFiles.length, file.path);
+        const chunks = pipeline.chunkContent(file.content, 8000);
+        const isLargeFile = chunks.length > 1;
+        const graphSection = pipeline.graphPromptFor(file.path, file.content);
+        if (isLargeFile && !graphSection) {
+            logger.warning(`Stage 3: ${file.path} too large (${chunks.length} parts) — service spec may be incomplete`);
+        }
+        const servicesFromFile = [];
+        const fileChunks = graphSection ? [graphSection] : chunks;
+        for (let i = 0; i < fileChunks.length; i++) {
+            const chunkNote = !graphSection && isLargeFile ? ` (part ${i + 1}/${fileChunks.length})` : '';
+            const userPrompt = `Analyze this file and extract services/modules:\n\n=== ${file.path}${chunkNote} ===\n${fileChunks[i]}`;
+            try {
+                const result = await pipeline.llm.completeJSON({
+                    systemPrompt,
+                    userPrompt,
+                    temperature: 0.3,
+                    maxTokens: 4000,
+                });
+                if (Array.isArray(result)) {
+                    for (const service of result) {
+                        if (!seenNames.has(service.name)) {
+                            seenNames.add(service.name);
+                            servicesFromFile.push(service);
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                logger.warning(`Stage 3: failed to analyze ${file.path}${chunkNote}: ${error.message}`);
+            }
+        }
+        if (isLargeFile && !graphSection) {
+            for (const service of servicesFromFile) {
+                service.purpose = `[PARTIAL SPEC — file too large to fully analyze (${chunks.length} parts)] ${service.purpose}`;
+            }
+        }
+        // For god-function files analyzed via graph, generate hierarchical sub-specs
+        if (graphSection && servicesFromFile.length > 0) {
+            for (const service of servicesFromFile) {
+                const subSpecs = await pipeline.generateSubSpecs(file.path, service.name, service.purpose);
+                if (subSpecs.length > 0) {
+                    service.subSpecs = subSpecs;
+                }
+            }
+        }
+        allServices.push(...servicesFromFile);
+    }
+    const stageResult = {
+        stage: 'services',
+        success: true,
+        data: allServices,
+        tokens: pipeline.llm.getTokenUsage().totalTokens,
+        duration: Date.now() - startTime,
+    };
+    if (pipeline.options.saveIntermediate) {
+        await pipeline.saveResult('stage3-services', stageResult);
+    }
+    return stageResult;
+}
+//# sourceMappingURL=stage3-services.js.map

package/dist/core/generator/stages/stage3-services.js.map

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

package/dist/core/generator/stages/stage4-api.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Stage 4: API Extraction
+ *
+ * Extracts API endpoints from route/controller files.
+ */
+import type { ExtractedEndpoint, StageResult, PipelineContext } from '../../../types/pipeline.js';
+export declare function runStage4(pipeline: PipelineContext, apiFiles: Array<{
+    path: string;
+    content: string;
+}>, onFile?: (i: number, total: number, file: string) => void): Promise<StageResult<ExtractedEndpoint[]>>;
+//# sourceMappingURL=stage4-api.d.ts.map

package/dist/core/generator/stages/stage4-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage4-api.d.ts","sourceRoot":"","sources":["../../../../src/core/generator/stages/stage4-api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElG,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GACxD,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC,CAAC,CA6D3C"}

package/dist/core/generator/stages/stage4-api.js

@@ -0,0 +1,65 @@
+/**
+ * Stage 4: API Extraction
+ *
+ * Extracts API endpoints from route/controller files.
+ */
+import logger from '../../../utils/logger.js';
+import { PROMPTS } from '../prompts.js';
+export async function runStage4(pipeline, apiFiles, onFile) {
+    const startTime = Date.now();
+    const allEndpoints = [];
+    const seenPaths = new Set();
+    for (const [idx, file] of apiFiles.entries()) {
+        onFile?.(idx + 1, apiFiles.length, file.path);
+        const chunks = pipeline.chunkContent(file.content, 8000);
+        const isLargeFile = chunks.length > 1;
+        const graphSection = pipeline.graphPromptFor(file.path, file.content);
+        if (isLargeFile && !graphSection) {
+            logger.warning(`Stage 4: ${file.path} too large (${chunks.length} parts) — endpoint spec may be incomplete`);
+        }
+        const endpointsFromFile = [];
+        const fileChunks = graphSection ? [graphSection] : chunks;
+        for (let i = 0; i < fileChunks.length; i++) {
+            const chunkNote = !graphSection && isLargeFile ? ` (part ${i + 1}/${fileChunks.length})` : '';
+            const userPrompt = `Analyze this API/route file and extract endpoints:\n\n=== ${file.path}${chunkNote} ===\n${fileChunks[i]}`;
+            try {
+                const result = await pipeline.llm.completeJSON({
+                    systemPrompt: PROMPTS.stage4_api,
+                    userPrompt,
+                    temperature: 0.3,
+                    maxTokens: 4000,
+                });
+                if (Array.isArray(result)) {
+                    for (const endpoint of result) {
+                        const key = `${endpoint.method}:${endpoint.path}`;
+                        if (!seenPaths.has(key)) {
+                            seenPaths.add(key);
+                            endpointsFromFile.push(endpoint);
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                logger.warning(`Stage 4: failed to analyze ${file.path}${chunkNote}: ${error.message}`);
+            }
+        }
+        if (isLargeFile && !graphSection) {
+            for (const endpoint of endpointsFromFile) {
+                endpoint.purpose = `[PARTIAL SPEC — file too large to fully analyze (${chunks.length} parts)] ${endpoint.purpose}`;
+            }
+        }
+        allEndpoints.push(...endpointsFromFile);
+    }
+    const stageResult = {
+        stage: 'api',
+        success: true,
+        data: allEndpoints,
+        tokens: pipeline.llm.getTokenUsage().totalTokens,
+        duration: Date.now() - startTime,
+    };
+    if (pipeline.options.saveIntermediate) {
+        await pipeline.saveResult('stage4-api', stageResult);
+    }
+    return stageResult;
+}
+//# sourceMappingURL=stage4-api.js.map

package/dist/core/generator/stages/stage4-api.js.map

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

package/dist/core/generator/stages/stage5-architecture.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Stage 5: Architecture Synthesis
+ *
+ * Synthesizes architecture overview from previous analysis results.
+ */
+import type { ArchitectureSynthesis, ExtractedEntity, ExtractedEndpoint, ExtractedService, PipelineContext, ProjectSurveyResult, StageResult } from '../../../types/pipeline.js';
+import type { DependencyGraphResult } from '../../analyzer/dependency-graph.js';
+import type { SerializedCallGraph } from '../../analyzer/call-graph.js';
+export declare function runStage5(pipeline: PipelineContext, survey: ProjectSurveyResult, entities: ExtractedEntity[], services: ExtractedService[], endpoints: ExtractedEndpoint[], depGraph?: DependencyGraphResult, callGraph?: SerializedCallGraph): Promise<StageResult<ArchitectureSynthesis>>;
+//# sourceMappingURL=stage5-architecture.d.ts.map

package/dist/core/generator/stages/stage5-architecture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage5-architecture.d.ts","sourceRoot":"","sources":["../../../../src/core/generator/stages/stage5-architecture.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,WAAW,EACZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,EAAE,eAAe,EAAE,EAC3B,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,SAAS,EAAE,iBAAiB,EAAE,EAC9B,QAAQ,CAAC,EAAE,qBAAqB,EAChC,SAAS,CAAC,EAAE,mBAAmB,GAC9B,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC,CA0D7C"}

package/dist/core/generator/stages/stage5-architecture.js

@@ -0,0 +1,62 @@
+/**
+ * Stage 5: Architecture Synthesis
+ *
+ * Synthesizes architecture overview from previous analysis results.
+ */
+import { PROMPTS } from '../prompts.js';
+export async function runStage5(pipeline, survey, entities, services, endpoints, depGraph, callGraph) {
+    const startTime = Date.now();
+    const userPrompt = `Synthesize the architecture from this analysis:
+
+Entities (${entities.length}):
+${entities.map(e => `- ${e.name}: ${e.description}`).join('\n')}
+
+Services (${services.length}):
+${services.map(s => `- ${s.name}: ${s.purpose}`).join('\n')}
+
+Endpoints (${endpoints.length}):
+${endpoints.map(e => `- ${e.method} ${e.path}: ${e.purpose}`).join('\n')}
+
+${depGraph ? `Dependency Graph:
+- Nodes: ${depGraph.statistics.nodeCount}
+- Edges: ${depGraph.statistics.edgeCount}
+- Clusters: ${depGraph.statistics.clusterCount}
+- Cycles: ${depGraph.statistics.cycleCount}` : ''}${callGraph && callGraph.stats.totalNodes > 0 ? `
+
+Call Graph (static analysis — ${callGraph.stats.totalNodes} functions, ${callGraph.stats.totalEdges} internal calls):
+${callGraph.hubFunctions.length > 0 ? `Hub functions (called by many others — likely integration points):
+${callGraph.hubFunctions.slice(0, 8).map(n => `- ${n.name} (${n.filePath}, fanIn=${n.fanIn}, fanOut=${n.fanOut}${n.className ? `, class=${n.className}` : ''})`).join('\n')}` : ''}
+${callGraph.entryPoints.length > 0 ? `\nEntry points (no internal callers — likely public API or CLI handlers):
+${callGraph.entryPoints.slice(0, 8).map(n => `- ${n.name} (${n.filePath}${n.isAsync ? ', async' : ''})`).join('\n')}` : ''}
+${callGraph.layerViolations.length > 0 ? `\nLayer violations detected:
+${callGraph.layerViolations.slice(0, 5).map(v => `- ${v.reason}`).join('\n')}` : ''}` : ''}`;
+    try {
+        const result = await pipeline.llm.completeJSON({
+            systemPrompt: PROMPTS.stage5_architecture(survey),
+            userPrompt,
+            temperature: 0.3,
+            maxTokens: 3000,
+        });
+        const stageResult = {
+            stage: 'architecture',
+            success: true,
+            data: result,
+            tokens: pipeline.llm.getTokenUsage().totalTokens,
+            duration: Date.now() - startTime,
+        };
+        if (pipeline.options.saveIntermediate) {
+            await pipeline.saveResult('stage5-architecture', stageResult);
+        }
+        return stageResult;
+    }
+    catch (error) {
+        return {
+            stage: 'architecture',
+            success: false,
+            error: error.message,
+            tokens: 0,
+            duration: Date.now() - startTime,
+        };
+    }
+}
+//# sourceMappingURL=stage5-architecture.js.map

package/dist/core/generator/stages/stage5-architecture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage5-architecture.js","sourceRoot":"","sources":["../../../../src/core/generator/stages/stage5-architecture.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAaxC,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAyB,EACzB,MAA2B,EAC3B,QAA2B,EAC3B,QAA4B,EAC5B,SAA8B,EAC9B,QAAgC,EAChC,SAA+B;IAE/B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,MAAM,UAAU,GAAG;;YAET,QAAQ,CAAC,MAAM;EACzB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;YAEnD,QAAQ,CAAC,MAAM;EACzB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;aAE9C,SAAS,CAAC,MAAM;EAC3B,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;EAEtE,QAAQ,CAAC,CAAC,CAAC;WACF,QAAQ,CAAC,UAAU,CAAC,SAAS;WAC7B,QAAQ,CAAC,UAAU,CAAC,SAAS;cAC1B,QAAQ,CAAC,UAAU,CAAC,YAAY;YAClC,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC;;gCAElE,SAAS,CAAC,KAAK,CAAC,UAAU,eAAe,SAAS,CAAC,KAAK,CAAC,UAAU;EACjG,SAAS,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;EACpC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,WAAW,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;EAChL,SAAS,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;EACnC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;EACxH,SAAS,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;EACvC,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAE3F,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAwB;YACpE,YAAY,EAAE,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC;YACjD,UAAU;YACV,WAAW,EAAE,GAAG;YAChB,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,MAAM,WAAW,GAAuC;YACtD,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,WAAW;YAChD,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACjC,CAAC;QAEF,IAAI,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;YACtC,MAAM,QAAQ,CAAC,UAAU,CAAC,qBAAqB,EAAE,WAAW,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE,KAAK;YACd,KAAK,EAAG,KAAe,CAAC,OAAO;YAC/B,MAAM,EAAE,CAAC;YACT,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACjC,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/core/generator/stages/stage6-adr.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Stage 6: ADR Enrichment
+ *
+ * Expands architectural decisions into full ADRs.
+ */
+import type { ArchitectureSynthesis, EnrichedADR, PipelineContext, StageResult } from '../../../types/pipeline.js';
+export declare function runStage6(pipeline: PipelineContext, architecture: ArchitectureSynthesis): Promise<StageResult<EnrichedADR[]>>;
+//# sourceMappingURL=stage6-adr.d.ts.map

package/dist/core/generator/stages/stage6-adr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage6-adr.d.ts","sourceRoot":"","sources":["../../../../src/core/generator/stages/stage6-adr.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEnH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,eAAe,EACzB,YAAY,EAAE,qBAAqB,GAClC,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,CAqCrC"}

package/dist/core/generator/stages/stage6-adr.js

@@ -0,0 +1,41 @@
+/**
+ * Stage 6: ADR Enrichment
+ *
+ * Expands architectural decisions into full ADRs.
+ */
+import { PROMPTS } from '../prompts.js';
+export async function runStage6(pipeline, architecture) {
+    const startTime = Date.now();
+    const userPrompt = `Expand these ${architecture.keyDecisions.length} architectural decisions into full ADRs:
+
+${architecture.keyDecisions.map((d, i) => `${i + 1}. ${d}`).join('\n')}`;
+    try {
+        const result = await pipeline.llm.completeJSON({
+            systemPrompt: PROMPTS.stage6_adr(architecture),
+            userPrompt,
+            temperature: 0.3,
+            maxTokens: 5000,
+        });
+        const stageResult = {
+            stage: 'adr',
+            success: true,
+            data: result,
+            tokens: pipeline.llm.getTokenUsage().totalTokens,
+            duration: Date.now() - startTime,
+        };
+        if (pipeline.options.saveIntermediate) {
+            await pipeline.saveResult('stage6-adr-enrichment', stageResult);
+        }
+        return stageResult;
+    }
+    catch (error) {
+        return {
+            stage: 'adr',
+            success: false,
+            error: error.message,
+            tokens: 0,
+            duration: Date.now() - startTime,
+        };
+    }
+}
+//# sourceMappingURL=stage6-adr.js.map

package/dist/core/generator/stages/stage6-adr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage6-adr.js","sourceRoot":"","sources":["../../../../src/core/generator/stages/stage6-adr.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAyB,EACzB,YAAmC;IAEnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,MAAM,UAAU,GAAG,gBAAgB,YAAY,CAAC,YAAY,CAAC,MAAM;;EAEnE,YAAY,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAEvE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAgB;YAC5D,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC;YAC9C,UAAU;YACV,WAAW,EAAE,GAAG;YAChB,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,MAAM,WAAW,GAA+B;YAC9C,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,WAAW;YAChD,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACjC,CAAC;QAEF,IAAI,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;YACtC,MAAM,QAAQ,CAAC,UAAU,CAAC,uBAAuB,EAAE,WAAW,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,KAAK;YACd,KAAK,EAAG,KAAe,CAAC,OAAO;YAC/B,MAAM,EAAE,CAAC;YACT,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACjC,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/core/services/chat-agent.d.ts

@@ -0,0 +1,45 @@
+/**
+ * ChatAgent — agentic tool-use loop for the diagram chatbot.
+ *
+ * Supports three provider formats:
+ *   - Anthropic Claude   (tool_use / tool_result via /v1/messages)
+ *   - OpenAI-compatible  (function calling via /chat/completions)
+ *   - Google Gemini      (function calling via generateContent)
+ *
+ * Provider resolution (same priority as generate.ts):
+ *   1. GEMINI_API_KEY                → Gemini
+ *   2. ANTHROPIC_API_KEY             → Anthropic Claude
+ *   3. OPENAI_COMPAT_BASE_URL        → any OpenAI-compatible endpoint
+ *   4. specGenConfig.generation      → reads provider + openaiCompatBaseUrl from config
+ *   5. OPENAI_API_KEY                → OpenAI directly
+ *
+ * Model: OPENAI_COMPAT_MODEL env var → specGenConfig.generation.model → provider default.
+ *
+ * Max iterations: 8 (prevents runaway loops).
+ */
+type ProviderKind = 'gemini' | 'anthropic' | 'openai-compat';
+interface ProviderConfig {
+    kind: ProviderKind;
+    baseUrl: string;
+    apiKey: string;
+    model: string;
+}
+export declare function resolveProviderConfig(directory: string): Promise<ProviderConfig>;
+export interface ChatAgentOptions {
+    directory: string;
+    messages: {
+        role: 'user' | 'assistant';
+        content: string;
+    }[];
+    modelOverride?: string;
+    signal?: AbortSignal;
+    onToolStart?: (name: string) => void;
+    onToolEnd?: (name: string) => void;
+}
+export interface ChatAgentResult {
+    reply: string;
+    filePaths: string[];
+}
+export declare function runChatAgent(options: ChatAgentOptions): Promise<ChatAgentResult>;
+export {};
+//# sourceMappingURL=chat-agent.d.ts.map

package/dist/core/services/chat-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-agent.d.ts","sourceRoot":"","sources":["../../../src/core/services/chat-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAyEH,KAAK,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,eAAe,CAAC;AAE7D,UAAU,cAAc;IACtB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA+CtF;AAMD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAqSD,wBAAsB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAQtF"}