@atlashub/smartstack-cli 1.13.2 → 1.14.1

package/templates/skills/business-analyse/templates-react.md

@@ -1,25 +1,25 @@
-# Templates React - Documentation FRD
+# Templates React - FRD Documentation
 
-> **Usage:** Templates pour générer la documentation HTML (React) des specs fonctionnelles
+> **Usage:** Templates for generating HTML (React) documentation of functional specifications
 > **Output:** `web/smartstack-web/src/pages/docs/business/{app}/{module}/`
-> **Context7:** Utiliser pour génération de code React à jour
+> **Context7:** Use for up-to-date React code generation
 
 ---
 
-## RÈGLE CONTEXT7 (OBLIGATOIRE)
+## CONTEXT7 RULE (MANDATORY)
 
 ```
 ╔══════════════════════════════════════════════════════════════════════════════╗
-║  GÉNÉRATION REACT AVEC CONTEXT7                                              ║
+║  REACT GENERATION WITH CONTEXT7                                              ║
 ╠══════════════════════════════════════════════════════════════════════════════╣
 ║                                                                              ║
-║  TOUJOURS utiliser Context7 pour la génération de composants React:          ║
+║  ALWAYS use Context7 for React component generation:                         ║
 ║                                                                              ║
 ║  Prompt pattern:                                                             ║
 ║  "use context7 with /facebook/react and /i18next/react-i18next              ║
 ║   to generate {component} following SmartStack patterns"                     ║
 ║                                                                              ║
-║  Libraries à référencer:                                                     ║
+║  Libraries to reference:                                                     ║
 ║  • /facebook/react - React 19 patterns                                       ║
 ║  • /i18next/react-i18next - Internationalization                             ║
 ║  • /remix-run/react-router - React Router v7                                 ║
@@ -34,7 +34,7 @@
 
 ```tsx
 // web/smartstack-web/src/pages/docs/business/{app}/{module}/FrdDocPage.tsx
-// GÉNÉRER AVEC: use context7 with /facebook/react
+// GENERATE WITH: use context7 with /facebook/react
 
 import { Link } from 'react-router-dom';
 import { useTranslation } from 'react-i18next';
@@ -51,7 +51,7 @@ import {
   Database
 } from 'lucide-react';
 
