expxdev 0.4.0 → 0.5.0

package/dist/watch/desenho/arvore.js

@@ -0,0 +1,62 @@
+import { cortar } from "./largura.js";
+/**
+ * A árvore: sprints, fases e tasks, indentadas.
+ *
+ * Os dois vocabulários de status NÃO são intercambiáveis: task usa o feminino
+ * (`concluida`, `bloqueada`) e trabalho/sprint/fase usam o masculino
+ * (`concluido`, `bloqueado`). Uma função de marcador que aceitasse `string`
+ * casaria os dois por engano ou deixaria um sem cor — por isso são duas
+ * (base/schema-v1-e-kinds.md, risco 4).
+ *
+ * Marcadores são caractere simples, sem emoji, como manda a especificação.
+ */
+const MARCA_TASK = {
+    concluida: { marca: "[x]", papel: "sucesso" },
+    em_andamento: { marca: "[>]", papel: "atencao" },
+    bloqueada: { marca: "[!]", papel: "erro" },
+    pendente: { marca: "[ ]", papel: "apagado" },
+};
+const MARCA_GRUPO = {
+    concluido: { marca: "[x]", papel: "sucesso" },
+    em_andamento: { marca: "[>]", papel: "atencao" },
+    bloqueado: { marca: "[!]", papel: "erro" },
+    nao_iniciado: { marca: "[ ]", papel: "apagado" },
+};
+export function desenharArvore(v, colunas, pintar) {
+    if (v.trabalho === null)
+        return [];
+    const linhas = [];
+    // A task em andamento é o que a pessoa quer achar de relance na tela.
+    const emFoco = v.estado?.task ?? null;
+    for (const sprint of v.trabalho.sprints) {
+        const s = MARCA_GRUPO[sprint.status];
+        linhas.push(pintar(cortar(`${s.marca} ${sprint.sprint_id} · ${sprint.titulo}`, colunas), s.papel));
+        for (const fase of sprint.fases) {
+            const f = MARCA_GRUPO[fase.status];
+            // fase paralela mostra com quem roda junto — o plano declarou, a
+            // execução nunca decide isso sozinha
+            const par = fase.paralela_com.length > 0 ? ` || ${fase.paralela_com.join(",")}` : "";
+            linhas.push(pintar(cortar(`  ${f.marca} ${fase.id} · ${fase.titulo}${par}`, colunas), f.papel));
+            for (const task of fase.tasks) {
+                const t = MARCA_TASK[task.status];
+                const dep = task.depende_de.length > 0 ? ` ← ${task.depende_de.join(",")}` : "";
+                const paralela = task.paralelizavel ? " ||" : "";
+                const foco = task.id === emFoco ? " <" : "";
+                const texto = `    ${t.marca} ${task.id} ${task.titulo}${paralela}${dep}${foco}`;
+                linhas.push(pintar(cortar(texto, colunas), task.id === emFoco ? "destaque" : t.papel));
+            }
+        }
+        // Tasks que o arquivo de fases não referencia continuam existindo: o
+        // vínculo autoritativo é o campo `fase` da task, e uma task apontando
+        // para fase inexistente sumiria da tela sem isto.
+        const nasFases = new Set(sprint.fases.flatMap((f) => f.tasks.map((t) => t.id)));
+        for (const task of sprint.tasks) {
+            if (nasFases.has(task.id))
+                continue;
+            const t = MARCA_TASK[task.status];
+            linhas.push(pintar(cortar(`    ${t.marca} ${task.id} ${task.titulo} (fora de fase)`, colunas), t.papel));
+        }
+    }
+    return linhas;
+}
+//# sourceMappingURL=arvore.js.map

package/dist/watch/desenho/arvore.js.map

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

package/dist/watch/desenho/bloqueios.d.ts

@@ -0,0 +1,5 @@
+import type { Visao } from "../visao/projetar.js";
+import type { Pintor } from "./cor.js";
+/** "hoje", "1 dia", "N dias" — nunca "0 dias", que não é português. */
+export declare function tempoAberto(aberto: string, agora: Date): string;
+export declare function desenharBloqueios(v: Visao, colunas: number, pintar: Pintor, agora: Date): string[];

package/dist/watch/desenho/bloqueios.js

