@atlashub/smartstack-cli 4.76.0 → 4.79.0

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

@@ -120,15 +120,15 @@ const docData: DocData = {
   ]
 };
 
-// Priority Badge Component
+// Priority Badge Component (theme-aware via SmartStack status tokens)
 function PriorityBadge({ priority }: { priority: string }) {
   const colors = {
-    Must: 'bg-red-500/10 text-red-600',
-    Should: 'bg-yellow-500/10 text-yellow-600',
-    Could: 'bg-blue-500/10 text-blue-600'
+    Must:   'bg-[var(--error-bg)] text-[var(--error-text)] border border-[var(--error-border)]',
+    Should: 'bg-[var(--warning-bg)] text-[var(--warning-text)] border border-[var(--warning-border)]',
+    Could:  'bg-[var(--info-bg)] text-[var(--info-text)] border border-[var(--info-border)]'
   };
   return (
-    <span className={`px-2 py-0.5 rounded text-xs font-medium ${colors[priority as keyof typeof colors] || 'bg-gray-500/10 text-gray-600'}`}>
+    <span className={`px-2 py-0.5 rounded text-xs font-medium ${colors[priority as keyof typeof colors] || 'bg-[var(--bg-tertiary)] text-[var(--text-secondary)]'}`}>
       {priority}
     </span>
   );
@@ -186,7 +186,7 @@ export function {ModuleName}DocPage() {
           <span className="px-2 py-0.5 rounded bg-[var(--color-primary-600)]/10 text-[var(--color-primary-600)] text-xs font-medium">
             {docData.featureId}
           </span>
-          <span className="px-2 py-0.5 rounded bg-green-500/10 text-green-600 text-xs font-medium">
+          <span className="px-2 py-0.5 rounded bg-[var(--success-bg)] text-[var(--success-text)] border border-[var(--success-border)] text-xs font-medium">
             v{docData.version}
           </span>
         </div>
@@ -264,7 +264,7 @@ export function {ModuleName}DocPage() {
               </div>
               <p className="text-sm text-[var(--text-secondary)] mb-2">{uc.description}</p>
               <div className="flex items-center gap-2 text-xs">
-                <Shield className="w-3 h-3 text-amber-500" />
+                <Shield className="w-3 h-3 text-[var(--warning-text)]" />
                 <code className="bg-[var(--bg-secondary)] px-2 py-0.5 rounded">{uc.permission}</code>
               </div>
             </div>
@@ -318,11 +318,11 @@ export function {ModuleName}DocPage() {
           ))}
         </div>
 
-        {/* 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" />
+        {/* Permission Warning (theme-aware) */}
+        <div className="mt-4 p-4 rounded-lg bg-[var(--warning-bg)] border border-[var(--warning-border)] flex items-start gap-3">
+          <AlertTriangle className="w-5 h-5 text-[var(--warning-text)] flex-shrink-0 mt-0.5" />
           <div>
-            <div className="font-medium text-amber-600">{t('warnings.permissionCheck')}</div>
+            <div className="font-medium text-[var(--warning-text)]">{t('warnings.permissionCheck')}</div>
             <p className="text-sm text-[var(--text-secondary)]">
               {t('warnings.permissionCheckDescription')}
             </p>
@@ -367,22 +367,22 @@ export function {ModuleName}DocPage() {
             </thead>
             <tbody>
               <tr>
-                <td className="py-2 px-3"><span className="px-2 py-0.5 rounded bg-green-500/10 text-green-600">GET</span></td>
+                <td className="py-2 px-3"><span className="px-2 py-0.5 rounded bg-[var(--success-bg)] text-[var(--success-text)] border border-[var(--success-border)]">GET</span></td>
                 <td className="py-2 px-3">/api/{'{module}'}</td>
                 <td className="py-2 px-3 text-[var(--text-secondary)]">.read</td>
               </tr>
               <tr className="bg-[var(--bg-secondary)]/50">
-                <td className="py-2 px-3"><span className="px-2 py-0.5 rounded bg-blue-500/10 text-blue-600">POST</span></td>
+                <td className="py-2 px-3"><span className="px-2 py-0.5 rounded bg-[var(--info-bg)] text-[var(--info-text)] border border-[var(--info-border)]">POST</span></td>
                 <td className="py-2 px-3">/api/{'{module}'}</td>
                 <td className="py-2 px-3 text-[var(--text-secondary)]">.create</td>
               </tr>
               <tr>
-                <td className="py-2 px-3"><span className="px-2 py-0.5 rounded bg-yellow-500/10 text-yellow-600">PUT</span></td>
+                <td className="py-2 px-3"><span className="px-2 py-0.5 rounded bg-[var(--warning-bg)] text-[var(--warning-text)] border border-[var(--warning-border)]">PUT</span></td>
                 <td className="py-2 px-3">/api/{'{module}'}/{'{id}'}</td>
                 <td className="py-2 px-3 text-[var(--text-secondary)]">.update</td>
               </tr>
               <tr className="bg-[var(--bg-secondary)]/50">
-                <td className="py-2 px-3"><span className="px-2 py-0.5 rounded bg-red-500/10 text-red-600">DELETE</span></td>
+                <td className="py-2 px-3"><span className="px-2 py-0.5 rounded bg-[var(--error-bg)] text-[var(--error-text)] border border-[var(--error-border)]">DELETE</span></td>
                 <td className="py-2 px-3">/api/{'{module}'}/{'{id}'}</td>
                 <td className="py-2 px-3 text-[var(--text-secondary)]">.delete</td>
               </tr>

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:

package/templates/skills/cli-app-sync/references/diff-entities.md

@@ -0,0 +1,162 @@
+# `/cli-app-sync diff-entities` — Reference
+
+> Detailed algorithm and rules for the `diff-entities` sub-mode of `/cli-app-sync`.
+
+## What it solves
+
+The default `cli-app-sync` mode compares **known file pairs** (Program.cs ↔ Program.cs.template, vite.config.ts ↔ inline `init.ts`, etc.). It is good at catching **explicit drift** in those known surfaces.
+
+It is blind to **trous** : when SmartStack.app introduces a brand-new entity (e.g. `AiTool` in v3.46) that no skill in `templates/skills/` mentions, nothing fires. The drift only surfaces during a manual audit (which is what just happened in the v3.46 alignment iteration 3 — 7 uncovered entities discovered by reading the `Domain/` directory by hand).
+
+`diff-entities` automates that audit : it enumerates every Domain entity and reports those without coverage in the CLI skills.
+
+## Inputs
+
+| Variable | Default | Source |
+|---|---|---|
+| `APP_PATH` | `D:/01 - projets/SmartStack.app/features/IA-Workflow` | `--app-path=...` flag, otherwise the IA-Workflow branch (current source of truth) |
+| `CLI_SKILLS` | `D:/01 - projets/SmartStack.cli/02-Develop/templates/skills` | hardcoded |
+| `MIN_REFS` | `3` | a "well-covered" entity has at least 3 mentions across templates |
+
+## Step-by-step algorithm
+
+### 1. Enumerate Domain entities (the haystack)
+
+Pattern (Bash + grep) :
+```bash
+APP_DOMAIN="$APP_PATH/src/SmartStack.Domain"
+
+grep -rPnh \
+  "^\s*public\s+(?:partial\s+)?(?:abstract\s+)?(?:class|record)\s+([A-Z][A-Za-z0-9]+)\s*:?\s*(?:BaseEntity|I[A-Z][A-Za-z]+Entity|IDomainEvent|DomainEvent)\b" \
+  "$APP_DOMAIN" --include='*.cs' \
+  | sed -E "s/.*\b(?:class|record)\s+([A-Z][A-Za-z0-9]+).*/\1/" \
+  | sort -u > /tmp/app-entities.txt
+```
+
+This captures :
+- Classes inheriting `BaseEntity` (most aggregate roots)
+- Classes implementing `IXxxEntity` interfaces (`ITenantEntity`, `IOptionalTenantEntity`, …)
+- Domain events (inheriting `DomainEvent` or implementing `IDomainEvent`)
+
+It deliberately excludes :
+- Pure value objects (no marker interface)
+- Internal helper classes
+- DTOs (those live in `Application/`)
+
+If you suspect an entity is missed, broaden the regex or add a manual entry in the exclusion list.
+
+### 2. Count references in CLI skills (the needles)
+
+For each entity name `E`, count how many `templates/skills/**/*.md|*.sh` files mention it as a whole word :
+
+```bash
+CLI_SKILLS="D:/01 - projets/SmartStack.cli/02-Develop/templates/skills"
+
+while IFS= read -r ENT; do
+  COUNT=$(grep -rl --include='*.md' --include='*.sh' -E "\\b${ENT}\\b" "$CLI_SKILLS" | wc -l)
+  echo -e "${ENT}\t${COUNT}"
+done < /tmp/app-entities.txt > /tmp/entity-coverage.tsv
+```
+
+Counting **distinct files** (not occurrences) is intentional — 50 mentions in one file ≈ 1 file with deep coverage, not 50 files of shallow coverage.
+
+### 3. Classify
+
+| Bucket | Rule | Action |
+|---|---|---|
+| `[NEW UNCOVERED]` | `count == 0` | Propose a skill destination (table below) |
+| `[THIN]` | `1 <= count < MIN_REFS` (default `MIN_REFS=3`) | Suggest extending an existing skill or adding a dedicated `references/` doc |
+| `[COVERED]` | `count >= MIN_REFS` | Hide from report unless `--verbose` |
+
+### 4. Suggest a skill destination
+
+Map the entity's namespace to a target skill :
+
+```python
+def suggest_skill(namespace, entity_name):
+    rules = [
+        ("Domain.AI.Evaluations",   "ai-prompt/references/eval-framework.md"),
+        ("Domain.AI.Tools",          "ai-prompt"),
+        ("Domain.AI.Agents",         "ai-prompt"),
+        ("Domain.AI.Skills",         "ai-prompt"),
+        ("Domain.AI",                "ai-prompt"),
+        ("Domain.Communications.Workflow",      "workflow"),
+        ("Domain.Communications.EmailTemplate", "notification"),
+        ("Domain.Communications",               "workflow"),
+        ("Domain.Navigation",                   "application"),
+        ("Domain.Platform.Administration.UiConfiguration", "application/references/themes-db-driven.md"),
+        ("Domain.Platform.Administration",      "application"),
+        ("Domain.Licensing",                    "apex/references/smartstack-api.md (Licensing section)"),
+        ("Domain.Common",                       "apex/references/smartstack-api.md"),
+        ("Domain.Support",                      "notification"),
+        ("Application.Common.Interfaces.Hooks", "apex/references/smartstack-api.md (Entity Lifecycle Hooks)"),
+    ]
+    for prefix, skill in rules:
+        if namespace.startswith(prefix):
+            return skill
+    return f"NEW SKILL — propose name based on namespace: {namespace.split('.')[-1].lower()}"
+```
+
+When the namespace doesn't match any rule, propose a brand-new skill name derived from the leaf segment.
+
+### 5. Render the report
+
+See the example output in `SKILL.md` (`<diff_entities_workflow>` section).
+
+Sort order : `[NEW UNCOVERED]` first, then `[THIN]`, then (only with `--verbose`) `[COVERED]`. Within each bucket, alphabetical.
+
+## Exclusion list
+
+Some entities are intentionally NOT documented by any skill — they are infrastructure plumbing the SDK abstracts away. Maintain this list manually :
+
+```
+EXCLUDED_ENTITIES = {
+    # Marker / framework types — not domain concepts
+    "DomainEvent",          # abstract base, not a concrete event
+    "BaseEntity",           # already documented in smartstack-api.md
+    "EntityScope",          # enum, documented inline
+
+    # Internal helpers — not part of the public SDK
+    # (add as needed)
+}
+```
+
+Implementation : after step 1, filter out names in this set before counting.
+
+## Output flags
+
+| Flag | Effect |
+|---|---|
+| `--verbose` | Show `[COVERED]` entities too (debugging) |
+| `--report-only` | Don't write cache, print to stdout only |
+| `--app-path=<path>` | Override the default APP_PATH (e.g. testing against `02-Develop` or another branch) |
+| `--min-refs=<n>` | Custom threshold for `[THIN]` vs `[COVERED]` (default 3) |
+| `--json` | Output machine-readable JSON instead of human report |
+
+## Exit code
+
+- 0 if zero entities classified `[NEW UNCOVERED]`
+- 1 otherwise (so `diff-entities` can be a CI quality gate)
+
+`[THIN]` entities do NOT fail the gate — they're warnings.
+
+## Performance
+
+- Step 1 (enumerate) : ~200-400 ms (grep over `Domain/` ≈ 100 files)
+- Step 2 (count) : ~2-5 s (grep over `templates/skills/` ≈ 350 files × N entities)
+- Total : < 10 s for a typical run — eligible for pre-commit hooks and CI
+
+## Limitations
+
+- **Heuristic regex for entity discovery** : may miss entities that don't follow the `class X : BaseEntity` pattern. Augment with explicit lookups for known patterns if false negatives appear.
+- **Word-boundary count** : `AiTool` matches `AiTool` exactly but also matches a `AiTool` mention in a code comment. Acceptable noise — the goal is to spot zero-reference entities.
+- **No DTO / Service coverage** : the skill only enumerates Domain entities. DTOs and Services live in `Application/` and are not in scope (they're typically auto-generated by MCP, so missing skill coverage is less impactful).
+- **Doesn't catch DELETED entities** : if an entity is removed from app but still cited in skills, this skill won't flag it. Use the existing `cli-app-sync report` for that direction.
+
+## Relation to other skills / checks
+
+- **`cli-app-sync report`** : detects **content drift** in known file pairs. Complementary, not redundant.
+- **`smoke-generation --quick`** : detects **broken imports** (the EntityLookup paradox). Catches references to things the CLI invented but the app doesn't have. `diff-entities` catches the inverse direction.
+- **`apex-verify`** : runs after generation, catches generated code that doesn't follow conventions. Operates at a different layer.
+
+Together, the trio `cli-app-sync report` + `cli-app-sync diff-entities` + `smoke-generation` covers the full bidirectional drift surface.

package/templates/skills/documentation/templates.md

@@ -116,7 +116,7 @@ import { Info } from 'lucide-react';
 
 function Annotation({ text }: { text: string }) {
   return (
-    <div className="flex items-start gap-2 p-2.5 rounded-lg bg-blue-500/5 border border-blue-500/15 text-sm text-blue-700 dark:text-blue-400">
+    <div className="flex items-start gap-2 p-2.5 rounded-lg bg-[var(--info-bg)] border border-[var(--info-border)] text-sm text-[var(--info-text)]">
       <Info className="w-4 h-4 mt-0.5 flex-shrink-0" />
       <span>{text}</span>
     </div>
@@ -168,7 +168,7 @@ import {
 // ═══════════════════════════════════════════════════
 function Annotation({ text }: { text: string }) {
   return (
-    <div className="flex items-start gap-2 p-2.5 rounded-lg bg-blue-500/5 border border-blue-500/15 text-sm text-blue-700 dark:text-blue-400">
+    <div className="flex items-start gap-2 p-2.5 rounded-lg bg-[var(--info-bg)] border border-[var(--info-border)] text-sm text-[var(--info-text)]">
       <Info className="w-4 h-4 mt-0.5 flex-shrink-0" />
       <span>{text}</span>
     </div>
@@ -231,14 +231,14 @@ export default function {Module}DocPage() {
         <div className="card p-6">
           <div className="mb-6">
             <h3 className="font-semibold mb-3 flex items-center gap-2">
-              <Target className="w-5 h-5 text-red-500" />
+              <Target className="w-5 h-5 text-[var(--error-text)]" />
               {t('sections.problem')}
             </h3>
             <p className="text-[var(--text-secondary)]">{t('problem')}</p>
           </div>
 
-          <div className="p-4 rounded-lg bg-green-500/10 border border-green-500/20">
-            <h3 className="font-semibold mb-2 flex items-center gap-2 text-green-700">
+          <div className="p-4 rounded-lg bg-[var(--success-bg)] border border-[var(--success-border)]">
+            <h3 className="font-semibold mb-2 flex items-center gap-2 text-[var(--success-text)]">
               <Lightbulb className="w-5 h-5" />
               {t('sections.solution')}
             </h3>
@@ -371,8 +371,8 @@ export default function {Module}DocPage() {
           {[1, 2, 3].map((i) => (
             <div key={i} className="card p-6">
               <div className="flex items-center gap-3 mb-4">
-                <div className="w-10 h-10 rounded-full bg-blue-500/10 flex items-center justify-center">
-                  <Users className="w-5 h-5 text-blue-600" />
+                <div className="w-10 h-10 rounded-full bg-[var(--accent-bg)] flex items-center justify-center">
+                  <Users className="w-5 h-5 text-[var(--accent-text)]" />
                 </div>
                 <div>
                   <div className="font-semibold">{t(`useCases.${i}.persona`)}</div>
@@ -384,8 +384,8 @@ export default function {Module}DocPage() {
                   <span className="font-medium text-[var(--text-secondary)]">Situation:</span>
                   <p>{t(`useCases.${i}.situation`)}</p>
                 </div>
-                <div className="text-sm p-3 rounded-lg bg-green-500/5 border border-green-500/15">
-                  <span className="font-medium text-green-600">Avec la fonctionnalite:</span>
+                <div className="text-sm p-3 rounded-lg bg-[var(--success-bg)] border border-[var(--success-border)]">
+                  <span className="font-medium text-[var(--success-text)]">Avec la fonctionnalite:</span>
                   <p>{t(`useCases.${i}.withFeature`)}</p>
                 </div>
               </div>
@@ -454,7 +454,7 @@ export default function {Module}DocPage() {
       <section id="reference" className="scroll-mt-4">
         <details className="card">
           <summary className="p-4 cursor-pointer hover:bg-[var(--bg-secondary)] rounded-lg font-semibold flex items-center gap-2">
-            <span className="w-8 h-8 rounded-full bg-gray-500/10 text-gray-600 flex items-center justify-center text-sm">9</span>
+            <span className="w-8 h-8 rounded-full bg-[var(--bg-tertiary)] text-[var(--text-secondary)] flex items-center justify-center text-sm">9</span>
             {t('sections.technicalRef')}
           </summary>
           <div className="p-6 pt-2 space-y-8">
@@ -499,12 +499,12 @@ export default function {Module}DocPage() {
                     {apiEndpoints.map((ep, i) => (
                       <tr key={i} className="border-b border-[var(--border-color)]">
                         <td className="py-2 px-3">
-                          <span className={`px-2 py-0.5 rounded text-xs font-medium ${
-                            ep.method === 'GET' ? 'bg-blue-500/10 text-blue-600' :
-                            ep.method === 'POST' ? 'bg-green-500/10 text-green-600' :
-                            ep.method === 'PUT' ? 'bg-orange-500/10 text-orange-600' :
-                            ep.method === 'PATCH' ? 'bg-purple-500/10 text-purple-600' :
-                            'bg-red-500/10 text-red-600'
+                          <span className={`px-2 py-0.5 rounded text-xs font-medium border ${
+                            ep.method === 'GET'    ? 'bg-[var(--info-bg)] text-[var(--info-text)] border-[var(--info-border)]' :
+                            ep.method === 'POST'   ? 'bg-[var(--success-bg)] text-[var(--success-text)] border-[var(--success-border)]' :
+                            ep.method === 'PUT'    ? 'bg-[var(--warning-bg)] text-[var(--warning-text)] border-[var(--warning-border)]' :
+                            ep.method === 'PATCH'  ? 'bg-[var(--accent-bg)] text-[var(--accent-text)] border-[var(--accent-border)]' :
+                                                     'bg-[var(--error-bg)] text-[var(--error-text)] border-[var(--error-border)]'
                           }`}>{ep.method}</span>
                         </td>
                         <td className="py-2 px-3 font-mono text-xs">{ep.path}</td>