spectra-cli 4.1.1

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

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

package/dist/models/module-spec.js

@@ -0,0 +1,272 @@
+/**
+ * ModuleSpec、ArchitectureIndex、DriftReport、BatchState、RedactionResult
+ * 及所有相关嵌套实体的 Zod Schema 定义
+ */
+import { z } from 'zod';
+import { CodeSkeletonSchema } from './code-skeleton.js';
+import { DriftItemSchema, DriftSummarySchema } from './drift-item.js';
+// ============================================================
+// 多语言支持：语言分布 Schema（Feature 031）
+// ============================================================
+/** 架构索引中展示的语言分布汇总信息 */
+export const LanguageDistributionSchema = z.object({
+    /** 语言显示名称（如 'TypeScript'） */
+    language: z.string().min(1),
+    /** 适配器 ID（如 'ts-js'） */
+    adapterId: z.string().min(1),
+    /** 文件数 */
+    fileCount: z.number().int().nonnegative(),
+    /** 模块数 */
+    moduleCount: z.number().int().nonnegative(),
+    /** 文件占比（%，保留一位小数） */
+    percentage: z.number().nonnegative(),
+    /** 本次批量生成是否处理了该语言 */
+    processed: z.boolean(),
+});
+// ============================================================
+// ModuleSpec 相关
+// ============================================================
+/** LLM token 使用量（input / output 分项） */
+export const TokenUsageSchema = z.object({
+    input: z.number().int().nonnegative(),
+    output: z.number().int().nonnegative(),
+});
+/**
+ * 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 const CostBreakdownSchema = z.object({
+    /** 跨模块上下文总 input token（dependencies / snippets / readme 等聚合） */
+    contextAssembly: z.number().int().nonnegative(),
+    /** prompt 模板 instructions 的 input token */
+    promptTemplate: z.number().int().nonnegative(),
+    /** 目标模块 skeleton 的 input token */
+    sourceFile: z.number().int().nonnegative(),
+    /** LLM response output token（来自 SDK usage） */
+    llmReasoning: z.number().int().nonnegative(),
+});
+/** 单次 spec 生成的成本元数据（Feature 127） */
+export const CostMetadataSchema = z.object({
+    /** 本次生成消耗的 input / output token 数 */
+    tokenUsage: TokenUsageSchema,
+    /** LLM + enrichment 总耗时（毫秒） */
+    durationMs: z.number().int().nonnegative(),
+    /** 实际使用的 LLM 模型 ID；AST-only 降级时为空字符串 */
+    llmModel: z.string(),
+    /** 降级原因；未降级时为 null */
+    fallbackReason: z.string().nullable(),
+});
+/** YAML Frontmatter */
+export const SpecFrontmatterSchema = z.object({
+    type: z.literal('module-spec'),
+    version: z.string().regex(/^v\d+$/),
+    generatedBy: z.string().min(1),
+    sourceTarget: z.string().min(1),
+    relatedFiles: z.array(z.string()),
+    lastUpdated: z.string().datetime(),
+    confidence: z.enum(['high', 'medium', 'low']),
+    skeletonHash: z.string().regex(/^[0-9a-f]{64}$/),
+    /** 模块主要编程语言（多语言项目时设置） */
+    language: z.string().optional(),
+    /** 跨语言引用（如 ['go:services/auth', 'python:scripts/deploy']） */
+    crossLanguageRefs: z.array(z.string()).optional(),
+    /** 人类可读的模块显示名（默认取目录名） */
+    displayName: z.string().optional(),
+    /** 本次生成消耗的 token 使用量（Feature 127） */
+    tokenUsage: TokenUsageSchema.optional(),
+    /** LLM + enrichment 总耗时（毫秒）（Feature 127） */
+    durationMs: z.number().int().nonnegative().optional(),
+    /** 实际使用的 LLM 模型 ID（Feature 127） */
+    llmModel: z.string().optional(),
+    /** 降级原因（Feature 127）；未降级时为 null */
+    fallbackReason: z.string().nullable().optional(),
+    /** 生成本 spec 时的批处理模式（Bug 142 修复）；旧 spec 缺失此字段时视为 cache miss */
+    generatedByMode: z.enum(['full', 'reading', 'code-only']).optional(),
+    /** spec 身份类型（Feature 128）；缺失时应用层默认视为 'canonical'（向后兼容历史 spec） */
+    sourceKind: z.enum(['canonical', 'derived', 'bundle_copy']).optional(),
+    /** 派生来源 spec 的 outputPath（Feature 128，相对于 projectRoot）；canonical 时为 null 或 undefined */
+    derivedFrom: z.string().nullable().optional(),
+    /**
+     * Feature 140 FR-012 — input token 来源细分（observability）。
+     * 旧 spec 缺失此字段时视为未观测，下游聚合 Top N 时跳过。
+     */
+    costBreakdown: CostBreakdownSchema.optional(),
+    /**
+     * Feature 140 FR-012 — context 是否被 budget 截断。
+     * true 时表示 `assembleContext` 因超预算丢弃了部分跨模块输入；缺失时视为 false（向后兼容）。
+     */
+    contextTruncated: z.boolean().optional(),
+});
+/** 9 段式 Spec 内容 */
+export const SpecSectionsSchema = z.object({
+    intent: z.string().min(1),
+    interfaceDefinition: z.string().min(1),
+    businessLogic: z.string().min(1),
+    dataStructures: z.string().min(1),
+    constraints: z.string().min(1),
+    edgeCases: z.string().min(1),
+    technicalDebt: z.string().min(1),
+    testCoverage: z.string().min(1),
+    dependencies: z.string().min(1),
+});
+/** Mermaid 图表 */
+export const MermaidDiagramSchema = z.object({
+    type: z.enum(['classDiagram', 'flowchart', 'graph']),
+    source: z.string().min(1),
+    title: z.string().optional(),
+});
+/** 源文件清单条目 */
+export const FileEntrySchema = z.object({
+    path: z.string().min(1),
+    loc: z.number().int().positive(),
+    purpose: z.string().min(1),
+});
+/** 交叉引用链接 */
+export const CrossReferenceLinkSchema = z.object({
+    label: z.string().min(1),
+    href: z.string().min(1),
+    targetSpecPath: z.string().min(1),
+    targetSourceTarget: z.string().min(1),
+    kind: z.enum(['same-module', 'cross-module']),
+    direction: z.enum(['internal', 'outbound', 'inbound', 'bidirectional']),
+    evidenceCount: z.number().int().positive(),
+    summary: z.string().min(1),
+});
+/** 当前模块的交叉引用索引 */
+export const ModuleCrossReferenceIndexSchema = z.object({
+    generatedAt: z.string().datetime(),
+    sameModule: z.array(CrossReferenceLinkSchema),
+    crossModule: z.array(CrossReferenceLinkSchema),
+});
+/** 单模块 Spec 文档结构化表示 */
+export const ModuleSpecSchema = z.object({
+    frontmatter: SpecFrontmatterSchema,
+    sections: SpecSectionsSchema,
+    mermaidDiagrams: z.array(MermaidDiagramSchema).optional(),
+    fileInventory: z.array(FileEntrySchema),
+    crossReferenceIndex: ModuleCrossReferenceIndexSchema.optional(),
+    baselineSkeleton: CodeSkeletonSchema,
+    outputPath: z.string().min(1),
+});
+// ============================================================
+// ArchitectureIndex 相关
+// ============================================================
+/** 架构索引 Frontmatter */
+export const IndexFrontmatterSchema = z.object({
+    type: z.literal('architecture-index'),
+    version: z.string().regex(/^v\d+$/),
+    generatedBy: z.string().min(1),
+    projectRoot: z.string().min(1),
+    totalModules: z.number().int().nonnegative(),
+    lastUpdated: z.string().datetime(),
+});
+/** 模块映射表条目 */
+export const ModuleMapEntrySchema = z.object({
+    name: z.string().min(1),
+    specPath: z.string().min(1),
+    description: z.string().min(1),
+    level: z.number().int().nonnegative(),
+    dependencies: z.array(z.string()),
+});
+/** 技术栈条目 */
+export const TechStackEntrySchema = z.object({
+    category: z.string().min(1),
+    name: z.string().min(1),
+    version: z.string().nullable().optional(),
+    purpose: z.string().min(1),
+});
+/** 项目级架构索引文档 */
+export const ArchitectureIndexSchema = z.object({
+    frontmatter: IndexFrontmatterSchema,
+    systemPurpose: z.string().min(1),
+    architecturePattern: z.string().min(1),
+    moduleMap: z.array(ModuleMapEntrySchema),
+    crossCuttingConcerns: z.array(z.string()),
+    technologyStack: z.array(TechStackEntrySchema),
+    dependencyDiagram: z.string().min(1),
+    outputPath: z.string().min(1),
+    /** 语言分布（多语言项目时填充，单语言或 undefined） */
+    languageDistribution: z.array(LanguageDistributionSchema).optional(),
+});
+// ============================================================
+// DriftReport 相关
+// ============================================================
+/** 漂移检测完整报告 */
+export const DriftReportSchema = z.object({
+    specPath: z.string().min(1),
+    sourcePath: z.string().min(1),
+    generatedAt: z.string().datetime(),
+    specVersion: z.string().min(1),
+    summary: DriftSummarySchema,
+    items: z.array(DriftItemSchema),
+    filteredNoise: z.number().int().nonnegative(),
+    recommendation: z.string().min(1),
+    outputPath: z.string().min(1),
+});
+// ============================================================
+// BatchState 相关
+// ============================================================
+/** 已完成模块 */
+export const CompletedModuleSchema = z.object({
+    path: z.string().min(1),
+    specPath: z.string().min(1),
+    completedAt: z.string().datetime(),
+    /** 历史字段：input+output 累加的 token 总数（向后兼容） */
+    tokenUsage: z.number().int().nonnegative().optional(),
+    /** 本次生成的成本元数据（Feature 127） */
+    costMetadata: CostMetadataSchema.optional(),
+});
+/** 失败模块 */
+export const FailedModuleSchema = z.object({
+    path: z.string().min(1),
+    error: z.string().min(1),
+    failedAt: z.string().datetime(),
+    retryCount: z.number().int().nonnegative(),
+    degradedToAstOnly: z.boolean(),
+    /** 失败原因标识（Bug 142）；'retry-budget-exceeded' 表示累计 input token 超限 */
+    reason: z.string().optional(),
+});
+/** 批处理断点恢复状态 */
+export const BatchStateSchema = z.object({
+    batchId: z.string().min(1),
+    projectRoot: z.string().min(1),
+    startedAt: z.string().datetime(),
+    lastUpdatedAt: z.string().datetime(),
+    totalModules: z.number().int().nonnegative(),
+    processingOrder: z.array(z.string()),
+    completedModules: z.array(CompletedModuleSchema),
+    failedModules: z.array(FailedModuleSchema),
+    forceRegenerate: z.boolean(),
+    /** 语言分组信息（key: adapterId, value: 文件路径列表） */
+    languageGroups: z.record(z.string(), z.array(z.string())).optional(),
+    /** 过滤语言列表（用于断点恢复时还原过滤条件） */
+    filterLanguages: z.array(z.string()).optional(),
+});
+// ============================================================
+// RedactionResult 相关
+// ============================================================
+/** 敏感信息检测项 */
+export const SecretDetectionSchema = z.object({
+    type: z.string().min(1),
+    line: z.number().int().positive(),
+    confidence: z.enum(['high', 'medium', 'low']),
+    placeholder: z.string().min(1),
+});
+/** 敏感信息脱敏结果 */
+export const RedactionResultSchema = z.object({
+    originalHash: z.string().min(1),
+    redactedContent: z.string(),
+    detections: z.array(SecretDetectionSchema),
+    falsePositivesFiltered: z.number().int().nonnegative(),
+});
+//# sourceMappingURL=module-spec.js.map

