@atlashub/smartstack-cli 3.37.0 → 3.39.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 (228) hide show
  1. package/dist/index.js +16 -24
  2. package/dist/index.js.map +1 -1
  3. package/dist/mcp-entry.mjs +235 -265
  4. package/dist/mcp-entry.mjs.map +1 -1
  5. package/package.json +1 -1
  6. package/scripts/extract-api-endpoints.ts +5 -5
  7. package/scripts/generate-doc-with-mock-ui.ts +10 -17
  8. package/templates/agents/ba-reader.md +9 -9
  9. package/templates/agents/ba-writer.md +12 -15
  10. package/templates/agents/code-reviewer.md +1 -1
  11. package/templates/agents/docs-context-reader.md +1 -1
  12. package/templates/agents/efcore/scan.md +3 -1
  13. package/templates/agents/gitflow/commit.md +74 -0
  14. package/templates/agents/gitflow/finish.md +5 -2
  15. package/templates/agents/gitflow/init-clone.md +3 -3
  16. package/templates/agents/gitflow/init-validate.md +3 -2
  17. package/templates/agents/gitflow/merge.md +5 -4
  18. package/templates/agents/gitflow/pr.md +5 -4
  19. package/templates/agents/gitflow/start.md +37 -5
  20. package/templates/hooks/hooks.json +11 -0
  21. package/templates/hooks/wsl-dotnet-cleanup.sh +24 -0
  22. package/templates/mcp-scaffolding/frontend/nav-routes.ts.hbs +20 -20
  23. package/templates/mcp-scaffolding/frontend/routes.tsx.hbs +16 -24
  24. package/templates/mcp-scaffolding/migrations/seed-roles.cs.hbs +2 -2
  25. package/templates/skills/_resources/mcp-validate-documentation-spec.md +3 -3
  26. package/templates/skills/_shared.md +15 -17
  27. package/templates/skills/ai-prompt/SKILL.md +1 -1
  28. package/templates/skills/ai-prompt/steps/step-00-init.md +47 -0
  29. package/templates/skills/apex/SKILL.md +3 -4
  30. package/templates/skills/apex/_shared.md +10 -20
  31. package/templates/skills/apex/references/analysis-methods.md +141 -0
  32. package/templates/skills/apex/references/challenge-questions.md +1 -21
  33. package/templates/skills/apex/references/core-seed-data.md +35 -58
  34. package/templates/skills/apex/references/examine-build-validation.md +82 -0
  35. package/templates/skills/apex/references/execution-frontend-gates.md +177 -0
  36. package/templates/skills/apex/references/execution-frontend-patterns.md +105 -0
  37. package/templates/skills/apex/references/execution-layer1-rules.md +96 -0
  38. package/templates/skills/apex/references/initialization-challenge-flow.md +110 -0
  39. package/templates/skills/apex/references/planning-layer-mapping.md +151 -0
  40. package/templates/skills/apex/references/post-checks.md +145 -40
  41. package/templates/skills/apex/references/smartstack-api.md +35 -51
  42. package/templates/skills/apex/references/smartstack-frontend.md +18 -18
  43. package/templates/skills/apex/references/smartstack-layers.md +38 -62
  44. package/templates/skills/apex/steps/step-00-init.md +14 -26
  45. package/templates/skills/apex/steps/step-01-analyze.md +10 -143
  46. package/templates/skills/apex/steps/step-02-plan.md +10 -92
  47. package/templates/skills/apex/steps/step-03-execute.md +45 -252
  48. package/templates/skills/apex/steps/step-04-examine.md +14 -78
  49. package/templates/skills/apex/steps/step-05-deep-review.md +2 -2
  50. package/templates/skills/apex/steps/step-08-run-tests.md +1 -0
  51. package/templates/skills/application/SKILL.md +241 -242
  52. package/templates/skills/application/references/backend-controller-hierarchy.md +16 -16
  53. package/templates/skills/application/references/backend-seeding-and-dto-output.md +83 -0
  54. package/templates/skills/application/references/backend-table-prefix-mapping.md +79 -0
  55. package/templates/skills/application/references/backend-verification.md +1 -1
  56. package/templates/skills/application/references/frontend-i18n-and-output.md +67 -0
  57. package/templates/skills/application/references/frontend-route-naming.md +117 -0
  58. package/templates/skills/application/references/frontend-route-wiring-app-tsx.md +107 -0
  59. package/templates/skills/application/references/frontend-verification.md +12 -12
  60. package/templates/skills/application/references/init-parameter-detection.md +121 -0
  61. package/templates/skills/application/references/migration-checklist-troubleshooting.md +100 -0
  62. package/templates/skills/application/references/nav-fallback-procedure.md +199 -200
  63. package/templates/skills/application/references/provider-template.md +2 -6
  64. package/templates/skills/application/references/roles-client-project-handling.md +55 -0
  65. package/templates/skills/application/references/roles-fallback-procedure.md +149 -0
  66. package/templates/skills/application/references/test-coverage-requirements.md +213 -0
  67. package/templates/skills/application/references/test-frontend.md +3 -3
  68. package/templates/skills/application/steps/step-00-init.md +130 -260
  69. package/templates/skills/application/steps/step-01-navigation.md +170 -170
  70. package/templates/skills/application/steps/step-02-permissions.md +196 -196
  71. package/templates/skills/application/steps/step-03-roles.md +182 -339
  72. package/templates/skills/application/steps/step-03b-provider.md +133 -134
  73. package/templates/skills/application/steps/step-04-backend.md +174 -265
  74. package/templates/skills/application/steps/step-05-frontend.md +18 -144
  75. package/templates/skills/application/steps/step-06-migration.md +12 -60
  76. package/templates/skills/application/steps/step-07-tests.md +9 -76
  77. package/templates/skills/application/templates-backend.md +29 -27
  78. package/templates/skills/application/templates-frontend.md +49 -49
  79. package/templates/skills/application/templates-seed.md +57 -131
  80. package/templates/skills/business-analyse/SKILL.md +27 -30
  81. package/templates/skills/business-analyse/_architecture.md +6 -6
  82. package/templates/skills/business-analyse/_shared.md +60 -88
  83. package/templates/skills/business-analyse/questionnaire/04-data.md +3 -3
  84. package/templates/skills/business-analyse/questionnaire/06-security.md +1 -1
  85. package/templates/skills/business-analyse/questionnaire/13-cross-module.md +1 -1
  86. package/templates/skills/business-analyse/react/application-viewer.md +12 -12
  87. package/templates/skills/business-analyse/react/components.md +8 -12
  88. package/templates/skills/business-analyse/react/schema.md +836 -836
  89. package/templates/skills/business-analyse/references/agent-module-prompt.md +2 -3
  90. package/templates/skills/business-analyse/references/analysis-semantic-checks.md +190 -0
  91. package/templates/skills/business-analyse/references/cache-warming-strategy.md +2 -2
  92. package/templates/skills/business-analyse/references/cadrage-challenge-patterns.md +41 -0
  93. package/templates/skills/business-analyse/references/cadrage-coverage-matrix.md +74 -0
  94. package/templates/skills/business-analyse/references/cadrage-shared-modules.md +69 -0
  95. package/templates/skills/business-analyse/references/cadrage-structure-cards.md +1 -1
  96. package/templates/skills/business-analyse/references/compilation-structure-cards.md +297 -0
  97. package/templates/skills/business-analyse/references/consolidation-structural-checks.md +2 -2
  98. package/templates/skills/business-analyse/references/deploy-modes.md +5 -5
  99. package/templates/skills/business-analyse/references/detection-strategies.md +7 -7
  100. package/templates/skills/business-analyse/references/handoff-file-templates.md +14 -22
  101. package/templates/skills/business-analyse/references/handoff-mappings.md +4 -4
  102. package/templates/skills/business-analyse/references/handoff-seeddata-generation.md +312 -0
  103. package/templates/skills/business-analyse/references/init-schema-deployment.md +3 -3
  104. package/templates/skills/business-analyse/references/naming-conventions.md +22 -24
  105. package/templates/skills/business-analyse/references/prd-generation.md +2 -2
  106. package/templates/skills/business-analyse/references/review-data-mapping.md +2 -2
  107. package/templates/skills/business-analyse/references/robustness-checks.md +1 -1
  108. package/templates/skills/business-analyse/references/spec-auto-inference.md +3 -3
  109. package/templates/skills/business-analyse/references/team-orchestration.md +49 -6
  110. package/templates/skills/business-analyse/references/ui-dashboard-spec.md +1 -1
  111. package/templates/skills/business-analyse/references/ui-resource-cards.md +18 -18
  112. package/templates/skills/business-analyse/references/validate-incremental-html.md +2 -2
  113. package/templates/skills/business-analyse/references/validation-checklist.md +2 -2
  114. package/templates/skills/business-analyse/schemas/application-schema.json +4 -5
  115. package/templates/skills/business-analyse/schemas/project-schema.json +1 -6
  116. package/templates/skills/business-analyse/schemas/sections/metadata-schema.json +2 -3
  117. package/templates/skills/business-analyse/schemas/sections/specification-schema.json +4 -4
  118. package/templates/skills/business-analyse/steps/step-00-init.md +8 -17
  119. package/templates/skills/business-analyse/steps/step-01-cadrage.md +35 -198
  120. package/templates/skills/business-analyse/steps/step-01b-applications.md +16 -20
  121. package/templates/skills/business-analyse/steps/step-02-decomposition.md +1 -1
  122. package/templates/skills/business-analyse/steps/step-03a1-setup.md +4 -4
  123. package/templates/skills/business-analyse/steps/step-03a2-analysis.md +1 -1
  124. package/templates/skills/business-analyse/steps/step-03b-ui.md +4 -4
  125. package/templates/skills/business-analyse/steps/step-03c-compile.md +66 -140
  126. package/templates/skills/business-analyse/steps/step-03d-validate.md +2 -2
  127. package/templates/skills/business-analyse/steps/step-04a-collect.md +2 -2
  128. package/templates/skills/business-analyse/steps/step-04b-analyze.md +42 -160
  129. package/templates/skills/business-analyse/steps/step-04c-decide.md +1 -1
  130. package/templates/skills/business-analyse/steps/step-05a-handoff.md +74 -104
  131. package/templates/skills/business-analyse/steps/step-05b-deploy.md +13 -11
  132. package/templates/skills/business-analyse/steps/step-06-review.md +3 -3
  133. package/templates/skills/business-analyse/templates/tpl-frd.md +13 -13
  134. package/templates/skills/business-analyse/templates/tpl-handoff.md +12 -12
  135. package/templates/skills/business-analyse/templates/tpl-progress.md +1 -1
  136. package/templates/skills/business-analyse/templates-frd.md +25 -25
  137. package/templates/skills/business-analyse/templates-react.md +15 -21
  138. package/templates/skills/controller/SKILL.md +1 -1
  139. package/templates/skills/controller/postman-templates.md +1 -1
  140. package/templates/skills/controller/references/controller-code-templates.md +2 -2
  141. package/templates/skills/controller/references/mcp-scaffold-workflow.md +209 -0
  142. package/templates/skills/controller/references/permission-sync-templates.md +13 -16
  143. package/templates/skills/controller/steps/step-00-init.md +11 -11
  144. package/templates/skills/controller/steps/step-03-generate.md +64 -103
  145. package/templates/skills/controller/templates.md +67 -71
  146. package/templates/skills/debug/SKILL.md +13 -218
  147. package/templates/skills/debug/steps/step-00-init.md +57 -0
  148. package/templates/skills/debug/steps/step-01-analyze.md +219 -0
  149. package/templates/skills/debug/steps/step-02-resolve.md +85 -0
  150. package/templates/skills/documentation/SKILL.md +49 -345
  151. package/templates/skills/documentation/data-schema.md +11 -8
  152. package/templates/skills/documentation/steps/step-00-init.md +70 -0
  153. package/templates/skills/documentation/steps/step-01-scan.md +113 -0
  154. package/templates/skills/documentation/steps/step-02-generate.md +231 -0
  155. package/templates/skills/documentation/steps/step-03-validate.md +238 -0
  156. package/templates/skills/documentation/templates.md +480 -322
  157. package/templates/skills/efcore/SKILL.md +1 -1
  158. package/templates/skills/efcore/references/both-contexts.md +32 -0
  159. package/templates/skills/efcore/references/database-operations.md +67 -0
  160. package/templates/skills/efcore/references/destructive-operations.md +38 -0
  161. package/templates/skills/efcore/references/reset-operations.md +81 -0
  162. package/templates/skills/efcore/references/seed-methods.md +86 -0
  163. package/templates/skills/efcore/references/shared-init-functions.md +250 -0
  164. package/templates/skills/efcore/references/sql-objects-injection.md +61 -0
  165. package/templates/skills/efcore/references/troubleshooting.md +81 -0
  166. package/templates/skills/efcore/steps/db/step-deploy.md +1 -32
  167. package/templates/skills/efcore/steps/db/step-reset.md +7 -103
  168. package/templates/skills/efcore/steps/db/step-seed.md +10 -132
  169. package/templates/skills/efcore/steps/db/step-status.md +5 -44
  170. package/templates/skills/efcore/steps/migration/step-02-create.md +1 -14
  171. package/templates/skills/efcore/steps/migration/step-03-validate.md +8 -62
  172. package/templates/skills/efcore/steps/rebase-snapshot/step-03-create.md +1 -57
  173. package/templates/skills/efcore/steps/shared/step-00-init.md +11 -254
  174. package/templates/skills/efcore/steps/squash/step-03-create.md +1 -58
  175. package/templates/skills/feature-full/SKILL.md +1 -1
  176. package/templates/skills/feature-full/steps/step-00-init.md +57 -0
  177. package/templates/skills/feature-full/steps/step-01-implementation.md +1 -1
  178. package/templates/skills/gitflow/SKILL.md +28 -5
  179. package/templates/skills/gitflow/_shared.md +109 -12
  180. package/templates/skills/gitflow/phases/abort.md +4 -0
  181. package/templates/skills/gitflow/phases/cleanup.md +4 -0
  182. package/templates/skills/gitflow/references/commit-message-generation.md +58 -0
  183. package/templates/skills/gitflow/references/commit-migration-validation.md +49 -0
  184. package/templates/skills/gitflow/references/finish-cleanup.md +55 -0
  185. package/templates/skills/gitflow/references/finish-version-bumping.md +45 -0
  186. package/templates/skills/gitflow/references/init-environment-detection.md +41 -0
  187. package/templates/skills/gitflow/references/init-questions.md +185 -0
  188. package/templates/skills/gitflow/references/init-structure-creation.md +75 -0
  189. package/templates/skills/gitflow/references/init-version-detection.md +21 -0
  190. package/templates/skills/gitflow/references/init-workspace-detection.md +43 -0
  191. package/templates/skills/gitflow/references/merge-ci-status.md +36 -0
  192. package/templates/skills/gitflow/references/merge-execution.md +62 -0
  193. package/templates/skills/gitflow/references/merge-pr-context.md +76 -0
  194. package/templates/skills/gitflow/references/pr-build-checks.md +60 -0
  195. package/templates/skills/gitflow/references/pr-generation.md +58 -0
  196. package/templates/skills/gitflow/references/start-branch-normalization.md +28 -0
  197. package/templates/skills/gitflow/references/start-worktree-creation.md +50 -0
  198. package/templates/skills/gitflow/references/sync-push-verify.md +44 -0
  199. package/templates/skills/gitflow/references/sync-rebase-conflicts.md +38 -0
  200. package/templates/skills/gitflow/steps/step-commit.md +12 -91
  201. package/templates/skills/gitflow/steps/step-finish.md +15 -159
  202. package/templates/skills/gitflow/steps/step-init.md +24 -326
  203. package/templates/skills/gitflow/steps/step-merge.md +17 -176
  204. package/templates/skills/gitflow/steps/step-pr.md +10 -116
  205. package/templates/skills/gitflow/steps/step-start.md +16 -109
  206. package/templates/skills/gitflow/steps/step-sync.md +6 -69
  207. package/templates/skills/ralph-loop/SKILL.md +6 -0
  208. package/templates/skills/ralph-loop/references/category-completeness.md +185 -0
  209. package/templates/skills/ralph-loop/references/compact-loop.md +1 -1
  210. package/templates/skills/ralph-loop/references/init-resume-recovery.md +127 -0
  211. package/templates/skills/ralph-loop/references/module-transition.md +151 -0
  212. package/templates/skills/ralph-loop/references/multi-module-queue.md +171 -0
  213. package/templates/skills/ralph-loop/references/parallel-execution.md +246 -0
  214. package/templates/skills/ralph-loop/references/task-transform-legacy.md +6 -9
  215. package/templates/skills/ralph-loop/references/team-orchestration.md +45 -3
  216. package/templates/skills/ralph-loop/steps/step-00-init.md +36 -109
  217. package/templates/skills/ralph-loop/steps/step-01-task.md +15 -163
  218. package/templates/skills/ralph-loop/steps/step-02-execute.md +8 -154
  219. package/templates/skills/ralph-loop/steps/step-04-check.md +20 -73
  220. package/templates/skills/review-code/references/owasp-api-top10.md +5 -5
  221. package/templates/skills/review-code/references/smartstack-conventions.md +568 -568
  222. package/templates/skills/validate-feature/references/api-smoke-tests.md +140 -0
  223. package/templates/skills/validate-feature/references/db-validation-checks.md +180 -0
  224. package/templates/skills/validate-feature/steps/step-01-compile.md +1 -3
  225. package/templates/skills/validate-feature/steps/step-04-api-smoke.md +34 -145
  226. package/templates/skills/validate-feature/steps/step-05-db-validation.md +74 -260
  227. package/templates/skills/workflow/SKILL.md +1 -1
  228. package/templates/skills/workflow/steps/step-00-init.md +57 -0
