spectra-cli 4.2.0 → 4.3.0

package/dist/scaffold-kb/tokenizer.js

@@ -0,0 +1,97 @@
+/**
+ * F190 scaffold-kb — CJK/符号感知的索引规范化（唯一 canonical 形式）
+ *
+ * 写入侧与查询侧共用同一个 `tokenize` / `normalizeForIndex`，保证同构（plan §4.1.2）。
+ * 设计要点：
+ * - SQLite FTS5 默认 unicode61 不切中文、对 `.`/`-`/`_` 等符号按分隔处理；
+ *   故不依赖 tokenizer 的 CJK 感知，而是在写入/查询前把文本规范化成"空格分隔、
+ *   unicode61 能逐 token 索引"的形式。
+ * - CJK 连续段 → unigram + bigram（单字保证短查询不零召回，bigram 提精度）。
+ * - ASCII 符号段（含 `._-<>@()/`）→ 各组件 + 拼接形（既能按组件查，也能按整符号查）；
+ *   不保留原始 `sdk.Init()` 字面（unicode61 下必被切），不使用任何特殊编码。
+ */
+/** 符号内连接符：出现在 ASCII 符号串内部、需被拆成组件的字符 */
+const SYMBOL_CONNECTOR = /[._\-<>@()/]/;
+/** 单个 ASCII 字母数字 */
+const ALNUM = /[A-Za-z0-9]/;
+/** Han（CJK 表意文字）—— 用 Unicode Script 属性，覆盖主区 + 扩展区 */
+const HAN = /\p{Script=Han}/u;
+function classify(ch) {
+    if (HAN.test(ch))
+        return 'han';
+    if (ALNUM.test(ch) || SYMBOL_CONNECTOR.test(ch))
+        return 'ascii';
+    return 'sep';
+}
+/**
+ * 将 CJK 连续段展开为 unigram + bigram。
+ * 例：`错误码` → ['错','误','码','错误','误码']
+ */
+function expandCjkRun(run) {
+    const chars = Array.from(run);
+    const out = [];
+    for (const c of chars)
+        out.push(c); // unigrams
+    for (let i = 0; i + 1 < chars.length; i++) {
+        out.push(chars[i] + chars[i + 1]); // bigrams
+    }
+    return out;
+}
+/**
+ * 将 ASCII 符号段拆为组件 + 拼接形。
+ * 例：`sdk.Init()` → ['sdk','Init','sdkInit']；`E01` → ['E01']；`hello` → ['hello']
+ */
+function expandAsciiRun(run) {
+    const components = run.split(/[._\-<>@()/]+/).filter((s) => s.length > 0);
+    if (components.length === 0)
+        return [];
+    if (components.length === 1)
+        return [components[0]];
+    const joined = components.join('');
+    return [...components, joined];
+}
+/**
+ * 把文本切成有序 token 数组（写入侧与查询侧共用）。
+ *
+ * - 按字符类别（han / ascii / sep）切分为 run；sep run 丢弃
+ * - han run → unigram + bigram
+ * - ascii run → 组件 + 拼接形
+ */
+export function tokenize(rawText) {
+    // NFKC 规范化：把全角 ASCII（ＡＰＩ１２３）、兼容字符折叠为标准形，避免被当 sep 静默丢弃
+    // （修 Codex WARNING）。写入侧与查询侧同走此函数 → 仍同构。
+    const text = rawText.normalize('NFKC');
+    const tokens = [];
+    let runStart = 0;
+    let runClass = null;
+    const flush = (end) => {
+        if (runClass === null)
+            return;
+        const run = text.slice(runStart, end);
+        if (runClass === 'han')
+            tokens.push(...expandCjkRun(run));
+        else if (runClass === 'ascii')
+            tokens.push(...expandAsciiRun(run));
+    };
+    const chars = Array.from(text);
+    let byteIdx = 0;
+    for (const ch of chars) {
+        const cls = classify(ch);
+        if (cls !== runClass) {
+            flush(byteIdx);
+            runStart = byteIdx;
+            runClass = cls;
+        }
+        byteIdx += ch.length;
+    }
+    flush(byteIdx);
+    return tokens;
+}
+/**
+ * 规范化为 FTS5 索引/查询用的空格分隔字符串。
+ * `normalizeForIndex(t) === tokenize(t).join(' ')`，写入与查询同构的单一事实源。
+ */
+export function normalizeForIndex(text) {
+    return tokenize(text).join(' ');
+}
+//# sourceMappingURL=tokenizer.js.map

