@kernel.chat/kbot 2.12.0 → 2.13.1

package/README.md

@@ -1,6 +1,6 @@
 <p align="center">
   <strong>K:BOT</strong><br>
-  Open-source terminal AI agent. 39 specialists, 167 tools, 19 providers, local-first.
+  Open-source terminal AI agent. 39 specialists, 167 tools, 19 providers, local-first. The first CLI agent that evolves its own source code.
 </p>
 
 <p align="center">
@@ -15,7 +15,9 @@
 - **19 providers, zero lock-in** — Claude, GPT, Gemini, Mistral, Grok, DeepSeek, SambaNova, Cerebras, OpenRouter, and more
 - **Runs fully offline** — `kbot local` for $0 local AI, no data leaves your machine
 - **Learns your patterns** — remembers what worked, gets faster over time
-- **37 specialist agents** — auto-routes to the right expert for each task
+- **39 specialist agents** — auto-routes to the right expert for each task
+- **Self-evolving** — diagnoses its own weaknesses and improves its own code (`/evolve`)
+- **Shell completions** — tab completion for bash, zsh, and fish (`kbot completions zsh`)
 - **MCP server built in** — plug kbot into any IDE as a tool provider
 
 ## Quick Start
@@ -34,6 +36,14 @@ kbot local
 kbot
 ```
 
+## What's New in v2.13.0
+
+- **Self-evolution engine** — K:BOT diagnoses weaknesses, proposes code changes, validates them (typecheck + tests), and applies improvements automatically (`/evolve`)
+- **Shell completions** — Tab completion for bash, zsh, fish (`kbot completions zsh >> ~/.zshrc`)
+- **Interactive tutorial** — Step-by-step walkthrough for new users (`/tutorial`)
+- **Changelog generator** — Auto-generate release notes from git history (`kbot changelog`)
+- **Doctor diagnostics** — 10-point health check for your setup (`kbot doctor`)
+
 ## One-Shot Mode
 
 ```bash
@@ -43,18 +53,19 @@ kbot "deploy to production"
 kbot -p "generate a migration for user roles" > migration.sql
 ```
 
-## Specialists (37)
+## Specialists (39)
 
 Auto-routed or manual with `kbot --agent <name>`:
 
 **Core**: kernel, researcher, coder, writer, analyst
 **Extended**: aesthete, guardian, curator, strategist, infrastructure, quant, investigator, oracle, chronist, sage, communicator, adapter
 **Domain**: physicist, mathematician, biologist, economist, psychologist, engineer, medic, linguist, ethicist, educator, diplomat
+**Creative**: creative, developer, hacker, operator, dreamer
 **Systems**: session, scholar, auditor, benchmarker, synthesizer, debugger
 
 ## Features
 
-- **60+ Tools** — File ops, bash, git, GitHub, web search, Jupyter, Docker sandbox, browser, MCP client
+- **167 Tools** — File ops, bash, git, GitHub, web search, Jupyter, Docker sandbox, browser, MCP client
 - **Local-First** — File reads, git, grep run instantly without an API call
 - **Learning Engine** — Patterns, solutions, and user preferences cached across sessions
 - **Mimic Matrix** — Code like Claude Code, Cursor, Copilot, Next.js, React, Rust, Python
@@ -109,7 +120,7 @@ Works with Claude Code, Cursor, VS Code, Windsurf, Zed, Neovim. Exposes 14 tools
 kbot serve --port 7437 --token mysecret
 ```
 
-REST API exposing all 60+ tools for any LLM or automation pipeline.
+REST API exposing all 167 tools for any LLM or automation pipeline.
 
 ## Commands
 
@@ -136,7 +147,7 @@ REST API exposing all 60+ tools for any LLM or automation pipeline.
 
 ## Web Companion
 
