wiki-graph-core 0.3.1 → 0.4.0

package/dist/graph/reading-build/index.js

@@ -0,0 +1,4 @@
+export * from "./artifact.js";
+export * from "./input.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/graph/reading-build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/graph/reading-build/index.ts"],"sourcesContent":["export * from \"./artifact.js\";\nexport * from \"./input.js\";\nexport * from \"./types.js\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/graph/reading-build/input.d.ts

@@ -0,0 +1,32 @@
+import { ReadonlyDocument } from '../../document/directory/types.js';
+import { ChapterDetails } from '../../document/chapter/types.js';
+import '../../text/source/meta.js';
+import 'zod';
+import '../../text/source/toc.js';
+import '../../text/source/types.js';
+import '../../document/database.js';
+import 'sqlite3';
+import '../../document/types.js';
+import '../../document/text-streams/serial.js';
+import '../../document/text-streams/draft.js';
+import '../../document/text-streams/types.js';
+import '../../document/stores/chunk.js';
+import '../../document/stores/types.js';
+import '../../document/stores/fragment-group.js';
+import '../../document/stores/graph-build-parameter.js';
+import '../../document/stores/mention-link.js';
+import '../../document/stores/mention.js';
+import '../../document/stores/object-metadata.js';
+import '../../document/stores/reading-edge.js';
+import '../../document/stores/serial.js';
+import '../../document/stores/snake/chunk.js';
+import '../../document/stores/snake/core.js';
+import '../../document/stores/snake/edge.js';
+
+declare function readChapterBuildInput(document: ReadonlyDocument, chapterId: number): Promise<{
+    readonly details: ChapterDetails;
+    readonly revision: number;
+    readonly sourceText: readonly string[];
+}>;
+
+export { readChapterBuildInput };

package/dist/graph/reading-build/input.js

@@ -0,0 +1,19 @@
+import {
+  getChapterDetails
+} from "../../document/chapter/index.js";
+import {
+  collectReaderText,
+  readChapterSource
+} from "../../text/summary-build/index.js";
+async function readChapterBuildInput(document, chapterId) {
+  const details = await getChapterDetails(document, chapterId);
+  return {
+    details,
+    revision: await document.serials.getRevision(chapterId),
+    sourceText: await collectReaderText(readChapterSource(document, chapterId))
+  };
+}
+export {
+  readChapterBuildInput
+};
+//# sourceMappingURL=input.js.map

package/dist/graph/reading-build/input.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/graph/reading-build/input.ts"],"sourcesContent":["import type { ReadonlyDocument } from \"../../document/index.js\";\nimport {\n  getChapterDetails,\n  type ChapterDetails,\n} from \"../../document/chapter/index.js\";\nimport {\n  collectReaderText,\n  readChapterSource,\n} from \"../../text/summary-build/index.js\";\n\nexport async function readChapterBuildInput(\n  document: ReadonlyDocument,\n  chapterId: number,\n): Promise<{\n  readonly details: ChapterDetails;\n  readonly revision: number;\n  readonly sourceText: readonly string[];\n}> {\n  const details = await getChapterDetails(document, chapterId);\n\n  return {\n    details,\n    revision: await document.serials.getRevision(chapterId),\n    sourceText: await collectReaderText(readChapterSource(document, chapterId)),\n  };\n}\n"],"mappings":"AACA;AAAA,EACE;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAEP,eAAsB,sBACpB,UACA,WAKC;AACD,QAAM,UAAU,MAAM,kBAAkB,UAAU,SAAS;AAE3D,SAAO;AAAA,IACL;AAAA,IACA,UAAU,MAAM,SAAS,QAAQ,YAAY,SAAS;AAAA,IACtD,YAAY,MAAM,kBAAkB,kBAAkB,UAAU,SAAS,CAAC;AAAA,EAC5E;AACF;","names":[]}

package/dist/graph/reading-build/options.d.ts

@@ -0,0 +1,47 @@
+import { BuildSerialTopologyOptions } from '../../text/serial/options.js';
+import { GraphBuildParameterInput } from './types.js';
+import '../../runtime/common/language.js';
+import '../../runtime/common/llm-scope.js';
+import '../../document/directory/types.js';
+import '../../text/source/meta.js';
+import 'zod';
+import '../../text/source/toc.js';
+import '../../text/source/types.js';
+import '../../document/database.js';
+import 'sqlite3';
+import '../../document/types.js';
+import '../../document/text-streams/serial.js';
+import '../../document/text-streams/draft.js';
+import '../../document/text-streams/types.js';
+import '../../document/stores/chunk.js';
+import '../../document/stores/types.js';
+import '../../document/stores/fragment-group.js';
+import '../../document/stores/graph-build-parameter.js';
+import '../../document/stores/mention-link.js';
+import '../../document/stores/mention.js';
+import '../../document/stores/object-metadata.js';
+import '../../document/stores/reading-edge.js';
+import '../../document/stores/serial.js';
+import '../../document/stores/snake/chunk.js';
+import '../../document/stores/snake/core.js';
+import '../../document/stores/snake/edge.js';
+import '../../external/llm/client/core.js';
+import '../../external/llm/context.js';
+import '../../external/llm/cache.js';
+import '../../external/llm/types.js';
+import 'ai';
+import '../../text/reader/types.js';
+import '../../text/reader/attention/core.js';
+import '../../text/reader/chunk-batch/types.js';
+import '../../text/reader/segment/types.js';
+
+declare function createTopologyOptions(options: {
+    readonly extractionPrompt?: string;
+    readonly userLanguage?: BuildSerialTopologyOptions["userLanguage"];
+}): BuildSerialTopologyOptions;
+declare function createGraphBuildParameterInput(options: {
+    readonly extractionPrompt?: string;
+    readonly userLanguage?: BuildSerialTopologyOptions["userLanguage"];
+}): GraphBuildParameterInput;
+
+export { createGraphBuildParameterInput, createTopologyOptions };

