agileflow 2.94.0 → 2.95.0

package/src/core/commands/update.md

@@ -523,6 +523,65 @@ OUTPUT
 
 ---
 
+## Expected Output
+
+### Success - Update Generated
+
+```
+📊 Stakeholder Update Generated
+══════════════════════════════════════════════════════════════
+
+Period: Oct 9-16, 2025 (Week)
+Audience: Executive
+Format: Markdown
+
+Data collected from:
+  ✓ status.json (45 stories)
+  ✓ 3 epics
+  ✓ Git history (28 commits)
+  ✓ Bus log (142 events)
+  ✓ 2 ADRs
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Preview
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+## Executive Summary
+**Status**: 🟢 On Track
+
+We completed the user authentication epic this week,
+delivering all planned features on schedule.
+
+**Key Highlights**:
+- ✅ 12 stories completed (velocity: 18 points)
+- 🎯 Payment integration on track for end-of-month
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Save to: docs/08-project/updates/20251016-update.md
+
+Send update? (YES/NO/EDIT)
+```
+
+### Error - No Data for Period
+
+```
+⚠️ Insufficient data for update
+
+Period: Oct 1-7, 2025
+Stories completed: 0
+Commits: 3
+
+Not enough activity to generate meaningful update.
+
+Options:
+1. Expand period to last 2 weeks
+2. Generate minimal status report
+3. Cancel
+```
+
+---
+
 ## Related Commands
 
 - `/agileflow:docs` - Synchronize documentation with code

package/src/core/commands/validate-expertise.md

@@ -221,6 +221,82 @@ RULES
 
 ---
 
+## Expected Output
+
+### Success - All Validations Pass
+
+```
+======================================
+EXPERTISE VALIDATION REPORT
+======================================
+
+Validating: database
+  [PASS] File exists: expertise.yaml
+  [PASS] Required sections present
+  [PASS] No stale learnings
+  [PASS] File size OK (142 lines)
+  [PASS] All referenced files exist
+
+Validating: api
+  [PASS] All checks passed
+
+Validating: ui
+  [PASS] All checks passed
+
+--------------------------------------
+SUMMARY
+--------------------------------------
+Total domains: 25
+Passed: 25
+Warnings: 0
+Failures: 0
+
+✅ All expertise files are valid and up-to-date.
+```
+
+### Success - Issues Found
+
+```
+======================================
+EXPERTISE VALIDATION REPORT
+======================================
+
+Validating: database
+  [PASS] File exists: expertise.yaml
+  [PASS] Required sections present
+  [WARN] 2 stale learnings (>30 days)
+  [FAIL] DRIFT: src/old/database.ts not found
+  [FAIL] DRIFT: lib/deprecated/orm.js not found
+
+Validating: api
+  [PASS] All checks passed
+
+--------------------------------------
+SUMMARY
+--------------------------------------
+Total domains: 25
+Passed: 23
+Warnings: 1
+Failures: 2
+
+RECOMMENDED ACTIONS:
+1. Update database expertise - remove reference to src/old/database.ts
+2. Update database expertise - remove reference to lib/deprecated/orm.js
+3. Review stale learnings in database domain
+```
+
+### Error - Expertise Not Found
+
+```
+❌ Expertise file not found: .agileflow/experts/mobile/expertise.yaml
+
+The 'mobile' domain has no expertise file.
+
+Create one with: /agileflow:agent mobile
+```
+
+---
+
 ## Related Commands
 
 - `/agileflow:diagnose` - System health diagnostics

package/src/core/commands/velocity.md

@@ -547,6 +547,80 @@ OUTPUT
 
 ---
 
+## Expected Output
+
+### Success - Velocity Report
+
+```
+📊 Velocity Report
+══════════════════════════════════════════════════════════════
+
+Generated: 2025-10-17 14:30
+Period: Last 4 sprints (8 weeks)
+Team: AG-UI, AG-API, AG-CI, AG-DEVOPS
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📈 Current Velocity
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Average: 8.3 points/week
+Trend: ↗️ +15% (improving)
+Last sprint: 10 points
+Confidence: High (85%)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎯 Forecast: EP-0010 (User Auth)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Stories: 8/12 completed (66%)
+Remaining: 6 points
+At current velocity: < 1 week
+Forecast completion: 2025-10-24
+Confidence: High (85%)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Saved to: docs/08-project/velocity/velocity-2025-10-17.md
+```
+
+### Success - Forecast Mode
+
+```
+📊 Epic Completion Forecast
+══════════════════════════════════════════════════════════════
+
+Epic: EP-0011 (Payment Integration)
+Current velocity: 8.3 points/week
+
+Stories: 2/8 completed (25%)
+Remaining: 6 stories, 9 points
+
+Forecast:
+  P50 (50% confidence): 2025-10-28 (11 days)
+  P80 (80% confidence): 2025-11-01 (15 days)
+  P90 (90% confidence): 2025-11-04 (18 days)
+
+⚠️ Risks:
+  - AG-API dependency (50% of velocity)
+  - 2 stories have external dependencies
+```
+
+### Error - Insufficient Data
+
+```
+⚠️ Insufficient velocity data
+
+Sample size: 3 stories completed
+Minimum required: 5 stories
+
+Velocity calculations require at least 5 completed stories
+over 3+ time periods for reliable forecasting.
+
+Complete more stories and try again.
+```
+
+---
+
 ## Related Commands
 
 - `/agileflow:sprint` - Sprint planning

