@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
package/dist/init.js
CHANGED
|
@@ -15,8 +15,16 @@ const PLUGIN_MCP_NOTE = 'O plugin fontdata@ai-harness está habilitado: o servid
|
|
|
15
15
|
const PERFIL_DELPHI_NOTE = 'Perfil Delphi instalado (projeto Delphi detectado): rules em .claude/rules/delphi/, a skill conhecimento-delphi e o ' +
|
|
16
16
|
'hook de encoding em .claude/hooks/delphi/, registrado em .claude/settings.json; para recusar, use perfis.delphi: false ' +
|
|
17
17
|
'no .ai-harness/config.json.';
|
|
18
|
+
const PERFIL_FISCAL_NOTE = 'Perfil delphi-fiscal instalado (projeto usa ACBr): rules em .claude/rules/delphi-fiscal/ e as skills patch-acbr e ' +
|
|
19
|
+
"diagnosticar-rejeicao-nfse; para recusar, use perfis[\"delphi-fiscal\"]: false no .ai-harness/config.json.";
|
|
18
20
|
function resumo(plan, skippedForPlugin = false) {
|
|
19
|
-
|
|
21
|
+
const fiscal = plan.items.some((item) => item.tipo === 'perfil' && item.id === 'delphi-fiscal');
|
|
22
|
+
return [
|
|
23
|
+
describePlan(plan),
|
|
24
|
+
...(skippedForPlugin ? [PLUGIN_HOOKS_NOTE] : []),
|
|
25
|
+
...(plan.registerPerfilDelphi ? [PERFIL_DELPHI_NOTE] : []),
|
|
26
|
+
...(fiscal ? [PERFIL_FISCAL_NOTE] : []),
|
|
27
|
+
].join(EOL + EOL);
|
|
20
28
|
}
|
|
21
29
|
/** Registra o MCP de banco no .mcp.json quando não foi recusado (flag, wizard ou config) e o plugin não o fornece. */
|
|
22
30
|
export function decidirRegistroMcp(options, root, home = homedir()) {
|
package/dist/install/perfis.js
CHANGED
|
@@ -1,9 +1,16 @@
|
|
|
1
|
-
import {
|
|
2
|
-
|
|
1
|
+
import { PERFIS_DO_CONFIG } from '../config/config.js';
|
|
2
|
+
import { detectarAcbr, detectarDelphi } from '../delphi/classificar.js';
|
|
3
|
+
export const PERFIS = PERFIS_DO_CONFIG;
|
|
3
4
|
export const PERFIL_DELPHI_HOOK_COMMAND = 'node "${CLAUDE_PROJECT_DIR}/.claude/hooks/delphi/encoding.mjs"';
|
|
4
|
-
/** Perfis que o projeto recebe: a stack foi detectada e o config não guarda a recusa. */
|
|
5
|
+
/** Perfis que o projeto recebe: a stack foi detectada e o config não guarda a recusa. O fiscal depende do Delphi. */
|
|
5
6
|
export function perfisDoProjeto(root, config) {
|
|
6
|
-
|
|
7
|
+
if (!config.perfis.delphi || !detectarDelphi(root))
|
|
8
|
+
return [];
|
|
9
|
+
return config.perfis['delphi-fiscal'] && detectarAcbr(root) ? ['delphi', 'delphi-fiscal'] : ['delphi'];
|
|
10
|
+
}
|
|
11
|
+
/** A recusa do perfil no config; a do Delphi recusa também o fiscal. */
|
|
12
|
+
export function perfilRecusadoNoConfig(perfil, config) {
|
|
13
|
+
return !config.perfis.delphi || !config.perfis[perfil];
|
|
7
14
|
}
|
|
8
15
|
export function perfilDelphiHooksConfig() {
|
|
9
16
|
const hooks = () => [{ type: 'command', command: PERFIL_DELPHI_HOOK_COMMAND }];
|
package/dist/update/update.js
CHANGED
|
@@ -9,7 +9,7 @@ import { HOOKS_ITEM_ID, isHarnessPluginEnabled, projectHooksConfig } from '../in
|
|
|
9
9
|
import { BANCO_MCP_NOME, BANCO_MCP_NOME_LEGADO, bancoMcpServer, ehEntradaGerenciada, MCP_PATH, mergeMcpServers } from '../install/mcp.js';
|
|
10
10
|
import { hashContent, LOCK_PATH, LOCK_VERSION, readLock, writeLock } from '../install/lock.js';
|
|
11
11
|
import { agentsForaDoLock, itemSources, packageInfo, PROJECT_RULE_PATH, projectRuleContent } from '../install/plan.js';
|
|
12
|
-
import { PERFIL_DELPHI_HOOK_COMMAND, perfilDelphiHooksConfig, perfisDoProjeto } from '../install/perfis.js';
|
|
12
|
+
import { PERFIL_DELPHI_HOOK_COMMAND, perfilDelphiHooksConfig, perfilRecusadoNoConfig, PERFIS, perfisDoProjeto } from '../install/perfis.js';
|
|
13
13
|
import { neededSkillsFor } from '../install/selection.js';
|
|
14
14
|
import { BANCO_PERMISSIONS_LEGADAS, combineHooks, HARNESS_DENY, harnessPermissions, hasAllowRule, hookCommands, mergeSettings, normalizarComandoHook, SETTINGS_PATH, } from '../install/settings.js';
|
|
15
15
|
import { adoptLegacyInstall } from './legado.js';
|
|
@@ -19,6 +19,14 @@ function pastasDoItem(root, item) {
|
|
|
19
19
|
const pastas = new Set(item.arquivos.map((entry) => `${entry.caminho.split('/').slice(0, 3).join('/')}/`));
|
|
20
20
|
return [...pastas].filter((pasta) => existsSync(join(root, pasta))).sort();
|
|
21
21
|
}
|
|
22
|
+
function itensRecusados(recusas) {
|
|
23
|
+
return new Set(recusas.map((recusa) => `perfil:${recusa.perfil}`));
|
|
24
|
+
}
|
|
25
|
+
function arquivosMantidos(pastas) {
|
|
26
|
+
return pastas.length
|
|
27
|
+
? `Os arquivos do perfil são mantidos e podem ser apagados à mão: ${pastas.join(', ')}.`
|
|
28
|
+
: 'Os arquivos do perfil já foram apagados.';
|
|
29
|
+
}
|
|
22
30
|
/** O settings do projeto já registra o hook do perfil em todos os eventos dele. */
|
|
23
31
|
function perfilDelphiRegistrado(root) {
|
|
24
32
|
let hooks;
|
|
@@ -33,6 +41,23 @@ function perfilDelphiRegistrado(root) {
|
|
|
33
41
|
const comando = normalizarComandoHook(PERFIL_DELPHI_HOOK_COMMAND);
|
|
34
42
|
return Object.keys(perfilDelphiHooksConfig()).every((evento) => hookCommands({ [evento]: hooks[evento] ?? [] }).map(normalizarComandoHook).includes(comando));
|
|
35
43
|
}
|
|
44
|
+
/** O settings do projeto já registra cada comando dos hooks do núcleo no evento dele, nas duas grafias. */
|
|
45
|
+
function hooksNucleoRegistrados(root) {
|
|
46
|
+
let hooks;
|
|
47
|
+
try {
|
|
48
|
+
hooks = JSON.parse(readFileSync(join(root, SETTINGS_PATH), 'utf8')).hooks ?? {};
|
|
49
|
+
}
|
|
50
|
+
catch {
|
|
51
|
+
return false;
|
|
52
|
+
}
|
|
53
|
+
if (!isPlainObject(hooks))
|
|
54
|
+
return false;
|
|
55
|
+
const registrados = hooks;
|
|
56
|
+
return Object.entries(projectHooksConfig()).every(([evento, grupos]) => {
|
|
57
|
+
const existentes = new Set(hookCommands({ [evento]: registrados[evento] ?? [] }).map(normalizarComandoHook));
|
|
58
|
+
return hookCommands({ [evento]: grupos }).every((comando) => existentes.has(normalizarComandoHook(comando)));
|
|
59
|
+
});
|
|
60
|
+
}
|
|
36
61
|
function isPlainObject(value) {
|
|
37
62
|
return typeof value === 'object' && value !== null && !Array.isArray(value);
|
|
38
63
|
}
|
|
@@ -80,11 +105,15 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
|
|
|
80
105
|
const changes = [];
|
|
81
106
|
const stale = [];
|
|
82
107
|
const { config } = readConfig(root);
|
|
83
|
-
const
|
|
84
|
-
const
|
|
108
|
+
const itemDoPerfil = (perfil) => lock.itens.find((item) => item.tipo === 'perfil' && item.id === perfil);
|
|
109
|
+
const perfisRecusados = PERFIS.flatMap((perfil) => {
|
|
110
|
+
const item = itemDoPerfil(perfil);
|
|
111
|
+
return item && perfilRecusadoNoConfig(perfil, config) ? [{ perfil, pastas: pastasDoItem(root, item) }] : [];
|
|
112
|
+
});
|
|
113
|
+
const recusados = itensRecusados(perfisRecusados);
|
|
85
114
|
for (const item of lock.itens) {
|
|
86
115
|
const key = `${item.tipo}:${item.id}`;
|
|
87
|
-
if (
|
|
116
|
+
if (recusados.has(key))
|
|
88
117
|
continue;
|
|
89
118
|
const sources = itemSources(catalog, item.tipo, item.id) ?? [];
|
|
90
119
|
const sourceByPath = new Map(sources.map((entry) => [entry.path, entry.source]));
|
|
@@ -125,8 +154,10 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
|
|
|
125
154
|
continue;
|
|
126
155
|
const target = join(root, path);
|
|
127
156
|
const same = existsSync(target) && hashContent(readFileSync(target)) === hashContent(readFileSync(source));
|
|
128
|
-
// O perfil
|
|
129
|
-
|
|
157
|
+
// O perfil e o hook:ai-harness da adoção entraram sem este arquivo porque ele já era do projeto: continua do
|
|
158
|
+
// projeto, mesmo com --forcar.
|
|
159
|
+
const preservado = item.tipo === 'perfil' || (item.tipo === 'hook' && item.id === HOOKS_ITEM_ID);
|
|
160
|
+
if (!same && existsSync(target) && preservado)
|
|
130
161
|
continue;
|
|
131
162
|
changes.push({ tipo: !existsSync(target) || same ? 'novo' : 'conflito', caminho: path, item: key, source });
|
|
132
163
|
}
|
|
@@ -158,6 +189,15 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
|
|
|
158
189
|
addItem('skill', skill.id, false);
|
|
159
190
|
}
|
|
160
191
|
}
|
|
192
|
+
for (const item of lock.itens) {
|
|
193
|
+
if (item.tipo !== 'skill')
|
|
194
|
+
continue;
|
|
195
|
+
const fluxo = entries.find((cmd) => cmd.id === item.id && cmd.skill);
|
|
196
|
+
if (!fluxo)
|
|
197
|
+
continue;
|
|
198
|
+
for (const skill of neededSkillsFor(catalog, [fluxo]))
|
|
199
|
+
addItem('skill', skill.id, false);
|
|
200
|
+
}
|
|
161
201
|
// Na adoção, a instalação antiga ganha o que a 2.1 instala e ela não tinha.
|
|
162
202
|
const adotada = !recorded;
|
|
163
203
|
const pluginHooks = adotada && isHarnessPluginEnabled(root, home);
|
|
@@ -169,6 +209,7 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
|
|
|
169
209
|
}
|
|
170
210
|
for (const id of agentsForaDoLock(catalog, lock))
|
|
171
211
|
addItem('agent', id, true);
|
|
212
|
+
const registrarHooksNucleo = !adotada && lock.itens.some((item) => item.tipo === 'hook' && item.id === HOOKS_ITEM_ID) && !isHarnessPluginEnabled(root, home) && !hooksNucleoRegistrados(root);
|
|
172
213
|
// O padrão de comentários também chega ao lock anterior a ele, salvo com a recusa no config ou na flag. O hook é a
|
|
173
214
|
// referência: o comando `comentarios` não registra a rule quando o projeto já tem uma própria.
|
|
174
215
|
const querComentarios = !semComentarios && config.comentarios.instalar;
|
|
@@ -179,10 +220,10 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
|
|
|
179
220
|
addItem('rule', 'comentarios', true);
|
|
180
221
|
addItem('hook', 'comentarios', true);
|
|
181
222
|
}
|
|
182
|
-
const
|
|
183
|
-
|
|
184
|
-
addItem('perfil',
|
|
185
|
-
const registrarPerfilDelphi =
|
|
223
|
+
const instalarPerfis = perfisDoProjeto(root, config).filter((perfil) => !itemDoPerfil(perfil));
|
|
224
|
+
for (const perfil of instalarPerfis)
|
|
225
|
+
addItem('perfil', perfil, true);
|
|
226
|
+
const registrarPerfilDelphi = instalarPerfis.includes('delphi') || (!!itemDoPerfil('delphi') && !recusados.has(PERFIL_DELPHI_ITEM) && !perfilDelphiRegistrado(root));
|
|
186
227
|
const registrarMcpConfig = config.banco_dados.registrar_mcp;
|
|
187
228
|
const permissoesBanco = !semBanco && registrarMcpConfig;
|
|
188
229
|
const permissoesFaltando = [
|
|
@@ -197,6 +238,7 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
|
|
|
197
238
|
stale,
|
|
198
239
|
adotada,
|
|
199
240
|
registrarHooks: adotada && !pluginHooks,
|
|
241
|
+
registrarHooksNucleo,
|
|
200
242
|
registrarComentarios,
|
|
201
243
|
registrarHookComentarios,
|
|
202
244
|
recusarComentarios: semComentarios && config.comentarios.instalar,
|
|
@@ -209,8 +251,8 @@ export function checkUpdate(root, catalog = loadCatalog(), legacy, home, { semBa
|
|
|
209
251
|
recusarMcp: semBanco && registrarMcpConfig,
|
|
210
252
|
renomearSecaoBanco: temSecaoBancoLegada(root),
|
|
211
253
|
registrarPerfilDelphi,
|
|
212
|
-
|
|
213
|
-
|
|
254
|
+
instalarPerfis,
|
|
255
|
+
perfisRecusados,
|
|
214
256
|
};
|
|
215
257
|
}
|
|
216
258
|
/**
|
|
@@ -248,14 +290,14 @@ export function applyUpdate(root, report, options, pkg, now = new Date()) {
|
|
|
248
290
|
renameSync(join(root, path), join(root, para));
|
|
249
291
|
return { de: path, para };
|
|
250
292
|
});
|
|
251
|
-
const hooks = combineHooks(report.registrarHooks ? projectHooksConfig() : {}, report.registrarComentarios ? commentsHooksConfig() : {}, report.registrarPerfilDelphi ? perfilDelphiHooksConfig() : {});
|
|
293
|
+
const hooks = combineHooks(report.registrarHooks || report.registrarHooksNucleo ? projectHooksConfig() : {}, report.registrarComentarios ? commentsHooksConfig() : {}, report.registrarPerfilDelphi ? perfilDelphiHooksConfig() : {});
|
|
252
294
|
const ajustes = [];
|
|
253
295
|
const settings = mergeSettings(root, {
|
|
254
296
|
hooks,
|
|
255
297
|
allow: harnessPermissions({ banco: report.permissoesBanco }),
|
|
256
298
|
deny: HARNESS_DENY,
|
|
257
299
|
removeAllow: BANCO_PERMISSIONS_LEGADAS,
|
|
258
|
-
removeHooks: report.
|
|
300
|
+
removeHooks: itensRecusados(report.perfisRecusados).has(PERFIL_DELPHI_ITEM) ? [PERFIL_DELPHI_HOOK_COMMAND] : [],
|
|
259
301
|
}, now);
|
|
260
302
|
if (settings.changed)
|
|
261
303
|
ajustes.push(`${SETTINGS_PATH} atualizado${settings.backup ? ` (backup em ${settings.backup})` : ''}.`);
|
|
@@ -314,9 +356,10 @@ export function applyUpdate(root, report, options, pkg, now = new Date()) {
|
|
|
314
356
|
const writtenHash = new Map(write.map((file) => [file.path, hashContent(file.content)]));
|
|
315
357
|
const dropped = new Set([...remove, ...report.stale, ...legacy]);
|
|
316
358
|
const itens = [];
|
|
359
|
+
const recusados = itensRecusados(report.perfisRecusados);
|
|
317
360
|
for (const item of report.lock.itens) {
|
|
318
361
|
const key = `${item.tipo}:${item.id}`;
|
|
319
|
-
if (
|
|
362
|
+
if (recusados.has(key))
|
|
320
363
|
continue;
|
|
321
364
|
const entries = new Map(item.arquivos.map((entry) => [entry.caminho, entry]));
|
|
322
365
|
for (const [path, sha256] of writtenHash) {
|
|
@@ -376,6 +419,7 @@ export function describeUpdate(report) {
|
|
|
376
419
|
'a rule de projeto e a permissão do `ai-harness evento`.',
|
|
377
420
|
]
|
|
378
421
|
: [];
|
|
422
|
+
const nucleo = report.registrarHooksNucleo ? [`Faltam hooks do harness em ${SETTINGS_PATH}; o --yes registra os que faltam.`] : [];
|
|
379
423
|
const permission = report.permissaoAusente && !report.adotada
|
|
380
424
|
? [
|
|
381
425
|
`Faltam permissões do harness em .claude/settings.json (${report.permissoesFaltando.join(', ')}); o --yes as acrescenta.`,
|
|
@@ -408,8 +452,10 @@ export function describeUpdate(report) {
|
|
|
408
452
|
...(report.renomearSecaoBanco ? [`A seção banco de ${CONFIG_PATH} agora se chama banco_dados; o --yes a renomeia.`] : []),
|
|
409
453
|
...(report.recusarMcp ? [`--sem-banco-dados: o --yes grava banco_dados.registrar_mcp: false em ${CONFIG_PATH} e não registra o MCP.`] : []),
|
|
410
454
|
];
|
|
455
|
+
const delphiRecusado = report.perfisRecusados.find((recusa) => recusa.perfil === 'delphi');
|
|
456
|
+
const fiscalRecusado = report.perfisRecusados.find((recusa) => recusa.perfil === 'delphi-fiscal');
|
|
411
457
|
const perfil = [
|
|
412
|
-
...(report.
|
|
458
|
+
...(report.instalarPerfis.includes('delphi')
|
|
413
459
|
? [
|
|
414
460
|
'Projeto Delphi sem o perfil delphi: o --yes grava as rules em .claude/rules/delphi/, a skill conhecimento-delphi e o hook ' +
|
|
415
461
|
`.claude/hooks/delphi/encoding.mjs, registrado em ${SETTINGS_PATH}. Para recusar, grave perfis.delphi: false em ${CONFIG_PATH}.`,
|
|
@@ -417,25 +463,36 @@ export function describeUpdate(report) {
|
|
|
417
463
|
: report.registrarPerfilDelphi
|
|
418
464
|
? [`O hook do perfil delphi não está registrado em ${SETTINGS_PATH}; o --yes o registra.`]
|
|
419
465
|
: []),
|
|
420
|
-
...(report.
|
|
466
|
+
...(report.instalarPerfis.includes('delphi-fiscal')
|
|
467
|
+
? [
|
|
468
|
+
'Projeto Delphi com ACBr sem o perfil delphi-fiscal: o --yes grava as rules em .claude/rules/delphi-fiscal/ e as skills ' +
|
|
469
|
+
`patch-acbr e diagnosticar-rejeicao-nfse. Para recusar, grave perfis["delphi-fiscal"]: false em ${CONFIG_PATH}.`,
|
|
470
|
+
]
|
|
471
|
+
: []),
|
|
472
|
+
...(delphiRecusado
|
|
421
473
|
? [
|
|
422
474
|
`perfis.delphi: false em ${CONFIG_PATH}: o --yes tira o perfil delphi do ${LOCK_PATH} e o registro do hook de ${SETTINGS_PATH}. ` +
|
|
423
|
-
(
|
|
424
|
-
|
|
425
|
-
|
|
475
|
+
arquivosMantidos(delphiRecusado.pastas),
|
|
476
|
+
]
|
|
477
|
+
: []),
|
|
478
|
+
...(fiscalRecusado
|
|
479
|
+
? [
|
|
480
|
+
`Perfil delphi-fiscal recusado em ${CONFIG_PATH} (perfis["delphi-fiscal"]: false ou perfis.delphi: false): o --yes tira o ` +
|
|
481
|
+
`perfil delphi-fiscal do ${LOCK_PATH}. ${arquivosMantidos(fiscalRecusado.pastas)}`,
|
|
426
482
|
]
|
|
427
483
|
: []),
|
|
428
484
|
];
|
|
429
485
|
if (!report.changes.length) {
|
|
430
|
-
const status = adopted.length || comentarios.length || perfil.length || permission.length || legadas.length || mcp.length
|
|
486
|
+
const status = adopted.length || comentarios.length || perfil.length || nucleo.length || permission.length || legadas.length || mcp.length
|
|
431
487
|
? 'Nenhum arquivo a atualizar.'
|
|
432
488
|
: 'A instalação está em dia: nenhum arquivo a atualizar.';
|
|
433
|
-
return [...adopted, ...comentarios, ...perfil, ...permission, ...legadas, ...mcp, status].join('\n');
|
|
489
|
+
return [...adopted, ...comentarios, ...perfil, ...nucleo, ...permission, ...legadas, ...mcp, status].join('\n');
|
|
434
490
|
}
|
|
435
491
|
return [
|
|
436
492
|
...adopted,
|
|
437
493
|
...comentarios,
|
|
438
494
|
...perfil,
|
|
495
|
+
...nucleo,
|
|
439
496
|
...permission,
|
|
440
497
|
...legadas,
|
|
441
498
|
...mcp,
|
|
@@ -478,7 +535,7 @@ export function runUpdateCommand(argv) {
|
|
|
478
535
|
const report = checkUpdate(root, undefined, undefined, undefined, { semBanco: args.semBanco, semComentarios: args.semComentarios });
|
|
479
536
|
console.log(describeUpdate(report));
|
|
480
537
|
// Sem arquivo a atualizar, a adoção ainda grava o lock, e a permissão e o MCP ainda são acrescentados.
|
|
481
|
-
const pendente = report.adotada || report.permissaoAusente || report.permissoesLegadas.length > 0 || report.mudancaMcp !== null || report.recusarMcp || report.recusarComentarios || report.registrarHookComentarios || report.renomearSecaoBanco || report.registrarPerfilDelphi || report.
|
|
538
|
+
const pendente = report.adotada || report.permissaoAusente || report.permissoesLegadas.length > 0 || report.mudancaMcp !== null || report.recusarMcp || report.recusarComentarios || report.registrarHookComentarios || report.renomearSecaoBanco || report.registrarPerfilDelphi || report.registrarHooksNucleo || report.perfisRecusados.length > 0;
|
|
482
539
|
if (args.check || (!report.changes.length && !pendente))
|
|
483
540
|
return 0;
|
|
484
541
|
if (!args.yes) {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fontdata/ai-harness",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "4.5.0",
|
|
4
4
|
"description": "Harness de engenharia com IA da Fontdata para Claude Code: roda os slash commands direto na pasta do projeto via npx, sem instalar nada — ou instala-os em .claude/commands.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
package/templates/CLAUDE.md
CHANGED
|
@@ -39,7 +39,8 @@ Tipos de trabalho: `feature` (`/nova-tarefa`), `bug` (`/resolver-bug`), `auditor
|
|
|
39
39
|
- **Hooks** (modo de cada um em `.ai-harness/config.json`): `lembrete` sugere o fluxo certo para o pedido;
|
|
40
40
|
`segredo-no-commit` bloqueia commit com segredo; `proteger-contratos` avisa quando SPEC, PLAN ou CLAUDE.md são
|
|
41
41
|
reescritos durante a execução; `task-so-fecha-verde` avisa sobre task concluída sem suíte verde; `sem-jargao`
|
|
42
|
-
avisa sobre termo técnico no relatório para o cliente
|
|
42
|
+
avisa sobre termo técnico no relatório para o cliente; `padroes-proibidos` avisa quando a edição introduz um
|
|
43
|
+
padrão declarado em `.ai-harness/padroes.json`.
|
|
43
44
|
- **Agents somente leitura:** `revisor-testes`, `qa`, `investigador`, `revisor-spec` e `auditor-plano`.
|
|
44
45
|
- **Verificação:** `npx @fontdata/ai-harness doctor` confere instalação, contrato dos documentos e rastro;
|
|
45
46
|
`npx @fontdata/ai-harness update` atualiza o que foi instalado sem perder alterações locais.
|
package/templates/catalog.json
CHANGED
|
@@ -21,10 +21,15 @@
|
|
|
21
21
|
{ "id": "revisor-testes", "file": "agents/revisor-testes.md", "title": "Agent revisor-testes", "description": "Verifica se cada teste crítico falharia com a implementação errada." }
|
|
22
22
|
],
|
|
23
23
|
"skills": [
|
|
24
|
-
{ "id": "lgpd-checker", "dir": "skills/lgpd-checker", "title": "Skill lgpd-checker", "description": "Conformidade com a LGPD (Lei nº 13.709/2018) em 11 categorias, com checklist e template de relatório. Vendorizada de bittencourtthulio/lgpd-checker." }
|
|
24
|
+
{ "id": "lgpd-checker", "dir": "skills/lgpd-checker", "title": "Skill lgpd-checker", "description": "Conformidade com a LGPD (Lei nº 13.709/2018) em 11 categorias, com checklist e template de relatório. Vendorizada de bittencourtthulio/lgpd-checker." },
|
|
25
|
+
{ "id": "security-audit", "dir": "skills/security-audit", "title": "Skill security-audit", "description": "Auditoria de segurança em fases (reconhecimento, caça, validação adversarial e relatório), com validadores de achados e de cobertura. Vendorizada de cloudflare/security-audit-skill." },
|
|
26
|
+
{ "id": "vercel-react-best-practices", "dir": "skills/vercel-react-best-practices", "title": "Skill vercel-react-best-practices", "description": "Boas práticas de performance em React e Next.js, organizadas por impacto. Vendorizada de vercel-labs/agent-skills." },
|
|
27
|
+
{ "id": "vercel-react-native-skills", "dir": "skills/vercel-react-native-skills", "title": "Skill vercel-react-native-skills", "description": "Boas práticas de performance em React Native e Expo, organizadas por impacto. Vendorizada de vercel-labs/agent-skills." },
|
|
28
|
+
{ "id": "supabase-postgres-best-practices", "dir": "skills/supabase-postgres-best-practices", "title": "Skill supabase-postgres-best-practices", "description": "Boas práticas de Postgres em 8 categorias (consultas, índices, conexões, segurança e outras), por impacto. Vendorizada de supabase/agent-skills." }
|
|
25
29
|
],
|
|
26
30
|
"perfis": [
|
|
27
|
-
{ "id": "delphi", "dir": "perfis/delphi", "title": "Perfil Delphi", "description": "Rules de Delphi, a skill conhecimento-delphi e o hook de encoding, instalados quando o projeto tem .dpr ou .dproj." }
|
|
31
|
+
{ "id": "delphi", "dir": "perfis/delphi", "title": "Perfil Delphi", "description": "Rules de Delphi, a skill conhecimento-delphi e o hook de encoding, instalados quando o projeto tem .dpr ou .dproj." },
|
|
32
|
+
{ "id": "delphi-fiscal", "dir": "perfis/delphi-fiscal", "title": "Perfil Delphi fiscal", "description": "Rules de documento fiscal com ACBr e as skills patch-acbr e diagnosticar-rejeicao-nfse, instalados com o perfil Delphi quando algum .dproj ou o boss.json cita ACBr." }
|
|
28
33
|
],
|
|
29
34
|
"groups": [
|
|
30
35
|
{
|
|
@@ -74,8 +79,8 @@
|
|
|
74
79
|
"commands": [
|
|
75
80
|
{ "id": "memoria", "skill": "skills/memoria", "title": "/memoria", "description": "Mostra quem já mexeu num arquivo e por quê e aponta regressões candidatas de um bug.", "recommended": false },
|
|
76
81
|
{ "id": "auditar-ui", "skill": "skills/auditar-ui", "title": "/auditar-ui", "description": "Navega a app via Playwright MCP e audita UX/UI e/ou acessibilidade (a11y), por tela e severidade.", "recommended": false },
|
|
77
|
-
{ "id": "auditar-performance", "skill": "skills/auditar-performance", "title": "/auditar-performance", "description": "Audita gargalos de performance (queries, bundle, renders, algoritmos).", "recommended": false },
|
|
78
|
-
{ "id": "auditar-seguranca", "skill": "skills/auditar-seguranca", "title": "/auditar-seguranca", "description": "Auditoria defensiva: segredos, deps vulneráveis, inputs sem validação, configs e conformidade LGPD.", "recommended": false, "requiresSkills": ["lgpd-checker"] }
|
|
82
|
+
{ "id": "auditar-performance", "skill": "skills/auditar-performance", "title": "/auditar-performance", "description": "Audita gargalos de performance (queries, bundle, renders, algoritmos).", "recommended": false, "requiresSkills": ["vercel-react-best-practices", "vercel-react-native-skills", "supabase-postgres-best-practices"] },
|
|
83
|
+
{ "id": "auditar-seguranca", "skill": "skills/auditar-seguranca", "title": "/auditar-seguranca", "description": "Auditoria defensiva: segredos, deps vulneráveis, inputs sem validação, configs e conformidade LGPD.", "recommended": false, "requiresSkills": ["lgpd-checker", "security-audit"] }
|
|
79
84
|
]
|
|
80
85
|
},
|
|
81
86
|
{
|
|
@@ -46,6 +46,8 @@ const RASTREIO = [
|
|
|
46
46
|
];
|
|
47
47
|
|
|
48
48
|
const DATA = /(^|[^"'\w])20\d{2}-\d{2}-\d{2}([^"'\w]|$)/;
|
|
49
|
+
const DATA_BR = /(^|[^"'\w/\d])\d{2}\/\d{2}\/(19|20)\d{2}([^"'\w/\d]|$)/;
|
|
50
|
+
const MSG_DATA = 'data de mudança no comentário — o git já registra isso';
|
|
49
51
|
const tokensDeCodigo = (...extras) =>
|
|
50
52
|
new RegExp(`(^|\\s)(${['const', 'let', 'var', 'function', 'return', 'if', 'for', 'while', 'await', 'import', 'export', 'def', 'class', ...extras].join('|')})\\b`);
|
|
51
53
|
const CODIGO_TOKEN = tokensDeCodigo();
|
|
@@ -264,7 +266,7 @@ function analisar(caminho, fonte) {
|
|
|
264
266
|
for (const [re, motivo] of RASTREIO) {
|
|
265
267
|
if (re.test(texto)) { marca(inicio + 1, `${motivo} — isso mora no commit ou em docs/, não no código`); break; }
|
|
266
268
|
}
|
|
267
|
-
if (DATA.test(texto)) marca(inicio + 1,
|
|
269
|
+
if (DATA.test(texto)) marca(inicio + 1, MSG_DATA);
|
|
268
270
|
for (let k = 0; k < conteudo.length; k++) {
|
|
269
271
|
if (conteudo[k] && codigoToken.test(conteudo[k]) && CODIGO_FIM.test(conteudo[k])) {
|
|
270
272
|
marca(inicio + k + 1, 'código comentado — apague, o git guarda');
|
|
@@ -295,6 +297,56 @@ function analisar(caminho, fonte) {
|
|
|
295
297
|
return { achados, comentadas, uteis, densidade: uteis ? comentadas / uteis : 0 };
|
|
296
298
|
}
|
|
297
299
|
|
|
300
|
+
function linhasComDataBr(caminho, fonte) {
|
|
301
|
+
const saida = [];
|
|
302
|
+
classificar(linhasDoFonte(caminho, fonte), extname(caminho)).forEach((c, i) => {
|
|
303
|
+
if (ehTexto(c) && DATA_BR.test(c)) saida.push(i + 1);
|
|
304
|
+
});
|
|
305
|
+
return saida;
|
|
306
|
+
}
|
|
307
|
+
|
|
308
|
+
const contarDataBr = (caminho, fonte) => (typeof fonte === 'string' ? linhasComDataBr(caminho, fonte).length : 0);
|
|
309
|
+
|
|
310
|
+
function desfazer(fonte, edicoes) {
|
|
311
|
+
let texto = fonte;
|
|
312
|
+
for (const e of [...edicoes].reverse()) {
|
|
313
|
+
const { old_string: antigo, new_string: novo } = e ?? {};
|
|
314
|
+
if (typeof antigo !== 'string' || typeof novo !== 'string' || !novo || !texto.includes(novo)) return null;
|
|
315
|
+
texto = e.replace_all ? texto.replaceAll(novo, () => antigo) : texto.replace(novo, () => antigo);
|
|
316
|
+
}
|
|
317
|
+
return texto;
|
|
318
|
+
}
|
|
319
|
+
|
|
320
|
+
function versaoNoHead(caminho) {
|
|
321
|
+
const r = spawnSync('git', ['show', `HEAD:./${parse(caminho).base}`], {
|
|
322
|
+
cwd: dirname(caminho),
|
|
323
|
+
encoding: 'utf8',
|
|
324
|
+
maxBuffer: 64 * 1024 * 1024,
|
|
325
|
+
stdio: ['ignore', 'pipe', 'ignore'],
|
|
326
|
+
});
|
|
327
|
+
return r.error || r.status !== 0 ? null : r.stdout;
|
|
328
|
+
}
|
|
329
|
+
|
|
330
|
+
function aumentouDataBr(caminho, fonte, toolInput) {
|
|
331
|
+
const edicoes = Array.isArray(toolInput?.edits) ? toolInput.edits : typeof toolInput?.new_string === 'string' ? [toolInput] : null;
|
|
332
|
+
const depois = contarDataBr(caminho, fonte);
|
|
333
|
+
if (!edicoes) return depois > 0 && depois > contarDataBr(caminho, versaoNoHead(caminho));
|
|
334
|
+
const reconstruido = desfazer(fonte, edicoes);
|
|
335
|
+
if (reconstruido !== null) return depois > contarDataBr(caminho, reconstruido);
|
|
336
|
+
const soma = (campo) => edicoes.reduce((total, e) => total + contarDataBr(caminho, e?.[campo]), 0);
|
|
337
|
+
return soma('new_string') > soma('old_string');
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
/** Linhas de comentário com data DD/MM/AAAA que a edição introduziu; vazio quando a contagem não aumentou. */
|
|
341
|
+
function datasBrIntroduzidas(caminho, fonte, toolInput) {
|
|
342
|
+
if (!aumentouDataBr(caminho, fonte, toolInput)) return [];
|
|
343
|
+
const novas = linhasDoToolInput(toolInput);
|
|
344
|
+
const linhas = fonte.split('\n');
|
|
345
|
+
const todas = linhasComDataBr(caminho, fonte);
|
|
346
|
+
const tocadas = todas.filter((n) => novas.has(linhas[n - 1].trim()));
|
|
347
|
+
return tocadas.length ? tocadas : todas.length ? todas : [null];
|
|
348
|
+
}
|
|
349
|
+
|
|
298
350
|
const raiz = process.env.CLAUDE_PROJECT_DIR || process.cwd();
|
|
299
351
|
const BASELINE = join(raiz, '.claude', 'hooks', 'comentarios', 'baseline.json');
|
|
300
352
|
|
|
@@ -488,8 +540,9 @@ const aviso = avisoAtalhos(caminho, fonte, payload.tool_input, rel);
|
|
|
488
540
|
let baseline = null;
|
|
489
541
|
try { baseline = JSON.parse(readFileSync(BASELINE, 'utf8')); } catch {}
|
|
490
542
|
const tolerado = baseline?.[chave] ?? 0;
|
|
543
|
+
const datasBr = datasBrIntroduzidas(caminho, fonte, payload.tool_input);
|
|
491
544
|
|
|
492
|
-
if (achados.length <= tolerado) {
|
|
545
|
+
if (achados.length <= tolerado && !datasBr.length) {
|
|
493
546
|
if (baseline && tolerado > 0 && achados.length < tolerado) {
|
|
494
547
|
atualizarBaseline(chave, achados.length);
|
|
495
548
|
console.error(`[comentarios] ${rel}: ${tolerado} → ${achados.length} violações. Catraca desceu — não pode mais subir.`);
|
|
@@ -500,11 +553,15 @@ if (achados.length <= tolerado) {
|
|
|
500
553
|
process.exit(0);
|
|
501
554
|
}
|
|
502
555
|
|
|
503
|
-
const lista = achados
|
|
556
|
+
const lista = [...achados, ...datasBr.map((linha) => ({ linha, msg: MSG_DATA }))]
|
|
557
|
+
.sort((a, b) => (a.linha ?? 0) - (b.linha ?? 0))
|
|
558
|
+
.map((a) => ` ${a.linha === null ? rel : `${rel}:${a.linha}`} ${a.msg}`);
|
|
504
559
|
const contexto =
|
|
505
|
-
tolerado > 0
|
|
560
|
+
tolerado > 0 && achados.length > tolerado
|
|
506
561
|
? `Este arquivo é legado: a baseline tolera ${tolerado} violação(ões) e agora há ${achados.length}. Não é preciso limpar o arquivo inteiro — basta não piorá-lo.`
|
|
507
|
-
:
|
|
562
|
+
: tolerado > 0
|
|
563
|
+
? 'Este arquivo é legado, mas a tolerância da baseline não cobre data DD/MM/AAAA nova: tire a data que a edição introduziu.'
|
|
564
|
+
: 'Este arquivo não tem tolerância na baseline: vale o padrão cheio.';
|
|
508
565
|
|
|
509
566
|
console.error(
|
|
510
567
|
[
|
|
@@ -17,7 +17,8 @@
|
|
|
17
17
|
{
|
|
18
18
|
"matcher": "Edit|Write|MultiEdit",
|
|
19
19
|
"hooks": [
|
|
20
|
-
{ "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/templates/hooks/proteger-contratos.mjs\"" }
|
|
20
|
+
{ "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/templates/hooks/proteger-contratos.mjs\"" },
|
|
21
|
+
{ "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/templates/hooks/padroes-proibidos.mjs\"" }
|
|
21
22
|
]
|
|
22
23
|
}
|
|
23
24
|
],
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
// @ts-check
|
|
2
|
+
import { existsSync, readFileSync } from 'node:fs';
|
|
3
|
+
import { extname, isAbsolute, join } from 'node:path';
|
|
4
|
+
import { runHook } from './lib/hook.mjs';
|
|
5
|
+
|
|
6
|
+
/** @typedef {{ extensoes: string[], regex: RegExp, motivo: string }} Padrao */
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* Entradas válidas de `.ai-harness/padroes.json`; a inválida é descartada sem derrubar as outras.
|
|
10
|
+
* @param {string} root
|
|
11
|
+
* @returns {Padrao[]}
|
|
12
|
+
*/
|
|
13
|
+
function lerPadroes(root) {
|
|
14
|
+
const file = join(root, '.ai-harness', 'padroes.json');
|
|
15
|
+
if (!existsSync(file)) return [];
|
|
16
|
+
const lista = JSON.parse(readFileSync(file, 'utf8'))?.padroes;
|
|
17
|
+
if (!Array.isArray(lista)) return [];
|
|
18
|
+
return lista.flatMap((entrada) => {
|
|
19
|
+
if (typeof entrada !== 'object' || entrada === null) return [];
|
|
20
|
+
const { extensoes, regex, flags, motivo } = entrada;
|
|
21
|
+
if (!Array.isArray(extensoes) || !extensoes.length || typeof regex !== 'string' || typeof motivo !== 'string' || !motivo) return [];
|
|
22
|
+
const aceitos = [...new Set(String(typeof flags === 'string' ? flags : '').replace(/[^imsu]/g, ''))].join('');
|
|
23
|
+
try {
|
|
24
|
+
return [{ extensoes: extensoes.map((ext) => String(ext).toLowerCase()), regex: new RegExp(regex, `${aceitos}g`), motivo }];
|
|
25
|
+
} catch {
|
|
26
|
+
return [];
|
|
27
|
+
}
|
|
28
|
+
});
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* @param {unknown} texto
|
|
33
|
+
* @param {RegExp} regex
|
|
34
|
+
*/
|
|
35
|
+
function contar(texto, regex) {
|
|
36
|
+
return [...String(texto ?? '').matchAll(new RegExp(regex))].length;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* Texto antigo e novo da edição, para comparar a contagem.
|
|
41
|
+
* @param {Record<string, any>} input
|
|
42
|
+
* @param {string} root
|
|
43
|
+
* @returns {{ antes: string[], depois: string[] }}
|
|
44
|
+
*/
|
|
45
|
+
function trechos(input, root) {
|
|
46
|
+
const toolInput = input.tool_input ?? {};
|
|
47
|
+
if (input.tool_name === 'Write') {
|
|
48
|
+
const alvo = String(toolInput.file_path ?? '');
|
|
49
|
+
const caminho = isAbsolute(alvo) ? alvo : join(root, alvo);
|
|
50
|
+
return { antes: [existsSync(caminho) ? readFileSync(caminho, 'utf8') : ''], depois: [String(toolInput.content ?? '')] };
|
|
51
|
+
}
|
|
52
|
+
/** @type {Array<Record<string, unknown>>} */
|
|
53
|
+
const edits = input.tool_name === 'MultiEdit' && Array.isArray(toolInput.edits) ? toolInput.edits : [toolInput];
|
|
54
|
+
return { antes: edits.map((edit) => String(edit?.old_string ?? '')), depois: edits.map((edit) => String(edit?.new_string ?? '')) };
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
await runHook('padroes-proibidos', (input, { root }) => {
|
|
58
|
+
const extensao = extname(String(input.tool_input?.file_path ?? '')).toLowerCase();
|
|
59
|
+
if (!extensao) return null;
|
|
60
|
+
const padroes = lerPadroes(root).filter((padrao) => padrao.extensoes.includes(extensao));
|
|
61
|
+
if (!padroes.length) return null;
|
|
62
|
+
|
|
63
|
+
const { antes, depois } = trechos(input, root);
|
|
64
|
+
const soma = (/** @type {string[]} */ textos, /** @type {RegExp} */ regex) => textos.reduce((total, texto) => total + contar(texto, regex), 0);
|
|
65
|
+
const introduzidos = padroes.filter((padrao) => soma(depois, padrao.regex) > soma(antes, padrao.regex));
|
|
66
|
+
if (!introduzidos.length) return null;
|
|
67
|
+
return { motivo: introduzidos.map((padrao) => padrao.motivo).join(' ') };
|
|
68
|
+
});
|
package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md
CHANGED
|
@@ -77,13 +77,13 @@ grep -n "Bibliotecas\\\\Helpers" *.dproj
|
|
|
77
77
|
As units de helper fazem `uses Fontdata.Utils`, então `Bibliotecas\Utils` também precisa estar no search path.
|
|
78
78
|
Se algum dos caminhos não aparece, **não** acrescente ao `.dproj` por conta própria: pergunte ao usuário.
|
|
79
79
|
|
|
80
|
-
Uma unit por framework, no `uses` da
|
|
80
|
+
Uma unit por framework (`Fontdata.Helpers.VCL`, `Fontdata.Helpers.FMX`, `Fontdata.Helpers.UniGUI`), no `uses` da
|
|
81
|
+
`implementation`.
|
|
81
82
|
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
| UniGUI | `Fontdata.Helpers.UniGUI` | `TUniCheckBox`, `TUniCustomEdit` |
|
|
83
|
+
**Consulte o catálogo antes de escrever.** O que cada unit `Fontdata.*` do search path declara (helpers, classes,
|
|
84
|
+
rotinas, com a assinatura) está em `.claude/skills/conhecimento-delphi/references/bibliotecas-fontdata.md`. O
|
|
85
|
+
arquivo é gerado no projeto, não vem no pacote: se ele não existir, gere com
|
|
86
|
+
`npx @fontdata/ai-harness delphi catalogo`, e rode o comando de novo quando as units mudarem (o `doctor` avisa).
|
|
87
87
|
|
|
88
88
|
Label só tem helper na VCL. `TSwitch` só na FMX. `Replace` só existe na VCL (edit e label); FMX e UniGUI não têm.
|
|
89
89
|
|
|
@@ -53,6 +53,12 @@ Encoding/BOM, `try/finally` e threads não estão aqui: são regras do perfil, j
|
|
|
53
53
|
- `references/horse-gbswagger-rotas-jwt.md` — Horse + gbswagger + JWT: rota que muda ou some, 401 no Swagger,
|
|
54
54
|
`W1074 Unknown custom attribute`.
|
|
55
55
|
|
|
56
|
+
### Bibliotecas Fontdata
|
|
57
|
+
|
|
58
|
+
- `references/bibliotecas-fontdata.md` — catálogo do que as units `Fontdata.*` do search path declaram, antes de
|
|
59
|
+
criar helper ou utilitário. É gerado no projeto por `npx @fontdata/ai-harness delphi catalogo` e não vem no
|
|
60
|
+
pacote: se faltar, rode o comando.
|
|
61
|
+
|
|
56
62
|
### Fiscal
|
|
57
63
|
|
|
58
64
|
- `references/acbr-nfce-integracao.md` — ACBr NFC-e: units, SSL em simulação, `IdCSC`, chave de 44 dígitos,
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
---
|
|
2
|
+
descricao: "Campo novo do ACBr exige preenchimento explícito: a tag sai zerada, não ausente"
|
|
3
|
+
paths:
|
|
4
|
+
- "**/*.pas"
|
|
5
|
+
- "**/*.dfm"
|
|
6
|
+
- "**/*.inc"
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Regra (camada fiscal): campo novo do ACBr exige preenchimento explícito
|
|
10
|
+
|
|
11
|
+
Aplica-se a toda montagem de documento fiscal eletrônico via ACBr (NF-e, NFC-e, CT-e, MDF-e, NFS-e) ao adotar um
|
|
12
|
+
layout novo ou atualizado (ex.: reforma tributária, `VersaoDF >= ve400`). Complementa
|
|
13
|
+
`total-tributo-acbr-soma-itens.md`.
|
|
14
|
+
|
|
15
|
+
## Um campo novo exposto pelo ACBr não é preenchido sozinho
|
|
16
|
+
|
|
17
|
+
Quando o ACBr passa a suportar um layout novo, ele expõe **novas propriedades** no objeto do componente (ex.:
|
|
18
|
+
`Imp.vTotDFe` no CT-e) e o **XmlWriter passa a emitir a tag correspondente sempre** que a versão do layout exige
|
|
19
|
+
(`VersaoDF >= ve400`), **mesmo que o sistema nunca tenha atribuído aquela propriedade**. A tag sai no XML com o
|
|
20
|
+
**valor default (zerado)**, não fica ausente, e a SEFAZ rejeita o documento como campo obrigatório não preenchido
|
|
21
|
+
(ex.: rejeição 360, "Total do DFe de preenchimento obrigatório").
|
|
22
|
+
|
|
23
|
+
O sintoma engana: o XML **tem** a tag, então parece que "o ACBr cuidou disso". O valor está zerado porque nenhuma
|
|
24
|
+
linha do sistema atribuiu a propriedade.
|
|
25
|
+
|
|
26
|
+
Errado (a propriedade nova nunca é atribuída):
|
|
27
|
+
|
|
28
|
+
```pascal
|
|
29
|
+
with ACBrCTe1.Conhecimentos.Add.CTe do
|
|
30
|
+
begin
|
|
31
|
+
Imp.ICMS.SituTrib := cst00;
|
|
32
|
+
Imp.IBSCBS.vBC := LBaseIBSCBS;
|
|
33
|
+
end;
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Certo:
|
|
37
|
+
|
|
38
|
+
```pascal
|
|
39
|
+
with ACBrCTe1.Conhecimentos.Add.CTe do
|
|
40
|
+
begin
|
|
41
|
+
Imp.ICMS.SituTrib := cst00;
|
|
42
|
+
Imp.IBSCBS.vBC := LBaseIBSCBS;
|
|
43
|
+
Imp.vTotDFe := LValorTotalDocumento;
|
|
44
|
+
end;
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## Procedimento obrigatório ao adotar um layout novo do ACBr
|
|
48
|
+
|
|
49
|
+
- Ao subir a versão do layout (`VersaoDF`) ou habilitar um novo grupo de campos (ex.: IBS/CBS da reforma
|
|
50
|
+
tributária), **procure a(s) propriedade(s) nova(s)** na unit que monta o documento e confirme que **cada campo
|
|
51
|
+
obrigatório do novo layout** tem atribuição explícita. "A propriedade existe no componente" não implica "está
|
|
52
|
+
sendo preenchida".
|
|
53
|
+
- Ao investigar uma rejeição de "campo obrigatório não preenchido" depois de adotar um layout novo, **a primeira
|
|
54
|
+
hipótese é esta**: buscar a propriedade na unit de montagem e verificar se há atribuição
|
|
55
|
+
(`grep -n '<PropriedadeDoErro>' <unit>.pas`), antes de suspeitar de outra causa.
|
|
56
|
+
- **Cuidado ao definir o valor:** documentos com lista de itens (NF-e, NFC-e) usam a soma dos itens
|
|
57
|
+
(`total-tributo-acbr-soma-itens.md`); documentos sem lista de itens (CT-e) usam o valor total do próprio
|
|
58
|
+
documento. Confirme a semântica do campo para o tipo de documento antes de atribuir.
|
|
59
|
+
|
|
60
|
+
Um caso típico: `Imp.vTotDFe` do CT-e, campo novo da reforma tributária e irmão de `Imp.IBSCBS`, nunca é atribuído
|
|
61
|
+
na rotina que gera o CT-e, sai `<vTotDFe>0.00</vTotDFe>` no XML e a SEFAZ devolve a rejeição 360.
|