@atlashub/smartstack-cli 4.80.0 → 5.0.0

package/templates/skills/check-version/SKILL.md

@@ -1,196 +1,196 @@
----
-name: check-version
-description: Verify version alignment between package.json and documentation
-context: fork
-agent: Explore
-model: haiku
-allowed-tools: Read, Glob, Grep, Bash
----
-
-## Current state (auto-injected)
-- Package version: !`node -p "require('./package.json').version" 2>/dev/null || echo "no package.json"`
-
-<objective>
-Verify that the version in `package.json` is aligned with all documentation files in `.documentation/`.
-Use before releases or as part of release process to ensure documentation is up-to-date.
-</objective>
-
-<quick_start>
-```bash
-/check-version            # Check version alignment (interactive)
-/check-version:fix        # Auto-update all doc files
-/check-version:report     # Detailed report without prompts
-```
-</quick_start>
-
-<subcommands>
-
-| Command | Description |
-|---------|-------------|
-| `/check-version` | Check alignment, prompt to fix if mismatches |
-| `/check-version:fix` | Auto-update documentation versions |
-| `/check-version:report` | Detailed report without prompts |
-
-</subcommands>
-
-<workflow>
-
-## Step 1: Read Package Version
-
-```bash
-PKG_VERSION=$(cat package.json | grep -oP '"version":\s*"\K[^"]+' | head -1)
-echo "Package version: $PKG_VERSION"
-```
-
-## Step 2: Scan Documentation Files
-
-```bash
-echo "Scanning documentation files..."
-
-for file in .documentation/*.html; do
-  if [ -f "$file" ]; then
-    DOC_VERSION=$(grep -oP 'version-badge">v?\K[^<]+' "$file" | head -1)
-    if [ -n "$DOC_VERSION" ]; then
-      FILENAME=$(basename "$file")
-      DOC_VERSION_CLEAN=${DOC_VERSION#v}
-
-      if [ "$DOC_VERSION_CLEAN" = "$PKG_VERSION" ]; then
-        echo "OK $FILENAME: v$DOC_VERSION_CLEAN"
-      else
-        echo "MISMATCH $FILENAME: v$DOC_VERSION_CLEAN (expected v$PKG_VERSION)"
-      fi
-    fi
-  fi
-done
-```
-
-## Step 3: Generate Report
-
-Display results:
-```
-================================================================================
-                    VERSION ALIGNMENT CHECK
-================================================================================
-
-Package version: vX.Y.Z
-Documentation files checked: N
-Mismatches found: M
-
-STATUS: PASSED | FAILED
-================================================================================
-```
-
-## Step 4: Handle Mismatches (Interactive)
-
-If mismatches detected, ask user:
-
-```yaml
-questions:
-  - header: "Fix versions"
-    question: "Des fichiers de documentation ont des versions obsoletes. Voulez-vous les mettre a jour automatiquement?"
-    options:
-      - label: "Oui, mettre a jour (Recommended)"
-        description: "Met a jour tous les fichiers avec la version actuelle"
-      - label: "Non, ignorer"
-        description: "Continuer sans corriger les versions"
-    multiSelect: false
-```
-
-</workflow>
-
-<fix_command>
-
-## /check-version:fix
-
-Auto-update all documentation files:
-
-```bash
-PKG_VERSION=$(cat package.json | grep -oP '"version":\s*"\K[^"]+' | head -1)
-
-echo "Updating documentation to v$PKG_VERSION..."
-
-UPDATED_COUNT=0
-
-for file in .documentation/*.html; do
-  if [ -f "$file" ]; then
-    DOC_VERSION=$(grep -oP 'version-badge">v?\K[^<]+' "$file" | head -1)
-    if [ -n "$DOC_VERSION" ]; then
-      DOC_VERSION_CLEAN=${DOC_VERSION#v}
-      if [ "$DOC_VERSION_CLEAN" != "$PKG_VERSION" ]; then
-        sed -i "s/version-badge\">v[^<]*/version-badge\">v$PKG_VERSION/" "$file"
-        UPDATED_COUNT=$((UPDATED_COUNT + 1))
-        echo "UPDATED $(basename "$file"): v$DOC_VERSION_CLEAN -> v$PKG_VERSION"
-      fi
-    fi
-  fi
-done
-
-echo ""
-if [ "$UPDATED_COUNT" -gt 0 ]; then
-  echo "OK $UPDATED_COUNT file(s) updated"
-  echo ""
-  echo "Next steps:"
-  echo "  1. Review changes: git diff .documentation/"
-  echo "  2. Commit: /gitflow commit"
-fi
-```
-
-</fix_command>
-
-<report_command>
-
-## /check-version:report
-
-Detailed report without prompts:
-
-```
-================================================================================
-         VERSION ALIGNMENT DETAILED REPORT
-================================================================================
-
-Package: @atlashub/smartstack-cli
-Current version: vX.Y.Z
-
----------------------------------------------------------------------
-FILE                          | DOC VERSION | STATUS
----------------------------------------------------------------------
-guide.html                    | vX.Y.Z      | OK
-api-reference.html            | vX.Y.Y      | MISMATCH
----------------------------------------------------------------------
-```
-
-</report_command>
-
-<gitflow_integration>
-
-This skill is automatically called during `/gitflow finish` for release branches.
-
-If mismatches detected during release finish:
-- Warning displayed
-- User prompted to fix with `/check-version:fix`
-- Release blocked until versions aligned
-
-</gitflow_integration>
-
-<files_checked>
-
-- `.documentation/*.html` - All HTML documentation files
-- Pattern: `<span class="version-badge">vX.Y.Z</span>`
-
-</files_checked>
-
-<exit_codes>
-
-| Code | Meaning |
-|------|---------|
-| 0 | All versions aligned |
-| 1 | Mismatches detected (blocking for releases) |
-
-</exit_codes>
-
-<success_criteria>
-- All version references compared against package.json version
-- Mismatches clearly listed with file path and current vs expected values
-- Exit code 0 when aligned, exit code 1 when mismatched
-- Fix subcommand updates all references successfully
-</success_criteria>
+---
+name: check-version
+description: Verify version alignment between package.json and documentation
+context: fork
+agent: Explore
+model: haiku
+allowed-tools: Read, Glob, Grep, Bash
+---
+
+## Current state (auto-injected)
+- Package version: !`node -p "require('./package.json').version" 2>/dev/null || echo "no package.json"`
+
+<objective>
+Verify that the version in `package.json` is aligned with all documentation files in `.documentation/`.
+Use before releases or as part of release process to ensure documentation is up-to-date.
+</objective>
+
+<quick_start>
+```bash
+/check-version            # Check version alignment (interactive)
+/check-version:fix        # Auto-update all doc files
+/check-version:report     # Detailed report without prompts
+```
+</quick_start>
+
+<subcommands>
+
+| Command | Description |
+|---------|-------------|
+| `/check-version` | Check alignment, prompt to fix if mismatches |
+| `/check-version:fix` | Auto-update documentation versions |
+| `/check-version:report` | Detailed report without prompts |
+
+</subcommands>
+
+<workflow>
+
+## Step 1: Read Package Version
+
+```bash
+PKG_VERSION=$(cat package.json | grep -oP '"version":\s*"\K[^"]+' | head -1)
+echo "Package version: $PKG_VERSION"
+```
+
+## Step 2: Scan Documentation Files
+
+```bash
+echo "Scanning documentation files..."
+
+for file in .documentation/*.html; do
+  if [ -f "$file" ]; then
+    DOC_VERSION=$(grep -oP 'version-badge">v?\K[^<]+' "$file" | head -1)
+    if [ -n "$DOC_VERSION" ]; then
+      FILENAME=$(basename "$file")
+      DOC_VERSION_CLEAN=${DOC_VERSION#v}
+
+      if [ "$DOC_VERSION_CLEAN" = "$PKG_VERSION" ]; then
+        echo "OK $FILENAME: v$DOC_VERSION_CLEAN"
+      else
+        echo "MISMATCH $FILENAME: v$DOC_VERSION_CLEAN (expected v$PKG_VERSION)"
+      fi
+    fi
+  fi
+done
+```
+
+## Step 3: Generate Report
+
+Display results:
+```
+================================================================================
+                    VERSION ALIGNMENT CHECK
+================================================================================
+
+Package version: vX.Y.Z
+Documentation files checked: N
+Mismatches found: M
+
+STATUS: PASSED | FAILED
+================================================================================
+```
+
+## Step 4: Handle Mismatches (Interactive)
+
+If mismatches detected, ask user:
+
+```yaml
+questions:
+  - header: "Fix versions"
+    question: "Des fichiers de documentation ont des versions obsoletes. Voulez-vous les mettre a jour automatiquement?"
+    options:
+      - label: "Oui, mettre a jour (Recommended)"
+        description: "Met a jour tous les fichiers avec la version actuelle"
+      - label: "Non, ignorer"
+        description: "Continuer sans corriger les versions"
+    multiSelect: false
+```
+
+</workflow>
+
+<fix_command>
+
+## /check-version:fix
+
+Auto-update all documentation files:
+
+```bash
+PKG_VERSION=$(cat package.json | grep -oP '"version":\s*"\K[^"]+' | head -1)
+
+echo "Updating documentation to v$PKG_VERSION..."
+
+UPDATED_COUNT=0
+
+for file in .documentation/*.html; do
+  if [ -f "$file" ]; then
+    DOC_VERSION=$(grep -oP 'version-badge">v?\K[^<]+' "$file" | head -1)
+    if [ -n "$DOC_VERSION" ]; then
+      DOC_VERSION_CLEAN=${DOC_VERSION#v}
+      if [ "$DOC_VERSION_CLEAN" != "$PKG_VERSION" ]; then
+        sed -i "s/version-badge\">v[^<]*/version-badge\">v$PKG_VERSION/" "$file"
+        UPDATED_COUNT=$((UPDATED_COUNT + 1))
+        echo "UPDATED $(basename "$file"): v$DOC_VERSION_CLEAN -> v$PKG_VERSION"
+      fi
+    fi
+  fi
+done
+
+echo ""
+if [ "$UPDATED_COUNT" -gt 0 ]; then
+  echo "OK $UPDATED_COUNT file(s) updated"
+  echo ""
+  echo "Next steps:"
+  echo "  1. Review changes: git diff .documentation/"
+  echo "  2. Commit: /gitflow commit"
+fi
+```
+
+</fix_command>
+
+<report_command>
+
+## /check-version:report
+
+Detailed report without prompts:
+
+```
+================================================================================
+         VERSION ALIGNMENT DETAILED REPORT
+================================================================================
+
+Package: @atlashub/smartstack-cli
+Current version: vX.Y.Z
+
+---------------------------------------------------------------------
+FILE                          | DOC VERSION | STATUS
+---------------------------------------------------------------------
+guide.html                    | vX.Y.Z      | OK
+api-reference.html            | vX.Y.Y      | MISMATCH
+---------------------------------------------------------------------
+```
+
+</report_command>
+
+<gitflow_integration>
+
+This skill is automatically called during `/gitflow finish` for release branches.
+
+If mismatches detected during release finish:
+- Warning displayed
+- User prompted to fix with `/check-version:fix`
+- Release blocked until versions aligned
+
+</gitflow_integration>
+
+<files_checked>
+
+- `.documentation/*.html` - All HTML documentation files
+- Pattern: `<span class="version-badge">vX.Y.Z</span>`
+
+</files_checked>
+
+<exit_codes>
+
+| Code | Meaning |
+|------|---------|
+| 0 | All versions aligned |
+| 1 | Mismatches detected (blocking for releases) |
+
+</exit_codes>
+
+<success_criteria>
+- All version references compared against package.json version
+- Mismatches clearly listed with file path and current vs expected values
+- Exit code 0 when aligned, exit code 1 when mismatched
+- Fix subcommand updates all references successfully
+</success_criteria>

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

