@gravirei/reis 1.2.3 → 2.1.0-beta.1

package/CHANGELOG.md

@@ -0,0 +1,318 @@
+# Changelog
+
+All notable changes to REIS 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).
+
+## [2.0.0-beta.1] - 2024-01-XX
+
+### Added - REIS Verifier 🔍
+
+**Major Feature: Automated Verification with FR4.1 Feature Completeness Validation**
+
+- **`reis verify` command** - Automated verification of execution results
+  - Verify phases: `reis verify 2` or `reis verify phase-2`
+  - Verify plans: `reis verify path/to/plan.PLAN.md`
+  - Options: `--verbose` for detailed output, `--strict` for strict mode
+
+- **reis_verifier subagent** - Comprehensive verification agent
+  - 7-step verification protocol
+  - Automated test execution and parsing
+  - Code quality checks (syntax, linting)
+  - Success criteria validation
+  - Documentation verification
+  - Detailed report generation
+  - STATE.md integration
+
+- **FR4.1: Feature Completeness Validation** - CRITICAL NEW CAPABILITY
+  - Detects when executor skips tasks or leaves features incomplete
+  - Parses all tasks from PLAN.md
+  - Extracts expected deliverables (files, functions, classes, endpoints)
+  - Verifies each deliverable exists in codebase using multiple methods:
+    * File existence checks (fs, git ls-files)
+    * Code pattern matching (grep for functions/classes)
+    * Git diff analysis
+    * Test presence verification
+  - Calculates task completion percentage (Tasks complete / Total tasks)
+  - **Requires 100% task completion to pass verification**
+  - Reports missing deliverables with search evidence
+  - Impact assessment (HIGH/MEDIUM/LOW) for incomplete tasks
+  - Specific recommendations for fixing incomplete features
+
+- **Verification Reports** - Comprehensive markdown reports
+  - Executive summary with key metrics
+  - Feature Completeness section (task-by-task breakdown)
+  - Test results with failure details
+  - Success criteria validation
+  - Code quality metrics
+  - Documentation status
+  - Issues summary (critical/major/minor)
+  - Actionable recommendations
+  - Saved to `.planning/verification/{phase}/VERIFICATION_REPORT.md`
+
+- **Templates**
+  - `templates/VERIFICATION_REPORT.md` - Report template with FR4.1 section
+  - `templates/STATE_VERIFICATION_ENTRY.md` - STATE.md entry template
+
+- **Documentation**
+  - `docs/VERIFICATION.md` - Comprehensive verification guide
+  - README.md updated with verification section
+  - FR4.1 Feature Completeness extensively documented
+  - Examples and best practices
+
+- **Test Suite**
+  - Comprehensive tests for verify command
+  - FR4.1 feature completeness validation tests
+  - Scenario tests (complete/incomplete tasks, tests pass/fail)
+  - Test coverage for all verification components
+
+### Why FR4.1 Matters
+
+Previous verification approaches only checked if tests passed. This meant:
+- ❌ Executor could skip tasks without detection
+- ❌ Tests might pass but features were missing
+- ❌ Incomplete implementations went unnoticed
+
+FR4.1 solves this by:
+- ✅ Verifying ALL planned tasks are implemented
+- ✅ Checking that deliverables actually exist
+- ✅ Providing evidence for completeness
+- ✅ Requiring 100% task completion before proceeding
+
+### Example
+
+```bash
+$ reis verify phase-2
+
+❌ VERIFICATION FAILED
+- Feature Completeness: 66% (1 task incomplete)
+- Task 2: Build Password Reset - INCOMPLETE
+  Missing: src/auth/password-reset.js, sendResetEmail()
+
+# After fixing
+$ reis verify phase-2
+
+✅ VERIFICATION PASSED
+- Feature Completeness: 100% (3/3 tasks)
+- All checks passed
+```
+
+### Technical Details
+
+- Verification protocol: 7 steps (load → test → quality → FR4.1 → docs → report → state)
+- FR4.1 uses file existence, grep patterns, git diff for verification
+- Confidence scoring (0.7-1.0) prevents false positives
+- Handles refactoring and file renames gracefully
+- Integration with STATE.md for verification history
+
+### Breaking Changes
+
+None - This is a new feature addition.
+
+### Migration
+
+No migration needed. Existing projects can immediately use `reis verify`.
+
+### Credits
+
+FR4.1 Feature Completeness Validation was designed to solve the critical gap of detecting incomplete implementations that tests alone cannot catch.
+
+---
+
+## [2.0.0-beta.1] - 2026-01-18 (Phase 4 Wave 1-2 Complete)
+
+### Added - Phase 4 Wave 1-2: Visualization & Performance
+- **Visualizer Utility** (`lib/utils/visualizer.js`)
+  - ASCII bar charts for metrics
+  - Timeline visualization for roadmap phases
+  - Progress bars with ETA
+  - Distribution charts for statistics
+  - Tables with borders and alignment
+  - Terminal-safe, width-adaptive rendering
+  - Color and monochrome mode support
+
+- **Visualize Command** (`lib/commands/visualize.js`)
+  - Real-time progress visualization
+  - Wave execution timeline
+  - Roadmap overview
+  - Metrics dashboard
+  - Watch mode with auto-refresh (5s intervals)
+  - Compact and colorless modes
+
+- **Performance Benchmarks** (`test/performance.test.js`)
+  - Baseline metrics for all utilities
+  - Config load: <50ms
+  - STATE.md operations: <100ms
+  - Git commits: <250ms
+  - Wave parsing: <150ms
+  - Metrics operations: <10ms
+  - Validation: <200ms
+  - Visualization rendering: <10ms
+  - Memory profiling for large operations
+
+### Technical Details
+- 297 tests passing (58 new tests for Phase 4 Wave 1-2)
+- All performance targets met and validated
+- Regression detection baselines established
+
+## [2.0.0-alpha.3] - 2026-01-18 (Phase 3 Complete)
+
+### Added - Phase 3: Advanced Features
+- **Plan Validator** (`lib/utils/plan-validator.js`)
+  - Validate PLAN.md structure and syntax
+  - Check wave definitions and dependencies
+  - Validate task completeness (files, actions, verification)
+  - Detect circular dependencies
+  - Provide actionable error messages
+
+- **Metrics Tracker** (`lib/utils/metrics-tracker.js`)
+  - Track wave execution metrics (duration, success rate)
+  - Log deviations and blockers
+  - Calculate phase-level and overall statistics
+  - Export metrics for analysis
+  - JSON-based metrics storage
+
+### Technical Details
+- 239 tests passing (82 new tests for Phase 3)
+- Full validator coverage with edge cases
+- Metrics persistence and retrieval
+- Performance validated (<10ms operations)
+
+## [2.0.0-alpha.2] - 2026-01-18 (Phase 2 Complete)
+
+### Added - Phase 2: Command Enhancement
+- **Enhanced execute-plan Command** (`lib/commands/execute-plan.js`)
+  - Wave-based execution with automatic checkpoints
+  - Parallel wave detection and dependency resolution
+  - Interactive mode with wave-by-wave confirmation
+  - Deviation detection and logging
+  - Git integration for wave completion commits
+
+- **Checkpoint Command** (`lib/commands/checkpoint.js`)
+  - Manual checkpoint creation with custom messages
+  - Automatic checkpoint creation between waves
+  - List all checkpoints with --list flag
+  - Git commit integration with refs/reis/checkpoints
+
+- **Resume Command** (`lib/commands/resume.js`)
+  - Smart resume with context-aware recommendations
+  - Resume from specific checkpoint with git diff display
+  - Continue wave execution from interruption point
+  - Blocker detection and next steps display
+
+- **Config Command** (`lib/commands/config.js`)
+  - Initialize reis.config.js in project root
+  - Show current configuration (merged defaults + overrides)
+  - Validate configuration files
+  - Interactive config setup
+
+### Technical Details
+- 157 tests passing (109 new tests for Phase 2)
+- Integration tests for command workflows
+- E2E scenario tests for real developer workflows
+- Backward compatible with REIS v1.x projects
+
+## [2.0.0-alpha.1] - 2026-01-18 (Phase 1 Complete)
+
+### Added - Phase 1: Foundation
+- **Config System** (`lib/utils/config.js`)
+  - Load and validate `reis.config.js` from project root
+  - Wave size configuration (small/medium/large)
+  - Git integration settings
+  - Deep merge with defaults
+  - Comprehensive validation
+  
+- **Enhanced State Management** (`lib/utils/state-manager.js`)
+  - Wave tracking with start/complete/progress
+  - Checkpoint management with history
+  - Activity logging with timestamps
+  - Metrics tracking (success rate, duration)
+  - Markdown-based state persistence
+  
+- **Git Integration** (`lib/utils/git-integration.js`)
+  - Repository detection and status checking
+  - Structured commits with metadata
+  - Wave completion auto-commits
+  - Checkpoint commits and milestone tagging
+  - Branch management and rollback support
+  
+- **Wave Execution Engine** (`lib/utils/wave-executor.js`)
+  - Parse PLAN.md into Wave objects
+  - Wave lifecycle management
+  - Sequential execution with auto-checkpoints
+  - Deviation detection and reporting
+  - Resume from checkpoint capability
+
+- **Comprehensive Test Suite**
+  - 48 unit and integration tests (100% passing)
+  - Full workflow integration tests
+  - Test coverage for all Phase 1 utilities
+
+### Technical Details
+- ~1,587 lines of utility code
+- 4 core utility modules
+- Wave-based execution model from GSD analysis
+- Backward compatible with REIS v1.x projects
+
+## [1.0.0] - 2025-01-17
+
+### Added - Initial Release
+
+#### Core System
+- **29 Commands** - Complete systematic development workflow
+  - Project initialization: `new`, `map`
+  - Requirements & roadmap: `requirements`, `roadmap`
+  - Phase management: `plan`, `discuss`, `research`, `assumptions`, `execute`, `execute-plan`, `verify`
+  - Progress tracking: `progress`, `pause`, `resume`
+  - Roadmap management: `add`, `insert`, `remove`
+  - Milestones: `milestone complete`, `milestone discuss`, `milestone new`
+  - Utilities: `todo`, `todos`, `debug`, `update`, `whats-new`, `docs`, `uninstall`
+  - Help: `help`, `version`
+
+#### 3 Specialized Subagents
+- **reis_planner** - Creates executable phase plans with task breakdown
+- **reis_executor** - Executes plans with atomic commits and deviation handling
+- **reis_project_mapper** - Maps existing codebases and bootstraps REIS structure
+
+#### Documentation (8 files)
+- `README.md` - Main documentation and architecture guide
+- `COMPLETE_COMMANDS.md` - All 29 commands with examples
+- `QUICK_REFERENCE.md` - Quick reference for daily use
+- `WORKFLOW_EXAMPLES.md` - Real-world workflow examples
+- `INTEGRATION_GUIDE.md` - Rovo Dev integration instructions
+- `SHORTCUT_GUIDE.md` - Natural language shortcuts
+- `README_DOCS.md` - Documentation navigation guide
+- `shortcuts.json` - Structured shortcut definitions
+
+#### Templates (5 files)
+- `PROJECT.md` - Project vision template
+- `REQUIREMENTS.md` - Requirements document template
+- `ROADMAP.md` - Roadmap structure template
+- `STATE.md` - State tracking template
+- `PLAN.md` - Phase plan template
+
+#### Features
+- ✅ Parallel execution - Run up to 4 subagents simultaneously
+- ✅ No context rot - Fresh 200k context per task
+- ✅ Atomic commits - One commit per task
+- ✅ Auto-fix - Bugs and gaps fixed automatically
+- ✅ Structured documentation - Always-loaded context
+- ✅ Beautiful CLI - Colors, icons, and clear formatting
+- ✅ Silent mode - CI/CD friendly installation
+- ✅ Idempotent installation - Safe to run multiple times
+
+#### Installation
+- NPM package with `npx reis` support
+- Interactive installation with confirmation prompt
+- Automatic file copying to `~/.rovodev/reis/`
+- Subagent installation to `~/.rovodev/subagents/`
+
+### Credits
+Inspired by [Get Shit Done](https://github.com/glittercowboy/get-shit-done) by TÂCHES, adapted for Atlassian Rovo Dev with enhanced parallel subagent execution.
+
+[2.0.0-beta.1]: https://github.com/Gravirei/reis/releases/tag/v2.0.0-beta.1
+[2.0.0-alpha.3]: https://github.com/Gravirei/reis/releases/tag/v2.0.0-alpha.3
+[2.0.0-alpha.2]: https://github.com/Gravirei/reis/releases/tag/v2.0.0-alpha.2
+[2.0.0-alpha.1]: https://github.com/Gravirei/reis/releases/tag/v2.0.0-alpha.1
+[1.0.0]: https://github.com/Gravirei/reis/releases/tag/v1.0.0