@atlashub/smartstack-cli 3.39.0 → 3.40.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 (471) hide show
  1. package/.documentation/apex.html +644 -644
  2. package/.documentation/css/styles.css +2320 -2320
  3. package/.documentation/init.html +1377 -1377
  4. package/.documentation/js/app.js +780 -780
  5. package/.documentation/prd-json-v2.0.0.md +396 -396
  6. package/.documentation/testing-ba-e2e.md +462 -462
  7. package/config/default-config.json +95 -95
  8. package/config/mcp-defaults.json +62 -62
  9. package/config/settings.json +53 -53
  10. package/config/settings.local.example.json +16 -16
  11. package/dist/index.js.map +1 -1
  12. package/dist/mcp-entry.mjs +6 -4
  13. package/dist/mcp-entry.mjs.map +1 -1
  14. package/package.json +115 -115
  15. package/scripts/extract-api-endpoints.ts +325 -325
  16. package/scripts/extract-business-rules.ts +440 -440
  17. package/scripts/generate-doc-with-mock-ui.ts +804 -804
  18. package/scripts/health-check.sh +168 -168
  19. package/scripts/postinstall.js +18 -18
  20. package/templates/agents/action.md +37 -37
  21. package/templates/agents/ba-reader.md +378 -378
  22. package/templates/agents/ba-writer.md +861 -861
  23. package/templates/agents/code-reviewer.md +163 -163
  24. package/templates/agents/db-reader.md +149 -149
  25. package/templates/agents/docs-context-reader.md +143 -143
  26. package/templates/agents/docs-sync-checker.md +122 -122
  27. package/templates/agents/efcore/conflicts.md +84 -84
  28. package/templates/agents/efcore/db-deploy.md +74 -74
  29. package/templates/agents/efcore/db-reset.md +85 -85
  30. package/templates/agents/efcore/db-seed.md +61 -61
  31. package/templates/agents/efcore/db-status.md +86 -86
  32. package/templates/agents/efcore/migration.md +186 -186
  33. package/templates/agents/efcore/rebase-snapshot.md +108 -108
  34. package/templates/agents/efcore/scan.md +92 -92
  35. package/templates/agents/efcore/squash.md +161 -161
  36. package/templates/agents/explore-codebase.md +66 -66
  37. package/templates/agents/explore-docs.md +98 -98
  38. package/templates/agents/fix-grammar.md +50 -50
  39. package/templates/agents/gitflow/abort.md +45 -45
  40. package/templates/agents/gitflow/cleanup.md +96 -96
  41. package/templates/agents/gitflow/commit.md +236 -236
  42. package/templates/agents/gitflow/exec.md +48 -48
  43. package/templates/agents/gitflow/finish.md +146 -146
  44. package/templates/agents/gitflow/init-clone.md +199 -199
  45. package/templates/agents/gitflow/init-detect.md +137 -137
  46. package/templates/agents/gitflow/init-validate.md +225 -225
  47. package/templates/agents/gitflow/init.md +340 -340
  48. package/templates/agents/gitflow/merge.md +145 -145
  49. package/templates/agents/gitflow/plan.md +42 -42
  50. package/templates/agents/gitflow/pr.md +191 -191
  51. package/templates/agents/gitflow/review.md +49 -49
  52. package/templates/agents/gitflow/start.md +147 -147
  53. package/templates/agents/gitflow/status.md +95 -95
  54. package/templates/agents/mcp-healthcheck.md +163 -163
  55. package/templates/agents/snipper.md +37 -37
  56. package/templates/agents/websearch.md +46 -46
  57. package/templates/hooks/appsettings-guard.sh +76 -76
  58. package/templates/hooks/docs-drift-check.md +96 -96
  59. package/templates/hooks/ef-migration-check.md +139 -139
  60. package/templates/hooks/hooks.json +58 -58
  61. package/templates/hooks/mcp-check.md +64 -64
  62. package/templates/hooks/ralph-mcp-logger.sh +46 -46
  63. package/templates/hooks/ralph-session-end.sh +69 -69
  64. package/templates/hooks/stop-hook.sh +177 -177
  65. package/templates/hooks/wsl-dotnet-cleanup.sh +24 -24
  66. package/templates/mcp-scaffolding/component.tsx.hbs +318 -318
  67. package/templates/mcp-scaffolding/controller.cs.hbs +192 -192
  68. package/templates/mcp-scaffolding/entity-extension.cs.hbs +239 -239
  69. package/templates/mcp-scaffolding/frontend/api-client.ts.hbs +116 -116
  70. package/templates/mcp-scaffolding/frontend/nav-routes.ts.hbs +133 -133
  71. package/templates/mcp-scaffolding/frontend/routes.tsx.hbs +126 -126
  72. package/templates/mcp-scaffolding/migrations/seed-roles.cs.hbs +261 -261
  73. package/templates/mcp-scaffolding/service-extension.cs.hbs +53 -53
  74. package/templates/mcp-scaffolding/tests/controller.test.cs.hbs +436 -436
  75. package/templates/mcp-scaffolding/tests/entity.test.cs.hbs +239 -239
  76. package/templates/mcp-scaffolding/tests/repository.test.cs.hbs +441 -441
  77. package/templates/mcp-scaffolding/tests/security.test.cs.hbs +442 -442
  78. package/templates/mcp-scaffolding/tests/service.test.cs.hbs +402 -402
  79. package/templates/mcp-scaffolding/tests/validator.test.cs.hbs +428 -428
  80. package/templates/project/DependencyInjection.Application.cs.template +25 -25
  81. package/templates/project/DependencyInjection.Infrastructure.cs.template +61 -61
  82. package/templates/project/DesignTimeExtensionsDbContextFactory.cs.template +70 -70
  83. package/templates/project/ExampleEntity.cs.template +116 -116
  84. package/templates/project/ExampleEntityConfiguration.cs.template +64 -64
  85. package/templates/project/ExampleService.cs.template +146 -146
  86. package/templates/project/ExtensionsDbContext.cs.template +41 -41
  87. package/templates/project/IExtensionsDbContext.cs.template +22 -22
  88. package/templates/project/Program.cs.template +47 -47
  89. package/templates/project/README.md +79 -79
  90. package/templates/project/api.ts.template +12 -12
  91. package/templates/project/appsettings.json.template +170 -170
  92. package/templates/project/claude-settings.json.template +5 -5
  93. package/templates/project/test-frontend/msw/handlers.ts +58 -58
  94. package/templates/project/test-frontend/msw/server.ts +25 -25
  95. package/templates/project/test-frontend/setup.ts +16 -16
  96. package/templates/project/test-frontend/test-utils.tsx +59 -59
  97. package/templates/project/test-frontend/vitest.config.ts +31 -31
  98. package/templates/ralph/README.md +93 -93
  99. package/templates/ralph/ralph.config.yaml +113 -113
  100. package/templates/scripts/setup-ralph-loop.sh +173 -173
  101. package/templates/skills/_resources/config-safety.md +61 -61
  102. package/templates/skills/_resources/context-digest-template.md +53 -53
  103. package/templates/skills/_resources/doc-context-cache.md +60 -60
  104. package/templates/skills/_resources/docs-manifest-schema.md +155 -155
  105. package/templates/skills/_resources/formatting-guide.md +124 -124
  106. package/templates/skills/_resources/mcp-validate-documentation-spec.md +181 -181
  107. package/templates/skills/_shared.md +228 -228
  108. package/templates/skills/admin/SKILL.md +48 -48
  109. package/templates/skills/ai-prompt/SKILL.md +107 -107
  110. package/templates/skills/ai-prompt/steps/step-00-init.md +47 -47
  111. package/templates/skills/ai-prompt/steps/step-01-implementation.md +122 -122
  112. package/templates/skills/apex/SKILL.md +168 -168
  113. package/templates/skills/apex/_shared.md +141 -141
  114. package/templates/skills/apex/references/agent-teams-protocol.md +164 -164
  115. package/templates/skills/apex/references/analysis-methods.md +141 -141
  116. package/templates/skills/apex/references/challenge-questions.md +145 -145
  117. package/templates/skills/apex/references/code-generation.md +412 -412
  118. package/templates/skills/apex/references/core-seed-data.md +1437 -1437
  119. package/templates/skills/apex/references/error-classification.md +144 -144
  120. package/templates/skills/apex/references/examine-build-validation.md +82 -82
  121. package/templates/skills/apex/references/execution-frontend-gates.md +177 -177
  122. package/templates/skills/apex/references/execution-frontend-patterns.md +105 -105
  123. package/templates/skills/apex/references/execution-layer1-rules.md +96 -96
  124. package/templates/skills/apex/references/initialization-challenge-flow.md +110 -110
  125. package/templates/skills/apex/references/planning-layer-mapping.md +151 -151
  126. package/templates/skills/apex/references/post-checks.md +1584 -1584
  127. package/templates/skills/apex/references/smartstack-api.md +1053 -1053
  128. package/templates/skills/apex/references/smartstack-frontend.md +1571 -1571
  129. package/templates/skills/apex/references/smartstack-layers.md +402 -402
  130. package/templates/skills/apex/steps/step-00-init.md +307 -307
  131. package/templates/skills/apex/steps/step-01-analyze.md +165 -165
  132. package/templates/skills/apex/steps/step-02-plan.md +144 -144
  133. package/templates/skills/apex/steps/step-03-execute.md +328 -328
  134. package/templates/skills/apex/steps/step-04-examine.md +263 -263
  135. package/templates/skills/apex/steps/step-05-deep-review.md +129 -129
  136. package/templates/skills/apex/steps/step-06-resolve.md +101 -101
  137. package/templates/skills/apex/steps/step-07-tests.md +238 -238
  138. package/templates/skills/apex/steps/step-08-run-tests.md +125 -125
  139. package/templates/skills/application/SKILL.md +4 -4
  140. package/templates/skills/application/references/application-roles-template.md +227 -227
  141. package/templates/skills/application/references/backend-controller-hierarchy.md +58 -58
  142. package/templates/skills/application/references/backend-entity-seeding.md +72 -72
  143. package/templates/skills/application/references/backend-seeding-and-dto-output.md +83 -83
  144. package/templates/skills/application/references/backend-table-prefix-mapping.md +79 -79
  145. package/templates/skills/application/references/backend-verification.md +88 -88
  146. package/templates/skills/application/references/frontend-i18n-and-output.md +67 -67
  147. package/templates/skills/application/references/frontend-route-naming.md +117 -117
  148. package/templates/skills/application/references/frontend-route-wiring-app-tsx.md +107 -107
  149. package/templates/skills/application/references/frontend-verification.md +156 -156
  150. package/templates/skills/application/references/migration-checklist-troubleshooting.md +1 -1
  151. package/templates/skills/application/references/provider-template.md +177 -177
  152. package/templates/skills/application/references/roles-client-project-handling.md +55 -55
  153. package/templates/skills/application/references/roles-fallback-procedure.md +149 -149
  154. package/templates/skills/application/references/test-coverage-requirements.md +213 -213
  155. package/templates/skills/application/references/test-frontend.md +73 -73
  156. package/templates/skills/application/references/test-prerequisites.md +72 -72
  157. package/templates/skills/application/steps/step-05-frontend.md +176 -176
  158. package/templates/skills/application/steps/step-06-migration.md +193 -193
  159. package/templates/skills/application/steps/step-07-tests.md +356 -356
  160. package/templates/skills/application/steps/step-08-documentation.md +137 -137
  161. package/templates/skills/application/templates-backend.md +463 -463
  162. package/templates/skills/application/templates-frontend.md +685 -685
  163. package/templates/skills/application/templates-i18n.md +520 -520
  164. package/templates/skills/application/templates-seed.md +1096 -1096
  165. package/templates/skills/business-analyse/SKILL.md +327 -327
  166. package/templates/skills/business-analyse/_architecture.md +123 -123
  167. package/templates/skills/business-analyse/_elicitation.md +206 -206
  168. package/templates/skills/business-analyse/_module-loop.md +115 -115
  169. package/templates/skills/business-analyse/_shared.md +383 -383
  170. package/templates/skills/business-analyse/_suggestions.md +34 -34
  171. package/templates/skills/business-analyse/html/ba-interactive.html +4477 -4477
  172. package/templates/skills/business-analyse/html/build-html.js +77 -77
  173. package/templates/skills/business-analyse/html/src/scripts/01-data-init.js +150 -150
  174. package/templates/skills/business-analyse/html/src/scripts/02-navigation.js +227 -227
  175. package/templates/skills/business-analyse/html/src/scripts/03-render-cadrage.js +199 -199
  176. package/templates/skills/business-analyse/html/src/scripts/04-render-modules.js +205 -205
  177. package/templates/skills/business-analyse/html/src/scripts/05-render-specs.js +647 -647
  178. package/templates/skills/business-analyse/html/src/scripts/06-render-consolidation.js +195 -195
  179. package/templates/skills/business-analyse/html/src/scripts/07-render-handoff.js +92 -92
  180. package/templates/skills/business-analyse/html/src/scripts/08-editing.js +135 -135
  181. package/templates/skills/business-analyse/html/src/scripts/09-export.js +168 -168
  182. package/templates/skills/business-analyse/html/src/scripts/10-comments.js +171 -171
  183. package/templates/skills/business-analyse/html/src/scripts/11-review-panel.js +166 -166
  184. package/templates/skills/business-analyse/html/src/styles/01-variables.css +38 -38
  185. package/templates/skills/business-analyse/html/src/styles/02-layout.css +101 -101
  186. package/templates/skills/business-analyse/html/src/styles/03-navigation.css +120 -120
  187. package/templates/skills/business-analyse/html/src/styles/04-cards.css +196 -196
  188. package/templates/skills/business-analyse/html/src/styles/05-modules.css +454 -454
  189. package/templates/skills/business-analyse/html/src/styles/06-wireframes.css +272 -272
  190. package/templates/skills/business-analyse/html/src/styles/07-comments.css +184 -184
  191. package/templates/skills/business-analyse/html/src/styles/08-review-panel.css +241 -241
  192. package/templates/skills/business-analyse/html/src/template.html +516 -516
  193. package/templates/skills/business-analyse/patterns/suggestion-catalog.md +546 -546
  194. package/templates/skills/business-analyse/questionnaire/00-application.md +160 -160
  195. package/templates/skills/business-analyse/questionnaire/00b-project.md +85 -85
  196. package/templates/skills/business-analyse/questionnaire/01-context.md +185 -185
  197. package/templates/skills/business-analyse/questionnaire/02-stakeholders.md +189 -189
  198. package/templates/skills/business-analyse/questionnaire/03-scope.md +164 -164
  199. package/templates/skills/business-analyse/questionnaire/04-data.md +88 -88
  200. package/templates/skills/business-analyse/questionnaire/05-integrations.md +58 -58
  201. package/templates/skills/business-analyse/questionnaire/06-security.md +68 -68
  202. package/templates/skills/business-analyse/questionnaire/07-ui.md +76 -76
  203. package/templates/skills/business-analyse/questionnaire/08-performance.md +42 -42
  204. package/templates/skills/business-analyse/questionnaire/09-constraints.md +45 -45
  205. package/templates/skills/business-analyse/questionnaire/10-documentation.md +43 -43
  206. package/templates/skills/business-analyse/questionnaire/11-data-lifecycle.md +59 -59
  207. package/templates/skills/business-analyse/questionnaire/12-migration.md +58 -58
  208. package/templates/skills/business-analyse/questionnaire/13-cross-module.md +69 -69
  209. package/templates/skills/business-analyse/questionnaire/14-risk-assumptions.md +135 -135
  210. package/templates/skills/business-analyse/questionnaire/15-success-metrics.md +136 -136
  211. package/templates/skills/business-analyse/questionnaire.md +337 -337
  212. package/templates/skills/business-analyse/react/application-viewer.md +242 -242
  213. package/templates/skills/business-analyse/react/components.md +551 -551
  214. package/templates/skills/business-analyse/react/i18n-template.md +306 -306
  215. package/templates/skills/business-analyse/references/acceptance-criteria.md +169 -169
  216. package/templates/skills/business-analyse/references/agent-module-prompt.md +362 -362
  217. package/templates/skills/business-analyse/references/agent-pooling-best-practices.md +557 -557
  218. package/templates/skills/business-analyse/references/analysis-semantic-checks.md +190 -190
  219. package/templates/skills/business-analyse/references/cache-warming-strategy.md +566 -566
  220. package/templates/skills/business-analyse/references/cadrage-challenge-patterns.md +41 -41
  221. package/templates/skills/business-analyse/references/cadrage-coverage-matrix.md +74 -74
  222. package/templates/skills/business-analyse/references/cadrage-pre-analysis.md +115 -115
  223. package/templates/skills/business-analyse/references/cadrage-shared-modules.md +68 -69
  224. package/templates/skills/business-analyse/references/cadrage-structure-cards.md +85 -85
  225. package/templates/skills/business-analyse/references/compilation-structure-cards.md +297 -297
  226. package/templates/skills/business-analyse/references/consolidation-structural-checks.md +107 -107
  227. package/templates/skills/business-analyse/references/deploy-data-build.md +180 -180
  228. package/templates/skills/business-analyse/references/deploy-modes.md +118 -118
  229. package/templates/skills/business-analyse/references/detection-strategies.md +424 -424
  230. package/templates/skills/business-analyse/references/entity-architecture-decision.md +218 -218
  231. package/templates/skills/business-analyse/references/handoff-file-templates.md +120 -120
  232. package/templates/skills/business-analyse/references/handoff-mappings.md +81 -81
  233. package/templates/skills/business-analyse/references/handoff-seeddata-generation.md +312 -312
  234. package/templates/skills/business-analyse/references/html-data-mapping.md +299 -299
  235. package/templates/skills/business-analyse/references/init-schema-deployment.md +65 -65
  236. package/templates/skills/business-analyse/references/naming-conventions.md +243 -243
  237. package/templates/skills/business-analyse/references/prd-generation.md +258 -258
  238. package/templates/skills/business-analyse/references/review-data-mapping.md +363 -363
  239. package/templates/skills/business-analyse/references/robustness-checks.md +542 -542
  240. package/templates/skills/business-analyse/references/spec-auto-inference.md +111 -111
  241. package/templates/skills/business-analyse/references/team-orchestration.md +1022 -1022
  242. package/templates/skills/business-analyse/references/ui-dashboard-spec.md +85 -85
  243. package/templates/skills/business-analyse/references/ui-resource-cards.md +259 -259
  244. package/templates/skills/business-analyse/references/validate-incremental-html.md +121 -121
  245. package/templates/skills/business-analyse/references/validation-checklist.md +347 -347
  246. package/templates/skills/business-analyse/references/wireframe-svg-style-guide.md +335 -335
  247. package/templates/skills/business-analyse/schemas/application-schema.json +453 -453
  248. package/templates/skills/business-analyse/schemas/feature-schema.json +53 -53
  249. package/templates/skills/business-analyse/schemas/project-schema.json +485 -485
  250. package/templates/skills/business-analyse/schemas/sections/analysis-schema.json +201 -201
  251. package/templates/skills/business-analyse/schemas/sections/discovery-schema.json +82 -82
  252. package/templates/skills/business-analyse/schemas/sections/handoff-schema.json +80 -80
  253. package/templates/skills/business-analyse/schemas/sections/metadata-schema.json +70 -70
  254. package/templates/skills/business-analyse/schemas/sections/specification-schema.json +547 -547
  255. package/templates/skills/business-analyse/schemas/sections/validation-schema.json +93 -93
  256. package/templates/skills/business-analyse/schemas/shared/common-defs.json +226 -226
  257. package/templates/skills/business-analyse/steps/step-00-init.md +575 -576
  258. package/templates/skills/business-analyse/steps/step-01-cadrage.md +767 -767
  259. package/templates/skills/business-analyse/steps/step-01b-applications.md +419 -419
  260. package/templates/skills/business-analyse/steps/step-02-decomposition.md +387 -387
  261. package/templates/skills/business-analyse/steps/step-03a-data.md +16 -16
  262. package/templates/skills/business-analyse/steps/step-03a1-setup.md +506 -506
  263. package/templates/skills/business-analyse/steps/step-03a2-analysis.md +252 -252
  264. package/templates/skills/business-analyse/steps/step-03b-ui.md +425 -425
  265. package/templates/skills/business-analyse/steps/step-03c-compile.md +611 -611
  266. package/templates/skills/business-analyse/steps/step-03d-validate.md +783 -783
  267. package/templates/skills/business-analyse/steps/step-04-consolidation.md +17 -17
  268. package/templates/skills/business-analyse/steps/step-04a-collect.md +415 -415
  269. package/templates/skills/business-analyse/steps/step-04b-analyze.md +163 -163
  270. package/templates/skills/business-analyse/steps/step-04c-decide.md +186 -186
  271. package/templates/skills/business-analyse/steps/step-05a-handoff.md +840 -840
  272. package/templates/skills/business-analyse/steps/step-05b-deploy.md +522 -522
  273. package/templates/skills/business-analyse/steps/step-05c-ralph-readiness.md +703 -703
  274. package/templates/skills/business-analyse/steps/step-06-review.md +278 -278
  275. package/templates/skills/business-analyse/templates/tpl-frd.md +168 -168
  276. package/templates/skills/business-analyse/templates/tpl-handoff.md +186 -186
  277. package/templates/skills/business-analyse/templates/tpl-launch-displays.md +59 -59
  278. package/templates/skills/business-analyse/templates/tpl-progress.md +172 -172
  279. package/templates/skills/business-analyse/templates-frd.md +476 -476
  280. package/templates/skills/business-analyse/templates-react.md +574 -574
  281. package/templates/skills/cc-agent/SKILL.md +129 -129
  282. package/templates/skills/cc-agent/references/agent-behavior-patterns.md +95 -95
  283. package/templates/skills/cc-agent/references/agent-frontmatter.md +213 -213
  284. package/templates/skills/cc-agent/references/permission-modes.md +102 -102
  285. package/templates/skills/cc-agent/references/tools-reference.md +144 -144
  286. package/templates/skills/cc-agent/steps/step-00-init.md +134 -134
  287. package/templates/skills/cc-agent/steps/step-01-design.md +186 -186
  288. package/templates/skills/cc-agent/steps/step-02-generate.md +131 -131
  289. package/templates/skills/cc-agent/steps/step-03-validate.md +130 -130
  290. package/templates/skills/cc-agent/templates/agent-categorized.md +67 -67
  291. package/templates/skills/cc-agent/templates/agent-standalone.md +56 -56
  292. package/templates/skills/cc-agent/templates/agent-with-skills.md +94 -94
  293. package/templates/skills/cc-audit/SKILL.md +108 -108
  294. package/templates/skills/cc-audit/references/agent-checklist.md +91 -91
  295. package/templates/skills/cc-audit/references/hook-checklist.md +110 -110
  296. package/templates/skills/cc-audit/references/skill-checklist.md +70 -70
  297. package/templates/skills/cc-audit/steps/step-00-init.md +98 -98
  298. package/templates/skills/cc-audit/steps/step-01-scan.md +142 -142
  299. package/templates/skills/cc-audit/steps/step-02-analyze.md +158 -158
  300. package/templates/skills/cc-audit/steps/step-03-report.md +142 -142
  301. package/templates/skills/cc-skill/SKILL.md +134 -134
  302. package/templates/skills/cc-skill/references/best-practices.md +167 -167
  303. package/templates/skills/cc-skill/references/frontmatter-reference.md +182 -182
  304. package/templates/skills/cc-skill/references/skill-patterns.md +199 -199
  305. package/templates/skills/cc-skill/steps/step-00-init.md +119 -119
  306. package/templates/skills/cc-skill/steps/step-01-design.md +199 -199
  307. package/templates/skills/cc-skill/steps/step-02-generate.md +145 -145
  308. package/templates/skills/cc-skill/steps/step-03-steps.md +151 -151
  309. package/templates/skills/cc-skill/steps/step-04-validate.md +124 -124
  310. package/templates/skills/cc-skill/templates/skill-forked.md +85 -85
  311. package/templates/skills/cc-skill/templates/skill-progressive.md +102 -102
  312. package/templates/skills/cc-skill/templates/skill-simple.md +75 -75
  313. package/templates/skills/cc-skill/templates/step-template.md +82 -82
  314. package/templates/skills/check-version/SKILL.md +196 -196
  315. package/templates/skills/controller/SKILL.md +162 -162
  316. package/templates/skills/controller/postman-templates.md +614 -614
  317. package/templates/skills/controller/references/controller-code-templates.md +159 -159
  318. package/templates/skills/controller/references/mcp-scaffold-workflow.md +209 -209
  319. package/templates/skills/controller/references/permission-sync-templates.md +149 -149
  320. package/templates/skills/controller/steps/step-00-init.md +193 -191
  321. package/templates/skills/controller/steps/step-01-analyze.md +146 -146
  322. package/templates/skills/controller/steps/step-02-plan.md +176 -176
  323. package/templates/skills/controller/steps/step-03-generate.md +189 -189
  324. package/templates/skills/controller/steps/step-04-perms.md +80 -80
  325. package/templates/skills/controller/steps/step-05-validate.md +107 -107
  326. package/templates/skills/controller/templates.md +1555 -1555
  327. package/templates/skills/debug/SKILL.md +70 -70
  328. package/templates/skills/debug/references/team-protocol.md +232 -232
  329. package/templates/skills/debug/steps/step-00-init.md +57 -57
  330. package/templates/skills/debug/steps/step-01-analyze.md +219 -219
  331. package/templates/skills/debug/steps/step-02-resolve.md +85 -85
  332. package/templates/skills/documentation/SKILL.md +132 -132
  333. package/templates/skills/documentation/data-schema.md +227 -227
  334. package/templates/skills/documentation/steps/step-00-init.md +70 -70
  335. package/templates/skills/documentation/steps/step-01-scan.md +113 -113
  336. package/templates/skills/documentation/steps/step-02-generate.md +231 -231
  337. package/templates/skills/documentation/steps/step-03-validate.md +251 -238
  338. package/templates/skills/documentation/templates.md +662 -663
  339. package/templates/skills/efcore/SKILL.md +167 -167
  340. package/templates/skills/efcore/references/both-contexts.md +32 -32
  341. package/templates/skills/efcore/references/database-operations.md +67 -67
  342. package/templates/skills/efcore/references/destructive-operations.md +38 -38
  343. package/templates/skills/efcore/references/reset-operations.md +81 -81
  344. package/templates/skills/efcore/references/seed-methods.md +86 -86
  345. package/templates/skills/efcore/references/shared-init-functions.md +250 -250
  346. package/templates/skills/efcore/references/sql-objects-injection.md +61 -61
  347. package/templates/skills/efcore/references/troubleshooting.md +81 -81
  348. package/templates/skills/efcore/references/zero-downtime-patterns.md +227 -227
  349. package/templates/skills/efcore/steps/db/step-deploy.md +217 -217
  350. package/templates/skills/efcore/steps/db/step-reset.md +186 -186
  351. package/templates/skills/efcore/steps/db/step-seed.md +166 -166
  352. package/templates/skills/efcore/steps/db/step-status.md +173 -173
  353. package/templates/skills/efcore/steps/migration/step-00-init.md +102 -102
  354. package/templates/skills/efcore/steps/migration/step-01-check.md +164 -164
  355. package/templates/skills/efcore/steps/migration/step-02-create.md +160 -160
  356. package/templates/skills/efcore/steps/migration/step-03-validate.md +168 -168
  357. package/templates/skills/efcore/steps/rebase-snapshot/step-00-init.md +173 -173
  358. package/templates/skills/efcore/steps/rebase-snapshot/step-01-backup.md +100 -100
  359. package/templates/skills/efcore/steps/rebase-snapshot/step-02-fetch.md +115 -115
  360. package/templates/skills/efcore/steps/rebase-snapshot/step-03-create.md +112 -112
  361. package/templates/skills/efcore/steps/rebase-snapshot/step-04-validate.md +157 -157
  362. package/templates/skills/efcore/steps/shared/step-00-init.md +131 -131
  363. package/templates/skills/efcore/steps/squash/step-00-init.md +141 -141
  364. package/templates/skills/efcore/steps/squash/step-01-backup.md +120 -120
  365. package/templates/skills/efcore/steps/squash/step-02-fetch.md +168 -168
  366. package/templates/skills/efcore/steps/squash/step-03-create.md +184 -184
  367. package/templates/skills/efcore/steps/squash/step-04-validate.md +174 -174
  368. package/templates/skills/explore/SKILL.md +98 -98
  369. package/templates/skills/feature-full/SKILL.md +111 -111
  370. package/templates/skills/feature-full/steps/step-00-init.md +57 -57
  371. package/templates/skills/feature-full/steps/step-01-implementation.md +120 -120
  372. package/templates/skills/gitflow/SKILL.md +377 -377
  373. package/templates/skills/gitflow/_shared.md +620 -620
  374. package/templates/skills/gitflow/phases/abort.md +189 -189
  375. package/templates/skills/gitflow/phases/cleanup.md +234 -234
  376. package/templates/skills/gitflow/phases/status.md +192 -192
  377. package/templates/skills/gitflow/references/commit-message-generation.md +58 -58
  378. package/templates/skills/gitflow/references/commit-migration-validation.md +49 -49
  379. package/templates/skills/gitflow/references/finish-cleanup.md +55 -55
  380. package/templates/skills/gitflow/references/finish-version-bumping.md +45 -45
  381. package/templates/skills/gitflow/references/init-config-template.md +135 -135
  382. package/templates/skills/gitflow/references/init-environment-detection.md +41 -41
  383. package/templates/skills/gitflow/references/init-name-normalization.md +103 -103
  384. package/templates/skills/gitflow/references/init-questions.md +185 -185
  385. package/templates/skills/gitflow/references/init-structure-creation.md +75 -75
  386. package/templates/skills/gitflow/references/init-version-detection.md +21 -21
  387. package/templates/skills/gitflow/references/init-workspace-detection.md +43 -43
  388. package/templates/skills/gitflow/references/merge-ci-status.md +36 -36
  389. package/templates/skills/gitflow/references/merge-execution.md +62 -62
  390. package/templates/skills/gitflow/references/merge-pr-context.md +76 -76
  391. package/templates/skills/gitflow/references/plan-template.md +69 -69
  392. package/templates/skills/gitflow/references/pr-build-checks.md +60 -60
  393. package/templates/skills/gitflow/references/pr-generation.md +58 -58
  394. package/templates/skills/gitflow/references/start-branch-normalization.md +28 -28
  395. package/templates/skills/gitflow/references/start-efcore-preflight.md +70 -70
  396. package/templates/skills/gitflow/references/start-local-config.md +113 -113
  397. package/templates/skills/gitflow/references/start-worktree-creation.md +50 -50
  398. package/templates/skills/gitflow/references/sync-push-verify.md +44 -44
  399. package/templates/skills/gitflow/references/sync-rebase-conflicts.md +38 -38
  400. package/templates/skills/gitflow/steps/step-commit.md +199 -199
  401. package/templates/skills/gitflow/steps/step-finish.md +147 -147
  402. package/templates/skills/gitflow/steps/step-init.md +190 -190
  403. package/templates/skills/gitflow/steps/step-merge.md +85 -85
  404. package/templates/skills/gitflow/steps/step-plan.md +151 -151
  405. package/templates/skills/gitflow/steps/step-pr.md +199 -199
  406. package/templates/skills/gitflow/steps/step-start.md +195 -195
  407. package/templates/skills/gitflow/steps/step-sync.md +161 -161
  408. package/templates/skills/gitflow/templates/config.json +72 -72
  409. package/templates/skills/mcp/SKILL.md +62 -62
  410. package/templates/skills/mcp/steps/step-01-healthcheck.md +108 -108
  411. package/templates/skills/mcp/steps/step-02-tools.md +73 -73
  412. package/templates/skills/notification/SKILL.md +173 -173
  413. package/templates/skills/quick-search/SKILL.md +99 -99
  414. package/templates/skills/ralph-loop/SKILL.md +234 -234
  415. package/templates/skills/ralph-loop/references/category-completeness.md +185 -185
  416. package/templates/skills/ralph-loop/references/category-rules.md +96 -96
  417. package/templates/skills/ralph-loop/references/compact-loop.md +300 -300
  418. package/templates/skills/ralph-loop/references/init-resume-recovery.md +127 -127
  419. package/templates/skills/ralph-loop/references/module-transition.md +151 -151
  420. package/templates/skills/ralph-loop/references/multi-module-queue.md +171 -171
  421. package/templates/skills/ralph-loop/references/parallel-execution.md +246 -246
  422. package/templates/skills/ralph-loop/references/section-splitting.md +439 -439
  423. package/templates/skills/ralph-loop/references/task-transform-legacy.md +256 -256
  424. package/templates/skills/ralph-loop/references/team-orchestration.md +547 -547
  425. package/templates/skills/ralph-loop/steps/step-00-init.md +150 -150
  426. package/templates/skills/ralph-loop/steps/step-01-task.md +174 -174
  427. package/templates/skills/ralph-loop/steps/step-02-execute.md +177 -177
  428. package/templates/skills/ralph-loop/steps/step-03-commit.md +92 -92
  429. package/templates/skills/ralph-loop/steps/step-04-check.md +207 -207
  430. package/templates/skills/ralph-loop/steps/step-05-report.md +175 -175
  431. package/templates/skills/refactor/SKILL.md +56 -56
  432. package/templates/skills/refactor/steps/step-01-discover.md +60 -60
  433. package/templates/skills/refactor/steps/step-02-execute.md +67 -67
  434. package/templates/skills/review-code/SKILL.md +94 -94
  435. package/templates/skills/review-code/references/clean-code-principles.md +292 -292
  436. package/templates/skills/review-code/references/code-quality-metrics.md +174 -174
  437. package/templates/skills/review-code/references/feedback-patterns.md +149 -149
  438. package/templates/skills/review-code/references/owasp-api-top10.md +243 -243
  439. package/templates/skills/review-code/references/security-checklist.md +212 -212
  440. package/templates/skills/review-code/steps/step-01-smartstack.md +96 -96
  441. package/templates/skills/review-code/steps/step-02-detailed-review.md +80 -80
  442. package/templates/skills/review-code/steps/step-03-react.md +44 -44
  443. package/templates/skills/ui-components/SKILL.md +137 -137
  444. package/templates/skills/ui-components/accessibility.md +170 -170
  445. package/templates/skills/ui-components/patterns/dashboard-chart.md +327 -327
  446. package/templates/skills/ui-components/patterns/data-table.md +39 -39
  447. package/templates/skills/ui-components/patterns/entity-card.md +77 -77
  448. package/templates/skills/ui-components/patterns/grid-layout.md +91 -91
  449. package/templates/skills/ui-components/patterns/kanban.md +43 -43
  450. package/templates/skills/ui-components/responsive-guidelines.md +278 -278
  451. package/templates/skills/ui-components/style-guide.md +113 -113
  452. package/templates/skills/utils/SKILL.md +44 -44
  453. package/templates/skills/utils/subcommands/test-web-config.md +152 -152
  454. package/templates/skills/utils/subcommands/test-web.md +123 -123
  455. package/templates/skills/validate/SKILL.md +181 -181
  456. package/templates/skills/validate-feature/SKILL.md +101 -101
  457. package/templates/skills/validate-feature/references/api-smoke-tests.md +140 -140
  458. package/templates/skills/validate-feature/references/db-validation-checks.md +180 -180
  459. package/templates/skills/validate-feature/steps/step-00-dependencies.md +121 -121
  460. package/templates/skills/validate-feature/steps/step-01-compile.md +39 -39
  461. package/templates/skills/validate-feature/steps/step-02-unit-tests.md +45 -45
  462. package/templates/skills/validate-feature/steps/step-03-integration-tests.md +53 -53
  463. package/templates/skills/validate-feature/steps/step-04-api-smoke.md +94 -94
  464. package/templates/skills/validate-feature/steps/step-05-db-validation.md +149 -149
  465. package/templates/skills/workflow/SKILL.md +127 -127
  466. package/templates/skills/workflow/steps/step-00-init.md +57 -57
  467. package/templates/skills/workflow/steps/step-01-implementation.md +84 -84
  468. package/templates/test-web/api-health.json +38 -38
  469. package/templates/test-web/minimal.json +19 -19
  470. package/templates/test-web/npm-package.json +46 -46
  471. package/templates/test-web/seo-check.json +54 -54