package/dist/scaffold-kb/tokenizer.js.map

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

package/dist/scaffold-kb/types.d.ts

@@ -0,0 +1,157 @@
+/**
+ * F190 scaffold-kb — 共享类型（构建流水线各模块的契约单一事实源）
+ */
+/** 知识库来源种类（厂商库 / 项目库）；下沉到 scaffold-kb 供 evidence-envelope 复用，避免反向依赖 kb-mcp */
+export type SourceKind = 'vendor' | 'project';
+/** ingester 解析出的单篇文档 */
+export interface ParsedDoc {
+    /** 文档唯一 id（URL path 或文件相对路径），同一 KB 内稳定唯一 */
+    id: string;
+    /** 文档标题 */
+    title: string;
+    /** 文档 Markdown 正文 */
+    content: string;
+    /** 原始来源（URL 或文件路径） */
+    sourceUrl: string;
+    /** 语言标记 */
+    lang: 'zh' | 'en' | string;
+    /** 文档内显式引用的其它文档目标（href / llms.txt 关联），用于 doc-graph 边 */
+    references?: string[];
+}
+/** chunk-splitter 切出的单个片段 */
+export interface Chunk {
+    /** `doc_id + '#' + anchor`（同 anchor 多 chunk 追加序号），稳定可复现 */
+    chunkId: string;
+    /** 所属文档 id */
+    docId: string;
+    /** 片段原文（envelope 返回用） */
+    contentRaw: string;
+    /** 所在段落/章节锚点 slug（如 `error-codes`），可空 */
+    anchor: string | null;
+}
+/** 三方导入来源种类（F192 §3.3 provenance）；null/缺省 = F190 旧库或厂商构建 */
+export type IngestSourceType = 'llms-txt' | 'markdown-dir' | 'url' | 'office-docx' | 'office-pptx' | 'office-pdf' | 'minutes';
+/** chunk_meta 表的一行（关联检索结果到来源） */
+export interface ChunkMeta {
+    chunkId: string;
+    docId: string;
+    /** 冗余自 doc-graph 节点 title，使 kb_search 不依赖 doc-graph.json（R-003） */
+    docTitle: string;
+    sourceUrl: string | null;
+    anchor: string | null;
+    sdkVersion: string | null;
+    builtAt: string;
+    /** F192 provenance（仅新建/项目库写入；F190 旧库读取时为 null，见 R-COMPAT-1） */
+    ingestSourceType?: IngestSourceType | null;
+    ingestOrigin?: string | null;
+    ingestedAt?: string | null;
+}
+/** API 实体单条（F192 §3.2；文档自抽取，证据级，非代码级） */
+export interface ApiEntity {
+    /** 稳定唯一 id：qualified_name + kind + overload_key 归一 */
+    id: string;
+    name: string;
+    /** 文档侧限定名（含 namespace/容器路径）；无则等于 name */
+    qualifiedName: string;
+    /** 所属 class/module/namespace（可选） */
+    container?: string | null;
+    /** 同名重载消歧键（可选） */
+    overloadKey?: string | null;
+    kind: 'function' | 'method' | 'class' | 'constant' | 'type' | 'endpoint' | 'error_code' | 'event';
+    signature?: string | null;
+    params?: Array<{
+        name: string;
+        type?: string | null;
+        required?: boolean;
+        doc?: string | null;
+    }>;
+    returns?: string | null;
+    deprecated?: {
+        isDeprecated: boolean;
+        since?: string | null;
+        replacement?: string | null;
+    };
+    sinceVersion?: string | null;
+    sourceDocId: string;
+    /** primary 证据 chunk id（chunks.sqlite，仅同一次 build 内可回溯） */
+    sourceChunkId: string;
+    /** 证据链跨多 chunk 时的全部 chunk id（可选） */
+    sourceChunkIds?: string[];
+    sourceAnchor?: string | null;
+    /** 抽取依据的原文片段（截断，可选） */
+    evidenceQuote?: string | null;
+    lang: string;
+    /** [0,1]，读取越界 clamp、非数值视为缺失 */
+    confidence: number;
+    extractionMethod: 'llm' | 'heuristic';
+}
+/**
+ * 抽取输入单元（section 窗口，W-4）：同 docId+anchor 的相邻 chunk 聚合，
+ * 防 API 签名/参数跨 chunk 被切碎。LLM 与 heuristic 抽取共享此输入契约。
+ */
+export interface ExtractionSection {
+    docId: string;
+    anchor: string | null;
+    lang: string;
+    /** 窗口内全部 chunk id（primary = chunkIds[0]） */
+    chunkIds: string[];
+    /** 聚合后的原文文本 */
+    text: string;
+}
+/** api-entities.json 结构契约（F192 §3.2） */
+export interface ApiEntityFile {
+    schemaVersion: '1.0';
+    builtAt: string;
+    sdkVersion: string | null;
+    sourceKind: SourceKind;
+    entities: ApiEntity[];
+    /** 成本护栏：抽取覆盖率元字段（超预算截断时记录，FR-001） */
+    coverage?: {
+        totalSections: number;
+        extractedSections: number;
+    };
+}
+/** doc-graph.json 节点 */
+export interface DocNode {
+    id: string;
+    title: string;
+    summary?: string;
+    tags?: string[];
+    lang: string;
+    sourceUrl: string;
+}
+/** doc-graph.json 边 */
+export interface DocEdge {
+    source: string;
+    target: string;
+    relation: 'references' | 'mentions' | 'supersedes';
+}
+/** doc-graph.json 结构契约（spec §3.2） */
+export interface DocGraph {
+    schemaVersion: '1.0';
+    source: 'llms.txt' | 'directory';
+    builtAt: string;
+    sdkVersion: string | null;
+    nodes: DocNode[];
+    edges: DocEdge[];
+}
+/** scaffold-kb build 选项 */
+export interface BuildKbOptions {
+    /** 远程 llms.txt 索引 URL */
+    llmsTxtUrl?: string;
+    /** 本地 Markdown 文档目录 */
+    dirPath?: string;
+    /** kb/ 产物输出目录（默认 ./kb） */
+    outputPath?: string;
+    /** SDK 版本（写入产物元数据） */
+    sdkVersion?: string;
+    /** 文档语言标记（写入 doc-graph 节点 lang；默认 en） */
+    lang?: string;
+    /** 注入的时间戳（ISO 8601）；幂等比较时排除（不传则由 build 决定，测试可固定） */
+    builtAt?: string;
+    /** 跳过 LLM 抽取，只走 heuristic（CLI --no-llm，FR-001） */
+    noLlm?: boolean;
+    /** 产物 source_kind（厂商构建=vendor，项目导入=project）；默认 vendor */
+    sourceKind?: SourceKind;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/scaffold-kb/types.d.ts.map

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

package/dist/scaffold-kb/types.js

@@ -0,0 +1,5 @@
+/**
+ * F190 scaffold-kb — 共享类型（构建流水线各模块的契约单一事实源）
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/scaffold-kb/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scaffold-kb/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/file-scanner.d.ts

@@ -27,6 +27,21 @@ export interface ScanResult {
     /** 各已支持语言的文件统计（key 为 adapter.id） */
     languageStats?: Map<string, LanguageFileStat>;
 }
