@orkastery/cli 0.4.3 → 0.5.0

package/dist/index.js

@@ -34,12 +34,20 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMANDOS_COM_PROJETO_PROPRIO = void 0;
 exports.parseArgs = parseArgs;
+exports.avisoRoadmapSemAssociacao = avisoRoadmapSemAssociacao;
+exports.extrairOpcaoDeProjeto = extrairOpcaoDeProjeto;
 exports.main = main;
 const company_brain_cli_1 = require("./company-brain-cli");
+const estado_thread_1 = require("./estado-thread");
+const intelligence_graph_cli_1 = require("./intelligence-graph-cli");
 const maestro_cli_1 = require("./maestro-cli");
 const hitl_public_receipt_1 = require("./hitl-public-receipt");
 const hitl_presentation_1 = require("./hitl-presentation");
+const hitl_curto_1 = require("./hitl-curto");
+const roadmap_status_1 = require("./roadmap-status");
+const master_nota_1 = require("./master-nota");
 const hitl_native_offer_1 = require("./hitl-native-offer");
 const hitl_ingress_receipt_1 = require("./hitl-ingress-receipt");
 const node_path_1 = require("node:path");
@@ -79,6 +87,7 @@ const pulse_1 = require("./pulse");
 const pulse_resposta_1 = require("./pulse-resposta");
 const pulse_cadencia_1 = require("./pulse-cadencia");
 const decisao_autonoma_1 = require("./decisao-autonoma");
+const hitl_contract_1 = require("./hitl-contract");
 const orquestracao_1 = require("./orquestracao");
 const divida_1 = require("./divida");
 const ciclos_1 = require("./ciclos");
@@ -105,9 +114,13 @@ const master_2 = require("./master");
 const manifest_1 = require("./manifest");
 const horario_1 = require("./horario");
 const onboarding_1 = require("./onboarding");
+const experiencia_1 = require("./experiencia");
+const hosts_2 = require("./hosts");
 const init_2 = require("./init");
 const memoria_1 = require("./memoria");
 const orkmind_1 = require("./orkmind");
+const indice_vetorial_1 = require("./indice-vetorial");
+const busca_semantica_1 = require("./busca-semantica");
 const recall_1 = require("./recall");
 const memory_migration_1 = require("./memory-migration");
 const fix_1 = require("./fix");
@@ -132,6 +145,7 @@ const thread_1 = require("./thread");
 const docs_1 = require("./docs");
 const roadmap_reservas_1 = require("./roadmap-reservas");
 const fabrica_estado_1 = require("./fabrica-estado");
+const network_roadmap_1 = require("./network-roadmap");
 const fabrica_publicar_1 = require("./fabrica-publicar");
 const maquina_1 = require("./maquina");
 const ledger_1 = require("./ledger");
@@ -143,6 +157,7 @@ const claim_lint_1 = require("./claim-lint");
 const licoes_1 = require("./licoes");
 const demo_1 = require("./demo");
 const entrega_pr_1 = require("./entrega-pr");
+const projeto_alvo_1 = require("./projeto-alvo");
 /** A versao publicada em `@orkastery/cli`, lida do package.json (`versao.ts`). */
 // Antes de qualquer arquivo ou despacho: sem escrita de grupo nem de outros, que o sensor recusaria.
 (0, preflight_1.endurecerUmask)();
