@fontdata/ai-harness 4.4.0 → 4.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (214) hide show
  1. package/.claude-plugin/plugin.json +2 -2
  2. package/README.md +94 -1
  3. package/dist/cli.js +1 -0
  4. package/dist/config/config.js +24 -13
  5. package/dist/delphi/catalogo.js +308 -0
  6. package/dist/delphi/classificar.js +27 -2
  7. package/dist/delphi/command.js +50 -2
  8. package/dist/delphi/uses.js +90 -0
  9. package/dist/doctor/checks.js +37 -1
  10. package/dist/init.js +9 -1
  11. package/dist/install/perfis.js +15 -4
  12. package/dist/mapa/extratores/pascal.js +1 -1
  13. package/dist/update/update.js +80 -23
  14. package/package.json +1 -1
  15. package/templates/CLAUDE.md +2 -1
  16. package/templates/catalog.json +9 -4
  17. package/templates/hooks/comentarios/check.mjs +62 -5
  18. package/templates/hooks/hooks.json +2 -1
  19. package/templates/hooks/lib/config.mjs +1 -0
  20. package/templates/hooks/padroes-proibidos.mjs +68 -0
  21. package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md +6 -6
  22. package/templates/perfis/delphi/skills/conhecimento-delphi/SKILL.md +6 -0
  23. package/templates/perfis/delphi-fiscal/rules/campo-novo-acbr-preenchimento-explicito.md +61 -0
  24. package/templates/perfis/delphi-fiscal/rules/retorno-de-evento-nfe-pelo-cstat.md +51 -0
  25. package/templates/perfis/delphi-fiscal/rules/sucesso-de-webservice-fiscal-nao-prova-documento.md +100 -0
  26. package/templates/perfis/delphi-fiscal/rules/total-tributo-acbr-soma-itens.md +63 -0
  27. package/templates/perfis/delphi-fiscal/skills/diagnosticar-rejeicao-nfse/SKILL.md +155 -0
  28. package/templates/perfis/delphi-fiscal/skills/patch-acbr/SKILL.md +143 -0
  29. package/templates/skills/auditar-performance/SKILL.md +9 -0
  30. package/templates/skills/auditar-performance/references/pontos-quentes.md +8 -0
  31. package/templates/skills/auditar-seguranca/SKILL.md +55 -14
  32. package/templates/skills/auditar-seguranca/templates/relatorios/TECNICO.md +5 -0
  33. package/templates/skills/auditar-ui/SKILL.md +18 -3
  34. package/templates/skills/auditar-ui/references/ATRIBUICAO.md +44 -0
  35. package/templates/skills/auditar-ui/references/web-interface-guidelines.md +191 -0
  36. package/templates/skills/harness/references/validar-ideia.md +7 -6
  37. package/templates/skills/security-audit/AI-AND-LLM.md +83 -0
  38. package/templates/skills/security-audit/ATTACK-CLASSES.md +130 -0
  39. package/templates/skills/security-audit/CLIENT-SIDE.md +83 -0
  40. package/templates/skills/security-audit/CLOUD-AND-DEPLOYMENT.md +86 -0
  41. package/templates/skills/security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -0
  42. package/templates/skills/security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -0
  43. package/templates/skills/security-audit/HUNTING.md +251 -0
  44. package/templates/skills/security-audit/LICENSE +21 -0
  45. package/templates/skills/security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -0
  46. package/templates/skills/security-audit/ORIGEM.md +51 -0
  47. package/templates/skills/security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -0
  48. package/templates/skills/security-audit/RECONNAISSANCE.md +156 -0
  49. package/templates/skills/security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -0
  50. package/templates/skills/security-audit/SKILL.md +192 -0
  51. package/templates/skills/security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -0
  52. package/templates/skills/security-audit/VALIDATION-AND-REPORTING.md +186 -0
  53. package/templates/skills/security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -0
  54. package/templates/skills/security-audit/report-schema.json +461 -0
  55. package/templates/skills/security-audit/validate-coverage-ledger.cjs +872 -0
  56. package/templates/skills/security-audit/validate-findings.cjs +773 -0
  57. package/templates/skills/supabase-postgres-best-practices/CHANGELOG.md +73 -0
  58. package/templates/skills/supabase-postgres-best-practices/LICENSE +21 -0
  59. package/templates/skills/supabase-postgres-best-practices/ORIGEM.md +43 -0
  60. package/templates/skills/supabase-postgres-best-practices/SKILL.md +64 -0
  61. package/templates/skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
  62. package/templates/skills/supabase-postgres-best-practices/references/_sections.md +39 -0
  63. package/templates/skills/supabase-postgres-best-practices/references/_template.md +34 -0
  64. package/templates/skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
  65. package/templates/skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
  66. package/templates/skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
  67. package/templates/skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
  68. package/templates/skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
  69. package/templates/skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
  70. package/templates/skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
  71. package/templates/skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
  72. package/templates/skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
  73. package/templates/skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
  74. package/templates/skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
  75. package/templates/skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
  76. package/templates/skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
  77. package/templates/skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
  78. package/templates/skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
  79. package/templates/skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
  80. package/templates/skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
  81. package/templates/skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
  82. package/templates/skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
  83. package/templates/skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
  84. package/templates/skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
  85. package/templates/skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
  86. package/templates/skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
  87. package/templates/skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
  88. package/templates/skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
  89. package/templates/skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
  90. package/templates/skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
  91. package/templates/skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
  92. package/templates/skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
  93. package/templates/skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
  94. package/templates/skills/supabase-postgres-best-practices/references/security-rls-performance.md +63 -0
  95. package/templates/skills/vercel-react-best-practices/AGENTS.md +3810 -0
  96. package/templates/skills/vercel-react-best-practices/ORIGEM.md +39 -0
  97. package/templates/skills/vercel-react-best-practices/README.md +123 -0
  98. package/templates/skills/vercel-react-best-practices/SKILL.md +149 -0
  99. package/templates/skills/vercel-react-best-practices/metadata.json +15 -0
  100. package/templates/skills/vercel-react-best-practices/rules/_sections.md +46 -0
  101. package/templates/skills/vercel-react-best-practices/rules/_template.md +28 -0
  102. package/templates/skills/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
  103. package/templates/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  104. package/templates/skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
  105. package/templates/skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
  106. package/templates/skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
  107. package/templates/skills/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
  108. package/templates/skills/vercel-react-best-practices/rules/async-defer-await.md +82 -0
  109. package/templates/skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
  110. package/templates/skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
  111. package/templates/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
  112. package/templates/skills/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
  113. package/templates/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
  114. package/templates/skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
  115. package/templates/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
  116. package/templates/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  117. package/templates/skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
  118. package/templates/skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
  119. package/templates/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
  120. package/templates/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
  121. package/templates/skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
  122. package/templates/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
  123. package/templates/skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
  124. package/templates/skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
  125. package/templates/skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
  126. package/templates/skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
  127. package/templates/skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
  128. package/templates/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
  129. package/templates/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
  130. package/templates/skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
  131. package/templates/skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
  132. package/templates/skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
  133. package/templates/skills/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
  134. package/templates/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
  135. package/templates/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
  136. package/templates/skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
  137. package/templates/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  138. package/templates/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
  139. package/templates/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
  140. package/templates/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  141. package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  142. package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  143. package/templates/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
  144. package/templates/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
  145. package/templates/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
  146. package/templates/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  147. package/templates/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
  148. package/templates/skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
  149. package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  150. package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
  151. package/templates/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
  152. package/templates/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  153. package/templates/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  154. package/templates/skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
  155. package/templates/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  156. package/templates/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
  157. package/templates/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  158. package/templates/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
  159. package/templates/skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
  160. package/templates/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
  161. package/templates/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  162. package/templates/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
  163. package/templates/skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
  164. package/templates/skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
  165. package/templates/skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
  166. package/templates/skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
  167. package/templates/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
  168. package/templates/skills/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
  169. package/templates/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
  170. package/templates/skills/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
  171. package/templates/skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
  172. package/templates/skills/vercel-react-native-skills/AGENTS.md +2897 -0
  173. package/templates/skills/vercel-react-native-skills/ORIGEM.md +39 -0
  174. package/templates/skills/vercel-react-native-skills/README.md +165 -0
  175. package/templates/skills/vercel-react-native-skills/SKILL.md +121 -0
  176. package/templates/skills/vercel-react-native-skills/metadata.json +16 -0
  177. package/templates/skills/vercel-react-native-skills/rules/_sections.md +86 -0
  178. package/templates/skills/vercel-react-native-skills/rules/_template.md +28 -0
  179. package/templates/skills/vercel-react-native-skills/rules/animation-derived-value.md +53 -0
  180. package/templates/skills/vercel-react-native-skills/rules/animation-gesture-detector-press.md +95 -0
  181. package/templates/skills/vercel-react-native-skills/rules/animation-gpu-properties.md +65 -0
  182. package/templates/skills/vercel-react-native-skills/rules/design-system-compound-components.md +66 -0
  183. package/templates/skills/vercel-react-native-skills/rules/fonts-config-plugin.md +71 -0
  184. package/templates/skills/vercel-react-native-skills/rules/imports-design-system-folder.md +68 -0
  185. package/templates/skills/vercel-react-native-skills/rules/js-hoist-intl.md +61 -0
  186. package/templates/skills/vercel-react-native-skills/rules/list-performance-callbacks.md +44 -0
  187. package/templates/skills/vercel-react-native-skills/rules/list-performance-function-references.md +132 -0
  188. package/templates/skills/vercel-react-native-skills/rules/list-performance-images.md +53 -0
  189. package/templates/skills/vercel-react-native-skills/rules/list-performance-inline-objects.md +97 -0
  190. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-expensive.md +94 -0
  191. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-memo.md +82 -0
  192. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-types.md +104 -0
  193. package/templates/skills/vercel-react-native-skills/rules/list-performance-virtualize.md +67 -0
  194. package/templates/skills/vercel-react-native-skills/rules/monorepo-native-deps-in-app.md +46 -0
  195. package/templates/skills/vercel-react-native-skills/rules/monorepo-single-dependency-versions.md +63 -0
  196. package/templates/skills/vercel-react-native-skills/rules/navigation-native-navigators.md +188 -0
  197. package/templates/skills/vercel-react-native-skills/rules/react-compiler-destructure-functions.md +50 -0
  198. package/templates/skills/vercel-react-native-skills/rules/react-compiler-reanimated-shared-values.md +48 -0
  199. package/templates/skills/vercel-react-native-skills/rules/react-state-dispatcher.md +91 -0
  200. package/templates/skills/vercel-react-native-skills/rules/react-state-fallback.md +56 -0
  201. package/templates/skills/vercel-react-native-skills/rules/react-state-minimize.md +65 -0
  202. package/templates/skills/vercel-react-native-skills/rules/rendering-no-falsy-and.md +74 -0
  203. package/templates/skills/vercel-react-native-skills/rules/rendering-text-in-text-component.md +36 -0
  204. package/templates/skills/vercel-react-native-skills/rules/scroll-position-no-state.md +82 -0
  205. package/templates/skills/vercel-react-native-skills/rules/state-ground-truth.md +80 -0
  206. package/templates/skills/vercel-react-native-skills/rules/ui-expo-image.md +66 -0
  207. package/templates/skills/vercel-react-native-skills/rules/ui-image-gallery.md +104 -0
  208. package/templates/skills/vercel-react-native-skills/rules/ui-measure-views.md +78 -0
  209. package/templates/skills/vercel-react-native-skills/rules/ui-menus.md +174 -0
  210. package/templates/skills/vercel-react-native-skills/rules/ui-native-modals.md +77 -0
  211. package/templates/skills/vercel-react-native-skills/rules/ui-pressable.md +61 -0
  212. package/templates/skills/vercel-react-native-skills/rules/ui-safe-area-scroll.md +65 -0
  213. package/templates/skills/vercel-react-native-skills/rules/ui-scrollview-content-inset.md +45 -0
  214. package/templates/skills/vercel-react-native-skills/rules/ui-styling.md +87 -0
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "fontdata",
3
- "version": "4.4.0",
3
+ "version": "4.5.1",
4
4
  "mcpServers": {
5
- "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.4.0", "banco-dados-mcp"] }
5
+ "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.5.1", "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
@@ -142,6 +142,32 @@ o aviso fica em `.claude/skills/conhecimento-delphi/references/ATRIBUICAO.md`.
142
142
  O `update` não sobrescreve arquivo do projeto que já exista num caminho do perfil, nem com `--forcar`, e não apaga