package/dist/graph/reading-build/options.js

@@ -0,0 +1,20 @@
+import { normalizeLanguageCode } from "../../runtime/common/language.js";
+import { resolveExtractionPrompt } from "../../runtime/common/prompts.js";
+function createTopologyOptions(options) {
+  return {
+    extractionPrompt: resolveExtractionPrompt(options.extractionPrompt),
+    ...options.userLanguage === void 0 ? {} : { userLanguage: options.userLanguage }
+  };
+}
+function createGraphBuildParameterInput(options) {
+  const language = normalizeLanguageCode(options.userLanguage);
+  return {
+    ...language === void 0 ? {} : { language },
+    prompt: resolveExtractionPrompt(options.extractionPrompt)
+  };
+}
+export {
+  createGraphBuildParameterInput,
+  createTopologyOptions
+};
+//# sourceMappingURL=options.js.map

package/dist/graph/reading-build/options.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/graph/reading-build/options.ts"],"sourcesContent":["import { normalizeLanguageCode } from \"../../runtime/common/language.js\";\nimport { resolveExtractionPrompt } from \"../../runtime/common/prompts.js\";\nimport type { BuildSerialTopologyOptions } from \"../../serial.js\";\nimport type { GraphBuildParameterInput } from \"./types.js\";\n\nexport function createTopologyOptions(options: {\n  readonly extractionPrompt?: string;\n  readonly userLanguage?: BuildSerialTopologyOptions[\"userLanguage\"];\n}): BuildSerialTopologyOptions {\n  return {\n    extractionPrompt: resolveExtractionPrompt(options.extractionPrompt),\n    ...(options.userLanguage === undefined\n      ? {}\n      : { userLanguage: options.userLanguage }),\n  };\n}\n\nexport function createGraphBuildParameterInput(options: {\n  readonly extractionPrompt?: string;\n  readonly userLanguage?: BuildSerialTopologyOptions[\"userLanguage\"];\n}): GraphBuildParameterInput {\n  const language = normalizeLanguageCode(options.userLanguage);\n\n  return {\n    ...(language === undefined ? {} : { language }),\n    prompt: resolveExtractionPrompt(options.extractionPrompt),\n  };\n}\n"],"mappings":"AAAA,SAAS,6BAA6B;AACtC,SAAS,+BAA+B;AAIjC,SAAS,sBAAsB,SAGP;AAC7B,SAAO;AAAA,IACL,kBAAkB,wBAAwB,QAAQ,gBAAgB;AAAA,IAClE,GAAI,QAAQ,iBAAiB,SACzB,CAAC,IACD,EAAE,cAAc,QAAQ,aAAa;AAAA,EAC3C;AACF;AAEO,SAAS,+BAA+B,SAGlB;AAC3B,QAAM,WAAW,sBAAsB,QAAQ,YAAY;AAE3D,SAAO;AAAA,IACL,GAAI,aAAa,SAAY,CAAC,IAAI,EAAE,SAAS;AAAA,IAC7C,QAAQ,wBAAwB,QAAQ,gBAAgB;AAAA,EAC1D;AACF;","names":[]}

package/dist/graph/reading-build/source-fragments.d.ts

@@ -0,0 +1,15 @@
+import { ReaderTextStream } from '../../text/reader/types.js';
+import '../../text/reader/attention/core.js';
+import '../../text/reader/chunk-batch/types.js';
+import '../../runtime/common/language.js';
+import '../../external/llm/client/core.js';
+import '../../external/llm/context.js';
+import '../../external/llm/cache.js';
+import '../../external/llm/types.js';
+import 'ai';
+import '../../document/types.js';
+import '../../text/reader/segment/types.js';
+
+declare function writeGraphArtifactSourceFragments(documentPath: string, chapterId: number, sourceText: ReaderTextStream): Promise<void>;
+
+export { writeGraphArtifactSourceFragments };

package/dist/graph/reading-build/source-fragments.js

