@atlashub/smartstack-cli 4.75.0 → 4.79.0

package/templates/skills/{sketch → business-analyse-quick}/references/domain-heuristics.md

@@ -1,8 +1,8 @@
-# Domain Heuristics — /sketch
+# Domain Heuristics — /business-analyse-quick
 
-> **Purpose:** Accelerate entity/property inference for common business domains.
+> **Purpose:** Accelerate entity/property/section/rule inference for common business domains.
 > This table is an **accelerator**, not a limiter. If the user's domain is not listed,
-> the LLM infers entities and properties from general knowledge.
+> the LLM infers entities, properties, sections, and rules from general knowledge.
 
 ---
 
@@ -12,6 +12,10 @@
   labels: { fr: "Employé", en: "Employee", it: "Dipendente", de: "Mitarbeiter" }
 - **Department** (Name:string, Code:string, ParentDepartmentId:Guid?→Department)
   labels: { fr: "Département", en: "Department", it: "Dipartimento", de: "Abteilung" }
+- typicalSections: list, detail, orgchart (functional)
+- typicalRules: "Employee must have unique email", "Department cannot be its own parent"
+- personExtension: Employee
+- typicalRoles: [{ role: "HR Admin", level: "admin" }, { role: "HR Manager", level: "manager" }, { role: "Employee", level: "viewer" }]
 
 ## Absences / Congés
 
@@ -19,6 +23,10 @@
   labels: { fr: "Absence", en: "Absence", it: "Assenza", de: "Abwesenheit" }
 - **AbsenceType** (Name:string, Code:string, MaxDays:int, IsPaid:bool)
   labels: { fr: "Type d'absence", en: "Absence Type", it: "Tipo di assenza", de: "Abwesenheitstyp" }
+- typicalSections: list, detail, calendar (functional), approve (functional)
+- typicalRules: "StartDate must be before EndDate", "Cannot exceed MaxDays per type per year", "Approval required for > 3 days"
+- workflow: Draft → Submitted → Approved/Rejected
+- typicalRoles: [{ role: "HR Admin", level: "admin" }, { role: "Manager", level: "manager" }, { role: "Employee", level: "contributor" }]
 
 ## CRM / Clients
 
@@ -26,6 +34,10 @@
   labels: { fr: "Client", en: "Customer", it: "Cliente", de: "Kunde" }
 - **Contact** (FirstName:string, LastName:string, Email:string, Phone:string, CustomerId:Guid→Customer)
   labels: { fr: "Contact", en: "Contact", it: "Contatto", de: "Kontakt" }
+- typicalSections: list, detail, dashboard (embedded)
+- typicalRules: "Customer must have unique email or phone", "Contact requires valid Customer"
+- personExtension: Customer, Contact
+- typicalRoles: [{ role: "CRM Admin", level: "admin" }, { role: "Sales Manager", level: "manager" }, { role: "Sales Rep", level: "contributor" }]
 
 ## Commandes / Orders
 
@@ -33,6 +45,10 @@
   labels: { fr: "Commande", en: "Order", it: "Ordine", de: "Bestellung" }
 - **OrderLine** (Quantity:int, UnitPrice:decimal, TotalPrice:decimal, ProductId:Guid→Product, OrderId:Guid→Order)
   labels: { fr: "Ligne de commande", en: "Order Line", it: "Riga d'ordine", de: "Bestellposition" }
+- typicalSections: list, detail, dashboard (embedded)
+- typicalRules: "TotalPrice = Quantity * UnitPrice", "Order TotalAmount = sum of lines", "Cannot delete confirmed order"
+- workflow: Draft → Confirmed → Shipped → Delivered/Cancelled
+- typicalRoles: [{ role: "Sales Admin", level: "admin" }, { role: "Sales Manager", level: "manager" }, { role: "Sales Rep", level: "contributor" }]
 
 ## Facturation / Invoicing
 
@@ -40,6 +56,10 @@
   labels: { fr: "Facture", en: "Invoice", it: "Fattura", de: "Rechnung" }
 - **InvoiceLine** (Description:string, Quantity:int, UnitPrice:decimal, TotalPrice:decimal, InvoiceId:Guid→Invoice)
   labels: { fr: "Ligne de facture", en: "Invoice Line", it: "Riga di fattura", de: "Rechnungsposition" }
+- typicalSections: list, detail, dashboard (embedded)
+- typicalRules: "DueDate must be after InvoiceDate", "TotalPrice = Quantity * UnitPrice", "Cannot modify paid invoice"
+- workflow: Draft → Sent → Paid/Overdue/Cancelled
+- typicalRoles: [{ role: "Finance Admin", level: "admin" }, { role: "Accountant", level: "contributor" }, { role: "Viewer", level: "viewer" }]
 
 ## Projets / Projects
 
