feat(irc): add IRC client and backend services

.env.example

@@ -37,3 +37,7 @@ GIT_AUTO_PUSH=false  # Automatically push commits to remote
 MAX_CONCURRENT_REQUESTS=5
 STREAMING_ENABLED=false
 ENABLE_CHECKPOINTS=true
+
+# IRC Configuration
+NEXT_PUBLIC_IRC_WS_URL=ws://localhost:8080
+NEXT_PUBLIC_IRC_CHANNEL=#devussy-chat

.gitignore

@@ -64,7 +64,6 @@ QUICK_SETUP.md
 START_HERE.txt
 
 # Generated project outputs (in root)
-/devplan.md
 /handoff_prompt.md
 /project_design.md
 /phase*.md
@@ -116,3 +115,4 @@ yarn-error.log*
 .yarn/
 dist/
 .vite/
+devussy-web/streaming_server/analytics.db

AGENTS.md

@@ -2,6 +2,62 @@
 
 This file provides guidance to agents when working with code in this repository.
 
+## 🔗 CRITICAL: Anchor-Based Context Management
+
+> **⚠️ READ THIS FIRST - This is the most important pattern in this project.**
+
+Devussy uses **stable HTML comment anchors** for efficient context management and safe file updates. **All agents MUST use anchors** when reading/writing devplan, phase, and handoff files.
+
+### Required Anchors
+
+| File | Anchor | Purpose |
+|------|--------|---------|
+| devplan.md | `<!-- PROGRESS_LOG_START -->` / `<!-- PROGRESS_LOG_END -->` | Track completed work |
+| devplan.md | `<!-- NEXT_TASK_GROUP_START -->` / `<!-- NEXT_TASK_GROUP_END -->` | Current 3-5 tasks to execute |
+| phase*.md | `<!-- PHASE_TASKS_START -->` / `<!-- PHASE_TASKS_END -->` | Phase-specific tasks |
+| phase*.md | `<!-- PHASE_PROGRESS_START -->` / `<!-- PHASE_PROGRESS_END -->` | Outcomes and blockers |
+| handoff_prompt.md | `<!-- QUICK_STATUS_START -->` / `<!-- QUICK_STATUS_END -->` | Status snapshot |
+| handoff_prompt.md | `<!-- HANDOFF_NOTES_START -->` / `<!-- HANDOFF_NOTES_END -->` | Agent handoff notes |
+
+### How to Use Anchors
+
+**Reading (CORRECT):**
+```
+Read devplan.md lines between <!-- NEXT_TASK_GROUP_START --> and <!-- NEXT_TASK_GROUP_END -->
+# Result: ~100 tokens loaded
+```
+
+**Reading (WRONG):**
+```
+Read entire devplan.md
+# Result: ~3000 tokens wasted
+```
+
+**Writing:** Always use `safe_write_devplan()` from `src/file_manager.py`:
+- Creates `.bak` backup before writing
+- Validates anchors exist in new content
+- Refuses to overwrite if anchors missing (writes to `.tmp` instead)
+
+### Token Budget
+
+| File | Section | ~Tokens | When to Read |
+|------|---------|---------|--------------|
+| handoff.md | Progress Log | ~200 | Start of session |
+| devplan.md | NEXT_TASK_GROUP | ~100 | Every turn |
+| devplan.md | PROGRESS_LOG | ~100 | If needed |
+| phase*.md | PHASE_TASKS | ~80 | When working on phase |
+
+**Target: Stay under 500 tokens per turn by reading ONLY anchored sections.**
+
+### Validation
+
+`file_manager.py:_validate_devplan_content()` enforces:
+- Header: `# Development Plan` or `## 📋 Project Dashboard`
+- Phase table: `### 🚀 Phase Overview` with `| Phase |`
+- Anchors: `<!-- PROGRESS_LOG_START -->` and `<!-- NEXT_TASK_GROUP_START -->`
+
+---
+
 ## Critical Commands (Non-Obvious)
 - **Test single file**: `pytest tests/unit/test_cli.py::TestGenerateDesignCommand::test_generate_design_minimal_args -v`
 - **Run integration tests**: `pytest tests/integration/ -v`  

DevDocs/JINJA_DATA_SAMPLES/basic_devplan.jinja.json

