@atlashub/smartstack-cli 1.13.1 → 1.14.0

package/templates/project/IExtensionsDbContext.cs.template

@@ -0,0 +1,22 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace {{ProjectName}}.Application.Common.Interfaces;
+
+/// <summary>
+/// Interface for Extensions DbContext (client-specific entities).
+///
+/// This interface provides access to all entities specific to your project.
+/// For Core entities (User, Role, Permission, etc.), use ICoreDataService.
+/// </summary>
+public interface IExtensionsDbContext
+{
+    // === YOUR ENTITIES ===
+    // Add DbSet properties for your entities here. Example:
+    // DbSet<Order> Orders { get; }
+    // DbSet<Product> Products { get; }
+
+    /// <summary>
+    /// Saves all changes made in this context to the database.
+    /// </summary>
+    Task<int> SaveChangesAsync(CancellationToken cancellationToken = default);
+}

package/templates/project/Program.cs.template

@@ -0,0 +1,47 @@
+using Microsoft.EntityFrameworkCore;
+using SmartStack.Api.Extensions;
+using {{ProjectName}}.Infrastructure;
+using {{ProjectName}}.Infrastructure.Persistence;
+using {{ProjectName}}.Application;
+
+var builder = WebApplication.CreateBuilder(args);
+
+// ===================================================================
+// 1. Add SmartStack Core services (from NuGet package)
+// ===================================================================
+builder.Services.AddSmartStack(builder.Configuration, options =>
+{
+    options.EnableDevSeeding = builder.Environment.IsDevelopment();
+    options.EnableSwagger = builder.Environment.IsDevelopment();
+});
+
+// ===================================================================
+// 2. Add client-specific services (Dual-DbContext pattern)
+// ===================================================================
+builder.Services.Add{{ProjectName}}Infrastructure(builder.Configuration);
+builder.Services.Add{{ProjectName}}Application();
+
+var app = builder.Build();
+
+// ===================================================================
+// 3. Initialize SmartStack + apply migrations (in correct order!)
+// ===================================================================
+// This initializes SmartStack and applies Core migrations automatically
+await app.InitializeSmartStackAsync();
+
+// Apply Extensions migrations AFTER Core migrations
+// Your client-specific tables may have FK references to Core tables
+if (app.Environment.IsDevelopment())
+{
+    using var scope = app.Services.CreateScope();
+    var extDb = scope.ServiceProvider.GetRequiredService<ExtensionsDbContext>();
+    await extDb.Database.MigrateAsync();
+}
+
+// ===================================================================
+// 4. SmartStack middleware & endpoints
+// ===================================================================
+app.UseSmartStack();
+app.MapSmartStack();
+
+app.Run();

package/templates/project/README.md

