fivocell 7.0.0 → 7.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/README.md +120 -237
  2. package/dist/__tests__/cli-regression.test.js +2 -2
  3. package/dist/__tests__/cli-regression.test.js.map +1 -1
  4. package/dist/walls/01-context/context/agents-md.d.ts +1 -1
  5. package/dist/walls/01-context/context/agents-md.d.ts.map +1 -1
  6. package/dist/walls/01-context/context/agents-md.js +33 -1
  7. package/dist/walls/01-context/context/agents-md.js.map +1 -1
  8. package/dist/walls/01-context/context/context-bridge.d.ts +39 -0
  9. package/dist/walls/01-context/context/context-bridge.d.ts.map +1 -0
  10. package/dist/walls/01-context/context/context-bridge.js +224 -0
  11. package/dist/walls/01-context/context/context-bridge.js.map +1 -0
  12. package/dist/walls/01-context/context/context-continuity.d.ts +54 -0
  13. package/dist/walls/01-context/context/context-continuity.d.ts.map +1 -0
  14. package/dist/walls/01-context/context/context-continuity.js +350 -0
  15. package/dist/walls/01-context/context/context-continuity.js.map +1 -0
  16. package/dist/walls/01-context/context/context-predictor.d.ts +24 -0
  17. package/dist/walls/01-context/context/context-predictor.d.ts.map +1 -0
  18. package/dist/walls/01-context/context/context-predictor.js +322 -0
  19. package/dist/walls/01-context/context/context-predictor.js.map +1 -0
  20. package/dist/walls/01-context/context/prompt-builder.d.ts.map +1 -1
  21. package/dist/walls/01-context/context/prompt-builder.js +53 -0
  22. package/dist/walls/01-context/context/prompt-builder.js.map +1 -1
  23. package/dist/walls/01-context/sessions/session-memory.d.ts.map +1 -1
  24. package/dist/walls/01-context/sessions/session-memory.js +47 -1
  25. package/dist/walls/01-context/sessions/session-memory.js.map +1 -1
  26. package/dist/walls/04-team/collab/team-supreme.d.ts +70 -0
  27. package/dist/walls/04-team/collab/team-supreme.d.ts.map +1 -0
  28. package/dist/walls/04-team/collab/team-supreme.js +357 -0
  29. package/dist/walls/04-team/collab/team-supreme.js.map +1 -0
  30. package/dist/walls/05-community/share/cloud-connector.d.ts +83 -0
  31. package/dist/walls/05-community/share/cloud-connector.d.ts.map +1 -0
  32. package/dist/walls/05-community/share/cloud-connector.js +385 -0
  33. package/dist/walls/05-community/share/cloud-connector.js.map +1 -0
  34. package/dist/walls/05-community/stats/community-supreme.d.ts +83 -0
  35. package/dist/walls/05-community/stats/community-supreme.d.ts.map +1 -0
  36. package/dist/walls/05-community/stats/community-supreme.js +221 -0
  37. package/dist/walls/05-community/stats/community-supreme.js.map +1 -0
  38. package/dist/walls/06-memory/vibe/vibe-confidence.js +6 -6
  39. package/dist/walls/06-memory/vibe/vibe-confidence.js.map +1 -1
  40. package/dist/walls/06-memory/vibe/vibe-engine.d.ts +7 -0
  41. package/dist/walls/06-memory/vibe/vibe-engine.d.ts.map +1 -1
  42. package/dist/walls/06-memory/vibe/vibe-engine.js +323 -240
  43. package/dist/walls/06-memory/vibe/vibe-engine.js.map +1 -1
  44. package/dist/walls/06-memory/vibe/vibe-intelligence.d.ts +19 -0
  45. package/dist/walls/06-memory/vibe/vibe-intelligence.d.ts.map +1 -0
  46. package/dist/walls/06-memory/vibe/vibe-intelligence.js +264 -0
  47. package/dist/walls/06-memory/vibe/vibe-intelligence.js.map +1 -0
  48. package/dist/walls/06-memory/vibe/vibe-signals.d.ts +3 -0
  49. package/dist/walls/06-memory/vibe/vibe-signals.d.ts.map +1 -1
  50. package/dist/walls/06-memory/vibe/vibe-signals.js +122 -9
  51. package/dist/walls/06-memory/vibe/vibe-signals.js.map +1 -1
  52. package/dist/walls/07-runtime/cli/cli.js +8 -0
  53. package/dist/walls/07-runtime/cli/cli.js.map +1 -1
  54. package/dist/walls/07-runtime/cli/commands/cloud.d.ts +3 -0
  55. package/dist/walls/07-runtime/cli/commands/cloud.d.ts.map +1 -0
  56. package/dist/walls/07-runtime/cli/commands/cloud.js +219 -0
  57. package/dist/walls/07-runtime/cli/commands/cloud.js.map +1 -0
  58. package/dist/walls/07-runtime/cli/commands/community.d.ts.map +1 -1
  59. package/dist/walls/07-runtime/cli/commands/community.js +6 -0
  60. package/dist/walls/07-runtime/cli/commands/community.js.map +1 -1
  61. package/dist/walls/07-runtime/cli/commands/help.d.ts.map +1 -1
  62. package/dist/walls/07-runtime/cli/commands/help.js +85 -75
  63. package/dist/walls/07-runtime/cli/commands/help.js.map +1 -1
  64. package/dist/walls/07-runtime/cli/commands/setup.d.ts.map +1 -1
  65. package/dist/walls/07-runtime/cli/commands/setup.js +20 -4
  66. package/dist/walls/07-runtime/cli/commands/setup.js.map +1 -1
  67. package/dist/walls/07-runtime/cli/utils.js +2 -2
  68. package/dist/walls/07-runtime/daemon/lifecycle.d.ts.map +1 -1
  69. package/dist/walls/07-runtime/daemon/lifecycle.js +13 -1
  70. package/dist/walls/07-runtime/daemon/lifecycle.js.map +1 -1
  71. package/dist/walls/07-runtime/setup/setup.d.ts +1 -0
  72. package/dist/walls/07-runtime/setup/setup.d.ts.map +1 -1
  73. package/dist/walls/07-runtime/setup/setup.js +2 -1
  74. package/dist/walls/07-runtime/setup/setup.js.map +1 -1
  75. package/package.json +1 -1
