spectra-cli 4.1.1 → 4.3.0

package/dist/runtime-bootstrap.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 一次性初始化 spectra runtime 的 3 个 registry。
+ *
+ * @param outputDir 可选的 generator 输出目录（透传给 bootstrapGenerators）。
+ *   - mcp / cli 入口通常省略（generator 内部使用默认值）
+ *   - batch / audit 入口可传入特定的 outputDir 指定 panoramic 文档落点
+ */
+export declare function bootstrapRuntime(outputDir?: string): void;
+//# sourceMappingURL=runtime-bootstrap.d.ts.map

package/dist/runtime-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-bootstrap.d.ts","sourceRoot":"","sources":["../src/runtime-bootstrap.ts"],"names":[],"mappings":"AAqBA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAIzD"}

package/dist/runtime-bootstrap.js

@@ -0,0 +1,33 @@
+/**
+ * 单一 runtime 初始化入口（FR-10 + SC-007）。
+ *
+ * 所有 entry point 必须调用 `bootstrapRuntime()`：
+ * - src/mcp/server.ts（MCP entry）
+ * - src/cli/index.ts（CLI entry）
+ * - src/panoramic/batch-project-docs.ts（batch entry）
+ * - src/panoramic/pipelines/coverage-auditor.ts（audit entry）
+ *
+ * 幂等性：内部 3 个 bootstrap 函数本身已幂等
+ *（registry 非空时跳过；详见 generator-registry.ts / parser-registry.ts / adapters/index.ts）。
+ *
+ * SC-007 验收：
+ *   grep -rE 'bootstrap(Adapters|Generators|Parsers)\(' src/ \
+ *     | grep -v 'src/runtime-bootstrap.ts'
+ *   → 期望 0 行命中（仅本文件调用 3 个 bootstrap 函数）
+ */
+import { bootstrapAdapters } from './adapters/index.js';
+import { bootstrapGenerators } from './panoramic/generator-registry.js';
+import { bootstrapParsers } from './panoramic/parser-registry.js';
+/**
+ * 一次性初始化 spectra runtime 的 3 个 registry。
+ *
+ * @param outputDir 可选的 generator 输出目录（透传给 bootstrapGenerators）。
+ *   - mcp / cli 入口通常省略（generator 内部使用默认值）
+ *   - batch / audit 入口可传入特定的 outputDir 指定 panoramic 文档落点
+ */
+export function bootstrapRuntime(outputDir) {
+    bootstrapAdapters();
+    bootstrapGenerators(outputDir);
+    bootstrapParsers();
+}
+//# sourceMappingURL=runtime-bootstrap.js.map

package/dist/runtime-bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-bootstrap.js","sourceRoot":"","sources":["../src/runtime-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAkB;IACjD,iBAAiB,EAAE,CAAC;IACpB,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC/B,gBAAgB,EAAE,CAAC;AACrB,CAAC"}

package/dist/scaffold-kb/api-entities-serializer.d.ts

@@ -0,0 +1,12 @@
+/**
+ * F192 — api-entities.json 序列化（内存 ApiEntityFile → on-disk snake_case，§3.2）
+ * build（厂商）+ ingest（项目）共用，保证两库 schema 一致。
+ */
+import type { ApiEntityFile } from './types.js';
+/** 序列化 ApiEntityFile 为 on-disk JSON 对象（snake_case，含 schema_version） */
+export declare function serializeApiEntities(file: ApiEntityFile): Record<string, unknown>;
+/** 实体数上限（防恶意超大 api-entities.json 在 MCP 启动期 OOM/CPU DoS） */
+export declare const MAX_ENTITIES = 50000;
+/** 反序列化 on-disk api-entities.json（snake_case）→ ApiEntityFile；顶层非法返回 null */
+export declare function deserializeApiEntities(raw: unknown): ApiEntityFile | null;
+//# sourceMappingURL=api-entities-serializer.d.ts.map

package/dist/scaffold-kb/api-entities-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-entities-serializer.d.ts","sourceRoot":"","sources":["../../src/scaffold-kb/api-entities-serializer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAa,aAAa,EAAE,MAAM,YAAY,CAAC;AAqC3D,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWjF;AA0DD,2DAA2D;AAC3D,eAAO,MAAM,YAAY,QAAS,CAAC;AAEnC,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAiBzE"}

