@atlashub/smartstack-cli 2.9.0 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (90) hide show
  1. package/.documentation/agents.html +1 -371
  2. package/.documentation/business-analyse.html +81 -17
  3. package/.documentation/cli-commands.html +1 -1
  4. package/.documentation/commands.html +1 -1
  5. package/.documentation/efcore.html +1 -1
  6. package/.documentation/gitflow.html +1 -1
  7. package/.documentation/hooks.html +27 -66
  8. package/.documentation/index.html +166 -166
  9. package/.documentation/init.html +6 -7
  10. package/.documentation/installation.html +1 -1
  11. package/.documentation/ralph-loop.html +1 -9
  12. package/.documentation/test-web.html +15 -39
  13. package/dist/index.js +23 -16
  14. package/dist/index.js.map +1 -1
  15. package/dist/mcp-entry.mjs +1302 -223
  16. package/dist/mcp-entry.mjs.map +1 -1
  17. package/package.json +1 -1
  18. package/templates/agents/efcore/db-deploy.md +1 -1
  19. package/templates/agents/efcore/migration.md +26 -10
  20. package/templates/agents/efcore/rebase-snapshot.md +24 -7
  21. package/templates/agents/efcore/squash.md +73 -57
  22. package/templates/agents/gitflow/commit.md +138 -18
  23. package/templates/agents/gitflow/exec.md +1 -1
  24. package/templates/agents/gitflow/finish.md +79 -62
  25. package/templates/agents/gitflow/init-clone.md +186 -0
  26. package/templates/agents/gitflow/init-detect.md +137 -0
  27. package/templates/agents/gitflow/init-validate.md +210 -0
  28. package/templates/agents/gitflow/init.md +231 -74
  29. package/templates/agents/gitflow/merge.md +115 -33
  30. package/templates/agents/gitflow/pr.md +151 -46
  31. package/templates/agents/gitflow/start.md +76 -33
  32. package/templates/agents/gitflow/status.md +41 -71
  33. package/templates/hooks/appsettings-guard.sh +76 -0
  34. package/templates/hooks/ef-migration-check.md +1 -1
  35. package/templates/hooks/hooks.json +9 -0
  36. package/templates/project/appsettings.json.template +8 -2
  37. package/templates/project/test-frontend/msw/handlers.ts +58 -0
  38. package/templates/project/test-frontend/msw/server.ts +25 -0
  39. package/templates/project/test-frontend/setup.ts +16 -0
  40. package/templates/project/test-frontend/test-utils.tsx +59 -0
  41. package/templates/project/test-frontend/vitest.config.ts +31 -0
  42. package/templates/skills/_resources/config-safety.md +61 -0
  43. package/templates/skills/_resources/formatting-guide.md +2 -2
  44. package/templates/skills/application/SKILL.md +12 -3
  45. package/templates/skills/application/steps/step-04-backend.md +21 -0
  46. package/templates/skills/application/steps/step-07-tests.md +259 -120
  47. package/templates/skills/business-analyse/SKILL.md +57 -28
  48. package/templates/skills/business-analyse/_shared.md +70 -39
  49. package/templates/skills/business-analyse/html/ba-interactive.html +2596 -0
  50. package/templates/skills/business-analyse/questionnaire/00-application.md +123 -131
  51. package/templates/skills/business-analyse/questionnaire/01-context.md +173 -24
  52. package/templates/skills/business-analyse/questionnaire/02-stakeholders.md +170 -50
  53. package/templates/skills/business-analyse/questionnaire/03-scope.md +154 -48
  54. package/templates/skills/business-analyse/questionnaire/10-documentation.md +1 -1
  55. package/templates/skills/business-analyse/questionnaire/14-risk-assumptions.md +135 -0
  56. package/templates/skills/business-analyse/questionnaire/15-success-metrics.md +136 -0
  57. package/templates/skills/business-analyse/questionnaire.md +55 -46
  58. package/templates/skills/business-analyse/steps/step-00-init.md +24 -2
  59. package/templates/skills/business-analyse/steps/step-01-cadrage.md +31 -20
  60. package/templates/skills/business-analyse/steps/step-03-specify.md +58 -0
  61. package/templates/skills/business-analyse/steps/step-05-handoff.md +301 -1
  62. package/templates/skills/business-analyse/steps/step-06-extract.md +518 -0
  63. package/templates/skills/check-version/SKILL.md +1 -1
  64. package/templates/skills/efcore/steps/db/step-deploy.md +22 -3
  65. package/templates/skills/efcore/steps/db/step-reset.md +27 -4
  66. package/templates/skills/efcore/steps/db/step-seed.md +46 -2
  67. package/templates/skills/efcore/steps/db/step-status.md +14 -0
  68. package/templates/skills/efcore/steps/migration/step-01-check.md +31 -5
  69. package/templates/skills/efcore/steps/migration/step-02-create.md +20 -4
  70. package/templates/skills/efcore/steps/rebase-snapshot/step-03-create.md +60 -0
  71. package/templates/skills/efcore/steps/shared/step-00-init.md +47 -8
  72. package/templates/skills/efcore/steps/squash/step-03-create.md +27 -5
  73. package/templates/skills/gitflow/SKILL.md +91 -29
  74. package/templates/skills/gitflow/_shared.md +144 -2
  75. package/templates/skills/gitflow/phases/status.md +11 -1
  76. package/templates/skills/gitflow/steps/step-commit.md +1 -1
  77. package/templates/skills/gitflow/steps/step-init.md +202 -39
  78. package/templates/skills/gitflow/steps/step-pr.md +17 -5
  79. package/templates/skills/gitflow/templates/config.json +10 -1
  80. package/templates/skills/ralph-loop/SKILL.md +22 -15
  81. package/templates/skills/ralph-loop/steps/step-01-task.md +89 -4
  82. package/templates/skills/ralph-loop/steps/step-02-execute.md +408 -23
  83. package/templates/skills/ralph-loop/steps/step-03-commit.md +84 -2
  84. package/templates/skills/ralph-loop/steps/step-04-check.md +235 -6
  85. package/templates/skills/ralph-loop/steps/step-05-report.md +115 -0
  86. package/templates/skills/validate-feature/SKILL.md +83 -0
  87. package/templates/skills/validate-feature/steps/step-01-compile.md +38 -0
  88. package/templates/skills/validate-feature/steps/step-02-unit-tests.md +45 -0
  89. package/templates/skills/validate-feature/steps/step-03-integration-tests.md +53 -0
  90. package/templates/skills/validate-feature/steps/step-04-api-smoke.md +157 -0
