@wiki0/cli 0.0.5 → 0.1.0

package/README.md

@@ -1,6 +1,7 @@
 # @wiki0/cli
 
-Command line interface for wiki0 local-first Markdown wiki memory.
+Command line interface for wiki0: search a project's docs and get the
+right section with a `path:start-end` citation.
 
 ## Install
 
@@ -8,32 +9,34 @@ Command line interface for wiki0 local-first Markdown wiki memory.
 pnpm add -g @wiki0/cli
 ```
 
-The package exposes the `wiki0` binary.
-
 ## Commands
 
 ```sh
-wiki0 init ./my-wiki
-wiki0 page create "projects/wiki0" --body "Local-first [[topics/memory]]." --root ./my-wiki
-wiki0 plan --source_type codebase --scope "current repository" --sources README.md,package.json
-wiki0 extract docs/guide.md --root ./my-wiki
-wiki0 sync docs --root ./my-wiki
-wiki0 index --root ./my-wiki
-wiki0 status --root ./my-wiki
-wiki0 search "memory" --root ./my-wiki
-wiki0 context "what is wiki0?" --root ./my-wiki
-wiki0 show topics/memory.md:12 --root ./my-wiki
-wiki0 lint --root ./my-wiki
-wiki0 graph --root ./my-wiki
-wiki0 facts add "Markdown is source of truth" --category decision --confidence high --source decisions/storage.md:12 --root ./my-wiki
-wiki0 facts list --root ./my-wiki
-wiki0 topics --root ./my-wiki
-wiki0 events --root ./my-wiki
-wiki0 review --root ./my-wiki
+wiki0 index                      # index the project docs
+wiki0 status                     # index path and staleness
+wiki0 search "query" [--limit 5] # one cited section per document
+wiki0 show <target> [--tokens 2000] [--neighbours 1]
+wiki0 context "query"            # top sections as cited Markdown
+wiki0 lint                       # broken links and anchors
+wiki0 graph                      # documents and links
+wiki0 documents                  # outline and link counts per document
+wiki0 backlinks <path-or-title>
+wiki0 ui [--no-open] [--stop]    # browse the docs in a local web app
 ```
 
+`show` targets: `path:12`, `path:12-40`, `path#heading`, `path` or a
+document title. When the text is longer than the token budget, the
+output ends with the range to read next.
+
+To show a user this project's docs, an agent runs `npx @wiki0/cli ui`:
+it prints the URL and returns, and a second run reuses the open
+server. Flags: [`@wiki0/ui`](../ui/README.md).
+
+Every command takes `--root`; by default the project root is the
+nearest folder with `.git` or `wiki0.toml`. `lint` exits with code 1
+when it finds errors.
+
 ## Output
 
-Most commands return JSON so agents and shell scripts can consume the
-results. `wiki0 context` returns Markdown by default and supports
-`--json` for structured output.
+`show` and `context` print Markdown (`--json` for structured output).
+`ui` prints the URL. The other commands print JSON.

package/dist/actions.d.ts

@@ -1,8 +1 @@
-import { type WikiFrontmatter } from '@wiki0/core';
-export declare function init_workspace(root: string): string;
-export declare function read_markdown_input(options: {
-    file?: string;
-    body?: string;
-}): string;
-export declare function parse_frontmatter_json(data: string): WikiFrontmatter;
 export declare function print_json(value: unknown): void;

package/dist/actions.js

@@ -1,29 +1,3 @@
-import { schema_sql } from '@wiki0/core';
-import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-export function init_workspace(root) {
-    for (const dir of [
-        'wiki/inbox',
-        'wiki/decisions',
-        'wiki/people',
-        'wiki/projects',
-        'wiki/topics',
-        '.wiki0',
-    ]) {
-        mkdirSync(join(root, dir), { recursive: true });
-    }
-    writeFileSync(join(root, 'wiki/index.md'), '# Wiki0\n\nStart here. Link pages with `[[topics/example]]`.\n', { flag: 'wx' });
-    writeFileSync(join(root, '.wiki0/schema.sql'), schema_sql);
-    return `Created wiki0 workspace at ${root}`;
-}
-export function read_markdown_input(options) {
-    return options.file
-        ? readFileSync(options.file, 'utf-8')
-        : (options.body ?? '');
-}
-export function parse_frontmatter_json(data) {
-    return JSON.parse(data);
-}
 export function print_json(value) {
     console.log(JSON.stringify(value, null, 2));
 }

package/dist/actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAwB,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,cAAc,CAAC,IAAY;IAC1C,KAAK,MAAM,GAAG,IAAI;QACjB,YAAY;QACZ,gBAAgB;QAChB,aAAa;QACb,eAAe;QACf,aAAa;QACb,QAAQ;KACR,EAAE,CAAC;QACH,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,aAAa,CACZ,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EAC3B,gEAAgE,EAChE,EAAE,IAAI,EAAE,IAAI,EAAE,CACd,CAAC;IACF,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,EAAE,UAAU,CAAC,CAAC;IAC3D,OAAO,8BAA8B,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAGnC;IACA,OAAO,OAAO,CAAC,IAAI;QAClB,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;QACrC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACrC,IAAY;IAEZ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACxC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,KAAc;IACxC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/commands.js

