Pular para o conteúdo

Referência

Referência do CLI

Encontre comandos por tarefa e confira os argumentos na instalação em uso.

Consulte o estado

Comece pelo diagnóstico e pelo panorama. Consultas de thread, fases e claims explicam o que foi registrado; não concedem permissão de escrita. Use --help no comando específico antes de uma operação mutável.

O ork doctor reprova arquivo ou pasta do .git com dono diferente do dono do repositório, com a contagem, exemplos e o chown exato na correção; ele não roda nada. O check analisadores do grafo carrega o typescript e o micromark como o ork grafo indexar e avisa com a correção quando faltam. A linha rede mostra a adesão à Orkastery Network, a casa, a última batida e a última falha, só lendo arquivos locais. Com a batida no crontab, a última rodada há mais de 30 min também reprova: a batida parou. A seção forja confere a forja do remoto origin, e só aparece com remoto de forja ou com o bloco forja: no manifesto. Com verify.security_scan declarado, o check security scan fica ok com o Docker, ou com o binário nativo de toda ferramenta do laço, e avisa, nunca reprova, quando alguma ficaria indisponível.

Na versão 0.6.10, ork doctor --json devolve os mesmos checks no contrato ork.doctor/v1, com veredito, falhas, avisos, projeto, máquina e a batida da fábrica: threads abertas, linha no crontab, última rodada, a idade dela, atrasada e o aviso pronto para o dono. A seção forja só roda com --forja; sem a flag, o JSON traz forja: nao-medida.

ork doctor
ork maestro --json
ork thread status <thread>
ork phase list <thread>
ork claims list <thread>

Comandos por responsabilidade

A condução reúne ork thread, ork phase, ork modos e ork gate. A evidência usa ork claims, ork verify, ork fix e ork retry, e a varredura usa ork security-scan e ork privado varrer. O isolamento usa ork worktree, ork lease e ork conducao, que diz quem conduz cada thread. A continuidade usa ork handoff, ork recall e ork memory, e o conhecimento escrito usa ork conhecimento. A entrega usa ork ship e ork master. A auditoria usa ork audit, com o board de dívida em ork audit divida. Desde a versão 0.6.0, o ork verify traz o Agile Check, e o security-scan é comando próprio.

ork --help
ork ship --help
ork master --help

Thread e worktree

Com worktree.por_thread: true, o que o ork init grava, ork thread new cria a worktree e a branch ork/<slug> sem flag; com a chave false ou ausente, só com --worktree auto. --worktree DIR reusa um diretório existente, --sem-worktree cria sem worktree e avisa que, na branch base, o ork ship sai barrado, e --dry-run mostra a worktree que seria criada. A mesma regra vale para --from-finding. Na versão 0.6.10, com worktree.dependencias no manifesto, o comando roda dentro da worktree nova depois da criação da thread, e a falha vai ao stderr com o comando exato, sem desfazer a thread.

ork worktree sync recria a branch sem commit próprio no SHA da base. Com commits próprios e a base reescrita, por exemplo depois de um force-push, recusa com tree.blocked, causa base-reescrita, e mostra o git rebase --onto que reaplica só os commits da thread.

Na versão 0.6.10, com --pedido, ork thread new guarda o pedido em pedido.md, na pasta da thread, com o sha256 no thread.json e no thread_created; pedido vazio ou acima de 64 KiB recusa antes de gravar. Sem --pedido, ork prompt render usa o pedido guardado, conferido pelo sha256 (thread.pedido.divergente quando o arquivo foi editado fora do núcleo); thread sem pedido guardado segue com o texto de exemplo.

ork thread new "<nome>" --modo auto --dry-run
ork thread new "<nome>" --modo auto --sem-worktree
ork thread new "<nome>" --modo auto --pedido "<texto>"
ork prompt render <thread> --fase GO
ork worktree sync <thread> --dry-run

Quem conduz a thread

ork conducao status <thread> diz quem conduz a thread agora (o canal, a sessão ou o processo, a fase e desde quando) e libera, com prova, a condução que ficou sem dono. ork conducao assumir <thread> faz o handoff: encerra a condução atual pelo runtime, registra quem assumiu, de qual canal e por quê, e reserva a vez para esse canal; --por e --motivo são obrigatórios.

Na versão 0.6.10, o ork conducao também tem os três comandos da Sentinela do Condutor, no bloco abaixo. O primeiro diz se a Sentinela está ligada nesta máquina, com a sessão, a última batida e o prazo, e dá o passo do condutor em cada thread aberta, calculado pelo núcleo; com --json, no contrato ork.conducao-sentinela/v1, é o que o condutor externo lê para ceder o despacho. O segundo é a batida: renova a presença da sessão por 3 min, ou a toma quando não há outra viva; com outra sessão viva na máquina, sai 3 e não toma o lugar dela. O terceiro tira a presença da própria sessão, e o condutor externo volta a conduzir. Quem bate e desliga é o mod ork-sentinela, sozinho.