@@ -29,8 +29,8 @@ All BA outputs are stored in up to **three levels** of feature.json, enriched pr
29
29
  > **Backward compatibility:** If only 1 application is identified, the project level is NOT created. The application-level feature.json remains the master (current behavior).
30
30
 
31
31
  ### Application-Level (Master)
32
- **Path:** `docs/{context}/{app}/business-analyse/v{X.Y}/feature.json`
33
- **Schema:** `docs/{context}/{app}/business-analyse/schemas/application-schema.json` (deployed to project by step-00)
32
+ **Path:** `docs/{app}/business-analyse/v{X.Y}/feature.json`
33
+ **Schema:** `docs/{app}/business-analyse/schemas/application-schema.json` (deployed to project by step-00)
34
34
  **$schema:** `"../schemas/application-schema.json"` (relative in feature.json)
35
35
 
36
36
  | Step | Section enriched | Status after |
@@ -42,11 +42,9 @@ All BA outputs are stored in up to **three levels** of feature.json, enriched pr
42
42
  | 04-consolidation | consolidation | consolidated |
43
43
  | 05-handoff | (per-module handoff) | handed-off |
44
44
 
45
- > **{context}** = `business` (default) | `platform` | `personal` — determined per application. In standalone mode, always `business`.
46
-
47
45
  ### Module-Level (Per Module)
