@nextsparkjs/ai-workflow 0.1.0-beta.100

package/claude/commands/session/status.md

@@ -0,0 +1,169 @@
+# /session:status
+
+View the status of active sessions.
+
+**Aliases:** `/status`
+
+---
+
+## Syntax
+
+```
+/session:status [session-path]
+```
+
+---
+
+## Behavior
+
+### Without path (all sessions)
+
+```
+/session:status
+```
+
+Shows summary of all active sessions.
+
+### With path (specific session)
+
+```
+/session:status stories/2026-01-11-new-entity
+```
+
+Shows detailed status of a specific session.
+
+---
+
+## General Output
+
+```
+📊 SESSION STATUS
+
+STORIES (2 active)
+─────────────────────────────────────────
+[L] 2026-01-11-new-products-entity
+    Iteration: 02-scope-change
+    Phase: EXECUTE (frontend-developer)
+    Progress: 60%
+    Last activity: 2 hours ago
+
+[XL] 2026-01-08-refactor-auth
+    Iteration: 01-initial
+    Phase: BACKEND (api-tester)
+    Progress: 35%
+    Last activity: 1 day ago
+
+TASKS (1 active)
+─────────────────────────────────────────
+[M] 2026-01-10-improve-search
+    Progress: 80%
+    Last activity: 5 hours ago
+
+LOGS (3 today)
+─────────────────────────────────────────
+2026-01-11-fix-typo-login
+2026-01-11-update-config
+2026-01-11-fix-validation
+```
+
+---
+
+## Detailed Output (with path)
+
+```
+📊 STATUS: 2026-01-11-new-products-entity
+
+Type: Story (STORY workflow)
+T-Shirt: L
+Created: 2026-01-11
+Last activity: 2 hours ago
+
+─────────────────────────────────────────
+
+📈 PROGRESS
+
+BLOCK 1: PLANNING ████████████████████ 100%
+├─ [✓] product-manager
+└─ [✓] architecture-supervisor
+
+BLOCK 2: FOUNDATION ████████████████████ 100%
+├─ [✓] db-entity-developer
+└─ [✓] db-entity-validator
+
+BLOCK 3: BACKEND ████████████████████ 100%
+├─ [✓] backend-developer
+└─ [✓] backend-validator
+
+BLOCK 4: DESIGN ░░░░░░░░░░░░░░░░░░░░ SKIP
+
+BLOCK 5: FRONTEND ████████░░░░░░░░░░░░ 40%
+├─ [→] frontend-developer (in progress)
+└─ [ ] frontend-validator
+
+BLOCK 6: CODE REVIEW ░░░░░░░░░░░░░░░░░░░░ 0%
+└─ [ ] code-reviewer
+
+BLOCK 7: QA ░░░░░░░░░░░░░░░░░░░░ 0%
+├─ [ ] qa-manual (Claude orchestrator)
+└─ [ ] qa-automation
+
+BLOCK 8: FINALIZATION ░░░░░░░░░░░░░░░░░░░░ 0%
+├─ [ ] documentation-writer
+└─ [ ] unit-test-writer
+
+─────────────────────────────────────────
+
+📁 ITERATIONS
+
+01-initial [CLOSED]
+   Duration: 3 days
+   Reason: scope-change
+   Summary: "Initial implementation done"
+
+02-scope-change [ACTIVE]
+   Started: 2026-01-14
+   Reason: "add-variants-field"
+   Progress: In frontend
+
+─────────────────────────────────────────
+
+📌 PENDING ITEMS (3)
+
+- [ ] Add performance tests
+- [ ] Document API endpoints
+- [ ] Review DB indexes
+
+─────────────────────────────────────────
+
+🎯 NEXT STEP
+
+Complete frontend-developer:
+- [ ] Create UI components
+- [ ] Implement hooks
+- [ ] Add translations
+```
+
+---
+
+## Task Manager Integration
+
+If a task is linked:
+
+```
+📋 LINKED TASK
+
+ClickUp: #abc123
+URL: https://app.clickup.com/t/abc123
+Status: In Progress
+Assignee: Pablo
+```
+
+---
+
+## Related Commands
+
+| Command | Action |
+|---------|--------|
+| `/session:resume` | Resume this session |
+| `/session:close` | Close this session |
+| `/session:scope-change` | Create new iteration |

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

