spectra-cli 4.1.1

package/dist/core/tree-sitter-fallback.js

@@ -0,0 +1,423 @@
+/**
+ * tree-sitter 容错降级（三级降级链）
+ *
+ * 降级链: ts-morph → tree-sitter → regex
+ *
+ * 当 ts-morph 解析失败时:
+ * 1. 优先使用 TreeSitterAnalyzer 进行真正的 tree-sitter AST 解析
+ * 2. 若 tree-sitter 也失败（如 WASM 加载错误），降级到正则提取
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { createHash } from 'node:crypto';
+import { TreeSitterAnalyzer } from './tree-sitter-analyzer.js';
+// ════════════════════════ 正则降级（最终兜底） ════════════════════════
+/**
+ * 基于正则的简易导出提取（最终降级模式）
+ * 当 tree-sitter 也无法使用时，使用正则提取基本结构
+ */
+function extractExportsFromText(content) {
+    const exports = [];
+    const lines = content.split('\n');
+    const seen = new Set();
+    const exportPatterns = [
+        /^export\s+(?:async\s+)?function\s+(\w+)/,
+        /^export\s+(?:abstract\s+)?class\s+(\w+)/,
+        /^export\s+interface\s+(\w+)/,
+        /^export\s+type\s+(\w+)/,
+        /^export\s+enum\s+(\w+)/,
+        /^export\s+(?:const|let|var)\s+(\w+)/,
+        /^export\s+default\s+(?:async\s+)?(?:function|class)\s+(\w+)/,
+    ];
+    const kindMap = {
+        function: 'function',
+        class: 'class',
+        interface: 'interface',
+        type: 'type',
+        enum: 'enum',
+        const: 'const',
+        let: 'variable',
+        var: 'variable',
+    };
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        for (const pattern of exportPatterns) {
+            const match = pattern.exec(line);
+            if (match?.[1] && !seen.has(match[1])) {
+                seen.add(match[1]);
+                let kind = 'variable';
+                for (const [keyword, k] of Object.entries(kindMap)) {
+                    if (line.includes(keyword)) {
+                        kind = k;
+                        break;
+                    }
+                }
+                exports.push({
+                    name: match[1],
+                    kind,
+                    signature: `[SYNTAX ERROR] ${line.slice(0, 200)}`,
+                    jsDoc: null,
+                    isDefault: line.includes('default'),
+                    startLine: i + 1,
+                    endLine: i + 1,
+                });
+                break;
+            }
+        }
+    }
+    return exports;
+}
+/**
+ * 基于正则的简易导入提取
+ */
+function extractImportsFromText(content) {
+    const imports = [];
+    const importRe = /import\s+(?:type\s+)?(?:({[^}]+})\s+from\s+|(\w+)\s+from\s+|(\w+),\s*({[^}]+})\s+from\s+)?['"]([^'"]+)['"]/g;
+    let match;
+    while ((match = importRe.exec(content)) !== null) {
+        const moduleSpecifier = match[5];
+        const isRelative = moduleSpecifier.startsWith('.') || moduleSpecifier.startsWith('/');
+        const isTypeOnly = match[0].includes('import type');
+        const namedImportsStr = match[1] ?? match[4];
+        const namedImports = namedImportsStr
+            ? namedImportsStr
+                .replace(/[{}]/g, '')
+                .split(',')
+                .map((s) => s.trim().split(/\s+as\s+/)[0])
+                .filter(Boolean)
+            : undefined;
+        const defaultImport = match[2] ?? match[3] ?? null;
+        imports.push({
+            moduleSpecifier,
+            isRelative,
+            resolvedPath: null,
+            namedImports: namedImports && namedImports.length > 0 ? namedImports : undefined,
+            defaultImport,
+            isTypeOnly,
+        });
+    }
+    return imports;
+}
+// ════════════════════════ Python 正则降级 ════════════════════════
+/**
+ * 基于正则的 Python 导出提取
+ * 识别顶层 def、async def、class 定义
+ */
+function extractPythonExportsFromText(content) {
+    const exports = [];
+    const lines = content.split('\n');
+    const seen = new Set();
+    const patterns = [
+        { re: /^(?:async\s+)?def\s+(\w+)\s*\(/, kind: 'function' },
+        { re: /^class\s+(\w+)/, kind: 'class' },
+    ];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // 仅匹配顶层定义（无缩进）
+        if (line.startsWith(' ') || line.startsWith('\t'))
+            continue;
+        for (const { re, kind } of patterns) {
+            const match = re.exec(line);
+            if (match?.[1] && !seen.has(match[1]) && !match[1].startsWith('_')) {
+                seen.add(match[1]);
+                const isAsync = line.trimStart().startsWith('async');
+                exports.push({
+                    name: match[1],
+                    kind,
+                    signature: `[REGEX] ${isAsync ? 'async ' : ''}${line.trim().slice(0, 200)}`,
+                    jsDoc: null,
+                    isDefault: false,
+                    startLine: i + 1,
+                    endLine: i + 1,
+                });
+                break;
+            }
+        }
+    }
+    return exports;
+}
+/**
+ * 基于正则的 Python 导入提取
+ * 识别 import 和 from...import 语句
+ */
+function extractPythonImportsFromText(content) {
+    const imports = [];
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // from <module> import <names>
+        const fromMatch = /^from\s+(\S+)\s+import\s+(.+)$/.exec(trimmed);
+        if (fromMatch) {
+            const mod = fromMatch[1];
+            const namesStr = fromMatch[2].split('#')[0].trim(); // 去掉行内注释
+            const namedImports = namesStr.split(',').map((s) => s.trim().split(/\s+as\s+/)[0]).filter(Boolean);
+            imports.push({
+                moduleSpecifier: mod,
+                isRelative: mod.startsWith('.'),
+                resolvedPath: null,
+                namedImports: namedImports.length > 0 ? namedImports : undefined,
+                isTypeOnly: false,
+            });
+            continue;
+        }
+        // import <module>
+        const importMatch = /^import\s+(\S+)/.exec(trimmed);
+        if (importMatch) {
+            const mod = importMatch[1].replace(/,\s*$/, '');
+            imports.push({
+                moduleSpecifier: mod,
+                isRelative: false,
+                resolvedPath: null,
+                isTypeOnly: false,
+            });
+        }
+    }
+    return imports;
+}
+// ════════════════════════ Go 正则降级 ════════════════════════
+/**
+ * 基于正则的 Go 导出提取
+ * 识别顶层 func、type（struct/interface）、const、var 定义
+ * Go 的可见性规则：首字母大写 = 导出
+ */
+function extractGoExportsFromText(content) {
+    const exports = [];
+    const lines = content.split('\n');
+    const seen = new Set();
+    const patterns = [
+        { re: /^func\s+(\w+)\s*\(/, kind: 'function' },
+        { re: /^func\s+\([^)]+\)\s+(\w+)\s*\(/, kind: 'function' }, // method
+        { re: /^type\s+(\w+)\s+struct\b/, kind: 'struct' },
+        { re: /^type\s+(\w+)\s+interface\b/, kind: 'interface' },
+        { re: /^type\s+(\w+)\s+/, kind: 'type' },
+        { re: /^const\s+(\w+)/, kind: 'const' },
+        { re: /^var\s+(\w+)/, kind: 'variable' },
+    ];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // 仅匹配顶层定义（无缩进）
+        if (line.startsWith(' ') || line.startsWith('\t'))
+            continue;
+        for (const { re, kind } of patterns) {
+            const match = re.exec(line);
+            // Go: 首字母大写 = 导出
+            if (match?.[1] && !seen.has(match[1]) && /^[A-Z]/.test(match[1])) {
+                seen.add(match[1]);
+                exports.push({
+                    name: match[1],
+                    kind,
+                    signature: `[REGEX] ${line.trim().slice(0, 200)}`,
+                    jsDoc: null,
+                    isDefault: false,
+                    startLine: i + 1,
+                    endLine: i + 1,
+                });
+                break;
+            }
+        }
+    }
+    return exports;
+}
+/**
+ * 基于正则的 Go 导入提取
+ * 识别单行 import 和分组 import
+ */
+function extractGoImportsFromText(content) {
+    const imports = [];
+    // 分组 import: import ( "pkg1" \n "pkg2" )
+    const groupRe = /import\s*\(([\s\S]*?)\)/g;
+    let groupMatch;
+    while ((groupMatch = groupRe.exec(content)) !== null) {
+        const block = groupMatch[1];
+        const lineRe = /^\s*(?:\w+\s+)?"([^"]+)"/gm;
+        let lineMatch;
+        while ((lineMatch = lineRe.exec(block)) !== null) {
+            imports.push({
+                moduleSpecifier: lineMatch[1],
+                isRelative: false,
+                resolvedPath: null,
+                isTypeOnly: false,
+            });
+        }
+    }
+    // 单行 import: import "pkg"
+    const singleRe = /^import\s+(?:\w+\s+)?"([^"]+)"/gm;
+    let singleMatch;
+    while ((singleMatch = singleRe.exec(content)) !== null) {
+        // 避免重复（如果已在分组中匹配）
+        if (!imports.some((i) => i.moduleSpecifier === singleMatch[1])) {
+            imports.push({
+                moduleSpecifier: singleMatch[1],
+                isRelative: false,
+                resolvedPath: null,
+                isTypeOnly: false,
+            });
+        }
+    }
+    return imports;
+}
+// ════════════════════════ Java 正则降级 ════════════════════════
+/**
+ * 基于正则的 Java 导出提取
+ * 识别顶层 public class、interface、enum 定义
+ */
+function extractJavaExportsFromText(content) {
+    const exports = [];
+    const lines = content.split('\n');
+    const seen = new Set();
+    const patterns = [
+        { re: /^public\s+(?:abstract\s+)?class\s+(\w+)/, kind: 'class' },
+        { re: /^public\s+interface\s+(\w+)/, kind: 'interface' },
+        { re: /^public\s+enum\s+(\w+)/, kind: 'enum' },
+        { re: /^public\s+(?:final\s+)?class\s+(\w+)/, kind: 'class' },
+    ];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        for (const { re, kind } of patterns) {
+            const match = re.exec(line);
+            if (match?.[1] && !seen.has(match[1])) {
+                seen.add(match[1]);
+                exports.push({
+                    name: match[1],
+                    kind,
+                    signature: `[REGEX] ${line.slice(0, 200)}`,
+                    jsDoc: null,
+                    isDefault: false,
+                    startLine: i + 1,
+                    endLine: i + 1,
+                });
+                break;
+            }
+        }
+    }
+    return exports;
+}
+/**
+ * 基于正则的 Java 导入提取
+ * 识别 import 和 import static 语句
+ */
+function extractJavaImportsFromText(content) {
+    const imports = [];
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // import static java.util.Collections.sort;
+        const staticMatch = /^import\s+static\s+([\w.]+(?:\.\*)?)\s*;/.exec(trimmed);
+        if (staticMatch) {
+            imports.push({
+                moduleSpecifier: staticMatch[1],
+                isRelative: false,
+                resolvedPath: null,
+                isTypeOnly: false,
+            });
+            continue;
+        }
+        // import java.util.List;
+        // import java.util.*;
+        const importMatch = /^import\s+([\w.]+(?:\.\*)?)\s*;/.exec(trimmed);
+        if (importMatch) {
+            imports.push({
+                moduleSpecifier: importMatch[1],
+                isRelative: false,
+                resolvedPath: null,
+                isTypeOnly: false,
+            });
+        }
+    }
+    return imports;
+}
+// ════════════════════════ 语言检测 ════════════════════════
+/**
+ * 从文件扩展名检测语言（扩展支持多语言）
+ */
+function getLanguage(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    const langMap = {
+        '.ts': 'typescript',
+        '.tsx': 'typescript',
+        '.js': 'javascript',
+        '.jsx': 'javascript',
+        '.py': 'python',
+        '.pyi': 'python',
+        '.go': 'go',
+        '.java': 'java',
+    };
+    return langMap[ext] ?? 'javascript';
+}
+// ════════════════════════ 降级入口 ════════════════════════
+/**
+ * 容错解析文件（三级降级链）
+ *
+ * 1. 尝试 TreeSitterAnalyzer 真正的 AST 解析
+ * 2. tree-sitter 失败时降级到正则提取
+ *
+ * 函数签名保持与重写前完全一致，不影响调用方。
+ *
+ * @param filePath - 文件路径
+ * @returns CodeSkeleton，parserUsed 为 'tree-sitter'（AST）或 'tree-sitter'（正则降级亦标记为 tree-sitter，保持兼容）
+ */
+export async function analyzeFallback(filePath) {
+    const language = getLanguage(filePath);
+    // 第一级降级：尝试 tree-sitter AST 解析
+    try {
+        const analyzer = TreeSitterAnalyzer.getInstance();
+        if (analyzer.isLanguageSupported(language)) {
+            return await analyzer.analyze(filePath, language);
+        }
+    }
+    catch {
+        // tree-sitter 解析失败，继续降级到正则
+    }
+    // 第二级降级：正则提取（最终兜底）
+    return regexFallback(filePath, language);
+}
+/**
+ * 正则降级分析（内部方法，可用于测试对比）
+ */
+function regexFallback(filePath, language) {
+    let content;
+    try {
+        content = fs.readFileSync(filePath, 'utf-8');
+    }
+    catch (error) {
+        throw new Error(`无法读取文件: ${filePath} — ${error.message}`);
+    }
+    const hash = createHash('sha256').update(content).digest('hex');
+    const lines = content.split('\n');
+    const loc = lines.length;
+    // 根据语言选择对应的正则提取器
+    const exports = language === 'python'
+        ? extractPythonExportsFromText(content)
+        : language === 'go'
+            ? extractGoExportsFromText(content)
+            : language === 'java'
+                ? extractJavaExportsFromText(content)
+                : extractExportsFromText(content);
+    const imports = language === 'python'
+        ? extractPythonImportsFromText(content)
+        : language === 'go'
+            ? extractGoImportsFromText(content)
+            : language === 'java'
+                ? extractJavaImportsFromText(content)
+                : extractImportsFromText(content);
+    const parseErrors = [
+        {
+            line: 1,
+            column: 0,
+            message: 'ts-morph 解析失败，已降级至正则模式提取',
+            affectedSymbols: exports.map((e) => e.name),
+        },
+    ];
+    return {
+        filePath,
+        language,
+        loc,
+        exports,
+        imports,
+        parseErrors,
+        hash,
+        analyzedAt: new Date().toISOString(),
+        parserUsed: 'tree-sitter',
+    };
+}
+//# sourceMappingURL=tree-sitter-fallback.js.map

