spectra-cli 4.1.1

package/dist/panoramic/generators/mock-readme-generator.js

@@ -0,0 +1,113 @@
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('mock-readme-generator');
+// ============================================================
+// MockReadmeGenerator 实现
+// ============================================================
+/**
+ * Mock README 文档生成器
+ * 实现 DocumentGenerator<ReadmeInput, ReadmeOutput> 接口的全部方法，
+ * 作为接口设计的冒烟验证。
+ *
+ * 生命周期：isApplicable -> extract -> generate -> render
+ */
+export class MockReadmeGenerator {
+    /** 唯一标识符 */
+    id = 'mock-readme';
+    /** 显示名称 */
+    name = 'Mock README Generator';
+    /** 功能描述 */
+    description = '从 package.json 提取项目信息，生成简单的 README.md 文档';
+    /**
+     * 判断当前项目是否适用此 Generator
+     * 同步检查 configFiles 中是否包含 package.json
+     *
+     * @param context - 项目上下文
+     * @returns 如果 configFiles 包含 package.json 则返回 true
+     */
+    isApplicable(context) {
+        return context.configFiles.has('package.json');
+    }
+    /**
+     * 从项目上下文中提取 README 所需的输入数据
+     * 读取 package.json 内容提取 name 和 description，缺失时使用默认值
+     *
+     * @param context - 项目上下文
+     * @returns ReadmeInput 数据
+     */
+    async extract(context) {
+        const packageJsonContent = context.configFiles.get('package.json');
+        if (!packageJsonContent) {
+            return {
+                projectName: 'unknown-project',
+                description: 'No description provided',
+                hasPackageJson: false,
+            };
+        }
+        try {
+            const parsed = JSON.parse(packageJsonContent);
+            return {
+                projectName: typeof parsed['name'] === 'string' ? parsed['name'] : 'unknown-project',
+                description: typeof parsed['description'] === 'string' ? parsed['description'] : 'No description provided',
+                hasPackageJson: true,
+            };
+        }
+        catch (err) {
+            logger.debug(`package.json JSON 解析失败，使用默认值: ${String(err)}`);
+            return {
+                projectName: 'unknown-project',
+                description: 'No description provided',
+                hasPackageJson: true,
+            };
+        }
+    }
+    /**
+     * 将 ReadmeInput 转换为 ReadmeOutput
+     * 生成包含 Installation 和 Usage 两个默认 section 的文档结构
+     *
+     * @param input - extract 步骤的输出
+     * @param _options - 生成选项（当前未使用）
+     * @returns ReadmeOutput 文档结构
+     */
+    async generate(input, _options) {
+        const sections = [
+            {
+                heading: 'Installation',
+                content: `npm install ${input.projectName}`,
+            },
+            {
+                heading: 'Usage',
+                content: `Import and use ${input.projectName} in your project.`,
+            },
+        ];
+        return {
+            title: input.projectName,
+            description: input.description,
+            sections,
+        };
+    }
+    /**
+     * 将 ReadmeOutput 渲染为 Markdown 字符串
+     * 同步拼接标题 + 描述 + sections
+     *
+     * @param output - generate 步骤的输出
+     * @returns Markdown 字符串
+     */
+    render(output) {
+        const lines = [];
+        // 标题
+        lines.push(`# ${output.title}`);
+        lines.push('');
+        // 描述
+        lines.push(output.description);
+        lines.push('');
+        // 各章节
+        for (const section of output.sections) {
+            lines.push(`## ${section.heading}`);
+            lines.push('');
+            lines.push(section.content);
+            lines.push('');
+        }
+        return lines.join('\n').trimEnd() + '\n';
+    }
+}
+//# sourceMappingURL=mock-readme-generator.js.map

package/dist/panoramic/generators/mock-readme-generator.js.map

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

package/dist/panoramic/generators/pattern-hints-generator.d.ts