@@ -0,0 +1,36 @@
+import { Fragments } from "../../document/index.js";
+import {
+  segmentTextStream
+} from "../../text/reader/index.js";
+const GRAPH_ARTIFACT_FRAGMENT_WORDS_COUNT = 320;
+async function writeGraphArtifactSourceFragments(documentPath, chapterId, sourceText) {
+  const fragments = new Fragments(documentPath);
+  const serial = fragments.getSerial(chapterId);
+  let draft = await serial.createDraft();
+  let draftWordsCount = 0;
+  let hasSentences = false;
+  await fragments.ensureCreated();
+  for await (const sentence of segmentTextStream(sourceText)) {
+    const text = sentence.text.trim();
+    if (text === "") {
+      continue;
+    }
+    if (draftWordsCount > 0 && draftWordsCount + sentence.wordsCount > GRAPH_ARTIFACT_FRAGMENT_WORDS_COUNT) {
+      await draft.commit();
+      draft = await serial.createDraft();
+      draftWordsCount = 0;
+    }
+    draft.addSentence(text, sentence.wordsCount);
+    draftWordsCount += sentence.wordsCount;
+    hasSentences = true;
+  }
+  if (hasSentences) {
+    await draft.commit();
+  } else {
+    draft.discard();
+  }
+}
+export {
+  writeGraphArtifactSourceFragments
+};
+//# sourceMappingURL=source-fragments.js.map

package/dist/graph/reading-build/source-fragments.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/graph/reading-build/source-fragments.ts"],"sourcesContent":["import { Fragments } from \"../../document/index.js\";\nimport {\n  segmentTextStream,\n  type ReaderTextStream,\n} from \"../../text/reader/index.js\";\n\nconst GRAPH_ARTIFACT_FRAGMENT_WORDS_COUNT = 320;\n\nexport async function writeGraphArtifactSourceFragments(\n  documentPath: string,\n  chapterId: number,\n  sourceText: ReaderTextStream,\n): Promise<void> {\n  const fragments = new Fragments(documentPath);\n  const serial = fragments.getSerial(chapterId);\n  let draft = await serial.createDraft();\n  let draftWordsCount = 0;\n  let hasSentences = false;\n\n  await fragments.ensureCreated();\n\n  for await (const sentence of segmentTextStream(sourceText)) {\n    const text = sentence.text.trim();\n\n    if (text === \"\") {\n      continue;\n    }\n    if (\n      draftWordsCount > 0 &&\n      draftWordsCount + sentence.wordsCount >\n        GRAPH_ARTIFACT_FRAGMENT_WORDS_COUNT\n    ) {\n      await draft.commit();\n      draft = await serial.createDraft();\n      draftWordsCount = 0;\n    }\n\n    draft.addSentence(text, sentence.wordsCount);\n    draftWordsCount += sentence.wordsCount;\n    hasSentences = true;\n  }\n\n  if (hasSentences) {\n    await draft.commit();\n  } else {\n    draft.discard();\n  }\n}\n"],"mappings":"AAAA,SAAS,iBAAiB;AAC1B;AAAA,EACE;AAAA,OAEK;AAEP,MAAM,sCAAsC;AAE5C,eAAsB,kCACpB,cACA,WACA,YACe;AACf,QAAM,YAAY,IAAI,UAAU,YAAY;AAC5C,QAAM,SAAS,UAAU,UAAU,SAAS;AAC5C,MAAI,QAAQ,MAAM,OAAO,YAAY;AACrC,MAAI,kBAAkB;AACtB,MAAI,eAAe;AAEnB,QAAM,UAAU,cAAc;AAE9B,mBAAiB,YAAY,kBAAkB,UAAU,GAAG;AAC1D,UAAM,OAAO,SAAS,KAAK,KAAK;AAEhC,QAAI,SAAS,IAAI;AACf;AAAA,IACF;AACA,QACE,kBAAkB,KAClB,kBAAkB,SAAS,aACzB,qCACF;AACA,YAAM,MAAM,OAAO;AACnB,cAAQ,MAAM,OAAO,YAAY;AACjC,wBAAkB;AAAA,IACpB;AAEA,UAAM,YAAY,MAAM,SAAS,UAAU;AAC3C,uBAAmB,SAAS;AAC5B,mBAAe;AAAA,EACjB;AAEA,MAAI,cAAc;AAChB,UAAM,MAAM,OAAO;AAAA,EACrB,OAAO;AACL,UAAM,QAAQ;AAAA,EAChB;AACF;","names":[]}

package/dist/graph/reading-build/types.d.ts

