auroq-os 2.8.2 → 2.8.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -92,12 +92,21 @@ agora; a certeza vem do uso; nada volta para o zero.
92
92
  refinar (melhorar agentes e processos). Cada volta deixa o sistema mais forte.
93
93
 
94
94
  **Conversa:** o Companion carrega onde paramos, mostra o que importa, o aluno escolhe o foco, a
95
- equipe trabalha, no fim de cada tarefa a memória é salva e, quando o aluno pede, o trabalho é salvo
96
- e entregue no GitHub.
95
+ equipe trabalha e, no fim de cada tarefa, a memória é salva. Com o app Auroq OS aberto, o trabalho é salvo e
96
+ entregue no GitHub sozinho (a cada 15 minutos, ao abrir e ao fechar); sem o app, quando o aluno pede. O aluno
97
+ abre quantas conversas quiser dentro do projeto, uma por assunto, todas com o Companion.
97
98
 
98
99
  **Semana:** sem revisão há 7 dias ou mais, o Companion propõe uma revisão de 20 minutos (cockpit,
99
100
  trackers, pendências, padrões).
100
101
 
102
+ **Mês:** uma vez por mês, o Companion propõe a revisão do mês, também de uns 20 minutos: os números do
103
+ mês, o que funcionou, se os projetos levam à meta dos 90 dias e o foco do mês que vem
104
+ (`business/revisoes-do-mes.md`).
105
+
106
+ **Ano:** o plano da empresa (`business/plano-da-empresa.md`) diz aonde o negócio quer chegar em 12 meses,
107
+ em 4 trimestres. Cada trimestre é uma meta de 90 dias. O Companion propõe montar o plano na primeira
108
+ revisão do mês e o refaz no fim do ano.
109
+
101
110
  **Projeto:** nasce no cockpit com tracker e fases → os agentes trabalham e atualizam o tracker →
102
111
  termina com uma retrospectiva de 3 perguntas e vai para o arquivo, abrindo vaga para o próximo.
103
112
 
