@wiki0/core 0.0.1

package/dist/database.d.ts

@@ -0,0 +1,3 @@
+import Database from 'better-sqlite3';
+export declare function wiki_db_path(root?: string): string;
+export declare function open_wiki_database(root?: string): Database.Database;

package/dist/database.js

@@ -0,0 +1,17 @@
+import Database from 'better-sqlite3';
+import { mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { resolve_wiki_root } from './paths.js';
+import { schema_sql } from './schema.js';
+export function wiki_db_path(root = '.') {
+    return join(resolve_wiki_root(root), '.wiki0', 'wiki0.sqlite');
+}
+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);
+    db.exec(schema_sql);
+    return db;
+}
+//# sourceMappingURL=database.js.map

package/dist/database.js.map

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { open_wiki_database, wiki_db_path } from './database.js';
+export { index_wiki } from './indexer.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, 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 type * from './types.js';

package/dist/index.js

@@ -0,0 +1,9 @@
+export { open_wiki_database, wiki_db_path } from './database.js';
+export { index_wiki } from './indexer.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, 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';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,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,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"}

package/dist/indexer.d.ts

@@ -0,0 +1,2 @@
+import type { IndexResult } from './types.js';
+export declare function index_wiki(root?: string): IndexResult;

package/dist/indexer.js

@@ -0,0 +1,77 @@
+import { createHash } from 'node:crypto';
+import { statSync } from 'node:fs';
+import { join } from 'node:path';
+import { open_wiki_database, wiki_db_path } from './database.js';
+import { list_markdown_page_paths, read_page_by_path, } from './pages.js';
+import { resolve_wiki_root, wikilink_target_path } from './paths.js';
+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);
+    let page_count = 0;
+    let link_count = 0;
+    const upsert_page = db.prepare(`
+		INSERT INTO pages (path, title, body, content_hash, modified_at)
+		VALUES (@path, @title, @body, @content_hash, @modified_at)
+		ON CONFLICT(path) DO UPDATE SET
+			title = excluded.title,
+			body = excluded.body,
+			content_hash = excluded.content_hash,
+			modified_at = excluded.modified_at,
+			updated_at = datetime('now')
+	`);
+    const page_id_query = db.prepare('SELECT id FROM pages WHERE path = ?');
+    const delete_links = db.prepare('DELETE FROM page_links WHERE from_page_id = ?');
+    const insert_link = db.prepare(`
+		INSERT INTO page_links (from_page_id, to_path, raw_text, target, alias, embed, status)
+		VALUES (?, ?, ?, ?, ?, ?, ?)
+	`);
+    const clear_fts = db.prepare('DELETE FROM fts_pages');
+    const insert_fts = db.prepare('INSERT INTO fts_pages (path, title, body) VALUES (?, ?, ?)');
+    const page_paths = list_markdown_page_paths(wiki_root);
+    const known_paths = new Set(page_paths);
+    const transaction = db.transaction(() => {
+        clear_fts.run();
+        for (const page_path of page_paths) {
+            const file_path = join(wiki_root, 'wiki', page_path);
+            const page = read_page_by_path(page_path, wiki_root);
+            const modified_at = statSync(file_path).mtime.toISOString();
+            const content_hash = createHash('sha256')
+                .update(page.body)
+                .digest('hex');
+            upsert_page.run({
+                path: page.path,
+                title: page.title,
+                body: page.body,
+                content_hash,
+                modified_at,
+            });
+            const row = page_id_query.get(page.path);
+            delete_links.run(row.id);
+            for (const link of page.links) {
+                const to_path = wikilink_target_path(link.target);
+                const is_resolved = known_paths.has(to_path);
+                insert_link.run(row.id, is_resolved ? to_path : null, link.raw, link.target, link.alias ?? null, link.embed ? 1 : 0, is_resolved ? 'resolved' : 'unresolved');
+                link_count += 1;
+            }
+            insert_fts.run(page.path, page.title, page.content);
+            page_count += 1;
+        }
+        const placeholders = [...known_paths].map(() => '?').join(', ');
+        if (known_paths.size > 0) {
+            db.prepare(`DELETE FROM pages WHERE path NOT IN (${placeholders})`).run(...known_paths);
+        }
+        else {
+            db.prepare('DELETE FROM pages').run();
+        }
+    });
+    transaction();
+    db.close();
+    return {
+        root: wiki_root,
+        dbPath: db_path,
+        pageCount: page_count,
+        linkCount: link_count,
+    };
+}
+//# sourceMappingURL=indexer.js.map

