@atlashub/smartstack-cli 2.8.0 → 3.0.0

package/.documentation/business-analyse.html

@@ -12,7 +12,7 @@
         <header class="global-header">
             <div class="logo">SS</div>
             <span class="site-title">SmartStack CLI</span>
-            <span class="version-badge">v5.0.0</span>
+            <span class="version-badge">v6.0.0</span>
             <div class="header-divider"></div>
             <span class="page-title">Business Analyse</span>
             <nav class="breadcrumb">
@@ -24,7 +24,7 @@
                 <span data-lang="fr">Workflows</span>
                 <span data-lang="en">Workflows</span>
                 <span class="breadcrumb-separator">&#8250;</span>
-                <span class="breadcrumb-current">Business Analyse v5.0</span>
+                <span class="breadcrumb-current">Business Analyse v6.0</span>
             </nav>
             <!-- Language Select -->
             <select class="lang-select" id="lang-select" onchange="setLanguage(this.value); localStorage.setItem('doc-language', this.value);">
@@ -99,8 +99,8 @@
                             </a>
                             <a href="#quick-start" class="sidebar-toc-link">Quick Start</a>
                             <a href="#use-cases" class="sidebar-toc-link">
-                                <span data-lang="fr">4 Cas d'usage</span>
-                                <span data-lang="en">4 Use Cases</span>
+                                <span data-lang="fr">5 Cas d'usage</span>
+                                <span data-lang="en">5 Use Cases</span>
                             </a>
                             <a href="#flags" class="sidebar-toc-link">
                                 <span data-lang="fr">Flags &amp; Modes</span>
@@ -169,14 +169,14 @@
                     <section id="introduction">
                         <h2>Introduction</h2>
                         <p data-lang="fr">
-                            Le skill <strong>Business Analyse v5.0</strong> est un workflow en <strong>6 etapes</strong> qui transforme un besoin utilisateur en specification fonctionnelle complete avec support iteratif multi-module. Chaque application est composee de modules interdependants, analyzes et specifies dans un ordre logique.
+                            Le skill <strong>Business Analyse v6.0</strong> est un workflow en <strong>7 etapes</strong> qui transforme un besoin utilisateur en specification fonctionnelle complete avec support iteratif multi-module. La v6.0 ajoute un document HTML interactif pour la revue client et un pipeline d'extraction (<code>-x</code>) pour re-importer les modifications.
                         </p>
                         <p data-lang="en">
-                            The <strong>Business Analyse v5.0</strong> skill is a <strong>6-step</strong> workflow that transforms a user need into a complete functional specification with iterative multi-module support. Each application consists of interdependent modules, analyzed and specified in logical order.
+                            The <strong>Business Analyse v6.0</strong> skill is a <strong>7-step</strong> workflow that transforms a user need into a complete functional specification with iterative multi-module support. v6.0 adds an interactive HTML document for client review and an extraction pipeline (<code>-x</code>) to re-import modifications.
                         </p>
 
-                        <h4 data-lang="fr">6 Etapes du workflow</h4>
-                        <h4 data-lang="en">6 Workflow Steps</h4>
+                        <h4 data-lang="fr">7 Etapes du workflow</h4>
+                        <h4 data-lang="en">7 Workflow Steps</h4>
                         <ol class="steps-list">
                             <li>
                                 <strong>Init</strong> - Detecte le mode (application vs module), cree feature.json initial
@@ -194,7 +194,10 @@
                                 <strong>Consolidation</strong> - Validation cross-module, coherence des permissions et entites partagees
                             </li>
                             <li>
-                                <strong>Handoff</strong> - Mapping des fichiers par module, extraction programmatique prd.json via <code>ss derive-prd</code>
+                                <strong>Handoff</strong> - Mapping des fichiers par module, extraction programmatique prd.json via <code>ss derive-prd</code>, deploiement HTML interactif
+                            </li>
+                            <li>
+                                <strong>Extract</strong> - Import depuis l'export JSON du HTML interactif (<code>-x</code>), mapping vers feature.json
                             </li>
                         </ol>
 
