@fontdata/ai-harness 4.4.0 → 4.5.1

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 (214) hide show
  1. package/.claude-plugin/plugin.json +2 -2
  2. package/README.md +94 -1
  3. package/dist/cli.js +1 -0
  4. package/dist/config/config.js +24 -13
  5. package/dist/delphi/catalogo.js +308 -0
  6. package/dist/delphi/classificar.js +27 -2
  7. package/dist/delphi/command.js +50 -2
  8. package/dist/delphi/uses.js +90 -0
  9. package/dist/doctor/checks.js +37 -1
  10. package/dist/init.js +9 -1
  11. package/dist/install/perfis.js +15 -4
  12. package/dist/mapa/extratores/pascal.js +1 -1
  13. package/dist/update/update.js +80 -23
  14. package/package.json +1 -1
  15. package/templates/CLAUDE.md +2 -1
  16. package/templates/catalog.json +9 -4
  17. package/templates/hooks/comentarios/check.mjs +62 -5
  18. package/templates/hooks/hooks.json +2 -1
  19. package/templates/hooks/lib/config.mjs +1 -0
  20. package/templates/hooks/padroes-proibidos.mjs +68 -0
  21. package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md +6 -6
  22. package/templates/perfis/delphi/skills/conhecimento-delphi/SKILL.md +6 -0
  23. package/templates/perfis/delphi-fiscal/rules/campo-novo-acbr-preenchimento-explicito.md +61 -0
  24. package/templates/perfis/delphi-fiscal/rules/retorno-de-evento-nfe-pelo-cstat.md +51 -0
  25. package/templates/perfis/delphi-fiscal/rules/sucesso-de-webservice-fiscal-nao-prova-documento.md +100 -0
  26. package/templates/perfis/delphi-fiscal/rules/total-tributo-acbr-soma-itens.md +63 -0
  27. package/templates/perfis/delphi-fiscal/skills/diagnosticar-rejeicao-nfse/SKILL.md +155 -0
  28. package/templates/perfis/delphi-fiscal/skills/patch-acbr/SKILL.md +143 -0
  29. package/templates/skills/auditar-performance/SKILL.md +9 -0
  30. package/templates/skills/auditar-performance/references/pontos-quentes.md +8 -0
  31. package/templates/skills/auditar-seguranca/SKILL.md +55 -14
  32. package/templates/skills/auditar-seguranca/templates/relatorios/TECNICO.md +5 -0
  33. package/templates/skills/auditar-ui/SKILL.md +18 -3
  34. package/templates/skills/auditar-ui/references/ATRIBUICAO.md +44 -0
  35. package/templates/skills/auditar-ui/references/web-interface-guidelines.md +191 -0
  36. package/templates/skills/harness/references/validar-ideia.md +7 -6
  37. package/templates/skills/security-audit/AI-AND-LLM.md +83 -0
  38. package/templates/skills/security-audit/ATTACK-CLASSES.md +130 -0
  39. package/templates/skills/security-audit/CLIENT-SIDE.md +83 -0
  40. package/templates/skills/security-audit/CLOUD-AND-DEPLOYMENT.md +86 -0
  41. package/templates/skills/security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -0
  42. package/templates/skills/security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -0
  43. package/templates/skills/security-audit/HUNTING.md +251 -0
  44. package/templates/skills/security-audit/LICENSE +21 -0
  45. package/templates/skills/security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -0
  46. package/templates/skills/security-audit/ORIGEM.md +51 -0
  47. package/templates/skills/security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -0
  48. package/templates/skills/security-audit/RECONNAISSANCE.md +156 -0
  49. package/templates/skills/security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -0
  50. package/templates/skills/security-audit/SKILL.md +192 -0
  51. package/templates/skills/security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -0
  52. package/templates/skills/security-audit/VALIDATION-AND-REPORTING.md +186 -0
  53. package/templates/skills/security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -0
  54. package/templates/skills/security-audit/report-schema.json +461 -0
  55. package/templates/skills/security-audit/validate-coverage-ledger.cjs +872 -0
  56. package/templates/skills/security-audit/validate-findings.cjs +773 -0
  57. package/templates/skills/supabase-postgres-best-practices/CHANGELOG.md +73 -0
  58. package/templates/skills/supabase-postgres-best-practices/LICENSE +21 -0
  59. package/templates/skills/supabase-postgres-best-practices/ORIGEM.md +43 -0
  60. package/templates/skills/supabase-postgres-best-practices/SKILL.md +64 -0
  61. package/templates/skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
  62. package/templates/skills/supabase-postgres-best-practices/references/_sections.md +39 -0
  63. package/templates/skills/supabase-postgres-best-practices/references/_template.md +34 -0
  64. package/templates/skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
  65. package/templates/skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
  66. package/templates/skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
  67. package/templates/skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
  68. package/templates/skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
  69. package/templates/skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
  70. package/templates/skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
  71. package/templates/skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
  72. package/templates/skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
  73. package/templates/skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
  74. package/templates/skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
  75. package/templates/skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
  76. package/templates/skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
  77. package/templates/skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
  78. package/templates/skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
  79. package/templates/skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
  80. package/templates/skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
  81. package/templates/skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
  82. package/templates/skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
  83. package/templates/skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
  84. package/templates/skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
  85. package/templates/skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
  86. package/templates/skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
  87. package/templates/skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
  88. package/templates/skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
  89. package/templates/skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
  90. package/templates/skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
  91. package/templates/skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
  92. package/templates/skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
  93. package/templates/skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
  94. package/templates/skills/supabase-postgres-best-practices/references/security-rls-performance.md +63 -0
  95. package/templates/skills/vercel-react-best-practices/AGENTS.md +3810 -0
  96. package/templates/skills/vercel-react-best-practices/ORIGEM.md +39 -0
  97. package/templates/skills/vercel-react-best-practices/README.md +123 -0
  98. package/templates/skills/vercel-react-best-practices/SKILL.md +149 -0
  99. package/templates/skills/vercel-react-best-practices/metadata.json +15 -0
  100. package/templates/skills/vercel-react-best-practices/rules/_sections.md +46 -0
  101. package/templates/skills/vercel-react-best-practices/rules/_template.md +28 -0
  102. package/templates/skills/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
  103. package/templates/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  104. package/templates/skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
  105. package/templates/skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
  106. package/templates/skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
  107. package/templates/skills/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
  108. package/templates/skills/vercel-react-best-practices/rules/async-defer-await.md +82 -0
  109. package/templates/skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
  110. package/templates/skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
  111. package/templates/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
  112. package/templates/skills/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
  113. package/templates/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
  114. package/templates/skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
  115. package/templates/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
  116. package/templates/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  117. package/templates/skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
  118. package/templates/skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
  119. package/templates/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
  120. package/templates/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
  121. package/templates/skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
  122. package/templates/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
  123. package/templates/skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
  124. package/templates/skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
  125. package/templates/skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
  126. package/templates/skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
  127. package/templates/skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
  128. package/templates/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
  129. package/templates/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
  130. package/templates/skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
  131. package/templates/skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
  132. package/templates/skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
  133. package/templates/skills/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
  134. package/templates/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
  135. package/templates/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
  136. package/templates/skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
  137. package/templates/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  138. package/templates/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
  139. package/templates/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
  140. package/templates/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  141. package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  142. package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  143. package/templates/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
  144. package/templates/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
  145. package/templates/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
  146. package/templates/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  147. package/templates/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
  148. package/templates/skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
  149. package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  150. package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
  151. package/templates/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
  152. package/templates/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  153. package/templates/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  154. package/templates/skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
  155. package/templates/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  156. package/templates/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
  157. package/templates/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  158. package/templates/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
  159. package/templates/skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
  160. package/templates/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
  161. package/templates/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  162. package/templates/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
  163. package/templates/skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
  164. package/templates/skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
  165. package/templates/skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
  166. package/templates/skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
  167. package/templates/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
  168. package/templates/skills/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
  169. package/templates/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
  170. package/templates/skills/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
  171. package/templates/skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
  172. package/templates/skills/vercel-react-native-skills/AGENTS.md +2897 -0
  173. package/templates/skills/vercel-react-native-skills/ORIGEM.md +39 -0
  174. package/templates/skills/vercel-react-native-skills/README.md +165 -0
  175. package/templates/skills/vercel-react-native-skills/SKILL.md +121 -0
  176. package/templates/skills/vercel-react-native-skills/metadata.json +16 -0
  177. package/templates/skills/vercel-react-native-skills/rules/_sections.md +86 -0
  178. package/templates/skills/vercel-react-native-skills/rules/_template.md +28 -0
  179. package/templates/skills/vercel-react-native-skills/rules/animation-derived-value.md +53 -0
  180. package/templates/skills/vercel-react-native-skills/rules/animation-gesture-detector-press.md +95 -0
  181. package/templates/skills/vercel-react-native-skills/rules/animation-gpu-properties.md +65 -0
  182. package/templates/skills/vercel-react-native-skills/rules/design-system-compound-components.md +66 -0
  183. package/templates/skills/vercel-react-native-skills/rules/fonts-config-plugin.md +71 -0
  184. package/templates/skills/vercel-react-native-skills/rules/imports-design-system-folder.md +68 -0
  185. package/templates/skills/vercel-react-native-skills/rules/js-hoist-intl.md +61 -0
  186. package/templates/skills/vercel-react-native-skills/rules/list-performance-callbacks.md +44 -0
  187. package/templates/skills/vercel-react-native-skills/rules/list-performance-function-references.md +132 -0
  188. package/templates/skills/vercel-react-native-skills/rules/list-performance-images.md +53 -0
  189. package/templates/skills/vercel-react-native-skills/rules/list-performance-inline-objects.md +97 -0
  190. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-expensive.md +94 -0
  191. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-memo.md +82 -0
  192. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-types.md +104 -0
  193. package/templates/skills/vercel-react-native-skills/rules/list-performance-virtualize.md +67 -0
  194. package/templates/skills/vercel-react-native-skills/rules/monorepo-native-deps-in-app.md +46 -0
  195. package/templates/skills/vercel-react-native-skills/rules/monorepo-single-dependency-versions.md +63 -0
  196. package/templates/skills/vercel-react-native-skills/rules/navigation-native-navigators.md +188 -0
  197. package/templates/skills/vercel-react-native-skills/rules/react-compiler-destructure-functions.md +50 -0
  198. package/templates/skills/vercel-react-native-skills/rules/react-compiler-reanimated-shared-values.md +48 -0
  199. package/templates/skills/vercel-react-native-skills/rules/react-state-dispatcher.md +91 -0
  200. package/templates/skills/vercel-react-native-skills/rules/react-state-fallback.md +56 -0
  201. package/templates/skills/vercel-react-native-skills/rules/react-state-minimize.md +65 -0
  202. package/templates/skills/vercel-react-native-skills/rules/rendering-no-falsy-and.md +74 -0
  203. package/templates/skills/vercel-react-native-skills/rules/rendering-text-in-text-component.md +36 -0
  204. package/templates/skills/vercel-react-native-skills/rules/scroll-position-no-state.md +82 -0
  205. package/templates/skills/vercel-react-native-skills/rules/state-ground-truth.md +80 -0
  206. package/templates/skills/vercel-react-native-skills/rules/ui-expo-image.md +66 -0
  207. package/templates/skills/vercel-react-native-skills/rules/ui-image-gallery.md +104 -0
  208. package/templates/skills/vercel-react-native-skills/rules/ui-measure-views.md +78 -0
  209. package/templates/skills/vercel-react-native-skills/rules/ui-menus.md +174 -0
  210. package/templates/skills/vercel-react-native-skills/rules/ui-native-modals.md +77 -0
  211. package/templates/skills/vercel-react-native-skills/rules/ui-pressable.md +61 -0
  212. package/templates/skills/vercel-react-native-skills/rules/ui-safe-area-scroll.md +65 -0
  213. package/templates/skills/vercel-react-native-skills/rules/ui-scrollview-content-inset.md +45 -0
  214. package/templates/skills/vercel-react-native-skills/rules/ui-styling.md +87 -0