48
- **Path:** `docs/{context}/{app}/{module}/business-analyse/v{X.Y}/feature.json`
49
- **Schema:** `docs/{context}/{app}/business-analyse/schemas/feature-schema.json` (deployed to project by step-00)
46
+ **Path:** `docs/{app}/{module}/business-analyse/v{X.Y}/feature.json`
47
+ **Schema:** `docs/{app}/business-analyse/schemas/feature-schema.json` (deployed to project by step-00)
50
48
  **$schema:** `"../../../business-analyse/schemas/feature-schema.json"` (relative in feature.json)
51
49
 
52
50
  | Step | Section enriched | Status after |
@@ -61,7 +59,7 @@ All BA outputs are stored in up to **three levels** of feature.json, enriched pr
61
59
  - **ba-writer**: Writes/updates feature.json (create, enrichSection, updateStatus, createVersion, createApplicationFeature, createProjectFeature, enrichApplicationRegistry, advanceModuleLoop, advanceApplicationLoop)
62
60
  - **ba-reader**: Reads feature.json (findFeature, findProjectFeature, readSection, answerQuestion, getSummaryForSkill, readApplicationContext, getCompletedModulesSummary, getCompletedApplicationsSummary)
63
61
 
64
- **Schemas:** Deployed to project at `docs/{context}/{app}/business-analyse/schemas/` (10 files, including project-schema.json). Source: `schemas/` in skill directory. Every feature.json includes `$schema` relative reference.
62
+ **Schemas:** Deployed to project at `docs/{app}/business-analyse/schemas/` (10 files, including project-schema.json). Source: `schemas/` in skill directory. Every feature.json includes `$schema` relative reference.
65
63
 
