@wiki0/core 0.0.2 → 0.0.4

package/README.md

@@ -8,32 +8,56 @@ 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.
 
 ## Basic usage
 
 ```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: '.',
 });
 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.
+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/database.d.ts

@@ -1,3 +1,4 @@
-import Database from 'better-sqlite3';
+import { DatabaseSync } from 'node:sqlite';
+export type WikiDatabase = DatabaseSync;
 export declare function wiki_db_path(root?: string): string;
-export declare function open_wiki_database(root?: string): Database.Database;
+export declare function open_wiki_database(root?: string): WikiDatabase;

package/dist/database.js

@@ -1,6 +1,6 @@
-import Database from 'better-sqlite3';
 import { mkdirSync } from 'node:fs';
 import { dirname, join } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
 import { resolve_wiki_root } from './paths.js';
 import { schema_sql } from './schema.js';
 export function wiki_db_path(root = '.') {
@@ -10,7 +10,7 @@ export function open_wiki_database(root = '.') {
     const wiki_root = resolve_wiki_root(root);
     const db_path = wiki_db_path(wiki_root);
     mkdirSync(dirname(db_path), { recursive: true });
-    const db = new Database(db_path);
+    const db = new DatabaseSync(db_path);
     db.exec(schema_sql);
     return db;
 }

package/dist/database.js.map

@@ -1 +1 @@
-{"version":3,"file":"database.js","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,YAAY,CAAC,IAAI,GAAG,GAAG;IACtC,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAI,GAAG,GAAG;IAC5C,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IACxC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC;AACX,CAAC"}
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,MAAM,UAAU,YAAY,CAAC,IAAI,GAAG,GAAG;IACtC,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAI,GAAG,GAAG;IAC5C,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IACxC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;IACrC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC;AACX,CAAC"}

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,EAAiB,CAAC;IACvB,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,12 +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 { 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,12 +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 { 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,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,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"}
+{"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,2 +1,14 @@
-import type { IndexResult } from './types.js';
+import type { IndexResult, IndexStatus } from './types.js';
+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 {};