package/dist/core/tree-sitter-fallback.js.map

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

package/dist/debt-scanner/aggregator/quality-report-patcher.d.ts

@@ -0,0 +1,22 @@
+import type { DebtMetrics } from '../types.js';
+export interface PatchQualityReportOptions {
+    qualityReportPath: string;
+    metrics: DebtMetrics;
+    /** technical-debt.md 的相对路径（通常同目录下的 "technical-debt.md"） */
+    technicalDebtRelPath?: string;
+}
+/**
+ * 对 quality-report.md 追加或替换 "## 技术债" 节。
+ * 返回 true 表示做了改动，false 表示跳过。
+ */
+export declare function patchQualityReportWithDebt(opts: PatchQualityReportOptions): boolean;
+/**
+ * 生成 "## 技术债" 节 Markdown（不含首尾空行控制）。
+ */
+export declare function renderDebtSection(metrics: DebtMetrics, technicalDebtRelPath: string): string;
+/**
+ * 辅助：根据 specsDir 推断 quality-report.md 的常见路径。
+ * 文件不存在时也返回该路径，由 patcher 自行 skip。
+ */
+export declare function findQualityReportPath(specsDir: string): string;
+//# sourceMappingURL=quality-report-patcher.d.ts.map

package/dist/debt-scanner/aggregator/quality-report-patcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-report-patcher.d.ts","sourceRoot":"","sources":["../../../src/debt-scanner/aggregator/quality-report-patcher.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAY,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,WAAW,yBAAyB;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,WAAW,CAAC;IACrB,2DAA2D;IAC3D,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CA+BnF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,GAAG,MAAM,CAe5F;AAmCD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/dist/debt-scanner/aggregator/quality-report-patcher.js

