@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.
Files changed (257) hide show
  1. package/.claude-plugin/plugin.json +2 -2
  2. package/README.md +154 -3
  3. package/dist/cli.js +1 -0
  4. package/dist/config/config.js +45 -3
  5. package/dist/delphi/catalogo.js +299 -0
  6. package/dist/delphi/classificar.js +21 -0
  7. package/dist/delphi/command.js +144 -2
  8. package/dist/delphi/encoding.js +112 -0
  9. package/dist/doctor/checks.js +19 -1
  10. package/dist/init.js +16 -2
  11. package/dist/install/perfis.js +21 -0
  12. package/dist/install/plan.js +29 -2
  13. package/dist/install/settings.js +40 -3
  14. package/dist/mapa/extratores/pascal.js +1 -1
  15. package/dist/update/update.js +126 -7
  16. package/package.json +1 -1
  17. package/templates/CLAUDE.md +2 -1
  18. package/templates/catalog.json +11 -3
  19. package/templates/hooks/comentarios/check.mjs +62 -5
  20. package/templates/hooks/hooks.json +2 -1
  21. package/templates/hooks/lib/config.mjs +1 -0
  22. package/templates/hooks/padroes-proibidos.mjs +68 -0
  23. package/templates/perfis/delphi/hooks/encoding.mjs +317 -0
  24. package/templates/perfis/delphi/rules/build-e-verificacao.md +59 -0
  25. package/templates/perfis/delphi/rules/dados/cnpj-alfanumerico-nao-extrair-so-numeros.md +65 -0
  26. package/templates/perfis/delphi/rules/dados/data-hora-sql-nunca-round-trip-textual.md +78 -0
  27. package/templates/perfis/delphi/rules/dados/datestyle-sessao-firedac-postgres.md +60 -0
  28. package/templates/perfis/delphi/rules/dados/ddl-tabela-nova-exige-trigger-de-log.md +68 -0
  29. package/templates/perfis/delphi/rules/dados/divisao-e-conversao-numerica.md +53 -0
  30. package/templates/perfis/delphi/rules/dados/fieldbyname-value-variant-cru-em-aritmetica.md +73 -0
  31. package/templates/perfis/delphi/rules/dados/filtro-condicional-sql-par-add-parambyname.md +72 -0
  32. package/templates/perfis/delphi/rules/dados/firedac.md +51 -0
  33. package/templates/perfis/delphi/rules/dados/macro-firedac-exige-entrada-macrodata.md +96 -0
  34. package/templates/perfis/delphi/rules/dados/sql-qualificacao-colunas.md +36 -0
  35. package/templates/perfis/delphi/rules/dados/tmeminifile-getstrings-nao-limpa-destino.md +89 -0
  36. package/templates/perfis/delphi/rules/encoding-eol.md +130 -0
  37. package/templates/perfis/delphi/rules/linguagem/dataset-nao-se-le-depois-do-laco-eof.md +56 -0
  38. package/templates/perfis/delphi/rules/linguagem/existencia-nunca-se-testa-por-campo-formatado.md +60 -0
  39. package/templates/perfis/delphi/rules/linguagem/float-nunca-comparado-por-igualdade-com-literal.md +55 -0
  40. package/templates/perfis/delphi/rules/linguagem/literal-enum-de-dfm-exige-unit-no-uses.md +84 -0
  41. package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md +172 -0
  42. package/templates/perfis/delphi/rules/linguagem/sem-clipboard-debug.md +43 -0
  43. package/templates/perfis/delphi/rules/linguagem/validacao-em-onexit-nao-protege-a-gravacao.md +65 -0
  44. package/templates/perfis/delphi/rules/linguagem/variavel-inline-sai-de-escopo-ao-envolver-bloco.md +69 -0
  45. package/templates/perfis/delphi/rules/telas/foco-decisao-por-canfocus-nao-tabstop.md +40 -0
  46. package/templates/perfis/delphi/rules/telas/form-dinamico-liberar-em-toda-saida.md +80 -0
  47. package/templates/perfis/delphi/rules/telas/heranca-de-form-e-grade-de-selecao.md +58 -0
  48. package/templates/perfis/delphi/rules/threads-e-timers.md +131 -0
  49. package/templates/perfis/delphi/rules/try-finally-e-vazamento.md +109 -0
  50. package/templates/perfis/delphi/skills/conhecimento-delphi/SKILL.md +70 -0
  51. package/templates/perfis/delphi/skills/conhecimento-delphi/references/ATRIBUICAO.md +29 -0
  52. package/templates/perfis/delphi/skills/conhecimento-delphi/references/acbr-nfce-integracao.md +60 -0
  53. package/templates/perfis/delphi/skills/conhecimento-delphi/references/build-via-bat-com-log.md +86 -0
  54. package/templates/perfis/delphi/skills/conhecimento-delphi/references/class-var-vaza-para-campos-de-instancia.md +73 -0
  55. package/templates/perfis/delphi/skills/conhecimento-delphi/references/componentes-designer-vs-runtime.md +47 -0
  56. package/templates/perfis/delphi/skills/conhecimento-delphi/references/console-writeln-sem-flush-nao-loga.md +47 -0
  57. package/templates/perfis/delphi/skills/conhecimento-delphi/references/conversao-numerica-locale.md +47 -0
  58. package/templates/perfis/delphi/skills/conhecimento-delphi/references/delphi13-breaking-changes.md +41 -0
  59. package/templates/perfis/delphi/skills/conhecimento-delphi/references/dpr-uses-project-manager.md +62 -0
  60. package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-dcc-debuginformation-nao-booleano.md +78 -0
  61. package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-projectguid-valido.md +38 -0
  62. package/templates/perfis/delphi/skills/conhecimento-delphi/references/firedac-registro-drivers.md +94 -0
  63. package/templates/perfis/delphi/skills/conhecimento-delphi/references/horse-gbswagger-rotas-jwt.md +61 -0
  64. package/templates/perfis/delphi/skills/conhecimento-delphi/references/msb6003-command-line-too-long.md +52 -0
  65. package/templates/perfis/delphi/skills/conhecimento-delphi/references/recursos-rcdata.md +67 -0
  66. package/templates/perfis/delphi-fiscal/rules/campo-novo-acbr-preenchimento-explicito.md +61 -0
  67. package/templates/perfis/delphi-fiscal/rules/retorno-de-evento-nfe-pelo-cstat.md +51 -0
  68. package/templates/perfis/delphi-fiscal/rules/sucesso-de-webservice-fiscal-nao-prova-documento.md +100 -0
  69. package/templates/perfis/delphi-fiscal/rules/total-tributo-acbr-soma-itens.md +63 -0
  70. package/templates/perfis/delphi-fiscal/skills/diagnosticar-rejeicao-nfse/SKILL.md +155 -0
  71. package/templates/perfis/delphi-fiscal/skills/patch-acbr/SKILL.md +143 -0
  72. package/templates/skills/auditar-performance/SKILL.md +9 -0
  73. package/templates/skills/auditar-performance/references/pontos-quentes.md +8 -0
  74. package/templates/skills/auditar-seguranca/SKILL.md +55 -14
  75. package/templates/skills/auditar-seguranca/templates/relatorios/TECNICO.md +5 -0
  76. package/templates/skills/auditar-ui/SKILL.md +18 -3
  77. package/templates/skills/auditar-ui/references/ATRIBUICAO.md +44 -0
  78. package/templates/skills/auditar-ui/references/web-interface-guidelines.md +191 -0
  79. package/templates/skills/harness/references/validar-ideia.md +7 -6
  80. package/templates/skills/security-audit/AI-AND-LLM.md +83 -0
  81. package/templates/skills/security-audit/ATTACK-CLASSES.md +130 -0
  82. package/templates/skills/security-audit/CLIENT-SIDE.md +83 -0
  83. package/templates/skills/security-audit/CLOUD-AND-DEPLOYMENT.md +86 -0
  84. package/templates/skills/security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -0
  85. package/templates/skills/security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -0
  86. package/templates/skills/security-audit/HUNTING.md +251 -0
  87. package/templates/skills/security-audit/LICENSE +21 -0
  88. package/templates/skills/security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -0
  89. package/templates/skills/security-audit/ORIGEM.md +51 -0
  90. package/templates/skills/security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -0
  91. package/templates/skills/security-audit/RECONNAISSANCE.md +156 -0
  92. package/templates/skills/security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -0
  93. package/templates/skills/security-audit/SKILL.md +192 -0
  94. package/templates/skills/security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -0
  95. package/templates/skills/security-audit/VALIDATION-AND-REPORTING.md +186 -0
  96. package/templates/skills/security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -0
  97. package/templates/skills/security-audit/report-schema.json +461 -0
  98. package/templates/skills/security-audit/validate-coverage-ledger.cjs +872 -0
  99. package/templates/skills/security-audit/validate-findings.cjs +773 -0
  100. package/templates/skills/supabase-postgres-best-practices/CHANGELOG.md +73 -0
  101. package/templates/skills/supabase-postgres-best-practices/LICENSE +21 -0
  102. package/templates/skills/supabase-postgres-best-practices/ORIGEM.md +43 -0
  103. package/templates/skills/supabase-postgres-best-practices/SKILL.md +64 -0
  104. package/templates/skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
  105. package/templates/skills/supabase-postgres-best-practices/references/_sections.md +39 -0
  106. package/templates/skills/supabase-postgres-best-practices/references/_template.md +34 -0
  107. package/templates/skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
  108. package/templates/skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
  109. package/templates/skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
  110. package/templates/skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
  111. package/templates/skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
  112. package/templates/skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
  113. package/templates/skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
  114. package/templates/skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
  115. package/templates/skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
  116. package/templates/skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
  117. package/templates/skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
  118. package/templates/skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
  119. package/templates/skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
  120. package/templates/skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
  121. package/templates/skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
  122. package/templates/skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
  123. package/templates/skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
  124. package/templates/skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
  125. package/templates/skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
  126. package/templates/skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
  127. package/templates/skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
  128. package/templates/skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
  129. package/templates/skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
  130. package/templates/skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
  131. package/templates/skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
  132. package/templates/skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
  133. package/templates/skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
  134. package/templates/skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
  135. package/templates/skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
  136. package/templates/skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
  137. package/templates/skills/supabase-postgres-best-practices/references/security-rls-performance.md +63 -0
  138. package/templates/skills/vercel-react-best-practices/AGENTS.md +3810 -0
  139. package/templates/skills/vercel-react-best-practices/ORIGEM.md +39 -0
  140. package/templates/skills/vercel-react-best-practices/README.md +123 -0
  141. package/templates/skills/vercel-react-best-practices/SKILL.md +149 -0
  142. package/templates/skills/vercel-react-best-practices/metadata.json +15 -0
  143. package/templates/skills/vercel-react-best-practices/rules/_sections.md +46 -0
  144. package/templates/skills/vercel-react-best-practices/rules/_template.md +28 -0
  145. package/templates/skills/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
  146. package/templates/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  147. package/templates/skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
  148. package/templates/skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
  149. package/templates/skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
  150. package/templates/skills/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
  151. package/templates/skills/vercel-react-best-practices/rules/async-defer-await.md +82 -0
  152. package/templates/skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
  153. package/templates/skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
  154. package/templates/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
  155. package/templates/skills/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
  156. package/templates/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
  157. package/templates/skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
  158. package/templates/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
  159. package/templates/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  160. package/templates/skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
  161. package/templates/skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
  162. package/templates/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
  163. package/templates/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
  164. package/templates/skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
  165. package/templates/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
  166. package/templates/skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
  167. package/templates/skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
  168. package/templates/skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
  169. package/templates/skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
  170. package/templates/skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
  171. package/templates/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
  172. package/templates/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
  173. package/templates/skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
  174. package/templates/skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
  175. package/templates/skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
  176. package/templates/skills/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
  177. package/templates/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
  178. package/templates/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
  179. package/templates/skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
  180. package/templates/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  181. package/templates/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
  182. package/templates/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
  183. package/templates/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  184. package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  185. package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  186. package/templates/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
  187. package/templates/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
  188. package/templates/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
  189. package/templates/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  190. package/templates/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
  191. package/templates/skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
  192. package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  193. package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
  194. package/templates/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
  195. package/templates/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  196. package/templates/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  197. package/templates/skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
  198. package/templates/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  199. package/templates/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
  200. package/templates/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  201. package/templates/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
  202. package/templates/skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
  203. package/templates/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
  204. package/templates/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  205. package/templates/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
  206. package/templates/skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
  207. package/templates/skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
  208. package/templates/skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
  209. package/templates/skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
  210. package/templates/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
  211. package/templates/skills/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
  212. package/templates/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
  213. package/templates/skills/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
  214. package/templates/skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
  215. package/templates/skills/vercel-react-native-skills/AGENTS.md +2897 -0
  216. package/templates/skills/vercel-react-native-skills/ORIGEM.md +39 -0
  217. package/templates/skills/vercel-react-native-skills/README.md +165 -0
  218. package/templates/skills/vercel-react-native-skills/SKILL.md +121 -0
  219. package/templates/skills/vercel-react-native-skills/metadata.json +16 -0
  220. package/templates/skills/vercel-react-native-skills/rules/_sections.md +86 -0
  221. package/templates/skills/vercel-react-native-skills/rules/_template.md +28 -0
  222. package/templates/skills/vercel-react-native-skills/rules/animation-derived-value.md +53 -0
  223. package/templates/skills/vercel-react-native-skills/rules/animation-gesture-detector-press.md +95 -0
  224. package/templates/skills/vercel-react-native-skills/rules/animation-gpu-properties.md +65 -0
  225. package/templates/skills/vercel-react-native-skills/rules/design-system-compound-components.md +66 -0
  226. package/templates/skills/vercel-react-native-skills/rules/fonts-config-plugin.md +71 -0
  227. package/templates/skills/vercel-react-native-skills/rules/imports-design-system-folder.md +68 -0
  228. package/templates/skills/vercel-react-native-skills/rules/js-hoist-intl.md +61 -0
  229. package/templates/skills/vercel-react-native-skills/rules/list-performance-callbacks.md +44 -0
  230. package/templates/skills/vercel-react-native-skills/rules/list-performance-function-references.md +132 -0
  231. package/templates/skills/vercel-react-native-skills/rules/list-performance-images.md +53 -0
  232. package/templates/skills/vercel-react-native-skills/rules/list-performance-inline-objects.md +97 -0
  233. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-expensive.md +94 -0
  234. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-memo.md +82 -0
  235. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-types.md +104 -0
  236. package/templates/skills/vercel-react-native-skills/rules/list-performance-virtualize.md +67 -0
  237. package/templates/skills/vercel-react-native-skills/rules/monorepo-native-deps-in-app.md +46 -0
  238. package/templates/skills/vercel-react-native-skills/rules/monorepo-single-dependency-versions.md +63 -0
  239. package/templates/skills/vercel-react-native-skills/rules/navigation-native-navigators.md +188 -0
  240. package/templates/skills/vercel-react-native-skills/rules/react-compiler-destructure-functions.md +50 -0
  241. package/templates/skills/vercel-react-native-skills/rules/react-compiler-reanimated-shared-values.md +48 -0
  242. package/templates/skills/vercel-react-native-skills/rules/react-state-dispatcher.md +91 -0
  243. package/templates/skills/vercel-react-native-skills/rules/react-state-fallback.md +56 -0
  244. package/templates/skills/vercel-react-native-skills/rules/react-state-minimize.md +65 -0
  245. package/templates/skills/vercel-react-native-skills/rules/rendering-no-falsy-and.md +74 -0
  246. package/templates/skills/vercel-react-native-skills/rules/rendering-text-in-text-component.md +36 -0
  247. package/templates/skills/vercel-react-native-skills/rules/scroll-position-no-state.md +82 -0
  248. package/templates/skills/vercel-react-native-skills/rules/state-ground-truth.md +80 -0
  249. package/templates/skills/vercel-react-native-skills/rules/ui-expo-image.md +66 -0
  250. package/templates/skills/vercel-react-native-skills/rules/ui-image-gallery.md +104 -0
  251. package/templates/skills/vercel-react-native-skills/rules/ui-measure-views.md +78 -0
  252. package/templates/skills/vercel-react-native-skills/rules/ui-menus.md +174 -0
  253. package/templates/skills/vercel-react-native-skills/rules/ui-native-modals.md +77 -0
  254. package/templates/skills/vercel-react-native-skills/rules/ui-pressable.md +61 -0
  255. package/templates/skills/vercel-react-native-skills/rules/ui-safe-area-scroll.md +65 -0
  256. package/templates/skills/vercel-react-native-skills/rules/ui-scrollview-content-inset.md +45 -0
  257. package/templates/skills/vercel-react-native-skills/rules/ui-styling.md +87 -0
