@wanshi-kg/wanshi 0.1.0

package/dist/core/processor/readers/referenceExtraction.js.map

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

package/dist/core/processor/readers/stripReferences.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * Trailing references/bibliography quarantine (academic-paper hygiene).
+ *
+ * Bibliography text extracted as content turns citation titles into observations
+ * and author surnames into garbage person-entities tangled into nonsense relations
+ * (`B. Thirion has_attribute red pepper`). These helpers split the references
+ * section off BEFORE chunking/extraction; the tail is dropped, not extracted.
+ *
+ * Heuristic: the LAST line that is a references-style heading, located in the
+ * final 40% of the document — early "References" mentions (e.g. a section that
+ * discusses related work) are never treated as the bibliography.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitTrailingReferences = splitTrailingReferences;
+exports.splitPagesAtReferences = splitPagesAtReferences;
+const REF_HEADING = /^(?:#{1,6}\s*)?(?:[\divxlc]+\.?\s+)?(references|bibliography|works cited)\s*:?\s*$/i;
+/** Split plain/markdown text at the trailing references heading. */
+function splitTrailingReferences(text) {
+    const lines = text.split("\n");
+    const earliest = Math.floor(lines.length * 0.6);
+    for (let i = lines.length - 1; i >= earliest; i--) {
+        if (REF_HEADING.test(lines[i].trim())) {
+            return {
+                body: lines.slice(0, i).join("\n"),
+                references: lines.slice(i).join("\n"),
+            };
+        }
+    }
+    return { body: text };
+}
+/**
+ * Page-array variant (PDF readers): truncate the page containing the trailing
+ * references heading and drop all subsequent pages.
+ */
+function splitPagesAtReferences(pages) {
+    const totalChars = pages.reduce((acc, p) => acc + p.length, 0);
+    const earliestChar = totalChars * 0.6;
+    let offset = totalChars;
+    for (let p = pages.length - 1; p >= 0; p--) {
+        offset -= pages[p].length;
+        const lines = pages[p].split("\n");
+        for (let i = lines.length - 1; i >= 0; i--) {
+            if (!REF_HEADING.test(lines[i].trim()))
+                continue;
+            const headingChar = offset + lines.slice(0, i).join("\n").length;
+            if (headingChar < earliestChar)
+                continue;
+            const body = lines.slice(0, i).join("\n");
+            const tail = [lines.slice(i).join("\n"), ...pages.slice(p + 1)].join("\n");
+            const kept = [...pages.slice(0, p)];
+            if (body.trim().length > 0)
+                kept.push(body);
+            return { pages: kept, references: tail };
+        }
+    }
+    return { pages };
+}
+//# sourceMappingURL=stripReferences.js.map

package/dist/core/processor/readers/stripReferences.js.map

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

package/dist/core/processor/readers/transcript/turnPacking.js

@@ -0,0 +1,81 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderTurn = renderTurn;
+exports.packTurns = packTurns;
+/** Render a turn with its inline speaker label (`speaker: text`). */
+function renderTurn(turn) {
+    return `${turn.speaker}: ${turn.text}`;
+}
+/**
+ * Pack consecutive turns into chunks up to `maxChunkSize` (regardless of
+ * speaker), rendering each turn inline as `speaker: text`. Provenance carries
+ * the speaker only when a chunk turns out to be single-speaker; a turn longer
+ * than the budget on its own is split with the label kept on every piece.
+ *
+ * Shared by `TranscriptReader` (parsed transcript files) and `AudioReader`'s
+ * dual-STT engine (turns emitted by the vendored Python pipeline) so both
+ * produce identical speaker-stamped chunk provenance.
+ */
+function packTurns(turns, sourcePath, maxChunkSize, chunker) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const SEP = "\n\n";
+        const chunks = [];
+        let buf = [];
+        const renderLen = (t) => renderTurn(t).length;
+        const bufLen = () => buf.reduce((n, t) => n + renderLen(t) + SEP.length, 0);
+        const flush = () => {
+            var _a;
+            if (buf.length === 0)
+                return;
+            const speakers = new Set(buf.map((t) => t.speaker));
+            const occurredAt = (_a = buf.find((t) => t.occurredAt)) === null || _a === void 0 ? void 0 : _a.occurredAt;
+            const text = buf.map((t) => renderTurn(t)).join(SEP).trim();
+            const provenance = Object.assign(Object.assign({ source: sourcePath }, (speakers.size === 1 && { speaker: buf[0].speaker })), (occurredAt && { occurredAt }));
+            chunks.push({ content: text, index: 0, totalChunks: 0, startOffset: 0, endOffset: text.length, provenance });
+            buf = [];
+        };
+        // Split a single oversized turn, keeping its speaker label on each piece.
+        const flushOversized = (turn) => __awaiter(this, void 0, void 0, function* () {
+            const provenance = Object.assign({ source: sourcePath, speaker: turn.speaker }, (turn.occurredAt && { occurredAt: turn.occurredAt }));
+            for (const p of yield chunker.chunk(turn.text)) {
+                const content = `${turn.speaker}: ${p.content}`;
+                chunks.push({ content, index: 0, totalChunks: 0, startOffset: p.startOffset, endOffset: p.endOffset, provenance });
+            }
+        });
+        for (const turn of turns) {
+            if (!turn.text)
+                continue;
+            // Conversation boundary (KG-10): a chat export's conversations must never
+            // share a chunk, so flush before a turn from a different conversation —
+            // regardless of remaining budget — keeping validAt/speaker per-conversation.
+            if (buf.length > 0 && buf[buf.length - 1].conversation !== turn.conversation) {
+                flush();
+            }
+            if (renderLen(turn) > maxChunkSize) {
+                flush();
+                yield flushOversized(turn);
+                continue;
+            }
+            if (buf.length > 0 && bufLen() + renderLen(turn) + SEP.length > maxChunkSize) {
+                flush();
+            }
+            buf.push(turn);
+        }
+        flush();
+        chunks.forEach((c, i) => {
+            c.index = i + 1;
+            c.totalChunks = chunks.length;
+        });
+        return chunks;
+    });
+}
+//# sourceMappingURL=turnPacking.js.map