@@ -0,0 +1,57 @@
+import { LLM } from '../../external/llm/client/core.js';
+import { Language } from '../../runtime/common/language.js';
+import { WikiGraphScope } from '../../runtime/common/llm-scope.js';
+import { SerialProgressSink } from '../../text/serial/options.js';
+import '../../external/llm/context.js';
+import '../../external/llm/cache.js';
+import '../../external/llm/types.js';
+import 'ai';
+import '../../document/directory/types.js';
+import '../../text/source/meta.js';
+import 'zod';
+import '../../text/source/toc.js';
+import '../../text/source/types.js';
+import '../../document/database.js';
+import 'sqlite3';
+import '../../document/types.js';
+import '../../document/text-streams/serial.js';
+import '../../document/text-streams/draft.js';
+import '../../document/text-streams/types.js';
+import '../../document/stores/chunk.js';
+import '../../document/stores/types.js';
+import '../../document/stores/fragment-group.js';
+import '../../document/stores/graph-build-parameter.js';
+import '../../document/stores/mention-link.js';
+import '../../document/stores/mention.js';
+import '../../document/stores/object-metadata.js';
+import '../../document/stores/reading-edge.js';
+import '../../document/stores/serial.js';
+import '../../document/stores/snake/chunk.js';
+import '../../document/stores/snake/core.js';
+import '../../document/stores/snake/edge.js';
+import '../../text/reader/types.js';
+import '../../text/reader/attention/core.js';
+import '../../text/reader/chunk-batch/types.js';
+import '../../text/reader/segment/types.js';
+
+interface ChapterGraphBuildArtifact {
+    readonly documentPath: string;
+    readonly chapterId: number;
+    readonly objectsPath: string;
+    readonly parameter: GraphBuildParameterInput;
+}
+interface GraphBuildParameterInput {
+    readonly language?: string;
+    readonly prompt: string;
+}
+interface BuildChapterGraphArtifactOptions {
+    readonly extractionPrompt?: string;
+    readonly llm: LLM<WikiGraphScope>;
+    readonly logDirPath?: string;
+    readonly progressTracker?: SerialProgressSink;
+    readonly sourceText: readonly string[];
+    readonly userLanguage?: Language;
+    readonly workspacePath: string;
+}
+
+export type { BuildChapterGraphArtifactOptions, ChapterGraphBuildArtifact, GraphBuildParameterInput };

package/dist/graph/reading.d.ts

@@ -0,0 +1,73 @@
+import { ChunkImportance, ChunkRetention, SentenceId } from '../document/types.js';
+import { ReadonlyDocument } from '../document/directory/types.js';
+import '../text/source/meta.js';
+import 'zod';
+import '../text/source/toc.js';
+import '../text/source/types.js';
+import '../document/database.js';
+import 'sqlite3';
+import '../document/text-streams/serial.js';
+import '../document/text-streams/draft.js';
+import '../document/text-streams/types.js';
+import '../document/stores/chunk.js';
+import '../document/stores/types.js';
+import '../document/stores/fragment-group.js';
+import '../document/stores/graph-build-parameter.js';
+import '../document/stores/mention-link.js';
+import '../document/stores/mention.js';
+import '../document/stores/object-metadata.js';
+import '../document/stores/reading-edge.js';
+import '../document/stores/serial.js';
+import '../document/stores/snake/chunk.js';
+import '../document/stores/snake/core.js';
+import '../document/stores/snake/edge.js';
+
+interface GraphNode {
+    readonly content: string;
+    readonly id: number;
+    readonly importance?: ChunkImportance;
+    readonly label: string;
+    readonly retention?: ChunkRetention;
+    readonly sentenceIds: readonly SentenceId[];
+    readonly weight: number;
+    readonly wordsCount: number;
+}
+interface GraphEdge {
+    readonly fromId: number;
+    readonly strength?: string;
+    readonly toId: number;
+    readonly weight: number;
+}
+interface GraphEvidenceLine {
+    readonly sentenceId: SentenceId;
+    readonly text: string;
+}
+interface GraphStatus {
+    readonly chapterId: number;
+    readonly edgeCount: number;
+    readonly graphReady: boolean;
+    readonly nodeCount: number;
+}
+interface GraphSearchHit {
+    readonly node: GraphNode;
+    readonly matchedFields: readonly GraphSearchField[];
+}
+type GraphSearchField = "content" | "evidence" | "label";
+interface GraphNeighbor {
+    readonly direction: "incoming" | "outgoing";
+    readonly edge: GraphEdge;
+    readonly node: GraphNode;
+}
+interface GraphPathStep {
+    readonly edge?: GraphEdge;
+    readonly node: GraphNode;
+}
+declare function getGraphStatus(document: ReadonlyDocument, chapterId: number): Promise<GraphStatus>;
+declare function listGraphNodes(document: ReadonlyDocument, chapterId: number): Promise<readonly GraphNode[]>;
+declare function getGraphNode(document: ReadonlyDocument, chapterId: number, nodeId: number): Promise<GraphNode>;
+declare function searchGraphNodes(document: ReadonlyDocument, chapterId: number, pattern: string): Promise<readonly GraphSearchHit[]>;
+declare function listGraphNeighbors(document: ReadonlyDocument, chapterId: number, nodeId: number): Promise<readonly GraphNeighbor[]>;
+declare function getGraphEvidence(document: ReadonlyDocument, chapterId: number, nodeId: number): Promise<readonly GraphEvidenceLine[]>;
+declare function findGraphPath(document: ReadonlyDocument, chapterId: number, fromNodeId: number, toNodeId: number): Promise<readonly GraphPathStep[]>;
+
+export { type GraphEdge, type GraphEvidenceLine, type GraphNeighbor, type GraphNode, type GraphPathStep, type GraphSearchField, type GraphSearchHit, type GraphStatus, findGraphPath, getGraphEvidence, getGraphNode, getGraphStatus, listGraphNeighbors, listGraphNodes, searchGraphNodes };

