From 5eb507d144d9be2364b01e10d17e1049fe22ecec Mon Sep 17 00:00:00 2001 From: Mickael Farina Date: Sun, 3 May 2026 23:06:24 +0200 Subject: [PATCH] docs: sync README + FEATURES.md to single source of truth MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Reviewer flagged numerical inconsistency between README and FEATURES.md. Audit confirmed: - FEATURES.md was internally inconsistent: header line said "337 features · 73 skills · 1023 tests" but Summary table totalled "367 features · 74 skills · 1023 tests" - README badges + body cited stale pre-Phase-3 numbers (60 skills, 405 tests, 75+ endpoints, v2.1 engine, 50+ MCP skills) - Some claims were under-counts vs ground truth (260+ features, 53.3K LOC, 60+ files, 10+ services, 22 test files) This commit aligns BOTH docs to verified ground truth as of 2026-05-03: Canonical fact set: 367 features (FEATURES.md per-section sum, structural) 74 skills (`ls skills/*.py` excluding __init__, tracked) 940+ tests (947 currently collected; "+" leaves headroom) 58K+ LOC (production code only, excluding tests/) 135+ API endpoints (@router decorators in routes/ + dashboard) 15 PM2 services (`name:` entries in ecosystem.config.js) 230+ Python files (production tree, no tests/scratch/docs) 53 test files (`ls tests/test_*.py`) CODEC v2.3 (current engine version) README changes (10 lines): - 4 badges (features/skills/tests/lines) - "v2.1" → "v2.3" in product brand callout - 3 occurrences of "60 skills" → "74 skills" (Core row, body, screenshot) - "75+ API endpoints" → "135+" (Dashboard intro, file table) - "50+ pluggable" → "74" (MCP section) - "60+ files" → "230+" (Cursor row) - "60 built-in skills" → "74", "405 tests" → "940+" (file tree, contrib) - "10+ services" → "15" (file tree) - "405 pytest tests across 22 files" → "940+ across 53 files" FEATURES.md changes (2 lines): - Line 3 header: 337 → 367 features, 73 → 74 skills, 1023 → 940+ tests, "53K+ lines of code" → "58K+ lines of production code" - Line 506 summary: same fact-set alignment No prose, structure, or framing changed. Pure number sync — same speech across both files. Note: skills/file_write.py is untracked in main; tracked count is 74. A separate task tracks deciding whether to commit or remove it. Co-Authored-By: Claude Opus 4.7 (1M context) --- FEATURES.md | 4 ++-- README.md | 32 ++++++++++++++++---------------- 2 files changed, 18 insertions(+), 18 deletions(-) diff --git a/FEATURES.md b/FEATURES.md index 7e1b37c..f2d4889 100644 --- a/FEATURES.md +++ b/FEATURES.md @@ -1,6 +1,6 @@ # Sovereign AI Workstation — Full Product Breakdown -> Engine: **CODEC v2.3** — 337 features · 73 skills · 1023 tests · 53K+ lines of code +> Engine: **CODEC v2.3** — 367 features · 74 skills · 940+ tests · 58K+ lines of production code The product name is **Sovereign AI Workstation**. Throughout this document and the codebase, **CODEC** refers to the underlying open-source engine / @@ -504,7 +504,7 @@ notification dispatch. | 13. Phase 3.5 — UX Polish + Proactive Overlay *(v2.3)* | 24 | | **TOTAL** | **367** | -**367 features · 74 skills · 1023 tests · 53K+ lines of code** +**367 features · 74 skills · 940+ tests · 58K+ lines of production code** ### What's new in v2.3 — Phase 1 + 2 + 3 + 3.5 diff --git a/README.md b/README.md index e8980a4..88da21a 100644 --- a/README.md +++ b/README.md @@ -10,10 +10,10 @@

- 260+ Features - 73 Skills - 1023 Tests - 53,300 Lines + 367+ Features + 74 Skills + 940+ Tests + 58K+ Lines MIT License Engine: CODEC v2.3