package/dist/core/processor/readers/transcript/turnPacking.js.map

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

package/dist/core/progress/NdjsonProgressEmitter.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NdjsonProgressEmitter = void 0;
+/**
+ * Emits each progress event as a single newline-delimited JSON object on a
+ * writable stream (stdout by default). Lines are wrapped in an envelope with a
+ * `channel` discriminator so the same stream can also carry log lines
+ * (`channel: "log"`, written by the logger in NDJSON mode) — a consumer reading
+ * the stream demuxes the two by `channel`.
+ *
+ *   {"channel":"progress","ts":1717600000000,"event":{"type":"file_start",...}}
+ *
+ * Writes are best-effort and never throw, so a broken pipe (consumer went away)
+ * can't take down a run.
+ */
+class NdjsonProgressEmitter {
+    constructor(stream = process.stdout) {
+        this.stream = stream;
+    }
+    emit(event) {
+        try {
+            this.stream.write(JSON.stringify({ channel: "progress", ts: Date.now(), event }) + "\n");
+        }
+        catch (_a) {
+            // side-channel only — swallow write errors (e.g. EPIPE)
+        }
+    }
+}
+exports.NdjsonProgressEmitter = NdjsonProgressEmitter;
+//# sourceMappingURL=NdjsonProgressEmitter.js.map

package/dist/core/progress/NdjsonProgressEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NdjsonProgressEmitter.js","sourceRoot":"","sources":["../../../src/core/progress/NdjsonProgressEmitter.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;GAWG;AACH,MAAa,qBAAqB;IAChC,YAA6B,SAAgC,OAAO,CAAC,MAAM;QAA9C,WAAM,GAAN,MAAM,CAAwC;IAAG,CAAC;IAE/E,IAAI,CAAC,KAAoB;QACvB,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CACtE,CAAC;QACJ,CAAC;QAAC,WAAM,CAAC;YACP,wDAAwD;QAC1D,CAAC;IACH,CAAC;CACF;AAZD,sDAYC"}

package/dist/core/progress/NoopProgressEmitter.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoopProgressEmitter = void 0;
+/**
+ * Default progress emitter: discards every event. Used whenever structured
+ * progress isn't requested, so the normal CLI path has zero overhead and
+ * unchanged behavior.
+ */
+class NoopProgressEmitter {
+    emit() {
+        // intentionally empty
+    }
+}
+exports.NoopProgressEmitter = NoopProgressEmitter;
+//# sourceMappingURL=NoopProgressEmitter.js.map

package/dist/core/progress/NoopProgressEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoopProgressEmitter.js","sourceRoot":"","sources":["../../../src/core/progress/NoopProgressEmitter.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAa,mBAAmB;IAC9B,IAAI;QACF,sBAAsB;IACxB,CAAC;CACF;AAJD,kDAIC"}