+/**
+ * 创建 .gitignore 过滤器（单一事实源）
+ * 供 python-adapter 及 batch-orchestrator 的自写 walk 叠加接入。
+ *
+ * 基准契约：返回的过滤函数期望输入**相对 projectRoot 的路径**
+ * （即 .gitignore 所在根 = 相对路径基准，二者必须一致，由调用方保证）。
+ * 注意 scanFiles 现状存在 scanRoot != projectRoot 时基准错位的既有怪癖
+ * （gitignore 取自 projectRoot 而 relativePath 相对 resolvedDir，
+ * 如 module-derivation.ts scanRoot=src 的调用）——该怪癖属 file-scanner
+ * 既有行为，本 fix 不修也不放大；三处新接入 walk 的扫描根 = gitignore 根，无错位。
+ *
+ * @param projectRoot - 项目根目录（用于定位 .gitignore，亦是相对路径基准）
+ * @returns 过滤函数：接受相对 projectRoot 的路径，返回 true 表示命中 gitignore 应跳过
+ */
+export declare function createGitignoreFilter(projectRoot: string): (relativePath: string) => boolean;
 /**
  * 扫描目录中支持的源文件
  *

package/dist/utils/file-scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-scanner.d.ts","sourceRoot":"","sources":["../../src/utils/file-scanner.ts"],"names":[],"mappings":"AAwGA,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,iCAAiC;IACjC,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED,sBAAsB;AACtB,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,qBAAqB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,oCAAoC;IACpC,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC/C;AAiLD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,UAAU,CAyE9E"}
+{"version":3,"file":"file-scanner.d.ts","sourceRoot":"","sources":["../../src/utils/file-scanner.ts"],"names":[],"mappings":"AAwGA,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,iCAAiC;IACjC,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED,sBAAsB;AACtB,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,qBAAqB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,oCAAoC;IACpC,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC/C;AAkDD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAE5F;AAiID;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,UAAU,CAyE9E"}

package/dist/utils/file-scanner.js

@@ -139,6 +139,23 @@ function parseGitignore(gitignorePath) {
         return ignored;
     };
 }
+/**
+ * 创建 .gitignore 过滤器（单一事实源）
+ * 供 python-adapter 及 batch-orchestrator 的自写 walk 叠加接入。
+ *
+ * 基准契约：返回的过滤函数期望输入**相对 projectRoot 的路径**
+ * （即 .gitignore 所在根 = 相对路径基准，二者必须一致，由调用方保证）。
+ * 注意 scanFiles 现状存在 scanRoot != projectRoot 时基准错位的既有怪癖
+ * （gitignore 取自 projectRoot 而 relativePath 相对 resolvedDir，
+ * 如 module-derivation.ts scanRoot=src 的调用）——该怪癖属 file-scanner
+ * 既有行为，本 fix 不修也不放大；三处新接入 walk 的扫描根 = gitignore 根，无错位。
+ *
+ * @param projectRoot - 项目根目录（用于定位 .gitignore，亦是相对路径基准）
+ * @returns 过滤函数：接受相对 projectRoot 的路径，返回 true 表示命中 gitignore 应跳过
+ */
+export function createGitignoreFilter(projectRoot) {
+    return parseGitignore(path.resolve(projectRoot, '.gitignore'));
+}
 /**
  * 将简单 glob 模式转换为正则表达式
  */

