loki-mode 6.40.0 → 6.42.0

package/SKILL.md

@@ -3,7 +3,7 @@ name: loki-mode
 description: Multi-agent autonomous startup system. Triggers on "Loki Mode". Takes PRD to deployed product with minimal human intervention. Requires --dangerously-skip-permissions flag.
 ---
 
-# Loki Mode v6.40.0
+# Loki Mode v6.42.0
 
 **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
 
@@ -267,4 +267,4 @@ The following features are documented in skill modules but not yet fully automat
 | Quality gates 3-reviewer system | Implemented (v5.35.0) | 5 specialist reviewers in `skills/quality-gates.md`; execution in run.sh |
 | Benchmarks (HumanEval, SWE-bench) | Infrastructure only | Runner scripts and datasets exist in `benchmarks/`; no published results |
 
-**v6.40.0 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**
+**v6.42.0 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**

package/VERSION

@@ -1 +1 @@
-6.40.0
+6.42.0

package/autonomy/loki

@@ -3171,6 +3171,13 @@ cmd_web_stop() {
     local port
     port=$(cat "${LOKI_DIR}/purple-lab/port" 2>/dev/null || echo "$PURPLE_LAB_DEFAULT_PORT")
 
+    # Gracefully stop any active session before killing Purple Lab
+    curl -s --max-time 3 -X POST "http://127.0.0.1:${port}/api/session/stop" >/dev/null 2>&1 || true
+    sleep 1
+
+    # Kill any orphaned loki-run processes (belt-and-suspenders)
+    pkill -f "loki-run-" 2>/dev/null || true
+
     # Try PID file first
     if [ -f "$PURPLE_LAB_PID_FILE" ]; then
         local pid

package/dashboard/__init__.py

@@ -7,7 +7,7 @@ Modules:
     control: Session control API (start/stop/pause/resume)
 """
 
-__version__ = "6.40.0"
+__version__ = "6.42.0"
 
 # Expose the control app for easy import
 try:

package/docs/INSTALLATION.md

@@ -2,7 +2,7 @@
 
 The flagship product of [Autonomi](https://www.autonomi.dev/). Complete installation instructions for all platforms and use cases.
 
-**Version:** v6.40.0
+**Version:** v6.42.0
 
 ---
 

package/docs/prd-purple-lab-ide.md

@@ -0,0 +1,152 @@
+# PRD: Purple Lab Full IDE Experience
+
+## Overview
+
+Transform Purple Lab from a basic file viewer into a production-grade fullstack IDE comparable to Replit, Lovable, and Bolt. Users should be able to build a project via PRD, then immediately browse, edit, preview, and iterate on the output -- all within the browser.
+
+## Target Users
+
+- Developers using Loki Mode to generate projects from PRDs
+- Non-technical founders using Purple Lab as their primary development environment
+- Teams evaluating Loki Mode for autonomous development workflows
+
+## Current State (v6.39.0)
+
+- React Router with `/project/:sessionId` URLs
+- File tree sidebar with collapsible directories
+- Code viewer with line numbers (read-only)
+- Live preview via iframe serving real files with correct MIME types
+- Session state persists across refresh
+- WebSocket real-time log streaming during builds
+
+## Requirements
+
+### P0 -- Must Have
+
+#### Monaco Editor Integration
+- Replace the read-only code viewer with Monaco Editor (VS Code's editor)
+- Syntax highlighting for all major languages (JS, TS, Python, HTML, CSS, JSON, MD, Go, Rust)
+- Read-only mode by default, editable when user clicks "Edit" button
+- File save via `PUT /api/sessions/:id/file?path=` endpoint
+- Keyboard shortcut: Cmd/Ctrl+S to save
+- Show unsaved changes indicator (dot on tab)
+
+#### Resizable Split Panes
+- Three-pane layout: file tree | editor | preview
+- Drag handles between panes to resize
+- Pane sizes persist to localStorage
+- Collapse/expand each pane via toggle buttons
+- Minimum widths: file tree 180px, editor 300px, preview 300px
+
+#### Integrated Terminal
+- xterm.js terminal emulator in a bottom panel
+- WebSocket-connected to backend for real-time output
+- Resizable height (drag handle)
+- Support for ANSI color codes
+- Show build output, loki logs, and allow running commands in project directory
+- Toggle with Cmd/Ctrl+` keyboard shortcut
+
+#### File Operations
+- Create new file (right-click context menu or button)
+- Create new directory
+- Rename file/directory (inline edit)
+- Delete file/directory (with confirmation)
+- All operations via REST API with path traversal protection
+
+### P1 -- Should Have
+
+#### Tab System
+- Open multiple files in tabs
+- Close tabs (with unsaved changes warning)
+- Tab reordering via drag
+- "Close All" and "Close Others" context menu
+- Active tab highlighted
+
+#### Search
+- Cmd/Ctrl+P: fuzzy file search (like VS Code quick open)
+- Cmd/Ctrl+Shift+F: search across all files in project
+- Search results panel with file + line previews
+- Click result to open file at line
+
+#### Preview Enhancements
+- URL bar showing current preview path
+- Back/forward navigation buttons
+- Refresh button
+- Open in new tab button
+- Console panel showing preview JS errors (via postMessage from sandboxed iframe)
+- Auto-refresh on file save
+
+### P2 -- Nice to Have
+
+#### Git Integration
+- Show git status in file tree (modified, added, untracked)
+- Diff view for modified files
+- Commit from UI
+- Branch indicator in header
+
+#### AI Chat Panel
+- Side panel for chat with Claude about the project
+- Context-aware: knows which file is open, what project is about
+- "Fix this" button on error highlights
+- "Explain" button on selected code
+
+#### Deployment
+- "Deploy" button that runs loki deploy
+- Deploy status indicator
+- Preview deployed URL
+
+## Technical Architecture
+
+### Frontend
+- React 19 + TypeScript + Tailwind CSS (existing stack)
+- Monaco Editor: `@monaco-editor/react` package
+- xterm.js: `@xterm/xterm` + `@xterm/addon-fit` + `@xterm/addon-web-links`
+- Split panes: custom implementation with CSS resize or `react-resizable-panels`
+- File operations: REST API calls to new CRUD endpoints
+
+### Backend (web-app/server.py)
+- `PUT /api/sessions/:id/file?path=` -- save file content
+- `POST /api/sessions/:id/file` -- create new file
+- `DELETE /api/sessions/:id/file?path=` -- delete file
+- `POST /api/sessions/:id/directory` -- create directory
+- `POST /api/sessions/:id/rename` -- rename file/directory
+- `GET /api/sessions/:id/search?q=&glob=` -- search files
+- WebSocket terminal: `/ws/terminal/:id` -- PTY-backed terminal session
+
+### Security
+- All file operations scoped to project directory (path traversal protection)
+- File size limits on saves (1MB)
+- Rate limiting on file operations
+- No shell injection in terminal (PTY spawns bash in project dir only)
+- Preview iframe sandboxed
+
+## Success Criteria
+
+- User can build a project via PRD, then immediately edit files and see preview update
+- Preview loads all relative assets (CSS, JS, images) correctly
+- Terminal shows real-time build output and allows running commands
+- All operations work without page refresh
+- Performance: file tree renders 1000+ files without freezing
+- Mobile: graceful degradation (single-pane view)
+
+## Non-Goals
+
+- Multi-user collaboration (Google Docs style)
+- Version control UI beyond basic git status
+- Package manager integration (npm/pip install from UI)
+- Database management UI
+- Cloud deployment orchestration
+
+## Timeline
+
+- P0: 2-3 days focused development
+- P1: 2 days
+- P2: Future sprints
+
+## References
+
+- Replit: https://replit.com
+- Lovable: https://lovable.dev
+- Bolt: https://bolt.new
+- Monaco Editor: https://microsoft.github.io/monaco-editor/
+- xterm.js: https://xtermjs.org/

package/docs/prd-purple-lab-platform-v2.md

@@ -0,0 +1,223 @@
+# PRD: Purple Lab Platform v2 -- Hosted Autonomous Development IDE
+## Post-Feedback Final Plan (3 review loops completed)
+
+---
+
+## Feedback Applied
+
+Three review loops identified these critical gaps in v1 of this PRD:
+1. **Product review:** Missing deployment, secrets, import project, issue-driven workflow; `loki plan` should be default; timeline unrealistic
+2. **Engineering review:** Only 2 pages exist today; sidebar/navigation is the foundational gap; Phase 1 needs auth to work as hosted platform
+3. **Competitive review:** Bottom activity panel is on wrong page; AI Chat is missing entirely; platform feels 40% done -- needs structural work before features
+
+---
+
+## Current State (v6.41.0) -- Honest Assessment
+
+**Working:**
+- Monaco editor with syntax highlighting (17+ languages)
+- File tree with CRUD (create, save, delete files/dirs)
+- Tabs with unsaved indicator, Cmd+S save
+- Quick Open (Cmd+P) fuzzy file search
+- Live preview iframe with auto-refresh on save
+- Resizable split panes
+- URL routing (/project/:id persists on refresh)
+- Session history with status detection
+- WebSocket real-time streaming during builds
+- Error boundaries on all panels
+
+**Not working / missing:**
+- NO sidebar navigation (users stuck in IDE, can't browse projects)
+- NO projects list page
+- NO templates gallery page
+- NO settings page
+- NO AI chat (can't iterate by talking to agents)
+- Bottom activity panel (agents, quality gates, build output) only on HomePage, NOT in IDE workspace
+- NO deployment capability
+- NO secrets management
+- NO import project flow
+- Preview has no URL bar, back/forward, or open-in-new-tab
+
+---
+
+## Revised Architecture
+
+### Phase 1: Platform Shell + Navigation (buildable now)
+**Goal:** Make Purple Lab feel like a real platform, not a disconnected prototype.
+
+**1a. Global Sidebar (all pages)**
+- Logo + "Purple Lab" branding
+- Nav items: Home, Projects, Templates, Settings
+- Active page highlight
+- Connection status indicator
+- Bottom: Docs link, version
+
+**1b. Projects Page (/projects)**
+- Card grid from `/api/sessions/history` (already returns status, file count, PRD snippet)
+- Search bar, status filter (completed/started/empty)
+- Actions per card: Open, Delete, Export as zip
+- Empty state: "No projects yet. Start building."
+
+**1c. Templates Gallery (/templates)**
+- Card grid from `/api/templates` (22 templates, already served)
+- Category badges: Simple (green), Standard (blue), Complex (orange)
+- Click -> pre-fills PRD on home page, user confirms and builds
+- Template preview (show first 10 lines of PRD content)
+
+**1d. Fix Workspace Navigation**
+- Add sidebar to ProjectPage (same sidebar as all pages)
+- Add breadcrumb: Projects > project-name
+- Back button navigates to /projects (not just /)
+
+**Files to create/modify:**
+- NEW: `web-app/src/components/Sidebar.tsx`
+- NEW: `web-app/src/pages/ProjectsPage.tsx`
+- NEW: `web-app/src/pages/TemplatesPage.tsx`
+- NEW: `web-app/src/pages/SettingsPage.tsx` (shell)
+- MODIFY: `web-app/src/App.tsx` (add routes, wrap in sidebar layout)
+- MODIFY: `web-app/src/pages/ProjectPage.tsx` (add sidebar)
+
+---
+
+### Phase 2: Enhanced Workspace (buildable now)
+**Goal:** Bring the monitoring panels into the IDE and add AI chat.
+
+**2a. Bottom Activity Panel in ProjectWorkspace**
+Tabbed panel below the editor (collapsible, resizable height):
+- **Build Log:** Real-time loki output (WebSocket, already works on HomePage)
+- **Agents:** Active agent cards with status (already built as AgentDashboard)
+- **Quality Gates:** 9-gate display (already built as QualityGatesPanel)
+- **AI Chat:** NEW -- text input that sends prompts to iterate on the project
+
+**2b. AI Chat (key differentiator)**
+- Input at bottom: "Make the header blue" or "Add user authentication"
+- Backend: `POST /api/sessions/:id/chat` which runs `loki quick "<prompt>"` in the project directory
+- Output streams to Build Log tab
+- File tree refreshes after completion
+- Preview auto-refreshes
+
+**2c. Mode Selector**
+In workspace header toolbar:
+- Quick (fast, 3 iterations) -- `loki quick`
+- Standard (full RARV, 5 iterations) -- `loki start`
+- Max (extended, 8+ iterations) -- `loki start --complexity complex`
+
+**2d. Plan Before Build**
+Default behavior: when user submits a PRD, run `loki plan` first.
+Show: complexity tier, estimated cost, iteration count, phases.
+User confirms "Build" or adjusts.
+
+**2e. Preview Toolbar**
+URL bar showing current preview path, Refresh button, Open in New Tab button.
+
+**Files to create/modify:**
+- NEW: `web-app/src/components/ActivityPanel.tsx` (bottom tabs: Build Log, Agents, Quality, Chat)
+- NEW: `web-app/src/components/AIChatPanel.tsx`
+- NEW: `web-app/src/components/PreviewToolbar.tsx`
+- MODIFY: `web-app/src/components/ProjectWorkspace.tsx` (add bottom panel, mode selector)
+- MODIFY: `web-app/server.py` (add POST /api/sessions/:id/chat endpoint)
+
+---
+
+### Phase 3: Import + Deploy + Secrets (needs backend work)
+**Goal:** Close the loop -- users can bring code in and ship code out.
+
+**3a. Import Project**
+- "Import from GitHub" button on Projects page
+- Backend: clone repo, run `loki onboard` to analyze, generate CLAUDE.md
+- User lands in IDE with file tree populated
+- Uses `loki explain` to show architecture summary on first open
+
+**3b. Deploy to Public URL**
+- "Deploy" button in workspace header
+- Backend: build the project (npm build / python build), serve on a public URL
+- URL format: `{project-id}.purplelab.dev` (or subdomain on autonomi.dev)
+- Show deployment status and live URL
+- Uses Docker container already present in workspace
+
+**3c. Secrets / Environment Variables**
+- Per-project secrets pane in workspace settings
+- Stored encrypted, injected into build container as env vars
+- UI: key-value editor with show/hide toggle
+- Uses existing `loki secrets` CLI command
+
+**3d. Cost Tracking**
+- Visible in workspace header: current session cost estimate
+- Uses existing `/api/cost` and `/api/budget` endpoints
+- Budget limit warning when approaching threshold
+
+---
+
+### Phase 4: Hosted Infrastructure (requires infra work)
+**Goal:** Multi-tenant hosted platform with user isolation.
+
+- Per-user container orchestration (Docker or Firecracker)
+- Persistent storage per workspace
+- User auth (email + OAuth via existing OIDC support)
+- Usage metering and billing
+- Custom preview domains
+- Provider failover (`loki failover`) for platform uptime
+
+---
+
+## What to Cut from v1
+
+Based on feedback:
+- Memory System Viewer (power-user debug tool, not customer-facing)
+- Full Integrations page (keep GitHub only, defer Jira/Linear/Slack/Teams)
+- 41-agent grid (most sessions have 1-3 agents active; show compact list instead)
+- Code Review panel (let quality gates surface findings inline)
+- Collaboration/multiplayer (acknowledged as future need, not v1)
+- Database provisioning (out of scope for v1)
+
+---
+
+## What to Fix Before Building (bugs from competitive review)
+
+1. Preview only auto-refreshes on HTML/CSS/JS saves (not .py or .json)
+2. Quick Open should show all results with scrolling (remove slice(0,20) limit)
+3. File creation should optimistically update tree (no wait for API)
+4. ProjectWorkspace should be read-only for completed sessions
+5. No-HTML projects should show helpful message instead of blank preview
+
+---
+
+## Loki Features to Surface (under-leveraged)
+
+| Feature | Where in UI | Backend |
+|---------|-------------|---------|
+| `loki plan` | Plan step before every build | Exists |
+| `loki run <issue>` | "Import from Issue" on Home page | Exists |
+| `loki review` | Right-click file -> "Review this file" | Exists |
+| `loki test` | Right-click file -> "Generate tests" | Exists |
+| `loki explain` | "Explain Project" button in workspace | Exists |
+| `loki onboard` | Import project flow | Exists |
+| `loki failover` | Auto-provider switching | Exists |
+| `loki trigger` | Scheduled builds (cron) | Exists |
+| `loki ci` | Quality checks on save | Exists |
+| `--budget` | Cost display in header | Exists |
+| `--compliance` | Compliance preset selector | Exists |
+
+---
+
+## Realistic Timeline
+
+- **Phase 1 (Platform Shell):** 3-4 days -- sidebar, projects page, templates page, settings shell, workspace nav fix
+- **Phase 2 (Enhanced Workspace):** 5-7 days -- activity panel, AI chat, mode selector, plan-before-build, preview toolbar
+- **Phase 3 (Import + Deploy + Secrets):** 2-3 weeks -- needs backend work for GitHub import, deploy pipeline, secrets encryption
+- **Phase 4 (Hosted Infra):** 2-3 months -- container orchestration, auth, billing, custom domains
+
+**MVP milestone (Phase 1 + 2): ~2 weeks**
+
+---
+
+## Success Criteria (revised)
+
+- User can go from prompt to working preview in under 3 minutes
+- User can iterate via AI chat without starting a new session
+- Page refresh at any point preserves full state
+- User can browse all past projects and templates from sidebar
+- Plan step shows cost estimate before every build
+- Preview renders all relative assets correctly
+- Quality gates visible during builds
+- Cost tracking visible in workspace header