crewswarm 0.9.2 → 0.9.4

package/apps/vibe/QUICK-REFERENCE.md

@@ -1,211 +0,0 @@
-# crewswarm Vibe — Quick Reference Card
-
-## Start Vibe
-
-```bash
-npm install
-npm run build
-npm start
-# -> http://127.0.0.1:3333
-```
-
----
-
-## Layout
-
-```
-┌─────────────────────────────────────────────┐
-│ 🐝 crewswarm Vibe            Project Name   │
-├───────┬─────────────────┬───────────────────┤
-│ Files │  Editor (Monaco)│  Chat + Agents    │
-├───────┴─────────────────┴───────────────────┤
-│ Terminal (Agent Activity Logs)              │
-└─────────────────────────────────────────────┘
-```
-
----
-
-## Keyboard Shortcuts
-
-| Key | Action |
-|---|---|
-| **Enter** | Send chat message |
-| **Shift+Enter** | Insert a new line in chat |
-| **⌘+S** | Save file (also auto-saves after 1s) |
-| Click file in tree | Open in editor |
-| Click × on tab | Close file |
-
----
-
-## Agent Status Icons
-
-| Icon | Meaning |
-|---|---|
-| 🟢 | Online |
-| ⚡ | Working |
-| ✅ | Complete |
-| 🔴 | Error |
-
----
-
-## Terminal Log Colors
-
-| Color | Type |
-|---|---|
-| Cyan | Info |
-| Green | Success |
-| Red | Error |
-| Orange | Warning |
-
----
-
-## Workflow
-
-1. **Open file** → Click in file tree
-2. **Edit** → Type in Monaco editor
-3. **Save** → Auto-saves (or ⌘+S)
-4. **Run Codex** → Switch mode to `cli:codex`, type a task, press Enter
-5. **Watch progress** → Terminal shows RT updates
-
----
-
-## Connections
-
-Always local:
-- **Vibe** (:3333) — projects, file IO, local `cli:codex`
-
-Optional shared services:
-- **Dashboard** (:4319) — auth, agents, crew-lead passthrough
-- **crew-lead** (:5010) — shared chat backend
-- **RT Bus** (:18889) — agent activity
-
----
-
-## File Structure
-
-```
-apps/vibe/
-├── index.html       # UI layout
-├── src/main.js      # All logic
-├── vite.config.js   # Dev server
-└── server.mjs       # Prod server
-```
-
----
-
-## Commands
-
-```bash
-# Dev mode
-npm run dev
-
-# Production build
-npm run build
-
-# Production server
-npm start
-
-# Smoke test
-npm test
-```
-
----
-
-## Troubleshooting
-
-**Vibe won't start?**
-```bash
-cd apps/vibe
-rm -rf node_modules
-npm install
-npm run dev
-```
-
-**Codex mode not working?**
-- Check Codex CLI: `codex --help`
-- Use `cli:codex` for standalone local coding
-
-**Terminal not acting like a full shell?**
-- The bottom terminal opens a real local shell for the selected project
-- It still is not a full PTY-backed terminal emulator, so use an external terminal for heavy TUI workflows
-- Use `cli:codex` for real local file-changing execution
-
-**RT bus disconnected?**
-- Check RT daemon: `ps aux | grep "rt-daemon"`
-
-**File tree empty?**
-- Check the selected project path exists
-- Check local server: `curl http://127.0.0.1:3333/api/studio/projects`
-
----
-
-## Ports
-
-| Service | Port |
-|---|---|
-| Vibe | 3333 |
-| Dashboard | 4319 |
-| crew-lead | 5010 |
-| RT Bus | 18889 |
-
----
-
-## Docs
-
-- `README.md`
-- `ARCHITECTURE.md`
-- `VISUAL-GUIDE.md`
-
----
-
-## Phase Status
-
-**Local Core (Complete):**
-- ✅ Monaco editor
-- ✅ Local project persistence
-- ✅ Real file operations
-- ✅ Local `cli:codex` execution
-- ✅ Smoke test coverage
-
-**Still shared / optional:**
-- 🔄 crew-lead chat
-- 🔄 broader agent routing
-- 🔄 RT activity from the full crewswarm stack
-
----
-
-## Quick Tips
-
-- **File not saving?** Check terminal for the save error line and confirm the file is inside the selected project directory
-- **Want dark theme?** Already using vs-dark (Monaco default)
-- **Multiple tabs?** Click files to open, × to close
-- **Agent not responding?** Check dashboard → Agents tab for status
-- **Customize layout?** Edit `apps/vibe/index.html` CSS grid
-
----
-
-## Example Chat
-
-```
-You: Add validation to the login form
-
-Mode: cli:codex
-
-[Terminal]
-[14:30:00] fake codex started
-[14:30:05] fake codex finished
-
-codex: wrote files in the project directory
-```
-
----
-
-**Built with:** Monaco • Vite • local HTTP server • Codex CLI  
-**License:** MIT  
-**Version:** 1.0.0
-
----
-
-**Need help?** Open GitHub issue with `[Vibe]` tag.
-
-**Enjoy!** 🐝✨