package/dist/utils/file-scanner.js.map

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

package/dist/utils/string-distance.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 字符串距离工具（string-distance）
+ *
+ * 提供仓库内共享的纯函数编辑距离实现。原先 `levenshtein` 在
+ * `src/knowledge-graph/query-helpers.ts`（F174 fuzzy 解析热路径）与
+ * `src/panoramic/pipelines/adr-evidence-verifier.ts`（ADR 证据宽容匹配）两处逐字复制，
+ * 注释自承"照搬"。Feature 178 合并为单一来源，两调用方 import，消除双写漂移风险。
+ */
+/**
+ * Levenshtein 编辑距离 — 标准 DP 滚动数组实现（O(min(m,n)) 空间）。
+ *
+ * 选短的一边作内层循环、长的一边作外层，减小内层数组规模。
+ * 纯函数：相同输入恒返回相同距离，不依赖任何外部状态。
+ *
+ * @param a 字符串 A
+ * @param b 字符串 B
+ * @returns 把 a 变换为 b 所需的最少单字符插入/删除/替换次数
+ */
+export declare function levenshtein(a: string, b: string): number;
+//# sourceMappingURL=string-distance.d.ts.map

package/dist/utils/string-distance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-distance.d.ts","sourceRoot":"","sources":["../../src/utils/string-distance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBxD"}

