@atlashub/smartstack-cli 3.39.0 → 3.41.0

package/templates/skills/application/references/backend-entity-seeding.md

@@ -1,72 +1,72 @@
-# Entity Seeding Pattern
-
-> Reference: See `templates-seed.md` section "TEMPLATE: ENTITY SEED DATA (SeedData Provider)"
-
-## SeedData File
-
-**`Infrastructure/Persistence/Seeding/Data/{Domain}/{EntityName}SeedData.cs`**
-
-Follow SmartStack.app pattern:
-- Static class with `internal static IEnumerable<{EntityName}SeedItem> GetAll{EntityName}s()`
-- Use deterministic GUIDs (NEVER `Guid.NewGuid()`)
-- Include 3-5 sample entities with varied, realistic data
-- For multi-tenant: organize by tenant using `GetTenant1{EntityName}s()` helpers
-
-```csharp
-public static class {EntityName}SeedData
-{
-    public static readonly Guid Sample1Id = Guid.Parse("...");
-    public static readonly Guid Sample2Id = Guid.Parse("...");
-    public static readonly Guid Sample3Id = Guid.Parse("...");
-
-    internal static IEnumerable<{EntityName}SeedItem> GetAll{EntityName}s()
-    {
-        return new[]
-        {
-            new {EntityName}SeedItem { Id = Sample1Id, /* ... */ },
-            new {EntityName}SeedItem { Id = Sample2Id, /* ... */ },
-            new {EntityName}SeedItem { Id = Sample3Id, /* ... */ }
-        };
-    }
-}
-
-internal class {EntityName}SeedItem
-{
-    public Guid Id { get; init; }
-    // ... all required entity properties
-}
-```
-
-## DevDataSeeder Update
-
-Add to `Infrastructure/Persistence/Seeding/DevDataSeeder.cs`:
-- `using` for the new SeedData namespace
-- `await Seed{EntityName}sAsync(cancellationToken);` in `SeedAsync()` method
-
-```csharp
-private async Task Seed{EntityName}sAsync(CancellationToken cancellationToken)
-{
-    _logger.LogInformation("Seeding demo {EntityName}s...");
-
-    var existingCount = await _context.{EntityName}s.CountAsync(cancellationToken);
-    if (existingCount > 0)
-    {
-        _logger.LogWarning("{EntityName}s already seeded ({Count} exist), skipping.", existingCount);
-        return;
-    }
-
-    var createdCount = 0;
-    foreach (var seedItem in {EntityName}SeedData.GetAll{EntityName}s())
-    {
-        var entity = {EntityName}.Create(/* map seedItem properties */);
-        typeof({EntityName}).GetProperty("Id")?.SetValue(entity, seedItem.Id);
-        _context.{EntityName}s.Add(entity);
-        createdCount++;
-    }
-
-    if (createdCount > 0)
-        await _context.SaveChangesAsync(cancellationToken);
-
-    _logger.LogInformation("Created {Count} demo {EntityName}s.", createdCount);
-}
-```
+# Entity Seeding Pattern
+
+> Reference: See `templates-seed.md` section "TEMPLATE: ENTITY SEED DATA (SeedData Provider)"
+
+## SeedData File
+
+**`Infrastructure/Persistence/Seeding/Data/{Domain}/{EntityName}SeedData.cs`**
+
+Follow SmartStack.app pattern:
+- Static class with `internal static IEnumerable<{EntityName}SeedItem> GetAll{EntityName}s()`
+- Use deterministic GUIDs (NEVER `Guid.NewGuid()`)
+- Include 3-5 sample entities with varied, realistic data
+- For multi-tenant: organize by tenant using `GetTenant1{EntityName}s()` helpers
+
+```csharp
+public static class {EntityName}SeedData
+{
+    public static readonly Guid Sample1Id = Guid.Parse("...");
+    public static readonly Guid Sample2Id = Guid.Parse("...");
+    public static readonly Guid Sample3Id = Guid.Parse("...");
+
+    internal static IEnumerable<{EntityName}SeedItem> GetAll{EntityName}s()
+    {
+        return new[]
+        {
+            new {EntityName}SeedItem { Id = Sample1Id, /* ... */ },
+            new {EntityName}SeedItem { Id = Sample2Id, /* ... */ },
+            new {EntityName}SeedItem { Id = Sample3Id, /* ... */ }
+        };
+    }
+}
+
+internal class {EntityName}SeedItem
+{
+    public Guid Id { get; init; }
+    // ... all required entity properties
+}
+```
+
+## DevDataSeeder Update
+
+Add to `Infrastructure/Persistence/Seeding/DevDataSeeder.cs`:
+- `using` for the new SeedData namespace
+- `await Seed{EntityName}sAsync(cancellationToken);` in `SeedAsync()` method
+
+```csharp
+private async Task Seed{EntityName}sAsync(CancellationToken cancellationToken)
+{
+    _logger.LogInformation("Seeding demo {EntityName}s...");
+
+    var existingCount = await _context.{EntityName}s.CountAsync(cancellationToken);
+    if (existingCount > 0)
+    {
+        _logger.LogWarning("{EntityName}s already seeded ({Count} exist), skipping.", existingCount);
+        return;
+    }
+
+    var createdCount = 0;
+    foreach (var seedItem in {EntityName}SeedData.GetAll{EntityName}s())
+    {
+        var entity = {EntityName}.Create(/* map seedItem properties */);
+        typeof({EntityName}).GetProperty("Id")?.SetValue(entity, seedItem.Id);
+        _context.{EntityName}s.Add(entity);
+        createdCount++;
+    }
+
+    if (createdCount > 0)
+        await _context.SaveChangesAsync(cancellationToken);
+
+    _logger.LogInformation("Created {Count} demo {EntityName}s.", createdCount);
+}
+```