@@ -267,10 +270,10 @@ Exemple:
                         </h2>
 
                         <p data-lang="fr">
-                            La v5.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 5 niveaux 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">
-                            v5.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 5-level hierarchy 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>
@@ -411,7 +414,10 @@ Exemple:
 /business-analyse -r FEAT-001 "Add return management module"
 
 # Micro-feature (analyse minimale)
-/business-analyse -m Add a status field to orders</code></pre>
+/business-analyse -m Add a status field to orders
+
+# Extract depuis HTML interactif
+/business-analyse -x ./docs/business/MyApp/ba-export.json</code></pre>
                                 </div>
                             </div>
                         </div>
@@ -422,8 +428,8 @@ Exemple:
                     <!-- ============================================ -->
                     <section id="use-cases">
                         <h2>
-                            <span data-lang="fr">4 Cas d'usage</span>
-                            <span data-lang="en">4 Use Cases</span>
+                            <span data-lang="fr">5 Cas d'usage</span>
+                            <span data-lang="en">5 Use Cases</span>
                         </h2>
 
                         <div class="table-container">
@@ -470,6 +476,12 @@ Exemple:
                                         <td><span data-lang="fr">module simple</span><span data-lang="en">simple module</span></td>
                                         <td>00 (micro) → 01 (lite) → 02 (skip) → 03 (minimal) → 04 (auto) → 05</td>
                                     </tr>
+                                    <tr>
+                                        <td><strong>Extract</strong></td>
+                                        <td><code>-x</code></td>
+                                        <td><span data-lang="fr">import HTML interactif</span><span data-lang="en">interactive HTML import</span></td>
+                                        <td>00 → 06 (extract) → <span data-lang="fr">choix</span><span data-lang="en">choice</span> (01 | 05 | EXIT)</td>
+                                    </tr>
                                 </tbody>
                             </table>
                         </div>
@@ -521,6 +533,14 @@ Exemple:
                                         </td>
                                         <td>false</td>
                                     </tr>
+                                    <tr>
+                                        <td><code>-x, --extract</code></td>
+                                        <td>
+                                            <span data-lang="fr">Importer depuis l'export JSON du HTML interactif</span>
+                                            <span data-lang="en">Import from interactive HTML JSON export</span>
+                                        </td>
+                                        <td>false</td>
+                                    </tr>
                                     <tr>
                                         <td><code>--economy-mode</code></td>
                                         <td>
@@ -546,13 +566,13 @@ Exemple:
                     <!-- WORKFLOW (6 STEPS)                            -->
                     <!-- ============================================ -->
                     <section id="workflow">
-                        <h2>Workflow (6 Etapes)</h2>
+                        <h2>Workflow (7 Etapes)</h2>
 
                         <p data-lang="fr">
-                            Le workflow v5.0 combine decouverte, decomposition, specification iterative et consolidation cross-module. Chaque etape enrichit progressivement le feature.json.
+                            Le workflow v6.0 combine decouverte, decomposition, specification iterative et consolidation cross-module. Chaque etape enrichit progressivement le feature.json.
                         </p>
                         <p data-lang="en">
-                            The v5.0 workflow combines discovery, decomposition, iterative specification and cross-module consolidation. Each step progressively enriches the feature.json.
+                            The v6.0 workflow combines discovery, decomposition, iterative specification and cross-module consolidation. Each step progressively enriches the feature.json.
                         </p>
                     </section>
 
@@ -849,6 +869,16 @@ Exemple:
 }</code></pre>
                         </div>
 
+                        <h4 data-lang="fr">Document HTML interactif</h4>
+                        <h4 data-lang="en">Interactive HTML Document</h4>
+
+                        <p data-lang="fr">
+                            A l'etape de handoff, un document HTML interactif (<code>ba-interactive.html</code>) est deploye dans le repertoire du projet. Ce document permet au client de consulter, modifier et enrichir l'analyse metier directement dans son navigateur, sans serveur. Les modifications peuvent etre re-importees via <code>/business-analyse -x &lt;json-path&gt;</code>.
+                        </p>
+                        <p data-lang="en">
+                            At the handoff step, an interactive HTML document (<code>ba-interactive.html</code>) is deployed to the project directory. This document allows the client to review, edit and enrich the business analysis directly in their browser, without a server. Modifications can be re-imported via <code>/business-analyse -x &lt;json-path&gt;</code>.
+                        </p>
+
                         <h4 data-lang="fr">Verification post-handoff</h4>
                         <h4 data-lang="en">Post-Handoff Verification</h4>
 
