@roarpeng/graphflow 1.9.16 → 1.12.1

package/dist/graph/knowledge-extraction.d.ts

@@ -0,0 +1,43 @@
+import type { GraphEdge, GraphNode } from "../core/types.js";
+export interface KnowledgeTurnRecord {
+    turnId: string;
+    query: string;
+    reply: string;
+}
+export interface KnowledgeDocumentInput {
+    text?: string;
+    turns?: KnowledgeTurnRecord[];
+}
+export type KnowledgeExtractionInput = string | KnowledgeTurnRecord | KnowledgeDocumentInput;
+export interface KnowledgeEvidence {
+    /** Offset within the containing document field, query, or reply. */
+    start: number;
+    end: number;
+    field?: "text" | "query" | "reply";
+    sourceTurnId?: string;
+}
+export interface KnowledgeGraphNodeMetadata {
+    domain: "doc";
+    kind: "concept" | "requirement";
+    confidence: number;
+    evidence: KnowledgeEvidence[];
+    sourceIds?: string[];
+    sourceTurnIds?: string[];
+    cue?: string;
+}
+export interface KnowledgeGraphFragment {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+}
+export interface KnowledgeExtractionOptions {
+    /** Existing graph source ID, normally `file:<relative-path>`. */
+    sourceNodeId?: string;
+}
+/**
+ * Extract deterministic Concept/Requirement fragments from dialogue or document text.
+ * No network access or model inference is involved.
+ */
+export declare function extractEngineeringKnowledgeGraphFragment(input: KnowledgeExtractionInput, options?: KnowledgeExtractionOptions): KnowledgeGraphFragment;
+/** Descriptive alias preferred by integrations that treat this as a graph adapter. */
+export declare const extractKnowledgeGraphFragment: typeof extractEngineeringKnowledgeGraphFragment;
+//# sourceMappingURL=knowledge-extraction.d.ts.map

package/dist/graph/knowledge-extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-extraction.d.ts","sourceRoot":"","sources":["../../src/graph/knowledge-extraction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,mBAAmB,GAAG,sBAAsB,CAAC;AAE7F,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,KAAK,CAAC;IACd,IAAI,EAAE,SAAS,GAAG,aAAa,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA8QD;;;GAGG;AACH,wBAAgB,wCAAwC,CACtD,KAAK,EAAE,wBAAwB,EAC/B,OAAO,GAAE,0BAA+B,GACvC,sBAAsB,CAwCxB;AAED,sFAAsF;AACtF,eAAO,MAAM,6BAA6B,iDAA2C,CAAC"}

package/dist/graph/knowledge-extraction.js

