@fontdata/ai-harness 4.3.1 → 4.5.0
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/.claude-plugin/plugin.json +2 -2
- package/README.md +154 -3
- package/dist/cli.js +1 -0
- package/dist/config/config.js +45 -3
- package/dist/delphi/catalogo.js +299 -0
- package/dist/delphi/classificar.js +21 -0
- package/dist/delphi/command.js +144 -2
- package/dist/delphi/encoding.js +112 -0
- package/dist/doctor/checks.js +19 -1
- package/dist/init.js +16 -2
- package/dist/install/perfis.js +21 -0
- package/dist/install/plan.js +29 -2
- package/dist/install/settings.js +40 -3
- package/dist/mapa/extratores/pascal.js +1 -1
- package/dist/update/update.js +126 -7
- package/package.json +1 -1
- package/templates/CLAUDE.md +2 -1
- package/templates/catalog.json +11 -3
- package/templates/hooks/comentarios/check.mjs +62 -5
- package/templates/hooks/hooks.json +2 -1
- package/templates/hooks/lib/config.mjs +1 -0
- package/templates/hooks/padroes-proibidos.mjs +68 -0
- package/templates/perfis/delphi/hooks/encoding.mjs +317 -0
- package/templates/perfis/delphi/rules/build-e-verificacao.md +59 -0
- package/templates/perfis/delphi/rules/dados/cnpj-alfanumerico-nao-extrair-so-numeros.md +65 -0
- package/templates/perfis/delphi/rules/dados/data-hora-sql-nunca-round-trip-textual.md +78 -0
- package/templates/perfis/delphi/rules/dados/datestyle-sessao-firedac-postgres.md +60 -0
- package/templates/perfis/delphi/rules/dados/ddl-tabela-nova-exige-trigger-de-log.md +68 -0
- package/templates/perfis/delphi/rules/dados/divisao-e-conversao-numerica.md +53 -0
- package/templates/perfis/delphi/rules/dados/fieldbyname-value-variant-cru-em-aritmetica.md +73 -0
- package/templates/perfis/delphi/rules/dados/filtro-condicional-sql-par-add-parambyname.md +72 -0
- package/templates/perfis/delphi/rules/dados/firedac.md +51 -0
- package/templates/perfis/delphi/rules/dados/macro-firedac-exige-entrada-macrodata.md +96 -0
- package/templates/perfis/delphi/rules/dados/sql-qualificacao-colunas.md +36 -0
- package/templates/perfis/delphi/rules/dados/tmeminifile-getstrings-nao-limpa-destino.md +89 -0
- package/templates/perfis/delphi/rules/encoding-eol.md +130 -0
- package/templates/perfis/delphi/rules/linguagem/dataset-nao-se-le-depois-do-laco-eof.md +56 -0
- package/templates/perfis/delphi/rules/linguagem/existencia-nunca-se-testa-por-campo-formatado.md +60 -0
- package/templates/perfis/delphi/rules/linguagem/float-nunca-comparado-por-igualdade-com-literal.md +55 -0
- package/templates/perfis/delphi/rules/linguagem/literal-enum-de-dfm-exige-unit-no-uses.md +84 -0
- package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md +172 -0
- package/templates/perfis/delphi/rules/linguagem/sem-clipboard-debug.md +43 -0
- package/templates/perfis/delphi/rules/linguagem/validacao-em-onexit-nao-protege-a-gravacao.md +65 -0
- package/templates/perfis/delphi/rules/linguagem/variavel-inline-sai-de-escopo-ao-envolver-bloco.md +69 -0
- package/templates/perfis/delphi/rules/telas/foco-decisao-por-canfocus-nao-tabstop.md +40 -0
- package/templates/perfis/delphi/rules/telas/form-dinamico-liberar-em-toda-saida.md +80 -0
- package/templates/perfis/delphi/rules/telas/heranca-de-form-e-grade-de-selecao.md +58 -0
- package/templates/perfis/delphi/rules/threads-e-timers.md +131 -0
- package/templates/perfis/delphi/rules/try-finally-e-vazamento.md +109 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/SKILL.md +70 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/ATRIBUICAO.md +29 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/acbr-nfce-integracao.md +60 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/build-via-bat-com-log.md +86 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/class-var-vaza-para-campos-de-instancia.md +73 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/componentes-designer-vs-runtime.md +47 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/console-writeln-sem-flush-nao-loga.md +47 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/conversao-numerica-locale.md +47 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/delphi13-breaking-changes.md +41 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/dpr-uses-project-manager.md +62 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-dcc-debuginformation-nao-booleano.md +78 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-projectguid-valido.md +38 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/firedac-registro-drivers.md +94 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/horse-gbswagger-rotas-jwt.md +61 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/msb6003-command-line-too-long.md +52 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/recursos-rcdata.md +67 -0
- package/templates/perfis/delphi-fiscal/rules/campo-novo-acbr-preenchimento-explicito.md +61 -0
- package/templates/perfis/delphi-fiscal/rules/retorno-de-evento-nfe-pelo-cstat.md +51 -0
- package/templates/perfis/delphi-fiscal/rules/sucesso-de-webservice-fiscal-nao-prova-documento.md +100 -0
- package/templates/perfis/delphi-fiscal/rules/total-tributo-acbr-soma-itens.md +63 -0
- package/templates/perfis/delphi-fiscal/skills/diagnosticar-rejeicao-nfse/SKILL.md +155 -0
- package/templates/perfis/delphi-fiscal/skills/patch-acbr/SKILL.md +143 -0
- package/templates/skills/auditar-performance/SKILL.md +9 -0
- package/templates/skills/auditar-performance/references/pontos-quentes.md +8 -0
- package/templates/skills/auditar-seguranca/SKILL.md +55 -14
- package/templates/skills/auditar-seguranca/templates/relatorios/TECNICO.md +5 -0
- package/templates/skills/auditar-ui/SKILL.md +18 -3
- package/templates/skills/auditar-ui/references/ATRIBUICAO.md +44 -0
- package/templates/skills/auditar-ui/references/web-interface-guidelines.md +191 -0
- package/templates/skills/harness/references/validar-ideia.md +7 -6
- package/templates/skills/security-audit/AI-AND-LLM.md +83 -0
- package/templates/skills/security-audit/ATTACK-CLASSES.md +130 -0
- package/templates/skills/security-audit/CLIENT-SIDE.md +83 -0
- package/templates/skills/security-audit/CLOUD-AND-DEPLOYMENT.md +86 -0
- package/templates/skills/security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -0
- package/templates/skills/security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -0
- package/templates/skills/security-audit/HUNTING.md +251 -0
- package/templates/skills/security-audit/LICENSE +21 -0
- package/templates/skills/security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -0
- package/templates/skills/security-audit/ORIGEM.md +51 -0
- package/templates/skills/security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -0
- package/templates/skills/security-audit/RECONNAISSANCE.md +156 -0
- package/templates/skills/security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -0
- package/templates/skills/security-audit/SKILL.md +192 -0
- package/templates/skills/security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -0
- package/templates/skills/security-audit/VALIDATION-AND-REPORTING.md +186 -0
- package/templates/skills/security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -0
- package/templates/skills/security-audit/report-schema.json +461 -0
- package/templates/skills/security-audit/validate-coverage-ledger.cjs +872 -0
- package/templates/skills/security-audit/validate-findings.cjs +773 -0
- package/templates/skills/supabase-postgres-best-practices/CHANGELOG.md +73 -0
- package/templates/skills/supabase-postgres-best-practices/LICENSE +21 -0
- package/templates/skills/supabase-postgres-best-practices/ORIGEM.md +43 -0
- package/templates/skills/supabase-postgres-best-practices/SKILL.md +64 -0
- package/templates/skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
- package/templates/skills/supabase-postgres-best-practices/references/_sections.md +39 -0
- package/templates/skills/supabase-postgres-best-practices/references/_template.md +34 -0
- package/templates/skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
- package/templates/skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
- package/templates/skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
- package/templates/skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
- package/templates/skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/security-rls-performance.md +63 -0
- package/templates/skills/vercel-react-best-practices/AGENTS.md +3810 -0
- package/templates/skills/vercel-react-best-practices/ORIGEM.md +39 -0
- package/templates/skills/vercel-react-best-practices/README.md +123 -0
- package/templates/skills/vercel-react-best-practices/SKILL.md +149 -0
- package/templates/skills/vercel-react-best-practices/metadata.json +15 -0
- package/templates/skills/vercel-react-best-practices/rules/_sections.md +46 -0
- package/templates/skills/vercel-react-best-practices/rules/_template.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
- package/templates/skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
- package/templates/skills/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
- package/templates/skills/vercel-react-best-practices/rules/async-defer-await.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
- package/templates/skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
- package/templates/skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
- package/templates/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
- package/templates/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
- package/templates/skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
- package/templates/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
- package/templates/skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
- package/templates/skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
- package/templates/skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
- package/templates/skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
- package/templates/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
- package/templates/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
- package/templates/skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
- package/templates/skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
- package/templates/skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
- package/templates/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
- package/templates/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
- package/templates/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
- package/templates/skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
- package/templates/skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
- package/templates/skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
- package/templates/skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
- package/templates/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
- package/templates/skills/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
- package/templates/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
- package/templates/skills/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
- package/templates/skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
- package/templates/skills/vercel-react-native-skills/AGENTS.md +2897 -0
- package/templates/skills/vercel-react-native-skills/ORIGEM.md +39 -0
- package/templates/skills/vercel-react-native-skills/README.md +165 -0
- package/templates/skills/vercel-react-native-skills/SKILL.md +121 -0
- package/templates/skills/vercel-react-native-skills/metadata.json +16 -0
- package/templates/skills/vercel-react-native-skills/rules/_sections.md +86 -0
- package/templates/skills/vercel-react-native-skills/rules/_template.md +28 -0
- package/templates/skills/vercel-react-native-skills/rules/animation-derived-value.md +53 -0
- package/templates/skills/vercel-react-native-skills/rules/animation-gesture-detector-press.md +95 -0
- package/templates/skills/vercel-react-native-skills/rules/animation-gpu-properties.md +65 -0
- package/templates/skills/vercel-react-native-skills/rules/design-system-compound-components.md +66 -0
- package/templates/skills/vercel-react-native-skills/rules/fonts-config-plugin.md +71 -0
- package/templates/skills/vercel-react-native-skills/rules/imports-design-system-folder.md +68 -0
- package/templates/skills/vercel-react-native-skills/rules/js-hoist-intl.md +61 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-callbacks.md +44 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-function-references.md +132 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-images.md +53 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-inline-objects.md +97 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-item-expensive.md +94 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-item-memo.md +82 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-item-types.md +104 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-virtualize.md +67 -0
- package/templates/skills/vercel-react-native-skills/rules/monorepo-native-deps-in-app.md +46 -0
- package/templates/skills/vercel-react-native-skills/rules/monorepo-single-dependency-versions.md +63 -0
- package/templates/skills/vercel-react-native-skills/rules/navigation-native-navigators.md +188 -0
- package/templates/skills/vercel-react-native-skills/rules/react-compiler-destructure-functions.md +50 -0
- package/templates/skills/vercel-react-native-skills/rules/react-compiler-reanimated-shared-values.md +48 -0
- package/templates/skills/vercel-react-native-skills/rules/react-state-dispatcher.md +91 -0
- package/templates/skills/vercel-react-native-skills/rules/react-state-fallback.md +56 -0
- package/templates/skills/vercel-react-native-skills/rules/react-state-minimize.md +65 -0
- package/templates/skills/vercel-react-native-skills/rules/rendering-no-falsy-and.md +74 -0
- package/templates/skills/vercel-react-native-skills/rules/rendering-text-in-text-component.md +36 -0
- package/templates/skills/vercel-react-native-skills/rules/scroll-position-no-state.md +82 -0
- package/templates/skills/vercel-react-native-skills/rules/state-ground-truth.md +80 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-expo-image.md +66 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-image-gallery.md +104 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-measure-views.md +78 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-menus.md +174 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-native-modals.md +77 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-pressable.md +61 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-safe-area-scroll.md +65 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-scrollview-content-inset.md +45 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-styling.md +87 -0
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "fontdata",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "4.5.0",
|
|
4
4
|
"mcpServers": {
|
|
5
|
-
"banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.
|
|
5
|
+
"banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.5.0", "banco-dados-mcp"] }
|
|
6
6
|
},
|
|
7
7
|
"description": "Harness de engenharia com IA da Fontdata para Claude Code",
|
|
8
8
|
"author": { "name": "Fontdata" },
|
package/README.md
CHANGED
|
@@ -102,7 +102,7 @@ npx @fontdata/ai-harness init --comandos resolver-bug,nova-tarefa --sem-harness
|
|
|
102
102
|
| `--yes` | Aplica; sem ele, só simula |
|
|
103
103
|
|
|
104
104
|
Com o plugin `fontdata@ai-harness` habilitado, o `init` não instala os hooks no projeto, para eles não rodarem
|
|
105
|
-
duas vezes.
|
|
105
|
+
duas vezes. A exceção é o hook do [perfil Delphi](#perfil-delphi), que não vem no plugin.
|
|
106
106
|
|
|
107
107
|
### Permissões para o modo auto
|
|
108
108
|
|
|
@@ -121,6 +121,119 @@ Ficam de fora os comandos de teste e build, que variam por projeto, e os que reg
|
|
|
121
121
|
Nos modos 1 e 2 nada é gravado no projeto: rode `npx @fontdata/ai-harness update --yes` num projeto já instalado,
|
|
122
122
|
ou `init`, para receber as regras.
|
|
123
123
|
|
|
124
|
+
## Perfil Delphi
|
|
125
|
+
|
|
126
|
+
Quando o projeto tem `.dpr` ou `.dproj` (até 3 níveis de pasta ou versionado no git), o `init` e o `update` instalam o perfil Delphi. Vale também com o
|
|
127
|
+
plugin habilitado e com `--sem-hooks`: o perfil só chega pelo `init`/`update`, nunca pelo plugin, e sempre leva o
|
|
128
|
+
hook. Projeto sem Delphi não recebe nada. O perfil é um item só no lock (`perfil:delphi`), e o `doctor` confere os
|
|
129
|
+
arquivos dele como confere os demais.
|
|
130
|
+
|
|
131
|
+
| O que instala | Onde |
|
|
132
|
+
|---|---|
|
|
133
|
+
| 26 rules de Delphi: build e verificação, encoding e EOL, threads e timers, `try`/`finally`, linguagem, dados e SQL, telas | `.claude/rules/delphi/` |
|
|
134
|
+
| Skill `conhecimento-delphi`: índice e 14 artigos de armadilhas (`.dproj`, FireDAC, `.dpr`, recursos, Horse, ACBr, Delphi 13...) | `.claude/skills/conhecimento-delphi/` |
|
|
135
|
+
| Hook `delphi-encoding`, em `PreToolUse` (`Edit\|MultiEdit`) e `PostToolUse` (`Write\|Edit\|MultiEdit`) | `.claude/hooks/delphi/encoding.mjs` |
|
|
136
|
+
|
|
137
|
+
Cada rule lista no `paths:` do frontmatter as extensões que lhe dizem respeito, entre `.pas`, `.dfm`, `.dpr`,
|
|
138
|
+
`.dpk`, `.inc`, `.dproj` e `.sql`, e só entra no contexto quando o Claude mexe num desses arquivos. A skill é consultada sob demanda. Os 14 artigos são
|
|
139
|
+
adaptações em pt-BR do plugin [delphi-dev](https://github.com/adrianosantostreina/delphi-dev), sob licença MIT;
|
|
140
|
+
o aviso fica em `.claude/skills/conhecimento-delphi/references/ATRIBUICAO.md`.
|
|
141
|
+
|
|
142
|
+
O `update` não sobrescreve arquivo do projeto que já exista num caminho do perfil, nem com `--forcar`, e não apaga
|
|
143
|
+
rules do projeto que repetem uma rule do perfil: tirar a duplicata fica com você.
|
|
144
|
+
|
|
145
|
+
### Perfil `delphi-fiscal`
|
|
146
|
+
|
|
147
|
+
Quando o projeto recebe o perfil Delphi e usa ACBr — algum `.dproj` (pelo mesmo critério de detecção do Delphi) ou o
|
|
148
|
+
`boss.json` da raiz cita `ACBr`, sem diferenciar maiúsculas —, o `init` e o `update` instalam também o perfil
|
|
149
|
+
`delphi-fiscal`, como o item `perfil:delphi-fiscal` no lock. Como o perfil Delphi, ele fica fora do plugin.
|
|
150
|
+
|
|
151
|
+
| O que instala | Onde |
|
|
152
|
+
|---|---|
|
|
153
|
+
| 4 rules de documento fiscal com ACBr: sucesso do webservice não prova o documento, campo novo do ACBr preenchido explicitamente, total de tributo como soma dos itens e retorno de evento da NF-e pelo `cStat` | `.claude/rules/delphi-fiscal/` |
|
|
154
|
+
| Skills `patch-acbr` e `diagnosticar-rejeicao-nfse` | `.claude/skills/patch-acbr/` e `.claude/skills/diagnosticar-rejeicao-nfse/` |
|
|
155
|
+
|
|
156
|
+
Para recusar, grave `"perfis": { "delphi-fiscal": false }` no `.ai-harness/config.json` e rode
|
|
157
|
+
`npx @fontdata/ai-harness update --yes`: o `update` tira o item do lock e **mantém** os arquivos. A recusa do perfil
|
|
158
|
+
Delphi (`perfis.delphi: false`) recusa também o fiscal e tira os dois itens do lock. Sem o perfil Delphi, por
|
|
159
|
+
recusa ou porque o projeto não é Delphi, o fiscal não é instalado.
|
|
160
|
+
|
|
161
|
+
### Hook `delphi-encoding`
|
|
162
|
+
|
|
163
|
+
| Arquivo | Antes de `Edit`/`MultiEdit` | Depois de `Write`/`Edit`/`MultiEdit` |
|
|
164
|
+
|---|---|---|
|
|
165
|
+
| `.pas`, `.dpr`, `.dpk`, `.inc` | não é UTF-8 → **bloqueia** e mostra o `delphi encoding converter`; UTF-8 sem BOM → avisa | avisa BOM ausente, U+FFFD, dupla codificação (`é`, `â€`) e EOL misto novos |
|
|
166
|
+
| `.dfm` texto | nada: o encoding do `.dfm` é preservado, nunca convertido | avisa U+FFFD novo e EOL diferente do anterior |
|
|
167
|
+
| `.dfm` binário, `.dproj` e o resto | ignorado | ignorado |
|
|
168
|
+
|
|
169
|
+
"Novo" compara com a versão do arquivo no `HEAD`; arquivo fora do git conta como todo novo, então o aviso se repete
|
|
170
|
+
até o defeito ser corrigido ou commitado. O modo fica em `hooks["delphi-encoding"]` no `.ai-harness/config.json`:
|
|
171
|
+
`bloqueio` (padrão, sem precisar gravar), `aviso` ou `desligado`. Se o hook não consegue ler o evento ou o arquivo,
|
|
172
|
+
ele sai sem bloquear.
|
|
173
|
+
|
|
174
|
+
### Configuração
|
|
175
|
+
|
|
176
|
+
```json
|
|
177
|
+
{
|
|
178
|
+
"hooks": { "delphi-encoding": "aviso" },
|
|
179
|
+
"delphi": { "ignorar": ["**/modules/**", "**/ACBr*/**", "**/Terceiros/**"] }
|
|
180
|
+
}
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
- **`delphi.ignorar`**: globs de arquivos que o hook e o `--todos` do comando pulam. `**` casa qualquer
|
|
184
|
+
profundidade, `*` casa dentro de um segmento; maiúsculas e minúsculas não importam, e `\` vale como separador.
|
|
185
|
+
Sem a chave, valem `['**/modules/**', '**/ACBr*/**']` (código de terceiros, que pode estar em ISO-8859-1 de
|
|
186
|
+
propósito); ao gravar a chave, repita esses dois se quiser mantê-los. Se o hook bloquear uma unit de terceiro,
|
|
187
|
+
acrescente a pasta dela aqui.
|
|
188
|
+
- **Recusar o perfil**: `"perfis": { "delphi": false }` e `npx @fontdata/ai-harness update --yes`. O `init` deixa de
|
|
189
|
+
instalar o perfil. Num projeto que já o tem, o `update` tira o item do lock e o registro do hook do
|
|
190
|
+
`.claude/settings.json` e **mantém** os arquivos; o relatório lista as pastas, que você pode apagar à mão. Depois
|
|
191
|
+
disso o `doctor` não acusa arquivo faltando.
|
|
192
|
+
|
|
193
|
+
Valor inválido em `delphi.ignorar` ou `perfis.delphi` é apontado pelo `doctor` como problema do config, e o padrão
|
|
194
|
+
vale.
|
|
195
|
+
|
|
196
|
+
### Comando `delphi encoding`
|
|
197
|
+
|
|
198
|
+
```bash
|
|
199
|
+
npx @fontdata/ai-harness delphi encoding detectar Unit1.pas Form1.dfm
|
|
200
|
+
npx @fontdata/ai-harness delphi encoding converter Unit1.pas
|
|
201
|
+
npx @fontdata/ai-harness delphi encoding checar --todos
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
- `detectar <arquivos|--todos>`: encoding (UTF-8 com BOM, UTF-8 sem BOM, CP1252, `.dfm` binário) e EOL de cada
|
|
205
|
+
arquivo.
|
|
206
|
+
- `converter <arquivos>`: só `.pas`, `.dpr`, `.dpk` e `.inc` (recusa `.dfm`). UTF-8 com BOM fica intacto; UTF-8 sem
|
|
207
|
+
BOM ganha só o BOM; o resto é lido como CP1252 e gravado em UTF-8 com BOM, sem perder acentos, `€` e aspas curvas.
|
|
208
|
+
O EOL de cada linha não muda.
|
|
209
|
+
- `checar <arquivos|--todos>`: U+FFFD, dupla codificação, BOM ausente (nas extensões do `converter`) e EOL misto;
|
|
210
|
+
sai com código 1 se achar algum.
|
|
211
|
+
|
|
212
|
+
`--todos` pega os fontes Delphi versionados (`git ls-files`) fora de `delphi.ignorar`. Arquivo passado pelo nome é
|
|
213
|
+
processado mesmo que case com `delphi.ignorar`.
|
|
214
|
+
|
|
215
|
+
### Comando `delphi catalogo`
|
|
216
|
+
|
|
217
|
+
```bash
|
|
218
|
+
npx @fontdata/ai-harness delphi catalogo
|
|
219
|
+
npx @fontdata/ai-harness delphi catalogo --pasta ../Bibliotecas/Fontdata --check
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
Gera o catálogo das Bibliotecas Fontdata em `.claude/skills/conhecimento-delphi/references/bibliotecas-fontdata.md`,
|
|
223
|
+
na raiz do projeto, que a skill `conhecimento-delphi` e a rule de reaproveitamento mandam consultar antes de criar um
|
|
224
|
+
helper. Por unit `Fontdata.*.pas`, ele traz os tipos públicos da `interface` e, de cada tipo, os métodos e as
|
|
225
|
+
propriedades `public` e `published`, com a assinatura; os class helpers trazem também o tipo que estendem. A lista de
|
|
226
|
+
fontes guarda o nome de cada unit e o `sha256` do conteúdo, sem caminho, então o catálogo pode ser versionado.
|
|
227
|
+
|
|
228
|
+
- Sem `--pasta`, as units são procuradas nas pastas do `DCC_UnitSearchPath` de todos os `.dproj` do projeto,
|
|
229
|
+
relativas à pasta de cada `.dproj`; entradas com `$(...)` são ignoradas. `--pasta <dir>`, que pode se repetir,
|
|
230
|
+
troca o search path pelas pastas informadas.
|
|
231
|
+
- `--check` não grava nada e sai com código 1 quando o catálogo falta ou diverge das units atuais.
|
|
232
|
+
|
|
233
|
+
Nenhuma unit encontrada é erro: passe `--pasta` com o caminho das Bibliotecas Fontdata. Num projeto com o perfil
|
|
234
|
+
Delphi e units `Fontdata.*` no search path, o `doctor` avisa `catalogo-fontdata-ausente` quando o catálogo não existe
|
|
235
|
+
e `catalogo-fontdata-desatualizado` quando ele não bate com as units; fora desse caso, não há aviso de catálogo.
|
|
236
|
+
|
|
124
237
|
## Conexões de banco de dados
|
|
125
238
|
|
|
126
239
|
O Claude pode ler o banco do projeto (PostgreSQL, MariaDB ou SQLite) sem que ninguém cole credencial no chat. O
|
|
@@ -170,6 +283,9 @@ projeto, cadastro, limites do filtro, produção, mascaramento e dúvidas freque
|
|
|
170
283
|
| `mapa [caminho]` | Símbolos públicos por pasta do código-fonte, pastas compartilhadas primeiro (`--limite <n>`, padrão 4000 caracteres) |
|
|
171
284
|
| `atalhos [caminho]` | Lista os `TODO:`/`FIXME:` do código-fonte e marca os sem gatilho (`--sem-gatilho`, `--json`) |
|
|
172
285
|
| `versao detectar\|calcular\|aplicar` | Fontes de versão do projeto, próxima versão e gravação nos arquivos (veja abaixo) |
|
|
286
|
+
| `delphi classificar\|extrair-icone` | Classifica os `.res` versionados de um projeto Delphi e extrai o ícone que só existe no `.res` |
|
|
287
|
+
| `delphi encoding detectar\|converter\|checar` | Encoding e EOL dos fontes Delphi: diagnóstico, conversão para UTF-8 com BOM e checagem (veja [Comando `delphi encoding`](#comando-delphi-encoding)) |
|
|
288
|
+
| `delphi catalogo` | Catálogo das units `Fontdata.*.pas` do search path dos `.dproj` (`--pasta <dir>`, `--check`; veja [Comando `delphi catalogo`](#comando-delphi-catalogo)) |
|
|
173
289
|
| `list` | Lista o catálogo |
|
|
174
290
|
|
|
175
291
|
O `mapa` lê TS/JS, Delphi, Python, C#, Java, Kotlin, Go, PHP, Rust e Dart. Outra linguagem, ou outra regra para uma
|
|
@@ -228,9 +344,29 @@ Os formatos estão em [`docs/contratos/ARTEFATOS.md`](docs/contratos/ARTEFATOS.m
|
|
|
228
344
|
| `proteger-contratos` | SPEC, PLAN ou CLAUDE.md reescritos durante a execução de um trabalho | aviso |
|
|
229
345
|
| `task-so-fecha-verde` | Task marcada como concluída sem suíte verde no rastro | aviso |
|
|
230
346
|
| `sem-jargao` | Termo técnico no relatório para o cliente | aviso |
|
|
347
|
+
| `padroes-proibidos` | `Edit`, `MultiEdit` ou `Write` que introduz um padrão declarado em `.ai-harness/padroes.json` | aviso |
|
|
231
348
|
|
|
232
349
|
O modo de cada hook (`aviso`, `bloqueio` ou `desligado`) fica em `.ai-harness/config.json`. Hook que falha
|
|
233
|
-
internamente não atrapalha o trabalho — exceto o de segurança em modo bloqueio.
|
|
350
|
+
internamente não atrapalha o trabalho — exceto o de segurança em modo bloqueio. Projetos Delphi recebem também o
|
|
351
|
+
hook `delphi-encoding`, do [perfil Delphi](#perfil-delphi).
|
|
352
|
+
|
|
353
|
+
O `padroes-proibidos` vale para qualquer stack e só age no projeto que cria o `.ai-harness/padroes.json`; sem o
|
|
354
|
+
arquivo, ou com a lista vazia, ele não faz nada. Cada entrada traz as extensões, a regex, os flags e o motivo
|
|
355
|
+
mostrado ao agente. Só o padrão **introduzido** é acusado: o hook conta as ocorrências no texto antigo e no novo
|
|
356
|
+
(`old_string` contra `new_string` no `Edit`, a soma das `edits` no `MultiEdit`, o arquivo em disco contra o
|
|
357
|
+
`content` no `Write`) e acusa quando o novo tem mais. Dos flags, valem só `i`, `m`, `s` e `u`; uma entrada com regex
|
|
358
|
+
que não compila ou com campo faltando é ignorada, e as demais continuam valendo. Em `aviso` o motivo entra como
|
|
359
|
+
contexto, em `bloqueio` a edição é negada. O `update` registra no `.claude/settings.json` os hooks do núcleo que
|
|
360
|
+
faltam num projeto sem plugin e com os hooks do harness no lock, então um hook tirado à mão do settings volta no próximo `update`: para desligar, grave
|
|
361
|
+
`hooks["<nome>"]: "desligado"` no `.ai-harness/config.json`, por exemplo `"hooks": { "padroes-proibidos": "desligado" }`.
|
|
362
|
+
|
|
363
|
+
```json
|
|
364
|
+
{
|
|
365
|
+
"padroes": [
|
|
366
|
+
{ "extensoes": [".pas"], "regex": "Clipboard\\s*\\.\\s*AsText\\s*:=", "flags": "i", "motivo": "Use o helper de clipboard do projeto." }
|
|
367
|
+
]
|
|
368
|
+
}
|
|
369
|
+
```
|
|
234
370
|
|
|
235
371
|
### Agents somente leitura
|
|
236
372
|
|
|
@@ -272,7 +408,7 @@ também acionado pelo modelo quando o pedido combina.
|
|
|
272
408
|
- `/memoria` **(skill)** — mostra quem já mexeu num arquivo e por quê e aponta regressões candidatas de um bug
|
|
273
409
|
- `/auditar-ui` **(skill)** — navega a aplicação via Playwright MCP e audita UX/UI e acessibilidade
|
|
274
410
|
- `/auditar-performance` **(skill)** — mede e audita gargalos de performance
|
|
275
|
-
- `/auditar-seguranca` **(skill)** — auditoria defensiva de segurança e conformidade com a LGPD
|
|
411
|
+
- `/auditar-seguranca` **(skill)** — auditoria defensiva de segurança e conformidade com a LGPD, com os perfis `quick` (padrão), `standard` e `deep` (`/auditar-seguranca deep`); no fim, oferece criar o trabalho de correção, com uma task por achado
|
|
276
412
|
|
|
277
413
|
### Utilitário
|
|
278
414
|
- `/git-commit-push` ⭐ — gera a mensagem (PT-BR, Conventional Commits) e faz add, commit e push
|
|
@@ -300,6 +436,21 @@ A skill `lgpd-checker`, usada pela auditoria de segurança, é uma cópia vendor
|
|
|
300
436
|
[bittencourtthulio/lgpd-checker](https://github.com/bittencourtthulio/lgpd-checker); veja
|
|
301
437
|
`templates/skills/lgpd-checker/ORIGEM.md`.
|
|
302
438
|
|
|
439
|
+
As outras skills e referências de terceiros também são cópias vendorizadas, sem alteração no conteúdo e com a
|
|
440
|
+
licença MIT de origem. Créditos aos autores:
|
|
441
|
+
|
|
442
|
+
- `security-audit`, da Cloudflare — [cloudflare/security-audit-skill](https://github.com/cloudflare/security-audit-skill);
|
|
443
|
+
usada pelo `/auditar-seguranca`. Veja `templates/skills/security-audit/ORIGEM.md`.
|
|
444
|
+
- `vercel-react-best-practices`, da Vercel — [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills);
|
|
445
|
+
usada pelo `/auditar-performance`. Veja `templates/skills/vercel-react-best-practices/ORIGEM.md`.
|
|
446
|
+
- `vercel-react-native-skills`, da Vercel — [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills);
|
|
447
|
+
usada pelo `/auditar-performance`. Veja `templates/skills/vercel-react-native-skills/ORIGEM.md`.
|
|
448
|
+
- `supabase-postgres-best-practices`, da Supabase — [supabase/agent-skills](https://github.com/supabase/agent-skills);
|
|
449
|
+
usada pelo `/auditar-performance`. Veja `templates/skills/supabase-postgres-best-practices/ORIGEM.md`.
|
|
450
|
+
- Web Interface Guidelines, da Vercel — [vercel-labs/web-interface-guidelines](https://github.com/vercel-labs/web-interface-guidelines);
|
|
451
|
+
referência do `/auditar-ui`, em `templates/skills/auditar-ui/references/web-interface-guidelines.md`. Veja
|
|
452
|
+
`templates/skills/auditar-ui/references/ATRIBUICAO.md`.
|
|
453
|
+
|
|
303
454
|
## Fluxo recomendado
|
|
304
455
|
|
|
305
456
|
O jeito mais simples é rodar **`/harness`**, que pergunta se o projeto é novo ou existente e conduz as etapas:
|
package/dist/cli.js
CHANGED
|
@@ -72,6 +72,7 @@ Gerenciar:
|
|
|
72
72
|
banco-dados-mcp Servidor MCP de leitura do banco, usado pelo Claude Code (stdio)
|
|
73
73
|
versao detectar|calcular|aplicar Fontes de versão, próxima versão e gravação (--app, --json; aplicar --dry-run)
|
|
74
74
|
delphi classificar|extrair-icone .res de projetos Delphi: classificação e extração do ícone
|
|
75
|
+
delphi catalogo Catálogo da API das units Fontdata.*.pas do search path (--pasta <dir>, --check)
|
|
75
76
|
mapa [caminho] Símbolos públicos por pasta, compartilhadas primeiro (--limite <n>, padrão 4000 caracteres)
|
|
76
77
|
atalhos [caminho] TODO:/FIXME: do código-fonte, marcando os sem gatilho (--sem-gatilho, --json)
|
|
77
78
|
list Lista todos os comandos disponíveis no catálogo
|
package/dist/config/config.js
CHANGED
|
@@ -10,9 +10,12 @@ export const DEFAULT_HOOK_MODES = {
|
|
|
10
10
|
'task-so-fecha-verde': 'aviso',
|
|
11
11
|
'proteger-contratos': 'aviso',
|
|
12
12
|
'sem-jargao': 'aviso',
|
|
13
|
+
'padroes-proibidos': 'aviso',
|
|
13
14
|
};
|
|
14
15
|
export const MODOS_PRODUCAO = ['aviso', 'bloqueio'];
|
|
15
16
|
export const TIPOS_CONEXAO_PROJETO = ['postgres', 'mariadb', 'sqlite'];
|
|
17
|
+
export const PERFIS_DO_CONFIG = ['delphi', 'delphi-fiscal'];
|
|
18
|
+
export const DELPHI_IGNORAR_PADRAO = ['**/modules/**', '**/ACBr*/**'];
|
|
16
19
|
function isObject(value) {
|
|
17
20
|
return typeof value === 'object' && value !== null && !Array.isArray(value);
|
|
18
21
|
}
|
|
@@ -73,6 +76,8 @@ export function defaultConfig() {
|
|
|
73
76
|
declarado: false,
|
|
74
77
|
},
|
|
75
78
|
comentarios: { instalar: true },
|
|
79
|
+
perfis: { delphi: true, 'delphi-fiscal': true },
|
|
80
|
+
delphi: { ignorar: [...DELPHI_IGNORAR_PADRAO] },
|
|
76
81
|
};
|
|
77
82
|
}
|
|
78
83
|
function inteiroEntre(value, min, max) {
|
|
@@ -239,6 +244,22 @@ export function readConfig(root) {
|
|
|
239
244
|
else
|
|
240
245
|
problems.push(`comentarios.instalar deve ser true ou false em ${CONFIG_PATH}.`);
|
|
241
246
|
}
|
|
247
|
+
for (const perfil of PERFIS_DO_CONFIG) {
|
|
248
|
+
if (!isObject(raw.perfis) || !(perfil in raw.perfis))
|
|
249
|
+
continue;
|
|
250
|
+
const valor = raw.perfis[perfil];
|
|
251
|
+
if (typeof valor === 'boolean')
|
|
252
|
+
config.perfis[perfil] = valor;
|
|
253
|
+
else
|
|
254
|
+
problems.push(`perfis.${perfil} deve ser true ou false em ${CONFIG_PATH}.`);
|
|
255
|
+
}
|
|
256
|
+
if (isObject(raw.delphi) && 'ignorar' in raw.delphi) {
|
|
257
|
+
const ignorar = raw.delphi.ignorar;
|
|
258
|
+
if (Array.isArray(ignorar) && ignorar.every((glob) => typeof glob === 'string'))
|
|
259
|
+
config.delphi.ignorar = ignorar;
|
|
260
|
+
else
|
|
261
|
+
problems.push(`delphi.ignorar deve ser uma lista de globs (texto) em ${CONFIG_PATH}; valem os padrões.`);
|
|
262
|
+
}
|
|
242
263
|
const secao = soSecaoLegada(raw) ? raw[BANCO_CHAVE_LEGADA] : raw[BANCO_CHAVE];
|
|
243
264
|
if (isObject(secao))
|
|
244
265
|
lerBanco(secao, config.banco_dados, problems);
|
|
@@ -250,12 +271,12 @@ export function readConfig(root) {
|
|
|
250
271
|
}
|
|
251
272
|
return { config, problems };
|
|
252
273
|
}
|
|
253
|
-
/** Os padrões que vão para o arquivo: sem as seções banco_dados e
|
|
274
|
+
/** Os padrões que vão para o arquivo: sem as seções banco_dados, comentarios, perfis e delphi, que só entram quando mudam. */
|
|
254
275
|
function configGravada() {
|
|
255
|
-
const { banco_dados: _banco, comentarios: _comentarios, ...gravada } = defaultConfig();
|
|
276
|
+
const { banco_dados: _banco, comentarios: _comentarios, perfis: _perfis, delphi: _delphi, ...gravada } = defaultConfig();
|
|
256
277
|
return gravada;
|
|
257
278
|
}
|
|
258
|
-
/** Cria a config com os padrões, sem as seções
|
|
279
|
+
/** Cria a config com os padrões, sem as seções que só entram quando mudam; retorna false se já existia (nunca sobrescreve). */
|
|
259
280
|
export function writeDefaultConfig(root) {
|
|
260
281
|
const file = join(root, CONFIG_PATH);
|
|
261
282
|
if (existsSync(file))
|
|
@@ -373,6 +394,27 @@ export function gravarInstalarComentarios(root, valor) {
|
|
|
373
394
|
mkdirSync(dirname(file), { recursive: true });
|
|
374
395
|
writeFileSync(file, `${JSON.stringify(proxima, null, 2)}\n`);
|
|
375
396
|
}
|
|
397
|
+
/**
|
|
398
|
+
* Grava a recusa do perfil (`perfis.<id>: false`), preservando o resto do JSON; sem config, cria uma com os padrões e
|
|
399
|
+
* essa chave. `true` desfaz a recusa apagando a chave, e não cria o arquivo. JSON inválido é recusado sem tocar no
|
|
400
|
+
* arquivo.
|
|
401
|
+
*/
|
|
402
|
+
export function gravarPerfil(root, perfil, valor) {
|
|
403
|
+
const file = join(root, CONFIG_PATH);
|
|
404
|
+
if (!existsSync(file) && valor)
|
|
405
|
+
return;
|
|
406
|
+
const raw = existsSync(file) ? lerJsonParaEscrita(file, `perfis.${perfil}`) : configGravada();
|
|
407
|
+
const { [perfil]: atual, ...resto } = isObject(raw.perfis) ? raw.perfis : {};
|
|
408
|
+
if (valor ? atual === undefined || atual === true : atual === false)
|
|
409
|
+
return;
|
|
410
|
+
const { perfis: _perfis, ...semSecao } = raw;
|
|
411
|
+
const proxima = valor ? (Object.keys(resto).length ? { ...raw, perfis: resto } : semSecao) : { ...raw, perfis: { ...resto, [perfil]: false } };
|
|
412
|
+
mkdirSync(dirname(file), { recursive: true });
|
|
413
|
+
writeFileSync(file, `${JSON.stringify(proxima, null, 2)}\n`);
|
|
414
|
+
}
|
|
415
|
+
export function gravarPerfilDelphi(root, valor) {
|
|
416
|
+
gravarPerfil(root, 'delphi', valor);
|
|
417
|
+
}
|
|
376
418
|
const BLOCK_START = '# ai-harness (gerenciado pelo harness; não edite entre estas linhas)';
|
|
377
419
|
const BLOCK_END = '# /ai-harness';
|
|
378
420
|
/**
|
|
@@ -0,0 +1,299 @@
|
|
|
1
|
+
import { existsSync, readdirSync, readFileSync } from 'node:fs';
|
|
2
|
+
import { dirname, join, resolve } from 'node:path';
|
|
3
|
+
import { hashContent } from '../install/lock.js';
|
|
4
|
+
import { semComentariosPascal } from '../mapa/extratores/pascal.js';
|
|
5
|
+
import { arquivosDproj } from './classificar.js';
|
|
6
|
+
export const CAMINHO_CATALOGO = '.claude/skills/conhecimento-delphi/references/bibliotecas-fontdata.md';
|
|
7
|
+
const VISIBILIDADE = /^(strict\s+private|strict\s+protected|private|protected|public|published|automated)\b\s*/i;
|
|
8
|
+
const SECAO_DO_TIPO = /^(class\s+var|type|const|var|threadvar|resourcestring)\b\s*/i;
|
|
9
|
+
const SECAO_DO_TOPO = /^(type|const|var|threadvar|resourcestring)\b\s*/i;
|
|
10
|
+
const ATRIBUTO = /^\[[^\]]*\]\s*/;
|
|
11
|
+
const MEMBRO = /^(class\s+)?(function|procedure|constructor|destructor|property|operator)\b/i;
|
|
12
|
+
const ROTINA = /^(function|procedure)\b/i;
|
|
13
|
+
const DIRETIVA = /^(overload|override|virtual|dynamic|abstract|reintroduce|static|inline|stdcall|cdecl|register|safecall|pascal|final|default|nodefault|deprecated|platform|experimental|message|dispid|varargs|external|assembler)\b(?!\s*[:=])/i;
|
|
14
|
+
const CABECALHO = /^([A-Za-z_]\w*(?:\s*<[^>]*>)?)\s*=\s*(.*)$/;
|
|
15
|
+
const HELPER = /^((?:class|record)\s+helper\s*(?:\([^)]*\))?\s+for\s+[\w.]+(?:\s*<[^>]*>)?)\s*(.*)$/i;
|
|
16
|
+
const ESTRUTURA = /^((?:packed\s+)?(class|record|object|interface|dispinterface)\b(?:\s+(?:sealed|abstract))?\s*(?:\([^)]*\))?\s*(?:\[[^\]]*\])?)\s*(.*)$/i;
|
|
17
|
+
const RECORD_ANONIMO = /^[\w\s,]+:\s*(packed\s+)?record\b\s*(.*)$/i;
|
|
18
|
+
export function pastasDoSearchPath(raiz) {
|
|
19
|
+
const pastas = [];
|
|
20
|
+
for (const rel of arquivosDproj(raiz)) {
|
|
21
|
+
const dproj = join(raiz, rel);
|
|
22
|
+
let xml;
|
|
23
|
+
try {
|
|
24
|
+
xml = readFileSync(dproj, 'utf8');
|
|
25
|
+
}
|
|
26
|
+
catch {
|
|
27
|
+
continue;
|
|
28
|
+
}
|
|
29
|
+
for (const grupo of xml.matchAll(/<DCC_UnitSearchPath>([\s\S]*?)<\/DCC_UnitSearchPath>/gi)) {
|
|
30
|
+
for (const entrada of (grupo[1] ?? '').split(';')) {
|
|
31
|
+
const caminho = entrada.trim().replace(/\\/g, '/');
|
|
32
|
+
if (!caminho || caminho.includes('$('))
|
|
33
|
+
continue;
|
|
34
|
+
const pasta = resolve(dirname(dproj), caminho);
|
|
35
|
+
if (!pastas.includes(pasta))
|
|
36
|
+
pastas.push(pasta);
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
return pastas;
|
|
41
|
+
}
|
|
42
|
+
export function acharUnitsFontdata(pastas) {
|
|
43
|
+
const units = new Map();
|
|
44
|
+
for (const pasta of pastas) {
|
|
45
|
+
let arquivos;
|
|
46
|
+
try {
|
|
47
|
+
arquivos = readdirSync(pasta).sort();
|
|
48
|
+
}
|
|
49
|
+
catch {
|
|
50
|
+
continue;
|
|
51
|
+
}
|
|
52
|
+
for (const arquivo of arquivos) {
|
|
53
|
+
const nome = arquivo.slice(0, -'.pas'.length);
|
|
54
|
+
if (!/^Fontdata\..+\.pas$/i.test(arquivo) || units.has(nome.toLowerCase()))
|
|
55
|
+
continue;
|
|
56
|
+
try {
|
|
57
|
+
units.set(nome.toLowerCase(), { nome, conteudo: readFileSync(join(pasta, arquivo)) });
|
|
58
|
+
}
|
|
59
|
+
catch {
|
|
60
|
+
continue;
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
return [...units.values()].sort((a, b) => (a.nome < b.nome ? -1 : a.nome > b.nome ? 1 : 0));
|
|
65
|
+
}
|
|
66
|
+
function semStrings(texto) {
|
|
67
|
+
return texto.replace(/'[^'\n]*'/g, (m) => m.replace(/[^\n]/g, ' '));
|
|
68
|
+
}
|
|
69
|
+
function mascararStrings(fonte) {
|
|
70
|
+
let saida = '';
|
|
71
|
+
let fimDoComentario = null;
|
|
72
|
+
let emString = false;
|
|
73
|
+
for (let i = 0; i < fonte.length; i++) {
|
|
74
|
+
const c = fonte[i];
|
|
75
|
+
if (fimDoComentario) {
|
|
76
|
+
if (fonte.startsWith(fimDoComentario, i) && fimDoComentario.length > 1) {
|
|
77
|
+
saida += fimDoComentario;
|
|
78
|
+
i += fimDoComentario.length - 1;
|
|
79
|
+
fimDoComentario = null;
|
|
80
|
+
continue;
|
|
81
|
+
}
|
|
82
|
+
if (c === fimDoComentario)
|
|
83
|
+
fimDoComentario = null;
|
|
84
|
+
saida += c;
|
|
85
|
+
}
|
|
86
|
+
else if (emString) {
|
|
87
|
+
if (c === "'" && fonte[i + 1] === "'") {
|
|
88
|
+
saida += '__';
|
|
89
|
+
i++;
|
|
90
|
+
continue;
|
|
91
|
+
}
|
|
92
|
+
if (c === "'" || c === '\n')
|
|
93
|
+
emString = false;
|
|
94
|
+
saida += c === "'" || c === '\n' ? c : '_';
|
|
95
|
+
}
|
|
96
|
+
else {
|
|
97
|
+
if (c === "'")
|
|
98
|
+
emString = true;
|
|
99
|
+
else if (c === '{')
|
|
100
|
+
fimDoComentario = '}';
|
|
101
|
+
else if (c === '/' && fonte[i + 1] === '/')
|
|
102
|
+
fimDoComentario = '\n';
|
|
103
|
+
else if (c === '(' && fonte[i + 1] === '*')
|
|
104
|
+
fimDoComentario = '*)';
|
|
105
|
+
saida += c;
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
return saida;
|
|
109
|
+
}
|
|
110
|
+
function semComentariosPreservandoStrings(fonte) {
|
|
111
|
+
const mascarado = mascararStrings(fonte);
|
|
112
|
+
const limpo = semComentariosPascal(mascarado);
|
|
113
|
+
let saida = '';
|
|
114
|
+
for (let i = 0; i < limpo.length; i++)
|
|
115
|
+
saida += limpo[i] === '_' && mascarado[i] === '_' ? fonte[i] : limpo[i];
|
|
116
|
+
return saida;
|
|
117
|
+
}
|
|
118
|
+
function declaracoesDaInterface(fonte) {
|
|
119
|
+
const limpo = semComentariosPreservandoStrings(fonte);
|
|
120
|
+
const inicio = /^\s*interface\b/im.exec(limpo);
|
|
121
|
+
if (!inicio)
|
|
122
|
+
return [];
|
|
123
|
+
const resto = limpo.slice(inicio.index + inicio[0].length);
|
|
124
|
+
const fim = /^\s*implementation\b/im.exec(resto);
|
|
125
|
+
const secao = fim ? resto.slice(0, fim.index) : resto;
|
|
126
|
+
const mascara = semStrings(secao);
|
|
127
|
+
const declaracoes = [];
|
|
128
|
+
let profundidade = 0;
|
|
129
|
+
let comeco = 0;
|
|
130
|
+
for (let i = 0; i < mascara.length; i++) {
|
|
131
|
+
const c = mascara[i];
|
|
132
|
+
if (c === '(' || c === '[')
|
|
133
|
+
profundidade++;
|
|
134
|
+
else if ((c === ')' || c === ']') && profundidade > 0)
|
|
135
|
+
profundidade--;
|
|
136
|
+
else if (c === ';' && profundidade === 0) {
|
|
137
|
+
declaracoes.push(secao.slice(comeco, i).replace(/\s+/g, ' ').trim());
|
|
138
|
+
comeco = i + 1;
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
return declaracoes;
|
|
142
|
+
}
|
|
143
|
+
function abrirTipo(definicao) {
|
|
144
|
+
if (/^class\s+of\b/i.test(definicao))
|
|
145
|
+
return null;
|
|
146
|
+
const abertura = HELPER.exec(definicao) ?? ESTRUTURA.exec(definicao);
|
|
147
|
+
if (!abertura)
|
|
148
|
+
return null;
|
|
149
|
+
const cabeca = (abertura[1] ?? '').replace(/\s*\[[^\]]*\]$/, '').trim();
|
|
150
|
+
return { cabeca, corpo: abertura[abertura.length - 1] ?? '' };
|
|
151
|
+
}
|
|
152
|
+
export function extrairApi(fonte) {
|
|
153
|
+
const api = { tipos: [], rotinas: [] };
|
|
154
|
+
const abertos = [];
|
|
155
|
+
let secaoDeTipos = false;
|
|
156
|
+
let ultimo = null;
|
|
157
|
+
for (const declaracao of declaracoesDaInterface(fonte)) {
|
|
158
|
+
let resto = declaracao;
|
|
159
|
+
while (resto) {
|
|
160
|
+
resto = resto.replace(ATRIBUTO, '');
|
|
161
|
+
const topo = abertos[abertos.length - 1];
|
|
162
|
+
if (DIRETIVA.test(resto)) {
|
|
163
|
+
if (ultimo && ultimo.length > 0)
|
|
164
|
+
ultimo[ultimo.length - 1] += ` ${resto};`;
|
|
165
|
+
break;
|
|
166
|
+
}
|
|
167
|
+
if (topo) {
|
|
168
|
+
const visibilidade = VISIBILIDADE.exec(resto);
|
|
169
|
+
if (visibilidade) {
|
|
170
|
+
topo.visivel = /^(public|published|automated)$/i.test(visibilidade[1] ?? '');
|
|
171
|
+
resto = resto.slice(visibilidade[0].length);
|
|
172
|
+
continue;
|
|
173
|
+
}
|
|
174
|
+
const fim = /^end\b\s*/i.exec(resto);
|
|
175
|
+
if (fim) {
|
|
176
|
+
abertos.pop();
|
|
177
|
+
resto = resto.slice(fim[0].length);
|
|
178
|
+
continue;
|
|
179
|
+
}
|
|
180
|
+
const secao = SECAO_DO_TIPO.exec(resto);
|
|
181
|
+
if (secao) {
|
|
182
|
+
resto = resto.slice(secao[0].length);
|
|
183
|
+
continue;
|
|
184
|
+
}
|
|
185
|
+
if (MEMBRO.test(resto)) {
|
|
186
|
+
const publico = abertos.length === 1 && topo.visivel && topo.tipo;
|
|
187
|
+
if (publico)
|
|
188
|
+
topo.tipo.membros.push(`${resto};`);
|
|
189
|
+
ultimo = publico ? topo.tipo.membros : null;
|
|
190
|
+
break;
|
|
191
|
+
}
|
|
192
|
+
const anonimo = RECORD_ANONIMO.exec(resto);
|
|
193
|
+
const aninhado = anonimo ? null : CABECALHO.exec(resto);
|
|
194
|
+
const corpo = anonimo ? (anonimo[2] ?? '') : (abrirTipo(aninhado?.[2] ?? '')?.corpo ?? '');
|
|
195
|
+
ultimo = null;
|
|
196
|
+
if (!corpo)
|
|
197
|
+
break;
|
|
198
|
+
abertos.push({ visivel: false });
|
|
199
|
+
resto = corpo;
|
|
200
|
+
continue;
|
|
201
|
+
}
|
|
202
|
+
const secao = SECAO_DO_TOPO.exec(resto);
|
|
203
|
+
if (secao) {
|
|
204
|
+
secaoDeTipos = /^type$/i.test(secao[1] ?? '');
|
|
205
|
+
resto = resto.slice(secao[0].length);
|
|
206
|
+
continue;
|
|
207
|
+
}
|
|
208
|
+
if (/^uses\b/i.test(resto))
|
|
209
|
+
break;
|
|
210
|
+
if (ROTINA.test(resto)) {
|
|
211
|
+
api.rotinas.push(`${resto};`);
|
|
212
|
+
ultimo = api.rotinas;
|
|
213
|
+
secaoDeTipos = false;
|
|
214
|
+
break;
|
|
215
|
+
}
|
|
216
|
+
const cabecalho = secaoDeTipos ? CABECALHO.exec(resto) : null;
|
|
217
|
+
if (!cabecalho) {
|
|
218
|
+
ultimo = null;
|
|
219
|
+
break;
|
|
220
|
+
}
|
|
221
|
+
const nome = (cabecalho[1] ?? '').replace(/\s+/g, '');
|
|
222
|
+
const definicao = cabecalho[2] ?? '';
|
|
223
|
+
const abertura = abrirTipo(definicao);
|
|
224
|
+
ultimo = null;
|
|
225
|
+
if (!abertura) {
|
|
226
|
+
api.tipos.push({ nome, declaracao: definicao, membros: [] });
|
|
227
|
+
break;
|
|
228
|
+
}
|
|
229
|
+
const { cabeca, corpo } = abertura;
|
|
230
|
+
if (!corpo && /^(class|interface|dispinterface)$/i.test(cabeca))
|
|
231
|
+
break;
|
|
232
|
+
const tipo = { nome, declaracao: cabeca, membros: [] };
|
|
233
|
+
api.tipos.push(tipo);
|
|
234
|
+
if (!corpo)
|
|
235
|
+
break;
|
|
236
|
+
abertos.push({ tipo, visivel: true });
|
|
237
|
+
resto = corpo;
|
|
238
|
+
}
|
|
239
|
+
}
|
|
240
|
+
return api;
|
|
241
|
+
}
|
|
242
|
+
function renderizarUnit(unit) {
|
|
243
|
+
const { tipos, rotinas } = extrairApi(unit.conteudo.toString('utf8').replace(/^/, ''));
|
|
244
|
+
const linhas = [`## ${unit.nome}`, ''];
|
|
245
|
+
if (tipos.length === 0 && rotinas.length === 0)
|
|
246
|
+
linhas.push('Nada público na `interface`.', '');
|
|
247
|
+
for (const tipo of tipos) {
|
|
248
|
+
linhas.push(`### \`${tipo.nome} = ${tipo.declaracao}\``, '');
|
|
249
|
+
if (tipo.membros.length > 0)
|
|
250
|
+
linhas.push(...tipo.membros.map((m) => `- \`${m}\``), '');
|
|
251
|
+
}
|
|
252
|
+
if (rotinas.length > 0)
|
|
253
|
+
linhas.push('### Rotinas', '', ...rotinas.map((r) => `- \`${r}\``), '');
|
|
254
|
+
return linhas;
|
|
255
|
+
}
|
|
256
|
+
export function gerarCatalogo(units) {
|
|
257
|
+
const linhas = [
|
|
258
|
+
'# Catálogo das units Fontdata',
|
|
259
|
+
'',
|
|
260
|
+
'Gerado por `npx @fontdata/ai-harness delphi catalogo` a partir das units `Fontdata.*.pas` do search path do',
|
|
261
|
+
'projeto. Antes de criar um helper ou utilitário, procure aqui o que já existe. Não edite à mão: quando as units',
|
|
262
|
+
'mudarem, rode o comando de novo.',
|
|
263
|
+
'',
|
|
264
|
+
'## Fontes',
|
|
265
|
+
'',
|
|
266
|
+
'| Unit | sha256 |',
|
|
267
|
+
'|---|---|',
|
|
268
|
+
...units.map((unit) => `| ${unit.nome} | ${hashContent(unit.conteudo)} |`),
|
|
269
|
+
'',
|
|
270
|
+
...units.flatMap(renderizarUnit),
|
|
271
|
+
];
|
|
272
|
+
return `${linhas.join('\n').trimEnd()}\n`;
|
|
273
|
+
}
|
|
274
|
+
export function lerFontesDoCatalogo(texto) {
|
|
275
|
+
const fontes = new Map();
|
|
276
|
+
for (const linha of texto.split(/\r?\n/)) {
|
|
277
|
+
const fonte = /^\| (Fontdata\.[^|\s]+) \| ([0-9a-f]{64}) \|$/.exec(linha);
|
|
278
|
+
if (fonte)
|
|
279
|
+
fontes.set(fonte[1], fonte[2]);
|
|
280
|
+
}
|
|
281
|
+
return fontes;
|
|
282
|
+
}
|
|
283
|
+
export function estadoDoCatalogo(arquivo, units) {
|
|
284
|
+
if (units.length === 0)
|
|
285
|
+
return 'sem-units';
|
|
286
|
+
if (!existsSync(arquivo))
|
|
287
|
+
return 'ausente';
|
|
288
|
+
const fontes = lerFontesDoCatalogo(readFileSync(arquivo, 'utf8'));
|
|
289
|
+
const emDia = fontes.size === units.length && units.every((unit) => fontes.get(unit.nome) === hashContent(unit.conteudo));
|
|
290
|
+
return emDia ? 'em-dia' : 'desatualizado';
|
|
291
|
+
}
|
|
292
|
+
/**
|
|
293
|
+
* Estado do catálogo gravado na raiz contra as units `Fontdata.*.pas` do search path dos `.dproj`, ou das
|
|
294
|
+
* `pastas` informadas. `sem-units` quando nenhuma unit é encontrada, caso em que não há o que avisar.
|
|
295
|
+
*/
|
|
296
|
+
export function checarCatalogo(raiz, pastas) {
|
|
297
|
+
const units = acharUnitsFontdata(pastas ?? pastasDoSearchPath(raiz));
|
|
298
|
+
return estadoDoCatalogo(join(raiz, CAMINHO_CATALOGO), units);
|
|
299
|
+
}
|
|
@@ -13,6 +13,27 @@ export function detectarDelphi(raiz) {
|
|
|
13
13
|
return true;
|
|
14
14
|
return Boolean(git(raiz, ['ls-files', '--', ':(icase)*.dproj', ':(icase)*.dpr'])?.trim());
|
|
15
15
|
}
|
|
16
|
+
/** Os `.dproj` do projeto pelo critério de `detectarDelphi`: até 3 níveis de pasta, mais os versionados no git. */
|
|
17
|
+
export function arquivosDproj(raiz) {
|
|
18
|
+
const achados = new Set(varrerArquivos(raiz, '', 3, /\.dproj$/i));
|
|
19
|
+
for (const nome of git(raiz, ['ls-files', '--', ':(icase)*.dproj'])?.split('\n') ?? []) {
|
|
20
|
+
if (nome)
|
|
21
|
+
achados.add(nome);
|
|
22
|
+
}
|
|
23
|
+
return [...achados].sort();
|
|
24
|
+
}
|
|
25
|
+
function citaAcbr(arquivo) {
|
|
26
|
+
try {
|
|
27
|
+
return /acbr/i.test(readFileSync(arquivo, 'utf8'));
|
|
28
|
+
}
|
|
29
|
+
catch {
|
|
30
|
+
return false;
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
/** Algum `.dproj` ou o `boss.json` da raiz cita ACBr, sem diferenciar maiúsculas. */
|
|
34
|
+
export function detectarAcbr(raiz) {
|
|
35
|
+
return citaAcbr(join(raiz, 'boss.json')) || arquivosDproj(raiz).some((rel) => citaAcbr(join(raiz, rel)));
|
|
36
|
+
}
|
|
16
37
|
export function emRepositorioGit(raiz) {
|
|
17
38
|
return git(raiz, ['rev-parse', '--is-inside-work-tree'])?.trim() === 'true';
|
|
18
39
|
}
|