@wiki0/core 0.0.2 → 0.0.4

package/dist/search.js

@@ -1,5 +1,9 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
 import { open_wiki_database } from './database.js';
+import { index_status } from './indexer.js';
 import { resolve_page_path } from './pages.js';
+import { resolve_wiki_root } from './paths.js';
 export function search_wiki(query, root = '.', limit = 10) {
     const db = open_wiki_database(root);
     const statement = db.prepare(`SELECT path, title,
@@ -16,40 +20,233 @@ export function search_wiki(query, root = '.', limit = 10) {
     }
     try {
         const rows = statement.all(fts_query, limit);
-        db.close();
-        return rows;
+        if (rows.length > 0)
+            return rows;
+        const relaxed_query = relaxed_plain_text_fts_query(query);
+        if (!relaxed_query || relaxed_query === fts_query)
+            return rows;
+        return statement.all(relaxed_query, limit);
     }
     catch (error) {
-        db.close();
         throw new Error(`Invalid wiki search query: ${query}`, {
             cause: error,
         });
     }
+    finally {
+        db.close();
+    }
 }
+const stop_words = new Set([
+    'a',
+    'an',
+    'and',
+    'are',
+    'as',
+    'at',
+    'be',
+    'by',
+    'did',
+    'do',
+    'does',
+    'for',
+    'from',
+    'how',
+    'in',
+    'is',
+    'it',
+    'of',
+    'on',
+    'or',
+    'that',
+    'the',
+    'this',
+    'to',
+    'was',
+    'we',
+    'what',
+    'when',
+    'where',
+    'who',
+    'why',
+    'with',
+]);
 export function plain_text_fts_query(query) {
+    return plain_text_terms(query).map(quote_fts_term).join(' ');
+}
+export function relaxed_plain_text_fts_query(query) {
+    return plain_text_terms(query)
+        .filter((term) => !stop_words.has(term.toLowerCase()))
+        .map(quote_fts_term)
+        .join(' OR ');
+}
+function plain_text_terms(query) {
     return query
         .split(/\s+/u)
         .map((term) => term.replace(/^\W+|\W+$/gu, ''))
-        .filter((term) => term.length > 0)
-        .map((term) => `"${term.replace(/"/gu, '""')}"`)
-        .join(' ');
+        .filter((term) => term.length > 0);
+}
+function quote_fts_term(term) {
+    return `"${term.replace(/"/gu, '""')}"`;
+}
+export function search_wiki_chunks(query, root = '.', limit = 10) {
+    const db = open_wiki_database(root);
+    const statement = db.prepare(`SELECT fts_page_chunks.chunk_id AS chunk_id,
+			fts_page_chunks.path,
+			fts_page_chunks.title,
+			page_chunks.heading,
+			page_chunks.body,
+			page_chunks.start_line AS start_line,
+			page_chunks.end_line AS end_line,
+			page_chunks.page_priority,
+			page_chunks.page_status,
+			page_chunks.page_tags,
+			snippet(fts_page_chunks, 4, '[', ']', '…', 12) AS snippet,
+			bm25(fts_page_chunks) AS rank
+		FROM fts_page_chunks
+		JOIN page_chunks ON page_chunks.id = fts_page_chunks.chunk_id
+		WHERE fts_page_chunks MATCH ?
+		ORDER BY rank
+		LIMIT ?`);
+    const fts_query = plain_text_fts_query(query);
+    if (!fts_query) {
+        db.close();
+        return [];
+    }
+    try {
+        const rows = boosted_chunk_rows(statement.all(fts_query, limit * 5).map(chunk_row_from_sql), limit);
+        if (rows.length > 0)
+            return rows;
+        const relaxed_query = relaxed_plain_text_fts_query(query);
+        if (!relaxed_query || relaxed_query === fts_query)
+            return rows;
+        return boosted_chunk_rows(statement.all(relaxed_query, limit * 5).map(chunk_row_from_sql), limit);
+    }
+    catch (error) {
+        throw new Error(`Invalid wiki chunk search query: ${query}`, {
+            cause: error,
+        });
+    }
+    finally {
+        db.close();
+    }
+}
+function chunk_row_from_sql(row) {
+    return {
+        chunk_id: Number(row.chunk_id),
+        path: String(row.path),
+        title: String(row.title),
+        heading: row.heading === null ? null : String(row.heading),
+        body: String(row.body),
+        start_line: Number(row.start_line),
+        end_line: Number(row.end_line),
+        page_priority: Number(row.page_priority ?? 0),
+        page_status: row.page_status === null ? null : String(row.page_status),
+        page_tags: parse_page_tags(row.page_tags),
+        snippet: String(row.snippet),
+        rank: Number(row.rank),
+    };
+}
+function boosted_chunk_rows(rows, limit) {
+    return rows
+        .map(normalize_chunk_row)
+        .map((row) => ({ ...row, rank: boosted_rank(row) }))
+        .sort((left, right) => left.rank - right.rank)
+        .slice(0, limit);
+}
+function normalize_chunk_row(row) {
+    return {
+        ...row,
+        page_tags: parse_page_tags(row.page_tags),
+    };
+}
+function boosted_rank(row) {
+    const priority = row.page_priority ?? 0;
+    const status = (row.page_status ?? '').toLowerCase();
+    const tags = row.page_tags ?? [];
+    let rank = row.rank - priority * 0.1;
+    if (status === 'verified' || status === 'accepted')
+        rank -= 0.5;
+    if (status === 'draft' || status === 'review')
+        rank += 0.5;
+    if (status === 'stale' ||
+        status === 'superseded' ||
+        status === 'archived') {
+        rank += 2;
+    }
+    if (tags.includes('canonical') || tags.includes('source'))
+        rank -= 0.25;
+    if (tags.includes('archive') || tags.includes('superseded'))
+        rank += 2;
+    return rank;
+}
+function parse_page_tags(value) {
+    if (Array.isArray(value))
+        return value.filter((item) => typeof item === 'string');
+    if (typeof value !== 'string')
+        return [];
+    try {
+        const parsed = JSON.parse(value);
+        return Array.isArray(parsed)
+            ? parsed.filter((item) => typeof item === 'string')
+            : [];
+    }
+    catch {
+        return [];
+    }
+}
+export function show_wiki_chunk(target, root = '.') {
+    const { path, line } = parse_chunk_target(target, root);
+    const db = open_wiki_database(root);
+    const row = db
+        .prepare(`SELECT id AS chunk_id, path, title, heading, body,
+				start_line AS start_line, end_line AS end_line,
+				body AS snippet, 0 AS rank
+			FROM page_chunks
+			WHERE path = ? AND (? IS NULL OR (start_line <= ? AND end_line >= ?))
+			ORDER BY sequence
+			LIMIT 1`)
+        .get(path, line, line, line);
+    db.close();
+    return row ?? null;
+}
+function parse_chunk_target(target, root) {
+    const match = target.match(/^(.*?)(?::(\d+))?$/u);
+    const title = match?.[1]?.trim() ?? target;
+    const line = match?.[2] ? Number(match[2]) : null;
+    const wiki_root = resolve_wiki_root(root);
+    const direct_path = title.endsWith('.md') ? title : `${title}.md`;
+    if (existsSync(join(wiki_root, 'wiki', direct_path))) {
+        return { path: direct_path, line };
+    }
+    return { path: resolve_page_path(title, root), line };
 }
 export function get_wiki_context(query, root = '.', limit = 5) {
-    const results = search_wiki(query, root, limit);
+    const status = index_status(root);
+    const warnings = status.stale
+        ? [
+            `Index is stale (${status.reasons.join(', ')}); run index_wiki before relying on these results.`,
+        ]
+        : [];
+    const results = search_wiki_chunks(query, root, limit);
     return {
         query,
         results,
-        markdown: format_context_markdown(query, results),
+        warnings,
+        markdown: format_context_markdown(query, results, warnings),
     };
 }
