spectra-cli 4.1.1

package/dist/panoramic/stored-module-specs.d.ts

@@ -0,0 +1,26 @@
+import type { CodeSkeleton } from '../models/code-skeleton.js';
+export interface StoredModuleSpecRecord {
+    sourceTarget: string;
+    relatedFiles: string[];
+    confidence: 'high' | 'medium' | 'low';
+    intentSummary: string;
+    businessSummary: string;
+    dependencySummary: string;
+    baselineSkeleton?: CodeSkeleton;
+}
+interface SpecFrontmatter {
+    type?: string;
+    sourceTarget?: string;
+    confidence?: 'high' | 'medium' | 'low';
+    relatedFiles: string[];
+}
+export declare function loadStoredModuleSpecs(outputDir: string, projectRoot: string): StoredModuleSpecRecord[];
+export declare function parseStoredModuleSpec(filePath: string, projectRoot: string): StoredModuleSpecRecord | null;
+export declare function extractStoredSpecFrontmatter(content: string): SpecFrontmatter | null;
+export declare function extractStoredSpecSectionSummary(content: string, sectionNumber: number, fallback: string): string;
+export declare function summarizeStoredMarkdown(content: string, fallback: string): string;
+export declare function extractStoredBaselineSkeleton(content: string): CodeSkeleton | undefined;
+export declare function normalizeStoredProjectPath(inputPath: string, projectRoot: string): string;
+export declare function stripYamlScalar(value: string): string;
+export {};
+//# sourceMappingURL=stored-module-specs.d.ts.map

package/dist/panoramic/stored-module-specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-module-specs.d.ts","sourceRoot":"","sources":["../../src/panoramic/stored-module-specs.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAK/D,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,YAAY,CAAC;CACjC;AAED,UAAU,eAAe;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACvC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,sBAAsB,EAAE,CAY1B;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,sBAAsB,GAAG,IAAI,CAgB/B;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAqDpF;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,MAAM,CAiBR;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAcjF;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAYvF;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAMzF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQrD"}

package/dist/panoramic/stored-module-specs.js

