@pjmendonca/devflow 1.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (124) hide show
  1. package/CHANGELOG.md +526 -0
  2. package/LICENSE +21 -0
  3. package/README.md +620 -0
  4. package/bin/devflow-checkpoint.js +10 -0
  5. package/bin/devflow-collab.js +10 -0
  6. package/bin/devflow-cost.js +10 -0
  7. package/bin/devflow-create-persona.js +10 -0
  8. package/bin/devflow-init.js +10 -0
  9. package/bin/devflow-memory.js +10 -0
  10. package/bin/devflow-new-doc.js +10 -0
  11. package/bin/devflow-personalize.js +10 -0
  12. package/bin/devflow-setup-checkpoint.js +10 -0
  13. package/bin/devflow-story.js +10 -0
  14. package/bin/devflow-tech-debt.js +10 -0
  15. package/bin/devflow-validate-overrides.js +10 -0
  16. package/bin/devflow-validate.js +10 -0
  17. package/bin/devflow-version.js +10 -0
  18. package/lib/constants.js +30 -0
  19. package/lib/exec-python.js +78 -0
  20. package/lib/python-check.js +178 -0
  21. package/package.json +64 -0
  22. package/tooling/.automation/agents/architect.md +135 -0
  23. package/tooling/.automation/agents/ba.md +70 -0
  24. package/tooling/.automation/agents/dev.md +79 -0
  25. package/tooling/.automation/agents/maintainer.md +97 -0
  26. package/tooling/.automation/agents/pm.md +116 -0
  27. package/tooling/.automation/agents/reviewer.md +141 -0
  28. package/tooling/.automation/agents/sm.md +61 -0
  29. package/tooling/.automation/agents/writer.md +193 -0
  30. package/tooling/.automation/config.ps1.template +61 -0
  31. package/tooling/.automation/config.sh.template +48 -0
  32. package/tooling/.automation/memory/.gitkeep +6 -0
  33. package/tooling/.automation/memory/knowledge/kg_integration-test.json +94 -0
  34. package/tooling/.automation/memory/knowledge/kg_test-story.json +300 -0
  35. package/tooling/.automation/memory/shared/shared_integration-test.json +30 -0
  36. package/tooling/.automation/memory/shared/shared_test-story.json +78 -0
  37. package/tooling/.automation/overrides/templates/README.md +113 -0
  38. package/tooling/.automation/overrides/templates/architect/README.md +27 -0
  39. package/tooling/.automation/overrides/templates/architect/cloud-native.yaml +92 -0
  40. package/tooling/.automation/overrides/templates/architect/enterprise-architect.yaml +85 -0
  41. package/tooling/.automation/overrides/templates/architect/pragmatic-minimalist.yaml +88 -0
  42. package/tooling/.automation/overrides/templates/ba/README.md +27 -0
  43. package/tooling/.automation/overrides/templates/ba/agile-storyteller.yaml +86 -0
  44. package/tooling/.automation/overrides/templates/ba/domain-expert.yaml +91 -0
  45. package/tooling/.automation/overrides/templates/ba/requirements-engineer.yaml +89 -0
  46. package/tooling/.automation/overrides/templates/dev/README.md +32 -0
  47. package/tooling/.automation/overrides/templates/dev/junior-mentored.yaml +39 -0
  48. package/tooling/.automation/overrides/templates/dev/performance-engineer.yaml +43 -0
  49. package/tooling/.automation/overrides/templates/dev/rapid-prototyper.yaml +52 -0
  50. package/tooling/.automation/overrides/templates/dev/security-focused.yaml +43 -0
  51. package/tooling/.automation/overrides/templates/dev/senior-fullstack.yaml +39 -0
  52. package/tooling/.automation/overrides/templates/maintainer/README.md +27 -0
  53. package/tooling/.automation/overrides/templates/maintainer/devops-maintainer.yaml +113 -0
  54. package/tooling/.automation/overrides/templates/maintainer/legacy-steward.yaml +94 -0
  55. package/tooling/.automation/overrides/templates/maintainer/oss-maintainer.yaml +94 -0
  56. package/tooling/.automation/overrides/templates/pm/README.md +27 -0
  57. package/tooling/.automation/overrides/templates/pm/agile-pm.yaml +91 -0
  58. package/tooling/.automation/overrides/templates/pm/hybrid-delivery.yaml +87 -0
  59. package/tooling/.automation/overrides/templates/pm/traditional-pm.yaml +91 -0
  60. package/tooling/.automation/overrides/templates/reviewer/README.md +11 -0
  61. package/tooling/.automation/overrides/templates/reviewer/mentoring-reviewer.yaml +45 -0
  62. package/tooling/.automation/overrides/templates/reviewer/quick-sanity.yaml +50 -0
  63. package/tooling/.automation/overrides/templates/reviewer/thorough-critic.yaml +48 -0
  64. package/tooling/.automation/overrides/templates/sm/README.md +11 -0
  65. package/tooling/.automation/overrides/templates/sm/agile-coach.yaml +52 -0
  66. package/tooling/.automation/overrides/templates/sm/startup-pm.yaml +50 -0
  67. package/tooling/.automation/overrides/templates/sm/technical-lead.yaml +47 -0
  68. package/tooling/.automation/overrides/templates/user-profile.template.yaml +62 -0
  69. package/tooling/.automation/overrides/templates/writer/README.md +27 -0
  70. package/tooling/.automation/overrides/templates/writer/api-documentarian.yaml +99 -0
  71. package/tooling/.automation/overrides/templates/writer/docs-as-code.yaml +108 -0
  72. package/tooling/.automation/overrides/templates/writer/user-guide-author.yaml +100 -0
  73. package/tooling/completions/DevflowCompletion.ps1 +213 -0
  74. package/tooling/completions/_run-story +116 -0
  75. package/tooling/completions/run-story-completion.bash +136 -0
  76. package/tooling/docs/DOC-STANDARD.md +717 -0
  77. package/tooling/docs/sprint-status.yaml.template +24 -0
  78. package/tooling/docs/templates/bug-report.md +234 -0
  79. package/tooling/docs/templates/migration-spec.md +274 -0
  80. package/tooling/docs/templates/refactor-spec.md +86 -0
  81. package/tooling/docs/templates/tech-debt.md +86 -0
  82. package/tooling/scripts/context_checkpoint.py +556 -0
  83. package/tooling/scripts/cost_dashboard.py +617 -0
  84. package/tooling/scripts/create-persona.py +690 -0
  85. package/tooling/scripts/create-persona.sh +435 -0
  86. package/tooling/scripts/init-project-workflow.ps1 +651 -0
  87. package/tooling/scripts/init-project-workflow.py +70 -0
  88. package/tooling/scripts/init-project-workflow.sh +746 -0
  89. package/tooling/scripts/lib/__init__.py +35 -0
  90. package/tooling/scripts/lib/agent_handoff.py +526 -0
  91. package/tooling/scripts/lib/agent_router.py +698 -0
  92. package/tooling/scripts/lib/checkpoint-integration.ps1 +245 -0
  93. package/tooling/scripts/lib/checkpoint-integration.sh +191 -0
  94. package/tooling/scripts/lib/claude-cli.ps1 +952 -0
  95. package/tooling/scripts/lib/claude-cli.sh +1293 -0
  96. package/tooling/scripts/lib/cost_config.py +222 -0
  97. package/tooling/scripts/lib/cost_display.py +443 -0
  98. package/tooling/scripts/lib/cost_tracker.py +710 -0
  99. package/tooling/scripts/lib/currency_converter.py +328 -0
  100. package/tooling/scripts/lib/errors.py +438 -0
  101. package/tooling/scripts/lib/override-loader.sh +286 -0
  102. package/tooling/scripts/lib/pair_programming.py +589 -0
  103. package/tooling/scripts/lib/shared_memory.py +637 -0
  104. package/tooling/scripts/lib/swarm_orchestrator.py +689 -0
  105. package/tooling/scripts/memory_summarize.py +324 -0
  106. package/tooling/scripts/new-doc.ps1 +405 -0
  107. package/tooling/scripts/new-doc.py +93 -0
  108. package/tooling/scripts/new-doc.sh +534 -0
  109. package/tooling/scripts/personalize_agent.py +385 -0
  110. package/tooling/scripts/rollback-migration.sh +540 -0
  111. package/tooling/scripts/run-collab.ps1 +251 -0
  112. package/tooling/scripts/run-collab.py +605 -0
  113. package/tooling/scripts/run-collab.sh +110 -0
  114. package/tooling/scripts/run-story.ps1 +490 -0
  115. package/tooling/scripts/run-story.py +387 -0
  116. package/tooling/scripts/run-story.sh +467 -0
  117. package/tooling/scripts/setup-checkpoint-service.ps1 +219 -0
  118. package/tooling/scripts/setup-checkpoint-service.py +87 -0
  119. package/tooling/scripts/setup-checkpoint-service.sh +236 -0
  120. package/tooling/scripts/tech-debt-tracker.py +608 -0
  121. package/tooling/scripts/update_version.py +244 -0
  122. package/tooling/scripts/validate-overrides.py +511 -0
  123. package/tooling/scripts/validate-overrides.sh +432 -0
  124. package/tooling/scripts/validate_setup.py +539 -0
