@fontdata/ai-harness 4.3.1 → 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 (55) 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/delphi/command.js +102 -1
  5. package/dist/delphi/encoding.js +112 -0
  6. package/dist/init.js +8 -2
  7. package/dist/install/perfis.js +14 -0
  8. package/dist/install/plan.js +29 -2
  9. package/dist/install/settings.js +40 -3
  10. package/dist/update/update.js +69 -7
  11. package/package.json +1 -1
  12. package/templates/catalog.json +3 -0
  13. package/templates/perfis/delphi/hooks/encoding.mjs +317 -0
  14. package/templates/perfis/delphi/rules/build-e-verificacao.md +59 -0
  15. package/templates/perfis/delphi/rules/dados/cnpj-alfanumerico-nao-extrair-so-numeros.md +65 -0
  16. package/templates/perfis/delphi/rules/dados/data-hora-sql-nunca-round-trip-textual.md +78 -0
  17. package/templates/perfis/delphi/rules/dados/datestyle-sessao-firedac-postgres.md +60 -0
  18. package/templates/perfis/delphi/rules/dados/ddl-tabela-nova-exige-trigger-de-log.md +68 -0
  19. package/templates/perfis/delphi/rules/dados/divisao-e-conversao-numerica.md +53 -0
  20. package/templates/perfis/delphi/rules/dados/fieldbyname-value-variant-cru-em-aritmetica.md +73 -0
  21. package/templates/perfis/delphi/rules/dados/filtro-condicional-sql-par-add-parambyname.md +72 -0
  22. package/templates/perfis/delphi/rules/dados/firedac.md +51 -0
  23. package/templates/perfis/delphi/rules/dados/macro-firedac-exige-entrada-macrodata.md +96 -0
  24. package/templates/perfis/delphi/rules/dados/sql-qualificacao-colunas.md +36 -0
  25. package/templates/perfis/delphi/rules/dados/tmeminifile-getstrings-nao-limpa-destino.md +89 -0
  26. package/templates/perfis/delphi/rules/encoding-eol.md +130 -0
  27. package/templates/perfis/delphi/rules/linguagem/dataset-nao-se-le-depois-do-laco-eof.md +56 -0
  28. package/templates/perfis/delphi/rules/linguagem/existencia-nunca-se-testa-por-campo-formatado.md +60 -0
  29. package/templates/perfis/delphi/rules/linguagem/float-nunca-comparado-por-igualdade-com-literal.md +55 -0
  30. package/templates/perfis/delphi/rules/linguagem/literal-enum-de-dfm-exige-unit-no-uses.md +84 -0
  31. package/templates/perfis/delphi/rules/linguagem/reaproveitar-funcao-existente-antes-de-criar.md +172 -0
  32. package/templates/perfis/delphi/rules/linguagem/sem-clipboard-debug.md +43 -0
  33. package/templates/perfis/delphi/rules/linguagem/validacao-em-onexit-nao-protege-a-gravacao.md +65 -0
  34. package/templates/perfis/delphi/rules/linguagem/variavel-inline-sai-de-escopo-ao-envolver-bloco.md +69 -0
  35. package/templates/perfis/delphi/rules/telas/foco-decisao-por-canfocus-nao-tabstop.md +40 -0
  36. package/templates/perfis/delphi/rules/telas/form-dinamico-liberar-em-toda-saida.md +80 -0
  37. package/templates/perfis/delphi/rules/telas/heranca-de-form-e-grade-de-selecao.md +58 -0
  38. package/templates/perfis/delphi/rules/threads-e-timers.md +131 -0
  39. package/templates/perfis/delphi/rules/try-finally-e-vazamento.md +109 -0
  40. package/templates/perfis/delphi/skills/conhecimento-delphi/SKILL.md +64 -0
  41. package/templates/perfis/delphi/skills/conhecimento-delphi/references/ATRIBUICAO.md +29 -0
  42. package/templates/perfis/delphi/skills/conhecimento-delphi/references/acbr-nfce-integracao.md +60 -0
  43. package/templates/perfis/delphi/skills/conhecimento-delphi/references/build-via-bat-com-log.md +86 -0
  44. package/templates/perfis/delphi/skills/conhecimento-delphi/references/class-var-vaza-para-campos-de-instancia.md +73 -0
  45. package/templates/perfis/delphi/skills/conhecimento-delphi/references/componentes-designer-vs-runtime.md +47 -0
  46. package/templates/perfis/delphi/skills/conhecimento-delphi/references/console-writeln-sem-flush-nao-loga.md +47 -0
  47. package/templates/perfis/delphi/skills/conhecimento-delphi/references/conversao-numerica-locale.md +47 -0
  48. package/templates/perfis/delphi/skills/conhecimento-delphi/references/delphi13-breaking-changes.md +41 -0
  49. package/templates/perfis/delphi/skills/conhecimento-delphi/references/dpr-uses-project-manager.md +62 -0
  50. package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-dcc-debuginformation-nao-booleano.md +78 -0
  51. package/templates/perfis/delphi/skills/conhecimento-delphi/references/dproj-projectguid-valido.md +38 -0
  52. package/templates/perfis/delphi/skills/conhecimento-delphi/references/firedac-registro-drivers.md +94 -0
  53. package/templates/perfis/delphi/skills/conhecimento-delphi/references/horse-gbswagger-rotas-jwt.md +61 -0
  54. package/templates/perfis/delphi/skills/conhecimento-delphi/references/msb6003-command-line-too-long.md +52 -0
  55. package/templates/perfis/delphi/skills/conhecimento-delphi/references/recursos-rcdata.md +67 -0
