@nextsparkjs/ai-workflow 0.1.0-beta.100

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

@@ -0,0 +1,182 @@
+# /session:fix:build
+
+Fix build errors automatically.
+
+---
+
+## Syntax
+
+```
+/session:fix:build [--max-iterations <n>]
+```
+
+---
+
+## Behavior
+
+Automatically diagnoses and fixes build errors in a loop until the build passes.
+
+---
+
+## Flow
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  /session:fix:build                                              │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1. Run build                                                   │
+│     ↓                                                           │
+│  2. Parse errors                                                │
+│     - TypeScript errors                                         │
+│     - Import errors                                             │
+│     - Config errors                                             │
+│     ↓                                                           │
+│  3. Categorize by type                                          │
+│     - Type mismatch                                             │
+│     - Missing import                                            │
+│     - Missing dependency                                        │
+│     - Syntax error                                              │
+│     ↓                                                           │
+│  4. Fix each error                                              │
+│     - Apply targeted fix                                        │
+│     ↓                                                           │
+│  5. Re-run build                                                │
+│     │                                                           │
+│     ├─► Errors remain: Go to step 2                             │
+│     │                                                           │
+│     └─► Build passes: Done                                      │
+│     ↓                                                           │
+│  6. Show summary                                                │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Example Output
+
+```
+🔧 FIX BUILD ERRORS
+
+─────────────────────────────────────────
+
+📋 ITERATION 1
+
+Running build...
+❌ Build failed with 5 errors
+
+Errors:
+1. TS2345: products.ts:23 - Type mismatch
+2. TS2307: ProductForm.tsx:5 - Missing import
+3. TS2307: ProductForm.tsx:8 - Missing import
+4. TS2339: ProductList.tsx:45 - Property does not exist
+5. TS2345: ProductService.ts:12 - Type mismatch
+
+─────────────────────────────────────────
+
+🔧 FIXING ERRORS
+
+[1/5] products.ts:23 - Type mismatch
+      Fix: Cast to correct type
+      ✓ Fixed
+
+[2/5] ProductForm.tsx:5 - Missing import
+      Fix: Add import for 'useForm'
+      ✓ Fixed
+
+[3/5] ProductForm.tsx:8 - Missing import
+      Fix: Add import for 'zodResolver'
+      ✓ Fixed
+
+[4/5] ProductList.tsx:45 - Property does not exist
+      Fix: Update property name
+      ✓ Fixed
+
+[5/5] ProductService.ts:12 - Type mismatch
+      Fix: Update function signature
+      ✓ Fixed
+
+─────────────────────────────────────────
+
+📋 ITERATION 2
+
+Running build...
+✓ Build successful
+
+─────────────────────────────────────────
+
+📊 SUMMARY
+
+Iterations: 2
+Errors fixed: 5
+Files modified: 4
+
+Build is now passing.
+```
+
+---
+
+## With Max Iterations
+
+```
+/session:fix:build --max-iterations 3
+```
+
+Output when limit reached:
+
+```
+🔧 FIX BUILD ERRORS
+
+─────────────────────────────────────────
+
+📋 ITERATION 3
+
+Running build...
+❌ Build failed with 2 errors
+
+⚠️ MAX ITERATIONS REACHED
+
+Remaining errors:
+1. TS2322: complex-type.ts:45 - Complex type error
+2. TS2339: api-handler.ts:23 - Missing property
+
+These errors may require manual intervention.
+
+Options:
+[1] Continue fixing (increase limit)
+[2] Show detailed error analysis
+[3] Stop and fix manually
+```
+
+---
+
+## Error Categories
+
+| Category | Auto-Fix | Example |
+|----------|----------|---------|
+| Missing import | Yes | `import { X } from 'y'` |
+| Type mismatch | Usually | Cast or update type |
+| Syntax error | Usually | Missing bracket, etc. |
+| Missing property | Sometimes | Add property to interface |
+| Complex type | Manual | Generic constraints |
+
+---
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--max-iterations <n>` | Max fix attempts (default: 5) |
+| `--dry-run` | Show fixes without applying |
+| `--verbose` | Show detailed fix reasoning |
+
+---
+
+## Related Commands
+
+| Command | Action |
+|---------|--------|
+| `/session:fix:test` | Fix failing tests |
+| `/session:fix:bug` | Fix reported bug |
+| `/session:validate` | Full validation |

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 |