@@ -0,0 +1,107 @@
+/**
+ * quality-report.md 追加 "## 技术债" 节
+ *
+ * AC-4.1 / AC-4.3：
+ * - 若 quality-report.md 不存在 → 跳过，不报错
+ * - 若 technical-debt.md 未生成（metrics 为空）→ 跳过
+ * - 若节已存在 → 替换内容（幂等）
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * 对 quality-report.md 追加或替换 "## 技术债" 节。
+ * 返回 true 表示做了改动，false 表示跳过。
+ */
+export function patchQualityReportWithDebt(opts) {
+    if (!fs.existsSync(opts.qualityReportPath))
+        return false;
+    const section = renderDebtSection(opts.metrics, opts.technicalDebtRelPath ?? 'technical-debt.md');
+    const original = fs.readFileSync(opts.qualityReportPath, 'utf-8');
+    const existing = findExistingSection(original);
+    let next;
+    if (existing) {
+        next =
+            original.slice(0, existing.start) +
+                section +
+                original.slice(existing.end);
+    }
+    else {
+        // AC-4.1 / plan §3.4：优先插入到 "## Required Docs" 节末尾；
+        // 找不到锚点时退化到文件末尾追加（向后兼容模板漂移）。
+        const anchor = findRequiredDocsInsertionPoint(original);
+        if (anchor != null) {
+            const before = original.slice(0, anchor);
+            const after = original.slice(anchor);
+            const leadingNewline = before.endsWith('\n\n') ? '' : before.endsWith('\n') ? '\n' : '\n\n';
+            next = before + leadingNewline + section + (after.startsWith('\n') ? '' : '\n') + after;
+        }
+        else {
+            const sep = original.endsWith('\n') ? '' : '\n';
+            next = original + sep + '\n' + section;
+        }
+    }
+    if (next === original)
+        return false;
+    fs.writeFileSync(opts.qualityReportPath, next, 'utf-8');
+    return true;
+}
+/**
+ * 生成 "## 技术债" 节 Markdown（不含首尾空行控制）。
+ */
+export function renderDebtSection(metrics, technicalDebtRelPath) {
+    const kindLine = Object.keys(metrics.byKind)
+        .map((k) => `${k} ${metrics.byKind[k]}`)
+        .join(' / ');
+    return [
+        '## 技术债',
+        '',
+        `- 总条目数：${metrics.totalEntries}`,
+        `- 按 kind：${kindLine}`,
+        `- 代码债务密度：${metrics.densityPerKloc.toFixed(2)} 条/kLOC`,
+        `- 最老条目：${metrics.oldestAgeDays} 天`,
+        '',
+        `详情见 [technical-debt.md](${technicalDebtRelPath})。`,
+        '',
+    ].join('\n');
+}
+/**
+ * 若存在 "## 技术债" 节，返回其 [start, end)；无则 null。
+ * 结束位置为下一个同级或更高级 heading 行首，或文件末尾。
+ */
+function findExistingSection(text) {
+    const re = /^##\s+技术债\s*$/m;
+    const m = re.exec(text);
+    if (!m)
+        return null;
+    const start = m.index;
+    // 从 start 之后查找下一个 ^#{1,2}\s
+    const afterStart = start + m[0].length;
+    const nextRe = /^#{1,2}\s+\S/gm;
+    nextRe.lastIndex = afterStart;
+    const next = nextRe.exec(text);
+    const end = next ? next.index : text.length;
+    return { start, end };
+}
+/**
+ * 找到 "## Required Docs" 节结束位置（下一个同级 heading 前、或文件末尾）。
+ * 返回可插入位置（字符偏移）；没有该节时返回 null。
+ */
+function findRequiredDocsInsertionPoint(text) {
+    const re = /^##\s+Required Docs\s*$/m;
+    const m = re.exec(text);
+    if (!m)
+        return null;
+    const afterHeading = m.index + m[0].length;
+    const nextRe = /^#{1,2}\s+\S/gm;
+    nextRe.lastIndex = afterHeading;
+    const next = nextRe.exec(text);
+    return next ? next.index : text.length;
+}
+/**
+ * 辅助：根据 specsDir 推断 quality-report.md 的常见路径。
+ * 文件不存在时也返回该路径，由 patcher 自行 skip。
+ */
+export function findQualityReportPath(specsDir) {
+    return path.join(specsDir, 'project', 'quality-report.md');
+}
+//# sourceMappingURL=quality-report-patcher.js.map

