@orkastery/cli 0.5.6 → 0.6.1

package/dist/locale-adapter.js

@@ -0,0 +1,291 @@
+"use strict";
+/**
+ * RM-061, fatia F3b: a familia `adapter` do catalogo de mensagens (`ork adapter list|show|install`): a tabela dos hosts,
+ * a descricao e os pitfalls de cada um, o texto da instalacao, os avisos do pacote de experiencia e as recusas. O pt-BR
+ * e a fonte (o `HOSTS` de `hosts.ts` le a descricao e os pitfalls daqui); o ingles e tipado por ele. Sem import do nucleo.
+ *
+ * O host, o caminho, o comando de ativacao, o motivo da divergencia (`catalogo-andou`) e o recibo `INSTALADO.json` sao
+ * dado e saem iguais nas duas linguas. A prova de cada pitfall e um comando: so o comentario depois do `#` muda.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADAPTER_EN = exports.ADAPTER_PT_BR = void 0;
+const HOSTS_PT_BR = {
+    'claude-code': {
+        descricao: 'Plugin com as skills do catalogo, subagentes de fase, entrada /orkastery:ork e hooks do Orkastery',
+        pitfalls: [
+            {
+                titulo: 'manifesto sem os caminhos das skills instala limpo e nao expoe nada',
+                detalhe: 'o plugin auto-descobre skills/<nome>/SKILL.md e para ai: ele nao desce nos buckets (core/, phases/, reviewers/, ...) que este catalogo usa, entao o plugin.json declara cada caminho de skill, um a um',
+                prova: 'claude plugin details orkastery   # Skills (N) soma as skills do plugin.json e os comandos de commands/',
+            },
+            {
+                titulo: 'duas copias do catalogo divergem',
+                detalhe: 'a fonte unica e skills/ na raiz do produto; o INSTALADO.json guarda a origem e o sha256 de cada arquivo, e reinstalar CLASSIFICA cada divergencia por ele: o que so mudou no catalogo ressincroniza sozinho, o que voce editou barra e pede decisao por arquivo (--aceitar-catalogo ou --manter-copia). Editar a copia instalada e bandeira vermelha',
+                prova: 'ork adapter install claude-code --dry-run   # mostra o que divergiu do catalogo',
+            },
+            {
+                titulo: 'hook com caminho relativo nao roda, e o guard vira decoracao',
+                detalhe: 'o hooks.json chama node "${CLAUDE_PLUGIN_ROOT}/hooks/ork-guard.js", nunca um caminho relativo ao diretorio de trabalho, que muda a cada worktree de thread',
+                prova: `echo '{"tool_name":"Bash","tool_input":{"command":"git add -A"}}' | node <destino>/hooks/ork-guard.js ; echo "codigo: $?"   # 2 = guard vivo`,
+            },
+        ],
+    },
+    codex: {
+        descricao: 'Entrada $ork e catalogo de conducao em skills locais do projeto, sem configuracao global',
+        pitfalls: [
+            {
+                titulo: 'skills instaladas fora do projeto da sessao',
+                detalhe: 'Codex descobre .agents/skills a partir do diretorio da sessao ate a raiz do repositorio; outra worktree precisa da sua propria instalacao e comprovacao de descoberta',
+                prova: 'No Codex aberto no projeto instalado: $ork',
+            },
+            {
+                titulo: 'copia instalada diferente do catalogo',
+                detalhe: 'o recibo INSTALADO.json registra os arquivos e hashes dentro da pasta propria orkastery; uma edicao divergente barra a reinstalacao sem substituir arquivos de outras skills',
+                prova: 'ork adapter install codex --dry-run',
+            },
+            {
+                titulo: 'skill confundida com autorizacao de runtime',
+                detalhe: 'instalar instrucoes nao habilita permissoes, hooks ou sandbox; em projeto configurado, AGENTS.md recebe apenas o bloco reversível da experiência. Gates e preflight continuam no nucleo, e descoberta nao prova a jornada conversacional',
+                prova: 'ork doctor',
+            },
+        ],
+    },
+    hermes: {
+        descricao: 'Skill roteadora fina, plugin que a declara e script de abertura de thread',
+        pitfalls: [
+            {
+                titulo: 'ork fora do PATH do host',
+                detalhe: 'o host roda com ambiente mais enxuto que o terminal do builder e ~/.local/bin pode nao estar la; o plugin grava o caminho absoluto e o script honra ORK_BIN',
+                prova: 'ORK_BIN=$(command -v ork) ; "$ORK_BIN" doctor',
+            },
+            {
+                titulo: 'reimplementar o parse da #TAG no host',
+                detalhe: 'duas implementacoes divergem na primeira tag nova, e a divergencia aparece como thread aberta no modo errado, o que ninguem percebe ate a pausa que nao veio',
+                prova: 'ork modos --do-pedido "teste #Maestro"   # a unica fonte do modo',
+            },
+            {
+                titulo: 'validar allowed_modes no host',
+                detalhe: 'um host que recusa o modo antes de chamar o ork recusa com a regra que ele tem em cache, nao com a do manifesto do projeto; deixe o ork thread new recusar, com erro tipado',
+                prova: 'ork thread new "teste" --mode look --dry-run',
+            },
+        ],
+    },
+    openclaw: {
+        descricao: 'extensao do OpenClaw 2026.7.1 (package.json + dist/index.js) com as tools ork_*, cada uma uma chamada de CLI',
+        pitfalls: [
+            {
+                titulo: 'placeholder {{ork_bin}} que fica no arquivo',
+                detalhe: 'o entry executa o binario como ele esta: um placeholder nao renderizado cai no fallback (ORK_BIN ou o ork do PATH), e sem o fallback vira "comando nao encontrado" em toda tool, que a sessao so descobre depois de ja ter aberto thread na cabeca do agente',
+                prova: 'grep -c "{{" <destino>/extensions/orkastery/dist/index.js   # precisa devolver 0',
+            },
+            {
+                titulo: 'argumento com espaco quebrado em varios argumentos',
+                detalhe: 'cada tool monta o comando como VETOR de argv, nunca como string de shell, para o pedido do builder chegar inteiro em --prompt; string de shell aqui vira injecao de comando com o texto do builder dentro',
+                prova: 'ork_phase_run com um prompt de varias linhas, conferido em ork phase list <thread>',
+            },
+            {
+                titulo: 'tool que reimplementa regra do nucleo',
+                detalhe: 'toda tool deste plugin e uma chamada de CLI e nada mais; tool nova que precisa de logica e sinal de que a logica pertence ao ork, com teste',
+                prova: 'ork eval   # o corpus reprova host com regra de negocio duplicada',
+            },
+        ],
+    },
+};
+const HOSTS_EN = {
+    'claude-code': {
+        descricao: 'Plugin with the catalog skills, phase subagents, the /orkastery:ork entry and the Orkastery hooks',
+        pitfalls: [
+            {
+                titulo: 'a manifest without the skill paths installs cleanly and exposes nothing',
+                detalhe: 'the plugin auto-discovers `skills/<name>/SKILL.md` and stops there: it does not go down into the buckets (`core/`, `phases/`, `reviewers/`, ...) this catalog uses, so `plugin.json` declares each skill path, one by one',
+                prova: 'claude plugin details orkastery   # Skills (N) adds up the skills in plugin.json and the commands in commands/',
+            },
+            {
+                titulo: 'two copies of the catalog drift apart',
+                detalhe: 'the single source is `skills/` at the product root; `INSTALADO.json` keeps the origin and the sha256 of each file, and a reinstall CLASSIFIES each divergence by it: what only changed in the catalog resyncs by itself, what you edited blocks the install and asks for a decision per file (`--aceitar-catalogo` or `--manter-copia`). Editing the installed copy is a red flag',
+                prova: 'ork adapter install claude-code --dry-run   # shows what drifted from the catalog',
+            },
+            {
+                titulo: 'a hook with a relative path does not run, and the guard becomes decoration',
+                detalhe: '`hooks.json` calls `node "${CLAUDE_PLUGIN_ROOT}/hooks/ork-guard.js"`, never a path relative to the working directory, which changes with each thread worktree',
+                prova: `echo '{"tool_name":"Bash","tool_input":{"command":"git add -A"}}' | node <target>/hooks/ork-guard.js ; echo "code: $?"   # 2 = guard alive`,
+            },
+        ],
+    },
+    codex: {
+        descricao: 'The $ork entry and the conduction catalog as project-local skills, with no global configuration',
+        pitfalls: [
+            {
+                titulo: 'skills installed outside the session project',
+                detalhe: 'Codex discovers `.agents/skills` from the session directory up to the repository root; another worktree needs its own install and its own proof of discovery',
+                prova: 'In Codex opened on the installed project: $ork',
+            },
+            {
+                titulo: 'installed copy differs from the catalog',
+                detalhe: 'the `INSTALADO.json` receipt records the files and hashes inside its own `orkastery` folder; a divergent edit blocks the reinstall without replacing files of other skills',
+                prova: 'ork adapter install codex --dry-run',
+            },
+            {
+                titulo: 'a skill mistaken for runtime authorization',
+                detalhe: 'installing instructions does not enable permissions, hooks or a sandbox; in a configured project, `AGENTS.md` only gets the reversible experience block. Gates and preflight stay in the core, and discovery does not prove the conversational journey',
+                prova: 'ork doctor',
+            },
+        ],
+    },
+    hermes: {
+        descricao: 'A thin router skill, the plugin that declares it and the thread opening script',
+        pitfalls: [
+            {
+                titulo: 'ork outside the host PATH',
+                detalhe: 'the host runs with a leaner environment than the builder terminal, and `~/.local/bin` may not be there; the plugin writes the absolute path and the script honors `ORK_BIN`',
+                prova: 'ORK_BIN=$(command -v ork) ; "$ORK_BIN" doctor',
+            },
+            {
+                titulo: 'reimplementing the #TAG parse in the host',
+                detalhe: 'two implementations drift apart on the first new tag, and the drift shows up as a thread opened in the wrong mode, which nobody notices until the pause that never came',
+                prova: 'ork modos --do-pedido "test #Maestro"   # the only source of the mode',
+            },
+            {
+                titulo: 'validating allowed_modes in the host',
+                detalhe: 'a host that refuses the mode before calling ork refuses with the rule it has cached, not the one in the project manifest; let `ork thread new` refuse, with a typed error',
+                prova: 'ork thread new "test" --mode look --dry-run',
+            },
+        ],
+    },
+    openclaw: {
+        descricao: 'OpenClaw 2026.7.1 extension (package.json + dist/index.js) with the ork_* tools, each one a CLI call',
+        pitfalls: [
+            {
+                titulo: 'a {{ork_bin}} placeholder left in the file',
+                detalhe: 'the entry runs the binary as it is: an unrendered placeholder falls back (`ORK_BIN` or the ork in PATH), and without the fallback it becomes "command not found" in every tool, which the session only finds out after the agent already believes the thread is open',
+                prova: 'grep -c "{{" <target>/extensions/orkastery/dist/index.js   # must return 0',
+            },
+            {
+                titulo: 'an argument with spaces split into several arguments',
+                detalhe: 'each tool builds the command as an argv VECTOR, never as a shell string, so the builder request reaches `--prompt` whole; a shell string here becomes command injection with the builder text inside',
+                prova: 'ork_phase_run with a multi-line prompt, checked in ork phase list <thread>',
+            },
+            {
+                titulo: 'a tool that reimplements a core rule',
+                detalhe: 'every tool in this plugin is a CLI call and nothing more; a new tool that needs logic is a sign that the logic belongs in ork, with a test',
+                prova: 'ork eval   # the corpus fails a host with a duplicated business rule',
+            },
+        ],
+    },
+};
+exports.ADAPTER_PT_BR = {
+    hosts: HOSTS_PT_BR,
+    // ork adapter list
+    titulo: 'Adaptadores de host (Camada 1, o podio)',
+    destinoPadrao: (destino) => `destino padrao: <projeto>/${destino}`,
+    catalogoJunto: (leva) => `catalogo de skills junto: ${leva ? 'sim' : 'nao'}`,
+    instaleCom: 'Instale com: ork adapter install <host> [--dir DIR] [--dry-run] [--force]',
+    zeroRegra: 'Zero regra de negocio no host: a #TAG vira `--mode` e a validacao e do nucleo.',
+    // ork adapter show e os erros de uso
+    adaptador: (host) => `Adaptador ${host}`,
+    hostDesconhecido: (bruto, hosts) => `host desconhecido: "${bruto}". Use: ${hosts}`,
+    subcomandoDesconhecido: (sub) => `subcomando desconhecido: adapter ${sub}`,
+    tituloDosPitfalls: (host) => `Os 3 pitfalls de instalacao do ${host} (confira, nao suponha):`,
+    prova: (prova) => `prova: ${prova}`,
+    // ork adapter install
+    experiencia: (estado, skill) => `Experiência: ${{ ativa: 'ativação preparada',
+        pulada: 'pacote pulado nesta instalação, veja o aviso abaixo', desativada: 'desativada ou sem integração de skills' }[estado]}` +
+        `${skill ? ` (${skill})` : ''}.`,
+    aviso: (aviso) => `Aviso: ${aviso}`,
+    simulacao: (host) => `Simulacao (--dry-run) da instalacao do adaptador ${host}: nada foi escrito.`,
+    preparados: (host) => `Arquivos do adaptador ${host} preparados.`,
+    barrada: (host) => `Instalacao do adaptador ${host} BARRADA: ha arquivo diferente no destino.`,
+    claudeNaoVerificado: 'Uso no Claude Code ainda nao verificado por esta copia.',
+    claudeValide: 'No diretorio deste projeto, valide e ative o plugin:',
+    claudeDepois: 'Depois, na sessao deste projeto: /orkastery:ork',
+    codexAbra: 'Abra o Codex neste projeto e use $ork.',
+    codexNaoVerificado: 'Descoberta e uso nativo ainda nao verificados por esta copia.',
+    prepareMcp: (projeto, host) => `Prepare tambem as ferramentas do projeto: ork mcp install --project ${projeto} --host ${host}`,
+    consentimento: 'A configuracao MCP exige descoberta e consentimento no cliente; a copia nao concede aprovacoes.',
+    catalogo: (catalogo) => `  catalogo: ${catalogo}`,
+    destino: (destino) => `  destino:  ${destino}`,
+    ork: (ork) => `  ork:      ${ork}`,
+    avisoOrk: (aviso) => `  Aviso: ${aviso}`,
+    arquivos: (total, novos, iguais, divergentes) => `  arquivos: ${total} (${novos} novo(s), ${iguais} ja identico(s), ${divergentes} divergente(s))`,
+    removido: (relativo, simulacao) => `    - ${relativo}  (saiu do catalogo${simulacao ? ', seria removido' : ', removido'})`,
+    reciboVizinho: (destino, vizinho) => [`  ATENCAO: nao ha recibo em ${destino}, mas ha um em`, `    ${vizinho}`,
+        '  `--dir` e o destino COMPLETO, nao a raiz do projeto. Do jeito que esta, esta',
+        '  instalacao criaria uma copia nova ao lado da que ja existe, e a que existe', '  ficaria sem conferencia nenhuma.'],
+    catalogoAndou: (n) => [`  ${n} divergente(s) sao "catalogo-andou": a copia esta como foi instalada`,
+        '  e quem mudou foi o catalogo. Sobrescrever nao perde trabalho de ninguem.'],
+    precisamDeDecisao: (n) => `  ${n} arquivo(s) precisam de uma decisao sua:`,
+    resolva: '  Resolva em UM comando, por arquivo:',
+    proximoPassoClaude: 'Proximo passo, no diretorio deste projeto (o mesmo do comeco):',
+    proximoPasso: 'Proximo passo (o mesmo do comeco):',
+    // Os avisos do pacote de experiencia e do ork do PATH (`instalarAdaptador`)
+    segue: 'O restante da instalação do adaptador segue normalmente.',
+    puladoManifesto: (erro, segue) => `Pacote de experiência pulado: o manifesto tem erros (${erro}). ${segue}`,
+    puladoInvalida: (aviso, segue) => `Pacote de experiência pulado: ${aviso}. ${segue}`,
+    puladoSemSkill: (skill, segue) => `Pacote de experiência pulado: a skill ${skill} não está no catálogo. ${segue}`,
+    puladoForaDoProjeto: (segue) => `Pacote de experiência pulado: o adaptador fica fora do projeto e o bloco de instruções só aponta caminhos do projeto. ${segue}`,
+    puladoCaminho: (segue) => `Pacote de experiência pulado: o caminho das skills contém quebra de linha ou crase, incompatível com o bloco de instruções. ${segue}`,
+    puladoBloco: (link, host, segue) => `Pacote de experiência pulado: ${link ? 'o arquivo de instruções é link ou não é arquivo comum'
+        : `o bloco de instruções ou o recibo .orkastery/experiencia/${host}.json foi editado ou está duplicado`}; nada foi escrito. Revise os dois à mão. ${segue}`,
+    versaoDesconhecida: 'versão desconhecida',
+    orkNoPath: (doPath, outra, emExecucao, versao) => `o ork do PATH (${doPath}, ${outra}) não é o que roda este install (${emExecucao}, ${versao}). ` +
+        `A extensão chama ${emExecucao}; para outro binário, passe --ork <caminho>.`,
+    // As recusas
+    adaptadorNaoExiste: (host, dir) => `adaptador do host ${host} nao existe em ${dir}`,
+    destinoInseguro: 'experiencia.path.unsafe: destino do adaptador',
+    catalogoNaoEncontrado: 'catalogo do Orkastery nao encontrado (esperado um diretorio com skills/, references/ e eval/)',
+};
+exports.ADAPTER_EN = {
+    hosts: HOSTS_EN,
+    titulo: 'Host adapters (Layer 1, the podium)',
+    destinoPadrao: (destino) => `default target: <project>/${destino}`,
+    catalogoJunto: (leva) => `skill catalog included: ${leva ? 'yes' : 'no'}`,
+    instaleCom: 'Install with: ork adapter install <host> [--dir DIR] [--dry-run] [--force]',
+    zeroRegra: 'Zero business rules in the host: the #TAG becomes `--mode` and validation belongs to the core.',
+    adaptador: (host) => `Adapter ${host}`,
+    hostDesconhecido: (bruto, hosts) => `unknown host: "${bruto}". Use: ${hosts}`,
+    subcomandoDesconhecido: (sub) => `unknown subcommand: adapter ${sub}`,
+    tituloDosPitfalls: (host) => `The 3 install pitfalls of ${host} (check them, do not assume):`,
+    prova: (prova) => `proof: ${prova}`,
+    experiencia: (estado, skill) => `Experience: ${{ ativa: 'activation prepared', pulada: 'package skipped in this install, see the warning below',
+        desativada: 'disabled or without skill integration' }[estado]}${skill ? ` (${skill})` : ''}.`,
+    aviso: (aviso) => `Warning: ${aviso}`,
+    simulacao: (host) => `Dry run (\`--dry-run\`) of the ${host} adapter install: nothing was written.`,
+    preparados: (host) => `${host} adapter files prepared.`,
+    barrada: (host) => `${host} adapter install BLOCKED: there is a different file at the target.`,
+    claudeNaoVerificado: 'Use in Claude Code not verified by this copy yet.',
+    claudeValide: 'In this project directory, validate and enable the plugin:',
+    claudeDepois: 'Then, in this project session: /orkastery:ork',
+    codexAbra: 'Open Codex in this project and use $ork.',
+    codexNaoVerificado: 'Discovery and native use not verified by this copy yet.',
+    prepareMcp: (projeto, host) => `Also prepare the project tools: ork mcp install --project ${projeto} --host ${host}`,
+    consentimento: 'MCP configuration needs discovery and consent in the client; the copy grants no approvals.',
+    catalogo: (catalogo) => `  catalog:  ${catalogo}`,
+    destino: (destino) => `  target:   ${destino}`,
+    ork: (ork) => `  ork:      ${ork}`,
+    avisoOrk: (aviso) => `  Warning: ${aviso}`,
+    arquivos: (total, novos, iguais, divergentes) => `  files: ${total} (${novos} new, ${iguais} already identical, ${divergentes} divergent)`,
+    removido: (relativo, simulacao) => `    - ${relativo}  (left the catalog${simulacao ? ', would be removed' : ', removed'})`,
+    reciboVizinho: (destino, vizinho) => [`  WARNING: there is no receipt in ${destino}, but there is one in`, `    ${vizinho}`,
+        '  `--dir` is the FULL target, not the project root. As it is, this install',
+        '  would create a new copy next to the existing one, and the existing one', '  would be left without any check.'],
+    catalogoAndou: (n) => [`  ${n} divergent file(s) are "catalogo-andou": the copy is as it was installed`,
+        '  and what changed was the catalog. Overwriting loses nobody\'s work.'],
+    precisamDeDecisao: (n) => `  ${n} file(s) need a decision from you:`,
+    resolva: '  Resolve it in ONE command, per file:',
+    proximoPassoClaude: 'Next step, in this project directory (the same as at the start):',
+    proximoPasso: 'Next step (the same as at the start):',
+    segue: 'The rest of the adapter install goes on as usual.',
+    puladoManifesto: (erro, segue) => `Experience package skipped: the manifest has errors (${erro}). ${segue}`,
+    puladoInvalida: (aviso, segue) => `Experience package skipped: ${aviso}. ${segue}`,
+    puladoSemSkill: (skill, segue) => `Experience package skipped: skill ${skill} is not in the catalog. ${segue}`,
+    puladoForaDoProjeto: (segue) => `Experience package skipped: the adapter lives outside the project and the instructions block only points to project paths. ${segue}`,
+    puladoCaminho: (segue) => `Experience package skipped: the skills path has a line break or a backtick, which the instructions block cannot hold. ${segue}`,
+    puladoBloco: (link, host, segue) => `Experience package skipped: ${link ? 'the instructions file is a link or not a regular file'
+        : `the instructions block or the \`.orkastery/experiencia/${host}.json\` receipt was edited or is duplicated`}; nothing was written. Review both by hand. ${segue}`,
+    versaoDesconhecida: 'unknown version',
+    orkNoPath: (doPath, outra, emExecucao, versao) => `the ork in PATH (${doPath}, ${outra}) is not the one running this install (${emExecucao}, ${versao}). ` +
+        `The extension calls ${emExecucao}; for another binary, pass \`--ork <path>\`.`,
+    adaptadorNaoExiste: (host, dir) => `the ${host} host adapter does not exist in ${dir}`,
+    destinoInseguro: 'experiencia.path.unsafe: adapter target',
+    catalogoNaoEncontrado: 'Orkastery catalog not found (expected a directory with skills/, references/ and eval/)',
+};

package/dist/locale-ajuda.js

@@ -33,12 +33,12 @@ Uso: ork [--projeto <nome|caminho>] <comando> [argumentos]
   experiencia uninstall <host> [--dry-run] [--json]
                                             Remove o bloco de Claude Code/Codex; sem --dry-run aplica a remoção
   setup <modo>                              Config atual de cada bloco do modo
-  setup <modo> --bloco N [--runtime R]      Edita o bloco (runtimes: claude-bg, codex);
+  setup <modo> --bloco N [--runtime R]      Edita o bloco (runtimes: claude-bg, codex, grok);
         [--model M] [--effort E] [--por Q]       evento setup_configured no ledger do projeto
         [--fallback R:M[:E],...]                  ordem de fallback de runtime do bloco (I-33)
   accounts list [--json]                    Perfis de conta por runtime, sem segredo (I-33)
   accounts add <id> --runtime R --dir D     Cria o perfil e roda o login do proprio CLI com o env
-        [--sem-login]                            do perfil (nunca copia credencial)
+        [--sem-login] [--device-auth]            do perfil (nunca copia credencial; codigo de dispositivo so no grok)
   accounts remove <id>                      Desativa o perfil (diretorio e login ficam onde estao)
   accounts check [<id>]                     Confere o login de cada perfil e marca o store
   accounts esgotamentos [--desde 7d] [--json]
@@ -110,12 +110,36 @@ Uso: ork [--projeto <nome|caminho>] <comando> [argumentos]
   pulse [--json] [--registrar]             Fila unificada de atenção humana e retry de órfãs
   pulse responder --resposta-stdin --origem telegram --canal C --por ID --mensagem REF [--conta ID]
                                             Recebe o que o dono digitou no canal do resumo (P4EJ a, 1a 2c)
+        [--em-resposta-a <codigo>:<id>]     o código da pergunta e o id da mensagem respondida (reply)
+        [--em-resposta-a outra]             a palavra solta em reply a outra mensagem: recusada, com o porquê
   pulse cadencia [<tag>] [--por P] [--json] Mostra ou troca a cadencia do resumo: OrkPulseOn, OrkPulseOn-15m,
                                             -30m, -60m ou OrkPulseOff; pergunta nova sai na hora (I-50)
   sessions hitl [--json] [--so-paradas]     Radar de sessoes que exigem acao humana AGORA:
         [--atencao N] [--sem-logs]              classifica o estado de cada sessao do runtime,
         [--so-da-raiz] [--exigir-limpo]         le a pergunta que a sessao trava e diz o que
                                                 destrava (pega HITL de sessao SEM thread)
+  noctum propor --arquivo <envelope.json>   Propõe o envelope de um arco #Noctum (RM-058) e pergunta ao dono, com código
+                                            curto e alternativas, também no canal dele; não autoriza nada
+  noctum maquina [--json]                   A entrada desta máquina em maquinas do envelope v3 (RM-058): o nome, a chave
+                                            pública e a impressão dela; a chave privada não sai desta raiz
+  noctum revogar <arco> [--json]            Pergunta ao dono se revoga o arco (RM-057); quem revoga é a resposta dele,
+                                            no Telegram ou pelo diálogo do host
+  noctum responder <arco> --resposta-stdin --origem telegram --canal C --por ID --mensagem REF [--conta ID]
+                                            Recebe a autorização ou a revogação assinada pelo gateway
+  noctum terminal --hook-stdin              O ingresso do terminal (RM-057), desligado: o hook UserPromptSubmit entrega
+                                            o que o dono digitou, e o núcleo só diz por onde responder; nada grava
+  noctum status [<arco>] [--json]           Retrato do arco: situação, consumo medido, fila, fechamento e lacunas
+  noctum tique <arco> [--json]              Fechamento, vigia e relatório do arco, nessa ordem (o cron do dono chama);
+                                            o vigia reconcilia e, sem condutor vivo, dá o passo do despacho e o da entrega
+  noctum relatorio <arco> [--json]          O relatório da manhã no terminal (recibo só em terminal interativo)
+        [--reenviar telegram|openclaw]          reenvia as páginas sem recibo, inclusive a de envio incerto
+  noctum conduzir <arco> [--json]           O condutor do arco, que o cron do piloto relança: sai 0 com o arco terminado
+                                            ou parado, 2 em recusa, 3 com outro condutor vivo, 4 com a geração perdida
+  noctum aceite <arco> [--json]             O aceite do piloto: as medidas M1 a M10, os critérios e o veredito; sai 0 só
+                                            com aprovado, e a evidência simulada (o ensaio) nunca aprova
+        [--injecoes <arquivo>]                  a agenda das falhas injetadas, que M4 e M5 medem
+        [--limiares <arquivo>]                  os limiares do dono; o que faltar fica com a proposta, marcada
+        [--publicar <arquivo>]                  grava a versão publicável, sem dado pessoal
 
   claims add <thread-id> <arquivo> --claim "<alegacao>" [--verificar "<comando>"] [--fase F]
                                             Registra alegacao verificavel da thread
@@ -141,6 +165,8 @@ Uso: ork [--projeto <nome|caminho>] <comando> [argumentos]
   ci run [<thread-id>] [--bundle ARQ]       Executa o CHECK no runner independente
         [--branch B]                         acha o bundle da thread pelo nome da branch (o CI usa)
   ci status [--sha SHA] [--remoto origin]   Consulta o check exato publicado no GitHub
+  privado varrer [--base REF] [--json]      Dado privado (home, e-mail fora da lista, hostname de maquina e a lista
+                                            local fora do git) nas linhas e nomes versionados; --base: so o diff (RM-062)
 
   gate next <thread-id> [--proximo FASE]    Gate de tokens: mesma sessao ou nova sessao
         [--ocupacao 0..1] [--fonte F] [--transcript ARQ] [--janela N] [--refazer]
@@ -179,6 +205,10 @@ Uso: ork [--projeto <nome|caminho>] <comando> [argumentos]
   brain status|inventory|get|query|receipts|context|dossie|sync|reconcile|apply|rollback|bind
   brain dossie --thread T [--decisao ID]    Dossie de decisao: vinculo, contexto citavel, alternativas,
                                             quem decidiu e evidencia, com os ids do Brain (so leitura)
+  conhecimento listar [--colecao C] [--json]  Documentos validos da pasta conhecimento.dir (RM-026 K7), com versao e lacunas
+  conhecimento mostrar <doc-id> [--json]    O documento com corpo, versao, fonte e referencias conferidas (Brain por get)
+  conhecimento colecoes [--json]            As colecoes e os documentos de cada uma
+  conhecimento verificar [--json]           Confere a pasta inteira, ids do Brain por get; sai != 0 com lacuna
   memory status [--json] [--sondar]         Regime efetivo (files|orkmind), tenant, degradacao e embeddings
                                             (--sondar: uma chamada real de embedding, com a latencia)
   memory sync [<thread-id>] [--json]        Publica decisoes, policies, handoff, licao e roadmap
@@ -209,12 +239,14 @@ Uso: ork [--projeto <nome|caminho>] <comando> [argumentos]
   grafo amostra [--por-estrato N]           Amostra de arestas para auditoria manual; --conferir ARQ confere a auditada
   grafo limpar [--tudo] [--json]            Apaga os indices que nao sao do HEAD e as sobras com mais de uma hora
 
+  security-scan [--base <ref>] [--json]     Varredura de seguranca do HEAD contra a base: relatorio por SHA em
+                                            .orkastery/security-scan/<sha>/; sai 1 com achado novo no laco
   ship <thread-id> --para <branch>          Merge --no-ff serializado por lease e push PROVADO
   ship registrar-pr <thread-id>|--todas    A entrega feita por PR vira ship_done: merge ship(<thread>) na base
         [--remoto R] [--json]                    remota e CI verde no head do PR; depois, ork master <thread> --aceitar-omissao
         [--repo <dono/nome> --pr <n>]            PR mesclado em repositorio externo de ci.external_repositories
         [--dry-run]                              Ensaio: as mesmas conferencias, sem gravar ship_done, fase nem fabrica
-        [--de <branch>] [--remoto origin] [--autorizar-push <quem>] [--sem-push] [--dry-run]
+        [--de <branch>] [--remoto origin] [--autorizar-push <quem>] [--allow-unscanned <quem>] [--sem-push] [--dry-run]
   ship publicar <thread-id>                 Publica a branch e abre o PR com prova (ls-remote), so em #Auto e #Maestro
         [--dry-run] [--remoto R] [--json]        Ensaio confere tudo sem publicar; repetido, nao abre outro PR
   ship pista [<thread-id>] [--json]         Etapas da entrega, do CHECK ao ship_done, e o proximo passo do nucleo
@@ -241,6 +273,11 @@ Uso: ork [--projeto <nome|caminho>] <comando> [argumentos]
                                             Handoff: encerra a conducao atual pelo runtime e registra quem assumiu
   conducao sentinela status|bater|desligar [--sessao S] [--json]
                                             Sentinela do Condutor: presenca nesta maquina e o passo de cada thread
+  conducao autorizar --ate D --pode A[,B] [--por Q] [--nota N]
+                                            Grava a autorizacao duravel do dono nesta maquina (fora do git)
+  conducao autorizacao [--json]             A autorizacao duravel vigente nesta maquina, ou por que ela nao vale
+  conducao batida [--entregar] [--json]     Avanca as threads dentro da autorizacao: merge, registro, MASTER, despacho
+  conducao atualizar <thread-id> [--enviar] Merge da base na branch da thread, com o CHANGELOG reconciliado
 
   master propor <id> --score N --justificativa J --por <agente>
   master batch --aceitar <thread:assinatura,...> --por <humano>
@@ -317,7 +354,7 @@ Uso: ork [--projeto <nome|caminho>] <comando> [argumentos]
                                              o padrao e o item dela; --todos volta a todo item (RM-037)
   docs init                                 Cria padroes, modelos, indices e o lint de Markdown no projeto
 
-  mcp serve --project RAIZ --host HOST       Servidor MCP stdio deste projeto (codex|claude-code)
+  mcp serve --project RAIZ --host HOST       Servidor MCP stdio deste projeto (codex|claude-code; grok so na sessao filha, com --thread)
   mcp install --project RAIZ --host HOST     Prepara MCP; aceita --dry-run, --ship-transport, --child-permissions e --owner-permissions (Codex)
 
   adapter list                              Adaptadores de host (Camada 1) e o destino de cada um
@@ -355,7 +392,8 @@ Uso: ork [--projeto <nome|caminho>] <comando> [argumentos]
                                                  worktree.por_thread como no thread new)
 
 Regimes de memoria: files (fallback honesto) e orkmind (bloco B6, base propria por tenant
-declarada em memory.database_url_env pelo NOME da variavel de ambiente, sem fallback).
+declarada em memory.database_url_file, arquivo 0600 em ~/.orkastery/segredos/, ou em
+memory.database_url_env pelo NOME da variavel de ambiente; uma fonte so, sem fallback).
 Colecoes gravadas no OrkMind: decision, handoff, rule, learning, roadmap (source=agent,
 nunca mandatory: regra critica so nasce de humano autenticado).
 
@@ -409,12 +447,12 @@ Usage: ork [--projeto <name|path>] <command> [arguments]
   experiencia uninstall <host> [--dry-run] [--json]
                                             Removes the Claude Code/Codex block; without --dry-run it applies the removal
   setup <mode>                              Current config of each block of the mode
-  setup <mode> --bloco N [--runtime R]      Edits the block (runtimes: claude-bg, codex);
+  setup <mode> --bloco N [--runtime R]      Edits the block (runtimes: claude-bg, codex, grok);
         [--model M] [--effort E] [--por Q]       setup_configured event in the project ledger
         [--fallback R:M[:E],...]                  runtime fallback order of the block (I-33)
   accounts list [--json]                    Account profiles per runtime, without secrets (I-33)
   accounts add <id> --runtime R --dir D     Creates the profile and runs the CLI's own login with the profile
-        [--sem-login]                            env (never copies a credential)
+        [--sem-login] [--device-auth]            env (never copies a credential; device code only for grok)
   accounts remove <id>                      Deactivates the profile (directory and login stay where they are)
   accounts check [<id>]                     Checks the login of each profile and marks the store
   accounts esgotamentos [--desde 7d] [--json]
@@ -486,12 +524,36 @@ Usage: ork [--projeto <name|path>] <command> [arguments]
   pulse [--json] [--registrar]             Unified queue of human attention and retry of orphans
   pulse responder --resposta-stdin --origem telegram --canal C --por ID --mensagem REF [--conta ID]
                                             Receives what the owner typed in the summary channel (P4EJ a, 1a 2c)
+        [--em-resposta-a <code>:<id>]       the question code and the id of the replied message (reply)
+        [--em-resposta-a outra]             the bare word in reply to another message: refused, with the reason
   pulse cadencia [<tag>] [--por P] [--json]  Shows or changes the summary cadence: OrkPulseOn, OrkPulseOn-15m,
                                             -30m, -60m or OrkPulseOff; a new question goes out at once (I-50)
   sessions hitl [--json] [--so-paradas]     Radar of sessions that need human action NOW:
         [--atencao N] [--sem-logs]              classifies the state of each runtime session,
         [--so-da-raiz] [--exigir-limpo]         reads the question the session is stuck on and says what
                                                 unblocks it (catches HITL of sessions WITHOUT a thread)
+  noctum propor --arquivo <envelope.json>   Proposes the envelope of a #Noctum arc (RM-058) and asks the owner, with a short
+                                            code and choices, also on the owner's channel; it authorizes nothing
+  noctum maquina [--json]                   This machine's entry in maquinas of the v3 envelope (RM-058): its name, public key
+                                            and fingerprint; the private key never leaves this root
+  noctum revogar <arc> [--json]             Asks the owner whether to revoke the arc (RM-057); the owner's answer revokes,
+                                            on Telegram or through the host dialog
+  noctum responder <arc> --resposta-stdin --origem telegram --canal C --por ID --mensagem REF [--conta ID]
+                                            Receives the authorization or revocation signed by the gateway
+  noctum terminal --hook-stdin              The terminal ingress (RM-057), turned off: the UserPromptSubmit hook delivers
+                                            what the owner typed, and the core only says where to answer; nothing is recorded
+  noctum status [<arc>] [--json]            Arc snapshot: situation, measured usage, queue, closing and gaps
+  noctum tique <arc> [--json]               Closing, watcher and report of the arc, in that order (the owner cron calls it);
+                                            the watcher reconciles and, with no live conductor, takes the dispatch and delivery step
+  noctum relatorio <arc> [--json]           The morning report in the terminal (receipt only in an interactive terminal)
+        [--reenviar telegram|openclaw]          resends the pages without a receipt, even an uncertain one
+  noctum conduzir <arc> [--json]            The arc conductor, which the pilot cron relaunches: exits 0 with the arc ended
+                                            or stopped, 2 on refusal, 3 with another live conductor, 4 with the generation lost
+  noctum aceite <arc> [--json]              The pilot acceptance: measures M1 to M10, the criteria and the verdict; exits 0
+                                            only when approved, and simulated evidence (the rehearsal) never approves
+        [--injecoes <file>]                     the schedule of injected failures, which M4 and M5 measure
+        [--limiares <file>]                     the owner's thresholds; what is missing stays with the proposal, marked
+        [--publicar <file>]                     writes the publishable version, without personal data
 
   claims add <thread-id> <file> --claim "<claim>" [--verificar "<command>"] [--fase F]
                                             Records a verifiable claim of the thread
@@ -517,6 +579,8 @@ Usage: ork [--projeto <name|path>] <command> [arguments]
   ci run [<thread-id>] [--bundle FILE]      Runs the CHECK on the independent runner
         [--branch B]                         finds the thread bundle by the branch name (the CI uses it)
   ci status [--sha SHA] [--remoto origin]   Queries the exact check published on GitHub
+  privado varrer [--base REF] [--json]      Private data (home, e-mail off the allow list, machine hostname and the local
+                                            list outside git) in versioned lines and names; --base: only the diff (RM-062)
 
   gate next <thread-id> [--proximo PHASE]   Token gate: same session or new session
         [--ocupacao 0..1] [--fonte F] [--transcript FILE] [--janela N] [--refazer]
@@ -555,6 +619,10 @@ Usage: ork [--projeto <name|path>] <command> [arguments]
   brain status|inventory|get|query|receipts|context|dossie|sync|reconcile|apply|rollback|bind
   brain dossie --thread T [--decisao ID]    Decision dossier: link, citable context, alternatives,
                                             who decided and evidence, with the Brain ids (read only)
+  conhecimento listar [--colecao C] [--json]  Valid documents of the conhecimento.dir folder (RM-026 K7), with version and gaps
+  conhecimento mostrar <doc-id> [--json]    The document with body, version, source and checked references (Brain by get)
+  conhecimento colecoes [--json]            The collections and the documents of each one
+  conhecimento verificar [--json]           Checks the whole folder, Brain ids by get; exits != 0 with a gap
   memory status [--json] [--sondar]         Effective regime (files|orkmind), tenant, degradation and embeddings
                                             (--sondar: one real embedding call, with the latency)
   memory sync [<thread-id>] [--json]        Publishes decisions, policies, handoff, lesson and roadmap
@@ -585,12 +653,14 @@ Usage: ork [--projeto <name|path>] <command> [arguments]
   grafo amostra [--por-estrato N]           Sample of edges for manual audit; --conferir FILE checks the audited one
   grafo limpar [--tudo] [--json]            Deletes the indexes that are not from HEAD and leftovers older than one hour
 
+  security-scan [--base <ref>] [--json]     Security scan of the HEAD against the base: report by SHA in
+                                            .orkastery/security-scan/<sha>/; exits 1 on a new finding in the loop
   ship <thread-id> --para <branch>          Serialized --no-ff merge by lease and PROVEN push
   ship registrar-pr <thread-id>|--todas    A delivery made by PR becomes ship_done: ship(<thread>) merge on the remote
         [--remoto R] [--json]                    base and green CI on the PR head; then, ork master <thread> --aceitar-omissao
         [--repo <owner/name> --pr <n>]           PR merged in an external repository of ci.external_repositories
         [--dry-run]                              Rehearsal: the same checks, without writing ship_done, phase or factory
-        [--de <branch>] [--remoto origin] [--autorizar-push <who>] [--sem-push] [--dry-run]
+        [--de <branch>] [--remoto origin] [--autorizar-push <who>] [--allow-unscanned <who>] [--sem-push] [--dry-run]
   ship publicar <thread-id>                 Publishes the branch and opens the PR with proof (ls-remote), only in #Auto and #Maestro
         [--dry-run] [--remoto R] [--json]        The rehearsal checks everything without publishing; repeated, it opens no other PR
   ship pista [<thread-id>] [--json]         Delivery steps, from CHECK to ship_done, and the core's next step
@@ -617,6 +687,11 @@ Usage: ork [--projeto <name|path>] <command> [arguments]
                                             Handoff: ends the current conduction through the runtime and records who took over
   conducao sentinela status|bater|desligar [--sessao S] [--json]
                                             Conductor Sentinel: presence on this machine and the step of each thread
+  conducao autorizar --ate D --pode A[,B] [--por Q] [--nota N]
+                                            Records the owner's durable authorization on this machine (outside git)
+  conducao autorizacao [--json]             The durable authorization in force on this machine, or why it does not hold
+  conducao batida [--entregar] [--json]     Moves the threads within the authorization: merge, record, MASTER, dispatch
+  conducao atualizar <thread-id> [--enviar] Merges the base into the thread branch, with the CHANGELOG reconciled
 
   master propor <id> --score N --justificativa J --por <agent>
   master batch --aceitar <thread:signature,...> --por <human>
@@ -693,7 +768,7 @@ Usage: ork [--projeto <name|path>] <command> [arguments]
                                              the default is its item; --todos goes back to every item (RM-037)
   docs init                                 Creates standards, templates, indexes and the Markdown lint in the project
 
-  mcp serve --project ROOT --host HOST       stdio MCP server of this project (codex|claude-code)
+  mcp serve --project ROOT --host HOST       stdio MCP server of this project (codex|claude-code; grok only in the child session, with --thread)
   mcp install --project ROOT --host HOST     Prepares MCP; accepts --dry-run, --ship-transport, --child-permissions and --owner-permissions (Codex)
 
   adapter list                              Host adapters (Layer 1) and the target of each one
@@ -731,7 +806,8 @@ Usage: ork [--projeto <name|path>] <command> [arguments]
                                                  worktree.por_thread as in thread new)
 
 Memory regimes: files (honest fallback) and orkmind (block B6, own database per tenant
-declared in memory.database_url_env by the NAME of the environment variable, without fallback).
+declared in memory.database_url_file, a 0600 file in ~/.orkastery/segredos/, or in
+memory.database_url_env by the NAME of the environment variable; one source only, without fallback).
 Collections written to OrkMind: decision, handoff, rule, learning, roadmap (source=agent,
 never mandatory: a critical rule is only born from an authenticated human).