@@ -46,6 +46,8 @@ const RASTREIO = [
46
46
  ];
47
47
 
48
48
  const DATA = /(^|[^"'\w])20\d{2}-\d{2}-\d{2}([^"'\w]|$)/;
49
+ const DATA_BR = /(^|[^"'\w/\d])\d{2}\/\d{2}\/(19|20)\d{2}([^"'\w/\d]|$)/;
50
+ const MSG_DATA = 'data de mudança no comentário — o git já registra isso';
49
51
  const tokensDeCodigo = (...extras) =>
50
52
  new RegExp(`(^|\\s)(${['const', 'let', 'var', 'function', 'return', 'if', 'for', 'while', 'await', 'import', 'export', 'def', 'class', ...extras].join('|')})\\b`);
51
53
  const CODIGO_TOKEN = tokensDeCodigo();
@@ -264,7 +266,7 @@ function analisar(caminho, fonte) {
264
266
  for (const [re, motivo] of RASTREIO) {
265
267
  if (re.test(texto)) { marca(inicio + 1, `${motivo} — isso mora no commit ou em docs/, não no código`); break; }
266
268
  }
267
- if (DATA.test(texto)) marca(inicio + 1, 'data de mudança no comentário — o git já registra isso');
269
+ if (DATA.test(texto)) marca(inicio + 1, MSG_DATA);
268
270
  for (let k = 0; k < conteudo.length; k++) {
269
271
  if (conteudo[k] && codigoToken.test(conteudo[k]) && CODIGO_FIM.test(conteudo[k])) {
270
272
  marca(inicio + k + 1, 'código comentado — apague, o git guarda');
@@ -295,6 +297,56 @@ function analisar(caminho, fonte) {
295
297
  return { achados, comentadas, uteis, densidade: uteis ? comentadas / uteis : 0 };
296
298
  }
297
299
 
300
+ function linhasComDataBr(caminho, fonte) {
301
+ const saida = [];
302
+ classificar(linhasDoFonte(caminho, fonte), extname(caminho)).forEach((c, i) => {
303
+ if (ehTexto(c) && DATA_BR.test(c)) saida.push(i + 1);
304
+ });
305
+ return saida;
306
+ }
307
+
308
+ const contarDataBr = (caminho, fonte) => (typeof fonte === 'string' ? linhasComDataBr(caminho, fonte).length : 0);
309
+
310
+ function desfazer(fonte, edicoes) {
311
+ let texto = fonte;
312
+ for (const e of [...edicoes].reverse()) {
313
+ const { old_string: antigo, new_string: novo } = e ?? {};
314
+ if (typeof antigo !== 'string' || typeof novo !== 'string' || !novo || !texto.includes(novo)) return null;
315
+ texto = e.replace_all ? texto.replaceAll(novo, () => antigo) : texto.replace(novo, () => antigo);
316
+ }
317
+ return texto;
318
+ }
319
+
320
+ function versaoNoHead(caminho) {
321
+ const r = spawnSync('git', ['show', `HEAD:./${parse(caminho).base}`], {
322
+ cwd: dirname(caminho),
323
+ encoding: 'utf8',
324
+ maxBuffer: 64 * 1024 * 1024,
325
+ stdio: ['ignore', 'pipe', 'ignore'],
326
+ });
327
+ return r.error || r.status !== 0 ? null : r.stdout;
328
+ }
329
+
330
+ function aumentouDataBr(caminho, fonte, toolInput) {
331
+ const edicoes = Array.isArray(toolInput?.edits) ? toolInput.edits : typeof toolInput?.new_string === 'string' ? [toolInput] : null;
332
+ const depois = contarDataBr(caminho, fonte);
333
+ if (!edicoes) return depois > 0 && depois > contarDataBr(caminho, versaoNoHead(caminho));
334
+ const reconstruido = desfazer(fonte, edicoes);
335
+ if (reconstruido !== null) return depois > contarDataBr(caminho, reconstruido);
336
+ const soma = (campo) => edicoes.reduce((total, e) => total + contarDataBr(caminho, e?.[campo]), 0);
337
+ return soma('new_string') > soma('old_string');
338
+ }
339
+
340
+ /** Linhas de comentário com data DD/MM/AAAA que a edição introduziu; vazio quando a contagem não aumentou. */
341
+ function datasBrIntroduzidas(caminho, fonte, toolInput) {
342
+ if (!aumentouDataBr(caminho, fonte, toolInput)) return [];
343
+ const novas = linhasDoToolInput(toolInput);
344
+ const linhas = fonte.split('\n');
345
+ const todas = linhasComDataBr(caminho, fonte);
346
+ const tocadas = todas.filter((n) => novas.has(linhas[n - 1].trim()));
347
+ return tocadas.length ? tocadas : todas.length ? todas : [null];
348
+ }
349
+
298
350
  const raiz = process.env.CLAUDE_PROJECT_DIR || process.cwd();
299
351
  const BASELINE = join(raiz, '.claude', 'hooks', 'comentarios', 'baseline.json');
300
352
 
@@ -488,8 +540,9 @@ const aviso = avisoAtalhos(caminho, fonte, payload.tool_input, rel);
488
540
  let baseline = null;
489
541
  try { baseline = JSON.parse(readFileSync(BASELINE, 'utf8')); } catch {}
490
542
  const tolerado = baseline?.[chave] ?? 0;
543
+ const datasBr = datasBrIntroduzidas(caminho, fonte, payload.tool_input);
491
544
 
492
- if (achados.length <= tolerado) {
545
+ if (achados.length <= tolerado && !datasBr.length) {
493
546
  if (baseline && tolerado > 0 && achados.length < tolerado) {
494
547
  atualizarBaseline(chave, achados.length);
495
548
  console.error(`[comentarios] ${rel}: ${tolerado} → ${achados.length} violações. Catraca desceu — não pode mais subir.`);
@@ -500,11 +553,15 @@ if (achados.length <= tolerado) {
500
553
  process.exit(0);
501
554
  }
502
555
 
503
- const lista = achados.sort((a, b) => a.linha - b.linha).map((a) => ` ${rel}:${a.linha} ${a.msg}`);
556
+ const lista = [...achados, ...datasBr.map((linha) => ({ linha, msg: MSG_DATA }))]
557
+ .sort((a, b) => (a.linha ?? 0) - (b.linha ?? 0))
558
+ .map((a) => ` ${a.linha === null ? rel : `${rel}:${a.linha}`} ${a.msg}`);
504
559
  const contexto =
505
- tolerado > 0
560
+ tolerado > 0 && achados.length > tolerado
506
561
  ? `Este arquivo é legado: a baseline tolera ${tolerado} violação(ões) e agora há ${achados.length}. Não é preciso limpar o arquivo inteiro — basta não piorá-lo.`
507
- : 'Este arquivo não tem tolerância na baseline: vale o padrão cheio.';
562
+ : tolerado > 0
563
+ ? 'Este arquivo é legado, mas a tolerância da baseline não cobre data DD/MM/AAAA nova: tire a data que a edição introduziu.'
564
+ : 'Este arquivo não tem tolerância na baseline: vale o padrão cheio.';
508
565
 
509
566
  console.error(
510
567
  [
@@ -17,7 +17,8 @@
17
17
  {
18
18
  "matcher": "Edit|Write|MultiEdit",
19
19
  "hooks": [
20
- { "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/templates/hooks/proteger-contratos.mjs\"" }
20
+ { "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/templates/hooks/proteger-contratos.mjs\"" },
21
+ { "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/templates/hooks/padroes-proibidos.mjs\"" }
21
22
  ]
22
23
  }
23
24
  ],
@@ -16,6 +16,7 @@ export const DEFAULT_HOOK_MODES = {
16
16
  'task-so-fecha-verde': 'aviso',
17
17
  'proteger-contratos': 'aviso',
18
18
  'sem-jargao': 'aviso',
19
+ 'padroes-proibidos': 'aviso',
19
20
  };
20
21
 
21
22
  /** @type {HookMode[]} */
@@ -0,0 +1,68 @@
1
+ // @ts-check
2
+ import { existsSync, readFileSync } from 'node:fs';
3
+ import { extname, isAbsolute, join } from 'node:path';
4
+ import { runHook } from './lib/hook.mjs';
5
+
6
+ /** @typedef {{ extensoes: string[], regex: RegExp, motivo: string }} Padrao */
7
+
8
+ /**
9
+ * Entradas válidas de `.ai-harness/padroes.json`; a inválida é descartada sem derrubar as outras.
10
+ * @param {string} root
11
+ * @returns {Padrao[]}
12
+ */
13
+ function lerPadroes(root) {
14
+ const file = join(root, '.ai-harness', 'padroes.json');
15
+ if (!existsSync(file)) return [];
16
+ const lista = JSON.parse(readFileSync(file, 'utf8'))?.padroes;
17
+ if (!Array.isArray(lista)) return [];
18
+ return lista.flatMap((entrada) => {
19
+ if (typeof entrada !== 'object' || entrada === null) return [];
20
+ const { extensoes, regex, flags, motivo } = entrada;
21
+ if (!Array.isArray(extensoes) || !extensoes.length || typeof regex !== 'string' || typeof motivo !== 'string' || !motivo) return [];
22
+ const aceitos = [...new Set(String(typeof flags === 'string' ? flags : '').replace(/[^imsu]/g, ''))].join('');
23
+ try {
24
+ return [{ extensoes: extensoes.map((ext) => String(ext).toLowerCase()), regex: new RegExp(regex, `${aceitos}g`), motivo }];
25
+ } catch {
26
+ return [];
27
+ }
28
+ });
29
+ }
30
+
31
+ /**
32
+ * @param {unknown} texto
33
+ * @param {RegExp} regex
34
+ */
35
+ function contar(texto, regex) {
36
+ return [...String(texto ?? '').matchAll(new RegExp(regex))].length;
37
+ }
38
+
39
+ /**
40
+ * Texto antigo e novo da edição, para comparar a contagem.
41
+ * @param {Record<string, any>} input
42
+ * @param {string} root
43
+ * @returns {{ antes: string[], depois: string[] }}
44
+ */
45
+ function trechos(input, root) {
46
+ const toolInput = input.tool_input ?? {};
47
+ if (input.tool_name === 'Write') {
48
+ const alvo = String(toolInput.file_path ?? '');
49
+ const caminho = isAbsolute(alvo) ? alvo : join(root, alvo);
50
+ return { antes: [existsSync(caminho) ? readFileSync(caminho, 'utf8') : ''], depois: [String(toolInput.content ?? '')] };
51
+ }
52
+ /** @type {Array<Record<string, unknown>>} */
53
+ const edits = input.tool_name === 'MultiEdit' && Array.isArray(toolInput.edits) ? toolInput.edits : [toolInput];
54
+ return { antes: edits.map((edit) => String(edit?.old_string ?? '')), depois: edits.map((edit) => String(edit?.new_string ?? '')) };
55
+ }
56
+
57
+ await runHook('padroes-proibidos', (input, { root }) => {
58
+ const extensao = extname(String(input.tool_input?.file_path ?? '')).toLowerCase();
59
+ if (!extensao) return null;
60
+ const padroes = lerPadroes(root).filter((padrao) => padrao.extensoes.includes(extensao));
61
+ if (!padroes.length) return null;
62
+
63
+ const { antes, depois } = trechos(input, root);
64
+ const soma = (/** @type {string[]} */ textos, /** @type {RegExp} */ regex) => textos.reduce((total, texto) => total + contar(texto, regex), 0);
65
+ const introduzidos = padroes.filter((padrao) => soma(depois, padrao.regex) > soma(antes, padrao.regex));
66
+ if (!introduzidos.length) return null;
67
+ return { motivo: introduzidos.map((padrao) => padrao.motivo).join(' ') };
68
+ });
@@ -77,13 +77,13 @@ grep -n "Bibliotecas\\\\Helpers" *.dproj
77
77
  As units de helper fazem `uses Fontdata.Utils`, então `Bibliotecas\Utils` também precisa estar no search path.
78
78
  Se algum dos caminhos não aparece, **não** acrescente ao `.dproj` por conta própria: pergunte ao usuário.
79
79
 
80
- Uma unit por framework, no `uses` da `implementation`:
80
+ Uma unit por framework (`Fontdata.Helpers.VCL`, `Fontdata.Helpers.FMX`, `Fontdata.Helpers.UniGUI`), no `uses` da
81
+ `implementation`.
81
82
 
82
- | Framework | Unit | Helpers que ela declara |
83
- |---|---|---|
84
- | VCL | `Fontdata.Helpers.VCL` | `TCheckBox`, `TCustomEdit`, `TCustomLabel` |
85
- | FMX | `Fontdata.Helpers.FMX` | `TCheckBox`, `TSwitch`, `TCustomEdit` |
86
- | UniGUI | `Fontdata.Helpers.UniGUI` | `TUniCheckBox`, `TUniCustomEdit` |
83
+ **Consulte o catálogo antes de escrever.** O que cada unit `Fontdata.*` do search path declara (helpers, classes,
84
+ rotinas, com a assinatura) está em `.claude/skills/conhecimento-delphi/references/bibliotecas-fontdata.md`. O
85
+ arquivo é gerado no projeto, não vem no pacote: se ele não existir, gere com
86
+ `npx @fontdata/ai-harness delphi catalogo`, e rode o comando de novo quando as units mudarem (o `doctor` avisa).
87
87
 
88
88
  Label só tem helper na VCL. `TSwitch` só na FMX. `Replace` só existe na VCL (edit e label); FMX e UniGUI não têm.
89
89
 
@@ -53,6 +53,12 @@ Encoding/BOM, `try/finally` e threads não estão aqui: são regras do perfil, j
53
53
  - `references/horse-gbswagger-rotas-jwt.md` — Horse + gbswagger + JWT: rota que muda ou some, 401 no Swagger,
54
54
  `W1074 Unknown custom attribute`.
55
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
+
56
62
  ### Fiscal
57
63
 
58
64
  - `references/acbr-nfce-integracao.md` — ACBr NFC-e: units, SSL em simulação, `IdCSC`, chave de 44 dígitos,
@@ -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.