@flaviogarrido/reversa 0.0.0-stage → 1.3.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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,240 @@
|
|
|
1
|
+
# Dependency Graph 3D
|
|
2
|
+
|
|
3
|
+
Grafo orientado de dependências entre módulos visualizado em 3D, com simulação de forças (atração entre nós conectados, repulsão entre não conectados) que distribui o grafo no espaço de forma orgânica.
|
|
4
|
+
|
|
5
|
+
## Mapeamento
|
|
6
|
+
|
|
7
|
+
| Atributo do código | Atributo visual do nó |
|
|
8
|
+
|---|---|
|
|
9
|
+
| Módulo | Esfera ou ícone |
|
|
10
|
+
| Tamanho (LOC ou número de dependentes) | Raio da esfera |
|
|
11
|
+
| Tipo do módulo | Cor |
|
|
12
|
+
| Pasta | Cor secundária ou cluster próximo |
|
|
13
|
+
| Aresta = `imports/requires` | Linha curva orientada (com seta) |
|
|
14
|
+
| Peso da aresta (frequência de uso) | Espessura da linha |
|
|
15
|
+
|
|
16
|
+
## Quando usar
|
|
17
|
+
|
|
18
|
+
- Detectar **acoplamento alto** (nós muito conectados ficam no centro do cluster).
|
|
19
|
+
- Identificar **módulos centrais** (alto fan-in) e **módulos isolados**.
|
|
20
|
+
- Visualizar **ciclos de dependência** (loops visíveis na simulação).
|
|
21
|
+
- Comparar coesão entre pastas (módulos da mesma pasta deveriam estar próximos).
|
|
22
|
+
|
|
23
|
+
**Quando evitar**: projetos com mais de ~300 módulos, onde o grafo vira hairball ilegível. Use Code City ou agrupe por pasta.
|
|
24
|
+
|
|
25
|
+
## Algoritmo de layout: força em 3D
|
|
26
|
+
|
|
27
|
+
Simulação tipo D3-force adaptada para 3 dimensões. Roda em loop até estabilizar, depois congela.
|
|
28
|
+
|
|
29
|
+
```javascript
|
|
30
|
+
const nodes = deps.nodes.map((n) => ({
|
|
31
|
+
id: n.id,
|
|
32
|
+
x: (Math.random() - 0.5) * 200,
|
|
33
|
+
y: (Math.random() - 0.5) * 200,
|
|
34
|
+
z: (Math.random() - 0.5) * 200,
|
|
35
|
+
vx: 0, vy: 0, vz: 0,
|
|
36
|
+
fx: 0, fy: 0, fz: 0,
|
|
37
|
+
mass: 1 + (n.loc ?? 0) / 100
|
|
38
|
+
}));
|
|
39
|
+
|
|
40
|
+
const edges = deps.edges.map((e) => ({
|
|
41
|
+
source: nodes.find((n) => n.id === e.from),
|
|
42
|
+
target: nodes.find((n) => n.id === e.to),
|
|
43
|
+
weight: e.weight ?? 1
|
|
44
|
+
}));
|
|
45
|
+
|
|
46
|
+
const REPULSION = 800;
|
|
47
|
+
const ATTRACTION = 0.04;
|
|
48
|
+
const CENTER_GRAVITY = 0.002;
|
|
49
|
+
const DAMPING = 0.85;
|
|
50
|
+
|
|
51
|
+
function simulationStep() {
|
|
52
|
+
nodes.forEach((n) => { n.fx = 0; n.fy = 0; n.fz = 0; });
|
|
53
|
+
|
|
54
|
+
// Repulsão entre todos os pares
|
|
55
|
+
for (let i = 0; i < nodes.length; i++) {
|
|
56
|
+
for (let j = i + 1; j < nodes.length; j++) {
|
|
57
|
+
const a = nodes[i], b = nodes[j];
|
|
58
|
+
const dx = b.x - a.x, dy = b.y - a.y, dz = b.z - a.z;
|
|
59
|
+
const distSq = dx * dx + dy * dy + dz * dz + 0.1;
|
|
60
|
+
const dist = Math.sqrt(distSq);
|
|
61
|
+
const force = REPULSION / distSq;
|
|
62
|
+
const fx = (dx / dist) * force;
|
|
63
|
+
const fy = (dy / dist) * force;
|
|
64
|
+
const fz = (dz / dist) * force;
|
|
65
|
+
a.fx -= fx; a.fy -= fy; a.fz -= fz;
|
|
66
|
+
b.fx += fx; b.fy += fy; b.fz += fz;
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
// Atração ao longo das arestas
|
|
71
|
+
edges.forEach((e) => {
|
|
72
|
+
const dx = e.target.x - e.source.x;
|
|
73
|
+
const dy = e.target.y - e.source.y;
|
|
74
|
+
const dz = e.target.z - e.source.z;
|
|
75
|
+
const f = ATTRACTION * e.weight;
|
|
76
|
+
e.source.fx += dx * f; e.source.fy += dy * f; e.source.fz += dz * f;
|
|
77
|
+
e.target.fx -= dx * f; e.target.fy -= dy * f; e.target.fz -= dz * f;
|
|
78
|
+
});
|
|
79
|
+
|
|
80
|
+
// Gravidade para o centro
|
|
81
|
+
nodes.forEach((n) => {
|
|
82
|
+
n.fx -= n.x * CENTER_GRAVITY;
|
|
83
|
+
n.fy -= n.y * CENTER_GRAVITY;
|
|
84
|
+
n.fz -= n.z * CENTER_GRAVITY;
|
|
85
|
+
});
|
|
86
|
+
|
|
87
|
+
// Integrar
|
|
88
|
+
nodes.forEach((n) => {
|
|
89
|
+
n.vx = (n.vx + n.fx / n.mass) * DAMPING;
|
|
90
|
+
n.vy = (n.vy + n.fy / n.mass) * DAMPING;
|
|
91
|
+
n.vz = (n.vz + n.fz / n.mass) * DAMPING;
|
|
92
|
+
n.x += n.vx;
|
|
93
|
+
n.y += n.vy;
|
|
94
|
+
n.z += n.vz;
|
|
95
|
+
});
|
|
96
|
+
}
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
Para grafos grandes (>200 nós), substituir repulsão O(n²) por **octree (Barnes-Hut)** para reduzir a O(n log n).
|
|
100
|
+
|
|
101
|
+
## Renderização dos nós
|
|
102
|
+
|
|
103
|
+
Usar `InstancedMesh` de esferas para até 1.000 nós; acima disso, billboard com sprites.
|
|
104
|
+
|
|
105
|
+
```javascript
|
|
106
|
+
const sphereGeo = new THREE.SphereGeometry(1, 16, 16);
|
|
107
|
+
const sphereMat = new THREE.MeshStandardMaterial({ roughness: 0.4 });
|
|
108
|
+
const nodeMesh = new THREE.InstancedMesh(sphereGeo, sphereMat, nodes.length);
|
|
109
|
+
nodeMesh.castShadow = true;
|
|
110
|
+
|
|
111
|
+
const dummy = new THREE.Object3D();
|
|
112
|
+
const color = new THREE.Color();
|
|
113
|
+
|
|
114
|
+
function updateNodes() {
|
|
115
|
+
nodes.forEach((n, i) => {
|
|
116
|
+
dummy.position.set(n.x, n.y, n.z);
|
|
117
|
+
const radius = 1 + Math.sqrt(n.mass) * 0.5;
|
|
118
|
+
dummy.scale.set(radius, radius, radius);
|
|
119
|
+
dummy.updateMatrix();
|
|
120
|
+
nodeMesh.setMatrixAt(i, dummy.matrix);
|
|
121
|
+
color.set(colorForNode(n));
|
|
122
|
+
nodeMesh.setColorAt(i, color);
|
|
123
|
+
});
|
|
124
|
+
nodeMesh.instanceMatrix.needsUpdate = true;
|
|
125
|
+
nodeMesh.instanceColor.needsUpdate = true;
|
|
126
|
+
}
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
## Renderização das arestas
|
|
130
|
+
|
|
131
|
+
Linhas curvas em 3D usando `BufferGeometry` com `LineSegments` ou `TubeGeometry` para arestas com volume.
|
|
132
|
+
|
|
133
|
+
```javascript
|
|
134
|
+
const edgePositions = new Float32Array(edges.length * 6);
|
|
135
|
+
const edgeGeo = new THREE.BufferGeometry();
|
|
136
|
+
edgeGeo.setAttribute("position", new THREE.BufferAttribute(edgePositions, 3));
|
|
137
|
+
const edgeMat = new THREE.LineBasicMaterial({ color: 0x4a9eff, transparent: true, opacity: 0.4 });
|
|
138
|
+
const edgeLines = new THREE.LineSegments(edgeGeo, edgeMat);
|
|
139
|
+
scene.add(edgeLines);
|
|
140
|
+
|
|
141
|
+
function updateEdges() {
|
|
142
|
+
edges.forEach((e, i) => {
|
|
143
|
+
edgePositions[i * 6 + 0] = e.source.x;
|
|
144
|
+
edgePositions[i * 6 + 1] = e.source.y;
|
|
145
|
+
edgePositions[i * 6 + 2] = e.source.z;
|
|
146
|
+
edgePositions[i * 6 + 3] = e.target.x;
|
|
147
|
+
edgePositions[i * 6 + 4] = e.target.y;
|
|
148
|
+
edgePositions[i * 6 + 5] = e.target.z;
|
|
149
|
+
});
|
|
150
|
+
edgeGeo.attributes.position.needsUpdate = true;
|
|
151
|
+
}
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
Para arestas orientadas com seta visível, usar `ArrowHelper` ou pequenos cones próximos ao target.
|
|
155
|
+
|
|
156
|
+
## Loop de simulação + renderização
|
|
157
|
+
|
|
158
|
+
```javascript
|
|
159
|
+
let frame = 0;
|
|
160
|
+
const MAX_SIM_FRAMES = 400; // estabiliza após ~7s em 60fps
|
|
161
|
+
function tick() {
|
|
162
|
+
if (frame < MAX_SIM_FRAMES) {
|
|
163
|
+
simulationStep();
|
|
164
|
+
updateNodes();
|
|
165
|
+
updateEdges();
|
|
166
|
+
frame++;
|
|
167
|
+
}
|
|
168
|
+
controls.update();
|
|
169
|
+
renderer.render(scene, camera);
|
|
170
|
+
requestAnimationFrame(tick);
|
|
171
|
+
}
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
Depois de estabilizar, manter renderização mas pausar simulação para economizar CPU.
|
|
175
|
+
|
|
176
|
+
## Detecção de ciclos
|
|
177
|
+
|
|
178
|
+
Rodar Tarjan ou Kosaraju antes de renderizar; nós que pertencem a ciclos recebem cor especial (laranja) e suas arestas viram vermelhas.
|
|
179
|
+
|
|
180
|
+
```javascript
|
|
181
|
+
const cycles = findStronglyConnectedComponents(nodes, edges).filter((c) => c.length > 1);
|
|
182
|
+
cycles.flat().forEach((n) => n.inCycle = true);
|
|
183
|
+
edges.forEach((e) => {
|
|
184
|
+
e.inCycle = e.source.inCycle && e.target.inCycle;
|
|
185
|
+
});
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
## Sidebar de controles
|
|
189
|
+
|
|
190
|
+
```html
|
|
191
|
+
<aside id="sidebar">
|
|
192
|
+
<h3>Dependency Graph 3D</h3>
|
|
193
|
+
|
|
194
|
+
<label>Repulsão
|
|
195
|
+
<input type="range" min="100" max="2000" value="800" data-param="repulsion">
|
|
196
|
+
</label>
|
|
197
|
+
|
|
198
|
+
<label>Atração
|
|
199
|
+
<input type="range" min="0.01" max="0.2" step="0.01" value="0.04" data-param="attraction">
|
|
200
|
+
</label>
|
|
201
|
+
|
|
202
|
+
<label>Filtrar por pasta
|
|
203
|
+
<select data-param="folderFilter">
|
|
204
|
+
<option value="all">Todas</option>
|
|
205
|
+
</select>
|
|
206
|
+
</label>
|
|
207
|
+
|
|
208
|
+
<label>
|
|
209
|
+
<input type="checkbox" data-param="highlightCycles" checked> Destacar ciclos
|
|
210
|
+
</label>
|
|
211
|
+
|
|
212
|
+
<label>
|
|
213
|
+
<input type="checkbox" data-param="showLabels"> Labels visíveis
|
|
214
|
+
</label>
|
|
215
|
+
|
|
216
|
+
<button id="reset">Reset</button>
|
|
217
|
+
<button id="freeze">Congelar simulação</button>
|
|
218
|
+
<button id="export-png">Exportar PNG</button>
|
|
219
|
+
</aside>
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
Mudanças nos sliders reativam a simulação por mais 100 frames antes de congelar novamente.
|
|
223
|
+
|
|
224
|
+
## Interação
|
|
225
|
+
|
|
226
|
+
- **Hover em nó**: tooltip com nome, número de dependentes (fan-in), dependências (fan-out).
|
|
227
|
+
- **Clique em nó**: destaca o nó e suas arestas conectadas, desfoca os demais (opacity reduzida).
|
|
228
|
+
- **Duplo clique em nó**: foca câmera no nó.
|
|
229
|
+
- **Scroll**: zoom.
|
|
230
|
+
|
|
231
|
+
## Performance
|
|
232
|
+
|
|
233
|
+
| Nós | Estratégia |
|
|
234
|
+
|---|---|
|
|
235
|
+
| < 50 | Esferas individuais com `add()` |
|
|
236
|
+
| 50 a 500 | InstancedMesh + repulsão O(n²) |
|
|
237
|
+
| 500 a 2.000 | InstancedMesh + Barnes-Hut octree |
|
|
238
|
+
| > 2.000 | Agrupar por pasta antes (cada cluster = um meta-nó) |
|
|
239
|
+
|
|
240
|
+
Arestas: até **10.000** com LineSegments. Acima disso, simplificar (mostrar só as top N por peso) ou usar gradient de cor em vez de duplicar geometria.
|
|
@@ -0,0 +1,286 @@
|
|
|
1
|
+
# Cenários de Erro e Tratamento
|
|
2
|
+
|
|
3
|
+
Catálogo de erros comuns na skill `arquitetura-3d` e como tratá-los para preservar a experiência do usuário.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## ERR-01: Three.js indisponível (CDN inacessível)
|
|
8
|
+
|
|
9
|
+
**Causa**: usuário está offline na primeira execução, ou CDN bloqueado por firewall corporativo.
|
|
10
|
+
|
|
11
|
+
**Detecção**: o script `<script type="module">` falha ao importar, ou `THREE` fica `undefined` após o carregamento.
|
|
12
|
+
|
|
13
|
+
**Tratamento**:
|
|
14
|
+
|
|
15
|
+
```javascript
|
|
16
|
+
try {
|
|
17
|
+
const mod = await import("https://cdn.jsdelivr.net/npm/three@0.158.0/build/three.module.js");
|
|
18
|
+
window.THREE = mod;
|
|
19
|
+
} catch (e) {
|
|
20
|
+
document.getElementById("loader").innerHTML = `
|
|
21
|
+
<div class="error-panel">
|
|
22
|
+
<h2>Não foi possível carregar a biblioteca 3D</h2>
|
|
23
|
+
<p>Esta visualização requer acesso à internet para baixar o Three.js uma vez.
|
|
24
|
+
Conecte-se à internet e recarregue a página.</p>
|
|
25
|
+
<p>Detalhe técnico: ${e.message}</p>
|
|
26
|
+
</div>`;
|
|
27
|
+
return;
|
|
28
|
+
}
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Texto sempre em pt-br, sem travessão.
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## ERR-02: WebGL não suportado
|
|
36
|
+
|
|
37
|
+
**Causa**: browser sem WebGL (raríssimo hoje, mas possível em VMs antigas ou ambientes corporativos restritos).
|
|
38
|
+
|
|
39
|
+
**Detecção**: `new THREE.WebGLRenderer()` lança exceção ou retorna `null`.
|
|
40
|
+
|
|
41
|
+
**Tratamento**:
|
|
42
|
+
|
|
43
|
+
```javascript
|
|
44
|
+
let renderer;
|
|
45
|
+
try {
|
|
46
|
+
renderer = new THREE.WebGLRenderer({ antialias: true });
|
|
47
|
+
} catch (e) {
|
|
48
|
+
showFallback("WebGL não está disponível no seu browser. Use Chrome, Firefox ou Edge atualizados.");
|
|
49
|
+
return;
|
|
50
|
+
}
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
Fallback exibe uma versão estática da cena (screenshot pré-renderizado se houver, ou ASCII art simbólico) com mensagem clara.
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## ERR-03: JSON malformado
|
|
58
|
+
|
|
59
|
+
**Causa**: `modules.json` ou `deps.json` com sintaxe inválida, ou campos esperados ausentes.
|
|
60
|
+
|
|
61
|
+
**Detecção**: `JSON.parse` falha, ou validação de schema indica campos ausentes.
|
|
62
|
+
|
|
63
|
+
**Tratamento**:
|
|
64
|
+
|
|
65
|
+
```javascript
|
|
66
|
+
function loadData() {
|
|
67
|
+
const raw = document.getElementById("data").textContent;
|
|
68
|
+
let data;
|
|
69
|
+
try {
|
|
70
|
+
data = JSON.parse(raw);
|
|
71
|
+
} catch (e) {
|
|
72
|
+
showError("Dados de entrada inválidos: arquivo JSON malformado. " + e.message);
|
|
73
|
+
return null;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
if (!Array.isArray(data.modules)) {
|
|
77
|
+
showError("Dados de entrada inválidos: 'modules' deve ser uma lista.");
|
|
78
|
+
return null;
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
data.modules = data.modules.filter((m) => {
|
|
82
|
+
if (!m.name) {
|
|
83
|
+
console.warn("Módulo sem 'name' descartado:", m);
|
|
84
|
+
return false;
|
|
85
|
+
}
|
|
86
|
+
return true;
|
|
87
|
+
});
|
|
88
|
+
|
|
89
|
+
return data;
|
|
90
|
+
}
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Erros não-fatais (módulo individual ruim) descartam o item com aviso. Erros fatais (estrutura raiz inválida) mostram mensagem clara.
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## ERR-04: Projeto vazio ou sem dados visualizáveis
|
|
98
|
+
|
|
99
|
+
**Causa**: `modules.json` tem 0 itens, ou `deps.json` tem 0 arestas, ou ambos.
|
|
100
|
+
|
|
101
|
+
**Detecção**: após `loadData()`, contagem dos itens.
|
|
102
|
+
|
|
103
|
+
**Tratamento**:
|
|
104
|
+
|
|
105
|
+
```javascript
|
|
106
|
+
if (data.modules.length === 0) {
|
|
107
|
+
showEmptyState({
|
|
108
|
+
title: "Nada para visualizar ainda",
|
|
109
|
+
message: "O projeto não tem módulos detectados. Rode `/reversa` para extrair a estrutura primeiro.",
|
|
110
|
+
actions: [
|
|
111
|
+
{ label: "Voltar à documentação", href: "index.html" }
|
|
112
|
+
]
|
|
113
|
+
});
|
|
114
|
+
return;
|
|
115
|
+
}
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
Empty state amigável, nunca cena vazia silenciosa.
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
## ERR-05: Projeto muito grande (>5.000 módulos sem agrupamento)
|
|
123
|
+
|
|
124
|
+
**Causa**: o usuário força modo Code City sem agrupamento em um projeto enorme.
|
|
125
|
+
|
|
126
|
+
**Detecção**: `data.modules.length > 5000` e nenhuma estratégia de agrupamento ativada.
|
|
127
|
+
|
|
128
|
+
**Tratamento**: aplicar agrupamento automaticamente e avisar.
|
|
129
|
+
|
|
130
|
+
```javascript
|
|
131
|
+
if (data.modules.length > 5000) {
|
|
132
|
+
showToast("Projeto grande detectado (" + data.modules.length + " arquivos). Agrupando por pasta para manter performance.");
|
|
133
|
+
data.modules = groupByFolder(data.modules);
|
|
134
|
+
config.grouped = true;
|
|
135
|
+
}
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
O agrupamento e seu impacto aparecem no rodapé permanente da página: "Visualização agrupada por pasta. Cada bloco representa N arquivos."
|
|
139
|
+
|
|
140
|
+
---
|
|
141
|
+
|
|
142
|
+
## ERR-06: Performance degradada (fps < 30)
|
|
143
|
+
|
|
144
|
+
**Causa**: hardware fraco, projeto no limite superior, sombras pesadas.
|
|
145
|
+
|
|
146
|
+
**Detecção**: medir `requestAnimationFrame` delta.
|
|
147
|
+
|
|
148
|
+
```javascript
|
|
149
|
+
let frameTimes = [];
|
|
150
|
+
function measureFps(time) {
|
|
151
|
+
frameTimes.push(time);
|
|
152
|
+
if (frameTimes.length > 60) frameTimes.shift();
|
|
153
|
+
if (frameTimes.length === 60) {
|
|
154
|
+
const fps = 1000 / ((frameTimes[59] - frameTimes[0]) / 59);
|
|
155
|
+
if (fps < 30 && !config.degraded) {
|
|
156
|
+
degradeQuality();
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
**Tratamento progressivo** (`degradeQuality`):
|
|
163
|
+
|
|
164
|
+
1. Desativar sombras.
|
|
165
|
+
2. Reduzir pixelRatio para 1.
|
|
166
|
+
3. Reduzir contagem de partículas em tours.
|
|
167
|
+
4. Mostrar toast "Modo de performance ativado".
|
|
168
|
+
|
|
169
|
+
---
|
|
170
|
+
|
|
171
|
+
## ERR-07: InstancedMesh limit excedido
|
|
172
|
+
|
|
173
|
+
**Causa**: tentativa de criar InstancedMesh com mais instâncias do que o hardware suporta (limite de ~65k em hardwares antigos via Uint16, mas raro).
|
|
174
|
+
|
|
175
|
+
**Detecção**: console error do Three.js após `setMatrixAt` para índices altos.
|
|
176
|
+
|
|
177
|
+
**Tratamento**:
|
|
178
|
+
|
|
179
|
+
```javascript
|
|
180
|
+
const MAX_INSTANCES = 32768;
|
|
181
|
+
if (modules.length > MAX_INSTANCES) {
|
|
182
|
+
showWarning("Limite de instâncias excedido. Mostrando apenas os " + MAX_INSTANCES + " maiores.");
|
|
183
|
+
modules = modules.sort((a, b) => b.loc - a.loc).slice(0, MAX_INSTANCES);
|
|
184
|
+
}
|
|
185
|
+
```
|
|
186
|
+
|
|
187
|
+
---
|
|
188
|
+
|
|
189
|
+
## ERR-08: Ciclo de dependências infinito durante layout
|
|
190
|
+
|
|
191
|
+
**Causa**: grafo com ciclo fechado e layout iterativo sem critério de parada.
|
|
192
|
+
|
|
193
|
+
**Detecção**: medir iterações de simulação; se passar `MAX_SIM_FRAMES` sem convergir, abortar.
|
|
194
|
+
|
|
195
|
+
**Tratamento**: parar simulação no frame limite, mostrar aviso "Layout não convergiu, posições podem não refletir estabilidade ideal", desenhar mesmo assim.
|
|
196
|
+
|
|
197
|
+
---
|
|
198
|
+
|
|
199
|
+
## ERR-09: WebGL context lost
|
|
200
|
+
|
|
201
|
+
**Causa**: aba inativa por muito tempo, troca de driver gráfico, GPU sobrecarregada.
|
|
202
|
+
|
|
203
|
+
**Detecção**: evento `webglcontextlost` no canvas.
|
|
204
|
+
|
|
205
|
+
**Tratamento**:
|
|
206
|
+
|
|
207
|
+
```javascript
|
|
208
|
+
renderer.domElement.addEventListener("webglcontextlost", (e) => {
|
|
209
|
+
e.preventDefault();
|
|
210
|
+
showToast("Contexto 3D foi perdido. Tentando recuperar...");
|
|
211
|
+
});
|
|
212
|
+
|
|
213
|
+
renderer.domElement.addEventListener("webglcontextrestored", () => {
|
|
214
|
+
rebuildScene();
|
|
215
|
+
showToast("Contexto recuperado.");
|
|
216
|
+
});
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
Em vez de recarregar a página, reconstruir a cena no mesmo canvas. Importante chamar `rebuildScene()` que recria texturas e buffers.
|
|
220
|
+
|
|
221
|
+
---
|
|
222
|
+
|
|
223
|
+
## ERR-10: Sidebar localStorage corrompido
|
|
224
|
+
|
|
225
|
+
**Causa**: dados antigos de localStorage com formato incompatível após atualização da skill.
|
|
226
|
+
|
|
227
|
+
**Detecção**: `JSON.parse` falha ao restaurar estado, ou valor está fora do range esperado de um slider.
|
|
228
|
+
|
|
229
|
+
**Tratamento**: silencioso, descarta e usa default.
|
|
230
|
+
|
|
231
|
+
```javascript
|
|
232
|
+
function loadSliderState(slider) {
|
|
233
|
+
try {
|
|
234
|
+
const saved = localStorage.getItem(`arq3d.${slider.dataset.param}`);
|
|
235
|
+
if (saved !== null) {
|
|
236
|
+
const value = parseFloat(saved);
|
|
237
|
+
if (value >= slider.min && value <= slider.max) {
|
|
238
|
+
slider.value = value;
|
|
239
|
+
}
|
|
240
|
+
}
|
|
241
|
+
} catch (e) {
|
|
242
|
+
// ignora e mantém valor padrão
|
|
243
|
+
}
|
|
244
|
+
}
|
|
245
|
+
```
|
|
246
|
+
|
|
247
|
+
---
|
|
248
|
+
|
|
249
|
+
## Função utilitária: showError + showWarning + showToast
|
|
250
|
+
|
|
251
|
+
```javascript
|
|
252
|
+
function showError(message) {
|
|
253
|
+
const panel = document.createElement("div");
|
|
254
|
+
panel.className = "reversa-error-panel";
|
|
255
|
+
panel.innerHTML = `<h2>Erro</h2><p>${escapeHtml(message)}</p>`;
|
|
256
|
+
document.body.appendChild(panel);
|
|
257
|
+
}
|
|
258
|
+
|
|
259
|
+
function showWarning(message) {
|
|
260
|
+
const panel = document.createElement("div");
|
|
261
|
+
panel.className = "reversa-warning-banner";
|
|
262
|
+
panel.textContent = message;
|
|
263
|
+
document.body.appendChild(panel);
|
|
264
|
+
setTimeout(() => panel.remove(), 8000);
|
|
265
|
+
}
|
|
266
|
+
|
|
267
|
+
function showToast(message) {
|
|
268
|
+
const t = document.createElement("div");
|
|
269
|
+
t.className = "reversa-toast";
|
|
270
|
+
t.textContent = message;
|
|
271
|
+
document.body.appendChild(t);
|
|
272
|
+
setTimeout(() => t.remove(), 4000);
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
function escapeHtml(s) {
|
|
276
|
+
return s.replace(/[&<>"']/g, (c) => ({ "&": "&", "<": "<", ">": ">", '"': """, "'": "'" }[c]));
|
|
277
|
+
}
|
|
278
|
+
```
|
|
279
|
+
|
|
280
|
+
Estilos `reversa-error-panel`, `reversa-warning-banner`, `reversa-toast` ficam no CSS compartilhado do mini-site.
|
|
281
|
+
|
|
282
|
+
---
|
|
283
|
+
|
|
284
|
+
## Princípio geral
|
|
285
|
+
|
|
286
|
+
Nenhum erro deve resultar em **tela branca silenciosa**. Sempre mostrar mensagem clara em pt-br com instrução acionável ou indicação clara de limitação. Mensagens curtas, sem jargão de framework, sem travessão.
|