wogiflow 1.0.21 → 1.0.22

package/.claude/commands/wogi-bug.md

@@ -0,0 +1,43 @@
+Create a bug report. Provide title: `/wogi-bug Login button not responding`
+
+Run `./scripts/flow bug "<title>"` to create a bug report.
+
+Options:
+- `--from <task-id>` - Task ID that discovered this bug (auto-populated if task in progress)
+- `--priority <P>` - Priority P0-P4 (auto-boosted to P1 if discovered during task)
+- `--severity <s>` - Severity: critical, high, medium, low (default: medium)
+- `--json` - Output JSON
+
+Examples:
+```bash
+flow bug "Login button not responding"
+flow bug "Null pointer in Profile API" --from wf-a1b2c3d4 --priority P0
+flow bug "Fix auth header" --severity critical
+```
+
+Output:
+```
+Created: wf-f2d409c2
+
+File: .workflow/bugs/wf-f2d409c2.md
+Title: Login button not responding
+Priority: P1
+Severity: medium
+Discovered From: wf-a1b2c3d4 (auto-detected)
+```
+
+Bug report includes:
+- Hash-based ID (wf-XXXXXXXX format)
+- Priority (P0-P4, auto-boosted if discovered during task)
+- Discovered From tracking (links bug to source task)
+- Description
+- Steps to reproduce
+- Expected vs Actual
+- Severity
+- Tags (#bug, #screen:X, #component:Y)
+- Status tracking
+
+The `discovered-from` field enables learning:
+- Track which tasks tend to discover bugs
+- Auto-boost priority when bug is found during task work
+- Link bugs back to their source for better traceability

package/.claude/commands/wogi-bulk.md

@@ -0,0 +1,144 @@
+Execute multiple tasks in sequence, following all workflow rules.
+
+**v2.1**: Now uses task queue for automatic continuation between tasks.
+
+## Usage
+
+- `/wogi-bulk` - Work through all ready tasks
+- `/wogi-bulk 3` - Work through next 3 tasks
+- `/wogi-bulk wf-001 wf-002 wf-003` - Work specific tasks in order
+
+**Natural Language Alternative** (no slash command needed):
+- "do story 1-3" or "work on tasks 1-5"
+- "do wf-001, wf-002, wf-003"
+- "work on these 3 stories"
+
+## How It Works (v2.1)
+
+1. **Initialize Queue**:
+   - Parse task IDs from arguments or natural language
+   - Store in durable session's `taskQueue`
+   - Run `flow queue init <task-ids>`
+
+2. **Start First Task**:
+   - Run `/wogi-start <first-task-id>`
+   - Full execution loop with all quality gates
+
+3. **Automatic Continuation**:
+   - When task completes, stop hook checks queue
+   - If more tasks, outputs next task instruction
+   - Continues until queue is empty
+
+4. **Quality Per Task**:
+   - Each task runs complete execution loop
+   - Spec generation (if needed)
+   - All acceptance criteria verification
+   - Quality gates and validation
+   - Request log and app-map updates
+
+## Execution Flow
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  /wogi-bulk 3                                               │
+├─────────────────────────────────────────────────────────────┤
+│  1. Get 3 ready tasks sorted by priority                    │
+│  2. Initialize task queue: [wf-001, wf-002, wf-003]         │
+│  3. Start wf-001 (full loop)                                │
+│     → All scenarios implemented and verified                │
+│     → Quality gates pass                                    │
+│     → Committed                                             │
+│  4. Stop hook detects queue has more tasks                  │
+│  5. Auto-continue to wf-002 (full loop)                     │
+│     → ...                                                   │
+│  6. Auto-continue to wf-003 (full loop)                     │
+│     → ...                                                   │
+│  7. Queue empty - stop                                      │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Output
+
+**Start:**
+```
+📋 Task Queue Initialized
+
+Tasks (3):
+  1. wf-001 - Add user login [P1]
+  2. wf-002 - Password reset [P2]
+  3. wf-003 - Session management [P2]
+
+Starting first task...
+```
+
+**Between Tasks (automatic):**
+```
+✓ Task complete!
+
+Continuing to next task in queue: wf-002
+(2 task(s) remaining)
+
+Run: /wogi-start wf-002
+```
+
+**Final (after last task):**
+```
+✓ All tasks complete!
+
+Queue Summary:
+  ✓ wf-001 - Add user login
+  ✓ wf-002 - Password reset
+  ✓ wf-003 - Session management
+
+3/3 tasks completed successfully.
+```
+
+## Options
+
+- `--auto` - Don't pause between tasks (default behavior in v2.1)
+- `--pause` - Pause and ask before each task
+- `--plan` - Show order without executing
+- `--feature <name>` - Only tasks in specified feature
+
+## Configuration
+
+In `config.json`:
+```json
+{
+  "taskQueue": {
+    "enabled": true,
+    "autoContinue": true,
+    "pauseBetweenTasks": false,  // Default: automatic
+    "maxQueueSize": 10,
+    "showProgressSummary": true
+  }
+}
+```
+
+## CLI Commands
+
+```bash
+# Initialize queue directly
+flow queue init wf-001 wf-002 wf-003
+
+# Check queue status
+flow queue status
+
+# Parse natural language
+flow queue parse "do story 1-3"
+
+# Clear queue
+flow queue clear
+
+# Advance manually
+flow queue advance
+```
+
+## Important Rules
+
+1. **Full loop per task** - Each task runs complete execution with all quality gates
+2. **Automatic continuation** - Default is no pause between tasks
+3. **Commit after each task** - Progress saved even if interrupted
+4. **Stop on failure** - If quality gates fail, stop and report
+5. **Respect dependencies** - Tasks sorted by dependencies then priority
+6. **Context management** - Consider `/wogi-compact` after 3+ tasks

package/.claude/commands/wogi-changelog.md

@@ -0,0 +1,36 @@
+Generate a CHANGELOG from request-log entries.
+
+Parse `.workflow/state/request-log.md` and group by type:
+- `new` → Added
+- `change` → Changed
+- `fix` → Fixed
+- `refactor` → Refactored
+- `remove` → Removed
+
+Output standard changelog format:
+```markdown
+# Changelog
+
+## [Unreleased]
+
+### Added
+- Forgot password link on login page (R-045)
+- User profile page with avatar upload (R-042)
+- Button ghost variant (R-038)
+
+### Changed
+- Updated form validation to use react-hook-form (R-044)
+- Improved error message styling (R-040)
+
+### Fixed
+- Password visibility toggle state (R-043)
+- Mobile responsive issues on dashboard (R-039)
+
+### Refactored
+- Extracted AuthForm from LoginScreen (R-037)
+```
+
+Options:
+- `/wogi-changelog` - All unreleased changes
+- `/wogi-changelog v1.0` - Changes since v1.0 tag
+- `/wogi-changelog --save` - Write to CHANGELOG.md file

package/.claude/commands/wogi-compact.md

@@ -0,0 +1,99 @@
+Compact the conversation to free up context space using the recursive summary tree.
+
+## Recursive Context Compaction
+
+WogiFlow uses a hierarchical summary tree to manage context:
+
+```
+Root (overview)
+├── Tasks Section (summary)
+│   ├── Task 1 (details, expandable)
+│   └── Task 2 (details, expandable)
+├── Decisions Section (summary)
+│   └── Decision details (expandable)
+└── Files Section (summary)
+    └── File changes (expandable)
+```
+
+## Before Compacting
+
+1. **Update progress.md** with:
+   - Current task being worked on
+   - What's been done this session
+   - Next steps
+   - Any decisions made
+
+2. **Ensure request-log is current** - All changes logged
+
+3. **Save any in-progress work** - Commit or stash
+
+## Automatic Context Saving
+
+When compacting, the system automatically:
+1. Builds a hierarchical summary tree of the session
+2. Stores summaries at multiple levels (root → sections → details)
+3. Applies relevance decay to older items
+4. Enables on-demand expansion when details are needed later
+
+## Format for Context Summary
+
+Provide this information for the compaction system:
+
+```
+## Session Summary for Compaction
+
+**Goal**: [What user wanted to accomplish]
+
+**Completed**:
+- [Task/change 1]
+- [Task/change 2]
+
+**In Progress**:
+- TASK-XXX: [description] - [current state, what's left]
+
+**Key Decisions**:
+- [Decision 1]
+- [Decision 2]
+
+**Files Modified**:
+- [file1.tsx] - [what changed]
+- [file2.tsx] - [what changed]
+
+**Next Steps**:
+1. [Step 1]
+2. [Step 2]
+
+**Context to Preserve**:
+- [Important context that should survive compaction]
+```
+
+## Context Pressure Monitoring
+
+Check context pressure status:
+- **Normal**: Under 50k tokens - no action needed
+- **Warning**: 50k-80k tokens - consider compacting soon
+- **Critical**: Over 80k tokens - compact immediately
+
+## CLI Commands
+
+```bash
+# View tree stats
+node scripts/flow-context-compact stats
+
+# Check context pressure
+node scripts/flow-context-compact pressure
+
+# View serialized tree
+node scripts/flow-context-compact show
+
+# Manual compact
+node scripts/flow-context-compact compact
+
+# Compact and prune old nodes
+node scripts/flow-context-compact compact --prune
+
+# Get context for a query
+node scripts/flow-context-compact context "authentication task"
+```
+
+After providing the summary, tell user: "Ready to compact. Please run /compact or continue and I'll auto-compact when needed."

package/.claude/commands/wogi-config.md

@@ -0,0 +1,50 @@
+View or modify workflow configuration.
+
+**View config:** `/wogi-config`
+Shows current settings from `.workflow/config.json`
+
+**Toggle settings:** `/wogi-config [setting] [on/off]`
+
+Available settings:
+- `storybook on/off` - Auto-generate Storybook stories for new components
+- `hooks on/off` - Enable/disable pre-commit git hooks
+- `tests-before-commit on/off` - Run tests before each commit
+
+Examples:
+```
+/wogi-config
+→ Shows all current settings
+
+/wogi-config storybook on
+→ Enables Storybook auto-generation
+→ Updates componentRules.autoGenerateStorybook: true
+
+/wogi-config hooks on
+→ Runs: ./scripts/flow setup-hooks install
+
+/wogi-config tests-before-commit on
+→ Updates testing.runBeforeCommit: true
+```
+
+Output for view:
+```
+⚙️ Workflow Configuration
+
+Quality Gates:
+  feature: tests, appMapUpdate, requestLogEntry
+  bugfix: tests, requestLogEntry
+
+Testing:
+  Run after task: off
+  Run before commit: off
+  Browser tests: off
+
+Components:
+  Auto Storybook: off
+  Require app-map entry: on
+
+Hooks:
+  Pre-commit: not installed
+
+Use /wogi-config [setting] on/off to change.
+```

package/.claude/commands/wogi-context.md

@@ -0,0 +1,68 @@
+Load all context needed to implement a task. Provide task ID: `/wogi-context wf-012`
+
+## What It Loads
+
+1. **Story** - From `.workflow/changes/*/wf-XXX.md` or tasks.json
+2. **Product Context** - Relevant sections from product.md (using PIN system)
+3. **Related history** - Search request-log for task ID and related tags
+4. **Components** - Load details for any components mentioned in technical notes
+5. **Decisions** - Show relevant patterns from decisions.md
+
+## Product Context Loading
+
+If `.workflow/state/product.md` exists:
+- Extract keywords from task description
+- Use section-resolver to find relevant PIN sections
+- Include product vision, user personas, or feature context that applies
+
+This replaces the need for separate PRD loading - product context is automatically included.
+
+## Output
+
+```
+📚 Context for wf-012
+
+═══════════════════════════════════════
+STORY
+═══════════════════════════════════════
+[Full story content with acceptance criteria]
+
+═══════════════════════════════════════
+PRODUCT CONTEXT
+═══════════════════════════════════════
+From product.md (sections: user-auth, security):
+• Users should be able to reset passwords via email
+• Security: All auth tokens expire after 24 hours
+• Target users: Enterprise teams with SSO requirements
+
+═══════════════════════════════════════
+RELATED HISTORY
+═══════════════════════════════════════
+• R-038: Added AuthForm component
+• R-032: Created login screen
+
+═══════════════════════════════════════
+COMPONENTS
+═══════════════════════════════════════
+Button (primary, secondary):
+  Path: components/ui/Button
+  Used in: LoginForm, SignupForm
+
+Link (default, subtle):
+  Path: components/ui/Link
+
+═══════════════════════════════════════
+DECISIONS
+═══════════════════════════════════════
+• Use Link component for navigation, not button
+• Form validation uses react-hook-form
+
+Ready to implement.
+```
+
+## Usage
+
+```bash
+/wogi-context wf-012           # Load all context for task
+/wogi-context wf-012 --brief   # Shorter summary
+```

package/.claude/commands/wogi-correction.md

@@ -0,0 +1,73 @@
+Create a detailed correction report for a significant bug fix.
+
+Usage: `/wogi-correction [TASK-XXX]`
+
+## When to Use
+
+Based on `config.json` corrections mode:
+- **inline**: Only use when explicitly requested
+- **hybrid**: Use for significant/complex fixes
+- **always-detailed**: Use for every fix
+
+## Steps
+
+1. Read `config.json` to check corrections mode
+2. Find next correction number for the task
+3. Create correction report at `.workflow/corrections/[TASK-XXX]-correction-[N].md`
+4. Add summary to request-log.md with link to detail
+
+## Gather Information
+
+Ask user for:
+1. **What was expected?** - The correct behavior
+2. **What happened?** - The actual behavior
+3. **Error message?** - If applicable
+4. **Root cause?** - Why it happened
+5. **Solution?** - What was changed
+6. **Prevention?** - How to avoid in future
+
+## Output
+
+Create detailed report:
+
+```markdown
+# Correction Report: TASK-012-Correction-1
+
+## Problem Description
+### What Was Expected
+User should see dashboard after login
+
+### What Actually Happened
+Redirect failed, stayed on login page
+
+### Error Message
+TypeError: Cannot read property 'id' of undefined
+
+## Root Cause Analysis
+Auth token not being sent in header
+
+## Solution Applied
+| File | Change |
+|------|--------|
+| api.ts | Added Authorization header |
+
+## Prevention Measures
+1. Add integration test for auth flow
+2. Update API client documentation
+```
+
+Add to request-log.md:
+
+```markdown
+### R-045 | 2024-01-15
+**Type**: fix
+**Tags**: #bug:BUG-003 #task:TASK-012
+**Request**: Fix login redirect failure
+**Result**: Added auth header to API client
+**Correction**: [TASK-012-correction-1](../corrections/TASK-012-correction-1.md)
+**Files**: `api.ts`
+```
+
+## Template
+
+Use: `.workflow/templates/correction-report.md`

package/.claude/commands/wogi-debt.md

@@ -0,0 +1,128 @@
+View and manage technical debt across sessions.
+
+**Triggers**: `/wogi-debt`, "show debt", "technical debt", "debt status"
+
+## Usage
+
+```bash
+/wogi-debt                  # Show debt summary dashboard
+/wogi-debt list             # List all open items
+/wogi-debt list --aging     # Show items seen 3+ sessions
+/wogi-debt list --fixable   # Show auto-fixable items
+/wogi-debt fix              # Run auto-fixes (batch all at once)
+/wogi-debt dismiss <id>     # Mark as won't-fix
+/wogi-debt promote <id>     # Create task from debt item
+/wogi-debt promote-aging    # Create tasks for all aging items
+```
+
+## How It Works
+
+Technical debt is captured automatically from `/wogi-session-review` and persisted to `.workflow/state/tech-debt.json`. Each issue tracks:
+
+- **File and line**: Where the issue was found
+- **Severity**: critical, high, medium, low
+- **Sessions seen**: How many sessions this issue has persisted
+- **Auto-fixable**: Whether safe batch fixing is possible
+
+### Issue Aging
+
+Issues that persist across multiple sessions are flagged as "aging":
+- **Session 1-2**: Normal tracking
+- **Session 3+**: Marked as aging, shown in warnings
+- **Auto-promotion**: Aging items can auto-create tasks
+
+### Auto-Fixable Issues
+
+Certain issue types can be safely batch-fixed:
+- `console.log` statements → Remove line
+- `debugger` statements → Remove line
+- Unused imports → Remove import
+- Empty catch blocks → Add comment
+
+When you run `/wogi-debt fix`, ALL auto-fixable items are processed at once.
+
+## Execution Steps
+
+When `/wogi-debt` is invoked:
+
+1. **Load tech debt data** from `.workflow/state/tech-debt.json`
+2. **Parse arguments** to determine action (list, fix, dismiss, promote)
+3. **Execute action**:
+   - `list`: Filter and display issues based on flags
+   - `fix`: Run auto-fix engine on all fixable items
+   - `dismiss`: Mark issue as won't-fix
+   - `promote`: Create task in ready.json from debt item
+4. **Display results** with severity colors and counts
+
+## Output Format
+
+### Summary Dashboard
+```
+╔══════════════════════════════════════════════════════════╗
+║  Technical Debt Dashboard                                 ║
+╚══════════════════════════════════════════════════════════╝
+
+Summary: 15 open items
+  Critical: 0  High: 2  Medium: 5  Low: 8
+
+⚠ 3 items aging (3+ sessions)
+✓ 6 auto-fixable items available
+
+Commands:
+  flow tech-debt list          List all items
+  flow tech-debt list --aging  Show aging items
+  flow tech-debt fix           Run auto-fixes
+```
+
+### List View
+```
+━━━ All Open Issues ━━━
+  [td-001] scripts/utils.js:45 (low)
+      console.log statement
+      Fix: Remove debugging statement
+
+  [td-002] scripts/main.js:234 (medium) ⚠ 5 sessions
+      Magic number should be named constant
+      Fix: Extract to TIMEOUT_MS
+
+Total: 15 items
+```
+
+## Integration Points
+
+- **Session Review**: Issues captured after `/wogi-session-review`
+- **Morning Briefing**: Debt summary shown in `/wogi-morning`
+- **Session End**: Optional cleanup prompt in `/wogi-session-end`
+- **Task System**: Aging items auto-promoted to ready.json
+
+## Config Options
+
+In `.workflow/config.json`:
+
+```json
+{
+  "techDebt": {
+    "enabled": true,
+    "promptOnSessionEnd": true,
+    "showInMorningBriefing": true,
+    "agingThreshold": 3,
+    "autoFix": {
+      "enabled": true,
+      "types": ["console.log", "unused-import", "debugger", "empty-catch"]
+    }
+  }
+}
+```
+
+## When No Debt Found
+
+```
+╔══════════════════════════════════════════════════════════╗
+║  Technical Debt Dashboard                                 ║
+╚══════════════════════════════════════════════════════════╝
+
+Summary: 0 open items
+  ✓ No technical debt tracked
+
+Run /wogi-session-review to scan for issues.
+```

package/.claude/commands/wogi-deps.md

@@ -0,0 +1,32 @@
+Show dependency tree for a task. Provide task ID: `/wogi-deps wf-015`
+
+Search all tasks.json files in `.workflow/changes/` to find:
+1. What this task depends on
+2. What other tasks depend on this task
+
+Output:
+```
+🔗 Dependencies for wf-015
+
+Depends On:
+  ✓ wf-012: Add forgot password link (completed)
+  → wf-014: User API endpoint (in progress)
+
+Blocking:
+  • wf-018: Profile settings modal
+  • wf-020: Account deletion
+
+Status: BLOCKED (waiting on wf-014)
+```
+
+If task has no dependencies, show:
+```
+🔗 Dependencies for wf-015
+
+Depends On: None
+
+Blocking:
+  • wf-018: Profile settings modal
+
+Status: READY
+```