spectra-cli 4.1.1

package/dist/debt-scanner/design-docs/index.js

@@ -0,0 +1,60 @@
+/**
+ * Design-doc open question 候选检测
+ *
+ * 输出：
+ * - confirmedByRule: 显式命中，直接收录为最终 entry
+ * - llmCandidates: 仅问号命中，需要 LLM 仲裁（或降级为直接丢弃 / 保留为空 topics）
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { discoverDesignDocs } from './doc-discoverer.js';
+import { parseMarkdownSections } from './markdown-sections.js';
+import { endsWithQuestionMark, hasExplicitMarker, makeSnippet } from './rule-detector.js';
+/**
+ * 扫描 projectRoot 的 design-doc，提取 open question 候选。
+ */
+export function detectOpenQuestions(projectRoot) {
+    const absRoot = path.resolve(projectRoot);
+    const docs = discoverDesignDocs(absRoot);
+    const confirmed = [];
+    const llmCandidates = [];
+    for (const absPath of docs) {
+        let text;
+        try {
+            text = fs.readFileSync(absPath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const relPath = toPosix(path.relative(absRoot, absPath));
+        const sections = parseMarkdownSections(text);
+        for (const section of sections) {
+            for (const para of section.paragraphs) {
+                if (hasExplicitMarker(para, section.headingPath)) {
+                    confirmed.push({
+                        snippet: makeSnippet(para),
+                        docPath: relPath,
+                        headingPath: section.headingPath || '(doc root)',
+                        source: 'rule',
+                        topics: [],
+                    });
+                    continue;
+                }
+                if (endsWithQuestionMark(para)) {
+                    llmCandidates.push({
+                        absPath,
+                        docPath: relPath,
+                        headingPath: section.headingPath || '(doc root)',
+                        snippet: makeSnippet(para),
+                    });
+                }
+            }
+        }
+    }
+    return { confirmed, llmCandidates, docsScanned: docs.length };
+}
+function toPosix(p) {
+    return p.split(path.sep).join('/');
+}
+export { discoverDesignDocs, parseMarkdownSections };
+//# sourceMappingURL=index.js.map

package/dist/debt-scanner/design-docs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/debt-scanner/design-docs/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAgB,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAsB1F;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,SAAS,GAAwB,EAAE,CAAC;IAC1C,MAAM,aAAa,GAA4B,EAAE,CAAC;IAElD,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC7C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACtC,IAAI,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;oBACjD,SAAS,CAAC,IAAI,CAAC;wBACb,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC;wBAC1B,OAAO,EAAE,OAAO;wBAChB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,YAAY;wBAChD,MAAM,EAAE,MAAM;wBACd,MAAM,EAAE,EAAE;qBACX,CAAC,CAAC;oBACH,SAAS;gBACX,CAAC;gBACD,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC/B,aAAa,CAAC,IAAI,CAAC;wBACjB,OAAO;wBACP,OAAO,EAAE,OAAO;wBAChB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,YAAY;wBAChD,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC;qBAC3B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,OAAO,CAAC,CAAS;IACxB,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/debt-scanner/design-docs/llm-topic-inferrer.d.ts

@@ -0,0 +1,68 @@
+/**
+ * LLM 主题推断 + budget 集成
+ *
+ * 职责：
+ * - 接收 open question 候选（规则命中 + 问号命中）
+ * - 批量 prompt LLM 判断问号候选是否为真正的 open question + 推断 1-3 个主题
+ * - budget 超出或 dryRun 时降级（不调用 LLM，fallbackReason 标记原因）
+ *
+ * 本模块不直接依赖 src/core/llm-client.ts 的 callLLM（它以 AssembledContext 为契约），
+ * 而是引入一个轻量 SimpleLLMClient 抽象便于测试注入。
+ */
+import type { OpenQuestionEntry, TokenUsage } from '../types.js';
+import type { OpenQuestionCandidate } from './index.js';
+/**
+ * 轻量 LLM 客户端抽象。
+ * 生产实现可用 src/debt-scanner/llm-client-adapter 包装 Anthropic SDK；
+ * 测试时注入 StubLLMClient。
+ */
+export interface SimpleLLMClient {
+    /**
+     * 调用 LLM，返回原始文本 + token 使用量 + 实际模型名。
+     */
+    complete(input: SimpleLLMInput): Promise<SimpleLLMOutput>;
+    /** 估算一段文本的 token 数（用于 budget 预检） */
+    estimateTokens(text: string): number;
+    /** 提供给 UI / 报告的 model 标识 */
+    readonly model: string;
+}
+export interface SimpleLLMInput {
+    systemPrompt: string;
+    userPrompt: string;
+    maxOutputTokens: number;
+}
+export interface SimpleLLMOutput {
+    text: string;
+    inputTokens: number;
+    outputTokens: number;
+    model: string;
+}
+export interface InferTopicsOptions {
+    /** 规则命中的 confirmed 条目 */
+    confirmed: OpenQuestionEntry[];
+    /** 问号命中的候选 */
+    llmCandidates: OpenQuestionCandidate[];
+    /** LLM 客户端；为 undefined 则走 "no-llm-client" 降级 */
+    llmClient?: SimpleLLMClient;
+    /** 剩余 budget（input+output tokens 总量）；undefined 表示无限制 */
+    budgetLimit?: number;
+    /** dryRun = true 时跳过 LLM 调用 */
+    dryRun?: boolean;
+}
+export interface InferTopicsResult {
+    /** 最终的 open question 条目（规则 + LLM 判定为真的问号候选） */
+    entries: OpenQuestionEntry[];
+    /** 实际 token 用量 */
+    tokenUsage: TokenUsage;
+    /** LLM 调用次数 */
+    llmCalls: number;
+    /** 降级原因；未降级为 undefined */
+    fallbackReason?: 'budget-exhausted' | 'dry-run' | 'no-llm-client';
+    /** LLM 使用的 model 名称 */
+    llmModel?: string;
+}
+/**
+ * 批量对 llmCandidates 做 LLM 推断；confirmed 直接透传（可选：给它们也补 topic）。
+ */
+export declare function inferOpenQuestionTopics(opts: InferTopicsOptions): Promise<InferTopicsResult>;
+//# sourceMappingURL=llm-topic-inferrer.d.ts.map

package/dist/debt-scanner/design-docs/llm-topic-inferrer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-topic-inferrer.d.ts","sourceRoot":"","sources":["../../../src/debt-scanner/design-docs/llm-topic-inferrer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1D,oCAAoC;IACpC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,cAAc;IACd,aAAa,EAAE,qBAAqB,EAAE,CAAC;IACvC,gDAAgD;IAChD,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,kBAAkB;IAClB,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,cAAc,CAAC,EAAE,kBAAkB,GAAG,SAAS,GAAG,eAAe,CAAC;IAClE,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAUD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,iBAAiB,CAAC,CA6E5B"}

package/dist/debt-scanner/design-docs/llm-topic-inferrer.js

@@ -0,0 +1,151 @@
+const SYSTEM_PROMPT = [
+    'You are a classifier for software-design-document open questions.',
+    'For each candidate sentence, decide:',
+    '1. Is this an actual OPEN QUESTION (not rhetorical)?',
+    '2. If yes, return 1-3 short topic keywords (lowercase, hyphenated).',
+    'Return strict JSON only: {"results":[{"id":"c1","isOpenQuestion":true,"topics":["parser","validation"]}]}',
+].join('\n');
+/**
+ * 批量对 llmCandidates 做 LLM 推断；confirmed 直接透传（可选：给它们也补 topic）。
+ */
+export async function inferOpenQuestionTopics(opts) {
+    const tokenUsage = { input: 0, output: 0 };
+    const entries = [...opts.confirmed];
+    // 无候选 → 没必要调用 LLM
+    if (opts.llmCandidates.length === 0) {
+        return { entries, tokenUsage, llmCalls: 0 };
+    }
+    // dryRun 优先生效
+    if (opts.dryRun) {
+        return { entries, tokenUsage, llmCalls: 0, fallbackReason: 'dry-run' };
+    }
+    if (!opts.llmClient) {
+        return { entries, tokenUsage, llmCalls: 0, fallbackReason: 'no-llm-client' };
+    }
+    const userPrompt = buildUserPrompt(opts.llmCandidates);
+    const estimatedInput = opts.llmClient.estimateTokens(SYSTEM_PROMPT + '\n' + userPrompt);
+    // 预留 output 预算：每个候选 20 token 估
+    const estimatedOutput = Math.max(256, opts.llmCandidates.length * 20);
+    const totalEstimate = estimatedInput + estimatedOutput;
+    if (opts.budgetLimit != null && totalEstimate > opts.budgetLimit) {
+        return {
+            entries,
+            tokenUsage,
+            llmCalls: 0,
+            fallbackReason: 'budget-exhausted',
+            llmModel: opts.llmClient.model,
+        };
+    }
+    let output;
+    try {
+        output = await opts.llmClient.complete({
+            systemPrompt: SYSTEM_PROMPT,
+            userPrompt,
+            maxOutputTokens: Math.min(estimatedOutput * 2, 2048),
+        });
+    }
+    catch {
+        // LLM 调用失败不中断 pipeline
+        return {
+            entries,
+            tokenUsage,
+            llmCalls: 0,
+            fallbackReason: 'budget-exhausted',
+            llmModel: opts.llmClient.model,
+        };
+    }
+    tokenUsage.input += output.inputTokens;
+    tokenUsage.output += output.outputTokens;
+    const parsed = parseLLMJson(output.text);
+    for (let idx = 0; idx < opts.llmCandidates.length; idx++) {
+        const c = opts.llmCandidates[idx];
+        if (!c)
+            continue;
+        // 主键用 id（c0/c1/…，LLM 难以改写的短字符串），兼容回退到 key（docPath|snippet）
+        const found = parsed.byId.get('c' + idx) ?? parsed.byKey.get(c.docPath + '|' + c.snippet);
+        if (!found)
+            continue;
+        if (!found.isOpenQuestion)
+            continue;
+        entries.push({
+            snippet: c.snippet,
+            docPath: c.docPath,
+            headingPath: c.headingPath,
+            source: 'llm',
+            topics: found.topics.slice(0, 3),
+        });
+    }
+    return {
+        entries,
+        tokenUsage,
+        llmCalls: 1,
+        llmModel: output.model,
+    };
+}
+/**
+ * 构造 user prompt，id 用 docPath|snippet 组合以便回填
+ */
+function buildUserPrompt(candidates) {
+    const payload = candidates.map((c, idx) => ({
+        id: 'c' + idx,
+        key: c.docPath + '|' + c.snippet,
+        text: c.snippet,
+        context: c.headingPath,
+    }));
+    return [
+        'Candidates (JSON):',
+        JSON.stringify(payload),
+        '',
+        'Respond with JSON only matching the system prompt schema.',
+        'Use the "id" field to correlate each result; also echo "key" verbatim so the caller can align rows.',
+        'Schema: {"results":[{"id":"c0","key":"...","isOpenQuestion":true,"topics":["k1","k2"]}]}',
+    ].join('\n');
+}
+/** 解析 LLM JSON 响应，容错：取第一段 JSON；失败返回空索引 */
+function parseLLMJson(raw) {
+    const byId = new Map();
+    const byKey = new Map();
+    const jsonText = extractJsonBlock(raw);
+    if (!jsonText)
+        return { byId, byKey };
+    let obj;
+    try {
+        obj = JSON.parse(jsonText);
+    }
+    catch {
+        return { byId, byKey };
+    }
+    if (!obj || typeof obj !== 'object')
+        return { byId, byKey };
+    const results = obj.results;
+    if (!Array.isArray(results))
+        return { byId, byKey };
+    for (const row of results) {
+        if (!row || typeof row !== 'object')
+            continue;
+        const r = row;
+        const topics = Array.isArray(r.topics)
+            ? r.topics.filter((t) => typeof t === 'string')
+            : [];
+        const parsed = {
+            isOpenQuestion: Boolean(r.isOpenQuestion),
+            topics,
+        };
+        if (typeof r.id === 'string' && r.id.length > 0) {
+            byId.set(r.id, parsed);
+        }
+        if (typeof r.key === 'string' && r.key.length > 0) {
+            byKey.set(r.key, parsed);
+        }
+    }
+    return { byId, byKey };
+}
+/** 取第一段 {…} 或 [...] JSON，容错 markdown 围栏 */
+function extractJsonBlock(text) {
+    const fence = /```(?:json)?\s*([\s\S]*?)```/.exec(text);
+    if (fence?.[1])
+        return fence[1].trim();
+    const m = /\{[\s\S]*\}|\[[\s\S]*\]/.exec(text);
+    return m ? m[0] : null;
+}
+//# sourceMappingURL=llm-topic-inferrer.js.map

package/dist/debt-scanner/design-docs/llm-topic-inferrer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-topic-inferrer.js","sourceRoot":"","sources":["../../../src/debt-scanner/design-docs/llm-topic-inferrer.ts"],"names":[],"mappings":"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"}

package/dist/debt-scanner/design-docs/markdown-sections.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 轻量 Markdown 解析：heading tree + 段落
+ *
+ * 仅实现 debt-scanner 需要的最小功能，不依赖重型 Markdown AST 库。
+ * 规则：
+ * - `^#{1,6}\s+` 识别 heading，记录 level 与 text
+ * - 两个 heading 之间或到文件结尾为一个 section
+ * - 空行分隔段落
+ * - 忽略 fenced code block（``` ... ```）与 indented code block（行首 4+ 空格）
+ */
+export interface Section {
+    /** heading path，如 "# Design > ## Open Questions" */
+    headingPath: string;
+    /** 段落列表（已剥离首尾空白、去除 code block） */
+    paragraphs: string[];
+    /** 该 section 的起始行号（1-indexed） */
+    startLine: number;
+}
+/**
+ * 解析 markdown 文本为 sections。
+ * 如果文档没有任何 heading，则视为单个 "" section。
+ */
+export declare function parseMarkdownSections(text: string): Section[];
+//# sourceMappingURL=markdown-sections.d.ts.map

package/dist/debt-scanner/design-docs/markdown-sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-sections.d.ts","sourceRoot":"","sources":["../../../src/debt-scanner/design-docs/markdown-sections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,OAAO;IACtB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CA4D7D"}

package/dist/debt-scanner/design-docs/markdown-sections.js

@@ -0,0 +1,92 @@
+/**
+ * 轻量 Markdown 解析：heading tree + 段落
+ *
+ * 仅实现 debt-scanner 需要的最小功能，不依赖重型 Markdown AST 库。
+ * 规则：
+ * - `^#{1,6}\s+` 识别 heading，记录 level 与 text
+ * - 两个 heading 之间或到文件结尾为一个 section
+ * - 空行分隔段落
+ * - 忽略 fenced code block（``` ... ```）与 indented code block（行首 4+ 空格）
+ */
+/**
+ * 解析 markdown 文本为 sections。
+ * 如果文档没有任何 heading，则视为单个 "" section。
+ */
+export function parseMarkdownSections(text) {
+    const lines = text.split('\n');
+    const sections = [];
+    // 先标记 fenced code block 区域
+    const inFence = new Array(lines.length).fill(false);
+    let fenceOpen = false;
+    for (let i = 0; i < lines.length; i++) {
+        if (/^```/.test(lines[i])) {
+            fenceOpen = !fenceOpen;
+            inFence[i] = true; // fence 标记行本身也算 code
+            continue;
+        }
+        inFence[i] = fenceOpen;
+    }
+    const headingStack = [];
+    let current = {
+        startLine: 1,
+        buffer: [],
+        path: '',
+    };
+    const flushSection = () => {
+        const paragraphs = bufferToParagraphs(current.buffer);
+        sections.push({
+            headingPath: current.path,
+            paragraphs,
+            startLine: current.startLine,
+        });
+    };
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (inFence[i]) {
+            current.buffer.push(''); // 把 code block 行当成空行，免得它粘进段落
+            continue;
+        }
+        const m = /^(#{1,6})\s+(.+?)\s*$/.exec(line);
+        if (m) {
+            // 先保存前一个 section（只有内容非空才 push）
+            flushSection();
+            const level = m[1].length;
+            const text = m[2];
+            // 调整 headingStack
+            while (headingStack.length && headingStack[headingStack.length - 1].level >= level) {
+                headingStack.pop();
+            }
+            headingStack.push({ level, text });
+            const pathStr = headingStack
+                .map((h) => `${'#'.repeat(h.level)} ${h.text}`)
+                .join(' > ');
+            current = { startLine: i + 1, buffer: [], path: pathStr };
+            continue;
+        }
+        current.buffer.push(line);
+    }
+    flushSection();
+    return sections;
+}
+function bufferToParagraphs(lines) {
+    const paras = [];
+    let current = [];
+    for (const raw of lines) {
+        const line = raw.replace(/\r$/, '');
+        if (line.trim() === '') {
+            if (current.length) {
+                paras.push(current.join(' ').trim());
+                current = [];
+            }
+            continue;
+        }
+        // indented code block：行首 4+ 空格或 tab 开头的视为代码忽略
+        if (/^(\s{4}|\t)/.test(line) && current.length === 0)
+            continue;
+        current.push(line.trim());
+    }
+    if (current.length)
+        paras.push(current.join(' ').trim());
+    return paras.filter((p) => p.length > 0);
+}
+//# sourceMappingURL=markdown-sections.js.map

package/dist/debt-scanner/design-docs/markdown-sections.js.map

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

package/dist/debt-scanner/design-docs/rule-detector.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Design-doc open question 规则检测
+ *
+ * 两种命中路径（AC-2.2）：
+ * 1. 显式标记：段落包含 TBD、待定、open question(s)、tradeoff/trade-off 之一
+ * 2. 疑问句：段落（或 heading 下的子段落）以 `?` 或 `？` 结尾
+ *
+ * 显式命中直接进入 "rule" source；问号命中为 LLM 仲裁候选。
+ */
+/** 是否显式命中（大小写不敏感） */
+export declare function hasExplicitMarker(text: string, headingPath?: string): boolean;
+/** 是否以问号结尾（兼容英文 ? 和中文 ？） */
+export declare function endsWithQuestionMark(text: string): boolean;
+/**
+ * 限制 snippet 最大 400 字符。
+ */
+export declare function makeSnippet(text: string, max?: number): string;
+//# sourceMappingURL=rule-detector.d.ts.map

package/dist/debt-scanner/design-docs/rule-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-detector.d.ts","sourceRoot":"","sources":["../../../src/debt-scanner/design-docs/rule-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,qBAAqB;AACrB,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAU7E;AAED,4BAA4B;AAC5B,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAM,GAAG,MAAM,CAG3D"}

package/dist/debt-scanner/design-docs/rule-detector.js

@@ -0,0 +1,46 @@
+/**
+ * Design-doc open question 规则检测
+ *
+ * 两种命中路径（AC-2.2）：
+ * 1. 显式标记：段落包含 TBD、待定、open question(s)、tradeoff/trade-off 之一
+ * 2. 疑问句：段落（或 heading 下的子段落）以 `?` 或 `？` 结尾
+ *
+ * 显式命中直接进入 "rule" source；问号命中为 LLM 仲裁候选。
+ */
+const EXPLICIT_KEYWORDS = [
+    'tbd',
+    '待定',
+    'open question',
+    'open questions',
+    'tradeoff',
+    'trade-off',
+];
+/** 是否显式命中（大小写不敏感） */
+export function hasExplicitMarker(text, headingPath) {
+    const lower = text.toLowerCase();
+    if (EXPLICIT_KEYWORDS.some((k) => lower.includes(k)))
+        return true;
+    if (headingPath) {
+        const h = headingPath.toLowerCase();
+        if (/open\s*question/.test(h))
+            return true;
+        if (/trade[-\s]*off/.test(h))
+            return true;
+        if (/\btbd\b/.test(h))
+            return true;
+    }
+    return false;
+}
+/** 是否以问号结尾（兼容英文 ? 和中文 ？） */
+export function endsWithQuestionMark(text) {
+    const t = text.trimEnd();
+    return t.endsWith('?') || t.endsWith('？');
+}
+/**
+ * 限制 snippet 最大 400 字符。
+ */
+export function makeSnippet(text, max = 400) {
+    const s = text.replace(/\s+/g, ' ').trim();
+    return s.length <= max ? s : s.slice(0, max - 1) + '…';
+}
+//# sourceMappingURL=rule-detector.js.map

package/dist/debt-scanner/design-docs/rule-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-detector.js","sourceRoot":"","sources":["../../../src/debt-scanner/design-docs/rule-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,iBAAiB,GAAG;IACxB,KAAK;IACL,IAAI;IACJ,eAAe;IACf,gBAAgB;IAChB,UAAU;IACV,WAAW;CACZ,CAAC;AAEF,qBAAqB;AACrB,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,WAAoB;IAClE,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAClE,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,CAAC,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;QACpC,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3C,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;IACrC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IACzB,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,GAAG,GAAG,GAAG;IACjD,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,OAAO,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;AACzD,CAAC"}

package/dist/debt-scanner/index.d.ts

@@ -0,0 +1,43 @@
+import type { LanguageAdapterRegistry } from '../adapters/language-adapter-registry.js';
+import type { Language } from '../models/code-skeleton.js';
+import { type SimpleLLMClient } from './design-docs/llm-topic-inferrer.js';
+import type { CodeDebtEntry, DebtReport, OpenQuestionEntry } from './types.js';
+export interface ScanProjectDebtOptions {
+    projectRoot: string;
+    registry: LanguageAdapterRegistry;
+    /**
+     * 可选：语言过滤（adapter id 集合，例如 ['python']）。
+     * 传入时，只扫描这些 adapter 支持的扩展名。
+     * 用于让 debt 扫描与 batch 的 --languages 过滤保持一致，避免发布不在本次 batch 范围内的债务。
+     */
+    languages?: string[];
+    /** 可选：LLM 客户端；未提供则 open-question 主题推断降级 */
+    llmClient?: SimpleLLMClient;
+    /** 剩余 LLM budget（input+output token 总量） */
+    budgetLimit?: number;
+    /** dryRun 跳过 LLM */
+    dryRun?: boolean;
+    /** 可选：覆盖文件枚举（测试用） */
+    files?: string[];
+    /** 可选：注入 blame（测试用） */
+    blame?: (filePath: string, line: number) => Promise<{
+        author: string;
+        ageDays: number;
+    }>;
+}
+/**
+ * 扫描 projectRoot，返回完整 DebtReport。
+ */
+export declare function scanProjectDebt(opts: ScanProjectDebtOptions): Promise<DebtReport>;
+/**
+ * 根据 languageFilter 返回人类可读的语言标签（报告使用）。
+ * 过滤器为空时覆盖全部已注册 adapter；否则仅列出过滤集合中的 adapter。
+ */
+export declare function describeScannedLanguages(registry: LanguageAdapterRegistry, languageFilter: string[] | undefined): string[];
+export type { DebtReport, CodeDebtEntry, OpenQuestionEntry };
+export { buildDebtReportFromReport } from './aggregator/report-builder.js';
+export { patchQualityReportWithDebt, findQualityReportPath, renderDebtSection } from './aggregator/quality-report-patcher.js';
+export { indexDebtInReadme } from './aggregator/readme-indexer.js';
+export type { SimpleLLMClient } from './design-docs/llm-topic-inferrer.js';
+export type { Language };
+//# sourceMappingURL=index.d.ts.map

package/dist/debt-scanner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/debt-scanner/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EACV,aAAa,EAIb,UAAU,EACV,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,uBAAuB,CAAC;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,uBAAuB;IACvB,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1F;AAUD;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAmDvF;AAsFD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,uBAAuB,EACjC,cAAc,EAAE,MAAM,EAAE,GAAG,SAAS,GACnC,MAAM,EAAE,CASV;AAiBD,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC9H,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAG3E,YAAY,EAAE,QAAQ,EAAE,CAAC"}