@pjmendonca/devflow 1.19.0 → 1.20.0

package/.claude/skills/dashboard/SKILL.md

@@ -0,0 +1,118 @@
+---
+name: dashboard
+description: Launch live status dashboard in a terminal
+---
+
+# Live Dashboard Skill
+
+Launch or provide instructions for the Devflow live status dashboard - a real-time display of context usage, cost tracking, and agent activity.
+
+## Usage
+
+```
+/dashboard [story-key] [options]
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| story-key | Story to monitor (default: 'default') |
+| --refresh N | Refresh interval in seconds (default: 0.5) |
+| --compact | Single-line compact mode |
+| --width N | Dashboard width (default: 70) |
+
+## Prompt
+
+You are helping the user launch the Devflow live dashboard.
+
+**Arguments:** $ARGUMENTS
+
+### Dashboard Launch Instructions
+
+The live dashboard is a terminal-based real-time display that needs to run in a separate terminal to show continuous updates while you work.
+
+**Option 1: VS Code Split Terminal (Recommended)**
+
+Tell the user:
+
+1. Open the VS Code integrated terminal (Ctrl+` or Cmd+`)
+2. Click the "Split Terminal" button (or press Cmd+Shift+5 / Ctrl+Shift+5)
+3. In the new terminal pane, run:
+
+```bash
+python3 tooling/scripts/live_dashboard.py $ARGUMENTS
+```
+
+Or if using npm:
+```bash
+npx devflow dashboard $ARGUMENTS
+```
+
+**Option 2: Separate Terminal Window**
+
+For a floating dashboard window:
+
+```bash
+# Open a new terminal and run:
+cd [project-root] && python3 tooling/scripts/live_dashboard.py $ARGUMENTS
+```
+
+**Option 3: Compact Mode (less screen space)**
+
+For minimal display:
+```bash
+python3 tooling/scripts/live_dashboard.py --compact $ARGUMENTS
+```
+
+### Dashboard Features
+
+The dashboard displays:
+
+```
++------------------------------------------------------------------+
+|  DEVFLOW LIVE DASHBOARD                          Updated: HH:MM  |
++------------------------------------------------------------------+
+|  ACTIVITY                                                        |
+|  Agent: DEV [2/3] Development (3:45)                            |
+|  Task: Implementing user authentication                          |
++------------------------------------------------------------------+
+|  CONTEXT                                                         |
+|  Usage: [================--------]  65.2% ^                      |
+|  Tokens: 130.4K/200K  ~14 exchanges left                        |
++------------------------------------------------------------------+
+|  COST                                                            |
+|  Budget: [====--------------------]  12.3%                       |
+|  Spent: $1.85 / $15.00  In: 45.2K  Out: 12.1K                   |
++------------------------------------------------------------------+
+|  RECENT                                                          |
+|  > +3.2K tokens (45s ago)                                       |
+|  > +2.8K tokens (1m ago)                                        |
++------------------------------------------------------------------+
+```
+
+- **Activity**: Current agent, phase, task, and elapsed time
+- **Context**: Visual progress bar with trend indicator and remaining exchanges
+- **Cost**: Budget usage with token breakdown
+- **Recent**: Token history showing recent activity
+
+### Color Coding
+
+- Green: Safe levels (< 50% context, < 75% budget)
+- Yellow: Caution (50-75% context, 75-90% budget)
+- Red: Critical (> 75% context, > 90% budget)
+
+### Tips
+
+1. **High refresh rate**: Use `--refresh 0.25` for faster updates
+2. **Narrow terminal**: Use `--width 60` for smaller panes
+3. **Minimal mode**: Use `--compact` for single-line status
+4. **Stop dashboard**: Press Ctrl+C to exit
+
+### If No Data Shows
+
+The dashboard reads from:
+- Context state: `tooling/.automation/context/context_[story-key].json`
+- Cost data: `tooling/.automation/costs/sessions/*.json`
+
+If these files don't exist yet, run a story or use `/develop` to generate tracking data.

package/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.20.0] - 2026-01-16
+
+### Fixed
+- **Import Error** - Fixed Python stdlib `platform` module conflict in multiple scripts
+  - `run-collab.py`, `run-story.py`, `new-doc.py`, `setup-checkpoint-service.py` now use `from lib.platform import`
+  - `swarm_orchestrator.py`, `pair_programming.py`, `cost_display.py` now prioritize lib.platform over stdlib
+  - Resolves `ImportError: cannot import name 'IS_MACOS' from 'platform'` on Python 3.14+
+
+### Added
+- **Live Dashboard** - Real-time terminal status display for monitoring Devflow sessions
+  - Rich ASCII dashboard with box-drawing characters and color-coded progress bars
+  - Shows context usage, cost tracking, current agent/activity, and token history
+  - Configurable refresh rate (default 0.5s) for responsive updates
+  - Compact single-line mode with `--compact` flag
+  - Run via `devflow dashboard` or `python3 tooling/scripts/live_dashboard.py`
+  - New `/dashboard` skill with instructions for VS Code split terminal setup
+
+- **Swarm Command** - Added `devflow swarm` CLI command for multi-agent swarm mode
+  - New `bin/devflow-swarm.js` wrapper that calls run-collab.py with --swarm flag
+  - Added to devflow.js dispatcher and package.json bin entries
+
 ## [1.19.0] - 2026-01-03
 
 ### Added

package/README.md

@@ -747,7 +747,7 @@ Free to use in commercial and personal projects.
 
 
 <!-- VERSION_START - Auto-updated by update_version.py -->
-**Version**: 1.19.0
+**Version**: 1.20.0
 **Status**: Production Ready
-**Last Updated**: 2026-01-03
+**Last Updated**: 2026-01-16
 <!-- VERSION_END -->

package/bin/devflow-dashboard.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+const path = require('path');
+const { execPythonScript, getScriptsDir } = require('../lib/exec-python');
+
+const scriptPath = path.join(getScriptsDir(), 'live_dashboard.py');
+const args = process.argv.slice(2);
+
+const exitCode = execPythonScript(scriptPath, args);
+process.exit(exitCode);

package/bin/devflow-swarm.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+const path = require('path');
+const { execPythonScript, getScriptsDir } = require('../lib/exec-python');
+
+const scriptPath = path.join(getScriptsDir(), 'run-collab.py');
+const args = process.argv.slice(2);
+
+// Prepend --swarm flag to run in swarm mode
+const exitCode = execPythonScript(scriptPath, ['--swarm', ...args]);
+process.exit(exitCode);

package/bin/devflow.js

@@ -6,6 +6,8 @@ const commands = {
   'install': 'Install Devflow into your project',
   'story': 'Run full story pipeline (context + dev + review)',
   'collab': 'Run collaborative story with mode selection',
+  'swarm': 'Run multi-agent swarm mode (debate/consensus)',
+  'dashboard': 'Live status dashboard (context, cost, activity)',
   'checkpoint': 'Create or restore context checkpoints',
   'memory': 'View or query shared agent memory',
   'cost': 'View cost dashboard and spending analytics',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pjmendonca/devflow",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "Development workflow automation with Claude Code - agent-based development system with cost tracking",
   "keywords": [
     "devflow",
@@ -33,6 +33,8 @@
     "devflow-checkpoint": "bin/devflow-checkpoint.js",
     "devflow-memory": "bin/devflow-memory.js",
     "devflow-collab": "bin/devflow-collab.js",
+    "devflow-swarm": "bin/devflow-swarm.js",
+    "devflow-dashboard": "bin/devflow-dashboard.js",
     "devflow-create-persona": "bin/devflow-create-persona.js",
     "devflow-personalize": "bin/devflow-personalize.js",
     "devflow-validate-overrides": "bin/devflow-validate-overrides.js",

package/tooling/.automation/memory/knowledge/kg_integration-test.json

@@ -1,6 +1,6 @@
 {
   "story_key": "integration-test",
-  "last_updated": "2026-01-03T14:30:38.051845",
+  "last_updated": "2026-01-16T12:33:48.829767",
   "decisions": {},
   "topic_index": {},
   "handoffs": [
@@ -962,6 +962,90 @@
         "Implement the required functionality",
         "Write tests for the implementation"
       ]
+    },
+    {
+      "id": "handoff_cb6d7c7a",
+      "timestamp": "2026-01-16T12:33:30.919040",
+      "from_agent": "SM",
+      "to_agent": "DEV",
+      "story_key": "integration-test",
+      "summary": "Ready for implementation",
+      "key_decisions": [],
+      "blockers_resolved": [],
+      "watch_out_for": [],
+      "files_touched": [
+        ".claude/commands/brainstorm.md",
+        ".claude/commands/init.md",
+        ".claude/skills/brainstorm/SKILL.md",
+        ".claude/skills/dashboard/SKILL.md",
+        "CHANGELOG.md",
+        "README.md",
+        "bin/devflow-dashboard.js",
+        "bin/devflow-swarm.js",
+        "bin/devflow.js",
+        "package.json",
+        "pyproject.toml",
+        "tooling/docs/stories/.gitkeep",
+        "tooling/docs/templates/brainstorm-guide.md",
+        "tooling/docs/templates/story.md",
+        "tooling/scripts/lib/__init__.py",
+        "tooling/scripts/lib/cost_display.py",
+        "tooling/scripts/lib/pair_programming.py",
+        "tooling/scripts/lib/swarm_orchestrator.py",
+        "tooling/scripts/live_dashboard.py",
+        "tooling/scripts/new-doc.py",
+        "tooling/scripts/run-collab.py",
+        "tooling/scripts/run-story.py",
+        "tooling/scripts/setup-checkpoint-service.py"
+      ],
+      "next_steps": [
+        "Review the acceptance criteria in the story context",
+        "Examine the 23 files that have context",
+        "Implement the required functionality",
+        "Write tests for the implementation"
+      ]
+    },
+    {
+      "id": "handoff_a2389911",
+      "timestamp": "2026-01-16T12:33:48.829611",
+      "from_agent": "SM",
+      "to_agent": "DEV",
+      "story_key": "integration-test",
+      "summary": "Ready for implementation",
+      "key_decisions": [],
+      "blockers_resolved": [],
+      "watch_out_for": [],
+      "files_touched": [
+        ".claude/commands/brainstorm.md",
+        ".claude/commands/init.md",
+        ".claude/skills/brainstorm/SKILL.md",
+        ".claude/skills/dashboard/SKILL.md",
+        "CHANGELOG.md",
+        "README.md",
+        "bin/devflow-dashboard.js",
+        "bin/devflow-swarm.js",
+        "bin/devflow.js",
+        "package.json",
+        "pyproject.toml",
+        "tooling/docs/stories/.gitkeep",
+        "tooling/docs/templates/brainstorm-guide.md",
+        "tooling/docs/templates/story.md",
+        "tooling/scripts/lib/__init__.py",
+        "tooling/scripts/lib/cost_display.py",
+        "tooling/scripts/lib/pair_programming.py",
+        "tooling/scripts/lib/swarm_orchestrator.py",
+        "tooling/scripts/live_dashboard.py",
+        "tooling/scripts/new-doc.py",
+        "tooling/scripts/run-collab.py",
+        "tooling/scripts/run-story.py",
+        "tooling/scripts/setup-checkpoint-service.py"
+      ],
+      "next_steps": [
+        "Review the acceptance criteria in the story context",
+        "Examine the 23 files that have context",
+        "Implement the required functionality",
+        "Write tests for the implementation"
+      ]
     }
   ]
 }

package/tooling/.automation/memory/knowledge/kg_test-story.json

@@ -1,6 +1,6 @@
 {
   "story_key": "test-story",
-  "last_updated": "2026-01-03T14:30:38.027249",
+  "last_updated": "2026-01-16T12:33:48.803767",
   "decisions": {
     "dec_c5690ae1": {
       "id": "dec_c5690ae1",
@@ -251,6 +251,26 @@
       "context": {},
       "supersedes": null,
       "status": "active"
+    },
+    "dec_b6c0af85": {
+      "id": "dec_b6c0af85",
+      "timestamp": "2026-01-16T12:33:30.872788",
+      "agent": "DEV",
+      "topic": "approach",
+      "decision": "Use REST API",
+      "context": {},
+      "supersedes": null,
+      "status": "active"
+    },
+    "dec_0200caa6": {
+      "id": "dec_0200caa6",
+      "timestamp": "2026-01-16T12:33:48.784189",
+      "agent": "DEV",
+      "topic": "approach",
+      "decision": "Use REST API",
+      "context": {},
+      "supersedes": null,
+      "status": "active"
     }
   },
   "topic_index": {
@@ -279,7 +299,9 @@
       "dec_1f8bb74c",
       "dec_9df46791",
       "dec_6c156148",
-      "dec_c76c3450"
+      "dec_c76c3450",
+      "dec_b6c0af85",
+      "dec_0200caa6"
     ]
   },
   "handoffs": [
@@ -4110,6 +4132,266 @@
         "Implement the required functionality",
         "Write tests for the implementation"
       ]
+    },
+    {
+      "id": "handoff_70e45c92",
+      "timestamp": "2026-01-16T12:33:30.868912",
+      "from_agent": "SM",
+      "to_agent": "DEV",
+      "story_key": "test-story",
+      "summary": "Created story context",
+      "key_decisions": [],
+      "blockers_resolved": [],
+      "watch_out_for": [],
+      "files_touched": [
+        ".claude/commands/brainstorm.md",
+        ".claude/commands/init.md",
+        ".claude/skills/brainstorm/SKILL.md",
+        ".claude/skills/dashboard/SKILL.md",
+        "CHANGELOG.md",
+        "README.md",
+        "bin/devflow-dashboard.js",
+        "bin/devflow-swarm.js",
+        "bin/devflow.js",
+        "package.json",
+        "pyproject.toml",
+        "tooling/docs/stories/.gitkeep",
+        "tooling/docs/templates/brainstorm-guide.md",
+        "tooling/docs/templates/story.md",
+        "tooling/scripts/lib/__init__.py",
+        "tooling/scripts/lib/cost_display.py",
+        "tooling/scripts/lib/pair_programming.py",
+        "tooling/scripts/lib/swarm_orchestrator.py",
+        "tooling/scripts/live_dashboard.py",
+        "tooling/scripts/new-doc.py",
+        "tooling/scripts/run-collab.py",
+        "tooling/scripts/run-story.py",
+        "tooling/scripts/setup-checkpoint-service.py"
+      ],
+      "next_steps": [
+        "Review the acceptance criteria in the story context",
+        "Examine the 23 files that have context",
+        "Implement the required functionality",
+        "Write tests for the implementation"
+      ]
+    },
+    {
+      "id": "handoff_2cde7586",
+      "timestamp": "2026-01-16T12:33:30.881482",
+      "from_agent": "DEV",
+      "to_agent": "REVIEWER",
+      "story_key": "test-story",
+      "summary": "Implementation complete",
+      "key_decisions": [
+        "approach: Use REST API"
+      ],
+      "blockers_resolved": [],
+      "watch_out_for": [
+        "Watch out for rate limits"
+      ],
+      "files_touched": [
+        ".claude/commands/brainstorm.md",
+        ".claude/commands/init.md",
+        ".claude/skills/brainstorm/SKILL.md",
+        ".claude/skills/dashboard/SKILL.md",
+        "CHANGELOG.md",
+        "README.md",
+        "bin/devflow-dashboard.js",
+        "bin/devflow-swarm.js",
+        "bin/devflow.js",
+        "package.json",
+        "pyproject.toml",
+        "tooling/docs/stories/.gitkeep",
+        "tooling/docs/templates/brainstorm-guide.md",
+        "tooling/docs/templates/story.md",
+        "tooling/scripts/lib/__init__.py",
+        "tooling/scripts/lib/cost_display.py",
+        "tooling/scripts/lib/pair_programming.py",
+        "tooling/scripts/lib/swarm_orchestrator.py",
+        "tooling/scripts/live_dashboard.py",
+        "tooling/scripts/new-doc.py",
+        "tooling/scripts/run-collab.py",
+        "tooling/scripts/run-story.py",
+        "tooling/scripts/setup-checkpoint-service.py"
+      ],
+      "next_steps": [
+        "Review the 23 changed files",
+        "Check for code quality and best practices",
+        "Verify test coverage",
+        "Provide actionable feedback"
+      ]
+    },
+    {
+      "id": "handoff_b297fde0",
+      "timestamp": "2026-01-16T12:33:30.892145",
+      "from_agent": "SM",
+      "to_agent": "DEV",
+      "story_key": "test-story",
+      "summary": "Ready for development",
+      "key_decisions": [],
+      "blockers_resolved": [],
+      "watch_out_for": [],
+      "files_touched": [
+        ".claude/commands/brainstorm.md",
+        ".claude/commands/init.md",
+        ".claude/skills/brainstorm/SKILL.md",
+        ".claude/skills/dashboard/SKILL.md",
+        "CHANGELOG.md",
+        "README.md",
+        "bin/devflow-dashboard.js",
+        "bin/devflow-swarm.js",
+        "bin/devflow.js",
+        "package.json",
+        "pyproject.toml",
+        "tooling/docs/stories/.gitkeep",
+        "tooling/docs/templates/brainstorm-guide.md",
+        "tooling/docs/templates/story.md",
+        "tooling/scripts/lib/__init__.py",
+        "tooling/scripts/lib/cost_display.py",
+        "tooling/scripts/lib/pair_programming.py",
+        "tooling/scripts/lib/swarm_orchestrator.py",
+        "tooling/scripts/live_dashboard.py",
+        "tooling/scripts/new-doc.py",
+        "tooling/scripts/run-collab.py",
+        "tooling/scripts/run-story.py",
+        "tooling/scripts/setup-checkpoint-service.py"
+      ],
+      "next_steps": [
+        "Review the acceptance criteria in the story context",
+        "Examine the 23 files that have context",
+        "Implement the required functionality",
+        "Write tests for the implementation"
+      ]
+    },
+    {
+      "id": "handoff_f61128ca",
+      "timestamp": "2026-01-16T12:33:48.780259",
+      "from_agent": "SM",
+      "to_agent": "DEV",
+      "story_key": "test-story",
+      "summary": "Created story context",
+      "key_decisions": [],
+      "blockers_resolved": [],
+      "watch_out_for": [],
+      "files_touched": [
+        ".claude/commands/brainstorm.md",
+        ".claude/commands/init.md",
+        ".claude/skills/brainstorm/SKILL.md",
+        ".claude/skills/dashboard/SKILL.md",
+        "CHANGELOG.md",
+        "README.md",
+        "bin/devflow-dashboard.js",
+        "bin/devflow-swarm.js",
+        "bin/devflow.js",
+        "package.json",
+        "pyproject.toml",
+        "tooling/docs/stories/.gitkeep",
+        "tooling/docs/templates/brainstorm-guide.md",
+        "tooling/docs/templates/story.md",
+        "tooling/scripts/lib/__init__.py",
+        "tooling/scripts/lib/cost_display.py",
+        "tooling/scripts/lib/pair_programming.py",
+        "tooling/scripts/lib/swarm_orchestrator.py",
+        "tooling/scripts/live_dashboard.py",
+        "tooling/scripts/new-doc.py",
+        "tooling/scripts/run-collab.py",
+        "tooling/scripts/run-story.py",
+        "tooling/scripts/setup-checkpoint-service.py"
+      ],
+      "next_steps": [
+        "Review the acceptance criteria in the story context",
+        "Examine the 23 files that have context",
+        "Implement the required functionality",
+        "Write tests for the implementation"
+      ]
+    },
+    {
+      "id": "handoff_603c3e9a",
+      "timestamp": "2026-01-16T12:33:48.792867",
+      "from_agent": "DEV",
+      "to_agent": "REVIEWER",
+      "story_key": "test-story",
+      "summary": "Implementation complete",
+      "key_decisions": [
+        "approach: Use REST API"
+      ],
+      "blockers_resolved": [],
+      "watch_out_for": [
+        "Watch out for rate limits"
+      ],
+      "files_touched": [
+        ".claude/commands/brainstorm.md",
+        ".claude/commands/init.md",
+        ".claude/skills/brainstorm/SKILL.md",
+        ".claude/skills/dashboard/SKILL.md",
+        "CHANGELOG.md",
+        "README.md",
+        "bin/devflow-dashboard.js",
+        "bin/devflow-swarm.js",
+        "bin/devflow.js",
+        "package.json",
+        "pyproject.toml",
+        "tooling/docs/stories/.gitkeep",
+        "tooling/docs/templates/brainstorm-guide.md",
+        "tooling/docs/templates/story.md",
+        "tooling/scripts/lib/__init__.py",
+        "tooling/scripts/lib/cost_display.py",
+        "tooling/scripts/lib/pair_programming.py",
+        "tooling/scripts/lib/swarm_orchestrator.py",
+        "tooling/scripts/live_dashboard.py",
+        "tooling/scripts/new-doc.py",
+        "tooling/scripts/run-collab.py",
+        "tooling/scripts/run-story.py",
+        "tooling/scripts/setup-checkpoint-service.py"
+      ],
+      "next_steps": [
+        "Review the 23 changed files",
+        "Check for code quality and best practices",
+        "Verify test coverage",
+        "Provide actionable feedback"
+      ]
+    },
+    {
+      "id": "handoff_2eb32cc4",
+      "timestamp": "2026-01-16T12:33:48.803629",
+      "from_agent": "SM",
+      "to_agent": "DEV",
+      "story_key": "test-story",
+      "summary": "Ready for development",
+      "key_decisions": [],
+      "blockers_resolved": [],
+      "watch_out_for": [],
+      "files_touched": [
+        ".claude/commands/brainstorm.md",
+        ".claude/commands/init.md",
+        ".claude/skills/brainstorm/SKILL.md",
+        ".claude/skills/dashboard/SKILL.md",
+        "CHANGELOG.md",
+        "README.md",
+        "bin/devflow-dashboard.js",
+        "bin/devflow-swarm.js",
+        "bin/devflow.js",
+        "package.json",
+        "pyproject.toml",
+        "tooling/docs/stories/.gitkeep",
+        "tooling/docs/templates/brainstorm-guide.md",
+        "tooling/docs/templates/story.md",
+        "tooling/scripts/lib/__init__.py",
+        "tooling/scripts/lib/cost_display.py",
+        "tooling/scripts/lib/pair_programming.py",
+        "tooling/scripts/lib/swarm_orchestrator.py",
+        "tooling/scripts/live_dashboard.py",
+        "tooling/scripts/new-doc.py",
+        "tooling/scripts/run-collab.py",
+        "tooling/scripts/run-story.py",
+        "tooling/scripts/setup-checkpoint-service.py"
+      ],
+      "next_steps": [
+        "Review the acceptance criteria in the story context",
+        "Examine the 23 files that have context",
+        "Implement the required functionality",
+        "Write tests for the implementation"
+      ]
     }
   ]
 }

package/tooling/.automation/memory/shared/shared_integration-test.json

@@ -1,6 +1,6 @@
 {
   "story_key": "integration-test",
-  "last_updated": "2026-01-03T14:30:38.052354",
+  "last_updated": "2026-01-16T12:33:48.830308",
   "entries": [
     {
       "id": "mem_1bf0cedf",
@@ -241,6 +241,30 @@
       ],
       "story_key": "integration-test",
       "references": []
+    },
+    {
+      "id": "mem_3309650f",
+      "timestamp": "2026-01-16T12:33:30.919658",
+      "agent": "SM",
+      "content": "Handed off to DEV: Ready for implementation",
+      "tags": [
+        "handoff",
+        "dev"
+      ],
+      "story_key": "integration-test",
+      "references": []
+    },
+    {
+      "id": "mem_8294aaab",
+      "timestamp": "2026-01-16T12:33:48.830271",
+      "agent": "SM",
+      "content": "Handed off to DEV: Ready for implementation",
+      "tags": [
+        "handoff",
+        "dev"
+      ],
+      "story_key": "integration-test",
+      "references": []
     }
   ]
 }