auroq-os 2.8.1 → 2.8.2
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.
- package/.auroq-core/como-funciona.md +4 -5
- package/.auroq-core/core-config.yaml +1 -1
- package/.claude/CLAUDE.md +2 -3
- package/.claude/rules/agent-authority.md +8 -5
- package/.claude/rules/mcp-usage.md +2 -2
- package/.claude/rules/memoria-inteligente.md +2 -2
- package/.claude/rules/operacao-autonoma.md +11 -2
- package/.claude/rules/puxar-e-entregar.md +7 -7
- package/.claude/settings.json +7 -0
- package/.synapse/agent-ops +1 -1
- package/AGENTS.md +40 -14
- package/CHANGELOG.md +75 -0
- package/README.md +46 -12
- package/agents/organizer/agents/organizer.md +4 -4
- package/bin/auroq-os.js +33 -5
- package/installer/install.ps1 +2 -2
- package/installer/install.sh +2 -2
- package/lib/cofre.js +1453 -0
- package/lib/infisical-api.js +670 -0
- package/lib/infisical-cli.js +869 -0
- package/lib/infisical.js +1271 -0
- package/lib/legacy-shims.json +2 -1
- package/lib/onepassword.js +1315 -22
- package/lib/runtime-integrity.json +23 -7
- package/package.json +3 -3
|
@@ -20,11 +20,10 @@ a IA domina o **como**.
|
|
|
20
20
|
|
|
21
21
|
| Tipo | O que é | Exemplo |
|
|
22
22
|
|------|---------|---------|
|
|
23
|
-
| **Companion** | Chefe da equipe e parceiro do aluno. Situa, lembra, pensa junto
|
|
23
|
+
| **Companion** | Chefe da equipe e parceiro do aluno. Situa, lembra, pensa junto, chama quem faz e cuida do técnico (instala, atualiza, conserta, conecta) | `/auroq-companion` |
|
|
24
24
|
| **Mentes** | Pensam e julgam: consultam, mentoram, avaliam | Clone, mente sintética, consultor |
|
|
25
25
|
| **Workers** | Executam uma função (um cargo) | um worker de atendimento |
|
|
26
26
|
| **Squads** | Vários agentes com etapas e conferência de qualidade | Squad de conteúdo, de anúncios |
|
|
27
|
-
| **Ops** | O técnico: instala, atualiza, conserta, conecta | `/AuroqOS:agents:ops` |
|
|
28
27
|
| **Forjas** | Criam agentes novos para o negócio do aluno | Squad Forge, Mind Forge, Worker Forge, Clone Forge, ETLmaker |
|
|
29
28
|
|
|
30
29
|
Subtipos de mente: **Clone** (replica uma pessoa real), **Mente sintética** (junta vários
|
|
@@ -45,13 +44,13 @@ pasta-do-negocio/
|
|
|
45
44
|
├── .claude/
|
|
46
45
|
│ ├── CLAUDE.md # porta de entrada do Claude Code (importa o AGENTS.md)
|
|
47
46
|
│ ├── rules/ # regras do sistema + custom-do-aluno.md (do aluno)
|
|
48
|
-
│ ├── commands/ # atalhos dos agentes (/auroq-companion, /
|
|
47
|
+
│ ├── commands/ # atalhos dos agentes (/auroq-companion, /auroq-consultor...)
|
|
49
48
|
│ ├── output-styles/ # estilo de resposta Direto
|
|
50
49
|
│ └── hooks/ # automações (Synapse, sincronização, histórico)
|
|
51
50
|
├── .auroq-core/ # núcleo do sistema (constitution, configuração) — não mexer
|
|
52
51
|
├── .synapse/ # lembretes curtos que o sistema injeta em cada conversa
|
|
53
52
|
├── agents/companion/data/ # memória: onde paramos, decisões, padrões, pendências
|
|
54
|
-
├── business/ # o negócio: cockpit, campanhas, processos, vault (fora do git)
|
|
53
|
+
├── business/ # o negócio: cockpit, campanhas, processos, vault (só status e referências do cofre de senhas, 1Password ou Infisical, fora do git)
|
|
55
54
|
└── docs/knowledge/ # conhecimento do aluno
|
|
56
55
|
├── mapa-do-negocio.md # resumo de uma página que todo squad lê primeiro (o Companion mantém: *contexto)
|
|
57
56
|
├── expert-mind/ # quem o aluno é: propósito, identidade, valores, tom de voz, história
|
|
@@ -69,7 +68,7 @@ Texto completo em `.auroq-core/constitution.md`.
|
|
|
69
68
|
| Artigo | Princípio |
|
|
70
69
|
|--------|-----------|
|
|
71
70
|
| I | O terminal é o centro de comando: o negócio passa pela pasta, ferramentas externas são braços |
|
|
72
|
-
| II | Cada um faz o seu: o técnico (push forçado, MCP, infraestrutura, atualização) é do
|
|
71
|
+
| II | Cada um faz o seu: o técnico (push forçado, MCP, infraestrutura, atualização) é do Companion, pelas skills técnicas |
|
|
73
72
|
| III | Documentar é investir: o que não está escrito se perde |
|
|
74
73
|
| IV | Não inventar: fato, número e prova precisam de fonte |
|
|
75
74
|
| V | Qualidade com julgamento: o aluno aprova as entregas importantes |
|
package/.claude/CLAUDE.md
CHANGED
|
@@ -11,7 +11,6 @@ e o Grok leem. Ele entra aqui pela linha abaixo:
|
|
|
11
11
|
|
|
12
12
|
- As regras de `.claude/rules/` carregam sozinhas. `.claude/rules/custom-do-aluno.md` vale acima de todas.
|
|
13
13
|
- O estilo de resposta é o Direto (`.claude/output-styles/direto.md`).
|
|
14
|
-
- Agentes pelo comando: `/auroq-companion`
|
|
15
|
-
`/atlas-companion`), `/AuroqOS:agents:ops`, `/auroq-consultor` e as forjas `/auroq-squad-forge`,
|
|
14
|
+
- Agentes pelo comando: `/auroq-companion`, `/auroq-consultor` e as forjas `/auroq-squad-forge`,
|
|
16
15
|
`/auroq-mind-forge`, `/auroq-worker-forge`, `/auroq-clone-forge`, `/auroq-etlmaker`. O aluno não
|
|
17
|
-
precisa usar nenhum: falar o que quer basta.
|
|
16
|
+
precisa usar nenhum: falar o que quer basta, e o Companion cuida do resto (inclusive do técnico).
|
|
@@ -1,12 +1,15 @@
|
|
|
1
1
|
# Agent Authority — Auroq OS
|
|
2
2
|
|
|
3
|
-
##
|
|
3
|
+
## O tecnico e do Companion (nao existe Ops desde 23/10/2026)
|
|
4
4
|
|
|
5
|
-
`git push --force` · Pull Request (`gh pr create` / `gh pr merge`) ·
|
|
6
|
-
|
|
5
|
+
`git push --force` (so com ordem explicita do aluno) · Pull Request (`gh pr create` / `gh pr merge`) ·
|
|
6
|
+
MCP add/remove/configure · configurar o computador · atualizar o sistema: o Companion faz, pelas skills
|
|
7
|
+
tecnicas dele (`conserto-tecnico`, `salvar-e-sincronizar`, `publicar-site`, `atualizar-sistema`,
|
|
8
|
+
`configurar-computador`). Squad ou worker que esbarrar nisso passa ao Companion; nunca manda o aluno a
|
|
9
|
+
outro agente.
|
|
7
10
|
|
|
8
|
-
**Salvar, entregar e puxar NAO sao exclusivos.**
|
|
9
|
-
|
|
11
|
+
**Salvar, entregar e puxar NAO sao exclusivos.** Qualquer agente ativo executa o ritual da skill
|
|
12
|
+
`salvar-e-sincronizar` quando o aluno pede, sem troca de agente (`rules/puxar-e-entregar.md`).
|
|
10
13
|
|
|
11
14
|
## Quem faz o que
|
|
12
15
|
|
|
@@ -16,9 +16,9 @@ SEMPRE preferir ferramentas nativas do Claude Code sobre MCP, **exceto** conteú
|
|
|
16
16
|
|
|
17
17
|
## MCP Governance
|
|
18
18
|
|
|
19
|
-
Gestao de MCP servers (add/remove/configure) e **
|
|
19
|
+
Gestao de MCP servers (add/remove/configure) e do **Companion**, pelas skills `conserto-tecnico` e `configurar-computador`.
|
|
20
20
|
|
|
21
|
-
Outros agentes sao **consumidores** de MCP, nao administradores. Se precisar de gestao MCP,
|
|
21
|
+
Outros agentes sao **consumidores** de MCP, nao administradores. Se precisar de gestao MCP, deixar com o Companion.
|
|
22
22
|
|
|
23
23
|
## Quando usar MCP
|
|
24
24
|
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
## Regra principal: fim de tarefa, memoria salva
|
|
6
6
|
|
|
7
|
-
No fim de CADA tarefa concluida, o agente ativo (Companion,
|
|
7
|
+
No fim de CADA tarefa concluida, o agente ativo (Companion, qualquer squad, skill ou a equipe que
|
|
8
8
|
o Companion abre, no Claude ou no Codex) salva sem esperar pedido, antes da resposta final. Com o app
|
|
9
9
|
Auroq OS aberto, a memoria tambem e consolidada sozinha a cada ~30 min e logo que um trabalho termina;
|
|
10
10
|
sem o app (so no terminal), esta regra e o que garante a memoria:
|
|
@@ -45,7 +45,7 @@ SE o Companion percebe comportamento recorrente (so Companion faz isso):
|
|
|
45
45
|
|
|
46
46
|
### 5. Sessao Encerrando
|
|
47
47
|
SE o aluno indica que vai fechar ou pede commit final:
|
|
48
|
-
→
|
|
48
|
+
→ No ritual de salvar (skill `salvar-e-sincronizar`), conferir: contexto e trackers atualizados?
|
|
49
49
|
→ Atualizar `agents/companion/data/contexto-dinamico.md` com onde paramos
|
|
50
50
|
|
|
51
51
|
### 6. Tarefa Concluida
|
|
@@ -6,8 +6,17 @@
|
|
|
6
6
|
## Ordem das ferramentas
|
|
7
7
|
|
|
8
8
|
1. Ferramenta nativa, CLI, API, conector ou MCP próprio da tarefa, já configurado.
|
|
9
|
-
2. Se faltar autenticação: o
|
|
10
|
-
|
|
9
|
+
2. Se faltar autenticação: o cofre do aluno (1Password, cofre `Claude`; ou Infisical, se ele escolheu o grátis)
|
|
10
|
+
antes de pedir ao aluno. Leia com `npx -y auroq-os@latest segredo ler <referência>` (Windows: `npx.cmd`, pois no Codex/PowerShell o `npx` sem `.cmd`
|
|
11
|
+
é bloqueado; serve para os dois cofres; com 1Password, `op read "op://Claude/<Item>/<campo>"` direto também vale)
|
|
12
|
+
e guarde com `segredo gravar` (valor por stdin, nunca em argumento). Nunca rode `segredo ler` sozinho (nem `op read`): leia
|
|
13
|
+
dentro do comando que usa o valor, numa variável (`X="$(npx -y auroq-os@latest segredo ler Item/campo)" && comando "$X"`),
|
|
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
|
+
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
|
|
17
|
+
retome a tarefa. Leia cada credencial uma vez por conversa e reaproveite o valor (a chave tem teto de leituras
|
|
18
|
+
por hora, por minuto ou por dia, conforme o cofre); nunca rode `env`/`printenv` nem abra o arquivo de ambiente
|
|
19
|
+
onde a chave fica.
|
|
11
20
|
3. Web: a superfície oficial conectada ao navegador quando existir (Claude in Chrome no Claude Code;
|
|
12
21
|
Browser ou Chrome no app do ChatGPT/Codex).
|
|
13
22
|
4. Playwright para testes repetíveis, página, console e rede, coleta estruturada ou quando o programa
|
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
# Salvar, Entregar e Puxar — Qualquer Agente Executa o Ritual
|
|
1
|
+
# Salvar, Entregar e Puxar — Qualquer Agente Executa o Ritual
|
|
2
2
|
|
|
3
3
|
> O aluno NUNCA precisa trocar de agente pra salvar, entregar ou puxar trabalho.
|
|
4
|
-
> Quem estiver ativo (Companion, Organizer, squad, worker ou Claude sem agente) executa o ritual
|
|
5
|
-
> O
|
|
4
|
+
> Quem estiver ativo (Companion, Organizer, squad, worker ou Claude sem agente) executa o ritual por baixo.
|
|
5
|
+
> O ritual mora na skill `salvar-e-sincronizar` do Companion (nao existe Ops desde 23/10/2026).
|
|
6
6
|
|
|
7
7
|
## Intents (linguagem natural → acao)
|
|
8
8
|
|
|
@@ -29,9 +29,9 @@ Exemplo: `progresso: NDF Workshop fase 1 concluida — LP, flows e criativos pro
|
|
|
29
29
|
Momentos naturais de salvar: fim de sessao, troca de assunto, etapa de projeto
|
|
30
30
|
concluida, decisao importante tomada, antes de fechar o computador.
|
|
31
31
|
|
|
32
|
-
## O ritual — fonte da verdade:
|
|
32
|
+
## O ritual — fonte da verdade: skill `salvar-e-sincronizar` (`agents/companion/tasks/salvar-e-sincronizar.md`)
|
|
33
33
|
|
|
34
|
-
Leia as
|
|
34
|
+
Leia as partes `*commit`, `*pre-push` e `*sync` da skill e execute os passos como estao. O minimo inegociavel:
|
|
35
35
|
|
|
36
36
|
- **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 aluno** (regra 7) → `git add` SO desses arquivos, um a um (NUNCA `git add -A`/`git add .`, NUNCA `business/vault/`, `.env`, chaves) → commit → confirmar ao aluno em 1 linha.
|
|
37
37
|
- **ENTREGAR:** pre-push OBRIGATORIO (vault/.env fora do staging, `.gitignore` protege, nenhum arquivo gigante, branch certa) → `git push` → confirmar.
|
|
@@ -39,10 +39,10 @@ Leia as secoes `*commit`, `*pre-push` e `*sync` do ops.md e execute os passos co
|
|
|
39
39
|
|
|
40
40
|
## Regras
|
|
41
41
|
|
|
42
|
-
1. Nao pedir troca de agente. Nao dizer "chama o
|
|
42
|
+
1. Nao pedir troca de agente. Nao dizer "chama o tecnico". Faca.
|
|
43
43
|
2. **Nunca entregar (push) sem o aluno pedir.** O sistema so PUXA sozinho (hook de abertura) — entregar e decisao dele.
|
|
44
44
|
3. As travas do pre-push valem pra TODO agente — sao o que impede senha de subir pro GitHub.
|
|
45
|
-
4.
|
|
45
|
+
4. Fica com o Companion (skills tecnicas): `git push --force` (so com ordem explicita do aluno), Pull Request (`gh pr`), MCP/infra, configurar o computador, atualizar o sistema.
|
|
46
46
|
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 aluno em 1-2 linhas, sem drama, e siga.
|
|
47
47
|
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.
|
|
48
48
|
7. **A pasta e compartilhada; a conversa nao.** Outras janelas, agentes e squads escrevem
|
package/.claude/settings.json
CHANGED
|
@@ -17,6 +17,13 @@
|
|
|
17
17
|
{ "type": "command", "command": "node .claude/hooks/auroq-sync.cjs --remind", "timeout": 5000 }
|
|
18
18
|
]
|
|
19
19
|
}
|
|
20
|
+
],
|
|
21
|
+
"Stop": [
|
|
22
|
+
{
|
|
23
|
+
"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." }
|
|
25
|
+
]
|
|
26
|
+
}
|
|
20
27
|
]
|
|
21
28
|
}
|
|
22
29
|
}
|
package/.synapse/agent-ops
CHANGED
|
@@ -6,5 +6,5 @@ OPS_RULE_2=O aluno e leigo em tecnologia — nunca assumir que ele sabe o que e
|
|
|
6
6
|
OPS_RULE_3=Quando o aluno precisar agir, dar receita de bolo: o que fazer, o que colar, o que vai aparecer, como saber que deu certo
|
|
7
7
|
OPS_RULE_4=Uma fase por vez; so avancar quando os checks da fase atual passarem de verdade
|
|
8
8
|
OPS_RULE_5=Detectar o sistema operacional antes de instalar e nunca misturar comandos de Mac e Windows
|
|
9
|
-
OPS_RULE_6=Nunca pedir segredo colado no chat; credencial vai para o 1Password ou
|
|
9
|
+
OPS_RULE_6=Nunca pedir segredo colado no chat; credencial vai para o cofre do aluno (1Password, cofre Claude; ou Infisical se ele escolheu o gratis); nao existe vault local de valores
|
|
10
10
|
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/AGENTS.md
CHANGED
|
@@ -19,12 +19,14 @@ Se alguma instrução antiga desta pasta contradisser estas regras, valem estas.
|
|
|
19
19
|
2. O **Companion** é o chefe da equipe. O aluno fala com ele; ele entende o pedido, escolhe quem faz e entrega.
|
|
20
20
|
3. A equipe (squads, skills, Consultor, forjas e o próprio Companion) chega ao vivo pelo MCP `arcane`,
|
|
21
21
|
catálogos `auroq-core` e `arcane-pack`. Nunca procurar esse conteúdo em `agents/`.
|
|
22
|
-
4.
|
|
22
|
+
4. Não existe técnico à parte: o Companion também instala, atualiza, conserta e conecta ferramentas, pelas
|
|
23
|
+
skills técnicas dele (`conserto-tecnico`, `salvar-e-sincronizar`, `publicar-site`, `atualizar-sistema`,
|
|
24
|
+
`configurar-computador`, `conectar-cofre`, `companion-externo`). O antigo Ops foi aposentado para o aluno.
|
|
23
25
|
5. Memória: `agents/companion/data/` (onde paramos, decisões, pendências), conhecimento em
|
|
24
26
|
`docs/knowledge/`, projetos em `business/cockpit.md` e nos trackers de cada projeto.
|
|
25
27
|
6. Salvar é commit; entregar é mandar para o GitHub privado do aluno.
|
|
26
28
|
7. Não precisa decorar comando: o aluno fala do jeito dele. Atalhos existem (Claude: `/auroq-companion`,
|
|
27
|
-
`/
|
|
29
|
+
`/auroq-consultor`; Codex: `$companion`, `$consultor`).
|
|
28
30
|
8. Como o sistema funciona por dentro (tipos de agente, ciclos, conhecimento, projetos):
|
|
29
31
|
`.auroq-core/como-funciona.md`. Leia só quando o aluno perguntar ou a tarefa precisar.
|
|
30
32
|
|
|
@@ -38,7 +40,7 @@ Se alguma instrução antiga desta pasta contradisser estas regras, valem estas.
|
|
|
38
40
|
(`*contexto`), com a fonte. Dedução nunca vira fato sem o aluno confirmar.
|
|
39
41
|
|
|
40
42
|
Se a ferramenta do MCP `arcane` falhar, mostre a mensagem como veio e pare. Exceções: pedido de
|
|
41
|
-
atualizar o sistema ou consertar a conexão (o
|
|
43
|
+
atualizar o sistema ou consertar a conexão (o Companion roda a manutenção local, skill `atualizar-sistema`) e servidor que recusou o
|
|
42
44
|
acesso quando a pasta do agente existe em `agents/` (aí vale a versão local, avisando em uma linha).
|
|
43
45
|
|
|
44
46
|
**Execução preparada pelo MCP:** Apps, Edição, Edição Euriliana, Carrossel, Tráfego, Low Ticket e Bia
|
|
@@ -49,14 +51,25 @@ nunca como fonte do método.
|
|
|
49
51
|
|
|
50
52
|
## O Companion orquestra sozinho
|
|
51
53
|
|
|
52
|
-
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
54
|
+
- **Toda conversa nesta pasta é com o Companion**, o braço direito do aluno (que é o dono da empresa): ele
|
|
55
|
+
entende o pedido, passa para quem faz, acompanha, revisa, manda refazer quando precisa e entrega pronto. O
|
|
56
|
+
aluno nunca precisa chamar squad, skill ou agente. Numa conversa nova, responda ao pedido; o briefing
|
|
57
|
+
completo do Companion só quando o aluno pedir ("onde estamos?").
|
|
58
|
+
- **Pedido de fazer algo de tamanho real** (texto de venda, página, site, anúncios, conteúdo, vídeo, oferta,
|
|
59
|
+
pesquisa), mesmo que seja uma entrega só: antes de começar, carregue a skill `orquestrar` do Companion (MCP
|
|
60
|
+
`arcane`, `squad_passo` com recurso_id `companion` e passo `orquestrar`) e siga. Ela diz como escolher quem
|
|
61
|
+
faz e com qual IA, escrever o briefing, soltar as partes (as independentes ao mesmo tempo, sem teto fixo de
|
|
62
|
+
quantas), acompanhar, revisar e mandar refazer.
|
|
63
|
+
- Conversa, dúvida, decisão junto e ajuste pequeno: o Companion faz direto, sem acionar ninguém.
|
|
64
|
+
- **A dica do aluno manda:** "usa o squad de anúncios", "faz com a skill de carrossel" → siga. Se ele chamou um
|
|
65
|
+
squad ou agente direto, siga o que ele chamou.
|
|
56
66
|
- Para saber quem faz o quê: `catalogo_listar` e `busca` do MCP `arcane`, mais os comandos em
|
|
57
67
|
`.claude/commands/` e o que o aluno criou em `agents/` ou `squads/`.
|
|
68
|
+
- Toda entrega é aberta e conferida antes de ir ao aluno; o que vai a público (página, anúncio, oferta, e-mail
|
|
69
|
+
para lista) passa também pela revisão de outra IA. Diga em uma linha quem trabalhou.
|
|
58
70
|
- O aluno só escolhe quando falta uma decisão de negócio que ninguém consegue tomar por ele.
|
|
59
|
-
-
|
|
71
|
+
- **IA da equipe:** se a conversa começou com "BRIEFING DA EQUIPE", você não é o Companion: faça só a sua
|
|
72
|
+
parte, não monte equipe e devolva o relatório pedido no briefing.
|
|
60
73
|
|
|
61
74
|
## Escopo e autonomia
|
|
62
75
|
|
|
@@ -66,7 +79,12 @@ nunca como fonte do método.
|
|
|
66
79
|
- Antes de perguntar, procure no arquivo, na memória, no histórico ou na ferramenta. Decidiu sozinho:
|
|
67
80
|
diga a suposição em uma linha.
|
|
68
81
|
- Resolva antes de devolver: ferramentas, CLIs, MCPs e logins já configurados primeiro. Credencial vem
|
|
69
|
-
do
|
|
82
|
+
do cofre do aluno, nunca do chat: 1Password (recomendado, cofre `Claude`) ou Infisical (grátis, para
|
|
83
|
+
quem escolheu não pagar). Leitura e gravação por `npx -y auroq-os@latest segredo ler|gravar <referência>`
|
|
84
|
+
(com 1Password, `op read` direto também vale; no Windows use `npx.cmd`, porque no Codex/PowerShell o `npx`
|
|
85
|
+
sem `.cmd` é bloqueado). Nunca rode `segredo ler` sozinho (nem `op read`): leia dentro do comando que usa o
|
|
86
|
+
valor, numa variável (`X="$(npx -y auroq-os@latest segredo ler Item/campo)" && comando "$X"`), para o valor
|
|
87
|
+
não voltar na conversa. Em `business/vault/` fica só status e referência `op://...`, nunca o valor.
|
|
70
88
|
- O que a ferramenta consegue fazer (abrir, clicar, configurar, conferir) é trabalho seu. Para o aluno
|
|
71
89
|
fica só o que é dele: senha pessoal, código do celular, CAPTCHA, pagamento ou decisão de negócio.
|
|
72
90
|
Nesse caso, peça uma ação mínima, como receita de bolo: o que fazer, o que vai aparecer, como saber
|
|
@@ -79,6 +97,10 @@ nunca como fonte do método.
|
|
|
79
97
|
conectado; depois Playwright; Computer Use por último (detalhe em `.claude/rules/operacao-autonoma.md`).
|
|
80
98
|
- Trabalho longo: checklist em arquivo (o tracker do projeto ou o documento de trabalho), marcado item
|
|
81
99
|
a item; retome por ele, não pela memória da conversa.
|
|
100
|
+
- **Trabalhe até o fim.** Antes de terminar cada resposta, duas conferências (no Claude Code o sistema também
|
|
101
|
+
confere sozinho): o que vou dizer que está pronto, eu conferi de verdade? Estou devolvendo ao aluno algo
|
|
102
|
+
que eu mesmo consigo fazer (comando para ele rodar, clique, "próximos passos", "quer que eu siga?")? Se sim,
|
|
103
|
+
faça antes de responder.
|
|
82
104
|
|
|
83
105
|
## Travas
|
|
84
106
|
|
|
@@ -87,7 +109,7 @@ Sem ordem explícita do aluno para aquela ação, nunca:
|
|
|
87
109
|
- gastar dinheiro, comprar ou assinar serviço;
|
|
88
110
|
- mandar mensagem, e-mail, post ou qualquer envio para cliente, lead ou outra pessoa;
|
|
89
111
|
- apagar dado ou arquivo do aluno;
|
|
90
|
-
- reescrever o histórico do git (`git push --force`
|
|
112
|
+
- reescrever o histórico do git (`git push --force`);
|
|
91
113
|
- mostrar, copiar ou trocar senha, token ou chave.
|
|
92
114
|
|
|
93
115
|
A ordem vale para aquela ação, não para as próximas. Se uma parte do pedido cair numa trava, diga na
|
|
@@ -141,13 +163,17 @@ mesma resposta que essa parte não foi feita e por quê; nunca pule em silêncio
|
|
|
141
163
|
- Decisão só quando nenhuma ferramenta resolve, assim: **Decide: A ou B?** A → o que acontece.
|
|
142
164
|
B → o que acontece.
|
|
143
165
|
- Sem preâmbulo, bajulação, emoji ou tabela quando uma frase resolve. Não termine oferecendo mais.
|
|
166
|
+
- Fale pouco: o aluno é leigo e ocupado. Nada de bastidor (comando, caminho técnico, nome de ferramenta) que
|
|
167
|
+
ele não pediu, nem as palavras worker, terminal, token, subagente, orquestração, briefing ou MCP.
|
|
168
|
+
- Durante um trabalho que demora, no máximo uma linha de vez em quando: o que está acontecendo e o que você
|
|
169
|
+
está fazendo ("Página pronta e revisada; os anúncios estão na segunda volta").
|
|
144
170
|
- Resposta que fez trabalho termina com duas linhas curtas: **Resumo:** do que se trata a conversa e o
|
|
145
|
-
que já ficou feito; **Onde parou:** o que
|
|
146
|
-
(ou "fechado, nada pendente"). Pergunta simples respondida em uma frase dispensa.
|
|
171
|
+
que já ficou feito; **Onde parou:** o que está pronto, o que segue rodando, o que ainda não (e por quê) e o
|
|
172
|
+
que espera pelo aluno (ou "fechado, nada pendente"). Pergunta simples respondida em uma frase dispensa.
|
|
147
173
|
|
|
148
174
|
## Privacidade
|
|
149
175
|
|
|
150
|
-
Sua memória e seus documentos ficam na sua máquina e no seu GitHub privado (senhas e `business/vault/`
|
|
176
|
+
Sua memória e seus documentos ficam na sua máquina e no seu GitHub privado (senhas e chaves ficam só no seu cofre, o 1Password ou, se você escolheu o grátis, o Infisical; `business/vault/` guarda apenas status e referências, nunca o valor). O histórico das sessões com os squads está previsto nos Termos de Uso: vem ligado para quem aceita os termos na plataforma (quem já tinha dito "não" continua sem gravar) e você desliga quando quiser em Minha Conta, "Guardar minhas conversas". Se a pasta do seu negócio tem dados de clientes, desligue. Além disso, a Arka registra qual conteúdo licenciado foi entregue, quando e pra qual conta — igual a uma nota de entrega.
|
|
151
177
|
|
|
152
178
|
## Onde o aluno customiza
|
|
153
179
|
|
|
@@ -161,7 +187,7 @@ Sua memória e seus documentos ficam na sua máquina e no seu GitHub privado (se
|
|
|
161
187
|
- O Codex não carrega `.claude/rules/` sozinho. Quando o assunto aparecer, leia a regra: salvar e
|
|
162
188
|
entregar em `puxar-e-entregar.md`, memória em `memoria-inteligente.md`, projetos em
|
|
163
189
|
`project-tracker.md`, ferramentas em `operacao-autonoma.md` e `mcp-usage.md`. As skills do Codex
|
|
164
|
-
ficam em `.agents/skills/` (
|
|
190
|
+
ficam em `.agents/skills/` (refaz com `node scripts/sync-codex-skills.mjs --clean`).
|
|
165
191
|
- O Grok lê `.claude/rules/` e `.claude/commands/`, mas o conteúdo ao vivo do MCP `arcane` não está
|
|
166
192
|
garantido nele.
|
|
167
193
|
- Use um programa por conversa. Antes de trocar entre Claude Code, Codex e Grok, salve onde parou.
|
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,73 @@
|
|
|
1
|
+
## Unreleased
|
|
2
|
+
|
|
3
|
+
## 2.8.2 — 2026-10-23
|
|
4
|
+
|
|
5
|
+
- 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`.
|
|
6
|
+
|
|
7
|
+
- **O Companion vira o braço direito do aluno (orquestrador mestre), decisão do Euriler (23/10).** Toda conversa na pasta é com o Companion: o aluno pede, e ele passa para quem faz (squad, skill ou agente), escolhe a IA de cada parte (Opus para pensar, Sonnet para produzir, Haiku para tarefa mecânica), escreve o briefing, solta as partes independentes ao mesmo tempo (sem teto fixo de quantas; os freios são o limite de uso do plano e a memória do computador), acompanha, revisa (o que vai a público passa também por outra IA), manda refazer (até duas voltas) e entrega pronto. A dica do aluno ("usa o squad de anúncios") manda. Conteúdo ao vivo (próximo catálogo `auroq-core`): skill nova `orquestrar` no Companion, persona 3.0.0 e modo de operar. No pacote: `AGENTS.md` (toda conversa é o Companion; quem foi aberto com "BRIEFING DA EQUIPE" faz só a sua parte; fala curta, com uma linha de andamento quando demora; duas conferências antes de responder).
|
|
8
|
+
- **Trabalhar até o fim (Claude Code).** Freio novo no fim de cada resposta, um gancho do próprio Claude do aluno (`type: "prompt"` no `.claude/settings.json`): se a resposta devolve ao aluno algo que a IA consegue fazer sozinha, ou diz que algo está pronto sem ter conferido, a IA volta, faz ou confere e responde de novo; no máximo uma volta por resposta. Libera conversa, explicação, decisão de negócio e o que é do aluno (senha, código, pagamento, mensagem a terceiro, apagar). Custa uma consulta rápida ao modelo de fundo do plano do aluno (~1 s, provado em 23/10). Codex e Grok seguem a mesma regra pelo `AGENTS.md`. A manutenção reconhece o freio pela marca `[auroq-ate-o-fim]` e não o duplica (teste em `manutencao-agente`).
|
|
9
|
+
- Conteúdo ao vivo (catálogo `auroq-core` 2.3.37, 23/10): **o Ops não existe mais para o aluno.** Tudo o que ele fazia virou skill do Companion, que roda na mesma conversa: `conserto-tecnico` (conferir e consertar o computador), `salvar-e-sincronizar` (salvar, entregar, puxar e conflito), `publicar-site`, `atualizar-sistema` (sistema e squads), `configurar-computador` (quem não usa o app e conexões extras), `companion-externo` e o Bitwarden dentro de `conectar-cofre`. O `AGENTS.md` não cita mais o Ops nem o atalho dele, e o primeiro uso conserta pela skill (decisão do Euriler: "não existe Ops; tudo vira skill que o Companion usa").
|
|
10
|
+
|
|
11
|
+
### 1Password automático: você liga uma chave e aprova, o Ops faz o resto
|
|
12
|
+
|
|
13
|
+
Decisão do Euriler (22/10): a credencial do aluno passa a ficar num cofre de verdade (o 1Password, recomendado; desde 23/10 o aluno que não quer gastar pode usar o Infisical grátis, ver a seção seguinte). O "cofre local" (a pasta `business/vault/` com os valores em texto) deixa de ser um caminho para guardar senha, chave ou token.
|
|
14
|
+
|
|
15
|
+
- **O que você faz agora são só quatro coisas.** Criar a conta do 1Password, instalar o app, ligar a chave "Integrar com a CLI do 1Password" nas configurações do app (Configurações > Desenvolvedor) e aprovar com a digital (Touch ID no Mac, Windows Hello no Windows) ou com a senha. Normalmente a aprovação é uma vez; se a janela aparecer de novo, é só aprovar de novo. O app precisa ficar aberto.
|
|
16
|
+
- **O Ops faz o resto sozinho.** Cria o cofre `Claude` na sua conta (se já existir, usa o que está lá e não mexe em nada) e a chave do agente (uma "conta de serviço" chamada `Auroq`), sem data de validade e com acesso só ao cofre `Claude`. O agente não enxerga mais nada da sua conta, nem o seu cofre pessoal. Depois confere, num terminal novo, se a chave funciona, e só então diz que está pronto.
|
|
17
|
+
- **A chave nunca aparece.** Ela nasce dentro do comando e vai direto para o arquivo do seu computador (Mac: `~/.zshenv`; Linux: `~/.bashrc`; Windows: variável de ambiente do seu usuário), com permissão só sua (se o arquivo for um atalho para uma pasta de configurações versionada no git, o comando recusa gravar ali, para a chave não ir parar no GitHub). O comando nunca mostra a chave nem a passa pela linha de comando; depois de gravada ela vira uma variável de ambiente sua, então o Ops nunca roda `env` nem abre esses arquivos.
|
|
18
|
+
- **Uma cópia no seu cofre pessoal.** O item "Auroq OS - token da conta de servico" fica guardado no seu cofre pessoal, que o agente não enxerga. Num segundo computador seu, o comando acha essa cópia e reaproveita a mesma chave em vez de criar outra (o 1Password aceita ~100 contas de serviço por conta). Se a cópia não puder ser guardada, a conexão vale do mesmo jeito e o Ops avisa.
|
|
19
|
+
- **O cofre local saiu como rota de credencial.** `business/vault/` continua existindo só para o status e para as referências `op://...`, nunca com o valor. A oferta "seguir com cofre local (menos seguro)" saiu do Ops, do `AGENTS.md` e dos guias.
|
|
20
|
+
- **Quem não tem 1Password é guiado a criar.** O Ops explica o caminho: teste grátis de 14 dias, sem cartão; depois, o plano Individual custa ~US$ 2,99 por mês (promoção do 1º ano, cobrança anual) a ~US$ 3,99 por mês (anual, preço regular) ou ~US$ 4,99 no mensal, e o Families ~US$ 4,49 a ~US$ 5,99 por mês. Os preços mudam: confira na tela. O Ops nunca digita dados de pagamento nem cria a conta por você.
|
|
21
|
+
- **Mais de uma conta no app?** O comando não adivinha: lista as contas e pede para você escolher em qual vai ficar o cofre (`--conta "<e-mail>"`). Se a única conta do app for de empresa (Teams ou Business), ele também pergunta antes de criar o cofre nela. Em conta de empresa (Teams ou Business) só o dono ou o administrador cria conta de serviço, por padrão; sem permissão, o comando para antes de criar qualquer coisa e explica.
|
|
22
|
+
- **O Companion liga o cofre sozinho (skill `conectar-1password`, hoje `conectar-cofre`).** Pipeline de 8 etapas, cada uma com o critério de "pronto": conta e plano → app instalado e chave "Integrar com a CLI" ligada → ferramenta `op` → aprovação com a digital → cofre `Claude` → chave do agente → teste em terminal novo → pronto (só depois do teste). Ele aciona no primeiro uso (conferência técnica), quando uma tarefa precisa de uma credencial e não acha a chave, e quando o `op` dá erro de autenticação; também responde ao `*cofre`. Fica retomável: o comando grava, em `~/.arcane/1password-etapas.json` (só neste computador, fora do GitHub, sem segredo e sem e-mail), até onde chegou; `--estado` mostra a etapa sem falar com o 1Password e sem gastar a cota, e rodar o comando de novo reconfere tudo e continua de onde parou, sem criar nada em duplicidade. O Ops e o Companion leem a cota com cuidado: cada credencial uma vez por conversa, com `op read`, e nunca rodam `env`/`printenv` nem abrem o arquivo onde a chave fica.
|
|
23
|
+
- **Mais cuidado com a sua conta.** Falha passageira (limite de uso, falta de internet, resposta estranha de um proxy) nunca é tratada como "chave morta": o comando para sem criar outra conta de serviço e sem arquivar a cópia boa, e diz para tentar de novo em alguns minutos. Antes de criar qualquer coisa ele confere que consegue guardar a chave: se o arquivo de configurações do seu terminal for um atalho ou estiver guardado no git (como repositórios de "dotfiles"), ou já tiver uma linha sua para essa chave, ele não grava (a chave iria para o GitHub, ou apagaria o que é seu) e avisa. Só uma execução por vez, e uma cópia da chave só é reaproveitada se for da mesma conta e só enxergar o cofre `Claude`.
|
|
24
|
+
- **Modo manual só como plano B.** O jeito antigo (você cria a conta de serviço no site do 1Password e copia o token) continua existindo atrás de `--manual`, escondido, para quem não puder usar o automático. Não faz parte do caminho principal.
|
|
25
|
+
- **Limite de uso.** Nos planos Individual e Families, a chave aceita ~1.000 leituras e ~100 escritas por hora, e a conta inteira ~1.000 chamadas por dia (confira na tela do 1Password). O Ops lê o que precisa uma vez por conversa e reaproveita o valor, em vez de ler de novo.
|
|
26
|
+
- **Trocar a chave.** `--rotacionar` cria uma chave nova mesmo com a atual funcionando. A antiga só deixa de valer quando você a revoga em 1password.com > Developer > Service accounts (o 1Password não tem comando para apagar conta de serviço). Se o endereço de login da conta mudar, a chave precisa ser trocada assim.
|
|
27
|
+
|
|
28
|
+
### Para o suporte
|
|
29
|
+
|
|
30
|
+
- **Comando:** `npx -y auroq-os@latest conectar-1password --agente` (Windows: `npx.cmd`; dê 10 minutos de tempo-limite à ferramenta). Sem `--agente` (aluno no terminal), se a chave do app ainda não estiver ligada, o comando espera até 5 min, olhando a cada 3 s, e segue sozinho.
|
|
31
|
+
- **Flags:** `--agente` (usado pelo Ops e pelo app: não espera, não pergunta e termina com uma linha só); `--conta "<e-mail>"` (escolhe a conta do app quando há mais de uma; aceita e-mail, endereço de login ou ID); `--rotacionar`; `--esperar N` (segundos; 0 não espera); `--manual` (plano B).
|
|
32
|
+
- **Linha lida pelo Ops (só com `--agente`):** `AUROQ_RESULTADO 1password=<ok|aguardando|erro> codigo=<codigo> [aviso=cofres-extras] [contas="a|b"] mensagem="..."`, no mesmo padrão da `manutencao --agente`. Código de saída: 0 para `ok` e para `aguardando` (falta uma ação do aluno, não é falha; assim a telemetria não registra falso `INSTALL_FAILED`) e 1 para `erro`.
|
|
33
|
+
- **Códigos `ok`:** `criada`, `reaproveitada` (achou a cópia no cofre pessoal), `ja-conectado` (pode vir com `aviso=cofres-extras`: a chave antiga enxerga mais cofres que o `Claude`; rode com `--rotacionar`).
|
|
34
|
+
- **Estado e retomada:** `--estado` (com `--agente`) imprime `AUROQ_ESTADO 1password=<pronto|em-andamento|nao-iniciado> proxima=<etapa> feitas=... token=<configurado|ausente> ultimo=<codigo> conferido=nao` (`conferido=nao`: não falou com o 1Password). O arquivo de estado fica em `~/.arcane/1password-etapas.json`; a trava de instância única, em `~/.arcane/1password.lock`.
|
|
35
|
+
- **Códigos `aguardando`:** `ligar-integracao` (a chave "Integrar com a CLI do 1Password" está desligada; o app aberto e desbloqueado é pré-requisito, e o erro `No accounts configured` também cai aqui), `escolher-conta` (mais de uma conta no app; as contas vêm no campo `contas`), `aprovar-no-app` (o aluno não aprovou a janela da digital), `confirmar-conta` (a conta do app parece de empresa: só segue com `--conta`) e `outra-execucao` (já tem uma conexão rodando neste computador; vale por até 15 minutos).
|
|
36
|
+
- **Códigos `erro`:** `sem-op` e `op-antigo` (o `op` não instalou ou é anterior à 2.30.0; ele atualiza sozinho quando consegue), `rede`, `conta-nao-encontrada` (o `--conta` não existe no app), `sem-cofre`, `cofre-duplicado` (a conta tem dois cofres `Claude`; o `op` deixa duplicar e o comando para sem criar nada), `sem-permissao` (conta de empresa em que o aluno não é dono nem administrador), `falha-criar`, `nao-gravou` (não conseguiu salvar a chave no computador), `token-recusado` (a chave foi salva, mas o teste falhou; a chave não se perde, rode de novo), `cofres-extras` (a chave nova enxerga mais que o `Claude`), `app-tem-prioridade` (o `op` respondeu pelo app e não pela chave), `conta-ambigua` (duas contas com o mesmo e-mail: use o endereço de login em `--conta`) e `token-indisponivel` (limite de uso, falta de internet ou demora do 1Password na hora de conferir a chave que já existe: o comando para SEM criar outra conta de serviço; tente de novo em alguns minutos), `arquivo-ambiente` (o arquivo de configurações do terminal é um atalho, está no git ou já tem uma linha do aluno para a chave: nada foi criado) e `falha` (exceção inesperada). Erros que o aluno ou o plano dele resolvem (`sem-op`, `op-antigo`, `rede`, `conta-nao-encontrada`, `conta-ambigua`, `cofre-duplicado`, `sem-permissao`, `token-indisponivel`, `arquivo-ambiente`) saem com 1 mas a telemetria os registra como etapa do fluxo, não como instalação quebrada.
|
|
37
|
+
- **Sinais conhecidos:** `(429) Too Many Requests` é limite de uso estourado; no macOS 27, se o `op` disser `No accounts configured` com o app aberto, libere o terminal em Privacidade e Segurança > Arquivos e Pastas ("Data shared by 1Password") e abra o terminal de novo. Windows: a documentação do 1Password só cita o PowerShell como terminal suportado; Git Bash e WSL ficam para conferir no teste manual.
|
|
38
|
+
- **Nunca peça o token ao aluno** nem o aceite colado na conversa: o comando automático não precisa dele.
|
|
39
|
+
|
|
40
|
+
### Plano B grátis: Infisical, para quem não quer gastar nem 1 real
|
|
41
|
+
|
|
42
|
+
Decisão do Euriler (23/10): além do 1Password (pago, recomendado), o aluno que diz "não quero gastar nem 1 real, mas quero resolver" tem o **Infisical**, um cofre de código aberto com plano grátis na nuvem. Não é tão bom quanto o 1Password (não preenche senha no navegador; só guarda as chaves que o agente usa), mas resolve. O cofre local, com os valores em texto, continua proibido.
|
|
43
|
+
|
|
44
|
+
- **A escolha vem no começo.** Quando o aluno precisa de um cofre e ainda não tem nenhum, o Companion pergunta: "Quer o 1Password (uns 3 dólares por mês, confira o preço na tela, preenche senha no navegador, recomendado) ou o grátis (Infisical, só guarda as chaves do agente)?". Sem resposta clara, ele oferece o 1Password e diz que o grátis existe. O comando novo `conectar-cofre` faz essa escolha; o `conectar-1password` continua com as mesmas flags e respostas (só passa a marcar o cofre ativo em `~/.arcane/cofre.json`).
|
|
45
|
+
- **O que o aluno faz no grátis são duas coisas.** Criar a conta grátis no Infisical (app.infisical.com/signup) e entrar na conta na página que abre sozinha no navegador. Ele **não** clica em "Start a free trial" (o teste do plano pago pede cartão e pode virar cobrança se não for cancelado). O resto é do Companion.
|
|
46
|
+
- **O Companion faz o resto, em 7 etapas, cada uma com o seu "pronto".** Conta → ferramenta `infisical` → entrar no navegador → projeto `Auroq` → chave do agente → teste em terminal novo → pronto (só depois do teste). Ele instala a ferramenta sem pedir senha de administrador e sem mexer no PATH (baixa a versão 0.44.8 da página oficial de versões, confere o código de verificação SHA-256 e guarda no computador do aluno; se não der, tenta Homebrew no Mac e winget no Windows), cria o projeto `Auroq`, cria a chave do agente **só desse projeto** (uma "identidade de máquina" do projeto, com papel `member`: lê e grava segredos, sem validade) e guarda a chave no computador, no mesmo lugar da chave do 1Password. Por último confere num terminal novo: grava, lê e apaga um segredo de teste usando só a chave do agente. O segredo de teste tem nome novo a cada teste (`AUROQ_TESTE_<12 caracteres 0-9 e A-F>`), então nunca pisa num segredo do aluno e dois computadores testando juntos não se atrapalham; depois de gravar ele é sempre apagado, mesmo se a leitura falhar, e se nem o apagar der certo a tela diz o nome para o aluno apagar no painel (a migração para o 1Password ignora esse nome).
|
|
47
|
+
- **A sessão do aluno só existe na configuração.** O login do navegador vale alguns dias (o padrão do Infisical é 10; na nuvem o prazo exato não foi confirmado) e a ferramenta não o renova, então o agente não depende dele: trabalha só com a chave do agente, que não vence e entra sozinha a cada uso. O login do aluno é encerrado no fim de **toda** execução que o usou, com sucesso ou com erro (a tela avisa "O Auroq saiu da sua sessão do Infisical"), para o acesso de administrador da organização não ficar parado alguns dias no computador. Se o encerramento falhar, a tela avisa e traz o caminho do programa que o Auroq instalou para o aluno sair na mão (`<caminho> logout --profile auroq`); isso não muda o resultado da conexão. Só não é encerrado quando o login ainda não terminou (o aluno ainda não aprovou). Consequência: depois de um erro posterior ao login (por exemplo `falha-identidade` ou `rede`), a rodada seguinte abre o navegador de novo para entrar ou aprovar; e os erros que só se resolvem trocando de organização ou de conta (`sem-organizacao`, `projeto-sem-acesso`, `sem-permissao`) dizem "Encerrei a sessão" e a próxima rodada reabre o navegador.
|
|
48
|
+
- **A chave nunca aparece.** Nem na tela, nem na conversa, nem em linha de comando, nem nos arquivos do projeto ou da configuração do Auroq: ela nasce dentro do comando e é gravada direto no arquivo de ambiente do seu usuário (Mac/Linux, permissão só dele, com as mesmas recusas da rota A para atalho, arquivo no git e linha própria do aluno) ou nas variáveis do usuário (Windows). Qualquer programa do aluno consegue usá-la. Se não der para gravar, a chave que acabou de ser criada é revogada na hora, para não sobrar nada solto; se nem a revogação der certo, o resultado traz `aviso=chave-orfa` e a descrição da chave a apagar no painel.
|
|
49
|
+
- **Uma chave por computador.** Quem usa dois computadores tem uma chave em cada (descrição "Auroq OS - <nome do computador> [código de 10 caracteres] - <data>"). O código vem de um identificador que o sistema já tem (não do nome, que pode repetir ou mudar) e só ele identifica o computador: trocar a chave (`--rotacionar`) revoga só as antigas daquele computador, nunca as dos outros, mesmo com dois computadores de mesmo nome. Além das que têm o código do computador na descrição, a troca também revoga a chave que este computador usa agora, reconhecida pelos 4 primeiros caracteres que o Infisical lista (vale para computador novo com a pasta copiada, em que o código da descrição é de antes). A troca lista as chaves antigas antes de criar a nova, só revoga depois que o teste da nova passa e, se a revogação falhar, termina `ok` com `aviso=revogacao-pendente` ("a chave antiga AINDA vale"): a rodada seguinte, sem `--rotacionar`, termina a troca. Se não achar nenhuma chave antiga para revogar (e havia chaves vivas), termina `ok` com `aviso=chave-antiga-nao-identificada`: nenhuma foi revogada, a que vazou (se for uma antiga) continua valendo e a mensagem manda apagá-la no painel; não há o que terminar rodando de novo. Chave de outro computador (perdido, roubado) a rotação não revoga: apagar no painel do Infisical.
|
|
50
|
+
- **Um comando só para ler e gravar, qualquer que seja o cofre.** `npx -y auroq-os@latest segredo ler|gravar|listar|apagar|qual <Item>[/<campo>]` funciona igual no 1Password e no Infisical, para os agentes, squads e skills não precisarem saber qual dos dois está por trás. O valor para gravar vai por stdin (ou `--arquivo`), nunca na linha de comando; o `gravar` confere lendo de volta e tira o BOM, a quebra de linha final e os espaços das pontas; `ler` escreve só o valor e **nunca** sai com sucesso e saída vazia (segredo que não existe, ou que existe sem valor, sai com código 3); `ler` imprime o valor, então os textos mandam usá-lo sempre dentro do comando que o usa, numa variável, e nunca sozinho. Apagar exige `--confirmo`; no 1Password isso arquiva o **item inteiro** (todos os campos dele; volta pelo Arquivo do app), por isso a confirmação avisa antes, lista os campos com valor e recusa `ITEM/CAMPO` quando o item tem outros campos. As mensagens de erro não repetem o que foi digitado. No 1Password, `op read "op://Claude/<Item>/<campo>"` continua valendo.
|
|
51
|
+
- **Começou no grátis e assinou o 1Password?** O Companion conecta o 1Password e roda `conectar-cofre --migrar`: as chaves são levadas para o cofre `Claude`, cada uma lida de volta para conferir, sem mostrar valor nenhum. Nada é apagado do Infisical. **Ligar o 1Password sozinho não troca o cofre de quem já usa o Infisical** (a linha `AUROQ_AVISO cofre=infisical mantido=sim` avisa): o cofre ativo só vira o 1Password quando a migração leva **todas** as chaves (ou não havia nenhuma); com falhas (`migrado-parcial`), segue o grátis. Nomes que só diferem na caixa (`abc` e `ABC`) são falha explícita (no 1Password seriam o mesmo nome) e nenhuma das duas é passada; nomes que o Auroq não usa (espaço, mais de 64 caracteres) não se resolvem rodando de novo: renomear no painel ou usar `--ignorar-fora-do-formato`, que os deixa no Infisical sem apagar. Chave que já existia no 1Password com outro valor fica com o valor do Infisical e a mensagem avisa quais (só nomes). Se o Infisical recusar a chave deste computador (revogada, ou identidade ou projeto apagado), a migração para com `origem-indisponivel` e manda gerar a chave de novo (`conectar-cofre --cofre infisical --agente`) em vez de mandar esperar; só instabilidade (rede, limite, bloqueio) continua pedindo para esperar. O segredo de teste da conexão (`AUROQ_TESTE_<código>`) nunca é levado. O caminho contrário não é automático: conectar o Infisical com o 1Password ativo troca o cofre ativo (escolha explícita do aluno) e avisa (`AUROQ_AVISO cofre=infisical chaves-antigas=1password`) que as chaves do 1Password não foram levadas, mas continuam lá e se leem com `segredo ler NOME --cofre 1password`.
|
|
52
|
+
- **Limites do plano grátis (confira na tela do Infisical):** 5 vagas no total, somando o aluno e cada agente (identidade) que ele criar (o Auroq usa 1 identidade, então o aluno usa 2; um segundo computador ganha só uma chave nova e não gasta vaga); projetos ilimitados; 3 ambientes por projeto; sem histórico de versões dos segredos nem registro de auditoria; o plano grátis pode ser alterado ou encerrado pela empresa e os termos do Infisical falam em uso profissional. Região: Estados Unidos por padrão; Europa com `--regiao eu`.
|
|
53
|
+
- **O Companion aciona sozinho, nos mesmos gatilhos do 1Password** (primeiro uso, tarefa que precisa de credencial sem cofre, erro de autenticação, `*cofre`, computador novo). A skill agora se chama `conectar-cofre` (`agents/companion/tasks/conectar-cofre.md`; o gatilho e o comando antigos continuam funcionando).
|
|
54
|
+
|
|
55
|
+
### Para o suporte (cofre grátis)
|
|
56
|
+
|
|
57
|
+
- **Comandos:** `npx -y auroq-os@latest conectar-cofre --cofre infisical --agente` (Windows: `npx.cmd`; dê 10 minutos de tempo-limite à ferramenta: o comando espera o aluno entrar no navegador por até 9 minutos). Sem `--cofre` e sem cofre em andamento, devolve `AUROQ_RESULTADO cofre=aguardando codigo=escolher-cofre`. `conectar-cofre --estado --agente` imprime `AUROQ_ESTADO cofre=<1password|infisical|nenhum> ...`. `--migrar` leva as chaves do Infisical para o 1Password (`--ignorar-fora-do-formato` deixa no Infisical as chaves com nome que o Auroq não usa).
|
|
58
|
+
- **Flags da rota B:** `--agente`, `--estado`, `--rotacionar`, `--regiao us|eu`, `--dominio <https://...>`, `--esperar N` (segundos; teto 570, descontado o tempo gasto antes, como instalar a ferramenta; mínimo 5, então `--esperar 0` devolve `aguardando` na hora). Numa máquina já conectada, o endereço novo (`--regiao`/`--dominio`) só é gravado quando a chave nova fica guardada: depois de um `aguardando` numa troca de região, repetir `--regiao eu` na rodada seguinte.
|
|
59
|
+
- **Linhas lidas pelo Ops:** `AUROQ_RESULTADO infisical=<ok|aguardando|erro> codigo=<codigo> [aviso=identidades-extras|revogacao-pendente|chave-antiga-nao-identificada|chave-orfa] [url="..."] mensagem="..."` (um aviso por resultado, na prioridade `revogacao-pendente`, `chave-antiga-nao-identificada`, `identidades-extras`; a `url` é de um login que já terminou, não serve para o aluno abrir: o link vivo sai na tela durante a espera), `AUROQ_AVISO cofre=infisical mantido=sim mensagem="..."` (depois do resultado do 1Password, quando o Infisical continua o cofre ativo), `AUROQ_AVISO cofre=infisical chaves-antigas=1password mensagem="..."` (depois do resultado do Infisical, quando ele trocou o 1Password como cofre ativo; pode vir também depois de `ja-conectado`, quando o aluno volta do 1Password para o grátis, e diz que nada foi copiado: o Infisical só tem o que já foi guardado nele) e `AUROQ_ESTADO infisical=<pronto|em-andamento|nao-iniciado> proxima=<etapa> feitas=... credencial=<configurado|ausente> ultimo=<codigo> conferido=nao`. Migração: `AUROQ_RESULTADO cofre=<ok|aguardando|erro> codigo=<migrado|migrado-parcial|nada-a-migrar|conectar-1password-primeiro|origem-indisponivel|falha> movidos=N iguais=M falhas=K mensagem="..."`. Código de saída: 0 para `ok` e `aguardando`, 1 para `erro`.
|
|
60
|
+
- **Códigos `ok`:** `criada` (identidade nova), `reaproveitada` (a identidade `Auroq` já existia; se o comando criou chave, ela é só deste computador; numa troca pendente ou numa configuração perdida ele só reaproveita a chave que já estava aqui, sem criar outra, e a linha de resultado é a mesma; é aqui que vêm `aviso=identidades-extras`, `aviso=revogacao-pendente` e `aviso=chave-antiga-nao-identificada`, este só com `--rotacionar`: a chave nova existe, mas nenhuma chave antiga foi revogada) e `ja-conectado` (a chave do computador já entra no projeto; confere sem abrir navegador, mas só diz isso depois de provar que um terminal novo a enxerga e que ela grava, e nunca com uma troca de chave pela metade).
|
|
61
|
+
- **Códigos `aguardando`:** `login-no-navegador` (o aluno ainda não entrou na conta; a sessão vencida cai aqui também, e o código antigo `sessao-expirada` nunca é devolvido) e `outra-execucao`.
|
|
62
|
+
- **Códigos `erro`:** `sem-cli`, `cli-antigo` (precisa da 0.43.139 ou mais), `rede`, `sem-organizacao`, `projeto-sem-acesso` (o endereço `auroq` já é de outro projeto da organização), `falha-projeto`, `limite-plano` (só aqui é falta de vaga: as 5 do grátis acabaram; apagar uma **identidade** que não usa no painel), `plano-restringe` (o plano grátis barrou outra etapa, como papel, faixa de IP, ambiente ou projeto: **não** é falta de vaga e apagar identidade não resolve), `sem-permissao`, `falha-identidade`, `falha-chave`, `nao-gravou` (a chave criada é revogada; se nem isso der, `aviso=chave-orfa`), `teste-falhou` (a chave ficou gravada: rodar de novo, sem `--rotacionar`; numa troca, a chave antiga não foi revogada), `credencial-indisponivel`, `arquivo-ambiente`, `bloqueada` (3 falhas de login seguidas travam a chave por 5 minutos: esperar 6), `limite` (limite de uso) e `falha`. Os que o aluno ou o plano dele resolve saem com 1 mas a telemetria os registra como etapa do fluxo.
|
|
63
|
+
- **Arquivos no computador do aluno (sem segredo, fora do git), em `~/.arcane/`:** `cofre.json` (qual cofre está ativo), `infisical.json` (endereço, projeto, identidade, caminho da ferramenta), `infisical-etapas.json` (as 7 etapas), `infisical.lock` (uma execução por vez), e, do comando `segredo`, `cofre-op.lock` (uma gravação por vez no 1Password), `cofre-infisical-login.lock` (um login por vez no Infisical) e `cofre-infisical-bloqueio.json` (marca de "chave bloqueada por uns 5 minutos", só com o código da chave e a hora). O `infisical.json` pode ganhar `instalacaoId` (só quando o sistema não informa o identificador do computador) e `rotacaoPendente` (só códigos das chaves antigas a revogar). As chaves ficam nas variáveis `AUROQ_INFISICAL_CLIENT_ID` e `AUROQ_INFISICAL_CLIENT_SECRET` (nome próprio para não colidir com as `INFISICAL_*` do trabalho do aluno).
|
|
64
|
+
- **Falha passageira nunca cria chave nova:** erro 500, limite de uso, falta de internet ou bloqueio na hora de conferir a chave do computador param com `credencial-indisponivel`/`limite`/`rede`/`bloqueada` e não criam nada (vale também quando a chave está válida mas a configuração se perdeu). Só "credenciais inválidas" prova chave morta e gera outra. Pelo mesmo motivo, erro 5xx ou de rede ao CRIAR projeto, identidade ou chave não repete sozinho: vira `falha-projeto`/`falha-identidade`/`falha-chave` e a rodada seguinte reaproveita o que o servidor gravou.
|
|
65
|
+
- **Desfazer:** `infisical logout --profile auroq` (a sessão já é encerrada no fim da conexão; se o `infisical` não estiver no PATH, use o caminho do programa que o Auroq instalou, o mesmo que a tela mostra quando não consegue sair da sessão: `<caminho> logout --profile auroq`); apagar a identidade `Auroq` e o projeto `Auroq` no painel do Infisical revoga tudo (apagar a identidade é o que libera vaga; apagar só uma chave dentro dela não); remover o bloco "Infisical - identidade do agente" do arquivo de ambiente (ou as duas variáveis do usuário no Windows) e a pasta `~/.arcane/infisical*`; a ferramenta instalada fica em `~/.local/bin/infisical` (Mac) ou `%LOCALAPPDATA%\Programs\infisical` (Windows).
|
|
66
|
+
|
|
67
|
+
### Ainda não publicado
|
|
68
|
+
|
|
69
|
+
Precisa de nova versão do npm ANTES de subir o catálogo `auroq-core`: o `ops.md` e a skill `conectar-cofre` vivem no catálogo e mandam rodar comandos novos (`conectar-1password --agente`, `conectar-cofre`, `segredo`). A versão atual do npm não entende `--agente` nem `conectar-cofre` e cai no jeito antigo de colar o token. Ainda falta o teste manual numa conta 1Password nova **e numa conta Infisical nova**, em Mac e em Windows (ver `docs/stories/AUROQ-1password-automatico.md`). Sem número de versão por enquanto.
|
|
70
|
+
|
|
1
71
|
## 2.8.1 — 2026-10-22
|
|
2
72
|
|
|
3
73
|
### Mapa do Negócio: o sistema conhece o seu negócio e toda a equipe lê isso primeiro
|
|
@@ -8,6 +78,11 @@
|
|
|
8
78
|
- Conteúdo ao vivo (catálogo `auroq-core` 2.3.30): **skill `auroq-contexto` no Companion.** 11 blocos (quem é você, o que vende, para quem, como vende, meta e o que trava, posicionamento, provas, tom e valores, referências, vida pessoal opcional, equipe e ferramentas). Primeiro lê o seu material (bio, site, Instagram, apresentação, PDF, prints, áudio, página de vendas) e só pergunta o que faltou, uma pergunta por vez, em português simples. Cada fato fica com a fonte (`o aluno disse, 22/10`, `do site, 22/10`); o que o Companion só deduziu fica "a confirmar" e nunca vira fato sem você dizer que está certo. Nunca pede senha, token ou dado bancário; vida pessoal é opcional e qualquer pergunta pode ser pulada.
|
|
9
79
|
- **Primeiro uso mais rápido** (decisão do Euriler, 22/10: ver resultado logo). O `*primeiro-uso` agora pede o material primeiro, faz só o bloco essencial (blocos 1 a 5) e termina como antes: organiza os projetos no app e no GitHub e grava `.auroq/primeiro-uso.json`. O resto do mapa vem aos poucos.
|
|
10
80
|
- **Pergunta do dia.** Na conversa normal, se o mapa tem lacunas, o Companion faz UMA pergunta no começo (pode pular), no máximo uma por dia, nunca no meio de uma tarefa. Comando novo `*contexto [bloco]` para ver, completar, revisar ou refazer uma parte do mapa. "Lancei um produto" ou "mudei o preço" atualizam o mapa na hora; a cada 90 dias o Companion propõe revisar a meta.
|
|
81
|
+
- Conteúdo ao vivo (catálogo `auroq-core` 2.3.31, 22/10): **o Companion confere e conserta o computador.** O primeiro uso começa com uma conferência técnica (`doctor --leve` e as contas): o que faltar de programa ou do sistema o próprio Companion conserta na mesma conversa, seguindo o guia do Ops, e confere de novo; conta faltando vira um aviso de uma linha para Configurações → Conexões; conserto que demora ou falha duas vezes vai para as pendências e a entrevista segue. Fora do primeiro uso, "algo do computador quebrou" também fica com o Companion, sem trocar de agente (decisão do Euriler: o aluno só fala com o Companion).
|
|
82
|
+
- Conteúdo ao vivo (catálogo `auroq-core` 2.3.34, 22/10): **depoimento não é obrigatório.** O Companion nunca pergunta por provas e depoimentos (nem no primeiro uso, nem na pergunta do dia) e não ter não vira lacuna; o bloco só se preenche quando aparece no material ou o aluno conta.
|
|
83
|
+
- Conteúdo ao vivo (catálogo `auroq-core` 2.3.33, 22/10): quem ainda não vende nada fica registrado em `produto/ainda-nao-vende.md` (o app conta como respondido).
|
|
84
|
+
- Conteúdo ao vivo (catálogo `auroq-core` 2.3.32, 22/10): **a entrevista nunca trava o aluno.** Toda pergunta aceita "não tenho ainda" (vira fato no mapa, ex.: "ainda não tem produto", e não fica cobrando), "não sei ainda" e "pular" (viram lacuna, sem repetir antes de 30 dias). Sem material, segue direto para a entrevista básica. No primeiro uso, no máximo 7 perguntas; quem ainda não tem negócio responde só quem é, o que gostaria de vender e a meta.
|
|
85
|
+
- Conteúdo ao vivo (catálogo `auroq-core` 2.3.35, 22/10): **no app, o aluno não é mais mandado ao Ops.** Conflito ao salvar, cofre de senhas (1Password ou Bitwarden) e publicar site ficam com o próprio Companion, seguindo o guia técnico do Ops; atualizar o sistema é do app. O Ops segue como o Bootstrap de quem não usa o app (decisão do Euriler: "não faz sentido chamar ops").
|
|
11
86
|
- Mantém `arcane-mcp@0.7.0`. Instaladores do repositório preparados para 2.8.1.
|
|
12
87
|
|
|
13
88
|
### Também nesta versão
|
package/README.md
CHANGED
|
@@ -53,12 +53,45 @@ O caminho manual antigo foi aposentado. Use a instalacao guiada acima. Em negoci
|
|
|
53
53
|
| `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
54
|
| `auroq-os register-mcp` | Reescreve o registro do conteudo ao vivo no projeto (use se o `doctor` apontar que ele falta) |
|
|
55
55
|
| `auroq-os sync-codex` | Regenera e verifica as skills locais do Codex |
|
|
56
|
-
| `auroq-os conectar-1password` |
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
>
|
|
61
|
-
>
|
|
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`) |
|
|
58
|
+
| `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
|
+
|
|
60
|
+
> **Um cofre de senhas e obrigatorio** para guardar credenciais: senha, token e chave nunca ficam em arquivo do
|
|
61
|
+
> projeto. Em `business/vault/` fica so o status e a referencia `op://...`, nunca o valor. Voce escolhe:
|
|
62
|
+
>
|
|
63
|
+
> - **1Password (recomendado, pago).** Quem nao tem e guiado pelo Ops (ou pelo Companion) a criar a conta (teste
|
|
64
|
+
> 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
|
+
> (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
|
|
67
|
+
> navegador.
|
|
68
|
+
> - **Infisical (gratis).** Para quem nao quer gastar nem 1 real. Voce so (1) cria a conta em
|
|
69
|
+
> 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
|
|
71
|
+
> preenche senha no navegador**, so guarda as chaves que o agente usa. Plano gratis (confira os limites na tela):
|
|
72
|
+
> 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
|
+
> Infisical falam em uso profissional e o gratis pode mudar. Se um dia assinar o 1Password, `conectar-cofre
|
|
74
|
+
> --migrar` leva as chaves para la.
|
|
75
|
+
>
|
|
76
|
+
> Nao existe cofre de valores guardado em arquivo no computador, em nenhuma das duas rotas.
|
|
77
|
+
|
|
78
|
+
> **Seguranca da chave 1Password:** o comando cria sozinho o cofre `Claude` e a conta de servico, e essa
|
|
79
|
+
> chave **so enxerga o cofre `Claude`** (leitura e escrita), nunca suas senhas pessoais, de banco ou da empresa.
|
|
80
|
+
> Ela nao expira. A chave fica salva no computador e qualquer programa seu consegue usa-la; por isso o cofre
|
|
81
|
+
> `Claude` deve ter so o que o Auroq precisa. Em conta de empresa (Teams/Business), em geral so o dono ou
|
|
82
|
+
> administrador cria conta de servico. Se um dia quiser trocar a chave, rode com `--rotacionar` e revogue a
|
|
83
|
+
> antiga em 1password.com > Developer > Service accounts. Plano B escondido: `--manual`, para quem prefere
|
|
84
|
+
> criar a conta de servico na mao e copiar o token (Cmd+C / Ctrl+C), sem colar em lugar nenhum: o comando le da
|
|
85
|
+
> area de transferencia e a limpa depois.
|
|
86
|
+
|
|
87
|
+
> **Seguranca da chave do Infisical:** o comando cria sozinho o projeto `Auroq` e uma chave do agente que **so
|
|
88
|
+
> enxerga esse projeto** (leitura e escrita), sem data de validade. Ela fica salva no computador (arquivo so seu no
|
|
89
|
+
> Mac, variavel do usuario no Windows) e qualquer programa seu consegue usa-la; por isso o projeto deve ter so o que
|
|
90
|
+
> o Auroq precisa. Para trocar, rode com `--rotacionar` (depois do teste ele revoga as chaves antigas deste
|
|
91
|
+
> computador, reconhecido por um codigo proprio e nao pelo nome, e tambem a chave que este computador usa agora;
|
|
92
|
+
> se a revogacao falhar, ou se ele nao achar nenhuma chave antiga para revogar, avisa que a chave antiga ainda vale
|
|
93
|
+
> e que voce deve apaga-la no painel do Infisical). A sessao do seu login no Infisical so existe durante a conexao e e encerrada no fim. A chave nunca
|
|
94
|
+
> passa pela conversa.
|
|
62
95
|
|
|
63
96
|
Dentro do projeto instalado, os mesmos checks ficam disponiveis como
|
|
64
97
|
`npm run auroq:sync:codex`, `npm run auroq:sync:codex:check` e
|
|
@@ -76,12 +109,13 @@ npx auroq-os clone # lista seus repos do GitHub e baixa o negocio intei
|
|
|
76
109
|
cd meu-negocio
|
|
77
110
|
claude
|
|
78
111
|
/AuroqOS:agents:ops
|
|
79
|
-
*conectar-
|
|
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
|
|
80
114
|
```
|
|
81
115
|
|
|
82
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).
|
|
83
117
|
Colaborador usa conta propria de tudo (GitHub via convite, assinatura Claude propria,
|
|
84
|
-
cofre 1Password com escopo) — nunca a senha do dono. **Colaborador nao precisa ser
|
|
118
|
+
cofre 1Password ou Infisical com escopo) — nunca a senha do dono. **Colaborador nao precisa ser
|
|
85
119
|
aluno**: o acesso dele e o convite do GitHub (o `clone` nao pede login); quem atualiza
|
|
86
120
|
o sistema e o dono, e o colaborador recebe as atualizacoes automaticamente ao abrir o `claude`.
|
|
87
121
|
|
|
@@ -255,13 +289,13 @@ agents/ → Seu exercito (companion, workers, minds, squads)
|
|
|
255
289
|
|
|
256
290
|
## Observabilidade e integridade do motor
|
|
257
291
|
|
|
258
|
-
Apos publicacao, `npx -y auroq-os@2.8.
|
|
259
|
-
manutencao/diagnostico. `npx -y auroq-os@2.8.
|
|
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
|
|
260
294
|
de consentimento legado, studentFiles, customizacoes e dados do negocio. Nao ha
|
|
261
|
-
migracao forcada. O registro MCP aponta para `arcane-mcp@0.7.
|
|
295
|
+
migracao forcada. O registro MCP aponta para `arcane-mcp@0.7.1` — o pin mora no campo
|
|
262
296
|
`arcaneMcpPin` do package.json (fonte unica; o servidor le o mesmo campo no npm).
|
|
263
297
|
`npm run release:verify` recusa publicar com um pin que o npm nao resolva.
|
|
264
|
-
Os instaladores do repositorio ficam preparados para 2.8.
|
|
298
|
+
Os instaladores do repositorio ficam preparados para 2.8.2; as copias publicas so recebem
|
|
265
299
|
a versao apos os gates nativos e a verificacao do tarball publicado.
|
|
266
300
|
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.
|
|
267
301
|
|
|
@@ -68,7 +68,7 @@ business/
|
|
|
68
68
|
campanhas/ ← Campanhas ativas + _template
|
|
69
69
|
processos/ ← SOPs documentados
|
|
70
70
|
agente/ ← Agentes autonomos (Bia, etc.)
|
|
71
|
-
vault/ ←
|
|
71
|
+
vault/ ← So status e referencias op:// do cofre (1Password ou Infisical) (NUNCA guardar valor; NUNCA mexer sem permissao)
|
|
72
72
|
cockpit.md ← Fonte unica de verdade dos projetos
|
|
73
73
|
templates/ ← Moldes reutilizaveis
|
|
74
74
|
docs/knowledge/
|
|
@@ -103,7 +103,7 @@ docs/diagrams/ ← Visualizacoes
|
|
|
103
103
|
| Processo documentado (SOP) | `business/processos/` | Feito, funcionou, documentou |
|
|
104
104
|
| Campanha ativa | `business/campanhas/{slug}/` | Com tracker + arsenal |
|
|
105
105
|
| Template reutilizavel | `business/templates/` ou `business/campanhas/_template/` | Molde, nao instancia |
|
|
106
|
-
| Chave/acesso/login | `business/vault/`
|
|
106
|
+
| Chave/acesso/login | Cofre do aluno (1Password ou Infisical; via Companion/Ops) | `business/vault/` guarda so status e referencia `op://...`, nunca o valor |
|
|
107
107
|
| Agente/squad/worker | `agents/{slug}/` | Todo agente vive aqui |
|
|
108
108
|
| Diagrama/visualizacao | `docs/diagrams/` | HTML, imagens conceituais |
|
|
109
109
|
| Lixo/temporario | DELETAR | Nao acumular |
|
|
@@ -216,7 +216,7 @@ Ativado por: `*store`, "guarda isso", "salva esse documento", "armazena", "coloc
|
|
|
216
216
|
- NUNCA salvar sem confirmar o destino com o aluno (se houver duvida)
|
|
217
217
|
- NUNCA sobrescrever arquivo existente sem aprovacao
|
|
218
218
|
- SE o aluno cola texto bruto longo: organizar minimamente (titulo, secoes) antes de salvar
|
|
219
|
-
- SE o aluno manda algo que nao e documento de negocio (chave, login, senha): redirecionar pro vault
|
|
219
|
+
- SE o aluno manda algo que nao e documento de negocio (chave, login, senha): NAO salvar em arquivo nenhum e redirecionar pro cofre do aluno (1Password ou Infisical; via Companion/Ops); `business/vault/` so guarda status e referencia `op://...`, nunca o valor
|
|
220
220
|
|
|
221
221
|
### Modo 6: LIMPAR (*clean)
|
|
222
222
|
|
|
@@ -239,7 +239,7 @@ Ativado por: `*clean`, "limpa", "remove lixo", "tira o que nao precisa"
|
|
|
239
239
|
|
|
240
240
|
Ativado por: `*backup`, "faz backup", "espelha no drive"
|
|
241
241
|
|
|
242
|
-
**Pre-requisito:** rclone configurado com Google Drive (verificar no vault)
|
|
242
|
+
**Pre-requisito:** rclone configurado com Google Drive (verificar no status em `business/vault/`; a chave em si fica no cofre do aluno)
|
|
243
243
|
|
|
244
244
|
**Protocolo:**
|
|
245
245
|
1. Verificar rclone configurado: `rclone listremotes`
|