@@ -0,0 +1,41 @@
+import { cortar } from "./largura.js";
+/**
+ * A seção de bloqueios — a que sobe para o topo.
+ *
+ * O "há quanto tempo" é em DIAS porque `aberto_em` é `DataIso` (`AAAA-MM-DD`),
+ * sem hora (`src/parser/esquema/kinds.ts`). O rastro tem `ts` com hora no
+ * evento `task_bloqueada` e refinaria isso, ao custo de cruzar duas fontes —
+ * decisão D-14 escolheu não pagar.
+ */
+const MS_POR_DIA = 86_400_000;
+/** Dias inteiros entre a data de abertura e hoje, ambos em UTC. */
+function diasDesde(aberto, agora) {
+    const a = Date.parse(`${aberto}T00:00:00Z`);
+    if (Number.isNaN(a))
+        return 0;
+    const b = Date.UTC(agora.getUTCFullYear(), agora.getUTCMonth(), agora.getUTCDate());
+    return Math.max(0, Math.floor((b - a) / MS_POR_DIA));
+}
+/** "hoje", "1 dia", "N dias" — nunca "0 dias", que não é português. */
+export function tempoAberto(aberto, agora) {
+    const d = diasDesde(aberto, agora);
+    if (d === 0)
+        return "hoje";
+    return d === 1 ? "1 dia" : `${String(d)} dias`;
+}
+export function desenharBloqueios(v, colunas, pintar, agora) {
+    if (v.bloqueiosAbertos.length === 0)
+        return [];
+    const n = v.bloqueiosAbertos.length;
+    const titulo = n === 1 ? "1 bloqueio aberto" : `${String(n)} bloqueios abertos`;
+    const linhas = [pintar(cortar(titulo, colunas), "erro")];
+    for (const b of v.bloqueiosAbertos) {
+        const alvo = b.task ?? "sem task";
+        const quando = tempoAberto(b.aberto_em, agora);
+        // corta primeiro, pinta depois: escape ANSI não ocupa coluna
+        const texto = cortar(`  ${b.id} · ${alvo} · ${quando} · ${b.descricao}`, colunas);
+        linhas.push(pintar(texto, "erro"));
+    }
+    return linhas;
+}
+//# sourceMappingURL=bloqueios.js.map

package/dist/watch/desenho/bloqueios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bloqueios.js","sourceRoot":"","sources":["../../../src/watch/desenho/bloqueios.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;GAOG;AAEH,MAAM,UAAU,GAAG,UAAU,CAAC;AAE9B,mEAAmE;AACnE,SAAS,SAAS,CAAC,MAAc,EAAE,KAAW;IAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,MAAM,YAAY,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IACpF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,KAAW;IACrD,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3B,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,CAAQ,EACR,OAAe,EACf,MAAc,EACd,KAAW;IAEX,IAAI,CAAC,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE/C,MAAM,CAAC,GAAG,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC;IACpC,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC;IAChF,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAEzD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,UAAU,CAAC;QAClC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC/C,6DAA6D;QAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,IAAI,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;QAClF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/watch/desenho/cabecalho.d.ts

@@ -0,0 +1,11 @@
+import type { Visao } from "../visao/projetar.js";
+import type { Pintor } from "./cor.js";
+/**
+ * O cabeçalho: que trabalho é, em que pé está.
+ *
+ * A linha de legado (raio e orçamento) e a de repositório (branch e PR) só
+ * existem quando o `estado.json` pôde ser lido: nenhum kind do `expx-schema`
+ * declara esses campos, então no modo degradado não há de onde tirá-los
+ * (base/estado-json.md, risco 2).
+ */
+export declare function desenharCabecalho(v: Visao, colunas: number, pintar: Pintor): string[];

package/dist/watch/desenho/cabecalho.js