-export function format_context_markdown(query, results) {
+export function format_context_markdown(query, results, warnings = []) {
     const lines = [`# wiki0 context: ${query}`, ''];
+    if (warnings.length > 0) {
+        lines.push('## Warnings', '', ...warnings.map((warning) => `- ${warning}`), '');
+    }
     if (results.length === 0) {
         lines.push('No indexed wiki context found.');
         return `${lines.join('\n')}\n`;
     }
     for (const [index, result] of results.entries()) {
-        lines.push(`## ${index + 1}. ${result.title}`, `Source: \`wiki/${result.path}\``, '', result.snippet.replace(/\s+/gu, ' ').trim(), '');
+        const line_range = `${result.start_line}-${result.end_line}`;
+        lines.push(`## ${index + 1}. ${result.title}`, `Source: \`wiki/${result.path}:${line_range}\``, result.heading ? `Heading: ${result.heading}` : '', '', result.body.trim(), '');
     }
     return `${lines.join('\n').trimEnd()}\n`;
 }
@@ -57,7 +254,7 @@ export function backlinks_for_page(title, root = '.') {
     const db = open_wiki_database(root);
     const page_path = resolve_page_path(title, root);
     const rows = db
-        .prepare(`SELECT pages.path, pages.title, page_links.raw_text AS rawText,
+        .prepare(`SELECT pages.path, pages.title, page_links.raw_text AS raw_text,
 				page_links.alias, page_links.embed
 			FROM page_links
 			JOIN pages ON pages.id = page_links.from_page_id
@@ -65,6 +262,15 @@ export function backlinks_for_page(title, root = '.') {
 			ORDER BY pages.path`)
         .all(page_path);
     db.close();
-    return rows.map((row) => ({ ...row, embed: Boolean(row.embed) }));
+    return rows.map(backlink_from_row);
+}
+function backlink_from_row(row) {
+    return {
+        path: String(row.path),
+        title: String(row.title),
+        raw_text: String(row.raw_text),
+        alias: row.alias === null ? null : String(row.alias),
+        embed: Boolean(row.embed),
+    };
 }
 //# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAS/C,MAAM,UAAU,WAAW,CAC1B,KAAa,EACb,IAAI,GAAG,GAAG,EACV,KAAK,GAAG,EAAE;IAEV,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAC3B;;;;;;UAMQ,CACR,CAAC;IACF,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACX,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAmB,CAAC;QAC/D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAEjC,MAAM,aAAa,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;QAC1D,IAAI,CAAC,aAAa,IAAI,aAAa,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAC/D,OAAO,SAAS,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,CAAmB,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,EAAE,EAAE;YACtD,KAAK,EAAE,KAAK;SACZ,CAAC,CAAC;IACJ,CAAC;YAAS,CAAC;QACV,EAAE,CAAC,KAAK,EAAE,CAAC;IACZ,CAAC;AACF,CAAC;AAED,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IAC1B,GAAG;IACH,IAAI;IACJ,KAAK;IACL,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,KAAK;IACL,MAAM;IACN,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;IACL,KAAK;IACL,MAAM;CACN,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IACjD,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAa;IACzD,OAAO,gBAAgB,CAAC,KAAK,CAAC;SAC5B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;SACrD,GAAG,CAAC,cAAc,CAAC;SACnB,IAAI,CAAC,MAAM,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACtC,OAAO,KAAK;SACV,KAAK,CAAC,MAAM,CAAC;SACb,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;SAC9C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IACnC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,kBAAkB,CACjC,KAAa,EACb,IAAI,GAAG,GAAG,EACV,KAAK,GAAG,EAAE;IAEV,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAC3B;;;;;;;;;;;;;;;;UAgBQ,CACR,CAAC;IACF,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACX,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,kBAAkB,CAE7B,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,GAAG,CAAC,CAIlC,CAAC,GAAG,CAAC,kBAAkB,CAAC,EACzB,KAAK,CACL,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAEjC,MAAM,aAAa,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;QAC1D,IAAI,CAAC,aAAa,IAAI,aAAa,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAC/D,OAAO,kBAAkB,CAEvB,SAAS,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,GAAG,CAAC,CAItC,CAAC,GAAG,CAAC,kBAAkB,CAAC,EACzB,KAAK,CACL,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,oCAAoC,KAAK,EAAE,EAAE;YAC5D,KAAK,EAAE,KAAK;SACZ,CAAC,CAAC;IACJ,CAAC;YAAS,CAAC;QACV,EAAE,CAAC,KAAK,EAAE,CAAC;IACZ,CAAC;AACF,CAAC;AAED,SAAS,kBAAkB,CAC1B,GAAmC;IAEnC,OAAO;QACN,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;QACxB,OAAO,EAAE,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QAC1D,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;QAClC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,CAAC;QAC7C,WAAW,EACV,GAAG,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;QAC1D,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC;QACzC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QAC5B,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;KACtB,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAC1B,IAAyB,EACzB,KAAa;IAEb,OAAO,IAAI;SACT,GAAG,CAAC,mBAAmB,CAAC;SACxB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;SACnD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;SAC7C,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAC3B,GAAsB;IAEtB,OAAO;QACN,GAAG,GAAG;QACN,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC;KACzC,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,GAAsB;IAC3C,MAAM,QAAQ,GAAG,GAAG,CAAC,aAAa,IAAI,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACrD,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;IACjC,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,QAAQ,GAAG,GAAG,CAAC;IACrC,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,UAAU;QAAE,IAAI,IAAI,GAAG,CAAC;IAChE,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,QAAQ;QAAE,IAAI,IAAI,GAAG,CAAC;IAC3D,IACC,MAAM,KAAK,OAAO;QAClB,MAAM,KAAK,YAAY;QACvB,MAAM,KAAK,UAAU,EACpB,CAAC;QACF,IAAI,IAAI,CAAC,CAAC;IACX,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACxD,IAAI,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC1D,IAAI,IAAI,CAAC,CAAC;IACX,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACtC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACvB,OAAO,KAAK,CAAC,MAAM,CAClB,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAClD,CAAC;IACH,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzC,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAY,CAAC;QAC5C,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAC3B,CAAC,CAAC,MAAM,CAAC,MAAM,CACb,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAClD;YACF,CAAC,CAAC,EAAE,CAAC;IACP,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC;AAED,MAAM,UAAU,eAAe,CAC9B,MAAc,EACd,IAAI,GAAG,GAAG;IAEV,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxD,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,EAAE;SACZ,OAAO,CACP;;;;;;WAMQ,CACR;SACA,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAgC,CAAC;IAC7D,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,GAAG,IAAI,IAAI,CAAC;AACpB,CAAC;AAED,SAAS,kBAAkB,CAC1B,MAAc,EACd,IAAY;IAEZ,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC;IAC3C,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClD,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC;IAClE,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;QACtD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC/B,KAAa,EACb,IAAI,GAAG,GAAG,EACV,KAAK,GAAG,CAAC;IAET,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK;QAC5B,CAAC,CAAC;YACA,mBAAmB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,oDAAoD;SAChG;QACF,CAAC,CAAC,EAAE,CAAC;IACN,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACvD,OAAO;QACN,KAAK;QACL,OAAO;QACP,QAAQ;QACR,QAAQ,EAAE,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC;KAC3D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACtC,KAAa,EACb,OAA4B,EAC5B,WAAqB,EAAE;IAEvB,MAAM,KAAK,GAAG,CAAC,oBAAoB,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAEhD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CACT,aAAa,EACb,EAAE,EACF,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,EAAE,CAAC,EAC5C,EAAE,CACF,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC7C,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAChC,CAAC;IAED,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC7D,KAAK,CAAC,IAAI,CACT,MAAM,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,EAClC,kBAAkB,MAAM,CAAC,IAAI,IAAI,UAAU,IAAI,EAC/C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAClD,EAAE,EACF,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAClB,EAAE,CACF,CAAC;IACH,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,kBAAkB,CACjC,KAAa,EACb,IAAI,GAAG,GAAG;IAEV,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,EAAE;SACb,OAAO,CACP;;;;;uBAKoB,CACpB;SACA,GAAG,CAAC,SAAS,CAAqC,CAAC;IACrD,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,iBAAiB,CACzB,GAAmC;IAEnC,OAAO;QACN,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;QACxB,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;KACzB,CAAC;AACH,CAAC"}

package/dist/topics.d.ts

@@ -0,0 +1,2 @@
+import type { TopicThreadResult } from './types.js';
+export declare function list_topic_threads(root?: string, limit?: number): TopicThreadResult[];

package/dist/topics.js

@@ -0,0 +1,55 @@
+import { open_wiki_database } from './database.js';
+export function list_topic_threads(root = '.', limit = 50) {
+    const db = open_wiki_database(root);
+    const rows = db
+        .prepare(`SELECT path, title, heading, page_tags FROM page_chunks
+			ORDER BY path, sequence`)
+        .all();
+    db.close();
+    const topics = new Map();
+    for (const row of rows) {
+        const path = String(row.path);
+        const heading = row.heading === null ? null : String(row.heading);
+        const tags = parse_tags(row.page_tags);
+        for (const topic of [...tags, ...(heading ? [heading] : [])]) {
+            const normalized_topic = topic.trim();
+            if (!normalized_topic)
+                continue;
+            const bucket = topics.get(normalized_topic) ?? {
+                paths: new Set(),
+                references: 0,
+                headings: new Set(),
+            };
+            bucket.paths.add(path);
+            bucket.references += 1;
+            if (heading)
+                bucket.headings.add(heading);
+            topics.set(normalized_topic, bucket);
+        }
+    }
+    return [...topics]
+        .map(([topic, bucket]) => ({
+        topic,
+        reference_count: bucket.references,
+        page_count: bucket.paths.size,
+        paths: [...bucket.paths].sort(),
+        summary: [...bucket.headings].slice(0, 5).join('; '),
+    }))
+        .sort((left, right) => right.reference_count - left.reference_count ||
+        left.topic.localeCompare(right.topic))
+        .slice(0, limit);
+}
+function parse_tags(value) {
+    if (value === null)
+        return [];
+    try {
+        const parsed = JSON.parse(String(value));
+        return Array.isArray(parsed)
+            ? parsed.filter((tag) => typeof tag === 'string')
+            : [];
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=topics.js.map

package/dist/topics.js.map

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

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 export type WikiConfig = {
     root: string;
-    wikiDir?: string;
-    dbPath?: string;
+    wiki_dir?: string;
+    db_path?: string;
 };
 export type WikiLink = {
     raw: string;
@@ -9,7 +9,9 @@ export type WikiLink = {
     alias?: string;
     embed: boolean;
 };
-export type FrontmatterValue = string | number | boolean | string[];
+export type FrontmatterValue = string | number | boolean | null | FrontmatterValue[] | {
+    [key: string]: FrontmatterValue;
+};
 export type WikiFrontmatter = Record<string, FrontmatterValue>;
 export type ParsedMarkdown = {
     frontmatter: WikiFrontmatter;
@@ -33,9 +35,26 @@ export type PageFrontmatterOptions = {
 };
 export type IndexResult = {
     root: string;
-    dbPath: string;
-    pageCount: number;
-    linkCount: number;
+    db_path: string;
+    page_count: number;
+    link_count: number;
+    indexed_at: string;
+    schema_version: number;
+    package_version: string;
+};
+export type IndexStatus = {
+    root: string;
+    db_path: string;
+    exists: boolean;
+    indexed_at: string | null;
+    schema_version: number | null;
+    current_schema_version: number;
+    package_version: string | null;
+    current_package_version: string;
+    page_count: number;
+    indexed_page_count: number;
+    stale: boolean;
+    reasons: string[];
 };
 export type SearchResult = {
     path: string;
@@ -43,15 +62,27 @@ export type SearchResult = {
     snippet: string;
     rank: number;
 };
+export type ChunkSearchResult = SearchResult & {
+    chunk_id: number;
+    heading: string | null;
+    body: string;
+    start_line: number;
+    end_line: number;
+    page_priority?: number;
+    page_status?: string | null;
+    page_tags?: string[];
+};
+export type ShowChunkResult = ChunkSearchResult;
 export type ContextResult = {
     query: string;
-    results: SearchResult[];
+    results: ChunkSearchResult[];
+    warnings: string[];
     markdown: string;
 };
 export type BacklinkResult = {
     path: string;
     title: string;
-    rawText: string;
+    raw_text: string;
     alias: string | null;
     embed: boolean;
 };
@@ -63,7 +94,7 @@ export type GraphEdge = {
     from: string;
     to: string;
     target: string;
-    rawText: string;
+    raw_text: string;
     alias: string | null;
     embed: boolean;
     status: 'resolved' | 'unresolved';
@@ -76,12 +107,17 @@ export type GraphResult = {
 export type FactConfidence = 'unknown' | 'low' | 'medium' | 'high' | 'verified';
 export type Fact = {
     id: number;
-    pagePath: string | null;
+    page_path: string | null;
     category: string;
     summary: string;
     body: string | null;
     confidence: FactConfidence;
-    createdAt: string;
+    source_path: string | null;
+    source_heading: string | null;
+    source_start_line: number | null;
+    source_end_line: number | null;
+    source_quote: string | null;
+    created_at: string;
 };
 export type FactWriteOptions = {
     root?: string;
@@ -90,6 +126,8 @@ export type FactWriteOptions = {
     summary: string;
     body?: string;
     confidence?: FactConfidence;
+    source?: string;
+    source_quote?: string;
 };
 export type ReviewResult = {
     path: string;
@@ -108,6 +146,58 @@ export type LintIssue = {
 export type LintResult = {
     root: string;
     ok: boolean;
-    issueCount: number;
+    issue_count: number;
     issues: LintIssue[];
 };
+export type WikiSourceType = 'general' | 'codebase' | 'docs' | 'research' | 'notes';
+export type WikiPlanOptions = {
+    source_type?: WikiSourceType;
+    scope?: string;
+    sources?: string[];
+};
+export type WikiBootstrapOptions = WikiPlanOptions & {
+    root?: string;
+    overwrite?: boolean;
+    ingest_sources?: boolean;
+};
+export type WikiPlanPage = {
+    title: string;
+    path: string;
+    purpose: string;
+    tags: string[];
+};
+export type WikiPlanResult = {
+    source_type: WikiSourceType;
+    scope: string;
+    workflow: string;
+    pages: WikiPlanPage[];
+    next_steps: string[];
+};
+export type WikiSourceIngestion = {
+    source: string;
+    page: string;
+    kind: 'file' | 'url' | 'missing';
+};
+export type WikiBootstrapResult = {
+    root: string;
+    plan: WikiPlanResult;
+    created: string[];
+    skipped: string[];
+    ingested_sources: WikiSourceIngestion[];
+    indexed: IndexResult;
+};
+export type WikiEvent = {
+    id: number;
+    operation: string;
+    summary: string;
+    target: string | null;
+    details: string | null;
+    created_at: string;
+};
+export type TopicThreadResult = {
+    topic: string;
+    reference_count: number;
+    page_count: number;
+    paths: string[];
+    summary: string;
+};

package/dist/workflow.d.ts

@@ -0,0 +1,4 @@
+import type { WikiBootstrapOptions, WikiBootstrapResult, WikiPlanOptions, WikiPlanResult } from './types.js';
+export declare const wiki_building_workflow_markdown = "# Wiki building workflow\n\nUse this workflow when a user asks to build, bootstrap, generate, or improve a wiki from source material. A codebase is one source type; the same workflow applies to docs, notes, research, transcripts, or any mixed knowledge corpus.\n\n## Steps\n\n1. Clarify the source scope only if it is ambiguous.\n2. Inspect source material before writing pages.\n3. Propose a small page plan with names, purposes, and review flags.\n4. Create an index page that explains the corpus and links to major sections.\n5. Create focused pages for concepts, workflows, decisions, sources, and open questions.\n6. Use [[WikiLinks]] to connect related pages instead of duplicating context.\n7. Use frontmatter for title, aliases, tags, status, and review markers.\n8. Add structured facts for durable claims, decisions, or constraints.\n9. Run index_wiki after page creation.\n10. Run lint_wiki and fix unresolved links or duplicate names.\n11. Run review_wiki and surface pages that still need human review.\n\n## Quality bar\n\n- Prefer many focused pages over one giant dump.\n- Mark uncertain pages with needs-review instead of inventing confidence.\n- Preserve citations or source paths when facts come from external material.\n- Make the wiki navigable for humans and retrievable for agents.\n";
+export declare function plan_wiki(options?: WikiPlanOptions): WikiPlanResult;
+export declare function bootstrap_wiki(options?: WikiBootstrapOptions): WikiBootstrapResult;