@@ -0,0 +1,28 @@
+/**
+ * PatternHintsGenerator
+ *
+ * 组合 045 的架构概览输出，生成规则驱动的模式提示与 explanation 附录。
+ */
+import type { DocumentGenerator, GenerateOptions, ProjectContext } from '../interfaces.js';
+import { ArchitectureOverviewGenerator } from './architecture-overview-generator.js';
+import { type PatternHint, type PatternHintsInput, type PatternHintsOutput, type PatternKnowledgeBaseEntry } from '../models/pattern-hints-model.js';
+export type PatternHintsLLMEnhancer = (hints: PatternHint[], input: PatternHintsInput) => Promise<PatternHint[]>;
+export interface PatternHintsGeneratorDependencies {
+    architectureOverviewGenerator?: ArchitectureOverviewGenerator;
+    knowledgeBase?: readonly PatternKnowledgeBaseEntry[];
+    llmEnhancer?: PatternHintsLLMEnhancer;
+}
+export declare class PatternHintsGenerator implements DocumentGenerator<PatternHintsInput, PatternHintsOutput> {
+    readonly id: "pattern-hints";
+    readonly name: "\u67B6\u6784\u6A21\u5F0F\u63D0\u793A\u751F\u6210\u5668";
+    readonly description = "\u57FA\u4E8E\u67B6\u6784\u6982\u89C8\u5171\u4EAB\u6A21\u578B\u751F\u6210\u6A21\u5F0F\u63D0\u793A\u3001\u8BC1\u636E\u94FE\u4E0E explanation \u9644\u5F55";
+    private readonly architectureOverviewGenerator;
+    private readonly knowledgeBase;
+    private readonly llmEnhancer;
+    constructor(dependencies?: PatternHintsGeneratorDependencies);
+    isApplicable(context: ProjectContext): boolean | Promise<boolean>;
+    extract(context: ProjectContext): Promise<PatternHintsInput>;
+    generate(input: PatternHintsInput, options?: GenerateOptions): Promise<PatternHintsOutput>;
+    render(output: PatternHintsOutput): string;
+}
+//# sourceMappingURL=pattern-hints-generator.d.ts.map

package/dist/panoramic/generators/pattern-hints-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-hints-generator.d.ts","sourceRoot":"","sources":["../../../src/panoramic/generators/pattern-hints-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AAKrF,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC/B,MAAM,kCAAkC,CAAC;AAQ1C,MAAM,MAAM,uBAAuB,GAAG,CACpC,KAAK,EAAE,WAAW,EAAE,EACpB,KAAK,EAAE,iBAAiB,KACrB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;AAE5B,MAAM,WAAW,iCAAiC;IAChD,6BAA6B,CAAC,EAAE,6BAA6B,CAAC;IAC9D,aAAa,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACrD,WAAW,CAAC,EAAE,uBAAuB,CAAC;CACvC;AAED,qBAAa,qBACX,YAAW,iBAAiB,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IAEnE,QAAQ,CAAC,EAAE,EAAG,eAAe,CAAU;IACvC,QAAQ,CAAC,IAAI,EAAG,wDAAW,CAAU;IACrC,QAAQ,CAAC,WAAW,6JAA0C;IAE9D,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAgC;IAC9E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuC;IACrE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;gBAE1C,YAAY,GAAE,iCAAsC;IAMhE,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3D,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAe5D,QAAQ,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiDhG,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM;CAM3C"}

package/dist/panoramic/generators/pattern-hints-generator.js