@@ -154,6 +163,7 @@ concluída e conversa encerrando. Regra completa: `.claude/rules/memoria-intelig
154
163
  Commit aqui não é coisa de programador: é o ponto de restauração do negócio. A mensagem conta o que
155
164
  aconteceu (`progresso:`, `decisao:`, `processo:`, `agente:`, `conhecimento:`, `campanha:`, `fix:`,
156
165
  `setup:`), não o que mudou nos arquivos. Entregar (push) manda a cópia para o GitHub privado do aluno.
166
+ Com o app aberto isso acontece sozinho a cada 15 minutos; o pedido "salva" continua valendo para salvar na hora.
157
167
  Ritual em `.claude/rules/puxar-e-entregar.md`.
158
168
 
159
169
  ## Volante
@@ -1,7 +1,7 @@
1
1
  project:
2
2
  name: "Auroq OS"
3
3
  type: greenfield
4
- version: 2.8.2
4
+ version: 2.8.5
5
5
  installedAt: '2026-03-16'
6
6
 
7
7
  ide:
@@ -1,22 +1,18 @@
1
1
  # ops
2
2
 
3
- Bootstrap e operação do Auroq OS.
3
+ O Ops foi aposentado para o aluno (23/10/2026). Quem cuida de tudo, inclusive do técnico, é o Companion.
4
4
 
5
- O corpo deste guia (FASES 0–N) vem pelo MCP `arcane` (catálogo `auroq-core`). Chame a tool `forja_bundle` com forge_id `ops` e a fase atual. Enquanto o servidor responder, nunca procurar o texto longo em disco.
5
+ Ao ser ativado por este atalho (`/AuroqOS:agents:ops` ou `$ops`): diga em UMA linha "Agora quem cuida disso é o Companion." e ative o Companion pelo mesmo caminho do atalho `/auroq-companion` (tool `squad_ativar` do MCP `arcane` com recurso_id `companion`), passando o pedido do aluno inteiro. O Companion resolve pelas skills técnicas dele (`conserto-tecnico`, `salvar-e-sincronizar`, `publicar-site`, `atualizar-sistema`, `configurar-computador`, `conectar-cofre`, `companion-externo`), que chegam ao vivo pelo MCP `arcane` (catálogo `auroq-core`). Nunca mande o aluno trocar de conversa nem digitar comando.
6
6
 
7
7
  O Pack chega ao vivo pelo MCP. NUNCA peça zip nem instalacao do Pack.
8
8
 
9
- **Execucao preparada pelo MCP:** Edicao, Carrossel, Trafego, Low Ticket e Bia recebem seus arquivos por `squad_passo` com o recurso_id do squad e passo `preparar-execucao`. O agente executa o script retornado na pasta do negocio e continua o trabalho. Anuncios funciona sem arquivos locais. Nao instalar nem atualizar Pack; nao pedir ZIP. Os arquivos locais servem apenas para executar o passo, nunca como fonte do metodo.
10
-
11
9
  Ao ativar, mostre o selo de acesso que a tool devolver (as duas primeiras linhas) antes de qualquer outra coisa — é como o aluno vê que a licença dele foi conferida agora.
12
10
 
13
- Se a tool recusar (acesso vencido, cancelado, suspenso ou encerrado) ou falhar: confira se existe `agents/ops/OPS-LOCAL.md` no disco (é o Bootstrap completo que morava no computador do aluno antes da migração; o instalador guarda ele ali). Se existir, avise em UMA linha — "O servidor não liberou o conteúdo ao vivo; seguindo com o Bootstrap que já está no seu computador." — e siga por esse arquivo como fonte da verdade, mostrando a mensagem do servidor junto. Se não existir, mostre a mensagem exatamente como veio, com o contato do suporte da Arcane, e pare (única exceção abaixo). Nunca improvisar de memória, nunca tentar de novo sozinho. O que já estava no computador do aluno antes da migração continua dele.
11
+ Se a tool recusar (acesso vencido, cancelado, suspenso ou encerrado) ou falhar: confira se existe `agents/ops/OPS-LOCAL.md` no disco (o guia que já está no seu computador desde antes da migração). Se existir, avise em UMA linha — "O servidor não liberou o conteúdo ao vivo; seguindo com o guia que já está no seu computador." — e siga por esse arquivo, mostrando a mensagem do servidor junto. Se não existir, mostre a mensagem exatamente como veio, com o contato do suporte da Arcane, e pare (única exceção abaixo). Nunca improvisar de memória, nunca tentar de novo sozinho. O que já estava no computador do aluno antes da migração continua dele.
14
12
 
15
13
  **Exceção — atualizar ou consertar a conexão sem o MCP:** se a tool falhou ou recusou e o aluno pediu para atualizar o sistema ou consertar a conexão, rode você mesmo na raiz do negócio (Windows: `npx.cmd` no lugar de `npx`), sem mandar o aluno ao terminal:
16
14
  - atualizar: `npx -y auroq-os@latest manutencao --agente` (Claude Code: timeout 600000; Codex: espere a linha `AUROQ_RESULTADO`). `status=ok` → "Pronto, atualizei."; `motivo=login` → oriente o login na janela "Login Arcane" que abriu, nunca peça senha no chat, e peça que ele repita o pedido; `motivo=migracao` → peça o SIM e rode de novo com `--migrar-mcp`; outro erro → mostre a `mensagem` e sugira o Arcano;
17
15
  - consertar a conexão: `npx -y auroq-os@latest register-mcp`.
18
16
  Depois: "Feche e abra o Claude Code (ou o Codex) para terminar." Não rode `doctor` em seguida.
19
17
 
20
- **Comandos antigos aposentados:** `*update-auroq`, `*update`, `*update-packarcane` e instalacao do Pack nao autorizam copiar arquivos antigos ou instalar ZIP. Para conteudo, usar o MCP. Para atualizar o sistema ("atualiza o sistema"), seguir `forja_bundle` com forge_id `ops` e fase `manutencao` — ou a exceção acima, se o MCP falhar. Nunca seguir a antiga lista ATUALIZA nem extrair pacote em /tmp/auroq-update.
21
-
22
- CRITICAL: Do not treat this file as the Bootstrap. Use the MCP `arcane` tools; fall back to `agents/ops/OPS-LOCAL.md` only after the MCP refused or failed and that file exists. Without the MCP, the only other local action is the update/connection exception above.
18
+ CRITICAL: Do not treat this file as a guide. Hand the request to the Companion through the MCP `arcane` tools; fall back to `agents/ops/OPS-LOCAL.md` only after the MCP refused or failed and that file exists. Without the MCP, the only other local action is the update/connection exception above.
@@ -0,0 +1,102 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Freio "trabalhar até o fim" (Stop do Claude Code, 2.8.4).
4
+ *
5
+ * Confere a última resposta da IA antes de ela chegar ao aluno. Se a resposta termina pedindo licença
6
+ * para um passo de rotina ("quer que eu...?", "posso seguir?") ou manda o aluno rodar um comando que
7
+ * ele não pediu para rodar sozinho, devolve a vez à IA uma única vez, para ela fazer e responder de novo.
8
+ *
9
+ * Até a 2.8.3 era um gancho de IA (`type: "prompt"`). Quando ele segurava uma resposta, o Claude Code
10
+ * mostrava ao aluno o texto inteiro das instruções ("Stop hook feedback: [Você confere a última
11
+ * resposta...]"), e não há como esconder. Gancho de comando mostra só o comando e o motivo curto abaixo.
12
+ *
13
+ * Libera: o que é do aluno (senha, código, pagamento, apagar, mensagem a outra pessoa, publicar,
14
+ * GitHub), "Decide: A ou B?", passo a passo que o aluno pediu e relatório de IA da equipe.
15
+ * Qualquer falha sai em silêncio com código 0: o freio nunca trava a conversa.
16
+ */
17
+
18
+ 'use strict';
19
+
20
+ const fs = require('node:fs');
21
+
22
+ const MOTIVO = 'Auroq: faça você mesmo o que a resposta deixava para o aluno e responda de novo, curto. Não comente esta conferência.';
23
+ const LER_DO_FIM = 512 * 1024;
24
+
25
+ const PEDE_LICENCA = [
26
+ /\b(?:quer|queres|deseja|gostaria)\s+que\s+eu\b[^?\n]{0,160}\?/i,
27
+ /\bposso\s+(?:seguir|continuar|prosseguir|come[cç]ar|fazer|rodar|executar|criar|ajustar|aplicar|corrigir|instalar|configurar|montar|gerar|atualizar|salvar)\b[^?\n]{0,160}\?/i,
28
+ /\b(?:sigo|continuo|prossigo|fa[cç]o|aplico|rodo)\s*\?/i,
29
+ /\bse\s+(?:voc[eê]\s+)?quiser,?\s+(?:eu\s+)?(?:posso|fa[cç]o|j[aá]\s+fa[cç]o)\b/i,
30
+ /\bme\s+(?:avise|avisa|diga|diz|fala)\s+(?:se|quando)\s+(?:quiser|puder|posso)\b/i,
31
+ ];
32
+ const MANDA_RODAR = /\b(?:rode|roda|execute|executa|cole|cola|digite|digita)\b[^.\n]{0,80}\b(?:comando|terminal|powershell|prompt de comando)\b/i;
33
+ const DO_ALUNO = /\b(?:senha|c[oó]digo|captcha|biometria|2fa|pagamento|pagar|cart[aã]o|compra|comprar|apagar|excluir|deletar|remover|mensagem|enviar\s+para|mandar\s+para|publicar|publica[cç][aã]o|no\s+ar|github|push|entregar|entregue|decide:)/i;
34
+ const ALUNO_PEDIU_PASSO = /\b(?:eu\s+mesm[oa]|sozinh[oa]|me\s+ensin|passo\s+a\s+passo|como\s+(?:eu\s+)?fa[cç]o|me\s+explic|quero\s+aprender)/i;
35
+
36
+ function lerEntrada() {
37
+ try { return JSON.parse(fs.readFileSync(0, 'utf8') || '{}'); } catch { return {}; }
38
+ }
39
+
40
+ function textoDe(conteudo) {
41
+ if (typeof conteudo === 'string') return conteudo;
42
+ if (!Array.isArray(conteudo)) return '';
43
+ return conteudo.filter(p => p && p.type === 'text').map(p => p.text || '').join('\n');
44
+ }
45
+
46
+ // Lê do transcript a última resposta da IA, o último pedido do aluno e se a conversa é de equipe.
47
+ function lerConversa(caminho) {
48
+ const r = { resposta: '', pedido: '', equipe: false };
49
+ if (!caminho) return r;
50
+ let bruto;
51
+ try {
52
+ const fd = fs.openSync(caminho, 'r');
53
+ try {
54
+ const tam = fs.fstatSync(fd).size;
55
+ const inicio = Math.max(0, tam - LER_DO_FIM);
56
+ const buf = Buffer.alloc(tam - inicio);
57
+ fs.readSync(fd, buf, 0, buf.length, inicio);
58
+ bruto = buf.toString('utf8');
59
+ const cabeca = Buffer.alloc(Math.min(tam, 64 * 1024));
60
+ fs.readSync(fd, cabeca, 0, cabeca.length, 0);
61
+ r.equipe = cabeca.toString('utf8').includes('BRIEFING DA EQUIPE');
62
+ } finally { fs.closeSync(fd); }
63
+ } catch { return r; }
64
+ for (const linha of bruto.split('\n')) {
65
+ let ev;
66
+ try { ev = JSON.parse(linha); } catch { continue; }
67
+ const msg = ev && ev.message;
68
+ if (!msg || ev.isMeta) continue;
69
+ const texto = textoDe(msg.content).trim();
70
+ if (!texto) continue;
71
+ if (ev.type === 'assistant') r.resposta = texto;
72
+ else if (ev.type === 'user' && !texto.startsWith('<')) r.pedido = texto;
73
+ }
74
+ return r;
75
+ }
76
+
77
+ function deveSegurar(resposta, pedido) {
78
+ if (!resposta) return false;
79
+ // Só o fim da resposta importa: a pergunta de licença costuma fechar a mensagem.
80
+ const fim = resposta.split(/\n\s*\n/).slice(-2).join('\n');
81
+ if (DO_ALUNO.test(fim)) return false;
82
+ if (PEDE_LICENCA.some(re => re.test(fim))) return true;
83
+ if (MANDA_RODAR.test(resposta) && /```/.test(resposta) && !ALUNO_PEDIU_PASSO.test(pedido)) return true;
84
+ return false;
85
+ }
86
+
87
+ function main() {
88
+ const entrada = lerEntrada();
89
+ if (entrada.stop_hook_active) return;
90
+ const conversa = lerConversa(entrada.transcript_path);
91
+ if (conversa.equipe) return;
92
+ const resposta = String(entrada.last_assistant_message || conversa.resposta || '');
93
+ if (!deveSegurar(resposta, conversa.pedido)) return;
94
+ process.stdout.write(JSON.stringify({ decision: 'block', reason: MOTIVO }));
95
+ }
96
+
97
+ if (require.main === module) {
98
+ try { main(); } catch { /* nunca trava a conversa */ }
99
+ process.exit(0);
100
+ }
101
+
102
+ module.exports = { deveSegurar };
@@ -13,7 +13,8 @@
13
13
  dentro do comando que usa o valor, numa variável (`X="$(npx -y auroq-os@latest segredo ler Item/campo)" && comando "$X"`),
