@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,80 @@
1
+ ---
2
+ paths:
3
+ - "**/*.pas"
4
+ - "**/*.dfm"
5
+ - "**/*.dpr"
6
+ - "**/*.inc"
7
+ ---
8
+
9
+ # Regra (camada de UI): form criado dinamicamente sem dono, toda saída da rotina libera o form
10
+
11
+ Aplica-se a toda rotina que cria um form auxiliar em runtime sem dono (`TFormX.Create(nil)`, ou um helper
12
+ do projeto que faça isso por baixo) para exibi-lo e **ler os seus campos depois do `ShowModal`**. É o caso
13
+ das telas orquestradoras que abrem, em sequência, forms de pagamento, parcelas ou confirmação.
14
+
15
+ ## Sem dono, só o `Free` explícito libera
16
+
17
+ Form criado com `Create(nil)` não tem dono: nem a tela que o criou nem a aplicação o liberam ao fechar. Um
18
+ `Free` escrito no fim da rotina só roda no caminho de sucesso. Qualquer `Exit` depois da criação deixa o
19
+ form na memória: cancelamento, botão "Retornar", validação que falha, `except` que mostra mensagem e sai.
20
+
21
+ Quando a referência é uma **variável global** (a que o IDE declara na unit do form), a próxima execução
22
+ sobrescreve a variável e a instância anterior fica órfã. Nada denuncia na hora: o sintoma aparece só ao
23
+ fechar o sistema, como "Unexpected Memory Leak" do FastMM, sem indicar a tela que o causou.
24
+
25
+ ## Padrão obrigatório
26
+
27
+ Prefira variável local e `try`/`finally`. O `finally` roda também no `Exit`, então cobre toda saída:
28
+
29
+ ```pascal
30
+ var
31
+ LFormParcelas: TFormParcelas;
32
+ begin
33
+ LFormParcelas := TFormParcelas.Create(nil);
34
+ try
35
+ if LFormParcelas.ShowModal = mrCancel then
36
+ Exit;
37
+ LEnviarEmail := LFormParcelas.CheckBoxEnviarEmail.Checked;
38
+ finally
39
+ LFormParcelas.Free;
40
+ end;
41
+ end;
42
+ ```
43
+
44
+ Em rotina legada longa que cria vários forms em pontos diferentes e não comporta `try`/`finally`
45
+ aninhados sem reescrita, centralize a liberação numa rotina privada e chame-a antes de **toda** saída
46
+ posterior à primeira criação e no fim do caminho de sucesso:
47
+
48
+ ```pascal
49
+ procedure TFormPedido.LiberarFormsAuxiliares;
50
+ begin
51
+ FreeAndNil(FFormPagamento);
52
+ FreeAndNil(FFormParcelas);
53
+ end;
54
+
55
+ if FFormPagamento.ShowModal = mrCancel then
56
+ begin
57
+ LiberarFormsAuxiliares;
58
+ Exit;
59
+ end;
60
+ ```
61
+
62
+ - `FreeAndNil` aceita variável `nil` e a zera depois do `Free`, então pode ser chamado sem `Assigned`,
63
+ inclusive para forms que aquela execução não chegou a criar.
64
+ - `if ... then Exit;` de uma linha vira `begin`/`end` em linhas separadas.
65
+ - No caminho de sucesso, a liberação vem **depois** da última leitura do form.
66
+ - Se o form não precisa ser lido depois do `ShowModal`, use o helper do projeto que cria, exibe e libera
67
+ numa chamada só, ou o `try`/`finally` acima.
68
+
69
+ ## Antes de fechar
70
+
71
+ ```bash
72
+ grep -niE "create\(nil\)|\.free\b|freeandnil|\bexit\b" <Unit>.pas # -i: Delphi não diferencia caixa
73
+ ```
74
+
75
+ Em cada rotina que cria form sem dono, todo `Exit` posterior à primeira criação precisa estar dentro de um
76
+ `try`/`finally` ou ter a liberação antes dele. Rotinas irmãs nascem de cópia: corrija todas na mesma
77
+ passagem.
78
+
79
+ Teste cancelando **cada** form auxiliar isoladamente e depois feche o sistema. O caminho de sucesso nunca
80
+ mostra o vazamento.
@@ -0,0 +1,58 @@
1
+ ---
2
+ descricao: "Form novo herda da classe-base do projeto; grade com coluna de seleção e filtro \"todos\" seguem o padrão da casa"
3
+ paths:
4
+ - "**/*.pas"
5
+ - "**/*.dfm"
6
+ - "**/*.dpr"
7
+ - "**/*.inc"
8
+ ---
9
+
10
+ # Regra (camada de UI): form novo herda da classe-base do projeto e grade de seleção segue o padrão da casa
11
+
12
+ Aplica-se a toda tela nova ou alterada num projeto VCL que tem classe-base de forms (cadastro, consulta,
13
+ movimentação, relatório).
14
+
15
+ ## Descubra a classe-base antes de criar o form
16
+
17
+ Não suponha. Veja de onde as telas do projeto herdam e onde a base mora (muitas vezes numa biblioteca comum,
18
+ fora da pasta do sistema e somente leitura):
19
+
20
+ ```bash
21
+ # classes de que os forms do projeto herdam, da mais usada para a menos usada
22
+ grep -rhoiE "^\s*T\w+\s*=\s*class\s*\(T\w+\)" --include="*.pas" . | sed -E 's/.*\((T\w+)\).*/\1/' | sort | uniq -c | sort -rn | head
23
+ # .dfm que já nascem herdados
24
+ grep -rlE "^inherited " --include="*.dfm" . | head
25
+ ```
26
+
27
+ Se o projeto tem base, o form novo herda dela — `TFormBase`, `TFormBaseCadastro`, `TFormBaseRelatorio`, conforme o
28
+ tipo de tela —, nunca direto de `TForm`. Na dúvida entre duas bases, siga a tela existente mais parecida com a nova.
29
+
30
+ - O `.dfm` começa com `inherited`, não com `object`.
31
+ - Os eventos que a base já implementa (`FormCreate`, `FormShow`, `FormKeyDown`, `OnDrawColumnCell`) chamam
32
+ `inherited`.
33
+ - A base costuma tratar ENTER como TAB, fonte e negrito dos botões, ordenação pelo título da grade e zebrado.
34
+ Tela que herda de `TForm` perde esse comportamento sem nenhum erro de compilação.
35
+
36
+ ## Grade com coluna de seleção
37
+
38
+ - A coluna de seleção é a **última** da grade.
39
+ - Marca e desmarca com **barra de espaço** ou **duplo clique** na linha. Clique simples e ENTER não marcam.
40
+ - Se a base já pinta a grade zebrada, não repita o zebrado no form.
41
+ - Só implemente o `OnDrawColumnCell` no próprio form quando a grade tiver pintura personalizada, como linha marcada
42
+ ou linha bloqueada em outra cor. Nesse caso, nas linhas sem cor própria, reproduza o padrão da base (a mesma cor e
43
+ a mesma condição, por exemplo `RecNo` par fora de `gdSelected`) e termine com `DefaultDrawColumnCell`.
44
+ - Coluna calculada no SQL (`CASE`, `||`, `COALESCE` de texto) vira `text` no PostgreSQL, e o FireDAC a mostra como
45
+ `(WIDEMEMO)` na grade. Faça `CAST(... AS varchar(n))` na coluna calculada.
46
+ - Se a base aplica negrito em todo `TButton`/`TBitBtn`, o caption dos botões precisa caber **em negrito**: confira
47
+ a largura no form aberto, não no designer da tela sem herança.
48
+
49
+ ## Filtro "todos"
50
+
51
+ Campo de código usado como filtro, quando vazio, significa "todos". Siga a convenção que o projeto já usa nas outras
52
+ telas de filtro, por exemplo:
53
+
54
+ - código vazio vira zeros no `OnExit` (`'000000'` significa todos);
55
+ - o nome ao lado mostra um texto fixo como `* TODOS OS CLIENTES *`;
56
+ - o SQL só aplica o filtro quando o código é maior que zero.
57
+
58
+ Procure uma tela de filtro existente e repita o mesmo comportamento, em vez de inventar outro.
@@ -0,0 +1,131 @@
1
+ ---
2
+ paths:
3
+ - "**/*.pas"
4
+ - "**/*.dpr"
5
+ - "**/*.dpk"
6
+ - "**/*.inc"
7
+ - "**/*.dfm"
8
+ ---
9
+
10
+ # Threads e timers
11
+
12
+ ## `TTimer` não pode reentrar
13
+
14
+ O `OnTimer` roda na thread principal a partir da mensagem `WM_TIMER`. Um handler longo que não bombeia mensagens
15
+ não reentra (o próximo disparo só é tratado depois que ele termina), mas basta o handler bombear mensagens
16
+ (`Application.ProcessMessages`, diálogo modal, `ShowMessage`, rotina de terceiro que faz isso por dentro) para o
17
+ evento disparar de novo antes de terminar. Como é difícil garantir que nada no caminho bombeia mensagens, desligue o
18
+ timer durante o processamento e proteja com uma flag; religue no `finally`, senão uma exceção deixa o timer parado
19
+ para sempre.
20
+
21
+ Errado:
22
+
23
+ ```pascal
24
+ procedure TFrmMonitor.TmrSincronizarTimer(Sender: TObject);
25
+ begin
26
+ SincronizarPedidos; // pode rodar duas vezes ao mesmo tempo
27
+ end;
28
+ ```
29
+
30
+ Certo:
31
+
32
+ ```pascal
33
+ procedure TFrmMonitor.TmrSincronizarTimer(Sender: TObject);
34
+ begin
35
+ if FProcessando then
36
+ Exit;
37
+ FProcessando := True;
38
+ TmrSincronizar.Enabled := False;
39
+ try
40
+ SincronizarPedidos;
41
+ finally
42
+ FProcessando := False;
43
+ TmrSincronizar.Enabled := True;
44
+ end;
45
+ end;
46
+ ```
47
+
48
+ ## VCL só na thread principal
49
+
50
+ Componente visual (form, label, grid, dataset ligado a tela) não é thread-safe. Código em `TThread` ou `TTask` que
51
+ precisa tocar a tela passa por `TThread.Synchronize` ou `TThread.Queue`:
52
+
53
+ - `Synchronize` bloqueia a thread de fundo até a thread principal executar o bloco: use quando precisa do
54
+ resultado antes de continuar.
55
+ - `Queue` enfileira e segue sem esperar: use para progresso e notificação. Variável local capturada pela closure é
56
+ segura (a captura vive num frame no heap, contado por referência, como `LTotal` abaixo). O perigo é a thread
57
+ terminar antes de o bloco rodar: campo de um `TThread` com `FreeOnTerminate := True` ou objeto que a thread libera
58
+ ao sair já não existe quando o bloco executa. Copie o valor para uma variável local antes do `Queue`.
59
+
60
+ ```pascal
61
+ TTask.Run(
62
+ procedure
63
+ var
64
+ LTotal: Integer;
65
+ begin
66
+ LTotal := ImportarArquivo(LCaminho);
67
+ TThread.Queue(nil,
68
+ procedure
69
+ begin
70
+ LblStatus.Caption := Format('%d registros importados', [LTotal]);
71
+ end);
72
+ end);
73
+ ```
74
+
75
+ ## Conexão FireDAC própria por thread
76
+
77
+ `TFDConnection` e as queries ligadas a ela não podem ser usadas por duas threads ao mesmo tempo. A thread de fundo
78
+ cria a própria conexão (de preferência por uma connection definition com pooling) e a libera no fim; nunca usa a
79
+ conexão do DataModule da tela.
80
+
81
+ A conexão criada na thread não executa o `AfterConnect` do DataModule, então perde a inicialização de sessão que
82
+ ele faz (por exemplo `SET SESSION DateStyle TO 'ISO, DMY'` no PostgreSQL). Replique essa inicialização na conexão da
83
+ thread, com um `AfterConnect` próprio ou pelos parâmetros da connection definition. Detalhes nas rules
84
+ `dados/firedac.md` e `dados/datestyle-sessao-firedac-postgres.md` deste perfil.
85
+
86
+ ```pascal
87
+ procedure TImportador.Execute;
88
+ var
89
+ LConexao: TFDConnection;
90
+ begin
91
+ LConexao := TFDConnection.Create(nil);
92
+ try
93
+ LConexao.ConnectionDefName := 'Principal';
94
+ LConexao.Connected := True;
95
+ InicializarSessao(LConexao); // o mesmo que o AfterConnect do DataModule faz
96
+ GravarLote(LConexao);
97
+ finally
98
+ LConexao.Free;
99
+ end;
100
+ end;
101
+ ```
102
+
103
+ Estado compartilhado entre threads (lista, contador, cache) fica atrás de `TCriticalSection` (ou `TMonitor`), com
104
+ `Enter` seguido de `try ... finally Leave`.
105
+
106
+ ## `TTask` não captura variável de laço
107
+
108
+ A closure captura a **variável**, não o valor: quando a task roda, o laço já mudou a variável e todas as tasks
109
+ podem ver o último valor. Passe o valor por uma função que cria a closure com um parâmetro próprio.
110
+
111
+ Errado:
112
+
113
+ ```pascal
114
+ for LId in LIds do
115
+ TTask.Run(procedure begin ProcessarId(LId); end);
116
+ ```
117
+
118
+ Certo:
119
+
120
+ ```pascal
121
+ function TProcessador.CriarTarefa(const AId: Integer): TProc;
122
+ begin
123
+ Result := procedure begin ProcessarId(AId); end;
124
+ end;
125
+
126
+ for LId in LIds do
127
+ TTask.Run(CriarTarefa(LId));
128
+ ```
129
+
130
+ Copiar para uma variável local declarada fora do laço não resolve: ela também é única e é capturada pela
131
+ referência. O parâmetro de `CriarTarefa` é uma variável nova a cada chamada.
@@ -0,0 +1,109 @@
1
+ ---
2
+ paths:
3
+ - "**/*.pas"
4
+ - "**/*.dpr"
5
+ - "**/*.dpk"
6
+ - "**/*.inc"
7
+ - "**/*.dfm"
8
+ ---
9
+
10
+ # `try/finally` e vazamento de memória
11
+
12
+ ## `Create` e, na linha seguinte, `try`
13
+
14
+ Objeto criado sem dono é liberado num `finally` que começa logo depois do `Create`. Nada entre os dois: se uma
15
+ linha no meio levantar exceção, o objeto vaza. E o `Create` fica fora do `try`: se o construtor falhar, a variável
16
+ não foi atribuída e o `Free` no `finally` operaria sobre lixo.
17
+
18
+ Errado:
19
+
20
+ ```pascal
21
+ LLista := TStringList.Create;
22
+ LLista.LoadFromFile(ACaminho); // exceção aqui vaza LLista
23
+ try
24
+ Processar(LLista);
25
+ finally
26
+ LLista.Free;
27
+ end;
28
+ ```
29
+
30
+ Certo:
31
+
32
+ ```pascal
33
+ LLista := TStringList.Create;
34
+ try
35
+ LLista.LoadFromFile(ACaminho);
36
+ Processar(LLista);
37
+ finally
38
+ LLista.Free;
39
+ end;
40
+ ```
41
+
42
+ Dois objetos: inicialize o segundo com `nil` antes do `try` e libere os dois no mesmo `finally` (`Free` em `nil`
43
+ não faz nada), ou aninhe um `try/finally` por objeto.
44
+
45
+ ```pascal
46
+ LOrigem := nil;
47
+ LDestino := TStringList.Create;
48
+ try
49
+ LOrigem := TStringList.Create;
50
+ LOrigem.LoadFromFile(ACaminho);
51
+ LDestino.Assign(LOrigem);
52
+ finally
53
+ LOrigem.Free;
54
+ LDestino.Free;
55
+ end;
56
+ ```
57
+
58
+ ## `FreeAndNil` em campo e variável que sobrevive
59
+
60
+ Campo de classe, variável global ou variável que ainda é testada depois (`if Assigned(...)`) é liberada com
61
+ `FreeAndNil`: o `Free` sozinho deixa o ponteiro apontando para memória liberada, e o `Assigned` seguinte responde
62
+ `True`. Variável local que morre no `finally` pode usar `Free`.
63
+
64
+ ```pascal
65
+ destructor TGerenciador.Destroy;
66
+ begin
67
+ FreeAndNil(FCache);
68
+ inherited;
69
+ end;
70
+ ```
71
+
72
+ ## Dono do objeto (Owner)
73
+
74
+ Componente criado com dono (`TFDQuery.Create(Self)`, `TForm.Create(Application)`) é liberado pelo dono quando o
75
+ dono é destruído. Isso não é liberação no fim do uso:
76
+
77
+ - objeto criado com dono dentro de um método chamado muitas vezes acumula até o form fechar; para uso local, crie
78
+ com `nil` e libere no `finally`;
79
+ - liberar antes um componente com dono é seguro com `Free`/`FreeAndNil`, que o tiram da lista do dono; o que não
80
+ pode é guardar a referência e usá-la depois que o dono foi destruído;
81
+ - objeto sem dono que fica num campo é liberado no `destructor` da classe que o criou.
82
+
83
+ Form criado em tempo de execução para uso modal é criado e liberado no mesmo método:
84
+
85
+ ```pascal
86
+ LForm := TFrmBuscaCliente.Create(nil);
87
+ try
88
+ if LForm.ShowModal = mrOk then
89
+ SelecionarCliente(LForm.ClienteId);
90
+ finally
91
+ LForm.Free;
92
+ end;
93
+ ```
94
+
95
+ ## `ReportMemoryLeaksOnShutdown` em DEBUG
96
+
97
+ Ligue o relatório de vazamento no `.dpr`, só no build de depuração, para o vazamento aparecer ao fechar a
98
+ aplicação durante o teste do usuário:
99
+
100
+ ```pascal
101
+ begin
102
+ {$IFDEF DEBUG}
103
+ ReportMemoryLeaksOnShutdown := True;
104
+ {$ENDIF}
105
+ Application.Initialize;
106
+ ```
107
+
108
+ Fora do `{$IFDEF DEBUG}` a mensagem aparece para o usuário final. Vazamento relatado ao fechar é defeito a
109
+ corrigir, não ruído: siga a classe listada até o `Create` sem `Free` correspondente.
@@ -0,0 +1,70 @@
1
+ ---
2
+ name: conhecimento-delphi
3
+ description: "Base de armadilhas Delphi consultada sob demanda. Use quando aparecer erro de compilação estranho (F1026 File not found 'true.dpr', E2356 Property accessor must be an instance field, E2003 em Delphi 13, E1026/E2606 de .dres, MSB6003/MSB6002 command line too long), .dproj que o IDE não abre (ProjectGuid inválido), unit que não aparece no Project Manager, driver FireDAC não encontrado (Object factory is missing, -314 Cannot load vendor library), log/Writeln que não aparece em saída redirecionada, acento quebrado ou valor zerado ao converter número (StrToFloat, vírgula/ponto), Horse com Swagger (gbswagger) e JWT dando 401 ou rota sumindo, integração ACBr NFC-e, recurso RCDATA não encontrado, componente criado em runtime em vez do designer, migração para Delphi 13 ou build por .bat com log no Windows."
4
+ ---
5
+
6
+ # Conhecimento Delphi
7
+
8
+ Coleção de armadilhas reais de Delphi, cada uma no formato **sintoma → causa → correção → exemplo**. Não fica
9
+ carregada no contexto: leia só o artigo que casa com o problema relatado.
10
+
11
+ ## Como usar
12
+
13
+ 1. Compare o que o usuário relatou (mensagem de erro, código do erro, comportamento) com o índice abaixo.
14
+ 2. Leia o artigo correspondente em `references/` e aplique a correção ao código do projeto.
15
+ 3. Se nenhum artigo casar, siga a investigação normal; não force um artigo que não explica o sintoma.
16
+
17
+ Encoding/BOM, `try/finally` e threads não estão aqui: são regras do perfil, já carregadas ao editar fonte Delphi.
18
+
19
+ ## Índice
20
+
21
+ ### Projeto, `.dproj` e `.dpr`
22
+
23
+ - `references/dproj-dcc-debuginformation-nao-booleano.md` — `F1026 File not found: 'true.dpr'`: `DCC_DebugInformation`
24
+ é enum numérico, não booleano.
25
+ - `references/dproj-projectguid-valido.md` — IDE recusa abrir o projeto: "is not a valid GUID value" no `ProjectGuid`.
26
+ - `references/dpr-uses-project-manager.md` — unit não aparece no Project Manager ou o Designer diz "No form found".
27
+ - `references/msb6003-command-line-too-long.md` — `MSB6003`/`MSB6002`: linha de comando do compilador longa demais.
28
+ - `references/recursos-rcdata.md` — embutir arquivos como RCDATA; `E1026 ... .dres`, `E2606 Duplicate resource`,
29
+ "Resource not found".
30
+ - `references/build-via-bat-com-log.md` — para quem compila no Windows/VM: `build.bat` que grava log e devolve o
31
+ código certo.
32
+
33
+ ### Linguagem e compilação
34
+
35
+ - `references/class-var-vaza-para-campos-de-instancia.md` — `E2356 Property accessor must be an instance field or
36
+ method`: `class var` contamina os campos seguintes.
37
+ - `references/delphi13-breaking-changes.md` — migração para Delphi 13: `E2003 Undeclared identifier: 'Interval'`
38
+ em `AniCalculations`.
39
+ - `references/conversao-numerica-locale.md` — `StrToFloat`/`StrToCurr` devolvendo 0 ou exceção por causa da
40
+ vírgula/ponto do locale.
41
+ - `references/componentes-designer-vs-runtime.md` — controle fixo criado em `FormCreate` que não aparece no
42
+ Designer.
43
+
44
+ ### Dados (FireDAC)
45
+
46
+ - `references/firedac-registro-drivers.md` — "Object factory for class ... is missing", driver FireDAC não
47
+ encontrado, SQLite `-314` no mobile.
48
+
49
+ ### Servidor e console
50
+
51
+ - `references/console-writeln-sem-flush-nao-loga.md` — log/`Writeln` que não aparece em saída redirecionada e some
52
+ quando o processo é morto.
53
+ - `references/horse-gbswagger-rotas-jwt.md` — Horse + gbswagger + JWT: rota que muda ou some, 401 no Swagger,
54
+ `W1074 Unknown custom attribute`.
55
+
56
+ ### Bibliotecas Fontdata
57
+
58
+ - `references/bibliotecas-fontdata.md` — catálogo do que as units `Fontdata.*` do search path declaram, antes de
59
+ criar helper ou utilitário. É gerado no projeto por `npx @fontdata/ai-harness delphi catalogo` e não vem no
60
+ pacote: se faltar, rode o comando.
61
+
62
+ ### Fiscal
63
+
64
+ - `references/acbr-nfce-integracao.md` — ACBr NFC-e: units, SSL em simulação, `IdCSC`, chave de 44 dígitos,
65
+ `ForceDirectories`.
66
+
67
+ ## Origem e licença
68
+
69
+ Os artigos são adaptações do plugin `delphi-dev` (licença MIT). Aviso de copyright e texto da licença em
70
+ `references/ATRIBUICAO.md`.
@@ -0,0 +1,29 @@
1
+ # Atribuição
2
+
3
+ Os artigos desta pasta são adaptações (tradução, reorganização e cortes) de artigos do plugin **delphi-dev**,
4
+ disponível em https://github.com/adrianosantostreina/delphi-dev (commit `e5ed42ad1828b3d55ee87e7c6d2dad935391648e`),
5
+ distribuído sob a licença MIT reproduzida abaixo.
6
+
7
+ ---
8
+
9
+ MIT License
10
+
11
+ Copyright (c) 2026 Adriano Santos
12
+
13
+ Permission is hereby granted, free of charge, to any person obtaining a copy
14
+ of this software and associated documentation files (the "Software"), to deal
15
+ in the Software without restriction, including without limitation the rights
16
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
17
+ copies of the Software, and to permit persons to whom the Software is
18
+ furnished to do so, subject to the following conditions:
19
+
20
+ The above copyright notice and this permission notice shall be included in all
21
+ copies or substantial portions of the Software.
22
+
23
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
24
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
25
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
26
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
27
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
28
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
29
+ SOFTWARE.
@@ -0,0 +1,60 @@
1
+ # ACBr NFC-e: integração e armadilhas
2
+
3
+ Observado com ACBr Trunk2 (DCUs pré-compilados) e Delphi 12, usando `TACBrNFe` no modelo 65. Confira na versão do
4
+ ACBr do projeto antes de aplicar: a superfície muda entre revisões.
5
+
6
+ ## Sintoma e causa
7
+
8
+ | Sintoma | Causa | Correção |
9
+ |---|---|---|
10
+ | `E2003` em enum de NF-e (`moNFCe`, `ve400`, `fpDinheiro`, `csosn102`) | unit errada no `uses` | enums em `pcnConversaoNFe`; aliases legados (`taHomologacao`, `tnSaida`) em `pcnConversao`; tipos SSL em `ACBrDFeSSL`; componente em `ACBrNFe` |
11
+ | SSL configurado com valor errado ou exceção estranha | cast inteiro (`TSSLLib(4)`) com ordinal do DCU diferente do fonte | usar constantes nomeadas |
12
+ | `Configuracoes.Arquivos.PathPDF` não existe | o caminho do PDF pertence ao DANFE | `DANFE.PathPDF`, conferindo `Assigned(DANFE)` (pode ser nil em servidor) |
13
+ | incompatibilidade de tipo em `IdCSC` | `IdCSC` é `string` | `IdCSC := '000001'` |
14
+ | chave com 47 caracteres | `infNFe.ID` vem com o prefixo `NFe` | `Copy(ID, 4, 44)` |
15
+ | `EInOutError: Unable to create directory` | `ForceDirectories` com caminho relativo chama `ForceDirectories('')` | montar caminho absoluto |
16
+ | `ExtractFilePath(ParamStr(0))` vazio | executável chamado sem caminho completo | cair para `GetCurrentDir` |
17
+
18
+ ## Exemplo
19
+
20
+ SSL em simulação (sem transmissão) e em produção:
21
+
22
+ ```pascal
23
+ ACBrNFe.Configuracoes.Geral.SSLLib := libNone;
24
+ ACBrNFe.Configuracoes.Geral.SSLCryptLib := cryNone;
25
+ ACBrNFe.Configuracoes.Geral.SSLHttpLib := httpNone;
26
+ ACBrNFe.Configuracoes.Geral.SSLXmlSignLib := xsNone;
27
+ // produção: libOpenSSL, cryOpenSSL, httpOpenSSL, xsLibXml2
28
+ ```
29
+
30
+ Configuração mínima de NFC-e 4.00:
31
+
32
+ ```pascal
33
+ ACBrNFe.Configuracoes.Geral.ModeloDF := moNFCe;
34
+ ACBrNFe.Configuracoes.Geral.VersaoDF := ve400;
35
+ ACBrNFe.Configuracoes.Geral.VersaoQRCode := veqr200;
36
+ ACBrNFe.Configuracoes.Geral.IdCSC := '000001';
37
+ ACBrNFe.Configuracoes.Geral.CSC := LCsc;
38
+ ACBrNFe.Configuracoes.WebServices.Ambiente := taHomologacao;
39
+ ACBrNFe.Configuracoes.WebServices.UF := LUf;
40
+ ```
41
+
42
+ Chave de 44 dígitos depois de `GerarNFe`:
43
+
44
+ ```pascal
45
+ LChave := Copy(ACBrNFe.NotasFiscais.Items[0].NFe.infNFe.ID, 4, 44);
46
+ ```
47
+
48
+ Pasta de XML com caminho absoluto:
49
+
50
+ ```pascal
51
+ LPastaXml := ExtractFilePath(ParamStr(0));
52
+ if LPastaXml.IsEmpty then
53
+ LPastaXml := GetCurrentDir;
54
+ LPastaXml := IncludeTrailingPathDelimiter(LPastaXml) + 'xml';
55
+ ForceDirectories(LPastaXml);
56
+ ```
57
+
58
+ Forma de pagamento: PIX é `fpPagamentoInstantaneo` (código SEFAZ `17`). Em simulação sem certificado válido,
59
+ `NotasFiscais.Assinar` falha, mas o XML gerado por `GerarNFe` continua íntegro; trate a falha da assinatura como
60
+ aviso só nesse modo, nunca em produção.
@@ -0,0 +1,86 @@
1
+ # Build por `.bat` com log (para quem compila no Windows/VM)
2
+
3
+ **Este artigo é para o desenvolvedor que compila no Windows ou na VM, não para o agente.** O agente não compila: a
4
+ regra de build do perfil vale. O artigo serve para montar ou corrigir o `build.bat` do projeto e para ler o log que o
5
+ desenvolvedor devolver.
6
+
7
+ ## Sintoma
8
+
9
+ - A saída do msbuild/`dcc32` chega cortada, com acento quebrado ou nem chega quando o build é chamado de outro shell
10
+ (MSYS, PowerShell).
11
+ - `cd` antes do `cmd.exe /c` não vale: o `cmd.exe` filho não herda a pasta corrente.
12
+ - O `.bat` diz "BUILD OK", mas o log tem `error E2010`.
13
+ - DUnitX falha com `ECommandLineError: Option [exit] expected a following :value but none was found`.
14
+
15
+ ## Causa
16
+
17
+ - `2>&1` no shell externo nem sempre captura tudo, o compilador escreve em CP1252 e o buffer do PowerShell corta
18
+ linhas longas.
19
+ - `%ERRORLEVEL%` reflete o **último** comando: um `type "%LOG%"` antes do `exit /b %ERRORLEVEL%` devolve o código do
20
+ `type` (0) e mascara a falha.
21
+ - DUnitX exige `chave:valor`; a opção é `--exitbehavior:Continue`, não `--exit`.
22
+
23
+ ## Correção
24
+
25
+ - O `.bat` redireciona toda a saída para um arquivo ao lado dele (`%~dp0build_log.txt`) e guarda o código do msbuild
26
+ numa variável **logo depois** do msbuild.
27
+ - Conferir o resultado pelo conteúdo do log (`error E`, `error F`, `Fatal`), não só pelo código de saída.
28
+ - `build_log.txt` e `test_log.txt` no `.claudeignore` e no `.gitignore`.
29
+ - Pergunte antes de fixar a versão no `.bat` se houver mais de uma pasta em `Studio\<N>.0\`, plataforma diferente de
30
+ Win32/Win64, configurações além de Debug/Release ou Community Edition (outro caminho de instalação).
31
+
32
+ | Pasta | Versão |
33
+ |---|---|
34
+ | `Studio\21.0` | Delphi 10.4 Sydney |
35
+ | `Studio\22.0` | Delphi 11 Alexandria |
36
+ | `Studio\23.0` | Delphi 12 Athens |
37
+ | `Studio\37.0` | Delphi 13 |
38
+
39
+ ## Exemplo
40
+
41
+ ```bat
42
+ @echo off
43
+ setlocal
44
+ set CONFIG=%1
45
+ if "%CONFIG%"=="" set CONFIG=Debug
46
+ set PLAT=%2
47
+ if "%PLAT%"=="" set PLAT=Win32
48
+
49
+ set RSVARS=C:\Program Files (x86)\Embarcadero\Studio\37.0\bin\rsvars.bat
50
+ if not exist "%RSVARS%" (
51
+ echo [build.bat] rsvars.bat nao encontrado em "%RSVARS%"
52
+ exit /b 2
53
+ )
54
+ call "%RSVARS%"
55
+
56
+ set LOG=%~dp0build_log.txt
57
+ msbuild "%~dp0SeuProjeto.dproj" /t:Build /p:Config=%CONFIG% /p:Platform=%PLAT% /nologo /v:minimal /clp:NoSummary > "%LOG%" 2>&1
58
+ set ERR=%ERRORLEVEL%
59
+
60
+ type "%LOG%"
61
+ if %ERR% EQU 0 (echo === BUILD OK %PLAT%\%CONFIG% ===) else (echo === BUILD FALHOU codigo %ERR% ===)
62
+ exit /b %ERR%
63
+ ```
64
+
65
+ Chamada a partir de outro shell, sempre com caminho absoluto entre aspas:
66
+
67
+ ```bash
68
+ cmd.exe /c '"C:\caminho\do\projeto\build.bat" 2>&1'
69
+ ```
70
+
71
+ ```powershell
72
+ & cmd.exe /c '"C:\caminho\do\projeto\build.bat" 2>&1'
73
+ ```
74
+
75
+ ## Erros de compilação que se resolvem com uma unit no `uses`
76
+
77
+ | Identificador | Unit |
78
+ |---|---|
79
+ | `TColor`, `TBitmap`, `TFont`, `TCanvas` | `Vcl.Graphics` (VCL) ou `FMX.Graphics` (FMX) |
80
+ | `TList<>`, `TObjectList<>`, `TDictionary<>` | `System.Generics.Collections` |
81
+ | `Format`, `IntToStr`, `Trim`, `FreeAndNil` | `System.SysUtils` |
82
+ | `IncDay`, `DaysBetween` | `System.DateUtils` |
83
+ | `TStringList`, `TStringStream` | `System.Classes` |
84
+ | `RGB`, `MessageBox`, `LoadCursor` | `Winapi.Windows` |
85
+
86
+ Linha de comando longa demais (`MSB6003`): `msb6003-command-line-too-long.md`.