package/apps/vibe/ROADMAP.md

@@ -1,41 +0,0 @@
-# crewswarm vibe — ROADMAP
-
-## Phase 1: Core IDE ✅
-- [x] Monaco editor integration
-- [x] File tree navigation
-- [x] Chat with agents (crew-lead, direct agents, CLI bypass)
-- [x] Project selection
-- [x] Authentication (Bearer token)
-- [x] CORS fixes for Vibe ↔ Dashboard ↔ crew-lead
-
-## Phase 2: Advanced Features 🔄
-- [x] Cmd+K inline chat overlay  ✓ 12:50:06 AM (crew-coder-front)
-- [x] Diff preview modal for agent changes AM  ✓ 1:20:18 AM (crew-coder-front)
-- [x] File content loading from local Studio server  ✓ 1:22:32 AM (crew-coder-front)
-- [x] Terminal integration (bottom panel) AM  ✓ 1:28:52 AM (crew-fixer)
-- [x] Settings panel (link to main dashboard)  ✓ 1:31:55 AM (crew-coder-front)
-- [x] Change from studio to vibe (only in the UI and docs; directory and runtime names unchanged)
-
-
-## Phase 3: Polish 📋
-- [x] All panels adjustable / resize the views AM  ✓ 2:55:51 AM (crew-fixer)
-- [x] Syntax highlighting for the bundled Monaco language set (`css`, `html`, `javascript`, `markdown`, `python`, `typescript`)
-- [x] Dark/light theme toggle AM AM  ✓ 3:21:24 AM (crew-fixer)
-- [x] Keyboard shortcuts guide AM  ✓ 3:25:51 AM (crew-coder-front)
-- [x] Performance optimization AM AM PM PM  ✓ 1:19:08 AM (crew-coder-back)
-- [x] Error handling improvements PM PM  ✓ 1:24:08 AM (crew-coder-back)
-
-## Notes
-- All CORS issues resolved (wildcard headers)
-- Local Studio API working: `/api/studio/projects`, `/api/studio/files`, `/api/studio/file-content`
-- crew-lead chat working: `/chat` with Bearer auth
-- Vibe port: 3333, Dashboard: 4319, crew-lead: 5010
-
----
-
-## PM-Generated (Round 1)
-
-- [x] Add a color contrast analyzer tool to the project to ensure that the color schemes used in the application meet the latest accessibility standards and provide a good user experience for users with visual impairments. PM PM  ✓ 1:30:42 AM (crew-coder-back)
-- [x] Implement a comprehensive testing framework that includes automated tests for accessibility, performance, and security to ensure that the application is robust, reliable, and meets the latest web development trends and best practices. PM PM  ✓ 1:35:44 AM (crew-coder-back)
-
-

package/apps/vibe/STUDIO-SETUP-COMPLETE.md

@@ -1,35 +0,0 @@
-# Vibe Setup Complete
-
-## Quick Start
-
-```bash
-cd apps/vibe
-bash start-studio.sh
-```
-
-Open `http://127.0.0.1:3333`.
-
-## Manual Start
-
-```bash
-cd apps/vibe
-npm install
-npm run build
-npm start
-```
-
-## Verification
-
-```bash
-npm test
-npm run test:e2e
-```
-
-- `npm test` runs the local smoke, accessibility, performance, and security checks.
-- `npm run test:e2e` runs a self-contained local HTTP/API end-to-end check for the shipped Vibe server and bundle.
-
-## Notes
-
-- `cli:codex` is the standalone local CLI path.
-- Shared dashboard and agent routing features still depend on the broader crewswarm stack.
-- Built assets are served from `dist/`.

