@flaviogarrido/reversa 0.0.0-stage → 1.3.7

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 (421) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +487 -2
  3. package/agents/fg-backlog/SKILL.md +129 -0
  4. package/agents/fg-backlog/agents/openai.yaml +5 -0
  5. package/agents/fg-backlog/references/backlog-template.md +60 -0
  6. package/agents/fg-backlog/references/priorizacao.md +41 -0
  7. package/agents/impeccable/LICENSE +191 -0
  8. package/agents/impeccable/NOTICE.md +11 -0
  9. package/agents/impeccable/SKILL.md +88 -0
  10. package/agents/impeccable/agents/impeccable_asset_producer.toml +47 -0
  11. package/agents/impeccable/agents/impeccable_documenter.toml +27 -0
  12. package/agents/impeccable/agents/impeccable_finish_reviewer.toml +41 -0
  13. package/agents/impeccable/agents/impeccable_manual_edit_applier.toml +95 -0
  14. package/agents/impeccable/agents/openai.yaml +4 -0
  15. package/agents/impeccable/reference/adapt.md +318 -0
  16. package/agents/impeccable/reference/adapt.native.md +58 -0
  17. package/agents/impeccable/reference/android.md +46 -0
  18. package/agents/impeccable/reference/animate.md +89 -0
  19. package/agents/impeccable/reference/audit.md +139 -0
  20. package/agents/impeccable/reference/audit.native.md +139 -0
  21. package/agents/impeccable/reference/bolder.md +33 -0
  22. package/agents/impeccable/reference/clarify.md +94 -0
  23. package/agents/impeccable/reference/colorize.md +86 -0
  24. package/agents/impeccable/reference/component-review.md +63 -0
  25. package/agents/impeccable/reference/craft-floor.md +44 -0
  26. package/agents/impeccable/reference/craft.md +5 -0
  27. package/agents/impeccable/reference/critique.md +819 -0
  28. package/agents/impeccable/reference/degraded/asset-producer.md +42 -0
  29. package/agents/impeccable/reference/degraded/documenter.md +24 -0
  30. package/agents/impeccable/reference/degraded/finish-reviewer.md +38 -0
  31. package/agents/impeccable/reference/degraded/manual-edit-applier.md +92 -0
  32. package/agents/impeccable/reference/delight.md +70 -0
  33. package/agents/impeccable/reference/distill.md +111 -0
  34. package/agents/impeccable/reference/doctor.md +54 -0
  35. package/agents/impeccable/reference/document.md +416 -0
  36. package/agents/impeccable/reference/extract.md +69 -0
  37. package/agents/impeccable/reference/generate.md +101 -0
  38. package/agents/impeccable/reference/harden.md +343 -0
  39. package/agents/impeccable/reference/hooks.md +113 -0
  40. package/agents/impeccable/reference/init.md +131 -0
  41. package/agents/impeccable/reference/ios.md +51 -0
  42. package/agents/impeccable/reference/layout.md +84 -0
  43. package/agents/impeccable/reference/live-setup.md +104 -0
  44. package/agents/impeccable/reference/live.md +325 -0
  45. package/agents/impeccable/reference/mode-operate.md +21 -0
  46. package/agents/impeccable/reference/mode-persuade.md +19 -0
  47. package/agents/impeccable/reference/mode-read.md +21 -0
  48. package/agents/impeccable/reference/new-work.md +154 -0
  49. package/agents/impeccable/reference/onboard.md +234 -0
  50. package/agents/impeccable/reference/operate.md +61 -0
  51. package/agents/impeccable/reference/optimize.md +258 -0
  52. package/agents/impeccable/reference/overdrive.md +127 -0
  53. package/agents/impeccable/reference/polish.md +105 -0
  54. package/agents/impeccable/reference/quieter.md +99 -0
  55. package/agents/impeccable/reference/region-map.md +26 -0
  56. package/agents/impeccable/reference/routing.md +24 -0
  57. package/agents/impeccable/reference/shape.md +59 -0
  58. package/agents/impeccable/reference/typeset.md +90 -0
  59. package/agents/impeccable/reference/visualize.md +47 -0
  60. package/agents/impeccable/reversa-bundle.json +16 -0
  61. package/agents/impeccable/scripts/VERSION +1 -0
  62. package/agents/impeccable/scripts/command-metadata.json +98 -0
  63. package/agents/impeccable/scripts/data/font-index-failures.json +121 -0
  64. package/agents/impeccable/scripts/data/font-index.json +1 -0
  65. package/agents/impeccable/scripts/impeccable +212 -0
  66. package/agents/impeccable/scripts/impeccable.cmd +239 -0
  67. package/agents/impeccable/scripts/live-browser-dom.js +320 -0
  68. package/agents/impeccable/scripts/live-browser-ignores.js +242 -0
  69. package/agents/impeccable/scripts/live-browser-session.js +180 -0
  70. package/agents/impeccable/scripts/live-browser.js +13557 -0
  71. package/agents/impeccable/scripts/modern-screenshot.umd.js +14 -0
  72. package/agents/reversa/SKILL.md +135 -0
  73. package/agents/reversa/agents/openai.yaml +3 -0
  74. package/agents/reversa/references/checkpoint-guide.md +106 -0
  75. package/agents/reversa/references/state-schema.md +80 -0
  76. package/agents/reversa/references/step-01-first-run.md +63 -0
  77. package/agents/reversa/references/step-02-resume.md +88 -0
  78. package/agents/reversa/references/step-03-specs-organization.md +145 -0
  79. package/agents/reversa/references/step-04-regression-check.md +94 -0
  80. package/agents/reversa-add/SKILL.md +131 -0
  81. package/agents/reversa-add/agents/openai.yaml +5 -0
  82. package/agents/reversa-agents-help/SKILL.md +211 -0
  83. package/agents/reversa-agents-help/agents/openai.yaml +3 -0
  84. package/agents/reversa-arbiter/SKILL.md +140 -0
  85. package/agents/reversa-arbiter/agents/openai.yaml +5 -0
  86. package/agents/reversa-archaeologist/SKILL.md +95 -0
  87. package/agents/reversa-archaeologist/agents/openai.yaml +5 -0
  88. package/agents/reversa-archaeologist/references/modules-schema.md +69 -0
  89. package/agents/reversa-architect/SKILL.md +93 -0
  90. package/agents/reversa-architect/agents/openai.yaml +5 -0
  91. package/agents/reversa-arquitetura-3d/SKILL.md +163 -0
  92. package/agents/reversa-arquitetura-3d/agents/openai.yaml +5 -0
  93. package/agents/reversa-arquitetura-3d/references/ARCH_TOUR.md +242 -0
  94. package/agents/reversa-arquitetura-3d/references/CALL_GRAPH_3D.md +217 -0
  95. package/agents/reversa-arquitetura-3d/references/CODE_CITY.md +228 -0
  96. package/agents/reversa-arquitetura-3d/references/DEPENDENCY_GRAPH_3D.md +240 -0
  97. package/agents/reversa-arquitetura-3d/references/ERRORS.md +286 -0
  98. package/agents/reversa-arquitetura-3d/references/LAYER_STACK.md +230 -0
  99. package/agents/reversa-arquitetura-3d/references/THREE_PATTERNS.md +221 -0
  100. package/agents/reversa-audit/SKILL.md +98 -0
  101. package/agents/reversa-audit/agents/openai.yaml +5 -0
  102. package/agents/reversa-autonomous/SKILL.md +139 -0
  103. package/agents/reversa-autonomous/agents/openai.yaml +3 -0
  104. package/agents/reversa-brainstorm/SKILL.md +131 -0
  105. package/agents/reversa-brainstorm/agents/openai.yaml +3 -0
  106. package/agents/reversa-challenger/SKILL.md +122 -0
  107. package/agents/reversa-challenger/agents/openai.yaml +5 -0
  108. package/agents/reversa-clarify/SKILL.md +103 -0
  109. package/agents/reversa-clarify/agents/openai.yaml +5 -0
  110. package/agents/reversa-code-express/SKILL.md +252 -0
  111. package/agents/reversa-code-express/agents/openai.yaml +5 -0
  112. package/agents/reversa-coding/SKILL.md +172 -0
  113. package/agents/reversa-coding/agents/openai.yaml +5 -0
  114. package/agents/reversa-curator/SKILL.md +133 -0
  115. package/agents/reversa-curator/agents/openai.yaml +5 -0
  116. package/agents/reversa-curator/references/decision-rubric.md +52 -0
  117. package/agents/reversa-curator/references/templates/discard_log.md +37 -0
  118. package/agents/reversa-curator/references/templates/target_business_rules.md +54 -0
  119. package/agents/reversa-data-master/SKILL.md +67 -0
  120. package/agents/reversa-data-master/agents/openai.yaml +5 -0
  121. package/agents/reversa-debugger/SKILL.md +178 -0
  122. package/agents/reversa-debugger/agents/openai.yaml +3 -0
  123. package/agents/reversa-debugger/references/bug-schema.md +123 -0
  124. package/agents/reversa-debugger/references/bugs-readme-template.md +76 -0
  125. package/agents/reversa-debugger-debate/SKILL.md +75 -0
  126. package/agents/reversa-debugger-debate/agents/openai.yaml +5 -0
  127. package/agents/reversa-debugger-debate/references/debate-protocol.md +102 -0
  128. package/agents/reversa-debugger-fix/SKILL.md +170 -0
  129. package/agents/reversa-debugger-fix/agents/openai.yaml +5 -0
  130. package/agents/reversa-debugger-graph/SKILL.md +94 -0
  131. package/agents/reversa-debugger-graph/agents/openai.yaml +5 -0
  132. package/agents/reversa-decouple/SKILL.md +78 -0
  133. package/agents/reversa-decouple/agents/openai.yaml +5 -0
  134. package/agents/reversa-depth-inspection/SKILL.md +99 -0
  135. package/agents/reversa-depth-inspection/agents/openai.yaml +5 -0
  136. package/agents/reversa-design-system/SKILL.md +77 -0
  137. package/agents/reversa-design-system/agents/openai.yaml +5 -0
  138. package/agents/reversa-designer/SKILL.md +217 -0
  139. package/agents/reversa-designer/agents/openai.yaml +5 -0
  140. package/agents/reversa-designer/references/paradigm-checklist.md +50 -0
  141. package/agents/reversa-designer/references/templates/data_migration_plan.md +80 -0
  142. package/agents/reversa-designer/references/templates/target_architecture.md +68 -0
  143. package/agents/reversa-designer/references/templates/target_data_model.md +64 -0
  144. package/agents/reversa-designer/references/templates/target_domain_model.md +62 -0
  145. package/agents/reversa-designer/references/templates/topology_decision.md +82 -0
  146. package/agents/reversa-detective/SKILL.md +82 -0
  147. package/agents/reversa-detective/agents/openai.yaml +5 -0
  148. package/agents/reversa-docs/SKILL.md +241 -0
  149. package/agents/reversa-docs/agents/openai.yaml +3 -0
  150. package/agents/reversa-docs/references/config-schema.json +108 -0
  151. package/agents/reversa-docs/references/expected_sources.yaml +60 -0
  152. package/agents/reversa-docs-analyst/SKILL.md +163 -0
  153. package/agents/reversa-docs-analyst/agents/openai.yaml +5 -0
  154. package/agents/reversa-docs-mapper/SKILL.md +167 -0
  155. package/agents/reversa-docs-mapper/agents/openai.yaml +5 -0
  156. package/agents/reversa-docs-mapper/references/extraction-policy.md +44 -0
  157. package/agents/reversa-docs-publisher/SKILL.md +323 -0
  158. package/agents/reversa-docs-publisher/agents/openai.yaml +5 -0
  159. package/agents/reversa-docs-publisher/references/auxiliary_sources.yaml +27 -0
  160. package/agents/reversa-docs-publisher/references/vendor-pins.yaml +149 -0
  161. package/agents/reversa-docs-storyteller/SKILL.md +189 -0
  162. package/agents/reversa-docs-storyteller/agents/openai.yaml +5 -0
  163. package/agents/reversa-drafter/SKILL.md +189 -0
  164. package/agents/reversa-drafter/agents/openai.yaml +5 -0
  165. package/agents/reversa-especialista-d3/SKILL.md +37 -0
  166. package/agents/reversa-especialista-d3/agents/openai.yaml +5 -0
  167. package/agents/reversa-especialista-d3/references/api-core.md +13 -0
  168. package/agents/reversa-especialista-d3/references/interatividade.md +5 -0
  169. package/agents/reversa-especialista-d3/references/layouts-complexos.md +8 -0
  170. package/agents/reversa-explorer/SKILL.md +110 -0
  171. package/agents/reversa-explorer/agents/openai.yaml +5 -0
  172. package/agents/reversa-extract-soul/SKILL.md +221 -0
  173. package/agents/reversa-extract-soul/agents/openai.yaml +5 -0
  174. package/agents/reversa-forward/SKILL.md +235 -0
  175. package/agents/reversa-forward/agents/openai.yaml +3 -0
  176. package/agents/reversa-forward-autonomous/SKILL.md +184 -0
  177. package/agents/reversa-forward-autonomous/agents/openai.yaml +3 -0
  178. package/agents/reversa-framer/SKILL.md +124 -0
  179. package/agents/reversa-framer/agents/openai.yaml +5 -0
  180. package/agents/reversa-highcharts-visualizer/SKILL.md +123 -0
  181. package/agents/reversa-highcharts-visualizer/agents/openai.yaml +5 -0
  182. package/agents/reversa-highcharts-visualizer/references/CHART_CATALOG.md +450 -0
  183. package/agents/reversa-highcharts-visualizer/references/ERRORS.md +99 -0
  184. package/agents/reversa-highcharts-visualizer/references/HIGHCHARTS_PATTERNS.md +347 -0
  185. package/agents/reversa-highcharts-visualizer/scripts/analyze_data.py +219 -0
  186. package/agents/reversa-highcharts-visualizer/scripts/parse_data.py +246 -0
  187. package/agents/reversa-highcharts-visualizer/scripts/sample_data.py +208 -0
  188. package/agents/reversa-ideator/SKILL.md +139 -0
  189. package/agents/reversa-ideator/agents/openai.yaml +5 -0
  190. package/agents/reversa-image-prompt-json/SKILL.md +210 -0
  191. package/agents/reversa-image-prompt-json/agents/openai.yaml +5 -0
  192. package/agents/reversa-image-prompt-json/references/Examples.md +123 -0
  193. package/agents/reversa-inspector/SKILL.md +147 -0
  194. package/agents/reversa-inspector/agents/openai.yaml +5 -0
  195. package/agents/reversa-inspector/references/parity-coverage-matrix.md +54 -0
  196. package/agents/reversa-inspector/references/templates/parity_specs.md +64 -0
  197. package/agents/reversa-inspector/references/templates/parity_test.feature +40 -0
  198. package/agents/reversa-migrate/SKILL.md +282 -0
  199. package/agents/reversa-migrate/agents/openai.yaml +3 -0
  200. package/agents/reversa-migrate/references/auto-defaults.md +52 -0
  201. package/agents/reversa-migrate/references/expected_legacy_artifacts.yaml +69 -0
  202. package/agents/reversa-migrate/references/handoff-checklist.md +34 -0
  203. package/agents/reversa-migrate/references/state.json +28 -0
  204. package/agents/reversa-migrate/references/templates/ambiguity_log.md +43 -0
  205. package/agents/reversa-migrate/references/templates/handoff.md +91 -0
  206. package/agents/reversa-migrate/references/templates/migration_brief.md +52 -0
  207. package/agents/reversa-migrate/references/templates/pending_decisions.md +36 -0
  208. package/agents/reversa-modularize/SKILL.md +77 -0
  209. package/agents/reversa-modularize/agents/openai.yaml +5 -0
  210. package/agents/reversa-n8n/SKILL.md +256 -0
  211. package/agents/reversa-n8n/agents/openai.yaml +5 -0
  212. package/agents/reversa-n8n/references/node-catalog.md +245 -0
  213. package/agents/reversa-new/SKILL.md +328 -0
  214. package/agents/reversa-new/agents/openai.yaml +3 -0
  215. package/agents/reversa-optimize/SKILL.md +80 -0
  216. package/agents/reversa-optimize/agents/openai.yaml +5 -0
  217. package/agents/reversa-paradigm-advisor/SKILL.md +168 -0
  218. package/agents/reversa-paradigm-advisor/agents/openai.yaml +5 -0
  219. package/agents/reversa-paradigm-advisor/references/paradigm-catalog.md +73 -0
  220. package/agents/reversa-paradigm-advisor/references/templates/paradigm_decision.md +69 -0
  221. package/agents/reversa-plan/SKILL.md +92 -0
  222. package/agents/reversa-plan/agents/openai.yaml +5 -0
  223. package/agents/reversa-pre-spec/SKILL.md +133 -0
  224. package/agents/reversa-pre-spec/agents/openai.yaml +5 -0
  225. package/agents/reversa-pricing/SKILL.md +181 -0
  226. package/agents/reversa-pricing/agents/openai.yaml +3 -0
  227. package/agents/reversa-pricing-advisor/SKILL.md +322 -0
  228. package/agents/reversa-pricing-advisor/agents/openai.yaml +5 -0
  229. package/agents/reversa-pricing-advisor/references/advisor-schema.json +196 -0
  230. package/agents/reversa-pricing-advisor/references/advisor-template.md +106 -0
  231. package/agents/reversa-pricing-advisor/references/sale-models.md +237 -0
  232. package/agents/reversa-pricing-estimate/SKILL.md +287 -0
  233. package/agents/reversa-pricing-estimate/agents/openai.yaml +5 -0
  234. package/agents/reversa-pricing-estimate/references/effort-formula.md +146 -0
  235. package/agents/reversa-pricing-estimate/references/estimate-schema.json +141 -0
  236. package/agents/reversa-pricing-estimate/references/estimate-template.md +153 -0
  237. package/agents/reversa-pricing-estimate/references/example-estimate.json +74 -0
  238. package/agents/reversa-pricing-estimate/references/example-estimate.md +88 -0
  239. package/agents/reversa-pricing-estimate/references/market-benchmarks.md +102 -0
  240. package/agents/reversa-pricing-estimate/references/value-formula.md +123 -0
  241. package/agents/reversa-pricing-product/SKILL.md +299 -0
  242. package/agents/reversa-pricing-product/agents/openai.yaml +5 -0
  243. package/agents/reversa-pricing-product/references/breakeven-formula.md +237 -0
  244. package/agents/reversa-pricing-product/references/product-schema.json +288 -0
  245. package/agents/reversa-pricing-product/references/product-template.md +113 -0
  246. package/agents/reversa-pricing-product/references/store-commissions.md +57 -0
  247. package/agents/reversa-pricing-profile/SKILL.md +390 -0
  248. package/agents/reversa-pricing-profile/agents/openai.yaml +5 -0
  249. package/agents/reversa-pricing-profile/references/example-profile.json +23 -0
  250. package/agents/reversa-pricing-profile/references/example-profile.md +46 -0
  251. package/agents/reversa-pricing-profile/references/profile-schema.json +227 -0
  252. package/agents/reversa-pricing-profile/references/tax-regimes.md +106 -0
  253. package/agents/reversa-pricing-research/SKILL.md +352 -0
  254. package/agents/reversa-pricing-research/agents/openai.yaml +5 -0
  255. package/agents/reversa-pricing-research/references/research-policy.md +213 -0
  256. package/agents/reversa-pricing-research/references/research-schema.json +330 -0
  257. package/agents/reversa-pricing-size/SKILL.md +205 -0
  258. package/agents/reversa-pricing-size/agents/openai.yaml +5 -0
  259. package/agents/reversa-pricing-size/references/example-size.json +41 -0
  260. package/agents/reversa-pricing-size/references/size-schema.json +120 -0
  261. package/agents/reversa-pricing-size/references/sizing-formula.md +183 -0
  262. package/agents/reversa-principles/SKILL.md +82 -0
  263. package/agents/reversa-principles/agents/openai.yaml +5 -0
  264. package/agents/reversa-prune/SKILL.md +85 -0
  265. package/agents/reversa-prune/agents/openai.yaml +5 -0
  266. package/agents/reversa-quality/SKILL.md +87 -0
  267. package/agents/reversa-quality/agents/openai.yaml +5 -0
  268. package/agents/reversa-reconstructor/SKILL.md +243 -0
  269. package/agents/reversa-reconstructor/agents/openai.yaml +5 -0
  270. package/agents/reversa-reconstructor/references/reconstruction-plan-migration-template.md +89 -0
  271. package/agents/reversa-reconstructor/references/reconstruction-plan-template.md +77 -0
  272. package/agents/reversa-refactor/SKILL.md +112 -0
  273. package/agents/reversa-refactor/agents/openai.yaml +3 -0
  274. package/agents/reversa-refactor/references/opportunity-schema.md +68 -0
  275. package/agents/reversa-refactor/references/refactor-readme-template.md +35 -0
  276. package/agents/reversa-requirements/SKILL.md +217 -0
  277. package/agents/reversa-requirements/agents/openai.yaml +5 -0
  278. package/agents/reversa-researcher/SKILL.md +136 -0
  279. package/agents/reversa-researcher/agents/openai.yaml +5 -0
  280. package/agents/reversa-restructure/SKILL.md +78 -0
  281. package/agents/reversa-restructure/agents/openai.yaml +5 -0
  282. package/agents/reversa-resume/SKILL.md +141 -0
  283. package/agents/reversa-resume/agents/openai.yaml +5 -0
  284. package/agents/reversa-reviewer/SKILL.md +163 -0
  285. package/agents/reversa-reviewer/agents/openai.yaml +5 -0
  286. package/agents/reversa-reviewer/references/confidence-report-template.md +73 -0
  287. package/agents/reversa-reviewer/references/confidence-rules.md +65 -0
  288. package/agents/reversa-reviewer/references/questions-template.md +74 -0
  289. package/agents/reversa-scout/SKILL.md +82 -0
  290. package/agents/reversa-scout/agents/openai.yaml +5 -0
  291. package/agents/reversa-scout/references/surface-schema.md +93 -0
  292. package/agents/reversa-screen-translator/SKILL.md +279 -0
  293. package/agents/reversa-screen-translator/agents/openai.yaml +5 -0
  294. package/agents/reversa-screen-translator/references/adapter-pairs.md +97 -0
  295. package/agents/reversa-screen-translator/references/platform-detection.md +73 -0
  296. package/agents/reversa-screen-translator/references/templates/golden_manifest.yaml +62 -0
  297. package/agents/reversa-screen-translator/references/templates/inventory.schema.json +132 -0
  298. package/agents/reversa-screen-translator/references/templates/screen_deviation_log.md +66 -0
  299. package/agents/reversa-screen-translator/references/templates/screen_modernization_decision.md +106 -0
  300. package/agents/reversa-screen-translator/references/templates/target_screens.md +206 -0
  301. package/agents/reversa-selo-generativo/SKILL.md +176 -0
  302. package/agents/reversa-selo-generativo/agents/openai.yaml +5 -0
  303. package/agents/reversa-selo-generativo/references/ERRORS.md +212 -0
  304. package/agents/reversa-selo-generativo/references/GENERATIVE_PATTERNS.md +365 -0
  305. package/agents/reversa-selo-generativo/references/PALETTE_BY_STYLE.md +176 -0
  306. package/agents/reversa-simplify/SKILL.md +79 -0
  307. package/agents/reversa-simplify/agents/openai.yaml +5 -0
  308. package/agents/reversa-spec-sdd/SKILL.md +278 -0
  309. package/agents/reversa-spec-sdd/agents/openai.yaml +5 -0
  310. package/agents/reversa-spec-sdd/assets/spec_examples.md +159 -0
  311. package/agents/reversa-spec-sdd/references/evaluation_rubric.md +113 -0
  312. package/agents/reversa-spec-sdd/references/sdd_guide.md +124 -0
  313. package/agents/reversa-spec-sdd/references/spec_template.md +231 -0
  314. package/agents/reversa-spec-sdd/scripts/spec_scorer.py +476 -0
  315. package/agents/reversa-standardize/SKILL.md +76 -0
  316. package/agents/reversa-standardize/agents/openai.yaml +5 -0
  317. package/agents/reversa-strategist/SKILL.md +119 -0
  318. package/agents/reversa-strategist/agents/openai.yaml +5 -0
  319. package/agents/reversa-strategist/references/migration-strategies.md +41 -0
  320. package/agents/reversa-strategist/references/templates/cutover_plan.md +60 -0
  321. package/agents/reversa-strategist/references/templates/migration_strategy.md +55 -0
  322. package/agents/reversa-strategist/references/templates/risk_register.md +44 -0
  323. package/agents/reversa-sync/SKILL.md +100 -0
  324. package/agents/reversa-sync/agents/openai.yaml +5 -0
  325. package/agents/reversa-to-do/SKILL.md +89 -0
  326. package/agents/reversa-to-do/agents/openai.yaml +5 -0
  327. package/agents/reversa-visor/SKILL.md +91 -0
  328. package/agents/reversa-visor/agents/openai.yaml +5 -0
  329. package/agents/reversa-writer/SKILL.md +212 -0
  330. package/agents/reversa-writer/agents/openai.yaml +5 -0
  331. package/agents/reversa-writer/references/design-template.md +49 -0
  332. package/agents/reversa-writer/references/requirements-template.md +62 -0
  333. package/agents/reversa-writer/references/tasks-template.md +39 -0
  334. package/bin/reversa.js +65 -0
  335. package/lib/commands/add-engine.js +97 -0
  336. package/lib/commands/export-diagrams.js +194 -0
  337. package/lib/commands/install.js +260 -0
  338. package/lib/commands/status.js +35 -0
  339. package/lib/commands/uninstall.js +159 -0
  340. package/lib/commands/update.js +252 -0
  341. package/lib/installer/bundled.js +42 -0
  342. package/lib/installer/detector.js +167 -0
  343. package/lib/installer/manifest.js +61 -0
  344. package/lib/installer/orange-prompts.js +13 -0
  345. package/lib/installer/policy.js +53 -0
  346. package/lib/installer/prompts.js +252 -0
  347. package/lib/installer/validator.js +22 -0
  348. package/lib/installer/writer.js +376 -0
  349. package/lib/utils/banner.js +35 -0
  350. package/lib/utils/json-safe.js +10 -0
  351. package/lib/utils/package-info.js +22 -0
  352. package/package.json +51 -4
  353. package/templates/config.toml +46 -0
  354. package/templates/config.user.toml +8 -0
  355. package/templates/documentation/assets/css/style.css +476 -0
  356. package/templates/documentation/assets/js/nav.js +141 -0
  357. package/templates/documentation/assets/js/sidebar.js +162 -0
  358. package/templates/documentation/demo/viewer-demo.html +200 -0
  359. package/templates/documentation/pages/arquitetura.html.tpl +36 -0
  360. package/templates/documentation/pages/deck.html.tpl +27 -0
  361. package/templates/documentation/pages/features/feature.html.tpl +44 -0
  362. package/templates/documentation/pages/glossario.html.tpl +30 -0
  363. package/templates/documentation/pages/index.html.tpl +32 -0
  364. package/templates/documentation/pages/metricas.html.tpl +43 -0
  365. package/templates/documentation/pages/modulos.html.tpl +33 -0
  366. package/templates/documentation/pages/timeline.html.tpl +33 -0
  367. package/templates/documentation/pages/topologia.html.tpl +31 -0
  368. package/templates/documentation/scripts/convert_chronicle.py +71 -0
  369. package/templates/documentation/scripts/convert_soul.py +73 -0
  370. package/templates/documentation/scripts/extract_deps.py +54 -0
  371. package/templates/documentation/scripts/extract_modules.py +90 -0
  372. package/templates/documentation/scripts/list_specs.py +74 -0
  373. package/templates/documentation/viewer.html +60 -0
  374. package/templates/engines/AGENTS.md +26 -0
  375. package/templates/engines/CLAUDE.md +27 -0
  376. package/templates/engines/CONVENTIONS.md +26 -0
  377. package/templates/engines/GEMINI.md +26 -0
  378. package/templates/engines/amazonq +7 -0
  379. package/templates/engines/clinerules +7 -0
  380. package/templates/engines/copilot-instructions +26 -0
  381. package/templates/engines/cursorrules +7 -0
  382. package/templates/engines/roorules +7 -0
  383. package/templates/engines/windsurf +7 -0
  384. package/templates/forward/body/actions-template.md +83 -0
  385. package/templates/forward/body/principles-template.md +75 -0
  386. package/templates/forward/body/quality-template.md +103 -0
  387. package/templates/forward/body/requirements-template.md +121 -0
  388. package/templates/forward/body/roadmap-template.md +107 -0
  389. package/templates/forward/hooks.yml +60 -0
  390. package/templates/forward/scripts/ps/bind-to-extraction.ps1 +71 -0
  391. package/templates/forward/scripts/ps/prepare-roadmap.ps1 +84 -0
  392. package/templates/forward/scripts/ps/verify-prerequisites.ps1 +103 -0
  393. package/templates/forward/scripts/sh/bind-to-extraction.sh +103 -0
  394. package/templates/forward/scripts/sh/prepare-roadmap.sh +79 -0
  395. package/templates/forward/scripts/sh/verify-prerequisites.sh +125 -0
  396. package/templates/forward/setup.json +24 -0
  397. package/templates/hooks/README.md +41 -0
  398. package/templates/hooks/check-legacy-policy.mjs +0 -0
  399. package/templates/migration/artifacts/ambiguity_log.md +43 -0
  400. package/templates/migration/artifacts/cutover_plan.md +60 -0
  401. package/templates/migration/artifacts/data_migration_plan.md +80 -0
  402. package/templates/migration/artifacts/discard_log.md +37 -0
  403. package/templates/migration/artifacts/handoff.md +76 -0
  404. package/templates/migration/artifacts/migration_brief.md +52 -0
  405. package/templates/migration/artifacts/migration_strategy.md +55 -0
  406. package/templates/migration/artifacts/paradigm_decision.md +69 -0
  407. package/templates/migration/artifacts/parity_specs.md +64 -0
  408. package/templates/migration/artifacts/parity_test.feature +40 -0
  409. package/templates/migration/artifacts/pending_decisions.md +36 -0
  410. package/templates/migration/artifacts/risk_register.md +44 -0
  411. package/templates/migration/artifacts/target_architecture.md +68 -0
  412. package/templates/migration/artifacts/target_business_rules.md +54 -0
  413. package/templates/migration/artifacts/target_data_model.md +64 -0
  414. package/templates/migration/artifacts/target_domain_model.md +62 -0
  415. package/templates/migration/catalogs/migration_strategies.md +101 -0
  416. package/templates/migration/catalogs/paradigm_catalog.md +101 -0
  417. package/templates/migration/expected_legacy_artifacts.yaml +77 -0
  418. package/templates/migration/state.json +28 -0
  419. package/templates/plan.md +65 -0
  420. package/templates/reversa-config.json +5 -0
  421. package/templates/state.json +18 -0