package/dist/scaffold-kb/api-entities-serializer.js

@@ -0,0 +1,144 @@
+/**
+ * F192 — api-entities.json 序列化（内存 ApiEntityFile → on-disk snake_case，§3.2）
+ * build（厂商）+ ingest（项目）共用，保证两库 schema 一致。
+ */
+import { clampConfidence } from './entity-util.js';
+const VALID_KINDS = new Set([
+    'function', 'method', 'class', 'constant', 'type', 'endpoint', 'error_code', 'event',
+]);
+function serializeEntity(e) {
+    return {
+        id: e.id,
+        name: e.name,
+        qualified_name: e.qualifiedName,
+        container: e.container ?? null,
+        overload_key: e.overloadKey ?? null,
+        kind: e.kind,
+        signature: e.signature ?? null,
+        params: e.params ?? null,
+        returns: e.returns ?? null,
+        deprecated: e.deprecated
+            ? {
+                is_deprecated: e.deprecated.isDeprecated,
+                since: e.deprecated.since ?? null,
+                replacement: e.deprecated.replacement ?? null,
+            }
+            : null,
+        since_version: e.sinceVersion ?? null,
+        source_doc_id: e.sourceDocId,
+        source_chunk_id: e.sourceChunkId,
+        source_chunk_ids: e.sourceChunkIds ?? null,
+        source_anchor: e.sourceAnchor ?? null,
+        evidence_quote: e.evidenceQuote ?? null,
+        lang: e.lang,
+        confidence: e.confidence,
+        extraction_method: e.extractionMethod,
+    };
+}
+/** 序列化 ApiEntityFile 为 on-disk JSON 对象（snake_case，含 schema_version） */
+export function serializeApiEntities(file) {
+    return {
+        schema_version: file.schemaVersion,
+        built_at: file.builtAt,
+        sdk_version: file.sdkVersion,
+        source_kind: file.sourceKind,
+        entities: file.entities.map(serializeEntity),
+        coverage: file.coverage
+            ? { total_sections: file.coverage.totalSections, extracted_sections: file.coverage.extractedSections }
+            : null,
+    };
+}
+function deserializeEntity(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return null;
+    const o = raw;
+    const str = (k) => (typeof o[k] === 'string' ? o[k] : undefined);
+    const name = str('name');
+    const id = str('id');
+    if (!name || !id)
+        return null;
+    const kindRaw = String(o['kind'] ?? 'function');
+    const kind = (VALID_KINDS.has(kindRaw) ? kindRaw : 'function');
+    const e = {
+        id,
+        name,
+        qualifiedName: str('qualified_name') ?? name,
+        kind,
+        sourceDocId: str('source_doc_id') ?? '',
+        sourceChunkId: str('source_chunk_id') ?? '',
+        lang: str('lang') ?? 'en',
+        // 缺失/非数值 confidence → NaN（仲裁中性化，不贬为 0 即输；C-3 修正）
+        confidence: typeof o['confidence'] === 'number' && Number.isFinite(o['confidence'])
+            ? clampConfidence(o['confidence'], 0)
+            : NaN,
+        extractionMethod: o['extraction_method'] === 'llm' ? 'llm' : 'heuristic',
+    };
+    if (str('container'))
+        e.container = str('container');
+    if (str('overload_key'))
+        e.overloadKey = str('overload_key');
+    if (str('signature'))
+        e.signature = str('signature');
+    if (str('returns'))
+        e.returns = str('returns');
+    if (str('since_version'))
+        e.sinceVersion = str('since_version');
+    if (str('source_anchor'))
+        e.sourceAnchor = str('source_anchor');
+    if (str('evidence_quote'))
+        e.evidenceQuote = str('evidence_quote');
+    if (Array.isArray(o['source_chunk_ids']))
+        e.sourceChunkIds = o['source_chunk_ids'].map(String);
+    if (Array.isArray(o['params'])) {
+        e.params = o['params']
+            .filter((p) => typeof p === 'object' && p !== null)
+            .map((p) => {
+            const param = { name: String(p['name'] ?? '') };
+            if (typeof p['type'] === 'string')
+                param.type = p['type'];
+            if (typeof p['required'] === 'boolean')
+                param.required = p['required'];
+            if (typeof p['doc'] === 'string')
+                param.doc = p['doc'];
+            return param;
+        })
+            .filter((p) => p.name.length > 0);
+    }
+    const dep = o['deprecated'];
+    if (typeof dep === 'object' && dep !== null) {
+        const d = dep;
+        if (d['is_deprecated'] === true) {
+            e.deprecated = { isDeprecated: true };
+            if (typeof d['since'] === 'string')
+                e.deprecated.since = d['since'];
+            if (typeof d['replacement'] === 'string')
+                e.deprecated.replacement = d['replacement'];
+        }
+    }
+    return e;
+}
+/** 实体数上限（防恶意超大 api-entities.json 在 MCP 启动期 OOM/CPU DoS） */
+export const MAX_ENTITIES = 50_000;
+/** 反序列化 on-disk api-entities.json（snake_case）→ ApiEntityFile；顶层非法返回 null */
+export function deserializeApiEntities(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return null;
+    const o = raw;
+    if (!Array.isArray(o['entities']))
+        return null;
+    // DoS 防护：超量实体直接拒绝（降级 null → kb_api_lookup document_fallback）
+    if (o['entities'].length > MAX_ENTITIES)
+        return null;
+    const entities = o['entities']
+        .map(deserializeEntity)
+        .filter((e) => e !== null);
+    const sourceKind = o['source_kind'] === 'project' ? 'project' : 'vendor';
+    return {
+        schemaVersion: '1.0',
+        builtAt: typeof o['built_at'] === 'string' ? o['built_at'] : '',
+        sdkVersion: typeof o['sdk_version'] === 'string' ? o['sdk_version'] : null,
+        sourceKind,
+        entities,
+    };
+}
+//# sourceMappingURL=api-entities-serializer.js.map

