@fontdata/ai-harness 4.4.0 → 4.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (213) hide show
  1. package/.claude-plugin/plugin.json +2 -2
  2. package/README.md +74 -1
  3. package/dist/cli.js +1 -0
  4. package/dist/config/config.js +20 -12
  5. package/dist/delphi/catalogo.js +299 -0
  6. package/dist/delphi/classificar.js +21 -0
  7. package/dist/delphi/command.js +43 -2
  8. package/dist/doctor/checks.js +19 -1
  9. package/dist/init.js +9 -1
  10. package/dist/install/perfis.js +11 -4
  11. package/dist/mapa/extratores/pascal.js +1 -1
  12. package/dist/update/update.js +80 -23
  13. package/package.json +1 -1
  14. package/templates/CLAUDE.md +2 -1
  15. package/templates/catalog.json +9 -4
  16. package/templates/hooks/comentarios/check.mjs +62 -5
  17. package/templates/hooks/hooks.json +2 -1
  18. package/templates/hooks/lib/config.mjs +1 -0
  19. package/templates/hooks/padroes-proibidos.mjs +68 -0
  20. package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md +6 -6
  21. package/templates/perfis/delphi/skills/conhecimento-delphi/SKILL.md +6 -0
  22. package/templates/perfis/delphi-fiscal/rules/campo-novo-acbr-preenchimento-explicito.md +61 -0
  23. package/templates/perfis/delphi-fiscal/rules/retorno-de-evento-nfe-pelo-cstat.md +51 -0
  24. package/templates/perfis/delphi-fiscal/rules/sucesso-de-webservice-fiscal-nao-prova-documento.md +100 -0
  25. package/templates/perfis/delphi-fiscal/rules/total-tributo-acbr-soma-itens.md +63 -0
  26. package/templates/perfis/delphi-fiscal/skills/diagnosticar-rejeicao-nfse/SKILL.md +155 -0
  27. package/templates/perfis/delphi-fiscal/skills/patch-acbr/SKILL.md +143 -0
  28. package/templates/skills/auditar-performance/SKILL.md +9 -0
  29. package/templates/skills/auditar-performance/references/pontos-quentes.md +8 -0
  30. package/templates/skills/auditar-seguranca/SKILL.md +55 -14
  31. package/templates/skills/auditar-seguranca/templates/relatorios/TECNICO.md +5 -0
  32. package/templates/skills/auditar-ui/SKILL.md +18 -3
  33. package/templates/skills/auditar-ui/references/ATRIBUICAO.md +44 -0
  34. package/templates/skills/auditar-ui/references/web-interface-guidelines.md +191 -0
  35. package/templates/skills/harness/references/validar-ideia.md +7 -6
  36. package/templates/skills/security-audit/AI-AND-LLM.md +83 -0
  37. package/templates/skills/security-audit/ATTACK-CLASSES.md +130 -0
  38. package/templates/skills/security-audit/CLIENT-SIDE.md +83 -0
  39. package/templates/skills/security-audit/CLOUD-AND-DEPLOYMENT.md +86 -0
  40. package/templates/skills/security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -0
  41. package/templates/skills/security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -0
  42. package/templates/skills/security-audit/HUNTING.md +251 -0
  43. package/templates/skills/security-audit/LICENSE +21 -0
  44. package/templates/skills/security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -0
  45. package/templates/skills/security-audit/ORIGEM.md +51 -0
  46. package/templates/skills/security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -0
  47. package/templates/skills/security-audit/RECONNAISSANCE.md +156 -0
  48. package/templates/skills/security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -0
  49. package/templates/skills/security-audit/SKILL.md +192 -0
  50. package/templates/skills/security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -0
  51. package/templates/skills/security-audit/VALIDATION-AND-REPORTING.md +186 -0
  52. package/templates/skills/security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -0
  53. package/templates/skills/security-audit/report-schema.json +461 -0
  54. package/templates/skills/security-audit/validate-coverage-ledger.cjs +872 -0
  55. package/templates/skills/security-audit/validate-findings.cjs +773 -0
  56. package/templates/skills/supabase-postgres-best-practices/CHANGELOG.md +73 -0
  57. package/templates/skills/supabase-postgres-best-practices/LICENSE +21 -0
  58. package/templates/skills/supabase-postgres-best-practices/ORIGEM.md +43 -0
  59. package/templates/skills/supabase-postgres-best-practices/SKILL.md +64 -0
  60. package/templates/skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
  61. package/templates/skills/supabase-postgres-best-practices/references/_sections.md +39 -0
  62. package/templates/skills/supabase-postgres-best-practices/references/_template.md +34 -0
  63. package/templates/skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
  64. package/templates/skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
  65. package/templates/skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
  66. package/templates/skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
  67. package/templates/skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
  68. package/templates/skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
  69. package/templates/skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
  70. package/templates/skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
  71. package/templates/skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
  72. package/templates/skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
  73. package/templates/skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
  74. package/templates/skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
  75. package/templates/skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
  76. package/templates/skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
  77. package/templates/skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
  78. package/templates/skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
  79. package/templates/skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
  80. package/templates/skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
  81. package/templates/skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
  82. package/templates/skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
  83. package/templates/skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
  84. package/templates/skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
  85. package/templates/skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
  86. package/templates/skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
  87. package/templates/skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
  88. package/templates/skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
  89. package/templates/skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
  90. package/templates/skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
  91. package/templates/skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
  92. package/templates/skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
  93. package/templates/skills/supabase-postgres-best-practices/references/security-rls-performance.md +63 -0
  94. package/templates/skills/vercel-react-best-practices/AGENTS.md +3810 -0
  95. package/templates/skills/vercel-react-best-practices/ORIGEM.md +39 -0
  96. package/templates/skills/vercel-react-best-practices/README.md +123 -0
  97. package/templates/skills/vercel-react-best-practices/SKILL.md +149 -0
  98. package/templates/skills/vercel-react-best-practices/metadata.json +15 -0
  99. package/templates/skills/vercel-react-best-practices/rules/_sections.md +46 -0
  100. package/templates/skills/vercel-react-best-practices/rules/_template.md +28 -0
  101. package/templates/skills/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
  102. package/templates/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  103. package/templates/skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
  104. package/templates/skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
  105. package/templates/skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
  106. package/templates/skills/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
  107. package/templates/skills/vercel-react-best-practices/rules/async-defer-await.md +82 -0
  108. package/templates/skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
  109. package/templates/skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
  110. package/templates/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
  111. package/templates/skills/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
  112. package/templates/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
  113. package/templates/skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
  114. package/templates/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
  115. package/templates/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  116. package/templates/skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
  117. package/templates/skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
  118. package/templates/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
  119. package/templates/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
  120. package/templates/skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
  121. package/templates/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
  122. package/templates/skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
  123. package/templates/skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
  124. package/templates/skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
  125. package/templates/skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
  126. package/templates/skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
  127. package/templates/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
  128. package/templates/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
  129. package/templates/skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
  130. package/templates/skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
  131. package/templates/skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
  132. package/templates/skills/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
  133. package/templates/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
  134. package/templates/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
  135. package/templates/skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
  136. package/templates/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  137. package/templates/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
  138. package/templates/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
  139. package/templates/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  140. package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  141. package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  142. package/templates/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
  143. package/templates/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
  144. package/templates/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
  145. package/templates/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  146. package/templates/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
  147. package/templates/skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
  148. package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  149. package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
  150. package/templates/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
  151. package/templates/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  152. package/templates/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  153. package/templates/skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
  154. package/templates/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  155. package/templates/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
  156. package/templates/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  157. package/templates/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
  158. package/templates/skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
  159. package/templates/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
  160. package/templates/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  161. package/templates/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
  162. package/templates/skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
  163. package/templates/skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
  164. package/templates/skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
  165. package/templates/skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
  166. package/templates/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
  167. package/templates/skills/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
  168. package/templates/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
  169. package/templates/skills/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
  170. package/templates/skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
  171. package/templates/skills/vercel-react-native-skills/AGENTS.md +2897 -0
  172. package/templates/skills/vercel-react-native-skills/ORIGEM.md +39 -0
  173. package/templates/skills/vercel-react-native-skills/README.md +165 -0
  174. package/templates/skills/vercel-react-native-skills/SKILL.md +121 -0
  175. package/templates/skills/vercel-react-native-skills/metadata.json +16 -0
  176. package/templates/skills/vercel-react-native-skills/rules/_sections.md +86 -0
  177. package/templates/skills/vercel-react-native-skills/rules/_template.md +28 -0
  178. package/templates/skills/vercel-react-native-skills/rules/animation-derived-value.md +53 -0
  179. package/templates/skills/vercel-react-native-skills/rules/animation-gesture-detector-press.md +95 -0
  180. package/templates/skills/vercel-react-native-skills/rules/animation-gpu-properties.md +65 -0
  181. package/templates/skills/vercel-react-native-skills/rules/design-system-compound-components.md +66 -0
  182. package/templates/skills/vercel-react-native-skills/rules/fonts-config-plugin.md +71 -0
  183. package/templates/skills/vercel-react-native-skills/rules/imports-design-system-folder.md +68 -0
  184. package/templates/skills/vercel-react-native-skills/rules/js-hoist-intl.md +61 -0
  185. package/templates/skills/vercel-react-native-skills/rules/list-performance-callbacks.md +44 -0
  186. package/templates/skills/vercel-react-native-skills/rules/list-performance-function-references.md +132 -0
  187. package/templates/skills/vercel-react-native-skills/rules/list-performance-images.md +53 -0
  188. package/templates/skills/vercel-react-native-skills/rules/list-performance-inline-objects.md +97 -0
  189. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-expensive.md +94 -0
  190. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-memo.md +82 -0
  191. package/templates/skills/vercel-react-native-skills/rules/list-performance-item-types.md +104 -0
  192. package/templates/skills/vercel-react-native-skills/rules/list-performance-virtualize.md +67 -0
  193. package/templates/skills/vercel-react-native-skills/rules/monorepo-native-deps-in-app.md +46 -0
  194. package/templates/skills/vercel-react-native-skills/rules/monorepo-single-dependency-versions.md +63 -0
  195. package/templates/skills/vercel-react-native-skills/rules/navigation-native-navigators.md +188 -0
  196. package/templates/skills/vercel-react-native-skills/rules/react-compiler-destructure-functions.md +50 -0
  197. package/templates/skills/vercel-react-native-skills/rules/react-compiler-reanimated-shared-values.md +48 -0
  198. package/templates/skills/vercel-react-native-skills/rules/react-state-dispatcher.md +91 -0
  199. package/templates/skills/vercel-react-native-skills/rules/react-state-fallback.md +56 -0
  200. package/templates/skills/vercel-react-native-skills/rules/react-state-minimize.md +65 -0
  201. package/templates/skills/vercel-react-native-skills/rules/rendering-no-falsy-and.md +74 -0
  202. package/templates/skills/vercel-react-native-skills/rules/rendering-text-in-text-component.md +36 -0
  203. package/templates/skills/vercel-react-native-skills/rules/scroll-position-no-state.md +82 -0
  204. package/templates/skills/vercel-react-native-skills/rules/state-ground-truth.md +80 -0
  205. package/templates/skills/vercel-react-native-skills/rules/ui-expo-image.md +66 -0
  206. package/templates/skills/vercel-react-native-skills/rules/ui-image-gallery.md +104 -0
  207. package/templates/skills/vercel-react-native-skills/rules/ui-measure-views.md +78 -0
  208. package/templates/skills/vercel-react-native-skills/rules/ui-menus.md +174 -0
  209. package/templates/skills/vercel-react-native-skills/rules/ui-native-modals.md +77 -0
  210. package/templates/skills/vercel-react-native-skills/rules/ui-pressable.md +61 -0
  211. package/templates/skills/vercel-react-native-skills/rules/ui-safe-area-scroll.md +65 -0
  212. package/templates/skills/vercel-react-native-skills/rules/ui-scrollview-content-inset.md +45 -0
  213. package/templates/skills/vercel-react-native-skills/rules/ui-styling.md +87 -0
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "fontdata",
3
- "version": "4.4.0",
3
+ "version": "4.5.0",
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.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
@@ -142,6 +142,22 @@ 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 — 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
+
145
161
  ### Hook `delphi-encoding`