66
64
  ### Workflow Modes
67
65
 
@@ -73,35 +71,34 @@ All BA outputs are stored in up to **three levels** of feature.json, enriched pr
73
71
 
74
72
  ---
75
73
 
76
- ## 5-Level Navigation Hierarchy (SmartStack)
74
+ ## 4-Level Navigation Hierarchy (SmartStack)
77
75
 
78
76
  > **This is the structuring principle of the entire BA workflow.**
79
77
 
80
78
  The BA aligns with the SmartStack navigation hierarchy:
81
79
 
82
80
  ```
83
- Level 1: Context (business)
84
- Level 2: Application (Sales)
85
- Level 3: Module (Customers)
86
- Level 4: Section (list) ← sidebar nav
87
- Level 5: Resource (customer-grid)
88
- Level 5: Resource (customer-filters)
89
- Level 4: Section (detail) [hidden] ← reached by row click, route :id
90
- Level 5: Resource (customer-detail-header)
91
- Level 5: Resource (customer-detail-tabs)
92
- Level 5: Resource (customer-info-card)
93
- Level 5: Resource (customer-orders-grid) relation tab
94
- Level 5: Resource (customer-history) ← audit tab
95
- Level 3: Module (Orders)
96
- Level 4: Section (list) sidebar nav
97
- Level 4: Section (detail) [hidden] reached by row click
98
- Level 4: Section (approve) ← sidebar nav (workflow)
81
+ Level 1: Application (Sales)
82
+ Level 2: Module (Customers)
83
+ Level 3: Section (list) ← sidebar nav
84
+ Level 4: Resource (customer-grid)
85
+ Level 4: Resource (customer-filters)
86
+ Level 3: Section (detail) [hidden] ← reached by row click, route :id
87
+ Level 4: Resource (customer-detail-header)
88
+ Level 4: Resource (customer-detail-tabs)
89
+ Level 4: Resource (customer-info-card)
90
+ Level 4: Resource (customer-orders-grid) ← relation tab
91
+ Level 4: Resource (customer-history) audit tab
92
+ Level 2: Module (Orders)
93
+ Level 3: Section (list) ← sidebar nav
94
+ Level 3: Section (detail) [hidden] reached by row click
95
+ Level 3: Section (approve) sidebar nav (workflow)
99
96
  ```