package/dist/scaffold-kb/api-entities-serializer.js.map

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

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

@@ -0,0 +1,44 @@
+/**
+ * F192 T006 — 冲突仲裁档 A（kb_api_lookup 实体级，FR-007/008 + §3.4 R-ARB-2）
+ *
+ * 同 id 实体在两库均命中且关键属性矛盾 → 冲突组。pairwise 归一加权打分：
+ *   score = Σ(w_i · dim_i) / Σ(w_i over 活跃维)   —— 缺失维剔除并重归一（非填 0）
+ * 维度：版本匹配度 / 时效 / confidence。安全默认（R-ARB-2）：
+ *   - 缺 confidence/version → 该维中性化（剔除）；缺时间戳 → 按"最旧"（显式例外）
+ *   - 推荐项 MUST 在版本或 confidence ≥1 主维严格占优；仅时效新不足以推荐
+ *   - 分差 < ε → 并列，全 recommended=false（回退双呈现）
+ */
+import type { ApiEntity, SourceKind } from './types.js';
+export interface ArbitrationInput extends ApiEntity {
+    sourceKind: SourceKind;
+    /** 来源库 sdk_version（ApiEntityFile 级，版本匹配兜底；实体无 sinceVersion 时用） */
+    libSdkVersion?: string | null;
+    /** recency 时间戳：导入实体用 ingested_at、厂商构建用 built_at（缺 → 按最旧） */
+    timestamp?: string | null;
+}
+export interface Arbitration {
+    recommended: boolean;
+    score: number;
+    reason: string;
+    groupId: string;
+}
+export interface ArbitratedEntity extends ArbitrationInput {
+    arbitration?: Arbitration;
+}
+export interface ArbitrateOptions {
+    /** 查询显式版本；无则 fallback 到 kbSdkVersion（W-5 防版本维形同虚设） */
+    targetSdkVersion?: string | null;
+    kbSdkVersion?: string | null;
+    weights?: {
+        version: number;
+        recency: number;
+        confidence: number;
+    };
+    epsilon?: number;
+}
+/**
+ * 对一组匹配实体做冲突仲裁。返回标注 arbitration 的实体（同 id 冲突组共享 groupId）。
+ * 非冲突（单库命中或组内属性一致）不标 arbitration。
+ */
+export declare function arbitrateEntities(entities: ArbitrationInput[], opts?: ArbitrateOptions): ArbitratedEntity[];
+//# sourceMappingURL=arbitration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"arbitration.d.ts","sourceRoot":"","sources":["../../src/scaffold-kb/arbitration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,UAAU,EAAE,UAAU,CAAC;IACvB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA4ED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,IAAI,GAAE,gBAAqB,GAC1B,gBAAgB,EAAE,CAgEpB"}

