wiki-graph-core 0.3.1

package/dist/document/schema.js

@@ -0,0 +1,472 @@
+const SCHEMA_SQL = `
+  CREATE TABLE IF NOT EXISTS serials (
+    id INTEGER PRIMARY KEY,
+    document_order INTEGER NOT NULL DEFAULT 0
+  );
+
+  CREATE TABLE IF NOT EXISTS serial_states (
+    serial_id INTEGER PRIMARY KEY,
+    revision INTEGER NOT NULL DEFAULT 0,
+    topology_ready INTEGER NOT NULL DEFAULT 0,
+    topology_parameter_hash TEXT,
+    knowledge_graph_ready INTEGER NOT NULL DEFAULT 0,
+    knowledge_graph_parameter_hash TEXT,
+    FOREIGN KEY (serial_id) REFERENCES serials(id)
+  );
+
+  CREATE TABLE IF NOT EXISTS archive_revisions (
+    key TEXT PRIMARY KEY,
+    value INTEGER NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS archive_index_settings (
+    id INTEGER PRIMARY KEY CHECK (id = 1),
+    fts_embedded INTEGER NOT NULL DEFAULT 0
+  );
+
+  CREATE TABLE IF NOT EXISTS graph_build_parameters (
+    hash TEXT PRIMARY KEY,
+    prompt TEXT NOT NULL,
+    language TEXT,
+    created_at TEXT NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS chunks (
+    id INTEGER PRIMARY KEY,
+    generation INTEGER NOT NULL,
+    serial_id INTEGER NOT NULL,
+    sentence_index INTEGER NOT NULL,
+    label TEXT NOT NULL,
+    content TEXT NOT NULL,
+    retention TEXT,
+    importance TEXT,
+    wordsCount INTEGER NOT NULL DEFAULT 0,
+    weight REAL NOT NULL DEFAULT 0.0
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_chunks_sentence
+  ON chunks(serial_id, sentence_index);
+
+  CREATE INDEX IF NOT EXISTS idx_chunks_serial_id
+  ON chunks(serial_id, id);
+
+  CREATE TABLE IF NOT EXISTS chunk_sentences (
+    chunk_id INTEGER NOT NULL,
+    serial_id INTEGER NOT NULL,
+    sentence_index INTEGER NOT NULL,
+    FOREIGN KEY (chunk_id) REFERENCES chunks(id),
+    PRIMARY KEY (chunk_id, serial_id, sentence_index)
+  );
+
+  CREATE TABLE IF NOT EXISTS reading_edges (
+    from_id INTEGER NOT NULL,
+    to_id INTEGER NOT NULL,
+    strength TEXT,
+    weight REAL NOT NULL DEFAULT 0.1,
+    PRIMARY KEY (from_id, to_id),
+    FOREIGN KEY (from_id) REFERENCES chunks(id),
+    FOREIGN KEY (to_id) REFERENCES chunks(id)
+  );
+
+  CREATE TABLE IF NOT EXISTS snakes (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    serial_id INTEGER NOT NULL,
+    group_id INTEGER NOT NULL,
+    local_snake_id INTEGER NOT NULL,
+    size INTEGER NOT NULL,
+    first_label TEXT NOT NULL,
+    last_label TEXT NOT NULL,
+    wordsCount INTEGER NOT NULL DEFAULT 0,
+    weight REAL NOT NULL DEFAULT 0.0,
+    UNIQUE(serial_id, group_id, local_snake_id)
+  );
+
+  CREATE TABLE IF NOT EXISTS snake_chunks (
+    snake_id INTEGER NOT NULL,
+    chunk_id INTEGER NOT NULL,
+    position INTEGER NOT NULL,
+    FOREIGN KEY (snake_id) REFERENCES snakes(id),
+    FOREIGN KEY (chunk_id) REFERENCES chunks(id),
+    PRIMARY KEY (snake_id, chunk_id)
+  );
+
+  CREATE TABLE IF NOT EXISTS snake_edges (
+    from_snake_id INTEGER NOT NULL,
+    to_snake_id INTEGER NOT NULL,
+    weight REAL NOT NULL DEFAULT 0.1,
+    PRIMARY KEY (from_snake_id, to_snake_id),
+    FOREIGN KEY (from_snake_id) REFERENCES snakes(id),
+    FOREIGN KEY (to_snake_id) REFERENCES snakes(id)
+  );
+
+  CREATE TABLE IF NOT EXISTS sentence_groups (
+    serial_id INTEGER NOT NULL,
+    group_id INTEGER NOT NULL,
+    start_sentence_index INTEGER NOT NULL,
+    end_sentence_index INTEGER NOT NULL,
+    PRIMARY KEY (serial_id, group_id, start_sentence_index, end_sentence_index)
+  );
+
+  CREATE TABLE IF NOT EXISTS mentions (
+    id TEXT PRIMARY KEY,
+    chapter_id INTEGER NOT NULL,
+    sentence_index INTEGER,
+    range_start INTEGER NOT NULL,
+    range_end INTEGER NOT NULL,
+    surface TEXT NOT NULL,
+    qid TEXT NOT NULL,
+    confidence REAL,
+    note TEXT,
+    FOREIGN KEY (chapter_id) REFERENCES serials(id)
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_mentions_chapter
+  ON mentions(chapter_id);
+
+  CREATE INDEX IF NOT EXISTS idx_mentions_chapter_position
+  ON mentions(chapter_id, sentence_index, range_start, range_end, id);
+
+  CREATE INDEX IF NOT EXISTS idx_mentions_chapter_qid
+  ON mentions(chapter_id, qid);
+
+  CREATE INDEX IF NOT EXISTS idx_mentions_qid
+  ON mentions(qid);
+
+  CREATE INDEX IF NOT EXISTS idx_mentions_qid_position
+  ON mentions(qid, chapter_id, sentence_index, range_start, range_end, id);
+
+  CREATE INDEX IF NOT EXISTS idx_mentions_surface
+  ON mentions(surface);
+
+  CREATE INDEX IF NOT EXISTS idx_mentions_surface_position
+  ON mentions(surface, chapter_id, sentence_index, range_start, range_end, id);
+
+  CREATE INDEX IF NOT EXISTS idx_mentions_sentence
+  ON mentions(chapter_id, sentence_index);
+
+  CREATE TABLE IF NOT EXISTS mention_links (
+    id TEXT PRIMARY KEY,
+    source_mention_id TEXT NOT NULL,
+    target_mention_id TEXT NOT NULL,
+    predicate TEXT NOT NULL,
+    confidence REAL,
+    note TEXT,
+    FOREIGN KEY (source_mention_id) REFERENCES mentions(id),
+    FOREIGN KEY (target_mention_id) REFERENCES mentions(id)
+  );
+
+  CREATE TABLE IF NOT EXISTS mention_link_evidence_sentences (
+    link_id TEXT NOT NULL,
+    chapter_id INTEGER NOT NULL,
+    sentence_index INTEGER NOT NULL,
+    FOREIGN KEY (link_id) REFERENCES mention_links(id),
+    PRIMARY KEY (link_id, chapter_id, sentence_index)
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_mention_link_evidence_sentences_sentence
+  ON mention_link_evidence_sentences(chapter_id, sentence_index);
+
+  CREATE INDEX IF NOT EXISTS idx_mention_links_source
+  ON mention_links(source_mention_id);
+
+  CREATE INDEX IF NOT EXISTS idx_mention_links_target
+  ON mention_links(target_mention_id);
+
+  CREATE INDEX IF NOT EXISTS idx_mention_links_predicate
+  ON mention_links(predicate);
+
+  CREATE INDEX IF NOT EXISTS idx_mention_links_predicate_source_target
+  ON mention_links(predicate, source_mention_id, target_mention_id);
+
+  CREATE INDEX IF NOT EXISTS idx_mention_links_predicate_target_source
+  ON mention_links(predicate, target_mention_id, source_mention_id);
+
+  CREATE INDEX IF NOT EXISTS idx_mention_links_source_predicate_target
+  ON mention_links(source_mention_id, predicate, target_mention_id);
+
+  CREATE INDEX IF NOT EXISTS idx_mention_links_target_predicate_source
+  ON mention_links(target_mention_id, predicate, source_mention_id);
+
+  CREATE INDEX IF NOT EXISTS idx_mention_links_source_target_predicate
+  ON mention_links(source_mention_id, target_mention_id, predicate);
+
+  CREATE INDEX IF NOT EXISTS idx_reading_edges_target
+  ON reading_edges(to_id, from_id);
+
+  CREATE INDEX IF NOT EXISTS idx_snake_edges_target
+  ON snake_edges(to_snake_id, from_snake_id);
+
+  CREATE VIEW IF NOT EXISTS chapter_entities AS
+  SELECT
+    chapter_id,
+    qid,
+    COUNT(*) AS mention_count
+  FROM mentions
+  GROUP BY chapter_id, qid;
+
+  CREATE VIEW IF NOT EXISTS book_entities AS
+  SELECT
+    qid,
+    SUM(mention_count) AS mention_count
+  FROM chapter_entities
+  GROUP BY qid;
+
+  CREATE VIEW IF NOT EXISTS chapter_entity_relations AS
+  SELECT
+    source_mentions.chapter_id AS chapter_id,
+    source_mentions.qid AS subject_qid,
+    mention_links.predicate AS predicate,
+    target_mentions.qid AS object_qid,
+    COUNT(*) AS evidence_count
+  FROM mention_links
+  JOIN mentions AS source_mentions
+    ON source_mentions.id = mention_links.source_mention_id
+  JOIN mentions AS target_mentions
+    ON target_mentions.id = mention_links.target_mention_id
+  WHERE source_mentions.chapter_id = target_mentions.chapter_id
+  GROUP BY
+    source_mentions.chapter_id,
+    source_mentions.qid,
+    mention_links.predicate,
+    target_mentions.qid;
+
+  CREATE VIEW IF NOT EXISTS book_entity_relations AS
+  SELECT
+    subject_qid,
+    predicate,
+    object_qid,
+    SUM(evidence_count) AS evidence_count
+  FROM chapter_entity_relations
+  GROUP BY subject_qid, predicate, object_qid;
+
+  CREATE TABLE IF NOT EXISTS text_sentence_records (
+    id INTEGER PRIMARY KEY,
+    kind INTEGER NOT NULL,
+    chapter_id INTEGER NOT NULL,
+    sentence_index INTEGER NOT NULL,
+    words_count INTEGER NOT NULL DEFAULT 0,
+    byte_offset INTEGER NOT NULL DEFAULT 0,
+    byte_length INTEGER NOT NULL DEFAULT 0,
+    UNIQUE(kind, chapter_id, sentence_index)
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_text_sentence_records_chapter
+  ON text_sentence_records(kind, chapter_id, sentence_index);
+
+  CREATE TABLE IF NOT EXISTS object_metadata (
+    id INTEGER PRIMARY KEY,
+    object_kind INTEGER NOT NULL,
+    object_path TEXT NOT NULL,
+    key TEXT NOT NULL,
+    value_json TEXT NOT NULL,
+    updated_at TEXT NOT NULL,
+    chapter_id INTEGER,
+    chunk_id INTEGER,
+    entity_qid TEXT,
+    triple_subject_qid TEXT,
+    triple_predicate TEXT,
+    triple_object_qid TEXT,
+    UNIQUE(object_path, key)
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_object_metadata_object
+  ON object_metadata(object_path);
+
+  CREATE INDEX IF NOT EXISTS idx_object_metadata_chapter
+  ON object_metadata(chapter_id);
+
+  CREATE INDEX IF NOT EXISTS idx_object_metadata_chunk
+  ON object_metadata(chunk_id);
+
+  CREATE INDEX IF NOT EXISTS idx_object_metadata_entity
+  ON object_metadata(entity_qid);
+
+  CREATE INDEX IF NOT EXISTS idx_object_metadata_triple
+  ON object_metadata(
+    triple_subject_qid,
+    triple_predicate,
+    triple_object_qid
+  );
+`;
+const SEARCH_INDEX_SCHEMA_SQL = `
+  CREATE TABLE IF NOT EXISTS search_index_state (
+    key TEXT PRIMARY KEY,
+    value TEXT NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS text_sentence_records (
+    id INTEGER PRIMARY KEY,
+    kind INTEGER NOT NULL,
+    chapter_id INTEGER NOT NULL,
+    sentence_index INTEGER NOT NULL,
+    words_count INTEGER NOT NULL DEFAULT 0,
+    byte_offset INTEGER NOT NULL DEFAULT 0,
+    byte_length INTEGER NOT NULL DEFAULT 0,
+    UNIQUE(kind, chapter_id, sentence_index)
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_text_sentence_records_chapter
+  ON text_sentence_records(kind, chapter_id, sentence_index);
+
+  CREATE VIRTUAL TABLE IF NOT EXISTS text_sentence_fts USING fts5(
+    tier1,
+    tier2,
+    tier3,
+    tokenize='ascii'
+  );
+
+  CREATE TABLE IF NOT EXISTS search_object_properties_records (
+    id INTEGER PRIMARY KEY,
+    owner_kind INTEGER NOT NULL,
+    owner_id TEXT NOT NULL,
+    property_kind INTEGER NOT NULL,
+    chapter_id INTEGER
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_search_object_properties_records_owner
+  ON search_object_properties_records(owner_kind, owner_id);
+
+  CREATE INDEX IF NOT EXISTS idx_search_object_properties_records_chapter
+  ON search_object_properties_records(chapter_id, owner_kind, owner_id);
+
+  CREATE VIRTUAL TABLE IF NOT EXISTS search_object_properties_fts USING fts5(
+    tier1,
+    tier2,
+    tier3,
+    tokenize='ascii'
+  );
+`;
+async function initializeDocumentSchema(database) {
+  await migrateSerialDocumentOrder(database);
+  await ensureGraphBuildParameterTable(database);
+  await migrateSerialStateRevision(database);
+  await migrateSerialStateKnowledgeGraphReady(database);
+  await migrateSerialStateGraphParameterHashes(database);
+  await ensureSerialDocumentOrderIndex(database);
+  await ensureGraphBuildParameterIndexes(database);
+}
+async function migrateSerialDocumentOrder(database) {
+  const columns = await listTableColumns(database, "serials");
+  if (columns.has("document_order")) {
+    return;
+  }
+  await database.transaction(async () => {
+    const transactionColumns = await listTableColumns(database, "serials");
+    if (transactionColumns.has("document_order")) {
+      return;
+    }
+    await database.run(`
+      ALTER TABLE serials
+      ADD COLUMN document_order INTEGER NOT NULL DEFAULT 0
+    `);
+  });
+}
+async function ensureSerialDocumentOrderIndex(database) {
+  await database.run(`
+    CREATE INDEX IF NOT EXISTS idx_serials_document_order
+    ON serials(document_order, id)
+  `);
+}
+async function migrateSerialStateRevision(database) {
+  const columns = await listTableColumns(database, "serial_states");
+  if (columns.has("revision")) {
+    return;
+  }
+  await database.transaction(async () => {
+    const transactionColumns = await listTableColumns(
+      database,
+      "serial_states"
+    );
+    if (transactionColumns.has("revision")) {
+      return;
+    }
+    await database.run(`
+      ALTER TABLE serial_states
+      ADD COLUMN revision INTEGER NOT NULL DEFAULT 0
+    `);
+  });
+}
+async function ensureGraphBuildParameterTable(database) {
+  await database.run(`
+    CREATE TABLE IF NOT EXISTS graph_build_parameters (
+      hash TEXT PRIMARY KEY,
+      prompt TEXT NOT NULL,
+      language TEXT,
+      created_at TEXT NOT NULL
+    )
+  `);
+}
+async function ensureGraphBuildParameterIndexes(database) {
+  await database.run(`
+    CREATE INDEX IF NOT EXISTS idx_serial_states_topology_parameter_hash
+    ON serial_states(topology_parameter_hash)
+  `);
+  await database.run(`
+    CREATE INDEX IF NOT EXISTS idx_serial_states_knowledge_graph_parameter_hash
+    ON serial_states(knowledge_graph_parameter_hash)
+  `);
+}
+async function migrateSerialStateKnowledgeGraphReady(database) {
+  const columns = await listTableColumns(database, "serial_states");
+  if (columns.has("knowledge_graph_ready")) {
+    return;
+  }
+  await database.transaction(async () => {
+    const transactionColumns = await listTableColumns(
+      database,
+      "serial_states"
+    );
+    if (transactionColumns.has("knowledge_graph_ready")) {
+      return;
+    }
+    await database.run(`
+      ALTER TABLE serial_states
+      ADD COLUMN knowledge_graph_ready INTEGER NOT NULL DEFAULT 0
+    `);
+  });
+}
+async function migrateSerialStateGraphParameterHashes(database) {
+  const columns = await listTableColumns(database, "serial_states");
+  const parameterColumns = [
+    ["topology_parameter_hash", "TEXT"],
+    ["knowledge_graph_parameter_hash", "TEXT"]
+  ];
+  const missingColumns = [];
+  for (const column of parameterColumns) {
+    if (!columns.has(column[0])) {
+      missingColumns.push(column);
+    }
+  }
+  if (missingColumns.length === 0) {
+    return;
+  }
+  await database.transaction(async () => {
+    const transactionColumns = await listTableColumns(
+      database,
+      "serial_states"
+    );
+    for (const [name, type] of missingColumns) {
+      if (transactionColumns.has(name)) {
+        continue;
+      }
+      await database.run(`
+        ALTER TABLE serial_states
+        ADD COLUMN ${name} ${type}
+      `);
+    }
+  });
+}
+async function listTableColumns(database, table) {
+  const columns = await database.queryAll(
+    `PRAGMA table_info(${table})`,
+    void 0,
+    (row) => String(row.name)
+  );
+  return new Set(columns);
+}
+export {
+  SCHEMA_SQL,
+  SEARCH_INDEX_SCHEMA_SQL,
+  initializeDocumentSchema
+};
+//# sourceMappingURL=schema.js.map