@@ -0,0 +1,49 @@
+import { cortar } from "./largura.js";
+/**
+ * O cabeçalho: que trabalho é, em que pé está.
+ *
+ * A linha de legado (raio e orçamento) e a de repositório (branch e PR) só
+ * existem quando o `estado.json` pôde ser lido: nenhum kind do `expx-schema`
+ * declara esses campos, então no modo degradado não há de onde tirá-los
+ * (base/estado-json.md, risco 2).
+ */
+export function desenharCabecalho(v, colunas, pintar) {
+    if (v.trabalho === null) {
+        return [pintar(cortar("nenhum trabalho aberto", colunas), "apagado")];
+    }
+    const t = v.trabalho;
+    const linhas = [];
+    // Linha 1: identificação. O título do plano é o completo; o `titulo_curto`
+    // do estado.json já vem cortado em 30 e serviria à barra de status, não aqui.
+    //
+    // Regra que vale para o arquivo inteiro: CORTA primeiro, PINTA depois. Os
+    // escapes ANSI não ocupam coluna, então medir texto já pintado dá largura
+    // errada — e foi o primeiro jeito que este arquivo teve.
+    const marca = t.status === "bloqueado" ? "erro" : "destaque";
+    const identificacao = cortar(`${t.trabalho_id} · ${t.expx_tool} · ${t.titulo}`, colunas);
+    linhas.push(pintar(identificacao, marca));
+    // Linha 2: progresso. O par vem do estado quando há, do plano quando não.
+    const fase = v.estado?.fase ?? t.estagio;
+    const progresso = `${String(v.concluidas)}/${String(v.total)} tasks`;
+    const task = v.estado?.task != null ? ` · agora ${v.estado.task}` : "";
+    linhas.push(cortar(`  ${fase} · ${progresso}${task}`, colunas));
+    // Linha 3: modo legado. Só com estado legível E raio preenchido.
+    if (v.estado?.raio != null) {
+        const partes = [`raio ${v.estado.raio}`];
+        if (v.estado.orcamento_arquivos !== null) {
+            partes.push(`arquivos ${v.estado.orcamento_arquivos}`);
+        }
+        if (v.estado.orcamento_linhas !== null) {
+            partes.push(`linhas ${v.estado.orcamento_linhas}`);
+        }
+        const papel = v.estado.raio === "alto" ? "erro" : "atencao";
+        linhas.push(`  ${pintar(cortar(partes.join(" · "), colunas - 2), papel)}`);
+    }
+    // Linha 4: repositório. Idem — sem estado, sem branch e sem PR.
+    if (v.estado?.branch != null) {
+        const pr = v.estado.pr_estado !== null ? ` · pr ${v.estado.pr_estado}` : "";
+        linhas.push(`  ${pintar(cortar(`${v.estado.branch}${pr}`, colunas - 2), "apagado")}`);
+    }
+    return linhas;
+}
+//# sourceMappingURL=cabecalho.js.map

package/dist/watch/desenho/cabecalho.js.map

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

package/dist/watch/desenho/cor.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Cor no terminal, escrita à mão.
+ *
+ * O projeto não tem nenhuma biblioteca de cor disponível em runtime: os três
+ * pacotes ANSI em `node_modules` (`picocolors`, `ansi-styles`, `ansi-regex`)
+ * são transitivos de devDependencies e somem numa instalação de produção
+ * (base/bibliotecas-de-terminal.md). Seis códigos SGR não justificam uma
+ * dependência nova — decisão D-04.
+ */
+/**
+ * Os papéis de cor do painel, por significado e não por cor.
+ *
+ * Nomear por papel é o que permite trocar a paleta depois sem caçar "vermelho"
+ * espalhado pelo desenho.
+ */
+export declare const PAPEIS: readonly ["sucesso", "atencao", "erro", "destaque", "apagado", "neutro"];
+export type Papel = (typeof PAPEIS)[number];
+export type Ambiente = {
+    /** `process.stdout.isTTY` — e SÓ ele. */
+    tty: boolean;
+    /** A variável `NO_COLOR` está definida? */
+    noColor: boolean;
+};
+/**
+ * Decide se a cor sai.
+ *
+ * Duas condições, nesta ordem: a saída precisa ser terminal (especificação:
+ * "sem cor quando a saída não for terminal, para não sujar redirecionamento de
+ * arquivo") e `NO_COLOR` não pode estar definida (decisão D-10).
+ *
+ * Repare que NÃO usamos `ehInterativo()` do CLI: aquele exige stdin E stdout, e
+ * aqui stdin é irrelevante — o que suja o arquivo é o stdout.
+ */
+export declare function corAtiva(amb: Ambiente): boolean;
+/** Lê o ambiente real. Isolado para o teste nunca depender de TTY de verdade. */
+export declare function ambienteAtual(): Ambiente;
+export type Pintor = (texto: string, papel: Papel) => string;
+/**
+ * Devolve a função de pintura já com a decisão tomada.
+ *
+ * Com a cor desligada, `pintar` é identidade — nenhum escape chega ao arquivo,
+ * e o desenho não precisa de um `if` em cada linha.
+ */
+export declare function criarPintor(ativa: boolean): Pintor;

