expxdev 0.4.1 → 0.5.1

package/dist/watch/visao/projetar.d.ts

@@ -0,0 +1,51 @@
+import { type BloqueioSituado, type TrabalhoMontado } from "../../parser/projeto/montar.js";
+import type { LinhaEvento } from "../../parser/esquema/evento.js";
+import type { EstadoExpx } from "../fontes/estado-schema.js";
+/**
+ * A visão que o desenho consome — as três fontes reunidas numa estrutura só.
+ *
+ * O parser do painel é reaproveitado inteiro, sem refatoração: `montarProjeto`
+ * é função pura de sistema de arquivos, sem acoplamento a HTTP ou websocket
+ * (base/parser-de-artefatos.md, decisão D-02). O que se acrescenta aqui é o
+ * que ele não sabe: o `estado.json` e o rastro.
+ */
+export type Visao = {
+    /** O trabalho que o watch está seguindo, ou `null` se não há nenhum. */
+    trabalho: TrabalhoMontado | null;
+    /** Os trabalhos abertos, para `--todos` e para a tela de "nenhum trabalho". */
+    abertos: TrabalhoMontado[];
+    /** O `estado.json`, ou `null` quando ausente, inválido ou de versão futura. */
+    estado: EstadoExpx | null;
+    /**
+     * Estamos sem o `estado.json`?
+     *
+     * NÃO é "o arquivo não existe": a decisão D-12 trata versão ≠ 1 e JSON
+     * inválido do mesmo jeito. No modo degradado, `raio`, `orcamento_*`, `branch`
+     * e `pr_estado` não têm fonte alguma e não podem ser exibidos — nenhum kind
+     * do `expx-schema` os declara (base/estado-json.md, risco 2).
+     */
+    degradado: boolean;
+    /** Tasks concluídas e total, do estado quando há, do plano quando não há. */
+    concluidas: number;
+    total: number;
+    /** Só os bloqueios abertos, que são os que sobem ao topo. */
+    bloqueiosAbertos: BloqueioSituado[];
+    /** As últimas linhas do rastro, da mais recente para a mais antiga. */
+    eventos: LinhaEvento[];
+    /** Violações em modo aviso desde que o watch subiu (decisão D-07). */
+    violacoesAviso: number;
+    /** Instante da leitura, para o rodapé calcular "tempo desde o último evento". */
+    lidoEm: Date;
+};
+export type OpcoesVisao = {
+    /** Id pedido em `expx watch <trabalho_id>`. */
+    trabalhoPedido?: string;
+    /**
+     * Quando o watch subiu. É a fronteira da "sessão" no rodapé: o rastro é
+     * append-only e não marca sessão nenhuma (lacuna L-03, decisão D-07).
+     */
+    subiuEm?: Date;
+    /** Quantas linhas do rastro exibir. */
+    linhasRastro?: number;
+};
+export declare function projetarVisao(raizProjeto: string, op?: OpcoesVisao, agora?: Date): Visao;

package/dist/watch/visao/projetar.js

