@atlashub/smartstack-cli 1.13.2 → 1.14.1

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

@@ -0,0 +1,63 @@
+# 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

@@ -0,0 +1,34 @@
+# 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

@@ -0,0 +1,61 @@
+# 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/05-examine.md

@@ -0,0 +1,58 @@
+# 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

@@ -0,0 +1,39 @@
+# 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

@@ -0,0 +1,56 @@
+# 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

@@ -0,0 +1,41 @@
+# 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_

package/templates/skills/apex/templates/README.md

@@ -0,0 +1,69 @@
+# APEX Template System
+
+## Overview
+
+This directory contains template files used to initialize APEX workflow outputs when save mode (`-s`) is enabled.
+
+## Template Files
+
+| Template | Purpose | Created When |
+|----------|---------|--------------|
+| `00-context.md` | Workflow configuration and progress tracking | Always (if save_mode) |
+| `01-analyze.md` | Analysis findings | Always (if save_mode) |
+| `02-plan.md` | Implementation plan | Always (if save_mode) |
+| `03-execute.md` | Implementation log | Always (if save_mode) |
+| `04-validate.md` | Validation results | Always (if save_mode) |
+| `05-examine.md` | Adversarial review findings | Only if examine_mode |
+| `06-resolve.md` | Finding resolution log | Only if examine_mode |
+| `07-tests.md` | Test analysis and creation | Only if test_mode |
+| `08-run-tests.md` | Test runner log | Only if test_mode |
+
+## Template Variables
+
+Templates use `{{variable}}` syntax for placeholders:
+
+| Variable | Description | Example |
+|----------|-------------|---------|
+| `{{task_id}}` | Kebab-case task identifier | `01-add-auth-middleware` |
+| `{{task_description}}` | Plain text task description | `add authentication middleware` |
+| `{{timestamp}}` | ISO 8601 timestamp | `2026-01-22T10:30:00Z` |
+| `{{auto_mode}}` | Auto mode flag | `true` or `false` |
+| `{{examine_mode}}` | Examine mode flag | `true` or `false` |
+| `{{save_mode}}` | Save mode flag | `true` or `false` |
+| `{{test_mode}}` | Test mode flag | `true` or `false` |
+| `{{economy_mode}}` | Economy mode flag | `true` or `false` |
+| `{{original_input}}` | Raw user input | `/apex -a -s add auth` |
+| `{{examine_status}}` | Progress status for examine steps | `Pending` or `Skip` |
+| `{{test_status}}` | Progress status for test steps | `Pending` or `Skip` |
+
+## How It Works
+
+1. **Initialization (step-00-init):**
+   - Creates output directory `.claude/output/apex/{task-id}/`
+   - Copies templates with variables replaced
+   - All files ready for appending
+
+2. **Each Step:**
+   - Reads from pre-created file if resuming
+   - Appends findings/outputs to step file
+   - Updates 00-context.md progress table
+
+3. **Benefits:**
+   - Consistent formatting across all workflows
+   - Easy to update templates
+   - Supports resume from any step
+
+## Output Structure
+
+```
+.claude/output/apex/{task-id}/
+├── 00-context.md      # Configuration + progress
+├── 01-analyze.md      # Analysis findings
+├── 02-plan.md         # Implementation plan
+├── 03-execute.md      # Execution log
+├── 04-validate.md     # Validation results
+├── 05-examine.md      # Review findings (if -x)
+├── 06-resolve.md      # Resolution log (if -x)
+├── 07-tests.md        # Test creation (if -t)
+└── 08-run-tests.md    # Test runner (if -t)
+```

package/templates/skills/application/SKILL.md

@@ -1,26 +1,26 @@
 ---
 name: application
 description: |
-  Crée des applications/modules SmartStack full-stack.
-  Utiliser ce skill quand:
-  - L'utilisateur demande de créer une application, un module, ou un context
-  - L'utilisateur mentionne "nouveau module", "nouvelle application", "ajouter une fonctionnalité"
-  - L'utilisateur veut étendre la navigation avec de nouvelles entrées
-  Scope: Context → Application → Module → Section (tous niveaux)
+  Creates SmartStack full-stack applications/modules.
+  Use this skill when:
+  - User asks to create an application, module, or context
+  - User mentions "new module", "new application", "add a feature"
+  - User wants to extend navigation with new entries
+  Scope: Context → Application → Module → Section (all levels)
 ---
 
 # Skill Application SmartStack
 
-**Référence:** [_shared.md](../_shared.md) pour architecture, permissions, i18n
+**Reference:** [_shared.md](../_shared.md) for architecture, permissions, i18n
 
-## QUAND CE SKILL S'ACTIVE
+## WHEN THIS SKILL ACTIVATES
 