package/dist/models/module-spec.js.map

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

package/dist/panoramic/abstract-registry.d.ts

@@ -0,0 +1,87 @@
+/**
+ * AbstractRegistry<TItem, TEntry> — Registry 泛型基类
+ *
+ * 抽取 GeneratorRegistry 和 ArtifactParserRegistry 的共同逻辑：
+ * - items Map：id -> TItem 映射
+ * - enabledState Map：id -> boolean 启用/禁用状态
+ * - itemOrder 数组：按注册顺序维护的有序列表
+ * - 两阶段验证 register()：格式校验 + 冲突检测
+ * - get() / list() / setEnabled() / isEmpty() 通用方法
+ *
+ * 子类职责：
+ * - 各自管理 static instance 单例
+ * - 提供 getMetadataSchema()、extractMetadata()、buildEntry() 抽象实现
+ * - 扩展领域特有的查询方法（如 filterByContext、getByFilePattern）
+ */
+import type { z } from 'zod';
+/**
+ * Registry 泛型基类
+ *
+ * @typeParam TItem - 注册项的类型（如 DocumentGenerator、ArtifactParser）
+ * @typeParam TEntry - list() 返回的只读数据视图类型（如 GeneratorEntry、ParserEntry）
+ */
+export declare abstract class AbstractRegistry<TItem, TEntry> {
+    /** id -> 注册项实例映射 */
+    protected items: Map<string, TItem>;
+    /** id -> 启用/禁用状态映射 */
+    protected enabledState: Map<string, boolean>;
+    /** 按注册顺序维护的有序列表 */
+    protected itemOrder: TItem[];
+    /**
+     * 子类实现：返回用于验证注册项元数据的 Zod Schema
+     */
+    protected abstract getMetadataSchema(): z.ZodSchema;
+    /**
+     * 子类实现：从注册项中提取元数据供验证和冲突检测
+     * 返回的对象至少包含 id 和 name 字段
+     */
+    protected abstract extractMetadata(item: TItem): {
+        id: string;
+        name: string;
+        [key: string]: unknown;
+    };
+    /**
+     * 子类实现：根据注册项和启用状态构建 list() 返回的 Entry 对象
+     */
+    protected abstract buildEntry(item: TItem, enabled: boolean): TEntry;
+    /**
+     * 注册项实例
+     *
+     * 两阶段验证：
+     * 1. Phase A — 使用 Zod Schema 验证元数据格式
+     * 2. Phase B — 检查 id 冲突，已存在时抛出错误
+     * 任一阶段失败均不修改内部状态。
+     *
+     * @param item - 注册项实例
+     * @throws Error id 格式不符合 kebab-case 或已存在冲突时
+     */
+    register(item: TItem): void;
+    /**
+     * 按 id 查询单个已注册的实例
+     *
+     * @param id - 唯一标识符
+     * @returns 匹配的实例，未命中返回 undefined
+     */
+    get(id: string): TItem | undefined;
+    /**
+     * 全量列出所有已注册项及其启用/禁用状态
+     * 返回新数组（防御性拷贝），按注册顺序排列
+     *
+     * @returns TEntry 数组
+     */
+    list(): TEntry[];
+    /**
+     * 切换注册项的启用/禁用状态
+     *
+     * @param id - 唯一标识符
+     * @param enabled - 目标状态（true: 启用, false: 禁用）
+     * @throws Error 指定 id 不存在时
+     */
+    setEnabled(id: string, enabled: boolean): void;
+    /**
+     * 检查 Registry 是否为空（无任何已注册项）
+     * 用于区分"未初始化"和"无适用项"两种状态。
+     */
+    isEmpty(): boolean;
+}
+//# sourceMappingURL=abstract-registry.d.ts.map

