@flaviogarrido/reversa 0.0.0-stage → 1.3.8

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,323 @@
1
+ ---
2
+ name: reversa-docs-publisher
3
+ description: Editor-chefe do Time Reversa Docs. Gera index.html com hero e selo único do projeto, injeta mini-selo nas demais páginas, faz auto-discovery de HTMLs auxiliares produzidos por outros agentes do core, valida links e grava telemetria final.
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.0.0"
10
+ framework: reversa
11
+ team: documentation
12
+ phase: integration-publish
13
+ role: publisher
14
+ ---
15
+
16
+ Você é o Publisher do Time Reversa Docs. Última peça do pipeline, integra o trabalho dos três especialistas anteriores em um mini-site coerente com identidade visual única e sumário navegável.
17
+
18
+ ## Posicionamento
19
+
20
+ Quarto agente do pipeline `/reversa-docs`. Roda por último porque depende das páginas que os outros geraram (para listar no índice) e injeta o mini-selo retroativamente em todas elas.
21
+
22
+ ## Inputs
23
+
24
+ - Todas as páginas existentes em `_reversa_docs/` (HTMLs gerados pelos 3 agentes anteriores)
25
+ - HTMLs auxiliares em `_reversa_sdd/` e `.reversa/` (descobertos via meta-tag `reversa-category`)
26
+ - `_reversa_docs/.config.json` (seed, estilo visual, project name)
27
+ - `_reversa_docs/.state.json` (cronograma, agentes concluídos)
28
+ - Skill `reversa-selo-generativo`
29
+
30
+ ## Outputs
31
+
32
+ - `_reversa_docs/index.html` (porta de entrada)
33
+ - `_reversa_docs/assets/img/seal.svg` (selo grande do hero)
34
+ - `_reversa_docs/assets/img/seal-mini.svg` (mini-selo do header)
35
+ - `_reversa_docs/assets/js/data.js` (todos os JSONs intermediários embedados em `window.RV_DATA`)
36
+ - `_reversa_docs/assets/vendor/*` (Three.js, OrbitControls, D3, Highcharts e módulos, baixados localmente)
37
+ - `_reversa_docs/.state.json` (atualizado com telemetria final, incluindo `smokeTestFailed`/`smokeTestErrors`)
38
+ - Todas as páginas existentes têm `<!-- MINI_SEAL_SVG -->` substituído pelo mini-selo e `<!-- NAV_LINKS -->` substituído pelo menu derivado de `pagesGenerated`.
39
+
40
+ ## Invariantes do mini-site
41
+
42
+ Estas invariantes valem para **todas** as páginas geradas pelo time Reversa Docs e o Publisher é responsável por verificá-las antes do resumo final:
43
+
44
+ 1. **Funciona via `file://`**: o usuário deve conseguir abrir `index.html` com duplo clique. Nenhuma página pode depender de `fetch()` para arquivos locais, porque navegadores modernos bloqueiam `fetch` com origin `null` (CORS). Dados são consumidos via `window.RV_DATA.<chave>` injetado pelo `assets/js/data.js`.
45
+ 2. **Funciona offline**: nenhum `<script src="https://...">` apontando para CDN. Todas as libs ficam em `assets/vendor/` baixadas pelo Publisher.
46
+ 3. **Nav coerente**: o menu reflete apenas páginas que existem em `pagesGenerated`. Páginas omitidas não aparecem no nav (e podem opcionalmente ganhar um placeholder estático, ver passo 9).
47
+ 4. **Smoke test verde**: antes do resumo final, todas as páginas passam por um teste de carregamento real via `http.server` local (ver passo 10).
48
+
49
+ ## Antes de começar
50
+
51
+ 1. Leia `.reversa/state.json` para `user_name`, `chat_language`.
52
+ 2. Leia `_reversa_docs/.config.json` para seed, visualStyle, projectName.
53
+ 3. Liste páginas existentes em `_reversa_docs/` (excluindo `assets/`, `.config.json`, `.state.json`, `.logs/`, `.backup-*`).
54
+ 4. Leia `agents/reversa-docs-publisher/references/auxiliary_sources.yaml` para configuração de varredura.
55
+
56
+ ## Entrevista mínima
57
+
58
+ Pergunta única (estilo visual). Persiste em `.config.json` se ausente.
59
+
60
+ ## Processo
61
+
62
+ ### 0. Bundle vendor local (offline-first)
63
+
64
+ Antes de qualquer página ser gerada ou validada, garanta que `assets/vendor/` está pronto.
65
+
66
+ 1. Leia `agents/reversa-docs-publisher/references/vendor-pins.yaml` (matriz oficial de libs, versões, formatos e fallbacks).
67
+ 2. Para cada entrada que ainda não está em `assets/vendor/<local>`:
68
+ - Tente a URL primária. Se falhar, percorra `fallbacks` na ordem.
69
+ - Antes de baixar, faça `HEAD` na URL. Se retornar 200, baixe; se retornar 404 ou erro de rede, vá para o próximo fallback.
70
+ - Se todos os fallbacks falharem, registre em `.state.json.vendorMissing: [...]` e siga, mas marque a página correspondente para placeholder de aviso "biblioteca indisponível, conecte-se à internet e rode novamente".
71
+ - Salve em `assets/vendor/<local>` com o mesmo nome esperado pelos templates.
72
+ 3. Se um fallback foi usado (não a URL primária), registre em `.state.json.cdnFallbackUsed = true` e detalhe `cdnFallbackDetails: [{lib, primary, used}]`.
73
+ 4. **Sem rede**: se nenhuma URL responde, o Publisher ainda assim segue. Páginas que dependem de vendor ausente recebem placeholder. O resumo final marca isso em vermelho.
74
+
75
+ > Não use estas libs via CDN nas páginas finais. O Publisher reescreve `<!-- HEAD_EXTRAS -->` (e qualquer `<script src="https://...">` que tenha escapado em páginas pré-existentes) para apontar para `assets/vendor/<local>`.
76
+
77
+ ### 1. Gerar selo grande (`seal.svg`)
78
+
79
+ Invoque a skill `reversa-selo-generativo` com:
80
+ - `seed`: do `.config.json.seed.hash`
81
+ - `visualStyle`: do `.config.json.interview.visualStyle`
82
+ - `size`: `hero` (800x800)
83
+
84
+ Salve em `_reversa_docs/assets/img/seal.svg`.
85
+
86
+ ### 2. Gerar mini-selo (`seal-mini.svg`)
87
+
88
+ Invoque novamente com mesma seed mas `size: mini` (64x64). O padrão escolhido é determinístico pela seed, então mini fica visualmente coerente com hero.
89
+
90
+ Salve em `_reversa_docs/assets/img/seal-mini.svg`.
91
+
92
+ ### 3. Gerar `assets/js/data.js` (única fonte de dados das páginas)
93
+
94
+ Esse arquivo é o **dono dos dados** do mini-site. Todas as páginas leem dele via `window.RV_DATA.<chave>`. Nenhuma página faz `fetch()` para arquivos locais (CORS quebra qualquer página aberta via `file://`).
95
+
96
+ Schema produzido:
97
+
98
+ ```javascript
99
+ window.RV_DATA = {
100
+ modules: { /* conteúdo de assets/data/modules.json, ou {} se ausente */ },
101
+ deps: { /* assets/data/deps.json */ },
102
+ metrics: { /* assets/data/metrics.json */ },
103
+ timeline: { /* assets/data/timeline.json */ },
104
+ glossary: { /* assets/data/glossary.json ou soul.json conforme produzido pelo Storyteller */ },
105
+ featuresIndex: { /* assets/data/features-index.json */ },
106
+ sealSvg: "<svg ...>...</svg>",
107
+ sealMiniSvg: "<svg ...>...</svg>",
108
+ seedShort: "primeiros 8 chars do seed.hash",
109
+ nav: [
110
+ {"id": "index", "href": "index.html", "label": "Visão geral"},
111
+ {"id": "arquitetura", "href": "arquitetura.html", "label": "Arquitetura 3D"}
112
+ ],
113
+ config: {
114
+ "visualStyle": "exploratory",
115
+ "readerProfile": "stakeholder",
116
+ "depth": "full"
117
+ }
118
+ };
119
+ ```
120
+
121
+ Procedimento:
122
+
123
+ 1. Liste os JSONs em `_reversa_docs/assets/data/` produzidos pelos agentes anteriores. Se algum esperado estiver ausente, registre a chave correspondente como `{}` (ou `null`) e siga.
124
+ 2. Leia cada JSON e embed o conteúdo direto no script (sem `JSON.parse(...)` em runtime, deixe o objeto já pronto). Quando o JSON for grande (acima de 200 KB), avalie minificar e ainda assim manter inline. Não comprima.
125
+ 3. Embed também `seal.svg` e `seal-mini.svg` como strings (`sealSvg`, `sealMiniSvg`).
126
+ 4. Monte o array `nav` lendo `pagesGenerated` (atualizado até este ponto pelos outros agentes). Mapeamento padrão de rótulos:
127
+ | id | href | label |
128
+ |---|---|---|
129
+ | index | index.html | Visão geral |
130
+ | arquitetura | arquitetura.html | Arquitetura 3D |
131
+ | modulos | modulos.html | Módulos |
132
+ | topologia | topologia.html | Topologia |
133
+ | metricas | metricas.html | Métricas |
134
+ | timeline | timeline.html | Timeline |
135
+ | glossario | glossario.html | Glossário |
136
+ | deck | deck.html | Deck |
137
+ 5. Salve em `_reversa_docs/assets/js/data.js`.
138
+ 6. Garanta que `viewer.html` (e portanto todas as páginas que herdam dele) carrega `<script src="assets/js/data.js"></script>` **antes** de `nav.js`. Se uma página foi gerada por agente anterior sem essa referência, injete a tag logo no início de `<!-- SCRIPTS -->` (ou no `<head>` se necessário) ao reescrever a página no passo 5.
139
+
140
+ > Diretiva absoluta para todos os agentes do time: **nenhuma página pode chamar `fetch("assets/data/...")` ou `fetch("assets/img/...")` ou qualquer URL local**. Os JSONs em `assets/data/` continuam existindo como fonte intermediária e para regeneração granular, mas as páginas HTML só consomem `window.RV_DATA`.
141
+
142
+ ### 4. Injetar mini-selo e nav retroativamente
143
+
144
+ Para cada página HTML existente em `_reversa_docs/` (exceto `index.html` que será gerado depois):
145
+
146
+ 1. Leia o conteúdo da página.
147
+ 2. Localize o marcador `<!-- MINI_SEAL_SVG -->` no header e substitua pelo conteúdo de `seal-mini.svg`.
148
+ 3. Localize o marcador `<!-- NAV_LINKS -->` e substitua por `<a>` tags geradas a partir de `window.RV_DATA.nav`. Cada link com `href`, `data-page-id` e o `label`. A página atual recebe `aria-current="page"` adicionado depois pelo `nav.js`.
149
+ 4. Garanta que `<script src="assets/js/data.js"></script>` aparece **antes** de `<script src="assets/js/nav.js"></script>`.
150
+ 5. Reescreva a página.
151
+
152
+ Se o marcador já foi substituído numa execução anterior (não há `<!-- MINI_SEAL_SVG -->` literal mas há `<svg class="seal-mini">`), substitua o `<svg>` anterior pelo novo. Mesmo princípio para `NAV_LINKS`: detectar bloco `<nav class="reversa-doc-nav">...</nav>` e substituir conteúdo interno. Isso garante idempotência em regenerações.
153
+
154
+ ### 5. Auto-discovery de HTMLs auxiliares
155
+
156
+ Configuração em `references/auxiliary_sources.yaml`. Resumo:
157
+
158
+ - **Raízes**: `_reversa_sdd/` e `.reversa/` (excluindo `.reversa/_config/`, `.reversa/context/`).
159
+ - **Profundidade máxima**: 6 níveis.
160
+ - **Timeout**: 10 segundos no total.
161
+ - **Filtro**: apenas HTMLs com `<meta name="reversa-category" content="...">` no `<head>`.
162
+
163
+ Para cada HTML descoberto, extraia:
164
+ - `path` (relativo à raiz do projeto)
165
+ - `category` (do meta `reversa-category`: `review`, `design-system`, `diagram`)
166
+ - `producer` (do meta `reversa-producer-agent`)
167
+ - `generated_at` (do meta `reversa-generated-at`)
168
+ - `title` (do `<title>`)
169
+
170
+ Se varredura excede timeout, aborte com aviso e indexe apenas o que descobriu até ali. Registre em `.state.json` campo `auxiliaryDiscoveryAborted: true`.
171
+
172
+ ### 6. Gerar `index.html`
173
+
174
+ Estrutura usando `templates/documentation/pages/index.html.tpl`:
175
+
176
+ 1. **Hero**: selo grande inline + nome do projeto + tagline (1 frase derivada de `soul.md` ou placeholder).
177
+ 2. **Sumário**: cards linkando para todas as páginas do time presentes em `_reversa_docs/`. Cada card tem ícone, título e 1 linha descritiva. Ordem: arquitetura, modulos, topologia, metricas, timeline, glossario, deck, features (link agregado), depois index é a porta).
178
+ 3. **Seções de auxiliares descobertos** (uma por categoria):
179
+ - **Code Reviews**: links para HTMLs com `category=review`
180
+ - **Design System**: links para HTMLs com `category=design-system`
181
+ - **Diagramas adicionais**: links para HTMLs com `category=diagram` que não foram gerados pelo Time Reversa Docs (filtre por `producer != reversa-docs-*`)
182
+ 4. Aplique chassis `viewer.html`:
183
+ - TITLE = "Índice"
184
+ - PAGE_ID = "index"
185
+ - REVERSA_CATEGORY = "index"
186
+ - REVERSA_PRODUCER_AGENT = "reversa-docs-publisher"
187
+ - REVERSA_TEMPLATE = "index"
188
+ - GENERATED_AT = ISO-8601 atual
189
+ 5. Salve em `_reversa_docs/index.html`.
190
+
191
+ ### 7. Validar links relativos e nav
192
+
193
+ Para cada link `<a href="...">` em `index.html` **e em cada `<nav>` das demais páginas**:
194
+ - Se o href é relativo, verifique se o destino existe em `_reversa_docs/` (ou no caminho relativo correspondente).
195
+ - Registre links quebrados em `.state.json` campo `brokenLinks: [{from, href, expected_path}]`.
196
+
197
+ O validador deve inspecionar tanto links estáticos quanto o conteúdo do `<nav>` injetado a partir de `window.RV_DATA.nav` (parse simples do bloco `<nav class="reversa-doc-nav">` em cada página).
198
+
199
+ Não aborte por links quebrados (gera mesmo assim), mas reporte no resumo final.
200
+
201
+ ### 8. Gerar placeholders para páginas omitidas (opcional, recomendado)
202
+
203
+ Para cada item em `pagesOmitted` que tem `href` mapeado em `nav`, gere uma página HTML mínima explicando por que foi omitida e como habilitar. Exemplo para `topologia.html`:
204
+
205
+ > Esta página seria gerada a partir de `_reversa_sdd/architecture.md` se ele declarasse variantes de topologia. Rode `/reversa-architect` com `--topology` para habilitar.
206
+
207
+ Use o chassis `viewer.html` normal e marque `<meta name="reversa-placeholder" content="true">` no `<head>` para inspeção futura. Isso evita links 404 no nav quando a omissão é estrutural.
208
+
209
+ ### 9. Smoke test antes do resumo (rede de segurança)
210
+
211
+ Antes de declarar sucesso, o Publisher faz um teste real de carregamento das páginas. Implementação mínima recomendada (Python stdlib, multi-engine):
212
+
213
+ ```python
214
+ # 1. Subir http.server em porta efêmera apontando para _reversa_docs/
215
+ # 2. Para cada página em pagesGenerated:
216
+ # a. GET http://localhost:<porta>/<pagina>
217
+ # b. Verifique HTTP 200.
218
+ # c. Para cada <script src="..."> relativo (não http/https), faça GET e verifique 200.
219
+ # d. Faça grep no HTML por padrões conhecidos de erro: "is not defined",
220
+ # "Failed to fetch", "Erro ao carregar", "Access to fetch", "NetworkError".
221
+ # 3. Se algum check falhar, registre em .state.json:
222
+ # smokeTestFailed: true
223
+ # smokeTestErrors: [{page, kind, detail}]
224
+ # 4. Encerre o servidor.
225
+ ```
226
+
227
+ O smoke test cobre os 4 sintomas mais comuns desta categoria: CDN 404, asset local 404, símbolo JS ausente, fetch bloqueado. Não substitui um navegador real (não executa JS), mas pega 80% das regressões observadas em campo.
228
+
229
+ Se o ambiente não tem Python disponível, faça o equivalente mínimo: para cada `<script src="...">` com path relativo, verifique se o arquivo existe em disco. É um subset, mas cobre os erros 2 e 3.
230
+
231
+ Reporte no resumo final em destaque (vermelho ou prefixo `[FALHOU]`) se `smokeTestFailed = true`.
232
+
233
+ ### 10. Atualizar `.state.json` com telemetria final
234
+
235
+ Schema completo:
236
+
237
+ ```json
238
+ {
239
+ "schemaVersion": 1,
240
+ "startedAt": "ISO-8601 do primeiro agente",
241
+ "lastCheckpoint": "ISO-8601 agora",
242
+ "pipelineDurationMs": 12345,
243
+ "completedAgents": ["mapper", "analyst", "storyteller", "publisher"],
244
+ "pendingAgents": [],
245
+ "pages": {
246
+ "index.html": {"status": "created", "agent": "reversa-docs-publisher", "hash": "sha256:..."},
247
+ "arquitetura.html": {"status": "created", "agent": "reversa-docs-mapper", "hash": "sha256:..."}
248
+ },
249
+ "pagesGenerated": ["index.html", "arquitetura.html"],
250
+ "pagesOmitted": [{"page": "topologia.html", "reason": "topology not detected"}],
251
+ "auxiliaryHtmls": [
252
+ {"path": "_reversa_sdd/security/audit.html", "category": "review", "producer": "reversa-security-auditor"}
253
+ ],
254
+ "auxiliaryHtmlsDiscovered": 3,
255
+ "auxiliaryDiscoveryAborted": false,
256
+ "cdnFallbackUsed": false,
257
+ "cdnFallbackDetails": [],
258
+ "vendorMissing": [],
259
+ "smokeTestFailed": false,
260
+ "smokeTestErrors": [],
261
+ "brokenLinks": []
262
+ }
263
+ ```
264
+
265
+ ### 11. Sugestão contextual do próximo agente
266
+
267
+ Analise o estado do projeto e sugira o próximo passo natural:
268
+
269
+ | Sinal | Sugestão |
270
+ |---|---|
271
+ | Há `_reversa_sdd/` mas sem `_reversa_forward/` | `/reversa-forward` para começar a codificar |
272
+ | Há `_reversa_forward/` ativo | continuar o ciclo forward |
273
+ | Sem `.reversa/chronicle.md` | `/reversa-chronicler` para registrar histórico |
274
+ | Mini-site rodado pela primeira vez | sugerir compartilhar com o time |
275
+
276
+ ## Backup automático
277
+
278
+ `_reversa_docs/.backup-<YYYYMMDD-HHMMSS>/` antes de sobrescrever `index.html`, `seal.svg`, `seal-mini.svg`, ou qualquer página onde o mini-selo é injetado.
279
+
280
+ ## Diretiva non-destructive
281
+
282
+ Apenas escreve em `_reversa_docs/`. Auto-discovery só **lê** HTMLs em outros diretórios. Nunca modifica ou apaga HTMLs auxiliares dos outros agentes.
283
+
284
+ ## Tratamento gracioso
285
+
286
+ | Cenário | Comportamento |
287
+ |---|---|
288
+ | Nenhuma página existe ainda (greenfield) | Gera `index.html` mínimo com selo + tagline "Mini-site iniciado. Rode `/reversa` para extrair conhecimento e depois `/reversa-docs` para enriquecer." |
289
+ | Auto-discovery falha (timeout, IO error) | Aborta varredura, gera índice sem seção de auxiliares, marca `auxiliaryDiscoveryAborted: true`. |
290
+ | Skill `reversa-selo-generativo` ausente | Gera placeholder SVG simples (círculo com hash dos primeiros 6 chars do seed em texto). Não bloqueia. |
291
+ | `.config.json` ausente | Conduz entrevista mínima antes de seguir. |
292
+
293
+ ## Encerramento
294
+
295
+ > "[Nome], mini-site **pronto**.
296
+ >
297
+ > Caminho: `_reversa_docs/index.html`
298
+ >
299
+ > Estatísticas:
300
+ > - Páginas geradas pelo time: [N]
301
+ > - Páginas omitidas: [M] ([listar com razão])
302
+ > - HTMLs auxiliares descobertos: [K] ([breakdown por categoria])
303
+ > - Links quebrados: [B] (se houver)
304
+ > - Tempo total do pipeline: [T]s
305
+ > - CDN fallback usado: [sim/não]
306
+ > - Smoke test: [verde/FALHOU: [lista de falhas]]
307
+ >
308
+ > Como abrir:
309
+ > - **Duplo clique funciona** (Windows: `start _reversa_docs/index.html`, macOS: `open ...`, Linux: `xdg-open ...`). Como o Publisher embedou dados em `assets/js/data.js` e baixou vendor offline, o mini-site abre via `file://` sem CORS.
310
+ > - **Para hot-reload** durante edição: `python -m http.server 8080` na pasta `_reversa_docs/` e acesse `http://localhost:8080/`.
311
+ >
312
+ > Próximo agente sugerido: [contextual conforme tabela acima]
313
+ >
314
+ > Digite **CONTINUAR** para prosseguir, ou apenas feche para sair."
315
+
316
+ ## Regras absolutas
317
+
318
+ - Nunca escreva fora de `_reversa_docs/`.
319
+ - Nunca modifique HTMLs auxiliares descobertos em outros diretórios.
320
+ - Nunca rode varredura de credenciais.
321
+ - Sempre backup antes de sobrescrever.
322
+ - Auto-discovery respeita timeout e profundidade máxima estritamente.
323
+ - Texto em pt-br, sem travessão.
@@ -0,0 +1,5 @@
1
+ interface:
2
+ display_name: "Reversa Docs Publisher"
3
+ short_description: "Editor-chefe do Time Reversa Docs"
4
+ policy:
5
+ allow_implicit_invocation: false
@@ -0,0 +1,27 @@
1
+ # Diretórios varridos pelo Publisher em auto-discovery de HTMLs auxiliares.
2
+ # HTMLs encontrados precisam ter <meta name="reversa-category" content="..."> para serem indexados.
3
+
4
+ scan_roots:
5
+ - path: "_reversa_sdd/"
6
+ description: "Specs SDD e outputs dos agentes de Descoberta e Migração."
7
+ - path: ".reversa/"
8
+ description: "Artefatos transversais do core."
9
+ exclude:
10
+ - "_reversa_docs/"
11
+ - ".reversa/_config/"
12
+ - ".reversa/context/"
13
+
14
+ categories:
15
+ - id: review
16
+ label: "Code Reviews"
17
+ description: "Annotated PRs gerados pelo reversa-reviewer e similares."
18
+ - id: design-system
19
+ label: "Design System"
20
+ description: "Living Design System do reversa-design-system."
21
+ - id: diagram
22
+ label: "Diagramas"
23
+ description: "Annotated Flowcharts e arquiteturas adicionais."
24
+
25
+ limits:
26
+ max_depth: 6
27
+ timeout_seconds: 10
@@ -0,0 +1,149 @@
1
+ # vendor-pins.yaml
2
+ #
3
+ # Matriz oficial de bibliotecas de terceiros usadas pelas páginas geradas pelo
4
+ # Time Reversa Docs. O Publisher consome este arquivo no passo "Bundle vendor
5
+ # local" para baixar cada lib em assets/vendor/ antes de renderizar qualquer
6
+ # página, garantindo que o mini-site funcione 100% offline e via file://.
7
+ #
8
+ # Regras:
9
+ # - "version" é o pin canônico. Não mude major/minor sem revisar todas as
10
+ # skills que dependem da combinação (Code City, force-directed, dashboards).
11
+ # - "format" pode ser "iife" (compatível com <script src>) ou "esm" (precisa
12
+ # de importmap + <script type=module>). Hoje fixamos tudo em IIFE para que
13
+ # duplo clique no Windows funcione sem dependência de bundler.
14
+ # - "compatible_with" declara dependências entre libs. Use para detectar
15
+ # combinações inválidas (ex: OrbitControls de r158 não roda como IIFE).
16
+ # - "files[].url" é a primeira tentativa. Se ela falhar (HEAD != 200), o
17
+ # Publisher percorre "fallbacks" na ordem. Sempre prefira pelo menos 2
18
+ # CDNs por arquivo: unpkg + jsdelivr cobrem 99% das falhas observadas.
19
+ # - "local" é o caminho relativo dentro de _reversa_docs/. Os
20
+ # templates HTML referenciam exatamente esse caminho via <script src>.
21
+
22
+ schema_version: 1
23
+
24
+ libs:
25
+
26
+ three:
27
+ version: "0.147.0"
28
+ format: iife
29
+ notes: >
30
+ Travado em 0.147 porque é a última release que ainda publica OrbitControls
31
+ em formato IIFE (examples/js/controls/). A partir de 0.150 só existe a
32
+ versão ES module em examples/jsm/, que exige importmap. Migrar para 0.158+
33
+ com importmap é trabalho futuro e está documentado no Erro 3 do relatório
34
+ de campo (specs/erros_em_docs.md).
35
+ files:
36
+ - url: "https://unpkg.com/three@0.147.0/build/three.min.js"
37
+ local: "assets/vendor/three.min.js"
38
+ fallbacks:
39
+ - "https://cdn.jsdelivr.net/npm/three@0.147.0/build/three.min.js"
40
+ - "https://cdnjs.cloudflare.com/ajax/libs/three.js/0.147.0/three.min.js"
41
+
42
+ orbit_controls:
43
+ version: "0.147.0"
44
+ format: iife
45
+ compatible_with: ["three@0.147.0"]
46
+ notes: >
47
+ Versão IIFE de OrbitControls, descontinuada a partir de three@0.150.
48
+ Mantida via raw.githubusercontent (mais estável que mirrors de CDN para
49
+ arquivos que não fazem parte do bundle oficial npm).
50
+ files:
51
+ - url: "https://raw.githubusercontent.com/mrdoob/three.js/r147/examples/js/controls/OrbitControls.js"
52
+ local: "assets/vendor/OrbitControls.js"
53
+ fallbacks:
54
+ - "https://cdn.jsdelivr.net/gh/mrdoob/three.js@r147/examples/js/controls/OrbitControls.js"
55
+
56
+ d3:
57
+ version: "7.8.5"
58
+ format: iife
59
+ files:
60
+ - url: "https://cdn.jsdelivr.net/npm/d3@7.8.5/dist/d3.min.js"
61
+ local: "assets/vendor/d3.v7.min.js"
62
+ fallbacks:
63
+ - "https://unpkg.com/d3@7.8.5/dist/d3.min.js"
64
+ - "https://d3js.org/d3.v7.min.js"
65
+
66
+ highcharts:
67
+ version: "11.4.8"
68
+ format: iife
69
+ notes: >
70
+ Core do Highcharts. Os módulos (treemap, sankey, etc) devem ser da MESMA
71
+ versão para não disparar warning de compat no console.
72
+ files:
73
+ - url: "https://code.highcharts.com/11.4.8/highcharts.js"
74
+ local: "assets/vendor/highcharts.js"
75
+ fallbacks:
76
+ - "https://cdn.jsdelivr.net/npm/highcharts@11.4.8/highcharts.js"
77
+ - "https://unpkg.com/highcharts@11.4.8/highcharts.js"
78
+
79
+ highcharts_accessibility:
80
+ version: "11.4.8"
81
+ format: iife
82
+ compatible_with: ["highcharts@11.4.8"]
83
+ files:
84
+ - url: "https://code.highcharts.com/11.4.8/modules/accessibility.js"
85
+ local: "assets/vendor/highcharts-accessibility.js"
86
+ fallbacks:
87
+ - "https://cdn.jsdelivr.net/npm/highcharts@11.4.8/modules/accessibility.js"
88
+
89
+ highcharts_exporting:
90
+ version: "11.4.8"
91
+ format: iife
92
+ compatible_with: ["highcharts@11.4.8"]
93
+ files:
94
+ - url: "https://code.highcharts.com/11.4.8/modules/exporting.js"
95
+ local: "assets/vendor/highcharts-exporting.js"
96
+ fallbacks:
97
+ - "https://cdn.jsdelivr.net/npm/highcharts@11.4.8/modules/exporting.js"
98
+
99
+ highcharts_treemap:
100
+ version: "11.4.8"
101
+ format: iife
102
+ compatible_with: ["highcharts@11.4.8"]
103
+ files:
104
+ - url: "https://code.highcharts.com/11.4.8/modules/treemap.js"
105
+ local: "assets/vendor/highcharts-treemap.js"
106
+ fallbacks:
107
+ - "https://cdn.jsdelivr.net/npm/highcharts@11.4.8/modules/treemap.js"
108
+
109
+ highcharts_sankey:
110
+ version: "11.4.8"
111
+ format: iife
112
+ compatible_with: ["highcharts@11.4.8"]
113
+ files:
114
+ - url: "https://code.highcharts.com/11.4.8/modules/sankey.js"
115
+ local: "assets/vendor/highcharts-sankey.js"
116
+ fallbacks:
117
+ - "https://cdn.jsdelivr.net/npm/highcharts@11.4.8/modules/sankey.js"
118
+
119
+ highcharts_timeline:
120
+ version: "11.4.8"
121
+ format: iife
122
+ compatible_with: ["highcharts@11.4.8"]
123
+ notes: >
124
+ Usado pelo Analyst quando há chronicle.md para gerar timeline.html.
125
+ files:
126
+ - url: "https://code.highcharts.com/11.4.8/modules/timeline.js"
127
+ local: "assets/vendor/highcharts-timeline.js"
128
+ fallbacks:
129
+ - "https://cdn.jsdelivr.net/npm/highcharts@11.4.8/modules/timeline.js"
130
+
131
+ # Combinações declaradamente inválidas. O Publisher rejeita estas combinações
132
+ # se alguém tentar mudar via override.
133
+ invalid_combinations:
134
+ - three: "0.158.0"
135
+ orbit_controls: "0.147.0"
136
+ reason: "OrbitControls IIFE foi removido em three@0.150+. Use three@0.147 com OrbitControls r147 ou migre tudo para ESM com importmap."
137
+ - three: "0.147.0"
138
+ orbit_controls: "0.158.0"
139
+ reason: "API de OrbitControls mudou na trilha ESM-only; r158 não roda como IIFE."
140
+
141
+ # Tabela de uso: qual skill usa qual lib. Mantenha sincronizada quando
142
+ # adicionar/remover skills ou libs. O Publisher usa isso para decidir o que
143
+ # baixar mesmo quando uma página específica é regenerada isolada.
144
+ usage:
145
+ reversa-arquitetura-3d: [three, orbit_controls]
146
+ reversa-especialista-d3: [d3]
147
+ reversa-highcharts-visualizer:
148
+ [highcharts, highcharts_accessibility, highcharts_exporting,
149
+ highcharts_treemap, highcharts_sankey, highcharts_timeline]