@@ -0,0 +1,79 @@
+# SmartStack Client Project Templates
+
+These templates are used by the SmartStack CLI to generate new client projects.
+
+## Template Files
+
+| File | Description | Destination |
+|------|-------------|-------------|
+| `ExtensionsDbContext.cs.template` | DbContext for client entities | `{ProjectName}.Infrastructure/Persistence/` |
+| `IExtensionsDbContext.cs.template` | Interface for ExtensionsDbContext | `{ProjectName}.Application/Common/Interfaces/` |
+| `DependencyInjection.Infrastructure.cs.template` | DI configuration for Infrastructure | `{ProjectName}.Infrastructure/` |
+| `Program.cs.template` | API entry point with migration order | `{ProjectName}.Api/` |
+| `DesignTimeExtensionsDbContextFactory.cs.template` | Factory for EF Core CLI tools | `{ProjectName}.Infrastructure/Persistence/` |
+| `ExampleEntity.cs.template` | Example entity with FK to Core | `{ProjectName}.Domain/Entities/` (optional) |
+| `ExampleService.cs.template` | Example service using ICoreDataService | `{ProjectName}.Infrastructure/Services/` (optional) |
+| `ExampleEntityConfiguration.cs.template` | Example EF Core configuration | `{ProjectName}.Infrastructure/Persistence/Configurations/` (optional) |
+
+## Placeholders
+
+The following placeholders are replaced during project generation:
+
+| Placeholder | Description | Example |
+|-------------|-------------|---------|
+| `{{ProjectName}}` | PascalCase project name | `MyCompany` |
+
+## Architecture Overview
+
+### Dual DbContext Pattern
+
+SmartStack uses two separate DbContexts:
+
+1. **CoreDbContext** (from SmartStack NuGet package)
+   - Schema: `core`
+   - Manages: Users, Roles, Permissions, Navigation, etc.
+   - Migrations: `core.__EFMigrationsHistory`
+
+2. **ExtensionsDbContext** (client project)
+   - Schema: `extensions`
+   - Manages: Client-specific entities
+   - Migrations: `extensions.__EFMigrationsHistory`
+
+### FK References to Core Entities
+
+When your entities need to reference Core entities (User, Role, etc.):
+
+```csharp
+// IN YOUR ENTITY - Store GUID only
+public Guid CustomerId { get; private set; }  // FK to User
+
+// IN YOUR SERVICE - Use ICoreDataService
+var user = await _coreDataService.GetUserByIdAsync(entity.CustomerId);
+```
+
+**DO NOT** create navigation properties to Core entities, as ExtensionsDbContext doesn't know about them.
+
+### Migration Order
+
+Migrations must be applied in order:
+
+1. Core migrations first (SmartStack platform tables)
+2. Extensions migrations second (client tables that may reference Core)
+
+This is handled automatically in `Program.cs.template`.
+
+## Usage
+
+```bash
+# Create new project
+smartstack init MyProject
+
+# Add entity to Extensions
+smartstack scaffold entity Order --context extensions
+
+# Create migration
+dotnet ef migrations add ext_v1.0.0_001_AddOrders --context ExtensionsDbContext
+
+# Apply migrations
+dotnet ef database update
+```

package/templates/ralph/README.md

@@ -27,15 +27,17 @@ Edit `ralph.config.yaml` to customize:
 
 Ralph **requires** these MCP servers to function:
 
-1. **context7** - Library documentation
-   ```bash
-   claude mcp add context7
-   ```
+### 1. Download MCP packages
+```bash
+npm install -g @atlashub/smartstack-mcp
+npm install -g @upstash/context7-mcp
+```
 
-2. **smartstack** - Validation and scaffolding
-   ```bash
-   claude mcp add smartstack
-   ```
+### 2. Register in Claude Code
+```bash
+claude mcp add smartstack -- npx @atlashub/smartstack-mcp
+claude mcp add context7 -- npx @upstash/context7-mcp
+```
 
 ## Usage
 

package/templates/ralph/ralph.config.yaml

@@ -9,12 +9,12 @@ mcp:
   required:
     - name: context7
       description: "Library documentation and code examples"
-      install_command: "claude mcp add context7"
+      install_command: "npm install -g @upstash/context7-mcp && claude mcp add context7 -- npx @upstash/context7-mcp"
       health_check: true
 
     - name: smartstack
       description: "SmartStack validation and scaffolding"
-      install_command: "claude mcp add smartstack"
+      install_command: "npm install -g @atlashub/smartstack-mcp && claude mcp add smartstack -- npx @atlashub/smartstack-mcp"
       health_check: true
 
   # Behavior when MCP is unavailable

package/templates/skills/_shared.md

@@ -1,29 +1,29 @@
-# Skills SmartStack - Fonctions Partagées
+# Skills SmartStack - Shared Functions
 
-## Stratégie Modèles
+## Model Strategy
 
-| Tâche | Modèle | Raison |
-|-------|--------|--------|
-| Génération code | **Sonnet** | Rapport qualité/coût optimal |
-| Audit sécurité | **Opus** | Analyse critique requise |
-| Validation finale | **Opus** | Décisions architecturales |
+| Task | Model | Reason |
+|------|-------|--------|
+| Code generation | **Sonnet** | Optimal quality/cost ratio |
+| Security audit | **Opus** | Critical analysis required |
+| Final validation | **Opus** | Architectural decisions |
 
-## Architecture SmartStack
+## SmartStack Architecture
 
 ```
 Domain → Application → Infrastructure → API → Web
 ```
 
 ### Layers
-| Layer | Responsabilité | Namespace |
-|-------|---------------|-----------|
-| Domain | Entités, ValueObjects | `SmartStack.Domain.{Context}` |
+| Layer | Responsibility | Namespace |
+|-------|-----------------|-----------|
+| Domain | Entities, ValueObjects | `SmartStack.Domain.{Context}` |
 | Application | Services, DTOs, Interfaces | `SmartStack.Application.{Context}` |
