@fontdata/ai-harness 4.4.0 → 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 (213) hide show
  1. package/.claude-plugin/plugin.json +2 -2
  2. package/README.md +74 -1
  3. package/dist/cli.js +1 -0
  4. package/dist/config/config.js +20 -12
  5. package/dist/delphi/catalogo.js +299 -0
  6. package/dist/delphi/classificar.js +21 -0
  7. package/dist/delphi/command.js +43 -2
  8. package/dist/doctor/checks.js +19 -1
  9. package/dist/init.js +9 -1
  10. package/dist/install/perfis.js +11 -4
  11. package/dist/mapa/extratores/pascal.js +1 -1
  12. package/dist/update/update.js +80 -23
  13. package/package.json +1 -1
  14. package/templates/CLAUDE.md +2 -1
  15. package/templates/catalog.json +9 -4
  16. package/templates/hooks/comentarios/check.mjs +62 -5
  17. package/templates/hooks/hooks.json +2 -1
  18. package/templates/hooks/lib/config.mjs +1 -0
  19. package/templates/hooks/padroes-proibidos.mjs +68 -0
  20. package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md +6 -6
  21. package/templates/perfis/delphi/skills/conhecimento-delphi/SKILL.md +6 -0
  22. package/templates/perfis/delphi-fiscal/rules/campo-novo-acbr-preenchimento-explicito.md +61 -0
  23. package/templates/perfis/delphi-fiscal/rules/retorno-de-evento-nfe-pelo-cstat.md +51 -0
  24. package/templates/perfis/delphi-fiscal/rules/sucesso-de-webservice-fiscal-nao-prova-documento.md +100 -0
  25. package/templates/perfis/delphi-fiscal/rules/total-tributo-acbr-soma-itens.md +63 -0
  26. package/templates/perfis/delphi-fiscal/skills/diagnosticar-rejeicao-nfse/SKILL.md +155 -0
  27. package/templates/perfis/delphi-fiscal/skills/patch-acbr/SKILL.md +143 -0
  28. package/templates/skills/auditar-performance/SKILL.md +9 -0
  29. package/templates/skills/auditar-performance/references/pontos-quentes.md +8 -0
  30. package/templates/skills/auditar-seguranca/SKILL.md +55 -14
  31. package/templates/skills/auditar-seguranca/templates/relatorios/TECNICO.md +5 -0
  32. package/templates/skills/auditar-ui/SKILL.md +18 -3
  33. package/templates/skills/auditar-ui/references/ATRIBUICAO.md +44 -0
  34. package/templates/skills/auditar-ui/references/web-interface-guidelines.md +191 -0
  35. package/templates/skills/harness/references/validar-ideia.md +7 -6
  36. package/templates/skills/security-audit/AI-AND-LLM.md +83 -0
  37. package/templates/skills/security-audit/ATTACK-CLASSES.md +130 -0
  38. package/templates/skills/security-audit/CLIENT-SIDE.md +83 -0
  39. package/templates/skills/security-audit/CLOUD-AND-DEPLOYMENT.md +86 -0
  40. package/templates/skills/security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -0
  41. package/templates/skills/security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -0
  42. package/templates/skills/security-audit/HUNTING.md +251 -0
  43. package/templates/skills/security-audit/LICENSE +21 -0
  44. package/templates/skills/security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -0
  45. package/templates/skills/security-audit/ORIGEM.md +51 -0
  46. package/templates/skills/security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -0
  47. package/templates/skills/security-audit/RECONNAISSANCE.md +156 -0
  48. package/templates/skills/security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -0
  49. package/templates/skills/security-audit/SKILL.md +192 -0
  50. package/templates/skills/security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -0
  51. package/templates/skills/security-audit/VALIDATION-AND-REPORTING.md +186 -0
  52. package/templates/skills/security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -0
  53. package/templates/skills/security-audit/report-schema.json +461 -0
  54. package/templates/skills/security-audit/validate-coverage-ledger.cjs +872 -0
  55. package/templates/skills/security-audit/validate-findings.cjs +773 -0
  56. package/templates/skills/supabase-postgres-best-practices/CHANGELOG.md +73 -0
  57. package/templates/skills/supabase-postgres-best-practices/LICENSE +21 -0
  58. package/templates/skills/supabase-postgres-best-practices/ORIGEM.md +43 -0
  59. package/templates/skills/supabase-postgres-best-practices/SKILL.md +64 -0
  60. package/templates/skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
  61. package/templates/skills/supabase-postgres-best-practices/references/_sections.md +39 -0
  62. package/templates/skills/supabase-postgres-best-practices/references/_template.md +34 -0
  63. package/templates/skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
  64. package/templates/skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
  65. package/templates/skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
  66. package/templates/skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
  67. package/templates/skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
  68. package/templates/skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
  69. package/templates/skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
  70. package/templates/skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
  71. package/templates/skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
  72. package/templates/skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
  73. package/templates/skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
  74. package/templates/skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
  75. package/templates/skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
  76. package/templates/skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
  77. package/templates/skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
  78. package/templates/skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
  79. package/templates/skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
  80. package/templates/skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
  81. package/templates/skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
  82. package/templates/skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
  83. package/templates/skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
  84. package/templates/skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
  85. package/templates/skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
  86. package/templates/skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
  87. package/templates/skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
  88. package/templates/skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
  89. package/templates/skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
  90. package/templates/skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
  91. package/templates/skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
  92. package/templates/skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
  93. package/templates/skills/supabase-postgres-best-practices/references/security-rls-performance.md +63 -0
  94. package/templates/skills/vercel-react-best-practices/AGENTS.md +3810 -0
  95. package/templates/skills/vercel-react-best-practices/ORIGEM.md +39 -0
  96. package/templates/skills/vercel-react-best-practices/README.md +123 -0
  97. package/templates/skills/vercel-react-best-practices/SKILL.md +149 -0
  98. package/templates/skills/vercel-react-best-practices/metadata.json +15 -0
  99. package/templates/skills/vercel-react-best-practices/rules/_sections.md +46 -0
  100. package/templates/skills/vercel-react-best-practices/rules/_template.md +28 -0
  101. package/templates/skills/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
  102. package/templates/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  103. package/templates/skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
  104. package/templates/skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
  105. package/templates/skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
  106. package/templates/skills/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
  107. package/templates/skills/vercel-react-best-practices/rules/async-defer-await.md +82 -0
  108. package/templates/skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
  109. package/templates/skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
  110. package/templates/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
  111. package/templates/skills/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
  112. package/templates/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
  113. package/templates/skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
  114. package/templates/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
  115. package/templates/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  116. package/templates/skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
  117. package/templates/skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
  118. package/templates/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
  119. package/templates/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
  120. package/templates/skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
  121. package/templates/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
  122. package/templates/skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
  123. package/templates/skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
  124. package/templates/skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
  125. package/templates/skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
  126. package/templates/skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
  127. package/templates/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
  128. package/templates/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
  129. package/templates/skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
  130. package/templates/skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
  131. package/templates/skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
  132. package/templates/skills/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
  133. package/templates/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
  134. package/templates/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
  135. package/templates/skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
  136. package/templates/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  137. package/templates/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
  138. package/templates/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
  139. package/templates/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  140. package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  141. package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  142. package/templates/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
  143. package/templates/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
  144. package/templates/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
  145. package/templates/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  146. package/templates/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
  147. package/templates/skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
  148. package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  149. package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
  150. package/templates/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
  151. package/templates/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  152. package/templates/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  153. package/templates/skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
  154. package/templates/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  155. package/templates/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
  156. package/templates/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  157. package/templates/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
  158. package/templates/skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
  159. package/templates/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
  160. package/templates/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  161. package/templates/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
  162. package/templates/skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
  163. package/templates/skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
  164. package/templates/skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
  165. package/templates/skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
  166. package/templates/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
  167. package/templates/skills/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
  168. package/templates/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
  169. package/templates/skills/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
  170. package/templates/skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
  171. package/templates/skills/vercel-react-native-skills/AGENTS.md +2897 -0
  172. package/templates/skills/vercel-react-native-skills/ORIGEM.md +39 -0
  173. package/templates/skills/vercel-react-native-skills/README.md +165 -0
  174. package/templates/skills/vercel-react-native-skills/SKILL.md +121 -0
  175. package/templates/skills/vercel-react-native-skills/metadata.json +16 -0
  176. package/templates/skills/vercel-react-native-skills/rules/_sections.md +86 -0
  177. package/templates/skills/vercel-react-native-skills/rules/_template.md +28 -0
  178. package/templates/skills/vercel-react-native-skills/rules/animation-derived-value.md +53 -0
  179. package/templates/skills/vercel-react-native-skills/rules/animation-gesture-detector-press.md +95 -0
  180. package/templates/skills/vercel-react-native-skills/rules/animation-gpu-properties.md +65 -0
  181. package/templates/skills/vercel-react-native-skills/rules/design-system-compound-components.md +66 -0
  182. package/templates/skills/vercel-react-native-skills/rules/fonts-config-plugin.md +71 -0
  183. package/templates/skills/vercel-react-native-skills/rules/imports-design-system-folder.md +68 -0
  184. package/templates/skills/vercel-react-native-skills/rules/js-hoist-intl.md +61 -0
  185. package/templates/skills/vercel-react-native-skills/rules/list-performance-callbacks.md +44 -0
  186. package/templates/skills/vercel-react-native-skills/rules/list-performance-function-references.md +132 -0
  187. package/templates/skills/vercel-react-native-skills/rules/list-performance-images.md +53 -0
  188. package/templates/skills/vercel-react-native-skills/rules/list-performance-inline-objects.md +97 -0
  189. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-expensive.md +94 -0
  190. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-memo.md +82 -0
  191. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-types.md +104 -0
  192. package/templates/skills/vercel-react-native-skills/rules/list-performance-virtualize.md +67 -0
  193. package/templates/skills/vercel-react-native-skills/rules/monorepo-native-deps-in-app.md +46 -0
  194. package/templates/skills/vercel-react-native-skills/rules/monorepo-single-dependency-versions.md +63 -0
  195. package/templates/skills/vercel-react-native-skills/rules/navigation-native-navigators.md +188 -0
  196. package/templates/skills/vercel-react-native-skills/rules/react-compiler-destructure-functions.md +50 -0
  197. package/templates/skills/vercel-react-native-skills/rules/react-compiler-reanimated-shared-values.md +48 -0
  198. package/templates/skills/vercel-react-native-skills/rules/react-state-dispatcher.md +91 -0
  199. package/templates/skills/vercel-react-native-skills/rules/react-state-fallback.md +56 -0
  200. package/templates/skills/vercel-react-native-skills/rules/react-state-minimize.md +65 -0
  201. package/templates/skills/vercel-react-native-skills/rules/rendering-no-falsy-and.md +74 -0
  202. package/templates/skills/vercel-react-native-skills/rules/rendering-text-in-text-component.md +36 -0
  203. package/templates/skills/vercel-react-native-skills/rules/scroll-position-no-state.md +82 -0
  204. package/templates/skills/vercel-react-native-skills/rules/state-ground-truth.md +80 -0
  205. package/templates/skills/vercel-react-native-skills/rules/ui-expo-image.md +66 -0
  206. package/templates/skills/vercel-react-native-skills/rules/ui-image-gallery.md +104 -0
  207. package/templates/skills/vercel-react-native-skills/rules/ui-measure-views.md +78 -0
  208. package/templates/skills/vercel-react-native-skills/rules/ui-menus.md +174 -0
  209. package/templates/skills/vercel-react-native-skills/rules/ui-native-modals.md +77 -0
  210. package/templates/skills/vercel-react-native-skills/rules/ui-pressable.md +61 -0
  211. package/templates/skills/vercel-react-native-skills/rules/ui-safe-area-scroll.md +65 -0
  212. package/templates/skills/vercel-react-native-skills/rules/ui-scrollview-content-inset.md +45 -0
  213. package/templates/skills/vercel-react-native-skills/rules/ui-styling.md +87 -0