@@ -9,8 +9,8 @@ allowed-tools: Read, Grep, Glob, Bash, Edit, Write
 ## Current state (auto-injected)
 - CLI version: !`node -p "require('./package.json').version" 2>/dev/null || echo "unknown"`
 - CLI branch: !`git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "unknown"`
-- App branch: !`git -C "D:/01 - projets/SmartStack.app/02-Develop" rev-parse --abbrev-ref HEAD 2>/dev/null || echo "unknown"`
-- App last commit: !`git -C "D:/01 - projets/SmartStack.app/02-Develop" log --oneline -1 2>/dev/null || echo "unknown"`
+- App branch: !`git -C "D:/01 - projets/SmartStack.app/features/IA-Workflow" rev-parse --abbrev-ref HEAD 2>/dev/null || echo "unknown"`
+- App last commit: !`git -C "D:/01 - projets/SmartStack.app/features/IA-Workflow" log --oneline -1 2>/dev/null || echo "unknown"`
 
 <objective>
 Detect drift between SmartStack.app (the platform / source of truth) and the CLI project templates used by `ss init`.
@@ -46,14 +46,14 @@ See [references/comparison-map.md](references/comparison-map.md) for the full fi
 
 **Source of truth (SmartStack.app):**
 ```
-APP_ROOT = D:/01 - projets/SmartStack.app/02-Develop
+APP_ROOT = D:/01 - projets/SmartStack.app/features/IA-Workflow
 APP_API  = $APP_ROOT/src/SmartStack.Api
 APP_WEB  = $APP_ROOT/web/smartstack-web
 ```
 
 **CLI templates (to validate):**
 ```
-CLI_ROOT      = D:/01 - projets/SmartStack.cli/02-Develop
+CLI_ROOT      = D:/01 - projets/SmartStack.cli/features/version-5-optimisation
 CLI_TEMPLATES = $CLI_ROOT/templates/project
 CLI_INIT      = $CLI_ROOT/src/commands/init.ts
 ```
