@orkastery/cli 0.4.3 → 0.5.0

package/adapters/openclaw/dist/index.js

@@ -76,6 +76,9 @@ async function rodarOrk(args, signal, entrada) {
         env.ORK_RECEIPT_VERIFIERS = verifiers;
     // I-36 (D6): o adaptador declara o proprio canal de conducao. Descreve a porta, nao concede autoridade.
     env.ORK_CANAL = 'openclaw';
+    // RM-052 (D3): o cwd do gateway nao e projeto de ninguem. Sem `projeto` pedido, o nucleo usa o unico
+    // projeto conhecido da maquina ou devolve a escolha; nunca o manifesto que estiver no cwd do gateway.
+    env.ORK_PROJETO_EXPLICITO = '1';
     return new Promise((resolve) => {
         const filho = execFile(bin, args, { maxBuffer: MAX_BUFFER, signal, env }, (erro, stdout, stderr) => {
             const partes = [stdout, stderr].map((t) => (t ?? '').trim()).filter((t) => t !== '');
@@ -156,10 +159,36 @@ function argvDaResposta(p, alvo) {
     return [alvo, 'answer', thread, pedido, '--resposta-stdin', '--por', `telegram:${usuario}`,
         '--mensagem', `telegram:${chat}:${referencia}`, '--origem', 'telegram'];
 }
+/**
+ * RM-052 (D4): o projeto pedido chega como NOME de projeto registrado (`ork projetos`), nunca como
+ * caminho. O modelo escolhe entre os projetos da maquina; nao aponta o nucleo para um diretorio.
+ */
+const PADRAO_DO_PROJETO = /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$/;
+const PARAMETRO_PROJETO = {
+    type: 'string',
+    pattern: PADRAO_DO_PROJETO.source,
+    description: 'Nome do projeto que o dono pediu (ex.: orkastery), como em `ork projetos`. Sem ele e com mais de um projeto na máquina, a resposta é a escolha; nunca use o diretório do gateway.',
+};
+const PROJETO_DA_RM052 = {
+    padrao: PADRAO_DO_PROJETO,
+    descricao: PARAMETRO_PROJETO.description,
+    recusa: 'informe o NOME de um projeto de `ork projetos` (ex.: orkastery), nunca um caminho',
+};
+/**
+ * RM-054 (fatia 2, D-G4): no roadmap da rede, `projeto` tambem aceita a forja (`github:dono/repo`,
+ * `gitlab:grupo/repo`): numa maquina sem clone, e o unico caminho ate o projeto enquanto a rede por
+ * pessoa (RM-053) nao chega. Caminho e URL continuam fora (a URL pode levar credencial), e o nucleo
+ * confere de novo, porque o adaptador declara ORK_PROJETO_EXPLICITO=1.
+ */
+const PROJETO_DA_REDE = {
+    padrao: /^(?:[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}|(?:github|gitlab):[A-Za-z0-9][A-Za-z0-9._-]{0,99}(?:\/[A-Za-z0-9][A-Za-z0-9._-]{0,99}){1,8})$/,
+    descricao: 'Projeto que o dono pediu: o nome, como em `ork projetos` (ex.: orkastery), ou a forja (github:dono/repo, gitlab:grupo/repo) quando não há clone nesta máquina. Sem ele, vêm todos os projetos conhecidos. Nunca caminho nem URL.',
+    recusa: 'informe o NOME de um projeto de `ork projetos` (ex.: orkastery) ou github:dono/repo, nunca caminho nem URL',
+};
 const FERRAMENTAS = [
     {
         name: 'ork_maestro',
-        description: 'Ao receber a frase exata orkastery maestro, consulte o panorama somente leitura. Não cria thread. Apresente fontes, lacunas e HITL com recomendação e opções claras; horários para o dono vêm dos campos *Local (fuso do dono), nunca do ISO. Ação posterior exige operação autorizada e readback.',
+        description: 'Ao receber a frase exata orkastery maestro: sem projeto nomeado, chame ork_network_roadmap sem projeto (o panorama da rede, com fontes, frescor e lacunas) e apresente-o como vem; com projeto nomeado, consulte este panorama somente leitura com projeto. Não cria thread. Apresente fontes, lacunas e HITL com recomendação e opções claras; horários para o dono vêm dos campos *Local (fuso do dono), nunca do ISO. O panorama NÃO lê o roadmap, as reservas nem as outras máquinas (veja notConsulted): zero threads nunca é roadmap vazio; para o roadmap use ork_network_roadmap. Ação posterior exige operação autorizada e readback.',
         parameters: { type: 'object', additionalProperties: false, properties: {
                 thread: { type: 'string' }, section: { type: 'string', enum: ['portfolio', 'demands', 'threads', 'sessions', 'blockers', 'leases', 'retries', 'hitl', 'ship', 'master', 'nextActions'] },
                 offset: { type: 'integer', minimum: 0, maximum: 100000 },
@@ -281,6 +310,27 @@ const FERRAMENTAS = [
         parameters: schema({ thread: { type: 'string' }, id: { type: 'string' } }),
         argv: (p) => ['brain', 'get', texto(p, 'id'), '--thread', texto(p, 'thread')],
     },
+    {
+        name: 'ork_brain_context',
+        description: 'Pacote de contexto citável do Company Brain: entidades pedidas e seus pais, cada uma com a citação da fonte, o frescor contra o portfólio e as lacunas. Só leitura.',
+        parameters: schema({
+            thread: { type: 'string' },
+            ids: { type: 'string', description: 'ids do portfólio separados por vírgula (prod-, proj-, init-)' },
+        }),
+        argv: (p) => ['brain', 'context', '--thread', texto(p, 'thread'), '--ids', texto(p, 'ids')],
+    },
+    {
+        name: 'ork_brain_dossie',
+        description: 'Dossiê de decisão da thread: vínculo com objetivo e projeto, contexto citável, alternativas, decisão, quem decidiu e evidência, com os ids do Company Brain e as lacunas. Resposta do dono só com recibo conferido. Só leitura.',
+        parameters: {
+            type: 'object', additionalProperties: false, required: ['thread'],
+            properties: {
+                thread: { type: 'string' },
+                decisao: { type: 'string', description: 'id do pedido ou fact- da decisão; omita para a thread inteira' },
+            },
+        },
+        argv: (p) => ['brain', 'dossie', '--thread', texto(p, 'thread'), ...(p.decisao === undefined ? [] : ['--decisao', texto(p, 'decisao')])],
+    },
     {
         name: 'ork_claims_add',
         description: 'Registra uma alegacao verificavel com o comando que a comprova. Toda citacao de arquivo ou teste vira claim.',
@@ -358,30 +408,32 @@ const FERRAMENTAS = [
     },
     {
         name: 'ork_master',
-        description: 'Fecha a thread: POSTMORTEM tipado, MASTER log no contrato congelado e o score HUMANO de 0 a 5 com justificativa. Nunca invente a nota.',
+        description: 'Pede ao dono a nota do MASTER (0 a 5, com o porque) de uma entrega: devolve a linha com o codigo curto para mostrar a ele. A nota volta pelo Telegram, com a prova do ingresso. Esta tool nunca grava nota e nao recebe nome de pessoa (RM-048).',
         parameters: schema({
             thread: { type: 'string' },
-            score: { type: 'string', description: 'inteiro de 0 a 5, dado pelo humano' },
-            justificativa: { type: 'string' },
-            quem: { type: 'string' },
         }),
-        argv: (p) => [
-            'master',
-            texto(p, 'thread'),
-            '--score',
-            texto(p, 'score'),
-            '--justificativa',
-            texto(p, 'justificativa'),
-            '--por',
-            texto(p, 'quem'),
-        ],
+        argv: (p) => ['master', 'pedir', texto(p, 'thread'), '--formato', 'telegram'],
     },
     {
         name: 'ork_board',
-        description: 'Todas as threads em uma visao, e o escalonador dizendo quem avanca agora e quem espera.',
+        description: 'As threads DESTE projeto nesta maquina e o escalonador dizendo quem avanca agora e quem espera. NAO le o roadmap: nunca conclua sobre o roadmap a partir do board (zero threads nao e roadmap vazio); para o roadmap use ork_network_roadmap. O cabecalho diz o projeto consultado e o que nao foi lido.',
         parameters: schema({}),
         argv: () => ['board', 'plan'],
     },
+    {
+        name: 'ork_roadmap_status',
+        description: 'Status report do roadmap SO desta maquina (o checkout local), no formato aprovado pelo dono (grupos com icones, #HITL e o fecho): nao le as reservas nem as outras maquinas, e o cabecalho diz isso. Para o status do roadmap com as threads de todas as maquinas, as reservas, as fontes e as lacunas, use ork_network_roadmap. Somente leitura: transporte o texto como vem, sem reescrever. Passe projeto com o nome que o dono pediu (ex.: orkastery); sem ele e com mais de um projeto na maquina, a resposta e a escolha. Nunca deduza o roadmap de ork_board ou ork_maestro.',
+        parameters: schema({}),
+        argv: () => ['roadmap', 'status'],
+    },
+    {
+        name: 'ork_network_roadmap',
+        description: 'Roadmap da rede, somente leitura: para cada projeto, o status report do roadmap (RM-048) com as threads de TODAS as máquinas, as reservas, as threads por máquina com a idade da batida, a fonte e a hora de cada parte e as lacunas. É a fonte para qualquer pergunta sobre o roadmap ou o status report: transporte o texto como vem, sem reescrever nem resumir. Passe projeto com o nome que o dono pediu (ex.: orkastery) ou github:dono/repo; sem projeto, vêm todos os projetos conhecidos, e esse é o panorama da frase orkastery maestro sem projeto. Lacuna, "não lido" e "Não consultado" são fontes que ficaram sem leitura: nunca conclua "roadmap vazio" nem "nenhuma máquina publicou" a partir delas.',
+        parameters: schema({}),
+        projeto: PROJETO_DA_REDE,
+        // RM-054 (fatia 2): uma chamada de CLI; o `--projeto` vai no inicio e o nucleo o devolve ao `network`.
+        argv: () => ['network', 'roadmap'],
+    },
     {
         name: 'ork_master_batch',
         description: 'Todas as entregas em JSON, com o indice derivado do ledger, as ja pontuadas e as aceitas por omissao. Roda ork master --todas; o nome e da antiga fila de score (ork master --batch), aposentada na I-43.',
@@ -389,21 +441,41 @@ const FERRAMENTAS = [
         argv: () => ['master', '--todas', '--json'],
     },
 ];
+/** RM-052: toda tool aceita `projeto` opcional, sem mudar o que ela ja exigia. */
+function comProjeto(f) {
+    const propriedades = (f.parameters.properties ?? {});
+    const p = f.projeto;
+    const projeto = p ? { type: 'string', pattern: p.padrao.source, description: p.descricao } : PARAMETRO_PROJETO;
+    return { ...f.parameters, properties: { ...propriedades, projeto } };
+}
+/** `--projeto <nome>` vai no inicio do argv; o resto dos parametros segue para a tool como antes. */
+function argvComProjeto(f, params) {
+    const { projeto, ...resto } = params;
+    if (projeto !== undefined && (typeof projeto !== 'string' || !(f.projeto ?? PROJETO_DA_RM052).padrao.test(projeto))) {
+        throw new Error('projeto.invalido');
+    }
+    return { argv: [...(projeto === undefined ? [] : ['--projeto', projeto]), ...f.argv(resto)], resto };
+}
 const plugin = defineToolPlugin({
     id: 'orkastery',
     name: 'Orkastery',
-    description: 'Conducao de looping threads em 6 fases pelo nucleo `ork`, exposta ao OpenClaw como tools `ork_*`. Zero regra de negocio no host: cada tool e uma chamada de CLI.',
+    description: 'Conducao de looping threads em 6 fases pelo nucleo `ork`, exposta ao OpenClaw como tools `ork_*`. Zero regra de negocio no host: cada tool e uma chamada de CLI. Toda tool aceita projeto (nome do projeto pedido); o cwd do gateway nunca escolhe o projeto. O status do roadmap vem de ork_network_roadmap.',
     tools: (tool) => FERRAMENTAS.map((f) => tool({
         name: f.name,
         description: f.description,
-        parameters: f.parameters,
+        parameters: comProjeto(f),
         execute: (params, _config, contexto) => {
+            let chamada;
             try {
-                return rodarOrk(f.argv(params), contexto.signal, f.entrada?.(params));
+                chamada = argvComProjeto(f, params);
             }
-            catch {
+            catch (e) {
+                if (e.message === 'projeto.invalido') {
+                    return `[ork recusou] projeto.invalido: ${(f.projeto ?? PROJETO_DA_RM052).recusa}`;
+                }
                 return '[ork recusou] resposta humana não confirmada; confira origem e correlação do pedido';
             }
+            return rodarOrk(chamada.argv, contexto.signal, f.entrada?.(chamada.resto));
         },
     })),
 });

package/adapters/openclaw/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "orkastery",
   "name": "Orkastery",
   "description": "Conducao de looping threads em 6 fases pelo nucleo `ork`, exposta ao OpenClaw como tools `ork_*`. Zero regra de negocio no host: cada tool e uma chamada de CLI.",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "configSchema": {
     "type": "object",
     "properties": {},
@@ -25,6 +25,8 @@
       "ork_brain_status",
       "ork_brain_query",
       "ork_brain_get",
+      "ork_brain_context",
+      "ork_brain_dossie",
       "ork_claims_add",
       "ork_verify",
       "ork_verify_baseline",
@@ -35,7 +37,14 @@
       "ork_ship",
       "ork_master",
       "ork_board",
+      "ork_roadmap_status",
+      "ork_network_roadmap",
       "ork_master_batch"
     ]
+  },
+  "toolMetadata": {
+    "ork_network_roadmap": {
+      "profiles": ["coding", "messaging"]
+    }
   }
 }

package/adapters/openclaw/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orkastery/openclaw-plugin",
-  "version": "0.4.3",
-  "description": "Plugin Orkastery para OpenClaw: 23 tools ork_* que traduzem intencao em chamada de CLI do nucleo `ork`. Zero regra de negocio no host.",
+  "version": "0.5.0",
+  "description": "Plugin Orkastery para OpenClaw: 27 tools ork_* que traduzem intencao em chamada de CLI do nucleo `ork`. Zero regra de negocio no host.",
   "type": "module",
   "private": true,
   "license": "MIT",

package/adapters/openclaw/src/hitl-ingress.ts

@@ -2,6 +2,8 @@
 /** D12: this host is the `openclaw` channel, and the channel is signed, not labelled. */
 import { createHash, createHmac } from 'node:crypto';
 import { execFile } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { isAbsolute, join } from 'node:path';
 
 interface NativeEvent {
   content: string; channel: string; commandAuthorized?: boolean; accountId?: string;
@@ -18,14 +20,41 @@ interface NativeApi { on: (name: 'inbound_claim', handler: (event: NativeEvent,
  * stay equal. The code starts with a letter and has a digit: ordinary chat never has this shape,
  * and it never reads as an answer to the batch, which starts with the question number.
  */
-const PULSE_CONSENT = new RegExp("^[ \\t]*(?=[A-HJKMNP-TV-Z][2-9A-HJKMNP-TV-Z]{0,2}[2-9])[A-HJKMNP-TV-Z][2-9A-HJKMNP-TV-Z]{3}[ \\t]+[^\\r\\n]{1,40}$", 'i');
+const PULSE_CONSENT = new RegExp("^[ \\t]*(?=[A-HJKMNP-TV-Z][2-9A-HJKMNP-TV-Z]{0,2}[2-9])[A-HJKMNP-TV-Z][2-9A-HJKMNP-TV-Z]{3}[ \\t]+[^\\r\\n]{1,200}$", 'i');
 const PULSE_LOTE = new RegExp("^[ \\t]*[0-9]{1,2}[ \\t]*[a-zA-Z](?:[ \\t,;]*[0-9]{1,2}[ \\t]*[a-zA-Z])*[ \\t]*[.!]?[ \\t]*$");
 /** I-50 (RM-039): the pulse cadence tag, alone in the message. It starts with '#', so it never reads as the other two. */
 const PULSE_CADENCIA = new RegExp("^[ \\t]*#OrkPulse(?:On(?:-(?:15|30|60)m)?|Off)[ \\t]*[.!]?[ \\t]*$", 'i');
 /** The pulse address inside the signed body: neither a thread nor a request. The core translates. */
 const PULSE_ALVO = 'pulse', PULSE_ENDERECO = 'resposta';
-export function isPulseAnswer(text: string): boolean {
-  return !text.includes('\0') && (PULSE_CONSENT.test(text) || PULSE_LOTE.test(text) || PULSE_CADENCIA.test(text));
+/**
+ * RM-048 (D2 and D3): the free-text shapes, generated in the core from the closed vocabulary. `lista`
+ * ("1. B, 2. aprovo") is always claimed; `livre` ("sim", "aprovo", "a") only while the core's
+ * listening window is open: outside it, the word goes to the assistant, as it always did. The
+ * window is a routing hint, not proof: the message still goes through the signature and the core rule.
+ */
+const PULSE_LISTA = new RegExp("^[ \\t]*[0-9]{1,2}(?:[ \\t]*[.):-])?[ \\t]*(?:[a-d]|pode seguir|pode ir|pode|sim|s|ok|aprovo|aprovado|aprovada|aprovar|aprova|segue|siga|seguir|manda|confirmo|confirmado|de acordo|agora n[aã]o|n[aã]o|n|recuso|recusado|recusar|reprovo|reprovado|revisar|revis[aã]o|refazer|volta|voltar|esperar|espera|aguardar|aguarda|aguarde|depois|mais tarde|detalhes?|evid[eê]ncias?)(?:[ \\t\\r\\n,;]*[0-9]{1,2}(?:[ \\t]*[.):-])?[ \\t]*(?:[a-d]|pode seguir|pode ir|pode|sim|s|ok|aprovo|aprovado|aprovada|aprovar|aprova|segue|siga|seguir|manda|confirmo|confirmado|de acordo|agora n[aã]o|n[aã]o|n|recuso|recusado|recusar|reprovo|reprovado|revisar|revis[aã]o|refazer|volta|voltar|esperar|espera|aguardar|aguarda|aguarde|depois|mais tarde|detalhes?|evid[eê]ncias?))*[ \\t]*(?:[.!][ \\t]*)?$", 'i');
+const PULSE_LIVRE = new RegExp("^[ \\t]*(?:[1-4]|(?:[a-d]|pode seguir|pode ir|pode|sim|s|ok|aprovo|aprovado|aprovada|aprovar|aprova|segue|siga|seguir|manda|confirmo|confirmado|de acordo|agora n[aã]o|n[aã]o|n|recuso|recusado|recusar|reprovo|reprovado|revisar|revis[aã]o|refazer|volta|voltar|esperar|espera|aguardar|aguarda|aguarde|depois|mais tarde|detalhes?|evid[eê]ncias?))[ \\t]*(?:[.!]+[ \\t]*)?$", 'i');
+/** RM-048 (item 8): the digest keyboard line goes to the core at the same signed address. */
+const PULSE_RATIFICACAO = new RegExp("^[ \\t]*ratificar(?:-lote)?(?:[ \\t]+[A-Za-z0-9._-]{1,80}){2,3}[ \\t]*$", 'i');
+/** Text above this is never tested against the shapes: they run before the allowlist. */
+const PULSE_TETO = 300, ESCUTA_TETO = 4096;
+
+/** The bare-word window (ork.pulse-escuta/v1), read with a byte cap; any error closes it. */
+export function listeningOpen(root: string | undefined, now = Date.now()): boolean {
+  try {
+    if (!root || !isAbsolute(root)) return false;
+    const raw = readFileSync(join(root, '.orkastery', 'monitor', 'pulse-escuta.json'));
+    if (raw.length > ESCUTA_TETO) return false;
+    const value = JSON.parse(raw.toString('utf8'));
+    return value?.contrato === 'ork.pulse-escuta/v1' && typeof value.livreAte === 'string' && Date.parse(value.livreAte) > now;
+  } catch { return false; }
+}
+
+export function isPulseAnswer(text: string, root: string | undefined = process.env.ORK_HITL_ROOT): boolean {
+  if (text.includes('\0') || text.length > PULSE_TETO) return false;
+  if (PULSE_CONSENT.test(text) || PULSE_LOTE.test(text) || PULSE_CADENCIA.test(text) || PULSE_LISTA.test(text) ||
+      PULSE_RATIFICACAO.test(text)) return true;
+  return PULSE_LIVRE.test(text) && listeningOpen(root);
 }
 
 export function registerHitlIngress(api: NativeApi, bin: string): void {

package/adapters/openclaw/src/index.ts

@@ -71,6 +71,9 @@ async function rodarOrk(args: string[], signal?: AbortSignal, entrada?: string):
   if (verifiers) env.ORK_RECEIPT_VERIFIERS = verifiers;
   // I-36 (D6): o adaptador declara o proprio canal de conducao. Descreve a porta, nao concede autoridade.
   env.ORK_CANAL = 'openclaw';
+  // RM-052 (D3): o cwd do gateway nao e projeto de ninguem. Sem `projeto` pedido, o nucleo usa o unico
+  // projeto conhecido da maquina ou devolve a escolha; nunca o manifesto que estiver no cwd do gateway.
+  env.ORK_PROJETO_EXPLICITO = '1';
   return new Promise((resolve) => {
     const filho = execFile(bin, args, { maxBuffer: MAX_BUFFER, signal, env }, (erro, stdout, stderr) => {
       const partes = [stdout, stderr].map((t) => (t ?? '').trim()).filter((t) => t !== '');
@@ -154,6 +157,38 @@ function argvDaResposta(p: Record<string, unknown>, alvo: 'gate' | 'sessions'):
     '--mensagem', `telegram:${chat}:${referencia}`, '--origem', 'telegram'];
 }
 
+/**
+ * RM-052 (D4): o projeto pedido chega como NOME de projeto registrado (`ork projetos`), nunca como
+ * caminho. O modelo escolhe entre os projetos da maquina; nao aponta o nucleo para um diretorio.
+ */
+const PADRAO_DO_PROJETO = /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$/;
+const PARAMETRO_PROJETO = {
+  type: 'string',
+  pattern: PADRAO_DO_PROJETO.source,
+  description: 'Nome do projeto que o dono pediu (ex.: orkastery), como em `ork projetos`. Sem ele e com mais de um projeto na máquina, a resposta é a escolha; nunca use o diretório do gateway.',
+};
+
+/** O `projeto` de uma tool: o padrao que o host confere, a descricao para o modelo e a recusa. */
+interface ProjetoDaTool { padrao: RegExp; descricao: string; recusa: string }
+
+const PROJETO_DA_RM052: ProjetoDaTool = {
+  padrao: PADRAO_DO_PROJETO,
+  descricao: PARAMETRO_PROJETO.description,
+  recusa: 'informe o NOME de um projeto de `ork projetos` (ex.: orkastery), nunca um caminho',
+};
+
+/**
+ * RM-054 (fatia 2, D-G4): no roadmap da rede, `projeto` tambem aceita a forja (`github:dono/repo`,
+ * `gitlab:grupo/repo`): numa maquina sem clone, e o unico caminho ate o projeto enquanto a rede por
+ * pessoa (RM-053) nao chega. Caminho e URL continuam fora (a URL pode levar credencial), e o nucleo
+ * confere de novo, porque o adaptador declara ORK_PROJETO_EXPLICITO=1.
+ */
+const PROJETO_DA_REDE: ProjetoDaTool = {
+  padrao: /^(?:[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}|(?:github|gitlab):[A-Za-z0-9][A-Za-z0-9._-]{0,99}(?:\/[A-Za-z0-9][A-Za-z0-9._-]{0,99}){1,8})$/,
+  descricao: 'Projeto que o dono pediu: o nome, como em `ork projetos` (ex.: orkastery), ou a forja (github:dono/repo, gitlab:grupo/repo) quando não há clone nesta máquina. Sem ele, vêm todos os projetos conhecidos. Nunca caminho nem URL.',
+  recusa: 'informe o NOME de um projeto de `ork projetos` (ex.: orkastery) ou github:dono/repo, nunca caminho nem URL',
+};
+
 /** Catálogo em paridade nome a nome com o manifesto; aprovação genérica legada aposentada. */
 interface FerramentaOrk {
   name: string;
@@ -161,12 +196,14 @@ interface FerramentaOrk {
   parameters: Record<string, unknown>;
   argv: (params: Record<string, unknown>) => string[];
   entrada?: (params: Record<string, unknown>) => string;
+  /** O `projeto` desta tool, quando nao e o da RM-052 (so nome). */
+  projeto?: ProjetoDaTool;
 }
 
 const FERRAMENTAS: FerramentaOrk[] = [
   {
     name: 'ork_maestro',
-    description: 'Ao receber a frase exata orkastery maestro, consulte o panorama somente leitura. Não cria thread. Apresente fontes, lacunas e HITL com recomendação e opções claras; horários para o dono vêm dos campos *Local (fuso do dono), nunca do ISO. Ação posterior exige operação autorizada e readback.',
+    description: 'Ao receber a frase exata orkastery maestro: sem projeto nomeado, chame ork_network_roadmap sem projeto (o panorama da rede, com fontes, frescor e lacunas) e apresente-o como vem; com projeto nomeado, consulte este panorama somente leitura com projeto. Não cria thread. Apresente fontes, lacunas e HITL com recomendação e opções claras; horários para o dono vêm dos campos *Local (fuso do dono), nunca do ISO. O panorama NÃO lê o roadmap, as reservas nem as outras máquinas (veja notConsulted): zero threads nunca é roadmap vazio; para o roadmap use ork_network_roadmap. Ação posterior exige operação autorizada e readback.',
     parameters: { type: 'object', additionalProperties: false, properties: {
       thread: { type: 'string' }, section: { type: 'string', enum: ['portfolio','demands','threads','sessions','blockers','leases','retries','hitl','ship','master','nextActions'] },
       offset: { type: 'integer', minimum: 0, maximum: 100000 },
@@ -292,6 +329,29 @@ const FERRAMENTAS: FerramentaOrk[] = [
     parameters: schema({ thread: { type: 'string' }, id: { type: 'string' } }),
     argv: (p) => ['brain', 'get', texto(p, 'id'), '--thread', texto(p, 'thread')],
   },
+  {
+    name: 'ork_brain_context',
+    description:
+      'Pacote de contexto citável do Company Brain: entidades pedidas e seus pais, cada uma com a citação da fonte, o frescor contra o portfólio e as lacunas. Só leitura.',
+    parameters: schema({
+      thread: { type: 'string' },
+      ids: { type: 'string', description: 'ids do portfólio separados por vírgula (prod-, proj-, init-)' },
+    }),
+    argv: (p) => ['brain', 'context', '--thread', texto(p, 'thread'), '--ids', texto(p, 'ids')],
+  },
+  {
+    name: 'ork_brain_dossie',
+    description:
+      'Dossiê de decisão da thread: vínculo com objetivo e projeto, contexto citável, alternativas, decisão, quem decidiu e evidência, com os ids do Company Brain e as lacunas. Resposta do dono só com recibo conferido. Só leitura.',
+    parameters: {
+      type: 'object', additionalProperties: false, required: ['thread'],
+      properties: {
+        thread: { type: 'string' },
+        decisao: { type: 'string', description: 'id do pedido ou fact- da decisão; omita para a thread inteira' },
+      },
+    },
+    argv: (p) => ['brain', 'dossie', '--thread', texto(p, 'thread'), ...(p.decisao === undefined ? [] : ['--decisao', texto(p, 'decisao')])],
+  },
   {
     name: 'ork_claims_add',
     description:
@@ -375,31 +435,35 @@ const FERRAMENTAS: FerramentaOrk[] = [
   {
     name: 'ork_master',
     description:
-      'Fecha a thread: POSTMORTEM tipado, MASTER log no contrato congelado e o score HUMANO de 0 a 5 com justificativa. Nunca invente a nota.',
+      'Pede ao dono a nota do MASTER (0 a 5, com o porque) de uma entrega: devolve a linha com o codigo curto para mostrar a ele. A nota volta pelo Telegram, com a prova do ingresso. Esta tool nunca grava nota e nao recebe nome de pessoa (RM-048).',
     parameters: schema({
       thread: { type: 'string' },
-      score: { type: 'string', description: 'inteiro de 0 a 5, dado pelo humano' },
-      justificativa: { type: 'string' },
-      quem: { type: 'string' },
     }),
-    argv: (p) => [
-      'master',
-      texto(p, 'thread'),
-      '--score',
-      texto(p, 'score'),
-      '--justificativa',
-      texto(p, 'justificativa'),
-      '--por',
-      texto(p, 'quem'),
-    ],
+    argv: (p) => ['master', 'pedir', texto(p, 'thread'), '--formato', 'telegram'],
   },
   {
     name: 'ork_board',
     description:
-      'Todas as threads em uma visao, e o escalonador dizendo quem avanca agora e quem espera.',
+      'As threads DESTE projeto nesta maquina e o escalonador dizendo quem avanca agora e quem espera. NAO le o roadmap: nunca conclua sobre o roadmap a partir do board (zero threads nao e roadmap vazio); para o roadmap use ork_network_roadmap. O cabecalho diz o projeto consultado e o que nao foi lido.',
     parameters: schema({}),
     argv: () => ['board', 'plan'],
   },
+  {
+    name: 'ork_roadmap_status',
+    description:
+      'Status report do roadmap SO desta maquina (o checkout local), no formato aprovado pelo dono (grupos com icones, #HITL e o fecho): nao le as reservas nem as outras maquinas, e o cabecalho diz isso. Para o status do roadmap com as threads de todas as maquinas, as reservas, as fontes e as lacunas, use ork_network_roadmap. Somente leitura: transporte o texto como vem, sem reescrever. Passe projeto com o nome que o dono pediu (ex.: orkastery); sem ele e com mais de um projeto na maquina, a resposta e a escolha. Nunca deduza o roadmap de ork_board ou ork_maestro.',
+    parameters: schema({}),
+    argv: () => ['roadmap', 'status'],
+  },
+  {
+    name: 'ork_network_roadmap',
+    description:
+      'Roadmap da rede, somente leitura: para cada projeto, o status report do roadmap (RM-048) com as threads de TODAS as máquinas, as reservas, as threads por máquina com a idade da batida, a fonte e a hora de cada parte e as lacunas. É a fonte para qualquer pergunta sobre o roadmap ou o status report: transporte o texto como vem, sem reescrever nem resumir. Passe projeto com o nome que o dono pediu (ex.: orkastery) ou github:dono/repo; sem projeto, vêm todos os projetos conhecidos, e esse é o panorama da frase orkastery maestro sem projeto. Lacuna, "não lido" e "Não consultado" são fontes que ficaram sem leitura: nunca conclua "roadmap vazio" nem "nenhuma máquina publicou" a partir delas.',
+    parameters: schema({}),
+    projeto: PROJETO_DA_REDE,
+    // RM-054 (fatia 2): uma chamada de CLI; o `--projeto` vai no inicio e o nucleo o devolve ao `network`.
+    argv: () => ['network', 'roadmap'],
+  },
   {
     name: 'ork_master_batch',
     description:
@@ -409,20 +473,44 @@ const FERRAMENTAS: FerramentaOrk[] = [
   },
 ];
 
+/** RM-052: toda tool aceita `projeto` opcional, sem mudar o que ela ja exigia. */
+function comProjeto(f: FerramentaOrk): Record<string, unknown> {
+  const propriedades = (f.parameters.properties ?? {}) as Record<string, unknown>;
+  const p = f.projeto;
+  const projeto = p ? { type: 'string', pattern: p.padrao.source, description: p.descricao } : PARAMETRO_PROJETO;
+  return { ...f.parameters, properties: { ...propriedades, projeto } };
+}
+
+/** `--projeto <nome>` vai no inicio do argv; o resto dos parametros segue para a tool como antes. */
+function argvComProjeto(f: FerramentaOrk, params: Record<string, unknown>): { argv: string[]; resto: Record<string, unknown> } {
+  const { projeto, ...resto } = params;
+  if (projeto !== undefined && (typeof projeto !== 'string' || !(f.projeto ?? PROJETO_DA_RM052).padrao.test(projeto))) {
+    throw new Error('projeto.invalido');
+  }
+  return { argv: [...(projeto === undefined ? [] : ['--projeto', projeto]), ...f.argv(resto)], resto };
+}
+
 const plugin = defineToolPlugin({
   id: 'orkastery',
   name: 'Orkastery',
   description:
-    'Conducao de looping threads em 6 fases pelo nucleo `ork`, exposta ao OpenClaw como tools `ork_*`. Zero regra de negocio no host: cada tool e uma chamada de CLI.',
+    'Conducao de looping threads em 6 fases pelo nucleo `ork`, exposta ao OpenClaw como tools `ork_*`. Zero regra de negocio no host: cada tool e uma chamada de CLI. Toda tool aceita projeto (nome do projeto pedido); o cwd do gateway nunca escolhe o projeto. O status do roadmap vem de ork_network_roadmap.',
   tools: (tool) =>
     FERRAMENTAS.map((f) =>
       tool({
         name: f.name,
         description: f.description,
-        parameters: f.parameters,
+        parameters: comProjeto(f),
         execute: (params, _config, contexto) => {
-          try { return rodarOrk(f.argv(params), contexto.signal, f.entrada?.(params)); }
-          catch { return '[ork recusou] resposta humana não confirmada; confira origem e correlação do pedido'; }
+          let chamada: ReturnType<typeof argvComProjeto>;
+          try { chamada = argvComProjeto(f, params); }
+          catch (e) {
+            if ((e as Error).message === 'projeto.invalido') {
+              return `[ork recusou] projeto.invalido: ${(f.projeto ?? PROJETO_DA_RM052).recusa}`;
+            }
+            return '[ork recusou] resposta humana não confirmada; confira origem e correlação do pedido';
+          }
+          return rodarOrk(chamada.argv, contexto.signal, f.entrada?.(chamada.resto));
         },
       })
     ),

package/assets/docs/padroes/documentacao-de-produto.md

@@ -16,7 +16,7 @@ O **roadmap** registra problemas, hipóteses, escolhas, prioridades e andamento
 
 | Regra | Aplicação |
 | --- | --- |
-| Identidade | Atribua IDs estáveis, por exemplo `PLAT-01`, `SYS-01`, `MOD-01`, `FEAT-042`, `UC-042-01`, `BR-042-01`, `API-01`, `EVT-01`, `JOB-01` e `RM-042`. Renomear não muda o ID. |
+| Identidade | Atribua IDs estáveis, por exemplo `PLAT-01`, `SYS-01`, `MOD-01`, `FEAT-042`, `UC-042-01`, `BR-042-01`, `API-01`, `EVT-01`, `JOB-01` e `RM-042`. Renomear não muda o ID. No Orkastery, o número da FEAT nova sai de `ork roadmap feat`, reservado entre máquinas; nunca do maior número da sua branch. |
 | Escopo e estado | Informe se a página descreve `vigente`, `em desenvolvimento`, `proposto` ou `descontinuado`, com ambiente, versão e data de verificação. |
 | Rastreabilidade | Ligue feature ↔ item de roadmap ↔ casos de uso/regras ↔ contratos/esquemas ↔ código/PR ↔ testes/evidências ↔ release. Use `Não aplicável — motivo` quando uma seção não fizer sentido. |
 | Fonte | Diferencie `confirmado` (código, contrato, teste ou decisão aprovada), `planejado` (item de roadmap) e `a validar`. Nunca complete uma lacuna por inferência silenciosa. |
@@ -75,7 +75,7 @@ Registre risco, perfis e matriz de permissões (RBAC/ABAC), autenticação/sess
 
 ## 4. Modelo de página de feature
 
-Copie [o modelo](../produto/_modelo-feature.md) para cada feature; substitua colchetes por valores ou por `Não aplicável — motivo`. O frontmatter é a camada que agentes e o verificador leem; o corpo é a camada que pessoas leem. Acrescente tabelas de campos e contratos quando houver vários elementos.
+Reserve o número com `ork roadmap feat --thread <thread>` e copie [o modelo](../produto/_modelo-feature.md) para cada feature; substitua colchetes por valores ou por `Não aplicável — motivo`. O frontmatter é a camada que agentes e o verificador leem; o corpo é a camada que pessoas leem. Acrescente tabelas de campos e contratos quando houver vários elementos.
 
 Chaves do frontmatter de uma feature:
 

package/assets/docs/padroes/roadmap-de-produto.md

@@ -80,7 +80,7 @@ Copie [o modelo](../roadmap/_modelo-item.md) para cada item. O frontmatter guard
 
 Revisite itens ativos na cadência do time e sempre após decisão, PR relevante, teste, deploy, alteração de flag ou medição de resultado. A cada revisão, compare roadmap, documentação da feature, código, contratos e evidências de produção; anote divergências com owner e prazo. Agentes podem sugerir atualização de status a partir de eventos do repositório, mas um PR mesclado atualiza somente a dimensão **código** até que deploy e exposição sejam comprovados. Registre a data de atualização e mantenha histórico das decisões e mudanças de escopo.
 
-No Orkastery, `ork docs sincronizar` é esse agente: ele atualiza `estado.codigo` e `evidencias.codigo.commit` a partir do ledger (`ship_done`) e do git, e a seção `sdlc` a partir da thread. **Ele nunca mexe em ciclo, documentação, deploy, exposição ou habilitação** — essas dimensões são decisão de pessoa, e o verificador só cobra que estejam coerentes com o código.
+No Orkastery, `ork docs sincronizar` é esse agente: ele atualiza `estado.codigo` e `evidencias.codigo.commit` a partir do ledger (`ship_done`) e do git, e a seção `sdlc` a partir da thread. **Ele nunca mexe em ciclo, documentação, deploy, exposição ou habilitação** — essas dimensões são decisão de pessoa, e o verificador só cobra que estejam coerentes com o código. Na worktree de uma thread, ele só toca o item dela e os índices, para que o PR de uma thread não mude o item de outra; `--so RM-NNN` escolhe os itens, e `--todos` (o padrão na raiz do projeto, onde o condutor sincroniza depois do merge) volta a todos.
 
 ## 6. Três leitores e fatos de SDLC (adaptação Orkastery)
 

package/assets/docs/produto/_modelo-feature.md

@@ -17,6 +17,8 @@ fontes:
   comandos: []
 ---
 
+<!-- O número da feature sai de `ork roadmap feat --thread <thread>`, reservado entre máquinas; nunca do maior número da branch. -->
+
 # FEAT-000 — Nome da feature
 
 > **Em uma frase:** [o que esta feature faz, para quem, em até 240 caracteres]