100
97
 
101
- **CRITICAL — Application identification (Level 2):**
98
+ **CRITICAL — Application identification (Level 1):**
102
99
  The application is formally identified in step-01b (ALWAYS, even for single-app mode):
103
100
  - Code: PascalCase (e.g., "HumanResources")
104
- - Route: kebab-case (e.g., "/business/human-resources")
101
+ - Route: kebab-case (e.g., "/human-resources")
105
102
  - Icon: Lucide icon name
106
103
  - Sort order: position in navigation
107
104
  This creates the `seedDataCore.navigationApplications` entry that links modules to their parent application.
@@ -109,24 +106,24 @@ The `seedDataCore.applicationRoles` entries are also built from `cadrage.applica
109
106
 
110
107
  | BA Phase | Levels treated | What is defined |
111
108
  |----------|---------------|-----------------|
112
- | Cadrage (step-01) | Context + Application | Problem, stakeholders, scope, application-level roles |
109
+ | Cadrage (step-01) | Application | Problem, stakeholders, scope, application-level roles |
113
110
  | Decomposition (step-02) | Modules | Module list, dependencies, processing order |
114
- | Specification (step-03) | Module -> Sections -> Resources | Entities, BR, UC, permissions, ASCII/SVG mockups per section |
111
+ | Specification (step-03) | Module Sections Resources (levels 2-3-4) | Entities, BR, UC, permissions, ASCII/SVG mockups per section |
115
112
  | Consolidation (step-04) | Cross-module | Interactions, permission coherence, E2E flows |
116
113
  | Handoff (step-05) | All levels | Implementation mapping, prd.json |
117
114
 
118
115
  ### Route patterns
119
116
  ```