package/dist/init.js CHANGED
@@ -15,8 +15,16 @@ const PLUGIN_MCP_NOTE = 'O plugin fontdata@ai-harness está habilitado: o servid
15
15
  const PERFIL_DELPHI_NOTE = 'Perfil Delphi instalado (projeto Delphi detectado): rules em .claude/rules/delphi/, a skill conhecimento-delphi e o ' +
16
16
  'hook de encoding em .claude/hooks/delphi/, registrado em .claude/settings.json; para recusar, use perfis.delphi: false ' +
17
17
  'no .ai-harness/config.json.';
18
+ const PERFIL_FISCAL_NOTE = 'Perfil delphi-fiscal instalado (projeto usa ACBr): rules em .claude/rules/delphi-fiscal/ e as skills patch-acbr e ' +
19
+ "diagnosticar-rejeicao-nfse; para recusar, use perfis[\"delphi-fiscal\"]: false no .ai-harness/config.json.";
18
20
  function resumo(plan, skippedForPlugin = false) {
19
- return [describePlan(plan), ...(skippedForPlugin ? [PLUGIN_HOOKS_NOTE] : []), ...(plan.registerPerfilDelphi ? [PERFIL_DELPHI_NOTE] : [])].join(EOL + EOL);
21
+ const fiscal = plan.items.some((item) => item.tipo === 'perfil' && item.id === 'delphi-fiscal');
22
+ return [
23
+ describePlan(plan),
24
+ ...(skippedForPlugin ? [PLUGIN_HOOKS_NOTE] : []),
25
+ ...(plan.registerPerfilDelphi ? [PERFIL_DELPHI_NOTE] : []),
26
+ ...(fiscal ? [PERFIL_FISCAL_NOTE] : []),
27
+ ].join(EOL + EOL);
20
28
  }
