auroq-os 2.6.3 → 2.6.4

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

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

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## 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

@@ -241,13 +241,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.4 doctor` mostra a fila local segura e os comandos pinados de
+manutencao/diagnostico. `npx -y auroq-os@2.6.4 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.4; 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

@@ -398,6 +398,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 +520,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 +557,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 +1994,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

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.4 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.4 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.4 "$@"
   else
-    npx -y auroq-os@2.6.3 "$@" < /dev/tty
+    npx -y auroq-os@2.6.4 "$@" < /dev/tty
   fi
 }
 

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.4",
   "files": [
     {
       "path": ".auroq-core/constitution.md",
@@ -10,7 +10,7 @@
     },
     {
       "path": ".auroq-core/core-config.yaml",
-      "sha256": "791b732e0e56651111feeec49d53bf4399bc2590c0c51d7ee2e8f3fd2ac54e24"
+      "sha256": "3052aab9e21a7b36788f5141a7d34ce6baa87c482ac18762c306b84b24ffc5c9"
     },
     {
       "path": ".auroq-core/core/synapse/context/context-builder.js",
@@ -206,7 +206,7 @@
     },
     {
       "path": "bin/auroq-os.js",
-      "sha256": "167c9c92e3e247cfc61f8b9fcde69deec85debd8938181708d980142b45cef95"
+      "sha256": "7a9fd719e1ddc2fb18000b9f237ec2fdb0b605ed111c6e58dccef890f2d68cb1"
     },
     {
       "path": "lib/ahi/client.mjs",
@@ -258,7 +258,7 @@
     },
     {
       "path": "package.json",
-      "sha256": "d26aeecec853f39b5b0a1c6a78a6a3bafe5ce025e310c6f0fbd3f05e4a7567bf"
+      "sha256": "9c2cafc77bfc679534da059fbcb7a847ca284da5d9074e138308d329aa6aef76"
     },
     {
       "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.4",
   "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();
 }