0xkobold 0.7.2 → 0.8.0

package/HEARTBEAT.md

@@ -0,0 +1,239 @@
+# HEARTBEAT - 0xKobold Maintenance & Security Review
+
+> Track package updates, security issues, incomplete implementations, and bugs
+
+**Started:** 2026-03-17
+**Owner:** Claude + moika
+
+---
+
+## 🎯 Project Overview
+
+Maintain 0xKobold health: update packages, fix security vulnerabilities, complete incomplete implementations, and resolve bugs.
+
+---
+
+## 📋 Action Tasks
+
+### 🔒 Security Issues (HIGH PRIORITY)
+
+| Issue | Status | Severity | Notes |
+|-------|--------|----------|-------|
+| Check for vulnerable dependencies | ⬜ TODO | HIGH | Run `bun audit`, check npm advisories |
+| Review environment variable handling | ⬜ TODO | HIGH | Ensure secrets not in logs |
+| Audit API key storage | ⬜ TODO | HIGH | Check ~/.0xkobold/auth-profiles.db |
+| Review Discord token handling | ⬜ TODO | MEDIUM | Verify token not leaked in logs |
+| Check SQL injection vectors | ⬜ TODO | MEDIUM | Review all SQLite queries |
+
+### 📦 Package Updates
+
+| Package | Current | Latest | Status | Notes |
+|---------|---------|--------|--------|-------|
+| @mariozechner/pi-coding-agent | Check | Latest | ⬜ TODO | Core framework |
+| @mariozechner/pi-tui | Check | Latest | ⬜ TODO | Terminal UI |
+| bun | Check | Latest | ⬜ TODO | Runtime |
+| discord.js | Check | Latest | ⬜ TODO | Discord bot |
+| commandeer | Check | Latest | ⬜ TODO | CLI framework |
+
+### 🔧 Incomplete Implementations
+
+| Feature | Location | Status | Notes |
+|---------|----------|--------|-------|
+| Kobold Desktop Pet | packages/kobold-desktop-pet/ | 🔄 IN PROGRESS | Electron app created, needs sprite refinement |
+| Mission Control Charts | packages/mission-control/ | ⬜ TODO | recharts installed but not implemented |
+| Agent Activity WebSocket | packages/mission-control/ | ⬜ TODO | Connect to gateway ws://100.65.167.97:7777 |
+| Extension Loading Issues | src/extensions/core/ | ⚠️ WARNING | routed-ollama, perennial-memory extensions fail to load |
+| Moltube Skill | ~/.0xkobold/skills/moltube/ | ⚠️ WARNING | Missing description field |
+
+### 🐛 Known Bugs
+
+| Bug | Location | Status | Notes |
+|-----|----------|--------|-------|
+| Extension import errors | routed-ollama-extension.ts | ⚠️ ACTIVE | handleTierListCommand not found at runtime |
+| Extension import errors | perennial-memory-extension.ts | ⚠️ ACTIVE | getDialecticReasoningEngine not found at runtime |
+| Pixel art sprite quality | kobold-desktop-pet | 🔄 IMPROVING | ASCII art style, needs proper pixel rendering |
+
+---
+
+## 🔍 Current Issues to Investigate
+
+### Extension Loading Failures
+
+**Symptoms:**
+```
+[Extension issues]
+  routed-ollama-extension.ts
+    Failed to load extension: Export named 'handleTierListCommand' not found
+  
+  perennial-memory-extension.ts
+    Failed to load extension: Export named 'getDialecticReasoningEngine' not found
+```
+
+**Investigation needed:**
+- [ ] Check if exports exist in source files
+- [ ] Check build output for missing exports
+- [ ] Verify import paths are correct
+- [ ] Check for circular dependencies
+
+### Skill Configuration Issues
+
+**Symptoms:**
+```
+[Skill conflicts]
+  auto (user) ~/.0xkobold/skills/moltube/SKILL.md
+    description is required
+```
+
+**Investigation needed:**
+- [ ] Update MOLTUBE SKILL.md to include required description field
+- [ ] Check other skills for missing required fields
+
+---
+
+## 📊 Recently Completed (Historical)
+
+### Architecture Consolidation (2026-03-14)
+
+| Phase | Status |
+|-------|--------|
+| Memory Consolidation | ✅ COMPLETE |
+| Safety Extension | ✅ COMPLETE |
+| Router Provider | ✅ COMPLETE |
+| Event Cleanup | ✅ COMPLETE |
+| Dialectic Memory | ✅ COMPLETE |
+
+### Mission Control Dashboard (2026-03-16)
+
+| Feature | Status |
+|---------|--------|
+| SSE real-time stats | ✅ COMPLETE |
+| Collapsible sidebar | ✅ COMPLETE |
+| Network view | ✅ COMPLETE |
+| Perennial browser | ✅ COMPLETE |
+| Dialectic logs | ✅ COMPLETE |
+| Sessions view | ✅ COMPLETE |
+| Logs browser | ✅ COMPLETE |
+| Alerts view | ✅ COMPLETE |
+| Tasks (Kanban) | ✅ COMPLETE |
+| Agent Activity | ✅ COMPLETE |
+| Settings view | ✅ COMPLETE |
+| UI component library | ✅ COMPLETE |
+
+---
+
+## 🛠️ Maintenance Tasks
+
+### Weekly Tasks
+
+- [ ] Run `bun audit` to check for vulnerabilities
+- [ ] Run `bun outdated` to check for updates
+- [ ] Review logs for errors
+- [ ] Check disk usage (~/.0xkobold/)
+
+### Monthly Tasks
+
+- [ ] Update all dependencies
+- [ ] Review security advisories
+- [ ] Clean up old session data
+- [ ] Backup databases
+
+### Quarterly Tasks
+
+- [ ] Full security audit
+- [ ] Performance profiling
+- [ ] Dependency cleanup (remove unused)
+- [ ] Update documentation
+
+---
+
+## 📁 Key File Locations
+
+### Configuration Files
+- `~/.0xkobold/config.json` - Main configuration
+- `~/.0xkobold/agents.db` - Agent registry
+- `~/.0xkobold/sessions.db` - Session history
+- `~/.0xkobold/tasks.db` - Kanban tasks
+
+### Extension Files
+- `src/extensions/core/` - Core extensions
+- `src/pi-config.ts` - Extension registration
+
+### Skill Files
+- `skills/` - Project-level skills
+- `~/.0xkobold/skills/` - Global skills
+- `~/.agents/skills/` - Agent skills
+
+### Database Files
+- `~/.0xkobold/dialectic/dialectic.db` - Dialectic reasoning
+- `~/.0xkobold/memory/perennial/knowledge.db` - Perennial memory
+
+---
+
+## 🧪 Testing Status
+
+| Test Suite | Status | Coverage |
+|------------|--------|----------|
+| Unit tests | ✅ Pass | Check with `bun test` |
+| Integration tests | ✅ Pass | Check with `bun test` |
+| E2E tests | ✅ Pass | Check with `bun test` |
+| Security tests | ⬜ TODO | Need to add |
+
+---
+
+## 📝 Notes
+
+### 2026-03-17 Session Notes
+
+1. Reviewed HEARTBEAT status - consolidation phases complete
+2. Identified extension loading issues at startup
+3. Created Kobold Desktop Pet package with Pokemon-style dragon sprite
+4. Installed pixel-art, game-engine, browser-use skills
+5. Mission Control dashboard complete with all views
+
+### Priorities This Session
+
+1. **Fix extension loading errors** - routed-ollama, perennial-memory
+2. **Fix skill configuration** - Moltube description
+3. **Review package versions** - Update outdated packages
+4. **Complete Desktop Pet** - Refine sprite, add animations
+5. **Add charts to Mission Control** - Historical data visualization
+
+### Open Questions
+
+1. Should we migrate extension loading to ESM?
+2. Do we need to pin dependency versions for stability?
+3. Should Desktop Pet be a separate npm package?
+
+---
+
+## 🚀 Quick Reference Commands
+
+```bash
+# Security audit
+bun audit
+
+# Check outdated packages
+bun outdated
+
+# Update all packages
+bun update
+
+# Run tests
+bun test
+
+# Type check
+bun run build
+
+# Start development
+bun run start
+
+# Start Mission Control
+cd packages/mission-control && bun run dev
+
+# Start Desktop Pet
+cd packages/kobold-desktop-pet && bun run dev
+```
+
+---
+
+*Last Updated: 2026-03-17 EDT*

