auroq-os 2.6.3 → 2.6.5

package/.auroq-core/core-config.yaml

@@ -1,7 +1,7 @@
 project:
   name: "Auroq OS"
   type: greenfield
-  version: 2.6.3
+  version: 2.6.5
   installedAt: '2026-03-16'
 
 ide:

package/.claude/CLAUDE.md

@@ -4,6 +4,6 @@ Sistema operacional de IA para o negócio. Você manda e julga; a IA executa.
 
 Ative um agente pelo comando (`/companion`, `$companion`, `@companion`). Todo conteúdo Arcane (Companion interno, Consultor, forjas, Pack) vem pelo MCP `arcane` — nunca procurar em `agents/`.
 
-Sua memória, seus documentos e suas conversas nunca saem da sua máquina. O que registramos é qual conteúdo licenciado foi entregue, quando e pra qual conta — igual a uma nota de entrega.
+Sua memória e seus documentos ficam na sua máquina e no seu GitHub privado (senhas e `business/vault/` ficam fora). O histórico das sessões com os squads só vai para a Arka se você autorizar na plataforma, e você pode retirar a autorização quando quiser. Além disso, a Arka registra qual conteúdo licenciado foi entregue, quando e pra qual conta — igual a uma nota de entrega.
 
 Rules em `.claude/rules/`. Constitution em `.auroq-core/constitution.md`.

package/CHANGELOG.md

@@ -1,3 +1,39 @@
+## 2.6.5 — 2026-10-02
+
+### Pasta do negocio nunca vai inteira pro ar na Vercel
+
+- O Bootstrap 1 ligava a publicacao automatica da Vercel (`vercel link` + `vercel git connect`) na raiz da pasta do negocio. Sem site, a Vercel publica a pasta inteira: memoria, `business/`, `docs/`, `.claude/`, `.synapse/` num endereco aberto (conferido com `vercel build` num projeto de teste).
+- Ops (auroq-core 2.3.21): a FASE 6 so faz login e confere a trava. A publicacao automatica liga no primeiro site, com `--root-directory` na pasta do site e conferencia em `vercel project inspect` antes do `git connect`. Pasta ja ligada na raiz: o Ops aponta a raiz pro site ou desliga o git (sem apagar nada no ar).
+- `instalar`, `manutencao`, `clone` e `fix-gitignore` gravam um `.vercelignore` que nega memoria, negocio, documentos e configuracao. Linhas proprias do aluno ficam; rodar de novo nao duplica.
+
+### Supabase sem segredo na conversa
+
+- Ops FASE 7: o login do Supabase vai numa janela separada do Terminal/PowerShell aberta pelo aluno na pasta do negocio. Acabou o roteiro "gera token com validade Nunca e cola aqui no terminal" (o terminal, ali, era a conversa). Token, codigo e senha do banco colados por engano: o Ops avisa, nao repete e manda revogar.
+- Windows: Supabase pelo instalador oficial (Scoop ou o `.exe` da pagina de releases), nunca `npm install -g`.
+- Antes do `supabase link`, o Ops mostra os projetos da conta e o aluno confirma qual e deste negocio; projeto de outro produto ou de producao nao e usado.
+
+### Instalador do Mac nao tira mais o `claude` do caminho
+
+- `auroq_aplicar_path` reescrevia o bloco do perfil so com a pasta da vez: no Mac sem Node, a pasta do motor (segunda chamada) apagava `~/.local/bin` e o aluno ficava com `claude: command not found`. O bloco agora guarda as duas pastas (motor na frente), sem duplicar ao reinstalar, descarta pasta que nao existe mais e aceita caminho com espaco. Testes com shell limpo (bash e zsh).
+
+### Texto de privacidade verdadeiro
+
+- `casca/.claude/CLAUDE.md` dizia que memoria, documentos e conversas "nunca saem da sua maquina". Agora: ficam na maquina e no GitHub privado do aluno; o historico das sessoes com squads so vai para a Arka se ele autorizar na plataforma, e a autorizacao pode ser retirada.
+- Mantem `arcane-mcp@0.7.0`. Instaladores do repositorio preparados para 2.6.5.
+
+## 2.6.4 — 2026-09-29
+
+### Companion com o nome do aluno nao trava mais a atualizacao
+
+- Quem deu nome ao Companion no Bootstrap (ex.: "Atlas" → `/atlas-companion`) podia ficar preso em "Sync de skills do Codex falhou" → "arquivo faltando: Codex Companion (.agents/skills/companion/SKILL.md)" → `AUROQ_RESULTADO status=erro`. Tres alunos em 29/09.
+- Causa: o sync do Codex morria inteiro na primeira pasta de skill que nao reconhecia — pasta do negocio movida, copiada ou vinda de outra maquina (marcador com outro caminho), `companion.md` antigo colidindo com `auroq-companion.md`, ou skill feita a mao pelo agente. Como o `--clean` ja tinha apagado a skill `companion` quando o comando base sumiu, ela nunca voltava e a verificacao final derrubava a atualizacao.
+- O sync nao para mais por isso: pasta de skill com o nosso marcador dentro do proprio negocio e reconhecida mesmo depois de mover a pasta; colisao de nome usa o comando oficial e segue; skill sem marcador feita pelo aluno fica como esta, com aviso. A pasta global `~/.agents/skills` continua recusando o que e de outro projeto.
+- `$companion` sempre existe no Codex: sem o comando base, vira atalho do comando com o nome do aluno. `$atlas-companion` continua.
+- A verificacao de integridade aceita o comando com o nome do aluno como o Companion (so ele; os outros arquivos seguem exigidos pelo caminho exato). Quando o sync falha, a manutencao mostra o motivo.
+- Ops (auroq-core 2.3.20): a FASE 10 cria o comando com o nome e deixa `/auroq-companion` no lugar (antes mandava apagar um `companion.md` que nao existe mais).
+- Quem esta travado: "atualiza o sistema" termina `status=ok` e mantem o nome, o comando e o conteudo do Companion.
+- Mantem `arcane-mcp@0.7.0`. Instaladores do repositorio preparados para 2.6.4.
+
 ## 2.6.3 — 2026-09-29
 
 ### Codex no Windows volta a ler e gravar na pasta (EMB-063)