-| Déclencheur | Exemple |
-|-------------|---------|
-| Demande explicite | "Crée un module pour gérer les produits" |
-| Nouvelle fonctionnalité | "Il faut ajouter la gestion des commandes" |
-| Extension navigation | "Ajoute une application CRM dans business" |
-| Mots-clés | "nouveau module", "nouvelle application", "ajouter un context" |
+| Trigger | Example |
+|---------|---------|
+| Explicit request | "Create a module to manage products" |
+| New feature | "We need to add order management" |
+| Navigation extension | "Add a CRM application in business" |
+| Keywords | "new module", "new application", "add a context" |
 
 ## FLOW ARCHITECTURE
 
@@ -28,44 +28,44 @@ description: |
 WEB (React) → API (.NET) → Application → Infrastructure → Database
 ```
 
-**INTERDIT:** WEB → Infrastructure (accès DB direct), WEB → Domain
+**FORBIDDEN:** WEB → Infrastructure (direct DB access), WEB → Domain
 
 ## WORKFLOW
 
-### 1. Détection du Niveau
+### 1. Level Detection
 
-| Indice | → Niveau |
-|--------|----------|
+| Hint | → Level |
+|------|---------|
 | "context", "workspace" | Context |
 | "application", "app" | Application |
-| "module", "fonctionnalité" | Module |
-| "section", "onglet" | Section |
+| "module", "feature" | Module |
+| "section", "tab" | Section |
 
-### 2. Extraction Paramètres
-`$LEVEL`, `$PARENT` (platform/business/personal), `$CODE` (kebab-case), `$LABEL_FR`, `$ICON` (Lucide)
+### 2. Parameter Extraction
+`$LEVEL`, `$PARENT` (platform/business/personal), `$CODE` (kebab-case), `$LABEL_EN`, `$ICON` (Lucide)
 
-### 3. Génération Full-Stack
+### 3. Full-Stack Generation
 ```
-1. DB SEED (Navigation + Translations 4 langues)
-2. PERMISSIONS (Permissions.cs + PermissionConfiguration.cs) ← 2 fichiers!
+1. DB SEED (Navigation + Translations 4 languages)
+2. PERMISSIONS (Permissions.cs + PermissionConfiguration.cs) ← 2 files!
 3. API (Controller + DTOs via /controller:create)
 4. SERVICES (Interface + Implementation)
 5. FRONTEND (Page + Components + Hooks)
 6. I18N (fr, en, it, de)
-7. ROUTES (nested routes obligatoires)
+7. ROUTES (nested routes mandatory)
 8. PREFERENCES (Hook pattern)
 9. MIGRATION (/efcore:migration)
 ```
 
-### 4. Chaînage Automatique
-- `/controller:create` → Controllers API
-- `/efcore:migration` → Migrations DB
+### 4. Automatic Chaining
+- `/controller:create` → API Controllers
+- `/efcore:migration` → DB Migrations
 - `/ui-components` → EntityCard, DataTable
 
-## PRÉFÉRENCES UTILISATEUR
+## USER PREFERENCES
 
-| Préférence | Stockage |
-|------------|----------|
+| Preference | Storage |
+|------------|---------|
 | pageSize | `user.preferences.{module}.pageSize` |
 | sortColumn/Direction | `user.preferences.{module}.sort*` |
 | filters | `user.preferences.{module}.filters` |
@@ -78,7 +78,7 @@ export function use{Module}Preferences() {
   return {
     pageSize: preferences.{module}?.pageSize ?? 10,
     setPageSize: (size: number) => updatePreference('{module}.pageSize', size),
-    // ... autres
+    // ... others
   };
 }
 ```