@@ -861,9 +891,42 @@ Exemple:
                             <li data-lang="en">Extract prd.json via <code>ss derive-prd</code></li>
                             <li data-lang="fr">Generer progress.txt tracker</li>
                             <li data-lang="en">Generate progress.txt tracker</li>
+                            <li data-lang="fr">Deployer ba-interactive.html avec placeholders remplaces</li>
+                            <li data-lang="en">Deploy ba-interactive.html with placeholders replaced</li>
                         </ul>
                     </section>
 
+                    <!-- ============================================ -->
+                    <!-- STEP 06 - EXTRACT                             -->
+                    <!-- ============================================ -->
+                    <section id="step-06">
+                        <h3>06. Extract</h3>
+
+                        <p data-lang="fr">
+                            Importe les donnees depuis l'export JSON du document HTML interactif (<code>ba-interactive.html</code>) et les transforme en feature.json. Cette etape est declenchee par le flag <code>-x</code>.
+                        </p>
+                        <p data-lang="en">
+                            Imports data from the interactive HTML document's JSON export (<code>ba-interactive.html</code>) and transforms it into feature.json. This step is triggered by the <code>-x</code> flag.
+                        </p>
+
+                        <h4 data-lang="fr">Principe</h4>
+                        <h4 data-lang="en">Principle</h4>
+
+                        <ul>
+                            <li data-lang="fr">Zero perte d'information : chaque champ du JSON exporte est mappe vers feature.json</li>
+                            <li data-lang="en">Zero information loss: every field from the exported JSON is mapped to feature.json</li>
+                            <li data-lang="fr">Mapping deterministe : cadrage, modules, specifications, consolidation</li>
+                            <li data-lang="en">Deterministic mapping: cadrage, modules, specifications, consolidation</li>
+                            <li data-lang="fr">Post-extraction : choix entre enrichir (step-01), handoff (step-05), ou terminer</li>
+                            <li data-lang="en">Post-extraction: choice between enrichment (step-01), handoff (step-05), or terminate</li>
+                        </ul>
+
+                        <div class="code-block">
+                            <button class="copy-btn">Copy</button>
+<pre><code>/business-analyse -x ./docs/business/MyApp/ba-export.json</code></pre>
+                        </div>
+                    </section>
+
                     <!-- ============================================ -->
                     <!-- SCHEMAS                                      -->
                     <!-- ============================================ -->
@@ -1065,6 +1128,7 @@ Module: "Checkout"
 <pre><code>docs/business/{app}/business-analyse/
 ├── v1.0/
 │   ├── feature.json              ← Master application spec
+│   ├── ba-interactive.html       ← Interactive client review document
 │   └── README.md                 ← Overview
 ├── checkout/v1.0/
 │   ├── feature.json              ← Module spec

package/dist/index.js

@@ -116538,6 +116538,30 @@ EndGlobal
   if (!dryRun) {
     await import_fs_extra5.default.ensureDir((0, import_path6.join)(apiDir, "wwwroot"));
   }
