@atlashub/smartstack-cli 4.29.0 → 4.31.0

package/.documentation/business-analyse.html

@@ -122,6 +122,11 @@
                             <a href="#step-03" class="sidebar-toc-link">03. Specify (Per-Module)</a>
                             <a href="#step-04" class="sidebar-toc-link">04. Consolidation</a>
                             <a href="#step-05" class="sidebar-toc-link">05. Handoff</a>
+                            <a href="#step-06" class="sidebar-toc-link">06. Extract</a>
+                            <a href="#companion-skills" class="sidebar-toc-link">
+                                <span data-lang="fr">Skills complementaires</span>
+                                <span data-lang="en">Companion Skills</span>
+                            </a>
                             <a href="#schemas" class="sidebar-toc-link">Schemas</a>
                             <a href="#agents" class="sidebar-toc-link">Agents</a>
                             <a href="#ids-refs" class="sidebar-toc-link">
@@ -904,6 +909,31 @@ Exemple:
                             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>
 
+                        <div class="warning-block" style="background:rgba(255,170,0,0.1);border-left:4px solid #ffaa00;padding:1rem 1.2rem;border-radius:6px;margin:1rem 0;">
+                            <strong style="color:#ffaa00;">&#9888;
+                                <span data-lang="fr">Important : Source de verite</span>
+                                <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>.
+                            </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>.
+                            </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>
+                            </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>
+                            </p>
+                        </div>
+
                         <h4 data-lang="fr">Verification post-handoff</h4>
                         <h4 data-lang="en">Post-Handoff Verification</h4>
 
@@ -952,6 +982,193 @@ Exemple:
                         </div>
                     </section>
 
