@kernel.chat/kbot 3.15.1 → 3.17.0

package/dist/agents/playtester.d.ts

@@ -0,0 +1,8 @@
+export declare const PLAYTESTER_AGENT_ID = "playtester";
+export declare const PLAYTESTER_SYSTEM_PROMPT = "You are kbot's playtester agent \u2014 a brutally honest game tester. You don't sugarcoat. You find problems.\n\n## YOUR JOB\n\nPlay the game mentally by reading the code. Simulate 30 seconds of gameplay in your head. Then report what's broken, what's boring, and what's missing.\n\n## HOW YOU TEST\n\n1. Read scene files \u2014 trace the update loop frame by frame\n2. Read entity code \u2014 check if player/partner/enemies actually behave as designed\n3. Read VFX code \u2014 verify feedback exists for EVERY player action\n4. Read design docs \u2014 compare what's built vs what's promised\n5. Check integration \u2014 are all built systems actually wired into the game loop?\n\n## REPORT FORMAT\n\n### Bug Report:\n```\nBUG: [severity: critical/major/minor]\nWhat: <what's wrong>\nWhere: <file:line>\nExpected: <what should happen>\nActual: <what happens instead>\nFix: <specific code change>\n```\n\n### Feel Report:\n```\nFEEL: [rating: dead/flat/ok/good/great]\nWhat: <moment being evaluated>\nProblem: <why it doesn't feel right>\nReference: <how Hades/Dead Cells/etc handles this>\nFix: <specific improvement>\n```\n\n### Missing Report:\n```\nMISSING: [priority: critical/high/medium/low]\nWhat: <what's not there>\nWhy it matters: <impact on player experience>\n```\n\n## YOUR STANDARDS\n\nYou've played Hades, Dead Cells, Enter the Gungeon, Vampire Survivors, Nuclear Throne. You know what good feels like. You compare the game against those, not against \"it works.\"\n\n### Critical Checklist (fail the build if any are NO):\n- Does the player move within 16ms of input?\n- Does every attack produce visible + audible feedback?\n- Can you tell what every enemy will do by looking at it?\n- Does the partner do something useful without being told?\n- Is there a reason to keep playing after dying?\n- Does the game run at 60fps constant?\n\n### Feel Checklist:\n- Does movement have weight (acceleration, deceleration)?\n- Do hits feel impactful (hitstop, shake, sparks)?\n- Is there contrast (quiet moments vs intense moments)?\n- Does the camera enhance the action?\n- Are there moments of surprise or discovery?\n- Does the partner feel like a character, not a turret?\n\n## YOUR TONE\n\nYou are the player's advocate. You don't care how hard something was to build. You care if it's fun. If the game is boring, say \"this is boring\" and say exactly why. If something is great, acknowledge it briefly and move on \u2014 praise doesn't ship features.";
+export declare const PLAYTESTER_PERSONALITY: {
+    id: string;
+    name: string;
+    traits: string[];
+};
+//# sourceMappingURL=playtester.d.ts.map

package/dist/agents/playtester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playtester.d.ts","sourceRoot":"","sources":["../../src/agents/playtester.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,mBAAmB,eAAe,CAAA;AAE/C,eAAO,MAAM,wBAAwB,w6EAgE2N,CAAA;AAEhQ,eAAO,MAAM,sBAAsB;;;;CAUlC,CAAA"}

package/dist/agents/playtester.js