package/dist/watch/desenho/cor.js

@@ -0,0 +1,66 @@
+/**
+ * Cor no terminal, escrita à mão.
+ *
+ * O projeto não tem nenhuma biblioteca de cor disponível em runtime: os três
+ * pacotes ANSI em `node_modules` (`picocolors`, `ansi-styles`, `ansi-regex`)
+ * são transitivos de devDependencies e somem numa instalação de produção
+ * (base/bibliotecas-de-terminal.md). Seis códigos SGR não justificam uma
+ * dependência nova — decisão D-04.
+ */
+const ESC = "";
+const RESET = `${ESC}[0m`;
+/**
+ * Os papéis de cor do painel, por significado e não por cor.
+ *
+ * Nomear por papel é o que permite trocar a paleta depois sem caçar "vermelho"
+ * espalhado pelo desenho.
+ */
+export const PAPEIS = [
+    "sucesso",
+    "atencao",
+    "erro",
+    "destaque",
+    "apagado",
+    "neutro",
+];
+/** Código SGR de cada papel. */
+const CODIGO = {
+    sucesso: "32", // verde: concluído
+    atencao: "33", // amarelo: em andamento, aviso
+    erro: "31", // vermelho: bloqueado, violação
+    destaque: "1;36", // ciano forte: a task em andamento
+    apagado: "90", // cinza: pendente, metadado
+    neutro: "0", // sem cor, mas passa pelo mesmo caminho
+};
+/**
+ * Decide se a cor sai.
+ *
+ * Duas condições, nesta ordem: a saída precisa ser terminal (especificação:
+ * "sem cor quando a saída não for terminal, para não sujar redirecionamento de
+ * arquivo") e `NO_COLOR` não pode estar definida (decisão D-10).
+ *
+ * Repare que NÃO usamos `ehInterativo()` do CLI: aquele exige stdin E stdout, e
+ * aqui stdin é irrelevante — o que suja o arquivo é o stdout.
+ */
+export function corAtiva(amb) {
+    return amb.tty && !amb.noColor;
+}
+/** Lê o ambiente real. Isolado para o teste nunca depender de TTY de verdade. */
+export function ambienteAtual() {
+    return {
+        tty: process.stdout.isTTY === true,
+        noColor: process.env["NO_COLOR"] !== undefined,
+    };
+}
+/**
+ * Devolve a função de pintura já com a decisão tomada.
+ *
+ * Com a cor desligada, `pintar` é identidade — nenhum escape chega ao arquivo,
+ * e o desenho não precisa de um `if` em cada linha.
+ */
+export function criarPintor(ativa) {
+    if (!ativa)
+        return (texto) => texto;
+    return (texto, papel) => `${ESC}[${CODIGO[papel]}m${texto}${RESET}`;
+}
+//# sourceMappingURL=cor.js.map

package/dist/watch/desenho/cor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cor.js","sourceRoot":"","sources":["../../../src/watch/desenho/cor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,GAAG,GAAG,GAAG,CAAC;AAChB,MAAM,KAAK,GAAG,GAAG,GAAG,KAAK,CAAC;AAE1B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,SAAS;IACT,SAAS;IACT,MAAM;IACN,UAAU;IACV,SAAS;IACT,QAAQ;CACA,CAAC;AAIX,gCAAgC;AAChC,MAAM,MAAM,GAA0B;IACpC,OAAO,EAAE,IAAI,EAAE,mBAAmB;IAClC,OAAO,EAAE,IAAI,EAAE,+BAA+B;IAC9C,IAAI,EAAE,IAAI,EAAE,gCAAgC;IAC5C,QAAQ,EAAE,MAAM,EAAE,mCAAmC;IACrD,OAAO,EAAE,IAAI,EAAE,4BAA4B;IAC3C,MAAM,EAAE,GAAG,EAAE,wCAAwC;CACtD,CAAC;AASF;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAa;IACpC,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;AACjC,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI;QAClC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,SAAS;KAC/C,CAAC;AACJ,CAAC;AAID;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;IACpC,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;AACtE,CAAC"}

package/dist/watch/desenho/desenhar.d.ts

