@seedgrid/ai-toolkit 0.4.1 → 0.4.2

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.2",
   "description": "Instala agentes, skills, regras, templates e referências versionados em projetos locais para Claude Code e Codex.",
   "type": "module",
   "license": "MIT",

package/seedgridKB/manifest.json

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