@atlashub/smartstack-cli 1.14.3 → 1.17.0

package/templates/commands/efcore/db-status.md

@@ -12,13 +12,18 @@ model: haiku
 
 ---
 
-## STEP 1: Détecter Configuration
+## STEP 1: Détecter Configuration et DbContext
 
 ```bash
-detect_efcore_project
+detect_efcore_project   # Appelle detect_dbcontext() automatiquement
 detect_environment
+
+echo "DbContext: $DBCONTEXT ($DBCONTEXT_TYPE)"
+echo "Schema: $SCHEMA"
 ```
 
+**Si DbContext non détecté :** Afficher le status des DEUX contextes.
+
 ---
 
 ## STEP 2: Invoquer MCP
@@ -26,7 +31,10 @@ detect_environment
 ```json
 {
   "tool": "mcp__smartstack__check_migrations",
-  "parameters": { "branch": "<current_branch>" }
+  "parameters": {
+    "branch": "<current_branch>",
+    "projectPath": "<auto-detect>"
+  }
 }
 ```
 
@@ -37,7 +45,10 @@ Extraire: `migrations[]`, `conflicts[]`
 ## STEP 3: Tester Connexion
 
 ```bash
-CONNECTION_OK=$(dotnet ef database list 2>&1)
+CONNECTION_OK=$(dotnet ef database list \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" 2>&1)
 ```
 
 ---
@@ -45,8 +56,15 @@ CONNECTION_OK=$(dotnet ef database list 2>&1)
 ## STEP 4: Compter Migrations
 
 ```bash
-APPLIED=$(dotnet ef migrations list | grep -v "(Pending)" | wc -l)
-PENDING=$(dotnet ef migrations list | grep "(Pending)" | wc -l)
+APPLIED=$(dotnet ef migrations list \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" | grep -v "(Pending)" | wc -l)
+
+PENDING=$(dotnet ef migrations list \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" | grep "(Pending)" | wc -l)
 ```
 
 ---

package/templates/commands/efcore/migration.md

@@ -29,12 +29,31 @@ Options: `--force`, `--no-cross-check`, `--rebase-first`
 
 ---
 
-## STEP 1: Contexte Git
+## STEP 1: Contexte Git et DbContext
 
 ```bash
 CURRENT_BRANCH=$(git branch --show-current)
 # Extraire type (feature/hotfix/release) et nom
-detect_efcore_project
+detect_efcore_project   # Appelle detect_dbcontext() automatiquement
+
+echo "DbContext: $DBCONTEXT ($DBCONTEXT_TYPE)"
+echo "Schema: $SCHEMA"
+```
+
+**Si DbContext non détecté automatiquement :**
+
+```javascript
+AskUserQuestion({
+  questions: [{
+    question: "Quel DbContext utiliser pour cette migration ?",
+    header: "DbContext",
+    options: [
+      { label: "CoreDbContext", description: "Entités SmartStack (User, Role, Navigation...)" },
+      { label: "ExtensionsDbContext", description: "Entités client spécifiques" }
+    ],
+    multiSelect: false
+  }]
+})
 ```
 
 ---