+  if (!dryRun) {
+    for (const { proj, type } of projects) {
+      if (type === "classlib") {
+        const class1Path = (0, import_path6.join)(srcDir, proj, "Class1.cs");
+        if (await import_fs_extra5.default.pathExists(class1Path)) {
+          await import_fs_extra5.default.remove(class1Path);
+          logger.info(`Removed placeholder: ${proj}/Class1.cs`);
+        }
+      }
+    }
+    const apiPlaceholders = [
+      "Program.cs",
+      "appsettings.json",
+      "appsettings.Development.json",
+      (0, import_path6.join)("Properties", "launchSettings.json")
+    ];
+    for (const placeholder of apiPlaceholders) {
+      const placeholderPath = (0, import_path6.join)(apiDir, placeholder);
+      if (await import_fs_extra5.default.pathExists(placeholderPath)) {
+        await import_fs_extra5.default.remove(placeholderPath);
+        logger.info(`Removed placeholder: ${projectName}.Api/${placeholder}`);
+      }
+    }
+  }
   const launchSettings = {
     $schema: "https://json.schemastore.org/launchsettings.json",
     profiles: {
@@ -116558,6 +116582,15 @@ EndGlobal
         environmentVariables: {
           ASPNETCORE_ENVIRONMENT: "Development"
         }
+      },
+      Local: {
+        commandName: "Project",
+        dotnetRunMessages: true,
+        launchBrowser: false,
+        applicationUrl: "https://localhost:7142;http://localhost:5142",
+        environmentVariables: {
+          ASPNETCORE_ENVIRONMENT: "Development"
+        }
       }
     }
   };
@@ -116572,24 +116605,6 @@ EndGlobal
     logSafeWriteResult(launchRelPath, launchResult);
     recordFile(state, "backend", launchRelPath, launchResult.hash);
   }