A mesma versão traz a autorização durável do dono, que deixa a batida agir sozinha dentro do prazo. ork conducao autorizar --ate D --pode limpar,registrar,master,merge,despachar grava o contrato ork.autorizacao-duravel/v1 em .orkastery/monitor/autorizacao.json, fora do git, por até 31 dias; sem --por, vale o user.name do git, quando nomeia uma pessoa. ork conducao autorizacao lê a autorização vigente, ou o motivo tipado de ela não valer. ork conducao batida executa o passo determinístico do cron: o merge do PR de branch ork/* com os checks obrigatórios verdes, o registro da entrega, o MASTER por omissão, a limpeza das fantasmas e o despacho da fase seguinte, só dentro da autorização, e sai 3 com outra batida agindo. ork conducao atualizar <thread> mescla a base remota na branch da thread, e --enviar empurra sem força e prova pelo git ls-remote.

ork conducao status <thread> --json
ork conducao assumir <thread> --por <quem> --motivo "<por que>"
ork conducao sentinela status --json
ork conducao sentinela bater --sessao <id>
ork conducao sentinela desligar --sessao <id>
ork conducao autorizar --ate 2026-11-02 --pode limpar,registrar,master --por "<quem>"
ork conducao autorizacao --json
ork conducao batida --json
ork conducao atualizar <thread>

Integrações e operação

ork adapter e ork mcp conectam o host. ork accounts e ork setup descrevem runtimes, perfis e o que esta máquina confirmou. ork onboarding guarda a pauta e as respostas do projeto, e ork experiencia mostra as preferências do pacote de experiência. ork sessions, ork monitor e ork pulse observam execução e atenção humana. ork brain e ork portfolio consultam memória e catálogo, e ork ledger stats dá a telemetria do ledger. ork fabrica, ork roadmap e ork network coordenam trabalho entre máquinas, e ork projetos diz qual projeto cada comando lê. ork grafo consulta o índice local do grafo de código, e ork conhecimento consulta o conhecimento escrito do projeto. A referência canônica no repositório detalha as opções de cada família, e um teste confere as invocações dela contra a ajuda do ork.

Na versão 0.6.10, ork mcp install aceita --ship-transport github-ssh, forja-ssh, forja-https ou bare-local, e esse é o único push que um agente dispara. Sem a opção, vale github-ssh. forja-ssh aceita host e porta da forja, lê a chave do servidor e só a fixa confirmada pelo seu known_hosts ou por --ssh-fingerprint, e confere a chave a cada push com StrictHostKeyChecking=yes. forja-https usa o auth git-credential do gh ou do glab, com login no host exato, zera os outros helpers da config e recusa HTTP puro ou credencial na URL. A fixação fica em $XDG_CONFIG_HOME/orkastery/mcp-ship/, é por máquina e exige reinstalar em outra; trocar de modo é remover a entrada orkastery e reinstalar.

ork mcp install --project "$PWD" --host claude-code --ship-transport forja-https
ork mcp install --project "$PWD" --host claude-code --ship-transport forja-ssh --ssh-fingerprint SHA256:<impressao>

Confirmações desta máquina

Na versão 0.6.10, três escolhas do manifesto só valem depois de a máquina confirmar, fora do git. O runtime.sandbox que dá ao agente acesso total (danger-full-access) só despacha pelo Codex e pelo Grok Build depois de ork setup sandbox confirmar <postura>; sem isso, ork phase run e ork retry run recusam com runtime.sandbox-nao-confirmado. O worktree.dir que leva para fora da raiz, pelo caminho real, só cria worktree depois de ork setup worktree confirmar; sem isso, a criação recusa com worktree.dir-fora-da-raiz. E o fabrica.compartilhada: true só liga a fábrica com a adesão da máquina, por ork fabrica entrar.

As duas confirmações do ork setup ficam em .orkastery/private (postura-local.json e worktree-local.json, modo 0600, fora do git) e valem só para este checkout; a da worktree, só para aquela pasta. A adesão da fábrica fica em ~/.orkastery/maquina.json e vale para a máquina. O ork doctor acusa a falta de cada uma.

Também na versão 0.6.10, o ork eval só executa o catálogo do pacote que está rodando: um catálogo achado a partir do cwd que não é o do pacote recusa com eval.catalogo-alheio. Num checkout do Orkastery, use o do checkout, node core/dist/index.js eval, como o CI já faz.

ork setup sandbox --json
ork setup sandbox confirmar danger-full-access
ork setup worktree confirmar
ork setup worktree revogar
node core/dist/index.js eval

Contas, perfis e sessões

ork phase run --perfil <id> despacha pela conta pedida, ou recusa com runtime.profile-invalid, runtime.quota-exhausted ou runtime.auth-missing, sem trocar de perfil sozinho. runtime_profiles.distribuir escolhe entre os perfis: ordem, o padrão, é o primeiro do store; carga é o de menos sessões vivas nesta máquina. Valor desconhecido vale ordem, com aviso.

ork sessions lista as sessões de todas as contas, com a coluna PERFIL e as fantasmas; --global inventaria também as sessões Claude e Codex da conta fora da raiz do projeto, e --exigir-limpo sai diferente de zero com fonte inválida ou sessão sem thread. ork sessions limpar-fantasmas solta cada fantasma do ork com registro no ledger, sem chamar stop nem rm no runtime. Quando o runtime recusa o diretório da worktree ou espera o aceite de termos novos, a fase espera o dono rodar o comando indicado, e ork retry run re-despacha o mesmo prompt depois.

Na versão 0.6.10, para o ork retry run, a confiança no diretório vale quando o .claude.json da conta a registra no próprio diretório, num de cima até a raiz do repositório ou no repositório principal da worktree, e o redespacho recusado de novo pelo mesmo impedimento não gasta tentativa nem sobe esforço.

ork accounts esgotamentos mede, sem gravar nada, os despachos que caíram numa conta marcada como esgotada por outro projeto dentro do prazo da marca; a conta sai como id opaco, e o total é um piso.

ork phase run <thread> GO --prompt "<texto>" --perfil <id>
ork sessions --all
ork sessions --global --json
ork sessions limpar-fantasmas --dry-run --json
ork accounts esgotamentos --desde 7d --json

Grok Build por despacho explícito

Na versão 0.6.10, ork phase run <thread> GO --runtime grok --model <modelo> despacha a fase pelo Grok Build sem interface, pedido explicitamente ou pelo setup do bloco, e nunca pelo runtime.adapter do projeto. Não há modelo padrão: o modelo é sempre o do dono, e o esforço vai ao Grok Build com o mesmo nome. O processo filho roda sem XAI_API_KEY, pela assinatura que o login do perfil guardou, no sandbox workspace por padrão: read-only com runtime.sandbox: read-only e no PLAN que fecha o bloco, e sem sandbox só com danger-full-access confirmado nesta máquina por ork setup sandbox confirmar <postura>.

O comando ork setup <modo> --bloco N --runtime grok --model <modelo> faz do Grok Build o runtime de um bloco, e o fallback do bloco aceita o Grok Build com o modelo. ork mcp install --project <raiz> --host grok grava a entrada do MCP no .grok/config.toml do projeto, que não se versiona; no despacho, o servidor MCP do núcleo sobe fora do sandbox do Grok Build, só em 127.0.0.1, com um token por despacho e só com as ferramentas daquela sessão, e morre com ela.

O Grok Build não documenta um comando que confira o login, então ork accounts check mantém o estado do perfil dele, e o erro de login no despacho o tira do rodízio com runtime.auth-missing. ork sessions também lista as sessões do Grok Build de cada perfil. O ensaio real que homologa o runtime ainda falta.

Contexto citável e atenção humana

ork brain context devolve entidades, pais, citações, frescor e lacunas sem conceder permissão de escrita, e ork brain dossie monta, só para leitura, o dossiê de uma decisão: vínculo, contexto citável, alternativas, quem decidiu e evidência. ork roadmap status monta um relatório de leitura com a atenção que cabe ao dono. ork master pedir gera o pedido de nota para resposta pelo canal autenticado; não é uma nota dada pelo agente. ork master <thread> --score exige --por com o nome de quem dá a nota. ork master <thread> --aceitar-omissao aceita por omissão só a thread indicada, com --dry-run para ver antes; sem a thread, aceita todas as entregues do projeto.

Sem --classe, a classe da falha sai do motivo de cada gate reprovado, e base-avancou entra quando a branch trouxe a base antes da entrega; vale também no --aceitar-omissao.

Na versão 0.6.10, quando uma thread fora do roadmap espera o dono, o fecho do ork roadmap status ganha uma linha que conta essas threads e aponta o ork pulse, e o --json ganha o campo opcional foraDoRoadmap; sem thread assim, a saída não muda.

ork brain context --thread <thread> --ids <ids>
ork brain dossie --thread <thread>
ork roadmap status --json
ork master pedir <thread> --formato telegram
ork master <thread> --aceitar-omissao --dry-run

Escolha o projeto consultado

Todo comando lê um projeto. Vale, nesta ordem: --projeto <nome|caminho>, em qualquer posição do comando; a variável ORK_PROJETO; no host sem diretório de projeto, o único projeto conhecido ou a recusa projeto.escolha; e, no terminal, o diretório atual. Nome ambíguo ou desconhecido recusa com os candidatos, na saída 4; o ork nunca escolhe no lugar de quem pediu.

ork projetos lista os projetos conhecidos desta máquina, sem segredo. ork init, ork thread new e ork fabrica entrar registram sozinhos; ork projetos registrar e ork projetos esquecer cuidam das cópias antigas, sem apagar nada do disco. ork maestro, ork board, ork board plan, ork fabrica e ork roadmap status começam dizendo o projeto consultado e o que não foi lido.

Na versão 0.6.10, ork roadmap reservas também começa pelo projeto consultado, e os demais comandos que leem um projeto que o leitor não tem como adivinhar (no host, ou fora do diretório dele) terminam com a linha Projeto consultado, no stderr.

ork projetos --json
ork roadmap status --projeto meu-produto
ork roadmap reservas --json
ork projetos registrar
ork projetos esquecer <nome>

Rede, reservas e números de feature

ork network roadmap junta o roadmap da rede de qualquer diretório, com lacuna tipada no que não leu. ork roadmap reservas marca a reserva órfã de thread já fechada nesta máquina, e --soltar-orfas a solta ou a passa para outra thread aberta do mesmo item, com registro; --remoto escolhe o remoto lido, origin por padrão. ork roadmap feat reserva o próximo número de FEAT por push atômico; duas máquinas nunca levam o mesmo número, e o número reservado não volta.

ork network status mostra as máquinas da Orkastery Network da pessoa, de qualquer diretório, com a fonte, as lacunas tipadas e o que não foi lido. ork network entrar confere ou cria a casa privada na forja e publica o primeiro retrato antes de gravar a adesão; ork network publicar grava o retrato na hora, e ork network sair o tira da casa.

ork docs sincronizar leva fatos do ledger e do git aos itens do roadmap. --so limita aos itens pedidos; na worktree de uma thread com item, o padrão é o item dela, e --todos volta a todos. ork docs verificar confere a documentação de produto e do roadmap contra o código e o git, e sai diferente de zero com erro; no PR, com --pr, o merge de outra thread e o índice que divergem da main só avisam. ork docs init cria padrões, modelos, índices e o lint de Markdown no projeto.

ork network roadmap --json
ork network status --json
ork network entrar --maquina <nome>
ork roadmap reservas --soltar-orfas
ork roadmap feat --thread <thread>
ork docs sincronizar --escrever --so RM-NNN
ork docs verificar --pr

Rede da empresa e reserva coletiva

ork network empresa criar cria ou relê o repositório privado da rede e grava a política, com --nivel observar, avisar ou exigir. ork network empresa inscrever registra a inscrição pendente e a identidade esperada do maestro; ork network empresa aceitar, rodado pelo maestro autenticado, confere forja, host, accountId, rede e projetos antes de ativar.

ork network empresa publicar confere a conta de novo, recompõe a projeção fechada, aplica dado_privado e a varredura de segredo e grava os contratos v2 e v3 na mesma transação, sem force. ork network empresa status mostra estado, última projeção, pendência e o preflight coletivo; ork network empresa sair e ork network empresa revogar cessam os novos envios.

Com inscrição ativa, ork roadmap pegar e ork thread new --roadmap reservam primeiro na rede coletiva e mostram cobertura ausente, não conferida ou pendente; exigir sem conferência recusa. --forcar só trata a guarda local e nunca toma a reserva coletiva de outra identidade. Sem inscrição, a saída é a de antes.

--coordenacao reserva, colaborador ou acordo escolhe como entrar no item. O acordo pede as opções --atestacao-forja, --atestacao-id, --atestacao-endpoint e --atestacao-sha256, e a exceção auditável pede responsável, justificativa, expiração e a referência --excecao-*. No MCP, ork_thread_new recebe os mesmos dados no objeto coordenacao.

ork roadmap reconciliar retoma uma saga interrompida e desfaz só os efeitos que ainda pertencem à operação. ork ship, ork ship publicar e ork ship pista mostram o preflight coletivo consultivo, sem mudar a prontidão da entrega.

ork network empresa criar --forja github --dono <org> --repositorio <rede> --nivel avisar
ork network empresa aceitar --empresa github:<org>/<rede> --inscricao <id> --rede github:<org>/<rede> --projetos github:<org>/<projeto>
ork network empresa status --inscricao <id> --json
ork roadmap pegar RM-NNN --coordenacao colaborador
ork roadmap reconciliar RM-NNN --operacao op-<id>

Confira claims no sandbox

Na versão 0.6.10, ork claims conferir <thread> --claims C3,C7 reexecuta só essas claims no sandbox do ork_verify, na worktree da thread registrada no git, sob a condução da thread e sem gravar recibo: nem verify_run, nem estado de claim. ork claims conferir <thread> --tarefa T2.1 confere, no lugar delas, o verify de uma tarefa do docs/plan.md da thread, quando ele é um comando só, entre crases; --prazo vai de 10 a 600 segundos, com 180 por padrão, e --json devolve ork.claims-conferencia/v1.

Sai 1 quando alguma não passa, 2 sem sandbox ou com pedido inválido e 3 quando outra sessão conduz. Quem verifica de verdade continua sendo o ork verify, que não roda confinado: no sandbox, processo filho do node falha, e a claim de teste que cria processo pode reprovar ali e passar no ork verify.

ork claims conferir <thread> --claims C3,C7
ork claims conferir <thread> --tarefa T2.1 --json
ork verify <thread>

Retire claims e corrija pelo parecer

ork claims retirar ganha --motivo-tipo, com três valores: substituicao, obsoleta ou erro. Com --substituida-por <claim-id>, a retirada só vale se a substituta existir, estiver ativa e tiver passado no último verify com o mesmo comando; senão, recusa e pede verify novo.

Sem substituta, a claim continua ativa, e o núcleo abre ao dono o pedido tipado claims.retirada-sem-substituta. Sem --motivo-tipo, vale a forma livre de antes, e o recibo marca a retirada como não tipada. O histórico fica no claims.jsonl.

ork claims add aceita --dependencia-externa rede,relogio para a claim cujo comando depende de rede ou de relógio. Um GO sem commit que não muda o HEAD, as claims ativas nem o plano não repete o verify nem a revisão; a claim com dependência externa pede verify novo mesmo assim.

ork fix open lê o veredito e os achados estruturados do docs/check.md da thread: uma única linha de veredito, em português ou inglês (PASSOU, REPROVOU, PRECISA DE MUDANÇA ou BLOQUEADO), e um achado por linha, com id, severidade, arquivo e linha, como no fim do bloco abaixo. Parecer negativo sem achado estruturado, com o verify verde, recusa com fix.check.findings.

Achado sem claim entra na mesma rodada de correção e só fecha com um novo parecer independente PASSOU e o verify completo verde. ork fix status mostra os achados da rodada, com arquivo e linha, o commit que fechou cada um e o que ainda falta.

Textos de comando e motivos saem redigidos. O verify_run, os recibos e as execuções do verify redigem as credenciais sem mudar o que roda nem a identidade da prova. A retirada pela CLI mostra o motivo redigido, e ork_claim_withdraw, no MCP, faz a mesma retirada tipada e devolve só a impressão dos comandos da claim, nunca o texto deles.

ork claims add <thread> <arquivo> --claim "<alegacao>" --verificar "<comando>" --dependencia-externa rede
ork claims retirar <thread> C3 --motivo-tipo substituicao --substituida-por C7 --motivo "<motivo>"
ork claims retirar <thread> C4 --motivo-tipo obsoleta --motivo "<motivo>"
ork fix open <thread>
ork fix status <thread> --json

# docs/check.md
Veredito: PRECISA DE MUDANÇA
- A1 [bloqueador] src/filtro.ts:42 - o filtro ignora o fuso

Claims que o CI roda como foram escritas

ork claims add aceita --verificar repetido e grava todos os comandos, na ordem informada. ork claims verificar faz o mesmo com --comando repetido.

Opção de valor único repetida com o mesmo valor vale como uma só. Com valores diferentes, o comando sai com código 2 e nomeia a opção; com --json, devolve o erro cli.option.repeated.

O lint lê o ramo base do manifesto. A prova que o cita como ref local, main em vez de origin/main, não roda no checkout do CI, que só traz o ramo remoto. A ref remota, um texto de busca, um nome de arquivo ou uma opção parecida não disparam a recusa.

O parecer do CHECK fica só no artefato check, o docs/check.md do estado da thread, gravado pelo ork_artifact_write. Uma cópia não versionada de docs/check.md, docs/goal.md ou docs/plan.md na worktree continua lá, mas vira aviso tipado no ledger e aparece no ork thread status.

ork claims add <thread> <arquivo> --claim "<alegacao>" --verificar "<comando 1>" --verificar "<comando 2>"
ork claims verificar <thread> C3 --comando "<comando 1>" --comando "<comando 2>"
ork claims add <thread> <arquivo> --claim "<alegacao>" --verificar "git merge-base --is-ancestor origin/main HEAD"
ork thread status <thread> --json

Entrega, CI e concorrência

ork ci prepare grava .ork-ci/<thread>.json na worktree da thread, com a branch dela; ork ci run --branch acha esse bundle pelo nome da branch, reprova branch ork/* sem bundle e, fora de thread, roda só os comandos do manifesto. ork ship registrar-pr --repo --pr registra PR mesclado num repositório externo declarado em ci.external_repositories, com o merge conferido pela API do GitHub e o check declarado verde no head do PR.

ork phase run recusa com concurrency.limite, na saída 3, quando o projeto já tem max_parallel_threads sessões vivas em outras threads; --esperar espera a vaga. Na sessão sem acesso ao ledger, a ferramenta MCP ork_decision_record grava a decisão pelo mesmo contrato de ork decisao registrar.

ork ship registrar-pr --dry-run, também com --repo --pr, faz as mesmas conferências e responde registraria, sem gravar ship_done, sem mudar a fase e sem publicar a fábrica.

O --remoto de ork ship --para, ork ship registrar-pr e ork ci status é o nome de um remoto do git, validado antes de qualquer git: fora do formato, recusa com ship.remoto-invalido ou ci.remoto-invalido, sem consultar o GitHub.

Na versão 0.6.10, o push da base recusado pela proteção da branch vira entrega.base-protegida, com a orientação de entregar por PR ou MR. Com verify.security_scan declarado e sem ci.required_for_ship, uma categoria do laço sem varredura no SHA da candidata para com human.pending antes de qualquer push, e --allow-unscanned "<quem>" entrega mesmo assim, gravando ship_unscanned_authorized no ledger. ork ship registrar-pr e ork ci status reconhecem o GitLab pela forja resolvida, e no GitLab --repo aceita grupo, subgrupo e projeto, com --pr sendo o iid do MR.

ork ci prepare <thread>
ork ci run --branch <branch>
ork ship registrar-pr <thread> --repo <dono/nome> --pr <n>
ork ship <thread> --para main --allow-unscanned "<quem>"
ork phase run <thread> GO --prompt "<texto>" --esperar

Recibo de verify no CI

Com ci.politica_recibo e o último verify verde e integral, ork ci prepare grava no campo recibo do bundle a projeção ork.ci-projecao-replay/v1, sem HEAD presente. Sem a chave, o recibo histórico continua.

ork ci run --branch aplica a política quando configurada. O runner valida a projeção, reexecuta preparo, claims e comandos canônicos em ambiente allowlisted e emite ork.ci-recibo-runner/v1 com o HEAD executado.

observar relata o estado; avisar também usa os canais do job; exigir reprova PR ou MR para worktree.base_branch com recibo ausente, inválido, divergente ou replay degradado.

Em PR ou MR com inscrição na rede da empresa, ORK_REDE_EMPRESA_READ_TOKEN dá leitura à rede para anexar o preflight. Sem a credencial, ou em fork, a saída informa que a checagem coletiva não foi realizada, e o resultado do CI não muda.

ork ci prepare <thread>
ork ci run --branch <branch> --json

Telemetria OpenTelemetry

ork telemetria status mostra a adesão privada, a origem, o destino sem credencial e as pendências por thread; desligada, não enumera thread nem lê endpoint. ork telemetria ligar e ork telemetria desligar gravam a opção no arquivo privado ork.telemetria-config/v1, com permissão 0600; variáveis OTEL sozinhas não ligam o recurso.

ork telemetria enviar manda lotes OTLP/HTTP JSON com cursor por ledger. --dry-run mostra os mesmos LogRecords desde o início, ou desde o byte de --offset, sem cabeçalhos, rede nem cursor.

ork telemetria maturidade calcula os seis indicadores agênticos sobre os ledgers locais, na janela entre --desde e --ate, sem rede nem opt-in. DORA fica separado e sai como não confirmado sem fatos externos.

Com a telemetria ligada, o conteúdo dos prompts vem só do arquivo carimbado, com segredos removidos e dado_privado aplicado antes do LogRecord, em gen_ai.input.messages. Origem irrecuperável vira lacuna tipada, e erro transitório para antes do evento.

ork telemetria ligar
ork telemetria status --json
ork telemetria enviar --dry-run --json
ork telemetria maturidade --desde <ISO> --ate <ISO> --json

Busca por significado na memória

ork memory search --texto busca por significado no tenant, com vetor e FTS combinados, e não é determinística; não combina com --tags nem --thread. ork memory index mantém o índice vetorial local, idempotente, e --dry-run estima tokens e custo sem chamar o provider. ork memory status --sondar faz uma chamada real e mede a latência. Os três usam o mesmo universo da busca do tenant; ork memory status e ork memory index o mostram por coleção, contam o que fica fora da busca e avisam quando o índice cobre menos do que a busca enxerga.

Sem o universo lido inteiro, ou com a memória desligada ou indisponível, ork memory search --texto sai 1 com motivo tipado e sem resultados, também em --json; universo vazio lido com sucesso sai 0. A leitura do universo tem prazo próprio, memory.universo_timeout_ms, 90.000 ms por padrão.

ork memory search --tags é a busca determinística por tag; com --thread, a leitura fica restrita à thread, e --restrito e --janela exigem --thread (memory.query.thread-required).

Na versão 0.6.10, a DSN da memória pode vir de arquivo, fora do ambiente dos agentes: memory.database_url_file aceita só a forma ~/.orkastery/segredos/<nome>, e as duas fontes são exclusivas, então o ork nunca cai de uma para a outra. O arquivo precisa ser comum, do usuário que roda o ork, com permissão 0600 ou 0400 exata, até 4 KiB e uma linha só com a DSN. Ausente, inseguro ou inválido, a memória degrada para files com dsn.arquivo-ausente, dsn.arquivo-inseguro ou dsn.arquivo-invalido. ork memory status mostra a fonte, sem o valor, e o ork doctor ganha os checks fonte da DSN e DSN no ambiente; o segundo lista, pelo nome, as variáveis com a DSN do projeto ou com URL com senha que o agente lê com env.

Na mesma versão, a prova core/scripts/prova-busca-semantica.sh mostra, por par, a posição e a similaridade de cada alvo no ranking vetorial e quantas entradas da busca têm vetor coerente no índice, sem mudar os pares nem os códigos de saída. Sem argumentos, ela usa os pares padrão que o dono decidiu; pares passados como argumentos substituem os padrão.

ork memory status --sondar
ork memory index --dry-run --json
ork memory search --texto "<frase>" --json

Consulte o grafo de código

ork grafo indexar constrói o índice do HEAD limpo, no estado do projeto e fora do git; --verificar extrai de novo e confere contrato, bytes e determinismo. ork grafo vizinhos, ork grafo chamadores, ork grafo importadores e ork grafo caminho respondem pelas arestas, em texto ou --json, com o extrator e a evidência de cada uma. ork grafo status mostra o índice do HEAD, ork grafo amostra ajuda na auditoria manual de arestas e ork grafo limpar apaga os índices que não são do HEAD de nenhuma árvore.

A resposta é parcial por construção: só o que o extrator prova, e ela diz isso. Com a árvore modificada, a resposta é a do HEAD, com aviso. Todo o ork grafo precisa do typescript e do micromark no node_modules do próprio pacote do ork: são dependências do pacote, com versão exata, e o npm install -g os traz. Instalado dentro de um projeto ou pelo npx, o npm os iça para fora do pacote, e a recusa é grafo.parser.indisponivel, com a correção no ork grafo status e no ork doctor. O grafo pede Node 20.19, 22.12 ou mais novo.

Na versão 0.6.10, a resposta confere a proveniência contra a árvore: o texto marca com [fonte modificada na arvore] a aresta cuja origem, alvo ou evidência mudou depois do HEAD e lista até cinco fontes que mudaram; no JSON, cada aresta traz o campo arvore, e a resposta traz o campo fontes.

Com o índice de uma revisão ancestral, ork grafo indexar reextrai só o que a mudança alcança, com os mesmos bytes da extração completa, e diz quando foi completo e por quê. Com --json, --teto-bytes N limita a resposta a N bytes, tirando primeiro as arestas mais longe do alvo; o caminho não se corta e recusa com grafo.consulta.teto-excedido. Sem o índice do HEAD, a recusa diz o caso (grafo.indice.ausente, grafo.indice.outra-revisao ou grafo.indice.outro-extrator) e a correção. As mesmas consultas estão no MCP do projeto atrás da flag grafo.mcp, desligada por padrão.

ork grafo contexto <thread> monta o pacote compacto da thread, com o diff da worktree, GOAL, PLAN e claims, as ligações mais próximas do diff primeiro e evidência em tupla; o JSON ork.thread-graph-context/v2 tem teto de 32.768 bytes por padrão, de 4.096 a 65.536. Sem worktree, o diff é ignorado e declarado; com a flag ligada, ork_grafo_contexto entrega o mesmo JSON no MCP.

ork grafo indexar --verificar
ork grafo status
ork grafo chamadores <símbolo>
ork grafo importadores <arquivo> --json
ork grafo caminho <de> <para>
ork grafo contexto <thread> --json

Agile Check e Classic Check

Na versão 0.6.10, o ork verify roda o Agile Check por padrão, e o Classic Check continua sendo o CHECK de sempre, com os mesmos comandos, a mesma ordem e as mesmas ferramentas. --check classic ou --check agile vence o check.mode do manifesto, e o verify_run grava o modo e de onde ele veio: opcao, manifesto ou padrao. O texto da rodada mostra a linha check.

O Agile Check roda o preparo uma vez e as claims contra o produto dele, com guarda de hash, e leva as lanes de teste e a varredura em paralelo sem passar da CPU da máquina; a lane que sobe containers espera a varredura, por check.agile.apos_a_varredura. O banco do Trivy fica em cache, a imagem de lint é pré-montada e o binário nativo vem primeiro; a peça indisponível cai para o equivalente do Classic e fica registrada no verify_run. Nos dois modos, o verify_run grava a duração de cada comando, claim e rodada, e o parecer do CHECK e o pr-body.md dizem o modo da rodada.

A rodada e a baseline esperam a vez na fila de recursos pesados: concurrency.max_parallel_heavy, 1 por padrão, e 0 desliga. No máximo essa quantidade roda ao mesmo tempo nas worktrees do projeto, e nunca duas na mesma worktree. A espera em primeiro plano vai até --esperar ou 60 min e então recusa com fila-pesada.ocupada, na saída 3, dizendo quem ocupa.

Pelo MCP, ork_verify inicia a mesma rodada num worker do servidor e devolve um rodadaId na hora, e ork_verify_status acompanha fila, lane e veredito, no contrato ork.verify-mcp/v1. Quando o runner nomeia as falhas, a rodada compara teste a teste dentro do mesmo comando, e uma falha nova num comando que já falhava bloqueia com verify.regression. Com ORK_CHECK_TMPFS=auto, as lanes do Agile usam tmpfs quando há folga de memória, espaço e escrita.

ork verify <thread>
ork verify <thread> --check classic
ork verify <thread> --check agile --esperar 20

Varredura de segurança e qualidade

ork security-scan varre o HEAD, o conteúdo versionado numa worktree destacada, com as ferramentas do catálogo: segredos, dependências, SAST, IaC, workflows, qualidade e licença. Cada achado é comparado com a base por impressão digital e sai como new, existing ou dismissed. A base é --base, ou o merge-base com <remoto>/<worktree.base_branch>.

Segredo novo e vulnerabilidade high ou critical nova fazem o comando sair 1; qualidade e licença só reportam. O relatório report.json, no contrato ork.security-scan/v1, e o report.md ficam em .orkastery/security-scan/<sha>/ da árvore principal, e nunca levam o valor de um segredo. Sem --json, o resumo termina com o caminho do report.md.

Com verify.security_scan no manifesto, o ork verify roda o scan como quarto comando, e o ork doctor ganha o check security scan. ORK_SECURITY_SCAN_REQUIRED=1 faz ferramenta da categoria do laço indisponível ou que falhou sair 1. Os motivos unsupported-ci e no-requirements-file são declarados no relatório e não contam como categoria não varrida. O --check classic ou agile escolhe o paralelismo: no Agile as ferramentas rodam ao mesmo tempo, com o banco do Trivy em cache persistente, e no Classic uma por vez.

ork security-scan --json
ork security-scan --base origin/main
ork security-scan --check classic

Barreira de dado privado

Na versão 0.6.10, ork privado varrer procura dado privado no repositório do diretório atual: caminho de home, e-mail fora da lista permitida, hostname no formato de máquina e os termos da lista local, que fica fora do git. A lista é termos-privados.txt em ~/.orkastery/ e em .orkastery/ do projeto, ou o arquivo indicado por ORK_TERMOS_PRIVADOS, e só é lida como arquivo comum do usuário atual, sem link e com permissão 0600. As exceções ficam em orkastery.privado.json, com padrão e valor exato sem curinga e motivo obrigatório.

Sem --base, a varredura lê os nomes e todo o conteúdo dos arquivos versionados, inclusive binários. Com --base REF, lê o diff contra a merge-base com REF e os arquivos não rastreados. O relatório diz arquivo, linha, coluna e padrão, nunca o valor, e o nome de arquivo com achado sai com [omitido]. Sai 1 com achado sob a policy dado_privado em block ou sem a policy declarada, 0 em warn e off, e 2 quando a varredura não roda.

Com a policy dado_privado no manifesto, o ork verify varre o diff da thread e reprova com policy.violation em block, e o ork ci prepare recusa gerar o bundle com achado. No CI do núcleo, a varredura é um passo do job documentacao.

ork privado varrer
ork privado varrer --base origin/main
ork privado varrer --json