@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,212 @@
1
+ ---
2
+ name: reversa-writer
3
+ description: Gera especificações executáveis do sistema legado como contratos operacionais, em formato de pasta-por-unit com requirements.md, design.md e tasks.md. Use na fase de geração de uma análise de engenharia reversa.
4
+ disable-model-invocation: true
5
+ license: MIT
6
+ compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
7
+ metadata:
8
+ author: sandeco
9
+ version: "1.2.0"
10
+ framework: reversa
11
+ phase: geracao
12
+ ---
13
+
14
+ Você é o Writer. Sua missão é transformar o conhecimento extraído em especificações formais, precisas e rastreáveis, no layout de pasta-por-unit definido em `[specs]` do `config.toml`.
15
+
16
+ ## Antes de começar
17
+
18
+ Leia, nesta ordem:
19
+
20
+ 1. `.reversa/state.json` → campos `output_folder` (padrão: `_reversa_sdd`), `doc_level` (padrão: `completo`) e `doc_language`.
21
+ 2. `.reversa/config.toml` → seção `[specs]` (campos `granularity`, `custom_folders`).
22
+ 3. `.reversa/config.user.toml` → seção `[specs]` se existir, com precedência chave a chave sobre `config.toml`.
23
+ 4. `.reversa/context/surface.json` → especialmente `modules` e `organization_suggestion.features`.
24
+ 5. Demais artefatos em `<output_folder>/` e `.reversa/context/` (gerados por agentes anteriores).
25
+
26
+ Se a seção `[specs]` ainda não está decidida (granularity vazia), pare e peça ao orquestrador Reversa para executar `references/step-03-specs-organization.md` antes de continuar.
27
+
28
+ ## Layout de saída, pasta-por-unit
29
+
30
+ Toda spec gerada por este agente vai para uma **pasta de unit** dentro de `<output_folder>/`. Cada unit recebe os 3 arquivos canônicos:
31
+
32
+ - `<output_folder>/<unit>/requirements.md`
33
+ - `<output_folder>/<unit>/design.md`
34
+ - `<output_folder>/<unit>/tasks.md`
35
+
36
+ O que é uma "unit" depende da `granularity`:
37
+
38
+ | `granularity` | Unit é... | Fonte para enumerar |
39
+ |---------------|-----------|---------------------|
40
+ | `module` | Um módulo do legado | `surface.json.modules` |
41
+ | `endpoint` | Um endpoint ou contrato HTTP/RPC | Routes/controllers identificados pelo Scout (sinais em `organization_suggestion.signals`) ou inferidos do código |
42
+ | `use-case` | Um caso de uso comportamental | Specs Gherkin/E2E (`features/*.feature`, `*.spec.*`) ou casos extraídos de fluxos no código |
43
+ | `hybrid` | Módulo no topo, casos de uso aninhados | `surface.json.modules` no nível 1 + casos de uso dentro de cada módulo |
44
+ | `feature` | Uma feature listada pelo Scout | `surface.json.organization_suggestion.features` |
45
+ | `custom` | Pasta definida pelo usuário | `[specs].custom_folders` do `config.toml` |
46
+
47
+ ### Idioma e nomes de pasta (RF-10)
48
+
49
+ Os nomes das pastas seguem `doc_language` do `state.json`. Em uma instalação `Português`, os nomes saem em pt-br (ex.: `pedidos/`, `autenticacao/`); em `English`, saem em inglês (ex.: `orders/`, `authentication/`). Não pergunte idioma, apenas aplique o já configurado. Sanitize cada nome (substitua espaços por `-`, remova caracteres proibidos pelo OS).
50
+
51
+ ### Caso `hybrid`
52
+
53
+ Para cada módulo `M` em `surface.json.modules`, crie a pasta `<output_folder>/<M>/` com os 3 arquivos canônicos no nível do módulo, e abaixo dela uma pasta por caso de uso identificado dentro daquele módulo: `<output_folder>/<M>/<caso-de-uso>/requirements.md`, `design.md`, `tasks.md`.
54
+
55
+ ## Artefatos canônicos e opcionais
56
+
57
+ **Sempre, em cada pasta de unit:**
58
+ - `requirements.md`, ver `references/requirements-template.md`
59
+ - `design.md`, ver `references/design-template.md`
60
+ - `tasks.md`, ver `references/tasks-template.md`
61
+
62
+ **Opcionais por unit, conforme `doc_level` e contexto:**
63
+
64
+ | Arquivo | Quando gerar |
65
+ |---------|--------------|
66
+ | `contracts.md` | `doc_level` = `completo` ou `detalhado`, e a unit expõe contrato externo (HTTP, fila, RPC) |
67
+ | `flows.md` | A unit tem 2+ fluxos distintos não cobertos no `design.md` |
68
+ | `edge-cases.md` | `doc_level` = `detalhado`, com pelo menos 2 casos extremos por unit |
69
+ | `decisions.md` | A unit tem decisões arquiteturais explícitas (ADR-style) que mereçam registro |
70
+ | `legacy-mapping.md` | Útil para `module`, mas o Archaeologist é quem normalmente preenche |
71
+ | `questions.md` | A unit tem 🔴 lacunas que dependem de validação humana |
72
+
73
+ `tests.md` pode ser gerado quando há um corpo de testes legado significativo a documentar separadamente.
74
+
75
+ **Globais, FORA das pastas de unit:**
76
+
77
+ Estes ficam na raiz de `<output_folder>/`, não dentro de feature folders:
78
+
79
+ - `traceability/code-spec-matrix.md`, apenas se `doc_level` = `completo` ou `detalhado`
80
+ - `openapi/<api>.yaml`, apenas se `doc_level` = `completo` ou `detalhado` (ou se a API for o produto principal no `essencial`)
81
+ - `user-stories/<fluxo>.md`, apenas se `doc_level` = `completo` ou `detalhado`
82
+
83
+ ## Princípio fundamental
84
+
85
+ **Specs são contratos operacionais, não texto bonito.** Uma spec deve ser suficientemente detalhada para que um agente de IA, sem acesso ao código original, possa reimplementar a funcionalidade com fidelidade.
86
+
87
+ ## Regra de execução obrigatória
88
+
89
+ **Nunca gere tudo de uma vez.** Projetos grandes têm muitas units. Gerar tudo em uma única resposta consome contexto excessivo, reduz a qualidade e impede revisão incremental.
90
+
91
+ ## Fluxo obrigatório
92
+
93
+ ### Passo 1, Montar o plano
94
+
95
+ 1. Resolva a lista de units conforme a tabela de `granularity` acima.
96
+ 2. Para cada unit, monte a lista de arquivos a gerar: sempre os 3 canônicos, mais opcionais aplicáveis.
97
+ 3. Adicione, ao final, os globais aplicáveis (traceability, openapi, user-stories).
98
+
99
+ Apresente o plano ao usuário neste formato (ajuste o idioma conforme `chat_language`):
100
+
101
+ ```
102
+ 📋 Plano de geração, X units, Y arquivos no total
103
+
104
+ Units:
105
+ [ ] 1. <unit-1>/requirements.md
106
+ [ ] 2. <unit-1>/design.md
107
+ [ ] 3. <unit-1>/tasks.md
108
+ [ ] 4. <unit-1>/contracts.md (opcional, se aplicável)
109
+ ...
110
+
111
+ Globais (se aplicáveis):
112
+ [ ] N. openapi/<api>.yaml
113
+ [ ] N+1. user-stories/<fluxo>.md
114
+ [ ] N+2. traceability/code-spec-matrix.md
115
+
116
+ Digite CONTINUAR para iniciar, ou me diga se quer ajustar o plano.
117
+ ```
118
+
119
+ Aguarde a confirmação do usuário antes de prosseguir.
120
+
121
+ ### Passo 2, Gerar um arquivo por vez
122
+
123
+ Para cada item do plano, em sequência:
124
+
125
+ 1. Informe: `"Gerando [N/total]: [caminho do arquivo]..."`
126
+ 2. Gere apenas aquele arquivo, baseando-se no template correspondente em `references/`.
127
+ 3. Se a pasta da unit ainda não existe, crie-a; se já existe (EC-05), preserve qualquer conteúdo presente e apenas adicione os arquivos faltantes. Nunca sobrescreva arquivos já existentes sem confirmação.
128
+ 4. Marque o item como concluído no plano.
129
+ 5. Salve o progresso em `.reversa/state.json` (campo `redator_progress`).
130
+ 6. Informe: `"✅ [arquivo] concluído. Próximo: [próximo item]. Digite CONTINUAR para prosseguir."`
131
+ 7. Pare e aguarde a resposta do usuário.
132
+
133
+ Só avance para o próximo item após resposta. Isso permite que o usuário revise, ajuste ou interrompa a qualquer momento.
134
+
135
+ **Pausa preventiva entre units:** quando você concluir o último arquivo (`tasks.md`) de uma unit e a sessão já gerou **3 units ou mais** sem pausa, troque a mensagem padrão "Digite CONTINUAR" pela versão com pausa preventiva:
136
+
137
+ > "✅ [arquivo] concluído. Unit **[X]** está completa e o checkpoint está salvo. Próxima unit: **[Y]**. Você quer:
138
+ >
139
+ > 1. Continuar agora
140
+ > 2. Pausar aqui, digitar `/clear` e retomar com `/reversa` em sessão nova (recomendado se a sessão atual já está longa, preserva qualidade nas próximas units)
141
+ >
142
+ > Pressione 1, 2, ou digite CONTINUAR para opção 1."
143
+
144
+ Antes de oferecer a opção 2, confirme que `redator_progress` em `.reversa/state.json` reflete o último arquivo concluído. Não force a pausa, o usuário decide.
145
+
146
+ ### Passo 3, Globais
147
+
148
+ Após todos os arquivos de unit, gere os globais aplicáveis na ordem: `openapi/`, `user-stories/`, `traceability/code-spec-matrix.md` por último.
149
+
150
+ A code-spec matrix lista, por arquivo do legado, qual unit cobre o quê:
151
+
152
+ | Arquivo do legado | Unit correspondente | Cobertura |
153
+ |---------|---------------------|-----------|
154
+ | `caminho/arquivo.ext` | `<unit>/` | 🟢 / 🟡 / n/a |
155
+
156
+ Arquivos sem unit correspondente ficam com `n/a`, são candidatos a análise adicional.
157
+
158
+ ### Passo 4, Encerramento
159
+
160
+ Ao concluir, informe ao Reversa:
161
+ - Units geradas (quantidade)
162
+ - Total de arquivos canônicos + opcionais
163
+ - Globais gerados
164
+ - % de cobertura estimada (arquivos do legado mapeados a alguma unit)
165
+
166
+ ## Confiança em cada afirmação
167
+
168
+ Marque toda afirmação com 🟢 (CONFIRMADO no código), 🟡 (INFERIDO) ou 🔴 (LACUNA). Sem exceções.
169
+
170
+ ## Como preencher seções críticas
171
+
172
+ **Requisitos Não Funcionais** (em `requirements.md`)
173
+ Infira a partir do código, não invente. Sinais a procurar:
174
+ - Timeouts explícitos → Performance
175
+ - Middleware de autenticação/autorização → Segurança
176
+ - Uso de cache, filas, workers → Escalabilidade
177
+ - Retry logic, circuit breakers → Disponibilidade
178
+ Se não encontrar evidência, omita a linha. Nunca preencha sem rastreabilidade.
179
+
180
+ **Critérios de Aceitação** (em `requirements.md`)
181
+ Derive dos fluxos e regras de negócio documentados em `design.md` (ou diretamente do código). Para cada fluxo principal, gere ao menos um cenário feliz e um cenário de falha. Use `Dado / Quando / Então` sem exceção.
182
+
183
+ **MoSCoW** (em `requirements.md`)
184
+ - **Must:** caminho crítico ou chamado por múltiplos componentes
185
+ - **Should:** importante mas com alternativa ou fallback
186
+ - **Could:** acionada raramente ou em casos de borda
187
+ - **Won't:** código comentado, flags desativadas, deprecado
188
+
189
+ Baseie em frequência de chamada, posição na cadeia de dependências e presença de testes.
190
+
191
+ **Tasks** (em `tasks.md`)
192
+ Cada tarefa cita o arquivo do legado de onde o comportamento foi extraído. Critério de pronto sempre presente. Confiança 🟢/🟡/🔴 sempre presente.
193
+
194
+ ## Saída resumo
195
+
196
+ ```
197
+ <output_folder>/
198
+ ├── <unit-1>/
199
+ │ ├── requirements.md
200
+ │ ├── design.md
201
+ │ ├── tasks.md
202
+ │ └── (opcionais aplicáveis)
203
+ ├── <unit-2>/
204
+ │ └── ...
205
+ ├── traceability/code-spec-matrix.md # apenas completo/detalhado
206
+ ├── openapi/<api>.yaml # apenas completo/detalhado
207
+ └── user-stories/<fluxo>.md # apenas completo/detalhado
208
+ ```
209
+
210
+ ## Diretiva non-destructive
211
+
212
+ Nunca apague, mova ou modifique pastas e arquivos já existentes em `<output_folder>/`. Em caso de pasta de unit pré-existente, adicione apenas os arquivos faltantes. Em caso de arquivo canônico já presente, deixe-o como está e informe ao usuário.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Writer"
3
+ short_description: "Gera especificações executáveis do sistema legado como…"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,49 @@
1
+ # [Nome da Unit], Design Técnico
2
+
3
+ > Template do arquivo `design.md`. Foca no COMO a unit é construída, com base no código legado lido.
4
+
5
+ ## Interface
6
+ [Entradas, saídas, parâmetros, tipos de dados]
7
+
8
+ Para endpoints HTTP:
9
+
10
+ | Método | Caminho | Entrada | Saída | Status codes |
11
+ |--------|---------|---------|-------|--------------|
12
+ | GET | `/recurso/:id` | `id: string` | `Recurso` | 200, 404 |
13
+ | POST | `/recurso` | `RecursoCreate` | `Recurso` | 201, 400, 409 |
14
+
15
+ Para classes/funções:
16
+
17
+ | Símbolo | Assinatura | Retorno | Observação |
18
+ |---------|-----------|---------|------------|
19
+ | `NomeDaClasse.metodo` | `(arg1: T, arg2: U)` | `V` | [Detalhe relevante] |
20
+
21
+ ## Fluxo Principal
22
+ 1. [Passo 1, com referência ao arquivo legado quando aplicável]
23
+ 2. [Passo 2]
24
+ 3. [Passo N]
25
+
26
+ ## Fluxos Alternativos
27
+ - **[Condição especial]:** [comportamento]
28
+ - **[Caso de erro]:** [comportamento]
29
+
30
+ ## Dependências
31
+ - [Componente X], [motivo, como usa]
32
+ - [Serviço Y], [motivo, como usa]
33
+
34
+ ## Decisões de Design Identificadas
35
+
36
+ | Decisão | Evidência no código | Confiança |
37
+ |---------|---------------------|-----------|
38
+ | [ex: persistência via Prisma com soft-delete] | `prisma/schema.prisma:42` | 🟢 |
39
+ | [ex: cache em memória com TTL de 5min] | `cache/store.ts:18` | 🟡 |
40
+
41
+ ## Estado Interno
42
+ [Se a unit mantém estado, descrever quais campos, onde são armazenados, como evoluem]
43
+
44
+ ## Observabilidade
45
+ [Logs, métricas, traces emitidos pela unit, com referência ao código]
46
+
47
+ ## Riscos e Lacunas
48
+ - 🔴 [Comportamento que não foi possível inferir do código, requer validação humana]
49
+ - 🟡 [Suposição que pode estar errada]
@@ -0,0 +1,62 @@
1
+ # [Nome da Unit]
2
+
3
+ > Template do arquivo `requirements.md`. Foca no QUE a unit faz, não no como.
4
+
5
+ ## Visão Geral
6
+ [O que é, qual problema resolve, 2 a 3 linhas]
7
+
8
+ ## Responsabilidades
9
+ - [Responsabilidade 1]
10
+ - [Responsabilidade 2]
11
+
12
+ ## Regras de Negócio
13
+ - [Regra 1] 🟢
14
+ - [Regra 2] 🟡
15
+ - [Comportamento desconhecido] 🔴
16
+
17
+ ## Requisitos Funcionais
18
+
19
+ | ID | Requisito | Prioridade | Critério de Aceite |
20
+ |----|-----------|-----------|-------------------|
21
+ | RF-01 | [Descrição] | Must | [Como validar] |
22
+ | RF-02 | [Descrição] | Should | [Como validar] |
23
+
24
+ ## Requisitos Não Funcionais
25
+
26
+ | Tipo | Requisito inferido | Evidência no código | Confiança |
27
+ |------|--------------------|---------------------|-----------|
28
+ | Performance | [ex: timeout de 30s em chamadas externas] | `caminho/arquivo.ext:linha` | 🟢 |
29
+ | Segurança | [ex: autenticação obrigatória na rota] | `caminho/arquivo.ext:linha` | 🟡 |
30
+ | Escalabilidade | [ex: uso de cache Redis] | `caminho/arquivo.ext:linha` | 🟢 |
31
+ | Disponibilidade | [ex: retry automático em falha] | `caminho/arquivo.ext:linha` | 🟡 |
32
+
33
+ > Inferido a partir do código. Validar com equipe de operações.
34
+
35
+ ## Critérios de Aceitação
36
+
37
+ ```gherkin
38
+ Dado [pré-condição]
39
+ Quando [ação]
40
+ Então [resultado esperado]
41
+
42
+ Dado [condição de erro]
43
+ Quando [ação inválida]
44
+ Então [comportamento de falha esperado]
45
+ ```
46
+
47
+ ## Prioridade (MoSCoW)
48
+
49
+ | Requisito | MoSCoW | Justificativa |
50
+ |-----------|--------|---------------|
51
+ | [Responsabilidade principal] | Must | Caminho crítico, chamado em todo fluxo |
52
+ | [Regra de negócio central] | Must | Regra de negócio sem fallback |
53
+ | [Funcionalidade secundária] | Should | Importante mas com alternativa |
54
+ | [Caso de borda] | Could | Raramente acionado |
55
+
56
+ > Prioridade inferida por frequência de chamada e posição na cadeia de dependências.
57
+
58
+ ## Rastreabilidade de Código
59
+
60
+ | Arquivo | Função / Classe | Cobertura |
61
+ |---------|-----------------|-----------|
62
+ | `caminho/arquivo.ext` | `NomeDaClasse` | 🟢 |
@@ -0,0 +1,39 @@
1
+ # [Nome da Unit], Tarefas de Implementação
2
+
3
+ > Template do arquivo `tasks.md`. Foca em uma sequência de tarefas executáveis para reimplementar a unit a partir do legado, com rastreabilidade ao código original.
4
+
5
+ ## Pré-requisitos
6
+ - [ ] Dependências da unit listadas em `design.md` estão disponíveis
7
+ - [ ] Schema/migrations do banco compatíveis (se aplicável)
8
+ - [ ] Variáveis de ambiente / configs necessárias documentadas
9
+
10
+ ## Tarefas
11
+
12
+ > Cada tarefa referencia o arquivo do legado de onde o comportamento foi extraído.
13
+
14
+ - [ ] T-01, [Descrição da tarefa]
15
+ - Origem no legado: `caminho/arquivo.ext:linha`
16
+ - Critério de pronto: [como validar]
17
+ - Confiança: 🟢 / 🟡 / 🔴
18
+
19
+ - [ ] T-02, [Descrição da tarefa]
20
+ - Origem no legado: `caminho/arquivo.ext:linha`
21
+ - Critério de pronto: [como validar]
22
+ - Confiança: 🟢 / 🟡 / 🔴
23
+
24
+ ## Tarefas de Teste
25
+
26
+ - [ ] TT-01, Teste do happy path do fluxo principal (ver `requirements.md`, Critérios de Aceitação)
27
+ - [ ] TT-02, Teste do caso de erro principal
28
+ - [ ] TT-03, [Outros cenários relevantes]
29
+
30
+ ## Tarefas de Migração de Dados (se aplicável)
31
+
32
+ - [ ] TM-01, [Migração de dados X, com referência ao schema legado]
33
+
34
+ ## Ordem Sugerida
35
+ 1. [Quais tarefas devem ser feitas primeiro e por quê]
36
+ 2. [Bloqueios entre tarefas]
37
+
38
+ ## Lacunas Pendentes (🔴)
39
+ [Liste aqui as decisões que dependem de validação humana antes da implementação]
package/bin/reversa.js ADDED
@@ -0,0 +1,65 @@
1
+ #!/usr/bin/env node
2
+
3
+ import { readFileSync } from 'fs';
4
+ import { fileURLToPath } from 'url';
5
+ import { dirname, join } from 'path';
6
+ import chalk from 'chalk';
7
+ import { clearTerminalForLogo, renderReversaLogo } from '../lib/utils/banner.js';
8
+
9
+ const __dirname = dirname(fileURLToPath(import.meta.url));
10
+ const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf8'));
11
+
12
+ const [,, command, ...args] = process.argv;
13
+
14
+ const commands = {
15
+ install: () => import('../lib/commands/install.js'),
16
+ update: () => import('../lib/commands/update.js'),
17
+ status: () => import('../lib/commands/status.js'),
18
+ uninstall: () => import('../lib/commands/uninstall.js'),
19
+ 'add-engine': () => import('../lib/commands/add-engine.js'),
20
+ 'export-diagrams': () => import('../lib/commands/export-diagrams.js'),
21
+ };
22
+
23
+ if (!command || command === '--help' || command === '-h') {
24
+ clearTerminalForLogo();
25
+ console.log(renderReversaLogo(chalk) + `
26
+
27
+ reversa v${pkg.version}
28
+
29
+ Uso: npx ${pkg.name} <comando>
30
+
31
+ Comandos:
32
+ install Instala o Reversa no projeto atual (todos os agentes)
33
+ update Atualiza tudo para a última versão (todos os agentes)
34
+ status Mostra o estado atual da análise
35
+ uninstall Remove o Reversa do projeto
36
+ add-engine Adiciona suporte a uma engine
37
+ export-diagrams Exporta diagramas Mermaid como imagens SVG/PNG
38
+ Opções: --format=svg|png --output=<pasta>
39
+ Requer: npm install -g @mermaid-js/mermaid-cli
40
+
41
+ Fluxos principais no chat (após a instalação):
42
+ /reversa Descobre e documenta um sistema existente
43
+ /reversa-new Cria PRD e specs para um projeto novo
44
+ /reversa-forward Implementa ou evolui código a partir das specs
45
+ /reversa-migrate Planeja a migração de um sistema legado
46
+ /reversa-docs Gera o mini-site visual da documentação
47
+
48
+ Documentação: https://github.com/sandeco/reversa
49
+ `);
50
+ process.exit(0);
51
+ }
52
+
53
+ if (command === '--version' || command === '-v') {
54
+ console.log(pkg.version);
55
+ process.exit(0);
56
+ }
57
+
58
+ if (!commands[command]) {
59
+ console.error(`\n Comando desconhecido: "${command}"`);
60
+ console.error(` Execute "npx ${pkg.name} --help" para ver os comandos disponíveis.\n`);
61
+ process.exit(1);
62
+ }
63
+
64
+ const mod = await commands[command]();
65
+ await mod.default(args);
@@ -0,0 +1,97 @@
1
+ import { existsSync, readFileSync, writeFileSync } from 'fs';
2
+ import { join, resolve } from 'path';
3
+ import { npxCommand } from '../utils/package-info.js';
4
+ import { checkExistingInstallation } from '../installer/validator.js';
5
+ import { detectEngines, ENGINES } from '../installer/detector.js';
6
+ import { Writer } from '../installer/writer.js';
7
+ import { loadManifest, saveManifest, buildManifest } from '../installer/manifest.js';
8
+ import { applyOrangeTheme, ORANGE_PREFIX } from '../installer/orange-prompts.js';
9
+ import { readJsonSafe } from '../utils/json-safe.js';
10
+
11
+ export default async function addEngine(args) {
12
+ const { default: chalk } = await import('chalk');
13
+ const { default: inquirer } = await import('inquirer');
14
+ applyOrangeTheme();
15
+
16
+ const projectRoot = resolve(process.cwd());
17
+
18
+ console.log(chalk.bold('\n Reversa: Add Engine\n'));
19
+
20
+ const existing = checkExistingInstallation(projectRoot);
21
+ if (!existing.installed) {
22
+ console.log(chalk.yellow(' Reversa is not installed in this directory.'));
23
+ console.log(' Run ' + chalk.bold(npxCommand('install')) + ' to install.\n');
24
+ return;
25
+ }
26
+
27
+ const state = existing.state;
28
+
29
+ // Validate required fields
30
+ if (!Array.isArray(state.agents) || state.agents.length === 0) {
31
+ console.log(chalk.red(' state.json has no registered agents.'));
32
+ console.log(' Run ' + chalk.bold(npxCommand('install')) + ' first.\n');
33
+ return;
34
+ }
35
+
36
+ const installedEngineIds = new Set(state.engines ?? []);
37
+ const installedAgents = state.agents;
38
+
39
+ const allEngines = detectEngines(projectRoot);
40
+ const notInstalled = allEngines.filter(e => !installedEngineIds.has(e.id));
41
+
42
+ if (notInstalled.length === 0) {
43
+ console.log(chalk.hex('#ffa203')(' All detected engines are already configured.\n'));
44
+ return;
45
+ }
46
+
47
+ const choices = notInstalled.map(e => ({
48
+ name: `${e.name}${e.star ? ' ⭐' : ''}${e.detected ? chalk.gray(' (detected)') : ''}`,
49
+ value: e.id,
50
+ checked: e.detected,
51
+ }));
52
+
53
+ const { selected } = await inquirer.prompt([{
54
+ prefix: ORANGE_PREFIX,
55
+ type: 'checkbox',
56
+ name: 'selected',
57
+ message: '\nSelect engines to add:\n\n',
58
+ choices,
59
+ validate: (v) => v.length > 0 || 'Select at least one engine.',
60
+ }]);
61
+
62
+ const selectedEngines = ENGINES.filter(e => selected.includes(e.id));
63
+ const writer = new Writer(projectRoot);
64
+
65
+ const seenEntryFiles = new Set();
66
+ for (const engine of selectedEngines) {
67
+ if (engine.entryFile && !seenEntryFiles.has(engine.entryFile)) {
68
+ seenEntryFiles.add(engine.entryFile);
69
+ await writer.installEntryFile(engine, {
70
+ outputFolder: state.output_folder,
71
+ forwardFolder: state.forward_folder,
72
+ });
73
+ }
74
+ for (const agent of installedAgents) {
75
+ await writer.installSkill(agent, engine.skillsDir);
76
+ if (engine.universalSkillsDir && engine.universalSkillsDir !== engine.skillsDir) {
77
+ await writer.installSkill(agent, engine.universalSkillsDir);
78
+ }
79
+ }
80
+ console.log(chalk.hex('#ffa203')(` ✓ ${engine.name}`));
81
+ }
82
+
83
+ // Atualizar state.json
84
+ const statePath = join(projectRoot, '.reversa', 'state.json');
85
+ const s = readJsonSafe(statePath);
86
+ s.engines = [...new Set([...(s.engines ?? []), ...selected])];
87
+ writeFileSync(statePath, JSON.stringify(s, null, 2), 'utf8');
88
+
89
+ writer.saveCreatedFiles();
90
+
91
+ // Atualizar manifest com caminhos relativos
92
+ const existingManifest = loadManifest(projectRoot);
93
+ const newManifest = buildManifest(projectRoot, writer.manifestPaths);
94
+ saveManifest(projectRoot, { ...existingManifest, ...newManifest });
95
+
96
+ console.log(chalk.bold(`\n ${selected.length} engine(s) added successfully.\n`));
97
+ }