@@ -12,7 +12,7 @@
12
12
  <header class="global-header">
13
13
  <div class="logo">SS</div>
14
14
  <span class="site-title">SmartStack CLI</span>
15
- <span class="version-badge">v2.0.0</span>
15
+ <span class="version-badge">v3.0.0</span>
16
16
  <div class="header-divider"></div>
17
17
  <span class="page-title" data-lang="fr">Agents Spécialisés</span>
18
18
  <span class="page-title" data-lang="en">Specialized Agents</span>
@@ -195,80 +195,6 @@
195
195
  </div>
196
196
  </div>
197
197
 
198
- <details class="template-section">
199
- <summary>
200
- <h4 style="display: inline; margin: 0;">
201
- <span data-lang="fr">Template Prompt</span>
202
- <span data-lang="en">Prompt Template</span>
203
- </h4>
204
- <span class="template-badge">explore-codebase.md</span>
205
- </summary>
206
- <div class="template-content">
207
- <p class="template-path">
208
- <code>templates/agents/explore-codebase.md</code>
209
- </p>
210
- <div class="code-block template-code">
211
- <button class="copy-btn">Copy</button>
212
- <pre><code>---
213
- name: explore-codebase
214
- description: Use this agent whenever you need to explore the codebase to implement a feature.
215
- color: yellow
216
- model: haiku
217
- ---
218
-
219
- You are a codebase exploration specialist. Your only job is to find and present ALL relevant code and logic for the requested feature.
220
-
221
- ## Search Strategy
222
-
223
- 1. Start with broad searches using `Grep` to find entry points
224
- 2. Use parallel searches for multiple related keywords
225
- 3. Read files completely with `Read` to understand context
226
- 4. Follow import chains to discover dependencies
227
-
228
- ## What to Find
229
-
230
- - Existing similar features or patterns
231
- - Related functions, classes, components
232
- - Configuration and setup files
233
- - Database schemas and models
234
- - API endpoints and routes
235
- - Tests showing usage examples
236
- - Utility functions that might be reused
237
-
238
- ## Output Format
239
-
240
- **CRITICAL**: Output all findings directly in your response. NEVER create markdown files.
241
-
242
- ### Relevant Files Found
243
-
244
- For each file:
245
-
246
- ```
247
- Path: /full/path/to/file.ext
248
- Purpose: [One line description]
249
- Key Code:
250
- - Lines X-Y: [Actual code or logic description]
251
- - Line Z: [Function/class definition]
252
- Related to: [How it connects to the feature]
253
- ```
254
-
255
- ### Code Patterns & Conventions
256
-
257
- - List discovered patterns (naming, structure, frameworks)
258
- - Note existing approaches that should be followed
259
-
260
- ### Dependencies & Connections
261
-
262
- - Import relationships between files
263
- - External libraries used
264
- - API integrations found
265
-
266
- ## Priority
267
-
268
- Thoroughness > Speed. Find everything relevant.</code></pre>
269
- </div>
270
- </div>
271
- </details>
272
198
  </div>