package/dist/core/progress/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./NoopProgressEmitter"), exports);
+__exportStar(require("./NdjsonProgressEmitter"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/progress/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/progress/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,0DAAwC"}

package/dist/core/trace/TraceWriter.js

@@ -0,0 +1,100 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trace = exports.TraceWriter = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const events_1 = require("./events");
+const lineage_1 = require("./lineage");
+/**
+ * The debug trace sidecar writer — a module singleton (à la `shared/shutdown.ts`
+ * and `vocabulary.ts`'s domain-gate) so every pipeline stage can `trace.emit(...)`
+ * without re-plumbing the DI graph. `ContainerFactory` calls `configure` once.
+ *
+ * Append-only JSONL (`<output>.trace.jsonl`), mirroring `CheckpointService`:
+ * parent-dir ensured on first write, best-effort, **never throws** — a trace I/O
+ * failure must not take down (or alter) a run. Off by default ⇒ `emit` is an
+ * early return and call sites guard rich payloads with `if (trace.enabled)`, so a
+ * default run carries zero overhead and is byte-identical.
+ */
+class TraceWriter {
+    constructor() {
+        this._enabled = false;
+        this.runId = "";
+        this.seq = 0;
+        this.dirEnsured = false;
+        /** Run-scoped lineage index (mention IDs live here, never on the graph). */
+        this.lineage = new lineage_1.LineageRegistry();
+    }
+    get enabled() {
+        return this._enabled;
+    }
+    configure(config) {
+        this._enabled = config.enabled && !!config.path;
+        this.outputPath = config.path;
+        this.runId = config.runId;
+        this.seq = 0;
+        this.dirEnsured = false;
+        this.lineage.reset();
+    }
+    emit(event) {
+        if (!this._enabled || !this.outputPath)
+            return;
+        const record = Object.assign({ v: events_1.TRACE_VERSION, runId: this.runId, ts: new Date().toISOString(), seq: this.seq++ }, event);
+        try {
+            if (!this.dirEnsured) {
+                fs.mkdirSync(path.dirname(this.outputPath), { recursive: true });
+                this.dirEnsured = true;
+            }
+            fs.appendFileSync(this.outputPath, JSON.stringify(record) + "\n");
+        }
+        catch (_a) {
+            // Best-effort side channel — swallow (e.g. ENOSPC/EPIPE) so the run is unaffected.
+        }
+    }
+    /** Test/reset hook — restore the disabled default + clear lineage. */
+    reset() {
+        this._enabled = false;
+        this.outputPath = undefined;
+        this.runId = "";
+        this.seq = 0;
+        this.dirEnsured = false;
+        this.lineage.reset();
+    }
+}
+exports.TraceWriter = TraceWriter;
+/** The process-wide trace singleton. */
+exports.trace = new TraceWriter();
+//# sourceMappingURL=TraceWriter.js.map

package/dist/core/trace/TraceWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TraceWriter.js","sourceRoot":"","sources":["../../../src/core/trace/TraceWriter.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAC7B,qCAAkE;AAClE,uCAA4C;AAQ5C;;;;;;;;;;GAUG;AACH,MAAa,WAAW;IAAxB;QACU,aAAQ,GAAG,KAAK,CAAC;QAEjB,UAAK,GAAG,EAAE,CAAC;QACX,QAAG,GAAG,CAAC,CAAC;QACR,eAAU,GAAG,KAAK,CAAC;QAC3B,4EAA4E;QACnE,YAAO,GAAG,IAAI,yBAAe,EAAE,CAAC;IA4C3C,CAAC;IA1CC,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,SAAS,CAAC,MAAmB;QAC3B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QAChD,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACb,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,IAAI,CAAC,KAAiB;QACpB,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,OAAO;QAC/C,MAAM,MAAM,mBACV,CAAC,EAAE,sBAAa,EAChB,KAAK,EAAE,IAAI,CAAC,KAAK,EACjB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAC5B,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IACZ,KAAK,CACT,CAAC;QACF,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACrB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACjE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACzB,CAAC;YACD,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;QACpE,CAAC;QAAC,WAAM,CAAC;YACP,mFAAmF;QACrF,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,KAAK;QACH,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACb,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF;AAnDD,kCAmDC;AAED,wCAAwC;AAC3B,QAAA,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC"}

package/dist/core/trace/events.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRACE_VERSION = void 0;
+/**
+ * Debug trace event taxonomy. One `type` per pipeline decision point. Every event
+ * is wrapped by `TraceWriter` in an envelope (`v`/`runId`/`ts`/`seq`) before it
+ * hits the JSONL sidecar — these interfaces describe the per-event *payload*.
+ *
+ * Bump TRACE_VERSION whenever an event's shape changes (same discipline as the
+ * checkpoint key / prompt version) so a future inspector can branch on it.
+ */
+exports.TRACE_VERSION = 1;
+//# sourceMappingURL=events.js.map

package/dist/core/trace/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/core/trace/events.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACU,QAAA,aAAa,GAAG,CAAC,CAAC"}

package/dist/core/trace/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./events"), exports);
+__exportStar(require("./lineage"), exports);
+__exportStar(require("./TraceWriter"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/trace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/trace/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,4CAA0B;AAC1B,gDAA8B"}

package/dist/core/trace/lineage.js

@@ -0,0 +1,97 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LineageRegistry = void 0;
+const crypto = __importStar(require("crypto"));
+const sha8 = (s) => crypto.createHash("sha1").update(s).digest("hex").slice(0, 8);
+/**
+ * Run-scoped lineage index that lives **entirely outside** the knowledge graph —
+ * nothing here is ever written onto an `Entity`/`Observation`/`Relation` or any
+ * export, so the serialized graph is byte-identical whether tracing is on or off
+ * (the observe-only gate holds by construction).
+ *
+ * It mints deterministic, reconstructable IDs and tracks, per entity NAME, the
+ * list of pre-merge mention instances. As the merger folds one name into another
+ * (`fold`), the loser's mentions are reattributed to the winner — so a final
+ * canonical node's full set of contributing mentions is `mentionsFor(canonical)`.
+ */
+class LineageRegistry {
+    constructor() {
+        this.byName = new Map();
+    }
+    static entityMentionId(extractionId, name) {
+        return `${extractionId}|e|${name}`;
+    }
+    static observationId(extractionId, name, text) {
+        return `${extractionId}|o|${sha8(`${name}␟${text}`)}`;
+    }
+    static relationMentionId(extractionId, from, to) {
+        return `${extractionId}|r|${from}>${to}`;
+    }
+    /** Record one entity mention under its name; returns the minted ref. */
+    registerEntity(ref) {
+        const list = this.byName.get(ref.name);
+        if (list)
+            list.push(ref);
+        else
+            this.byName.set(ref.name, [ref]);
+        return ref;
+    }
+    /** Reassign the loser name's mentions onto the winner (a merge fusion). */
+    fold(loserName, winnerName) {
+        var _a, _b;
+        if (loserName === winnerName)
+            return [];
+        const losers = (_a = this.byName.get(loserName)) !== null && _a !== void 0 ? _a : [];
+        if (losers.length === 0)
+            return [];
+        const winners = (_b = this.byName.get(winnerName)) !== null && _b !== void 0 ? _b : [];
+        this.byName.set(winnerName, winners.concat(losers));
+        this.byName.delete(loserName);
+        return losers;
+    }
+    mentionsFor(name) {
+        var _a;
+        return (_a = this.byName.get(name)) !== null && _a !== void 0 ? _a : [];
+    }
+    mentionIdsFor(name) {
+        return this.mentionsFor(name).map((m) => m.mentionId);
+    }
+    reset() {
+        this.byName.clear();
+    }
+}
+exports.LineageRegistry = LineageRegistry;
+//# sourceMappingURL=lineage.js.map

package/dist/core/trace/lineage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineage.js","sourceRoot":"","sources":["../../../src/core/trace/lineage.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+CAAiC;AAYjC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE1F;;;;;;;;;;GAUG;AACH,MAAa,eAAe;IAA5B;QACU,WAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IA0CnD,CAAC;IAxCC,MAAM,CAAC,eAAe,CAAC,YAAoB,EAAE,IAAY;QACvD,OAAO,GAAG,YAAY,MAAM,IAAI,EAAE,CAAC;IACrC,CAAC;IACD,MAAM,CAAC,aAAa,CAAC,YAAoB,EAAE,IAAY,EAAE,IAAY;QACnE,OAAO,GAAG,YAAY,MAAM,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;IACxD,CAAC;IACD,MAAM,CAAC,iBAAiB,CAAC,YAAoB,EAAE,IAAY,EAAE,EAAU;QACrE,OAAO,GAAG,YAAY,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;IAC3C,CAAC;IAED,wEAAwE;IACxE,cAAc,CAAC,GAAe;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;;YACpB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,2EAA2E;IAC3E,IAAI,CAAC,SAAiB,EAAE,UAAkB;;QACxC,IAAI,SAAS,KAAK,UAAU;YAAE,OAAO,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAA,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,mCAAI,EAAE,CAAC;QAChD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,MAAA,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,mCAAI,EAAE,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,WAAW,CAAC,IAAY;;QACtB,OAAO,MAAA,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,mCAAI,EAAE,CAAC;IACrC,CAAC;IAED,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF;AA3CD,0CA2CC"}