@orkastery/cli 0.2.0 → 0.3.0

package/dist/master-digest.js

@@ -0,0 +1,149 @@
+"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.dirDigest = void 0;
+exports.sextaLocal = sextaLocal;
+exports.montarDigest = montarDigest;
+exports.lerDigest = lerDigest;
+exports.responderLoteDigest = responderLoteDigest;
+exports.enviarDigest = enviarDigest;
+/** Uma fotografia semanal, páginas limitadas e recibos antes de marcar entrega. */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_crypto_1 = require("node:crypto");
+const master_batch_1 = require("./master-batch");
+const master_1 = require("./master");
+const estado_thread_1 = require("./estado-thread");
+const hitl_1 = require("./hitl");
+const pulse_delivery_1 = require("./pulse-delivery");
+const util_1 = require("./util");
+const horario_1 = require("./horario");
+const dirDigest = (raiz) => path.join((0, estado_thread_1.raizDoEstado)(raiz), '.orkastery', 'monitor', 'master-digest');
+exports.dirDigest = dirDigest;
+const hash = (v) => (0, node_crypto_1.createHash)('sha256').update(JSON.stringify(v)).digest('hex');
+/**
+ * I-35: a sexta-feira é a do fuso do dono (`owner.timezone`; sem ele, o fuso do sistema).
+ * Com o dono em Brasília o dia é o mesmo de antes em qualquer `TZ` do processo.
+ */
+function sextaLocal(quando, fuso = (0, horario_1.fusoDoDono)().fuso) {
+    const data = new Date(quando);
+    if (!Number.isFinite(data.getTime()))
+        throw new Error('data inválida');
+    const dia = (0, horario_1.dataLocal)(data, fuso);
+    return new Date(`${dia}T12:00:00Z`).getUTCDay() === 5 ? dia : null;
+}
+function pagina(texto, opcoes) {
+    if (texto.length > 3900 || opcoes.length > 12 || opcoes.some(o => o.length > 200))
+        throw new Error('página excede limite do host');
+    return { contrato: 'ork.master-digest-page/v1', texto, opcoes };
+}
+function montarDigest(raiz, quando) {
+    const semana = sextaLocal(quando);
+    if (!semana)
+        throw new Error(`digest semanal exige sexta-feira no fuso do dono (${(0, horario_1.fusoDoDono)().fuso})`);
+    const itens = (0, master_batch_1.listarBatch)(raiz);
+    const selecao = itens.filter(i => i.proposta && i.entregue).map(i => ({ thread: i.thread, assinatura: i.assinatura }));
+    const assinatura = hash(selecao);
+    const paginas = [pagina(`Orkastery: ${itens.length} scores esperando você. Semana de ${semana.split('-').reverse().join('/')}.\nRevise as propostas nas páginas seguintes antes de aceitar o lote.\nO lote contém ${selecao.length} propostas com entrega comprovada.`, selecao.length ? [`ratificar-lote ${semana} ${assinatura}`] : [])];
+    for (const i of itens) {
+        const campo = (s, n) => (0, hitl_1.redigirSegredos)(s).slice(0, n);
+        const texto = `Thread ${i.thread}: ${campo(i.nome, 180)}\n` + (i.proposta
+            ? `Proposta: ${i.proposta.valor}/5 por ${campo(i.proposta.propostoPor, 100)}\nJustificativa: ${campo(i.proposta.justificativa, 1800)}\nClasses propostas: ${i.proposta.classes.join(', ')}\nProposta ${i.assinatura}\nEscolha a classe para ratificar este score e esta justificativa.`
+            : 'Sem proposta. Registre score e justificativa após revisar a entrega.') + (!i.entregue ? '\nFalta prova de entrega; ratificação indisponível.' : '');
+        paginas.push(pagina(texto, i.proposta && i.entregue ? master_1.ORDEM_DAS_CLASSES.map(c => `ratificar ${i.thread} ${i.assinatura} ${c}`) : []));
+    }
+    return { contrato: 'ork.master-digest/v1', semana, criadoEm: quando, assinatura, selecao, paginas, recibos: [], concluidoEm: null };
+}
+function salvar(file, job) {
+    const tmp = `${file}.${process.pid}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify(job, null, 2) + '\n', { mode: 0o600 });
+    fs.renameSync(tmp, file);
+}
+function lerDigest(raiz, semana) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(semana))
+        throw new Error('semana inválida');
+    const job = (0, util_1.lerJson)(path.join((0, exports.dirDigest)(raiz), `${semana}.json`));
+    if (job.contrato !== 'ork.master-digest/v1' || job.semana !== semana || hash(job.selecao) !== job.assinatura ||
+        !Array.isArray(job.paginas) || !Array.isArray(job.recibos))
+        throw new Error('digest inválido');
+    return job;
+}
+function responderLoteDigest(raiz, resposta, por) {
+    const partes = resposta.trim().split(/\s+/);
+    if (partes.length !== 3 || partes[0] !== 'ratificar-lote')
+        throw new Error('resposta de lote inválida');
+    const job = lerDigest(raiz, partes[1]);
+    if (!job.concluidoEm || partes[2] !== job.assinatura)
+        throw new Error('lote não entregue ou assinatura divergente');
+    return (0, master_batch_1.ratificarBatch)(raiz, job.selecao, por);
+}
+function enviarDigest(opcoes) {
+    const quando = opcoes.quando ?? new Date().toISOString(), semana = sextaLocal(quando);
+    if (!semana)
+        return { code: 0, detalhe: `fora da sexta-feira no fuso do dono (${(0, horario_1.fusoDoDono)().fuso})`, enviadas: 0, semana };
+    const raiz = (0, estado_thread_1.raizDoEstado)(opcoes.raiz), dir = (0, exports.dirDigest)(raiz);
+    fs.mkdirSync(dir, { recursive: true });
+    const lock = path.join(dir, 'envio.lock'), file = path.join(dir, `${semana}.json`);
+    const trava = (0, pulse_delivery_1.adquirirLockMonitor)(lock);
+    if (!trava.ok)
+        return { code: 1, detalhe: trava.detalhe, enviadas: 0, semana };
+    let enviadas = 0;
+    try {
+        const job = fs.existsSync(file) ? lerDigest(raiz, semana) : montarDigest(raiz, quando);
+        if (job.concluidoEm)
+            return { code: 0, detalhe: 'semana já confirmada', enviadas, semana };
+        salvar(file, job);
+        const config = opcoes.transporte ?? (!opcoes.enviar ? (0, util_1.lerJson)(path.join(raiz, '.orkastery/monitor/master-host.json')) : undefined);
+        for (const [indice, p] of job.paginas.entries()) {
+            if (job.recibos.some(r => r.pagina === indice && r.sha256 === hash(p)))
+                continue;
+            const recibo = opcoes.enviar ? opcoes.enviar(p) : (0, pulse_delivery_1.enviarPayloadHost)(raiz, config, p);
+            if (recibo.success !== true || !Number.isInteger(recibo.message_id) || recibo.message_id <= 0 || !recibo.platform)
+                throw new Error('recibo inválido');
+            job.recibos.push({ pagina: indice, sha256: hash(p), confirmadoEm: quando, host: recibo });
+            enviadas++;
+            salvar(file, job);
+        }
+        job.concluidoEm = quando;
+        salvar(file, job);
+        return { code: 0, detalhe: 'digest confirmado pelo host', enviadas, semana };
+    }
+    catch (e) {
+        return { code: 1, detalhe: e.message, enviadas, semana };
+    }
+    finally {
+        trava.liberar();
+    }
+}

package/dist/master-migracao.js

@@ -0,0 +1,155 @@
+"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.planejarMigracaoMaster = planejarMigracaoMaster;
+exports.migrarMaster = migrarMaster;
+/** Correções append-only. Backups não recebem autoria humana retroativa. */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_crypto_1 = require("node:crypto");
+const thread_1 = require("./thread");
+const ledger_1 = require("./ledger");
+const master_1 = require("./master");
+const thread_close_1 = require("./thread-close");
+const estado_thread_1 = require("./estado-thread");
+const util_1 = require("./util");
+const ARQUIVOS = ['thread.json', 'ledger.jsonl', 'POSTMORTEM.json', 'master-log.json'];
+function snapshot(dir) {
+    return Object.fromEntries(ARQUIVOS.filter(f => fs.existsSync(path.join(dir, f))).map(f => [f, fs.readFileSync(path.join(dir, f), 'utf8')]));
+}
+function hash(dados) { return (0, node_crypto_1.createHash)('sha256').update(JSON.stringify(dados)).digest('hex'); }
+function motivoLegado(justificativa) {
+    const s = justificativa.normalize('NFD').replace(/[\u0300-\u036f]/g, '').toLowerCase();
+    if (/orfa/.test(s))
+        return 'orfa';
+    if (/engano|recriar|recriando/.test(s))
+        return 'engano';
+    if (/superad|substituid/.test(s))
+        return 'superada';
+    return undefined;
+}
+function planejarMigracaoMaster(raiz) {
+    return (0, thread_1.listarIds)(raiz).flatMap(id => {
+        const t = (0, thread_1.lerThread)(raiz, id);
+        if (!t.score || t.fechamentoAdmin || (0, master_1.masterRatificado)(raiz, id))
+            return [];
+        if (t.status !== 'fechada' && t.faseAtual !== 'MASTER')
+            return [];
+        if ((0, ledger_1.lerLedger)((0, thread_1.dirThread)(raiz, id)).some(e => e.tipo === ledger_1.TIPOS_DE_EVENTO.masterMigrado && e.versao === 1))
+            return [];
+        const motivo = t.score.valor === 0 && !(0, thread_close_1.provaDeEntrega)(raiz, id) ? motivoLegado(t.score.justificativa) : undefined;
+        return [{ thread: id, acao: motivo ? 'administrativo' : 'batch', ...(motivo ? { motivo } : {}), origem: hash(snapshot((0, thread_1.dirThread)(raiz, id))) }];
+    });
+}
+function migrarMaster(raiz, opcoes) {
+    if (!opcoes.por.trim())
+        throw new Error('migração exige autoria explícita');
+    const correcoes = planejarMigracaoMaster(raiz);
+    const adiadas = (0, thread_1.listarIds)(raiz).filter(id => {
+        const t = (0, thread_1.lerThread)(raiz, id);
+        return !!t.score && !(0, master_1.masterRatificado)(raiz, id) && t.status !== 'fechada' && t.faseAtual !== 'MASTER';
+    });
+    // O ensaio e a aplicação validam todos os documentos antes de criar backups.
+    for (const c of correcoes) {
+        const dir = (0, thread_1.dirThread)(raiz, c.thread), score = (0, thread_1.lerThread)(raiz, c.thread).score;
+        (0, master_1.exigirScoreValido)(score.valor, score.justificativa);
+        for (const nome of ['master-log.json', 'POSTMORTEM.json']) {
+            const file = path.join(dir, nome);
+            if (fs.existsSync(file)) {
+                const documento = (0, util_1.lerJson)(file);
+                if (!documento || typeof documento !== 'object' || Array.isArray(documento))
+                    throw new Error(`documento legado inválido: ${file}`);
+            }
+        }
+    }
+    if (opcoes.dryRun)
+        return { dryRun: true, correcoes, adiadas };
+    const lock = path.join((0, estado_thread_1.raizDoEstado)(raiz), '.orkastery', 'master-migracao.lock');
+    fs.mkdirSync(lock);
+    try {
+        // Preflight do conjunto antes da primeira mutação.
+        for (const c of correcoes) {
+            const dir = (0, thread_1.dirThread)(raiz, c.thread);
+            if (hash(snapshot(dir)) !== c.origem)
+                throw new Error(`estado mudou durante preflight: ${c.thread}`);
+            if (fs.existsSync(path.join(dir, 'migracao-master-v1')))
+                throw new Error(`backup anterior exige inspeção: ${c.thread}`);
+        }
+        for (const c of correcoes) {
+            const dir = (0, thread_1.dirThread)(raiz, c.thread), antes = snapshot(dir), t = (0, thread_1.lerThread)(raiz, c.thread);
+            if (hash(antes) !== c.origem)
+                throw new Error(`estado mudou antes da correção: ${c.thread}`);
+            const backup = path.join(dir, 'migracao-master-v1');
+            fs.mkdirSync(backup);
+            for (const [file, conteudo] of Object.entries(antes))
+                fs.writeFileSync(path.join(backup, file), conteudo, { flag: 'wx' });
+            const hashes = Object.fromEntries(Object.entries(antes).map(([f, v]) => [f, (0, node_crypto_1.createHash)('sha256').update(v).digest('hex')]));
+            (0, util_1.gravarJson)(path.join(backup, 'snapshot.json'), { origem: c.origem, hashes, correcao: c });
+            const score = t.score;
+            t.score = null;
+            if (c.acao === 'administrativo') {
+                t.status = 'fechada';
+                t.score_proposto = null;
+                t.fechamentoAdmin = { motivo: c.motivo, por: opcoes.por.trim(), justificativa: score.justificativa, fechadoEm: (0, util_1.agora)() };
+                (0, ledger_1.registrar)(dir, t.id, 'thread_closed_admin', { ...t.fechamentoAdmin, migracao: true, backup });
+                // Os logs legados ficam preservados; o leitor exige ratificação e os ignora.
+            }
+            else {
+                const log = antes['master-log.json'] ? (0, util_1.lerJson)(path.join(backup, 'master-log.json')) : {};
+                const classes = Array.isArray(log.classesDeFalha) ? log.classesDeFalha.map((c) => typeof c === 'string' ? (0, master_1.parseClasse)(c) : null).filter((c) => c !== null) : [];
+                const proposta = { valor: score.valor, justificativa: score.justificativa,
+                    classes: classes.length ? classes : ['outra'], propostoPor: opcoes.por.trim(), propostoEm: (0, util_1.agora)(),
+                    resumo: 'Score legado sem prova de ratificação humana; revisar entrega e autoria.' };
+                t.score_proposto = proposta;
+                t.status = 'aberta';
+                t.faseAtual = 'MASTER';
+                // Mantém toda a origem no backup e remove atribuição presumida da versão corrente.
+                const { avaliadoPor: _por, avaliadoEm: _em, ...base } = log;
+                (0, util_1.gravarJson)(path.join(dir, 'master-log.json'), { ...base, contrato: master_1.CONTRATO_MASTER_PENDENTE, versao: 1,
+                    thread: t.id, score: null, estado: 'ratificacao-pendente', score_proposto: proposta });
+                const post = antes['POSTMORTEM.json'] ? (0, util_1.lerJson)(path.join(backup, 'POSTMORTEM.json')) : { thread: t.id };
+                (0, util_1.gravarJson)(path.join(dir, 'POSTMORTEM.json'), { ...post, score: null, score_proposto: proposta });
+                (0, ledger_1.registrar)(dir, t.id, ledger_1.TIPOS_DE_EVENTO.scoreProposto, { fase: 'MASTER', ...proposta, migracao: true, backup });
+            }
+            (0, thread_1.gravarThread)(raiz, t);
+            (0, ledger_1.registrar)(dir, t.id, ledger_1.TIPOS_DE_EVENTO.masterMigrado, { versao: 1, por: opcoes.por.trim(), acao: c.acao, origem: c.origem, backup, hashes,
+                razao: 'Separar encerramento administrativo e score sem autoria humana comprovada, preservando os originais' });
+        }
+        return { dryRun: false, correcoes, adiadas };
+    }
+    finally {
+        fs.rmdirSync(lock);
+    }
+}