14
14
  para o valor não voltar na conversa; para guardar, ligue por pipe a saída de quem gerou o valor. Nunca exponha segredo no chat ou em logs; `business/vault/` guarda só
15
15
  status e referência `op://...`, nunca o valor. Cofre ainda não conectado, ou `op`/`segredo` com erro de
16
- autenticação: conecte você mesmo pela skill `conectar-cofre` (`agents/companion/tasks/conectar-cofre.md`) e
16
+ autenticação: conecte você mesmo pela skill `conectar-cofre` (`agents/companion/tasks/conectar-cofre.md`; MCP `arcane`, `squad_passo`
17
+ com recurso_id `companion` e passo `conectar-cofre`, cuja entrada diz qual das peças carregar) e
17
18
  retome a tarefa. Leia cada credencial uma vez por conversa e reaproveite o valor (a chave tem teto de leituras
18
19
  por hora, por minuto ou por dia, conforme o cofre); nunca rode `env`/`printenv` nem abra o arquivo de ambiente
19
20
  onde a chave fica.
@@ -26,7 +26,7 @@ Esta regra se aplica sempre que um agente trabalha em algo relacionado a um proj
26
26
 
27
27
  ### SE nao existe tracker
28
28
 
29
- - Se o projeto esta no cockpit mas nao tem tracker: avisar o Euriler ("Projeto X nao tem tracker. Quer que eu crie?")
29
+ - Se o projeto esta no cockpit mas nao tem tracker: criar o tracker pelo modelo (`business/templates/tracker-template.md`) e avisar o aluno em uma linha ("Criei o acompanhamento do projeto X.")
30
30
  - Se o trabalho nao esta relacionado a nenhum projeto do cockpit: trabalhar normalmente sem tracker
31
31
 
32
32
  ## O que NAO fazer
@@ -34,7 +34,7 @@ Esta regra se aplica sempre que um agente trabalha em algo relacionado a um proj
34
34
  - NAO criar tracker sem o projeto estar no cockpit
35
35
  - NAO alterar tarefas de outros agentes (so atualizar as suas)
36
36
  - NAO remover entradas do log (log e append-only)
37
- - NAO mudar o objetivo ou fases do projeto (so o Euriler/Jarvis fazem isso)
37
+ - NAO mudar o objetivo ou as fases do projeto sozinho (quem decide e o aluno; o Companion propoe)
38
38
 
39
39
  ## Formato do LOG
40
40
 
@@ -6,7 +6,11 @@
6
6
  {
7
7
  "matcher": "startup|resume|clear",
8
8
  "hooks": [
9
- { "type": "command", "command": "node .claude/hooks/auroq-sync.cjs --session-start", "timeout": 25000 }
9
+ {
10
+ "type": "command",
11
+ "command": "node .claude/hooks/auroq-sync.cjs --session-start",
12
+ "timeout": 25000
13
+ }
10
14
  ]
11
15
  }
12
16
  ],
@@ -14,14 +18,22 @@
14
18
  {
15
19
  "matcher": "",
16
20
  "hooks": [
17
- { "type": "command", "command": "node .claude/hooks/auroq-sync.cjs --remind", "timeout": 5000 }
21
+ {
22
+ "type": "command",
23
+ "command": "node .claude/hooks/auroq-sync.cjs --remind",
24
+ "timeout": 5000
25
+ }
18
26
  ]
19
27
  }
20
28
  ],
21
29
  "Stop": [
22
30
  {
23
31
  "hooks": [
24
- { "type": "prompt", "timeout": 20, "prompt": "[auroq-ate-o-fim] Você confere a última resposta de uma IA para um aluno leigo, dono de um negócio, antes de ela chegar a ele. Dados da conversa (JSON): $ARGUMENTS\n\nResponda só com JSON, sem mais nada.\n\nSe \"stop_hook_active\" for true, responda {\"ok\": true}.\n\nLibere ({\"ok\": true}) quando a resposta: responde uma pergunta ou explica algo que o aluno perguntou; entrega o trabalho pedido; diz com clareza o que segue rodando em segundo plano; pede ao aluno só o que é dele de verdade (senha, código do celular, CAPTCHA, pagamento, autorizar mensagem para outra pessoa, apagar algo, ou uma decisão de negócio como \"Decide: A ou B?\"); dá um passo a passo que o próprio aluno pediu para fazer sozinho; é o relatório de uma IA da equipe (a conversa começou com \"BRIEFING DA EQUIPE\"); ou é conversa curta.\n\nSegure ({\"ok\": false, \"reason\": \"...\"}) só em dois casos:\n1. A resposta devolve ao aluno trabalho que a IA conseguiria fazer sozinha: comando para ele rodar, passo a passo para ele clicar ou configurar sem ele ter pedido, \"próximos passos\" que a própria IA poderia executar, ou pergunta de permissão para um passo de rotina (\"quer que eu...?\", \"posso seguir?\"). Use reason: \"Antes de responder: faça agora o que você devolveu para o aluno e que você mesmo consegue fazer; o que for de rotina, decida e diga a suposição em uma linha. Depois responda de novo, curto: o que ficou pronto, o que segue rodando e o que de fato depende dele. Não fale desta checagem.\"\n2. A resposta diz que um site, arquivo, publicação, conserto ou entrega está pronto, no ar ou funcionando sem dizer que conferiu (abriu, testou, viu funcionando). Use reason: \"Antes de responder: confira de verdade o que você disse que ficou pronto (abra o arquivo ou o site, rode o teste). Depois responda de novo, curto, só com o que a conferência mostrou; se não der para conferir, diga o que falta. Não fale desta checagem.\"\n\nNa dúvida, libere." }
32
+ {
33
+ "type": "command",
34
+ "command": "node .claude/hooks/auroq-ate-o-fim.cjs",
35
+ "timeout": 10
36
+ }
25
37
  ]
26
38
  }
27
39
  ]
package/AGENTS.md CHANGED
@@ -128,6 +128,8 @@ mesma resposta que essa parte não foi feita e por quê; nunca pule em silêncio
128
128
 
129
129
  ## Salvar e entregar
130
130
 
131
+ - Com o app Auroq OS aberto, o próprio app salva e entrega no GitHub privado sozinho, a cada 15 minutos, ao
132
+ abrir e ao fechar. As regras abaixo valem quando o aluno pede para salvar na hora e sem o app.
131
133
  - Qualquer agente salva, entrega e puxa quando o aluno pede ("salva", "entrega", "puxa"), sem mandar
132
134
  trocar de agente. O ritual completo está em `.claude/rules/puxar-e-entregar.md`.
133
135
  - Antes de salvar: `git status --short`, separe o que esta conversa mexeu, mostre a lista em linguagem
package/CHANGELOG.md CHANGED
@@ -1,5 +1,42 @@
1
1
  ## Unreleased
2
2
 