package/README.md

@@ -55,6 +55,11 @@ O caminho manual antigo foi aposentado. Use a instalacao guiada acima. Em negoci
 | `auroq-os sync-codex` | Regenera e verifica as skills locais do Codex |
 | `auroq-os conectar-1password` | Conecta o 1Password CLI — le o token de Service Account direto do Ctrl+C (nunca digitado nem exposto), instala o `op` se faltar, valida online e salva permanente (Mac/Windows) |
 
+> **Seguranca do token 1Password:** o token fica salvo no computador e qualquer programa seu consegue usa-lo.
+> Crie a Service Account com acesso a **um cofre so**, dedicado ao Auroq (o cofre `Claude`), sem senhas
+> pessoais, de banco ou da empresa. Permissao **so leitura**; libere escrita apenas nesse cofre se quiser
+> que o Auroq guarde ali as credenciais novas que voce conectar.
+
 Dentro do projeto instalado, os mesmos checks ficam disponiveis como
 `npm run auroq:sync:codex`, `npm run auroq:sync:codex:check` e
 `npm run auroq:validate`. O instalador adiciona esses scripts sem sobrescrever
@@ -241,13 +246,13 @@ agents/             → Seu exercito (companion, workers, minds, squads)
 
 ## Observabilidade e integridade do motor
 
-Apos publicacao, `npx -y auroq-os@2.6.3 doctor` mostra a fila local segura e os comandos pinados de
-manutencao/diagnostico. `npx -y auroq-os@2.6.3 manutencao` preserva o caminho existente
+Apos publicacao, `npx -y auroq-os@2.6.5 doctor` mostra a fila local segura e os comandos pinados de
+manutencao/diagnostico. `npx -y auroq-os@2.6.5 manutencao` preserva o caminho existente
 de consentimento legado, studentFiles, customizacoes e dados do negocio. Nao ha
 migracao forcada. O registro MCP aponta para `arcane-mcp@0.7.0` — o pin mora no campo
 `arcaneMcpPin` do package.json (fonte unica; o servidor le o mesmo campo no npm).
 `npm run release:verify` recusa publicar com um pin que o npm nao resolva.