package/dist/scaffold-kb/arbitration.js

@@ -0,0 +1,144 @@
+/**
+ * F192 T006 — 冲突仲裁档 A（kb_api_lookup 实体级，FR-007/008 + §3.4 R-ARB-2）
+ *
+ * 同 id 实体在两库均命中且关键属性矛盾 → 冲突组。pairwise 归一加权打分：
+ *   score = Σ(w_i · dim_i) / Σ(w_i over 活跃维)   —— 缺失维剔除并重归一（非填 0）
+ * 维度：版本匹配度 / 时效 / confidence。安全默认（R-ARB-2）：
+ *   - 缺 confidence/version → 该维中性化（剔除）；缺时间戳 → 按"最旧"（显式例外）
+ *   - 推荐项 MUST 在版本或 confidence ≥1 主维严格占优；仅时效新不足以推荐
+ *   - 分差 < ε → 并列，全 recommended=false（回退双呈现）
+ */
+const DEFAULT_WEIGHTS = { version: 0.4, recency: 0.2, confidence: 0.4 };
+const DEFAULT_EPSILON = 0.05;
+/** 关键属性签名：用于判定组内是否"矛盾"（值不同即冲突） */
+function keyAttrSignature(e) {
+    const params = (e.params ?? []).map((p) => `${p.name}:${p.type ?? ''}`).join(',');
+    const dep = e.deprecated?.isDeprecated ? `dep@${e.deprecated.since ?? ''}` : 'live';
+    return `${e.signature ?? ''}|${params}|${dep}|${e.sinceVersion ?? ''}`;
+}
+/** 粗粒度版本比较：返回 -1/0/1（无法解析返回 null） */
+function compareVersion(a, b) {
+    const parse = (v) => {
+        const m = v.trim().match(/^v?(\d+)(?:\.(\d+))?(?:\.(\d+))?/);
+        if (!m)
+            return null;
+        return [Number(m[1] ?? 0), Number(m[2] ?? 0), Number(m[3] ?? 0)];
+    };
+    const pa = parse(a);
+    const pb = parse(b);
+    if (!pa || !pb)
+        return null;
+    for (let i = 0; i < 3; i++) {
+        const d = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (d !== 0)
+            return d > 0 ? 1 : -1;
+    }
+    return 0;
+}
+/** 版本匹配度：相对 target 的适用性（exact=1 / 适用旧=0.6 / 偏新=0.2）；无信息 → null（中性化） */
+function versionScore(e, target) {
+    const v = e.sinceVersion ?? e.libSdkVersion ?? null;
+    if (target == null || v == null)
+        return null;
+    const cmp = compareVersion(v, target);
+    if (cmp == null)
+        return null;
+    if (cmp === 0)
+        return 1.0;
+    return cmp < 0 ? 0.6 : 0.2;
+}
+/** 时效分：组内按时间戳归一（newest=1, oldest=0）；缺时间戳 → 0（最旧，显式例外） */
+function recencyScores(group) {
+    const ts = group.map((e) => e.timestamp ?? '');
+    const present = ts.filter((t) => t.length > 0).sort();
+    if (present.length === 0)
+        return group.map(() => 0);
+    const min = present[0];
+    const max = present[present.length - 1];
+    if (min === max)
+        return group.map((_, i) => (ts[i] ? 1 : 0));
+    return ts.map((t) => {
+        if (!t)
+            return 0;
+        return t === max ? 1 : t === min ? 0 : 0.5;
+    });
+}
+function weightedScore(d, w) {
+    let num = 0;
+    let den = 0;
+    if (d.version != null) {
+        num += w.version * d.version;
+        den += w.version;
+    }
+    if (d.confidence != null) {
+        num += w.confidence * d.confidence;
+        den += w.confidence;
+    }
+    // 时效维始终参与（缺时间戳已按最旧=0）
+    num += w.recency * d.recency;
+    den += w.recency;
+    return den > 0 ? num / den : 0;
+}
+/**
+ * 对一组匹配实体做冲突仲裁。返回标注 arbitration 的实体（同 id 冲突组共享 groupId）。
+ * 非冲突（单库命中或组内属性一致）不标 arbitration。
+ */
+export function arbitrateEntities(entities, opts = {}) {
+    const weights = opts.weights ?? DEFAULT_WEIGHTS;
+    const epsilon = opts.epsilon ?? DEFAULT_EPSILON;
+    const target = opts.targetSdkVersion ?? opts.kbSdkVersion ?? null;
+    // 按 id 分组
+    const groups = new Map();
+    for (const e of entities) {
+        const g = groups.get(e.id) ?? [];
+        g.push(e);
+        groups.set(e.id, g);
+    }
+    const out = [];
+    for (const [groupId, group] of groups) {
+        // 非冲突：单成员，或全员关键属性一致 → 不仲裁
+        const sigs = new Set(group.map(keyAttrSignature));
+        if (group.length < 2 || sigs.size < 2) {
+            out.push(...group);
+            continue;
+        }
+        const recScores = recencyScores(group);
+        const dims = group.map((e, i) => ({
+            version: versionScore(e, target),
+            recency: recScores[i] ?? 0,
+            confidence: Number.isFinite(e.confidence) ? e.confidence : null,
+        }));
+        const scores = dims.map((d) => weightedScore(d, weights));
+        // 找最高分 + 次高分
+        let bestIdx = 0;
+        for (let i = 1; i < scores.length; i++)
+            if ((scores[i] ?? 0) > (scores[bestIdx] ?? 0))
+                bestIdx = i;
+        const sorted = [...scores].sort((a, b) => b - a);
+        const best = sorted[0] ?? 0;
+        const second = sorted[1] ?? 0;
+        // 主维严格占优判定（版本 或 confidence），仅时效不算
+        const bestDim = dims[bestIdx];
+        // 主维"占优"要求所有对手在该维**有值且严格更低**；对手该维缺失（中性化）
+        // 不可被判为"被压过"——否则缺失即输，违背 R-ARB-2（C-3 修正）。
+        const dominatesVersion = bestDim.version != null &&
+            dims.every((d, i) => i === bestIdx || (d.version != null && d.version < bestDim.version));
+        const dominatesConfidence = bestDim.confidence != null &&
+            dims.every((d, i) => i === bestIdx || (d.confidence != null && d.confidence < bestDim.confidence));
+        const hasMainAdvantage = dominatesVersion || dominatesConfidence;
+        const recommend = hasMainAdvantage && best - second >= epsilon;
+        group.forEach((e, i) => {
+            const reason = !recommend
+                ? '各维并列或仅时效占优 → 回退双呈现（R-ARB-2）'
+                : i === bestIdx
+                    ? `推荐：${dominatesVersion ? '版本匹配' : ''}${dominatesVersion && dominatesConfidence ? '+' : ''}${dominatesConfidence ? 'confidence' : ''}占优（score ${best.toFixed(2)}）`
+                    : `备选（score ${(scores[i] ?? 0).toFixed(2)}）`;
+            out.push({
+                ...e,
+                arbitration: { recommended: recommend && i === bestIdx, score: scores[i] ?? 0, reason, groupId },
+            });
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=arbitration.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"arbitration.js","sourceRoot":"","sources":["../../src/scaffold-kb/arbitration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA+BH,MAAM,eAAe,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;AACxE,MAAM,eAAe,GAAG,IAAI,CAAC;AAE7B,kCAAkC;AAClC,SAAS,gBAAgB,CAAC,CAAY;IACpC,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClF,MAAM,GAAG,GAAG,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IACpF,OAAO,GAAG,CAAC,CAAC,SAAS,IAAI,EAAE,IAAI,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;AACzE,CAAC;AAED,qCAAqC;AACrC,SAAS,cAAc,CAAC,CAAS,EAAE,CAAS;IAC1C,MAAM,KAAK,GAAG,CAAC,CAAS,EAAmB,EAAE;QAC3C,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAC7D,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC;IACF,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACpB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,uEAAuE;AACvE,SAAS,YAAY,CAAC,CAAmB,EAAE,MAAqB;IAC9D,MAAM,CAAC,GAAG,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,aAAa,IAAI,IAAI,CAAC;IACpD,IAAI,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtC,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,GAAG,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC1B,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAC7B,CAAC;AAED,yDAAyD;AACzD,SAAS,aAAa,CAAC,KAAyB;IAC9C,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;IACxB,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;IACzC,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAClB,IAAI,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;QACjB,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC;AAQD,SAAS,aAAa,CAAC,CAAO,EAAE,CAAyB;IACvD,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;QACtB,GAAG,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;QAC7B,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;QACzB,GAAG,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;QACnC,GAAG,IAAI,CAAC,CAAC,UAAU,CAAC;IACtB,CAAC;IACD,sBAAsB;IACtB,GAAG,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;IAC7B,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC;IACjB,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAA4B,EAC5B,OAAyB,EAAE;IAE3B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,eAAe,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC;IAElE,UAAU;IACV,MAAM,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;IACrD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACV,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,GAAG,GAAuB,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACtC,0BAA0B;QAC1B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACtC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;YACnB,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,IAAI,GAAW,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACxC,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC;YAChC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;YAC1B,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI;SAChE,CAAC,CAAC,CAAC;QACJ,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAE1D,aAAa;QACb,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAAE,OAAO,GAAG,CAAC,CAAC;QACnG,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAE9B,kCAAkC;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAE,CAAC;QAC/B,yCAAyC;QACzC,yCAAyC;QACzC,MAAM,gBAAgB,GACpB,OAAO,CAAC,OAAO,IAAI,IAAI;YACvB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,IAAI,IAAI,CAAC,CAAC,OAAO,GAAG,OAAO,CAAC,OAAQ,CAAC,CAAC,CAAC;QAC7F,MAAM,mBAAmB,GACvB,OAAO,CAAC,UAAU,IAAI,IAAI;YAC1B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,IAAI,CAAC,CAAC,UAAU,GAAG,OAAO,CAAC,UAAW,CAAC,CAAC,CAAC;QACtG,MAAM,gBAAgB,GAAG,gBAAgB,IAAI,mBAAmB,CAAC;QAEjE,MAAM,SAAS,GAAG,gBAAgB,IAAI,IAAI,GAAG,MAAM,IAAI,OAAO,CAAC;QAE/D,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACrB,MAAM,MAAM,GAAG,CAAC,SAAS;gBACvB,CAAC,CAAC,6BAA6B;gBAC/B,CAAC,CAAC,CAAC,KAAK,OAAO;oBACb,CAAC,CAAC,MAAM,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,gBAAgB,IAAI,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,mBAAmB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;oBACnK,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;YACjD,GAAG,CAAC,IAAI,CAAC;gBACP,GAAG,CAAC;gBACJ,WAAW,EAAE,EAAE,WAAW,EAAE,SAAS,IAAI,CAAC,KAAK,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE;aACjG,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/scaffold-kb/chunk-splitter.d.ts

@@ -0,0 +1,20 @@
+/**
+ * F190 scaffold-kb — chunk-splitter
+ *
+ * 将 ParsedDoc 按三级策略切分为 Chunk[]:
+ *   1. 标题级（## / ###）— 每个标题节为候选单元
+ *   2. 段落级（\n\n）— 超 400 token 候选按空行切段，组合到接近 400 token
+ *   3. 句子级兜底（句号 / 换行）— 单段落超 400 token 时切
+ *
+ * token 计量：约 4 字符 = 1 token（无外部依赖）
+ * 单 chunk 上限：500 token（≈ 2000 字符）
+ * 最小 chunk：20 token（≈ 80 字符），不足则合并到邻近
+ */
+import type { Chunk, ParsedDoc } from './types.js';
+/**
+ * 将 ParsedDoc 按三级策略切分为 Chunk[]
+ *
+ * 幂等保证：相同输入产出相同 chunkId 集合与顺序
+ */
+export declare function splitDocument(doc: ParsedDoc): Chunk[];
+//# sourceMappingURL=chunk-splitter.d.ts.map

package/dist/scaffold-kb/chunk-splitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-splitter.d.ts","sourceRoot":"","sources":["../../src/scaffold-kb/chunk-splitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAgQnD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,GAAG,KAAK,EAAE,CAiFrD"}