143
143
  rules do projeto que repetem uma rule do perfil: tirar a duplicata fica com você.
144
144
 
145
+ ### Perfil `delphi-fiscal`
146
+
147
+ Quando o projeto recebe o perfil Delphi e usa ACBr, o `init` e o `update` instalam também o perfil `delphi-fiscal`,
148
+ como o item `perfil:delphi-fiscal` no lock. Como o perfil Delphi, ele fica fora do plugin. O ACBr é detectado assim:
149
+
150
+ - algum `.dproj` (pelo mesmo critério de detecção do Delphi) ou o `boss.json` da raiz cita `ACBr`, sem diferenciar
151
+ maiúsculas;
152
+ - senão, alguma `.pas` ou `.dpr` tem uma unit `ACBr...` (como `ACBrNFe`) na cláusula `uses`, fora de comentário e de
153
+ string. Isso pega o projeto que usa ACBr por DCU pré-compilada, sem pacote no `.dproj` nem `boss.json`. Num
154
+ repositório git, só contam os arquivos versionados (`git ls-files`); fora dele, os encontrados até 4 níveis de
155
+ pasta. Nos dois casos, o que casa com `delphi.ignorar` fica de fora.
156
+
157
+ Se a detecção não pegar o seu caso, grave `"perfis": { "delphi-fiscal": true }` no `.ai-harness/config.json` e rode
158
+ `npx @fontdata/ai-harness update --yes`: o `true` gravado no arquivo liga o perfil mesmo sem ACBr detectado. Sem a
159
+ chave, a detecção decide.
160
+
161
+ | O que instala | Onde |
162
+ |---|---|
163
+ | 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/` |
164
+ | Skills `patch-acbr` e `diagnosticar-rejeicao-nfse` | `.claude/skills/patch-acbr/` e `.claude/skills/diagnosticar-rejeicao-nfse/` |
165
+
166
+ Para recusar, grave `"perfis": { "delphi-fiscal": false }` no `.ai-harness/config.json` e rode
167
+ `npx @fontdata/ai-harness update --yes`: o `update` tira o item do lock e **mantém** os arquivos. A recusa do perfil
168
+ Delphi (`perfis.delphi: false`) recusa também o fiscal e tira os dois itens do lock, mesmo com o `true` do fiscal
169
+ gravado. Sem o perfil Delphi, por recusa ou porque o projeto não é Delphi, o fiscal não é instalado.
170
+
145
171
  ### Hook `delphi-encoding`
146
172
 
147
173
  | Arquivo | Antes de `Edit`/`MultiEdit` | Depois de `Write`/`Edit`/`MultiEdit` |
@@ -196,6 +222,38 @@ npx @fontdata/ai-harness delphi encoding checar --todos
196
222
  `--todos` pega os fontes Delphi versionados (`git ls-files`) fora de `delphi.ignorar`. Arquivo passado pelo nome é
197
223
  processado mesmo que case com `delphi.ignorar`.
198
224
 
225
+ ### Comando `delphi catalogo`
226
+
227
+ ```bash
228
+ npx @fontdata/ai-harness delphi catalogo
229
+ npx @fontdata/ai-harness delphi catalogo --pasta ../Bibliotecas/Fontdata --check
230
+ ```
231
+
232
+ Gera o catálogo das Bibliotecas Fontdata em `.claude/skills/conhecimento-delphi/references/bibliotecas-fontdata.md`,
233
+ na raiz do projeto, que a skill `conhecimento-delphi` e a rule de reaproveitamento mandam consultar antes de criar um
234
+ helper. Por unit `Fontdata.*.pas`, ele traz os tipos públicos da `interface` e, de cada tipo, os métodos e as
235
+ propriedades `public` e `published`, com a assinatura; os class helpers trazem também o tipo que estendem. A lista de
236
+ fontes guarda o nome de cada unit e o `sha256` do conteúdo, sem caminho, então o catálogo pode ser versionado.
237
+
238
+ - Sem `--pasta`, as units são procuradas nas pastas do `DCC_UnitSearchPath` de todos os `.dproj` do projeto. A
239
+ entrada relativa é resolvida a partir da pasta de cada `.dproj`, e a relativa com `$(...)` é ignorada.
240
+ - Um caminho absoluto do Windows ou UNC (`D:\DESEN\Delphi\Bibliotecas\Utils`, `\\servidor\share\Fontdata`) é usado
241
+ como está quando existe nesta máquina, o que é o caso no Windows. Se ele não existir, como no macOS ou no Linux, é
242
+ reancorado pelo sufixo: o trecho depois da raiz (`D:\`, `\\servidor\share`) é procurado sob cada pasta ancestral do
243
+ `.dproj`, do sufixo mais longo ao mais curto, com pelo menos 2 segmentos. Por exemplo, `D:\DESEN\Delphi\Bibliotecas\Utils`
244
+ casa com `~/Documents/DESEN/Delphi/Bibliotecas/Utils` quando o `.dproj` fica dentro de `~/Documents/DESEN`. O
245
+ caminho que não casa com nada fica sem resolver, e o absoluto com `$(...)` nunca é resolvido.
246
+ - `--pasta <dir>`, que pode se repetir, troca o search path pelas pastas informadas.
247
+ - `--check` não grava nada e sai com código 1 quando o catálogo falta ou diverge das units atuais.
248
+
249
+ Nenhuma unit encontrada é erro: o comando lista os caminhos absolutos do Windows que não foram encontrados nesta
250
+ máquina e pede `--pasta` com o caminho das Bibliotecas Fontdata. Num projeto com o perfil Delphi e units `Fontdata.*`
251
+ no search path, o `doctor` avisa `catalogo-fontdata-ausente` quando o catálogo não existe e
252
+ `catalogo-fontdata-desatualizado` quando ele não bate com as units. Quando nenhuma unit é achada, há caminho absoluto
253
+ sem resolver e alguma `.pas` ou `.dpr` usa uma unit `Fontdata.*` na cláusula `uses` (pelos mesmos arquivos e o mesmo
254
+ `delphi.ignorar` da detecção do ACBr), o `doctor` avisa `catalogo-fontdata-caminho-nao-resolvido`, lista os caminhos
255
+ e sugere `delphi catalogo --pasta <dir>`. Fora desses casos, não há aviso de catálogo.
256
+
199
257
  ## Conexões de banco de dados
200
258
 
201
259
  O Claude pode ler o banco do projeto (PostgreSQL, MariaDB ou SQLite) sem que ninguém cole credencial no chat. O
@@ -247,6 +305,7 @@ projeto, cadastro, limites do filtro, produção, mascaramento e dúvidas freque
247
305
  | `versao detectar\|calcular\|aplicar` | Fontes de versão do projeto, próxima versão e gravação nos arquivos (veja abaixo) |
248
306
  | `delphi classificar\|extrair-icone` | Classifica os `.res` versionados de um projeto Delphi e extrai o ícone que só existe no `.res` |
249
307
  | `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)) |