+                    <!-- ============================================ -->
+                    <!-- COMPANION SKILLS                              -->
+                    <!-- ============================================ -->
+                    <section id="companion-skills">
+                        <h2>
+                            <span data-lang="fr">Skills complementaires</span>
+                            <span data-lang="en">Companion Skills</span>
+                        </h2>
+
+                        <p data-lang="fr">
+                            Deux skills independants completent le workflow de business analyse pour la gestion du document HTML interactif.
+                        </p>
+                        <p data-lang="en">
+                            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>
+
+                        <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.
+                        </p>
+                        <p data-lang="en">
+                            Generates (or regenerates) the interactive HTML document from the analysis JSON files. This skill reads the JSON sources (<code>index.json</code>, <code>cadrage.json</code>, module files) and produces a standalone <code>ba-interactive.html</code> file.
+                        </p>
+
+                        <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>
+                        </div>
+
+                        <div class="table-container">
+                            <table class="reference-table">
+                                <thead>
+                                    <tr>
+                                        <th>Flag</th>
+                                        <th><span data-lang="fr">Effet</span><span data-lang="en">Effect</span></th>
+                                    </tr>
+                                </thead>
+                                <tbody>
+                                    <tr>
+                                        <td><code>--force</code></td>
+                                        <td><span data-lang="fr">Regenerer meme si le HTML existe deja</span><span data-lang="en">Regenerate even if HTML already exists</span></td>
+                                    </tr>
+                                </tbody>
+                            </table>
+                        </div>
+
+                        <h4><span data-lang="fr">Etapes internes</span><span data-lang="en">Internal Steps</span></h4>
+                        <div class="table-container">
+                            <table class="reference-table">
+                                <thead>
+                                    <tr>
+                                        <th>Step</th>
+                                        <th><span data-lang="fr">Role</span><span data-lang="en">Role</span></th>
+                                    </tr>
+                                </thead>
+                                <tbody>
+                                    <tr>
+                                        <td>01</td>
+                                        <td><span data-lang="fr">Lire les sources JSON (index, cadrage, modules, consolidation)</span><span data-lang="en">Read JSON sources (index, cadrage, modules, consolidation)</span></td>
+                                    </tr>
+                                    <tr>
+                                        <td>02</td>
+                                        <td><span data-lang="fr">Construire FEATURE_DATA + EMBEDDED_ARTIFACTS</span><span data-lang="en">Build FEATURE_DATA + EMBEDDED_ARTIFACTS</span></td>
+                                    </tr>
+                                    <tr>
+                                        <td>03</td>
+                                        <td><span data-lang="fr">Injecter dans le template ba-interactive.html</span><span data-lang="en">Inject into ba-interactive.html template</span></td>
+                                    </tr>
+                                    <tr>
+                                        <td>04</td>
+                                        <td><span data-lang="fr">Verification (taille &gt; 100KB, sections, coherence)</span><span data-lang="en">Verification (size &gt; 100KB, sections, coherence)</span></td>
+                                    </tr>
+                                </tbody>
+                            </table>
+                        </div>
+
+                        <div class="warning-block" style="background:rgba(255,170,0,0.1);border-left:4px solid #ffaa00;padding:1rem 1.2rem;border-radius:6px;margin:1rem 0;">
+                            <strong style="color:#ffaa00;">&#9888;
+                                <span data-lang="fr">Regeneration = ecrasement</span>
+                                <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.
+                            </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.
+                            </p>
+                        </div>
+
+                        <!-- /ba-review -->
+                        <h3><code>/ba-review</code></h3>
+
+                        <p data-lang="fr">
+                            Applique les corrections client exportees depuis le HTML interactif et regenere le document. Ce skill attend un fichier <code>ba-review.json</code> contenant les modifications structurees.
+                        </p>
+                        <p data-lang="en">
+                            Applies client corrections exported from the interactive HTML and regenerates the document. This skill expects a <code>ba-review.json</code> file containing structured modifications.
+                        </p>
+
+                        <div class="code-block">
+                            <button class="copy-btn">Copy</button>
+<pre><code>/ba-review</code></pre>
+                        </div>
+
+                        <h4><span data-lang="fr">Workflow</span><span data-lang="en">Workflow</span></h4>
+                        <ol>
+                            <li data-lang="fr">Lire <code>ba-review.json</code> (exporte depuis le HTML interactif)</li>
+                            <li data-lang="en">Read <code>ba-review.json</code> (exported from interactive HTML)</li>
+                            <li data-lang="fr">Lire le master <code>index.json</code> existant</li>
+                            <li data-lang="en">Read the existing master <code>index.json</code></li>
+                            <li data-lang="fr">Creer une nouvelle version</li>
+                            <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>
+                        </ol>
+
+                        <h4><span data-lang="fr">Routage des corrections</span><span data-lang="en">Correction Routing</span></h4>
+                        <div class="table-container">
+                            <table class="reference-table">
+                                <thead>
+                                    <tr>
+                                        <th><span data-lang="fr">Type de modification</span><span data-lang="en">Modification Type</span></th>
+                                        <th><span data-lang="fr">Action declenchee</span><span data-lang="en">Triggered Action</span></th>
+                                    </tr>
+                                </thead>
+                                <tbody>
+                                    <tr>
+                                        <td><span data-lang="fr">Entites / regles / UC / permissions</span><span data-lang="en">Entities / rules / UC / permissions</span></td>
+                                        <td><span data-lang="fr">Re-execution <code>/business-analyse</code> step-03</span><span data-lang="en">Re-run <code>/business-analyse</code> step-03</span></td>
+                                    </tr>
+                                    <tr>
+                                        <td><span data-lang="fr">Ecrans / wireframes / navigation</span><span data-lang="en">Screens / wireframes / navigation</span></td>
+                                        <td><span data-lang="fr">Re-execution <code>/ba-design-ui</code></span><span data-lang="en">Re-run <code>/ba-design-ui</code></span></td>
+                                    </tr>
+                                    <tr>
+                                        <td><span data-lang="fr">Les deux</span><span data-lang="en">Both</span></td>
+                                        <td><span data-lang="fr">Re-specification complete</span><span data-lang="en">Full re-specification</span></td>
+                                    </tr>
+                                    <tr>
+                                        <td><span data-lang="fr">Cadrage uniquement</span><span data-lang="en">Cadrage only</span></td>
+                                        <td><span data-lang="fr">Regeneration HTML uniquement</span><span data-lang="en">HTML regeneration only</span></td>
+                                    </tr>
+                                    <tr>
+                                        <td><span data-lang="fr">Client approuve</span><span data-lang="en">Client approves</span></td>
+                                        <td><code>/derive-prd</code></td>
+                                    </tr>
+                                </tbody>
+                            </table>
+                        </div>
+
+                        <!-- Workflow recap -->
+                        <h3><span data-lang="fr">Cycle de vie complet</span><span data-lang="en">Complete Lifecycle</span></h3>
+
+                        <div class="code-block">
+<pre><code><span data-lang="fr"># 1. Analyse initiale (genere les JSON + HTML)
+/business-analyse My Application Description
+
+# 2. Client consulte le HTML, fait des modifications, exporte le JSON
+
+# 3a. Re-import des modifications client dans les JSON sources
+/business-analyse -x ./docs/business/MyApp/ba-export.json
+
+# 3b. OU appliquer des corrections structurees
+/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 My Application Description
+
+# 2. Client reviews the HTML, makes modifications, exports JSON
+
+# 3a. Re-import client modifications into source JSONs
+/business-analyse -x ./docs/business/MyApp/ba-export.json
+
+# 3b. OR apply structured corrections
+/ba-review
+
+# 4. Regenerate HTML after JSON modifications
+/ba-generate-html FEAT-001</span></code></pre>
+                        </div>
+                    </section>
+
                     <!-- ============================================ -->
                     <!-- SCHEMAS                                      -->
                     <!-- ============================================ -->

