@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
@@ -9,9 +9,55 @@ import { HOOKS_ITEM_ID, isHarnessPluginEnabled, projectHooksConfig } from '../in
9
9
  import { BANCO_MCP_NOME, BANCO_MCP_NOME_LEGADO, bancoMcpServer, ehEntradaGerenciada, MCP_PATH, mergeMcpServers } from '../install/mcp.js';
10
10
  import { hashContent, LOCK_PATH, LOCK_VERSION, readLock, writeLock } from '../install/lock.js';
11
11
  import { agentsForaDoLock, itemSources, packageInfo, PROJECT_RULE_PATH, projectRuleContent } from '../install/plan.js';
12
+ import { PERFIL_DELPHI_HOOK_COMMAND, perfilDelphiHooksConfig, perfilRecusadoNoConfig, PERFIS, perfisDoProjeto } from '../install/perfis.js';
12
13
  import { neededSkillsFor } from '../install/selection.js';
13
- import { BANCO_PERMISSIONS_LEGADAS, combineHooks, HARNESS_DENY, harnessPermissions, hasAllowRule, mergeSettings, SETTINGS_PATH, } from '../install/settings.js';
14
+ import { BANCO_PERMISSIONS_LEGADAS, combineHooks, HARNESS_DENY, harnessPermissions, hasAllowRule, hookCommands, mergeSettings, normalizarComandoHook, SETTINGS_PATH, } from '../install/settings.js';
14
15
  import { adoptLegacyInstall } from './legado.js';
16
+ const PERFIL_DELPHI_ITEM = 'perfil:delphi';
17
+ /** Pastas que os arquivos do item ocupam no projeto (`.claude/<tipo>/<nome>/`), as que ainda existem. */
18
+ function pastasDoItem(root, item) {
19
+ const pastas = new Set(item.arquivos.map((entry) => `${entry.caminho.split('/').slice(0, 3).join('/')}/`));
20
+ return [...pastas].filter((pasta) => existsSync(join(root, pasta))).sort();
21
+ }
22
+ function itensRecusados(recusas) {
23
+ return new Set(recusas.map((recusa) => `perfil:${recusa.perfil}`));
24
+ }
25
+ function arquivosMantidos(pastas) {
26
+ return pastas.length
27
+ ? `Os arquivos do perfil são mantidos e podem ser apagados à mão: ${pastas.join(', ')}.`
28
+ : 'Os arquivos do perfil já foram apagados.';
29
+ }
30
+ /** O settings do projeto já registra o hook do perfil em todos os eventos dele. */
31
+ function perfilDelphiRegistrado(root) {
32
+ let hooks;
33
+ try {
34
+ hooks = JSON.parse(readFileSync(join(root, SETTINGS_PATH), 'utf8')).hooks ?? {};
35
+ }
36
+ catch {
37
+ return false;
38
+ }
39
+ if (!isPlainObject(hooks))
40
+ return false;
41
+ const comando = normalizarComandoHook(PERFIL_DELPHI_HOOK_COMMAND);
42
+ return Object.keys(perfilDelphiHooksConfig()).every((evento) => hookCommands({ [evento]: hooks[evento] ?? [] }).map(normalizarComandoHook).includes(comando));
43
+ }
44
+ /** O settings do projeto já registra cada comando dos hooks do núcleo no evento dele, nas duas grafias. */
45
+ function hooksNucleoRegistrados(root) {
46
+ let hooks;
47
+ try {
48
+ hooks = JSON.parse(readFileSync(join(root, SETTINGS_PATH), 'utf8')).hooks ?? {};
49
+ }
50
+ catch {
51
+ return false;
52
+ }
53
+ if (!isPlainObject(hooks))
54
+ return false;
55
+ const registrados = hooks;
56
+ return Object.entries(projectHooksConfig()).every(([evento, grupos]) => {
57
+ const existentes = new Set(hookCommands({ [evento]: registrados[evento] ?? [] }).map(normalizarComandoHook));
58
+ return hookCommands({ [evento]: grupos }).every((comando) => existentes.has(normalizarComandoHook(comando)));
59
+ });
60
+ }
15
61
  function isPlainObject(value) {
16
62
  return typeof value === 'object' && value !== null && !Array.isArray(value);
17
63
  }
@@ -58,8 +104,17 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
58
104
  }
59
105
  const changes = [];
60
106
  const stale = [];
