spectra-cli 4.1.1

package/dist/panoramic/pipelines/coverage-auditor.js

@@ -0,0 +1,290 @@
+/**
+ * CoverageAuditor
+ * 基于 DocGraph、ModuleGroup 和 GeneratorRegistry 生成覆盖率审计结果。
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { GeneratorRegistry, bootstrapGenerators, } from '../generator-registry.js';
+import { resolveSpecForSource, } from '../builders/doc-graph-builder.js';
+import { loadTemplate } from '../utils/template-loader.js';
+import { getBatchProjectOutputFileName, isBatchProjectGeneratorId, } from '../output-filenames.js';
+const ROOT_MODULE_RE = /^root(?:--.+)?$/;
+const SPEC_LINK_RE = /\[[^\]]+\]\(([^)]+?\.spec\.md(?:#[^)]+)?)\)/g;
+export class CoverageAuditor {
+    async audit(options) {
+        const coverageTargets = expandCoverageTargets(options.moduleGroups);
+        const danglingLinks = scanDanglingSpecLinks(options.outputDir, options.projectRoot);
+        const danglingBySpecPath = groupDanglingLinksBySpec(danglingLinks);
+        const missingLinks = options.docGraph.unlinkedSpecs.map((entry) => ({
+            specPath: entry.specPath,
+            sourceTarget: entry.sourceTarget,
+        }));
+        const lowConfidenceSpecs = options.docGraph.specs
+            .filter((spec) => spec.confidence === 'low')
+            .map((spec) => ({
+            specPath: spec.specPath,
+            sourceTarget: spec.sourceTarget,
+            confidence: 'low',
+        }));
+        const moduleCoverage = coverageTargets.map((target) => {
+            const matchedSpecs = target.sourceFiles
+                .map((filePath) => resolveSpecForSource(filePath, options.docGraph.specs))
+                .filter((spec, index, specs) => spec !== undefined
+                && specs.findIndex((candidate) => candidate?.specPath === spec.specPath) === index);
+            const issues = new Set();
+            if (matchedSpecs.length === 0) {
+                issues.add('missing-doc');
+            }
+            for (const spec of matchedSpecs) {
+                if (!spec.linked) {
+                    issues.add('missing-links');
+                }
+                if (spec.confidence === 'low') {
+                    issues.add('low-confidence');
+                }
+                if ((danglingBySpecPath.get(spec.specPath)?.length ?? 0) > 0) {
+                    issues.add('dangling-links');
+                }
+            }
+            const issueList = [...issues].sort(issuePrioritySort);
+            const primarySpec = matchedSpecs[0];
+            const status = issueList.length === 0
+                ? 'documented'
+                : issueList.includes('missing-doc')
+                    ? 'missing-doc'
+                    : 'attention';
+            return {
+                moduleName: target.displayName,
+                dirPath: target.dirPath,
+                level: target.level,
+                sourceFiles: target.sourceFiles,
+                status,
+                issues: issueList,
+                specPath: primarySpec?.specPath,
+                sourceTarget: primarySpec?.sourceTarget,
+            };
+        });
+        const generatorCoverage = await this.buildGeneratorCoverage(options.projectContext, options.outputDir, moduleCoverage);
+        const levelCoverage = summarizeLevelCoverage(moduleCoverage);
+        const documentedModules = moduleCoverage.filter((entry) => !entry.issues.includes('missing-doc')).length;
+        const missingDocCount = moduleCoverage.filter((entry) => entry.issues.includes('missing-doc')).length;
+        const missingLinkCount = moduleCoverage.filter((entry) => entry.issues.includes('missing-links')).length;
+        const moduleGenerator = generatorCoverage.find((entry) => entry.generatorId === 'module-spec');
+        const projectGeneratorEntries = generatorCoverage.filter((entry) => entry.scope === 'project');
+        const generatedGeneratorDocs = projectGeneratorEntries.reduce((sum, entry) => sum + entry.generatedCount, 0);
+        return {
+            title: 'Coverage Audit Report',
+            generatedAt: new Date().toISOString(),
+            projectRoot: options.projectRoot,
+            summary: {
+                totalModules: coverageTargets.length,
+                documentedModules,
+                moduleCoveragePct: percent(documentedModules, coverageTargets.length),
+                missingDocCount,
+                missingLinkCount,
+                danglingLinkCount: danglingLinks.length,
+                lowConfidenceCount: lowConfidenceSpecs.length,
+                applicableGenerators: projectGeneratorEntries.length + (moduleGenerator ? 1 : 0),
+                generatedGeneratorDocs,
+            },
+            moduleCoverage: moduleCoverage.sort((a, b) => a.moduleName.localeCompare(b.moduleName)),
+            missingDocModules: moduleCoverage
+                .filter((entry) => entry.issues.includes('missing-doc'))
+                .sort((a, b) => a.moduleName.localeCompare(b.moduleName)),
+            attentionModules: moduleCoverage
+                .filter((entry) => entry.status === 'attention')
+                .sort((a, b) => a.moduleName.localeCompare(b.moduleName)),
+            generatorCoverage,
+            levelCoverage,
+            danglingLinks,
+            missingLinks,
+            lowConfidenceSpecs,
+        };
+    }
+    render(audit) {
+        const template = loadTemplate('coverage-report.hbs', import.meta.url);
+        return template(audit);
+    }
+    async buildGeneratorCoverage(projectContext, outputDir, moduleCoverage) {
+        bootstrapGenerators();
+        const registry = GeneratorRegistry.getInstance();
+        const moduleSpecCoverage = {
+            generatorId: 'module-spec',
+            generatorName: '模块 Spec',
+            scope: 'module',
+            expectedCount: moduleCoverage.length,
+            generatedCount: moduleCoverage.filter((entry) => !entry.issues.includes('missing-doc')).length,
+            missingCount: moduleCoverage.filter((entry) => entry.issues.includes('missing-doc')).length,
+            coveragePct: percent(moduleCoverage.filter((entry) => !entry.issues.includes('missing-doc')).length, moduleCoverage.length),
+            expectedOutputs: moduleCoverage.map((entry) => entry.moduleName),
+            existingOutputs: moduleCoverage
+                .map((entry) => entry.specPath)
+                .filter((item) => typeof item === 'string'),
+            missingOutputs: moduleCoverage
+                .filter((entry) => entry.issues.includes('missing-doc'))
+                .map((entry) => entry.moduleName),
+        };
+        const applicableGenerators = (await registry.filterByContext(projectContext))
+            .filter((generator) => isBatchProjectGeneratorId(generator.id));
+        const projectEntries = applicableGenerators.map((generator) => {
+            const expectedFile = getBatchProjectOutputFileName(generator.id);
+            const expectedOutputs = [expectedFile];
+            const existingOutputs = expectedOutputs.filter((fileName) => fs.existsSync(path.join(outputDir, fileName)));
+            return {
+                generatorId: generator.id,
+                generatorName: generator.name,
+                scope: 'project',
+                expectedCount: expectedOutputs.length,
+                generatedCount: existingOutputs.length,
+                missingCount: expectedOutputs.length - existingOutputs.length,
+                coveragePct: percent(existingOutputs.length, expectedOutputs.length),
+                expectedOutputs,
+                existingOutputs,
+                missingOutputs: expectedOutputs.filter((item) => !existingOutputs.includes(item)),
+            };
+        });
+        return [moduleSpecCoverage, ...projectEntries].sort((left, right) => left.generatorId.localeCompare(right.generatorId));
+    }
+}
+function expandCoverageTargets(moduleGroups) {
+    return moduleGroups.flatMap((group) => {
+        if (ROOT_MODULE_RE.test(group.name)) {
+            return group.files.map((filePath) => ({
+                unitName: filePath,
+                displayName: filePath,
+                dirPath: path.posix.dirname(filePath) === '.' ? filePath : path.posix.dirname(filePath),
+                level: path.posix.dirname(filePath) === '.' ? 0 : path.posix.dirname(filePath).split('/').length,
+                sourceFiles: [filePath],
+            }));
+        }
+        return [{
+                unitName: group.name,
+                displayName: group.name,
+                dirPath: group.dirPath,
+                level: group.name.split('/').length - 1,
+                sourceFiles: [...group.files].sort((a, b) => a.localeCompare(b)),
+            }];
+    });
+}
+function scanDanglingSpecLinks(outputDir, projectRoot) {
+    if (!fs.existsSync(outputDir)) {
+        return [];
+    }
+    const markdownFiles = [];
+    walkMarkdownFiles(outputDir, markdownFiles);
+    const issues = [];
+    for (const filePath of markdownFiles) {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const matches = content.matchAll(SPEC_LINK_RE);
+        for (const match of matches) {
+            const href = match[1];
+            if (!href) {
+                continue;
+            }
+            const [targetFilePart, anchor] = href.split('#');
+            if (!targetFilePart) {
+                continue;
+            }
+            const targetAbs = path.resolve(path.dirname(filePath), targetFilePart);
+            const normalizedSource = normalizeProjectPath(filePath, projectRoot);
+            const normalizedTarget = normalizeProjectPath(targetAbs, projectRoot);
+            if (!fs.existsSync(targetAbs)) {
+                issues.push({
+                    specPath: normalizedSource,
+                    href,
+                    targetPath: normalizedTarget,
+                    anchor,
+                    reason: 'missing-file',
+                });
+                continue;
+            }
+            if (anchor && !hasAnchor(targetAbs, anchor)) {
+                issues.push({
+                    specPath: normalizedSource,
+                    href,
+                    targetPath: normalizedTarget,
+                    anchor,
+                    reason: 'missing-anchor',
+                });
+            }
+        }
+    }
+    return issues.sort((a, b) => {
+        const left = `${a.specPath}:${a.href}`;
+        const right = `${b.specPath}:${b.href}`;
+        return left.localeCompare(right);
+    });
+}
+function walkMarkdownFiles(dir, results) {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isSymbolicLink()) {
+            continue;
+        }
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            walkMarkdownFiles(fullPath, results);
+            continue;
+        }
+        if (entry.isFile() && entry.name.endsWith('.md')) {
+            results.push(fullPath);
+        }
+    }
+}
+function hasAnchor(filePath, anchor) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return content.includes(`id="${anchor}"`) || content.includes(`name="${anchor}"`);
+}
+function groupDanglingLinksBySpec(danglingLinks) {
+    const grouped = new Map();
+    for (const issue of danglingLinks) {
+        if (!grouped.has(issue.specPath)) {
+            grouped.set(issue.specPath, []);
+        }
+        grouped.get(issue.specPath).push(issue);
+    }
+    return grouped;
+}
+function summarizeLevelCoverage(moduleCoverage) {
+    const levels = new Map();
+    for (const entry of moduleCoverage) {
+        if (!levels.has(entry.level)) {
+            levels.set(entry.level, {
+                level: entry.level,
+                total: 0,
+                documented: 0,
+                missingDoc: 0,
+                attention: 0,
+            });
+        }
+        const levelEntry = levels.get(entry.level);
+        levelEntry.total += 1;
+        if (entry.status === 'documented')
+            levelEntry.documented += 1;
+        if (entry.status === 'missing-doc')
+            levelEntry.missingDoc += 1;
+        if (entry.status === 'attention')
+            levelEntry.attention += 1;
+    }
+    return [...levels.values()].sort((a, b) => a.level - b.level);
+}
+function percent(numerator, denominator) {
+    if (denominator === 0)
+        return 100;
+    return Math.round((numerator / denominator) * 1000) / 10;
+}
+function issuePrioritySort(left, right) {
+    const order = [
+        'missing-doc',
+        'dangling-links',
+        'missing-links',
+        'low-confidence',
+    ];
+    return order.indexOf(left) - order.indexOf(right);
+}
+function normalizeProjectPath(inputPath, projectRoot) {
+    const relative = path.isAbsolute(inputPath)
+        ? path.relative(projectRoot, inputPath)
+        : inputPath;
+    return relative.split(path.sep).join('/');
+}
+//# sourceMappingURL=coverage-auditor.js.map

package/dist/panoramic/pipelines/coverage-auditor.js.map

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

package/dist/panoramic/pipelines/debt-intelligence-pipeline.d.ts

@@ -0,0 +1,32 @@
+import type { LanguageAdapterRegistry } from '../../adapters/language-adapter-registry.js';
+import type { SimpleLLMClient } from '../../debt-scanner/design-docs/llm-topic-inferrer.js';
+import type { TokenUsage } from '../../debt-scanner/types.js';
+export interface DebtPipelineOptions {
+    projectRoot: string;
+    /** batch 输出目录（= specsDir，含 modules/project/_meta 子目录） */
+    specsDir: string;
+    registry: LanguageAdapterRegistry;
+    /**
+     * 可选：语言过滤 adapter id 列表（例如 ['python']）。
+     * 传入时让 debt 扫描只覆盖 batch 本次处理的语言子集，避免发布 out-of-scope 的债务。
+     */
+    languages?: string[];
+    llmClient?: SimpleLLMClient;
+    budgetLimit?: number;
+    dryRun?: boolean;
+}
+export interface DebtPipelineResult {
+    generated: boolean;
+    entriesCount: number;
+    openQuestionsCount: number;
+    tokenUsage: TokenUsage;
+    durationMs: number;
+    /** 相对 specsDir 的输出路径；未生成为 null */
+    outputPath: string | null;
+    qualityReportPatched: boolean;
+    readmeIndexed: boolean;
+    fallbackReason?: string;
+    diagnostics: string[];
+}
+export declare function generateDebtIntelligence(options: DebtPipelineOptions): Promise<DebtPipelineResult>;
+//# sourceMappingURL=debt-intelligence-pipeline.d.ts.map