package/dist/graph/reading.js

@@ -0,0 +1,203 @@
+async function getGraphStatus(document, chapterId) {
+  await requireChapter(document, chapterId);
+  const [serial, nodes, edges] = await Promise.all([
+    document.serials.getById(chapterId),
+    listGraphNodes(document, chapterId),
+    document.readingEdges.listBySerial(chapterId)
+  ]);
+  return {
+    chapterId,
+    edgeCount: edges.length,
+    graphReady: serial?.topologyReady === true,
+    nodeCount: nodes.length
+  };
+}
+async function listGraphNodes(document, chapterId) {
+  await requireChapter(document, chapterId);
+  const chunks = await document.chunks.listBySerial(chapterId);
+  return chunks.map(formatGraphNode).sort(compareNodeByWeightDescending);
+}
+async function getGraphNode(document, chapterId, nodeId) {
+  const node = formatGraphNode(
+    await requireChapterNode(document, chapterId, nodeId)
+  );
+  return node;
+}
+async function searchGraphNodes(document, chapterId, pattern) {
+  const normalizedPattern = pattern.trim().toLowerCase();
+  if (normalizedPattern === "") {
+    return [];
+  }
+  const nodes = await listGraphNodes(document, chapterId);
+  const hits = [];
+  for (const node of nodes) {
+    const evidence = await getGraphEvidence(document, chapterId, node.id);
+    const matchedFields = [];
+    if (node.label.toLowerCase().includes(normalizedPattern)) {
+      matchedFields.push("label");
+    }
+    if (node.content.toLowerCase().includes(normalizedPattern)) {
+      matchedFields.push("content");
+    }
+    if (evidence.some(
+      (line) => line.text.toLowerCase().includes(normalizedPattern)
+    )) {
+      matchedFields.push("evidence");
+    }
+    if (matchedFields.length > 0) {
+      hits.push({ matchedFields, node });
+    }
+  }
+  return hits;
+}
+async function listGraphNeighbors(document, chapterId, nodeId) {
+  await requireChapterNode(document, chapterId, nodeId);
+  const [incoming, outgoing] = await Promise.all([
+    document.readingEdges.listIncoming(nodeId),
+    document.readingEdges.listOutgoing(nodeId)
+  ]);
+  const neighbors = await Promise.all([
+    ...incoming.map(async (edge) => ({
+      direction: "incoming",
+      edge: formatGraphEdge(edge),
+      node: formatGraphNode(
+        await requireChapterNode(document, chapterId, edge.fromId)
+      )
+    })),
+    ...outgoing.map(async (edge) => ({
+      direction: "outgoing",
+      edge: formatGraphEdge(edge),
+      node: formatGraphNode(
+        await requireChapterNode(document, chapterId, edge.toId)
+      )
+    }))
+  ]);
+  return neighbors.sort(compareNeighbor);
+}
+async function getGraphEvidence(document, chapterId, nodeId) {
+  const node = await requireChapterNode(document, chapterId, nodeId);
+  const lines = await Promise.all(
+    node.sentenceIds.map(async (sentenceId) => ({
+      sentenceId,
+      text: await document.getSentence(sentenceId)
+    }))
+  );
+  return lines;
+}
+async function findGraphPath(document, chapterId, fromNodeId, toNodeId) {
+  await requireChapterNode(document, chapterId, fromNodeId);
+  await requireChapterNode(document, chapterId, toNodeId);
+  if (fromNodeId === toNodeId) {
+    return [{ node: await getGraphNode(document, chapterId, fromNodeId) }];
+  }
+  const edges = (await document.readingEdges.listBySerial(chapterId)).map(
+    formatGraphEdge
+  );
+  const outgoing = /* @__PURE__ */ new Map();
+  for (const edge of edges) {
+    const existing = outgoing.get(edge.fromId) ?? [];
+    existing.push(edge);
+    outgoing.set(edge.fromId, existing);
+  }
+  const visited = /* @__PURE__ */ new Set([fromNodeId]);
+  const queue = [fromNodeId];
+  const previous = /* @__PURE__ */ new Map();
+  while (queue.length > 0) {
+    const currentId = queue.shift();
+    for (const edge of outgoing.get(currentId) ?? []) {
+      if (visited.has(edge.toId)) {
+        continue;
+      }
+      visited.add(edge.toId);
+      previous.set(edge.toId, { edge, id: currentId });
+      if (edge.toId === toNodeId) {
+        return await buildPathSteps(
+          document,
+          chapterId,
+          fromNodeId,
+          toNodeId,
+          previous
+        );
+      }
+      queue.push(edge.toId);
+    }
+  }
+  return [];
+}
+async function buildPathSteps(document, chapterId, fromNodeId, toNodeId, previous) {
+  const steps = [
+    { nodeId: toNodeId }
+  ];
+  let currentId = toNodeId;
+  while (currentId !== fromNodeId) {
+    const previousStep = previous.get(currentId);
+    if (previousStep === void 0) {
+      return [];
+    }
+    steps.push({ edge: previousStep.edge, nodeId: previousStep.id });
+    currentId = previousStep.id;
+  }
+  steps.reverse();
+  return await Promise.all(
+    steps.map(async (step) => ({
+      ...step.edge === void 0 ? {} : { edge: step.edge },
+      node: await getGraphNode(document, chapterId, step.nodeId)
+    }))
+  );
+}
+async function requireChapter(document, chapterId) {
+  const serial = await document.serials.getById(chapterId);
+  if (serial === void 0) {
+    throw new Error(
+      `Chapter ${chapterId} does not exist. Use \`wg <archive-uri>/chapter list\` to discover chapter ids.`
+    );
+  }
+}
+async function requireChapterNode(document, chapterId, nodeId) {
+  const chunk = await document.chunks.getById(nodeId);
+  if (chunk === void 0 || chunk.sentenceId[0] !== chapterId) {
+    throw new Error(
+      `Graph node ${nodeId} does not exist in chapter ${chapterId}. Use \`wg <archive-uri>/chapter/${chapterId}/chunk list\` to discover chunk ids.`
+    );
+  }
+  return chunk;
+}
+function formatGraphNode(chunk) {
+  return {
+    content: chunk.content,
+    id: chunk.id,
+    label: chunk.label,
+    sentenceIds: chunk.sentenceIds,
+    weight: chunk.weight,
+    wordsCount: chunk.wordsCount,
+    ...chunk.importance === void 0 ? {} : { importance: chunk.importance },
+    ...chunk.retention === void 0 ? {} : { retention: chunk.retention }
+  };
+}
+function formatGraphEdge(edge) {
+  return {
+    fromId: edge.fromId,
+    toId: edge.toId,
+    weight: edge.weight,
+    ...edge.strength === void 0 ? {} : { strength: edge.strength }
+  };
+}
+function compareNodeByWeightDescending(left, right) {
+  return right.weight - left.weight || left.id - right.id;
+}
+function compareNeighbor(left, right) {
+  if (left.direction !== right.direction) {
+    return left.direction === "incoming" ? -1 : 1;
+  }
+  return right.edge.weight - left.edge.weight || left.node.id - right.node.id;
+}
+export {
+  findGraphPath,
+  getGraphEvidence,
+  getGraphNode,
+  getGraphStatus,
+  listGraphNeighbors,
+  listGraphNodes,
+  searchGraphNodes
+};
+//# sourceMappingURL=reading.js.map

