ctrlcode 0.1.0__tar.gz

ctrlcode-0.1.0/.gitignore

@@ -0,0 +1,87 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Unit test / coverage
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# MyPy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Ruff
+.ruff_cache/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Project specific
+*.log
+.claude/
+*.jsonl
+
+# Config files with secrets
+config.toml
+**/config.toml
+!**/config.example.toml
+.ctrlcode/
+
+# Temporary files
+*.tmp
+tmp/
+temp/
+
+# uv
+.python-version
+uv.lock

ctrlcode-0.1.0/AGENT.md

@@ -0,0 +1,46 @@
+# ctrl+code Project Instructions
+
+> Note: This is the project-level AGENT.md. Global defaults are in ~/.config/ctrlcode/AGENT.md
+
+## Project Overview
+
+This is a differential fuzzing harness for AI-assisted coding. It generates code variants, runs tests, and uses static/semantic analysis to find the best implementation.
+
+## Architecture
+
+- **Server** (`src/ctrlcode/server.py`): JSON-RPC server handling sessions
+- **Session Manager** (`src/ctrlcode/session/manager.py`): Conversation orchestration
+- **Providers** (`src/ctrlcode/providers/`): LLM integrations (OpenAI, Anthropic)
+- **Tools** (`src/ctrlcode/tools/`): Built-in explore tools + MCP support
+- **Skills** (`src/ctrlcode/skills/`): Reusable command templates
+- **Fuzzing** (`src/ctrlcode/fuzzing/`): Variant generation and analysis
+- **TUI** (`tui/`): Textual-based interface
+
+## Code Style
+
+- Use Python 3.12+ features (type hints, match/case, etc.)
+- Prefer async/await for I/O operations
+- Keep functions focused and single-purpose
+- Use dataclasses for structured data
+- Follow existing logging patterns (`logger.info/warning/error`)
+
+## Tool Usage
+
+When exploring this codebase:
+- Use `search_code` to find class/function definitions
+- Use `search_files` to locate files by pattern
+- Use `read_file` to examine implementation details
+- Check related files (e.g., if editing a provider, check base.py first)
+
+## Testing
+
+- Run tests with `uv run pytest`
+- Skills are in `src/ctrlcode/skills/builtin/`
+- Test execution uses `analysis/tests.py`
+
+## Key Patterns
+
+- All RPC methods are in `server.py` and call into `SessionManager`
+- Tool execution loop is in `session/manager.py:process_turn()`
+- Streaming events use `StreamEvent` dataclass from `providers/base.py`
+- Skills expand via `SkillRegistry.process_input()`

ctrlcode-0.1.0/INTEGRATION_SUMMARY.md

