@atlashub/smartstack-cli 3.39.0 → 3.41.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 (472) 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 +6 -3
  12. package/dist/index.js.map +1 -1
  13. package/dist/mcp-entry.mjs +6 -4
  14. package/dist/mcp-entry.mjs.map +1 -1
  15. package/package.json +115 -115
  16. package/scripts/extract-api-endpoints.ts +325 -325
  17. package/scripts/extract-business-rules.ts +440 -440
  18. package/scripts/generate-doc-with-mock-ui.ts +804 -804
  19. package/scripts/health-check.sh +168 -168
  20. package/scripts/postinstall.js +18 -18
  21. package/templates/agents/action.md +37 -37
  22. package/templates/agents/ba-reader.md +378 -378
  23. package/templates/agents/ba-writer.md +861 -861
  24. package/templates/agents/code-reviewer.md +163 -163
  25. package/templates/agents/db-reader.md +149 -149
  26. package/templates/agents/docs-context-reader.md +143 -143
  27. package/templates/agents/docs-sync-checker.md +122 -122
  28. package/templates/agents/efcore/conflicts.md +95 -84
  29. package/templates/agents/efcore/db-deploy.md +85 -74
  30. package/templates/agents/efcore/db-reset.md +96 -85
  31. package/templates/agents/efcore/db-seed.md +72 -61
  32. package/templates/agents/efcore/db-status.md +97 -86
  33. package/templates/agents/efcore/migration.md +197 -186
  34. package/templates/agents/efcore/rebase-snapshot.md +119 -108
  35. package/templates/agents/efcore/scan.md +103 -92
  36. package/templates/agents/efcore/squash.md +172 -161
  37. package/templates/agents/explore-codebase.md +66 -66
  38. package/templates/agents/explore-docs.md +98 -98
  39. package/templates/agents/fix-grammar.md +50 -50
  40. package/templates/agents/gitflow/abort.md +45 -45
  41. package/templates/agents/gitflow/cleanup.md +96 -96
  42. package/templates/agents/gitflow/commit.md +236 -236
  43. package/templates/agents/gitflow/exec.md +48 -48
  44. package/templates/agents/gitflow/finish.md +146 -146
  45. package/templates/agents/gitflow/init-clone.md +199 -199
  46. package/templates/agents/gitflow/init-detect.md +137 -137
  47. package/templates/agents/gitflow/init-validate.md +225 -225
  48. package/templates/agents/gitflow/init.md +340 -340
  49. package/templates/agents/gitflow/merge.md +145 -145
  50. package/templates/agents/gitflow/plan.md +42 -42
  51. package/templates/agents/gitflow/pr.md +191 -191
  52. package/templates/agents/gitflow/review.md +49 -49
  53. package/templates/agents/gitflow/start.md +147 -147
  54. package/templates/agents/gitflow/status.md +95 -95
  55. package/templates/agents/mcp-healthcheck.md +163 -163
  56. package/templates/agents/snipper.md +37 -37
  57. package/templates/agents/websearch.md +46 -46
  58. package/templates/hooks/appsettings-guard.sh +76 -76
  59. package/templates/hooks/docs-drift-check.md +96 -96
  60. package/templates/hooks/ef-migration-check.md +139 -139
  61. package/templates/hooks/hooks.json +58 -58
  62. package/templates/hooks/mcp-check.md +64 -64
  63. package/templates/hooks/ralph-mcp-logger.sh +46 -46
  64. package/templates/hooks/ralph-session-end.sh +69 -69
  65. package/templates/hooks/stop-hook.sh +177 -177
  66. package/templates/hooks/wsl-dotnet-cleanup.sh +24 -24
  67. package/templates/mcp-scaffolding/component.tsx.hbs +318 -318
  68. package/templates/mcp-scaffolding/controller.cs.hbs +192 -192
  69. package/templates/mcp-scaffolding/entity-extension.cs.hbs +239 -239
  70. package/templates/mcp-scaffolding/frontend/api-client.ts.hbs +116 -116
  71. package/templates/mcp-scaffolding/frontend/nav-routes.ts.hbs +133 -133
  72. package/templates/mcp-scaffolding/frontend/routes.tsx.hbs +126 -126
  73. package/templates/mcp-scaffolding/migrations/seed-roles.cs.hbs +261 -261
  74. package/templates/mcp-scaffolding/service-extension.cs.hbs +53 -53
  75. package/templates/mcp-scaffolding/tests/controller.test.cs.hbs +436 -436
  76. package/templates/mcp-scaffolding/tests/entity.test.cs.hbs +239 -239
  77. package/templates/mcp-scaffolding/tests/repository.test.cs.hbs +441 -441
  78. package/templates/mcp-scaffolding/tests/security.test.cs.hbs +442 -442
  79. package/templates/mcp-scaffolding/tests/service.test.cs.hbs +402 -402
  80. package/templates/mcp-scaffolding/tests/validator.test.cs.hbs +428 -428
  81. package/templates/project/DependencyInjection.Application.cs.template +25 -25
  82. package/templates/project/DependencyInjection.Infrastructure.cs.template +61 -61
  83. package/templates/project/DesignTimeExtensionsDbContextFactory.cs.template +70 -70
  84. package/templates/project/ExampleEntity.cs.template +116 -116
  85. package/templates/project/ExampleEntityConfiguration.cs.template +64 -64
  86. package/templates/project/ExampleService.cs.template +146 -146
  87. package/templates/project/ExtensionsDbContext.cs.template +41 -41
  88. package/templates/project/IExtensionsDbContext.cs.template +22 -22
  89. package/templates/project/Program.cs.template +47 -47
  90. package/templates/project/README.md +79 -79
  91. package/templates/project/api.ts.template +12 -12
  92. package/templates/project/appsettings.json.template +170 -170
  93. package/templates/project/claude-settings.json.template +5 -5
  94. package/templates/project/test-frontend/msw/handlers.ts +58 -58
  95. package/templates/project/test-frontend/msw/server.ts +25 -25
  96. package/templates/project/test-frontend/setup.ts +16 -16
  97. package/templates/project/test-frontend/test-utils.tsx +59 -59
  98. package/templates/project/test-frontend/vitest.config.ts +31 -31
  99. package/templates/ralph/README.md +93 -93
  100. package/templates/ralph/ralph.config.yaml +113 -113
  101. package/templates/scripts/setup-ralph-loop.sh +173 -173
  102. package/templates/skills/_resources/config-safety.md +61 -61
  103. package/templates/skills/_resources/context-digest-template.md +53 -53
  104. package/templates/skills/_resources/doc-context-cache.md +60 -60
  105. package/templates/skills/_resources/docs-manifest-schema.md +155 -155
  106. package/templates/skills/_resources/formatting-guide.md +124 -124
  107. package/templates/skills/_resources/mcp-validate-documentation-spec.md +181 -181
  108. package/templates/skills/_shared.md +228 -228
  109. package/templates/skills/admin/SKILL.md +48 -48
  110. package/templates/skills/ai-prompt/SKILL.md +107 -107
  111. package/templates/skills/ai-prompt/steps/step-00-init.md +47 -47
  112. package/templates/skills/ai-prompt/steps/step-01-implementation.md +122 -122
  113. package/templates/skills/apex/SKILL.md +168 -168
  114. package/templates/skills/apex/_shared.md +141 -141
  115. package/templates/skills/apex/references/agent-teams-protocol.md +164 -164
  116. package/templates/skills/apex/references/analysis-methods.md +141 -141
  117. package/templates/skills/apex/references/challenge-questions.md +145 -145
  118. package/templates/skills/apex/references/code-generation.md +412 -412
  119. package/templates/skills/apex/references/core-seed-data.md +1437 -1437
  120. package/templates/skills/apex/references/error-classification.md +144 -144
  121. package/templates/skills/apex/references/examine-build-validation.md +82 -82
  122. package/templates/skills/apex/references/execution-frontend-gates.md +177 -177
  123. package/templates/skills/apex/references/execution-frontend-patterns.md +105 -105
  124. package/templates/skills/apex/references/execution-layer1-rules.md +96 -96
  125. package/templates/skills/apex/references/initialization-challenge-flow.md +110 -110
  126. package/templates/skills/apex/references/planning-layer-mapping.md +151 -151
  127. package/templates/skills/apex/references/post-checks.md +1584 -1584
  128. package/templates/skills/apex/references/smartstack-api.md +1053 -1053
  129. package/templates/skills/apex/references/smartstack-frontend.md +1571 -1571
  130. package/templates/skills/apex/references/smartstack-layers.md +402 -402
  131. package/templates/skills/apex/steps/step-00-init.md +307 -307
  132. package/templates/skills/apex/steps/step-01-analyze.md +165 -165
  133. package/templates/skills/apex/steps/step-02-plan.md +144 -144
  134. package/templates/skills/apex/steps/step-03-execute.md +328 -328
  135. package/templates/skills/apex/steps/step-04-examine.md +263 -263
  136. package/templates/skills/apex/steps/step-05-deep-review.md +129 -129
  137. package/templates/skills/apex/steps/step-06-resolve.md +101 -101
  138. package/templates/skills/apex/steps/step-07-tests.md +238 -238
  139. package/templates/skills/apex/steps/step-08-run-tests.md +125 -125
  140. package/templates/skills/application/SKILL.md +4 -4
  141. package/templates/skills/application/references/application-roles-template.md +227 -227
  142. package/templates/skills/application/references/backend-controller-hierarchy.md +58 -58
  143. package/templates/skills/application/references/backend-entity-seeding.md +72 -72
  144. package/templates/skills/application/references/backend-seeding-and-dto-output.md +83 -83
  145. package/templates/skills/application/references/backend-table-prefix-mapping.md +79 -79
  146. package/templates/skills/application/references/backend-verification.md +88 -88
  147. package/templates/skills/application/references/frontend-i18n-and-output.md +67 -67
  148. package/templates/skills/application/references/frontend-route-naming.md +117 -117
  149. package/templates/skills/application/references/frontend-route-wiring-app-tsx.md +107 -107
  150. package/templates/skills/application/references/frontend-verification.md +156 -156
  151. package/templates/skills/application/references/migration-checklist-troubleshooting.md +1 -1
  152. package/templates/skills/application/references/provider-template.md +177 -177
  153. package/templates/skills/application/references/roles-client-project-handling.md +55 -55
  154. package/templates/skills/application/references/roles-fallback-procedure.md +149 -149
  155. package/templates/skills/application/references/test-coverage-requirements.md +213 -213
  156. package/templates/skills/application/references/test-frontend.md +73 -73
  157. package/templates/skills/application/references/test-prerequisites.md +72 -72
  158. package/templates/skills/application/steps/step-05-frontend.md +176 -176
  159. package/templates/skills/application/steps/step-06-migration.md +193 -193
  160. package/templates/skills/application/steps/step-07-tests.md +356 -356
  161. package/templates/skills/application/steps/step-08-documentation.md +137 -137
  162. package/templates/skills/application/templates-backend.md +463 -463
  163. package/templates/skills/application/templates-frontend.md +685 -685
  164. package/templates/skills/application/templates-i18n.md +520 -520
  165. package/templates/skills/application/templates-seed.md +1096 -1096
  166. package/templates/skills/business-analyse/SKILL.md +327 -327
  167. package/templates/skills/business-analyse/_architecture.md +123 -123
  168. package/templates/skills/business-analyse/_elicitation.md +206 -206
  169. package/templates/skills/business-analyse/_module-loop.md +115 -115
  170. package/templates/skills/business-analyse/_shared.md +383 -383
  171. package/templates/skills/business-analyse/_suggestions.md +34 -34
  172. package/templates/skills/business-analyse/html/ba-interactive.html +4477 -4477
  173. package/templates/skills/business-analyse/html/build-html.js +77 -77
  174. package/templates/skills/business-analyse/html/src/scripts/01-data-init.js +150 -150
  175. package/templates/skills/business-analyse/html/src/scripts/02-navigation.js +227 -227
  176. package/templates/skills/business-analyse/html/src/scripts/03-render-cadrage.js +199 -199
  177. package/templates/skills/business-analyse/html/src/scripts/04-render-modules.js +205 -205
  178. package/templates/skills/business-analyse/html/src/scripts/05-render-specs.js +647 -647
  179. package/templates/skills/business-analyse/html/src/scripts/06-render-consolidation.js +195 -195
  180. package/templates/skills/business-analyse/html/src/scripts/07-render-handoff.js +92 -92
  181. package/templates/skills/business-analyse/html/src/scripts/08-editing.js +135 -135
  182. package/templates/skills/business-analyse/html/src/scripts/09-export.js +168 -168
  183. package/templates/skills/business-analyse/html/src/scripts/10-comments.js +171 -171
  184. package/templates/skills/business-analyse/html/src/scripts/11-review-panel.js +166 -166
  185. package/templates/skills/business-analyse/html/src/styles/01-variables.css +38 -38
  186. package/templates/skills/business-analyse/html/src/styles/02-layout.css +101 -101
  187. package/templates/skills/business-analyse/html/src/styles/03-navigation.css +120 -120
  188. package/templates/skills/business-analyse/html/src/styles/04-cards.css +196 -196
  189. package/templates/skills/business-analyse/html/src/styles/05-modules.css +454 -454
  190. package/templates/skills/business-analyse/html/src/styles/06-wireframes.css +272 -272
  191. package/templates/skills/business-analyse/html/src/styles/07-comments.css +184 -184
  192. package/templates/skills/business-analyse/html/src/styles/08-review-panel.css +241 -241
  193. package/templates/skills/business-analyse/html/src/template.html +516 -516
  194. package/templates/skills/business-analyse/patterns/suggestion-catalog.md +546 -546
  195. package/templates/skills/business-analyse/questionnaire/00-application.md +160 -160
  196. package/templates/skills/business-analyse/questionnaire/00b-project.md +85 -85
  197. package/templates/skills/business-analyse/questionnaire/01-context.md +185 -185
  198. package/templates/skills/business-analyse/questionnaire/02-stakeholders.md +189 -189
  199. package/templates/skills/business-analyse/questionnaire/03-scope.md +164 -164
  200. package/templates/skills/business-analyse/questionnaire/04-data.md +88 -88
  201. package/templates/skills/business-analyse/questionnaire/05-integrations.md +58 -58
  202. package/templates/skills/business-analyse/questionnaire/06-security.md +68 -68
  203. package/templates/skills/business-analyse/questionnaire/07-ui.md +76 -76
  204. package/templates/skills/business-analyse/questionnaire/08-performance.md +42 -42
  205. package/templates/skills/business-analyse/questionnaire/09-constraints.md +45 -45
  206. package/templates/skills/business-analyse/questionnaire/10-documentation.md +43 -43
  207. package/templates/skills/business-analyse/questionnaire/11-data-lifecycle.md +59 -59
  208. package/templates/skills/business-analyse/questionnaire/12-migration.md +58 -58
  209. package/templates/skills/business-analyse/questionnaire/13-cross-module.md +69 -69
  210. package/templates/skills/business-analyse/questionnaire/14-risk-assumptions.md +135 -135
  211. package/templates/skills/business-analyse/questionnaire/15-success-metrics.md +136 -136
  212. package/templates/skills/business-analyse/questionnaire.md +337 -337
  213. package/templates/skills/business-analyse/react/application-viewer.md +242 -242
  214. package/templates/skills/business-analyse/react/components.md +551 -551
  215. package/templates/skills/business-analyse/react/i18n-template.md +306 -306
  216. package/templates/skills/business-analyse/references/acceptance-criteria.md +169 -169
  217. package/templates/skills/business-analyse/references/agent-module-prompt.md +362 -362
  218. package/templates/skills/business-analyse/references/agent-pooling-best-practices.md +557 -557
  219. package/templates/skills/business-analyse/references/analysis-semantic-checks.md +190 -190
  220. package/templates/skills/business-analyse/references/cache-warming-strategy.md +566 -566
  221. package/templates/skills/business-analyse/references/cadrage-challenge-patterns.md +41 -41
  222. package/templates/skills/business-analyse/references/cadrage-coverage-matrix.md +74 -74
  223. package/templates/skills/business-analyse/references/cadrage-pre-analysis.md +115 -115
  224. package/templates/skills/business-analyse/references/cadrage-shared-modules.md +68 -69
  225. package/templates/skills/business-analyse/references/cadrage-structure-cards.md +85 -85
  226. package/templates/skills/business-analyse/references/compilation-structure-cards.md +297 -297
  227. package/templates/skills/business-analyse/references/consolidation-structural-checks.md +107 -107
  228. package/templates/skills/business-analyse/references/deploy-data-build.md +180 -180
  229. package/templates/skills/business-analyse/references/deploy-modes.md +118 -118
  230. package/templates/skills/business-analyse/references/detection-strategies.md +424 -424
  231. package/templates/skills/business-analyse/references/entity-architecture-decision.md +218 -218
  232. package/templates/skills/business-analyse/references/handoff-file-templates.md +120 -120
  233. package/templates/skills/business-analyse/references/handoff-mappings.md +81 -81
  234. package/templates/skills/business-analyse/references/handoff-seeddata-generation.md +312 -312
  235. package/templates/skills/business-analyse/references/html-data-mapping.md +299 -299
  236. package/templates/skills/business-analyse/references/init-schema-deployment.md +65 -65
  237. package/templates/skills/business-analyse/references/naming-conventions.md +243 -243
  238. package/templates/skills/business-analyse/references/prd-generation.md +258 -258
  239. package/templates/skills/business-analyse/references/review-data-mapping.md +363 -363
  240. package/templates/skills/business-analyse/references/robustness-checks.md +542 -542
  241. package/templates/skills/business-analyse/references/spec-auto-inference.md +111 -111
  242. package/templates/skills/business-analyse/references/team-orchestration.md +1022 -1022
  243. package/templates/skills/business-analyse/references/ui-dashboard-spec.md +85 -85
  244. package/templates/skills/business-analyse/references/ui-resource-cards.md +259 -259
  245. package/templates/skills/business-analyse/references/validate-incremental-html.md +121 -121
  246. package/templates/skills/business-analyse/references/validation-checklist.md +347 -347
  247. package/templates/skills/business-analyse/references/wireframe-svg-style-guide.md +335 -335
  248. package/templates/skills/business-analyse/schemas/application-schema.json +453 -453
  249. package/templates/skills/business-analyse/schemas/feature-schema.json +53 -53
  250. package/templates/skills/business-analyse/schemas/project-schema.json +485 -485
  251. package/templates/skills/business-analyse/schemas/sections/analysis-schema.json +201 -201
  252. package/templates/skills/business-analyse/schemas/sections/discovery-schema.json +82 -82
  253. package/templates/skills/business-analyse/schemas/sections/handoff-schema.json +80 -80
  254. package/templates/skills/business-analyse/schemas/sections/metadata-schema.json +70 -70
  255. package/templates/skills/business-analyse/schemas/sections/specification-schema.json +547 -547
  256. package/templates/skills/business-analyse/schemas/sections/validation-schema.json +93 -93
  257. package/templates/skills/business-analyse/schemas/shared/common-defs.json +226 -226
  258. package/templates/skills/business-analyse/steps/step-00-init.md +575 -576
  259. package/templates/skills/business-analyse/steps/step-01-cadrage.md +767 -767
  260. package/templates/skills/business-analyse/steps/step-01b-applications.md +419 -419
  261. package/templates/skills/business-analyse/steps/step-02-decomposition.md +387 -387
  262. package/templates/skills/business-analyse/steps/step-03a-data.md +16 -16
  263. package/templates/skills/business-analyse/steps/step-03a1-setup.md +506 -506
  264. package/templates/skills/business-analyse/steps/step-03a2-analysis.md +252 -252
  265. package/templates/skills/business-analyse/steps/step-03b-ui.md +425 -425
  266. package/templates/skills/business-analyse/steps/step-03c-compile.md +611 -611
  267. package/templates/skills/business-analyse/steps/step-03d-validate.md +783 -783
  268. package/templates/skills/business-analyse/steps/step-04-consolidation.md +17 -17
  269. package/templates/skills/business-analyse/steps/step-04a-collect.md +415 -415
  270. package/templates/skills/business-analyse/steps/step-04b-analyze.md +163 -163
  271. package/templates/skills/business-analyse/steps/step-04c-decide.md +186 -186
  272. package/templates/skills/business-analyse/steps/step-05a-handoff.md +840 -840
  273. package/templates/skills/business-analyse/steps/step-05b-deploy.md +522 -522
  274. package/templates/skills/business-analyse/steps/step-05c-ralph-readiness.md +703 -703
  275. package/templates/skills/business-analyse/steps/step-06-review.md +278 -278
  276. package/templates/skills/business-analyse/templates/tpl-frd.md +168 -168
  277. package/templates/skills/business-analyse/templates/tpl-handoff.md +186 -186
  278. package/templates/skills/business-analyse/templates/tpl-launch-displays.md +59 -59
  279. package/templates/skills/business-analyse/templates/tpl-progress.md +172 -172
  280. package/templates/skills/business-analyse/templates-frd.md +476 -476
  281. package/templates/skills/business-analyse/templates-react.md +574 -574
  282. package/templates/skills/cc-agent/SKILL.md +129 -129
  283. package/templates/skills/cc-agent/references/agent-behavior-patterns.md +95 -95
  284. package/templates/skills/cc-agent/references/agent-frontmatter.md +213 -213
  285. package/templates/skills/cc-agent/references/permission-modes.md +102 -102
  286. package/templates/skills/cc-agent/references/tools-reference.md +144 -144
  287. package/templates/skills/cc-agent/steps/step-00-init.md +134 -134
  288. package/templates/skills/cc-agent/steps/step-01-design.md +186 -186
  289. package/templates/skills/cc-agent/steps/step-02-generate.md +131 -131
  290. package/templates/skills/cc-agent/steps/step-03-validate.md +130 -130
  291. package/templates/skills/cc-agent/templates/agent-categorized.md +67 -67
  292. package/templates/skills/cc-agent/templates/agent-standalone.md +56 -56
  293. package/templates/skills/cc-agent/templates/agent-with-skills.md +94 -94
  294. package/templates/skills/cc-audit/SKILL.md +108 -108
  295. package/templates/skills/cc-audit/references/agent-checklist.md +91 -91
  296. package/templates/skills/cc-audit/references/hook-checklist.md +110 -110
  297. package/templates/skills/cc-audit/references/skill-checklist.md +70 -70
  298. package/templates/skills/cc-audit/steps/step-00-init.md +98 -98
  299. package/templates/skills/cc-audit/steps/step-01-scan.md +142 -142
  300. package/templates/skills/cc-audit/steps/step-02-analyze.md +158 -158
  301. package/templates/skills/cc-audit/steps/step-03-report.md +142 -142
  302. package/templates/skills/cc-skill/SKILL.md +134 -134
  303. package/templates/skills/cc-skill/references/best-practices.md +167 -167
  304. package/templates/skills/cc-skill/references/frontmatter-reference.md +182 -182
  305. package/templates/skills/cc-skill/references/skill-patterns.md +199 -199
  306. package/templates/skills/cc-skill/steps/step-00-init.md +119 -119
  307. package/templates/skills/cc-skill/steps/step-01-design.md +199 -199
  308. package/templates/skills/cc-skill/steps/step-02-generate.md +145 -145
  309. package/templates/skills/cc-skill/steps/step-03-steps.md +151 -151
  310. package/templates/skills/cc-skill/steps/step-04-validate.md +124 -124
  311. package/templates/skills/cc-skill/templates/skill-forked.md +85 -85
  312. package/templates/skills/cc-skill/templates/skill-progressive.md +102 -102
  313. package/templates/skills/cc-skill/templates/skill-simple.md +75 -75
  314. package/templates/skills/cc-skill/templates/step-template.md +82 -82
  315. package/templates/skills/check-version/SKILL.md +196 -196
  316. package/templates/skills/controller/SKILL.md +162 -162
  317. package/templates/skills/controller/postman-templates.md +614 -614
  318. package/templates/skills/controller/references/controller-code-templates.md +159 -159
  319. package/templates/skills/controller/references/mcp-scaffold-workflow.md +209 -209
  320. package/templates/skills/controller/references/permission-sync-templates.md +149 -149
  321. package/templates/skills/controller/steps/step-00-init.md +193 -191
  322. package/templates/skills/controller/steps/step-01-analyze.md +146 -146
  323. package/templates/skills/controller/steps/step-02-plan.md +176 -176
  324. package/templates/skills/controller/steps/step-03-generate.md +189 -189
  325. package/templates/skills/controller/steps/step-04-perms.md +80 -80
  326. package/templates/skills/controller/steps/step-05-validate.md +107 -107
  327. package/templates/skills/controller/templates.md +1555 -1555
  328. package/templates/skills/debug/SKILL.md +70 -70
  329. package/templates/skills/debug/references/team-protocol.md +232 -232
  330. package/templates/skills/debug/steps/step-00-init.md +57 -57
  331. package/templates/skills/debug/steps/step-01-analyze.md +219 -219
  332. package/templates/skills/debug/steps/step-02-resolve.md +85 -85
  333. package/templates/skills/documentation/SKILL.md +132 -132
  334. package/templates/skills/documentation/data-schema.md +227 -227
  335. package/templates/skills/documentation/steps/step-00-init.md +70 -70
  336. package/templates/skills/documentation/steps/step-01-scan.md +113 -113
  337. package/templates/skills/documentation/steps/step-02-generate.md +231 -231
  338. package/templates/skills/documentation/steps/step-03-validate.md +251 -238
  339. package/templates/skills/documentation/templates.md +662 -663
  340. package/templates/skills/efcore/SKILL.md +168 -167
  341. package/templates/skills/efcore/references/both-contexts.md +32 -32
  342. package/templates/skills/efcore/references/database-operations.md +67 -67
  343. package/templates/skills/efcore/references/destructive-operations.md +38 -38
  344. package/templates/skills/efcore/references/reset-operations.md +81 -81
  345. package/templates/skills/efcore/references/seed-methods.md +86 -86
  346. package/templates/skills/efcore/references/shared-init-functions.md +250 -250
  347. package/templates/skills/efcore/references/sql-objects-injection.md +61 -61
  348. package/templates/skills/efcore/references/troubleshooting.md +81 -81
  349. package/templates/skills/efcore/references/zero-downtime-patterns.md +227 -227
  350. package/templates/skills/efcore/steps/db/step-deploy.md +217 -217
  351. package/templates/skills/efcore/steps/db/step-reset.md +186 -186
  352. package/templates/skills/efcore/steps/db/step-seed.md +166 -166
  353. package/templates/skills/efcore/steps/db/step-status.md +173 -173
  354. package/templates/skills/efcore/steps/migration/step-00-init.md +102 -102
  355. package/templates/skills/efcore/steps/migration/step-01-check.md +164 -164
  356. package/templates/skills/efcore/steps/migration/step-02-create.md +160 -160
  357. package/templates/skills/efcore/steps/migration/step-03-validate.md +168 -168
  358. package/templates/skills/efcore/steps/rebase-snapshot/step-00-init.md +173 -173
  359. package/templates/skills/efcore/steps/rebase-snapshot/step-01-backup.md +100 -100
  360. package/templates/skills/efcore/steps/rebase-snapshot/step-02-fetch.md +115 -115
  361. package/templates/skills/efcore/steps/rebase-snapshot/step-03-create.md +112 -112
  362. package/templates/skills/efcore/steps/rebase-snapshot/step-04-validate.md +157 -157
  363. package/templates/skills/efcore/steps/shared/step-00-init.md +131 -131
  364. package/templates/skills/efcore/steps/squash/step-00-init.md +141 -141
  365. package/templates/skills/efcore/steps/squash/step-01-backup.md +120 -120
  366. package/templates/skills/efcore/steps/squash/step-02-fetch.md +168 -168
  367. package/templates/skills/efcore/steps/squash/step-03-create.md +184 -184
  368. package/templates/skills/efcore/steps/squash/step-04-validate.md +174 -174
  369. package/templates/skills/explore/SKILL.md +98 -98
  370. package/templates/skills/feature-full/SKILL.md +111 -111
  371. package/templates/skills/feature-full/steps/step-00-init.md +57 -57
  372. package/templates/skills/feature-full/steps/step-01-implementation.md +120 -120
  373. package/templates/skills/gitflow/SKILL.md +377 -377
  374. package/templates/skills/gitflow/_shared.md +620 -620
  375. package/templates/skills/gitflow/phases/abort.md +189 -189
  376. package/templates/skills/gitflow/phases/cleanup.md +234 -234
  377. package/templates/skills/gitflow/phases/status.md +192 -192
  378. package/templates/skills/gitflow/references/commit-message-generation.md +58 -58
  379. package/templates/skills/gitflow/references/commit-migration-validation.md +49 -49
  380. package/templates/skills/gitflow/references/finish-cleanup.md +55 -55
  381. package/templates/skills/gitflow/references/finish-version-bumping.md +45 -45
  382. package/templates/skills/gitflow/references/init-config-template.md +135 -135
  383. package/templates/skills/gitflow/references/init-environment-detection.md +41 -41
  384. package/templates/skills/gitflow/references/init-name-normalization.md +103 -103
  385. package/templates/skills/gitflow/references/init-questions.md +185 -185
  386. package/templates/skills/gitflow/references/init-structure-creation.md +75 -75
  387. package/templates/skills/gitflow/references/init-version-detection.md +21 -21
  388. package/templates/skills/gitflow/references/init-workspace-detection.md +43 -43
  389. package/templates/skills/gitflow/references/merge-ci-status.md +36 -36
  390. package/templates/skills/gitflow/references/merge-execution.md +62 -62
  391. package/templates/skills/gitflow/references/merge-pr-context.md +76 -76
  392. package/templates/skills/gitflow/references/plan-template.md +69 -69
  393. package/templates/skills/gitflow/references/pr-build-checks.md +60 -60
  394. package/templates/skills/gitflow/references/pr-generation.md +58 -58
  395. package/templates/skills/gitflow/references/start-branch-normalization.md +28 -28
  396. package/templates/skills/gitflow/references/start-efcore-preflight.md +70 -70
  397. package/templates/skills/gitflow/references/start-local-config.md +113 -113
  398. package/templates/skills/gitflow/references/start-worktree-creation.md +50 -50
  399. package/templates/skills/gitflow/references/sync-push-verify.md +44 -44
  400. package/templates/skills/gitflow/references/sync-rebase-conflicts.md +38 -38
  401. package/templates/skills/gitflow/steps/step-commit.md +199 -199
  402. package/templates/skills/gitflow/steps/step-finish.md +147 -147
  403. package/templates/skills/gitflow/steps/step-init.md +190 -190
  404. package/templates/skills/gitflow/steps/step-merge.md +85 -85
  405. package/templates/skills/gitflow/steps/step-plan.md +151 -151
  406. package/templates/skills/gitflow/steps/step-pr.md +199 -199
  407. package/templates/skills/gitflow/steps/step-start.md +195 -195
  408. package/templates/skills/gitflow/steps/step-sync.md +161 -161
  409. package/templates/skills/gitflow/templates/config.json +72 -72
  410. package/templates/skills/mcp/SKILL.md +62 -62
  411. package/templates/skills/mcp/steps/step-01-healthcheck.md +108 -108
  412. package/templates/skills/mcp/steps/step-02-tools.md +73 -73
  413. package/templates/skills/notification/SKILL.md +173 -173
  414. package/templates/skills/quick-search/SKILL.md +99 -99
  415. package/templates/skills/ralph-loop/SKILL.md +234 -234
  416. package/templates/skills/ralph-loop/references/category-completeness.md +185 -185
  417. package/templates/skills/ralph-loop/references/category-rules.md +96 -96
  418. package/templates/skills/ralph-loop/references/compact-loop.md +300 -300
  419. package/templates/skills/ralph-loop/references/init-resume-recovery.md +127 -127
  420. package/templates/skills/ralph-loop/references/module-transition.md +151 -151
  421. package/templates/skills/ralph-loop/references/multi-module-queue.md +171 -171
  422. package/templates/skills/ralph-loop/references/parallel-execution.md +246 -246
  423. package/templates/skills/ralph-loop/references/section-splitting.md +439 -439
  424. package/templates/skills/ralph-loop/references/task-transform-legacy.md +256 -256
  425. package/templates/skills/ralph-loop/references/team-orchestration.md +547 -547
  426. package/templates/skills/ralph-loop/steps/step-00-init.md +150 -150
  427. package/templates/skills/ralph-loop/steps/step-01-task.md +174 -174
  428. package/templates/skills/ralph-loop/steps/step-02-execute.md +177 -177
  429. package/templates/skills/ralph-loop/steps/step-03-commit.md +92 -92
  430. package/templates/skills/ralph-loop/steps/step-04-check.md +207 -207
  431. package/templates/skills/ralph-loop/steps/step-05-report.md +175 -175
  432. package/templates/skills/refactor/SKILL.md +56 -56
  433. package/templates/skills/refactor/steps/step-01-discover.md +60 -60
  434. package/templates/skills/refactor/steps/step-02-execute.md +67 -67
  435. package/templates/skills/review-code/SKILL.md +95 -94
  436. package/templates/skills/review-code/references/clean-code-principles.md +292 -292
  437. package/templates/skills/review-code/references/code-quality-metrics.md +174 -174
  438. package/templates/skills/review-code/references/feedback-patterns.md +149 -149
  439. package/templates/skills/review-code/references/owasp-api-top10.md +243 -243
  440. package/templates/skills/review-code/references/security-checklist.md +212 -212
  441. package/templates/skills/review-code/steps/step-01-smartstack.md +96 -96
  442. package/templates/skills/review-code/steps/step-02-detailed-review.md +80 -80
  443. package/templates/skills/review-code/steps/step-03-react.md +44 -44
  444. package/templates/skills/ui-components/SKILL.md +137 -137
  445. package/templates/skills/ui-components/accessibility.md +170 -170
  446. package/templates/skills/ui-components/patterns/dashboard-chart.md +327 -327
  447. package/templates/skills/ui-components/patterns/data-table.md +39 -39
  448. package/templates/skills/ui-components/patterns/entity-card.md +77 -77
  449. package/templates/skills/ui-components/patterns/grid-layout.md +91 -91
  450. package/templates/skills/ui-components/patterns/kanban.md +43 -43
  451. package/templates/skills/ui-components/responsive-guidelines.md +278 -278
  452. package/templates/skills/ui-components/style-guide.md +113 -113
  453. package/templates/skills/utils/SKILL.md +44 -44
  454. package/templates/skills/utils/subcommands/test-web-config.md +152 -152
  455. package/templates/skills/utils/subcommands/test-web.md +123 -123
  456. package/templates/skills/validate/SKILL.md +181 -181
  457. package/templates/skills/validate-feature/SKILL.md +101 -101
  458. package/templates/skills/validate-feature/references/api-smoke-tests.md +140 -140
  459. package/templates/skills/validate-feature/references/db-validation-checks.md +180 -180
  460. package/templates/skills/validate-feature/steps/step-00-dependencies.md +121 -121
  461. package/templates/skills/validate-feature/steps/step-01-compile.md +39 -39
  462. package/templates/skills/validate-feature/steps/step-02-unit-tests.md +45 -45
  463. package/templates/skills/validate-feature/steps/step-03-integration-tests.md +53 -53
  464. package/templates/skills/validate-feature/steps/step-04-api-smoke.md +94 -94
  465. package/templates/skills/validate-feature/steps/step-05-db-validation.md +149 -149
  466. package/templates/skills/workflow/SKILL.md +127 -127
  467. package/templates/skills/workflow/steps/step-00-init.md +57 -57
  468. package/templates/skills/workflow/steps/step-01-implementation.md +84 -84
  469. package/templates/test-web/api-health.json +38 -38
  470. package/templates/test-web/minimal.json +19 -19
  471. package/templates/test-web/npm-package.json +46 -46
  472. 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
+ }