273
199
  </div>
274
200
  </section>
@@ -311,82 +237,6 @@ Thoroughness > Speed. Find everything relevant.</code></pre>
311
237
  </div>
312
238
  </div>
313
239
 
314
- <details class="template-section">
315
- <summary>
316
- <h4 style="display: inline; margin: 0;">
317
- <span data-lang="fr">Template Prompt</span>
318
- <span data-lang="en">Prompt Template</span>
319
- </h4>
320
- <span class="template-badge">explore-docs.md</span>
321
- </summary>
322
- <div class="template-content">
323
- <p class="template-path">
324
- <code>templates/agents/explore-docs.md</code>
325
- </p>
326
- <div class="code-block template-code">
327
- <button class="copy-btn">Copy</button>
328
- <pre><code>---
329
- name: explore-docs
330
- description: Use this agent IMMEDIATELY when the user asks about library features, implementation methods, "how to do X with Y library", documentation searches, or ANY question about using/implementing specific libraries or frameworks
331
- color: yellow
332
- model: haiku
333
- ---
334
-
335
- You are a documentation exploration specialist. Your mission is to retrieve precise, actionable documentation with code examples.
336
-
337
- ## Search Strategy
338
-
339
- **Primary**: Use Context7 for library-specific documentation
340
-
341
- - Resolve library ID first with `mcp__context7__resolve-library-id`
342
- - Fetch targeted docs with `mcp__context7__get-library-docs`
343
- - Focus on specific topics when provided
344
-
345
- **Fallback**: Use WebSearch + WebFetch for official documentation
346
-
347
- - Search for official docs, API references, guides
348
- - Target authoritative sources (official websites, GitHub repos)
349
-
350
- ## Data Processing
351
-
352
- **Filter for essentials**:
353
-
354
- - Code examples and usage patterns
355
- - API specifications and method signatures
356
- - Configuration options and parameters
357
- - Error handling patterns
358
- - Best practices and common pitfalls
359
-
360
- **Eliminate noise**:
361
-
362
- - Marketing content and introductions
363
- - Redundant explanations
364
- - Outdated or deprecated information
365
-
366
- ## Output Format
367
-
368
- **CRITICAL**: Output all findings directly in your response. NEVER create markdown files.
369
-
370
- ### Library: [Name/Version]
371
-
372
- ### Key Concepts
373
- - [Essential concept]: [Brief explanation with context]
374
-
375
- ### Code Examples
376
- ```language
377
- // [Real-world example with full context]
378
- // Include imports, setup, and actual usage
379
- ```
380
-
381
- ### API Reference
382
- - `method(params: Type)`: [Purpose, parameters, return type, example]
383
-
384
- ## Priority
385
-
386
- Actionable code examples > API specs > Configuration > Theory.</code></pre>
387
- </div>
388
- </div>
389
- </details>
390
240
  </div>