120
- /business/{application}/{module} ← list section (= module route, NO /list suffix)
121
- /business/{application}/{module}/:id ← detail page (= module route + /:id, NO /detail prefix)
122
- /business/{application}/{module}/{section} ← other sidebar sections (dashboard, approve, import, etc.)
117
+ /{application}/{module} ← list section (= module route, NO /list suffix)
118
+ /{application}/{module}/:id ← detail page (= module route + /:id, NO /detail prefix)
119
+ /{application}/{module}/{section} ← other sidebar sections (dashboard, approve, import, etc.)
123
120
  ```
124
121
 
125
122
  **Detail page routing:**
126
123
  - The detail page uses a parameterized route with `:id`
127
124
  - It is NOT registered as a sidebar navigation entry (`navigation: "hidden"`)
128
125
  - It is reached by clicking a row in the `list` section (action: `navigate:detail`)
129
- - The back button navigates to `/business/{application}/{module}`
126
+ - The back button navigates to `/{application}/{module}`
130
127
  - Route MUST be registered in frontend routing (App.tsx) alongside the list route
131
128
 
132
129
  > **ROUTE SPECIAL CASES (list and detail sections):**
@@ -165,29 +162,6 @@ The `seedDataCore.applicationRoles` entries are also built from `cadrage.applica
165
162
 
166
163
  ---
167
164
 
168
- ## Business Context Validation
169
-
170
- ```
171
- validate_business_context(context, workflow_mode):
172
- IF workflow_mode === "project" THEN
173
- // In project mode, applications can target any context
174
- IF context IN ['business', 'platform', 'personal'] THEN
175
- RETURN true
176
- END IF
177
- ERROR "Invalid context '${context}'. Allowed: business, platform, personal"
178
- RETURN false
179
- ELSE
180
- // In standalone mode, only business context is allowed
181
- IF context IN ['platform', 'personal', 'system'] THEN
182
- ERROR "BA restricted to 'business' context in standalone mode. Use multi-application project mode for other contexts."
183
- RETURN false
184
- END IF
185
- RETURN true
186
- END IF
187
- ```
188
-
189
- **CRITICAL:** In standalone mode (single application), BA works ONLY for the `business` context. In project mode (multi-application), each application can target `business`, `platform`, or `personal` contexts.
190
-
191
165
  ---
192
166
 
193
167
  ## Feature Directory Structure
@@ -199,35 +173,34 @@ docs/
199
173
  project-schema.json
200
174
  v1.0/
201
175
  feature.json <- PROJECT master ($schema: ../schemas/project-schema.json)
