browzy 1.0.0

package/dist/cli/banner.js

@@ -0,0 +1,60 @@
+import chalk from 'chalk';
+import { loadConfig } from '../core/config.js';
+import { Wiki } from '../core/wiki/wiki.js';
+import { touchProfile, getWelcomeMessage } from './onboarding.js';
+// Brand color: #6C3BAA (purple)
+const p = chalk.hex('#6C3BAA');
+const pb = chalk.hex('#6C3BAA').bold;
+const pl = chalk.hex('#9B6ED8'); // lighter purple
+const dim = chalk.hex('#7A7A8C');
+const accent = chalk.hex('#C084FC');
+const bright = chalk.white.bold;
+const LOGO = `
+  ${pb('██████╗ ██████╗  ██████╗ ██╗    ██╗███████╗██╗   ██╗')}
+  ${pb('██╔══██╗██╔══██╗██╔═══██╗██║    ██║╚══███╔╝╚██╗ ██╔╝')}
+  ${pb('██████╔╝██████╔╝██║   ██║██║ █╗ ██║  ███╔╝  ╚████╔╝')}
+  ${pl('██╔══██╗██╔══██╗██║   ██║██║███╗██║ ███╔╝    ╚██╔╝')}
+  ${pl('██████╔╝██║  ██║╚██████╔╝╚███╔███╔╝███████╗   ██║')}
+  ${pl('╚═════╝ ╚═╝  ╚═╝ ╚═════╝  ╚══╝╚══╝ ╚══════╝   ╚═╝')}
+`;
+export function showBanner() {
+    console.log(LOGO);
+    // Personalized welcome
+    const profile = touchProfile();
+    if (profile) {
+        const welcome = getWelcomeMessage(profile);
+        console.log(`  ${accent(welcome)}`);
+    }
+    else {
+        console.log(dim('  LLM-powered knowledge base engine'));
+    }
+    console.log(dim(`${''.padEnd(52)}v1.0.0`));
+    console.log();
+    try {
+        const config = loadConfig();
+        const wiki = new Wiki(config.dataDir);
+        const stats = wiki.stats();
+        wiki.close();
+        const model = config.llm.model || 'default';
+        console.log(p('  ─────────────────────────────────────────────────────'));
+        console.log();
+        console.log(`  ${dim('sources')}  ${bright(String(stats.sources).padStart(4))}    ${dim('articles')}  ${bright(String(stats.articles).padStart(4))}    ${dim('concepts')}  ${bright(String(stats.concepts).padStart(4))}`);
+        console.log(`  ${dim('model')}    ${chalk.white(model)}`);
+        console.log(`  ${dim('data')}     ${chalk.white(config.dataDir)}`);
+    }
+    catch {
+        console.log(dim('  No knowledge base found.'));
+        console.log(`  Run ${accent('browzy init')} to get started.`);
+    }
+    console.log();
+    console.log(p('  ─────────────────────────────────────────────────────'));
+    console.log();
+    console.log(`  ${dim('Just type a question, or use / commands:')}`);
+    console.log();
+    console.log(`  ${accent('/add <sources...>')}     ${dim('Add URLs, PDFs, images, text files')}`);
+    console.log(`  ${accent('/ask <question>')}       ${dim('Search + ask your knowledge base')}`);
+    console.log(`  ${accent('/health')}              ${dim('Stats, checks & suggestions')}`);
+    console.log(`  ${accent('/rebuild')}             ${dim('Force recompile wiki')}`);
+    console.log(`  ${accent('/help')}                ${dim('All commands')}`);
+    console.log();
+}

package/dist/cli/commands/compile.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const compileCommand: Command;

package/dist/cli/commands/compile.js

