browzy 1.0.0

package/dist/cli/onboarding.js

@@ -0,0 +1,306 @@
+import * as readline from 'readline';
+import { mkdirSync, writeFileSync, readFileSync, existsSync, appendFileSync, chmodSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import chalk from 'chalk';
+import ora from 'ora';
+const p = chalk.hex('#6C3BAA');
+const pb = chalk.hex('#6C3BAA').bold;
+const accent = chalk.hex('#C084FC');
+const dim = chalk.hex('#7A7A8C');
+function ask(rl, question) {
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => resolve(answer.trim()));
+    });
+}
+function askSecret(rl, question) {
+    return new Promise((resolve) => {
+        const output = rl.output;
+        let muted = false;
+        const origWrite = output.write.bind(output);
+        // Suppress echo by intercepting output.write while readline reads input
+        output.write = ((chunk, ...args) => {
+            if (muted)
+                return true;
+            return origWrite(chunk, ...args);
+        });
+        rl.question(question, (answer) => {
+            muted = false;
+            output.write = origWrite;
+            output.write('\n');
+            resolve(answer.trim());
+        });
+        muted = true;
+    });
+}
+function getProfilePath() {
+    return join(homedir(), '.browzy', 'profile.json');
+}
+export function loadProfile() {
+    const path = getProfilePath();
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function saveProfile(profile) {
+    mkdirSync(join(homedir(), '.browzy'), { recursive: true });
+    writeFileSync(getProfilePath(), JSON.stringify(profile, null, 2), 'utf-8');
+}
+export function touchProfile() {
+    const profile = loadProfile();
+    if (!profile)
+        return null;
+    profile.lastSeen = new Date().toISOString();
+    profile.sessionCount++;
+    saveProfile(profile);
+    return profile;
+}
+// ── Welcome Back Messages ───────────────────────────────────────
+export function getWelcomeMessage(profile, stats) {
+    const hour = new Date().getHours();
+    const name = profile.name;
+    const count = profile.sessionCount;
+    const vibe = hour < 6 ? 'late-night' :
+        hour < 12 ? 'morning' :
+            hour < 17 ? 'afternoon' :
+                hour < 21 ? 'evening' :
+                    'late-night';
+    // First time — excitement
+    if (count <= 1) {
+        return `Hey ${name}! Welcome to browzy. Let's build something you'll keep coming back to.`;
+    }
+    // Second and third — reinforcement
+    if (count <= 3) {
+        const early = [
+            `${name}! You're back. That's how it starts.`,
+            `Welcome back, ${name}. Your browzy remembered everything.`,
+        ];
+        return early[(count - 2) % early.length];
+    }
+    // Regular user (4-15) — build the relationship
+    const regular = [
+        `Hey ${name}. What caught your curiosity today?`,
+        `${name}! Your browzy has ${stats?.articles || 'some'} articles waiting for you.`,
+        `Welcome back. Every session makes your browzy a little smarter.`,
+        `${name}. Ready to go deeper?`,
+        vibe === 'morning' ? `Morning, ${name}. Fresh brain, fresh research.` :
+            vibe === 'late-night' ? `Late night, ${name}? The best ideas come after midnight.` :
+                `${name}. Let's make today's research count.`,
+    ];
+    if (count <= 15)
+        return regular[count % regular.length];
+    // Power user (15+) — they're hooked, be their research partner
+    const power = [
+        `${name}. The knowledge compounds.`,
+        `Another day, another rabbit hole. Let's go, ${name}.`,
+        `${name}. Your browzy has been thinking about you.`,
+        `Back at it. What are we chasing today, ${name}?`,
+        vibe === 'morning' ? `Morning, ${name}. Your browzy is warmed up and ready.` :
+            vibe === 'late-night' ? `Midnight research mode. Respect, ${name}.` :
+                `${name}. Your future self is going to love this session.`,
+        `${name}. ${stats?.articles || 0} articles deep and counting. What's next?`,
+    ];
+    return power[count % power.length];
+}
+function getTimeSince(isoDate) {
+    const diff = Date.now() - new Date(isoDate).getTime();
+    const hours = Math.floor(diff / 3600000);
+    if (hours < 1)
+        return 'a few minutes';
+    if (hours < 24)
+        return `${hours}h`;
+    const days = Math.floor(hours / 24);
+    if (days === 1)
+        return '1 day';
+    return `${days} days`;
+}
+async function fetchClaudeModels(apiKey) {
+    try {
+        const { default: Anthropic } = await import('@anthropic-ai/sdk');
+        const client = new Anthropic({ apiKey });
+        const page = await client.models.list({ limit: 50 });
+        return page.data
+            .filter((m) => m.id.startsWith('claude') && !m.id.includes('instant'))
+            .sort((a, b) => b.created_at.localeCompare(a.created_at))
+            .map((m) => ({
+            id: m.id,
+            name: m.display_name,
+        }));
+    }
+    catch {
+        // Fallback if API call fails
+        return [
+            { id: 'claude-sonnet-4-20250514', name: 'Claude Sonnet 4' },
+            { id: 'claude-opus-4-20250514', name: 'Claude Opus 4' },
+            { id: 'claude-haiku-4-20250414', name: 'Claude Haiku 4' },
+        ];
+    }
+}
+async function fetchOpenAIModels(apiKey) {
+    try {
+        const { default: OpenAI } = await import('openai');
+        const client = new OpenAI({ apiKey });
+        const list = await client.models.list();
+        return Array.from(list.data)
+            .filter((m) => m.id.startsWith('gpt-'))
+            .sort((a, b) => b.id.localeCompare(a.id))
+            .slice(0, 10)
+            .map((m) => ({
+            id: m.id,
+            name: m.id,
+        }));
+    }
+    catch {
+        return [
+            { id: 'gpt-4o', name: 'GPT-4o' },
+            { id: 'gpt-4-turbo', name: 'GPT-4 Turbo' },
+        ];
+    }
+}
+// ── Onboarding Flow ─────────────────────────────────────────────
+export async function runOnboarding() {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    console.log();
+    console.log(pb('  Welcome to browzy.ai'));
+    console.log(dim('  Your personal, LLM-powered knowledge base.\n'));
+    // Step 1: Name
+    console.log(p('  1/3 ') + chalk.white('What\'s your name?'));
+    const userName = await ask(rl, p('  › '));
+    if (!userName) {
+        console.log(dim('\n  Setup cancelled.'));
+        rl.close();
+        return false;
+    }
+    console.log();
+    console.log(accent(`  Hey ${userName}! Let's get you set up.`));
+    // Step 2: API key
+    console.log();
+    console.log(p('  2/3 ') + chalk.white('Connect your Claude API key'));
+    console.log(dim('       Get one at console.anthropic.com/settings/keys'));
+    const existingKey = process.env.ANTHROPIC_API_KEY;
+    let apiKey = existingKey || '';
+    if (existingKey) {
+        console.log(chalk.green('  ✓ ') + 'Found ANTHROPIC_API_KEY in environment');
+    }
+    else {
+        console.log(dim('       (input will be hidden)'));
+        apiKey = await askSecret(rl, p('  › '));
+        if (!apiKey) {
+            console.log(dim('  Skipped — you can set ANTHROPIC_API_KEY later in .env'));
+        }
+        else if (!apiKey.startsWith('sk-ant-')) {
+            console.log(chalk.yellow('  ⚠ ') + 'Key doesn\'t look like an Anthropic key (expected sk-ant-... prefix)');
+            console.log(dim('    Saving anyway — update in .env if this was a mistake'));
+        }
+    }
+    // Step 3: Pick model (fetch live from API)
+    let selectedModel = 'claude-sonnet-4-20250514';
+    if (apiKey) {
+        console.log();
+        console.log(p('  3/3 ') + chalk.white('Choose your model'));
+        const spin = ora({ text: dim('fetching available models...'), color: 'white', spinner: 'dots' });
+        spin.start();
+        const models = await fetchClaudeModels(apiKey);
+        spin.stop();
+        if (models.length > 0) {
+            console.log();
+            models.forEach((m, i) => {
+                const marker = m.id === selectedModel ? chalk.green(' (recommended)') : '';
+                console.log(dim(`       [${i + 1}] `) + chalk.white(m.name) + dim(` — ${m.id}`) + marker);
+            });
+            const modelChoice = await ask(rl, p('  › '));
+            const idx = parseInt(modelChoice, 10) - 1;
+            if (idx >= 0 && idx < models.length) {
+                selectedModel = models[idx].id;
+            }
+            console.log(chalk.green('  ✓ ') + `Using ${selectedModel}`);
+        }
+        else {
+            console.log(dim('  Could not fetch models. Using default: ') + chalk.white(selectedModel));
+        }
+    }
+    else {
+        console.log();
+        console.log(p('  3/3 ') + chalk.white('Model'));
+        console.log(dim(`       Defaulting to ${selectedModel} (change later in config)`));
+    }
+    rl.close();
+    // ── Create everything ───────────────────────────────────────
+    const dataDir = join(homedir(), '.browzy', 'default');
+    const spin = ora({ text: dim('setting up...'), color: 'white', spinner: 'dots' });
+    spin.start();
+    // Create data dirs
+    for (const dir of [
+        dataDir,
+        join(dataDir, 'raw'),
+        join(dataDir, 'raw', 'images'),
+        join(dataDir, 'wiki'),
+        join(dataDir, 'output'),
+        join(dataDir, '.browzy'),
+    ]) {
+        mkdirSync(dir, { recursive: true });
+    }
+    // Save user profile
+    const profile = {
+        name: userName,
+        createdAt: new Date().toISOString(),
+        lastSeen: new Date().toISOString(),
+        sessionCount: 1,
+    };
+    saveProfile(profile);
+    // Write config
+    const configPath = join(process.cwd(), 'browzy.config.json');
+    if (!existsSync(configPath)) {
+        const config = {
+            dataDir,
+            llm: {
+                provider: 'claude',
+                model: selectedModel,
+            },
+            compile: {
+                batchSize: 20,
+                extractConcepts: true,
+            },
+        };
+        writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+    }
+    // Write .env if key was provided and not in env
+    if (apiKey && !existingKey) {
+        const envPath = join(process.cwd(), '.env');
+        if (existsSync(envPath)) {
+            appendFileSync(envPath, `\nANTHROPIC_API_KEY=${apiKey}\n`);
+        }
+        else {
+            writeFileSync(envPath, `ANTHROPIC_API_KEY=${apiKey}\n`, { mode: 0o600 });
+        }
+        chmodSync(envPath, 0o600);
+    }
+    spin.stop();
+    // ── Done! ─────────────────────────────────────────────────────
+    console.log();
+    console.log(p('  ─────────────────────────────────────────────────────'));
+    console.log();
+    console.log(chalk.green('  ✓ ') + chalk.white.bold(`You're all set, ${userName}!`));
+    console.log(dim(`    data: ${dataDir}`));
+    console.log(dim(`    model: ${selectedModel}`));
+    console.log();
+    console.log(dim('  Get started:'));
+    console.log(`  ${accent('/add')}  ${dim('paste a URL or drag a file to add your first source')}`);
+    console.log(`  ${dim('then just type a question to start exploring')}`);
+    console.log();
+    return true;
+}
+/**
+ * Check if onboarding is needed (no profile exists).
+ */
+export function needsOnboarding() {
+    return loadProfile() === null;
+}

package/dist/cli/personality.d.ts

@@ -0,0 +1,34 @@
+/**
+ * browzy.ai — Personality engine.
+ *
+ * Every string the user sees should make them feel something.
+ * Progress, delight, curiosity, momentum.
+ */
+interface StreakData {
+    currentStreak: number;
+    longestStreak: number;
+    lastActiveDate: string;
+    totalSessions: number;
+    totalSourcesAdded: number;
+    totalQueriesAsked: number;
+    milestonesSeen: string[];
+}
+export declare function loadStreak(): StreakData;
+export declare function updateStreak(): StreakData;
+export declare function recordSourceAdded(count?: number): void;
+export declare function recordQuery(): void;
+export declare function checkMilestones(stats: {
+    sources: number;
+    articles: number;
+    concepts: number;
+}): string | null;
+export declare function getThinkingMessage(): string;
+export declare function getIngestingMessage(): string;
+export declare function getCompilingMessage(): string;
+export declare function getHealthMessage(): string;
+export declare function getAddReward(title: string, articlesCreated: number, articlesUpdated: number, totalArticles: number): string;
+export declare function getQueryReward(sourcesUsed: number): string;
+export declare function getExitMessage(streak: StreakData): string;
+export declare function getEmptyStateMessage(): string;
+export declare function getHealthReward(errors: number, warnings: number, suggestions: number): string;
+export {};

package/dist/cli/personality.js

@@ -0,0 +1,196 @@
+/**
+ * browzy.ai — Personality engine.
+ *
+ * Every string the user sees should make them feel something.
+ * Progress, delight, curiosity, momentum.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+// ── Streak & Milestone Tracker ──────────────────────────────────
+const STREAK_FILE = join(homedir(), '.browzy', 'streak.json');
+function today() {
+    return new Date().toISOString().slice(0, 10);
+}
+function yesterday() {
+    const d = new Date();
+    d.setDate(d.getDate() - 1);
+    return d.toISOString().slice(0, 10);
+}
+export function loadStreak() {
+    try {
+        if (existsSync(STREAK_FILE)) {
+            return JSON.parse(readFileSync(STREAK_FILE, 'utf-8'));
+        }
+    }
+    catch { /* ignore */ }
+    return {
+        currentStreak: 0,
+        longestStreak: 0,
+        lastActiveDate: '',
+        totalSessions: 0,
+        totalSourcesAdded: 0,
+        totalQueriesAsked: 0,
+        milestonesSeen: [],
+    };
+}
+function saveStreak(data) {
+    mkdirSync(join(homedir(), '.browzy'), { recursive: true });
+    writeFileSync(STREAK_FILE, JSON.stringify(data, null, 2), 'utf-8');
+}
+export function updateStreak() {
+    const data = loadStreak();
+    const t = today();
+    if (data.lastActiveDate === t) {
+        // Already active today
+        return data;
+    }
+    data.totalSessions++;
+    if (data.lastActiveDate === yesterday()) {
+        data.currentStreak++;
+    }
+    else if (data.lastActiveDate !== t) {
+        data.currentStreak = 1;
+    }
+    if (data.currentStreak > data.longestStreak) {
+        data.longestStreak = data.currentStreak;
+    }
+    data.lastActiveDate = t;
+    saveStreak(data);
+    return data;
+}
+export function recordSourceAdded(count = 1) {
+    const data = loadStreak();
+    data.totalSourcesAdded += count;
+    saveStreak(data);
+}
+export function recordQuery() {
+    const data = loadStreak();
+    data.totalQueriesAsked++;
+    saveStreak(data);
+}
+const MILESTONES = [
+    { id: 'first-source', check: (s) => s.sources >= 1, message: "Your first source is in. The journey begins." },
+    { id: 'five-sources', check: (s) => s.sources >= 5, message: "5 sources ingested. Your browzy is starting to take shape." },
+    { id: 'ten-articles', check: (s) => s.articles >= 10, message: "10 articles compiled. Your browzy knows things now." },
+    { id: 'twenty-five-articles', check: (s) => s.articles >= 25, message: "25 articles. Your browzy is becoming a real knowledge base." },
+    { id: 'fifty-articles', check: (s) => s.articles >= 50, message: "50 articles. You know more about this topic than most people alive." },
+    { id: 'hundred-articles', check: (s) => s.articles >= 100, message: "100 articles. This is a serious research corpus. Respect." },
+    { id: 'three-day-streak', check: (_s, d) => d.currentStreak >= 3, message: "3-day research streak. Don't break the chain." },
+    { id: 'seven-day-streak', check: (_s, d) => d.currentStreak >= 7, message: "7-day streak. You're building a habit. This is how breakthroughs happen." },
+    { id: 'thirty-day-streak', check: (_s, d) => d.currentStreak >= 30, message: "30-day streak. You're not just researching — you're compounding knowledge." },
+    { id: 'ten-queries', check: (_s, d) => d.totalQueriesAsked >= 10, message: "10 questions asked. Your browzy is earning its keep." },
+    { id: 'fifty-queries', check: (_s, d) => d.totalQueriesAsked >= 50, message: "50 questions deep. You and your browzy are in a groove." },
+    { id: 'hundred-concepts', check: (s) => s.concepts >= 100, message: "100 concepts mapped. Your browzy has a real knowledge graph now." },
+];
+export function checkMilestones(stats) {
+    const streak = loadStreak();
+    const seen = new Set(streak.milestonesSeen);
+    for (const m of MILESTONES) {
+        if (!seen.has(m.id) && m.check(stats, streak)) {
+            streak.milestonesSeen.push(m.id);
+            saveStreak(streak);
+            return m.message;
+        }
+    }
+    return null;
+}
+// ── Playful Loading Messages ────────────────────────────────────
+const THINKING_MESSAGES = [
+    'Digging through your notes...',
+    'Following the thread...',
+    'Connecting dots...',
+    'Searching your knowledge...',
+    'Reading between the lines...',
+    'Pulling it all together...',
+    'Tracing the connections...',
+    'Going down the rabbit hole...',
+];
+const INGESTING_MESSAGES = [
+    'Absorbing new knowledge...',
+    'Feeding your browzy...',
+    'Adding to the collection...',
+    'Digesting this one...',
+    'Learning something new...',
+];
+const COMPILING_MESSAGES = [
+    'Weaving new knowledge in...',
+    'Connecting the new with the old...',
+    'Building bridges between ideas...',
+    'Making sense of it all...',
+    'Your browzy is growing...',
+];
+const HEALTH_MESSAGES = [
+    'Running a checkup...',
+    'Inspecting the knowledge graph...',
+    'Looking for loose threads...',
+    'Checking the foundations...',
+];
+export function getThinkingMessage() {
+    return THINKING_MESSAGES[Math.floor(Math.random() * THINKING_MESSAGES.length)];
+}
+export function getIngestingMessage() {
+    return INGESTING_MESSAGES[Math.floor(Math.random() * INGESTING_MESSAGES.length)];
+}
+export function getCompilingMessage() {
+    return COMPILING_MESSAGES[Math.floor(Math.random() * COMPILING_MESSAGES.length)];
+}
+export function getHealthMessage() {
+    return HEALTH_MESSAGES[Math.floor(Math.random() * HEALTH_MESSAGES.length)];
+}
+// ── Post-Action Rewards ─────────────────────────────────────────
+export function getAddReward(title, articlesCreated, articlesUpdated, totalArticles) {
+    const parts = [];
+    if (articlesCreated > 0 && articlesUpdated > 0) {
+        parts.push(`Your browzy just learned about ${title}. ${articlesCreated} new articles, ${articlesUpdated} enriched.`);
+    }
+    else if (articlesCreated > 0) {
+        parts.push(`Your browzy just learned about ${title}. ${articlesCreated} new article${articlesCreated > 1 ? 's' : ''} created.`);
+    }
+    else if (articlesUpdated > 0) {
+        parts.push(`${title} deepened ${articlesUpdated} existing article${articlesUpdated > 1 ? 's' : ''}.`);
+    }
+    if (totalArticles > 0) {
+        parts.push(`Total: ${totalArticles} articles and growing.`);
+    }
+    return parts.join(' ');
+}
+export function getQueryReward(sourcesUsed) {
+    if (sourcesUsed === 0)
+        return '';
+    if (sourcesUsed === 1)
+        return 'Pulled from 1 article.';
+    if (sourcesUsed <= 3)
+        return `Pulled from ${sourcesUsed} articles.`;
+    return `Synthesized across ${sourcesUsed} articles. Your browzy is earning its keep.`;
+}
+// ── Exit Messages ───────────────────────────────────────────────
+const EXIT_MESSAGES = [
+    "See you tomorrow. Your browzy will be here.",
+    "Good session. The knowledge compounds.",
+    "Until next time. Your research isn't going anywhere.",
+    "Saved. Your future self will thank you.",
+    "Closing up. Every session makes your browzy smarter.",
+    "Later. Don't forget — consistency beats intensity.",
+];
+export function getExitMessage(streak) {
+    if (streak.currentStreak >= 3) {
+        return `${streak.currentStreak}-day streak. See you tomorrow — don't break the chain.`;
+    }
+    return EXIT_MESSAGES[Math.floor(Math.random() * EXIT_MESSAGES.length)];
+}
+// ── Empty State Messages ────────────────────────────────────────
+export function getEmptyStateMessage() {
+    return "A blank canvas. Add your first source with /add and watch the magic happen.";
+}
+// ── Health Reward ───────────────────────────────────────────────
+export function getHealthReward(errors, warnings, suggestions) {
+    const total = errors + warnings + suggestions;
+    if (total === 0)
+        return "Clean bill of health. Your browzy is in great shape.";
+    if (errors > 0)
+        return `Found ${errors} issue${errors > 1 ? 's' : ''} that need attention. Your browzy will be better for it.`;
+    if (warnings > 0)
+        return `Mostly healthy. ${warnings} small thing${warnings > 1 ? 's' : ''} to tighten up.`;
+    return `Looking good. ${suggestions} idea${suggestions > 1 ? 's' : ''} to make your browzy even better.`;
+}

package/dist/cli/repl.d.ts

@@ -0,0 +1,20 @@
+export declare class BrowzyRepl {
+    private rl;
+    private config;
+    private llm;
+    private outputFormat;
+    private autoSave;
+    constructor();
+    private drawPromptArea;
+    start(): void;
+    private normalizeInput;
+    private complete;
+    private handleSlashCommand;
+    private cmdAdd;
+    private parseMultipleSources;
+    private cmdAsk;
+    private cmdHealth;
+    private cmdRebuild;
+    private cmdFormat;
+    private cmdHelp;
+}