package/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # FIVO Cell
1
+ # FivoCell
2
2
 
3
3
  > **Your AI forgets. Cell doesn't.**
4
4
 
@@ -6,306 +6,189 @@
6
6
  [![Platform](https://img.shields.io/badge/Mac%20%7C%20Windows%20%7C%20Linux-supported-lightgrey)]()
7
7
  [![Node](https://img.shields.io/badge/Node-%3E%3D18-green)]()
8
8
  [![npm](https://img.shields.io/npm/v/fivocell)](https://www.npmjs.com/package/fivocell)
9
- [![Tests](https://img.shields.io/badge/Tests-783%2F783-passing-brightgreen)]()
9
+ [![Tests](https://img.shields.io/badge/Tests-817%2F817-passing-brightgreen)]()
10
10
 
11
11
  ---
12
12
 
13
13
  ## The Problem
14
14
 
15
- You work in Cursor. Then Claude Code. Then Open Code. Then Antigravity.
15
+ Every AI coding session starts from zero.
16
16
 
17
- 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.
17
+ You explain your stack. Your style. Your last decision. Your project goals.
18
+ Switch from Cursor to Codex? Start over. New chat? Start over. New day? Start over.
18
19
 
19
- **This is the #1 productivity killer for AI-assisted developers.**
20
+ **AI tools write code. But they forget everything between sessions.**
20
21
 
21
22
  ---
22
23
 
23
24
  ## The Solution
24
25
 
25
- **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.
26
+ Cell creates a permanent intelligence layer between you and every AI tool.
26
27
 
27
28
  ```
28
- $ @cell
29
-
30
- ━━━━━━━━━━━━━━━━━━━━━━━━━
31
- CELL CONTEXT — my-saas-app
32
- ━━━━━━━━━━━━━━━━━━━━━━━━━
33
-
34
- 📦 PROJECT
35
- Project: my-saas-app (412 files, 24,891 lines)
36
- Stack: React 19 · TypeScript · Vite · TailwindCSS
37
-
38
- ⚠️ BLIND SPOTS:
39
- → [12x, trust 92] async_without_trycatch:12/15
40
- → [8x, trust 88] chained_property_access:8/8
41
-
42
- 🎯 LAST SESSION
43
- Tool: claude-code (12 min ago)
44
- Working on: fixing memory leak in webhooks
45
- Last file: src/webhooks/handler.ts
46
- Key decision: switched from Map to WeakMap
47
-
48
- # ─── End @cell Context ───
29
+ ┌──────────┐
30
+ Cursor ────────→│ │
31
+ Claude Code ───→│ CELL │────→ SQLite (100% local)
32
+ Codex ─────────→│ │
33
+ Antigravity ───→│ Memory │────→ Never forgets. Never resets.
34
+ Windsurf ──────→│ │
35
+ Any MCP tool ──→└──────────┘
49
36
  ```
50
37
 
51
- **No re-explanation. No context loss. Just works.**
38
+ One daemon. One database. One memory. Works across every AI tool.
52
39
 
53
40
  ---
54
41
 
55
- ## Quick Start (30 seconds)
42
+ ## 30-Second Start
56
43
 
57
44
  ```bash
58
- # Install
59
45
  npm i -g fivocell
60
-
61
- # Setup (one-time, idempotent)
62
46
  cell setup
63
-
64
- # Start daemon
65
47
  cell start
66
-
67
- # Use in any AI tool
68
- # Type @cell in Cursor, Claude Code, Open Code, Antigravity, Codex, or Windsurf
48
+ cell mcp-config
69
49
  ```
70
50
 
71
- That's it. Your AI now has permanent memory.
51
+ Type `@cell` in Cursor, Codex, Antigravity, or any MCP tool. AI gets full project memory.
72
52
 
73
53
  ---
74
54
 
75
- ## How It Works
55
+ ## What Cell Remembers
76
56
 
77
- ```
78
- ┌─────────────────────────────────────────┐
79
- │ Your IDECursor, Claude Code, etc │
80
- │ Chat types @cell │
81
- │ ↓ │
82
- │ AI calls cell_get_context via MCP │
83
- └──────────────┬──────────────────────────┘
84
- JSON-RPC 2.0
85
-
86
- ┌─────────────────────────────────────────┐
87
- │ Cell Daemon (port 9876) │
88
- │ ┌─────────────────────────────────┐ │
89
- │ │ 96 MCP Tools │ │
90
- │ │ Context, Scan, Blind Spots, │ │
91
- │ │ Memory, Session, Branch, etc. │ │
92
- │ └─────────────────────────────────┘ │
93
- │ ┌─────────────────────────────────┐ │
94
- │ │ SQLite DB (100% local) │ │
95
- │ │ ~/.fivo/cell/cell.db │ │
96
- │ └─────────────────────────────────┘ │
97
- └─────────────────────────────────────────┘
98
- ```
99
-
100
- **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.
57
+ | Your AI Tool | Cell Adds |
58
+ |-------------|-----------|
59
+ | Writes code | **Remembers your project** stack, files, architecture |
60
+ | Generates functions | **Knows your style** — quotes, naming, patterns (auto-detected) |
61
+ | Answers questions | **Recalls your decisions** — why you chose PostgreSQL, not Mongo |
62
+ | Opens new chat | **Restores your session** — what you were working on, where you left off |
63
+ | Switches between tools | **Same memory everywhere** — Cursor → Codex → Claude, no loss |
64
+ | Responds generically | **Adapts to your vibe** — your language, your tone, your workflow |
101
65
 
102
66
  ---
103
67
 
104
- ## Why Cell?
105
-
106
- ### vs Cursor Memory
107
- | Feature | Cursor | Cell |
108
- |---------|--------|------|
109
- | Cross-IDE | ❌ Cursor only | ✅ 6+ IDEs |
110
- | Blind spots | ❌ | ✅ 31 rule types |
111
- | Style injection | ❌ | ✅ Auto .cursorrules |
112
- | Session recovery | ❌ | ✅ Resume across tools |
113
- | Memory replay | ❌ | ✅ By topic, time, file |
114
- | Local-first | ❌ Cloud | ✅ 100% local |
115
- | Open source | ❌ | ✅ Apache 2.0 |
116
-
117
- ### vs Claude Memory
118
- | Feature | Claude | Cell |
119
- |---------|--------|------|
120
- | Cross-IDE | ❌ Claude only | ✅ 6+ IDEs |
121
- | Persistent | ❌ Session only | ✅ Permanent |
122
- | Code analysis | ❌ | ✅ AST-based |
123
- | Blind spots | ❌ | ✅ 31 rules |
124
- | Style learning | ❌ | ✅ Auto-detect |
125
- | Local-first | ❌ | ✅ 100% local |
126
-
127
- ### vs GitHub Copilot
128
- | Feature | Copilot | Cell |
129
- |---------|---------|------|
130
- | Context | ❌ Current file only | ✅ Full project |
131
- | Memory | ❌ None | ✅ Permanent |
132
- | Cross-tool | ❌ | ✅ 6+ IDEs |
133
- | Code analysis | ❌ | ✅ AST + patterns |
134
- | Style matching | ❌ | ✅ Auto-detect |
135
- | Open source | ❌ | ✅ Apache 2.0 |
136
-
137
- ### vs Custom .cursorrules
138
- | Feature | .cursorrules | Cell |
139
- |---------|-------------|------|
140
- | Auto-generate | ❌ Manual | ✅ Auto from scan |
141
- | Update | ❌ Manual | ✅ Auto on re-scan |
142
- | Cross-IDE | ❌ | ✅ All tools |
143
- | Blind spots | ❌ | ✅ 31 rules |
144
- | Memory | ❌ | ✅ Permanent |
145
- | Session recovery | ❌ | ✅ Resume |
146
-
147
- **Bottom line:** Other tools give you a chat. Cell gives you a **brain**.
68
+ ## Core Features
148
69
 
149
- ---
70
+ ### 🎯 @cell Context Injection
71
+ 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.
150
72
 
151
- ## Features (What Cell Actually Does)
152
-
153
- ### 🔍 Code Intelligence
154
- - **Blind Spot Scanner** — 31 rule types (async errors, N+1 queries, deep nesting, missing null checks)
155
- - **Style Detection** — Auto-detect quotes, semicolons, naming, indentation, async patterns
156
- - **Knowledge Graph** — File dependencies, blast radius, tech proficiency
157
- - **Project DNA** — Architecture detection, framework identification, conventions
158
-
159
- ### 🧠 Memory System
160
- - **Permanent Memory** — Decisions, errors, fixes, sessions stored in SQLite
161
- - **Session Recovery** — Resume where you left off across tools
162
- - **Memory Replay** — Replay engineering history by topic, time, or file
163
- - **Handoff System** — Current status, completed work, pending tasks
164
-
165
- ### 🔗 Cross-Tool Continuity
166
- - **@cell Context** — Inject full project context into any AI tool
167
- - **6+ IDE Support** — Cursor, Claude Code, Open Code, Antigravity, Codex, Windsurf
168
- - **Same DB** — All tools share one memory
169
- - **Same Watcher** — Filesystem-level, not IDE-level
170
-
171
- ### 📊 Intelligence
172
- - **Predictive Engine** — Repeat mistakes, decision regret, energy warnings
173
- - **CI Integration** — Build status, test results, deploy tracking
174
- - **Branch Context** — Per-branch memory, CI risk correlation
175
- - **Weekly Reports** — Activity breakdown, decisions, errors, fixes
176
-
177
- ### 🛠️ Developer Tools
178
- - **Doctor** — Health check with severity levels (🔴/🟡/✅)
179
- - **Verify** — Data integrity check across all subsystems
180
- - **Focus Report** — Active, stalled, abandoned projects
181
- - **Evolution Map** — Skill progression, project history
182
-
183
- ### 🔒 Privacy
184
- - **100% Local** — Code never leaves your machine
185
- - **No Telemetry** — Zero tracking, zero analytics
186
- - **Apache 2.0** — Free forever, no restrictions
187
- - **Encrypted Storage** — AES-256-GCM for sensitive data
73
+ ### 🧠 Permanent Memory
74
+ Decisions, errors, fixes, patterns — everything stored in local SQLite. Searchable. Replayable. Survives sessions, tools, and time.
188
75
 
189
- ---
76
+ ### 🔍 Blind Spot Scanner
77
+ Automatically detects 15+ code issues: missing null checks, swallowed errors, `any` usage, N+1 queries, deep nesting. Prioritized. Actionable.
78
+
79
+ ### 🎭 Vibe Engine (NEW in v7)
80
+ 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.
81
+
82
+ ### 🔗 Cross-Tool Memory
83
+ Same daemon, same database, same memory. Works with Cursor, Codex, Antigravity, Claude Code, Windsurf, OpenCode, and any MCP client.
84
+
85
+ ### 🌐 Local-First & Private
86
+ Everything runs on your machine. No cloud. No telemetry. No tracking. AES-256-GCM encryption for sensitive data. Apache 2.0 — free forever.
190
87
 
191
- ## Commands Reference
192
-
193
- ### Core (Daily Use)
194
- | Command | What It Does | When |
195
- |---------|-------------|------|
196
- | `cell setup` | One-time project setup | First time only |
197
- | `cell scan` | Analyze codebase | After major changes |
198
- | `cell context` | Get @cell context | Every AI query |
199
- | `cell blindspots` | Show code issues | Before commits |
200
- | `cell watch start` | Track file changes | Always running |
201
- | `cell bridge start` | Connect to IDE | When using IDE |
202
- | `cell continue` | Resume last session | Start of day |
203
- | `cell doctor` | Health check | Weekly |
204
-
205
- ### Memory
206
- | Command | What It Does |
207
- |---------|-------------|
208
- | `cell memory` | Memory stats |
209
- | `cell memory search <query>` | Search memory |
210
- | `cell memory doctor` | Memory health |
211
- | `cell handoff` | View/create handoff |
212
- | `cell replay` | Replay history |
213
-
214
- ### Branch & Team
215
- | Command | What It Does |
216
- |---------|-------------|
217
- | `cell branches` | List branches |
218
- | `cell switch-back <branch>` | Restore branch context |
219
- | `cell lessons` | Engineering lessons |
220
- | `cell team` | Team intelligence |
221
- | `cell community` | Community patterns |
222
-
223
- ### Intelligence
224
- | Command | What It Does |
225
- |---------|-------------|
226
- | `cell predict` | Get warnings |
227
- | `cell evolution` | Project evolution |
228
- | `cell focus` | Active/stalled/abandoned |
229
- | `cell why <topic>` | Search decisions |
88
+ ### 🩺 Health System
89
+ `cell doctor` runs 12 checks across all subsystems. `cell verify` ensures data integrity. Critical issues flagged. Warnings explained. Always know your memory health.
230
90
 
231
91
  ---
232
92
 
233
- ## Supported IDEs
93
+ ## Why Cell vs The Alternatives
234
94
 
235
- | IDE | Status | How to Connect |
236
- |-----|--------|---------------|
237
- | Cursor | | `cell mcp-config` |
238
- | Claude Code | | `cell mcp-config` |
239
- | Open Code | | `cell mcp-config` |
240
- | Antigravity | | `cell mcp-config` |
241
- | Codex | | `cell mcp-config` |
242
- | Windsurf | | `cell mcp-config` |
243
- | VSCode | ⚠️ | Extension available |
95
+ | Problem | AI Tools Alone | With Cell |
96
+ |---------|---------------|-----------|
97
+ | Project context per session | Re-explain every time | Auto-injected |
98
+ | Memory across tools | Each tool isolated | One memory, all tools |
99
+ | Code style consistency | Manual rules files | Auto-detected + injected |
100
+ | Blind spots & risks | Hope AI catches them | Systematic scanner |
101
+ | Session handoff | Lost on tool switch | Seamless bridge |
102
+ | Developer personality | Generic responses | Vibe — adapts to you |
103
+ | Privacy | Cloud-dependent | 100% local |
244
104
 
245
105
  ---
246
106
 
247
- ## Architecture
107
+ ## Quick Commands
248
108
 
249
109
  ```
250
- ~/.fivo/cell/
251
- ├── cell.db — SQLite (all persistent data)
252
- ├── daemon.log — daemon output
253
- ├── daemon.pid process tracking
254
- └── personal/
255
- └── insights/ — saved AI analysis
256
-
257
- .cell/
258
- ├── personal/ profile, style, errors, decisions
259
- ├── team/ — members, shared patterns
260
- ├── community/ — aggregate patterns, benchmarks
261
- ├── memory/
262
- │ ├── archive/ — encrypted long-term storage
263
- │ ├── blobs/ — content-addressed dedup
264
- │ ├── context/ — short, full, last-session
265
- │ ├── patterns/ — code, error, fix, architecture
266
- │ └── summaries/ — daily, weekly, monthly
267
- └── handoff/
268
- ├── current.md — active handoff
269
- └── history/ — past handoffs
110
+ cell setup One-time setup
111
+ cell start Start daemon on localhost:9876
112
+ cell scan Analyze codebase + build intelligence
113
+ cell context View what @cell returns
114
+ cell blindspots Find code issues (--top for quick view)
115
+ cell vibe See your learned personality
116
+ cell teach Tell Cell about yourself
117
+ cell doctor 12-point health check
118
+ cell verify Data integrity check
119
+ cell memory search Search everything Cell remembers
270
120
  ```
271
121
 
272
122
  ---
273
123
 
274
- ## Privacy First
124
+ ## Supported Tools
125
+
126
+ | Tool | Connection | Setup |
127
+ |------|-----------|-------|
128
+ | **Cursor** | MCP | `cell mcp-config` |
129
+ | **Codex** | MCP | `cell mcp-config` |
130
+ | **Antigravity** | MCP | `cell mcp-config` |
131
+ | **Claude Code** | MCP | Manual URL |
132
+ | **Windsurf** | MCP | Manual URL |
133
+ | **OpenCode** | MCP | `cell mcp-config` |
134
+ | **GitHub Copilot** | MCP | Manual URL |
135
+ | **VS Code** | Extension | Install VSIX |
136
+ | **Any MCP Client** | HTTP | `http://localhost:9876/mcp` |
137
+
138
+ ---
139
+
140
+ ## What Users Are Saying
141
+
142
+ > "Finally — I switch between Cursor and Codex all day. Cell keeps my context. I don't explain anything twice anymore."
275
143
 
276
- - **100% local** code never leaves your machine
277
- - **No telemetry** — zero tracking, zero analytics
278
- - **No cloud**all data on your device
279
- - **Apache 2.0** — free forever, no restrictions
280
- - **Encrypted storage** — AES-256-GCM for sensitive data
281
- - **No browser sniffer, clipboard tracking, or keystroke logging** — permanently excluded
144
+ > "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."
145
+
146
+ > "My AI now talks in Hinglish. Not because I asked Cell figured it out from my sessions. The vibe engine is actually magic."
282
147
 
283
148
  ---
284
149
 
285
- ## Community
150
+ ## More Features
286
151
 
287
- - **GitHub:** [github.com/itsvinsoni/fivocell](https://github.com/itsvinsoni/fivocell)
288
- - **npm:** [npmjs.com/package/fivocell](https://www.npmjs.com/package/fivocell)
289
- - **Issues:** [GitHub Issues](https://github.com/itsvinsoni/fivocell/issues)
152
+ 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).
290
153
 
291
154
  ---
292
155
 
293
- ## Contributing
156
+ ## Architecture
294
157
 
295
- 1. Fork the repository
296
- 2. Create your feature branch (`git checkout -b feature/amazing-feature`)
297
- 3. Commit your changes (`git commit -m 'Add amazing feature'`)
298
- 4. Push to the branch (`git push origin feature/amazing-feature`)
299
- 5. Open a Pull Request
158
+ ```
159
+ ~/.fivo/cell/cell.db ← Single SQLite database (64 tables)
160
+ ├── memory_events ← Every edit, decision, error, fix
161
+ ├── sessions ← Work sessions across all tools
162
+ ├── style_profiles ← Auto-detected coding patterns
163
+ ├── code_patterns ← Learned patterns by category
164
+ └── ... (60+ more tables)
165
+
166
+ .cell/ ← Per-project readable files
167
+ ├── vibe/ ← Your learned personality (new in v7)
168
+ ├── memory/ ← Compressed archives + summaries
169
+ └── handoff/ ← Session-to-session context
170
+ ```
300
171
 
301
172
  ---
302
173
 
303
- ## License
174
+ ## Stats
304
175
 
305
- Apache 2.0 — Free forever. No restrictions for individual use.
176
+ ```
177
+ ✅ Build: 0 TypeScript errors
178
+ ✅ Tests: 86 suites, 817/817 passing
179
+ ✅ MCP Tools: 112 registered
180
+ ✅ Lines: 59,000+ production TypeScript
181
+ ✅ Security: 0 vulnerabilities (audited 2026-06-13)
182
+ ```
306
183
 
307
184
  ---
308
185
 
309
- **Git stores code. Cell stores engineering experience.**
186
+ ## Contribute
187
+
188
+ [github.com/itsvinsoni/fivocell](https://github.com/itsvinsoni/fivocell)
189
+
190
+ Apache 2.0. Open issues. PRs welcome.
191
+
192
+ ---
310
193
 
311
- *Your AI forgets. Cell doesn't.* 🚀
194
+ **AI tools come and go. Your project knowledge stays.**
@@ -59,8 +59,8 @@ describe('CLI regression — bin entrypoint', () => {
59
59
  timeout: 10000,
60
60
  });
61
61
  expect(out).toContain('FivoCell');
62
- expect(out).toContain('cell setup');
63
- expect(out).toContain('cell doctor');
62
+ expect(out).toContain('setup');
63
+ expect(out).toContain('doctor');
64
64
  });
65
65
  });
66
66
  describe('CLI regression — setup dynamic requires', () => {
@@ -1 +1 @@
1
- {"version":3,"file":"cli-regression.test.js","sourceRoot":"","sources":["../../src/__tests__/cli-regression.test.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"cli-regression.test.js","sourceRoot":"","sources":["../../src/__tests__/cli-regression.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,uCAAyB;AACzB,2CAA6B;AAC7B,iDAAyC;AAEzC,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAE7D,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjD,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAC;QAC9D,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,GAAG,GAAG,IAAA,wBAAQ,EAAC,SAAS,OAAO,aAAa,EAAE;YAClD,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC;YACrC,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,GAAG,GAAG,IAAA,wBAAQ,EAAC,SAAS,OAAO,QAAQ,EAAE;YAC7C,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC;YACrC,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACvD,IAAI,MAAc,CAAC;IAEnB,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC;YAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,iCAAiC,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC;YAC5B,GAAG,EAAE,MAAM;YACX,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,sBAAsB,CAAC,CAAC;YACvE,WAAW,EAAE,iBAAiB;YAC9B,QAAQ,EAAE,KAAK;YACf,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,iCAAiC,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC;YAC5B,GAAG,EAAE,MAAM;YACX,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC;YACxE,WAAW,EAAE,iBAAiB;YAC9B,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -1,7 +1,7 @@
1
1
  export declare const AGENTS_MD_FILENAME = "AGENTS.md";
2
2
  export declare const CURSORRULES_FILENAME = ".cursorrules";
3
3
  export declare const CELL_RULES_MARKER = "# fivo-cell:rules:v1";
4
- 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";
4
+ 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";
5
5
  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";
6
6
  export interface WriteRulesResult {
7
7
  agentsMd: 'written' | 'exists' | 'skipped';
@@ -1 +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"}
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,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"}
@@ -78,7 +78,24 @@ responding:
78
78
  \`"opencode"\`, not \`"cursor"\`, not \`"antigravity-ide"\`).
79
79
  4. **Use the returned context** to inform your answer — it contains the
80
80
  last session, recent file edits (live events), blind spots, style
81
- hints, predictions, and tried approaches.
81
+ hints, predictions, tried approaches, **session bridge (what just happened)**,
82
+ and **continuity thread (what's been happening across sessions)**.
83
+
84
+ ## Supreme Context: Bridge + Continuity
85
+
86
+ Fivo Cell v7+ maintains **Supreme Context** — AI never starts a session blind:
87
+
88
+ - **🌉 Session Bridge**: Automatically captured at session end. Auto-injected
89
+ at session start. Contains: summary, open questions, failed approaches,
90
+ working approaches, last thought, file focus, vibe snapshot.
91
+ - **🧵 Continuity Thread**: Tracks work across multiple sessions. Knows
92
+ what you're building, open questions, pending actions, key learnings.
93
+ - **🔮 Context Predictions**: Predicts what you'll need — which files,
94
+ which errors may recur, which decisions need revisiting.
95
+
96
+ **The bridge is auto-loaded in every \`@cell\` block.** You don't need to
97
+ ask for it — just read the \`🌉 LAST SESSION BRIDGE\` and \`🧵 CONTINUITY
98
+ THREAD\` sections at the top of the context block and use them.
82
99
 
83
100
  ## Common Cell Tools
84
101
 
@@ -112,6 +129,21 @@ There are 67 cell tools in total. Run \`cell --help\` to see all of them.
112
129
  project, the bridge context is auto-loaded — read it from the @cell
113
130
  block to understand what was just done.
114
131
 
132
+ ## Supreme Context: Never Start Blind
133
+
134
+ Fivo v7 includes **Supreme Context** that auto-injects into every
135
+ \`@cell\` block:
136
+
137
+ - **🌉 Bridge**: Last session's summary, decisions, open questions,
138
+ file focus, failed approaches (don't retry), working approaches
139
+ - **🧵 Continuity Thread**: Cross-session work tracking — what's being
140
+ built, pending actions, key learnings across sessions
141
+ - **🔮 Predictions**: What files you'll need, which errors may recur,
142
+ which decisions need revisiting
143
+
144
+ Read these sections at the top of the context block and you'll
145
+ immediately know what was happening and what to do next.
146
+
115
147
  ## Watcher Awareness
116
148
 
117
149
  - If the watcher is active, the @cell block includes the most recent
@@ -1 +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"}
1
+ {"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"}
@@ -0,0 +1,39 @@
1
+ export interface SessionBridge {
2
+ fromSessionId: number;
3
+ toSessionId?: number;
4
+ capturedAt: string;
5
+ consumedAt?: string;
6
+ consumed: boolean;
7
+ project: string;
8
+ tool: string;
9
+ summary: string;
10
+ status: string;
11
+ filesTouched: string[];
12
+ keyDecisions: string[];
13
+ openQuestions: string[];
14
+ failedApproaches: string[];
15
+ workingApproaches: string[];
16
+ lastThought: string;
17
+ vibeAtCapture: string;
18
+ predictedNextSteps: string[];
19
+ }
20
+ export declare function captureSessionBridge(projectDir: string, params: {
21
+ sessionId: number;
22
+ project: string;
23
+ tool: string;
24
+ summary: string;
25
+ status: string;
26
+ filesTouched: string[];
27
+ keyDecisions: string[];
28
+ openQuestions: string[];
29
+ failedApproaches: string[];
30
+ workingApproaches: string[];
31
+ lastThought: string;
32
+ predictedNextSteps: string[];
33
+ }): SessionBridge;
34
+ export declare function consumeSessionBridge(projectDir: string, currentSessionId: number): SessionBridge | null;
35
+ export declare function peekSessionBridge(projectDir: string): SessionBridge | null;
36
+ export declare function isBridgeStale(projectDir: string): boolean;
37
+ export declare function autoGenerateBridge(projectDir: string, project: string): SessionBridge | null;
38
+ export declare function formatBridgeForContext(bridge: SessionBridge): string;
39
+ //# sourceMappingURL=context-bridge.d.ts.map
@@ -0,0 +1 @@
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"}