agileflow 2.30.0

package/src/core/commands/blockers.md

@@ -0,0 +1,343 @@
+---
+description: Track and resolve blockers with actionable suggestions
+allowed-tools: Bash, Read, Edit, Write, Glob, Grep
+---
+
+# blockers
+
+Comprehensive blocker tracking, resolution suggestions, and cross-agent coordination (leverages v2.7.0 AG-API unblocking capabilities).
+
+## Prompt
+
+ROLE: Blocker Analyst & Resolution Coordinator
+
+OBJECTIVE
+Extract, categorize, and prioritize all blockers across the AgileFlow system. Leverage v2.7.0's cross-agent coordination where AG-API actively searches for blocked AG-UI stories. Provide actionable resolution suggestions with links to relevant ADRs and research.
+
+INPUTS (all optional)
+- AGENT=<agent-id> — Filter by specific agent (e.g., AG-UI, AG-API)
+- SHOW_RESOLVED=true — Include recently resolved blockers (last 7 days)
+- DETAILED=true — Show extended details (dependencies, research links, ADRs)
+
+KNOWLEDGE LOADING (run first, silently)
+Read in order:
+1. docs/09-agents/status.json — Current story statuses and blockers
+2. docs/09-agents/bus/log.jsonl — Recent unblock/blocked messages (last 50 lines)
+3. docs/06-stories/**/US-*.md — Story details for blocked stories
+4. docs/03-decisions/adr-*.md — Index all ADRs for resolution suggestions
+5. docs/10-research/*.md — Index research notes for blocker context
+6. docs/05-epics/*.md — Epic context for blocked stories
+
+BLOCKER EXTRACTION
+
+## 1. Direct Blockers (status="blocked")
+```bash
+# Extract all blocked stories
+jq -r '.stories | to_entries[] | select(.value.status=="blocked") |
+  "\(.key)|\(.value.owner)|\(.value.blocked_by // "Not specified")|\(.value.last_update)|\(.value.epic // "none")"' \
+  docs/09-agents/status.json
+```
+
+## 2. Dependency Blockers (stories waiting on dependencies)
+```bash
+# Find stories blocked by dependencies
+jq -r '.stories | to_entries[] | select(.value.deps) |
+  "\(.key)|\(.value.owner)|\(.value.deps | join(","))|\(.value.status)"' \
+  docs/09-agents/status.json | while IFS='|' read story owner deps status; do
+
+  # Check each dependency
+  IFS=',' read -ra DEP_ARRAY <<< "$deps"
+  for dep in "${DEP_ARRAY[@]}"; do
+    dep_status=$(jq -r ".stories[\"$dep\"].status" docs/09-agents/status.json 2>/dev/null)
+
+    # If dependency is not done, this is a blocker
+    if [ "$dep_status" != "done" ]; then
+      dep_owner=$(jq -r ".stories[\"$dep\"].owner" docs/09-agents/status.json 2>/dev/null)
+      echo "$story is waiting on $dep (owned by $dep_owner, status: $dep_status)"
+    fi
+  done
+done
+```
+
+## 3. WIP Capacity Blockers (agents at WIP limit)
+```bash
+# Find agents at WIP limit (2 in-progress stories)
+jq -r '.stories | to_entries[] | select(.value.status=="in-progress") |
+  "\(.value.owner)|\(.key)"' docs/09-agents/status.json | \
+  awk -F'|' '{count[$1]++; stories[$1]=stories[$1] $2 " "}
+  END {for (agent in count) if (count[agent] >= 2)
+    print agent " at WIP limit (" count[agent] "/2): " stories[agent]}'
+
+# Cross-reference with ready stories waiting for these agents
+```
+
+## 4. Stale Blockers (blocked >14 days)
+```bash
+fourteen_days_ago=$(date -u -d '14 days ago' +%Y-%m-%dT%H:%M:%S 2>/dev/null || date -u -v-14d +%Y-%m-%dT%H:%M:%S 2>/dev/null)
+
+jq -r --arg cutoff "$fourteen_days_ago" '.stories | to_entries[] |
+  select(.value.status=="blocked") |
+  select(.value.last_update < $cutoff) |
+  "\(.key)|\(.value.owner)|\(.value.last_update)|\(.value.blocked_by // \"Unknown\")"' \
+  docs/09-agents/status.json
+```
+
+BLOCKER CATEGORIZATION
+
+Group blockers by type:
+1. **Technical** — Missing APIs, infrastructure, dependencies not done
+2. **Coordination** — Waiting on other agents, handoff needed
+3. **Clarification** — Requirements unclear, acceptance criteria incomplete
+4. **External** — Third-party service, approval, access needed
+5. **Capacity** — Agent at WIP limit, no bandwidth
+6. **Research** — Need investigation before proceeding
+
+Assign category based on:
+- `blocked_by` text content (keywords: "API", "waiting", "unclear", "need", "WIP")
+- Bus messages (type: "blocked", text analysis)
+- Story dependency chain
+
+RESOLUTION SUGGESTIONS
+
+For each blocker, provide:
+
+### Technical Blockers
+- Check if dependent story is in-progress
+- Estimate completion time (based on story estimate and elapsed time)
+- Suggest interim workarounds (mock data, feature flags)
+- Link to relevant ADRs (search for technology/component keywords)
+
+### Coordination Blockers (v2.7.0 Focus)
+- **AG-API Unblocking Status**: Check bus/log.jsonl for AG-API messages about unblocking AG-UI stories
+  ```bash
+  # Find AG-API unblock messages for AG-UI stories
+  grep '"from":"AG-API"' docs/09-agents/bus/log.jsonl | grep '"type":"unblock"' | tail -n 10
+  ```
+- Show AG-API progress on implementing endpoints that AG-UI is waiting for
+- Suggest handoff if different agent better suited
+- Identify if blocker is due to missing communication (no bus messages)
+
+### Clarification Blockers
+- Check story file for incomplete AC
+- Suggest questions to ask (based on epic goals)
+- Link to related research or ADRs
+- Recommend creating spike story for investigation
+
+### External Blockers
+- Identify who/what is blocking (from blocked_by text)
+- Suggest escalation path
+- Recommend documenting assumptions to proceed in parallel
+
+### Capacity Blockers
+- Show agent's current in-progress stories
+- Suggest redistributing to other agents
+- Estimate when bandwidth will free up
+
+### Research Blockers
+- Search docs/10-research/ for related topics
+- Check for stale research (>90 days) that might need updating
+- Suggest running /AgileFlow:context MODE=research for specific topic
+- Link to ADRs that might have context
+
+CROSS-AGENT COORDINATION ANALYSIS (v2.7.0)
+
+Specifically analyze AG-API ↔ AG-UI coordination:
+
+```bash
+# Find AG-UI stories blocked waiting for AG-API endpoints
+jq -r '.stories | to_entries[] |
+  select(.value.owner=="AG-UI") |
+  select(.value.status=="blocked") |
+  select(.value.blocked_by | contains("API") or contains("endpoint") or contains("backend")) |
+  "\(.key)|\(.value.blocked_by)"' docs/09-agents/status.json
+
+# For each, check if AG-API has started work
+# Look for AG-API stories that might unblock these
+jq -r '.stories | to_entries[] |
+  select(.value.owner=="AG-API") |
+  select(.value.status=="in-progress" or .value.status=="in-review") |
+  "\(.key)|\(.value.summary)"' docs/09-agents/status.json
+```
+
+Show:
+- Which AG-UI stories are blocked waiting for AG-API
+- Which AG-API stories are in progress that will unblock AG-UI
+- Estimated unblock timeline (based on AG-API story estimates)
+- Recent AG-API unblock messages from bus
+
+ADR & RESEARCH LINKING
+
+For each blocker:
+1. **Extract keywords** from blocked_by text and story title
+2. **Search ADRs**: `grep -i <keywords> docs/03-decisions/adr-*.md`
+3. **Search research**: `grep -i <keywords> docs/10-research/*.md`
+4. **Link relevant documents** in output (path + brief context)
+
+Example:
+```
+US-0042 blocked by "Need authentication middleware decision"
+  → Related ADR: docs/03-decisions/adr-005-auth-strategy.md
+  → Related Research: docs/10-research/20251015-auth-comparison.md
+```
+
+RECENTLY RESOLVED BLOCKERS (if SHOW_RESOLVED=true)
+
+```bash
+# Find unblock messages in last 7 days
+seven_days_ago=$(date -u -d '7 days ago' +%Y-%m-%dT%H:%M:%S 2>/dev/null || date -u -v-7d +%Y-%m-%dT%H:%M:%S 2>/dev/null)
+
+grep '"type":"unblock"' docs/09-agents/bus/log.jsonl | while read -r line; do
+  ts=$(echo "$line" | jq -r '.ts')
+
+  # Compare timestamp
+  if [[ "$ts" > "$seven_days_ago" ]]; then
+    story=$(echo "$line" | jq -r '.story')
+    from=$(echo "$line" | jq -r '.from')
+    text=$(echo "$line" | jq -r '.text')
+    echo "✅ $ts - $from unblocked $story: $text"
+  fi
+done
+```
+
+OUTPUT FORMAT
+
+```
+🚧 Blocker Dashboard
+====================
+Generated: <timestamp>
+Filter: <agent filter if applied, else "All agents">
+
+📊 SUMMARY
+----------
+Total Active Blockers: X
+  - Technical: X
+  - Coordination: X
+  - Clarification: X
+  - External: X
+  - Capacity: X
+  - Research: X
+
+Critical (>14 days): X
+Cross-Agent Blockers: X (AG-UI ↔ AG-API coordination)
+
+🔴 CRITICAL BLOCKERS (>14 days)
+-------------------------------
+[Story ID] [Owner] [Type] [Blocked Since]
+<description>
+Resolution: <suggested action>
+Related: <ADR/research links>
+
+---
+
+⚠️  ACTIVE BLOCKERS
+-------------------
+### Technical Blockers (X)
+
+US-0042 | AG-UI | Blocked: Missing login API endpoint
+  Status: Blocked for 5 days
+  Epic: EP-0010 (Authentication System)
+  Dependencies: US-0038 (AG-API, in-progress, est. 1d remaining)
+
+  💡 Resolution:
+    - US-0038 is 70% complete (based on elapsed time vs estimate)
+    - Estimated unblock: Tomorrow
+    - Workaround: Use mock auth data for UI development
+    - AG-API is actively working on this (last update: 2h ago)
+
+  📚 Related:
+    - ADR: docs/03-decisions/adr-005-auth-strategy.md
+    - Research: docs/10-research/20251015-jwt-vs-session.md
+
+---
+
+### Coordination Blockers (X)
+
+[v2.7.0 AG-API Unblocking Status]
+AG-API is actively unblocking 2 AG-UI stories:
+  ✅ US-0038 (POST /auth/login) - 70% complete, unblocks US-0042
+  🔄 US-0041 (GET /user/profile) - 30% complete, unblocks US-0045
+
+Recent AG-API unblock activity:
+  - 2h ago: "POST /auth/login endpoint complete, ready for integration"
+  - 5h ago: "Started work on user profile endpoint"
+
+---
+
+### Clarification Blockers (X)
+
+US-0051 | AG-DEVOPS | Blocked: Unclear deployment target
+  Status: Blocked for 3 days
+  Epic: EP-0012 (CI/CD Pipeline)
+
+  💡 Resolution:
+    - Story AC incomplete (missing "Then" clause)
+    - Suggest questions:
+      1. Which platform? (Vercel, AWS, Docker)
+      2. What's the target environment? (staging, production, both)
+      3. Who approves production deploys?
+    - Related: Epic EP-0012 mentions "cloud-native" but no specifics
+
+  📚 Related:
+    - Research: docs/10-research/20251010-deployment-comparison.md (90 days old, may be stale)
+    - Suggest: /AgileFlow:context MODE=research TOPIC="Modern deployment platforms 2025"
+
+---
+
+💪 CAPACITY BLOCKERS
+--------------------
+AG-API at WIP limit (2/2):
+  - US-0038 (in-progress, 70% complete)
+  - US-0041 (in-progress, 30% complete)
+
+  Ready stories waiting for AG-API: 3
+    - US-0055 (Epic: EP-0011, est: 1d)
+    - US-0060 (Epic: EP-0013, est: 2d)
+    - US-0062 (Epic: EP-0010, est: 0.5d)
+
+  💡 Suggestion: Wait for US-0038 to complete (est. tomorrow), then pick up US-0062 (smallest)
+
+---
+
+✅ RECENTLY RESOLVED (last 7 days)
+----------------------------------
+[if SHOW_RESOLVED=true]
+
+2025-10-21 14:30 - AG-API unblocked US-0042: "POST /auth/login endpoint complete"
+2025-10-20 09:15 - AG-UI unblocked US-0033: "Design system tokens extracted"
+2025-10-19 16:45 - AG-CI unblocked US-0028: "Test environment configured"
+
+---
+
+🎯 PRIORITIZED ACTIONS
+----------------------
+1. [High] Resolve US-0051 clarification blocker (3 days old, blocking epic)
+2. [High] Complete US-0038 (70% done, unblocks AG-UI's US-0042)
+3. [Medium] Review stale research for US-0051 (deployment comparison is 90 days old)
+4. [Low] Redistribute AG-API backlog when capacity opens
+
+Next Commands:
+- /AgileFlow:status STORY=US-0051 STATUS=ready NOTE="Clarified deployment target: Vercel"
+- /AgileFlow:context MODE=research TOPIC="Modern deployment platforms 2025"
+- /AgileFlow:validate-system (check for other inconsistencies)
+- /AgileFlow:board (visualize current state)
+```
+
+RULES
+- Always show both blocker stats and resolution suggestions
+- Prioritize critical (>14 days) blockers first
+- Highlight v2.7.0 cross-agent coordination (AG-API unblocking AG-UI)
+- Link ADRs and research when relevant keywords match
+- Suggest specific next commands to resolve blockers
+- Read-only operation (no modifications to status.json)
+- Group by blocker type for clarity
+- Show estimated unblock times based on in-progress dependencies
+
+FOLLOW-UP INTEGRATION
+After displaying blockers, ask:
+"Would you like me to update any blocker statuses or create resolution stories?"
+
+If yes, suggest:
+- `/AgileFlow:status STORY=<id> STATUS=ready` for resolved blockers
+- `/story-new` for creating unblocking stories
+- `/handoff` for reassigning capacity-blocked stories
+- `/adr-new` for architectural blockers needing decisions

package/src/core/commands/board.md

@@ -0,0 +1,241 @@
+---
+description: Display visual kanban board with WIP limits
+allowed-tools: Bash, Read, Edit, Write, Glob, Grep
+---
+
+# board
+
+Generate a visual kanban board from current story statuses.
+
+## Prompt
+
+ROLE: Board Visualizer
+
+OBJECTIVE
+Create a visual kanban board showing stories organized by status with color coding, WIP limits, and quick stats.
+
+INPUTS (optional)
+- EPIC=<EP_ID> (filter by specific epic)
+- OWNER=<agent_id> (filter by owner)
+- FORMAT=ascii|markdown|html (default: ascii)
+- GROUP_BY=status|owner|epic (default: status)
+
+DATA SOURCE
+Read docs/09-agents/status.json to get all current story statuses.
+
+BOARD LAYOUT (ASCII Format)
+
+```
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                           AGILEFLOW KANBAN BOARD                              ║
+║                          Updated: 2025-10-17 14:30                            ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║ 📊 Summary: 15 stories | 3 ready | 4 in-progress | 2 in-review | 6 done     ║
+║ ⚠️  WIP Limit: 2/agent (AG-UI: 2/2 ⚠️, AG-API: 1/2 ✓, AG-CI: 0/2 ✓)         ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+
+┌─────────────────┬─────────────────┬─────────────────┬─────────────────┐
+│ 📋 READY (3)    │ 🔄 IN PROGRESS  │ 👀 IN REVIEW    │ ✅ DONE (6)     │
+│ WIP: -          │ (4) WIP: 4/6    │ (2) WIP: -      │ WIP: -          │
+├─────────────────┼─────────────────┼─────────────────┼─────────────────┤
+│                 │                 │                 │                 │
+│ 🟢 US-0042      │ 🟡 US-0038      │ 🔵 US-0035      │ ⚪ US-0030      │
+│ Login form UI   │ OAuth flow      │ Password reset  │ User registration│
+│ AG-UI · 1d      │ AG-API · 1.5d   │ AG-API · 1d     │ AG-API · 1d     │
+│ EP-0010         │ EP-0010         │ EP-0010         │ EP-0010         │
+│                 │                 │                 │                 │
+│ 🟢 US-0043      │ 🟡 US-0039      │ 🔵 US-0036      │ ⚪ US-0031      │
+│ Profile page    │ Session mgmt    │ Email verify    │ Login endpoint  │
+│ AG-UI · 1.5d    │ AG-API · 1d     │ AG-CI · 0.5d    │ AG-API · 1d     │
+│ EP-0011         │ EP-0010         │ EP-0010         │ EP-0010         │
+│                 │                 │                 │                 │
+│ 🟢 US-0044      │ 🟡 US-0040      │                 │ ⚪ US-0032      │
+│ Dashboard       │ Rate limiting   │                 │ JWT generation  │
+│ AG-UI · 2d      │ AG-CI · 0.5d    │                 │ AG-API · 0.5d   │
+│ EP-0011         │ EP-0010         │                 │ EP-0010         │
+│                 │                 │                 │                 │
+│                 │ 🟡 US-0041 ⚠️   │                 │ ⚪ US-0033      │
+│                 │ BLOCKED         │                 │ DB schema       │
+│                 │ Payment API     │                 │ AG-API · 0.5d   │
+│                 │ AG-API · 2d     │                 │ EP-0010         │
+│                 │ Dep: US-0035    │                 │                 │
+│                 │                 │                 │ ⚪ US-0034      │
+│                 │                 │                 │ Token refresh   │
+│                 │                 │                 │ AG-API · 1d     │
+│                 │                 │                 │ EP-0010         │
+│                 │                 │                 │                 │
+│                 │                 │                 │ ⚪ US-0037      │
+│                 │                 │                 │ CI setup        │
+│                 │                 │                 │ AG-CI · 1d      │
+│                 │                 │                 │ EP-0010         │
+└─────────────────┴─────────────────┴─────────────────┴─────────────────┘
+
+Legend:
+  🟢 Priority: High    🟡 Priority: Medium    🔵 Priority: Low    ⚪ Completed
+  ⚠️  Blocked/WIP limit exceeded
+```
+
+COLOR CODING
+
+Use emoji/symbols for visual distinction:
+- 🟢 Green: High priority or ready to start
+- 🟡 Yellow: In progress or medium priority
+- 🔵 Blue: In review or low priority
+- ⚪ White: Done
+- 🔴 Red: Blocked
+- ⚠️  Warning: WIP limit exceeded or blockers
+
+MARKDOWN TABLE FORMAT
+
+```markdown
+## AgileFlow Board (2025-10-17 14:30)
+
+**Summary**: 15 stories | 3 ready | 4 in-progress | 2 in-review | 6 done
+
+| Ready | In Progress | In Review | Done |
+|-------|-------------|-----------|------|
+| **US-0042** 🟢<br>Login form UI<br>AG-UI · 1d<br>EP-0010 | **US-0038** 🟡<br>OAuth flow<br>AG-API · 1.5d<br>EP-0010 | **US-0035** 🔵<br>Password reset<br>AG-API · 1d<br>EP-0010 | **US-0030** ✅<br>User registration<br>AG-API · 1d<br>EP-0010 |
+| **US-0043** 🟢<br>Profile page<br>AG-UI · 1.5d<br>EP-0011 | **US-0039** 🟡<br>Session mgmt<br>AG-API · 1d<br>EP-0010 | **US-0036** 🔵<br>Email verify<br>AG-CI · 0.5d<br>EP-0010 | **US-0031** ✅<br>Login endpoint<br>AG-API · 1d<br>EP-0010 |
+| ... | ... | | ... |
+
+### WIP Limits
+- AG-UI: 2/2 ⚠️ (at limit)
+- AG-API: 1/2 ✓
+- AG-CI: 0/2 ✓
+
+### Blockers
+- US-0041 blocked by US-0035 (in review)
+```
+
+HTML FORMAT (for export)
+
+```html
+<!DOCTYPE html>
+<html>
+<head>
+  <style>
+    .board { display: flex; gap: 20px; padding: 20px; }
+    .column { flex: 1; background: #f5f5f5; border-radius: 8px; padding: 15px; }
+    .card { background: white; padding: 12px; margin: 10px 0; border-radius: 4px; box-shadow: 0 2px 4px rgba(0,0,0,0.1); }
+    .ready { border-left: 4px solid #4caf50; }
+    .in-progress { border-left: 4px solid #ff9800; }
+    .in-review { border-left: 4px solid #2196f3; }
+    .done { border-left: 4px solid #9e9e9e; }
+    .blocked { border: 2px solid #f44336; }
+  </style>
+</head>
+<body>
+  <h1>AgileFlow Kanban Board</h1>
+  <div class="board">
+    <div class="column">
+      <h2>📋 Ready (3)</h2>
+      <div class="card ready">
+        <strong>US-0042</strong><br>
+        Login form UI<br>
+        <small>AG-UI · 1d · EP-0010</small>
+      </div>
+      <!-- More cards -->
+    </div>
+    <!-- More columns -->
+  </div>
+</body>
+</html>
+```
+
+GROUP BY OWNER
+
+```
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                      AGILEFLOW BOARD (Grouped by Owner)                       ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+
+┌─────────────────┬─────────────────┬─────────────────┐
+│ 🎨 AG-UI (5)    │ 🔧 AG-API (8)   │ ⚙️  AG-CI (2)    │
+│ WIP: 2/2 ⚠️     │ WIP: 1/2 ✓      │ WIP: 0/2 ✓      │
+├─────────────────┼─────────────────┼─────────────────┤
+│                 │                 │                 │
+│ 🟡 US-0038      │ 🟡 US-0039      │ ✅ US-0037      │
+│ IN PROGRESS     │ IN PROGRESS     │ DONE            │
+│ Login form      │ Session mgmt    │ CI setup        │
+│                 │                 │                 │
+│ 🟡 US-0040      │ 🔵 US-0035      │ 🔵 US-0036      │
+│ IN PROGRESS     │ IN REVIEW       │ IN REVIEW       │
+│ Profile page    │ Password reset  │ Email verify    │
+│                 │                 │                 │
+│ 🟢 US-0042      │ 🟢 US-0043      │                 │
+│ READY           │ READY           │                 │
+│ Dashboard       │ Payment API     │                 │
+└─────────────────┴─────────────────┴─────────────────┘
+```
+
+STATISTICS
+
+Include helpful stats:
+```
+📊 Board Statistics
+
+Throughput:
+  - Stories completed this week: 6
+  - Avg completion time: 2.3 days
+  - Velocity: 8.5 points/week
+
+Status Distribution:
+  - Ready: 3 (20%)
+  - In Progress: 4 (27%)
+  - In Review: 2 (13%)
+  - Done: 6 (40%)
+
+By Owner:
+  - AG-UI: 5 stories (2 in progress)
+  - AG-API: 8 stories (1 in progress)
+  - AG-CI: 2 stories (0 in progress)
+
+Blockers:
+  - 1 story blocked (US-0041 waiting on US-0035)
+
+Warnings:
+  - AG-UI at WIP limit (2/2)
+  - US-0050 stale (no updates in 7 days)
+```
+
+ACTIONS (after showing board)
+
+1. Ask: "Would you like to:"
+   - Export to file? (board-YYYYMMDD.md or .html)
+   - Update a story status?
+   - View details for a specific story?
+   - Filter by epic/owner?
+
+2. Suggest actions based on board state:
+   - "AG-UI is at WIP limit. Consider completing US-0038 before starting new work."
+   - "US-0041 is blocked. Can we unblock it by reviewing US-0035?"
+   - "3 stories ready. Which should we prioritize?"
+
+INTEGRATION
+
+- Save board snapshot to docs/08-project/boards/board-<YYYYMMDD>.md
+- Track board states over time for velocity analysis
+- Optionally update /AgileFlow:velocity with latest data
+
+WORKFLOW
+
+1. Read docs/09-agents/status.json
+2. Parse stories by status
+3. Apply filters (epic, owner) if specified
+4. Calculate WIP limits and warnings
+5. Render board in requested format
+6. Show statistics
+7. Suggest actions
+
+RULES
+- Never modify status.json (read-only visualization)
+- Highlight blockers and WIP violations prominently
+- Keep ASCII board width ≤80 chars for terminal viewing
+- Update timestamp on every render
+- Sort stories by priority within columns
+
+OUTPUT
+- Rendered kanban board (ASCII/markdown/HTML)
+- Statistics summary
+- Action suggestions
+- Optional: saved snapshot file