@atlashub/smartstack-cli 4.41.0 → 4.42.0

package/.documentation/apex.html

@@ -334,8 +334,8 @@
                                     <td colspan="1"></td>
                                     <td colspan="1">Init</td>
                                     <td colspan="1"></td>
-                                    <td data-lang="fr">Parser flags, détecter contexte, vérifier MCP, définir hiérarchie 5 niveaux, challenger besoin</td>
-                                    <td data-lang="en">Parse flags, detect context, verify MCP, define 5-level hierarchy, challenge need</td>
+                                    <td data-lang="fr">Parser flags, détecter contexte, vérifier MCP, définir hiérarchie 4 niveaux, challenger besoin</td>
+                                    <td data-lang="en">Parse flags, detect context, verify MCP, define 4-level hierarchy, challenge need</td>
                                 </tr>
                                 <tr style="background: #3b82f6; background: rgba(59, 130, 246, 0.1);">
                                     <td>01</td>

package/.documentation/business-analyse.html

@@ -103,8 +103,8 @@
                         <nav class="sidebar-toc">
                             <a href="#introduction" class="sidebar-toc-link">Introduction</a>
                             <a href="#architecture" class="sidebar-toc-link">
-                                <span data-lang="fr">Architecture (5-Niveaux)</span>
-                                <span data-lang="en">Architecture (5-Level Hierarchy)</span>
+                                <span data-lang="fr">Architecture (4-Niveaux)</span>
+                                <span data-lang="en">Architecture (4-Level Hierarchy)</span>
                             </a>
                             <a href="#quick-start" class="sidebar-toc-link">Quick Start</a>
                             <a href="#use-cases" class="sidebar-toc-link">
@@ -231,14 +231,13 @@
                             </li>
                         </ol>
 
-                        <h4 data-lang="fr">Navigation hierarchique (5 niveaux)</h4>
-                        <h4 data-lang="en">Hierarchical Navigation (5 Levels)</h4>
+                        <h4 data-lang="fr">Navigation hierarchique (4 niveaux)</h4>
+                        <h4 data-lang="en">Hierarchical Navigation (4 Levels)</h4>
                         <div class="code-block">
                             <button class="copy-btn">Copy</button>
-<pre><code>Context → Application → Module → Section → Resource
+<pre><code>Application → Module → Section → Resource
 
 Exemple:
-- Context: "ecommerce"
 - Application: "OrderManagement"
 - Module: "Checkout"
 - Section: "ShoppingCart" (page React)
@@ -291,19 +290,19 @@ Exemple:
                     </section>
 
                     <!-- ============================================ -->
-                    <!-- ARCHITECTURE (5-LEVEL HIERARCHY)              -->
+                    <!-- ARCHITECTURE (4-LEVEL HIERARCHY)              -->
                     <!-- ============================================ -->
                     <section id="architecture">
                         <h2>
-                            <span data-lang="fr">Architecture (Hierarchie 5-Niveaux)</span>
-                            <span data-lang="en">Architecture (5-Level Hierarchy)</span>
+                            <span data-lang="fr">Architecture (Hierarchie 4-Niveaux)</span>
+                            <span data-lang="en">Architecture (4-Level Hierarchy)</span>
                         </h2>
 
                         <p data-lang="fr">
-                            La v6.0 utilise une hierarchie 5 niveaux pour naviguer les applications multi-modules. Deux fichiers JSON (master application + per-module) garantissent la tracabilite et la coherence cross-module.
+                            La v6.0 utilise une hierarchie 4 niveaux (Application → Module → Section → Resource) pour naviguer les applications multi-modules. Deux fichiers JSON (master application + per-module) garantissent la tracabilite et la coherence cross-module.
                         </p>
                         <p data-lang="en">
