@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.
- package/.claude-plugin/plugin.json +2 -2
- package/README.md +80 -2
- package/dist/config/config.js +37 -3
- package/dist/contratos/artefatos.js +13 -5
- package/dist/delphi/command.js +102 -1
- package/dist/delphi/encoding.js +112 -0
- package/dist/init.js +8 -2
- package/dist/install/perfis.js +14 -0
- package/dist/install/plan.js +29 -2
- package/dist/install/settings.js +40 -3
- package/dist/update/update.js +69 -7
- package/package.json +1 -1
- package/templates/catalog.json +3 -0
- package/templates/perfis/delphi/hooks/encoding.mjs +317 -0
- package/templates/perfis/delphi/rules/build-e-verificacao.md +59 -0
- package/templates/perfis/delphi/rules/dados/cnpj-alfanumerico-nao-extrair-so-numeros.md +65 -0
- package/templates/perfis/delphi/rules/dados/data-hora-sql-nunca-round-trip-textual.md +78 -0
- package/templates/perfis/delphi/rules/dados/datestyle-sessao-firedac-postgres.md +60 -0
- package/templates/perfis/delphi/rules/dados/ddl-tabela-nova-exige-trigger-de-log.md +68 -0
- package/templates/perfis/delphi/rules/dados/divisao-e-conversao-numerica.md +53 -0
- package/templates/perfis/delphi/rules/dados/fieldbyname-value-variant-cru-em-aritmetica.md +73 -0
- package/templates/perfis/delphi/rules/dados/filtro-condicional-sql-par-add-parambyname.md +72 -0
- package/templates/perfis/delphi/rules/dados/firedac.md +51 -0
- package/templates/perfis/delphi/rules/dados/macro-firedac-exige-entrada-macrodata.md +96 -0
- package/templates/perfis/delphi/rules/dados/sql-qualificacao-colunas.md +36 -0
- package/templates/perfis/delphi/rules/dados/tmeminifile-getstrings-nao-limpa-destino.md +89 -0
- package/templates/perfis/delphi/rules/encoding-eol.md +130 -0
- package/templates/perfis/delphi/rules/linguagem/dataset-nao-se-le-depois-do-laco-eof.md +56 -0
- package/templates/perfis/delphi/rules/linguagem/existencia-nunca-se-testa-por-campo-formatado.md +60 -0
- package/templates/perfis/delphi/rules/linguagem/float-nunca-comparado-por-igualdade-com-literal.md +55 -0
- package/templates/perfis/delphi/rules/linguagem/literal-enum-de-dfm-exige-unit-no-uses.md +84 -0
- package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md +172 -0
- package/templates/perfis/delphi/rules/linguagem/sem-clipboard-debug.md +43 -0
- package/templates/perfis/delphi/rules/linguagem/validacao-em-onexit-nao-protege-a-gravacao.md +65 -0
- package/templates/perfis/delphi/rules/linguagem/variavel-inline-sai-de-escopo-ao-envolver-bloco.md +69 -0
- package/templates/perfis/delphi/rules/telas/foco-decisao-por-canfocus-nao-tabstop.md +40 -0
- package/templates/perfis/delphi/rules/telas/form-dinamico-liberar-em-toda-saida.md +80 -0
- package/templates/perfis/delphi/rules/telas/heranca-de-form-e-grade-de-selecao.md +58 -0
- package/templates/perfis/delphi/rules/threads-e-timers.md +131 -0
- package/templates/perfis/delphi/rules/try-finally-e-vazamento.md +109 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/SKILL.md +64 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/ATRIBUICAO.md +29 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/acbr-nfce-integracao.md +60 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/build-via-bat-com-log.md +86 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/class-var-vaza-para-campos-de-instancia.md +73 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/componentes-designer-vs-runtime.md +47 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/console-writeln-sem-flush-nao-loga.md +47 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/conversao-numerica-locale.md +47 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/delphi13-breaking-changes.md +41 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/dpr-uses-project-manager.md +62 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-dcc-debuginformation-nao-booleano.md +78 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-projectguid-valido.md +38 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/firedac-registro-drivers.md +94 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/horse-gbswagger-rotas-jwt.md +61 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/msb6003-command-line-too-long.md +52 -0
- package/templates/perfis/delphi/skills/conhecimento-delphi/references/recursos-rcdata.md +67 -0
- package/templates/skills/resolver-bug/SKILL.md +8 -2
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "fontdata",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "4.4.0",
|
|
4
4
|
"mcpServers": {
|
|
5
|
-
"banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.
|
|
5
|
+
"banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.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
|
|
package/dist/config/config.js
CHANGED
|
@@ -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
|
|
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
|
|
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] ?? '');
|
package/dist/delphi/command.js
CHANGED
|
@@ -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 =
|
|
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(
|
|
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
|
+
}
|
package/dist/install/plan.js
CHANGED
|
@@ -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
|
}
|
package/dist/install/settings.js
CHANGED
|
@@ -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
|
-
|
|
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 = { ...(
|
|
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));
|