Produto
MOD-02 · Verdade e entrega
Comportamentos e limites de verdade e entrega, conforme o catálogo de produto revisado.
FEAT-004 · Claims e verificação
A claim precisa de comando executado no HEAD real. Resultado pendente, timeout ou prova retirada não contam como aprovação.
Na versão 0.6.10, o CHECK tem dois modos com a mesma cobertura e o mesmo veredito. O Agile Check, padrão, roda o preparo uma vez, reaproveita o produto dele com guarda de hash e executa as lanes de teste e a varredura em paralelo, sem passar da CPU da máquina; o Classic Check mantém os mesmos comandos na mesma ordem. check.mode: classic no orkastery.yaml volta o projeto inteiro ao Classic, e ork verify --check classic|agile vale só para a rodada e vence o manifesto. Peça do Agile indisponível cai para o equivalente do Classic, e o verify_run registra o modo, de onde ele veio e o que rodou no lugar.
Com verify.security_scan no manifesto, o ork verify roda ork security-scan como quarto comando, depois de build, test e typecheck. O scan compara o HEAD com a base por impressão digital e classifica cada achado como new, existing ou dismissed; segredo novo e vulnerabilidade high ou critical nova de dependência, SAST, IaC ou workflow reprovam, e qualidade e licença só reportam. O CHECK faz a triagem de cada achado novo com o security-auditor, e o GO-FIX corrige pela skill security-remediation ou registra a dispensa com ork decisao registrar. Sem a chave, nada muda.
Na entrega por PR, o check de documentação do CI também cobra a linha no CHANGELOG quando a mudança toca core, adapters ou marketplaces, e o estado do item do roadmap depois do merge. O verify e o commit pelo MCP não travam em lease de thread já fechada.
Em máquina virtual com CPU roubada pelo hipervisor, o ork verify local pode reprovar por tempo; a prova confiável é o CI. O ork verify mede o steal do /proc/stat e grava a medida no verify_run: a reprovação só de teste com relógio sob steal acima de 40% vira verify.timeout, que o retry reexecuta, e nunca verify.regression. O registro dos testes de relógio segue o contrato ork.instabilidade/v1, e a marcação JUnit protege só os casos declarados.
Desde a versão 0.6.2, quando o runner nomeia as falhas, o verify compara teste a teste dentro do mesmo comando: uma falha nova num comando que já falhava bloqueia com verify.regression e leva o nome no motivo. A claim nova que usa rg, chama o CLI pelo nome em vez de node core/dist/index.js, lê .orkastery/ ou leva aspas escapadas literais é recusada antes da gravação, com a correção para grep e node core/dist/index.js. Em repositório com CHANGELOG.md e tag v* publicada, o verify também recusa linha nova em versão já tagueada e exige a entrada de Não publicado sob Adicionado, Alterado, Corrigido ou Segurança.
Na versão 0.6.5, o verify entende o relatório JUnit de qualquer runner declarado no orkastery.yaml, por comando e por lane do Agile; sem a declaração, nada muda. Com ela:
- falhas e erros entram por nome, sem o teto de dez, com contagens e duração no
verify_run; o código de saída continua julgando, e o XML nunca torna verde um comando vermelho; - com a chave filtro, a rodada de correção roda primeiro os nomes que caíram e, se eles passarem, a suíte inteira antes de o recibo ficar verde;
- sob steal alto, a reprovação formada só por casos marcados na chave relogio fica sem veredito e ganha uma segunda rodada isolada pelo mesmo filtro, que nunca a torna verde;
- no Agile morno, a lane com a chave selecao e cache válido usa a seleção nativa do runner para as mudanças mapeadas, e qualquer incerteza roda a suíte inteira, com o motivo;
- recibo parcial, de passagem filtrada ou de seleção, nunca vale para o
ork ship.
FEAT-005 · CHECK independente no CI
O bundle de claims é reexecutado no SHA exato da candidata. Uma execução de outra thread ou outro commit não prova esta mudança. Cada thread tem o próprio bundle, .ork-ci/<thread>.json, que o CI acha pelo nome da branch; branch de thread sem bundle reprova, e a main roda só os comandos do manifesto.
Com a policy opt-in dado_privado declarada, o ork verify varre o diff da thread contra a base e o ork ci prepare varre o mesmo diff e o texto do bundle antes de gravar o arquivo: achado reprova com policy.violation em block e grava policy_warn em warn. Os padrões cobrem caminho de home, e-mail fora da lista permitida e hostname no formato de máquina, além dos termos da lista local fora do git; o relatório diz arquivo, linha, coluna e padrão, nunca o valor. ork privado varrer faz a mesma varredura na árvore versionada inteira.
Desde a versão 0.6.0, o GitLab tem paridade com o GitHub: a CI do GitLab como CHECK independente, o pulse, a rede, a entrega por MR e o SHIP pelo MCP, por uma porta de forja em que cada plataforma é um adaptador com capacidades.
FEAT-006 · Entrega com push comprovado
SHIP serializa o merge por lease e confere o remoto. Dry-run e commit local não são recibos de publicação.
O recibo ship_done traz o commit que incorporou a branch da thread (mergeSha) separado da ponta da base provada no remoto (pontaDaBase e shaRemoto).
Com verify.security_scan declarado e sem ci.required_for_ship, o SHIP para em human.pending antes de qualquer push quando uma categoria do laço (secret, dependency, sast, iac ou workflow) ficou sem varredura no SHA da candidata; só --allow-unscanned "<quem>" entrega, com ship_unscanned_authorized no ledger.
No MCP, o ork_ship escolhe o transporte no ork mcp install --ship-transport: github-ssh, forja-ssh, forja-https ou bare-local. forja-ssh confere a chave do servidor pelo known_hosts da pessoa ou por --ssh-fingerprint e usa StrictHostKeyChecking=yes, sem a config de SSH do usuário; forja-https usa só o auth git-credential do gh ou do glab com login no host, sem prompt e sem token no ork. A fixação fica fora do projeto, em $XDG_CONFIG_HOME/orkastery/mcp-ship/, e é reconferida a cada passo; origin ou config que muda durante o push deixa a entrega sem prova, com mcp.ship.transport.mudou-no-push.
FEAT-007 · Worktrees e leases
Cada thread edita sua worktree. Leases de árvore, caminhos, cards e serviços coordenam recursos; a auditoria recusa divergência entre Git e registro.
A worktree nasce com a thread quando o manifesto tem worktree.por_thread: true, o padrão do ork init, ou com --worktree auto; depois, ork worktree ensure a cria. ork worktree sync recusa com tree.blocked, causa base-reescrita, quando a base foi reescrita, e mostra o git rebase --onto que reaplica só os commits da thread.
Os leases e a fila moram no .orkastery/leases da raiz do projeto, com o ork chamado da raiz ou de qualquer worktree. Um lease legado de worktree só é considerado numa janela de 30 minutos, nunca é apagado nem prova posse; ork lease list mostra leases, famílias e filas.