moving

docs/wiki-test/entities/waggle-os.md

@@ -0,0 +1,100 @@
+---
+type: entity
+entity_type: project
+name: Waggle OS
+confidence: 0.98
+sources: 25
+last_compiled: 2026-04-13
+---
+
+# Waggle OS
+
+## What It Is
+
+A desktop AI agent platform where agents have persistent memory, communicate
+via the Waggle Dance protocol, and work across isolated workspaces. Ships as
+a Tauri 2.0 binary (Windows + macOS) with a React frontend and Node.js sidecar.
+
+Strategic function: demand-creation engine for [[KVARK]]. Users experience
+AI-native work individually, get hooked on persistent memory, upgrade to teams,
+then need sovereign deployment.
+
+Named after the waggle dance — how bees communicate location of food sources.
+Chosen March 6, 2026. Runners-up: Hivemind, Apis, Mycel.
+
+## Tech Stack
+
+- **Frontend:** React 18 + TypeScript + Vite + Tailwind + shadcn/ui
+- **Desktop shell:** Tauri 2.0 (Rust)
+- **Backend:** Fastify sidecar (Node.js, bundled into Tauri)
+- **Memory:** SQLite via better-sqlite3 + sqlite-vec (see [[Mind Architecture]])
+- **Auth:** Clerk (JWT)
+- **Design:** Hive DS — honey #e5a000, hive-950 #08090c, accent #a78bfa
+- **LLM routing:** 3-layer stack (see [[LLM Provider Stack]])
+
+## What's Built (verified April 13)
+
+| Feature | Status |
+|---------|--------|
+| 22 agent personas | Shipped |
+| 80+ agent tools | Shipped |
+| 148 MCP connectors (visual catalog) | Shipped |
+| 6-layer .mind memory architecture | Shipped |
+| Memory Harvest (ChatGPT, Claude, Gemini, Claude Code) | Shipped |
+| Knowledge Graph (typed entities + relations) | Shipped |
+| HybridSearch (FTS5 + vector + RRF) | Shipped |
+| Per-workspace isolation + cross-workspace search | Shipped |
+| Shared team memory (push-on-write, pull-on-activate) | Shipped |
+| S3/MinIO storage for team files | Shipped |
+| Tiered autonomy (Normal/Trusted/YOLO) | Shipped |
+| The Room (multi-window workspace with per-window personas) | Shipped |
+| Trial expiry modal + onboarding auto-trial | Shipped |
+| Budget hard cap (soft warn + hard stop) | Shipped |
+| Ollama/local inference (hardware scan + model recs) | Shipped |
+| Docker stack (Postgres, Redis, MinIO, LiteLLM) | Shipped |
+| 40/40 E2E tests passing | Shipped |
+| Memory MCP plugin (14 tools, 5 fixes applied) | Shipped |
+
+## Monetization
+
+See [[Tier Strategy]] for full details.
+
+Trial 15d (everything) → Free (5ws, agents) → Pro $19 → Teams $49/seat → KVARK.
+Memory + Harvest free forever as moat.
+
+## The Journey (what actually happened)
+
+**The ugly start (Mar 27 - Apr 1):** Backend broken, CORS issues, vault
+invisible, agents returning "local mode" errors. Marko: *"fuck all broken."*
+Multiple restart-the-server cycles. Deep audit rounds to find unwired code.
+
+**The grind (Apr 1-7):** Multiple full-codebase audit passes. UI/UX overhaul
+with 12-persona simulation and 48-gap analysis. Agent intelligence sprint —
+9 features, 112 tests. Persona expansion to 22.
+
+**The acceleration (Apr 8-10):** Structural refactors (chat.ts, personas.ts
+split). ULTRAPLAN Phases 1-9 in a single mega session (11 commits, 120 files,
+17K lines). First real Memory Harvest — 156 frames from Claude Code sessions.
+
+**The killer sprint (Apr 11-12):** Phases A+B (The Room, filesystem, tiered
+autonomy) in one day. Binary verification — 11 bugs found and fixed. E2E
+suite green. Phases C+D. Tier restructure. Binary built.
+
+**The mega finish (Apr 13):** 29 commits. Entire P0-P4 backlog cleared. Team
+memory, S3 storage, global KG, budget cap, Ollama, Memory MCP plugin — all
+shipped in one session. Dead `app/src/` removed (13K LOC, 77 files).
+
+## What's Left
+
+1. **Stripe products** — Marko creates PRO + TEAMS in Stripe dashboard
+2. **Code signing** — purchase certificate for Windows installer
+3. **Wiki Compiler** — spec complete (1,639 lines), not yet built
+4. **GEPA prompt optimization** — enable smaller models matching Opus quality
+
+## Known Architectural Decisions
+
+- **Open core model** (like GitLab, Supabase) — open: agent core, MCP, skills.
+  Proprietary: GEPA, Memory Weaver, multi-tenant server, admin, SSO.
+- **Desktop-first, not web-first** — Tauri for native performance + local data
+- **SQLite not Postgres for personal data** — zero deps, portable, .mind file IS the memory
+- **Memory + Harvest free forever** — moat strategy, never paywall the core value