@@ -0,0 +1,42 @@
+import { Command } from 'commander';
+import { WikiCompiler } from '../../core/compile/index.js';
+import { getConfigAndLLM, ensureDirs, spinner, success, info, error } from '../helpers.js';
+import { clampInt } from '../../core/utils.js';
+export const compileCommand = new Command('compile')
+    .description('Compile raw sources into wiki articles')
+    .option('-b, --batch-size <n>', 'Max sources to process', '20')
+    .option('--no-concepts', 'Skip concept extraction')
+    .action(async (opts) => {
+    const spin = spinner('Compiling wiki...');
+    spin.start();
+    try {
+        const { config, llm } = getConfigAndLLM();
+        ensureDirs(config);
+        const compiler = new WikiCompiler(config.dataDir, llm);
+        const result = await compiler.compile({
+            batchSize: clampInt(opts.batchSize, 1, 100, 20),
+            extractConcepts: opts.concepts !== false,
+        });
+        spin.stop();
+        if (result.articlesCreated.length > 0) {
+            success(`Created ${result.articlesCreated.length} articles:`);
+            result.articlesCreated.forEach(s => console.log(`  + ${s}`));
+        }
+        if (result.articlesUpdated.length > 0) {
+            success(`Updated ${result.articlesUpdated.length} articles:`);
+            result.articlesUpdated.forEach(s => console.log(`  ~ ${s}`));
+        }
+        if (result.conceptsExtracted.length > 0) {
+            info(`Suggested ${result.conceptsExtracted.length} new concepts:`);
+            result.conceptsExtracted.forEach(s => console.log(`  ? ${s}`));
+        }
+        if (result.articlesCreated.length === 0 && result.articlesUpdated.length === 0) {
+            info('Wiki is up to date — nothing to compile');
+        }
+    }
+    catch (err) {
+        spin.stop();
+        error(`Compilation failed: ${err.message}`);
+        process.exit(1);
+    }
+});

package/dist/cli/commands/ingest.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const ingestCommand: Command;

package/dist/cli/commands/ingest.js

@@ -0,0 +1,32 @@
+import { Command } from 'commander';
+import { ingest } from '../../core/ingest/index.js';
+import { getConfigAndLLM, ensureDirs, spinner, success, error } from '../helpers.js';
+export const ingestCommand = new Command('ingest')
+    .description('Ingest a source into the knowledge base')
+    .argument('<source>', 'URL or file path to ingest')
+    .option('-t, --type <type>', 'Source type (web, pdf, image, text, markdown)')
+    .action(async (source, opts) => {
+    const spin = spinner(`Ingesting: ${source}`);
+    spin.start();
+    try {
+        const { config, llm } = getConfigAndLLM();
+        ensureDirs(config);
+        const result = await ingest(source, config.dataDir, {
+            llm,
+            type: opts.type,
+        });
+        spin.stop();
+        success(`Ingested: ${result.title}`);
+        console.log(`  Type: ${result.type}`);
+        console.log(`  ID: ${result.id}`);
+        console.log(`  Path: ${result.path}`);
+        if (result.images.length > 0) {
+            console.log(`  Images: ${result.images.length}`);
+        }
+    }
+    catch (err) {
+        spin.stop();
+        error(`Failed to ingest: ${err.message}`);
+        process.exit(1);
+    }
+});

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const initCommand: Command;

package/dist/cli/commands/init.js