@@ -0,0 +1,274 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractKnowledgeGraphFragment = void 0;
+exports.extractEngineeringKnowledgeGraphFragment = extractEngineeringKnowledgeGraphFragment;
+const REQUIREMENT_CUES = [
+    { cue: "must", pattern: /\bmust(?:\s+not)?\b/i, confidence: 0.94 },
+    { cue: "shall", pattern: /\bshall(?:\s+not)?\b/i, confidence: 0.95 },
+    { cue: "required to", pattern: /\b(?:is\s+|are\s+)?required\s+to\b/i, confidence: 0.88 },
+    { cue: "needs to", pattern: /\bneeds?\s+to\b/i, confidence: 0.84 },
+    { cue: "should", pattern: /\bshould(?:\s+not)?\b/i, confidence: 0.82 },
+    { cue: "必须", pattern: /必须/, confidence: 0.94 },
+    { cue: "需要", pattern: /需要/, confidence: 0.86 },
+    { cue: "应当", pattern: /应当|应当不/, confidence: 0.86 },
+    { cue: "应该", pattern: /应该/, confidence: 0.8 },
+    { cue: "不得", pattern: /不得|不能/, confidence: 0.92 },
+];
+const TECHNICAL_HEADS = [
+    "api", "architecture", "cache", "client", "contract", "database", "design",
+    "engine", "extractor", "graph", "index", "indexer", "interface", "kernel",
+    "module", "parser", "pipeline", "protocol", "queue", "schema", "service",
+    "storage", "store", "system", "transport", "workflow",
+];
+const ENGLISH_STOP_WORDS = new Set([
+    "a", "all", "an", "and", "are", "as", "at", "be", "been", "but", "by",
+    "can", "could", "do", "does", "for", "from", "had", "has", "have", "how",
+    "i", "if", "in", "into", "is", "it", "its", "may", "might", "must", "need",
+    "needs", "not", "of", "on", "or", "our", "shall", "should", "so", "that",
+    "the", "their", "them", "then", "there", "these", "they", "this", "to",
+    "too", "was", "we", "were", "what", "when", "where", "which", "while",
+    "who", "why", "will", "with", "would", "you", "your",
+]);
+const CONCEPT_SUFFIXES = [
+    "系统", "模块", "接口", "服务", "协议", "缓存", "队列", "架构", "引擎",
+    "调度器", "数据库", "工作流", "管道", "图谱", "提取器", "设计",
+];
+function stableHash(value) {
+    let hash = 0x811c9dc5;
+    for (let index = 0; index < value.length; index += 1) {
+        hash ^= value.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193) >>> 0;
+    }
+    return hash.toString(36);
+}
+function nodeId(kind, value) {
+    const normalized = value.toLowerCase().replace(/\s+/g, " ").trim();
+    const asciiSlug = normalized
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 56)
+        .replace(/^-+|-+$/g, "");
+    const digest = stableHash(`${kind}:${normalized}`);
+    return `${kind}:${asciiSlug ? `${asciiSlug}-` : ""}${digest}`;
+}
+function normalizeCandidate(candidate) {
+    return candidate.replace(/[`'".,;:!?()\[\]{}<>]+$/g, "").replace(/^[`'"(\[{<]+/g, "").trim();
+}
+function isTechnicalCandidate(candidate) {
+    const value = normalizeCandidate(candidate);
+    if (!value)
+        return false;
+    if (/[\u4e00-\u9fff]/.test(value)) {
+        return CONCEPT_SUFFIXES.some((suffix) => value.endsWith(suffix));
+    }
+    const hasCodeShape = /[/_]|_|-/.test(value) ||
+        /^[A-Z][a-z0-9]+(?:[A-Z][a-z0-9]+)+/.test(value) ||
+        /^[A-Za-z][A-Za-z0-9_]*(?:\.[A-Z][A-Za-z0-9_]*)+$/.test(value);
+    const words = value.toLowerCase().split(/[\s/-]+/).filter(Boolean);
+    const hasDottedIdentifier = /^[A-Za-z][A-Za-z0-9_]*(?:\.[A-Za-z_][A-Za-z0-9_]*)+$/.test(value);
+    if (hasDottedIdentifier) {
+        return true;
+    }
+    if (words.some((word) => ENGLISH_STOP_WORDS.has(word))) {
+        // A stop word is acceptable inside an explicit code identifier, but not in prose phrases.
+        if (!hasCodeShape || /\s/.test(value.trim()))
+            return false;
+    }
+    return TECHNICAL_HEADS.includes(words.at(-1) ?? "");
+}
+function extractConceptsFromSegment(segment) {
+    const found = new Map();
+    const add = (raw, localStart, localEnd, confidence) => {
+        const name = normalizeCandidate(raw);
+        if (name.length < 2 || name.length > 100 || !isTechnicalCandidate(name))
+            return;
+        const previous = found.get(name.toLowerCase());
+        if (!previous || previous.confidence < confidence) {
+            found.set(name.toLowerCase(), {
+                name,
+                start: segment.start + localStart,
+                end: segment.start + localEnd,
+                confidence,
+            });
+        }
+    };
+    const patterns = [
+        { pattern: /`([^`\n]{2,100})`/g, confidence: 0.96 },
+        { pattern: /\b[A-Za-z][A-Za-z0-9_]*(?:\.[A-Za-z_][A-Za-z0-9_]*)+\b/g, confidence: 0.95 },
+        { pattern: /\b[A-Za-z][\w.-]*(?:\/[\w.-]+)+\b/g, confidence: 0.94 },
+        { pattern: /\b[a-z]+(?:[A-Z][a-zA-Z0-9]*)+\b|\b[A-Z][a-z0-9]+(?:[A-Z][a-z0-9]+)+\b/g, confidence: 0.94 },
+        { pattern: /\b[A-Za-z][A-Za-z0-9_-]*(?:_[A-Za-z0-9_-]+)+\b/g, confidence: 0.93 },
+        {
+            pattern: new RegExp(`\\b(?:[A-Za-z][A-Za-z0-9-]*(?:\\s+[A-Za-z][A-Za-z0-9-]*){0,3}\\s+(?:${TECHNICAL_HEADS.join("|")}))\\b`, "gi"),
+            confidence: 0.82,
+        },
+        {
+            pattern: new RegExp(`[\\u4e00-\\u9fff]{2,16}(?:${CONCEPT_SUFFIXES.join("|")})`, "g"),
+            confidence: 0.84,
+        },
+    ];
+    for (const { pattern, confidence } of patterns) {
+        pattern.lastIndex = 0;
+        let match;
+        while ((match = pattern.exec(segment.text)) !== null) {
+            const raw = match[1] ?? match[0];
+            const index = match.index + match[0].indexOf(raw);
+            add(raw, index, index + raw.length, confidence);
+            if (match.index === pattern.lastIndex)
+                pattern.lastIndex += 1;
+        }
+    }
+    return [...found.values()].sort((left, right) => left.start - right.start);
+}
+function* segments(text, offset = 0) {
+    let start = 0;
+    for (let index = 0; index < text.length; index += 1) {
+        const char = text[index];
+        const next = text.at(index + 1);
+        const boundary = char !== undefined &&
+            ".?!;。！？；".includes(char) &&
+            (next === undefined || /\s/.exec(next) !== null);
+        const isNewline = char === "\n";
+        if (!boundary && !isNewline && index < text.length - 1)
+            continue;
+        const raw = text.slice(start, isNewline ? index : index + 1);
+        const cleaned = raw.trim();
+        if (cleaned.length > 2) {
+            const relativeStart = raw.indexOf(cleaned);
+            yield {
+                text: cleaned,
+                start: offset + start + (relativeStart >= 0 ? relativeStart : 0),
+            };
+        }
+        start = index + 1;
+    }
+}
+function matchRequirementCue(text) {
+    let best;
+    for (const item of REQUIREMENT_CUES) {
+        if (item.pattern.test(text) && (best?.confidence ?? 0) < item.confidence) {
+            best = { cue: item.cue, confidence: item.confidence };
+        }
+    }
+    return best;
+}
+function pushEvidence(target, evidence) {
+    if (!target.some((item) => item.start === evidence.start &&
+        item.end === evidence.end &&
+        item.field === evidence.field &&
+        item.sourceTurnId === evidence.sourceTurnId)) {
+        target.push(evidence);
+    }
+}
+function processField(text, field, sourceTurnId, nodesByKind) {
+    if (!nodesByKind)
+        return;
+    for (const segment of segments(text)) {
+        const cue = matchRequirementCue(segment.text);
+        const concepts = extractConceptsFromSegment(segment);
+        if (cue) {
+            const id = nodeId("requirement", segment.text.slice(0, 500));
+            const existing = nodesByKind.requirement.get(id);
+            const evidence = {
+                start: segment.start,
+                end: segment.start + segment.text.length,
+                ...(field ? { field } : {}),
+                ...(sourceTurnId ? { sourceTurnId } : {}),
+            };
+            if (existing) {
+                const metadata = existing.metadata;
+                pushEvidence(metadata.evidence, evidence);
+                metadata.confidence = Math.max(metadata.confidence, cue.confidence + (concepts.length ? 0.03 : 0));
+                if (metadata.confidence === cue.confidence) {
+                    metadata.cue = cue.cue;
+                }
+            }
+            else {
+                nodesByKind.requirement.set(id, {
+                    id,
+                    type: "Requirement",
+                    content: segment.text.slice(0, 500),
+                    metadata: {
+                        domain: "doc",
+                        kind: "requirement",
+                        confidence: Math.min(0.98, cue.confidence + (concepts.length ? 0.03 : 0)),
+                        cue: cue.cue,
+                        evidence: [evidence],
+                    },
+                });
+            }
+        }
+        for (const concept of concepts) {
+            const id = nodeId("concept", concept.name);
+            const existing = nodesByKind.concept.get(id);
+            const evidence = {
+                start: concept.start,
+                end: concept.end,
+                ...(field ? { field } : {}),
+                ...(sourceTurnId ? { sourceTurnId } : {}),
+            };
+            if (existing) {
+                const metadata = existing.metadata;
+                pushEvidence(metadata.evidence, evidence);
+                metadata.confidence = Math.max(metadata.confidence, concept.confidence);
+            }
+            else {
+                nodesByKind.concept.set(id, {
+                    id,
+                    type: "Concept",
+                    content: concept.name,
+                    metadata: {
+                        domain: "doc",
+                        kind: "concept",
+                        confidence: concept.confidence,
+                        evidence: [evidence],
+                    },
+                });
+            }
+        }
+    }
+}
+/**
+ * Extract deterministic Concept/Requirement fragments from dialogue or document text.
+ * No network access or model inference is involved.
+ */
+function extractEngineeringKnowledgeGraphFragment(input, options = {}) {
+    const document = typeof input === "string"
+        ? { text: input }
+        : "turnId" in input
+            ? { turns: [input] }
+            : input;
+    const concepts = new Map();
+    const requirements = new Map();
+    const maps = { concept: concepts, requirement: requirements };
+    processField(document.text ?? "", "text", undefined, maps);
+    for (const turn of document.turns ?? []) {
+        const turnId = turn.turnId.trim();
+        processField(turn.query ?? "", "query", turnId || undefined, maps);
+        processField(turn.reply ?? "", "reply", turnId || undefined, maps);
+    }
+    const nodes = [...requirements.values(), ...concepts.values()];
+    const sourceIds = new Set(options.sourceNodeId ? [options.sourceNodeId] : []);
+    const edges = new Map();
+    for (const node of nodes) {
+        const metadata = node.metadata;
+        const turnIds = metadata.evidence
+            .map((item) => item.sourceTurnId)
+            .filter((item) => Boolean(item));
+        if (turnIds.length > 0)
+            metadata.sourceTurnIds = [...new Set(turnIds)];
+        for (const sourceId of sourceIds) {
+            edges.set(`${node.id}\u0000${sourceId}`, {
+                from: node.id,
+                to: sourceId,
+                relation: "derived_from",
+            });
+        }
+        if (sourceIds.size > 0)
+            metadata.sourceIds = [...sourceIds];
+    }
+    return { nodes, edges: [...edges.values()] };
+}
+/** Descriptive alias preferred by integrations that treat this as a graph adapter. */
+exports.extractKnowledgeGraphFragment = extractEngineeringKnowledgeGraphFragment;
+//# sourceMappingURL=knowledge-extraction.js.map

package/dist/graph/knowledge-extraction.js.map

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

package/dist/graph/token-savings.d.ts

@@ -62,4 +62,43 @@ export declare function resetSavingsStats(config: GraphFlowConfig): {
     path: string;
     reset: boolean;
 };
+export interface ContextFidelityRecordInput {
+    timestamp?: string;
+    query?: string;
+    expectedAnchorIds: string[];
+    returnedAnchorIds: string[];
+    /** Anchor id to the authoritative/source body that should have been packaged. */
+    expectedBodies?: Record<string, string>;
+    /** Anchor id to the body actually placed into the context package. */
+    packagedBodies?: Record<string, string>;
+    source?: "preview_context" | "run" | "evaluation";
+}
+export interface ContextFidelityRecord extends Required<Pick<ContextFidelityRecordInput, "timestamp" | "query" | "expectedAnchorIds" | "returnedAnchorIds">> {
+    expectedBodies?: Record<string, string>;
+    packagedBodies?: Record<string, string>;
+    anchorRecallAtK: number;
+    missingAnchorIds: string[];
+    /** Normalized LCS similarity over supplied bodies; undefined when no pair is measurable. */
+    bodyCoverage?: number;
+    source: NonNullable<ContextFidelityRecordInput["source"]>;
+}
+export interface ContextFidelityStats {
+    sampleCount: number;
+    averageAnchorRecallPercent: number;
+    averageBodyCoveragePercent: number;
+    totalExpectedAnchors: number;
+    totalReturnedAnchors: number;
+    totalMissingAnchors: number;
+    bodyCoverageSampleCount: number;
+    firstRecordAt: string | null;
+    lastRecordAt: string | null;
+    recentRecords: ContextFidelityRecord[];
+}
+export declare function recordContextFidelity(config: GraphFlowConfig, input: ContextFidelityRecordInput): ContextFidelityRecord;
+export declare function listContextFidelityRecords(config: GraphFlowConfig): ContextFidelityRecord[];
+export declare function getContextFidelityStats(config: GraphFlowConfig): ContextFidelityStats;
+export declare function resetContextFidelityStats(config: GraphFlowConfig): {
+    path: string;
+    reset: boolean;
+};
 //# sourceMappingURL=token-savings.d.ts.map

package/dist/graph/token-savings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-savings.d.ts","sourceRoot":"","sources":["../../src/graph/token-savings.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,yBAAyB,8DACuB,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,iBAAiB,GAAG,KAAK,CAAC;IAClC,iFAAiF;IACjF,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,aAAa,EAAE,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAMvC;AAuDD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAyBlF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,CAErE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAkB3F"}
+{"version":3,"file":"token-savings.d.ts","sourceRoot":"","sources":["../../src/graph/token-savings.ts"],"names":[],"mappings":"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"}

package/dist/graph/token-savings.js

@@ -5,6 +5,10 @@ exports.explainSavings = explainSavings;
 exports.recordSavings = recordSavings;
 exports.getSavingsStats = getSavingsStats;
 exports.resetSavingsStats = resetSavingsStats;
+exports.recordContextFidelity = recordContextFidelity;
+exports.listContextFidelityRecords = listContextFidelityRecords;
+exports.getContextFidelityStats = getContextFidelityStats;
+exports.resetContextFidelityStats = resetContextFidelityStats;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 /**
@@ -140,4 +144,138 @@ function resetSavingsStats(config) {
     saveStats(statsPath, empty);
     return { path: statsPath, reset: true };
 }
+function normalizeText(value) {
+    return value.replace(/\s+/g, " ").trim();
+}
+/**
+ * Longest-common-subsequence similarity. Unlike equality or a byte-length
+ * ratio, this measures how much of the normalized source survives while
+ * allowing reordering-free edits and never rewards unrelated padding.
+ */
+function calculateBodyCoverage(expected, packaged) {
+    const left = normalizeText(expected);
+    const right = normalizeText(packaged);
+    if (!left)
+        return !right ? 1 : 0;
+    if (!right)
+        return 0;
+    let previous = new Array(right.length + 1).fill(0);
+    let current = new Array(right.length + 1).fill(0);
+    for (let i = 1; i <= left.length; i += 1) {
+        for (let j = 1; j <= right.length; j += 1) {
+            current[j] = left[i - 1] === right[j - 1]
+                ? previous[j - 1] + 1
+                : Math.max(previous[j], current[j - 1]);
+        }
+        previous = current;
+        current = new Array(right.length + 1).fill(0);
+    }
+    return previous[right.length] / left.length;
+}
+function emptyContextFidelityStats() {
+    return {
+        sampleCount: 0,
+        averageAnchorRecallPercent: 0,
+        averageBodyCoveragePercent: 0,
+        totalExpectedAnchors: 0,
+        totalReturnedAnchors: 0,
+        totalMissingAnchors: 0,
+        bodyCoverageSampleCount: 0,
+        firstRecordAt: null,
+        lastRecordAt: null,
+        recentRecords: [],
+    };
+}
+function resolveFidelityPath(config) {
+    const root = config.graphPolicy.workspaceRoot ?? process.cwd();
+    return (0, node_path_1.join)(root, "graphflow-out", "context-fidelity.json");
+}
+function loadContextFidelityStats(fidelityPath) {
+    if (!(0, node_fs_1.existsSync)(fidelityPath))
+        return emptyContextFidelityStats();
+    try {
+        const parsed = JSON.parse((0, node_fs_1.readFileSync)(fidelityPath, "utf8"));
+        if (!Array.isArray(parsed.recentRecords))
+            return emptyContextFidelityStats();
+        return { ...emptyContextFidelityStats(), ...parsed, recentRecords: parsed.recentRecords };
+    }
+    catch {
+        return emptyContextFidelityStats();
+    }
+}
+function saveContextFidelityStats(fidelityPath, stats) {
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(fidelityPath), { recursive: true });
+    (0, node_fs_1.writeFileSync)(fidelityPath, JSON.stringify(stats, null, 2), "utf8");
+}
+function normalizeAnchorIds(values) {
+    return [...new Set(values.filter((value) => value.trim().length > 0))];
+}
+function recordContextFidelity(config, input) {
+    const expectedAnchorIds = normalizeAnchorIds(input.expectedAnchorIds);
+    const returnedAnchorIds = normalizeAnchorIds(input.returnedAnchorIds);
+    const returnedSet = new Set(returnedAnchorIds);
+    const missingAnchorIds = expectedAnchorIds.filter((id) => !returnedSet.has(id));
+    const anchorRecallAtK = expectedAnchorIds.length === 0
+        ? 1
+        : (expectedAnchorIds.length - missingAnchorIds.length) / expectedAnchorIds.length;
+    let bodyCoverageSum = 0;
+    let bodyCoverageCount = 0;
+    const expectedBodies = input.expectedBodies ?? {};
+    const packagedBodies = input.packagedBodies ?? {};
+    for (const [anchorId, expectedBody] of Object.entries(expectedBodies)) {
+        const packagedBody = packagedBodies[anchorId];
+        if (typeof packagedBody !== "string")
+            continue;
+        bodyCoverageSum += calculateBodyCoverage(expectedBody, packagedBody);
+        bodyCoverageCount += 1;
+    }
+    const stored = {
+        timestamp: input.timestamp ?? new Date().toISOString(),
+        query: input.query ?? "",
+        expectedAnchorIds,
+        returnedAnchorIds,
+        ...(input.expectedBodies ? { expectedBodies } : {}),
+        ...(input.packagedBodies ? { packagedBodies } : {}),
+        anchorRecallAtK,
+        missingAnchorIds,
+        ...(bodyCoverageCount > 0 ? { bodyCoverage: bodyCoverageSum / bodyCoverageCount } : {}),
+        source: input.source ?? "evaluation",
+    };
+    const fidelityPath = resolveFidelityPath(config);
+    const stats = loadContextFidelityStats(fidelityPath);
+    const nextRecallTotal = stats.averageAnchorRecallPercent * stats.sampleCount + anchorRecallAtK * 100;
+    const nextCoverageTotal = stats.averageBodyCoveragePercent * stats.bodyCoverageSampleCount +
+        (stored.bodyCoverage ?? 0) * 100;
+    const nextSampleCount = stats.sampleCount + 1;
+    const nextCoverageSampleCount = stats.bodyCoverageSampleCount + (bodyCoverageCount > 0 ? 1 : 0);
+    stats.sampleCount = nextSampleCount;
+    stats.averageAnchorRecallPercent = Math.round(nextRecallTotal / nextSampleCount);
+    stats.bodyCoverageSampleCount = nextCoverageSampleCount;
+    stats.averageBodyCoveragePercent =
+        nextCoverageSampleCount === 0 ? 0 : Math.round(nextCoverageTotal / nextCoverageSampleCount);
+    stats.totalExpectedAnchors += expectedAnchorIds.length;
+    stats.totalReturnedAnchors += returnedAnchorIds.length;
+    stats.totalMissingAnchors += missingAnchorIds.length;
+    stats.firstRecordAt = stats.firstRecordAt ?? stored.timestamp;
+    stats.lastRecordAt = stored.timestamp;
+    stats.recentRecords.unshift(stored);
+    if (stats.recentRecords.length > MAX_RECENT_RECORDS) {
+        stats.recentRecords = stats.recentRecords.slice(0, MAX_RECENT_RECORDS);
+    }
+    saveContextFidelityStats(fidelityPath, stats);
+    return stored;
+}
+function listContextFidelityRecords(config) {
+    return loadContextFidelityStats(resolveFidelityPath(config)).recentRecords;
+}
+function getContextFidelityStats(config) {
+    return loadContextFidelityStats(resolveFidelityPath(config));
+}
+function resetContextFidelityStats(config) {
+    const fidelityPath = resolveFidelityPath(config);
+    if (!(0, node_fs_1.existsSync)(fidelityPath))
+        return { path: fidelityPath, reset: false };
+    saveContextFidelityStats(fidelityPath, emptyContextFidelityStats());
+    return { path: fidelityPath, reset: true };
+}
 //# sourceMappingURL=token-savings.js.map

package/dist/graph/token-savings.js.map

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

package/dist/learning/canary-gate.d.ts

@@ -25,13 +25,17 @@ export interface GateSkillPromotionOptions {
     localSuccesses: number;
     validated?: boolean;
     minLocalSuccesses?: number;
+    /** 绑定且 outcome=pass 的去重 episode 数（真实成功证据链，透传准入门）。 */
+    successCount?: number;
     /** When set, proven is held at correctable unless the held-out admission gate passes. */
     skillName?: string;
 }
 /**
  * Gate proven promotion for external skills and the held-out admission gate.
  * Other classes pass through. Proven is held at correctable until canaryPassed
- * and (when skillName is provided) admitSkillToProven.
+ * and (when skillName is provided) admitSkillToProven. Real success evidence
+ * (successCount >= threshold) bypasses the golden-overlap veto inside the
+ * admission gate — see skill-admission.
  */
 export declare function gateSkillPromotion(options: GateSkillPromotionOptions): SkillOutcomeKind;
 /**

package/dist/learning/canary-gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canary-gate.d.ts","sourceRoot":"","sources":["../../src/learning/canary-gate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAG1E,iFAAiF;AACjF,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD,wBAAgB,qBAAqB,CAAC,UAAU,CAAC,EAAE,eAAe,GAAG,OAAO,CAG3E;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,mFAAmF;IACnF,cAAc,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAS7D;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,gBAAgB,CAmBvF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,KAAK,CAEnD"}
+{"version":3,"file":"canary-gate.d.ts","sourceRoot":"","sources":["../../src/learning/canary-gate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAG1E,iFAAiF;AACjF,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD,wBAAgB,qBAAqB,CAAC,UAAU,CAAC,EAAE,eAAe,GAAG,OAAO,CAG3E;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,mFAAmF;IACnF,cAAc,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAS7D;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,gBAAgB,CAqBvF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,KAAK,CAEnD"}

package/dist/learning/canary-gate.js

@@ -33,7 +33,9 @@ function canaryPassed(input) {
 /**
  * Gate proven promotion for external skills and the held-out admission gate.
  * Other classes pass through. Proven is held at correctable until canaryPassed
- * and (when skillName is provided) admitSkillToProven.
+ * and (when skillName is provided) admitSkillToProven. Real success evidence
+ * (successCount >= threshold) bypasses the golden-overlap veto inside the
+ * admission gate — see skill-admission.
  */
 function gateSkillPromotion(options) {
     if (options.outcomeKind !== "proven") {
@@ -50,7 +52,8 @@ function gateSkillPromotion(options) {
     if (!canaryPassed(check)) {
         return "correctable";
     }
-    if (options.skillName && !(0, skill_admission_js_1.admitSkillToProven)(options.skillName).ok) {
+    const admitOptions = options.successCount !== undefined ? { successCount: options.successCount } : undefined;
+    if (options.skillName && !(0, skill_admission_js_1.admitSkillToProven)(options.skillName, admitOptions).ok) {
         return "correctable";
     }
     return "proven";

package/dist/learning/canary-gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"canary-gate.js","sourceRoot":"","sources":["../../src/learning/canary-gate.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAQH,sDAGC;AAYD,oCASC;AAiBD,gDAmBC;AAMD,kEAEC;AAzED,6DAA0D;AAE1D,iFAAiF;AACpE,QAAA,8BAA8B,GAAG,CAAC,CAAC;AAEhD,SAAgB,qBAAqB,CAAC,UAA4B;IAChE,MAAM,MAAM,GAAG,UAAU,EAAE,MAAM,IAAI,OAAO,CAAC;IAC7C,OAAO,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ,CAAC;AAClD,CAAC;AAWD,mFAAmF;AACnF,SAAgB,YAAY,CAAC,KAAuB;IAClD,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,iBAAiB,IAAI,sCAA8B,CAAC;IACvE,OAAO,KAAK,CAAC,cAAc,IAAI,IAAI,CAAC;AACtC,CAAC;AAYD;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,OAAkC;IACnE,IAAI,OAAO,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,OAAO,CAAC,WAAW,CAAC;IAC7B,CAAC;IACD,MAAM,KAAK,GAAqB;QAC9B,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,GAAG,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS;YACzC,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE;YAClD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,IAAA,uCAAkB,EAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC;QACnE,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAgB,2BAA2B;IACzC,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"canary-gate.js","sourceRoot":"","sources":["../../src/learning/canary-gate.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAQH,sDAGC;AAYD,oCASC;AAqBD,gDAqBC;AAMD,kEAEC;AA/ED,6DAA0D;AAE1D,iFAAiF;AACpE,QAAA,8BAA8B,GAAG,CAAC,CAAC;AAEhD,SAAgB,qBAAqB,CAAC,UAA4B;IAChE,MAAM,MAAM,GAAG,UAAU,EAAE,MAAM,IAAI,OAAO,CAAC;IAC7C,OAAO,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ,CAAC;AAClD,CAAC;AAWD,mFAAmF;AACnF,SAAgB,YAAY,CAAC,KAAuB;IAClD,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,iBAAiB,IAAI,sCAA8B,CAAC;IACvE,OAAO,KAAK,CAAC,cAAc,IAAI,IAAI,CAAC;AACtC,CAAC;AAcD;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAC,OAAkC;IACnE,IAAI,OAAO,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,OAAO,CAAC,WAAW,CAAC;IAC7B,CAAC;IACD,MAAM,KAAK,GAAqB;QAC9B,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,GAAG,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS;YACzC,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE;YAClD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,MAAM,YAAY,GAChB,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,IAAA,uCAAkB,EAAC,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,EAAE,EAAE,CAAC;QACjF,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAgB,2BAA2B;IACzC,OAAO,KAAK,CAAC;AACf,CAAC"}