@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.
- package/.claude-plugin/plugin.json +2 -2
- package/README.md +74 -1
- package/dist/cli.js +1 -0
- package/dist/config/config.js +20 -12
- package/dist/delphi/catalogo.js +299 -0
- package/dist/delphi/classificar.js +21 -0
- package/dist/delphi/command.js +43 -2
- package/dist/doctor/checks.js +19 -1
- package/dist/init.js +9 -1
- package/dist/install/perfis.js +11 -4
- package/dist/mapa/extratores/pascal.js +1 -1
- package/dist/update/update.js +80 -23
- package/package.json +1 -1
- package/templates/CLAUDE.md +2 -1
- package/templates/catalog.json +9 -4
- package/templates/hooks/comentarios/check.mjs +62 -5
- package/templates/hooks/hooks.json +2 -1
- package/templates/hooks/lib/config.mjs +1 -0
- package/templates/hooks/padroes-proibidos.mjs +68 -0
- package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md +6 -6
- package/templates/perfis/delphi/skills/conhecimento-delphi/SKILL.md +6 -0
- package/templates/perfis/delphi-fiscal/rules/campo-novo-acbr-preenchimento-explicito.md +61 -0
- package/templates/perfis/delphi-fiscal/rules/retorno-de-evento-nfe-pelo-cstat.md +51 -0
- package/templates/perfis/delphi-fiscal/rules/sucesso-de-webservice-fiscal-nao-prova-documento.md +100 -0
- package/templates/perfis/delphi-fiscal/rules/total-tributo-acbr-soma-itens.md +63 -0
- package/templates/perfis/delphi-fiscal/skills/diagnosticar-rejeicao-nfse/SKILL.md +155 -0
- package/templates/perfis/delphi-fiscal/skills/patch-acbr/SKILL.md +143 -0
- package/templates/skills/auditar-performance/SKILL.md +9 -0
- package/templates/skills/auditar-performance/references/pontos-quentes.md +8 -0
- package/templates/skills/auditar-seguranca/SKILL.md +55 -14
- package/templates/skills/auditar-seguranca/templates/relatorios/TECNICO.md +5 -0
- package/templates/skills/auditar-ui/SKILL.md +18 -3
- package/templates/skills/auditar-ui/references/ATRIBUICAO.md +44 -0
- package/templates/skills/auditar-ui/references/web-interface-guidelines.md +191 -0
- package/templates/skills/harness/references/validar-ideia.md +7 -6
- package/templates/skills/security-audit/AI-AND-LLM.md +83 -0
- package/templates/skills/security-audit/ATTACK-CLASSES.md +130 -0
- package/templates/skills/security-audit/CLIENT-SIDE.md +83 -0
- package/templates/skills/security-audit/CLOUD-AND-DEPLOYMENT.md +86 -0
- package/templates/skills/security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -0
- package/templates/skills/security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -0
- package/templates/skills/security-audit/HUNTING.md +251 -0
- package/templates/skills/security-audit/LICENSE +21 -0
- package/templates/skills/security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -0
- package/templates/skills/security-audit/ORIGEM.md +51 -0
- package/templates/skills/security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -0
- package/templates/skills/security-audit/RECONNAISSANCE.md +156 -0
- package/templates/skills/security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -0
- package/templates/skills/security-audit/SKILL.md +192 -0
- package/templates/skills/security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -0
- package/templates/skills/security-audit/VALIDATION-AND-REPORTING.md +186 -0
- package/templates/skills/security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -0
- package/templates/skills/security-audit/report-schema.json +461 -0
- package/templates/skills/security-audit/validate-coverage-ledger.cjs +872 -0
- package/templates/skills/security-audit/validate-findings.cjs +773 -0
- package/templates/skills/supabase-postgres-best-practices/CHANGELOG.md +73 -0
- package/templates/skills/supabase-postgres-best-practices/LICENSE +21 -0
- package/templates/skills/supabase-postgres-best-practices/ORIGEM.md +43 -0
- package/templates/skills/supabase-postgres-best-practices/SKILL.md +64 -0
- package/templates/skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
- package/templates/skills/supabase-postgres-best-practices/references/_sections.md +39 -0
- package/templates/skills/supabase-postgres-best-practices/references/_template.md +34 -0
- package/templates/skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
- package/templates/skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
- package/templates/skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
- package/templates/skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
- package/templates/skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
- package/templates/skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
- package/templates/skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
- package/templates/skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
- package/templates/skills/supabase-postgres-best-practices/references/security-rls-performance.md +63 -0
- package/templates/skills/vercel-react-best-practices/AGENTS.md +3810 -0
- package/templates/skills/vercel-react-best-practices/ORIGEM.md +39 -0
- package/templates/skills/vercel-react-best-practices/README.md +123 -0
- package/templates/skills/vercel-react-best-practices/SKILL.md +149 -0
- package/templates/skills/vercel-react-best-practices/metadata.json +15 -0
- package/templates/skills/vercel-react-best-practices/rules/_sections.md +46 -0
- package/templates/skills/vercel-react-best-practices/rules/_template.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
- package/templates/skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
- package/templates/skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
- package/templates/skills/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
- package/templates/skills/vercel-react-best-practices/rules/async-defer-await.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
- package/templates/skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
- package/templates/skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
- package/templates/skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
- package/templates/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
- package/templates/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
- package/templates/skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
- package/templates/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
- package/templates/skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
- package/templates/skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
- package/templates/skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
- package/templates/skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
- package/templates/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
- package/templates/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
- package/templates/skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
- package/templates/skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
- package/templates/skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
- package/templates/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
- package/templates/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
- package/templates/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
- package/templates/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
- package/templates/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
- package/templates/skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
- package/templates/skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
- package/templates/skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
- package/templates/skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
- package/templates/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
- package/templates/skills/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
- package/templates/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
- package/templates/skills/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
- package/templates/skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
- package/templates/skills/vercel-react-native-skills/AGENTS.md +2897 -0
- package/templates/skills/vercel-react-native-skills/ORIGEM.md +39 -0
- package/templates/skills/vercel-react-native-skills/README.md +165 -0
- package/templates/skills/vercel-react-native-skills/SKILL.md +121 -0
- package/templates/skills/vercel-react-native-skills/metadata.json +16 -0
- package/templates/skills/vercel-react-native-skills/rules/_sections.md +86 -0
- package/templates/skills/vercel-react-native-skills/rules/_template.md +28 -0
- package/templates/skills/vercel-react-native-skills/rules/animation-derived-value.md +53 -0
- package/templates/skills/vercel-react-native-skills/rules/animation-gesture-detector-press.md +95 -0
- package/templates/skills/vercel-react-native-skills/rules/animation-gpu-properties.md +65 -0
- package/templates/skills/vercel-react-native-skills/rules/design-system-compound-components.md +66 -0
- package/templates/skills/vercel-react-native-skills/rules/fonts-config-plugin.md +71 -0
- package/templates/skills/vercel-react-native-skills/rules/imports-design-system-folder.md +68 -0
- package/templates/skills/vercel-react-native-skills/rules/js-hoist-intl.md +61 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-callbacks.md +44 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-function-references.md +132 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-images.md +53 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-inline-objects.md +97 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-item-expensive.md +94 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-item-memo.md +82 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-item-types.md +104 -0
- package/templates/skills/vercel-react-native-skills/rules/list-performance-virtualize.md +67 -0
- package/templates/skills/vercel-react-native-skills/rules/monorepo-native-deps-in-app.md +46 -0
- package/templates/skills/vercel-react-native-skills/rules/monorepo-single-dependency-versions.md +63 -0
- package/templates/skills/vercel-react-native-skills/rules/navigation-native-navigators.md +188 -0
- package/templates/skills/vercel-react-native-skills/rules/react-compiler-destructure-functions.md +50 -0
- package/templates/skills/vercel-react-native-skills/rules/react-compiler-reanimated-shared-values.md +48 -0
- package/templates/skills/vercel-react-native-skills/rules/react-state-dispatcher.md +91 -0
- package/templates/skills/vercel-react-native-skills/rules/react-state-fallback.md +56 -0
- package/templates/skills/vercel-react-native-skills/rules/react-state-minimize.md +65 -0
- package/templates/skills/vercel-react-native-skills/rules/rendering-no-falsy-and.md +74 -0
- package/templates/skills/vercel-react-native-skills/rules/rendering-text-in-text-component.md +36 -0
- package/templates/skills/vercel-react-native-skills/rules/scroll-position-no-state.md +82 -0
- package/templates/skills/vercel-react-native-skills/rules/state-ground-truth.md +80 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-expo-image.md +66 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-image-gallery.md +104 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-measure-views.md +78 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-menus.md +174 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-native-modals.md +77 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-pressable.md +61 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-safe-area-scroll.md +65 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-scrollview-content-inset.md +45 -0
- package/templates/skills/vercel-react-native-skills/rules/ui-styling.md +87 -0
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "fontdata",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "4.5.0",
|
|
4
4
|
"mcpServers": {
|
|
5
|
-
"banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.
|
|
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
|
package/dist/config/config.js
CHANGED
|
@@ -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
|
-
|
|
246
|
-
if (
|
|
247
|
-
|
|
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
|
|
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
|
|
394
|
-
*
|
|
395
|
-
*
|
|
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
|
|
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,
|
|
402
|
-
const {
|
|
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,
|
|
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
|
}
|
package/dist/delphi/command.js
CHANGED
|
@@ -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
|
}
|
package/dist/doctor/checks.js
CHANGED
|
@@ -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),
|