@@ -0,0 +1,170 @@
+/**
+ * PatternHintsGenerator
+ *
+ * 组合 045 的架构概览输出，生成规则驱动的模式提示与 explanation 附录。
+ */
+import { ArchitectureOverviewGenerator } from './architecture-overview-generator.js';
+import { DEFAULT_PATTERN_KNOWLEDGE_BASE, evaluatePatternHints, } from '../models/pattern-knowledge-base.js';
+import { summarizePatternHints, } from '../models/pattern-hints-model.js';
+import { loadTemplate } from '../utils/template-loader.js';
+import { callLLM, extractJsonArray } from '../utils/llm-facade.js';
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('pattern-hints-generator');
+export class PatternHintsGenerator {
+    id = 'pattern-hints';
+    name = '架构模式提示生成器';
+    description = '基于架构概览共享模型生成模式提示、证据链与 explanation 附录';
+    architectureOverviewGenerator;
+    knowledgeBase;
+    llmEnhancer;
+    constructor(dependencies = {}) {
+        this.architectureOverviewGenerator = dependencies.architectureOverviewGenerator ?? new ArchitectureOverviewGenerator();
+        this.knowledgeBase = dependencies.knowledgeBase ?? DEFAULT_PATTERN_KNOWLEDGE_BASE;
+        this.llmEnhancer = dependencies.llmEnhancer ?? defaultPatternHintsLLMEnhancer;
+    }
+    isApplicable(context) {
+        return this.architectureOverviewGenerator.isApplicable(context);
+    }
+    async extract(context) {
+        const architectureOverview = await this.architectureOverviewGenerator.generate(await this.architectureOverviewGenerator.extract(context));
+        return {
+            architectureOverview,
+            warnings: [...architectureOverview.warnings],
+            weakSignals: {
+                runtimeAvailable: architectureOverview.deploymentView?.available ?? false,
+                docGraphAvailable: context.existingSpecs.length > 0,
+            },
+        };
+    }
+    async generate(input, options) {
+        const evaluation = evaluatePatternHints({
+            architectureOverview: input.architectureOverview,
+            weakSignals: input.weakSignals,
+        }, this.knowledgeBase);
+        const warnings = new Set([
+            ...input.warnings,
+            ...input.architectureOverview.warnings,
+            ...evaluation.warnings,
+        ]);
+        let matchedPatterns = evaluation.matchedPatterns;
+        if (options?.useLLM && matchedPatterns.length > 0) {
+            try {
+                matchedPatterns = await this.llmEnhancer(matchedPatterns, input);
+            }
+            catch (error) {
+                warnings.add(`LLM explanation 增强失败，已回退规则输出: ${String(error)}`);
+            }
+        }
+        const normalizedWarnings = uniqueSorted([...warnings]);
+        const model = {
+            projectName: input.architectureOverview.model.projectName,
+            matchedPatterns,
+            noHighConfidenceMatch: matchedPatterns.length === 0,
+            alternatives: evaluation.alternatives,
+            warnings: normalizedWarnings,
+            stats: summarizePatternHints({
+                matchedPatterns,
+                warnings: normalizedWarnings,
+            }, evaluation.totalPatternsEvaluated),
+        };
+        return {
+            title: `架构模式提示: ${model.projectName}`,
+            generatedAt: input.architectureOverview.generatedAt,
+            architectureOverview: input.architectureOverview,
+            model,
+            warnings: normalizedWarnings,
+        };
+    }
+    render(output) {
+        const overviewMarkdown = this.architectureOverviewGenerator.render(output.architectureOverview).trimEnd();
+        const appendixTemplate = loadTemplate('pattern-hints.hbs', import.meta.url);
+        const appendixMarkdown = appendixTemplate(output).trim();
+        return `${overviewMarkdown}\n\n${appendixMarkdown}\n`;
+    }
+}
+async function defaultPatternHintsLLMEnhancer(hints, input) {
+    if (hints.length === 0) {
+        return hints;
+    }
+    const systemPrompt = [
+        '你是架构文档说明增强器。',
+        '你的任务不是重新判断模式，也不是修改 confidence、evidence 或 alternatives。',
+        '你只能在既有结构化事实基础上，重写 explanation 和 summary 的中文表述。',
+        '若输入包含 [推断] 或证据不足信息，输出必须保留这种不确定性。',
+        '严格输出 JSON 数组，每个元素包含 patternId、summary、explanation 三个字段，不要输出其他内容。',
+    ].join('\n');
+    const userPrompt = JSON.stringify({
+        projectName: input.architectureOverview.model.projectName,
+        patterns: hints.map((hint) => ({
+            patternId: hint.patternId,
+            patternName: hint.patternName,
+            summary: hint.summary,
+            explanation: hint.explanation,
+            matchedSignals: hint.matchedSignals,
+            missingSignals: hint.missingSignals,
+            alternatives: hint.competingAlternatives.map((alternative) => ({
+                patternName: alternative.patternName,
+                reason: alternative.reason,
+            })),
+            inferred: hint.inferred,
+        })),
+    });
+    // 使用 llm-facade 统一调用门面
+    const responseText = await callLLM(userPrompt, {
+        systemPrompt,
+        timeout: 2500,
+        maxTokens: 1024,
+        temperature: 0.2,
+    });
+    if (!responseText) {
+        return hints;
+    }
+    const parsed = parsePatternHintsEnhancement(responseText);
+    if (!parsed) {
+        return hints;
+    }
+    const updates = new Map(parsed.map((item) => [item.patternId, item]));
+    return hints.map((hint) => {
+        const update = updates.get(hint.patternId);
+        if (!update) {
+            return hint;
+        }
+        const summary = normalizeInferenceMarker(update.summary?.trim() || hint.summary, hint.inferred);
+        const explanation = normalizeInferenceMarker(update.explanation?.trim() || hint.explanation, hint.inferred);
+        return {
+            ...hint,
+            summary,
+            explanation,
+        };
+    });
+}
+function parsePatternHintsEnhancement(text) {
+    try {
+        const parsed = extractJsonArray(text);
+        if (!Array.isArray(parsed)) {
+            return null;
+        }
+        return parsed
+            .filter((item) => typeof item === 'object' && item !== null)
+            .filter((item) => typeof item['patternId'] === 'string')
+            .map((item) => ({
+            patternId: String(item['patternId']),
+            summary: typeof item['summary'] === 'string' ? item['summary'] : undefined,
+            explanation: typeof item['explanation'] === 'string' ? item['explanation'] : undefined,
+        }));
+    }
+    catch (err) {
+        logger.debug(`LLM 响应解析失败，跳过增强: ${String(err)}`);
+        return null;
+    }
+}
+function normalizeInferenceMarker(text, inferred) {
+    if (!inferred || text.includes('[推断]')) {
+        return text;
+    }
+    return `${text} [推断]`;
+}
+function uniqueSorted(values) {
+    return [...new Set(values)].sort((left, right) => left.localeCompare(right));
+}
+//# sourceMappingURL=pattern-hints-generator.js.map