@@ -0,0 +1,283 @@
+# Event-Driven TUI Integration - Complete ✅
+
+**Date:** 2026-02-14
+**Status:** Ready for Testing
+
+---
+
+## What We Built
+
+### 🎯 Core Achievement
+
+Built a **simple, event-driven TUI** with:
+1. ✅ Clean chat-first interface (no clutter)
+2. ✅ On-demand modals via slash commands
+3. ✅ **Event bus viewer** - see everything on the bus
+4. ✅ Complete event history tracking
+5. ✅ Loosely coupled components via events
+
+---
+
+## New Slash Commands
+
+```bash
+/status   # ⭐ Event bus viewer (shows ALL events)
+/agents   # Show active agents
+/tasks    # Show task graph
+/review   # Show review feedback
+/metrics  # Show observability results
+```
+
+**How it works:**
+- Inline summaries appear in chat automatically
+- Type `/command` to see full details in modal
+- Press ESC to close modal
+
+---
+
+## Event Bus Viewer (`/status`) - The Key Feature
+
+Shows **every single event** flowing through the system:
+
+```
+╔══════════════════════════════════════╗
+║ Event Bus Stream                     ║
+╠══════════════════════════════════════╣
+║ 14:32:01 workflow_phase_change       ║
+║          phase: idle → planning      ║
+║          progress: 0.0               ║
+║                                      ║
+║ 14:32:05 workflow_agent_spawned      ║
+║          agent_id: planner-1         ║
+║          type: planner               ║
+║          task: Decompose intent      ║
+║                                      ║
+║ 14:32:08 workflow_task_graph_created ║
+║          tasks: 5                    ║
+╚══════════════════════════════════════╝
+[Auto-scroll ON] Press Space, ESC to close
+```
+
+**Why it matters:**
+- Complete transparency into multi-agent workflows
+- Debug issues by viewing event sequence
+- No more black box - see everything
+- Full audit trail
+
+---
+
+## Files Created
+
+```
+tui/ctrlcode_tui/
+├── event_bus_new.py                    # Async event bus + history
+├── widgets/
+│   ├── status_line.py                  # Single-line status
+│   ├── modal_base.py                   # Modal base class
+│   └── modals/
+│       ├── __init__.py
+│       ├── status_modal.py             # Event bus viewer ⭐
+│       ├── agents_modal.py             # Active agents
+│       ├── tasks_modal.py              # Task graph
+│       ├── review_modal.py             # Review feedback
+│       └── metrics_modal.py            # Observability
+
+docs/
+├── active-plans/
+│   ├── simplified-tui-redesign.md      # Design plan
+│   ├── event-driven-tui-summary.md     # Architecture
+│   └── tui-integration-complete.md     # Integration details
+└── architectural-patterns/
+    └── event-bus-architecture.md       # Event bus patterns
+```
+
+---
+
+## Files Modified
+
+```
+tui/ctrlcode_tui/app.py
+├── ✅ Added LegacyEventBus wrapper (backwards compat)
+├── ✅ Added 5 new slash commands
+├── ✅ Added modal action methods
+├── ✅ Added state tracking (agents, tasks, feedback, metrics)
+├── ✅ Updated event handlers to populate state
+├── ✅ Updated help text
+└── ✅ Added inline hints ("Type /tasks for full graph")
+```
+
+---
+
+## Architecture
+
+```
+Event Flow:
+    Workflow publishes event
+         ↓
+    EventBus receives
+         ↓
+    Distributes to subscribers
+         ↓
+    ┌─────────┬──────────┬──────────┐
+    │         │          │          │
+  Chat    StatusModal  AgentsModal  etc.
+(inline)  (bus viewer) (on-demand)
+```
+
+**Key benefits:**
+- Components don't know about each other
+- Event bus is single source of truth
+- Complete observability
+- Easy to add new subscribers
+
+---
+
+## Testing
+
+### Verify Integration
+
+```bash
+cd /home/jtregunna/Projects/ctrl+code
+
+# 1. Test imports
+uv run python -c "from tui.ctrlcode_tui.event_bus_new import EventBus; print('✅ Event bus OK')"
+uv run python -c "from tui.ctrlcode_tui.widgets.modals import StatusModal; print('✅ Modals OK')"
+
+# 2. Start TUI
+uv run ctrl-code tui
+
+# 3. In TUI, test commands:
+/help      # Should show new commands
+/status    # Should open event bus viewer (empty for now)
+# Press ESC to close
+```
+
+### Manual Test Workflow
+
+```
+1. Type "/help"
+   → Verify 5 new commands listed under "Multi-Agent Workflow Commands"
+
+2. Type "/status"
+   → Event bus viewer modal opens
+   → Shows "Event Bus Stream" title
+   → Currently empty (no events yet)
+   → Press ESC to close
+
+3. Type "/agents"
+   → Shows "No agents active (not in multi-agent mode)"
+
+4. Type "/tasks"
+   → Shows "No task graph available"
+
+5. When workflow runs (future):
+   → Events appear in chat inline
+   → Type "/status" to see all events
+   → Type "/agents" to see agent details
+   → Type "/tasks" to see full task graph
+```
+
+---
+
+## What's Next
+
+### 1. Wire Workflow to Event Bus
+
+**File:** `src/ctrlcode/session/manager.py`
+
+**Need:**
+- Pass TUI event bus to workflow orchestrator
+- Workflow calls `await bus.publish()` for each event
+- Events flow: Workflow → EventBus → TUI → Modals
+
+### 2. Test End-to-End
+
+- Run multi-agent workflow
+- Verify events appear in `/status`
+- Verify modals show real-time data
+- Verify inline hints work
+
+### 3. Polish
+
+- Animations (fade in/out)
+- Color coding by event type
+- Keyboard shortcuts (Ctrl+S for /status)
+- Event filtering in bus viewer
+
+---
+
+## Event Catalog
+
+All events defined in `event_bus_new.py`:
+
+**Workflow Events:**
+- `workflow_phase_change` - Phase transitions
+- `workflow_agent_spawned` - New agent created
+- `workflow_agent_updated` - Agent progress
+- `workflow_agent_completed` - Agent finished
+- `workflow_task_graph_created` - Planner output
+- `workflow_task_updated` - Task status change
+- `workflow_review_feedback` - Reviewer issues
+- `workflow_observability_results` - Validation
+- `workflow_error` - Error occurred
+- `workflow_complete` - Workflow done
+
+**UI Events:**
+- `ui_command_entered` - User typed /command
+- `ui_modal_opened` - Modal opened
+- `ui_modal_closed` - Modal closed
+
+**System Events:**
+- `system_info` - Info message
+- `system_warning` - Warning
+- `system_error` - Error
+
+---
+
+## Success Criteria
+
+- [x] Event bus implemented with history
+- [x] Event catalog defined (EventTypes)
+- [x] Modals created (5 modals)
+- [x] Slash commands added (5 new commands)
+- [x] State tracking integrated
+- [x] Event handlers updated
+- [x] Help text updated
+- [x] Inline hints added
+- [x] Imports verified (✅ all working)
+- [ ] Workflow connected to event bus
+- [ ] End-to-end test with real workflow
+- [ ] Polish and animations
+
+---
+
+## Key Innovation
+
+**Event Bus Viewer (`/status`)** provides:
+- Complete transparency into system
+- Full audit trail of all events
+- Real-time debugging capability
+- No more "what's happening?" mystery
+
+This single feature makes complex multi-agent workflows **debuggable** and **understandable**.
+
+---
+
+## Ready to Use
+
+```bash
+# Start TUI
+uv run ctrl-code tui
+
+# Try new commands
+/help
+/status
+/agents
+/tasks
+```
+
+**Next:** Connect workflow orchestrator to event bus, then test with real multi-agent workflow.
+
+---
+
+**Integration Status:** ✅ Complete and ready for workflow connection

