spectra-cli 4.1.1

package/dist/panoramic/pipelines/docs-quality-evaluator.d.ts

@@ -0,0 +1,55 @@
+import type { DocumentGenerator, GenerateOptions, ProjectContext } from '../interfaces.js';
+import type { ArchitectureNarrativeOutput, BatchGeneratedDocSummary } from './architecture-narrative.js';
+import type { ArchitectureOverviewOutput } from '../generators/architecture-overview-generator.js';
+import type { PatternHintsOutput } from '../models/pattern-hints-model.js';
+import type { ComponentViewOutput, DynamicScenariosOutput } from '../models/component-view-model.js';
+import type { RuntimeTopologyOutput } from '../generators/runtime-topology-generator.js';
+import type { AdrIndexOutput } from './adr-decision-pipeline.js';
+import type { FeatureBriefIndexOutput, ProductOverviewOutput, UserJourneysOutput } from './product-ux-docs.js';
+import type { DocsBundleManifestReference } from './docs-bundle-manifest-reader.js';
+import { type DocsQualityReport } from '../models/docs-quality-model.js';
+export interface EvaluateDocsQualityOptions {
+    projectRoot: string;
+    outputDir: string;
+    projectContext?: ProjectContext;
+    generatedDocs: BatchGeneratedDocSummary[];
+    architectureNarrative: ArchitectureNarrativeOutput;
+    architectureOverview?: ArchitectureOverviewOutput;
+    patternHints?: PatternHintsOutput;
+    componentView?: ComponentViewOutput;
+    dynamicScenarios?: DynamicScenariosOutput;
+    runtimeTopology?: RuntimeTopologyOutput;
+    adrIndex?: AdrIndexOutput;
+    productOverview?: ProductOverviewOutput;
+    userJourneys?: UserJourneysOutput;
+    featureBriefIndex?: FeatureBriefIndexOutput;
+    docsBundleManifest?: DocsBundleManifestReference;
+    dependencyWarnings?: string[];
+}
+export declare function evaluateDocsQuality(options: EvaluateDocsQualityOptions): DocsQualityReport;
+export declare function renderDocsQualityReport(report: DocsQualityReport): string;
+/**
+ * DocsQualityEvaluatorGenerator
+ *
+ * 将 evaluateDocsQuality() 适配为 DocumentGenerator 接口。
+ * 编排感知型 extract：从 outputDir 读取上游 JSON 产物（各字段均可选）。
+ * generate() 无 fs 写出副作用（纯计算）。
+ * render() 调用 renderDocsQualityReport() 返回 Markdown 质量报告。
+ *
+ * 必须最后注册，确保上游 JSON 产物已写出。
+ *
+ * TInput: EvaluateDocsQualityOptions
+ * TOutput: DocsQualityReport
+ */
+export declare class DocsQualityEvaluatorGenerator implements DocumentGenerator<EvaluateDocsQualityOptions, DocsQualityReport> {
+    readonly id: "docs-quality-evaluator";
+    readonly name: "\u6587\u6863\u8D28\u91CF\u8BC4\u4F30\u5668";
+    readonly description = "\u805A\u5408\u8BC4\u4F30\u5404\u4E0A\u6E38\u4EA7\u7269\u7684 provenance\u3001conflict \u4E0E required-doc \u8986\u76D6\uFF0C\u751F\u6210\u603B\u4F53\u8D28\u91CF\u7ED3\u8BBA\u62A5\u544A";
+    private readonly outputDir;
+    constructor(outputDir: string);
+    isApplicable(context: ProjectContext): boolean;
+    extract(context: ProjectContext): Promise<EvaluateDocsQualityOptions>;
+    generate(input: EvaluateDocsQualityOptions, _options?: GenerateOptions): Promise<DocsQualityReport>;
+    render(output: DocsQualityReport): string;
+}
+//# sourceMappingURL=docs-quality-evaluator.d.ts.map

package/dist/panoramic/pipelines/docs-quality-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-quality-evaluator.d.ts","sourceRoot":"","sources":["../../../src/panoramic/pipelines/docs-quality-evaluator.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,KAAK,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACzG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kDAAkD,CAAC;AACnG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AACrG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,KAAK,EAAY,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,EASL,KAAK,iBAAiB,EAMvB,MAAM,iCAAiC,CAAC;AAKzC,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,aAAa,EAAE,wBAAwB,EAAE,CAAC;IAC1C,qBAAqB,EAAE,2BAA2B,CAAC;IACnD,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAClD,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;IAC5C,kBAAkB,CAAC,EAAE,2BAA2B,CAAC;IACjD,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAiOD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,iBAAiB,CAqD1F;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAGzE;AAg1BD;;;;;;;;;;;;GAYG;AACH,qBAAa,6BACX,YAAW,iBAAiB,CAAC,0BAA0B,EAAE,iBAAiB,CAAC;IAE3E,QAAQ,CAAC,EAAE,EAAG,wBAAwB,CAAU;IAChD,QAAQ,CAAC,IAAI,EAAG,4CAAS,CAAU;IACnC,QAAQ,CAAC,WAAW,8LAAiE;IAErF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,SAAS,EAAE,MAAM;IAI7B,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;IAKxC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAgFrE,QAAQ,CACZ,KAAK,EAAE,0BAA0B,EACjC,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,iBAAiB,CAAC;IAK7B,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;CAG1C"}