@@ -49,6 +69,10 @@
   labels: { fr: "Tâche", en: "Task", it: "Attività", de: "Aufgabe" }
 - **Milestone** (Name:string, DueDate:DateTime, Status:string, ProjectId:Guid→Project)
   labels: { fr: "Jalon", en: "Milestone", it: "Traguardo", de: "Meilenstein" }
+- typicalSections: list, detail, board (functional), timeline (functional)
+- typicalRules: "EndDate must be after StartDate", "Task DueDate cannot exceed project EndDate", "Milestone blocks project completion"
+- workflow: Planning → InProgress → Completed/OnHold/Cancelled
+- typicalRoles: [{ role: "Project Admin", level: "admin" }, { role: "Project Manager", level: "manager" }, { role: "Team Member", level: "contributor" }, { role: "Stakeholder", level: "viewer" }]
 
 ## Stock / Inventaire
 
@@ -58,6 +82,9 @@
   labels: { fr: "Catégorie", en: "Category", it: "Categoria", de: "Kategorie" }
 - **StockMovement** (Quantity:int, Type:string, Date:DateTime, ProductId:Guid→Product, WarehouseId:Guid?→Warehouse)
   labels: { fr: "Mouvement de stock", en: "Stock Movement", it: "Movimento di stock", de: "Lagerbewegung" }
+- typicalSections: list, detail, movements (functional), inventory (functional)
+- typicalRules: "Product code must be unique", "Stock cannot go negative", "Category cannot be its own parent"
+- typicalRoles: [{ role: "Inventory Admin", level: "admin" }, { role: "Warehouse Manager", level: "manager" }, { role: "Stock Clerk", level: "contributor" }]
 
 ## Contrats / Contracts
 
@@ -65,6 +92,10 @@
   labels: { fr: "Contrat", en: "Contract", it: "Contratto", de: "Vertrag" }
 - **ContractAmendment** (Description:string, Date:DateTime, Amount:decimal?, ContractId:Guid→Contract)
   labels: { fr: "Avenant", en: "Amendment", it: "Emendamento", de: "Nachtrag" }
+- typicalSections: list, detail, renewals (functional)
+- typicalRules: "EndDate must be after StartDate", "Amendment Date must be within contract period", "Cannot amend terminated contract"
+- workflow: Draft → Active → Expired/Terminated/Renewed
+- typicalRoles: [{ role: "Contract Admin", level: "admin" }, { role: "Contract Manager", level: "manager" }, { role: "Viewer", level: "viewer" }]
 
 ## Tickets / Support
 
@@ -72,6 +103,10 @@
   labels: { fr: "Ticket", en: "Ticket", it: "Ticket", de: "Ticket" }
 - **TicketComment** (Content:string, IsInternal:bool, TicketId:Guid→Ticket)
   labels: { fr: "Commentaire", en: "Comment", it: "Commento", de: "Kommentar" }
+- typicalSections: list, detail, dashboard (embedded), board (functional)
+- typicalRules: "Priority must be set before assignment", "Internal comments not visible to customer", "SLA timer based on priority"
+- workflow: Open → InProgress → Resolved → Closed/Reopened
+- typicalRoles: [{ role: "Support Admin", level: "admin" }, { role: "Support Agent", level: "contributor" }, { role: "Customer", level: "viewer" }]
 
 ## Fournisseurs / Suppliers
 
@@ -79,6 +114,10 @@
   labels: { fr: "Fournisseur", en: "Supplier", it: "Fornitore", de: "Lieferant" }
 - **PurchaseOrder** (OrderDate:DateTime, Status:string, TotalAmount:decimal, SupplierId:Guid→Supplier)
   labels: { fr: "Bon de commande", en: "Purchase Order", it: "Ordine d'acquisto", de: "Bestellung" }
+- typicalSections: list, detail
+- typicalRules: "Supplier must have unique VatNumber", "PO requires valid supplier", "Cannot modify approved PO"
+- workflow: Draft → Submitted → Approved → Received/Cancelled
+- typicalRoles: [{ role: "Procurement Admin", level: "admin" }, { role: "Procurement Manager", level: "manager" }, { role: "Buyer", level: "contributor" }]
 
 ## Documents / GED
 