@@ -65,8 +65,8 @@ CLI_INIT      = $CLI_ROOT/src/commands/init.ts
 ## Step 1: Resolve paths and verify access
 
 ```bash
-APP_ROOT="D:/01 - projets/SmartStack.app/02-Develop"
-CLI_ROOT="D:/01 - projets/SmartStack.cli/02-Develop"
+APP_ROOT="D:/01 - projets/SmartStack.app/features/IA-Workflow"
+CLI_ROOT="D:/01 - projets/SmartStack.cli/features/version-5-optimisation"
 
 # Verify both projects are accessible
 [ -d "$APP_ROOT/src/SmartStack.Api" ] || { echo "ERROR: SmartStack.app not found at $APP_ROOT"; exit 1; }
@@ -286,7 +286,7 @@ See [references/diff-entities.md](references/diff-entities.md) for the full algo
 
 2. **Enumerate entities referenced in CLI skills** :
    ```bash
-   CLI_SKILLS="D:/01 - projets/SmartStack.cli/02-Develop/templates/skills"
+   CLI_SKILLS="D:/01 - projets/SmartStack.cli/features/version-5-optimisation/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)
@@ -310,8 +310,8 @@ See [references/diff-entities.md](references/diff-entities.md) for the full algo
    | `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.Licensing.*` | `conventions` (Licensing section) |
