@wiki0/core 0.0.3 → 0.0.4

package/README.md

@@ -8,9 +8,14 @@ Core wiki0 primitives for local-first Markdown wiki memory.
 - Obsidian-style `[[WikiLinks]]` parsing.
 - Page create/read/append/frontmatter operations.
 - SQLite indexing and FTS search.
-- Context snippets with `wiki/...` citations.
+- Chunk-level context snippets with `wiki/path.md:line-line`
+  citations.
+- Direct indexed chunk lookup for known `path:line` targets.
 - Backlinks, graph data, lint results, review queues, and structured
-  facts.
+  facts with optional source-line provenance.
+- Stale-index warnings in context responses.
+- Lightweight topic threads and operation logs for agent workflows.
+- Frontmatter-aware chunk ranking using priority, status, and tags.
 - Wiki-building workflow planning for agents that need a deterministic
   source-to-wiki recipe.
 
@@ -18,31 +23,41 @@ Core wiki0 primitives for local-first Markdown wiki memory.
 
 ```ts
 import {
-  bootstrap_wiki,
-  create_page,
-  index_status,
-  index_wiki,
-  search_wiki,
-  get_wiki_context,
-  lint_wiki,
-  plan_wiki,
-} from "@wiki0/core";
-
-create_page("projects/wiki0", "Local-first [[topics/memory]].", {
-  root: ".",
+	bootstrap_wiki,
+	create_page,
+	index_status,
+	index_wiki,
+	search_wiki,
+	get_wiki_context,
+	lint_wiki,
+	plan_wiki,
+} from '@wiki0/core';
+
+create_page('projects/wiki0', 'Local-first [[topics/memory]].', {
+	root: '.',
 });
-index_wiki(".");
-console.log(index_status("."));
-console.log(search_wiki("memory", ".", 10));
-console.log(get_wiki_context("what is wiki0?", ".", 5).markdown);
-console.log(lint_wiki("."));
-console.log(plan_wiki({ sourceType: "codebase", scope: "current repo" }));
-console.log(bootstrap_wiki({ root: ".", sourceType: "docs" }));
+index_wiki('.');
+console.log(index_status('.'));
+console.log(search_wiki('memory', '.', 10));
+console.log(get_wiki_context('what is wiki0?', '.', 5).markdown);
+console.log(lint_wiki('.'));
+console.log(
+	plan_wiki({ source_type: 'codebase', scope: 'current repo' }),
+);
+console.log(
+	bootstrap_wiki({
+		root: '.',
+		source_type: 'docs',
+		sources: ['docs/guide.md'],
+		ingest_sources: true,
+	}),
+);
 ```
 
 ## Storage model
 
 Markdown files under `wiki/` are canonical. The `.wiki0/wiki0.sqlite`
 database is a rebuildable cache for search, backlinks, graph data, and
-facts. `index_status` reports indexed-at time, schema version, and
-stale reasons when Markdown has changed since the last rebuild.
+facts. `index_status` reports indexed-at time, schema/package
+versions, and stale reasons when Markdown or index metadata has
+changed since the last rebuild.

package/dist/events.d.ts

@@ -0,0 +1,9 @@
+import type { WikiEvent } from './types.js';
+export declare function log_wiki_event(options: {
+    root?: string;
+    operation: string;
+    summary: string;
+    target?: string;
+    details?: unknown;
+}): WikiEvent;
+export declare function list_wiki_events(root?: string, limit?: number): WikiEvent[];

package/dist/events.js