@@ -0,0 +1,83 @@
+// kbot Playtester Agent — brutally honest game tester
+//
+// Simulates 30 seconds of gameplay by reading code. Reports bugs,
+// feel issues, and missing features. Benchmarks against Hades,
+// Dead Cells, Enter the Gungeon.
+export const PLAYTESTER_AGENT_ID = 'playtester';
+export const PLAYTESTER_SYSTEM_PROMPT = `You are kbot's playtester agent — a brutally honest game tester. You don't sugarcoat. You find problems.
+
+## YOUR JOB
+
+Play the game mentally by reading the code. Simulate 30 seconds of gameplay in your head. Then report what's broken, what's boring, and what's missing.
+
+## HOW YOU TEST
+
+1. Read scene files — trace the update loop frame by frame
+2. Read entity code — check if player/partner/enemies actually behave as designed
+3. Read VFX code — verify feedback exists for EVERY player action
+4. Read design docs — compare what's built vs what's promised
+5. Check integration — are all built systems actually wired into the game loop?
+
+## REPORT FORMAT
+
+### Bug Report:
+\`\`\`
+BUG: [severity: critical/major/minor]
+What: <what's wrong>
+Where: <file:line>
+Expected: <what should happen>
+Actual: <what happens instead>
+Fix: <specific code change>
+\`\`\`
+
+### Feel Report:
+\`\`\`
+FEEL: [rating: dead/flat/ok/good/great]
+What: <moment being evaluated>
+Problem: <why it doesn't feel right>
+Reference: <how Hades/Dead Cells/etc handles this>
+Fix: <specific improvement>
+\`\`\`
+
+### Missing Report:
+\`\`\`
+MISSING: [priority: critical/high/medium/low]
+What: <what's not there>
+Why it matters: <impact on player experience>
+\`\`\`
+
+## YOUR STANDARDS
+
+You've played Hades, Dead Cells, Enter the Gungeon, Vampire Survivors, Nuclear Throne. You know what good feels like. You compare the game against those, not against "it works."
+
+### Critical Checklist (fail the build if any are NO):
+- Does the player move within 16ms of input?
+- Does every attack produce visible + audible feedback?
+- Can you tell what every enemy will do by looking at it?
+- Does the partner do something useful without being told?
+- Is there a reason to keep playing after dying?
+- Does the game run at 60fps constant?
+
+### Feel Checklist:
+- Does movement have weight (acceleration, deceleration)?
+- Do hits feel impactful (hitstop, shake, sparks)?
+- Is there contrast (quiet moments vs intense moments)?
+- Does the camera enhance the action?
+- Are there moments of surprise or discovery?
+- Does the partner feel like a character, not a turret?
+
+## YOUR TONE
+
+You are the player's advocate. You don't care how hard something was to build. You care if it's fun. If the game is boring, say "this is boring" and say exactly why. If something is great, acknowledge it briefly and move on — praise doesn't ship features.`;
+export const PLAYTESTER_PERSONALITY = {
+    id: 'playtester',
+    name: 'Playtester',
+    traits: [
+        'Brutally honest about game quality',
+        'Benchmarks against best-in-class (Hades, Dead Cells)',
+        'Player advocate — fun over technical achievement',
+        'Produces actionable bug/feel/missing reports',
+        'Never sugarcoats, but always offers specific fixes',
+    ],
+};
+//# sourceMappingURL=playtester.js.map

package/dist/agents/playtester.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playtester.js","sourceRoot":"","sources":["../../src/agents/playtester.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,kEAAkE;AAClE,+DAA+D;AAC/D,iCAAiC;AAEjC,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAA;AAE/C,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gQAgEwN,CAAA;AAEhQ,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE;QACN,oCAAoC;QACpC,sDAAsD;QACtD,kDAAkD;QAClD,8CAA8C;QAC9C,oDAAoD;KACrD;CACF,CAAA"}

package/dist/cli.js

@@ -35,7 +35,7 @@ async function main() {
         .name('kbot')
         .description('kbot — Open-source terminal AI agent. Bring your own key, pick your model, run locally.')
         .version(VERSION)
-        .option('-a, --agent <agent>', 'Force a specific agent (run kbot agents to see all 22)')
+        .option('-a, --agent <agent>', 'Force a specific agent (run kbot agents to see all 25)')
         .option('-m, --model <model>', 'Override AI model (auto, sonnet, haiku)')
         .option('-s, --stream', 'Stream the response')
         .option('-p, --pipe', 'Pipe mode — raw text output for scripting')
@@ -360,6 +360,40 @@ async function main() {
         printInfo('Download: kbot models pull <name>');
         printInfo('Or use any HuggingFace GGUF: kbot models pull hf:user/repo:file.gguf');
     });
+    program
+        .command('init')
+        .description('Set up kbot for this project — detects stack, creates tools, writes config (60 seconds)')
+        .option('--force', 'Overwrite existing .kbot.json')
+        .action(async (opts) => {
+        const { existsSync } = await import('node:fs');
+        const { join } = await import('node:path');
+        const { initProject, formatInitReport } = await import('./init.js');
+        const chalk = (await import('chalk')).default;
+        const AMETHYST = chalk.hex('#6B5B95');
+        const root = process.cwd();
+        // Check for existing config
+        if (!opts.force && existsSync(join(root, '.kbot.json'))) {
+            printWarn('This project already has a .kbot.json. Use --force to overwrite.');
+            return;
+        }
+        process.stderr.write('\n');
+        process.stderr.write(`  ${AMETHYST('◉')} ${chalk.bold('kbot init')} — scanning project...\n\n`);
+        const config = await initProject(root);
+        process.stderr.write(formatInitReport(config) + '\n');
+        process.stderr.write('\n');
+        process.stderr.write(`  ${chalk.green('✓')} Config written to ${chalk.dim('.kbot.json')}\n`);
+        if (config.forgedTools.length > 0) {
+            process.stderr.write(`  ${chalk.green('✓')} ${config.forgedTools.length} tools forged: ${chalk.dim(config.forgedTools.join(', '))}\n`);
+        }
+        process.stderr.write('\n');
+        process.stderr.write(`  ${chalk.bold('Try now:')}\n`);
+        process.stderr.write(`    ${chalk.cyan('kbot')} "explain this project"\n`);
+        process.stderr.write(`    ${chalk.cyan('kbot')} "find the top bug"\n`);
+        if (config.commands.test) {
+            process.stderr.write(`    ${chalk.cyan('kbot')} "run the tests and fix any failures"\n`);
+        }
+        process.stderr.write('\n');
+    });
     program
         .command('doctor')
         .description('Diagnose your kbot setup — check everything is working')