@@ -0,0 +1,221 @@
+# /session:test:fix
+
+Fix failing Cypress tests iteratively until all pass.
+
+**Aliases:** Wrapper for `/session:fix:test` focused on Cypress
+
+---
+
+## Syntax
+
+```
+/session:test:fix [--spec <pattern>] [--max-retries <n>]
+```
+
+---
+
+## Behavior
+
+Runs Cypress tests, analyzes failures, applies fixes, and retries until all pass.
+
+---
+
+## Flow
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  /session:test:fix                                               │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1. Run Cypress tests                                           │
+│     ↓                                                           │
+│  2. Identify failures                                           │
+│     ↓                                                           │
+│  3. For each failure:                                           │
+│     │                                                           │
+│     ├─► Selector issue?                                         │
+│     │   - Update data-cy in component                           │
+│     │   - Update selector in test                               │
+│     │                                                           │
+│     ├─► Timing issue?                                           │
+│     │   - Add cy.wait or cy.intercept                           │
+│     │                                                           │
+│     ├─► Assertion issue?                                        │
+│     │   - Update expected value                                 │
+│     │                                                           │
+│     └─► Implementation bug?                                     │
+│         - Fix source code                                       │
+│     ↓                                                           │
+│  4. Re-run failed tests                                         │
+│     │                                                           │
+│     ├─► Still failing: Go to step 3                             │
+│     │                                                           │
+│     └─► All pass: Run full suite                                │
+│     ↓                                                           │
+│  5. Report final status                                         │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Example Output
+
+```
+🔧 FIX CYPRESS TESTS
+
+─────────────────────────────────────────
+
+📋 ITERATION 1
+
+Running Cypress tests...
+❌ 3 tests failing
+
+Failures:
+1. [UAT] products.cy.ts:45 - "should upload images"
+   Error: Element [data-cy=image-upload] not found
+
+2. [UAT] products.cy.ts:78 - "should filter by category"
+   Error: Expected 5, got 3
+
+3. [API] products.cy.ts:23 - "should create with category"
+   Error: Expected 201, got 400
+
+─────────────────────────────────────────
+
+🔍 ANALYZING FAILURE 1/3
+
+Test: should upload images
+Type: Selector not found
+
+Analysis:
+- Component uses: data-cy="upload-image"
+- Test expects: data-cy="image-upload"
+
+Action: Update test selector
+
+Fix applied:
+```typescript
+// Before
+cy.get('[data-cy=image-upload]')
+
+// After
+cy.get('[data-cy=upload-image]')
+```
+
+✓ Test file updated
+
+─────────────────────────────────────────
+
+🔍 ANALYZING FAILURE 2/3
+
+Test: should filter by category
+Type: Assertion mismatch
+
+Analysis:
+- Sample data has 3 products in "Electronics"
+- Test expects 5
+
+Action: Update test data or assertion
+
+Options:
+[1] Update assertion to match data (3)
+[2] Add more sample data
+[3] The data is wrong - fix sample
+
+> 1
+
+Fix applied:
+```typescript
+// Before
+pom.verifyProductCount(5);
+
+// After
+pom.verifyProductCount(3);
+```
+
+✓ Test file updated
+
+─────────────────────────────────────────
+
+🔍 ANALYZING FAILURE 3/3
+
+Test: should create with category
+Type: Implementation bug
+
+Analysis:
+- API returns 400: "categoryId required"
+- Test sends categoryId correctly
+- Bug: API validation not reading categoryId
+
+Action: Fix API implementation
+
+Fix applied in: core/api/v1/products/route.ts:34
+```typescript
+// Before
+const { name, price } = await req.json();
+
+// After
+const { name, price, categoryId } = await req.json();
+```
+
+✓ Implementation fixed
+
+─────────────────────────────────────────
+
+📋 ITERATION 2
+
+Re-running failed tests...
+✓ All 3 previously failed tests now pass
+
+Running full suite...
+✓ 20/20 tests passing
+
+─────────────────────────────────────────
+
+📊 SUMMARY
+
+Iterations: 2
+Tests fixed: 3
+  - 1 selector fix (test)
+  - 1 assertion fix (test)
+  - 1 implementation fix (source)
+
+Files modified:
+├─ cypress/e2e/uat/products.cy.ts (2 changes)
+└─ core/api/v1/products/route.ts (1 change)
+
+All tests passing.
+```
+
+---
+
+## Fix Categories
+
+| Category | Fix Location | Common Causes |
+|----------|--------------|---------------|
+| Selector | Test or Component | Changed markup, typo |
+| Timing | Test | Async operations, loading |
+| Assertion | Test | Changed behavior, data |
+| Implementation | Source | Bug in code |
+
+---
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--spec <pattern>` | Fix specific spec |
+| `--max-retries <n>` | Max fix iterations (default: 5) |
+| `--test-only` | Only fix test code, not source |
+| `--source-only` | Only fix source code |
+
+---
+
+## Related Commands
+
+| Command | Action |
+|---------|--------|
+| `/session:test:write` | Write new tests |
+| `/session:test:run` | Run tests |
+| `/session:fix:build` | Fix build errors |

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

@@ -0,0 +1,203 @@
+# /session:test:run
+
+Execute Cypress test suite with options for specific tests or full run.
+
+---
+
+## Syntax
+
+```
+/session:test:run [--spec <pattern>] [--tags <tags>]
+```
+
+---
+
+## Behavior
+
+Runs Cypress tests and reports results with detailed analysis.
+
+---
+
+## Flow
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  /session:test:run                                               │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  1. Determine tests to run                                      │
+│     - All tests, or filtered                                    │
+│     ↓                                                           │
+│  2. Start dev server (if not running)                           │
+│     ↓                                                           │
+│  3. Execute Cypress tests                                       │
+│     ↓                                                           │
+│  4. Collect results                                             │
+│     - Passed/Failed/Skipped                                     │
+│     - Screenshots on failure                                    │
+│     ↓                                                           │
+│  5. Analyze failures (if any)                                   │
+│     ↓                                                           │
+│  6. Report summary                                              │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Example Output
+
+```
+🧪 RUN TESTS
+
+─────────────────────────────────────────
+
+🚀 STARTING TEST RUN
+
+Server: http://localhost:3000 ✓
+Browser: Chrome (headless)
+Spec pattern: cypress/e2e/**/*.cy.ts
+
+─────────────────────────────────────────
+
+📋 EXECUTING TESTS
+
+API Tests:
+├─ products.cy.ts
+│  ├─ ✓ should create a product (1.2s)
+│  ├─ ✓ should get product by ID (0.8s)
+│  ├─ ✓ should update product (0.9s)
+│  ├─ ✓ should delete product (0.7s)
+│  ├─ ✓ should work with API key (1.1s)
+│  └─ ✓ should reject unauthenticated (0.5s)
+
+UAT Tests:
+├─ products.cy.ts
+│  ├─ ✓ should create a new product (3.2s)
+│  ├─ ❌ should upload product images (timeout)
+│  ├─ ✓ should assign categories (2.1s)
+│  ├─ ✓ should display with pagination (2.5s)
+│  └─ ✓ should show for team members (1.8s)
+
+─────────────────────────────────────────
+
+❌ FAILURE ANALYSIS
+
+Test: should upload product images
+File: cypress/e2e/uat/products.cy.ts:45
+
+Error:
+Timed out waiting for element: [data-cy=image-upload]
+
+Screenshot: cypress/screenshots/products-upload-fail.png
+
+Possible causes:
+1. Element not rendered (check component)
+2. Selector changed (verify data-cy)
+3. Async loading issue (add wait)
+
+─────────────────────────────────────────
+
+📊 SUMMARY
+
+Passed:  10
+Failed:  1
+Skipped: 0
+
+Duration: 14.8s
+
+Coverage:
+├─ API: 100% (6/6)
+└─ UAT: 80% (4/5)
+
+─────────────────────────────────────────
+
+Options:
+[1] Fix failing test (/session:test:fix)
+[2] View failure screenshot
+[3] Re-run failed test only
+```
+
+---
+
+## Run with Tags
+
+```
+/session:test:run --tags @api
+```
+
+Output:
+
+```
+🧪 RUN TESTS
+
+Filter: @api tag only
+
+─────────────────────────────────────────
+
+📋 EXECUTING TESTS
+
+Specs matching @api: 3 files
+Tests matching @api: 18 tests
+
+├─ products.cy.ts (6 tests)
+│  ├─ ✓ @api @crud should create
+│  ├─ ✓ @api @crud should read
+│  └─ ...
+├─ categories.cy.ts (6 tests)
+└─ users.cy.ts (6 tests)
+
+─────────────────────────────────────────
+
+📊 SUMMARY
+
+Passed:  18
+Failed:  0
+
+Duration: 8.2s
+
+All @api tests passing.
+```
+
+---
+
+## Run Specific Spec
+
+```
+/session:test:run --spec "cypress/e2e/uat/products.cy.ts"
+```
+
+---
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--spec <pattern>` | Run specific spec files |
+| `--tags <tags>` | Filter by grep tags |
+| `--headed` | Run with visible browser |
+| `--record` | Record to Cypress Cloud |
+| `--parallel` | Run in parallel |
+
+---
+
+## Test Tags Reference
+
+| Tag | Description |
+|-----|-------------|
+| `@api` | API tests |
+| `@uat` | UAT tests |
+| `@crud` | CRUD operations |
+| `@auth` | Authentication tests |
+| `@smoke` | Smoke tests (critical path) |
+| `@regression` | Full regression suite |
+
+---
+
+## Related Commands
+
+| Command | Action |
+|---------|--------|
+| `/session:test:write` | Write new tests |
+| `/session:test:fix` | Fix failing tests |
+| `/session:validate` | Full validation |