-[kernel.chat](https://kernel.chat) — same 37 agents with a visual interface. Free (20 msgs/day).
+[kernel.chat](https://kernel.chat) — same 39 agents with a visual interface. Free (20 msgs/day).
 
 ## Links
 

package/dist/changelog.d.ts

@@ -0,0 +1,21 @@
+export interface ChangelogOptions {
+    /** Git ref to start from (default: last tag or last 20 commits) */
+    since?: string;
+    /** Output format — 'markdown' for release notes, 'terminal' for CLI display */
+    format?: 'markdown' | 'terminal';
+}
+/**
+ * Generate a changelog from git history.
+ *
+ * Groups commits by conventional commit prefix and formats them
+ * as either markdown (for release notes / piping) or terminal
+ * (colored output for the REPL).
+ */
+export declare function generateChangelog(options?: ChangelogOptions): string;
+/**
+ * Format a markdown changelog string for colored terminal output.
+ * Use this to colorize changelog text that was already generated
+ * in markdown format.
+ */
+export declare function formatChangelogTerminal(changelog: string): string;
+//# sourceMappingURL=changelog.d.ts.map

package/dist/changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../src/changelog.ts"],"names":[],"mappings":"AA8GA,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+EAA+E;IAC/E,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,CAAA;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CA2BpE;AA4ED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAqBjE"}

package/dist/changelog.js

@@ -0,0 +1,204 @@
+// K:BOT Changelog Generator — Auto-generate release notes from git history
+//
+// Usage:
+//   import { generateChangelog, formatChangelogTerminal } from './changelog.js'
+//   const md = generateChangelog({ since: 'v2.11.0', format: 'markdown' })
+//   const colored = formatChangelogTerminal(md)
+//
+// CLI:
+//   $ kbot changelog              # Markdown to stdout (pipeable)
+//   $ kbot changelog --since v2.11.0
+//   REPL: /changelog              # Colored terminal output
+import { execSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import chalk from 'chalk';
+const CATEGORY_MAP = {
+    'feat': 'Features',
+    'fix': 'Bug Fixes',
+    'perf': 'Performance',
+    'refactor': 'Refactoring',
+    'test': 'Tests',
+    'docs': 'Documentation',
+    'chore': 'Maintenance',
+};
+const CATEGORY_ORDER = [
+    'Features',
+    'Bug Fixes',
+    'Performance',
+    'Refactoring',
+    'Tests',
+    'Documentation',
+    'Maintenance',
+    'Other Changes',
+];
+// ── Git helpers ──
+function getLastTag() {
+    try {
+        return execSync('git describe --tags --abbrev=0', {
+            cwd: process.cwd(),
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+function getCommits(since) {
+    const range = since ? `${since}..HEAD` : '';
+    const limit = since ? '' : '-20';
+    const format = '%h %s'; // short hash + subject
+    const cmd = `git log ${range} ${limit} --format="${format}"`.replace(/\s+/g, ' ').trim();
+    let output;
+    try {
+        output = execSync(cmd, {
+            cwd: process.cwd(),
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return [];
+    }
+    if (!output)
+        return [];
+    return output.split('\n').map(line => {
+        const spaceIdx = line.indexOf(' ');
+        const hash = line.slice(0, spaceIdx);
+        const subject = line.slice(spaceIdx + 1);
+        const category = categorize(subject);
+        return { hash, subject, category };
+    });
+}
+function categorize(subject) {
+    const match = subject.match(/^(\w+)(?:\(.+?\))?:\s/);
+    if (match) {
+        const prefix = match[1].toLowerCase();
+        return CATEGORY_MAP[prefix] || 'Other Changes';
+    }
+    return 'Other Changes';
+}
+function getVersion() {
+    try {
+        const pkgPath = join(process.cwd(), 'package.json');
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        return pkg.version || 'unreleased';
+    }
+    catch {
+        return 'unreleased';
+    }
+}
+/**
+ * Generate a changelog from git history.
+ *
+ * Groups commits by conventional commit prefix and formats them
+ * as either markdown (for release notes / piping) or terminal
+ * (colored output for the REPL).
+ */
+export function generateChangelog(options) {
+    const format = options?.format || 'markdown';
+    const since = options?.since || getLastTag() || undefined;
+    const commits = getCommits(since);
+    if (commits.length === 0) {
+        return format === 'terminal'
+            ? 'No commits found.'
+            : '> No commits found.\n';
+    }
+    // Group by category
+    const groups = {};
+    for (const commit of commits) {
+        if (!groups[commit.category])
+            groups[commit.category] = [];
+        groups[commit.category].push(commit);
+    }
+    const version = getVersion();
+    const date = new Date().toISOString().slice(0, 10);
+    const sinceLabel = since ? ` (since ${since})` : '';
+    if (format === 'terminal') {
+        return buildTerminalChangelog(version, date, sinceLabel, groups);
+    }
+    return buildMarkdownChangelog(version, date, sinceLabel, groups);
+}
+// ── Markdown output (pipeable) ──
+function buildMarkdownChangelog(version, date, sinceLabel, groups) {
+    const lines = [];
+    lines.push(`# ${version}${sinceLabel}`);
+    lines.push('');
+    lines.push(`_${date}_`);
+    lines.push('');
+    for (const category of CATEGORY_ORDER) {
+        const entries = groups[category];
+        if (!entries || entries.length === 0)
+            continue;
+        lines.push(`## ${category}`);
+        lines.push('');
+        for (const entry of entries) {
+            // Strip the prefix from the subject for cleaner display
+            const clean = stripPrefix(entry.subject);
+            lines.push(`- ${clean} (\`${entry.hash}\`)`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ── Terminal output (colored) ──
+function buildTerminalChangelog(version, date, sinceLabel, groups) {
+    const useColor = !process.env.NO_COLOR && process.stdout.isTTY !== false;
+    const ACCENT = useColor ? chalk.hex('#A78BFA') : (s) => s;
+    const DIM = useColor ? chalk.dim : (s) => s;
+    const GREEN = useColor ? chalk.hex('#4ADE80') : (s) => s;
+    const CYAN = useColor ? chalk.hex('#67E8F9') : (s) => s;
+    const lines = [];
+    lines.push('');
+    lines.push(`  ${chalk.bold(ACCENT(`v${version}`))} ${DIM(date)}${DIM(sinceLabel)}`);
+    lines.push(`  ${DIM('─'.repeat(50))}`);
+    for (const category of CATEGORY_ORDER) {
+        const entries = groups[category];
+        if (!entries || entries.length === 0)
+            continue;
+        lines.push('');
+        lines.push(`  ${chalk.bold(category)}`);
+        for (const entry of entries) {
+            const clean = stripPrefix(entry.subject);
+            lines.push(`  ${DIM('•')} ${clean} ${CYAN(entry.hash)}`);
+        }
+    }
+    const total = Object.values(groups).reduce((sum, g) => sum + g.length, 0);
+    lines.push('');
+    lines.push(`  ${GREEN(`${total} commits`)}${DIM(sinceLabel || ' (last 20)')}`);
+    lines.push('');
+    return lines.join('\n');
+}
+// ── Formatting helpers ──
+/**
+ * Format a markdown changelog string for colored terminal output.
+ * Use this to colorize changelog text that was already generated
+ * in markdown format.
+ */
+export function formatChangelogTerminal(changelog) {
+    const useColor = !process.env.NO_COLOR && process.stdout.isTTY !== false;
+    if (!useColor)
+        return changelog;
+    const ACCENT = chalk.hex('#A78BFA');
+    const DIM = chalk.dim;
+    const CYAN = chalk.hex('#67E8F9');
+    return changelog
+        // H1 headers — version line
+        .replace(/^# (.+)$/gm, (_m, h) => `  ${chalk.bold(ACCENT(h))}`)
+        // H2 headers — category
+        .replace(/^## (.+)$/gm, (_m, h) => `\n  ${chalk.bold(h)}`)
+        // Date line (italic in markdown)
+        .replace(/^_(.+)_$/gm, (_m, d) => `  ${DIM(d)}`)
+        // Bullet points with inline code (commit hash)
+        .replace(/^- (.+?) \(`([^`]+)`\)$/gm, (_m, text, hash) => `  ${DIM('•')} ${text} ${CYAN(hash)}`)
+        // Remaining bullet points
+        .replace(/^- (.+)$/gm, (_m, t) => `  ${DIM('•')} ${t}`)
+        // Inline code
+        .replace(/`([^`]+)`/g, (_m, c) => CYAN(c));
+}
+function stripPrefix(subject) {
+    // Remove "feat(scope): " or "fix: " prefixes for cleaner display
+    return subject.replace(/^\w+(?:\(.+?\))?:\s*/, '');
+}
+//# sourceMappingURL=changelog.js.map

package/dist/changelog.js.map

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

package/dist/cli.js

@@ -20,9 +20,10 @@ import { createAgent, removeAgent, getAgent, formatAgentList, formatAgentDetail,
 import { getExtendedStats, incrementSessions, learnFact, selfTrain, getTrainingLog, flushPendingWrites } from './learning.js';
 import { banner, bannerCompact, bannerAuth, prompt as kbotPrompt, printError, printSuccess, printInfo, printResponse, printHelp, printGoodbye, setQuiet, } from './ui.js';
 import { checkForUpdate, selfUpdate } from './updater.js';
+import { runTutorial } from './tutorial.js';
 import { syncOnStartup, schedulePush, flushCloudSync, isCloudSyncEnabled, setCloudToken, getCloudToken } from './cloud-sync.js';
 import chalk from 'chalk';
-const VERSION = '2.12.0';
+const VERSION = '2.13.1';
 async function main() {
     const program = new Command();
     program
@@ -241,82 +242,11 @@ async function main() {
         .command('doctor')
         .description('Diagnose your kbot setup — check everything is working')
         .action(async () => {
+        const { runDoctor, formatDoctorReport } = await import('./doctor.js');
         process.stderr.write('\n');
         printInfo('K:BOT Doctor — Checking your setup...');
-        process.stderr.write('\n');
-        // 1. Check BYOK provider
-        const config = loadConfig();
-        if (config?.byok_enabled && config?.byok_provider) {
-            const p = PROVIDERS[config.byok_provider];
-            printSuccess(`BYOK provider: ${p?.name || config.byok_provider}`);
-        }
-        // 3. Check Ollama
-        const ollamaUp = await isOllamaRunning();
-        if (ollamaUp) {
-            const models = await listOllamaModels();
-            printSuccess(`Ollama: running (${models.length} models)`);
-            for (const m of models)
-                printInfo(`    ${m}`);
-        }
-        else {
-            printInfo('  Ollama: not running (optional — run: ollama serve)');
-        }
-        // 4. Check OpenClaw
-        try {
-            const res = await fetch('http://127.0.0.1:18789/health', { signal: AbortSignal.timeout(2000) });
-            if (res.ok) {
-                printSuccess('OpenClaw: gateway running at 127.0.0.1:18789');
-            }
-            else {
-                printInfo('  OpenClaw: gateway not responding (optional)');
-            }
-        }
-        catch {
-            printInfo('  OpenClaw: gateway offline (optional — run: openclaw-cmd start)');
-        }
-        // 5. Check Docker (for sandbox tools)
-        try {
-            const { execSync } = await import('node:child_process');
-            execSync('docker info', { timeout: 5000, stdio: 'pipe' });
-            printSuccess('Docker: running (sandbox execution available)');
-        }
-        catch {
-            printInfo('  Docker: not running (optional — needed for sandbox_run)');
-        }
-        // 6. Check git
-        try {
-            const { execSync } = await import('node:child_process');
-            const ver = execSync('git --version', { encoding: 'utf-8', timeout: 3000 }).trim();
-            printSuccess(`Git: ${ver}`);
-        }
-        catch {
-            printError('Git: not found (needed for git tools)');
-        }
-        // 7. Check Node.js version
-        printSuccess(`Node.js: ${process.version}`);
-        // 8. Check config directory
-        const { existsSync } = await import('node:fs');
-        const { homedir } = await import('node:os');
-        const { join } = await import('node:path');
-        const kbotDir = join(homedir(), '.kbot');
-        if (existsSync(kbotDir)) {
-            printSuccess(`Config: ${kbotDir}`);
-        }
-        else {
-            printInfo(`  Config directory will be created at: ${kbotDir}`);
-        }
-        process.stderr.write('\n');
-        // Summary
-        const hasProvider = !!((config?.byok_enabled && config?.byok_provider) || ollamaUp);
-        if (hasProvider) {
-            printSuccess('Ready to go! Run: kbot');
-        }
-        else {
-            printInfo('Get started with one of:');
-            printInfo('  kbot local    — Free local AI');
-            printInfo('  kbot byok      — Use your own API key');
-        }
-        process.stderr.write('\n');
+        const report = await runDoctor();
+        process.stderr.write(formatDoctorReport(report));
     });
     program
         .command('pull')
@@ -549,6 +479,28 @@ async function main() {
             }
         }
     });
+    program
+        .command('changelog')
+        .description('Generate a changelog from git history (outputs markdown to stdout)')
+        .option('--since <ref>', 'Git ref to start from (tag, commit, branch)')
+        .action(async (changelogOpts) => {
+        const { generateChangelog } = await import('./changelog.js');
+        const md = generateChangelog({ since: changelogOpts.since, format: 'markdown' });
+        process.stdout.write(md);
+    });
+    program
+        .command('completions')
+        .description('Generate shell tab-completion script (bash, zsh, fish)')
+        .argument('<shell>', 'Shell type: bash, zsh, or fish')
+        .action(async (shell) => {
+        const validShells = ['bash', 'zsh', 'fish'];
+        if (!validShells.includes(shell)) {
+            printError(`Unknown shell: ${shell}. Use: bash, zsh, or fish`);
+            process.exit(1);
+        }
+        const { generateCompletions } = await import('./completions.js');
+        process.stdout.write(generateCompletions(shell));
+    });
     program.parse(process.argv);
     const opts = program.opts();
     const promptArgs = program.args;
@@ -556,7 +508,7 @@ async function main() {
     if (opts.quiet)
         setQuiet(true);
     // If a sub-command was run, we're done
-    if (['byok', 'auth', 'ide', 'local', 'ollama', 'openclaw', 'pull', 'doctor', 'serve', 'agents', 'watch', 'voice', 'export', 'plugins'].includes(program.args[0]))
+    if (['byok', 'auth', 'ide', 'local', 'ollama', 'openclaw', 'pull', 'doctor', 'serve', 'agents', 'watch', 'voice', 'export', 'plugins', 'changelog', 'completions'].includes(program.args[0]))
         return;
     // Check for API key (BYOK or local provider)
     let byokActive = isByokEnabled();
@@ -1316,44 +1268,7 @@ async function handleSlashCommand(input, opts, rl) {
             printHelp();
             break;
         case 'tutorial': {
-            console.log();
-            console.log(chalk.bold('  Let\'s build something together. Pick a track:'));
-            console.log();
-            console.log(`  ${chalk.bold('1.')} ${chalk.hex('#4ADE80')('Build a website')}     — Create an HTML page from scratch`);
-            console.log(`  ${chalk.bold('2.')} ${chalk.hex('#60A5FA')('Fix a bug')}           — Find and fix a problem in code`);
-            console.log(`  ${chalk.bold('3.')} ${chalk.hex('#FB923C')('Write a script')}      — Automate something with Python or JavaScript`);
-            console.log(`  ${chalk.bold('4.')} ${chalk.hex('#F472B6')('Research a topic')}    — Deep-dive into any subject`);
-            console.log(`  ${chalk.bold('5.')} ${chalk.hex('#A78BFA')('Explore this project')} — Understand the code in this folder`);
-            console.log();
-            console.log(chalk.dim('  Pick a number, or just type what you want to build.'));
-            console.log();
-            const tutorialInput = await new Promise((resolve) => {
-                rl.question('  Your choice: ', (answer) => resolve(answer.trim()));
-            });
-            const tutorialPrompts = {
-                '1': 'Create a simple, beautiful HTML page with a heading, a paragraph about me, and some CSS styling. Save it as index.html. Walk me through what each part does.',
-                '2': 'Look at the files in this directory. Find any issues, bugs, or things that could be improved. Explain what you found and fix the most important one.',
-                '3': 'Write a short script that lists all files in the current directory, sorted by size. Use the language that makes the most sense for this project. Explain each line.',
-                '4': 'I want to understand how AI agents work. Research this topic and explain it simply — what are agents, how do they think, and what tools do they use? Give real examples.',
-                '5': 'Explore this project directory. What language is it written in? What does it do? What are the most important files? Give me a quick tour.',
-            };
-            const prompt = tutorialPrompts[tutorialInput] || tutorialInput;
-            if (prompt) {
-                console.log();
-                printInfo('Great choice! Let me work on that...');
-                console.log();
-                try {
-                    const response = await runAgent(prompt, opts);
-                    if (!response.streamed) {
-                        printResponse(response.agent, response.content);
-                    }
-                    console.log();
-                    printInfo(chalk.dim('That\'s the basics! Keep asking questions — I learn from every conversation.'));
-                }
-                catch (err) {
-                    printError(err instanceof Error ? err.message : String(err));
-                }
-            }
+            await runTutorial(rl);
             break;
         }
         case 'agent':
@@ -1952,6 +1867,13 @@ async function handleSlashCommand(input, opts, rl) {
             }
             break;
         }
+        case 'changelog': {
+            const { generateChangelog } = await import('./changelog.js');
+            const since = args[0] || undefined;
+            const output = generateChangelog({ since, format: 'terminal' });
+            console.log(output);
+            break;
+        }
         case 'local':
         case 'ollama': {
             if (args[0] === 'off') {
@@ -2164,6 +2086,13 @@ async function handleSlashCommand(input, opts, rl) {
             console.log(formatRateLimitStatus());
             break;
         }
+        case 'doctor': {
+            const { runDoctor, formatDoctorReport } = await import('./doctor.js');
+            printInfo('Running diagnostics...');
+            const doctorReport = await runDoctor();
+            process.stderr.write(formatDoctorReport(doctorReport));
+            break;
+        }
         case 'quit':
         case 'exit':
             rl.close();