@@ -0,0 +1,16 @@
+import type { Visao } from "../visao/projetar.js";
+/**
+ * O painel inteiro, como lista de linhas.
+ *
+ * Função PURA: recebe a visão, a largura e se há cor, e devolve texto. Não
+ * toca em `process.stdout`, não lê TTY, não escreve em disco. É o que torna
+ * possível testar as dez fixtures da especificação sem nenhum terminal — as
+ * duas últimas (60 colunas, saída redirecionada) são justamente os parâmetros
+ * `colunas` e `cor` (decisão D-11).
+ */
+export type OpcoesDesenho = {
+    colunas: number;
+    cor: boolean;
+    agora: Date;
+};
+export declare function desenhar(v: Visao, op: OpcoesDesenho): string[];

package/dist/watch/desenho/desenhar.js

@@ -0,0 +1,54 @@
+import { desenharArvore } from "./arvore.js";
+import { desenharBloqueios } from "./bloqueios.js";
+import { desenharCabecalho } from "./cabecalho.js";
+import { criarPintor } from "./cor.js";
+import { desenharEventos } from "./eventos.js";
+import { cortar } from "./largura.js";
+const MINUTO = 60_000;
+const HORA = 60 * MINUTO;
+const DIA = 24 * HORA;
+/** "há 3 min", "há 2 h", "há 4 d" — curto, porque é rodapé. */
+function desde(quando, agora) {
+    const ms = Math.max(0, agora.getTime() - quando.getTime());
+    if (ms < MINUTO)
+        return "há instantes";
+    if (ms < HORA)
+        return `há ${String(Math.floor(ms / MINUTO))} min`;
+    if (ms < DIA)
+        return `há ${String(Math.floor(ms / HORA))} h`;
+    return `há ${String(Math.floor(ms / DIA))} d`;
+}
+function desenharRodape(v, colunas, pintar, agora) {
+    const partes = [];
+    // Tempo desde o último evento: "se passar muito, a execução travou".
+    const ultimo = v.eventos[0];
+    if (ultimo !== undefined) {
+        partes.push(`ultimo evento ${desde(new Date(ultimo.ts), agora)}`);
+    }
+    // Violações em modo aviso acumuladas na sessão (D-07).
+    if (v.violacoesAviso > 0) {
+        const n = v.violacoesAviso;
+        partes.push(n === 1 ? "1 violacao em aviso" : `${String(n)} violacoes em aviso`);
+    }
+    if (partes.length === 0)
+        return [];
+    const papel = v.violacoesAviso > 0 ? "atencao" : "apagado";
+    return [pintar(cortar(partes.join(" · "), colunas), papel)];
+}
+export function desenhar(v, op) {
+    const pintar = criarPintor(op.cor);
+    const c = op.colunas;
+    // A ordem é a prioridade da especificação: bloqueio aberto sobe para o topo,
+    // acima até do cabeçalho, "porque é a informação que mais precisa de olho
+    // humano e a que mais passa despercebida quando a execução é autônoma".
+    const secoes = [
+        desenharBloqueios(v, c, pintar, op.agora),
+        desenharCabecalho(v, c, pintar),
+        desenharArvore(v, c, pintar),
+        desenharEventos(v, c, pintar),
+        desenharRodape(v, c, pintar, op.agora),
+    ].filter((s) => s.length > 0);
+    // Uma linha em branco entre seções, nenhuma no fim.
+    return secoes.flatMap((s, i) => (i === 0 ? s : ["", ...s]));
+}
+//# sourceMappingURL=desenhar.js.map

package/dist/watch/desenho/desenhar.js.map

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

package/dist/watch/desenho/eventos.d.ts

@@ -0,0 +1,3 @@
+import type { Visao } from "../visao/projetar.js";
+import type { Pintor } from "./cor.js";
+export declare function desenharEventos(v: Visao, colunas: number, pintar: Pintor): string[];

package/dist/watch/desenho/eventos.js