package/dist/document/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/document/schema.ts"],"sourcesContent":["import type { Database } from \"./database.js\";\n\nexport const SCHEMA_SQL = `\n  CREATE TABLE IF NOT EXISTS serials (\n    id INTEGER PRIMARY KEY,\n    document_order INTEGER NOT NULL DEFAULT 0\n  );\n\n  CREATE TABLE IF NOT EXISTS serial_states (\n    serial_id INTEGER PRIMARY KEY,\n    revision INTEGER NOT NULL DEFAULT 0,\n    topology_ready INTEGER NOT NULL DEFAULT 0,\n    topology_parameter_hash TEXT,\n    knowledge_graph_ready INTEGER NOT NULL DEFAULT 0,\n    knowledge_graph_parameter_hash TEXT,\n    FOREIGN KEY (serial_id) REFERENCES serials(id)\n  );\n\n  CREATE TABLE IF NOT EXISTS archive_revisions (\n    key TEXT PRIMARY KEY,\n    value INTEGER NOT NULL\n  );\n\n  CREATE TABLE IF NOT EXISTS archive_index_settings (\n    id INTEGER PRIMARY KEY CHECK (id = 1),\n    fts_embedded INTEGER NOT NULL DEFAULT 0\n  );\n\n  CREATE TABLE IF NOT EXISTS graph_build_parameters (\n    hash TEXT PRIMARY KEY,\n    prompt TEXT NOT NULL,\n    language TEXT,\n    created_at TEXT NOT NULL\n  );\n\n  CREATE TABLE IF NOT EXISTS chunks (\n    id INTEGER PRIMARY KEY,\n    generation INTEGER NOT NULL,\n    serial_id INTEGER NOT NULL,\n    sentence_index INTEGER NOT NULL,\n    label TEXT NOT NULL,\n    content TEXT NOT NULL,\n    retention TEXT,\n    importance TEXT,\n    wordsCount INTEGER NOT NULL DEFAULT 0,\n    weight REAL NOT NULL DEFAULT 0.0\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_chunks_sentence\n  ON chunks(serial_id, sentence_index);\n\n  CREATE INDEX IF NOT EXISTS idx_chunks_serial_id\n  ON chunks(serial_id, id);\n\n  CREATE TABLE IF NOT EXISTS chunk_sentences (\n    chunk_id INTEGER NOT NULL,\n    serial_id INTEGER NOT NULL,\n    sentence_index INTEGER NOT NULL,\n    FOREIGN KEY (chunk_id) REFERENCES chunks(id),\n    PRIMARY KEY (chunk_id, serial_id, sentence_index)\n  );\n\n  CREATE TABLE IF NOT EXISTS reading_edges (\n    from_id INTEGER NOT NULL,\n    to_id INTEGER NOT NULL,\n    strength TEXT,\n    weight REAL NOT NULL DEFAULT 0.1,\n    PRIMARY KEY (from_id, to_id),\n    FOREIGN KEY (from_id) REFERENCES chunks(id),\n    FOREIGN KEY (to_id) REFERENCES chunks(id)\n  );\n\n  CREATE TABLE IF NOT EXISTS snakes (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    serial_id INTEGER NOT NULL,\n    group_id INTEGER NOT NULL,\n    local_snake_id INTEGER NOT NULL,\n    size INTEGER NOT NULL,\n    first_label TEXT NOT NULL,\n    last_label TEXT NOT NULL,\n    wordsCount INTEGER NOT NULL DEFAULT 0,\n    weight REAL NOT NULL DEFAULT 0.0,\n    UNIQUE(serial_id, group_id, local_snake_id)\n  );\n\n  CREATE TABLE IF NOT EXISTS snake_chunks (\n    snake_id INTEGER NOT NULL,\n    chunk_id INTEGER NOT NULL,\n    position INTEGER NOT NULL,\n    FOREIGN KEY (snake_id) REFERENCES snakes(id),\n    FOREIGN KEY (chunk_id) REFERENCES chunks(id),\n    PRIMARY KEY (snake_id, chunk_id)\n  );\n\n  CREATE TABLE IF NOT EXISTS snake_edges (\n    from_snake_id INTEGER NOT NULL,\n    to_snake_id INTEGER NOT NULL,\n    weight REAL NOT NULL DEFAULT 0.1,\n    PRIMARY KEY (from_snake_id, to_snake_id),\n    FOREIGN KEY (from_snake_id) REFERENCES snakes(id),\n    FOREIGN KEY (to_snake_id) REFERENCES snakes(id)\n  );\n\n  CREATE TABLE IF NOT EXISTS sentence_groups (\n    serial_id INTEGER NOT NULL,\n    group_id INTEGER NOT NULL,\n    start_sentence_index INTEGER NOT NULL,\n    end_sentence_index INTEGER NOT NULL,\n    PRIMARY KEY (serial_id, group_id, start_sentence_index, end_sentence_index)\n  );\n\n  CREATE TABLE IF NOT EXISTS mentions (\n    id TEXT PRIMARY KEY,\n    chapter_id INTEGER NOT NULL,\n    sentence_index INTEGER,\n    range_start INTEGER NOT NULL,\n    range_end INTEGER NOT NULL,\n    surface TEXT NOT NULL,\n    qid TEXT NOT NULL,\n    confidence REAL,\n    note TEXT,\n    FOREIGN KEY (chapter_id) REFERENCES serials(id)\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_mentions_chapter\n  ON mentions(chapter_id);\n\n  CREATE INDEX IF NOT EXISTS idx_mentions_chapter_position\n  ON mentions(chapter_id, sentence_index, range_start, range_end, id);\n\n  CREATE INDEX IF NOT EXISTS idx_mentions_chapter_qid\n  ON mentions(chapter_id, qid);\n\n  CREATE INDEX IF NOT EXISTS idx_mentions_qid\n  ON mentions(qid);\n\n  CREATE INDEX IF NOT EXISTS idx_mentions_qid_position\n  ON mentions(qid, chapter_id, sentence_index, range_start, range_end, id);\n\n  CREATE INDEX IF NOT EXISTS idx_mentions_surface\n  ON mentions(surface);\n\n  CREATE INDEX IF NOT EXISTS idx_mentions_surface_position\n  ON mentions(surface, chapter_id, sentence_index, range_start, range_end, id);\n\n  CREATE INDEX IF NOT EXISTS idx_mentions_sentence\n  ON mentions(chapter_id, sentence_index);\n\n  CREATE TABLE IF NOT EXISTS mention_links (\n    id TEXT PRIMARY KEY,\n    source_mention_id TEXT NOT NULL,\n    target_mention_id TEXT NOT NULL,\n    predicate TEXT NOT NULL,\n    confidence REAL,\n    note TEXT,\n    FOREIGN KEY (source_mention_id) REFERENCES mentions(id),\n    FOREIGN KEY (target_mention_id) REFERENCES mentions(id)\n  );\n\n  CREATE TABLE IF NOT EXISTS mention_link_evidence_sentences (\n    link_id TEXT NOT NULL,\n    chapter_id INTEGER NOT NULL,\n    sentence_index INTEGER NOT NULL,\n    FOREIGN KEY (link_id) REFERENCES mention_links(id),\n    PRIMARY KEY (link_id, chapter_id, sentence_index)\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_mention_link_evidence_sentences_sentence\n  ON mention_link_evidence_sentences(chapter_id, sentence_index);\n\n  CREATE INDEX IF NOT EXISTS idx_mention_links_source\n  ON mention_links(source_mention_id);\n\n  CREATE INDEX IF NOT EXISTS idx_mention_links_target\n  ON mention_links(target_mention_id);\n\n  CREATE INDEX IF NOT EXISTS idx_mention_links_predicate\n  ON mention_links(predicate);\n\n  CREATE INDEX IF NOT EXISTS idx_mention_links_predicate_source_target\n  ON mention_links(predicate, source_mention_id, target_mention_id);\n\n  CREATE INDEX IF NOT EXISTS idx_mention_links_predicate_target_source\n  ON mention_links(predicate, target_mention_id, source_mention_id);\n\n  CREATE INDEX IF NOT EXISTS idx_mention_links_source_predicate_target\n  ON mention_links(source_mention_id, predicate, target_mention_id);\n\n  CREATE INDEX IF NOT EXISTS idx_mention_links_target_predicate_source\n  ON mention_links(target_mention_id, predicate, source_mention_id);\n\n  CREATE INDEX IF NOT EXISTS idx_mention_links_source_target_predicate\n  ON mention_links(source_mention_id, target_mention_id, predicate);\n\n  CREATE INDEX IF NOT EXISTS idx_reading_edges_target\n  ON reading_edges(to_id, from_id);\n\n  CREATE INDEX IF NOT EXISTS idx_snake_edges_target\n  ON snake_edges(to_snake_id, from_snake_id);\n\n  CREATE VIEW IF NOT EXISTS chapter_entities AS\n  SELECT\n    chapter_id,\n    qid,\n    COUNT(*) AS mention_count\n  FROM mentions\n  GROUP BY chapter_id, qid;\n\n  CREATE VIEW IF NOT EXISTS book_entities AS\n  SELECT\n    qid,\n    SUM(mention_count) AS mention_count\n  FROM chapter_entities\n  GROUP BY qid;\n\n  CREATE VIEW IF NOT EXISTS chapter_entity_relations AS\n  SELECT\n    source_mentions.chapter_id AS chapter_id,\n    source_mentions.qid AS subject_qid,\n    mention_links.predicate AS predicate,\n    target_mentions.qid AS object_qid,\n    COUNT(*) AS evidence_count\n  FROM mention_links\n  JOIN mentions AS source_mentions\n    ON source_mentions.id = mention_links.source_mention_id\n  JOIN mentions AS target_mentions\n    ON target_mentions.id = mention_links.target_mention_id\n  WHERE source_mentions.chapter_id = target_mentions.chapter_id\n  GROUP BY\n    source_mentions.chapter_id,\n    source_mentions.qid,\n    mention_links.predicate,\n    target_mentions.qid;\n\n  CREATE VIEW IF NOT EXISTS book_entity_relations AS\n  SELECT\n    subject_qid,\n    predicate,\n    object_qid,\n    SUM(evidence_count) AS evidence_count\n  FROM chapter_entity_relations\n  GROUP BY subject_qid, predicate, object_qid;\n\n  CREATE TABLE IF NOT EXISTS text_sentence_records (\n    id INTEGER PRIMARY KEY,\n    kind INTEGER NOT NULL,\n    chapter_id INTEGER NOT NULL,\n    sentence_index INTEGER NOT NULL,\n    words_count INTEGER NOT NULL DEFAULT 0,\n    byte_offset INTEGER NOT NULL DEFAULT 0,\n    byte_length INTEGER NOT NULL DEFAULT 0,\n    UNIQUE(kind, chapter_id, sentence_index)\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_text_sentence_records_chapter\n  ON text_sentence_records(kind, chapter_id, sentence_index);\n\n  CREATE TABLE IF NOT EXISTS object_metadata (\n    id INTEGER PRIMARY KEY,\n    object_kind INTEGER NOT NULL,\n    object_path TEXT NOT NULL,\n    key TEXT NOT NULL,\n    value_json TEXT NOT NULL,\n    updated_at TEXT NOT NULL,\n    chapter_id INTEGER,\n    chunk_id INTEGER,\n    entity_qid TEXT,\n    triple_subject_qid TEXT,\n    triple_predicate TEXT,\n    triple_object_qid TEXT,\n    UNIQUE(object_path, key)\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_object_metadata_object\n  ON object_metadata(object_path);\n\n  CREATE INDEX IF NOT EXISTS idx_object_metadata_chapter\n  ON object_metadata(chapter_id);\n\n  CREATE INDEX IF NOT EXISTS idx_object_metadata_chunk\n  ON object_metadata(chunk_id);\n\n  CREATE INDEX IF NOT EXISTS idx_object_metadata_entity\n  ON object_metadata(entity_qid);\n\n  CREATE INDEX IF NOT EXISTS idx_object_metadata_triple\n  ON object_metadata(\n    triple_subject_qid,\n    triple_predicate,\n    triple_object_qid\n  );\n`;\n\nexport const SEARCH_INDEX_SCHEMA_SQL = `\n  CREATE TABLE IF NOT EXISTS search_index_state (\n    key TEXT PRIMARY KEY,\n    value TEXT NOT NULL\n  );\n\n  CREATE TABLE IF NOT EXISTS text_sentence_records (\n    id INTEGER PRIMARY KEY,\n    kind INTEGER NOT NULL,\n    chapter_id INTEGER NOT NULL,\n    sentence_index INTEGER NOT NULL,\n    words_count INTEGER NOT NULL DEFAULT 0,\n    byte_offset INTEGER NOT NULL DEFAULT 0,\n    byte_length INTEGER NOT NULL DEFAULT 0,\n    UNIQUE(kind, chapter_id, sentence_index)\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_text_sentence_records_chapter\n  ON text_sentence_records(kind, chapter_id, sentence_index);\n\n  CREATE VIRTUAL TABLE IF NOT EXISTS text_sentence_fts USING fts5(\n    tier1,\n    tier2,\n    tier3,\n    tokenize='ascii'\n  );\n\n  CREATE TABLE IF NOT EXISTS search_object_properties_records (\n    id INTEGER PRIMARY KEY,\n    owner_kind INTEGER NOT NULL,\n    owner_id TEXT NOT NULL,\n    property_kind INTEGER NOT NULL,\n    chapter_id INTEGER\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_search_object_properties_records_owner\n  ON search_object_properties_records(owner_kind, owner_id);\n\n  CREATE INDEX IF NOT EXISTS idx_search_object_properties_records_chapter\n  ON search_object_properties_records(chapter_id, owner_kind, owner_id);\n\n  CREATE VIRTUAL TABLE IF NOT EXISTS search_object_properties_fts USING fts5(\n    tier1,\n    tier2,\n    tier3,\n    tokenize='ascii'\n  );\n`;\n\nexport async function initializeDocumentSchema(\n  database: Database,\n): Promise<void> {\n  await migrateSerialDocumentOrder(database);\n  await ensureGraphBuildParameterTable(database);\n  await migrateSerialStateRevision(database);\n  await migrateSerialStateKnowledgeGraphReady(database);\n  await migrateSerialStateGraphParameterHashes(database);\n  await ensureSerialDocumentOrderIndex(database);\n  await ensureGraphBuildParameterIndexes(database);\n}\n\nasync function migrateSerialDocumentOrder(database: Database): Promise<void> {\n  const columns = await listTableColumns(database, \"serials\");\n\n  if (columns.has(\"document_order\")) {\n    return;\n  }\n\n  await database.transaction(async () => {\n    const transactionColumns = await listTableColumns(database, \"serials\");\n\n    if (transactionColumns.has(\"document_order\")) {\n      return;\n    }\n\n    await database.run(`\n      ALTER TABLE serials\n      ADD COLUMN document_order INTEGER NOT NULL DEFAULT 0\n    `);\n  });\n}\n\nasync function ensureSerialDocumentOrderIndex(\n  database: Database,\n): Promise<void> {\n  await database.run(`\n    CREATE INDEX IF NOT EXISTS idx_serials_document_order\n    ON serials(document_order, id)\n  `);\n}\n\nasync function migrateSerialStateRevision(database: Database): Promise<void> {\n  const columns = await listTableColumns(database, \"serial_states\");\n\n  if (columns.has(\"revision\")) {\n    return;\n  }\n\n  await database.transaction(async () => {\n    const transactionColumns = await listTableColumns(\n      database,\n      \"serial_states\",\n    );\n\n    if (transactionColumns.has(\"revision\")) {\n      return;\n    }\n\n    await database.run(`\n      ALTER TABLE serial_states\n      ADD COLUMN revision INTEGER NOT NULL DEFAULT 0\n    `);\n  });\n}\n\nasync function ensureGraphBuildParameterTable(\n  database: Database,\n): Promise<void> {\n  await database.run(`\n    CREATE TABLE IF NOT EXISTS graph_build_parameters (\n      hash TEXT PRIMARY KEY,\n      prompt TEXT NOT NULL,\n      language TEXT,\n      created_at TEXT NOT NULL\n    )\n  `);\n}\n\nasync function ensureGraphBuildParameterIndexes(\n  database: Database,\n): Promise<void> {\n  await database.run(`\n    CREATE INDEX IF NOT EXISTS idx_serial_states_topology_parameter_hash\n    ON serial_states(topology_parameter_hash)\n  `);\n  await database.run(`\n    CREATE INDEX IF NOT EXISTS idx_serial_states_knowledge_graph_parameter_hash\n    ON serial_states(knowledge_graph_parameter_hash)\n  `);\n}\n\nasync function migrateSerialStateKnowledgeGraphReady(\n  database: Database,\n): Promise<void> {\n  const columns = await listTableColumns(database, \"serial_states\");\n\n  if (columns.has(\"knowledge_graph_ready\")) {\n    return;\n  }\n\n  await database.transaction(async () => {\n    const transactionColumns = await listTableColumns(\n      database,\n      \"serial_states\",\n    );\n\n    if (transactionColumns.has(\"knowledge_graph_ready\")) {\n      return;\n    }\n\n    await database.run(`\n      ALTER TABLE serial_states\n      ADD COLUMN knowledge_graph_ready INTEGER NOT NULL DEFAULT 0\n    `);\n  });\n}\n\nasync function migrateSerialStateGraphParameterHashes(\n  database: Database,\n): Promise<void> {\n  const columns = await listTableColumns(database, \"serial_states\");\n  const parameterColumns = [\n    [\"topology_parameter_hash\", \"TEXT\"],\n    [\"knowledge_graph_parameter_hash\", \"TEXT\"],\n  ] as const;\n  const missingColumns: Array<(typeof parameterColumns)[number]> = [];\n\n  for (const column of parameterColumns) {\n    if (!columns.has(column[0])) {\n      missingColumns.push(column);\n    }\n  }\n\n  if (missingColumns.length === 0) {\n    return;\n  }\n\n  await database.transaction(async () => {\n    const transactionColumns = await listTableColumns(\n      database,\n      \"serial_states\",\n    );\n\n    for (const [name, type] of missingColumns) {\n      if (transactionColumns.has(name)) {\n        continue;\n      }\n\n      await database.run(`\n        ALTER TABLE serial_states\n        ADD COLUMN ${name} ${type}\n      `);\n    }\n  });\n}\n\nasync function listTableColumns(\n  database: Database,\n  table: string,\n): Promise<ReadonlySet<string>> {\n  const columns = await database.queryAll(\n    `PRAGMA table_info(${table})`,\n    undefined,\n    (row) => String(row.name),\n  );\n\n  return new Set(columns);\n}\n"],"mappings":"AAEO,MAAM,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;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","names":[]}

package/dist/document/shared-state-database.d.ts

@@ -0,0 +1,9 @@
+import { Database } from './database.js';
+import 'sqlite3';
+
+declare function openSharedStateDatabase(databasePath: string, schemaSql: string, options?: {
+    readonly readonly?: boolean;
+}): Promise<Database>;
+declare function ensureSharedStateDatabaseInitialized(databasePath: string, schemaSql: string): Promise<void>;
+
+export { ensureSharedStateDatabaseInitialized, openSharedStateDatabase };