@@ -0,0 +1,38 @@
+import { montarProjeto } from "../../parser/projeto/montar.js";
+import { lerEstadoExpx } from "../fontes/estado.js";
+import { lerRastro } from "../fontes/rastro.js";
+import { abertos, escolherTrabalho } from "./escolher.js";
+export function projetarVisao(raizProjeto, op = {}, agora = new Date()) {
+    const projeto = montarProjeto(raizProjeto, agora);
+    const estado = lerEstadoExpx(raizProjeto);
+    const trabalho = escolherTrabalho(projeto.trabalhos, estado, op.trabalhoPedido);
+    const tasks = trabalho?.sprints.flatMap((s) => s.tasks) ?? [];
+    // O par concluídas/total tem duas fontes: o estado.json traz os inteiros
+    // prontos, e o plano exige contagem — `progresso` do parser é fração 0..1,
+    // não o par (base/parser-de-artefatos.md, risco 4).
+    const doEstado = estado !== null && trabalho !== null;
+    const concluidas = doEstado
+        ? estado.tasks_concluidas
+        : tasks.filter((t) => t.status === "concluida").length;
+    const total = doEstado ? estado.tasks_total : tasks.length;
+    const eventos = trabalho === null ? [] : lerRastro(raizProjeto, trabalho.trabalho_id, op.linhasRastro);
+    // "Modo aviso" é vocabulário de hook e só existe no rastro: `regra_violada` é
+    // gravado por hook em modo aviso, `acao_bloqueada` em modo bloqueio. Não
+    // confundir com as `Violacao` da conformidade, que são defeitos do método nos
+    // arquivos do plano (lacuna L-03).
+    const fronteira = op.subiuEm?.toISOString().replace(/\.\d{3}Z$/, "Z");
+    const violacoesAviso = eventos.filter((e) => e.evento === "regra_violada" && (fronteira === undefined || e.ts >= fronteira)).length;
+    return {
+        trabalho,
+        abertos: abertos(projeto.trabalhos),
+        estado,
+        degradado: estado === null,
+        concluidas,
+        total,
+        bloqueiosAbertos: (trabalho?.bloqueios ?? []).filter((b) => b.aberto),
+        eventos,
+        violacoesAviso,
+        lidoEm: agora,
+    };
+}
+//# sourceMappingURL=projetar.js.map

package/dist/watch/visao/projetar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projetar.js","sourceRoot":"","sources":["../../../src/watch/visao/projetar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA8C,MAAM,gCAAgC,CAAC;AAG3G,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAoD1D,MAAM,UAAU,aAAa,CAC3B,WAAmB,EACnB,KAAkB,EAAE,EACpB,QAAc,IAAI,IAAI,EAAE;IAExB,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC;IAEhF,MAAM,KAAK,GAAG,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAE9D,yEAAyE;IACzE,2EAA2E;IAC3E,oDAAoD;IACpD,MAAM,QAAQ,GAAG,MAAM,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,CAAC;IACtD,MAAM,UAAU,GAAG,QAAQ;QACzB,CAAC,CAAC,MAAM,CAAC,gBAAgB;QACzB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IACzD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IAE3D,MAAM,OAAO,GACX,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC;IAEzF,8EAA8E;IAC9E,yEAAyE;IACzE,8EAA8E;IAC9E,mCAAmC;IACnC,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACtE,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CACnC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,eAAe,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,EAAE,IAAI,SAAS,CAAC,CACtF,CAAC,MAAM,CAAC;IAET,OAAO;QACL,QAAQ;QACR,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;QACnC,MAAM;QACN,SAAS,EAAE,MAAM,KAAK,IAAI;QAC1B,UAAU;QACV,KAAK;QACL,gBAAgB,EAAE,CAAC,QAAQ,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QACrE,OAAO;QACP,cAAc;QACd,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC"}

package/dist/watch/watch.d.ts

@@ -0,0 +1,26 @@
+import type { Opcoes } from "./opcoes.js";
+/**
+ * O loop do watch: lê, desenha, observa, redesenha.
+ *
+ * A promessa que este arquivo existe para cumprir: "a árvore completa vem dos
+ * arquivos do plano, relida apenas quando eles mudam — não a cada redesenho".
+ * Por isso a visão é guardada e só o gatilho de plano a reconstrói; o gatilho
+ * de estado atualiza o barato e redesenha com a árvore que já estava em mãos.
+ */
+export type SessaoWatch = {
+    parar: () => Promise<void>;
+    /** Código de saída, quando o watch terminou sozinho. */
+    codigo: number;
+    /** O watch encerrou por conta própria (projeto sem Expx)? */
+    encerrou: boolean;
+};
+export type OpcoesExecucao = {
+    raiz: string;
+    opcoes: Opcoes;
+    escrever: (texto: string) => void;
+    cor: boolean;
+    debounceMs?: number;
+    /** Gancho de teste: chamado toda vez que o PLANO é relido do disco. */
+    aoLerPlano?: () => void;
+};
+export declare function executarWatch(op: OpcoesExecucao): Promise<SessaoWatch>;

