@atlashub/smartstack-cli 2.7.3 → 2.8.0

package/templates/skills/apex/steps/step-08-run-tests.md

@@ -1,207 +0,0 @@
----
-name: step-08-run-tests
-description: Test runner - execute tests until all pass
-prev_step: steps/step-07-tests.md
-next_step: COMPLETE
----
-
-# Step 8: Run Tests
-
-## MANDATORY EXECUTION RULES:
-
-- NEVER claim tests pass when they don't
-- NEVER give up after first failure
-- ALWAYS run full test suite
-- ALWAYS fix failing tests before proceeding
-- ALWAYS re-run after each fix
-- YOU ARE A TEST RUNNER, ensuring green build
-- FORBIDDEN to proceed with failing tests
-
-## YOUR TASK:
-
-Run the test suite, fix any failures, and ensure all tests pass.
-
----
-
-<available_state>
-From previous steps:
-
-| Variable | Description |
-|----------|-------------|
-| `{task_description}` | What was implemented |
-| `{task_id}` | Kebab-case identifier |
-| `{auto_mode}` | Auto-fix test failures |
-| `{save_mode}` | Save outputs to files |
-| `{output_dir}` | Path to output (if save_mode) |
-| Tests created | From step-07 |
-</available_state>
-
----
-
-## EXECUTION SEQUENCE:
-
-### 1. Run Test Suite
-
-```bash
-pnpm run test
-```
-
-Or for specific tests:
-```bash
-pnpm run test -- --filter="auth"
-```
-
-### 2. Analyze Results
-
-**If ALL PASS:**
-Skip to step 5 (Summary).
-
-**If FAILURES:**
-For each failing test:
-
-```markdown
-## Failing Test Analysis
-
-### Test: `validateToken should throw for expired token`
-**File:** `src/auth/__tests__/handler.test.ts:25`
-**Error:** `Expected: "Token expired", Received: "Invalid token"`
-
-**Root Cause Analysis:**
-- [ ] Test bug: Incorrect assertion
-- [x] Code bug: Wrong error message
-- [ ] Setup issue: Missing mock
-
-**Fix:** Update error message in `validateToken` to be "Token expired"
-```
-
-### 3. Fix Failures
-
-**Loop until green:**
-
-```
-WHILE tests failing:
-  1. Identify root cause (test bug vs code bug)
-  2. Apply fix
-  3. Re-run tests
-  4. Log result
-```
-
-**If `{auto_mode}` = true:**
-Auto-fix obvious issues, continue loop.
-
-**If `{auto_mode}` = false AND stuck:**
-
-```yaml
-questions:
-  - header: "Test Fix"
-    question: "Test is still failing. How should we proceed?"
-    options:
-      - label: "Try alternative fix (Recommended)"
-        description: "Attempt a different approach"
-      - label: "Skip this test"
-        description: "Mark as skipped with TODO"
-      - label: "Discuss the issue"
-        description: "Need help understanding the failure"
-    multiSelect: false
-```
-
-### 4. Verify All Green
-
-Final run:
-```bash
-pnpm run test
-```
-
-**MUST show all tests passing.**
-
-### 5. Save Output (if save_mode)
-
-**If `{save_mode}` = true:**
-
-Write to `{output_dir}/08-run-tests.md`:
-- Test run results
-- Failures encountered and fixes
-- Final status
-- Timestamp
-- Update 00-context.md Progress table: 08-run-tests -> Complete
-
-### 6. Test Summary
-
-```
-**Test Run Complete**
-
-**Total tests:** {count}
-**Passing:** {count}
-**Failed:** 0
-
-**Iterations to green:** {count}
-
-**Fixes applied:**
-- Fixed error message in validateToken
-- Fixed mock setup in route.test.ts
-
-**All tests passing.**
-```
-
-### 7. Determine Next Step
-
-```
-IF {examine_mode} = true AND not already examined:
-    -> Load step-05-examine.md
-
-ELSE:
-    -> Workflow complete - show final summary
-```
-
----
-
-## SUCCESS METRICS:
-
-- All tests executed
-- All failures investigated
-- Root causes identified
-- Fixes applied correctly
-- All tests passing at end
-
-## FAILURE MODES:
-
-- Claiming green when tests fail
-- Giving up after first failure
-- Skipping tests without good reason
-- Not re-running after fixes
-- Not logging fix iterations
-
----
-
-## NEXT STEP:
-
-- **If examine_mode and not examined:** Load `./step-05-examine.md`
-- **Otherwise:** Workflow complete - show final summary
-
-## FINAL SUMMARY TEMPLATE:
-
-```
-**APEX Workflow Complete**
-
-**Task:** {task_description}
-**Task ID:** {task_id}
-
-**Implementation:**
-- Files modified: {count}
-- Files created: {count}
-
-**Quality:**
-- Typecheck: Pass
-- Lint: Pass
-- Tests: {count}/{count} passing
-
-**Review:** {examined ? "Complete" : "Skipped"}
-**Findings resolved:** {count}
-
-**Output saved:** {output_dir or "Not saved"}
-
-**Next steps:**
-- [ ] Review changes: `git diff`
-- [ ] Commit: `git commit -m "{task_description}"`
-- [ ] Push and create PR
-```

