@seedgrid/ai-toolkit 0.4.1 → 0.4.3

package/dist/adapters/shared.js

@@ -132,6 +132,7 @@ export function agentsMdBlock(bundle, targets, mode) {
         '',
         `Bloco gerenciado pelo \`seedgrid-ai\` (conteúdo ${bundle.contentVersion}, modo \`${mode}\`). Não edite entre os marcadores; personalize em \`.ai/local/\`.`,
         '',
+        ...(bundle.agentsNotes.length > 0 ? [...bundle.agentsNotes.map((n) => `> ${n}`), ''] : []),
         'Cada pasta de `.ai/` tem um `index.md` com o que há nela: comece por ele e leia só o que a tarefa pedir.',
         '',
         '- Regras: `.ai/rules/`. Antes de tarefas não triviais, leia `coordenacao.md`.',

package/dist/core/content.js

@@ -510,6 +510,10 @@ export async function loadContent(root) {
         checkBrain(ctx, brain.notes, brain.entrypoints, brain.base);
         shared.push(...brain.notes);
     }
+    const rawNotes = manifest.agentsNotes ?? [];
+    if (!Array.isArray(rawNotes) || rawNotes.length > 10 || rawNotes.some((n) => typeof n !== 'string' || n.trim() === '' || n.length > 600 || n.includes('\n'))) {
+        ctx.errors.push('manifest: agentsNotes deve ser uma lista de até 10 linhas de texto (até 600 caracteres, sem quebra de linha)');
+    }
     if (ctx.errors.length > 0) {
         throw new ToolkitError(`Conteúdo inválido em ${absRoot}`, ctx.errors);
     }
@@ -523,6 +527,7 @@ export async function loadContent(root) {
         brain: brain
             ? { notes: brain.notes.length, entrypoints: brain.entrypoints.map((e) => `.ai/brain/${brain.base}/${e}`) }
             : null,
+        agentsNotes: rawNotes,
         sourceFiles: [...ctx.sources].sort(),
     };
 }

package/docs/formato.md

@@ -87,6 +87,7 @@ Arquivos e pastas que começam com ponto são ignorados.
 | --- | --- |
 | `schemaVersion` | `2` (versão do formato do manifesto) |
 | `contentVersion` | semver; deve ser **igual** à versão do pacote (`package.json`); aumente a cada mudança de conteúdo |
+| `agentsNotes` | (opcional) até 10 linhas curtas que o bloco do `AGENTS.md` mostra no topo, como aviso (ex.: o modo de trabalho que uma camada adicional exige) |
 | `toolkitBase` | pasta do vault onde ficam `agents/`, `rules/`, `templates/`, `references/` e `skills/` (aqui, `SeedGrid/Toolkit`) |
 | `components[].id` | único; para skills, `skill:<name>` |
 | `components[].type` | `agents`, `rules`, `templates`, `references`, `skill` ou `brain` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seedgrid/ai-toolkit",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Instala agentes, skills, regras, templates e referências versionados em projetos locais para Claude Code e Codex.",
   "type": "module",
   "license": "MIT",

package/seedgridKB/SeedGrid/Extensions/Catalogo-de-propriedades.md

@@ -479,7 +479,7 @@ Tabela geral de **todas as propriedades públicas** de configuração documentad
 | `seedgrid.subdomain-tenancy.master.entity-packages` | Datasource master | `Optional<String>` | MPC: vazio (env `SEEDGRID_SUBDOMAIN_TENANCY_MASTER_ENTITY_PACKAGES`) | build (via expansão — Inferência) | Prefixada em quarkus.hibernate-orm.master.packages=${…master.entity-packages},br.com.seedgrid.subdomaintenancy.entities… | [[SeedGrid/Extensions/subdomain-tenancy/Configuracao\|subdomain-tenancy/Configuracao]] |
 | `seedgrid.subdomain-tenancy.master.migrations.location.additional` | Datasource master | `Optional<String>` (CSV) | MPC: vazio | runtime | Anexadas à base classpath:db/migration/master no mesmo history flyway_schema_history_master; versões precisam ser… | [[SeedGrid/Extensions/subdomain-tenancy/Configuracao\|subdomain-tenancy/Configuracao]] |
 | `database.master.subdomain` | Datasource master | `Optional<String>` | MPC: `${PRODUCT_PREFIX:app}` | runtime | Nenhum código da extension a lê (DatabaseMasterConfig não é injetado); é um valor auxiliar publicado para o host… | [[SeedGrid/Extensions/subdomain-tenancy/Configuracao\|subdomain-tenancy/Configuracao]] |