package/apps/vibe/VISUAL-GUIDE.md

@@ -1,378 +0,0 @@
-# CrewSwarm Vibe — Visual Guide
-
-## Vibe Layout
-
-```
-┌──────────────────────────────────────────────────────────────────────────────┐
-│ 🐝 CrewSwarm Vibe                                        my-todo-app         │
-├─────────────┬────────────────────────────────┬────────────────────────────────┤
-│             │                                │                                │
-│  EXPLORER   │     MONACO EDITOR              │     CHAT WITH AGENTS          │
-│             │                                │                                │
-│  📁 src/    │  function TodoApp() {          │ 🟢 crew-lead                  │
-│  ├─ 📄 app.js│    const [todos, setTodos]   │ ⚡ crew-coder                  │
-│  ├─ 📄 api.js│      = useState([]);         │ 🔵 crew-qa                     │
-│  └─ 📁 comp/│                               │                                │
-│  📝 README  │    return (                    │ ────────────────────────       │
-│  📦 package │      <div className="app">   │                                │
-│             │        <h1>Todo App</h1>      │ You:                           │
-│             │        {todos.map(todo =>     │ Add input validation for       │
-│             │          <TodoItem            │ the todo form                  │
-│             │            key={todo.id}      │                                │
-│             │            todo={todo}        │ crew-lead:                     │
-│             │          />                   │ I'll have crew-coder add       │
-│             │        )}                     │ validation for you.            │
-│             │      </div>                   │                                │
-│             │    );                         │ [14:32] ⚡ Dispatching to      │
-│             │  }                            │ crew-coder...                  │
-│             │                                │                                │
-│             │  export default TodoApp;      │ crew-coder:                    │
-│             │                                │ ✅ Added validation to         │
-│             │                                │ src/TodoForm.jsx:              │
-│             │                                │ • Required field check         │
-│             │                                │ • Max length 100 chars         │
-│             │                                │ • No empty strings             │
-│             │                                │                                │
-│             │                                │ ┌─────────────────────────┐   │
-│             │                                │ │ Ask the crew anything...│   │
-│             │                                │ │ (⌘+Enter to send)       │   │
-│             │                                │ └─────────────────────────┘   │
-├─────────────┴────────────────────────────────┴────────────────────────────────┤
-│ TERMINAL / AGENT OUTPUT                                                       │
-│                                                                                │
-│ [14:32:05] 🔗 Connected to RT message bus                                     │
-│ [14:32:15] ⚡ crew-coder started working on task                              │
-│ [14:32:16] 🔧 crew-coder → write_file src/TodoForm.jsx                        │
-│ [14:32:17] 🔧 crew-coder → write_file src/validation.js                       │
-│ [14:32:18] ✅ crew-coder completed task                                       │
-│ [14:32:19] 💾 Saved src/TodoForm.jsx                                          │
-│                                                                                │
-└────────────────────────────────────────────────────────────────────────────────┘
-```
-
----
-
-## Color Scheme (vs-dark theme)
-
-```css
-Background:     #1e1e1e  (main editor)
-Sidebar:        #252526  (file tree, chat)
-Titlebar:       #323233
-Borders:        #181818
-Text:           #d4d4d4
-Active tab:     #1e1e1e
-Inactive tab:   #2d2d30
-User message:   #0e639c (blue bubble)
-Agent message:  #2d2d30 (gray bubble)
-Success:        #81c784 (green)
-Error:          #e57373 (red)
-Info:           #4fc3f7 (cyan)
-Warning:        #ffb74d (orange)
-```
-
----
-
-## Key UI Elements
-
-### 1. Titlebar
-```
-┌──────────────────────────────────────────────────────┐
-│ 🐝 CrewSwarm Vibe            my-todo-app             │
-└──────────────────────────────────────────────────────┘
-     ↑ Logo              ↑ Project name (right aligned)
-```
-
-### 2. File Tree
-```
-EXPLORER
-
-📁 src/
-├─ 📄 app.js       ← Click to open
-├─ 📄 api.js
-└─ 📁 components/
-   ├─ 📄 TodoItem.jsx
-   └─ 📄 TodoForm.jsx
-📝 README.md
-📦 package.json
-```
-
-**States:**
-- Regular: `📄 app.js`
-- Active: `📄 app.js` (highlighted bg: #37373d)
-- Hover: `📄 app.js` (subtle highlight)
-
-### 3. Editor Tabs
-```
-┌───────────┬───────────┬───────────┐
-│ app.js ×  │ api.js ×  │ README ×  │
-└───────────┴───────────┴───────────┘
-    ↑ active    ↑ inactive   ↑ inactive
-```
-
-**Active tab:**
-- Background: #1e1e1e
-- Text: #fff
-
-**Inactive tab:**
-- Background: transparent
-- Text: #969696
-
-### 4. Chat Panel
-```
-┌─────────────────────────────────┐
-│ Chat with Agents                │ ← Header
-├─────────────────────────────────┤
-│ 🟢 crew-lead                    │ ← Status indicators
-│ ⚡ crew-coder                    │
-│ 🔵 crew-qa                       │
-├─────────────────────────────────┤
-│                                 │
-│ [Chat messages scroll here]    │
-│                                 │
-├─────────────────────────────────┤
-│ ┌─────────────────────────────┐ │
-│ │ Ask the crew anything...    │ │ ← Input (⌘+Enter)
-│ │                             │ │
-│ └─────────────────────────────┘ │
-└─────────────────────────────────┘
-```
-
-**Status indicators:**
-- 🟢 Green = online/available
-- ⚡ Yellow = working on task
-- 🔵 Blue = ready
-- 🔴 Red = error/offline
-
-### 5. Terminal
-```
-┌────────────────────────────────────────────────┐
-│ Agent Output                           [Clear] │ ← Header
-├────────────────────────────────────────────────┤
-│ [14:32:15] ⚡ crew-coder started working       │ ← Info (cyan)
-│ [14:32:18] ✅ crew-coder completed task        │ ← Success (green)
-│ [14:32:19] 💾 Saved src/TodoForm.jsx           │ ← Success (green)
-│ [14:32:20] ❌ Failed to save config.json       │ ← Error (red)
-└────────────────────────────────────────────────┘
-```
-
-**Log colors:**
-- Info: #4fc3f7
-- Success: #81c784
-- Error: #e57373
-- Warning: #ffb74d
-
----
-
-## Responsive Behavior
-
-### Desktop (1920×1080)
-```
-File Tree: 250px
-Editor: flex (grows)
-Chat: 350px
-Terminal: 200px
-```
-
-### Laptop (1440×900)
-```
-File Tree: 200px
-Editor: flex (grows)
-Chat: 300px
-Terminal: 180px
-```
-
-### Tablet (1024×768)
-```
-File Tree: Collapsible (hidden by default)
-Editor: Full width
-Chat: Overlay (slides in from right)
-Terminal: 150px
-```
-
----
-
-## Interactions
-
-### File Tree
-- **Click file** → Opens in editor
-- **Hover file** → Slight highlight
-- **Active file** → Bold + highlight
-
-### Editor
-- **Type** → Auto-saves after 1s
-- **⌘+S** → Immediate save
-- **Tab close (×)** → Removes tab, switches to previous
-
-### Chat
-- **Type** → Input grows (max 3 lines)
-- **⌘+Enter** → Sends message
-- **Messages** → Auto-scroll to bottom
-- **Agent bubbles** → Different colors per role
-
-### Terminal
-- **New event** → Auto-scrolls to bottom
-- **Scroll up** → Pauses auto-scroll
-- **Scroll to bottom** → Re-enables auto-scroll
-
----
-
-## Monaco Editor Features
-
-**Built-in:**
-- ✅ Syntax highlighting (50+ languages)
-- ✅ Auto-completion (basic)
-- ✅ Find/replace
-- ✅ Minimap
-- ✅ Line numbers
-- ✅ Code folding
-- ✅ Multi-cursor (⌥+Click)
-- ✅ Bracket matching
-
-**Coming soon:**
-- 🔄 IntelliSense (full)
-- 🔄 Git diff indicators (green/red bars)
-- 🔄 Error squiggles (from linter)
-- 🔄 Inline agent suggestions
-
----
-
-## Agent Status Icons
-
-```
-🟢 Online       Agent ready to receive tasks
-⚡ Working      Agent actively processing
-✅ Complete     Agent finished task
-🔵 Idle         Agent available but not active
-🔴 Error        Agent encountered error
-⏸️ Paused       Agent temporarily disabled
-🔄 Restarting   Agent reloading
-```
-
----
-
-## Example Workflows
-
-### Workflow 1: Open File + Edit
-```
-1. Click "src/app.js" in file tree
-   → File opens in editor
-   → Tab appears at top
-
-2. Type changes in editor
-   → Auto-saves after 1s
-   → Terminal shows: "💾 Saved src/app.js"
-
-3. Click "×" on tab to close
-   → File closes
-   → Switches to previous tab
-```
-
-### Workflow 2: Ask Agent to Edit
-```
-1. Type in chat: "Add error handling to api.js"
-   → Press ⌘+Enter
-
-2. crew-lead responds:
-   "I'll have crew-coder add that for you."
-
-3. Terminal shows:
-   [14:45:00] ⚡ crew-coder started working
-   [14:45:05] 🔧 crew-coder → write_file src/api.js
-   [14:45:06] ✅ crew-coder completed task
-
-4. File tree: "api.js" changes appear
-   → Click to open and review
-```
-
-### Workflow 3: Multi-Agent Pipeline
-```
-1. Type: "Build a login page with tests"
-
-2. crew-lead coordinates:
-   ⚡ Dispatching to crew-coder-front...
-   ⚡ Dispatching to crew-qa...
-
-3. Terminal shows both agents working:
-   [15:00:00] ⚡ crew-coder-front started
-   [15:00:15] ✅ crew-coder-front completed
-   [15:00:16] ⚡ crew-qa started
-   [15:00:30] ✅ crew-qa completed
-
-4. Result:
-   ✅ Created src/LoginPage.jsx
-   ✅ Created tests/login.test.js
-```
-
----
-
-## Keyboard Shortcuts (Future)
-
-| Shortcut | Action |
-|---|---|
-| ⌘+S | Save current file |
-| ⌘+P | Quick file picker |
-| ⌘+K | Focus chat input |
-| ⌘+J | Toggle terminal |
-| ⌘+B | Toggle file tree |
-| ⌘+Enter | Send chat message |
-| ⌘+W | Close current tab |
-| ⌘+Shift+P | Command palette |
-| ⌘+/ | Toggle comment |
-| ⌘+F | Find in file |
-
----
-
-## Comparison to Cursor
-
-| Feature | Cursor | Vibe |
-|---|---|---|
-| File editing | ✅ Full IDE | ✅ Monaco |
-| Agent chat | ✅ Inline + panel | ✅ Side panel |
-| File tree | ✅ Full features | ✅ Basic (Phase 1) |
-| Terminal | ✅ Full shell | ✅ Agent logs only |
-| Git | ✅ Built-in | 🔄 Future |
-| Extensions | ✅ VSCode ecosystem | ❌ Not yet |
-| Themes | ✅ Full customization | ✅ vs-dark (default) |
-| Multi-agent | ❌ Single agent | ✅ 20 agents |
-| Real-time updates | ⚠️ Polling | ✅ WebSocket |
-
-**Vibe's differentiator:** Real-time multi-agent coordination with visible progress. Cursor is better as a full IDE, Vibe is better for swarm workflows.
-
----
-
-## Screenshots (Conceptual)
-
-**Main view:**
-```
-┌────────────────────────────────────────────────┐
-│ FILE TREE     │   EDITOR     │   CHAT         │
-│               │              │                │
-│ Click files   │ Code here    │ Talk to agents│
-└────────────────────────────────────────────────┘
-                   │ TERMINAL (agent activity)  │
-                   └────────────────────────────┘
-```
-
-**Chat conversation:**
-```
-You: Add validation
-
-crew-lead: Sure! Dispatching to crew-coder...
-
-crew-coder: ✅ Added validation.js
-            • Required field check
-            • Email format validation
-            • Password strength check
-```
-
-**Terminal activity:**
-```
-[14:32:15] 🔗 Connected to RT bus
-[14:32:20] ⚡ crew-coder started task
-[14:32:25] 🔧 crew-coder → write_file
-[14:32:26] ✅ crew-coder completed task
-```
-
----
-
-**Next:** See [`STUDIO-SETUP-COMPLETE.md`](./STUDIO-SETUP-COMPLETE.md) in this folder for local setup, verification, and usage.