@@ -68,32 +87,61 @@ AskUserQuestion({
 
 ---
 
-## STEP 4: Nom Migration
+## STEP 4: Nom Migration (via MCP)
+
+**OBLIGATOIRE : Utiliser le MCP pour le nommage conforme**
 
 Pattern: `{context}_v{version}_{sequence}_{Description}`
 
+**4.1 Demander la description à l'utilisateur :**
+
 ```javascript
 AskUserQuestion({
   questions: [{
-    question: "Description courte (ex: AddUserRoles)",
+    question: "Description courte de la migration (ex: Add User Roles)",
     header: "Description",
     options: [
-      { label: "Add", description: "Ajout tables/colonnes" },
-      { label: "Update", description: "Modification structure" },
-      { label: "Fix", description: "Correction schéma" },
-      { label: "Remove", description: "Suppression éléments" }
+      { label: "Add...", description: "Ajout tables/colonnes" },
+      { label: "Update...", description: "Modification structure" },
+      { label: "Fix...", description: "Correction schéma" },
+      { label: "Remove...", description: "Suppression éléments" }
     ],
     multiSelect: false
   }]
 })
+// L'utilisateur peut aussi saisir un texte libre
 ```
 
+**4.2 Appeler le MCP pour obtenir le nom conforme :**
+
+```javascript
+// $DESCRIPTION = réponse de l'utilisateur (ex: "Add User Roles")
+// $DBCONTEXT_TYPE = "core" ou "extensions" (de detect_dbcontext)
+
+mcp__smartstack__suggest_migration({
+  description: DESCRIPTION,
+  context: DBCONTEXT_TYPE
+})
+
+// Résultat: core_v1.8.0_001_AddUserRoles
+```
+
+> **INTERDIT :** Calculer le nom manuellement. Toujours déléguer au MCP.
+
 ---
 
 ## STEP 5: Création
 
 ```bash
-dotnet ef migrations add "$MIGRATION_NAME" -o Persistence/Migrations --verbose
+# $MIGRATION_NAME = résultat du MCP
+# $DBCONTEXT = CoreDbContext ou ExtensionsDbContext (de detect_dbcontext)
+
+dotnet ef migrations add "$MIGRATION_NAME" \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" \
+  -o Persistence/Migrations \
+  --verbose
 ```
 
 ---

package/templates/commands/efcore/rebase-snapshot.md

@@ -18,7 +18,29 @@ model: sonnet
 CURRENT_BRANCH=$(git branch --show-current)
 [[ ! $CURRENT_BRANCH =~ ^(feature|release|hotfix)/ ]] && exit 1
 [ -n "$(git status --porcelain)" ] && { echo "Working directory non clean"; exit 1; }
-detect_efcore_project
+
+# Détecte projet ET DbContext (core vs extensions)
+detect_efcore_project   # Appelle detect_dbcontext() automatiquement
+determine_base_branch   # Détermine la branche parente
+
+echo "DbContext: $DBCONTEXT ($DBCONTEXT_TYPE)"
+echo "Branche parente: $BASE_BRANCH"
+```
+
+**Si DbContext non détecté automatiquement :**
+
+```javascript
+AskUserQuestion({
+  questions: [{
+    question: "Quel DbContext utiliser ?",
+    header: "DbContext",
+    options: [
+      { label: "CoreDbContext", description: "Entités SmartStack" },
+      { label: "ExtensionsDbContext", description: "Entités client" }
+    ],
+    multiSelect: false
+  }]
+})
 ```
 
 ---
@@ -69,11 +91,42 @@ done
 
 ## STEP 6: Régénérer Migration Consolidée
 
+**OBLIGATOIRE : Utiliser le MCP pour le nommage conforme**
+
+```bash
+# Construire la description
+BRANCH_NAME_CLEAN=$(echo "$CURRENT_BRANCH" | sed 's|.*/||' | sed 's/-/ /g')
+DESCRIPTION="${BRANCH_NAME_CLEAN} Consolidated"
+```
+
+**Appel MCP OBLIGATOIRE :**
+
+```javascript
+// Obtenir le nom conforme via MCP
+mcp__smartstack__suggest_migration({
+  description: DESCRIPTION,           // Ex: "user auth Consolidated"
+  context: DBCONTEXT_TYPE             // "core" ou "extensions" (de detect_dbcontext)
+})
+
+// Résultat: core_v1.7.0_001_UserAuthConsolidated
+```
+
+**Puis créer la migration :**
+
 ```bash
-MIGRATION_NAME="${BRANCH_TYPE}_${VERSION}_${BRANCH_NAME}_Consolidated"
-dotnet ef migrations add "$MIGRATION_NAME" -o Persistence/Migrations --verbose
+# $MIGRATION_NAME = résultat du MCP
+# $DBCONTEXT = CoreDbContext ou ExtensionsDbContext
+
+dotnet ef migrations add "$MIGRATION_NAME" \
+  --context "$DBCONTEXT" \
+  --project "$INFRA_PROJECT" \
+  --startup-project "$STARTUP_PROJECT" \
+  -o Persistence/Migrations \
+  --verbose
 ```
 
+> **Convention :** `{context}_v{version}_{sequence}_{Description}` - Jamais de nom hardcodé
+
 ---
 
 ## STEP 7: Validation

package/templates/commands/efcore/squash.md

@@ -103,24 +103,50 @@ echo "Backup: $BACKUP_DIR"
 
 ---
 
-## STEP 4: Récupérer ModelSnapshot de la Branche Parente (CRUCIAL)
+## STEP 4: Récupérer Migrations ET Snapshot de la Branche Parente (CRUCIAL)
 
 ```bash
 # Sauvegarder snapshot actuel
 cp "$MIGRATIONS_DIR"/*ModelSnapshot.cs "$BACKUP_DIR/"
 
-# Récupérer le snapshot de la branche parente
+# Récupérer TOUTES les migrations de la branche parente
 git fetch origin "$BASE_BRANCH" --quiet
+
+# 1. Récupérer le ModelSnapshot
 git checkout "origin/$BASE_BRANCH" -- "$MIGRATIONS_DIR"/*ModelSnapshot.cs
 
-echo "ModelSnapshot récupéré depuis: origin/$BASE_BRANCH"
+# 2. Récupérer les fichiers de migration de la branche parente
+# (pour ne pas perdre les migrations déjà présentes sur develop/main)
+for base_mig in $BASE_MIGRATIONS; do
+  base_file=$(basename "$base_mig")
+  base_name="${base_file%.cs}"
+
+  # Récupérer le fichier migration ET son Designer
+  git checkout "origin/$BASE_BRANCH" -- "$MIGRATIONS_DIR/${base_name}.cs" 2>/dev/null || true
+  git checkout "origin/$BASE_BRANCH" -- "$MIGRATIONS_DIR/${base_name}.Designer.cs" 2>/dev/null || true
+done
+
+echo "Récupéré depuis origin/$BASE_BRANCH:"
+echo "  - ModelSnapshot"
+echo "  - $(echo "$BASE_MIGRATIONS" | wc -l) migrations"
 ```
 
 **Pourquoi c'est crucial:**
 - Le snapshot de `$BASE_BRANCH` contient l'état VALIDÉ et COMPLET
+- Les **migrations existantes** de `$BASE_BRANCH` doivent être conservées
 - Les migrations parallèles sur d'autres branches sont incluses
 - Évite la perte d'information de schéma (cf. [Bokio best practices](https://www.bokio.se/engineering-blog/how-to-squash-ef-core-migrations/))
 
+**Résultat attendu:**
+```
+feature/* après squash:
+├── Core_v1_9_0_001_InitialSchema.cs       ← De develop (conservé)
+├── Core_v1_9_0_001_InitialSchema.Designer.cs
+├── core_v1.0.0_001_FeatureConsolidated.cs ← Squash de la feature
+├── core_v1.0.0_001_FeatureConsolidated.Designer.cs
+└── CoreDbContextModelSnapshot.cs          ← De develop
+```
+
 ---
 
 ## STEP 5: Supprimer Migrations de la Branche (pas celles héritées)
@@ -139,29 +165,48 @@ echo "Supprimé: ${#BRANCH_ONLY_MIGRATIONS[@]} migrations"
 
 ## STEP 6: Créer Migration Consolidée
 
+**OBLIGATOIRE: Utiliser le MCP pour le nommage conforme**
+
 ```bash
-# Nommage selon contexte
+# Construire la description selon le contexte
 case "$BRANCH_TYPE" in
   feature)
-    BRANCH_NAME=$(echo "$CURRENT_BRANCH" | sed 's|feature/||')
-    MIGRATION_NAME="Feature_${BRANCH_NAME}_Consolidated"
+    BRANCH_NAME=$(echo "$CURRENT_BRANCH" | sed 's|feature/||' | sed 's/-/ /g')
+    DESCRIPTION="${BRANCH_NAME} Consolidated"
     ;;
   release)
-    VERSION=$(echo "$CURRENT_BRANCH" | sed 's|release/||' | tr '.' '_')
-    MIGRATION_NAME="Release_${VERSION}_Initial"
+    VERSION=$(echo "$CURRENT_BRANCH" | sed 's|release/||')
+    DESCRIPTION="Release ${VERSION} Initial"
     ;;
   hotfix)
-    VERSION=$(echo "$CURRENT_BRANCH" | sed 's|hotfix/||' | tr '.' '_')
-    MIGRATION_NAME="Hotfix_${VERSION}_Fix"
+    VERSION=$(echo "$CURRENT_BRANCH" | sed 's|hotfix/||')
+    DESCRIPTION="Hotfix ${VERSION} Fix"
     ;;
   develop)
-    MIGRATION_NAME="Develop_Consolidated_$(date +%Y%m%d)"
+    DESCRIPTION="Develop Consolidated"
     ;;
   *)
-    MIGRATION_NAME="Consolidated_$(date +%Y%m%d_%H%M%S)"
+    DESCRIPTION="Consolidated"
     ;;
 esac
+```
 
+**Appel MCP OBLIGATOIRE:**
+
+```javascript
+// Utiliser le MCP pour obtenir le nom conforme
+mcp__smartstack__suggest_migration({
+  description: DESCRIPTION,  // Ex: "multitenant Consolidated"
+  context: "core"            // ou "extensions" selon le projet
+})
+
+// Résultat: core_v1.0.0_001_MultitenantConsolidated
+```
+
+**Puis créer la migration:**
+
+```bash
+# MIGRATION_NAME = résultat du MCP (ex: core_v1.0.0_001_MultitenantConsolidated)
 dotnet ef migrations add "$MIGRATION_NAME" \
   --project "$INFRA_PROJECT" \
   --startup-project "$STARTUP_PROJECT" \
@@ -169,6 +214,8 @@ dotnet ef migrations add "$MIGRATION_NAME" \
   --verbose
 ```
 
+> **Convention:** `{context}_v{version}_{sequence}_{Description}` - Jamais de nom hardcodé
+
 ---
 
 ## STEP 7: Validation
@@ -192,11 +239,19 @@ dotnet ef migrations script --no-build --idempotent > /dev/null
 
 ```
 SQUASH - {CURRENT_BRANCH}
-  Base:       {BASE_BRANCH} (snapshot récupéré)
-  Backup:     {BACKUP_DIR}
-  Avant:      {MIGRATION_COUNT} migrations
-  Apres:      1 migration ({MIGRATION_NAME})
-  Conformite: EF Core CLI, Pas de .sql, Snapshot parent
+  Base:         {BASE_BRANCH}
+  Backup:       {BACKUP_DIR}
+
+  Récupéré de {BASE_BRANCH}:
+    - ModelSnapshot
+    - {BASE_MIGRATION_COUNT} migrations (conservées)
+
+  Consolidé:
+    - Avant:  {MIGRATION_COUNT} migrations (propres à la branche)
+    - Après:  1 migration ({MIGRATION_NAME})
+
+  Total final: {BASE_MIGRATION_COUNT + 1} migrations
+  Conformité:  MCP suggest_migration, EF Core CLI, Snapshot parent
 
 Prochains: /efcore:db-reset, /efcore:db-deploy, /gitflow:3-commit
 ```

package/templates/hooks/mcp-check.md

@@ -0,0 +1,64 @@
+---
+description: Quick MCP availability check before MCP tool calls
+trigger: tool-use
+match: mcp__smartstack__*
+blocking: false
+---
+
+# MCP Quick Check (Low Token)
+
+Lightweight pre-check before MCP calls. Reads cache only, no LLM processing.
+
+## Script
+
+```bash
+#!/bin/bash
+STATUS_FILE=".claude/mcp-status.json"
+MAX_AGE_DAYS=7
+
+# Create .claude if missing
+mkdir -p .claude
+
+# Check if status file exists
+if [ ! -f "$STATUS_FILE" ]; then
+  echo "⚠️ MCP: First use - run /mcp:healthcheck"
+  exit 0
+fi
+
+# Check file age (cross-platform)
+if command -v stat &> /dev/null; then
+  if [[ "$OSTYPE" == "darwin"* ]]; then
+    FILE_AGE=$(( ($(date +%s) - $(stat -f %m "$STATUS_FILE")) / 86400 ))
+  else
+    FILE_AGE=$(( ($(date +%s) - $(stat -c %Y "$STATUS_FILE")) / 86400 ))
+  fi
+
+  if [ "$FILE_AGE" -gt "$MAX_AGE_DAYS" ]; then
+    echo "⚠️ MCP: Cache expired ($FILE_AGE days) - run /mcp:healthcheck"
+  fi
+fi
+
+# Check last status
+STATUS=$(grep -o '"status":\s*"[^"]*"' "$STATUS_FILE" 2>/dev/null | cut -d'"' -f4)
+if [ "$STATUS" = "error" ]; then
+  echo "❌ MCP: Last check failed - run /mcp:healthcheck"
+  exit 1
+fi
+
+exit 0
+```
+
+## Behavior
+
+| Condition | Output | Blocks? |
+|-----------|--------|---------|
+| No cache file | Warning message | No |
+| Cache > 7 days | Warning message | No |
+| Last status = error | Error message | Yes |
+| All OK | Silent (no output) | No |
+
+## Token Cost
+
+- **Normal case (cache valid):** 0 tokens (pure bash, no LLM)
+- **Warning case:** ~10 tokens (displays message)
+- **Full healthcheck:** ~100-200 tokens (only when explicitly called)

package/templates/skills/application/SKILL.md

@@ -13,6 +13,39 @@ description: |
 
 **Reference:** [_shared.md](../_shared.md) for architecture, permissions, i18n
 
+## ENTRY POINT
+
+> **FIRST ACTION:** Load `steps/step-00-init.md`
+
+This skill uses progressive step loading. Each step calls MCP tools for generation.
+
+## STEP FILES
+
+| Step | File | MCP Tool Called |
+|------|------|-----------------|
+| 00 | `steps/step-00-init.md` | `validate_conventions` (MCP check) |
+| 01 | `steps/step-01-navigation.md` | `scaffold_navigation` |
+| 02 | `steps/step-02-permissions.md` | `generate_permissions` |
+| 03 | `steps/step-03-roles.md` | `scaffold_role_permissions` |
+| 04 | `steps/step-04-backend.md` | `scaffold_extension` |
+| 05 | `steps/step-05-frontend.md` | `scaffold_api_client`, `scaffold_routes` |
+| 06 | `steps/step-06-migration.md` | `suggest_migration` |
+
+## MCP INTEGRATION
+
+> **CRITICAL:** This skill MUST use MCP tools for all generation.
+> Templates in this folder are for REFERENCE ONLY - never use them directly.
+
+| MCP Tool | Purpose |
+|----------|---------|
+| `mcp__smartstack__scaffold_navigation` | Navigation entity + translations |
+| `mcp__smartstack__generate_permissions` | Permissions.cs + HasData |
+| `mcp__smartstack__scaffold_role_permissions` | Role-permission mappings |
+| `mcp__smartstack__scaffold_extension` | Entity, Service, Controller, DTOs |
+| `mcp__smartstack__scaffold_api_client` | TypeScript API client |
+| `mcp__smartstack__scaffold_routes` | React Router configuration |
+| `mcp__smartstack__suggest_migration` | Migration name suggestion |
+
 ## WHEN THIS SKILL ACTIVATES
 
 | Trigger | Example |
@@ -134,7 +167,20 @@ await _workflowService.TriggerAsync("{entity}.created", new Dictionary<string, o
 
 ## ASSOCIATED FILES
 
-- [templates-backend.md](templates-backend.md)
-- [templates-frontend.md](templates-frontend.md)
-- [templates-i18n.md](templates-i18n.md)
-- [templates-seed.md](templates-seed.md)
+### Step Files (ACTIVE - Use These)
+- [steps/step-00-init.md](steps/step-00-init.md) - Initialize parameters
+- [steps/step-01-navigation.md](steps/step-01-navigation.md) - Generate navigation
+- [steps/step-02-permissions.md](steps/step-02-permissions.md) - Generate permissions
+- [steps/step-03-roles.md](steps/step-03-roles.md) - Assign roles
+- [steps/step-04-backend.md](steps/step-04-backend.md) - Generate backend
+- [steps/step-05-frontend.md](steps/step-05-frontend.md) - Generate frontend
+- [steps/step-06-migration.md](steps/step-06-migration.md) - Create migration
+
+### Templates (REFERENCE ONLY - Do Not Use Directly)
+> These templates are kept for documentation purposes.
+> All generation is done via MCP tools in step files.
+
+- [templates-backend.md](templates-backend.md) - Backend patterns reference
+- [templates-frontend.md](templates-frontend.md) - Frontend patterns reference
+- [templates-i18n.md](templates-i18n.md) - i18n structure reference
+- [templates-seed.md](templates-seed.md) - Seed data patterns reference

package/templates/skills/application/steps/step-00-init.md

@@ -0,0 +1,153 @@
+---
+name: step-00-init
+description: Initialize application/module creation - parse parameters and validate context
+next_step: steps/step-01-navigation.md
+---
+
+# Step 0: Initialization
+
+## MANDATORY EXECUTION RULES
+
+- NEVER skip parameter validation
+- ALWAYS detect the navigation level from user request
+- ALWAYS validate MCP availability before proceeding
+- YOU ARE AN INITIALIZER, not an executor
+- FORBIDDEN to call MCP tools until init is complete
+
+## YOUR TASK
+
+Initialize the application/module creation by parsing parameters, detecting level, and validating the SmartStack context.
+
+---
+
+## EXECUTION SEQUENCE
+
+### 1. Detect Navigation Level
+
+From user request, identify the level:
+
+| Hint in Request | → Level | Parent Required |
+|-----------------|---------|-----------------|
+| "context", "workspace", "nouveau contexte" | context | No |
+| "application", "app", "nouvelle application" | application | Yes (context) |
+| "module", "feature", "nouveau module" | module | Yes (context.application) |
+| "section", "tab", "nouvelle section" | section | Yes (context.app.module) |
+
+### 2. Extract Parameters
+
+```yaml
+# Required
+level: context | application | module | section
+code: kebab-case (e.g., "products", "order-management")
+labels:
+  fr: "Label français"
+  en: "English label"
+  it: "Etichetta italiana"
+  de: "Deutsche Bezeichnung"
+icon: Lucide icon name (e.g., "Package", "ShoppingCart")
+displayOrder: number
+
+# Conditional (required for non-context levels)
+parentPath: "context.application.module" (dot-separated)
+```
+
+### 3. Validate MCP Availability
+
+**CRITICAL:** Before proceeding, verify SmartStack MCP is available:
+
+```
+Call: mcp__smartstack__validate_conventions
+Args: { checks: ["all"] }
+```
+
+If MCP call fails:
+- Display warning: "SmartStack MCP not available"
+- Provide manual instructions instead of automated generation
+- Do NOT proceed with step files
+
+### 4. Build Full Path
+
+```
+{full_path} = {parentPath}.{code}  (if parentPath exists)
+{full_path} = {code}               (if context level)
+
+Example:
+  level: module
+  parentPath: erp.sales
+  code: products
+  → full_path: erp.sales.products
+```
+
+### 5. Infer Descriptions (if not provided)
+
+```yaml
+descriptions:
+  fr: "Gestion de {labels.fr}"
+  en: "{labels.en} management"
+  it: "Gestione di {labels.it}"
+  de: "Verwaltung von {labels.de}"
+```
+
+### 6. Show Summary
+
+```
+## Application Skill: {level} - {code}
+
+| Parameter | Value |
+|-----------|-------|
+| Level | {level} |
+| Code | {code} |
+| Full Path | {full_path} |
+| Parent | {parentPath} |
+| Icon | {icon} |
+| Display Order | {displayOrder} |
+
+### Labels
+| Language | Label |
+|----------|-------|
+| FR | {labels.fr} |
+| EN | {labels.en} |
+| IT | {labels.it} |
+| DE | {labels.de} |
+
+→ Proceeding to navigation generation...
+```
+
+---
+
+## STATE VARIABLES TO PERSIST
+
+| Variable | Description |
+|----------|-------------|
+| `{level}` | context, application, module, or section |
+| `{code}` | kebab-case identifier |
+| `{full_path}` | Complete navigation path |
+| `{parent_path}` | Parent path (null for context) |
+| `{labels}` | Object with fr, en, it, de |
+| `{descriptions}` | Object with fr, en, it, de |
+| `{icon}` | Lucide icon name |
+| `{display_order}` | Numeric display order |
+| `{mcp_available}` | Boolean - MCP connectivity status |
+
+---
+
+## SUCCESS METRICS
+
+- Level correctly detected
+- All required parameters extracted
+- MCP availability verified
+- Full path computed correctly
+- Summary displayed
+- Proceeded to step-01-navigation.md
+
+## FAILURE MODES
+
+- Missing required parameters (ask user)
+- Invalid level detection (clarify with user)
+- MCP not available (provide manual instructions)
+
+---
+
+## NEXT STEP
+
+After showing initialization summary, proceed to `./step-01-navigation.md`