package/templates/skills/apex/templates/00-context.md

@@ -1,46 +0,0 @@
-# APEX Task: {{task_id}}
-
-**Created:** {{timestamp}}
-**Task:** {{task_description}}
-
----
-
-## Configuration
-
-| Flag | Value |
-|------|-------|
-| Auto mode (`-a`) | {{auto_mode}} |
-| Examine mode (`-x`) | {{examine_mode}} |
-| Save mode (`-s`) | {{save_mode}} |
-| Test mode (`-t`) | {{test_mode}} |
-| Economy mode (`-e`) | {{economy_mode}} |
-
----
-
-## User Request
-
-```
-{{original_input}}
-```
-
----
-
-## Acceptance Criteria
-
-_To be defined in step-01-analyze_
-
----
-
-## Progress
-
-| Step | Status |
-|------|--------|
-| 00-init | {{init_status}} |
-| 01-analyze | Pending |
-| 02-plan | Pending |
-| 03-execute | Pending |
-| 04-validate | Pending |
-| 05-examine | {{examine_status}} |
-| 06-resolve | {{examine_status}} |
-| 07-tests | {{test_status}} |
-| 08-run-tests | {{test_status}} |

package/templates/skills/apex/templates/01-analyze.md

@@ -1,63 +0,0 @@
-# Step 01: Analyze
-
-**Task:** {{task_description}}
-**Started:** {{timestamp}}
-
----
-
-## Context Discovery
-
-### Search Keywords
-_Keywords extracted from task description_
-
-### Related Files Found
-
-| File | Lines | Contains |
-|------|-------|----------|
-| | | |
-
-### Patterns Observed
-_Patterns discovered in existing code_
-
-### Utilities Available
-_Existing utilities that can be reused_
-
-### Similar Implementations
-_Reference implementations found_
-
-### Test Patterns
-_How tests are structured in this project_
-
----
-
-## Documentation Insights
-
-### Libraries Used
-_Libraries and their usage patterns_
-
----
-
-## Research Findings
-
-### Common Approaches
-_Best practices discovered_
-
----
-
-## Inferred Acceptance Criteria
-
-- [ ] AC1:
-- [ ] AC2:
-- [ ] AC3:
-
----
-
-## Summary
-
-**Files analyzed:**
-**Patterns identified:**
-**Utilities found:**
-
----
-
-**Status:** _Pending_

package/templates/skills/apex/templates/02-plan.md