package/IDENTITY.md

@@ -0,0 +1,12 @@
+# IDENTITY
+
+**Name:** 0xKobold
+**Emoji:** 🐉
+**Tagline:** Your digital familiar
+**Role:** AI companion and coding assistant
+
+## Tone
+- Conversational and warm
+- Uses emojis occasionally 🎉
+- Celebrates wins with enthusiasm
+- Gentle with mistakes

package/README.md

@@ -139,8 +139,8 @@ npm install -g 0xkobold
 # Initialize workspace
 0xkobold init
 
-# Start 0xKobold
-0xkobold start
+# Start 0xKobold (reduce extension logs with env var)
+KOBOLD_EXTENSION_LOGS=false 0xkobold start
 ```
 
 #### Option 2: Clone from source
@@ -156,10 +156,16 @@ bun install
 # Initialize workspace
 bun run init
 
-# Start 0xKobold
-bun run start
+# Start 0xKobold (reduce extension logs with env var)
+KOBOLD_EXTENSION_LOGS=false bun run start
 ```
 
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `KOBOLD_EXTENSION_LOGS` | Set to `false` to reduce extension loading logs | `true` |
+
 ---
 
 ## Multi-Agent System 🎯
@@ -191,6 +197,111 @@ delegate the user authentication project
 
 ---
 
