@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,242 @@
|
|
|
1
|
+
# Architecture Tour
|
|
2
|
+
|
|
3
|
+
Câmera animada percorrendo a cena em ritmo cinematográfico, com **overlay narrativo** sincronizado. Funciona como um "trailer" do sistema: alguém aperta play e o vídeo se desenrola sozinho, parando em pontos-chave com legendas explicativas.
|
|
4
|
+
|
|
5
|
+
## Conceito
|
|
6
|
+
|
|
7
|
+
Tour não é um modo isolado, é uma **camada animada** que se sobrepõe a qualquer dos outros modos (Code City, Dependency Graph 3D, Layer Stack, Call Graph). A skill recebe uma sequência de waypoints e narrações, e a câmera viaja entre eles.
|
|
8
|
+
|
|
9
|
+
## Quando usar
|
|
10
|
+
|
|
11
|
+
- Apresentações para stakeholders não-técnicos.
|
|
12
|
+
- Onboarding de novos devs ("aperte play e veja como o sistema é").
|
|
13
|
+
- Demonstração executiva curta (1 a 3 minutos).
|
|
14
|
+
- Acompanhamento da `deck.html` do mini-site.
|
|
15
|
+
|
|
16
|
+
## Modelo de dados: a coreografia
|
|
17
|
+
|
|
18
|
+
```json
|
|
19
|
+
{
|
|
20
|
+
"baseMode": "code-city",
|
|
21
|
+
"duration": 90,
|
|
22
|
+
"waypoints": [
|
|
23
|
+
{
|
|
24
|
+
"at": 0,
|
|
25
|
+
"camera": { "position": [200, 250, 400], "target": [0, 0, 0] },
|
|
26
|
+
"overlay": "Esse é o sistema de pagamentos visto de cima."
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
"at": 12,
|
|
30
|
+
"camera": { "position": [50, 30, 80], "target": [40, 0, 20] },
|
|
31
|
+
"overlay": "O distrito mais alto, src/payments, concentra 40% do código."
|
|
32
|
+
},
|
|
33
|
+
{
|
|
34
|
+
"at": 24,
|
|
35
|
+
"camera": { "position": [80, 60, 60], "target": [60, 20, 30] },
|
|
36
|
+
"highlight": ["src/payments/charge.ts", "src/payments/refund.ts"],
|
|
37
|
+
"overlay": "Charge e refund são os arquivos centrais."
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
"at": 40,
|
|
41
|
+
"camera": { "position": [-100, 80, 200], "target": [-50, 0, 0] },
|
|
42
|
+
"switchMode": "dependency-graph",
|
|
43
|
+
"overlay": "Agora vamos olhar as dependências dele."
|
|
44
|
+
}
|
|
45
|
+
]
|
|
46
|
+
}
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
- `at`: segundo da timeline em que o waypoint dispara.
|
|
50
|
+
- `camera`: posição e alvo da câmera ao chegar.
|
|
51
|
+
- `highlight`: lista de IDs de nó/módulo para destacar (outros desfocam).
|
|
52
|
+
- `overlay`: texto da legenda, em pt-br.
|
|
53
|
+
- `switchMode` (opcional): troca o modo base no meio do tour, com transição.
|
|
54
|
+
|
|
55
|
+
## Algoritmo de interpolação
|
|
56
|
+
|
|
57
|
+
Entre dois waypoints, a câmera interpola posição e alvo com easing.
|
|
58
|
+
|
|
59
|
+
```javascript
|
|
60
|
+
import { CatmullRomCurve3 } from "https://cdn.jsdelivr.net/npm/three@0.158.0/build/three.module.js";
|
|
61
|
+
|
|
62
|
+
const positions = waypoints.map((w) => new THREE.Vector3(...w.camera.position));
|
|
63
|
+
const targets = waypoints.map((w) => new THREE.Vector3(...w.camera.target));
|
|
64
|
+
const positionCurve = new CatmullRomCurve3(positions);
|
|
65
|
+
const targetCurve = new CatmullRomCurve3(targets);
|
|
66
|
+
|
|
67
|
+
let startTime = null;
|
|
68
|
+
function playTour() {
|
|
69
|
+
startTime = performance.now();
|
|
70
|
+
controls.enabled = false; // desligar interação manual
|
|
71
|
+
animateTour();
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
function animateTour() {
|
|
75
|
+
const now = performance.now();
|
|
76
|
+
const elapsed = (now - startTime) / 1000;
|
|
77
|
+
|
|
78
|
+
if (elapsed >= tour.duration) {
|
|
79
|
+
finishTour();
|
|
80
|
+
return;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
const t = elapsed / tour.duration; // 0..1
|
|
84
|
+
const pos = positionCurve.getPoint(t);
|
|
85
|
+
const tgt = targetCurve.getPoint(t);
|
|
86
|
+
camera.position.copy(pos);
|
|
87
|
+
camera.lookAt(tgt);
|
|
88
|
+
|
|
89
|
+
updateOverlay(elapsed);
|
|
90
|
+
updateHighlights(elapsed);
|
|
91
|
+
|
|
92
|
+
renderer.render(scene, camera);
|
|
93
|
+
requestAnimationFrame(animateTour);
|
|
94
|
+
}
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
## Overlay narrativo
|
|
98
|
+
|
|
99
|
+
Caixa de texto posicionada em rodapé ou lateral, com transições suaves entre falas.
|
|
100
|
+
|
|
101
|
+
```html
|
|
102
|
+
<div id="tour-overlay">
|
|
103
|
+
<p id="tour-text"></p>
|
|
104
|
+
<div id="tour-progress"><div id="tour-progress-fill"></div></div>
|
|
105
|
+
<div id="tour-controls">
|
|
106
|
+
<button id="tour-pause">Pausar</button>
|
|
107
|
+
<button id="tour-restart">Reiniciar</button>
|
|
108
|
+
<button id="tour-skip">Pular</button>
|
|
109
|
+
</div>
|
|
110
|
+
</div>
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
```javascript
|
|
114
|
+
function updateOverlay(elapsed) {
|
|
115
|
+
const current = waypoints.findLast((w) => w.at <= elapsed);
|
|
116
|
+
if (!current) return;
|
|
117
|
+
const textEl = document.getElementById("tour-text");
|
|
118
|
+
if (textEl.dataset.at !== String(current.at)) {
|
|
119
|
+
textEl.dataset.at = current.at;
|
|
120
|
+
textEl.style.opacity = 0;
|
|
121
|
+
setTimeout(() => {
|
|
122
|
+
textEl.textContent = current.overlay;
|
|
123
|
+
textEl.style.opacity = 1;
|
|
124
|
+
}, 300);
|
|
125
|
+
}
|
|
126
|
+
const progress = (elapsed / tour.duration) * 100;
|
|
127
|
+
document.getElementById("tour-progress-fill").style.width = progress + "%";
|
|
128
|
+
}
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
## Destaque de elementos
|
|
132
|
+
|
|
133
|
+
Durante highlights, os módulos selecionados ganham emissive e os demais reduzem opacidade.
|
|
134
|
+
|
|
135
|
+
```javascript
|
|
136
|
+
function updateHighlights(elapsed) {
|
|
137
|
+
const current = waypoints.findLast((w) => w.at <= elapsed);
|
|
138
|
+
const highlightIds = new Set(current?.highlight ?? []);
|
|
139
|
+
|
|
140
|
+
modules.forEach((m, i) => {
|
|
141
|
+
const isHighlighted = highlightIds.size === 0 || highlightIds.has(m.name);
|
|
142
|
+
const targetOpacity = isHighlighted ? 1.0 : 0.15;
|
|
143
|
+
// animar opacity via InstancedMesh é mais trabalhoso;
|
|
144
|
+
// alternativa: trocar cor para uma versão dessaturada quando opacity baixa
|
|
145
|
+
const baseColor = colorForModule(m);
|
|
146
|
+
const finalColor = isHighlighted ? baseColor : dim(baseColor, 0.3);
|
|
147
|
+
instanced.setColorAt(i, new THREE.Color(finalColor));
|
|
148
|
+
});
|
|
149
|
+
instanced.instanceColor.needsUpdate = true;
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
function dim(hex, factor) {
|
|
153
|
+
const c = new THREE.Color(hex);
|
|
154
|
+
c.r *= factor; c.g *= factor; c.b *= factor;
|
|
155
|
+
return c.getHex();
|
|
156
|
+
}
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
## Mudança de modo no meio do tour
|
|
160
|
+
|
|
161
|
+
Quando um waypoint tem `switchMode`, fazer fade-out da cena atual, dispose, criar a nova cena, fade-in.
|
|
162
|
+
|
|
163
|
+
```javascript
|
|
164
|
+
function switchSceneMode(newMode) {
|
|
165
|
+
fadeOverlay.style.opacity = 1;
|
|
166
|
+
setTimeout(() => {
|
|
167
|
+
clearScene();
|
|
168
|
+
if (newMode === "dependency-graph") buildDependencyGraph();
|
|
169
|
+
else if (newMode === "code-city") buildCodeCity();
|
|
170
|
+
// etc
|
|
171
|
+
fadeOverlay.style.opacity = 0;
|
|
172
|
+
}, 600);
|
|
173
|
+
}
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
## Controles do tour
|
|
177
|
+
|
|
178
|
+
- **Pause**: para `requestAnimationFrame`, congela tempo.
|
|
179
|
+
- **Restart**: volta `startTime` para agora.
|
|
180
|
+
- **Skip**: pula para o próximo waypoint.
|
|
181
|
+
- **Manual takeover**: se usuário arrastar mouse na cena, interrompe tour e habilita OrbitControls.
|
|
182
|
+
|
|
183
|
+
```javascript
|
|
184
|
+
renderer.domElement.addEventListener("pointerdown", () => {
|
|
185
|
+
if (tourPlaying) {
|
|
186
|
+
pauseTour();
|
|
187
|
+
controls.enabled = true;
|
|
188
|
+
showResumeButton();
|
|
189
|
+
}
|
|
190
|
+
});
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
## Trilha sonora opcional
|
|
194
|
+
|
|
195
|
+
Tour pode incluir música ambient sutil via `<audio>` embutido em base64 (curto, ~30s em loop) ou via Web Audio API gerando drones procedurais. Default: sem áudio.
|
|
196
|
+
|
|
197
|
+
## Geração da coreografia
|
|
198
|
+
|
|
199
|
+
A skill recebe waypoints prontos OU gera automaticamente a partir de heurísticas:
|
|
200
|
+
|
|
201
|
+
- Iniciar de cima olhando o centro.
|
|
202
|
+
- Mergulhar nos 3 maiores prédios (Code City).
|
|
203
|
+
- Voar pelo grafo de dependências destacando o nó mais central.
|
|
204
|
+
- Terminar mostrando a layer stack das camadas violadoras (se houver).
|
|
205
|
+
|
|
206
|
+
Cada heurística pode ser ativada ou desativada via parâmetro.
|
|
207
|
+
|
|
208
|
+
## Sidebar do tour
|
|
209
|
+
|
|
210
|
+
```html
|
|
211
|
+
<aside id="sidebar">
|
|
212
|
+
<h3>Architecture Tour</h3>
|
|
213
|
+
|
|
214
|
+
<label>Duração total
|
|
215
|
+
<input type="range" min="30" max="300" value="90" data-param="duration"> s
|
|
216
|
+
</label>
|
|
217
|
+
|
|
218
|
+
<label>Modo base
|
|
219
|
+
<select data-param="baseMode">
|
|
220
|
+
<option value="code-city">Code City</option>
|
|
221
|
+
<option value="dependency-graph">Dependency Graph</option>
|
|
222
|
+
<option value="layer-stack">Layer Stack</option>
|
|
223
|
+
</select>
|
|
224
|
+
</label>
|
|
225
|
+
|
|
226
|
+
<label>
|
|
227
|
+
<input type="checkbox" data-param="autoPlay"> Tocar ao abrir
|
|
228
|
+
</label>
|
|
229
|
+
|
|
230
|
+
<label>
|
|
231
|
+
<input type="checkbox" data-param="includeViolationsScene" checked> Incluir cena de violações
|
|
232
|
+
</label>
|
|
233
|
+
|
|
234
|
+
<button id="play-tour">Tocar Tour</button>
|
|
235
|
+
<button id="pause-tour">Pausar</button>
|
|
236
|
+
<button id="restart-tour">Reiniciar</button>
|
|
237
|
+
</aside>
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
## Performance
|
|
241
|
+
|
|
242
|
+
Tour herda performance do modo base. Adicionar tour custa pouco: apenas interpolação de câmera e animações de opacity. Cuidado com `switchMode` no meio: dispose + rebuild pode causar stutter de 200-500ms.
|
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
# Call Graph 3D
|
|
2
|
+
|
|
3
|
+
Árvore (ou DAG) de **chamadas de função** explorável em 3D. Cada nó é uma função, cada aresta é uma chamada. Permite navegar a profundidade de uma cadeia de invocações partindo de pontos de entrada (endpoints, handlers, main).
|
|
4
|
+
|
|
5
|
+
## Mapeamento
|
|
6
|
+
|
|
7
|
+
| Conceito | Visual |
|
|
8
|
+
|---|---|
|
|
9
|
+
| Função | Cápsula ou pílula 3D com label |
|
|
10
|
+
| Profundidade de chamada | Posição em Z (eixo de profundidade) |
|
|
11
|
+
| Função síncrona | Cápsula sólida |
|
|
12
|
+
| Função assíncrona | Cápsula translúcida com partículas |
|
|
13
|
+
| Função recursiva | Cápsula com brilho (emissive) |
|
|
14
|
+
| Caminho quente (frequência) | Linha mais grossa, cor saturada |
|
|
15
|
+
| Função externa (lib) | Cor cinza |
|
|
16
|
+
| Função do projeto | Cor por pasta/módulo |
|
|
17
|
+
|
|
18
|
+
## Quando usar
|
|
19
|
+
|
|
20
|
+
- Entender o fluxo de execução de um endpoint específico.
|
|
21
|
+
- Diagnosticar profundidade excessiva de chamadas (>15 níveis, sinal de overengineering).
|
|
22
|
+
- Detectar recursão indireta.
|
|
23
|
+
- Apresentar como o sistema responde a uma requisição típica.
|
|
24
|
+
|
|
25
|
+
**Quando evitar**: análise estática sem dados de execução é incompleta (não captura polimorfismo). Para visão estrutural use Dependency Graph 3D.
|
|
26
|
+
|
|
27
|
+
## Modelo de dados esperado
|
|
28
|
+
|
|
29
|
+
```json
|
|
30
|
+
{
|
|
31
|
+
"entrypoints": ["POST /api/orders", "handleWebhookStripe"],
|
|
32
|
+
"calls": [
|
|
33
|
+
{
|
|
34
|
+
"from": "POST /api/orders",
|
|
35
|
+
"to": "OrderController.create",
|
|
36
|
+
"type": "sync",
|
|
37
|
+
"weight": 1000
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
"from": "OrderController.create",
|
|
41
|
+
"to": "OrderService.placeOrder",
|
|
42
|
+
"type": "sync",
|
|
43
|
+
"weight": 1000
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
"from": "OrderService.placeOrder",
|
|
47
|
+
"to": "PaymentClient.charge",
|
|
48
|
+
"type": "async",
|
|
49
|
+
"weight": 1000
|
|
50
|
+
}
|
|
51
|
+
]
|
|
52
|
+
}
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
`weight` é frequência relativa (quantidade de invocações observadas em um período). `type` é `sync`, `async`, `recursive` ou `external`.
|
|
56
|
+
|
|
57
|
+
## Algoritmo de layout: árvore radial 3D
|
|
58
|
+
|
|
59
|
+
Cada entrypoint vira raiz da árvore. Profundidade aumenta no eixo Z (afastando-se da câmera), funções no mesmo nível distribuem-se em um plano XY.
|
|
60
|
+
|
|
61
|
+
```javascript
|
|
62
|
+
function layoutTree(entrypoint, calls) {
|
|
63
|
+
const nodes = new Map();
|
|
64
|
+
nodes.set(entrypoint, { id: entrypoint, depth: 0, x: 0, y: 0, z: 0, children: [] });
|
|
65
|
+
|
|
66
|
+
function buildChildren(parentId, parentDepth) {
|
|
67
|
+
const outgoing = calls.filter((c) => c.from === parentId);
|
|
68
|
+
outgoing.forEach((c, i, arr) => {
|
|
69
|
+
if (nodes.has(c.to)) {
|
|
70
|
+
// detectou recursão
|
|
71
|
+
nodes.get(c.to).recursive = true;
|
|
72
|
+
return;
|
|
73
|
+
}
|
|
74
|
+
const angle = (i / arr.length) * Math.PI * 2;
|
|
75
|
+
const radius = parentDepth * 15 + 30;
|
|
76
|
+
const node = {
|
|
77
|
+
id: c.to,
|
|
78
|
+
depth: parentDepth + 1,
|
|
79
|
+
x: nodes.get(parentId).x + Math.cos(angle) * radius,
|
|
80
|
+
y: nodes.get(parentId).y + Math.sin(angle) * radius,
|
|
81
|
+
z: -(parentDepth + 1) * 40,
|
|
82
|
+
type: c.type,
|
|
83
|
+
weight: c.weight,
|
|
84
|
+
children: []
|
|
85
|
+
};
|
|
86
|
+
nodes.set(c.to, node);
|
|
87
|
+
nodes.get(parentId).children.push(node);
|
|
88
|
+
buildChildren(c.to, parentDepth + 1);
|
|
89
|
+
});
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
buildChildren(entrypoint, 0);
|
|
93
|
+
return Array.from(nodes.values());
|
|
94
|
+
}
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
Para múltiplos entrypoints, cada um ocupa uma região do plano XY (translação no centro), criando árvores paralelas.
|
|
98
|
+
|
|
99
|
+
## Renderização das cápsulas
|
|
100
|
+
|
|
101
|
+
```javascript
|
|
102
|
+
const capsuleGeo = new THREE.CapsuleGeometry(2, 6, 8, 12);
|
|
103
|
+
const capsuleMat = new THREE.MeshStandardMaterial({ roughness: 0.4 });
|
|
104
|
+
const capsules = new THREE.InstancedMesh(capsuleGeo, capsuleMat, nodes.length);
|
|
105
|
+
|
|
106
|
+
nodes.forEach((n, i) => {
|
|
107
|
+
const dummy = new THREE.Object3D();
|
|
108
|
+
dummy.position.set(n.x, n.y, n.z);
|
|
109
|
+
dummy.rotation.z = Math.PI / 2; // horizontal
|
|
110
|
+
const scale = 0.6 + Math.log(1 + (n.weight ?? 1)) * 0.2;
|
|
111
|
+
dummy.scale.set(scale, scale, scale);
|
|
112
|
+
dummy.updateMatrix();
|
|
113
|
+
capsules.setMatrixAt(i, dummy.matrix);
|
|
114
|
+
|
|
115
|
+
const color = new THREE.Color(colorForCall(n));
|
|
116
|
+
capsules.setColorAt(i, color);
|
|
117
|
+
});
|
|
118
|
+
capsules.instanceMatrix.needsUpdate = true;
|
|
119
|
+
capsules.instanceColor.needsUpdate = true;
|
|
120
|
+
scene.add(capsules);
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
`colorForCall(n)` retorna cinza para externas, cor da pasta para internas, com emissive se `n.recursive`.
|
|
124
|
+
|
|
125
|
+
## Renderização das chamadas (arestas)
|
|
126
|
+
|
|
127
|
+
Linhas curvas tipo bezier conectando pai a filho. Mais grossas para `weight` alto.
|
|
128
|
+
|
|
129
|
+
```javascript
|
|
130
|
+
calls.forEach((c) => {
|
|
131
|
+
const src = nodesById.get(c.from);
|
|
132
|
+
const dst = nodesById.get(c.to);
|
|
133
|
+
if (!src || !dst) return;
|
|
134
|
+
|
|
135
|
+
const mid = new THREE.Vector3(
|
|
136
|
+
(src.x + dst.x) / 2,
|
|
137
|
+
(src.y + dst.y) / 2 + 10,
|
|
138
|
+
(src.z + dst.z) / 2
|
|
139
|
+
);
|
|
140
|
+
const curve = new THREE.QuadraticBezierCurve3(
|
|
141
|
+
new THREE.Vector3(src.x, src.y, src.z),
|
|
142
|
+
mid,
|
|
143
|
+
new THREE.Vector3(dst.x, dst.y, dst.z)
|
|
144
|
+
);
|
|
145
|
+
const tube = new THREE.TubeGeometry(curve, 20, 0.2 + Math.log(1 + c.weight) * 0.1, 6, false);
|
|
146
|
+
const isAsync = c.type === "async";
|
|
147
|
+
const mat = new THREE.MeshStandardMaterial({
|
|
148
|
+
color: isAsync ? 0xb39ddb : 0x4a9eff,
|
|
149
|
+
transparent: true,
|
|
150
|
+
opacity: 0.6
|
|
151
|
+
});
|
|
152
|
+
scene.add(new THREE.Mesh(tube, mat));
|
|
153
|
+
});
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
## Animação de fluxo (opcional)
|
|
157
|
+
|
|
158
|
+
Partículas viajando ao longo das arestas, indicando que a chamada está "viva". Útil para apresentações.
|
|
159
|
+
|
|
160
|
+
```javascript
|
|
161
|
+
function animateFlow(time) {
|
|
162
|
+
edgeParticles.forEach((p) => {
|
|
163
|
+
const t = (time * 0.001 + p.offset) % 1;
|
|
164
|
+
const pos = p.curve.getPoint(t);
|
|
165
|
+
p.mesh.position.copy(pos);
|
|
166
|
+
});
|
|
167
|
+
}
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
## Sidebar de controles
|
|
171
|
+
|
|
172
|
+
```html
|
|
173
|
+
<aside id="sidebar">
|
|
174
|
+
<h3>Call Graph 3D</h3>
|
|
175
|
+
|
|
176
|
+
<label>Entrypoint
|
|
177
|
+
<select data-param="entrypoint">
|
|
178
|
+
<!-- POPULATED -->
|
|
179
|
+
</select>
|
|
180
|
+
</label>
|
|
181
|
+
|
|
182
|
+
<label>Profundidade máxima
|
|
183
|
+
<input type="range" min="1" max="20" value="10" data-param="maxDepth">
|
|
184
|
+
</label>
|
|
185
|
+
|
|
186
|
+
<label>
|
|
187
|
+
<input type="checkbox" data-param="showAsync" checked> Destacar async
|
|
188
|
+
</label>
|
|
189
|
+
|
|
190
|
+
<label>
|
|
191
|
+
<input type="checkbox" data-param="showExternal"> Mostrar libs externas
|
|
192
|
+
</label>
|
|
193
|
+
|
|
194
|
+
<label>
|
|
195
|
+
<input type="checkbox" data-param="animateFlow"> Animar fluxo
|
|
196
|
+
</label>
|
|
197
|
+
|
|
198
|
+
<div id="depth-info"></div>
|
|
199
|
+
<div id="recursive-warnings"></div>
|
|
200
|
+
|
|
201
|
+
<button id="reset">Reset</button>
|
|
202
|
+
<button id="export-png">Exportar PNG</button>
|
|
203
|
+
</aside>
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
## Interação
|
|
207
|
+
|
|
208
|
+
- **Hover em cápsula**: nome da função, módulo de origem, número de chamadores e chamados, tipo.
|
|
209
|
+
- **Clique em cápsula**: foca câmera, destaca cadeia desde o entrypoint até essa função.
|
|
210
|
+
- **Duplo clique**: expande/colapsa subárvore.
|
|
211
|
+
- **Toggle entrypoint**: muda a raiz da visualização, recalcula layout.
|
|
212
|
+
|
|
213
|
+
## Performance
|
|
214
|
+
|
|
215
|
+
- Limite prático: ~500 funções por entrypoint.
|
|
216
|
+
- Acima disso, colapsar subárvores automaticamente após profundidade 5 e exibir botão "+N funções".
|
|
217
|
+
- Animação de fluxo: limitar a 50 partículas simultâneas para não derrubar fps.
|
|
@@ -0,0 +1,228 @@
|
|
|
1
|
+
# Code City
|
|
2
|
+
|
|
3
|
+
Padrão consagrado de visualização de software em 3D: cada arquivo do projeto é um **prédio**, agrupados em **distritos** que correspondem a pastas. Permite captar tamanho, complexidade e distribuição do código em um único olhar.
|
|
4
|
+
|
|
5
|
+
## Mapeamento de atributos
|
|
6
|
+
|
|
7
|
+
| Atributo do código | Atributo visual do prédio |
|
|
8
|
+
|---|---|
|
|
9
|
+
| Linhas de código (LOC) | Altura |
|
|
10
|
+
| Complexidade ciclomática | Área da base (largura x profundidade) |
|
|
11
|
+
| Pasta do arquivo | Distrito (posição no plano) |
|
|
12
|
+
| Tipo de arquivo (código, teste, config) | Cor base |
|
|
13
|
+
| Hot path (frequência de mudança ou dependentes) | Cor de destaque (vermelho/amarelo) |
|
|
14
|
+
|
|
15
|
+
## Quando usar
|
|
16
|
+
|
|
17
|
+
- Visão geral inicial de um projeto desconhecido.
|
|
18
|
+
- Identificar arquivos muito grandes (prédios altos) ou complexos (prédios largos).
|
|
19
|
+
- Detectar agrupamento por pasta (distritos coesos vs espalhados).
|
|
20
|
+
- Apresentação executiva: visualmente impactante e intuitivo.
|
|
21
|
+
|
|
22
|
+
**Quando evitar**: projetos pequenos (< 30 arquivos), onde a metáfora urbana é overkill. Use Dependency Graph 3D ou módulos D3 2D.
|
|
23
|
+
|
|
24
|
+
## Algoritmo de layout
|
|
25
|
+
|
|
26
|
+
### 1. Agrupar por pasta
|
|
27
|
+
|
|
28
|
+
```javascript
|
|
29
|
+
const districts = {};
|
|
30
|
+
modules.forEach((m) => {
|
|
31
|
+
if (!districts[m.folder]) districts[m.folder] = [];
|
|
32
|
+
districts[m.folder].push(m);
|
|
33
|
+
});
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
### 2. Calcular tamanho de cada distrito
|
|
37
|
+
|
|
38
|
+
A área do distrito é proporcional ao número de arquivos. Use empacotamento simples (linha por linha) ou squarified treemap.
|
|
39
|
+
|
|
40
|
+
```javascript
|
|
41
|
+
function packDistrict(modules, padding = 1) {
|
|
42
|
+
const count = modules.length;
|
|
43
|
+
const cols = Math.ceil(Math.sqrt(count));
|
|
44
|
+
const rows = Math.ceil(count / cols);
|
|
45
|
+
return { cols, rows };
|
|
46
|
+
}
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### 3. Posicionar distritos no plano
|
|
50
|
+
|
|
51
|
+
Os distritos formam a cidade. Para até ~20 pastas, empacotar em grid simples. Para mais, usar treemap.
|
|
52
|
+
|
|
53
|
+
```javascript
|
|
54
|
+
const districtSize = (count) => Math.sqrt(count) * cellSize * 2;
|
|
55
|
+
let offsetX = 0;
|
|
56
|
+
let offsetZ = 0;
|
|
57
|
+
const districtPositions = {};
|
|
58
|
+
Object.entries(districts).forEach(([folder, mods], i) => {
|
|
59
|
+
const size = districtSize(mods.length);
|
|
60
|
+
districtPositions[folder] = { x: offsetX, z: offsetZ, size };
|
|
61
|
+
offsetX += size + districtGap;
|
|
62
|
+
if ((i + 1) % gridCols === 0) {
|
|
63
|
+
offsetX = 0;
|
|
64
|
+
offsetZ += size + districtGap;
|
|
65
|
+
}
|
|
66
|
+
});
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### 4. Posicionar prédios dentro do distrito
|
|
70
|
+
|
|
71
|
+
```javascript
|
|
72
|
+
modules.forEach((m) => {
|
|
73
|
+
const district = districtPositions[m.folder];
|
|
74
|
+
const local = packDistrict(districts[m.folder]);
|
|
75
|
+
const indexInDistrict = districts[m.folder].indexOf(m);
|
|
76
|
+
const col = indexInDistrict % local.cols;
|
|
77
|
+
const row = Math.floor(indexInDistrict / local.cols);
|
|
78
|
+
m.x = district.x + col * cellSize;
|
|
79
|
+
m.z = district.z + row * cellSize;
|
|
80
|
+
});
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### 5. Dimensionar cada prédio
|
|
84
|
+
|
|
85
|
+
```javascript
|
|
86
|
+
const LOC_TO_HEIGHT = 0.4; // 1000 LOC = 400 unidades de altura
|
|
87
|
+
const COMPLEXITY_TO_WIDTH = 0.8;
|
|
88
|
+
const MIN_W = 2;
|
|
89
|
+
const MIN_H = 1;
|
|
90
|
+
|
|
91
|
+
modules.forEach((m) => {
|
|
92
|
+
m.height = Math.max(MIN_H, m.loc * LOC_TO_HEIGHT);
|
|
93
|
+
const baseW = Math.max(MIN_W, Math.sqrt(m.complexity) * COMPLEXITY_TO_WIDTH);
|
|
94
|
+
m.w = baseW;
|
|
95
|
+
m.d = baseW;
|
|
96
|
+
});
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
### 6. Renderizar com InstancedMesh
|
|
100
|
+
|
|
101
|
+
Ver `THREE_PATTERNS.md` para o padrão de InstancedMesh. Cada prédio é uma instância da mesma BoxGeometry, com matriz e cor distintas.
|
|
102
|
+
|
|
103
|
+
```javascript
|
|
104
|
+
const boxGeo = new THREE.BoxGeometry(1, 1, 1);
|
|
105
|
+
boxGeo.translate(0, 0.5, 0); // base no chão
|
|
106
|
+
const mat = new THREE.MeshStandardMaterial({ roughness: 0.6 });
|
|
107
|
+
const buildings = new THREE.InstancedMesh(boxGeo, mat, modules.length);
|
|
108
|
+
buildings.castShadow = true;
|
|
109
|
+
buildings.receiveShadow = true;
|
|
110
|
+
|
|
111
|
+
const dummy = new THREE.Object3D();
|
|
112
|
+
const color = new THREE.Color();
|
|
113
|
+
|
|
114
|
+
modules.forEach((m, i) => {
|
|
115
|
+
dummy.position.set(m.x, 0, m.z);
|
|
116
|
+
dummy.scale.set(m.w, m.height, m.d);
|
|
117
|
+
dummy.updateMatrix();
|
|
118
|
+
buildings.setMatrixAt(i, dummy.matrix);
|
|
119
|
+
color.set(colorForModule(m));
|
|
120
|
+
buildings.setColorAt(i, color);
|
|
121
|
+
});
|
|
122
|
+
buildings.instanceMatrix.needsUpdate = true;
|
|
123
|
+
buildings.instanceColor.needsUpdate = true;
|
|
124
|
+
scene.add(buildings);
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
### 7. Chão e distritos
|
|
128
|
+
|
|
129
|
+
Adicionar um plano grande como chão e quadrados coloridos demarcando cada distrito.
|
|
130
|
+
|
|
131
|
+
```javascript
|
|
132
|
+
const ground = new THREE.Mesh(
|
|
133
|
+
new THREE.PlaneGeometry(2000, 2000),
|
|
134
|
+
new THREE.MeshStandardMaterial({ color: 0x14141a, roughness: 1 })
|
|
135
|
+
);
|
|
136
|
+
ground.rotation.x = -Math.PI / 2;
|
|
137
|
+
ground.receiveShadow = true;
|
|
138
|
+
scene.add(ground);
|
|
139
|
+
|
|
140
|
+
Object.entries(districtPositions).forEach(([folder, d]) => {
|
|
141
|
+
const districtPlane = new THREE.Mesh(
|
|
142
|
+
new THREE.PlaneGeometry(d.size, d.size),
|
|
143
|
+
new THREE.MeshStandardMaterial({ color: districtColor(folder), transparent: true, opacity: 0.15 })
|
|
144
|
+
);
|
|
145
|
+
districtPlane.rotation.x = -Math.PI / 2;
|
|
146
|
+
districtPlane.position.set(d.x + d.size / 2, 0.01, d.z + d.size / 2);
|
|
147
|
+
scene.add(districtPlane);
|
|
148
|
+
});
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
## Cores por tipo de arquivo
|
|
152
|
+
|
|
153
|
+
```javascript
|
|
154
|
+
const TYPE_COLORS = {
|
|
155
|
+
code: 0x4a9eff, // azul
|
|
156
|
+
test: 0x6cc46c, // verde
|
|
157
|
+
config: 0xffc857, // amarelo
|
|
158
|
+
doc: 0xb39ddb, // lilás
|
|
159
|
+
style: 0xff9aa2, // rosa
|
|
160
|
+
asset: 0x999999 // cinza
|
|
161
|
+
};
|
|
162
|
+
|
|
163
|
+
function colorForModule(m) {
|
|
164
|
+
if (m.isHotPath) return 0xff5a4f;
|
|
165
|
+
return TYPE_COLORS[m.type] || 0xcccccc;
|
|
166
|
+
}
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
## Sidebar de controles (Code City)
|
|
170
|
+
|
|
171
|
+
```html
|
|
172
|
+
<aside id="sidebar">
|
|
173
|
+
<h3>Code City</h3>
|
|
174
|
+
|
|
175
|
+
<label>Altura (LOC)
|
|
176
|
+
<input type="range" min="0.1" max="2.0" step="0.1" value="0.4" data-param="locScale">
|
|
177
|
+
</label>
|
|
178
|
+
|
|
179
|
+
<label>Base (complexidade)
|
|
180
|
+
<input type="range" min="0.2" max="2.0" step="0.1" value="0.8" data-param="complexityScale">
|
|
181
|
+
</label>
|
|
182
|
+
|
|
183
|
+
<label>Threshold de hot path
|
|
184
|
+
<input type="range" min="0" max="100" step="5" value="50" data-param="hotPathThreshold">
|
|
185
|
+
</label>
|
|
186
|
+
|
|
187
|
+
<label>
|
|
188
|
+
<input type="checkbox" data-param="showLabels" checked> Labels visíveis
|
|
189
|
+
</label>
|
|
190
|
+
|
|
191
|
+
<label>
|
|
192
|
+
<input type="checkbox" data-param="showDistricts" checked> Mostrar distritos
|
|
193
|
+
</label>
|
|
194
|
+
|
|
195
|
+
<label>Filtrar pasta
|
|
196
|
+
<select data-param="folderFilter">
|
|
197
|
+
<option value="all">Todas</option>
|
|
198
|
+
<!-- POPULATED_FROM_DATA -->
|
|
199
|
+
</select>
|
|
200
|
+
</label>
|
|
201
|
+
|
|
202
|
+
<button id="reset">Reset</button>
|
|
203
|
+
<button id="export-png">Exportar PNG</button>
|
|
204
|
+
</aside>
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
Quando um slider muda, recalcular `m.height`, `m.w`, `m.d` e atualizar a `InstancedMesh` com novas matrizes.
|
|
208
|
+
|
|
209
|
+
## Interação
|
|
210
|
+
|
|
211
|
+
- **Hover em prédio**: tooltip mostra nome do arquivo, LOC, complexidade, pasta.
|
|
212
|
+
- **Clique em prédio**: foca câmera no prédio (anima `controls.target` para a posição do prédio).
|
|
213
|
+
- **Drag em distrito**: rotaciona câmera com OrbitControls.
|
|
214
|
+
- **Scroll**: zoom in/out.
|
|
215
|
+
|
|
216
|
+
## Performance
|
|
217
|
+
|
|
218
|
+
- Até **5.000 prédios** é seguro com InstancedMesh.
|
|
219
|
+
- Acima disso, agrupar arquivos por pasta (um prédio = uma pasta com altura agregada de LOC, área pelo número de arquivos).
|
|
220
|
+
- Desativar sombras se o framerate cair abaixo de 30fps (detectar via `requestAnimationFrame` timer).
|
|
221
|
+
|
|
222
|
+
## Variantes opcionais
|
|
223
|
+
|
|
224
|
+
- **Code City temporal**: animar crescimento ao longo do histórico do projeto (cada commit faz prédios crescerem).
|
|
225
|
+
- **Code City colorida por autor**: cores indicam quem é o maintainer principal de cada arquivo.
|
|
226
|
+
- **Code City com chuva**: hot paths recebem efeito de partículas vermelhas caindo, indicando "instabilidade".
|
|
227
|
+
|
|
228
|
+
Estas variantes ficam para versões futuras da skill.
|