package/dist/panoramic/abstract-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-registry.d.ts","sourceRoot":"","sources":["../../src/panoramic/abstract-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;;;;GAKG;AACH,8BAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM;IAClD,oBAAoB;IACpB,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAa;IAEhD,sBAAsB;IACtB,SAAS,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAa;IAEzD,mBAAmB;IACnB,SAAS,CAAC,SAAS,EAAE,KAAK,EAAE,CAAM;IAElC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,iBAAiB,IAAI,CAAC,CAAC,SAAS;IAEnD;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE;IAErG;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM;IAEpE;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IA4B3B;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIlC;;;;;OAKG;IACH,IAAI,IAAI,MAAM,EAAE;IAQhB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAO9C;;;OAGG;IACH,OAAO,IAAI,OAAO;CAGnB"}

package/dist/panoramic/abstract-registry.js

@@ -0,0 +1,88 @@
+/**
+ * Registry 泛型基类
+ *
+ * @typeParam TItem - 注册项的类型（如 DocumentGenerator、ArtifactParser）
+ * @typeParam TEntry - list() 返回的只读数据视图类型（如 GeneratorEntry、ParserEntry）
+ */
+export class AbstractRegistry {
+    /** id -> 注册项实例映射 */
+    items = new Map();
+    /** id -> 启用/禁用状态映射 */
+    enabledState = new Map();
+    /** 按注册顺序维护的有序列表 */
+    itemOrder = [];
+    /**
+     * 注册项实例
+     *
+     * 两阶段验证：
+     * 1. Phase A — 使用 Zod Schema 验证元数据格式
+     * 2. Phase B — 检查 id 冲突，已存在时抛出错误
+     * 任一阶段失败均不修改内部状态。
+     *
+     * @param item - 注册项实例
+     * @throws Error id 格式不符合 kebab-case 或已存在冲突时
+     */
+    register(item) {
+        const metadata = this.extractMetadata(item);
+        const schema = this.getMetadataSchema();
+        // Phase A: 使用 Zod Schema 验证元数据格式
+        const parseResult = schema.safeParse(metadata);
+        if (!parseResult.success) {
+            throw new Error(`id 格式错误: '${metadata.id}' 不符合 kebab-case 格式（要求匹配 /^[a-z][a-z0-9-]*$/）`);
+        }
+        // Phase B: 检查 id 冲突
+        const existing = this.items.get(metadata.id);
+        if (existing) {
+            const existingMeta = this.extractMetadata(existing);
+            throw new Error(`id 冲突: '${metadata.id}'（name: '${existingMeta.name}'）已注册，` +
+                `无法再注册 '${metadata.id}'（name: '${metadata.name}'）`);
+        }
+        // 提交：同时写入三个数据结构
+        this.items.set(metadata.id, item);
+        this.enabledState.set(metadata.id, true);
+        this.itemOrder.push(item);
+    }
+    /**
+     * 按 id 查询单个已注册的实例
+     *
+     * @param id - 唯一标识符
+     * @returns 匹配的实例，未命中返回 undefined
+     */
+    get(id) {
+        return this.items.get(id);
+    }
+    /**
+     * 全量列出所有已注册项及其启用/禁用状态
+     * 返回新数组（防御性拷贝），按注册顺序排列
+     *
+     * @returns TEntry 数组
+     */
+    list() {
+        return this.itemOrder.map((item) => {
+            const metadata = this.extractMetadata(item);
+            const enabled = this.enabledState.get(metadata.id) ?? true;
+            return this.buildEntry(item, enabled);
+        });
+    }
+    /**
+     * 切换注册项的启用/禁用状态
+     *
+     * @param id - 唯一标识符
+     * @param enabled - 目标状态（true: 启用, false: 禁用）
+     * @throws Error 指定 id 不存在时
+     */
+    setEnabled(id, enabled) {
+        if (!this.items.has(id)) {
+            throw new Error(`'${id}' not found in registry`);
+        }
+        this.enabledState.set(id, enabled);
+    }
+    /**
+     * 检查 Registry 是否为空（无任何已注册项）
+     * 用于区分"未初始化"和"无适用项"两种状态。
+     */
+    isEmpty() {
+        return this.itemOrder.length === 0;
+    }
+}
+//# sourceMappingURL=abstract-registry.js.map