-// Types pour les données FRD
+// Types for FRD data
 interface UseCase {
   id: string;
   name: string;
@@ -83,7 +83,7 @@ interface FrdData {
   permissions: Permission[];
 }
 
-// Données chargées depuis le FRD (à générer dynamiquement)
+// Data loaded from FRD (to be generated dynamically)
 const frdData: FrdData = {
   featureId: 'FEAT-XXX',
   moduleName: '{ModuleName}',
@@ -120,7 +120,7 @@ const frdData: FrdData = {
   ]
 };
 
-// Composant Badge de priorité
+// Priority Badge Component
 function PriorityBadge({ priority }: { priority: string }) {
   const colors = {
     Must: 'bg-red-500/10 text-red-600',
@@ -134,7 +134,7 @@ function PriorityBadge({ priority }: { priority: string }) {
   );
 }
 
-// Composant Section numérotée
+// Numbered Section Component
 function NumberedSection({
   number,
   title,
@@ -203,7 +203,7 @@ export function {ModuleName}FrdDocPage() {
         </p>
       </header>
 
-      {/* Table des matières */}
+      {/* Table of Contents */}
       <div className="card p-4 bg-[var(--bg-secondary)]">
         <h2 className="font-semibold mb-3 flex items-center gap-2">
           <List className="w-4 h-4" />
@@ -223,7 +223,7 @@ export function {ModuleName}FrdDocPage() {
         </nav>
       </div>
 
-      {/* Section 1: Vue d'ensemble */}
+      {/* Section 1: Overview */}
       <NumberedSection number={1} title={t('sections.overview')} icon={Layout}>
         <p className="text-[var(--text-secondary)] mb-4">
           {t(`modules.${frdData.moduleName.toLowerCase()}.overview`)}
@@ -250,7 +250,7 @@ export function {ModuleName}FrdDocPage() {
         </div>
       </NumberedSection>
 
-      {/* Section 2: Cas d'utilisation */}
+      {/* Section 2: Use Cases */}
       <NumberedSection number={2} title={t('sections.useCases')} icon={Users}>
         <div className="space-y-4">
           {frdData.useCases.map((uc) => (
@@ -276,7 +276,7 @@ export function {ModuleName}FrdDocPage() {
         </div>
       </NumberedSection>
 
-      {/* Section 3: Règles métier */}
+      {/* Section 3: Business Rules */}
       <NumberedSection number={3} title={t('sections.businessRules')} icon={CheckCircle}>
         <div className="overflow-x-auto">
           <table className="w-full text-sm">
@@ -322,7 +322,7 @@ export function {ModuleName}FrdDocPage() {
           ))}
         </div>
 
-        {/* Avertissement permissions */}
+        {/* Permission Warning */}
         <div className="mt-4 p-4 rounded-lg bg-amber-500/10 border border-amber-500/20 flex items-start gap-3">
           <AlertTriangle className="w-5 h-5 text-amber-600 flex-shrink-0 mt-0.5" />
           <div>
@@ -340,7 +340,7 @@ export function {ModuleName}FrdDocPage() {
           <div className="text-center text-sm text-[var(--text-tertiary)] mb-4">
             {t('common.wireframePreview')}
           </div>
-          {/* Wireframe simplifié */}
+          {/* Simplified wireframe */}
           <div className="space-y-4">
             <div className="h-12 bg-[var(--bg-secondary)] rounded flex items-center px-4 justify-between">
               <span className="text-sm">[Header + Navigation]</span>
@@ -395,7 +395,7 @@ export function {ModuleName}FrdDocPage() {
         </div>
       </NumberedSection>
 
-      {/* Navigation footer */}
+      {/* Navigation Footer */}
       <div className="flex justify-between pt-6 border-t border-[var(--border-color)]">
         <Link
           to={`/docs/business/${frdData.applicationName.toLowerCase()}`}
@@ -569,12 +569,12 @@ export function {App}DocsIndexPage() {
 
 ---
 
-## Checklist génération
+## Generation Checklist
 
-Lors de la génération avec `/business-analyse:7-doc-html`:
+When generating with `/business-analyse:7-doc-html`:
 
-- [ ] Utiliser Context7 pour patterns React actuels
-- [ ] Générer `FrdDocPage.tsx` avec données du FRD
-- [ ] Créer/mettre à jour `docs-business.json` (4 langues)
-- [ ] Ajouter route dans `App.tsx`
-- [ ] Mettre à jour index parent si nouveau module
+- [ ] Use Context7 for current React patterns
+- [ ] Generate `FrdDocPage.tsx` with FRD data
+- [ ] Create/update `docs-business.json` (4 languages)
+- [ ] Add route in `App.tsx`
+- [ ] Update parent index if new module

package/templates/skills/controller/SKILL.md

@@ -1,113 +1,162 @@
 ---
 name: controller
-description: |
-  Génère automatiquement des controllers API pour SmartStack.
-  Utiliser ce skill quand:
-  - L'utilisateur demande de créer un controller, endpoint, ou API
-  - L'utilisateur mentionne "CRUD", "REST API", "endpoint"
-  - L'utilisateur veut ajouter des actions à un module existant
-  - Après création d'une entité Domain pour exposer via API
-  Types: CRUD standard, Auth/Login, Custom actions
+description: Generate SmartStack API controllers with progressive step loading and context refresh.
+argument-hint: "[-a] [-p] [-d] [-i] <area> <module> [entity]"
 ---
 
-# Skill Controller SmartStack
+<objective>
+Generate complete API controllers following SmartStack conventions. Uses progressive step loading to minimize context usage and ensure thorough validation at each phase.
+</objective>
 
-**Référence:** [_shared.md](../_shared.md) pour permissions, services, sécurité
+<quick_start>
+**Basic usage:**
 
-## QUAND CE SKILL S'ACTIVE
-
-| Déclencheur | Exemple |
-|-------------|---------|
-| Demande explicite | "Crée un controller pour les tickets" |
-| Mention d'API | "Il faut exposer les SLA via REST" |
-| Après entité Domain | "L'entité est prête, génère l'API" |
-| Mots-clés | "CRUD", "endpoint", "controller", "API REST" |
-
-## WORKFLOW
-
-### 1. Détection du Type
-
-| Indice | → Type |
-|--------|--------|
-| Authentification, login | `auth` |
-| Module avec CRUD | `crud` |
-| Actions spécifiques | `custom` |
+```bash
+/controller Admin Users
+```
 
-### 2. Extraction Paramètres
-`$AREA` (Admin/Support/Business), `$MODULE`, `$ENTITY`, `$PERMISSION_PATH` (platform.support.tickets)
+**With Postman tests:**
 
-### 3. Exécution
-Suivre workflow `/controller:create`
+```bash
+/controller -p Support Tickets Ticket
+```
 
-### 4. Synchronisation Permissions (OBLIGATOIRE)
+**Full generation (auto + DTOs + Postman):**
 
-```
-1. GÉNÉRER CONTROLLER avec [RequirePermission(Permissions.{Module}.View)]
-2. AJOUTER À Permissions.cs (Application layer)
-3. AJOUTER À PermissionConfiguration.cs (Infrastructure - HasData)
-4. CRÉER MIGRATION: /efcore:migration Add{Module}Permissions
-5. VALIDER: tous paths dans Permissions.cs existent dans PermissionConfiguration.cs
+```bash
+/controller -a -d -p Business Orders Order
 ```
 
-## SÉCURITÉ (OBLIGATOIRE)
+**Flags:**
 
-### Logs Critiques
-| Événement | Niveau |
-|-----------|--------|
-| Login échoué | `Critical` |
-| Compte verrouillé | `Critical` |
-| Password change | `Warning` |
-| Suppression | `Warning` |
+- `-a` (auto): Skip confirmations
+- `-p` (postman): Generate Postman tests
+- `-d` (dtos): Generate request/response DTOs
+- `-i` (interactive): Configure via menu
 
-### Protection Comptes Système
-```csharp
-if (entity.UserType == UserType.System || entity.UserType == UserType.LocalAdmin)
-    return BadRequest(new { message = "Cannot modify system accounts" });
-```
+See `<parameters>` for complete flag list.
+</quick_start>
 
-### Permissions
-```csharp
-[RequirePermission(Permissions.Support.Tickets.View)]  // ✅
-[RequirePermission("platform.support.tickets.read")]   // ❌ Éviter strings
-```
+<parameters>
 
-### Cache Invalidation (si rôles/permissions)
-```csharp
-await _permissionService.InvalidateUserPermissionsCacheAsync(userId, ct);
-```
+<flags>
+**Enable flags (turn ON):**
+| Short | Long | Description |
+|-------|------|-------------|
+| `-a` | `--auto` | Autonomous mode: skip confirmations |
+| `-p` | `--postman` | Postman mode: generate API tests |
+| `-d` | `--dtos` | DTO mode: generate CreateDto, UpdateDto, ResponseDto |
+| `-i` | `--interactive` | Interactive mode: configure flags via menu |
 
-## SERVICES À INJECTER
-
-| Service | Usage | Obligatoire |
-|---------|-------|-------------|
-| `IApplicationDbContext` | Accès DB | ✅ |
-| `ICurrentUserService` | User courant | ✅ |
-| `ILogger<T>` | Logging | ✅ |
-| `IPermissionService` | Cache permissions | Si roles |
-| `IPasswordService` | Hash passwords | Si auth |
-| `IJwtService` | Tokens JWT | Si auth |
-
-## PRODUCES RESPONSE TYPE (OBLIGATOIRE)
-
-```csharp
-[ProducesResponseType(typeof(ItemDto), StatusCodes.Status200OK)]
-[ProducesResponseType(StatusCodes.Status401Unauthorized)]  // Si [Authorize]
-[ProducesResponseType(StatusCodes.Status403Forbidden)]     // Si [RequirePermission]
-[ProducesResponseType(StatusCodes.Status404NotFound)]      // Si GET by ID
-[ProducesResponseType(StatusCodes.Status400BadRequest)]    // Si validation
-```
+**Disable flags (turn OFF):**
+| Short | Long | Description |
+|-------|------|-------------|
+| `-A` | `--no-auto` | Disable auto mode |
+| `-P` | `--no-postman` | Disable postman mode |
+| `-D` | `--no-dtos` | Disable DTO mode |
+</flags>
 
-## TESTS POSTMAN
+<examples>
+```bash
+# Basic CRUD controller
+/controller Admin Users
 
-| Test | User | Status |
-|------|------|--------|
-| GET list | SuperAdmin | 200 |
-| GET list | NoPerm | 403 |
-| GET list | Anonymous | 401 |
-| POST create | WithPerm | 201 |
-| DELETE | ReadOnly | 403 |
+# With specific entity name
+/controller Support Tickets Ticket
 
-## FICHIERS ASSOCIÉS
+# Full autonomous generation
+/controller -a -d -p Admin Roles Role
 
-- [templates.md](templates.md)
-- [postman-templates.md](postman-templates.md)
+# Interactive mode
+/controller -i Business Products
+```
+</examples>
+
+<parsing_rules>
+**Argument parsing:**
+
+1. Parse flags first (remove from input)
+2. `{area}` = First remaining word (Admin, Support, Business, User, Auth)
+3. `{module}` = Second remaining word (PascalCase)
+4. `{entity}` = Third word OR singularize({module})
+</parsing_rules>
+
+</parameters>
+
+<workflow>
+**Standard flow:**
+1. Parse flags and arguments
+2. Analyze existing codebase (Entity, DbContext, Permissions)
+3. Plan controller structure (endpoints, DTOs, permissions)
+4. Generate controller file
+5. Synchronize permissions (Permissions.cs + PermissionConfiguration.cs)
+6. Generate Postman tests (if -p)
+7. Validate build and conventions
+</workflow>
+
+<state_variables>
+**Persist throughout all steps:**
+
+| Variable | Type | Description |
+|----------|------|-------------|
+| `{area}` | string | Controller area (Admin, Support, Business, User, Auth) |
+| `{module}` | string | Module name PascalCase (e.g., Users, Tickets) |
+| `{entity}` | string | Entity name PascalCase (e.g., User, Ticket) |
+| `{controller_type}` | string | crud, readonly, auth, custom |
+| `{permission_path}` | string | Full permission path (e.g., platform.support.tickets) |
+| `{auto_mode}` | boolean | Skip confirmations |
+| `{postman_mode}` | boolean | Generate Postman tests |
+| `{dto_mode}` | boolean | Generate DTOs |
+| `{interactive_mode}` | boolean | Configure interactively |
+
+</state_variables>
+
+<entry_point>
+
+**FIRST ACTION:** Load `steps/step-00-init.md`
+
+</entry_point>
+
+<step_files>
+**Progressive loading - only load current step:**
+
+| Step | File | Purpose |
+|------|------|---------|
+| 00 | `steps/step-00-init.md` | Parse args, validate area/module, initialize state |
+| 01 | `steps/step-01-analyze.md` | Find Entity, DbContext, existing patterns |
+| 02 | `steps/step-02-plan.md` | Plan endpoints, DTOs, permissions |
+| 03 | `steps/step-03-generate.md` | Generate controller + DTOs |
+| 04 | `steps/step-04-perms.md` | Sync Permissions.cs + PermissionConfiguration.cs |
+| 05 | `steps/step-05-validate.md` | Build check, convention validation |
+
+</step_files>
+
+<execution_rules>
+
+- **Load one step at a time** - Only load the current step file
+- **ULTRA THINK** before code generation
+- **Persist state variables** across all steps
+- **Follow next_step directive** at end of each step
+- **NEVER skip permission sync** - security is mandatory
+- **Use templates from** `templates.md` and `postman-templates.md`
+</execution_rules>
+
+<security_rules>
+
+**MANDATORY - Never skip:**
+
+1. `[RequirePermission(Permissions.*)]` - Never use string literals
+2. `[ProducesResponseType]` - Document all response codes
+3. Protect system accounts (UserType.System/LocalAdmin)
+4. Log all operations (Info for CRUD, Warning for Delete)
+5. No raw SQL - use EF Core only
+</security_rules>
+
+<success_criteria>
+
+- Controller follows SmartStack conventions
+- Permissions synced in both files
+- Build passes without errors
+- Postman tests generated (if -p)
+- All endpoints documented with [ProducesResponseType]
+</success_criteria>

package/templates/skills/controller/postman-templates.md

@@ -1,7 +1,7 @@
-# Templates Postman SmartStack
+# SmartStack Postman Templates
 
-> **Note:** Ces templates sont utilisés pour générer automatiquement les tests Postman
-> après la création d'un controller.
+> **Note:** These templates are used to automatically generate Postman tests
+> after creating a controller.
 
 ---
 
@@ -23,16 +23,16 @@
 
 ---
 
-## Users de Test Disponibles
+## Available Test Users
 
 | User | Email | Password | Permissions |
 |------|-------|----------|-------------|
-| SuperAdmin | `superadmin@smartstack.test` | `SuperAdmin123!` | `*` (toutes) |
+| SuperAdmin | `superadmin@smartstack.test` | `SuperAdmin123!` | `*` (all) |
 | PlatformAdmin | `platformadmin@smartstack.test` | `PlatformAdmin123!` | `platform.administration.*` |
 | User | `user@smartstack.test` | `User123!` | Standard |
-| ReadOnly | `readonly@smartstack.test` | `ReadOnly123!` | `*.read` uniquement |
-| NoPerm | `noperm@smartstack.test` | `NoPerm123!` | Aucune |
-| Inactive | `inactive@smartstack.test` | `Inactive123!` | Compte désactivé |
+| ReadOnly | `readonly@smartstack.test` | `ReadOnly123!` | `*.read` only |
+| NoPerm | `noperm@smartstack.test` | `NoPerm123!` | None |
+| Inactive | `inactive@smartstack.test` | `Inactive123!` | Disabled account |
 
 ---
 
@@ -585,17 +585,17 @@
 
 ---
 
-## Génération Automatique
+## Automatic Generation
 
-Pour générer les tests d'un nouveau controller, remplacer :
+To generate tests for a new controller, replace:
 
-| Variable | Exemple |
+| Variable | Example |
 |----------|---------|
 | `{area}` | `support`, `admin`, `business` |
 | `{module}` | `tickets`, `sla`, `users` |
 | `{Entity}` | `Ticket`, `SlaDefinition`, `User` |
 
-### Tests Minimum par Controller
+### Minimum Tests per Controller
 
 1. GET list - SuperAdmin (200)
 2. GET list - NoPerm (403)
@@ -604,11 +604,11 @@ Pour générer les tests d'un nouveau controller, remplacer :
 5. POST create - ReadOnly (403)
 6. DELETE - ReadOnly (403)
 
-### Tests Optionnels
+### Optional Tests
 
 - GET by ID - (200)
 - GET by ID - Not Found (404)
 - PUT update - (200)
 - PATCH activate/deactivate - (204)
-- POST avec données invalides - (400)
-- POST doublon - (409)
+- POST with invalid data - (400)
+- POST duplicate - (409)

package/templates/skills/controller/steps/step-00-init.md

@@ -0,0 +1,191 @@
+---
+name: step-00-init
+description: Initialize controller generation - parse arguments, validate inputs, setup state
+next_step: steps/step-01-analyze.md
+---
+
+# Step 0: Initialization
+
+## MANDATORY EXECUTION RULES:
+
+- NEVER skip argument parsing
+- ALWAYS validate area is valid (Admin, Support, Business, User, Auth)
+- YOU ARE AN INITIALIZER, not a generator
+- FORBIDDEN to load step-01 until init is complete
+
+## YOUR TASK:
+
+Parse arguments, validate inputs, and initialize state variables for controller generation.
+
+---
+
+<defaults>
+## Default Configuration
+
+```yaml
+auto_mode: false      # -a: Skip confirmations
+postman_mode: false   # -p: Generate Postman tests
+dto_mode: false       # -d: Generate DTOs
+interactive_mode: false # -i: Configure via menu
+```
+</defaults>
+
+---
+
+## EXECUTION SEQUENCE:
+
+### 1. Parse Flags and Input
+
+**Step 1: Load defaults from config above**
+
+```
+{auto_mode}        = false
+{postman_mode}     = false
+{dto_mode}         = false
+{interactive_mode} = false
+```
+
+**Step 2: Parse user input and override defaults:**
+
+```
+Enable flags (lowercase - turn ON):
+  -a or --auto      -> {auto_mode} = true
+  -p or --postman   -> {postman_mode} = true
+  -d or --dtos      -> {dto_mode} = true
+  -i or --interactive -> {interactive_mode} = true
+
+Disable flags (UPPERCASE - turn OFF):
+  -A or --no-auto     -> {auto_mode} = false
+  -P or --no-postman  -> {postman_mode} = false
+  -D or --no-dtos     -> {dto_mode} = false
+
+Arguments (after flags removed):
+  First word  -> {area}
+  Second word -> {module}
+  Third word  -> {entity} (optional, default = singularize({module}))
+```
+
+### 2. Validate Area
+
+**Valid areas:**
+
+| Area | Route Prefix | Permission Context |
+|------|--------------|-------------------|
+| `Admin` | `api/admin/` | `platform.administration.` |
+| `Support` | `api/support/` | `platform.support.` |
+| `Business` | `api/business/` | `business.` |
+| `User` | `api/user/` | `personal.myspace.` |
+| `Auth` | `api/auth/` | (AllowAnonymous) |
+
+**If {area} missing or invalid:**
+
+```yaml
+AskUserQuestion:
+  header: "Area"
+  question: "Which area for the controller?"
+  options:
+    - label: "Admin"
+      description: "Platform administration (api/admin/)"
+    - label: "Support"
+      description: "Support features (api/support/)"
+    - label: "Business"
+      description: "Business modules (api/business/)"
+    - label: "User"
+      description: "User-facing features (api/user/)"
+```
+
+### 3. Validate Module
+
+**If {module} missing:**
+
+```yaml
+AskUserQuestion:
+  header: "Module"
+  question: "What is the module name? (PascalCase, e.g., Tickets, Users)"
+  # Free text input
+```
+
+**Normalize:**
+- Convert to PascalCase
+- Example: "tickets" → "Tickets", "user-roles" → "UserRoles"
+
+### 4. Derive Entity Name
+
+**If {entity} not provided:**
+
+```
+{entity} = singularize({module})
+
+Examples:
+  Users → User
+  Tickets → Ticket
+  Categories → Category
+  SlaDefinitions → SlaDefinition
+```
+
+### 5. Compute Permission Path
+
+**Based on {area}:**
+
+```
+Admin    → {permission_path} = "platform.administration.{module_lowercase}"
+Support  → {permission_path} = "platform.support.{module_lowercase}"
+Business → {permission_path} = "business.{module_lowercase}"
+User     → {permission_path} = "personal.myspace.{module_lowercase}"
+Auth     → {permission_path} = null (AllowAnonymous)
+```
+
+### 6. Interactive Mode (if -i flag)
+
+If `{interactive_mode}` = true:
+
+```yaml
+questions:
+  - header: "Configure"
+    question: "Select options for controller generation:"
+    options:
+      - label: "Auto mode (-a)"
+        description: "Skip all confirmations"
+      - label: "Postman tests (-p)"
+        description: "Generate Postman test collection"
+      - label: "DTOs (-d)"
+        description: "Generate CreateDto, UpdateDto, ResponseDto"
+    multiSelect: true
+```
+
+### 7. Show Summary and Proceed
+
+**Always show COMPACT summary:**
+
+```
+Controller: {area}/{module}Controller
+
+| Variable | Value |
+|----------|-------|
+| {area} | Admin |
+| {module} | Users |
+| {entity} | User |
+| {permission_path} | platform.administration.users |
+| {auto_mode} | true/false |
+| {postman_mode} | true/false |
+| {dto_mode} | true/false |
+
+-> Analyzing codebase...
+```
+
+**Then proceed directly to step-01-analyze.md**
+
+---
+
+## SUCCESS METRICS:
+
+- All arguments correctly parsed
+- Area validated against allowed values
+- Module/Entity derived correctly
+- Permission path computed
+- Output is COMPACT (one table)
+- Proceeded to step-01 immediately after summary
+
+## NEXT STEP:
+
+After showing initialization summary, always proceed directly to `./step-01-analyze.md`