@@ -0,0 +1,155 @@
+/**
+ * Stored module spec helpers
+ *
+ * 统一读取 batch 已生成的 module specs，并提取 frontmatter、章节摘要和 baseline skeleton。
+ * 该 helper 同时供 architecture-narrative 与 Feature 057 的组件/动态链路构建复用。
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { createLogger } from './utils/logger.js';
+const logger = createLogger('stored-module-specs');
+export function loadStoredModuleSpecs(outputDir, projectRoot) {
+    if (!fs.existsSync(outputDir)) {
+        return [];
+    }
+    const markdownSpecFiles = [];
+    walkStoredSpecFiles(outputDir, markdownSpecFiles);
+    return markdownSpecFiles
+        .map((filePath) => parseStoredModuleSpec(filePath, projectRoot))
+        .filter((item) => item !== null)
+        .sort((left, right) => left.sourceTarget.localeCompare(right.sourceTarget));
+}
+export function parseStoredModuleSpec(filePath, projectRoot) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const frontmatter = extractStoredSpecFrontmatter(content);
+    if (!frontmatter || frontmatter.type !== 'module-spec' || !frontmatter.sourceTarget) {
+        return null;
+    }
+    return {
+        sourceTarget: normalizeStoredProjectPath(frontmatter.sourceTarget, projectRoot),
+        relatedFiles: frontmatter.relatedFiles.map((item) => normalizeStoredProjectPath(item, projectRoot)),
+        confidence: frontmatter.confidence ?? 'medium',
+        intentSummary: extractStoredSpecSectionSummary(content, 1, frontmatter.sourceTarget),
+        businessSummary: extractStoredSpecSectionSummary(content, 2, `${frontmatter.sourceTarget} 的业务逻辑以模块职责为中心组织`),
+        dependencySummary: extractStoredSpecSectionSummary(content, 9, `${frontmatter.sourceTarget} 的依赖关系未在既有 spec 中显式描述`),
+        baselineSkeleton: extractStoredBaselineSkeleton(content),
+    };
+}
+export function extractStoredSpecFrontmatter(content) {
+    const match = /^---\r?\n([\s\S]*?)\r?\n---/m.exec(content);
+    if (!match?.[1]) {
+        return null;
+    }
+    const lines = match[1].split(/\r?\n/);
+    let type;
+    let sourceTarget;
+    let confidence;
+    const relatedFiles = [];
+    let inRelatedFiles = false;
+    for (const rawLine of lines) {
+        const line = rawLine.trimEnd();
+        if (line.startsWith('type:')) {
+            type = stripYamlScalar(line.slice('type:'.length).trim());
+            inRelatedFiles = false;
+            continue;
+        }
+        if (line.startsWith('sourceTarget:')) {
+            sourceTarget = stripYamlScalar(line.slice('sourceTarget:'.length).trim());
+            inRelatedFiles = false;
+            continue;
+        }
+        if (line.startsWith('confidence:')) {
+            const parsed = stripYamlScalar(line.slice('confidence:'.length).trim());
+            if (parsed === 'high' || parsed === 'medium' || parsed === 'low') {
+                confidence = parsed;
+            }
+            inRelatedFiles = false;
+            continue;
+        }
+        if (line === 'relatedFiles:') {
+            inRelatedFiles = true;
+            continue;
+        }
+        if (inRelatedFiles) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith('- ')) {
+                relatedFiles.push(stripYamlScalar(trimmed.slice(2).trim()));
+                continue;
+            }
+            inRelatedFiles = false;
+        }
+    }
+    return { type, sourceTarget, confidence, relatedFiles };
+}
+export function extractStoredSpecSectionSummary(content, sectionNumber, fallback) {
+    const headingRe = new RegExp(String.raw `^##\s+${sectionNumber}\.\s+[^\r\n]+\r?\n`, 'm');
+    const headingMatch = headingRe.exec(content);
+    if (!headingMatch?.[0]) {
+        return fallback;
+    }
+    const start = headingMatch.index + headingMatch[0].length;
+    const remainder = content.slice(start);
+    const boundaries = [
+        remainder.search(/^[ \t]*##\s+\d+\.\s+[^\r\n]+/m),
+        remainder.search(/^[ \t]*---\s*$/m),
+        remainder.search(/<!-- baseline-skeleton:/m),
+    ].filter((index) => index >= 0);
+    const end = boundaries.length > 0 ? Math.min(...boundaries) : remainder.length;
+    return summarizeStoredMarkdown(remainder.slice(0, end), fallback);
+}
+export function summarizeStoredMarkdown(content, fallback) {
+    const line = content
+        .split(/\r?\n/)
+        .map((item) => item
+        .replace(/^[-*]\s+/, '')
+        .replace(/^\d+\.\s+/, '')
+        .trim())
+        .find((item) => item.length > 0
+        && !item.startsWith('```')
+        && !item.startsWith('|')
+        && !/^<a\s+/i.test(item));
+    return line ?? fallback;
+}
+export function extractStoredBaselineSkeleton(content) {
+    const match = /<!-- baseline-skeleton: ([\s\S]*?) -->/.exec(content);
+    if (!match?.[1]) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(match[1]);
+    }
+    catch (err) {
+        logger.debug(`baseline-skeleton JSON 解析失败: ${String(err)}`);
+        return undefined;
+    }
+}
+export function normalizeStoredProjectPath(inputPath, projectRoot) {
+    const absolutePath = path.isAbsolute(inputPath)
+        ? inputPath
+        : path.join(projectRoot, inputPath);
+    const rel = path.relative(projectRoot, absolutePath);
+    return rel.startsWith('..') ? inputPath.split(path.sep).join('/') : rel.split(path.sep).join('/');
+}
+export function stripYamlScalar(value) {
+    if ((value.startsWith('"') && value.endsWith('"'))
+        || (value.startsWith('\'') && value.endsWith('\''))) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+function walkStoredSpecFiles(dir, results) {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isSymbolicLink()) {
+            continue;
+        }
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            walkStoredSpecFiles(fullPath, results);
+            continue;
+        }
+        if (entry.isFile() && entry.name.endsWith('.spec.md') && !entry.name.startsWith('_')) {
+            results.push(fullPath);
+        }
+    }
+}
+//# sourceMappingURL=stored-module-specs.js.map

package/dist/panoramic/stored-module-specs.js.map

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

package/dist/panoramic/utils/html-sanitizer.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Block-level HTML 净化工具
+ *
+ * Feature 125: 替代 Fix 124 的粗暴 `<[^>]+>` 全量 strip，
+ * 只处理**行首锚定**的 HTML block，保留合法行内尖括号内容
+ * （TypeScript 泛型、CLI 占位符、数值比较等）。
+ *
+ * 设计原则：
+ * 1. 只识别常见 HTML block 元素（p/div/img/br/hr/h1-6/details/summary/table/iframe）
+ * 2. 行首锚定：以 `^\s*<tag` 开头才判定为 block
+ * 3. `<details>/<summary>` 保留内部文字内容（不粗暴剥除语义节点）
+ * 4. 支持 HTML entity 解码（&lt; &gt; &amp; &quot; &#xxx;）
+ */
+/**
+ * 剥除行首锚定的 block HTML 标签，保留内部文字和行内内容
+ *
+ * 行为：
+ *   - 逐行处理：整行为 block HTML 开头（如 `<p>...`）则剥除标签，保留内部文字
+ *   - 对 `<details>/<summary>` 的嵌套块先做结构化提取（保留语义内容）
+ *   - 不处理行内尖括号（`Array<T>`、`<target>`、`a < b` 等全部保留）
+ *   - 多行 block（如 `<div>\n...\n</div>`）按块合并处理
+ */
+export declare function stripBlockHtml(text: string): string;
+/**
+ * 解码常见的 HTML entity：&lt; &gt; &amp; &quot; &apos; &nbsp; 以及数字实体
+ */
+export declare function decodeHtmlEntities(text: string): string;
+/**
+ * 一步完成：block HTML 剥除 + entity 解码。
+ * 这是 product-ux-docs 的主要调用点。
+ */
+export declare function sanitizeMarkdownContent(text: string): string;
+//# sourceMappingURL=html-sanitizer.d.ts.map

