@orkastery/cli 0.4.2 → 0.5.0

package/dist/experiencia.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizarIdioma = normalizarIdioma;
+exports.validarPreferencias = validarPreferencias;
+exports.idiomaDoSistema = idiomaDoSistema;
+exports.resolverExperiencia = resolverExperiencia;
+/** Preferências públicas da experiência. Consulta não grava respostas nem autoria. */
+const horario_1 = require("./horario");
+function normalizarIdioma(valor) {
+    if (typeof valor !== 'string' || !valor.trim())
+        return undefined;
+    try {
+        return Intl.getCanonicalLocales(valor.trim())[0];
+    }
+    catch {
+        return undefined;
+    }
+}
+function validarPreferencias(valor) {
+    if (!valor || typeof valor !== 'object' || Array.isArray(valor))
+        throw Error('experiencia.config.invalid: owner deve ser um objeto');
+    const v = valor, resultado = {};
+    if (v.language !== undefined) {
+        const idioma = normalizarIdioma(v.language);
+        if (!idioma)
+            throw Error('experiencia.config.invalid: owner.language exige locale BCP-47');
+        resultado.language = idioma;
+    }
+    if (v.timezone !== undefined) {
+        const fuso = (0, horario_1.normalizarFuso)(v.timezone);
+        if (!fuso)
+            throw Error('experiencia.config.invalid: owner.timezone exige fuso IANA');
+        resultado.timezone = fuso;
+    }
+    if (v.depth !== undefined) {
+        if (v.depth !== 'curta' && v.depth !== 'detalhada')
+            throw Error('experiencia.config.invalid: owner.depth exige curta ou detalhada');
+        resultado.depth = v.depth;
+    }
+    if (v.experience !== undefined) {
+        if (typeof v.experience !== 'boolean')
+            throw Error('experiencia.config.invalid: owner.experience exige booleano');
+        resultado.experience = v.experience;
+    }
+    return resultado;
+}
+/** C, POSIX e und (raiz do ICU) dizem que o sistema não escolheu idioma: vale o padrão. */
+const SEM_IDIOMA = new Set(['c', 'posix', 'und']);
+function idiomaEscolhido(valor) {
+    const idioma = normalizarIdioma(valor);
+    return idioma && !SEM_IDIOMA.has(idioma.toLowerCase().split('-')[0]) ? idioma : undefined;
+}
+function idiomaDoSistema(env = process.env, doIntl = () => Intl.DateTimeFormat().resolvedOptions().locale) {
+    const locale = env.LC_ALL || env.LC_MESSAGES || env.LANG;
+    return idiomaEscolhido(locale?.split(/[.@]/)[0].replace(/_/g, '-')) ?? idiomaEscolhido(doIntl()) ?? 'en-US';
+}
+function resolverExperiencia(owner = {}, sistema = { language: idiomaDoSistema(), timezone: (0, horario_1.fusoDoSistema)() }) {
+    const p = validarPreferencias(owner);
+    const language = p.language ?? normalizarIdioma(sistema.language) ?? 'en-US';
+    return {
+        language, timezone: p.timezone ?? (0, horario_1.normalizarFuso)(sistema.timezone) ?? 'UTC',
+        depth: p.depth ?? 'curta', experience: p.experience ?? true,
+        skill: language.toLowerCase().startsWith('pt-') || language === 'pt'
+            ? 'orchestration-experience-pt-br' : 'orchestration-experience',
+        origem: {
+            language: p.language === undefined ? 'sistema' : 'manifesto',
+            timezone: p.timezone === undefined ? 'sistema' : 'manifesto',
+            depth: p.depth === undefined ? 'padrao' : 'manifesto',
+            experience: p.experience === undefined ? 'padrao' : 'manifesto',
+        },
+    };
+}

package/dist/fabrica-estado.js

@@ -33,11 +33,14 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PULSACAO_MS = exports.BRANCH_DA_FABRICA = exports.CONTRATO_MAQUINA = void 0;
+exports.PULSACAO_MS = exports.DIR_DA_FABRICA = exports.BRANCH_DA_FABRICA = exports.CONTRATO_MAQUINA = void 0;
+exports.despachoDaThread = despachoDaThread;
+exports.runtimeDaThread = runtimeDaThread;
 exports.arquivoDaMaquina = arquivoDaMaquina;
 exports.entregasNaBase = entregasNaBase;
 exports.retratoDaMaquina = retratoDaMaquina;
 exports.assinaturaDoRetrato = assinaturaDoRetrato;