391
241
  </div>
392
242
  </section>
@@ -429,68 +279,6 @@ Actionable code examples > API specs > Configuration > Theory.</code></pre>
429
279
  </div>
430
280
  </div>
431
281
 
432
- <details class="template-section">
433
- <summary>
434
- <h4 style="display: inline; margin: 0;">
435
- <span data-lang="fr">Template Prompt</span>
436
- <span data-lang="en">Prompt Template</span>
437
- </h4>
438
- <span class="template-badge">websearch.md</span>
439
- </summary>
440
- <div class="template-content">
441
- <p class="template-path">
442
- <code>templates/agents/websearch.md</code>
443
- </p>
444
- <div class="code-block template-code">
445
- <button class="copy-btn">Copy</button>
446
- <pre><code>---
447
- name: websearch
448
- description: Use this agent when you need to make a quick web search.
449
- color: yellow
450
- tools: WebSearch, WebFetch
451
- model: haiku
452
- ---
453
-
454
- You are a rapid web search specialist. Find accurate information fast.
455
-
456
- ## Workflow
457
-
458
- 1. **Search**: Use `WebSearch` with precise keywords
459
- 2. **Fetch**: Use `WebFetch` for most relevant results
460
- 3. **Summarize**: Extract key information concisely
461
-
462
- ## Search Best Practices
463
-
464
- - Focus on authoritative sources (official docs, trusted sites)
465
- - Skip redundant information
466
- - Use specific keywords rather than vague terms
467
- - Prioritize recent information when relevant
468
-
469
- ## Output Format
470
-
471
- **CRITICAL**: Output all findings directly in your response. NEVER create markdown files.
472
-
473
- &lt;summary&gt;
474
- [Clear, concise answer to the query]
475
- &lt;/summary&gt;
476
-
477
- &lt;key-points&gt;
478
- • [Most important fact]
479
- • [Second important fact]
480
- • [Additional relevant info]
481
- &lt;/key-points&gt;
482
-
483
- &lt;sources&gt;
484
- 1. [Title](URL) - Brief description
485
- 2. [Title](URL) - What it contains
486
- &lt;/sources&gt;
487
-
488
- ## Priority
489
-
490
- Accuracy > Speed. Get the right answer quickly.</code></pre>
491
- </div>
492
- </div>
493
- </details>
494
282
  </div>
495
283
  </div>
496
284
  </section>
@@ -533,59 +321,6 @@ Accuracy > Speed. Get the right answer quickly.</code></pre>
533
321
  </div>
534
322
  </div>
535
323
 
536
- <details class="template-section">
537
- <summary>
538
- <h4 style="display: inline; margin: 0;">
539
- <span data-lang="fr">Template Prompt</span>
540
- <span data-lang="en">Prompt Template</span>
541
- </h4>
542
- <span class="template-badge">snipper.md</span>
543
- </summary>
544
- <div class="template-content">
545
- <p class="template-path">
546
- <code>templates/agents/snipper.md</code>
547
- </p>
548
- <div class="code-block template-code">
549
- <button class="copy-btn">Copy</button>
550
- <pre><code>---
551
- name: Snipper
552
- description: Use this agent when you need to modify code. This agent is specialized to be fast. The output is small and optimized to code as fast as agent can.
553
- color: blue
554
- model: haiku
555
- ---
556
-
557
- You are a rapid code modification specialist. No explanations, just execute.
558
-
559
- ## Workflow
560
-
561
- 1. **Read**: Load all specified files with `Read` tool
562
- 2. **Edit**: Apply requested changes using `Edit` or `MultiEdit`
563
- 3. **Report**: List what was modified
564
-
565
- ## Execution Rules
566
-
567
- - Follow existing code style exactly
568
- - Preserve all formatting and indentation
569
- - Make minimal changes to achieve the goal
570
- - Use `MultiEdit` for multiple changes in same file
571
- - Never add comments unless requested
572
- - DO NEVER RUN LINT CHECK. YOU CAN'T USE BASH.
573
-
574
- ## Output Format
575
-
576
- Simply list each file and the change made:
577
-
578
- ```
579
- - path/to/file.ext: [One line description of change]
580
- - path/to/other.ext: [What was modified]
581
- ```
582
-
583
- ## Priority
584
-
585
- Speed > Explanation. Just get it done.</code></pre>
586
- </div>
587
- </div>
588
- </details>
589
324
  </div>