@@ -86,34 +86,34 @@ export function use{Module}Preferences() {
 ## ROUTING (React Router v7)
 
 ```tsx
-// ✅ CORRECT - Routes imbriquées
+// ✅ CORRECT - Nested routes
 <Route path="$APPLICATION">
   <Route index element={<Navigate to="$DEFAULT_MODULE" replace />} />
   <Route path="$MODULE1" element={<Module1Page />} />
 </Route>
 
-// ❌ INTERDIT - Routes plates (causent redirect vers Home)
+// ❌ FORBIDDEN - Flat routes (cause redirect to Home)
 <Route path="$APPLICATION" element={<Navigate ... />} />
 <Route path="$APPLICATION/$MODULE1" element={...} />
 ```
 
 ## INTEGRATIONS
 
-| Skill | Quand | Action |
-|-------|-------|--------|
-| `/notification` | Alertes utilisateur | INotificationService + SignalR |
-| `/workflow` | Emails automatiques | IWorkflowService.TriggerAsync |
-| `/ai-prompt` | Assistance IA | IAiCompletionService |
-| `/feature-full` | Feature complète | Orchestration tous skills |
+| Skill | When | Action |
+|-------|------|--------|
+| `/notification` | User alerts | INotificationService + SignalR |
+| `/workflow` | Automated emails | IWorkflowService.TriggerAsync |
+| `/ai-prompt` | AI assistance | IAiCompletionService |
+| `/feature-full` | Complete feature | Orchestration all skills |
 
-### Pattern Integration Notification
+### Notification Integration Pattern
 ```csharp
 await _notificationService.SendNotificationAsync(
     userId, NotificationType.{Entity}Created, title, message,
     relatedEntityType: nameof({Entity}), relatedEntityId: entity.Id);
 ```
 
-### Pattern Integration Workflow
+### Workflow Integration Pattern
 ```csharp
 await _workflowService.TriggerAsync("{entity}.created", new Dictionary<string, object>
 {
@@ -122,17 +122,17 @@ await _workflowService.TriggerAsync("{entity}.created", new Dictionary<string, o
 });
 ```
 
-## REGLES ABSOLUES
+## ABSOLUTE RULES
 
 | DO | DON'T |
 |----|-------|
-| 4 langues (FR, EN, IT, DE) | Import Infrastructure dans frontend |
-| Permissions: 2 fichiers | SQL direct dans frontend |
-| Routes imbriquées | Routes plates (flat siblings) |
-| EntityCard pour cards | Cards manuelles avec divs |
-| DataTable pour tableaux | GUIDs séquentiels |
+| 4 languages (FR, EN, IT, DE) | Import Infrastructure in frontend |
+| Permissions: 2 files | Direct SQL in frontend |
+| Nested routes | Flat routes (flat siblings) |
+| EntityCard for cards | Manual cards with divs |
+| DataTable for tables | Sequential GUIDs |
 
-## FICHIERS ASSOCIÉS
+## ASSOCIATED FILES
 
 - [templates-backend.md](templates-backend.md)
 - [templates-frontend.md](templates-frontend.md)

package/templates/skills/application/templates-backend.md

@@ -1,13 +1,13 @@
 # Templates Backend - Application Skill
 
-> Ces templates génèrent le code C# pour les nouvelles applications/modules.
+> These templates generate C# code for new applications/modules.
 
 ---
 
 ## TEMPLATE: PERMISSIONS CLASS
 
 ```csharp
-// Ajouter dans src/SmartStack.Application/Common/Authorization/Permissions.cs
+// Add to src/SmartStack.Application/Common/Authorization/Permissions.cs
 
 public static class $CONTEXT_PASCAL
 {
@@ -25,7 +25,7 @@ public static class $CONTEXT_PASCAL
 }
 ```
 
-### Exemple pour ERP > Sales > Products
+### Example for ERP > Sales > Products
 
 ```csharp
 public static class Erp
@@ -412,39 +412,39 @@ services.AddScoped<I$MODULE_PASCALService, $MODULE_PASCALService>();
 
 ---
 
-## CHAÎNAGE AVEC /controller:create
+## CHAINING WITH /controller:create
 
-Après génération des templates backend, le skill appelle automatiquement :
+After backend templates generation, the skill automatically calls:
 
 ```
 /controller:create $AREA $MODULE $ENTITY
 ```
 
-Exemple :
+Example:
 ```
 /controller:create Business Products Product
 ```
 
-Cela génère :
-- Controller avec CRUD complet
-- Endpoints REST
+This generates:
+- Full CRUD Controller
+- REST Endpoints
 - ProducesResponseType
-- Logging approprié
-- Tests Postman
+- Appropriate logging
+- Postman tests
 
 ---
 
-## CHECKLIST BACKEND
-
-| Vérification | Status |
-|--------------|--------|
-| ☐ Permissions.cs mis à jour | |
-| ☐ Service interface créée | |
-| ☐ Service implementation créée | |
-| ☐ DTOs créés | |
-| ☐ Domain entity créée | |
-| ☐ EF Configuration créée | |
-| ☐ DbContext mis à jour | |
-| ☐ DI registration ajoutée | |
-| ☐ /controller:create exécuté | |
-| ☐ dotnet build réussi | |
+## BACKEND CHECKLIST
+
+| Check | Status |
+|-------|--------|
+| ☐ Permissions.cs updated | |
+| ☐ Service interface created | |
+| ☐ Service implementation created | |
+| ☐ DTOs created | |
+| ☐ Domain entity created | |
+| ☐ EF Configuration created | |
+| ☐ DbContext updated | |
+| ☐ DI registration added | |
+| ☐ /controller:create executed | |
+| ☐ dotnet build successful | |