146
162
 
147
163
  | Arquivo | Antes de `Edit`/`MultiEdit` | Depois de `Write`/`Edit`/`MultiEdit` |
@@ -196,6 +212,28 @@ npx @fontdata/ai-harness delphi encoding checar --todos
196
212
  `--todos` pega os fontes Delphi versionados (`git ls-files`) fora de `delphi.ignorar`. Arquivo passado pelo nome é
197
213
  processado mesmo que case com `delphi.ignorar`.
198
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
+
199
237
  ## Conexões de banco de dados
200
238
 
201
239
  O Claude pode ler o banco do projeto (PostgreSQL, MariaDB ou SQLite) sem que ninguém cole credencial no chat. O
@@ -247,6 +285,7 @@ projeto, cadastro, limites do filtro, produção, mascaramento e dúvidas freque
247
285
  | `versao detectar\|calcular\|aplicar` | Fontes de versão do projeto, próxima versão e gravação nos arquivos (veja abaixo) |
248
286
  | `delphi classificar\|extrair-icone` | Classifica os `.res` versionados de um projeto Delphi e extrai o ícone que só existe no `.res` |
249
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)) |
250
289
  | `list` | Lista o catálogo |
251
290
 
252
291
  O `mapa` lê TS/JS, Delphi, Python, C#, Java, Kotlin, Go, PHP, Rust e Dart. Outra linguagem, ou outra regra para uma