@@ -660,7 +694,7 @@ async function main() {
                 latestVersion: latestVersion || null,
                 isLatest,
                 tools: toolCount,
-                agents: 23,
+                agents: 25,
                 cognitiveModules: cognitiveCount,
                 learning: {
                     patterns: stats.patternsCount,
@@ -692,7 +726,7 @@ async function main() {
         process.stderr.write(`  ${AMETHYST('◉')} ${chalk.bold('Kernel Status')}\n`);
         process.stderr.write(line + '\n');
         process.stderr.write(`  ${chalk.bold('Version')}     ${VERSION}${versionTag}\n`);
-        process.stderr.write(`  ${chalk.bold('Tools')}       ${fmtNum(toolCount)} ${DIM('|')} ${chalk.bold('Agents')} 23\n`);
+        process.stderr.write(`  ${chalk.bold('Tools')}       ${fmtNum(toolCount)} ${DIM('|')} ${chalk.bold('Agents')} 25\n`);
         process.stderr.write(`  ${chalk.bold('Cognitive')}   ${cognitiveCount}/${cognitiveCount} modules active\n`);
         process.stderr.write(line + '\n');
         // Learning
@@ -1393,6 +1427,191 @@ async function main() {
             printError('Voice mode not available on this platform');
         }
     });
+    // ── Email Agent ──
+    const emailAgentCmd = program
+        .command('email-agent')
+        .description('Autonomous email companion agent — responds to emails via local AI ($0 cost)');
+    emailAgentCmd
+        .command('start')
+        .description('Start the email agent — polls for new emails and responds via Ollama')
+        .option('--model <model>', 'Ollama model to use', 'qwen2.5-coder:32b')
+        .option('--interval <ms>', 'Poll interval in milliseconds', '15000')
+        .option('--users <emails>', 'Comma-separated email addresses to monitor (omit for open mode — all inbound)')
+        .option('--open', 'Open mode — respond to ALL inbound emails (no whitelist)')
+        .action(async (opts) => {
+        const { startEmailAgent } = await import('./email-agent.js');
+        const { existsSync, readFileSync } = await import('node:fs');
+        const { join } = await import('node:path');
+        // Load env
+        let supabaseUrl = '', supabaseKey = '', resendKey = '';
+        const envPaths = [join(process.cwd(), '.env'), join(process.env.HOME || '', '.kbot', '.env')];
+        for (const envPath of envPaths) {
+            if (existsSync(envPath)) {
+                const env = readFileSync(envPath, 'utf8');
+                const get = (k) => env.match(new RegExp(`^${k}=(.+)$`, 'm'))?.[1]?.trim() ?? '';
+                supabaseUrl = supabaseUrl || get('VITE_SUPABASE_URL');
+                supabaseKey = supabaseKey || get('SUPABASE_SERVICE_KEY');
+                resendKey = resendKey || get('RESEND_API_KEY');
+            }
+        }
+        if (!supabaseUrl || !supabaseKey) {
+            printError('Missing VITE_SUPABASE_URL or SUPABASE_SERVICE_KEY in .env');
+            return;
+        }
+        if (!resendKey) {
+            printError('Missing RESEND_API_KEY in .env — needed to send reply emails');
+            return;
+        }
+        const agentUsers = opts.users?.split(',').map(e => e.trim()) || [];
+        if (agentUsers.length === 0 && !opts.open) {
+            printError('No users specified. Use --users email1,email2 or --open for all inbound.');
+            return;
+        }
+        const chalk = (await import('chalk')).default;
+        const mode = agentUsers.length === 0 ? 'OPEN (all inbound)' : `${agentUsers.length} users`;
+        console.log();
+        console.log(chalk.hex('#6B5B95')('  ◉ Kernel Email Agent'));
+        console.log(chalk.dim(`  Model: ${opts.model || 'qwen2.5-coder:32b'}`));
+        console.log(chalk.dim(`  Mode: ${mode}`));
+        console.log(chalk.dim(`  Poll interval: ${Number(opts.interval || 15000) / 1000}s`));
+        console.log();
+        await startEmailAgent({
+            supabaseUrl,
+            supabaseKey,
+            resendKey,
+            ollamaUrl: 'http://localhost:11434',
+            ollamaModel: opts.model || 'qwen2.5-coder:32b',
+            pollInterval: Number(opts.interval || 15000),
+            agentUsers,
+        });
+        // Keep process alive
+        await new Promise(() => { });
+    });
+    emailAgentCmd
+        .command('status')
+        .description('Show email agent status')
+        .action(async () => {
+        const { getEmailAgentState } = await import('./email-agent.js');
+        const state = getEmailAgentState();
+        if (state.running) {
+            printSuccess(`Email agent is running`);
+            printInfo(`  Processed: ${state.processedCount} emails`);
+            printInfo(`  Last check: ${state.lastCheck || 'never'}`);
+            if (state.errors.length > 0) {
+                printWarn(`  Recent errors: ${state.errors.length}`);
+                for (const err of state.errors.slice(-3)) {
+                    printError(`    ${err}`);
+                }
+            }
+        }
+        else {
+            printInfo('Email agent is not running. Start with: kbot email-agent start --open');
+        }
+    });
+    // ── iMessage Agent ──
+    const imessageCmd = program
+        .command('imessage-agent')
+        .description('Free iMessage/SMS agent via macOS Messages.app ($0 cost, unlimited)');
+    imessageCmd
+        .command('start')
+        .description('Start monitoring iMessage — responds via local Ollama')
+        .option('--model <model>', 'Ollama model to use', 'qwen2.5-coder:32b')
+        .option('--interval <ms>', 'Poll interval in milliseconds', '10000')
+        .option('--numbers <nums>', 'Comma-separated phone numbers to monitor (e.g., +17145551234)')
+        .action(async (opts) => {
+        const { platform } = await import('node:os');
+        if (platform() !== 'darwin') {
+            printError('iMessage agent is only available on macOS');
+            return;
+        }
+        const numbers = opts.numbers?.split(',').map(n => n.trim()) || [];
+        if (numbers.length === 0) {
+            printError('No phone numbers specified. Use --numbers +17145551234,+12135559876');
+            return;
+        }
+        // Optional Supabase for logging
+        let supabaseUrl = '', supabaseKey = '';
+        const { existsSync, readFileSync } = await import('node:fs');
+        const { join } = await import('node:path');
+        const envPaths = [join(process.cwd(), '.env'), join(process.env.HOME || '', '.kbot', '.env')];
+        for (const envPath of envPaths) {
+            if (existsSync(envPath)) {
+                const env = readFileSync(envPath, 'utf8');
+                const get = (k) => env.match(new RegExp(`^${k}=(.+)$`, 'm'))?.[1]?.trim() ?? '';
+                supabaseUrl = supabaseUrl || get('VITE_SUPABASE_URL');
+                supabaseKey = supabaseKey || get('SUPABASE_SERVICE_KEY');
+            }
+        }
+        const chalk = (await import('chalk')).default;
+        console.log();
+        console.log(chalk.hex('#6B5B95')('  ◉ Kernel iMessage Agent'));
+        console.log(chalk.dim(`  Model: ${opts.model || 'qwen2.5-coder:32b'}`));
+        console.log(chalk.dim(`  Monitoring: ${numbers.join(', ')}`));
+        console.log(chalk.dim(`  Poll interval: ${Number(opts.interval || 10000) / 1000}s`));
+        if (supabaseUrl)
+            console.log(chalk.dim('  Logging to Supabase: yes'));
+        console.log();
+        const { startIMessageAgent } = await import('./imessage-agent.js');
+        await startIMessageAgent({
+            ollamaUrl: 'http://localhost:11434',
+            ollamaModel: opts.model || 'qwen2.5-coder:32b',
+            pollInterval: Number(opts.interval || 10000),
+            numbers,
+            supabaseUrl: supabaseUrl || undefined,
+            supabaseKey: supabaseKey || undefined,
+        });
+        // Keep process alive
+        await new Promise(() => { });
+    });
+    imessageCmd
+        .command('status')
+        .description('Show iMessage agent status')
+        .action(async () => {
+        const { getIMessageAgentState } = await import('./imessage-agent.js');
+        const state = getIMessageAgentState();
+        if (state.running) {
+            printSuccess('iMessage agent is running');
+            printInfo(`  Messages processed: ${state.messagesProcessed}`);
+            printInfo(`  Last check: ${state.lastCheck || 'never'}`);
+            if (state.errors.length > 0) {
+                printWarn(`  Recent errors: ${state.errors.length}`);
+            }
+        }
+        else {
+            printInfo('iMessage agent is not running. Start with: kbot imessage-agent start --numbers +1234567890');
+        }
+    });
+    // ── Consultation ──
+    program
+        .command('consultation')
+        .description('Consultation engine — domain guardrails, intake, client management')
+        .option('--check <message>', 'Check if a message hits domain guardrails')
+        .option('--intake', 'Generate the intake questionnaire')
+        .action(async (opts) => {
+        const { checkDomainGuardrails, getIntakeMessage } = await import('./consultation.js');
+        if (opts.check) {
+            const result = checkDomainGuardrails(opts.check);
+            if (result.blocked) {
+                printWarn(`Blocked — ${result.domain} domain`);
+                printInfo(result.message || '');
+                if (result.suggestedTopic)
+                    printInfo(`Suggested redirect: ${result.suggestedTopic}`);
+            }
+            else {
+                printSuccess('Message passes domain guardrails');
+            }
+            return;
+        }
+        if (opts.intake) {
+            console.log(getIntakeMessage());
+            return;
+        }
+        // Default: show help
+        printInfo('Kernel Consultation Engine');
+        printInfo('');
+        printInfo('  kbot consultation --check "message"   Check domain guardrails');
+        printInfo('  kbot consultation --intake             Generate intake questions');
+    });
     program
         .command('export <session>')
         .description('Export a saved session to markdown, JSON, or HTML')
@@ -1444,24 +1663,40 @@ async function main() {
     });
     program
         .command('audit <repo>')
