@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,252 @@
1
+ import { existsSync, readFileSync, writeFileSync, appendFileSync } from 'fs';
2
+ import { join, resolve } from 'path';
3
+ import { checkExistingInstallation } from '../installer/validator.js';
4
+ import { renderLegacyEditPolicyParagraph } from '../installer/policy.js';
5
+ import { loadManifest, saveManifest, buildManifest, fileStatus, isInsideDir } from '../installer/manifest.js';
6
+ import { Writer } from '../installer/writer.js';
7
+ import { ENGINES } from '../installer/detector.js';
8
+ import { listAllAgents } from '../installer/prompts.js';
9
+ import { renderImpeccableNotice, IMPECCABLE_AGENT_ID } from '../installer/bundled.js';
10
+ import { applyOrangeTheme, ORANGE_PREFIX } from '../installer/orange-prompts.js';
11
+ import { readJsonSafe } from '../utils/json-safe.js';
12
+ import { PACKAGE_NAME, PACKAGE_VERSION, npxCommand, registryLatestUrl } from '../utils/package-info.js';
13
+
14
+ // Instalações anteriores ao registro do pacote de origem vieram do upstream.
15
+ const UPSTREAM_PACKAGE = 'reversa';
16
+
17
+ async function fetchLatestVersion(packageName) {
18
+ try {
19
+ const res = await fetch(registryLatestUrl(packageName));
20
+ if (!res.ok) return null;
21
+ const data = await res.json();
22
+ return data.version ?? null;
23
+ } catch {
24
+ return null;
25
+ }
26
+ }
27
+
28
+ export default async function update(args) {
29
+ const { default: chalk } = await import('chalk');
30
+ const { default: ora } = await import('ora');
31
+ const { default: semver } = await import('semver');
32
+
33
+ const projectRoot = resolve(process.cwd());
34
+
35
+ console.log(chalk.bold('\n Reversa: Update\n'));
36
+
37
+ const existing = checkExistingInstallation(projectRoot);
38
+ if (!existing.installed) {
39
+ console.log(chalk.yellow(' Reversa is not installed in this directory.'));
40
+ console.log(' Run ' + chalk.bold(npxCommand('install')) + ' to install.\n');
41
+ return;
42
+ }
43
+
44
+ const installedVersion = existing.version;
45
+ const installedFrom = existing.state.package ?? UPSTREAM_PACKAGE;
46
+ // Projeto instalado por outra distribuição (ex.: upstream → fork): as versões não são
47
+ // comparáveis, então o update sempre roda para trocar os arquivos pelos deste pacote.
48
+ const migrating = installedFrom !== PACKAGE_NAME;
49
+
50
+ // Validate installed version before comparing
51
+ if (!semver.valid(installedVersion)) {
52
+ console.log(chalk.yellow(` Invalid installed version: "${installedVersion}". Run ${npxCommand('install')} to fix it.\n`));
53
+ return;
54
+ }
55
+
56
+ // Check version on npm
57
+ const spinner = ora({ text: 'Checking for latest version...', color: 'cyan' }).start();
58
+ const latestVersion = await fetchLatestVersion(PACKAGE_NAME);
59
+ spinner.stop();
60
+
61
+ // Os arquivos instalados vêm DESTE pacote em execução: é a versão dele que o projeto passa a ter.
62
+ if (latestVersion && semver.valid(latestVersion) && semver.lt(PACKAGE_VERSION, latestVersion)) {
63
+ console.log(chalk.yellow(` This run uses v${PACKAGE_VERSION}, but v${latestVersion} is on npm.`));
64
+ console.log(chalk.yellow(` To get the newest, run: npx ${PACKAGE_NAME}@latest update\n`));
65
+ } else if (!latestVersion) {
66
+ console.log(chalk.gray(' Could not check version on npm. Continuing offline.\n'));
67
+ }
68
+
69
+ if (!migrating && !semver.lt(installedVersion, PACKAGE_VERSION)) {
70
+ console.log(chalk.hex('#ffa203')(` This project is already on v${installedVersion} of ${PACKAGE_NAME}.\n`));
71
+ return;
72
+ }
73
+
74
+ console.log(` Installed version: ${chalk.yellow('v' + installedVersion)}${migrating ? chalk.gray(` (from ${installedFrom})`) : ''}`);
75
+ console.log(` Target version: ${chalk.hex('#ffa203')('v' + PACKAGE_VERSION)}${migrating ? chalk.gray(` (${PACKAGE_NAME})`) : ''}\n`);
76
+
77
+ // Carregar manifest e classificar arquivos
78
+ const manifest = loadManifest(projectRoot);
79
+ const state = existing.state;
80
+ // Update instala todos os agentes do pacote, incluindo os novos
81
+ const allAgents = listAllAgents();
82
+ const installedEngineIds = state.engines ?? [];
83
+ const installedEngines = ENGINES.filter(e => installedEngineIds.includes(e.id));
84
+
85
+ const modified = [];
86
+ const intact = [];
87
+ const missing = [];
88
+
89
+ for (const [relPath, hash] of Object.entries(manifest)) {
90
+ const status = fileStatus(projectRoot, relPath, hash);
91
+ if (status === 'modified') modified.push(relPath);
92
+ else if (status === 'missing') missing.push(relPath);
93
+ else intact.push(relPath);
94
+ }
95
+
96
+ if (modified.length > 0) {
97
+ console.log(chalk.yellow(` ${modified.length} file(s) modified by you, will be kept:`));
98
+ modified.forEach(f => console.log(chalk.gray(` ✎ ${f}`)));
99
+ console.log('');
100
+ }
101
+ if (missing.length > 0) {
102
+ console.log(chalk.cyan(` ${missing.length} missing file(s), will be restored:`));
103
+ missing.forEach(f => console.log(chalk.gray(` + ${f}`)));
104
+ console.log('');
105
+ }
106
+
107
+ const toUpdate = intact.length + missing.length;
108
+ console.log(` ${toUpdate} file(s) will be updated.`);
109
+
110
+ const { default: inquirer } = await import('inquirer');
111
+ applyOrangeTheme();
112
+ const { confirm } = await inquirer.prompt([{
113
+ prefix: ORANGE_PREFIX,
114
+ type: 'confirm',
115
+ name: 'confirm',
116
+ message: '\nConfirm update?',
117
+ default: true,
118
+ }]);
119
+ if (!confirm) {
120
+ console.log(chalk.gray('\n Update cancelled.\n'));
121
+ return;
122
+ }
123
+
124
+ const writer = new Writer(projectRoot);
125
+ let configCreated = false;
126
+ const appendedTo = [];
127
+ const updateSpinner = ora({ text: 'Updating agents...', color: 'cyan' }).start();
128
+
129
+ try {
130
+ // Reinstalar skills (intactos + ausentes; pular modificados)
131
+ for (const agent of allAgents) {
132
+ for (const engine of installedEngines) {
133
+ const relDir = join(engine.skillsDir, agent).replace(/\\/g, '/');
134
+ // Compara pela pasta inteira: "reversa" não pode casar com "reversa-docs/...".
135
+ const isModified = modified.some(f => isInsideDir(f, relDir));
136
+ if (!isModified) {
137
+ const { rmSync } = await import('fs');
138
+ const dest = join(projectRoot, engine.skillsDir, agent);
139
+ if (existsSync(dest)) rmSync(dest, { recursive: true, force: true });
140
+ await writer.installSkill(agent, engine.skillsDir);
141
+ }
142
+
143
+ if (engine.universalSkillsDir && engine.universalSkillsDir !== engine.skillsDir) {
144
+ const uRelDir = join(engine.universalSkillsDir, agent).replace(/\\/g, '/');
145
+ const uIsModified = modified.some(f => isInsideDir(f, uRelDir));
146
+ if (!uIsModified) {
147
+ const { rmSync } = await import('fs');
148
+ const uDest = join(projectRoot, engine.universalSkillsDir, agent);
149
+ if (existsSync(uDest)) rmSync(uDest, { recursive: true, force: true });
150
+ await writer.installSkill(agent, engine.universalSkillsDir);
151
+ }
152
+ }
153
+ }
154
+ }
155
+
156
+ updateSpinner.text = 'Refreshing forward assets...';
157
+
158
+ // Refrescar body templates, scripts e hooks.yml respeitando modificações do usuário
159
+ const modifiedSet = new Set(modified.map(f => f.replace(/\\/g, '/')));
160
+ writer.refreshForwardAssets(modifiedSet);
161
+
162
+ updateSpinner.text = 'Updating entry files...';
163
+
164
+ // Atualizar entry files intactos ou ausentes
165
+ for (const engine of installedEngines) {
166
+ const relEntry = engine.entryFile;
167
+ const hash = manifest[relEntry];
168
+ if (!hash) continue; // não foi instalado pelo Reversa — não tocar
169
+ const status = fileStatus(projectRoot, relEntry, hash);
170
+ if (status === 'intact' || status === 'missing') {
171
+ await writer.installEntryFile(engine, {
172
+ force: true,
173
+ outputFolder: existing.state.output_folder,
174
+ forwardFolder: existing.state.forward_folder,
175
+ });
176
+ }
177
+ }
178
+
179
+ updateSpinner.text = 'Configuring legacy-edit policy...';
180
+
181
+ // Política de edição do legado: config com default seguro quando ausente + hook opcional
182
+ configCreated = writer.ensureReversaConfig();
183
+ writer.installPolicyHooks();
184
+
185
+ // Entry files modificados pelo usuário recebem o parágrafo padrão por append,
186
+ // sem apagar conteúdo (os intactos já foram reescritos com o template novo acima)
187
+ for (const engine of installedEngines) {
188
+ if (!engine.entryFile) continue;
189
+ const entryPath = join(projectRoot, engine.entryFile);
190
+ if (!existsSync(entryPath)) continue;
191
+ const content = readFileSync(entryPath, 'utf8');
192
+ if (content.includes('reversa-config.json')) continue;
193
+ appendFileSync(
194
+ entryPath,
195
+ '\n\n## Política de edição do legado (Reversa)\n\n' + renderLegacyEditPolicyParagraph() + '\n',
196
+ 'utf8'
197
+ );
198
+ appendedTo.push(engine.entryFile);
199
+ }
200
+
201
+ updateSpinner.text = 'Updating version...';
202
+
203
+ {
204
+ const statePath = join(projectRoot, '.reversa', 'state.json');
205
+ const s = readJsonSafe(statePath);
206
+ s.agents = allAgents;
207
+ s.package = PACKAGE_NAME;
208
+ s.version = PACKAGE_VERSION;
209
+ writeFileSync(join(projectRoot, '.reversa', 'version'), PACKAGE_VERSION, 'utf8');
210
+ writeFileSync(statePath, JSON.stringify(s, null, 2), 'utf8');
211
+ }
212
+
213
+ updateSpinner.text = 'Updating manifest...';
214
+
215
+ writer.saveCreatedFiles();
216
+ const newManifest = buildManifest(projectRoot, writer.manifestPaths);
217
+ // Mesclar com manifest existente (preservar entradas de arquivos não tocados)
218
+ const intactEntries = Object.fromEntries(
219
+ intact.map(r => [r, manifest[r]])
220
+ );
221
+ saveManifest(projectRoot, { ...intactEntries, ...newManifest });
222
+
223
+ updateSpinner.succeed(chalk.hex('#ffa203')('Update complete!'));
224
+ } catch (err) {
225
+ updateSpinner.fail(chalk.red('Error during update.'));
226
+ throw err;
227
+ }
228
+
229
+ if (modified.length > 0) {
230
+ console.log(chalk.yellow(`\n ${modified.length} file(s) kept (modified by you).`));
231
+ }
232
+
233
+ console.log(chalk.bold('\n Legacy-edit policy:'));
234
+ if (configCreated) {
235
+ console.log(` ${chalk.hex('#ffa203')('+')} .reversa/reversa-config.json created with the safe default (allowLegacyEdits: false).`);
236
+ } else {
237
+ console.log(chalk.gray(' .reversa/reversa-config.json already exists and was kept as is.'));
238
+ }
239
+ if (appendedTo.length > 0) {
240
+ console.log(` ${chalk.hex('#ffa203')('+')} Policy paragraph appended to: ${appendedTo.join(', ')} (your content was preserved).`);
241
+ }
242
+ console.log(' To let Reversa write in the legacy code, edit the file: allowLegacyEdits: true + allowedPaths with the desired globs.');
243
+ console.log(' If your entry files carry manual exceptions, consider migrating them to allowedPaths.');
244
+ console.log(' Optional hard enforcement for Claude Code: see .reversa/hooks/README.md');
245
+ console.log('');
246
+
247
+ if (allAgents.includes(IMPECCABLE_AGENT_ID)) {
248
+ const hasSlashEngine = installedEngines.some(e => e.id !== 'codex' && e.id !== 'hermes');
249
+ renderImpeccableNotice(chalk, { hasSlashEngine }).forEach(line => console.log(line));
250
+ console.log('');
251
+ }
252
+ }
@@ -0,0 +1,42 @@
1
+ // Componentes de terceiros entregues junto com o Reversa.
2
+ //
3
+ // Hoje: Impeccable (Paul Bakaus, Apache License 2.0), vendorizado em
4
+ // agents/impeccable/ por scripts/sync-impeccable.mjs, que também grava a
5
+ // proveniência em agents/impeccable/reversa-bundle.json. O install e o update
6
+ // leem esse arquivo para avisar o usuário de que o Impeccable vem junto, com
7
+ // qual versão e sob qual licença, citando a ferramenta.
8
+ import { existsSync } from 'fs';
9
+ import { join, resolve, dirname } from 'path';
10
+ import { fileURLToPath } from 'url';
11
+ import { readJsonSafe } from '../utils/json-safe.js';
12
+
13
+ const __dirname = dirname(fileURLToPath(import.meta.url));
14
+ const AGENTS_DIR = resolve(__dirname, '..', '..', 'agents');
15
+
16
+ export const IMPECCABLE_AGENT_ID = 'impeccable';
17
+
18
+ export function getImpeccableBundle() {
19
+ const file = join(AGENTS_DIR, IMPECCABLE_AGENT_ID, 'reversa-bundle.json');
20
+ if (!existsSync(file)) return null;
21
+ try {
22
+ return readJsonSafe(file);
23
+ } catch {
24
+ return null;
25
+ }
26
+ }
27
+
28
+ // Linhas do aviso exibido ao final do install e do update.
29
+ // hasSlashEngine: true quando alguma engine instalada aceita comandos /nome.
30
+ export function renderImpeccableNotice(chalk, { hasSlashEngine = true } = {}) {
31
+ const bundle = getImpeccableBundle();
32
+ if (!bundle) return [];
33
+ const cmd = hasSlashEngine ? '/impeccable' : 'impeccable';
34
+ return [
35
+ chalk.bold(' Front-end Team: Impeccable'),
36
+ ` Reversa ships ${chalk.bold(bundle.displayName)} v${bundle.version} by ${bundle.author} as its Front-end Team,`,
37
+ ` under the ${chalk.bold('Apache License 2.0')} (LICENSE and NOTICE.md travel inside the ${IMPECCABLE_AGENT_ID} skill folder).`,
38
+ ` ${bundle.homepage} · ${bundle.repository}`,
39
+ chalk.cyan(` → For frontend design (critique, audit, polish, animate...), run ${cmd} init once, then ${cmd} <command> <target>`),
40
+ chalk.gray(' The first run downloads the Impeccable engine binary into ~/.impeccable/bin (needs network).'),
41
+ ];
42
+ }
@@ -0,0 +1,167 @@
1
+ import { existsSync } from 'fs';
2
+ import { join } from 'path';
3
+ import { execFileSync } from 'child_process';
4
+
5
+ export const ENGINES = [
6
+ {
7
+ id: 'claude-code',
8
+ name: 'Claude Code',
9
+ star: true,
10
+ entryFile: 'CLAUDE.md',
11
+ entryTemplate: 'CLAUDE.md',
12
+ skillsDir: '.claude/skills',
13
+ universalSkillsDir: '.agents/skills',
14
+ },
15
+ {
16
+ id: 'codex',
17
+ name: 'Codex',
18
+ star: true,
19
+ entryFile: 'AGENTS.md',
20
+ entryTemplate: 'AGENTS.md',
21
+ skillsDir: '.agents/skills',
22
+ universalSkillsDir: '.agents/skills',
23
+ },
24
+ {
25
+ id: 'cursor',
26
+ name: 'Cursor',
27
+ star: true,
28
+ entryFile: '.cursorrules',
29
+ entryTemplate: 'cursorrules',
30
+ skillsDir: '.agents/skills',
31
+ universalSkillsDir: '.agents/skills',
32
+ },
33
+ {
34
+ id: 'gemini-cli',
35
+ name: 'Gemini CLI',
36
+ star: false,
37
+ entryFile: 'GEMINI.md',
38
+ entryTemplate: 'GEMINI.md',
39
+ skillsDir: '.agents/skills',
40
+ universalSkillsDir: '.agents/skills',
41
+ },
42
+ {
43
+ id: 'windsurf',
44
+ name: 'Windsurf',
45
+ star: false,
46
+ entryFile: '.windsurfrules',
47
+ entryTemplate: 'windsurf',
48
+ skillsDir: '.agents/skills',
49
+ universalSkillsDir: '.agents/skills',
50
+ },
51
+ {
52
+ id: 'antigravity',
53
+ name: 'Antigravity',
54
+ star: false,
55
+ entryFile: 'AGENTS.md',
56
+ entryTemplate: 'AGENTS.md',
57
+ skillsDir: '.agents/skills',
58
+ universalSkillsDir: '.agents/skills',
59
+ },
60
+ {
61
+ id: 'kiro',
62
+ name: 'Kiro',
63
+ star: false,
64
+ entryFile: null,
65
+ entryTemplate: null,
66
+ skillsDir: '.kiro/skills',
67
+ universalSkillsDir: '.agents/skills',
68
+ },
69
+ {
70
+ id: 'opencode',
71
+ name: 'Opencode',
72
+ star: false,
73
+ entryFile: 'AGENTS.md',
74
+ entryTemplate: 'AGENTS.md',
75
+ skillsDir: '.agents/skills',
76
+ universalSkillsDir: '.agents/skills',
77
+ },
78
+ {
79
+ id: 'hermes',
80
+ name: 'Hermes',
81
+ star: false,
82
+ entryFile: 'AGENTS.md',
83
+ entryTemplate: 'AGENTS.md',
84
+ skillsDir: '.agents/skills',
85
+ universalSkillsDir: '.agents/skills',
86
+ },
87
+ {
88
+ id: 'cline',
89
+ name: 'Cline',
90
+ star: false,
91
+ entryFile: '.clinerules',
92
+ entryTemplate: 'clinerules',
93
+ skillsDir: '.agents/skills',
94
+ universalSkillsDir: '.agents/skills',
95
+ },
96
+ {
97
+ id: 'roo-code',
98
+ name: 'Roo Code',
99
+ star: false,
100
+ entryFile: '.roorules',
101
+ entryTemplate: 'roorules',
102
+ skillsDir: '.agents/skills',
103
+ universalSkillsDir: '.agents/skills',
104
+ },
105
+ {
106
+ id: 'github-copilot',
107
+ name: 'GitHub Copilot',
108
+ star: false,
109
+ entryFile: '.github/copilot-instructions.md',
110
+ entryTemplate: 'copilot-instructions',
111
+ skillsDir: '.agents/skills',
112
+ universalSkillsDir: '.agents/skills',
113
+ },
114
+ {
115
+ id: 'aider',
116
+ name: 'Aider',
117
+ star: false,
118
+ entryFile: 'CONVENTIONS.md',
119
+ entryTemplate: 'CONVENTIONS.md',
120
+ skillsDir: '.agents/skills',
121
+ universalSkillsDir: '.agents/skills',
122
+ },
123
+ {
124
+ id: 'amazon-q',
125
+ name: 'Amazon Q Developer',
126
+ star: false,
127
+ entryFile: '.amazonq/rules/reversa.md',
128
+ entryTemplate: 'amazonq',
129
+ skillsDir: '.agents/skills',
130
+ universalSkillsDir: '.agents/skills',
131
+ },
132
+ ];
133
+
134
+ function commandExists(cmd) {
135
+ if (!/^[a-zA-Z0-9_-]+$/.test(cmd)) return false;
136
+ try {
137
+ const finder = process.platform === 'win32' ? 'where' : 'which';
138
+ execFileSync(finder, [cmd], { stdio: 'pipe' });
139
+ return true;
140
+ } catch {
141
+ return false;
142
+ }
143
+ }
144
+
145
+ export function detectEngines(projectRoot) {
146
+ const detectors = {
147
+ 'claude-code': (r) => existsSync(join(r, '.claude')) || commandExists('claude'),
148
+ 'codex': (r) => existsSync(join(r, 'AGENTS.md')) || commandExists('codex'),
149
+ 'cursor': (r) => existsSync(join(r, '.cursor')) || existsSync(join(r, '.cursorrules')),
150
+ 'gemini-cli': (r) => existsSync(join(r, 'GEMINI.md')) || commandExists('gemini'),
151
+ 'windsurf': (r) => existsSync(join(r, '.windsurf')) || existsSync(join(r, '.windsurfrules')),
152
+ 'antigravity': (r) => existsSync(join(r, '.antigravity')) || commandExists('agy'),
153
+ 'kiro': (r) => existsSync(join(r, '.kiro')) || commandExists('kiro'),
154
+ 'opencode': (r) => existsSync(join(r, '.opencode')) || commandExists('opencode'),
155
+ 'hermes': (r) => existsSync(join(r, '.hermes')) || commandExists('hermes'),
156
+ 'cline': (r) => existsSync(join(r, '.clinerules')) || existsSync(join(r, '.cline')),
157
+ 'roo-code': (r) => existsSync(join(r, '.roorules')) || existsSync(join(r, '.roo')),
158
+ 'github-copilot': (r) => existsSync(join(r, '.github', 'copilot-instructions.md')),
159
+ 'aider': (r) => existsSync(join(r, '.aider.conf.yml')) || commandExists('aider'),
160
+ 'amazon-q': (r) => existsSync(join(r, '.amazonq')) || commandExists('q'),
161
+ };
162
+
163
+ return ENGINES.map(engine => ({
164
+ ...engine,
165
+ detected: detectors[engine.id]?.(projectRoot) ?? false,
166
+ }));
167
+ }
@@ -0,0 +1,61 @@
1
+ import { createHash } from 'crypto';
2
+ import { readFileSync, existsSync, writeFileSync, mkdirSync, statSync } from 'fs';
3
+ import { join, dirname } from 'path';
4
+ import { readJsonSafe } from '../utils/json-safe.js';
5
+
6
+ export function hashFile(filePath) {
7
+ if (!existsSync(filePath)) return null;
8
+ if (statSync(filePath).isDirectory()) return null;
9
+ return createHash('sha256').update(readFileSync(filePath)).digest('hex');
10
+ }
11
+
12
+ // Accepts relative paths; stores them as relative keys in the manifest.
13
+ // Always use this signature — never pass absolute paths.
14
+ export function buildManifest(projectRoot, relPaths) {
15
+ const manifest = {};
16
+ for (const relPath of relPaths) {
17
+ const absPath = join(projectRoot, relPath);
18
+ const hash = hashFile(absPath);
19
+ if (hash) manifest[relPath] = hash;
20
+ }
21
+ return manifest;
22
+ }
23
+
24
+ export function saveManifest(projectRoot, manifest) {
25
+ const manifestPath = join(projectRoot, '.reversa', '_config', 'files-manifest.json');
26
+ mkdirSync(dirname(manifestPath), { recursive: true });
27
+ writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), 'utf8');
28
+ }
29
+
30
+ export function loadManifest(projectRoot) {
31
+ const manifestPath = join(projectRoot, '.reversa', '_config', 'files-manifest.json');
32
+ if (!existsSync(manifestPath)) return {};
33
+ try {
34
+ return readJsonSafe(manifestPath);
35
+ } catch {
36
+ return {};
37
+ }
38
+ }
39
+
40
+ // Returns 'intact' | 'modified' | 'missing'
41
+ export function fileStatus(projectRoot, relPath, originalHash) {
42
+ const absPath = join(projectRoot, relPath);
43
+ const current = hashFile(absPath);
44
+ if (!current) return 'missing';
45
+ return current === originalHash ? 'intact' : 'modified';
46
+ }
47
+
48
+ // true se relPath está dentro da pasta relDir (ou é ela), com separador normalizado para "/".
49
+ // startsWith(relDir) sem a "/" final fazia ".claude/skills/reversa" casar com ".claude/skills/reversa-docs/...".
50
+ export function isInsideDir(relPath, relDir) {
51
+ const file = relPath.replace(/\\/g, '/');
52
+ const dir = relDir.replace(/\\/g, '/').replace(/\/+$/, '');
53
+ return file === dir || file.startsWith(dir + '/');
54
+ }
55
+
56
+ // Kept for compatibility
57
+ export function hasFileBeenModified(filePath, originalHash) {
58
+ const current = hashFile(filePath);
59
+ if (!current) return false;
60
+ return current !== originalHash;
61
+ }
@@ -0,0 +1,13 @@
1
+ import { createRequire } from 'module';
2
+ import chalk from 'chalk';
3
+
4
+ const require = createRequire(import.meta.url);
5
+ const ORANGE = chalk.hex('#ffa203');
6
+
7
+ export function applyOrangeTheme() {
8
+ const colors = require('yoctocolors-cjs');
9
+ colors.green = (t) => ORANGE(t);
10
+ colors.cyan = (t) => ORANGE(t);
11
+ }
12
+
13
+ export const ORANGE_PREFIX = '';
@@ -0,0 +1,53 @@
1
+ // Fonte única da regra de não-destrutividade do Reversa: as únicas pastas em
2
+ // que o framework pode criar/escrever. Renderiza o texto da regra injetado em
3
+ // cada arquivo de entrada de engine no momento do install.
4
+ //
5
+ // `_reversa_sdd` e `_reversa_forward` são configuráveis pelo usuário
6
+ // (state.json: output_folder / forward_folder). `_reversa_docs` é fixo por
7
+ // enquanto; se um dia virar configurável (docs_folder), basta passá-lo aqui.
8
+
9
+ // Exportada também para uso futuro por updateGitignore/uninstall, que hoje
10
+ // só conhecem `.reversa/` + output_folder e divergem da regra global.
11
+ // `_reversa_bugs/` e `_reversa_refactor/` entraram na v1.2.59 (spec
12
+ // legacy-code-edition v1.3): territórios dos times Bugs e Code Quality.
13
+ export function getWritableFolders({
14
+ outputFolder = '_reversa_sdd',
15
+ forwardFolder = '_reversa_forward',
16
+ } = {}) {
17
+ return [
18
+ '.reversa/',
19
+ `${outputFolder}/`,
20
+ '_reversa_docs/',
21
+ `${forwardFolder}/`,
22
+ '_reversa_bugs/',
23
+ '_reversa_refactor/',
24
+ ];
25
+ }
26
+
27
+ // Parágrafo padrão da política configurável de edição do legado (spec
28
+ // legacy-code-edition, RF-08). Entra em todos os entry files via
29
+ // renderPolicyBlock e é anexado a entry files modificados durante o update.
30
+ export function renderLegacyEditPolicyParagraph() {
31
+ return [
32
+ 'Antes de criar, modificar ou apagar qualquer arquivo fora das pastas próprias do Reversa, leia `.reversa/reversa-config.json` e obedeça ao resultado:',
33
+ '',
34
+ '- Arquivo ausente, JSON inválido ou campo com tipo errado: trate como `allowLegacyEdits: false` (falha segura, nenhuma escrita fora das pastas do Reversa).',
35
+ '- `allowLegacyEdits: false`: recuse a escrita, informando o caminho recusado, o estado atual da config e o que o usuário deve editar para liberar.',
36
+ '- `allowLegacyEdits: true` com `allowedPaths` não vazio: escreva apenas em caminhos que casem com algum glob da lista (globs relativos à raiz do projeto, com `/`, suportando `*` e `**`).',
37
+ '- `allowLegacyEdits: true` com `allowedPaths` vazio ou ausente: projeto liberado; avise uma vez por sessão que a liberação é irrestrita.',
38
+ '',
39
+ 'Nunca crie nem edite `.reversa/reversa-config.json` por iniciativa própria: pedido na conversa não é liberação implícita, alterações nesse arquivo são ato exclusivo do usuário.',
40
+ ].join('\n');
41
+ }
42
+
43
+ export function renderPolicyBlock(opts = {}) {
44
+ const folders = getWritableFolders(opts).map((f) => `\`${f}\``);
45
+ const list = `${folders.slice(0, -1).join(', ')} e ${folders[folders.length - 1]}`;
46
+ return [
47
+ 'Por padrão, nunca apague, modifique ou sobrescreva arquivos pré-existentes do projeto legado:',
48
+ `o Reversa escreve apenas em ${list}.`,
49
+ 'A única exceção é a política configurável abaixo, controlada exclusivamente pelo usuário.',
50
+ '',
51
+ renderLegacyEditPolicyParagraph(),
52
+ ].join('\n');
53
+ }