spectra-cli 4.1.1

package/dist/models/module-spec.d.ts

@@ -0,0 +1,1905 @@
+/**
+ * ModuleSpec、ArchitectureIndex、DriftReport、BatchState、RedactionResult
+ * 及所有相关嵌套实体的 Zod Schema 定义
+ */
+import { z } from 'zod';
+/** 架构索引中展示的语言分布汇总信息 */
+export declare const LanguageDistributionSchema: z.ZodObject<{
+    /** 语言显示名称（如 'TypeScript'） */
+    language: z.ZodString;
+    /** 适配器 ID（如 'ts-js'） */
+    adapterId: z.ZodString;
+    /** 文件数 */
+    fileCount: z.ZodNumber;
+    /** 模块数 */
+    moduleCount: z.ZodNumber;
+    /** 文件占比（%，保留一位小数） */
+    percentage: z.ZodNumber;
+    /** 本次批量生成是否处理了该语言 */
+    processed: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    language: string;
+    adapterId: string;
+    fileCount: number;
+    moduleCount: number;
+    percentage: number;
+    processed: boolean;
+}, {
+    language: string;
+    adapterId: string;
+    fileCount: number;
+    moduleCount: number;
+    percentage: number;
+    processed: boolean;
+}>;
+export type LanguageDistribution = z.infer<typeof LanguageDistributionSchema>;
+/** LLM token 使用量（input / output 分项） */
+export declare const TokenUsageSchema: z.ZodObject<{
+    input: z.ZodNumber;
+    output: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    input: number;
+    output: number;
+}, {
+    input: number;
+    output: number;
+}>;
+export type TokenUsage = z.infer<typeof TokenUsageSchema>;
+/**
+ * Feature 140 FR-012 — 单次 spec 生成的 token 来源细分（observability）。
+ *
+ * 4 个字段含义：
+ * - `contextAssembly`：跨模块上下文总 input token（dependencies / snippets / slices /
+ *   readme / caller / knowledge），来自 `AssembledContext.tokenBreakdown.contextAssembly`
+ * - `promptTemplate`：LLM prompt 模板 instructions 的 input token
+ * - `sourceFile`：目标模块 skeleton 的 input token
+ * - `llmReasoning`：LLM response 的 output token（来自 SDK usage.outputTokens）
+ *
+ * 与 `TokenUsage` 的关系：`TokenUsage.input ≈ contextAssembly + promptTemplate + sourceFile`
+ * （存在轻微差异：分隔符开销 + estimateFast vs SDK actual 差异）；
+ * `TokenUsage.output = llmReasoning`。本字段是 input 端的进一步细分。
+ */
+export declare const CostBreakdownSchema: z.ZodObject<{
+    /** 跨模块上下文总 input token（dependencies / snippets / readme 等聚合） */
+    contextAssembly: z.ZodNumber;
+    /** prompt 模板 instructions 的 input token */
+    promptTemplate: z.ZodNumber;
+    /** 目标模块 skeleton 的 input token */
+    sourceFile: z.ZodNumber;
+    /** LLM response output token（来自 SDK usage） */
+    llmReasoning: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    contextAssembly: number;
+    promptTemplate: number;
+    sourceFile: number;
+    llmReasoning: number;
+}, {
+    contextAssembly: number;
+    promptTemplate: number;
+    sourceFile: number;
+    llmReasoning: number;
+}>;
+export type CostBreakdown = z.infer<typeof CostBreakdownSchema>;
+/** 单次 spec 生成的成本元数据（Feature 127） */
+export declare const CostMetadataSchema: z.ZodObject<{
+    /** 本次生成消耗的 input / output token 数 */
+    tokenUsage: z.ZodObject<{
+        input: z.ZodNumber;
+        output: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        input: number;
+        output: number;
+    }, {
+        input: number;
+        output: number;
+    }>;
+    /** LLM + enrichment 总耗时（毫秒） */
+    durationMs: z.ZodNumber;
+    /** 实际使用的 LLM 模型 ID；AST-only 降级时为空字符串 */
+    llmModel: z.ZodString;
+    /** 降级原因；未降级时为 null */
+    fallbackReason: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+    durationMs: number;
+    llmModel: string;
+    fallbackReason: string | null;
+}, {
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+    durationMs: number;
+    llmModel: string;
+    fallbackReason: string | null;
+}>;
+export type CostMetadata = z.infer<typeof CostMetadataSchema>;
+/** YAML Frontmatter */
+export declare const SpecFrontmatterSchema: z.ZodObject<{
+    type: z.ZodLiteral<"module-spec">;
+    version: z.ZodString;
+    generatedBy: z.ZodString;
+    sourceTarget: z.ZodString;
+    relatedFiles: z.ZodArray<z.ZodString, "many">;
+    lastUpdated: z.ZodString;
+    confidence: z.ZodEnum<["high", "medium", "low"]>;
+    skeletonHash: z.ZodString;
+    /** 模块主要编程语言（多语言项目时设置） */
+    language: z.ZodOptional<z.ZodString>;
+    /** 跨语言引用（如 ['go:services/auth', 'python:scripts/deploy']） */
+    crossLanguageRefs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** 人类可读的模块显示名（默认取目录名） */
+    displayName: z.ZodOptional<z.ZodString>;
+    /** 本次生成消耗的 token 使用量（Feature 127） */
+    tokenUsage: z.ZodOptional<z.ZodObject<{
+        input: z.ZodNumber;
+        output: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        input: number;
+        output: number;
+    }, {
+        input: number;
+        output: number;
+    }>>;
+    /** LLM + enrichment 总耗时（毫秒）（Feature 127） */
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    /** 实际使用的 LLM 模型 ID（Feature 127） */
+    llmModel: z.ZodOptional<z.ZodString>;
+    /** 降级原因（Feature 127）；未降级时为 null */
+    fallbackReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** 生成本 spec 时的批处理模式（Bug 142 修复）；旧 spec 缺失此字段时视为 cache miss */
+    generatedByMode: z.ZodOptional<z.ZodEnum<["full", "reading", "code-only"]>>;
+    /** spec 身份类型（Feature 128）；缺失时应用层默认视为 'canonical'（向后兼容历史 spec） */
+    sourceKind: z.ZodOptional<z.ZodEnum<["canonical", "derived", "bundle_copy"]>>;
+    /** 派生来源 spec 的 outputPath（Feature 128，相对于 projectRoot）；canonical 时为 null 或 undefined */
+    derivedFrom: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /**
+     * Feature 140 FR-012 — input token 来源细分（observability）。
+     * 旧 spec 缺失此字段时视为未观测，下游聚合 Top N 时跳过。
+     */
+    costBreakdown: z.ZodOptional<z.ZodObject<{
+        /** 跨模块上下文总 input token（dependencies / snippets / readme 等聚合） */
+        contextAssembly: z.ZodNumber;
+        /** prompt 模板 instructions 的 input token */
+        promptTemplate: z.ZodNumber;
+        /** 目标模块 skeleton 的 input token */
+        sourceFile: z.ZodNumber;
+        /** LLM response output token（来自 SDK usage） */
+        llmReasoning: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        contextAssembly: number;
+        promptTemplate: number;
+        sourceFile: number;
+        llmReasoning: number;
+    }, {
+        contextAssembly: number;
+        promptTemplate: number;
+        sourceFile: number;
+        llmReasoning: number;
+    }>>;
+    /**
+     * Feature 140 FR-012 — context 是否被 budget 截断。
+     * true 时表示 `assembleContext` 因超预算丢弃了部分跨模块输入；缺失时视为 false（向后兼容）。
+     */
+    contextTruncated: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "module-spec";
+    confidence: "low" | "medium" | "high";
+    version: string;
+    generatedBy: string;
+    sourceTarget: string;
+    relatedFiles: string[];
+    lastUpdated: string;
+    skeletonHash: string;
+    language?: string | undefined;
+    tokenUsage?: {
+        input: number;
+        output: number;
+    } | undefined;
+    durationMs?: number | undefined;
+    llmModel?: string | undefined;
+    fallbackReason?: string | null | undefined;
+    crossLanguageRefs?: string[] | undefined;
+    displayName?: string | undefined;
+    generatedByMode?: "full" | "reading" | "code-only" | undefined;
+    sourceKind?: "canonical" | "derived" | "bundle_copy" | undefined;
+    derivedFrom?: string | null | undefined;
+    costBreakdown?: {
+        contextAssembly: number;
+        promptTemplate: number;
+        sourceFile: number;
+        llmReasoning: number;
+    } | undefined;
+    contextTruncated?: boolean | undefined;
+}, {
+    type: "module-spec";
+    confidence: "low" | "medium" | "high";
+    version: string;
+    generatedBy: string;
+    sourceTarget: string;
+    relatedFiles: string[];
+    lastUpdated: string;
+    skeletonHash: string;
+    language?: string | undefined;
+    tokenUsage?: {
+        input: number;
+        output: number;
+    } | undefined;
+    durationMs?: number | undefined;
+    llmModel?: string | undefined;
+    fallbackReason?: string | null | undefined;
+    crossLanguageRefs?: string[] | undefined;
+    displayName?: string | undefined;
+    generatedByMode?: "full" | "reading" | "code-only" | undefined;
+    sourceKind?: "canonical" | "derived" | "bundle_copy" | undefined;
+    derivedFrom?: string | null | undefined;
+    costBreakdown?: {
+        contextAssembly: number;
+        promptTemplate: number;
+        sourceFile: number;
+        llmReasoning: number;
+    } | undefined;
+    contextTruncated?: boolean | undefined;
+}>;
+export type SpecFrontmatter = z.infer<typeof SpecFrontmatterSchema>;
+/** 9 段式 Spec 内容 */
+export declare const SpecSectionsSchema: z.ZodObject<{
+    intent: z.ZodString;
+    interfaceDefinition: z.ZodString;
+    businessLogic: z.ZodString;
+    dataStructures: z.ZodString;
+    constraints: z.ZodString;
+    edgeCases: z.ZodString;
+    technicalDebt: z.ZodString;
+    testCoverage: z.ZodString;
+    dependencies: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    intent: string;
+    interfaceDefinition: string;
+    businessLogic: string;
+    dataStructures: string;
+    constraints: string;
+    edgeCases: string;
+    technicalDebt: string;
+    testCoverage: string;
+    dependencies: string;
+}, {
+    intent: string;
+    interfaceDefinition: string;
+    businessLogic: string;
+    dataStructures: string;
+    constraints: string;
+    edgeCases: string;
+    technicalDebt: string;
+    testCoverage: string;
+    dependencies: string;
+}>;
+export type SpecSections = z.infer<typeof SpecSectionsSchema>;
+/** Mermaid 图表 */
+export declare const MermaidDiagramSchema: z.ZodObject<{
+    type: z.ZodEnum<["classDiagram", "flowchart", "graph"]>;
+    source: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "classDiagram" | "flowchart" | "graph";
+    source: string;
+    title?: string | undefined;
+}, {
+    type: "classDiagram" | "flowchart" | "graph";
+    source: string;
+    title?: string | undefined;
+}>;
+export type MermaidDiagram = z.infer<typeof MermaidDiagramSchema>;
+/** 源文件清单条目 */
+export declare const FileEntrySchema: z.ZodObject<{
+    path: z.ZodString;
+    loc: z.ZodNumber;
+    purpose: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    loc: number;
+    purpose: string;
+}, {
+    path: string;
+    loc: number;
+    purpose: string;
+}>;
+export type FileEntry = z.infer<typeof FileEntrySchema>;
+/** 交叉引用链接 */
+export declare const CrossReferenceLinkSchema: z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodString;
+    targetSpecPath: z.ZodString;
+    targetSourceTarget: z.ZodString;
+    kind: z.ZodEnum<["same-module", "cross-module"]>;
+    direction: z.ZodEnum<["internal", "outbound", "inbound", "bidirectional"]>;
+    evidenceCount: z.ZodNumber;
+    summary: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "same-module" | "cross-module";
+    label: string;
+    href: string;
+    targetSpecPath: string;
+    targetSourceTarget: string;
+    direction: "internal" | "outbound" | "inbound" | "bidirectional";
+    evidenceCount: number;
+    summary: string;
+}, {
+    kind: "same-module" | "cross-module";
+    label: string;
+    href: string;
+    targetSpecPath: string;
+    targetSourceTarget: string;
+    direction: "internal" | "outbound" | "inbound" | "bidirectional";
+    evidenceCount: number;
+    summary: string;
+}>;
+export type CrossReferenceLink = z.infer<typeof CrossReferenceLinkSchema>;
+/** 当前模块的交叉引用索引 */
+export declare const ModuleCrossReferenceIndexSchema: z.ZodObject<{
+    generatedAt: z.ZodString;
+    sameModule: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodString;
+        targetSpecPath: z.ZodString;
+        targetSourceTarget: z.ZodString;
+        kind: z.ZodEnum<["same-module", "cross-module"]>;
+        direction: z.ZodEnum<["internal", "outbound", "inbound", "bidirectional"]>;
+        evidenceCount: z.ZodNumber;
+        summary: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "same-module" | "cross-module";
+        label: string;
+        href: string;
+        targetSpecPath: string;
+        targetSourceTarget: string;
+        direction: "internal" | "outbound" | "inbound" | "bidirectional";
+        evidenceCount: number;
+        summary: string;
+    }, {
+        kind: "same-module" | "cross-module";
+        label: string;
+        href: string;
+        targetSpecPath: string;
+        targetSourceTarget: string;
+        direction: "internal" | "outbound" | "inbound" | "bidirectional";
+        evidenceCount: number;
+        summary: string;
+    }>, "many">;
+    crossModule: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodString;
+        targetSpecPath: z.ZodString;
+        targetSourceTarget: z.ZodString;
+        kind: z.ZodEnum<["same-module", "cross-module"]>;
+        direction: z.ZodEnum<["internal", "outbound", "inbound", "bidirectional"]>;
+        evidenceCount: z.ZodNumber;
+        summary: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "same-module" | "cross-module";
+        label: string;
+        href: string;
+        targetSpecPath: string;
+        targetSourceTarget: string;
+        direction: "internal" | "outbound" | "inbound" | "bidirectional";
+        evidenceCount: number;
+        summary: string;
+    }, {
+        kind: "same-module" | "cross-module";
+        label: string;
+        href: string;
+        targetSpecPath: string;
+        targetSourceTarget: string;
+        direction: "internal" | "outbound" | "inbound" | "bidirectional";
+        evidenceCount: number;
+        summary: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    generatedAt: string;
+    sameModule: {
+        kind: "same-module" | "cross-module";
+        label: string;
+        href: string;
+        targetSpecPath: string;
+        targetSourceTarget: string;
+        direction: "internal" | "outbound" | "inbound" | "bidirectional";
+        evidenceCount: number;
+        summary: string;
+    }[];
+    crossModule: {
+        kind: "same-module" | "cross-module";
+        label: string;
+        href: string;
+        targetSpecPath: string;
+        targetSourceTarget: string;
+        direction: "internal" | "outbound" | "inbound" | "bidirectional";
+        evidenceCount: number;
+        summary: string;
+    }[];
+}, {
+    generatedAt: string;
+    sameModule: {
+        kind: "same-module" | "cross-module";
+        label: string;
+        href: string;
+        targetSpecPath: string;
+        targetSourceTarget: string;
+        direction: "internal" | "outbound" | "inbound" | "bidirectional";
+        evidenceCount: number;
+        summary: string;
+    }[];
+    crossModule: {
+        kind: "same-module" | "cross-module";
+        label: string;
+        href: string;
+        targetSpecPath: string;
+        targetSourceTarget: string;
+        direction: "internal" | "outbound" | "inbound" | "bidirectional";
+        evidenceCount: number;
+        summary: string;
+    }[];
+}>;
+export type ModuleCrossReferenceIndex = z.infer<typeof ModuleCrossReferenceIndexSchema>;
+/** 单模块 Spec 文档结构化表示 */
+export declare const ModuleSpecSchema: z.ZodObject<{
+    frontmatter: z.ZodObject<{
+        type: z.ZodLiteral<"module-spec">;
+        version: z.ZodString;
+        generatedBy: z.ZodString;
+        sourceTarget: z.ZodString;
+        relatedFiles: z.ZodArray<z.ZodString, "many">;
+        lastUpdated: z.ZodString;
+        confidence: z.ZodEnum<["high", "medium", "low"]>;
+        skeletonHash: z.ZodString;
+        /** 模块主要编程语言（多语言项目时设置） */
+        language: z.ZodOptional<z.ZodString>;
+        /** 跨语言引用（如 ['go:services/auth', 'python:scripts/deploy']） */
+        crossLanguageRefs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** 人类可读的模块显示名（默认取目录名） */
+        displayName: z.ZodOptional<z.ZodString>;
+        /** 本次生成消耗的 token 使用量（Feature 127） */
+        tokenUsage: z.ZodOptional<z.ZodObject<{
+            input: z.ZodNumber;
+            output: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            input: number;
+            output: number;
+        }, {
+            input: number;
+            output: number;
+        }>>;
+        /** LLM + enrichment 总耗时（毫秒）（Feature 127） */
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        /** 实际使用的 LLM 模型 ID（Feature 127） */
+        llmModel: z.ZodOptional<z.ZodString>;
+        /** 降级原因（Feature 127）；未降级时为 null */
+        fallbackReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** 生成本 spec 时的批处理模式（Bug 142 修复）；旧 spec 缺失此字段时视为 cache miss */
+        generatedByMode: z.ZodOptional<z.ZodEnum<["full", "reading", "code-only"]>>;
+        /** spec 身份类型（Feature 128）；缺失时应用层默认视为 'canonical'（向后兼容历史 spec） */
+        sourceKind: z.ZodOptional<z.ZodEnum<["canonical", "derived", "bundle_copy"]>>;
+        /** 派生来源 spec 的 outputPath（Feature 128，相对于 projectRoot）；canonical 时为 null 或 undefined */
+        derivedFrom: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /**
+         * Feature 140 FR-012 — input token 来源细分（observability）。
+         * 旧 spec 缺失此字段时视为未观测，下游聚合 Top N 时跳过。
+         */
+        costBreakdown: z.ZodOptional<z.ZodObject<{
+            /** 跨模块上下文总 input token（dependencies / snippets / readme 等聚合） */
+            contextAssembly: z.ZodNumber;
+            /** prompt 模板 instructions 的 input token */
+            promptTemplate: z.ZodNumber;
+            /** 目标模块 skeleton 的 input token */
+            sourceFile: z.ZodNumber;
+            /** LLM response output token（来自 SDK usage） */
+            llmReasoning: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            contextAssembly: number;
+            promptTemplate: number;
+            sourceFile: number;
+            llmReasoning: number;
+        }, {
+            contextAssembly: number;
+            promptTemplate: number;
+            sourceFile: number;
+            llmReasoning: number;
+        }>>;
+        /**
+         * Feature 140 FR-012 — context 是否被 budget 截断。
+         * true 时表示 `assembleContext` 因超预算丢弃了部分跨模块输入；缺失时视为 false（向后兼容）。
+         */
+        contextTruncated: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "module-spec";
+        confidence: "low" | "medium" | "high";
+        version: string;
+        generatedBy: string;
+        sourceTarget: string;
+        relatedFiles: string[];
+        lastUpdated: string;
+        skeletonHash: string;
+        language?: string | undefined;
+        tokenUsage?: {
+            input: number;
+            output: number;
+        } | undefined;
+        durationMs?: number | undefined;
+        llmModel?: string | undefined;
+        fallbackReason?: string | null | undefined;
+        crossLanguageRefs?: string[] | undefined;
+        displayName?: string | undefined;
+        generatedByMode?: "full" | "reading" | "code-only" | undefined;
+        sourceKind?: "canonical" | "derived" | "bundle_copy" | undefined;
+        derivedFrom?: string | null | undefined;
+        costBreakdown?: {
+            contextAssembly: number;
+            promptTemplate: number;
+            sourceFile: number;
+            llmReasoning: number;
+        } | undefined;
+        contextTruncated?: boolean | undefined;
+    }, {
+        type: "module-spec";
+        confidence: "low" | "medium" | "high";
+        version: string;
+        generatedBy: string;
+        sourceTarget: string;
+        relatedFiles: string[];
+        lastUpdated: string;
+        skeletonHash: string;
+        language?: string | undefined;
+        tokenUsage?: {
+            input: number;
+            output: number;
+        } | undefined;
+        durationMs?: number | undefined;
+        llmModel?: string | undefined;
+        fallbackReason?: string | null | undefined;
+        crossLanguageRefs?: string[] | undefined;
+        displayName?: string | undefined;
+        generatedByMode?: "full" | "reading" | "code-only" | undefined;
+        sourceKind?: "canonical" | "derived" | "bundle_copy" | undefined;
+        derivedFrom?: string | null | undefined;
+        costBreakdown?: {
+            contextAssembly: number;
+            promptTemplate: number;
+            sourceFile: number;
+            llmReasoning: number;
+        } | undefined;
+        contextTruncated?: boolean | undefined;
+    }>;
+    sections: z.ZodObject<{
+        intent: z.ZodString;
+        interfaceDefinition: z.ZodString;
+        businessLogic: z.ZodString;
+        dataStructures: z.ZodString;
+        constraints: z.ZodString;
+        edgeCases: z.ZodString;
+        technicalDebt: z.ZodString;
+        testCoverage: z.ZodString;
+        dependencies: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        intent: string;
+        interfaceDefinition: string;
+        businessLogic: string;
+        dataStructures: string;
+        constraints: string;
+        edgeCases: string;
+        technicalDebt: string;
+        testCoverage: string;
+        dependencies: string;
+    }, {
+        intent: string;
+        interfaceDefinition: string;
+        businessLogic: string;
+        dataStructures: string;
+        constraints: string;
+        edgeCases: string;
+        technicalDebt: string;
+        testCoverage: string;
+        dependencies: string;
+    }>;
+    mermaidDiagrams: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["classDiagram", "flowchart", "graph"]>;
+        source: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "classDiagram" | "flowchart" | "graph";
+        source: string;
+        title?: string | undefined;
+    }, {
+        type: "classDiagram" | "flowchart" | "graph";
+        source: string;
+        title?: string | undefined;
+    }>, "many">>;
+    fileInventory: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        loc: z.ZodNumber;
+        purpose: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        loc: number;
+        purpose: string;
+    }, {
+        path: string;
+        loc: number;
+        purpose: string;
+    }>, "many">;
+    crossReferenceIndex: z.ZodOptional<z.ZodObject<{
+        generatedAt: z.ZodString;
+        sameModule: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodString;
+            targetSpecPath: z.ZodString;
+            targetSourceTarget: z.ZodString;
+            kind: z.ZodEnum<["same-module", "cross-module"]>;
+            direction: z.ZodEnum<["internal", "outbound", "inbound", "bidirectional"]>;
+            evidenceCount: z.ZodNumber;
+            summary: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "same-module" | "cross-module";
+            label: string;
+            href: string;
+            targetSpecPath: string;
+            targetSourceTarget: string;
+            direction: "internal" | "outbound" | "inbound" | "bidirectional";
+            evidenceCount: number;
+            summary: string;
+        }, {
+            kind: "same-module" | "cross-module";
+            label: string;
+            href: string;
+            targetSpecPath: string;
+            targetSourceTarget: string;
+            direction: "internal" | "outbound" | "inbound" | "bidirectional";
+            evidenceCount: number;
+            summary: string;
+        }>, "many">;
+        crossModule: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            href: z.ZodString;
+            targetSpecPath: z.ZodString;
+            targetSourceTarget: z.ZodString;
+            kind: z.ZodEnum<["same-module", "cross-module"]>;
+            direction: z.ZodEnum<["internal", "outbound", "inbound", "bidirectional"]>;
+            evidenceCount: z.ZodNumber;
+            summary: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "same-module" | "cross-module";
+            label: string;
+            href: string;
+            targetSpecPath: string;
+            targetSourceTarget: string;
+            direction: "internal" | "outbound" | "inbound" | "bidirectional";
+            evidenceCount: number;
+            summary: string;
+        }, {
+            kind: "same-module" | "cross-module";
+            label: string;
+            href: string;
+            targetSpecPath: string;
+            targetSourceTarget: string;
+            direction: "internal" | "outbound" | "inbound" | "bidirectional";
+            evidenceCount: number;
+            summary: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        generatedAt: string;
+        sameModule: {
+            kind: "same-module" | "cross-module";
+            label: string;
+            href: string;
+            targetSpecPath: string;
+            targetSourceTarget: string;
+            direction: "internal" | "outbound" | "inbound" | "bidirectional";
+            evidenceCount: number;
+            summary: string;
+        }[];
+        crossModule: {
+            kind: "same-module" | "cross-module";
+            label: string;
+            href: string;
+            targetSpecPath: string;
+            targetSourceTarget: string;
+            direction: "internal" | "outbound" | "inbound" | "bidirectional";
+            evidenceCount: number;
+            summary: string;
+        }[];
+    }, {
+        generatedAt: string;
+        sameModule: {
+            kind: "same-module" | "cross-module";
+            label: string;
+            href: string;
+            targetSpecPath: string;
+            targetSourceTarget: string;
+            direction: "internal" | "outbound" | "inbound" | "bidirectional";
+            evidenceCount: number;
+            summary: string;
+        }[];
+        crossModule: {
+            kind: "same-module" | "cross-module";
+            label: string;
+            href: string;
+            targetSpecPath: string;
+            targetSourceTarget: string;
+            direction: "internal" | "outbound" | "inbound" | "bidirectional";
+            evidenceCount: number;
+            summary: string;
+        }[];
+    }>>;
+    baselineSkeleton: z.ZodObject<{
+        filePath: z.ZodString;
+        language: z.ZodEnum<["typescript", "javascript", "python", "go", "java", "rust", "kotlin", "cpp", "ruby", "swift"]>;
+        loc: z.ZodNumber;
+        exports: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            kind: z.ZodEnum<["function", "class", "interface", "type", "enum", "const", "variable", "struct", "trait", "protocol", "data_class", "module"]>;
+            signature: z.ZodString;
+            jsDoc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            typeParameters: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            isDefault: z.ZodBoolean;
+            startLine: z.ZodNumber;
+            endLine: z.ZodNumber;
+            members: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                kind: z.ZodEnum<["method", "property", "getter", "setter", "constructor", "classmethod", "staticmethod", "associated_function"]>;
+                signature: z.ZodString;
+                jsDoc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                visibility: z.ZodOptional<z.ZodEnum<["public", "protected", "private"]>>;
+                isStatic: z.ZodBoolean;
+                isAbstract: z.ZodOptional<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+                signature: string;
+                isStatic: boolean;
+                jsDoc?: string | null | undefined;
+                visibility?: "public" | "protected" | "private" | undefined;
+                isAbstract?: boolean | undefined;
+            }, {
+                name: string;
+                kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+                signature: string;
+                isStatic: boolean;
+                jsDoc?: string | null | undefined;
+                visibility?: "public" | "protected" | "private" | undefined;
+                isAbstract?: boolean | undefined;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            kind: "function" | "class" | "interface" | "type" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
+            signature: string;
+            isDefault: boolean;
+            startLine: number;
+            endLine: number;
+            jsDoc?: string | null | undefined;
+            typeParameters?: string[] | undefined;
+            members?: {
+                name: string;
+                kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+                signature: string;
+                isStatic: boolean;
+                jsDoc?: string | null | undefined;
+                visibility?: "public" | "protected" | "private" | undefined;
+                isAbstract?: boolean | undefined;
+            }[] | undefined;
+        }, {
+            name: string;
+            kind: "function" | "class" | "interface" | "type" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
+            signature: string;
+            isDefault: boolean;
+            startLine: number;
+            endLine: number;
+            jsDoc?: string | null | undefined;
+            typeParameters?: string[] | undefined;
+            members?: {
+                name: string;
+                kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+                signature: string;
+                isStatic: boolean;
+                jsDoc?: string | null | undefined;
+                visibility?: "public" | "protected" | "private" | undefined;
+                isAbstract?: boolean | undefined;
+            }[] | undefined;
+        }>, "many">;
+        imports: z.ZodArray<z.ZodObject<{
+            moduleSpecifier: z.ZodString;
+            isRelative: z.ZodBoolean;
+            resolvedPath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            namedImports: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            defaultImport: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            isTypeOnly: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            moduleSpecifier: string;
+            isRelative: boolean;
+            isTypeOnly: boolean;
+            resolvedPath?: string | null | undefined;
+            namedImports?: string[] | undefined;
+            defaultImport?: string | null | undefined;
+        }, {
+            moduleSpecifier: string;
+            isRelative: boolean;
+            isTypeOnly: boolean;
+            resolvedPath?: string | null | undefined;
+            namedImports?: string[] | undefined;
+            defaultImport?: string | null | undefined;
+        }>, "many">;
+        parseErrors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            line: z.ZodNumber;
+            column: z.ZodNumber;
+            message: z.ZodString;
+            affectedSymbols: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            line: number;
+            column: number;
+            affectedSymbols?: string[] | undefined;
+        }, {
+            message: string;
+            line: number;
+            column: number;
+            affectedSymbols?: string[] | undefined;
+        }>, "many">>;
+        hash: z.ZodString;
+        analyzedAt: z.ZodString;
+        parserUsed: z.ZodEnum<["ts-morph", "tree-sitter", "baseline", "reconstructed"]>;
+        moduleDoc: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        filePath: string;
+        language: "typescript" | "javascript" | "python" | "go" | "java" | "rust" | "kotlin" | "cpp" | "ruby" | "swift";
+        loc: number;
+        exports: {
+            name: string;
+            kind: "function" | "class" | "interface" | "type" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
+            signature: string;
+            isDefault: boolean;
+            startLine: number;
+            endLine: number;
+            jsDoc?: string | null | undefined;
+            typeParameters?: string[] | undefined;
+            members?: {
+                name: string;
+                kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+                signature: string;
+                isStatic: boolean;
+                jsDoc?: string | null | undefined;
+                visibility?: "public" | "protected" | "private" | undefined;
+                isAbstract?: boolean | undefined;
+            }[] | undefined;
+        }[];
+        imports: {
+            moduleSpecifier: string;
+            isRelative: boolean;
+            isTypeOnly: boolean;
+            resolvedPath?: string | null | undefined;
+            namedImports?: string[] | undefined;
+            defaultImport?: string | null | undefined;
+        }[];
+        hash: string;
+        analyzedAt: string;
+        parserUsed: "ts-morph" | "tree-sitter" | "baseline" | "reconstructed";
+        parseErrors?: {
+            message: string;
+            line: number;
+            column: number;
+            affectedSymbols?: string[] | undefined;
+        }[] | undefined;
+        moduleDoc?: string | undefined;
+    }, {
+        filePath: string;
+        language: "typescript" | "javascript" | "python" | "go" | "java" | "rust" | "kotlin" | "cpp" | "ruby" | "swift";
+        loc: number;
+        exports: {
+            name: string;
+            kind: "function" | "class" | "interface" | "type" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
+            signature: string;
+            isDefault: boolean;
+            startLine: number;
+            endLine: number;
+            jsDoc?: string | null | undefined;
+            typeParameters?: string[] | undefined;
+            members?: {
+                name: string;
+                kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+                signature: string;
+                isStatic: boolean;
+                jsDoc?: string | null | undefined;
+                visibility?: "public" | "protected" | "private" | undefined;
+                isAbstract?: boolean | undefined;
+            }[] | undefined;
+        }[];
+        imports: {
+            moduleSpecifier: string;
+            isRelative: boolean;
+            isTypeOnly: boolean;
+            resolvedPath?: string | null | undefined;
+            namedImports?: string[] | undefined;
+            defaultImport?: string | null | undefined;
+        }[];
+        hash: string;
+        analyzedAt: string;
+        parserUsed: "ts-morph" | "tree-sitter" | "baseline" | "reconstructed";
+        parseErrors?: {
+            message: string;
+            line: number;
+            column: number;
+            affectedSymbols?: string[] | undefined;
+        }[] | undefined;
+        moduleDoc?: string | undefined;
+    }>;
+    outputPath: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    frontmatter: {
+        type: "module-spec";
+        confidence: "low" | "medium" | "high";
+        version: string;
+        generatedBy: string;
+        sourceTarget: string;
+        relatedFiles: string[];
+        lastUpdated: string;
+        skeletonHash: string;
+        language?: string | undefined;
+        tokenUsage?: {
+            input: number;
+            output: number;
+        } | undefined;
+        durationMs?: number | undefined;
+        llmModel?: string | undefined;
+        fallbackReason?: string | null | undefined;
+        crossLanguageRefs?: string[] | undefined;
+        displayName?: string | undefined;
+        generatedByMode?: "full" | "reading" | "code-only" | undefined;
+        sourceKind?: "canonical" | "derived" | "bundle_copy" | undefined;
+        derivedFrom?: string | null | undefined;
+        costBreakdown?: {
+            contextAssembly: number;
+            promptTemplate: number;
+            sourceFile: number;
+            llmReasoning: number;
+        } | undefined;
+        contextTruncated?: boolean | undefined;
+    };
+    sections: {
+        intent: string;
+        interfaceDefinition: string;
+        businessLogic: string;
+        dataStructures: string;
+        constraints: string;
+        edgeCases: string;
+        technicalDebt: string;
+        testCoverage: string;
+        dependencies: string;
+    };
+    fileInventory: {
+        path: string;
+        loc: number;
+        purpose: string;
+    }[];
+    baselineSkeleton: {
+        filePath: string;
+        language: "typescript" | "javascript" | "python" | "go" | "java" | "rust" | "kotlin" | "cpp" | "ruby" | "swift";
+        loc: number;
+        exports: {
+            name: string;
+            kind: "function" | "class" | "interface" | "type" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
+            signature: string;
+            isDefault: boolean;
+            startLine: number;
+            endLine: number;
+            jsDoc?: string | null | undefined;
+            typeParameters?: string[] | undefined;
+            members?: {
+                name: string;
+                kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+                signature: string;
+                isStatic: boolean;
+                jsDoc?: string | null | undefined;
+                visibility?: "public" | "protected" | "private" | undefined;
+                isAbstract?: boolean | undefined;
+            }[] | undefined;
+        }[];
+        imports: {
+            moduleSpecifier: string;
+            isRelative: boolean;
+            isTypeOnly: boolean;
+            resolvedPath?: string | null | undefined;
+            namedImports?: string[] | undefined;
+            defaultImport?: string | null | undefined;
+        }[];
+        hash: string;
+        analyzedAt: string;
+        parserUsed: "ts-morph" | "tree-sitter" | "baseline" | "reconstructed";
+        parseErrors?: {
+            message: string;
+            line: number;
+            column: number;
+            affectedSymbols?: string[] | undefined;
+        }[] | undefined;
+        moduleDoc?: string | undefined;
+    };
+    outputPath: string;
+    mermaidDiagrams?: {
+        type: "classDiagram" | "flowchart" | "graph";
+        source: string;
+        title?: string | undefined;
+    }[] | undefined;
+    crossReferenceIndex?: {
+        generatedAt: string;
+        sameModule: {
+            kind: "same-module" | "cross-module";
+            label: string;
+            href: string;
+            targetSpecPath: string;
+            targetSourceTarget: string;
+            direction: "internal" | "outbound" | "inbound" | "bidirectional";
+            evidenceCount: number;
+            summary: string;
+        }[];
+        crossModule: {
+            kind: "same-module" | "cross-module";
+            label: string;
+            href: string;
+            targetSpecPath: string;
+            targetSourceTarget: string;
+            direction: "internal" | "outbound" | "inbound" | "bidirectional";
+            evidenceCount: number;
+            summary: string;
+        }[];
+    } | undefined;
+}, {
+    frontmatter: {
+        type: "module-spec";
+        confidence: "low" | "medium" | "high";
+        version: string;
+        generatedBy: string;
+        sourceTarget: string;
+        relatedFiles: string[];
+        lastUpdated: string;
+        skeletonHash: string;
+        language?: string | undefined;
+        tokenUsage?: {
+            input: number;
+            output: number;
+        } | undefined;
+        durationMs?: number | undefined;
+        llmModel?: string | undefined;
+        fallbackReason?: string | null | undefined;
+        crossLanguageRefs?: string[] | undefined;
+        displayName?: string | undefined;
+        generatedByMode?: "full" | "reading" | "code-only" | undefined;
+        sourceKind?: "canonical" | "derived" | "bundle_copy" | undefined;
+        derivedFrom?: string | null | undefined;
+        costBreakdown?: {
+            contextAssembly: number;
+            promptTemplate: number;
+            sourceFile: number;
+            llmReasoning: number;
+        } | undefined;
+        contextTruncated?: boolean | undefined;
+    };
+    sections: {
+        intent: string;
+        interfaceDefinition: string;
+        businessLogic: string;
+        dataStructures: string;
+        constraints: string;
+        edgeCases: string;
+        technicalDebt: string;
+        testCoverage: string;
+        dependencies: string;
+    };
+    fileInventory: {
+        path: string;
+        loc: number;
+        purpose: string;
+    }[];
+    baselineSkeleton: {
+        filePath: string;
+        language: "typescript" | "javascript" | "python" | "go" | "java" | "rust" | "kotlin" | "cpp" | "ruby" | "swift";
+        loc: number;
+        exports: {
+            name: string;
+            kind: "function" | "class" | "interface" | "type" | "enum" | "const" | "variable" | "struct" | "trait" | "protocol" | "data_class" | "module";
+            signature: string;
+            isDefault: boolean;
+            startLine: number;
+            endLine: number;
+            jsDoc?: string | null | undefined;
+            typeParameters?: string[] | undefined;
+            members?: {
+                name: string;
+                kind: "method" | "property" | "getter" | "setter" | "constructor" | "classmethod" | "staticmethod" | "associated_function";
+                signature: string;
+                isStatic: boolean;
+                jsDoc?: string | null | undefined;
+                visibility?: "public" | "protected" | "private" | undefined;
+                isAbstract?: boolean | undefined;
+            }[] | undefined;
+        }[];
+        imports: {
+            moduleSpecifier: string;
+            isRelative: boolean;
+            isTypeOnly: boolean;
+            resolvedPath?: string | null | undefined;
+            namedImports?: string[] | undefined;
+            defaultImport?: string | null | undefined;
+        }[];
+        hash: string;
+        analyzedAt: string;
+        parserUsed: "ts-morph" | "tree-sitter" | "baseline" | "reconstructed";
+        parseErrors?: {
+            message: string;
+            line: number;
+            column: number;
+            affectedSymbols?: string[] | undefined;
+        }[] | undefined;
+        moduleDoc?: string | undefined;
+    };
+    outputPath: string;
+    mermaidDiagrams?: {
+        type: "classDiagram" | "flowchart" | "graph";
+        source: string;
+        title?: string | undefined;
+    }[] | undefined;
+    crossReferenceIndex?: {
+        generatedAt: string;
+        sameModule: {
+            kind: "same-module" | "cross-module";
+            label: string;
+            href: string;
+            targetSpecPath: string;
+            targetSourceTarget: string;
+            direction: "internal" | "outbound" | "inbound" | "bidirectional";
+            evidenceCount: number;
+            summary: string;
+        }[];
+        crossModule: {
+            kind: "same-module" | "cross-module";
+            label: string;
+            href: string;
+            targetSpecPath: string;
+            targetSourceTarget: string;
+            direction: "internal" | "outbound" | "inbound" | "bidirectional";
+            evidenceCount: number;
+            summary: string;
+        }[];
+    } | undefined;
+}>;
+export type ModuleSpec = z.infer<typeof ModuleSpecSchema>;
+/** 架构索引 Frontmatter */
+export declare const IndexFrontmatterSchema: z.ZodObject<{
+    type: z.ZodLiteral<"architecture-index">;
+    version: z.ZodString;
+    generatedBy: z.ZodString;
+    projectRoot: z.ZodString;
+    totalModules: z.ZodNumber;
+    lastUpdated: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "architecture-index";
+    projectRoot: string;
+    totalModules: number;
+    version: string;
+    generatedBy: string;
+    lastUpdated: string;
+}, {
+    type: "architecture-index";
+    projectRoot: string;
+    totalModules: number;
+    version: string;
+    generatedBy: string;
+    lastUpdated: string;
+}>;
+export type IndexFrontmatter = z.infer<typeof IndexFrontmatterSchema>;
+/** 模块映射表条目 */
+export declare const ModuleMapEntrySchema: z.ZodObject<{
+    name: z.ZodString;
+    specPath: z.ZodString;
+    description: z.ZodString;
+    level: z.ZodNumber;
+    dependencies: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    level: number;
+    description: string;
+    dependencies: string[];
+    specPath: string;
+}, {
+    name: string;
+    level: number;
+    description: string;
+    dependencies: string[];
+    specPath: string;
+}>;
+export type ModuleMapEntry = z.infer<typeof ModuleMapEntrySchema>;
+/** 技术栈条目 */
+export declare const TechStackEntrySchema: z.ZodObject<{
+    category: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    purpose: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    category: string;
+    purpose: string;
+    version?: string | null | undefined;
+}, {
+    name: string;
+    category: string;
+    purpose: string;
+    version?: string | null | undefined;
+}>;
+export type TechStackEntry = z.infer<typeof TechStackEntrySchema>;
+/** 项目级架构索引文档 */
+export declare const ArchitectureIndexSchema: z.ZodObject<{
+    frontmatter: z.ZodObject<{
+        type: z.ZodLiteral<"architecture-index">;
+        version: z.ZodString;
+        generatedBy: z.ZodString;
+        projectRoot: z.ZodString;
+        totalModules: z.ZodNumber;
+        lastUpdated: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "architecture-index";
+        projectRoot: string;
+        totalModules: number;
+        version: string;
+        generatedBy: string;
+        lastUpdated: string;
+    }, {
+        type: "architecture-index";
+        projectRoot: string;
+        totalModules: number;
+        version: string;
+        generatedBy: string;
+        lastUpdated: string;
+    }>;
+    systemPurpose: z.ZodString;
+    architecturePattern: z.ZodString;
+    moduleMap: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        specPath: z.ZodString;
+        description: z.ZodString;
+        level: z.ZodNumber;
+        dependencies: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        level: number;
+        description: string;
+        dependencies: string[];
+        specPath: string;
+    }, {
+        name: string;
+        level: number;
+        description: string;
+        dependencies: string[];
+        specPath: string;
+    }>, "many">;
+    crossCuttingConcerns: z.ZodArray<z.ZodString, "many">;
+    technologyStack: z.ZodArray<z.ZodObject<{
+        category: z.ZodString;
+        name: z.ZodString;
+        version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        purpose: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        category: string;
+        purpose: string;
+        version?: string | null | undefined;
+    }, {
+        name: string;
+        category: string;
+        purpose: string;
+        version?: string | null | undefined;
+    }>, "many">;
+    dependencyDiagram: z.ZodString;
+    outputPath: z.ZodString;
+    /** 语言分布（多语言项目时填充，单语言或 undefined） */
+    languageDistribution: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** 语言显示名称（如 'TypeScript'） */
+        language: z.ZodString;
+        /** 适配器 ID（如 'ts-js'） */
+        adapterId: z.ZodString;
+        /** 文件数 */
+        fileCount: z.ZodNumber;
+        /** 模块数 */
+        moduleCount: z.ZodNumber;
+        /** 文件占比（%，保留一位小数） */
+        percentage: z.ZodNumber;
+        /** 本次批量生成是否处理了该语言 */
+        processed: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        language: string;
+        adapterId: string;
+        fileCount: number;
+        moduleCount: number;
+        percentage: number;
+        processed: boolean;
+    }, {
+        language: string;
+        adapterId: string;
+        fileCount: number;
+        moduleCount: number;
+        percentage: number;
+        processed: boolean;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    frontmatter: {
+        type: "architecture-index";
+        projectRoot: string;
+        totalModules: number;
+        version: string;
+        generatedBy: string;
+        lastUpdated: string;
+    };
+    outputPath: string;
+    systemPurpose: string;
+    architecturePattern: string;
+    moduleMap: {
+        name: string;
+        level: number;
+        description: string;
+        dependencies: string[];
+        specPath: string;
+    }[];
+    crossCuttingConcerns: string[];
+    technologyStack: {
+        name: string;
+        category: string;
+        purpose: string;
+        version?: string | null | undefined;
+    }[];
+    dependencyDiagram: string;
+    languageDistribution?: {
+        language: string;
+        adapterId: string;
+        fileCount: number;
+        moduleCount: number;
+        percentage: number;
+        processed: boolean;
+    }[] | undefined;
+}, {
+    frontmatter: {
+        type: "architecture-index";
+        projectRoot: string;
+        totalModules: number;
+        version: string;
+        generatedBy: string;
+        lastUpdated: string;
+    };
+    outputPath: string;
+    systemPurpose: string;
+    architecturePattern: string;
+    moduleMap: {
+        name: string;
+        level: number;
+        description: string;
+        dependencies: string[];
+        specPath: string;
+    }[];
+    crossCuttingConcerns: string[];
+    technologyStack: {
+        name: string;
+        category: string;
+        purpose: string;
+        version?: string | null | undefined;
+    }[];
+    dependencyDiagram: string;
+    languageDistribution?: {
+        language: string;
+        adapterId: string;
+        fileCount: number;
+        moduleCount: number;
+        percentage: number;
+        processed: boolean;
+    }[] | undefined;
+}>;
+export type ArchitectureIndex = z.infer<typeof ArchitectureIndexSchema>;
+/** 漂移检测完整报告 */
+export declare const DriftReportSchema: z.ZodObject<{
+    specPath: z.ZodString;
+    sourcePath: z.ZodString;
+    generatedAt: z.ZodString;
+    specVersion: z.ZodString;
+    summary: z.ZodObject<{
+        totalChanges: z.ZodNumber;
+        high: z.ZodNumber;
+        medium: z.ZodNumber;
+        low: z.ZodNumber;
+        additions: z.ZodNumber;
+        removals: z.ZodNumber;
+        modifications: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        low: number;
+        medium: number;
+        high: number;
+        totalChanges: number;
+        additions: number;
+        removals: number;
+        modifications: number;
+    }, {
+        low: number;
+        medium: number;
+        high: number;
+        totalChanges: number;
+        additions: number;
+        removals: number;
+        modifications: number;
+    }>;
+    items: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        id: z.ZodString;
+        severity: z.ZodEnum<["HIGH", "MEDIUM", "LOW"]>;
+        category: z.ZodEnum<["Interface", "Behavior", "Constraint"]>;
+        changeType: z.ZodEnum<["addition", "removal", "modification"]>;
+        location: z.ZodString;
+        symbolName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        description: z.ZodString;
+        oldValue: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        newValue: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        proposedUpdate: z.ZodString;
+        detectedBy: z.ZodEnum<["structural", "semantic"]>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        description: string;
+        severity: "HIGH" | "MEDIUM" | "LOW";
+        category: "Interface" | "Behavior" | "Constraint";
+        changeType: "addition" | "removal" | "modification";
+        location: string;
+        proposedUpdate: string;
+        detectedBy: "structural" | "semantic";
+        symbolName?: string | null | undefined;
+        oldValue?: string | null | undefined;
+        newValue?: string | null | undefined;
+    }, {
+        id: string;
+        description: string;
+        severity: "HIGH" | "MEDIUM" | "LOW";
+        category: "Interface" | "Behavior" | "Constraint";
+        changeType: "addition" | "removal" | "modification";
+        location: string;
+        proposedUpdate: string;
+        detectedBy: "structural" | "semantic";
+        symbolName?: string | null | undefined;
+        oldValue?: string | null | undefined;
+        newValue?: string | null | undefined;
+    }>, {
+        id: string;
+        description: string;
+        severity: "HIGH" | "MEDIUM" | "LOW";
+        category: "Interface" | "Behavior" | "Constraint";
+        changeType: "addition" | "removal" | "modification";
+        location: string;
+        proposedUpdate: string;
+        detectedBy: "structural" | "semantic";
+        symbolName?: string | null | undefined;
+        oldValue?: string | null | undefined;
+        newValue?: string | null | undefined;
+    }, {
+        id: string;
+        description: string;
+        severity: "HIGH" | "MEDIUM" | "LOW";
+        category: "Interface" | "Behavior" | "Constraint";
+        changeType: "addition" | "removal" | "modification";
+        location: string;
+        proposedUpdate: string;
+        detectedBy: "structural" | "semantic";
+        symbolName?: string | null | undefined;
+        oldValue?: string | null | undefined;
+        newValue?: string | null | undefined;
+    }>, "many">;
+    filteredNoise: z.ZodNumber;
+    recommendation: z.ZodString;
+    outputPath: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    summary: {
+        low: number;
+        medium: number;
+        high: number;
+        totalChanges: number;
+        additions: number;
+        removals: number;
+        modifications: number;
+    };
+    generatedAt: string;
+    outputPath: string;
+    specPath: string;
+    sourcePath: string;
+    specVersion: string;
+    items: {
+        id: string;
+        description: string;
+        severity: "HIGH" | "MEDIUM" | "LOW";
+        category: "Interface" | "Behavior" | "Constraint";
+        changeType: "addition" | "removal" | "modification";
+        location: string;
+        proposedUpdate: string;
+        detectedBy: "structural" | "semantic";
+        symbolName?: string | null | undefined;
+        oldValue?: string | null | undefined;
+        newValue?: string | null | undefined;
+    }[];
+    filteredNoise: number;
+    recommendation: string;
+}, {
+    summary: {
+        low: number;
+        medium: number;
+        high: number;
+        totalChanges: number;
+        additions: number;
+        removals: number;
+        modifications: number;
+    };
+    generatedAt: string;
+    outputPath: string;
+    specPath: string;
+    sourcePath: string;
+    specVersion: string;
+    items: {
+        id: string;
+        description: string;
+        severity: "HIGH" | "MEDIUM" | "LOW";
+        category: "Interface" | "Behavior" | "Constraint";
+        changeType: "addition" | "removal" | "modification";
+        location: string;
+        proposedUpdate: string;
+        detectedBy: "structural" | "semantic";
+        symbolName?: string | null | undefined;
+        oldValue?: string | null | undefined;
+        newValue?: string | null | undefined;
+    }[];
+    filteredNoise: number;
+    recommendation: string;
+}>;
+export type DriftReport = z.infer<typeof DriftReportSchema>;
+/** 已完成模块 */
+export declare const CompletedModuleSchema: z.ZodObject<{
+    path: z.ZodString;
+    specPath: z.ZodString;
+    completedAt: z.ZodString;
+    /** 历史字段：input+output 累加的 token 总数（向后兼容） */
+    tokenUsage: z.ZodOptional<z.ZodNumber>;
+    /** 本次生成的成本元数据（Feature 127） */
+    costMetadata: z.ZodOptional<z.ZodObject<{
+        /** 本次生成消耗的 input / output token 数 */
+        tokenUsage: z.ZodObject<{
+            input: z.ZodNumber;
+            output: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            input: number;
+            output: number;
+        }, {
+            input: number;
+            output: number;
+        }>;
+        /** LLM + enrichment 总耗时（毫秒） */
+        durationMs: z.ZodNumber;
+        /** 实际使用的 LLM 模型 ID；AST-only 降级时为空字符串 */
+        llmModel: z.ZodString;
+        /** 降级原因；未降级时为 null */
+        fallbackReason: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        tokenUsage: {
+            input: number;
+            output: number;
+        };
+        durationMs: number;
+        llmModel: string;
+        fallbackReason: string | null;
+    }, {
+        tokenUsage: {
+            input: number;
+            output: number;
+        };
+        durationMs: number;
+        llmModel: string;
+        fallbackReason: string | null;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    specPath: string;
+    completedAt: string;
+    tokenUsage?: number | undefined;
+    costMetadata?: {
+        tokenUsage: {
+            input: number;
+            output: number;
+        };
+        durationMs: number;
+        llmModel: string;
+        fallbackReason: string | null;
+    } | undefined;
+}, {
+    path: string;
+    specPath: string;
+    completedAt: string;
+    tokenUsage?: number | undefined;
+    costMetadata?: {
+        tokenUsage: {
+            input: number;
+            output: number;
+        };
+        durationMs: number;
+        llmModel: string;
+        fallbackReason: string | null;
+    } | undefined;
+}>;
+export type CompletedModule = z.infer<typeof CompletedModuleSchema>;
+/** 失败模块 */
+export declare const FailedModuleSchema: z.ZodObject<{
+    path: z.ZodString;
+    error: z.ZodString;
+    failedAt: z.ZodString;
+    retryCount: z.ZodNumber;
+    degradedToAstOnly: z.ZodBoolean;
+    /** 失败原因标识（Bug 142）；'retry-budget-exceeded' 表示累计 input token 超限 */
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    error: string;
+    failedAt: string;
+    retryCount: number;
+    degradedToAstOnly: boolean;
+    reason?: string | undefined;
+}, {
+    path: string;
+    error: string;
+    failedAt: string;
+    retryCount: number;
+    degradedToAstOnly: boolean;
+    reason?: string | undefined;
+}>;
+export type FailedModule = z.infer<typeof FailedModuleSchema>;
+/** 批处理断点恢复状态 */
+export declare const BatchStateSchema: z.ZodObject<{
+    batchId: z.ZodString;
+    projectRoot: z.ZodString;
+    startedAt: z.ZodString;
+    lastUpdatedAt: z.ZodString;
+    totalModules: z.ZodNumber;
+    processingOrder: z.ZodArray<z.ZodString, "many">;
+    completedModules: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        specPath: z.ZodString;
+        completedAt: z.ZodString;
+        /** 历史字段：input+output 累加的 token 总数（向后兼容） */
+        tokenUsage: z.ZodOptional<z.ZodNumber>;
+        /** 本次生成的成本元数据（Feature 127） */
+        costMetadata: z.ZodOptional<z.ZodObject<{
+            /** 本次生成消耗的 input / output token 数 */
+            tokenUsage: z.ZodObject<{
+                input: z.ZodNumber;
+                output: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                input: number;
+                output: number;
+            }, {
+                input: number;
+                output: number;
+            }>;
+            /** LLM + enrichment 总耗时（毫秒） */
+            durationMs: z.ZodNumber;
+            /** 实际使用的 LLM 模型 ID；AST-only 降级时为空字符串 */
+            llmModel: z.ZodString;
+            /** 降级原因；未降级时为 null */
+            fallbackReason: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            tokenUsage: {
+                input: number;
+                output: number;
+            };
+            durationMs: number;
+            llmModel: string;
+            fallbackReason: string | null;
+        }, {
+            tokenUsage: {
+                input: number;
+                output: number;
+            };
+            durationMs: number;
+            llmModel: string;
+            fallbackReason: string | null;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        specPath: string;
+        completedAt: string;
+        tokenUsage?: number | undefined;
+        costMetadata?: {
+            tokenUsage: {
+                input: number;
+                output: number;
+            };
+            durationMs: number;
+            llmModel: string;
+            fallbackReason: string | null;
+        } | undefined;
+    }, {
+        path: string;
+        specPath: string;
+        completedAt: string;
+        tokenUsage?: number | undefined;
+        costMetadata?: {
+            tokenUsage: {
+                input: number;
+                output: number;
+            };
+            durationMs: number;
+            llmModel: string;
+            fallbackReason: string | null;
+        } | undefined;
+    }>, "many">;
+    failedModules: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        error: z.ZodString;
+        failedAt: z.ZodString;
+        retryCount: z.ZodNumber;
+        degradedToAstOnly: z.ZodBoolean;
+        /** 失败原因标识（Bug 142）；'retry-budget-exceeded' 表示累计 input token 超限 */
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        error: string;
+        failedAt: string;
+        retryCount: number;
+        degradedToAstOnly: boolean;
+        reason?: string | undefined;
+    }, {
+        path: string;
+        error: string;
+        failedAt: string;
+        retryCount: number;
+        degradedToAstOnly: boolean;
+        reason?: string | undefined;
+    }>, "many">;
+    forceRegenerate: z.ZodBoolean;
+    /** 语言分组信息（key: adapterId, value: 文件路径列表） */
+    languageGroups: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+    /** 过滤语言列表（用于断点恢复时还原过滤条件） */
+    filterLanguages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    projectRoot: string;
+    totalModules: number;
+    batchId: string;
+    startedAt: string;
+    lastUpdatedAt: string;
+    processingOrder: string[];
+    completedModules: {
+        path: string;
+        specPath: string;
+        completedAt: string;
+        tokenUsage?: number | undefined;
+        costMetadata?: {
+            tokenUsage: {
+                input: number;
+                output: number;
+            };
+            durationMs: number;
+            llmModel: string;
+            fallbackReason: string | null;
+        } | undefined;
+    }[];
+    failedModules: {
+        path: string;
+        error: string;
+        failedAt: string;
+        retryCount: number;
+        degradedToAstOnly: boolean;
+        reason?: string | undefined;
+    }[];
+    forceRegenerate: boolean;
+    languageGroups?: Record<string, string[]> | undefined;
+    filterLanguages?: string[] | undefined;
+}, {
+    projectRoot: string;
+    totalModules: number;
+    batchId: string;
+    startedAt: string;
+    lastUpdatedAt: string;
+    processingOrder: string[];
+    completedModules: {
+        path: string;
+        specPath: string;
+        completedAt: string;
+        tokenUsage?: number | undefined;
+        costMetadata?: {
+            tokenUsage: {
+                input: number;
+                output: number;
+            };
+            durationMs: number;
+            llmModel: string;
+            fallbackReason: string | null;
+        } | undefined;
+    }[];
+    failedModules: {
+        path: string;
+        error: string;
+        failedAt: string;
+        retryCount: number;
+        degradedToAstOnly: boolean;
+        reason?: string | undefined;
+    }[];
+    forceRegenerate: boolean;
+    languageGroups?: Record<string, string[]> | undefined;
+    filterLanguages?: string[] | undefined;
+}>;
+export type BatchState = z.infer<typeof BatchStateSchema>;
+/** 敏感信息检测项 */
+export declare const SecretDetectionSchema: z.ZodObject<{
+    type: z.ZodString;
+    line: z.ZodNumber;
+    confidence: z.ZodEnum<["high", "medium", "low"]>;
+    placeholder: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    line: number;
+    confidence: "low" | "medium" | "high";
+    placeholder: string;
+}, {
+    type: string;
+    line: number;
+    confidence: "low" | "medium" | "high";
+    placeholder: string;
+}>;
+export type SecretDetection = z.infer<typeof SecretDetectionSchema>;
+/** 敏感信息脱敏结果 */
+export declare const RedactionResultSchema: z.ZodObject<{
+    originalHash: z.ZodString;
+    redactedContent: z.ZodString;
+    detections: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        line: z.ZodNumber;
+        confidence: z.ZodEnum<["high", "medium", "low"]>;
+        placeholder: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        line: number;
+        confidence: "low" | "medium" | "high";
+        placeholder: string;
+    }, {
+        type: string;
+        line: number;
+        confidence: "low" | "medium" | "high";
+        placeholder: string;
+    }>, "many">;
+    falsePositivesFiltered: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    originalHash: string;
+    redactedContent: string;
+    detections: {
+        type: string;
+        line: number;
+        confidence: "low" | "medium" | "high";
+        placeholder: string;
+    }[];
+    falsePositivesFiltered: number;
+}, {
+    originalHash: string;
+    redactedContent: string;
+    detections: {
+        type: string;
+        line: number;
+        confidence: "low" | "medium" | "high";
+        placeholder: string;
+    }[];
+    falsePositivesFiltered: number;
+}>;
+export type RedactionResult = z.infer<typeof RedactionResultSchema>;
+/** 处理阶段标识符 */
+export type StageId = 'scan' | 'ast' | 'context' | 'llm' | 'parse' | 'render' | 'enrich' | 'lang-detect' | 'lang-graph';
+/** 阶段进度事件 */
+export interface StageProgress {
+    /** 阶段标识符 */
+    stage: StageId;
+    /** 阶段中文描述 */
+    message: string;
+    /** 阶段耗时（毫秒，仅完成时有值） */
+    duration?: number;
+}
+/** 阶段进度回调 */
+export type StageProgressCallback = (progress: StageProgress) => void;
+//# sourceMappingURL=module-spec.d.ts.map