@@ -0,0 +1,56 @@
+import { open_wiki_database } from './database.js';
+import { resolve_wiki_root } from './paths.js';
+export function log_wiki_event(options) {
+    const wiki_root = resolve_wiki_root(options.root);
+    const db = open_wiki_database(wiki_root);
+    ensure_events_table(db);
+    const result = db
+        .prepare(`INSERT INTO wiki_events (operation, summary, target, details)
+			VALUES (?, ?, ?, ?)`)
+        .run(options.operation, options.summary, options.target ?? null, options.details === undefined
+        ? null
+        : JSON.stringify(options.details));
+    const event = select_event_by_id(db, Number(result.lastInsertRowid));
+    db.close();
+    return event;
+}
+export function list_wiki_events(root = '.', limit = 50) {
+    const db = open_wiki_database(root);
+    ensure_events_table(db);
+    const rows = db
+        .prepare(`SELECT id, operation, summary, target, details, created_at
+			FROM wiki_events
+			ORDER BY id DESC
+			LIMIT ?`)
+        .all(limit);
+    db.close();
+    return rows.map(event_from_row);
+}
+function select_event_by_id(db, id) {
+    const row = db
+        .prepare(`SELECT id, operation, summary, target, details, created_at
+			FROM wiki_events WHERE id = ?`)
+        .get(id);
+    return event_from_row(row);
+}
+function event_from_row(row) {
+    return {
+        id: Number(row.id),
+        operation: String(row.operation),
+        summary: String(row.summary),
+        target: row.target === null ? null : String(row.target),
+        details: row.details === null ? null : String(row.details),
+        created_at: String(row.created_at),
+    };
+}
+function ensure_events_table(db) {
+    db.exec(`CREATE TABLE IF NOT EXISTS wiki_events (
+		id INTEGER PRIMARY KEY AUTOINCREMENT,
+		operation TEXT NOT NULL,
+		summary TEXT NOT NULL,
+		target TEXT,
+		details TEXT,
+		created_at TEXT DEFAULT (datetime('now'))
+	)`);
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAqB,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG/C,MAAM,UAAU,cAAc,CAAC,OAM9B;IACA,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,EAAE,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACzC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IACxB,MAAM,MAAM,GAAG,EAAE;SACf,OAAO,CACP;uBACoB,CACpB;SACA,GAAG,CACH,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,MAAM,IAAI,IAAI,EACtB,OAAO,CAAC,OAAO,KAAK,SAAS;QAC5B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAClC,CAAC;IACH,MAAM,KAAK,GAAG,kBAAkB,CAC/B,EAAE,EACF,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAC9B,CAAC;IACF,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,KAAK,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC/B,IAAI,GAAG,GAAG,EACV,KAAK,GAAG,EAAE;IAEV,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACpC,mBAAmB,CAAC,EAAE,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,EAAE;SACb,OAAO,CACP;;;WAGQ,CACR;SACA,GAAG,CAAC,KAAK,CAAqC,CAAC;IACjD,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,kBAAkB,CAAC,EAAgB,EAAE,EAAU;IACvD,MAAM,GAAG,GAAG,EAAE;SACZ,OAAO,CACP;iCAC8B,CAC9B;SACA,GAAG,CAAC,EAAE,CAAmC,CAAC;IAC5C,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,cAAc,CACtB,GAAmC;IAEnC,OAAO;QACN,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;QAChC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;QACvD,OAAO,EAAE,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QAC1D,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;KAClC,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,EAAgB;IAC5C,EAAE,CAAC,IAAI,CAAC;;;;;;;GAON,CAAC,CAAC;AACL,CAAC"}

package/dist/facts.js

@@ -1,43 +1,105 @@
 import { open_wiki_database } from './database.js';
+import { log_wiki_event } from './events.js';
 import { resolve_page_path } from './pages.js';
 import { resolve_wiki_root } from './paths.js';
+import { show_wiki_chunk } from './search.js';
 export function add_fact(fact) {
     const wiki_root = resolve_wiki_root(fact.root);
     const db = open_wiki_database(wiki_root);
+    ensure_fact_provenance_columns(db);
+    const source_chunk = fact.source
+        ? show_wiki_chunk(fact.source, wiki_root)
+        : null;
     const page_path = fact.page
         ? resolve_page_path(fact.page, wiki_root)
-        : null;
+        : (source_chunk?.path ?? null);
     const page = page_path
         ? db
             .prepare('SELECT id FROM pages WHERE path = ?')
             .get(page_path)
         : undefined;
     const result = db
-        .prepare(`INSERT INTO facts (page_id, category, summary, body, confidence)
-			VALUES (?, ?, ?, ?, ?)`)
-        .run(page?.id ?? null, fact.category, fact.summary, fact.body ?? null, fact.confidence ?? 'unknown');
-    const inserted = db
-        .prepare(`SELECT facts.id, pages.path AS pagePath, facts.category,
-				facts.summary, facts.body, facts.confidence, facts.created_at AS createdAt
-			FROM facts
-			LEFT JOIN pages ON pages.id = facts.page_id
-			WHERE facts.id = ?`)
-        .get(result.lastInsertRowid);
+        .prepare(`INSERT INTO facts (
+				page_id, category, summary, body, confidence,
+				source_path, source_heading, source_start_line, source_end_line, source_quote
+			)
+			VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+        .run(page?.id ?? null, fact.category, fact.summary, fact.body ?? null, fact.confidence ?? 'unknown', source_chunk?.path ?? null, source_chunk?.heading ?? null, source_chunk?.start_line ?? null, source_chunk?.end_line ?? null, fact.source_quote ?? source_quote(source_chunk));
+    const inserted = select_fact_by_id(db, Number(result.lastInsertRowid));
     db.close();
+    log_wiki_event({
+        root: wiki_root,
+        operation: 'add_fact',
+        summary: fact.summary,
+        target: page_path ?? source_chunk?.path ?? undefined,
+        details: {
+            category: fact.category,
+            confidence: inserted.confidence,
+        },
+    });
     return inserted;
 }
 export function list_facts(root = '.', category) {
     const db = open_wiki_database(root);
-    const sql = `SELECT facts.id, pages.path AS pagePath, facts.category,
-		facts.summary, facts.body, facts.confidence, facts.created_at AS createdAt
-		FROM facts
-		LEFT JOIN pages ON pages.id = facts.page_id
+    ensure_fact_provenance_columns(db);
+    const sql = `${fact_select_sql}
 		${category ? 'WHERE facts.category = ?' : ''}
 		ORDER BY facts.created_at DESC, facts.id DESC`;
     const rows = category
         ? db.prepare(sql).all(category)
         : db.prepare(sql).all();
     db.close();
-    return rows;
+    return rows.map(fact_from_row);
+}
+const fact_select_sql = `SELECT facts.id, pages.path AS page_path, facts.category,
+	facts.summary, facts.body, facts.confidence,
+	facts.source_path, facts.source_heading, facts.source_start_line,
+	facts.source_end_line, facts.source_quote, facts.created_at AS created_at
+	FROM facts
+	LEFT JOIN pages ON pages.id = facts.page_id`;
+function select_fact_by_id(db, id) {
+    const row = db
+        .prepare(`${fact_select_sql} WHERE facts.id = ?`)
+        .get(id);
+    return fact_from_row(row);
+}
+function fact_from_row(row) {
+    return {
+        id: Number(row.id),
+        page_path: row.page_path === null ? null : String(row.page_path),
+        category: String(row.category),
+        summary: String(row.summary),
+        body: row.body === null ? null : String(row.body),
+        confidence: String(row.confidence),
+        source_path: row.source_path === null ? null : String(row.source_path),
+        source_heading: row.source_heading === null ? null : String(row.source_heading),
+        source_start_line: row.source_start_line === null
+            ? null
+            : Number(row.source_start_line),
+        source_end_line: row.source_end_line === null
+            ? null
+            : Number(row.source_end_line),
+        source_quote: row.source_quote === null ? null : String(row.source_quote),
+        created_at: String(row.created_at),
+    };
+}
+function source_quote(source_chunk) {
+    if (!source_chunk)
+        return null;
+    return source_chunk.body.slice(0, 1000);
+}
+function ensure_fact_provenance_columns(db) {
+    const columns = new Set(db.prepare('PRAGMA table_info(facts)').all().map((column) => column.name));
+    const migrations = {
+        source_path: 'ALTER TABLE facts ADD COLUMN source_path TEXT',
+        source_heading: 'ALTER TABLE facts ADD COLUMN source_heading TEXT',
+        source_start_line: 'ALTER TABLE facts ADD COLUMN source_start_line INTEGER',
+        source_end_line: 'ALTER TABLE facts ADD COLUMN source_end_line INTEGER',
+        source_quote: 'ALTER TABLE facts ADD COLUMN source_quote TEXT',
+    };
+    for (const [column_name, sql] of Object.entries(migrations)) {
+        if (!columns.has(column_name))
+            db.exec(sql);
+    }
 }
 //# sourceMappingURL=facts.js.map

package/dist/facts.js.map

@@ -1 +1 @@
-{"version":3,"file":"facts.js","sourceRoot":"","sources":["../src/facts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG/C,MAAM,UAAU,QAAQ,CAAC,IAAsB;IAC9C,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,EAAE,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI;QAC1B,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;QACzC,CAAC,CAAC,IAAI,CAAC;IACR,MAAM,IAAI,GAAG,SAAS;QACrB,CAAC,CAAE,EAAE;aACF,OAAO,CAAC,qCAAqC,CAAC;aAC9C,GAAG,CAAC,SAAS,CAAgC;QAChD,CAAC,CAAC,SAAS,CAAC;IAEb,MAAM,MAAM,GAAG,EAAE;SACf,OAAO,CACP;0BACuB,CACvB;SACA,GAAG,CACH,IAAI,EAAE,EAAE,IAAI,IAAI,EAChB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,IAAI,IAAI,IAAI,EACjB,IAAI,CAAC,UAAU,IAAI,SAAS,CAC5B,CAAC;IACH,MAAM,QAAQ,GAAG,EAAE;SACjB,OAAO,CACP;;;;sBAImB,CACnB;SACA,GAAG,CAAC,MAAM,CAAC,eAAe,CAAS,CAAC;IACtC,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAI,GAAG,GAAG,EAAE,QAAiB;IACvD,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG;;;;IAIT,QAAQ,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,EAAE;gDACE,CAAC;IAChD,MAAM,IAAI,GAAG,QAAQ;QACpB,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC/B,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IACzB,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,IAAc,CAAC;AACvB,CAAC"}
+{"version":3,"file":"facts.js","sourceRoot":"","sources":["../src/facts.ts"],"names":[],"mappings":"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"}

package/dist/graph.js

@@ -6,11 +6,11 @@ export function graph_wiki(root = '.') {
     const nodes = db
         .prepare('SELECT path, title FROM pages ORDER BY path')
         .all();
-    const edges = db
+    const edge_rows = db
         .prepare(`SELECT pages.path AS "from",
 				COALESCE(page_links.to_path, page_links.target) AS "to",
 				page_links.target,
-				page_links.raw_text AS rawText,
+				page_links.raw_text AS raw_text,
 				page_links.alias,
 				page_links.embed,
 				page_links.status
@@ -19,6 +19,7 @@ export function graph_wiki(root = '.') {
 			ORDER BY pages.path, page_links.target`)
         .all();
     db.close();
+    const edges = edge_rows.map(graph_edge_from_row);
     return {
         root: wiki_root,
         nodes,
@@ -31,4 +32,15 @@ export function graph_wiki(root = '.') {
         })),
     };
 }
+function graph_edge_from_row(row) {
+    return {
+        from: String(row.from),
+        to: String(row.to),
+        target: String(row.target),
+        raw_text: String(row.raw_text),
+        alias: row.alias === null ? null : String(row.alias),
+        embed: Boolean(row.embed),
+        status: row.status === 'resolved' ? 'resolved' : 'unresolved',
+    };
+}
 //# sourceMappingURL=graph.js.map

package/dist/graph.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph.js","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGrE,MAAM,UAAU,UAAU,CAAC,IAAI,GAAG,GAAG;IACpC,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,EAAE,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,EAAE;SACd,OAAO,CAAC,6CAA6C,CAAC;SACtD,GAAG,EAAiB,CAAC;IACvB,MAAM,KAAK,GAAG,EAAE;SACd,OAAO,CACP;;;;;;;;;0CASuC,CACvC;SACA,GAAG,EAA4B,CAAC;IAClC,EAAE,CAAC,KAAK,EAAE,CAAC;IAEX,OAAO;QACN,IAAI,EAAE,SAAS;QACf,KAAK;QACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC3B,GAAG,IAAI;YACP,EAAE,EACD,IAAI,CAAC,MAAM,KAAK,UAAU;gBACzB,CAAC,CAAC,IAAI,CAAC,EAAE;gBACT,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC;YACrC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;SAC1B,CAAC,CAAC;KACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGrE,MAAM,UAAU,UAAU,CAAC,IAAI,GAAG,GAAG;IACpC,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,EAAE,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,EAAE;SACd,OAAO,CAAC,6CAA6C,CAAC;SACtD,GAAG,EAAiB,CAAC;IACvB,MAAM,SAAS,GAAG,EAAE;SAClB,OAAO,CACP;;;;;;;;;0CASuC,CACvC;SACA,GAAG,EAAsC,CAAC;IAC5C,EAAE,CAAC,KAAK,EAAE,CAAC;IAEX,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACjD,OAAO;QACN,IAAI,EAAE,SAAS;QACf,KAAK;QACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC3B,GAAG,IAAI;YACP,EAAE,EACD,IAAI,CAAC,MAAM,KAAK,UAAU;gBACzB,CAAC,CAAC,IAAI,CAAC,EAAE;gBACT,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC;YACrC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;SAC1B,CAAC,CAAC;KACH,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAC3B,GAAmC;IAEnC,OAAO;QACN,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QACtB,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;QAC1B,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC9B,KAAK,EAAE,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;QACpD,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;QACzB,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY;KAC7D,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -1,13 +1,15 @@
 export { open_wiki_database, wiki_db_path } from './database.js';
+export { list_wiki_events, log_wiki_event } from './events.js';
 export { add_fact, list_facts } from './facts.js';
 export { graph_wiki } from './graph.js';
-export { current_index_schema_version, index_status, index_wiki, } from './indexer.js';
+export { current_index_package_version, current_index_schema_version, index_status, index_wiki, } from './indexer.js';
 export { lint_wiki } from './lint.js';
 export { page_title_from_markdown, parse_frontmatter, parse_markdown, parse_wikilinks, serialize_frontmatter, strip_fenced_code_blocks, strip_inline_code, } from './markdown.js';
 export { append_page, create_page, list_markdown_page_paths, read_page, resolve_page_path, set_page_frontmatter, } from './pages.js';
 export { display_page_title, page_file_path, page_relative_path, resolve_wiki_root, slugify_title, wikilink_target_path, } from './paths.js';
 export { review_wiki } from './review.js';
 export { schema_sql } from './schema.js';
-export { backlinks_for_page, format_context_markdown, get_wiki_context, search_wiki, } from './search.js';
+export { backlinks_for_page, format_context_markdown, get_wiki_context, search_wiki, search_wiki_chunks, show_wiki_chunk, } from './search.js';
+export { list_topic_threads } from './topics.js';
 export type * from './types.js';
 export { bootstrap_wiki, plan_wiki, wiki_building_workflow_markdown, } from './workflow.js';

package/dist/index.js

@@ -1,13 +1,15 @@
 export { open_wiki_database, wiki_db_path } from './database.js';
+export { list_wiki_events, log_wiki_event } from './events.js';
 export { add_fact, list_facts } from './facts.js';
 export { graph_wiki } from './graph.js';
-export { current_index_schema_version, index_status, index_wiki, } from './indexer.js';
+export { current_index_package_version, current_index_schema_version, index_status, index_wiki, } from './indexer.js';
 export { lint_wiki } from './lint.js';
 export { page_title_from_markdown, parse_frontmatter, parse_markdown, parse_wikilinks, serialize_frontmatter, strip_fenced_code_blocks, strip_inline_code, } from './markdown.js';
 export { append_page, create_page, list_markdown_page_paths, read_page, resolve_page_path, set_page_frontmatter, } from './pages.js';
 export { display_page_title, page_file_path, page_relative_path, resolve_wiki_root, slugify_title, wikilink_target_path, } from './paths.js';
 export { review_wiki } from './review.js';
 export { schema_sql } from './schema.js';
-export { backlinks_for_page, format_context_markdown, get_wiki_context, search_wiki, } from './search.js';
+export { backlinks_for_page, format_context_markdown, get_wiki_context, search_wiki, search_wiki_chunks, show_wiki_chunk, } from './search.js';
+export { list_topic_threads } from './topics.js';
 export { bootstrap_wiki, plan_wiki, wiki_building_workflow_markdown, } from './workflow.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EACN,4BAA4B,EAC5B,YAAY,EACZ,UAAU,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EACN,wBAAwB,EACxB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,WAAW,EACX,WAAW,EACX,wBAAwB,EACxB,SAAS,EACT,iBAAiB,EACjB,oBAAoB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,oBAAoB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACN,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,GACX,MAAM,aAAa,CAAC;AAErB,OAAO,EACN,cAAc,EACd,SAAS,EACT,+BAA+B,GAC/B,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EACN,6BAA6B,EAC7B,4BAA4B,EAC5B,YAAY,EACZ,UAAU,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EACN,wBAAwB,EACxB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,WAAW,EACX,WAAW,EACX,wBAAwB,EACxB,SAAS,EACT,iBAAiB,EACjB,oBAAoB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,oBAAoB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACN,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,eAAe,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EACN,cAAc,EACd,SAAS,EACT,+BAA+B,GAC/B,MAAM,eAAe,CAAC"}

package/dist/indexer.d.ts

@@ -1,4 +1,14 @@
 import type { IndexResult, IndexStatus } from './types.js';
-export declare const current_index_schema_version = 1;
+export declare const current_index_schema_version = 4;
+export declare const current_index_package_version: string;
 export declare function index_wiki(root?: string): IndexResult;
+type PageChunk = {
+    heading: string | null;
+    body: string;
+    start_line: number;
+    end_line: number;
+    sequence: number;
+};
+export declare function chunk_page_body(body: string): PageChunk[];
 export declare function index_status(root?: string): IndexStatus;
+export {};

package/dist/indexer.js

@@ -1,14 +1,17 @@
 import { createHash } from 'node:crypto';
-import { existsSync, statSync } from 'node:fs';
+import { existsSync, readFileSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import { open_wiki_database, wiki_db_path } from './database.js';
+import { log_wiki_event } from './events.js';
 import { list_markdown_page_paths, read_page_by_path, } from './pages.js';
 import { resolve_wiki_root, wikilink_target_path } from './paths.js';
-export const current_index_schema_version = 1;
+export const current_index_schema_version = 4;
+export const current_index_package_version = read_package_version();
 export function index_wiki(root = '.') {
     const wiki_root = resolve_wiki_root(root);
     const db_path = wiki_db_path(wiki_root);
     const db = open_wiki_database(wiki_root);
+    ensure_index_schema(db);
     let page_count = 0;
     let link_count = 0;
     const upsert_page = db.prepare(`
@@ -28,7 +31,17 @@ export function index_wiki(root = '.') {
 		VALUES (?, ?, ?, ?, ?, ?, ?)
 	`);
     const clear_fts = db.prepare('DELETE FROM fts_pages');
+    const clear_chunks = db.prepare('DELETE FROM page_chunks');
+    const clear_chunk_fts = db.prepare('DELETE FROM fts_page_chunks');
     const insert_fts = db.prepare('INSERT INTO fts_pages (path, title, body) VALUES (?, ?, ?)');
+    const insert_chunk = db.prepare(`
+		INSERT INTO page_chunks (
+			page_id, path, title, heading, body, start_line, end_line,
+			sequence, page_priority, page_status, page_tags
+		)
+		VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+	`);
+    const insert_chunk_fts = db.prepare('INSERT INTO fts_page_chunks (chunk_id, path, title, heading, body) VALUES (?, ?, ?, ?, ?)');
     const set_meta = db.prepare(`
 		INSERT INTO wiki_meta (key, value, updated_at)
 		VALUES (?, ?, datetime('now'))
@@ -58,6 +71,8 @@ export function index_wiki(root = '.') {
     try {
         indexed_at = new Date().toISOString();
         clear_fts.run();
+        clear_chunks.run();
+        clear_chunk_fts.run();
         for (const page of pages) {
             const file_path = join(wiki_root, 'wiki', page.path);
             const modified_at = statSync(file_path).mtime.toISOString();
@@ -84,6 +99,13 @@ export function index_wiki(root = '.') {
                 link_count += 1;
             }
             insert_fts.run(page.path, page.title, page.content);
+            const page_priority = frontmatter_number(page.frontmatter.priority);
+            const page_status = frontmatter_string(page.frontmatter.status);
+            const page_tags = frontmatter_string_array(page.frontmatter.tags);
+            for (const chunk of chunk_page_body(page.body)) {
+                const chunk_result = insert_chunk.run(row.id, page.path, page.title, chunk.heading, chunk.body, chunk.start_line, chunk.end_line, chunk.sequence, page_priority, page_status, JSON.stringify(page_tags));
+                insert_chunk_fts.run(chunk_result.lastInsertRowid, page.path, page.title, chunk.heading, chunk.body);
+            }
             page_count += 1;
         }
         const placeholders = [...known_paths].map(() => '?').join(', ');
@@ -95,6 +117,7 @@ export function index_wiki(root = '.') {
         }
         set_meta.run('indexed_at', indexed_at);
         set_meta.run('schema_version', String(current_index_schema_version));
+        set_meta.run('package_version', current_index_package_version);
         db.exec('COMMIT');
     }
     catch (error) {
@@ -102,14 +125,85 @@ export function index_wiki(root = '.') {
         throw error;
     }
     db.close();
+    log_wiki_event({
+        root: wiki_root,
+        operation: 'index_wiki',
+        summary: `Indexed ${page_count} pages and ${link_count} links`,
+        target: wiki_root,
+        details: {
+            page_count,
+            link_count,
+            schema_version: current_index_schema_version,
+        },
+    });
     return {
         root: wiki_root,
-        dbPath: db_path,
-        pageCount: page_count,
-        linkCount: link_count,
-        indexedAt: indexed_at,
-        schemaVersion: current_index_schema_version,
+        db_path: db_path,
+        page_count: page_count,
+        link_count: link_count,
+        indexed_at: indexed_at,
+        schema_version: current_index_schema_version,
+        package_version: current_index_package_version,
+    };
+}
+function ensure_index_schema(db) {
+    const chunk_columns = new Set(db.prepare('PRAGMA table_info(page_chunks)').all().map((column) => column.name));
+    const migrations = {
+        page_priority: 'ALTER TABLE page_chunks ADD COLUMN page_priority INTEGER NOT NULL DEFAULT 0',
+        page_status: 'ALTER TABLE page_chunks ADD COLUMN page_status TEXT',
+        page_tags: 'ALTER TABLE page_chunks ADD COLUMN page_tags TEXT',
     };
+    for (const [column_name, sql] of Object.entries(migrations)) {
+        if (!chunk_columns.has(column_name))
+            db.exec(sql);
+    }
+}
+export function chunk_page_body(body) {
+    const lines = body.split(/\r?\n/u);
+    const heading_lines = lines
+        .map((line, index) => ({ line, index }))
+        .filter(({ line }) => /^#{1,6}\s+\S/u.test(line));
+    if (heading_lines.length === 0) {
+        return [
+            {
+                heading: null,
+                body: body.trim(),
+                start_line: 1,
+                end_line: Math.max(lines.length, 1),
+                sequence: 0,
+            },
+        ];
+    }
+    return heading_lines.map((heading, sequence) => {
+        const next_heading = heading_lines[sequence + 1];
+        const end_index = next_heading
+            ? next_heading.index - 1
+            : lines.length - 1;
+        return {
+            heading: heading.line.replace(/^#{1,6}\s+/u, '').trim(),
+            body: lines
+                .slice(heading.index, end_index + 1)
+                .join('\n')
+                .trim(),
+            start_line: heading.index + 1,
+            end_line: end_index + 1,
+            sequence,
+        };
+    });
+}
+function frontmatter_string(value) {
+    return typeof value === 'string' ? value : null;
+}
+function frontmatter_number(value) {
+    return typeof value === 'number' && Number.isFinite(value)
+        ? value
+        : 0;
+}
+function frontmatter_string_array(value) {
+    if (Array.isArray(value)) {
+        return value.filter((item) => typeof item === 'string');
+    }
+    return typeof value === 'string' ? [value] : [];
 }
 export function index_status(root = '.') {
     const wiki_root = resolve_wiki_root(root);
@@ -119,13 +213,15 @@ export function index_status(root = '.') {
     if (!existsSync(db_path)) {
         return {
             root: wiki_root,
-            dbPath: db_path,
+            db_path: db_path,
             exists: false,
-            indexedAt: null,
-            schemaVersion: null,
-            currentSchemaVersion: current_index_schema_version,
-            pageCount: page_paths.length,
-            indexedPageCount: 0,
+            indexed_at: null,
+            schema_version: null,
+            current_schema_version: current_index_schema_version,
+            package_version: null,
+            current_package_version: current_index_package_version,
+            page_count: page_paths.length,
+            indexed_page_count: 0,
             stale: true,
             reasons: ['missing-index'],
         };
@@ -137,9 +233,10 @@ export function index_status(root = '.') {
     const meta = new Map(meta_rows.map((row) => [row.key, row.value]));
     const indexed_at = meta.get('indexed_at') ?? null;
     const schema_version = Number(meta.get('schema_version') ?? NaN);
+    const package_version = meta.get('package_version') ?? null;
     const indexed_page_count = db.prepare('SELECT COUNT(*) AS count FROM pages').get().count;
     const indexed_pages = db
-        .prepare('SELECT path, content_hash AS contentHash FROM pages')
+        .prepare('SELECT path, content_hash AS content_hash FROM pages')
         .all();
     db.close();
     if (!indexed_at)
@@ -147,11 +244,14 @@ export function index_status(root = '.') {
     if (schema_version !== current_index_schema_version) {
         reasons.push('schema-version-mismatch');
     }
+    if (package_version !== current_index_package_version) {
+        reasons.push('package-version-mismatch');
+    }
     if (indexed_page_count !== page_paths.length) {
         reasons.push('page-count-changed');
     }
     const current_paths = new Set(page_paths);
-    const indexed_hashes = new Map(indexed_pages.map((page) => [page.path, page.contentHash]));
+    const indexed_hashes = new Map(indexed_pages.map((page) => [page.path, page.content_hash]));
     for (const page of indexed_pages) {
         if (!current_paths.has(page.path))
             reasons.push('deleted-pages');
@@ -169,17 +269,28 @@ export function index_status(root = '.') {
     }
     return {
         root: wiki_root,
-        dbPath: db_path,
+        db_path: db_path,
         exists: true,
-        indexedAt: indexed_at,
-        schemaVersion: Number.isNaN(schema_version)
+        indexed_at: indexed_at,
+        schema_version: Number.isNaN(schema_version)
             ? null
             : schema_version,
-        currentSchemaVersion: current_index_schema_version,
-        pageCount: page_paths.length,
-        indexedPageCount: indexed_page_count,
+        current_schema_version: current_index_schema_version,
+        package_version: package_version,
+        current_package_version: current_index_package_version,
+        page_count: page_paths.length,
+        indexed_page_count: indexed_page_count,
         stale: reasons.length > 0,
         reasons: [...new Set(reasons)],
     };
 }
+function read_package_version() {
+    try {
+        const package_json = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf-8'));
+        return package_json.version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
 //# sourceMappingURL=indexer.js.map