@fontdata/ai-harness 4.1.1 → 4.2.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.
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "fontdata",
3
- "version": "4.1.1",
3
+ "version": "4.2.0",
4
4
  "mcpServers": {
5
- "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.1.1", "banco-dados-mcp"] }
5
+ "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@4.2.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/dist/cli.js CHANGED
@@ -21,6 +21,7 @@ const RESERVED = new Set([
21
21
  'banco-dados',
22
22
  'banco-dados-mcp',
23
23
  'versao',
24
+ 'delphi',
24
25
  'list',
25
26
  'run',
26
27
  'help',
@@ -68,6 +69,7 @@ Gerenciar:
68
69
  banco-dados <subcomando> Conexões de banco somente leitura: adicionar, listar, testar, usar, remover
69
70
  banco-dados-mcp Servidor MCP de leitura do banco, usado pelo Claude Code (stdio)
70
71
  versao detectar|calcular|aplicar Fontes de versão, próxima versão e gravação (--app, --json; aplicar --dry-run)
72
+ delphi classificar|extrair-icone .res de projetos Delphi: classificação e extração do ícone
71
73
  list Lista todos os comandos disponíveis no catálogo
72
74
 
73
75
  Init sem perguntas (CI):
@@ -183,6 +185,10 @@ async function main() {
183
185
  const { runVersaoCommand } = await import('./versao/command.js');
184
186
  process.exit(runVersaoCommand(argv.slice(1)));
185
187
  }
188
+ if (cmd === 'delphi') {
189
+ const { runDelphiCommand } = await import('./delphi/command.js');
190
+ process.exit(await runDelphiCommand(argv.slice(1)));
191
+ }
186
192
  if (cmd === 'run') {
187
193
  const id = argv[1];
188
194
  if (!id) {
@@ -0,0 +1,126 @@
1
+ import { readdirSync, readFileSync } from 'node:fs';
2
+ import { dirname, join, relative, sep } from 'node:path';
3
+ import { git, isVersioned } from '../trabalhos/arquivar.js';
4
+ import { varrerArquivos } from '../versao/detectar.js';
5
+ import { lerRes } from './res.js';
6
+ const RT_ICON = 3;
7
+ const RT_RCDATA = 10;
8
+ const RT_GROUP_ICON = 14;
9
+ const RT_VERSION = 16;
10
+ const RT_MANIFEST = 24;
11
+ export function detectarDelphi(raiz) {
12
+ if (varrerArquivos(raiz, '', 3, /\.(dproj|dpr)$/i).length > 0)
13
+ return true;
14
+ return Boolean(git(raiz, ['ls-files', '--', ':(icase)*.dproj', ':(icase)*.dpr'])?.trim());
15
+ }
16
+ export function emRepositorioGit(raiz) {
17
+ return git(raiz, ['rev-parse', '--is-inside-work-tree'])?.trim() === 'true';
18
+ }
19
+ function mesmoNome(nome, esperado) {
20
+ return typeof nome === 'string' && nome.toUpperCase() === esperado;
21
+ }
22
+ function recursoRegeravel(r) {
23
+ if (r.tipo === RT_VERSION || r.tipo === RT_ICON || r.tipo === RT_MANIFEST)
24
+ return true;
25
+ if (r.tipo === RT_GROUP_ICON)
26
+ return mesmoNome(r.nome, 'MAINICON');
27
+ if (r.tipo === RT_RCDATA)
28
+ return mesmoNome(r.nome, 'PLATFORMTARGETS');
29
+ return false;
30
+ }
31
+ function descreverRecurso(r) {
32
+ return `tipo ${r.tipo}, nome ${r.nome}`;
33
+ }
34
+ function vendorizado(raiz, caminho) {
35
+ const saida = git(raiz, ['check-attr', '-z', 'linguist-vendored', '--', caminho]);
36
+ const valor = saida?.split('\0')[2];
37
+ return valor === 'set' || valor === 'true';
38
+ }
39
+ function acharNaPasta(pasta, nome) {
40
+ let entradas;
41
+ try {
42
+ entradas = readdirSync(pasta);
43
+ }
44
+ catch {
45
+ return null;
46
+ }
47
+ const alvo = nome.toLowerCase();
48
+ const achado = entradas.find((e) => e.toLowerCase() === alvo);
49
+ return achado === undefined ? null : join(pasta, achado);
50
+ }
51
+ function resolverSemCaixa(pasta, caminho) {
52
+ let atual = pasta;
53
+ for (const segmento of caminho.split(/[\\/]/)) {
54
+ if (atual === null)
55
+ return null;
56
+ if (segmento === '' || segmento === '.')
57
+ continue;
58
+ atual = segmento === '..' ? dirname(atual) : acharNaPasta(atual, segmento);
59
+ }
60
+ return atual;
61
+ }
62
+ function iconesProprios(dproj) {
63
+ const texto = readFileSync(dproj, 'utf8');
64
+ return [...texto.matchAll(/<Icon_MainIcon>([^<]*)<\/Icon_MainIcon>/gi)]
65
+ .map((m) => m[1].trim())
66
+ .filter((valor) => valor !== '' && !valor.toUpperCase().startsWith('$(BDS)'));
67
+ }
68
+ function paraPosix(caminho) {
69
+ return caminho.split(sep).join('/');
70
+ }
71
+ function classificar(raiz, caminho) {
72
+ if (vendorizado(raiz, caminho)) {
73
+ return { classe: 'manter', motivo: 'Pasta marcada como linguist-vendored no .gitattributes (biblioteca de terceiros).' };
74
+ }
75
+ const absoluto = join(raiz, caminho);
76
+ const pasta = dirname(absoluto);
77
+ const projeto = absoluto.slice(pasta.length + 1).replace(/\.res$/i, '');
78
+ const dpr = acharNaPasta(pasta, `${projeto}.dpr`);
79
+ const dproj = acharNaPasta(pasta, `${projeto}.dproj`);
80
+ if (dpr === null || dproj === null) {
81
+ const falta = [dpr === null ? `${projeto}.dpr` : null, dproj === null ? `${projeto}.dproj` : null].filter(Boolean);
82
+ return { classe: 'manter', motivo: `Falta ${falta.join(' e ')} na mesma pasta: a IDE não regera este .res.` };
83
+ }
84
+ let recursos;
85
+ try {
86
+ recursos = lerRes(readFileSync(absoluto));
87
+ }
88
+ catch (erro) {
89
+ return { classe: 'manter', motivo: `O .res não pôde ser lido: ${erro.message}` };
90
+ }
91
+ const proprios = recursos.filter((r) => !recursoRegeravel(r));
92
+ if (proprios.length > 0) {
93
+ return {
94
+ classe: 'manter',
95
+ motivo: `O .res tem recurso que a IDE não regera (${proprios.map(descreverRecurso).join('; ')}).`,
96
+ };
97
+ }
98
+ const temMainIcon = recursos.some((r) => r.tipo === RT_GROUP_ICON && mesmoNome(r.nome, 'MAINICON'));
99
+ const icones = iconesProprios(dproj);
100
+ if (temMainIcon && icones.length === 0) {
101
+ return {
102
+ classe: 'icone-so-no-res',
103
+ motivo: 'O .dproj não tem Icon_MainIcon próprio (só $(BDS)): o MAINICON existe só dentro do .res.',
104
+ };
105
+ }
106
+ for (const icone of icones) {
107
+ const ico = resolverSemCaixa(pasta, icone);
108
+ if (ico === null) {
109
+ return { classe: 'icone-so-no-res', motivo: `O Icon_MainIcon ${icone} não existe no disco: o ícone existe só dentro do .res.` };
110
+ }
111
+ if (!isVersioned(raiz, paraPosix(relative(raiz, ico)))) {
112
+ return { classe: 'icone-so-no-res', motivo: `O Icon_MainIcon ${icone} não está versionado: o ícone existe só dentro do .res.` };
113
+ }
114
+ }
115
+ return { classe: 'regeravel', motivo: 'Só tem os recursos que a IDE regera a partir do .dproj.' };
116
+ }
117
+ /** Classifica cada `.res` rastreado pelo git, com caminho relativo à raiz e `/`; fora de um repositório, `[]`. */
118
+ export function classificarRes(raiz) {
119
+ if (!emRepositorioGit(raiz))
120
+ return [];
121
+ const saida = git(raiz, ['ls-files', '-z', '--', ':(icase)*.res']) ?? '';
122
+ return saida
123
+ .split('\0')
124
+ .filter((caminho) => caminho !== '')
125
+ .map((caminho) => ({ caminho, ...classificar(raiz, caminho) }));
126
+ }
@@ -0,0 +1,76 @@
1
+ import { existsSync, readFileSync, writeFileSync } from 'node:fs';
2
+ import { basename, dirname, extname, join, resolve } from 'node:path';
3
+ import { acharRaiz } from '../raiz.js';
4
+ import { classificarRes, detectarDelphi, emRepositorioGit } from './classificar.js';
5
+ import { extrairIcone } from './icone.js';
6
+ import { lerRes } from './res.js';
7
+ const USO = `Uso:
8
+ npx @fontdata/ai-harness delphi classificar [raiz] [--json]
9
+ npx @fontdata/ai-harness delphi extrair-icone <arquivo.res> [--saida <arquivo.ico>]`;
10
+ function classificar(args) {
11
+ const json = args.includes('--json');
12
+ const posicionais = args.filter((arg) => arg !== '--json');
13
+ const raiz = posicionais[0] === undefined ? acharRaiz() : resolve(process.cwd(), posicionais[0]);
14
+ if (!emRepositorioGit(raiz)) {
15
+ console.error('Não é um repositório git: a classificação precisa do git ls-files.');
16
+ return 1;
17
+ }
18
+ const delphi = detectarDelphi(raiz);
19
+ const res = classificarRes(raiz);
20
+ if (json) {
21
+ console.log(JSON.stringify({ delphi, res }, null, 2));
22
+ return 0;
23
+ }
24
+ console.log(delphi ? 'Stack Delphi detectada.' : 'Stack Delphi não detectada.');
25
+ if (res.length === 0) {
26
+ console.log('Nenhum .res rastreado pelo git.');
27
+ return 0;
28
+ }
29
+ for (const item of res)
30
+ console.log(` ${item.caminho} ${item.classe} ${item.motivo}`);
31
+ return 0;
32
+ }
33
+ function extrairIconeDoRes(args) {
34
+ const posicionais = [];
35
+ let saida;
36
+ for (let i = 0; i < args.length; i++) {
37
+ if (args[i] === '--saida')
38
+ saida = args[++i];
39
+ else
40
+ posicionais.push(args[i]);
41
+ }
42
+ const arquivo = posicionais[0];
43
+ if (!arquivo || (args.includes('--saida') && !saida)) {
44
+ console.error(USO);
45
+ return 1;
46
+ }
47
+ const origem = resolve(process.cwd(), arquivo);
48
+ const destino = saida
49
+ ? resolve(process.cwd(), saida)
50
+ : join(dirname(origem), `${basename(origem, extname(origem))}_Icon.ico`);
51
+ if (existsSync(destino)) {
52
+ console.error(`O arquivo ${destino} já existe; não foi sobrescrito.`);
53
+ return 1;
54
+ }
55
+ let icone;
56
+ try {
57
+ icone = extrairIcone(lerRes(readFileSync(origem)));
58
+ }
59
+ catch (erro) {
60
+ const mensagem = erro instanceof Error ? erro.message : String(erro);
61
+ console.error(`Não foi possível extrair o ícone de ${origem}: ${mensagem}`);
62
+ return 1;
63
+ }
64
+ writeFileSync(destino, icone, { flag: 'wx' });
65
+ console.log(`Ícone MAINICON gravado em ${destino}.`);
66
+ return 0;
67
+ }
68
+ export async function runDelphiCommand(args) {
69
+ const [sub, ...resto] = args;
70
+ if (sub === 'classificar')
71
+ return classificar(resto);
72
+ if (sub === 'extrair-icone')
73
+ return extrairIconeDoRes(resto);
74
+ console.error(USO);
75
+ return 1;
76
+ }
@@ -0,0 +1,37 @@
1
+ const RT_ICON = 3;
2
+ const RT_GROUP_ICON = 14;
3
+ /**
4
+ * Monta o .ico a partir do RT_GROUP_ICON MAINICON e dos RT_ICON que ele referencia.
5
+ * Com dois RT_ICON de mesmo id, vale o primeiro.
6
+ */
7
+ export function extrairIcone(recursos) {
8
+ const grupo = recursos.find((r) => r.tipo === RT_GROUP_ICON && typeof r.nome === 'string' && r.nome.toUpperCase() === 'MAINICON');
9
+ if (!grupo)
10
+ throw new Error('O .res não tem o grupo de ícones MAINICON.');
11
+ const dados = grupo.dados;
12
+ if (dados.length < 6)
13
+ throw new Error('Grupo de ícones MAINICON truncado.');
14
+ const count = dados.readUInt16LE(4);
15
+ if (dados.length < 6 + 14 * count)
16
+ throw new Error('Grupo de ícones MAINICON truncado.');
17
+ const blobs = [];
18
+ for (let i = 0; i < count; i++) {
19
+ const id = dados.readUInt16LE(6 + 14 * i + 12);
20
+ const icone = recursos.find((r) => r.tipo === RT_ICON && r.nome === id);
21
+ if (!icone)
22
+ throw new Error(`O grupo MAINICON referencia o RT_ICON ${id}, que não existe no .res.`);
23
+ blobs.push(icone.dados);
24
+ }
25
+ const cabecalho = Buffer.alloc(6 + 16 * count);
26
+ cabecalho.writeUInt16LE(0, 0);
27
+ cabecalho.writeUInt16LE(1, 2);
28
+ cabecalho.writeUInt16LE(count, 4);
29
+ let offsetBlob = cabecalho.length;
30
+ blobs.forEach((blob, i) => {
31
+ const entrada = 6 + 16 * i;
32
+ dados.copy(cabecalho, entrada, 6 + 14 * i, 6 + 14 * i + 12);
33
+ cabecalho.writeUInt32LE(offsetBlob, entrada + 12);
34
+ offsetBlob += blob.length;
35
+ });
36
+ return Buffer.concat([cabecalho, ...blobs]);
37
+ }
@@ -0,0 +1,47 @@
1
+ function alinhar4(valor) {
2
+ return (valor + 3) & ~3;
3
+ }
4
+ function lerIdentificador(buffer, inicio, fim) {
5
+ if (inicio + 2 > fim)
6
+ throw new Error(`Cabeçalho de recurso inválido no offset ${inicio} do .res.`);
7
+ if (buffer.readUInt16LE(inicio) === 0xffff) {
8
+ if (inicio + 4 > fim)
9
+ throw new Error(`Cabeçalho de recurso inválido no offset ${inicio} do .res.`);
10
+ return { valor: buffer.readUInt16LE(inicio + 2), proximo: inicio + 4 };
11
+ }
12
+ for (let i = inicio; i + 2 <= fim; i += 2) {
13
+ if (buffer.readUInt16LE(i) === 0) {
14
+ return { valor: buffer.toString('utf16le', inicio, i), proximo: i + 2 };
15
+ }
16
+ }
17
+ throw new Error(`Cabeçalho de recurso inválido no offset ${inicio} do .res: nome sem terminador.`);
18
+ }
19
+ /**
20
+ * Lê um arquivo de recursos Win32 de 32 bits, ignorando a entrada vazia do início.
21
+ * Lança Error em pt-BR quando o arquivo está truncado ou tem cabeçalho inválido.
22
+ */
23
+ export function lerRes(buffer) {
24
+ const recursos = [];
25
+ let offset = 0;
26
+ while (offset < buffer.length) {
27
+ if (offset + 8 > buffer.length)
28
+ throw new Error(`Arquivo .res truncado no offset ${offset}.`);
29
+ const dataSize = buffer.readUInt32LE(offset);
30
+ const headerSize = buffer.readUInt32LE(offset + 4);
31
+ if (headerSize < 16) {
32
+ throw new Error(`Cabeçalho de recurso inválido no offset ${offset} do .res: HeaderSize ${headerSize}.`);
33
+ }
34
+ const fimCabecalho = offset + headerSize;
35
+ const fimDados = fimCabecalho + dataSize;
36
+ if (fimDados > buffer.length)
37
+ throw new Error(`Arquivo .res truncado no recurso do offset ${offset}.`);
38
+ const tipo = lerIdentificador(buffer, offset + 8, fimCabecalho);
39
+ const nome = lerIdentificador(buffer, tipo.proximo, fimCabecalho);
40
+ const vazia = offset === 0 && dataSize === 0 && tipo.valor === 0;
41
+ if (!vazia) {
42
+ recursos.push({ tipo: tipo.valor, nome: nome.valor, dados: Buffer.from(buffer.subarray(fimCabecalho, fimDados)) });
43
+ }
44
+ offset = alinhar4(fimDados);
45
+ }
46
+ return recursos;
47
+ }
@@ -8,6 +8,7 @@ import { COMMENTS_HOOK_PATH, hookProprioRegistrado } from '../comentarios/instal
8
8
  import { CONFIG_PATH, readConfig } from '../config/config.js';
9
9
  import { ARCHIVE_DIR_NAME, ARTIFACT_TYPES, listWorkFiles, readArtifact, validateAllWorks, WORKS_DIR } from '../contratos/artefatos.js';
10
10
  import { validateEventLog } from '../contratos/eventos.js';
11
+ import { classificarRes } from '../delphi/classificar.js';
11
12
  import { hashContent, LOCK_PATH, LOCK_VERSION } from '../install/lock.js';
12
13
  import { agentsForaDoLock, itemSources } from '../install/plan.js';
13
14
  import { hookCommands, SETTINGS_PATH } from '../install/settings.js';
@@ -253,6 +254,16 @@ function checkGitIgnore(root) {
253
254
  },
254
255
  ];
255
256
  }
257
+ function checkDelphiRes(root) {
258
+ return classificarRes(root)
259
+ .filter((res) => res.classe !== 'manter')
260
+ .map((res) => ({
261
+ id: 'delphi-res-versionado',
262
+ severidade: 'aviso',
263
+ mensagem: `${res.caminho} está versionado e é ${res.classe}: ${res.motivo}`,
264
+ correcao: 'Rode a etapa `/harness ignores` para classificar, extrair o ícone se preciso e tirar o .res do versionamento com aprovação.',
265
+ }));
266
+ }
256
267
  function checkWorks(root) {
257
268
  return validateAllWorks(root).map((problem) => ({
258
269
  id: `contrato-${problem.regra}`,
@@ -650,6 +661,7 @@ export function runDoctor(root, options = {}) {
650
661
  ...checkAgents(root),
651
662
  ...checkSettings(root),
652
663
  ...checkGitIgnore(root),
664
+ ...checkDelphiRes(root),
653
665
  ...checkConfig(configProblems),
654
666
  ...checkBanco(root, config),
655
667
  ...checkWorks(root),
@@ -36,7 +36,8 @@ export function extratorParaTexto(cfg) {
36
36
  function juntar(base, nome) {
37
37
  return base ? `${base}/${nome}` : nome;
38
38
  }
39
- function varrer(raiz, base, profundidade) {
39
+ /** Caminhos (com `/`, relativos à raiz) dos arquivos cujo nome casa com `casa`: os do nível antes das subpastas. */
40
+ export function varrerArquivos(raiz, base, profundidade, casa) {
40
41
  let entradas;
41
42
  try {
42
43
  entradas = readdirSync(join(raiz, base), { withFileTypes: true });
@@ -47,21 +48,26 @@ function varrer(raiz, base, profundidade) {
47
48
  entradas.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
48
49
  const achados = [];
49
50
  for (const e of entradas) {
50
- if (e.isFile()) {
51
- const candidato = CANDIDATOS.find((c) => c.casa.test(e.name));
52
- for (const extrator of candidato?.extratores ?? [])
53
- achados.push({ caminho: juntar(base, e.name), extrator });
54
- }
51
+ if (e.isFile() && casa.test(e.name))
52
+ achados.push(juntar(base, e.name));
55
53
  }
56
54
  if (profundidade > 0) {
57
55
  for (const e of entradas) {
58
56
  if (e.isDirectory() && !e.name.startsWith('.') && !PASTAS_IGNORADAS.has(e.name)) {
59
- achados.push(...varrer(raiz, juntar(base, e.name), profundidade - 1));
57
+ achados.push(...varrerArquivos(raiz, juntar(base, e.name), profundidade - 1, casa));
60
58
  }
61
59
  }
62
60
  }
63
61
  return achados;
64
62
  }
63
+ const CASA_CANDIDATO = new RegExp(CANDIDATOS.map((c) => `(?:${c.casa.source})`).join('|'), 'i');
64
+ function varrer(raiz, base, profundidade) {
65
+ return varrerArquivos(raiz, base, profundidade, CASA_CANDIDATO).flatMap((caminho) => {
66
+ const nome = caminho.slice(caminho.lastIndexOf('/') + 1);
67
+ const candidato = CANDIDATOS.find((c) => c.casa.test(nome));
68
+ return (candidato?.extratores ?? []).map((extrator) => ({ caminho, extrator }));
69
+ });
70
+ }
65
71
  function lerFontes(raiz, arquivos, problemas) {
66
72
  return arquivos.map((arquivo) => {
67
73
  const fonte = { caminho: arquivo.caminho, extrator: arquivo.extrator, ocorrencias: [] };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fontdata/ai-harness",
3
- "version": "4.1.1",
3
+ "version": "4.2.0",
4
4
  "description": "Harness de engenharia com IA da Fontdata para Claude Code: roda os slash commands direto na pasta do projeto via npx, sem instalar nada — ou instala-os em .claude/commands.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -33,6 +33,41 @@ Versão reforçada cobrindo as mesmas categorias. Se já existir, **reconcilie**
33
33
  que o projeto já tem. Mantenha versionados `.ai-harness/` e `.claude/`; o rastro em `docs/eventos/` fica fora do
34
34
  versionamento por padrão.
35
35
 
36
+ ## Stack Delphi
37
+
38
+ A stack é Delphi quando há `*.dproj` ou `*.dpr`; confirme com `npx @fontdata/ai-harness delphi classificar`. O
39
+ projeto é **novo** quando `delphi classificar` não lista nenhum `.res` rastreado, e **existente** quando lista algum.
40
+
41
+ **Projeto novo.** Inclua no `.gitignore` os padrões `*.res`, `*.dres`, `__history/`, `__recovery/`, `*.dcu`,
42
+ `*.local`, `*.identcache`, `*.stat`, `*.dsk`, as pastas `Win32/` e `Win64/` e o `Thumbs.db`. Um `.res` feito à mão
43
+ é o que não tem `.dpr` nem `.dproj` de mesmo nome na pasta: pergunte ao usuário se ele deve ser versionado e, com o
44
+ sim, acrescente a exceção `!caminho/Arquivo.res`.
45
+
46
+ **Projeto existente.** Antes de ignorar, rode `delphi classificar` e mostre a tabela ao usuário. Por classe:
47
+
48
+ - `regeravel`: sai do versionamento, porque a IDE o regera.
49
+ - `icone-so-no-res`: proponha `delphi extrair-icone <arquivo.res>`, que grava `<Projeto>_Icon.ico` ao lado do
50
+ `.res`, e troque no `.dproj` só os `Icon_MainIcon` próprios, deixando intactos os valores `$(BDS)\...`. Sem isso,
51
+ o executável perde o ícone.
52
+ - `manter`: continua versionado. Ocorre em projeto sem `.dproj` (Delphi antigo), em `.res` com recurso próprio que
53
+ a IDE não regera, em biblioteca de terceiros marcada `linguist-vendored` no `.gitattributes`, em pacote (`.dpk`)
54
+ e em `.res` ilegível.
55
+
56
+ Os demais padrões entram como no projeto novo. Um `.dres` já rastreado fica como está. A linha do `.res` no
57
+ `.gitignore` depende da tabela: com algum `manter`, o caminho exato de cada `.res` removido, para que um `.res` novo
58
+ com recurso próprio não seja ignorado sem ninguém perceber; sem nenhum `manter`, `*.res`.
59
+
60
+ **Remoção.** Faz parte do 🚦 da etapa: só depois da aprovação. Com o stage limpo, rode `git rm --cached <arquivo>`
61
+ de cada `.res` e depois `git commit` sem pathspec. Não use `git commit -- <caminho>`: com o arquivo ainda no disco,
62
+ ele readiciona ao índice o `.res` removido.
63
+
64
+ **Ícone.** Fica dentro da pasta do projeto, com caminho relativo no `.dproj`. Ao copiar o `.dproj` de outro projeto,
65
+ troque o ícone.
66
+
67
+ **Por quê.** O `.res` principal tem só VERSIONINFO, `MAINICON`, MANIFEST e `PLATFORMTARGETS`, e a IDE o regera a
68
+ partir do `.dproj`. Versionado, vira diff binário a cada bump de versão e conflito de merge. O `.dres` também é
69
+ gerado, a partir dos `RcItem` do `.dproj`; versionados ficam os arquivos de origem.
70
+
36
71
  ## Regras
37
72
 
38
73
  - Seja conservador: em caso de dúvida, exclua.