590
325
  </div>
591
326
  </section>
@@ -628,58 +363,6 @@ Speed > Explanation. Just get it done.</code></pre>
628
363
  </div>
629
364
  </div>
630
365
 
631
- <details class="template-section">
632
- <summary>
633
- <h4 style="display: inline; margin: 0;">
634
- <span data-lang="fr">Template Prompt</span>
635
- <span data-lang="en">Prompt Template</span>
636
- </h4>
637
- <span class="template-badge">fix-grammar.md</span>
638
- </summary>
639
- <div class="template-content">
640
- <p class="template-path">
641
- <code>templates/agents/fix-grammar.md</code>
642
- </p>
643
- <div class="code-block template-code">
644
- <button class="copy-btn">Copy</button>
645
- <pre><code>---
646
- name: fix-grammar
647
- description: Use this agent to fix grammar and spelling errors in a single file while preserving formatting
648
- color: blue
649
- model: haiku
650
- ---
651
-
652
- You are DevProfCorrectorGPT, a professional text corrector. Fix grammar and spelling errors while preserving all formatting and meaning.
653
-
654
- ## File Processing
655
-
656
- - Read the target file completely
657
- - Apply grammar and spelling corrections only
658
- - Preserve all formatting, tags, and technical terms
659
- - Do not translate or change word order
660
- - Do not modify special tags (MDX, custom syntax, code blocks)
661
-
662
- ## Correction Rules
663
-
664
- - Fix only spelling and grammar errors
665
- - Keep the same language used in each sentence
666
- - Preserve all document structure and formatting
667
- - Do not change meaning or technical terms
668
- - Handle multilingual content (keep anglicisms, technical terms)
669
-
670
- ## Output Format
671
-
672
- ```
673
- ✓ Fixed grammar in [filename]
674
- - [number] corrections made
675
- ```
676
-
677
- ## Priority
678
-
679
- Accuracy > Speed. Preserve meaning and formatting while fixing obvious errors.</code></pre>
680
- </div>
681
- </div>
682
- </details>
683
366
  </div>
684
367
  </div>
685
368
  </section>
@@ -817,59 +500,6 @@ Accuracy > Speed. Preserve meaning and formatting while fixing obvious errors.</
817
500
  </div>
818
501
  </div>
819
502
 
820
- <details class="template-section">
821
- <summary>
822
- <h4 style="display: inline; margin: 0;">
823
- <span data-lang="fr">Template Prompt</span>
824
- <span data-lang="en">Prompt Template</span>
825
- </h4>
826
- <span class="template-badge">action.md</span>
827
- </summary>
828
- <div class="template-content">
829
- <p class="template-path">
830
- <code>templates/agents/action.md</code>
831
- </p>
832
- <div class="code-block template-code">
833
- <button class="copy-btn">Copy</button>
834
- <pre><code>---
835
- name: action
836
- description: Conditional action executor - performs actions only when specific conditions are met
837
- color: purple
838
- model: haiku
839
- ---
840
-
841
- Batch conditional executor. Handle ≤5 tasks. VERIFY INDEPENDENTLY before each action.
842
-
843
- ## Workflow
844
-
845
- 1. **VERIFY each item yourself** (never trust input):
846
- - **Exports/Types**: Grep for `import.*{name}` in codebase
847
- - **Files**: Check framework patterns via explore-docs, then Grep for imports
848
- - **Dependencies**: Grep for `from 'pkg'` or `require('pkg')`
849
-
850
- 2. **Execute ONLY if verified unused**:
851
- - If used → Skip with reason, continue next
852
- - If unused → Execute action, confirm success
853
-
854
- 3. **Report**: Count executed, count skipped with reasons
855
-
856
- ## Rules
857
-
858
- - **MANDATORY**: Verify each item independently using Grep/explore-docs
859
- - **Skip if used**: Continue to next task
860
- - **Max 5 tasks**: Process all in batch
861
-
862
- ## Example
863
-
864
- "Verify and remove: lodash, axios, moment"
865
-
866
- 1. Grep `lodash` → Found in utils.ts → Skip
867
- 2. Grep `axios` → Not found → `pnpm remove axios` → Done
868
- 3. Grep `moment` → Not found → `pnpm remove moment` → Done
869
- Report: "Removed 2/3: axios, moment. Skipped: lodash (used in utils.ts)"</code></pre>
870
- </div>
871
- </div>
872
- </details>
873
503
  </div>
