@prmichaelsen/acp-visualizer 0.1.0

package/agent/manifest.yaml

@@ -0,0 +1,302 @@
+packages:
+  tanstack-cloudflare:
+    source: https://github.com/prmichaelsen/acp-tanstack-cloudflare.git
+    package_version: 1.2.0
+    commit: a7b38da5276d55bdd95e5afdde61bb17dfff52a3
+    installed_at: 2026-03-14T08:25:49Z
+    updated_at: 2026-03-14T08:25:49Z
+    files:
+      patterns:
+        - name: tanstack-cloudflare.zod-schema-validation.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:adb86721ba843d6aa0732d27bf2d67492e5771e3830f219303ea1b9172191ca6
+        - name: tanstack-cloudflare.wrangler-configuration.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:11bdd08fe4a069979d82eca9b6914e424bcf7de2cbdac87308aca15ec33f0e64
+        - name: tanstack-cloudflare.websocket-manager.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:3d02635ac5d36acc9a210a16349c52f86fb029c97bc3c708c970655b5e298583
+        - name: tanstack-cloudflare.user-scoped-collections.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:6469b71782f1e313d9d1042fe165e7976976537a43a259810f7a4089b60a8fe3
+        - name: tanstack-cloudflare.unified-header.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:766223cd53a8ec7706b924709d924351e1717c57b0ced19c15815472d8742549
+        - name: tanstack-cloudflare.toast-system.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:8ac5edd2b69b656775fdba1ac484b1c10218b97afde1547b6d1fb3ba5297e3a5
+        - name: tanstack-cloudflare.third-party-api-integration.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:c083463330b2fabb154349a7ab9c68791fd0a436e91b4b859cc1a8f9451385e3
+        - name: tanstack-cloudflare.ssr-preload.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:24758145fe8f65ff6cf1d44121157b7ccafbab4935631439b3a173162d964b2f
+        - name: tanstack-cloudflare.slide-over.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:093c6fd89cfaf999b0f3a742654ab11459fdfc341bbc8f0e27bf2e154cad505e
+        - name: tanstack-cloudflare.searchable-settings.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:e7dde5140043f1d22e719c62ed6f57d854b76bad826108c98667c81a46e75515
+        - name: tanstack-cloudflare.scheduled-tasks.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:0b82838b6f2c6e7f070786f8cc013ed06c25453c0ba5a7e3769f940724adef48
+        - name: tanstack-cloudflare.rate-limiting.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:6d1226c8316850cc35bad1e155e9a80d8b9866e227ca6cd0d49b7bc400ccc63a
+        - name: tanstack-cloudflare.provider-adapter.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:2d220ec327ca9b8b6cc4ec22c79554f64afce275639ad4c209bdb7f62bc9c7e9
+        - name: tanstack-cloudflare.pill-input.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:77cbb33bef218673ca48711c05a3f82cc0f2a426e33f77ac0031c5119ec15eb8
+        - name: tanstack-cloudflare.pagination.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:e82186a7e63e404b304294b8a4bf2009a7936149ca0229e81b7d62f6601485a2
+        - name: tanstack-cloudflare.og-metadata.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:77a215b9921b225580fbd2111d10b8a68b44ad942ad3ff4a31b65ea35137b236
+        - name: tanstack-cloudflare.oauth-token-refresh.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:5aa2142e895feb14632bca0adbea10cef65b886f993ba512a9b55d7901531d1f
+        - name: tanstack-cloudflare.notifications-engine.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:27f99c12451aec7dd41844560c2eaadf2aafb3d02300fed0a8db0e5e892f20fe
+        - name: tanstack-cloudflare.nextjs-to-tanstack-routing.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:c07222752febcd9841a8257d830ab45a28812805f223432798e2a362878e9af5
+        - name: tanstack-cloudflare.modal.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:7b3bb372452a0f6f7a6402af9dc68b1d88271f799640a031540d237080a3df5d
+        - name: tanstack-cloudflare.mention-suggestions.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:ddac4f68f056a0109b58dc684454c6a17811d9008fcb71e8f6e105ca4b49ca40
+        - name: tanstack-cloudflare.markdown-content.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:53d6f1da3683bd103f15206b9590a27c4d6203dbab96500ce3d308456db12a66
+        - name: tanstack-cloudflare.lightbox.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:4ffb50d603be7634f64fb40493eb645600f61d0126548b329286f6503aaedbfc
+        - name: tanstack-cloudflare.library-services.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:add205df35786610db4f30eeae5c22e8fef522d5e6da260cf7201a2e10d93995
+        - name: tanstack-cloudflare.image-carousel.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:418d2754d500e4f26b6e806ab1dd2fe5a88f21c9d3e84ebe386a6f3b8611bee2
+        - name: tanstack-cloudflare.global-search-context.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:e4639607f5a03fecf96cc56a441de680055ceac88140997ed9eb90b28216f8e8
+        - name: tanstack-cloudflare.form-controls.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:f8c617ae392a39d83c9a24cb88d22bcdf88648285f0fffee5bd82ea176b5e2d1
+        - name: tanstack-cloudflare.firebase-storage.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:af119009a4acf318a87478626234a4fc61d76787ff60f800105e04e89f88bab7
+        - name: tanstack-cloudflare.firebase-firestore.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:671ec50be46027dabb0c2498d85e2b5aa30f443534206f0252adb6b910478ee5
+        - name: tanstack-cloudflare.firebase-auth.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:b2b1701e5e1b34597e68fce18079288cf5a94440f0963e38f2ac723c4b860a14
+        - name: tanstack-cloudflare.firebase-anonymous-sessions.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:b0a3334caef04ddbb8bb8266e8e6c4a834f067447a8ed953530362e3f4975d08
+        - name: tanstack-cloudflare.fcm-push.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:31a1f4fa755cca2ddc9fb7df460d101fdfdaf3f618940a0151f9c4d962e28750
+        - name: tanstack-cloudflare.expander.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:1cca83093335dec65c70e4940f0cab42f139244d784dd27493b2509f21a19072
+        - name: tanstack-cloudflare.email-service.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:89191ee26f1151706cac35f31545d76f153199922e404d73352fa8f59bd05828
+        - name: tanstack-cloudflare.durable-objects-websocket.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:03f55b506bd0535c1f3aae769223becd9fc1ed436eb2d7f120d2c26bda061c23
+        - name: tanstack-cloudflare.confirmation-tokens.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:2886bee926fff0c0395a7c159257b1b741f933165126fdf44774b850db037108
+        - name: tanstack-cloudflare.chat-engine.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:f5fffc5f7c973b6b9e69d857b585afea7aa8e22f33c7275aa39eb4b5e48c0a99
+        - name: tanstack-cloudflare.card-and-list.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:97061ed34876e499559bca7af5c04bb0003328fb706a55ec014077ac600474f2
+        - name: tanstack-cloudflare.auth-session-management.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:bc4d32b53bbb6651daeb2fe532c0f43dd972fa939dea45bd7fc73f0eba95a512
+        - name: tanstack-cloudflare.api-route-handlers.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:d4ac07bb7453edd4493ca313c56a641c58fd8760a16741610d1ad0fc0da2b366
+        - name: tanstack-cloudflare.action-bar-item.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:d91fd67507ebfa7a304359124fc59c17f2906f6e70441863a491e54b1fc18bec
+        - name: tanstack-cloudflare.acl-permissions.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:769dae3dfc5dab520d5df259039a32db1e5d17082eef4a1060790d9f2e82ca46
+      commands:
+        - name: tanstack-cloudflare.tail.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:643d50910f50c3e7912488f4165cd0db92db53e12356efa15bac0161d100999e
+        - name: tanstack-cloudflare.deploy.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:66e1ab357c44cd26d356bc3e6ffe0b50d62bd36e9180f633a97b6b02d3de3e24
+        - name: git.init.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:2cd8bef13ba0278c3c3389631835aa4663a82c324bbb894aabd4299bb2370d53
+        - name: git.commit.md
+          version: 0.0.0
+          installed_at: 2026-03-14T08:25:56Z
+          modified: false
+          checksum: sha256:96249dee1a09f941f8ca2f072b53c90fa21fc34505fca4999d7c0c02982b3d02
+      designs:
+      scripts:
+      files:
+      indices:
+  acp-core:
+    source: https://github.com/prmichaelsen/agent-context-protocol.git
+    package_version: 5.18.3
+    installed_at: 2026-03-14T08:19:21Z
+    updated_at: 2026-03-14T08:19:21Z
+    files:
+      commands:
+        - name: acp.clarification-address.md
+        - name: acp.clarification-capture.md
+        - name: acp.clarification-create.md
+        - name: acp.clarifications-research.md
+        - name: acp.command-create.md
+        - name: acp.design-create.md
+        - name: acp.design-reference.md
+        - name: acp.handoff.md
+        - name: acp.index.md
+        - name: acp.init.md
+        - name: acp.package-create.md
+        - name: acp.package-info.md
+        - name: acp.package-install.md
+        - name: acp.package-list.md
+        - name: acp.package-publish.md
+        - name: acp.package-remove.md
+        - name: acp.package-search.md
+        - name: acp.package-update.md
+        - name: acp.package-validate.md
+        - name: acp.pattern-create.md
+        - name: acp.plan.md
+        - name: acp.proceed.md
+        - name: acp.project-create.md
+        - name: acp.project-info.md
+        - name: acp.project-list.md
+        - name: acp.project-remove.md
+        - name: acp.project-set.md
+        - name: acp.project-update.md
+        - name: acp.projects-restore.md
+        - name: acp.projects-sync.md
+        - name: acp.report.md
+        - name: acp.resume.md
+        - name: acp.sessions.md
+        - name: acp.status.md
+        - name: acp.sync.md
+        - name: acp.task-create.md
+        - name: acp.update.md
+        - name: acp.validate.md
+        - name: acp.version-check-for-updates.md
+        - name: acp.version-check.md
+        - name: acp.version-update.md
+        - name: git.commit.md
+        - name: git.init.md
+      patterns:
+        - name: bootstrap.template.md
+        - name: pattern.template.md
+      designs:
+        - name: design.template.md
+        - name: requirements.template.md
+manifest_version: 1.0.0
+last_updated: 2026-03-14T08:25:49Z