package/dist/graph/reading.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/graph/reading.ts"],"sourcesContent":["import type {\n  ChunkImportance,\n  ChunkRecord,\n  ChunkRetention,\n  ReadingEdgeRecord,\n  ReadonlyDocument,\n  SentenceId,\n} from \"../document/index.js\";\n\nexport interface GraphNode {\n  readonly content: string;\n  readonly id: number;\n  readonly importance?: ChunkImportance;\n  readonly label: string;\n  readonly retention?: ChunkRetention;\n  readonly sentenceIds: readonly SentenceId[];\n  readonly weight: number;\n  readonly wordsCount: number;\n}\n\nexport interface GraphEdge {\n  readonly fromId: number;\n  readonly strength?: string;\n  readonly toId: number;\n  readonly weight: number;\n}\n\nexport interface GraphEvidenceLine {\n  readonly sentenceId: SentenceId;\n  readonly text: string;\n}\n\nexport interface GraphStatus {\n  readonly chapterId: number;\n  readonly edgeCount: number;\n  readonly graphReady: boolean;\n  readonly nodeCount: number;\n}\n\nexport interface GraphSearchHit {\n  readonly node: GraphNode;\n  readonly matchedFields: readonly GraphSearchField[];\n}\n\nexport type GraphSearchField = \"content\" | \"evidence\" | \"label\";\n\nexport interface GraphNeighbor {\n  readonly direction: \"incoming\" | \"outgoing\";\n  readonly edge: GraphEdge;\n  readonly node: GraphNode;\n}\n\nexport interface GraphPathStep {\n  readonly edge?: GraphEdge;\n  readonly node: GraphNode;\n}\n\nexport async function getGraphStatus(\n  document: ReadonlyDocument,\n  chapterId: number,\n): Promise<GraphStatus> {\n  await requireChapter(document, chapterId);\n  const [serial, nodes, edges] = await Promise.all([\n    document.serials.getById(chapterId),\n    listGraphNodes(document, chapterId),\n    document.readingEdges.listBySerial(chapterId),\n  ]);\n\n  return {\n    chapterId,\n    edgeCount: edges.length,\n    graphReady: serial?.topologyReady === true,\n    nodeCount: nodes.length,\n  };\n}\n\nexport async function listGraphNodes(\n  document: ReadonlyDocument,\n  chapterId: number,\n): Promise<readonly GraphNode[]> {\n  await requireChapter(document, chapterId);\n  const chunks = await document.chunks.listBySerial(chapterId);\n\n  return chunks.map(formatGraphNode).sort(compareNodeByWeightDescending);\n}\n\nexport async function getGraphNode(\n  document: ReadonlyDocument,\n  chapterId: number,\n  nodeId: number,\n): Promise<GraphNode> {\n  const node = formatGraphNode(\n    await requireChapterNode(document, chapterId, nodeId),\n  );\n\n  return node;\n}\n\nexport async function searchGraphNodes(\n  document: ReadonlyDocument,\n  chapterId: number,\n  pattern: string,\n): Promise<readonly GraphSearchHit[]> {\n  const normalizedPattern = pattern.trim().toLowerCase();\n\n  if (normalizedPattern === \"\") {\n    return [];\n  }\n\n  const nodes = await listGraphNodes(document, chapterId);\n  const hits: GraphSearchHit[] = [];\n\n  for (const node of nodes) {\n    const evidence = await getGraphEvidence(document, chapterId, node.id);\n    const matchedFields: GraphSearchField[] = [];\n\n    if (node.label.toLowerCase().includes(normalizedPattern)) {\n      matchedFields.push(\"label\");\n    }\n    if (node.content.toLowerCase().includes(normalizedPattern)) {\n      matchedFields.push(\"content\");\n    }\n    if (\n      evidence.some((line) =>\n        line.text.toLowerCase().includes(normalizedPattern),\n      )\n    ) {\n      matchedFields.push(\"evidence\");\n    }\n\n    if (matchedFields.length > 0) {\n      hits.push({ matchedFields, node });\n    }\n  }\n\n  return hits;\n}\n\nexport async function listGraphNeighbors(\n  document: ReadonlyDocument,\n  chapterId: number,\n  nodeId: number,\n): Promise<readonly GraphNeighbor[]> {\n  await requireChapterNode(document, chapterId, nodeId);\n  const [incoming, outgoing] = await Promise.all([\n    document.readingEdges.listIncoming(nodeId),\n    document.readingEdges.listOutgoing(nodeId),\n  ]);\n  const neighbors = await Promise.all([\n    ...incoming.map(async (edge) => ({\n      direction: \"incoming\" as const,\n      edge: formatGraphEdge(edge),\n      node: formatGraphNode(\n        await requireChapterNode(document, chapterId, edge.fromId),\n      ),\n    })),\n    ...outgoing.map(async (edge) => ({\n      direction: \"outgoing\" as const,\n      edge: formatGraphEdge(edge),\n      node: formatGraphNode(\n        await requireChapterNode(document, chapterId, edge.toId),\n      ),\n    })),\n  ]);\n\n  return neighbors.sort(compareNeighbor);\n}\n\nexport async function getGraphEvidence(\n  document: ReadonlyDocument,\n  chapterId: number,\n  nodeId: number,\n): Promise<readonly GraphEvidenceLine[]> {\n  const node = await requireChapterNode(document, chapterId, nodeId);\n  const lines = await Promise.all(\n    node.sentenceIds.map(async (sentenceId) => ({\n      sentenceId,\n      text: await document.getSentence(sentenceId),\n    })),\n  );\n\n  return lines;\n}\n\nexport async function findGraphPath(\n  document: ReadonlyDocument,\n  chapterId: number,\n  fromNodeId: number,\n  toNodeId: number,\n): Promise<readonly GraphPathStep[]> {\n  await requireChapterNode(document, chapterId, fromNodeId);\n  await requireChapterNode(document, chapterId, toNodeId);\n\n  if (fromNodeId === toNodeId) {\n    return [{ node: await getGraphNode(document, chapterId, fromNodeId) }];\n  }\n\n  const edges = (await document.readingEdges.listBySerial(chapterId)).map(\n    formatGraphEdge,\n  );\n  const outgoing = new Map<number, GraphEdge[]>();\n\n  for (const edge of edges) {\n    const existing = outgoing.get(edge.fromId) ?? [];\n\n    existing.push(edge);\n    outgoing.set(edge.fromId, existing);\n  }\n\n  const visited = new Set<number>([fromNodeId]);\n  const queue: number[] = [fromNodeId];\n  const previous = new Map<\n    number,\n    { readonly edge: GraphEdge; readonly id: number }\n  >();\n\n  while (queue.length > 0) {\n    const currentId = queue.shift()!;\n\n    for (const edge of outgoing.get(currentId) ?? []) {\n      if (visited.has(edge.toId)) {\n        continue;\n      }\n\n      visited.add(edge.toId);\n      previous.set(edge.toId, { edge, id: currentId });\n\n      if (edge.toId === toNodeId) {\n        return await buildPathSteps(\n          document,\n          chapterId,\n          fromNodeId,\n          toNodeId,\n          previous,\n        );\n      }\n\n      queue.push(edge.toId);\n    }\n  }\n\n  return [];\n}\n\nasync function buildPathSteps(\n  document: ReadonlyDocument,\n  chapterId: number,\n  fromNodeId: number,\n  toNodeId: number,\n  previous: ReadonlyMap<\n    number,\n    { readonly edge: GraphEdge; readonly id: number }\n  >,\n): Promise<readonly GraphPathStep[]> {\n  const steps: Array<{ readonly edge?: GraphEdge; readonly nodeId: number }> = [\n    { nodeId: toNodeId },\n  ];\n  let currentId = toNodeId;\n\n  while (currentId !== fromNodeId) {\n    const previousStep = previous.get(currentId);\n\n    if (previousStep === undefined) {\n      return [];\n    }\n\n    steps.push({ edge: previousStep.edge, nodeId: previousStep.id });\n    currentId = previousStep.id;\n  }\n\n  steps.reverse();\n\n  return await Promise.all(\n    steps.map(async (step) => ({\n      ...(step.edge === undefined ? {} : { edge: step.edge }),\n      node: await getGraphNode(document, chapterId, step.nodeId),\n    })),\n  );\n}\n\nasync function requireChapter(\n  document: ReadonlyDocument,\n  chapterId: number,\n): Promise<void> {\n  const serial = await document.serials.getById(chapterId);\n\n  if (serial === undefined) {\n    throw new Error(\n      `Chapter ${chapterId} does not exist. Use \\`wg <archive-uri>/chapter list\\` to discover chapter ids.`,\n    );\n  }\n}\n\nasync function requireChapterNode(\n  document: ReadonlyDocument,\n  chapterId: number,\n  nodeId: number,\n): Promise<ChunkRecord> {\n  const chunk = await document.chunks.getById(nodeId);\n\n  if (chunk === undefined || chunk.sentenceId[0] !== chapterId) {\n    throw new Error(\n      `Graph node ${nodeId} does not exist in chapter ${chapterId}. Use \\`wg <archive-uri>/chapter/${chapterId}/chunk list\\` to discover chunk ids.`,\n    );\n  }\n\n  return chunk;\n}\n\nfunction formatGraphNode(chunk: ChunkRecord): GraphNode {\n  return {\n    content: chunk.content,\n    id: chunk.id,\n    label: chunk.label,\n    sentenceIds: chunk.sentenceIds,\n    weight: chunk.weight,\n    wordsCount: chunk.wordsCount,\n    ...(chunk.importance === undefined ? {} : { importance: chunk.importance }),\n    ...(chunk.retention === undefined ? {} : { retention: chunk.retention }),\n  };\n}\n\nfunction formatGraphEdge(edge: ReadingEdgeRecord): GraphEdge {\n  return {\n    fromId: edge.fromId,\n    toId: edge.toId,\n    weight: edge.weight,\n    ...(edge.strength === undefined ? {} : { strength: edge.strength }),\n  };\n}\n\nfunction compareNodeByWeightDescending(\n  left: GraphNode,\n  right: GraphNode,\n): number {\n  return right.weight - left.weight || left.id - right.id;\n}\n\nfunction compareNeighbor(left: GraphNeighbor, right: GraphNeighbor): number {\n  if (left.direction !== right.direction) {\n    return left.direction === \"incoming\" ? -1 : 1;\n  }\n\n  return right.edge.weight - left.edge.weight || left.node.id - right.node.id;\n}\n"],"mappings":"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","names":[]}