@@ -0,0 +1,48 @@
+import { Command } from 'commander';
+import { writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { success, info } from '../helpers.js';
+export const initCommand = new Command('init')
+    .description('Initialize a new browzy knowledge base')
+    .option('-d, --dir <path>', 'Data directory path', join(homedir(), '.browzy', 'default'))
+    .option('-p, --provider <provider>', 'LLM provider (claude or openai)', 'claude')
+    .action(async (opts) => {
+    const dataDir = opts.dir;
+    const provider = opts.provider;
+    // Create data directories
+    const dirs = [
+        dataDir,
+        join(dataDir, 'raw'),
+        join(dataDir, 'raw', 'images'),
+        join(dataDir, 'wiki'),
+        join(dataDir, 'output'),
+        join(dataDir, '.browzy'),
+    ];
+    for (const dir of dirs) {
+        mkdirSync(dir, { recursive: true });
+    }
+    // Write config file
+    const configPath = join(process.cwd(), 'browzy.config.json');
+    if (!existsSync(configPath)) {
+        const config = {
+            dataDir,
+            llm: {
+                provider,
+                model: provider === 'claude' ? 'claude-sonnet-4-20250514' : 'gpt-4o',
+            },
+            compile: {
+                batchSize: 20,
+                extractConcepts: true,
+            },
+        };
+        writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+        success(`Created config: ${configPath}`);
+    }
+    else {
+        info('Config already exists, skipping');
+    }
+    success(`Knowledge base initialized at: ${dataDir}`);
+    info(`Set your API key: export ${provider === 'claude' ? 'ANTHROPIC_API_KEY' : 'OPENAI_API_KEY'}=...`);
+    info('Start ingesting: browzy ingest <url-or-file>');
+});

package/dist/cli/commands/lint.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const lintCommand: Command;

package/dist/cli/commands/lint.js

@@ -0,0 +1,40 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { WikiLinter } from '../../core/lint/index.js';
+import { getConfigAndLLM, ensureDirs, spinner, success, info, error } from '../helpers.js';
+export const lintCommand = new Command('lint')
+    .description('Run health checks on the wiki')
+    .action(async () => {
+    const spin = spinner('Linting wiki...');
+    spin.start();
+    try {
+        const { config, llm } = getConfigAndLLM();
+        ensureDirs(config);
+        const linter = new WikiLinter(config.dataDir, llm);
+        const issues = await linter.lint();
+        spin.stop();
+        if (issues.length === 0) {
+            success('Wiki is healthy — no issues found');
+            return;
+        }
+        const errors = issues.filter(i => i.severity === 'error');
+        const warnings = issues.filter(i => i.severity === 'warning');
+        const suggestions = issues.filter(i => i.severity === 'suggestion');
+        for (const issue of issues) {
+            const icon = issue.severity === 'error' ? chalk.red('✗') :
+                issue.severity === 'warning' ? chalk.yellow('⚠') :
+                    chalk.blue('💡');
+            console.log(`${icon} [${issue.article}] ${issue.message}`);
+            if (issue.suggestion) {
+                console.log(`  → ${chalk.dim(issue.suggestion)}`);
+            }
+        }
+        console.log();
+        info(`${errors.length} errors, ${warnings.length} warnings, ${suggestions.length} suggestions`);
+    }
+    catch (err) {
+        spin.stop();
+        error(`Lint failed: ${err.message}`);
+        process.exit(1);
+    }
+});

package/dist/cli/commands/query.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const queryCommand: Command;

package/dist/cli/commands/query.js

@@ -0,0 +1,36 @@
+import { Command } from 'commander';
+import { QueryEngine } from '../../core/query/index.js';
+import { getConfigAndLLM, ensureDirs, spinner, success, info, error } from '../helpers.js';
+export const queryCommand = new Command('query')
+    .description('Ask a question against the knowledge base')
+    .argument('<question>', 'Your question')
+    .option('-f, --format <format>', 'Output format (markdown, marp, json)', 'markdown')
+    .option('-s, --save', 'Save output to a file')
+    .action(async (question, opts) => {
+    const spin = spinner('Researching...');
+    spin.start();
+    try {
+        const { config, llm } = getConfigAndLLM();
+        ensureDirs(config);
+        const engine = new QueryEngine(config.dataDir, llm);
+        const result = await engine.query(question, {
+            format: opts.format,
+            save: opts.save,
+        });
+        spin.stop();
+        console.log();
+        console.log(result.answer);
+        console.log();
+        if (result.sourcesUsed.length > 0) {
+            info(`Sources: ${result.sourcesUsed.join(', ')}`);
+        }
+        if (result.outputPath) {
+            success(`Saved to: ${result.outputPath}`);
+        }
+    }
+    catch (err) {
+        spin.stop();
+        error(`Query failed: ${err.message}`);
+        process.exit(1);
+    }
+});

package/dist/cli/commands/search.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const searchCommand: Command;

package/dist/cli/commands/search.js

@@ -0,0 +1,34 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { Wiki } from '../../core/wiki/index.js';
+import { getConfig, ensureDirs, info, error } from '../helpers.js';
+import { clampInt } from '../../core/utils.js';
+export const searchCommand = new Command('search')
+    .description('Search the knowledge base')
+    .argument('<query>', 'Search query')
+    .option('-n, --limit <n>', 'Max results', '10')
+    .action(async (query, opts) => {
+    try {
+        const config = getConfig();
+        ensureDirs(config);
+        const wiki = new Wiki(config.dataDir);
+        const results = wiki.search(query, clampInt(opts.limit, 1, 100, 10));
+        if (results.length === 0) {
+            info('No results found');
+            wiki.close();
+            return;
+        }
+        console.log();
+        for (const r of results) {
+            console.log(`${chalk.cyan(r.slug)} ${chalk.dim(`(${r.score.toFixed(1)})`)}`);
+            console.log(`  ${chalk.bold(r.title)}`);
+            console.log(`  ${chalk.dim(r.snippet)}`);
+            console.log();
+        }
+        wiki.close();
+    }
+    catch (err) {
+        error(`Search failed: ${err.message}`);
+        process.exit(1);
+    }
+});

package/dist/cli/commands/status.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const statusCommand: Command;

package/dist/cli/commands/status.js

@@ -0,0 +1,27 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { Wiki } from '../../core/wiki/index.js';
+import { getConfig, ensureDirs, info } from '../helpers.js';
+export const statusCommand = new Command('status')
+    .description('Show knowledge base status')
+    .action(async () => {
+    try {
+        const config = getConfig();
+        ensureDirs(config);
+        const wiki = new Wiki(config.dataDir);
+        const stats = wiki.stats();
+        console.log();
+        console.log(chalk.bold('browzy knowledge base'));
+        console.log(chalk.dim(`Data: ${config.dataDir}`));
+        console.log(chalk.dim(`LLM: ${config.llm.provider} (${config.llm.model || 'default'})`));
+        console.log();
+        console.log(`  Sources:  ${chalk.cyan(stats.sources)}`);
+        console.log(`  Articles: ${chalk.cyan(stats.articles)}`);
+        console.log(`  Concepts: ${chalk.cyan(stats.concepts)}`);
+        console.log();
+        wiki.close();
+    }
+    catch (err) {
+        info(`No knowledge base found. Run: browzy init`);
+    }
+});

package/dist/cli/components/Banner.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+interface BannerProps {
+    welcome: string;
+    stats: {
+        sources: number;
+        articles: number;
+        concepts: number;
+    };
+    model: string;
+    dataDir: string;
+}
+export declare const Banner: React.FC<BannerProps>;
+export {};

package/dist/cli/components/Banner.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import React from 'react';
+import { Text, Box } from 'ink';
+import { getTheme } from '../theme.js';
+import { loadStreak } from '../personality.js';
+const LOGO_TOP = [
+    '██████╗ ██████╗  ██████╗ ██╗    ██╗███████╗██╗   ██╗',
+    '██╔══██╗██╔══██╗██╔═══██╗██║    ██║╚══███╔╝╚██╗ ██╔╝',
+    '██████╔╝██████╔╝██║   ██║██║ █╗ ██║  ███╔╝  ╚████╔╝',
+];
+const LOGO_BOTTOM = [
+    '██╔══██╗██╔══██╗██║   ██║██║███╗██║ ███╔╝    ╚██╔╝',
+    '██████╔╝██║  ██║╚██████╔╝╚███╔███╔╝███████╗   ██║',
+    '╚═════╝ ╚═╝  ╚═╝ ╚═════╝  ╚══╝╚══╝ ╚══════╝   ╚═╝',
+];
+export const Banner = React.memo(({ welcome, stats, model, dataDir }) => {
+    const theme = getTheme();
+    const streak = loadStreak();
+    return (_jsxs(Box, { flexDirection: "column", paddingLeft: 2, children: [_jsxs(Box, { flexDirection: "column", marginBottom: 0, children: [LOGO_TOP.map((line, i) => (_jsx(Text, { bold: true, color: theme.brand, children: line }, `top-${i}`))), LOGO_BOTTOM.map((line, i) => (_jsx(Text, { color: theme.brandLight, children: line }, `bot-${i}`)))] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.accent, children: welcome }) }), _jsxs(Text, { color: theme.textMuted, children: [''.padEnd(50), "v1.0.0"] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.separator, children: '─'.repeat(55) }) }), _jsxs(Box, { marginTop: 1, gap: 2, children: [_jsxs(Text, { children: [_jsx(Text, { color: theme.textMuted, children: "sources " }), _jsx(Text, { bold: true, color: theme.text, children: stats.sources })] }), _jsx(Text, { color: theme.textMuted, children: "\u00B7" }), _jsxs(Text, { children: [_jsx(Text, { color: theme.textMuted, children: "articles " }), _jsx(Text, { bold: true, color: theme.text, children: stats.articles })] }), _jsx(Text, { color: theme.textMuted, children: "\u00B7" }), _jsxs(Text, { children: [_jsx(Text, { color: theme.textMuted, children: "concepts " }), _jsx(Text, { bold: true, color: theme.text, children: stats.concepts })] }), streak.currentStreak >= 2 && (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.textMuted, children: "\u00B7" }), _jsxs(Text, { color: theme.accent, children: [streak.currentStreak, "-day streak"] })] }))] }), _jsxs(Box, { children: [_jsx(Text, { color: theme.textMuted, children: "model    " }), _jsx(Text, { color: theme.text, children: model })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.separator, children: '─'.repeat(55) }) }), _jsx(Box, { flexDirection: "column", marginTop: 1, marginBottom: 1, children: stats.articles === 0 ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.accent, children: "  A blank canvas. Add your first source and watch the magic happen." }), _jsx(Text, { children: " " }), _jsxs(Text, { children: [_jsxs(Text, { color: theme.accent, children: ["  /add ", '<url or file>', "  "] }), _jsx(Text, { color: theme.textMuted, children: "Feed your browzy its first source" })] })] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: theme.textMuted, children: "  Just type a question, or use / commands:" }), _jsxs(Text, { children: [_jsxs(Text, { color: theme.accent, children: ["  /add ", '<sources...>', "   "] }), _jsx(Text, { color: theme.textMuted, children: "Feed your browzy new knowledge" })] }), _jsxs(Text, { children: [_jsx(Text, { color: theme.accent, children: "  /health              " }), _jsx(Text, { color: theme.textMuted, children: "How is your browzy doing?" })] }), _jsxs(Text, { children: [_jsx(Text, { color: theme.accent, children: "  /help                " }), _jsx(Text, { color: theme.textMuted, children: "All commands" })] })] })) })] }));
+});

package/dist/cli/components/Markdown.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+/**
+ * Render markdown as styled terminal text.
+ * Handles: headers, bold, italic, code blocks, blockquotes,
+ * lists, wiki links, markdown links, horizontal rules, tables.
+ * Strikethrough disabled (~ used for "approximately" too often).
+ */
+export declare function renderMarkdown(input: string): string;
+/**
+ * Ink component for rendering markdown.
+ */
+export declare const MarkdownText: React.FC<{
+    children: string;
+}>;