package/agent/milestones/milestone-1-project-scaffold-data-pipeline.md

@@ -0,0 +1,67 @@
+# Milestone 1: Project Scaffold & Data Pipeline
+
+**Goal**: Set up TanStack Start project with Tailwind and implement the complete data loading pipeline from YAML file to SSR-rendered React components
+**Duration**: 1 week
+**Dependencies**: None
+**Status**: Not Started
+
+---
+
+## Overview
+
+This milestone establishes the project foundation and the entire data flow: reading progress.yaml from disk, parsing it into typed TypeScript structures with agent-drift tolerance, serving it via SSR, and auto-refreshing when the file changes. By the end of this milestone, the app will load and display raw progress data in the browser with live updates.
+
+---
+
+## Deliverables
+
+### 1. TanStack Start Project
+- Initialized project with Vite, React, TanStack Start, TanStack Router
+- Tailwind CSS configured with custom design tokens (status colors, fonts)
+- TypeScript strict mode enabled
+- Dev server runs with `npm run dev`
+
+### 2. Data Model & Parser
+- TypeScript interfaces for ProgressData, Milestone, Task, WorkEntry
+- Lenient YAML parser with agent-drift handling (aliases, fuzzy status, extra fields)
+- ProgressDatabaseService wrapping all data access
+
+### 3. Server API & Auto-Refresh
+- Server-side data loading via `beforeLoad`
+- SSE endpoint for file change notifications
+- useAutoRefresh hook for client-side live updates
+- Configurable progress.yaml path
+
+---
+
+## Success Criteria
+
+- [ ] `npm run dev` starts the dev server without errors
+- [ ] Browser loads and displays parsed progress.yaml data
+- [ ] Modifying progress.yaml triggers auto-refresh in browser
+- [ ] Parser handles missing fields, unknown properties, and status variants without crashing
+- [ ] SSR renders data on first page load (no loading spinner)
+
+---
+
+## Tasks
+
+1. [Task 1: Initialize TanStack Start project](../tasks/milestone-1-project-scaffold-data-pipeline/task-1-initialize-tanstack-start-project.md) - Scaffold project with Vite, Tailwind, routing
+2. [Task 2: Implement data model & YAML parser](../tasks/milestone-1-project-scaffold-data-pipeline/task-2-implement-data-model-yaml-parser.md) - Types, parsing, drift handling
+3. [Task 3: Build server API & data loading](../tasks/milestone-1-project-scaffold-data-pipeline/task-3-build-server-api-data-loading.md) - ProgressDatabaseService, beforeLoad SSR
+4. [Task 4: Add auto-refresh via SSE](../tasks/milestone-1-project-scaffold-data-pipeline/task-4-add-auto-refresh-sse.md) - File watcher, SSE endpoint, useAutoRefresh hook
+
+---
+
+## Testing Requirements
+
+- [ ] YAML parser unit tests with real-world progress.yaml files
+- [ ] Drift handling tests (unknown fields, aliases, fuzzy status)
+- [ ] Server function returns valid ProgressData
+- [ ] Dev server starts and responds
+
+---
+
+**Next Milestone**: [Milestone 2: Dashboard Views & Interaction](milestone-2-dashboard-views-interaction.md)
+**Blockers**: None
+**Notes**: All subsequent milestones depend on this data pipeline being solid