@@ -0,0 +1,240 @@
1
+ # Dependency Graph 3D
2
+
3
+ Grafo orientado de dependências entre módulos visualizado em 3D, com simulação de forças (atração entre nós conectados, repulsão entre não conectados) que distribui o grafo no espaço de forma orgânica.
4
+
5
+ ## Mapeamento
6
+
7
+ | Atributo do código | Atributo visual do nó |
8
+ |---|---|
9
+ | Módulo | Esfera ou ícone |
10
+ | Tamanho (LOC ou número de dependentes) | Raio da esfera |
11
+ | Tipo do módulo | Cor |
12
+ | Pasta | Cor secundária ou cluster próximo |
13
+ | Aresta = `imports/requires` | Linha curva orientada (com seta) |
14
+ | Peso da aresta (frequência de uso) | Espessura da linha |
15
+
16
+ ## Quando usar
17
+
18
+ - Detectar **acoplamento alto** (nós muito conectados ficam no centro do cluster).
19
+ - Identificar **módulos centrais** (alto fan-in) e **módulos isolados**.
20
+ - Visualizar **ciclos de dependência** (loops visíveis na simulação).
21
+ - Comparar coesão entre pastas (módulos da mesma pasta deveriam estar próximos).
22
+
23
+ **Quando evitar**: projetos com mais de ~300 módulos, onde o grafo vira hairball ilegível. Use Code City ou agrupe por pasta.
24
+
25
+ ## Algoritmo de layout: força em 3D
26
+
27
+ Simulação tipo D3-force adaptada para 3 dimensões. Roda em loop até estabilizar, depois congela.
28
+
29
+ ```javascript
30
+ const nodes = deps.nodes.map((n) => ({
31
+ id: n.id,
32
+ x: (Math.random() - 0.5) * 200,
33
+ y: (Math.random() - 0.5) * 200,
34
+ z: (Math.random() - 0.5) * 200,
35
+ vx: 0, vy: 0, vz: 0,
36
+ fx: 0, fy: 0, fz: 0,
37
+ mass: 1 + (n.loc ?? 0) / 100
38
+ }));
39
+
40
+ const edges = deps.edges.map((e) => ({
41
+ source: nodes.find((n) => n.id === e.from),
42
+ target: nodes.find((n) => n.id === e.to),
43
+ weight: e.weight ?? 1
44
+ }));
45
+
46
+ const REPULSION = 800;
47
+ const ATTRACTION = 0.04;
48
+ const CENTER_GRAVITY = 0.002;
49
+ const DAMPING = 0.85;
50
+
51
+ function simulationStep() {
52
+ nodes.forEach((n) => { n.fx = 0; n.fy = 0; n.fz = 0; });
53
+
54
+ // Repulsão entre todos os pares
55
+ for (let i = 0; i < nodes.length; i++) {
56
+ for (let j = i + 1; j < nodes.length; j++) {
57
+ const a = nodes[i], b = nodes[j];
58
+ const dx = b.x - a.x, dy = b.y - a.y, dz = b.z - a.z;
59
+ const distSq = dx * dx + dy * dy + dz * dz + 0.1;
60
+ const dist = Math.sqrt(distSq);
61
+ const force = REPULSION / distSq;
62
+ const fx = (dx / dist) * force;
63
+ const fy = (dy / dist) * force;
64
+ const fz = (dz / dist) * force;
65
+ a.fx -= fx; a.fy -= fy; a.fz -= fz;
66
+ b.fx += fx; b.fy += fy; b.fz += fz;
67
+ }
68
+ }
69
+
70
+ // Atração ao longo das arestas
71
+ edges.forEach((e) => {
72
+ const dx = e.target.x - e.source.x;
73
+ const dy = e.target.y - e.source.y;
74
+ const dz = e.target.z - e.source.z;
75
+ const f = ATTRACTION * e.weight;
76
+ e.source.fx += dx * f; e.source.fy += dy * f; e.source.fz += dz * f;
77
+ e.target.fx -= dx * f; e.target.fy -= dy * f; e.target.fz -= dz * f;
78
+ });
79
+
80
+ // Gravidade para o centro
81
+ nodes.forEach((n) => {
82
+ n.fx -= n.x * CENTER_GRAVITY;
83
+ n.fy -= n.y * CENTER_GRAVITY;
84
+ n.fz -= n.z * CENTER_GRAVITY;
85
+ });
86
+
87
+ // Integrar
88
+ nodes.forEach((n) => {
89
+ n.vx = (n.vx + n.fx / n.mass) * DAMPING;
90
+ n.vy = (n.vy + n.fy / n.mass) * DAMPING;
91
+ n.vz = (n.vz + n.fz / n.mass) * DAMPING;
92
+ n.x += n.vx;
93
+ n.y += n.vy;
94
+ n.z += n.vz;
95
+ });
96
+ }
97
+ ```
98
+
99
+ Para grafos grandes (>200 nós), substituir repulsão O(n²) por **octree (Barnes-Hut)** para reduzir a O(n log n).
100
+
101
+ ## Renderização dos nós
102
+
103
+ Usar `InstancedMesh` de esferas para até 1.000 nós; acima disso, billboard com sprites.
104
+
105
+ ```javascript
106
+ const sphereGeo = new THREE.SphereGeometry(1, 16, 16);
107
+ const sphereMat = new THREE.MeshStandardMaterial({ roughness: 0.4 });
108
+ const nodeMesh = new THREE.InstancedMesh(sphereGeo, sphereMat, nodes.length);
109
+ nodeMesh.castShadow = true;
110
+
111
+ const dummy = new THREE.Object3D();
112
+ const color = new THREE.Color();
113
+
114
+ function updateNodes() {
115
+ nodes.forEach((n, i) => {
116
+ dummy.position.set(n.x, n.y, n.z);
117
+ const radius = 1 + Math.sqrt(n.mass) * 0.5;
118
+ dummy.scale.set(radius, radius, radius);
119
+ dummy.updateMatrix();
120
+ nodeMesh.setMatrixAt(i, dummy.matrix);
121
+ color.set(colorForNode(n));
122
+ nodeMesh.setColorAt(i, color);
123
+ });
124
+ nodeMesh.instanceMatrix.needsUpdate = true;
125
+ nodeMesh.instanceColor.needsUpdate = true;
126
+ }
127
+ ```
128
+
129
+ ## Renderização das arestas
130
+
131
+ Linhas curvas em 3D usando `BufferGeometry` com `LineSegments` ou `TubeGeometry` para arestas com volume.
132
+
133
+ ```javascript
134
+ const edgePositions = new Float32Array(edges.length * 6);
135
+ const edgeGeo = new THREE.BufferGeometry();
136
+ edgeGeo.setAttribute("position", new THREE.BufferAttribute(edgePositions, 3));
137
+ const edgeMat = new THREE.LineBasicMaterial({ color: 0x4a9eff, transparent: true, opacity: 0.4 });
138
+ const edgeLines = new THREE.LineSegments(edgeGeo, edgeMat);
139
+ scene.add(edgeLines);
140
+
141
+ function updateEdges() {
142
+ edges.forEach((e, i) => {
143
+ edgePositions[i * 6 + 0] = e.source.x;
144
+ edgePositions[i * 6 + 1] = e.source.y;
145
+ edgePositions[i * 6 + 2] = e.source.z;
146
+ edgePositions[i * 6 + 3] = e.target.x;
147
+ edgePositions[i * 6 + 4] = e.target.y;
148
+ edgePositions[i * 6 + 5] = e.target.z;
149
+ });
150
+ edgeGeo.attributes.position.needsUpdate = true;
151
+ }
152
+ ```
153
+
154
+ Para arestas orientadas com seta visível, usar `ArrowHelper` ou pequenos cones próximos ao target.
155
+
156
+ ## Loop de simulação + renderização
157
+
158
+ ```javascript
159
+ let frame = 0;
160
+ const MAX_SIM_FRAMES = 400; // estabiliza após ~7s em 60fps
161
+ function tick() {
162
+ if (frame < MAX_SIM_FRAMES) {
163
+ simulationStep();
164
+ updateNodes();
165
+ updateEdges();
166
+ frame++;
167
+ }
168
+ controls.update();
169
+ renderer.render(scene, camera);
170
+ requestAnimationFrame(tick);
171
+ }
172
+ ```
173
+
174
+ Depois de estabilizar, manter renderização mas pausar simulação para economizar CPU.
175
+
176
+ ## Detecção de ciclos
177
+
178
+ Rodar Tarjan ou Kosaraju antes de renderizar; nós que pertencem a ciclos recebem cor especial (laranja) e suas arestas viram vermelhas.
179
+
180
+ ```javascript
181
+ const cycles = findStronglyConnectedComponents(nodes, edges).filter((c) => c.length > 1);
182
+ cycles.flat().forEach((n) => n.inCycle = true);
183
+ edges.forEach((e) => {
184
+ e.inCycle = e.source.inCycle && e.target.inCycle;
185
+ });
186
+ ```
187
+
188
+ ## Sidebar de controles
189
+
190
+ ```html
191
+ <aside id="sidebar">
192
+ <h3>Dependency Graph 3D</h3>
193
+
194
+ <label>Repulsão
195
+ <input type="range" min="100" max="2000" value="800" data-param="repulsion">
196
+ </label>
197
+
198
+ <label>Atração
199
+ <input type="range" min="0.01" max="0.2" step="0.01" value="0.04" data-param="attraction">
200
+ </label>
201
+
202
+ <label>Filtrar por pasta
203
+ <select data-param="folderFilter">
204
+ <option value="all">Todas</option>
205
+ </select>
206
+ </label>
207
+
208
+ <label>
209
+ <input type="checkbox" data-param="highlightCycles" checked> Destacar ciclos
210
+ </label>
211
+
212
+ <label>
213
+ <input type="checkbox" data-param="showLabels"> Labels visíveis
214
+ </label>
215
+
216
+ <button id="reset">Reset</button>
217
+ <button id="freeze">Congelar simulação</button>
218
+ <button id="export-png">Exportar PNG</button>
219
+ </aside>
220
+ ```
221
+
222
+ Mudanças nos sliders reativam a simulação por mais 100 frames antes de congelar novamente.
223
+
224
+ ## Interação
225
+
226
+ - **Hover em nó**: tooltip com nome, número de dependentes (fan-in), dependências (fan-out).
227
+ - **Clique em nó**: destaca o nó e suas arestas conectadas, desfoca os demais (opacity reduzida).
228
+ - **Duplo clique em nó**: foca câmera no nó.
229
+ - **Scroll**: zoom.
230
+
231
+ ## Performance
232
+
233
+ | Nós | Estratégia |
234
+ |---|---|
235
+ | < 50 | Esferas individuais com `add()` |
236
+ | 50 a 500 | InstancedMesh + repulsão O(n²) |
237
+ | 500 a 2.000 | InstancedMesh + Barnes-Hut octree |
238
+ | > 2.000 | Agrupar por pasta antes (cada cluster = um meta-nó) |
239
+
240
+ Arestas: até **10.000** com LineSegments. Acima disso, simplificar (mostrar só as top N por peso) ou usar gradient de cor em vez de duplicar geometria.
@@ -0,0 +1,286 @@
1
+ # Cenários de Erro e Tratamento
2
+
3
+ Catálogo de erros comuns na skill `arquitetura-3d` e como tratá-los para preservar a experiência do usuário.
4
+
5
+ ---
6
+
7
+ ## ERR-01: Three.js indisponível (CDN inacessível)
8
+
9
+ **Causa**: usuário está offline na primeira execução, ou CDN bloqueado por firewall corporativo.
10
+
11
+ **Detecção**: o script `<script type="module">` falha ao importar, ou `THREE` fica `undefined` após o carregamento.
12
+
13
+ **Tratamento**:
14
+
15
+ ```javascript
16
+ try {
17
+ const mod = await import("https://cdn.jsdelivr.net/npm/three@0.158.0/build/three.module.js");
18
+ window.THREE = mod;
19
+ } catch (e) {
20
+ document.getElementById("loader").innerHTML = `
21
+ <div class="error-panel">
22
+ <h2>Não foi possível carregar a biblioteca 3D</h2>
23
+ <p>Esta visualização requer acesso à internet para baixar o Three.js uma vez.
24
+ Conecte-se à internet e recarregue a página.</p>
25
+ <p>Detalhe técnico: ${e.message}</p>
26
+ </div>`;
27
+ return;
28
+ }
29
+ ```
30
+
31
+ Texto sempre em pt-br, sem travessão.
32
+
33
+ ---
34
+
35
+ ## ERR-02: WebGL não suportado
36
+
37
+ **Causa**: browser sem WebGL (raríssimo hoje, mas possível em VMs antigas ou ambientes corporativos restritos).
38
+
39
+ **Detecção**: `new THREE.WebGLRenderer()` lança exceção ou retorna `null`.
40
+
41
+ **Tratamento**:
42
+
43
+ ```javascript
44
+ let renderer;
45
+ try {
46
+ renderer = new THREE.WebGLRenderer({ antialias: true });
47
+ } catch (e) {
48
+ showFallback("WebGL não está disponível no seu browser. Use Chrome, Firefox ou Edge atualizados.");
49
+ return;
50
+ }
51
+ ```
52
+
53
+ Fallback exibe uma versão estática da cena (screenshot pré-renderizado se houver, ou ASCII art simbólico) com mensagem clara.
54
+
55
+ ---
56
+
57
+ ## ERR-03: JSON malformado
58
+
59
+ **Causa**: `modules.json` ou `deps.json` com sintaxe inválida, ou campos esperados ausentes.
60
+
61
+ **Detecção**: `JSON.parse` falha, ou validação de schema indica campos ausentes.
62
+
63
+ **Tratamento**:
64
+
65
+ ```javascript
66
+ function loadData() {
67
+ const raw = document.getElementById("data").textContent;
68
+ let data;
69
+ try {
70
+ data = JSON.parse(raw);
71
+ } catch (e) {
72
+ showError("Dados de entrada inválidos: arquivo JSON malformado. " + e.message);
73
+ return null;
74
+ }
75
+
76
+ if (!Array.isArray(data.modules)) {
77
+ showError("Dados de entrada inválidos: 'modules' deve ser uma lista.");
78
+ return null;
79
+ }
80
+
81
+ data.modules = data.modules.filter((m) => {
82
+ if (!m.name) {
83
+ console.warn("Módulo sem 'name' descartado:", m);
84
+ return false;
85
+ }
86
+ return true;
87
+ });
88
+
89
+ return data;
90
+ }
91
+ ```
92
+
93
+ Erros não-fatais (módulo individual ruim) descartam o item com aviso. Erros fatais (estrutura raiz inválida) mostram mensagem clara.
94
+
95
+ ---
96
+
97
+ ## ERR-04: Projeto vazio ou sem dados visualizáveis
98
+
99
+ **Causa**: `modules.json` tem 0 itens, ou `deps.json` tem 0 arestas, ou ambos.
100
+
101
+ **Detecção**: após `loadData()`, contagem dos itens.
102
+
103
+ **Tratamento**:
104
+
105
+ ```javascript
106
+ if (data.modules.length === 0) {
107
+ showEmptyState({
108
+ title: "Nada para visualizar ainda",
109
+ message: "O projeto não tem módulos detectados. Rode `/reversa` para extrair a estrutura primeiro.",
110
+ actions: [
111
+ { label: "Voltar à documentação", href: "index.html" }
112
+ ]
113
+ });
114
+ return;
115
+ }
116
+ ```
117
+
118
+ Empty state amigável, nunca cena vazia silenciosa.
119
+
120
+ ---
121
+
122
+ ## ERR-05: Projeto muito grande (>5.000 módulos sem agrupamento)
123
+
124
+ **Causa**: o usuário força modo Code City sem agrupamento em um projeto enorme.
125
+
126
+ **Detecção**: `data.modules.length > 5000` e nenhuma estratégia de agrupamento ativada.
127
+
128
+ **Tratamento**: aplicar agrupamento automaticamente e avisar.
129
+
130
+ ```javascript
131
+ if (data.modules.length > 5000) {
132
+ showToast("Projeto grande detectado (" + data.modules.length + " arquivos). Agrupando por pasta para manter performance.");
133
+ data.modules = groupByFolder(data.modules);
134
+ config.grouped = true;
135
+ }
136
+ ```
137
+
138
+ O agrupamento e seu impacto aparecem no rodapé permanente da página: "Visualização agrupada por pasta. Cada bloco representa N arquivos."
139
+
140
+ ---
141
+
142
+ ## ERR-06: Performance degradada (fps < 30)
143
+
144
+ **Causa**: hardware fraco, projeto no limite superior, sombras pesadas.
145
+
146
+ **Detecção**: medir `requestAnimationFrame` delta.
147
+
148
+ ```javascript
149
+ let frameTimes = [];
150
+ function measureFps(time) {
151
+ frameTimes.push(time);
152
+ if (frameTimes.length > 60) frameTimes.shift();
153
+ if (frameTimes.length === 60) {
154
+ const fps = 1000 / ((frameTimes[59] - frameTimes[0]) / 59);
155
+ if (fps < 30 && !config.degraded) {
156
+ degradeQuality();
157
+ }
158
+ }
159
+ }
160
+ ```
161
+
162
+ **Tratamento progressivo** (`degradeQuality`):
163
+
164
+ 1. Desativar sombras.
165
+ 2. Reduzir pixelRatio para 1.
166
+ 3. Reduzir contagem de partículas em tours.
167
+ 4. Mostrar toast "Modo de performance ativado".
168
+
169
+ ---
170
+
171
+ ## ERR-07: InstancedMesh limit excedido
172
+
173
+ **Causa**: tentativa de criar InstancedMesh com mais instâncias do que o hardware suporta (limite de ~65k em hardwares antigos via Uint16, mas raro).
174
+
175
+ **Detecção**: console error do Three.js após `setMatrixAt` para índices altos.
176
+
177
+ **Tratamento**:
178
+
179
+ ```javascript
180
+ const MAX_INSTANCES = 32768;
181
+ if (modules.length > MAX_INSTANCES) {
182
+ showWarning("Limite de instâncias excedido. Mostrando apenas os " + MAX_INSTANCES + " maiores.");
183
+ modules = modules.sort((a, b) => b.loc - a.loc).slice(0, MAX_INSTANCES);
184
+ }
185
+ ```
186
+
187
+ ---
188
+
189
+ ## ERR-08: Ciclo de dependências infinito durante layout
190
+
191
+ **Causa**: grafo com ciclo fechado e layout iterativo sem critério de parada.
192
+
193
+ **Detecção**: medir iterações de simulação; se passar `MAX_SIM_FRAMES` sem convergir, abortar.
194
+
195
+ **Tratamento**: parar simulação no frame limite, mostrar aviso "Layout não convergiu, posições podem não refletir estabilidade ideal", desenhar mesmo assim.
196
+
197
+ ---
198
+
199
+ ## ERR-09: WebGL context lost
200
+
201
+ **Causa**: aba inativa por muito tempo, troca de driver gráfico, GPU sobrecarregada.
202
+
203
+ **Detecção**: evento `webglcontextlost` no canvas.
204
+
205
+ **Tratamento**:
206
+
207
+ ```javascript
208
+ renderer.domElement.addEventListener("webglcontextlost", (e) => {
209
+ e.preventDefault();
210
+ showToast("Contexto 3D foi perdido. Tentando recuperar...");
211
+ });
212
+
213
+ renderer.domElement.addEventListener("webglcontextrestored", () => {
214
+ rebuildScene();
215
+ showToast("Contexto recuperado.");
216
+ });
217
+ ```
218
+
219
+ Em vez de recarregar a página, reconstruir a cena no mesmo canvas. Importante chamar `rebuildScene()` que recria texturas e buffers.
220
+
221
+ ---
222
+
223
+ ## ERR-10: Sidebar localStorage corrompido
224
+
225
+ **Causa**: dados antigos de localStorage com formato incompatível após atualização da skill.
226
+
227
+ **Detecção**: `JSON.parse` falha ao restaurar estado, ou valor está fora do range esperado de um slider.
228
+
229
+ **Tratamento**: silencioso, descarta e usa default.
230
+
231
+ ```javascript
232
+ function loadSliderState(slider) {
233
+ try {
234
+ const saved = localStorage.getItem(`arq3d.${slider.dataset.param}`);
235
+ if (saved !== null) {
236
+ const value = parseFloat(saved);
237
+ if (value >= slider.min && value <= slider.max) {
238
+ slider.value = value;
239
+ }
240
+ }
241
+ } catch (e) {
242
+ // ignora e mantém valor padrão
243
+ }
244
+ }
245
+ ```
246
+
247
+ ---
248
+
249
+ ## Função utilitária: showError + showWarning + showToast
250
+
251
+ ```javascript
252
+ function showError(message) {
253
+ const panel = document.createElement("div");
254
+ panel.className = "reversa-error-panel";
255
+ panel.innerHTML = `<h2>Erro</h2><p>${escapeHtml(message)}</p>`;
256
+ document.body.appendChild(panel);
257
+ }
258
+
259
+ function showWarning(message) {
260
+ const panel = document.createElement("div");
261
+ panel.className = "reversa-warning-banner";
262
+ panel.textContent = message;
263
+ document.body.appendChild(panel);
264
+ setTimeout(() => panel.remove(), 8000);
265
+ }
266
+
267
+ function showToast(message) {
268
+ const t = document.createElement("div");
269
+ t.className = "reversa-toast";
270
+ t.textContent = message;
271
+ document.body.appendChild(t);
272
+ setTimeout(() => t.remove(), 4000);
273
+ }
274
+
275
+ function escapeHtml(s) {
276
+ return s.replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" }[c]));
277
+ }
278
+ ```
279
+
280
+ Estilos `reversa-error-panel`, `reversa-warning-banner`, `reversa-toast` ficam no CSS compartilhado do mini-site.
281
+
282
+ ---
283
+
284
+ ## Princípio geral
285
+
286
+ Nenhum erro deve resultar em **tela branca silenciosa**. Sempre mostrar mensagem clara em pt-br com instrução acionável ou indicação clara de limitação. Mensagens curtas, sem jargão de framework, sem travessão.