@@ -305,11 +344,30 @@ Os formatos estão em [`docs/contratos/ARTEFATOS.md`](docs/contratos/ARTEFATOS.m
305
344
  | `proteger-contratos` | SPEC, PLAN ou CLAUDE.md reescritos durante a execução de um trabalho | aviso |
306
345
  | `task-so-fecha-verde` | Task marcada como concluída sem suíte verde no rastro | aviso |
307
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 |
308
348
 
309
349
  O modo de cada hook (`aviso`, `bloqueio` ou `desligado`) fica em `.ai-harness/config.json`. Hook que falha
310
350
  internamente não atrapalha o trabalho — exceto o de segurança em modo bloqueio. Projetos Delphi recebem também o
311
351
  hook `delphi-encoding`, do [perfil Delphi](#perfil-delphi).
312
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
+ ```
370
+
313
371
  ### Agents somente leitura
314
372
 
315
373
  | Agent | Papel |
@@ -350,7 +408,7 @@ também acionado pelo modelo quando o pedido combina.
350
408
  - `/memoria` **(skill)** — mostra quem já mexeu num arquivo e por quê e aponta regressões candidatas de um bug
351
409
  - `/auditar-ui` **(skill)** — navega a aplicação via Playwright MCP e audita UX/UI e acessibilidade
352
410
  - `/auditar-performance` **(skill)** — mede e audita gargalos de performance
353
- - `/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
354
412
 
355
413
  ### Utilitário
356
414
  - `/git-commit-push` ⭐ — gera a mensagem (PT-BR, Conventional Commits) e faz add, commit e push
@@ -378,6 +436,21 @@ A skill `lgpd-checker`, usada pela auditoria de segurança, é uma cópia vendor
378
436
  [bittencourtthulio/lgpd-checker](https://github.com/bittencourtthulio/lgpd-checker); veja
379
437
  `templates/skills/lgpd-checker/ORIGEM.md`.
380
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
+
381
454
  ## Fluxo recomendado
382
455
 
383
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,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,7 @@ 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 },
78
80
  delphi: { ignorar: [...DELPHI_IGNORAR_PADRAO] },
79
81
  };
80
82
  }
