@atlashub/smartstack-cli 1.4.0 → 1.5.0

package/templates/commands/validate.md

@@ -0,0 +1,233 @@
+---
+description: Validate SmartStack conventions using MCP
+agent: action
+model: sonnet
+---
+
+# /validate - SmartStack Conventions Validator
+
+Validates the SmartStack project against established conventions using **SmartStack MCP**.
+
+**USAGE:** Before commits, PRs, or as part of CI/CD to ensure code quality.
+
+**INTEGRATION:** Uses `mcp__smartstack__validate_conventions` for comprehensive analysis.
+
+---
+
+## Available Commands
+
+| Command | Description | Checks |
+|---------|-------------|--------|
+| `/validate` | Run all validations | All |
+| `/validate:tables` | Validate table naming | SQL schemas, prefixes |
+| `/validate:migrations` | Validate migration naming | Format, order |
+| `/validate:services` | Validate service pattern | I*Service interfaces |
+| `/validate:namespaces` | Validate namespace structure | Layer separation |
+
+---
+
+## STEP 1: Invoke MCP validate_conventions
+
+> **MCP INTEGRATION:** This command uses the SmartStack MCP server for validation.
+
+**Claude instruction:** Call the MCP tool:
+
+```json
+{
+  "tool": "mcp__smartstack__validate_conventions",
+  "parameters": {
+    "checks": ["all"]
+  }
+}
+```
+
+For specific checks:
+
+```json
+{
+  "tool": "mcp__smartstack__validate_conventions",
+  "parameters": {
+    "checks": ["tables", "migrations"]
+  }
+}
+```
+
+---
+
+## STEP 2: Parse MCP Response
+
+The MCP returns a `ValidationResult`:
+
+```typescript
+interface ValidationResult {
+  valid: boolean;
+  errors: ValidationIssue[];
+  warnings: ValidationIssue[];
+  summary: string;
+}
+
+interface ValidationIssue {
+  type: 'error' | 'warning';
+  category: 'tables' | 'migrations' | 'services' | 'namespaces';
+  message: string;
+  file?: string;
+  line?: number;
+  suggestion?: string;
+}
+```
+
+---
+
+## STEP 3: Display Results
+
+**If `valid: true` with no warnings:**
+
+```
+================================================================================
+                    SMARTSTACK CONVENTIONS VALIDATION
+================================================================================
+
+STATUS: PASSED
+
+Checks performed: tables, migrations, services, namespaces
+Errors: 0
+Warnings: 0
+
+All conventions validated successfully!
+
+================================================================================
+```
+
+**If `valid: false` or has warnings:**
+
+```
+================================================================================
+                    SMARTSTACK CONVENTIONS VALIDATION
+================================================================================
+
+STATUS: {valid ? "PASSED (with warnings)" : "FAILED"}
+
+ERRORS ({errors.length})
+--------------------------------------------------------------------------------
+{for each error in errors}
+  [{error.category}] {error.message}
+    File: {error.file}
+    Suggestion: {error.suggestion}
+{end for}
+--------------------------------------------------------------------------------
+
+WARNINGS ({warnings.length})
+--------------------------------------------------------------------------------
+{for each warning in warnings}
+  [{warning.category}] {warning.message}
+    File: {warning.file}
+    Suggestion: {warning.suggestion}
+{end for}
+--------------------------------------------------------------------------------
+
+================================================================================
+```
+
+---
+
+## Validation Rules
+
+### Tables (`checks: ["tables"]`)
+
+| Rule | Valid | Invalid |
+|------|-------|---------|
+| Schema | `core`, `extensions` | `dbo`, custom |
+| Prefix | `auth_Users`, `nav_Items` | `Users`, `Items` |
+
+**Valid prefixes:** `auth_`, `nav_`, `usr_`, `ai_`, `cfg_`, `wkf_`, `support_`, `entra_`, `ref_`, `loc_`, `lic_`
+
+### Migrations (`checks: ["migrations"]`)
+
+| Rule | Valid | Invalid |
+|------|-------|---------|
+| Format | `core_v1.0.0_001_AddUsers` | `AddUsersTable` |
+| Order | v1.0.0 before v1.1.0 | v1.1.0 before v1.0.0 |
+
+**Format:** `{context}_v{version}_{sequence}_{Description}`
+
+### Services (`checks: ["services"]`)
+
+| Rule | Valid | Invalid |
+|------|-------|---------|
+| Interface | `IUserService` | `UserServiceInterface` |
+| Implementation | `UserService : IUserService` | `UserService` (no interface) |
+
+### Namespaces (`checks: ["namespaces"]`)
+
+| Layer | Expected Namespace |
+|-------|-------------------|
+| Domain | `SmartStack.Domain.*` |
+| Application | `SmartStack.Application.*` |
+| Infrastructure | `SmartStack.Infrastructure.*` |
+| Api | `SmartStack.Api.*` |
+
+---
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--fix` | Auto-fix simple issues (rename suggestions) |
+| `--json` | Output raw MCP JSON response |
+| `--strict` | Treat warnings as errors |
+
+---
+
+## CI/CD Integration
+
+```yaml
+# GitHub Actions
+- name: Validate SmartStack conventions
+  run: |
+    OUTPUT=$(claude-code "/validate --json")
+    VALID=$(echo $OUTPUT | jq '.valid')
+    if [ "$VALID" != "true" ]; then
+      echo "::error::SmartStack convention violations detected"
+      exit 1
+    fi
+```
+
+---
+
+## Pre-Commit Hook Integration
+
+Add to `.claude/hooks/PreToolUse`:
+
+```json
+{
+  "matcher": "Edit|Write",
+  "hooks": [{
+    "type": "command",
+    "command": "claude-code /validate:quick"
+  }]
+}
+```
+
+---
+
+## MCP Tool Reference
+
+**Tool:** `mcp__smartstack__validate_conventions`
+
+**Description:** Validate AtlasHub/SmartStack conventions: SQL schemas (core/extensions), domain table prefixes (auth_, nav_, ai_, etc.), migration naming ({context}_v{version}_{sequence}_*), service interfaces (I*Service), namespace structure
+
+**Parameters:**
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `path` | string | Project path (default: auto-detect) |
+| `checks` | string[] | Types of checks: `tables`, `migrations`, `services`, `namespaces`, `all` |
+
+---
+
+## Why MCP Integration?
+
+1. **Centralized Rules:** Convention rules defined once in MCP config
+2. **Consistency:** Same validation in CLI, CI/CD, and IDE
+3. **Extensibility:** Add new checks in MCP, available everywhere
+4. **Structured Output:** Typed responses for automation

package/templates/commands/workflow.md

@@ -1,193 +1,193 @@
-# /workflow - Gestion Workflows SmartStack
-
-> **Synergie Skill/Commande:**
-> - **Skill** (`templates/skills/workflow/`) → Invocation automatique par Claude
-> - **Commande** (`/workflow`) → Invocation manuelle par l'utilisateur
-
----
-
-## ARGUMENTS
-
-```
-/workflow <action> [options]
-```
-
-| Action | Description |
-|--------|-------------|
-| `create` | Creer un nouveau workflow complet |
-| `trigger` | Ajouter un nouveau trigger |
-| `step` | Ajouter un step a un workflow existant |
-| `template` | Creer un email template |
-
----
-
-## WORKFLOW
-
-### /workflow create
-
-Cree un workflow complet avec trigger et steps.
-
-**Questions:**
-1. Code du workflow ? (kebab-case)
-2. Nom descriptif ?
-3. Quel trigger ? (existant ou nouveau)
-4. Quels steps ? (Email, Wait, Condition, Webhook)
-5. Systeme ? (oui/non)
-6. Priorite ? (1-100, defaut 10)
-
-**Actions:**
-1. Creer/utiliser le trigger
-2. Ajouter le workflow dans WorkflowConfiguration.cs seed
-3. Ajouter les steps dans WorkflowStepConfiguration.cs seed
-4. Creer les email templates si necessaire
-5. Creer migration EF Core
-
-### /workflow trigger
-
-Ajoute un nouveau trigger.
-
-**Questions:**
-1. Code du trigger ? (format: entity.event)
-2. Nom descriptif ?
-3. Variables disponibles ?
-
-**Actions:**
-1. Ajouter dans WorkflowTriggerConfiguration.cs seed
-2. Creer migration EF Core
-
-### /workflow step
-
-Ajoute un step a un workflow existant.
-
-**Questions:**
-1. Quel workflow ?
-2. Type de step ? (SendEmail, Wait, Condition, Webhook)
-3. Configuration specifique selon le type
-
-**Actions:**
-1. Ajouter dans WorkflowStepConfiguration.cs seed
-2. Mettre a jour l'ordre des steps
-3. Creer migration EF Core
-
-### /workflow template
-
-Cree un email template.
-
-**Questions:**
-1. Code du template ?
-2. Nom ?
-3. Categorie ? (Transactional, Marketing, System)
-4. Langues ? (fr, en, it, de)
-
-**Actions:**
-1. Ajouter dans EmailTemplateConfiguration.cs seed
-2. Ajouter les translations
-3. Creer migration EF Core
-
----
-
-## TEMPLATES
-
-### Template Trigger Seed
-
-```csharp
-new
-{
-    Id = Guid.Parse("$TRIGGER_GUID"),
-    Code = "$ENTITY.$EVENT",
-    Name = "$NAME",
-    Description = "$DESCRIPTION",
-    TriggerType = "$TRIGGER_TYPE",
-    AvailableVariablesJson = JsonSerializer.Serialize(new[]
-    {
-        new { Name = "entityId", Type = "Guid", Description = "Entity ID" },
-        new { Name = "entityName", Type = "string", Description = "Entity name" },
-        new { Name = "userEmail", Type = "string", Description = "User email" },
-    }),
-    IsActive = true,
-    CreatedAt = seedDate
-},
-```
-
-### Template Workflow Seed
-
-```csharp
-new
-{
-    Id = Guid.Parse("$WORKFLOW_GUID"),
-    Code = "$CODE",
-    Name = "$NAME",
-    Description = "$DESCRIPTION",
-    TriggerId = Guid.Parse("$TRIGGER_GUID"),
-    ApplicationId = (Guid?)null,
-    IsActive = true,
-    IsSystem = $IS_SYSTEM,
-    Priority = $PRIORITY,
-    CreatedAt = seedDate
-},
-```
-
-### Template Step Seed (Email)
-
-```csharp
-new
-{
-    Id = Guid.Parse("$STEP_GUID"),
-    WorkflowId = Guid.Parse("$WORKFLOW_GUID"),
-    Name = "$NAME",
-    StepType = WorkflowStepType.SendEmail,
-    StepOrder = $ORDER,
-    EmailTemplateId = Guid.Parse("$TEMPLATE_GUID"),
-    IsActive = true,
-    CreatedAt = seedDate
-},
-```
-
-### Template Step Seed (Wait)
-
-```csharp
-new
-{
-    Id = Guid.Parse("$STEP_GUID"),
-    WorkflowId = Guid.Parse("$WORKFLOW_GUID"),
-    Name = "$NAME",
-    StepType = WorkflowStepType.Wait,
-    StepOrder = $ORDER,
-    DelayMinutes = $DELAY_MINUTES,
-    IsActive = true,
-    CreatedAt = seedDate
-},
-```
-
-### Template Declenchement
-
-```csharp
-await _workflowService.TriggerAsync(
-    "$TRIGGER_CODE",
-    new Dictionary<string, object>
-    {
-        ["entityId"] = entity.Id,
-        ["entityName"] = entity.Name,
-        ["userEmail"] = _currentUser.Email
-    },
-    language: "fr",
-    cancellationToken: ct);
-```
-
----
-
-## FICHIERS CLES
-
-| Fichier | Role |
-|---------|------|
-| `Domain/Communications/Workflow.cs` | Entite workflow |
-| `Domain/Communications/WorkflowStep.cs` | Entite step |
-| `Domain/Communications/WorkflowTrigger.cs` | Entite trigger |
-| `Infrastructure/.../WorkflowConfiguration.cs` | Seed workflows |
-| `Infrastructure/.../WorkflowTriggerConfiguration.cs` | Seed triggers |
-| `Infrastructure/.../WorkflowStepConfiguration.cs` | Seed steps |
-| `Infrastructure/Services/Workflow/WorkflowExecutionService.cs` | Execution |
-
----
-
-User: $ARGUMENTS
+# /workflow - Gestion Workflows SmartStack
+
+> **Synergie Skill/Commande:**
+> - **Skill** (`templates/skills/workflow/`) → Invocation automatique par Claude
+> - **Commande** (`/workflow`) → Invocation manuelle par l'utilisateur
+
+---
+
+## ARGUMENTS
+
+```
+/workflow <action> [options]
+```
+
+| Action | Description |
+|--------|-------------|
+| `create` | Creer un nouveau workflow complet |
+| `trigger` | Ajouter un nouveau trigger |
+| `step` | Ajouter un step a un workflow existant |
+| `template` | Creer un email template |
+
+---
+
+## WORKFLOW
+
+### /workflow create
+
+Cree un workflow complet avec trigger et steps.
+
+**Questions:**
+1. Code du workflow ? (kebab-case)
+2. Nom descriptif ?
+3. Quel trigger ? (existant ou nouveau)
+4. Quels steps ? (Email, Wait, Condition, Webhook)
+5. Systeme ? (oui/non)
+6. Priorite ? (1-100, defaut 10)
+
+**Actions:**
+1. Creer/utiliser le trigger
+2. Ajouter le workflow dans WorkflowConfiguration.cs seed
+3. Ajouter les steps dans WorkflowStepConfiguration.cs seed
+4. Creer les email templates si necessaire
+5. Creer migration EF Core
+
+### /workflow trigger
+
+Ajoute un nouveau trigger.
+
+**Questions:**
+1. Code du trigger ? (format: entity.event)
+2. Nom descriptif ?
+3. Variables disponibles ?
+
+**Actions:**
+1. Ajouter dans WorkflowTriggerConfiguration.cs seed
+2. Creer migration EF Core
+
+### /workflow step
+
+Ajoute un step a un workflow existant.
+
+**Questions:**
+1. Quel workflow ?
+2. Type de step ? (SendEmail, Wait, Condition, Webhook)
+3. Configuration specifique selon le type
+
+**Actions:**
+1. Ajouter dans WorkflowStepConfiguration.cs seed
+2. Mettre a jour l'ordre des steps
+3. Creer migration EF Core
+
+### /workflow template
+
+Cree un email template.
+
+**Questions:**
+1. Code du template ?
+2. Nom ?
+3. Categorie ? (Transactional, Marketing, System)
+4. Langues ? (fr, en, it, de)
+
+**Actions:**
+1. Ajouter dans EmailTemplateConfiguration.cs seed
+2. Ajouter les translations
+3. Creer migration EF Core
+
+---
+
+## TEMPLATES
+
+### Template Trigger Seed
+
+```csharp
+new
+{
+    Id = Guid.Parse("$TRIGGER_GUID"),
+    Code = "$ENTITY.$EVENT",
+    Name = "$NAME",
+    Description = "$DESCRIPTION",
+    TriggerType = "$TRIGGER_TYPE",
+    AvailableVariablesJson = JsonSerializer.Serialize(new[]
+    {
+        new { Name = "entityId", Type = "Guid", Description = "Entity ID" },
+        new { Name = "entityName", Type = "string", Description = "Entity name" },
+        new { Name = "userEmail", Type = "string", Description = "User email" },
+    }),
+    IsActive = true,
+    CreatedAt = seedDate
+},
+```
+
+### Template Workflow Seed
+
+```csharp
+new
+{
+    Id = Guid.Parse("$WORKFLOW_GUID"),
+    Code = "$CODE",
+    Name = "$NAME",
+    Description = "$DESCRIPTION",
+    TriggerId = Guid.Parse("$TRIGGER_GUID"),
+    ApplicationId = (Guid?)null,
+    IsActive = true,
+    IsSystem = $IS_SYSTEM,
+    Priority = $PRIORITY,
+    CreatedAt = seedDate
+},
+```
+
+### Template Step Seed (Email)
+
+```csharp
+new
+{
+    Id = Guid.Parse("$STEP_GUID"),
+    WorkflowId = Guid.Parse("$WORKFLOW_GUID"),
+    Name = "$NAME",
+    StepType = WorkflowStepType.SendEmail,
+    StepOrder = $ORDER,
+    EmailTemplateId = Guid.Parse("$TEMPLATE_GUID"),
+    IsActive = true,
+    CreatedAt = seedDate
+},
+```
+
+### Template Step Seed (Wait)
+
+```csharp
+new
+{
+    Id = Guid.Parse("$STEP_GUID"),
+    WorkflowId = Guid.Parse("$WORKFLOW_GUID"),
+    Name = "$NAME",
+    StepType = WorkflowStepType.Wait,
+    StepOrder = $ORDER,
+    DelayMinutes = $DELAY_MINUTES,
+    IsActive = true,
+    CreatedAt = seedDate
+},
+```
+
+### Template Declenchement
+
+```csharp
+await _workflowService.TriggerAsync(
+    "$TRIGGER_CODE",
+    new Dictionary<string, object>
+    {
+        ["entityId"] = entity.Id,
+        ["entityName"] = entity.Name,
+        ["userEmail"] = _currentUser.Email
+    },
+    language: "fr",
+    cancellationToken: ct);
+```
+
+---
+
+## FICHIERS CLES
+
+| Fichier | Role |
+|---------|------|
+| `Domain/Communications/Workflow.cs` | Entite workflow |
+| `Domain/Communications/WorkflowStep.cs` | Entite step |
+| `Domain/Communications/WorkflowTrigger.cs` | Entite trigger |
+| `Infrastructure/.../WorkflowConfiguration.cs` | Seed workflows |
+| `Infrastructure/.../WorkflowTriggerConfiguration.cs` | Seed triggers |
+| `Infrastructure/.../WorkflowStepConfiguration.cs` | Seed steps |
+| `Infrastructure/Services/Workflow/WorkflowExecutionService.cs` | Execution |
+
+---
+
+User: $ARGUMENTS