@@ -86,6 +125,9 @@
   labels: { fr: "Document", en: "Document", it: "Documento", de: "Dokument" }
 - **Folder** (Name:string, ParentFolderId:Guid?→Folder)
   labels: { fr: "Dossier", en: "Folder", it: "Cartella", de: "Ordner" }
+- typicalSections: list, detail, explorer (functional)
+- typicalRules: "Folder cannot be its own parent", "File size limit per tenant", "Unique filename within folder"
+- typicalRoles: [{ role: "Document Admin", level: "admin" }, { role: "Editor", level: "contributor" }, { role: "Reader", level: "viewer" }]
 
 ## Réservations / Bookings
 
@@ -93,6 +135,10 @@
   labels: { fr: "Réservation", en: "Booking", it: "Prenotazione", de: "Buchung" }
 - **Resource** (Name:string, Type:string, Capacity:int?, Location:string?)
   labels: { fr: "Ressource", en: "Resource", it: "Risorsa", de: "Ressource" }
+- typicalSections: list, detail, calendar (functional)
+- typicalRules: "EndDate must be after StartDate", "No overlapping bookings for same resource", "Cannot book past dates"
+- workflow: Pending → Confirmed → Completed/Cancelled
+- typicalRoles: [{ role: "Booking Admin", level: "admin" }, { role: "Booking Manager", level: "manager" }, { role: "Customer", level: "contributor" }]
 
 ## Événements / Events
 
@@ -100,6 +146,9 @@
   labels: { fr: "Événement", en: "Event", it: "Evento", de: "Veranstaltung" }
 - **Registration** (Status:string, RegisteredAt:DateTime, EventId:Guid→Event, ContactId:Guid?→Contact)
   labels: { fr: "Inscription", en: "Registration", it: "Iscrizione", de: "Anmeldung" }
+- typicalSections: list, detail, registrations (functional)
+- typicalRules: "Cannot exceed MaxAttendees", "Registration closes at event StartDate", "EndDate must be after StartDate"
+- typicalRoles: [{ role: "Event Admin", level: "admin" }, { role: "Event Organizer", level: "manager" }, { role: "Attendee", level: "viewer" }]
 
 ## Formation / Training
 
@@ -107,6 +156,9 @@
   labels: { fr: "Formation", en: "Training", it: "Formazione", de: "Schulung" }
 - **Enrollment** (Status:string, EnrolledAt:DateTime, TrainingId:Guid→Training, EmployeeId:Guid→Employee)
   labels: { fr: "Inscription", en: "Enrollment", it: "Iscrizione", de: "Anmeldung" }
+- typicalSections: list, detail, enrollments (functional)
+- typicalRules: "Cannot exceed MaxParticipants", "Employee cannot enroll twice in same training", "Trainer cannot be enrolled"
+- typicalRoles: [{ role: "Training Admin", level: "admin" }, { role: "Trainer", level: "manager" }, { role: "Employee", level: "contributor" }]
 
 ## Maintenance / Equipment
 
@@ -114,3 +166,7 @@
   labels: { fr: "Équipement", en: "Equipment", it: "Attrezzatura", de: "Ausrüstung" }
 - **MaintenanceRequest** (Title:string, Description:string, Priority:string, Status:string, EquipmentId:Guid→Equipment, RequestedById:Guid?→Employee)
   labels: { fr: "Demande de maintenance", en: "Maintenance Request", it: "Richiesta di manutenzione", de: "Wartungsanfrage" }
+- typicalSections: list, detail, schedule (functional)
+- typicalRules: "Equipment must have unique SerialNumber", "Cannot request maintenance on decommissioned equipment"
+- workflow: Submitted → Assigned → InProgress → Completed/Rejected
+- typicalRoles: [{ role: "Maintenance Admin", level: "admin" }, { role: "Technician", level: "contributor" }, { role: "Requester", level: "viewer" }]

package/templates/skills/business-analyse-quick/references/prd-schema.md