package/dist/panoramic/abstract-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-registry.js","sourceRoot":"","sources":["../../src/panoramic/abstract-registry.ts"],"names":[],"mappings":"AAiBA;;;;;GAKG;AACH,MAAM,OAAgB,gBAAgB;IACpC,oBAAoB;IACV,KAAK,GAAuB,IAAI,GAAG,EAAE,CAAC;IAEhD,sBAAsB;IACZ,YAAY,GAAyB,IAAI,GAAG,EAAE,CAAC;IAEzD,mBAAmB;IACT,SAAS,GAAY,EAAE,CAAC;IAkBlC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,IAAW;QAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAExC,iCAAiC;QACjC,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,aAAa,QAAQ,CAAC,EAAE,+CAA+C,CACxE,CAAC;QACJ,CAAC;QAED,oBAAoB;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC7C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YACpD,MAAM,IAAI,KAAK,CACb,WAAW,QAAQ,CAAC,EAAE,YAAY,YAAY,CAAC,IAAI,QAAQ;gBAC3D,UAAU,QAAQ,CAAC,EAAE,YAAY,QAAQ,CAAC,IAAI,IAAI,CACnD,CAAC;QACJ,CAAC;QAED,gBAAgB;QAChB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;OAKG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;YAC3D,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,EAAU,EAAE,OAAgB;QACrC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/panoramic/anchoring/chunker.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 文档切片（Chunk）
+ * 来自单个 Markdown 章节，包含位置信息和文本内容
+ */
+export interface DocChunk {
+    /** repo-relative 路径（已规范化为正斜杠） */
+    filePath: string;
+    /** chunk 起始行（1-based，含） */
+    startLine: number;
+    /** chunk 结束行（1-based，含） */
+    endLine: number;
+    /** 层级路径，如 "## Design > ### API" */
+    headingPath: string;
+    /** chunk 文本内容（去除 markdown 格式符） */
+    text: string;
+    /** 粗估 token 数（字符数 / 4，用于上限控制） */
+    tokenCount: number;
+}
+/**
+ * Chunker 选项
+ */
+export interface DocChunkerOptions {
+    /** 单个 chunk 的最大 token 数（默认 512） */
+    maxTokens?: number;
+}
+/**
+ * 批量切分 Markdown 文件为 DocChunk 数组
+ *
+ * @param filePaths   绝对路径列表（若为空则直接返回 []，FR-015 降级场景）
+ * @param projectRoot 项目根目录（用于计算 repo-relative 路径）
+ * @param options     Chunker 选项（默认 maxTokens=512）
+ */
+export declare function chunkMarkdownFiles(filePaths: string[], projectRoot: string, options?: DocChunkerOptions): DocChunk[];
+//# sourceMappingURL=chunker.d.ts.map

package/dist/panoramic/anchoring/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../../src/panoramic/anchoring/chunker.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA0BD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,QAAQ,EAAE,CAeZ"}