874
504
  </div>
875
505
  </section>
@@ -12,7 +12,7 @@
12
12
  <header class="global-header">
13
13
  <div class="logo">SS</div>
14
14
  <span class="site-title">SmartStack CLI</span>
15
- <span class="version-badge">v5.0.0</span>
15
+ <span class="version-badge">v6.0.0</span>
16
16
  <div class="header-divider"></div>
17
17
  <span class="page-title">Business Analyse</span>
18
18
  <nav class="breadcrumb">
@@ -24,7 +24,7 @@
24
24
  <span data-lang="fr">Workflows</span>
25
25
  <span data-lang="en">Workflows</span>
26
26
  <span class="breadcrumb-separator">&#8250;</span>
27
- <span class="breadcrumb-current">Business Analyse v5.0</span>
27
+ <span class="breadcrumb-current">Business Analyse v6.0</span>
28
28
  </nav>
29
29
  <!-- Language Select -->
30
30
  <select class="lang-select" id="lang-select" onchange="setLanguage(this.value); localStorage.setItem('doc-language', this.value);">
@@ -99,8 +99,8 @@
99
99
  </a>
100
100
  <a href="#quick-start" class="sidebar-toc-link">Quick Start</a>
101
101
  <a href="#use-cases" class="sidebar-toc-link">
102
- <span data-lang="fr">4 Cas d'usage</span>
103
- <span data-lang="en">4 Use Cases</span>
102
+ <span data-lang="fr">5 Cas d'usage</span>
103
+ <span data-lang="en">5 Use Cases</span>
104
104
  </a>
105
105
  <a href="#flags" class="sidebar-toc-link">
106
106
  <span data-lang="fr">Flags &amp; Modes</span>
@@ -169,14 +169,14 @@
169
169
  <section id="introduction">
170
170
  <h2>Introduction</h2>
171
171
  <p data-lang="fr">
172
- 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.
172
+ 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.
173
173
  </p>
174
174
  <p data-lang="en">
175
- 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.
175
+ 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.
176
176
  </p>
177
177
 
178
- <h4 data-lang="fr">6 Etapes du workflow</h4>
179
- <h4 data-lang="en">6 Workflow Steps</h4>
178
+ <h4 data-lang="fr">7 Etapes du workflow</h4>
179
+ <h4 data-lang="en">7 Workflow Steps</h4>
180
180
  <ol class="steps-list">
181
181
  <li>
182
182
  <strong>Init</strong> - Detecte le mode (application vs module), cree feature.json initial
@@ -194,7 +194,10 @@
194
194
  <strong>Consolidation</strong> - Validation cross-module, coherence des permissions et entites partagees
195
195
  </li>
196
196
  <li>
197
- <strong>Handoff</strong> - Mapping des fichiers par module, extraction programmatique prd.json via <code>ss derive-prd</code>
197
+ <strong>Handoff</strong> - Mapping des fichiers par module, extraction programmatique prd.json via <code>ss derive-prd</code>, deploiement HTML interactif
198
+ </li>
199
+ <li>
200
+ <strong>Extract</strong> - Import depuis l'export JSON du HTML interactif (<code>-x</code>), mapping vers feature.json
198
201
  </li>
199
202
  </ol>
200
203
 
@@ -267,10 +270,10 @@ Exemple:
267
270
  </h2>
268
271
 
269
272
  <p data-lang="fr">
270
- 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.
273
+ 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.
271
274
  </p>
272
275
  <p data-lang="en">
273
- 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.
276
+ 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.
274
277
  </p>