@@ -0,0 +1,60 @@
1
+ ---
2
+ descricao: "Regra incondicional: existência de registro nunca se testa por campo formatado para exibição"
3
+ paths:
4
+ - "**/*.pas"
5
+ - "**/*.dpr"
6
+ - "**/*.dpk"
7
+ - "**/*.inc"
8
+ - "**/*.dfm"
9
+ ---
10
+
11
+ # Regra incondicional: existência de registro nunca se testa por campo formatado para exibição
12
+
13
+ Aplica-se a toda guarda que decide **se um registro relacionado existe** antes de fazer UPDATE,
14
+ DELETE, reabertura ou conversão a partir dele — documento de origem, nota principal, título
15
+ financeiro, ordem vinculada, e afins.
16
+
17
+ ## O que é proibido
18
+
19
+ Testar existência pelo `.Text` de um controle preenchido com zeros à esquerda (ou qualquer
20
+ formatação de exibição):
21
+
22
+ ```pascal
23
+ // PROIBIDO: completar '' com 9 zeros dá '000000000' — este teste é sempre True
24
+ EditNumeroVinculado.Text := CompletarZeros(FieldByName('numero_vinculado').AsString, 9);
25
+ ...
26
+ if EditNumeroVinculado.Text <> '' then
27
+ ParamByName('cod_filial').AsInteger := StrToInt(FilialVinculada); // StrToInt('')
28
+ ```
29
+
30
+ O `LEFT OUTER JOIN` devolve NULL, `AsString` devolve `''`, e a formatação de exibição **apaga a
31
+ diferença entre "não existe" e "existe com valor zero"**. A guarda deixa de guardar.
32
+
33
+ ## O que fazer
34
+
35
+ A existência se testa pela **chave vinda do dataset**, antes de qualquer formatação:
36
+
37
+ ```pascal
38
+ if (StrToIntDef(FilialVinculada, 0) > 0) and (Trim(SerieVinculada) <> '') then
39
+ ```
40
+
41
+ Se o campo de origem for opcional (`LEFT JOIN`, coluna anulável), prefira `FieldByName(...).IsNull`
42
+ ou a chave crua. E use `StrToIntDef(..., 0)` em vez de `StrToInt` ao converter qualquer valor que
43
+ possa vir de coluna anulável — `StrToInt('')` derruba o fluxo inteiro com uma mensagem que não diz
44
+ nada ao usuário ("'' is not a valid integer value").
45
+
46
+ ## Por que escapa da revisão
47
+
48
+ O teste `<> ''` parece defensivo — é exatamente o que se espera ver ali. A falha só aparece quando
49
+ o registro relacionado **não existe**, e o desenvolvedor testa com o caso em que ele existe. O erro
50
+ costuma chegar pelo suporte, e o mesmo padrão pode estar latente em outro ramo, disparando um UPDATE
51
+ com chave zero em vez de uma exceção.
52
+
53
+ ## Antes de fechar a alteração
54
+
55
+ - Para cada `if <Controle>.Text <> ''` numa guarda de existência, verifique **onde aquele `.Text`
56
+ foi atribuído**. Se houver preenchimento com zeros, `Format` ou máscara no caminho, a guarda está
57
+ quebrada.
58
+ - Teste os **dois** casos: com e sem o registro relacionado. O fluxo feliz não distingue os dois.
59
+ - `grep -n "StrToInt(" <unit>.pas` nos blocos tocados: nenhuma conversão de coluna anulável pode
60
+ usar `StrToInt` sem default.
@@ -0,0 +1,55 @@
1
+ ---
2
+ descricao: "Regra: valor Double nunca é comparado por igualdade com literal decimal — comparar em inteiros ou com tolerância"
3
+ paths:
4
+ - "**/*.pas"
5
+ - "**/*.dpr"
6
+ - "**/*.dpk"
7
+ - "**/*.inc"
8
+ ---
9
+
10
+ # Regra incondicional: valor `Double` nunca é comparado por igualdade com literal decimal
11
+
12
+ Aplica-se a toda comparação de alíquota, percentual, quantidade ou valor lido como `Double` (`AsFloat`, campo
13
+ `Double` de classe, retorno de função) contra um número com casas decimais: `= 0.65`, `= 1.65`, `<> 7.6`, `in`.
14
+
15
+ ## O defeito
16
+
17
+ No dcc32 Win32, o literal `0.65` é avaliado como `Extended` (80 bits). O `Double` lido do banco é a aproximação de 64
18
+ bits do mesmo número. Os dois não são iguais, e a comparação dá falso **sempre**, mesmo com a coluna `numeric(8,2)`
19
+ guardando exatamente `0.65`:
20
+
21
+ ```pascal
22
+ // PROIBIDO: nunca é verdadeiro em Win32 quando Percentual vem de AsFloat
23
+ if (Self.Percentual = 0.65) or (Self.Percentual = 1.65) then
24
+ Result := '01'
25
+ ```
26
+
27
+ O código compila, o ramo errado roda em silêncio e o resultado parece regra de negócio, não bug. Um defeito assim
28
+ pode passar anos em produção gerando o valor errado para todo registro com aquele número exato.
29
+
30
+ ## Padrão obrigatório
31
+
32
+ Compare em inteiros, na escala da coluna, ou com tolerância explícita:
33
+
34
+ ```pascal
35
+ // CERTO: centésimos inteiros (coluna com 2 casas)
36
+ var LPercentualCentesimos := Round(Self.Percentual * 100);
37
+ if (LPercentualCentesimos = 65) or (LPercentualCentesimos = 165) then
38
+
39
+ // CERTO: tolerância explícita
40
+ if SameValue(Self.Percentual, 0.65, 0.0001) then // System.Math
41
+ ```
42
+
43
+ - A comparação com **zero** é segura, porque zero é exato nos dois tipos.
44
+ - `Currency` é decimal de ponto fixo e não tem o problema, mas só quando os **dois** lados são `Currency`.
45
+ - Uma função de arredondamento que devolve `Double` não resolve: arredondar e depois comparar com literal mantém o
46
+ defeito.
47
+
48
+ ## Antes de fechar a alteração
49
+
50
+ ```bash
51
+ grep -nE "(AsFloat|Percentual|Aliquota|Valor)[A-Za-z]*\)? *(=|<>) *[0-9]+\.[0-9]" <unit>.pas
52
+ ```
53
+
54
+ Toda ocorrência entre `Double` e literal decimal usa o padrão acima. Teste com o valor exato do literal, como 0,65, e
55
+ não só com valores vizinhos.
@@ -0,0 +1,84 @@
1
+ ---
2
+ descricao: "Regra incondicional: valor de enum lido no `.dfm` NÃO prova que o identificador está visível — localize a unit que o declara"
3
+ paths:
4
+ - "**/*.pas"
5
+ - "**/*.dpr"
6
+ - "**/*.dpk"
7
+ - "**/*.inc"
8
+ - "**/*.dfm"
9
+ ---
10
+
11
+ # Regra incondicional: valor de enum lido no `.dfm` NÃO prova que o identificador está visível — localize a unit que o declara
12
+
13
+ Aplica-se a toda edição de `.pas` que passe a **atribuir em código** um valor de enumerado (ou
14
+ constante) que até então só era conhecido por aparecer num `.dfm` — típico ao começar a preencher em
15
+ runtime uma propriedade de componente de terceiro (ACBr, ReportBuilder, Rx) que estava definida
16
+ apenas em design-time.
17
+
18
+ ## O `.dfm` guarda o identificador como TEXTO e resolve por RTTI em runtime
19
+
20
+ Quando um `.dfm` traz uma linha como:
21
+
22
+ ```
23
+ Cedente.PIX.TipoChavePIX = tchNenhuma
24
+ ```
25
+
26
+ isso **não** significa que `tchNenhuma` seja alcançável a partir do `uses` daquela unit. O streaming
27
+ da VCL grava o nome do valor como **string** e o converte para o ordinal via **RTTI, em tempo de
28
+ execução** — a unit que **declara** o enum precisa apenas estar **linkada no executável** (o que
29
+ acontece transitivamente, pelo `uses` do próprio componente), **nunca** no `uses` da unit que hospeda
30
+ o `.dfm`.
31
+
32
+ Ou seja: o `.dfm` prova que o valor **existe em algum lugar do projeto**; não prova **nada** sobre
33
+ visibilidade em tempo de compilação. Na primeira linha de código que usar o literal, o build acusa:
34
+
35
+ ```
36
+ [dcc32 Error] E2003 Undeclared identifier: 'tchNenhuma'
37
+ ```
38
+
39
+ O engano é convidativo porque o raciocínio parece sólido ("está no `.dfm` desta unit, logo compila
40
+ aqui") e porque **o erro só aparece na compilação** — nenhuma leitura de código o revela.
41
+
42
+ ## Procedimento obrigatório
43
+
44
+ **Antes** de escrever a primeira atribuição, localize a unit que **declara** o identificador nos
45
+ fontes da biblioteca — não deduza pelo nome da unit "irmã" mais óbvia:
46
+
47
+ ```bash
48
+ # macOS/Linux (com os fontes da biblioteca acessíveis):
49
+ grep -rn "tchNenhuma" "<pasta-dos-fontes-da-biblioteca>" --include="*.pas"
50
+
51
+ # Windows:
52
+ findstr /S /C:"tchNenhuma" <pasta-dos-fontes-da-biblioteca>\*.pas
53
+ ```
54
+
55
+ Acrescente **essa** unit ao `uses` — na `implementation`, se os literais só aparecem no corpo dos
56
+ métodos (o caso normal); na `interface` apenas se o tipo entrar em alguma assinatura.
57
+
58
+ > **Exemplo:** no ACBr, `TACBrPIXTipoChave = (tchNenhuma, tchEmail, tchCPF, tchCNPJ, tchCelular,
59
+ > tchAleatoria)` é declarado em **`ACBrPIXBase.pas`** — **não** em `ACBrBoletoConversao`, que seria o
60
+ > palpite natural por ser a unit de conversões do `ACBrBoleto` e já estar no `uses`. A propriedade que o
61
+ > consome é `TACBrCedentePIX.TipoChavePIX: TACBrPIXTipoChave`, em `ACBrBoleto.pas`.
62
+
63
+ ## Ao adicionar a unit, confirme que os OUTROS builds continuam compilando
64
+
65
+ Quando o mesmo `.pas` é compilado por mais de um projeto (sob `{$ifdef ...}` ou com search paths
66
+ próprios), antes de acrescentar um `uses` **incondicional** verifique se a unit nova já é dependência
67
+ de algo que aqueles projetos inevitavelmente compilam:
68
+
69
+ ```bash
70
+ grep -n "ACBrPIXBase" "<pasta-dos-fontes-da-biblioteca>/ACBrBoleto/ACBrBoleto.pas"
71
+ ```
72
+
73
+ Se o **próprio componente** já faz `uses` dela, todo projeto que compila o componente já tem a unit no
74
+ search path → a inclusão é segura **sem guarda de define**. Se **não** for esse o caso, coloque o
75
+ `uses` sob a mesma guarda condicional usada pelos vizinhos, ou o build de outro projeto quebra sem
76
+ que nada neste repositório o denuncie.
77
+
78
+ ## O sintoma quando esta regra é ignorada
79
+
80
+ Um ciclo de build desperdiçado: a análise de impacto passa, a revisão de código aprova (o identificador
81
+ "existe", afinal), e o `E2003` só aparece quando o usuário compila na IDE — no fim da tarefa, quando
82
+ tudo já parecia entregue. Se o erro citar **todos** os literais de um mesmo enum (e não um ou outro
83
+ nome divergente), a causa é **esta** — falta a unit no `uses` —, e não nome de literal errado por
84
+ diferença de versão da biblioteca.
@@ -0,0 +1,172 @@
1
+ ---
2
+ descricao: "Regra incondicional: antes de criar qualquer rotina utilitária, PROCURE nas bibliotecas compartilhadas e no próprio sistema"
3
+ paths:
4
+ - "**/*.pas"
5
+ - "**/*.dpr"
6
+ - "**/*.dpk"
7
+ - "**/*.inc"
8
+ ---
9
+
10
+ # Regra incondicional: antes de criar qualquer rotina utilitária, PROCURE nas bibliotecas compartilhadas e no próprio sistema
11
+
12
+ Aplica-se a toda criação de `function`/`procedure` **utilitária** — validação de formato, extração,
13
+ máscara, conversão, cálculo de dígito, manipulação de string/data/arquivo — em qualquer `.pas` do
14
+ projeto, seja como método privado de um form, seja como rotina de DataModule. Complementa
15
+ [../dados/cnpj-alfanumerico-nao-extrair-so-numeros.md](../dados/cnpj-alfanumerico-nao-extrair-so-numeros.md).
16
+
17
+ ## A busca é obrigatória e vem ANTES da primeira linha do corpo
18
+
19
+ Escrever o helper leva dois minutos, e é exatamente por isso que ele é escrito sem busca. O custo
20
+ não está na escrita: está no **segundo lugar da verdade** que passa a existir para a mesma pergunta
21
+ — e que ninguém mantém junto quando a regra muda.
22
+
23
+ Ordem obrigatória, do compartilhado para o local:
24
+
25
+ 1. **Mapa do projeto.** Se o `CLAUDE.md`, o `harness-projeto.md` ou outra documentação do projeto lista
26
+ as bibliotecas utilitárias da casa e o que cada uma cobre, comece por ali.
27
+ 2. **Bibliotecas compartilhadas** (units utilitárias usadas por vários sistemas, no search path do
28
+ projeto):
29
+ ```bash
30
+ grep -rnE "^\s*(class )?(function|procedure) [A-Za-z]*<termo>" <pasta-das-bibliotecas> --include="*.pas"
31
+ ```
32
+ 3. **O próprio sistema — como as outras telas resolvem ISTO?**
33
+ ```bash
34
+ grep -rn "<termo>" --include="*.pas" . | head -30
35
+ ```
36
+ 4. **A RTL do Delphi** (`System.SysUtils`, `System.StrUtils`, `System.DateUtils`, `System.Math`,
37
+ `System.IOUtils`, `System.Character`): muita "rotina utilitária" já existe ali.
38
+
39
+ Procure por sinônimos (`SomenteNumeros`, `ExtrairNumeros`, `ApenasDigitos`, `OnlyNumbers`) e em
40
+ português e inglês. O passo 3 é o mais revelador e o mais pulado: mesmo sem função pronta, o
41
+ projeto costuma já ter um **idioma consagrado** para a pergunta, repetido em várias units.
42
+ Reproduzi-lo vale mais do que inventar uma variação.
43
+
44
+ > **Se a unit já tem uma biblioteca utilitária no `uses`, a busca nela é obrigatória sem qualquer
45
+ > desculpa.** A capacidade costuma estar a uma linha de distância, na unit já referenciada.
46
+
47
+ ## Código novo usa as bibliotecas `Fontdata.*`, nunca `BibMarco`
48
+
49
+ Vale para projetos que usam as bibliotecas `Fontdata` (confira se `Fontdata.Utils` ou `Fontdata.MessageDialog`
50
+ aparece no `uses` de alguma unit). Unit nova, e trecho novo dentro de unit legada (handler, rotina, método),
51
+ **não** chamam a `BibMarco`. O equivalente está nas bibliotecas `Fontdata`:
52
+
53
+ | `BibMarco` (legado) | Código novo |
54
+ |---|---|
55
+ | `Mensagem(msg, mtWarning, [mbOk], 0)` | `TMessageDialog.Warning(msg)` |
56
+ | `Mensagem(msg, mtInformation, [mbOk], 0)` | `TMessageDialog.Info(msg)` |
57
+ | `Mensagem(msg, mtError, [mbOk], 0)` | `TMessageDialog.Error(msg)` |
58
+ | `Mensagem(msg, mtConfirmation, [mbYes, mbNo], 0) = mrYes` | `TMessageDialog.Question(msg)` (`Boolean`) |
59
+ | `CompletaZeros(valor, n)` | `TUtils.CompletarZeros(valor, n)` |
60
+ | `ExtrairNumeros(texto)` | `TUtils.ExtrairNumeros(texto)` |
61
+
62
+ - `TMessageDialog` vem de `Fontdata.MessageDialog`, e `TUtils` de `Fontdata.Utils`. Os dois entram no `uses` da
63
+ `implementation`.
64
+ - O legado de uma unit existente **não** é migrado por tabela: só o trecho que a task cria ou reescreve segue o
65
+ padrão novo. A `BibMarco` continua no `uses` enquanto o legado da unit a usar.
66
+ - Função da `BibMarco` sem equivalente em `Fontdata.*` vira pergunta ao usuário. Não recrie a função na unit
67
+ nova.
68
+
69
+ ## Helpers de componente das bibliotecas `Fontdata`
70
+
71
+ Vale para projetos que já têm `Bibliotecas\Helpers` no search path do `.dproj`. Confira antes:
72
+
73
+ ```bash
74
+ grep -n "Bibliotecas\\\\Helpers" *.dproj
75
+ ```
76
+
77
+ As units de helper fazem `uses Fontdata.Utils`, então `Bibliotecas\Utils` também precisa estar no search path.
78
+ Se algum dos caminhos não aparece, **não** acrescente ao `.dproj` por conta própria: pergunte ao usuário.
79
+
80
+ Uma unit por framework (`Fontdata.Helpers.VCL`, `Fontdata.Helpers.FMX`, `Fontdata.Helpers.UniGUI`), no `uses` da
81
+ `implementation`.
82
+
83
+ **Consulte o catálogo antes de escrever.** O que cada unit `Fontdata.*` do search path declara (helpers, classes,
84
+ rotinas, com a assinatura) está em `.claude/skills/conhecimento-delphi/references/bibliotecas-fontdata.md`. O
85
+ arquivo é gerado no projeto, não vem no pacote: se ele não existir, gere com
86
+ `npx @fontdata/ai-harness delphi catalogo`, e rode o comando de novo quando as units mudarem (o `doctor` avisa).
87
+
88
+ Label só tem helper na VCL. `TSwitch` só na FMX. `Replace` só existe na VCL (edit e label); FMX e UniGUI não têm.
89
+
90
+ | Código manual | Helper | Semântica exata |
91
+ |---|---|---|
92
+ | `StrToCurrDef(Edit.Text, 0)` / `StrToFloat(...)` | `Edit.AsCurrency` / `Edit.AsFloat` | `TUtils.ConverterValor(Text)`: tira `R`, `$` e `%` em qualquer posição, os espaços só das pontas e **todos** os `.`; qualquer `(`, em qualquer posição, torna o valor negativo; vazio vira `0`; depois `StrToFloat` (ver armadilhas) |
93
+ | `StrToIntDef(Edit.Text, 0)` | `Edit.AsInteger` | `StrToIntDef(TUtils.ExtrairNumeros(Text), 0)` |
94
+ | `Edit.Text := CurrToStr(v)` (e `FloatToStr`, `IntToStr`, `DateToStr`, `TimeToStr`, `DateTimeToStr`) | `Edit.AsCurrency := v` (e `AsFloat`, `AsInteger`, `AsDate`, `AsTime`, `AsDateTime`) | o setter chama exatamente essa função da RTL |
95
+ | `StrToDateDef(Edit.Text, Date)` | `Edit.AsDate` | `StrToDateDef(Text, DateOf(Now))` |
96
+ | `StrToTimeDef(Edit.Text, Time)` | `Edit.AsTime` | `StrToTimeDef(Text, TimeOf(Now))` |
97
+ | `StrToDateTimeDef(Edit.Text, Now)` | `Edit.AsDateTime` | `StrToDateTimeDef(Text, Now)` |
98
+ | `Edit.Text = ''` | `Edit.IsEmpty` / `Edit.NotIsEmpty` | compara o texto **sem** `Trim` |
99
+ | `Trim(Edit.Text) = ''` | `Edit.Trim = ''` | **não** é `Edit.IsEmpty`: `' '` não é vazio para `IsEmpty` |
100
+ | `TUtils.ExtrairNumeros(Edit.Text)` | `Edit.ExtractNumbers` | a mesma chamada |
101
+ | `QuotedStr(Edit.Text)` | `Edit.QuotedString` | `String.QuotedString` (aspas simples, duplicando as internas) |
102
+ | `Edit.Text = 'X'` / `Pos('X', Edit.Text) > 0` | `Edit.Equals('X')` / `Edit.Contains('X')` (e `NotEquals`, `NotContains`) | diferencia maiúsculas de minúsculas |
103
+ | `UpperCase`, `LowerCase`, `Copy`, `Length` sobre o texto | `Edit.ToUpper`, `Edit.ToLower`, `Edit.Substring(i[, n])`, `Edit.Length` | métodos de `String`; `Substring` começa em **0**, `Copy` em 1 |
104
+ | `if CheckBox.Checked then 'S' else 'N'` (e o inverso) | `CheckBox.Value` (FMX: também `Switch.Value`) | leitura devolve `'S'`/`'N'`; escrita marca só com `'S'` exato |
105
+ | `StrToCurrDef(Label.Caption, 0)` e afins (só VCL) | `Label.AsCurrency`, `Label.IsEmpty`... | os mesmos métodos do edit, sobre `Caption` |
106
+
107
+ ### Armadilhas
108
+
109
+ - **`AsDate`, `AsTime` e `AsDateTime` não validam.** Texto inválido ou vazio devolve a data de hoje, a hora atual
110
+ ou `Now`, sem erro. Nunca use para validar entrada: valide antes (`TryStrToDate` ou a validação da tela) e só
111
+ depois leia pelo helper.
112
+ - **`AsCurrency` e `AsFloat` levantam exceção.** Ao contrário do que o `Def` do código manual sugere, texto não
113
+ numérico (`'abc'`) gera `EConvertError` do `StrToFloat`; só o vazio vira `0`. E `AsCurrency` passa por `Double`.
114
+ - **Dependem do locale.** `ConverterValor` remove todo `.` (milhar no padrão brasileiro) e deixa a vírgula para o
115
+ `StrToFloat` com o `DecimalSeparator` da máquina: `'1.50'` vira `150`, e numa máquina com separador `.` o
116
+ `'1,50'` falha. Os setters (`CurrToStr`, `DateToStr`...) e `AsDate`/`AsTime` também seguem as configurações
117
+ regionais.
118
+ - **`AsInteger` extrai dígitos antes de converter.** `'-5'` vira `5`, `'1,50'` vira `150`, `'abc'` vira `0`. Não
119
+ serve para número com sinal ou decimal.
120
+ - **`CheckBox.Value := 's'` desmarca.** A comparação com `'S'` diferencia maiúsculas.
121
+ - **Só um class helper por classe vale num escopo**: o da última unit do `uses` vence. Um segundo helper de
122
+ `TCustomEdit` (ou de `TCheckBox`, `TCustomLabel`) no projeto desliga este, e os métodos "somem" sem aviso claro. Um helper de classe descendente (ex.: `TEdit`) também esconde o de
123
+ `TCustomEdit` nas variáveis daquele tipo.
124
+ Antes de criar helper próprio para essas classes, procure os existentes (`grep -rn "class helper for" --include="*.pas" .`).
125
+ - **Nomes que coincidem com outros.** `Edit.Equals('X')` compara texto, não é o `TObject.Equals(Obj)`;
126
+ `Edit.Length` e `Edit.Trim` são do helper e devolvem o tamanho / o texto aparado, não alteram o componente.
127
+ Dentro de um método do form, `Trim(...)` e `Length(...)` sem qualificador continuam sendo da RTL. Leia com atenção.
128
+
129
+ O legado **não** é migrado: só código novo ou reescrito usa o helper, como na tabela de `Fontdata.*` acima. Antes
130
+ de trocar uma conversão manual, compare o caso de borda (vazio, inválido, negativo) conforme a seção seguinte.
131
+
132
+ ## Reaproveitar não é copiar a chamada — é preservar a SEMÂNTICA
133
+
134
+ A rotina existente quase nunca tem exatamente o contrato do helper que você ia escrever. **Compare
135
+ os casos de borda antes de substituir**, um a um: string vazia, `nil`, zero, negativo, acento,
136
+ valor fora de faixa.
137
+
138
+ O caso de borda que costuma divergir é o **vazio**:
139
+
140
+ ```pascal
141
+ // helper local removido: False para vazio
142
+ Result := ATexto <> '';
143
+ if not Result then Exit;
144
+
145
+ // ExtrairNumeros(''): devolve '' — logo ExtrairNumeros(T) = T é TRUE para vazio
146
+ // -> o guard de vazio faz parte da substituição, não é redundância:
147
+ if (Texto <> '') and (ExtrairNumeros(Texto) = Texto) then
148
+ ```
149
+
150
+ Sem esse cuidado, a "simplificação" muda o comportamento em silêncio — e o caminho quebrado é
151
+ justamente o do campo em branco, que o teste do fluxo feliz nunca exercita.
152
+
153
+ ## Quando criar é a resposta certa
154
+
155
+ Criar rotina nova é legítimo quando a busca **foi feita** e mostrou que nada cobre o caso. Nesse
156
+ caso, decida **onde** ela mora antes de escrevê-la:
157
+
158
+ | A rotina serve... | Mora em |
159
+ |---|---|
160
+ | só a esta tela, e depende do estado dela | método privado do próprio form |
161
+ | a este módulo (fiscal, estoque, financeiro) | o DataModule ou a unit do módulo |
162
+ | a qualquer sistema da casa, sem depender deste | a biblioteca compartilhada — **se for outro repositório, exige aprovação do usuário** |
163
+
164
+ Um helper genérico (sem nenhuma dependência do form) nascendo como método privado de um form é
165
+ sinal de que a pergunta de "onde mora" não foi feita.
166
+
167
+ ## Antes de fechar a alteração
168
+
169
+ - Para **cada** rotina nova declarada no diff, registre na resposta **qual busca foi feita** e o que
170
+ ela retornou. "Não encontrei nada" só vale acompanhado do comando que produziu o vazio.
171
+ - Se a rotina nova reproduz um idioma que já existe em outras units, **use o idioma existente** — a
172
+ consistência vale mais que a marginal elegância da versão nova.
@@ -0,0 +1,43 @@
1
+ ---
2
+ descricao: "Regra incondicional: nunca deixar escrita de debug no Clipboard em código de produção"
3
+ paths:
4
+ - "**/*.pas"
5
+ - "**/*.dpr"
6
+ - "**/*.dpk"
7
+ - "**/*.inc"
8
+ ---
9
+
10
+ # Regra incondicional: nunca deixar escrita de debug no Clipboard em código de produção
11
+
12
+ Aplica-se a toda unit `.pas` do projeto. É proibido deixar, em código entregue, escrita no
13
+ clipboard usada como apoio de depuração — tipicamente o SQL de uma `TFDQuery` copiado para a
14
+ área de transferência durante a montagem/execução de uma consulta.
15
+
16
+ ## O que é proibido
17
+
18
+ Linhas como estas, dentro de rotinas de montagem/execução de query (ou qualquer fluxo de
19
+ negócio), são **debug** e não podem ser commitadas:
20
+
21
+ ```pascal
22
+ Clipboard.AsText := SQL.Text; // copia o SELECT para o clipboard — PROIBIDO em produção
23
+ Clipboard.SetTextBuf(...); // idem, qualquer escrita de depuração no clipboard
24
+ ```
25
+
26
+ - Elas sobrescrevem silenciosamente o que o usuário tinha copiado — o cliente cola o SELECT
27
+ sem entender o porquê. O erro só aparece em runtime, para o usuário final.
28
+ - O sintoma típico: o usuário digita num campo de filtro de uma tela e, sem pedir, o texto do
29
+ SELECT montado vai parar no clipboard.
30
+
31
+ ## O que continua permitido
32
+
33
+ Escrita/limpeza de clipboard que faz parte de uma **funcionalidade real** pedida pelo usuário
34
+ (ex.: botão "Copiar chave", `Clipboard.Clear` para proteger um dado sensível). O critério é:
35
+ a operação de clipboard pertence ao fluxo de negócio (acionada por um controle/intenção do
36
+ usuário) e não a uma inspeção de SQL/variável de desenvolvimento.
37
+
38
+ ## Antes de fechar a alteração
39
+
40
+ - Faça `Grep` (sem diferenciar caixa) por `Clipboard.AsText :=` e `Clipboard.SetTextBuf` na unit
41
+ alterada e confirme que nenhuma escrita de clipboard foi introduzida como apoio de debug.
42
+ - Se precisar inspecionar o SQL durante o desenvolvimento, use o debugger/log temporário e
43
+ **remova antes do commit** — nunca o clipboard.
@@ -0,0 +1,65 @@
1
+ ---
2
+ descricao: "Regra incondicional: validação no `OnExit` NÃO protege a gravação — revalide no ponto de gravação o que não pode ser gravado"
3
+ paths:
4
+ - "**/*.pas"
5
+ - "**/*.dpr"
6
+ - "**/*.dpk"
7
+ - "**/*.inc"
8
+ - "**/*.dfm"
9
+ ---
10
+
11
+ # Regra incondicional: validação no `OnExit` NÃO protege a gravação — revalide no ponto de gravação o que não pode ser gravado
12
+
13
+ Aplica-se a toda validação de campo-chave de documento feita no `OnExit` (série, filial, número,
14
+ código fiscal, fornecedor) que **impede** um documento inválido: série de outra filial, série
15
+ desativada, combinação de tipos incompatível, etc. Complementa
16
+ [../telas/foco-decisao-por-canfocus-nao-tabstop.md](../telas/foco-decisao-por-canfocus-nao-tabstop.md).
17
+
18
+ ## O `Exit` do handler só sai do handler
19
+
20
+ Várias telas preenchem outra tela **por código**, chamando os eventos dela em sequência:
21
+
22
+ ```pascal
23
+ FormDocumento.DocumentoProprio := True;
24
+ FormDocumento.EditSerie.Text := EditSerieOrigem.Text;
25
+ FormDocumento.EditSerieExit(Self); // mostra "Série não permitida" e dá Exit...
26
+ FormDocumento.EditNumeroExit(Self); // ...e o chamador segue normalmente
27
+ // lança itens, ShowModal — a série bloqueada continua no campo
28
+ ```
29
+
30
+ A mensagem aparece, o teste manual "vê o bloqueio" e dá o caso por aprovado. O documento **grava
31
+ mesmo assim**, porque:
32
+
33
+ - o `Exit` não se propaga para quem chamou o evento;
34
+ - o estado que o bloqueio desfaz na digitação manual (ex.: `DocumentoProprio := False`) costuma
35
+ ser **preservado de propósito** no fluxo automatizado (`if not FLancamentoAutomatico then`);
36
+ - o botão de gravar confia que o `OnExit` já validou.
37
+
38
+ ## Padrão obrigatório
39
+
40
+ 1. **Toda validação que impede documento inválido é repetida no ponto de gravação**, antes de
41
+ `StartTransaction` e de qualquer reserva de número. A validação no `OnExit` serve para dar
42
+ feedback ao usuário. A barreira de verdade fica na gravação.
43
+ 2. **Antes de fechar**, procure quem chama o handler por código:
44
+ `grep -rn "<Form>\.<Campo>Exit(" --include="*.pas" .`. Se houver chamador, a revalidação na
45
+ gravação é obrigatória. Se possível, valide também **no chamador**, antes de criar a tela.
46
+ 3. **`SetFocus` em validação de handler que pode rodar por código** exige `CanFocus`: o chamador
47
+ costuma disparar o evento antes do `ShowModal`.
48
+ 4. **O roteiro de teste do fluxo automatizado vai até a gravação.** "A mensagem apareceu" não
49
+ prova nada: confirme que o documento **não foi gravado** e que a numeração não avançou.
50
+
51
+ ## Caso irmão: `OnColExit` de `TDBGrid`
52
+
53
+ A validação no `OnColExit` só roda quando muda a **coluna**. O ENTER costuma passar por ela, mas a seta muda de
54
+ **linha** e o `TDBGrid` faz o `Post` implícito sem `ColExit`. A trava de verdade fica no `BeforePost` do dataset (com
55
+ `Abort`) e é repetida no OK da tela. Teste ENTER, seta, clique em outra linha e OK.
56
+
57
+ ## Caso recorrente: restrição por filial
58
+
59
+ Quando um cadastro auxiliar (série, tabela de preço, depósito) pode ser restrito a uma filial, toda
60
+ tela que o usa compara a filial do cadastro com a do documento, no mesmo idioma que o projeto já usa
61
+ para isso. Uma pesquisa (F2/lookup) que não filtra filial não substitui essa validação.
62
+
63
+ E a restrição só vale onde faz sentido: se o campo pode guardar um dado de terceiro (a série da nota
64
+ do fornecedor, por exemplo), bloqueie a outra filial só quando o documento for **próprio**, senão um
65
+ documento de terceiro com código coincidente é barrado.
@@ -0,0 +1,69 @@
1
+ ---
2
+ descricao: "Regra incondicional: envolver código existente num bloco novo muda o escopo das variáveis inline"
3
+ paths:
4
+ - "**/*.pas"
5
+ - "**/*.dpr"
6
+ - "**/*.dpk"
7
+ - "**/*.inc"
8
+ ---
9
+
10
+ # Regra incondicional: envolver código existente num bloco novo muda o escopo das variáveis inline
11
+
12
+ Aplica-se a toda edição que **envolve trecho já existente** de um `.pas` num bloco novo — `try..finally`
13
+ para uma flag, `try..except`, `begin..end` de um `if`, laço `for`/`while` — em units que usam
14
+ **variáveis inline** (`var LX := …`, Delphi 10.3 em diante).
15
+
16
+ ## A variável inline vive até o `end` do bloco onde foi DECLARADA
17
+
18
+ Uma variável da seção `var` da rotina vale no corpo inteiro. Uma **inline** vale só do ponto da
19
+ declaração até o fim do **bloco que a contém**. Envolver um trecho num bloco novo muda o dono
20
+ dessa declaração sem mudar nenhuma linha dela:
21
+
22
+ ```pascal
23
+ // ANTES — compila: LQuantidadeGerada pertence ao begin..end do if
24
+ begin
25
+ ...
26
+ var LQuantidadeGerada := 0;
27
+ ... Inc(LQuantidadeGerada) ...
28
+ if LQuantidadeGerada > 0 then ...
29
+ end;
30
+
31
+ // DEPOIS — E2003: a declaração passou a pertencer ao try..finally
32
+ begin
33
+ FSuspenderAtualizacao := True;
34
+ try
35
+ ...
36
+ var LQuantidadeGerada := 0;
37
+ ... Inc(LQuantidadeGerada) ...
38
+ finally
39
+ FSuspenderAtualizacao := False;
40
+ end;
41
+ if LQuantidadeGerada > 0 then ... // [dcc32 Error] E2003 Undeclared identifier
42
+ end;
43
+ ```
44
+
45
+ ## Por que escapa da revisão
46
+
47
+ Lendo o código, a variável **parece** estar em escopo: a declaração continua ali, algumas linhas
48
+ acima, com o mesmo recuo — o novo `try` costuma ser inserido **sem reindentar** o corpo, justamente
49
+ para manter o diff pequeno. O executor e o revisor leem o diff, e o diff não mostra a declaração nem
50
+ o uso posterior, só as linhas `try`/`finally` acrescentadas. O erro só aparece no **build**, que o
51
+ agente não faz — um ciclo inteiro de build desperdiçado.
52
+
53
+ ## Procedimento obrigatório
54
+
55
+ Ao inserir `try`, `begin` ou início de laço envolvendo código existente:
56
+
57
+ 1. **Liste as inline declaradas dentro do trecho envolvido:**
58
+ ```bash
59
+ awk 'NR>=<linha_try> && NR<=<linha_finally> && /^[[:space:]]*var L[A-Za-z]+/' <unit>.pas
60
+ ```
61
+ 2. **Para cada uma, procure uso DEPOIS do fim do bloco** (entre o `end` do bloco novo e o `end` da
62
+ rotina). Se houver, **mova a declaração para antes do bloco**, preservando o valor inicial —
63
+ desde que nada entre o ponto antigo e o novo leia a variável.
64
+ 3. **Não migre para a seção `var`** da rotina se o projeto preserva as inline existentes. Basta subir a
65
+ declaração inline.
66
+ 4. Registre na resposta ao revisor quais inline foram verificadas — "nenhuma" só vale acompanhado do
67
+ comando que produziu a lista vazia.
68
+
69
+ Vale igualmente para `for var LI := …`: o contador inline não existe depois do laço.
@@ -0,0 +1,40 @@
1
+ ---
2
+ paths:
3
+ - "**/*.pas"
4
+ - "**/*.dfm"
5
+ - "**/*.dpr"
6
+ - "**/*.inc"
7
+ ---
8
+
9
+ # Regra (camada de UI): decidir `SetFocus` por `CanFocus`, nunca por `TabStop`
10
+
11
+ Aplica-se a todo código que decide **para qual controle mover o foco** (`SetFocus`) a partir de uma
12
+ condição sobre outro controle, tipicamente em `OnExit`/`OnKeyPress` de telas de lançamento que testam se
13
+ um campo "está disponível" antes de focá-lo.
14
+
15
+ ## `TabStop` não diz se o controle pode receber foco agora
16
+
17
+ `TabStop` só controla se a tecla **Tab** alcança o controle na navegação. Não indica se ele está apto a
18
+ receber foco neste momento. Um controle pode ter `TabStop = False` (valor de design, nunca ajustado em
19
+ runtime) e estar `Visible = True` e `Enabled = True`, perfeitamente focável por `SetFocus`.
20
+
21
+ Um `if <Campo>.TabStop then <Campo>.SetFocus else <Outro>.SetFocus` que dependa de `TabStop` sem que o
22
+ código jamais ajuste a propriedade **sempre cai no `else`** e manda o foco para o controle errado. Em
23
+ silêncio: não lança exceção, não aparece na compilação, só o usuário percebe ao navegar pela tela.
24
+
25
+ ## Padrão obrigatório
26
+
27
+ Use `CanFocus` (de `TWinControl`): ele já considera `Visible`, `Enabled` e a hierarquia de exibição
28
+ (`Showing`):
29
+
30
+ ```pascal
31
+ if EditCondicaoPagamento.CanFocus then
32
+ EditCondicaoPagamento.SetFocus
33
+ else
34
+ EditCarteira.SetFocus;
35
+ ```
36
+
37
+ - Se a intenção for também permitir a navegação por Tab até o controle, ajuste `TabStop` à parte: é uma
38
+ decisão de navegação, independente da decisão de `SetFocus`.
39
+ - Um handler costuma repetir o mesmo bloco de decisão de foco para várias mensagens de validação. Corrija
40
+ **todas** as ocorrências de uma vez, e as dos handlers semelhantes de outras telas.