@orkastery/cli 0.4.3 → 0.5.0

package/schemas/maestro-snapshot.schema.json

@@ -40,6 +40,21 @@
             "fingerprint": {
               "type": "string",
               "pattern": "^[a-f0-9]{64}$"
+            },
+            "root": {
+              "type": "string",
+              "maxLength": 512
+            },
+            "remote": {
+              "anyOf": [
+                {
+                  "type": "string",
+                  "maxLength": 512
+                },
+                {
+                  "type": "null"
+                }
+              ]
             }
           },
           "required": [
@@ -2697,6 +2712,14 @@
             "maxLength": 512
           },
           "maxItems": 100
+        },
+        "notConsulted": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "maxLength": 512
+          },
+          "maxItems": 20
         }
       },
       "required": [

package/skills/README.md

@@ -1,6 +1,6 @@
 # skills/
 
-Catalogo do Orkastery: as 17 skills que levam a metodologia das 6 fases para qualquer host
+Catalogo do Orkastery: as skills que levam a metodologia das 6 fases para qualquer host
 compativel. Buckets: `core/`, `phases/`, `reviewers/`, `governance/`, `observability/`.
 
 **Regra do catalogo, herdada do original e mantida aqui:** cada skill e um **roteador fino que
@@ -11,6 +11,7 @@ faz, o nucleo vence, e a divergencia e defeito da skill.
 | Bucket | Skill | Roteia para |
 |---|---|---|
 | core | [orkastery-bootstrap](core/orkastery-bootstrap/SKILL.md) | `ork modos`, `ork thread new`, `ork board` |
+| core | [orchestration-experience](core/orchestration-experience/SKILL.md) / [pt-BR](core/orchestration-experience-pt-br/SKILL.md) | `ork experiencia show`, `ork onboarding` |
 | core | [thread-state](core/thread-state/SKILL.md) | `ork thread status`, `ork phase list` |
 | phases | [goal-definition](phases/goal-definition/SKILL.md) | `ork phase run <t> GOAL`, `ork claims add` |
 | phases | [plan-specification](phases/plan-specification/SKILL.md) | `ork phase run <t> PLAN`, `ork lease acquire` |
@@ -30,7 +31,7 @@ faz, o nucleo vence, e a divergencia e defeito da skill.
 
 ## Evals
 
-Os 87 casos que protegem estas skills ficam em [`eval/casos/`](../eval/casos/) e rodam por
+Os casos que protegem estas skills ficam em [`eval/casos/`](../eval/casos/) e rodam por
 `ork eval`. Cada skill tem no minimo tres casos, cobrindo caminho feliz, resistencia a
 racionalizacao e borda de dominio. O runner julga a **metade estatica** (as regras que precisam
 existir no arquivo para o comportamento ser possivel) e diz em voz alta que a **metade
@@ -38,6 +39,7 @@ comportamental e `unavailable`**, nunca `passing`: lacuna e publicada como lacun
 
 ## Instalacao nos hosts
 
-`ork adapter install claude-code|hermes|openclaw` instala estas mesmas skills no host, sem copiar o
-catalogo: **uma copia so**, declarada caminho a caminho no manifesto do plugin. Duas copias do
-catalogo divergem, e a divergencia so aparece quando ja custou uma entrega.
+`ork adapter install claude-code|codex` copia o catálogo e declara suas entradas no host.
+Hermes recebe a entrada própria e as duas variantes de experiência. OpenClaw ainda não
+recebe skills do pacote. A fonte permanece neste catálogo; recibos registram os hashes
+instalados. Preferências vêm de `ork experiencia show --json` no projeto da sessão.

package/skills/core/onboarding/SKILL.md

@@ -17,6 +17,13 @@ com `ork onboarding set <etapa> --conteudo <JSON> --por <quem>`. Transporte o JS
 com escaping adequado ao shell. Não invente resposta nem autoria; `owner` é o default do CLI,
 não uma declaração de que o humano respondeu.
 
+Na etapa maestro, consulte `ork experiencia show --json` e apresente a opção recomendada
+detectada, configurar e desativar. Grave somente a escolha recebida em `owner`, com
+`language`, `timezone`, `depth` e `experience`. O núcleo persiste essas chaves no manifesto,
+preservando as demais respostas. Exemplo de opt-out:
+`ork onboarding set maestro --conteudo '{"owner":{"experience":false}}' --por equipe`.
+Sem resposta, mantenha a pergunta pendente: defaults efetivos não são autoria humana.
+
 Peça somente referências de variáveis nas etapas sensíveis. Valores secretos ficam em
 `~/.hermes/.env`; não leia esse arquivo nem leve credenciais para conversa, onboarding ou ledger.
 Se o builder fornecer um segredo, não o repita: oriente a configuração local e registre apenas

package/skills/core/orchestration-experience/SKILL.md

@@ -0,0 +1,113 @@
+---
+name: orchestration-experience
+description: "Conversation experience for people running projects with Orkastery: preferences, decisions, facts and coordination through the core."
+bucket: core
+roteia: "ork experiencia show | ork onboarding | ork roadmap status | ork observe"
+license: MIT
+---
+
+# Orchestration experience
+
+Use in a configured Orkastery project. Read `ork experiencia show --json` in the session's
+project. If `experience` is false, do not activate this pack. Explicit configuration wins;
+detected defaults do not mean a human answered. The `maestro` step of `ork onboarding`
+offers activation, configuration and opt-out. Methodology, validation and authorization
+belong to the core; this skill only guides the conversation.
+
+## 1. Language and time
+
+Use effective `language`, `timezone` and `depth`. Respond in the configured language and
+translate quotations when needed. Use the core's localized presentation (I-35), including
+`prazoLocal`; do not show ISO with Z to humans or rewrite ledger timestamps.
+UTC is valid when chosen or detected by the core; never impose a personal timezone.
+
+## 2. Messages
+
+State in one line; up to four short change bullets; what the person needs to do (usually
+nothing); next step in one line. Respect `curta` or `detalhada`. At most one table.
+Mention SHAs, files and tests only on request or when a decision needs them. Do not narrate
+the investigation. Offer details. Every item ID carries its short name.
+
+## 3. Decisions
+
+Decide autonomously only with a written criterion, worse alternatives by that criterion,
+reversibility before delivery, and cheap, observable mistakes. Otherwise present the
+tradeoff: irreversibility, money or scope changes need a decision. Use
+`ork decisao registrar` through authorized transport: who decided, evidence, reason,
+criterion, how to change it, and reversal cost now/later. Report decisions in the next
+summary, one line per Dn. Decisions must not disappear from the conversation.
+
+## 4. Questions and HITL
+
+Use core presentation (RM-048/I-41) and `ork_request_decision` in the conducting session.
+Relay its output: reply instructions first, one recommendation ✅, costs, reversible ↩️
+or irreversible ⚠️ actions; present real questions immediately. The core controls up to
+five objective questions, four options, short requests of up to 15 lines; open questions
+follow, one at a time, at most two. Do not reimplement the formatter.
+Silence is not human approval. A deadline does not sign a gate; preserve HMAC ingress and
+native identity. Child sessions never answer as the owner. Missing transport stays pending.
+
+## 5. Command destination
+
+Give one destination per line: 💬 in chat, ⌨️ in the terminal, 🌐 in the browser.
+Do not mix an agent message, shell command and web page in one instruction.
+
+## 6. Roadmap
+
+Read `ork_roadmap_status` or `ork roadmap status` and relay core output without rebuilding
+groups, counts or layout. Pair IDs with short names. `#HITL` requires a proven, current
+human dependency; check repository, ledger and publication receipts. Old pages do not
+overrule measured state. Groups and their order belong to the core (RM-048).
+
+## 7. Facts before reports
+
+Read state, events, logs and HEAD before making claims. Use `ork_observe`/`ork observe`
+and core stall detection; honor configured thresholds, without inventing a fixed eight
+minutes or promising permanent surveillance. A skill does not create a monitor. Show real
+failures and skipped steps. Leave a checkpoint when inactive. A registered claim is not
+verified proof.
+
+## 8. Operations
+
+Use dry-run when supported; otherwise rehearse in a temporary project. Never invent flags.
+Secrets stay in the local secret manager; use public references in conversation.
+External or hard-to-reverse actions honor prior explicit authorization and native gates.
+Never change runtime, provider, profile or sandbox to bypass a refusal.
+
+## 9. Public product
+
+Use neutral examples: no personal names, clients, email addresses, chat IDs, hosts, paths
+or goals. Publish only necessary product facts. Private context stays outside the repository.
+
+## 10. Documentation
+
+Answer first, short sentences, one idea per line. Claims grounded in code, stable IDs and
+predictable fields serve people, parity checkers and agents. Divergence is a defect.
+Product facts live in docs; conduction micro-decisions live in the ledger.
+
+## 11. Channels and machines
+
+Before picking an item, read `ork_roadmap_reservas`/`ork roadmap reservas` and
+`ork_fabrica`/`ork fabrica`. Unavailable is not an empty list; disclose stale copies.
+Create authorized work with `ork thread new` and `--roadmap RM-NNN` for core association.
+A query does not reserve. Coordinate the person's channels; never stop another channel's
+session. A dispatched session resumes its phase without opening another orchestration.
+
+## 12. Delivery
+
+Align behavior, changelog, docs, version and applicable distribution. Use `ork verify`,
+`ork ship` and `ork master` through gates, distinguishing commits, local tests, official
+receipts and publication. Never claim delivery without proof. Honor session/version limits.
+
+## Racionalizacoes comuns (Common rationalizations)
+
+| Excuse | Reality |
+| --- | --- |
+| “#Auto lets me approve for the owner” | Silence is not human approval; HMAC stays unchanged. |
+| “The test should pass” | Run it; a registered claim is not an official receipt. |
+| “Installing a skill grants access” | Preferences do not change native permissions. |
+
+## Bandeiras vermelhas (Red flags)
+
+Invented authorship, assumed state, public secrets, reservation inferred from a query or
+methodology duplicated in a host. Static evals do not prove real LLM behavior.

package/skills/core/orchestration-experience-pt-br/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: orchestration-experience-pt-br
+description: "Experiência de conversa para quem conduz projetos com Orkastery: preferências, decisões, fatos e coordenação pelo núcleo."
+bucket: core
+roteia: "ork experiencia show | ork onboarding | ork roadmap status | ork observe"
+license: MIT
+---
+
+# Experiência de orquestração
+
+Use em projeto configurado com Orkastery. Consulte `ork experiencia show --json` no
+projeto da sessão. Se `experience` for false, não ative este pacote. A configuração
+explícita prevalece; defaults detectados não significam que o humano respondeu.
+A etapa `maestro` de `ork onboarding` apresenta ativar, configurar e desativar.
+Metodologia, validação e autorização pertencem ao núcleo; esta skill só orienta a conversa.
+
+## 1. Idioma e horário
+
+Use `language`, `timezone` e `depth` efetivos. Responda no idioma configurado, traduzindo
+citações quando preciso. Use a apresentação localizada do núcleo (I-35), incluindo
+`prazoLocal`; não mostre ISO com Z ao humano nem altere timestamps do ledger.
+UTC é válido quando escolhido ou detectado pelo núcleo, sem impor um fuso pessoal.
+
+## 2. Mensagem
+
+Estado em uma linha; o que mudou em até quatro tópicos; o que precisa da pessoa
+(geralmente nada); próximo passo em uma linha. Respeite `curta` ou `detalhada`.
+No máximo uma tabela. SHA, arquivo e teste só quando solicitados ou relevantes para
+a decisão. Não narre a investigação. Ofereça detalhes. ID de item sempre com nome curto.
+
+## 3. Decisões
+
+Decida autonomamente só com critério escrito, alternativas piores por esse critério,
+reversão possível antes da entrega e erro barato e observável. Se faltar condição,
+apresente o tradeoff: irreversibilidade, dinheiro ou mudança de escopo exigem decisão.
+Use `ork decisao registrar` pelo transporte autorizado: quem decidiu, evidência, razão,
+critério, como mudar e custo de reverter agora/depois. Informe as decisões no próximo
+resumo, uma linha por Dn. Decisão tomada não pode desaparecer da conversa.
+
+## 4. Perguntas e HITL
+
+Use a apresentação do núcleo (RM-048/I-41) e `ork_request_decision` na sessão condutora.
+Transporte como vem: modo de responder primeiro, recomendação única ✅, custos e
+reversibilidade ↩️ ou irreversibilidade ⚠️; perguntas reais são apresentadas imediatamente.
+O núcleo controla lotes de até cinco objetivas, até quatro opções, pedido curto de até
+15 linhas; abertas vêm depois, uma por vez, até duas. Não reimplemente o formatador.
+Silêncio não é aprovação humana. Prazo não assina gate; preserve ingresso HMAC e
+identidade nativa. Sessão filha nunca responde pelo dono. Sem transporte, relate a pendência.
+
+## 5. Destino dos comandos
+
+Indique um destino por linha: 💬 no chat, ⌨️ no terminal, 🌐 no navegador.
+Não misture mensagem ao agente, comando de shell e página na mesma instrução.
+
+## 6. Roadmap
+
+Consulte `ork_roadmap_status` ou `ork roadmap status` e transporte o texto do núcleo,
+sem recriar grupos, contagens ou formato. Use IDs com nome curto. `#HITL` só marca
+pendência humana atual comprovada; confira repositório, ledger e recibos de publicação.
+Página antiga não vence estado medido. Grupos e sua ordem pertencem ao núcleo (RM-048).
+
+## 7. Fatos antes do relato
+
+Leia estado, eventos, log e HEAD antes de afirmar. Use `ork_observe`/`ork observe` e os
+mecanismos de parada do núcleo; respeite limiares configurados, sem inventar oito minutos
+fixos ou prometer vigilância permanente. Skill não cria monitor. Mostre a falha real e
+passos pulados. Sem sessão ativa, deixe checkpoint. Claim cadastrada não é prova verificada.
+
+## 8. Operação
+
+Use dry-run quando o comando o suporta; caso contrário, ensaie em projeto temporário.
+Não invente flags. Segredos ficam no cofre local: só referências públicas na conversa.
+Ação externa ou difícil de desfazer respeita autorização prévia explícita e gates nativos.
+Não altere runtime, provider, perfil ou sandbox para contornar recusa.
+
+## 9. Produto público
+
+Exemplos neutros: sem pessoas, clientes, e-mails, IDs de chat, hosts, caminhos ou metas
+pessoais. Só publique fatos necessários ao produto. Contexto privado fica fora do repositório.
+
+## 10. Documentação
+
+Resposta primeiro, frases curtas e uma ideia por linha. Afirmações conferíveis no código,
+IDs estáveis e campos previsíveis servem a pessoas, verificadores e agentes. Divergência
+é defeito. Fatos de produto nas docs; microdecisões de condução no ledger.
+
+## 11. Canais e máquinas
+
+Antes de pegar item, consulte `ork_roadmap_reservas`/`ork roadmap reservas` e
+`ork_fabrica`/`ork fabrica`. Indisponibilidade não é lista vazia; informe cópia desatualizada.
+Crie trabalho autorizado com `ork thread new` e `--roadmap RM-NNN` para associação pelo
+núcleo. Consultar não reserva. Coordene canais da mesma pessoa; não encerre sessão alheia.
+Sessão despachada retoma a fase recebida, sem abrir outra orquestração.
+
+## 12. Entrega
+
+Alinhe comportamento, changelog, docs, versão e distribuição aplicáveis. Use `ork verify`,
+`ork ship` e `ork master` pelos gates, distinguindo commit, teste local, recibo oficial e
+publicação. Não afirme entrega sem prova. Respeite limite de sessão e versão decididos.
+
+## Racionalizacoes comuns
+
+| Desculpa | Realidade |
+| --- | --- |
+| “#Auto deixa aprovar pelo dono” | Silêncio não é aprovação humana; HMAC não muda. |
+| “O teste deve passar” | Execute; claim cadastrada não é recibo oficial. |
+| “Instalar a skill concede acesso” | Preferências não alteram permissões nativas. |
+
+## Bandeiras vermelhas
+
+Autoria inventada, estado suposto, segredo público, reserva inferida de consulta ou
+metodologia duplicada no host. Evals estáticos não comprovam comportamento real de LLM.

package/skills/core/orkastery-bootstrap/SKILL.md

@@ -30,7 +30,7 @@ de leitura no terminal é `ork maestro --json`; a frase conversacional não é u
 A consulta não cria demanda, thread, sessão ou aprovação. Projeto ausente retorna
 `maestro.project.missing`; ambíguo retorna `maestro.project.ambiguous`: apresente os
 candidatos permitidos e obtenha a seleção, sem varrer home nem escolher o primeiro.
-Se já recebeu fase/thread/WT, continue esse bloco; a frase não abre outra orquestração.
+Se já recebeu fase/thread/WT, continue esse bloco; a frase não abre outra orquestração. O projeto de cada consulta é explícito (RM-052): se o dono nomeou um, passe-o (`projeto` na ferramenta, `--projeto <nome>` no CLI) e leia "Projeto consultado" e "Não lido" antes de responder: board e panorama não leem o roadmap, e zero threads nunca é roadmap vazio. Sem projeto nomeado, ofereça o panorama da rede (RM-054): `ork_network_roadmap` no host (no MCP, o projeto fixado em todas as máquinas) ou `ork network roadmap` no CLI (todos os projetos conhecidos), com fontes, frescor e lacunas, transportado como vem. O status do roadmap sai dessa mesma fonte: lacuna e "Não consultado" nunca viram roadmap vazio nem "nenhuma máquina publicou".
 
 Apresente o panorama com fontes, lacunas e próximas ações: demandas, threads, sessões,
 impedimentos, leases, retries, HITL, SHIP e MASTER. Vazio difere de indisponível;
@@ -52,7 +52,7 @@ Prefira MCP no projeto fixado pelo servidor, sem outro root/cwd. No Claude com s
 
 | Acao | Ferramenta MCP | CLI quando a ferramenta nao esta disponivel |
 |---|---|---|
-| Estado/documentos/claims | `ork_thread_status`, `ork_phase_list`, `ork_artifact_read/write`, `ork_claims_list`, `ork_claim_add` | `ork thread status <thread>`, `ork phase list <thread>`, `ork claims` |
+| Estado/documentos/claims/decisao autonoma | `ork_thread_status`, `ork_phase_list`, `ork_artifact_read/write`, `ork_claims_list`, `ork_claim_add`, `ork_decision_record` | `ork thread status <thread>`, `ork phase list <thread>`, `ork claims`, `ork decisao registrar <thread>` |
 | Demanda nova | `ork_thread_new(nome, modo)` | `ork thread new "<nome>" --mode <modo> --worktree auto` |
 | Despacho | `ork_phase_run(threadId, fase, prompt, runtime?, model?, effort?, dryRun?)` | `ork phase run <thread> GOAL --prompt "<pedido>"` |
 | Progresso nativo | `ork_observe(threadId)` | `ork thread status <thread>` |

package/skills/phases/go-implementation/SKILL.md

@@ -31,6 +31,8 @@ ork verify <thread>                           # reexecuta no HEAD real
    nenhuma, e a base carimbada no `thread.json` e o que diz de onde a thread partiu.
 3. **Baseline gravada antes da primeira linha.** Sem baseline, uma falha depois nao distingue
    regressao de divida pre-existente, e a thread ou leva culpa alheia ou esconde o que quebrou.
+   No codex, cujo sandbox nao grava o estado da thread, o `ork phase run` grava a baseline antes de
+   soltar o bloco com GO: confira o campo `baseline` em `ork_thread_status` e siga, em vez de parar.
 4. **Uma claim por alegacao.** Todo arquivo citado, todo teste citado, toda funcao dita pronta vira
    claim com comando. Passagem relatada por agente nao e passagem.
 5. **Nada fora das tarefas do PLAN.** Melhoria oportunista sem tarefa e scope creep: ela vira