@@ -0,0 +1,268 @@
+# PRD Schema Reference — /business-analyse-quick
+
+> Schemas for PRD v4.0 and companion specification files.
+> Field names are **identical** to BA schemas for APEX delegate mode compatibility.
+
+---
+
+## PRD v4.0 Structure
+
+```json
+{
+  "$version": "4.0.0",
+  "project": {
+    "application": "{AppPascalCase}",
+    "module": "{module-kebab-case}"
+  },
+  "expectedFiles": {
+    "domain": [
+      { "path": "src/Domain/Entities/{App}/{Module}/{Entity}.cs", "type": "Entity", "module": "{Module}" }
+    ],
+    "infrastructure": [
+      { "path": "src/Infrastructure/Persistence/Configurations/{App}/{Module}/{Entity}Configuration.cs", "type": "EFConfig", "module": "{Module}" }
+    ],
+    "seedData": [
+      { "path": "src/Infrastructure/Persistence/Seeding/Data/{Module}/NavigationModuleSeedData.cs", "type": "NavModule", "module": "{Module}" },
+      { "path": "src/Infrastructure/Persistence/Seeding/Data/{Module}/NavigationSectionSeedData.cs", "type": "NavSection", "module": "{Module}" },
+      { "path": "src/Infrastructure/Persistence/Seeding/Data/{Module}/PermissionsSeedData.cs", "type": "Permissions", "module": "{Module}" },
+      { "path": "src/Infrastructure/Persistence/Seeding/Data/{Module}/RolesSeedData.cs", "type": "Roles", "module": "{Module}" }
+    ],
+    "application": [
+      { "path": "src/Application/Services/{App}/{Module}/{Entity}Service.cs", "type": "Service", "module": "{Module}" },
+      { "path": "src/Application/DTOs/{App}/{Module}/Create{Entity}Dto.cs", "type": "DTO", "module": "{Module}" },
+      { "path": "src/Application/DTOs/{App}/{Module}/Update{Entity}Dto.cs", "type": "DTO", "module": "{Module}" },
+      { "path": "src/Application/DTOs/{App}/{Module}/{Entity}Dto.cs", "type": "DTO", "module": "{Module}" },
+      { "path": "src/Application/Validators/{App}/{Module}/{Entity}Validator.cs", "type": "Validator", "module": "{Module}" }
+    ],
+    "api": [
+      { "path": "src/API/Controllers/{App}/{Entity}Controller.cs", "type": "Controller", "module": "{Module}" }
+    ],
+    "frontend": [
+      { "path": "src/pages/{app-kebab}/{module-kebab}/{Entity}ListPage.tsx", "type": "Page", "module": "{Module}" },
+      { "path": "src/pages/{app-kebab}/{module-kebab}/{Entity}DetailPage.tsx", "type": "Page", "module": "{Module}" },
+      { "path": "src/pages/{app-kebab}/{module-kebab}/Create{Entity}Page.tsx", "type": "Page", "module": "{Module}" },
+      { "path": "src/pages/{app-kebab}/{module-kebab}/Edit{Entity}Page.tsx", "type": "Page", "module": "{Module}" },
+      { "path": "src/i18n/locales/fr/{module-lower}.json", "type": "i18n", "module": "{Module}" },
+      { "path": "src/i18n/locales/en/{module-lower}.json", "type": "i18n", "module": "{Module}" },
+      { "path": "src/i18n/locales/it/{module-lower}.json", "type": "i18n", "module": "{Module}" },
+      { "path": "src/i18n/locales/de/{module-lower}.json", "type": "i18n", "module": "{Module}" }
+    ],
+    "tests": [
+      { "path": "src/Tests/Unit/Domain/{App}/{Module}/{Entity}Tests.cs", "type": "UnitTest", "module": "{Module}" },
+      { "path": "src/Tests/Integration/{App}/{Module}/{Entity}ControllerTests.cs", "type": "IntegrationTest", "module": "{Module}" }
+    ],
+    "documentation": []
+  },
+  "specificationFiles": {
+    "entities": "prd-{module}.entities.json",
+    "permissions": "prd-{module}.permissions.json",
+    "rules": "prd-{module}.rules.json",
+    "usecases": "prd-{module}.usecases.json",
+    "screens": "prd-{module}.screens.json"
+  },
+  "tasks": []
+}
+```
+
+> **Paths in `specificationFiles`** are relative to the PRD directory (`.ralph/`).
+> APEX resolves them via `path.join(path.dirname(prd_path), specFiles.xxx)`.
+
+---
+
+## entities.json
+
+```json
+{
+  "entities": [
+    {
+      "name": "Employee",
+      "description": "Represents a company employee",
+      "personRoleConfig": { "variant": "mandatory", "userFields": ["firstName", "lastName", "email"] },
+      "attributes": [
+        { "name": "code", "type": "string", "required": true, "unique": true, "searchable": true },
+        { "name": "firstName", "type": "string", "required": true },
+        { "name": "hireDate", "type": "DateTime", "required": true },
+        { "name": "status", "type": "enum", "required": true, "values": ["Active", "Inactive"] }
+      ],
+      "relationships": [
+        { "target": "Department", "type": "ManyToOne", "description": "Employee belongs to a department" }
+      ],
+      "codePattern": { "strategy": "sequential", "prefix": "emp", "digits": 5, "separator": "-", "includeTenantSlug": true },
+      "estimatedVolume": { "monthly": 20, "total2y": 500 }
+    }
+  ]
+}
+```
+
+**Rules:**
+- `personRoleConfig` only if entity has personal attributes (→ FK to auth_Users with type `string`, NOT Guid)
+- Omit boolean flags when `false` (unique, searchable, computed)
+- NO technical fields (Id, TenantId, CreatedBy, ModifiedBy, etc.)
+- `type`: string | int | decimal | long | bool | DateTime | Guid | enum
+
+---
+
+## rules.json
+
+```json
+{
+  "rules": [
+    {
+      "id": "BR-VAL-EMP-001",
+      "name": "Hire date validation",
+      "category": "validation",
+      "statement": "Hire date cannot be in the future",
+      "severity": "blocking",
+      "priority": "must",
+      "entities": ["Employee"],
+      "examples": [
+        { "input": "hireDate = 2027-01-01", "expected": "Error: date in the future" }
+      ]
+    }
+  ]
+}
+```
+
+**ID format:** `BR-{CAT}-{MODULE}-{NNN}` where CAT = VAL|CALC|WFL|SEC|DAT|NOT
+**Categories:** validation | calculation | workflow | security | data | notification
+- `formula` field required for `calculation` category
+- `conditions` + `consequences` fields required for `workflow` category
+
+---
+
+## usecases.json
+
+```json
+{
+  "useCases": [
+    {
+      "id": "UC-EMP-001",
+      "name": "Create employee",
+      "sectionCode": "list",
+      "primaryActor": "HR Manager",
+      "permission": "HumanResources.Employees.Create",
+      "preconditions": ["User has HumanResources.Employees.Create permission"],
+      "mainScenario": [
+        "User opens the creation page",
+        "User fills mandatory fields",
+        "User submits the form",
+        "System validates business rules",
+        "System creates the employee with Active status"
+      ],
+      "alternativeScenarios": [
+        { "name": "Invalid data", "steps": ["System displays validation errors", "User corrects and resubmits"] }
+      ],
+      "postconditions": ["Employee created with status Active"],
+      "businessRules": ["BR-VAL-EMP-001"],
+      "result": "Employee is created with Active status"
+    }
+  ]
+}
+```
+
+**Field naming:** `useCases` (NOT usecases), `primaryActor` (NOT actor), `mainScenario` as string[]
+
+---
+
+## permissions.json
+
+```json
+{
+  "roles": [
+    { "role": "HR Admin", "level": "admin", "description": "Full access to HR module" },
+    { "role": "Manager", "level": "manager", "description": "Read, create, update and approve access" },
+    { "role": "Viewer", "level": "viewer", "description": "Read-only access" }
+  ],
+  "permissionPaths": [
+    "HumanResources.Employees.Read",
+    "HumanResources.Employees.Create",
+    "HumanResources.Employees.Update",
+    "HumanResources.Employees.Delete",
+    "HumanResources.Employees.Export",
+    "HumanResources.Employees.Approve"
+  ],
+  "matrix": {
+    "roleAssignments": [
+      { "role": "HR Admin", "permissions": ["HumanResources.Employees.*"] },
+      { "role": "Manager", "permissions": ["HumanResources.Employees.Read", "HumanResources.Employees.Create", "HumanResources.Employees.Update", "HumanResources.Employees.Approve"] },
+      { "role": "Viewer", "permissions": ["HumanResources.Employees.Read"] }
+    ]
+  }
+}
+```
+
+**Role rules:**
+- `role`: display name, PascalCase words with spaces (e.g., "HR Admin", NOT "hr-admin")
+- `level`: one of `admin` | `manager` | `contributor` | `viewer` — determines hierarchy position
+- `description`: one sentence in `{conversation_language}`
+- MINIMUM 2 roles: one admin-level + one operational role
+
+**Permission path format:**
+- 3-segment (standard): `{ApplicationPascalCase}.{ModulePascalCase}.{Action}`
+- 4-segment (custom section): `{ApplicationPascalCase}.{ModulePascalCase}.{SectionPascalCase}.{Action}`
+- All segments are PascalCase — NO hyphens, NO spaces, NO kebab-case
+- Module name conversion: `absence-management` → `AbsenceManagement`
+
+**Standard actions:** Read, Create, Update, Delete, Export, Import, Approve, Admin
+
+**Matrix rules:**
+- Admin role ALWAYS gets wildcard: `["{base}.*"]`
+- Other roles get EXPLICIT path lists (no wildcards)
+- Every role in `roleAssignments` MUST exist in `roles[]`
+- Every permission path in `roleAssignments` MUST exist in `permissionPaths` (except wildcards ending with `.*`)
+
+**Cross-validation requirements:**
+- Every `permission` field in usecases.json MUST exist in `permissionPaths`
+- Every section `permission` in screens.json (where `permissionMode` is not `"inherit"`) MUST exist in `permissionPaths`
+- `permissionPaths.length >= 4` (Read + Create + Update + Delete minimum per module)
+
+---
+
+## screens.json
+
+```json
+{
+  "sections": [
+    {
+      "code": "list",
+      "sectionType": "primary",
+      "permissionMode": "crud",
+      "parentSectionCode": null,
+      "labels": { "fr": "Employés", "en": "Employees", "it": "Dipendenti", "de": "Mitarbeiter" },
+      "route": "/{app-kebab}/{module-kebab}/list",
+      "icon": "users",
+      "permission": "HumanResources.Employees.Read",
+      "useCases": ["UC-EMP-001", "UC-EMP-002"],
+      "resources": [
+        {
+          "code": "employees-grid",
+          "type": "SmartTable",
+          "entity": "Employee",
+          "columns": [
+            { "field": "code", "label": { "fr": "Code", "en": "Code" }, "format": "text", "sortable": true },
+            { "field": "firstName", "label": { "fr": "Prénom", "en": "First Name" }, "format": "text" },
+            { "field": "status", "label": { "fr": "Statut", "en": "Status" }, "format": "badge" }
+          ],
+          "actions": ["create", "edit", "delete"],
+          "defaultSort": { "field": "code", "direction": "asc" },
+          "defaultPageSize": 20
+        }
+      ]
+    }
+  ]
+}
+```
+
+**Section types:** primary (menu-visible, includes implicit detail/create/edit pages) | functional (independent workflow) | embedded (widget/tab)
+**Resource types:** SmartTable | SmartForm | DetailCard | KpiPanel | KpiCard | Timeline | Chart | FilterBar | Tabs
+
+> **IMPORTANT — Implicit pages (NOT sections):**
+> APEX automatically generates detail (/:id), create (/create), and edit (/:id/edit) pages
+> as routes under each primary section. Do NOT include "detail", "create", "edit", or "*-detail"
+> as sections in screens.json — they are implicit APEX pages, not navigation entries.
+>
+> **API route convention:**
+> - `route` field is the frontend React Router path (e.g., `/human-resources/employees/list`)
+> - The backend API endpoint is `/api/{app-kebab}/{module-kebab}` (API routes never include section codes)
+> - GetById: `GET /api/{app-kebab}/{module-kebab}/{id}`
+> - GetAll: `GET /api/{app-kebab}/{module-kebab}` with pagination query params

