@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,67 @@
1
+ # Recursos embutidos no executável (RCDATA / `.dres`)
2
+
3
+ Vale para VCL e FMX, em todas as plataformas. Serve para embutir SVG, JSON, imagens, templates e scripts e lê-los em
4
+ runtime com `TResourceStream`.
5
+
6
+ ## Sintoma
7
+
8
+ - `[DCC Error] E1026 File not found: 'MeuProjeto.dres'`
9
+ - `[DCC Error] E2606 Duplicate resource: type RCDATA ID <nome>`
10
+ - `Resource <id> not found` em runtime
11
+
12
+ ## Causa
13
+
14
+ | Erro | Causa |
15
+ |---|---|
16
+ | `E1026 ... .dres` | `{$R *.dres}` no `.dpr`, mas nenhum recurso cadastrado: sem recurso, o IDE não gera o `.dres`. Ou um `.rc` manual gerou o `.dres` com outro nome. |
17
+ | `E2606 Duplicate resource` | `{$R *.dres}` repetido no `.dpr`, ou o mesmo recurso cadastrado pelo diálogo e também num `.rc` manual. |
18
+ | `Resource not found` | tipo diferente de `RCDATA` (algumas versões sugerem `RC_DATA`), identificador com erro de digitação, ou binário compilado antes de cadastrar o recurso (faça **Build**, não só Compile). |
19
+
20
+ ## Correção
21
+
22
+ Usar o mecanismo oficial, **Project → Resources and Images...**:
23
+
24
+ 1. **Add...** e escolher o arquivo;
25
+ 2. **Resource identifier**: o nome usado no código (padronize em minúsculas, ex.: `svg_email`);
26
+ 3. **Resource type**: digitar `RCDATA` (sem underscore);
27
+ 4. **OK** grava `<Resource>` no `.dproj`; o build gera `<Projeto>.dres`, que não se edita à mão;
28
+ 5. no `.dpr`, uma única `{$R *.dres}`, ao lado de `{$R *.res}` (as duas coexistem: `.dres` é multiplataforma, `.res`
29
+ traz ícone e version info do Windows).
30
+
31
+ Evite `.rc` manual: o nome do `.dres` gerado muda entre versões do IDE. Se o projeto tem um `.rc` antigo e também
32
+ `<Resource>` no `.dproj`, o que vale é o `.dproj`; tire o `.rc` do Project Manager para não duplicar.
33
+
34
+ ## Exemplo
35
+
36
+ ```xml
37
+ <ItemGroup>
38
+ <Resource Include="imagens\svg\email.svg">
39
+ <ResourceType>RCDATA</ResourceType>
40
+ <ResourceId>svg_email</ResourceId>
41
+ </Resource>
42
+ </ItemGroup>
43
+ ```
44
+
45
+ ```pascal
46
+ function LerRecursoComoString(const ANome: string): string;
47
+ var
48
+ LRecurso: TResourceStream;
49
+ LTexto: TStringStream;
50
+ begin
51
+ LRecurso := TResourceStream.Create(HInstance, ANome, RT_RCDATA);
52
+ try
53
+ LTexto := TStringStream.Create('', TEncoding.UTF8);
54
+ try
55
+ LTexto.CopyFrom(LRecurso, 0);
56
+ Result := LTexto.DataString;
57
+ finally
58
+ LTexto.Free;
59
+ end;
60
+ finally
61
+ LRecurso.Free;
62
+ end;
63
+ end;
64
+ ```
65
+
66
+ O segundo parâmetro é o identificador cadastrado; o terceiro, `RT_RCDATA` (`Winapi.Windows` na VCL; também funciona
67
+ em FMX mobile).
@@ -0,0 +1,61 @@
1
+ ---
2
+ descricao: "Campo novo do ACBr exige preenchimento explícito: a tag sai zerada, não ausente"
3
+ paths:
4
+ - "**/*.pas"
5
+ - "**/*.dfm"
6
+ - "**/*.inc"
7
+ ---
8
+
9
+ # Regra (camada fiscal): campo novo do ACBr exige preenchimento explícito
10
+
11
+ Aplica-se a toda montagem de documento fiscal eletrônico via ACBr (NF-e, NFC-e, CT-e, MDF-e, NFS-e) ao adotar um
12
+ layout novo ou atualizado (ex.: reforma tributária, `VersaoDF >= ve400`). Complementa
13
+ `total-tributo-acbr-soma-itens.md`.
14
+
15
+ ## Um campo novo exposto pelo ACBr não é preenchido sozinho
16
+
17
+ Quando o ACBr passa a suportar um layout novo, ele expõe **novas propriedades** no objeto do componente (ex.:
18
+ `Imp.vTotDFe` no CT-e) e o **XmlWriter passa a emitir a tag correspondente sempre** que a versão do layout exige
19
+ (`VersaoDF >= ve400`), **mesmo que o sistema nunca tenha atribuído aquela propriedade**. A tag sai no XML com o
20
+ **valor default (zerado)**, não fica ausente, e a SEFAZ rejeita o documento como campo obrigatório não preenchido
21
+ (ex.: rejeição 360, "Total do DFe de preenchimento obrigatório").
22
+
23
+ O sintoma engana: o XML **tem** a tag, então parece que "o ACBr cuidou disso". O valor está zerado porque nenhuma
24
+ linha do sistema atribuiu a propriedade.
25
+
26
+ Errado (a propriedade nova nunca é atribuída):
27
+
28
+ ```pascal
29
+ with ACBrCTe1.Conhecimentos.Add.CTe do
30
+ begin
31
+ Imp.ICMS.SituTrib := cst00;
32
+ Imp.IBSCBS.vBC := LBaseIBSCBS;
33
+ end;
34
+ ```
35
+
36
+ Certo:
37
+
38
+ ```pascal
39
+ with ACBrCTe1.Conhecimentos.Add.CTe do
40
+ begin
41
+ Imp.ICMS.SituTrib := cst00;
42
+ Imp.IBSCBS.vBC := LBaseIBSCBS;
43
+ Imp.vTotDFe := LValorTotalDocumento;
44
+ end;
45
+ ```
46
+
47
+ ## Procedimento obrigatório ao adotar um layout novo do ACBr
48
+
49
+ - Ao subir a versão do layout (`VersaoDF`) ou habilitar um novo grupo de campos (ex.: IBS/CBS da reforma
50
+ tributária), **procure a(s) propriedade(s) nova(s)** na unit que monta o documento e confirme que **cada campo
51
+ obrigatório do novo layout** tem atribuição explícita. "A propriedade existe no componente" não implica "está
52
+ sendo preenchida".
53
+ - Ao investigar uma rejeição de "campo obrigatório não preenchido" depois de adotar um layout novo, **a primeira
54
+ hipótese é esta**: buscar a propriedade na unit de montagem e verificar se há atribuição
55
+ (`grep -n '<PropriedadeDoErro>' <unit>.pas`), antes de suspeitar de outra causa.
56
+ - **Cuidado ao definir o valor:** documentos com lista de itens (NF-e, NFC-e) usam a soma dos itens
57
+ (`total-tributo-acbr-soma-itens.md`); documentos sem lista de itens (CT-e) usam o valor total do próprio
58
+ documento. Confirme a semântica do campo para o tipo de documento antes de atribuir.
59
+
60
+ Um caso típico: `Imp.vTotDFe` do CT-e, campo novo da reforma tributária e irmão de `Imp.IBSCBS`, nunca é atribuído
61
+ na rotina que gera o CT-e, sai `<vTotDFe>0.00</vTotDFe>` no XML e a SEFAZ devolve a rejeição 360.
@@ -0,0 +1,51 @@
1
+ ---
2
+ descricao: "Retorno de evento da NF-e é classificado pelo cStat do evento, nunca pela exceção do ACBr"
3
+ paths:
4
+ - "**/*.pas"
5
+ - "**/*.inc"
6
+ ---
7
+
8
+ # Retorno de evento da NF-e pelo cStat
9
+
10
+ `EnviarEvento` só lança exceção quando o cStat do **lote** é diferente de 128. A rejeição do evento
11
+ (`retEvento[i].RetInfEvento.cStat`: 136, 577 a 579, 596, 650, 655…) volta sem exceção.
12
+
13
+ - Classifique todo cStat do evento no ramo sem exceção, com `retEvento.Count > 0`; não deixe o tratamento só no
14
+ `except`.
15
+ - Nunca grave status sem valor atribuído: todo cStat cai em um status conhecido, e o "demais" é rejeição.
16
+ - Rejeição vai para o log com documento, cStat e xMotivo, nunca com o `RetWS` cru.
17
+ - Nova tentativa (577 a 579, erro de horário da SEFAZ) é controlada por documento, nunca por flag global.
18
+
19
+ Errado:
20
+
21
+ ```pascal
22
+ try
23
+ ACBrNFe1.EnviarEvento(LIdLote);
24
+ GravarStatus(LChave, LStatus);
25
+ except
26
+ on E: Exception do
27
+ GravarStatus(LChave, stRejeitado);
28
+ end;
29
+ ```
30
+
31
+ Certo:
32
+
33
+ ```pascal
34
+ ACBrNFe1.EnviarEvento(LIdLote);
35
+ LRetorno := ACBrNFe1.WebServices.EnvEvento.EventoRetorno;
36
+ if LRetorno.retEvento.Count = 0 then
37
+ raise Exception.Create('Retorno de evento sem itens');
38
+ LInfEvento := LRetorno.retEvento[0].RetInfEvento;
39
+ case LInfEvento.cStat of
40
+ 135, 136:
41
+ GravarStatus(LChave, stRegistrado);
42
+ 577..579:
43
+ AgendarNovaTentativa(LChave);
44
+ else
45
+ GravarStatus(LChave, stRejeitado);
46
+ RegistrarLog(Format('%s: cStat %d - %s', [LChave, LInfEvento.cStat, LInfEvento.xMotivo]));
47
+ end;
48
+ ```
49
+
50
+ Por quê: tratar só o `except` grava status vazio quando o evento é rejeitado, prende quem aguarda o retorno e repete
51
+ o envio à SEFAZ.
@@ -0,0 +1,100 @@
1
+ ---
2
+ descricao: "Retorno de sucesso de webservice fiscal (ACBr) não prova que veio documento: ramificar pelo cStat"
3
+ paths:
4
+ - "**/*.pas"
5
+ - "**/*.dpr"
6
+ - "**/*.inc"
7
+ ---
8
+
9
+ # Regra: retorno de sucesso de webservice fiscal não prova que veio documento
10
+
11
+ Aplica-se a toda chamada a webservice fiscal via ACBr (`DistribuicaoDFe`, `Consultar`, `ConsultaCadastro`,
12
+ `DownloadNFe`, `Recibo`, `StatusServico`, eventos e afins) e a qualquer componente que traduza a resposta de um
13
+ serviço em `Boolean` ou em "não levantou exceção". Complementa a rule
14
+ `existencia-nunca-se-testa-por-campo-formatado.md` do perfil Delphi.
15
+
16
+ ## A regra
17
+
18
+ Antes de percorrer **qualquer** coleção de retorno, leia o **`cStat`** e ramifique por ele. O `Boolean` devolvido
19
+ pelo componente, ou a ausência de exceção, responde apenas "a conversa com a SEFAZ terminou bem". Nunca responde
20
+ "há documento para processar".
21
+
22
+ ## O que é proibido
23
+
24
+ ```pascal
25
+ // Errado: sem exceção não quer dizer que veio documento.
26
+ ACBrNFe1.DistribuicaoDFePorUltNSU(LUF, LCNPJ, LUltNSU);
27
+ for I := 0 to ACBrNFe1.WebServices.DistribuicaoDFe.retDistDFeInt.docZip.Count - 1 do
28
+ ProcessarDocumento(I);
29
+ ```
30
+
31
+ Com a resposta "nada encontrado", o laço não executa, nada é gravado e nenhuma mensagem aparece.
32
+
33
+ No ACBr, `TDistribuicaoDFe.TratarResposta` (`ACBrNFe/ACBrNFeWebServices.pas`) termina com:
34
+
35
+ ```pascal
36
+ Result := (FretDistDFeInt.CStat = 137) or (FretDistDFeInt.CStat = 138);
37
+ ```
38
+
39
+ O **137 é "Nenhum documento localizado para o interessado"** e entra como **sucesso**. O mesmo padrão vale para
40
+ os demais `TDFeWebService`: cada um tem sua lista de `cStat` aceitos, e essa lista inclui os "não encontrei". Só
41
+ o que está fora dela levanta exceção, via `GerarException`.
42
+
43
+ Certo:
44
+
45
+ ```pascal
46
+ ACBrNFe1.DistribuicaoDFePorUltNSU(LUF, LCNPJ, LUltNSU);
47
+ LRetorno := ACBrNFe1.WebServices.DistribuicaoDFe.retDistDFeInt;
48
+ case LRetorno.cStat of
49
+ 137:
50
+ InformarUsuario('Nenhum documento novo. Aguarde 1 hora para consultar de novo.');
51
+ 138:
52
+ ProcessarDocumentos(LRetorno);
53
+ else
54
+ InformarUsuario(Format('Rejeição %d: %s', [LRetorno.cStat, LRetorno.xMotivo]));
55
+ end;
56
+ ```
57
+
58
+ ## Corolário: resposta de "nada encontrado" não traz os campos de controle
59
+
60
+ Os campos de posição e controle são lidos direto do XML, **sem valor padrão**. Numa resposta 137,
61
+ `retDistDFeInt.ultNSU` e `maxNSU` ficam `''` (`ACBrDFe/Comum/ACBrDFeComum.RetDistDFeInt.pas`), e `''.ToInteger`
62
+ derruba o fluxo com uma mensagem que não diz nada ao usuário.
63
+
64
+ Todo campo de resposta que pode não vir usa `StrToIntDef(..., 0)`, nunca `.ToInteger` nem `StrToInt` sem default.
65
+
66
+ ## O pior erro: inventar a posição de leitura
67
+
68
+ Ao receber "nada encontrado", **não calcule** um ponto de partida para "tentar de novo mais perto":
69
+ `maxNSU - 500`, "últimos N dias", "a partir de ontem". O cursor só avança para onde o **serviço** disse que você
70
+ chegou.
71
+
72
+ Um cursor calculado é gravado, **não retrocede** e apaga em silêncio tudo que ficou para trás. O dano não aparece
73
+ no teste: aparece meses depois, no relatório do cliente, como documento que nunca chegou.
74
+
75
+ E quando a regra do serviço manda **esperar** depois do "nada encontrado" (a NT 2014.002 exige 1 hora depois do
76
+ `cStat 137`, sob pena da rejeição **656, Consumo Indevido**), insistir com `Sleep` entre as tentativas é o oposto
77
+ da correção: é o que **provoca** o bloqueio.
78
+
79
+ Um caso típico: a consulta de notas destinadas usa `DistribuicaoDFePorNSU` (`consNSU`) no NSU 0, um NSU que nunca
80
+ existe. A SEFAZ responde 137, o ACBr devolve sucesso e a rotina termina muda; o cliente fica sem receber DF-e
81
+ algum. "Correções" como `maxNSU - 1000`, depois `maxNSU - 500`, depois `Sleep(3000)` atacam o sintoma e ampliam a
82
+ perda de documentos, porque cada uma inventa a posição de leitura em vez de ler o `cStat`.
83
+
84
+ ## Por que isso escapa da revisão
85
+
86
+ Não há linha errada para apontar. O código lê como código correto: chama o serviço, não trata erro porque não
87
+ houve erro, percorre a coleção. O defeito está no **contrato** entre o componente e quem o consome.
88
+
89
+ E o sintoma é **ausência**: nada acontece, nada é gravado, nenhum log, nenhuma mensagem. O suporte recebe "o botão
90
+ não funciona" e devolve orientação de uso. O defeito sobrevive a anos de operação porque ninguém desconfia de uma
91
+ chamada que não dá erro.
92
+
93
+ ## Antes de fechar a alteração
94
+
95
+ - Para cada chamada a webservice fiscal: **onde está o teste do `cStat`?** Sem ele, o achado é bloqueante.
96
+ - Abra o `TratarResposta` do componente e **liste** quais `cStat` ele considera sucesso. Sempre há um "não
97
+ encontrei" na lista.
98
+ - **Todo** caminho de saída informa o usuário, inclusive "nada novo" e "aguarde N".
99
+ - `grep -n "\.ToInteger\|StrToInt(" <unit>.pas` nos campos do retorno: nenhum sem default.
100
+ - Teste com o caso **vazio**, não só com o caso cheio. O fluxo feliz não distingue os dois.
@@ -0,0 +1,63 @@
1
+ ---
2
+ descricao: "Total de tributo no ACBr é a soma dos itens, nunca base total vezes alíquota"
3
+ paths:
4
+ - "**/*.pas"
5
+ - "**/*.dfm"
6
+ - "**/*.inc"
7
+ ---
8
+
9
+ # Regra (camada fiscal): total de tributo no ACBr é a soma dos itens
10
+
11
+ Aplica-se a toda montagem de grupos de totais de tributo enviados ao ACBr em NF-e e NFC-e, em especial os tributos
12
+ IBS/CBS (`IBSCBSTot`: `gCBS.vCBS`, `gIBS.gIBSUFTot.vIBSUF`, `gIBS.gIBSMunTot.vIBSMun`).
13
+
14
+ ## Nunca montar o total como base total × alíquota: sempre a soma dos itens
15
+
16
+ O total de um tributo no XML é validado pela SEFAZ contra a **soma dos valores do mesmo tributo em cada item**
17
+ (`det/imposto/.../vXxx`). Calcular o total como `base_total × alíquota` (ou ler um campo de cabeçalho já calculado
18
+ assim) **diverge** da soma dos itens por arredondamento: cada item é `arredondado(base_item × alíquota)`, e a soma
19
+ desses não é igual ao total da base única. A diferença costuma ser de **1 centavo** (mas pode ser maior, e em
20
+ qualquer direção), e gera rejeições como:
21
+
22
+ - **1079**: Total de CBS difere da soma dos itens;
23
+ - **1080**: Total de IBS UF difere da soma dos itens;
24
+ - **1081**: Total de IBS Município difere da soma dos itens.
25
+
26
+ Errado (o total vem do cabeçalho, calculado sobre a base total):
27
+
28
+ ```pascal
29
+ IBSCBSTot.gIBS.gIBSUFTot.vIBSUF := LQuery.FieldByName('total_ibs_uf').AsFloat;
30
+ ```
31
+
32
+ Certo: acumular o valor **cheio** de cada item, no mesmo ponto em que o valor do item é definido e **antes** de
33
+ qualquer redução, e compor o total descontando explicitamente o que reduz o item no XML (diferimento, tributação
34
+ regular):
35
+
36
+ ```pascal
37
+ LSomaIBSUFItens := LSomaIBSUFItens + ArredondarValor(gIBSCBS.gIBSUF.vIBSUF, 2);
38
+ IBSCBSTot.gIBS.gIBSUFTot.vIBSUF := LSomaIBSUFItens - LIBSUFDiferido - LIBSUFTribRegular;
39
+ ```
40
+
41
+ A primeira linha fica no laço de itens; a segunda, na montagem do total. `ArredondarValor` é a função de
42
+ arredondamento do projeto, que precisa seguir a mesma regra de arredondamento do componente.
43
+
44
+ - **Mesmo princípio de `vPIS`/`vCOFINS`:** no `ICMSTot` eles já costumam ser montados como soma dos itens; IBS/CBS
45
+ seguem a mesma lógica.
46
+ - **Arredondar por item a 2 casas**, de forma independente do locale, com a mesma semântica de arredondamento que o
47
+ componente usa ao gravar o item, para que `total = Σ round(item)`. Vale também para valores intermediários como
48
+ o **`vDif` do diferimento** (`ArredondarValor(LValor * pDif / 100, 2)`), nunca a divisão crua.
49
+ - A soma captura o valor **cheio** (antes da redução do diferimento) quando o total subtrai o diferimento
50
+ explicitamente; itens de tributação regular entram com o valor cheio e saem pela parcela de tributação regular
51
+ subtraída do total.
52
+ - O erro só aparece **em runtime, na transmissão à SEFAZ**, em cenário de borda (alíquotas fracionárias, muitos
53
+ itens), nunca na compilação.
54
+
55
+ ## Vale também para `ICMSTot.vProd`
56
+
57
+ O `vProd` do total é validado contra a soma dos `det/prod/vProd` (rejeição 564). Ler o total de produtos gravado no
58
+ cabeçalho da venda ou da compra diverge por arredondamento, porque o cabeçalho arredonda uma vez e cada item
59
+ arredonda separadamente.
60
+
61
+ - Concilie o resíduo nos itens, nunca no total, porque `vNF` e `vPag` dependem dele.
62
+ - No item ajustado, `qCom × vUnCom` precisa ficar a até R$ 0,01 do `vProd` (rejeição 629), com `vUnCom` nas casas
63
+ decimais de venda do produto.
@@ -0,0 +1,155 @@
1
+ ---
2
+ name: diagnosticar-rejeicao-nfse
3
+ description: Diagnostica rejeição de NFS-e devolvida por prefeitura ou pelo ACBrNFSeX, classificando em cadastro do cliente, defeito de código ou limitação da prefeitura antes de qualquer alteração. Use quando aparecer um código ou mensagem de rejeição de NFS-e (E0014, E0177, E0840, X211, Cod004, "não implementado para este provedor", "Element ... is not expected", "já cancelada", "temporariamente indisponível"), quando a nota de serviço voltar rejeitada sem motivo claro, ou quando o DANFSE sair zerado ou incompleto. Não use para NF-e nem NFC-e.
4
+ ---
5
+
6
+ # Diagnosticar rejeição de NFS-e
7
+
8
+ A classe de defeito mais comum na NFS-e é sempre a mesma: layout Padrão Nacional, campo que some em silêncio,
9
+ prefeitura respondendo mensagem genérica. Este roteiro existe para não repetir a investigação do zero.
10
+
11
+ **Regra que ordena tudo:** classificar antes de corrigir. Boa parte das rejeições **não é defeito do sistema**, e
12
+ nenhuma alteração de código as resolve.
13
+
14
+ ## Passo 0: coletar (não pule)
15
+
16
+ Sem estes cinco dados o diagnóstico é chute:
17
+
18
+ | Dado | Onde encontrar |
19
+ |---|---|
20
+ | Código **e** texto integral da rejeição | log do servidor, XML de resposta gravado no banco |
21
+ | Município e código IBGE do prestador | cadastro da empresa; parâmetro de município de prestação |
22
+ | Ambiente (produção ou homologação) | configuração do componente `ACBrNFSeX` no sistema |
23
+ | Operação | emissão, cancelamento, consulta ou impressão |
24
+ | XML efetivamente enviado | XML gravado da nota, **não** o que se supõe ter sido enviado |
25
+
26
+ ## Passo 1: identificar provedor e layout
27
+
28
+ Abra `ACBrNFSeXServicos.ini` na seção do município e leia três coisas:
29
+
30
+ ```ini
31
+ [ISSNet]
32
+ Params=APIPropria:|ServicosPadraoNacional:ConsultarNFSePorChave,ConsultarEvento,ConsultarDFe,ConsultarParam,ObterDANFSE
33
+ ```
34
+
35
+ 1. `Provedor`: `proPadraoNacional`, `proISSNet`, `proBetha`, `proAgili`…
36
+ 2. `APIPropria`: presente significa provedor com API própria **sobre** o layout nacional.
37
+ 3. `ServicosPadraoNacional`: a lista de serviços que seguem a rota nacional.
38
+
39
+ O layout é o Padrão Nacional quando:
40
+
41
+ ```pascal
42
+ LLayoutNacional := (Configuracoes.Geral.Provedor = proPadraoNacional) or
43
+ Configuracoes.Geral.APIPropria;
44
+ ```
45
+
46
+ **Cuidado:** `APIPropria` decide o **formato do XML** e **quais serviços** seguem a rota nacional, nunca a rota
47
+ inteira, e nunca por analogia com outra rotina. Antes de aplicar essa condição a uma rotina, confirme o serviço na
48
+ lista `ServicosPadraoNacional`. `ConsultarDPSPorChave` **não** consta: por isso a consulta da NFS-e bifurca só por
49
+ `proPadraoNacional`, e isso está correto.
50
+
51
+ ## Passo 2: classificar a natureza
52
+
53
+ | Natureza | Sinal | O que fazer |
54
+ |---|---|---|
55
+ | **Cadastro do cliente** | A prefeitura recusa um valor que é válido no schema, mas não na parametrização municipal | Instruir a correção no cadastro do sistema. **Não mexer no código.** |
56
+ | **Defeito de código** | Tag ausente, valor no campo errado do layout, serviço chamado pela rota errada | Corrigir pelo fluxo normal |
57
+ | **Limitação da prefeitura** | Serviço declarado indisponível ou em construção pelo próprio município | Registrar como aviso nas notas de versão ou no canal de suporte. Não há conserto possível. |
58
+
59
+ ## Passo 3: consultar as rejeições já conhecidas
60
+
61
+ | Rejeição | Natureza | Conclusão |
62
+ |---|---|---|
63
+ | `E0014`: DPS já existe em NFS-e gerada anteriormente | Código | A nota **está autorizada** na prefeitura. Vai para a fila de consulta, nunca para rejeitada. Compare pelo **código**, não pelo texto |
64
+ | `E0177`: regime especial não admitido pelo município | **Cadastro** | Trocar o Regime Especial de Tributação do prestador para "Nenhum". Há municípios (ex.: Cuiabá) que não aceitam o `9 - Outros`, embora seja válido no schema |
65
+ | "Serviço Preparar Cancela NFSe não implementado para este provedor" | Código | No layout nacional o cancelamento é o evento **`e101101`** por `EnviarEvento` |
66
+ | "O grupo de informações relativo ao imóvel deve constar na DPS" | Código | `cIndOp` de bem imóvel (`020101`, `020201`, `020301`) exige o grupo `<imovel>` |
67
+ | "Element 'CEP': This element is not expected" | Código | O ISSNet exige o endereço do imóvel com **município junto do CEP**: o XSD dele diverge do nacional |
68
+ | `X211` genérico no cancelamento | Código | O ACBr não achou a lista de mensagens; ler de `WebService.EnviarEvento.Erros`, concatenando **todos** os itens |
69
+ | `Cod004` | Código | Chave da NFS-e vazia: o XML gravado ainda é o da DPS. Validar `NFSe.infNFSe.ID` antes de enviar |
70
+ | "NFS-e já cancelada" | Sucesso | Tratar como cancelamento bem-sucedido |
71
+ | `E0840`: evento de Cancelamento já vinculado à NFS-e | Código | A nota **já está cancelada** no Ambiente Nacional (em geral pelo portal). Gravar como cancelada quando **todos** os `EnviarEvento.Erros` são E0840; retorno misto continua rejeitado. Nunca mandar para a consulta, que a marcaria como não cancelada |
72
+ | "Operação CancelarNfse está temporariamente indisponível. Serviço em construção." | **Limitação** | Serviço indisponível no município (visto no ISSNet). Sem conserto pelo código |
73
+ | Retenção federal não destacada na nota | Código | Campo ABRASF preenchido em vez do nacional; ver o passo 4, item 3 |
74
+ | "Outras Retenções" não aparece | **Limitação** | Não existe campo no layout nacional. Registrar aviso no log |
75
+
76
+ Se a rejeição não estiver na tabela, siga ao passo 4.
77
+
78
+ ## Passo 4: rastrear o campo até o XML
79
+
80
+ Para rejeição de campo, percorra a cadeia inteira antes de concluir:
81
+
82
+ 1. **Banco**: a query traz a coluna? Se a query é agregada, coluna nova precisa entrar no `SELECT` **e** no
83
+ `GROUP BY`.
84
+ 2. **Rotina que monta a NFS-e**: o campo é atribuído? Atenção a campos por item lidos **depois** do laço, com o
85
+ cursor no **último** item.
86
+ 3. **Propriedade certa do layout**: `TNFSe.Servico.Valores` acumula campos das duas gerações (ABRASF e nacional).
87
+ Preencher o campo ABRASF não gera erro: a tag simplesmente não aparece.
88
+ 4. **`GravarXml` do provedor**: confirme qual propriedade ele lê de fato. `AppendChild(nil)` sai em **silêncio**
89
+ (`ACBrXmlDocument.pas`), e `AddNode` grava tag obrigatória vazia registrando apenas um `wAlerta`
90
+ (`ACBrXmlWriter.pas`).
91
+ 5. **XSD do provedor**: compare com o do Padrão Nacional; podem divergir em formato e em campos disponíveis.
92
+ Confira também se o método auxiliar do ACBr é `virtual`; se não for, o `override` do provedor não tem efeito.
93
+
94
+ ## Saída esperada
95
+
96
+ Sempre neste formato, mesmo quando a conclusão é "não é defeito nosso":
97
+
98
+ ```
99
+ REJEIÇÃO: <código> — <texto integral da prefeitura>
100
+ PROVEDOR: <nome> | APIPropria: <sim/não> | Layout: <Nacional/ABRASF>
101
+ OPERAÇÃO: <emissão|cancelamento|consulta|impressão>
102
+ SERVIÇO NA LISTA ServicosPadraoNacional: <sim/não/não se aplica>
103
+
104
+ NATUREZA: <cadastro | código | limitação da prefeitura>
105
+
106
+ EVIDÊNCIA:
107
+ <trecho do XML enviado, ou o ponto do código, ou a linha do XSD>
108
+
109
+ CONCLUSÃO:
110
+ <cadastro> → qual campo o cliente corrige, em que tela do sistema
111
+ <código> → arquivo:linha a alterar e qual propriedade do layout usar
112
+ <limitação> → texto do aviso para as notas de versão ou o suporte
113
+ ```
114
+
115
+ ## Exemplo
116
+
117
+ **Entrada:** "NFS-e de Cuiabá rejeitou com: *O grupo de informações relativo ao imóvel deve constar na DPS para o
118
+ indicador da operação informado*."
119
+
120
+ **Saída:**
121
+
122
+ ```
123
+ REJEIÇÃO: — O grupo de informações relativo ao imóvel deve constar na DPS
124
+ para o indicador da operação informado
125
+ PROVEDOR: ISSNet (Cuiabá, 5103403) | APIPropria: sim | Layout: Nacional
126
+ OPERAÇÃO: emissão
127
+ SERVIÇO NA LISTA: não se aplica (emissão)
128
+
129
+ NATUREZA: código
130
+
131
+ EVIDÊNCIA:
132
+ cIndOp do prestador = 020201 (serviço sobre bem imóvel).
133
+ A rotina que monta a NFS-e preenche IBSCBS.finNFSe, indFinal, cIndOp e
134
+ indDest, mas nunca toca em IBSCBS.imovel — e o ACBr só emite a tag se
135
+ algum campo do grupo estiver preenchido (ACBrNFSeXGravarXml.pas).
136
+
137
+ CONCLUSÃO:
138
+ código → preencher IBSCBS.imovel com o endereço do tomador quando cIndOp
139
+ for 020101, 020201 ou 020301. No ISSNet o <end> exige município junto do
140
+ CEP (TCEndereco), diferente do Padrão Nacional (TCEnderObraEvento), e não
141
+ existe cCIB. Validar CEP, logradouro, número e bairro antes de enviar e
142
+ falhar com mensagem de negócio dizendo qual campo falta.
143
+ Toda saída por exceção na montagem precisa de NotasFiscais.Clear no except.
144
+ ```
145
+
146
+ ## Quando não usar
147
+
148
+ - **NF-e ou NFC-e**: outra biblioteca (`ACBrNFe`), outro conjunto de rejeições, outra contingência.
149
+ - **Erro de conexão, certificado ou SSL**: não é rejeição de conteúdo; olhe a configuração do componente, a
150
+ validade do certificado e as bibliotecas de SSL configuradas.
151
+ - **A nota nem chegou a ser transmitida**: se falhou na montagem, o problema é dado de origem ou query, não
152
+ resposta da prefeitura.
153
+ - **Já se sabe que é cadastro**: não gaste o roteiro; instrua a correção direto.
154
+ - **Escrever o conserto**: esta skill diagnostica e classifica. A correção segue o fluxo normal (`/resolver-bug`),
155
+ respeitando as rules do projeto.
@@ -0,0 +1,143 @@
1
+ ---
2
+ name: patch-acbr
3
+ description: Aplica patch local nos fontes do ACBr com o ritual completo que impede a perda silenciosa da alteração - avaliar alternativa sem patch, localizar o fonte, backup .bak-fontdata, edição preservando ISO-8859-1 e CRLF, marca "// PATCH FONTDATA:" e registro no trabalho em docs/trabalhos. Use quando a correção exigir alterar qualquer arquivo dentro da pasta de componentes do ACBr (ACBrNFSeX, ACBrNFe, ACBrCTe, ACBrMDFe, ACBrDFe, provedores, ACBrXmlWriter, ACBrXmlDocument). Não use para alterar o código do próprio projeto.
4
+ ---
5
+
6
+ # Patch local no ACBr
7
+
8
+ A pasta do ACBr costuma ser **compartilhada entre os sistemas que compilam contra ela** e **não é repositório
9
+ git** do projeto. Todo patch aplicado ali:
10
+
11
+ - some na próxima atualização do ACBr, **sem aviso**, e o bug volta;
12
+ - afeta os outros sistemas que compilam contra a mesma pasta;
13
+ - não aparece em nenhum `git diff` do projeto.
14
+
15
+ Por isso o patch é o **último recurso**, e quando acontece precisa deixar rastro.
16
+
17
+ ## Passo 1: esgotar a alternativa sem patch
18
+
19
+ Antes de tocar no ACBr, responda por escrito:
20
+
21
+ 1. Dá para resolver no código do projeto? Preencher outra propriedade, chamar outro serviço, pós-processar o XML
22
+ gerado antes do envio.
23
+ 2. O método que precisa mudar é `virtual`? Se for, dá para **descender** o provedor ou a classe em vez de editar o
24
+ ACBr.
25
+ 3. A versão nova do ACBr já corrige? Confira antes de patchar.
26
+
27
+ Só siga se as três respostas forem não. Registre-as no documento do passo 5: é o que evita alguém repatchar depois
28
+ sem entender por quê.
29
+
30
+ **Armadilha conhecida:** em `ACBrNFSeXGravarXml.pas` só `GerarXMLImovel` é `virtual`;
31
+ `GerarXMLEnderecoNacionalImovel` **não é**. Um `override` que delega para ele volta a gerar o formato nacional em
32
+ silêncio. Verifique a virtualidade de toda a cadeia, não só do método de entrada.
33
+
34
+ ## Passo 2: localizar a pasta do ACBr
35
+
36
+ **O ACBr não fica no repositório do projeto e pode não existir na máquina atual**: o desenvolvimento Delphi
37
+ acontece em Windows, e o clone do repositório pode estar em outra máquina.
38
+
39
+ Procure nesta ordem:
40
+
41
+ 1. Variável de ambiente `ACBR_PATH`, se definida.
42
+ 2. Caminho registrado em `docs/trabalhos/` por um patch anterior (`grep -rl "PATCH FONTDATA" docs/trabalhos/`).
43
+ 3. Busca por um arquivo conhecido: `ACBrNFSeXServicos.ini`, `ACBrNFSeXGravarXml.pas`, `ACBrNFeWebServices.pas`.
44
+
45
+ Se não encontrar, **pare e informe**:
46
+
47
+ > A pasta do ACBr não está acessível nesta máquina. O patch precisa ser aplicado no ambiente Windows onde o projeto
48
+ > compila. Segue o patch pronto para aplicar lá: <arquivo, trecho antes, trecho depois>.
49
+
50
+ Não invente caminho, não crie a pasta, não siga às cegas.
51
+
52
+ ## Passo 3: backup antes de qualquer edição
53
+
54
+ ```
55
+ <arquivo>.pas → <arquivo>.pas.bak-fontdata
56
+ ```
57
+
58
+ Um backup por arquivo, na própria pasta do componente. Se já existir um `.bak-fontdata`, **não sobrescreva**: já
59
+ há patch anterior ali, então leia o que ele mudou antes de empilhar outro.
60
+
61
+ ## Passo 4: editar preservando o encoding
62
+
63
+ Os fontes do ACBr são **ISO-8859-1 com CRLF**. Um `Write` ingênuo os converte para UTF-8 com LF e suja o arquivo
64
+ inteiro.
65
+
66
+ - Edite por script que leia e grave em `latin1`, preservando `\r\n`.
67
+ - Comentários da marca em **ASCII puro**: sem acento, sem `ç`, sem travessão.
68
+ - Altere o mínimo possível: quanto menor o patch, maior a chance de sobreviver a um merge manual.
69
+
70
+ Marque **início e fim**, sempre:
71
+
72
+ ```pascal
73
+ // PATCH FONTDATA: ISSNet exige municipio junto do CEP no endereco do imovel.
74
+ // Ver docs/trabalhos/<id>/
75
+ ... alteracao ...
76
+ // FIM PATCH FONTDATA
77
+ ```
78
+
79
+ ## Passo 5: registrar no trabalho em `docs/trabalhos/<id>/`
80
+
81
+ Sem este passo o patch está perdido, porque ele não aparece no `git diff` do projeto.
82
+
83
+ Crie ou atualize o `relatorios/TECNICO.md` do trabalho em `docs/trabalhos/<id>/` com uma seção contendo:
84
+
85
+ - o **caminho do arquivo** dentro da pasta do ACBr;
86
+ - a **versão do ACBr** em que o patch foi aplicado;
87
+ - o trecho **antes** e **depois**;
88
+ - por que não deu para resolver no código do projeto (as três respostas do passo 1);
89
+ - como **reaplicar** depois de atualizar o ACBr.
90
+
91
+ ## Passo 6: avisar sobre a reaplicação
92
+
93
+ Ao terminar, diga explicitamente ao usuário:
94
+
95
+ > Este patch está fora do git. Ao atualizar o ACBr, ele se perde e o bug volta. A instrução de reaplicação está em
96
+ > `docs/trabalhos/<id>/`.
97
+
98
+ ## Exemplo
99
+
100
+ **Entrada:** "O `<end>` do imóvel está saindo no formato nacional mesmo no ISSNet, e a prefeitura recusa com
101
+ *Element 'CEP': This element is not expected*."
102
+
103
+ **Saída:**
104
+
105
+ ```
106
+ PASSO 1 — alternativa sem patch
107
+ Resolver no projeto? não — o XML é montado inteiro pelo ACBr antes de voltar
108
+ Método virtual? GerarXMLImovel é virtual, MAS delega para
109
+ GerarXMLEnderecoNacionalImovel, que NÃO é. O override
110
+ volta a gerar o formato nacional.
111
+ Versão nova corrige? não, o ACBr trata o ISSNet como Padrão Nacional puro
112
+ => patch justificado
113
+
114
+ PASSO 2 — localização
115
+ ACBr não acessível nesta máquina (macOS). Patch preparado para aplicar no
116
+ ambiente Windows:
117
+ <ACBr>\Fontes\ACBrDFe\ACBrNFSeX\ACBrNFSeXGravarXml.pas
118
+
119
+ PASSO 3 — backup
120
+ ACBrNFSeXGravarXml.pas.bak-fontdata
121
+
122
+ PASSO 4 — edição (ISO-8859-1, CRLF, comentario em ASCII)
123
+ // PATCH FONTDATA: ISSNet usa TCEndereco (cMun+CEP) no endereco do imovel,
124
+ // nao TCEnderObraEvento (CEP solto) do Padrao Nacional. Sem isso a
125
+ // prefeitura recusa com "Element 'CEP': This element is not expected".
126
+ ... trecho ...
127
+ // FIM PATCH FONTDATA
128
+
129
+ PASSO 5 — docs/trabalhos/<id>/relatorios/TECNICO.md
130
+ seção "Patch no ACBr" com caminho, versão, antes/depois e reaplicação
131
+
132
+ PASSO 6 — aviso
133
+ Patch fora do git: se perde ao atualizar o ACBr.
134
+ ```
135
+
136
+ ## Quando não usar
137
+
138
+ - **Alterar o código do projeto**: fluxo normal, sem ritual de patch.
139
+ - **Antes de esgotar o passo 1**: patch é último recurso, não atalho.
140
+ - **Atualizar a versão do ACBr**: outra operação, que aliás **desfaz** os patches existentes; nesse caso o trabalho
141
+ é reaplicar os patches documentados em `docs/trabalhos/` (`grep -rl "PATCH FONTDATA" docs/trabalhos/`).
142
+ - **Quando o ACBr não está acessível e o usuário quer a alteração aplicada mesmo assim**: entregue o patch pronto
143
+ para o ambiente Windows; não simule.
@@ -26,6 +26,15 @@ Identifique a stack e percorra os pontos quentes de `references/pontos-quentes.m
26
26
  sempre que possível: profiler, `EXPLAIN`, análise de bundle, tempos em log ou teste de carga já existente.
27
27
  Achado sem medição é marcado como estimativa.
28
28
 
29
+ Conforme a stack detectada, consulte também as regras da skill correspondente:
30
+
31
+ - `react` ou `next` no `package.json` → `vercel-react-best-practices`;
32
+ - `react-native` ou `expo` no `package.json` → `vercel-react-native-skills`;
33
+ - Postgres (`pg`, `postgres`, Prisma com provider `postgresql`, FireDAC com driver PG) → `supabase-postgres-best-practices`.
34
+
35
+ No plugin, os nomes são `fontdata:vercel-react-best-practices`, `fontdata:vercel-react-native-skills` e
36
+ `fontdata:supabase-postgres-best-practices`. Sem a stack, a skill não é consultada. Achado que vem de uma dessas regras cita a skill e a regra aplicada.
37
+
29
38
  Sem caso concreto, não é achado: diga a situação (tela, endpoint, volume de dados) e o tempo ou consumo que ela
30
39
  produz. Leia quem chama o trecho apontado e o que ele chama. Escale o impacto pela carga esperada que o projeto
31
40
  declara (`SPEC.md`, `CLAUDE.md`, README, configuração de deploy); sem carga declarada, assuma a menor plausível. Diga