package/dist/utils/string-distance.js

@@ -0,0 +1,38 @@
+/**
+ * 字符串距离工具（string-distance）
+ *
+ * 提供仓库内共享的纯函数编辑距离实现。原先 `levenshtein` 在
+ * `src/knowledge-graph/query-helpers.ts`（F174 fuzzy 解析热路径）与
+ * `src/panoramic/pipelines/adr-evidence-verifier.ts`（ADR 证据宽容匹配）两处逐字复制，
+ * 注释自承"照搬"。Feature 178 合并为单一来源，两调用方 import，消除双写漂移风险。
+ */
+/**
+ * Levenshtein 编辑距离 — 标准 DP 滚动数组实现（O(min(m,n)) 空间）。
+ *
+ * 选短的一边作内层循环、长的一边作外层，减小内层数组规模。
+ * 纯函数：相同输入恒返回相同距离，不依赖任何外部状态。
+ *
+ * @param a 字符串 A
+ * @param b 字符串 B
+ * @returns 把 a 变换为 b 所需的最少单字符插入/删除/替换次数
+ */
+export function levenshtein(a, b) {
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    const [shorter, longer] = a.length <= b.length ? [a, b] : [b, a];
+    const sm = shorter.length;
+    const ln = longer.length;
+    let prev = Array.from({ length: sm + 1 }, (_, i) => i);
+    for (let i = 1; i <= ln; i++) {
+        const curr = [i];
+        for (let j = 1; j <= sm; j++) {
+            const cost = longer[i - 1] === shorter[j - 1] ? 0 : 1;
+            curr.push(Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + cost));
+        }
+        prev = curr;
+    }
+    return prev[sm];
+}
+//# sourceMappingURL=string-distance.js.map

package/dist/utils/string-distance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-distance.js","sourceRoot":"","sources":["../../src/utils/string-distance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,CAAS;IAC9C,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAC1B,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC;IACzB,IAAI,IAAI,GAAa,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACjE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAa,CAAC,CAAC,CAAC,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,GAAG,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,EAAE,CAAE,CAAC;AACnB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spectra-cli",
-  "version": "4.2.0",
+  "version": "4.3.0",
   "description": "通过 AST 静态分析 + LLM 混合流水线，将源代码逆向工程为结构化 Spec 文档的多语言代码分析平台",
   "type": "module",
   "main": "dist/index.js",