package/dist/graph/topology/core.d.ts

@@ -0,0 +1,42 @@
+import { Document } from '../../document/directory/types.js';
+import { ReaderGraphDelta } from '../../text/reader/types.js';
+import '../../text/source/meta.js';
+import 'zod';
+import '../../text/source/toc.js';
+import '../../text/source/types.js';
+import '../../document/database.js';
+import 'sqlite3';
+import '../../document/types.js';
+import '../../document/text-streams/serial.js';
+import '../../document/text-streams/draft.js';
+import '../../document/text-streams/types.js';
+import '../../document/stores/chunk.js';
+import '../../document/stores/types.js';
+import '../../document/stores/fragment-group.js';
+import '../../document/stores/graph-build-parameter.js';
+import '../../document/stores/mention-link.js';
+import '../../document/stores/mention.js';
+import '../../document/stores/object-metadata.js';
+import '../../document/stores/reading-edge.js';
+import '../../document/stores/serial.js';
+import '../../document/stores/snake/chunk.js';
+import '../../document/stores/snake/core.js';
+import '../../document/stores/snake/edge.js';
+import '../../text/reader/attention/core.js';
+import '../../text/reader/chunk-batch/types.js';
+import '../../runtime/common/language.js';
+import '../../external/llm/client/core.js';
+import '../../external/llm/context.js';
+import '../../external/llm/cache.js';
+import '../../external/llm/types.js';
+import 'ai';
+import '../../text/reader/segment/types.js';
+
+declare class Topology {
+    #private;
+    constructor(document: Document, serialId: number, groupWordsCount: number);
+    accept(delta: ReaderGraphDelta): void;
+    finalize(): Promise<void>;
+}
+
+export { Topology };