+exports.estadoValido = estadoValido;
 exports.lerFabrica = lerFabrica;
 exports.publicarMaquina = publicarMaquina;
 exports.removerMaquina = removerMaquina;
@@ -70,14 +73,18 @@ const monitor_lock_1 = require("./monitor-lock");
 const board_1 = require("./board");
 const estado_thread_1 = require("./estado-thread");
 const horario_1 = require("./horario");
+const ledger_1 = require("./ledger");
 const modos_1 = require("./modos");
 const orquestracao_1 = require("./orquestracao");
 const roadmap_reservas_1 = require("./roadmap-reservas");
+const thread_1 = require("./thread");
 const util_1 = require("./util");
 const versao_1 = require("./versao");
 exports.CONTRATO_MAQUINA = 'ork.fabrica-maquina/v1';
 exports.BRANCH_DA_FABRICA = 'ork/fabrica-estado';
-const DIR = 'maquinas';
+/** O diretorio dos retratos na branch; a leitura sem clone (RM-054) le o mesmo. */
+exports.DIR_DA_FABRICA = 'maquinas';
+const DIR = exports.DIR_DA_FABRICA;
 const PAINEL = 'FABRICA.md';
 const PREFIXO = 'fabrica';
 const TENTATIVAS = 5;
@@ -85,6 +92,24 @@ const TENTATIVAS = 5;
 exports.PULSACAO_MS = 60 * 60 * 1000;
 const ARQUIVO_DA_MARCA = 'fabrica-publicada.json';
 const ARQUIVO_DO_LOG = 'fabrica.log';
