@pathbit/agentdevkit 0.0.5 → 0.0.7

package/.pbai4devs/README.md

@@ -33,10 +33,13 @@ Somente `SKILL.md`, `AGENT.md`, `COMMAND.md` e `RULE.md` em suas pastas
 têm apontamentos nas ferramentas. A origem é agrupada; os destinos usam o
 layout registrado. Veja a [compatibilidade](COMPATIBILIDADE.md) dos clientes.
 Recursos auxiliares e guias ficam exclusivamente em `.pbai4devs`.
+A licença do kit fica em `LICENSE` dentro deste hub após `init` ou `update`.
+Ela vem do pacote e não substitui a licença do projeto consumidor.
 Os testes das automações ficam em `scripts/<nome>/tests/`; seus resultados são
 ignorados em `.agent-tests/`.
 O `.gitignore` desta pasta controla sua árvore. As saídas nos clientes são
-protegidas por regras locais geradas dos [modelos](templates/gitignore/TEMPLATE.md).
+protegidas por regras locais geradas dos
+[modelos](templates/gitignore/TEMPLATE.md).
 Um `.gitignore` não consegue ignorar irmãos com `../`; o gerador usa o local
 correto do Git e preserva configurações humanas.
 Os modelos acompanham cada fase. Após implementar, use `atualizar-documentacao`

package/.pbai4devs/scripts/lib/gitignore.mjs

@@ -114,6 +114,52 @@ function rootProbes(root, roots) {
   return roots.filter(path => { const item = localStat(join(root, path)); return !item || item.isDirectory(); }).map(path => `${path}/.agentdevkit-ignore-probe`);
 }
 
