feat(mesh-plugin-task-runner): Agent Status UI with real-time monitoring

.beads/config.json

@@ -0,0 +1,4 @@
+{
+  "version": "1.0.0",
+  "created": "2026-02-01T01:10:40.594Z"
+}

.beads/project-config.json

@@ -0,0 +1,39 @@
+{
+  "qualityGates": [
+    {
+      "id": "gate-check",
+      "name": "Type Check",
+      "command": "bun run check",
+      "description": "TypeScript type checking",
+      "required": true,
+      "source": "auto"
+    },
+    {
+      "id": "gate-lint",
+      "name": "Lint",
+      "command": "bun run lint",
+      "description": "Code linting",
+      "required": true,
+      "source": "auto"
+    },
+    {
+      "id": "gate-test",
+      "name": "Test",
+      "command": "bun run test",
+      "description": "Run tests",
+      "required": true,
+      "source": "auto"
+    },
+    {
+      "id": "gate-fmt",
+      "name": "Format",
+      "command": "bun run fmt",
+      "description": "Code formatting",
+      "required": true,
+      "source": "auto"
+    }
+  ],
+  "completionToken": "<promise>COMPLETE</promise>",
+  "memoryDir": "memory",
+  "lastUpdated": "2026-02-01T14:48:58.695Z"
+}

.beads/tasks.json

@@ -0,0 +1,131 @@
+{
+  "tasks": [
+    {
+      "id": "task-1769960270044-98r02z",
+      "title": "write HELLO_WORLD.md with a greeting and explanation of what is this project we are building",
+      "status": "in_progress",
+      "createdAt": "2026-02-01T15:37:50.044Z",
+      "updatedAt": "2026-02-01T15:40:54.899Z",
+      "plan": {
+        "summary": "Create HELLO_WORLD.md at the repository root as a friendly introduction document that welcomes newcomers to the MCP Mesh project, explains what it is (an open-source control plane for MCP traffic), and provides quick orientation for getting started.",
+        "acceptanceCriteria": [
+          {
+            "id": "ac-1",
+            "description": "HELLO_WORLD.md file exists at /Users/guilherme/Projects/mesh/HELLO_WORLD.md",
+            "verifiable": true
+          },
+          {
+            "id": "ac-2",
+            "description": "Document includes a welcoming greeting section (e.g., 'Welcome to MCP Mesh!')",
+            "verifiable": true
+          },
+          {
+            "id": "ac-3",
+            "description": "Document explains what MCP Mesh is: an open-source control plane that sits between MCP clients and servers, providing auth, routing, and observability",
+            "verifiable": true
+          },
+          {
+            "id": "ac-4",
+            "description": "Document explains the core value proposition: replacing M×N integrations with one production endpoint",
+            "verifiable": true
+          },
+          {
+            "id": "ac-5",
+            "description": "Document references key project components (apps/mesh, packages/, docs) to orient newcomers",
+            "verifiable": true
+          },
+          {
+            "id": "ac-6",
+            "description": "Document includes pointers to next steps (README.md for detailed docs, AGENTS.md for coding guidelines, quick start commands)",
+            "verifiable": true
+          },
+          {
+            "id": "ac-7",
+            "description": "Document follows Markdown formatting conventions consistent with existing docs (README.md, AGENTS.md)",
+            "verifiable": true
+          }
+        ],
+        "subtasks": [
+          {
+            "id": "st-1",
+            "title": "Create HELLO_WORLD.md file with greeting header",
+            "description": "Create the file at repository root with a welcoming header section that greets newcomers to the project",
+            "estimatedComplexity": "trivial",
+            "filesToModify": ["HELLO_WORLD.md"]
+          },
+          {
+            "id": "st-2",
+            "title": "Write 'What is MCP Mesh?' explanation section",
+            "description": "Add a section explaining that MCP Mesh is an open-source control plane for MCP traffic, sitting between clients (Cursor, Claude, VS Code) and MCP servers, providing unified auth, routing, and observability",
+            "estimatedComplexity": "simple",
+            "filesToModify": ["HELLO_WORLD.md"]
+          },
+          {
+            "id": "st-3",
+            "title": "Write 'Why MCP Mesh?' value proposition section",
+            "description": "Explain the core problem it solves: replacing M×N integrations with a single governed endpoint, multi-tenant support, and full observability",
+            "estimatedComplexity": "simple",
+            "filesToModify": ["HELLO_WORLD.md"]
+          },
+          {
+            "id": "st-4",
+            "title": "Add project orientation section",
+            "description": "Brief overview of the monorepo structure: apps/mesh (main app), apps/docs (documentation), packages/ (shared libraries), and key files like README.md and AGENTS.md",
+            "estimatedComplexity": "simple",
+            "filesToModify": ["HELLO_WORLD.md"]
+          },
+          {
+            "id": "st-5",
+            "title": "Add 'Getting Started' quick reference",
+            "description": "Include the essential commands to get up and running: bun install, bun run dev, and pointers to README.md for full documentation",
+            "estimatedComplexity": "trivial",
+            "filesToModify": ["HELLO_WORLD.md"]
+          }
+        ],
+        "risks": [
+          "Content should complement (not duplicate) README.md - need to keep it concise and focused on welcoming/orienting newcomers",
+          "Should match the tone and style of existing documentation in the repository"
+        ],
+        "estimatedComplexity": "simple"
+      },
+      "planStatus": "approved",
+      "acceptanceCriteria": [
+        {
+          "id": "ac-1",
+          "description": "HELLO_WORLD.md file exists at /Users/guilherme/Projects/mesh/HELLO_WORLD.md",
+          "completed": false
+        },
+        {
+          "id": "ac-2",
+          "description": "Document includes a welcoming greeting section (e.g., 'Welcome to MCP Mesh!')",
+          "completed": false
+        },
+        {
+          "id": "ac-3",
+          "description": "Document explains what MCP Mesh is: an open-source control plane that sits between MCP clients and servers, providing auth, routing, and observability",
+          "completed": false
+        },
+        {
+          "id": "ac-4",
+          "description": "Document explains the core value proposition: replacing M×N integrations with one production endpoint",
+          "completed": false
+        },
+        {
+          "id": "ac-5",
+          "description": "Document references key project components (apps/mesh, packages/, docs) to orient newcomers",
+          "completed": false
+        },
+        {
+          "id": "ac-6",
+          "description": "Document includes pointers to next steps (README.md for detailed docs, AGENTS.md for coding guidelines, quick start commands)",
+          "completed": false
+        },
+        {
+          "id": "ac-7",
+          "description": "Document follows Markdown formatting conventions consistent with existing docs (README.md, AGENTS.md)",
+          "completed": false
+        }
+      ]
+    }
+  ]
+}