@@ -19,7 +19,9 @@
   "scripts": {
     "prebuild": "tsx scripts/inline-d3.ts",
     "build": "tsc",
-    "test": "vitest run",
+    "postbuild": "node scripts/postbuild-stamp.mjs",
+    "test": "vitest run && npm run test:plugins",
+    "test:plugins": "node --test \"plugins/spec-driver/tests/**/*.test.mjs\"",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "test:unit": "vitest run --project unit",
@@ -66,19 +68,26 @@
   "dependencies": {
     "@anthropic-ai/sdk": "^0.39.0",
     "@modelcontextprotocol/sdk": "^1.26.0",
+    "@mozilla/readability": "^0.6.0",
+    "@sqlite.org/sqlite-wasm": "^3.53.0-build1",
     "chokidar": "^4.0.3",
+    "fflate": "^0.8.3",
     "graphology": "^0.26.0",
     "graphology-communities-louvain": "^2.0.2",
     "graphology-types": "^0.24.8",
     "handlebars": "^4.7.8",
+    "linkedom": "^0.18.12",
     "openai": "^6.37.0",
     "p-limit": "^6.1.0",
     "ts-morph": "^24.0.0",
+    "turndown": "^7.2.4",
+    "unpdf": "^1.6.2",
     "web-tree-sitter": "^0.24.7",
     "zod": "^3.24.1"
   },
   "devDependencies": {
     "@types/node": "^22.12.0",
+    "@types/turndown": "^5.0.6",
     "@vitest/coverage-v8": "^3.0.4",
     "d3-force": "^3.0.0",
     "tsx": "^4.21.0",

package/plugins/demo-kb-en/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "demo-kb-en",
+  "version": "0.1.0",
+  "description": "英文 SDK 知识库 demo fixture（测试用途，验证 scaffold-kb 构建与 KB MCP 分发路径）。基于某公开开源 SDK 的公开文档构建。",
+  "author": {
+    "name": "scaffold-kb-mvp-test"
+  },
+  "license": "MIT",
+  "keywords": ["kb", "demo", "scaffold-kb", "test-fixture"],
+  "_testOnly": true
+}

package/plugins/demo-kb-en/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "kb-en": {
+      "command": "spectra",
+      "args": ["scaffold-kb", "serve", "--vendor-kb", "${CLAUDE_PLUGIN_ROOT}/kb"]
+    }
+  }
+}

package/plugins/demo-kb-en/FIXTURE.json

@@ -0,0 +1,23 @@
+{
+  "manifest_version": "1.0",
+  "plugin": "demo-kb-en",
+  "note": "F192 demo fixture 来源清单（机械可检，W-6）。每条 source MUST 有 license 或 synthetic:true；'无真实客户内容'以此承载，非空声称。",
+  "sources": [
+    {
+      "id": "vendor-docs",
+      "kind": "vendor-doc",
+      "origin": "https://hono.dev + honojs/hono",
+      "license": "MIT",
+      "synthetic": false,
+      "note": "公开开源 SDK 文档（13 页）→ kb/ (doc-graph + chunks.sqlite FTS5 + api-entities.json)"
+    },
+    {
+      "id": "ingest-sample-minutes",
+      "kind": "minutes",
+      "origin": "ingest-samples/meeting-notes.md",
+      "license": null,
+      "synthetic": true,
+      "note": "F192 three-party ingest (scaffold-kb ingest --minutes) synthetic demo minutes; fictional, no real customer/company/project info"
+    }
+  ]
+}

package/plugins/demo-kb-en/FIXTURE.md