-| `database.master.name` | Datasource master | `Optional<String>` | MPC: `${database.master.subdomain}_master` | runtime | Valor auxiliar para expressões do host; ex. real em java/seedgrid-test-multitenancy/src/main/resources/application.prop… | [[SeedGrid/Extensions/subdomain-tenancy/Configuracao\|subdomain-tenancy/Configuracao]] |
+| `database.master.name` | Datasource master | `Optional<String>` | MPC: `${database.master.subdomain}_master` | runtime | Valor auxiliar para expressões do host; usado em expressões `${database.master.name}` do `application.properties` do host | [[SeedGrid/Extensions/subdomain-tenancy/Configuracao\|subdomain-tenancy/Configuracao]] |
 | `seedgrid.subdomain-tenancy.tenant.datasource.jdbc.url` | Datasource dos tenants (pool, cache e limite) | `Optional<String>` | `—` (sem `url` nem `url-pattern`: `jdbc:postgresql://localhost:5439/{tenant}`) | runtime | getEffectiveUrlPattern() remove / final e acrescenta /{tenant}; {tenant} vira o nome do banco (<prefix>_<tenant>) | [[SeedGrid/Extensions/subdomain-tenancy/Configuracao\|subdomain-tenancy/Configuracao]] |
 | `seedgrid.subdomain-tenancy.tenant.datasource.jdbc.url-pattern` | Datasource dos tenants (pool, cache e limite) | `Optional<String>` | `—` | runtime | Se não-vazia, usada como está (Javadoc: compatibilidade/legado) | [[SeedGrid/Extensions/subdomain-tenancy/Configuracao\|subdomain-tenancy/Configuracao]] |
 | `seedgrid.subdomain-tenancy.tenant.datasource.username` | Datasource dos tenants (pool, cache e limite) | `Optional<String>` | `—` no MPC; fallback `postgres` no código | runtime | Usuário de todos os bancos de tenant; também usado como OWNER no CREATE DATABASE (provisionamento) | [[SeedGrid/Extensions/subdomain-tenancy/Configuracao\|subdomain-tenancy/Configuracao]] |

package/seedgridKB/SeedGrid/Extensions/Indice.md