-  if (!dryRun) {
-    for (const { proj, type } of projects) {
-      if (type === "classlib") {
-        const class1Path = (0, import_path6.join)(srcDir, proj, "Class1.cs");
-        if (await import_fs_extra5.default.pathExists(class1Path)) {
-          await import_fs_extra5.default.remove(class1Path);
-          logger.info(`Removed placeholder: ${proj}/Class1.cs`);
-        }
-      }
-    }
-    for (const placeholder of ["appsettings.json", "appsettings.Development.json"]) {
-      const placeholderPath = (0, import_path6.join)(apiDir, placeholder);
-      if (await import_fs_extra5.default.pathExists(placeholderPath)) {
-        await import_fs_extra5.default.remove(placeholderPath);
-        logger.info(`Removed placeholder: ${projectName}.Api/${placeholder}`);
-      }
-    }
-  }
   if (!dryRun) {
     for (const { proj } of projects) {
       const csprojPath = (0, import_path6.join)(srcDir, proj, `${proj}.csproj`);
@@ -124821,6 +124836,26 @@ async function executeMigrations(projectDir, fromVersion, toVersion, dryRun) {
     hasErrors
   };
 }
+async function validateProgramCs(projectDir, baseNamespace) {
+  const programPath = (0, import_path7.join)(projectDir, "src", `${baseNamespace}.Api`, "Program.cs");
+  if (!await import_fs_extra6.default.pathExists(programPath)) {
+    return ["Program.cs not found"];
+  }
+  const content = await import_fs_extra6.default.readFile(programPath, "utf-8");
+  const requiredCalls = [
+    { pattern: /\.AddSmartStack\s*\(/, label: "AddSmartStack()" },
+    { pattern: /\.InitializeSmartStackAsync\s*\(/, label: "InitializeSmartStackAsync()" },
+    { pattern: /\.UseSmartStack\s*\(/, label: "UseSmartStack()" },
+    { pattern: /\.MapSmartStack\s*\(/, label: "MapSmartStack()" }
+  ];
+  const missing = [];
+  for (const { pattern, label } of requiredCalls) {
+    if (!pattern.test(content)) {
+      missing.push(label);
+    }
+  }
+  return missing;
+}
 async function syncAppSettings(projectDir, baseNamespace, dryRun) {
   const appSettingsPath = (0, import_path7.join)(projectDir, "src", `${baseNamespace}.Api`, "appsettings.json");
   if (!await import_fs_extra6.default.pathExists(appSettingsPath)) {
@@ -124858,7 +124893,8 @@ var upgradeCommand = new Command("upgrade").description("Upgrade SmartStack pack
     otherPkgFailed: 0,
     npmUpgraded: false,
     npmSkipped: false,
-    configSynced: 0
+    configSynced: 0,
+    programCsIssues: []
   };
   if (dryRun) {
     logger.warning("DRY RUN MODE - No packages will be upgraded");
@@ -125049,6 +125085,26 @@ var upgradeCommand = new Command("upgrade").description("Upgrade SmartStack pack
     logger.info(`appsettings.json ${source_default.green("\u2713")} up to date`);
     console.log();
   }
+  logger.info("Validating Program.cs...");
+  result.programCsIssues = await validateProgramCs(projectDir, config.baseNamespace);
+  if (result.programCsIssues.length > 0) {
+    logger.error("Program.cs is missing required SmartStack calls:");
+    for (const issue of result.programCsIssues) {
+      logger.warning(`  ${source_default.red("\u2717")} ${issue}`);
+    }
+    console.log();
+    logger.warning("Your Program.cs must contain these 4 calls in order:");
+    logger.info(`  1. builder.Services.${source_default.cyan("AddSmartStack")}(builder.Configuration);`);
+    logger.info(`  2. await app.${source_default.cyan("InitializeSmartStackAsync")}();`);
+    logger.info(`  3. app.${source_default.cyan("UseSmartStack")}();`);
+    logger.info(`  4. app.${source_default.cyan("MapSmartStack")}();`);
+    console.log();
+    logger.info(`Reference template: ${source_default.cyan("ss init --dry-run")} or check SmartStack docs`);
+    console.log();
+  } else {
+    logger.info(`Program.cs ${source_default.green("\u2713")} all SmartStack calls present`);
+    console.log();
+  }
   if (!dryRun && nugetVersion) {
     config.smartStackVersion = nugetVersion;
     const configPath = (0, import_path7.join)(projectDir, ".smartstack", "config.json");
@@ -125058,7 +125114,8 @@ var upgradeCommand = new Command("upgrade").description("Upgrade SmartStack pack
   }
   const totalChanged = result.nugetUpgraded + result.otherPkgUpdated + (result.npmUpgraded ? 1 : 0) + migrationSummary.totalApplied + result.configSynced;
   const allUpToDate = totalChanged === 0 && result.nugetFailed === 0 && result.otherPkgFailed === 0;
-  if (allUpToDate) {
+  const hasProgramIssues = result.programCsIssues.length > 0;
+  if (allUpToDate && !hasProgramIssues) {
     const summary = [
       source_default.green.bold("Already up to date!"),
       "",
@@ -125068,6 +125125,16 @@ var upgradeCommand = new Command("upgrade").description("Upgrade SmartStack pack
       "All packages at latest versions."
     ].filter(Boolean);
     logger.box(summary, "success");
+  } else if (allUpToDate && hasProgramIssues) {
+    const summary = [
+      source_default.yellow.bold("Packages up to date, but Program.cs needs attention!"),
+      "",
+      `  ${source_default.red("\u26A0")} Missing: ${result.programCsIssues.join(", ")}`,
+      "",
+      `  Fix: Ensure Program.cs contains all 4 SmartStack bootstrap calls`,
+      `  Ref: ${source_default.cyan("ss init --dry-run")} to see the correct template`
+    ];
+    logger.box(summary, "warning");
   } else {
     const lines = [
       source_default.green.bold("Upgrade completed!"),
@@ -125100,12 +125167,18 @@ var upgradeCommand = new Command("upgrade").description("Upgrade SmartStack pack
     if (result.configSynced > 0) {
       lines.push(`  ${source_default.green("\u2713")} Config: ${result.configSynced} new setting(s) added`);
     }
+    if (result.programCsIssues.length > 0) {
+      lines.push(`  ${source_default.red("\u26A0")} Program.cs: ${result.programCsIssues.length} missing call(s) - manual fix required`);
+    }
     lines.push("");
     lines.push(source_default.yellow("Next steps:"));
+    if (result.programCsIssues.length > 0) {
+      lines.push(`  ${source_default.red("!")} Fix Program.cs first (see warnings above)`);
+    }
     lines.push(`  1. Review changes: ${source_default.cyan("git diff")}`);
     lines.push(`  2. Test your application`);
     lines.push(`  3. Commit changes: ${source_default.cyan('git add . && git commit -m "chore: upgrade SmartStack to ' + nugetVersion + '"')}`);
-    logger.box(lines, "success");
+    logger.box(lines, result.programCsIssues.length > 0 ? "warning" : "success");
   }
 });