package/dist/indexer.js.map

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

package/dist/markdown.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedMarkdown, WikiFrontmatter, WikiLink } from './types.js';
+export declare function parse_wikilinks(markdown: string): WikiLink[];
+export declare function strip_fenced_code_blocks(markdown: string): string;
+export declare function strip_inline_code(markdown: string): string;
+export declare function parse_markdown(markdown: string): ParsedMarkdown;
+export declare function parse_frontmatter(source: string): WikiFrontmatter;
+export declare function serialize_frontmatter(frontmatter: WikiFrontmatter): string;
+export declare function page_title_from_markdown(markdown: string, fallback: string): string;

package/dist/markdown.js

@@ -0,0 +1,108 @@
+export function parse_wikilinks(markdown) {
+    const links = [];
+    const pattern = /(!?)\[\[([^\]|]+)(?:\|([^\]]+))?\]\]/gu;
+    const searchable_markdown = strip_inline_code(strip_fenced_code_blocks(parse_markdown(markdown).content));
+    for (const match of searchable_markdown.matchAll(pattern)) {
+        const [, embed_marker, target, alias] = match;
+        links.push({
+            raw: match[0],
+            target: target.trim(),
+            alias: alias?.trim(),
+            embed: embed_marker === '!',
+        });
+    }
+    return links;
+}
+export function strip_fenced_code_blocks(markdown) {
+    return markdown.replace(/^(```|~~~)[^\n]*\n[\s\S]*?^\1\s*$/gmu, '');
+}
+export function strip_inline_code(markdown) {
+    return markdown.replace(/`[^`\n]*`/gu, '');
+}
+export function parse_markdown(markdown) {
+    if (!markdown.startsWith('---\n') &&
+        !markdown.startsWith('---\r\n')) {
+        return { frontmatter: {}, content: markdown };
+    }
+    const match = markdown.match(/^---\r?\n([\s\S]*?)\r?\n---\s*\r?\n?/u);
+    if (!match)
+        return { frontmatter: {}, content: markdown };
+    return {
+        frontmatter: parse_frontmatter(match[1] ?? ''),
+        content: markdown.slice(match[0].length),
+    };
+}
+export function parse_frontmatter(source) {
+    const frontmatter = {};
+    let current_key;
+    for (const raw_line of source.split(/\r?\n/u)) {
+        const line = raw_line.trimEnd();
+        if (line.trim().length === 0)
+            continue;
+        const list_match = line.match(/^\s*-\s+(.+)$/u);
+        if (list_match && current_key) {
+            const value = frontmatter[current_key];
+            const values = Array.isArray(value)
+                ? value
+                : value === undefined
+                    ? []
+                    : [String(value)];
+            values.push(String(parse_frontmatter_scalar(list_match[1] ?? '')));
+            frontmatter[current_key] = values;
+            continue;
+        }
+        const pair_match = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/u);
+        if (!pair_match)
+            continue;
+        const [, key, value] = pair_match;
+        current_key = key;
+        frontmatter[key] =
+            value.length > 0 ? parse_frontmatter_scalar(value) : [];
+    }
+    return frontmatter;
+}
+export function serialize_frontmatter(frontmatter) {
+    const lines = ['---'];
+    for (const [key, value] of Object.entries(frontmatter)) {
+        if (Array.isArray(value)) {
+            lines.push(`${key}:`);
+            for (const item of value)
+                lines.push(`  - ${item}`);
+            continue;
+        }
+        lines.push(`${key}: ${String(value)}`);
+    }
+    lines.push('---', '');
+    return `${lines.join('\n')}\n`;
+}
+function parse_frontmatter_scalar(value) {
+    const trimmed_value = value.trim();
+    const unquoted_value = trimmed_value.replace(/^["']|["']$/gu, '');
+    if (trimmed_value === 'true')
+        return true;
+    if (trimmed_value === 'false')
+        return false;
+    if (/^-?\d+(?:\.\d+)?$/u.test(trimmed_value))
+        return Number(trimmed_value);
+    if (trimmed_value.startsWith('[') && trimmed_value.endsWith(']')) {
+        return trimmed_value
+            .slice(1, -1)
+            .split(',')
+            .map((item) => item.trim().replace(/^["']|["']$/gu, ''))
+            .filter((item) => item.length > 0);
+    }
+    return unquoted_value;
+}
+export function page_title_from_markdown(markdown, fallback) {
+    const parsed_markdown = parse_markdown(markdown);
+    const frontmatter_title = parsed_markdown.frontmatter.title;
+    if (typeof frontmatter_title === 'string' &&
+        frontmatter_title.length > 0) {
+        return frontmatter_title;
+    }
+    const heading = parsed_markdown.content
+        .match(/^#\s+(.+)$/mu)?.[1]
+        ?.trim();
+    return heading && heading.length > 0 ? heading : fallback;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

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

package/dist/pages.d.ts

@@ -0,0 +1,8 @@
+import { serialize_frontmatter } from './markdown.js';
+import type { PageFrontmatterOptions, PageWriteOptions, WikiPage } from './types.js';
+export declare function create_page(title: string, body: string, options?: PageWriteOptions): WikiPage;
+export declare function read_page(title: string, root?: string): WikiPage;
+export declare function set_page_frontmatter(title: string, frontmatter: Parameters<typeof serialize_frontmatter>[0], options?: PageFrontmatterOptions): WikiPage;
+export declare function append_page(title: string, body: string, root?: string): WikiPage;
+export declare function list_markdown_page_paths(root?: string): string[];
+export declare function read_page_by_path(page_path: string, root?: string): WikiPage;

package/dist/pages.js

@@ -0,0 +1,86 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, } from 'node:fs';
+import { dirname, join, relative } from 'node:path';
+import { page_title_from_markdown, parse_markdown, parse_wikilinks, serialize_frontmatter, } from './markdown.js';
+import { display_page_title, page_file_path, page_relative_path, resolve_wiki_root, } from './paths.js';
+export function create_page(title, body, options = {}) {
+    const file_path = page_file_path(title, options.root);
+    const page_body = body.match(/^#\s+/mu)
+        ? body
+        : `# ${display_page_title(title)}\n\n${body}`;
+    mkdirSync(dirname(file_path), { recursive: true });
+    writeFileSync(file_path, page_body.endsWith('\n') ? page_body : `${page_body}\n`, {
+        flag: options.overwrite ? 'w' : 'wx',
+    });
+    return read_page(title, options.root);
+}
+export function read_page(title, root = '.') {
+    const file_path = page_file_path(title, root);
+    const body = readFileSync(file_path, 'utf-8');
+    const parsed_markdown = parse_markdown(body);
+    return {
+        path: page_relative_path(title),
+        title: page_title_from_markdown(body, display_page_title(title)),
+        body,
+        content: parsed_markdown.content,
+        frontmatter: parsed_markdown.frontmatter,
+        links: parse_wikilinks(body),
+    };
+}
+export function set_page_frontmatter(title, frontmatter, options = {}) {
+    const file_path = page_file_path(title, options.root);
+    const body = readFileSync(file_path, 'utf-8');
+    const parsed_markdown = parse_markdown(body);
+    const next_frontmatter = options.merge
+        ? { ...parsed_markdown.frontmatter, ...frontmatter }
+        : frontmatter;
+    const next_body = `${serialize_frontmatter(next_frontmatter)}${parsed_markdown.content}`;
+    writeFileSync(file_path, next_body.endsWith('\n') ? next_body : `${next_body}\n`);
+    return read_page(title, options.root);
+}
+export function append_page(title, body, root = '.') {
+    const file_path = page_file_path(title, root);
+    const append_body = body.startsWith('\n') ? body : `\n${body}`;
+    writeFileSync(file_path, append_body.endsWith('\n') ? append_body : `${append_body}\n`, {
+        flag: 'a',
+    });
+    return read_page(title, root);
+}
+export function list_markdown_page_paths(root = '.') {
+    const wiki_root = resolve_wiki_root(root);
+    const wiki_dir = join(wiki_root, 'wiki');
+    if (!existsSync(wiki_dir))
+        return [];
+    const page_paths = [];
+    const visit_dir = (dir_path) => {
+        for (const entry of readdirSync(dir_path, {
+            withFileTypes: true,
+        })) {
+            const entry_path = join(dir_path, entry.name);
+            if (entry.isDirectory()) {
+                visit_dir(entry_path);
+                continue;
+            }
+            if (!entry.isFile() || !entry.name.endsWith('.md'))
+                continue;
+            page_paths.push(relative(wiki_dir, entry_path));
+        }
+    };
+    visit_dir(wiki_dir);
+    return page_paths.sort();
+}
+export function read_page_by_path(page_path, root = '.') {
+    const wiki_root = resolve_wiki_root(root);
+    const file_path = join(wiki_root, 'wiki', page_path);
+    const body = readFileSync(file_path, 'utf-8');
+    const title_fallback = display_page_title(page_path.replace(/\.md$/u, ''));
+    const parsed_markdown = parse_markdown(body);
+    return {
+        path: page_path,
+        title: page_title_from_markdown(body, title_fallback),
+        body,
+        content: parsed_markdown.content,
+        frontmatter: parsed_markdown.frontmatter,
+        links: parse_wikilinks(body),
+    };
+}
+//# sourceMappingURL=pages.js.map

package/dist/pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.js","sourceRoot":"","sources":["../src/pages.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,UAAU,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,aAAa,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EACN,wBAAwB,EACxB,cAAc,EACd,eAAe,EACf,qBAAqB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,YAAY,CAAC;AAOpB,MAAM,UAAU,WAAW,CAC1B,KAAa,EACb,IAAY,EACZ,UAA4B,EAAE;IAE9B,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;QACtC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,KAAK,kBAAkB,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;IAE/C,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,aAAa,CACZ,SAAS,EACT,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,EACvD;QACC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;KACpC,CACD,CAAC;IAEF,OAAO,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,IAAI,GAAG,GAAG;IAClD,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,eAAe,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAE7C,OAAO;QACN,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC;QAC/B,KAAK,EAAE,wBAAwB,CAAC,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAChE,IAAI;QACJ,OAAO,EAAE,eAAe,CAAC,OAAO;QAChC,WAAW,EAAE,eAAe,CAAC,WAAW;QACxC,KAAK,EAAE,eAAe,CAAC,IAAI,CAAC;KAC5B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CACnC,KAAa,EACb,WAAwD,EACxD,UAAkC,EAAE;IAEpC,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,eAAe,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK;QACrC,CAAC,CAAC,EAAE,GAAG,eAAe,CAAC,WAAW,EAAE,GAAG,WAAW,EAAE;QACpD,CAAC,CAAC,WAAW,CAAC;IACf,MAAM,SAAS,GAAG,GAAG,qBAAqB,CAAC,gBAAgB,CAAC,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC;IACzF,aAAa,CACZ,SAAS,EACT,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,CACvD,CAAC;IACF,OAAO,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,WAAW,CAC1B,KAAa,EACb,IAAY,EACZ,IAAI,GAAG,GAAG;IAEV,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/D,aAAa,CACZ,SAAS,EACT,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,EAC7D;QACC,IAAI,EAAE,GAAG;KACT,CACD,CAAC;IACF,OAAO,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAI,GAAG,GAAG;IAClD,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAE,EAAE;QACtC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,QAAQ,EAAE;YACzC,aAAa,EAAE,IAAI;SACnB,CAAC,EAAE,CAAC;YACJ,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACzB,SAAS,CAAC,UAAU,CAAC,CAAC;gBACtB,SAAS;YACV,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,SAAS;YAC7D,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;QACjD,CAAC;IACF,CAAC,CAAC;IAEF,SAAS,CAAC,QAAQ,CAAC,CAAC;IACpB,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAChC,SAAiB,EACjB,IAAI,GAAG,GAAG;IAEV,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAG,kBAAkB,CACxC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAC/B,CAAC;IACF,MAAM,eAAe,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAE7C,OAAO;QACN,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,wBAAwB,CAAC,IAAI,EAAE,cAAc,CAAC;QACrD,IAAI;QACJ,OAAO,EAAE,eAAe,CAAC,OAAO;QAChC,WAAW,EAAE,eAAe,CAAC,WAAW;QACxC,KAAK,EAAE,eAAe,CAAC,IAAI,CAAC;KAC5B,CAAC;AACH,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,6 @@
+export declare function slugify_title(title: string): string;
+export declare function resolve_wiki_root(start_path?: string): string;
+export declare function page_relative_path(title: string): string;
+export declare function page_file_path(title: string, root?: string): string;
+export declare function wikilink_target_path(target: string): string;
+export declare function display_page_title(title: string): string;

package/dist/paths.js

@@ -0,0 +1,46 @@
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+export function slugify_title(title) {
+    return title
+        .trim()
+        .toLowerCase()
+        .normalize('NFKD')
+        .replace(/[\u0300-\u036f]/gu, '')
+        .replace(/[^a-z0-9]+/gu, '-')
+        .replace(/^-+|-+$/gu, '');
+}
+export function resolve_wiki_root(start_path = '.') {
+    let current_path = resolve(start_path);
+    while (true) {
+        if (existsSync(join(current_path, '.wiki0')) ||
+            existsSync(join(current_path, 'wiki'))) {
+            return current_path;
+        }
+        const parent_path = dirname(current_path);
+        if (parent_path === current_path) {
+            return resolve(start_path);
+        }
+        current_path = parent_path;
+    }
+}
+export function page_relative_path(title) {
+    const path_parts = title
+        .split('/')
+        .map((part) => slugify_title(part))
+        .filter((part) => part.length > 0);
+    if (path_parts.length === 0) {
+        throw new Error('Page title must include at least one slug character');
+    }
+    return `${path_parts.join('/')}.md`;
+}
+export function page_file_path(title, root = '.') {
+    return join(resolve_wiki_root(root), 'wiki', page_relative_path(title));
+}
+export function wikilink_target_path(target) {
+    const clean_target = target.split('#')[0]?.trim() ?? '';
+    return page_relative_path(clean_target);
+}
+export function display_page_title(title) {
+    return title.split('/').filter(Boolean).at(-1)?.trim() ?? title;
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,UAAU,aAAa,CAAC,KAAa;IAC1C,OAAO,KAAK;SACV,IAAI,EAAE;SACN,WAAW,EAAE;SACb,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;SAChC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAU,GAAG,GAAG;IACjD,IAAI,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvC,OAAO,IAAI,EAAE,CAAC;QACb,IACC,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;YACxC,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,EACrC,CAAC;YACF,OAAO,YAAY,CAAC;QACrB,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,WAAW,KAAK,YAAY,EAAE,CAAC;YAClC,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC;QACD,YAAY,GAAG,WAAW,CAAC;IAC5B,CAAC;AACF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC/C,MAAM,UAAU,GAAG,KAAK;SACtB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;SAClC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEpC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACd,qDAAqD,CACrD,CAAC;IACH,CAAC;IAED,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,IAAI,GAAG,GAAG;IACvD,OAAO,IAAI,CACV,iBAAiB,CAAC,IAAI,CAAC,EACvB,MAAM,EACN,kBAAkB,CAAC,KAAK,CAAC,CACzB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc;IAClD,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxD,OAAO,kBAAkB,CAAC,YAAY,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC/C,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,KAAK,CAAC;AACjE,CAAC"}

package/dist/review.d.ts

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

package/dist/review.js

@@ -0,0 +1,46 @@
+import { list_markdown_page_paths, read_page_by_path, } from './pages.js';
+export function review_wiki(root = '.') {
+    const review_statuses = new Set([
+        'draft',
+        'proposed',
+        'review',
+        'stale',
+        'unverified',
+    ]);
+    const review_tags = new Set([
+        'review',
+        'needs-review',
+        'unverified',
+        'stale',
+    ]);
+    const results = [];
+    for (const page_path of list_markdown_page_paths(root)) {
+        const page = read_page_by_path(page_path, root);
+        const status = page.frontmatter.status;
+        const tags = page.frontmatter.tags;
+        const status_text = typeof status === 'string' ? status : null;
+        const tag_list = Array.isArray(tags) ? tags : [];
+        const matching_tag = tag_list.find((tag) => review_tags.has(tag));
+        if (status_text && review_statuses.has(status_text)) {
+            results.push({
+                path: page.path,
+                title: page.title,
+                status: status_text,
+                tags: tag_list,
+                reason: `status:${status_text}`,
+            });
+            continue;
+        }
+        if (matching_tag) {
+            results.push({
+                path: page.path,
+                title: page.title,
+                status: status_text,
+                tags: tag_list,
+                reason: `tag:${matching_tag}`,
+            });
+        }
+    }
+    return results.sort((left, right) => left.path.localeCompare(right.path));
+}
+//# sourceMappingURL=review.js.map

package/dist/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../src/review.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,wBAAwB,EACxB,iBAAiB,GACjB,MAAM,YAAY,CAAC;AAGpB,MAAM,UAAU,WAAW,CAAC,IAAI,GAAG,GAAG;IACrC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;QAC/B,OAAO;QACP,UAAU;QACV,QAAQ;QACR,OAAO;QACP,YAAY;KACZ,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;QAC3B,QAAQ;QACR,cAAc;QACd,YAAY;QACZ,OAAO;KACP,CAAC,CAAC;IACH,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,KAAK,MAAM,SAAS,IAAI,wBAAwB,CAAC,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,iBAAiB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QACnC,MAAM,WAAW,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/D,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAElE,IAAI,WAAW,IAAI,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACrD,OAAO,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,WAAW;gBACnB,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,UAAU,WAAW,EAAE;aAC/B,CAAC,CAAC;YACH,SAAS;QACV,CAAC;QAED,IAAI,YAAY,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,WAAW;gBACnB,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,OAAO,YAAY,EAAE;aAC7B,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACnC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CACnC,CAAC;AACH,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1 @@
+export declare const schema_sql: string;

package/dist/schema.js

@@ -0,0 +1,3 @@
+import { readFileSync } from 'node:fs';
+export const schema_sql = readFileSync(new URL('./schema.sql', import.meta.url), 'utf-8');
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CACrC,IAAI,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EACxC,OAAO,CACP,CAAC"}

package/dist/schema.sql

@@ -0,0 +1,37 @@
+PRAGMA journal_mode = WAL;
+PRAGMA foreign_keys = ON;
+
+CREATE TABLE IF NOT EXISTS pages (
+	id INTEGER PRIMARY KEY AUTOINCREMENT,
+	path TEXT NOT NULL UNIQUE,
+	title TEXT NOT NULL,
+	body TEXT NOT NULL,
+	content_hash TEXT NOT NULL,
+	modified_at TEXT NOT NULL,
+	created_at TEXT DEFAULT (datetime('now')),
+	updated_at TEXT DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS page_links (
+	id INTEGER PRIMARY KEY AUTOINCREMENT,
+	from_page_id INTEGER NOT NULL REFERENCES pages(id) ON DELETE CASCADE,
+	to_path TEXT,
+	raw_text TEXT NOT NULL,
+	target TEXT NOT NULL,
+	alias TEXT,
+	embed INTEGER NOT NULL DEFAULT 0,
+	status TEXT NOT NULL DEFAULT 'unresolved',
+	created_at TEXT DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS facts (
+	id INTEGER PRIMARY KEY AUTOINCREMENT,
+	page_id INTEGER REFERENCES pages(id) ON DELETE SET NULL,
+	category TEXT NOT NULL,
+	summary TEXT NOT NULL,
+	body TEXT,
+	confidence TEXT NOT NULL DEFAULT 'unknown',
+	created_at TEXT DEFAULT (datetime('now'))
+);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS fts_pages USING fts5(path, title, body);

package/dist/search.d.ts

@@ -0,0 +1,5 @@
+import type { BacklinkResult, ContextResult, SearchResult } from './types.js';
+export declare function search_wiki(query: string, root?: string, limit?: number): SearchResult[];
+export declare function get_wiki_context(query: string, root?: string, limit?: number): ContextResult;
+export declare function format_context_markdown(query: string, results: SearchResult[]): string;
+export declare function backlinks_for_page(title: string, root?: string): BacklinkResult[];

package/dist/search.js

@@ -0,0 +1,50 @@
+import { open_wiki_database } from './database.js';
+import { wikilink_target_path } from './paths.js';
+export function search_wiki(query, root = '.', limit = 10) {
+    const db = open_wiki_database(root);
+    const rows = db
+        .prepare(`SELECT path, title,
+				snippet(fts_pages, 2, '[', ']', '…', 12) AS snippet,
+				bm25(fts_pages) AS rank
+			FROM fts_pages
+			WHERE fts_pages MATCH ?
+			ORDER BY rank
+			LIMIT ?`)
+        .all(query, limit);
+    db.close();
+    return rows;
+}
+export function get_wiki_context(query, root = '.', limit = 5) {
+    const results = search_wiki(query, root, limit);
+    return {
+        query,
+        results,
+        markdown: format_context_markdown(query, results),
+    };
+}
+export function format_context_markdown(query, results) {
+    const lines = [`# wiki0 context: ${query}`, ''];
+    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(), '');
+    }
+    return `${lines.join('\n').trimEnd()}\n`;
+}
+export function backlinks_for_page(title, root = '.') {
+    const db = open_wiki_database(root);
+    const page_path = wikilink_target_path(title);
+    const rows = db
+        .prepare(`SELECT pages.path, pages.title, page_links.raw_text AS rawText,
+				page_links.alias, page_links.embed
+			FROM page_links
+			JOIN pages ON pages.id = page_links.from_page_id
+			WHERE page_links.to_path = ?
+			ORDER BY pages.path`)
+        .all(page_path);
+    db.close();
+    return rows.map((row) => ({ ...row, embed: Boolean(row.embed) }));
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAOlD,MAAM,UAAU,WAAW,CAC1B,KAAa,EACb,IAAI,GAAG,GAAG,EACV,KAAK,GAAG,EAAE;IAEV,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,EAAE;SACb,OAAO,CACP;;;;;;WAMQ,CACR;SACA,GAAG,CAAC,KAAK,EAAE,KAAK,CAAmB,CAAC;IACtC,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC/B,KAAa,EACb,IAAI,GAAG,GAAG,EACV,KAAK,GAAG,CAAC;IAET,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAChD,OAAO;QACN,KAAK;QACL,OAAO;QACP,QAAQ,EAAE,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC;KACjD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACtC,KAAa,EACb,OAAuB;IAEvB,MAAM,KAAK,GAAG,CAAC,oBAAoB,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAEhD,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,KAAK,CAAC,IAAI,CACT,MAAM,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,EAClC,kBAAkB,MAAM,CAAC,IAAI,IAAI,EACjC,EAAE,EACF,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAC3C,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,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,EAAE;SACb,OAAO,CACP;;;;;uBAKoB,CACpB;SACA,GAAG,CAAC,SAAS,CAAqB,CAAC;IACrC,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/dist/test-utils.d.ts

@@ -0,0 +1 @@
+export declare function make_wiki_root(): string;

package/dist/test-utils.js

@@ -0,0 +1,18 @@
+import { mkdirSync, mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach } from 'vitest';
+const temp_roots = [];
+export function make_wiki_root() {
+    const root = mkdtempSync(join(tmpdir(), 'wiki0-core-'));
+    mkdirSync(join(root, 'wiki'), { recursive: true });
+    mkdirSync(join(root, '.wiki0'), { recursive: true });
+    temp_roots.push(root);
+    return root;
+}
+afterEach(() => {
+    for (const root of temp_roots.splice(0)) {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+//# sourceMappingURL=test-utils.js.map

package/dist/test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.js","sourceRoot":"","sources":["../src/test-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEnC,MAAM,UAAU,GAAa,EAAE,CAAC;AAEhC,MAAM,UAAU,cAAc;IAC7B,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IACxD,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,IAAI,CAAC;AACb,CAAC;AAED,SAAS,CAAC,GAAG,EAAE;IACd,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;AACF,CAAC,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,64 @@
+export type WikiConfig = {
+    root: string;
+    wikiDir?: string;
+    dbPath?: string;
+};
+export type WikiLink = {
+    raw: string;
+    target: string;
+    alias?: string;
+    embed: boolean;
+};
+export type FrontmatterValue = string | number | boolean | string[];
+export type WikiFrontmatter = Record<string, FrontmatterValue>;
+export type ParsedMarkdown = {
+    frontmatter: WikiFrontmatter;
+    content: string;
+};
+export type WikiPage = {
+    path: string;
+    title: string;
+    body: string;
+    content: string;
+    frontmatter: WikiFrontmatter;
+    links: WikiLink[];
+};
+export type PageWriteOptions = {
+    root?: string;
+    overwrite?: boolean;
+};
+export type PageFrontmatterOptions = {
+    root?: string;
+    merge?: boolean;
+};
+export type IndexResult = {
+    root: string;
+    dbPath: string;
+    pageCount: number;
+    linkCount: number;
+};
+export type SearchResult = {
+    path: string;
+    title: string;
+    snippet: string;
+    rank: number;
+};
+export type ContextResult = {
+    query: string;
+    results: SearchResult[];
+    markdown: string;
+};
+export type BacklinkResult = {
+    path: string;
+    title: string;
+    rawText: string;
+    alias: string | null;
+    embed: boolean;
+};
+export type ReviewResult = {
+    path: string;
+    title: string;
+    status: string | null;
+    tags: string[];
+    reason: string;
+};

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@wiki0/core",
+  "version": "0.0.1",
+  "description": "Core wiki0 Markdown wiki indexing and retrieval primitives",
+  "homepage": "https://github.com/spences10/wiki0/tree/main/packages/core#readme",
+  "license": "MIT",
+  "author": "Scott Spence <me@scottspence.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/spences10/wiki0.git",
+    "directory": "packages/core"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.5.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^25.8.0",
+    "typescript": "^6.0.3",
+    "vite-plus": "^0.1.22",
+    "vitest": "4.1.7"
+  },
+  "engines": {
+    "node": ">=24.15.0"
+  },
+  "scripts": {
+    "build:self": "vp exec tsc -p tsconfig.build.json && cp src/schema.sql dist/schema.sql",
+    "check:self": "vp exec tsc --noEmit -p tsconfig.json",
+    "test:self": "vitest run"
+  }
+}