-                            v6.0 uses a 5-level hierarchy to navigate multi-module applications. Two JSON files (master application + per-module) ensure traceability and cross-module coherence.
+                            v6.0 uses a 4-level hierarchy (Application → Module → Section → Resource) to navigate multi-module applications. Two JSON files (master application + per-module) ensure traceability and cross-module coherence.
                         </p>
 
                         <h4 data-lang="fr">Structure de repertoires</h4>
@@ -915,22 +914,22 @@ Exemple:
                                 <span data-lang="en">Important: Source of Truth</span>
                             </strong>
                             <p data-lang="fr" style="margin:0.5rem 0 0;">
-                                Le HTML interactif est un <strong>livrable genere</strong>, pas une source de donnees. La source de verite est constituee par les fichiers JSON (<code>index.json</code>, <code>cadrage.json</code>, <code>entities.json</code>, etc.). Toute modification faite directement dans le HTML sera <strong>ecrasee</strong> a la prochaine regeneration via <code>/ba-generate-html</code>.
+                                Le HTML interactif est un <strong>livrable genere</strong>, pas une source de donnees. La source de verite est constituee par les fichiers JSON (<code>index.json</code>, <code>cadrage.json</code>, <code>entities.json</code>, etc.). Toute modification faite directement dans le HTML sera <strong>ecrasee</strong> a la prochaine regeneration via <code>/business-analyse-html</code>.
                             </p>
                             <p data-lang="en" style="margin:0.5rem 0 0;">