21
29
  /** Registra o MCP de banco no .mcp.json quando não foi recusado (flag, wizard ou config) e o plugin não o fornece. */
22
30
  export function decidirRegistroMcp(options, root, home = homedir()) {
@@ -1,9 +1,16 @@
1
- import { detectarDelphi } from '../delphi/classificar.js';
2
- export const PERFIS = ['delphi'];
1
+ import { PERFIS_DO_CONFIG } from '../config/config.js';
2
+ import { detectarAcbr, detectarDelphi } from '../delphi/classificar.js';
3
+ export const PERFIS = PERFIS_DO_CONFIG;
3
4
  export const PERFIL_DELPHI_HOOK_COMMAND = 'node "${CLAUDE_PROJECT_DIR}/.claude/hooks/delphi/encoding.mjs"';
4
- /** Perfis que o projeto recebe: a stack foi detectada e o config não guarda a recusa. */
5
+ /** Perfis que o projeto recebe: a stack foi detectada e o config não guarda a recusa. O fiscal depende do Delphi. */
5
6
  export function perfisDoProjeto(root, config) {
6
- return config.perfis.delphi && detectarDelphi(root) ? ['delphi'] : [];
7
+ if (!config.perfis.delphi || !detectarDelphi(root))
8
+ return [];
9
+ return config.perfis['delphi-fiscal'] && detectarAcbr(root) ? ['delphi', 'delphi-fiscal'] : ['delphi'];
10
+ }
11
+ /** A recusa do perfil no config; a do Delphi recusa também o fiscal. */
12
+ export function perfilRecusadoNoConfig(perfil, config) {
13
+ return !config.perfis.delphi || !config.perfis[perfil];
7
14
  }
8
15
  export function perfilDelphiHooksConfig() {
9
16
  const hooks = () => [{ type: 'command', command: PERFIL_DELPHI_HOOK_COMMAND }];
@@ -1,4 +1,4 @@
1
- function semComentariosPascal(texto) {
1
+ export function semComentariosPascal(texto) {
2
2
  return texto.replace(/\{[^}]*\}|\(\*[\s\S]*?\*\)|\/\/[^\n]*/g, (m) => m.replace(/[^\n]/g, ' '));
3
3
  }
4
4
  function simbolosPascal(texto) {
@@ -9,7 +9,7 @@ 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, perfisDoProjeto } from '../install/perfis.js';
12
+ import { PERFIL_DELPHI_HOOK_COMMAND, perfilDelphiHooksConfig, perfilRecusadoNoConfig, PERFIS, perfisDoProjeto } from '../install/perfis.js';
13
13
  import { neededSkillsFor } from '../install/selection.js';
14
14
  import { BANCO_PERMISSIONS_LEGADAS, combineHooks, HARNESS_DENY, harnessPermissions, hasAllowRule, hookCommands, mergeSettings, normalizarComandoHook, SETTINGS_PATH, } from '../install/settings.js';
15
15
  import { adoptLegacyInstall } from './legado.js';
@@ -19,6 +19,14 @@ function pastasDoItem(root, item) {
19
19
  const pastas = new Set(item.arquivos.map((entry) => `${entry.caminho.split('/').slice(0, 3).join('/')}/`));
20
20
  return [...pastas].filter((pasta) => existsSync(join(root, pasta))).sort();
21
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
+ }
22
30
  /** O settings do projeto já registra o hook do perfil em todos os eventos dele. */
23
31
  function perfilDelphiRegistrado(root) {
24
32
  let hooks;
@@ -33,6 +41,23 @@ function perfilDelphiRegistrado(root) {
33
41
  const comando = normalizarComandoHook(PERFIL_DELPHI_HOOK_COMMAND);
34
42
  return Object.keys(perfilDelphiHooksConfig()).every((evento) => hookCommands({ [evento]: hooks[evento] ?? [] }).map(normalizarComandoHook).includes(comando));
35
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
+ }
36
61
  function isPlainObject(value) {
37
62
  return typeof value === 'object' && value !== null && !Array.isArray(value);
38
63
  }
@@ -80,11 +105,15 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
80
105
  const changes = [];
81
106
  const stale = [];
82
107
  const { config } = readConfig(root);
83
- const itemPerfil = lock.itens.find((item) => `${item.tipo}:${item.id}` === PERFIL_DELPHI_ITEM);
84
- const perfilRecusado = itemPerfil && !config.perfis.delphi ? { pastas: pastasDoItem(root, itemPerfil) } : null;
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);
85
114
  for (const item of lock.itens) {
86
115
  const key = `${item.tipo}:${item.id}`;
87
- if (perfilRecusado && key === PERFIL_DELPHI_ITEM)
116
+ if (recusados.has(key))
88
117
  continue;
89
118
  const sources = itemSources(catalog, item.tipo, item.id) ?? [];
90
119
  const sourceByPath = new Map(sources.map((entry) => [entry.path, entry.source]));
@@ -125,8 +154,10 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
125
154
  continue;
126
155
  const target = join(root, path);
127
156
  const same = existsSync(target) && hashContent(readFileSync(target)) === hashContent(readFileSync(source));
128
- // O perfil entrou sem este arquivo porque ele já era do projeto: continua do projeto, mesmo com --forcar.
129
- if (!same && existsSync(target) && item.tipo === 'perfil')
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)
130
161
  continue;
131
162
  changes.push({ tipo: !existsSync(target) || same ? 'novo' : 'conflito', caminho: path, item: key, source });
132
163
  }
@@ -158,6 +189,15 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
158
189
  addItem('skill', skill.id, false);
159
190
  }
