@fontdata/ai-harness 4.3.0 → 4.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/.claude-plugin/plugin.json +2 -2
  2. package/README.md +80 -2
  3. package/dist/config/config.js +37 -3
  4. package/dist/contratos/artefatos.js +13 -5
  5. package/dist/delphi/command.js +102 -1
  6. package/dist/delphi/encoding.js +112 -0
  7. package/dist/init.js +8 -2
  8. package/dist/install/perfis.js +14 -0
  9. package/dist/install/plan.js +29 -2
  10. package/dist/install/settings.js +40 -3
  11. package/dist/update/update.js +69 -7
  12. package/package.json +1 -1
  13. package/templates/catalog.json +3 -0
  14. package/templates/perfis/delphi/hooks/encoding.mjs +317 -0
  15. package/templates/perfis/delphi/rules/build-e-verificacao.md +59 -0
  16. package/templates/perfis/delphi/rules/dados/cnpj-alfanumerico-nao-extrair-so-numeros.md +65 -0
  17. package/templates/perfis/delphi/rules/dados/data-hora-sql-nunca-round-trip-textual.md +78 -0
  18. package/templates/perfis/delphi/rules/dados/datestyle-sessao-firedac-postgres.md +60 -0
  19. package/templates/perfis/delphi/rules/dados/ddl-tabela-nova-exige-trigger-de-log.md +68 -0
  20. package/templates/perfis/delphi/rules/dados/divisao-e-conversao-numerica.md +53 -0
  21. package/templates/perfis/delphi/rules/dados/fieldbyname-value-variant-cru-em-aritmetica.md +73 -0
  22. package/templates/perfis/delphi/rules/dados/filtro-condicional-sql-par-add-parambyname.md +72 -0
  23. package/templates/perfis/delphi/rules/dados/firedac.md +51 -0
  24. package/templates/perfis/delphi/rules/dados/macro-firedac-exige-entrada-macrodata.md +96 -0
  25. package/templates/perfis/delphi/rules/dados/sql-qualificacao-colunas.md +36 -0
  26. package/templates/perfis/delphi/rules/dados/tmeminifile-getstrings-nao-limpa-destino.md +89 -0
  27. package/templates/perfis/delphi/rules/encoding-eol.md +130 -0
  28. package/templates/perfis/delphi/rules/linguagem/dataset-nao-se-le-depois-do-laco-eof.md +56 -0
  29. package/templates/perfis/delphi/rules/linguagem/existencia-nunca-se-testa-por-campo-formatado.md +60 -0
  30. package/templates/perfis/delphi/rules/linguagem/float-nunca-comparado-por-igualdade-com-literal.md +55 -0
  31. package/templates/perfis/delphi/rules/linguagem/literal-enum-de-dfm-exige-unit-no-uses.md +84 -0
  32. package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md +172 -0
  33. package/templates/perfis/delphi/rules/linguagem/sem-clipboard-debug.md +43 -0
  34. package/templates/perfis/delphi/rules/linguagem/validacao-em-onexit-nao-protege-a-gravacao.md +65 -0
  35. package/templates/perfis/delphi/rules/linguagem/variavel-inline-sai-de-escopo-ao-envolver-bloco.md +69 -0
  36. package/templates/perfis/delphi/rules/telas/foco-decisao-por-canfocus-nao-tabstop.md +40 -0
  37. package/templates/perfis/delphi/rules/telas/form-dinamico-liberar-em-toda-saida.md +80 -0
  38. package/templates/perfis/delphi/rules/telas/heranca-de-form-e-grade-de-selecao.md +58 -0
  39. package/templates/perfis/delphi/rules/threads-e-timers.md +131 -0
  40. package/templates/perfis/delphi/rules/try-finally-e-vazamento.md +109 -0
  41. package/templates/perfis/delphi/skills/conhecimento-delphi/SKILL.md +64 -0
  42. package/templates/perfis/delphi/skills/conhecimento-delphi/references/ATRIBUICAO.md +29 -0
  43. package/templates/perfis/delphi/skills/conhecimento-delphi/references/acbr-nfce-integracao.md +60 -0
  44. package/templates/perfis/delphi/skills/conhecimento-delphi/references/build-via-bat-com-log.md +86 -0
  45. package/templates/perfis/delphi/skills/conhecimento-delphi/references/class-var-vaza-para-campos-de-instancia.md +73 -0
  46. package/templates/perfis/delphi/skills/conhecimento-delphi/references/componentes-designer-vs-runtime.md +47 -0
  47. package/templates/perfis/delphi/skills/conhecimento-delphi/references/console-writeln-sem-flush-nao-loga.md +47 -0
  48. package/templates/perfis/delphi/skills/conhecimento-delphi/references/conversao-numerica-locale.md +47 -0
  49. package/templates/perfis/delphi/skills/conhecimento-delphi/references/delphi13-breaking-changes.md +41 -0
  50. package/templates/perfis/delphi/skills/conhecimento-delphi/references/dpr-uses-project-manager.md +62 -0
  51. package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-dcc-debuginformation-nao-booleano.md +78 -0
  52. package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-projectguid-valido.md +38 -0
  53. package/templates/perfis/delphi/skills/conhecimento-delphi/references/firedac-registro-drivers.md +94 -0
  54. package/templates/perfis/delphi/skills/conhecimento-delphi/references/horse-gbswagger-rotas-jwt.md +61 -0
  55. package/templates/perfis/delphi/skills/conhecimento-delphi/references/msb6003-command-line-too-long.md +52 -0
  56. package/templates/perfis/delphi/skills/conhecimento-delphi/references/recursos-rcdata.md +67 -0
  57. package/templates/skills/resolver-bug/SKILL.md +8 -2
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "fontdata",
3
- "version": "4.3.0",
3
+ "version": "4.4.0",
4
4
  "mcpServers": {
5
- "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.3.0", "banco-dados-mcp"] }
5
+ "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.4.0", "banco-dados-mcp"] }
6
6
  },
7
7
  "description": "Harness de engenharia com IA da Fontdata para Claude Code",