package/templates/skills/application/references/backend-seeding-and-dto-output.md

@@ -1,83 +1,83 @@
-# Backend Generation: Entity Seeding & Output Formatting
-
-> Referenced from `steps/step-04-backend.md` — Optional seeding and MCP response handling.
-
----
-
-## Entity Seeding (Optional)
-
-Ask the user if they want to seed initial data for the entity:
-
-```yaml
-questions:
-  - header: "Seed Data"
-    question: "Would you like to generate initial seed data for {EntityName}?"
-    options:
-      - label: "Yes - Generate SeedData provider"
-        description: "Creates {EntityName}SeedData.cs + registers in DevDataSeeder (same pattern as core)"
-      - label: "No - Skip seeding"
-        description: "Entity starts empty (can add seed data later)"
-    multiSelect: false
-```
-
-**If user selects YES:**
-
-See [references/backend-entity-seeding.md](../references/backend-entity-seeding.md) for the full seeding pattern:
-1. **SeedData file** (`{EntityName}SeedData.cs`) — static class with deterministic GUIDs, 3-5 samples
-2. **DevDataSeeder update** — add `Seed{EntityName}sAsync()` method with idempotent check
-
-**If user selects NO:**
-
-Skip this section and proceed to storing entity info.
-
-```markdown
-> Skipping entity seed data. You can generate it later using the SeedData provider pattern
-> documented in templates-seed.md.
-```
-
----
-
-## Presenting Output to User
-
-Display generated backend code organized by layer:
-
-### Domain Layer
-- `Domain/{Application}/{Module}/{EntityName}.cs`
-
-### Infrastructure Layer
-- `Persistence/Configurations/{Application}/{Module}/{EntityName}Configuration.cs`
-- `Services/{Application}/{Module}/{EntityName}Service.cs`
-
-### Application Layer
-- `Common/Interfaces/I{EntityName}Service.cs`
-- `{Application}/{Module}/DTOs/{EntityName}ResponseDto.cs`
-- `{Application}/{Module}/DTOs/Create{EntityName}Dto.cs`
-- `{Application}/{Module}/DTOs/Update{EntityName}Dto.cs`
-
-### API Layer
-- `Controllers/{controller_folder}/{Application}/{EntityName}Controller.cs`
-  - NavRoute: `{full_path}`
-  - Endpoints:
-    - GET /api/{code} - List all
-    - GET /api/{code}/{id} - Get by ID
-    - POST /api/{code} - Create
-    - PUT /api/{code}/{id} - Update
-    - DELETE /api/{code}/{id} - Delete
-
-### Next Steps
-1. Add DbSet to ICoreDbContext: `public DbSet<{EntityName}> {EntityName}s => Set<{EntityName}>();`
-2. Register service in DI: `services.AddScoped<I{EntityName}Service, {EntityName}Service>();`
-3. Run: `dotnet ef migrations add core_vX.X.X_XXX_Add{EntityName}`
-
----
-
-## Entity Info Storage
-
-Store for use in frontend generation:
-
-```
-{entity_name} = "{EntityName}"
-{entity_code} = "{code}"
-{api_route} = "/api/{code}"
-{has_seed_data} = true/false  // Whether SeedData provider was generated
-```
+# Backend Generation: Entity Seeding & Output Formatting
+
+> Referenced from `steps/step-04-backend.md` — Optional seeding and MCP response handling.
+
+---
+
+## Entity Seeding (Optional)
+
+Ask the user if they want to seed initial data for the entity:
+
+```yaml
+questions:
+  - header: "Seed Data"
+    question: "Would you like to generate initial seed data for {EntityName}?"
+    options:
+      - label: "Yes - Generate SeedData provider"
+        description: "Creates {EntityName}SeedData.cs + registers in DevDataSeeder (same pattern as core)"
+      - label: "No - Skip seeding"
+        description: "Entity starts empty (can add seed data later)"
+    multiSelect: false
+```
+
+**If user selects YES:**
+
+See [references/backend-entity-seeding.md](../references/backend-entity-seeding.md) for the full seeding pattern:
+1. **SeedData file** (`{EntityName}SeedData.cs`) — static class with deterministic GUIDs, 3-5 samples
+2. **DevDataSeeder update** — add `Seed{EntityName}sAsync()` method with idempotent check
+
+**If user selects NO:**
+
+Skip this section and proceed to storing entity info.
+
+```markdown
+> Skipping entity seed data. You can generate it later using the SeedData provider pattern
+> documented in templates-seed.md.
+```
+
+---
+
+## Presenting Output to User
+
+Display generated backend code organized by layer:
+
+### Domain Layer
+- `Domain/{Application}/{Module}/{EntityName}.cs`
+
+### Infrastructure Layer
+- `Persistence/Configurations/{Application}/{Module}/{EntityName}Configuration.cs`
+- `Services/{Application}/{Module}/{EntityName}Service.cs`
+
+### Application Layer
+- `Common/Interfaces/I{EntityName}Service.cs`
+- `{Application}/{Module}/DTOs/{EntityName}ResponseDto.cs`
+- `{Application}/{Module}/DTOs/Create{EntityName}Dto.cs`
+- `{Application}/{Module}/DTOs/Update{EntityName}Dto.cs`
+
+### API Layer
+- `Controllers/{controller_folder}/{Application}/{EntityName}Controller.cs`
+  - NavRoute: `{full_path}`
+  - Endpoints:
+    - GET /api/{code} - List all
+    - GET /api/{code}/{id} - Get by ID
+    - POST /api/{code} - Create
+    - PUT /api/{code}/{id} - Update
+    - DELETE /api/{code}/{id} - Delete
+
+### Next Steps
+1. Add DbSet to ICoreDbContext: `public DbSet<{EntityName}> {EntityName}s => Set<{EntityName}>();`
+2. Register service in DI: `services.AddScoped<I{EntityName}Service, {EntityName}Service>();`
+3. Run: `dotnet ef migrations add core_vX.X.X_XXX_Add{EntityName}`
+
+---
+
+## Entity Info Storage
+
+Store for use in frontend generation:
+
+```
+{entity_name} = "{EntityName}"
+{entity_code} = "{code}"
+{api_route} = "/api/{code}"
+{has_seed_data} = true/false  // Whether SeedData provider was generated
+```