@@ -0,0 +1,37 @@
+import { cortar } from "./largura.js";
+/**
+ * Os eventos recentes, do rastro, em ordem inversa.
+ *
+ * O `agente` sai em toda linha porque é o que responde "quem fez o quê" —
+ * e no contrato ele nunca é `null`: `principal` é o valor quando não há
+ * subagente, e isso é informação, não ausência.
+ */
+/** Só a hora, do `ts` que é `AAAA-MM-DDTHH:MM:SSZ`. */
+function hora(ts) {
+    return ts.slice(11, 16);
+}
+/** O papel de cor de cada evento, pelo que ele significa. */
+function papelDe(e) {
+    if (e.evento === "regra_violada" || e.evento === "acao_bloqueada")
+        return "erro";
+    if (e.evento === "task_bloqueada")
+        return "erro";
+    if (e.evento === "task_concluida" || e.evento === "fase_concluida")
+        return "sucesso";
+    if (e.resultado !== "ok")
+        return "atencao";
+    return "apagado";
+}
+export function desenharEventos(v, colunas, pintar) {
+    if (v.eventos.length === 0)
+        return [];
+    const linhas = [pintar(cortar("eventos recentes", colunas), "apagado")];
+    for (const e of v.eventos) {
+        const alvo = e.task ?? e.fase ?? "";
+        const detalhe = e.detalhe !== "" ? ` · ${e.detalhe}` : "";
+        const texto = `  ${hora(e.ts)} ${e.evento} ${alvo} [${e.agente}]${detalhe}`;
+        linhas.push(pintar(cortar(texto, colunas), papelDe(e)));
+    }
+    return linhas;
+}
+//# sourceMappingURL=eventos.js.map

package/dist/watch/desenho/eventos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventos.js","sourceRoot":"","sources":["../../../src/watch/desenho/eventos.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;GAMG;AAEH,uDAAuD;AACvD,SAAS,IAAI,CAAC,EAAU;IACtB,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED,6DAA6D;AAC7D,SAAS,OAAO,CAAC,CAAc;IAC7B,IAAI,CAAC,CAAC,MAAM,KAAK,eAAe,IAAI,CAAC,CAAC,MAAM,KAAK,gBAAgB;QAAE,OAAO,MAAM,CAAC;IACjF,IAAI,CAAC,CAAC,MAAM,KAAK,gBAAgB;QAAE,OAAO,MAAM,CAAC;IACjD,IAAI,CAAC,CAAC,MAAM,KAAK,gBAAgB,IAAI,CAAC,CAAC,MAAM,KAAK,gBAAgB;QAAE,OAAO,SAAS,CAAC;IACrF,IAAI,CAAC,CAAC,SAAS,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAQ,EAAE,OAAe,EAAE,MAAc;IACvE,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEtC,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAExE,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC;QAC5E,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/watch/desenho/largura.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Medir e cortar texto por COLUNA de terminal.
+ *
+ * R13 (`CONVENCOES.md`) garante acento em `titulo`, `objetivo` e `detalhe`. Em
+ * NFC o "ç" é um code point; em NFD são dois — e nome vindo do macOS chega em
+ * NFD. Medir com `String.length` erraria o corte em 80 colunas (decisão D-15).
+ *
+ * Normalizar para NFC resolve o caso real do método. Não tratamos largura
+ * dupla (CJK, emoji): a especificação proíbe emoji decorativo e a prosa do
+ * método é português. Um caractere de largura dupla contaria como uma coluna
+ * aqui — limitação conhecida, não acidente.
+ */
+/** Quantas colunas o texto ocupa. */
+export declare function largura(texto: string): number;
+/**
+ * Corta o texto para caber em `colunas`, com reticência quando sobra coisa.
+ *
+ * "Corta com elegância em vez de quebrar linha", como manda a especificação:
+ * quem lê num terminal estreito perde o fim da frase, nunca o alinhamento.
+ */
+export declare function cortar(texto: string, colunas: number): string;
+/** Completa com espaços à direita até `colunas`, cortando se passar. */
+export declare function preencher(texto: string, colunas: number): string;

package/dist/watch/desenho/largura.js

