@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
|
@@ -0,0 +1,317 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// @ts-check
|
|
3
|
+
import { spawnSync } from 'node:child_process';
|
|
4
|
+
import { existsSync, readFileSync, realpathSync } from 'node:fs';
|
|
5
|
+
import { basename, dirname, isAbsolute, join, relative, resolve } from 'node:path';
|
|
6
|
+
import { fileURLToPath } from 'node:url';
|
|
7
|
+
|
|
8
|
+
/** @typedef {'aviso' | 'bloqueio' | 'desligado'} Modo */
|
|
9
|
+
/** @typedef {'utf8-bom' | 'utf8-sem-bom' | 'cp1252' | 'dfm-binario'} Encoding */
|
|
10
|
+
/** @typedef {'crlf' | 'lf' | 'misto' | 'nenhum'} Eol */
|
|
11
|
+
/** @typedef {{ linha: number, mensagem: string, texto: string }} Problema */
|
|
12
|
+
|
|
13
|
+
const NOME = 'delphi-encoding';
|
|
14
|
+
/** @type {Modo} */
|
|
15
|
+
const MODO_PADRAO = 'bloqueio';
|
|
16
|
+
/** @type {Modo[]} */
|
|
17
|
+
const MODOS = ['aviso', 'bloqueio', 'desligado'];
|
|
18
|
+
const IGNORAR_PADRAO = ['**/modules/**', '**/ACBr*/**'];
|
|
19
|
+
const EXTENSOES_CONVERTER = ['.pas', '.dpr', '.dpk', '.inc'];
|
|
20
|
+
const MAX_LINHAS_NO_AVISO = 10;
|
|
21
|
+
|
|
22
|
+
/** @param {Buffer} bytes */
|
|
23
|
+
function temBom(bytes) {
|
|
24
|
+
return bytes.length >= 3 && bytes[0] === 0xef && bytes[1] === 0xbb && bytes[2] === 0xbf;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
/** @param {Buffer} bytes */
|
|
28
|
+
function utf8Valido(bytes) {
|
|
29
|
+
try {
|
|
30
|
+
new TextDecoder('utf-8', { fatal: true }).decode(bytes);
|
|
31
|
+
return true;
|
|
32
|
+
} catch {
|
|
33
|
+
return false;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* @param {Buffer} bytes
|
|
39
|
+
* @returns {Encoding}
|
|
40
|
+
*/
|
|
41
|
+
export function detectarEncoding(bytes) {
|
|
42
|
+
if (bytes.subarray(0, 3).equals(Buffer.from([0xff, 0x0a, 0x00])) || bytes.subarray(0, 4).toString('latin1') === 'TPF0') {
|
|
43
|
+
return 'dfm-binario';
|
|
44
|
+
}
|
|
45
|
+
if (temBom(bytes)) return 'utf8-bom';
|
|
46
|
+
return utf8Valido(bytes) ? 'utf8-sem-bom' : 'cp1252';
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/** @param {string} texto */
|
|
50
|
+
function contarEol(texto) {
|
|
51
|
+
const crlf = texto.match(/\r\n/g)?.length ?? 0;
|
|
52
|
+
const lf = (texto.match(/\n/g)?.length ?? 0) - crlf;
|
|
53
|
+
return { crlf, lf };
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* @param {Buffer} bytes
|
|
58
|
+
* @returns {Eol}
|
|
59
|
+
*/
|
|
60
|
+
export function detectarEol(bytes) {
|
|
61
|
+
const { crlf, lf } = contarEol(bytes.toString('latin1'));
|
|
62
|
+
if (crlf && lf) return 'misto';
|
|
63
|
+
if (crlf) return 'crlf';
|
|
64
|
+
return lf ? 'lf' : 'nenhum';
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/** @param {Buffer} bytes */
|
|
68
|
+
export function decodificar(bytes) {
|
|
69
|
+
const corpo = temBom(bytes) ? bytes.subarray(3) : bytes;
|
|
70
|
+
return utf8Valido(corpo) ? corpo.toString('utf8') : new TextDecoder('windows-1252').decode(corpo);
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
const SEGUNDO_BYTE_UTF8 = new TextDecoder('windows-1252').decode(Uint8Array.from({ length: 0x40 }, (_, i) => 0x80 + i));
|
|
74
|
+
const DUPLA_CODIFICACAO = new RegExp(`[ÃÂ][${SEGUNDO_BYTE_UTF8.replace(/[\\\]^-]/g, '\\$&')}]|â€`);
|
|
75
|
+
|
|
76
|
+
/** @param {string} caminho */
|
|
77
|
+
function extensao(caminho) {
|
|
78
|
+
const ponto = caminho.lastIndexOf('.');
|
|
79
|
+
return ponto < 0 ? '' : caminho.slice(ponto).toLowerCase();
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/**
|
|
83
|
+
* Problemas do arquivo com a linha (1 em diante) e o texto dela, que identifica o problema na comparação com o HEAD.
|
|
84
|
+
* @param {string} caminho
|
|
85
|
+
* @param {Buffer} bytes
|
|
86
|
+
* @returns {Problema[]}
|
|
87
|
+
*/
|
|
88
|
+
export function checarArquivo(caminho, bytes) {
|
|
89
|
+
const encoding = detectarEncoding(bytes);
|
|
90
|
+
if (encoding === 'dfm-binario') return [];
|
|
91
|
+
/** @type {Problema[]} */
|
|
92
|
+
const problemas = [];
|
|
93
|
+
if (encoding !== 'utf8-bom' && EXTENSOES_CONVERTER.includes(extensao(caminho))) {
|
|
94
|
+
problemas.push({ linha: 1, mensagem: `BOM ausente (${encoding})`, texto: '' });
|
|
95
|
+
}
|
|
96
|
+
const texto = decodificar(bytes);
|
|
97
|
+
const linhas = texto.split('\n');
|
|
98
|
+
const eol = detectarEol(bytes);
|
|
99
|
+
const { crlf, lf } = contarEol(texto);
|
|
100
|
+
const eolMaioria = lf > crlf ? 'lf' : 'crlf';
|
|
101
|
+
linhas.forEach((linha, i) => {
|
|
102
|
+
const numero = i + 1;
|
|
103
|
+
const conteudo = linha.replace(/\r$/, '');
|
|
104
|
+
if (linha.includes('�')) problemas.push({ linha: numero, mensagem: 'caractere U+FFFD', texto: conteudo });
|
|
105
|
+
const dupla = linha.match(DUPLA_CODIFICACAO);
|
|
106
|
+
if (dupla) problemas.push({ linha: numero, mensagem: `dupla codificação ('${dupla[0]}')`, texto: conteudo });
|
|
107
|
+
if (eol === 'misto' && i < linhas.length - 1 && (linha.endsWith('\r') ? 'crlf' : 'lf') !== eolMaioria) {
|
|
108
|
+
const mensagem = `EOL misto (${eolMaioria === 'crlf' ? 'LF' : 'CRLF'} num arquivo ${eolMaioria.toUpperCase()})`;
|
|
109
|
+
problemas.push({ linha: numero, mensagem, texto: conteudo });
|
|
110
|
+
}
|
|
111
|
+
});
|
|
112
|
+
return problemas;
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
/** @param {string} glob */
|
|
116
|
+
function globParaRegex(glob) {
|
|
117
|
+
let fonte = '';
|
|
118
|
+
for (let i = 0; i < glob.length; i++) {
|
|
119
|
+
if (glob.startsWith('**/', i)) {
|
|
120
|
+
fonte += '(?:.*/)?';
|
|
121
|
+
i += 2;
|
|
122
|
+
} else if (glob.startsWith('**', i)) {
|
|
123
|
+
fonte += '.*';
|
|
124
|
+
i += 1;
|
|
125
|
+
} else if (glob[i] === '*') fonte += '[^/]*';
|
|
126
|
+
else fonte += (glob[i] ?? '').replace(/[.+?^${}()|[\]\\]/g, '\\$&');
|
|
127
|
+
}
|
|
128
|
+
return new RegExp(`^${fonte}$`, 'i');
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
/**
|
|
132
|
+
* @param {string} caminho
|
|
133
|
+
* @param {string[]} padroes
|
|
134
|
+
*/
|
|
135
|
+
export function casaGlob(caminho, padroes) {
|
|
136
|
+
const normalizado = caminho.replace(/\\/g, '/').replace(/^\.\//, '');
|
|
137
|
+
return padroes.some((padrao) => globParaRegex(padrao.replace(/\\/g, '/')).test(normalizado));
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
/**
|
|
141
|
+
* Config ausente, ilegível ou com valor inválido cai nos padrões, campo a campo.
|
|
142
|
+
* @param {string} raiz
|
|
143
|
+
* @returns {{ modo: Modo, ignorar: string[] }}
|
|
144
|
+
*/
|
|
145
|
+
function lerConfig(raiz) {
|
|
146
|
+
/** @type {any} */
|
|
147
|
+
let config = {};
|
|
148
|
+
try {
|
|
149
|
+
const arquivo = join(raiz, '.ai-harness', 'config.json');
|
|
150
|
+
if (existsSync(arquivo)) config = JSON.parse(readFileSync(arquivo, 'utf8')) ?? {};
|
|
151
|
+
} catch {
|
|
152
|
+
config = {};
|
|
153
|
+
}
|
|
154
|
+
const modo = config?.hooks?.[NOME];
|
|
155
|
+
const ignorar = config?.delphi?.ignorar;
|
|
156
|
+
return {
|
|
157
|
+
modo: MODOS.includes(modo) ? modo : MODO_PADRAO,
|
|
158
|
+
ignorar: Array.isArray(ignorar) && ignorar.every((glob) => typeof glob === 'string') ? ignorar : IGNORAR_PADRAO,
|
|
159
|
+
};
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
/**
|
|
163
|
+
* Bytes do arquivo no HEAD, ou null quando não há repositório ou versão. `HEAD:./nome` resolve contra o cwd, o que
|
|
164
|
+
* funciona mesmo com o projeto numa subpasta do repositório.
|
|
165
|
+
* @param {string} arquivo
|
|
166
|
+
* @returns {Buffer | null}
|
|
167
|
+
*/
|
|
168
|
+
function versaoNoHead(arquivo) {
|
|
169
|
+
const r = spawnSync('git', ['show', `HEAD:./${basename(arquivo)}`], { cwd: dirname(arquivo), maxBuffer: 256 * 1024 * 1024 });
|
|
170
|
+
return r.status === 0 && Buffer.isBuffer(r.stdout) ? r.stdout : null;
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
/** @param {string} caminho */
|
|
174
|
+
const comandoConverter = (caminho) =>
|
|
175
|
+
`npx @fontdata/ai-harness delphi encoding converter ${/\s/.test(caminho) ? `"${caminho}"` : caminho}`;
|
|
176
|
+
|
|
177
|
+
/**
|
|
178
|
+
* @param {Problema[]} problemas
|
|
179
|
+
* @param {string} rel
|
|
180
|
+
*/
|
|
181
|
+
function listar(problemas, rel) {
|
|
182
|
+
const linhas = problemas.slice(0, MAX_LINHAS_NO_AVISO).map((p) => `- ${rel}, linha ${p.linha}: ${p.mensagem}`);
|
|
183
|
+
if (problemas.length > MAX_LINHAS_NO_AVISO) linhas.push(`- e mais ${problemas.length - MAX_LINHAS_NO_AVISO}`);
|
|
184
|
+
return linhas.join('\n');
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
/**
|
|
188
|
+
* @param {string} rel
|
|
189
|
+
* @param {Buffer} bytes
|
|
190
|
+
* @returns {{ bloqueia: boolean, mensagem: string } | null}
|
|
191
|
+
*/
|
|
192
|
+
function antesDeEditar(rel, bytes) {
|
|
193
|
+
if (!EXTENSOES_CONVERTER.includes(extensao(rel))) return null;
|
|
194
|
+
const encoding = detectarEncoding(bytes);
|
|
195
|
+
if (encoding === 'cp1252') {
|
|
196
|
+
return {
|
|
197
|
+
bloqueia: true,
|
|
198
|
+
mensagem:
|
|
199
|
+
`${rel} não está em UTF-8 (parece CP1252/ANSI); editar assim corrompe os acentos. ` +
|
|
200
|
+
`Converta para UTF-8 com BOM antes de editar: ${comandoConverter(rel)}`,
|
|
201
|
+
};
|
|
202
|
+
}
|
|
203
|
+
if (encoding === 'utf8-sem-bom') {
|
|
204
|
+
return {
|
|
205
|
+
bloqueia: false,
|
|
206
|
+
mensagem: `${rel} está em UTF-8 sem BOM; o Delphi pode lê-lo como ANSI. Para acrescentar o BOM: ${comandoConverter(rel)}`,
|
|
207
|
+
};
|
|
208
|
+
}
|
|
209
|
+
return null;
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
/** @param {Eol} eol */
|
|
213
|
+
const nomeEol = (eol) => (eol === 'nenhum' ? 'sem quebra de linha' : eol.toUpperCase());
|
|
214
|
+
|
|
215
|
+
/**
|
|
216
|
+
* Problemas que o HEAD não tinha; sem HEAD, todos contam como novos.
|
|
217
|
+
* @param {string} rel
|
|
218
|
+
* @param {Buffer} bytes
|
|
219
|
+
* @param {Buffer | null} head
|
|
220
|
+
* @returns {string | null}
|
|
221
|
+
*/
|
|
222
|
+
function depoisDeGravar(rel, bytes, head) {
|
|
223
|
+
const ext = extensao(rel);
|
|
224
|
+
const ehDfm = ext === '.dfm';
|
|
225
|
+
if (!ehDfm && !EXTENSOES_CONVERTER.includes(ext)) return null;
|
|
226
|
+
if (detectarEncoding(bytes) === 'dfm-binario') return null;
|
|
227
|
+
const anterior = head && detectarEncoding(head) !== 'dfm-binario' ? head : null;
|
|
228
|
+
|
|
229
|
+
const atuais = checarArquivo(rel, bytes);
|
|
230
|
+
const antigos = anterior ? checarArquivo(rel, anterior) : [];
|
|
231
|
+
const chave = (/** @type {Problema} */ p) => `${p.mensagem.replace(/ \(.*$/, '')}\0${p.texto}`;
|
|
232
|
+
const jaExistiam = new Set(antigos.map(chave));
|
|
233
|
+
const eolMistoAntes = anterior !== null && detectarEol(anterior) === 'misto';
|
|
234
|
+
|
|
235
|
+
const novos = atuais.filter((p) => {
|
|
236
|
+
if (p.mensagem.startsWith('BOM ausente')) return !ehDfm && (anterior === null || temBom(anterior));
|
|
237
|
+
if (p.mensagem.startsWith('EOL misto')) return !ehDfm && !eolMistoAntes;
|
|
238
|
+
if (ehDfm && !p.mensagem.startsWith('caractere U+FFFD')) return false;
|
|
239
|
+
return !jaExistiam.has(chave(p));
|
|
240
|
+
});
|
|
241
|
+
|
|
242
|
+
const partes = [];
|
|
243
|
+
if (novos.length) partes.push(`Regressão de encoding em ${rel}:\n${listar(novos, rel)}`);
|
|
244
|
+
if (ehDfm && anterior) {
|
|
245
|
+
const antes = detectarEol(anterior);
|
|
246
|
+
const depois = detectarEol(bytes);
|
|
247
|
+
if (antes !== depois) {
|
|
248
|
+
partes.push(`${rel}: o EOL mudou de ${nomeEol(antes)} para ${nomeEol(depois)}; o .dfm deve manter o EOL do HEAD.`);
|
|
249
|
+
}
|
|
250
|
+
}
|
|
251
|
+
return partes.length ? partes.join('\n') : null;
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
/**
|
|
255
|
+
* @param {string} evento
|
|
256
|
+
* @param {string} mensagem
|
|
257
|
+
*/
|
|
258
|
+
function avisar(evento, mensagem) {
|
|
259
|
+
process.stdout.write(JSON.stringify({ hookSpecificOutput: { hookEventName: evento, additionalContext: `[ai-harness · ${NOME}] ${mensagem}` } }));
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
async function lerStdin() {
|
|
263
|
+
let dados = '';
|
|
264
|
+
for await (const pedaco of process.stdin) dados += pedaco;
|
|
265
|
+
return dados;
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
async function main() {
|
|
269
|
+
/** @type {any} */
|
|
270
|
+
let evento;
|
|
271
|
+
try {
|
|
272
|
+
evento = JSON.parse(await lerStdin());
|
|
273
|
+
} catch {
|
|
274
|
+
return;
|
|
275
|
+
}
|
|
276
|
+
const caminho = evento?.tool_input?.file_path;
|
|
277
|
+
if (typeof caminho !== 'string' || !caminho) return;
|
|
278
|
+
const nomeEvento = String(evento.hook_event_name ?? '');
|
|
279
|
+
const ferramenta = String(evento.tool_name ?? '');
|
|
280
|
+
const pre = nomeEvento === 'PreToolUse' && ['Edit', 'MultiEdit'].includes(ferramenta);
|
|
281
|
+
const pos = nomeEvento === 'PostToolUse' && ['Write', 'Edit', 'MultiEdit'].includes(ferramenta);
|
|
282
|
+
if (!pre && !pos) return;
|
|
283
|
+
|
|
284
|
+
const raiz = process.env.CLAUDE_PROJECT_DIR || (typeof evento.cwd === 'string' && evento.cwd) || process.cwd();
|
|
285
|
+
const { modo, ignorar } = lerConfig(raiz);
|
|
286
|
+
if (modo === 'desligado') return;
|
|
287
|
+
|
|
288
|
+
const arquivo = isAbsolute(caminho) ? caminho : resolve(raiz, caminho);
|
|
289
|
+
const rel = relative(raiz, arquivo).replace(/\\/g, '/');
|
|
290
|
+
if (casaGlob(rel, ignorar)) return;
|
|
291
|
+
|
|
292
|
+
/** @type {Buffer} */
|
|
293
|
+
let bytes;
|
|
294
|
+
try {
|
|
295
|
+
bytes = readFileSync(arquivo);
|
|
296
|
+
} catch {
|
|
297
|
+
return;
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
if (pre) {
|
|
301
|
+
const resultado = antesDeEditar(rel, bytes);
|
|
302
|
+
if (!resultado) return;
|
|
303
|
+
if (resultado.bloqueia && modo === 'bloqueio') {
|
|
304
|
+
process.stderr.write(`[ai-harness · ${NOME}] ${resultado.mensagem}\n`);
|
|
305
|
+
process.exitCode = 2;
|
|
306
|
+
return;
|
|
307
|
+
}
|
|
308
|
+
avisar(nomeEvento, resultado.mensagem);
|
|
309
|
+
return;
|
|
310
|
+
}
|
|
311
|
+
|
|
312
|
+
const mensagem = depoisDeGravar(rel, bytes, versaoNoHead(arquivo));
|
|
313
|
+
if (mensagem) avisar(nomeEvento, mensagem);
|
|
314
|
+
}
|
|
315
|
+
|
|
316
|
+
const entrypoint = process.argv[1] ? realpathSync(process.argv[1]) : '';
|
|
317
|
+
if (entrypoint === realpathSync(fileURLToPath(import.meta.url))) await main();
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.pas"
|
|
4
|
+
- "**/*.dpr"
|
|
5
|
+
- "**/*.dpk"
|
|
6
|
+
- "**/*.inc"
|
|
7
|
+
- "**/*.dfm"
|
|
8
|
+
- "**/*.dproj"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Build e verificação em projeto Delphi
|
|
12
|
+
|
|
13
|
+
## Quem compila é o usuário
|
|
14
|
+
|
|
15
|
+
A compilação é manual: no macOS, pela IDE do Delphi dentro da VM do Parallels; no Windows, pela IDE direto. O
|
|
16
|
+
agente **não compila**: não procura o compilador (`dcc32`, `dcc64`, `msbuild`, `rsvars.bat`), não monta linha de
|
|
17
|
+
comando de build e não tenta rodar a IDE.
|
|
18
|
+
|
|
19
|
+
Por quê: o compilador não está no ambiente do agente (no macOS ele só existe na VM), e uma tentativa de achar ou
|
|
20
|
+
chamar o build gasta tempo e induz a afirmar que algo compilou quando não compilou.
|
|
21
|
+
|
|
22
|
+
## Unit nova entra no `uses` do `.dpr`
|
|
23
|
+
|
|
24
|
+
Toda unit criada pelo agente entra no `uses` do `.dpr` do projeto, com o caminho relativo e, se for form, o nome
|
|
25
|
+
do form no comentário que a IDE usa:
|
|
26
|
+
|
|
27
|
+
```pascal
|
|
28
|
+
uses
|
|
29
|
+
Vcl.Forms,
|
|
30
|
+
uPrincipal in 'uPrincipal.pas' {FrmPrincipal},
|
|
31
|
+
uRelatorioVendas in 'Relatorios\uRelatorioVendas.pas' {FrmRelatorioVendas};
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Por quê: a IDE acha a unit pelo search path no build incremental, mas o build "limpo" (o do deploy, ou um
|
|
35
|
+
*Build* depois de apagar os `.dcu`) só compila o que o `.dpr` lista. Unit fora do `uses` passa na máquina do dev e
|
|
36
|
+
quebra no build limpo. O `.dproj` também lista a unit (`<DCCReference>`); se a unit não aparecer no Project
|
|
37
|
+
Manager, avise o usuário para adicioná-la pela IDE, que atualiza os dois arquivos.
|
|
38
|
+
|
|
39
|
+
## Entrega sem compilação diz "não compilado"
|
|
40
|
+
|
|
41
|
+
Como o agente não compila, toda entrega que mexe em fonte Delphi termina dizendo **"não compilado"** e lista:
|
|
42
|
+
|
|
43
|
+
- as units e forms alterados ou criados;
|
|
44
|
+
- o projeto (`.dpr`/`.dproj`) que o usuário deve compilar;
|
|
45
|
+
- o que testar na aplicação depois de compilar (tela, rotina, caso de borda).
|
|
46
|
+
|
|
47
|
+
Errado: "a alteração está pronta e funcionando". Certo: "não compilado; compile `Vendas.dproj` e teste o
|
|
48
|
+
fechamento de pedido com desconto zerado".
|
|
49
|
+
|
|
50
|
+
## `DelphiBuildRelease` não é ferramenta do agente
|
|
51
|
+
|
|
52
|
+
O `DelphiBuildRelease` só roda no pipeline de deploy. O agente não o chama, não
|
|
53
|
+
o usa para "validar" a alteração e não pede ao usuário que dispare o deploy para testar o build.
|
|
54
|
+
|
|
55
|
+
## Suíte própria do projeto prevalece
|
|
56
|
+
|
|
57
|
+
Se o projeto declara uma suíte de testes automatizados em `.claude/rules/harness-projeto.md` (seção "Suíte de
|
|
58
|
+
testes"), ela prevalece sobre esta rule: o agente roda a suíte do projeto como ela está descrita lá, inclusive
|
|
59
|
+
quando ela compila. Sem suíte declarada, vale o "não compilado" acima.
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.pas"
|
|
4
|
+
- "**/*.dfm"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.inc"
|
|
7
|
+
- "**/*.sql"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Regra (camada de dados/fiscal): CNPJ alfanumérico, nunca extrair só os números
|
|
11
|
+
|
|
12
|
+
Aplica-se a todo código que manipula CNPJ ou CPF/CNPJ para **gravar** no banco, **comparar** ("o CNPJ
|
|
13
|
+
mudou?"), **decidir** o ramo de validação (CNPJ x CPF) ou **transmitir** em documento fiscal.
|
|
14
|
+
|
|
15
|
+
## O CNPJ passou a ser alfanumérico, e "extrair números" o destrói
|
|
16
|
+
|
|
17
|
+
O CNPJ admite letras nas 12 primeiras posições (ex.: `12.ABC.345/01DE-35`); só os 2 dígitos
|
|
18
|
+
verificadores continuam numéricos. Uma função que mantém **só dígitos** (`ExtrairNumeros`, um helper
|
|
19
|
+
`ExtractNumbers` de edit, `OnlyNumbers` e parecidas), aplicada a um CNPJ alfanumérico, **descarta as
|
|
20
|
+
letras em silêncio**: nada estoura na compilação, o campo aceita a digitação, a validação passa e o valor
|
|
21
|
+
chega mutilado ao banco.
|
|
22
|
+
|
|
23
|
+
## Padrão obrigatório
|
|
24
|
+
|
|
25
|
+
Use uma função que remova só a pontuação da máscara (`.`, `/`, `-`, espaço) e preserve letras e dígitos.
|
|
26
|
+
Procure primeiro a que o projeto ou suas bibliotecas já têm (ver
|
|
27
|
+
`linguagem/reaproveitar-funcao-existente-antes-de-criar.md`) antes de escrever uma.
|
|
28
|
+
|
|
29
|
+
```pascal
|
|
30
|
+
// ERRADO: perde as letras do CNPJ alfanumérico
|
|
31
|
+
ParamByName('cnpj').AsString := ExtrairNumeros(EditCnpj.Text);
|
|
32
|
+
|
|
33
|
+
// CERTO
|
|
34
|
+
ParamByName('cnpj').AsString := ExtrairLetrasENumeros(EditCnpj.Text);
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Extrair só números **continua correto** para CPF, CEP, telefone, CFOP, agência e outros valores de fato
|
|
38
|
+
numéricos. O critério não é "é documento", é **"este valor pode conter letra?"**.
|
|
39
|
+
|
|
40
|
+
## Três armadilhas irmãs: corrija as três juntas
|
|
41
|
+
|
|
42
|
+
1. **Gravação** (`ParamByName`/`FieldByName`): o caso óbvio.
|
|
43
|
+
2. **Comparação de "mudou?"**: as duas pontas têm de usar a **mesma** extração. Se a carga do valor
|
|
44
|
+
original usa uma função e a comparação usa outra, uma troca só de letras passa despercebida e a trava
|
|
45
|
+
que dependia dela não dispara.
|
|
46
|
+
3. **Decisão CNPJ x CPF por tamanho**: nunca conte **dígitos** para escolher o ramo.
|
|
47
|
+
|
|
48
|
+
```pascal
|
|
49
|
+
// ERRADO: CNPJ alfanumérico tem menos de 14 dígitos, cai no ramo CPF e acusa "CPF inválido"
|
|
50
|
+
if ExtrairNumeros(MskDocumento.Text).Length >= 14 then
|
|
51
|
+
|
|
52
|
+
// CERTO: conta caracteres alfanuméricos
|
|
53
|
+
if ExtrairLetrasENumeros(MskDocumento.Text).Length >= 14 then
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
## Validação e gravação são irmãs: nunca corrija só uma
|
|
57
|
+
|
|
58
|
+
A correção pela metade é o caminho mais comum para este defeito: a **validação** da tela é ajustada para
|
|
59
|
+
aceitar letras, e o **ponto de gravação** da mesma tela continua extraindo só números. Resultado: valida
|
|
60
|
+
com letras e grava sem letras.
|
|
61
|
+
|
|
62
|
+
Ao ajustar a validação de um campo fiscal, ajuste na mesma passagem o ponto de gravação correspondente, e
|
|
63
|
+
vice-versa. Antes de fechar, faça `grep` pelas funções de extração de números na unit inteira e
|
|
64
|
+
classifique **cada** ocorrência: valor numérico (mantém) ou alfanumérico (troca). Inclua na busca as
|
|
65
|
+
rotinas que montam documentos fiscais e arquivos para o fisco, que também transmitem o CNPJ.
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.pas"
|
|
4
|
+
- "**/*.dfm"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.inc"
|
|
7
|
+
- "**/*.sql"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Regra (camada de dados): data/hora em SQL se compõe por aritmética de tipos
|
|
11
|
+
|
|
12
|
+
Nunca por round-trip textual (`to_char` + `CAST`). Aplica-se a todo SQL, montado em código ou gravado no
|
|
13
|
+
`SQL.Strings` de um `.dfm`, que **reconstrói** um `date`/`time`/`timestamp` a partir de texto. O caso
|
|
14
|
+
típico é juntar data e hora guardadas em duas colunas numa única coluna "Data/Hora" de relatório.
|
|
15
|
+
Complementa `datestyle-sessao-firedac-postgres.md`.
|
|
16
|
+
|
|
17
|
+
## `CAST(to_char(...) || ... AS timestamp)` fica à mercê do `DateStyle`
|
|
18
|
+
|
|
19
|
+
Formatar uma data para texto e reconverter o texto para data descarta a tipagem e entrega a interpretação
|
|
20
|
+
ao `DateStyle` da sessão. `'DD/MM/YYYY'` só volta a ser aquela data se a sessão estiver em `DMY`:
|
|
21
|
+
|
|
22
|
+
```sql
|
|
23
|
+
-- ERRADO: depende do DateStyle; em sessão MDY, dia 19 vira mês 19
|
|
24
|
+
CAST(to_char(pedidos.data_emissao, 'DD/MM/YYYY') || ' ' ||
|
|
25
|
+
to_char(pedidos.hora_emissao, 'HH24:MI:SS') AS timestamp without time zone)
|
|
26
|
+
|
|
27
|
+
-- CERTO: aritmética de tipos, date + time = timestamp, sem texto no meio
|
|
28
|
+
pedidos.data_emissao::date + pedidos.hora_emissao::time
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
As duas expressões produzem `timestamp without time zone`, então alias, tipo do `TField` e layout do
|
|
32
|
+
relatório não mudam. A troca é segura em relatório já em produção.
|
|
33
|
+
|
|
34
|
+
Vale para todas as formas: `to_date(to_char(...))`, `CAST(<texto> AS date)`, `<coluna>::text::date`.
|
|
35
|
+
Formatar para **exibir** (`to_char` que termina em texto) continua correto. O defeito é formatar e
|
|
36
|
+
**voltar** a um tipo temporal.
|
|
37
|
+
|
|
38
|
+
## Defeito assimétrico: não estoura, mente
|
|
39
|
+
|
|
40
|
+
Com dia **≤ 12**, a string é ambígua mas válida: `05/08/2026` é lido como 8 de maio, o relatório imprime
|
|
41
|
+
normalmente e a data sai trocada. Só a partir do dia **13** o `CAST` estoura:
|
|
42
|
+
|
|
43
|
+
```
|
|
44
|
+
ERRO: valor do campo date/time está fora do intervalo: "19/08/2026 15:11:05".
|
|
45
|
+
Talvez você necessite de uma definição diferente para "datestyle"
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
> Ao investigar `date/time field value out of range` / `date/time está fora do intervalo`, a **primeira**
|
|
49
|
+
> busca é por `to_char` seguido de `CAST` na query que falhou, antes de suspeitar do dado, da coluna ou do
|
|
50
|
+
> `postgresql.conf`. A mensagem sugere reconfigurar o `datestyle`: é o mecanismo, não a causa.
|
|
51
|
+
|
|
52
|
+
Não presuma que os dias ≤ 12 estavam certos: se o defeito viveu numa sessão MDY, eles saíam com dia e mês
|
|
53
|
+
invertidos, em silêncio. Ao corrigir, teste os dois lados do limiar: dia > 12 (o que estourava) **e**
|
|
54
|
+
dia ≤ 12 (o que "funcionava").
|
|
55
|
+
|
|
56
|
+
## Fixar o `DateStyle` da sessão não dispensa esta regra
|
|
57
|
+
|
|
58
|
+
Fixar `SET SESSION DateStyle TO 'ISO, DMY'` no `AfterConnect` (ver `datestyle-sessao-firedac-postgres.md`)
|
|
59
|
+
é salvaguarda de ambiente, não licença para escrever SQL que dependa dela. Basta um executável antigo em
|
|
60
|
+
campo, uma conexão que não passou pelo handler ou uma ferramenta externa rodando a mesma query para o
|
|
61
|
+
valor voltar a depender de configuração. SQL que não precisa do `DateStyle` não quebra em nenhum desses
|
|
62
|
+
casos.
|
|
63
|
+
|
|
64
|
+
## Antes de fechar
|
|
65
|
+
|
|
66
|
+
- `grep -n "to_char" <Unit>.dfm <Unit>.pas`: nenhuma ocorrência pode terminar em
|
|
67
|
+
`CAST(... AS date|time|timestamp)` nem alimentar `to_date`/`to_timestamp`.
|
|
68
|
+
- Corrija as queries gêmeas juntas. Relatório com par runtime + design-time copia o mesmo SELECT;
|
|
69
|
+
corrigir só uma deixa a outra quebrada.
|
|
70
|
+
- Valide executando, com a sessão no pior cenário:
|
|
71
|
+
|
|
72
|
+
```sql
|
|
73
|
+
SET SESSION DateStyle TO 'ISO, MDY';
|
|
74
|
+
SELECT <a nova expressão>, pg_typeof(<a nova expressão>);
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
Confira o valor e o `pg_typeof`: o tipo tem de ser idêntico ao da expressão anterior, senão o `TField`
|
|
78
|
+
do dataset e o layout mudam junto.
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.pas"
|
|
4
|
+
- "**/*.dfm"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.inc"
|
|
7
|
+
- "**/*.sql"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Regra (camada de dados): garantir `DateStyle 'ISO, DMY'` na sessão FireDAC/PostgreSQL
|
|
11
|
+
|
|
12
|
+
Aplica-se à conexão principal PostgreSQL do projeto e a qualquer literal de data montado em SQL.
|
|
13
|
+
Complementa `firedac.md` e `data-hora-sql-nunca-round-trip-textual.md`.
|
|
14
|
+
|
|
15
|
+
## A sessão FireDAC não herda o `DateStyle` do servidor: force-o no `AfterConnect`
|
|
16
|
+
|
|
17
|
+
Mesmo com `datestyle = 'ISO, DMY'` no `postgresql.conf` (e `SHOW datestyle` confirmando no servidor), a
|
|
18
|
+
sessão aberta pelo driver PostgreSQL do FireDAC pode assumir **MDY**. Nesse caso, todo literal de data em
|
|
19
|
+
`dd/mm/yyyy` no SQL (ex.: `CAST(COALESCE(precos.data_validade, '31/12/2050') AS date)`) é rejeitado:
|
|
20
|
+
|
|
21
|
+
```
|
|
22
|
+
ERROR: date/time field value out of range: "31/12/2050". Perhaps you need a different "DateStyle" setting.
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
porque `31` é lido como **mês**. Ajustar só o `postgresql.conf` não resolve: a sessão do cliente
|
|
26
|
+
sobrescreve o padrão do servidor. Overrides por banco (`pg_database.datconfig`) ou por role
|
|
27
|
+
(`pg_roles.rolconfig`) também não são o remédio, porque a sessão FireDAC ainda pode divergir.
|
|
28
|
+
|
|
29
|
+
### Padrão obrigatório
|
|
30
|
+
|
|
31
|
+
O `AfterConnect` da conexão principal fixa o `DateStyle` da sessão logo no início, antes de qualquer
|
|
32
|
+
outra query:
|
|
33
|
+
|
|
34
|
+
```pascal
|
|
35
|
+
procedure TDmConexao.FDConnectionAfterConnect(Sender: TObject);
|
|
36
|
+
begin
|
|
37
|
+
FDConnection.ExecSQL('SET SESSION DateStyle TO ''ISO, DMY''');
|
|
38
|
+
// ... demais inicializações da sessão ...
|
|
39
|
+
end;
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
- **`ISO, DMY` é o par certo:** a **saída** fica em ISO (`2050-12-31`, lida sem ambiguidade pelo FireDAC)
|
|
43
|
+
e a **entrada** em DMY (aceita `dd/mm/yyyy` do locale brasileiro).
|
|
44
|
+
- **Idempotente e barato:** roda a cada conexão física (login, conexões auxiliares, reconexão automática
|
|
45
|
+
por `OnRecover`/`faRetry`). Rodar mais de uma vez não tem efeito colateral.
|
|
46
|
+
- Deixa o sistema imune ao `datestyle` padrão de qualquer servidor de cliente.
|
|
47
|
+
- Use `ExecSQL` direto na conexão, não uma `TFDQuery` avulsa.
|
|
48
|
+
|
|
49
|
+
## Prefira parâmetro ou ISO a literal de data localizado
|
|
50
|
+
|
|
51
|
+
Em SQL **novo**, monte data com `:Param` (o FireDAC envia o valor tipado, sem depender de `DateStyle`) ou
|
|
52
|
+
com literal ISO `yyyy-mm-dd` (sem ambiguidade em qualquer `DateStyle`). **Nunca** concatene `dd/mm/yyyy`
|
|
53
|
+
contando com o `DateStyle` do servidor. A fixação da sessão tolera o literal localizado que já existe; não
|
|
54
|
+
é motivo para escrever mais.
|
|
55
|
+
|
|
56
|
+
## Antes de fechar
|
|
57
|
+
|
|
58
|
+
- Confirme que a fixação está no `AfterConnect`, que dispara em toda sessão física nova.
|
|
59
|
+
- O erro só aparece em runtime, ao conectar num servidor cuja sessão não esteja em DMY; nunca na
|
|
60
|
+
compilação. Teste reconectando e reproduzindo um fluxo que monte literal `dd/mm/yyyy`.
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
---
|
|
2
|
+
descricao: "Script que cria tabela também cria a trigger de auditoria/log que o banco já usa nas outras tabelas"
|
|
3
|
+
paths:
|
|
4
|
+
- "**/*.sql"
|
|
5
|
+
- "**/*.pas"
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Regra (camada de dados): toda tabela nova ganha a trigger de log que o banco já usa
|
|
9
|
+
|
|
10
|
+
Aplica-se a todo script SQL (e a todo DDL montado em `.pas`) que cria tabela com `CREATE TABLE`, quando o banco do
|
|
11
|
+
projeto registra alterações por trigger de auditoria/log nas tabelas existentes.
|
|
12
|
+
|
|
13
|
+
## Descubra o padrão antes de escrever
|
|
14
|
+
|
|
15
|
+
Não invente nome nem função de trigger. Consulte o banco (ou um dump do esquema) e repita o que as outras tabelas
|
|
16
|
+
já têm:
|
|
17
|
+
|
|
18
|
+
```sql
|
|
19
|
+
-- nome de trigger mais comum e a função que ele chama (PostgreSQL)
|
|
20
|
+
SELECT trigger_name, action_statement, count(DISTINCT event_object_table) AS tabelas
|
|
21
|
+
FROM information_schema.triggers
|
|
22
|
+
GROUP BY trigger_name, action_statement
|
|
23
|
+
ORDER BY tabelas DESC;
|
|
24
|
+
|
|
25
|
+
-- alternativa pelo catálogo
|
|
26
|
+
SELECT t.tgname, p.proname, count(*) AS tabelas
|
|
27
|
+
FROM pg_trigger t
|
|
28
|
+
JOIN pg_proc p ON p.oid = t.tgfoid
|
|
29
|
+
WHERE NOT t.tgisinternal
|
|
30
|
+
GROUP BY t.tgname, p.proname
|
|
31
|
+
ORDER BY tabelas DESC;
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Se nenhuma trigger aparece em várias tabelas, o projeto não tem esse padrão e esta regra não se aplica. Se aparecem
|
|
35
|
+
padrões concorrentes, pergunte ao usuário qual vale para tabela nova.
|
|
36
|
+
|
|
37
|
+
## Padrão obrigatório
|
|
38
|
+
|
|
39
|
+
Logo depois das tabelas do script, uma trigger por tabela criada, com o mesmo nome, o mesmo evento (`AFTER UPDATE`,
|
|
40
|
+
`AFTER INSERT OR UPDATE OR DELETE`, o que o banco já usa) e a mesma função. Num banco que usa a trigger `eventos_log`
|
|
41
|
+
com a função `grava_log_tabelas()`, fica assim:
|
|
42
|
+
|
|
43
|
+
```sql
|
|
44
|
+
CREATE OR REPLACE TRIGGER eventos_log
|
|
45
|
+
AFTER UPDATE ON <tabela>
|
|
46
|
+
FOR EACH ROW EXECUTE FUNCTION grava_log_tabelas();
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
- `CREATE OR REPLACE TRIGGER` deixa o script reaplicável, como o `CREATE TABLE IF NOT EXISTS` das tabelas. Exige
|
|
50
|
+
PostgreSQL 14 ou mais novo; em versão anterior, use `DROP TRIGGER IF EXISTS` seguido de `CREATE TRIGGER`.
|
|
51
|
+
- Vale também para tabela filha (itens, pagamentos, eventos), não só para a principal.
|
|
52
|
+
|
|
53
|
+
## Por que escapa
|
|
54
|
+
|
|
55
|
+
O script cria a tabela, a tela grava e nada falha. A falta da trigger só aparece quando o suporte precisa saber quem
|
|
56
|
+
alterou um registro e o log daquela tabela está vazio.
|
|
57
|
+
|
|
58
|
+
## Antes de fechar
|
|
59
|
+
|
|
60
|
+
Conte as tabelas criadas e as triggers no script, com o nome da função descoberta:
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
grep -ci "CREATE TABLE" <script>.sql
|
|
64
|
+
grep -ci "EXECUTE FUNCTION <funcao_de_log>()" <script>.sql
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
As duas contagens são iguais. Se validar o script num banco de teste que não tem a função de log, crie antes uma
|
|
68
|
+
versão vazia dela só para o teste.
|