@@ -1,63 +0,0 @@
-# Step 02: Plan
-
-**Task:** {{task_description}}
-**Started:** {{timestamp}}
-
----
-
-## Implementation Plan
-
-### Overview
-_High-level strategy and approach_
-
-### Prerequisites
-- [ ] _Prerequisite 1_
-- [ ] _Prerequisite 2_
-
----
-
-## File Changes
-
-### `path/to/file1.ts`
-- _Change 1_
-- _Change 2_
-
-### `path/to/file2.ts` (NEW FILE)
-- _What to create_
-
----
-
-## Testing Strategy
-
-### New Tests
-- `path/to/file1.test.ts`
-  - _Test case 1_
-  - _Test case 2_
-
-### Update Existing Tests
-- _Existing test file to update_
-
----
-
-## Acceptance Criteria Mapping
-
-- [ ] AC1: Satisfied by _changes in file1.ts_
-- [ ] AC2: Satisfied by _changes in file2.ts_
-
----
-
-## Risks & Considerations
-
-- _Risk 1 and mitigation_
-
----
-
-## Summary
-
-**Files to modify:**
-**New files:**
-**Tests planned:**
-
----
-
-**Status:** _Pending_

package/templates/skills/apex/templates/03-execute.md

@@ -1,34 +0,0 @@
-# Step 03: Execute
-
-**Task:** {{task_description}}
-**Started:** {{timestamp}}
-
----
-
-## Implementation Log
-
-### Files Modified
-
-#### `path/to/file1.ts`
-- _Change applied (lines X-Y)_
-
-#### `path/to/file2.ts`
-- _Change applied_
-
----
-
-## Validation
-
-**Typecheck:** _Pending_
-**Lint:** _Pending_
-
----
-
-## Summary
-
-**Files modified:**
-**Todos completed:**
-
----
-
-**Status:** _Pending_

package/templates/skills/apex/templates/04-validate.md

@@ -1,61 +0,0 @@
-# Step 04: Validate
-
-**Task:** {{task_description}}
-**Started:** {{timestamp}}
-
----
-
-## Validation Results
-
-### Typecheck
-**Status:** _Pending_
-**Output:**
-```
-```
-
-### Lint
-**Status:** _Pending_
-**Output:**
-```
-```
-
-### Tests
-**Status:** _Pending_
-**Passing:** _/_
-**Output:**
-```
-```
-
----
-
-## Self-Audit Checklist
-
-### Tasks Complete
-- [ ] All todos marked complete
-- [ ] No tasks skipped
-
-### Tests Passing
-- [ ] All existing tests pass
-- [ ] New tests written
-
-### Acceptance Criteria
-- [ ] AC1: _Verified by..._
-- [ ] AC2: _Verified by..._
-
-### Patterns Followed
-- [ ] Code follows existing patterns
-- [ ] Error handling consistent
-- [ ] Naming conventions match
-
----
-
-## Summary
-
-**Typecheck:**
-**Lint:**
-**Tests:**
-**AC Verified:**
-
----
-
-**Status:** _Pending_

package/templates/skills/apex/templates/04b-doc-sync.md

@@ -1,31 +0,0 @@
-# Step 04b: Documentation Sync
-
-**Task:** {{task_description}}
-**Started:** {{timestamp}}
-
----
-
-## Manifest Status
-- **Found:** Yes | No
-- **Modules in manifest:** {{count}}
-
-## Affected Modules
-
-| Module | Changed Files | Impacted Sections | Updated |
-|--------|---------------|-------------------|---------|
-
-## Documentation Updates
-
-### Module: {{module_path}}
-- **doc-data.ts:** Updated fields: {{fields}}
-- **i18n FR:** {{updated|no_change}}
-- **Manifest:** Status → synced
-
-## Summary
-
-- **Modules checked:** {{count}}
-- **Modules updated:** {{count}}
-- **Modules skipped:** {{count}} (no documentation)
-- **Sections updated:** {{count}}
-
-**Status:** Complete