package/dist/panoramic/utils/html-sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-sanitizer.d.ts","sourceRoot":"","sources":["../../../src/panoramic/utils/html-sanitizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAgCH;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkFnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmCvD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/panoramic/utils/html-sanitizer.js

@@ -0,0 +1,170 @@
+/**
+ * Block-level HTML 净化工具
+ *
+ * Feature 125: 替代 Fix 124 的粗暴 `<[^>]+>` 全量 strip，
+ * 只处理**行首锚定**的 HTML block，保留合法行内尖括号内容
+ * （TypeScript 泛型、CLI 占位符、数值比较等）。
+ *
+ * 设计原则：
+ * 1. 只识别常见 HTML block 元素（p/div/img/br/hr/h1-6/details/summary/table/iframe）
+ * 2. 行首锚定：以 `^\s*<tag` 开头才判定为 block
+ * 3. `<details>/<summary>` 保留内部文字内容（不粗暴剥除语义节点）
+ * 4. 支持 HTML entity 解码（&lt; &gt; &amp; &quot; &#xxx;）
+ */
+/** 常见的 block-level HTML 标签 */
+const BLOCK_TAGS = [
+    'p', 'div', 'section', 'article', 'aside', 'header', 'footer', 'nav',
+    'img', 'br', 'hr', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6',
+    'table', 'iframe', 'pre', 'ul', 'ol', 'li', 'blockquote',
+];
+const BLOCK_TAG_PATTERN = BLOCK_TAGS.join('|');
+/**
+ * 判定一行是否以 block HTML 开头（行首锚定，忽略缩进）
+ */
+const BLOCK_START_RE = new RegExp(`^\\s*<(${BLOCK_TAG_PATTERN})\\b[^>]*>`, 'i');
+const BLOCK_SELF_CLOSING_RE = new RegExp(`^\\s*<(${BLOCK_TAG_PATTERN})\\b[^>]*\\/?\\s*>$`, 'i');
+/**
+ * 提取 `<details>...</details>` 中的文字内容
+ * 保留 summary 内容（若有）和 details 内容，移除其他标签
+ */
+function extractDetailsContent(text) {
+    // 捕获最外层 details 块内容
+    const detailsRe = /<details\b[^>]*>([\s\S]*?)<\/details>/gi;
+    return text.replace(detailsRe, (_, inner) => {
+        // 提取 summary 内容
+        let result = inner.replace(/<summary\b[^>]*>([\s\S]*?)<\/summary>/gi, '$1');
+        // 移除 details 内可能的其他 block 标签，保留文字
+        result = result.replace(/<\/?(?:p|div|section|article)\b[^>]*>/gi, ' ');
+        return result.trim();
+    });
+}
+/**
+ * 剥除行首锚定的 block HTML 标签，保留内部文字和行内内容
+ *
+ * 行为：
+ *   - 逐行处理：整行为 block HTML 开头（如 `<p>...`）则剥除标签，保留内部文字
+ *   - 对 `<details>/<summary>` 的嵌套块先做结构化提取（保留语义内容）
+ *   - 不处理行内尖括号（`Array<T>`、`<target>`、`a < b` 等全部保留）
+ *   - 多行 block（如 `<div>\n...\n</div>`）按块合并处理
+ */
+export function stripBlockHtml(text) {
+    if (!text)
+        return text;
+    // Step 1: 先处理 <details> 块（保留内部文字）
+    let result = extractDetailsContent(text);
+    // Step 2: 移除行首锚定的 block tag（开标签/闭标签/自闭合）
+    // 逐行扫描，识别连续的 block 段
+    const lines = result.split('\n');
+    const cleaned = [];
+    let inBlock = false;
+    let blockTag = '';
+    let blockContent = [];
+    for (const line of lines) {
+        if (inBlock) {
+            // 在多行 block 内，寻找闭标签
+            const closeRe = new RegExp(`</${blockTag}\\s*>`, 'i');
+            const closeMatch = line.match(closeRe);
+            if (closeMatch && closeMatch.index !== undefined) {
+                // 闭合前内容保留
+                blockContent.push(line.slice(0, closeMatch.index));
+                const after = line.slice(closeMatch.index + closeMatch[0].length);
+                const blockText = blockContent.join(' ').replace(/<[^>]+>/g, ' ').trim();
+                if (blockText)
+                    cleaned.push(blockText);
+                if (after.trim())
+                    cleaned.push(after);
+                inBlock = false;
+                blockTag = '';
+                blockContent = [];
+            }
+            else {
+                blockContent.push(line);
+            }
+            continue;
+        }
+        // 未在 block 内：检测行首是否为 block 开标签
+        const blockStart = line.match(BLOCK_START_RE);
+        if (!blockStart) {
+            cleaned.push(line);
+            continue;
+        }
+        blockTag = (blockStart[1] ?? '').toLowerCase();
+        const startIdx = (blockStart.index ?? 0) + blockStart[0].length;
+        const afterOpen = line.slice(startIdx);
+        // 自闭合（`<img .../>` 或 void 标签如 `<br>`、`<hr>`、`<img>`）
+        if (BLOCK_SELF_CLOSING_RE.test(line) ||
+            ['br', 'hr', 'img'].includes(blockTag)) {
+            if (afterOpen.trim())
+                cleaned.push(afterOpen);
+            blockTag = '';
+            continue;
+        }
+        // 同一行包含闭合
+        const sameLineCloseRe = new RegExp(`</${blockTag}\\s*>`, 'i');
+        const sameLineClose = line.match(sameLineCloseRe);
+        if (sameLineClose && sameLineClose.index !== undefined) {
+            const innerStart = startIdx;
+            const innerEnd = sameLineClose.index;
+            const inner = line.slice(innerStart, innerEnd).replace(/<[^>]+>/g, ' ').trim();
+            const after = line.slice(sameLineClose.index + sameLineClose[0].length);
+            if (inner)
+                cleaned.push(inner);
+            if (after.trim())
+                cleaned.push(after);
+            blockTag = '';
+            continue;
+        }
+        // 多行 block，进入 block 模式
+        inBlock = true;
+        if (afterOpen.trim())
+            blockContent.push(afterOpen);
+    }
+    // 未闭合的 block（容错）
+    if (inBlock && blockContent.length > 0) {
+        const tail = blockContent.join(' ').replace(/<[^>]+>/g, ' ').trim();
+        if (tail)
+            cleaned.push(tail);
+    }
+    return cleaned.join('\n');
+}
+/**
+ * 解码常见的 HTML entity：&lt; &gt; &amp; &quot; &apos; &nbsp; 以及数字实体
+ */
+export function decodeHtmlEntities(text) {
+    if (!text)
+        return text;
+    const namedEntities = {
+        '&lt;': '<',
+        '&gt;': '>',
+        '&amp;': '&',
+        '&quot;': '"',
+        '&apos;': "'",
+        '&nbsp;': ' ',
+        '&copy;': '©',
+        '&reg;': '®',
+        '&mdash;': '—',
+        '&ndash;': '–',
+        '&hellip;': '…',
+    };
+    let result = text;
+    // 先处理命名实体
+    for (const [entity, decoded] of Object.entries(namedEntities)) {
+        result = result.split(entity).join(decoded);
+    }
+    // 数字实体 &#123; &#xAB;
+    result = result.replace(/&#(\d+);/g, (_, code) => String.fromCodePoint(Number(code)));
+    result = result.replace(/&#x([0-9a-fA-F]+);/g, (_, hex) => String.fromCodePoint(parseInt(hex, 16)));
+    // &amp; 可能引入其他 entity（如 &amp;lt; -> &lt; -> <），再跑一轮
+    for (const [entity, decoded] of Object.entries(namedEntities)) {
+        result = result.split(entity).join(decoded);
+    }
+    return result;
+}
+/**
+ * 一步完成：block HTML 剥除 + entity 解码。
+ * 这是 product-ux-docs 的主要调用点。
+ */
+export function sanitizeMarkdownContent(text) {
+    return decodeHtmlEntities(stripBlockHtml(text));
+}
+//# sourceMappingURL=html-sanitizer.js.map

package/dist/panoramic/utils/html-sanitizer.js.map

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

package/dist/panoramic/utils/llm-enricher.d.ts

@@ -0,0 +1,74 @@
+/**
+ * LLM 语义增强工具函数
+ *
+ * 为空 description 的数据模型字段和配置项批量调用 LLM 推断说明。
+ * 所有 LLM 推断的 description 以 [AI] 前缀标注，与人工注释明确区分。
+ *
+ * 导出函数：
+ * - enrichModelDescriptions: 数据模型实体级描述增强（类似 API Reference class description）
+ * - enrichFieldDescriptions: 数据模型字段语义增强
+ * - enrichConfigDescriptions: 配置项语义增强（含文件级 + 配置项级）
+ *
+ * 降级策略：LLM 不可用时静默降级，不抛异常，返回原始数据。
+ */
+import { z } from 'zod';
+import type { DataModel } from '../generators/data-model-generator.js';
+import type { ConfigFileResult } from '../generators/config-reference-generator.js';
+/** 单个字段/配置项的 LLM 推断结果 */
+export declare const EnrichFieldResultSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+}, {
+    name: string;
+    description: string;
+}>;
+/** LLM 批量推断结果数组 */
+export declare const EnrichBatchResultSchema: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+}, {
+    name: string;
+    description: string;
+}>, "many">;
+/**
+ * 批量为空 description 的数据模型字段调用 LLM 推断说明
+ *
+ * 处理逻辑：
+ * 1. 深拷贝 models 数组（不修改原数据）
+ * 2. 收集 description === null 且不以 [AI] 开头的字段
+ * 3. 若无空字段，直接返回
+ * 4. 检查 LLM 可用性，不可用则静默返回原数据
+ * 5. 按模型分组，每个模型发一次 LLM 调用
+ * 6. 解析响应，匹配回字段，添加 [AI] 前缀
+ * 7. 单个模型调用失败时 catch 并跳过
+ *
+ * @param models - DataModel 数组（含待增强的字段）
+ * @returns 增强后的 DataModel 数组（深拷贝，不修改原数组）
+ */
+export declare function enrichFieldDescriptions(models: DataModel[]): Promise<DataModel[]>;
+/**
+ * 批量为空 description 的数据模型实体调用 LLM 推断描述
+ * 类似 API Reference 中 class/interface 顶部的描述说明。
+ *
+ * @param models - DataModel 数组
+ * @returns 增强后的 DataModel 数组（深拷贝，不修改原数组）
+ */
+export declare function enrichModelDescriptions(models: DataModel[]): Promise<DataModel[]>;
+/**
+ * 批量为空 description 的配置项和配置文件调用 LLM 推断说明
+ *
+ * 处理两个层级：
+ * 1. 文件级描述：每个配置文件的整体作用说明
+ * 2. 配置项级描述：每个配置项的作用说明
+ *
+ * @param files - ConfigFileResult 数组
+ * @returns 增强后的 ConfigFileResult 数组（深拷贝）
+ */
+export declare function enrichConfigDescriptions(files: ConfigFileResult[]): Promise<ConfigFileResult[]>;
+//# sourceMappingURL=llm-enricher.d.ts.map

package/dist/panoramic/utils/llm-enricher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-enricher.d.ts","sourceRoot":"","sources":["../../../src/panoramic/utils/llm-enricher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAUpF,yBAAyB;AACzB,eAAO,MAAM,uBAAuB;;;;;;;;;EAGlC,CAAC;AAEH,mBAAmB;AACnB,eAAO,MAAM,uBAAuB;;;;;;;;;WAAmC,CAAC;AAgGxE;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,SAAS,EAAE,GAClB,OAAO,CAAC,SAAS,EAAE,CAAC,CAiEtB;AAMD;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,SAAS,EAAE,GAClB,OAAO,CAAC,SAAS,EAAE,CAAC,CAuDtB;AAMD;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,gBAAgB,EAAE,GACxB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAuF7B"}