@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.
- package/LICENSE +21 -0
- package/README.md +487 -2
- package/agents/fg-backlog/SKILL.md +129 -0
- package/agents/fg-backlog/agents/openai.yaml +5 -0
- package/agents/fg-backlog/references/backlog-template.md +60 -0
- package/agents/fg-backlog/references/priorizacao.md +41 -0
- package/agents/impeccable/LICENSE +191 -0
- package/agents/impeccable/NOTICE.md +11 -0
- package/agents/impeccable/SKILL.md +88 -0
- package/agents/impeccable/agents/impeccable_asset_producer.toml +47 -0
- package/agents/impeccable/agents/impeccable_documenter.toml +27 -0
- package/agents/impeccable/agents/impeccable_finish_reviewer.toml +41 -0
- package/agents/impeccable/agents/impeccable_manual_edit_applier.toml +95 -0
- package/agents/impeccable/agents/openai.yaml +4 -0
- package/agents/impeccable/reference/adapt.md +318 -0
- package/agents/impeccable/reference/adapt.native.md +58 -0
- package/agents/impeccable/reference/android.md +46 -0
- package/agents/impeccable/reference/animate.md +89 -0
- package/agents/impeccable/reference/audit.md +139 -0
- package/agents/impeccable/reference/audit.native.md +139 -0
- package/agents/impeccable/reference/bolder.md +33 -0
- package/agents/impeccable/reference/clarify.md +94 -0
- package/agents/impeccable/reference/colorize.md +86 -0
- package/agents/impeccable/reference/component-review.md +63 -0
- package/agents/impeccable/reference/craft-floor.md +44 -0
- package/agents/impeccable/reference/craft.md +5 -0
- package/agents/impeccable/reference/critique.md +819 -0
- package/agents/impeccable/reference/degraded/asset-producer.md +42 -0
- package/agents/impeccable/reference/degraded/documenter.md +24 -0
- package/agents/impeccable/reference/degraded/finish-reviewer.md +38 -0
- package/agents/impeccable/reference/degraded/manual-edit-applier.md +92 -0
- package/agents/impeccable/reference/delight.md +70 -0
- package/agents/impeccable/reference/distill.md +111 -0
- package/agents/impeccable/reference/doctor.md +54 -0
- package/agents/impeccable/reference/document.md +416 -0
- package/agents/impeccable/reference/extract.md +69 -0
- package/agents/impeccable/reference/generate.md +101 -0
- package/agents/impeccable/reference/harden.md +343 -0
- package/agents/impeccable/reference/hooks.md +113 -0
- package/agents/impeccable/reference/init.md +131 -0
- package/agents/impeccable/reference/ios.md +51 -0
- package/agents/impeccable/reference/layout.md +84 -0
- package/agents/impeccable/reference/live-setup.md +104 -0
- package/agents/impeccable/reference/live.md +325 -0
- package/agents/impeccable/reference/mode-operate.md +21 -0
- package/agents/impeccable/reference/mode-persuade.md +19 -0
- package/agents/impeccable/reference/mode-read.md +21 -0
- package/agents/impeccable/reference/new-work.md +154 -0
- package/agents/impeccable/reference/onboard.md +234 -0
- package/agents/impeccable/reference/operate.md +61 -0
- package/agents/impeccable/reference/optimize.md +258 -0
- package/agents/impeccable/reference/overdrive.md +127 -0
- package/agents/impeccable/reference/polish.md +105 -0
- package/agents/impeccable/reference/quieter.md +99 -0
- package/agents/impeccable/reference/region-map.md +26 -0
- package/agents/impeccable/reference/routing.md +24 -0
- package/agents/impeccable/reference/shape.md +59 -0
- package/agents/impeccable/reference/typeset.md +90 -0
- package/agents/impeccable/reference/visualize.md +47 -0
- package/agents/impeccable/reversa-bundle.json +16 -0
- package/agents/impeccable/scripts/VERSION +1 -0
- package/agents/impeccable/scripts/command-metadata.json +98 -0
- package/agents/impeccable/scripts/data/font-index-failures.json +121 -0
- package/agents/impeccable/scripts/data/font-index.json +1 -0
- package/agents/impeccable/scripts/impeccable +212 -0
- package/agents/impeccable/scripts/impeccable.cmd +239 -0
- package/agents/impeccable/scripts/live-browser-dom.js +320 -0
- package/agents/impeccable/scripts/live-browser-ignores.js +242 -0
- package/agents/impeccable/scripts/live-browser-session.js +180 -0
- package/agents/impeccable/scripts/live-browser.js +13557 -0
- package/agents/impeccable/scripts/modern-screenshot.umd.js +14 -0
- package/agents/reversa/SKILL.md +135 -0
- package/agents/reversa/agents/openai.yaml +3 -0
- package/agents/reversa/references/checkpoint-guide.md +106 -0
- package/agents/reversa/references/state-schema.md +80 -0
- package/agents/reversa/references/step-01-first-run.md +63 -0
- package/agents/reversa/references/step-02-resume.md +88 -0
- package/agents/reversa/references/step-03-specs-organization.md +145 -0
- package/agents/reversa/references/step-04-regression-check.md +94 -0
- package/agents/reversa-add/SKILL.md +131 -0
- package/agents/reversa-add/agents/openai.yaml +5 -0
- package/agents/reversa-agents-help/SKILL.md +211 -0
- package/agents/reversa-agents-help/agents/openai.yaml +3 -0
- package/agents/reversa-arbiter/SKILL.md +140 -0
- package/agents/reversa-arbiter/agents/openai.yaml +5 -0
- package/agents/reversa-archaeologist/SKILL.md +95 -0
- package/agents/reversa-archaeologist/agents/openai.yaml +5 -0
- package/agents/reversa-archaeologist/references/modules-schema.md +69 -0
- package/agents/reversa-architect/SKILL.md +93 -0
- package/agents/reversa-architect/agents/openai.yaml +5 -0
- package/agents/reversa-arquitetura-3d/SKILL.md +163 -0
- package/agents/reversa-arquitetura-3d/agents/openai.yaml +5 -0
- package/agents/reversa-arquitetura-3d/references/ARCH_TOUR.md +242 -0
- package/agents/reversa-arquitetura-3d/references/CALL_GRAPH_3D.md +217 -0
- package/agents/reversa-arquitetura-3d/references/CODE_CITY.md +228 -0
- package/agents/reversa-arquitetura-3d/references/DEPENDENCY_GRAPH_3D.md +240 -0
- package/agents/reversa-arquitetura-3d/references/ERRORS.md +286 -0
- package/agents/reversa-arquitetura-3d/references/LAYER_STACK.md +230 -0
- package/agents/reversa-arquitetura-3d/references/THREE_PATTERNS.md +221 -0
- package/agents/reversa-audit/SKILL.md +98 -0
- package/agents/reversa-audit/agents/openai.yaml +5 -0
- package/agents/reversa-autonomous/SKILL.md +139 -0
- package/agents/reversa-autonomous/agents/openai.yaml +3 -0
- package/agents/reversa-brainstorm/SKILL.md +131 -0
- package/agents/reversa-brainstorm/agents/openai.yaml +3 -0
- package/agents/reversa-challenger/SKILL.md +122 -0
- package/agents/reversa-challenger/agents/openai.yaml +5 -0
- package/agents/reversa-clarify/SKILL.md +103 -0
- package/agents/reversa-clarify/agents/openai.yaml +5 -0
- package/agents/reversa-code-express/SKILL.md +252 -0
- package/agents/reversa-code-express/agents/openai.yaml +5 -0
- package/agents/reversa-coding/SKILL.md +172 -0
- package/agents/reversa-coding/agents/openai.yaml +5 -0
- package/agents/reversa-curator/SKILL.md +133 -0
- package/agents/reversa-curator/agents/openai.yaml +5 -0
- package/agents/reversa-curator/references/decision-rubric.md +52 -0
- package/agents/reversa-curator/references/templates/discard_log.md +37 -0
- package/agents/reversa-curator/references/templates/target_business_rules.md +54 -0
- package/agents/reversa-data-master/SKILL.md +67 -0
- package/agents/reversa-data-master/agents/openai.yaml +5 -0
- package/agents/reversa-debugger/SKILL.md +178 -0
- package/agents/reversa-debugger/agents/openai.yaml +3 -0
- package/agents/reversa-debugger/references/bug-schema.md +123 -0
- package/agents/reversa-debugger/references/bugs-readme-template.md +76 -0
- package/agents/reversa-debugger-debate/SKILL.md +75 -0
- package/agents/reversa-debugger-debate/agents/openai.yaml +5 -0
- package/agents/reversa-debugger-debate/references/debate-protocol.md +102 -0
- package/agents/reversa-debugger-fix/SKILL.md +170 -0
- package/agents/reversa-debugger-fix/agents/openai.yaml +5 -0
- package/agents/reversa-debugger-graph/SKILL.md +94 -0
- package/agents/reversa-debugger-graph/agents/openai.yaml +5 -0
- package/agents/reversa-decouple/SKILL.md +78 -0
- package/agents/reversa-decouple/agents/openai.yaml +5 -0
- package/agents/reversa-depth-inspection/SKILL.md +99 -0
- package/agents/reversa-depth-inspection/agents/openai.yaml +5 -0
- package/agents/reversa-design-system/SKILL.md +77 -0
- package/agents/reversa-design-system/agents/openai.yaml +5 -0
- package/agents/reversa-designer/SKILL.md +217 -0
- package/agents/reversa-designer/agents/openai.yaml +5 -0
- package/agents/reversa-designer/references/paradigm-checklist.md +50 -0
- package/agents/reversa-designer/references/templates/data_migration_plan.md +80 -0
- package/agents/reversa-designer/references/templates/target_architecture.md +68 -0
- package/agents/reversa-designer/references/templates/target_data_model.md +64 -0
- package/agents/reversa-designer/references/templates/target_domain_model.md +62 -0
- package/agents/reversa-designer/references/templates/topology_decision.md +82 -0
- package/agents/reversa-detective/SKILL.md +82 -0
- package/agents/reversa-detective/agents/openai.yaml +5 -0
- package/agents/reversa-docs/SKILL.md +241 -0
- package/agents/reversa-docs/agents/openai.yaml +3 -0
- package/agents/reversa-docs/references/config-schema.json +108 -0
- package/agents/reversa-docs/references/expected_sources.yaml +60 -0
- package/agents/reversa-docs-analyst/SKILL.md +163 -0
- package/agents/reversa-docs-analyst/agents/openai.yaml +5 -0
- package/agents/reversa-docs-mapper/SKILL.md +167 -0
- package/agents/reversa-docs-mapper/agents/openai.yaml +5 -0
- package/agents/reversa-docs-mapper/references/extraction-policy.md +44 -0
- package/agents/reversa-docs-publisher/SKILL.md +323 -0
- package/agents/reversa-docs-publisher/agents/openai.yaml +5 -0
- package/agents/reversa-docs-publisher/references/auxiliary_sources.yaml +27 -0
- package/agents/reversa-docs-publisher/references/vendor-pins.yaml +149 -0
- package/agents/reversa-docs-storyteller/SKILL.md +189 -0
- package/agents/reversa-docs-storyteller/agents/openai.yaml +5 -0
- package/agents/reversa-drafter/SKILL.md +189 -0
- package/agents/reversa-drafter/agents/openai.yaml +5 -0
- package/agents/reversa-especialista-d3/SKILL.md +37 -0
- package/agents/reversa-especialista-d3/agents/openai.yaml +5 -0
- package/agents/reversa-especialista-d3/references/api-core.md +13 -0
- package/agents/reversa-especialista-d3/references/interatividade.md +5 -0
- package/agents/reversa-especialista-d3/references/layouts-complexos.md +8 -0
- package/agents/reversa-explorer/SKILL.md +110 -0
- package/agents/reversa-explorer/agents/openai.yaml +5 -0
- package/agents/reversa-extract-soul/SKILL.md +221 -0
- package/agents/reversa-extract-soul/agents/openai.yaml +5 -0
- package/agents/reversa-forward/SKILL.md +235 -0
- package/agents/reversa-forward/agents/openai.yaml +3 -0
- package/agents/reversa-forward-autonomous/SKILL.md +184 -0
- package/agents/reversa-forward-autonomous/agents/openai.yaml +3 -0
- package/agents/reversa-framer/SKILL.md +124 -0
- package/agents/reversa-framer/agents/openai.yaml +5 -0
- package/agents/reversa-highcharts-visualizer/SKILL.md +123 -0
- package/agents/reversa-highcharts-visualizer/agents/openai.yaml +5 -0
- package/agents/reversa-highcharts-visualizer/references/CHART_CATALOG.md +450 -0
- package/agents/reversa-highcharts-visualizer/references/ERRORS.md +99 -0
- package/agents/reversa-highcharts-visualizer/references/HIGHCHARTS_PATTERNS.md +347 -0
- package/agents/reversa-highcharts-visualizer/scripts/analyze_data.py +219 -0
- package/agents/reversa-highcharts-visualizer/scripts/parse_data.py +246 -0
- package/agents/reversa-highcharts-visualizer/scripts/sample_data.py +208 -0
- package/agents/reversa-ideator/SKILL.md +139 -0
- package/agents/reversa-ideator/agents/openai.yaml +5 -0
- package/agents/reversa-image-prompt-json/SKILL.md +210 -0
- package/agents/reversa-image-prompt-json/agents/openai.yaml +5 -0
- package/agents/reversa-image-prompt-json/references/Examples.md +123 -0
- package/agents/reversa-inspector/SKILL.md +147 -0
- package/agents/reversa-inspector/agents/openai.yaml +5 -0
- package/agents/reversa-inspector/references/parity-coverage-matrix.md +54 -0
- package/agents/reversa-inspector/references/templates/parity_specs.md +64 -0
- package/agents/reversa-inspector/references/templates/parity_test.feature +40 -0
- package/agents/reversa-migrate/SKILL.md +282 -0
- package/agents/reversa-migrate/agents/openai.yaml +3 -0
- package/agents/reversa-migrate/references/auto-defaults.md +52 -0
- package/agents/reversa-migrate/references/expected_legacy_artifacts.yaml +69 -0
- package/agents/reversa-migrate/references/handoff-checklist.md +34 -0
- package/agents/reversa-migrate/references/state.json +28 -0
- package/agents/reversa-migrate/references/templates/ambiguity_log.md +43 -0
- package/agents/reversa-migrate/references/templates/handoff.md +91 -0
- package/agents/reversa-migrate/references/templates/migration_brief.md +52 -0
- package/agents/reversa-migrate/references/templates/pending_decisions.md +36 -0
- package/agents/reversa-modularize/SKILL.md +77 -0
- package/agents/reversa-modularize/agents/openai.yaml +5 -0
- package/agents/reversa-n8n/SKILL.md +256 -0
- package/agents/reversa-n8n/agents/openai.yaml +5 -0
- package/agents/reversa-n8n/references/node-catalog.md +245 -0
- package/agents/reversa-new/SKILL.md +328 -0
- package/agents/reversa-new/agents/openai.yaml +3 -0
- package/agents/reversa-optimize/SKILL.md +80 -0
- package/agents/reversa-optimize/agents/openai.yaml +5 -0
- package/agents/reversa-paradigm-advisor/SKILL.md +168 -0
- package/agents/reversa-paradigm-advisor/agents/openai.yaml +5 -0
- package/agents/reversa-paradigm-advisor/references/paradigm-catalog.md +73 -0
- package/agents/reversa-paradigm-advisor/references/templates/paradigm_decision.md +69 -0
- package/agents/reversa-plan/SKILL.md +92 -0
- package/agents/reversa-plan/agents/openai.yaml +5 -0
- package/agents/reversa-pre-spec/SKILL.md +133 -0
- package/agents/reversa-pre-spec/agents/openai.yaml +5 -0
- package/agents/reversa-pricing/SKILL.md +181 -0
- package/agents/reversa-pricing/agents/openai.yaml +3 -0
- package/agents/reversa-pricing-advisor/SKILL.md +322 -0
- package/agents/reversa-pricing-advisor/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-advisor/references/advisor-schema.json +196 -0
- package/agents/reversa-pricing-advisor/references/advisor-template.md +106 -0
- package/agents/reversa-pricing-advisor/references/sale-models.md +237 -0
- package/agents/reversa-pricing-estimate/SKILL.md +287 -0
- package/agents/reversa-pricing-estimate/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-estimate/references/effort-formula.md +146 -0
- package/agents/reversa-pricing-estimate/references/estimate-schema.json +141 -0
- package/agents/reversa-pricing-estimate/references/estimate-template.md +153 -0
- package/agents/reversa-pricing-estimate/references/example-estimate.json +74 -0
- package/agents/reversa-pricing-estimate/references/example-estimate.md +88 -0
- package/agents/reversa-pricing-estimate/references/market-benchmarks.md +102 -0
- package/agents/reversa-pricing-estimate/references/value-formula.md +123 -0
- package/agents/reversa-pricing-product/SKILL.md +299 -0
- package/agents/reversa-pricing-product/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-product/references/breakeven-formula.md +237 -0
- package/agents/reversa-pricing-product/references/product-schema.json +288 -0
- package/agents/reversa-pricing-product/references/product-template.md +113 -0
- package/agents/reversa-pricing-product/references/store-commissions.md +57 -0
- package/agents/reversa-pricing-profile/SKILL.md +390 -0
- package/agents/reversa-pricing-profile/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-profile/references/example-profile.json +23 -0
- package/agents/reversa-pricing-profile/references/example-profile.md +46 -0
- package/agents/reversa-pricing-profile/references/profile-schema.json +227 -0
- package/agents/reversa-pricing-profile/references/tax-regimes.md +106 -0
- package/agents/reversa-pricing-research/SKILL.md +352 -0
- package/agents/reversa-pricing-research/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-research/references/research-policy.md +213 -0
- package/agents/reversa-pricing-research/references/research-schema.json +330 -0
- package/agents/reversa-pricing-size/SKILL.md +205 -0
- package/agents/reversa-pricing-size/agents/openai.yaml +5 -0
- package/agents/reversa-pricing-size/references/example-size.json +41 -0
- package/agents/reversa-pricing-size/references/size-schema.json +120 -0
- package/agents/reversa-pricing-size/references/sizing-formula.md +183 -0
- package/agents/reversa-principles/SKILL.md +82 -0
- package/agents/reversa-principles/agents/openai.yaml +5 -0
- package/agents/reversa-prune/SKILL.md +85 -0
- package/agents/reversa-prune/agents/openai.yaml +5 -0
- package/agents/reversa-quality/SKILL.md +87 -0
- package/agents/reversa-quality/agents/openai.yaml +5 -0
- package/agents/reversa-reconstructor/SKILL.md +243 -0
- package/agents/reversa-reconstructor/agents/openai.yaml +5 -0
- package/agents/reversa-reconstructor/references/reconstruction-plan-migration-template.md +89 -0
- package/agents/reversa-reconstructor/references/reconstruction-plan-template.md +77 -0
- package/agents/reversa-refactor/SKILL.md +112 -0
- package/agents/reversa-refactor/agents/openai.yaml +3 -0
- package/agents/reversa-refactor/references/opportunity-schema.md +68 -0
- package/agents/reversa-refactor/references/refactor-readme-template.md +35 -0
- package/agents/reversa-requirements/SKILL.md +217 -0
- package/agents/reversa-requirements/agents/openai.yaml +5 -0
- package/agents/reversa-researcher/SKILL.md +136 -0
- package/agents/reversa-researcher/agents/openai.yaml +5 -0
- package/agents/reversa-restructure/SKILL.md +78 -0
- package/agents/reversa-restructure/agents/openai.yaml +5 -0
- package/agents/reversa-resume/SKILL.md +141 -0
- package/agents/reversa-resume/agents/openai.yaml +5 -0
- package/agents/reversa-reviewer/SKILL.md +163 -0
- package/agents/reversa-reviewer/agents/openai.yaml +5 -0
- package/agents/reversa-reviewer/references/confidence-report-template.md +73 -0
- package/agents/reversa-reviewer/references/confidence-rules.md +65 -0
- package/agents/reversa-reviewer/references/questions-template.md +74 -0
- package/agents/reversa-scout/SKILL.md +82 -0
- package/agents/reversa-scout/agents/openai.yaml +5 -0
- package/agents/reversa-scout/references/surface-schema.md +93 -0
- package/agents/reversa-screen-translator/SKILL.md +279 -0
- package/agents/reversa-screen-translator/agents/openai.yaml +5 -0
- package/agents/reversa-screen-translator/references/adapter-pairs.md +97 -0
- package/agents/reversa-screen-translator/references/platform-detection.md +73 -0
- package/agents/reversa-screen-translator/references/templates/golden_manifest.yaml +62 -0
- package/agents/reversa-screen-translator/references/templates/inventory.schema.json +132 -0
- package/agents/reversa-screen-translator/references/templates/screen_deviation_log.md +66 -0
- package/agents/reversa-screen-translator/references/templates/screen_modernization_decision.md +106 -0
- package/agents/reversa-screen-translator/references/templates/target_screens.md +206 -0
- package/agents/reversa-selo-generativo/SKILL.md +176 -0
- package/agents/reversa-selo-generativo/agents/openai.yaml +5 -0
- package/agents/reversa-selo-generativo/references/ERRORS.md +212 -0
- package/agents/reversa-selo-generativo/references/GENERATIVE_PATTERNS.md +365 -0
- package/agents/reversa-selo-generativo/references/PALETTE_BY_STYLE.md +176 -0
- package/agents/reversa-simplify/SKILL.md +79 -0
- package/agents/reversa-simplify/agents/openai.yaml +5 -0
- package/agents/reversa-spec-sdd/SKILL.md +278 -0
- package/agents/reversa-spec-sdd/agents/openai.yaml +5 -0
- package/agents/reversa-spec-sdd/assets/spec_examples.md +159 -0
- package/agents/reversa-spec-sdd/references/evaluation_rubric.md +113 -0
- package/agents/reversa-spec-sdd/references/sdd_guide.md +124 -0
- package/agents/reversa-spec-sdd/references/spec_template.md +231 -0
- package/agents/reversa-spec-sdd/scripts/spec_scorer.py +476 -0
- package/agents/reversa-standardize/SKILL.md +76 -0
- package/agents/reversa-standardize/agents/openai.yaml +5 -0
- package/agents/reversa-strategist/SKILL.md +119 -0
- package/agents/reversa-strategist/agents/openai.yaml +5 -0
- package/agents/reversa-strategist/references/migration-strategies.md +41 -0
- package/agents/reversa-strategist/references/templates/cutover_plan.md +60 -0
- package/agents/reversa-strategist/references/templates/migration_strategy.md +55 -0
- package/agents/reversa-strategist/references/templates/risk_register.md +44 -0
- package/agents/reversa-sync/SKILL.md +100 -0
- package/agents/reversa-sync/agents/openai.yaml +5 -0
- package/agents/reversa-to-do/SKILL.md +89 -0
- package/agents/reversa-to-do/agents/openai.yaml +5 -0
- package/agents/reversa-visor/SKILL.md +91 -0
- package/agents/reversa-visor/agents/openai.yaml +5 -0
- package/agents/reversa-writer/SKILL.md +212 -0
- package/agents/reversa-writer/agents/openai.yaml +5 -0
- package/agents/reversa-writer/references/design-template.md +49 -0
- package/agents/reversa-writer/references/requirements-template.md +62 -0
- package/agents/reversa-writer/references/tasks-template.md +39 -0
- package/bin/reversa.js +65 -0
- package/lib/commands/add-engine.js +97 -0
- package/lib/commands/export-diagrams.js +194 -0
- package/lib/commands/install.js +260 -0
- package/lib/commands/status.js +35 -0
- package/lib/commands/uninstall.js +159 -0
- package/lib/commands/update.js +252 -0
- package/lib/installer/bundled.js +42 -0
- package/lib/installer/detector.js +167 -0
- package/lib/installer/manifest.js +61 -0
- package/lib/installer/orange-prompts.js +13 -0
- package/lib/installer/policy.js +53 -0
- package/lib/installer/prompts.js +252 -0
- package/lib/installer/validator.js +22 -0
- package/lib/installer/writer.js +376 -0
- package/lib/utils/banner.js +35 -0
- package/lib/utils/json-safe.js +10 -0
- package/lib/utils/package-info.js +22 -0
- package/package.json +51 -4
- package/templates/config.toml +46 -0
- package/templates/config.user.toml +8 -0
- package/templates/documentation/assets/css/style.css +476 -0
- package/templates/documentation/assets/js/nav.js +141 -0
- package/templates/documentation/assets/js/sidebar.js +162 -0
- package/templates/documentation/demo/viewer-demo.html +200 -0
- package/templates/documentation/pages/arquitetura.html.tpl +36 -0
- package/templates/documentation/pages/deck.html.tpl +27 -0
- package/templates/documentation/pages/features/feature.html.tpl +44 -0
- package/templates/documentation/pages/glossario.html.tpl +30 -0
- package/templates/documentation/pages/index.html.tpl +32 -0
- package/templates/documentation/pages/metricas.html.tpl +43 -0
- package/templates/documentation/pages/modulos.html.tpl +33 -0
- package/templates/documentation/pages/timeline.html.tpl +33 -0
- package/templates/documentation/pages/topologia.html.tpl +31 -0
- package/templates/documentation/scripts/convert_chronicle.py +71 -0
- package/templates/documentation/scripts/convert_soul.py +73 -0
- package/templates/documentation/scripts/extract_deps.py +54 -0
- package/templates/documentation/scripts/extract_modules.py +90 -0
- package/templates/documentation/scripts/list_specs.py +74 -0
- package/templates/documentation/viewer.html +60 -0
- package/templates/engines/AGENTS.md +26 -0
- package/templates/engines/CLAUDE.md +27 -0
- package/templates/engines/CONVENTIONS.md +26 -0
- package/templates/engines/GEMINI.md +26 -0
- package/templates/engines/amazonq +7 -0
- package/templates/engines/clinerules +7 -0
- package/templates/engines/copilot-instructions +26 -0
- package/templates/engines/cursorrules +7 -0
- package/templates/engines/roorules +7 -0
- package/templates/engines/windsurf +7 -0
- package/templates/forward/body/actions-template.md +83 -0
- package/templates/forward/body/principles-template.md +75 -0
- package/templates/forward/body/quality-template.md +103 -0
- package/templates/forward/body/requirements-template.md +121 -0
- package/templates/forward/body/roadmap-template.md +107 -0
- package/templates/forward/hooks.yml +60 -0
- package/templates/forward/scripts/ps/bind-to-extraction.ps1 +71 -0
- package/templates/forward/scripts/ps/prepare-roadmap.ps1 +84 -0
- package/templates/forward/scripts/ps/verify-prerequisites.ps1 +103 -0
- package/templates/forward/scripts/sh/bind-to-extraction.sh +103 -0
- package/templates/forward/scripts/sh/prepare-roadmap.sh +79 -0
- package/templates/forward/scripts/sh/verify-prerequisites.sh +125 -0
- package/templates/forward/setup.json +24 -0
- package/templates/hooks/README.md +41 -0
- package/templates/hooks/check-legacy-policy.mjs +0 -0
- package/templates/migration/artifacts/ambiguity_log.md +43 -0
- package/templates/migration/artifacts/cutover_plan.md +60 -0
- package/templates/migration/artifacts/data_migration_plan.md +80 -0
- package/templates/migration/artifacts/discard_log.md +37 -0
- package/templates/migration/artifacts/handoff.md +76 -0
- package/templates/migration/artifacts/migration_brief.md +52 -0
- package/templates/migration/artifacts/migration_strategy.md +55 -0
- package/templates/migration/artifacts/paradigm_decision.md +69 -0
- package/templates/migration/artifacts/parity_specs.md +64 -0
- package/templates/migration/artifacts/parity_test.feature +40 -0
- package/templates/migration/artifacts/pending_decisions.md +36 -0
- package/templates/migration/artifacts/risk_register.md +44 -0
- package/templates/migration/artifacts/target_architecture.md +68 -0
- package/templates/migration/artifacts/target_business_rules.md +54 -0
- package/templates/migration/artifacts/target_data_model.md +64 -0
- package/templates/migration/artifacts/target_domain_model.md +62 -0
- package/templates/migration/catalogs/migration_strategies.md +101 -0
- package/templates/migration/catalogs/paradigm_catalog.md +101 -0
- package/templates/migration/expected_legacy_artifacts.yaml +77 -0
- package/templates/migration/state.json +28 -0
- package/templates/plan.md +65 -0
- package/templates/reversa-config.json +5 -0
- 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,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]
|