3
+ - Conteúdo ao vivo (catálogo `auroq-core` 2.3.53, 29/10): **a skill do cofre de senhas foi dividida em seis peças** (entrada, 1Password, Infisical grátis com os resultados à parte, passar do grátis para o 1Password, e uso do dia a dia). Antes era um texto só de 62 mil caracteres, grande demais para o Claude Code ler de uma vez (o Marcos viu isso no teste de 27/10). O Companion continua entrando pelo mesmo gatilho (`conectar-cofre`) e a entrada diz qual peça abrir. O Companion agora pede o OK do aluno em uma frase antes de criar a chave do agente, de instalar o app e de passar as chaves (a proteção do Claude Code barrava esses passos sem aviso), explica a Chave Secreta e o Kit de Emergência do 1Password (guardar o PDF fora do computador e fora do GitHub), ensina a ligar o Windows Hello ou o Touch ID quando a digital não aparece, e não manda mais ligar a chave do app de novo quando ela já está ligada. Precisa do auroq-os 2.8.5 no npm (comando `--instalar-app` e códigos novos).
4
+ - Conteúdo ao vivo (catálogo `auroq-core` 2.3.52, 27/10): **documentação revisada para o jeito de hoje.** O guia do sistema que o Companion usa com o aluno, a fundação do Companion e as fichas do Consultor não apresentam mais o Ops como técnico nem o nome personalizado do Companion; ensinam a abrir uma conversa nova dentro do projeto e chamar o Companion (quantas quiser, uma por assunto, nunca um chat por squad) e dizem que, com o app aberto, o salvamento na internet é automático a cada 15 minutos e ao abrir e fechar. A skill `configurar-computador` e o guia longo do Ops dizem que as contas são conectadas pelo Companion na primeira conversa, não na instalação.
5
+ - Motor: README com o app Auroq OS como caminho novo e o terminal como o caminho que a plataforma ensina hoje; segunda máquina pelo app ("Trazer projeto que já existe"); atualizar, primeiro uso e agentes core sem o Ops; endereço da plataforma `arcane.arka.education`. `AGENTS.md` e `.auroq-core/como-funciona.md` dizem que, com o app aberto, salvar e entregar são automáticos a cada 15 minutos.
6
+ - Conteúdo ao vivo (catálogo `auroq-core` 2.3.51, 27/10): a renovação diz o salvamento certo: o app guarda a cópia na internet sozinho a cada 15 minutos e ao abrir e fechar (antes dizia 3 vezes por dia).
7
+ - Conteúdo ao vivo (catálogo `auroq-core` 2.3.50, 27/10): na renovação, o jeito padrão de trabalhar é abrir uma conversa nova dentro do projeto e chamar o Companion ali (não a tela Início), e dá para abrir quantas conversas quiser, uma por assunto (correção do Euriler).
8
+ - Conteúdo ao vivo (catálogo `auroq-core` 2.3.49, 27/10): o "como era, como é agora" da renovação virou uma fala pronta em linguagem de leigo (pedido do Euriler: "não na sua linguagem de IA"): o gerente que ia de mesa em mesa × o braço direito que chama a equipe; uma conversa por assunto, não por ajudante; as janelinhas da equipe trabalhando; sem palavras técnicas nesta etapa.
9
+ - Conteúdo ao vivo (catálogo `auroq-core` 2.3.48, 27/10): na renovação do aluno antigo, o Companion explica com destaque o jeito de trabalhar agora: tudo começa no Companion (não existe mais um chat por squad); ele chama os squads da equipe Arcane e abre os especialistas em abas próprias do app, acompanha e entrega; conversa nova é para frente nova de trabalho, não para squad.
10
+ - Conteúdo ao vivo (catálogo `auroq-core` 2.3.47, 27/10): ajustes da renovação depois do teste com uma aluna antiga simulada (pasta da versão 2.6.10 com Companion "Atlas"): o Companion não para mais para pedir licença em passo de rotina (abertura segue direto para a atualização; "ficou alguma dúvida?" saiu), e na etapa de ligar o que falta, uma conexão recusada ou que não conectou em 10 minutos vai para o backlog e ele oferece a próxima, sem pular para o pente-fino com itens ainda não oferecidos. A etapa em `.auroq/renovacao.json` é gravada antes da mensagem que fecha cada etapa.
11
+ - Conteúdo ao vivo (catálogo `auroq-core` 2.3.46, 27/10): **revisão do mês e plano da empresa no Companion.** Decisão do Euriler: além da revisão semanal (projetos) e da meta de 90 dias, o Companion olha o negócio uma vez por mês e mantém um plano de 12 meses. Skill nova `revisao-mensal` (`*mensal`, "como foi o mês?"): o Companion puxa sozinho no briefing quando chega a data `Proxima revisao do mes` do cockpit (vale pela revisão semanal daquela semana; nesse dia não tem pergunta do dia); uns 20 minutos e no máximo 4 perguntas: números do mês (pode pular), o que funcionou, se os projetos levam à meta (meta vencida é revista ali), o plano e o foco do mês que vem; grava o bloco do mês em `business/revisoes-do-mes.md` e o foco no cockpit. Skill nova `plano-da-empresa` (`*plano`): aonde o negócio quer chegar em 12 meses, produtos, canais, os 4 trimestres (cada um é uma meta de 90 dias), o que fica de fora, tempo e dinheiro, em `business/plano-da-empresa.md`; proposto na primeira revisão do mês, nunca na primeira conversa; a cada 90 dias a próxima meta vem do trimestre seguinte; no fim do ano, plano novo. O `*primeiro-uso` grava as datas da próxima revisão semanal e do mês. Pelo npm (próxima versão): a semente do cockpit ganha `Proxima revisao do mes` e a seção `FOCO DO MES`, e o `como-funciona.md` explica o mês e o ano.
12
+ - Conteúdo ao vivo (catálogo `auroq-core` 2.3.45, 27/10): **renovação do aluno que já usava o Auroq.** Decisão do Euriler: quem chega no app com uma pasta de antes não refaz a primeira conversa do zero. Skill nova `renovacao` no Companion (também por `*renovacao` ou "o que mudou?"): atualiza e confere o sistema; mostra o que mudou comparando com o que o aluno fazia (terminal, squads, Ops, Pack, Bootstrap, salvar), o que ele não precisa mais fazer e os superpoderes novos; explica que o Companion não tem mais nome personalizado e aposenta o atalho com o nome antigo; oferece todas as conexões e liberações que faltam, uma de cada vez (exceção à skill `liberacoes`); e passa um pente-fino no negócio (Mapa, projetos, nuvem, presença, equipe que ele não usa), pede o material que falta e fecha com um plano de 3 a 5 ações. Retomável em `.auroq/renovacao.json`; o fim grava também o `.auroq/primeiro-uso.json` que o app vigia.
13
+ - Conteúdo ao vivo (catálogo `auroq-core` 2.3.44, 27/10): o aluno também pode pedir uma liberação por conta própria (por exemplo, numa etapa do Embarque da plataforma); o Companion faz na hora, uma por pedido, sem emendar as outras.
14
+ - Conteúdo ao vivo (catálogo `auroq-core` 2.3.43, 27/10): a skill `liberacoes` aponta só para o guia do app (que mostra as telas de Logins dos sites e Controle do computador); a plataforma ainda não tem aula sobre elas.
15
+ - Conteúdo ao vivo (catálogo `auroq-core` 2.3.42, 27/10): **as liberações do app entram uma de cada vez, na hora em que a tarefa precisa.** Decisão do Euriler: o aluno não libera tudo de uma vez. Skill nova `liberacoes` no Companion: logins dos sites (quando uma tarefa precisa entrar num site com a conta do aluno), controle do computador (quando precisa usar um programa do computador; no Windows nada a fazer), cofre (skill `conectar-cofre`) e as conexões do nível 2 (quando a tarefa usa o serviço). O Companion explica em uma linha por que precisa agora, mostra onde clicar e confere fazendo a tarefa; "agora não" vai para o backlog sem insistir. A IA sem pedir permissão já vem ligada pelo app.
16
+ - Conteúdo ao vivo (catálogo `auroq-core` 2.3.41, 26/10): na conexão do GitHub, o Companion diz o que o app faz de verdade: o app copia o código e abre a página; o aluno cola o código no GitHub (Cmd+V / Ctrl+V), clica em Continue e em Authorize. Antes a skill mandava "conferir" o código.
17
+ - Conteúdo ao vivo (catálogo `auroq-core` 2.3.40, 26/10): **as contas do nível 1 (GitHub, Vercel e Supabase) passam a ser conectadas pelo Companion na primeira conversa.** Decisão do Euriler: conectar na instalação do app não funciona bem para o aluno iniciante. Skill nova `conexoes-essenciais`: o Companion explica cada conta em uma linha, abre as páginas (GitHub primeiro, com a conta criada junto se o aluno não tiver; a Vercel e o Supabase entram com o GitHub), confere e segue; o aluno só cria a conta, entra e autoriza, sem senha nem código na conversa, sempre no plano grátis. Usa o comando `auroq conexoes` do app quando existir; antes disso, a tela Configurações → Conexões. O `*primeiro-uso` ficou: conferência e instalação do que faltar (o aluno nunca baixa nem instala programa), material, perguntas, Mapa, conexões (P6), organizar (P7) e fecho (P8).
18
+ - Conteúdo ao vivo (catálogo `auroq-core` 2.3.39, 26/10): **o cofre de senhas saiu da primeira conversa.** Decisão do Euriler: é técnico demais para o aluno iniciante e é conexão do nível 2 (com domínio próprio e Google, que o app chama de "conecte quando precisar"). No `*primeiro-uso` o Companion confere só o sistema e as contas do nível 1 (GitHub, Vercel e Supabase, que o app conecta na tela "Conectar suas contas") e vai para a entrevista; o cofre entra quando a primeira tarefa precisar de uma senha, chave ou token (skill `conectar-cofre`).
19
+ - **Regra de projetos do aluno sem o nome do Euriler.** `project-tracker.md` mandava "avisar o Euriler" quando faltava o acompanhamento de um projeto e dizia que só "o Euriler/Jarvis" mudam objetivo e fases (cópia da regra pessoal dele). Agora o Companion cria o acompanhamento pelo modelo e avisa o aluno em uma linha; quem decide objetivo e fases é o aluno (o Companion propõe). Chega pelo npm.
20
+ ## 2.8.5 — 2026-10-29
21
+
22
+ Correções do teste real do Marcos (27/10, Windows 11 zerado). O cofre grátis (Infisical) rodou liso; o 1Password travou em quatro pontos, e o Companion girava em círculo. Nenhuma máquina de aluno foi tocada; o que dá para provar sem Windows foi provado com um 1Password de mentira que agora se comporta como o de verdade (veja a story `AUROQ-1password-automatico`, seção "Teste real do Marcos 27/10").
23
+
24
+ - **O laço "liga a chave do app" acabou.** O comando pedia a digital com um comando (`op whoami`) que o 1Password não usa para isso: ele responde "não está conectado" na hora, sem abrir a janela. O Companion lia isso como "a chave do app está desligada" e mandava o aluno ligar de novo, mesmo ligada. Agora a digital é pedida do jeito certo (`op vault list`, e se o app disser "sem sessão", `op signin` e mais uma tentativa), a aprovação vale para o resto da execução, e "a conta aparece mas o app não liberou" vira o aviso `aprovar-no-app`, com a receita do Windows Hello ou do Touch ID. O aviso `ligar-integracao` só sai quando o app não mostra conta nenhuma. Vale no Mac e no Windows.
25
+ - **Instalar o app do 1Password.** Novo `conectar-1password --instalar-app`: no Windows tenta o winget e, se ele falhar (no teste deu o erro 0x80070002), baixa o instalador oficial do 1Password, confere que a assinatura é válida e do 1Password (Agilebits) e só então instala; no Mac usa o Homebrew. O comando também percebe quando o app nem está no computador (`instalar-app`) em vez de mandar ligar uma chave que não existe.
26
+ - **Cópia da chave no cofre pessoal, no Windows.** O jeito antigo (mandar o molde por "pipe") falhava no PowerShell 5.1 com "invalid JSON in piped input". Agora o molde vai num arquivo temporário, só do usuário, e é apagado logo depois, com sucesso ou erro. A chave continua fora de argumento de comando e fora de log.
27
+ - **`--migrar` e `segredo` quando o programa do 1Password acabou de ser instalado.** No Windows, o programa `op` recém-instalado não aparece para a janela que já estava aberta, e o comando respondia "não enxerga o cofre Claude". Agora o comando atualiza a lista de programas e tenta de novo; se o `op` continuar sem aparecer, diz a verdade (`op-nao-achado`: "não achei o programa nesta janela, feche e abra") e não manda refazer a conexão à toa. As mensagens do `--migrar` também dizem qual foi o caso (chave não achada, chave recusada, cofre `Claude` invisível) e mostram a linha que o 1Password devolveu. Aviso honesto: ler a chave gravada já era feito (a hipótese do relatório do Marcos não bate com o código); a causa exata do caso dele não foi provada e só um novo teste no Windows mostra.
28
+ - Skill do Companion: dividida em seis peças, com o OK do aluno antes dos passos que a proteção do Claude Code barrava, Chave Secreta e Kit de Emergência, receita do Windows Hello e do Touch ID (veja a nota do catálogo `auroq-core` 2.3.53 acima).
29
+ - Instaladores fixam `auroq-os@2.8.5`.
30
+
31
+ ## 2.8.4 — 2026-10-27
32
+
33
+ - **O freio "trabalhar até o fim" parou de mostrar as instruções dele na tela do aluno.** Ele era um gancho de IA (`type: "prompt"`), e quando segurava uma resposta o Claude Code mostrava ao aluno o texto inteiro da conferência ("Você confere a última resposta de uma IA para um aluno leigo..."), sem como esconder (alunos relataram em 27/10). Agora é um gancho de comando (`.claude/hooks/auroq-ate-o-fim.cjs`): segura só quando a resposta termina pedindo licença para passo de rotina ("quer que eu...?", "posso seguir?") ou manda o aluno rodar comando que ele não pediu para rodar sozinho, e o aluno vê só uma linha curta ("Auroq: faça você mesmo..."). Libera o que é do aluno (senha, código, pagamento, apagar, mensagem, publicar, GitHub e entregar), "Decide: A ou B?" e IA da equipe. Saiu a conferência de "disse que está pronto sem conferir", que precisava de IA; essa regra segue no `AGENTS.md`. A manutenção troca o freio antigo pelo novo sozinha. Provado num Claude Code de verdade e em `tests/ate-o-fim.test.mjs`.
34
+ - Leva junto o que estava pronto na 2.8.3 (que não chegou ao npm). Instaladores fixam `auroq-os@2.8.4`.
35
+
36
+ ## 2.8.3 — 2026-10-27
37
+
38
+ Motor com a documentação e os avisos do jeito de hoje: README com o app Auroq OS como caminho novo; o Companion no lugar do Ops nos avisos do terminal (doctor, manutenção, proteção de segredos) e na segunda máquina; `AGENTS.md` e `.auroq-core/como-funciona.md` dizem que, com o app aberto, salvar e entregar são automáticos a cada 15 minutos; regra de projetos do aluno sem o nome do Euriler; cockpit novo com a revisão do mês. Instaladores fixam `auroq-os@2.8.3`. O conteúdo ao vivo (catálogo `auroq-core`) segue publicado à parte, versão a versão, na lista acima.
39
+
3
40
  ## 2.8.2 — 2026-10-23