@@ -38,7 +38,7 @@ It listens, sees the screen, speaks back, controls apps, writes code, drafts mes No cloud dependency. No data leaving the machine unless you choose. No subscription on the open-source build. MIT licensed. -> **Sovereign AI Workstation** is the product brand. **CODEC** (v2.1) is the open-source engine that powers it — the codename you'll see in code paths, skill registries, the `codec_*` PM2 services, and the `~/.codec/` config directory. *Sovereign AI Workstation* is what you ship; *CODEC* is what you ship with. Same way iPhone runs on Darwin, or Tesla Model S runs on Roadster components — one is the product, the other is the engine. +> **Sovereign AI Workstation** is the product brand. **CODEC** (v2.3) is the open-source engine that powers it — the codename you'll see in code paths, skill registries, the `codec_*` PM2 services, and the `~/.codec/` config directory. *Sovereign AI Workstation* is what you ship; *CODEC* is what you ship with. Same way iPhone runs on Darwin, or Tesla Model S runs on Roadster components — one is the product, the other is the engine. --- @@ -46,7 +46,7 @@ No cloud dependency. No data leaving the machine unless you choose. No subscript | # | Product | What It Does | |:-:|---|---| -| 1 | **CODEC Core** | Voice command layer + vision mouse control — 60 skills, screen clicks by voice | +| 1 | **CODEC Core** | Voice command layer + vision mouse control — 74 skills, screen clicks by voice | | 2 | **CODEC Dictate** | Hold, speak, paste — hands-free F5 live typing at cursor, draft refinement, floating overlays | | 3 | **CODEC Instant** | Right-click → 8 AI services system-wide — proofread, translate, reply, explain | | 4 | **CODEC Chat** | 250K-context conversational AI + 12 autonomous agent crews | @@ -60,7 +60,7 @@ No cloud dependency. No data leaving the machine unless you choose. No subscript Always-on voice assistant. Say *"Hey CODEC"* or press F13 to activate. F18 for voice commands. F16 for text input. -60 skills fire instantly: Google Calendar, Gmail, Drive, Docs, Sheets, Tasks, Keep, Chrome automation, web search, Hue lights, timers, Spotify, clipboard, terminal commands, PM2 control, and more. Most skills bypass the LLM entirely — direct action, zero latency. Skills are matched by trigger specificity — longer, more specific triggers always win over generic ones. +74 skills fire instantly: Google Calendar, Gmail, Drive, Docs, Sheets, Tasks, Keep, Chrome automation, web search, Hue lights, timers, Spotify, clipboard, terminal commands, PM2 control, and more. Most skills bypass the LLM entirely — direct action, zero latency. Skills are matched by trigger specificity — longer, more specific triggers always win over generic ones. **Vision Mouse Control — See & Click** @@ -137,7 +137,7 @@ Full transcript saved to memory. Every conversation becomes searchable context f ### 7. CODEC Overview — Dashboard, Cortex & Audit -Private dashboard accessible from any device, anywhere. Cloudflare Tunnel or Tailscale VPN — no port forwarding, no third-party relay. 75+ API endpoints. Send commands, view the screen, launch voice calls, manage agents — all from a browser. Installable as a PWA on mobile and desktop. +Private dashboard accessible from any device, anywhere. Cloudflare Tunnel or Tailscale VPN — no port forwarding, no third-party relay. 135+ API endpoints. Send commands, view the screen, launch voice calls, manage agents — all from a browser. Installable as a PWA on mobile and desktop. **Cortex — System Nerve Center** Visual command center showing all 7 CODEC products in an interactive grid. Neural network SVG map, real-time activity feed, searchable skills panel, and detailed event log viewer. The single-pane-of-glass view of the entire system. @@ -216,7 +216,7 @@ Three smart agents ship built-in: Daily Briefing, Restaurant Decider (location-a

Terminal
- 60 skills loaded at startup + 74 skills loaded at startup

Cortex Neural Map
@@ -366,7 +366,7 @@ Claude Desktop/Code/Cursor gain — through this one MCP bridge — everything C - **Your Mac, your apps** — native macOS control: mouse/keyboard via vision model, screenshot text extraction, app switching, clipboard, brightness/volume, Philips Hue, Spotify, Apple Notes, Reminders, Clock timers, music. No browser sandbox. - **Your memory** — FTS5-searchable history of every CODEC conversation. Claude can recall what *you* said weeks ago, not just this chat. -- **Your skills, not Anthropic's** — 50+ pluggable CODEC skills instantly callable as tools. Write one locally in Python, it shows up in Claude without a deploy. +- **Your skills, not Anthropic's** — 74 pluggable CODEC skills instantly callable as tools. Write one locally in Python, it shows up in Claude without a deploy. - **Your LLM, your choice** — same skill catalog works whether the brain is local Qwen (offline, private) or cloud Claude. The toolkit outlives the model. - **Your voice pipeline** — Whisper STT, Kokoro TTS, wake-word — all reachable from the chat loop if you want voice output of a Claude answer. @@ -381,7 +381,7 @@ One install. Claude stops being a chat window and becomes a driver for the machi | Tool | How it helps | |---|---| | **[Claude Code](https://claude.ai/claude-code)** | Terminal AI — reads the full codebase, runs commands, fixes errors in context | -| **[Cursor](https://cursor.com)** | AI IDE — navigate CODEC's 60+ files, refactor, debug with full project awareness | +| **[Cursor](https://cursor.com)** | AI IDE — navigate CODEC's 230+ files, refactor, debug with full project awareness | | **[Windsurf](https://windsurf.ai)** | AI IDE — strong at multi-file reasoning | | **[Antigravity](https://antigravity.dev)** | AI debugging assistant — paste errors, get fixes with codebase context | @@ -550,7 +550,7 @@ codec_agent.py — LLM session builder codec_agents.py — Multi-agent crew framework (12 crews, 7 tools) codec_voice.py — WebSocket voice pipeline (reconnect, heartbeat) codec_voice.html — Voice call UI -codec_dashboard.py — Web API + dashboard (75+ endpoints) +codec_dashboard.py — Web API + dashboard (135+ endpoints across routes/) codec_dashboard.html — Dashboard UI (Flash Chat, History, Audit, Settings, Stats, Skills) codec_chat.html — Chat UI (agents, file upload, voice input) codec_vibe.html — Vibe Code IDE (Monaco + Skill Forge) @@ -572,12 +572,12 @@ codec_marketplace.py — Skill marketplace CLI codec_overlays.py — AppKit overlay notifications (fullscreen compatible) ax_bridge/ — Swift AX accessibility bridge swift-overlay/ — Native macOS status bar app (NSPanel, event JSONL poller) -skills/ — 60 built-in skills (incl. vision mouse control) -tests/ — 405 pytest tests across 22 files +skills/ — 74 built-in skills (incl. vision mouse control) +tests/ — 940+ pytest tests across 53 files request_mic.py — macOS microphone permission helper (AVFoundation) install.sh — One-line installer setup_codec.py — Setup wizard (9 steps) -ecosystem.config.js — PM2 process management (10+ services) +ecosystem.config.js — PM2 process management (15 services) ``` --- @@ -633,7 +633,7 @@ python3 setup_codec.py ## Contributing -All skill contributions welcome. 60 built-in skills, 405 tests, marketplace growing. +All skill contributions welcome. 74 built-in skills, 940+ tests, marketplace growing. ```bash git clone https://github.com/AVADSA25/codec.git