@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,242 @@
1
+ # Architecture Tour
2
+
3
+ Câmera animada percorrendo a cena em ritmo cinematográfico, com **overlay narrativo** sincronizado. Funciona como um "trailer" do sistema: alguém aperta play e o vídeo se desenrola sozinho, parando em pontos-chave com legendas explicativas.
4
+
5
+ ## Conceito
6
+
7
+ Tour não é um modo isolado, é uma **camada animada** que se sobrepõe a qualquer dos outros modos (Code City, Dependency Graph 3D, Layer Stack, Call Graph). A skill recebe uma sequência de waypoints e narrações, e a câmera viaja entre eles.
8
+
9
+ ## Quando usar
10
+
11
+ - Apresentações para stakeholders não-técnicos.
12
+ - Onboarding de novos devs ("aperte play e veja como o sistema é").
13
+ - Demonstração executiva curta (1 a 3 minutos).
14
+ - Acompanhamento da `deck.html` do mini-site.
15
+
16
+ ## Modelo de dados: a coreografia
17
+
18
+ ```json
19
+ {
20
+ "baseMode": "code-city",
21
+ "duration": 90,
22
+ "waypoints": [
23
+ {
24
+ "at": 0,
25
+ "camera": { "position": [200, 250, 400], "target": [0, 0, 0] },
26
+ "overlay": "Esse é o sistema de pagamentos visto de cima."
27
+ },
28
+ {
29
+ "at": 12,
30
+ "camera": { "position": [50, 30, 80], "target": [40, 0, 20] },
31
+ "overlay": "O distrito mais alto, src/payments, concentra 40% do código."
32
+ },
33
+ {
34
+ "at": 24,
35
+ "camera": { "position": [80, 60, 60], "target": [60, 20, 30] },
36
+ "highlight": ["src/payments/charge.ts", "src/payments/refund.ts"],
37
+ "overlay": "Charge e refund são os arquivos centrais."
38
+ },
39
+ {
40
+ "at": 40,
41
+ "camera": { "position": [-100, 80, 200], "target": [-50, 0, 0] },
42
+ "switchMode": "dependency-graph",
43
+ "overlay": "Agora vamos olhar as dependências dele."
44
+ }
45
+ ]
46
+ }
47
+ ```
48
+
49
+ - `at`: segundo da timeline em que o waypoint dispara.
50
+ - `camera`: posição e alvo da câmera ao chegar.
51
+ - `highlight`: lista de IDs de nó/módulo para destacar (outros desfocam).
52
+ - `overlay`: texto da legenda, em pt-br.
53
+ - `switchMode` (opcional): troca o modo base no meio do tour, com transição.
54
+
55
+ ## Algoritmo de interpolação
56
+
57
+ Entre dois waypoints, a câmera interpola posição e alvo com easing.
58
+
59
+ ```javascript
60
+ import { CatmullRomCurve3 } from "https://cdn.jsdelivr.net/npm/three@0.158.0/build/three.module.js";
61
+
62
+ const positions = waypoints.map((w) => new THREE.Vector3(...w.camera.position));
63
+ const targets = waypoints.map((w) => new THREE.Vector3(...w.camera.target));
64
+ const positionCurve = new CatmullRomCurve3(positions);
65
+ const targetCurve = new CatmullRomCurve3(targets);
66
+
67
+ let startTime = null;
68
+ function playTour() {
69
+ startTime = performance.now();
70
+ controls.enabled = false; // desligar interação manual
71
+ animateTour();
72
+ }
73
+
74
+ function animateTour() {
75
+ const now = performance.now();
76
+ const elapsed = (now - startTime) / 1000;
77
+
78
+ if (elapsed >= tour.duration) {
79
+ finishTour();
80
+ return;
81
+ }
82
+
83
+ const t = elapsed / tour.duration; // 0..1
84
+ const pos = positionCurve.getPoint(t);
85
+ const tgt = targetCurve.getPoint(t);
86
+ camera.position.copy(pos);
87
+ camera.lookAt(tgt);
88
+
89
+ updateOverlay(elapsed);
90
+ updateHighlights(elapsed);
91
+
92
+ renderer.render(scene, camera);
93
+ requestAnimationFrame(animateTour);
94
+ }
95
+ ```
96
+
97
+ ## Overlay narrativo
98
+
99
+ Caixa de texto posicionada em rodapé ou lateral, com transições suaves entre falas.
100
+
101
+ ```html
102
+ <div id="tour-overlay">
103
+ <p id="tour-text"></p>
104
+ <div id="tour-progress"><div id="tour-progress-fill"></div></div>
105
+ <div id="tour-controls">
106
+ <button id="tour-pause">Pausar</button>
107
+ <button id="tour-restart">Reiniciar</button>
108
+ <button id="tour-skip">Pular</button>
109
+ </div>
110
+ </div>
111
+ ```
112
+
113
+ ```javascript
114
+ function updateOverlay(elapsed) {
115
+ const current = waypoints.findLast((w) => w.at <= elapsed);
116
+ if (!current) return;
117
+ const textEl = document.getElementById("tour-text");
118
+ if (textEl.dataset.at !== String(current.at)) {
119
+ textEl.dataset.at = current.at;
120
+ textEl.style.opacity = 0;
121
+ setTimeout(() => {
122
+ textEl.textContent = current.overlay;
123
+ textEl.style.opacity = 1;
124
+ }, 300);
125
+ }
126
+ const progress = (elapsed / tour.duration) * 100;
127
+ document.getElementById("tour-progress-fill").style.width = progress + "%";
128
+ }
129
+ ```
130
+
131
+ ## Destaque de elementos
132
+
133
+ Durante highlights, os módulos selecionados ganham emissive e os demais reduzem opacidade.
134
+
135
+ ```javascript
136
+ function updateHighlights(elapsed) {
137
+ const current = waypoints.findLast((w) => w.at <= elapsed);
138
+ const highlightIds = new Set(current?.highlight ?? []);
139
+
140
+ modules.forEach((m, i) => {
141
+ const isHighlighted = highlightIds.size === 0 || highlightIds.has(m.name);
142
+ const targetOpacity = isHighlighted ? 1.0 : 0.15;
143
+ // animar opacity via InstancedMesh é mais trabalhoso;
144
+ // alternativa: trocar cor para uma versão dessaturada quando opacity baixa
145
+ const baseColor = colorForModule(m);
146
+ const finalColor = isHighlighted ? baseColor : dim(baseColor, 0.3);
147
+ instanced.setColorAt(i, new THREE.Color(finalColor));
148
+ });
149
+ instanced.instanceColor.needsUpdate = true;
150
+ }
151
+
152
+ function dim(hex, factor) {
153
+ const c = new THREE.Color(hex);
154
+ c.r *= factor; c.g *= factor; c.b *= factor;
155
+ return c.getHex();
156
+ }
157
+ ```
158
+
159
+ ## Mudança de modo no meio do tour
160
+
161
+ Quando um waypoint tem `switchMode`, fazer fade-out da cena atual, dispose, criar a nova cena, fade-in.
162
+
163
+ ```javascript
164
+ function switchSceneMode(newMode) {
165
+ fadeOverlay.style.opacity = 1;
166
+ setTimeout(() => {
167
+ clearScene();
168
+ if (newMode === "dependency-graph") buildDependencyGraph();
169
+ else if (newMode === "code-city") buildCodeCity();
170
+ // etc
171
+ fadeOverlay.style.opacity = 0;
172
+ }, 600);
173
+ }
174
+ ```
175
+
176
+ ## Controles do tour
177
+
178
+ - **Pause**: para `requestAnimationFrame`, congela tempo.
179
+ - **Restart**: volta `startTime` para agora.
180
+ - **Skip**: pula para o próximo waypoint.
181
+ - **Manual takeover**: se usuário arrastar mouse na cena, interrompe tour e habilita OrbitControls.
182
+
183
+ ```javascript
184
+ renderer.domElement.addEventListener("pointerdown", () => {
185
+ if (tourPlaying) {
186
+ pauseTour();
187
+ controls.enabled = true;
188
+ showResumeButton();
189
+ }
190
+ });
191
+ ```
192
+
193
+ ## Trilha sonora opcional
194
+
195
+ Tour pode incluir música ambient sutil via `<audio>` embutido em base64 (curto, ~30s em loop) ou via Web Audio API gerando drones procedurais. Default: sem áudio.
196
+
197
+ ## Geração da coreografia
198
+
199
+ A skill recebe waypoints prontos OU gera automaticamente a partir de heurísticas:
200
+
201
+ - Iniciar de cima olhando o centro.
202
+ - Mergulhar nos 3 maiores prédios (Code City).
203
+ - Voar pelo grafo de dependências destacando o nó mais central.
204
+ - Terminar mostrando a layer stack das camadas violadoras (se houver).
205
+
206
+ Cada heurística pode ser ativada ou desativada via parâmetro.
207
+
208
+ ## Sidebar do tour
209
+
210
+ ```html
211
+ <aside id="sidebar">
212
+ <h3>Architecture Tour</h3>
213
+
214
+ <label>Duração total
215
+ <input type="range" min="30" max="300" value="90" data-param="duration"> s
216
+ </label>
217
+
218
+ <label>Modo base
219
+ <select data-param="baseMode">
220
+ <option value="code-city">Code City</option>
221
+ <option value="dependency-graph">Dependency Graph</option>
222
+ <option value="layer-stack">Layer Stack</option>
223
+ </select>
224
+ </label>
225
+
226
+ <label>
227
+ <input type="checkbox" data-param="autoPlay"> Tocar ao abrir
228
+ </label>
229
+
230
+ <label>
231
+ <input type="checkbox" data-param="includeViolationsScene" checked> Incluir cena de violações
232
+ </label>
233
+
234
+ <button id="play-tour">Tocar Tour</button>
235
+ <button id="pause-tour">Pausar</button>
236
+ <button id="restart-tour">Reiniciar</button>
237
+ </aside>
238
+ ```
239
+
240
+ ## Performance
241
+
242
+ Tour herda performance do modo base. Adicionar tour custa pouco: apenas interpolação de câmera e animações de opacity. Cuidado com `switchMode` no meio: dispose + rebuild pode causar stutter de 200-500ms.
@@ -0,0 +1,217 @@
1
+ # Call Graph 3D
2
+
3
+ Árvore (ou DAG) de **chamadas de função** explorável em 3D. Cada nó é uma função, cada aresta é uma chamada. Permite navegar a profundidade de uma cadeia de invocações partindo de pontos de entrada (endpoints, handlers, main).
4
+
5
+ ## Mapeamento
6
+
7
+ | Conceito | Visual |
8
+ |---|---|
9
+ | Função | Cápsula ou pílula 3D com label |
10
+ | Profundidade de chamada | Posição em Z (eixo de profundidade) |
11
+ | Função síncrona | Cápsula sólida |
12
+ | Função assíncrona | Cápsula translúcida com partículas |
13
+ | Função recursiva | Cápsula com brilho (emissive) |
14
+ | Caminho quente (frequência) | Linha mais grossa, cor saturada |
15
+ | Função externa (lib) | Cor cinza |
16
+ | Função do projeto | Cor por pasta/módulo |
17
+
18
+ ## Quando usar
19
+
20
+ - Entender o fluxo de execução de um endpoint específico.
21
+ - Diagnosticar profundidade excessiva de chamadas (>15 níveis, sinal de overengineering).
22
+ - Detectar recursão indireta.
23
+ - Apresentar como o sistema responde a uma requisição típica.
24
+
25
+ **Quando evitar**: análise estática sem dados de execução é incompleta (não captura polimorfismo). Para visão estrutural use Dependency Graph 3D.
26
+
27
+ ## Modelo de dados esperado
28
+
29
+ ```json
30
+ {
31
+ "entrypoints": ["POST /api/orders", "handleWebhookStripe"],
32
+ "calls": [
33
+ {
34
+ "from": "POST /api/orders",
35
+ "to": "OrderController.create",
36
+ "type": "sync",
37
+ "weight": 1000
38
+ },
39
+ {
40
+ "from": "OrderController.create",
41
+ "to": "OrderService.placeOrder",
42
+ "type": "sync",
43
+ "weight": 1000
44
+ },
45
+ {
46
+ "from": "OrderService.placeOrder",
47
+ "to": "PaymentClient.charge",
48
+ "type": "async",
49
+ "weight": 1000
50
+ }
51
+ ]
52
+ }
53
+ ```
54
+
55
+ `weight` é frequência relativa (quantidade de invocações observadas em um período). `type` é `sync`, `async`, `recursive` ou `external`.
56
+
57
+ ## Algoritmo de layout: árvore radial 3D
58
+
59
+ Cada entrypoint vira raiz da árvore. Profundidade aumenta no eixo Z (afastando-se da câmera), funções no mesmo nível distribuem-se em um plano XY.
60
+
61
+ ```javascript
62
+ function layoutTree(entrypoint, calls) {
63
+ const nodes = new Map();
64
+ nodes.set(entrypoint, { id: entrypoint, depth: 0, x: 0, y: 0, z: 0, children: [] });
65
+
66
+ function buildChildren(parentId, parentDepth) {
67
+ const outgoing = calls.filter((c) => c.from === parentId);
68
+ outgoing.forEach((c, i, arr) => {
69
+ if (nodes.has(c.to)) {
70
+ // detectou recursão
71
+ nodes.get(c.to).recursive = true;
72
+ return;
73
+ }
74
+ const angle = (i / arr.length) * Math.PI * 2;
75
+ const radius = parentDepth * 15 + 30;
76
+ const node = {
77
+ id: c.to,
78
+ depth: parentDepth + 1,
79
+ x: nodes.get(parentId).x + Math.cos(angle) * radius,
80
+ y: nodes.get(parentId).y + Math.sin(angle) * radius,
81
+ z: -(parentDepth + 1) * 40,
82
+ type: c.type,
83
+ weight: c.weight,
84
+ children: []
85
+ };
86
+ nodes.set(c.to, node);
87
+ nodes.get(parentId).children.push(node);
88
+ buildChildren(c.to, parentDepth + 1);
89
+ });
90
+ }
91
+
92
+ buildChildren(entrypoint, 0);
93
+ return Array.from(nodes.values());
94
+ }
95
+ ```
96
+
97
+ Para múltiplos entrypoints, cada um ocupa uma região do plano XY (translação no centro), criando árvores paralelas.
98
+
99
+ ## Renderização das cápsulas
100
+
101
+ ```javascript
102
+ const capsuleGeo = new THREE.CapsuleGeometry(2, 6, 8, 12);
103
+ const capsuleMat = new THREE.MeshStandardMaterial({ roughness: 0.4 });
104
+ const capsules = new THREE.InstancedMesh(capsuleGeo, capsuleMat, nodes.length);
105
+
106
+ nodes.forEach((n, i) => {
107
+ const dummy = new THREE.Object3D();
108
+ dummy.position.set(n.x, n.y, n.z);
109
+ dummy.rotation.z = Math.PI / 2; // horizontal
110
+ const scale = 0.6 + Math.log(1 + (n.weight ?? 1)) * 0.2;
111
+ dummy.scale.set(scale, scale, scale);
112
+ dummy.updateMatrix();
113
+ capsules.setMatrixAt(i, dummy.matrix);
114
+
115
+ const color = new THREE.Color(colorForCall(n));
116
+ capsules.setColorAt(i, color);
117
+ });
118
+ capsules.instanceMatrix.needsUpdate = true;
119
+ capsules.instanceColor.needsUpdate = true;
120
+ scene.add(capsules);
121
+ ```
122
+
123
+ `colorForCall(n)` retorna cinza para externas, cor da pasta para internas, com emissive se `n.recursive`.
124
+
125
+ ## Renderização das chamadas (arestas)
126
+
127
+ Linhas curvas tipo bezier conectando pai a filho. Mais grossas para `weight` alto.
128
+
129
+ ```javascript
130
+ calls.forEach((c) => {
131
+ const src = nodesById.get(c.from);
132
+ const dst = nodesById.get(c.to);
133
+ if (!src || !dst) return;
134
+
135
+ const mid = new THREE.Vector3(
136
+ (src.x + dst.x) / 2,
137
+ (src.y + dst.y) / 2 + 10,
138
+ (src.z + dst.z) / 2
139
+ );
140
+ const curve = new THREE.QuadraticBezierCurve3(
141
+ new THREE.Vector3(src.x, src.y, src.z),
142
+ mid,
143
+ new THREE.Vector3(dst.x, dst.y, dst.z)
144
+ );
145
+ const tube = new THREE.TubeGeometry(curve, 20, 0.2 + Math.log(1 + c.weight) * 0.1, 6, false);
146
+ const isAsync = c.type === "async";
147
+ const mat = new THREE.MeshStandardMaterial({
148
+ color: isAsync ? 0xb39ddb : 0x4a9eff,
149
+ transparent: true,
150
+ opacity: 0.6
151
+ });
152
+ scene.add(new THREE.Mesh(tube, mat));
153
+ });
154
+ ```
155
+
156
+ ## Animação de fluxo (opcional)
157
+
158
+ Partículas viajando ao longo das arestas, indicando que a chamada está "viva". Útil para apresentações.
159
+
160
+ ```javascript
161
+ function animateFlow(time) {
162
+ edgeParticles.forEach((p) => {
163
+ const t = (time * 0.001 + p.offset) % 1;
164
+ const pos = p.curve.getPoint(t);
165
+ p.mesh.position.copy(pos);
166
+ });
167
+ }
168
+ ```
169
+
170
+ ## Sidebar de controles
171
+
172
+ ```html
173
+ <aside id="sidebar">
174
+ <h3>Call Graph 3D</h3>
175
+
176
+ <label>Entrypoint
177
+ <select data-param="entrypoint">
178
+ <!-- POPULATED -->
179
+ </select>
180
+ </label>
181
+
182
+ <label>Profundidade máxima
183
+ <input type="range" min="1" max="20" value="10" data-param="maxDepth">
184
+ </label>
185
+
186
+ <label>
187
+ <input type="checkbox" data-param="showAsync" checked> Destacar async
188
+ </label>
189
+
190
+ <label>
191
+ <input type="checkbox" data-param="showExternal"> Mostrar libs externas
192
+ </label>
193
+
194
+ <label>
195
+ <input type="checkbox" data-param="animateFlow"> Animar fluxo
196
+ </label>
197
+
198
+ <div id="depth-info"></div>
199
+ <div id="recursive-warnings"></div>
200
+
201
+ <button id="reset">Reset</button>
202
+ <button id="export-png">Exportar PNG</button>
203
+ </aside>
204
+ ```
205
+
206
+ ## Interação
207
+
208
+ - **Hover em cápsula**: nome da função, módulo de origem, número de chamadores e chamados, tipo.
209
+ - **Clique em cápsula**: foca câmera, destaca cadeia desde o entrypoint até essa função.
210
+ - **Duplo clique**: expande/colapsa subárvore.
211
+ - **Toggle entrypoint**: muda a raiz da visualização, recalcula layout.
212
+
213
+ ## Performance
214
+
215
+ - Limite prático: ~500 funções por entrypoint.
216
+ - Acima disso, colapsar subárvores automaticamente após profundidade 5 e exibir botão "+N funções".
217
+ - Animação de fluxo: limitar a 50 partículas simultâneas para não derrubar fps.
@@ -0,0 +1,228 @@
1
+ # Code City
2
+
3
+ Padrão consagrado de visualização de software em 3D: cada arquivo do projeto é um **prédio**, agrupados em **distritos** que correspondem a pastas. Permite captar tamanho, complexidade e distribuição do código em um único olhar.
4
+
5
+ ## Mapeamento de atributos
6
+
7
+ | Atributo do código | Atributo visual do prédio |
8
+ |---|---|
9
+ | Linhas de código (LOC) | Altura |
10
+ | Complexidade ciclomática | Área da base (largura x profundidade) |
11
+ | Pasta do arquivo | Distrito (posição no plano) |
12
+ | Tipo de arquivo (código, teste, config) | Cor base |
13
+ | Hot path (frequência de mudança ou dependentes) | Cor de destaque (vermelho/amarelo) |
14
+
15
+ ## Quando usar
16
+
17
+ - Visão geral inicial de um projeto desconhecido.
18
+ - Identificar arquivos muito grandes (prédios altos) ou complexos (prédios largos).
19
+ - Detectar agrupamento por pasta (distritos coesos vs espalhados).
20
+ - Apresentação executiva: visualmente impactante e intuitivo.
21
+
22
+ **Quando evitar**: projetos pequenos (< 30 arquivos), onde a metáfora urbana é overkill. Use Dependency Graph 3D ou módulos D3 2D.
23
+
24
+ ## Algoritmo de layout
25
+
26
+ ### 1. Agrupar por pasta
27
+
28
+ ```javascript
29
+ const districts = {};
30
+ modules.forEach((m) => {
31
+ if (!districts[m.folder]) districts[m.folder] = [];
32
+ districts[m.folder].push(m);
33
+ });
34
+ ```
35
+
36
+ ### 2. Calcular tamanho de cada distrito
37
+
38
+ A área do distrito é proporcional ao número de arquivos. Use empacotamento simples (linha por linha) ou squarified treemap.
39
+
40
+ ```javascript
41
+ function packDistrict(modules, padding = 1) {
42
+ const count = modules.length;
43
+ const cols = Math.ceil(Math.sqrt(count));
44
+ const rows = Math.ceil(count / cols);
45
+ return { cols, rows };
46
+ }
47
+ ```
48
+
49
+ ### 3. Posicionar distritos no plano
50
+
51
+ Os distritos formam a cidade. Para até ~20 pastas, empacotar em grid simples. Para mais, usar treemap.
52
+
53
+ ```javascript
54
+ const districtSize = (count) => Math.sqrt(count) * cellSize * 2;
55
+ let offsetX = 0;
56
+ let offsetZ = 0;
57
+ const districtPositions = {};
58
+ Object.entries(districts).forEach(([folder, mods], i) => {
59
+ const size = districtSize(mods.length);
60
+ districtPositions[folder] = { x: offsetX, z: offsetZ, size };
61
+ offsetX += size + districtGap;
62
+ if ((i + 1) % gridCols === 0) {
63
+ offsetX = 0;
64
+ offsetZ += size + districtGap;
65
+ }
66
+ });
67
+ ```
68
+
69
+ ### 4. Posicionar prédios dentro do distrito
70
+
71
+ ```javascript
72
+ modules.forEach((m) => {
73
+ const district = districtPositions[m.folder];
74
+ const local = packDistrict(districts[m.folder]);
75
+ const indexInDistrict = districts[m.folder].indexOf(m);
76
+ const col = indexInDistrict % local.cols;
77
+ const row = Math.floor(indexInDistrict / local.cols);
78
+ m.x = district.x + col * cellSize;
79
+ m.z = district.z + row * cellSize;
80
+ });
81
+ ```
82
+
83
+ ### 5. Dimensionar cada prédio
84
+
85
+ ```javascript
86
+ const LOC_TO_HEIGHT = 0.4; // 1000 LOC = 400 unidades de altura
87
+ const COMPLEXITY_TO_WIDTH = 0.8;
88
+ const MIN_W = 2;
89
+ const MIN_H = 1;
90
+
91
+ modules.forEach((m) => {
92
+ m.height = Math.max(MIN_H, m.loc * LOC_TO_HEIGHT);
93
+ const baseW = Math.max(MIN_W, Math.sqrt(m.complexity) * COMPLEXITY_TO_WIDTH);
94
+ m.w = baseW;
95
+ m.d = baseW;
96
+ });
97
+ ```
98
+
99
+ ### 6. Renderizar com InstancedMesh
100
+
101
+ Ver `THREE_PATTERNS.md` para o padrão de InstancedMesh. Cada prédio é uma instância da mesma BoxGeometry, com matriz e cor distintas.
102
+
103
+ ```javascript
104
+ const boxGeo = new THREE.BoxGeometry(1, 1, 1);
105
+ boxGeo.translate(0, 0.5, 0); // base no chão
106
+ const mat = new THREE.MeshStandardMaterial({ roughness: 0.6 });
107
+ const buildings = new THREE.InstancedMesh(boxGeo, mat, modules.length);
108
+ buildings.castShadow = true;
109
+ buildings.receiveShadow = true;
110
+
111
+ const dummy = new THREE.Object3D();
112
+ const color = new THREE.Color();
113
+
114
+ modules.forEach((m, i) => {
115
+ dummy.position.set(m.x, 0, m.z);
116
+ dummy.scale.set(m.w, m.height, m.d);
117
+ dummy.updateMatrix();
118
+ buildings.setMatrixAt(i, dummy.matrix);
119
+ color.set(colorForModule(m));
120
+ buildings.setColorAt(i, color);
121
+ });
122
+ buildings.instanceMatrix.needsUpdate = true;
123
+ buildings.instanceColor.needsUpdate = true;
124
+ scene.add(buildings);
125
+ ```
126
+
127
+ ### 7. Chão e distritos
128
+
129
+ Adicionar um plano grande como chão e quadrados coloridos demarcando cada distrito.
130
+
131
+ ```javascript
132
+ const ground = new THREE.Mesh(
133
+ new THREE.PlaneGeometry(2000, 2000),
134
+ new THREE.MeshStandardMaterial({ color: 0x14141a, roughness: 1 })
135
+ );
136
+ ground.rotation.x = -Math.PI / 2;
137
+ ground.receiveShadow = true;
138
+ scene.add(ground);
139
+
140
+ Object.entries(districtPositions).forEach(([folder, d]) => {
141
+ const districtPlane = new THREE.Mesh(
142
+ new THREE.PlaneGeometry(d.size, d.size),
143
+ new THREE.MeshStandardMaterial({ color: districtColor(folder), transparent: true, opacity: 0.15 })
144
+ );
145
+ districtPlane.rotation.x = -Math.PI / 2;
146
+ districtPlane.position.set(d.x + d.size / 2, 0.01, d.z + d.size / 2);
147
+ scene.add(districtPlane);
148
+ });
149
+ ```
150
+
151
+ ## Cores por tipo de arquivo
152
+
153
+ ```javascript
154
+ const TYPE_COLORS = {
155
+ code: 0x4a9eff, // azul
156
+ test: 0x6cc46c, // verde
157
+ config: 0xffc857, // amarelo
158
+ doc: 0xb39ddb, // lilás
159
+ style: 0xff9aa2, // rosa
160
+ asset: 0x999999 // cinza
161
+ };
162
+
163
+ function colorForModule(m) {
164
+ if (m.isHotPath) return 0xff5a4f;
165
+ return TYPE_COLORS[m.type] || 0xcccccc;
166
+ }
167
+ ```
168
+
169
+ ## Sidebar de controles (Code City)
170
+
171
+ ```html
172
+ <aside id="sidebar">
173
+ <h3>Code City</h3>
174
+
175
+ <label>Altura (LOC)
176
+ <input type="range" min="0.1" max="2.0" step="0.1" value="0.4" data-param="locScale">
177
+ </label>
178
+
179
+ <label>Base (complexidade)
180
+ <input type="range" min="0.2" max="2.0" step="0.1" value="0.8" data-param="complexityScale">
181
+ </label>
182
+
183
+ <label>Threshold de hot path
184
+ <input type="range" min="0" max="100" step="5" value="50" data-param="hotPathThreshold">
185
+ </label>
186
+
187
+ <label>
188
+ <input type="checkbox" data-param="showLabels" checked> Labels visíveis
189
+ </label>
190
+
191
+ <label>
192
+ <input type="checkbox" data-param="showDistricts" checked> Mostrar distritos
193
+ </label>
194
+
195
+ <label>Filtrar pasta
196
+ <select data-param="folderFilter">
197
+ <option value="all">Todas</option>
198
+ <!-- POPULATED_FROM_DATA -->
199
+ </select>
200
+ </label>
201
+
202
+ <button id="reset">Reset</button>
203
+ <button id="export-png">Exportar PNG</button>
204
+ </aside>
205
+ ```
206
+
207
+ Quando um slider muda, recalcular `m.height`, `m.w`, `m.d` e atualizar a `InstancedMesh` com novas matrizes.
208
+
209
+ ## Interação
210
+
211
+ - **Hover em prédio**: tooltip mostra nome do arquivo, LOC, complexidade, pasta.
212
+ - **Clique em prédio**: foca câmera no prédio (anima `controls.target` para a posição do prédio).
213
+ - **Drag em distrito**: rotaciona câmera com OrbitControls.
214
+ - **Scroll**: zoom in/out.
215
+
216
+ ## Performance
217
+
218
+ - Até **5.000 prédios** é seguro com InstancedMesh.
219
+ - Acima disso, agrupar arquivos por pasta (um prédio = uma pasta com altura agregada de LOC, área pelo número de arquivos).
220
+ - Desativar sombras se o framerate cair abaixo de 30fps (detectar via `requestAnimationFrame` timer).
221
+
222
+ ## Variantes opcionais
223
+
224
+ - **Code City temporal**: animar crescimento ao longo do histórico do projeto (cada commit faz prédios crescerem).
225
+ - **Code City colorida por autor**: cores indicam quem é o maintainer principal de cada arquivo.
226
+ - **Code City com chuva**: hot paths recebem efeito de partículas vermelhas caindo, indicando "instabilidade".
227
+
228
+ Estas variantes ficam para versões futuras da skill.