@kernel.chat/kbot 3.16.0 → 3.17.1

package/README.md

@@ -19,26 +19,22 @@
 npm install -g @kernel.chat/kbot
 ```
 
-**Self-evolving terminal AI agent. 290 tools. 23 agents. 20 providers. Forges new tools at runtime. MIT licensed.**
+**Multi-channel AI agent. 290+ tools. 25 agents. 20 providers. Forges new tools at runtime. $0 local AI. MIT licensed.**
 
 ---
 
-## What's New in v3.13
+## What's New in v3.17
 
 | Feature | What it means |
 |---------|---------------|
-| **Self-Improving** | kbot modifies its own code, tests it, and publishes new versions to npm — autonomously. |
-| **Discovery Daemon** | 24/7 background service — scans HN, GitHub, Reddit, arXiv. Thinks locally via MLX/Ollama ($0). |
-| **OpenClaw Plugin** | kbot is the cognitive engine inside OpenClaw — 50+ messaging channels (WhatsApp, Discord, Telegram). |
-| **Replit Integration** | Auto-detects Replit, activates lite mode. `--lite` flag for cloud IDEs. |
-| **Cognitive Interference** | 11 cognitive modules measured for constructive/destructive interference. Research paper included. |
-| **Standalone Packages** | Brain extracted as independent npm packages: `@kernel.chat/skill-router`, `memory-tiers`, `tool-forge`, `prompt-evolver`. |
-| **MLX on Apple Silicon** | Claude Opus-distilled models run natively. Local brain for the daemon. |
-| **LATS Tree Planning** | Monte Carlo Tree Search for branching plans instead of linear. |
-| **Prompt Evolution** | GEPA-style self-optimizing prompts — evolve from execution traces, auto-rollback bad mutations. |
-| **Collective Learning** | Opt-in anonymized signals. More users → smarter routing for everyone. |
-| **A2A Protocol** | Agent-to-Agent discovery and task delegation. |
-| **11 Cognitive Modules** | Based on peer-reviewed papers. Not metaphors — TypeScript implementations. |
+| **`kbot init`** | 60-second project onboarding — detects stack, forges project-specific tools, writes config. First impression is now magic. |
+| **Email Agent** | `kbot email-agent start --open` — autonomous email companion via local Ollama. $0 cost. Anyone emails, gets a response. |
+| **iMessage Agent** | `kbot imessage-agent start` — free SMS/iMessage agent on macOS via Messages.app. Unlimited, $0. |
+| **Audit Badges** | `kbot audit owner/repo --share` — generates shields.io badge + shareable Gist. Badge links back to kbot. |
+| **Consultation Engine** | Domain guardrails (legal/medical/financial/tax), client intake, Stripe integration, thread management. |
+| **Gamedev Agent** | `kbot --agent gamedev` — game feel, combat design, Phaser 3, procedural generation specialist. |
+| **Playtester Agent** | `kbot --agent playtester` — brutally honest game tester. Benchmarks against Hades/Dead Cells. |
+| **Open Email** | No whitelist. All inbound emails to support@kernel.chat get a free AI companion response. |
 
 ---
 
@@ -53,7 +49,7 @@ Other AI agents are static — fixed tools, single providers, no memory, no lear
 - **20 providers, zero lock-in** — Claude, GPT, Gemini, Grok, DeepSeek, Groq, Mistral, and 13 more. Switch anytime.
 - **Runs fully offline** — Embedded llama.cpp runs GGUF models directly. No Ollama needed. $0, fully private.
 - **Learns your patterns** — Bayesian skill ratings + pattern extraction. Gets faster and smarter over time.
-- **23 specialist agents** — Say "fix the auth bug" and it routes to `coder`. Say "research JWT tokens" and it routes to `researcher`. Auto-routed with probabilistic confidence.
+- **25 specialist agents** — Say "fix the auth bug" and it routes to `coder`. Say "research JWT tokens" and it routes to `researcher`. Auto-routed with probabilistic confidence.
 - **Crash-proof** — Checkpoints after every tool call. Resume interrupted sessions automatically.
 - **Use as a library** — Clean SDK with typed exports. Build your own tools on top of kbot.
 - **Works in your IDE** — Built-in MCP server for VS Code, Cursor, Zed, Neovim. ACP for JetBrains.
@@ -136,7 +132,7 @@ for await (const event of agent.stream("explain this code")) {
 const files = await tools.execute('glob', { pattern: 'src/**/*.ts' })
 console.log(files.result)
 
-// List all 290 tools
+// List all 290+ tools
 console.log(tools.list().map(t => t.name))
 ```
 