@@ -0,0 +1,53 @@
+# demo-kb-en — 英文 demo fixture（Hono Web 框架文档）
+
+本目录是 Feature 190 `scaffold-kb` 的**英文 demo fixture**，用作一个**公开开源 SDK 文档**的代表性样例，用于演示 / 验证 `scaffold-kb build` 把 Markdown 文档目录构建为 `kb/`（`doc-graph.json` + `chunks.sqlite` FTS5 全文检索）。
+
+> 本 fixture 仅作通用「开源 SDK 文档」演示用途，不绑定任何客户、行业或专属场景。Hono 是一个公开的 MIT 开源项目，在此作为「某个公开 SDK」的一个实例呈现。
+
+> **F192 更新**：`kb/` 现额外含 **`api-entities.json`**（API 实体层，heuristic 抽取，供 `kb_api_lookup` 据文档查签名/参数/废弃，证据级非代码级）；`ingest-samples/meeting-notes.md` 是**三方导入演示用合成纪要**（`scaffold-kb ingest --minutes`，纯虚构无客户内容）；来源清单见机械可检的 `FIXTURE.json`。
+
+## 来源
+
+- 上游项目：Hono（Web Standards 上的轻量 Web 框架）
+- 文档站：https://hono.dev/docs/
+- 文档源码仓库：https://github.com/honojs/website （`docs/` 目录，原始 Markdown）
+- License：**MIT License**（https://github.com/honojs/hono/blob/main/LICENSE ；文档仓库 honojs/website 同为 MIT）
+
+## 页数与规模
+
+- 页数：**13 页**（`source-docs/*.md`，覆盖 getting-started / routing / middleware / context / request / response / exception 错误处理 / validation 等代表性主题）
+- 规模：每页 1 篇，远小于 50 页上限；构建出的 `chunks.sqlite` 远小于 10MB 上限
+
+## 来源页清单（slug ← 上游文档路径）
+
+| 本地文件 | 上游文档页（hono.dev） |
+|---------|----------------------|
+| `getting-started.md` | https://hono.dev/docs/getting-started/basic |
+| `routing.md` | https://hono.dev/docs/api/routing |
+| `context.md` | https://hono.dev/docs/api/context |
+| `request.md` | https://hono.dev/docs/api/request |
+| `app-hono-object.md` | https://hono.dev/docs/api/hono |
+| `exception-error-handling.md` | https://hono.dev/docs/api/exception |
+| `validation.md` | https://hono.dev/docs/guides/validation |
+| `middleware-concept.md` | https://hono.dev/docs/concepts/middleware |
+| `cors-middleware.md` | https://hono.dev/docs/middleware/builtin/cors |
+| `bearer-auth-middleware.md` | https://hono.dev/docs/middleware/builtin/bearer-auth |
+| `jwt-helper.md` | https://hono.dev/docs/helpers/jwt |
+| `best-practices.md` | https://hono.dev/docs/guides/best-practices |
+| `testing.md` | https://hono.dev/docs/guides/testing |
+
+## 处理说明
+
+- 正文取自上述上游文档的原始 Markdown（`honojs/website` 仓库 `docs/`），保留真实 API 名、错误处理示例与代码符号（如 `c.req.param()`、`app.get()`、`HTTPException`、`app.onError`）。
+- 仅做了文档站特定语法的轻量规整以得到干净的通用 Markdown：代码围栏语言标记归一（`ts twoslash` → `ts`）、移除 twoslash 切割标记、`[!code]` 高亮标记与 `:::` 容器标记。未改写任何 API 语义或代码内容。
+- 每个文件首行为 `# <页面标题>`，与上游 H1 一致，供 `scaffold-kb` 提取 doc title。
+
+## 构建命令
+
+```bash
+npx tsx src/cli/index.ts scaffold-kb build \
+  --dir plugins/demo-kb-en/source-docs \
+  --output plugins/demo-kb-en/kb
+```
+
+产物：`kb/doc-graph.json` + `kb/chunks.sqlite`。

package/plugins/demo-kb-en/ingest-samples/meeting-notes.md

@@ -0,0 +1,13 @@
+# Integration Review Meeting Notes (synthetic demo content)
+
+> This file is a **synthetic sample for F192 three-party ingest (`scaffold-kb ingest --minutes`)**. Content is fictional, contains no real customer/company/project information, and only demonstrates ingesting meeting notes into the project KB with provenance.
+
+## Agreements
+
+- In this project, the app object is always created via `new Hono()` at module top level; do not recreate per request.
+- Bearer auth middleware `bearerAuth({ token })` is mounted before route handlers, not after.
+- Error code `E1001` here usually means a missing middleware order issue; check `app.use` placement first.
+
+## Action items
+
+- Evaluate whether `app.route()` nesting depth affects cold-start latency.