fivocell 7.0.0 → 7.1.0

package/README.md

@@ -1,4 +1,4 @@
-# FIVO Cell
+# FivoCell
 
 > **Your AI forgets. Cell doesn't.**
 
@@ -6,306 +6,189 @@
 [![Platform](https://img.shields.io/badge/Mac%20%7C%20Windows%20%7C%20Linux-supported-lightgrey)]()
 [![Node](https://img.shields.io/badge/Node-%3E%3D18-green)]()
 [![npm](https://img.shields.io/npm/v/fivocell)](https://www.npmjs.com/package/fivocell)
-[![Tests](https://img.shields.io/badge/Tests-783%2F783-passing-brightgreen)]()
+[![Tests](https://img.shields.io/badge/Tests-817%2F817-passing-brightgreen)]()
 
 ---
 
 ## The Problem
 
-You work in Cursor. Then Claude Code. Then Open Code. Then Antigravity.
+Every AI coding session starts from zero.
 
-Every time you switch tools, **you re-explain** your stack, your style, what you were working on, the bug you just fixed. Your AI has amnesia. Your context is trapped in each tool.
+You explain your stack. Your style. Your last decision. Your project goals.  
+Switch from Cursor to Codex? Start over. New chat? Start over. New day? Start over.
 
-**This is the #1 productivity killer for AI-assisted developers.**
+**AI tools write code. But they forget everything between sessions.**
 
 ---
 
 ## The Solution
 
-**Cell sits between you and your AI tools.** It remembers everything — your coding style, your decisions, your blind spots, your session history — and injects it automatically.
+Cell creates a permanent intelligence layer between you and every AI tool.
 
 ```
-$ @cell
-
-━━━━━━━━━━━━━━━━━━━━━━━━━
- CELL CONTEXT — my-saas-app
-━━━━━━━━━━━━━━━━━━━━━━━━━
-
-📦 PROJECT
-Project: my-saas-app (412 files, 24,891 lines)
-Stack: React 19 · TypeScript · Vite · TailwindCSS
-
-⚠️ BLIND SPOTS:
-→ [12x, trust 92] async_without_trycatch:12/15
-→ [8x, trust 88] chained_property_access:8/8
-
-🎯 LAST SESSION
-Tool: claude-code (12 min ago)
-Working on: fixing memory leak in webhooks
-Last file: src/webhooks/handler.ts
-Key decision: switched from Map to WeakMap
-
-# ─── End @cell Context ───
+                ┌──────────┐
+Cursor ────────→│          │
+Claude Code ───→│   CELL   │────→ SQLite (100% local)
+Codex ─────────→│          │
+Antigravity ───→│  Memory  │────→ Never forgets. Never resets.
+Windsurf ──────→│          │
+Any MCP tool ──→└──────────┘
 ```
 
-**No re-explanation. No context loss. Just works.**
+One daemon. One database. One memory. Works across every AI tool.
 
 ---
 
-## Quick Start (30 seconds)
+## 30-Second Start
 
 ```bash
-# Install
 npm i -g fivocell
-
-# Setup (one-time, idempotent)
 cell setup
-
-# Start daemon
 cell start
-
-# Use in any AI tool
-# Type @cell in Cursor, Claude Code, Open Code, Antigravity, Codex, or Windsurf
+cell mcp-config
 ```
 
-That's it. Your AI now has permanent memory.
+Type `@cell` in Cursor, Codex, Antigravity, or any MCP tool. AI gets full project memory.
 
 ---
 
-## How It Works
+## What Cell Remembers
 
-```
-┌─────────────────────────────────────────┐
-│  Your IDE — Cursor, Claude Code, etc    │
-│  Chat types @cell                       │
-│              ↓                          │
-│  AI calls cell_get_context via MCP      │
-└──────────────┬──────────────────────────┘
-               │ JSON-RPC 2.0
-               ▼
-┌─────────────────────────────────────────┐
-│  Cell Daemon (port 9876)                │
-│  ┌─────────────────────────────────┐    │
-│  │  96 MCP Tools                   │    │
-│  │  Context, Scan, Blind Spots,    │    │
-│  │  Memory, Session, Branch, etc.  │    │
-│  └─────────────────────────────────┘    │
-│  ┌─────────────────────────────────┐    │
-│  │  SQLite DB (100% local)         │    │
-│  │  ~/.fivo/cell/cell.db           │    │
-│  └─────────────────────────────────┘    │
-└─────────────────────────────────────────┘
-```
-
-**Key insight:** Cell is filesystem-level, not IDE-level. It doesn't care whether you're in Cursor, Claude Code, Vim, or Notepad. Same watcher, same DB, same memory.
+| Your AI Tool | Cell Adds |
+|-------------|-----------|
+| Writes code | **Remembers your project** — stack, files, architecture |
+| Generates functions | **Knows your style** — quotes, naming, patterns (auto-detected) |
+| Answers questions | **Recalls your decisions** — why you chose PostgreSQL, not Mongo |
+| Opens new chat | **Restores your session** — what you were working on, where you left off |
+| Switches between tools | **Same memory everywhere** — Cursor → Codex → Claude, no loss |
+| Responds generically | **Adapts to your vibe** — your language, your tone, your workflow |
 
 ---
 
-## Why Cell?
-
-### vs Cursor Memory
-| Feature | Cursor | Cell |
-|---------|--------|------|
-| Cross-IDE | ❌ Cursor only | ✅ 6+ IDEs |
-| Blind spots | ❌ | ✅ 31 rule types |
-| Style injection | ❌ | ✅ Auto .cursorrules |
-| Session recovery | ❌ | ✅ Resume across tools |
-| Memory replay | ❌ | ✅ By topic, time, file |
-| Local-first | ❌ Cloud | ✅ 100% local |
-| Open source | ❌ | ✅ Apache 2.0 |
-
-### vs Claude Memory
-| Feature | Claude | Cell |
-|---------|--------|------|
-| Cross-IDE | ❌ Claude only | ✅ 6+ IDEs |
-| Persistent | ❌ Session only | ✅ Permanent |
-| Code analysis | ❌ | ✅ AST-based |
-| Blind spots | ❌ | ✅ 31 rules |
-| Style learning | ❌ | ✅ Auto-detect |
-| Local-first | ❌ | ✅ 100% local |
-
-### vs GitHub Copilot
-| Feature | Copilot | Cell |
-|---------|---------|------|
-| Context | ❌ Current file only | ✅ Full project |
-| Memory | ❌ None | ✅ Permanent |
-| Cross-tool | ❌ | ✅ 6+ IDEs |
-| Code analysis | ❌ | ✅ AST + patterns |
-| Style matching | ❌ | ✅ Auto-detect |
-| Open source | ❌ | ✅ Apache 2.0 |
-
-### vs Custom .cursorrules
-| Feature | .cursorrules | Cell |
-|---------|-------------|------|
-| Auto-generate | ❌ Manual | ✅ Auto from scan |
-| Update | ❌ Manual | ✅ Auto on re-scan |
-| Cross-IDE | ❌ | ✅ All tools |
-| Blind spots | ❌ | ✅ 31 rules |
-| Memory | ❌ | ✅ Permanent |
-| Session recovery | ❌ | ✅ Resume |
-
-**Bottom line:** Other tools give you a chat. Cell gives you a **brain**.
+## Core Features
 
----
+### 🎯 @cell Context Injection
+Type `@cell` in any AI tool. Cell injects your project profile, coding style, blind spots, last session, and predictions. AI never starts from zero again.
 
-## Features (What Cell Actually Does)
-
-### 🔍 Code Intelligence
-- **Blind Spot Scanner** — 31 rule types (async errors, N+1 queries, deep nesting, missing null checks)
-- **Style Detection** — Auto-detect quotes, semicolons, naming, indentation, async patterns
-- **Knowledge Graph** — File dependencies, blast radius, tech proficiency
-- **Project DNA** — Architecture detection, framework identification, conventions
-
-### 🧠 Memory System
-- **Permanent Memory** — Decisions, errors, fixes, sessions stored in SQLite
-- **Session Recovery** — Resume where you left off across tools
-- **Memory Replay** — Replay engineering history by topic, time, or file
-- **Handoff System** — Current status, completed work, pending tasks
-
-### 🔗 Cross-Tool Continuity
-- **@cell Context** — Inject full project context into any AI tool
-- **6+ IDE Support** — Cursor, Claude Code, Open Code, Antigravity, Codex, Windsurf
-- **Same DB** — All tools share one memory
-- **Same Watcher** — Filesystem-level, not IDE-level
-
-### 📊 Intelligence
-- **Predictive Engine** — Repeat mistakes, decision regret, energy warnings
-- **CI Integration** — Build status, test results, deploy tracking
-- **Branch Context** — Per-branch memory, CI risk correlation
-- **Weekly Reports** — Activity breakdown, decisions, errors, fixes
-
-### 🛠️ Developer Tools
-- **Doctor** — Health check with severity levels (🔴/🟡/✅)
-- **Verify** — Data integrity check across all subsystems
-- **Focus Report** — Active, stalled, abandoned projects
-- **Evolution Map** — Skill progression, project history
-
-### 🔒 Privacy
-- **100% Local** — Code never leaves your machine
-- **No Telemetry** — Zero tracking, zero analytics
-- **Apache 2.0** — Free forever, no restrictions
-- **Encrypted Storage** — AES-256-GCM for sensitive data
+### 🧠 Permanent Memory
+Decisions, errors, fixes, patterns — everything stored in local SQLite. Searchable. Replayable. Survives sessions, tools, and time.
 
----
+### 🔍 Blind Spot Scanner
+Automatically detects 15+ code issues: missing null checks, swallowed errors, `any` usage, N+1 queries, deep nesting. Prioritized. Actionable.
+
+### 🎭 Vibe Engine (NEW in v7)
+Cell learns how you work — your language, your tone, your preferences. Hinglish or English? Bullets or paragraphs? Minimal changes or thorough rewrites? AI adapts automatically.
+
+### 🔗 Cross-Tool Memory
+Same daemon, same database, same memory. Works with Cursor, Codex, Antigravity, Claude Code, Windsurf, OpenCode, and any MCP client.
+
+### 🌐 Local-First & Private
+Everything runs on your machine. No cloud. No telemetry. No tracking. AES-256-GCM encryption for sensitive data. Apache 2.0 — free forever.
 
-## Commands Reference
-
-### Core (Daily Use)
-| Command | What It Does | When |
-|---------|-------------|------|
-| `cell setup` | One-time project setup | First time only |
-| `cell scan` | Analyze codebase | After major changes |
-| `cell context` | Get @cell context | Every AI query |
-| `cell blindspots` | Show code issues | Before commits |
-| `cell watch start` | Track file changes | Always running |
-| `cell bridge start` | Connect to IDE | When using IDE |
-| `cell continue` | Resume last session | Start of day |
-| `cell doctor` | Health check | Weekly |
-
-### Memory
-| Command | What It Does |
-|---------|-------------|
-| `cell memory` | Memory stats |
-| `cell memory search <query>` | Search memory |
-| `cell memory doctor` | Memory health |
-| `cell handoff` | View/create handoff |
-| `cell replay` | Replay history |
-
-### Branch & Team
-| Command | What It Does |
-|---------|-------------|
-| `cell branches` | List branches |
-| `cell switch-back <branch>` | Restore branch context |
-| `cell lessons` | Engineering lessons |
-| `cell team` | Team intelligence |
-| `cell community` | Community patterns |
-
-### Intelligence
-| Command | What It Does |
-|---------|-------------|
-| `cell predict` | Get warnings |
-| `cell evolution` | Project evolution |
-| `cell focus` | Active/stalled/abandoned |
-| `cell why <topic>` | Search decisions |
+### 🩺 Health System
+`cell doctor` runs 12 checks across all subsystems. `cell verify` ensures data integrity. Critical issues flagged. Warnings explained. Always know your memory health.
 
 ---
 
-## Supported IDEs
+## Why Cell vs The Alternatives
 
-| IDE | Status | How to Connect |
-|-----|--------|---------------|
-| Cursor | ✅ | `cell mcp-config` |
-| Claude Code | ✅ | `cell mcp-config` |
-| Open Code | ✅ | `cell mcp-config` |
-| Antigravity | ✅ | `cell mcp-config` |
-| Codex | ✅ | `cell mcp-config` |
-| Windsurf | ✅ | `cell mcp-config` |
-| VSCode | ⚠️ | Extension available |
+| Problem | AI Tools Alone | With Cell |
+|---------|---------------|-----------|
+| Project context per session | ❌ Re-explain every time | ✅ Auto-injected |
+| Memory across tools | ❌ Each tool isolated | ✅ One memory, all tools |
+| Code style consistency | ❌ Manual rules files | ✅ Auto-detected + injected |
+| Blind spots & risks | ❌ Hope AI catches them | ✅ Systematic scanner |
+| Session handoff | ❌ Lost on tool switch | ✅ Seamless bridge |
+| Developer personality | ❌ Generic responses | ✅ Vibe — adapts to you |
+| Privacy | ❌ Cloud-dependent | ✅ 100% local |
 
 ---
 
-## Architecture
+## Quick Commands
 
 ```
-~/.fivo/cell/
-├── cell.db          — SQLite (all persistent data)
-├── daemon.log       — daemon output
-├── daemon.pid       — process tracking
-└── personal/
-    └── insights/    — saved AI analysis
-
-.cell/
-├── personal/        — profile, style, errors, decisions
-├── team/            — members, shared patterns
-├── community/       — aggregate patterns, benchmarks
-├── memory/
-│   ├── archive/     — encrypted long-term storage
-│   ├── blobs/       — content-addressed dedup
-│   ├── context/     — short, full, last-session
-│   ├── patterns/    — code, error, fix, architecture
-│   └── summaries/   — daily, weekly, monthly
-└── handoff/
-    ├── current.md   — active handoff
-    └── history/     — past handoffs
+cell setup         One-time setup
+cell start         Start daemon on localhost:9876
+cell scan          Analyze codebase + build intelligence
+cell context       View what @cell returns
+cell blindspots    Find code issues (--top for quick view)
+cell vibe          See your learned personality
+cell teach         Tell Cell about yourself
+cell doctor        12-point health check
+cell verify        Data integrity check
+cell memory search Search everything Cell remembers
 ```
 
 ---
 
-## Privacy First
+## Supported Tools
+
+| Tool | Connection | Setup |
+|------|-----------|-------|
+| **Cursor** | MCP | `cell mcp-config` |
+| **Codex** | MCP | `cell mcp-config` |
+| **Antigravity** | MCP | `cell mcp-config` |
+| **Claude Code** | MCP | Manual URL |
+| **Windsurf** | MCP | Manual URL |
+| **OpenCode** | MCP | `cell mcp-config` |
+| **GitHub Copilot** | MCP | Manual URL |
+| **VS Code** | Extension | Install VSIX |
+| **Any MCP Client** | HTTP | `http://localhost:9876/mcp` |
+
+---
+
+## What Users Are Saying
+
+> "Finally — I switch between Cursor and Codex all day. Cell keeps my context. I don't explain anything twice anymore."
 
-- **100% local** — code never leaves your machine
-- **No telemetry** — zero tracking, zero analytics
-- **No cloud** — all data on your device
-- **Apache 2.0** — free forever, no restrictions
-- **Encrypted storage** — AES-256-GCM for sensitive data
-- **No browser sniffer, clipboard tracking, or keystroke logging** — permanently excluded
+> "The blind spot scanner found 39 async functions without try/catch in my codebase. I fixed them in an hour. That alone saved me weeks of debugging."
+
+> "My AI now talks in Hinglish. Not because I asked — Cell figured it out from my sessions. The vibe engine is actually magic."
 
 ---
 
-## Community
+## More Features
 
-- **GitHub:** [github.com/itsvinsoni/fivocell](https://github.com/itsvinsoni/fivocell)
-- **npm:** [npmjs.com/package/fivocell](https://www.npmjs.com/package/fivocell)
-- **Issues:** [GitHub Issues](https://github.com/itsvinsoni/fivocell/issues)
+Cell also includes: session replay, branch context memory, CI/CD integration, encrypted sync export/import, weekly reports, memory health scoring, developer velocity tracking, knowledge graph, project DNA fingerprinting, focus reports, PR review assistant, and 70+ more. See [full reference](docs/FIVO-CELL-COMPLETE-REFERENCE.md).
 
 ---
 
-## Contributing
+## Architecture
 
-1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
+```
+~/.fivo/cell/cell.db    ← Single SQLite database (64 tables)
+  ├── memory_events     ← Every edit, decision, error, fix
+  ├── sessions          ← Work sessions across all tools
+  ├── style_profiles    ← Auto-detected coding patterns
+  ├── code_patterns     ← Learned patterns by category
+  └── ... (60+ more tables)
+
+.cell/                   ← Per-project readable files
+  ├── vibe/              ← Your learned personality (new in v7)
+  ├── memory/            ← Compressed archives + summaries
+  └── handoff/           ← Session-to-session context
+```
 
 ---
 
-## License
+## Stats
 
-Apache 2.0 — Free forever. No restrictions for individual use.
+```
+✅ Build:      0 TypeScript errors
+✅ Tests:      86 suites, 817/817 passing
+✅ MCP Tools:  112 registered
+✅ Lines:      59,000+ production TypeScript
+✅ Security:   0 vulnerabilities (audited 2026-06-13)
+```
 
 ---
 
-**Git stores code. Cell stores engineering experience.**
+## Contribute
+
+[github.com/itsvinsoni/fivocell](https://github.com/itsvinsoni/fivocell)
+
+Apache 2.0. Open issues. PRs welcome.
+
+---
 
-*Your AI forgets. Cell doesn't.* 🚀
+**AI tools come and go. Your project knowledge stays.**

package/dist/walls/01-context/context/agents-md.d.ts

@@ -1,7 +1,7 @@
 export declare const AGENTS_MD_FILENAME = "AGENTS.md";
 export declare const CURSORRULES_FILENAME = ".cursorrules";
 export declare const CELL_RULES_MARKER = "# fivo-cell:rules:v1";
-export declare const AGENTS_MD_TEMPLATE = "# fivo-cell:rules:v1\n# FIVO Cell \u2014 AI Memory Rules\n\nFIVO Cell is installed and configured for this project. Use its MCP tools\n(named `cell_*`) to maintain permanent memory across sessions.\n\n## The @cell Convention\n\nWhenever the user types `@cell` in their message (e.g. \"@cell what did I\njust edit?\" or \"@cell fix this bug\"), you MUST do the following BEFORE\nresponding:\n\n1. **Call `cell_get_context` FIRST** to load this project's full context.\n2. **Pass `project` as the current folder name** \u2014 derive it from\n   `path.basename(process.cwd())` or the absolute path the IDE is open\n   in. If unsure, call `cell_list_projects` and pick the matching one.\n3. **Also pass `tool`** set to YOUR ACTUAL IDE/TOOL NAME (the one you\n   are running in right now). Cell formats the block differently for\n   each tool. The valid values are:\n   - If you are in **Antigravity** / **Gemini** IDE \u2192 pass `\"tool\": \"antigravity\"`\n   - If you are in **Cursor** \u2192 pass `\"tool\": \"cursor\"`\n   - If you are in **OpenCode** CLI \u2192 pass `\"tool\": \"opencode\"`\n   - If you are in **Claude Code** CLI \u2192 pass `\"tool\": \"claude-code\"`\n   - If you are in **Codex** CLI \u2192 pass `\"tool\": \"codex\"`\n   - If you are in **Windsurf** / **Codeium** \u2192 pass `\"tool\": \"windsurf\"`\n   - If you are in **GitHub Copilot** \u2192 pass `\"tool\": \"copilot\"`\n   - If you are in **Aider** \u2192 pass `\"tool\": \"aider\"`\n   - If you are in **Continue.dev** \u2192 pass `\"tool\": \"continue-dev\"`\n   - If you are unsure / none of the above \u2192 omit `tool` and Cell\n     returns the rich text block (works for every IDE).\n   DO NOT pass `\"opencode\"` unless you are actually OpenCode. If you\n   are Antigravity, the correct value is `\"antigravity\"` (not\n   `\"opencode\"`, not `\"cursor\"`, not `\"antigravity-ide\"`).\n4. **Use the returned context** to inform your answer \u2014 it contains the\n   last session, recent file edits (live events), blind spots, style\n   hints, predictions, and tried approaches.\n\n## Common Cell Tools\n\n| Task | Tool |\n|------|------|\n| Load project context (`@cell`) | `cell_get_context` |\n| Open a work session | `cell_session_start` |\n| Close a session with key decisions | `cell_session_end` |\n| See recent sessions | `cell_session_recent` |\n| See recent file saves | `cell_watch_events` |\n| Start the file watcher | `cell_watch_start` |\n| Stop the file watcher | `cell_watch_stop` |\n| Detect code risks (try/catch, null checks, validation) | `cell_blindspots` |\n| Scan the project | `cell_scan` |\n| Log an error you hit | `cell_log_error` |\n| Log how you fixed it | `cell_log_fix` |\n| Log a key decision | `cell_log_decision` |\n| List all registered projects | `cell_list_projects` |\n\nThere are 67 cell tools in total. Run `cell --help` to see all of them.\n\n## Session Discipline\n\n- **At the start of a non-trivial task** (multi-file work, refactor,\n  feature, debugging session): call `cell_session_start` to open a\n  session.\n- **At the end** (or before a long break): call `cell_session_end` with\n  `keyDecisions` summarising what you decided and `filesTouched`\n  listing the files you changed.\n- If the user switches tools (e.g. Cursor \u2192 Antigravity) within a\n  project, the bridge context is auto-loaded \u2014 read it from the @cell\n  block to understand what was just done.\n\n## Watcher Awareness\n\n- If the watcher is active, the @cell block includes the most recent\n  file edits. Trust those for \"what did I just edit\" questions.\n- If the user reports a file change you don't know about, call\n  `cell_watch_events` directly.\n\n## Anti-Patterns to Avoid\n\n- Do NOT guess a project name. If unsure, call `cell_list_projects`.\n- Do NOT skip `cell_get_context` when @cell is in the prompt \u2014 the\n  whole point of the convention is automatic context.\n- Do NOT call `cell_get_context` for every message. Only when @cell\n  appears, or when context is genuinely needed.\n- Do NOT modify or remove this file. To regenerate it, run\n  `cell scan` again (it is idempotent \u2014 existing files are kept).\n\n## Regeneration\n\nThis file is auto-generated by `cell scan`. To remove it: `cell scan --no-rules`.\n";
+export declare const AGENTS_MD_TEMPLATE = "# fivo-cell:rules:v1\n# FIVO Cell \u2014 AI Memory Rules\n\nFIVO Cell is installed and configured for this project. Use its MCP tools\n(named `cell_*`) to maintain permanent memory across sessions.\n\n## The @cell Convention\n\nWhenever the user types `@cell` in their message (e.g. \"@cell what did I\njust edit?\" or \"@cell fix this bug\"), you MUST do the following BEFORE\nresponding:\n\n1. **Call `cell_get_context` FIRST** to load this project's full context.\n2. **Pass `project` as the current folder name** \u2014 derive it from\n   `path.basename(process.cwd())` or the absolute path the IDE is open\n   in. If unsure, call `cell_list_projects` and pick the matching one.\n3. **Also pass `tool`** set to YOUR ACTUAL IDE/TOOL NAME (the one you\n   are running in right now). Cell formats the block differently for\n   each tool. The valid values are:\n   - If you are in **Antigravity** / **Gemini** IDE \u2192 pass `\"tool\": \"antigravity\"`\n   - If you are in **Cursor** \u2192 pass `\"tool\": \"cursor\"`\n   - If you are in **OpenCode** CLI \u2192 pass `\"tool\": \"opencode\"`\n   - If you are in **Claude Code** CLI \u2192 pass `\"tool\": \"claude-code\"`\n   - If you are in **Codex** CLI \u2192 pass `\"tool\": \"codex\"`\n   - If you are in **Windsurf** / **Codeium** \u2192 pass `\"tool\": \"windsurf\"`\n   - If you are in **GitHub Copilot** \u2192 pass `\"tool\": \"copilot\"`\n   - If you are in **Aider** \u2192 pass `\"tool\": \"aider\"`\n   - If you are in **Continue.dev** \u2192 pass `\"tool\": \"continue-dev\"`\n   - If you are unsure / none of the above \u2192 omit `tool` and Cell\n     returns the rich text block (works for every IDE).\n   DO NOT pass `\"opencode\"` unless you are actually OpenCode. If you\n   are Antigravity, the correct value is `\"antigravity\"` (not\n   `\"opencode\"`, not `\"cursor\"`, not `\"antigravity-ide\"`).\n4. **Use the returned context** to inform your answer \u2014 it contains the\n   last session, recent file edits (live events), blind spots, style\n   hints, predictions, tried approaches, **session bridge (what just happened)**,\n   and **continuity thread (what's been happening across sessions)**.\n\n## Supreme Context: Bridge + Continuity\n\nFivo Cell v7+ maintains **Supreme Context** \u2014 AI never starts a session blind:\n\n- **\uD83C\uDF09 Session Bridge**: Automatically captured at session end. Auto-injected\n   at session start. Contains: summary, open questions, failed approaches,\n   working approaches, last thought, file focus, vibe snapshot.\n- **\uD83E\uDDF5 Continuity Thread**: Tracks work across multiple sessions. Knows\n   what you're building, open questions, pending actions, key learnings.\n- **\uD83D\uDD2E Context Predictions**: Predicts what you'll need \u2014 which files,\n   which errors may recur, which decisions need revisiting.\n\n**The bridge is auto-loaded in every `@cell` block.** You don't need to\nask for it \u2014 just read the `\uD83C\uDF09 LAST SESSION BRIDGE` and `\uD83E\uDDF5 CONTINUITY\nTHREAD` sections at the top of the context block and use them.\n\n## Common Cell Tools\n\n| Task | Tool |\n|------|------|\n| Load project context (`@cell`) | `cell_get_context` |\n| Open a work session | `cell_session_start` |\n| Close a session with key decisions | `cell_session_end` |\n| See recent sessions | `cell_session_recent` |\n| See recent file saves | `cell_watch_events` |\n| Start the file watcher | `cell_watch_start` |\n| Stop the file watcher | `cell_watch_stop` |\n| Detect code risks (try/catch, null checks, validation) | `cell_blindspots` |\n| Scan the project | `cell_scan` |\n| Log an error you hit | `cell_log_error` |\n| Log how you fixed it | `cell_log_fix` |\n| Log a key decision | `cell_log_decision` |\n| List all registered projects | `cell_list_projects` |\n\nThere are 67 cell tools in total. Run `cell --help` to see all of them.\n\n## Session Discipline\n\n- **At the start of a non-trivial task** (multi-file work, refactor,\n  feature, debugging session): call `cell_session_start` to open a\n  session.\n- **At the end** (or before a long break): call `cell_session_end` with\n  `keyDecisions` summarising what you decided and `filesTouched`\n  listing the files you changed.\n- If the user switches tools (e.g. Cursor \u2192 Antigravity) within a\n  project, the bridge context is auto-loaded \u2014 read it from the @cell\n  block to understand what was just done.\n\n## Supreme Context: Never Start Blind\n\nFivo v7 includes **Supreme Context** that auto-injects into every\n`@cell` block:\n\n- **\uD83C\uDF09 Bridge**: Last session's summary, decisions, open questions,\n  file focus, failed approaches (don't retry), working approaches\n- **\uD83E\uDDF5 Continuity Thread**: Cross-session work tracking \u2014 what's being\n  built, pending actions, key learnings across sessions\n- **\uD83D\uDD2E Predictions**: What files you'll need, which errors may recur,\n  which decisions need revisiting\n\nRead these sections at the top of the context block and you'll\nimmediately know what was happening and what to do next.\n\n## Watcher Awareness\n\n- If the watcher is active, the @cell block includes the most recent\n  file edits. Trust those for \"what did I just edit\" questions.\n- If the user reports a file change you don't know about, call\n  `cell_watch_events` directly.\n\n## Anti-Patterns to Avoid\n\n- Do NOT guess a project name. If unsure, call `cell_list_projects`.\n- Do NOT skip `cell_get_context` when @cell is in the prompt \u2014 the\n  whole point of the convention is automatic context.\n- Do NOT call `cell_get_context` for every message. Only when @cell\n  appears, or when context is genuinely needed.\n- Do NOT modify or remove this file. To regenerate it, run\n  `cell scan` again (it is idempotent \u2014 existing files are kept).\n\n## Regeneration\n\nThis file is auto-generated by `cell scan`. To remove it: `cell scan --no-rules`.\n";
 export declare const CURSORRULES_TEMPLATE = "# fivo-cell:rules:v1\n# FIVO Cell \u2014 Cursor Rules\n\nWhen the user types `@cell` in chat or Composer, you MUST call the\n`cell_get_context` MCP tool FIRST, with `project` set to the current\nfolder name and `tool` set to `cursor`. Then use the returned block\nto inform your response. See AGENTS.md for the full convention.\n";
 export interface WriteRulesResult {
     agentsMd: 'written' | 'exists' | 'skipped';

package/dist/walls/01-context/context/agents-md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../../../src/walls/01-context/context/agents-md.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAC9C,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AACnD,eAAO,MAAM,iBAAiB,yBAAyB,CAAC;AAExD,eAAO,MAAM,kBAAkB,qqIAyF9B,CAAC;AAEF,eAAO,MAAM,oBAAoB,8UAOhC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,WAAW,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAWvH;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAW1H;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,gBAAgB,CAI1H"}
+{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../../../src/walls/01-context/context/agents-md.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAC9C,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AACnD,eAAO,MAAM,iBAAiB,yBAAyB,CAAC;AAExD,eAAO,MAAM,kBAAkB,0yLAyH9B,CAAC;AAEF,eAAO,MAAM,oBAAoB,8UAOhC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,WAAW,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAWvH;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAW1H;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,gBAAgB,CAI1H"}

package/dist/walls/01-context/context/agents-md.js

@@ -78,7 +78,24 @@ responding:
    \`"opencode"\`, not \`"cursor"\`, not \`"antigravity-ide"\`).
 4. **Use the returned context** to inform your answer — it contains the
    last session, recent file edits (live events), blind spots, style
-   hints, predictions, and tried approaches.
+   hints, predictions, tried approaches, **session bridge (what just happened)**,
+   and **continuity thread (what's been happening across sessions)**.
+
+## Supreme Context: Bridge + Continuity
+
+Fivo Cell v7+ maintains **Supreme Context** — AI never starts a session blind:
+
+- **🌉 Session Bridge**: Automatically captured at session end. Auto-injected
+   at session start. Contains: summary, open questions, failed approaches,
+   working approaches, last thought, file focus, vibe snapshot.
+- **🧵 Continuity Thread**: Tracks work across multiple sessions. Knows
+   what you're building, open questions, pending actions, key learnings.
+- **🔮 Context Predictions**: Predicts what you'll need — which files,
+   which errors may recur, which decisions need revisiting.
+
+**The bridge is auto-loaded in every \`@cell\` block.** You don't need to
+ask for it — just read the \`🌉 LAST SESSION BRIDGE\` and \`🧵 CONTINUITY
+THREAD\` sections at the top of the context block and use them.
 
 ## Common Cell Tools
 
@@ -112,6 +129,21 @@ There are 67 cell tools in total. Run \`cell --help\` to see all of them.
   project, the bridge context is auto-loaded — read it from the @cell
   block to understand what was just done.
 
+## Supreme Context: Never Start Blind
+
+Fivo v7 includes **Supreme Context** that auto-injects into every
+\`@cell\` block:
+
+- **🌉 Bridge**: Last session's summary, decisions, open questions,
+  file focus, failed approaches (don't retry), working approaches
+- **🧵 Continuity Thread**: Cross-session work tracking — what's being
+  built, pending actions, key learnings across sessions
+- **🔮 Predictions**: What files you'll need, which errors may recur,
+  which decisions need revisiting
+
+Read these sections at the top of the context block and you'll
+immediately know what was happening and what to do next.
+
 ## Watcher Awareness
 
 - If the watcher is active, the @cell block includes the most recent

package/dist/walls/01-context/context/agents-md.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents-md.js","sourceRoot":"","sources":["../../../../src/walls/01-context/context/agents-md.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiHA,0CAEC;AAED,sCAWC;AAED,4CAWC;AAED,wCAIC;AAnJD,uCAAyB;AACzB,2CAA6B;AAEhB,QAAA,kBAAkB,GAAG,WAAW,CAAC;AACjC,QAAA,oBAAoB,GAAG,cAAc,CAAC;AACtC,QAAA,iBAAiB,GAAG,sBAAsB,CAAC;AAE3C,QAAA,kBAAkB,GAAG,GAAG,yBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyFrD,CAAC;AAEW,QAAA,oBAAoB,GAAG,GAAG,yBAAiB;;;;;;;CAOvD,CAAC;AAQF,SAAgB,eAAe,CAAC,OAAe;IAC7C,OAAO,OAAO,CAAC,QAAQ,CAAC,yBAAiB,CAAC,CAAC;AAC7C,CAAC;AAED,SAAgB,aAAa,CAAC,WAAmB,EAAE,OAAgC,EAAE;IACnF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,0BAAkB,CAAC,CAAC;IAC5D,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/C,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,0BAAkB,EAAE,MAAM,CAAC,CAAC;QACvD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAgB,gBAAgB,CAAC,WAAmB,EAAE,OAAgC,EAAE;IACtF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,4BAAoB,CAAC,CAAC;IAC9D,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/C,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,4BAAoB,EAAE,MAAM,CAAC,CAAC;QACzD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAgB,cAAc,CAAC,WAAmB,EAAE,OAAkD,EAAE;IACtG,MAAM,QAAQ,GAAG,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC5F,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACnC,CAAC"}
+{"version":3,"file":"agents-md.js","sourceRoot":"","sources":["../../../../src/walls/01-context/context/agents-md.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiJA,0CAEC;AAED,sCAWC;AAED,4CAWC;AAED,wCAIC;AAnLD,uCAAyB;AACzB,2CAA6B;AAEhB,QAAA,kBAAkB,GAAG,WAAW,CAAC;AACjC,QAAA,oBAAoB,GAAG,cAAc,CAAC;AACtC,QAAA,iBAAiB,GAAG,sBAAsB,CAAC;AAE3C,QAAA,kBAAkB,GAAG,GAAG,yBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyHrD,CAAC;AAEW,QAAA,oBAAoB,GAAG,GAAG,yBAAiB;;;;;;;CAOvD,CAAC;AAQF,SAAgB,eAAe,CAAC,OAAe;IAC7C,OAAO,OAAO,CAAC,QAAQ,CAAC,yBAAiB,CAAC,CAAC;AAC7C,CAAC;AAED,SAAgB,aAAa,CAAC,WAAmB,EAAE,OAAgC,EAAE;IACnF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,0BAAkB,CAAC,CAAC;IAC5D,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/C,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,0BAAkB,EAAE,MAAM,CAAC,CAAC;QACvD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAgB,gBAAgB,CAAC,WAAmB,EAAE,OAAgC,EAAE;IACtF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,4BAAoB,CAAC,CAAC;IAC9D,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/C,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,4BAAoB,EAAE,MAAM,CAAC,CAAC;QACzD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAgB,cAAc,CAAC,WAAmB,EAAE,OAAkD,EAAE;IACtG,MAAM,QAAQ,GAAG,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC5F,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACnC,CAAC"}

package/dist/walls/01-context/context/context-bridge.d.ts

@@ -0,0 +1,39 @@
+export interface SessionBridge {
+    fromSessionId: number;
+    toSessionId?: number;
+    capturedAt: string;
+    consumedAt?: string;
+    consumed: boolean;
+    project: string;
+    tool: string;
+    summary: string;
+    status: string;
+    filesTouched: string[];
+    keyDecisions: string[];
+    openQuestions: string[];
+    failedApproaches: string[];
+    workingApproaches: string[];
+    lastThought: string;
+    vibeAtCapture: string;
+    predictedNextSteps: string[];
+}
+export declare function captureSessionBridge(projectDir: string, params: {
+    sessionId: number;
+    project: string;
+    tool: string;
+    summary: string;
+    status: string;
+    filesTouched: string[];
+    keyDecisions: string[];
+    openQuestions: string[];
+    failedApproaches: string[];
+    workingApproaches: string[];
+    lastThought: string;
+    predictedNextSteps: string[];
+}): SessionBridge;
+export declare function consumeSessionBridge(projectDir: string, currentSessionId: number): SessionBridge | null;
+export declare function peekSessionBridge(projectDir: string): SessionBridge | null;
+export declare function isBridgeStale(projectDir: string): boolean;
+export declare function autoGenerateBridge(projectDir: string, project: string): SessionBridge | null;
+export declare function formatBridgeForContext(bridge: SessionBridge): string;
+//# sourceMappingURL=context-bridge.d.ts.map

package/dist/walls/01-context/context/context-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-bridge.d.ts","sourceRoot":"","sources":["../../../../src/walls/01-context/context/context-bridge.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAaD,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE;IACN,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B,GACA,aAAa,CA6Cf;AAGD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAavG;AAGD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAI1E;AAGD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAKzD;AAGD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA0C5F;AAGD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA+DpE"}