auroq-os 2.4.8 → 2.4.10

package/.auroq-core/core/synapse/engine.js

@@ -22,6 +22,7 @@ const {
   needsHandoffWarning,
 } = require('./context/context-tracker');
 const { buildLayerContext } = require('./context/context-builder');
+const { parseManifest } = require('./domain/domain-loader');
 
 const { formatSynapseRules } = require('./output/formatter');
 const { MemoryBridge } = require('./memory/memory-bridge');
@@ -196,7 +197,22 @@ class SynapseEngine {
    */
   constructor(synapsePath, config = {}) {
     this.synapsePath = synapsePath;
-    this.config = config;
+
+    // The manifest is what L2/L5 use to resolve an active agent/squad to its
+    // domain file. When the caller does not pass one (the hook never did),
+    // parse it here — otherwise those layers silently produce nothing.
+    let manifest = config.manifest;
+    if (!manifest || Object.keys(manifest).length === 0) {
+      try {
+        const parsed = parseManifest(path.join(synapsePath, 'manifest'));
+        manifest = parsed;
+      } catch (err) {
+        console.warn(`[synapse:engine] Failed to parse manifest: ${err.message}`);
+        manifest = {};
+      }
+    }
+
+    this.config = { ...config, manifest };
 
     /** @type {Array<import('./layers/layer-processor')>} */
     this.layers = [];

package/.auroq-core/core/synapse/output/formatter.js

@@ -120,7 +120,7 @@ function formatAgent(result) {
   if (result.rules.length > 0) {
     lines.push('  RULES:');
     result.rules.forEach((rule, i) => {
-      lines.push(`    ${i}. ${rule}`);
+      lines.push(`    ${i + 1}. ${rule}`);
     });
   }
 
@@ -146,7 +146,7 @@ function formatWorkflow(result) {
   if (result.rules.length > 0) {
     lines.push('  RULES:');
     result.rules.forEach((rule, i) => {
-      lines.push(`    ${i}. ${rule}`);
+      lines.push(`    ${i + 1}. ${rule}`);
     });
   }
 
@@ -234,7 +234,7 @@ function formatStarCommands(result) {
   ];
 
   result.rules.forEach((rule, i) => {
-    lines.push(`  ${i}. ${rule}`);
+    lines.push(`  ${i + 1}. ${rule}`);
   });
 
   lines.push('============================================================');
@@ -366,7 +366,12 @@ function formatSummary(results, _metrics) {
   for (const result of results) {
     if (!result || !result.rules || result.rules.length === 0) continue;
     const meta = result.metadata || {};
-    const source = (meta.source || meta.domain || 'unknown').toUpperCase();
+    // Layers may report a single `source` or a list of `sources` (e.g. L1
+    // combines global + context). Accept both so the summary never says UNKNOWN.
+    const rawSource = Array.isArray(meta.sources) && meta.sources.length > 0
+      ? meta.sources.join('+')
+      : (meta.source || meta.domain || 'unknown');
+    const source = String(rawSource).toUpperCase();
     const reason = meta.activationReason || meta.reason || 'active layer';
     lines.push(`    [${source}] ${reason} (${result.rules.length} rules)`);
   }

package/.auroq-core/core/synapse/runtime/hook-runtime.js

@@ -81,12 +81,18 @@ function resolveHookRuntime(input) {
 
 /**
  * Normalize hook output payload shape.
+ *
+ * `hookEventName` is REQUIRED by Claude Code — without it the whole payload is
+ * rejected and `additionalContext` never reaches the model.
+ *
  * @param {string} xml
- * @returns {{hookSpecificOutput: {additionalContext: string}}}
+ * @param {string} [eventName] - Hook event name (default: 'UserPromptSubmit')
+ * @returns {{hookSpecificOutput: {hookEventName: string, additionalContext: string}}}
  */
-function buildHookOutput(xml) {
+function buildHookOutput(xml, eventName) {
   return {
     hookSpecificOutput: {
+      hookEventName: eventName || 'UserPromptSubmit',
       additionalContext: xml || '',
     },
   };

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

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

package/.claude/rules/puxar-e-entregar.md

@@ -33,7 +33,7 @@ concluida, decisao importante tomada, antes de fechar o computador.
 
 Leia as secoes `*commit`, `*pre-push` e `*sync` do ops.md e execute os passos como estao. O minimo inegociavel:
 
-- **SALVAR:** revisar o que mudou → conferir tracker/contexto → mensagem em linguagem de negocio → `git add` dos arquivos relevantes (NUNCA `business/vault/`, `.env`, chaves) → commit → confirmar ao expert em 1 linha.
+- **SALVAR:** revisar o que mudou → conferir tracker/contexto → mensagem em linguagem de negocio → **mostrar a lista do que vai entrar e ter o OK do expert** (regra 7) → `git add` SO desses arquivos, um a um (NUNCA `git add -A`/`git add .`, NUNCA `business/vault/`, `.env`, chaves) → commit → confirmar ao expert em 1 linha.
 - **ENTREGAR:** pre-push OBRIGATORIO (vault/.env fora do staging, `.gitignore` protege, nenhum arquivo gigante, branch certa) → `git push` → confirmar.
 - **PUXAR:** se ha trabalho local, SALVAR primeiro (commit antes de pull, sempre) → `git fetch` → `git pull` (merge — nunca rebase com o expert) → relatar em portugues o que chegou (autor + o que fez) → conflito: conduzir com o expert, mostrando as duas versoes; em `agents/companion/data/` a resposta quase sempre e juntar as duas.
 
@@ -45,3 +45,15 @@ Leia as secoes `*commit`, `*pre-push` e `*sync` do ops.md e execute os passos co
 4. Continua EXCLUSIVO do Ops: `git push --force`, Pull Request (`gh pr`), MCP/infra, bootstrap, `*update`.
 5. O hook de abertura (`.claude/hooks/auroq-sync.cjs`) ja puxou o que era seguro e pode ter deixado um aviso no contexto (atualizacoes esperando, trabalho pendente). Repasse ao expert em 1-2 linhas, sem drama, e siga.
 6. O lembrete de trabalho nao entregue chega no contexto no maximo a cada 30 min: ofereca "salva e entrega" em UMA linha ao fechar o bloco — nunca interrompa o raciocinio em andamento.
+7. **A pasta e compartilhada; a conversa nao.** Outras janelas, agentes e squads escrevem
+   na mesma pasta, entao `git status` mostra trabalho que NAO e desta conversa — e um `git
+   add -A` publica isso pela metade, dentro de um commit com nome de outro assunto. Antes
+   de salvar, SEMPRE:
+   - rodar `git status --short` e separar o que ESTA conversa tocou do resto;
+   - mostrar ao expert a lista agrupada por assunto, em linguagem comum (nome do arquivo
+     nao basta: diga o que e). Ex: *"Vai entrar: a pagina de vendas que a gente fez agora.
+     Encontrei tambem 12 arquivos de financas, que nao sao deste assunto — parecem de outra
+     conversa sua."*;
+   - perguntar em UMA linha: *"salvo so o nosso, ou tudo junto?"* — e obedecer a resposta;
+   - na duvida, ou se ele nao responder, salvar SO o que esta conversa tocou. Deixar o resto
+     parado nunca perde nada: fica no lugar, esperando a conversa dona dele.

package/.synapse/agent-companion

@@ -0,0 +1,9 @@
+# SYNAPSE Agent Domain (L2) — Companion
+# Fonte: agents/companion/agents/companion.md (IDENTIDADE, PERSONALIDADE, ESTILO)
+
+COMPANION_RULE_1=Parceiro que manja — nunca guru, nunca servo. Verdade acima de validacao
+COMPANION_RULE_2=Confrontar quando necessario; se o expert esta dispersando, avisar
+COMPANION_RULE_3=Fundamentar em contexto real do projeto — nunca inventar para preencher lacuna
+COMPANION_RULE_4=Opcoes numeradas quando houver mais de um caminho real
+COMPANION_RULE_5=Ser transparente sobre o que sabe e o que nao sabe
+COMPANION_RULE_6=Ciclo operacional: Situar > Priorizar > Executar > Documentar > Refinar

package/.synapse/agent-ops

@@ -0,0 +1,10 @@
+# SYNAPSE Agent Domain (L2) — Ops
+# Fonte: .claude/commands/AuroqOS/agents/ops.md (CRITICAL — OPS FAZ, EXPERT APROVA / LINGUAGEM)
+
+OPS_RULE_1=O Ops FAZ sozinho sempre que possivel; o expert so aprova, loga no browser e decide
+OPS_RULE_2=O expert e leigo em tecnologia — nunca assumir que ele sabe o que e terminal, CLI ou auth
+OPS_RULE_3=Quando o expert precisar agir, dar receita de bolo: o que fazer, o que colar, o que vai aparecer, como saber que deu certo
+OPS_RULE_4=Uma fase por vez; so avancar quando os checks da fase atual passarem de verdade
+OPS_RULE_5=Detectar o sistema operacional antes de instalar e nunca misturar comandos de Mac e Windows
+OPS_RULE_6=Nunca pedir segredo colado no chat; credencial vai para o 1Password ou para o vault local fora do git
+OPS_RULE_7=O corpo do Bootstrap vem do MCP arcane — se a tool falhar, mostrar a mensagem e parar, nunca improvisar de memoria

package/.synapse/agent-organizer

@@ -0,0 +1,9 @@
+# SYNAPSE Agent Domain (L2) — Organizer
+# Fonte: agents/organizer/agents/organizer.md (PRINCIPIOS INEGOCIAVEIS)
+
+ORGANIZER_RULE_1=Organizacao que nao serve acao e decoracao — se nao ajuda a FAZER, nao tem valor
+ORGANIZER_RULE_2=Quase tudo e ruido, pouquissimo e vital: filtros rigorosos sao inegociaveis
+ORGANIZER_RULE_3=Diagnosticar antes de prescrever — nunca sugerir sem entender primeiro
+ORGANIZER_RULE_4=Sistema previsivel que o expert USA vale mais que sistema perfeito que vira arquivo morto
+ORGANIZER_RULE_5=NUNCA mover ou apagar sem aprovacao explicita do expert
+ORGANIZER_RULE_6=NUNCA mexer no vault sem permissao e NUNCA modificar .auroq-core/

package/.synapse/context

@@ -1,7 +1,7 @@
 # SYNAPSE Context Domain (L1)
 # Dynamic context loaded on every prompt
 
-CONTEXT_FRAMEWORK=Auroq OS v1.0.0 — Sistema Operacional de IA para Experts
+CONTEXT_FRAMEWORK=Auroq OS — Sistema Operacional de IA para Experts
 CONTEXT_PHILOSOPHY=Pensar, Fazer e Lembrar com IA. Expert manda e julga, IA executa
 CONTEXT_FORMULA=Repertorio + IA = Resultado
 CONTEXT_CYCLE=Situar > Priorizar > Executar > Documentar > Refinar

package/.synapse/manifest

@@ -8,29 +8,21 @@ CONSTITUTION_ALWAYS_ON=true
 CONSTITUTION_NON_NEGOTIABLE=true
 
 # Global rules (L1) — always loaded
-GLOBAL_RULES_STATE=active
-GLOBAL_RULES_ALWAYS_ON=true
+GLOBAL_STATE=active
+GLOBAL_ALWAYS_ON=true
 
 # Global context (L1) — always loaded
-GLOBAL_CONTEXT_STATE=active
-GLOBAL_CONTEXT_ALWAYS_ON=true
+CONTEXT_STATE=active
+CONTEXT_ALWAYS_ON=true
 
 # Agent: Companion
 AGENT_COMPANION_STATE=active
 AGENT_COMPANION_AGENT_TRIGGER=companion
 
-# Agent: Aurora (auroq-master)
-AGENT_AUROQ_MASTER_STATE=active
-AGENT_AUROQ_MASTER_AGENT_TRIGGER=auroq-master
-
 # Agent: Ops
 AGENT_OPS_STATE=active
 AGENT_OPS_AGENT_TRIGGER=ops
 
-# Agent: Atlas (analyst)
-AGENT_ANALYST_STATE=active
-AGENT_ANALYST_AGENT_TRIGGER=analyst
-
 # Agent: Organizer
 AGENT_ORGANIZER_STATE=active
 AGENT_ORGANIZER_AGENT_TRIGGER=organizer

package/.synapse/squad-clone-forge

@@ -0,0 +1,6 @@
+# SYNAPSE Squad Domain (L5) — Clone Forge
+# Fonte: agents/clone-forge/README.md (pipeline, quality gates)
+
+CLONE_FORGE_RULE_1=Clonagem cognitiva preserva voz, heuristicas e estilo de decisao do expert — fidelidade acima de fluencia
+CLONE_FORGE_RULE_2=Seguir as fases do pipeline em ordem, respeitando os quality gates de cada uma
+CLONE_FORGE_RULE_3=Modo completo tem 11 fases e modo rapido tem 5 — nunca misturar nem pular fase sem declarar

package/.synapse/squad-etlmaker

@@ -0,0 +1,7 @@
+# SYNAPSE Squad Domain (L5) — ETLmaker
+# Fonte: agents/etlmaker/skill.md (activation-instructions)
+
+ETLMAKER_RULE_1=SEMPRE responder em portugues brasileiro, casual e direto
+ETLMAKER_RULE_2=Ao executar tasks de dependencias, seguir as instrucoes da task exatamente
+ETLMAKER_RULE_3=Tasks com elicit=true exigem interacao real do expert — nunca preencher por ele
+ETLMAKER_RULE_4=Carregar arquivo de dependencia apenas quando o expert pedir a execucao do comando

package/.synapse/squad-mind-forge

@@ -0,0 +1,5 @@
+# SYNAPSE Squad Domain (L5) — Mind Forge
+# Fonte: agents/mind-forge/skill.md
+
+MIND_FORGE_RULE_1=Fabrica de mentes sinteticas e consultores — adotar a persona de forge-chief antes de agir
+MIND_FORGE_RULE_2=A persona e a task de start sao a unica fonte de verdade; seguir exatamente como escritas

package/.synapse/squad-squad-forge

@@ -0,0 +1,7 @@
+# SYNAPSE Squad Domain (L5) — Squad Forge
+# Fonte: agents/squad-forge/README.md (pipeline, modos, hard gates)
+
+SQUAD_FORGE_RULE_1=Extracao profunda com 8 lentes iterativas antes de montar qualquer squad
+SQUAD_FORGE_RULE_2=Playback validation obrigatorio: devolver o processo entendido ao expert antes de construir
+SQUAD_FORGE_RULE_3=Hard gates de profundidade — squad raso nao passa para instalacao
+SQUAD_FORGE_RULE_4=Seguir o pipeline em ordem: Setup > Extracao > Playback > Arquitetura > Montagem > Validacao e Instalacao

package/.synapse/squad-worker-forge

@@ -0,0 +1,5 @@
+# SYNAPSE Squad Domain (L5) — Worker Forge
+# Fonte: agents/worker-forge/skill.md
+
+WORKER_FORGE_RULE_1=Transforma descricao de cargo em worker operacional com KB viva que cresce a cada missao
+WORKER_FORGE_RULE_2=Adotar a persona de worker-chief e seguir a task de start exatamente como escritas

package/CHANGELOG.md

@@ -0,0 +1,461 @@
+# Changelog
+
+## [2.4.10] — 2026-09-02
+
+### O Synapse voltou a existir
+Um aluno reportou o aviso `UserPromptSubmit hook error`. A auditoria mostrou que o
+aviso era so o sintoma: o Synapse — a camada que reforca as regras do sistema e do
+agente ativo a cada mensagem — nunca funcionou em nenhuma versao publicada. Eram tres
+falhas em serie.
+
+- **O pacote de regras ia sem etiqueta.** Faltava o campo `hookEventName`, obrigatorio,
+  e o Claude Code recusava o payload inteiro. Nada chegava ao modelo — a conta era zero,
+  nao parcial.
+- **O motor nunca lia o proprio indice.** A engine so usava o manifesto se o chamador
+  passasse um, e o hook nunca passou. Com indice vazio, as camadas de agente (L2) e de
+  squad (L5) nao resolviam o dominio e produziam zero regras. Sobravam a Constituicao e
+  as regras globais, essas por acaso — tinham caminho fixo no codigo.
+- **O indice apontava para o vazio.** 12 dos 13 dominios declarados nao tinham arquivo,
+  com nomes descasados dos que existem em disco, mais dois agentes fantasma
+  (`auroq-master`, `analyst`) que nao existem no Auroq OS.
+
+Agora o indice bate com a realidade (11/11 no diagnostico, era 1/13) e os dominios dos
+tres agentes core e dos cinco meta-squads existem, escritos a partir dos principios que
+ja estavam dentro de cada agente. O resumo tambem parou de rotular tudo como `[UNKNOWN]`.
+
+### O Bootstrap 2 parou de cobrar caro pelo Google Drive
+O passo se chamava "Google Drive conectado" e nao conectava conector nenhum: instalava o
+rclone, que serve a UMA funcao (o `*backup` do Organizer). O aluno passava pelo pedaco
+mais chato da instalacao — terminal separado, configuracao interativa — achando que tinha
+ganhado Drive no dia a dia, e nao tinha.
+
+- **Conector oficial virou o padrao.** Clique no navegador, resolve ler, criar, buscar e
+  compartilhar arquivo. E agora o Ops pergunta com qual conta Google conectar, em vez de
+  pegar a que estiver logada no navegador.
+- **rclone virou opcional declarado**, oferecido so a quem quer espelhar pastas inteiras,
+  baixar arquivo grande que o conector recusa ou conferir integridade do backup.
+- **O `*health` parou de contar rclone como pendencia.** Quem nao tem esta correto.
+
+### O aviso de "saiu versao nova" que nunca calava
+`core-config.yaml` estava congelado em 2.4.3 desde a 2.4.7. Como o hook de sync compara
+essa versao com a do npm, todo aluno ja atualizado via o aviso de versao nova todo dia,
+para sempre — e alguns reinstalavam por causa disso. O `prepack` agora sincroniza a
+versao sozinho, entao nao desatualiza de novo.
+
+## [2.4.9] — 2026-09-01
+
+### Salvar nunca mais leva junto o trabalho de outra conversa
+A pasta do negocio e compartilhada entre janelas, agentes e squads, mas o ritual de
+commit so pedia "adicionar os arquivos relevantes" — sem definir relevante e sem nada
+preso ao escopo da conversa. Na pratica virava um `git add -A`: o expert aprovava a
+MENSAGEM do commit e nunca via a LISTA de arquivos, entao trabalho pela metade de outra
+sessao subia dentro de um commit com nome de outro assunto. Reportado por uma aluna e
+reproduzido aqui (60 arquivos de outra frente quase entraram num commit de documentacao).
+
+- **Antes de salvar, o agente mostra o que vai entrar.** Ele separa o que a conversa
+  atual tocou do resto, apresenta a lista em linguagem comum ("vai entrar a pagina de
+  vendas; achei tambem 12 arquivos de financas, que parecem de outra conversa sua") e
+  pergunta: "salvo so o nosso, ou tudo junto?". Sem nada de fora, nao pergunta nada.
+- **Na duvida, salva so o da conversa.** Deixar o resto parado nunca perde trabalho —
+  fica no lugar, esperando a conversa dona dele. O erro caro e o contrario.
+- **`git add -A` e `git add .` proibidos** no ritual; adicao caminho por caminho,
+  conferencia do que ficou preparado antes de fechar e commit por pathspec quando o
+  resto e de terceiros (o que outra sessao preparou fica intocado).
+- Vale pra TODOS os agentes, nao so o Ops: a mesma protecao entrou na rule
+  `puxar-e-entregar.md`, porque hoje o Companion e os squads tambem atendem
+  "salva e entrega".
+
+
+## [2.4.8] — 2026-09-01
+
+### Enxugamento das rules — menos instrucao repetida em toda sessao
+Contexto: a Anthropic cortou 80% do system prompt do Claude Code (02/07/2026) e
+publicou o motivo — regra repetida e exemplo pronto estreitam a decisao dos modelos
+novos em vez de melhora-la. As rules do Auroq carregam em TODA sessao, no Claude e no
+Grok (que le `.claude/rules/` do mesmo jeito), entao duplicacao ali custa em toda
+conversa do aluno.
+
+- **`commit-inteligente.md` absorvido por `puxar-e-entregar.md`:** os dois ensinavam o
+  mesmo ritual de salvar/entregar, e o passo a passo completo ja vive no `ops.md`, que
+  e a fonte da verdade. As travas do pre-push (vault, `.env`, chaves) continuam
+  intactas — isso e seguranca, nao repeticao.
+- **`agent-handoff.md` removido:** protocolo de compactacao que nada executava; o que
+  importa (levar so o resumo, nunca a persona do agente anterior) esta no
+  `dna-operacional.md`.
+- **"Salve antes da compactacao de contexto" estava em tres arquivos.** Agora mora so
+  no `dna-operacional.md` (Session Management).
+- **`natural-language-first.md` sem os blocos longos de exemplo ERRADO/CERTO:** a regra
+  continua inteira, o exemplo que so ocupava espaco saiu.
+- **`agent-authority.md` enxuto:** as exclusividades reais do Ops em duas linhas, no
+  lugar de sete tabelas.
+- **O `init` agora apaga rules aposentadas.** Ele sempre sobrescreveu o que estava na
+  lista, mas nunca apagava o que saia dela — quem ja tinha instalado ficaria com a
+  regra velha convivendo com a nova. Coberto por `tests/rules-aposentadas.test.mjs`.
+
+Resultado, medido na maquina (upgrade real 2.4.7 -> 2.4.8): o que carrega em toda
+sessao caiu de 26.982 para 18.792 caracteres (-30%).
+Nenhuma regra de seguranca, de licenciamento (carve-out Arcane) ou do aluno
+(`custom-do-aluno.md`) foi tocada.
+
+## [2.4.7] — 2026-09-01
+
+### Fix
+- Dica da senha corrigida: a tela mostra asteriscos (ou nada, dependendo da janela) — a versao 2.4.6 dizia que nada aparecia.
+
+## [2.4.6] — 2026-09-01
+
+### Fix — semana de campo: /euriler existia na aula, nao no disco
+- **Atalhos do Pack Arcane no disco:** `/euriler`, `/trafegoArcane` e os demais 16 atalhos do Pack agora viajam no pacote e o `init` os instala. O conteudo continua chegando ao vivo pelo MCP — mas sem o arquivo do atalho, o Claude Code respondia "Unknown command" mesmo com MCP conectado e licenca ativa. Copiados SO SE NAO EXISTEM: aluno antigo com a versao completa local (vitalicia) nunca e sobrescrito (EMB-019).
+- **Ops destrava sem atalho:** quando `/euriler` nao existe, o Ops ativa o Clone direto pela tool `squad_ativar` (tabela atalho ↔ recurso_id na secao PACK ARCANE) e so entao oferece o update. Diagnostico do Pack passa SEMPRE por `auroq-os doctor` / MCP `arcane` — nunca por Vercel/Cloudflare/Playwright.
+- **A janela do Windows parava de fechar sozinha:** rodando por `irm | iex`, qualquer `exit` do instalador fechava a janela inteira do PowerShell antes de o aluno ler a mensagem (seis relatos em uma semana — inclusive quem so estava reinstalando e via a janela "cair" ao digitar o nome). Toda parada agora mantem a janela aberta; o `exit` com codigo continua valendo quando o script roda de arquivo (CI e testes).
+- **Nome de pasta com espaco, acento ou maiuscula e ajustado, nao recusado:** "Fevo Ecossistema" vira `fevo-ecossistema`, com aviso na tela. Nos dois instaladores (Mac e Windows).
+- **Reinstalacao virou confirmacao:** quem roda o instalador de novo com o Auroq ja montado recebe "voce ja tinha instalado" + os proximos passos prontos pra colar, em vez de um aviso seco que sumia com a janela.
+- **Senha do login avisada:** a tela do login agora diz que a senha nao aparece enquanto digita — metade dos chamados de "nao estou conseguindo digitar" era so isso.
+- **`*update-auroq` com consentimento pro aluno antigo (EMB-019):** projeto sem conteudo ao vivo so migra depois de um SIM explicito, com a troca explicada em linguagem comum. Nada de empurrar a migracao.
+
+## [2.4.5] — 2026-09-01
+
+### Fix — a travessia do aluno antigo virou caminho único
+- O `*update-auroq` das versões antigas manda ler a lista ATUALIZA no ops.md do pacote novo — que hoje é um ponteiro pro MCP. Um Ops antigo podia tentar a tool (que o projeto dele ainda não tem) e parar no meio. O ponteiro agora traz a instrução de migração explícita: fallback determinístico via `init` do pacote baixado, que preserva os dados e registra o conteúdo ao vivo.
+
+## [2.4.4] — 2026-09-01
+
+### Feat — quem esta em versao antiga descobre e migra sem quebrar nada
+- **Aviso automatico de versao nova:** ao abrir o Claude Code no projeto, o sistema compara a versao instalada com a do npm (1x por dia, silencioso quando esta em dia) e oferece o update. Ninguem mais descobre versao nova por acaso.
+- **`auroq-os register-mcp`:** comando novo que reescreve o registro do conteudo ao vivo (`.mcp.json` + `.codex/config.toml`). E o que faltava pra projeto antigo migrar pelo `*update` sem ficar com Companion mudo: o `*update-auroq` agora registra o MCP como passo obrigatorio e fecha com `auroq-os doctor` — so encerra com o diagnostico limpo.
+- **`*update-auroq` mostra o que mudou:** antes de aplicar, o Ops resume o CHANGELOG da versao nova em linguagem comum.
+- **README ganhou as secoes "Conteudo ao vivo" e "Atualizar o sistema":** o que mora no computador vs o que chega ao vivo pelo MCP `arcane`, como atualizar com uma frase e a garantia de que os dados do expert nunca sao tocados.
+
+## [2.4.3] — 2026-08-27
+
+### Fix — Ops pedia zip do Pack Arcane
+- O Pack da mentoria chega ao vivo. `*install-pack` e `*update-packarcane` nao pedem mais zip, path nem `npx arcane-pack`. A prova e `/euriler` (Codex: `$euriler`) + oi.
+- A casca ganhou a mesma regra, e ela vence se o MCP ainda estiver velho.
+- Catalogo vivo `auroq-core@2.3.3` republicado em 28/08 (EMB-018): o 2.3.2 ainda servia o `*install-pack` antigo.
+
+## [2.4.2] — 2026-08-27
+
+### Fix — piloto Windows real (Marcos)
+- **`npx.ps1` barrado pela politica do Windows.** O PowerShell resolve `.ps1` antes de `.cmd`. Chamado pelado, `npx` vira `npx.ps1` e a politica padrao recusa abrir arquivo de script. A instalacao morria logo depois de baixar o motor. Conserto: chamar `npx.cmd` (funcao `Get-AuroqNpx`). **Nao** se mexe na execution policy (ADR-3).
+- **`claude` nao respondia depois da parada 1.** O Claude Code se instala em `%USERPROFILE%\.local\bin` (e `~/.local/bin` no Mac) e nao publica a pasta. O instalador agora coloca essa pasta no PATH do usuario quando o binario existe.
+- **O fecho pedia "abra a pasta".** Numa janela de texto isso nao quer dizer nada. Agora imprime o `cd` pronto pra colar, depois `claude`/`codex`, depois o Ops.
+- **`core-config.yaml` mentia a versao.** Toda instalacao nova jurava ser 2.2.4, a versao do arquivo modelo. O `init` carimba a versao do pacote e a data de hoje.
+
+## [2.4.0] — 2026-08-27
+
+### Feat — Embarque em 2 passos: instalador proprio
+- **`installer/install.sh` e `installer/install.ps1`:** um endereco (`arka.education/install.sh` / `.ps1`) instala Git, motor do sistema, login da mentoria, pasta do negocio e `init`. Sem `sudo`, sem Administrador, sem `Set-ExecutionPolicy`, sem `mkdir`/`cd` na mao. Bash 3.2 e PowerShell 5.1 — o que vem de fabrica na maquina do aluno.
+- **Catalogo de falhas completo:** maquina velha, disco cheio, sem internet, PowerShell x86, janela da Apple fechada no meio, winget ausente, permissao negada, download corrompido (SHA256 conferido), antivirus, pasta ja ocupada, terminal que nao aceita resposta. Toda falha diz o que aconteceu, o que fazer agora e o contato do suporte.
+- **Motor visivel pra quem abre pelo icone:** o bloco de ambiente vai pros dois perfis (`~/.zshrc` e `~/.zprofile`) no Mac e pro ambiente do usuario no Windows. Era a falha silenciosa do projeto — no terminal funcionava, no app nao, e ninguem via erro.
+- **`auroq-os doctor` mais fundo:** informa a origem do motor (Auroq, Homebrew, nvm, sistema) e responde se o programa aberto pelo icone vai enxergar ele. Nao acusa quem ja tinha Homebrew ou nvm declarado no perfil.
+- **`auroq-os init --pasta <nome>`:** cria a pasta e instala dentro dela, pra quem nao pode depender de um `cd`.
+- **`~/.auroq/install.log`:** registro pro suporte, uma linha por evento. Sem e-mail, sem senha, sem token.
+- **`lib/diagnostico.js`:** as decisoes do doctor viraram funcoes puras e testadas.
+
+### Feat — Bootstrap 1 para de refazer o que o instalador ja fez
+- **FASE 0 nova ("de onde voce veio"):** o Ops le `~/.auroq/install.log` e pula Git e motor quando o instalador ja resolveu. Sem o arquivo (aluno antigo), segue como sempre foi.
+- **FASE 1 emendada:** Homebrew deixa de ser o passo 1 obrigatorio (so entra quando alguma ferramenta pedir); motor minimo sobe de 18 pra 20 e o Ops **nao instala um segundo** quando ja existe um que serve; Python deixa de bloquear quem nao vai rodar transcricao local.
+
+### Fix — o portao de acesso e a conversa com o aluno (auditoria de 27/08)
+- **O passo do login nao gateava nada.** Ele perguntava `auroq-os whoami` e lia o codigo de saida como "ja esta logado" — mas o `whoami` imprimia "Nao autenticado" e saia com **sucesso**. Numa maquina nova de verdade (o unico caso que importa), o instalador dizia "voce ja estava logado" pra quem nunca logou, pulava o portao, criava a pasta do negocio no disco e so entao morria dentro do `init`. O portao virou `check-access`, que confere o contrato online antes de qualquer coisa ser criada.
+- **`whoami` passa a dizer a verdade no codigo de saida:** 0 so com sessao salva e ultimo status `ativo`.
+- **As perguntas voltaram a ser do aluno.** Por `curl | bash`, a entrada padrao do script — e de todo programa que ele chama — e o proprio texto do install.sh. O pedido de e-mail e senha lia uma linha do script como resposta, e a pergunta da segunda maquina era respondida sozinha. `login` e `init` agora rodam ligados no terminal de verdade.
+- **Conta suspensa, cancelada ou finalizada nao deixa mais pasta pra tras** (§10.1 nº 9).
+
+### Testes
+- 4 suites novas (`installer-sh`, `installer-ps1`, `diagnostico`, `cli-embarque`): 88 testes no total. Os do PowerShell rodam de verdade quando ha um `pwsh` na maquina.
+- +11 testes de regressao do portao e da conversa: provados nos dois sentidos (falham com o defeito, passam com a correcao).
+
+## [2.3.0] — 2026-08-25
+
+### Feat — tarball MOTOR+CASCA (ainda NÃO é `latest`)
+- **K9:** esta versão só pode ir pro npm com dist-tag `next`. Não vira `latest` até o T1 do MCP `auroq-core` passar em produção.
+- **Corte do miolo:** `files` deixa de levar `agents/` de conteúdo (Clone Forge, Companion, Consultor, forjas). Organizer (síntese pública) e `seeds/` (memória/docs em branco) ficam.
+- **Casca no pack:** `prepack` sobrepõe CLAUDE.md, AGENTS.md, constitution, DNA, ops.md, shims e rules de MCP. `postpack` restaura o working tree. Tarball medido: 158.7 kB / 121 arquivos (antes ~2.14 MB / 279).
+- **Installer:** não copia forjas; semeia dados do aluno sem sobrescrever; `doctor` falha alto se autoload faltar; patch idempotente de `enableAllProjectMcpServers`.
+- **Login:** fingerprint de device em `~/.arcane/credentials.json`; contrato `finalizado` pode reinstalar (K6). Pack download continua exigindo `ativo`.
+
+## [2.2.4] — 2026-08-21
+
+### Feat — browser nativo, Computer Use e comunicacao direta
+- **Bootstrap 1 atualizado por runtime:** Claude Code configura Claude in Chrome via `/chrome` e Computer Use via `/mcp` no macOS elegivel; o app ChatGPT/Codex instala Browser, Chrome e Computer Use por Plugins; Codex CLI/IDE e Grok sem integracao exposta caem explicitamente no Playwright, sem sucesso falso.
+- **Playwright continua obrigatorio:** Chromium e Firefox permanecem registrados; Chromium ganha smoke test bloqueante e vira fallback/automacao tecnica, nao porta universal pra qualquer tarefa web.
+- **Output style `Direto`:** projeto entrega e ativa um estilo de brevidade inteligente — resultado primeiro, contexto minimo, risco material preservado.
+- **Regra de operacao autonoma:** escopo, persistencia, credenciais, honestidade e ordem de ferramentas passam a valer no Claude (`.claude/rules`) e no Codex (`AGENTS.md`).
+- **Material didatico corrigido:** Consultor passa a ensinar API/CLI/MCP → browser conectado → Playwright → Computer Use.
+- **Gates reais:** recurso nativo so e marcado como pronto depois de status + smoke test; indisponibilidade por plano, OS, politica ou rollout e registrada e coberta pelo fallback.
+
+## [2.2.3] — 2026-08-21
+
+### Feat — O ritual vira invisível: puxar automático + qualquer agente salva e entrega
+- **Hook `auroq-sync.cjs` (SessionStart):** ao abrir o `claude` na pasta do negócio, checa o GitHub e **puxa sozinho quando é seguro** (working tree limpo, nada por enviar), deixando no contexto o que chegou pro agente relatar em português ("Marcos subiu 9 criativos"). Se há trabalho local não entregue, NÃO puxa — avisa e sugere "salva e entrega" primeiro. Sem conexão ou sem GitHub: silêncio. **Nunca entrega sozinho.**
+- **Lembrete (UserPromptSubmit):** quando há trabalho não entregue há 30+ min, injeta um lembrete discreto (no máximo 1 a cada 30 min) pra o agente oferecer "salva e entrega" ao fechar o bloco. Estado fora do repositório (tmpdir) — nunca suja o git do aluno.
+- **Rule `puxar-e-entregar.md` (universal):** "salva", "entrega", "puxa" em linguagem natural são executados pelo agente ATIVO seguindo o ritual do Ops (`*commit`, `*pre-push`, `*sync`) — o expert nunca mais troca de agente pra isso. As travas do pre-push (vault/.env) valem pra todo agente.
+- **Autoridade ajustada** (ops.md, agent-authority, AGENTS.md, Companion): o Ops segue DONO do ritual e exclusivo em `push --force`, PR, MCP/infra, bootstrap e `*update`; commit/push/pull viram ritual compartilhado.
+- Hooks registrados em `.claude/settings.json` (arquivo de framework, versionado — viaja no clone e chega no update); `*update-auroq` passa a atualizar esse arquivo.
+
+
+## [2.2.2] — 2026-08-07
+
+### Improve — Grok Build como terceiro runtime
+- `AGENTS.md` e `README` passam a tratar **Claude Code**, **Codex CLI** e **Grok Build** como harnesses oficiais.
+- Grok usa a camada Claude nativa (`.claude/commands`, rules, `AGENTS.md`) — **sem** precisar de `sync:codex`.
+- Ativacao por harness documentada: Codex via `$nome` + skills; Claude/Grok via slash commands / pedido de ativacao.
+- Constitution e higiene de sessao atualizadas pra incluir Grok (um runtime por sessao).
+
+## [2.2.1] — 2026-08-05
+
+### Change — Colaborador não precisa ser aluno (política oficial)
+- `clone` **não pede mais login de aluno** — colaborador do negócio de um aluno clona sem conta na mentoria. O gate real do clone é o convite do GitHub (repo privado); um `git clone` puro já entregaria o mesmo conteúdo. Os gates de aluno seguem onde há valor do framework: `init` (criar negócio do zero) e `*update-auroq` (atualizar o sistema — só o dono atualiza; o colaborador recebe a atualização via `*sync`, porque o update vira commit no repo).
+- Ops (seção MULTI-MAQUINA) e README documentam a política.
+
+## [2.2.0] — 2026-08-05
+
+### Feat — Multi-máquina e colaborador
+- **Novo comando `npx auroq-os clone`** — o caminho oficial da segunda máquina (e do colaborador). Clonar JÁ é a instalação: baixa o negócio inteiro do GitHub (sistema, agentes, memória do Companion, documentos), com o mesmo gate de aluno do init, e completa só o que não viaja — npm install, skills do Codex, proteções de segredo e health check. Aceita `owner/repo`, URL ou caminho; sem argumento, lista os repositórios da conta via GitHub CLI pra escolher.
+- **Guardrail no `init`** — em instalação nova, pergunta se o aluno já usa o Auroq em outra máquina; se sim, aborta e aponta pro `clone`. Mata o erro clássico de criar um segundo Auroq desconectado (históricos que não se cruzam + versões divergentes do framework). Update/reinstall em pasta existente não pergunta. Escape: `AUROQ_INIT_MODE=novo`.
+- **Ops ganha `*sync`** — puxar as atualizações do GitHub no início da sessão, com commit-antes-de-pull automático, condução de conflito pra leigo (memória do Companion = juntar as duas versões) e relatório em português do que chegou. Ritual oficial: sentou → `*sync` · levantou → `*commit` + `*push`.
+- **Ops ganha a seção MULTI-MAQUINA E COLABORADOR** — sabe orientar: clone (nunca init), convite-não-senha (GitHub Collaborators, assinatura Claude própria, cofre "Equipe" no 1Password com escopo), régua do diário (colaborador lê e escreve a memória do Companion), arquivo pesado no Drive.
+
+### Security — Fix do .gitignore (vazamento de Service Key)
+- O `.gitignore` do aluno passa a ser **gerado por código** (`applySecretProtections`), não copiado de arquivo — o tarball do npm não preservava o arquivo de forma confiável e instalações reais ficavam com um .gitignore de 4 linhas **sem `business/vault/`**, onde o Bootstrap salva a Service Key do Supabase em texto plano: o primeiro push do aluno subia segredo pro GitHub.
+- Novo comando `npx auroq-os fix-gitignore` — merge idempotente (adiciona o que falta, preserva linhas do expert) + **destraqueia segredos já versionados** (`git rm --cached` em vault/.env/chaves; os arquivos continuam no disco) e avisa quando podem já ter subido pro remote (conduzir rotação das chaves).
+- Roda automaticamente no `init`, no `clone` e no `*update-auroq` (Passo 5) — aluno existente é migrado no próximo update sem fazer nada.
+- Proteções também para mídia pesada (png/jpg/mp4/mov/mp3/wav) — repo é texto; mídia vai pro Drive.
+
+### Improve
+- Versão dinâmica no banner e rodapé (lida do package.json; acabou o "v2.1.0" hardcoded).
+- Health check extraído (`runHealthChecks`) e compartilhado por init e clone.
+
+## [2.1.6] — 2026-06-26
+
+### Improve
+- Bootstrap 2 (Ops) — seção do Cloudflare reescrita pra leigo. Dois caminhos explícitos: **Caminho A** (já tem domínio → apontar nameservers, guiado por print da tela porque cada registrador é diferente) e **Caminho B** (comprar novo direto no Cloudflare, recomendado — já nasce conectado).
+- Deixa claro que o aluno pode ter **quantos domínios quiser** na conta e adicionar mais a qualquer momento.
+- Documenta o limite real: o Cloudflare Registrar **não vende `.com.br`** (nem ccTLD br) — quem quer `.com.br` compra no Registro.br e cai no Caminho A.
+- Gate de verificação reforçado: confirma que o(s) domínio(s) esperado(s) aparecem nas zonas, não só que o MCP conectou.
+
+## [2.1.5] — 2026-06-24
+
+### Fix
+- O `init` (rodado direto ou via `arcane-pack update`) deixa de sobrescrever customizacoes do aluno. Antes, todo update restaurava os arquivos de framework (`CLAUDE.md`, rules, companion) com `overwrite: true` — quem editava esses arquivos perdia o trabalho no proximo update (so o git checkpoint salvava).
+- Novo lugar oficial pra customizacao: `.claude/rules/custom-do-aluno.md` — semente criada na 1a vez e NUNCA mais sobrescrita. E onde regras de comportamento e overrides do aluno devem morar (o Auroq ja carrega tudo de `.claude/rules/` automaticamente).
+- `.claude/settings.local.json` passa a ser preservado (config local do aluno, nao do framework).
+- `CLAUDE.md` documenta os 2 lugares que sobrevivem a updates; o output do `init` avisa onde eles ficam.
+
+## [2.1.3] — 2026-06-10
+
+### Fix
+- `init` cria o `package.json` ANTES de gerar as skills do Codex — o marcador de ownership nascia com o nome da pasta e todo sync seguinte recusava com "foreign" (quebrava o `arcane-pack update` em instalacoes novas).
+- Ownership das skills do Codex passa a aceitar marcador da MESMA pasta de projeto mesmo que o name do package tenha mudado (repara projetos ja afetados sem intervencao manual).
+- `*update-auroq` (Ops) passa a seguir a lista ATUALIZA do ops.md NOVO do pacote baixado — a lista da versao instalada nao conhecia arquivos novos (ex.: `scripts/sync-codex-skills.mjs` nunca chegava em quem atualizava a partir de <= 2.0.4).
+## [2.1.2] — 2026-06-10
+
+### Fix
+- Bootstrap 2 deixa de configurar o 1Password, que passa a ser pre-requisito tratado no Step anterior da plataforma.
+- Ops valida o cofre antes das conexoes e oferece duas rotas explicitas: voltar para configurar o 1Password ou continuar com vault local menos seguro.
+- Todas as conexoes do Bootstrap 2 passam a obedecer uma politica unica de armazenamento de credenciais.
+
+## [2.1.1] — 2026-06-09
+
+### Fix
+- Remove command orfao do Squad Edicao do core; squads Arcane pertencem ao `arcane-pack` e so ganham skill quando os arquivos completos sao instalados.
+- Fluxo do Ops passa a exigir confirmacao do sync Codex executado pelo `arcane-pack@1.2.0+`.
+
+## [2.1.0] — 2026-06-09
+
+### Feat — Runtime hibrido oficial
+- Claude Code e Codex CLI passam a ser runtimes oficiais equivalentes do Auroq OS.
+- Installer gera e verifica skills Codex no local oficial `.agents/skills`, isoladas por projeto e sem colisao global entre negocios.
+- Sync Codex com ownership, collision guard, deteccao real de drift, execucao fora da raiz e descoberta automatica de comandos customizados.
+- Ops atualiza `AGENTS.md` e a ponte Codex, regenerando as skills no pos-update.
+- Constitution 2.0.0 torna o projeto Auroq no terminal o centro de comando, sem dependencia conceitual de um fornecedor.
+
+### Quality
+- Quality gates raiz: lint, typecheck estrutural, testes Node e pack dry-run.
+- Testes cobrem determinismo, portabilidade, preservacao de skills externas, drift e colisoes.
+
+Histórico de versões do Auroq OS. Formato: data + o que mudou.
+
+## [1.6.1] — 2026-05-08
+
+### Fix — Ops install/update-squad/install-pack
+
+- **Slash command file usa agora `slash_prefix:` do `squad.yaml`, não nome da pasta.** Antes: Ops criava `.claude/commands/{nome-da-pasta}.md` cegamente — funciona se `slash_prefix == nome-da-pasta`, mas QUEBRA se o squad declara um slash diferente.
+
+  Exemplo concreto que motivou o fix: Slide Forge v2 tem pasta `slide-forge` mas `slash_prefix: "slideForgeV2"`. Do jeito antigo, Ops criaria `.claude/commands/slide-forge.md` → aluno ativaria com `/slide-forge` (errado). Agora cria `.claude/commands/slideForgeV2.md` → ativa com `/slideForgeV2` (correto).
+
+- **Suporte a `slash_prefix_legacy:`** pra alias backward-compat. Squad pode declarar nome novo + nome antigo no mesmo `squad.yaml`. Ops cria os 2 command files. Útil pra updates que mudam ativação (v1 → v2): aluno que tinha hábito do nome antigo continua funcionando, e o novo está disponível.
+
+- **Conteúdo do command file melhorado:** descrição lida de `description:` ou `title:` do squad.yaml. Chief agent detectado de `tiers.orchestrator[0]` automaticamente.
+
+- **Aplicado em 3 lugares:** `*install` Passo 4, `*update-squad` Passo 7, `*install-pack` Passo 3.
+
+### Por que isso importa
+
+Sem esse fix, qualquer squad da Mentoria Arcane que declara `slash_prefix` diferente do nome da pasta era instalado errado. Aluno ativava `/{nome-pasta}` em vez do nome correto `/slug-real`. Agora é determinístico.
+
+---
+
+## [1.6.0] — 2026-05-08
+
+### Feat — Ops
+
+- **`*update-squad`: protocolo dedicado de atualização de squad existente.** Aluno baixa zip da versão nova de um squad (ex: `slide-forge-v2.0.0.zip`) e roda `*update-squad` — Ops faz a operação completa preservando dados:
+  - Detecta versão atual instalada vs versão do zip (lendo campo `version:` do `squad.yaml`)
+  - Mostra diff de versão pro aluno confirmar
+  - Detecta modificações locais do aluno em arquivos do framework (a princípio aluno não deveria modificar) → cria backup em `_backup-tuas-mods/{slug}-v{old}-{timestamp}/` antes de sobrescrever
+  - Backup completo do squad antigo em `agents/_archive/{slug}-v{old}-{timestamp}/` (retenção 30 dias)
+  - **Preserva sempre runtime do aluno:** `agents/{slug}/minds/` (outputs do expert), `.state.json` (pipeline em andamento), `*-state.json`
+  - Substitui só arquivos framework (agents/, tasks/, data/, workflows/, checklists/, templates/, squad.yaml, README)
+  - Atualiza slash command em `.claude/commands/{slug}.md` se mudou
+  - Validação pós-update + rollback automático se algum check falhar
+  - Reporta o que mudou + caminhos dos backups
+
+- **`*install` ganhou smart detection.** Antes: se squad já existia, perguntava só "quer sobrescrever?" — apagava `minds/` e tudo. Agora: se squad existe, oferece 3 opções:
+  1. **Atualizar** (recomendado) — reroteia pra `*update-squad` (preserva dados)
+  2. **Reinstalar do zero** — apaga tudo e instala como novo (raro, requer dupla confirmação)
+  3. **Cancelar**
+  - Ainda: se aluno usa `*update-squad` num squad que NÃO existe, reroteia automaticamente pro `*install`.
+
+- **Greeting do Ops atualizado:** novo item "4. Atualizar squad — substituir squad existente por versao nova (preserva teus dados)".
+
+### Cenários de uso
+
+- **Aluno recebe slide-forge v2:** zip nomeado com versão (`slide-forge-v2.0.0.zip`). Roda `*update-squad`, drag-and-drop do zip. Ops detecta v1 instalada, confirma update, faz backup, preserva minds/, instala v2 limpo.
+- **Aluno tenta `*install` num squad já instalado:** Ops oferece atualizar via `*update-squad` antes de apagar dados.
+- **Aluno modificou framework localmente:** Ops detecta divergências, oferece backup-tuas-mods antes de sobrescrever.
+
+### Detalhes técnicos
+
+- Backup retenção: 30 dias (squad antigo em `agents/_archive/`)
+- Backup das mods locais: separado em `_backup-tuas-mods/` pra clareza
+- Whitelist de runtime preservado: `minds/`, `.state.json`, `*-state.json`, `.local/`
+- Rollback automático se validação pós-update falhar (`squad.yaml` parseável, `start.md` existe, slash command aponta pra arquivos existentes, runtime preservado intacto)
+
+---
+
+## [1.5.0] — 2026-05-08
+
+### Refactor
+- **Squad Forge reescrito do zero.** Plano de correção em 7 fases aplicado após diagnóstico que revelou squads gerados superficiais (agentes 90-130 linhas, sem Output Examples, sem Immune System, com refs externas a paths privados que quebravam na máquina do aluno). Versão antiga: 1.0.0. Nova: 2.0.0.
+
+### Feat — Squad Forge
+
+- **6 tasks novas:** `fix-squad`, `update-squad`, `rebuild-squad` (modos completos do greeting), `generate-prd`, `generate-stories` (Story-Driven — Article III Constitution), `self-test` (auto-validação contínua). Total: 12 tasks (era 6).
+- **Profundidade obrigatória nos squads gerados:** hard gates bloqueiam QG-SF-004 se agente sair com <250 linhas, sem 3+ OUTPUT EXAMPLES concretos, sem 3+ IMMUNE SYSTEM triggers rastreáveis, ou com <5 frases-chave. Self-audit quantitativo via bash + self-healing loop (max 3 tentativas).
+- **REGRA AUTOCONTIDO (NON-NEGOTIABLE):** squads gerados nunca mais saem com refs a `docs/knowledge/...`, `squads/etlmaker/kbs/...`, `business/...`, `~/euriler-brain/`, ou absolute paths. Fontes externas viram build-time inputs — Smith lê, processa, sintetiza, e ESCREVE conteúdo novo dentro de `squads/{name}/data/`. Aluno consegue zipar e rodar em qualquer máquina.
+- **Story-Driven Development:** todo squad gerado vem com PRD em `docs/prd/squad-{slug}.md` (FRs/NFRs/CONs/SCs rastreáveis aos PUs via Trace Matrix), stories em `docs/stories/squad-forge/{slug}/` (1 epic com 5 ACs = 5 QGs + 1 story por fase), e tracker em `business/campanhas/squad-{slug}/tracker.md` (Project Tracker Protocol).
+- **Modos completos no greeting:** `*start` (criar), `*update {squad}` (modificação cirúrgica preservando profundidade), `*fix {squad}` (audit + auto-fix + lista manual), `*rebuild {squad}` (reverse-extract + reconstruir com profundidade nova), `*self-test` (audita o próprio squad-forge).
+- **Instalação automática (Fase 5):** após QG-SF-005 PASS, squad é copiado pra `squads/{name}/`, skill registrada em `.claude/commands/{slashPrefix}.md`, MEMORY.md atualizado, tracker atualizado, validação pós-instalação. Rollback completo se qualquer sub-step falha. Backup automático em `squads/_archive/` se squad já existia.
+- **Template de agente condicional (target_audience):** start.md Step 3 pergunta se squad é `internal` (uso interno do dono — pode ter refs `business/cockpit.md`) ou `distributed` (alunos/clientes — REGRA AUTOCONTIDO ativa). Default seguro: distributed.
+- **State management real:** `.state.json` atualizado por todos os 3 agentes em cada round/fase. `*resume` agora retoma de verdade da última fase incompleta (antes era fingido).
+- **Quality thresholds centralizados:** `data/quality-thresholds.yaml` é single source of truth — extraction, agent_depth, kb_depth (por tipo: operacional 800 / analítico-criativo 600 / dev 400), task_structure, workflow, autocontido, story_driven, installation. Mudar 1 valor propaga pra todos os checks.
+
+### Fix — Squad Forge
+
+- Path do schema corrigido em `forge-smith.md` (`.aios-core/schemas/squad-schema.json`)
+- `data/` padronizado em README e templates (era inconsistente com `knowledge/`)
+- Comandos do chief alinhados ao greeting (antes greeting prometia 4 modos, chief tinha só `*start`)
+- Numeração inconsistente em `architect-squad.md` corrigida
+- Smoke tests em `validate-squad.md` sem hardcode de exemplo (era "oferta R$997")
+- `current_phase` documentado como 0..5 (6 fases totais)
+
+### Migration
+
+- **Squads existentes contaminados:** quem tinha squads gerados antes desta versão (com refs `business/cockpit.md` ou `business/campanhas/*/tracker.md` em runtime) deve rodar `*fix {squad-name}` pra detectar violações + `*update` ou `*rebuild` pra corrigir. Squads internos do dono (não distribuídos) podem ficar como estão.
+- **Aluno via `*update` do Ops:** pasta `agents/squad-forge/` é sobrescrita (L1/L2/L3 — framework, igual ao fix de 1.4.1). Outputs em `agents/squad-forge/minds/` continuam preservados.
+
+### Detalhes técnicos
+
+- Plano completo: `docs/plans/squad-forge-correcao-v2.md` (no AIOS — não distribuído)
+- Backup local pré-sync: `_backup-pre-sync/squad-forge-pre-1.5.0-20260508-125651/`
+- Validator: VALID, 0 errors, 1 warning não-bloqueante (`handoff_prompts` opcional)
+
+---
+
+## [1.4.1] — 2026-04-29
+
+### Fix
+- **`*update` do Ops agora atualiza os meta squads em `agents/`.** Antes só
+  atualizava os arquivos `.claude/commands/{meta-squad}.md` (commands), mas
+  deixava o conteúdo da pasta `agents/{meta-squad}/` intocado — bug que
+  fazia atualizações do Clone Forge (e outros meta squads) não chegarem nos
+  alunos via `*update`. Agora `agents/squad-forge/`, `agents/mind-forge/`,
+  `agents/worker-forge/`, `agents/clone-forge/`, `agents/etlmaker/` e
+  `agents/organizer/` são tratados como L1/L2/L3 (framework) e sobrescritos.
+  Outputs em `agents/{meta-squad}/minds/` continuam preservados (L4 — dados
+  do expert).
+
+## [1.4.0] — 2026-04-29
+
+### Refactor
+- **Clone Forge agora é self-contained.** Removida dependência do Squad Creator
+  Premium e dos agentes externos `@oalanicolas` e `@pedro-valerio` que travavam
+  o setup com "Squad Creator Premium nao instalado". Aluno baixa e roda do zero.
+
+### Feat
+- 5 tasks novas no Clone Forge: `extract-voice-dna`, `extract-thinking-dna`,
+  `fidelity-score`, `validate-clone`, `clone-review`. Total: 17 tasks.
+- 4 data files novos: `clone-anti-patterns`, `clone-validation`,
+  `output-examples`, `source-tiers`. Total: 11 data.
+- Checklist `smoke-test-clone.md` (3 cenários padronizados).
+- `@innerlens` absorve Voice DNA extraction, `@cognitive-motor` absorve
+  Thinking DNA, `@clone-forge-chief` absorve coleta + validação completa.
+
+### Fix
+- Quick workflow não valida mais "MIUs >= 80%" no QG-005 quando Fase 2
+  (MIU extraction) é skipped — bug que dava comportamento indefinido.
+- Removidas referências personalizadas em exemplos de tasks (paths e nomes
+  trocados por genéricos).
+
+## [1.3.2] — 2026-04-29
+
+### Chore
+- Declara `engines.node >=18` no package.json (alinha com o check de runtime
+  que o installer já fazia, mas agora o npm avisa antes de instalar).
+- LICENSE proprietário e CHANGELOG adicionados ao repo.
+- `.gitignore` reorganizado: `.npmrc` movido pra seção de Secrets.
+
+## [1.3.1] — 2026-04-25
+
+### Fix
+- CLI agora aponta pra `arcane.arka.education` na tela de login.
+  Antes mostrava `mentoria-arcane.vercel.app` (domínio antigo).
+
+## [1.3.0] — 2026-04-14
+
+### Feat
+- Auth gate no CLI: comandos `init`, `login`, `logout`, `whoami`.
+  Aluno autentica com email + senha da Mentoria Arcane antes de instalar.
+- Validação de acesso ativo via RPC `check_access_status` no Supabase.
+- Modo offline: usa credencial local quando sem internet.
+
+## [1.2.0] — 2026-04-09
+
+### Fix
+- Installer copia meta squads e scripts como diretórios inteiros
+  (antes copiava só arquivos individuais e perdia conteúdo).
+- Installer bloqueia instalação na pasta home do usuário.
+- Preserva companion personalizado (não sobrescreve com o genérico).
+- Limpa commands antigos em camelCase ao atualizar.
+- Migra meta squads de `squads/` pra `agents/` em projetos antigos.
+
+## [1.1.0] — 2026-04-08
+
+### Feat
+- Meta squads incluídos: Squad Forge, Mind Forge, Worker Forge, Clone Forge, ETLmaker.
+- Organizer com comando `*store`.
+- Companion com knowledge completo (foundation, system-guide, modus-operandi,
+  arcane-method, expert-essencial).
+
+### Fix
+- Installer sobrescreve framework mas preserva dados do aluno (resolve loop circular de update).
+- Companion varre `agents/` pra descobrir especialistas instalados.
+
+## [1.0.2] — 2026-03-17
+
+### Setup
+- Versão inicial pública: framework completo (constitution, synapse engine,
+  hooks, rules, companion, organizer).
+- Bootstrap detecta OS (mac/windows) com mapa de comandos por plataforma.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auroq-os",
-  "version": "2.4.8",
+  "version": "2.4.10",
   "description": "Auroq OS — Sistema Operacional de IA para Experts",
   "bin": {
     "auroq-os": "bin/auroq-os.js"
@@ -47,6 +47,7 @@
     "agents/organizer/",
     "AGENTS.md",
     "README.md",
+    "CHANGELOG.md",
     ".gitignore",
     ".env.example"
   ],

package/scripts/prepack-casca.mjs

@@ -44,4 +44,23 @@ for (const src of files) {
   fs.copyFileSync(src, dest);
 }
 
+// O hook auroq-sync compara a versao lida de .auroq-core/core-config.yaml com a
+// do npm para avisar de update. Se o core-config ficar para tras, TODO aluno ja
+// atualizado ve "saiu versao nova" para sempre. Sincroniza no pack.
+const pkgVersion = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).version;
+const cfgPath = path.join(root, '.auroq-core', 'core-config.yaml');
+if (fs.existsSync(cfgPath)) {
+  const cfg = fs.readFileSync(cfgPath, 'utf8');
+  const synced = cfg.replace(/^(\s*version:\s*)["']?\d+\.\d+\.\d+["']?/m, `$1${pkgVersion}`);
+  if (synced !== cfg) {
+    const bak = path.join(backupRoot, '.auroq-core', 'core-config.yaml');
+    if (!fs.existsSync(bak)) {
+      fs.mkdirSync(path.dirname(bak), { recursive: true });
+      fs.copyFileSync(cfgPath, bak);
+    }
+    fs.writeFileSync(cfgPath, synced);
+    console.log(`prepack-casca: core-config.yaml sincronizado para ${pkgVersion}`);
+  }
+}
+
 console.log(`prepack-casca: ${files.length} arquivos sobrepostos`);