@nextsparkjs/ai-workflow 0.1.0-beta.86

package/claude/commands/session/fix-test.md

@@ -0,0 +1,189 @@
+# /session:fix:test
+
+Fix failing tests automatically.
+
+---
+
+## Syntax
+
+```
+/session:fix:test [--spec <pattern>] [--max-iterations <n>]
+```
+
+---
+
+## Behavior
+
+Runs tests, analyzes failures, and fixes them iteratively until all pass.
+
+---
+
+## Flow
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  /session:fix:test                                               │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1. Run test suite                                              │
+│     ↓                                                           │
+│  2. Parse failures                                              │
+│     - Unit tests (Jest)                                         │
+│     - API tests (Cypress)                                       │
+│     - UAT tests (Cypress)                                       │
+│     ↓                                                           │
+│  3. Analyze each failure                                        │
+│     - Is it test code issue?                                    │
+│     - Is it implementation bug?                                 │
+│     ↓                                                           │
+│  4. Apply fix                                                   │
+│     - Update test assertion                                     │
+│     - Fix implementation                                        │
+│     - Update selectors                                          │
+│     ↓                                                           │
+│  5. Re-run failed tests                                         │
+│     │                                                           │
+│     ├─► Still failing: Go to step 3                             │
+│     │                                                           │
+│     └─► All pass: Done                                          │
+│     ↓                                                           │
+│  6. Show summary                                                │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Example Output
+
+```
+🧪 FIX FAILING TESTS
+
+─────────────────────────────────────────
+
+📋 ITERATION 1
+
+Running tests...
+❌ 3 of 15 tests failing
+
+Failures:
+1. [Jest] ProductsService.test.ts
+   "should calculate price with discount"
+   Expected: 90, Received: 89.99
+
+2. [Cypress API] products.cy.ts
+   "POST /products - should create product"
+   Expected status 201, got 400
+
+3. [Cypress UAT] products.cy.ts
+   "should display product list"
+   Element [data-cy=product-row] not found
+
+─────────────────────────────────────────
+
+🔍 ANALYZING FAILURES
+
+[1/3] ProductsService.test.ts - Price calculation
+      Analysis: Floating point precision issue
+      Type: Test assertion needs update
+      Fix: Use toBeCloseTo instead of toBe
+
+[2/3] products.cy.ts - POST /products
+      Analysis: Missing required field 'categoryId'
+      Type: Test data incomplete
+      Fix: Add categoryId to test fixture
+
+[3/3] products.cy.ts - Display list
+      Analysis: Selector changed in implementation
+      Type: Test selector outdated
+      Fix: Update from [data-cy=product-row] to [data-cy=products-row]
+
+─────────────────────────────────────────
+
+🔧 APPLYING FIXES
+
+[1/3] ProductsService.test.ts
+      ✓ Updated assertion to use toBeCloseTo(90, 2)
+
+[2/3] products.cy.ts (API)
+      ✓ Added categoryId to fixture
+
+[3/3] products.cy.ts (UAT)
+      ✓ Updated selector
+
+─────────────────────────────────────────
+
+📋 ITERATION 2
+
+Running failed tests...
+✓ All 3 tests now passing
+
+Running full suite...
+✓ 15/15 tests passing
+
+─────────────────────────────────────────
+
+📊 SUMMARY
+
+Iterations: 2
+Tests fixed: 3
+Files modified: 2
+  - ProductsService.test.ts
+  - products.cy.ts
+
+All tests passing.
+```
+
+---
+
+## Test Types Handled
+
+| Type | Runner | Fix Approach |
+|------|--------|--------------|
+| Unit Tests | Jest | Update assertions, fix mocks |
+| API Tests | Cypress | Fix endpoints, update fixtures |
+| UAT Tests | Cypress | Update selectors, fix flows |
+
+---
+
+## Fix vs Implementation Bug
+
+```
+🔍 FAILURE ANALYSIS
+
+Test: "should return products for authenticated user"
+
+Analysis:
+This appears to be an IMPLEMENTATION BUG, not a test issue.
+
+Evidence:
+- Test was passing before
+- Recent change to ProductsService
+- Error: "Unauthorized" when should succeed
+
+Recommended action:
+Fix implementation in ProductsService.ts:45
+
+Proceed with implementation fix? [Yes/Fix test instead]
+```
+
+---
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--spec <pattern>` | Run specific test files |
+| `--max-iterations <n>` | Max fix attempts (default: 5) |
+| `--unit-only` | Only fix Jest tests |
+| `--e2e-only` | Only fix Cypress tests |
+
+---
+
+## Related Commands
+
+| Command | Action |
+|---------|--------|
+| `/session:fix:build` | Fix build errors |
+| `/session:fix:bug` | Fix reported bug |
+| `/session:validate` | Full validation |

package/claude/commands/session/pending.md

@@ -0,0 +1,232 @@
+# /session:pending
+
+Document pending items discovered during development.
+
+---
+
+## Syntax
+
+```
+/session:pending [add|list|resolve] [description]
+```
+
+---
+
+## Behavior
+
+Manages pending items that are discovered during implementation but are out of scope for the current session.
+
+---
+
+## Flow
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  /session:pending add                                            │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1. Load session context                                        │
+│     ↓                                                           │
+│  2. Categorize pending item                                     │
+│     - Bug discovered                                            │
+│     - Enhancement idea                                          │
+│     - Technical debt                                            │
+│     - Missing feature                                           │
+│     ↓                                                           │
+│  3. Assess priority                                             │
+│     - Critical / Important / Nice-to-have                       │
+│     ↓                                                           │
+│  4. Add to pendings.md                                          │
+│     ↓                                                           │
+│  5. Optionally create task in manager                           │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Example: Add Pending
+
+```
+/session:pending add "Performance optimization needed for product list"
+```
+
+Output:
+
+```
+📌 ADD PENDING ITEM
+
+Session: stories/2026-01-11-new-products-entity
+
+─────────────────────────────────────────
+
+📝 NEW PENDING ITEM
+
+Description: Performance optimization needed for product list
+
+Category?
+[1] Bug discovered
+[2] Enhancement idea
+[3] Technical debt
+[4] Missing feature
+
+> 3
+
+Priority?
+[1] Critical - Must fix before release
+[2] Important - Should fix soon
+[3] Nice-to-have - Future improvement
+
+> 2
+
+Additional context?
+> List becomes slow with 100+ products, consider pagination
+
+─────────────────────────────────────────
+
+📄 ITEM RECORDED
+
+```markdown
+## P-003: Performance optimization for product list
+
+**Category:** Technical debt
+**Priority:** Important
+**Discovered:** 2026-01-14
+**Session:** new-products-entity
+
+### Description
+Performance optimization needed for product list.
+List becomes slow with 100+ products.
+
+### Suggested Action
+Consider pagination or virtual scrolling.
+```
+
+─────────────────────────────────────────
+
+Create task in ClickUp? [Yes/No]
+```
+
+---
+
+## Example: List Pending
+
+```
+/session:pending list
+```
+
+Output:
+
+```
+📌 PENDING ITEMS
+
+Session: stories/2026-01-11-new-products-entity
+
+─────────────────────────────────────────
+
+## Critical (0)
+(none)
+
+## Important (2)
+
+P-001: Add search index for products table
+       [Technical debt] Discovered: 2026-01-12
+
+P-003: Performance optimization for product list
+       [Technical debt] Discovered: 2026-01-14
+
+## Nice-to-have (1)
+
+P-002: Add bulk import for products
+       [Enhancement] Discovered: 2026-01-13
+
+─────────────────────────────────────────
+
+Total: 3 pending items
+```
+
+---
+
+## Example: Resolve Pending
+
+```
+/session:pending resolve P-001
+```
+
+Output:
+
+```
+📌 RESOLVE PENDING
+
+Item: P-001 - Add search index for products table
+
+─────────────────────────────────────────
+
+How was this resolved?
+[1] Fixed in this session
+[2] Fixed in another session
+[3] Won't fix (explain why)
+[4] Duplicate
+
+> 1
+
+Additional notes?
+> Added GIN index in migration 009
+
+─────────────────────────────────────────
+
+✓ P-001 marked as resolved
+  Resolution: Fixed in this session
+  Notes: Added GIN index in migration 009
+```
+
+---
+
+## pendings.md Format
+
+```markdown
+# Pending Items
+
+## Active
+
+### P-003: Performance optimization for product list
+- **Category:** Technical debt
+- **Priority:** Important
+- **Discovered:** 2026-01-14
+- **Session:** new-products-entity
+
+#### Description
+List becomes slow with 100+ products.
+
+#### Suggested Action
+Consider pagination or virtual scrolling.
+
+---
+
+## Resolved
+
+### P-001: Add search index for products table
+- **Resolved:** 2026-01-15
+- **Resolution:** Fixed in session
+- **Notes:** Added GIN index in migration 009
+```
+
+---
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `add` | Add new pending item |
+| `list` | List all pending items |
+| `resolve <id>` | Mark item as resolved |
+| `--priority <level>` | Filter by priority |
+
+---
+
+## Related Commands
+
+| Command | Action |
+|---------|--------|
+| `/session:close` | Shows pending items summary |
+| `/session:scope-change` | For in-scope changes |

package/claude/commands/session/refine.md

@@ -0,0 +1,188 @@
+# /session:refine
+
+Refine requirements or plan before continuing execution.
+
+---
+
+## Syntax
+
+```
+/session:refine [requirements|plan]
+```
+
+---
+
+## Behavior
+
+Opens refinement mode to adjust requirements or technical plan without creating a new iteration.
+
+---
+
+## When to Use
+
+| Situation | Action |
+|-----------|--------|
+| Minor clarification needed | `/session:refine requirements` |
+| Technical approach adjustment | `/session:refine plan` |
+| Add missing AC | `/session:refine requirements` |
+| Change implementation detail | `/session:refine plan` |
+
+**Note:** For major scope changes, use `/session:scope-change` instead.
+
+---
+
+## Flow
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  /session:refine                                                 │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1. Load current session                                        │
+│     ↓                                                           │
+│  2. Show current state                                          │
+│     - requirements.md or plan.md                                │
+│     ↓                                                           │
+│  3. Ask for refinements                                         │
+│     - What needs to change?                                     │
+│     - Why?                                                      │
+│     ↓                                                           │
+│  4. Apply changes                                               │
+│     - Update file                                               │
+│     - Log change in progress.md                                 │
+│     ↓                                                           │
+│  5. Show diff and confirm                                       │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Example: Refine Requirements
+
+```
+/session:refine requirements
+```
+
+Output:
+
+```
+📝 REFINE REQUIREMENTS
+
+Session: stories/2026-01-11-new-products-entity
+
+─────────────────────────────────────────
+
+📋 CURRENT ACCEPTANCE CRITERIA
+
+AC1: Admin can create a new product ✓
+AC2: Admin can upload product images ✓
+AC3: Admin can assign products to categories
+AC4: Products are listed with pagination
+AC5: Team members can view products
+
+─────────────────────────────────────────
+
+What would you like to refine?
+> Add AC for product search functionality
+
+─────────────────────────────────────────
+
+📝 PROPOSED CHANGES
+
++ AC6: Products can be searched by name and SKU
+
+Why this change?
+> Client requested search feature during review
+
+─────────────────────────────────────────
+
+Apply these changes? [Yes/Edit/Cancel]
+
+> Yes
+
+✓ requirements.md updated
+✓ Change logged in progress.md
+```
+
+---
+
+## Example: Refine Plan
+
+```
+/session:refine plan
+```
+
+Output:
+
+```
+📐 REFINE PLAN
+
+Session: stories/2026-01-11-new-products-entity
+
+─────────────────────────────────────────
+
+📋 CURRENT PLAN
+
+## Phase 2: Backend
+- [ ] Configure entity in entities.config.ts
+- [ ] Add translations
+
+─────────────────────────────────────────
+
+What would you like to refine?
+> Need custom service for price calculation
+
+─────────────────────────────────────────
+
+📝 PROPOSED CHANGES
+
+## Phase 2: Backend
+- [ ] Configure entity in entities.config.ts
++ - [ ] Create ProductsService with price calculation
+- [ ] Add translations
+
+Estimated impact: +2 files
+
+─────────────────────────────────────────
+
+Apply these changes? [Yes/Edit/Cancel]
+
+> Yes
+
+✓ plan.md updated
+✓ scope.json updated (2 new files)
+✓ Change logged in progress.md
+```
+
+---
+
+## Refinement vs Scope Change
+
+| Refinement | Scope Change |
+|------------|--------------|
+| Minor clarifications | Major new requirements |
+| Implementation details | New ACs that change scope |
+| Same T-Shirt size | T-Shirt size increases |
+| No new iteration | Creates new iteration |
+| `/session:refine` | `/session:scope-change` |
+
+---
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `requirements` | Refine requirements.md |
+| `plan` | Refine plan.md |
+| `--interactive` | Guided refinement mode |
+
+---
+
+## Related Commands
+
+| Command | Action |
+|---------|--------|
+| `/session:scope-change` | For major scope changes |
+| `/session:execute` | Continue after refinement |
+| `/session:status` | View current state |