package/templates/skills/apex/templates/05-examine.md

@@ -1,58 +0,0 @@
-# Step 05: Examine (Adversarial Review)
-
-**Task:** {{task_description}}
-**Started:** {{timestamp}}
-
----
-
-## Files Reviewed
-
-| File | Type |
-|------|------|
-| | source |
-| | test |
-
----
-
-## Security Checklist
-
-- [ ] No SQL injection (parameterized queries)
-- [ ] No XSS (output encoding)
-- [ ] No secrets in code
-- [ ] Input validation present
-- [ ] Auth checks on protected routes
-
-## Logic Checklist
-
-- [ ] Error handling for all failure modes
-- [ ] Edge cases handled
-- [ ] Null/undefined checks
-- [ ] Race conditions considered
-
-## Quality Checklist
-
-- [ ] Follows existing patterns
-- [ ] No code duplication
-- [ ] Clear naming
-
----
-
-## Findings
-
-| ID | Severity | Category | Location | Issue | Validity |
-|----|----------|----------|----------|-------|----------|
-| | | | | | |
-
----
-
-## Summary
-
-**Total findings:**
-**Critical:**
-**High:**
-**Medium:**
-**Low:**
-
----
-
-**Status:** _Pending_

package/templates/skills/apex/templates/06-resolve.md

@@ -1,39 +0,0 @@
-# Step 06: Resolve Findings
-
-**Task:** {{task_description}}
-**Started:** {{timestamp}}
-
----
-
-## Resolution Log
-
-### Fixed
-
-| ID | Location | Fix Applied |
-|----|----------|-------------|
-| | | |
-
-### Skipped
-
-| ID | Location | Reason |
-|----|----------|--------|
-| | | |
-
----
-
-## Post-Fix Validation
-
-**Typecheck:** _Pending_
-**Lint:** _Pending_
-
----
-
-## Summary
-
-**Findings fixed:**
-**Findings skipped:**
-**Validation:**
-
----
-
-**Status:** _Pending_

package/templates/skills/apex/templates/07-tests.md

@@ -1,56 +0,0 @@
-# Step 07: Test Analysis & Creation
-
-**Task:** {{task_description}}
-**Started:** {{timestamp}}
-
----
-
-## Test Coverage Analysis
-
-### Existing Test Structure
-- **Framework:** _vitest/jest_
-- **Pattern:** _describe/it_
-- **Location:** _**/__tests__/_
-
-### Coverage Gaps
-
-| File | Existing | New Code | Gap |
-|------|----------|----------|-----|
-| | | | |
-
----
-
-## Test Plan
-
-### New Test Files
-
-| File | Tests Planned |
-|------|---------------|
-| | |
-
-### Test Cases
-
-| File | Function | Test Case | Priority |
-|------|----------|-----------|----------|
-| | | | |
-
----
-
-## Tests Created
-
-### `path/to/file.test.ts`
-```typescript
-// Test code added
-```
-
----
-
-## Summary
-
-**New test files:**
-**Test cases added:**
-**Coverage improvement:**
-
----
-
-**Status:** _Pending_

package/templates/skills/apex/templates/08-run-tests.md

@@ -1,41 +0,0 @@
-# Step 08: Run Tests
-
-**Task:** {{task_description}}
-**Started:** {{timestamp}}
-
----
-
-## Test Run Log
-
-### Run 1
-**Command:** `pnpm run test`
-**Result:** _Pending_
-**Output:**
-```
-```
-
-### Failures & Fixes
-
-| Test | Error | Root Cause | Fix |
-|------|-------|------------|-----|
-| | | | |
-
----
-
-## Final Results
-
-**Total tests:**
-**Passing:**
-**Failed:** 0
-
-**Iterations to green:**
-
----
-
-## Summary
-
-All tests passing: _Yes/No_
-
----
-
-**Status:** _Pending_