+   | `Domain.Common.*` (interfaces, enums) | `conventions` |
    | `Domain.Support.*` | `notification` (or new skill) |
    | other | propose a new skill name based on the namespace |
 

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

@@ -7,10 +7,10 @@
 
 | Alias | Path |
 |---|---|
-| `APP_API` | `D:/01 - projets/SmartStack.app/02-Develop/src/SmartStack.Api` |
-| `APP_WEB` | `D:/01 - projets/SmartStack.app/02-Develop/web/smartstack-web` |
-| `CLI_TPL` | `D:/01 - projets/SmartStack.cli/02-Develop/templates/project` |
-| `CLI_INIT` | `D:/01 - projets/SmartStack.cli/02-Develop/src/commands/init.ts` |
+| `APP_API` | `D:/01 - projets/SmartStack.app/features/IA-Workflow/src/SmartStack.Api` |
+| `APP_WEB` | `D:/01 - projets/SmartStack.app/features/IA-Workflow/web/smartstack-web` |
+| `CLI_TPL` | `D:/01 - projets/SmartStack.cli/features/version-5-optimisation/templates/project` |
+| `CLI_INIT` | `D:/01 - projets/SmartStack.cli/features/version-5-optimisation/src/commands/init.ts` |
 
 ---
 

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

@@ -15,7 +15,7 @@ It is blind to **trous** : when SmartStack.app introduces a brand-new entity (e.
 | 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 |
+| `CLI_SKILLS` | `D:/01 - projets/SmartStack.cli/features/version-5-optimisation/templates/skills` | hardcoded |
 | `MIN_REFS` | `3` | a "well-covered" entity has at least 3 mentions across templates |
 
 ## Step-by-step algorithm
@@ -50,7 +50,7 @@ If you suspect an entity is missed, broaden the regex or add a manual entry in t
 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"
+CLI_SKILLS="D:/01 - projets/SmartStack.cli/features/version-5-optimisation/templates/skills"
 
 while IFS= read -r ENT; do
   COUNT=$(grep -rl --include='*.md' --include='*.sh' -E "\\b${ENT}\\b" "$CLI_SKILLS" | wc -l)
@@ -86,10 +86,10 @@ def suggest_skill(namespace, entity_name):
         ("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.Licensing",                    "conventions (Licensing section)"),
+        ("Domain.Common",                       "conventions"),
         ("Domain.Support",                      "notification"),
-        ("Application.Common.Interfaces.Hooks", "apex/references/smartstack-api.md (Entity Lifecycle Hooks)"),
+        ("Application.Common.Interfaces.Hooks", "conventions (Entity Lifecycle Hooks)"),
     ]
     for prefix, skill in rules:
         if namespace.startswith(prefix):