@@ -1,780 +1,780 @@
1
- /* ============================================
2
- CLAUDE TOOLS DOCUMENTATION - APP
3
- ============================================ */
4
-
5
- document.addEventListener('DOMContentLoaded', function() {
6
- initSidebar();
7
- initLanguageSwitch();
8
- initCopyButtons();
9
- initMobileMenu();
10
- initSidebarToc();
11
- initScrollSpy();
12
- initInteractiveDiagram();
13
- initSearch();
14
- initCopyableCommands();
15
- });
16
-
17
- /* ============================================
18
- SIDEBAR
19
- ============================================ */
20
-
21
- function initSidebar() {
22
- const sidebar = document.querySelector('.sidebar');
23
- const toggle = document.querySelector('.sidebar-toggle');
24
-
25
- if (!sidebar || !toggle) return;
26
-
27
- // Load saved state
28
- const isCollapsed = localStorage.getItem('sidebar-collapsed') === 'true';
29
- if (isCollapsed) {
30
- sidebar.classList.add('collapsed');
31
- }
32
-
33
- toggle.addEventListener('click', function() {
34
- sidebar.classList.toggle('collapsed');
35
- localStorage.setItem('sidebar-collapsed', sidebar.classList.contains('collapsed'));
36
- });
37
-
38
- // Set active nav item
39
- const currentPage = window.location.pathname.split('/').pop() || 'index.html';
40
- document.querySelectorAll('.nav-item').forEach(item => {
41
- if (item.getAttribute('href') === currentPage) {
42
- item.classList.add('active');
43
- }
44
- });
45
- }
46
-
47
- /* ============================================
48
- LANGUAGE SWITCH
49
- ============================================ */
50
-
51
- function initLanguageSwitch() {
52
- const langSelect = document.getElementById('lang-select');
53
-
54
- // Load saved language
55
- const savedLang = localStorage.getItem('doc-language') || 'fr';
56
- setLanguage(savedLang);
57
-
58
- // Set dropdown to saved value
59
- if (langSelect) {
60
- langSelect.value = savedLang;
61
- }
62
-
63
- // Setup language button handlers (sidebar footer)
64
- document.querySelectorAll('.lang-btn').forEach(btn => {
65
- btn.addEventListener('click', function() {
66
- const lang = this.dataset.lang;
67
- setLanguage(lang);
68
- localStorage.setItem('doc-language', lang);
69
-
70
- // Update active state
71
- document.querySelectorAll('.lang-btn').forEach(b => b.classList.remove('active'));
72
- this.classList.add('active');
73
- });
74
- });
75
- }
76
-
77
- function setLanguage(lang) {
78
- // Update body class
79
- document.body.classList.remove('lang-fr', 'lang-en');
80
- document.body.classList.add('lang-' + lang);
81
-
82
- // Update dropdown value (if exists)
83
- const langSelect = document.getElementById('lang-select');
84
- if (langSelect) {
85
- langSelect.value = lang;
86
- }
87
-
88
- // Update HTML lang attribute
89
- document.documentElement.lang = lang;
90
-
91
- // Update search placeholder
92
- const searchInput = document.getElementById('search-input');
93
- if (searchInput) {
94
- const placeholder = lang === 'en' ? searchInput.dataset.placeholderEn : searchInput.dataset.placeholderFr;
95
- if (placeholder) {
96
- searchInput.placeholder = placeholder;
97
- }
98
- }
99
- }
100
-
101
- /* ============================================
102
- COPY BUTTONS
103
- ============================================ */
104
-
105
- function initCopyButtons() {
106
- document.querySelectorAll('.copy-btn').forEach(btn => {
107
- btn.addEventListener('click', async function() {
108
- const code = this.closest('.code-block').querySelector('code').textContent;
109
-
110
- try {
111
- await navigator.clipboard.writeText(code);
112
- const originalText = this.textContent;
113
- this.textContent = 'Copied!';
114
- this.style.background = 'var(--success)';
115
-
116
- setTimeout(() => {
117
- this.textContent = originalText;
118
- this.style.background = '';
119
- }, 2000);
120
- } catch (err) {
121
- console.error('Failed to copy:', err);
122
- }
123
- });
124
- });
125
- }
126
-
127
- /* ============================================
128
- MOBILE MENU
129
- ============================================ */
130
-
131
- function initMobileMenu() {
132
- const menuBtn = document.querySelector('.mobile-menu-btn');
133
- const sidebar = document.querySelector('.sidebar');
134
- const overlay = document.querySelector('.overlay');
135
-
136
- if (!menuBtn || !sidebar) return;
137
-
138
- menuBtn.addEventListener('click', function() {
139
- sidebar.classList.toggle('open');
140
- overlay?.classList.toggle('active');
141
- });
142
-
143
- overlay?.addEventListener('click', function() {
144
- sidebar.classList.remove('open');
145
- overlay.classList.remove('active');
146
- });
147
-
148
- // Close on nav item click (mobile)
149
- document.querySelectorAll('.nav-item').forEach(item => {
150
- item.addEventListener('click', function() {
151
- if (window.innerWidth <= 1024) {
152
- sidebar.classList.remove('open');
153
- overlay?.classList.remove('active');
154
- }
155
- });
156
- });
157
- }
158
-
159
- /* ============================================
160
- SIDEBAR TABLE OF CONTENTS
161
- ============================================ */
162
-
163
- function initSidebarToc() {
164
- const sidebarToc = document.querySelector('.sidebar-toc');
165
- const tocToggle = document.querySelector('.toc-toggle');
166
-
167
- if (!sidebarToc) return;
168
-
169
- // Auto-open TOC on current page
170
- sidebarToc.classList.add('open');
171
- if (tocToggle) tocToggle.classList.add('open');
172
-
173
- // Toggle handler
174
- if (tocToggle) {
175
- tocToggle.addEventListener('click', function(e) {
176
- e.preventDefault();
177
- e.stopPropagation();
178
- sidebarToc.classList.toggle('open');
179
- tocToggle.classList.toggle('open');
180
- });
181
- }
182
-
183
- // Smooth scroll for sidebar TOC links
184
- document.querySelectorAll('.sidebar-toc-link').forEach(link => {
185
- link.addEventListener('click', function(e) {
186
- e.preventDefault();
187
- const targetId = this.getAttribute('href');
188
- const target = document.querySelector(targetId);
189
- if (target) {
190
- target.scrollIntoView({ behavior: 'smooth', block: 'start' });
191
- // Update active state immediately
192
- document.querySelectorAll('.sidebar-toc-link').forEach(l => l.classList.remove('active'));
193
- this.classList.add('active');
194
- }
195
- });
196
- });
197
- }
198
-
199
- /* ============================================
200
- SCROLL SPY
201
- ============================================ */
202
-
203
- function initScrollSpy() {
204
- const headings = document.querySelectorAll('h2[id], h3[id]');
205
- const sidebarTocLinks = document.querySelectorAll('.sidebar-toc-link');
206
-
207
- if (!headings.length || !sidebarTocLinks.length) return;
208
-
209
- const observer = new IntersectionObserver(entries => {
210
- entries.forEach(entry => {
211
- if (entry.isIntersecting) {
212
- const id = entry.target.id;
213
- sidebarTocLinks.forEach(link => {
214
- link.classList.toggle('active', link.getAttribute('href') === '#' + id);
215
- });
216
- }
217
- });
218
- }, { rootMargin: '-20% 0px -80% 0px' });
219
-
220
- headings.forEach(heading => observer.observe(heading));
221
- }
222
-
223
- /* ============================================
224
- UTILITIES
225
- ============================================ */
226
-
227
- // Smooth scroll for anchor links
228
- document.querySelectorAll('a[href^="#"]').forEach(anchor => {
229
- anchor.addEventListener('click', function(e) {
230
- e.preventDefault();
231
- const target = document.querySelector(this.getAttribute('href'));
232
- if (target) {
233
- target.scrollIntoView({ behavior: 'smooth', block: 'start' });
234
- }
235
- });
236
- });
237
-
238
- // Add animation class on scroll
239
- const observerOptions = {
240
- threshold: 0.1,
241
- rootMargin: '0px 0px -50px 0px'
242
- };
243
-
244
- const fadeObserver = new IntersectionObserver((entries) => {
245
- entries.forEach(entry => {
246
- if (entry.isIntersecting) {
247
- entry.target.classList.add('fade-in');
248
- fadeObserver.unobserve(entry.target);
249
- }
250
- });
251
- }, observerOptions);
252
-
253
- document.querySelectorAll('.card, .alert, .best-practice').forEach(el => {
254
- fadeObserver.observe(el);
255
- });
256
-
257
- /* ============================================
258
- INTERACTIVE DIAGRAM
259
- ============================================ */
260
-
261
- function initInteractiveDiagram() {
262
- const diagram = document.getElementById('gitflow-diagram');
263
- const tooltip = document.getElementById('diagram-tooltip');
264
-
265
- if (!diagram || !tooltip) return;
266
-
267
- const clickableElements = diagram.querySelectorAll('.clickable-element');
268
- let activeElement = null;
269
-
270
- // Get current language
271
- function getLang() {
272
- return document.body.classList.contains('lang-en') ? 'en' : 'fr';
273
- }
274
-
275
- // Show tooltip for an element
276
- function showTooltip(element, event) {
277
- const lang = getLang();
278
- const title = element.dataset['title' + lang.charAt(0).toUpperCase() + lang.slice(1)] || element.dataset.titleFr;
279
- const desc = element.dataset['desc' + lang.charAt(0).toUpperCase() + lang.slice(1)] || element.dataset.descFr;
280
- const cmd = element.dataset.cmd || '';
281
-
282
- // Set tooltip content
283
- tooltip.querySelector('.tooltip-title').textContent = title;
284
- tooltip.querySelector('.tooltip-desc').textContent = desc;
285
-
286
- const cmdElement = tooltip.querySelector('.tooltip-cmd');
287
- if (cmd) {
288
- cmdElement.textContent = cmd;
289
- cmdElement.style.display = 'inline-block';
290
- } else {
291
- cmdElement.style.display = 'none';
292
- }
293
-
294
- // Position tooltip
295
- const diagramRect = diagram.getBoundingClientRect();
296
- const svgRect = diagram.querySelector('svg').getBoundingClientRect();
297
-
298
- // Calculate position relative to the diagram
299
- let left = event.clientX - diagramRect.left + 15;
300
- let top = event.clientY - diagramRect.top + 15;
301
-
302
- // Make tooltip visible to measure it
303
- tooltip.style.left = left + 'px';
304
- tooltip.style.top = top + 'px';
305
- tooltip.classList.add('visible');
306
-
307
- // Adjust if overflowing right edge
308
- const tooltipRect = tooltip.getBoundingClientRect();
309
- if (tooltipRect.right > diagramRect.right - 10) {
310
- left = event.clientX - diagramRect.left - tooltipRect.width - 15;
311
- tooltip.style.left = left + 'px';
312
- }
313
-
314
- // Adjust if overflowing bottom edge
315
- if (tooltipRect.bottom > window.innerHeight - 10) {
316
- top = event.clientY - diagramRect.top - tooltipRect.height - 15;
317
- tooltip.style.top = top + 'px';
318
- }
319
-
320
- // Mark element as active
321
- if (activeElement) {
322
- activeElement.classList.remove('active');
323
- }
324
- element.classList.add('active');
325
- activeElement = element;
326
- }
327
-
328
- // Hide tooltip
329
- function hideTooltip() {
330
- tooltip.classList.remove('visible');
331
- if (activeElement) {
332
- activeElement.classList.remove('active');
333
- activeElement = null;
334
- }
335
- }
336
-
337
- // Add click handlers to clickable elements
338
- clickableElements.forEach(element => {
339
- element.addEventListener('click', function(e) {
340
- e.stopPropagation();
341
-
342
- // If clicking the same element, toggle off
343
- if (activeElement === this) {
344
- hideTooltip();
345
- } else {
346
- showTooltip(this, e);
347
- }
348
- });
349
- });
350
-
351
- // Close tooltip when clicking outside
352
- document.addEventListener('click', function(e) {
353
- if (!diagram.contains(e.target) || (!e.target.closest('.clickable-element') && !e.target.closest('.diagram-tooltip'))) {
354
- hideTooltip();
355
- }
356
- });
357
-
358
- // Close on escape key
359
- document.addEventListener('keydown', function(e) {
360
- if (e.key === 'Escape') {
361
- hideTooltip();
362
- }
363
- });
364
-
365
- // Update tooltip language when language changes
366
- const langSelect = document.getElementById('lang-select');
367
- if (langSelect) {
368
- langSelect.addEventListener('change', function() {
369
- if (activeElement && tooltip.classList.contains('visible')) {
370
- // Re-show tooltip with new language
371
- const event = { clientX: parseFloat(tooltip.style.left) + diagram.getBoundingClientRect().left,
372
- clientY: parseFloat(tooltip.style.top) + diagram.getBoundingClientRect().top };
373
- setTimeout(() => showTooltip(activeElement, event), 50);
374
- }
375
- });
376
- }
377
- }
378
-
379
- /* ============================================
380
- SEARCH (Full-Text with Static Fallback)
381
- ============================================ */
382
-
383
- function initSearch() {
384
- const searchInput = document.getElementById('search-input');
385
- const searchResults = document.getElementById('search-results');
386
-
387
- if (!searchInput || !searchResults) return;
388
-
389
- // Static search index (works without server, file:// protocol)
390
- const staticIndex = [
391
- // Index - Accueil
392
- { page: 'index.html', icon: '🏠', title: { fr: 'Accueil', en: 'Home' }, section: '', anchor: '',
393
- keywords: 'accueil home documentation claude tools atlashub cli automatisation gitflow ef core migration hooks agents commandes installation npm' },
394
-
395
- // Installation
396
- { page: 'installation.html', icon: '📦', title: { fr: 'Installation', en: 'Installation' }, section: '', anchor: '',
397
- keywords: 'installation install npm registry nodejs node prérequis requirements setup configuration package global' },
398
- { page: 'installation.html', icon: '📦', title: { fr: 'Installation', en: 'Installation' }, section: { fr: 'Prérequis', en: 'Prerequisites' }, anchor: 'prerequisites',
399
- keywords: 'prérequis prerequisites nodejs node version 18 npm git' },
400
- { page: 'installation.html', icon: '📦', title: { fr: 'Installation', en: 'Installation' }, section: { fr: 'Installation globale', en: 'Global Installation' }, anchor: 'global-install',
401
- keywords: 'npm install global atlashub smartstack smartstack-cli registry package' },
402
-
403
- // GitFlow
404
- { page: 'gitflow.html', icon: '🔀', title: { fr: 'GitFlow', en: 'GitFlow' }, section: '', anchor: '',
405
- keywords: 'gitflow git workflow branch branche feature release hotfix develop main master merge fusion version semver' },
406
- { page: 'gitflow.html', icon: '🔀', title: { fr: 'GitFlow', en: 'GitFlow' }, section: { fr: 'Branches principales', en: 'Main Branches' }, anchor: 'main-branches',
407
- keywords: 'main master develop development production branches principales' },
408
- { page: 'gitflow.html', icon: '🔀', title: { fr: 'GitFlow', en: 'GitFlow' }, section: { fr: 'Feature branches', en: 'Feature branches' }, anchor: 'feature',
409
- keywords: 'feature branch nouvelle fonctionnalité develop merge création git checkout' },
410
- { page: 'gitflow.html', icon: '🔀', title: { fr: 'GitFlow', en: 'GitFlow' }, section: { fr: 'Release branches', en: 'Release branches' }, anchor: 'release',
411
- keywords: 'release branch version livraison production tag semver minor major patch' },
412
- { page: 'gitflow.html', icon: '🔀', title: { fr: 'GitFlow', en: 'GitFlow' }, section: { fr: 'Hotfix branches', en: 'Hotfix branches' }, anchor: 'hotfix',
413
- keywords: 'hotfix branch correction bug urgent production patch fix' },
414
- { page: 'gitflow.html', icon: '🔀', title: { fr: 'GitFlow', en: 'GitFlow' }, section: { fr: 'Commandes', en: 'Commands' }, anchor: 'commands',
415
- keywords: 'commandes commands gitflow init start finish status plan exec commit abort' },
416
- { page: 'gitflow.html', icon: '🔀', title: { fr: 'GitFlow', en: 'GitFlow' }, section: { fr: 'Versioning SemVer', en: 'SemVer Versioning' }, anchor: 'semver',
417
- keywords: 'semver semantic versioning version major minor patch auto increment package.json' },
418
-
419
- // EF Core
420
- { page: 'efcore.html', icon: '📄', title: { fr: 'EF Core', en: 'EF Core' }, section: '', anchor: '',
421
- keywords: 'ef core entity framework migration database dotnet .net sql model orm microsoft' },
422
- { page: 'efcore.html', icon: '📄', title: { fr: 'EF Core', en: 'EF Core' }, section: { fr: 'Structure des migrations', en: 'Migration Structure' }, anchor: 'structure',
423
- keywords: 'migration structure fichier file timestamp designer snapshot model context dbcontext' },
424
- { page: 'efcore.html', icon: '📄', title: { fr: 'EF Core', en: 'EF Core' }, section: { fr: 'Conflits', en: 'Conflicts' }, anchor: 'conflicts',
425
- keywords: 'conflit conflict merge migration snapshot résolution resolution gitflow' },
426
- { page: 'efcore.html', icon: '📄', title: { fr: 'EF Core', en: 'EF Core' }, section: { fr: 'Bonnes pratiques', en: 'Best Practices' }, anchor: 'best-practices',
427
- keywords: 'bonnes pratiques best practices migration naming convention idempotent script sql' },
428
- { page: 'efcore.html', icon: '📄', title: { fr: 'EF Core', en: 'EF Core' }, section: { fr: 'Commandes', en: 'Commands' }, anchor: 'commands',
429
- keywords: 'commandes commands dotnet ef migrations add remove update database script' },
430
-
431
- // Business Analyse
432
- { page: 'business-analyse.html', icon: '📊', title: { fr: 'Business Analyse', en: 'Business Analyse' }, section: '', anchor: '',
433
- keywords: 'business analyse analysis specification requirements exigences babok' },
434
- { page: 'business-analyse.html', icon: '📊', title: { fr: 'Business Analyse', en: 'Business Analyse' }, section: { fr: 'Discovery', en: 'Discovery' }, anchor: 'phase-2',
435
- keywords: 'discover discovery questionnaire questions adaptatives ultrathink elicitation' },
436
- { page: 'business-analyse.html', icon: '📊', title: { fr: 'Business Analyse', en: 'Business Analyse' }, section: { fr: 'Specification', en: 'Specification' }, anchor: 'phase-4',
437
- keywords: 'specify specification use cases wireframes gherkin acceptance criteria' },
438
- { page: 'business-analyse.html', icon: '📊', title: { fr: 'Business Analyse', en: 'Business Analyse' }, section: { fr: 'Handoff', en: 'Handoff' }, anchor: 'phase-6',
439
- keywords: 'handoff dev prompt developer implementation autonome autonomous' },
440
-
441
- // Agents
442
- { page: 'agents.html', icon: '🤖', title: { fr: 'Agents', en: 'Agents' }, section: '', anchor: '',
443
- keywords: 'agents subagent task tool automation automatisation ai ia claude specialized spécialisé' },
444
- { page: 'agents.html', icon: '🤖', title: { fr: 'Agents', en: 'Agents' }, section: { fr: 'GitFlow Agents', en: 'GitFlow Agents' }, anchor: 'gitflow-agents',
445
- keywords: 'gitflow agents plan exec commit status abort rollback recovery' },
446
- { page: 'agents.html', icon: '🤖', title: { fr: 'Agents', en: 'Agents' }, section: { fr: 'Explore Agent', en: 'Explore Agent' }, anchor: 'explore',
447
- keywords: 'explore agent codebase search recherche exploration quick thorough' },
448
-
449
- // Commands
450
- { page: 'commands.html', icon: '⚡', title: { fr: 'Commandes', en: 'Commands' }, section: '', anchor: '',
451
- keywords: 'commandes commands slash cli terminal prompt gitflow commit review deploy' },
452
- { page: 'commands.html', icon: '⚡', title: { fr: 'Commandes', en: 'Commands' }, section: { fr: 'GitFlow Commands', en: 'GitFlow Commands' }, anchor: 'gitflow-commands',
453
- keywords: 'gitflow commands init start finish status commit plan exec' },
454
- { page: 'commands.html', icon: '⚡', title: { fr: 'Commandes', en: 'Commands' }, section: { fr: 'Commit', en: 'Commit' }, anchor: 'commit',
455
- keywords: 'commit git message conventional commits push' },
456
- { page: 'commands.html', icon: '⚡', title: { fr: 'Commandes', en: 'Commands' }, section: { fr: 'Deploy', en: 'Deploy' }, anchor: 'deploy',
457
- keywords: 'deploy deployment déploiement build test lint push production' },
458
-
459
- // Hooks
460
- { page: 'hooks.html', icon: '🔗', title: { fr: 'Hooks', en: 'Hooks' }, section: '', anchor: '',
461
- keywords: 'hooks pre-commit post-commit validation automation automatisation script event événement' },
462
- { page: 'hooks.html', icon: '🔗', title: { fr: 'Hooks', en: 'Hooks' }, section: { fr: 'Types de hooks', en: 'Hook Types' }, anchor: 'types',
463
- keywords: 'types hooks PreToolUse PostToolUse Stop SessionStart UserPromptSubmit' },
464
- { page: 'hooks.html', icon: '🔗', title: { fr: 'Hooks', en: 'Hooks' }, section: { fr: 'Configuration', en: 'Configuration' }, anchor: 'configuration',
465
- keywords: 'configuration hooks settings.json matcher command timeout' }
466
- ];
467
-
468
- let searchIndex = null;
469
- let activeIndex = -1;
470
-
471
- function getLang() {
472
- return document.body.classList.contains('lang-en') ? 'en' : 'fr';
473
- }
474
-
475
- // Build search index from static data
476
- function buildIndex() {
477
- const lang = getLang();
478
-
479
- return staticIndex.map(item => {
480
- const pageTitle = typeof item.title === 'object' ? item.title[lang] : item.title;
481
- const sectionTitle = typeof item.section === 'object' ? item.section[lang] : item.section;
482
-
483
- return {
484
- page: item.page,
485
- pageTitle: pageTitle,
486
- icon: item.icon,
487
- sectionTitle: sectionTitle || '',
488
- content: (pageTitle + ' ' + sectionTitle + ' ' + item.keywords).toLowerCase(),
489
- contentRaw: item.keywords,
490
- anchor: item.anchor,
491
- url: item.anchor ? `${item.page}#${item.anchor}` : item.page
492
- };
493
- });
494
- }
495
-
496
- // Search through index
497
- function search(query) {
498
- if (!query || query.length < 2) return [];
499
-
500
- // Build index if not ready
501
- if (!searchIndex) {
502
- searchIndex = buildIndex();
503
- }
504
-
505
- const normalizedQuery = query.toLowerCase().trim();
506
- const words = normalizedQuery.split(/\s+/).filter(w => w.length >= 2);
507
- const results = [];
508
- const seenPages = new Set();
509
-
510
- searchIndex.forEach(item => {
511
- // Check if any word matches
512
- const anyWordMatch = words.some(word => item.content.includes(word));
513
- if (!anyWordMatch) return;
514
-
515
- // Calculate relevance score
516
- let score = 0;
517
- words.forEach(word => {
518
- if (item.content.includes(word)) {
519
- // Title match is worth more
520
- if (item.pageTitle.toLowerCase().includes(word)) score += 10;
521
- if (item.sectionTitle.toLowerCase().includes(word)) score += 5;
522
- // Count occurrences in content
523
- const matches = (item.content.match(new RegExp(word, 'g')) || []).length;
524
- score += matches;
525
- }
526
- });
527
-
528
- // Generate excerpt from keywords
529
- let excerpt = item.contentRaw;
530
- if (excerpt.length > 80) {
531
- // Find first matching word position
532
- const firstWord = words.find(w => item.contentRaw.toLowerCase().includes(w));
533
- if (firstWord) {
534
- const idx = item.contentRaw.toLowerCase().indexOf(firstWord);
535
- const start = Math.max(0, idx - 20);
536
- const end = Math.min(item.contentRaw.length, idx + 60);
537
- excerpt = (start > 0 ? '...' : '') + item.contentRaw.substring(start, end) + (end < item.contentRaw.length ? '...' : '');
538
- } else {
539
- excerpt = item.contentRaw.substring(0, 80) + '...';
540
- }
541
- }
542
-
543
- // Avoid duplicate pages for same section
544
- const key = item.page + '#' + item.anchor;
545
- if (!seenPages.has(key)) {
546
- seenPages.add(key);
547
- results.push({
548
- ...item,
549
- score,
550
- excerpt
551
- });
552
- }
553
- });
554
-
555
- // Sort by score and limit results
556
- return results
557
- .sort((a, b) => b.score - a.score)
558
- .slice(0, 10);
559
- }
560
-
561
- // Escape regex special chars
562
- function escapeRegex(str) {
563
- return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
564
- }
565
-
566
- // Highlight matches in text
567
- function highlightMatch(text, query) {
568
- const words = query.toLowerCase().split(/\s+/).filter(w => w.length >= 2);
569
- let result = text;
570
- words.forEach(word => {
571
- const regex = new RegExp(`(${escapeRegex(word)})`, 'gi');
572
- result = result.replace(regex, '<mark>$1</mark>');
573
- });
574
- return result;
575
- }
576
-
577
- function renderResults(results, query) {
578
- const lang = getLang();
579
-
580
- if (results.length === 0) {
581
- const emptyMsg = lang === 'fr' ? 'Aucun résultat trouvé' : 'No results found';
582
- searchResults.innerHTML = `<div class="search-results-empty">${emptyMsg}</div>`;
583
- } else {
584
- searchResults.innerHTML = results.map((item, index) => `
585
- <a href="${item.url}" class="search-result-item${index === activeIndex ? ' active' : ''}" data-index="${index}">
586
- <div class="search-result-icon">${item.icon}</div>
587
- <div class="search-result-content">
588
- <div class="search-result-title">${highlightMatch(item.pageTitle, query)}${item.sectionTitle ? ' <span class="search-result-section">› ' + highlightMatch(item.sectionTitle, query) + '</span>' : ''}</div>
589
- <div class="search-result-excerpt">${highlightMatch(item.excerpt, query)}</div>
590
- <div class="search-result-path">${item.url}</div>
591
- </div>
592
- </a>
593
- `).join('');
594
- }
595
-
596
- searchResults.classList.add('visible');
597
- }
598
-
599
- function hideResults() {
600
- searchResults.classList.remove('visible');
601
- activeIndex = -1;
602
- }
603
-
604
- // Input handler with debounce
605
- let debounceTimer;
606
- searchInput.addEventListener('input', function() {
607
- clearTimeout(debounceTimer);
608
- const query = this.value.trim();
609
-
610
- if (query.length >= 2) {
611
- debounceTimer = setTimeout(() => {
612
- const results = search(query);
613
- activeIndex = -1;
614
- renderResults(results, query);
615
- }, 150);
616
- } else {
617
- hideResults();
618
- }
619
- });
620
-
621
- // Keyboard navigation
622
- searchInput.addEventListener('keydown', function(e) {
623
- const items = searchResults.querySelectorAll('.search-result-item');
624
-
625
- if (e.key === 'ArrowDown') {
626
- e.preventDefault();
627
- activeIndex = Math.min(activeIndex + 1, items.length - 1);
628
- updateActiveItem(items);
629
- } else if (e.key === 'ArrowUp') {
630
- e.preventDefault();
631
- activeIndex = Math.max(activeIndex - 1, 0);
632
- updateActiveItem(items);
633
- } else if (e.key === 'Enter') {
634
- e.preventDefault();
635
- if (activeIndex >= 0 && items[activeIndex]) {
636
- window.location.href = items[activeIndex].getAttribute('href');
637
- }
638
- } else if (e.key === 'Escape') {
639
- hideResults();
640
- searchInput.blur();
641
- }
642
- });
643
-
644
- function updateActiveItem(items) {
645
- items.forEach((item, index) => {
646
- item.classList.toggle('active', index === activeIndex);
647
- });
648
-
649
- if (items[activeIndex]) {
650
- items[activeIndex].scrollIntoView({ block: 'nearest' });
651
- }
652
- }
653
-
654
- // Focus handler
655
- searchInput.addEventListener('focus', function() {
656
- if (this.value.length >= 2) {
657
- const results = search(this.value);
658
- renderResults(results, this.value);
659
- }
660
- });
661
-
662
- // Click outside to close
663
- document.addEventListener('click', function(e) {
664
- if (!e.target.closest('.header-search')) {
665
- hideResults();
666
- }
667
- });
668
-
669
- // Keyboard shortcut (Ctrl/Cmd + K)
670
- document.addEventListener('keydown', function(e) {
671
- if ((e.ctrlKey || e.metaKey) && e.key === 'k') {
672
- e.preventDefault();
673
- searchInput.focus();
674
- searchInput.select();
675
- }
676
- });
677
- }
678
-
679
- /* ============================================
680
- COPYABLE COMMANDS (SVG Diagram)
681
- ============================================ */
682
-
683
- function initCopyableCommands() {
684
- const copyableElements = document.querySelectorAll('.cmd-copyable');
685
-
686
- if (copyableElements.length === 0) return;
687
-
688
- // Get current language
689
- function getLang() {
690
- return document.body.classList.contains('lang-en') ? 'en' : 'fr';
691
- }
692
-
693
- // Create floating tooltip for feedback
694
- const tooltip = document.createElement('div');
695
- tooltip.className = 'copy-tooltip';
696
- tooltip.style.cssText = `
697
- position: fixed;
698
- background: #22c55e;
699
- color: white;
700
- padding: 0.5rem 1rem;
701
- border-radius: 6px;
702
- font-size: 0.85rem;
703
- font-weight: 500;
704
- z-index: 10000;
705
- pointer-events: none;
706
- opacity: 0;
707
- transition: opacity 0.2s ease;
708
- box-shadow: 0 4px 12px rgba(0,0,0,0.3);
709
- `;
710
- document.body.appendChild(tooltip);
711
-
712
- copyableElements.forEach(element => {
713
- // Add hover effect
714
- element.addEventListener('mouseenter', function() {
715
- const rect = this.querySelector('rect');
716
- if (rect) {
717
- rect.style.filter = 'brightness(1.2)';
718
- rect.style.transition = 'filter 0.2s ease';
719
- }
720
- });
721
-
722
- element.addEventListener('mouseleave', function() {
723
- const rect = this.querySelector('rect');
724
- if (rect) {
725
- rect.style.filter = '';
726
- }
727
- });
728
-
729
- // Add click handler
730
- element.addEventListener('click', function(e) {
731
- e.stopPropagation();
732
-
733
- const cmd = this.dataset.cmd;
734
- if (!cmd) return;
735
-
736
- // Copy to clipboard
737
- navigator.clipboard.writeText(cmd).then(() => {
738
- // Show tooltip
739
- const lang = getLang();
740
- tooltip.textContent = lang === 'fr' ? '✓ Copié !' : '✓ Copied!';
741
-
742
- // Position tooltip near cursor
743
- tooltip.style.left = e.clientX + 10 + 'px';
744
- tooltip.style.top = e.clientY - 30 + 'px';
745
- tooltip.style.opacity = '1';
746
-
747
- // Flash effect on element
748
- const rect = this.querySelector('rect');
749
- if (rect) {
750
- const originalStroke = rect.getAttribute('stroke');
751
- rect.setAttribute('stroke', '#22c55e');
752
- rect.style.filter = 'brightness(1.4)';
753
-
754
- setTimeout(() => {
755
- rect.setAttribute('stroke', originalStroke);
756
- rect.style.filter = '';
757
- }, 300);
758
- }
759
-
760
- // Hide tooltip after delay
761
- setTimeout(() => {
762
- tooltip.style.opacity = '0';
763
- }, 1500);
764
- }).catch(err => {
765
- console.error('Failed to copy:', err);
766
- const lang = getLang();
767
- tooltip.textContent = lang === 'fr' ? '✗ Erreur' : '✗ Error';
768
- tooltip.style.background = '#ef4444';
769
- tooltip.style.left = e.clientX + 10 + 'px';
770
- tooltip.style.top = e.clientY - 30 + 'px';
771
- tooltip.style.opacity = '1';
772
-
773
- setTimeout(() => {
774
- tooltip.style.opacity = '0';
775
- tooltip.style.background = '#22c55e';
776
- }, 1500);
777
- });
778
- });
779
- });
780
- }
1
+ /* ============================================
2
+ CLAUDE TOOLS DOCUMENTATION - APP
3
+ ============================================ */
4
+
5
+ document.addEventListener('DOMContentLoaded', function() {
6
+ initSidebar();
7
+ initLanguageSwitch();
8
+ initCopyButtons();
9
+ initMobileMenu();
10
+ initSidebarToc();
11
+ initScrollSpy();
12
+ initInteractiveDiagram();
13
+ initSearch();
14
+ initCopyableCommands();
15
+ });
16
+
17
+ /* ============================================
18
+ SIDEBAR
19
+ ============================================ */
20
+
21
+ function initSidebar() {
22
+ const sidebar = document.querySelector('.sidebar');
23
+ const toggle = document.querySelector('.sidebar-toggle');
24
+
25
+ if (!sidebar || !toggle) return;
26
+
27
+ // Load saved state
28
+ const isCollapsed = localStorage.getItem('sidebar-collapsed') === 'true';
29
+ if (isCollapsed) {
30
+ sidebar.classList.add('collapsed');
31
+ }
32
+
33
+ toggle.addEventListener('click', function() {
34
+ sidebar.classList.toggle('collapsed');
35
+ localStorage.setItem('sidebar-collapsed', sidebar.classList.contains('collapsed'));
36
+ });
37
+
38
+ // Set active nav item
39
+ const currentPage = window.location.pathname.split('/').pop() || 'index.html';
40
+ document.querySelectorAll('.nav-item').forEach(item => {
41
+ if (item.getAttribute('href') === currentPage) {
42
+ item.classList.add('active');
43
+ }
44
+ });
45
+ }
46
+
47
+ /* ============================================
48
+ LANGUAGE SWITCH
49
+ ============================================ */
50
+
51
+ function initLanguageSwitch() {
52
+ const langSelect = document.getElementById('lang-select');
53
+
54
+ // Load saved language
55
+ const savedLang = localStorage.getItem('doc-language') || 'fr';
56
+ setLanguage(savedLang);
57
+
58
+ // Set dropdown to saved value
59
+ if (langSelect) {
60
+ langSelect.value = savedLang;
61
+ }
62
+
63
+ // Setup language button handlers (sidebar footer)
64
+ document.querySelectorAll('.lang-btn').forEach(btn => {
65
+ btn.addEventListener('click', function() {
66
+ const lang = this.dataset.lang;
67
+ setLanguage(lang);
68
+ localStorage.setItem('doc-language', lang);
69
+
70
+ // Update active state
71
+ document.querySelectorAll('.lang-btn').forEach(b => b.classList.remove('active'));
72
+ this.classList.add('active');
73
+ });
74
+ });
75
+ }
76
+
77
+ function setLanguage(lang) {
78
+ // Update body class
79
+ document.body.classList.remove('lang-fr', 'lang-en');
80
+ document.body.classList.add('lang-' + lang);
81
+
82
+ // Update dropdown value (if exists)
83
+ const langSelect = document.getElementById('lang-select');
84
+ if (langSelect) {
85
+ langSelect.value = lang;
86
+ }
87
+
88
+ // Update HTML lang attribute
89
+ document.documentElement.lang = lang;
90
+
91
+ // Update search placeholder
92
+ const searchInput = document.getElementById('search-input');
93
+ if (searchInput) {
94
+ const placeholder = lang === 'en' ? searchInput.dataset.placeholderEn : searchInput.dataset.placeholderFr;
95
+ if (placeholder) {
96
+ searchInput.placeholder = placeholder;
97
+ }
98
+ }
99
+ }
100
+
101
+ /* ============================================
102
+ COPY BUTTONS
103
+ ============================================ */
104
+
105
+ function initCopyButtons() {
106
+ document.querySelectorAll('.copy-btn').forEach(btn => {
107
+ btn.addEventListener('click', async function() {
108
+ const code = this.closest('.code-block').querySelector('code').textContent;
109
+
110
+ try {
111
+ await navigator.clipboard.writeText(code);
112
+ const originalText = this.textContent;
113
+ this.textContent = 'Copied!';
114
+ this.style.background = 'var(--success)';
115
+
116
+ setTimeout(() => {
117
+ this.textContent = originalText;
118
+ this.style.background = '';
119
+ }, 2000);
120
+ } catch (err) {
121
+ console.error('Failed to copy:', err);
122
+ }
123
+ });
124
+ });
125
+ }
126
+
127
+ /* ============================================
128
+ MOBILE MENU
129
+ ============================================ */
130
+
131
+ function initMobileMenu() {
132
+ const menuBtn = document.querySelector('.mobile-menu-btn');
133
+ const sidebar = document.querySelector('.sidebar');
134
+ const overlay = document.querySelector('.overlay');
135
+
136
+ if (!menuBtn || !sidebar) return;
137
+
138
+ menuBtn.addEventListener('click', function() {
139
+ sidebar.classList.toggle('open');
140
+ overlay?.classList.toggle('active');
141
+ });
142
+
143
+ overlay?.addEventListener('click', function() {
144
+ sidebar.classList.remove('open');
145
+ overlay.classList.remove('active');
146
+ });
147
+
148
+ // Close on nav item click (mobile)
149
+ document.querySelectorAll('.nav-item').forEach(item => {
150
+ item.addEventListener('click', function() {
151
+ if (window.innerWidth <= 1024) {
152
+ sidebar.classList.remove('open');
153
+ overlay?.classList.remove('active');
154
+ }
155
+ });
156
+ });
157
+ }
158
+
159
+ /* ============================================
160
+ SIDEBAR TABLE OF CONTENTS
161
+ ============================================ */
162
+
163
+ function initSidebarToc() {
164
+ const sidebarToc = document.querySelector('.sidebar-toc');
165
+ const tocToggle = document.querySelector('.toc-toggle');
166
+
167
+ if (!sidebarToc) return;
168
+
169
+ // Auto-open TOC on current page
170
+ sidebarToc.classList.add('open');
171
+ if (tocToggle) tocToggle.classList.add('open');
172
+
173
+ // Toggle handler
174
+ if (tocToggle) {
175
+ tocToggle.addEventListener('click', function(e) {
176
+ e.preventDefault();
177
+ e.stopPropagation();
178
+ sidebarToc.classList.toggle('open');
179
+ tocToggle.classList.toggle('open');
180
+ });
181
+ }
182
+
183
+ // Smooth scroll for sidebar TOC links
184
+ document.querySelectorAll('.sidebar-toc-link').forEach(link => {
185
+ link.addEventListener('click', function(e) {
186
+ e.preventDefault();
187
+ const targetId = this.getAttribute('href');
188
+ const target = document.querySelector(targetId);
189
+ if (target) {
190
+ target.scrollIntoView({ behavior: 'smooth', block: 'start' });
191
+ // Update active state immediately
192
+ document.querySelectorAll('.sidebar-toc-link').forEach(l => l.classList.remove('active'));
193
+ this.classList.add('active');
194
+ }
195
+ });
196
+ });
197
+ }
198
+
199
+ /* ============================================
200
+ SCROLL SPY
201
+ ============================================ */
202
+
203
+ function initScrollSpy() {
204
+ const headings = document.querySelectorAll('h2[id], h3[id]');
205
+ const sidebarTocLinks = document.querySelectorAll('.sidebar-toc-link');
206
+
207
+ if (!headings.length || !sidebarTocLinks.length) return;
208
+
209
+ const observer = new IntersectionObserver(entries => {
210
+ entries.forEach(entry => {
211
+ if (entry.isIntersecting) {
212
+ const id = entry.target.id;
213
+ sidebarTocLinks.forEach(link => {
214
+ link.classList.toggle('active', link.getAttribute('href') === '#' + id);
215
+ });
216
+ }
217
+ });
218
+ }, { rootMargin: '-20% 0px -80% 0px' });
219
+
220
+ headings.forEach(heading => observer.observe(heading));
221
+ }
222
+
223
+ /* ============================================
224
+ UTILITIES
225
+ ============================================ */
226
+
227
+ // Smooth scroll for anchor links
228
+ document.querySelectorAll('a[href^="#"]').forEach(anchor => {
229
+ anchor.addEventListener('click', function(e) {
230
+ e.preventDefault();
231
+ const target = document.querySelector(this.getAttribute('href'));
232
+ if (target) {
233
+ target.scrollIntoView({ behavior: 'smooth', block: 'start' });
234
+ }
235
+ });
236
+ });
237
+
238
+ // Add animation class on scroll
239
+ const observerOptions = {
240
+ threshold: 0.1,
241
+ rootMargin: '0px 0px -50px 0px'
242
+ };
243
+
244
+ const fadeObserver = new IntersectionObserver((entries) => {
245
+ entries.forEach(entry => {
246
+ if (entry.isIntersecting) {
247
+ entry.target.classList.add('fade-in');
248
+ fadeObserver.unobserve(entry.target);
249
+ }
250
+ });
251
+ }, observerOptions);
252
+
253
+ document.querySelectorAll('.card, .alert, .best-practice').forEach(el => {
254
+ fadeObserver.observe(el);
255
+ });
256
+
257
+ /* ============================================
258
+ INTERACTIVE DIAGRAM
259
+ ============================================ */
260
+
261
+ function initInteractiveDiagram() {
262
+ const diagram = document.getElementById('gitflow-diagram');
263
+ const tooltip = document.getElementById('diagram-tooltip');
264
+
265
+ if (!diagram || !tooltip) return;
266
+
267
+ const clickableElements = diagram.querySelectorAll('.clickable-element');
268
+ let activeElement = null;
269
+
270
+ // Get current language
271
+ function getLang() {
272
+ return document.body.classList.contains('lang-en') ? 'en' : 'fr';
273
+ }
274
+
275
+ // Show tooltip for an element
276
+ function showTooltip(element, event) {
277
+ const lang = getLang();
278
+ const title = element.dataset['title' + lang.charAt(0).toUpperCase() + lang.slice(1)] || element.dataset.titleFr;
279
+ const desc = element.dataset['desc' + lang.charAt(0).toUpperCase() + lang.slice(1)] || element.dataset.descFr;
280
+ const cmd = element.dataset.cmd || '';
281
+
282
+ // Set tooltip content
283
+ tooltip.querySelector('.tooltip-title').textContent = title;
284
+ tooltip.querySelector('.tooltip-desc').textContent = desc;
285
+
286
+ const cmdElement = tooltip.querySelector('.tooltip-cmd');
287
+ if (cmd) {
288
+ cmdElement.textContent = cmd;
289
+ cmdElement.style.display = 'inline-block';
290
+ } else {
291
+ cmdElement.style.display = 'none';
292
+ }
293
+
294
+ // Position tooltip
295
+ const diagramRect = diagram.getBoundingClientRect();
296
+ const svgRect = diagram.querySelector('svg').getBoundingClientRect();
297
+
298
+ // Calculate position relative to the diagram
299
+ let left = event.clientX - diagramRect.left + 15;
300
+ let top = event.clientY - diagramRect.top + 15;
301
+
302
+ // Make tooltip visible to measure it
303
+ tooltip.style.left = left + 'px';
304
+ tooltip.style.top = top + 'px';
305
+ tooltip.classList.add('visible');
306
+
307
+ // Adjust if overflowing right edge
308
+ const tooltipRect = tooltip.getBoundingClientRect();
309
+ if (tooltipRect.right > diagramRect.right - 10) {
310
+ left = event.clientX - diagramRect.left - tooltipRect.width - 15;
311
+ tooltip.style.left = left + 'px';
312
+ }
313
+
314
+ // Adjust if overflowing bottom edge
315
+ if (tooltipRect.bottom > window.innerHeight - 10) {
316
+ top = event.clientY - diagramRect.top - tooltipRect.height - 15;
317
+ tooltip.style.top = top + 'px';
318
+ }
319
+
320
+ // Mark element as active
321
+ if (activeElement) {
322
+ activeElement.classList.remove('active');
323
+ }
324
+ element.classList.add('active');
325
+ activeElement = element;
326
+ }
327
+
328
+ // Hide tooltip
329
+ function hideTooltip() {
330
+ tooltip.classList.remove('visible');
331
+ if (activeElement) {
332
+ activeElement.classList.remove('active');
333
+ activeElement = null;
334
+ }
335
+ }
336
+
337
+ // Add click handlers to clickable elements
338
+ clickableElements.forEach(element => {
339
+ element.addEventListener('click', function(e) {
340
+ e.stopPropagation();
341
+
342
+ // If clicking the same element, toggle off
343
+ if (activeElement === this) {
344
+ hideTooltip();
345
+ } else {
346
+ showTooltip(this, e);
347
+ }
348
+ });
349
+ });
350
+
351
+ // Close tooltip when clicking outside
352
+ document.addEventListener('click', function(e) {
353
+ if (!diagram.contains(e.target) || (!e.target.closest('.clickable-element') && !e.target.closest('.diagram-tooltip'))) {
354
+ hideTooltip();
355
+ }
356
+ });
357
+
358
+ // Close on escape key
359
+ document.addEventListener('keydown', function(e) {
360
+ if (e.key === 'Escape') {
361
+ hideTooltip();
362
+ }
363
+ });
364
+
365
+ // Update tooltip language when language changes
366
+ const langSelect = document.getElementById('lang-select');
367
+ if (langSelect) {
368
+ langSelect.addEventListener('change', function() {
369
+ if (activeElement && tooltip.classList.contains('visible')) {
370
+ // Re-show tooltip with new language
371
+ const event = { clientX: parseFloat(tooltip.style.left) + diagram.getBoundingClientRect().left,
372
+ clientY: parseFloat(tooltip.style.top) + diagram.getBoundingClientRect().top };
373
+ setTimeout(() => showTooltip(activeElement, event), 50);
374
+ }
375
+ });
376
+ }
377
+ }
378
+
379
+ /* ============================================
380
+ SEARCH (Full-Text with Static Fallback)
381
+ ============================================ */
382
+
383
+ function initSearch() {
384
+ const searchInput = document.getElementById('search-input');
385
+ const searchResults = document.getElementById('search-results');
386
+
387
+ if (!searchInput || !searchResults) return;
388
+
389
+ // Static search index (works without server, file:// protocol)
390
+ const staticIndex = [
391
+ // Index - Accueil
392
+ { page: 'index.html', icon: '🏠', title: { fr: 'Accueil', en: 'Home' }, section: '', anchor: '',
393
+ keywords: 'accueil home documentation claude tools atlashub cli automatisation gitflow ef core migration hooks agents commandes installation npm' },
394
+
395
+ // Installation
396
+ { page: 'installation.html', icon: '📦', title: { fr: 'Installation', en: 'Installation' }, section: '', anchor: '',
397
+ keywords: 'installation install npm registry nodejs node prérequis requirements setup configuration package global' },
398
+ { page: 'installation.html', icon: '📦', title: { fr: 'Installation', en: 'Installation' }, section: { fr: 'Prérequis', en: 'Prerequisites' }, anchor: 'prerequisites',
399
+ keywords: 'prérequis prerequisites nodejs node version 18 npm git' },
400
+ { page: 'installation.html', icon: '📦', title: { fr: 'Installation', en: 'Installation' }, section: { fr: 'Installation globale', en: 'Global Installation' }, anchor: 'global-install',
401
+ keywords: 'npm install global atlashub smartstack smartstack-cli registry package' },
402
+
403
+ // GitFlow
404
+ { page: 'gitflow.html', icon: '🔀', title: { fr: 'GitFlow', en: 'GitFlow' }, section: '', anchor: '',
405
+ keywords: 'gitflow git workflow branch branche feature release hotfix develop main master merge fusion version semver' },
406
+ { page: 'gitflow.html', icon: '🔀', title: { fr: 'GitFlow', en: 'GitFlow' }, section: { fr: 'Branches principales', en: 'Main Branches' }, anchor: 'main-branches',
407
+ keywords: 'main master develop development production branches principales' },
408
+ { page: 'gitflow.html', icon: '🔀', title: { fr: 'GitFlow', en: 'GitFlow' }, section: { fr: 'Feature branches', en: 'Feature branches' }, anchor: 'feature',
409
+ keywords: 'feature branch nouvelle fonctionnalité develop merge création git checkout' },
410
+ { page: 'gitflow.html', icon: '🔀', title: { fr: 'GitFlow', en: 'GitFlow' }, section: { fr: 'Release branches', en: 'Release branches' }, anchor: 'release',
411
+ keywords: 'release branch version livraison production tag semver minor major patch' },
412
+ { page: 'gitflow.html', icon: '🔀', title: { fr: 'GitFlow', en: 'GitFlow' }, section: { fr: 'Hotfix branches', en: 'Hotfix branches' }, anchor: 'hotfix',
413
+ keywords: 'hotfix branch correction bug urgent production patch fix' },
414
+ { page: 'gitflow.html', icon: '🔀', title: { fr: 'GitFlow', en: 'GitFlow' }, section: { fr: 'Commandes', en: 'Commands' }, anchor: 'commands',
415
+ keywords: 'commandes commands gitflow init start finish status plan exec commit abort' },
416
+ { page: 'gitflow.html', icon: '🔀', title: { fr: 'GitFlow', en: 'GitFlow' }, section: { fr: 'Versioning SemVer', en: 'SemVer Versioning' }, anchor: 'semver',
417
+ keywords: 'semver semantic versioning version major minor patch auto increment package.json' },
418
+
419
+ // EF Core
420
+ { page: 'efcore.html', icon: '📄', title: { fr: 'EF Core', en: 'EF Core' }, section: '', anchor: '',
421
+ keywords: 'ef core entity framework migration database dotnet .net sql model orm microsoft' },
422
+ { page: 'efcore.html', icon: '📄', title: { fr: 'EF Core', en: 'EF Core' }, section: { fr: 'Structure des migrations', en: 'Migration Structure' }, anchor: 'structure',
423
+ keywords: 'migration structure fichier file timestamp designer snapshot model context dbcontext' },
424
+ { page: 'efcore.html', icon: '📄', title: { fr: 'EF Core', en: 'EF Core' }, section: { fr: 'Conflits', en: 'Conflicts' }, anchor: 'conflicts',
425
+ keywords: 'conflit conflict merge migration snapshot résolution resolution gitflow' },
426
+ { page: 'efcore.html', icon: '📄', title: { fr: 'EF Core', en: 'EF Core' }, section: { fr: 'Bonnes pratiques', en: 'Best Practices' }, anchor: 'best-practices',
427
+ keywords: 'bonnes pratiques best practices migration naming convention idempotent script sql' },
428
+ { page: 'efcore.html', icon: '📄', title: { fr: 'EF Core', en: 'EF Core' }, section: { fr: 'Commandes', en: 'Commands' }, anchor: 'commands',
429
+ keywords: 'commandes commands dotnet ef migrations add remove update database script' },
430
+
431
+ // Business Analyse
432
+ { page: 'business-analyse.html', icon: '📊', title: { fr: 'Business Analyse', en: 'Business Analyse' }, section: '', anchor: '',
433
+ keywords: 'business analyse analysis specification requirements exigences babok' },
434
+ { page: 'business-analyse.html', icon: '📊', title: { fr: 'Business Analyse', en: 'Business Analyse' }, section: { fr: 'Discovery', en: 'Discovery' }, anchor: 'phase-2',
435
+ keywords: 'discover discovery questionnaire questions adaptatives ultrathink elicitation' },
436
+ { page: 'business-analyse.html', icon: '📊', title: { fr: 'Business Analyse', en: 'Business Analyse' }, section: { fr: 'Specification', en: 'Specification' }, anchor: 'phase-4',
437
+ keywords: 'specify specification use cases wireframes gherkin acceptance criteria' },
438
+ { page: 'business-analyse.html', icon: '📊', title: { fr: 'Business Analyse', en: 'Business Analyse' }, section: { fr: 'Handoff', en: 'Handoff' }, anchor: 'phase-6',
439
+ keywords: 'handoff dev prompt developer implementation autonome autonomous' },
440
+
441
+ // Agents
442
+ { page: 'agents.html', icon: '🤖', title: { fr: 'Agents', en: 'Agents' }, section: '', anchor: '',
443
+ keywords: 'agents subagent task tool automation automatisation ai ia claude specialized spécialisé' },
444
+ { page: 'agents.html', icon: '🤖', title: { fr: 'Agents', en: 'Agents' }, section: { fr: 'GitFlow Agents', en: 'GitFlow Agents' }, anchor: 'gitflow-agents',
445
+ keywords: 'gitflow agents plan exec commit status abort rollback recovery' },
446
+ { page: 'agents.html', icon: '🤖', title: { fr: 'Agents', en: 'Agents' }, section: { fr: 'Explore Agent', en: 'Explore Agent' }, anchor: 'explore',
447
+ keywords: 'explore agent codebase search recherche exploration quick thorough' },
448
+
449
+ // Commands
450
+ { page: 'commands.html', icon: '⚡', title: { fr: 'Commandes', en: 'Commands' }, section: '', anchor: '',
451
+ keywords: 'commandes commands slash cli terminal prompt gitflow commit review deploy' },
452
+ { page: 'commands.html', icon: '⚡', title: { fr: 'Commandes', en: 'Commands' }, section: { fr: 'GitFlow Commands', en: 'GitFlow Commands' }, anchor: 'gitflow-commands',
453
+ keywords: 'gitflow commands init start finish status commit plan exec' },
454
+ { page: 'commands.html', icon: '⚡', title: { fr: 'Commandes', en: 'Commands' }, section: { fr: 'Commit', en: 'Commit' }, anchor: 'commit',
455
+ keywords: 'commit git message conventional commits push' },
456
+ { page: 'commands.html', icon: '⚡', title: { fr: 'Commandes', en: 'Commands' }, section: { fr: 'Deploy', en: 'Deploy' }, anchor: 'deploy',
457
+ keywords: 'deploy deployment déploiement build test lint push production' },
458
+
459
+ // Hooks
460
+ { page: 'hooks.html', icon: '🔗', title: { fr: 'Hooks', en: 'Hooks' }, section: '', anchor: '',
461
+ keywords: 'hooks pre-commit post-commit validation automation automatisation script event événement' },
462
+ { page: 'hooks.html', icon: '🔗', title: { fr: 'Hooks', en: 'Hooks' }, section: { fr: 'Types de hooks', en: 'Hook Types' }, anchor: 'types',
463
+ keywords: 'types hooks PreToolUse PostToolUse Stop SessionStart UserPromptSubmit' },
464
+ { page: 'hooks.html', icon: '🔗', title: { fr: 'Hooks', en: 'Hooks' }, section: { fr: 'Configuration', en: 'Configuration' }, anchor: 'configuration',
465
+ keywords: 'configuration hooks settings.json matcher command timeout' }
466
+ ];
467
+
468
+ let searchIndex = null;
469
+ let activeIndex = -1;
470
+
471
+ function getLang() {
472
+ return document.body.classList.contains('lang-en') ? 'en' : 'fr';
473
+ }
474
+
475
+ // Build search index from static data
476
+ function buildIndex() {
477
+ const lang = getLang();
478
+
479
+ return staticIndex.map(item => {
480
+ const pageTitle = typeof item.title === 'object' ? item.title[lang] : item.title;
481
+ const sectionTitle = typeof item.section === 'object' ? item.section[lang] : item.section;
482
+
483
+ return {
484
+ page: item.page,
485
+ pageTitle: pageTitle,
486
+ icon: item.icon,
487
+ sectionTitle: sectionTitle || '',
488
+ content: (pageTitle + ' ' + sectionTitle + ' ' + item.keywords).toLowerCase(),
489
+ contentRaw: item.keywords,
490
+ anchor: item.anchor,
491
+ url: item.anchor ? `${item.page}#${item.anchor}` : item.page
492
+ };
493
+ });
494
+ }
495
+
496
+ // Search through index
497
+ function search(query) {
498
+ if (!query || query.length < 2) return [];
499
+
500
+ // Build index if not ready
501
+ if (!searchIndex) {
502
+ searchIndex = buildIndex();
503
+ }
504
+
505
+ const normalizedQuery = query.toLowerCase().trim();
506
+ const words = normalizedQuery.split(/\s+/).filter(w => w.length >= 2);
507
+ const results = [];
508
+ const seenPages = new Set();
509
+
510
+ searchIndex.forEach(item => {
511
+ // Check if any word matches
512
+ const anyWordMatch = words.some(word => item.content.includes(word));
513
+ if (!anyWordMatch) return;
514
+
515
+ // Calculate relevance score
516
+ let score = 0;
517
+ words.forEach(word => {
518
+ if (item.content.includes(word)) {
519
+ // Title match is worth more
520
+ if (item.pageTitle.toLowerCase().includes(word)) score += 10;
521
+ if (item.sectionTitle.toLowerCase().includes(word)) score += 5;
522
+ // Count occurrences in content
523
+ const matches = (item.content.match(new RegExp(word, 'g')) || []).length;
524
+ score += matches;
525
+ }
526
+ });
527
+
528
+ // Generate excerpt from keywords
529
+ let excerpt = item.contentRaw;
530
+ if (excerpt.length > 80) {
531
+ // Find first matching word position
532
+ const firstWord = words.find(w => item.contentRaw.toLowerCase().includes(w));
533
+ if (firstWord) {
534
+ const idx = item.contentRaw.toLowerCase().indexOf(firstWord);
535
+ const start = Math.max(0, idx - 20);
536
+ const end = Math.min(item.contentRaw.length, idx + 60);
537
+ excerpt = (start > 0 ? '...' : '') + item.contentRaw.substring(start, end) + (end < item.contentRaw.length ? '...' : '');
538
+ } else {
539
+ excerpt = item.contentRaw.substring(0, 80) + '...';
540
+ }
541
+ }
542
+
543
+ // Avoid duplicate pages for same section
544
+ const key = item.page + '#' + item.anchor;
545
+ if (!seenPages.has(key)) {
546
+ seenPages.add(key);
547
+ results.push({
548
+ ...item,
549
+ score,
550
+ excerpt
551
+ });
552
+ }
553
+ });
554
+
555
+ // Sort by score and limit results
556
+ return results
557
+ .sort((a, b) => b.score - a.score)
558
+ .slice(0, 10);
559
+ }
560
+
561
+ // Escape regex special chars
562
+ function escapeRegex(str) {
563
+ return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
564
+ }
565
+
566
+ // Highlight matches in text
567
+ function highlightMatch(text, query) {
568
+ const words = query.toLowerCase().split(/\s+/).filter(w => w.length >= 2);
569
+ let result = text;
570
+ words.forEach(word => {
571
+ const regex = new RegExp(`(${escapeRegex(word)})`, 'gi');
572
+ result = result.replace(regex, '<mark>$1</mark>');
573
+ });
574
+ return result;
575
+ }
576
+
577
+ function renderResults(results, query) {
578
+ const lang = getLang();
579
+
580
+ if (results.length === 0) {
581
+ const emptyMsg = lang === 'fr' ? 'Aucun résultat trouvé' : 'No results found';
582
+ searchResults.innerHTML = `<div class="search-results-empty">${emptyMsg}</div>`;
583
+ } else {
584
+ searchResults.innerHTML = results.map((item, index) => `
585
+ <a href="${item.url}" class="search-result-item${index === activeIndex ? ' active' : ''}" data-index="${index}">
586
+ <div class="search-result-icon">${item.icon}</div>
587
+ <div class="search-result-content">
588
+ <div class="search-result-title">${highlightMatch(item.pageTitle, query)}${item.sectionTitle ? ' <span class="search-result-section">› ' + highlightMatch(item.sectionTitle, query) + '</span>' : ''}</div>
589
+ <div class="search-result-excerpt">${highlightMatch(item.excerpt, query)}</div>
590
+ <div class="search-result-path">${item.url}</div>
591
+ </div>
592
+ </a>
593
+ `).join('');
594
+ }
595
+
596
+ searchResults.classList.add('visible');
597
+ }
598
+
599
+ function hideResults() {
600
+ searchResults.classList.remove('visible');
601
+ activeIndex = -1;
602
+ }
603
+
604
+ // Input handler with debounce
605
+ let debounceTimer;
606
+ searchInput.addEventListener('input', function() {
607
+ clearTimeout(debounceTimer);
608
+ const query = this.value.trim();
609
+
610
+ if (query.length >= 2) {
611
+ debounceTimer = setTimeout(() => {
612
+ const results = search(query);
613
+ activeIndex = -1;
614
+ renderResults(results, query);
615
+ }, 150);
616
+ } else {
617
+ hideResults();
618
+ }
619
+ });
620
+
621
+ // Keyboard navigation
622
+ searchInput.addEventListener('keydown', function(e) {
623
+ const items = searchResults.querySelectorAll('.search-result-item');
624
+
625
+ if (e.key === 'ArrowDown') {
626
+ e.preventDefault();
627
+ activeIndex = Math.min(activeIndex + 1, items.length - 1);
628
+ updateActiveItem(items);
629
+ } else if (e.key === 'ArrowUp') {
630
+ e.preventDefault();
631
+ activeIndex = Math.max(activeIndex - 1, 0);
632
+ updateActiveItem(items);
633
+ } else if (e.key === 'Enter') {
634
+ e.preventDefault();
635
+ if (activeIndex >= 0 && items[activeIndex]) {
636
+ window.location.href = items[activeIndex].getAttribute('href');
637
+ }
638
+ } else if (e.key === 'Escape') {
639
+ hideResults();
640
+ searchInput.blur();
641
+ }
642
+ });
643
+
644
+ function updateActiveItem(items) {
645
+ items.forEach((item, index) => {
646
+ item.classList.toggle('active', index === activeIndex);
647
+ });
648
+
649
+ if (items[activeIndex]) {
650
+ items[activeIndex].scrollIntoView({ block: 'nearest' });
651
+ }
652
+ }
653
+
654
+ // Focus handler
655
+ searchInput.addEventListener('focus', function() {
656
+ if (this.value.length >= 2) {
657
+ const results = search(this.value);
658
+ renderResults(results, this.value);
659
+ }
660
+ });
661
+
662
+ // Click outside to close
663
+ document.addEventListener('click', function(e) {
664
+ if (!e.target.closest('.header-search')) {
665
+ hideResults();
666
+ }
667
+ });
668
+
669
+ // Keyboard shortcut (Ctrl/Cmd + K)
670
+ document.addEventListener('keydown', function(e) {
671
+ if ((e.ctrlKey || e.metaKey) && e.key === 'k') {
672
+ e.preventDefault();
673
+ searchInput.focus();
674
+ searchInput.select();
675
+ }
676
+ });
677
+ }
678
+
679
+ /* ============================================
680
+ COPYABLE COMMANDS (SVG Diagram)
681
+ ============================================ */
682
+
683
+ function initCopyableCommands() {
684
+ const copyableElements = document.querySelectorAll('.cmd-copyable');
685
+
686
+ if (copyableElements.length === 0) return;
687
+
688
+ // Get current language
689
+ function getLang() {
690
+ return document.body.classList.contains('lang-en') ? 'en' : 'fr';
691
+ }
692
+
693
+ // Create floating tooltip for feedback
694
+ const tooltip = document.createElement('div');
695
+ tooltip.className = 'copy-tooltip';
696
+ tooltip.style.cssText = `
697
+ position: fixed;
698
+ background: #22c55e;
699
+ color: white;
700
+ padding: 0.5rem 1rem;
701
+ border-radius: 6px;
702
+ font-size: 0.85rem;
703
+ font-weight: 500;
704
+ z-index: 10000;
705
+ pointer-events: none;
706
+ opacity: 0;
707
+ transition: opacity 0.2s ease;
708
+ box-shadow: 0 4px 12px rgba(0,0,0,0.3);
709
+ `;
710
+ document.body.appendChild(tooltip);
711
+
712
+ copyableElements.forEach(element => {
713
+ // Add hover effect
714
+ element.addEventListener('mouseenter', function() {
715
+ const rect = this.querySelector('rect');
716
+ if (rect) {
717
+ rect.style.filter = 'brightness(1.2)';
718
+ rect.style.transition = 'filter 0.2s ease';
719
+ }
720
+ });
721
+
722
+ element.addEventListener('mouseleave', function() {
723
+ const rect = this.querySelector('rect');
724
+ if (rect) {
725
+ rect.style.filter = '';
726
+ }
727
+ });
728
+
729
+ // Add click handler
730
+ element.addEventListener('click', function(e) {
731
+ e.stopPropagation();
732
+
733
+ const cmd = this.dataset.cmd;
734
+ if (!cmd) return;
735
+
736
+ // Copy to clipboard
737
+ navigator.clipboard.writeText(cmd).then(() => {
738
+ // Show tooltip
739
+ const lang = getLang();
740
+ tooltip.textContent = lang === 'fr' ? '✓ Copié !' : '✓ Copied!';
741
+
742
+ // Position tooltip near cursor
743
+ tooltip.style.left = e.clientX + 10 + 'px';
744
+ tooltip.style.top = e.clientY - 30 + 'px';
745
+ tooltip.style.opacity = '1';
746
+
747
+ // Flash effect on element
748
+ const rect = this.querySelector('rect');
749
+ if (rect) {
750
+ const originalStroke = rect.getAttribute('stroke');
751
+ rect.setAttribute('stroke', '#22c55e');
752
+ rect.style.filter = 'brightness(1.4)';
753
+
754
+ setTimeout(() => {
755
+ rect.setAttribute('stroke', originalStroke);
756
+ rect.style.filter = '';
757
+ }, 300);
758
+ }
759
+
760
+ // Hide tooltip after delay
761
+ setTimeout(() => {
762
+ tooltip.style.opacity = '0';
763
+ }, 1500);
764
+ }).catch(err => {
765
+ console.error('Failed to copy:', err);
766
+ const lang = getLang();
767
+ tooltip.textContent = lang === 'fr' ? '✗ Erreur' : '✗ Error';
768
+ tooltip.style.background = '#ef4444';
769
+ tooltip.style.left = e.clientX + 10 + 'px';
770
+ tooltip.style.top = e.clientY - 30 + 'px';
771
+ tooltip.style.opacity = '1';
772
+
773
+ setTimeout(() => {
774
+ tooltip.style.opacity = '0';
775
+ tooltip.style.background = '#22c55e';
776
+ }, 1500);
777
+ });
778
+ });
779
+ });
780
+ }