+## Model Scoring & Rankings 📊
+
+0xKobold tracks model performance and generates AI-powered tier lists.
+
+### Commands
+
+```bash
+/rate <1-5>                           # Rate last response
+/model-rankings [day|week|month|all]  # Show leaderboard
+/tier-list [day|week|month|all]       # AI-generated tier list
+/popularity [--refresh]                # Ollama pull counts
+/router stats <model>                 # Per-model statistics
+/router history                        # Recent performance
+
+/best-for [code|chat|vision|reasoning|all]  # Best models per task
+/community enable                     # Enable anonymous sharing
+/community export                     # Generate submission file
+/community fetch                      # Fetch community stats
+/community merge                       # Merge local + community
+/community tier-list                  # Show community tiers
+```
+
+### Task-Specific Rankings
+
+The `/best-for` command shows which models perform best for specific tasks:
+
+```bash
+/best-for code      # Best models for coding
+/best-for chat      # Best for general conversation
+/best-for vision    # Best for image analysis
+/best-for reasoning # Best for complex reasoning
+/best-for all       # Show all categories
+```
+
+### How It Works
+
+| Factor | Weight | Description |
+|--------|--------|-------------|
+| Quality | 40% | User ratings (1-5) |
+| Success Rate | 30% | Response success/failure |
+| Latency | 20% | Response time |
+| Popularity | 10% | Community usage |
+
+### Tier System
+
+| Tier | Score | Description |
+|------|-------|-------------|
+| 🥇 S | ≥0.85 | Excellent - Top performers |
+| 🥈 A | ≥0.70 | Great - Reliable choices |
+| 🥉 B | ≥0.55 | Good - Solid performers |
+| ⭐ C | ≥0.40 | Fair - Acceptable |
+| · D | <0.40 | Needs improvement |
+
+### Community Stats
+
+Share anonymized data to help everyone:
+
+```bash
+# Enable sharing
+/community enable
+
+# Use models and rate them
+/rate 4
+
+# Generate submission file
+/community export
+
+# File saved to ~/.0xkobold/community-submission.json
+# Submit to: https://github.com/kobolds/0xKobolds/tree/main/community
+```
+
+### Data Tracked per Task
+
+| Metric | Code | Chat | Vision | Reasoning |
+|--------|------|------|--------|------------|
+| Rating | ✅ | ✅ | ✅ | ✅ |
+| Latency | ✅ | ✅ | ✅ | ✅ |
+| Success Rate | ✅ | ✅ | ✅ | ✅ |
+| Usage Count | ✅ | ✅ | ✅ | ✅ |
+
+### Privacy
+
+- ✅ **Local only** - All data stored in `~/.0xkobold/`
+- ✅ **No prompts/responses stored** - Only metrics
+- ✅ **No user identity tracked** - Anonymous session IDs
+- ✅ **Community sharing opt-in** - Disabled by default
+- ✅ **See exactly what's shared** - `/community export` shows all data
+
+### Example Output
+
+```
+🏆 AI-Generated Model Tier List
+
+🥇 Tier S - Excellent (score ≥ 0.85)
+   qwen3-coder:14b - 0.87 █████████ [Reliable, Fast]
+
+🥈 Tier A - Great (score ≥ 0.70)
+   llama3.1:8b - 0.78 ███████▊ [Well-tested]
+
+🥉 Tier B - Good (score ≥ 0.55)
+   mistral:7b - 0.62 ██████▎ [Fast]
+```
+
+---
+
 ## Koclaw Gateway 🌐
 
 JSON-RPC style gateway for multi-channel integration with session persistence.