160
191
  }
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
+ }
161
201
  // Na adoção, a instalação antiga ganha o que a 2.1 instala e ela não tinha.
162
202
  const adotada = !recorded;
163
203
  const pluginHooks = adotada && isHarnessPluginEnabled(root, home);
@@ -169,6 +209,7 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
169
209
  }
170
210
  for (const id of agentsForaDoLock(catalog, lock))
171
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);
172
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
173
214
  // referência: o comando `comentarios` não registra a rule quando o projeto já tem uma própria.
174
215
  const querComentarios = !semComentarios && config.comentarios.instalar;
@@ -179,10 +220,10 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
179
220
  addItem('rule', 'comentarios', true);
180
221
  addItem('hook', 'comentarios', true);
181
222
  }
182
- const instalarPerfilDelphi = !itemPerfil && perfisDoProjeto(root, config).includes('delphi');
183
- if (instalarPerfilDelphi)
184
- addItem('perfil', 'delphi', true);
185
- const registrarPerfilDelphi = instalarPerfilDelphi || (!!itemPerfil && !perfilRecusado && !perfilDelphiRegistrado(root));
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));
186
227
  const registrarMcpConfig = config.banco_dados.registrar_mcp;
187
228
  const permissoesBanco = !semBanco && registrarMcpConfig;