package/templates/skills/business-analyse-review/references/review-data-mapping.md

@@ -153,11 +153,17 @@ reverseBusinessRule(htmlBR, existingBR) {
     name: htmlBR.name,
     category: htmlBR.category,
     statement: htmlBR.statement,
+    severity: htmlBR.severity || existingBR?.severity || "blocking",
+    sectionCode: htmlBR.sectionCode || existingBR?.sectionCode || "",
+    entities: htmlBR.entities || existingBR?.entities || [],
     priority: existingBR?.priority || "must",
     conditions: existingBR?.conditions || [],
     examples: htmlBR.example
       ? [{ input: htmlBR.example, expected: "" }]
       : (existingBR?.examples || []),
+    consequences: existingBR?.consequences || [],
+    formula: htmlBR.formula || existingBR?.formula || null,
+    domainSpecific: existingBR?.domainSpecific ?? false,
     testability: existingBR?.testability || ""
   };
 }

package/templates/skills/cli-app-sync/SKILL.md

@@ -22,10 +22,11 @@ See [references/comparison-map.md](references/comparison-map.md) for the full fi
 
 <quick_start>
 ```bash
-/cli-app-sync                # Full drift report (read-only)
-/cli-app-sync report         # Same as above
-/cli-app-sync fix            # Detect drift + apply fixes interactively
-/cli-app-sync check Program  # Check a single file mapping
+/cli-app-sync                  # Full drift report (read-only)
+/cli-app-sync report           # Same as above
+/cli-app-sync fix              # Detect drift + apply fixes interactively
+/cli-app-sync check Program    # Check a single file mapping
+/cli-app-sync diff-entities    # List Domain entities NOT referenced by any skill
 ```
 </quick_start>
 