-| Infrastructure | Implémentations, EF Core | `SmartStack.Infrastructure.{Context}` |
+| Infrastructure | Implementations, EF Core | `SmartStack.Infrastructure.{Context}` |
 | API | Controllers, Middleware | `SmartStack.Api.Controllers.{Area}` |
 | Web | React components, pages | `src/pages/{context}/{app}/{module}` |
 
-## Permissions (2 fichiers obligatoires)
+## Permissions (2 mandatory files)
 
 ### 1. Permissions.cs (Application layer)
 ```csharp
@@ -45,16 +45,16 @@ builder.HasData(
 );
 ```
 
-## i18n (4 langues obligatoires)
+## i18n (4 mandatory languages)
 
-| Langue | Fichier | Code |
-|--------|---------|------|
-| Français | `fr.json` | `fr` |
+| Language | File | Code |
+|----------|------|------|
+| French | `fr.json` | `fr` |
 | English | `en.json` | `en` |
-| Italiano | `it.json` | `it` |
-| Deutsch | `de.json` | `de` |
+| Italian | `it.json` | `it` |
+| German | `de.json` | `de` |
 
-### Structure i18n
+### i18n Structure
 ```json
 {
   "{context}": {
@@ -70,48 +70,48 @@ builder.HasData(
 }
 ```
 
-## Services Communs à Injecter
+## Common Services to Inject
 
 | Service | Usage |
 |---------|-------|
-| `IApplicationDbContext` | Accès DB |
-| `ICurrentUserService` | User courant |
+| `IApplicationDbContext` | DB access |
+| `ICurrentUserService` | Current user |
 | `ILogger<T>` | Logging |
 | `IMapper` | AutoMapper |
-| `IPermissionService` | Cache permissions |
+| `IPermissionService` | Permission cache |
 
-## Validation Sécurité
+## Security Validation
 
-### Logs Critiques
-| Événement | Niveau |
-|-----------|--------|
-| Login échoué | `Critical` |
-| Permission refusée | `Critical` |
-| Compte verrouillé | `Critical` |
+### Critical Logs
+| Event | Level |
+|-------|-------|
+| Failed login | `Critical` |
+| Permission denied | `Critical` |
+| Account locked | `Critical` |
 | Password change | `Warning` |
-| Suppression | `Warning` |
+| Deletion | `Warning` |
 
-### Protection Comptes Système
+### System Account Protection
 ```csharp
 if (entity.UserType == UserType.System || entity.UserType == UserType.LocalAdmin)
     return BadRequest(new { message = "Cannot modify system accounts" });
 ```
 
-## Checklist Validation Commune
+## Common Validation Checklist
 
 ```
-□ Permissions créées (Permissions.cs + PermissionConfiguration.cs)
-□ Migration EF Core créée
-□ i18n 4 langues (fr, en, it, de)
-□ Tests unitaires
-□ Documentation API (ProducesResponseType)
+□ Permissions created (Permissions.cs + PermissionConfiguration.cs)
+□ EF Core migration created
+□ i18n 4 languages (fr, en, it, de)
+□ Unit tests
+□ API documentation (ProducesResponseType)
 ```
 
-## Références MCP Tools
+## MCP Tools References
 
 | Tool | Usage |
 |------|-------|
-| `mcp__smartstack__validate_conventions` | Validation conventions |
-| `mcp__smartstack__scaffold_extension` | Génération code |
-| `mcp__smartstack__check_migrations` | Vérification migrations |
-| `mcp__smartstack__scaffold_tests` | Génération tests |
+| `mcp__smartstack__validate_conventions` | Validate conventions |
+| `mcp__smartstack__scaffold_extension` | Code generation |
+| `mcp__smartstack__check_migrations` | Check migrations |
+| `mcp__smartstack__scaffold_tests` | Generate tests |

package/templates/skills/ai-prompt/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: ai-prompt
 description: |