188
229
  const permissoesFaltando = [
@@ -197,6 +238,7 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
197
238
  stale,
198
239
  adotada,
199
240
  registrarHooks: adotada && !pluginHooks,
241
+ registrarHooksNucleo,
200
242
  registrarComentarios,
201
243
  registrarHookComentarios,
202
244
  recusarComentarios: semComentarios && config.comentarios.instalar,
@@ -209,8 +251,8 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
209
251
  recusarMcp: semBanco && registrarMcpConfig,
210
252
  renomearSecaoBanco: temSecaoBancoLegada(root),
211
253
  registrarPerfilDelphi,
212
- instalarPerfilDelphi,
213
- perfilRecusado,
254
+ instalarPerfis,
255
+ perfisRecusados,
214
256
  };
215
257
  }
216
258
  /**
@@ -248,14 +290,14 @@ export function applyUpdate(root, report, options, pkg, now = new Date()) {
248
290
  renameSync(join(root, path), join(root, para));
249
291
  return { de: path, para };
250
292
  });
251
- const hooks = combineHooks(report.registrarHooks ? projectHooksConfig() : {}, report.registrarComentarios ? commentsHooksConfig() : {}, report.registrarPerfilDelphi ? perfilDelphiHooksConfig() : {});
293
+ const hooks = combineHooks(report.registrarHooks || report.registrarHooksNucleo ? projectHooksConfig() : {}, report.registrarComentarios ? commentsHooksConfig() : {}, report.registrarPerfilDelphi ? perfilDelphiHooksConfig() : {});
252
294
  const ajustes = [];
253
295
  const settings = mergeSettings(root, {
254
296
  hooks,
255
297
  allow: harnessPermissions({ banco: report.permissoesBanco }),
256
298
  deny: HARNESS_DENY,
257
299
  removeAllow: BANCO_PERMISSIONS_LEGADAS,
258
- removeHooks: report.perfilRecusado ? [PERFIL_DELPHI_HOOK_COMMAND] : [],
300
+ removeHooks: itensRecusados(report.perfisRecusados).has(PERFIL_DELPHI_ITEM) ? [PERFIL_DELPHI_HOOK_COMMAND] : [],
259
301
  }, now);
260
302
  if (settings.changed)
261
303
  ajustes.push(`${SETTINGS_PATH} atualizado${settings.backup ? ` (backup em ${settings.backup})` : ''}.`);
@@ -314,9 +356,10 @@ export function applyUpdate(root, report, options, pkg, now = new Date()) {
314
356
  const writtenHash = new Map(write.map((file) => [file.path, hashContent(file.content)]));
315
357
  const dropped = new Set([...remove, ...report.stale, ...legacy]);
316
358
  const itens = [];
359
+ const recusados = itensRecusados(report.perfisRecusados);
317
360
  for (const item of report.lock.itens) {
318
361
  const key = `${item.tipo}:${item.id}`;
319
- if (report.perfilRecusado && key === PERFIL_DELPHI_ITEM)
362
+ if (recusados.has(key))
320
363
  continue;
321
364
  const entries = new Map(item.arquivos.map((entry) => [entry.caminho, entry]));
322
365
  for (const [path, sha256] of writtenHash) {
@@ -376,6 +419,7 @@ export function describeUpdate(report) {
376
419
  'a rule de projeto e a permissão do `ai-harness evento`.',
377
420
  ]
378
421
  : [];
422
+ const nucleo = report.registrarHooksNucleo ? [`Faltam hooks do harness em ${SETTINGS_PATH}; o --yes registra os que faltam.`] : [];
379
423
  const permission = report.permissaoAusente && !report.adotada
380
424
  ? [
381
425
  `Faltam permissões do harness em .claude/settings.json (${report.permissoesFaltando.join(', ')}); o --yes as acrescenta.`,
@@ -408,8 +452,10 @@ export function describeUpdate(report) {
408
452
  ...(report.renomearSecaoBanco ? [`A seção banco de ${CONFIG_PATH} agora se chama banco_dados; o --yes a renomeia.`] : []),
409
453
  ...(report.recusarMcp ? [`--sem-banco-dados: o --yes grava banco_dados.registrar_mcp: false em ${CONFIG_PATH} e não registra o MCP.`] : []),
410
454
  ];
455
+ const delphiRecusado = report.perfisRecusados.find((recusa) => recusa.perfil === 'delphi');
456
+ const fiscalRecusado = report.perfisRecusados.find((recusa) => recusa.perfil === 'delphi-fiscal');
411
457
  const perfil = [
412
- ...(report.instalarPerfilDelphi
458
+ ...(report.instalarPerfis.includes('delphi')
413
459
  ? [
414
460
  'Projeto Delphi sem o perfil delphi: o --yes grava as rules em .claude/rules/delphi/, a skill conhecimento-delphi e o hook ' +
415
461
  `.claude/hooks/delphi/encoding.mjs, registrado em ${SETTINGS_PATH}. Para recusar, grave perfis.delphi: false em ${CONFIG_PATH}.`,
@@ -417,25 +463,36 @@ export function describeUpdate(report) {
417
463
  : report.registrarPerfilDelphi
418
464
  ? [`O hook do perfil delphi não está registrado em ${SETTINGS_PATH}; o --yes o registra.`]
419
465
  : []),
420
- ...(report.perfilRecusado
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
421
473
  ? [
422
474
  `perfis.delphi: false em ${CONFIG_PATH}: o --yes tira o perfil delphi do ${LOCK_PATH} e o registro do hook de ${SETTINGS_PATH}. ` +
423
- (report.perfilRecusado.pastas.length
424
- ? `Os arquivos do perfil são mantidos e podem ser apagados à mão: ${report.perfilRecusado.pastas.join(', ')}.`
425
- : 'Os arquivos do perfil já foram apagados.'),
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)}`,
426
482
  ]
427
483
  : []),
428
484
  ];
429
485
  if (!report.changes.length) {
430
- const status = adopted.length || comentarios.length || perfil.length || permission.length || legadas.length || mcp.length
486
+ const status = adopted.length || comentarios.length || perfil.length || nucleo.length || permission.length || legadas.length || mcp.length
431
487
  ? 'Nenhum arquivo a atualizar.'
432
488
  : 'A instalação está em dia: nenhum arquivo a atualizar.';
433
- return [...adopted, ...comentarios, ...perfil, ...permission, ...legadas, ...mcp, status].join('\n');
489
+ return [...adopted, ...comentarios, ...perfil, ...nucleo, ...permission, ...legadas, ...mcp, status].join('\n');
434
490
  }
435
491
  return [
436
492
  ...adopted,
437
493
  ...comentarios,
438
494
  ...perfil,
495
+ ...nucleo,
439
496
  ...permission,
440
497
  ...legadas,
441
498
  ...mcp,
@@ -478,7 +535,7 @@ export function runUpdateCommand(argv) {
478
535
  const report = checkUpdate(root, undefined, undefined, undefined, { semBanco: args.semBanco, semComentarios: args.semComentarios });
479
536
  console.log(describeUpdate(report));
480
537
  // Sem arquivo a atualizar, a adoção ainda grava o lock, e a permissão e o MCP ainda são acrescentados.
481
- const pendente = report.adotada || report.permissaoAusente || report.permissoesLegadas.length > 0 || report.mudancaMcp !== null || report.recusarMcp || report.recusarComentarios || report.registrarHookComentarios || report.renomearSecaoBanco || report.registrarPerfilDelphi || report.perfilRecusado !== null;
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;
482
539
  if (args.check || (!report.changes.length && !pendente))
483
540
  return 0;
484
541
  if (!args.yes) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fontdata/ai-harness",
3
- "version": "4.4.0",
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,10 +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." }
25
29
  ],
26
30
  "perfis": [
27
- { "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." }
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." }
28
33
  ],
29
34
  "groups": [
30
35
  {
@@ -74,8 +79,8 @@
74
79
  "commands": [
75
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 },
76
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 },
77
- { "id": "auditar-performance", "skill": "skills/auditar-performance", "title": "/auditar-performance", "description": "Audita gargalos de performance (queries, bundle, renders, algoritmos).", "recommended": false },
78
- { "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"] }
79
84
  ]
80
85
  },
81
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
+ });
@@ -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.