@@ -242,11 +244,14 @@ export function readConfig(root) {
242
244
  else
243
245
  problems.push(`comentarios.instalar deve ser true ou false em ${CONFIG_PATH}.`);
244
246
  }
245
- if (isObject(raw.perfis) && 'delphi' in raw.perfis) {
246
- if (typeof raw.perfis.delphi === 'boolean')
247
- config.perfis.delphi = raw.perfis.delphi;
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;
248
253
  else
249
- problems.push(`perfis.delphi deve ser true ou false em ${CONFIG_PATH}.`);
254
+ problems.push(`perfis.${perfil} deve ser true ou false em ${CONFIG_PATH}.`);
250
255
  }
251
256
  if (isObject(raw.delphi) && 'ignorar' in raw.delphi) {
252
257
  const ignorar = raw.delphi.ignorar;
@@ -390,23 +395,26 @@ export function gravarInstalarComentarios(root, valor) {
390
395
  writeFileSync(file, `${JSON.stringify(proxima, null, 2)}\n`);
391
396
  }
392
397
  /**
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.
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.
396
401
  */
397
- export function gravarPerfilDelphi(root, valor) {
402
+ export function gravarPerfil(root, perfil, valor) {
398
403
  const file = join(root, CONFIG_PATH);
399
404
  if (!existsSync(file) && valor)
400
405
  return;
401
- const raw = existsSync(file) ? lerJsonParaEscrita(file, 'perfis.delphi') : configGravada();
402
- const { delphi: atual, ...resto } = isObject(raw.perfis) ? raw.perfis : {};
406
+ const raw = existsSync(file) ? lerJsonParaEscrita(file, `perfis.${perfil}`) : configGravada();
407
+ const { [perfil]: atual, ...resto } = isObject(raw.perfis) ? raw.perfis : {};
403
408
  if (valor ? atual === undefined || atual === true : atual === false)
404
409
  return;
405
410
  const { perfis: _perfis, ...semSecao } = raw;
406
- const proxima = valor ? (Object.keys(resto).length ? { ...raw, perfis: resto } : semSecao) : { ...raw, perfis: { ...resto, delphi: false } };
411
+ const proxima = valor ? (Object.keys(resto).length ? { ...raw, perfis: resto } : semSecao) : { ...raw, perfis: { ...resto, [perfil]: false } };
407
412
  mkdirSync(dirname(file), { recursive: true });
408
413
  writeFileSync(file, `${JSON.stringify(proxima, null, 2)}\n`);
409
414
  }
415
+ export function gravarPerfilDelphi(root, valor) {
416
+ gravarPerfil(root, 'delphi', valor);
417
+ }
410
418
  const BLOCK_START = '# ai-harness (gerenciado pelo harness; não edite entre estas linhas)';
411
419
  const BLOCK_END = '# /ai-harness';
412
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
  }
@@ -1,8 +1,9 @@
1
- import { existsSync, readFileSync, writeFileSync } from 'node:fs';
1
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
2
2
  import { basename, dirname, extname, join, resolve } from 'node:path';
3
3
  import { readConfig } from '../config/config.js';
4
4
  import { acharRaiz } from '../raiz.js';
5
5
  import { git } from '../trabalhos/arquivar.js';
6
+ import { acharUnitsFontdata, CAMINHO_CATALOGO, estadoDoCatalogo, gerarCatalogo, pastasDoSearchPath } from './catalogo.js';
6
7
  import { classificarRes, detectarDelphi, emRepositorioGit } from './classificar.js';
7
8
  import { casaGlob, checarArquivo, converterParaUtf8Bom, detectarEncoding, detectarEol, EXTENSOES_CONVERTER, EXTENSOES_DELPHI, } from './encoding.js';
8
9
  import { extrairIcone } from './icone.js';
@@ -12,7 +13,8 @@ const USO = `Uso:
12
13
  npx @fontdata/ai-harness delphi extrair-icone <arquivo.res> [--saida <arquivo.ico>]
13
14
  npx @fontdata/ai-harness delphi encoding detectar <arquivos...|--todos>
14
15
  npx @fontdata/ai-harness delphi encoding converter <arquivos .pas/.dpr/.dpk/.inc...>
15
- npx @fontdata/ai-harness delphi encoding checar <arquivos...|--todos>`;
16
+ npx @fontdata/ai-harness delphi encoding checar <arquivos...|--todos>
17
+ npx @fontdata/ai-harness delphi catalogo [--pasta <dir> ...] [--check]`;
16
18
  function classificar(args) {
17
19
  const json = args.includes('--json');
18
20
  const posicionais = args.filter((arg) => arg !== '--json');
@@ -164,6 +166,43 @@ function encoding(args) {
164
166
  const fontes = fontesPedidas(resto);
165
167
  return fontes ? acao(fontes) : 1;
166
168
  }
169
+ function catalogo(args) {
170
+ const pastas = [];
171
+ let check = false;
172
+ for (let i = 0; i < args.length; i++) {
173
+ const pasta = args[i] === '--pasta' ? args[++i] : undefined;
174
+ if (pasta)
175
+ pastas.push(resolve(process.cwd(), pasta));
176
+ else if (args[i] === '--check')
177
+ check = true;
178
+ else {
179
+ console.error(USO);
180
+ return 1;
181
+ }
182
+ }
183
+ const raiz = acharRaiz();
184
+ const units = acharUnitsFontdata(pastas.length > 0 ? pastas : pastasDoSearchPath(raiz));
185
+ if (units.length === 0) {
186
+ const onde = pastas.length > 0 ? 'nas pastas informadas' : 'no DCC_UnitSearchPath dos .dproj do projeto';
187
+ console.error(`Nenhuma unit Fontdata.*.pas encontrada ${onde}. Passe --pasta <dir> com a pasta das units.`);
188
+ return 1;
189
+ }
190
+ const destino = join(raiz, CAMINHO_CATALOGO);
191
+ if (check) {
192
+ const estado = estadoDoCatalogo(destino, units);
193
+ if (estado === 'em-dia') {
194
+ console.log(`O catálogo ${CAMINHO_CATALOGO} está em dia com ${units.length} unit(s) Fontdata.`);
195
+ return 0;
196
+ }
197
+ const motivo = estado === 'ausente' ? 'não existe' : 'está desatualizado';
198
+ console.error(`O catálogo ${CAMINHO_CATALOGO} ${motivo}: rode npx @fontdata/ai-harness delphi catalogo.`);
199
+ return 1;
200
+ }
201
+ mkdirSync(dirname(destino), { recursive: true });
202
+ writeFileSync(destino, gerarCatalogo(units));
203
+ console.log(`Catálogo de ${units.length} unit(s) Fontdata gravado em ${CAMINHO_CATALOGO}.`);
204
+ return 0;
205
+ }
167
206
  export async function runDelphiCommand(args) {
168
207
  const [sub, ...resto] = args;
169
208
  if (sub === 'classificar')
@@ -172,6 +211,8 @@ export async function runDelphiCommand(args) {
172
211
  return extrairIconeDoRes(resto);
173
212
  if (sub === 'encoding')
174
213
  return encoding(resto);
214
+ if (sub === 'catalogo')
215
+ return catalogo(resto);
175
216
  console.error(USO);
176
217
  return 1;
177
218
  }
@@ -8,6 +8,7 @@ import { COMMENTS_HOOK_PATH, hookProprioRegistrado } from '../comentarios/instal
8
8
  import { CONFIG_PATH, readConfig } from '../config/config.js';
9
9
  import { ARCHIVE_DIR_NAME, ARTIFACT_TYPES, listWorkFiles, readArtifact, validateAllWorks, WORKS_DIR } from '../contratos/artefatos.js';
10
10
  import { validateEventLog } from '../contratos/eventos.js';
11
+ import { CAMINHO_CATALOGO, checarCatalogo } from '../delphi/catalogo.js';
11
12
  import { classificarRes } from '../delphi/classificar.js';
12
13
  import { hashContent, LOCK_PATH, LOCK_VERSION } from '../install/lock.js';
13
14
  import { agentsForaDoLock, itemSources } from '../install/plan.js';
@@ -264,6 +265,23 @@ function checkDelphiRes(root) {
264
265
  correcao: 'Rode a etapa `/harness ignores` para classificar, extrair o ícone se preciso e tirar o .res do versionamento com aprovação.',
265
266
  }));
266
267
  }
268
+ function checkCatalogoFontdata(root, lock) {
269
+ if (!lock.itens.some((item) => item.tipo === 'perfil' && item.id === 'delphi'))
270
+ return [];
271
+ const estado = checarCatalogo(root);
272
+ if (estado !== 'ausente' && estado !== 'desatualizado')
273
+ return [];
274
+ return [
275
+ {
276
+ id: `catalogo-fontdata-${estado}`,
277
+ severidade: 'aviso',
278
+ mensagem: estado === 'ausente'
279
+ ? `O search path do projeto tem units Fontdata.*, mas o catálogo ${CAMINHO_CATALOGO} não existe.`
280
+ : `O catálogo ${CAMINHO_CATALOGO} não bate com as units Fontdata.* do search path.`,
281
+ correcao: 'Rode `npx @fontdata/ai-harness delphi catalogo` para gerar o catálogo de novo.',
282
+ },
283
+ ];
284
+ }
267
285
  function checkWorks(root) {
268
286
  return validateAllWorks(root).map((problem) => ({
269
287
  id: `contrato-${problem.regra}`,
@@ -655,7 +673,7 @@ export function runDoctor(root, options = {}) {
655
673
  return [
656
674
  ...checkNode(options.nodeVersion ?? process.versions.node),
657
675
  ...lockFindings,
658
- ...(lock ? [...checkFiles(root, lock), ...checkRequiredSkills(root, lock), ...checkMissingHarnessAgents(root, lock), ...checkComments(root, lock, config)] : []),
676
+ ...(lock ? [...checkFiles(root, lock), ...checkRequiredSkills(root, lock), ...checkMissingHarnessAgents(root, lock), ...checkComments(root, lock, config), ...checkCatalogoFontdata(root, lock)] : []),
659
677
  ...checkShadowedCommands(root),
660
678
  ...checkOldCommentsBlock(root),
661
679
  ...checkAgents(root),