-Os instaladores do repositorio ficam preparados para 2.6.3; as copias publicas so recebem
+Os instaladores do repositorio ficam preparados para 2.6.5; as copias publicas so recebem
 a versao apos os gates nativos e a verificacao do tarball publicado.
 O pacote inclui `lib/runtime-integrity.json`: inventario SHA-256 gerado depois da montagem da casca, verificavel com `npm run integrity:verify` dentro do pacote extraido. Ele comprova consistencia do conteudo; nao e uma assinatura de autoria.
 

package/bin/auroq-os.js

@@ -353,6 +353,30 @@ async function untrackSecrets(targetDir) {
   return tracked;
 }
 
+// ─── TRAVA DA VERCEL (.vercelignore canonico) ────────────
+// A pasta do negocio nao e um site. Se alguem ligar a Vercel na raiz do repositorio
+// (Bootstrap antigo: `vercel link` + `vercel git connect` sem site), sem esta trava a
+// Vercel publica memoria, documentos e configuracao num endereco aberto. Com a raiz
+// na pasta do site (o certo), este arquivo nem e lido. Linhas proprias do expert ficam.
+const VERCELIGNORE_HEADER = '# ── Trava do Auroq OS: a pasta do negocio nao vai ao ar (adicionada automaticamente) ──';
+const VERCELIGNORE_PROTECTIONS = [
+  '.claude/', '.codex/', '.agents/', '.synapse/', '.auroq-core/', '.auroq/', '.git/',
+  'agents/', 'business/', 'docs/', 'memoria/', 'memory/', 'squads/',
+  'AGENTS.md', 'CLAUDE.md', '*.md', '.env', '.env.*', '*.key', '*.pem', '.npmrc',
+];
+
+async function ensureVercelignore(targetDir) {
+  const viPath = path.join(targetDir, '.vercelignore');
+  const existing = (await fs.pathExists(viPath)) ? await fs.readFile(viPath, 'utf8') : '';
+  const have = new Set(existing.split('\n').map(l => l.trim()).filter(Boolean));
+  const missing = VERCELIGNORE_PROTECTIONS.filter(l => !have.has(l));
+  if (!missing.length) return [];
+  const base = existing.trim().length ? existing.replace(/\s*$/, '\n\n') : '';
+  const header = have.has(VERCELIGNORE_HEADER) ? '' : `${VERCELIGNORE_HEADER}\n`;
+  await fs.writeFile(viPath, base + header + missing.join('\n') + '\n');
+  return missing;
+}
+
 async function applySecretProtections(targetDir) {
   const added = await ensureGitignore(targetDir);
   if (added.length) {
@@ -360,6 +384,10 @@ async function applySecretProtections(targetDir) {
   } else {
     success('.gitignore ja protege segredos e runtime');
   }
+  const travaVercel = await ensureVercelignore(targetDir);
+  if (travaVercel.length) {
+    success('Trava da Vercel no lugar: memoria, documentos e configuracao do negocio nunca vao ao ar');
+  }
   const untracked = await untrackSecrets(targetDir);
   if (untracked.length) {
     warn(`${untracked.length} arquivo(s) sensivel(is) removido(s) do controle de versao (continuam no seu disco):`);
@@ -398,6 +426,32 @@ const HEALTH_CHECKS = [
   ['scripts/validate-hybrid.mjs', 'Validador hibrido'],
 ];
 
+/**
+ * O aluno da um nome ao Companion no bootstrap (FASE 10 do Ops): `/atlas-companion`. Um
+ * comando com esse nome que ainda aponta pro Companion (recurso `companion` do MCP ou a
+ * pasta agents/companion/) vale como a casca dele — um clone do negocio que so tem o
+ * comando com o nome do aluno nao pode ser acusado de "arquivo faltando". So o Companion
+ * tem essa folga: os outros arquivos continuam exigidos pelo caminho exato.
+ */
+async function companionComNomeDoAluno(targetDir) {
+  const dir = path.join(targetDir, '.claude', 'commands');
+  let nomes = [];
+  try { nomes = await fs.readdir(dir); } catch { return null; }
+  for (const nome of nomes.filter(n => /^[a-z0-9-]+-companion\.md$/.test(n)).sort()) {
+    try {
+      const texto = await fs.readFile(path.join(dir, nome), 'utf8');
+      if (/recurso_id\s*`?companion`?/.test(texto) || /agents\/companion\//.test(texto)) return `.claude/commands/${nome}`;
+    } catch { /* ilegivel: nao conta */ }
+  }
+  return null;
+}
+
+async function checagemPresente(targetDir, file) {
+  if (await fs.pathExists(path.join(targetDir, file))) return true;
+  if (file === '.claude/commands/auroq-companion.md') return Boolean(await companionComNomeDoAluno(targetDir));
+  return false;
+}
+
 /**
  * Registro pro suporte (PRD "Embarque em 2 passos" §5.7).
  *
@@ -494,7 +548,7 @@ async function runHealthChecks(targetDir) {
   let passed = 0;
   const missing = [];
   for (const [file, label] of HEALTH_CHECKS) {
-    if (await fs.pathExists(path.join(targetDir, file))) {
+    if (await checagemPresente(targetDir, file)) {
       passed++;
     } else {
       missing.push(`${label} (${file})`);
@@ -531,7 +585,7 @@ async function runDoctor(targetDir) {
   // 1. arquivos de autoload
   let faltando = 0;
   for (const [file] of HEALTH_CHECKS) {
-    if (!(await fs.pathExists(path.join(targetDir, file)))) faltando++;
+    if (!(await checagemPresente(targetDir, file))) faltando++;
   }
   if (faltando === 0) {
     success(`Arquivos do sistema: ${HEALTH_CHECKS.length}/${HEALTH_CHECKS.length} no lugar`);
@@ -1968,8 +2022,11 @@ async function init({ pasta = null, maintenance = false, modoAgente = false, mig
     execSync('node scripts/sync-codex-skills.mjs --clean', { cwd: targetDir, stdio: 'pipe' });
     execSync('node scripts/sync-codex-skills.mjs --check', { cwd: targetDir, stdio: 'pipe' });
     success('Codex CLI pronto — skills locais verificadas ($companion, $ops, etc.)');
-  } catch {
+  } catch (e) {
     warn('Sync de skills do Codex falhou — rode "npx auroq-os sync-codex" para diagnosticar');
+    // Sem o motivo, o suporte so via o efeito ("Codex Companion faltando") e nunca a causa.
+    const motivo = String(e && (e.stderr || e.message) || '').split(/\r?\n/).find(l => /Error:|Skill |Drift|Ownership|Recusando/.test(l));
+    if (motivo) warn(`  ${motivo.trim().slice(0, 300)}`);
   }
 
   // ─── Fase 5: npm install
@@ -2401,6 +2458,6 @@ if (['init', 'install', 'update'].includes(command)) {
   log('');
 }
 
-if (process.env.AUROQ_EXPORTA_INTERNOS === '1') module.exports = { blocoCodexArcane, envCodexArcane, lerBlocoArcane, lerEnvDoBloco, limparArcaneDoGlobal, envComoCodex, argumentosCodexSmoke, avaliarEventosCodex, rotulo, ARCANE_MCP_PIN };
+if (process.env.AUROQ_EXPORTA_INTERNOS === '1') module.exports = { blocoCodexArcane, envCodexArcane, lerBlocoArcane, lerEnvDoBloco, limparArcaneDoGlobal, envComoCodex, argumentosCodexSmoke, avaliarEventosCodex, rotulo, ARCANE_MCP_PIN, ensureVercelignore, VERCELIGNORE_PROTECTIONS };
 
 }

package/installer/install.ps1

@@ -589,7 +589,7 @@ function Invoke-AuroqLogin {
   # sucesso. Usado como pergunta de sim/nao, ele dizia "voce ja estava logado"
   # pra quem nunca logou, pulava o portao e deixava a conta sem acesso chegar ate
   # a criacao da pasta.
-  & (Get-AuroqNpx) -y auroq-os@2.6.3 check-access
+  & (Get-AuroqNpx) -y auroq-os@2.6.5 check-access
   if ($LASTEXITCODE -ne 0) {
     Write-AuroqLog 'login' 'recusado'
     Write-Host ''
@@ -677,7 +677,7 @@ function Invoke-AuroqInit {
   if ($env:AUROQ_INSTALL_DRY_RUN) { Write-AuroqOk 'Sistema - seria montado aqui'; return }
 
   Set-Location $script:AuroqPastaAlvo
-  & (Get-AuroqNpx) -y auroq-os@2.6.3 instalar
+  & (Get-AuroqNpx) -y auroq-os@2.6.5 instalar
   if ($LASTEXITCODE -ne 0) {
     Write-AuroqLog 'init' 'falhou'
     Write-AuroqErro 'A montagem do sistema parou no meio.' 'Rode o mesmo comando de novo. Se repetir, mande pro suporte o arquivo install.log da pasta .auroq.'

package/installer/install.sh

@@ -219,9 +219,9 @@ auroq_tem_terminal() {
 # recebem pedaco do script no lugar da resposta dele.
 auroq_npx_aluno() {
   if [ -t 0 ]; then
-    npx -y auroq-os@2.6.3 "$@"
+    npx -y auroq-os@2.6.5 "$@"
   else
-    npx -y auroq-os@2.6.3 "$@" < /dev/tty
+    npx -y auroq-os@2.6.5 "$@" < /dev/tty
   fi
 }
 
@@ -245,6 +245,32 @@ auroq_aplicar_path() {
   local bin="${2:-}"
   local tmp="${arquivo}.auroq-tmp.$$"
   [ -f "$arquivo" ] || : > "$arquivo"
+  # O instalador publica DUAS pastas, em chamadas separadas: a da ferramenta
+  # (~/.local/bin, onde mora o `claude`) e a do motor. Reescrever o bloco so com
+  # a pasta da vez apagava a outra: Mac sem Node terminava com `claude: command
+  # not found`. Agora o bloco guarda todas as pastas do Auroq que ainda existem,
+  # a da vez na frente (o motor entra por ultimo e fica na frente do Node velho).
+  local pastas="$bin"
+  local antiga
+  while IFS= read -r antiga; do
+    [ -n "$antiga" ] || continue
+    [ "$antiga" = "$bin" ] && continue
+    [ -d "$antiga" ] || continue
+    case ":${pastas}:" in *":${antiga}:"*) continue ;; esac
+    pastas="${pastas}:${antiga}"
+  done <<EOF
+$(awk '
+    /^# >>> auroq >>>$/ { dentro=1; next }
+    /^# <<< auroq <<<$/ { dentro=0; next }
+    dentro == 1 && /^export PATH="/ {
+      linha=$0
+      sub(/^export PATH="/, "", linha)
+      sub(/:\$PATH"$/, "", linha)
+      n=split(linha, partes, ":")
+      for (i=1; i<=n; i++) if (partes[i] != "") print partes[i]
+    }
+  ' "$arquivo" 2>/dev/null)
+EOF
   # tira o bloco antigo (se houver) e escreve o novo — nunca empilha
   awk '
     /^# >>> auroq >>>$/ { pulando=1; next }
@@ -253,8 +279,8 @@ auroq_aplicar_path() {
   ' "$arquivo" > "$tmp" 2>/dev/null || cp "$arquivo" "$tmp"
   {
     printf '# >>> auroq >>>\n'
-    printf '# Motor do Auroq OS. Bloco gerado pelo instalador — pode apagar se desinstalar.\n'
-    printf 'export PATH="%s:$PATH"\n' "$bin"
+    printf '# Motor e ferramentas do Auroq OS. Bloco gerado pelo instalador — pode apagar se desinstalar.\n'
+    printf 'export PATH="%s:$PATH"\n' "$pastas"
     printf '# <<< auroq <<<\n'
   } >> "$tmp"
   mv "$tmp" "$arquivo"

package/lib/onepassword.js

@@ -191,6 +191,19 @@ function persistToken(token) {
 
 // ─── Comando principal ───────────────────────────────────
 
+// Orientacao de escopo: o token fica salvo no computador e qualquer programa do
+// aluno consegue usa-lo, entao a Service Account deve alcancar so um cofre
+// dedicado. "Claude" e o cofre que os agentes do Auroq usam (ops.md).
+function accessTips() {
+  log(`${BOLD}Seguranca do token (recomendado):${RESET}`);
+  log('  - Crie a Service Account com acesso a UM cofre so, dedicado ao Auroq');
+  log(`    (o cofre ${CYAN}"Claude"${RESET}), sem suas senhas pessoais, de banco ou da empresa.`);
+  log('  - Permissao: so leitura. Se quiser que o Auroq guarde credenciais novas');
+  log('    pra voce nesse cofre, libere tambem escrita — mas so nesse cofre.');
+  log(`  ${DIM}- O token fica salvo neste computador e qualquer programa seu consegue usa-lo:${RESET}`);
+  log(`  ${DIM}  com o cofre dedicado, um vazamento so alcanca o que esta nele.${RESET}`);
+}
+
 async function connect() {
   console.log(`\n${PURPLE}${BOLD}  Conectar 1Password — Auroq OS${RESET}`);
 
@@ -223,6 +236,8 @@ async function connect() {
     log(`${BOLD}Como resolver:${RESET}`);
     log(`  1. Abra o 1Password e copie o seu token de Service Account (${CYAN}Ctrl/Cmd + C${RESET})`);
     log(`  2. ${BOLD}Sem copiar mais nada${RESET}, rode este comando de novo`);
+    log('');
+    accessTips();
     process.exit(1);
   }
   ok('Token encontrado (formato valido)');
@@ -258,6 +273,8 @@ ${GREEN}${BOLD}  ✅ 1Password conectado com sucesso.${RESET}
 ${DIM}  A conexao e permanente — voce nao precisa repetir este processo.${RESET}
 ${restartHint}
 `);
+  accessTips();
+  log('');
 }
 
 module.exports = {

package/lib/runtime-integrity.json

@@ -2,7 +2,7 @@
   "schema": 1,
   "algorithm": "sha256",
   "scope": "packaged-runtime-and-cascas",
-  "version": "2.6.3",
+  "version": "2.6.5",
   "files": [
     {
       "path": ".auroq-core/constitution.md",
@@ -10,7 +10,7 @@
     },
     {
       "path": ".auroq-core/core-config.yaml",
-      "sha256": "791b732e0e56651111feeec49d53bf4399bc2590c0c51d7ee2e8f3fd2ac54e24"
+      "sha256": "8134b48404278f57dd5fa423638a486ffc0b9d6fd8e0c8207ee0332e6ffc3456"
     },
     {
       "path": ".auroq-core/core/synapse/context/context-builder.js",
@@ -206,7 +206,7 @@
     },
     {
       "path": "bin/auroq-os.js",
-      "sha256": "167c9c92e3e247cfc61f8b9fcde69deec85debd8938181708d980142b45cef95"
+      "sha256": "f0cfd3e5434118c618a1a48b93902ff38eb70b340c44a5af13bcc7130b45c853"
     },
     {
       "path": "lib/ahi/client.mjs",
@@ -242,7 +242,7 @@
     },
     {
       "path": "lib/onepassword.js",
-      "sha256": "a65d425182e0698d3f80b8d81bb088b13c5e5b60ae1aa92b095ab38d60e22ea9"
+      "sha256": "e14a7b5347e46f48d7f319c010e019f503f206d6dee8a37455ae71c77bed2635"
     },
     {
       "path": "lib/supabase.js",
@@ -258,7 +258,7 @@
     },
     {
       "path": "package.json",
-      "sha256": "d26aeecec853f39b5b0a1c6a78a6a3bafe5ce025e310c6f0fbd3f05e4a7567bf"
+      "sha256": "687f311ba5fadb11f900e924d16ac3ec683f6459d3164907a008229621889444"
     },
     {
       "path": "scripts/build-pack.mjs",
@@ -282,7 +282,7 @@
     },
     {
       "path": "scripts/sync-codex-skills.mjs",
-      "sha256": "36e703e8d298a5fc4cff3a85828b93a5123ab9563eeb2808c30f23f3eefd58f8"
+      "sha256": "889394bcbf80aefeba49adf2f19202b47382324f3b1357063ca04b87ce46ddb2"
     },
     {
       "path": "scripts/validate-hybrid.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auroq-os",
-  "version": "2.6.3",
+  "version": "2.6.5",
   "arcaneMcpPin": "0.7.0",
   "description": "Auroq OS — Sistema Operacional de IA para Experts",
   "bin": {

package/scripts/sync-codex-skills.mjs

@@ -61,12 +61,48 @@ function summaryFromMarkdown(file) {
   return output.join(' ').replace(/\s+/g, ' ').replaceAll('"', "'") || 'Agente do Auroq OS.';
 }
 
+const avisos = [];
+
+// Comando oficial = `auroq-<nome>.md` ou o Ops. Numa colisao de nome ele vence; o
+// outro comando continua valendo no Claude/Grok e so fica sem skill no Codex.
+const oficial = (file) => /^auroq-/.test(path.basename(file)) || relative(file).startsWith('.claude/commands/AuroqOS/');
+
 function registerSkill(name, commandFile) {
-  if (!/^[a-z0-9-]+$/.test(name)) throw new Error(`Nome de skill invalido: ${name}`);
-  if (skills.has(name)) throw new Error(`Colisao de nome '${name}': ${relative(skills.get(name))} e ${relative(commandFile)}`);
+  if (!/^[a-z0-9-]+$/.test(name)) {
+    avisos.push(`Comando ${relative(commandFile)} ignorado no Codex: nome de skill invalido '${name}'.`);
+    return;
+  }
+  if (skills.has(name)) {
+    // Uma colisao (ex: companion.md de antes do prefixo auroq- ao lado de auroq-companion.md)
+    // derrubava o sync inteiro — e junto a skill $companion, que a manutencao exige.
+    const atual = skills.get(name);
+    const [fica, sai] = oficial(commandFile) && !oficial(atual) ? [commandFile, atual] : [atual, commandFile];
+    skills.set(name, fica);
+    avisos.push(`Colisao de nome '${name}': usando ${relative(fica)}; ${relative(sai)} continua valendo no Claude, sem skill propria no Codex.`);
+    return;
+  }
   skills.set(name, commandFile);
 }
 
+// O aluno da um nome ao Companion no bootstrap (FASE 10 do Ops: /atlas-companion).
+// Se o comando base sumiu, $companion continua existindo, apontando pro comando dele.
+function comandoDoCompanion(file) {
+  try {
+    const texto = fs.readFileSync(file, 'utf8');
+    return /recurso_id\s*`?companion`?/.test(texto) || /agents\/companion\//.test(texto);
+  } catch {
+    return false;
+  }
+}
+
+function garantirAliasCompanion() {
+  if (skills.has('companion')) return;
+  const candidatos = [...skills.entries()]
+    .filter(([name, file]) => name.endsWith('-companion') && comandoDoCompanion(file))
+    .sort(([a], [b]) => a.localeCompare(b));
+  if (candidatos.length) skills.set('companion', candidatos[0][1]);
+}
+
 function collectSkills() {
   const commandRoot = path.join(root, '.claude', 'commands');
   if (!fs.existsSync(commandRoot)) return;
@@ -88,6 +124,7 @@ function collectSkills() {
       registerSkill(kebab(file.replace(/\.md$/, '')), path.join(coreAgents, file));
     }
   }
+  garantirAliasCompanion();
 }
 
 function skillContent(name, commandFile, outRoot) {
@@ -139,13 +176,20 @@ function readOwner(dir) {
     // Mesma pasta de projeto = mesmo dono, mesmo que o name do package tenha
     // mudado depois (ex: marcador gerado antes do package.json existir).
     if (data.sourceRoot && path.resolve(data.sourceRoot) === root) return { kind: 'owned', data };
+    // .agents/skills mora DENTRO do projeto: marcador do nosso gerador com outro caminho
+    // e a mesma pasta de negocio movida, copiada ou vinda de outra maquina. Tratar como
+    // estranho travava o sync inteiro (e com ele a skill $companion) pra sempre.
+    if (path.dirname(dir) === localOut && data.schema === 2 && data.projectId) return { kind: 'owned', data, movido: true };
     return { kind: 'foreign', data };
   } catch {
     return { kind: 'foreign', data: { invalidMarker: true } };
   }
 }
 
-function assertNoCollisions(outRoot) {
+// Local: pasta de skill sem o nosso marcador e do aluno — fica como esta, com aviso,
+// e o resto do sync segue. Global (~/.agents/skills, dividido entre projetos): recusa tudo.
+function collisions(outRoot) {
+  const preservadas = new Set();
   for (const [name, commandFile] of skills) {
     const dir = path.join(outRoot, name);
     if (!fs.existsSync(dir)) continue;
@@ -155,8 +199,15 @@ function assertNoCollisions(outRoot) {
     if (adoptLegacy && owner.kind === 'foreign' && owner.data?.projectName === projectName) continue;
     const existing = path.join(dir, 'SKILL.md');
     if (owner.kind === 'legacy' && fs.existsSync(existing) && fs.readFileSync(existing, 'utf8') === skillContent(name, commandFile, outRoot)) continue;
+    if (outRoot === localOut && owner.kind === 'legacy') continue;
+    if (outRoot === localOut) {
+      preservadas.add(name);
+      continue;
+    }
     throw new Error(`Recusando sobrescrever ${dir}; ownership: ${owner.kind}.`);
   }
+  for (const name of preservadas) avisos.push(`Skill ${name} em ${relative(path.join(outRoot, name))} nao foi gerada por este sync: mantida como esta.`);
+  return preservadas;
 }
 
 function inspect(outRoot) {
@@ -168,7 +219,9 @@ function inspect(outRoot) {
       issues.push(`Skill ausente: ${name}`);
       continue;
     }
-    if (readOwner(dir).kind !== 'owned') issues.push(`Ownership invalido: ${name}`);
+    const owner = readOwner(dir);
+    if (outRoot === localOut && owner.kind === 'unmanaged') continue; // skill do aluno, preservada
+    if (owner.kind !== 'owned' || owner.movido) issues.push(`Ownership invalido: ${name}`);
     const file = path.join(dir, 'SKILL.md');
     if (!fs.existsSync(file) || fs.readFileSync(file, 'utf8') !== skillContent(name, commandFile, outRoot)) {
       issues.push(`Drift de conteudo: ${name}`);
@@ -183,16 +236,18 @@ function inspect(outRoot) {
 
 function sync(outRoot) {
   ensureDir(outRoot);
-  assertNoCollisions(outRoot);
+  const preservadas = collisions(outRoot);
   const stage = fs.mkdtempSync(path.join(outRoot, '.auroq-stage-'));
   try {
     for (const [name, commandFile] of skills) {
+      if (preservadas.has(name)) continue;
       const dir = path.join(stage, name);
       ensureDir(dir);
       fs.writeFileSync(path.join(dir, markerFile), marker, 'utf8');
       fs.writeFileSync(path.join(dir, 'SKILL.md'), skillContent(name, commandFile, outRoot), 'utf8');
     }
     for (const name of skills.keys()) {
+      if (preservadas.has(name)) continue;
       const target = path.join(outRoot, name);
       fs.rmSync(target, { recursive: true, force: true });
       fs.renameSync(path.join(stage, name), target);
@@ -237,6 +292,11 @@ Padrao      gera skills locais em .agents/skills (recomendado)
 collectSkills();
 if (targets.includes(localOut)) cleanLegacyLocalLocation();
 
+const mostrarAvisos = () => {
+  for (const aviso of new Set(avisos)) console.error(`Aviso: ${aviso}`);
+  avisos.length = 0;
+};
+
 for (const target of targets) {
   if (check) {
     const issues = inspect(target);
@@ -247,10 +307,11 @@ for (const target of targets) {
       console.log(`Auroq: ${skills.size} skills verificadas em ${target}`);
     }
   } else if (dryRun) {
-    if (fs.existsSync(target)) assertNoCollisions(target);
+    if (fs.existsSync(target)) collisions(target);
     console.log(`Auroq: ${skills.size} skills validadas para ${target}`);
   } else {
     sync(target);
     console.log(`Auroq: ${skills.size} skills sincronizadas em ${target}`);
   }
+  mostrarAvisos();
 }