fivocell 1.0.4 → 2.0.0

package/README.md

@@ -1,505 +1,697 @@
-# FIVO Cell
-
-<div align="center">
-
-**Your coding taste. Learned once. Applied everywhere. Forever free.**
-
-[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
-[![Platform](https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg)](#)
-[![Version](https://img.shields.io/badge/Version-1.0.0-purple.svg)](#)
-
-`🌍 Local-First` • `🆓 Free Forever` • `🔗 5+ AI Surfaces`
-
----
-
-</div>
-
-Every AI tool you use has amnesia. Claude doesn't remember what you taught Cursor. Copilot never learned from the fix you made in Windsurf. You repeat yourself. You reject the same patterns. You waste hours context-switching between tools that share nothing.
-
-**This is the last time you'll explain yourself to a machine.**
-
-Cell is a daemon that lives on your machine. It watches how you edit AI-generated code — across every tool — and builds a mathematical model of your taste. Then it injects that taste back into every AI you use.
-
-**One profile. Every surface. Zero config.**
-
-```
-          ┌──────────┐
-          │  VS Code  │──┐
-          └──────────┘  │
-          ┌──────────┐  │     ┌──────────────────┐
-          │  Cursor   │──┤     │                  │
-          └──────────┘  │     │   CELL DAEMON    │   Your taste,
-          ┌──────────┐  ├────►│   (localhost)    │──► everywhere.
-          │ Windsurf │──┤     │                  │
-          └──────────┘  │     │  0 cloud deps    │
-          ┌──────────┐  │     └──────────────────┘
-          │  Claude   │──┤
-          └──────────┘  │
-          ┌──────────┐  │
-          │  Codex    │──┤
-          └──────────┘  │
-          ┌──────────┐  │
-          │ Terminal  │──┤
-          └──────────┘  │
-          ┌──────────┐  │
-          │  Copilot  │──┘
-          └──────────┘
-```
-
----
-
-## Quick Install
-
-```bash
-npm i -g fivocell
-cell init
-cell daemon start
-```
-
-**Three commands. Thirty seconds. Done.**
-
-```bash
-cell status    # Verify it's working
-```
-
----
-
-## 5-Minute Quickstart
-
-```bash
-# 1. Initialize Cell in any project
-cd my-project
-cell init
-
-# 2. Start the daemon (background service)
-cell daemon start
-
-# 3. Learn from a code edit
-cell learn --file src/app.ts --diff "const x=1 → const x = 1"
-
-# 4. See your taste profile
-cell status
-
-# 5. Get recommendations
-cell community
-
-# 6. Predict your next action
-cell next
-
-# 7. Check privacy settings
-cell privacy
-```
-
----
-
-## The 9 Intelligence Chapters
-
-Cell's brain is organized into 9 intelligence layers. Each layer runs independently and persists to its own JSON file in `~/.fivo/cell/`.
-
-### Chapter 2 — Learning Layer
-
-The foundation. Watches 4 signals from every AI tool:
-
-| Signal | Trigger | Weight |
-|--------|---------|--------|
-| **Edit Diff** | You changed what AI wrote | High |
-| **Reject** | You deleted AI output entirely | High |
-| **Retry** | You asked AI to regenerate | Medium |
-| **Accept** | You kept it as-is | Low |
-
-Includes: Validator, Classifier, ConfidenceEngine, QualityEngine, LifecycleTracker, RelationshipEngine, PatternSearch, RankingEngine.
-
-```
-Commands: cell init, cell status, cell taste show, cell taste reset, cell learn
-```
-
-### Chapter 3 — Outcome Engine
-
-Tracks what happens AFTER your code ships. 7 event types (deploy, review, test, bug, perf, security, rollback) with 3-factor confidence scoring, 4-value trend analysis, 5-factor health assessment, and 6-category leaderboard.
-
-```
-No CLI commands — accessed via daemon API at /api/outcomes
-```
-
-### Chapter 4 — Recommendation Engine V2
-
-5-factor scoring (pattern strength, recency, contextual relevance, team consensus, outcome validation) with diversity enforcement, evidence-based reasons, and cold-start handling.
-
-```
-Commands: cell community (community priors feed into recommendations)
-```
-
-### Chapter 5 — Project DNA
-
-Filesystem scanner that profiles any repository in 40-200ms. 10 profiling systems: stack detection, framework detection, style detection, test patterns, dependency patterns, architecture patterns, config patterns, language stats, file tree, git patterns. Fingerprint comparison for similarity scoring.
-
-```
-No CLI commands — accessed via daemon API at /api/project-dna
-```
-
-### Chapter 6 — Knowledge Graph V2
-
-11 edge types (imports, calls, extends, implements, defines, uses, configures, tests, documents, deploys, monitors) across 10 subsystems. Path discovery with weighted traversal and influence scoring.
-
-```
-No CLI commands — accessed via daemon API at /api/knowledge-graph
-```
-
-### Chapter 7 — Community Intelligence
-
-10 systems: privacy guard (14 allowed fields only), rankings, trends (hour/day/week), clusters, playbooks, benchmarks, reputation, insights. Aggregates patterns from 5000+ simulated developers.
-
-```
-Commands: cell community, cell community-live, cell community-full
-```
-
-### Chapter 8 — Organization Intelligence
-
-10 systems: org isolation, team profiles, knowledge silos, bus factor, risk assessment, playbooks, executive insights, benchmarks. Team collaboration tools with voting and conflict resolution.
-
-```
-Commands: cell push, cell pull, cell vote, cell silos, cell review, cell standup, cell handoff
-```
-
-### Chapter 9 — Cross-Layer Intelligence
-
-10 systems: unified context builder, 7-dimension intelligence score, evidence fusion engine, knowledge gap detector, opportunity finder, risk analyzer, lifecycle classifier, decision generator, multi-level benchmarker, report generator.
-
-```
-No CLI commands — accessed via daemon API at /api/cross-layer
-```
-
----
-
-## CLI Commands Reference (42 Commands)
-
-### Learning & Profile
-
-| Command | Description |
-|---------|-------------|
-| `cell init` | Initialize Cell in current project |
-| `cell status` | Show taste profile summary |
-| `cell taste show` | Display cell.md taste profile |
-| `cell taste reset` | Reset all learned patterns |
-| `cell learn --file --diff` | Feed a code edit for learning |
-
-### Team Collaboration
-
-| Command | Description |
-|---------|-------------|
-| `cell push` | Push taste to team directory |
-| `cell pull` | Pull team or member taste |
-| `cell vote` | Vote on pattern conflict |
-| `cell handoff` | Generate teammate handoff summary |
-| `cell silos` | Detect knowledge silos |
-| `cell review` | Generate PR review summary |
-| `cell standup` | Generate daily standup |
-
-### Predictions
-
-| Command | Description |
-|---------|-------------|
-| `cell next` | Predict next coding action |
-| `cell branch` | Pre-generate files from branch name |
-| `cell gentests` | Generate test cases for a function |
-| `cell errors` | Predict potential errors in code |
-| `cell buildcheck` | Predict build failures |
-| `cell mergecheck` | Predict merge conflicts |
-| `cell scan` | Scan code for security vulnerabilities |
-| `cell perf` | Analyze code for performance issues |
-
-### Community
-
-| Command | Description |
-|---------|-------------|
-| `cell community` | Show community prior patterns |
-| `cell community-live` | Show live community stats |
-| `cell community-full` | Show full community dashboard |
-
-### Code Health
-
-| Command | Description |
-|---------|-------------|
-| `cell deadcode` | Detect dead code in a file |
-| `cell cycles` | Detect circular dependencies |
-| `cell dupes` | Detect code duplication |
-| `cell complexity` | Analyze code complexity |
-| `cell deps` | Check dependency health |
-
-### Utilities
-
-| Command | Description |
-|---------|-------------|
-| `cell snapshot` | Capture or restore project context |
-| `cell sync` | Sync patterns across projects |
-| `cell solutions` | Search solution index |
-| `cell langswitch` | Get language switch guide |
-| `cell resume` | Check for interruption and resume |
-| `cell offline` | Check offline queue status |
-| `cell abtest` | Run A/B test |
-| `cell xdomain` | Cross-domain projections (research) |
-
-### Infrastructure
-
-| Command | Description |
-|---------|-------------|
-| `cell daemon start` | Start background daemon |
-| `cell daemon stop` | Stop background daemon |
-| `cell daemon restart` | Restart daemon |
-| `cell daemon status` | Check daemon status |
-| `cell cloud on` | Enable cloud sync |
-| `cell cloud off` | Disable cloud sync |
-| `cell cloud status` | Show cloud sync status |
-| `cell privacy` | Show privacy settings |
-
----
-
-## MCP Server
-
-Cell includes a Model Context Protocol (MCP) server that exposes the full intelligence engine to any MCP-compatible client (Claude Code, Codex CLI, Cursor, etc.).
-
-### 25 Tools
-
-| Tool | Description |
-|------|-------------|
-| `cell_learn` | Learn from a code edit |
-| `cell_predict_next` | Predict next coding action |
-| `cell_predict_errors` | Predict errors in code |
-| `cell_predict_build` | Predict build failures |
-| `cell_predict_merge` | Predict merge conflicts |
-| `cell_scan_security` | Scan for security issues |
-| `cell_analyze_perf` | Analyze performance issues |
-| `cell_generate_tests` | Generate test cases |
-| `cell_generate_branch` | Pre-generate branch files |
-| `cell_community_stats` | Get community pattern stats |
-| `cell_community_trends` | Get community trends |
-| `cell_community_playbooks` | Get community playbooks |
-| `cell_outcome_events` | Record outcome events |
-| `cell_outcome_health` | Get outcome health score |
-| `cell_outcome_leaderboard` | Get outcome leaderboard |
-| `cell_project_dna` | Build project DNA profile |
-| `cell_knowledge_graph` | Query knowledge graph |
-| `cell_knowledge_paths` | Discover knowledge paths |
-| `cell_org_profile` | Get organization profile |
-| `cell_org_silos` | Detect knowledge silos |
-| `cell_org_busfactor` | Compute bus factor |
-| `cell_cross_layer_report` | Generate intelligence report |
-| `cell_cross_layer_gaps` | Detect knowledge gaps |
-| `cell_cross_layer_opportunities` | Find opportunities |
-| `cell_cross_layer_risks` | Analyze risks |
-
-### 8 Resources
-
-- `cell://patterns` — All learned patterns
-- `cell://profile` — Developer taste profile
-- `cell://outcomes` — Outcome event history
-- `cell://community/trends` — Community trends
-- `cell://community/rankings` — Community rankings
-- `cell://org/teams` — Team profiles
-- `cell://org/benchmarks` — Organization benchmarks
-- `cell://cross-layer/report` — Full intelligence report
-
-### Setup
-
-```json
-{
-  "mcpServers": {
-    "cell": {
-      "command": "node",
-      "args": ["path/to/packages/mcp-server/dist/server.js"]
-    }
-  }
-}
-```
-
-Or via Claude Code:
-
-```bash
-claude mcp add cell -- node path/to/packages/mcp-server/dist/server.js
-```
-
----
-
-## Daemon
-
-The daemon is a REST API server on port 9876 with WebSocket streaming on port 9878.
-
-```bash
-# Start
-cell daemon start
-
-# Check status
-cell daemon status
-
-# Stop
-cell daemon stop
-```
-
-125+ API endpoints across all 9 intelligence layers.
-
----
-
-## Extensions
-
-| Tool | Type | Setup |
-|------|------|-------|
-| **VS Code** | Extension | `code --install-extension extensions/vscode/fivo-cell-0.2.0.vsix` |
-| **Cursor** | Extension | Same .vsix file |
-| **Windsurf** | Extension | Same .vsix file |
-| **Claude Code** | MCP | `claude mcp add cell -- node packages/mcp-server/dist/server.js` |
-| **Codex CLI** | MCP | `codex mcp add cell -- node packages/mcp-server/dist/server.js` |
-| **Copilot** | Sync Script | `node extensions/shell/copilot-sync.js` |
-| **Terminal** | Shell Hook | `source extensions/shell/install.sh` |
-
----
-
-## Team Mode
-
-Cell supports local-network team collaboration without any cloud dependency.
-
-```
-Developer A ──┐
-              ├── Cell Daemon (port 9876)
-Developer B ──┘     │
-                    │ LAN
-Developer C ──┐     │
-              ├─────┘
-Developer D ──┘
-```
-
-- `cell push` — Share your taste with the team
-- `cell pull` — Pull team taste profile
-- `cell vote` — Resolve pattern conflicts democratically
-- `cell handoff` — Generate context summaries for teammates
-- `cell standup` — Auto-generated daily standups
-
-Up to 10-20 developers can collaborate on a single local network.
-
----
-
-## Cloud Sync
-
-Cloud sync is **ON by default** and shares only anonymous pattern statistics:
-
-```
-"prefers const over let (87%)"
-"uses named exports, not default (83%)"
-"vitest over jest (91%)"
-```
-
-**Your source code never leaves your machine.** No file paths. No project names. No secrets.
-
-```bash
-cell cloud off    # Fully offline mode
-cell cloud on     # Re-enable sync
-cell cloud status # Check current status
-```
-
----
-
-## Privacy
-
-### Never stored or transmitted
-
-| Data | Guarantee |
-|------|-----------|
-| Your source code | Never leaves your machine. Cell only sees diffs. |
-| File paths | Never persisted or transmitted. Only file extensions. |
-| Git history | Never accessed. |
-| API keys / secrets | Detected and warned. Never captured. |
-| Identity | No email. No signup. No account. |
-| Project names | Obfuscated before any transmission. |
-
-### Stored locally only
-
-| Data | Location |
-|------|----------|
-| Pattern preferences | `~/.fivo/cell/pattern-store.json` |
-| Outcomes | `~/.fivo/cell/outcomes.json` |
-| Developer profiles | `~/.fivo/cell/profiles/` |
-| Project DNA | `~/.fivo/cell/project-dna.json` |
-| Knowledge graph | `~/.fivo/cell/knowledge-graph.json` |
-| Community intelligence | `~/.fivo/cell/community-intelligence.json` |
-| Organization intelligence | `~/.fivo/cell/org-intelligence.json` |
-| Cross-layer intelligence | `~/.fivo/cell/cross-layer-intelligence.json` |
-| Session snapshots | `~/.fivo/cell/snapshots/` |
-
----
-
-## Architecture
-
-```
-CLI (42 commands)
-  │
-  ├──► Daemon (port 9876) ──► REST API (125+ endpoints)
-  │       │                      │
-  │       ├──► WebSocket (port 9878) ──► Real-time streaming
-  │       │
-  │       └──► MCP Server (port 9877) ──► 25 tools, 8 resources
-  │
-  ├──► Intelligence Engine
-  │       ├── Learning Layer (Ch2)
-  │       ├── Outcome Engine (Ch3)
-  │       ├── Recommendation Engine (Ch4)
-  │       ├── Project DNA (Ch5)
-  │       ├── Knowledge Graph (Ch6)
-  │       ├── Community Intelligence (Ch7)
-  │       ├── Organization Intelligence (Ch8)
-  │       └── Cross-Layer Intelligence (Ch9)
-  │
-  └──► Storage (~/.fivo/cell/)
-          ├── 30+ JSON stores
-          ├── Each layer has its own file
-          └── No database required
-```
-
-Each intelligence layer:
-- Runs independently
-- Persists to its own JSON file
-- Can be reset without affecting others
-- Has 80+ hostile assertions in tests
-
----
-
-## Running Tests
-
-```bash
-# All tests
-npx jest --passWithNoTests --no-coverage
-
-# Specific chapter
-npx jest --passWithNoTests --no-coverage src/core/__tests__/chapter9-hostile.test.ts
-
-# Real-world validation
-npx ts-node src/validation/quick-run.ts
-```
-
-**772 hostile assertions across 9 chapters — all passing.**
-
----
-
-## Why Trust Cell
-
-- **Open Source. Apache 2.0.** Every line is public. Audit it. Fork it. Own it.
-- **Local-First. Always.** Zero cloud dependency. If cell.fivo.live disappears tomorrow, your taste doesn't.
-- **Free. Permanently.** Cell is supported by our community. You're not the product.
-- **Clean uninstall.** `npm uninstall -g fivocell` + `rm -rf ~/.fivo/cell`. Done.
-
----
-
-## Links
-
-| Resource | URL |
-|----------|-----|
-| Website | [cell.fivo.live](https://cell.fivo.live) |
-| Enterprise | [fivo.live](https://fivo.live) |
-| Community | [discord.gg/fivo](https://discord.gg/fivo) |
-| NPM | `npm i -g fivocell` |
-
----
-
-<div align="center">
-
-**Your taste. Every tool. Forever free.**
-
-</div>
+<div align="center">
+
+# 🧠 FIVO Cell
+
+<img src="https://img.shields.io/badge/License-Apache%202.0-blue?style=for-the-badge&logo=apache" alt="License">
+<img src="https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey?style=for-the-badge&logo=linux" alt="Platform">
+<img src="https://img.shields.io/badge/Version-2.0.0-purple?style=for-the-badge" alt="Version">
+<img src="https://img.shields.io/badge/Tests-391%20Passing-brightgreen?style=for-the-badge" alt="Tests">
+
+<br><br>
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║                                                              ║
+║   🧬  Your Coding DNA. Learned Once. Applied Everywhere.     ║
+║                                                              ║
+║   🌍 Local-First  •  🆓 Free Forever  •  🔗 5+ AI Surfaces  ║
+║   🛡️ Zero Code Leaves Machine  •  🔓 Apache 2.0            ║
+║                                                              ║
+╚══════════════════════════════════════════════════════════════╝
+```
+
+</div>
+
+---
+
+<div align="center">
+
+## 🤔 The Problem
+
+</div>
+
+<div align="center">
+
+```
+╔════════════════════════════════════════════════════════════╗
+║                                                            ║
+║   💬 "Use arrow functions"          💬 "I prefer TypeScript"║
+║   💬 "Add error handling"           💬 "Don't use any"     ║
+║   💬 "Use Zod for validation"       💬 "Named exports please"║
+║                                                            ║
+║   You repeat yourself. Every. Single. Day.                ║
+║                  To every. Single. AI tool.               ║
+║                                                            ║
+╚════════════════════════════════════════════════════════════╝
+```
+
+</div>
+
+**Every AI tool you use has amnesia.** Claude doesn't remember what you taught Cursor. Copilot never learned from the fix you made in Windsurf. Gemini starts from zero every session. You waste **hours** context-switching between tools that share absolutely nothing.
+
+> **This is the last time you'll explain yourself to a machine.**
+
+---
+
+<div align="center">
+
+## 🎯 The Solution
+
+</div>
+
+<div align="center">
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│                       🧠 CELL DAEMON                         │
+│                    Your Persistent Brain                     │
+│                                                              │
+│   ┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐    │
+│   │ VS Code │   │ Cursor  │   │ Gemini  │   │ Claude  │    │
+│   └────┬────┘   └────┬────┘   └────┬────┘   └────┬────┘    │
+│        │             │             │             │          │
+│        └─────────────┴──────┬──────┴─────────────┘          │
+│                             │                               │
+│                   ┌─────────▼─────────┐                     │
+│                   │   🧠 CELL DAEMON  │                     │
+│                   │    localhost:9876 │                     │
+│                   └─────────┬─────────┘                     │
+│                             │                               │
+│       ┌─────────────────────┼───────────────────────┐       │
+│       │                     │                       │       │
+│   ┌───▼───┐             ┌───▼───┐             ┌───▼───┐   │
+│   │ 👤 You│             │ 👥Team│             │ 🌐 All│   │
+│   │Style  │    ───►     │Shared │    ───►     │ Best  │   │
+│   │Blind  │             │Pattern│             │Practi-│   │
+│   │Spots  │             │  Bus  │             │ ces   │   │
+│   │ DNA   │             │Factor │             │Trends │   │
+│   └───────┘             └───────┘             └───────┘   │
+│                                                              │
+│        Personal Layer         Team Layer     Community Layer│
+│                                                              │
+│              🎯 One profile. Every AI tool. Zero config.    │
+└──────────────────────────────────────────────────────────────┘
+```
+
+</div>
+
+Cell is a daemon that lives on **your machine**. It watches how you edit AI-generated code — across every tool — and builds a mathematical model of your coding taste. Then it injects that taste back into every AI you use.
+
+**It's not another AI tool. It's the cognitive layer that makes every AI tool actually understand you.**
+
+---
+
+<div align="center">
+
+## ⚡ One Command. Everything.
+
+</div>
+
+<div align="center">
+
+```bash
+npm i -g fivocell       # 📦 Install
+cell start              # 🚀 Start daemon + watcher + MCP server
+cell connect            # 🔌 Auto-configure ALL your AI tools
+```
+
+</div>
+
+<div align="center">
+
+```
+╔════════════════════════════════════════════════════════════╗
+║                                                            ║
+║  cell start brings up:                                    ║
+║                                                            ║
+║  ⚙️  Daemon (port 9876)    — 125+ API endpoints            ║
+║  👁️  File Watcher           — Auto-learns from every edit   ║
+║  🔌 MCP Server (port 9877) — 25 tools, 8 resources         ║
+║                                                            ║
+║  One command. Thirty seconds. Done.                        ║
+║                                                            ║
+╚════════════════════════════════════════════════════════════╝
+```
+
+</div>
+
+<div align="center">
+
+`cell connect` — Auto-creates config files for every AI tool detected
+
+</div>
+
+<div align="center">
+
+| 🛠️ Tool | 📁 Config Created | 🔗 Method |
+|:-------:|:-----------------:|:---------:|
+| 🖱️ **Cursor** | `.cursor/mcp.json` | Auto-detected |
+| 🤖 **Claude Code** | `.mcp.json` | Project-level |
+| 🌌 **Gemini CLI** | `~/.gemini/settings.json` | Global config |
+| ⚡ **Codex CLI** | `~/.codex/config.json` | Global config |
+
+💡 **Zero manual config. Works on Windows, Mac, and Linux identically.**
+
+</div>
+
+---
+
+<div align="center">
+
+## 🧬 The Three-Layer Brain
+
+</div>
+
+<div align="center">
+
+```
+╔═══════════════════════════════════════════════════════════════════╗
+║                  🧠 CELL INTELLIGENCE LAYERS                      ║
+╠═══════════════════╦═══════════════════╦═══════════════════════════╣
+║                   ║                   ║                           ║
+║   👤 PERSONAL     ║   👥 TEAM         ║   🌐 COMMUNITY            ║
+║   ─────────      ║   ─────           ║   ─────────               ║
+║                   ║                   ║                           ║
+║  "Tum kaise      ║  "Team kaisi      ║ "Duniya ke best          ║
+║   code karte     ║   hai —           ║   developers kya         ║
+║   ho — exactly"  ║   collectively"   ║   karte hain —           ║
+║                  ║                   ║   evidence ke saath"     ║
+║                   ║                   ║                           ║
+║  🔐 PRIVATE      ║  🔒 ANONYMIZED    ║  📊 AGGREGATED          ║
+║  Sirf tumhara    ║  SHA-256 hashed   ║  No code. No names.     ║
+║                  ║                   ║                           ║
+╚═══════════════════╩═══════════════════╩═══════════════════════════╝
+```
+
+</div>
+
+<div align="center">
+
+### 👤 PERSONAL LAYER
+
+*"Cell knows you better than you know yourself"*
+
+</div>
+
+| 🧩 Engine | 🔍 What It Learns |
+|:----------|:------------------|
+| 📝 **Syntax** | Arrow vs named? Async/await? Semicolons? Quotes? Destructuring? |
+| 🏷️ **Naming** | camelCase? Boolean prefixes? Abbreviations? Generic name avoidance? |
+| 📐 **Structure** | File size? Function length? Nesting depth? Early returns? Guard clauses? |
+| 🏗️ **Architecture** | Frontend/backend patterns? Folder style? Config placement? |
+| 👁️ **Blind Spots** | **31 rules** — Error handling missed? Tests skipped? Security gaps? N+1 queries? |
+| ⚡ **Productivity** | Speed patterns? Decision history? Revert frequency? Over/under engineering? |
+| 🧠 **Knowledge Graph** | Tech proficiency? Project DNA? Session context? Context chain? |
+| 🔬 **Proof Engine** | Evidence for every claim — memory, prediction, impact, DNA, identity |
+
+<div align="center">
+
+> 💡 *"Tumhara #1 issue: async error handling 73% cases mein missing hai. Ye tumhara sabse bada bug source hai last 3 months mein."*
+
+</div>
+
+<div align="center">
+
+### 👥 TEAM LAYER
+
+*"Collective intelligence no wiki can capture"*
+
+</div>
+
+| 🧩 Feature | 🔍 What It Provides |
+|:----------|:-------------------|
+| 📚 **Shared Patterns** | Team-approved patterns + rationale |
+| 🗺️ **Knowledge Map** | Kaun kya jaanta hai — expertise distribution |
+| 🚌 **Bus Factor** | "Is module ko sirf Rahul jaanta hai — risk alert!" |
+| 🏥 **Team DNA** | Quality bar, risk profile, testing culture, refactoring appetite |
+| 🔄 **Workflows** | PR bottlenecks, deploy patterns, common failures |
+| 👁️ **Collective Blind Spots** | Patterns team consistently misses across sprints |
+
+<div align="center">
+
+> 🔒 **Privacy guarantee:** Team filenames use SHA-256 hashes, not usernames. File system browsers can't identify individual developers.
+
+</div>
+
+<div align="center">
+
+### 🌐 COMMUNITY LAYER
+
+*"Evidence, not opinions"*
+
+</div>
+
+| 🧩 Feature | 🔍 What It Aggregates |
+|:----------|:---------------------|
+| 📈 **Pattern Success** | "Next.js + Prisma + Zod — 89% success across 48K projects" |
+| 💀 **Failure Library** | Most common bugs, security vulnerabilities, performance bottlenecks |
+| 🔮 **Tech Evolution** | Adoption curves, migration patterns, abandonment signals |
+| 📊 **Benchmarks** | Feature delivery by team size, bug rate by testing culture |
+
+<div align="center">
+
+> 🛡️ **46 fields blocked.** Only abstract, anonymized statistics. Zero code. Zero identities.
+
+</div>
+
+---
+
+<div align="center">
+
+## 🏆 Why Developers Choose Cell
+
+</div>
+
+<div align="center">
+
+| 🎯 Feature | 🧠 Cell | 🤖 Copilot | 🖱️ Cursor Rules | ⚡ Codex | 🌊 Windsurf |
+|:----------|:-------:|:----------:|:---------------:|:--------:|:-----------:|
+| **Works across tools** | ✅ All | ❌ GitHub only | ❌ Cursor only | ❌ OpenAI only | ❌ Windsurf only |
+| **Learns from behavior** | ✅ Edits, rejects | ❌ Prompt-only | ⚠️ Manual rules | ❌ Prompt-only | ⚠️ Basic |
+| **👁️ Blind spot detection** | ✅ 31 rules | ❌ | ❌ | ❌ | ❌ |
+| **👥 Team intelligence** | ✅ Bus factor, silos | ❌ | ❌ | ❌ | ❌ |
+| **🌐 Community data** | ✅ Evidence-backed | ❌ | ❌ | ❌ | ❌ |
+| **🏠 Local-first** | ✅ Zero cloud deps | ❌ Cloud required | ✅ Local only | ❌ Cloud required | ⚠️ Hybrid |
+| **🔓 Open source** | ✅ Apache 2.0 | ❌ Proprietary | ❌ Proprietary | ❌ Proprietary | ❌ Proprietary |
+| **🛡️ Privacy** | ✅ 46 fields blocked | ⚠️ Code to cloud | ✅ Local | ⚠️ Code to cloud | ⚠️ Code to cloud |
+| **🔌 MCP support** | ✅ 25 tools | ❌ | ⚠️ Limited | ⚠️ Limited | ❌ |
+| **💰 Free forever** | ✅ Yes | ❌ $10+/mo | ✅ Free tier | ❌ Pay-per-use | ❌ $15+/mo |
+
+</div>
+
+<div align="center">
+
+> 🎯 **Bottom line:** Every other tool is locked to one editor, sends code to the cloud, or costs money. Cell works everywhere, keeps everything local, and is permanently free.
+
+</div>
+
+---
+
+<div align="center">
+
+## 🔌 MCP Server — 25 Tools, 8 Resources
+
+</div>
+
+<div align="center">
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│                    🔌 CELL MCP SERVER                         │
+│                    localhost:9877/mcp                         │
+│                                                              │
+│   ┌─────────────────────┐    ┌───────────────────────┐      │
+│   │  👤 Personal (6)     │    │  🌐 Community (6)     │      │
+│   │                     │    │                       │      │
+│   │ 🎯 get_taste_context │    │ 📊 community_stats   │      │
+│   │ 📤 send_signal      │    │ 🏆 community_rankings │      │
+│   │ 📋 get_profile      │    │ 📈 community_trends   │      │
+│   │ 🔮 predict_next     │    │ 💡 community_insights │      │
+│   │ 🏗️ check_build      │    │ 📖 community_playbooks │      │
+│   │ 🎯 get_recommend... │    │ ⭐ community_reputation │      │
+│   └─────────────────────┘    └───────────────────────┘      │
+│                                                              │
+│   ┌─────────────────────┐    ┌───────────────────────┐      │
+│   │  🏢 Org Intel (6)    │    │  🔄 Cross-Layer (5)    │      │
+│   │                     │    │                       │      │
+│   │ 📊 org_benchmarks   │    │ 🧮 intelligence_score │      │
+│   │ 🔍 org_silos        │    │ ⚠️ analyze_risks      │      │
+│   │ 🚌 org_bus_factor   │    │ 🎯 find_opportunities │      │
+│   │ ⚠️ org_risks        │    │ 📋 generate_decisions │      │
+│   │ 💡 org_insights     │    │ 📄 intelligence_report │      │
+│   │ 📖 org_playbooks    │    │                       │      │
+│   └─────────────────────┘    └───────────────────────┘      │
+│                                                              │
+│         📦 Resources: 8 URIs — taste, community, team       │
+└──────────────────────────────────────────────────────────────┘
+```
+
+</div>
+
+---
+
+<div align="center">
+
+## 🛡️ Security & Privacy — The Deep Dive
+
+</div>
+
+<div align="center">
+
+```
+╔══════════════════════════════════════════════════════════╗
+║                                                          ║
+║   🔒 Your code is yours. Period.                         ║
+║                                                          ║
+║   No account. No cloud dependency. No telemetry.         ║
+║   No analytics. No tracking. No phone-home.              ║
+║                                                          ║
+╚══════════════════════════════════════════════════════════╝
+```
+
+</div>
+
+<div align="center">
+
+### 🚫 46 Fields BLOCKED From Leaving Your Machine
+
+</div>
+
+<div align="center">
+
+```
+❌ source_code       ❌ file_path        ❌ file_content     ❌ file_name
+❌ prompt            ❌ response         ❌ ai_response      ❌ repo_name
+❌ company_name      ❌ project_name     ❌ customer_name    ❌ username
+❌ secret            ❌ api_key          ❌ password         ❌ token
+❌ auth_token        ❌ private_key      ❌ pii              ❌ email
+❌ phone             ❌ address          ❌ ssn              ❌ environment_vars
+❌ stack_trace       ❌ variable_name    ❌ function_name    ❌ api_name
+❌ endpoint_name     ❌ class_name       ❌ interface_name   ❌ type_name
+❌ business_logic    ❌ domain_terms     ❌ comment_text     ❌ error_message
+❌ log_message       ❌ db_schema        ❌ display_name     ❌ handle
+```
+
+</div>
+
+<div align="center">
+
+### 🔐 Team Layer — Anonymized by Default
+
+</div>
+
+<div align="center">
+
+```
+╔════════════════════════════════════════════════════════════╗
+║                                                            ║
+║   BEFORE:  team/alice.json     👀 Aah, Alice ka data!     ║
+║   AFTER:   team/a7f3b9c1.json  🤷 Kaun hai ye? Koi nahi.  ║
+║                                                            ║
+╚════════════════════════════════════════════════════════════╝
+```
+
+</div>
+
+<div align="center">
+
+> 🔑 Team member filenames use **SHA-256 hashing** with a fixed salt. Same user → same hash (deterministic). But impossible to reverse into a username.
+
+</div>
+
+<div align="center">
+
+### 📊 Community Layer — Only Abstract, Aggregated Stats
+
+</div>
+
+<div align="center">
+
+```
+╔════════════════════════════════════════════════════════════╗
+║   ✅ ALLOWED:                                              ║
+║                                                            ║
+║   "TypeScript + tests developers produce 37% fewer bugs"  ║
+║   "68% of developers miss async error handling"           ║
+║   "Server Components adoption: 34% → 71% in one year"    ║
+║                                                            ║
+║   ❌ NEVER:                                                ║
+║                                                            ║
+║   "Vinayak's payment-service has an auth bug on line 47"  ║
+║   "acme-corp/backend uses this exact folder structure"     ║
+║                                                            ║
+╚════════════════════════════════════════════════════════════╝
+```
+
+</div>
+
+<div align="center">
+
+### 🎚️ Three Privacy Modes
+
+</div>
+
+<div align="center">
+
+| 🔒 Mode | 📤 What's Shared |
+|:-------:|:-----------------|
+| 🏠 `private` | **Nothing.** Fully offline. |
+| 🌐 `community` | Anonymized pattern stats only (default) |
+| 🏢 `organization` | Within your company's org boundary |
+
+</div>
+
+```bash
+cell privacy        # Check current mode
+cell cloud off      # 🔒 Full privacy
+cell cloud on       # 🌐 Community (default)
+```
+
+<div align="center">
+
+> 💨 **Clean uninstall:** `npm uninstall -g fivocell` + `rm -rf ~/.fivo/cell/`. Gone. No traces. No leftovers.
+
+</div>
+
+---
+
+<div align="center">
+
+## 🏗️ Architecture
+
+</div>
+
+<div align="center">
+
+```
+╔═══════════════════════════════════════════════════════════════════╗
+║                      🏗️ CELL ARCHITECTURE                         ║
+╠═══════════════════════════════════════════════════════════════════╣
+║                                                                   ║
+║   📟 CLI                                  🔌 MCP                  ║
+║   42 commands + shortcuts  ◄────►  25 tools + 8 URIs              ║
+║        │                                   │                      ║
+║        └─────────────────┬─────────────────┘                      ║
+║                          │                                        ║
+║               ┌──────────▼──────────┐                             ║
+║               │   ⚙️  DAEMON        │                             ║
+║               │   localhost:9876    │                             ║
+║               │   125+ endpoints    │                             ║
+║               └──────────┬──────────┘                             ║
+║                          │                                        ║
+║        ┌─────────────────┼─────────────────┐                      ║
+║        │                 │                 │                      ║
+║    ┌───▼───┐         ┌───▼───┐         ┌───▼───┐                ║
+║    │ 👤 You │         │ 👥 We │         │ 🌐 All │                ║
+║    │ 11 eng │ ───►    │ 3 eng │ ───►    │ 4 eng │                ║
+║    └───────┘         └───────┘         └───────┘                ║
+║                                                                   ║
+║   ────────────────────────────────────────────────────────       ║
+║   💾 Storage: ~/.fivo/cell/  (all JSON, no database needed)      ║
+╚═══════════════════════════════════════════════════════════════════╝
+```
+
+</div>
+
+---
+
+<div align="center">
+
+## 🤝 Contributing
+
+</div>
+
+<div align="center">
+
+```
+╔══════════════════════════════════════════════════════╗
+║   We ❤️ contributors. Here's how to jump in.          ║
+╚══════════════════════════════════════════════════════╝
+```
+
+</div>
+
+<div align="center">
+
+### 🚀 First Time Setup
+
+</div>
+
+```bash
+git clone https://github.com/thevinsoni/cell.git
+cd cell
+npm install
+npm run build          # TypeScript → dist/
+npm test               # Verify all 772 assertions pass
+```
+
+<div align="center">
+
+### 📁 Project Map
+
+</div>
+
+```
+src/
+├── 📟 cli.ts                    # CLI (42 commands + shortcuts)
+├── 🔌 mcp-server.ts             # MCP JSON-RPC server (25 tools)
+├── 🧠 core/                     # All 19 intelligence engines
+│   ├── syntax-engine.ts         # 13 syntax analyzers
+│   ├── naming-engine.ts         # Variable/function/boolean naming
+│   ├── structure-engine.ts      # File size, nesting, guards
+│   ├── architecture-engine.ts   # Frontend/backend patterns
+│   ├── 👁️ blind-spot-engine.ts  # 31 blind spot rules
+│   ├── ⚡ productivity-engine.ts # Speed, decisions, reverts
+│   ├── 🧬 knowledge-graph-engine.ts # Tech map, session context
+│   ├── 📦 cell-store.ts         # .cell/ directory manager
+│   ├── 🔬 proof-engine.ts       # Evidence-based claims
+│   ├── 👥 team-engine.ts        # Team patterns + knowledge map
+│   ├── 👥 team-advanced-engine.ts # Sprint tracking, blind spots
+│   ├── 👥 team-composer.ts      # Weighted taste aggregation
+│   ├── 🌐 community-engine.ts   # Pattern success + benchmarks
+│   ├── 🌐 community-advanced.ts # Stack decisions
+│   ├── 🌐 community-prior.ts    # Synthetic → live transition
+│   ├── 🌐 community-live.ts     # Real signal ingestion
+│   ├── 🛡️ privacy-manager.ts    # 46 forbidden fields
+│   └── 🧪 __tests__/            # 772 hostile assertions
+├── ⚙️ daemon/                   # Daemon server
+│   ├── server.ts                # 125+ route Express server
+│   ├── lifecycle.ts             # Start/stop/restart
+│   └── websocket.ts             # Real-time streaming
+
+📦 extensions/
+├── 🖥️ vscode/                   # VSCode extension (.vsix)
+├── 🖥️ jetbrains/                # JetBrains plugin config
+└── ⌨️ shell/                    # Shell + Copilot sync scripts
+```
+
+<div align="center">
+
+### 🎯 What to Build
+
+</div>
+
+| 🏷️ Type | 💡 Examples |
+|:--------|:------------|
+| 👁️ **New blind spot rule** | Add `detectMissing()` to `blind-spot-engine.ts` |
+| 🧠 **New engine** | Create `src/core/your-engine.ts` with `CellStore` |
+| 📟 **CLI command** | Add to `cli.ts` following existing patterns |
+| 🔌 **MCP tool** | Add to `mcp-server.ts` TOOLS + `handleToolCall()` |
+| 🧪 **Tests** | Add hostile assertions proving edge cases |
+| 📖 **Docs** | Improve README, FOUNDATION.md, MCP-SETUP.md |
+
+<div align="center">
+
+### 📋 Guidelines
+
+</div>
+
+1. 🚫 **Zero AI/ML dependencies.** Evidence-based math only.
+2. 🏠 **Local-first.** Every feature must work fully offline.
+3. 🛡️ **Privacy-first.** Check `privacy-manager.ts` before sharing data.
+4. 💾 **Memory-only file content.** Abstract patterns only — never raw code.
+5. 🌍 **Cross-platform.** Node.js only. Works on Windows, Mac, Linux.
+6. 🧪 **Tests required.** Every engine needs hostile assertions.
+
+<div align="center">
+
+### 🔄 PR Process
+
+</div>
+
+```
+1️⃣  Fork → Branch → Implement → Add tests
+2️⃣  npm test          → 772 assertions must pass
+3️⃣  npx tsc --noEmit  → Zero TypeScript errors
+4️⃣  Open PR → main    → Describe what + why
+5️⃣  ✅ All checks green → Merged! 🎉
+```
+
+---
+
+<div align="center">
+
+## 🧪 Tests
+
+</div>
+
+```bash
+npm test              # All 772 assertions
+
+# Specific test:
+npx vitest run src/core/__tests__/team-composer.test.ts
+```
+
+<div align="center">
+
+```
+✅ 772/772 hostile assertions passing
+✅ Zero TypeScript errors
+✅ Cross-platform verified
+```
+
+</div>
+
+---
+
+<div align="center">
+
+## ⭐ Why Trust Cell
+
+</div>
+
+<div align="center">
+
+```
+╔════════════════════════════════════════════════════════════╗
+║                                                            ║
+║  🔓 Apache 2.0     — Every line is public. Audit it.      ║
+║  🏠 Local-First    — Zero cloud dependency.               ║
+║  💰 Free Forever   — No pricing page. No billing code.    ║
+║  🛡️ 46 Blocked     — Code literally cannot leave.         ║
+║  📊 Zero Telemetry — No usage tracking. No analytics.     ║
+║  🧪 772 Assertions — Edge cases proven to work.           ║
+║  💨 Clean Uninstall — One command. No traces.             ║
+║                                                            ║
+╚════════════════════════════════════════════════════════════╝
+```
+
+</div>
+
+---
+
+<div align="center">
+
+## 🔗 Links
+
+</div>
+
+<div align="center">
+
+| 🔗 | Resource |
+|:---:|:---------|
+| 🌐 | [cell.fivo.live](https://cell.fivo.live) |
+| 📦 | `npm i -g fivocell` |
+| 💻 | [github.com/thevinsoni/cell](https://github.com/thevinsoni/cell) |
+| 📖 | [MCP Setup Guide](docs/MCP-SETUP.md) |
+
+</div>
+
+---
+
+<div align="center">
+
+```
+╔══════════════════════════════════════════════════════════╗
+║                                                          ║
+║   🧬 Your taste. Every tool. Forever free.               ║
+║                                                          ║
+║   Cell is the last time you explain yourself             ║
+║   to a machine.                                          ║
+║                                                          ║
+╚══════════════════════════════════════════════════════════╝
+```
+
+**Made with ❤️ by developers, for developers. [Contribute →](#-contributing)**
+
+</div>