-  Integre les capacites IA dans les features SmartStack.
-  Utiliser ce skill quand:
-  - L'utilisateur veut integrer l'IA dans une fonctionnalite
-  - L'utilisateur mentionne "prompt", "GPT", "Claude", "IA", "AI"
-  - Creation d'un assistant ou chatbot
-  - Generation de contenu automatique
-  - Validation de reponses IA avec schema
+  Integrates AI capabilities into SmartStack features.
+  Use this skill when:
+  - User wants to integrate AI into a feature
+  - User mentions "prompt", "GPT", "Claude", "IA", "AI"
+  - Creating an assistant or chatbot
+  - Automatic content generation
+  - AI response validation with schema
   Types: Prompt, OutputSchema, Provider, Model
 ---
 
@@ -16,19 +16,19 @@ description: |
 > **Architecture:** Prompt + Blocks → Provider + Model → Completion → Schema Validation
 > Multi-provider: OpenAI, Anthropic (Claude), Azure OpenAI, Google Gemini
 
-**Référence:** [_shared.md](../_shared.md) pour patterns communs
+**Reference:** [_shared.md](../_shared.md) for common patterns
 
-## QUAND CE SKILL S'ACTIVE
+## WHEN THIS SKILL ACTIVATES
 
-| Declencheur | Exemple |
-|-------------|---------|
-| Demande explicite | "Integre GPT pour generer des descriptions" |
-| Chatbot/Assistant | "Cree un assistant pour le support" |
-| Generation contenu | "Genere automatiquement des reponses" |
-| Analyse texte | "Analyse le sentiment des commentaires" |
-| Mots-cles | "prompt", "GPT", "Claude", "IA", "completion", "LLM" |
+| Trigger | Example |
+|---------|---------|
+| Explicit request | "Integrate GPT to generate descriptions" |
+| Chatbot/Assistant | "Create an assistant for support" |
+| Content generation | "Auto-generate responses" |
+| Text analysis | "Analyze the sentiment of comments" |
+| Keywords | "prompt", "GPT", "Claude", "IA", "completion", "LLM" |
 
-## FLOW IA
+## AI FLOW
 
 ```
 Feature → IAiCompletionService.ExecutePromptAsync()
@@ -38,7 +38,7 @@ Prompt + Blocks → Provider Instance → External API (OpenAI/Claude/Azure/Gemi
 AI Response → OutputSchema Validation → Typed Result<T>
 ```
 
-## ENTITES PRINCIPALES
+## MAIN ENTITIES
 
 ### AiProvider & AiModel
 - **Providers:** OpenAI, Anthropic, Azure OpenAI, Google
@@ -46,7 +46,7 @@ AI Response → OutputSchema Validation → Typed Result<T>
 - Properties: Code, ContextWindow, MaxOutputTokens, InputCost, OutputCost, SupportsVision, SupportsStreaming
 
 ### AiProviderInstance
-Instance configurée: Code, Name, SystemContext, DefaultModel, MonthlyBudgetLimit, EncryptedApiKey
+Configured instance: Code, Name, SystemContext, DefaultModel, MonthlyBudgetLimit, EncryptedApiKey
 
 ### Prompt & PromptBlock
 ```csharp
@@ -56,20 +56,20 @@ Instance configurée: Code, Name, SystemContext, DefaultModel, MonthlyBudgetLimi
 ```
 
 ### OutputSchema
-JSON Schema pour validation: Code, Name, JsonSchema, DotNetType
+JSON Schema for validation: Code, Name, JsonSchema, DotNetType
 
 ## WORKFLOW INTEGRATION
 
-### 1. Definir le Use Case
+### 1. Define the Use Case
 | Question | Impact |
 |----------|--------|
-| Type de contenu ? | Choix modele |
-| Reponse structuree ? | OutputSchema |
-| Multi-langue ? | Variables langue |
-| Budget limite ? | ProviderInstance |
-| Temps reel ? | Streaming |
+| Content type? | Model choice |
+| Structured response? | OutputSchema |
+| Multi-language? | Language variables |
+| Budget limited? | ProviderInstance |
+| Real-time? | Streaming |
 
-### 2. Creer le Prompt
+### 2. Create the Prompt
 ```csharp
 var promptId = await _promptService.CreatePromptAsync(new CreatePromptRequest
 {
@@ -90,7 +90,7 @@ var promptId = await _promptService.CreatePromptAsync(new CreatePromptRequest
 });
 ```
 