@@ -0,0 +1,42 @@
+/**
+ * Medir e cortar texto por COLUNA de terminal.
+ *
+ * R13 (`CONVENCOES.md`) garante acento em `titulo`, `objetivo` e `detalhe`. Em
+ * NFC o "ç" é um code point; em NFD são dois — e nome vindo do macOS chega em
+ * NFD. Medir com `String.length` erraria o corte em 80 colunas (decisão D-15).
+ *
+ * Normalizar para NFC resolve o caso real do método. Não tratamos largura
+ * dupla (CJK, emoji): a especificação proíbe emoji decorativo e a prosa do
+ * método é português. Um caractere de largura dupla contaria como uma coluna
+ * aqui — limitação conhecida, não acidente.
+ */
+/** Reticência de uma coluna, para marcar o que foi cortado. */
+const RETICENCIA = "…";
+/** Quantas colunas o texto ocupa. */
+export function largura(texto) {
+    // O spread itera por code point, não por unidade UTF-16: um par surrogate
+    // conta como um, e não como dois.
+    return [...texto.normalize("NFC")].length;
+}
+/**
+ * Corta o texto para caber em `colunas`, com reticência quando sobra coisa.
+ *
+ * "Corta com elegância em vez de quebrar linha", como manda a especificação:
+ * quem lê num terminal estreito perde o fim da frase, nunca o alinhamento.
+ */
+export function cortar(texto, colunas) {
+    if (colunas <= 0)
+        return "";
+    const normalizado = texto.normalize("NFC");
+    const pontos = [...normalizado];
+    if (pontos.length <= colunas)
+        return normalizado;
+    // -1 para a reticência, que também ocupa uma coluna
+    return pontos.slice(0, colunas - 1).join("") + RETICENCIA;
+}
+/** Completa com espaços à direita até `colunas`, cortando se passar. */
+export function preencher(texto, colunas) {
+    const cortado = cortar(texto, colunas);
+    return cortado + " ".repeat(Math.max(0, colunas - largura(cortado)));
+}
+//# sourceMappingURL=largura.js.map