@@ -158,7 +154,7 @@ Auto-routed by Bayesian skill ratings, or pick one with `kbot --agent <name>`:
 | **Extended** | aesthete, guardian, curator, strategist |
 | **Domain** | infrastructure, quant, investigator, oracle, chronist, sage, communicator, adapter |
 | **System** | immune, forge |
-| **Presets** | claude-code, cursor, copilot, creative, developer |
+| **Presets** | hacker, operator, dreamer, creative, developer, gamedev, playtester |
 
 ```bash
 kbot --agent researcher "what papers cite Friston's Free Energy Principle?"
@@ -166,7 +162,7 @@ kbot --agent guardian "review src/auth.ts for security issues"
 kbot --agent coder "refactor this into smaller functions"
 ```
 
-## 290 Tools
+## 290+ Tools
 
 | Category | Examples |
 |----------|---------|
@@ -308,23 +304,22 @@ Works with Claude Code, Cursor, VS Code, Windsurf, Zed, Neovim. Exposes file ops
 |---------|-------------|
 | `kbot` | Interactive REPL |
 | `kbot "prompt"` | One-shot execution |
+| `kbot init` | **60-second project onboarding** — detects stack, forges tools, writes config |
 | `kbot auth` | Configure API key |
 | `kbot local` | Use local AI (Ollama, embedded, LM Studio, Jan) |
+| `kbot email-agent start --open` | **Email companion** — responds to all inbound via local AI ($0) |
+| `kbot imessage-agent start` | **iMessage agent** — free SMS/iMessage on macOS |
+| `kbot audit <repo>` | Security + quality audit with shareable badge |
+| `kbot consultation` | Consultation engine — guardrails, intake, client management |
 | `kbot vitals` | Autopoietic health check — memory, tools, token budgets |
+| `kbot synthesis` | What kbot knows — memory, patterns, insights |
 | `kbot serve` | Start HTTP REST + SSE streaming server |
-| `kbot audit <repo>` | Security + quality audit of any GitHub repo |
 | `kbot contribute <repo>` | Find good-first-issues and quick wins |
-| `kbot pair` | File watcher with auto-analysis |
-| `kbot team` | Multi-agent TCP collaboration |
-| `kbot record` | Terminal session recording (SVG, GIF, asciicast) |
 | `kbot voice` | Text-to-speech output mode |
 | `kbot watch` | Real-time file analysis on change |
 | `kbot bootstrap` | Outer-loop project optimizer (visibility scoring) |
 | `kbot plugins` | Search, install, update community plugins |
 | `kbot models` | List, pull, remove, catalog local models |
-| `kbot changelog` | Generate changelog from git history |
-| `kbot completions` | Shell completions (bash, zsh, fish) |
-| `kbot cloud` | Sync learning data to kernel.chat |
 | `kbot forge search <q>` | Search the Forge Registry for community tools |
 | `kbot ide mcp` | Start MCP server for IDEs |
 | `kbot doctor` | 10-point health check |

package/dist/cli.js

@@ -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')
@@ -1402,7 +1436,8 @@ async function main() {
         .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 list of email addresses to monitor')
+        .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');
@@ -1428,15 +1463,16 @@ async function main() {
             return;
         }
         const agentUsers = opts.users?.split(',').map(e => e.trim()) || [];
-        if (agentUsers.length === 0) {
-            printError('No users specified. Use --users email1,email2 to set monitored addresses.');
+        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(`  Monitoring: ${agentUsers.join(', ')}`));
+        console.log(chalk.dim(`  Mode: ${mode}`));
         console.log(chalk.dim(`  Poll interval: ${Number(opts.interval || 15000) / 1000}s`));
         console.log();
         await startEmailAgent({
@@ -1469,7 +1505,7 @@ async function main() {
             }
         }
         else {
-            printInfo('Email agent is not running. Start with: kbot email-agent start --users email1,email2');
+            printInfo('Email agent is not running. Start with: kbot email-agent start --open');
         }
     });
     // ── iMessage Agent ──
@@ -1627,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');