4
41
 
5
42
  - Publicação final de 23/10 (ordem do Euriler: ele testa num Windows como aluno novo, do zero): o núcleo sai com o Companion orquestrador e sem o Ops para o aluno, e o catálogo ao vivo `auroq-core` vai para 2.3.38. O cliente do MCP passa a ser o `arcane-mcp` 0.7.1 (o exemplo da descrição do `squad_conhecimento` não mistura mais tópicos de squads diferentes, EMB-093). Os instaladores fixam `auroq-os@2.8.2`.
package/README.md CHANGED
@@ -1,22 +1,27 @@
1
1
  # Auroq OS — Sistema Operacional de IA para o negócio do aluno
2
2
 
3
- Transforma Claude Code, Codex CLI ou Grok Build num centro de comando inteligente para operar seu negocio digital.
3
+ O app **Auroq OS** (Mac e Windows) vira o centro de comando do seu negocio, com o Claude ou o ChatGPT (Codex)
4
+ por dentro. Este pacote (`auroq-os`) e o motor que o app instala e atualiza na pasta do seu negocio.
4
5
 
5
6
  **Pensar. Fazer. Lembrar.** Tudo com IA.
6
7
 
7
8
  ## Instalacao
8
9
 
9
- ### Pre-requisitos
10
- - Mac com Apple Silicon (recomendado)
11
- - Node.js 22+
12
- - Git
13
- - Claude Code, Codex CLI ou Grok Build (um deles basta)
10
+ ### O app Auroq OS (o caminho novo, chegando aos alunos)
14
11
 
