spectra-cli 4.1.1

package/dist/extraction/openapi-extractor.js

@@ -0,0 +1,449 @@
+/**
+ * OpenAPI / AsyncAPI 提取器（Feature 107）
+ * 独立实现，不修改 api-surface/openapi-extractor.ts
+ * 输出：ExtractionResult（包含 api / api-schema / event 节点）
+ *
+ * 实现的功能：
+ * - JSON/YAML 格式 OpenAPI 3.x/Swagger 2.x 解析
+ * - AsyncAPI 2.x channel/message → event 节点
+ * - $ref 循环检测（visited set + 5 层绝对深度上限 + 占位节点）
+ * - 置信度均为 EXTRACTED（确定性提取）
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { createLogger } from '../panoramic/utils/logger.js';
+import { EMPTY_EXTRACTION_RESULT } from './extraction-types.js';
+const logger = createLogger('extraction-openapi');
+// ============================================================
+// $ref 循环检测常量
+// ============================================================
+/** $ref 解析绝对层数上限（超过则插入占位节点） */
+const REF_MAX_DEPTH = 5;
+// ============================================================
+// 轻量 YAML 解析（仅覆盖 OpenAPI spec 的 key-value + $ref 场景）
+// ============================================================
+/**
+ * 极简 YAML 解析器，仅支持 OpenAPI/AsyncAPI spec 所需的子集：
+ * - key: value（字符串、数字、布尔）
+ * - key: （嵌套对象，通过缩进识别）
+ * - $ref: "#/..."
+ *
+ * 不支持 YAML 锚点、别名、多文档等高级特性。
+ * 对于无法解析的内容返回 null。
+ */
+function parseSimpleYaml(content) {
+    const lines = content.split('\n');
+    // 使用迭代式栈解析缩进层次
+    return parseYamlBlock(lines, 0, -1).value;
+}
+function unquote(s) {
+    if ((s.startsWith('"') && s.endsWith('"')) || (s.startsWith("'") && s.endsWith("'"))) {
+        return s.slice(1, -1);
+    }
+    return s;
+}
+function parseYamlValue(raw) {
+    const s = raw.trim();
+    if (s === 'true' || s === 'yes')
+        return true;
+    if (s === 'false' || s === 'no')
+        return false;
+    if (s === 'null' || s === '~' || s === '')
+        return null;
+    const num = Number(s);
+    if (!isNaN(num) && s !== '')
+        return num;
+    return unquote(s);
+}
+function parseYamlBlock(lines, startLine, parentIndent) {
+    const result = {};
+    let i = startLine;
+    while (i < lines.length) {
+        const line = lines[i];
+        // 跳过注释和空行
+        const trimmed = line.trimStart();
+        if (trimmed.startsWith('#') || trimmed === '') {
+            i++;
+            continue;
+        }
+        // 计算当前缩进
+        const indent = line.length - trimmed.length;
+        // 当前行缩进不超过父级，返回
+        if (indent <= parentIndent) {
+            break;
+        }
+        // 解析 key: value 或 key:
+        const colonIdx = trimmed.indexOf(': ');
+        const colonEnd = trimmed.endsWith(':') ? trimmed.length - 1 : -1;
+        if (colonIdx !== -1) {
+            const key = unquote(trimmed.slice(0, colonIdx).trim());
+            const valueStr = trimmed.slice(colonIdx + 2).trim();
+            if (valueStr === '' || valueStr.startsWith('#')) {
+                // key: （子对象或数组，由下一行决定）
+                const nextNonEmpty = lines.slice(i + 1).findIndex((l) => l.trimStart() !== '' && !l.trimStart().startsWith('#'));
+                const nextLine = nextNonEmpty === -1 ? lines.length : i + 1 + nextNonEmpty;
+                const nextTrimmed = nextLine < lines.length ? lines[nextLine].trimStart() : '';
+                if (nextTrimmed.startsWith('- ')) {
+                    // 数组 block
+                    const arr = parseYamlArray(lines, i + 1, indent);
+                    result[key] = arr.value;
+                    i = arr.nextLine;
+                }
+                else {
+                    const sub = parseYamlBlock(lines, i + 1, indent);
+                    result[key] = sub.value;
+                    i = sub.nextLine;
+                }
+            }
+            else {
+                result[key] = parseYamlValue(valueStr);
+                i++;
+            }
+        }
+        else if (colonEnd !== -1) {
+            const key = unquote(trimmed.slice(0, colonEnd).trim());
+            const sub = parseYamlBlock(lines, i + 1, indent);
+            result[key] = sub.value;
+            i = sub.nextLine;
+        }
+        else {
+            // 非 key: value 行，跳过
+            i++;
+        }
+    }
+    return { value: result, nextLine: i };
+}
+/**
+ * 解析 YAML 列表块（`- item` 格式）
+ */
+function parseYamlArray(lines, startLine, parentIndent) {
+    const result = [];
+    let i = startLine;
+    while (i < lines.length) {
+        const line = lines[i];
+        const trimmed = line.trimStart();
+        if (trimmed.startsWith('#') || trimmed === '') {
+            i++;
+            continue;
+        }
+        const indent = line.length - trimmed.length;
+        if (indent <= parentIndent)
+            break;
+        if (trimmed.startsWith('- ')) {
+            result.push(parseYamlValue(trimmed.slice(2).trim()));
+            i++;
+        }
+        else {
+            break;
+        }
+    }
+    return { value: result, nextLine: i };
+}
+// ============================================================
+// 辅助：类型检查
+// ============================================================
+function isObj(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+// ============================================================
+// $ref 解析（内部，带循环检测）
+// ============================================================
+/**
+ * 解析 JSON Pointer 格式的 $ref（如 #/components/schemas/User）
+ */
+function resolveRef(doc, ref) {
+    if (!ref.startsWith('#/'))
+        return null;
+    const segments = ref.slice(2).split('/').map((s) => s.replace(/~1/g, '/').replace(/~0/g, '~'));
+    let cur = doc;
+    for (const seg of segments) {
+        if (!isObj(cur))
+            return null;
+        cur = cur[seg];
+    }
+    return cur ?? null;
+}
+/**
+ * 递归解引用 $ref，带深度限制和已访问集合（循环检测）
+ */
+function dereferenceWithDepth(doc, value, visited, depth) {
+    if (depth > REF_MAX_DEPTH) {
+        return { _truncated: true, reason: '[ref-truncated]' };
+    }
+    if (!isObj(value) || typeof value.$ref !== 'string') {
+        return value;
+    }
+    const ref = value.$ref;
+    if (visited.has(ref)) {
+        return { _truncated: true, reason: `[ref-cycle: ${ref}]` };
+    }
+    const resolved = resolveRef(doc, ref);
+    if (!resolved)
+        return value;
+    visited.add(ref);
+    const result = dereferenceWithDepth(doc, resolved, visited, depth + 1);
+    visited.delete(ref);
+    return result;
+}
+// ============================================================
+// 节点 ID 生成（遵循 data-model.md 规则）
+// ============================================================
+function makeApiNodeId(method, pathStr, sourceFile) {
+    return `api:${method.toUpperCase()}:${pathStr}:${sourceFile}`;
+}
+function makeSchemaNodeId(schemaName, sourceFile) {
+    return `schema:${schemaName}:${sourceFile}`;
+}
+function makeEventNodeId(channelName, sourceFile) {
+    return `event:${channelName}:${sourceFile}`;
+}
+// ============================================================
+// OpenAPI 解析核心逻辑
+// ============================================================
+const HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace'];
+/**
+ * 解析 OpenAPI 3.x / Swagger 2.x 文档，生成节点和边
+ */
+function parseOpenApiDoc(doc, relativeSourceFile) {
+    const nodes = [];
+    const edges = [];
+    if (!isObj(doc))
+        return { nodes, edges };
+    // 解析 components.schemas → api-schema 节点
+    const schemas = [];
+    if (isObj(doc.components) && isObj(doc.components.schemas)) {
+        for (const schemaName of Object.keys(doc.components.schemas)) {
+            const nodeId = makeSchemaNodeId(schemaName, relativeSourceFile);
+            schemas.push(nodeId);
+            nodes.push({
+                id: nodeId,
+                label: schemaName,
+                kind: 'api-schema',
+                source_file: relativeSourceFile,
+                confidence: 'EXTRACTED',
+                metadata: { sourceType: 'openapi-schema' },
+            });
+        }
+    }
+    // Swagger 2.x definitions → api-schema 节点
+    if (isObj(doc.definitions)) {
+        for (const schemaName of Object.keys(doc.definitions)) {
+            const nodeId = makeSchemaNodeId(schemaName, relativeSourceFile);
+            if (!schemas.includes(nodeId)) {
+                schemas.push(nodeId);
+                nodes.push({
+                    id: nodeId,
+                    label: schemaName,
+                    kind: 'api-schema',
+                    source_file: relativeSourceFile,
+                    confidence: 'EXTRACTED',
+                    metadata: { sourceType: 'swagger-definition' },
+                });
+            }
+        }
+    }
+    // 解析 paths → api 节点
+    if (isObj(doc.paths)) {
+        for (const [pathStr, pathItem] of Object.entries(doc.paths)) {
+            if (!isObj(pathItem))
+                continue;
+            for (const method of HTTP_METHODS) {
+                const operation = pathItem[method];
+                if (!isObj(operation))
+                    continue;
+                const nodeId = makeApiNodeId(method, pathStr, relativeSourceFile);
+                const label = `${method.toUpperCase()} ${pathStr}`;
+                nodes.push({
+                    id: nodeId,
+                    label,
+                    kind: 'api',
+                    source_file: relativeSourceFile,
+                    confidence: 'EXTRACTED',
+                    metadata: {
+                        method: method.toUpperCase(),
+                        path: pathStr,
+                        summary: typeof operation.summary === 'string' ? operation.summary : undefined,
+                        operationId: typeof operation.operationId === 'string' ? operation.operationId : undefined,
+                        tags: Array.isArray(operation.tags) ? operation.tags : [],
+                    },
+                });
+                // 建立 api → schema 的 uses-schema 边（扫描 $ref）
+                const refsInOperation = extractRefs(operation);
+                for (const ref of refsInOperation) {
+                    const schemaName = ref.split('/').pop();
+                    if (schemaName) {
+                        const schemaId = makeSchemaNodeId(schemaName, relativeSourceFile);
+                        if (schemas.includes(schemaId)) {
+                            edges.push({
+                                source: nodeId,
+                                target: schemaId,
+                                relation: 'uses-schema',
+                                confidence: 'EXTRACTED',
+                                weight: 1.0,
+                            });
+                        }
+                    }
+                }
+            }
+        }
+    }
+    // schema defines 边：来源 api-schema 节点 → 目标（当前版本仅记录节点，不生成 schema-to-schema 边）
+    return { nodes, edges };
+}
+/** 递归提取对象中的所有 $ref 字符串 */
+function extractRefs(obj, found = new Set(), depth = 0) {
+    if (depth > REF_MAX_DEPTH || !isObj(obj))
+        return found;
+    if (typeof obj.$ref === 'string') {
+        found.add(obj.$ref);
+        return found;
+    }
+    for (const val of Object.values(obj)) {
+        if (isObj(val))
+            extractRefs(val, found, depth + 1);
+    }
+    return found;
+}
+// ============================================================
+// AsyncAPI 解析
+// ============================================================
+/**
+ * 解析 AsyncAPI 2.x 文档，channels → event 节点
+ */
+function parseAsyncApiDoc(doc, relativeSourceFile) {
+    const nodes = [];
+    const edges = [];
+    if (!isObj(doc) || !isObj(doc.channels))
+        return { nodes, edges };
+    // 创建 service 节点（代表该文件本身）
+    const serviceNodeId = `service:${relativeSourceFile}`;
+    const serviceLabel = relativeSourceFile.split('/').pop()?.replace(/\.[^.]+$/, '') ?? relativeSourceFile;
+    nodes.push({
+        id: serviceNodeId,
+        label: serviceLabel,
+        kind: 'service',
+        source_file: relativeSourceFile,
+        confidence: 'EXTRACTED',
+        metadata: { sourceTarget: relativeSourceFile },
+    });
+    for (const [channelName, channelItem] of Object.entries(doc.channels)) {
+        if (!isObj(channelItem))
+            continue;
+        const nodeId = makeEventNodeId(channelName, relativeSourceFile);
+        nodes.push({
+            id: nodeId,
+            label: channelName,
+            kind: 'event',
+            source_file: relativeSourceFile,
+            confidence: 'EXTRACTED',
+            metadata: {
+                channelName,
+                hasPublish: isObj(channelItem.publish),
+                hasSubscribe: isObj(channelItem.subscribe),
+            },
+        });
+        // publish → publishes 边（service 节点已存在，不会悬空）
+        if (isObj(channelItem.publish)) {
+            edges.push({
+                source: serviceNodeId,
+                target: nodeId,
+                relation: 'publishes',
+                confidence: 'EXTRACTED',
+                weight: 1.0,
+            });
+        }
+        // subscribe → subscribes 边
+        if (isObj(channelItem.subscribe)) {
+            edges.push({
+                source: serviceNodeId,
+                target: nodeId,
+                relation: 'subscribes',
+                confidence: 'EXTRACTED',
+                weight: 1.0,
+            });
+        }
+    }
+    return { nodes, edges };
+}
+// ============================================================
+// 判断是否为 AsyncAPI 文档
+// ============================================================
+function isAsyncApiDoc(doc) {
+    return isObj(doc) && typeof doc.asyncapi === 'string';
+}
+// ============================================================
+// 公开 API
+// ============================================================
+/**
+ * 从单个 OpenAPI/AsyncAPI 文件提取节点和边
+ *
+ * @param filePath - 文件绝对路径
+ * @param projectRoot - 项目根目录（用于计算相对路径）
+ * @returns ExtractionResult（降级时返回 EMPTY_EXTRACTION_RESULT）
+ */
+export function extractOpenApi(filePath, projectRoot) {
+    if (!fs.existsSync(filePath)) {
+        logger.debug(`OpenAPI 文件不存在，跳过: ${filePath}`);
+        return EMPTY_EXTRACTION_RESULT;
+    }
+    let content;
+    try {
+        content = fs.readFileSync(filePath, 'utf-8');
+    }
+    catch (err) {
+        logger.warn(`读取 OpenAPI 文件失败: ${filePath} — ${String(err)}`);
+        return EMPTY_EXTRACTION_RESULT;
+    }
+    // 解析 JSON 或 YAML
+    const ext = path.extname(filePath).toLowerCase();
+    let doc;
+    if (ext === '.json') {
+        try {
+            doc = JSON.parse(content);
+        }
+        catch (err) {
+            logger.warn(`JSON 解析失败，跳过: ${filePath} — ${String(err)}`);
+            return EMPTY_EXTRACTION_RESULT;
+        }
+    }
+    else if (ext === '.yaml' || ext === '.yml') {
+        try {
+            doc = parseSimpleYaml(content);
+        }
+        catch (err) {
+            logger.warn(`YAML 解析失败，跳过: ${filePath} — ${String(err)}`);
+            return EMPTY_EXTRACTION_RESULT;
+        }
+    }
+    else {
+        logger.debug(`不支持的文件格式，跳过: ${filePath}`);
+        return EMPTY_EXTRACTION_RESULT;
+    }
+    if (!isObj(doc)) {
+        logger.warn(`文件内容无效（非对象），跳过: ${filePath}`);
+        return EMPTY_EXTRACTION_RESULT;
+    }
+    // 计算相对路径（用于节点 ID）
+    const relativeSourceFile = path.relative(projectRoot, filePath).replace(/\\/g, '/');
+    try {
+        // AsyncAPI 文档单独处理
+        if (isAsyncApiDoc(doc)) {
+            const { nodes, edges } = parseAsyncApiDoc(doc, relativeSourceFile);
+            if (nodes.length === 0 && edges.length === 0) {
+                return EMPTY_EXTRACTION_RESULT;
+            }
+            return { nodes, edges };
+        }
+        // OpenAPI 文档处理
+        const { nodes, edges } = parseOpenApiDoc(doc, relativeSourceFile);
+        if (nodes.length === 0 && edges.length === 0) {
+            return EMPTY_EXTRACTION_RESULT;
+        }
+        return { nodes, edges };
+    }
+    catch (err) {
+        logger.warn(`OpenAPI 解析失败，跳过: ${filePath} — ${String(err)}`);
+        return EMPTY_EXTRACTION_RESULT;
+    }
+}
+//# sourceMappingURL=openapi-extractor.js.map

package/dist/extraction/openapi-extractor.js.map

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

package/dist/generator/frontmatter.d.ts

@@ -0,0 +1,58 @@
+import type { CostBreakdown, SpecFrontmatter, TokenUsage } from '../models/module-spec.js';
+/**
+ * 从 package.json 动态读取 Spectra 版本号，返回 "spectra vX.Y.Z" 格式字符串。
+ * 读取失败时返回 "spectra (unknown version)" 并打印警告，避免硬编码版本字符串。
+ * 结果在模块生命周期内缓存，多次调用不重复 I/O。
+ */
+export declare function getSpectraVersionString(): string;
+export interface FrontmatterInput {
+    /** 源目标路径 */
+    sourceTarget: string;
+    /** 人类可读的模块显示名（默认取目录名） */
+    displayName?: string;
+    /** 相关文件路径列表 */
+    relatedFiles: string[];
+    /** 置信度等级 */
+    confidence: 'high' | 'medium' | 'low';
+    /** baseline CodeSkeleton 的 SHA-256 哈希 */
+    skeletonHash: string;
+    /** 已有版本号（如 'v3'），用于自动递增 */
+    existingVersion?: string;
+    /** 模块主要编程语言（多语言项目时设置） */
+    language?: string;
+    /** 跨语言引用（如 ['go:services/auth', 'python:scripts/deploy']） */
+    crossLanguageRefs?: string[];
+    /** 本次生成消耗的 token 使用量（Feature 127） */
+    tokenUsage?: TokenUsage;
+    /** LLM + enrichment 总耗时（毫秒）（Feature 127） */
+    durationMs?: number;
+    /** 实际使用的 LLM 模型 ID（Feature 127） */
+    llmModel?: string;
+    /** 降级原因（Feature 127）；未降级时为 null，未知时不传 */
+    fallbackReason?: string | null;
+    /** spec 身份类型（Feature 128，canonical / derived / bundle_copy） */
+    sourceKind?: 'canonical' | 'derived' | 'bundle_copy';
+    /** 派生来源 spec 的 outputPath（Feature 128）；canonical 时为 null 或 undefined */
+    derivedFrom?: string | null;
+    /** 生成本 spec 时的批处理模式（Bug 142）；单文件 generate 不传，batch 流程传入 effectiveMode */
+    generatedByMode?: 'full' | 'reading' | 'code-only';
+    /**
+     * Feature 140 FR-012 — context 来源 input token 细分。
+     * 由 single-spec-orchestrator 从 `AssembledContext.tokenBreakdown` + LLM response usage
+     * 组装传入；AST-only / 失败模式不传。
+     */
+    costBreakdown?: CostBreakdown;
+    /**
+     * Feature 140 FR-012 — context 是否因 budget 被裁剪。
+     * 由 single-spec-orchestrator 从 `AssembledContext.truncated` 透传。
+     */
+    contextTruncated?: boolean;
+}
+/**
+ * 生成 YAML Frontmatter 数据
+ *
+ * @param data - Frontmatter 输入
+ * @returns SpecFrontmatter
+ */
+export declare function generateFrontmatter(data: FrontmatterInput): SpecFrontmatter;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/generator/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/generator/frontmatter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAK3F;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAahD;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY;IACZ,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,qCAAqC;IACrC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;IACrD,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;IACnD;;;;OAIG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAcD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CA2D3E"}

package/dist/generator/frontmatter.js

@@ -0,0 +1,100 @@
+/**
+ * YAML Frontmatter 生成器（含版本自增）
+ * 参见 contracts/generator.md
+ */
+import { createRequire } from 'node:module';
+/** 模块级缓存，避免每次生成 frontmatter 都重复读取 package.json */
+let _versionCache;
+/**
+ * 从 package.json 动态读取 Spectra 版本号，返回 "spectra vX.Y.Z" 格式字符串。
+ * 读取失败时返回 "spectra (unknown version)" 并打印警告，避免硬编码版本字符串。
+ * 结果在模块生命周期内缓存，多次调用不重复 I/O。
+ */
+export function getSpectraVersionString() {
+    if (_versionCache !== undefined) {
+        return _versionCache;
+    }
+    try {
+        const _require = createRequire(import.meta.url);
+        const pkg = _require('../../package.json');
+        _versionCache = `spectra v${pkg.version}`;
+    }
+    catch {
+        process.stderr.write('[warn] frontmatter: 读取 package.json 版本失败，降级为 unknown version\n');
+        _versionCache = 'spectra (unknown version)';
+    }
+    return _versionCache;
+}
+/**
+ * 版本号自增
+ * v1 → v2, v3 → v4
+ * 新规格无已有版本时返回 v1
+ */
+function incrementVersion(existing) {
+    if (!existing)
+        return 'v1';
+    const match = /^v(\d+)$/.exec(existing);
+    if (!match)
+        return 'v1';
+    return `v${parseInt(match[1], 10) + 1}`;
+}
+/**
+ * 生成 YAML Frontmatter 数据
+ *
+ * @param data - Frontmatter 输入
+ * @returns SpecFrontmatter
+ */
+export function generateFrontmatter(data) {
+    const frontmatter = {
+        type: 'module-spec',
+        version: incrementVersion(data.existingVersion),
+        generatedBy: getSpectraVersionString(),
+        sourceTarget: data.sourceTarget,
+        relatedFiles: data.relatedFiles,
+        lastUpdated: new Date().toISOString(),
+        confidence: data.confidence,
+        skeletonHash: data.skeletonHash,
+    };
+    // displayName（人类可读标题）
+    if (data.displayName) {
+        frontmatter.displayName = data.displayName;
+    }
+    // 多语言项目扩展字段（仅设置时填充）
+    if (data.language) {
+        frontmatter.language = data.language;
+    }
+    if (data.crossLanguageRefs && data.crossLanguageRefs.length > 0) {
+        frontmatter.crossLanguageRefs = data.crossLanguageRefs;
+    }
+    // 成本元数据（Feature 127）— 4 个字段作为一组写入
+    // 只要 tokenUsage 传入就把全组写入，包括 output=0 / durationMs=0 / llmModel='' 等 AST-only 情形
+    if (data.tokenUsage) {
+        frontmatter.tokenUsage = data.tokenUsage;
+        frontmatter.durationMs = typeof data.durationMs === 'number' ? data.durationMs : 0;
+        frontmatter.llmModel = typeof data.llmModel === 'string' ? data.llmModel : '';
+        frontmatter.fallbackReason =
+            data.fallbackReason === undefined ? null : data.fallbackReason;
+    }
+    // spec 身份字段（Feature 128，bundle_copy / derived 时由调用方注入）
+    if (data.sourceKind !== undefined) {
+        frontmatter.sourceKind = data.sourceKind;
+    }
+    if (data.derivedFrom !== undefined) {
+        frontmatter.derivedFrom = data.derivedFrom;
+    }
+    // 批处理模式标记（Bug 142）；仅 batch 流程传入，单文件 generate 不写入
+    if (data.generatedByMode !== undefined) {
+        frontmatter.generatedByMode = data.generatedByMode;
+    }
+    // Feature 140 FR-012：context 来源 input token 细分 + 是否被 budget 裁剪
+    // 仅 single-spec-orchestrator 主流程传入；AST-only 模式 / 早期失败路径不写入此字段
+    // （下游聚合 Top N 时遇缺失字段视为未观测，跳过）。
+    if (data.costBreakdown !== undefined) {
+        frontmatter.costBreakdown = data.costBreakdown;
+    }
+    if (data.contextTruncated !== undefined) {
+        frontmatter.contextTruncated = data.contextTruncated;
+    }
+    return frontmatter;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/generator/frontmatter.js.map

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

package/dist/generator/index-generator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 架构索引生成器
+ * 生成 specs/_index.spec.md（FR-013）
+ * 支持多语言项目的语言分布展示（Feature 031）
+ * 参见 contracts/generator.md
+ */
+import type { ArchitectureIndex } from '../models/module-spec.js';
+import type { SpecFrontmatter, SpecSections } from '../models/module-spec.js';
+import type { DependencyGraph } from '../models/dependency-graph.js';
+import type { LanguageFileStat } from '../utils/file-scanner.js';
+export interface IndexableModuleSpec {
+    frontmatter: SpecFrontmatter;
+    outputPath: string;
+    sections?: Pick<SpecSections, 'intent'>;
+    intentSummary?: string;
+}
+/**
+ * 生成项目级架构索引
+ *
+ * @param specs - 所有已生成的 ModuleSpec
+ * @param graph - 项目 DependencyGraph（或合并后的图）
+ * @param languageStats - 完整扫描的语言统计（可选）
+ * @param processedLanguages - 本次实际处理的语言列表（可选）
+ * @returns ArchitectureIndex
+ */
+export declare function generateIndex(specs: IndexableModuleSpec[], graph: DependencyGraph, languageStats?: Map<string, LanguageFileStat>, processedLanguages?: string[]): ArchitectureIndex;
+//# sourceMappingURL=index-generator.d.ts.map