@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
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "fontdata",
3
- "version": "4.3.1",
3
+ "version": "4.5.0",
4
4
  "mcpServers": {
5
- "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.3.1", "banco-dados-mcp"] }
5
+ "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.5.0", "banco-dados-mcp"] }
6
6
  },
7
7
  "description": "Harness de engenharia com IA da Fontdata para Claude Code",
8
8
  "author": { "name": "Fontdata" },
package/README.md CHANGED
@@ -102,7 +102,7 @@ npx @fontdata/ai-harness init --comandos resolver-bug,nova-tarefa --sem-harness
102
102
  | `--yes` | Aplica; sem ele, só simula |
103
103
 
104
104
  Com o plugin `fontdata@ai-harness` habilitado, o `init` não instala os hooks no projeto, para eles não rodarem
105
- duas vezes.
105
+ duas vezes. A exceção é o hook do [perfil Delphi](#perfil-delphi), que não vem no plugin.
106
106
 
107
107
  ### Permissões para o modo auto
108
108
 
@@ -121,6 +121,119 @@ Ficam de fora os comandos de teste e build, que variam por projeto, e os que reg
121
121
  Nos modos 1 e 2 nada é gravado no projeto: rode `npx @fontdata/ai-harness update --yes` num projeto já instalado,
122
122
  ou `init`, para receber as regras.
123
123
 
124
+ ## Perfil Delphi
125
+
126
+ Quando o projeto tem `.dpr` ou `.dproj` (até 3 níveis de pasta ou versionado no git), o `init` e o `update` instalam o perfil Delphi. Vale também com o
127
+ plugin habilitado e com `--sem-hooks`: o perfil só chega pelo `init`/`update`, nunca pelo plugin, e sempre leva o
128
+ hook. Projeto sem Delphi não recebe nada. O perfil é um item só no lock (`perfil:delphi`), e o `doctor` confere os
129
+ arquivos dele como confere os demais.
130
+
131
+ | O que instala | Onde |
132
+ |---|---|
133
+ | 26 rules de Delphi: build e verificação, encoding e EOL, threads e timers, `try`/`finally`, linguagem, dados e SQL, telas | `.claude/rules/delphi/` |
134
+ | Skill `conhecimento-delphi`: índice e 14 artigos de armadilhas (`.dproj`, FireDAC, `.dpr`, recursos, Horse, ACBr, Delphi 13...) | `.claude/skills/conhecimento-delphi/` |
135
+ | Hook `delphi-encoding`, em `PreToolUse` (`Edit\|MultiEdit`) e `PostToolUse` (`Write\|Edit\|MultiEdit`) | `.claude/hooks/delphi/encoding.mjs` |
136
+
137
+ Cada rule lista no `paths:` do frontmatter as extensões que lhe dizem respeito, entre `.pas`, `.dfm`, `.dpr`,
138
+ `.dpk`, `.inc`, `.dproj` e `.sql`, e só entra no contexto quando o Claude mexe num desses arquivos. A skill é consultada sob demanda. Os 14 artigos são
139
+ adaptações em pt-BR do plugin [delphi-dev](https://github.com/adrianosantostreina/delphi-dev), sob licença MIT;
140
+ o aviso fica em `.claude/skills/conhecimento-delphi/references/ATRIBUICAO.md`.
141
+
142
+ O `update` não sobrescreve arquivo do projeto que já exista num caminho do perfil, nem com `--forcar`, e não apaga
143
+ rules do projeto que repetem uma rule do perfil: tirar a duplicata fica com você.
144
+
145
+ ### Perfil `delphi-fiscal`
146
+
147
+ Quando o projeto recebe o perfil Delphi e usa ACBr — algum `.dproj` (pelo mesmo critério de detecção do Delphi) ou o
148
+ `boss.json` da raiz cita `ACBr`, sem diferenciar maiúsculas —, o `init` e o `update` instalam também o perfil
149
+ `delphi-fiscal`, como o item `perfil:delphi-fiscal` no lock. Como o perfil Delphi, ele fica fora do plugin.
150
+
151
+ | O que instala | Onde |
152
+ |---|---|
153
+ | 4 rules de documento fiscal com ACBr: sucesso do webservice não prova o documento, campo novo do ACBr preenchido explicitamente, total de tributo como soma dos itens e retorno de evento da NF-e pelo `cStat` | `.claude/rules/delphi-fiscal/` |
154
+ | Skills `patch-acbr` e `diagnosticar-rejeicao-nfse` | `.claude/skills/patch-acbr/` e `.claude/skills/diagnosticar-rejeicao-nfse/` |
155
+
156
+ Para recusar, grave `"perfis": { "delphi-fiscal": false }` no `.ai-harness/config.json` e rode
157
+ `npx @fontdata/ai-harness update --yes`: o `update` tira o item do lock e **mantém** os arquivos. A recusa do perfil
158
+ Delphi (`perfis.delphi: false`) recusa também o fiscal e tira os dois itens do lock. Sem o perfil Delphi, por
159
+ recusa ou porque o projeto não é Delphi, o fiscal não é instalado.
160
+
161
+ ### Hook `delphi-encoding`
162
+
163
+ | Arquivo | Antes de `Edit`/`MultiEdit` | Depois de `Write`/`Edit`/`MultiEdit` |
164
+ |---|---|---|
165
+ | `.pas`, `.dpr`, `.dpk`, `.inc` | não é UTF-8 → **bloqueia** e mostra o `delphi encoding converter`; UTF-8 sem BOM → avisa | avisa BOM ausente, U+FFFD, dupla codificação (`é`, `â€`) e EOL misto novos |
166
+ | `.dfm` texto | nada: o encoding do `.dfm` é preservado, nunca convertido | avisa U+FFFD novo e EOL diferente do anterior |
167
+ | `.dfm` binário, `.dproj` e o resto | ignorado | ignorado |
168
+
169
+ "Novo" compara com a versão do arquivo no `HEAD`; arquivo fora do git conta como todo novo, então o aviso se repete
170
+ até o defeito ser corrigido ou commitado. O modo fica em `hooks["delphi-encoding"]` no `.ai-harness/config.json`:
171
+ `bloqueio` (padrão, sem precisar gravar), `aviso` ou `desligado`. Se o hook não consegue ler o evento ou o arquivo,
172
+ ele sai sem bloquear.
173
+
174
+ ### Configuração
175
+
176
+ ```json
177
+ {
178
+ "hooks": { "delphi-encoding": "aviso" },
179
+ "delphi": { "ignorar": ["**/modules/**", "**/ACBr*/**", "**/Terceiros/**"] }
180
+ }
181
+ ```
182
+
183
+ - **`delphi.ignorar`**: globs de arquivos que o hook e o `--todos` do comando pulam. `**` casa qualquer
184
+ profundidade, `*` casa dentro de um segmento; maiúsculas e minúsculas não importam, e `\` vale como separador.
185
+ Sem a chave, valem `['**/modules/**', '**/ACBr*/**']` (código de terceiros, que pode estar em ISO-8859-1 de
186
+ propósito); ao gravar a chave, repita esses dois se quiser mantê-los. Se o hook bloquear uma unit de terceiro,
187
+ acrescente a pasta dela aqui.
188
+ - **Recusar o perfil**: `"perfis": { "delphi": false }` e `npx @fontdata/ai-harness update --yes`. O `init` deixa de
189
+ instalar o perfil. Num projeto que já o tem, o `update` tira o item do lock e o registro do hook do
190
+ `.claude/settings.json` e **mantém** os arquivos; o relatório lista as pastas, que você pode apagar à mão. Depois
191
+ disso o `doctor` não acusa arquivo faltando.
192
+
193
+ Valor inválido em `delphi.ignorar` ou `perfis.delphi` é apontado pelo `doctor` como problema do config, e o padrão
194
+ vale.
195
+
196
+ ### Comando `delphi encoding`
197
+
198
+ ```bash
199
+ npx @fontdata/ai-harness delphi encoding detectar Unit1.pas Form1.dfm
200
+ npx @fontdata/ai-harness delphi encoding converter Unit1.pas
201
+ npx @fontdata/ai-harness delphi encoding checar --todos
202
+ ```
203
+
204
+ - `detectar <arquivos|--todos>`: encoding (UTF-8 com BOM, UTF-8 sem BOM, CP1252, `.dfm` binário) e EOL de cada
205
+ arquivo.
206
+ - `converter <arquivos>`: só `.pas`, `.dpr`, `.dpk` e `.inc` (recusa `.dfm`). UTF-8 com BOM fica intacto; UTF-8 sem
207
+ BOM ganha só o BOM; o resto é lido como CP1252 e gravado em UTF-8 com BOM, sem perder acentos, `€` e aspas curvas.
208
+ O EOL de cada linha não muda.
209
+ - `checar <arquivos|--todos>`: U+FFFD, dupla codificação, BOM ausente (nas extensões do `converter`) e EOL misto;
210
+ sai com código 1 se achar algum.
211
+
212
+ `--todos` pega os fontes Delphi versionados (`git ls-files`) fora de `delphi.ignorar`. Arquivo passado pelo nome é
213
+ processado mesmo que case com `delphi.ignorar`.
214
+
215
+ ### Comando `delphi catalogo`
216
+
217
+ ```bash
218
+ npx @fontdata/ai-harness delphi catalogo
219
+ npx @fontdata/ai-harness delphi catalogo --pasta ../Bibliotecas/Fontdata --check
220
+ ```
221
+
222
+ Gera o catálogo das Bibliotecas Fontdata em `.claude/skills/conhecimento-delphi/references/bibliotecas-fontdata.md`,
223
+ na raiz do projeto, que a skill `conhecimento-delphi` e a rule de reaproveitamento mandam consultar antes de criar um
224
+ helper. Por unit `Fontdata.*.pas`, ele traz os tipos públicos da `interface` e, de cada tipo, os métodos e as
225
+ propriedades `public` e `published`, com a assinatura; os class helpers trazem também o tipo que estendem. A lista de
226
+ fontes guarda o nome de cada unit e o `sha256` do conteúdo, sem caminho, então o catálogo pode ser versionado.
227
+
228
+ - Sem `--pasta`, as units são procuradas nas pastas do `DCC_UnitSearchPath` de todos os `.dproj` do projeto,
229
+ relativas à pasta de cada `.dproj`; entradas com `$(...)` são ignoradas. `--pasta <dir>`, que pode se repetir,
230
+ troca o search path pelas pastas informadas.
231
+ - `--check` não grava nada e sai com código 1 quando o catálogo falta ou diverge das units atuais.
232
+
233
+ Nenhuma unit encontrada é erro: passe `--pasta` com o caminho das Bibliotecas Fontdata. Num projeto com o perfil
234
+ Delphi e units `Fontdata.*` no search path, o `doctor` avisa `catalogo-fontdata-ausente` quando o catálogo não existe
235
+ e `catalogo-fontdata-desatualizado` quando ele não bate com as units; fora desse caso, não há aviso de catálogo.
236
+
124
237
  ## Conexões de banco de dados
125
238
 
126
239
  O Claude pode ler o banco do projeto (PostgreSQL, MariaDB ou SQLite) sem que ninguém cole credencial no chat. O
@@ -170,6 +283,9 @@ projeto, cadastro, limites do filtro, produção, mascaramento e dúvidas freque
170
283
  | `mapa [caminho]` | Símbolos públicos por pasta do código-fonte, pastas compartilhadas primeiro (`--limite <n>`, padrão 4000 caracteres) |
171
284
  | `atalhos [caminho]` | Lista os `TODO:`/`FIXME:` do código-fonte e marca os sem gatilho (`--sem-gatilho`, `--json`) |
172
285
  | `versao detectar\|calcular\|aplicar` | Fontes de versão do projeto, próxima versão e gravação nos arquivos (veja abaixo) |
286
+ | `delphi classificar\|extrair-icone` | Classifica os `.res` versionados de um projeto Delphi e extrai o ícone que só existe no `.res` |
287
+ | `delphi encoding detectar\|converter\|checar` | Encoding e EOL dos fontes Delphi: diagnóstico, conversão para UTF-8 com BOM e checagem (veja [Comando `delphi encoding`](#comando-delphi-encoding)) |
288
+ | `delphi catalogo` | Catálogo das units `Fontdata.*.pas` do search path dos `.dproj` (`--pasta <dir>`, `--check`; veja [Comando `delphi catalogo`](#comando-delphi-catalogo)) |
173
289
  | `list` | Lista o catálogo |
174
290
 
175
291
  O `mapa` lê TS/JS, Delphi, Python, C#, Java, Kotlin, Go, PHP, Rust e Dart. Outra linguagem, ou outra regra para uma
@@ -228,9 +344,29 @@ Os formatos estão em [`docs/contratos/ARTEFATOS.md`](docs/contratos/ARTEFATOS.m
228
344
  | `proteger-contratos` | SPEC, PLAN ou CLAUDE.md reescritos durante a execução de um trabalho | aviso |
229
345
  | `task-so-fecha-verde` | Task marcada como concluída sem suíte verde no rastro | aviso |
230
346
  | `sem-jargao` | Termo técnico no relatório para o cliente | aviso |
347
+ | `padroes-proibidos` | `Edit`, `MultiEdit` ou `Write` que introduz um padrão declarado em `.ai-harness/padroes.json` | aviso |
231
348
 
232
349
  O modo de cada hook (`aviso`, `bloqueio` ou `desligado`) fica em `.ai-harness/config.json`. Hook que falha
233
- internamente não atrapalha o trabalho — exceto o de segurança em modo bloqueio.
350
+ internamente não atrapalha o trabalho — exceto o de segurança em modo bloqueio. Projetos Delphi recebem também o
351
+ hook `delphi-encoding`, do [perfil Delphi](#perfil-delphi).
352
+
353
+ O `padroes-proibidos` vale para qualquer stack e só age no projeto que cria o `.ai-harness/padroes.json`; sem o
354
+ arquivo, ou com a lista vazia, ele não faz nada. Cada entrada traz as extensões, a regex, os flags e o motivo
355
+ mostrado ao agente. Só o padrão **introduzido** é acusado: o hook conta as ocorrências no texto antigo e no novo
356
+ (`old_string` contra `new_string` no `Edit`, a soma das `edits` no `MultiEdit`, o arquivo em disco contra o
357
+ `content` no `Write`) e acusa quando o novo tem mais. Dos flags, valem só `i`, `m`, `s` e `u`; uma entrada com regex
358
+ que não compila ou com campo faltando é ignorada, e as demais continuam valendo. Em `aviso` o motivo entra como
359
+ contexto, em `bloqueio` a edição é negada. O `update` registra no `.claude/settings.json` os hooks do núcleo que
360
+ faltam num projeto sem plugin e com os hooks do harness no lock, então um hook tirado à mão do settings volta no próximo `update`: para desligar, grave
361
+ `hooks["<nome>"]: "desligado"` no `.ai-harness/config.json`, por exemplo `"hooks": { "padroes-proibidos": "desligado" }`.
362
+
363
+ ```json
364
+ {
365
+ "padroes": [
366
+ { "extensoes": [".pas"], "regex": "Clipboard\\s*\\.\\s*AsText\\s*:=", "flags": "i", "motivo": "Use o helper de clipboard do projeto." }
367
+ ]
368
+ }
369
+ ```
234
370
 
235
371
  ### Agents somente leitura
236
372
 
@@ -272,7 +408,7 @@ também acionado pelo modelo quando o pedido combina.
272
408
  - `/memoria` **(skill)** — mostra quem já mexeu num arquivo e por quê e aponta regressões candidatas de um bug
273
409
  - `/auditar-ui` **(skill)** — navega a aplicação via Playwright MCP e audita UX/UI e acessibilidade
274
410
  - `/auditar-performance` **(skill)** — mede e audita gargalos de performance
275
- - `/auditar-seguranca` **(skill)** — auditoria defensiva de segurança e conformidade com a LGPD
411
+ - `/auditar-seguranca` **(skill)** — auditoria defensiva de segurança e conformidade com a LGPD, com os perfis `quick` (padrão), `standard` e `deep` (`/auditar-seguranca deep`); no fim, oferece criar o trabalho de correção, com uma task por achado
276
412
 
277
413
  ### Utilitário
278
414
  - `/git-commit-push` ⭐ — gera a mensagem (PT-BR, Conventional Commits) e faz add, commit e push
@@ -300,6 +436,21 @@ A skill `lgpd-checker`, usada pela auditoria de segurança, é uma cópia vendor
300
436
  [bittencourtthulio/lgpd-checker](https://github.com/bittencourtthulio/lgpd-checker); veja
301
437
  `templates/skills/lgpd-checker/ORIGEM.md`.
302
438
 
439
+ As outras skills e referências de terceiros também são cópias vendorizadas, sem alteração no conteúdo e com a
440
+ licença MIT de origem. Créditos aos autores:
441
+
442
+ - `security-audit`, da Cloudflare — [cloudflare/security-audit-skill](https://github.com/cloudflare/security-audit-skill);
443
+ usada pelo `/auditar-seguranca`. Veja `templates/skills/security-audit/ORIGEM.md`.
444
+ - `vercel-react-best-practices`, da Vercel — [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills);
445
+ usada pelo `/auditar-performance`. Veja `templates/skills/vercel-react-best-practices/ORIGEM.md`.
446
+ - `vercel-react-native-skills`, da Vercel — [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills);
447
+ usada pelo `/auditar-performance`. Veja `templates/skills/vercel-react-native-skills/ORIGEM.md`.
448
+ - `supabase-postgres-best-practices`, da Supabase — [supabase/agent-skills](https://github.com/supabase/agent-skills);
449
+ usada pelo `/auditar-performance`. Veja `templates/skills/supabase-postgres-best-practices/ORIGEM.md`.
450
+ - Web Interface Guidelines, da Vercel — [vercel-labs/web-interface-guidelines](https://github.com/vercel-labs/web-interface-guidelines);
451
+ referência do `/auditar-ui`, em `templates/skills/auditar-ui/references/web-interface-guidelines.md`. Veja
452
+ `templates/skills/auditar-ui/references/ATRIBUICAO.md`.
453
+
303
454
  ## Fluxo recomendado
304
455
 
305
456
  O jeito mais simples é rodar **`/harness`**, que pergunta se o projeto é novo ou existente e conduz as etapas:
package/dist/cli.js CHANGED
@@ -72,6 +72,7 @@ Gerenciar:
72
72
  banco-dados-mcp Servidor MCP de leitura do banco, usado pelo Claude Code (stdio)
73
73
  versao detectar|calcular|aplicar Fontes de versão, próxima versão e gravação (--app, --json; aplicar --dry-run)
74
74
  delphi classificar|extrair-icone .res de projetos Delphi: classificação e extração do ícone
75
+ delphi catalogo Catálogo da API das units Fontdata.*.pas do search path (--pasta <dir>, --check)
75
76
  mapa [caminho] Símbolos públicos por pasta, compartilhadas primeiro (--limite <n>, padrão 4000 caracteres)
76
77
  atalhos [caminho] TODO:/FIXME: do código-fonte, marcando os sem gatilho (--sem-gatilho, --json)
77
78
  list Lista todos os comandos disponíveis no catálogo
@@ -10,9 +10,12 @@ export const DEFAULT_HOOK_MODES = {
10
10
  'task-so-fecha-verde': 'aviso',
11
11
  'proteger-contratos': 'aviso',
12
12
  'sem-jargao': 'aviso',
13
+ 'padroes-proibidos': 'aviso',
13
14
  };
14
15
  export const MODOS_PRODUCAO = ['aviso', 'bloqueio'];
15
16
  export const TIPOS_CONEXAO_PROJETO = ['postgres', 'mariadb', 'sqlite'];
17
+ export const PERFIS_DO_CONFIG = ['delphi', 'delphi-fiscal'];
18
+ export const DELPHI_IGNORAR_PADRAO = ['**/modules/**', '**/ACBr*/**'];
16
19
  function isObject(value) {
17
20
  return typeof value === 'object' && value !== null && !Array.isArray(value);
18
21
  }
@@ -73,6 +76,8 @@ export function defaultConfig() {
73
76
  declarado: false,
74
77
  },
75
78
  comentarios: { instalar: true },
79
+ perfis: { delphi: true, 'delphi-fiscal': true },
80
+ delphi: { ignorar: [...DELPHI_IGNORAR_PADRAO] },
76
81
  };
77
82
  }
78
83
  function inteiroEntre(value, min, max) {
@@ -239,6 +244,22 @@ export function readConfig(root) {
239
244
  else
240
245
  problems.push(`comentarios.instalar deve ser true ou false em ${CONFIG_PATH}.`);
241
246
  }
247
+ for (const perfil of PERFIS_DO_CONFIG) {
248
+ if (!isObject(raw.perfis) || !(perfil in raw.perfis))
249
+ continue;
250
+ const valor = raw.perfis[perfil];
251
+ if (typeof valor === 'boolean')
252
+ config.perfis[perfil] = valor;
253
+ else
254
+ problems.push(`perfis.${perfil} deve ser true ou false em ${CONFIG_PATH}.`);
255
+ }
256
+ if (isObject(raw.delphi) && 'ignorar' in raw.delphi) {
257
+ const ignorar = raw.delphi.ignorar;
258
+ if (Array.isArray(ignorar) && ignorar.every((glob) => typeof glob === 'string'))
259
+ config.delphi.ignorar = ignorar;
260
+ else
261
+ problems.push(`delphi.ignorar deve ser uma lista de globs (texto) em ${CONFIG_PATH}; valem os padrões.`);
262
+ }
242
263
  const secao = soSecaoLegada(raw) ? raw[BANCO_CHAVE_LEGADA] : raw[BANCO_CHAVE];
243
264
  if (isObject(secao))
244
265
  lerBanco(secao, config.banco_dados, problems);
@@ -250,12 +271,12 @@ export function readConfig(root) {
250
271
  }
251
272
  return { config, problems };
252
273
  }
253
- /** Os padrões que vão para o arquivo: sem as seções banco_dados e comentarios, que só entram quando mudam. */
274
+ /** Os padrões que vão para o arquivo: sem as seções banco_dados, comentarios, perfis e delphi, que só entram quando mudam. */
254
275
  function configGravada() {
255
- const { banco_dados: _banco, comentarios: _comentarios, ...gravada } = defaultConfig();
276
+ const { banco_dados: _banco, comentarios: _comentarios, perfis: _perfis, delphi: _delphi, ...gravada } = defaultConfig();
256
277
  return gravada;
257
278
  }
258
- /** Cria a config com os padrões, sem as seções banco_dados e comentarios; retorna false se já existia (nunca sobrescreve). */
279
+ /** Cria a config com os padrões, sem as seções que só entram quando mudam; retorna false se já existia (nunca sobrescreve). */
259
280
  export function writeDefaultConfig(root) {
260
281
  const file = join(root, CONFIG_PATH);
261
282
  if (existsSync(file))
@@ -373,6 +394,27 @@ export function gravarInstalarComentarios(root, valor) {
373
394
  mkdirSync(dirname(file), { recursive: true });
374
395
  writeFileSync(file, `${JSON.stringify(proxima, null, 2)}\n`);
375
396
  }
397
+ /**
398
+ * Grava a recusa do perfil (`perfis.<id>: false`), preservando o resto do JSON; sem config, cria uma com os padrões e
399
+ * essa chave. `true` desfaz a recusa apagando a chave, e não cria o arquivo. JSON inválido é recusado sem tocar no
400
+ * arquivo.
401
+ */
402
+ export function gravarPerfil(root, perfil, valor) {
403
+ const file = join(root, CONFIG_PATH);
404
+ if (!existsSync(file) && valor)
405
+ return;
406
+ const raw = existsSync(file) ? lerJsonParaEscrita(file, `perfis.${perfil}`) : configGravada();
407
+ const { [perfil]: atual, ...resto } = isObject(raw.perfis) ? raw.perfis : {};
408
+ if (valor ? atual === undefined || atual === true : atual === false)
409
+ return;
410
+ const { perfis: _perfis, ...semSecao } = raw;
411
+ const proxima = valor ? (Object.keys(resto).length ? { ...raw, perfis: resto } : semSecao) : { ...raw, perfis: { ...resto, [perfil]: false } };
412
+ mkdirSync(dirname(file), { recursive: true });
413
+ writeFileSync(file, `${JSON.stringify(proxima, null, 2)}\n`);
414
+ }
415
+ export function gravarPerfilDelphi(root, valor) {
416
+ gravarPerfil(root, 'delphi', valor);
417
+ }
376
418
  const BLOCK_START = '# ai-harness (gerenciado pelo harness; não edite entre estas linhas)';
377
419
  const BLOCK_END = '# /ai-harness';
378
420
  /**
@@ -0,0 +1,299 @@
1
+ import { existsSync, readdirSync, readFileSync } from 'node:fs';
2
+ import { dirname, join, resolve } from 'node:path';
3
+ import { hashContent } from '../install/lock.js';
4
+ import { semComentariosPascal } from '../mapa/extratores/pascal.js';
5
+ import { arquivosDproj } from './classificar.js';
6
+ export const CAMINHO_CATALOGO = '.claude/skills/conhecimento-delphi/references/bibliotecas-fontdata.md';
7
+ const VISIBILIDADE = /^(strict\s+private|strict\s+protected|private|protected|public|published|automated)\b\s*/i;
8
+ const SECAO_DO_TIPO = /^(class\s+var|type|const|var|threadvar|resourcestring)\b\s*/i;
9
+ const SECAO_DO_TOPO = /^(type|const|var|threadvar|resourcestring)\b\s*/i;
10
+ const ATRIBUTO = /^\[[^\]]*\]\s*/;
11
+ const MEMBRO = /^(class\s+)?(function|procedure|constructor|destructor|property|operator)\b/i;
12
+ const ROTINA = /^(function|procedure)\b/i;
13
+ const DIRETIVA = /^(overload|override|virtual|dynamic|abstract|reintroduce|static|inline|stdcall|cdecl|register|safecall|pascal|final|default|nodefault|deprecated|platform|experimental|message|dispid|varargs|external|assembler)\b(?!\s*[:=])/i;
14
+ const CABECALHO = /^([A-Za-z_]\w*(?:\s*<[^>]*>)?)\s*=\s*(.*)$/;
15
+ const HELPER = /^((?:class|record)\s+helper\s*(?:\([^)]*\))?\s+for\s+[\w.]+(?:\s*<[^>]*>)?)\s*(.*)$/i;
16
+ const ESTRUTURA = /^((?:packed\s+)?(class|record|object|interface|dispinterface)\b(?:\s+(?:sealed|abstract))?\s*(?:\([^)]*\))?\s*(?:\[[^\]]*\])?)\s*(.*)$/i;
17
+ const RECORD_ANONIMO = /^[\w\s,]+:\s*(packed\s+)?record\b\s*(.*)$/i;
18
+ export function pastasDoSearchPath(raiz) {
19
+ const pastas = [];
20
+ for (const rel of arquivosDproj(raiz)) {
21
+ const dproj = join(raiz, rel);
22
+ let xml;
23
+ try {
24
+ xml = readFileSync(dproj, 'utf8');
25
+ }
26
+ catch {
27
+ continue;
28
+ }
29
+ for (const grupo of xml.matchAll(/<DCC_UnitSearchPath>([\s\S]*?)<\/DCC_UnitSearchPath>/gi)) {
30
+ for (const entrada of (grupo[1] ?? '').split(';')) {
31
+ const caminho = entrada.trim().replace(/\\/g, '/');
32
+ if (!caminho || caminho.includes('$('))
33
+ continue;
34
+ const pasta = resolve(dirname(dproj), caminho);
35
+ if (!pastas.includes(pasta))
36
+ pastas.push(pasta);
37
+ }
38
+ }
39
+ }
40
+ return pastas;
41
+ }
42
+ export function acharUnitsFontdata(pastas) {
43
+ const units = new Map();
44
+ for (const pasta of pastas) {
45
+ let arquivos;
46
+ try {
47
+ arquivos = readdirSync(pasta).sort();
48
+ }
49
+ catch {
50
+ continue;
51
+ }
52
+ for (const arquivo of arquivos) {
53
+ const nome = arquivo.slice(0, -'.pas'.length);
54
+ if (!/^Fontdata\..+\.pas$/i.test(arquivo) || units.has(nome.toLowerCase()))
55
+ continue;
56
+ try {
57
+ units.set(nome.toLowerCase(), { nome, conteudo: readFileSync(join(pasta, arquivo)) });
58
+ }
59
+ catch {
60
+ continue;
61
+ }
62
+ }
63
+ }
64
+ return [...units.values()].sort((a, b) => (a.nome < b.nome ? -1 : a.nome > b.nome ? 1 : 0));
65
+ }
66
+ function semStrings(texto) {
67
+ return texto.replace(/'[^'\n]*'/g, (m) => m.replace(/[^\n]/g, ' '));
68
+ }
69
+ function mascararStrings(fonte) {
70
+ let saida = '';
71
+ let fimDoComentario = null;
72
+ let emString = false;
73
+ for (let i = 0; i < fonte.length; i++) {
74
+ const c = fonte[i];
75
+ if (fimDoComentario) {
76
+ if (fonte.startsWith(fimDoComentario, i) && fimDoComentario.length > 1) {
77
+ saida += fimDoComentario;
78
+ i += fimDoComentario.length - 1;
79
+ fimDoComentario = null;
80
+ continue;
81
+ }
82
+ if (c === fimDoComentario)
83
+ fimDoComentario = null;
84
+ saida += c;
85
+ }
86
+ else if (emString) {
87
+ if (c === "'" && fonte[i + 1] === "'") {
88
+ saida += '__';
89
+ i++;
90
+ continue;
91
+ }
92
+ if (c === "'" || c === '\n')
93
+ emString = false;
94
+ saida += c === "'" || c === '\n' ? c : '_';
95
+ }
96
+ else {
97
+ if (c === "'")
98
+ emString = true;
99
+ else if (c === '{')
100
+ fimDoComentario = '}';
101
+ else if (c === '/' && fonte[i + 1] === '/')
102
+ fimDoComentario = '\n';
103
+ else if (c === '(' && fonte[i + 1] === '*')
104
+ fimDoComentario = '*)';
105
+ saida += c;
106
+ }
107
+ }
108
+ return saida;
109
+ }
110
+ function semComentariosPreservandoStrings(fonte) {
111
+ const mascarado = mascararStrings(fonte);
112
+ const limpo = semComentariosPascal(mascarado);
113
+ let saida = '';
114
+ for (let i = 0; i < limpo.length; i++)
115
+ saida += limpo[i] === '_' && mascarado[i] === '_' ? fonte[i] : limpo[i];
116
+ return saida;
117
+ }
118
+ function declaracoesDaInterface(fonte) {
119
+ const limpo = semComentariosPreservandoStrings(fonte);
120
+ const inicio = /^\s*interface\b/im.exec(limpo);
121
+ if (!inicio)
122
+ return [];
123
+ const resto = limpo.slice(inicio.index + inicio[0].length);
124
+ const fim = /^\s*implementation\b/im.exec(resto);
125
+ const secao = fim ? resto.slice(0, fim.index) : resto;
126
+ const mascara = semStrings(secao);
127
+ const declaracoes = [];
128
+ let profundidade = 0;
129
+ let comeco = 0;
130
+ for (let i = 0; i < mascara.length; i++) {
131
+ const c = mascara[i];
132
+ if (c === '(' || c === '[')
133
+ profundidade++;
134
+ else if ((c === ')' || c === ']') && profundidade > 0)
135
+ profundidade--;
136
+ else if (c === ';' && profundidade === 0) {
137
+ declaracoes.push(secao.slice(comeco, i).replace(/\s+/g, ' ').trim());
138
+ comeco = i + 1;
139
+ }
140
+ }
141
+ return declaracoes;
142
+ }
143
+ function abrirTipo(definicao) {
144
+ if (/^class\s+of\b/i.test(definicao))
145
+ return null;
146
+ const abertura = HELPER.exec(definicao) ?? ESTRUTURA.exec(definicao);
147
+ if (!abertura)
148
+ return null;
149
+ const cabeca = (abertura[1] ?? '').replace(/\s*\[[^\]]*\]$/, '').trim();
150
+ return { cabeca, corpo: abertura[abertura.length - 1] ?? '' };
151
+ }
152
+ export function extrairApi(fonte) {
153
+ const api = { tipos: [], rotinas: [] };
154
+ const abertos = [];
155
+ let secaoDeTipos = false;
156
+ let ultimo = null;
157
+ for (const declaracao of declaracoesDaInterface(fonte)) {
158
+ let resto = declaracao;
159
+ while (resto) {
160
+ resto = resto.replace(ATRIBUTO, '');
161
+ const topo = abertos[abertos.length - 1];
162
+ if (DIRETIVA.test(resto)) {
163
+ if (ultimo && ultimo.length > 0)
164
+ ultimo[ultimo.length - 1] += ` ${resto};`;
165
+ break;
166
+ }
167
+ if (topo) {
168
+ const visibilidade = VISIBILIDADE.exec(resto);
169
+ if (visibilidade) {
170
+ topo.visivel = /^(public|published|automated)$/i.test(visibilidade[1] ?? '');
171
+ resto = resto.slice(visibilidade[0].length);
172
+ continue;
173
+ }
174
+ const fim = /^end\b\s*/i.exec(resto);
175
+ if (fim) {
176
+ abertos.pop();
177
+ resto = resto.slice(fim[0].length);
178
+ continue;
179
+ }
180
+ const secao = SECAO_DO_TIPO.exec(resto);
181
+ if (secao) {
182
+ resto = resto.slice(secao[0].length);
183
+ continue;
184
+ }
185
+ if (MEMBRO.test(resto)) {
186
+ const publico = abertos.length === 1 && topo.visivel && topo.tipo;
187
+ if (publico)
188
+ topo.tipo.membros.push(`${resto};`);
189
+ ultimo = publico ? topo.tipo.membros : null;
190
+ break;
191
+ }
192
+ const anonimo = RECORD_ANONIMO.exec(resto);
193
+ const aninhado = anonimo ? null : CABECALHO.exec(resto);
194
+ const corpo = anonimo ? (anonimo[2] ?? '') : (abrirTipo(aninhado?.[2] ?? '')?.corpo ?? '');
195
+ ultimo = null;
196
+ if (!corpo)
197
+ break;
198
+ abertos.push({ visivel: false });
199
+ resto = corpo;
200
+ continue;
201
+ }
202
+ const secao = SECAO_DO_TOPO.exec(resto);
203
+ if (secao) {
204
+ secaoDeTipos = /^type$/i.test(secao[1] ?? '');
205
+ resto = resto.slice(secao[0].length);
206
+ continue;
207
+ }
208
+ if (/^uses\b/i.test(resto))
209
+ break;
210
+ if (ROTINA.test(resto)) {
211
+ api.rotinas.push(`${resto};`);
212
+ ultimo = api.rotinas;
213
+ secaoDeTipos = false;
214
+ break;
215
+ }
216
+ const cabecalho = secaoDeTipos ? CABECALHO.exec(resto) : null;
217
+ if (!cabecalho) {
218
+ ultimo = null;
219
+ break;
220
+ }
221
+ const nome = (cabecalho[1] ?? '').replace(/\s+/g, '');
222
+ const definicao = cabecalho[2] ?? '';
223
+ const abertura = abrirTipo(definicao);
224
+ ultimo = null;
225
+ if (!abertura) {
226
+ api.tipos.push({ nome, declaracao: definicao, membros: [] });
227
+ break;
228
+ }
229
+ const { cabeca, corpo } = abertura;
230
+ if (!corpo && /^(class|interface|dispinterface)$/i.test(cabeca))
231
+ break;
232
+ const tipo = { nome, declaracao: cabeca, membros: [] };
233
+ api.tipos.push(tipo);
234
+ if (!corpo)
235
+ break;
236
+ abertos.push({ tipo, visivel: true });
237
+ resto = corpo;
238
+ }
239
+ }
240
+ return api;
241
+ }
242
+ function renderizarUnit(unit) {
243
+ const { tipos, rotinas } = extrairApi(unit.conteudo.toString('utf8').replace(/^/, ''));
244
+ const linhas = [`## ${unit.nome}`, ''];
245
+ if (tipos.length === 0 && rotinas.length === 0)
246
+ linhas.push('Nada público na `interface`.', '');
247
+ for (const tipo of tipos) {
248
+ linhas.push(`### \`${tipo.nome} = ${tipo.declaracao}\``, '');
249
+ if (tipo.membros.length > 0)
250
+ linhas.push(...tipo.membros.map((m) => `- \`${m}\``), '');
251
+ }
252
+ if (rotinas.length > 0)
253
+ linhas.push('### Rotinas', '', ...rotinas.map((r) => `- \`${r}\``), '');
254
+ return linhas;
255
+ }
256
+ export function gerarCatalogo(units) {
257
+ const linhas = [
258
+ '# Catálogo das units Fontdata',
259
+ '',
260
+ 'Gerado por `npx @fontdata/ai-harness delphi catalogo` a partir das units `Fontdata.*.pas` do search path do',
261
+ 'projeto. Antes de criar um helper ou utilitário, procure aqui o que já existe. Não edite à mão: quando as units',
262
+ 'mudarem, rode o comando de novo.',
263
+ '',
264
+ '## Fontes',
265
+ '',
266
+ '| Unit | sha256 |',
267
+ '|---|---|',
268
+ ...units.map((unit) => `| ${unit.nome} | ${hashContent(unit.conteudo)} |`),
269
+ '',
270
+ ...units.flatMap(renderizarUnit),
271
+ ];
272
+ return `${linhas.join('\n').trimEnd()}\n`;
273
+ }
274
+ export function lerFontesDoCatalogo(texto) {
275
+ const fontes = new Map();
276
+ for (const linha of texto.split(/\r?\n/)) {
277
+ const fonte = /^\| (Fontdata\.[^|\s]+) \| ([0-9a-f]{64}) \|$/.exec(linha);
278
+ if (fonte)
279
+ fontes.set(fonte[1], fonte[2]);
280
+ }
281
+ return fontes;
282
+ }
283
+ export function estadoDoCatalogo(arquivo, units) {
284
+ if (units.length === 0)
285
+ return 'sem-units';
286
+ if (!existsSync(arquivo))
287
+ return 'ausente';
288
+ const fontes = lerFontesDoCatalogo(readFileSync(arquivo, 'utf8'));
289
+ const emDia = fontes.size === units.length && units.every((unit) => fontes.get(unit.nome) === hashContent(unit.conteudo));
290
+ return emDia ? 'em-dia' : 'desatualizado';
291
+ }
292
+ /**
293
+ * Estado do catálogo gravado na raiz contra as units `Fontdata.*.pas` do search path dos `.dproj`, ou das
294
+ * `pastas` informadas. `sem-units` quando nenhuma unit é encontrada, caso em que não há o que avisar.
295
+ */
296
+ export function checarCatalogo(raiz, pastas) {
297
+ const units = acharUnitsFontdata(pastas ?? pastasDoSearchPath(raiz));
298
+ return estadoDoCatalogo(join(raiz, CAMINHO_CATALOGO), units);
299
+ }
@@ -13,6 +13,27 @@ export function detectarDelphi(raiz) {
13
13
  return true;
14
14
  return Boolean(git(raiz, ['ls-files', '--', ':(icase)*.dproj', ':(icase)*.dpr'])?.trim());
15
15
  }
16
+ /** Os `.dproj` do projeto pelo critério de `detectarDelphi`: até 3 níveis de pasta, mais os versionados no git. */
17
+ export function arquivosDproj(raiz) {
18
+ const achados = new Set(varrerArquivos(raiz, '', 3, /\.dproj$/i));
19
+ for (const nome of git(raiz, ['ls-files', '--', ':(icase)*.dproj'])?.split('\n') ?? []) {
20
+ if (nome)
21
+ achados.add(nome);
22
+ }
23
+ return [...achados].sort();
24
+ }
25
+ function citaAcbr(arquivo) {
26
+ try {
27
+ return /acbr/i.test(readFileSync(arquivo, 'utf8'));
28
+ }
29
+ catch {
30
+ return false;
31
+ }
32
+ }
33
+ /** Algum `.dproj` ou o `boss.json` da raiz cita ACBr, sem diferenciar maiúsculas. */
34
+ export function detectarAcbr(raiz) {
35
+ return citaAcbr(join(raiz, 'boss.json')) || arquivosDproj(raiz).some((rel) => citaAcbr(join(raiz, rel)));
36
+ }
16
37
  export function emRepositorioGit(raiz) {
17
38
  return git(raiz, ['rev-parse', '--is-inside-work-tree'])?.trim() === 'true';
18
39
  }