ctrlcode-0.1.0/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: ctrlcode
+Version: 0.1.0
+Summary: Adaptive coding harness with differential fuzzing - transforms AI slop into production-ready code
+Requires-Python: >=3.12
+Requires-Dist: aiohttp>=3.10.0
+Requires-Dist: anthropic>=0.40.0
+Requires-Dist: apscheduler>=3.11.2
+Requires-Dist: ctrlcode-tui
+Requires-Dist: faiss-cpu>=1.13.2
+Requires-Dist: harness-utils>=0.3.1
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: networkx>=3.6.1
+Requires-Dist: openai>=1.54.0
+Requires-Dist: platformdirs>=4.5.1
+Requires-Dist: playwright>=1.58.0
+Requires-Dist: sentence-transformers>=5.2.2
+Requires-Dist: tiktoken>=0.12.0
+Description-Content-Type: text/markdown
+
+# ctrl+code
+
+Adaptive coding harness with differential fuzzing - transforms AI slop into production-ready code.
+
+## Configuration
+
+ctrl+code follows platform conventions for config and data storage:
+
+| Platform | Config | Data | Cache |
+|----------|--------|------|-------|
+| **Linux** | `~/.config/ctrlcode/` | `~/.local/share/ctrlcode/` | `~/.cache/ctrlcode/` |
+| **macOS** | `~/Library/Application Support/ctrlcode/` | `~/Library/Application Support/ctrlcode/` | `~/Library/Caches/ctrlcode/` |
+| **Windows** | `%APPDATA%\ctrlcode\` | `%LOCALAPPDATA%\ctrlcode\` | `%LOCALAPPDATA%\ctrlcode\Cache\` |
+
+### Environment Variables
+
+Override default directories:
+- `CTRLCODE_CONFIG_DIR`: Config file location
+- `CTRLCODE_DATA_DIR`: Session logs and persistent data
+- `CTRLCODE_CACHE_DIR`: Conversation storage and temp files
+
+### Configuration File
+
+Copy `config.example.toml` to your config directory as `config.toml` and fill in your API keys.
+
+### Agent Instructions (AGENT.md)
+
+Customize agent behavior with `AGENT.md` files, loaded hierarchically:
+
+1. **Global** (`~/.config/ctrlcode/AGENT.md`) - Your personal defaults across all projects
+2. **Project** (`<workspace>/AGENT.md`) - Project-specific instructions
+
+Example global `AGENT.md`:
+```markdown
+# Global Agent Defaults
+
+- Always use semantic commit messages
+- Show tool results explicitly
+- Prefer built-in tools over scripts
+```
+
+Example project `AGENT.md`:
+```markdown
+# MyProject Instructions
+
+## Architecture
+- Frontend: React + TypeScript
+- Backend: FastAPI + PostgreSQL
+
+## Style
+- Use async/await for all I/O
+- Prefer functional components
+```
+
+Instructions are injected into the system prompt, giving the agent context about your preferences and project structure.
+
+## Installation
+
+```bash
+uv pip install ctrlcode
+```
+
+## Usage
+
+Start the TUI (auto-launches server):
+```bash
+ctrlcode
+```
+
+Or start server separately:
+```bash
+ctrlcode-server
+```

ctrlcode-0.1.0/README.md

@@ -0,0 +1,73 @@
+# ctrl+code
+
+Adaptive coding harness with differential fuzzing - transforms AI slop into production-ready code.
+
+## Configuration
+
+ctrl+code follows platform conventions for config and data storage:
+
+| Platform | Config | Data | Cache |
+|----------|--------|------|-------|
+| **Linux** | `~/.config/ctrlcode/` | `~/.local/share/ctrlcode/` | `~/.cache/ctrlcode/` |
+| **macOS** | `~/Library/Application Support/ctrlcode/` | `~/Library/Application Support/ctrlcode/` | `~/Library/Caches/ctrlcode/` |
+| **Windows** | `%APPDATA%\ctrlcode\` | `%LOCALAPPDATA%\ctrlcode\` | `%LOCALAPPDATA%\ctrlcode\Cache\` |
+
+### Environment Variables
+
+Override default directories:
+- `CTRLCODE_CONFIG_DIR`: Config file location
+- `CTRLCODE_DATA_DIR`: Session logs and persistent data
+- `CTRLCODE_CACHE_DIR`: Conversation storage and temp files
+
+### Configuration File
+
+Copy `config.example.toml` to your config directory as `config.toml` and fill in your API keys.
+
+### Agent Instructions (AGENT.md)
+
+Customize agent behavior with `AGENT.md` files, loaded hierarchically:
+
+1. **Global** (`~/.config/ctrlcode/AGENT.md`) - Your personal defaults across all projects
+2. **Project** (`<workspace>/AGENT.md`) - Project-specific instructions
+
+Example global `AGENT.md`:
+```markdown
+# Global Agent Defaults
+
+- Always use semantic commit messages
+- Show tool results explicitly
+- Prefer built-in tools over scripts
+```
+
+Example project `AGENT.md`:
+```markdown
+# MyProject Instructions
+
+## Architecture
+- Frontend: React + TypeScript
+- Backend: FastAPI + PostgreSQL
+
+## Style
+- Use async/await for all I/O
+- Prefer functional components
+```
+
+Instructions are injected into the system prompt, giving the agent context about your preferences and project structure.
+
+## Installation
+
+```bash
+uv pip install ctrlcode
+```
+
+## Usage
+
+Start the TUI (auto-launches server):
+```bash
+ctrlcode
+```
+
+Or start server separately:
+```bash
+ctrlcode-server
+```