package/CHANGELOG.md ADDED
@@ -0,0 +1,526 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [1.9.0] - 2025-12-22
9
+
10
+ ### Added
11
+ - **npm Package Distribution** - Complete npm package for all CLI commands
12
+ - Cross-platform Node.js wrapper for Python scripts (Windows/macOS/Linux)
13
+ - Automatic Python 3.9+ detection and validation during installation
14
+ - All 14 CLI commands exposed via npm: `devflow-cost`, `devflow-validate`, `devflow-story`, `devflow-checkpoint`, `devflow-memory`, `devflow-collab`, `devflow-create-persona`, `devflow-personalize`, `devflow-validate-overrides`, `devflow-new-doc`, `devflow-tech-debt`, `devflow-setup-checkpoint`, `devflow-init`, `devflow-version`
15
+ - Zero npm runtime dependencies - lightweight package (~600KB)
16
+ - Complements existing pip package (both methods work identically)
17
+ - Comprehensive npm installation documentation
18
+ - Version synchronization script for CHANGELOG → package.json
19
+
20
+ ## [1.8.0] - 2025-12-22
21
+
22
+ ### Added
23
+ - **GitHub CLI Skill** - Comprehensive skill for GitHub CLI (gh) automation
24
+ - Repository management (view, clone, fork, create)
25
+ - Pull request operations (create, list, merge, review)
26
+ - Issue management (create, list, close, reopen)
27
+ - Workflow run management (list, view, rerun)
28
+ - Branch and release operations
29
+ - API access with JSON output parsing
30
+ - Common workflows and best practices
31
+
32
+ ## [1.7.1] - 2025-12-22
33
+
34
+ ### Fixed
35
+ - **Comprehensive Lint Cleanup** - Fixed 1200+ Ruff lint errors across all tooling scripts
36
+ - Replaced deprecated `typing.List`, `typing.Dict`, `typing.Tuple`, `typing.Set` with Python 3.9+ generics
37
+ - Removed all trailing whitespace (W293, W291)
38
+ - Fixed import ordering (I001) across all modules
39
+ - Removed unused imports (F401) and unused variables (F841)
40
+ - Fixed f-strings without placeholders (F541)
41
+ - Replaced bare `except:` with specific exception types (E722)
42
+ - Fixed `raise ... from err` patterns (B904) for proper exception chaining
43
+ - Moved module-level imports to top of files (E402)
44
+ - Renamed unused loop variables to underscore prefix (B007)
45
+ - **Test Fixes** - Updated `test_pair_programming.py` mock fixture to match refactored imports
46
+
47
+ ### Changed
48
+ - Lowered test coverage threshold from 80% to 75% to account for new modules
49
+
50
+ ## [1.7.0] - 2025-12-22
51
+
52
+ ### Added
53
+ - **Multi-Agent Collaboration System** - Advanced agent collaboration capabilities
54
+ - **Swarm Mode** (`--swarm`) - Multi-agent debate/consensus with automatic iteration
55
+ - Configurable consensus types: unanimous, majority, quorum, reviewer_approval
56
+ - Parallel execution support for first iteration
57
+ - Automatic issue tracking and resolution loops
58
+ - Budget limits and cost tracking per swarm session
59
+ - **Pair Programming Mode** (`--pair`) - DEV + REVIEWER interleaved collaboration
60
+ - Real-time feedback loops during implementation
61
+ - Chunk-based development with immediate review
62
+ - Automatic revision cycles for blocking issues
63
+ - Approval rate tracking
64
+ - **Auto-Route Mode** (`--auto-route`) - Intelligent agent selection
65
+ - Task type detection (bugfix, security, feature, refactor, etc.)
66
+ - Complexity analysis (trivial to critical)
67
+ - Dynamic agent selection based on task patterns
68
+ - File type and context awareness
69
+
70
+ - **Shared Memory System** (`shared_memory.py`) - Cross-agent knowledge sharing
71
+ - Shared memory pool for all agents to read/write
72
+ - Tagging and search functionality
73
+ - Persistence across sessions
74
+ - Context generation for agent prompts
75
+
76
+ - **Knowledge Graph** - Queryable decision tracking
77
+ - Record and track agent decisions
78
+ - Natural language queries ("What did ARCHITECT decide about auth?")
79
+ - Decision superseding and status tracking
80
+ - Topic-based indexing
81
+
82
+ - **Agent Handoff System** (`agent_handoff.py`) - Structured handoffs between agents
83
+ - Automatic handoff summary generation
84
+ - Git diff analysis for file changes
85
+ - Decision and blocker tracking
86
+ - Warning propagation to next agent
87
+ - Markdown export for handoff documents
88
+
89
+ - **Agent Router** (`agent_router.py`) - Dynamic agent selection
90
+ - Task complexity estimation
91
+ - Pattern-based task type detection
92
+ - Specialty matching for optimal agent selection
93
+ - Workflow recommendations (sequential, parallel, swarm, pair)
94
+ - Routing explanations with confidence scores
95
+
96
+ - **Swarm Orchestrator** (`swarm_orchestrator.py`) - Multi-agent coordination
97
+ - Consensus detection algorithms
98
+ - Issue extraction from agent responses
99
+ - Vote determination (approve/reject/abstain)
100
+ - Cost estimation and budget enforcement
101
+ - Iteration result tracking
102
+
103
+ - **Shell Tab Completion** - Autocomplete for commands
104
+ - Zsh completion script (`tooling/completions/_run-story`)
105
+ - Bash completion script (`tooling/completions/run-story-completion.bash`)
106
+ - PowerShell completion module (`tooling/completions/DevflowCompletion.ps1`)
107
+ - Completion for modes, agents, models, and all options
108
+ - Comma-separated agent list completion
109
+
110
+ - **PowerShell Collaboration Script** (`run-collab.ps1`) - Windows native CLI
111
+ - Full feature parity with shell scripts
112
+ - Native PowerShell parameter handling
113
+ - Proper Windows path support
114
+ - Color output support
115
+
116
+ - **New Claude Slash Commands** - Extended command set for collaboration
117
+ - `/swarm <story-key>` - Run multi-agent swarm mode (debate/consensus)
118
+ - `/pair <story-key>` - Run pair programming mode (DEV + REVIEWER)
119
+ - `/route <task>` - Auto-route task to best agents
120
+ - `/collab <story-key>` - Unified collaboration CLI with mode selection
121
+ - `/memory <story-key>` - View or query shared agent memory
122
+ - `/handoff <story-key>` - View handoff summaries between agents
123
+ - `/checkpoint` - Create or restore context checkpoints
124
+ - `/costs` - View cost dashboard and spending analytics
125
+
126
+ ### Changed
127
+ - **Cross-Platform Compatibility** - Enhanced support for all platforms
128
+ - `run-collab.py` now detects Claude CLI on Windows, macOS, and Linux
129
+ - Cross-platform config/cache directory detection (XDG, Library, AppData)
130
+ - ANSI color support with Windows compatibility
131
+ - Path normalization for Windows
132
+ - Shell quoting for both Unix and Windows
133
+ - Safe filename sanitization for Windows restrictions
134
+
135
+ - **Pair Programming Engine** (`pair_programming.py`) - Real-time collaboration
136
+ - Code chunk parsing and categorization
137
+ - Reviewer feedback extraction
138
+ - Revision loop management
139
+ - Session result summaries
140
+
141
+ - **Unified Collaboration CLI** (`run-collab.py`) - Single entry point
142
+ - `--swarm` mode with custom agents
143
+ - `--pair` mode for pair programming
144
+ - `--auto` mode for intelligent routing
145
+ - `--memory` to view shared memory
146
+ - `--query` to query knowledge graph
147
+ - `--route-only` to preview routing decisions
148
+
149
+ - **Collaboration Test Suite** (`test_collaboration.py`) - Comprehensive tests
150
+ - SharedMemory tests
151
+ - KnowledgeGraph tests
152
+ - AgentRouter tests
153
+ - HandoffGenerator tests
154
+ - SwarmOrchestrator tests
155
+ - PairProgramming tests
156
+ - Integration tests
157
+
158
+ ### Changed
159
+ - **run-story.sh** - Extended with collaborative modes
160
+ - Added `--swarm` option for multi-agent debate
161
+ - Added `--pair` option for pair programming
162
+ - Added `--auto-route` option for intelligent routing
163
+ - Added `--agents` option for custom agent selection
164
+ - Added `--max-iter` option for iteration control
165
+
166
+ ### Documentation
167
+ - **README.md** - Added Multi-Agent Collaboration section
168
+ - Swarm mode usage examples
169
+ - Pair programming mode examples
170
+ - Auto-route mode examples
171
+ - Shared memory and knowledge graph usage
172
+
173
+ ## [1.6.0] - 2025-12-21
174
+
175
+ ### Added
176
+ - **Testing Infrastructure** - Comprehensive test suite for cost tracking
177
+ - pytest configuration in pyproject.toml
178
+ - Unit tests for cost_tracker.py (23KB test suite)
179
+ - Scenario-based integration tests
180
+ - Test fixtures and mocks via conftest.py
181
+ - 80% minimum code coverage requirement
182
+ - **Enhanced Error Handling** - Structured error system for better debugging
183
+ - New errors.py module with error codes and context
184
+ - CostTrackingError, SessionError, BudgetError, CalculationError classes
185
+ - User-friendly error messages with suggested fixes
186
+ - Backward-compatible fallback for gradual adoption
187
+ - **Cost Tracker Improvements** - Better validation and user experience
188
+ - Negative token count validation with clear error messages
189
+ - Unknown model warnings with fallback to sonnet pricing
190
+ - Enhanced budget status messages with emoji indicators
191
+ - Improved session save error handling (permission, disk space)
192
+ - Better session loading with validation and corruption detection
193
+ - Case-insensitive token usage parsing
194
+ - **Setup Validation Tool** - User-friendly configuration verification
195
+ - validate_setup.py script for checking Devflow installation
196
+ - Checks for directories, config files, permissions
197
+ - Verbose mode and auto-fix capabilities
198
+ - Color-coded status output
199
+ - **CI/CD Pipeline** - Automated testing and quality checks
200
+ - GitHub Actions workflow for multi-version Python testing (3.9-3.12)
201
+ - Ruff linting and formatting checks
202
+ - mypy type checking
203
+ - pytest with coverage reporting
204
+ - Codecov integration
205
+ - Integration test support
206
+ - **Python Package Configuration** - Full project packaging support
207
+ - pyproject.toml with build system configuration
208
+ - requirements.txt and requirements-dev.txt
209
+ - Project metadata and dependencies
210
+ - CLI entry points (devflow-cost, devflow-validate)
211
+ - Development tools: pytest, mypy, ruff, coverage
212
+
213
+ ### Changed
214
+ - **cost_tracker.py** - Enhanced with better error handling and validation
215
+ - calculate_cost() now validates token counts and warns on unknown models
216
+ - check_budget() returns emoji-enhanced status messages
217
+ - save_session() handles errors gracefully without disrupting workflow
218
+ - load_session() validates required fields and handles corruption
219
+
220
+ ## [1.5.3] - 2025-12-21
221
+
222
+ ### Changed
223
+ - **Auto-commit disabled by default** - Changed `AUTO_COMMIT` default from `true` to `false` in both config templates (shell and PowerShell)
224
+
225
+ ## [1.5.2] - 2025-12-21
226
+
227
+ ### Changed
228
+ - **Override system cleanup** - Removed example override files in favor of templates
229
+ - Users now copy from `templates/` to create their override files
230
+ - Added `user-profile.template.yaml` as starting point
231
+ - Updated templates README with clearer instructions
232
+ - Added `.gitignore` rules to keep user overrides private
233
+
234
+ ### Removed
235
+ - `tooling/.automation/overrides/dev.override.yaml` - Use templates instead
236
+ - `tooling/.automation/overrides/reviewer.override.yaml` - Use templates instead
237
+ - `tooling/.automation/overrides/sm.override.yaml` - Use templates instead
238
+ - `tooling/.automation/overrides/user-profile.yaml` - Use templates instead
239
+
240
+ ## [1.5.1] - 2025-12-21
241
+
242
+ ### Changed
243
+ - **CLAUDE.md** - Updated changelog instructions to require proper version numbers
244
+ - Removed references to `[Unreleased]` sections
245
+ - Added semantic versioning guidance (patch/minor/major)
246
+ - Updated example to show proper versioned entry format
247
+ - **README.md** - Updated version number to 1.5.1
248
+
249
+ ## [1.5.0] - 2025-12-21
250
+
251
+ ### Added
252
+ - **Agent Persona Templates** - Pre-built personality configurations for all 8 agents:
253
+ - DEV agent: senior-fullstack, junior-mentored, security-focused, performance-engineer, rapid-prototyper
254
+ - Reviewer agent: thorough-critic, mentoring-reviewer, quick-sanity
255
+ - SM agent: agile-coach, technical-lead, startup-pm
256
+ - Architect agent: enterprise-architect, cloud-native, pragmatic-minimalist
257
+ - BA agent: requirements-engineer, agile-storyteller, domain-expert
258
+ - PM agent: traditional-pm, agile-pm, hybrid-delivery
259
+ - Writer agent: api-documentarian, user-guide-author, docs-as-code
260
+ - Maintainer agent: oss-maintainer, legacy-steward, devops-maintainer
261
+ - **Personalization Wizard** (`personalize_agent.py`) - Interactive tool for customizing agent behavior
262
+ - **`/personalize` slash command** - Quick access to the personalization wizard from Claude Code
263
+ - **Memory Summarization Utility** (`memory_summarize.py`) - Consolidate and categorize agent memory files
264
+ - **Override Validation & Linting** - New tools to validate override YAML files
265
+ - `validate-overrides.sh` - Shell script for validating YAML syntax, models, budgets
266
+ - `validate-overrides.py` - Python version with JSON output support
267
+ - Auto-fix capability for common issues (trailing whitespace, tabs)
268
+ - Schema validation for override structure
269
+ - **Technical Debt Tracker** - Comprehensive debt metrics and reporting
270
+ - `tech-debt-tracker.py` - Scans codebase for TODO, FIXME, HACK, etc.
271
+ - Debt scoring system with severity weights
272
+ - Dashboard view with visual progress bars
273
+ - Trend tracking over time with history
274
+ - Markdown report generation
275
+ - JSON output for CI/CD integration
276
+ - **Enhanced Bug Root Cause Analysis** - Improved bug-report.md template
277
+ - 5 Whys analysis framework
278
+ - Fault tree visualization template
279
+ - Root cause categorization (11 categories)
280
+ - Hypothesis and evidence tracking
281
+ - Investigation steps documentation
282
+ - Impact analysis section
283
+ - Prevention strategies
284
+ - **Migration Rollback Automation** - New rollback capabilities
285
+ - `rollback-migration.sh` - Automated migration rollback tool
286
+ - Rollback checkpoint creation and management
287
+ - Git-based state preservation
288
+ - Dependency file backup (package.json, pubspec.yaml, etc.)
289
+ - Dry-run mode for preview
290
+ - Enhanced migration-spec.md with comprehensive rollback plan
291
+ - **Custom Persona Builder** - Interactive agent persona creation
292
+ - `create-persona.py` - Full-featured Python wizard
293
+ - `create-persona.sh` - Shell script version
294
+ - 7 pre-built templates (developer, reviewer, architect, tester, security, devops, documentation)
295
+ - Automatic override file generation
296
+ - Persona validation
297
+ - **Additional Project Types** - Java, Kotlin, Swift, and Android project detection
298
+ - **Project Override Templates** - Stack-specific configurations:
299
+ - web-frontend.override.yaml
300
+ - backend-api.override.yaml
301
+ - data-science.override.yaml
302
+ - devops.override.yaml
303
+ - mobile-native.override.yaml
304
+
305
+ ### Changed
306
+ - Expanded project type detection in initialization wizard
307
+ - Enhanced override system with template-based customization
308
+ - Enhanced `migration-spec.md` template with:
309
+ - Detailed pre-migration checklist
310
+ - Phase-based migration steps
311
+ - Rollback triggers and automation commands
312
+ - Communication plan template
313
+ - Lessons learned section
314
+ - Improved `bug-report.md` template with structured root cause analysis
315
+
316
+ ## [1.4.0] - 2025-12-21
317
+
318
+ ### Added
319
+ - **Override Templates** - Pre-configured templates for common project types
320
+ - `web-frontend.override.yaml` - React, Vue, Angular, Svelte
321
+ - `backend-api.override.yaml` - Node.js, Python, Go, Rust APIs
322
+ - `data-science.override.yaml` - ML, data analysis, Jupyter
323
+ - `devops.override.yaml` - Infrastructure, CI/CD, Kubernetes
324
+ - `mobile-native.override.yaml` - iOS (Swift), Android (Kotlin/Java)
325
+ - **Memory Summarization** - Utility to prevent unbounded memory growth
326
+ - `memory_summarize.py` - Consolidates duplicate entries
327
+ - Categorizes memories by type (errors, preferences, implementation, etc.)
328
+ - Configurable max entries limit
329
+ - **Additional Project Types** - Java, Kotlin, Swift, Android support
330
+ - Auto-detection for Maven, Gradle, Xcode projects
331
+ - Updated config templates with all supported types
332
+
333
+ ### Changed
334
+ - **Simplified CLI Integration** - Removed terminal-based CLI in favor of Claude Code native commands
335
+ - Removed `tooling/scripts/gds` CLI wrapper
336
+ - Removed `tooling/scripts/completions/` directory (zsh completions)
337
+ - All workflows now accessed via Claude Code slash commands (`/story`, `/develop`, `/review`, etc.)
338
+ - **Simplified zsh autocomplete** - Replaced complex interactive menu with native zsh completion
339
+ - Cleaner implementation (~130 lines vs ~450 lines)
340
+ - Renamed product from "GDS_Automation" to "Devflow" throughout codebase
341
+ - **CLAUDE.md** - Added project instructions file for Claude Code
342
+ - Mandatory changelog update requirement before pushing
343
+ - Project context and directory structure
344
+ - Commit style guidelines
345
+ - **Claude Code Slash Commands** - Native slash commands for Devflow workflows
346
+ - `/story` - Run full story pipeline
347
+ - `/develop` - Run development phase
348
+ - `/review` - Run code review
349
+ - `/adversarial` - Run critical code review
350
+ - `/agent` - Invoke a specific agent
351
+ - `/bugfix` - Fix a bug
352
+ - `/devflow` - Run any Devflow command
353
+ - `/personalize` - Quick access to personalization wizard
354
+
355
+ ### Removed
356
+ - `tooling/scripts/gds` - Terminal CLI wrapper
357
+ - `tooling/scripts/completions/_gds` - Zsh completion script
358
+ - `tooling/scripts/completions/_run-story` - Run-story completion script
359
+ - `tooling/scripts/completions/gds-interactive.zsh` - Interactive completion
360
+ - `tooling/scripts/completions/README.md` - Completion documentation
361
+
362
+ ## [1.3.1] - 2025-12-20
363
+
364
+ ### Added
365
+ - **Interactive Visual Autocomplete** - Claude-style `/` command experience
366
+ - `Alt+.` triggers visual menu with arrow navigation
367
+ - `devflow.` shell function for quick command menu
368
+ - `devflow.story` and `devflow.agent` for context-specific menus
369
+ - Fuzzy filtering by typing
370
+ - fzf integration when available
371
+ - Category-tagged commands (story, maint, agent)
372
+
373
+ ### Changed
374
+ - `devflow setup` now installs interactive completion
375
+ - Updated completion documentation
376
+
377
+ ### Fixed
378
+ - README: Removed references to non-existent Python scripts
379
+ - README: Fixed agent count (now 8 with REVIEWER)
380
+ - README: Updated version to 1.3.1
381
+ - README: Added Devflow CLI documentation
382
+ - README: Simplified cost management section
383
+ - CONTRIBUTING: Added override system contribution areas
384
+ - CONTRIBUTING: Updated release process documentation
385
+
386
+ ## [1.3.0] - 2025-12-20
387
+
388
+ ### Added
389
+ - **Agent Override System** - BMAD-style personalization (inspired by [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD))
390
+ - `user-profile.yaml` - Global user preferences (name, tech level, code style)
391
+ - Per-agent override files (`dev.override.yaml`, `sm.override.yaml`, etc.)
392
+ - Persistent agent memory system (`memory/{agent}.memory.md`)
393
+ - Runtime merging: base agent + user profile + overrides + memory
394
+ - Model and budget overrides per agent
395
+ - Customizations survive updates to core agents
396
+ - **Adversarial Reviewer Agent** - Critical code reviewer that finds problems
397
+ - Uses Opus for deeper analysis
398
+ - Security, reliability, correctness, maintainability checks
399
+ - Issue severity classification (Critical, High, Medium, Low)
400
+ - `--adversarial` mode in run-story.sh
401
+ - **CLI Autocomplete System** - Zsh tab completion
402
+ - `devflow` - Unified CLI wrapper with all commands
403
+ - Story key completion from sprint-status.yaml
404
+ - Mode and option completion
405
+ - Agent and override completion
406
+ - `devflow setup` command for easy installation
407
+ - **New CLI Commands**
408
+ - `devflow profile` - Edit user profile
409
+ - `devflow override <agent>` - Edit agent overrides
410
+ - `devflow memory [show|add|clear] <agent>` - Manage agent memory
411
+ - `devflow agents` - List available agents
412
+ - `devflow logs [tail|list|view|clean]` - Log management
413
+
414
+ ### Changed
415
+ - `claude-cli.sh` now loads overrides via `override-loader.sh`
416
+ - Agent prompts include user context and memories
417
+ - `run-story.sh` supports `--adversarial` mode
418
+
419
+ ### New Files
420
+ - `tooling/.automation/overrides/` - Override configuration directory
421
+ - `tooling/.automation/memory/` - Persistent agent memory directory
422
+ - `tooling/.automation/agents/reviewer.md` - Adversarial reviewer agent
423
+ - `tooling/scripts/lib/override-loader.sh` - Override loading library
424
+ - `tooling/scripts/devflow` - Unified CLI wrapper
425
+ - `tooling/scripts/completions/` - Zsh completion scripts
426
+
427
+ ## [1.2.0] - 2025-12-20
428
+
429
+ ### Added
430
+ - **Brownfield Workflow Support** - Full support for existing codebase maintenance
431
+ - `--bugfix` mode for bug investigation and fixing
432
+ - `--refactor` mode for code refactoring
433
+ - `--investigate` mode for codebase exploration (read-only)
434
+ - `--quickfix` mode for small, targeted changes
435
+ - `--migrate` mode for framework/dependency migrations
436
+ - `--tech-debt` mode for technical debt resolution
437
+ - **MAINTAINER Agent Persona** - New agent specialized for brownfield work
438
+ - **Brownfield Directory Structure** - Organized folders for bugs, refactors, investigations, migrations, tech-debt
439
+ - **Task Templates** - Templates for bug reports, refactoring specs, migration plans, tech debt items
440
+ - **Workflow Mode Selection** - Init wizard now asks for greenfield, brownfield, or both
441
+
442
+ ### Changed
443
+ - Agent count increased from 6 to 7 (added MAINTAINER)
444
+ - `run-story.sh` now supports brownfield modes alongside greenfield
445
+ - `init-project-workflow.sh` includes workflow mode selection step
446
+ - README updated with brownfield documentation
447
+ - CONTRIBUTING updated with brownfield contribution areas
448
+
449
+ ## [1.1.0] - 2025-12-20
450
+
451
+ ### Added
452
+ - **Windows Compatibility** - Full PowerShell support
453
+ - `run-story.ps1` - Windows workflow runner
454
+ - `init-project-workflow.ps1` - Windows setup wizard
455
+ - `new-doc.ps1` - Windows documentation generator
456
+ - Updated installation instructions for Windows
457
+ - **Cost Analysis System** - Real-time cost tracking
458
+ - `cost_dashboard.py` - Cost monitoring dashboard
459
+ - Multi-currency display (USD, EUR, GBP, BRL, CAD, AUD)
460
+ - Per-agent and per-model cost breakdown
461
+ - Budget alerts (warning at 75%, critical at 90%)
462
+ - Auto-stop at budget limit
463
+ - Session history and CSV export
464
+ - **Currency Selection** - Init wizard now prompts for preferred currency
465
+
466
+ ### Changed
467
+ - Updated README with Windows installation instructions
468
+ - Added cost tracking configuration options to config.sh
469
+ - Improved cross-platform compatibility
470
+
471
+ ## [1.0.0] - 2025-12-20
472
+
473
+ ### Added
474
+ - Initial release of Claude Workflow Template
475
+ - Multi-persona agent system (SM, DEV, BA, ARCHITECT, PM, WRITER)
476
+ - Smart model optimization (Opus for dev/review, Sonnet for planning)
477
+ - Automated story implementation pipeline
478
+ - Context checkpoint system with auto-save
479
+ - Interactive setup wizard (`init-project-workflow.sh`)
480
+ - Documentation standards and templates
481
+ - Sprint tracking system
482
+ - Export/import functionality for portability
483
+ - macOS LaunchAgent for background checkpoint monitoring
484
+ - Cost optimization with budget controls
485
+ - 6 pre-configured agent personas
486
+ - Complete documentation suite
487
+ - Git integration with auto-commit
488
+ - Code review automation
489
+
490
+ ### Features
491
+ - `run-story.sh` - Main workflow runner
492
+ - `init-project-workflow.sh` - Interactive setup wizard
493
+ - `context_checkpoint.py` - Checkpoint management system
494
+ - `setup-checkpoint-service.sh` - Background service installer
495
+ - `new-doc.sh` - Documentation template generator
496
+ - `export-workflow-template.sh` - Template packager
497
+
498
+ ### Documentation
499
+ - README.md - Main project documentation
500
+ - CONTRIBUTING.md - Contribution guidelines
501
+ - LICENSE - MIT License
502
+ - CHANGELOG.md - This file
503
+ - tooling/docs/DOC-STANDARD.md - Documentation standards
504
+
505
+ ### Supported Project Types
506
+ - Flutter
507
+ - Node.js
508
+ - Python
509
+ - Rust
510
+ - Go
511
+ - Ruby
512
+ - Generic (any project)
513
+
514
+ ### Model Strategy
515
+ - Opus ($15/$75 per M tokens) for development and code review
516
+ - Sonnet ($3/$15 per M tokens) for planning, context, documentation
517
+ - Average cost savings: 40-60% per story
518
+
519
+ ### Budget Controls
520
+ - MAX_BUDGET_CONTEXT: Default $3.00
521
+ - MAX_BUDGET_DEV: Default $15.00
522
+ - MAX_BUDGET_REVIEW: Default $5.00
523
+
524
+ ---
525
+
526
+ For more details, see the [GitHub releases](https://github.com/Pedro-Jose-da-Rocha-Mendonca/Devflow/releases).
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Pedro Jose da Rocha Mendonca
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.