15
- ### Setup
12
+ Baixe o app pelo link que a mentoria passa, abra e entre com o mesmo e-mail e senha da plataforma
13
+ ([arcane.arka.education](https://arcane.arka.education)). O app instala sozinho tudo o que precisa (Git, Node,
14
+ Python, os programas do GitHub, da Vercel e do Supabase e este motor), cria a pasta do seu negocio e abre a
15
+ primeira conversa com o Companion, que conhece voce e o seu negocio e conecta as suas contas. Voce nao abre
16
+ terminal nem baixa programa nenhum.
16
17
 
17
- Cole **um endereco** no terminal (o de dentro do Claude Code ou do Codex serve).
18
- Ele instala o Git, o motor do sistema, faz o login da mentoria, cria a pasta do seu
19
- negocio e monta tudo — sem senha e sem voce baixar nada na mao:
18
+ Ja usava o Auroq pelo terminal? Abra o app: ele acha a pasta do seu negocio sozinho, e o Companion faz a
19
+ renovacao (atualiza, mostra o que mudou e liga o que falta). Nada do que voce construiu se perde.
20
+
21
+ ### Pelo terminal (o caminho que a plataforma ensina hoje, e o do Linux)
22
+
23
+ Cole **um endereco** no terminal (o de dentro do Claude Code ou do Codex serve). Ele instala o Git, o motor,
24
+ faz o login da mentoria, cria a pasta do seu negocio e monta tudo:
20
25
 
21
26
  ```bash
22
27
  # Mac
@@ -26,25 +31,24 @@ curl -fsSL https://arka.education/install.sh | bash
26
31
  irm https://arka.education/install.ps1 | iex
27
32
  ```
28
33
 
29
- Depois, **feche e abra** o Claude Code ou o Codex — senao ele nao enxerga o que
30
- acabou de ser instalado.
31
-
32
- O caminho manual antigo foi aposentado. Use a instalacao guiada acima. Em negocio existente, peca ao Ops "atualiza o sistema" (no Claude Code ou no Codex). Os agentes e squads chegam pelo MCP, sem instalacao ou atualizacao de Pack.
33
-
34
+ Depois, **feche e abra** o Claude Code ou o Codex e chame o Companion (`/auroq-companion` ou `$companion`). Em
35
+ negocio existente, peca ao Companion "atualiza o sistema" (em pasta de antes de 23/10/2026, o atalho do Ops
36
+ ainda atende esse pedido). Os agentes e squads chegam ao vivo, sem instalar
37
+ nem atualizar Pack.
34
38
 
35
39
  > **Grok:** nao precisa de `sync:codex`. Ele descobre `.claude/commands/`,
36
40
  > `.claude/rules/` e `AGENTS.md` sozinho. Use Claude/Grok com slash commands;
37
41
  > use Codex com `$nome` apos o sync de skills.
38
42
 
39
43
  > **Acesso exclusivo para alunos da Mentoria Arcane.** O instalador pede o mesmo email + senha
40
- > que voce usa em [mentoria-arcane.vercel.app](https://mentoria-arcane.vercel.app).
44
+ > que voce usa em [arcane.arka.education](https://arcane.arka.education).
41
45
  > A sessao fica salva em `~/.arcane/credentials.json` e renova automaticamente.
42
46
 
43
47
  ### Comandos de sessao
44
48
 
45
49
  | Comando | O que faz |
46
50
  |---------|-----------|
47
- | `auroq-os manutencao` | Manutencao do motor no negocio existente; conteudo vem pelo MCP. **Caminho normal: pedir ao Ops "atualiza o sistema"** — ele roda `manutencao --agente` (sem perguntas; ultima linha `AUROQ_RESULTADO ...`). Rodar no terminal e so reserva |
51
+ | `auroq-os manutencao` | Manutencao do motor no negocio existente; conteudo vem pelo MCP. **Caminho normal: pedir ao Companion "atualiza o sistema"** — ele roda `manutencao --agente` (sem perguntas; ultima linha `AUROQ_RESULTADO ...`). Rodar no terminal e so reserva |
48
52
  | `auroq-os clone` | Continua o SEU negocio em outra maquina (ou na maquina de um colaborador) — baixa tudo do GitHub, ja instalado |
49
53
  | `auroq-os fix-gitignore` | Garante as protecoes de segredo no .gitignore (vault, .env, midia) e destraqueia segredos versionados |
50
54
  | `auroq-os login` | Forca novo login (substitui credencial atual) |
@@ -53,21 +57,21 @@ O caminho manual antigo foi aposentado. Use a instalacao guiada acima. Em negoci
53
57
  | `auroq-os doctor` | Diagnostico do suporte: arquivos, motor do sistema (e se o programa aberto pelo icone enxerga ele), registro do conteudo ao vivo, login e servidor |
54
58
  | `auroq-os register-mcp` | Reescreve o registro do conteudo ao vivo no projeto (use se o `doctor` apontar que ele falta) |
55
59
  | `auroq-os sync-codex` | Regenera e verifica as skills locais do Codex |
56
- | `auroq-os conectar-1password` | Liga o 1Password ao Auroq sozinho (Mac/Windows): instala o `op` se faltar, cria o cofre `Claude` e uma conta de servico que so enxerga esse cofre (sem data de validade), guarda a chave no computador e testa. Voce so aprova no app do 1Password. O Ops roda isto por voce (`--agente`). Opcoes: `--conta "<e-mail>"` (escolhe a conta quando o app tem mais de uma), `--rotacionar` (cria uma chave nova), `--estado` (mostra em que etapa voce parou, sem falar com o 1Password; com `--agente` imprime a linha `AUROQ_ESTADO ...`). Pode ser retomado a qualquer hora: ele reconfere cada etapa e continua de onde parou. O Companion roda isto sozinho quando falta o cofre (skill `conectar-cofre`, que pergunta qual cofre) |
57
- | `auroq-os conectar-cofre` | Escolhe e liga o cofre de senhas: **1Password** (pago, uns US$ 3 por mes, confira o preco na tela, recomendado; preenche senha no navegador) ou **Infisical** (gratis, so guarda as chaves que o agente usa). Opcoes: `--cofre 1password\|infisical` (sem ela, pergunta qual), `--regiao us\|eu` (Infisical), `--estado` (em que etapa voce parou, sem falar com o cofre; com `--agente` imprime a linha `AUROQ_ESTADO ...`), `--rotacionar` (chave nova) e `--migrar` (passa as chaves do Infisical para o 1Password, sem apagar nada; so depois que todas passaram o 1Password vira o cofre ativo, e `--ignorar-fora-do-formato` deixa no Infisical as chaves com nome que o Auroq nao usa). Ligar o 1Password sozinho nao troca o cofre de quem ja usa o Infisical; ligar o Infisical com o 1Password ativo troca, e as chaves do 1Password nao sao levadas (continuam la, `segredo ler NOME --cofre 1password`). O Ops e o Companion rodam isto por voce (`--agente`) |
60
+ | `auroq-os conectar-1password` | Liga o 1Password ao Auroq sozinho (Mac/Windows): instala o `op` se faltar, cria o cofre `Claude` e uma conta de servico que so enxerga esse cofre (sem data de validade), guarda a chave no computador e testa. Voce so aprova no app do 1Password. O Companion roda isto por voce (`--agente`). Opcoes: `--conta "<e-mail>"` (escolhe a conta quando o app tem mais de uma), `--rotacionar` (cria uma chave nova), `--instalar-app` (instala o app do 1Password: Windows pelo winget e, se ele falhar, pelo instalador oficial depois de conferir a assinatura; Mac pelo Homebrew), `--estado` (mostra em que etapa voce parou, sem falar com o 1Password; com `--agente` imprime a linha `AUROQ_ESTADO ...`). Pode ser retomado a qualquer hora: ele reconfere cada etapa e continua de onde parou. O Companion roda isto sozinho quando falta o cofre (skill `conectar-cofre`, que pergunta qual cofre) |
61
+ | `auroq-os conectar-cofre` | Escolhe e liga o cofre de senhas: **1Password** (pago, uns US$ 3 por mes, confira o preco na tela, recomendado; preenche senha no navegador) ou **Infisical** (gratis, so guarda as chaves que o agente usa). Opcoes: `--cofre 1password\|infisical` (sem ela, pergunta qual), `--regiao us\|eu` (Infisical), `--estado` (em que etapa voce parou, sem falar com o cofre; com `--agente` imprime a linha `AUROQ_ESTADO ...`), `--rotacionar` (chave nova) e `--migrar` (passa as chaves do Infisical para o 1Password, sem apagar nada; so depois que todas passaram o 1Password vira o cofre ativo, e `--ignorar-fora-do-formato` deixa no Infisical as chaves com nome que o Auroq nao usa). Ligar o 1Password sozinho nao troca o cofre de quem ja usa o Infisical; ligar o Infisical com o 1Password ativo troca, e as chaves do 1Password nao sao levadas (continuam la, `segredo ler NOME --cofre 1password`). O Companion roda isto por voce (`--agente`) |
58
62
  | `auroq-os segredo` | Le e guarda credenciais no cofre que voce escolheu, igual nos dois: `segredo ler\|gravar\|listar\|apagar\|qual <referencia>`. O valor de `gravar` entra por stdin, nunca como argumento; `ler` imprime o valor, entao use sempre dentro do comando que o usa (`X="$(auroq-os segredo ler Item/campo)" && comando "$X"`), nunca sozinho; a referencia e `op://Claude/<Item>/<campo>` ou `cofre://<Item>/<campo>`. Com 1Password, `op read` direto continua valendo. Squads, skills e agentes usam este comando |
59
63
 
60
64
  > **Um cofre de senhas e obrigatorio** para guardar credenciais: senha, token e chave nunca ficam em arquivo do
61
65
  > projeto. Em `business/vault/` fica so o status e a referencia `op://...`, nunca o valor. Voce escolhe:
62
66
  >
63
- > - **1Password (recomendado, pago).** Quem nao tem e guiado pelo Ops (ou pelo Companion) a criar a conta (teste
67
+ > - **1Password (recomendado, pago).** Quem nao tem e guiado pelo Companion a criar a conta (teste
64
68
  > gratis de 14 dias, sem cartao; o plano Individual custa ~US$ 2,99 a 3,99/mes, confira o preco na tela). Voce so
65
69
  > (1) cria a conta, (2) instala o app, (3) liga "Integrar com a CLI do 1Password" em Configuracoes >
66
- > Desenvolvedor e (4) aprova com a digital (Mac) ou o Windows Hello. O resto o Ops faz. Preenche senha no
70
+ > Desenvolvedor e (4) aprova com a digital (Mac) ou o Windows Hello. O resto o Companion faz. Preenche senha no
67
71
  > navegador.
68
72
  > - **Infisical (gratis).** Para quem nao quer gastar nem 1 real. Voce so (1) cria a conta em
69
73
  > https://app.infisical.com/signup (plano gratis; **nao** clique em "Start a free trial", que e o teste dos
70
- > planos pagos e pede cartao) e (2) aprova o login que abre no navegador. O resto o Ops faz. Nao e tao bom: **nao
74
+ > planos pagos e pede cartao) e (2) aprova o login que abre no navegador. O resto o Companion faz. Nao e tao bom: **nao
71
75
  > preenche senha no navegador**, so guarda as chaves que o agente usa. Plano gratis (confira os limites na tela):
72
76
  > 5 vagas (voce e o agente Auroq; um segundo computador ganha chave nova mas nao gasta vaga), sem historico de versoes e sem registro de auditoria. Os termos do
73
77
  > Infisical falam em uso profissional e o gratis pode mudar. Se um dia assinar o 1Password, `conectar-cofre
@@ -100,24 +104,19 @@ os comandos existentes do seu negocio.
100
104
 
101
105
  ### Segunda maquina (ou colaborador)
102
106
 
103
- O Auroq nao mora no computador — mora no GitHub. Pra trabalhar em outra maquina,
104
- **nao instale de novo**: clone o que ja existe.
107
+ O Auroq nao mora so no computador: o app guarda uma copia do negocio no seu GitHub privado. Pra trabalhar em
108
+ outra maquina, **nao instale um negocio novo**: instale o app nela, entre com a sua conta e use "Trazer projeto
109
+ que ja existe" (do GitHub). Depois peca ao Companion "conecta meu cofre" se precisar das senhas nessa maquina.
105
110
 
106
- ```bash
107
- # na maquina nova (Claude Code instalado e logado)
108
- npx auroq-os clone # lista seus repos do GitHub e baixa o negocio inteiro
109
- cd meu-negocio
110
- claude
111
- /AuroqOS:agents:ops
112
- *conectar-cofre # 1Password: reaproveita a chave que ja existe no seu cofre (uma vez so nesta maquina; so aprovar no app). Infisical gratis: cria uma chave nova so para esta maquina (voce aprova o login no navegador). Antes, ele pergunta qual cofre voce usa
113
- *conectar-1password # atalho antigo, so para o 1Password
114
- ```
111
+ Sem o app: `npx auroq-os clone` lista seus repositorios do GitHub e baixa o negocio inteiro; depois abra o
112
+ `claude` (ou `codex`) na pasta e chame o Companion.
115
113
 
116
- Ritual diario em toda maquina: **abriu o `claude` → o sistema puxa sozinho o que mudou · terminou → diga "salva e entrega"** (qualquer agente executa o ritual do Ops; `*sync`/`*commit`/`*push` seguem como atalhos).
114
+ Com o app aberto, o trabalho e salvo e mandado para o GitHub sozinho (a cada 15 minutos, ao abrir e ao fechar).
115
+ Sem o app, diga "salva e entrega" no fim do trabalho.
117
116
  Colaborador usa conta propria de tudo (GitHub via convite, assinatura Claude propria,
118
117
  cofre 1Password ou Infisical com escopo) — nunca a senha do dono. **Colaborador nao precisa ser
119
118
  aluno**: o acesso dele e o convite do GitHub (o `clone` nao pede login); quem atualiza
120
- o sistema e o dono, e o colaborador recebe as atualizacoes automaticamente ao abrir o `claude`.
119
+ o sistema e o dono, e o colaborador recebe as atualizacoes automaticamente.
121
120
 
122
121
  ## Conteudo ao vivo
123
122
 
@@ -142,14 +141,13 @@ correcoes). Voce nao precisa vigiar nada: quando existe versao nova, o proprio s
142
141
  avisa — ao usar um squad ou agente do conteudo ao vivo e ao abrir o Claude Code no seu
143
142
  projeto — e pergunta se voce quer atualizar.
144
143
 
145
- Pra atualizar, e uma frase — dentro do Claude Code ou do Codex, com o Ops ativo
146
- (`/AuroqOS:agents:ops` ou `$ops`), ou respondendo "sim" ao aviso:
144
+ Pra atualizar, e uma frase para o Companion (no app ou no terminal), ou responder "sim" ao aviso:
147
145
 
148
146
  ```
149
147
  atualiza o sistema
150
148
  ```
151
149
 
152
- Voce nao abre terminal nem digita comando: o Ops salva um ponto de restauracao (commit)
150
+ Voce nao abre terminal nem digita comando: o Companion salva um ponto de restauracao (commit)
153
151
  se houver trabalho seu pendente, roda a manutencao e diz se precisa fechar e abrir o
154
152
  aplicativo. Se o login da plataforma tiver expirado, abre uma janela "Login Arcane" pra
155
153
  voce digitar o e-mail e a senha (nunca no chat). **Seus dados nunca sao tocados**:
@@ -157,7 +155,7 @@ memoria do Companion, documentos, cockpit, campanhas, squads que voce criou,
157
155
  personalizacoes e as suas permissoes do Claude Code ficam exatamente como estavam.
158
156
  O que se atualiza e so o framework.
159
157
 
160
- Reserva, so se o Ops nao abrir: na pasta do negocio, `npx -y auroq-os@latest manutencao`
158
+ Reserva, so se o Companion nao conseguir: na pasta do negocio, `npx -y auroq-os@latest manutencao`
161
159
  (Windows: `npx.cmd`).
162
160
 
163
161
  O historico do que mudou em cada versao fica no arquivo `CHANGELOG.md`, dentro do
@@ -232,7 +230,7 @@ exigido e `excluir --account --confirm-delete`. Apagar o historico da conta inte
232
230
  permanente); para voltar a gravar, escreva para euriler@arka.education. Excluir uma
233
231
  sessao nao encerra a gravacao.
234
232
 
235
- A atualizacao do coletor exige a manutencao no projeto (peca ao Ops "atualiza o sistema")
233
+ A atualizacao do coletor exige a manutencao no projeto (peca ao Companion "atualiza o sistema")
236
234
  e reabrir o host. O aviso de nova versao ao iniciar o Claude Code nao instala essa correcao.
237
235
  A publicacao do pacote tambem nao comprova que cada aluno ja atualizou.
238
236
 
@@ -249,10 +247,9 @@ agents/ → Seu exercito (companion, workers, minds, squads)
249
247
 
250
248
  ## Agentes Core
251
249
 
252
- | Agente | Comando | O que faz |
250
+ | Agente | Como chamar | O que faz |
253
251
  |--------|---------|-----------|
254
- | Companion | `/auroq-companion` ou `$companion` | Parceiro cognitivo. Situa, lembra, pensa junto |
255
- | Ops | `/AuroqOS:agents:ops` ou `$ops` | Git, deploy, ambiente, install |
252
+ | Companion | no app: conversa nova dentro do projeto; terminal: `/auroq-companion` ou `$companion` | Braco direito e chefe da equipe: pensa junto, lembra, chama os squads da Arcane e entrega; tambem instala, atualiza, conserta, conecta, salva e publica |
256
253
  | Organizer | `/auroq-organizer` ou `$organizer` | Organizacao, guarda documentos, limpeza, backup |
257
254
 
258
255
  ### Meta Squads (criadores de agentes)
@@ -267,12 +264,16 @@ agents/ → Seu exercito (companion, workers, minds, squads)
267
264
 
268
265
  ## Primeiro uso
269
266
 
270
- 1. Ative o Ops (`/AuroqOS:agents:ops` no Claude/Grok ou `$ops` no Codex) e peca o Bootstrap 1.
271
- 2. O Ops prepara browser oficial, Computer Use quando elegivel e Playwright como fallback, sempre com smoke test real.
272
- 3. Ative o Companion (`/auroq-companion` no Claude/Grok ou `$companion` no Codex).
273
- 4. O Companion monta o seu Mapa do Negocio (`docs/knowledge/mapa-do-negocio.md`): le o material que voce tiver,
274
- pergunta so o que faltou e completa o resto aos poucos (`*contexto`). Todo squad le esse resumo primeiro.
275
- 5. Pronto — o sistema ja te conhece.
267
+ 1. **No app:** a primeira conversa com o Companion abre sozinha no fim da instalacao. Ele le o material que voce
268
+ tiver, pergunta so o que faltou, monta o seu Mapa do Negocio (`docs/knowledge/mapa-do-negocio.md`, que todo
269
+ squad le primeiro), conecta GitHub, Vercel e Supabase e organiza os seus projetos.
270
+ 2. **Sem o app:** chame o Companion (`/auroq-companion` no Claude/Grok ou `$companion` no Codex). Ele confere o
271
+ computador (skill `configurar-computador`) e segue o mesmo caminho.
272
+ 3. Daqui pra frente: uma conversa com o Companion por assunto, quantas quiser. Ele chama a equipe; voce nao
273
+ precisa chamar squad nenhum.
274
+
275
+ O Companion e Companion para todo mundo (nao tem nome personalizado). O antigo Ops foi aposentado para o aluno:
276
+ a parte tecnica e com o Companion.
276
277
 
277
278
  ## Filosofia
278
279
 
@@ -289,13 +290,13 @@ agents/ → Seu exercito (companion, workers, minds, squads)
289
290
 
290
291
  ## Observabilidade e integridade do motor
291
292
 
292
- Apos publicacao, `npx -y auroq-os@2.8.2 doctor` mostra a fila local segura e os comandos pinados de
293
- manutencao/diagnostico. `npx -y auroq-os@2.8.2 manutencao` preserva o caminho existente
293
+ Apos publicacao, `npx -y auroq-os@2.8.5 doctor` mostra a fila local segura e os comandos pinados de
294
+ manutencao/diagnostico. `npx -y auroq-os@2.8.5 manutencao` preserva o caminho existente
294
295
  de consentimento legado, studentFiles, customizacoes e dados do negocio. Nao ha
295
296
  migracao forcada. O registro MCP aponta para `arcane-mcp@0.7.1` — o pin mora no campo
296
297
  `arcaneMcpPin` do package.json (fonte unica; o servidor le o mesmo campo no npm).
297
298
  `npm run release:verify` recusa publicar com um pin que o npm nao resolva.
298
- Os instaladores do repositorio ficam preparados para 2.8.2; as copias publicas so recebem
299
+ Os instaladores do repositorio ficam preparados para 2.8.5; as copias publicas so recebem
299
300
  a versao apos os gates nativos e a verificacao do tarball publicado.
300
301
  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.
301
302