@@ -199,7 +214,13 @@ function conducaoDoCli(args) {
 }
 const AJUDA = `ork ${VERSAO}, nucleo de orquestracao do Orkastery
 
-Uso: ork <comando> [argumentos]
+Uso: ork [--projeto <nome|caminho>] <comando> [argumentos]
+
+  --projeto <nome|caminho>                  Projeto-alvo de qualquer comando (RM-052): vence ORK_PROJETO, que vence o
+                                            diretorio atual; nome ambiguo ou desconhecido recusa com os candidatos (saida 4)
+  projetos [--json]                         Projetos conhecidos desta maquina (~/.orkastery/projetos.json)
+  projetos registrar [caminho]              Registra a copia (init, thread new e fabrica entrar ja registram)
+  projetos esquecer <nome|caminho>          Tira do registro a copia que sumiu ou sobrou (nada no disco e apagado)
 
   doctor                                    O que vale nesta maquina agora (sai != 0 se bloqueado)
   init [--force] [--name N] [--abbrev A]    Gera o orkastery.yaml do repositorio
@@ -211,6 +232,9 @@ Uso: ork <comando> [argumentos]
         [--reset [etapa]]                    Reset seletivo ou total, idempotente
   onboarding sync [--json]                  Publicação opcional na memória, com degradação
                                             por bloco de cada modo (default claude-bg/opus/high; #Fast: sonnet)
+  experiencia show [--json]                 Preferências efetivas; configure por onboarding set maestro --conteudo '{"owner":{"experience":true}}'
+  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);
         [--model M] [--effort E] [--por Q]       evento setup_configured no ledger do projeto
@@ -298,13 +322,15 @@ Uso: ork <comando> [argumentos]
   verify <thread-id> [--baseline]           Reexecuta claims e verify do manifesto no HEAD real
         [--so-claims]                       --baseline grava o estado do mundo antes do GO
         [--canal C] [--esperar [min]]       So executa com a conducao da thread (sai 3 se outra conduz)
-  ci prepare <thread-id>                    Exporta claims/comandos para a candidata
+  ci prepare <thread-id>                    Exporta claims/comandos para a candidata (.ork-ci/<thread>.json)
   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
 
   gate next <thread-id> [--proximo FASE]    Gate de tokens: mesma sessao ou nova sessao
         [--ocupacao 0..1] [--fonte F] [--transcript ARQ] [--janela N] [--refazer]
   gate request <thread-id> [--motivo M]     Apresenta pedido HITL correlacionado à pausa
+        [--formato telegram|terminal]           no contrato curto, com o codigo estavel para responder
   gate answer <thread-id> <pedido>          Recebe envelope do ingresso humano autenticado
         --resposta-stdin --por Q --mensagem ID --origem telegram [--canal hermes|openclaw]
         [--conta ID]  conta homologada do canal; obrigatoria no canal openclaw
@@ -335,17 +361,38 @@ Uso: ork <comando> [argumentos]
         [--id ptr-N] [--todos] [--forcar]        momento (retrieve_when), nunca a janela inteira
         [--sem-conteudo] [--json]                (orkmind por tag, files por path#ancora)
 
-  brain status|inventory|get|query|receipts|sync|reconcile|apply|rollback|bind
-  memory status [--json]                    Regime efetivo (files|orkmind), tenant e degradacao
+  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)
+  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
   memory inventory --escopo <threads> [--json]                 Inventaria fontes canonicas e tenants excluidos, sem gravar
   memory migrate --operadora <thread> --escopo <threads> [--dry-run] [--json]                   Migra handoffs por G3, com pacote integral e readback
   memory search --tags '<json>' [--colecao C]  Busca deterministica por tag (mandatory sempre volta)
         [--thread ID] [--restrito] [--janela N] [--limite N] [--json]
+  memory search --texto "<frase>"          Busca por significado (I-38): vetor + FTS por RRF no tenant,
+        [--modo hibrido|vetor|fts]               NAO deterministica; nao combina com --tags nem --thread
+        [--colecao C] [--limite N] [--json]
+  memory index [--modelo primario|fallback|todos] Indice vetorial local do tenant (I-38), idempotente,
+        [--dry-run] [--json]                     com tokens e custo estimados; --dry-run nao chama o provider
+
+  grafo indexar [--verificar] [--forcar]    Indice do grafo de codigo do HEAD limpo (RM-031 KG3) no estado do projeto:
+        [--json]                                 pastas 0700, chave por revisao e extrator, idempotente; --verificar
+                                                 confere contrato, bytes e determinismo; precisa de typescript e micromark
+  grafo status [--json]                     Indices guardados, o do HEAD, os analisadores e o tamanho
+  grafo vizinhos <no> [--profundidade N]    Vizinhanca de arquivo ou simbolo, com extrator e evidencia de cada aresta
+        [--sentido entrada|saida|ambos] [--tipo T,...] [--limite N] [--json]
+  grafo chamadores <simbolo>                Quem chama (arestas calls que chegam) [--profundidade N] [--limite N] [--json]
+  grafo importadores <arquivo|simbolo>      Quem importa (arestas imports que chegam) [--profundidade N] [--limite N] [--json]
+  grafo caminho <de> <para>                 Menor caminho pelas arestas [--sentido saida|entrada|ambos] [--tipo T,...] [--json]
+  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
 
   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 --aceitar-omissao
+        [--repo <dono/nome> --pr <n>]            PR mesclado em repositorio externo de ci.external_repositories
         [--de <branch>] [--remoto origin] [--autorizar-push <quem>] [--sem-push] [--dry-run]
 
   board [--all] [--sem-remoto]              Visao unica das threads (todos os perfis com --all); com a
@@ -375,7 +422,11 @@ Uso: ork <comando> [argumentos]
   master digest <enviar|preview|responder>  Digest semanal com recibos do host
   master <thread-id> --score 0-5 --justificativa "<texto>"
         [--classe C[,C]] [--resumo R] [--por Q] [--refazer]
-                                            Fecha a thread: POSTMORTEM + MASTER log + score
+                                            Fecha a thread: POSTMORTEM + MASTER log + score (so do terminal;
+                                            de processo de host e recusado com master.prova-de-canal)
+  master pedir <thread-id> [--formato telegram|terminal|json]
+                                            Pede a nota ao dono com codigo curto; ele responde pelo Telegram
+                                            (<codigo> <0 a 5> <porque>) e a nota vai ao ledger com o recibo (RM-048)
   master [--todas] [--json]                 As entregas, com o indice derivado do ledger
   master --aceitar-omissao [--json]         Aceita as entregues por omissao, com registro
   master classes                            As classes de falha fixas do POSTMORTEM
@@ -395,11 +446,17 @@ Uso: ork <comando> [argumentos]
         [--pedido "<texto>"] [--template ID]
   prompt render --exemplo --fase F --modo M Renderiza sem thread nenhuma, para revisar o texto
 
+  roadmap status [--json]                   Status report unico do roadmap: grupos com icones, #HITL no que espera
+                                            voce e o fecho com o que precisa de voce e o que vem a seguir (RM-048)
   roadmap reservas [--json] [--remoto R]    Quem esta com cada item do roadmap, lido da branch ork/roadmap-reservas
+        [--soltar-orfas]                     marca a reserva de thread ja fechada (orfa) e, com a opcao, solta
+                                             ou passa para outra thread aberta do mesmo item, com registro
   roadmap pegar <RM-NNN> [--thread T]       Reserva o item para esta maquina (push atomico: o primeiro vence)
         [--nota N] [--por Q] [--maquina M]       maquina = --maquina, ORK_MAQUINA ou o hostname
         [--forcar --motivo M]                    tomar a reserva de outra maquina fica registrado
   roadmap soltar <RM-NNN> [--forcar --motivo M]  Devolve o item
+  roadmap feat [--thread T] [--nota N]      Reserva o proximo numero de FEAT na mesma branch (push atomico: duas
+                                            maquinas nunca levam o mesmo numero; numero reservado nao volta)
   fabrica [--json] [--sem-remoto]           O que cada maquina conduz, lido da branch ork/fabrica-estado (I-51)
   fabrica entrar [--maquina NOME]           Esta maquina entra na fabrica compartilhada deste usuario, com
                                             este nome (~/.orkastery/maquina.json), e publica o primeiro retrato
@@ -407,10 +464,15 @@ Uso: ork <comando> [argumentos]
                                             depois de entrar, sai sozinho ao criar thread, despachar fase,
                                             entregar e fechar, e a cada batida do pulse
   fabrica sair                              Para de publicar daqui e tira o retrato desta maquina da branch
+  network roadmap [--projeto P] [--json]    Roadmap, reservas e threads de cada maquina de cada projeto, de qualquer diretorio:
+        [--sem-remoto]                           fonte e hora de cada parte, lacuna tipada no que nao leu. P = caminho do clone,
+                                                 github:dono/repo, gitlab:grupo/repo ou nome conhecido; sem clone, le a forja (RM-054)
   docs verificar [--json]                   Documentacao de produto e roadmap contra o codigo e o git
                                             (padrao do dono: frontmatter, leitura, paridade; sai != 0 com erro)
   docs sincronizar [--escrever]             Fatos do ledger e do git para o roadmap (merge, fase) e indices;
                                             sem --escrever so mostra; nunca muda status por passagem de tempo
+        [--so RM-NNN[,RM-MMM]] [--todos]     so esses itens (e os indices); na worktree de uma thread com item,
+                                             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)
@@ -526,6 +588,10 @@ function comandoThread(args) {
                 return 1;
             }
             const gravadaDoAchado = args.opcoes['dry-run'] !== true;
+            // RM-052 (D7): thread nova, projeto conhecido; o aviso nunca derruba a criacao.
+            const avisoDoRegistroDoAchado = gravadaDoAchado && r.thread ? (0, projeto_alvo_1.registrarProjetoEmSilencio)(carregado.raiz, 'thread new') : null;
+            if (avisoDoRegistroDoAchado)
+                console.error(avisoDoRegistroDoAchado);
             console.log(gravadaDoAchado
                 ? `Thread criada a partir do achado ${r.achado.id}.`
                 : 'Simulacao (--dry-run), nada foi gravado.');
@@ -567,6 +633,9 @@ function comandoThread(args) {
             console.error('uso: ork thread new <nome> --modo <MODO>');
             return 2;
         }
+        const avisoRoadmap = avisoRoadmapSemAssociacao(nome, texto(args.opcoes.roadmap));
+        if (avisoRoadmap)
+            console.error(avisoRoadmap);
         const brutoModo = texto(args.opcoes.modo) ?? texto(args.opcoes.mode);
         let modo;
         try {
@@ -646,6 +715,10 @@ function comandoThread(args) {
         // I-51 (RM-047): com a fabrica compartilhada, as outras maquinas veem a thread nova.
         if (gravada)
             (0, fabrica_publicar_1.publicarEmSegundoPlano)(carregado.raiz);
+        // RM-052 (D7): quem abre thread aqui conhece este projeto; o aviso nunca derruba a criacao.
+        const avisoDoRegistro = gravada ? (0, projeto_alvo_1.registrarProjetoEmSilencio)(carregado.raiz, 'thread new') : null;
+        if (avisoDoRegistro)
+            console.error(avisoDoRegistro);
         console.log(gravada ? 'Thread criada.' : 'Simulacao (--dry-run), nada foi gravado.');
         if (reservaDoItem)
             console.log(`  roadmap: ${reservaDoItem.item} reservado para esta maquina (${reservaDoItem.reserva?.maquina})`);
@@ -762,7 +835,7 @@ function comandoOnboarding(args) {
         estado = (0, onboarding_1.resetarOnboarding)(raiz, etapa, por);
     else
         estado = (0, onboarding_1.lerOnboarding)(raiz);
-    console.log(args.opcoes.json === true ? JSON.stringify(estado, null, 2) : (0, onboarding_1.textoDaPauta)(estado));
+    console.log(args.opcoes.json === true ? JSON.stringify(estado, null, 2) : (0, onboarding_1.textoDaPauta)(estado, (0, manifest_1.exigirManifesto)(raiz).manifesto.owner));
     return 0;
 }
 /**
@@ -1014,6 +1087,32 @@ function comandoPhase(args) {
             console.log(args.opcoes.json === true && r.recusa ? JSON.stringify(r.recusa, null, 2) : r.recusa?.texto ?? r.erro);
             return 3;
         }
+        // RM-037 (defeito 3): a recusa por vaga e espera, como a da conducao (codigo 3), e diz quem ocupa.
+        if (r.motivo === 'concurrency.limite' && r.vaga) {
+            if (args.opcoes.json === true) {
+                console.log(JSON.stringify({ motivo: r.motivo, ...r.vaga }, null, 2));
+                return 3;
+            }
+            console.log(`Despacho recusado: concurrency.limite. O projeto ja tem ${r.vaga.ocupam.length} sessao(oes) viva(s) ` +
+                `em outras threads e o limite e ${r.vaga.limite} (concurrency.max_parallel_threads).`);
+            for (const o of r.vaga.ocupam) {
+                console.log(`  ${o.thread.padEnd(20)} ${(o.fase ?? '-').padEnd(6)} ` +
+                    `${o.sessao ? `${o.runtime} ${o.sessao.slice(0, 8)}` : 'despacho em curso'}, desde ${(0, horario_1.localizarTextoRotulado)(o.desde)}`);
+            }
+            console.log(`  correcao: ${r.vaga.correcao}`);
+            console.log(r.dryRun ? '  ensaio (--dry-run): nada foi gravado.' : `  evento slot_refused no ledger de ${id}; nenhuma sessao aberta.`);
+            return 3;
+        }
+        // RM-037 (S-4 do CHECK 3): a baseline que o despacho nao conseguiu gravar nao e gate reprovado.
+        if (r.motivo === 'baseline.pendente') {
+            if (args.opcoes.json === true) {
+                console.log(JSON.stringify({ motivo: r.motivo, detalhe: r.erro }, null, 2));
+                return 1;
+            }
+            console.error(`Despacho recusado: ${r.erro}`);
+            console.error('  nenhuma sessao aberta; o ledger nao ganhou gate_blocked');
+            return 1;
+        }
         if (r.dryRun && !r.bloqueado) {
             console.log('Simulacao (--dry-run), nada foi despachado.');
             console.log(`  slug da sessao : ${r.slug}`);
@@ -1136,7 +1235,7 @@ function comandoSessionsHitl(args, raiz) {
 function comandoSessions(args) {
     const sub = args.posicionais[1];
     const carregado = (0, manifest_1.carregarManifesto)();
-    const raiz = carregado?.raiz ?? process.cwd();
+    const raiz = carregado?.raiz ?? (0, manifest_1.diretorioDoProjeto)();
     if (sub === 'watch') {
         const id = texto(args.opcoes.thread);
         if (!carregado || !id) {
@@ -1260,12 +1359,21 @@ function comandoDecisao(args) {
         if (separador < 1 || !['manifesto', 'ledger', 'medicao'].includes(tipo) || !referencia.trim()) {
             throw new Error('decisao registrar: --criterio manifesto:CHAVE, ledger:REF ou medicao:COMANDO');
         }
-        const { pedido, evento } = (0, decisao_autonoma_1.registrarDecisao)(carregado.raiz, id, {
+        const entrada = {
             decidido: campo('decidido'), porque: campo('porque'), comoMudar: campo('como-mudar'),
             custoDeReverter: { agora: campo('custo-agora'), depois: campo('custo-depois') },
             criterio: { tipo, referencia }, quemDecidiu: campo('quem'), evidencia: campo('evidencia'),
             razao: texto(args.opcoes.razao), reverte: texto(args.opcoes.reverte),
-        });
+        };
+        let registro;
+        // RM-037 (defeito 4): a recusa cita a flag que o dono digitou, com o tamanho e o teto reais.
+        try {
+            registro = (0, decisao_autonoma_1.registrarDecisao)(carregado.raiz, id, entrada);
+        }
+        catch (e) {
+            throw new Error((0, hitl_contract_1.recusaNaSuperficie)(e.message, hitl_contract_1.CAMPOS_DA_DECISAO_NO_CLI));
+        }
+        const { pedido, evento } = registro;
         const placar = (0, decisao_autonoma_1.placarDaThread)((0, ledger_1.lerLedger)((0, thread_1.dirThread)(carregado.raiz, id))).find(f => f.fase === pedido.fase);
         console.log(JSON.stringify({ ok: true, pedidoId: pedido.id, eventId: evento.eventId, fase: pedido.fase, placar }));
         return 0;
@@ -1461,6 +1569,14 @@ function comandoConducao(args) {
     }
     throw new Error('uso: ork conducao status|assumir <thread-id>');
 }
+/** RM-048 (D1): o gate aberto no contrato curto, com o codigo estavel e o "desde" do ledger. */
+function textoDoGateCurto(raiz, pedido, canal) {
+    const quando = new Date().toISOString();
+    const eventos = (0, ledger_1.lerLedger)((0, thread_1.dirThread)(raiz, pedido.thread));
+    const codigo = pedido.codigo;
+    const curto = (0, hitl_curto_1.montarPedidoCurto)((0, hitl_curto_1.entradaDoPedido)(pedido, (0, hitl_curto_1.desdeDoPedido)(eventos, pedido)), { quando, responder: typeof codigo === 'string' ? { tipo: 'codigo', codigo } : { tipo: 'dialogo' } });
+    return (0, hitl_curto_1.textoDoPedidoCurto)(curto, canal);
+}
 function comandoGate(args) {
     const carregado = (0, manifest_1.exigirManifesto)();
     const sub = args.posicionais[1];
@@ -1479,7 +1595,13 @@ function comandoGate(args) {
         const id = args.posicionais[2];
         if (!id)
             throw new Error('gate request exige thread');
-        console.log(JSON.stringify((0, hitl_gates_1.abrirPedidoGate)(carregado.raiz, id, texto(args.opcoes.motivo))));
+        const formato = texto(args.opcoes.formato);
+        if (formato !== undefined && formato !== 'telegram' && formato !== 'terminal')
+            throw new Error('gate request: --formato telegram|terminal');
+        const pedido = (0, hitl_gates_1.abrirPedidoGate)(carregado.raiz, id, texto(args.opcoes.motivo));
+        // RM-048 (D1): com --formato, o que sai e o pedido no contrato curto, pronto para o canal, com
+        // o codigo estavel na ultima linha. Sem ele, o JSON de sempre, para quem integra.
+        console.log(formato ? textoDoGateCurto(carregado.raiz, pedido, formato) : JSON.stringify(pedido));
         return 0;
     }
     if (sub === 'answer') {
@@ -1827,11 +1949,14 @@ function comandoShip(args) {
         // I-57 (RM-008): a entrega feita por PR vira ship_done, provada no remoto e no CI.
         const alvo = args.posicionais[2];
         const remoto = texto(args.opcoes.remoto);
-        if (!alvo && args.opcoes.todas !== true) {
-            console.error('uso: ork ship registrar-pr <thread-id> | --todas [--remoto R] [--json]');
+        // RM-037 (defeito 5): PR mesclado em repositorio externo declarado em ci.external_repositories.
+        const repo = texto(args.opcoes.repo), numeroDoPr = texto(args.opcoes.pr);
+        if ((!alvo && args.opcoes.todas !== true) || (!!repo !== !!numeroDoPr) || (repo && !alvo)) {
+            console.error('uso: ork ship registrar-pr <thread-id> [--repo <dono/nome> --pr <n>] | --todas [--remoto R] [--json]');
             return 2;
         }
-        const r = alvo ? [(0, entrega_pr_1.registrarEntregaPorPr)(carregado, alvo, { remoto })] : (0, entrega_pr_1.registrarEntregasPorPr)(carregado, { remoto });
+        const r = alvo && repo ? [(0, entrega_pr_1.registrarEntregaExternaPorPr)(carregado, alvo, { repositorio: repo, pr: Number(numeroDoPr) })]
+            : alvo ? [(0, entrega_pr_1.registrarEntregaPorPr)(carregado, alvo, { remoto })] : (0, entrega_pr_1.registrarEntregasPorPr)(carregado, { remoto });
         if (args.opcoes.json === true) {
             console.log(JSON.stringify(r, null, 2));
             return r.some((x) => x.acao === 'recusada') ? 1 : 0;
@@ -2028,9 +2153,16 @@ function comandoCi(args) {
             console.log(JSON.stringify(result, null, 2));
             return result.ok ? 0 : 1;
         }
+        // RM-037 (rm037noite, defeito 1): o CI passa a branch e acha o `.ork-ci/<thread>.json` dela.
+        const branch = texto(args.opcoes.branch);
+        if (branch) {
+            const result = (0, ci_1.executarCiDaBranch)(carregado, branch);
+            console.log(JSON.stringify(result, null, 2));
+            return result.ok ? 0 : 1;
+        }
         const thread = args.posicionais[2];
         if (!thread) {
-            console.error('uso: ork ci run <thread-id> [--json] | ork ci run --bundle <arquivo>');
+            console.error('uso: ork ci run <thread-id> [--json] | ork ci run --bundle <arquivo> | ork ci run --branch <branch>');
             return 2;
         }
         const result = (0, ci_1.executarCi)(carregado, thread);
@@ -2094,12 +2226,34 @@ function comandoLease(args) {
     console.error(`subcomando desconhecido: lease ${sub}`);
     return 2;
 }
+/**
+ * RM-052: o cabecalho do board. O board le as threads DESTE projeto nesta maquina; o roadmap nunca
+ * e lido aqui, e "0 threads" nunca quer dizer "roadmap vazio". As outras maquinas so entram com a
+ * fabrica compartilhada e um remoto de verdade.
+ */
+function consultaDoBoard(carregado, opcoes) {
+    const remoto = carregado.manifesto.fabrica.remoto;
+    const comFabrica = !opcoes.plano && (0, maquina_1.fabricaCompartilhada)(carregado.manifesto);
+    const url = (0, projeto_alvo_1.remotoDoProjeto)(carregado.raiz, remoto);
+    return (0, projeto_alvo_1.consultaDoProjeto)(carregado, {
+        remoto: url,
+        lido: [`${projeto_alvo_1.FORA_DA_CONSULTA.threadsDaMaquina}${opcoes.todos ? ' (todos os perfis)' : ''}`,
+            ...(comFabrica && url !== null ? [`outras máquinas (ork/fabrica-estado em ${remoto})`] : [])],
+        naoLido: [projeto_alvo_1.FORA_DA_CONSULTA.roadmap, projeto_alvo_1.FORA_DA_CONSULTA.reservas,
+            ...(url === null ? [(0, projeto_alvo_1.semRemoto)(remoto)] : comFabrica ? [] : [projeto_alvo_1.FORA_DA_CONSULTA.outrasMaquinas])],
+    });
+}
 function comandoBoard(args) {
     const carregado = (0, manifest_1.exigirManifesto)();
     const sub = args.posicionais[1];
+    const todos = args.opcoes.all === true || args.opcoes.todos === true;
     if (sub === 'plan' || sub === 'plano') {
         const plano = (0, board_1.planejar)(carregado);
-        console.log(args.opcoes.json === true ? JSON.stringify(plano, null, 2) : (0, board_1.textoDoPlano)(plano));
+        const consulta = consultaDoBoard(carregado, { plano: true, todos: false });
+        if (args.opcoes.json === true)
+            console.log(JSON.stringify({ ...plano, consulta }, null, 2));
+        else
+            console.log([...(0, projeto_alvo_1.linhasDaConsulta)(consulta), '', (0, board_1.textoDoPlano)(plano)].join('\n'));
         return 0;
     }
     if (sub === 'reap') {
@@ -2115,21 +2269,31 @@ function comandoBoard(args) {
         console.error('uso: ork board [list|plan|reap] [--all] [--por <quem>] [--json]');
         return 2;
     }
-    const todos = args.opcoes.all === true || args.opcoes.todos === true;
+    const consulta = consultaDoBoard(carregado, { plano: false, todos });
     if (args.opcoes.json === true) {
-        console.log(JSON.stringify((0, board_1.threadsDeTodosOsPerfis)(carregado, todos), null, 2));
+        // RM-052 (D6): objeto com o cabecalho; a lista de threads continua inteira em `threads`.
+        console.log(JSON.stringify({ contrato: CONTRATO_DO_BOARD, consulta, threads: (0, board_1.threadsDeTodosOsPerfis)(carregado, todos) }, null, 2));
         return 0;
     }
+    console.log([...(0, projeto_alvo_1.linhasDaConsulta)(consulta), ''].join('\n'));
     console.log((0, board_1.textoDoBoard)(carregado, todos));
     // I-51 (RM-047): com a fabrica compartilhada, o board mostra tambem as outras maquinas.
     if ((0, maquina_1.fabricaCompartilhada)(carregado.manifesto)) {
-        const painel = (0, fabrica_estado_1.lerFabrica)(carregado.raiz, { remoto: carregado.manifesto.fabrica.remoto,
-            semRemoto: args.opcoes['sem-remoto'] === true });
         console.log('');
-        console.log((0, fabrica_estado_1.textoDasOutrasMaquinas)(painel, (0, maquina_1.nomeDaMaquina)()));
+        // RM-052: sem o remoto, nada foi lido; dizer "nenhuma publicou" seria a frase do incidente de 29/09.
+        if (consulta.projeto.remoto === null) {
+            console.log(`Outras maquinas: o projeto ${carregado.manifesto.project.name} nao tem o remoto ${carregado.manifesto.fabrica.remoto}; nada foi lido de ork/fabrica-estado.`);
+        }
+        else {
+            const painel = (0, fabrica_estado_1.lerFabrica)(carregado.raiz, { remoto: carregado.manifesto.fabrica.remoto,
+                semRemoto: args.opcoes['sem-remoto'] === true });
+            console.log((0, fabrica_estado_1.textoDasOutrasMaquinas)(painel, (0, maquina_1.nomeDaMaquina)()));
+        }
     }
     return 0;
 }
+/** RM-052 (D6): `ork board --json` deixou de ser lista para carregar o cabecalho da consulta. */
+const CONTRATO_DO_BOARD = 'ork.board/v1';
 /**
  * I-51 (RM-047): `ork fabrica` mostra o que cada maquina conduz; `ork fabrica publicar` grava o
  * retrato desta maquina na branch `ork/fabrica-estado`. O `--silencioso` e o da publicacao em
@@ -2173,6 +2337,10 @@ function comandoFabrica(args) {
         const config = (0, maquina_1.gravarConfigDaMaquina)({ nome: texto(args.opcoes.maquina) ?? (0, maquina_1.lerConfigDaMaquina)()?.nome ?? (0, maquina_1.nomeDaMaquina)(),
             fabricaCompartilhada: true });
         const r = (0, fabrica_estado_1.publicarMaquina)(carregado, { remoto, forcar: true });
+        // RM-052 (D7): a maquina que entra na fabrica deste projeto passa a conhece-lo pelo nome.
+        const avisoDoRegistro = (0, projeto_alvo_1.registrarProjetoEmSilencio)(carregado.raiz, 'fabrica entrar');
+        if (avisoDoRegistro)
+            console.error(avisoDoRegistro);
         console.log(`Fabrica: esta maquina entrou como ${config.nome}; publica ao criar thread, despachar fase, entregar e fechar,`);
         console.log(`  e a cada batida do pulse. Primeiro retrato: ${r.threads} thread(s) em ork/fabrica-estado (${r.commit?.slice(0, 7)}).`);
         if (process.env.ORK_MAQUINA && process.env.ORK_MAQUINA.trim() !== config.nome) {
@@ -2195,10 +2363,82 @@ function comandoFabrica(args) {
         console.error('uso: ork fabrica [--json] [--sem-remoto] | fabrica publicar [--forcar] [--json] | fabrica entrar [--maquina NOME] | fabrica sair');
         return 2;
     }
-    const painel = (0, fabrica_estado_1.lerFabrica)(carregado.raiz, { remoto, semRemoto: args.opcoes['sem-remoto'] === true });
-    console.log(args.opcoes.json === true ? JSON.stringify(painel, null, 2) : (0, fabrica_estado_1.textoDaFabrica)(painel, (0, maquina_1.nomeDaMaquina)()));
+    // RM-052: a fabrica le a branch de UM projeto, no remoto dele; o cabecalho diz qual e o que ficou de fora.
+    const url = (0, projeto_alvo_1.remotoDoProjeto)(carregado.raiz, remoto);
+    const painel = url === null ? { maquinas: [], atualizado: false, ponta: null }
+        : (0, fabrica_estado_1.lerFabrica)(carregado.raiz, { remoto, semRemoto: args.opcoes['sem-remoto'] === true });
+    const consulta = (0, projeto_alvo_1.consultaDoProjeto)(carregado, {
+        remoto: url,
+        lido: url === null ? [] : [`ork/fabrica-estado em ${remoto} (${painel.atualizado ? 'lido agora' : 'última cópia local'})`],
+        naoLido: [projeto_alvo_1.FORA_DA_CONSULTA.roadmap, projeto_alvo_1.FORA_DA_CONSULTA.reservas, ...(url === null ? [(0, projeto_alvo_1.semRemoto)(remoto)] : [])],
+    });
+    if (args.opcoes.json === true) {
+        console.log(JSON.stringify({ ...painel, consulta }, null, 2));
+        return 0;
+    }
+    console.log([...(0, projeto_alvo_1.linhasDaConsulta)(consulta), ''].join('\n'));
+    console.log(url === null
+        ? `Fabrica: o projeto ${carregado.manifesto.project.name} nao tem o remoto ${remoto}; nada foi lido de ork/fabrica-estado.`
+        : (0, fabrica_estado_1.textoDaFabrica)(painel, (0, maquina_1.nomeDaMaquina)()));
     return 0;
 }
+/**
+ * RM-052: `ork projetos` lista o registro desta maquina (`~/.orkastery/projetos.json`); `registrar`
+ * poe uma copia que ja existia antes do registro (init, thread new e fabrica entrar ja registram) e
+ * `esquecer` tira a copia que sumiu ou sobrou. Sem segredo: so nome, abbrev, raiz e remoto redigido.
+ */
+function comandoProjetos(args, projeto) {
+    const sub = args.posicionais[1] ?? 'list';
+    if (sub === 'list' || sub === 'listar') {
+        const projetos = (0, projeto_alvo_1.listarProjetos)();
+        if (args.opcoes.json === true) {
+            console.log(JSON.stringify({ contrato: projeto_alvo_1.CONTRATO_PROJETOS, arquivo: (0, projeto_alvo_1.caminhoDoRegistro)(), projetos }, null, 2));
+            return 0;
+        }
+        console.log(`Projetos conhecidos desta maquina (${(0, projeto_alvo_1.raizParaExibir)((0, projeto_alvo_1.caminhoDoRegistro)())})`);
+        console.log('');
+        if (projetos.length === 0) {
+            console.log('  Nenhum ainda. ork init, ork thread new e ork fabrica entrar registram; ou: ork projetos registrar <caminho>');
+            return 0;
+        }
+        console.log((0, util_1.tabela)(['NOME', 'ABBREV', 'RAIZ', 'REMOTO', 'NO DISCO', 'ATUALIZADO'], projetos.map((p) => [
+            p.nome, p.abbrev || '-', (0, projeto_alvo_1.raizParaExibir)(p.raiz), p.remoto ?? 'sem remoto', p.presente ? 'sim' : 'ausente',
+            (0, horario_1.formatarDataHora)(p.atualizadoEm)
+        ])));
+        console.log('');
+        console.log('Use --projeto <nome> em qualquer comando (ORK_PROJETO vale para o shell inteiro). ' + (0, horario_1.legendaDoFuso)());
+        return 0;
+    }
+    if (sub === 'registrar') {
+        const caminho = args.posicionais[2];
+        if (caminho !== undefined && projeto !== undefined)
+            throw new Error('uso: ork projetos registrar [caminho] (um caminho ou --projeto, não os dois)');
+        const alvo = caminho === undefined ? (0, projeto_alvo_1.resolverProjetoAlvo)({ opcao: projeto ?? null }) : null;
+        const p = (0, projeto_alvo_1.registrarProjeto)(caminho ?? alvo?.raiz ?? process.cwd(), 'projetos registrar');
+        if (args.opcoes.json === true) {
+            console.log(JSON.stringify(p, null, 2));
+            return 0;
+        }
+        console.log(`Projeto ${p.nome} (${p.abbrev || '-'}) registrado: ${(0, projeto_alvo_1.raizParaExibir)(p.raiz)} · ${p.remoto ?? 'sem remoto'}`);
+        return 0;
+    }
+    if (sub === 'esquecer') {
+        const alvo = args.posicionais[2] ?? projeto;
+        if (!alvo)
+            throw new Error('uso: ork projetos esquecer <nome|caminho>');
+        const sairam = (0, projeto_alvo_1.esquecerProjeto)(alvo);
+        if (args.opcoes.json === true) {
+            console.log(JSON.stringify(sairam, null, 2));
+            return 0;
+        }
+        for (const p of sairam)
+            console.log(`Projeto ${p.nome} esquecido: ${(0, projeto_alvo_1.raizParaExibir)(p.raiz)} (nada no disco foi apagado)`);
+        return 0;
+    }
+    console.error(`subcomando desconhecido: projetos ${sub}`);
+    console.error('uso: ork projetos [--json] | projetos registrar [caminho] | projetos esquecer <nome|caminho>');
+    return 2;
+}
 /**
  * `ork orquestracao status` (alias `ork monitor`): pausas e impedimentos de uma chamada.
  *
@@ -2314,9 +2554,20 @@ function comandoMaster(args) {
         console.log(JSON.stringify(r, null, 2));
         return r.ok ? 0 : 1;
     }
+    if (primeiro === 'pedir') {
+        // RM-048 (item 8): a nota com prova. O canal mostra a linha; o dono responde pelo Telegram.
+        const id = args.posicionais[2];
+        const formato = texto(args.opcoes.formato) ?? 'telegram';
+        if (!id || !['telegram', 'terminal', 'json'].includes(formato))
+            throw new Error('uso: ork master pedir <thread> [--formato telegram|terminal|json]');
+        const pedido = (0, master_nota_1.pedirNota)(carregado.raiz, id, { codigosEmUso: (0, pulse_resposta_1.codigosEmUso)(carregado.raiz) });
+        console.log(formato === 'json' ? JSON.stringify(pedido, null, 2) : (0, master_nota_1.textoDoPedidoDeNota)(carregado.raiz, pedido, formato));
+        return 0;
+    }
     if (primeiro === 'digest') {
         const sub = args.posicionais[2];
         if (sub === 'responder') {
+            (0, master_nota_1.exigirNotaSemHost)();
             console.log(JSON.stringify((0, master_digest_1.responderLoteDigest)(carregado.raiz, texto(args.opcoes.resposta) ?? '', texto(args.opcoes.por) ?? '').map(r => ({ thread: r.thread.id, score: r.masterLog.score })), null, 2));
             return 0;
         }
@@ -2339,6 +2590,7 @@ function comandoMaster(args) {
         return 0;
     }
     if (primeiro === 'ratificar' || ((args.opcoes.batch === true || primeiro === 'batch') && args.opcoes.aceitar)) {
+        (0, master_nota_1.exigirNotaSemHost)();
         let selecao;
         if (primeiro === 'ratificar') {
             const partes = (texto(args.opcoes.resposta) ?? '').trim().split(/\s+/);
@@ -2434,6 +2686,8 @@ function comandoMaster(args) {
         console.log(JSON.stringify((0, master_1.proporMaster)(carregado.raiz, id, opcoesMaster), null, 2));
         return 0;
     }
+    // RM-048 (D8): nota em nome de pessoa, de processo de host, so pelo ingresso autenticado.
+    (0, master_nota_1.exigirNotaSemHost)();
     const r = (0, master_2.registrarMaster)(carregado.raiz, id, opcoesMaster);
     console.log((0, master_2.textoDoMaster)(r));
     // Bloco B6: fechada a thread, a licao (POSTMORTEM + score) vai para a colecao
@@ -2478,13 +2732,47 @@ function comandoRoadmap(args) {
     const sub = args.posicionais[1] ?? 'reservas';
     const remoto = texto(args.opcoes.remoto);
     if (sub === 'reservas') {
+        // RM-037 (rm037noite, defeito 3): a reserva de thread ja fechada aparece como orfa e sai com registro.
+        if (args.opcoes['soltar-orfas'] === true) {
+            const soltas = (0, roadmap_reservas_1.soltarReservasOrfas)(carregado.raiz, { remoto });
+            if (args.opcoes.json === true)
+                console.log(JSON.stringify(soltas, null, 2));
+            else
+                console.log(soltas.length === 0 ? 'Nenhuma reserva órfã desta máquina.'
+                    : soltas.map((s) => `${s.item}: ${s.detalhe} (thread fechada ${s.thread})`).join('\n'));
+            return 0;
+        }
         const painel = (0, roadmap_reservas_1.listarReservas)(carregado.raiz, { remoto });
-        console.log(args.opcoes.json === true ? JSON.stringify(painel, null, 2) : (0, roadmap_reservas_1.textoDasReservas)(painel));
+        const orfas = (0, roadmap_reservas_1.reservasOrfas)(carregado.raiz, painel.reservas);
+        console.log(args.opcoes.json === true ? JSON.stringify({ ...painel, orfas }, null, 2) : (0, roadmap_reservas_1.textoDasReservas)(painel, orfas));
+        return 0;
+    }
+    if (sub === 'status') {
+        // RM-048 (item 7): o status report unico do roadmap. Os canais chamam isto e transportam o texto.
+        // RM-052: com o projeto consultado e o que ficou de fora (as outras maquinas nao sao lidas aqui).
+        const consulta = (0, projeto_alvo_1.consultaDoProjeto)(carregado, { lido: ['roadmap (docs/roadmap)', projeto_alvo_1.FORA_DA_CONSULTA.threadsDaMaquina],
+            naoLido: [projeto_alvo_1.FORA_DA_CONSULTA.reservas, 'threads de outras máquinas (ork network roadmap)'] });
+        const status = (0, roadmap_status_1.montarStatusDoRoadmap)(carregado.raiz, { projeto: carregado.manifesto.project.name, consulta });
+        console.log(args.opcoes.json === true ? JSON.stringify(status, null, 2) : (0, roadmap_status_1.textoDoStatusDoRoadmap)(status));
+        return 0;
+    }
+    // RM-037 (rm037noite, defeito 6): o numero da FEAT nova sai da mesma branch de reservas.
+    if (sub === 'feat') {
+        const r = (0, roadmap_reservas_1.reservarFeat)(carregado.raiz, { remoto, por: texto(args.opcoes.por), maquina: texto(args.opcoes.maquina),
+            thread: texto(args.opcoes.thread) ?? null, nota: texto(args.opcoes.nota) ?? null });
+        if (args.opcoes.json === true)
+            console.log(JSON.stringify(r, null, 2));
+        else {
+            console.log(`${r.feat}: reservado para esta maquina${r.reserva.thread ? `, thread ${r.reserva.thread}` : ''}.`);
+            console.log(`  crie docs/produto/${r.feat}-<assunto>.md; o numero nao volta, mesmo que a feature nao saia`);
+            console.log(`  branch ork/roadmap-reservas em ${r.commit.slice(0, 7)}`);
+        }
         return 0;
     }
     const item = args.posicionais[2];
     if ((sub !== 'pegar' && sub !== 'soltar') || !item) {
-        console.error('uso: ork roadmap reservas | pegar <RM-NNN> [--thread T] [--nota N] | soltar <RM-NNN> [--forcar --motivo M]');
+        console.error('uso: ork roadmap status [--json] | reservas [--soltar-orfas] | pegar <RM-NNN> [--thread T] [--nota N] | ' +
+            'soltar <RM-NNN> [--forcar --motivo M] | feat [--thread T] [--nota N]');
         return 2;
     }
     const opcoes = {
@@ -2510,10 +2798,35 @@ function comandoRoadmap(args) {
         console.log(`  branch ork/roadmap-reservas em ${r.commit.slice(0, 7)}`);
     return 0;
 }
+/**
+ * RM-054 (fatia 1): `ork network roadmap`, o roadmap da rede de qualquer diretorio. Pedido de projeto
+ * ambiguo ou desconhecido e resposta, nao erro: a recusa com os candidatos, e o codigo da RM-052.
+ */
+function comandoNetwork(args) {
+    const pedido = texto(args.opcoes.projeto);
+    if (args.posicionais[1] !== 'roadmap' || args.posicionais.length > 2 || (args.opcoes.projeto !== undefined && !pedido)) {
+        console.error('uso: ork network roadmap [--projeto <caminho|github:dono/repo|gitlab:grupo/repo|nome>] [--json] [--sem-remoto]');
+        return 2;
+    }
+    try {
+        // RM-054 (fatia 2, D-G4 e D-G6): o host que declara nao ter cwd de projeto (RM-052, D3) pede por
+        // nome ou pela forja, e o projeto do diretorio dele so entra pelo registro.
+        const host = (process.env[projeto_alvo_1.ENV_PROJETO_EXPLICITO] ?? '').trim() === '1';
+        const p = (0, network_roadmap_1.montarPanoramaDaRede)({ pedido, semRemoto: args.opcoes['sem-remoto'] === true, host });
+        console.log(args.opcoes.json === true ? JSON.stringify(p, null, 2) : (0, network_roadmap_1.textoDoPanoramaDaRede)(p));
+        return p.projetos.length ? 0 : 2;
+    }
+    catch (e) {
+        if (!(e instanceof network_roadmap_1.ErroDoPedidoDeProjeto))
+            throw e;
+        console.log(args.opcoes.json === true ? JSON.stringify(e.recusa, null, 2) : e.texto);
+        return network_roadmap_1.SAIDA_DO_PEDIDO;
+    }
+}
 function comandoDocs(args) {
     const sub = args.posicionais[1] ?? 'verificar';
     const carregado = (0, manifest_1.carregarManifesto)();
-    const raiz = carregado?.raiz ?? process.cwd();
+    const raiz = carregado?.raiz ?? (0, manifest_1.diretorioDoProjeto)();
     const baseBranch = carregado?.manifesto.worktree?.base_branch ?? 'main';
     if (sub === 'verificar') {
         const { docs, achados } = (0, docs_1.verificarDocs)(raiz, { baseBranch, ajudaDoCli: AJUDA });
@@ -2528,8 +2841,36 @@ function comandoDocs(args) {
     }
     if (sub === 'sincronizar') {
         const escrever = args.opcoes.escrever === true;
-        const r = (0, docs_1.sincronizarDocs)(raiz, { baseBranch, escrever });
-        console.log(args.opcoes.json === true ? JSON.stringify(r, null, 2) : (0, docs_1.textoDaSincronizacao)(r, escrever));
+        // RM-037 (rm037noite, defeito 5): o escopo. `--so` diz os itens; sem ele, na worktree de uma thread
+        // com item, so o item dela; `--todos` (ou fora de worktree de thread) volta a todo item.
+        // Sugestao 4 do CHECK 1 (e 8 do CHECK 2, `--so=`): `--so` sem item e erro de uso, nunca o escopo
+        // padrao em silencio.
+        if (args.opcoes.so === true || (typeof args.opcoes.so === 'string' && !args.opcoes.so.trim())) {
+            console.error('uso: ork docs sincronizar --so RM-NNN[,RM-MMM] (faltou o item depois de --so)');
+            return 2;
+        }
+        const so = texto(args.opcoes.so);
+        let itens;
+        let escopo = 'todo item do roadmap';
+        if (so) {
+            itens = so.split(',').map((i) => i.trim().toUpperCase()).filter(Boolean);
+            const fora = itens.filter((i) => !/^RM-\d{3}$/.test(i));
+            if (fora.length || itens.length === 0) {
+                console.error(`uso: ork docs sincronizar --so RM-NNN[,RM-MMM] (recebido: ${so})`);
+                return 2;
+            }
+            escopo = `so ${itens.join(', ')} (--so)`;
+        }
+        else if (args.opcoes.todos !== true) {
+            const padrao = (0, docs_1.escopoPadraoDoSync)(raiz);
+            if (padrao.itens) {
+                itens = padrao.itens;
+                escopo = `so ${itens.join(', ')}, o item da thread ${padrao.thread} desta worktree (--todos para todo item)`;
+            }
+        }
+        const r = (0, docs_1.sincronizarDocs)(raiz, { baseBranch, escrever, itens });
+        console.log(args.opcoes.json === true ? JSON.stringify({ ...r, escopo: itens ?? null }, null, 2)
+            : `Escopo: ${escopo}.\n${(0, docs_1.textoDaSincronizacao)(r, escrever)}`);
         return 0;
     }
     if (sub === 'init') {
@@ -2540,7 +2881,7 @@ function comandoDocs(args) {
                 'Proximo passo: copie docs/produto/_modelo-feature.md e docs/roadmap/_modelo-item.md, e rode ork docs verificar'].join('\n'));
         return 0;
     }
-    console.error(`uso: ork docs verificar [--json] | sincronizar [--escrever] | init`);
+    console.error(`uso: ork docs verificar [--json] | sincronizar [--escrever] [--so RM-NNN] [--todos] | init`);
     return 2;
 }
 function comandoPrompt(args) {
@@ -2645,7 +2986,7 @@ function comandoAdapter(args) {
         }
         const carregado = (0, manifest_1.carregarManifesto)();
         const r = (0, hosts_1.instalarAdaptador)(host, {
-            projeto: carregado?.raiz ?? process.cwd(),
+            projeto: carregado?.raiz ?? (0, manifest_1.diretorioDoProjeto)(),
             dir: texto(args.opcoes.dir),
             dryRun: args.opcoes['dry-run'] === true,
             force: args.opcoes.force === true || args.opcoes.forcar === true,
@@ -2669,7 +3010,7 @@ function comandoAdapter(args) {
  * de zero em qualquer falha, para o CI do kit poder barrar merge sem eval.
  */
 function comandoEval(args) {
-    const catalogo = (0, catalogo_1.exigirCatalogo)((0, manifest_1.carregarManifesto)()?.raiz ?? process.cwd());
+    const catalogo = (0, catalogo_1.exigirCatalogo)((0, manifest_1.carregarManifesto)()?.raiz ?? (0, manifest_1.diretorioDoProjeto)());
     const lista = (v) => {
         const t = texto(v);
         return t ? t.split(',').map((x) => x.trim()).filter(Boolean) : undefined;
@@ -3161,7 +3502,12 @@ function comandoMemory(args) {
     if (sub === 'sync' && args.posicionais[2])
         (0, escopo_escrita_1.validarDiretorioDeThread)(carregado.raiz, args.posicionais[2]);
     if (sub === 'status') {
-        const memoria = (0, memoria_1.abrirMemoria)(candidate);
+        const memoria = (0, memoria_1.abrirMemoria)(candidate, { embeddings: 'detalhado' });
+        // I-38 (D7): --sondar faz UMA chamada real pelo caminho ativo e mede a latencia.
+        if (args.opcoes.sondar === true && memoria.ativo && memoria.estado.embeddings) {
+            const driver = new orkmind_1.DriverCliOrkMind((0, orkmind_1.configDoManifesto)(carregado.manifesto));
+            memoria.estado.embeddings.sonda = (0, memoria_1.sondarEmbeddings)(carregado.manifesto, memoria.estado.embeddings, (p, o) => driver.embeddar(p, o), (0, orkmind_1.configDoManifesto)(carregado.manifesto).timeoutMs);
+        }
         if (args.opcoes.json === true) {
             console.log(JSON.stringify({ ...memoria.estado, configSource: memoria.configSource, configDivergent: memoria.configDivergent }, null, 2));
             return 0;
@@ -3207,6 +3553,8 @@ function comandoMemory(args) {
         }
         return r.estado.pedido === 'orkmind' && r.falhas > 0 ? 1 : 0;
     }
+    if (sub === 'search' && args.opcoes.texto !== undefined)
+        return buscaPorTexto(args, carregado);
     if (sub === 'search') {
         const threadId = texto(args.opcoes.thread);
         if ((args.opcoes.restrito !== undefined || args.opcoes.thread !== undefined ||
@@ -3261,15 +3609,175 @@ function comandoMemory(args) {
         console.log(`  ${entradas.length} entrada(s)`);
         return 0;
     }
+    if (sub === 'index') {
+        const modelo = texto(args.opcoes.modelo) ?? 'primario';
+        if (!['primario', 'fallback', 'todos'].includes(modelo)) {
+            console.error('uso: ork memory index [--modelo primario|fallback|todos] [--dry-run] [--json]');
+            return 2;
+        }
+        const memoria = (0, memoria_1.abrirMemoria)(carregado);
+        if (!memoria.ativo) {
+            const falha = { motivo: memoria.estado.motivo, detalhe: memoria.estado.detalhe, correcao: memoria.estado.correcao };
+            if (args.opcoes.json === true)
+                console.log(JSON.stringify(falha, null, 2));
+            else
+                console.error(`memory.index: regime ${memoria.regime} (${memoria.estado.motivo}); ${memoria.estado.correcao}`);
+            return 1;
+        }
+        const config = (0, manifest_1.configDeEmbedding)(carregado.manifesto);
+        const driver = (0, orkmind_1.configDoManifesto)(carregado.manifesto);
+        const embedder = new orkmind_1.DriverCliOrkMind(driver);
+        const universo = (0, indice_vetorial_1.universoDoTenant)(memoria, memoria.estado.tenant);
+        const alvos = modelo === 'todos' ? ['primario', 'fallback'] : [modelo];
+        const resultados = alvos.map(alvo => (0, indice_vetorial_1.indexar)({ raiz: carregado.raiz, tenant: memoria.estado.tenant,
+            dsn: driver.dsn, config, alvo, universo, dryRun: args.opcoes['dry-run'] === true,
+            chavePresente: !!config.api_key_env && (0, orkmind_1.chaveDeEmbeddingAceita)((process.env[config.api_key_env] ?? '').trim(), driver.dsn),
+            chaveRecusada: !!config.api_key_env && (process.env[config.api_key_env] ?? '').trim() !== '' &&
+                !(0, orkmind_1.chaveDeEmbeddingAceita)((process.env[config.api_key_env] ?? '').trim(), driver.dsn),
+            embeddar: (p, o) => embedder.embeddar(p, o) }));
+        if (args.opcoes.json === true) {
+            console.log(JSON.stringify(modelo === 'todos' ? { alvo: 'todos', resultados } : resultados[0], null, 2));
+        }
+        else {
+            for (const r of resultados)
+                console.log(textoDoIndice(r));
+        }
+        return resultados.some(r => !r.dryRun && r.motivo) ? 1 : 0;
+    }
     console.error(`subcomando desconhecido: memory ${sub}`);
     return 2;
 }
-function main(argv) {
-    // I-35: todo horário para pessoa sai no fuso do dono deste projeto (lido só se for preciso).
+/** Aviso informativo: não consulta rede, não reserva e não bloqueia criação. */
+function avisoRoadmapSemAssociacao(nome, roadmap) {
+    const item = /\bRM-\d{3}\b/i.exec(nome)?.[0].toUpperCase();
+    if (!item || roadmap)
+        return null;
+    return `Aviso: ${item} no nome não associa a thread ao roadmap. No terminal, consulte ork roadmap reservas e ork fabrica; para associar e reservar, use --roadmap ${item} em ork thread new. Nenhuma reserva foi criada por este aviso.`;
+}
+/**
+ * `ork memory search --texto` (I-38 D7): busca por significado, separada da busca por tag.
+ * Nao combina com --tags nem com a leitura restrita por thread nesta versao (erro tipado).
+ */
+function buscaPorTexto(args, carregado) {
+    const frase = texto(args.opcoes.texto);
+    if (args.opcoes.tags !== undefined || args.opcoes.thread !== undefined || args.opcoes.restrito !== undefined ||
+        args.opcoes.janela !== undefined) {
+        console.error('memory.search.texto-exclusivo: --texto nao combina com --tags, --thread, --restrito nem --janela');
+        return 2;
+    }
+    const modo = (texto(args.opcoes.modo) ?? 'hibrido');
+    const colecao = texto(args.opcoes.colecao) ?? texto(args.opcoes.collection);
+    const limiteBruto = texto(args.opcoes.limite);
+    const limite = limiteBruto === undefined ? busca_semantica_1.LIMITE_PADRAO_DA_BUSCA : Number(limiteBruto);
+    if (!(0, orkmind_1.textoDeBuscaValido)(frase) || !busca_semantica_1.MODOS_DE_BUSCA.includes(modo) ||
+        (colecao !== undefined && !orkmind_1.COLECOES_DO_ORK.includes(colecao)) ||
+        !Number.isInteger(limite) || limite < 1 || limite > busca_semantica_1.LIMITE_MAXIMO_DA_BUSCA) {
+        console.error(`uso: ork memory search --texto "<frase>" [--modo ${busca_semantica_1.MODOS_DE_BUSCA.join('|')}] [--colecao ${orkmind_1.COLECOES_DO_ORK.join('|')}] [--limite 1..${busca_semantica_1.LIMITE_MAXIMO_DA_BUSCA}] [--json]`);
+        return 2;
+    }
+    const memoria = (0, memoria_1.abrirMemoria)(carregado);
+    const config = (0, manifest_1.configDeEmbedding)(carregado.manifesto);
+    let r;
+    if (!memoria.ativo) {
+        r = { texto: frase, modo, origem: 'nenhum', modeloUsado: null, deterministico: false, motivo: memoria.estado.motivo,
+            detalhe: `${memoria.estado.detalhe}; correcao: ${memoria.estado.correcao}`, resultados: [], listas: { vetor: [], fts: [] } };
+    }
+    else {
+        const driver = (0, orkmind_1.configDoManifesto)(carregado.manifesto);
+        const transporte = new orkmind_1.DriverCliOrkMind(driver);
+        const fallback = memoria.estado.embeddings?.fallback;
+        r = (0, busca_semantica_1.buscarPorSignificado)({ raiz: carregado.raiz, tenant: memoria.estado.tenant, dsn: driver.dsn, config,
+            universo: (0, indice_vetorial_1.universoDoTenant)(memoria, memoria.estado.tenant, colecao ? [colecao] : orkmind_1.COLECOES_DO_ORK),
+            texto: frase, modo, limite, timeoutMs: driver.timeoutMs,
+            chavePresente: memoria.estado.embeddings?.chavePresente === true,
+            fallbackUsavel: memoria.estado.embeddings?.sondado === true && fallback?.dependencias === true,
+            embeddar: (p, o) => transporte.embeddar(p, o), buscarTexto: (t, q) => transporte.buscarTexto(t, q) });
+    }
+    if (args.opcoes.json === true) {
+        console.log(JSON.stringify(r, null, 2));
+        return 0;
+    }
+    console.log(`Busca por significado (NAO deterministica; modo ${r.modo}, origem ${r.origem}${r.modeloUsado ? ` ${r.modeloUsado}` : ''})`);
+    if (r.motivo)
+        console.log(`  motivo: ${r.motivo}${r.detalhe ? `; ${r.detalhe}` : ''}`);
+    console.log('');
+    r.resultados.forEach((e, i) => {
+        const sim = e.similaridade === null ? '' : `  similaridade ${e.similaridade}`;
+        console.log(`  ${i + 1}. [${e.collection}] ${e.id}  score ${e.score}  ${e.fontes.join('+')}${sim}`);
+        console.log(`      ${e.resumo}`);
+    });
+    console.log('');
+    console.log(`  ${r.resultados.length} resultado(s); busca por tag continua em ork memory search --tags`);
+    return 0;
+}
+/** Texto de `ork memory index`: o que foi (ou seria) embedado e quanto custa estimado. */
+function textoDoIndice(r) {
+    const custo = r.custoEstimadoUsd === null ? 'nao estimado' : `US$ ${r.custoEstimadoUsd.toFixed(8)}`;
+    return [
+        `Indice vetorial (${r.alvo}${r.dryRun ? ', --dry-run' : ''}): ${r.modelo ?? '(sem modelo)'}${r.dim ? ` / ${r.dim} dim` : ''}`,
+        `  universo do tenant   ${r.universo} entrada(s); coerentes ${r.coerentes}`,
+        `  embedados            ${r.embedados} (reescritos ${r.reescritos}); removidos ${r.removidos}`,
+        `  fora do indice       ${r.recusados} recusada(s) por padrao de segredo, ${r.foraDoLimite} acima do limite`,
+        ...(r.truncados ? [`  truncados            ${r.truncados} acima do contexto do modelo local, embedados pelo comeco`] : []),
+        `  estimativa           ${r.tokensEstimados} token(s), ${custo}; chamadas ao provider ${r.chamadasAoProvider}`,
+        ...(r.arquivo ? [`  arquivo              ${r.arquivo}`] : []),
+        ...(r.motivo ? [`  motivo               ${r.motivo}: ${r.detalhe}`] : r.detalhe ? [`  ${r.detalhe}`] : []),
+    ].join('\n');
+}
+/**
+ * RM-052: `--projeto <nome|caminho>` e opcao GLOBAL. Sai do argv em qualquer posicao, antes de
+ * qualquer despacho (inclusive do `maestro`, que tem parse proprio), e so aparece uma vez.
+ */
+function extrairOpcaoDeProjeto(argv) {
+    const resto = [];
+    let projeto;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a !== '--projeto' && !a.startsWith('--projeto=')) {
+            resto.push(a);
+            continue;
+        }
+        if (projeto !== undefined)
+            throw new Error('uso: --projeto <nome|caminho> aparece uma vez só');
+        if (a !== '--projeto') {
+            projeto = a.slice('--projeto='.length);
+            continue;
+        }
+        const valor = argv[i + 1];
+        projeto = valor !== undefined && !valor.startsWith('--') ? valor : '';
+        if (projeto)
+            i++;
+    }
+    return { argv: resto, projeto };
+}
+/** Comandos que nao leem projeto: o alvo nao e resolvido (nem recusado) para eles. */
+const COMANDOS_SEM_PROJETO = new Set(['demo', 'ciclos', 'mcp', 'init', 'projetos']);
+/**
+ * Comandos cujo `--projeto` e DELES (RM-054: `ork network roadmap --projeto github:dono/repo`, que
+ * le varios projetos). A opcao volta intacta ao argv do subcomando e o alvo global nao e resolvido:
+ * nem `--projeto`, nem `ORK_PROJETO`, nem o modo host escolhem um projeto por eles.
+ */
+exports.COMANDOS_COM_PROJETO_PROPRIO = new Set(['network']);
+/** Resolve e fixa o projeto-alvo do processo (D2, D3). `null`: vale o cwd de sempre. */
+function fixarAlvoDoProcesso(projeto) {
+    const alvo = (0, projeto_alvo_1.resolverProjetoAlvo)({ opcao: projeto ?? null });
+    (0, projeto_alvo_1.fixarProjetoAlvo)(alvo);
+    return alvo;
+}
+function main(argvBruto) {
+    // I-35: todo horário para pessoa sai no fuso do dono deste projeto (lido só se for preciso, e já
+    // depois de o projeto-alvo abaixo estar fixado: a fonte é preguiçosa).
     (0, horario_1.registrarFonteDoFuso)(() => (0, horario_1.fusoDoManifesto)((0, manifest_1.carregarManifesto)()));
+    // RM-052: sem alvo herdado de uma chamada anterior no mesmo processo (os testes chamam `main` em serie).
+    (0, projeto_alvo_1.fixarProjetoAlvo)(null);
+    const extraida = extrairOpcaoDeProjeto(argvBruto);
+    const proprio = exports.COMANDOS_COM_PROJETO_PROPRIO.has(parseArgs(extraida.argv).posicionais[0] ?? '');
+    const argv = proprio && extraida.projeto !== undefined
+        ? [...extraida.argv, ...(extraida.projeto ? ['--projeto', extraida.projeto] : ['--projeto'])] : extraida.argv;
+    const projeto = proprio ? undefined : extraida.projeto;
     // Helper fixo do host confiável: o projeto vem da instalação, nunca de toolargs.
     if (argv[0] === 'receipt-verifiers') {
-        if (argv.length !== 2 || argv[1] !== '--json')
+        if (argv.length !== 2 || argv[1] !== '--json' || projeto !== undefined)
             throw Error('uso: ork receipt-verifiers --json');
         const root = process.env.ORK_HITL_ROOT;
         const privateKey = Object.keys(process.env).some(name => /^ORK_HITL_(?:INGRESS_KEY|NATIVE_KEY)/.test(name));
@@ -3285,8 +3793,14 @@ function main(argv) {
         console.log((0, hitl_public_receipt_1.publicHitlVerifiers)() ?? 'null');
         return 0;
     }
-    if (argv[0] === 'maestro')
-        return (0, maestro_cli_1.runMaestroCli)(argv.slice(1));
+    if (argv[0] === 'maestro') {
+        if (argv.length === 2 && argv[1] === '--help')
+            return (0, maestro_cli_1.runMaestroCli)(argv.slice(1));
+        // RM-052: o alvo explicito vira SELECAO entre as raizes permitidas; sem ele, o cwd de sempre.
+        const alvo = fixarAlvoDoProcesso(projeto);
+        return alvo ? (0, maestro_cli_1.runMaestroCli)(argv.slice(1), alvo.raiz, { allowedRoots: [alvo.raiz], selected: alvo.raiz })
+            : (0, maestro_cli_1.runMaestroCli)(argv.slice(1));
+    }
     const args = parseArgs(argv);
     const comando = args.posicionais[0];
     // `ork --version` tambem chega sem comando: a versao e conferida antes da ajuda.
@@ -3298,6 +3812,14 @@ function main(argv) {
         console.log(AJUDA);
         return 0;
     }
+    if (!COMANDOS_SEM_PROJETO.has(comando) && !proprio)
+        fixarAlvoDoProcesso(projeto);
+    else if (projeto !== undefined && comando !== 'projetos') {
+        throw new Error(comando === 'init'
+            ? 'uso: ork init cria o projeto no diretório atual; entre nele e rode ork init, sem --projeto'
+            : comando === 'mcp' ? 'uso: o servidor MCP recebe a raiz por --project <raiz absoluta>, não por --projeto'
+                : `uso: ork ${comando} não lê projeto; tire --projeto`);
+    }
     const nomesHerdados = (0, runtime_ambiente_1.nomesDeProviderAtivos)();
     const ambienteManifesto = (0, manifest_1.carregarManifesto)();
     if (ambienteManifesto?.manifesto.runtime.provider_policy === 'subscription-only') {
@@ -3347,11 +3869,11 @@ function main(argv) {
                 if (args.posicionais.length !== 1 || !bruto ||
                     Object.keys(args.opcoes).some(k => k !== 'modo') || argv.filter(a => a === '--modo' || a.startsWith('--modo=')).length !== 1)
                     throw Error(`uso: ork doctor --modo ${modos_1.ORDEM_DOS_MODOS.join('|')}`);
-                const r = (0, preflight_1.preflight)(process.cwd(), (0, modos_1.exigirModoVivo)(bruto), nomesHerdados);
+                const r = (0, preflight_1.preflight)((0, manifest_1.diretorioDoProjeto)(), (0, modos_1.exigirModoVivo)(bruto), nomesHerdados);
                 console.log((0, preflight_1.textoPreflight)(r));
                 return r.prontoPrimeiroBloco ? 0 : 1;
             }
-            const r = (0, doctor_1.doctor)(process.cwd(), nomesHerdados);
+            const r = (0, doctor_1.doctor)((0, manifest_1.diretorioDoProjeto)(), nomesHerdados);
             console.log(r.texto);
             return r.codigo;
         }
@@ -3363,6 +3885,10 @@ function main(argv) {
             });
             const carregado = (0, manifest_1.exigirManifesto)(r.deteccao.raiz);
             const agents = (0, agents_md_1.atualizarAgentsMd)(r.deteccao.raiz, carregado.manifesto);
+            // RM-052 (D7): o projeto entra no registro desta maquina; falha vira aviso, nunca derruba o init.
+            const avisoDoRegistro = (0, projeto_alvo_1.registrarProjetoEmSilencio)(r.deteccao.raiz, 'init');
+            if (avisoDoRegistro)
+                console.error(avisoDoRegistro);
             if (!r.criado) {
                 console.log(`Manifesto ja existe: ${r.caminho}`);
                 console.log('Nada foi sobrescrito. Use --force para regerar.');
@@ -3430,6 +3956,30 @@ function main(argv) {
             return comandoAccounts(args);
         case 'onboarding':
             return comandoOnboarding(args);
+        case 'experiencia': {
+            if (args.posicionais[1] === 'uninstall') {
+                const host = (0, hosts_1.parseHost)(args.posicionais[2]);
+                if (!host || !['claude-code', 'codex'].includes(host) || args.posicionais.length !== 3 ||
+                    Object.keys(args.opcoes).some(k => !['dry-run', 'json'].includes(k)) ||
+                    Object.values(args.opcoes).some(v => v !== true))
+                    throw Error('uso: ork experiencia uninstall claude-code|codex [--dry-run] [--json]');
+                const r = (0, hosts_2.desinstalarExperiencia)((0, manifest_1.exigirManifesto)().raiz, host, args.opcoes['dry-run'] === true);
+                console.log(args.opcoes.json ? JSON.stringify(r, null, 2) :
+                    `${r.dryRun ? 'Simulação de remoção' : 'Remoção concluída'}: ${r.arquivos.length} arquivo(s). O adaptador permanece instalado. Para manter o pacote desativado, configure owner.experience:false no onboarding.`);
+                return 0;
+            }
+            if ((args.posicionais[1] ?? 'show') !== 'show' || args.posicionais.length > 2 ||
+                Object.keys(args.opcoes).some(k => k !== 'json') || ('json' in args.opcoes && args.opcoes.json !== true)) {
+                throw Error('uso: ork experiencia show [--json]');
+            }
+            const manifesto = (0, manifest_1.exigirManifesto)(), p = (0, experiencia_1.resolverExperiencia)(manifesto.manifesto.owner);
+            // Preferência inválida vale o padrão e faz o adapter install pular o pacote: a consulta avisa.
+            const avisos = manifesto.avisos.filter(a => a.startsWith('experiencia.config.invalid'));
+            console.log(args.opcoes.json ? JSON.stringify({ ...p, avisos }, null, 2) :
+                `Experiência ${p.experience ? 'ativa' : 'desativada'}: ${p.language}, ${p.timezone}, profundidade ${p.depth}.\nSkill: ${p.skill}\nOrigens: ${JSON.stringify(p.origem)}` +
+                    avisos.map(a => `\nAviso: ${a}; o adapter install pula o pacote até ork onboarding set maestro corrigir.`).join(''));
+            return 0;
+        }
         case 'thread':
             return comandoThread(args);
         case 'objective':
@@ -3494,6 +4044,11 @@ function main(argv) {
         }
         case 'memory':
             return comandoMemory(args);
+        case 'grafo': {
+            // RM-031 KG3 (D7): o argv cru depois do comando; o parser do grafo e estrito.
+            const carregado = (0, manifest_1.exigirManifesto)();
+            return (0, intelligence_graph_cli_1.executarGrafo)(argv.slice(argv.indexOf('grafo') + 1), { raiz: carregado.raiz, estado: (0, estado_thread_1.raizDoEstado)(carregado.raiz), repositorio: carregado.manifesto.project.name, escrever: (texto) => console.log(texto) });
+        }
         case 'ship':
             return comandoShip(args);
         case 'activation':
@@ -3530,6 +4085,10 @@ function main(argv) {
         }
         case 'fabrica':
             return comandoFabrica(args);
+        case 'projetos':
+            return comandoProjetos(args, projeto);
+        case 'network':
+            return comandoNetwork(args);
         case 'licoes':
             return comandoLicoes(args);
         case 'ciclos':
@@ -3551,6 +4110,11 @@ if (require.main === module) {
             console.log(process.argv.includes('--json') ? JSON.stringify(e.recusa, null, 2) : e.recusa.texto);
             process.exitCode = 3;
         }
+        else if (e instanceof projeto_alvo_1.ErroDeProjeto) {
+            // RM-052 (D3): a recusa de projeto-alvo e a resposta (a escolha, os candidatos), nao um stack trace.
+            console.log(process.argv.includes('--json') ? JSON.stringify(e.recusa, null, 2) : e.texto);
+            process.exitCode = projeto_alvo_1.SAIDA_DE_PROJETO;
+        }
         else {
             console.error(`erro: ${e.message}`);
             process.exitCode = 1;