107
+ const { config } = readConfig(root);
108
+ const itemDoPerfil = (perfil) => lock.itens.find((item) => item.tipo === 'perfil' && item.id === perfil);
109
+ const perfisRecusados = PERFIS.flatMap((perfil) => {
110
+ const item = itemDoPerfil(perfil);
111
+ return item && perfilRecusadoNoConfig(perfil, config) ? [{ perfil, pastas: pastasDoItem(root, item) }] : [];
112
+ });
113
+ const recusados = itensRecusados(perfisRecusados);
61
114
  for (const item of lock.itens) {
62
115
  const key = `${item.tipo}:${item.id}`;
116
+ if (recusados.has(key))
117
+ continue;
63
118
  const sources = itemSources(catalog, item.tipo, item.id) ?? [];
64
119
  const sourceByPath = new Map(sources.map((entry) => [entry.path, entry.source]));
65
120
  for (const entry of item.arquivos) {
@@ -99,6 +154,11 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
99
154
  continue;
100
155
  const target = join(root, path);
101
156
  const same = existsSync(target) && hashContent(readFileSync(target)) === hashContent(readFileSync(source));
157
+ // O perfil e o hook:ai-harness da adoção entraram sem este arquivo porque ele já era do projeto: continua do
158
+ // projeto, mesmo com --forcar.
159
+ const preservado = item.tipo === 'perfil' || (item.tipo === 'hook' && item.id === HOOKS_ITEM_ID);
160
+ if (!same && existsSync(target) && preservado)
161
+ continue;
102
162
  changes.push({ tipo: !existsSync(target) || same ? 'novo' : 'conflito', caminho: path, item: key, source });
103
163
  }
104
164
  }
@@ -129,7 +189,15 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
129
189
  addItem('skill', skill.id, false);
130
190
  }
131
191
  }
132
- const { config } = readConfig(root);
192
+ for (const item of lock.itens) {
193
+ if (item.tipo !== 'skill')
194
+ continue;
195
+ const fluxo = entries.find((cmd) => cmd.id === item.id && cmd.skill);
196
+ if (!fluxo)
197
+ continue;
198
+ for (const skill of neededSkillsFor(catalog, [fluxo]))
199
+ addItem('skill', skill.id, false);
200
+ }
133
201
  // Na adoção, a instalação antiga ganha o que a 2.1 instala e ela não tinha.
134
202
  const adotada = !recorded;
135
203
  const pluginHooks = adotada && isHarnessPluginEnabled(root, home);
@@ -141,6 +209,7 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
141
209
  }
142
210
  for (const id of agentsForaDoLock(catalog, lock))
143
211
  addItem('agent', id, true);
212
+ const registrarHooksNucleo = !adotada && lock.itens.some((item) => item.tipo === 'hook' && item.id === HOOKS_ITEM_ID) && !isHarnessPluginEnabled(root, home) && !hooksNucleoRegistrados(root);
144
213
  // O padrão de comentários também chega ao lock anterior a ele, salvo com a recusa no config ou na flag. O hook é a
145
214
  // referência: o comando `comentarios` não registra a rule quando o projeto já tem uma própria.
146
215
  const querComentarios = !semComentarios && config.comentarios.instalar;
@@ -151,6 +220,10 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
151
220
  addItem('rule', 'comentarios', true);
152
221
  addItem('hook', 'comentarios', true);
153
222
  }
223
+ const instalarPerfis = perfisDoProjeto(root, config).filter((perfil) => !itemDoPerfil(perfil));
224
+ for (const perfil of instalarPerfis)
225
+ addItem('perfil', perfil, true);
226
+ const registrarPerfilDelphi = instalarPerfis.includes('delphi') || (!!itemDoPerfil('delphi') && !recusados.has(PERFIL_DELPHI_ITEM) && !perfilDelphiRegistrado(root));
154
227
  const registrarMcpConfig = config.banco_dados.registrar_mcp;
155
228
  const permissoesBanco = !semBanco && registrarMcpConfig;
156
229
  const permissoesFaltando = [
@@ -165,6 +238,7 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
165
238
  stale,
166
239
  adotada,
167
240
  registrarHooks: adotada && !pluginHooks,
241
+ registrarHooksNucleo,
168
242
  registrarComentarios,
169
243
  registrarHookComentarios,
170
244
  recusarComentarios: semComentarios && config.comentarios.instalar,
@@ -176,6 +250,9 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
176
250
  mudancaMcp: registrarMcp ? mcpChange(root, packageInfo().versao) : null,
177
251
  recusarMcp: semBanco && registrarMcpConfig,
178
252
  renomearSecaoBanco: temSecaoBancoLegada(root),
253
+ registrarPerfilDelphi,
254
+ instalarPerfis,
255
+ perfisRecusados,
179
256
  };
180
257
  }