308
+ | `delphi catalogo` | Catálogo das units `Fontdata.*.pas` do search path dos `.dproj` (`--pasta <dir>`, `--check`; veja [Comando `delphi catalogo`](#comando-delphi-catalogo)) |
250
309
  | `list` | Lista o catálogo |
251
310
 
252
311
  O `mapa` lê TS/JS, Delphi, Python, C#, Java, Kotlin, Go, PHP, Rust e Dart. Outra linguagem, ou outra regra para uma
@@ -305,11 +364,30 @@ Os formatos estão em [`docs/contratos/ARTEFATOS.md`](docs/contratos/ARTEFATOS.m
305
364
  | `proteger-contratos` | SPEC, PLAN ou CLAUDE.md reescritos durante a execução de um trabalho | aviso |
306
365
  | `task-so-fecha-verde` | Task marcada como concluída sem suíte verde no rastro | aviso |
307
366
  | `sem-jargao` | Termo técnico no relatório para o cliente | aviso |
367
+ | `padroes-proibidos` | `Edit`, `MultiEdit` ou `Write` que introduz um padrão declarado em `.ai-harness/padroes.json` | aviso |
308
368
 
309
369
  O modo de cada hook (`aviso`, `bloqueio` ou `desligado`) fica em `.ai-harness/config.json`. Hook que falha
310
370
  internamente não atrapalha o trabalho — exceto o de segurança em modo bloqueio. Projetos Delphi recebem também o
311
371
  hook `delphi-encoding`, do [perfil Delphi](#perfil-delphi).
312
372
 
373
+ O `padroes-proibidos` vale para qualquer stack e só age no projeto que cria o `.ai-harness/padroes.json`; sem o
374
+ arquivo, ou com a lista vazia, ele não faz nada. Cada entrada traz as extensões, a regex, os flags e o motivo
375
+ mostrado ao agente. Só o padrão **introduzido** é acusado: o hook conta as ocorrências no texto antigo e no novo
376
+ (`old_string` contra `new_string` no `Edit`, a soma das `edits` no `MultiEdit`, o arquivo em disco contra o
377
+ `content` no `Write`) e acusa quando o novo tem mais. Dos flags, valem só `i`, `m`, `s` e `u`; uma entrada com regex
378
+ que não compila ou com campo faltando é ignorada, e as demais continuam valendo. Em `aviso` o motivo entra como
379
+ contexto, em `bloqueio` a edição é negada. O `update` registra no `.claude/settings.json` os hooks do núcleo que
380
+ 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
381
+ `hooks["<nome>"]: "desligado"` no `.ai-harness/config.json`, por exemplo `"hooks": { "padroes-proibidos": "desligado" }`.
382
+
383
+ ```json
384
+ {
385
+ "padroes": [
386
+ { "extensoes": [".pas"], "regex": "Clipboard\\s*\\.\\s*AsText\\s*:=", "flags": "i", "motivo": "Use o helper de clipboard do projeto." }
387
+ ]
388
+ }
389
+ ```
390
+
313
391
  ### Agents somente leitura
314
392
 
315
393
  | Agent | Papel |
@@ -350,7 +428,7 @@ também acionado pelo modelo quando o pedido combina.
350
428
  - `/memoria` **(skill)** — mostra quem já mexeu num arquivo e por quê e aponta regressões candidatas de um bug
351
429
  - `/auditar-ui` **(skill)** — navega a aplicação via Playwright MCP e audita UX/UI e acessibilidade
352
430
  - `/auditar-performance` **(skill)** — mede e audita gargalos de performance
353
- - `/auditar-seguranca` **(skill)** — auditoria defensiva de segurança e conformidade com a LGPD
431
+ - `/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
354
432
 
355
433
  ### Utilitário
356
434
  - `/git-commit-push` ⭐ — gera a mensagem (PT-BR, Conventional Commits) e faz add, commit e push
@@ -378,6 +456,21 @@ A skill `lgpd-checker`, usada pela auditoria de segurança, é uma cópia vendor
378
456
  [bittencourtthulio/lgpd-checker](https://github.com/bittencourtthulio/lgpd-checker); veja
379
457
  `templates/skills/lgpd-checker/ORIGEM.md`.
380
458
 
459
+ As outras skills e referências de terceiros também são cópias vendorizadas, sem alteração no conteúdo e com a
460
+ licença MIT de origem. Créditos aos autores:
461
+
462
+ - `security-audit`, da Cloudflare — [cloudflare/security-audit-skill](https://github.com/cloudflare/security-audit-skill);
463
+ usada pelo `/auditar-seguranca`. Veja `templates/skills/security-audit/ORIGEM.md`.
464
+ - `vercel-react-best-practices`, da Vercel — [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills);
465
+ usada pelo `/auditar-performance`. Veja `templates/skills/vercel-react-best-practices/ORIGEM.md`.
466
+ - `vercel-react-native-skills`, da Vercel — [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills);
467
+ usada pelo `/auditar-performance`. Veja `templates/skills/vercel-react-native-skills/ORIGEM.md`.
468
+ - `supabase-postgres-best-practices`, da Supabase — [supabase/agent-skills](https://github.com/supabase/agent-skills);
469
+ usada pelo `/auditar-performance`. Veja `templates/skills/supabase-postgres-best-practices/ORIGEM.md`.
470
+ - Web Interface Guidelines, da Vercel — [vercel-labs/web-interface-guidelines](https://github.com/vercel-labs/web-interface-guidelines);
471
+ referência do `/auditar-ui`, em `templates/skills/auditar-ui/references/web-interface-guidelines.md`. Veja
472
+ `templates/skills/auditar-ui/references/ATRIBUICAO.md`.
473
+
381
474
  ## Fluxo recomendado
382
475
 
383
476
  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,11 @@ 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'];
16
18
  export const DELPHI_IGNORAR_PADRAO = ['**/modules/**', '**/ACBr*/**'];
17
19
  function isObject(value) {
18
20
  return typeof value === 'object' && value !== null && !Array.isArray(value);
@@ -74,7 +76,8 @@ export function defaultConfig() {
74
76
  declarado: false,
75
77
  },
76
78
  comentarios: { instalar: true },
77
- perfis: { delphi: true },
79
+ perfis: { delphi: true, 'delphi-fiscal': true },
80
+ perfisExplicitos: {},
78
81
  delphi: { ignorar: [...DELPHI_IGNORAR_PADRAO] },
79
82
  };
80
83
  }
@@ -242,11 +245,16 @@ export function readConfig(root) {
242
245
  else
243
246
  problems.push(`comentarios.instalar deve ser true ou false em ${CONFIG_PATH}.`);
244
247
  }
245
- if (isObject(raw.perfis) && 'delphi' in raw.perfis) {
246
- if (typeof raw.perfis.delphi === 'boolean')
247
- config.perfis.delphi = raw.perfis.delphi;
248
+ for (const perfil of PERFIS_DO_CONFIG) {
249
+ if (!isObject(raw.perfis) || !(perfil in raw.perfis))
250
+ continue;
251
+ const valor = raw.perfis[perfil];
252
+ if (typeof valor === 'boolean') {
253
+ config.perfis[perfil] = valor;
254
+ config.perfisExplicitos[perfil] = valor;
255
+ }
248
256
  else
249
- problems.push(`perfis.delphi deve ser true ou false em ${CONFIG_PATH}.`);
257
+ problems.push(`perfis.${perfil} deve ser true ou false em ${CONFIG_PATH}.`);
250
258
  }
251
259
  if (isObject(raw.delphi) && 'ignorar' in raw.delphi) {
252
260
  const ignorar = raw.delphi.ignorar;
@@ -268,7 +276,7 @@ export function readConfig(root) {
268
276
  }
269
277
  /** Os padrões que vão para o arquivo: sem as seções banco_dados, comentarios, perfis e delphi, que só entram quando mudam. */
270
278
  function configGravada() {
271
- const { banco_dados: _banco, comentarios: _comentarios, perfis: _perfis, delphi: _delphi, ...gravada } = defaultConfig();
279
+ const { banco_dados: _banco, comentarios: _comentarios, perfis: _perfis, perfisExplicitos: _perfisExplicitos, delphi: _delphi, ...gravada } = defaultConfig();
272
280
  return gravada;
273
281
  }
274
282
  /** Cria a config com os padrões, sem as seções que só entram quando mudam; retorna false se já existia (nunca sobrescreve). */
@@ -390,23 +398,26 @@ export function gravarInstalarComentarios(root, valor) {
390
398
  writeFileSync(file, `${JSON.stringify(proxima, null, 2)}\n`);
391
399
  }
392
400
  /**
393
- * Grava a recusa do perfil Delphi (`perfis.delphi: false`), preservando o resto do JSON; sem config, cria uma com os
394
- * padrões e essa chave. `true` desfaz a recusa apagando a chave, e não cria o arquivo. JSON inválido é recusado sem
395
- * tocar no arquivo.
401
+ * Grava a recusa do perfil (`perfis.<id>: false`), preservando o resto do JSON; sem config, cria uma com os padrões e
402
+ * essa chave. `true` desfaz a recusa apagando a chave, e não cria o arquivo. JSON inválido é recusado sem tocar no
403
+ * arquivo.
396
404
  */
397
- export function gravarPerfilDelphi(root, valor) {
405
+ export function gravarPerfil(root, perfil, valor) {
398
406
  const file = join(root, CONFIG_PATH);
399
407
  if (!existsSync(file) && valor)
400
408
  return;
401
- const raw = existsSync(file) ? lerJsonParaEscrita(file, 'perfis.delphi') : configGravada();
402
- const { delphi: atual, ...resto } = isObject(raw.perfis) ? raw.perfis : {};
409
+ const raw = existsSync(file) ? lerJsonParaEscrita(file, `perfis.${perfil}`) : configGravada();
410
+ const { [perfil]: atual, ...resto } = isObject(raw.perfis) ? raw.perfis : {};
403
411
  if (valor ? atual === undefined || atual === true : atual === false)
404
412
  return;
405
413
  const { perfis: _perfis, ...semSecao } = raw;
406
- const proxima = valor ? (Object.keys(resto).length ? { ...raw, perfis: resto } : semSecao) : { ...raw, perfis: { ...resto, delphi: false } };
414
+ const proxima = valor ? (Object.keys(resto).length ? { ...raw, perfis: resto } : semSecao) : { ...raw, perfis: { ...resto, [perfil]: false } };
407
415
  mkdirSync(dirname(file), { recursive: true });
408
416
  writeFileSync(file, `${JSON.stringify(proxima, null, 2)}\n`);
409
417
  }
418
+ export function gravarPerfilDelphi(root, valor) {
419
+ gravarPerfil(root, 'delphi', valor);
420
+ }
410
421
  const BLOCK_START = '# ai-harness (gerenciado pelo harness; não edite entre estas linhas)';
411
422
  const BLOCK_END = '# /ai-harness';
412
423
  /**
@@ -0,0 +1,308 @@
1
+ import { existsSync, readdirSync, readFileSync } from 'node:fs';
2
+ import path, { join } 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
+ import { mascararStrings } from './uses.js';
7
+ export const CAMINHO_CATALOGO = '.claude/skills/conhecimento-delphi/references/bibliotecas-fontdata.md';
8
+ const VISIBILIDADE = /^(strict\s+private|strict\s+protected|private|protected|public|published|automated)\b\s*/i;
9
+ const SECAO_DO_TIPO = /^(class\s+var|type|const|var|threadvar|resourcestring)\b\s*/i;
10
+ const SECAO_DO_TOPO = /^(type|const|var|threadvar|resourcestring)\b\s*/i;
11
+ const ATRIBUTO = /^\[[^\]]*\]\s*/;
12
+ const MEMBRO = /^(class\s+)?(function|procedure|constructor|destructor|property|operator)\b/i;
13
+ const ROTINA = /^(function|procedure)\b/i;
14
+ 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;
15
+ const CABECALHO = /^([A-Za-z_]\w*(?:\s*<[^>]*>)?)\s*=\s*(.*)$/;
16
+ const HELPER = /^((?:class|record)\s+helper\s*(?:\([^)]*\))?\s+for\s+[\w.]+(?:\s*<[^>]*>)?)\s*(.*)$/i;
17
+ const ESTRUTURA = /^((?:packed\s+)?(class|record|object|interface|dispinterface)\b(?:\s+(?:sealed|abstract))?\s*(?:\([^)]*\))?\s*(?:\[[^\]]*\])?)\s*(.*)$/i;
18
+ const RECORD_ANONIMO = /^[\w\s,]+:\s*(packed\s+)?record\b\s*(.*)$/i;
19
+ const RAIZ_WINDOWS = /^(?:[A-Za-z]:[\\/]|[\\/]{2}[^\\/]+[\\/][^\\/]+)/;
20
+ function* ancestrais(pasta, caminho) {
21
+ for (let atual = pasta;;) {
22
+ yield atual;
23
+ const pai = caminho.dirname(atual);
24
+ if (pai === atual)
25
+ return;
26
+ atual = pai;
27
+ }
28
+ }
29
+ /**
30
+ * Pasta de uma entrada do search path, ou `null` para a entrada absoluta do Windows ou UNC sem correspondente:
31
+ * o literal vale quando o `caminho` a considera absoluta e ela existe; senão, o sufixo de pelo menos 2 segmentos,
32
+ * do mais longo ao mais curto, é procurado sob cada ancestral de `pastaDoDproj`.
33
+ */
34
+ export function resolverEntrada(entrada, pastaDoDproj, opcoes = {}) {
35
+ const { caminho = path, existe = existsSync } = opcoes;
36
+ const raizWindows = RAIZ_WINDOWS.exec(entrada);
37
+ if (!raizWindows)
38
+ return caminho.resolve(pastaDoDproj, entrada.replace(/\\/g, '/'));
39
+ if (caminho.isAbsolute(entrada)) {
40
+ const literal = caminho.normalize(entrada);
41
+ if (existe(literal))
42
+ return literal;
43
+ }
44
+ const segmentos = entrada
45
+ .slice(raizWindows[0].length)
46
+ .split(/[\\/]+/)
47
+ .filter((segmento) => segmento && segmento !== '.');
48
+ for (let tamanho = segmentos.length; tamanho >= 2; tamanho--) {
49
+ const sufixo = segmentos.slice(segmentos.length - tamanho);
50
+ for (const ancestral of ancestrais(pastaDoDproj, caminho)) {
51
+ const candidato = caminho.join(ancestral, ...sufixo);
52
+ if (existe(candidato))
53
+ return candidato;
54
+ }
55
+ }
56
+ return null;
57
+ }
58
+ /** Pastas do `DCC_UnitSearchPath` de todos os `.dproj`; a entrada relativa com `$(...)` é ignorada. */
59
+ export function resolverSearchPath(raiz, opcoes = {}) {
60
+ const caminho = opcoes.caminho ?? path;
61
+ const resultado = { pastas: [], naoResolvidas: [] };
62
+ for (const rel of arquivosDproj(raiz)) {
63
+ const dproj = join(raiz, rel);
64
+ let xml;
65
+ try {
66
+ xml = readFileSync(dproj, 'utf8');
67
+ }
68
+ catch {
69
+ continue;
70
+ }
71
+ for (const grupo of xml.matchAll(/<DCC_UnitSearchPath>([\s\S]*?)<\/DCC_UnitSearchPath>/gi)) {
72
+ for (const bruta of (grupo[1] ?? '').split(';')) {
73
+ const entrada = bruta.trim();
74
+ if (!entrada)
75
+ continue;
76
+ const comMacro = entrada.includes('$(');
77
+ if (comMacro && !RAIZ_WINDOWS.test(entrada))
78
+ continue;
79
+ const pasta = comMacro ? null : resolverEntrada(entrada, caminho.dirname(dproj), opcoes);
80
+ const lista = pasta === null ? resultado.naoResolvidas : resultado.pastas;
81
+ const valor = pasta ?? entrada;
82
+ if (!lista.includes(valor))
83
+ lista.push(valor);
84
+ }
85
+ }
86
+ }
87
+ return resultado;
88
+ }
89
+ export function pastasDoSearchPath(raiz) {
90
+ return resolverSearchPath(raiz).pastas;
91
+ }
92
+ export function acharUnitsFontdata(pastas) {
93
+ const units = new Map();
94
+ for (const pasta of pastas) {
95
+ let arquivos;
96
+ try {
97
+ arquivos = readdirSync(pasta).sort();
98
+ }
99
+ catch {
100
+ continue;
101
+ }
102
+ for (const arquivo of arquivos) {
103
+ const nome = arquivo.slice(0, -'.pas'.length);
104
+ if (!/^Fontdata\..+\.pas$/i.test(arquivo) || units.has(nome.toLowerCase()))
105
+ continue;
106
+ try {
107
+ units.set(nome.toLowerCase(), { nome, conteudo: readFileSync(join(pasta, arquivo)) });
108
+ }
109
+ catch {
110
+ continue;
111
+ }
112
+ }
113
+ }
114
+ return [...units.values()].sort((a, b) => (a.nome < b.nome ? -1 : a.nome > b.nome ? 1 : 0));
115
+ }
116
+ function semStrings(texto) {
117
+ return texto.replace(/'[^'\n]*'/g, (m) => m.replace(/[^\n]/g, ' '));
118
+ }
119
+ function semComentariosPreservandoStrings(fonte) {
120
+ const mascarado = mascararStrings(fonte);
121
+ const limpo = semComentariosPascal(mascarado);
122
+ let saida = '';
123
+ for (let i = 0; i < limpo.length; i++)
124
+ saida += limpo[i] === '_' && mascarado[i] === '_' ? fonte[i] : limpo[i];
125
+ return saida;
126
+ }
127
+ function declaracoesDaInterface(fonte) {
128
+ const limpo = semComentariosPreservandoStrings(fonte);
129
+ const inicio = /^\s*interface\b/im.exec(limpo);
130
+ if (!inicio)
131
+ return [];
132
+ const resto = limpo.slice(inicio.index + inicio[0].length);
133
+ const fim = /^\s*implementation\b/im.exec(resto);
134
+ const secao = fim ? resto.slice(0, fim.index) : resto;
135
+ const mascara = semStrings(secao);
136
+ const declaracoes = [];
137
+ let profundidade = 0;
138
+ let comeco = 0;
139
+ for (let i = 0; i < mascara.length; i++) {
140
+ const c = mascara[i];
141
+ if (c === '(' || c === '[')
142
+ profundidade++;
143
+ else if ((c === ')' || c === ']') && profundidade > 0)
144
+ profundidade--;
145
+ else if (c === ';' && profundidade === 0) {
146
+ declaracoes.push(secao.slice(comeco, i).replace(/\s+/g, ' ').trim());
147
+ comeco = i + 1;
148
+ }
149
+ }
150
+ return declaracoes;
151
+ }
152
+ function abrirTipo(definicao) {
153
+ if (/^class\s+of\b/i.test(definicao))
154
+ return null;
155
+ const abertura = HELPER.exec(definicao) ?? ESTRUTURA.exec(definicao);
156
+ if (!abertura)
157
+ return null;
158
+ const cabeca = (abertura[1] ?? '').replace(/\s*\[[^\]]*\]$/, '').trim();
159
+ return { cabeca, corpo: abertura[abertura.length - 1] ?? '' };
160
+ }
161
+ export function extrairApi(fonte) {
162
+ const api = { tipos: [], rotinas: [] };
163
+ const abertos = [];
164
+ let secaoDeTipos = false;
165
+ let ultimo = null;
166
+ for (const declaracao of declaracoesDaInterface(fonte)) {
167
+ let resto = declaracao;
168
+ while (resto) {
169
+ resto = resto.replace(ATRIBUTO, '');
170
+ const topo = abertos[abertos.length - 1];
171
+ if (DIRETIVA.test(resto)) {
172
+ if (ultimo && ultimo.length > 0)
173
+ ultimo[ultimo.length - 1] += ` ${resto};`;
174
+ break;
175
+ }
176
+ if (topo) {
177
+ const visibilidade = VISIBILIDADE.exec(resto);
178
+ if (visibilidade) {
179
+ topo.visivel = /^(public|published|automated)$/i.test(visibilidade[1] ?? '');
180
+ resto = resto.slice(visibilidade[0].length);
181
+ continue;
182
+ }
183
+ const fim = /^end\b\s*/i.exec(resto);
184
+ if (fim) {
185
+ abertos.pop();
186
+ resto = resto.slice(fim[0].length);
187
+ continue;
188
+ }
189
+ const secao = SECAO_DO_TIPO.exec(resto);
190
+ if (secao) {
191
+ resto = resto.slice(secao[0].length);
192
+ continue;
193
+ }
194
+ if (MEMBRO.test(resto)) {
195
+ const publico = abertos.length === 1 && topo.visivel && topo.tipo;
196
+ if (publico)
197
+ topo.tipo.membros.push(`${resto};`);
198
+ ultimo = publico ? topo.tipo.membros : null;
199
+ break;
200
+ }
201
+ const anonimo = RECORD_ANONIMO.exec(resto);
202
+ const aninhado = anonimo ? null : CABECALHO.exec(resto);
203
+ const corpo = anonimo ? (anonimo[2] ?? '') : (abrirTipo(aninhado?.[2] ?? '')?.corpo ?? '');
204
+ ultimo = null;
205
+ if (!corpo)
206
+ break;
207
+ abertos.push({ visivel: false });
208
+ resto = corpo;
209
+ continue;
210
+ }
211
+ const secao = SECAO_DO_TOPO.exec(resto);
212
+ if (secao) {
213
+ secaoDeTipos = /^type$/i.test(secao[1] ?? '');
214
+ resto = resto.slice(secao[0].length);
215
+ continue;
216
+ }
217
+ if (/^uses\b/i.test(resto))
218
+ break;
219
+ if (ROTINA.test(resto)) {
220
+ api.rotinas.push(`${resto};`);
221
+ ultimo = api.rotinas;
222
+ secaoDeTipos = false;
223
+ break;
224
+ }
225
+ const cabecalho = secaoDeTipos ? CABECALHO.exec(resto) : null;
226
+ if (!cabecalho) {
227
+ ultimo = null;
228
+ break;
229
+ }
230
+ const nome = (cabecalho[1] ?? '').replace(/\s+/g, '');
231
+ const definicao = cabecalho[2] ?? '';
232
+ const abertura = abrirTipo(definicao);
233
+ ultimo = null;
234
+ if (!abertura) {
235
+ api.tipos.push({ nome, declaracao: definicao, membros: [] });
236
+ break;
237
+ }
238
+ const { cabeca, corpo } = abertura;
239
+ if (!corpo && /^(class|interface|dispinterface)$/i.test(cabeca))
240
+ break;
241
+ const tipo = { nome, declaracao: cabeca, membros: [] };
242
+ api.tipos.push(tipo);
243
+ if (!corpo)
244
+ break;
245
+ abertos.push({ tipo, visivel: true });
246
+ resto = corpo;
247
+ }
248
+ }
249
+ return api;
250
+ }
251
+ function renderizarUnit(unit) {
252
+ const { tipos, rotinas } = extrairApi(unit.conteudo.toString('utf8').replace(/^/, ''));
253
+ const linhas = [`## ${unit.nome}`, ''];
254
+ if (tipos.length === 0 && rotinas.length === 0)
255
+ linhas.push('Nada público na `interface`.', '');
256
+ for (const tipo of tipos) {
257
+ linhas.push(`### \`${tipo.nome} = ${tipo.declaracao}\``, '');
258
+ if (tipo.membros.length > 0)
259
+ linhas.push(...tipo.membros.map((m) => `- \`${m}\``), '');
260
+ }
261
+ if (rotinas.length > 0)
262
+ linhas.push('### Rotinas', '', ...rotinas.map((r) => `- \`${r}\``), '');
263
+ return linhas;
264
+ }
265
+ export function gerarCatalogo(units) {
266
+ const linhas = [
267
+ '# Catálogo das units Fontdata',
268
+ '',
269
+ 'Gerado por `npx @fontdata/ai-harness delphi catalogo` a partir das units `Fontdata.*.pas` do search path do',
270
+ 'projeto. Antes de criar um helper ou utilitário, procure aqui o que já existe. Não edite à mão: quando as units',
271
+ 'mudarem, rode o comando de novo.',
272
+ '',
273
+ '## Fontes',
274
+ '',
275
+ '| Unit | sha256 |',
276
+ '|---|---|',
277
+ ...units.map((unit) => `| ${unit.nome} | ${hashContent(unit.conteudo)} |`),
278
+ '',
279
+ ...units.flatMap(renderizarUnit),
280
+ ];
281
+ return `${linhas.join('\n').trimEnd()}\n`;
282
+ }
283
+ export function lerFontesDoCatalogo(texto) {
284
+ const fontes = new Map();
285
+ for (const linha of texto.split(/\r?\n/)) {
286
+ const fonte = /^\| (Fontdata\.[^|\s]+) \| ([0-9a-f]{64}) \|$/.exec(linha);
287
+ if (fonte)
288
+ fontes.set(fonte[1], fonte[2]);
289
+ }
290
+ return fontes;
291
+ }
292
+ export function estadoDoCatalogo(arquivo, units) {
293
+ if (units.length === 0)
294
+ return 'sem-units';
295
+ if (!existsSync(arquivo))
296
+ return 'ausente';
297
+ const fontes = lerFontesDoCatalogo(readFileSync(arquivo, 'utf8'));
298
+ const emDia = fontes.size === units.length && units.every((unit) => fontes.get(unit.nome) === hashContent(unit.conteudo));
299
+ return emDia ? 'em-dia' : 'desatualizado';
300
+ }
301
+ /**
302
+ * Estado do catálogo gravado na raiz contra as units `Fontdata.*.pas` do search path dos `.dproj`, ou das
303
+ * `pastas` informadas. `sem-units` quando nenhuma unit é encontrada, caso em que não há o que avisar.
304
+ */
305
+ export function checarCatalogo(raiz, pastas) {
306
+ const units = acharUnitsFontdata(pastas ?? pastasDoSearchPath(raiz));
307
+ return estadoDoCatalogo(join(raiz, CAMINHO_CATALOGO), units);
308
+ }
@@ -3,6 +3,8 @@ import { dirname, join, relative, sep } from 'node:path';
3
3
  import { git, isVersioned } from '../trabalhos/arquivar.js';
4
4
  import { varrerArquivos } from '../versao/detectar.js';
5
5
  import { lerRes } from './res.js';
6
+ import { algumUsesCasa, emRepositorioGit } from './uses.js';
7
+ export { emRepositorioGit };
6
8
  const RT_ICON = 3;
7
9
  const RT_RCDATA = 10;
8
10
  const RT_GROUP_ICON = 14;
@@ -13,8 +15,31 @@ export function detectarDelphi(raiz) {
13
15
  return true;
14
16
  return Boolean(git(raiz, ['ls-files', '--', ':(icase)*.dproj', ':(icase)*.dpr'])?.trim());
15
17
  }
16
- export function emRepositorioGit(raiz) {
17
- return git(raiz, ['rev-parse', '--is-inside-work-tree'])?.trim() === 'true';
18
+ /** Os `.dproj` do projeto pelo critério de `detectarDelphi`: até 3 níveis de pasta, mais os versionados no git. */
19
+ export function arquivosDproj(raiz) {
20
+ const achados = new Set(varrerArquivos(raiz, '', 3, /\.dproj$/i));
21
+ for (const nome of git(raiz, ['ls-files', '--', ':(icase)*.dproj'])?.split('\n') ?? []) {
22
+ if (nome)
23
+ achados.add(nome);
24
+ }
25
+ return [...achados].sort();
26
+ }
27
+ function citaAcbr(arquivo) {
28
+ try {
29
+ return /acbr/i.test(readFileSync(arquivo, 'utf8'));
30
+ }
31
+ catch {
32
+ return false;
33
+ }
34
+ }
35
+ /**
36
+ * Algum `.dproj` ou o `boss.json` da raiz cita ACBr, sem diferenciar maiúsculas; sem achado, alguma `.pas`/`.dpr`
37
+ * fora de `ignorar` tem uma unit `ACBr[A-Z]...` na cláusula `uses`.
38
+ */
39
+ export function detectarAcbr(raiz, ignorar) {
40
+ if (citaAcbr(join(raiz, 'boss.json')) || arquivosDproj(raiz).some((rel) => citaAcbr(join(raiz, rel))))
41
+ return true;
42
+ return algumUsesCasa(raiz, (unit) => /^ACBr[A-Z]/.test(unit), ignorar);
18
43
  }
19
44
  function mesmoNome(nome, esperado) {
20
45
  return typeof nome === 'string' && nome.toUpperCase() === esperado;