+/** O trio do ultimo `phase_dispatch` do ledger da thread; tudo `null` quando nao ha despacho legivel. */
+function despachoDaThread(dir) {
+    let ultimo;
+    try {
+        ultimo = [...(0, ledger_1.lerLedger)(dir)].reverse().find((e) => e.tipo === ledger_1.TIPOS_DE_EVENTO.faseDespachada);
+    }
+    catch {
+        ultimo = undefined;
+    }
+    const campo = (v) => (typeof v === 'string' && v.trim() ? curto(v, 40) : null);
+    return { runtime: campo(ultimo?.runtime), modelo: campo(ultimo?.model), esforco: campo(ultimo?.effort) };
+}
+/** `claude-bg opus/xhigh`: o runtime com o modelo e o esforco, para as colunas do texto. */
+function runtimeDaThread(t) {
+    if (!t.runtime && !t.modelo)
+        return '-';
+    return [t.runtime ?? '?', [t.modelo, t.esforco].filter(Boolean).join('/')].filter(Boolean).join(' ');
+}
 const curto = (texto, teto = 120) => {
     const limpo = String(texto ?? '').replace(/\s+/g, ' ').trim();
     return limpo.length > teto ? `${limpo.slice(0, teto - 3)}...` : limpo;
@@ -101,7 +126,11 @@ function arquivoDaMaquina(maquina) {
  * entrega usa, o mesmo fato que o `ork docs sincronizar` le. Um `git log` so, para todas.
  */
 function entregasNaBase(raiz, base, remoto = 'origin') {
-    const ref = (0, branch_de_estado_1.git)(raiz, ['rev-parse', '--verify', '--quiet', `refs/remotes/${remoto}/${base}`]).ok ? `${remoto}/${base}` : base;
+    // A base vem do manifesto: a ref vai sempre qualificada (`refs/...`), e um valor como
+    // `--output=<arquivo>` nunca vira opcao do `git log`, em qualquer versao do git (RM-054, CHECK).
+    // Na ordem: a copia remota da base, a branch local, e a base escrita como remota (`origin/main`).
+    const candidatas = [`refs/remotes/${remoto}/${base}`, `refs/heads/${base}`, `refs/remotes/${base}`];
+    const ref = candidatas.find((c) => (0, branch_de_estado_1.git)(raiz, ['rev-parse', '--verify', '--quiet', c]).ok) ?? candidatas[1];
     // Regex basica do git: o `(` e literal.
     const r = (0, branch_de_estado_1.git)(raiz, ['log', ref, '--format=%h%x09%s', '--grep=^ship(']);
     const entregas = new Map();
@@ -125,7 +154,7 @@ function retratoDaMaquina(carregado, opcoes = {}) {
     const linhas = new Map(monitor.linhas.map((l) => [l.thread, l]));
     const entregas = entregasNaBase(raiz, carregado.manifesto.worktree.base_branch, remoto);
     const itemDaThread = new Map((0, roadmap_reservas_1.reservasLocais)(raiz, remoto).filter((r) => r.thread).map((r) => [r.thread, r.item]));
-    const threads = itens.map(({ thread: t }) => {
+    const threads = itens.map(({ thread: t, raiz: raizDoPerfil }) => {
         const pausa = linhas.get(t.id)?.pausas[0];
         const entregue = entregas.get(t.id) ?? null;
         const esperaVoce = !entregue && linhas.get(t.id)?.precisaDeHumano === true;
@@ -135,6 +164,7 @@ function retratoDaMaquina(carregado, opcoes = {}) {
             atualizadaEm: t.atualizadaEm ?? null, entregue,
             esperaVoce, pergunta: esperaVoce && pausa ? curto(pausa.pausaSobre || pausa.detalhe) : null,
             paradaDesde: esperaVoce && pausa ? pausa.desdeEm : null,
+            ...despachoDaThread((0, thread_1.dirThread)(raizDoPerfil, t.id)),
         };
     }).sort((a, b) => a.id.localeCompare(b.id));
     const eu = (0, roadmap_reservas_1.quemSouEu)(raiz, { por: opcoes.por, maquina: opcoes.maquina });
@@ -146,6 +176,7 @@ function assinaturaDoRetrato(e) {
     const { publicadoEm: _publicadoEm, ...resto } = e;
     return (0, node_crypto_1.createHash)('sha256').update(JSON.stringify(resto)).digest('hex');
 }
+/** O retrato so vale inteiro: e o filtro da leitura pelo clone e pela forja (RM-054). */
 function estadoValido(bruto) {
     const e = bruto;
     return !!e && e.contrato === exports.CONTRATO_MAQUINA && typeof e.maquina === 'string' && !!e.maquina.trim() &&
@@ -278,8 +309,8 @@ function blocoDaMaquina(m, eu) {
         `${vivas.length} thread(s) ativa(s)` + (entregues ? `, ${entregues} entregue(s) sem MASTER` : '');
     if (vivas.length === 0)
         return [cabeca];
-    return [cabeca, ...tabela(['THREAD', 'MODO', 'FASE', 'ITEM', 'ESPERA VOCE'], vivas.map((t) => [
-            t.id, t.modo, t.fase, t.roadmap ?? '-', t.esperaVoce ? `sim: ${curto(t.pergunta ?? 'veredito', 40)}` : '-',
+    return [cabeca, ...tabela(['THREAD', 'MODO', 'FASE', 'RUNTIME', 'ITEM', 'ESPERA VOCE'], vivas.map((t) => [
+            t.id, t.modo, t.fase, runtimeDaThread(t), t.roadmap ?? '-', t.esperaVoce ? `sim: ${curto(t.pergunta ?? 'veredito', 40)}` : '-',
         ]))];
 }
 /** `ork fabrica`: todas as maquinas. */
@@ -315,15 +346,17 @@ function painelDaFabricaEmMarkdown(maquinas) {
         'O que cada máquina está conduzindo agora. Gerado pelo `ork fabrica publicar`; não edite à mão.',
         'Antes de pegar um item do roadmap: `ork roadmap reservas`.',
         '',
-        '| Máquina | Thread | Modo | Fase | Item | Espera você | Publicado |',
-        '| --- | --- | --- | --- | --- | --- | --- |',
+        '| Máquina | Thread | Modo | Fase | Runtime | Item | Espera você | Publicado |',
+        '| --- | --- | --- | --- | --- | --- | --- | --- |',
     ];
     const vivas = maquinas.flatMap((m) => ativas(m).map((t) => ({ m, t })));
     if (vivas.length === 0)
-        linhas.push('| — | nenhuma thread ativa | — | — | — | — | — |');
+        linhas.push('| — | nenhuma thread ativa | — | — |  | — | — | — |');
     for (const { m, t } of vivas) {
         const pergunta = t.esperaVoce ? `sim: ${curto(t.pergunta ?? 'veredito', 60).replace(/\|/g, '/')}` : '—';
-        linhas.push(`| ${m.maquina} | ${t.id} | ${t.modo} | ${t.fase} | ${t.roadmap ?? '—'} | ${pergunta} | ${(0, horario_1.formatarDataHora)(m.publicadoEm)} |`);
+        // RM-037 (sugestao 6 do CHECK 1): a celula sem despacho diz isso, sem travessao novo.
+        const runtime = t.runtime || t.modelo ? runtimeDaThread(t).replace(/\|/g, '/') : 'sem despacho';
+        linhas.push(`| ${m.maquina} | ${t.id} | ${t.modo} | ${t.fase} | ${runtime} | ${t.roadmap ?? '—'} | ${pergunta} | ${(0, horario_1.formatarDataHora)(m.publicadoEm)} |`);
     }
     return [...linhas, '', (0, horario_1.legendaDoFuso)(), ''].join('\n');
 }

package/dist/fechamento.js

@@ -0,0 +1,105 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.liberarAoFechar = liberarAoFechar;
+/**
+ * RM-037 (rm037noite): o que sai quando a thread fecha, pelo MASTER ou pelo `ork thread close`.
+ *
+ * Domicilio unico do "ao fechar". Antes, as duas saidas gravavam `status: fechada` e paravam ali:
+ * a thread fechada seguia na frente da fila de regiao (defeito 2) e com o item do roadmap reservado
+ * (defeito 3). Tudo aqui e de melhor esforco: o fechamento ja aconteceu, e nada daqui o desfaz nem o
+ * derruba. Cada parte roda isolada (achado A1 do CHECK 1): erro de E/S numa nao impede a outra, e o
+ * que nao saiu agora sai na poda do proximo pedido de regiao ou no `ork roadmap reservas --soltar-orfas`.
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const estado_thread_1 = require("./estado-thread");
+const ledger_1 = require("./ledger");
+const leases_1 = require("./leases");
+const roadmap_reservas_1 = require("./roadmap-reservas");
+const thread_1 = require("./thread");
+function liberarAoFechar(raiz, threadId) {
+    const saida = { leases: [], fila: [], reservas: [], falhas: [] };
+    const falhou = (parte, e) => saida.falhas.push(`${parte}: ${e?.message ?? String(e)}`);
+    // Os leases de regiao sao por checkout: o de quem fecha, a raiz do projeto e, quando a thread tem
+    // worktree, os pegos de la (sugestao 6 do CHECK 2: fechar da worktree tambem solta os da raiz).
+    const real = (p) => { try {
+        return fs.realpathSync(p);
+    }
+    catch {
+        return path.resolve(p);
+    } };
+    const candidatos = [raiz];
+    try {
+        candidatos.push((0, estado_thread_1.raizDoEstado)(raiz));
+    }
+    catch (e) {
+        falhou('raiz', e);
+    }
+    try {
+        const wt = (0, thread_1.lerThread)(raiz, threadId).worktree;
+        if (wt && fs.existsSync(wt))
+            candidatos.push(wt);
+    }
+    catch (e) {
+        falhou('thread', e);
+    }
+    const checkouts = candidatos.filter((c, i) => candidatos.findIndex((x) => real(x) === real(c)) === i);
+    for (const checkout of checkouts) {
+        try {
+            const solto = (0, leases_1.soltarThreadFechada)(checkout, threadId, 'fechamento');
+            saida.leases.push(...solto.leases);
+            saida.fila.push(...solto.fila);
+        }
+        catch (e) {
+            falhou(`leases em ${checkout}`, e);
+        }
+    }
+    try {
+        saida.reservas = (0, roadmap_reservas_1.soltarReservaDaThread)(raiz, threadId);
+    }
+    catch (e) {
+        falhou('reserva', e);
+    }
+    // Sugestao 2 do CHECK 2: a falha tambem vai ao ledger da thread, de melhor esforco.
+    if (saida.falhas.length > 0) {
+        try {
+            (0, ledger_1.registrarSeExiste)((0, thread_1.dirThread)(raiz, threadId), threadId, ledger_1.TIPOS_DE_EVENTO.solturaFalhou, { falhas: saida.falhas,
+                correcao: 'a poda do proximo pedido de regiao solta o que ficou; reserva: ork roadmap reservas --soltar-orfas' });
+        }
+        catch { /* o ledger que nao grava ja esta nas falhas */ }
+    }
+    return saida;
+}

package/dist/fix.js

@@ -196,7 +196,7 @@ function sobConducao(carregado, threadId, operacao, conducao, executar) {
         canal: conducao.canal ?? (0, conducao_1.canalDoProcesso)(),
         correlacao: conducao.correlacao ?? null,
         operacao,
-        identidade: conducao.identidade ?? (0, conducao_1.identidadeDoAmbiente)(threadId),
+        identidade: conducao.identidade ?? (0, conducao_1.identidadeDoAmbiente)(threadId, process.env, carregado.raiz),
         prazoMs: (0, conducao_1.prazoDaVerificacao)(carregado.manifesto.verify.timeout_ms ?? 10 * 60 * 1000, 8),
         esperarMs: conducao.esperarMs,
     }, executar);