@@ -0,0 +1,94 @@
1
+ # Driver FireDAC não encontrado — "Object factory for class ... is missing"
2
+
3
+ ## Sintoma
4
+
5
+ Na primeira conexão ou consulta, em runtime:
6
+
7
+ ```
8
+ Object factory for class {3E9B315B-F456-4175-A864-B2573C4A2201} is missing.
9
+ To register it, you can drop component [TFDGUIxWaitCursor] into your project.
10
+ ```
11
+
12
+ O GUID varia; o que importa é o nome da classe na mensagem (`TFDGUIxWaitCursor`, `TFDPhysSQLiteDriverLink`,
13
+ `TFDStanJSONFile`...). No mobile com SQLite, a variante é:
14
+
15
+ ```
16
+ [FireDAC][Phys][SQLite]-314. Cannot load vendor library [libsqlite.so or libdb_sql.so].
17
+ dlopen failed: library "libdb_sql.so" not found
18
+ ```
19
+
20
+ ## Causa
21
+
22
+ O FireDAC separa drivers e UI em units que se registram no `initialization`. Se nenhuma unit da cadeia de `uses` as
23
+ referencia, o linker não as inclui e a classe não é registrada. Acontece em projetos sem DataModule (conexão criada
24
+ em código), porque quem arrasta o componente no Designer ganha as units e a instância de
25
+ graça.
26
+
27
+ Duas pegadinhas:
28
+
29
+ - **Registrar a classe não basta.** `FireDAC.ConsoleUI.Wait` só registra `TFDGUIxWaitCursor`; sem DataModule, é
30
+ preciso criar a **instância** do componente.
31
+ - **SQLite no Android/iOS exige linkagem estática:** `slDefault`/`slDynamic` tentam `dlopen` de uma biblioteca do
32
+ sistema que o app não alcança. O Designer grava `EngineLinkage = slStatic` no `.dfm`; em código, é preciso setar.
33
+
34
+ ## Correção
35
+
36
+ No `uses` de uma unit viva no projeto (normalmente a de conexão), incluir conforme o uso:
37
+
38
+ | Banco | Units |
39
+ |---|---|
40
+ | SQLite | `FireDAC.Phys.SQLite`, `FireDAC.Phys.SQLiteDef` (+ `FireDAC.Phys.SQLiteWrapper.Stat` no mobile) |
41
+ | MySQL/MariaDB | `FireDAC.Phys.MySQL`, `FireDAC.Phys.MySQLDef` |
42
+ | PostgreSQL | `FireDAC.Phys.PG`, `FireDAC.Phys.PGDef` |
43
+
44
+ | Tipo de aplicação | Unit de espera (escolha uma) |
45
+ |---|---|
46
+ | VCL | `FireDAC.VCLUI.Wait` |
47
+ | Console, serviço, mobile | `FireDAC.ConsoleUI.Wait` |
48
+ | FMX desktop | `FireDAC.ConsoleUI.Wait` ou `FireDAC.FMXUI.Wait` |
49
+
50
+ | Unit | Para quê |
51
+ |---|---|
52
+ | `FireDAC.DApt` | necessária para `Open`/`Fetch` de queries |
53
+ | `FireDAC.Stan.ExprFuncs` | funções de expressão em filtros locais |
54
+ | `FireDAC.Stan.JSONFile` / `FireDAC.Stan.StorageBin` | salvar/carregar dataset em JSON ou binário |
55
+
56
+ A unit de setup precisa ser referenciada antes de qualquer acesso a banco no boot (primeiras posições do `uses` do
57
+ `.dpr`). Em Delphi 10.3 e anteriores, `EngineLinkage := slStatic` se escreve `StaticLink := True`.
58
+
59
+ Outro GUID da mesma família: procure o nome da classe em `$(BDS)\source\data\firedac\`; a unit que a registra é a que
60
+ falta no `uses`.
61
+
62
+ ## Exemplo
63
+
64
+ Unit de setup sem DataModule:
65
+
66
+ ```pascal
67
+ unit App.Infra.FireDAC.Setup;
68
+
69
+ interface
70
+
71
+ implementation
72
+
73
+ uses
74
+ FireDAC.Phys.SQLite, FireDAC.Phys.SQLiteDef, FireDAC.Phys.SQLiteWrapper.Stat,
75
+ FireDAC.Stan.ExprFuncs, FireDAC.Stan.Intf, FireDAC.UI.Intf,
76
+ FireDAC.Comp.UI, FireDAC.ConsoleUI.Wait, FireDAC.DApt;
77
+
78
+ var
79
+ FWaitCursor: TFDGUIxWaitCursor;
80
+ FSQLiteDriver: TFDPhysSQLiteDriverLink;
81
+
82
+ initialization
83
+ FWaitCursor := TFDGUIxWaitCursor.Create(nil);
84
+ FWaitCursor.Provider := 'Console';
85
+ FWaitCursor.ScreenCursor := gcrNone;
86
+ FSQLiteDriver := TFDPhysSQLiteDriverLink.Create(nil);
87
+ FSQLiteDriver.EngineLinkage := slStatic;
88
+
89
+ finalization
90
+ FSQLiteDriver.Free;
91
+ FWaitCursor.Free;
92
+
93
+ end.
94
+ ```
@@ -0,0 +1,61 @@
1
+ # Horse + gbswagger + JWT: rota que muda, rota que some e 401 no Swagger
2
+
3
+ Para projetos Delphi com Horse que documentam rotas com `Horse.GBSwagger` e protegem com `Horse.JWT`. Superfície de
4
+ API confirmada no gbswagger 3.1.0; a versão instalada pelo Boss em `modules/` é a única verdade, leia a interface ali
5
+ antes de escrever código de memória.
6
+
7
+ ## Sintoma
8
+
9
+ 1. Depois de converter um controller para o padrão de classe gbswagger, o cliente (app mobile) passa a receber 404:
10
+ `/cargo` virou `/v1/cargo`.
11
+ 2. O projeto compila e sobe, mas as rotas anotadas **não existem**; o build só mostrou
12
+ `warning W1074: Unknown custom attribute`.
13
+ 3. A UI do Swagger devolve **401**, ou o banner do console anuncia uma URL que não abre.
14
+ 4. `E2003`/`E2066` em cascata no `.dpr` ao configurar `Swagger.Title(...)` ou `Horse.GBSwagger.Middleware`.
15
+
16
+ ## Causa
17
+
18
+ 1. A rota é `BasePath + SwagPath.Name + '/' + SwagEndPoint.Path` (`{id}` vira `:id`). `[SwagPath('Tag')]` (1
19
+ argumento) deixa `Name` vazio e a rota fica na raiz; `[SwagPath(C_Prefix, 'Tag')]` acrescenta o prefixo.
20
+ 2. Os atributos `SwagPath`, `SwagGET`, `SwagPOST`, `SwagPUT`, `SwagDELETE` estão em `GBSwagger.Path.Attributes`, que
21
+ `Horse.GBSwagger` não reexporta. Sem a unit, o atributo é ignorado com um simples warning.
22
+ 3. A UI fica em `/swagger/doc/html` e o JSON em `/swagger/doc/json`. `/swagger` não é rota: pular `'/swagger'` no
23
+ `SkipRoutes` não libera a UI.
24
+ 4. `Title` e `Description` vivem em `IGBSwaggerInfo` (acesso por `.Info`, fechado com `.&End`), e o middleware é a
25
+ função `HorseSwagger`.
26
+
27
+ Sobre a ordem do JWT: `THorse.Use(...)` **sem path** registra no nó raiz e roda para toda rota, registrada antes ou
28
+ depois. Controllers que se registram na `initialization` (`THorseGBSwaggerRegister.RegisterPath`) continuam
29
+ protegidos pelo `Use(HorseJWT(...))` global. A ordem só importa para `Use` com path específico. O cadeado do Swagger
30
+ é documental (endpoints não públicos ganham o cadeado automaticamente; `[SwagGET('rota', 'desc', True)]` deixa
31
+ público); a proteção real é o middleware.
32
+
33
+ ## Correção
34
+
35
+ - Ao converter controller que já atende na raiz, usar `[SwagPath('Tag')]` para preservar o caminho.
36
+ - `GBSwagger.Path.Attributes` no `uses` de todo controller anotado; tratar `W1074` como erro.
37
+ - `SkipRoutes` com `/swagger/doc/html` e `/swagger/doc/json`, e o banner anunciando `/swagger/doc/html`.
38
+ - Configuração pelo `.Info ... .&End` e `THorse.Use(HorseSwagger)`. `Version`, `BasePath`, `Host`, `AddSecurity`,
39
+ `AddBearerSecurity`, `Path` e `AddModel` ficam direto em `IGBSwagger`; `Swagger` é variável global da unit.
40
+
41
+ ## Exemplo
42
+
43
+ ```pascal
44
+ uses
45
+ Horse, Horse.GBSwagger, Horse.JWT, GBSwagger.Path.Attributes;
46
+
47
+ Swagger
48
+ .Info
49
+ .Title('MinhaApi')
50
+ .Description('API REST')
51
+ .Version('1.0.0')
52
+ .&End
53
+ .AddBearerSecurity;
54
+
55
+ THorse
56
+ .Use(HorseSwagger)
57
+ .Use(HorseJWT(LSegredo,
58
+ THorseJWTConfig.New.SkipRoutes(['/health', '/swagger/doc/html', '/swagger/doc/json'])));
59
+ ```
60
+
61
+ Banner que não aparece em saída redirecionada: `console-writeln-sem-flush-nao-loga.md`.
@@ -0,0 +1,52 @@
1
+ # `MSB6003` / `MSB6002` — linha de comando do compilador longa demais
2
+
3
+ ## Sintoma
4
+
5
+ O build pelo msbuild falha com:
6
+
7
+ ```
8
+ warning MSB6002: The command-line for the "DCC" task is too long. Command-lines longer than 32000 characters
9
+ error MSB6003: The specified task executable "dcc32.exe" could not be run. The filename or extension is too long
10
+ ```
11
+
12
+ (em português: "O nome do arquivo ou a extensão é muito grande"). Costuma compilar no IDE e falhar na linha de
13
+ comando, principalmente em Android64/iOS e em máquinas com muitas bibliotecas de terceiros instaladas.
14
+
15
+ ## Causa
16
+
17
+ O limite do `CreateProcess` do Windows é de cerca de 32.000 caracteres. `DCC_UnitSearchPath` inchado por bibliotecas
18
+ globais (TMS, ACBr, DevExpress...) e `DCC_UsePackage` expandido em flags de pacote fazem o comando do `dcc` passar
19
+ disso, às vezes de 50.000.
20
+
21
+ ## Correção
22
+
23
+ 1. **Preferida:** arquivo de resposta do compilador. Numa `PropertyGroup` base do `.dproj` (sem condição de
24
+ plataforma), acrescentar `DCC_ForceExecute`. O msbuild grava `<Projeto>.cmds` e passa só `@Projeto.cmds` ao `dcc`.
25
+ Não remove caminhos nem muda a estrutura do projeto.
26
+ 2. Se ainda estourar ou não der para mexer no `.dproj`:
27
+ - encurtar `DCC_UnitSearchPath`, tirando caminhos de bibliotecas que o projeto não usa;
28
+ - concentrar os `.dcu` pré-compilados das bibliotecas num único diretório e referenciar só ele;
29
+ - usar caminhos curtos ou mapear a raiz das bibliotecas num drive (`subst`);
30
+ - chamar o `dcc32`/`dcc64` direto com um `<Projeto>.cfg` na pasta do projeto, que não tem limite de tamanho. Os
31
+ caminhos relativos do `.cfg` são resolvidos a partir da pasta corrente, então o `.bat` precisa de `cd /d` para a
32
+ pasta do projeto antes.
33
+
34
+ ## Exemplo
35
+
36
+ ```xml
37
+ <PropertyGroup>
38
+ <DCC_ForceExecute>true</DCC_ForceExecute>
39
+ </PropertyGroup>
40
+ ```
41
+
42
+ Formato do `.cfg` (alternativa do item 2):
43
+
44
+ ```ini
45
+ -DDEBUG
46
+ -NSWinapi;System;Vcl;Data
47
+ -E".\bin"
48
+ -N0".\dcu"
49
+ -U"modules\horse\src"
50
+ ```
51
+
52
+ Quem compila no Windows encontra o modelo de `.bat` com log em `build-via-bat-com-log.md`.
@@ -0,0 +1,67 @@
1
+ # Recursos embutidos no executável (RCDATA / `.dres`)
2
+
3
+ Vale para VCL e FMX, em todas as plataformas. Serve para embutir SVG, JSON, imagens, templates e scripts e lê-los em
4
+ runtime com `TResourceStream`.
5
+
6
+ ## Sintoma
7
+
8
+ - `[DCC Error] E1026 File not found: 'MeuProjeto.dres'`
9
+ - `[DCC Error] E2606 Duplicate resource: type RCDATA ID <nome>`
10
+ - `Resource <id> not found` em runtime
11
+
12
+ ## Causa
13
+
14
+ | Erro | Causa |
15
+ |---|---|
16
+ | `E1026 ... .dres` | `{$R *.dres}` no `.dpr`, mas nenhum recurso cadastrado: sem recurso, o IDE não gera o `.dres`. Ou um `.rc` manual gerou o `.dres` com outro nome. |
17
+ | `E2606 Duplicate resource` | `{$R *.dres}` repetido no `.dpr`, ou o mesmo recurso cadastrado pelo diálogo e também num `.rc` manual. |
18
+ | `Resource not found` | tipo diferente de `RCDATA` (algumas versões sugerem `RC_DATA`), identificador com erro de digitação, ou binário compilado antes de cadastrar o recurso (faça **Build**, não só Compile). |
19
+
20
+ ## Correção
21
+
22
+ Usar o mecanismo oficial, **Project → Resources and Images...**:
23
+
24
+ 1. **Add...** e escolher o arquivo;
25
+ 2. **Resource identifier**: o nome usado no código (padronize em minúsculas, ex.: `svg_email`);
26
+ 3. **Resource type**: digitar `RCDATA` (sem underscore);
27
+ 4. **OK** grava `<Resource>` no `.dproj`; o build gera `<Projeto>.dres`, que não se edita à mão;
28
+ 5. no `.dpr`, uma única `{$R *.dres}`, ao lado de `{$R *.res}` (as duas coexistem: `.dres` é multiplataforma, `.res`
29
+ traz ícone e version info do Windows).
30
+
31
+ Evite `.rc` manual: o nome do `.dres` gerado muda entre versões do IDE. Se o projeto tem um `.rc` antigo e também
32
+ `<Resource>` no `.dproj`, o que vale é o `.dproj`; tire o `.rc` do Project Manager para não duplicar.
33
+
34
+ ## Exemplo
35
+
36
+ ```xml
37
+ <ItemGroup>
38
+ <Resource Include="imagens\svg\email.svg">
39
+ <ResourceType>RCDATA</ResourceType>
40
+ <ResourceId>svg_email</ResourceId>
41
+ </Resource>
42
+ </ItemGroup>
43
+ ```
44
+
45
+ ```pascal
46
+ function LerRecursoComoString(const ANome: string): string;
47
+ var
48
+ LRecurso: TResourceStream;
49
+ LTexto: TStringStream;
50
+ begin
51
+ LRecurso := TResourceStream.Create(HInstance, ANome, RT_RCDATA);
52
+ try
53
+ LTexto := TStringStream.Create('', TEncoding.UTF8);
54
+ try
55
+ LTexto.CopyFrom(LRecurso, 0);
56
+ Result := LTexto.DataString;
57
+ finally
58
+ LTexto.Free;
59
+ end;
60
+ finally
61
+ LRecurso.Free;
62
+ end;
63
+ end;
64
+ ```
65
+
66
+ O segundo parâmetro é o identificador cadastrado; o terceiro, `RT_RCDATA` (`Winapi.Windows` na VCL; também funciona
67
+ em FMX mobile).