package/src/core/commands/verify.md

@@ -411,6 +411,97 @@ Run without story_id to verify all in_progress stories.
 
 ---
 
+## Expected Output
+
+### Success - Tests Passing
+
+```
+🧪 Test Verification Complete
+══════════════════════════════════════════════════════════════
+
+Command: npm test
+Duration: 12.3s
+Result: ✅ PASSED
+
+Tests: 42 passed, 0 failed, 42 total
+
+Updated stories:
+  • US-0042: passing
+  • US-0043: passing
+
+All in-progress stories have passing tests ✅
+```
+
+### Error - Tests Failing
+
+```
+🧪 Test Verification Complete
+══════════════════════════════════════════════════════════════
+
+Command: npm test
+Duration: 8.7s
+Result: ❌ FAILED
+
+Tests: 40 passed, 2 failed, 42 total
+
+Failed tests:
+  ❌ auth.test.ts:42
+     Expected redirect to /dashboard
+     Got redirect to /login
+
+  ❌ auth.test.ts:67
+     Session token not persisting
+     Cookie not set after login
+
+Updated stories:
+  • US-0042: failing
+  • US-0043: failing
+
+⚠️ WARNING: 2 stories now have failing tests
+```
+
+### Error - Timeout
+
+```
+🧪 Test Verification Failed
+══════════════════════════════════════════════════════════════
+
+Command: npm test
+Result: ⏱️ TIMEOUT (60s)
+
+The test suite did not complete within 60 seconds.
+
+Updated stories:
+  • US-0042: failing (timeout)
+
+⚠️ Consider:
+1. Increase test_timeout_ms in environment.json
+2. Optimize slow tests
+3. Run specific test suites instead of all tests
+```
+
+### Error - Session Not Initialized
+
+```
+⚠️ Session Harness Not Initialized
+══════════════════════════════════════════════════════════════
+
+The verify command requires session harness configuration.
+
+Run /agileflow:session:init to:
+1. Detect your project type and test command
+2. Create environment.json configuration
+3. Enable test verification for all stories
+
+Or manually create docs/00-meta/environment.json with:
+{
+  "test_command": "npm test",
+  "test_timeout_ms": 60000
+}
+```
+
+---
+
 ## Example Execution
 
 ```

package/src/core/commands/whats-new.md

@@ -125,6 +125,75 @@ If a newer version exists, show:
 
 ---
 
+## Expected Output
+
+### Success - Changelog Display
+
+```
+╭─────────────────────────────────────────────────────╮
+│  AgileFlow Changelog                                │
+│  Current: v2.57.0                                   │
+╰─────────────────────────────────────────────────────╯
+
+## v2.57.0 (2025-12-27)
+
+### Added
+• Auto-update system with configurable check frequency
+• Update notifications in welcome message and status line
+• Changelog display after updates
+
+---
+
+## v2.56.0 (2025-12-27)
+
+### Added
+• Dynamic IDE discovery - Codex CLI now in setup
+
+### Changed
+• Replaced hardcoded IDE list with dynamic loading
+
+---
+
+## v2.55.0 (2025-12-26)
+
+### Changed
+• Consolidated code improvements and debugging
+
+---
+
+📖 Full changelog: https://github.com/projectquestorg/AgileFlow/blob/main/packages/cli/CHANGELOG.md
+🔄 Check for updates: npx agileflow update
+⚙️ Configure auto-update: /agileflow:configure --auto-update
+```
+
+### Success - Update Available
+
+```
+╭─────────────────────────────────────────────────────╮
+│  AgileFlow Changelog                                │
+│  Current: v2.57.0                                   │
+╰─────────────────────────────────────────────────────╯
+
+[changelog content...]
+
+⚡ Update available: v2.57.0 → v2.58.0
+   Run: npx agileflow update
+```
+
+### Error - Changelog Not Found
+
+```
+⚠️ Changelog not found
+
+Expected location: .agileflow/CHANGELOG.md
+
+The changelog file may be missing or AgileFlow may need to be reinstalled.
+
+Check: https://github.com/projectquestorg/AgileFlow/releases
+```
+
+---
+
 ## Related Commands
 
 - `/agileflow:changelog` - Generate changelog from commits

package/src/core/commands/workflow.md

@@ -350,6 +350,94 @@ Custom workflows (docs/08-project/workflows/):
 
 ---
 
+## Expected Output
+
+### Success - Workflow Executed
+
+```
+🔄 Workflow: review
+══════════════════════════════════════════════════════════════
+
+Arguments:
+  • path: src/auth.ts
+  • focus: security
+
+Executing workflow steps...
+
+Step 1: Reading target file(s)
+  ✓ Read src/auth.ts (245 lines)
+
+Step 2: Spawning security expert
+  ✓ agileflow-security analyzing...
+
+Step 3: Generating findings
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📋 Review Results
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Security Analysis: src/auth.ts
+
+🔴 HIGH: Hardcoded JWT secret (line 42)
+   Suggestion: Use environment variable
+
+🟡 MEDIUM: No rate limiting on login endpoint
+   Suggestion: Add rate limiter middleware
+
+🟢 LOW: Console.log in production code (line 87)
+   Suggestion: Remove or use proper logging
+
+Summary: 1 high, 1 medium, 1 low severity issues
+```
+
+### Success - List Workflows
+
+```
+📋 Available Workflows
+══════════════════════════════════════════════════════════════
+
+Built-in workflows:
+  • review        Code review with configurable focus
+  • test-feature  Test a feature end-to-end
+  • implement     Implement a story/feature
+  • analyze       Analyze codebase for issues
+
+Custom workflows (docs/08-project/workflows/):
+  • deploy-staging   Deploy to staging environment
+  • release-check    Pre-release checklist
+
+Usage: /agileflow:workflow <name> [args...]
+```
+
+### Error - Unknown Workflow
+
+```
+❌ Workflow not found: my-workflow
+
+Available workflows:
+  • review
+  • test-feature
+  • implement
+  • analyze
+
+Create custom workflow:
+  docs/08-project/workflows/my-workflow.md
+```
+
+### Error - Missing Required Argument
+
+```
+❌ Missing required argument: path
+
+Workflow 'review' requires:
+  • path (required): File or glob pattern to review
+  • focus (optional): Review focus (default: all)
+
+Usage: /agileflow:workflow review path=src/auth.ts focus=security
+```
+
+---
+
 ## Related Commands
 
 - `/agileflow:babysit` - Interactive mentor workflow

package/src/core/council/shared_reasoning.template.md

@@ -0,0 +1,106 @@
+# AI Council Deliberation
+
+## Session Info
+- **Session ID**: {{session_id}}
+- **Created**: {{timestamp}}
+- **Mode**: {{mode}} (parallel | debate)
+- **Rounds**: {{rounds}}
+
+---
+
+## Question/Proposal
+
+{{question}}
+
+---
+
+## Council Perspectives
+
+### Round 1
+
+#### Optimist Strategist
+<!-- council-optimist writes here -->
+
+[Awaiting optimist perspective...]
+
+---
+
+#### Devil's Advocate
+<!-- council-advocate writes here -->
+
+[Awaiting advocate perspective...]
+
+---
+
+#### Neutral Analyst
+<!-- council-analyst writes here -->
+
+[Awaiting analyst perspective...]
+
+---
+
+{{#if debate_mode}}
+### Round {{round_number}}
+
+#### Optimist Response
+<!-- Responds to other perspectives -->
+
+[Awaiting optimist response...]
+
+---
+
+#### Advocate Response
+<!-- Responds to other perspectives -->
+
+[Awaiting advocate response...]
+
+---
+
+#### Analyst Synthesis
+<!-- Synthesizes debate -->
+
+[Awaiting analyst synthesis...]
+
+---
+{{/if}}
+
+## Final Synthesis
+
+### Common Ground (All Agree)
+- [To be synthesized after all perspectives received]
+
+### Opportunities (Optimist Unique)
+- [From optimist perspective]
+
+### Risks (Advocate Unique)
+- [From advocate perspective]
+
+### Trade-offs (Analyst Assessment)
+- [From analyst perspective]
+
+### Recommendation
+**Decision**: [To be determined]
+**Confidence**: [High/Medium/Low]
+**Reasoning**: [Summary of key factors]
+
+### Next Steps
+1. [Action item]
+2. [Action item]
+3. [Action item]
+
+---
+
+## Metadata
+
+```json
+{
+  "session_id": "{{session_id}}",
+  "question": "{{question}}",
+  "mode": "{{mode}}",
+  "rounds": {{rounds}},
+  "agents": ["council-optimist", "council-advocate", "council-analyst"],
+  "status": "in_progress",
+  "created_at": "{{timestamp}}",
+  "completed_at": null
+}
+```