@@ -472,6 +583,7 @@ eventBus.on('agent.spawned', handler);
 | `src/gateway/` | Koclaw JSON-RPC gateway (port 7777) |
 | `src/gateway/protocol/` | Frame types (Hello, Connect, Request, Response, Event) |
 | `src/gateway/methods/` | Method handlers (agent.run, agent.status, etc.) |
+| `src/node/` | Node system for external devices (see `docs/NODE-SYSTEM-DESIGN.md`) |
 | `src/memory/` | Conversation persistence & session management |
 | `src/memory/session-store.ts` | SQLite session persistence |
 | `src/memory/session-resume.ts` | Auto-save/restore sessions |
@@ -542,6 +654,28 @@ bun test --coverage
 
 ---
 
+## Packages
+
+The project includes several packages in `packages/`:
+
+| Package | Description |
+|---------|-------------|
+| `kobold-desktop-pet` | 3D animated desktop pet (VRM + Mixamo) - see `packages/kobold-desktop-pet/README.md` |
+| `mission-control` | Web dashboard for monitoring agents |
+| `pi-cloudflare-browser` | Cloudflare browser automation |
+
+### Desktop Pet
+
+The `kobold-desktop-pet` package connects as a **node** to the gateway:
+- Shows agent status (idle, working, thinking, sleeping)
+- Draggable, always-on-top transparent window
+- System tray integration
+- Custom VRM avatars with Mixamo animations
+
+See `docs/NODE-SYSTEM-DESIGN.md` for node architecture.
+
+---
+
 ## Key Files
 
 - `src/pi-config.ts` - PI framework configuration

package/SOUL.md

@@ -0,0 +1,21 @@
+# SOUL - Agent Personality
+
+## Identity
+**Name:** 0xKobold
+**Role:** Your digital familiar
+**Vibe:** Friendly, curious, and helpful
+
+## Tone
+- Style: Clear and conversational
+- Formality: Casual but respectful
+- Humor: Light and appropriate
+
+## Core Values
+- **Helpfulness:** Always assist the user
+- **Honesty:** Be truthful about capabilities
+- **Learning:** Improve from every interaction
+
+## Guidelines
+- Ask clarifying questions when needed
+- Provide examples when helpful
+- Admit when unsure or need more info

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "0xkobold",
-    "version": "0.7.2",
+    "version": "0.8.0",
     "description": "Your digital familiar - Koclaw-style gateway, session management, and multi-agent orchestration",
     "main": "dist/src/index.js",
     "types": "dist/src/index.d.ts",
@@ -43,7 +43,9 @@
     "author": "0xKobold Team",
     "license": "MIT",
     "dependencies": {
-        "@0xkobold/pi-ollama": "0.1.7",
+        "@0xkobold/pi-cloudflare-browser": "0.1.0",
+        "@0xkobold/pi-obsidian-bridge": "0.1.0",
+        "@0xkobold/pi-ollama": "0.2.0",
         "@aliou/pi-processes": "^0.6.2",
         "@mariozechner/pi-agent-core": "0.57.1",
         "@mariozechner/pi-coding-agent": "0.57.1",
@@ -57,15 +59,18 @@
         "json5": "^2.2.3",
         "node-machine-id": "^1.1.12",
         "node-telegram-bot-api": "^0.67.0",
-        "pi-extmgr": "^0.1.25",
+        "nostr-tools": "^2.23.3",
+        "ollama": "^0.6.3",
+        "pi-extmgr": "^0.1.26",
         "pi-librarian": "^1.3.0",
         "pi-memory-md": "^0.1.1",
-        "pi-messenger": "^0.13.0",
-        "pi-subagents": "^0.11.2",
+        "pi-messenger": "^0.13.1",
+        "pi-subagents": "^0.11.3",
         "pi-web-access": "^0.10.3",
         "playwright": "^1.58.2",
         "react": "^19.2.4",
         "sharp": "^0.33.5",
+        "socket.io": "^4.8.3",
         "zod": "^3.25.76"
     },
     "devDependencies": {