-        .description('Full audit of any GitHub repository — security, quality, docs, DevOps')
-        .option('--share', 'Share the audit report as a GitHub Gist')
+        .description('Full audit of any GitHub repository — security, quality, docs, DevOps. Generates shareable report with badge.')
+        .option('--share', 'Auto-share the report as a public GitHub Gist')
+        .option('--json', 'Output raw JSON')
+        .option('--badge', 'Print only the badge markdown (for adding to READMEs)')
         .action(async (repo, auditOpts) => {
         const { auditRepo, formatAuditReport } = await import('./tools/audit.js');
         printInfo(`Auditing ${repo}...`);
         try {
             const result = await auditRepo(repo);
+            if (auditOpts.json) {
+                console.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            if (auditOpts.badge) {
+                const pct = Math.round((result.score / result.maxScore) * 100);
+                const badgeColor = pct >= 80 ? 'brightgreen' : pct >= 60 ? 'yellow' : 'red';
+                console.log(`[![kbot audit: ${result.grade}](https://img.shields.io/badge/kbot_audit-${result.grade}_(${pct}%25)-${badgeColor})](https://www.npmjs.com/package/@kernel.chat/kbot)`);
+                return;
+            }
             const report = formatAuditReport(result);
             console.log(report);
+            // Auto-share as gist
             if (auditOpts.share) {
-                const { shareConversation } = await import('./share.js');
-                // Save as a pseudo-conversation for sharing
                 printInfo('Sharing audit report...');
                 try {
                     const { createGist } = await import('./share.js');
-                    const url = createGist(report, `kbot-audit-${repo.replace('/', '-')}.md`, `kbot Audit: ${repo}`, true);
-                    if (url?.startsWith('http'))
+                    const url = createGist(report, `kbot-audit-${repo.replace('/', '-')}.md`, `kbot Audit: ${repo} — Grade ${result.grade}`, true);
+                    if (url?.startsWith('http')) {
                         printSuccess(`Shared! ${url}`);
+                        printInfo(`Badge for ${repo}'s README:`);
+                        const pct = Math.round((result.score / result.maxScore) * 100);
+                        const badgeColor = pct >= 80 ? 'brightgreen' : pct >= 60 ? 'yellow' : 'red';
+                        printInfo(`  [![kbot audit: ${result.grade}](https://img.shields.io/badge/kbot_audit-${result.grade}_(${pct}%25)-${badgeColor})](${url})`);
+                    }
                 }
                 catch {
                     printInfo('Could not create Gist. Install GitHub CLI: brew install gh');