@@ -61,4 +61,4 @@ Contagens de propriedades por extension e plataforma: [[SeedGrid/Extensions/Cata
 
 ## Não documentados como extension
 
-`seedgrid-parent` (POM pai), `seedgrid-cli`, `seedgrid-components-mcp`, `seedgrid-test-multitenancy` e `java/examples/*`: ver [[SeedGrid/Mapa-dos-repositorios|Mapa dos repositórios]].
+`seedgrid-parent` (POM pai), `seedgrid-cli`, `seedgrid-components-mcp` e `java/examples/*`: ver [[SeedGrid/Mapa-dos-repositorios|Mapa dos repositórios]].

package/seedgridKB/SeedGrid/Extensions/subdomain-tenancy/Configuracao.md

@@ -60,7 +60,7 @@ Visão geral: [[SeedGrid/Extensions/subdomain-tenancy/Visao-geral|Visão geral d
 | `seedgrid.subdomain-tenancy.master.entity-packages` | `Optional<String>` | pacotes Java (CSV) | MPC: vazio (env `SEEDGRID_SUBDOMAIN_TENANCY_MASTER_ENTITY_PACKAGES`) | Não | Prefixada em `quarkus.hibernate-orm.master.packages=${…master.entity-packages},br.com.seedgrid.subdomaintenancy.entities,br.com.seedgrid.billing.entities,br.com.seedgrid.security.entities` | PU `master` | Se o host redefinir `quarkus.hibernate-orm.master.packages` (como o exemplo), esta chave só vale se ele a reutilizar | build (via expansão — Inferência) | Decl.: `SubdomainTenancyBridgeConfig.Master#entityPackages()`, `MPC` |
 | `seedgrid.subdomain-tenancy.master.migrations.location.additional` | `Optional<String>` (CSV) | locations Flyway, ex. `classpath:db/migration/master-extra` | MPC: vazio | Não | Anexadas à base `classpath:db/migration/master` no mesmo history `flyway_schema_history_master`; versões precisam ser distintas da base | `Migrations#migrateMasterSchema` (startup) | Mesmo history → colisão de versão falha o Flyway | runtime | Decl.: `SubdomainTenancyBridgeConfig.Migrations#locationAdditional()` (`@WithName("location.additional")`), `SubdomainTenancyConfig#masterMigrationsLocationAdditional`, `MPC`. Consumo: `RT/flyway/Migrations` (construtor) |
 | `database.master.subdomain` | `Optional<String>` | texto | MPC: `${PRODUCT_PREFIX:app}` | Não | Nenhum código da extension a lê (`DatabaseMasterConfig` não é injetado); é um valor auxiliar publicado para o host referenciar em expressões | Expressões `${database.master.subdomain}` no host | Lê a env `PRODUCT_PREFIX`; base de `database.master.name` | runtime | Decl.: `RT/configs/DatabaseMasterConfig#subdomain()`, `MPC` |
-| `database.master.name` | `Optional<String>` | texto | MPC: `${database.master.subdomain}_master` | Não | Valor auxiliar para expressões do host; ex. real em `java/seedgrid-test-multitenancy/src/main/resources/application.properties`: `…master.datasource.jdbc.url=${SEEDGRID_SUBDOMAIN_TENANCY_MASTER_DB_URL:jdbc:postgresql://localhost:5439/${database.master.name}}` | Expressões do host | `database.master.subdomain` | runtime | Decl.: `RT/configs/DatabaseMasterConfig#name()`, `MPC` |
+| `database.master.name` | `Optional<String>` | texto | MPC: `${database.master.subdomain}_master` | Não | Valor auxiliar para expressões do host; ex.: `…master.datasource.jdbc.url=${SEEDGRID_SUBDOMAIN_TENANCY_MASTER_DB_URL:jdbc:postgresql://localhost:5439/${database.master.name}}` | Expressões do host | `database.master.subdomain` | runtime | Decl.: `RT/configs/DatabaseMasterConfig#name()`, `MPC` |
 
 ### 2.3 Datasource dos tenants (pool, cache e limite)
 

package/seedgridKB/SeedGrid/Extensions/subdomain-tenancy/Exemplos.md

@@ -10,7 +10,7 @@ analisado-em: 2026-10-14
 
 Visão geral: [[SeedGrid/Extensions/subdomain-tenancy/Visao-geral|Visão geral do subdomain-tenancy]] · Catálogo de propriedades: [[SeedGrid/Extensions/subdomain-tenancy/Configuracao|Configuração do subdomain-tenancy]] · [[SeedGrid/Extensions/subdomain-tenancy/Rust|Porte Rust]]
 
-Fontes: app de exemplo `java/examples/seedgrid-subdomain-tenancy-example` (repositório git próprio, commit `cd83edd` — fora da tabela de commits da análise), `README.md` da extension e o código do runtime (commit `fe62530a29`). Outro consumidor no monorepo: `java/seedgrid-test-multitenancy`.
+Fontes: app de exemplo `java/examples/seedgrid-subdomain-tenancy-example` (repositório git próprio, commit `cd83edd` — fora da tabela de commits da análise), `README.md` da extension e o código do runtime (commit `fe62530a29`).
 
 ## 1. Dependência
 

package/seedgridKB/SeedGrid/Mapa-dos-repositorios.md

@@ -36,7 +36,6 @@ Estado na análise (2026-10-14): todos na branch `main` e **sem alterações loc
 | `seedgrid-quarkus-lib-commons` | Library | 2026.10.08 | `fa49c344db` | 2026-10-08 | [[SeedGrid/Extensions/commons/Visao-geral\|commons]] |
 | `seedgrid-quarkus-lib-filemanagement` | Library | 2026.07.08 | `35c89c7cf7` | 2026-07-20 | [[SeedGrid/Extensions/filemanagement/Visao-geral\|filemanagement]] |
 | `seedgrid-quarkus-lib-privacy` | Library | 2026.07.27 | `79f8b03eeb` | 2026-09-25 | [[SeedGrid/Extensions/privacy/Visao-geral\|privacy]] |
-| `seedgrid-test-multitenancy` | App Quarkus de teste/integração | — | `21c70b4254` | 2026-10-13 | não documentado em detalhe |
 | `seedgrid-cli` | CLI em **Rust** (apesar de estar em `java/`) que gera apps Next.js com módulos `@seedgrid/fe-*` | — | `d3184afc84` | 2026-07-20 | não documentado em detalhe |
 | `seedgrid-components-mcp` | Servidor MCP (TypeScript) que expõe o catálogo de componentes | — | `69fe6a1cf8` | 2026-09-17 | não documentado em detalhe |
 | `examples/*` (12 apps) | Apps de exemplo, cada um com `.git` próprio | — | não registrados | — | usados como fonte de exemplos |

package/seedgridKB/SeedGrid/Toolkit/rules/documentos.md

@@ -5,6 +5,8 @@ description: "Onde salvar os documentos que a IA gera (planos, handoff, decisõe
 
 Todo documento de trabalho que a IA produzir (plano, handoff, decisão, especificação, relatório, análise, anotações de sessão) é salvo em **`docs/ai/<tipo>/`** do projeto: uma pasta fixa, visível e **versionada**. Nunca na raiz do projeto, em outra pasta de `docs/` nem dentro de `.ai/`, que o toolkit gerencia e reescreve no `update`.
 
+**Exceção — modo de trabalho avisado no `AGENTS.md`:** se o bloco do `AGENTS.md` trouxer um aviso de modo (por exemplo `MODO PLATAFORMA`, do `seedgrid-ai-plt`) que define outro lugar para planos, handoffs, relatórios e ADR, siga o aviso; o que está abaixo vale para projeto host.
+
 **Não crie arquivo `.md` fora de `docs/ai/`**, exceto o que o pedido nomeou (por exemplo um README) e os documentos permanentes do próprio projeto. Rascunho e saída de comando não são documentos: não os grave no projeto.
 
 ## Pastas por tipo

package/seedgridKB/manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 2,
-  "contentVersion": "0.4.1",
+  "contentVersion": "0.4.3",
   "toolkitBase": "SeedGrid/Toolkit",
   "components": [
     {