package/agent/milestones/milestone-1-{title}.template.md

@@ -0,0 +1,206 @@
+# Milestone {N}: {Descriptive Name}
+
+**Goal**: [One-line objective that clearly states what this milestone achieves]
+**Duration**: [Estimated time: e.g., "1-2 weeks", "3-5 days"]
+**Dependencies**: [List prerequisite milestones or external dependencies, or "None"]
+**Status**: Not Started | In Progress | Completed
+
+---
+
+## Overview
+
+[Provide a comprehensive description of what this milestone accomplishes and why it's important to the project. Explain how it fits into the overall project roadmap.]
+
+**Example**: "This milestone establishes the foundational infrastructure for the project, including build system, database connections, and basic server setup. It creates the scaffolding that all future features will build upon."
+
+---
+
+## Deliverables
+
+[List concrete, measurable outputs this milestone will produce. Be specific about what will exist when this milestone is complete.]
+
+### 1. [Deliverable Category 1]
+- Specific item 1
+- Specific item 2
+- Specific item 3
+
+### 2. [Deliverable Category 2]
+- Specific item 1
+- Specific item 2
+
+### 3. [Deliverable Category 3]
+- Specific item 1
+- Specific item 2
+
+**Example**:
+
+### 1. Project Structure
+- New `project-name/` directory with organized subdirectories
+- package.json with all metadata and scripts
+- TypeScript configuration (tsconfig.json)
+- Build system using esbuild
+- Directory structure: src/, tests/, agent/
+
+### 2. Core Dependencies
+- @modelcontextprotocol/sdk installed and configured
+- Database client libraries installed
+- Development tools (TypeScript, testing framework)
+
+---
+
+## Success Criteria
+
+[Define objective, verifiable criteria that indicate this milestone is complete. Each criterion should be testable.]
+
+- [ ] Criterion 1: [Specific, measurable condition]
+- [ ] Criterion 2: [Specific, measurable condition]
+- [ ] Criterion 3: [Specific, measurable condition]
+- [ ] Criterion 4: [Specific, measurable condition]
+- [ ] Criterion 5: [Specific, measurable condition]
+
+**Example**:
+- [ ] Project builds successfully (`npm run build` completes without errors)
+- [ ] TypeScript compiles without errors (`npm run typecheck` passes)
+- [ ] All dependencies install correctly (`npm install` succeeds)
+- [ ] Basic server starts and responds to health check
+- [ ] All tests pass (`npm test` succeeds)
+
+---
+
+## Key Files to Create
+
+[List the specific files and directories that will be created during this milestone. Use a tree structure for clarity.]
+
+```
+project-root/
+├── file1.ext
+├── file2.ext
+├── directory1/
+│   ├── file3.ext
+│   └── file4.ext
+└── directory2/
+    ├── subdirectory/
+    │   └── file5.ext
+    └── file6.ext
+```
+
+**Example**:
+```
+my-project/
+├── package.json
+├── tsconfig.json
+├── esbuild.build.js
+├── .gitignore
+├── .env.example
+├── README.md
+├── src/
+│   ├── index.ts
+│   ├── server.ts
+│   ├── types/
+│   │   └── index.ts
+│   └── utils/
+│       └── logger.ts
+└── tests/
+    └── setup.test.ts
+```
+
+---
+
+## Tasks
+
+[List the tasks that comprise this milestone. Reference task documents if they exist.]
+
+1. [Task 1: task-N-{name}.md](../tasks/task-N-{name}.md) - [Brief description]
+2. [Task 2: task-N-{name}.md](../tasks/task-N-{name}.md) - [Brief description]
+3. [Task 3: task-N-{name}.md](../tasks/task-N-{name}.md) - [Brief description]
+4. [Task 4: task-N-{name}.md](../tasks/task-N-{name}.md) - [Brief description]
+
+**Example**:
+1. [Task 1: Initialize Project Structure](../tasks/task-1-initialize-project-structure.md) - Set up directories and config files
+2. [Task 2: Install Dependencies](../tasks/task-2-install-dependencies.md) - Install and configure npm packages
+3. [Task 3: Create Basic Server](../tasks/task-3-create-basic-server.md) - Implement minimal MCP server
+
+---
+
+## Environment Variables
+
+[If this milestone requires environment configuration, document it here:]
+
+```env
+# Category 1
+VAR_NAME_1=example_value
+VAR_NAME_2=example_value
+
+# Category 2
+VAR_NAME_3=example_value
+VAR_NAME_4=example_value
+```
+
+**Example**:
+```env
+# Database Configuration
+DATABASE_URL=postgresql://localhost:5432/mydb
+DATABASE_POOL_SIZE=10
+
+# API Configuration
+API_KEY=your_api_key_here
+API_URL=https://api.example.com
+
+# Server Configuration
+PORT=3000
+NODE_ENV=development
+```
+
+---
+
+## Testing Requirements
+
+[Describe what testing should be in place by the end of this milestone:]
+
+- [ ] Test category 1: [Description]
+- [ ] Test category 2: [Description]
+- [ ] Test category 3: [Description]
+
+**Example**:
+- [ ] Unit tests for core utilities
+- [ ] Integration test for database connection
+- [ ] Server initialization test
+- [ ] Environment variable loading test
+
+---
+
+## Documentation Requirements
+
+[List documentation that should be created or updated:]
+
+- [ ] Document 1: [Description]
+- [ ] Document 2: [Description]
+- [ ] Document 3: [Description]
+
+**Example**:
+- [ ] README.md with project overview and quick start
+- [ ] API documentation for core interfaces
+- [ ] Development setup guide
+
+---
+
+## Risks and Mitigation
+
+[Identify potential risks and how to address them:]
+
+| Risk | Impact | Probability | Mitigation Strategy |
+|------|--------|-------------|---------------------|
+| [Risk 1] | High/Medium/Low | High/Medium/Low | [How to mitigate] |
+| [Risk 2] | High/Medium/Low | High/Medium/Low | [How to mitigate] |
+
+**Example**:
+| Risk | Impact | Probability | Mitigation Strategy |
+|------|--------|-------------|---------------------|
+| Database connection issues | High | Medium | Provide clear error messages and connection testing utilities |
+| Dependency conflicts | Medium | Low | Pin dependency versions and test thoroughly |
+
+---
+
+**Next Milestone**: [Link to next milestone: milestone-{N+1}-{name}.md]
+**Blockers**: [List any current blockers, or "None"]
+**Notes**: [Any additional context or considerations]

package/agent/milestones/milestone-2-dashboard-views-interaction.md

@@ -0,0 +1,79 @@
+# Milestone 2: Dashboard Views & Interaction
+
+**Goal**: Build the complete dashboard UI with sidebar navigation, overview page, table/tree milestone views, search, and filtering
+**Duration**: 1.5 weeks
+**Dependencies**: M1 - Project Scaffold & Data Pipeline
+**Status**: Not Started
+
+---
+
+## Overview
+
+This milestone transforms the raw data pipeline from M1 into a polished admin dashboard. It builds the application shell (sidebar, header, routing), the overview page, two milestone visualization views (table and tree), and the search/filtering system. By the end, users have a fully functional P0 visualizer.
+
+---
+
+## Deliverables
+
+### 1. Application Shell
+- Root layout with sidebar navigation and header
+- File-based routing for all pages
+- Design tokens applied (dark theme, status colors, monospace data)
+
+### 2. Overview Page
+- Project metadata card (name, version, status, dates)
+- Overall progress bar
+- Milestone summary list with progress indicators
+- Next steps and current blockers display
+
+### 3. Milestone Views
+- Sortable table view with @tanstack/react-table
+- Expandable tree view with milestone → task hierarchy
+- View toggle (table/tree) with shared filter state
+- TaskList component with StatusDot and ExtraFieldsBadge
+
+### 4. Search & Filtering
+- Fuse.js search index across milestones, tasks, and extra fields
+- Status filter bar (all/in_progress/not_started/completed)
+- SearchBar in sidebar
+- GlobalSearchContext for cross-component state
+
+---
+
+## Success Criteria
+
+- [ ] Sidebar navigation works across all routes
+- [ ] Overview page shows project metadata, progress, and next steps
+- [ ] Table view renders milestones with sortable columns
+- [ ] Tree view expands to show tasks per milestone
+- [ ] Search returns fuzzy-matched results
+- [ ] Status filter narrows visible milestones/tasks
+- [ ] View toggle preserves filter state
+- [ ] All views render via SSR (no loading spinners)
+
+---
+
+## Tasks
+
+1. [Task 5: Build dashboard layout & routing](../tasks/milestone-2-dashboard-views-interaction/task-5-build-dashboard-layout-routing.md) - Root layout, sidebar, header, design tokens
+2. [Task 6: Build overview page](../tasks/milestone-2-dashboard-views-interaction/task-6-build-overview-page.md) - Project summary dashboard
+3. [Task 7: Implement milestone table view](../tasks/milestone-2-dashboard-views-interaction/task-7-implement-milestone-table-view.md) - @tanstack/react-table with sorting
+4. [Task 8: Implement milestone tree view](../tasks/milestone-2-dashboard-views-interaction/task-8-implement-milestone-tree-view.md) - Expandable hierarchy with TaskList
+5. [Task 9: Implement search & filtering](../tasks/milestone-2-dashboard-views-interaction/task-9-implement-search-filtering.md) - Fuse.js, GlobalSearchContext, FilterBar
+6. [Task 10: Polish & integration testing](../tasks/milestone-2-dashboard-views-interaction/task-10-polish-integration-testing.md) - View toggle, error states, empty states
+
+---
+
+## Testing Requirements
+
+- [ ] Component tests for StatusBadge, ProgressBar, FilterBar
+- [ ] Table sorting works correctly
+- [ ] Tree expand/collapse toggles
+- [ ] Search returns expected results for known queries
+- [ ] Filter narrows visible items correctly
+
+---
+
+**Next Milestone**: None (P0 complete)
+**Blockers**: None
+**Notes**: P1 features (kanban, activity timeline, GitHub remote, multi-project) would follow as M3