package/dist/index.js

@@ -127501,8 +127501,10 @@ function detectSmartStackApp() {
   return null;
 }
 var adminCommand = new Command("admin").description("Admin account utilities");
-adminCommand.command("reset").description("Reset the localAdmin account password").option("-c, --connection <string>", "SQL Server connection string").option("-p, --path <path>", "Path to SmartStack.Api folder containing appsettings.json").option("-e, --email <email>", "Admin email address", DEFAULT_CONFIG.adminEmail).option("-f, --force", "Skip confirmation prompt").action(async (options) => {
-  logger.header("SmartStack Admin Reset");
+adminCommand.command("reset").description("Reset the localAdmin account password").option("-c, --connection <string>", "SQL Server connection string").option("-p, --path <path>", "Path to SmartStack.Api folder containing appsettings.json").option("-e, --email <email>", "Admin email address", DEFAULT_CONFIG.adminEmail).option("-f, --force", "Skip confirmation prompt").option("--json", "Output as JSON (machine-readable)").action(async (options) => {
+  if (!options.json) {
+    logger.header("SmartStack Admin Reset");
+  }
   let connectionString = options.connection || null;
   if (!connectionString) {
     const apiPath = options.path || detectSmartStackApp();
@@ -127548,8 +127550,10 @@ adminCommand.command("reset").description("Reset the localAdmin account password
   }
   const adminEmail = options.email;
   const connInfo = parseConnectionString(connectionString);
-  logger.info(`Server:   ${source_default.cyan(connInfo.server)}`);
-  logger.info(`Database: ${source_default.cyan(connInfo.database)}`);
+  if (!options.json) {
+    logger.info(`Server:   ${source_default.cyan(connInfo.server)}`);
+    logger.info(`Database: ${source_default.cyan(connInfo.database)}`);
+  }
   if (!options.force) {
     const { confirm } = await lib_default.prompt([
       {
@@ -127587,6 +127591,15 @@ adminCommand.command("reset").description("Reset the localAdmin account password
     displayPasswordResult(adminEmail, newPassword);
   };
   const displayPasswordResult = (email, password) => {
+    if (options.json) {
+      console.log(JSON.stringify({
+        email,
+        password,
+        server: connInfo.server,
+        database: connInfo.database
+      }));
+      return;
+    }
     console.log();
     console.log(source_default.green("\u2550".repeat(60)));
     console.log(source_default.green.bold("  LOCAL ADMINISTRATOR PASSWORD RESET"));