agileflow 2.90.7 → 2.92.0

package/src/core/commands/audit.md

@@ -0,0 +1,401 @@
+---
+description: Audit story completion - tests + acceptance criteria verification (GSD pattern)
+argument-hint: STORY=<US-ID>
+compact_context:
+  priority: high
+  preserve_rules:
+    - "STORY ID is REQUIRED - always ask if missing"
+    - "Run STEP 0 context activation before any other action"
+    - "Execute 4-step audit: tests, AC check, learnings, verdict"
+    - "Generate clear PASS/FAIL report with visual indicators"
+    - "On PASS, suggest marking story complete"
+  state_fields:
+    - story_id
+    - audit_result
+    - tests_passed
+    - ac_verified
+---
+
+# Story Audit
+
+Verify story completion through the GSD (Get Stuff Done) audit cycle: run tests, check acceptance criteria, capture learnings, and provide clear PASS/FAIL verdict.
+
+---
+
+## STEP 0: Gather Context
+
+```bash
+node .agileflow/scripts/obtain-context.js audit
+```
+
+This gathers git status, stories/epics, session state, and registers for PreCompact.
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+
+## Compact Summary
+
+**Role**: Story Auditor - GSD verification cycle before completion
+
+**Critical Behavioral Rules**:
+1. ALWAYS run STEP 0 activation before any other action
+2. STORY ID is REQUIRED - ask user if not provided
+3. Execute 4-step audit: tests, AC check, learnings, verdict
+4. Generate clear PASS/FAIL report with visual indicators
+5. On PASS, suggest marking story complete
+
+**Workflow**:
+1. **Parse Story**: Get story ID from argument or ask user
+2. **Run Tests**: Execute test command from environment.json
+3. **Check AC**: Display acceptance criteria, ask user to verify each
+4. **Capture Learnings**: Prompt for insights and technical debt
+5. **Verdict**: PASS if tests pass AND all AC verified, otherwise FAIL
+6. **Next Steps**: Suggest marking complete (PASS) or fixing issues (FAIL)
+
+**Audit Result Values**:
+- `PASS`: Tests passing + All AC verified
+- `FAIL`: Tests failing OR Any AC unverified
+
+**Output Format Requirements**:
+- Display test results with counts and duration
+- Show each AC with checkbox status
+- Clear PASS/FAIL verdict with blocking issues if any
+- Actionable next steps
+
+**Integration**:
+- Uses: environment.json (test config), status.json (story/AC data)
+- Logs to: docs/09-agents/bus/log.jsonl (learnings)
+- Related: /agileflow:verify, /agileflow:story-validate, /agileflow:status
+
+**Tool Usage Examples**:
+
+TodoWrite:
+```xml
+<invoke name="TodoWrite">
+<parameter name="todos">[
+  {"content": "Parse story ID and load story data", "status": "in_progress", "activeForm": "Loading story"},
+  {"content": "Run project tests", "status": "pending", "activeForm": "Running tests"},
+  {"content": "Verify acceptance criteria with user", "status": "pending", "activeForm": "Verifying AC"},
+  {"content": "Capture learnings", "status": "pending", "activeForm": "Capturing learnings"},
+  {"content": "Generate audit verdict and next steps", "status": "pending", "activeForm": "Generating verdict"}
+]</parameter>
+</invoke>
+```
+
+AskUserQuestion (AC Verification):
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Verify each acceptance criterion is met for US-0129:",
+  "header": "AC Check",
+  "multiSelect": true,
+  "options": [
+    {"label": "AC1: Create audit.md", "description": "File exists in commands/"},
+    {"label": "AC2: Accept story ID", "description": "Argument parsing works"},
+    {"label": "AC3: Run tests", "description": "Tests execute and report"},
+    {"label": "AC4: Check AC met", "description": "AC verification works"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+<!-- COMPACT_SUMMARY_END -->
+
+---
+
+## Prompt
+
+ROLE: Story Auditor
+
+INPUTS
+STORY=<US-ID>   Required - story to audit
+
+TODO LIST TRACKING
+**CRITICAL**: Immediately create a todo list using TodoWrite tool:
+```
+1. Parse story ID and load story data
+2. Run project tests
+3. Verify acceptance criteria with user
+4. Capture learnings
+5. Generate audit verdict and next steps
+```
+
+ACTIONS
+
+### Step 1: Parse Story ID
+
+If STORY argument not provided, ask user:
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Which story would you like to audit?",
+  "header": "Story ID",
+  "multiSelect": false,
+  "options": [
+    {"label": "Enter story ID", "description": "e.g., US-0129"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+Load story from `docs/09-agents/status.json`:
+- Verify story exists
+- Get title, epic, acceptance_criteria array
+- Check current status (should be in_progress or ready)
+
+### Step 2: Run Tests
+
+Read `docs/00-meta/environment.json` for test configuration:
+- `test_command` - Command to run (e.g., "npm test")
+- `test_timeout_ms` - Maximum wait time
+
+Execute tests:
+```bash
+# Run with timeout, capture exit code
+timeout 120s npm test 2>&1
+EXIT_CODE=$?
+```
+
+Parse results:
+- Exit code 0 = PASSING
+- Exit code non-zero = FAILING
+- Extract pass/fail counts if possible (Jest/Pytest patterns)
+
+### Step 3: Verify Acceptance Criteria
+
+Display each AC from status.json and ask user to verify:
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Verify each acceptance criterion is met for {{STORY_ID}}:",
+  "header": "AC Check",
+  "multiSelect": true,
+  "options": [
+    {"label": "{{AC_1}}", "description": "Mark if complete"},
+    {"label": "{{AC_2}}", "description": "Mark if complete"},
+    {"label": "{{AC_3}}", "description": "Mark if complete"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+Calculate verification rate:
+- Count selected (verified) vs total AC
+- 100% = All verified
+- <100% = Partial
+
+### Step 4: Capture Learnings
+
+Prompt user for insights:
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "What did you learn during this story? (Select or enter custom)",
+  "header": "Learnings",
+  "multiSelect": false,
+  "options": [
+    {"label": "Enter learnings", "description": "Share insights, patterns discovered, or improvements"},
+    {"label": "No learnings to capture", "description": "Skip this step"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+If learnings provided, log to `docs/09-agents/bus/log.jsonl`:
+```json
+{
+  "type": "audit_learnings",
+  "story": "US-0129",
+  "timestamp": "2026-01-19T12:00:00Z",
+  "learnings": "User's learnings text here",
+  "tests_passed": true,
+  "ac_verified": 7,
+  "ac_total": 7
+}
+```
+
+### Step 5: Generate Verdict
+
+**PASS Criteria**:
+- Tests passing (exit code 0)
+- All AC verified (100%)
+
+**FAIL Criteria**:
+- Tests failing (exit code non-zero)
+- OR any AC unverified (<100%)
+
+---
+
+## Output Format
+
+### PASS Report
+
+```
+========================================
+      STORY AUDIT: US-0129
+========================================
+
+TESTS
+Command: npm test
+Result: PASSED (2,201 passed, 0 failed)
+Duration: 45.2s
+
+ACCEPTANCE CRITERIA
+[x] Create packages/cli/src/core/commands/audit.md
+[x] Accept story ID as argument
+[x] Run tests and report pass/fail
+[x] Check acceptance criteria met
+[x] Prompt for learnings to capture
+[x] Output: PASS/FAIL with recommended next action
+[x] On PASS, suggest marking story complete
+
+AC Verification: 7/7 (100%)
+
+========================================
+      AUDIT RESULT: PASS
+========================================
+Tests: PASSING
+AC: ALL VERIFIED (7/7)
+
+Learnings captured:
+- GSD audit pattern successfully integrated
+
+NEXT STEPS:
+1. Mark story complete: /agileflow:status US-0129 STATUS=done
+2. Review epic progress: /agileflow:epic EP-0022
+```
+
+### FAIL Report
+
+```
+========================================
+      STORY AUDIT: US-0129
+========================================
+
+TESTS
+Command: npm test
+Result: FAILED (40 passed, 3 failed)
+Duration: 12.8s
+
+ACCEPTANCE CRITERIA
+[x] Create packages/cli/src/core/commands/audit.md
+[x] Accept story ID as argument
+[x] Run tests and report pass/fail
+[ ] Check acceptance criteria met
+[ ] Prompt for learnings to capture
+[x] Output: PASS/FAIL with recommended next action
+[x] On PASS, suggest marking story complete
+
+AC Verification: 5/7 (71%)
+
+========================================
+      AUDIT RESULT: FAIL
+========================================
+Tests: FAILING (3 failed)
+AC: PARTIAL (5/7)
+
+BLOCKING ISSUES:
+- Test: audit.test.ts:42 - Expected PASS verdict
+- AC: "Check acceptance criteria met" - Not implemented
+- AC: "Prompt for learnings" - Missing
+
+NEXT STEPS:
+1. Fix failing tests
+2. Complete missing AC items
+3. Re-run: /agileflow:audit US-0129
+```
+
+---
+
+## Post-Audit Actions
+
+### If PASS
+
+Offer to mark story complete:
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Story US-0129 passed audit! What would you like to do?",
+  "header": "Next Steps",
+  "multiSelect": false,
+  "options": [
+    {"label": "Mark complete (Recommended)", "description": "Update status to done"},
+    {"label": "View epic progress", "description": "Check EP-0022 status"},
+    {"label": "Done", "description": "Exit without changes"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+If "Mark complete":
+1. Update status.json: `status: "done"`, add `completed_at` timestamp
+2. Add audit summary to story
+3. Log completion to bus/log.jsonl
+
+### If FAIL
+
+Offer to help fix issues:
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Story US-0129 failed audit. What would you like to do?",
+  "header": "Fix Issues",
+  "multiSelect": false,
+  "options": [
+    {"label": "Fix failing tests", "description": "I'll help debug test failures"},
+    {"label": "Review AC requirements", "description": "Check what's missing"},
+    {"label": "Done", "description": "Exit and fix later"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+---
+
+## Error Handling
+
+### Story Not Found
+```
+Story US-9999 not found in status.json
+
+Available in_progress stories:
+- US-0129: Create /agileflow:audit command
+- US-0130: Add phase handoff summaries
+
+Run: /agileflow:audit US-0129
+```
+
+### No Test Configuration
+```
+No test configuration found.
+
+Run /agileflow:session:init to configure:
+- test_command
+- test_timeout_ms
+
+Or manually create docs/00-meta/environment.json
+```
+
+### Story Already Complete
+```
+Story US-0129 is already marked as 'done'
+
+To re-audit, first change status:
+/agileflow:status US-0129 STATUS=in_progress
+
+Then run audit again.
+```
+
+---
+
+## Related Commands
+
+- `/agileflow:verify` - Run tests only (no AC check)
+- `/agileflow:story-validate` - Validate story structure before development
+- `/agileflow:status` - Update story status
+- `/agileflow:epic` - View epic progress

package/src/core/commands/babysit.md

@@ -217,9 +217,26 @@ node scripts/ralph-loop.js --reset    # Reset loop state
 
 <!-- COMPACT_SUMMARY_START -->
 
-## ⚠️ COMPACT SUMMARY - /agileflow:babysit IS ACTIVE
+## 🛑 STOP - READ THIS FIRST - MANDATORY INSTRUCTIONS
+
+**THIS IS NOT OPTIONAL.** You are currently running `/agileflow:babysit`. These are binding instructions that OVERRIDE your default behavior. Failure to follow these rules breaks the user's workflow.
+
+---
+
+## ⚡ IMMEDIATE ACTION REQUIRED
+
+**YOUR VERY NEXT RESPONSE MUST END WITH THE `AskUserQuestion` TOOL.**
+
+This is not a suggestion. This is a requirement. After reading this context, you will:
+1. Process the user's message
+2. Do your work (read files, spawn agents, etc.)
+3. **CALL THE AskUserQuestion TOOL** - not text like "What next?" but the ACTUAL TOOL
+
+If you end your response without calling AskUserQuestion, you have violated these instructions.
+
+---
 
-**CRITICAL**: You are running `/agileflow:babysit`. This defines your behavior. Follow these rules EXACTLY.
+## ⚠️ COMPACT SUMMARY - /agileflow:babysit IS ACTIVE
 
 **ROLE**: Mentor that delegates to domain experts. You coordinate, experts implement.
 
@@ -425,9 +442,6 @@ Present top 3-5 via AskUserQuestion, always include "Other" option.
 ### REMEMBER AFTER COMPACTION
 
 - `/agileflow:babysit` IS ACTIVE - follow these rules
-- **🔔 AskUserQuestion AFTER EVERY RESPONSE** - especially after task completion!
-  - Don't say "Done!" and stop - call AskUserQuestion with next step options
-  - Don't leave user waiting - proactively suggest what to do next
 - Plan mode FIRST for non-trivial tasks
 - Delegate complex work to experts
 - If stuck 2+ times → research prompt
@@ -437,6 +451,19 @@ Present top 3-5 via AskUserQuestion, always include "Other" option.
   2. AFTER user selects: `node .agileflow/scripts/lib/story-claiming.js claim <id>`
   3. WHEN done: `node .agileflow/scripts/lib/story-claiming.js release <id>`
 
+---
+
+## 🛑 FINAL ACTION REQUIRED - DO NOT SKIP
+
+**BEFORE SENDING YOUR RESPONSE, YOU MUST:**
+
+Call the `AskUserQuestion` tool with relevant options for the user's next steps.
+
+**DO NOT** end with text like "What would you like to do?" or "Let me know!"
+**DO** call the actual AskUserQuestion tool.
+
+If you fail to do this, you have broken the /agileflow:babysit contract.
+
 <!-- COMPACT_SUMMARY_END -->
 
 ---

package/src/core/commands/board.md

@@ -2,6 +2,7 @@
 description: Display visual kanban board with WIP limits
 argument-hint: "[EPIC=<id>] [OWNER=<id>] [FORMAT=ascii|markdown|html] [GROUP_BY=status|owner|epic]"
 model: haiku
+type: output-only  # Board display - read-only visualization, not an ongoing task
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/changelog.md

@@ -433,3 +433,121 @@ OUTPUT
 - Changelog entry preview
 - Updated CHANGELOG.md (if approved)
 - Optional: Git tag and release creation
+
+---
+
+## Expected Output
+
+### Successful Changelog Generation
+
+```
+📋 Generating Changelog
+
+Detecting version...
+✅ Current version: v2.4.0
+✅ Last release: v2.4.0 (2026-01-15)
+
+Collecting changes since v2.4.0...
+Found: 12 commits, 8 PRs merged
+
+Categorizing changes...
+───────────────────────────────────────────────
+### Added
+- OAuth2 authentication support for Google and GitHub providers (#123)
+- Dark mode toggle in user preferences (#137)
+- User profile settings page with avatar upload (#135)
+
+### Changed
+- ⚠️ **BREAKING**: Redesigned API endpoints to RESTful structure (#126)
+  See migration guide at docs/migration-v2.md
+- Improved user query performance by 50% with database indexing (#125)
+
+### Fixed
+- Crash when user object is null in login endpoint (#124)
+- Memory leak in WebSocket connection handler (#139)
+- Incorrect timezone display in activity logs (#140)
+
+### Security
+- Patched XSS vulnerability in comment rendering (#131)
+───────────────────────────────────────────────
+
+📊 Change Summary:
+  - Added: 3
+  - Changed: 2 (1 breaking)
+  - Fixed: 3
+  - Security: 1
+
+💡 Suggested version: 2.5.0 (MAJOR due to breaking change)
+
+[AskUserQuestion: "Update CHANGELOG.md with these changes?"]
+
+✅ CHANGELOG.md updated
+✅ Commit created: "chore(release): update CHANGELOG for v2.5.0"
+
+Next steps:
+1. Create git tag: git tag -a v2.5.0 -m "Release v2.5.0"
+2. Create GitHub release: gh release create v2.5.0 --generate-notes
+```
+
+### No Changes Detected
+
+```
+📋 Generating Changelog
+
+Detecting version...
+✅ Current version: v2.4.0
+✅ Last release: v2.4.0 (2026-01-15)
+
+Collecting changes since v2.4.0...
+Found: 0 commits
+
+ℹ️  No changes detected since v2.4.0
+
+Nothing to add to changelog.
+```
+
+### Unclear Commits (Manual Categorization)
+
+```
+📋 Generating Changelog
+
+Found 3 commits that need manual categorization:
+
+Unclear commits:
+1. "update stuff" (abc1234)
+2. "fix things" (def5678)
+3. "misc changes" (ghi9012)
+
+[AskUserQuestion: "How should 'update stuff' be categorized?"]
+  - Added (new feature)
+  - Changed (modification)
+  - Fixed (bug fix)
+  - Skip (don't include)
+
+User selected: Changed
+
+[Continuing with remaining commits...]
+```
+
+### Version Suggestion
+
+```
+📊 Version Analysis
+
+Changes detected:
+- 3 Added (feat:)
+- 5 Fixed (fix:)
+- 1 BREAKING (feat!:)
+
+Version calculation:
+  Current: 1.5.2
+  Breaking change detected → Major bump required
+
+💡 Suggested: 2.0.0 (MAJOR - breaking change)
+
+[AskUserQuestion: "Accept version 2.0.0?"]
+  - Yes, use 2.0.0 (Recommended)
+  - Use minor: 1.6.0
+  - Use patch: 1.5.3
+  - Enter custom version
+```

package/src/core/commands/configure.md

@@ -51,6 +51,7 @@ node .agileflow/scripts/agileflow-configure.js --profile=full  # Enable all
 node .agileflow/scripts/agileflow-configure.js --migrate       # Fix format
 node .agileflow/scripts/agileflow-configure.js --upgrade       # Update scripts
 node .agileflow/scripts/agileflow-configure.js --repair        # Restore missing
+node .agileflow/scripts/agileflow-configure.js --new-options   # Check for new options
 ```
 
 ### Critical Rules
@@ -170,8 +171,8 @@ After handling issues (or if none), present the main category menu:
   "header": "Preset",
   "multiSelect": false,
   "options": [
-    {"label": "Full (Recommended)", "description": "All features: hooks, archival, status line, AskUserQuestion"},
-    {"label": "Basic", "description": "SessionStart + PreCompact + Archival + AskUserQuestion"},
+    {"label": "Full (Recommended)", "description": "All features: hooks, archival, status line, AskUserQuestion, TmuxAutoSpawn"},
+    {"label": "Basic", "description": "SessionStart + PreCompact + Archival + AskUserQuestion + TmuxAutoSpawn"},
     {"label": "Minimal", "description": "SessionStart + Archival only"},
     {"label": "None", "description": "Disable all AgileFlow features"}
   ]
@@ -313,7 +314,8 @@ Then ask about other features:
     {"label": "Archival", "description": "Auto-archive completed stories older than threshold"},
     {"label": "Status Line", "description": "Custom status bar showing story/epic info"},
     {"label": "Auto-Update", "description": "Automatically update AgileFlow on session start"},
-    {"label": "AskUserQuestion Mode", "description": "End responses with guided options"}
+    {"label": "AskUserQuestion Mode", "description": "End responses with guided options"},
+    {"label": "Tmux Auto-Spawn", "description": "Auto-start Claude in tmux session when using af/agileflow wrapper"}
   ]
 }]</parameter>
 </invoke>
@@ -328,6 +330,7 @@ Map selections to commands:
 - Status Line → `statusline`
 - Auto-Update → `autoupdate`
 - AskUserQuestion Mode → `askuserquestion`
+- Tmux Auto-Spawn → `tmuxautospawn`
 
 Then run:
 ```bash
@@ -379,20 +382,49 @@ Task({ subagent_type: "configuration-ci", description: "Configure CI/CD", prompt
   "header": "Maintenance",
   "multiSelect": false,
   "options": [
+    {"label": "Apply new options", "description": "Enable newly available configuration options"},
     {"label": "Fix format issues", "description": "Migrate invalid settings to correct format"},
     {"label": "Upgrade scripts", "description": "Update features to latest AgileFlow version"},
-    {"label": "Repair missing scripts", "description": "Restore accidentally deleted scripts"},
-    {"label": "Check status", "description": "View current configuration (already shown above)"}
+    {"label": "Repair missing scripts", "description": "Restore accidentally deleted scripts"}
   ]
 }]</parameter>
 </invoke>
 ```
 
 Then run:
+- "Apply new options" → Show available new options and apply selected ones (see below)
 - "Fix format issues" → `node .agileflow/scripts/agileflow-configure.js --migrate`
 - "Upgrade scripts" → `node .agileflow/scripts/agileflow-configure.js --upgrade`
 - "Repair missing scripts" → `node .agileflow/scripts/agileflow-configure.js --repair`
-- "Check status" → Already shown in Step 1, no action needed
+
+#### If "Apply new options" selected
+
+Check for unconfigured options:
+```bash
+node .agileflow/scripts/agileflow-configure.js --new-options
+```
+
+If new options found, present them:
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Which new options do you want to enable?",
+  "header": "New Options",
+  "multiSelect": true,
+  "options": [
+    {"label": "CLAUDE.md reinforcement", "description": "Add /babysit context preservation rules to CLAUDE.md"},
+    {"label": "Skip for now", "description": "Don't enable any new options"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+Then apply selected options:
+```bash
+node .agileflow/scripts/agileflow-configure.js --apply-option=claudeMdReinforcement
+```
+
+If no new options: "✅ All configuration options are up to date!"
 
 ---
 
@@ -437,6 +469,10 @@ node .agileflow/scripts/agileflow-configure.js --upgrade
 node .agileflow/scripts/agileflow-configure.js --repair
 node .agileflow/scripts/agileflow-configure.js --list-scripts
 node .agileflow/scripts/agileflow-configure.js --version
+
+# New config options
+node .agileflow/scripts/agileflow-configure.js --new-options                  # List unconfigured options
+node .agileflow/scripts/agileflow-configure.js --apply-option=optionName      # Apply specific option
 ```
 
 ## Custom Profiles