@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
|
@@ -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.
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
---
|
|
2
|
+
descricao: "Retorno de evento da NF-e é classificado pelo cStat do evento, nunca pela exceção do ACBr"
|
|
3
|
+
paths:
|
|
4
|
+
- "**/*.pas"
|
|
5
|
+
- "**/*.inc"
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Retorno de evento da NF-e pelo cStat
|
|
9
|
+
|
|
10
|
+
`EnviarEvento` só lança exceção quando o cStat do **lote** é diferente de 128. A rejeição do evento
|
|
11
|
+
(`retEvento[i].RetInfEvento.cStat`: 136, 577 a 579, 596, 650, 655…) volta sem exceção.
|
|
12
|
+
|
|
13
|
+
- Classifique todo cStat do evento no ramo sem exceção, com `retEvento.Count > 0`; não deixe o tratamento só no
|
|
14
|
+
`except`.
|
|
15
|
+
- Nunca grave status sem valor atribuído: todo cStat cai em um status conhecido, e o "demais" é rejeição.
|
|
16
|
+
- Rejeição vai para o log com documento, cStat e xMotivo, nunca com o `RetWS` cru.
|
|
17
|
+
- Nova tentativa (577 a 579, erro de horário da SEFAZ) é controlada por documento, nunca por flag global.
|
|
18
|
+
|
|
19
|
+
Errado:
|
|
20
|
+
|
|
21
|
+
```pascal
|
|
22
|
+
try
|
|
23
|
+
ACBrNFe1.EnviarEvento(LIdLote);
|
|
24
|
+
GravarStatus(LChave, LStatus);
|
|
25
|
+
except
|
|
26
|
+
on E: Exception do
|
|
27
|
+
GravarStatus(LChave, stRejeitado);
|
|
28
|
+
end;
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Certo:
|
|
32
|
+
|
|
33
|
+
```pascal
|
|
34
|
+
ACBrNFe1.EnviarEvento(LIdLote);
|
|
35
|
+
LRetorno := ACBrNFe1.WebServices.EnvEvento.EventoRetorno;
|
|
36
|
+
if LRetorno.retEvento.Count = 0 then
|
|
37
|
+
raise Exception.Create('Retorno de evento sem itens');
|
|
38
|
+
LInfEvento := LRetorno.retEvento[0].RetInfEvento;
|
|
39
|
+
case LInfEvento.cStat of
|
|
40
|
+
135, 136:
|
|
41
|
+
GravarStatus(LChave, stRegistrado);
|
|
42
|
+
577..579:
|
|
43
|
+
AgendarNovaTentativa(LChave);
|
|
44
|
+
else
|
|
45
|
+
GravarStatus(LChave, stRejeitado);
|
|
46
|
+
RegistrarLog(Format('%s: cStat %d - %s', [LChave, LInfEvento.cStat, LInfEvento.xMotivo]));
|
|
47
|
+
end;
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
Por quê: tratar só o `except` grava status vazio quando o evento é rejeitado, prende quem aguarda o retorno e repete
|
|
51
|
+
o envio à SEFAZ.
|
package/templates/perfis/delphi-fiscal/rules/sucesso-de-webservice-fiscal-nao-prova-documento.md
ADDED
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
---
|
|
2
|
+
descricao: "Retorno de sucesso de webservice fiscal (ACBr) não prova que veio documento: ramificar pelo cStat"
|
|
3
|
+
paths:
|
|
4
|
+
- "**/*.pas"
|
|
5
|
+
- "**/*.dpr"
|
|
6
|
+
- "**/*.inc"
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Regra: retorno de sucesso de webservice fiscal não prova que veio documento
|
|
10
|
+
|
|
11
|
+
Aplica-se a toda chamada a webservice fiscal via ACBr (`DistribuicaoDFe`, `Consultar`, `ConsultaCadastro`,
|
|
12
|
+
`DownloadNFe`, `Recibo`, `StatusServico`, eventos e afins) e a qualquer componente que traduza a resposta de um
|
|
13
|
+
serviço em `Boolean` ou em "não levantou exceção". Complementa a rule
|
|
14
|
+
`existencia-nunca-se-testa-por-campo-formatado.md` do perfil Delphi.
|
|
15
|
+
|
|
16
|
+
## A regra
|
|
17
|
+
|
|
18
|
+
Antes de percorrer **qualquer** coleção de retorno, leia o **`cStat`** e ramifique por ele. O `Boolean` devolvido
|
|
19
|
+
pelo componente, ou a ausência de exceção, responde apenas "a conversa com a SEFAZ terminou bem". Nunca responde
|
|
20
|
+
"há documento para processar".
|
|
21
|
+
|
|
22
|
+
## O que é proibido
|
|
23
|
+
|
|
24
|
+
```pascal
|
|
25
|
+
// Errado: sem exceção não quer dizer que veio documento.
|
|
26
|
+
ACBrNFe1.DistribuicaoDFePorUltNSU(LUF, LCNPJ, LUltNSU);
|
|
27
|
+
for I := 0 to ACBrNFe1.WebServices.DistribuicaoDFe.retDistDFeInt.docZip.Count - 1 do
|
|
28
|
+
ProcessarDocumento(I);
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Com a resposta "nada encontrado", o laço não executa, nada é gravado e nenhuma mensagem aparece.
|
|
32
|
+
|
|
33
|
+
No ACBr, `TDistribuicaoDFe.TratarResposta` (`ACBrNFe/ACBrNFeWebServices.pas`) termina com:
|
|
34
|
+
|
|
35
|
+
```pascal
|
|
36
|
+
Result := (FretDistDFeInt.CStat = 137) or (FretDistDFeInt.CStat = 138);
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
O **137 é "Nenhum documento localizado para o interessado"** e entra como **sucesso**. O mesmo padrão vale para
|
|
40
|
+
os demais `TDFeWebService`: cada um tem sua lista de `cStat` aceitos, e essa lista inclui os "não encontrei". Só
|
|
41
|
+
o que está fora dela levanta exceção, via `GerarException`.
|
|
42
|
+
|
|
43
|
+
Certo:
|
|
44
|
+
|
|
45
|
+
```pascal
|
|
46
|
+
ACBrNFe1.DistribuicaoDFePorUltNSU(LUF, LCNPJ, LUltNSU);
|
|
47
|
+
LRetorno := ACBrNFe1.WebServices.DistribuicaoDFe.retDistDFeInt;
|
|
48
|
+
case LRetorno.cStat of
|
|
49
|
+
137:
|
|
50
|
+
InformarUsuario('Nenhum documento novo. Aguarde 1 hora para consultar de novo.');
|
|
51
|
+
138:
|
|
52
|
+
ProcessarDocumentos(LRetorno);
|
|
53
|
+
else
|
|
54
|
+
InformarUsuario(Format('Rejeição %d: %s', [LRetorno.cStat, LRetorno.xMotivo]));
|
|
55
|
+
end;
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## Corolário: resposta de "nada encontrado" não traz os campos de controle
|
|
59
|
+
|
|
60
|
+
Os campos de posição e controle são lidos direto do XML, **sem valor padrão**. Numa resposta 137,
|
|
61
|
+
`retDistDFeInt.ultNSU` e `maxNSU` ficam `''` (`ACBrDFe/Comum/ACBrDFeComum.RetDistDFeInt.pas`), e `''.ToInteger`
|
|
62
|
+
derruba o fluxo com uma mensagem que não diz nada ao usuário.
|
|
63
|
+
|
|
64
|
+
Todo campo de resposta que pode não vir usa `StrToIntDef(..., 0)`, nunca `.ToInteger` nem `StrToInt` sem default.
|
|
65
|
+
|
|
66
|
+
## O pior erro: inventar a posição de leitura
|
|
67
|
+
|
|
68
|
+
Ao receber "nada encontrado", **não calcule** um ponto de partida para "tentar de novo mais perto":
|
|
69
|
+
`maxNSU - 500`, "últimos N dias", "a partir de ontem". O cursor só avança para onde o **serviço** disse que você
|
|
70
|
+
chegou.
|
|
71
|
+
|
|
72
|
+
Um cursor calculado é gravado, **não retrocede** e apaga em silêncio tudo que ficou para trás. O dano não aparece
|
|
73
|
+
no teste: aparece meses depois, no relatório do cliente, como documento que nunca chegou.
|
|
74
|
+
|
|
75
|
+
E quando a regra do serviço manda **esperar** depois do "nada encontrado" (a NT 2014.002 exige 1 hora depois do
|
|
76
|
+
`cStat 137`, sob pena da rejeição **656, Consumo Indevido**), insistir com `Sleep` entre as tentativas é o oposto
|
|
77
|
+
da correção: é o que **provoca** o bloqueio.
|
|
78
|
+
|
|
79
|
+
Um caso típico: a consulta de notas destinadas usa `DistribuicaoDFePorNSU` (`consNSU`) no NSU 0, um NSU que nunca
|
|
80
|
+
existe. A SEFAZ responde 137, o ACBr devolve sucesso e a rotina termina muda; o cliente fica sem receber DF-e
|
|
81
|
+
algum. "Correções" como `maxNSU - 1000`, depois `maxNSU - 500`, depois `Sleep(3000)` atacam o sintoma e ampliam a
|
|
82
|
+
perda de documentos, porque cada uma inventa a posição de leitura em vez de ler o `cStat`.
|
|
83
|
+
|
|
84
|
+
## Por que isso escapa da revisão
|
|
85
|
+
|
|
86
|
+
Não há linha errada para apontar. O código lê como código correto: chama o serviço, não trata erro porque não
|
|
87
|
+
houve erro, percorre a coleção. O defeito está no **contrato** entre o componente e quem o consome.
|
|
88
|
+
|
|
89
|
+
E o sintoma é **ausência**: nada acontece, nada é gravado, nenhum log, nenhuma mensagem. O suporte recebe "o botão
|
|
90
|
+
não funciona" e devolve orientação de uso. O defeito sobrevive a anos de operação porque ninguém desconfia de uma
|
|
91
|
+
chamada que não dá erro.
|
|
92
|
+
|
|
93
|
+
## Antes de fechar a alteração
|
|
94
|
+
|
|
95
|
+
- Para cada chamada a webservice fiscal: **onde está o teste do `cStat`?** Sem ele, o achado é bloqueante.
|
|
96
|
+
- Abra o `TratarResposta` do componente e **liste** quais `cStat` ele considera sucesso. Sempre há um "não
|
|
97
|
+
encontrei" na lista.
|
|
98
|
+
- **Todo** caminho de saída informa o usuário, inclusive "nada novo" e "aguarde N".
|
|
99
|
+
- `grep -n "\.ToInteger\|StrToInt(" <unit>.pas` nos campos do retorno: nenhum sem default.
|
|
100
|
+
- Teste com o caso **vazio**, não só com o caso cheio. O fluxo feliz não distingue os dois.
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
---
|
|
2
|
+
descricao: "Total de tributo no ACBr é a soma dos itens, nunca base total vezes alíquota"
|
|
3
|
+
paths:
|
|
4
|
+
- "**/*.pas"
|
|
5
|
+
- "**/*.dfm"
|
|
6
|
+
- "**/*.inc"
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Regra (camada fiscal): total de tributo no ACBr é a soma dos itens
|
|
10
|
+
|
|
11
|
+
Aplica-se a toda montagem de grupos de totais de tributo enviados ao ACBr em NF-e e NFC-e, em especial os tributos
|
|
12
|
+
IBS/CBS (`IBSCBSTot`: `gCBS.vCBS`, `gIBS.gIBSUFTot.vIBSUF`, `gIBS.gIBSMunTot.vIBSMun`).
|
|
13
|
+
|
|
14
|
+
## Nunca montar o total como base total × alíquota: sempre a soma dos itens
|
|
15
|
+
|
|
16
|
+
O total de um tributo no XML é validado pela SEFAZ contra a **soma dos valores do mesmo tributo em cada item**
|
|
17
|
+
(`det/imposto/.../vXxx`). Calcular o total como `base_total × alíquota` (ou ler um campo de cabeçalho já calculado
|
|
18
|
+
assim) **diverge** da soma dos itens por arredondamento: cada item é `arredondado(base_item × alíquota)`, e a soma
|
|
19
|
+
desses não é igual ao total da base única. A diferença costuma ser de **1 centavo** (mas pode ser maior, e em
|
|
20
|
+
qualquer direção), e gera rejeições como:
|
|
21
|
+
|
|
22
|
+
- **1079**: Total de CBS difere da soma dos itens;
|
|
23
|
+
- **1080**: Total de IBS UF difere da soma dos itens;
|
|
24
|
+
- **1081**: Total de IBS Município difere da soma dos itens.
|
|
25
|
+
|
|
26
|
+
Errado (o total vem do cabeçalho, calculado sobre a base total):
|
|
27
|
+
|
|
28
|
+
```pascal
|
|
29
|
+
IBSCBSTot.gIBS.gIBSUFTot.vIBSUF := LQuery.FieldByName('total_ibs_uf').AsFloat;
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
Certo: acumular o valor **cheio** de cada item, no mesmo ponto em que o valor do item é definido e **antes** de
|
|
33
|
+
qualquer redução, e compor o total descontando explicitamente o que reduz o item no XML (diferimento, tributação
|
|
34
|
+
regular):
|
|
35
|
+
|
|
36
|
+
```pascal
|
|
37
|
+
LSomaIBSUFItens := LSomaIBSUFItens + ArredondarValor(gIBSCBS.gIBSUF.vIBSUF, 2);
|
|
38
|
+
IBSCBSTot.gIBS.gIBSUFTot.vIBSUF := LSomaIBSUFItens - LIBSUFDiferido - LIBSUFTribRegular;
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
A primeira linha fica no laço de itens; a segunda, na montagem do total. `ArredondarValor` é a função de
|
|
42
|
+
arredondamento do projeto, que precisa seguir a mesma regra de arredondamento do componente.
|
|
43
|
+
|
|
44
|
+
- **Mesmo princípio de `vPIS`/`vCOFINS`:** no `ICMSTot` eles já costumam ser montados como soma dos itens; IBS/CBS
|
|
45
|
+
seguem a mesma lógica.
|
|
46
|
+
- **Arredondar por item a 2 casas**, de forma independente do locale, com a mesma semântica de arredondamento que o
|
|
47
|
+
componente usa ao gravar o item, para que `total = Σ round(item)`. Vale também para valores intermediários como
|
|
48
|
+
o **`vDif` do diferimento** (`ArredondarValor(LValor * pDif / 100, 2)`), nunca a divisão crua.
|
|
49
|
+
- A soma captura o valor **cheio** (antes da redução do diferimento) quando o total subtrai o diferimento
|
|
50
|
+
explicitamente; itens de tributação regular entram com o valor cheio e saem pela parcela de tributação regular
|
|
51
|
+
subtraída do total.
|
|
52
|
+
- O erro só aparece **em runtime, na transmissão à SEFAZ**, em cenário de borda (alíquotas fracionárias, muitos
|
|
53
|
+
itens), nunca na compilação.
|
|
54
|
+
|
|
55
|
+
## Vale também para `ICMSTot.vProd`
|
|
56
|
+
|
|
57
|
+
O `vProd` do total é validado contra a soma dos `det/prod/vProd` (rejeição 564). Ler o total de produtos gravado no
|
|
58
|
+
cabeçalho da venda ou da compra diverge por arredondamento, porque o cabeçalho arredonda uma vez e cada item
|
|
59
|
+
arredonda separadamente.
|
|
60
|
+
|
|
61
|
+
- Concilie o resíduo nos itens, nunca no total, porque `vNF` e `vPag` dependem dele.
|
|
62
|
+
- No item ajustado, `qCom × vUnCom` precisa ficar a até R$ 0,01 do `vProd` (rejeição 629), com `vUnCom` nas casas
|
|
63
|
+
decimais de venda do produto.
|
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: diagnosticar-rejeicao-nfse
|
|
3
|
+
description: Diagnostica rejeição de NFS-e devolvida por prefeitura ou pelo ACBrNFSeX, classificando em cadastro do cliente, defeito de código ou limitação da prefeitura antes de qualquer alteração. Use quando aparecer um código ou mensagem de rejeição de NFS-e (E0014, E0177, E0840, X211, Cod004, "não implementado para este provedor", "Element ... is not expected", "já cancelada", "temporariamente indisponível"), quando a nota de serviço voltar rejeitada sem motivo claro, ou quando o DANFSE sair zerado ou incompleto. Não use para NF-e nem NFC-e.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Diagnosticar rejeição de NFS-e
|
|
7
|
+
|
|
8
|
+
A classe de defeito mais comum na NFS-e é sempre a mesma: layout Padrão Nacional, campo que some em silêncio,
|
|
9
|
+
prefeitura respondendo mensagem genérica. Este roteiro existe para não repetir a investigação do zero.
|
|
10
|
+
|
|
11
|
+
**Regra que ordena tudo:** classificar antes de corrigir. Boa parte das rejeições **não é defeito do sistema**, e
|
|
12
|
+
nenhuma alteração de código as resolve.
|
|
13
|
+
|
|
14
|
+
## Passo 0: coletar (não pule)
|
|
15
|
+
|
|
16
|
+
Sem estes cinco dados o diagnóstico é chute:
|
|
17
|
+
|
|
18
|
+
| Dado | Onde encontrar |
|
|
19
|
+
|---|---|
|
|
20
|
+
| Código **e** texto integral da rejeição | log do servidor, XML de resposta gravado no banco |
|
|
21
|
+
| Município e código IBGE do prestador | cadastro da empresa; parâmetro de município de prestação |
|
|
22
|
+
| Ambiente (produção ou homologação) | configuração do componente `ACBrNFSeX` no sistema |
|
|
23
|
+
| Operação | emissão, cancelamento, consulta ou impressão |
|
|
24
|
+
| XML efetivamente enviado | XML gravado da nota, **não** o que se supõe ter sido enviado |
|
|
25
|
+
|
|
26
|
+
## Passo 1: identificar provedor e layout
|
|
27
|
+
|
|
28
|
+
Abra `ACBrNFSeXServicos.ini` na seção do município e leia três coisas:
|
|
29
|
+
|
|
30
|
+
```ini
|
|
31
|
+
[ISSNet]
|
|
32
|
+
Params=APIPropria:|ServicosPadraoNacional:ConsultarNFSePorChave,ConsultarEvento,ConsultarDFe,ConsultarParam,ObterDANFSE
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
1. `Provedor`: `proPadraoNacional`, `proISSNet`, `proBetha`, `proAgili`…
|
|
36
|
+
2. `APIPropria`: presente significa provedor com API própria **sobre** o layout nacional.
|
|
37
|
+
3. `ServicosPadraoNacional`: a lista de serviços que seguem a rota nacional.
|
|
38
|
+
|
|
39
|
+
O layout é o Padrão Nacional quando:
|
|
40
|
+
|
|
41
|
+
```pascal
|
|
42
|
+
LLayoutNacional := (Configuracoes.Geral.Provedor = proPadraoNacional) or
|
|
43
|
+
Configuracoes.Geral.APIPropria;
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
**Cuidado:** `APIPropria` decide o **formato do XML** e **quais serviços** seguem a rota nacional, nunca a rota
|
|
47
|
+
inteira, e nunca por analogia com outra rotina. Antes de aplicar essa condição a uma rotina, confirme o serviço na
|
|
48
|
+
lista `ServicosPadraoNacional`. `ConsultarDPSPorChave` **não** consta: por isso a consulta da NFS-e bifurca só por
|
|
49
|
+
`proPadraoNacional`, e isso está correto.
|
|
50
|
+
|
|
51
|
+
## Passo 2: classificar a natureza
|
|
52
|
+
|
|
53
|
+
| Natureza | Sinal | O que fazer |
|
|
54
|
+
|---|---|---|
|
|
55
|
+
| **Cadastro do cliente** | A prefeitura recusa um valor que é válido no schema, mas não na parametrização municipal | Instruir a correção no cadastro do sistema. **Não mexer no código.** |
|
|
56
|
+
| **Defeito de código** | Tag ausente, valor no campo errado do layout, serviço chamado pela rota errada | Corrigir pelo fluxo normal |
|
|
57
|
+
| **Limitação da prefeitura** | Serviço declarado indisponível ou em construção pelo próprio município | Registrar como aviso nas notas de versão ou no canal de suporte. Não há conserto possível. |
|
|
58
|
+
|
|
59
|
+
## Passo 3: consultar as rejeições já conhecidas
|
|
60
|
+
|
|
61
|
+
| Rejeição | Natureza | Conclusão |
|
|
62
|
+
|---|---|---|
|
|
63
|
+
| `E0014`: DPS já existe em NFS-e gerada anteriormente | Código | A nota **está autorizada** na prefeitura. Vai para a fila de consulta, nunca para rejeitada. Compare pelo **código**, não pelo texto |
|
|
64
|
+
| `E0177`: regime especial não admitido pelo município | **Cadastro** | Trocar o Regime Especial de Tributação do prestador para "Nenhum". Há municípios (ex.: Cuiabá) que não aceitam o `9 - Outros`, embora seja válido no schema |
|
|
65
|
+
| "Serviço Preparar Cancela NFSe não implementado para este provedor" | Código | No layout nacional o cancelamento é o evento **`e101101`** por `EnviarEvento` |
|
|
66
|
+
| "O grupo de informações relativo ao imóvel deve constar na DPS" | Código | `cIndOp` de bem imóvel (`020101`, `020201`, `020301`) exige o grupo `<imovel>` |
|
|
67
|
+
| "Element 'CEP': This element is not expected" | Código | O ISSNet exige o endereço do imóvel com **município junto do CEP**: o XSD dele diverge do nacional |
|
|
68
|
+
| `X211` genérico no cancelamento | Código | O ACBr não achou a lista de mensagens; ler de `WebService.EnviarEvento.Erros`, concatenando **todos** os itens |
|
|
69
|
+
| `Cod004` | Código | Chave da NFS-e vazia: o XML gravado ainda é o da DPS. Validar `NFSe.infNFSe.ID` antes de enviar |
|
|
70
|
+
| "NFS-e já cancelada" | Sucesso | Tratar como cancelamento bem-sucedido |
|
|
71
|
+
| `E0840`: evento de Cancelamento já vinculado à NFS-e | Código | A nota **já está cancelada** no Ambiente Nacional (em geral pelo portal). Gravar como cancelada quando **todos** os `EnviarEvento.Erros` são E0840; retorno misto continua rejeitado. Nunca mandar para a consulta, que a marcaria como não cancelada |
|
|
72
|
+
| "Operação CancelarNfse está temporariamente indisponível. Serviço em construção." | **Limitação** | Serviço indisponível no município (visto no ISSNet). Sem conserto pelo código |
|
|
73
|
+
| Retenção federal não destacada na nota | Código | Campo ABRASF preenchido em vez do nacional; ver o passo 4, item 3 |
|
|
74
|
+
| "Outras Retenções" não aparece | **Limitação** | Não existe campo no layout nacional. Registrar aviso no log |
|
|
75
|
+
|
|
76
|
+
Se a rejeição não estiver na tabela, siga ao passo 4.
|
|
77
|
+
|
|
78
|
+
## Passo 4: rastrear o campo até o XML
|
|
79
|
+
|
|
80
|
+
Para rejeição de campo, percorra a cadeia inteira antes de concluir:
|
|
81
|
+
|
|
82
|
+
1. **Banco**: a query traz a coluna? Se a query é agregada, coluna nova precisa entrar no `SELECT` **e** no
|
|
83
|
+
`GROUP BY`.
|
|
84
|
+
2. **Rotina que monta a NFS-e**: o campo é atribuído? Atenção a campos por item lidos **depois** do laço, com o
|
|
85
|
+
cursor no **último** item.
|
|
86
|
+
3. **Propriedade certa do layout**: `TNFSe.Servico.Valores` acumula campos das duas gerações (ABRASF e nacional).
|
|
87
|
+
Preencher o campo ABRASF não gera erro: a tag simplesmente não aparece.
|
|
88
|
+
4. **`GravarXml` do provedor**: confirme qual propriedade ele lê de fato. `AppendChild(nil)` sai em **silêncio**
|
|
89
|
+
(`ACBrXmlDocument.pas`), e `AddNode` grava tag obrigatória vazia registrando apenas um `wAlerta`
|
|
90
|
+
(`ACBrXmlWriter.pas`).
|
|
91
|
+
5. **XSD do provedor**: compare com o do Padrão Nacional; podem divergir em formato e em campos disponíveis.
|
|
92
|
+
Confira também se o método auxiliar do ACBr é `virtual`; se não for, o `override` do provedor não tem efeito.
|
|
93
|
+
|
|
94
|
+
## Saída esperada
|
|
95
|
+
|
|
96
|
+
Sempre neste formato, mesmo quando a conclusão é "não é defeito nosso":
|
|
97
|
+
|
|
98
|
+
```
|
|
99
|
+
REJEIÇÃO: <código> — <texto integral da prefeitura>
|
|
100
|
+
PROVEDOR: <nome> | APIPropria: <sim/não> | Layout: <Nacional/ABRASF>
|
|
101
|
+
OPERAÇÃO: <emissão|cancelamento|consulta|impressão>
|
|
102
|
+
SERVIÇO NA LISTA ServicosPadraoNacional: <sim/não/não se aplica>
|
|
103
|
+
|
|
104
|
+
NATUREZA: <cadastro | código | limitação da prefeitura>
|
|
105
|
+
|
|
106
|
+
EVIDÊNCIA:
|
|
107
|
+
<trecho do XML enviado, ou o ponto do código, ou a linha do XSD>
|
|
108
|
+
|
|
109
|
+
CONCLUSÃO:
|
|
110
|
+
<cadastro> → qual campo o cliente corrige, em que tela do sistema
|
|
111
|
+
<código> → arquivo:linha a alterar e qual propriedade do layout usar
|
|
112
|
+
<limitação> → texto do aviso para as notas de versão ou o suporte
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
## Exemplo
|
|
116
|
+
|
|
117
|
+
**Entrada:** "NFS-e de Cuiabá rejeitou com: *O grupo de informações relativo ao imóvel deve constar na DPS para o
|
|
118
|
+
indicador da operação informado*."
|
|
119
|
+
|
|
120
|
+
**Saída:**
|
|
121
|
+
|
|
122
|
+
```
|
|
123
|
+
REJEIÇÃO: — O grupo de informações relativo ao imóvel deve constar na DPS
|
|
124
|
+
para o indicador da operação informado
|
|
125
|
+
PROVEDOR: ISSNet (Cuiabá, 5103403) | APIPropria: sim | Layout: Nacional
|
|
126
|
+
OPERAÇÃO: emissão
|
|
127
|
+
SERVIÇO NA LISTA: não se aplica (emissão)
|
|
128
|
+
|
|
129
|
+
NATUREZA: código
|
|
130
|
+
|
|
131
|
+
EVIDÊNCIA:
|
|
132
|
+
cIndOp do prestador = 020201 (serviço sobre bem imóvel).
|
|
133
|
+
A rotina que monta a NFS-e preenche IBSCBS.finNFSe, indFinal, cIndOp e
|
|
134
|
+
indDest, mas nunca toca em IBSCBS.imovel — e o ACBr só emite a tag se
|
|
135
|
+
algum campo do grupo estiver preenchido (ACBrNFSeXGravarXml.pas).
|
|
136
|
+
|
|
137
|
+
CONCLUSÃO:
|
|
138
|
+
código → preencher IBSCBS.imovel com o endereço do tomador quando cIndOp
|
|
139
|
+
for 020101, 020201 ou 020301. No ISSNet o <end> exige município junto do
|
|
140
|
+
CEP (TCEndereco), diferente do Padrão Nacional (TCEnderObraEvento), e não
|
|
141
|
+
existe cCIB. Validar CEP, logradouro, número e bairro antes de enviar e
|
|
142
|
+
falhar com mensagem de negócio dizendo qual campo falta.
|
|
143
|
+
Toda saída por exceção na montagem precisa de NotasFiscais.Clear no except.
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
## Quando não usar
|
|
147
|
+
|
|
148
|
+
- **NF-e ou NFC-e**: outra biblioteca (`ACBrNFe`), outro conjunto de rejeições, outra contingência.
|
|
149
|
+
- **Erro de conexão, certificado ou SSL**: não é rejeição de conteúdo; olhe a configuração do componente, a
|
|
150
|
+
validade do certificado e as bibliotecas de SSL configuradas.
|
|
151
|
+
- **A nota nem chegou a ser transmitida**: se falhou na montagem, o problema é dado de origem ou query, não
|
|
152
|
+
resposta da prefeitura.
|
|
153
|
+
- **Já se sabe que é cadastro**: não gaste o roteiro; instrua a correção direto.
|
|
154
|
+
- **Escrever o conserto**: esta skill diagnostica e classifica. A correção segue o fluxo normal (`/resolver-bug`),
|
|
155
|
+
respeitando as rules do projeto.
|