package/dist/debt-scanner/aggregator/quality-report-patcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-report-patcher.js","sourceRoot":"","sources":["../../../src/debt-scanner/aggregator/quality-report-patcher.ts"],"names":[],"mappings":"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"}

package/dist/debt-scanner/aggregator/readme-indexer.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 在 specs/README.md 的 "质量审计" 节中插入技术债链接。
+ * 返回 true 表示做了改动，false 表示跳过（文件缺失 / 节缺失 / 已存在）。
+ */
+export declare function indexDebtInReadme(specsDir: string): boolean;
+//# sourceMappingURL=readme-indexer.d.ts.map

package/dist/debt-scanner/aggregator/readme-indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme-indexer.d.ts","sourceRoot":"","sources":["../../../src/debt-scanner/aggregator/readme-indexer.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAuC3D"}

package/dist/debt-scanner/aggregator/readme-indexer.js

@@ -0,0 +1,52 @@
+/**
+ * specs/README.md "质量审计" 节追加技术债链接
+ *
+ * AC-3.4：若文件存在且有 "质量审计" 节，在该节内 idempotent 插入一行。
+ * 若 README.md 不存在或没有 "质量审计" 节则跳过。
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const LINK_LINE = '- [技术债清单](project/technical-debt.md)';
+const HEADING_REGEX = /^##\s+质量审计\s*$/m;
+/**
+ * 在 specs/README.md 的 "质量审计" 节中插入技术债链接。
+ * 返回 true 表示做了改动，false 表示跳过（文件缺失 / 节缺失 / 已存在）。
+ */
+export function indexDebtInReadme(specsDir) {
+    const readmePath = path.join(specsDir, 'README.md');
+    if (!fs.existsSync(readmePath))
+        return false;
+    const text = fs.readFileSync(readmePath, 'utf-8');
+    const match = HEADING_REGEX.exec(text);
+    if (!match)
+        return false;
+    // 已存在链接时 idempotent 跳过
+    if (text.includes(LINK_LINE))
+        return false;
+    const headingEnd = match.index + match[0].length;
+    // 将 LINK_LINE 插到 "## 质量审计" 后的第一个空行之后，或直接紧跟 heading
+    const after = text.slice(headingEnd);
+    // 找到下一个 heading（同级或更高级）或文件末尾
+    const nextHeading = /^#{1,2}\s+\S/gm;
+    nextHeading.lastIndex = 0;
+    nextHeading.exec(after); // 仅为复用正则；下一步用 .lastIndex 计算
+    const nextIdx = (() => {
+        const re = /^#{1,2}\s+\S/gm;
+        re.lastIndex = 0;
+        const m2 = re.exec(after);
+        return m2 ? m2.index : after.length;
+    })();
+    const block = after.slice(0, nextIdx);
+    // 插入：保留 heading 后的原 block，但在结尾前追加 LINK_LINE
+    const trimmed = block.replace(/\s+$/, '');
+    const newBlock = trimmed + '\n' + LINK_LINE + '\n\n';
+    const next = text.slice(0, headingEnd) +
+        '\n' + // heading 与 block 之间的换行
+        newBlock.replace(/^\n/, '') +
+        text.slice(headingEnd + block.length);
+    if (next === text)
+        return false;
+    fs.writeFileSync(readmePath, next, 'utf-8');
+    return true;
+}
+//# sourceMappingURL=readme-indexer.js.map

package/dist/debt-scanner/aggregator/readme-indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme-indexer.js","sourceRoot":"","sources":["../../../src/debt-scanner/aggregator/readme-indexer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,SAAS,GAAG,sCAAsC,CAAC;AACzD,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACpD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAE7C,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,uBAAuB;IACvB,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IAE3C,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACjD,mDAAmD;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACrC,6BAA6B;IAC7B,MAAM,WAAW,GAAG,gBAAgB,CAAC;IACrC,WAAW,CAAC,SAAS,GAAG,CAAC,CAAC;IAC1B,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,4BAA4B;IACrD,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE;QACpB,MAAM,EAAE,GAAG,gBAAgB,CAAC;QAC5B,EAAE,CAAC,SAAS,GAAG,CAAC,CAAC;QACjB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IACtC,CAAC,CAAC,EAAE,CAAC;IAEL,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACtC,4CAA4C;IAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC;IAErD,MAAM,IAAI,GACR,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;QACzB,IAAI,GAAG,wBAAwB;QAC/B,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAExC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC"}