@@ -1,83 +1,33 @@
 {
-  "repo_context": {
-    "project_type": "python",
-    "structure": {
-      "source_dirs": [
-        "src"
-      ],
-      "test_dirs": [
-        "tests"
-      ],
-      "config_dirs": [
-        "config"
-      ],
-      "has_ci": true
-    },
-    "dependencies": {
-      "python": [
-        "fastapi",
-        "uvicorn"
-      ]
-    },
-    "metrics": {
-      "total_files": 42,
-      "total_lines": 1337
-    },
-    "patterns": {
-      "test_frameworks": [
-        "pytest"
-      ],
-      "build_tools": [
-        "poetry"
-      ]
-    },
-    "project_name": "ExistingApp",
-    "description": "An existing app",
-    "version": "1.0.0",
-    "author": "Dev"
-  },
   "project_design": {
-    "project_name": "SuperApp",
-    "languages": [
-      "Python",
-      "TypeScript"
-    ],
-    "frameworks": [
-      "FastAPI",
-      "React"
-    ],
-    "apis": [
-      "OpenAI",
-      "Stripe"
-    ],
-    "requirements": "Build a scalable web app.",
+    "project_name": "test-project",
     "objectives": [
-      "High performance",
-      "User friendly"
+      "Build web application",
+      "Create API"
     ],
     "tech_stack": [
-      "Python 3.11",
-      "React 18",
+      "Python",
+      "FastAPI",
       "PostgreSQL"
     ],
-    "architecture_overview": "Microservices architecture...",
+    "architecture_overview": "Test architecture overview",
     "dependencies": [
-      "sqlalchemy",
-      "pydantic"
+      "requests",
+      "pydantic",
+      "uvicorn"
     ],
     "challenges": [
-      "Concurrency",
-      "Data consistency"
+      "Performance optimization",
+      "Scalability"
     ],
     "mitigations": [
-      "Use async/await",
-      "Use transactions"
+      "Use caching",
+      "Load balancing"
     ],
-    "complexity": "Medium",
-    "estimated_phases": 5
+    "raw_llm_response": null,
+    "complexity": null,
+    "estimated_phases": null
   },
-  "code_samples": "def hello(): pass",
-  "interactive_session": {
-    "question_count": 5
-  }
+  "task_group_size": 3,
+  "detail_level": "normal"
 }

DevDocs/JINJA_DATA_SAMPLES/detailed_devplan.jinja.json

@@ -1,48 +1,9 @@
 {
-  "repo_context": {
-    "project_type": "python",
-    "structure": {
-      "source_dirs": [
-        "src"
-      ],
-      "test_dirs": [
-        "tests"
-      ],
-      "config_dirs": [
-        "config"
-      ],
-      "has_ci": true
-    },
-    "dependencies": {
-      "python": [
-        "fastapi",
-        "uvicorn"
-      ]
-    },
-    "metrics": {
-      "total_files": 42,
-      "total_lines": 1337
-    },
-    "patterns": {
-      "test_frameworks": [
-        "pytest"
-      ],
-      "build_tools": [
-        "poetry"
-      ]
-    },
-    "project_name": "ExistingApp",
-    "description": "An existing app",
-    "version": "1.0.0",
-    "author": "Dev"
-  },
-  "phase_number": 1,
-  "phase_title": "Setup",
-  "phase_description": "Initialize the project.",
-  "project_name": "SuperApp",
-  "tech_stack": [
-    "Python",
-    "Git"
-  ],
-  "code_samples": "print('hello')"
+  "phase_number": 3,
+  "phase_title": "Phase 3",
+  "phase_description": "",
+  "project_name": "test",
+  "tech_stack": [],
+  "task_group_size": 3,
+  "detail_level": "normal"
 }

DevDocs/JINJA_DATA_SAMPLES/handoff_prompt.jinja.json

@@ -1,45 +1,9 @@
 {
-  "project_name": "SuperApp",
-  "repo_context": {
-    "project_type": "python",
-    "structure": {
-      "source_dirs": [
-        "src"
-      ],
-      "test_dirs": [
-        "tests"
-      ],
-      "config_dirs": [
-        "config"
-      ],
-      "has_ci": true
-    },
-    "dependencies": {
-      "python": [
-        "fastapi",
-        "uvicorn"
-      ]
-    },
-    "metrics": {
-      "total_files": 42,
-      "total_lines": 1337
-    },
-    "patterns": {
-      "test_frameworks": [
-        "pytest"
-      ],
-      "build_tools": [
-        "poetry"
-      ]
-    },
-    "project_name": "ExistingApp",
-    "description": "An existing app",
-    "version": "1.0.0",
-    "author": "Dev"
-  },
-  "current_phase_number": 2,
-  "current_phase_name": "Core Logic",
-  "next_task_id": "2.1",
-  "next_task_description": "Implement auth",
-  "blockers": "None"
+  "project_name": "TestProject",
+  "current_phase_number": "None",
+  "current_phase_name": "No active phase",
+  "next_task_id": "1.1",
+  "next_task_description": "Initialize project",
+  "blockers": "None known",
+  "detail_level": "normal"
 }

DevDocs/JINJA_DATA_SAMPLES/project_design.jinja.json

@@ -1,40 +1,14 @@
 {
-  "project_name": "SuperApp",
+  "project_name": "Test Project",
+  "requirements": [
+    "Req 1",
+    "Req 2"
+  ],
   "languages": [
-    "Python",
-    "TypeScript"
+    "Python"
   ],
   "frameworks": [
-    "FastAPI",
-    "React"
-  ],
-  "apis": [
-    "OpenAI",
-    "Stripe"
-  ],
-  "requirements": "Build a scalable web app.",
-  "objectives": [
-    "High performance",
-    "User friendly"
-  ],
-  "tech_stack": [
-    "Python 3.11",
-    "React 18",
-    "PostgreSQL"
-  ],
-  "architecture_overview": "Microservices architecture...",
-  "dependencies": [
-    "sqlalchemy",
-    "pydantic"
-  ],
-  "challenges": [
-    "Concurrency",
-    "Data consistency"
-  ],
-  "mitigations": [
-    "Use async/await",
-    "Use transactions"
+    "FastAPI"
   ],
-  "complexity": "Medium",
-  "estimated_phases": 5
+  "apis": []
 }