package/templates/skills/application/references/backend-table-prefix-mapping.md

@@ -1,79 +1,79 @@
-# Backend: Table Prefix & Controller Folder Mapping
-
-> Referenced from `steps/step-04-backend.md` — Deriving table prefixes and controller organization.
-
----
-
-## Table Prefix Priority
-
-1. **If a `feature.json` exists** with `metadata.tablePrefix` → use that prefix (e.g., `rh_`, `fi_`)
-2. **Otherwise**, derive from navigation context using the fallback table below
-
----
-
-## Fallback Table (when no feature.json tablePrefix)
-
-| Application | Table Prefix | Controller Folder | Example |
-|---------|--------|-------------------|---------|
-| `administration.*` | `auth_` or `cfg_` | `Administration` | Table: `auth_Tenants`, Controller: `Controllers/Administration/TenantsController.cs` |
-| `support.*` | `support_` | `Support` | Table: `support_Tickets`, Controller: `Controllers/Support/TicketsController.cs` |
-| `*` (business apps) | `ref_` or domain-specific | `{ApplicationPascal}` | Table: `ref_Products`, Controller: `Controllers/Sales/ProductsController.cs` |
-| `myspace.*` | `usr_` | `MySpace` | Table: `usr_Preferences`, Controller: `Controllers/MySpace/PreferencesController.cs` |
-
----
-
-## Feature.json Table Prefix Detection
-
-```
-Search for feature.json in:
-  - docs/business/{application}/business-analyse/*/feature.json
-  - Read metadata.tablePrefix if exists
-```
-
-**Example from feature.json:**
-
-```json
-{
-  "metadata": {
-    "tablePrefix": "rh_",
-    "schema": "core"
-  },
-  "analysis": { ... }
-}
-```
-
----
-
-## Implementation
-
-```csharp
-// Check for feature.json tablePrefix
-Search for feature.json in:
-  - docs/business/{application}/business-analyse/*/feature.json
-  - Read metadata.tablePrefix if exists
-
-IF metadata.tablePrefix exists:
-  {prefix} = metadata.tablePrefix   # e.g., "rh_"
-ELSE:
-  {prefix} = derived from context table above
-```
-
-Store: `{controller_folder}` = the Controller Folder from the table above.
-
----
-
-## Usage in MCP Call
-
-When calling `mcp__smartstack__scaffold_extension`:
-
-```
-Tool: mcp__smartstack__scaffold_extension
-Args:
-  type: "feature"
-  name: "{entityName}"
-  options:
-    navRoute: "{full_path}"
-    tablePrefix: "{prefix}"        ← Derived prefix
-    schema: "core"
-    ...
-```
+# Backend: Table Prefix & Controller Folder Mapping
+
+> Referenced from `steps/step-04-backend.md` — Deriving table prefixes and controller organization.
+
+---
+
+## Table Prefix Priority
+
+1. **If a `feature.json` exists** with `metadata.tablePrefix` → use that prefix (e.g., `rh_`, `fi_`)
+2. **Otherwise**, derive from navigation context using the fallback table below
+
+---
+
+## Fallback Table (when no feature.json tablePrefix)
+
+| Application | Table Prefix | Controller Folder | Example |
+|---------|--------|-------------------|---------|
+| `administration.*` | `auth_` or `cfg_` | `Administration` | Table: `auth_Tenants`, Controller: `Controllers/Administration/TenantsController.cs` |
+| `support.*` | `support_` | `Support` | Table: `support_Tickets`, Controller: `Controllers/Support/TicketsController.cs` |
+| `*` (business apps) | `ref_` or domain-specific | `{ApplicationPascal}` | Table: `ref_Products`, Controller: `Controllers/Sales/ProductsController.cs` |
+| `myspace.*` | `usr_` | `MySpace` | Table: `usr_Preferences`, Controller: `Controllers/MySpace/PreferencesController.cs` |
+
+---
+
+## Feature.json Table Prefix Detection
+
+```
+Search for feature.json in:
+  - docs/business/{application}/business-analyse/*/feature.json
+  - Read metadata.tablePrefix if exists
+```
+
+**Example from feature.json:**
+
+```json
+{
+  "metadata": {
+    "tablePrefix": "rh_",
+    "schema": "core"
+  },
+  "analysis": { ... }
+}
+```
+
+---
+
+## Implementation
+
+```csharp
+// Check for feature.json tablePrefix
+Search for feature.json in:
+  - docs/business/{application}/business-analyse/*/feature.json
+  - Read metadata.tablePrefix if exists
+
+IF metadata.tablePrefix exists:
+  {prefix} = metadata.tablePrefix   # e.g., "rh_"
+ELSE:
+  {prefix} = derived from context table above
+```
+
+Store: `{controller_folder}` = the Controller Folder from the table above.
+
+---
+
+## Usage in MCP Call
+
+When calling `mcp__smartstack__scaffold_extension`:
+
+```
+Tool: mcp__smartstack__scaffold_extension
+Args:
+  type: "feature"
+  name: "{entityName}"
+  options:
+    navRoute: "{full_path}"
+    tablePrefix: "{prefix}"        ← Derived prefix
+    schema: "core"
+    ...
+```

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