202
- {context}/ <- "business" | "platform" | "personal"
203
- {application}/
204
- business-analyse/
205
- schemas/ <- JSON SCHEMAS (deployed by step-00)
206
- feature-schema.json
207
- application-schema.json
208
- project-schema.json
209
- sections/
210
- analysis-schema.json
211
- discovery-schema.json
212
- handoff-schema.json
213
- metadata-schema.json
214
- specification-schema.json
215
- validation-schema.json
216
- shared/
217
- common-defs.json
218
- v1.0/
219
- feature.json <- APPLICATION master ($schema: ../schemas/application-schema.json)
220
- {module1}/
221
- business-analyse/
222
- v1.0/
223
- feature.json <- MODULE detail ($schema: ../../../business-analyse/schemas/feature-schema.json)
224
- {module2}/
225
- business-analyse/
226
- v1.0/
227
- feature.json <- MODULE detail
176
+ {application}/
177
+ business-analyse/
178
+ schemas/ <- JSON SCHEMAS (deployed by step-00)
179
+ feature-schema.json
180
+ application-schema.json
181
+ project-schema.json
182
+ sections/
183
+ analysis-schema.json
184
+ discovery-schema.json
185
+ handoff-schema.json
186
+ metadata-schema.json
187
+ specification-schema.json
188
+ validation-schema.json
189
+ shared/
190
+ common-defs.json
191
+ v1.0/
192
+ feature.json <- APPLICATION master ($schema: ../schemas/application-schema.json)
193
+ {module1}/
194
+ business-analyse/
195
+ v1.0/
196
+ feature.json <- MODULE detail ($schema: ../../../business-analyse/schemas/feature-schema.json)
197
+ {module2}/
198
+ business-analyse/
199
+ v1.0/
200
+ feature.json <- MODULE detail
228
201
  ```
229
202
 
230
- > In standalone mode (single app), `{context}` is always `business` and the project-level directory is NOT created.
203
+ > In standalone mode (single app), the project-level directory is NOT created.
231
204
 
232
205
  **Ralph Loop Integration (generated by step-05):**
233
206
 
@@ -263,12 +236,12 @@ generate_project_id():
263
236
 
264
237
  | Level | Format | Example |
265
238
  |-------|--------|---------|
266
- | Module | `{context}.{app}.{module}.{action}` | `business.human-resources.employees.read` |
267
- | Section | `{context}.{app}.{module}.{section}.{action}` | `business.human-resources.employees.departments.read` |
239
+ | Module | `{app}.{module}.{action}` | `human-resources.employees.read` |
240
+ | Section | `{app}.{module}.{section}.{action}` | `human-resources.employees.departments.read` |
268
241
 
269
242
  > **Rule:** Use module-level permissions for standard CRUD. Use section-level permissions only when a section requires distinct access control (e.g., dashboard, approve, import).
270
243
  >
271
- > **CRITICAL — All segments use kebab-case:** Multi-word codes MUST have hyphens. `human-resources`, NOT `humanresources`. Matches NavRoute convention. SmartStack.app ref: `business.support-client.my-tickets.read`
244
+ > **CRITICAL — All segments use kebab-case:** Multi-word codes MUST have hyphens. `human-resources`, NOT `humanresources`. Matches NavRoute convention. SmartStack.app ref: `support-client.my-tickets.read`
272
245
 
273
246
  | Action | Permission | Usage |
274
247
  |--------|------------|-------|
@@ -297,8 +270,8 @@ generate_project_id():
297
270
 
298
271
  | Type | Path |
299
272
  |------|------|
300
- | BA Feature | `docs/business/{app}/{module}/business-analyse/v{X.Y}/feature.json` |
301
- | User Guide | `docs/business/{app}/{module}/user-guide/v{X.Y}/guide.json` |
273
+ | BA Feature | `docs/{app}/{module}/business-analyse/v{X.Y}/feature.json` |
274
+ | User Guide | `docs/{app}/{module}/user-guide/v{X.Y}/guide.json` |
302
275
  | i18n | `web/smartstack-web/src/i18n/locales/{lang}/` |
303
276
 
304
277
  ---
@@ -397,7 +370,6 @@ Le champ `language` dans `feature.json.metadata.language` definit la langue :
397
370
  {
398
371
  "project": "{Name}",
399
372
  "lastFeatureId": 0,
400
- "context": "business",
401
373
  "language": "fr",
402
374
  "standards": ["BABOK-v3", "IEEE-830"],
403
375
  "contact": "support@atlshub.ch"
@@ -45,10 +45,10 @@
45
45
  >
46
46
  > | Concept | ❌ Wrong (entity attribute) | ✅ Correct (RBAC) |
47
47
  > |---------|---------------------------|-------------------|
48
- > | User role | `User.Role` property | Permission set `business.{app}.{module}.*` |
48
+ > | User role | `User.Role` property | Permission set `{app}.{module}.*` |
49
49
  > | Access level | `User.AccessLevel` enum | Permission matrix per role |
50
- > | Is admin | `User.IsAdmin` boolean | `business.{app}.{module}.admin` permission |
51
- > | Can edit | `User.CanEdit` boolean | `business.{app}.{module}.update` permission |
50
+ > | Is admin | `User.IsAdmin` boolean | `{app}.{module}.admin` permission |
51
+ > | Can edit | `User.CanEdit` boolean | `{app}.{module}.update` permission |
52
52
  >
53
53
  > When Q4.2 asks for "important attributes", **exclude** any role/permission/access concept.
54
54
 
@@ -27,7 +27,7 @@
27
27
 
28
28
  ## Platform Permission
29
29
 
30
- **Format:** `business.{application}.{module}.{action}`
30
+ **Format:** `{application}.{module}.{action}`
31
31
 
32
32
  | Action | Permission |
33
33
  |--------|------------|
@@ -34,7 +34,7 @@
34
34
  | Event notification | MediatR notification | `OrderCreatedNotification` |
35
35
  | Cross-module query | Read-only DTO from other module | `IClientQueryService` |
36
36
  | Navigation link | Menu entry in NavRoute | `business/{app}/{module}` |
37
- | Shared permission | Permission hierarchy | `business.{app}.*` covers all modules |
37
+ | Shared permission | Permission hierarchy | `{app}.*` covers all modules |
38
38
 
39
39
  ## Elicitation Guide
40
40
 
@@ -1,9 +1,9 @@
1
1
  # Application-Level Business Analyse Viewer
2
2
 
3
3
  > **Usage:** React component for application-level BA documentation within SmartStack web app
4
- > **Route:** `/docs/business/{app}` (application overview)
5
- > **Data source:** `docs/business/{app}/business-analyse/v{X.Y}/feature.json` (scope: "application")
6
- > **Linked to:** Module viewers at `/docs/business/{app}/{module}`
4
+ > **Route:** `/docs/{app}` (application overview)
5
+ > **Data source:** `docs/{app}/business-analyse/v{X.Y}/feature.json` (scope: "application")
6
+ > **Linked to:** Module viewers at `/docs/{app}/{module}`
7
7
 
8
8
  ---
9
9
 
@@ -23,7 +23,7 @@ interface ApplicationAnalyseViewerProps {
23
23
  ```typescript
24
24
  // In app router configuration
25
25
  {
26
- path: '/docs/business/:app',
26
+ path: '/docs/:app',
27
27
  component: ApplicationAnalyseViewer,
28
28
  exact: true
29
29
  }
@@ -88,7 +88,7 @@ Grid/cards layout showing all modules:
88
88
  └─────────────────────┘ └─────────────────────┘