package/dist/watch/desenho/largura.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"largura.js","sourceRoot":"","sources":["../../../src/watch/desenho/largura.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,+DAA+D;AAC/D,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,qCAAqC;AACrC,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,0EAA0E;IAC1E,kCAAkC;IAClC,OAAO,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa,EAAE,OAAe;IACnD,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAE5B,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;IAChC,IAAI,MAAM,CAAC,MAAM,IAAI,OAAO;QAAE,OAAO,WAAW,CAAC;IAEjD,oDAAoD;IACpD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC;AAC5D,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,OAAe;IACtD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACvC,OAAO,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/dist/watch/desenho/lista.d.ts

@@ -0,0 +1,9 @@
+import type { Visao } from "../visao/projetar.js";
+/**
+ * `expx watch --todos`: os trabalhos abertos, um por linha, sem a árvore.
+ *
+ * "Útil para quem tem várias ocorrências em paralelo." Aberto é todo status
+ * diferente de `concluido` (decisão D-16): `bloqueado` e `nao_iniciado` são
+ * exatamente o que a pessoa precisa ver numa lista de acompanhamento.
+ */
+export declare function desenharLista(v: Visao, colunas: number, cor: boolean): string[];

package/dist/watch/desenho/lista.js

@@ -0,0 +1,28 @@
+import { criarPintor } from "./cor.js";
+import { cortar } from "./largura.js";
+/**
+ * `expx watch --todos`: os trabalhos abertos, um por linha, sem a árvore.
+ *
+ * "Útil para quem tem várias ocorrências em paralelo." Aberto é todo status
+ * diferente de `concluido` (decisão D-16): `bloqueado` e `nao_iniciado` são
+ * exatamente o que a pessoa precisa ver numa lista de acompanhamento.
+ */
+export function desenharLista(v, colunas, cor) {
+    const pintar = criarPintor(cor);
+    if (v.abertos.length === 0) {
+        return [pintar(cortar("nenhum trabalho aberto", colunas), "apagado")];
+    }
+    const linhas = [pintar(cortar(`${String(v.abertos.length)} trabalhos abertos`, colunas), "apagado")];
+    for (const t of v.abertos) {
+        const tasks = t.sprints.flatMap((s) => s.tasks);
+        const feitas = tasks.filter((x) => x.status === "concluida").length;
+        const progresso = tasks.length > 0 ? ` · ${String(feitas)}/${String(tasks.length)}` : "";
+        const bloqueios = t.bloqueios.filter((b) => b.aberto).length;
+        const marcaBloqueio = bloqueios > 0 ? ` · ${String(bloqueios)} bloq` : "";
+        const papel = t.status === "bloqueado" ? "erro" : t.status === "em_andamento" ? "atencao" : "apagado";
+        const texto = `  ${t.trabalho_id} · ${t.expx_tool} · ${t.status}${progresso}${marcaBloqueio} · ${t.titulo}`;
+        linhas.push(pintar(cortar(texto, colunas), papel));
+    }
+    return linhas;
+}
+//# sourceMappingURL=lista.js.map

package/dist/watch/desenho/lista.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lista.js","sourceRoot":"","sources":["../../../src/watch/desenho/lista.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,CAAQ,EAAE,OAAe,EAAE,GAAY;IACnE,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAEhC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,wBAAwB,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAErG,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;QACpE,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzF,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;QAC7D,MAAM,aAAa,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAE1E,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QACtG,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,WAAW,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,MAAM,GAAG,SAAS,GAAG,aAAa,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5G,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/watch/fontes/cauda.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Lê apenas o fim de um arquivo de texto, em linhas completas.
+ *
+ * O rastro só rotaciona em 5 MB (contrato `expx-eventos`), e o watch relê a
+ * cada evento novo. Ler o arquivo inteiro todas as vezes é a "chamada externa
+ * cara" que a especificação proíbe — daí a decisão D-09 de ler só a cauda.
+ *
+ * O preço de ler pelo fim é cortar a primeira linha ao meio. Este módulo
+ * DESCARTA esse fragmento: quem consome recebe só linhas íntegras, e uma linha
+ * perdida no começo da janela é irrelevante para "as últimas N linhas".
+ */
+/** Teto de bytes lidos por arquivo. */
+export declare const LIMITE_CAUDA: number;
+export declare function lerCauda(caminho: string, limite?: number): string[];

package/dist/watch/fontes/cauda.js

@@ -0,0 +1,49 @@
+import { closeSync, openSync, readSync, statSync } from "node:fs";
+/**
+ * Lê apenas o fim de um arquivo de texto, em linhas completas.
+ *
+ * O rastro só rotaciona em 5 MB (contrato `expx-eventos`), e o watch relê a
+ * cada evento novo. Ler o arquivo inteiro todas as vezes é a "chamada externa
+ * cara" que a especificação proíbe — daí a decisão D-09 de ler só a cauda.
+ *
+ * O preço de ler pelo fim é cortar a primeira linha ao meio. Este módulo
+ * DESCARTA esse fragmento: quem consome recebe só linhas íntegras, e uma linha
+ * perdida no começo da janela é irrelevante para "as últimas N linhas".
+ */
+/** Teto de bytes lidos por arquivo. */
+export const LIMITE_CAUDA = 64 * 1024;
+export function lerCauda(caminho, limite = LIMITE_CAUDA) {
+    let fd;
+    try {
+        const tamanho = statSync(caminho).size;
+        if (tamanho === 0)
+            return [];
+        const inicio = Math.max(0, tamanho - limite);
+        const bytes = tamanho - inicio;
+        fd = openSync(caminho, "r");
+        const buf = Buffer.allocUnsafe(bytes);
+        readSync(fd, buf, 0, bytes, inicio);
+        const texto = buf.toString("utf8");
+        const linhas = texto.split("\n");
+        // Cortamos no meio do arquivo? Então a primeira linha é um fragmento do
+        // que veio antes da janela, e não um registro. Fora.
+        if (inicio > 0)
+            linhas.shift();
+        return linhas.filter((l) => l.trim() !== "");
+    }
+    catch {
+        // arquivo ausente, sem permissão, sumiu entre o stat e o open: sem rastro
+        return [];
+    }
+    finally {
+        if (fd !== undefined) {
+            try {
+                closeSync(fd);
+            }
+            catch {
+                // fechar não pode derrubar quem só queria ler
+            }
+        }
+    }
+}
+//# sourceMappingURL=cauda.js.map

package/dist/watch/fontes/cauda.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cauda.js","sourceRoot":"","sources":["../../../src/watch/fontes/cauda.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAElE;;;;;;;;;;GAUG;AAEH,uCAAuC;AACvC,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,GAAG,IAAI,CAAC;AAEtC,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,SAAiB,YAAY;IACrE,IAAI,EAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;QACvC,IAAI,OAAO,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAE7B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;QAE/B,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACtC,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAEpC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEjC,wEAAwE;QACxE,qDAAqD;QACrD,IAAI,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAE/B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;QAC1E,OAAO,EAAE,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,SAAS,CAAC,EAAE,CAAC,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACP,8CAA8C;YAChD,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}