.gitignore

@@ -26,6 +26,7 @@ dist-ssr
 !.vscode/extensions.json
 .idea
 .DS_Store
+.claude/
 *.suo
 *.ntvs*
 *.njsproj

.planning/PROJECT.md

@@ -0,0 +1,81 @@
+# Site Builder
+
+## What This Is
+
+A Mesh plugin that extends the Task Runner to enable AI-assisted site building with live preview. Users connect to a local Deno/Fresh site, run the dev server, create tasks like "implement a new landing page", and watch the AI agent break it down into a plan, implement each step, and see changes via HMR in real-time.
+
+## Core Value
+
+Users describe what they want in natural language, and an AI agent builds it iteratively with real-time visual feedback.
+
+## Requirements
+
+### Validated
+
+<!-- Existing capabilities from the codebase -->
+
+- ✓ MCP Gateway architecture with plugin system — existing
+- ✓ Task Runner plugin with Beads integration — existing
+- ✓ Task creation, plan generation, plan approval workflow — existing
+- ✓ Agent spawning via Claude Code (AGENT_SPAWN) — existing
+- ✓ Quality gates and completion detection — existing
+- ✓ local-fs MCP for file read/write — existing
+- ✓ Session tracking and status polling — existing
+
+### Active
+
+<!-- New capabilities for this milestone -->
+
+- [ ] Site Builder plugin with preview-first UI layout
+- [ ] Connection dropdown filtering for sites (local-fs with deno.json)
+- [ ] Stack detection from deno.json/package.json
+- [ ] Dev server control (start/stop) via task-runner MCP
+- [ ] Live preview iframe with port detection
+- [ ] Page/route selector dropdown
+- [ ] Reuse task board components in collapsible panel
+- [ ] Site context passed to agents for stack-aware editing
+
+### Out of Scope
+
+- Multi-stack support (Next.js, Astro, etc.) — focus on Deno/Deco first
+- Remote site deployment — local development only for v1
+- Visual page builder / drag-drop — agent builds via code, user watches
+- MCP UI in chat panel — not ready yet, use collapsible task panel instead
+
+## Context
+
+**Existing Architecture:**
+- `mesh/packages/mesh-plugin-task-runner/` — working task runner UI
+- `mcps/task-runner/` — MCP with AGENT_SPAWN, quality gates, memory tools
+- `mesh/packages/bindings/` — well-known bindings including TASK_RUNNER_BINDING
+
+**Target Site Stack:**
+- Deno + Fresh framework (like decocms/)
+- `deno task dev` starts dev server with HMR
+- `.deco/blocks/` contains page JSON configs
+- `sections/` contains React components
+
+**UI Pattern:**
+- Same connection dropdown pattern as Task Runner
+- Preview iframe takes most of the screen
+- Task board is collapsible/secondary
+- Chat panel on right (existing Mesh layout)
+
+## Constraints
+
+- **Tech stack**: Must use existing Mesh patterns (React, TanStack Query, Radix)
+- **Reuse**: Should reuse task-runner hooks where possible (useTasks, useAgentSessions)
+- **MCP location**: Site tools go in existing task-runner MCP (not a new MCP)
+- **Detection**: Stack detection must be robust (deno.json with deco/ import)
+
+## Key Decisions
+
+| Decision | Rationale | Outcome |
+|----------|-----------|---------|
+| Extend task-runner MCP with site tools | Simpler than new MCP, reuses existing agent infrastructure | — Pending |
+| Preview-first layout | Site building is visual, tasks are secondary | — Pending |
+| Deno/Deco stack first | User's current need, add other stacks later | — Pending |
+| Filter connections by deno.json | Auto-detect sites vs generic folders | — Pending |
+
+---
+*Last updated: 2026-02-01 after initialization*