275
278
 
276
279
  <h4 data-lang="fr">Structure de repertoires</h4>
@@ -411,7 +414,10 @@ Exemple:
411
414
  /business-analyse -r FEAT-001 "Add return management module"
412
415
 
413
416
  # Micro-feature (analyse minimale)
414
- /business-analyse -m Add a status field to orders</code></pre>
417
+ /business-analyse -m Add a status field to orders
418
+
419
+ # Extract depuis HTML interactif
420
+ /business-analyse -x ./docs/business/MyApp/ba-export.json</code></pre>
415
421
  </div>
416
422
  </div>
417
423
  </div>
@@ -422,8 +428,8 @@ Exemple:
422
428
  <!-- ============================================ -->
423
429
  <section id="use-cases">
424
430
  <h2>
425
- <span data-lang="fr">4 Cas d'usage</span>
426
- <span data-lang="en">4 Use Cases</span>
431
+ <span data-lang="fr">5 Cas d'usage</span>
432
+ <span data-lang="en">5 Use Cases</span>
427
433
  </h2>
428
434
 
429
435
  <div class="table-container">
@@ -470,6 +476,12 @@ Exemple:
470
476
  <td><span data-lang="fr">module simple</span><span data-lang="en">simple module</span></td>
471
477
  <td>00 (micro) → 01 (lite) → 02 (skip) → 03 (minimal) → 04 (auto) → 05</td>
472
478
  </tr>
479
+ <tr>
480
+ <td><strong>Extract</strong></td>
481
+ <td><code>-x</code></td>
482
+ <td><span data-lang="fr">import HTML interactif</span><span data-lang="en">interactive HTML import</span></td>
483
+ <td>00 → 06 (extract) → <span data-lang="fr">choix</span><span data-lang="en">choice</span> (01 | 05 | EXIT)</td>
484
+ </tr>
473
485
  </tbody>
474
486
  </table>
475
487
  </div>
@@ -521,6 +533,14 @@ Exemple:
521
533
  </td>
522
534
  <td>false</td>
523
535
  </tr>
536
+ <tr>
537
+ <td><code>-x, --extract</code></td>
538
+ <td>
539
+ <span data-lang="fr">Importer depuis l'export JSON du HTML interactif</span>
540
+ <span data-lang="en">Import from interactive HTML JSON export</span>
541
+ </td>
542
+ <td>false</td>
543
+ </tr>
524
544
  <tr>
525
545
  <td><code>--economy-mode</code></td>
526
546
  <td>
@@ -546,13 +566,13 @@ Exemple:
546
566
  <!-- WORKFLOW (6 STEPS) -->
547
567
  <!-- ============================================ -->
548
568
  <section id="workflow">
549
- <h2>Workflow (6 Etapes)</h2>
569
+ <h2>Workflow (7 Etapes)</h2>
550
570
 
551
571
  <p data-lang="fr">
552
- Le workflow v5.0 combine decouverte, decomposition, specification iterative et consolidation cross-module. Chaque etape enrichit progressivement le feature.json.
572
+ Le workflow v6.0 combine decouverte, decomposition, specification iterative et consolidation cross-module. Chaque etape enrichit progressivement le feature.json.
553
573
  </p>
554
574
  <p data-lang="en">
555
- The v5.0 workflow combines discovery, decomposition, iterative specification and cross-module consolidation. Each step progressively enriches the feature.json.
575
+ The v6.0 workflow combines discovery, decomposition, iterative specification and cross-module consolidation. Each step progressively enriches the feature.json.
556
576
  </p>
557
577
  </section>
558
578
 
@@ -849,6 +869,16 @@ Exemple:
849
869
  }</code></pre>
850
870
  </div>
851
871
 
872
+ <h4 data-lang="fr">Document HTML interactif</h4>
873
+ <h4 data-lang="en">Interactive HTML Document</h4>
874
+
875
+ <p data-lang="fr">
876
+ 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>.
877
+ </p>
878
+ <p data-lang="en">
879
+ 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>.
880
+ </p>
881
+
852
882
  <h4 data-lang="fr">Verification post-handoff</h4>