package/dist/watch/watch.js

@@ -0,0 +1,89 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { desenhar } from "./desenho/desenhar.js";
+import { desenharLista } from "./desenho/lista.js";
+import { lerEstadoExpx } from "./fontes/estado.js";
+import { observarFontes } from "./fontes/observar.js";
+import { lerRastro } from "./fontes/rastro.js";
+import { criarTela } from "./terminal/tela.js";
+import { projetarVisao } from "./visao/projetar.js";
+/** Largura de trabalho: a do terminal, o pedido explícito, ou 80. */
+function larguraDe(op) {
+    if (op.opcoes.colunas !== undefined)
+        return op.opcoes.colunas;
+    const cols = process.stdout.columns;
+    // Abaixo de 80 continuamos desenhando: o corte é elegante por construção.
+    return typeof cols === "number" && cols > 0 ? cols : 80;
+}
+export async function executarWatch(op) {
+    // Sem `.expx/`, o projeto não tem o Expx instalado. Mensagem curta e saída
+    // limpa, como manda a tolerância a falha — não é erro, é ausência.
+    if (!existsSync(join(op.raiz, ".expx"))) {
+        op.escrever([
+            "este projeto nao tem o Expx instalado (falta a pasta .expx/).",
+            "",
+            "  npx expxdev init      instala as skills neste projeto",
+            "",
+        ].join("\n"));
+        return { parar: async () => undefined, codigo: 0, encerrou: true };
+    }
+    const subiuEm = new Date();
+    const colunas = larguraDe(op);
+    const tela = criarTela(op.escrever);
+    // A visão fica guardada de propósito: é ela que carrega a árvore, cara de
+    // montar. O gatilho de estado NÃO a reconstrói.
+    let visao = lerTudo();
+    function lerTudo() {
+        op.aoLerPlano?.();
+        return projetarVisao(op.raiz, {
+            ...(op.opcoes.trabalho !== undefined ? { trabalhoPedido: op.opcoes.trabalho } : {}),
+            subiuEm,
+        });
+    }
+    function redesenhar() {
+        const linhas = op.opcoes.todos
+            ? desenharLista(visao, colunas, op.cor)
+            : desenhar(visao, { colunas, cor: op.cor, agora: new Date() });
+        tela.desenhar(linhas);
+    }
+    redesenhar();
+    const observador = await observarFontes(op.raiz, {
+        // O plano mudou: reconstrói tudo. É a releitura cara, e ela só acontece
+        // aqui.
+        aoMudarPlano: () => {
+            visao = lerTudo();
+            redesenhar();
+        },
+        // Só o estado.json mudou: atualiza o barato e redesenha com a árvore
+        // que já estava em mãos.
+        aoMudarEstado: () => {
+            const estado = lerEstadoExpx(op.raiz);
+            visao = { ...visao, estado, degradado: estado === null };
+            redesenhar();
+        },
+        // Só o rastro cresceu: relê os eventos, que é leitura de cauda, e
+        // preserva a árvore. É o caminho mais percorrido durante uma execução
+        // autônoma — cada hook grava uma linha.
+        aoMudarRastro: () => {
+            if (visao.trabalho === null)
+                return;
+            const eventos = lerRastro(op.raiz, visao.trabalho.trabalho_id);
+            const fronteira = subiuEm.toISOString().replace(/\.\d{3}Z$/, "Z");
+            visao = {
+                ...visao,
+                eventos,
+                violacoesAviso: eventos.filter((e) => e.evento === "regra_violada" && e.ts >= fronteira)
+                    .length,
+            };
+            redesenhar();
+        },
+    }, op.debounceMs ?? 150);
+    return {
+        parar: async () => {
+            await observador.parar();
+        },
+        codigo: 0,
+        encerrou: false,
+    };
+}
+//# sourceMappingURL=watch.js.map

package/dist/watch/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/watch/watch.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expxdev",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "CLI do metodo Expx: instala, atualiza e opera o ecossistema de skills, e sobe o painel de operacao",
   "type": "module",
   "bin": {