@@ -156,7 +156,7 @@ Implementation : after step 1, filter out names in this set before counting.
 ## 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.
+- **`smoke-generation --quick`** : detects **broken imports** (historically the EntityLookup paradox, now resolved by the `ui-primitives` scaffolder; the detector remains for future paradoxes of the same shape). Catches references to things the CLI documents but neither `SmartStack.app` SDK nor the CLI's local primitive scaffolders provide. `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/conventions/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: conventions
+description: SmartStack global conventions — DB schemas, prefixes, namespaces
+group: E
+allowed-tools: [Read, Glob, Grep]
+---
+
+# Skill: SmartStack Conventions
+
+> Global conventions: DB schemas, prefixes, namespaces.
+
+## DB Schemas
+
+| Schema | Usage |
+|--------|-------|
+| `core` | SmartStack platform tables |
+| `extensions` | Client/extensions tables |
+
+## Domain Table Prefixes
+
+| Prefix | Domain |
+|--------|--------|
+| `auth_` | Authorization (Users, Roles, Permissions) |
+| `nav_` | Navigation (Applications, Modules, Sections) |
+| `usr_` | User profiles |
+| `ai_` | AI features |
+| `cfg_` | Configuration |
+| `wkf_` | Workflows |
+| `support_` | Support tickets |
+| `ref_` | References |
+| `loc_` | Localization |
+| `lic_` | Licensing |
+| `tenant_` | Multi-tenancy |
+
+Custom applications: 2-5 letter prefix (`crm_`, `rh_`, `fi_`).
+
+## Namespaces
+
+```
+{App}.Domain.Entities.{Module}/
+{App}.Application.DTOs.{Module}/
+{App}.Application.Services.{Module}/
+{App}.Infrastructure.Repositories.{Module}/
+{App}.Api.Controllers.{Module}/
+```
+
+## Service Naming
+
+| Type | Pattern |
+|------|---------|
+| Interface | `I{Resource}Service` |
+| Implementation | `{Resource}Service` |
+| Repo interface | `I{Resource}Repository` |
+| Repo implementation | `{Resource}Repository` |
+
+## Migrations
+
+Format: `{context}_v{version}_{seq}_{Description}`
+
+## Frontend
+
+- Layout: no `max-w-*`, standard padding `lg:px-10`
+- Tabs: `useTabNavigation` hook, URL sync `?tab=name`, lazy load
+- Breadcrumb: `<Breadcrumb items={[...]}/>` as first element