+function artifactPolicy(templateFile) {
+  const adjacent = join(dirname(templateFile), 'agents.ignore');
+  const source = checkedLocalPath(localStat(adjacent) ? adjacent : fileURLToPath(new URL('../../templates/gitignore/agents.ignore', import.meta.url)));
+  const content = readFileSync(source, 'utf8');
+  const section = content.split(/^## Resultados e arquivos temporarios\r?$/m)[1]?.split(/^## /m)[0];
+  const patterns = section?.split(/\r?\n/).map(line => line.trim()).filter(line => line && !line.startsWith('#'));
+  if (!patterns?.length || patterns.some(pattern => !pattern.startsWith('**/') || /[!\\\x00-\x1f]/.test(pattern) || pattern.split('/').includes('..'))) throw new Error('Secao de artefatos invalida em agents.ignore.');
+  return patterns;
+}
+
+function artifactProbes(root, patterns) {
+  const probes = new Set();
+  for (const pattern of patterns) {
+    const stem = pattern.slice(3).replace(/\/$/, '').replace(/\[([^\]]+)\]/g, (_match, letters) => letters[0]).replace(/\?/g, 'x');
+    const names = stem.includes('*') ? ['', '-mcp', '-report', '-cache', '-agentdevkit'].map(suffix => stem.replace(/\*/g, suffix)) : [stem];
+    for (const name of names) for (const variant of new Set([name, name.toLowerCase()])) {
+      const leaves = stem.includes('*') ? ['.agentdevkit-artifact-probe', '.cache/.agentdevkit-artifact-probe'] : ['.agentdevkit-artifact-probe'];
+      for (const leaf of leaves) for (const path of [`${variant}/${leaf}`, `.agentdevkit-ignore-probes/${variant}/${leaf}`]) {
+        let parent = root, safe = true;
+        for (const part of path.split('/').slice(0, -1)) {
+          parent = join(parent, part); const item = localStat(parent);
+          if (item && !item.isDirectory()) { safe = false; break; }
+        }
+        if (safe) probes.add(path);
+      }
+    }
+  }
+  return [...probes];
+}
+
+function localIgnoreSource(location, source) {
+  const path = resolve(location.top, source);
+  if (path === location.exclude) return true;
+  const inside = relative(location.top, path);
+  return basename(path) === '.gitignore' && !isAbsolute(inside) && inside !== '..' && !inside.startsWith(`..${sep}`);
+}
+
+function ignoreMatches(location, probes) {
+  const paths = probes.map(path => location.prefix ? `${location.prefix}/${path}` : path);
+  const result = gitCommand(location.top, ['-c', 'core.excludesFile=', 'check-ignore', '--verbose', '--no-index', '--stdin', '-z'], paths.join('\0') + '\0');
+  if (result.error || ![0, 1].includes(result.status)) throw new Error(result.error?.message || result.stderr || 'Falha ao conferir exclusoes Git.');
+  const values = result.stdout.split('\0'), matches = new Map();
+  for (let index = 0; index + 3 < values.length; index += 4) matches.set(values[index + 3], { source: values[index], line: Number(values[index + 1]), pattern: values[index + 2] });
+  return { paths, matches };
+}
+
 function localRoot(value) {
   const missing = []; let parent = resolve(value);
   while (!localStat(parent)) { missing.unshift(parent.slice(dirname(parent).length + 1)); parent = dirname(parent); }
@@ -128,6 +174,7 @@ export function planLocalIgnore(root, { outputs = [], templateRoot } = {}) {
   const localTemplate = join(root, '.pbai4devs/templates/gitignore/local.ignore');
   const templateFile = checkedLocalPath(templateRoot ? join(templateRoot, '.pbai4devs/templates/gitignore/local.ignore') : localStat(localTemplate) ? localTemplate : fileURLToPath(new URL('../../templates/gitignore/local.ignore', import.meta.url)));
   const template = readFileSync(templateFile, 'utf8');
+  const artifacts = artifactPolicy(templateFile);
   if (template.split('{{OUTPUTS}}').length !== 2) throw new Error('local.ignore exige um unico {{OUTPUTS}}.');
   if (template.split('{{ROOTS}}').length > 2) throw new Error('local.ignore permite um unico {{ROOTS}}.');
   const localPolicy = join(templateRoot || root, '.pbai4devs/templates/clients/ADAPTERS.json');
@@ -152,16 +199,18 @@ export function planLocalIgnore(root, { outputs = [], templateRoot } = {}) {
   }
   const id = createHash('sha256').update(root).digest('hex').slice(0, 16);
   const first = `# BEGIN AGENTDEVKIT LOCAL ${id}`, last = `# END AGENTDEVKIT LOCAL ${id}`;
-  const fixed = template.replace('{{ROOTS}}', roots.map(path => `/${path}/`).join('\n')).replace('{{OUTPUTS}}', paths.filter(path => !roots.some(root => path === root || path.startsWith(root + '/'))).map(path => `/${escapePattern(path)}`).join('\n'));
+  const fixed = template.replace('{{ROOTS}}', roots.map(path => `/${path}/`).join('\n')).replace('{{OUTPUTS}}', paths.filter(path => !roots.some(root => path === root || path.startsWith(root + '/'))).map(path => `/${escapePattern(path)}`).join('\n'))
+    + '\n# Resultados e arquivos temporarios\n' + artifacts.map(pattern => `/${pattern}`).join('\n') + '\n';
   const body = fixed.split(/\r?\n/).map(line => location?.prefix && line.startsWith('/') ? `/${escapePattern(location.prefix)}${line}` : line).join('\n');
   const target = location?.exclude ?? checkedLocalPath(join(root, '.gitignore'));
   const before = localRead(target), after = localBlock(before, first, last, body);
   const edits = before === after ? [] : [{ path: target, before, after }];
   const probes = [...paths, ...rootProbes(root, roots)];
+  const artifactPaths = artifactProbes(root, artifacts);
   const wanted = new Set(probes.map(path => location?.prefix ? `${location.prefix}/${path}` : path));
   if (location && !before?.includes(first) && !localRead(join(root, '.gitignore'))?.includes(first)) {
-    const ignored = gitCommand(location.top, ['check-ignore', '--no-index', '--stdin', '-z'], [...wanted].join('\0') + '\0');
-    if (!ignored.error && [0, 1].includes(ignored.status) && ignored.stdout.split('\0').filter(Boolean).length === wanted.size) edits.length = 0;
+    const ignored = ignoreMatches(location, [...probes, ...artifactPaths]);
+    if (ignored.paths.every(path => { const match = ignored.matches.get(path); return match && !match.pattern.startsWith('!') && localIgnoreSource(location, match.source); })) edits.length = 0;
   }
   if (location) {
     const fallback = checkedLocalPath(join(root, '.gitignore'));
@@ -169,7 +218,7 @@ export function planLocalIgnore(root, { outputs = [], templateRoot } = {}) {
     if (old !== null && old !== next) edits.push({ path: fallback, before: old, after: next });
   }
   const tracked = location ? gitCommand(location.top, ['ls-files', '-z']).stdout.split('\0').filter(path => wanted.has(path)).map(path => location.prefix ? path.slice(location.prefix.length + 1) : path) : [];
-  return { root, status: location ? 'git' : 'fallback', location, paths, roots, edits, trackedOutputs: tracked, first, last };
+  return { root, status: location ? 'git' : 'fallback', location, paths, roots, artifactProbes: artifactPaths, edits, trackedOutputs: tracked, first, last };
 }
 
 export function checkLocalIgnore(plan, { replacedBlocks = [] } = {}) {
@@ -185,19 +234,16 @@ export function checkLocalIgnore(plan, { replacedBlocks = [] } = {}) {
     if (createHash('sha256').update(block).digest('hex') !== item.sha256) throw new Error('Bloco de ignore mudou antes da verificacao.');
     return { ...item, path };
   });
-  if (plan.location && plan.paths.length) {
-    const probes = [...plan.paths, ...rootProbes(plan.root, plan.roots || [])];
-    const relativePaths = probes.map(path => plan.location.prefix ? `${plan.location.prefix}/${path}` : path);
-    const result = gitCommand(plan.location.top, ['check-ignore', '--verbose', '--no-index', '--stdin', '-z'], relativePaths.join('\0') + '\0');
-    if (result.error || ![0, 1].includes(result.status)) throw new Error(result.error?.message || result.stderr || 'Falha ao conferir exclusoes Git.');
-    const values = result.stdout.split('\0'), matches = new Map();
-    for (let index = 0; index + 3 < values.length; index += 4) matches.set(values[index + 3], { source: values[index], line: Number(values[index + 1]), pattern: values[index + 2] });
+  if (plan.location && (plan.paths.length || plan.artifactProbes?.length)) {
+    const probes = [...plan.paths, ...rootProbes(plan.root, plan.roots || []), ...(plan.artifactProbes || [])];
+    const { paths: relativePaths, matches } = ignoreMatches(plan.location, probes);
     for (let index = 0; index < relativePaths.length; index++) {
       const match = matches.get(relativePaths[index]);
       const negative = match?.pattern.startsWith('!');
-      const humanOverride = negative && /(?:^|[\\/])\.gitignore$/.test(match.source);
+      const local = match && localIgnoreSource(plan.location, match.source);
+      const humanOverride = negative && local && /(?:^|[\\/])\.gitignore$/.test(match.source);
       const replaced = negative && replacements.some(item => item.path === canonicalExisting(resolve(plan.location.top, match.source)) && match.line >= item.firstLine && match.line <= item.lastLine);
-      if (!replaced && ((!plan.edits.length && (!match || negative)) || humanOverride)) missing.push(probes[index]);
+      if (!replaced && ((!plan.edits.length && (!match || negative || !local)) || humanOverride)) missing.push(probes[index]);
     }
   }
   return { ok: plan.edits.length === 0 && missing.length === 0 && plan.trackedOutputs.length === 0, status: plan.status, missing, trackedOutputs: plan.trackedOutputs, changed: plan.edits.length };
@@ -212,6 +258,8 @@ export function assertLocalIgnoreUnchanged(plan) {
 
 export function applyLocalIgnore(plan) {
   assertLocalIgnoreUnchanged(plan);
+  const before = checkLocalIgnore(plan);
+  if (before.missing.length) throw new Error(`Regras humanas reabrem derivados locais: ${before.missing.join(', ')}`);
   const written = [];
   try {
     for (const edit of plan.edits) {

package/.pbai4devs/scripts/sincronizar-agentes/tests/LOCAL_IGNORE.mjs

@@ -129,6 +129,72 @@ test('raízes dedicadas são locais, enquanto configurações de GitHub e VS Cod
   assert.ok(tracked.includes('.github/settings.json')); assert.ok(tracked.includes('.vscode/settings.json'));
 });
 
+test('artefatos vêm da política compartilhada e não entram na lista de outputs', t => {
+  const root = fixture(t); git(root, ['init', '-q']);
+  put(root, '.agent-tests/human.txt', 'evidência humana'); git(root, ['add', '-f', '.agent-tests/human.txt']);
+  const plan = planLocalIgnore(root, { outputs: ['AGENTS.md'] });
+  assert.ok(plan.artifactProbes.some(path => path.startsWith('.agent-tests/')));
+  assert.ok(plan.artifactProbes.some(path => path.startsWith('.agentdevkit-ignore-probes/')));
+  assert.ok(plan.paths.every(path => !plan.artifactProbes.includes(path)));
+  assert.ok(!plan.trackedOutputs.includes('.agent-tests/human.txt'));
+  applyLocalIgnore(plan);
+  for (const path of ['.agent-tests/x', 'TMP/x', 'nested/TeMp/x', '.PlAyWrIgHt-McP/x', 'nested/playwright-report/x', 'TEST-RESULTS/x', 'nested/TestResults/x', 'BLOB-REPORT/x']) {
+    assert.equal(git(root, ['check-ignore', '--no-index', path]).trim(), path);
+  }
+  assert.equal(git(root, ['ls-files', '.agent-tests/human.txt']).trim(), '.agent-tests/human.txt');
+  assert.equal(readFileSync(join(root, '.agent-tests/human.txt'), 'utf8'), 'evidência humana');
+  assert.equal(checkLocalIgnore(planLocalIgnore(root, { outputs: ['AGENTS.md'] })).ok, true);
+});
+
+test('regras de artefatos são limitadas ao projeto dentro do monorepo', t => {
+  const root = fixture(t); git(root, ['init', '-q']);
+  const child = join(root, 'apps', 'my project'); mkdirSync(child, { recursive: true });
+  applyLocalIgnore(planLocalIgnore(child, { outputs: ['AGENTS.md'] }));
+  for (const path of ['apps/my project/.agent-tests/x', 'apps/my project/nested/.Playwright-MCP/x', 'apps/my project/sub/test-results/x']) {
+    assert.equal(git(root, ['check-ignore', '--no-index', path]).trim(), path);
+  }
+  for (const path of ['apps/other/.agent-tests/x', 'apps/other/tmp/x', '.agent-tests/x']) {
+    const result = spawnSync('git', ['-C', root, 'check-ignore', '--no-index', path], { encoding: 'utf8' });
+    assert.equal(result.status, 1, path + result.stderr);
+  }
+});
+
+test('ignore global não mascara a ausência das regras locais de artefatos', t => {
+  const root = fixture(t), outside = fixture(t); git(root, ['init', '-q']);
+  put(outside, 'global.ignore', '*\n');
+  git(root, ['config', 'core.excludesFile', join(outside, 'global.ignore')]);
+  const plan = planLocalIgnore(root, { outputs: ['AGENTS.md'] });
+  assert.equal(plan.edits.length, 1);
+  const missing = checkLocalIgnore({ ...plan, edits: [] });
+  assert.ok(missing.missing.some(path => path.startsWith('.agent-tests/')));
+  applyLocalIgnore(plan);
+  assert.equal(checkLocalIgnore(planLocalIgnore(root, { outputs: ['AGENTS.md'] })).ok, true);
+});
+
+test('negação humana de artefatos bloqueia aplicação sem modificar regras ou índice', t => {
+  const root = fixture(t); git(root, ['init', '-q']);
+  const human = '!/.agent-tests/**\n'; put(root, '.gitignore', human);
+  const exclude = readFileSync(join(root, '.git/info/exclude'));
+  const plan = planLocalIgnore(root, { outputs: ['AGENTS.md'] });
+  assert.ok(checkLocalIgnore(plan).missing.some(path => path.startsWith('.agent-tests/')));
+  assert.throws(() => applyLocalIgnore(plan), /Regras humanas/);
+  assert.deepEqual(readFileSync(join(root, '.git/info/exclude')), exclude);
+  assert.equal(readFileSync(join(root, '.gitignore'), 'utf8'), human);
+});
+
+test('probes reconhecem exceções humanas para nomes reais de Playwright', async t => {
+  for (const path of ['.playwright-mcp', 'playwright-report', 'playwright/.cache']) await t.test(path, subtest => {
+    const root = fixture(subtest); git(root, ['init', '-q']);
+    const prefixes = path.split('/').map((_part, index, parts) => '!/' + parts.slice(0, index + 1).join('/') + '/');
+    const human = [...prefixes, `!/${path}/**`, ''].join('\n'); put(root, '.gitignore', human);
+    const before = readFileSync(join(root, '.git/info/exclude'));
+    const plan = planLocalIgnore(root, { outputs: ['AGENTS.md'] });
+    assert.ok(checkLocalIgnore(plan).missing.some(probe => probe.startsWith(path + '/')));
+    assert.throws(() => applyLocalIgnore(plan), /Regras humanas/);
+    assert.deepEqual(readFileSync(join(root, '.git/info/exclude')), before);
+  });
+});
+
 test('milhares de caminhos usam stdin e não ampliam metadata de área já ignorada', t => {
   const root = fixture(t); git(root, ['init', '-q']); put(root, '.gitignore', '/ignored/\n');
   const before = readFileSync(join(root, '.git/info/exclude'), 'utf8');

package/CHANGELOG.md

@@ -4,6 +4,20 @@ description: Alterações verificáveis por versão do AgentDevKit.
 
 # Changelog
 
+## 0.0.7 — 2026-11-11
+
+- Artefatos de testes e pastas temporárias protegidos em projetos existentes.
+- Regras locais respeitam o escopo do projeto e as exceções do usuário.
+- Teste opt-in em clones reais, com commits fixos e comparação de arquivos.
+- Relato explícito de bloqueios por links simbólicos preexistentes.
+
+## 0.0.6 — 2026-11-11
+
+- Metadados npm com autoria PathBit, palavras-chave e licença MIT.
+- README público sem frontmatter, com links absolutos para o GitHub.
+- Licença canônica instalada no hub, preservando a licença do consumidor.
+- Verificação de versão estável, consumo anônimo e atualização do router.
+
 ## 0.0.5 — 2026-11-11
 
 - Documentação organizada em guias, produto e manutenção, com índices próprios.

package/README.en.md

@@ -7,6 +7,8 @@ language: en
 
 [Português](README.md) · [Español](README.es.md) · [npm package][npm-package]
 
+[![npm][npm-badge]][npm-package] [![MIT][license-badge]](LICENSE)
+
 Organize work with coding agents, from planning to verification. Keep skills,
 rules, commands and agent profiles in `.pbai4devs`; the kit generates the
 references each client can discover. Code lives in `src/`, product tests in
@@ -32,7 +34,7 @@ Then open the project in your coding agent and ask:
 
 See [installation](docs/guides/installation.md) for Windows, missing Node, previews
 and updates. Install and update through the [public npm package][packages]; the
-[v0.0.5 release][release] retains artifacts and checksums for verification.
+[v0.0.7 release][release] retains artifacts and checksums for verification.
 No global installation is required.
 The CLI supports `pt`, `en` and `es`; it saves your selection per project.
 
@@ -60,7 +62,14 @@ tools are installed separately. Product documents follow your planning
 decisions. Existing projects retain their code and decisions. Discovery
 depends on the client; references alone do not prove a skill was loaded.
 
-[Changelog](CHANGELOG.md) · [Roadmap](docs/product/roadmap.md) · [MIT license](LICENSE)
+## License and authorship
+
+Maintained by [PathBit](https://www.pathbit.com.br),
+under the [MIT license](LICENSE).
+Installation includes the kit license in `.pbai4devs/LICENSE` and preserves
+your project's license and files.
+
+[Changelog](CHANGELOG.md) · [Roadmap](docs/product/roadmap.md)
 
 Found a bug or have an idea? [Open an issue][issues] using the contribution
 forms. See [how to participate](docs/maintainers/community.md).
@@ -69,8 +78,10 @@ forms. See [how to participate](docs/maintainers/community.md).
 agent to read `AGENTS.md`.
 
 [clients]: .pbai4devs/COMPATIBILIDADE.md
-[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.5
+[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.7
 [npm-package]: https://www.npmjs.com/package/@pathbit/agentdevkit
+[npm-badge]: https://img.shields.io/npm/v/%40pathbit%2Fagentdevkit
+[license-badge]: https://img.shields.io/badge/license-MIT-blue
 [tests]: docs/guides/tools-and-testing.md
 [cli]: docs/guides/cli.md
 [help]: docs/guides/troubleshooting.md

package/README.es.md

@@ -7,6 +7,8 @@ language: es
 
 [Português](README.md) · [English](README.en.md) · [Paquete npm][npm-package]
 
+[![npm][npm-badge]][npm-package] [![MIT][license-badge]](LICENSE)
+
 Organiza el trabajo con agentes de código, desde la planificación hasta la
 verificación. Mantén skills, reglas, comandos y perfiles en `.pbai4devs`;
 el kit genera las referencias de cada [cliente compatible][clients].
@@ -33,7 +35,7 @@ Después, abre el proyecto en tu agente y pide:
 La [guía de instalación](docs/guides/installation.md) incluye Windows, Node ausente,
 simulación y actualización. Instala y actualiza mediante el
 [paquete npm público][packages];
-la [release v0.0.5][release] conserva artefactos y checksums para verificarlos.
+la [release v0.0.7][release] conserva artefactos y checksums para verificarlos.
 No requiere instalación global.
 La CLI guarda el idioma `pt`, `en` o `es` por proyecto.
 
@@ -62,7 +64,14 @@ las herramientas se instalan por separado. Los documentos de producto siguen
 las decisiones de planificación. Los proyectos existentes conservan su código.
 Una referencia no demuestra que un cliente haya cargado la skill.
 
-[Changelog](CHANGELOG.md) · [Roadmap](docs/product/roadmap.md) · [Licencia MIT](LICENSE)
+## Licencia y autoría
+
+Mantenido por [PathBit](https://www.pathbit.com.br),
+con licencia [MIT](LICENSE).
+La instalación incluye la licencia del kit en `.pbai4devs/LICENSE` y conserva
+la licencia y los archivos propios de tu proyecto.
+
+[Changelog](CHANGELOG.md) · [Roadmap](docs/product/roadmap.md)
 
 ¿Encontraste un problema o tienes una idea? [Abre una issue][issues] con los
 formularios. Consulta [cómo participar](docs/maintainers/community.md).
@@ -71,8 +80,10 @@ formularios. Consulta [cómo participar](docs/maintainers/community.md).
 al agente que lea `AGENTS.md`.
 
 [clients]: .pbai4devs/COMPATIBILIDADE.md
-[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.5
+[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.7
 [npm-package]: https://www.npmjs.com/package/@pathbit/agentdevkit
+[npm-badge]: https://img.shields.io/npm/v/%40pathbit%2Fagentdevkit
+[license-badge]: https://img.shields.io/badge/license-MIT-blue
 [tests]: docs/guides/tools-and-testing.md
 [cli]: docs/guides/cli.md
 [help]: docs/guides/troubleshooting.md

package/README.md

@@ -1,18 +1,15 @@
----
-description: Instruções e fluxo de trabalho para agentes de código.
-language: pt
----
-
 # AgentDevKit
 
-[English](README.en.md) · [Español](README.es.md) · [Pacote npm][npm-package]
+[English](https://github.com/pathbit/AgentDevKit/blob/master/README.en.md) · [Español](https://github.com/pathbit/AgentDevKit/blob/master/README.es.md) · [Pacote npm][npm-package]
+
+[![npm][npm-badge]][npm-package] [![MIT][license-badge]](https://github.com/pathbit/AgentDevKit/blob/master/LICENSE)
 
 Uma forma de organizar o trabalho com agentes de código, do planejamento à
 verificação. Você mantém skills, regras, comandos e perfis em `.pbai4devs`;
 o kit gera os apontamentos que cada cliente sabe encontrar.
 
 Use com Codex, Claude, Cursor, Copilot, OpenCode e outros
-[clientes compatíveis](.pbai4devs/COMPATIBILIDADE.md). Há uma origem;
+[clientes compatíveis](https://github.com/pathbit/AgentDevKit/blob/master/.pbai4devs/COMPATIBILIDADE.md). Há uma origem;
 cada cliente conserva seu formato de descoberta. No repositório, o código
 fica em `src/`, os testes em `tests/` e os recursos compartilhados em
 `.pbai4devs/`. Pastas nativas, entradas e preferências são geradas localmente.
@@ -34,8 +31,8 @@ Depois, abra o projeto no seu agente e peça:
 > Leia AGENTS.md e use a skill proximos-passos para orientar meu trabalho.
 
 Windows, instalação sem Node, simulação e atualização estão no
-[guia de instalação](docs/guides/installation.md). A distribuição usa a
-versão publicada no [npm público][packages] e na [release v0.0.5][release],
+[guia de instalação](https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/installation.md). A distribuição usa a
+versão publicada no [npm público][packages] e na [release v0.0.7][release],
 sem instalação global. Instalação e atualização usam o pacote do registro;
 os arquivos da release servem para conferir os artefatos publicados.
 O idioma da CLI pode ser `pt`, `en` ou `es`.
@@ -44,12 +41,12 @@ O idioma da CLI pode ser `pt`, `en` ou `es`.
 
 | Quero… | Ler |
 | --- | --- |
-| Entender e começar | [Wiki](docs/README.md) |
-| Planejar ou retomar um projeto | [Fluxo de trabalho](docs/guides/workflow.md) |
-| Criar uma skill ou comando | [Recursos](docs/guides/resources.md) |
+| Entender e começar | [Wiki](https://github.com/pathbit/AgentDevKit/blob/master/docs/README.md) |
+| Planejar ou retomar um projeto | [Fluxo de trabalho](https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/workflow.md) |
+| Criar uma skill ou comando | [Recursos](https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/resources.md) |
 | Instalar ferramentas e comprovar uma entrega | [Ferramentas e testes][tests] |
 | Consultar opções ou resolver um erro | [CLI][cli] · [Soluções][help] |
-| Melhorar o próprio kit | [Contribuir](CONTRIBUTING.md) |
+| Melhorar o próprio kit | [Contribuir](https://github.com/pathbit/AgentDevKit/blob/master/CONTRIBUTING.md) |
 | Experimentar os cenários | [Exemplos](https://github.com/pathbit/AgentDevKit/tree/master/examples) |
 
 ## Desenvolver este repositório
@@ -65,25 +62,34 @@ npm run examples
 
 Os exemplos aparecem em `examples/generated/`. Para testar todos os cenários,
 use `npm run test:examples`; para verificar o pacote, `npm run verify`.
-O [guia de desenvolvimento](docs/maintainers/development.md) explica a árvore
+O [guia de desenvolvimento](https://github.com/pathbit/AgentDevKit/blob/master/docs/maintainers/development.md) explica a árvore
 e os comandos.
 
 Instalar o kit prepara instruções. As ferramentas são instaladas por uma ação
 separada; PRD, design e specs surgem quando você inicia o planejamento.
 Projetos existentes preservam seu código e suas decisões.
 
-[Changelog](CHANGELOG.md) · [Roadmap](docs/product/roadmap.md) · [Licença MIT](LICENSE)
+## Licença e autoria
+
+Mantido pela [PathBit](https://www.pathbit.com.br),
+sob a licença [MIT](https://github.com/pathbit/AgentDevKit/blob/master/LICENSE).
+A instalação inclui a licença do kit em `.pbai4devs/LICENSE` e preserva
+a licença e os arquivos próprios do seu projeto.
+
+[Changelog](https://github.com/pathbit/AgentDevKit/blob/master/CHANGELOG.md) · [Roadmap](https://github.com/pathbit/AgentDevKit/blob/master/docs/product/roadmap.md)
 
 Encontrou um problema ou tem uma ideia? [Abra uma issue][issues] pelos
-[formulários de contribuição](docs/maintainers/community.md).
+[formulários de contribuição](https://github.com/pathbit/AgentDevKit/blob/master/docs/maintainers/community.md).
 
-**[ Próximo passo ]** Siga a [instalação](docs/guides/installation.md) e peça
+**[ Próximo passo ]** Siga a [instalação](https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/installation.md) e peça
 ao seu agente para ler `AGENTS.md`.
 
-[tests]: docs/guides/tools-and-testing.md
-[cli]: docs/guides/cli.md
-[help]: docs/guides/troubleshooting.md
+[tests]: https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/tools-and-testing.md
+[cli]: https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/cli.md
+[help]: https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/troubleshooting.md
 [issues]: https://github.com/pathbit/AgentDevKit/issues/new/choose
-[packages]: docs/maintainers/packages.md
-[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.5
+[packages]: https://github.com/pathbit/AgentDevKit/blob/master/docs/maintainers/packages.md
+[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.7
 [npm-package]: https://www.npmjs.com/package/@pathbit/agentdevkit
+[npm-badge]: https://img.shields.io/npm/v/%40pathbit%2Fagentdevkit
+[license-badge]: https://img.shields.io/badge/license-MIT-blue

package/docs/guides/installation.md

@@ -44,10 +44,13 @@ Sem escolha explícita ou salva, `all` mantém todos os clientes compatíveis.
 | Índices, manifesto e seleção pessoal | Derivados locais ignorados. |
 | Código, documentos e configurações humanas | Preservados. |
 | Downloads e resultados de testes | Locais e ignorados. |
+| `.pbai4devs/LICENSE` | Licença MIT do kit, copiada do pacote. |
 
 O gerador completo permanece no pacote npm. Ele não copia `bin/`, `src/`,
 `scripts/release/` ou os testes do produto para o projeto atendido.
 Instalar o kit não inicia uma aplicação nem instala todas as ferramentas.
+A licença existente na raiz do projeto não é substituída. A cópia do hub
+identifica a licença dos recursos do AgentDevKit, sem redefinir a do projeto.
 
 ## Git e migração
 
@@ -57,6 +60,11 @@ workflows, formulários de issues ou configurações humanas em `.github`.
 Sem Git, uma proteção no `.gitignore` da raiz evita incluir os derivados
 quando o repositório for iniciado.
 
+O bloco local também protege `.agent-tests`, `tmp`, `temp`, `.playwright*`
+e relatórios de testes, inclusive com letras maiúsculas e em subpastas.
+O `.gitignore` existente e seus arquivos rastreados são preservados;
+uma exceção humana que conflite com essa proteção é informada como conflito.
+
 Arquivos já rastreados exigem migração do índice: apenas saídas identificadas
 do kit podem deixar de ser rastreadas, preservando seus bytes no disco.
 Revise o plano e os conflitos em um projeto existente; use `--dry-run` antes
@@ -69,10 +77,19 @@ continua válida; `agents` consulta e `agents codex,claude` altera a seleção.
 `agents all` habilita todos. As pastas compartilhadas permanecem quando
 necessárias para outro cliente, como `.agents` para Codex e Antigravity.
 
+Confira a simulação antes de atualizar um projeto existente. Arquivos
+gerenciados alterados geram conflito; use `--force` somente após revisar o
+backup e o conteúdo que será substituído. Preserve os dados locais, as
+configurações próprias e os commits do projeto.
+
+Links simbólicos em caminhos usados pela instalação podem bloquear a operação.
+O kit informa o caminho e não converte nem remove o link automaticamente.
+Use a simulação para identificar esse caso antes de aplicar.
+
 O [fluxo de trabalho](workflow.md) orienta a próxima etapa do projeto.
 Se houver erro, consulte [solução de problemas](troubleshooting.md).
 
-[Wiki](../README.md) · [Release 0.0.5][release]
+[Wiki](../README.md) · [Spec v0.0.7][spec]
 
 [bootstrap]: ../../.pbai4devs/scripts/preparar-ferramentas/BOOTSTRAP.md
-[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.5
+[spec]: ../specs/v0.0.7/SPEC.md

package/docs/maintainers/packages.md

@@ -8,6 +8,13 @@ O AgentDevKit é um único pacote: [`@pathbit/agentdevkit`][package]. Ele conté
 a CLI e os recursos compartilhados; a instalação prepara os apontamentos dos
 agentes escolhidos no projeto.
 
+Os metadados identificam PathBit como autor, palavras-chave do kit e licença
+MIT. O README público é gerado sem frontmatter e com links absolutos do GitHub;
+a fonte versionada conserva o YAML. O `LICENSE` canônico acompanha o pacote e
+é instalado em `.pbai4devs/LICENSE`, sem alterar a licença do consumidor.
+Ferramentas de terceiros baixadas à parte mantêm suas próprias licenças e
+não integram o TGZ do AgentDevKit.
+
 ## Instalar no projeto
 
 Com Node.js 18+ e npm, execute na pasta do projeto. Não é necessário login:
@@ -16,7 +23,7 @@ Com Node.js 18+ e npm, execute na pasta do projeto. Não é necessário login:
 npx @pathbit/agentdevkit init
 ```
 
-Para fixar a versão, use `npx @pathbit/agentdevkit@0.0.5 init`.
+Para repetir uma instalação, fixe a versão desejada após o nome do pacote.
 
 Acrescente `--agents codex,claude` para selecionar clientes, `--dry-run` para
 simular ou use `update`, `doctor` e `sync --check` no lugar de `init`.
@@ -57,13 +64,17 @@ existir; a primeira publicação pode usar o secret `NPMJS_TOKEN`.
 Para publicar somente o pacote de uma tag que já tem artefato aprovado:
 
 ```console
-gh workflow run release.yml --ref master -f tag=v0.0.5 -F package_only=true
+gh workflow run release.yml --ref master -f tag=v0.0.7 -F package_only=true
 ```
 
 Se o artefato expirou, reexecute o CI original da tag antes da publicação.
 Depois do envio, o job usa um ambiente sem credenciais e cache novo para
 executar `--version`, `init`, `doctor` e `sync --check` pelo nome e versão
 publicados. Assim, a verificação comprova o acesso de um usuário comum.
+Confirme também que `latest` aponta para a versão estável e que o tarball é
+baixável; metadados visíveis sozinhos não comprovam uma instalação funcional.
+Se o registro ainda não disponibilizar o pacote, aguarde a verificação sem
+republicar automaticamente a mesma versão.
 
 As versões antigas no [GitHub Packages][legacy] permanecem disponíveis;
 o canal de instalação padrão é o npm público.

package/docs/product/design.md

@@ -39,6 +39,11 @@ as automações de release ou os testes exclusivos do produto. Os layouts dos
 clientes vêm da [configuração declarativa][clients]. Os arquivos nativos são
 pequenos apontamentos para o hub, sem symlinks.
 
+O `LICENSE` da raiz do pacote é a fonte canônica da licença MIT do kit.
+`init` e `update` copiam seus bytes para `.pbai4devs/LICENSE`; a licença da raiz
+do projeto consumidor permanece intacta. Alterações na licença gerenciada
+seguem a mesma proteção de conflitos e backup dos demais arquivos do hub.
+
 A escolha salva determina as derivações. Atualizações e sincronizações não
 reativam clientes desmarcados. `all` preserva a intenção de usar todos; estados
 antigos sem escolha explícita mantêm esse comportamento.
@@ -74,6 +79,11 @@ O CI separa a suíte completa dos testes de portabilidade. A publicação usa um
 artifact aprovado do mesmo commit e verifica versão, origem e checksum.
 Não há novo empacotamento entre teste e publicação.
 
+Antes de empacotar, o estágio de distribuição deriva o README público da
+fonte: remove o frontmatter YAML e resolve links locais para URLs absolutas
+do GitHub. O README versionado mantém seu YAML e seus links de trabalho.
+O pacote identifica PathBit como autor, inclui palavras-chave e declara MIT.
+
 O npm público recebe o mesmo tarball da release, como `@pathbit/agentdevkit`.
 O workflow prioriza o secret `NPMJS_TOKEN` do repositório, recebido pela
 variável interna `NPM_TOKEN`; sem token, usa OIDC. Confirma a integridade da

package/docs/product/prd.md

@@ -1,7 +1,7 @@
 ---
 description: Requisitos da distribuição portátil AgentDevKit.
 status: aprovado
-version: 0.0.5
+version: 0.0.6
 ---
 
 # PRD do AgentDevKit
@@ -37,6 +37,9 @@ extraído do projeto de origem como produto independente.
 | FR-015 | Publicar no npm público, instalável via npx sem autenticação. |
 | FR-016 | Organizar código e testes em `src/` e `tests/`, na raiz. |
 | FR-017 | Gerar exemplos isolados e acessíveis por comandos documentados. |
+| FR-018 | Publicar autoria PathBit, palavras-chave e licença MIT no npm. |
+| FR-019 | Exibir README legível no npm sem alterar o Markdown fonte. |
+| FR-020 | Levar a licença do kit ao hub sem alterar a licença do projeto. |
 
 Execuções repetidas devem ser idempotentes; a CLI oferece simulação e JSON.
 As instruções permanecem concisas, com detalhes opcionais em referências.
@@ -54,6 +57,8 @@ A entrega exige testes de projeto vazio e existente, preservação de arquivos,
 atualização, idiomas, catálogos e distribuição sem artefatos locais.
 Os aceites da distribuição ficam na [spec inicial](../specs/v0.0.1/SPEC.md);
 a [spec de seleção](../specs/v0.0.2/SPEC.md) detalha a instalação por agente.
+A [spec v0.0.6](../specs/v0.0.6/SPEC.md) trata a apresentação pública, a licença
+distribuída e a atualização verificada do projeto de origem.
 
 ## Autorização
 
@@ -61,4 +66,5 @@ Escopo autorizado pela solicitação explícita de criação do AgentDevKit.
 Este estado registra requisitos aceitos; testes e publicação têm validação
 própria e não são considerados concluídos por esta aprovação.
 
-[Wiki](../README.md) · [Design](design.md) · [Fluxo de uso](../guides/workflow.md)
+[Wiki](../README.md) · [Design](design.md) ·
+[Fluxo de uso](../guides/workflow.md)

package/docs/product/roadmap.md

@@ -13,11 +13,13 @@ status: vigente
 | Release v0.0.1 | Aceites e revisão | Pacote versionado e changelog. |
 | Seleção de agentes v0.0.2 | CLI e adaptadores | [Spec][selection]. |
 | Fontes e geração local v0.0.3 | Seleção e distribuição | [Spec][source]. |
-| Pacote npm no GitHub Packages | Artefato aprovado da release | [Spec][packages]. |
+| Pacote no GitHub Packages | Artefato aprovado | [Spec][packages]. |
 | Estrutura e exemplos v0.0.4 | CLI, distribuição e gerador | [Spec][layout]. |
 | Instalação pelo registro v0.0.5 | Pacote publicado | [Spec][registry]. |
+| Apresentação e licença v0.0.6 | Distribuição e atualização | [Spec][public]. |
+| Compatibilidade real v0.0.7 | Testes em clones existentes | [Spec][oss]. |
 
-A primeira entrega segue a [spec v0.0.1](../specs/v0.0.1/SPEC.md) e está disponível
+A primeira entrega segue a [spec v0.0.1](../specs/v0.0.1/SPEC.md), disponível
 na [release v0.0.1][release]. Os detalhes de mudanças estão no
 [changelog](../../CHANGELOG.md), e o processo de publicação em
 [manutenção](../maintainers/maintenance.md).
@@ -34,3 +36,5 @@ comportamento existente, sem alterar a versão de uma release já publicada.
 [packages]: ../specs/github-packages/SPEC.md
 [layout]: ../specs/v0.0.4/SPEC.md
 [registry]: ../specs/v0.0.5/SPEC.md
+[public]: ../specs/v0.0.6/SPEC.md
+[oss]: ../specs/v0.0.7/SPEC.md

package/docs/specs/README.md

@@ -10,6 +10,8 @@ description: Incrementos verificáveis do AgentDevKit.
 - [GitHub Packages](github-packages/SPEC.md): pacote npm instalável via npx.
 - [v0.0.4](v0.0.4/SPEC.md): estrutura padrão e exemplos na raiz.
 - [v0.0.5](v0.0.5/SPEC.md): instalação pelo registro em todos os fluxos.
+- [v0.0.6](v0.0.6/SPEC.md): apresentação pública, licença e atualização segura.
+- [v0.0.7](v0.0.7/SPEC.md): projetos reais e proteção local de artefatos.
 
 Cada incremento vincula requisitos, critérios, testes e evidências locais.
 

package/docs/specs/v0.0.6/README.md

@@ -0,0 +1,10 @@
+---
+description: Apresentação pública e licença distribuída do AgentDevKit.
+---
+
+# Versão 0.0.6
+
+A [spec](SPEC.md) define metadados, README e licença do pacote, consumo
+anônimo da versão estável e atualização segura do projeto de origem.
+
+[Specs](../README.md)

package/docs/specs/v0.0.6/SPEC.md

@@ -0,0 +1,77 @@
+---
+description: Apresentação pública, licença e atualização verificada do kit.
+status: aprovado
+version: 0.0.6
+---
+
+# Apresentação pública e licença
+
+## Objetivo e autorização
+
+Publicar uma versão estável do AgentDevKit com identificação clara no npm,
+README legível e licença incluída no hub instalado. Depois da publicação,
+atualizar o `talquee-ai-router` preservando seus arquivos e dados.
+
+Escopo autorizado pela solicitação do usuário. A aprovação permite executar
+o trabalho; testes, publicação e atualização exigem suas próprias provas.
+Dependências: [PRD](../../product/prd.md), [design](../../product/design.md) e
+[instalação pelo registro](../v0.0.5/SPEC.md).
+
+## Contrato
+
+- Declarar autor PathBit, palavras-chave relevantes e licença MIT no pacote.
+- Derivar o README publicado da fonte sem alterar o arquivo versionado:
+  remover YAML e converter links locais para URLs absolutas do GitHub.
+- Usar o `LICENSE` da raiz do pacote como fonte de `.pbai4devs/LICENSE`.
+  Preservar a licença da raiz do consumidor e proteger conflitos no hub.
+- Manter Node 18+ no launcher e Node 24+ no núcleo; isolar credenciais e cache
+  nas provas de consumo público, sem instalar ferramentas implicitamente.
+- Confirmar `latest`, integridade e download antes das provas anônimas.
+- Simular a atualização do router, conferir propriedade e preservar dados,
+  configurações, ferramentas locais e commits humanos existentes.
+
+Não criar documentos de produto no router, redefinir sua licença nem alterar
+versões publicadas. A entrega não promete ausência total de bugs.
+
+## Critérios de aceite
+
+| ID | Resultado observável |
+| --- | --- |
+| AC-001 | Pacote identifica PathBit, palavras-chave e licença MIT. |
+| AC-002 | README do TGZ não tem YAML; links locais tornam-se absolutos. |
+| AC-003 | Hub recebe a licença canônica sem alterar a do consumidor. |
+| AC-004 | Runtime e consumo público mantêm os contratos de ambiente. |
+| AC-005 | Versão estável em `latest` instala e opera sem autenticação. |
+| AC-006 | Router atualizado preserva arquivos, dados e commits anteriores. |
+
+## Plano de verificação
+
+Resultados ficam em `.agent-tests/public-package/`, separados desta spec.
+O código dos testes é versionado. Cada prova registra comando, versão,
+pré-requisitos, assertiva e caminho da evidência no relatório de revisão.
+
+- **AC-001:** inspecionar o `package.json` do TGZ exato e os metadados do npm;
+  comparar autoria, palavras-chave, MIT e versão com a fonte aprovada.
+- **AC-002:** testar empacotamento e extrair o TGZ; verificar a primeira linha,
+  links de arquivos/imagens e preservação dos bytes do README fonte.
+- **AC-003:** executar testes de instalação e distribuição em projetos novos
+  e existentes; comparar as licenças, testar conflito, backup e diagnóstico.
+- **AC-004:** executar testes do launcher, publicação e distribuição; provar
+  compatibilidade de runtime, cache isolado e ausência de tokens no consumidor.
+- **AC-005:** publicar o artefato aprovado; consultar `latest` e baixar;
+  executar `--version`, `init`, `doctor` e `sync --check` em destino e cache
+  novos.
+- **AC-006:** salvar hashes e estado Git do router, revisar `--dry-run`, aplicar
+  a versão fixada e repetir diagnóstico/sincronização; comparar arquivos
+  próprios, oito recibos de ferramentas e histórico com o estado anterior.
+
+A revisão independente confere o relatório e os achados antes da conclusão.
+Esta mudança exige terminal e registro npm; não altera interface web/desktop.
+
+## Documentação afetada
+
+Atualizar README público, guias de instalação/publicação, PRD, design, roadmap,
+índice de specs, changelog e descrição da licença no hub. Revisar somente os
+trechos do README do router afetados pela atualização, preservando seu contexto.
+
+[Specs](../README.md) · [Pacote npm](../../maintainers/packages.md)

package/docs/specs/v0.0.7/README.md

@@ -0,0 +1,10 @@
+---
+description: Compatibilidade do pacote com projetos open source existentes.
+---
+
+# Versão 0.0.7
+
+A [spec](SPEC.md) define testes em clones reais e a correção das exclusões
+locais de artefatos, preservando os arquivos e as decisões dos projetos.
+
+[Specs](../README.md)

package/docs/specs/v0.0.7/SPEC.md

@@ -0,0 +1,59 @@
+---
+description: Testes em projetos reais e proteção de artefatos locais.
+status: aprovado
+version: 0.0.7
+---
+
+# Compatibilidade com projetos existentes
+
+## Objetivo e autorização
+
+Atender ao pedido de testar o pacote publicado em projetos open source com
+conteúdo real, usando clones em `tmp/` ignorado. Corrigir a falta de proteção
+de artefatos revelada em projetos que não tinham as regras do AgentDevKit.
+
+O trabalho usa o [PRD](../../product/prd.md),
+o [design](../../product/design.md) e a
+[distribuição pública](../v0.0.6/SPEC.md). Não altera as aplicações clonadas.
+
+## Contrato
+
+- Clonar commits fixos de Express, Zod e Chi; preservar os projetos originais.
+- Comparar bytes, tipos, permissões, links, HEAD e alterações staged.
+- Verificar instalação, atualização, repetição, skill própria e conflitos.
+- Proteger artefatos no ignore local sem reescrever o `.gitignore` do usuário
+  nem desindexar arquivos humanos. Respeitar projetos irmãos e exceções.
+- Manter as recusas de links simbólicos. Um bloqueio seguro não comprova
+  instalação bem-sucedida; relatá-lo e verificar ausência de alterações.
+- Versionar o teste; guardar clones, logs e resultados somente em `tmp/`.
+- Publicar correções como nova versão estável; repetir a prova pública.
+
+## Critérios de aceite
+
+| ID | Resultado observável |
+| --- | --- |
+| AC-001 | Matriz real registra resultado e preservação por projeto. |
+| AC-002 | Artefatos são ignorados sem alterar fontes ou projetos irmãos. |
+| AC-003 | Regressões e revisão independente aprovam a correção. |
+| AC-004 | Pacote estável publicado repete os resultados e atualiza o router. |
+
+## Verificação
+
+- **AC-001:** executar o runner contra o npm, incluindo caso staged e bloqueios;
+  registrar commits, versão e hashes. Não confundir com testes das aplicações.
+- **AC-002:** testar Git, instalação sem Git, projeto aninhado, caixa mista,
+  exceções humanas e artefatos já rastreados. Não forçar sobrescritas.
+- **AC-003:** executar testes do pacote, infraestrutura, lint e distribuição.
+  Comparar testes nativos do Express antes e depois, sem modificar suas fontes.
+- **AC-004:** conferir release, `latest`, checksum e instalação anônima; repetir
+  matriz com o pacote publicado e atualizar o router com backup e diagnóstico.
+
+Evidências dos clones ficam em `tmp/oss-compatibility/`; o relatório de revisão
+em `.agent-tests/oss-compatibility/` referencia cópias dessas provas.
+Zod e Chi não terão testes nativos sem os runtimes/gerenciadores exigidos.
+Não concluir compatibilidade universal a partir desta matriz.
+
+## Documentação afetada
+
+Atualizar instalação, testes, changelog, índices e roadmap. Documentar a
+proteção de artefatos locais e os limites de configurações preexistentes.

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@pathbit/agentdevkit",
-  "version": "0.0.5",
-  "description": "PathBit AgentDevKit: specs, skills and workflows for coding agents.",
+  "version": "0.0.7",
+  "description": "Shared skills, specifications and workflows for AI coding agents.",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
-    "access": "public"
+    "access": "public",
+    "tag": "latest"
   },
   "repository": {
     "type": "git",
@@ -49,6 +50,21 @@
     "pack:release": "node scripts/release/assets.mjs",
     "ci:full": "node scripts/release/pipeline.mjs full",
     "ci:portable": "node scripts/release/pipeline.mjs portable",
-    "ci:smoke": "node scripts/release/pipeline.mjs smoke"
-  }
+    "ci:smoke": "node scripts/release/pipeline.mjs smoke",
+    "test:oss": "node tests/oss-compatibility.mjs"
+  },
+  "author": {
+    "name": "PathBit",
+    "url": "https://www.pathbit.com.br"
+  },
+  "keywords": [
+    "ai",
+    "coding-agents",
+    "agent-skills",
+    "spec-driven-development",
+    "developer-tools",
+    "codex",
+    "claude-code",
+    "github-copilot"
+  ]
 }

package/src/install.mjs

@@ -52,7 +52,7 @@ export function safePath(root, path) {
 function resourceAllowed(path, directory = false) {
   const parts = path.split('/');
   const folders = new Set(['agents', 'commands', 'external-skills', 'rules', 'scripts', 'skills', 'templates', 'tools', 'estado']);
-  const files = new Set(['README.md', 'INSTRUCTIONS.md', 'COMPATIBILIDADE.md', '.gitignore']);
+  const files = new Set(['README.md', 'INSTRUCTIONS.md', 'COMPATIBILIDADE.md', 'LICENSE', '.gitignore']);
   if (!folders.has(parts[0]) && !(parts.length === 1 && files.has(parts[0]))) return false;
   if (parts[0] === 'estado') return directory && parts.length === 1 || path === 'estado/README.md';
   if (isGeneratedOutput(path, directory) || parts.some(part => ignored.has(part)) || parts[0] === 'adapters' || path === 'estado/agentdevkit.json' || path === '.npmignore') return false;
@@ -178,6 +178,12 @@ export function planInstallation({ target, language = 'pt', mode = 'init', force
   try {
     const existing = copyResources(join(target, '.pbai4devs'), join(stage, '.pbai4devs'));
     const bundled = mode === 'init' || mode === 'update' ? copyResources(join(packageRoot, '.pbai4devs'), join(stage, '.pbai4devs')) : [];
+    if (mode === 'init' || mode === 'update') {
+      const license = read(packageRoot, 'LICENSE');
+      if (!license?.length) fail('E_LICENSE', 'The AgentDevKit package is missing its LICENSE.');
+      write(stage, '.pbai4devs/LICENSE', license);
+      bundled.push('LICENSE');
+    }
     const supplied = new Set(bundled);
     const internal = new Set(['catalog.json', 'skills.json', 'agents.json', 'rules.json', 'espelhos.conf', '.gitignore', 'estado/README.md']);
     if (bundled.length) for (const path of Object.keys(previous?.files || {})) {