@wiki0/core 0.0.3 → 0.0.5

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: ".",
+	create_page,
+	index_status,
+	index_wiki,
+	search_wiki,
+	get_wiki_context,
+	sync_documents,
+	lint_wiki,
+	parse_document,
+	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(await parse_document('docs/guide.md'));
+console.log(
+	await sync_documents({
+		root: '.',
+		sources: ['docs'],
+	}),
+);
 ```
 
 ## 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/documents.d.ts

@@ -0,0 +1,12 @@
+export type ParsedDocumentKind = 'markdown' | 'text' | 'pdf' | 'docx' | 'unsupported';
+export type ParsedDocumentMetadata = Record<string, string | number | boolean | null>;
+export interface ParsedDocument {
+    source_path: string;
+    kind: ParsedDocumentKind;
+    title?: string;
+    text: string;
+    metadata: ParsedDocumentMetadata;
+    warnings: string[];
+}
+export declare function parse_document(source_path: string): Promise<ParsedDocument>;
+export declare function document_kind(source_path: string): ParsedDocumentKind;

package/dist/documents.js

@@ -0,0 +1,143 @@
+import mammoth from 'mammoth';
+import { readFile, stat } from 'node:fs/promises';
+import { basename, extname, resolve } from 'node:path';
+import { PDFParse } from 'pdf-parse';
+import { page_title_from_markdown, parse_markdown, } from './markdown.js';
+export async function parse_document(source_path) {
+    const resolved_path = resolve(source_path);
+    const kind = document_kind(source_path);
+    const base_result = {
+        source_path,
+        kind,
+        text: '',
+        metadata: {},
+        warnings: [],
+    };
+    try {
+        const stats = await stat(resolved_path);
+        if (!stats.isFile()) {
+            return {
+                ...base_result,
+                kind: 'unsupported',
+                warnings: ['Source is not a file.'],
+            };
+        }
+    }
+    catch (error) {
+        return {
+            ...base_result,
+            kind: 'unsupported',
+            warnings: [`Source could not be read: ${error_message(error)}`],
+        };
+    }
+    if (kind === 'markdown')
+        return parse_markdown_document(source_path);
+    if (kind === 'text')
+        return parse_text_document(source_path);
+    if (kind === 'pdf')
+        return parse_pdf_document(source_path);
+    if (kind === 'docx')
+        return parse_docx_document(source_path);
+    return {
+        ...base_result,
+        warnings: [`Unsupported document type: ${extname(source_path)}`],
+    };
+}
+export function document_kind(source_path) {
+    const extension = extname(source_path).toLowerCase();
+    if (extension === '.md' || extension === '.markdown')
+        return 'markdown';
+    if (extension === '.txt')
+        return 'text';
+    if (extension === '.pdf')
+        return 'pdf';
+    if (extension === '.docx')
+        return 'docx';
+    return 'unsupported';
+}
+async function parse_markdown_document(source_path) {
+    const text = await readFile(source_path, 'utf-8');
+    const parsed = parse_markdown(text);
+    return {
+        source_path,
+        kind: 'markdown',
+        title: page_title_from_markdown(text, basename(source_path)),
+        text: normalize_text(parsed.content),
+        metadata: {
+            bytes: Buffer.byteLength(text),
+            ...flatten_frontmatter_metadata(parsed.frontmatter),
+        },
+        warnings: [],
+    };
+}
+async function parse_text_document(source_path) {
+    const text = await readFile(source_path, 'utf-8');
+    return {
+        source_path,
+        kind: 'text',
+        title: basename(source_path),
+        text: normalize_text(text),
+        metadata: { bytes: Buffer.byteLength(text) },
+        warnings: [],
+    };
+}
+async function parse_pdf_document(source_path) {
+    const parser = new PDFParse({ data: await readFile(source_path) });
+    try {
+        const [text_result, info_result] = await Promise.all([
+            parser.getText(),
+            parser.getInfo().catch(() => null),
+        ]);
+        const info = info_result?.info;
+        return {
+            source_path,
+            kind: 'pdf',
+            title: string_metadata(info?.Title) ?? basename(source_path),
+            text: normalize_text(text_result.text),
+            metadata: compact_metadata({
+                pages: text_result.total,
+                title: string_metadata(info?.Title),
+                author: string_metadata(info?.Author),
+                subject: string_metadata(info?.Subject),
+                creator: string_metadata(info?.Creator),
+                producer: string_metadata(info?.Producer),
+            }),
+            warnings: [],
+        };
+    }
+    finally {
+        await parser.destroy();
+    }
+}
+async function parse_docx_document(source_path) {
+    const result = await mammoth.extractRawText({ path: source_path });
+    return {
+        source_path,
+        kind: 'docx',
+        title: basename(source_path),
+        text: normalize_text(result.value),
+        metadata: {},
+        warnings: result.messages.map((message) => message.message),
+    };
+}
+function normalize_text(text) {
+    return text.replace(/\r\n?/gu, '\n').trim();
+}
+function flatten_frontmatter_metadata(frontmatter) {
+    return Object.fromEntries(Object.entries(frontmatter)
+        .filter((entry) => entry[1] === null ||
+        ['string', 'number', 'boolean'].includes(typeof entry[1]))
+        .map(([key, value]) => [`frontmatter_${key}`, value]));
+}
+function compact_metadata(metadata) {
+    return Object.fromEntries(Object.entries(metadata).filter((entry) => entry[1] !== undefined));
+}
+function string_metadata(value) {
+    return typeof value === 'string' && value.trim().length > 0
+        ? value.trim()
+        : undefined;
+}
+function error_message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=documents.js.map

package/dist/documents.js.map

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

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.d.ts

@@ -1,3 +1,7 @@
 import type { Fact, FactWriteOptions } from './types.js';
+export type DerivedFactCandidate = Omit<FactWriteOptions, 'root' | 'page' | 'source'> & {
+    line: number;
+};
 export declare function add_fact(fact: FactWriteOptions): Fact;
 export declare function list_facts(root?: string, category?: string): Fact[];
+export declare function derive_facts_from_markdown(markdown: string): DerivedFactCandidate[];

package/dist/facts.js

@@ -1,43 +1,135 @@
 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);
+}
+export function derive_facts_from_markdown(markdown) {
+    return markdown
+        .split(/\n/u)
+        .map((line, index) => ({
+        line: line.trim(),
+        line_number: index + 1,
+    }))
+        .filter(({ line }) => /\b(should|must|required|requirement|decision|constraint|risk|assumption|fact)\b/iu.test(line))
+        .slice(0, 20)
+        .map(({ line, line_number }) => ({
+        category: fact_category(line),
+        summary: line.replace(/^[-*]\s*/u, '').slice(0, 240),
+        body: `Derived from extracted source text line ${line_number}.`,
+        confidence: 'low',
+        source_quote: line,
+        line: line_number,
+    }));
+}
+function fact_category(line) {
+    if (/\b(decision)\b/iu.test(line))
+        return 'decision';
+    if (/\b(risk)\b/iu.test(line))
+        return 'risk';
+    if (/\b(assumption)\b/iu.test(line))
+        return 'assumption';
+    if (/\b(constraint|must|required|requirement|should)\b/iu.test(line)) {
+        return 'constraint';
+    }
+    return 'note';
+}
+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,17 @@
 export { open_wiki_database, wiki_db_path } from './database.js';
-export { add_fact, list_facts } from './facts.js';
+export { document_kind, parse_document, type ParsedDocument, type ParsedDocumentKind, type ParsedDocumentMetadata, } from './documents.js';
+export { list_wiki_events, log_wiki_event } from './events.js';
+export { add_fact, derive_facts_from_markdown, list_facts, type DerivedFactCandidate, } 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 { sync_documents } from './sync.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';
+export { plan_wiki, wiki_building_workflow_markdown, } from './workflow.js';

package/dist/index.js

@@ -1,13 +1,17 @@
 export { open_wiki_database, wiki_db_path } from './database.js';
-export { add_fact, list_facts } from './facts.js';
+export { document_kind, parse_document, } from './documents.js';
+export { list_wiki_events, log_wiki_event } from './events.js';
+export { add_fact, derive_facts_from_markdown, 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 { bootstrap_wiki, plan_wiki, wiki_building_workflow_markdown, } from './workflow.js';
+export { backlinks_for_page, format_context_markdown, get_wiki_context, search_wiki, search_wiki_chunks, show_wiki_chunk, } from './search.js';
+export { sync_documents } from './sync.js';
+export { list_topic_threads } from './topics.js';
+export { 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,EACN,aAAa,EACb,cAAc,GAId,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EACN,QAAQ,EACR,0BAA0B,EAC1B,UAAU,GAEV,MAAM,YAAY,CAAC;AACpB,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,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EACN,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 {};