-### 3. Definir OutputSchema (si reponse structuree)
+### 3. Define OutputSchema (if structured response)
 ```csharp
 var schemaId = await _schemaService.CreateAsync(new CreateSchemaRequest
 {
@@ -100,22 +100,22 @@ var schemaId = await _schemaService.CreateAsync(new CreateSchemaRequest
 });
 ```
 
-### 4. Executer le Prompt
+### 4. Execute the Prompt
 ```csharp
-// Execution simple
+// Simple execution
 var result = await _aiService.ExecutePromptAsync(promptId, new Dictionary<string, object>
 {
     ["ticketTitle"] = ticket.Title,
     ["ticketDescription"] = ticket.Description
 });
 
-// Avec validation typee
+// With typed validation
 var typedResult = await _aiService.ExecutePromptWithValidationAsync<TicketAnalysisResult>(
     promptId, variables);
 if (typedResult.Success && typedResult.IsValid) { /* use typedResult.Data */ }
 ```
 
-## SERVICES IA
+## AI SERVICES
 
 ### IAiCompletionService
 ```csharp
@@ -151,17 +151,17 @@ const { execute, loading, error, result } = useAiCompletion<T>(promptCode);
 const data = await execute(variables);
 ```
 
-### Composant AiAssistantButton
+### Component AiAssistantButton
 ```tsx
 <AiAssistantButton
   promptCode="ticket-analyzer"
   variables={{ ticketTitle, ticketDescription }}
   onResult={(result) => handleAnalysis(result)}
-  label="Analyser avec IA"
+  label="Analyze with AI"
 />
 ```
 
-## PATTERNS AVANCES
+## ADVANCED PATTERNS
 
 ### Streaming Response
 ```typescript
@@ -180,32 +180,32 @@ foreach (var provider in providers.OrderBy(p => p.Priority)) {
 ## CHECKLIST
 
 ```
-□ Prompt cree (Code unique, Blocks, Variables, Version)
-□ OutputSchema si reponse structuree
-□ Service avec IAiCompletionService injecte
-□ Gestion erreurs + Logging (tokens, temps)
-□ Frontend: Hook/composant, Loading, Error handling
-□ ProviderInstance avec limite budget
-□ Tests: execution, variables, validation schema
+□ Prompt created (unique Code, Blocks, Variables, Version)
+□ OutputSchema if structured response
+□ Service with IAiCompletionService injected
+□ Error handling + Logging (tokens, time)
+□ Frontend: Hook/component, Loading, Error handling
+□ ProviderInstance with budget limit
+□ Tests: execution, variables, schema validation
 ```
 
-## REGLES ABSOLUES
+## ABSOLUTE RULES
 
 | DO | DON'T |
 |----|-------|
-| IAiCompletionService pour executions | Appels API directs |
-| OutputSchema pour reponses structurees | Reponses non validees |
-| Gestion erreurs (API down, quota) | Ignorer les limites tokens |
-| Logger executions (tokens, duree) | Hardcoder cles API |
-| Variables pour contenu dynamique | Exposer prompts systeme au frontend |
+| IAiCompletionService for executions | Direct API calls |
+| OutputSchema for structured responses | Unvalidated responses |
+| Error handling (API down, quota) | Ignore token limits |
+| Log executions (tokens, duration) | Hardcode API keys |
+| Variables for dynamic content | Expose system prompts to frontend |
 
-## FICHIERS CLES
+## KEY FILES
 
-| Fichier | Role |
-|---------|------|
-| `Domain/AI/Prompts/Prompt.cs` | Entite prompt |
+| File | Role |
+|------|------|
+| `Domain/AI/Prompts/Prompt.cs` | Prompt entity |
 | `Domain/AI/Schemas/OutputSchema.cs` | Schema validation |
-| `Domain/AI/AiProviderInstance.cs` | Instance configuree |
-| `Application/Common/Interfaces/IAiCompletionService.cs` | Interface service |
+| `Domain/AI/AiProviderInstance.cs` | Configured instance |
+| `Application/Common/Interfaces/IAiCompletionService.cs` | Service interface |
 | `Infrastructure/Services/AI/AiCompletionService.cs` | Implementation |
-| `web/src/services/api/aiApi.ts` | API frontend |
+| `web/src/services/api/aiApi.ts` | Frontend API |