@atlashub/smartstack-cli 4.50.0 → 4.51.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlashub/smartstack-cli",
-  "version": "4.50.0",
+  "version": "4.51.0",
   "description": "SmartStack Claude Code automation toolkit - GitFlow, EF Core migrations, prompts and more",
   "author": {
     "name": "SmartStack",

package/templates/skills/apex/SKILL.md

@@ -171,6 +171,36 @@ Execute incremental SmartStack development using the APEX methodology. This skil
 
 </execution_rules>
 
+<execution_guarantee>
+
+## Execution Guarantee (CRITICAL — read before ANY step)
+
+> **The user is NOT watching. There is NOBODY to answer your questions. Stopping is a FAILURE.**
+
+When APEX runs (especially in `-d` delegate mode or `-a` auto mode), the execution is **fully autonomous**. The user has launched the command and walked away. Any pause, question, or numbered option list is a **dead end** — nobody will respond.
+
+**YOU MUST NOT:**
+- Stop to ask the user a question between layers
+- Present numbered options ("Would you like to: 1. Continue... 2. Generate... 3. Stop...")
+- Pause between layers to summarize progress and wait for confirmation
+- Stop because the work seems "large" or "complex" — that is expected
+- Add "Let me know if you want me to continue" at any point
+
+**YOU MUST:**
+- After Layer N completes, **IMMEDIATELY** load the next sub-step file. No pause, no summary, no question.
+- Execute the full pipeline: Layer 0 → Layer 1 → Layer 2 → Layer 3 → Layer 4 → step-04, with **ZERO pauses** between layers
+- Treat each "Load `steps/step-03X-...md`" instruction as a **mandatory immediate action**, not a suggestion
+- Continue even if a layer produced warnings (only a build gate failure after max retries is a valid stop)
+
+**The ONLY valid reasons to stop:**
+1. A build gate fails after maximum retries (3 attempts)
+2. ALL layers are completed and step-04 (eXamine) is done
+3. The user presses Ctrl+C
+
+**Anything else — including "being helpful" by asking — is a VIOLATION of the execution guarantee.**
+
+</execution_guarantee>
+
 <error_handling>
 
 ## Error Handling Strategy

package/templates/skills/apex/steps/step-03-execute.md

@@ -65,6 +65,13 @@ BEFORE starting Layer N:
 
 ## Layer Dispatch
 
+> **CRITICAL RULES — LAYER EXECUTION GUARANTEE**
+>
+> - **NEVER** stop between layers. NEVER ask the user. NEVER present numbered options between layers.
+> - The pipeline is sequential and mandatory: **0 → 1 → 2 → 3 → 4 → step-04**, with **ZERO pauses**.
+> - After each sub-step completes, IMMEDIATELY load the next one. No summary, no confirmation request.
+> - Stopping between layers is a **VIOLATION** of the execution guarantee defined in SKILL.md.
+
 Load each sub-step sequentially:
 
 | Layer | Sub-step | Content |

package/templates/skills/apex/steps/step-03a-layer0-domain.md

@@ -136,6 +136,9 @@ feat({module}): [domain+infra] {short description}
 
 ---
 
-## NEXT SUB-STEP
+## NEXT SUB-STEP (MANDATORY — IMMEDIATE)
+
+> **DO NOT STOP.** DO NOT ask the user. DO NOT present options. IMMEDIATELY load the next sub-step.
+> Stopping here is a VIOLATION of the execution guarantee.
 
 Load `steps/step-03b-layer1-seed.md`

package/templates/skills/apex/steps/step-03b-layer1-seed.md

@@ -254,6 +254,9 @@ feat({module}): [seed] navigation, permissions, roles
 
 ---
 
-## NEXT SUB-STEP
+## NEXT SUB-STEP (MANDATORY — IMMEDIATE)
+
+> **DO NOT STOP.** DO NOT ask the user. DO NOT present options. IMMEDIATELY load the next sub-step.
+> Stopping here is a VIOLATION of the execution guarantee.
 
 Load `steps/step-03c-layer2-backend.md`

package/templates/skills/apex/steps/step-03c-layer2-backend.md

@@ -348,6 +348,9 @@ test({module}): backend unit and integration tests
 
 ---
 
-## NEXT SUB-STEP
+## NEXT SUB-STEP (MANDATORY — IMMEDIATE)
+
+> **DO NOT STOP.** DO NOT ask the user. DO NOT present options. IMMEDIATELY load the next sub-step.
+> Stopping here is a VIOLATION of the execution guarantee.
 
 Load `steps/step-03d-layer3-frontend.md`

package/templates/skills/apex/steps/step-03d-layer3-frontend.md

@@ -329,6 +329,9 @@ test({module}): frontend form tests
 
 ---
 
-## NEXT SUB-STEP
+## NEXT SUB-STEP (MANDATORY — IMMEDIATE)
+
+> **DO NOT STOP.** DO NOT ask the user. DO NOT present options. IMMEDIATELY load the next sub-step.
+> Stopping here is a VIOLATION of the execution guarantee.
 
 Load `steps/step-03e-layer4-devdata.md`

package/templates/skills/business-analyse-html/html/ba-interactive.html

@@ -2394,6 +2394,13 @@ let data = {{FEATURE_DATA}};
 const ORIGINAL_DATA = JSON.parse(JSON.stringify(data));
 const EMBEDDED_ARTIFACTS = {{EMBEDDED_ARTIFACTS}};
 
+// CRITICAL: Initialize top-level structures FIRST to prevent TypeError crashes
+data.cadrage = data.cadrage || {};
+data.modules = data.modules || [];
+data.dependencies = data.dependencies || [];
+data.handoff = data.handoff || {};
+data.cadrage.stakeholders = data.cadrage.stakeholders || [];
+
 // Initialize applications array (multi-app support)
 data.applications = data.applications || [];
 

package/templates/skills/business-analyse-html/html/src/scripts/01-data-init.js

@@ -6,6 +6,13 @@ let data = {{FEATURE_DATA}};
 const ORIGINAL_DATA = JSON.parse(JSON.stringify(data));
 const EMBEDDED_ARTIFACTS = {{EMBEDDED_ARTIFACTS}};
 
+// CRITICAL: Initialize top-level structures FIRST to prevent TypeError crashes
+data.cadrage = data.cadrage || {};
+data.modules = data.modules || [];
+data.dependencies = data.dependencies || [];
+data.handoff = data.handoff || {};
+data.cadrage.stakeholders = data.cadrage.stakeholders || [];
+
 // Initialize applications array (multi-app support)
 data.applications = data.applications || [];
 

package/templates/skills/business-analyse-html/steps/step-02-build-data.md

@@ -242,6 +242,19 @@ if (errors.length > 0) {
 > If self-check detects errors, you MUST re-read the source data and re-build the failing moduleSpecs entries.
 > Do NOT proceed with empty arrays when source data exists.
 
+**dependencies[] (TOP-LEVEL — CRITICAL for HTML navigation):**
+```javascript
+dependencies: (master.consolidation?.crossModuleInteractions || master.dependencyGraph?.edges || []).map(i => ({
+  from: i.fromModule || i.from || "",
+  to: i.toModule || i.to || "",
+  description: i.description || ""
+}))
+```
+
+> **WARNING:** `data.dependencies` is used by the sidebar (navigation), module rendering, consolidation views,
+> handoff summary, and export. If this array is missing, the entire HTML page crashes with a TypeError.
+> ALWAYS include it, even if empty (`dependencies: []`).
+
 **consolidation:**
 ```javascript
 consolidation: {

package/templates/skills/business-analyse-html/steps/step-04-verify.md

@@ -69,6 +69,24 @@ FOR each module in FEATURE_DATA.modules:
     BLOCKING_ERROR("Module {module.code}: 0 businessRules in HTML but {sourceBRCount} in source")
 ```
 
+**Check 7 — No runtime crash (CRITICAL — validates page won't be blank):**
+```
+Open ba-interactive.html and search for the FEATURE_DATA JSON block.
+Verify these MANDATORY top-level fields exist:
+  - "modules": [...]          (array, can be empty)
+  - "dependencies": [...]     (array, can be empty)
+  - "cadrage": {...}          (object with stakeholders[], scope{})
+  - "moduleSpecs": {...}      (object, one key per module)
+  - "consolidation": {...}    (object)
+
+IF "dependencies" is missing from FEATURE_DATA:
+  Add: "dependencies": [] to the FEATURE_DATA object in the HTML
+  (This is the #1 cause of blank HTML pages — TypeError on data.dependencies.length crashes all JS)
+
+IF "modules" is missing:
+  BLOCKING_ERROR("FEATURE_DATA.modules missing — page will crash")
+```
+
 > **IF any check fails:** fix the issue and re-run the failing step before completing.
 
 ---