181
258
  /**
@@ -213,9 +290,15 @@ export function applyUpdate(root, report, options, pkg, now = new Date()) {
213
290
  renameSync(join(root, path), join(root, para));
214
291
  return { de: path, para };
215
292
  });
216
- const hooks = combineHooks(report.registrarHooks ? projectHooksConfig() : {}, report.registrarComentarios ? commentsHooksConfig() : {});
293
+ const hooks = combineHooks(report.registrarHooks || report.registrarHooksNucleo ? projectHooksConfig() : {}, report.registrarComentarios ? commentsHooksConfig() : {}, report.registrarPerfilDelphi ? perfilDelphiHooksConfig() : {});
217
294
  const ajustes = [];
218
- const settings = mergeSettings(root, { hooks, allow: harnessPermissions({ banco: report.permissoesBanco }), deny: HARNESS_DENY, removeAllow: BANCO_PERMISSIONS_LEGADAS }, now);
295
+ const settings = mergeSettings(root, {
296
+ hooks,
297
+ allow: harnessPermissions({ banco: report.permissoesBanco }),
298
+ deny: HARNESS_DENY,
299
+ removeAllow: BANCO_PERMISSIONS_LEGADAS,
300
+ removeHooks: itensRecusados(report.perfisRecusados).has(PERFIL_DELPHI_ITEM) ? [PERFIL_DELPHI_HOOK_COMMAND] : [],
301
+ }, now);
219
302
  if (settings.changed)
220
303
  ajustes.push(`${SETTINGS_PATH} atualizado${settings.backup ? ` (backup em ${settings.backup})` : ''}.`);
221
304
  const avisos = [];
@@ -273,8 +356,11 @@ export function applyUpdate(root, report, options, pkg, now = new Date()) {
273
356
  const writtenHash = new Map(write.map((file) => [file.path, hashContent(file.content)]));
274
357
  const dropped = new Set([...remove, ...report.stale, ...legacy]);
275
358
  const itens = [];
359
+ const recusados = itensRecusados(report.perfisRecusados);
276
360
  for (const item of report.lock.itens) {
277
361
  const key = `${item.tipo}:${item.id}`;
362
+ if (recusados.has(key))
363
+ continue;
278
364
  const entries = new Map(item.arquivos.map((entry) => [entry.caminho, entry]));
279
365
  for (const [path, sha256] of writtenHash) {
280
366
  if (itemOf.get(path) === key)
@@ -333,6 +419,7 @@ export function describeUpdate(report) {
333
419
  'a rule de projeto e a permissão do `ai-harness evento`.',
334
420
  ]
335
421
  : [];
422
+ const nucleo = report.registrarHooksNucleo ? [`Faltam hooks do harness em ${SETTINGS_PATH}; o --yes registra os que faltam.`] : [];
336
423
  const permission = report.permissaoAusente && !report.adotada
337
424
  ? [
338
425
  `Faltam permissões do harness em .claude/settings.json (${report.permissoesFaltando.join(', ')}); o --yes as acrescenta.`,
@@ -365,15 +452,47 @@ export function describeUpdate(report) {
365
452
  ...(report.renomearSecaoBanco ? [`A seção banco de ${CONFIG_PATH} agora se chama banco_dados; o --yes a renomeia.`] : []),
366
453
  ...(report.recusarMcp ? [`--sem-banco-dados: o --yes grava banco_dados.registrar_mcp: false em ${CONFIG_PATH} e não registra o MCP.`] : []),
367
454
  ];
455
+ const delphiRecusado = report.perfisRecusados.find((recusa) => recusa.perfil === 'delphi');
456
+ const fiscalRecusado = report.perfisRecusados.find((recusa) => recusa.perfil === 'delphi-fiscal');
457
+ const perfil = [
458
+ ...(report.instalarPerfis.includes('delphi')
459
+ ? [
460
+ 'Projeto Delphi sem o perfil delphi: o --yes grava as rules em .claude/rules/delphi/, a skill conhecimento-delphi e o hook ' +
461
+ `.claude/hooks/delphi/encoding.mjs, registrado em ${SETTINGS_PATH}. Para recusar, grave perfis.delphi: false em ${CONFIG_PATH}.`,
462
+ ]
463
+ : report.registrarPerfilDelphi
464
+ ? [`O hook do perfil delphi não está registrado em ${SETTINGS_PATH}; o --yes o registra.`]
465
+ : []),
466
+ ...(report.instalarPerfis.includes('delphi-fiscal')
467
+ ? [
468
+ 'Projeto Delphi com ACBr sem o perfil delphi-fiscal: o --yes grava as rules em .claude/rules/delphi-fiscal/ e as skills ' +
469
+ `patch-acbr e diagnosticar-rejeicao-nfse. Para recusar, grave perfis["delphi-fiscal"]: false em ${CONFIG_PATH}.`,
470
+ ]
471
+ : []),
472
+ ...(delphiRecusado
473
+ ? [
474
+ `perfis.delphi: false em ${CONFIG_PATH}: o --yes tira o perfil delphi do ${LOCK_PATH} e o registro do hook de ${SETTINGS_PATH}. ` +
475
+ arquivosMantidos(delphiRecusado.pastas),
476
+ ]
477
+ : []),
478
+ ...(fiscalRecusado
479
+ ? [
480
+ `Perfil delphi-fiscal recusado em ${CONFIG_PATH} (perfis["delphi-fiscal"]: false ou perfis.delphi: false): o --yes tira o ` +
481
+ `perfil delphi-fiscal do ${LOCK_PATH}. ${arquivosMantidos(fiscalRecusado.pastas)}`,
482
+ ]
483
+ : []),
484
+ ];
368
485
  if (!report.changes.length) {
369
- const status = adopted.length || comentarios.length || permission.length || legadas.length || mcp.length
486
+ const status = adopted.length || comentarios.length || perfil.length || nucleo.length || permission.length || legadas.length || mcp.length
370
487
  ? 'Nenhum arquivo a atualizar.'
371
488
  : 'A instalação está em dia: nenhum arquivo a atualizar.';
372
- return [...adopted, ...comentarios, ...permission, ...legadas, ...mcp, status].join('\n');
489
+ return [...adopted, ...comentarios, ...perfil, ...nucleo, ...permission, ...legadas, ...mcp, status].join('\n');
373
490
  }
374
491
  return [
375
492
  ...adopted,
376
493
  ...comentarios,
494
+ ...perfil,
495
+ ...nucleo,
377
496
  ...permission,
378
497
  ...legadas,
379
498
  ...mcp,
@@ -416,7 +535,7 @@ export function runUpdateCommand(argv) {
416
535
  const report = checkUpdate(root, undefined, undefined, undefined, { semBanco: args.semBanco, semComentarios: args.semComentarios });
417
536
  console.log(describeUpdate(report));
418
537
  // Sem arquivo a atualizar, a adoção ainda grava o lock, e a permissão e o MCP ainda são acrescentados.
419
- const pendente = report.adotada || report.permissaoAusente || report.permissoesLegadas.length > 0 || report.mudancaMcp !== null || report.recusarMcp || report.recusarComentarios || report.registrarHookComentarios || report.renomearSecaoBanco;
538
+ const pendente = report.adotada || report.permissaoAusente || report.permissoesLegadas.length > 0 || report.mudancaMcp !== null || report.recusarMcp || report.recusarComentarios || report.registrarHookComentarios || report.renomearSecaoBanco || report.registrarPerfilDelphi || report.registrarHooksNucleo || report.perfisRecusados.length > 0;
420
539
  if (args.check || (!report.changes.length && !pendente))
421
540
  return 0;
422
541
  if (!args.yes) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fontdata/ai-harness",
3
- "version": "4.3.1",
3
+ "version": "4.5.0",
4
4
  "description": "Harness de engenharia com IA da Fontdata para Claude Code: roda os slash commands direto na pasta do projeto via npx, sem instalar nada — ou instala-os em .claude/commands.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -39,7 +39,8 @@ Tipos de trabalho: `feature` (`/nova-tarefa`), `bug` (`/resolver-bug`), `auditor
39
39
  - **Hooks** (modo de cada um em `.ai-harness/config.json`): `lembrete` sugere o fluxo certo para o pedido;
40
40
  `segredo-no-commit` bloqueia commit com segredo; `proteger-contratos` avisa quando SPEC, PLAN ou CLAUDE.md são
41
41
  reescritos durante a execução; `task-so-fecha-verde` avisa sobre task concluída sem suíte verde; `sem-jargao`
42
- avisa sobre termo técnico no relatório para o cliente.
42
+ avisa sobre termo técnico no relatório para o cliente; `padroes-proibidos` avisa quando a edição introduz um
43
+ padrão declarado em `.ai-harness/padroes.json`.
43
44
  - **Agents somente leitura:** `revisor-testes`, `qa`, `investigador`, `revisor-spec` e `auditor-plano`.
44
45
  - **Verificação:** `npx @fontdata/ai-harness doctor` confere instalação, contrato dos documentos e rastro;
45
46
  `npx @fontdata/ai-harness update` atualiza o que foi instalado sem perder alterações locais.
@@ -21,7 +21,15 @@
21
21
  { "id": "revisor-testes", "file": "agents/revisor-testes.md", "title": "Agent revisor-testes", "description": "Verifica se cada teste crítico falharia com a implementação errada." }
22
22
  ],
23
23
  "skills": [
24
- { "id": "lgpd-checker", "dir": "skills/lgpd-checker", "title": "Skill lgpd-checker", "description": "Conformidade com a LGPD (Lei nº 13.709/2018) em 11 categorias, com checklist e template de relatório. Vendorizada de bittencourtthulio/lgpd-checker." }
24
+ { "id": "lgpd-checker", "dir": "skills/lgpd-checker", "title": "Skill lgpd-checker", "description": "Conformidade com a LGPD (Lei nº 13.709/2018) em 11 categorias, com checklist e template de relatório. Vendorizada de bittencourtthulio/lgpd-checker." },
25
+ { "id": "security-audit", "dir": "skills/security-audit", "title": "Skill security-audit", "description": "Auditoria de segurança em fases (reconhecimento, caça, validação adversarial e relatório), com validadores de achados e de cobertura. Vendorizada de cloudflare/security-audit-skill." },
26
+ { "id": "vercel-react-best-practices", "dir": "skills/vercel-react-best-practices", "title": "Skill vercel-react-best-practices", "description": "Boas práticas de performance em React e Next.js, organizadas por impacto. Vendorizada de vercel-labs/agent-skills." },
27
+ { "id": "vercel-react-native-skills", "dir": "skills/vercel-react-native-skills", "title": "Skill vercel-react-native-skills", "description": "Boas práticas de performance em React Native e Expo, organizadas por impacto. Vendorizada de vercel-labs/agent-skills." },
28
+ { "id": "supabase-postgres-best-practices", "dir": "skills/supabase-postgres-best-practices", "title": "Skill supabase-postgres-best-practices", "description": "Boas práticas de Postgres em 8 categorias (consultas, índices, conexões, segurança e outras), por impacto. Vendorizada de supabase/agent-skills." }
29
+ ],
30
+ "perfis": [
31
+ { "id": "delphi", "dir": "perfis/delphi", "title": "Perfil Delphi", "description": "Rules de Delphi, a skill conhecimento-delphi e o hook de encoding, instalados quando o projeto tem .dpr ou .dproj." },
32
+ { "id": "delphi-fiscal", "dir": "perfis/delphi-fiscal", "title": "Perfil Delphi fiscal", "description": "Rules de documento fiscal com ACBr e as skills patch-acbr e diagnosticar-rejeicao-nfse, instalados com o perfil Delphi quando algum .dproj ou o boss.json cita ACBr." }
25
33
  ],
26
34
  "groups": [
27
35
  {
@@ -71,8 +79,8 @@
71
79
  "commands": [
72
80
  { "id": "memoria", "skill": "skills/memoria", "title": "/memoria", "description": "Mostra quem já mexeu num arquivo e por quê e aponta regressões candidatas de um bug.", "recommended": false },
73
81
  { "id": "auditar-ui", "skill": "skills/auditar-ui", "title": "/auditar-ui", "description": "Navega a app via Playwright MCP e audita UX/UI e/ou acessibilidade (a11y), por tela e severidade.", "recommended": false },
74
- { "id": "auditar-performance", "skill": "skills/auditar-performance", "title": "/auditar-performance", "description": "Audita gargalos de performance (queries, bundle, renders, algoritmos).", "recommended": false },
75
- { "id": "auditar-seguranca", "skill": "skills/auditar-seguranca", "title": "/auditar-seguranca", "description": "Auditoria defensiva: segredos, deps vulneráveis, inputs sem validação, configs e conformidade LGPD.", "recommended": false, "requiresSkills": ["lgpd-checker"] }
82
+ { "id": "auditar-performance", "skill": "skills/auditar-performance", "title": "/auditar-performance", "description": "Audita gargalos de performance (queries, bundle, renders, algoritmos).", "recommended": false, "requiresSkills": ["vercel-react-best-practices", "vercel-react-native-skills", "supabase-postgres-best-practices"] },
83
+ { "id": "auditar-seguranca", "skill": "skills/auditar-seguranca", "title": "/auditar-seguranca", "description": "Auditoria defensiva: segredos, deps vulneráveis, inputs sem validação, configs e conformidade LGPD.", "recommended": false, "requiresSkills": ["lgpd-checker", "security-audit"] }
76
84
  ]
77
85
  },
78
86
  {
@@ -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
+ });