@@ -1,88 +1,88 @@
-# Backend Post-Generation Verification
-
-**Run ALL checks before proceeding to next step.**
-
-## Check 1: Backend Build (BLOCKING)
-
-```bash
-dotnet build {SolutionName}.sln --no-restore
-```
-
-IF build fails: Read errors, fix compilation issues, re-run until success.
-
-## Check 2: DbSet Registration (BLOCKING)
-
-Search for `DbSet<{EntityName}>` in `I{DbContextName}.cs` or `{DbContextName}.cs`.
-
-IF NOT found, add:
-```csharp
-public DbSet<{EntityName}> {EntityName}s => Set<{EntityName}>();
-```
-
-## Check 3: DI Registration (BLOCKING)
-
-Search for `I{EntityName}Service` in `DependencyInjection.cs`.
-
-IF NOT found, add:
-```csharp
-services.AddScoped<I{EntityName}Service, {EntityName}Service>();
-```
-
-## Check 4: RequirePermission Attributes (BLOCKING)
-
-Each HTTP action MUST have `[RequirePermission(Permissions.{Application}.{Module}.{Action})]`.
-
-## Check 5: Entity Configuration (BLOCKING)
-
-Verify:
-- `builder.ToTable("{table_prefix}{EntityName}s")` uses correct prefix
-- `builder.HasKey(e => e.Id)` present
-- `builder.HasIndex` for unique fields
-
-## Check 5b: Seeding Infrastructure (first entity only)
-
-**If this is the FIRST entity (no existing DevDataSeeder):**
-
-1. **`Infrastructure/Persistence/Seeding/Data/SeedConstants.cs`**
-```csharp
-namespace {BaseNamespace}.Infrastructure.Persistence.Seeding.Data;
-public static class SeedConstants
-{
-    public static readonly DateTime SeedDate = new(2024, 1, 1, 0, 0, 0, DateTimeKind.Utc);
-}
-```
-
-2. **`Infrastructure/Persistence/Seeding/DevDataSeeder.cs`**
-```csharp
-public class DevDataSeeder : IDevDataSeeder
-{
-    private readonly ExtensionsDbContext _context;
-    private readonly ILogger<DevDataSeeder> _logger;
-    public DevDataSeeder(ExtensionsDbContext context, ILogger<DevDataSeeder> logger) { _context = context; _logger = logger; }
-    public async Task SeedAsync(CancellationToken cancellationToken = default)
-    {
-        _logger.LogInformation("Starting development data seeding...");
-        // Add Seed{Entity}sAsync calls here
-        _logger.LogInformation("Development data seeding complete.");
-    }
-}
-```
-
-3. Register: `services.AddScoped<IDevDataSeeder, DevDataSeeder>();`
-
-## Check 5c: SqlObjects Directory (first entity only)
-
-**If no existing SqlObjectHelper:**
-
-1. **`Infrastructure/Persistence/SqlObjects/SqlObjectHelper.cs`** - Helper for embedded SQL resources
-2. Create `Infrastructure/Persistence/SqlObjects/Functions/` directory
-3. Ensure `.csproj` has: `<EmbeddedResource Include="Persistence\SqlObjects\**\*.sql" />`
-
-## Check 6: Convention Validation (RECOMMENDED)
-
-```
-Tool: mcp__smartstack__validate_conventions
-Args: target: "backend", scope: "{entity_name}"
-```
-
-Verifies naming conventions, architecture layers, required attributes, DTO patterns.
+# Backend Post-Generation Verification
+
+**Run ALL checks before proceeding to next step.**
+
+## Check 1: Backend Build (BLOCKING)
+
+```bash
+dotnet build {SolutionName}.sln --no-restore
+```
+
+IF build fails: Read errors, fix compilation issues, re-run until success.
+
+## Check 2: DbSet Registration (BLOCKING)
+
+Search for `DbSet<{EntityName}>` in `I{DbContextName}.cs` or `{DbContextName}.cs`.
+
+IF NOT found, add:
+```csharp
+public DbSet<{EntityName}> {EntityName}s => Set<{EntityName}>();
+```
+
+## Check 3: DI Registration (BLOCKING)
+
+Search for `I{EntityName}Service` in `DependencyInjection.cs`.
+
+IF NOT found, add:
+```csharp
+services.AddScoped<I{EntityName}Service, {EntityName}Service>();
+```
+
+## Check 4: RequirePermission Attributes (BLOCKING)
+
+Each HTTP action MUST have `[RequirePermission(Permissions.{Application}.{Module}.{Action})]`.
+
+## Check 5: Entity Configuration (BLOCKING)
+
+Verify:
+- `builder.ToTable("{table_prefix}{EntityName}s")` uses correct prefix
+- `builder.HasKey(e => e.Id)` present
+- `builder.HasIndex` for unique fields
+
+## Check 5b: Seeding Infrastructure (first entity only)
+
+**If this is the FIRST entity (no existing DevDataSeeder):**
+
+1. **`Infrastructure/Persistence/Seeding/Data/SeedConstants.cs`**
+```csharp
+namespace {BaseNamespace}.Infrastructure.Persistence.Seeding.Data;
+public static class SeedConstants
+{
+    public static readonly DateTime SeedDate = new(2024, 1, 1, 0, 0, 0, DateTimeKind.Utc);
+}
+```
+
+2. **`Infrastructure/Persistence/Seeding/DevDataSeeder.cs`**
+```csharp
+public class DevDataSeeder : IDevDataSeeder
+{
+    private readonly ExtensionsDbContext _context;
+    private readonly ILogger<DevDataSeeder> _logger;
+    public DevDataSeeder(ExtensionsDbContext context, ILogger<DevDataSeeder> logger) { _context = context; _logger = logger; }
+    public async Task SeedAsync(CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("Starting development data seeding...");
+        // Add Seed{Entity}sAsync calls here
+        _logger.LogInformation("Development data seeding complete.");
+    }
+}
+```
+
+3. Register: `services.AddScoped<IDevDataSeeder, DevDataSeeder>();`
+
+## Check 5c: SqlObjects Directory (first entity only)
+
+**If no existing SqlObjectHelper:**
+
+1. **`Infrastructure/Persistence/SqlObjects/SqlObjectHelper.cs`** - Helper for embedded SQL resources
+2. Create `Infrastructure/Persistence/SqlObjects/Functions/` directory
+3. Ensure `.csproj` has: `<EmbeddedResource Include="Persistence\SqlObjects\**\*.sql" />`
+
+## Check 6: Convention Validation (RECOMMENDED)
+
+```
+Tool: mcp__smartstack__validate_conventions
+Args: target: "backend", scope: "{entity_name}"
+```
+
+Verifies naming conventions, architecture layers, required attributes, DTO patterns.