853
883
  <h4 data-lang="en">Post-Handoff Verification</h4>
854
884
 
@@ -861,9 +891,42 @@ Exemple:
861
891
  <li data-lang="en">Extract prd.json via <code>ss derive-prd</code></li>
862
892
  <li data-lang="fr">Generer progress.txt tracker</li>
863
893
  <li data-lang="en">Generate progress.txt tracker</li>
894
+ <li data-lang="fr">Deployer ba-interactive.html avec placeholders remplaces</li>
895
+ <li data-lang="en">Deploy ba-interactive.html with placeholders replaced</li>
864
896
  </ul>
865
897
  </section>
866
898
 
899
+ <!-- ============================================ -->
900
+ <!-- STEP 06 - EXTRACT -->
901
+ <!-- ============================================ -->
902
+ <section id="step-06">
903
+ <h3>06. Extract</h3>
904
+
905
+ <p data-lang="fr">
906
+ 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>.
907
+ </p>
908
+ <p data-lang="en">
909
+ 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.
910
+ </p>
911
+
912
+ <h4 data-lang="fr">Principe</h4>
913
+ <h4 data-lang="en">Principle</h4>
914
+
915
+ <ul>
916
+ <li data-lang="fr">Zero perte d'information : chaque champ du JSON exporte est mappe vers feature.json</li>
917
+ <li data-lang="en">Zero information loss: every field from the exported JSON is mapped to feature.json</li>
918
+ <li data-lang="fr">Mapping deterministe : cadrage, modules, specifications, consolidation</li>
919
+ <li data-lang="en">Deterministic mapping: cadrage, modules, specifications, consolidation</li>
920
+ <li data-lang="fr">Post-extraction : choix entre enrichir (step-01), handoff (step-05), ou terminer</li>
921
+ <li data-lang="en">Post-extraction: choice between enrichment (step-01), handoff (step-05), or terminate</li>
922
+ </ul>
923
+
924
+ <div class="code-block">
925
+ <button class="copy-btn">Copy</button>
926
+ <pre><code>/business-analyse -x ./docs/business/MyApp/ba-export.json</code></pre>
927
+ </div>
928
+ </section>
929
+
867
930
  <!-- ============================================ -->
868
931
  <!-- SCHEMAS -->
869
932
  <!-- ============================================ -->
@@ -1065,6 +1128,7 @@ Module: "Checkout"
1065
1128
  <pre><code>docs/business/{app}/business-analyse/
1066
1129
  ├── v1.0/
1067
1130
  │ ├── feature.json ← Master application spec
1131
+ │ ├── ba-interactive.html ← Interactive client review document
1068
1132
  │ └── README.md ← Overview
1069
1133
  ├── checkout/v1.0/
1070
1134
  │ ├── feature.json ← Module spec
@@ -12,7 +12,7 @@
12
12
  <header class="global-header">
13
13
  <div class="logo">SS</div>
14
14
  <span class="site-title">SmartStack CLI</span>
15
- <span class="version-badge">v2.0.0</span>
15
+ <span class="version-badge">v3.0.0</span>
16
16
  <div class="header-divider"></div>
17
17
  <span class="page-title">CLI Commands</span>
18
18
  <nav class="breadcrumb">
@@ -12,7 +12,7 @@
12
12
  <header class="global-header">
13
13
  <div class="logo">SS</div>
14
14
  <span class="site-title">SmartStack CLI</span>
15
- <span class="version-badge">v2.0.0</span>
15
+ <span class="version-badge">v3.0.0</span>
16
16
  <div class="header-divider"></div>
17
17
  <span class="page-title" data-lang="fr">Référence des commandes</span>
18
18
  <span class="page-title" data-lang="en">Command Reference</span>
@@ -12,7 +12,7 @@
12
12
  <header class="global-header">
13
13
  <div class="logo">SS</div>
14
14
  <span class="site-title">SmartStack CLI</span>
15
- <span class="version-badge">v2.0.0</span>
15
+ <span class="version-badge">v3.0.0</span>
16
16
  <div class="header-divider"></div>
17
17
  <span class="page-title">EF Core Migrations</span>
18
18
  <nav class="breadcrumb">