spectra-cli 4.1.1

package/dist/panoramic/pipelines/architecture-narrative.js

@@ -0,0 +1,419 @@
+/**
+ * Architecture narrative document builder
+ *
+ * 面向人类阅读的技术架构说明，不替代现有结构化 panoramic 文档，
+ * 而是聚合 module spec、baseline skeleton 与 architecture overview 的事实，
+ * 生成“先说结论 / 关键模块 / 关键类 / 关键方法”的叙事文档。
+ */
+import * as path from 'node:path';
+import { loadStoredModuleSpecs, summarizeStoredMarkdown, } from '../stored-module-specs.js';
+import { loadTemplate } from '../utils/template-loader.js';
+/** Feature 140 — README 摘录在 v4.1 template-based narrative 中的字符上限。Step 4 MapReduce 后取消。*/
+const README_EXCERPT_MAX_CHARS = 1000;
+export function buildArchitectureNarrative(options) {
+    const modules = loadStoredNarrativeModules(options.specsRootDir ?? options.outputDir, options.projectRoot);
+    const projectName = resolveProjectName(options.architectureOverview?.model.projectName, options.projectRoot);
+    const moduleInsights = modules
+        .map((module) => toNarrativeModuleInsight(module))
+        .sort((left, right) => compareModuleInsights(left, right));
+    const keyModules = moduleInsights.slice(0, 6);
+    const keySymbols = collectKeySymbols(moduleInsights).slice(0, 10);
+    const keyMethods = collectKeyMethods(moduleInsights).slice(0, 12);
+    // Feature 140 T31 (FR-009) — 删除 buildRepositoryMap template-fill 路径。
+    // 之前生成的 "项目子域目录，覆盖 N 个模块 / N 个文件" 是固定模板句，不反映项目本质。
+    // 替代方案：buildArchitectureNarrativeWithLLM (Step 4 T32-T34) 通过 cluster-orchestrator
+    // 生成 LLM-driven cluster narrative + key abstractions，覆盖原 repositoryMap 的语义。
+    // .hbs 模板的 {{#each repositoryMap}} 块在空数组下静默跳过（向后兼容）。
+    const repositoryMap = [];
+    const supportingDocs = buildSupportingDocs(options.generatedDocs);
+    const executiveSummary = buildExecutiveSummary(projectName, moduleInsights, keyModules, options.projectContext, options.architectureOverview, supportingDocs);
+    const observations = buildObservations(moduleInsights, options.architectureOverview, supportingDocs);
+    // Feature 140 FR-010 — 截取 README 前 README_EXCERPT_MAX_CHARS 字符；
+    // 不传 readmeContent / 空 readme → 输出不含 readmeExcerpt（向后兼容）
+    const readmeExcerpt = options.readmeContent && options.readmeContent.trim().length > 0
+        ? options.readmeContent.length > README_EXCERPT_MAX_CHARS
+            ? `${options.readmeContent.slice(0, README_EXCERPT_MAX_CHARS).trimEnd()}…`
+            : options.readmeContent
+        : undefined;
+    return {
+        title: `技术架构说明: ${projectName}`,
+        generatedAt: new Date().toISOString().split('T')[0],
+        projectName,
+        executiveSummary,
+        repositoryMap,
+        keyModules,
+        keySymbols,
+        keyMethods,
+        observations,
+        supportingDocs,
+        ...(readmeExcerpt !== undefined ? { readmeExcerpt } : {}),
+    };
+}
+export function renderArchitectureNarrative(output) {
+    const template = loadTemplate('architecture-narrative.hbs', import.meta.url);
+    return template(output);
+}
+export function loadStoredNarrativeModules(outputDir, projectRoot) {
+    return loadStoredModuleSpecs(outputDir, projectRoot);
+}
+function toNarrativeModuleInsight(module) {
+    const role = classifyModuleRole(module.sourceTarget);
+    const keySymbols = collectModuleSymbols(module).slice(0, symbolLimitForRole(role));
+    const keyMethods = collectModuleMethods(module).slice(0, methodLimitForRole(role));
+    const inferred = module.confidence === 'low' || !module.baselineSkeleton;
+    return {
+        sourceTarget: module.sourceTarget,
+        displayName: path.posix.basename(module.sourceTarget),
+        role,
+        relatedFiles: module.relatedFiles,
+        confidence: module.confidence,
+        intentSummary: module.intentSummary,
+        businessSummary: module.businessSummary,
+        dependencySummary: module.dependencySummary,
+        keySymbols,
+        keyMethods,
+        inferred,
+    };
+}
+function collectModuleSymbols(module) {
+    const exports = module.baselineSkeleton?.exports ?? [];
+    return exports
+        .filter((symbol) => isNarrativeSymbolKind(symbol.kind))
+        .map((symbol) => ({
+        moduleName: module.sourceTarget,
+        name: symbol.name,
+        kind: symbol.kind,
+        signature: symbol.signature,
+        note: summarizeSymbolNote(symbol, module.intentSummary),
+        inferred: module.confidence === 'low',
+    }))
+        .sort((left, right) => compareSymbolInsights(left, right));
+}
+function collectModuleMethods(module) {
+    const exports = module.baselineSkeleton?.exports ?? [];
+    const methods = [];
+    const role = classifyModuleRole(module.sourceTarget);
+    for (const symbol of exports) {
+        if (symbol.kind === 'function' && !isLowSignalNarrativeMethod(symbol.name, undefined, role)) {
+            methods.push({
+                moduleName: module.sourceTarget,
+                ownerName: undefined,
+                name: symbol.name,
+                kind: 'function',
+                signature: symbol.signature,
+                note: summarizeSymbolNote(symbol, module.businessSummary),
+                inferred: module.confidence === 'low',
+            });
+        }
+        for (const member of symbol.members ?? []) {
+            if (!isNarrativeMethodKind(member.kind)) {
+                continue;
+            }
+            if (isLowSignalNarrativeMethod(member.name, symbol.name, role)) {
+                continue;
+            }
+            methods.push({
+                moduleName: module.sourceTarget,
+                ownerName: symbol.name,
+                name: member.name,
+                kind: member.kind,
+                signature: member.signature,
+                note: summarizeMemberNote(member, symbol.name, module.businessSummary),
+                inferred: module.confidence === 'low',
+            });
+        }
+    }
+    return methods.sort((left, right) => compareMethodInsights(left, right));
+}
+function collectKeySymbols(modules) {
+    return collectPrioritizedNarrativeItems(modules, (module) => module.keySymbols, (item) => `${item.moduleName}:${item.kind}:${item.name}`, compareSymbolInsights, 10);
+}
+function collectKeyMethods(modules) {
+    return collectPrioritizedNarrativeItems(modules, (module) => module.keyMethods, (item) => `${item.moduleName}:${item.ownerName ?? 'module'}:${item.kind}:${item.name}`, compareMethodInsights, 12);
+}
+// Feature 140 T31 (FR-009) — buildRepositoryMap 已删除（template-fill 路径）。
+// 之前的实现产生固定模板句"项目子域目录，覆盖 N 个模块 / N 个文件"，spec 锁定为
+// "narrative 模板化"质量问题之一。新流程通过 buildArchitectureNarrativeWithLLM
+// （Step 4 T32-T34）的 LLM cluster narrative 生成项目特有的叙事内容。
+function buildSupportingDocs(generatedDocs) {
+    return generatedDocs
+        .map((doc) => {
+        const markdownPath = doc.writtenFiles.find((filePath) => filePath.endsWith('.md'));
+        if (!markdownPath) {
+            return null;
+        }
+        return {
+            generatorId: doc.generatorId,
+            title: humanizeGeneratorId(doc.generatorId),
+            path: path.basename(markdownPath),
+        };
+    })
+        .filter((item) => item !== null)
+        .sort((left, right) => left.title.localeCompare(right.title));
+}
+function buildExecutiveSummary(projectName, modules, keyModules, projectContext, architectureOverview, supportingDocs) {
+    const lines = [];
+    const languages = projectContext.detectedLanguages.length > 0
+        ? projectContext.detectedLanguages.join(' / ')
+        : 'unknown';
+    lines.push(`${projectName} 当前以 ${modules.length} 个模块组织，主要语言为 ${languages}，包管理器为 ${projectContext.packageManager}。`);
+    if (architectureOverview) {
+        lines.push(`结构化架构视图已覆盖 ${architectureOverview.model.stats.availableSections}/${architectureOverview.model.stats.totalSections} 个版块，可进一步下钻 system context / deployment / layered 视图。`);
+    }
+    else {
+        lines.push('当前项目缺少完整部署/monorepo 事实，系统级说明主要基于模块 spec 与源码骨架归纳。');
+    }
+    if (keyModules.length > 0) {
+        lines.push(`关键职责主要集中在 ${keyModules.slice(0, 3).map((item) => `\`${item.sourceTarget}\``).join('、')} 等模块。`);
+    }
+    if (supportingDocs.length > 0) {
+        lines.push(`本次 batch 还产出了 ${supportingDocs.length} 份项目级结构化文档，可与本叙事文档配合阅读。`);
+    }
+    return lines;
+}
+function buildObservations(modules, architectureOverview, supportingDocs) {
+    const observations = new Set();
+    const lowConfidenceCount = modules.filter((module) => module.confidence === 'low').length;
+    if (!architectureOverview) {
+        observations.add('未生成 architecture-overview；当前叙事以模块职责、导出符号与依赖摘要为主。');
+    }
+    else if (architectureOverview.warnings.length > 0) {
+        for (const warning of architectureOverview.warnings.slice(0, 4)) {
+            observations.add(warning);
+        }
+    }
+    if (lowConfidenceCount > 0) {
+        observations.add(`有 ${lowConfidenceCount} 个模块标记为 low confidence，叙事中的部分结论带有 [推断] 性质。`);
+    }
+    if (supportingDocs.length === 0) {
+        observations.add('当前批次未写出额外项目级结构化文档；如需更细粒度视图，需检查 generator 适用性。');
+    }
+    return [...observations];
+}
+function resolveProjectName(explicitName, projectRoot) {
+    return explicitName?.trim() || path.basename(projectRoot);
+}
+function compareModuleInsights(left, right) {
+    const scoreDiff = scoreModuleInsight(right) - scoreModuleInsight(left);
+    return scoreDiff !== 0 ? scoreDiff : left.sourceTarget.localeCompare(right.sourceTarget);
+}
+function scoreModuleInsight(module) {
+    let score = module.relatedFiles.length * 2 + module.keySymbols.length * 3 + module.keyMethods.length * 2;
+    if (module.role === 'core')
+        score += 10;
+    if (module.sourceTarget.includes('core'))
+        score += 4;
+    if (module.sourceTarget.includes('internal'))
+        score += 2;
+    if (module.role === 'support')
+        score -= 2;
+    if (module.role === 'validation')
+        score -= 8;
+    if (module.confidence === 'low')
+        score -= 2;
+    return score;
+}
+function compareSymbolInsights(left, right) {
+    const scoreDiff = scoreSymbolInsight(right) - scoreSymbolInsight(left);
+    if (scoreDiff !== 0) {
+        return scoreDiff;
+    }
+    return `${left.moduleName}:${left.name}`.localeCompare(`${right.moduleName}:${right.name}`);
+}
+function scoreSymbolInsight(item) {
+    let score = 0;
+    if (/(Client|Service|Manager|Parser|Session|Transport|Query|Config|Model|SDK|Server)/.test(item.name))
+        score += 5;
+    if (/(class|data_class|struct|protocol|interface)/.test(item.kind))
+        score += 4;
+    score += Math.min(item.signature.length / 40, 4);
+    if (classifyModuleRole(item.moduleName) === 'core')
+        score += 3;
+    if (classifyModuleRole(item.moduleName) === 'validation')
+        score -= 4;
+    if (item.inferred)
+        score -= 1;
+    return score;
+}
+function compareMethodInsights(left, right) {
+    const scoreDiff = scoreMethodInsight(right) - scoreMethodInsight(left);
+    if (scoreDiff !== 0) {
+        return scoreDiff;
+    }
+    return `${left.moduleName}:${left.ownerName ?? 'module'}:${left.name}`.localeCompare(`${right.moduleName}:${right.ownerName ?? 'module'}:${right.name}`);
+}
+function scoreMethodInsight(item) {
+    let score = 0;
+    if (/(create|connect|query|start|run|handle|parse|generate|initialize|send|receive|load|build|call|stream|execute|process|write|read|resolve)/i.test(item.name)) {
+        score += 6;
+    }
+    if (item.ownerName)
+        score += 2;
+    if (classifyModuleRole(item.moduleName) === 'core')
+        score += 4;
+    if (classifyModuleRole(item.moduleName) === 'support')
+        score -= 1;
+    if (classifyModuleRole(item.moduleName) === 'validation')
+        score -= 6;
+    score += Math.min(item.signature.length / 50, 4);
+    if (item.inferred)
+        score -= 1;
+    return score;
+}
+function collectPrioritizedNarrativeItems(modules, pick, keyOf, compare, limit) {
+    const orderedRoles = ['core', 'support', 'validation'];
+    const results = [];
+    const seen = new Set();
+    for (const role of orderedRoles) {
+        const ranked = modules
+            .filter((module) => module.role === role)
+            .flatMap((module) => pick(module))
+            .sort(compare);
+        for (const item of ranked) {
+            const key = keyOf(item);
+            if (seen.has(key)) {
+                continue;
+            }
+            seen.add(key);
+            results.push(item);
+            if (results.length >= limit) {
+                return results;
+            }
+        }
+    }
+    return results;
+}
+function summarizeSymbolNote(symbol, fallback) {
+    if (symbol.jsDoc?.trim()) {
+        return summarizeStoredMarkdown(symbol.jsDoc, fallback);
+    }
+    return fallback;
+}
+function summarizeMemberNote(member, ownerName, fallback) {
+    if (member.jsDoc?.trim()) {
+        return summarizeStoredMarkdown(member.jsDoc, fallback);
+    }
+    return `${ownerName} 的核心成员；${fallback}`;
+}
+function isNarrativeSymbolKind(kind) {
+    return kind === 'class'
+        || kind === 'interface'
+        || kind === 'type'
+        || kind === 'data_class'
+        || kind === 'struct'
+        || kind === 'protocol';
+}
+function isNarrativeMethodKind(kind) {
+    return kind === 'method'
+        || kind === 'constructor'
+        || kind === 'classmethod'
+        || kind === 'staticmethod'
+        || kind === 'associated_function'
+        || kind === 'getter'
+        || kind === 'setter';
+}
+function humanizeGeneratorId(generatorId) {
+    return generatorId
+        .split('-')
+        .map((part) => {
+        if (part === 'api')
+            return 'API';
+        return part.charAt(0).toUpperCase() + part.slice(1);
+    })
+        .join(' ');
+}
+// Feature 140 T31 (FR-009) — categorizePath 已删除（template-fill 路径）。
+// 之前的 "项目子域目录" 默认分类是 spec 锁定的"narrative 模板化"质量问题。
+// 新流程的目录归类由 LLM cluster narrative 隐式表达，不再生成机械分类标签。
+function classifyModuleRole(sourceTarget) {
+    if (sourceTarget === 'tests'
+        || sourceTarget.startsWith('tests/')
+        || sourceTarget === 'e2e-tests'
+        || sourceTarget.startsWith('e2e-tests/')) {
+        return 'validation';
+    }
+    if (sourceTarget === 'examples'
+        || sourceTarget.startsWith('examples/')
+        || sourceTarget === 'scripts'
+        || sourceTarget.startsWith('scripts/')) {
+        return 'support';
+    }
+    return 'core';
+}
+function symbolLimitForRole(role) {
+    switch (role) {
+        case 'core':
+            return 6;
+        case 'support':
+            return 3;
+        case 'validation':
+            return 2;
+    }
+}
+function methodLimitForRole(role) {
+    switch (role) {
+        case 'core':
+            return 10;
+        case 'support':
+            return 4;
+        case 'validation':
+            return 2;
+    }
+}
+function isLowSignalNarrativeMethod(name, ownerName, role) {
+    if (role !== 'validation') {
+        return false;
+    }
+    return name.startsWith('test_')
+        || name.startsWith('test')
+        || ownerName?.startsWith('Test') === true;
+}
+function dedupeNarrativeItems(items, getKey) {
+    const seen = new Set();
+    const results = [];
+    for (const item of items) {
+        const key = getKey(item);
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        results.push(item);
+    }
+    return results;
+}
+// ============================================================
+// DocumentGenerator Adapter
+// ============================================================
+/**
+ * ArchitectureNarrativeGenerator
+ *
+ * 将 buildArchitectureNarrative() 适配为 DocumentGenerator 接口。
+ * 面向人类阅读的技术架构说明文档。
+ *
+ * TInput: BuildArchitectureNarrativeOptions
+ * TOutput: ArchitectureNarrativeOutput
+ */
+export class ArchitectureNarrativeGenerator {
+    id = 'architecture-narrative';
+    name = '技术架构说明生成器';
+    description = '面向人类阅读的技术架构叙事文档，聚合 module spec 与架构事实，生成关键模块/类/方法的结构化说明';
+    isApplicable(context) {
+        // 检查项目根目录是否存在（最低要求）
+        return Boolean(context.projectRoot);
+    }
+    async extract(context) {
+        return {
+            projectRoot: context.projectRoot,
+            outputDir: context.projectRoot,
+            projectContext: context,
+            generatedDocs: [],
+        };
+    }
+    async generate(input, _options) {
+        return buildArchitectureNarrative(input);
+    }
+    render(output) {
+        return renderArchitectureNarrative(output);
+    }
+}
+//# sourceMappingURL=architecture-narrative.js.map

package/dist/panoramic/pipelines/architecture-narrative.js.map

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

package/dist/panoramic/pipelines/coverage-auditor.d.ts

@@ -0,0 +1,95 @@
+import type { ModuleGroup } from '../../batch/module-grouper.js';
+import type { ProjectContext } from '../interfaces.js';
+import { type DocGraph } from '../builders/doc-graph-builder.js';
+export type CoverageIssue = 'missing-doc' | 'missing-links' | 'dangling-links' | 'low-confidence';
+export type ModuleCoverageStatus = 'documented' | 'missing-doc' | 'attention';
+export interface CoverageTargetUnit {
+    unitName: string;
+    displayName: string;
+    dirPath: string;
+    level: number;
+    sourceFiles: string[];
+}
+export interface ModuleCoverageEntry {
+    moduleName: string;
+    dirPath: string;
+    level: number;
+    sourceFiles: string[];
+    status: ModuleCoverageStatus;
+    issues: CoverageIssue[];
+    specPath?: string;
+    sourceTarget?: string;
+}
+export interface GeneratorCoverageEntry {
+    generatorId: string;
+    generatorName: string;
+    scope: 'project' | 'module';
+    expectedCount: number;
+    generatedCount: number;
+    missingCount: number;
+    coveragePct: number;
+    expectedOutputs: string[];
+    existingOutputs: string[];
+    missingOutputs: string[];
+}
+export interface DanglingLinkEntry {
+    specPath: string;
+    href: string;
+    targetPath: string;
+    anchor?: string;
+    reason: 'missing-file' | 'missing-anchor';
+}
+export interface MissingLinkEntry {
+    specPath: string;
+    sourceTarget: string;
+}
+export interface LowConfidenceSpecEntry {
+    specPath: string;
+    sourceTarget: string;
+    confidence: 'low';
+}
+export interface LevelCoverageEntry {
+    level: number;
+    total: number;
+    documented: number;
+    missingDoc: number;
+    attention: number;
+}
+export interface CoverageSummary {
+    totalModules: number;
+    documentedModules: number;
+    moduleCoveragePct: number;
+    missingDocCount: number;
+    missingLinkCount: number;
+    danglingLinkCount: number;
+    lowConfidenceCount: number;
+    applicableGenerators: number;
+    generatedGeneratorDocs: number;
+}
+export interface CoverageAudit {
+    title: string;
+    generatedAt: string;
+    projectRoot: string;
+    summary: CoverageSummary;
+    moduleCoverage: ModuleCoverageEntry[];
+    missingDocModules: ModuleCoverageEntry[];
+    attentionModules: ModuleCoverageEntry[];
+    generatorCoverage: GeneratorCoverageEntry[];
+    levelCoverage: LevelCoverageEntry[];
+    danglingLinks: DanglingLinkEntry[];
+    missingLinks: MissingLinkEntry[];
+    lowConfidenceSpecs: LowConfidenceSpecEntry[];
+}
+export interface CoverageAuditorOptions {
+    projectRoot: string;
+    outputDir: string;
+    projectContext: ProjectContext;
+    docGraph: DocGraph;
+    moduleGroups: ModuleGroup[];
+}
+export declare class CoverageAuditor {
+    audit(options: CoverageAuditorOptions): Promise<CoverageAudit>;
+    render(audit: CoverageAudit): string;
+    private buildGeneratorCoverage;
+}
+//# sourceMappingURL=coverage-auditor.d.ts.map

package/dist/panoramic/pipelines/coverage-auditor.d.ts.map

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