@@ -1,544 +1,215 @@
-import { add_fact, append_page, backlinks_for_page, create_page, get_wiki_context, graph_wiki, index_status, index_wiki, lint_wiki, list_facts, list_topic_threads, list_wiki_events, parse_document, plan_wiki, read_page, review_wiki, search_wiki, set_page_frontmatter, show_wiki_chunk, sync_documents, } from '@wiki0/core';
+import { backlinks_for_page, get_wiki_context, graph_wiki, index_status, index_wiki, lint_wiki, list_documents, search, show, } from '@wiki0/core';
 import { defineCommand } from 'citty';
-import { isAbsolute, resolve } from 'node:path';
-import { init_workspace, parse_frontmatter_json, print_json, read_markdown_input, } from './actions.js';
-function parse_wiki_source_type(value) {
-    const source_type = typeof value === 'string' ? value : 'general';
-    if (source_type === 'general' ||
-        source_type === 'codebase' ||
-        source_type === 'docs' ||
-        source_type === 'research' ||
-        source_type === 'notes') {
-        return source_type;
-    }
-    throw new Error(`Invalid wiki source type: ${source_type}`);
-}
-function parse_sources(value) {
-    if (typeof value !== 'string' || value.trim().length === 0) {
-        return undefined;
-    }
-    return value
-        .split(',')
-        .map((source) => source.trim())
-        .filter(Boolean);
-}
-function parse_optional_sources(value) {
-    return parse_sources(value);
-}
-function resolve_cli_source(root, source) {
-    return isAbsolute(source) ? source : resolve(root, source);
-}
-function parse_fact_confidence(value) {
-    const confidence = typeof value === 'string' ? value : 'unknown';
-    if (confidence === 'unknown' ||
-        confidence === 'low' ||
-        confidence === 'medium' ||
-        confidence === 'high' ||
-        confidence === 'verified') {
-        return confidence;
-    }
-    throw new Error(`Invalid fact confidence: ${confidence}`);
-}
+import { print_json } from './actions.js';
+import { run_ui } from './ui.js';
+const root_arg = {
+    root: {
+        type: 'string',
+        description: 'Project root (default: nearest folder with .git)',
+        default: '.',
+    },
+};
+const json_arg = {
+    json: {
+        type: 'boolean',
+        description: 'Output JSON instead of Markdown',
+    },
+};
 export const main = defineCommand({
     meta: {
         name: 'wiki0',
-        description: 'Local-first Markdown wiki memory for humans and agents',
+        description: 'Search a project’s docs and get the right section with a path:line citation',
     },
     subCommands: {
-        init: defineCommand({
-            meta: { description: 'Create a wiki0 folder structure' },
-            args: {
-                path: {
-                    type: 'positional',
-                    description: 'Wiki root path',
-                    default: '.',
-                },
-            },
-            run({ args }) {
-                console.log(init_workspace(String(args.path ?? '.')));
-            },
-        }),
-        page: defineCommand({
-            meta: {
-                description: 'Create, read, append, and tag wiki pages',
-            },
-            subCommands: {
-                create: defineCommand({
-                    meta: { description: 'Create a wiki page' },
-                    args: {
-                        title: {
-                            type: 'positional',
-                            required: true,
-                            description: 'Page title or path',
-                        },
-                        body: { type: 'string', description: 'Markdown body' },
-                        file: {
-                            type: 'string',
-                            description: 'Read Markdown body from a file',
-                        },
-                        root: {
-                            type: 'string',
-                            description: 'Wiki root path',
-                            default: '.',
-                        },
-                        overwrite: {
-                            type: 'boolean',
-                            description: 'Overwrite an existing page',
-                        },
-                    },
-                    run({ args }) {
-                        const page = create_page(String(args.title), read_markdown_input(args), {
-                            root: String(args.root ?? '.'),
-                            overwrite: Boolean(args.overwrite),
-                        });
-                        print_json(page);
-                    },
-                }),
-                read: defineCommand({
-                    meta: { description: 'Read a wiki page' },
-                    args: {
-                        title: {
-                            type: 'positional',
-                            required: true,
-                            description: 'Page title or path',
-                        },
-                        root: {
-                            type: 'string',
-                            description: 'Wiki root path',
-                            default: '.',
-                        },
-                    },
-                    run({ args }) {
-                        print_json(read_page(String(args.title), String(args.root ?? '.')));
-                    },
-                }),
-                frontmatter: defineCommand({
-                    meta: {
-                        description: 'Set YAML frontmatter on a wiki page',
-                    },
-                    args: {
-                        title: {
-                            type: 'positional',
-                            required: true,
-                            description: 'Page title or path',
-                        },
-                        data: {
-                            type: 'string',
-                            required: true,
-                            description: 'Frontmatter as a JSON object',
-                        },
-                        root: {
-                            type: 'string',
-                            description: 'Wiki root path',
-                            default: '.',
-                        },
-                        merge: {
-                            type: 'boolean',
-                            description: 'Merge with existing frontmatter',
-                        },
-                    },
-                    run({ args }) {
-                        const page = set_page_frontmatter(String(args.title), parse_frontmatter_json(args.data), {
-                            root: String(args.root ?? '.'),
-                            merge: Boolean(args.merge),
-                        });
-                        print_json(page);
-                    },
-                }),
-                append: defineCommand({
-                    meta: { description: 'Append Markdown to a wiki page' },
-                    args: {
-                        title: {
-                            type: 'positional',
-                            required: true,
-                            description: 'Page title or path',
-                        },
-                        body: {
-                            type: 'string',
-                            description: 'Markdown body to append',
-                        },
-                        file: {
-                            type: 'string',
-                            description: 'Read Markdown body from a file',
-                        },
-                        root: {
-                            type: 'string',
-                            description: 'Wiki root path',
-                            default: '.',
-                        },
-                    },
-                    run({ args }) {
-                        const page = append_page(String(args.title), read_markdown_input(args), String(args.root ?? '.'));
-                        print_json(page);
-                    },
-                }),
-            },
-        }),
-        extract: defineCommand({
-            meta: {
-                description: 'Extract normalized text and metadata from a source document',
-            },
-            args: {
-                source: {
-                    type: 'positional',
-                    required: true,
-                    description: 'Source document path',
-                },
-                root: {
-                    type: 'string',
-                    description: 'Wiki root path for relative sources',
-                    default: '.',
-                },
-            },
+        index: defineCommand({
+            meta: { description: 'Index the project docs' },
+            args: { ...root_arg },
             async run({ args }) {
-                print_json(await parse_document(resolve_cli_source(String(args.root ?? '.'), String(args.source))));
+                print_json(await index_wiki(String(args.root)));
             },
         }),
-        sync: defineCommand({
+        status: defineCommand({
             meta: {
-                description: 'Sync source documents into wiki source pages, then index the wiki',
+                description: 'Show where the index is and whether it is stale',
             },
-            args: {
-                sources: {
-                    type: 'positional',
-                    required: true,
-                    description: 'Comma-separated source paths or directories',
-                },
-                root: {
-                    type: 'string',
-                    description: 'Wiki root path',
-                    default: '.',
-                },
-                overwrite: {
-                    type: 'boolean',
-                    description: 'Overwrite existing synced source pages',
-                },
-                include: {
-                    type: 'string',
-                    description: 'Comma-separated glob patterns to include during recursive sync',
-                },
-                ignore: {
-                    type: 'string',
-                    description: 'Comma-separated glob patterns to ignore during recursive sync',
-                },
-                noFacts: {
-                    type: 'boolean',
-                    description: 'Skip deriving SQLite facts from source text',
-                },
-                proposePages: {
-                    type: 'boolean',
-                    description: 'Generate proposed concept/workflow pages from source text',
-                },
-                noIndex: {
-                    type: 'boolean',
-                    description: 'Skip rebuilding the SQLite index after sync',
-                },
-            },
-            async run({ args }) {
-                print_json(await sync_documents({
-                    root: String(args.root ?? '.'),
-                    sources: parse_sources(args.sources) ?? [],
-                    overwrite: Boolean(args.overwrite),
-                    index: !args.noIndex,
-                    include: parse_optional_sources(args.include),
-                    ignore: parse_optional_sources(args.ignore),
-                    derive_facts: !args.noFacts,
-                    propose_pages: Boolean(args.proposePages),
-                }));
+            args: { ...root_arg },
+            run({ args }) {
+                print_json(index_status(String(args.root)));
             },
         }),
-        plan: defineCommand({
+        search: defineCommand({
             meta: {
-                description: 'Print a deterministic workflow and starter page plan for building a wiki',
+                description: 'Search the docs; one cited section per document, most authoritative first',
             },
             args: {
-                source_type: {
-                    type: 'string',
-                    description: 'general, codebase, docs, research, or notes',
-                    default: 'general',
-                },
-                scope: {
+                query: { type: 'positional', required: true },
+                ...root_arg,
+                limit: {
                     type: 'string',
-                    description: 'Source scope description',
+                    description: 'Maximum number of documents',
+                    default: '5',
                 },
-                sources: {
-                    type: 'string',
-                    description: 'Comma-separated source paths or URLs',
+                includeSuperseded: {
+                    type: 'boolean',
+                    description: 'Keep superseded documents in results',
+                    default: true,
                 },
             },
             run({ args }) {
-                print_json(plan_wiki({
-                    source_type: parse_wiki_source_type(args.source_type),
-                    scope: args.scope ? String(args.scope) : undefined,
-                    sources: parse_sources(args.sources),
+                print_json(search(String(args.query), String(args.root), {
+                    limit: Number(args.limit),
+                    include_superseded: args.includeSuperseded !== false,
                 }));
             },
         }),
-        facts: defineCommand({
-            meta: { description: 'Add and list structured wiki facts' },
-            subCommands: {
-                add: defineCommand({
-                    meta: { description: 'Add a structured wiki fact' },
-                    args: {
-                        summary: { type: 'positional', required: true },
-                        category: {
-                            type: 'string',
-                            description: 'Fact category',
-                            default: 'note',
-                        },
-                        body: { type: 'string', description: 'Fact details' },
-                        confidence: {
-                            type: 'string',
-                            description: 'unknown, low, medium, high, or verified',
-                            default: 'unknown',
-                        },
-                        page: {
-                            type: 'string',
-                            description: 'Related page title or path',
-                        },
-                        source: {
-                            type: 'string',
-                            description: 'Source page or page:line target for provenance',
-                        },
-                        sourceQuote: {
-                            type: 'string',
-                            description: 'Exact source quote for provenance',
-                        },
-                        root: {
-                            type: 'string',
-                            description: 'Wiki root path',
-                            default: '.',
-                        },
-                    },
-                    run({ args }) {
-                        print_json(add_fact({
-                            root: String(args.root ?? '.'),
-                            page: args.page ? String(args.page) : undefined,
-                            category: String(args.category ?? 'note'),
-                            summary: String(args.summary),
-                            body: args.body ? String(args.body) : undefined,
-                            confidence: parse_fact_confidence(args.confidence),
-                            source: args.source ? String(args.source) : undefined,
-                            source_quote: args.sourceQuote
-                                ? String(args.sourceQuote)
-                                : undefined,
-                        }));
-                    },
-                }),
-                list: defineCommand({
-                    meta: { description: 'List structured wiki facts' },
-                    args: {
-                        category: {
-                            type: 'string',
-                            description: 'Filter by category',
-                        },
-                        root: {
-                            type: 'string',
-                            description: 'Wiki root path',
-                            default: '.',
-                        },
-                    },
-                    run({ args }) {
-                        print_json(list_facts(String(args.root ?? '.'), args.category ? String(args.category) : undefined));
-                    },
-                }),
+        show: defineCommand({
+            meta: {
+                description: 'Show a cited section: path:line, path:start-end, path#heading, path or title',
             },
-        }),
-        events: defineCommand({
-            meta: { description: 'List recent wiki operation log events' },
             args: {
-                root: {
+                target: { type: 'positional', required: true },
+                ...root_arg,
+                tokens: {
                     type: 'string',
-                    description: 'Wiki root path',
-                    default: '.',
+                    description: 'Token budget for the returned text',
+                    default: '2000',
                 },
-                limit: {
+                neighbours: {
                     type: 'string',
-                    description: 'Maximum number of events',
-                    default: '50',
+                    description: 'Also include this many sections either side',
+                    default: '0',
                 },
+                ...json_arg,
             },
             run({ args }) {
-                print_json(list_wiki_events(String(args.root ?? '.'), Number(args.limit ?? 50)));
+                const result = show(String(args.target), String(args.root), {
+                    token_budget: Number(args.tokens),
+                    neighbours: Number(args.neighbours),
+                });
+                if (args.json) {
+                    print_json(result);
+                    return;
+                }
+                if (!result) {
+                    console.log('No indexed section found.');
+                    process.exitCode = 1;
+                    return;
+                }
+                console.log(`Source: ${result.citation}`);
+                for (const warning of result.warnings) {
+                    console.log(`Warning: ${warning}`);
+                }
+                if (result.superseded_by) {
+                    console.log(`Superseded by: ${result.superseded_by}`);
+                }
+                console.log('');
+                console.log(result.markdown);
+                if (result.next) {
+                    console.log(`\nMore: wiki0 show ${result.next}`);
+                }
             },
         }),
-        topics: defineCommand({
+        context: defineCommand({
             meta: {
-                description: 'List lightweight topic threads from indexed chunks',
+                description: 'Search and return the top sections as cited Markdown',
             },
             args: {
-                root: {
-                    type: 'string',
-                    description: 'Wiki root path',
-                    default: '.',
-                },
+                query: { type: 'positional', required: true },
+                ...root_arg,
                 limit: {
                     type: 'string',
-                    description: 'Maximum number of topics',
-                    default: '50',
+                    description: 'Maximum number of sections',
+                    default: '3',
                 },
+                ...json_arg,
             },
             run({ args }) {
-                print_json(list_topic_threads(String(args.root ?? '.'), Number(args.limit ?? 50)));
+                const result = get_wiki_context(String(args.query), String(args.root), Number(args.limit));
+                console.log(args.json
+                    ? JSON.stringify(result, null, 2)
+                    : result.markdown);
             },
         }),
-        index: defineCommand({
-            meta: { description: 'Index Markdown pages into SQLite' },
-            args: {
-                root: {
-                    type: 'string',
-                    description: 'Wiki root path',
-                    default: '.',
-                },
+        lint: defineCommand({
+            meta: {
+                description: 'Report broken links, missing headings and other link problems',
             },
+            args: { ...root_arg },
             run({ args }) {
-                print_json(index_wiki(String(args.root ?? '.')));
+                const result = lint_wiki(String(args.root));
+                print_json(result);
+                if (!result.ok)
+                    process.exitCode = 1;
             },
         }),
-        status: defineCommand({
-            meta: { description: 'Show index freshness and schema status' },
-            args: {
-                root: {
-                    type: 'string',
-                    description: 'Wiki root path',
-                    default: '.',
-                },
-            },
+        graph: defineCommand({
+            meta: { description: 'Output the document link graph' },
+            args: { ...root_arg },
             run({ args }) {
-                print_json(index_status(String(args.root ?? '.')));
+                print_json(graph_wiki(String(args.root)));
             },
         }),
-        search: defineCommand({
-            meta: { description: 'Search indexed wiki pages' },
-            args: {
-                query: { type: 'positional', required: true },
-                root: {
-                    type: 'string',
-                    description: 'Wiki root path',
-                    default: '.',
-                },
-                limit: {
-                    type: 'string',
-                    description: 'Maximum number of results',
-                    default: '10',
-                },
+        documents: defineCommand({
+            meta: {
+                description: 'List indexed documents with outlines and link counts',
             },
+            args: { ...root_arg },
             run({ args }) {
-                print_json(search_wiki(String(args.query), String(args.root ?? '.'), Number(args.limit ?? 10)));
+                print_json(list_documents(String(args.root)));
             },
         }),
-        show: defineCommand({
-            meta: {
-                description: 'Show the indexed wiki chunk for a page or page:line target',
-            },
+        backlinks: defineCommand({
+            meta: { description: 'List documents that link to a document' },
             args: {
-                target: {
-                    type: 'positional',
-                    required: true,
-                    description: 'Page path/title, optionally with :line',
-                },
-                root: {
-                    type: 'string',
-                    description: 'Wiki root path',
-                    default: '.',
-                },
-                json: {
-                    type: 'boolean',
-                    description: 'Output structured JSON instead of Markdown',
-                },
+                target: { type: 'positional', required: true },
+                ...root_arg,
             },
             run({ args }) {
-                const result = show_wiki_chunk(String(args.target), String(args.root ?? '.'));
-                if (args.json)
-                    print_json(result);
-                else
-                    console.log(result?.body ?? 'No indexed chunk found.');
+                print_json(backlinks_for_page(String(args.target), String(args.root)));
             },
         }),
-        context: defineCommand({
+        ui: defineCommand({
             meta: {
-                description: 'Retrieve indexed context with citations',
+                description: 'Open the project docs in the browser; prints the URL and reuses a running server',
             },
             args: {
-                query: { type: 'positional', required: true },
-                root: {
+                ...root_arg,
+                host: {
                     type: 'string',
-                    description: 'Wiki root path',
-                    default: '.',
+                    description: 'Host to bind (default: 127.0.0.1)',
                 },
-                limit: {
+                port: {
                     type: 'string',
-                    description: 'Maximum number of context results',
-                    default: '5',
+                    description: 'Port (default: 4100 or WIKI0_UI_PORT; a busy port falls back)',
                 },
-                json: {
+                open: {
                     type: 'boolean',
-                    description: 'Output structured JSON instead of Markdown',
-                },
-            },
-            run({ args }) {
-                const result = get_wiki_context(String(args.query), String(args.root ?? '.'), Number(args.limit ?? 5));
-                console.log(args.json
-                    ? JSON.stringify(result, null, 2)
-                    : result.markdown);
-            },
-        }),
-        graph: defineCommand({
-            meta: { description: 'Output indexed wiki graph data' },
-            args: {
-                root: {
-                    type: 'string',
-                    description: 'Wiki root path',
-                    default: '.',
+                    description: 'Open a browser (--no-open to only print the URL)',
+                    default: true,
                 },
-            },
-            run({ args }) {
-                print_json(graph_wiki(String(args.root ?? '.')));
-            },
-        }),
-        lint: defineCommand({
-            meta: { description: 'Lint wiki links and duplicate names' },
-            args: {
-                root: {
-                    type: 'string',
-                    description: 'Wiki root path',
-                    default: '.',
+                detach: {
+                    type: 'boolean',
+                    description: 'Run in the background and return (default when not in a terminal)',
                 },
-            },
-            run({ args }) {
-                const result = lint_wiki(String(args.root ?? '.'));
-                print_json(result);
-                if (!result.ok)
-                    process.exitCode = 1;
-            },
-        }),
-        backlinks: defineCommand({
-            meta: { description: 'List resolved backlinks for a page' },
-            args: {
-                title: { type: 'positional', required: true },
-                root: {
-                    type: 'string',
-                    description: 'Wiki root path',
-                    default: '.',
+                foreground: {
+                    type: 'boolean',
+                    description: 'Stay in the foreground until Ctrl-C',
                 },
-            },
-            run({ args }) {
-                print_json(backlinks_for_page(String(args.title), String(args.root ?? '.')));
-            },
-        }),
-        review: defineCommand({
-            meta: {
-                description: 'List pages marked for review',
-            },
-            args: {
-                root: {
-                    type: 'string',
-                    description: 'Wiki root path',
-                    default: '.',
+                stop: {
+                    type: 'boolean',
+                    description: 'Stop the server for this project',
                 },
             },
-            run({ args }) {
-                print_json(review_wiki(String(args.root ?? '.')));
+            async run({ args }) {
+                await run_ui({
+                    root: String(args.root),
+                    host: args.host,
+                    port: args.port,
+                    open: args.open,
+                    detach: args.detach,
+                    foreground: args.foreground,
+                    stop: args.stop,
+                });
             },
         }),
     },

package/dist/commands.js.map

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

package/dist/ui.d.ts

@@ -0,0 +1,12 @@
+import type { LaunchOptions } from '@wiki0/ui';
+export type UiArgs = {
+    root: string;
+    host?: string;
+    port?: string;
+    open?: boolean;
+    detach?: boolean;
+    foreground?: boolean;
+    stop?: boolean;
+};
+export declare function ui_launch_options(args: UiArgs, parse_port: (value: string | undefined) => number | undefined, env?: NodeJS.ProcessEnv): LaunchOptions;
+export declare function run_ui(args: UiArgs): Promise<void>;

package/dist/ui.js

@@ -0,0 +1,25 @@
+// Maps `wiki0 ui` flags to launch options. Detach is left unset
+// unless asked for, so @wiki0/ui can detach when stdout is not a
+// terminal, as when an agent runs the command.
+export function ui_launch_options(args, parse_port, env = process.env) {
+    return {
+        root: args.root,
+        host: args.host || undefined,
+        port: parse_port(args.port || env.WIKI0_UI_PORT),
+        open: args.open !== false,
+        detach: args.foreground ? false : args.detach ? true : undefined,
+        stop: args.stop === true,
+    };
+}
+export async function run_ui(args) {
+    // Loaded on use, so other commands don't pay for the server.
+    const { launch_ui, parse_port } = await import('@wiki0/ui');
+    try {
+        await launch_ui(ui_launch_options(args, parse_port));
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : error);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAYA,gEAAgE;AAChE,iEAAiE;AACjE,+CAA+C;AAC/C,MAAM,UAAU,iBAAiB,CAChC,IAAY,EACZ,UAA6D,EAC7D,GAAG,GAAsB,OAAO,CAAC,GAAG;IAEpC,OAAO;QACN,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,SAAS;QAC5B,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,aAAa,CAAC;QAChD,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,KAAK;QACzB,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAChE,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,IAAI;KACxB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAY;IACxC,6DAA6D;IAC7D,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAC5D,IAAI,CAAC;QACJ,MAAM,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACtB,CAAC;AACF,CAAC"}

package/dist/viewer.d.ts

@@ -0,0 +1 @@
+export declare function serve_viewer(root: string, host: string, port: number, open: boolean): void;

package/dist/viewer.js

@@ -0,0 +1,186 @@
+import { backlinks_for_page, graph_wiki, index_status, index_wiki, read_page, review_wiki, search_wiki, } from '@wiki0/core';
+import { spawn } from 'node:child_process';
+import { createServer } from 'node:http';
+function send_json(response, status_code, data) {
+    response.writeHead(status_code, {
+        'content-type': 'application/json; charset=utf-8',
+        'cache-control': 'no-store',
+    });
+    response.end(JSON.stringify(data));
+}
+function send_html(response, html) {
+    response.writeHead(200, {
+        'content-type': 'text/html; charset=utf-8',
+        'cache-control': 'no-store',
+    });
+    response.end(html);
+}
+function open_url(url) {
+    const command = process.platform === 'darwin'
+        ? 'open'
+        : process.platform === 'win32'
+            ? 'cmd'
+            : 'xdg-open';
+    const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];
+    const child = spawn(command, args, { detached: true, stdio: 'ignore' });
+    child.unref();
+}
+function read_view_state(root, url) {
+    const status = index_status(root);
+    if (status.stale)
+        index_wiki(root);
+    const graph = graph_wiki(root);
+    const review = review_wiki(root);
+    const query = url.searchParams.get('q')?.trim() ?? '';
+    const search = query ? search_wiki(query, root, 8) : [];
+    const selected_path = url.searchParams.get('page') ?? graph.nodes[0]?.path ?? null;
+    let selected_page = null;
+    let backlinks = [];
+    if (selected_path) {
+        try {
+            const selected_title = selected_path.replace(/\.md$/u, '');
+            selected_page = read_page(selected_title, root);
+            backlinks = backlinks_for_page(selected_title, root);
+        }
+        catch {
+            selected_page = null;
+        }
+    }
+    return {
+        root,
+        status: status.stale ? index_status(root) : status,
+        graph,
+        review,
+        query,
+        search,
+        selected_path,
+        selected_page,
+        backlinks,
+    };
+}
+function viewer_html() {
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>wiki0 viewer</title>
+<style>
+:root{color-scheme:light dark;font-family:Inter,ui-sans-serif,system-ui,sans-serif;background:#0f172a;color:#e2e8f0}body{margin:0}main{padding:24px;display:grid;gap:16px}header{display:flex;justify-content:space-between;gap:16px;align-items:end;flex-wrap:wrap}.muted{color:#94a3b8}.cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(160px,1fr));gap:12px}.card{background:#111827;border:1px solid #334155;border-radius:14px;padding:16px;box-shadow:0 12px 40px #02061740}.value{font-size:28px;font-weight:700}input,button{border-radius:10px;border:1px solid #475569;background:#020617;color:#e2e8f0;padding:10px 12px}button{cursor:pointer}button:hover{border-color:#93c5fd}.layout{display:grid;grid-template-columns:minmax(0,1fr) 380px;gap:16px}.graph{min-height:520px;overflow:hidden}.side{display:grid;gap:16px;align-content:start}.page-list{display:grid;gap:6px;max-height:220px;overflow:auto}.page-list button{text-align:left}.selected{border-color:#38bdf8;background:#082f49}svg{width:100%;height:520px}.node{fill:#38bdf8;cursor:pointer}.node.selected{fill:#f59e0b}.edge{stroke:#64748b;stroke-width:1.4}.edge.unresolved{stroke:#f97316;stroke-dasharray:4 4}.label{fill:#cbd5e1;font-size:12px;pointer-events:none}pre{white-space:pre-wrap;max-height:420px;overflow:auto}.result{border-top:1px solid #334155;padding:10px 0}@media(max-width:900px){.layout{grid-template-columns:1fr}}
+</style>
+</head>
+<body>
+<main>
+<header><div><h1>wiki0 viewer</h1><p id="root" class="muted"></p></div><form id="search"><input id="q" name="q" placeholder="Search wiki" /><button>Search</button></form></header>
+<section class="cards"><div class="card"><div class="muted">Pages</div><div id="pages" class="value">0</div></div><div class="card"><div class="muted">Edges</div><div id="edges" class="value">0</div></div><div class="card"><div class="muted">Unresolved</div><div id="unresolved" class="value">0</div></div><div class="card"><div class="muted">Review</div><div id="review" class="value">0</div></div></section>
+<section class="layout"><div class="card graph"><svg id="graph" role="img" aria-label="Wiki graph"></svg></div><aside class="side"><div class="card"><h2>Pages</h2><div id="page-list" class="page-list"></div></div><div class="card"><h2 id="page-title">Select a page</h2><p id="page-path" class="muted"></p><pre id="page-content"></pre><div id="backlinks"></div></div></aside></section>
+<section id="search-results" class="card" hidden><h2>Search results</h2><div id="results"></div></section>
+</main>
+<script>
+const state = { data: null };
+const esc = (value) => String(value ?? '').replace(/[&<>"']/g, (char) => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[char]));
+async function load_state() {
+  const params = new URLSearchParams(location.search);
+  const response = await fetch('/api/state?' + params.toString());
+  state.data = await response.json();
+  render_state(state.data);
+}
+function select_page(path) {
+  const params = new URLSearchParams(location.search);
+  params.set('page', path);
+  history.pushState(null, '', '?' + params.toString());
+  load_state();
+}
+function render_state(data) {
+  document.getElementById('root').textContent = data.root;
+  document.getElementById('q').value = data.query;
+  document.getElementById('pages').textContent = data.graph.nodes.length;
+  document.getElementById('edges').textContent = data.graph.edges.length;
+  document.getElementById('unresolved').textContent = data.graph.edges.filter((edge) => edge.status === 'unresolved').length;
+  document.getElementById('review').textContent = data.review.length;
+  document.getElementById('page-list').innerHTML = data.graph.nodes.map((node) => '<button class="' + (node.path === data.selected_path ? 'selected' : '') + '" type="button" onclick="select_page(' + JSON.stringify(node.path).replace(/"/g, '&quot;') + ')">' + esc(node.title) + '</button>').join('');
+  render_graph(data);
+  render_page(data);
+  render_search(data);
+}
+function render_graph(data) {
+  const svg = document.getElementById('graph');
+  const nodes = data.graph.nodes;
+  const width = svg.clientWidth || 800;
+  const height = svg.clientHeight || 520;
+  const radius = Math.max(130, Math.min(width, height) / 2 - 70);
+  const center_x = width / 2;
+  const center_y = height / 2;
+  const positions = new Map(nodes.map((node, index) => {
+    const angle = (Math.PI * 2 * index) / Math.max(nodes.length, 1) - Math.PI / 2;
+    return [node.path, { x: center_x + Math.cos(angle) * radius, y: center_y + Math.sin(angle) * radius }];
+  }));
+  const edge_markup = data.graph.edges.map((edge) => {
+    const from = positions.get(edge.from);
+    const to = positions.get(edge.to);
+    if (!from || !to) return '';
+    return '<line class="edge ' + edge.status + '" x1="' + from.x + '" y1="' + from.y + '" x2="' + to.x + '" y2="' + to.y + '"></line>';
+  }).join('');
+  const node_markup = nodes.map((node) => {
+    const point = positions.get(node.path);
+    const selected = node.path === data.selected_path ? ' selected' : '';
+    return '<g onclick="select_page(' + JSON.stringify(node.path).replace(/"/g, '&quot;') + ')"><circle class="node' + selected + '" cx="' + point.x + '" cy="' + point.y + '" r="8"></circle><text class="label" x="' + (point.x + 12) + '" y="' + (point.y + 4) + '">' + esc(node.title) + '</text></g>';
+  }).join('');
+  svg.innerHTML = edge_markup + node_markup;
+}
+function render_page(data) {
+  const page = data.selected_page;
+  document.getElementById('page-title').textContent = page ? page.title : 'Select a page';
+  document.getElementById('page-path').textContent = page ? page.path : '';
+  document.getElementById('page-content').textContent = page ? page.content : '';
+  document.getElementById('backlinks').innerHTML = '<h3>Backlinks</h3>' + (data.backlinks.length ? data.backlinks.map((link) => '<button type="button" onclick="select_page(' + JSON.stringify(link.path).replace(/"/g, '&quot;') + ')">' + esc(link.title) + '</button>').join(' ') : '<p class="muted">No backlinks.</p>');
+}
+function render_search(data) {
+  const section = document.getElementById('search-results');
+  section.hidden = !data.query;
+  document.getElementById('results').innerHTML = data.search.length ? data.search.map((result) => '<article class="result"><strong>' + esc(result.title) + '</strong><p class="muted">' + esc(result.path) + '</p><p>' + esc(result.snippet) + '</p></article>').join('') : '<p class="muted">No results.</p>';
+}
+document.getElementById('search').addEventListener('submit', (event) => {
+  event.preventDefault();
+  const params = new URLSearchParams(location.search);
+  const q = document.getElementById('q').value.trim();
+  if (q) params.set('q', q); else params.delete('q');
+  history.pushState(null, '', '?' + params.toString());
+  load_state();
+});
+addEventListener('popstate', load_state);
+addEventListener('resize', () => state.data && render_graph(state.data));
+load_state();
+</script>
+</body>
+</html>`;
+}
+export function serve_viewer(root, host, port, open) {
+    const server = createServer((request, response) => {
+        const url = new URL(request.url ?? '/', `http://${host}:${port}`);
+        try {
+            if (url.pathname === '/api/state') {
+                send_json(response, 200, read_view_state(root, url));
+                return;
+            }
+            if (url.pathname === '/') {
+                send_html(response, viewer_html());
+                return;
+            }
+            send_json(response, 404, { error: 'Not found' });
+        }
+        catch (error) {
+            send_json(response, 500, {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    });
+    server.listen(port, host, () => {
+        const address = `http://${host}:${port}`;
+        console.log(`Serving wiki0 viewer for ${root}`);
+        console.log(address);
+        if (open)
+            open_url(address);
+    });
+}
+//# sourceMappingURL=viewer.js.map

package/dist/viewer.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wiki0/cli",
-  "version": "0.0.5",
+  "version": "0.1.0",
   "description": "wiki0 command line interface",
   "homepage": "https://github.com/spences10/wiki0/tree/main/packages/cli#readme",
   "license": "MIT",
@@ -30,14 +30,15 @@
     "access": "public"
   },
   "dependencies": {
-    "citty": "^0.2.2",
-    "@wiki0/core": "0.0.5"
+    "@wiki0/core": "0.1.0",
+    "@wiki0/ui": "0.1.0",
+    "citty": "^0.2.2"
   },
   "devDependencies": {
-    "@types/node": "^25.8.0",
-    "typescript": "^6.0.3",
-    "vite-plus": "^0.1.22",
-    "vitest": "4.1.7"
+    "@types/node": "^24.0.0",
+    "typescript": "^7.0.2",
+    "vite-plus": "1.1.0",
+    "vitest": "5.0.3"
   },
   "engines": {
     "node": ">=24.15.0"
@@ -45,6 +46,6 @@
   "scripts": {
     "build:self": "vp exec tsc -p tsconfig.build.json && chmod +x dist/index.js",
     "check:self": "vp exec tsc --noEmit -p tsconfig.json",
-    "test:self": "vitest run"
+    "test:self": "vp test"
   }
 }