89
89
  ```
90
90
 
91
- Each card links to the module viewer: `/docs/business/{app}/{module}`
91
+ Each card links to the module viewer: `/docs/{app}/{module}`
92
92
 
93
93
  Status colors:
94
94
  - ✓ Specified (green)
@@ -141,10 +141,10 @@ Per-Module Permission Paths:
141
141
  ┌──────────────┬──────────────────────────────────────────┐
142
142
  │ Module │ Permission Paths │
143
143
  ├──────────────┼──────────────────────────────────────────┤
144
- │ Customers │ business.sales.customers.{read|create|…}
145
- │ Products │ business.sales.products.{read|create|…}
146
- │ Orders │ business.sales.orders.{read|create|…}
147
- │ Invoices │ business.sales.invoices.{read|create|…}
144
+ │ Customers │ sales.customers.{read|create|…}
145
+ │ Products │ sales.products.{read|create|…}
146
+ │ Orders │ sales.orders.{read|create|…}
147
+ │ Invoices │ sales.invoices.{read|create|…}
148
148
  └──────────────┴──────────────────────────────────────────┘
149
149
  ```
150
150
 
@@ -198,14 +198,14 @@ Cross-module permission matrix display.
198
198
  ## Data Loading
199
199
 
200
200
  ```typescript
201
- import type { ApplicationFeatureJson } from '../types/business-analyse';
201
+ import type { ApplicationFeatureJson } from '../types/docs';
202
202
 
203
203
  export async function loadApplicationFeature(
204
204
  app: string,
205
205
  version: string
206
206
  ): Promise<ApplicationFeatureJson> {
207
207
  const response = await fetch(
208
- `/docs/business/${app}/business-analyse/v${version}/feature.json`
208
+ `/docs/${app}/business-analyse/v${version}/feature.json`
209
209
  );
210
210
  return response.json();
211
211
  }
@@ -214,7 +214,7 @@ export async function listApplicationVersions(
214
214
  app: string
215
215
  ): Promise<string[]> {
216
216
  const response = await fetch(
217
- `/api/docs/business/${app}/business-analyse/versions`
217
+ `/api/docs/${app}/business-analyse/versions`
218
218
  );
219
219
  return response.json();
220
220
  }
@@ -2,8 +2,8 @@
2
2
 
3
3
  > **Usage:** React component that renders feature.json directly
4
4
  > **Loaded in:** step-05b-deploy.md
5
- > **Data source (module):** `docs/business/{app}/{module}/business-analyse/v{X.Y}/feature.json`
6
- > **Data source (application):** `docs/business/{app}/business-analyse/v{X.Y}/feature.json`
5
+ > **Data source (module):** `docs/{app}/{module}/business-analyse/v{X.Y}/feature.json`
6
+ > **Data source (application):** `docs/{app}/business-analyse/v{X.Y}/feature.json`
7
7
  > **Related:** `react/application-viewer.md` for application-level view
8
8
  > **Context7:** /facebook/react, /lucide-icons/lucide-react
9
9
 
@@ -12,7 +12,7 @@
12
12
  ## BusinessAnalyseViewer Component
13
13
 
14
14
  ```tsx
15
- // web/smartstack-web/src/pages/docs/business/[app]/[module]/BusinessAnalyseViewer.tsx
15
+ // web/smartstack-web/src/pages/docs/[app]/[module]/BusinessAnalyseViewer.tsx
16
16
 
17
17
  import { useState, useEffect } from 'react';
18
18
  import { Link, useParams } from 'react-router-dom';
@@ -33,8 +33,8 @@ import {
33
33
  BookOpen,
34
34
  Target
35
35
  } from 'lucide-react';
36
- import type { FeatureJson, FeatureStatus } from '@/types/business-analyse';
37
- import { loadFeature, listVersions } from '@/services/businessAnalyse';
36
+ import type { FeatureJson, FeatureStatus } from '@/types/docs';
37
+ import { loadFeature, listVersions } from '@/services/docs';
38
38
 
39
39
  // Status Badge Component (supports both module and application statuses)
40
40
  function StatusBadge({ status }: { status: FeatureStatus }) {
@@ -173,11 +173,7 @@ export function BusinessAnalyseViewer() {
173
173
  {t('breadcrumb.docs', 'Documentation')}
174
174
  </Link>
175
175
  <span>/</span>
176
- <Link to="/docs/business" className="hover:text-[var(--color-primary-600)]">
177
- {t('breadcrumb.business', 'Business')}
178
- </Link>
179
- <span>/</span>
180
- <Link to={`/docs/business/${app}`} className="hover:text-[var(--color-primary-600)]">
176
+ <Link to={`/docs/${app}`} className="hover:text-[var(--color-primary-600)]">
181
177
  {feature.metadata.application}
182
178
  </Link>
183
179
  <span>/</span>
@@ -535,14 +531,14 @@ export function BusinessAnalyseViewer() {
535
531
  {/* Navigation Footer */}
536
532
  <div className="flex justify-between pt-6 border-t border-[var(--border-color)]">
537
533
  <Link
538
- to={`/docs/business/${app}`}
534
+ to={`/docs/${app}`}
539
535
  className="flex items-center gap-2 text-[var(--text-secondary)] hover:text-[var(--color-primary-600)]"
540
536
  >
541
537
  <ArrowRight className="w-4 h-4 rotate-180" />
542
538
  {t('nav.backToApp', 'Back to Application')}
543
539
  </Link>
544
540
  <Link
545
- to="/docs/business"
541
+ to="/docs"
546
542
  className="flex items-center gap-2 text-[var(--color-primary-600)]"
547
543
  >
548
544
  {t('nav.allModules', 'All Modules')}