8
8
  "author": { "name": "Fontdata" },
package/README.md CHANGED
@@ -102,7 +102,7 @@ npx @fontdata/ai-harness init --comandos resolver-bug,nova-tarefa --sem-harness
102
102
  | `--yes` | Aplica; sem ele, só simula |
103
103
 
104
104
  Com o plugin `fontdata@ai-harness` habilitado, o `init` não instala os hooks no projeto, para eles não rodarem
105
- duas vezes.
105
+ duas vezes. A exceção é o hook do [perfil Delphi](#perfil-delphi), que não vem no plugin.
106
106
 
107
107
  ### Permissões para o modo auto
108
108
 
@@ -121,6 +121,81 @@ Ficam de fora os comandos de teste e build, que variam por projeto, e os que reg
121
121
  Nos modos 1 e 2 nada é gravado no projeto: rode `npx @fontdata/ai-harness update --yes` num projeto já instalado,
122
122
  ou `init`, para receber as regras.
123
123
 
124
+ ## Perfil Delphi
125
+
126
+ Quando o projeto tem `.dpr` ou `.dproj` (até 3 níveis de pasta ou versionado no git), o `init` e o `update` instalam o perfil Delphi. Vale também com o
127
+ plugin habilitado e com `--sem-hooks`: o perfil só chega pelo `init`/`update`, nunca pelo plugin, e sempre leva o
128
+ hook. Projeto sem Delphi não recebe nada. O perfil é um item só no lock (`perfil:delphi`), e o `doctor` confere os
129
+ arquivos dele como confere os demais.
130
+
131
+ | O que instala | Onde |
132
+ |---|---|
133
+ | 26 rules de Delphi: build e verificação, encoding e EOL, threads e timers, `try`/`finally`, linguagem, dados e SQL, telas | `.claude/rules/delphi/` |
134
+ | Skill `conhecimento-delphi`: índice e 14 artigos de armadilhas (`.dproj`, FireDAC, `.dpr`, recursos, Horse, ACBr, Delphi 13...) | `.claude/skills/conhecimento-delphi/` |
135
+ | Hook `delphi-encoding`, em `PreToolUse` (`Edit\|MultiEdit`) e `PostToolUse` (`Write\|Edit\|MultiEdit`) | `.claude/hooks/delphi/encoding.mjs` |
136
+
137
+ Cada rule lista no `paths:` do frontmatter as extensões que lhe dizem respeito, entre `.pas`, `.dfm`, `.dpr`,
138
+ `.dpk`, `.inc`, `.dproj` e `.sql`, e só entra no contexto quando o Claude mexe num desses arquivos. A skill é consultada sob demanda. Os 14 artigos são
139
+ adaptações em pt-BR do plugin [delphi-dev](https://github.com/adrianosantostreina/delphi-dev), sob licença MIT;
140
+ o aviso fica em `.claude/skills/conhecimento-delphi/references/ATRIBUICAO.md`.
141
+
142
+ O `update` não sobrescreve arquivo do projeto que já exista num caminho do perfil, nem com `--forcar`, e não apaga
143
+ rules do projeto que repetem uma rule do perfil: tirar a duplicata fica com você.
144
+
145
+ ### Hook `delphi-encoding`
146
+
147
+ | Arquivo | Antes de `Edit`/`MultiEdit` | Depois de `Write`/`Edit`/`MultiEdit` |
148
+ |---|---|---|
149
+ | `.pas`, `.dpr`, `.dpk`, `.inc` | não é UTF-8 → **bloqueia** e mostra o `delphi encoding converter`; UTF-8 sem BOM → avisa | avisa BOM ausente, U+FFFD, dupla codificação (`é`, `â€`) e EOL misto novos |
150
+ | `.dfm` texto | nada: o encoding do `.dfm` é preservado, nunca convertido | avisa U+FFFD novo e EOL diferente do anterior |
151
+ | `.dfm` binário, `.dproj` e o resto | ignorado | ignorado |
152
+
153
+ "Novo" compara com a versão do arquivo no `HEAD`; arquivo fora do git conta como todo novo, então o aviso se repete
154
+ até o defeito ser corrigido ou commitado. O modo fica em `hooks["delphi-encoding"]` no `.ai-harness/config.json`:
155
+ `bloqueio` (padrão, sem precisar gravar), `aviso` ou `desligado`. Se o hook não consegue ler o evento ou o arquivo,
156
+ ele sai sem bloquear.
157
+
158
+ ### Configuração
159
+
160
+ ```json
161
+ {
162
+ "hooks": { "delphi-encoding": "aviso" },
163
+ "delphi": { "ignorar": ["**/modules/**", "**/ACBr*/**", "**/Terceiros/**"] }
164
+ }
165
+ ```
166
+
167
+ - **`delphi.ignorar`**: globs de arquivos que o hook e o `--todos` do comando pulam. `**` casa qualquer
168
+ profundidade, `*` casa dentro de um segmento; maiúsculas e minúsculas não importam, e `\` vale como separador.
169
+ Sem a chave, valem `['**/modules/**', '**/ACBr*/**']` (código de terceiros, que pode estar em ISO-8859-1 de
170
+ propósito); ao gravar a chave, repita esses dois se quiser mantê-los. Se o hook bloquear uma unit de terceiro,
171
+ acrescente a pasta dela aqui.
172
+ - **Recusar o perfil**: `"perfis": { "delphi": false }` e `npx @fontdata/ai-harness update --yes`. O `init` deixa de
173
+ instalar o perfil. Num projeto que já o tem, o `update` tira o item do lock e o registro do hook do
174
+ `.claude/settings.json` e **mantém** os arquivos; o relatório lista as pastas, que você pode apagar à mão. Depois
175
+ disso o `doctor` não acusa arquivo faltando.
176
+
177
+ Valor inválido em `delphi.ignorar` ou `perfis.delphi` é apontado pelo `doctor` como problema do config, e o padrão
178
+ vale.
179
+
180
+ ### Comando `delphi encoding`
181
+
182
+ ```bash
183
+ npx @fontdata/ai-harness delphi encoding detectar Unit1.pas Form1.dfm
184
+ npx @fontdata/ai-harness delphi encoding converter Unit1.pas
185
+ npx @fontdata/ai-harness delphi encoding checar --todos
186
+ ```
187
+
188
+ - `detectar <arquivos|--todos>`: encoding (UTF-8 com BOM, UTF-8 sem BOM, CP1252, `.dfm` binário) e EOL de cada
189
+ arquivo.
190
+ - `converter <arquivos>`: só `.pas`, `.dpr`, `.dpk` e `.inc` (recusa `.dfm`). UTF-8 com BOM fica intacto; UTF-8 sem
191
+ BOM ganha só o BOM; o resto é lido como CP1252 e gravado em UTF-8 com BOM, sem perder acentos, `€` e aspas curvas.
192
+ O EOL de cada linha não muda.
193
+ - `checar <arquivos|--todos>`: U+FFFD, dupla codificação, BOM ausente (nas extensões do `converter`) e EOL misto;
194
+ sai com código 1 se achar algum.
195
+
196
+ `--todos` pega os fontes Delphi versionados (`git ls-files`) fora de `delphi.ignorar`. Arquivo passado pelo nome é
197
+ processado mesmo que case com `delphi.ignorar`.
198
+
124
199
  ## Conexões de banco de dados
125
200
 
126
201
  O Claude pode ler o banco do projeto (PostgreSQL, MariaDB ou SQLite) sem que ninguém cole credencial no chat. O
@@ -170,6 +245,8 @@ projeto, cadastro, limites do filtro, produção, mascaramento e dúvidas freque
170
245
  | `mapa [caminho]` | Símbolos públicos por pasta do código-fonte, pastas compartilhadas primeiro (`--limite <n>`, padrão 4000 caracteres) |
171
246
  | `atalhos [caminho]` | Lista os `TODO:`/`FIXME:` do código-fonte e marca os sem gatilho (`--sem-gatilho`, `--json`) |
172
247
  | `versao detectar\|calcular\|aplicar` | Fontes de versão do projeto, próxima versão e gravação nos arquivos (veja abaixo) |
248
+ | `delphi classificar\|extrair-icone` | Classifica os `.res` versionados de um projeto Delphi e extrai o ícone que só existe no `.res` |
249
+ | `delphi encoding detectar\|converter\|checar` | Encoding e EOL dos fontes Delphi: diagnóstico, conversão para UTF-8 com BOM e checagem (veja [Comando `delphi encoding`](#comando-delphi-encoding)) |
173
250
  | `list` | Lista o catálogo |
174
251
 
175
252
  O `mapa` lê TS/JS, Delphi, Python, C#, Java, Kotlin, Go, PHP, Rust e Dart. Outra linguagem, ou outra regra para uma
@@ -230,7 +307,8 @@ Os formatos estão em [`docs/contratos/ARTEFATOS.md`](docs/contratos/ARTEFATOS.m
230
307
  | `sem-jargao` | Termo técnico no relatório para o cliente | aviso |
231
308
 
232
309
  O modo de cada hook (`aviso`, `bloqueio` ou `desligado`) fica em `.ai-harness/config.json`. Hook que falha
233
- internamente não atrapalha o trabalho — exceto o de segurança em modo bloqueio.
310
+ internamente não atrapalha o trabalho — exceto o de segurança em modo bloqueio. Projetos Delphi recebem também o
311
+ hook `delphi-encoding`, do [perfil Delphi](#perfil-delphi).
234
312
 
235
313
  ### Agents somente leitura
236
314
 
@@ -13,6 +13,7 @@ export const DEFAULT_HOOK_MODES = {
13
13
  };
14
14
  export const MODOS_PRODUCAO = ['aviso', 'bloqueio'];
15
15
  export const TIPOS_CONEXAO_PROJETO = ['postgres', 'mariadb', 'sqlite'];
16
+ export const DELPHI_IGNORAR_PADRAO = ['**/modules/**', '**/ACBr*/**'];
16
17
  function isObject(value) {
17
18
  return typeof value === 'object' && value !== null && !Array.isArray(value);
18
19
  }
@@ -73,6 +74,8 @@ export function defaultConfig() {
73
74
  declarado: false,
74
75
  },
75
76
  comentarios: { instalar: true },
77
+ perfis: { delphi: true },
78
+ delphi: { ignorar: [...DELPHI_IGNORAR_PADRAO] },
76
79
  };
77
80
  }
78
81
  function inteiroEntre(value, min, max) {
@@ -239,6 +242,19 @@ export function readConfig(root) {
239
242
  else
240
243
  problems.push(`comentarios.instalar deve ser true ou false em ${CONFIG_PATH}.`);
241
244
  }
245
+ if (isObject(raw.perfis) && 'delphi' in raw.perfis) {
246
+ if (typeof raw.perfis.delphi === 'boolean')
247
+ config.perfis.delphi = raw.perfis.delphi;
248
+ else
249
+ problems.push(`perfis.delphi deve ser true ou false em ${CONFIG_PATH}.`);
250
+ }
251
+ if (isObject(raw.delphi) && 'ignorar' in raw.delphi) {
252
+ const ignorar = raw.delphi.ignorar;
253
+ if (Array.isArray(ignorar) && ignorar.every((glob) => typeof glob === 'string'))
254
+ config.delphi.ignorar = ignorar;
255
+ else
256
+ problems.push(`delphi.ignorar deve ser uma lista de globs (texto) em ${CONFIG_PATH}; valem os padrões.`);
257
+ }
242
258
  const secao = soSecaoLegada(raw) ? raw[BANCO_CHAVE_LEGADA] : raw[BANCO_CHAVE];
243
259
  if (isObject(secao))
244
260
  lerBanco(secao, config.banco_dados, problems);
@@ -250,12 +266,12 @@ export function readConfig(root) {
250
266
  }
251
267
  return { config, problems };
252
268
  }
253
- /** Os padrões que vão para o arquivo: sem as seções banco_dados e comentarios, que só entram quando mudam. */
269
+ /** Os padrões que vão para o arquivo: sem as seções banco_dados, comentarios, perfis e delphi, que só entram quando mudam. */
254
270
  function configGravada() {
255
- const { banco_dados: _banco, comentarios: _comentarios, ...gravada } = defaultConfig();
271
+ const { banco_dados: _banco, comentarios: _comentarios, perfis: _perfis, delphi: _delphi, ...gravada } = defaultConfig();
256
272
  return gravada;
257
273
  }
258
- /** Cria a config com os padrões, sem as seções banco_dados e comentarios; retorna false se já existia (nunca sobrescreve). */
274
+ /** Cria a config com os padrões, sem as seções que só entram quando mudam; retorna false se já existia (nunca sobrescreve). */
259
275
  export function writeDefaultConfig(root) {
260
276
  const file = join(root, CONFIG_PATH);
261
277
  if (existsSync(file))
@@ -373,6 +389,24 @@ export function gravarInstalarComentarios(root, valor) {
373
389
  mkdirSync(dirname(file), { recursive: true });
374
390
  writeFileSync(file, `${JSON.stringify(proxima, null, 2)}\n`);
375
391
  }
392
+ /**
393
+ * Grava a recusa do perfil Delphi (`perfis.delphi: false`), preservando o resto do JSON; sem config, cria uma com os
394
+ * padrões e essa chave. `true` desfaz a recusa apagando a chave, e não cria o arquivo. JSON inválido é recusado sem
395
+ * tocar no arquivo.
396
+ */
397
+ export function gravarPerfilDelphi(root, valor) {
398
+ const file = join(root, CONFIG_PATH);
399
+ if (!existsSync(file) && valor)
400
+ return;
401
+ const raw = existsSync(file) ? lerJsonParaEscrita(file, 'perfis.delphi') : configGravada();
402
+ const { delphi: atual, ...resto } = isObject(raw.perfis) ? raw.perfis : {};
403
+ if (valor ? atual === undefined || atual === true : atual === false)
404
+ return;
405
+ const { perfis: _perfis, ...semSecao } = raw;
406
+ const proxima = valor ? (Object.keys(resto).length ? { ...raw, perfis: resto } : semSecao) : { ...raw, perfis: { ...resto, delphi: false } };
407
+ mkdirSync(dirname(file), { recursive: true });
408
+ writeFileSync(file, `${JSON.stringify(proxima, null, 2)}\n`);
409
+ }
376
410
  const BLOCK_START = '# ai-harness (gerenciado pelo harness; não edite entre estas linhas)';
377
411
  const BLOCK_END = '# /ai-harness';
378
412
  /**
@@ -45,14 +45,22 @@ function isData(value) {
45
45
  function isStringList(value) {
46
46
  return Array.isArray(value) && value.every((entry) => typeof entry === 'string');
47
47
  }
48
+ function frontmatterAusente(file, content) {
49
+ const linhas = content.replace(/^/, '').split(/\r?\n/);
50
+ if (linhas[0] !== '---') {
51
+ return { arquivo: file, regra: 'frontmatter-ausente', mensagem: 'O artefato não começa com um frontmatter YAML entre ---.', linha: 1 };
52
+ }
53
+ const colada = linhas.findIndex((linha, i) => i > 0 && linha.trim() !== '---' && linha.trimEnd().endsWith('---'));
54
+ const mensagem = 'O frontmatter abre com --- na linha 1, mas falta o --- de fechamento em linha própria';
55
+ return colada > 0
56
+ ? { arquivo: file, regra: 'frontmatter-ausente', mensagem: `${mensagem}: a linha ${colada + 1} termina com --- colado ao texto.`, linha: colada + 1 }
57
+ : { arquivo: file, regra: 'frontmatter-ausente', mensagem: `${mensagem}.`, linha: 1 };
58
+ }
48
59
  /** Lê o frontmatter de um artefato; `data` ausente quando há problema de leitura. */
49
60
  export function readArtifact(file, content) {
50
61
  const match = /^\uFEFF?---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(content);
51
- if (!match) {
52
- return {
53
- problems: [{ arquivo: file, regra: 'frontmatter-ausente', mensagem: 'O artefato não começa com um frontmatter YAML entre ---.', linha: 1 }],
54
- };
55
- }
62
+ if (!match)
63
+ return { problems: [frontmatterAusente(file, content)] };
56
64
  let data;
57
65
  try {
58
66
  data = parse(match[1] ?? '');
@@ -1,12 +1,18 @@
1
1
  import { existsSync, readFileSync, writeFileSync } from 'node:fs';
2
2
  import { basename, dirname, extname, join, resolve } from 'node:path';
3
+ import { readConfig } from '../config/config.js';
3
4
  import { acharRaiz } from '../raiz.js';
5
+ import { git } from '../trabalhos/arquivar.js';
4
6
  import { classificarRes, detectarDelphi, emRepositorioGit } from './classificar.js';
7
+ import { casaGlob, checarArquivo, converterParaUtf8Bom, detectarEncoding, detectarEol, EXTENSOES_CONVERTER, EXTENSOES_DELPHI, } from './encoding.js';
5
8
  import { extrairIcone } from './icone.js';
6
9
  import { lerRes } from './res.js';
7
10
  const USO = `Uso:
8
11
  npx @fontdata/ai-harness delphi classificar [raiz] [--json]
9
- npx @fontdata/ai-harness delphi extrair-icone <arquivo.res> [--saida <arquivo.ico>]`;
12
+ npx @fontdata/ai-harness delphi extrair-icone <arquivo.res> [--saida <arquivo.ico>]
13
+ npx @fontdata/ai-harness delphi encoding detectar <arquivos...|--todos>
14
+ npx @fontdata/ai-harness delphi encoding converter <arquivos .pas/.dpr/.dpk/.inc...>
15
+ npx @fontdata/ai-harness delphi encoding checar <arquivos...|--todos>`;
10
16
  function classificar(args) {
11
17
  const json = args.includes('--json');
12
18
  const posicionais = args.filter((arg) => arg !== '--json');
@@ -65,12 +71,107 @@ function extrairIconeDoRes(args) {
65
71
  console.log(`Ícone MAINICON gravado em ${destino}.`);
66
72
  return 0;
67
73
  }
74
+ /** Com `--todos`, os fontes Delphi versionados da raiz fora de `delphi.ignorar`; senão, os arquivos pedidos. */
75
+ function fontesPedidas(args) {
76
+ if (!args.includes('--todos'))
77
+ return args.map((nome) => ({ nome, caminho: resolve(process.cwd(), nome) }));
78
+ const raiz = acharRaiz();
79
+ const saida = git(raiz, ['ls-files', '-z', '--', ...EXTENSOES_DELPHI.map((ext) => `:(icase)*${ext}`)]);
80
+ if (saida === null) {
81
+ console.error('Não é um repositório git: --todos precisa do git ls-files.');
82
+ return null;
83
+ }
84
+ const { ignorar } = readConfig(raiz).config.delphi;
85
+ return saida
86
+ .split('\0')
87
+ .filter((nome) => nome && !casaGlob(nome, ignorar) && existsSync(join(raiz, nome)))
88
+ .map((nome) => ({ nome, caminho: join(raiz, nome) }));
89
+ }
90
+ function lerFonte(fonte) {
91
+ try {
92
+ return readFileSync(fonte.caminho);
93
+ }
94
+ catch (erro) {
95
+ const mensagem = erro instanceof Error ? erro.message : String(erro);
96
+ console.error(`Não foi possível ler ${fonte.nome}: ${mensagem}`);
97
+ return null;
98
+ }
99
+ }
100
+ function detectar(fontes) {
101
+ let codigo = 0;
102
+ for (const fonte of fontes) {
103
+ const bytes = lerFonte(fonte);
104
+ if (!bytes) {
105
+ codigo = 1;
106
+ continue;
107
+ }
108
+ const encoding = detectarEncoding(bytes);
109
+ console.log(encoding === 'dfm-binario' ? `${fonte.nome}: ${encoding}` : `${fonte.nome}: ${encoding}, ${detectarEol(bytes)}`);
110
+ }
111
+ return codigo;
112
+ }
113
+ function converter(fontes) {
114
+ const recusadas = fontes.filter((fonte) => !EXTENSOES_CONVERTER.includes(extname(fonte.nome).toLowerCase()));
115
+ if (recusadas.length > 0) {
116
+ for (const fonte of recusadas) {
117
+ console.error(`${fonte.nome}: só .pas, .dpr, .dpk e .inc são convertidos; o encoding do .dfm é preservado.`);
118
+ }
119
+ return 1;
120
+ }
121
+ let codigo = 0;
122
+ for (const fonte of fontes) {
123
+ const bytes = lerFonte(fonte);
124
+ if (!bytes) {
125
+ codigo = 1;
126
+ continue;
127
+ }
128
+ const antes = detectarEncoding(bytes);
129
+ const convertido = converterParaUtf8Bom(bytes);
130
+ if (convertido === bytes) {
131
+ console.log(`${fonte.nome}: já está em UTF-8 com BOM, nada alterado.`);
132
+ continue;
133
+ }
134
+ writeFileSync(fonte.caminho, convertido);
135
+ console.log(`${fonte.nome}: ${antes} -> utf8-bom (EOL preservado).`);
136
+ }
137
+ return codigo;
138
+ }
139
+ function checar(fontes) {
140
+ let codigo = 0;
141
+ let achados = 0;
142
+ for (const fonte of fontes) {
143
+ const bytes = lerFonte(fonte);
144
+ if (!bytes) {
145
+ codigo = 1;
146
+ continue;
147
+ }
148
+ for (const problema of checarArquivo(fonte.nome, bytes)) {
149
+ console.log(`${fonte.nome}:${problema.linha}: ${problema.mensagem}`);
150
+ achados++;
151
+ }
152
+ }
153
+ console.log(achados === 0 ? `Nenhum problema de encoding em ${fontes.length} arquivo(s).` : `${achados} problema(s) de encoding.`);
154
+ return achados > 0 ? 1 : codigo;
155
+ }
156
+ function encoding(args) {
157
+ const [sub, ...resto] = args;
158
+ const acao = sub === 'detectar' ? detectar : sub === 'converter' ? converter : sub === 'checar' ? checar : undefined;
159
+ const todos = resto.includes('--todos');
160
+ if (!acao || resto.length === 0 || (todos && (sub === 'converter' || resto.length > 1))) {
161
+ console.error(USO);
162
+ return 1;
163
+ }
164
+ const fontes = fontesPedidas(resto);
165
+ return fontes ? acao(fontes) : 1;
166
+ }
68
167
  export async function runDelphiCommand(args) {
69
168
  const [sub, ...resto] = args;
70
169
  if (sub === 'classificar')
71
170
  return classificar(resto);
72
171
  if (sub === 'extrair-icone')
73
172
  return extrairIconeDoRes(resto);
173
+ if (sub === 'encoding')
174
+ return encoding(resto);
74
175
  console.error(USO);
75
176
  return 1;
76
177
  }
@@ -0,0 +1,112 @@
1
+ export const EXTENSOES_CONVERTER = ['.pas', '.dpr', '.dpk', '.inc'];
2
+ export const EXTENSOES_DELPHI = [...EXTENSOES_CONVERTER, '.dfm'];
3
+ const BOM = Buffer.from([0xef, 0xbb, 0xbf]);
4
+ function temBom(bytes) {
5
+ return bytes.length >= 3 && bytes[0] === 0xef && bytes[1] === 0xbb && bytes[2] === 0xbf;
6
+ }
7
+ function utf8Valido(bytes) {
8
+ try {
9
+ new TextDecoder('utf-8', { fatal: true }).decode(bytes);
10
+ return true;
11
+ }
12
+ catch {
13
+ return false;
14
+ }
15
+ }
16
+ export function detectarEncoding(bytes) {
17
+ if (bytes.subarray(0, 3).equals(Buffer.from([0xff, 0x0a, 0x00])) || bytes.subarray(0, 4).toString('latin1') === 'TPF0') {
18
+ return 'dfm-binario';
19
+ }
20
+ if (temBom(bytes))
21
+ return 'utf8-bom';
22
+ return utf8Valido(bytes) ? 'utf8-sem-bom' : 'cp1252';
23
+ }
24
+ function contarEol(texto) {
25
+ const crlf = texto.match(/\r\n/g)?.length ?? 0;
26
+ const lf = (texto.match(/\n/g)?.length ?? 0) - crlf;
27
+ return { crlf, lf };
28
+ }
29
+ export function detectarEol(bytes) {
30
+ const { crlf, lf } = contarEol(bytes.toString('latin1'));
31
+ if (crlf && lf)
32
+ return 'misto';
33
+ if (crlf)
34
+ return 'crlf';
35
+ return lf ? 'lf' : 'nenhum';
36
+ }
37
+ /** Texto do arquivo sem o BOM: UTF-8 quando é UTF-8 válido, senão CP1252. */
38
+ export function decodificar(bytes) {
39
+ const corpo = temBom(bytes) ? bytes.subarray(3) : bytes;
40
+ return utf8Valido(corpo) ? corpo.toString('utf8') : new TextDecoder('windows-1252').decode(corpo);
41
+ }
42
+ /**
43
+ * Bytes em UTF-8 com BOM. UTF-8 com BOM volta o mesmo Buffer; UTF-8 sem BOM só ganha o BOM; o resto é lido como
44
+ * CP1252. O EOL não muda porque CR e LF são os mesmos bytes nos dois encodings.
45
+ */
46
+ export function converterParaUtf8Bom(bytes) {
47
+ const encoding = detectarEncoding(bytes);
48
+ if (encoding === 'utf8-bom' || encoding === 'dfm-binario')
49
+ return bytes;
50
+ if (encoding === 'utf8-sem-bom')
51
+ return Buffer.concat([BOM, bytes]);
52
+ return Buffer.concat([BOM, Buffer.from(new TextDecoder('windows-1252').decode(bytes), 'utf8')]);
53
+ }
54
+ const SEGUNDO_BYTE_UTF8 = new TextDecoder('windows-1252').decode(Uint8Array.from({ length: 0x40 }, (_, i) => 0x80 + i));
55
+ const DUPLA_CODIFICACAO = new RegExp(`[ÃÂ][${SEGUNDO_BYTE_UTF8.replace(/[\\\]^-]/g, '\\$&')}]|â€`);
56
+ function extensao(caminho) {
57
+ const ponto = caminho.lastIndexOf('.');
58
+ return ponto < 0 ? '' : caminho.slice(ponto).toLowerCase();
59
+ }
60
+ /** Problemas de encoding do arquivo, com a linha (1 em diante); `.dfm` binário não tem nenhum. */
61
+ export function checarArquivo(caminho, bytes) {
62
+ const encoding = detectarEncoding(bytes);
63
+ if (encoding === 'dfm-binario')
64
+ return [];
65
+ const problemas = [];
66
+ if (encoding !== 'utf8-bom' && EXTENSOES_CONVERTER.includes(extensao(caminho))) {
67
+ problemas.push({ linha: 1, mensagem: `BOM ausente (${encoding})` });
68
+ }
69
+ const texto = decodificar(bytes);
70
+ const linhas = texto.split('\n');
71
+ const eol = detectarEol(bytes);
72
+ const { crlf, lf } = contarEol(texto);
73
+ const eolMaioria = lf > crlf ? 'lf' : 'crlf';
74
+ linhas.forEach((linha, i) => {
75
+ const numero = i + 1;
76
+ if (linha.includes('�'))
77
+ problemas.push({ linha: numero, mensagem: 'caractere U+FFFD' });
78
+ const dupla = linha.match(DUPLA_CODIFICACAO);
79
+ if (dupla)
80
+ problemas.push({ linha: numero, mensagem: `dupla codificação ('${dupla[0]}')` });
81
+ if (eol === 'misto' && i < linhas.length - 1 && (linha.endsWith('\r') ? 'crlf' : 'lf') !== eolMaioria) {
82
+ problemas.push({ linha: numero, mensagem: `EOL misto (${eolMaioria === 'crlf' ? 'LF' : 'CRLF'} num arquivo ${eolMaioria.toUpperCase()})` });
83
+ }
84
+ });
85
+ return problemas;
86
+ }
87
+ function globParaRegex(glob) {
88
+ let fonte = '';
89
+ for (let i = 0; i < glob.length; i++) {
90
+ if (glob.startsWith('**/', i)) {
91
+ fonte += '(?:.*/)?';
92
+ i += 2;
93
+ }
94
+ else if (glob.startsWith('**', i)) {
95
+ fonte += '.*';
96
+ i += 1;
97
+ }
98
+ else if (glob[i] === '*')
99
+ fonte += '[^/]*';
100
+ else
101
+ fonte += glob[i].replace(/[.+?^${}()|[\]\\]/g, '\\$&');
102
+ }
103
+ return new RegExp(`^${fonte}$`, 'i');
104
+ }
105
+ /**
106
+ * Se o caminho relativo casa com algum glob: `**` vale qualquer profundidade (inclusive zero pastas) e `*` fica dentro
107
+ * de um segmento. Barra invertida conta como separador e a comparação ignora maiúsculas, como no Windows.
108
+ */
109
+ export function casaGlob(caminho, padroes) {
110
+ const normalizado = caminho.replace(/\\/g, '/').replace(/^\.\//, '');
111
+ return padroes.some((padrao) => globParaRegex(padrao.replace(/\\/g, '/')).test(normalizado));
112
+ }
package/dist/init.js CHANGED
@@ -12,6 +12,12 @@ import { detectProjectKind } from './install/selection.js';
12
12
  export { detectProjectKind, neededSkillsFor, resolveSelection } from './install/selection.js';
13
13
  const PLUGIN_HOOKS_NOTE = 'O plugin fontdata@ai-harness está habilitado: os hooks já rodam por ele e não foram instalados no projeto, para não rodarem duas vezes.';
14
14
  const PLUGIN_MCP_NOTE = 'O plugin fontdata@ai-harness está habilitado: o servidor MCP de banco já roda por ele e não foi registrado no .mcp.json, para não duplicar.';
15
+ const PERFIL_DELPHI_NOTE = 'Perfil Delphi instalado (projeto Delphi detectado): rules em .claude/rules/delphi/, a skill conhecimento-delphi e o ' +
16
+ 'hook de encoding em .claude/hooks/delphi/, registrado em .claude/settings.json; para recusar, use perfis.delphi: false ' +
17
+ 'no .ai-harness/config.json.';
18
+ function resumo(plan, skippedForPlugin = false) {
19
+ return [describePlan(plan), ...(skippedForPlugin ? [PLUGIN_HOOKS_NOTE] : []), ...(plan.registerPerfilDelphi ? [PERFIL_DELPHI_NOTE] : [])].join(EOL + EOL);
20
+ }
15
21
  /** Registra o MCP de banco no .mcp.json quando não foi recusado (flag, wizard ou config) e o plugin não o fornece. */
16
22
  export function decidirRegistroMcp(options, root, home = homedir()) {
17
23
  return options.mcpBanco && readConfig(root).config.banco_dados.registrar_mcp && !isHarnessPluginEnabled(root, home);
@@ -110,7 +116,7 @@ function runNonInteractive(args) {
110
116
  options.hooks = false;
111
117
  const plan = planInstall(catalog, repoPath, options);
112
118
  applyMcpDecision(plan, options, repoPath);
113
- const summary = [describePlan(plan), ...(skippedForPlugin ? [PLUGIN_HOOKS_NOTE] : [])].join(EOL + EOL);
119
+ const summary = resumo(plan, skippedForPlugin);
114
120
  if (!args.yes) {
115
121
  console.log(`Simulação — nada foi gravado em ${repoPath}.\n\n${summary}\n\nRode de novo com --yes para aplicar.`);
116
122
  return;
@@ -252,7 +258,7 @@ async function runWizard(args) {
252
258
  executePlan(repoPath, plan, packageInfo());
253
259
  prepareProjectFiles(repoPath);
254
260
  s.stop('Instalação concluída.');
255
- p.note(describePlan(plan), `Resumo · ${repoPath}`);
261
+ p.note(resumo(plan), `Resumo · ${repoPath}`);
256
262
  p.outro('Abra o projeto no Claude Code e digite "/" para ver os comandos instalados.');
257
263
  }
258
264
  export async function runInit(argv = []) {
@@ -0,0 +1,14 @@
1
+ import { detectarDelphi } from '../delphi/classificar.js';
2
+ export const PERFIS = ['delphi'];
3
+ 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
+ export function perfisDoProjeto(root, config) {
6
+ return config.perfis.delphi && detectarDelphi(root) ? ['delphi'] : [];
7
+ }
8
+ export function perfilDelphiHooksConfig() {
9
+ const hooks = () => [{ type: 'command', command: PERFIL_DELPHI_HOOK_COMMAND }];
10
+ return {
11
+ PreToolUse: [{ matcher: 'Edit|MultiEdit', hooks: hooks() }],
12
+ PostToolUse: [{ matcher: 'Write|Edit|MultiEdit', hooks: hooks() }],
13
+ };
14
+ }
@@ -7,8 +7,9 @@ import { buildLockItem, hashContent, LOCK_VERSION, readLock, writeLock } from '.
7
7
  import { HOOKS_ITEM_ID, PROJECT_HOOKS_DIR, projectHooksConfig } from './hooks.js';
8
8
  import { neededSkillsFor, resolveSelection } from './selection.js';
9
9
  import { BANCO_MCP_NOME, bancoMcpServer, MCP_PATH, mergeMcpServers } from './mcp.js';
10
- import { gravarInstalarComentarios, gravarRegistrarMcp } from '../config/config.js';
10
+ import { gravarInstalarComentarios, gravarRegistrarMcp, readConfig } from '../config/config.js';
11
11
  import { COMMENTS_RULE_PATH, commentsHooksConfig, ensureCommentsBaseline, hookProprio, hookProprioRegistrado } from '../comentarios/instalar.js';
12
+ import { perfilDelphiHooksConfig, perfisDoProjeto } from './perfis.js';
12
13
  import { combineHooks, HARNESS_DENY, harnessPermissions, mergeSettings } from './settings.js';
13
14
  /** Rule de convenção com o que é específico do projeto (D-38): é do projeto, então fica fora do lock. */
14
15
  export const PROJECT_RULE_PATH = '.claude/rules/harness-projeto.md';
@@ -76,11 +77,31 @@ export function itemSources(catalog, tipo, id) {
76
77
  if (tipo === 'rule' && id === 'comentarios') {
77
78
  return [{ path: COMMENTS_RULE_PATH, source: join(templatesDir, 'rules', 'comentarios.md') }];
78
79
  }
80
+ if (tipo === 'perfil') {
81
+ const perfil = catalog.perfis?.find((candidate) => candidate.id === id);
82
+ if (!perfil)
83
+ return null;
84
+ const base = join(templatesDir, perfil.dir);
85
+ return listFiles(base).flatMap((rel) => {
86
+ const destino = perfilDestino(id, rel);
87
+ return destino ? [{ path: destino, source: join(base, rel) }] : [];
88
+ });
89
+ }
79
90
  if (tipo === 'hook' && id === 'comentarios') {
80
91
  return [{ path: '.claude/hooks/comentarios/check.mjs', source: join(templatesDir, 'hooks', 'comentarios', 'check.mjs') }];
81
92
  }
82
93
  return null;
83
94
  }
95
+ /** Rules e hooks do perfil ficam numa subpasta com o id dele; as skills mantêm o próprio nome. */
96
+ function perfilDestino(id, rel) {
97
+ const [pasta, ...resto] = rel.split('/');
98
+ const caminho = resto.join('/');
99
+ if (pasta === 'rules' || pasta === 'hooks')
100
+ return `.claude/${pasta}/${id}/${caminho}`;
101
+ if (pasta === 'skills')
102
+ return `.claude/skills/${caminho}`;
103
+ return null;
104
+ }
84
105
  /** Agents do catálogo que o lock não tem. Lock sem nenhum agent é a recusa do `--sem-agents`: nada falta. */
85
106
  export function agentsForaDoLock(catalog, lock) {
86
107
  const noLock = new Set(lock.itens.filter((item) => item.tipo === 'agent').map((item) => item.id));
@@ -160,6 +181,12 @@ export function planInstall(catalog, root, options) {
160
181
  if (options.agents)
161
182
  for (const agent of catalog.agents ?? [])
162
183
  add('agent', agent.id);
184
+ // O perfil não depende de options.hooks: o plugin e o --sem-hooks tratam só dos hooks do pacote.
185
+ for (const perfil of perfisDoProjeto(root, readConfig(root).config)) {
186
+ add('perfil', perfil);
187
+ if (perfil === 'delphi')
188
+ plan.registerPerfilDelphi = true;
189
+ }
163
190
  if (plan.registerComments) {
164
191
  add('rule', 'comentarios');
165
192
  add('hook', 'comentarios');
@@ -191,7 +218,7 @@ export function executePlan(root, plan, pkg, now = new Date()) {
191
218
  }
192
219
  applyAtomically(root, plan.files);
193
220
  const permission = needsEventPermission(plan);
194
- const hooks = combineHooks(plan.registerHooks ? projectHooksConfig() : {}, plan.registerComments ? commentsHooksConfig() : {});
221
+ const hooks = combineHooks(plan.registerHooks ? projectHooksConfig() : {}, plan.registerComments ? commentsHooksConfig() : {}, plan.registerPerfilDelphi ? perfilDelphiHooksConfig() : {});
195
222
  if (Object.keys(hooks).length || permission) {
196
223
  mergeSettings(root, { hooks, allow: permission ? harnessPermissions({ banco: bancoAtivo(plan) }) : [], deny: permission ? HARNESS_DENY : [] }, now);
197
224
  }
@@ -101,6 +101,38 @@ export function hookCommands(hooks) {
101
101
  export function normalizarComandoHook(command) {
102
102
  return command.replace(/\$CLAUDE_PROJECT_DIR\b/g, '${CLAUDE_PROJECT_DIR}');
103
103
  }
104
+ /**
105
+ * Tira de `hooks` as entradas com esses comandos, nas duas grafias de `CLAUDE_PROJECT_DIR`, e apaga os grupos, os
106
+ * eventos e a chave `hooks` que ficarem vazios. As outras chaves e os valores fora do formato esperado ficam como estão.
107
+ */
108
+ export function removeHookCommands(settings, comandos) {
109
+ if (!isPlainObject(settings.hooks))
110
+ return settings;
111
+ const remover = new Set(comandos.map(normalizarComandoHook));
112
+ const hooks = {};
113
+ let removido = false;
114
+ for (const [event, groups] of Object.entries(settings.hooks)) {
115
+ if (!Array.isArray(groups)) {
116
+ hooks[event] = groups;
117
+ continue;
118
+ }
119
+ const restantes = groups.flatMap((group) => {
120
+ if (!isPlainObject(group) || !Array.isArray(group.hooks))
121
+ return [group];
122
+ const mantidos = group.hooks.filter((hook) => !(isPlainObject(hook) && typeof hook.command === 'string' && remover.has(normalizarComandoHook(hook.command))));
123
+ if (mantidos.length === group.hooks.length)
124
+ return [group];
125
+ removido = true;
126
+ return mantidos.length ? [{ ...group, hooks: mantidos }] : [];
127
+ });
128
+ if (restantes.length || !groups.length)
129
+ hooks[event] = restantes;
130
+ }
131
+ if (!removido)
132
+ return settings;
133
+ const { hooks: _hooks, ...resto } = settings;
134
+ return (Object.keys(hooks).length ? { ...resto, hooks } : resto);
135
+ }
104
136
  export function mergeHooksIntoSettings(root, hooks, now = new Date()) {
105
137
  return mergeSettings(root, { hooks }, now);
106
138
  }
@@ -109,7 +141,7 @@ export function mergeHooksIntoSettings(root, hooks, now = new Date()) {
109
141
  * sem perder o que já existe. Um hook é considerado presente quando algum grupo do mesmo
110
142
  * evento já tem o mesmo `command`, nas duas grafias de `CLAUDE_PROJECT_DIR`, e uma regra quando já está na lista, o que torna a
111
143
  * operação idempotente. As regras de `removeAllow` saem de `permissions.allow`. Tudo é gravado de uma vez, com um único backup datado do arquivo
112
- * original; JSON inválido é recusado sem tocar em nada.
144
+ * original; JSON inválido é recusado sem tocar em nada. Os hooks de `removeHooks` saem antes dos acréscimos.
113
145
  */
114
146
  export function mergeSettings(root, additions, now = new Date()) {
115
147
  const file = join(root, SETTINGS_PATH);
@@ -136,11 +168,16 @@ export function mergeSettings(root, additions, now = new Date()) {
136
168
  }
137
169
  settings = parsed;
138
170
  }
139
- const next = { ...settings };
171
+ let next = { ...settings };
140
172
  let changed = false;
173
+ if (additions.removeHooks?.length) {
174
+ const semComandos = removeHookCommands(next, additions.removeHooks);
175
+ changed = semComandos !== next;
176
+ next = semComandos;
177
+ }
141
178
  const hookEntries = Object.entries(additions.hooks ?? {});
142
179
  if (hookEntries.length) {
143
- const merged = { ...(settings.hooks ?? {}) };
180
+ const merged = { ...(next.hooks ?? {}) };
144
181
  for (const [event, groups] of hookEntries) {
145
182
  const eventGroups = [...(merged[event] ?? [])];
146
183
  const known = new Set(hookCommands({ [event]: eventGroups }).map(normalizarComandoHook));