-                                The interactive HTML is a <strong>generated deliverable</strong>, not a data source. The source of truth is the JSON files (<code>index.json</code>, <code>cadrage.json</code>, <code>entities.json</code>, etc.). Any modification made directly in the HTML will be <strong>overwritten</strong> on the next regeneration via <code>/ba-generate-html</code>.
+                                The interactive HTML is a <strong>generated deliverable</strong>, not a data source. The source of truth is the JSON files (<code>index.json</code>, <code>cadrage.json</code>, <code>entities.json</code>, etc.). Any modification made directly in the HTML will be <strong>overwritten</strong> on the next regeneration via <code>/business-analyse-html</code>.
                             </p>
                             <p data-lang="fr" style="margin:0.5rem 0 0;">
                                 <strong>Pour conserver vos modifications :</strong><br>
                                 1. Exporter le JSON depuis le HTML (bouton d'export)<br>
                                 2. Re-importer avec <code>/business-analyse -x &lt;json-path&gt;</code> (met a jour les fichiers JSON sources)<br>
-                                3. Regenerer le HTML avec <code>/ba-generate-html</code>
+                                3. Regenerer le HTML avec <code>/business-analyse-html</code>
                             </p>
                             <p data-lang="en" style="margin:0.5rem 0 0;">
                                 <strong>To preserve your modifications:</strong><br>
                                 1. Export JSON from the HTML (export button)<br>
                                 2. Re-import with <code>/business-analyse -x &lt;json-path&gt;</code> (updates source JSON files)<br>
-                                3. Regenerate the HTML with <code>/ba-generate-html</code>
+                                3. Regenerate the HTML with <code>/business-analyse-html</code>
                             </p>
                         </div>
 
@@ -998,8 +997,8 @@ Exemple:
                             Two independent skills complement the business analysis workflow for managing the interactive HTML document.
                         </p>
 
-                        <!-- /ba-generate-html -->
-                        <h3><code>/ba-generate-html</code></h3>
+                        <!-- /business-analyse-html -->
+                        <h3><code>/business-analyse-html</code></h3>
 
                         <p data-lang="fr">
                             Genere (ou regenere) le document HTML interactif a partir des fichiers JSON d'analyse. Ce skill lit les sources JSON (<code>index.json</code>, <code>cadrage.json</code>, fichiers modules) et produit un fichier <code>ba-interactive.html</code> autonome.
@@ -1010,8 +1009,8 @@ Exemple:
 
                         <div class="code-block">
                             <button class="copy-btn">Copy</button>
-<pre><code>/ba-generate-html FEAT-001
-/ba-generate-html FEAT-001 --force</code></pre>
+<pre><code>/business-analyse-html FEAT-001
+/business-analyse-html FEAT-001 --force</code></pre>
                         </div>
 
                         <div class="table-container">
@@ -1067,10 +1066,10 @@ Exemple:
                                 <span data-lang="en">Regeneration = overwrite</span>
                             </strong>
                             <p data-lang="fr" style="margin:0.5rem 0 0;">
-                                <code>/ba-generate-html</code> ecrase le HTML existant. Si vous avez fait des modifications dans le HTML interactif, exportez d'abord le JSON puis re-importez avec <code>/business-analyse -x</code> avant de regenerer.
+                                <code>/business-analyse-html</code> ecrase le HTML existant. Si vous avez fait des modifications dans le HTML interactif, exportez d'abord le JSON puis re-importez avec <code>/business-analyse -x</code> avant de regenerer.
                             </p>
                             <p data-lang="en" style="margin:0.5rem 0 0;">
-                                <code>/ba-generate-html</code> overwrites the existing HTML. If you made modifications in the interactive HTML, first export the JSON then re-import with <code>/business-analyse -x</code> before regenerating.
+                                <code>/business-analyse-html</code> overwrites the existing HTML. If you made modifications in the interactive HTML, first export the JSON then re-import with <code>/business-analyse -x</code> before regenerating.
                             </p>
                         </div>
 
@@ -1099,8 +1098,8 @@ Exemple:
                             <li data-lang="en">Create a new version</li>
                             <li data-lang="fr">Appliquer les corrections (cadrage, modules, consolidation)</li>
                             <li data-lang="en">Apply corrections (cadrage, modules, consolidation)</li>
-                            <li data-lang="fr">Regenerer le HTML via <code>/ba-generate-html</code></li>
-                            <li data-lang="en">Regenerate HTML via <code>/ba-generate-html</code></li>
+                            <li data-lang="fr">Regenerer le HTML via <code>/business-analyse-html</code></li>
+                            <li data-lang="en">Regenerate HTML via <code>/business-analyse-html</code></li>
                         </ol>
 
                         <h4><span data-lang="fr">Routage des corrections</span><span data-lang="en">Correction Routing</span></h4>
@@ -1153,7 +1152,7 @@ Exemple:
 /ba-review
 
 # 4. Regenerer le HTML apres modifications des JSON
-/ba-generate-html FEAT-001</span><span data-lang="en"># 1. Initial analysis (generates JSON + HTML)
+/business-analyse-html FEAT-001</span><span data-lang="en"># 1. Initial analysis (generates JSON + HTML)
 /business-analyse My Application Description
 
 # 2. Client reviews the HTML, makes modifications, exports JSON
@@ -1165,7 +1164,7 @@ Exemple:
 /ba-review
 
 # 4. Regenerate HTML after JSON modifications
-/ba-generate-html FEAT-001</span></code></pre>
+/business-analyse-html FEAT-001</span></code></pre>
                         </div>
                     </section>
 
@@ -1200,8 +1199,8 @@ Exemple:
                         <ul>
                             <li data-lang="fr">Metadata : module, version, featureType</li>
                             <li data-lang="en">Metadata: module, version, featureType</li>
-                            <li data-lang="fr">Sections &amp; Resources : 5-level navigation</li>
-                            <li data-lang="en">Sections &amp; Resources: 5-level navigation</li>
+                            <li data-lang="fr">Sections &amp; Resources : 4-level navigation</li>
+                            <li data-lang="en">Sections &amp; Resources: 4-level navigation</li>
                             <li data-lang="fr">Entities : domaine, attributs, constraints</li>
                             <li data-lang="en">Entities: domain, attributes, constraints</li>
                             <li data-lang="fr">Business Rules (BR-{CAT}-{PREFIX}-{NNN}) : validations metier</li>

package/.documentation/commands.html

@@ -182,7 +182,7 @@
                         </li>
                         <li>
                             <div class="step-content">
-                                <h5><code>/ba-design-ui</code> &rarr; <code>/ba-generate-html</code> &rarr; <code>/ba-review</code></h5>
+                                <h5><code>/ba-design-ui</code> &rarr; <code>/business-analyse-html</code> &rarr; <code>/ba-review</code></h5>
                                 <p data-lang="fr">Designer les ecrans, generer le livrable HTML interactif, iterer avec le client jusqu'a validation.</p>
                                 <p data-lang="en">Design screens, generate interactive HTML deliverable, iterate with client until validation.</p>
                             </div>
@@ -571,7 +571,7 @@
                         <pre><code data-lang="fr">Que voulez-vous faire ?
 │
 ├─ Nouveau projet complet
-│  └─ /business-analyse → /ba-design-ui → /ba-generate-html
+│  └─ /business-analyse → /ba-design-ui → /business-analyse-html
 │     → /ba-review → /derive-prd → /ralph-loop
 │
 ├─ Ajouter une feature a un projet existant
@@ -619,7 +619,7 @@
    └─ Finaliser                  → /gitflow finish</code><code data-lang="en">What do you want to do?
 │
 ├─ New complete project
-│  └─ /business-analyse → /ba-design-ui → /ba-generate-html
+│  └─ /business-analyse → /ba-design-ui → /business-analyse-html
 │     → /ba-review → /derive-prd → /ralph-loop
 │
 ├─ Add a feature to an existing project
@@ -944,7 +944,7 @@
                                     <td><a href="business-analyse.html">BA</a></td>
                                 </tr>
                                 <tr>
-                                    <td><code>/ba-generate-html</code></td>
+                                    <td><code>/business-analyse-html</code></td>
                                     <td>
                                         <span data-lang="fr">Generer le document HTML interactif (mockups, ERD, permissions)</span>
                                         <span data-lang="en">Generate interactive HTML document (mockups, ERD, permissions)</span>
@@ -975,10 +975,10 @@
                         <span class="alert-icon">&#128161;</span>
                         <div class="alert-content">
                             <p data-lang="fr">
-                                <strong>Pipeline complet</strong> : /business-analyse (steps 00-04) &rarr; /ba-design-ui &rarr; /ba-generate-html &rarr; /ba-review &rarr; /derive-prd &rarr; /ralph-loop
+                                <strong>Pipeline complet</strong> : /business-analyse (steps 00-04) &rarr; /ba-design-ui &rarr; /business-analyse-html &rarr; /ba-review &rarr; /derive-prd &rarr; /ralph-loop
                             </p>
                             <p data-lang="en">
-                                <strong>Full pipeline</strong>: /business-analyse (steps 00-04) &rarr; /ba-design-ui &rarr; /ba-generate-html &rarr; /ba-review &rarr; /derive-prd &rarr; /ralph-loop
+                                <strong>Full pipeline</strong>: /business-analyse (steps 00-04) &rarr; /ba-design-ui &rarr; /business-analyse-html &rarr; /ba-review &rarr; /derive-prd &rarr; /ralph-loop
                             </p>
                         </div>
                     </div>

package/dist/index.js

@@ -112873,7 +112873,7 @@ async function uninstallCommands(options = {}) {
             "quick-search.md",
             "review.md",
             "implement.md",
-            "ralph-loop"
+            "business-analyse-develop"
           ];
           for (const item of ourDirs) {
             const itemPath = (0, import_path2.join)(targetDir, item);
@@ -113474,7 +113474,7 @@ var installCommand = new Command("install").alias("i").description("Install Smar
       `  ${source_default.cyan("/efcore migration")}  - Migration management`,
       "",
       source_default.bold("Ralph Loop:"),
-      `  ${source_default.cyan("/ralph-loop")}        - Start iterative loop`,
+      `  ${source_default.cyan("/business-analyse-develop")}        - Start iterative loop`,
       ...ralphSummary,
       ...pluginSummary
     ];
@@ -116004,7 +116004,7 @@ var updateCommand = new Command("update").description("Update commands to the la
 // src/commands/docs.ts
 var import_path5 = require("path");
 var import_fs2 = require("fs");
-var DOCS_PAGES = ["index", "installation", "init", "commands", "cli-commands", "agents", "business-analyse", "gitflow", "efcore", "hooks", "ralph-loop", "test-web"];
+var DOCS_PAGES = ["index", "installation", "init", "commands", "cli-commands", "agents", "business-analyse", "gitflow", "efcore", "hooks", "business-analyse-develop", "test-web"];
 var docsCommand = new Command("docs").alias("d").description("Open SmartStack documentation in browser").argument("[page]", "Documentation page to open", "index").option("-l, --list", "List available documentation pages").action(async (page, options) => {
   if (options.list) {
     logger.header("Available Documentation Pages");
@@ -118022,7 +118022,7 @@ var initCommand = new Command("init").description("Initialize a new SmartStack p
       source_default.yellow("Ralph (AI Automation):"),
       `  1. Check MCP servers: ${source_default.cyan("smartstack check-mcp")}`,
       `  2. Verify Ralph setup: ${source_default.cyan("smartstack ralph start")}`,
-      `  3. Start automation: ${source_default.cyan('/ralph-loop "Your feature"')}`,
+      `  3. Start automation: ${source_default.cyan('/business-analyse-develop "Your feature"')}`,
       "",
       source_default.bold("Documentation:"),
       `  SmartStack: ${source_default.cyan("https://docs.smartstack.app")}`,
@@ -126840,7 +126840,7 @@ var ralphCommand = new Command("ralph").description("Ralph Weegund automation lo
   console.log(`  ${source_default.cyan("smartstack ralph report")}  - List or view feature reports`);
   console.log(`  ${source_default.cyan("smartstack ralph init")}    - Initialize Ralph in current project`);
   console.log();
-  console.log(`After running ${source_default.cyan("ralph start")}, use ${source_default.cyan("/ralph-loop")} in Claude Code.`);
+  console.log(`After running ${source_default.cyan("ralph start")}, use ${source_default.cyan("/business-analyse-develop")} in Claude Code.`);
 });
 ralphCommand.command("start").description("Verify prerequisites and prepare Ralph for use").option("--skip-mcp", "Skip MCP server verification (not recommended)").action(async (options) => {
   logger.header("Ralph Weegund - Pre-flight Check");
@@ -126920,7 +126920,7 @@ ralphCommand.command("start").description("Verify prerequisites and prepare Ralp
       "Ralph is ready!",
       "",
       "Start Ralph in Claude Code with:",
-      '  /ralph-loop "Your feature description"',
+      '  /business-analyse-develop "Your feature description"',
       "",
       "Or use BA orchestration:",
       "  /business-analyse:0-orchestrate"
@@ -127269,13 +127269,13 @@ var doctorCommand = new Command("doctor").description("Run diagnostics and check
     status: installation.gitflow.configExists ? "ok" : "info",
     message: installation.gitflow.configExists ? "Configured" : "Not configured"
   });
-  const ralphSkillPath = (0, import_path13.join)(installation.location, "skills", "ralph-loop", "SKILL.md");
+  const ralphSkillPath = (0, import_path13.join)(installation.location, "skills", "business-analyse-develop", "SKILL.md");
   const ralphSkillExists = await import_fs_extra13.default.pathExists(ralphSkillPath);
   diagnostics.push({
     name: "Ralph Skill",
     status: ralphSkillExists ? "ok" : "warning",
     message: ralphSkillExists ? "Installed" : "Not installed",
-    details: "Global skill (~/.claude/skills/ralph-loop/)",
+    details: "Global skill (~/.claude/skills/business-analyse-develop/)",
     fix: !ralphSkillExists ? "smartstack install" : void 0
   });
   const ralphStatus = await checkRalphInstallation();
@@ -127995,7 +127995,7 @@ mcpCommand.command("remove").description("Unregister MCP servers from CLI and VS
   logger.box(["MCP servers unregistered.", "", "Re-register with: ss mcp install"], "info");
 });
 
-// src/commands/derive-prd.ts
+// src/commands/business-analyse-handoff.ts
 var import_fs_extra15 = __toESM(require_lib());
 var import_path16 = require("path");
 
@@ -128514,6 +128514,17 @@ function validateForPrdExtraction(feature) {
   if (!feature.handoff?.filesToCreate) {
     errors.push("No filesToCreate found in handoff");
   }
+  const sections = feature.specification?.sections ?? [];
+  if (sections.length > 0) {
+    for (const section of sections) {
+      const resources = section.resources ?? [];
+      for (const resource of resources) {
+        if (!resource.entity) {
+          errors.push(`Section "${section.code}" resource "${resource.code}" is missing "entity" field \u2014 section-splitting will fail`);
+        }
+      }
+    }
+  }
   return errors;
 }
 function validatePrdCompleteness(prd, feature) {
@@ -128554,7 +128565,7 @@ function extractUnifiedPrd(moduleFeature, featureJsonPath, namespace, cliVersion
     seedData: prdJson.seedData,
     tasks,
     metadata: {
-      generatedBy: "ss-derive-prd",
+      generatedBy: "ss-business-analyse-handoff",
       cliVersion: cliVersion ?? "unknown",
       moduleCode: prdJson.project.module
     }
@@ -128782,7 +128793,7 @@ function toKebabCase(str) {
   return str.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
 }
 
-// src/commands/derive-prd.ts
+// src/commands/business-analyse-handoff.ts
 function readSmartStackNamespace() {
   try {
     const configPath = (0, import_path16.join)(process.cwd(), ".smartstack", "config.json");
@@ -128810,7 +128821,7 @@ async function findModuleFeatureFiles(masterPath) {
   }
   return paths;
 }
-var derivePrdCommand = new Command("derive-prd").description("Extract prd.json programmatically from feature.json or flat BA files (no LLM)").option("-f, --feature <path>", "Path to a module-level feature.json").option("-a, --application <path>", "Path to a master application-level feature.json (processes all modules)").option("--ba-dir <path>", "Path to a flat-file BA module directory (contains index.json, entities.json, etc.)").option("--ba-app <path>", "Path to an app-level BA index.json (discovers all modules)").option("-o, --output <path>", "Output path for prd.json (default: .ralph/prd-{module}.json)").option("--strict", "Fail on validation warnings").action(async (options) => {
+var businessAnalyseHandoffCommand = new Command("business-analyse-handoff").description("Extract prd.json programmatically from feature.json or flat BA files (no LLM)").option("-f, --feature <path>", "Path to a module-level feature.json").option("-a, --application <path>", "Path to a master application-level feature.json (processes all modules)").option("--ba-dir <path>", "Path to a flat-file BA module directory (contains index.json, entities.json, etc.)").option("--ba-app <path>", "Path to an app-level BA index.json (discovers all modules)").option("-o, --output <path>", "Output path for prd.json (default: .ralph/prd-{module}.json)").option("--strict", "Fail on validation warnings").action(async (options) => {
   if (!options.feature && !options.application && !options.baDir && !options.baApp) {
     console.log(source_default.red("Error: Provide --feature, --application, --ba-dir, or --ba-app"));
     process.exit(1);
@@ -129629,7 +129640,7 @@ async function main2() {
   program2.addCommand(doctorCommand);
   program2.addCommand(adminCommand);
   program2.addCommand(mcpCommand);
-  program2.addCommand(derivePrdCommand);
+  program2.addCommand(businessAnalyseHandoffCommand);
   program2.addCommand(tmuxCommand);
   const args = process.argv.slice(2);
   const commandName = args[0] || "";