@@ -37,6 +38,7 @@ See [references/comparison-map.md](references/comparison-map.md) for the full fi
 | `/cli-app-sync report` | Same as above (explicit) |
 | `/cli-app-sync fix` | Detect drift and propose fixes interactively |
 | `/cli-app-sync check <name>` | Check a single comparison point by name |
+| `/cli-app-sync diff-entities` | List Domain entities present in app but NOT covered by any CLI skill (uncovered drift detector) |
 
 </subcommands>
 
@@ -262,6 +264,103 @@ Status: DRIFT (2 issues)
 
 </output_format>
 
+<diff_entities_workflow>
+
+## `/cli-app-sync diff-entities` — uncovered Domain entities
+
+**Why this exists.** `cli-app-sync` (default mode) compares known files in `templates/project/` and `init.ts` against their counterparts in `SmartStack.app`. It detects **explicit drift** but is blind to **trous** : a brand-new entity in the platform (e.g. `AiTool`, `WorkflowVersion`, `AiEvalDataset` added in v3.46) that no CLI skill mentions yet. Without `diff-entities`, those gaps are only caught by manual audit.
+
+See [references/diff-entities.md](references/diff-entities.md) for the full algorithm (rules, exclusions, output format).
+
+### Quick algorithm
+
+1. **Enumerate Domain entities** :
+   ```bash
+   APP_DOMAIN="${APP_PATH:-D:/01 - projets/SmartStack.app/features/IA-Workflow}/src/SmartStack.Domain"
+   # Classes/records that look like aggregate roots (inherit BaseEntity or are records under Domain/)
+   grep -rPnh "^\s*public\s+(?:partial\s+)?(?:class|record)\s+([A-Z][A-Za-z0-9]+)\s*:?\s*(?:BaseEntity|I[A-Z][A-Za-z]+Entity|IDomainEvent)" "$APP_DOMAIN" \
+     --include='*.cs' \
+     | sed -E "s/.*\b(class|record)\s+([A-Z][A-Za-z0-9]+).*/\2/" \
+     | sort -u > /tmp/app-entities.txt
+   ```
+
+2. **Enumerate entities referenced in CLI skills** :
+   ```bash
+   CLI_SKILLS="D:/01 - projets/SmartStack.cli/02-Develop/templates/skills"
+   # Any PascalCase token in code blocks that matches an entity name
+   while IFS= read -r ENT; do
+     COUNT=$(grep -r --include='*.md' --include='*.sh' -lE "\b${ENT}\b" "$CLI_SKILLS" | wc -l)
+     echo "${ENT}|${COUNT}"
+   done < /tmp/app-entities.txt > /tmp/entity-coverage.tsv
+   ```
+
+3. **Classify** each entity :
+   - `count = 0` → `[NEW UNCOVERED]` — propose a skill to cover it
+   - `count = 1-2` → `[THIN]` — covered but might benefit from a dedicated reference
+   - `count ≥ 3` → `[COVERED]` — well documented (skip in report unless `--verbose`)
+
+4. **Suggest a skill destination** based on the entity's namespace :
+
+   | Namespace prefix | Suggested skill |
+   |---|---|
+   | `Domain.AI.Agents.*` / `Domain.AI.Skills.*` | `ai-prompt` |
+   | `Domain.AI.Evaluations.*` | `ai-prompt` (`references/eval-framework.md`) |
+   | `Domain.AI.Tools.*` | `ai-prompt` |
+   | `Domain.Communications.Workflow*` | `workflow` |
+   | `Domain.Communications.EmailTemplate*` | `notification` (or `workflow`) |
+   | `Domain.Navigation.*` | `application` |
+   | `Domain.Platform.Administration.UiConfiguration.*` | `application/references/themes-db-driven.md` |
+   | `Domain.Licensing.*` | `apex/references/smartstack-api.md` (Licensing section) |
+   | `Domain.Common.*` (interfaces, enums) | `apex/references/smartstack-api.md` |
+   | `Domain.Support.*` | `notification` (or new skill) |
+   | other | propose a new skill name based on the namespace |
+
+### Output (typical)
+
+```
+================================================================================
+              UNCOVERED DOMAIN ENTITIES — {date}
+================================================================================
+APP : IA-Workflow @ {commit}
+Total Domain entities scanned: 87
+
+[NEW UNCOVERED] (0 references in templates/skills/)
+  AiTool                     → Domain/AI/Tools/         → ai-prompt skill
+  AiSkillTool                → Domain/AI/Tools/         → ai-prompt skill
+  AiEvalDataset              → Domain/AI/Evaluations/   → ai-prompt/references/eval-framework.md
+  AiEvalDatasetItem          → Domain/AI/Evaluations/   → idem
+  AiEvaluation               → Domain/AI/Evaluations/   → idem
+  AiEvalResult               → Domain/AI/Evaluations/   → idem
+  AiAgentExecution           → Domain/AI/Agents/        → ai-prompt skill
+  AiAgentStepExecution       → Domain/AI/Agents/        → ai-prompt skill
+  WorkflowVersion            → Domain/Communications/   → workflow skill
+  IBeforeCreate              → Application/Hooks/       → smartstack-api.md (Hooks section)
+  IDomainEvent               → Domain/Support/Events/   → smartstack-api.md (Domain Events)
+
+[THIN] (1-2 references — consider dedicated docs)
+  License                    (2 refs)  → smartstack-api.md (Licensing section)
+  BrandingAsset              (1 ref)   → themes-db-driven.md
+  UiThemeTenantPublication   (1 ref)   → themes-db-driven.md
+
+[COVERED] (≥3 references — well documented, hidden unless --verbose)
+  87 entities — 76 covered, 11 thin/uncovered
+
+--------------------------------------------------------------------------------
+SUMMARY : 11 entities need attention (8 NEW UNCOVERED, 3 THIN)
+================================================================================
+```
+
+### Integration with the rest of `cli-app-sync`
+
+`diff-entities` is independent from the comparison map (no overlap with `report` / `fix`). It only adds new findings ; it never modifies templates. To act on findings, the user runs the suggested skill author flow manually (or invokes `/apex` if a brand-new domain warrants a full skill).
+
+Recommended cadence :
+- Run after every bump of the `APP_PATH` branch (e.g. moving from `02-Develop` to `features/IA-Workflow`)
+- Run before each release of the CLI (catch entities the platform shipped that the CLI hasn't documented yet)
+- Run weekly as a background `/loop /cli-app-sync diff-entities --report-only`
+
+</diff_entities_workflow>
+
 <success_criteria>
 - All comparison points from the map are checked
 - Intentional differences are correctly identified as SKIP
@@ -269,4 +368,6 @@ Status: DRIFT (2 issues)
 - Fix mode correctly updates template files and init.ts inline templates
 - Build passes after fixes are applied
 - Report is clear, actionable, and easy to scan
+- `diff-entities` lists every Domain entity NOT covered by any CLI skill, with a suggested destination skill
+- `diff-entities` matches the manual audit pattern that surfaced AiTool / AiEvalDataset / WorkflowVersion / Hooks gaps in the v3.46 alignment work
 </success_criteria>

package/templates/skills/cli-app-sync/references/comparison-map.md

@@ -219,6 +219,19 @@ These comparisons should **always** return `[SKIP]` — differences are by desig
 
 ---
 
+## v3.46+ Comparison Points
+
+Added with the v3.46 alignment of CLI templates. These verify client projects honor the new architecture.
+
+| ID | Comparison | Reference path | Patterns to check | Criticality |
+|---|---|---|---|---|
+| `nav-application-flags` | Seeds use `IsPersonal`/`IsOpen`, NOT `Zone = ApplicationZone.X` | `*/Seeding/Data/*NavigationApplicationSeedData.cs` and `*/Seeding/Data/*NavigationSeedData.cs` | Must match `IsPersonal\s*=` AND `IsOpen\s*=`. Must NOT match `ApplicationZone\.\w+`. | BLOCKING (with C66 grace period — currently WARNING) |
+| `frontend-layouts-count` | Exactly 4 layouts present | `web/.../src/layouts/*.tsx` | Must contain `AppLayout.tsx`, `AuthLayout.tsx`, `DocsLayout.tsx`, `PublicLayout.tsx`. Must NOT contain `AdminLayout`, `BusinessLayout`, `UserLayout`, `HRLayout`, `SalesLayout`. | BLOCKING (C67 grace period — WARNING) |
+| `provider-pattern` | Client root uses `<SmartStackProvider>` | `web/.../src/main.tsx` or `web/.../src/App.tsx` | Must contain `<SmartStackProvider config={` AND `<DynamicRouter />`. Must NOT contain manual `<AuthProvider>`/`<ThemeProvider>` re-wrap. | WARNING |
+| `ai-agent-modes` | If AI activated, enums `AiAgentMode` / `AiAgentStepRole` are present | `src/.../Domain/AI/Agents/*.cs` | If `AiAgent.cs` exists, must reference `AiAgentMode` enum (Sequential/ReAct/PlanAndExecute/SelfCorrection). | WARNING |
+
+---
+
 ## Maintenance
 
 When adding a new comparison point: