@fontdata/ai-harness 4.4.0 → 4.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +2 -2
- package/README.md +94 -1
- package/dist/cli.js +1 -0
- package/dist/config/config.js +24 -13
- package/dist/delphi/catalogo.js +308 -0
- package/dist/delphi/classificar.js +27 -2
- package/dist/delphi/command.js +50 -2
- package/dist/delphi/uses.js +90 -0
- package/dist/doctor/checks.js +37 -1
- package/dist/init.js +9 -1
- package/dist/install/perfis.js +15 -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.1",
|
|
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.1", "banco-dados-mcp"] }
|
|
6
6
|
},
|
|
7
7
|
"description": "Harness de engenharia com IA da Fontdata para Claude Code",
|
|
8
8
|
"author": { "name": "Fontdata" },
|
package/README.md
CHANGED
|
@@ -142,6 +142,32 @@ o aviso fica em `.claude/skills/conhecimento-delphi/references/ATRIBUICAO.md`.
|
|
|
142
142
|
O `update` não sobrescreve arquivo do projeto que já exista num caminho do perfil, nem com `--forcar`, e não apaga
|
|
143
143
|
rules do projeto que repetem uma rule do perfil: tirar a duplicata fica com você.
|
|
144
144
|
|
|
145
|
+
### Perfil `delphi-fiscal`
|
|
146
|
+
|
|
147
|
+
Quando o projeto recebe o perfil Delphi e usa ACBr, o `init` e o `update` instalam também o perfil `delphi-fiscal`,
|
|
148
|
+
como o item `perfil:delphi-fiscal` no lock. Como o perfil Delphi, ele fica fora do plugin. O ACBr é detectado assim:
|
|
149
|
+
|
|
150
|
+
- algum `.dproj` (pelo mesmo critério de detecção do Delphi) ou o `boss.json` da raiz cita `ACBr`, sem diferenciar
|
|
151
|
+
maiúsculas;
|
|
152
|
+
- senão, alguma `.pas` ou `.dpr` tem uma unit `ACBr...` (como `ACBrNFe`) na cláusula `uses`, fora de comentário e de
|
|
153
|
+
string. Isso pega o projeto que usa ACBr por DCU pré-compilada, sem pacote no `.dproj` nem `boss.json`. Num
|
|
154
|
+
repositório git, só contam os arquivos versionados (`git ls-files`); fora dele, os encontrados até 4 níveis de
|
|
155
|
+
pasta. Nos dois casos, o que casa com `delphi.ignorar` fica de fora.
|
|
156
|
+
|
|
157
|
+
Se a detecção não pegar o seu caso, grave `"perfis": { "delphi-fiscal": true }` no `.ai-harness/config.json` e rode
|
|
158
|
+
`npx @fontdata/ai-harness update --yes`: o `true` gravado no arquivo liga o perfil mesmo sem ACBr detectado. Sem a
|
|
159
|
+
chave, a detecção decide.
|
|
160
|
+
|
|
161
|
+
| O que instala | Onde |
|
|
162
|
+
|---|---|
|
|
163
|
+
| 4 rules de documento fiscal com ACBr: sucesso do webservice não prova o documento, campo novo do ACBr preenchido explicitamente, total de tributo como soma dos itens e retorno de evento da NF-e pelo `cStat` | `.claude/rules/delphi-fiscal/` |
|
|
164
|
+
| Skills `patch-acbr` e `diagnosticar-rejeicao-nfse` | `.claude/skills/patch-acbr/` e `.claude/skills/diagnosticar-rejeicao-nfse/` |
|
|
165
|
+
|
|
166
|
+
Para recusar, grave `"perfis": { "delphi-fiscal": false }` no `.ai-harness/config.json` e rode
|
|
167
|
+
`npx @fontdata/ai-harness update --yes`: o `update` tira o item do lock e **mantém** os arquivos. A recusa do perfil
|
|
168
|
+
Delphi (`perfis.delphi: false`) recusa também o fiscal e tira os dois itens do lock, mesmo com o `true` do fiscal
|
|
169
|
+
gravado. Sem o perfil Delphi, por recusa ou porque o projeto não é Delphi, o fiscal não é instalado.
|
|
170
|
+
|
|
145
171
|
### Hook `delphi-encoding`
|
|
146
172
|
|
|
147
173
|
| Arquivo | Antes de `Edit`/`MultiEdit` | Depois de `Write`/`Edit`/`MultiEdit` |
|
|
@@ -196,6 +222,38 @@ npx @fontdata/ai-harness delphi encoding checar --todos
|
|
|
196
222
|
`--todos` pega os fontes Delphi versionados (`git ls-files`) fora de `delphi.ignorar`. Arquivo passado pelo nome é
|
|
197
223
|
processado mesmo que case com `delphi.ignorar`.
|
|
198
224
|
|
|
225
|
+
### Comando `delphi catalogo`
|
|
226
|
+
|
|
227
|
+
```bash
|
|
228
|
+
npx @fontdata/ai-harness delphi catalogo
|
|
229
|
+
npx @fontdata/ai-harness delphi catalogo --pasta ../Bibliotecas/Fontdata --check
|
|
230
|
+
```
|
|
231
|
+
|
|
232
|
+
Gera o catálogo das Bibliotecas Fontdata em `.claude/skills/conhecimento-delphi/references/bibliotecas-fontdata.md`,
|
|
233
|
+
na raiz do projeto, que a skill `conhecimento-delphi` e a rule de reaproveitamento mandam consultar antes de criar um
|
|
234
|
+
helper. Por unit `Fontdata.*.pas`, ele traz os tipos públicos da `interface` e, de cada tipo, os métodos e as
|
|
235
|
+
propriedades `public` e `published`, com a assinatura; os class helpers trazem também o tipo que estendem. A lista de
|
|
236
|
+
fontes guarda o nome de cada unit e o `sha256` do conteúdo, sem caminho, então o catálogo pode ser versionado.
|
|
237
|
+
|
|
238
|
+
- Sem `--pasta`, as units são procuradas nas pastas do `DCC_UnitSearchPath` de todos os `.dproj` do projeto. A
|
|
239
|
+
entrada relativa é resolvida a partir da pasta de cada `.dproj`, e a relativa com `$(...)` é ignorada.
|
|
240
|
+
- Um caminho absoluto do Windows ou UNC (`D:\DESEN\Delphi\Bibliotecas\Utils`, `\\servidor\share\Fontdata`) é usado
|
|
241
|
+
como está quando existe nesta máquina, o que é o caso no Windows. Se ele não existir, como no macOS ou no Linux, é
|
|
242
|
+
reancorado pelo sufixo: o trecho depois da raiz (`D:\`, `\\servidor\share`) é procurado sob cada pasta ancestral do
|
|
243
|
+
`.dproj`, do sufixo mais longo ao mais curto, com pelo menos 2 segmentos. Por exemplo, `D:\DESEN\Delphi\Bibliotecas\Utils`
|
|
244
|
+
casa com `~/Documents/DESEN/Delphi/Bibliotecas/Utils` quando o `.dproj` fica dentro de `~/Documents/DESEN`. O
|
|
245
|
+
caminho que não casa com nada fica sem resolver, e o absoluto com `$(...)` nunca é resolvido.
|
|
246
|
+
- `--pasta <dir>`, que pode se repetir, troca o search path pelas pastas informadas.
|
|
247
|
+
- `--check` não grava nada e sai com código 1 quando o catálogo falta ou diverge das units atuais.
|
|
248
|
+
|
|
249
|
+
Nenhuma unit encontrada é erro: o comando lista os caminhos absolutos do Windows que não foram encontrados nesta
|
|
250
|
+
máquina e pede `--pasta` com o caminho das Bibliotecas Fontdata. Num projeto com o perfil Delphi e units `Fontdata.*`
|
|
251
|
+
no search path, o `doctor` avisa `catalogo-fontdata-ausente` quando o catálogo não existe e
|
|
252
|
+
`catalogo-fontdata-desatualizado` quando ele não bate com as units. Quando nenhuma unit é achada, há caminho absoluto
|
|
253
|
+
sem resolver e alguma `.pas` ou `.dpr` usa uma unit `Fontdata.*` na cláusula `uses` (pelos mesmos arquivos e o mesmo
|
|
254
|
+
`delphi.ignorar` da detecção do ACBr), o `doctor` avisa `catalogo-fontdata-caminho-nao-resolvido`, lista os caminhos
|
|
255
|
+
e sugere `delphi catalogo --pasta <dir>`. Fora desses casos, não há aviso de catálogo.
|
|
256
|
+
|
|
199
257
|
## Conexões de banco de dados
|
|
200
258
|
|
|
201
259
|
O Claude pode ler o banco do projeto (PostgreSQL, MariaDB ou SQLite) sem que ninguém cole credencial no chat. O
|
|
@@ -247,6 +305,7 @@ projeto, cadastro, limites do filtro, produção, mascaramento e dúvidas freque
|
|
|
247
305
|
| `versao detectar\|calcular\|aplicar` | Fontes de versão do projeto, próxima versão e gravação nos arquivos (veja abaixo) |
|
|
248
306
|
| `delphi classificar\|extrair-icone` | Classifica os `.res` versionados de um projeto Delphi e extrai o ícone que só existe no `.res` |
|
|
249
307
|
| `delphi encoding detectar\|converter\|checar` | Encoding e EOL dos fontes Delphi: diagnóstico, conversão para UTF-8 com BOM e checagem (veja [Comando `delphi encoding`](#comando-delphi-encoding)) |
|
|
308
|
+
| `delphi catalogo` | Catálogo das units `Fontdata.*.pas` do search path dos `.dproj` (`--pasta <dir>`, `--check`; veja [Comando `delphi catalogo`](#comando-delphi-catalogo)) |
|
|
250
309
|
| `list` | Lista o catálogo |
|
|
251
310
|
|
|
252
311
|
O `mapa` lê TS/JS, Delphi, Python, C#, Java, Kotlin, Go, PHP, Rust e Dart. Outra linguagem, ou outra regra para uma
|
|
@@ -305,11 +364,30 @@ Os formatos estão em [`docs/contratos/ARTEFATOS.md`](docs/contratos/ARTEFATOS.m
|
|
|
305
364
|
| `proteger-contratos` | SPEC, PLAN ou CLAUDE.md reescritos durante a execução de um trabalho | aviso |
|
|
306
365
|
| `task-so-fecha-verde` | Task marcada como concluída sem suíte verde no rastro | aviso |
|
|
307
366
|
| `sem-jargao` | Termo técnico no relatório para o cliente | aviso |
|
|
367
|
+
| `padroes-proibidos` | `Edit`, `MultiEdit` ou `Write` que introduz um padrão declarado em `.ai-harness/padroes.json` | aviso |
|
|
308
368
|
|
|
309
369
|
O modo de cada hook (`aviso`, `bloqueio` ou `desligado`) fica em `.ai-harness/config.json`. Hook que falha
|
|
310
370
|
internamente não atrapalha o trabalho — exceto o de segurança em modo bloqueio. Projetos Delphi recebem também o
|
|
311
371
|
hook `delphi-encoding`, do [perfil Delphi](#perfil-delphi).
|
|
312
372
|
|
|
373
|
+
O `padroes-proibidos` vale para qualquer stack e só age no projeto que cria o `.ai-harness/padroes.json`; sem o
|
|
374
|
+
arquivo, ou com a lista vazia, ele não faz nada. Cada entrada traz as extensões, a regex, os flags e o motivo
|
|
375
|
+
mostrado ao agente. Só o padrão **introduzido** é acusado: o hook conta as ocorrências no texto antigo e no novo
|
|
376
|
+
(`old_string` contra `new_string` no `Edit`, a soma das `edits` no `MultiEdit`, o arquivo em disco contra o
|
|
377
|
+
`content` no `Write`) e acusa quando o novo tem mais. Dos flags, valem só `i`, `m`, `s` e `u`; uma entrada com regex
|
|
378
|
+
que não compila ou com campo faltando é ignorada, e as demais continuam valendo. Em `aviso` o motivo entra como
|
|
379
|
+
contexto, em `bloqueio` a edição é negada. O `update` registra no `.claude/settings.json` os hooks do núcleo que
|
|
380
|
+
faltam num projeto sem plugin e com os hooks do harness no lock, então um hook tirado à mão do settings volta no próximo `update`: para desligar, grave
|
|
381
|
+
`hooks["<nome>"]: "desligado"` no `.ai-harness/config.json`, por exemplo `"hooks": { "padroes-proibidos": "desligado" }`.
|
|
382
|
+
|
|
383
|
+
```json
|
|
384
|
+
{
|
|
385
|
+
"padroes": [
|
|
386
|
+
{ "extensoes": [".pas"], "regex": "Clipboard\\s*\\.\\s*AsText\\s*:=", "flags": "i", "motivo": "Use o helper de clipboard do projeto." }
|
|
387
|
+
]
|
|
388
|
+
}
|
|
389
|
+
```
|
|
390
|
+
|
|
313
391
|
### Agents somente leitura
|
|
314
392
|
|
|
315
393
|
| Agent | Papel |
|
|
@@ -350,7 +428,7 @@ também acionado pelo modelo quando o pedido combina.
|
|
|
350
428
|
- `/memoria` **(skill)** — mostra quem já mexeu num arquivo e por quê e aponta regressões candidatas de um bug
|
|
351
429
|
- `/auditar-ui` **(skill)** — navega a aplicação via Playwright MCP e audita UX/UI e acessibilidade
|
|
352
430
|
- `/auditar-performance` **(skill)** — mede e audita gargalos de performance
|
|
353
|
-
- `/auditar-seguranca` **(skill)** — auditoria defensiva de segurança e conformidade com a LGPD
|
|
431
|
+
- `/auditar-seguranca` **(skill)** — auditoria defensiva de segurança e conformidade com a LGPD, com os perfis `quick` (padrão), `standard` e `deep` (`/auditar-seguranca deep`); no fim, oferece criar o trabalho de correção, com uma task por achado
|
|
354
432
|
|
|
355
433
|
### Utilitário
|
|
356
434
|
- `/git-commit-push` ⭐ — gera a mensagem (PT-BR, Conventional Commits) e faz add, commit e push
|
|
@@ -378,6 +456,21 @@ A skill `lgpd-checker`, usada pela auditoria de segurança, é uma cópia vendor
|
|
|
378
456
|
[bittencourtthulio/lgpd-checker](https://github.com/bittencourtthulio/lgpd-checker); veja
|
|
379
457
|
`templates/skills/lgpd-checker/ORIGEM.md`.
|
|
380
458
|
|
|
459
|
+
As outras skills e referências de terceiros também são cópias vendorizadas, sem alteração no conteúdo e com a
|
|
460
|
+
licença MIT de origem. Créditos aos autores:
|
|
461
|
+
|
|
462
|
+
- `security-audit`, da Cloudflare — [cloudflare/security-audit-skill](https://github.com/cloudflare/security-audit-skill);
|
|
463
|
+
usada pelo `/auditar-seguranca`. Veja `templates/skills/security-audit/ORIGEM.md`.
|
|
464
|
+
- `vercel-react-best-practices`, da Vercel — [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills);
|
|
465
|
+
usada pelo `/auditar-performance`. Veja `templates/skills/vercel-react-best-practices/ORIGEM.md`.
|
|
466
|
+
- `vercel-react-native-skills`, da Vercel — [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills);
|
|
467
|
+
usada pelo `/auditar-performance`. Veja `templates/skills/vercel-react-native-skills/ORIGEM.md`.
|
|
468
|
+
- `supabase-postgres-best-practices`, da Supabase — [supabase/agent-skills](https://github.com/supabase/agent-skills);
|
|
469
|
+
usada pelo `/auditar-performance`. Veja `templates/skills/supabase-postgres-best-practices/ORIGEM.md`.
|
|
470
|
+
- Web Interface Guidelines, da Vercel — [vercel-labs/web-interface-guidelines](https://github.com/vercel-labs/web-interface-guidelines);
|
|
471
|
+
referência do `/auditar-ui`, em `templates/skills/auditar-ui/references/web-interface-guidelines.md`. Veja
|
|
472
|
+
`templates/skills/auditar-ui/references/ATRIBUICAO.md`.
|
|
473
|
+
|
|
381
474
|
## Fluxo recomendado
|
|
382
475
|
|
|
383
476
|
O jeito mais simples é rodar **`/harness`**, que pergunta se o projeto é novo ou existente e conduz as etapas:
|
package/dist/cli.js
CHANGED
|
@@ -72,6 +72,7 @@ Gerenciar:
|
|
|
72
72
|
banco-dados-mcp Servidor MCP de leitura do banco, usado pelo Claude Code (stdio)
|
|
73
73
|
versao detectar|calcular|aplicar Fontes de versão, próxima versão e gravação (--app, --json; aplicar --dry-run)
|
|
74
74
|
delphi classificar|extrair-icone .res de projetos Delphi: classificação e extração do ícone
|
|
75
|
+
delphi catalogo Catálogo da API das units Fontdata.*.pas do search path (--pasta <dir>, --check)
|
|
75
76
|
mapa [caminho] Símbolos públicos por pasta, compartilhadas primeiro (--limite <n>, padrão 4000 caracteres)
|
|
76
77
|
atalhos [caminho] TODO:/FIXME: do código-fonte, marcando os sem gatilho (--sem-gatilho, --json)
|
|
77
78
|
list Lista todos os comandos disponíveis no catálogo
|
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,8 @@ export function defaultConfig() {
|
|
|
74
76
|
declarado: false,
|
|
75
77
|
},
|
|
76
78
|
comentarios: { instalar: true },
|
|
77
|
-
perfis: { delphi: true },
|
|
79
|
+
perfis: { delphi: true, 'delphi-fiscal': true },
|
|
80
|
+
perfisExplicitos: {},
|
|
78
81
|
delphi: { ignorar: [...DELPHI_IGNORAR_PADRAO] },
|
|
79
82
|
};
|
|
80
83
|
}
|
|
@@ -242,11 +245,16 @@ export function readConfig(root) {
|
|
|
242
245
|
else
|
|
243
246
|
problems.push(`comentarios.instalar deve ser true ou false em ${CONFIG_PATH}.`);
|
|
244
247
|
}
|
|
245
|
-
|
|
246
|
-
if (
|
|
247
|
-
|
|
248
|
+
for (const perfil of PERFIS_DO_CONFIG) {
|
|
249
|
+
if (!isObject(raw.perfis) || !(perfil in raw.perfis))
|
|
250
|
+
continue;
|
|
251
|
+
const valor = raw.perfis[perfil];
|
|
252
|
+
if (typeof valor === 'boolean') {
|
|
253
|
+
config.perfis[perfil] = valor;
|
|
254
|
+
config.perfisExplicitos[perfil] = valor;
|
|
255
|
+
}
|
|
248
256
|
else
|
|
249
|
-
problems.push(`perfis
|
|
257
|
+
problems.push(`perfis.${perfil} deve ser true ou false em ${CONFIG_PATH}.`);
|
|
250
258
|
}
|
|
251
259
|
if (isObject(raw.delphi) && 'ignorar' in raw.delphi) {
|
|
252
260
|
const ignorar = raw.delphi.ignorar;
|
|
@@ -268,7 +276,7 @@ export function readConfig(root) {
|
|
|
268
276
|
}
|
|
269
277
|
/** Os padrões que vão para o arquivo: sem as seções banco_dados, comentarios, perfis e delphi, que só entram quando mudam. */
|
|
270
278
|
function configGravada() {
|
|
271
|
-
const { banco_dados: _banco, comentarios: _comentarios, perfis: _perfis, delphi: _delphi, ...gravada } = defaultConfig();
|
|
279
|
+
const { banco_dados: _banco, comentarios: _comentarios, perfis: _perfis, perfisExplicitos: _perfisExplicitos, delphi: _delphi, ...gravada } = defaultConfig();
|
|
272
280
|
return gravada;
|
|
273
281
|
}
|
|
274
282
|
/** Cria a config com os padrões, sem as seções que só entram quando mudam; retorna false se já existia (nunca sobrescreve). */
|
|
@@ -390,23 +398,26 @@ export function gravarInstalarComentarios(root, valor) {
|
|
|
390
398
|
writeFileSync(file, `${JSON.stringify(proxima, null, 2)}\n`);
|
|
391
399
|
}
|
|
392
400
|
/**
|
|
393
|
-
* Grava a recusa do perfil
|
|
394
|
-
*
|
|
395
|
-
*
|
|
401
|
+
* Grava a recusa do perfil (`perfis.<id>: false`), preservando o resto do JSON; sem config, cria uma com os padrões e
|
|
402
|
+
* essa chave. `true` desfaz a recusa apagando a chave, e não cria o arquivo. JSON inválido é recusado sem tocar no
|
|
403
|
+
* arquivo.
|
|
396
404
|
*/
|
|
397
|
-
export function
|
|
405
|
+
export function gravarPerfil(root, perfil, valor) {
|
|
398
406
|
const file = join(root, CONFIG_PATH);
|
|
399
407
|
if (!existsSync(file) && valor)
|
|
400
408
|
return;
|
|
401
|
-
const raw = existsSync(file) ? lerJsonParaEscrita(file,
|
|
402
|
-
const {
|
|
409
|
+
const raw = existsSync(file) ? lerJsonParaEscrita(file, `perfis.${perfil}`) : configGravada();
|
|
410
|
+
const { [perfil]: atual, ...resto } = isObject(raw.perfis) ? raw.perfis : {};
|
|
403
411
|
if (valor ? atual === undefined || atual === true : atual === false)
|
|
404
412
|
return;
|
|
405
413
|
const { perfis: _perfis, ...semSecao } = raw;
|
|
406
|
-
const proxima = valor ? (Object.keys(resto).length ? { ...raw, perfis: resto } : semSecao) : { ...raw, perfis: { ...resto,
|
|
414
|
+
const proxima = valor ? (Object.keys(resto).length ? { ...raw, perfis: resto } : semSecao) : { ...raw, perfis: { ...resto, [perfil]: false } };
|
|
407
415
|
mkdirSync(dirname(file), { recursive: true });
|
|
408
416
|
writeFileSync(file, `${JSON.stringify(proxima, null, 2)}\n`);
|
|
409
417
|
}
|
|
418
|
+
export function gravarPerfilDelphi(root, valor) {
|
|
419
|
+
gravarPerfil(root, 'delphi', valor);
|
|
420
|
+
}
|
|
410
421
|
const BLOCK_START = '# ai-harness (gerenciado pelo harness; não edite entre estas linhas)';
|
|
411
422
|
const BLOCK_END = '# /ai-harness';
|
|
412
423
|
/**
|
|
@@ -0,0 +1,308 @@
|
|
|
1
|
+
import { existsSync, readdirSync, readFileSync } from 'node:fs';
|
|
2
|
+
import path, { join } from 'node:path';
|
|
3
|
+
import { hashContent } from '../install/lock.js';
|
|
4
|
+
import { semComentariosPascal } from '../mapa/extratores/pascal.js';
|
|
5
|
+
import { arquivosDproj } from './classificar.js';
|
|
6
|
+
import { mascararStrings } from './uses.js';
|
|
7
|
+
export const CAMINHO_CATALOGO = '.claude/skills/conhecimento-delphi/references/bibliotecas-fontdata.md';
|
|
8
|
+
const VISIBILIDADE = /^(strict\s+private|strict\s+protected|private|protected|public|published|automated)\b\s*/i;
|
|
9
|
+
const SECAO_DO_TIPO = /^(class\s+var|type|const|var|threadvar|resourcestring)\b\s*/i;
|
|
10
|
+
const SECAO_DO_TOPO = /^(type|const|var|threadvar|resourcestring)\b\s*/i;
|
|
11
|
+
const ATRIBUTO = /^\[[^\]]*\]\s*/;
|
|
12
|
+
const MEMBRO = /^(class\s+)?(function|procedure|constructor|destructor|property|operator)\b/i;
|
|
13
|
+
const ROTINA = /^(function|procedure)\b/i;
|
|
14
|
+
const DIRETIVA = /^(overload|override|virtual|dynamic|abstract|reintroduce|static|inline|stdcall|cdecl|register|safecall|pascal|final|default|nodefault|deprecated|platform|experimental|message|dispid|varargs|external|assembler)\b(?!\s*[:=])/i;
|
|
15
|
+
const CABECALHO = /^([A-Za-z_]\w*(?:\s*<[^>]*>)?)\s*=\s*(.*)$/;
|
|
16
|
+
const HELPER = /^((?:class|record)\s+helper\s*(?:\([^)]*\))?\s+for\s+[\w.]+(?:\s*<[^>]*>)?)\s*(.*)$/i;
|
|
17
|
+
const ESTRUTURA = /^((?:packed\s+)?(class|record|object|interface|dispinterface)\b(?:\s+(?:sealed|abstract))?\s*(?:\([^)]*\))?\s*(?:\[[^\]]*\])?)\s*(.*)$/i;
|
|
18
|
+
const RECORD_ANONIMO = /^[\w\s,]+:\s*(packed\s+)?record\b\s*(.*)$/i;
|
|
19
|
+
const RAIZ_WINDOWS = /^(?:[A-Za-z]:[\\/]|[\\/]{2}[^\\/]+[\\/][^\\/]+)/;
|
|
20
|
+
function* ancestrais(pasta, caminho) {
|
|
21
|
+
for (let atual = pasta;;) {
|
|
22
|
+
yield atual;
|
|
23
|
+
const pai = caminho.dirname(atual);
|
|
24
|
+
if (pai === atual)
|
|
25
|
+
return;
|
|
26
|
+
atual = pai;
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Pasta de uma entrada do search path, ou `null` para a entrada absoluta do Windows ou UNC sem correspondente:
|
|
31
|
+
* o literal vale quando o `caminho` a considera absoluta e ela existe; senão, o sufixo de pelo menos 2 segmentos,
|
|
32
|
+
* do mais longo ao mais curto, é procurado sob cada ancestral de `pastaDoDproj`.
|
|
33
|
+
*/
|
|
34
|
+
export function resolverEntrada(entrada, pastaDoDproj, opcoes = {}) {
|
|
35
|
+
const { caminho = path, existe = existsSync } = opcoes;
|
|
36
|
+
const raizWindows = RAIZ_WINDOWS.exec(entrada);
|
|
37
|
+
if (!raizWindows)
|
|
38
|
+
return caminho.resolve(pastaDoDproj, entrada.replace(/\\/g, '/'));
|
|
39
|
+
if (caminho.isAbsolute(entrada)) {
|
|
40
|
+
const literal = caminho.normalize(entrada);
|
|
41
|
+
if (existe(literal))
|
|
42
|
+
return literal;
|
|
43
|
+
}
|
|
44
|
+
const segmentos = entrada
|
|
45
|
+
.slice(raizWindows[0].length)
|
|
46
|
+
.split(/[\\/]+/)
|
|
47
|
+
.filter((segmento) => segmento && segmento !== '.');
|
|
48
|
+
for (let tamanho = segmentos.length; tamanho >= 2; tamanho--) {
|
|
49
|
+
const sufixo = segmentos.slice(segmentos.length - tamanho);
|
|
50
|
+
for (const ancestral of ancestrais(pastaDoDproj, caminho)) {
|
|
51
|
+
const candidato = caminho.join(ancestral, ...sufixo);
|
|
52
|
+
if (existe(candidato))
|
|
53
|
+
return candidato;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
return null;
|
|
57
|
+
}
|
|
58
|
+
/** Pastas do `DCC_UnitSearchPath` de todos os `.dproj`; a entrada relativa com `$(...)` é ignorada. */
|
|
59
|
+
export function resolverSearchPath(raiz, opcoes = {}) {
|
|
60
|
+
const caminho = opcoes.caminho ?? path;
|
|
61
|
+
const resultado = { pastas: [], naoResolvidas: [] };
|
|
62
|
+
for (const rel of arquivosDproj(raiz)) {
|
|
63
|
+
const dproj = join(raiz, rel);
|
|
64
|
+
let xml;
|
|
65
|
+
try {
|
|
66
|
+
xml = readFileSync(dproj, 'utf8');
|
|
67
|
+
}
|
|
68
|
+
catch {
|
|
69
|
+
continue;
|
|
70
|
+
}
|
|
71
|
+
for (const grupo of xml.matchAll(/<DCC_UnitSearchPath>([\s\S]*?)<\/DCC_UnitSearchPath>/gi)) {
|
|
72
|
+
for (const bruta of (grupo[1] ?? '').split(';')) {
|
|
73
|
+
const entrada = bruta.trim();
|
|
74
|
+
if (!entrada)
|
|
75
|
+
continue;
|
|
76
|
+
const comMacro = entrada.includes('$(');
|
|
77
|
+
if (comMacro && !RAIZ_WINDOWS.test(entrada))
|
|
78
|
+
continue;
|
|
79
|
+
const pasta = comMacro ? null : resolverEntrada(entrada, caminho.dirname(dproj), opcoes);
|
|
80
|
+
const lista = pasta === null ? resultado.naoResolvidas : resultado.pastas;
|
|
81
|
+
const valor = pasta ?? entrada;
|
|
82
|
+
if (!lista.includes(valor))
|
|
83
|
+
lista.push(valor);
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
return resultado;
|
|
88
|
+
}
|
|
89
|
+
export function pastasDoSearchPath(raiz) {
|
|
90
|
+
return resolverSearchPath(raiz).pastas;
|
|
91
|
+
}
|
|
92
|
+
export function acharUnitsFontdata(pastas) {
|
|
93
|
+
const units = new Map();
|
|
94
|
+
for (const pasta of pastas) {
|
|
95
|
+
let arquivos;
|
|
96
|
+
try {
|
|
97
|
+
arquivos = readdirSync(pasta).sort();
|
|
98
|
+
}
|
|
99
|
+
catch {
|
|
100
|
+
continue;
|
|
101
|
+
}
|
|
102
|
+
for (const arquivo of arquivos) {
|
|
103
|
+
const nome = arquivo.slice(0, -'.pas'.length);
|
|
104
|
+
if (!/^Fontdata\..+\.pas$/i.test(arquivo) || units.has(nome.toLowerCase()))
|
|
105
|
+
continue;
|
|
106
|
+
try {
|
|
107
|
+
units.set(nome.toLowerCase(), { nome, conteudo: readFileSync(join(pasta, arquivo)) });
|
|
108
|
+
}
|
|
109
|
+
catch {
|
|
110
|
+
continue;
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
return [...units.values()].sort((a, b) => (a.nome < b.nome ? -1 : a.nome > b.nome ? 1 : 0));
|
|
115
|
+
}
|
|
116
|
+
function semStrings(texto) {
|
|
117
|
+
return texto.replace(/'[^'\n]*'/g, (m) => m.replace(/[^\n]/g, ' '));
|
|
118
|
+
}
|
|
119
|
+
function semComentariosPreservandoStrings(fonte) {
|
|
120
|
+
const mascarado = mascararStrings(fonte);
|
|
121
|
+
const limpo = semComentariosPascal(mascarado);
|
|
122
|
+
let saida = '';
|
|
123
|
+
for (let i = 0; i < limpo.length; i++)
|
|
124
|
+
saida += limpo[i] === '_' && mascarado[i] === '_' ? fonte[i] : limpo[i];
|
|
125
|
+
return saida;
|
|
126
|
+
}
|
|
127
|
+
function declaracoesDaInterface(fonte) {
|
|
128
|
+
const limpo = semComentariosPreservandoStrings(fonte);
|
|
129
|
+
const inicio = /^\s*interface\b/im.exec(limpo);
|
|
130
|
+
if (!inicio)
|
|
131
|
+
return [];
|
|
132
|
+
const resto = limpo.slice(inicio.index + inicio[0].length);
|
|
133
|
+
const fim = /^\s*implementation\b/im.exec(resto);
|
|
134
|
+
const secao = fim ? resto.slice(0, fim.index) : resto;
|
|
135
|
+
const mascara = semStrings(secao);
|
|
136
|
+
const declaracoes = [];
|
|
137
|
+
let profundidade = 0;
|
|
138
|
+
let comeco = 0;
|
|
139
|
+
for (let i = 0; i < mascara.length; i++) {
|
|
140
|
+
const c = mascara[i];
|
|
141
|
+
if (c === '(' || c === '[')
|
|
142
|
+
profundidade++;
|
|
143
|
+
else if ((c === ')' || c === ']') && profundidade > 0)
|
|
144
|
+
profundidade--;
|
|
145
|
+
else if (c === ';' && profundidade === 0) {
|
|
146
|
+
declaracoes.push(secao.slice(comeco, i).replace(/\s+/g, ' ').trim());
|
|
147
|
+
comeco = i + 1;
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
return declaracoes;
|
|
151
|
+
}
|
|
152
|
+
function abrirTipo(definicao) {
|
|
153
|
+
if (/^class\s+of\b/i.test(definicao))
|
|
154
|
+
return null;
|
|
155
|
+
const abertura = HELPER.exec(definicao) ?? ESTRUTURA.exec(definicao);
|
|
156
|
+
if (!abertura)
|
|
157
|
+
return null;
|
|
158
|
+
const cabeca = (abertura[1] ?? '').replace(/\s*\[[^\]]*\]$/, '').trim();
|
|
159
|
+
return { cabeca, corpo: abertura[abertura.length - 1] ?? '' };
|
|
160
|
+
}
|
|
161
|
+
export function extrairApi(fonte) {
|
|
162
|
+
const api = { tipos: [], rotinas: [] };
|
|
163
|
+
const abertos = [];
|
|
164
|
+
let secaoDeTipos = false;
|
|
165
|
+
let ultimo = null;
|
|
166
|
+
for (const declaracao of declaracoesDaInterface(fonte)) {
|
|
167
|
+
let resto = declaracao;
|
|
168
|
+
while (resto) {
|
|
169
|
+
resto = resto.replace(ATRIBUTO, '');
|
|
170
|
+
const topo = abertos[abertos.length - 1];
|
|
171
|
+
if (DIRETIVA.test(resto)) {
|
|
172
|
+
if (ultimo && ultimo.length > 0)
|
|
173
|
+
ultimo[ultimo.length - 1] += ` ${resto};`;
|
|
174
|
+
break;
|
|
175
|
+
}
|
|
176
|
+
if (topo) {
|
|
177
|
+
const visibilidade = VISIBILIDADE.exec(resto);
|
|
178
|
+
if (visibilidade) {
|
|
179
|
+
topo.visivel = /^(public|published|automated)$/i.test(visibilidade[1] ?? '');
|
|
180
|
+
resto = resto.slice(visibilidade[0].length);
|
|
181
|
+
continue;
|
|
182
|
+
}
|
|
183
|
+
const fim = /^end\b\s*/i.exec(resto);
|
|
184
|
+
if (fim) {
|
|
185
|
+
abertos.pop();
|
|
186
|
+
resto = resto.slice(fim[0].length);
|
|
187
|
+
continue;
|
|
188
|
+
}
|
|
189
|
+
const secao = SECAO_DO_TIPO.exec(resto);
|
|
190
|
+
if (secao) {
|
|
191
|
+
resto = resto.slice(secao[0].length);
|
|
192
|
+
continue;
|
|
193
|
+
}
|
|
194
|
+
if (MEMBRO.test(resto)) {
|
|
195
|
+
const publico = abertos.length === 1 && topo.visivel && topo.tipo;
|
|
196
|
+
if (publico)
|
|
197
|
+
topo.tipo.membros.push(`${resto};`);
|
|
198
|
+
ultimo = publico ? topo.tipo.membros : null;
|
|
199
|
+
break;
|
|
200
|
+
}
|
|
201
|
+
const anonimo = RECORD_ANONIMO.exec(resto);
|
|
202
|
+
const aninhado = anonimo ? null : CABECALHO.exec(resto);
|
|
203
|
+
const corpo = anonimo ? (anonimo[2] ?? '') : (abrirTipo(aninhado?.[2] ?? '')?.corpo ?? '');
|
|
204
|
+
ultimo = null;
|
|
205
|
+
if (!corpo)
|
|
206
|
+
break;
|
|
207
|
+
abertos.push({ visivel: false });
|
|
208
|
+
resto = corpo;
|
|
209
|
+
continue;
|
|
210
|
+
}
|
|
211
|
+
const secao = SECAO_DO_TOPO.exec(resto);
|
|
212
|
+
if (secao) {
|
|
213
|
+
secaoDeTipos = /^type$/i.test(secao[1] ?? '');
|
|
214
|
+
resto = resto.slice(secao[0].length);
|
|
215
|
+
continue;
|
|
216
|
+
}
|
|
217
|
+
if (/^uses\b/i.test(resto))
|
|
218
|
+
break;
|
|
219
|
+
if (ROTINA.test(resto)) {
|
|
220
|
+
api.rotinas.push(`${resto};`);
|
|
221
|
+
ultimo = api.rotinas;
|
|
222
|
+
secaoDeTipos = false;
|
|
223
|
+
break;
|
|
224
|
+
}
|
|
225
|
+
const cabecalho = secaoDeTipos ? CABECALHO.exec(resto) : null;
|
|
226
|
+
if (!cabecalho) {
|
|
227
|
+
ultimo = null;
|
|
228
|
+
break;
|
|
229
|
+
}
|
|
230
|
+
const nome = (cabecalho[1] ?? '').replace(/\s+/g, '');
|
|
231
|
+
const definicao = cabecalho[2] ?? '';
|
|
232
|
+
const abertura = abrirTipo(definicao);
|
|
233
|
+
ultimo = null;
|
|
234
|
+
if (!abertura) {
|
|
235
|
+
api.tipos.push({ nome, declaracao: definicao, membros: [] });
|
|
236
|
+
break;
|
|
237
|
+
}
|
|
238
|
+
const { cabeca, corpo } = abertura;
|
|
239
|
+
if (!corpo && /^(class|interface|dispinterface)$/i.test(cabeca))
|
|
240
|
+
break;
|
|
241
|
+
const tipo = { nome, declaracao: cabeca, membros: [] };
|
|
242
|
+
api.tipos.push(tipo);
|
|
243
|
+
if (!corpo)
|
|
244
|
+
break;
|
|
245
|
+
abertos.push({ tipo, visivel: true });
|
|
246
|
+
resto = corpo;
|
|
247
|
+
}
|
|
248
|
+
}
|
|
249
|
+
return api;
|
|
250
|
+
}
|
|
251
|
+
function renderizarUnit(unit) {
|
|
252
|
+
const { tipos, rotinas } = extrairApi(unit.conteudo.toString('utf8').replace(/^/, ''));
|
|
253
|
+
const linhas = [`## ${unit.nome}`, ''];
|
|
254
|
+
if (tipos.length === 0 && rotinas.length === 0)
|
|
255
|
+
linhas.push('Nada público na `interface`.', '');
|
|
256
|
+
for (const tipo of tipos) {
|
|
257
|
+
linhas.push(`### \`${tipo.nome} = ${tipo.declaracao}\``, '');
|
|
258
|
+
if (tipo.membros.length > 0)
|
|
259
|
+
linhas.push(...tipo.membros.map((m) => `- \`${m}\``), '');
|
|
260
|
+
}
|
|
261
|
+
if (rotinas.length > 0)
|
|
262
|
+
linhas.push('### Rotinas', '', ...rotinas.map((r) => `- \`${r}\``), '');
|
|
263
|
+
return linhas;
|
|
264
|
+
}
|
|
265
|
+
export function gerarCatalogo(units) {
|
|
266
|
+
const linhas = [
|
|
267
|
+
'# Catálogo das units Fontdata',
|
|
268
|
+
'',
|
|
269
|
+
'Gerado por `npx @fontdata/ai-harness delphi catalogo` a partir das units `Fontdata.*.pas` do search path do',
|
|
270
|
+
'projeto. Antes de criar um helper ou utilitário, procure aqui o que já existe. Não edite à mão: quando as units',
|
|
271
|
+
'mudarem, rode o comando de novo.',
|
|
272
|
+
'',
|
|
273
|
+
'## Fontes',
|
|
274
|
+
'',
|
|
275
|
+
'| Unit | sha256 |',
|
|
276
|
+
'|---|---|',
|
|
277
|
+
...units.map((unit) => `| ${unit.nome} | ${hashContent(unit.conteudo)} |`),
|
|
278
|
+
'',
|
|
279
|
+
...units.flatMap(renderizarUnit),
|
|
280
|
+
];
|
|
281
|
+
return `${linhas.join('\n').trimEnd()}\n`;
|
|
282
|
+
}
|
|
283
|
+
export function lerFontesDoCatalogo(texto) {
|
|
284
|
+
const fontes = new Map();
|
|
285
|
+
for (const linha of texto.split(/\r?\n/)) {
|
|
286
|
+
const fonte = /^\| (Fontdata\.[^|\s]+) \| ([0-9a-f]{64}) \|$/.exec(linha);
|
|
287
|
+
if (fonte)
|
|
288
|
+
fontes.set(fonte[1], fonte[2]);
|
|
289
|
+
}
|
|
290
|
+
return fontes;
|
|
291
|
+
}
|
|
292
|
+
export function estadoDoCatalogo(arquivo, units) {
|
|
293
|
+
if (units.length === 0)
|
|
294
|
+
return 'sem-units';
|
|
295
|
+
if (!existsSync(arquivo))
|
|
296
|
+
return 'ausente';
|
|
297
|
+
const fontes = lerFontesDoCatalogo(readFileSync(arquivo, 'utf8'));
|
|
298
|
+
const emDia = fontes.size === units.length && units.every((unit) => fontes.get(unit.nome) === hashContent(unit.conteudo));
|
|
299
|
+
return emDia ? 'em-dia' : 'desatualizado';
|
|
300
|
+
}
|
|
301
|
+
/**
|
|
302
|
+
* Estado do catálogo gravado na raiz contra as units `Fontdata.*.pas` do search path dos `.dproj`, ou das
|
|
303
|
+
* `pastas` informadas. `sem-units` quando nenhuma unit é encontrada, caso em que não há o que avisar.
|
|
304
|
+
*/
|
|
305
|
+
export function checarCatalogo(raiz, pastas) {
|
|
306
|
+
const units = acharUnitsFontdata(pastas ?? pastasDoSearchPath(raiz));
|
|
307
|
+
return estadoDoCatalogo(join(raiz, CAMINHO_CATALOGO), units);
|
|
308
|
+
}
|
|
@@ -3,6 +3,8 @@ import { dirname, join, relative, sep } from 'node:path';
|
|
|
3
3
|
import { git, isVersioned } from '../trabalhos/arquivar.js';
|
|
4
4
|
import { varrerArquivos } from '../versao/detectar.js';
|
|
5
5
|
import { lerRes } from './res.js';
|
|
6
|
+
import { algumUsesCasa, emRepositorioGit } from './uses.js';
|
|
7
|
+
export { emRepositorioGit };
|
|
6
8
|
const RT_ICON = 3;
|
|
7
9
|
const RT_RCDATA = 10;
|
|
8
10
|
const RT_GROUP_ICON = 14;
|
|
@@ -13,8 +15,31 @@ export function detectarDelphi(raiz) {
|
|
|
13
15
|
return true;
|
|
14
16
|
return Boolean(git(raiz, ['ls-files', '--', ':(icase)*.dproj', ':(icase)*.dpr'])?.trim());
|
|
15
17
|
}
|
|
16
|
-
|
|
17
|
-
|
|
18
|
+
/** Os `.dproj` do projeto pelo critério de `detectarDelphi`: até 3 níveis de pasta, mais os versionados no git. */
|
|
19
|
+
export function arquivosDproj(raiz) {
|
|
20
|
+
const achados = new Set(varrerArquivos(raiz, '', 3, /\.dproj$/i));
|
|
21
|
+
for (const nome of git(raiz, ['ls-files', '--', ':(icase)*.dproj'])?.split('\n') ?? []) {
|
|
22
|
+
if (nome)
|
|
23
|
+
achados.add(nome);
|
|
24
|
+
}
|
|
25
|
+
return [...achados].sort();
|
|
26
|
+
}
|
|
27
|
+
function citaAcbr(arquivo) {
|
|
28
|
+
try {
|
|
29
|
+
return /acbr/i.test(readFileSync(arquivo, 'utf8'));
|
|
30
|
+
}
|
|
31
|
+
catch {
|
|
32
|
+
return false;
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* Algum `.dproj` ou o `boss.json` da raiz cita ACBr, sem diferenciar maiúsculas; sem achado, alguma `.pas`/`.dpr`
|
|
37
|
+
* fora de `ignorar` tem uma unit `ACBr[A-Z]...` na cláusula `uses`.
|
|
38
|
+
*/
|
|
39
|
+
export function detectarAcbr(raiz, ignorar) {
|
|
40
|
+
if (citaAcbr(join(raiz, 'boss.json')) || arquivosDproj(raiz).some((rel) => citaAcbr(join(raiz, rel))))
|
|
41
|
+
return true;
|
|
42
|
+
return algumUsesCasa(raiz, (unit) => /^ACBr[A-Z]/.test(unit), ignorar);
|
|
18
43
|
}
|
|
19
44
|
function mesmoNome(nome, esperado) {
|
|
20
45
|
return typeof nome === 'string' && nome.toUpperCase() === esperado;
|