package/dist/panoramic/pipelines/debt-intelligence-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debt-intelligence-pipeline.d.ts","sourceRoot":"","sources":["../../../src/panoramic/pipelines/debt-intelligence-pipeline.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAK3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AAC5F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,uBAAuB,CAAC;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAcD,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAqF7B"}

package/dist/panoramic/pipelines/debt-intelligence-pipeline.js

@@ -0,0 +1,108 @@
+/**
+ * Debt Intelligence pipeline
+ *
+ * batch-orchestrator 调用入口。封装：
+ * 1. scanProjectDebt（代码注释 + design-doc open questions）
+ * 2. 写入 <specsDir>/project/technical-debt.md
+ * 3. 若 quality-report.md 存在则追加 "## 技术债" 节
+ * 4. 若 specs/README.md 存在则在 "质量审计" 节插入链接
+ *
+ * 任何单步失败都 try/catch；返回 result 且包含 diagnostics。
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { scanProjectDebt, describeScannedLanguages } from '../../debt-scanner/index.js';
+import { buildDebtReportFromReport } from '../../debt-scanner/aggregator/report-builder.js';
+import { patchQualityReportWithDebt } from '../../debt-scanner/aggregator/quality-report-patcher.js';
+import { indexDebtInReadme } from '../../debt-scanner/aggregator/readme-indexer.js';
+const EMPTY_RESULT = Object.freeze({
+    generated: false,
+    entriesCount: 0,
+    openQuestionsCount: 0,
+    tokenUsage: { input: 0, output: 0 },
+    durationMs: 0,
+    outputPath: null,
+    qualityReportPatched: false,
+    readmeIndexed: false,
+    diagnostics: [],
+});
+export async function generateDebtIntelligence(options) {
+    const t0 = Date.now();
+    const diagnostics = [];
+    let report;
+    try {
+        report = await scanProjectDebt({
+            projectRoot: options.projectRoot,
+            registry: options.registry,
+            languages: options.languages,
+            llmClient: options.llmClient,
+            budgetLimit: options.budgetLimit,
+            dryRun: options.dryRun,
+        });
+    }
+    catch (err) {
+        diagnostics.push(`scanProjectDebt 失败：${err.message}`);
+        return { ...EMPTY_RESULT, diagnostics, durationMs: Date.now() - t0 };
+    }
+    diagnostics.push(...report.diagnostics.messages);
+    // Feature 145 P2（T021）：诊断日志输出 docsScanned、openQuestions.length、ruleCandidates
+    // 字段名与 DebtDiagnostics 定义保持一致；ruleCandidates 表示规则匹配阶段被识别为候选 open question 的数量。
+    // 用于排查 P2 根因：docsScanned=0 说明 projectRoot 传值有问题；docsScanned>0 但 openQuestions 为空说明内容匹配问题
+    diagnostics.push(`扫描 ${report.diagnostics.filesScanned} 个源文件，跳过 ${report.diagnostics.filesSkipped} 个，` +
+        `扫描 ${report.diagnostics.docsScanned} 个 design-doc，` +
+        `发现 ${report.openQuestions.length} 个 open question（ruleCandidates=${report.diagnostics.ruleCandidates}），` +
+        `LLM 调用 ${report.diagnostics.llmCalls} 次`);
+    // 报告中的语言标签严格遵循 languages 过滤器，避免列出未扫描的语言
+    const languages = describeScannedLanguages(options.registry, options.languages);
+    const markdown = buildDebtReportFromReport(report, languages);
+    const projectDir = path.join(options.specsDir, 'project');
+    const outputAbs = path.join(projectDir, 'technical-debt.md');
+    try {
+        fs.mkdirSync(projectDir, { recursive: true });
+        fs.writeFileSync(outputAbs, markdown, 'utf-8');
+    }
+    catch (err) {
+        diagnostics.push(`写入 technical-debt.md 失败：${err.message}`);
+        return {
+            ...EMPTY_RESULT,
+            diagnostics,
+            durationMs: Date.now() - t0,
+            tokenUsage: report.tokenUsage,
+            fallbackReason: report.fallbackReason,
+        };
+    }
+    // 仅当存在内容才追加到 quality-report.md（AC-4.3）
+    let qualityReportPatched = false;
+    if (report.codeEntries.length > 0 || report.openQuestions.length > 0) {
+        try {
+            qualityReportPatched = patchQualityReportWithDebt({
+                qualityReportPath: path.join(projectDir, 'quality-report.md'),
+                metrics: report.metrics,
+            });
+        }
+        catch (err) {
+            diagnostics.push(`quality-report 追加失败：${err.message}`);
+        }
+    }
+    // 说明：batch 路径上 specs/README.md 由 batch-readme-generator 在 debt pipeline 之后重写，
+    // 所以这里的 indexDebtInReadme 即便成功也会被 batch 覆写。为了避免"看起来生效实际没用"的假阳性，
+    // 在批处理上下文中直接 skip：README 入口由 batch-readme-generator 统一拥有（它会检测
+    // project/technical-debt.md 是否存在并生成链接）。
+    //
+    // indexDebtInReadme 仍保留在 aggregator 中供独立调用 scanProjectDebt 的 caller 使用。
+    const readmeIndexed = false;
+    void indexDebtInReadme; // 显式保留 import（向外暴露）
+    return {
+        generated: true,
+        entriesCount: report.codeEntries.length,
+        openQuestionsCount: report.openQuestions.length,
+        tokenUsage: report.tokenUsage,
+        durationMs: Date.now() - t0,
+        outputPath: path.relative(options.specsDir, outputAbs).split(path.sep).join('/'),
+        qualityReportPatched,
+        readmeIndexed,
+        fallbackReason: report.fallbackReason,
+        diagnostics,
+    };
+}
+//# sourceMappingURL=debt-intelligence-pipeline.js.map

package/dist/panoramic/pipelines/debt-intelligence-pipeline.js.map

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

package/dist/panoramic/pipelines/docs-bundle-manifest-reader.d.ts

@@ -0,0 +1,26 @@
+export interface BundleNavigationReference {
+    title: string;
+    path?: string;
+    children: BundleNavigationReference[];
+}
+export interface BundleProfileReference {
+    id: string;
+    title: string;
+    rootDir?: string;
+    docsRoot?: string;
+    landingPagePath?: string;
+    documentIds: string[];
+    navigation: BundleNavigationReference[];
+}
+export interface DocsBundleManifestReference {
+    sourcePath: string;
+    version?: number;
+    generatedAt?: string;
+    profiles: BundleProfileReference[];
+}
+export interface ReadDocsBundleManifestResult {
+    manifest?: DocsBundleManifestReference;
+    warnings: string[];
+}
+export declare function readDocsBundleManifest(outputDir: string, projectRoot?: string): ReadDocsBundleManifestResult;
+//# sourceMappingURL=docs-bundle-manifest-reader.d.ts.map

package/dist/panoramic/pipelines/docs-bundle-manifest-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-bundle-manifest-reader.d.ts","sourceRoot":"","sources":["../../../src/panoramic/pipelines/docs-bundle-manifest-reader.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,yBAAyB,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,yBAAyB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,sBAAsB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,2BAA2B,CAAC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAID,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,4BAA4B,CAuC9B"}

package/dist/panoramic/pipelines/docs-bundle-manifest-reader.js

@@ -0,0 +1,108 @@
+/**
+ * Docs bundle manifest reader
+ *
+ * 059 只做 055 manifest 的轻量读取与降级，不重做 bundle orchestration。
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { parseYamlDocument, } from '../parsers/yaml-config-parser.js';
+const CANDIDATE_MANIFEST_NAMES = ['docs-bundle.yaml', 'docs-bundle.yml'];
+export function readDocsBundleManifest(outputDir, projectRoot) {
+    const warnings = [];
+    // 在 outputDir 及其 _meta/ 子目录中查找 manifest（兼容新旧布局）
+    const searchDirs = [outputDir, path.join(outputDir, '_meta')];
+    const manifestPath = searchDirs
+        .flatMap((dir) => CANDIDATE_MANIFEST_NAMES.map((fileName) => path.join(dir, fileName)))
+        .find((candidatePath) => fs.existsSync(candidatePath));
+    if (!manifestPath) {
+        return {
+            manifest: undefined,
+            warnings: ['未找到 docs-bundle manifest，将以 partial 模式降级 required-doc 的发布覆盖校验。'],
+        };
+    }
+    try {
+        const parsed = parseYamlDocument(fs.readFileSync(manifestPath, 'utf-8'));
+        const profiles = readProfileReferences(parsed.profiles);
+        if (profiles.length === 0) {
+            warnings.push('docs-bundle manifest 已存在，但未解析到有效 profile。');
+        }
+        return {
+            manifest: {
+                sourcePath: normalizeProjectPath(manifestPath, projectRoot),
+                version: asNumber(parsed.version),
+                generatedAt: asString(parsed.generatedAt),
+                profiles,
+            },
+            warnings,
+        };
+    }
+    catch (error) {
+        return {
+            manifest: undefined,
+            warnings: [`docs-bundle manifest 读取失败: ${String(error)}`],
+        };
+    }
+}
+function readProfileReferences(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .map((entry) => (isYamlObject(entry) ? entry : undefined))
+        .filter((entry) => Boolean(entry))
+        .map((entry) => ({
+        id: asString(entry.id) ?? 'unknown',
+        title: asString(entry.title) ?? asString(entry.id) ?? 'Unknown Profile',
+        rootDir: asString(entry.rootDir),
+        docsRoot: asString(entry.docsRoot),
+        landingPagePath: asString(entry.landingPagePath),
+        documentIds: readDocumentIds(entry.documents),
+        navigation: readNavigation(entry.navigation),
+    }));
+}
+function readDocumentIds(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .map((entry) => (isYamlObject(entry) ? asString(entry.sourceId) : undefined))
+        .filter((entry) => Boolean(entry))
+        .sort((left, right) => left.localeCompare(right));
+}
+function readNavigation(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .map((entry) => readNavigationNode(entry))
+        .filter((entry) => Boolean(entry));
+}
+function readNavigationNode(value) {
+    if (!isYamlObject(value)) {
+        return undefined;
+    }
+    return {
+        title: asString(value.title) ?? 'Untitled',
+        path: asString(value.path),
+        children: readNavigation(value.children),
+    };
+}
+function asString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+function asNumber(value) {
+    return typeof value === 'number' ? value : undefined;
+}
+function isYamlObject(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function normalizeProjectPath(candidatePath, projectRoot) {
+    if (!projectRoot) {
+        return candidatePath.split(path.sep).join('/');
+    }
+    const relative = path.relative(projectRoot, candidatePath);
+    return relative.startsWith('..')
+        ? candidatePath.split(path.sep).join('/')
+        : relative.split(path.sep).join('/');
+}
+//# sourceMappingURL=docs-bundle-manifest-reader.js.map

package/dist/panoramic/pipelines/docs-bundle-manifest-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-bundle-manifest-reader.js","sourceRoot":"","sources":["../../../src/panoramic/pipelines/docs-bundle-manifest-reader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EACL,iBAAiB,GAIlB,MAAM,kCAAkC,CAAC;AA8B1C,MAAM,wBAAwB,GAAG,CAAC,kBAAkB,EAAE,iBAAiB,CAAU,CAAC;AAElF,MAAM,UAAU,sBAAsB,CACpC,SAAiB,EACjB,WAAoB;IAEpB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,gDAAgD;IAChD,MAAM,UAAU,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,UAAU;SAC5B,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;SACtF,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC;IAEzD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO;YACL,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,CAAC,gEAAgE,CAAC;SAC7E,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;QACzE,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAExD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO;YACL,QAAQ,EAAE;gBACR,UAAU,EAAE,oBAAoB,CAAC,YAAY,EAAE,WAAW,CAAC;gBAC3D,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;gBACjC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC;gBACzC,QAAQ;aACT;YACD,QAAQ;SACT,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,CAAC,8BAA8B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;SAC1D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,KAA4B;IACzD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;SACzD,MAAM,CAAC,CAAC,KAAK,EAAuB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;SACtD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,SAAS;QACnC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,iBAAiB;QACvE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;QAChC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC;QAClC,eAAe,EAAE,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC;QAChD,WAAW,EAAE,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC;QAC7C,UAAU,EAAE,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC;KAC7C,CAAC,CAAC,CAAC;AACR,CAAC;AAED,SAAS,eAAe,CAAC,KAA4B;IACnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;SAC5E,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;SAClD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,cAAc,CAAC,KAA4B;IAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;SACzC,MAAM,CAAC,CAAC,KAAK,EAAsC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAgB;IAC1C,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,UAAU;QAC1C,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QAC1B,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAA4B;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,QAAQ,CAAC,KAA4B;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,YAAY,CAAC,KAA4B;IAChD,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,oBAAoB,CAAC,aAAqB,EAAE,WAAoB;IACvE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC3D,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;QAC9B,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACzC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC"}

package/dist/panoramic/pipelines/docs-bundle-orchestrator.d.ts

@@ -0,0 +1,16 @@
+import { type DocsBundleInput, type DocsBundleResult } from '../models/docs-bundle-types.js';
+interface OrchestratorPaths {
+    projectRoot: string;
+    outputDir: string;
+    outputDirRelative: string;
+}
+export interface OrchestrateDocsBundleOptions {
+    projectRoot: string;
+    outputDir: string;
+    /** docs-bundle.yaml 写入目录（默认 outputDir） */
+    metaDir?: string;
+}
+export declare function orchestrateDocsBundle(options: OrchestrateDocsBundleOptions): DocsBundleResult;
+export declare function buildDocsBundleInput(paths: OrchestratorPaths): DocsBundleInput;
+export {};
+//# sourceMappingURL=docs-bundle-orchestrator.d.ts.map

package/dist/panoramic/pipelines/docs-bundle-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-bundle-orchestrator.d.ts","sourceRoot":"","sources":["../../../src/panoramic/pipelines/docs-bundle-orchestrator.ts"],"names":[],"mappings":"AASA,OAAO,EAQL,KAAK,eAAe,EAGpB,KAAK,gBAAgB,EAGtB,MAAM,gCAAgC,CAAC;AA2GxC,UAAU,iBAAiB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAYD,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,gBAAgB,CAkClB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,eAAe,CAY9E"}