package/dist/panoramic/generators/pattern-hints-generator.js.map

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

package/dist/panoramic/generators/runtime-topology-generator.d.ts

@@ -0,0 +1,77 @@
+import type { DocumentGenerator, GenerateOptions, ProjectContext } from '../interfaces.js';
+import type { DockerfileInfo } from '../parsers/types.js';
+import type { YamlArray, YamlValue } from '../parsers/yaml-config-parser.js';
+import { type RuntimeConfigHint, type RuntimeDependency, type RuntimeEnvironmentVariable, type RuntimePortBinding, type RuntimeTopology, type RuntimeTopologyStats, type RuntimeVolumeMount } from '../models/runtime-topology-model.js';
+interface ComposeBuildDefinition {
+    context: string;
+    dockerfilePath?: string;
+    targetStage?: string;
+}
+interface ComposeServiceDefinition {
+    name: string;
+    sourceFile: string;
+    image?: string;
+    build?: ComposeBuildDefinition;
+    containerName: string;
+    command?: string;
+    entrypoint?: string;
+    environment: RuntimeEnvironmentVariable[];
+    envFiles: string[];
+    ports: RuntimePortBinding[];
+    volumes: RuntimeVolumeMount[];
+    dependsOn: RuntimeDependency[];
+}
+interface ComposeFileDefinition {
+    filePath: string;
+    services: ComposeServiceDefinition[];
+}
+interface DockerfileArtifact {
+    filePath: string;
+    relativePath: string;
+    parsed: DockerfileInfo;
+    serviceNames: string[];
+    runtimeTargets: string[];
+}
+interface RuntimeEnvFile {
+    filePath: string;
+    entries: RuntimeEnvironmentVariable[];
+}
+export interface RuntimeTopologyInput {
+    projectName: string;
+    composeFiles: ComposeFileDefinition[];
+    dockerfiles: DockerfileArtifact[];
+    envFiles: RuntimeEnvFile[];
+    configHints: RuntimeConfigHint[];
+    warnings: string[];
+}
+export interface RuntimeTopologyOutput {
+    title: string;
+    generatedAt: string;
+    topology: RuntimeTopology;
+    stats: RuntimeTopologyStats;
+    warnings: string[];
+}
+/**
+ * 运行时拓扑生成器。
+ */
+export declare class RuntimeTopologyGenerator implements DocumentGenerator<RuntimeTopologyInput, RuntimeTopologyOutput> {
+    readonly id: "runtime-topology";
+    readonly name: "\u8FD0\u884C\u65F6\u62D3\u6251\u751F\u6210\u5668";
+    readonly description = "\u8054\u5408\u89E3\u6790 Compose\u3001Dockerfile\u3001.env \u548C\u914D\u7F6E\u63D0\u793A\uFF0C\u751F\u6210\u7EDF\u4E00\u8FD0\u884C\u65F6\u62D3\u6251\u6A21\u578B";
+    isApplicable(context: ProjectContext): boolean;
+    extract(context: ProjectContext): Promise<RuntimeTopologyInput>;
+    generate(input: RuntimeTopologyInput, _options?: GenerateOptions): Promise<RuntimeTopologyOutput>;
+    render(output: RuntimeTopologyOutput): string;
+    private extractComposeFiles;
+    private extractDockerfiles;
+    private extractEnvFiles;
+    private extractRuntimeConfigHints;
+}
+declare function parseComposeFile(projectRoot: string, composePath: string, content: string): ComposeFileDefinition;
+declare function parseComposeShortPort(rawPort: string, sourceFile: string): RuntimePortBinding;
+declare function parseComposeShortVolume(rawVolume: string, sourceFile: string): RuntimeVolumeMount;
+declare function discoverComposeFiles(projectRoot: string, configFiles: Map<string, string>): string[];
+declare function dedupeConfigHints(configHints: RuntimeConfigHint[]): RuntimeConfigHint[];
+declare function _isYamlArray(value: YamlValue | undefined): value is YamlArray;
+export { discoverComposeFiles as _discoverComposeFiles, parseComposeFile as _parseComposeFile, parseComposeShortPort as _parseComposeShortPort, parseComposeShortVolume as _parseComposeShortVolume, dedupeConfigHints as _dedupeConfigHints, _isYamlArray, };
+//# sourceMappingURL=runtime-topology-generator.d.ts.map

package/dist/panoramic/generators/runtime-topology-generator.d.ts.map

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