expxdev 0.3.0 → 0.4.1

package/dist/cli/wizard.js

@@ -3,53 +3,104 @@ import { avaliarSelecao } from "./selecao.js";
 import { detectarProjeto } from "./projeto.js";
 import { HARNESS_VALIDOS } from "./init-flags.js";
 import { interpretarEscolhaMultipla, interpretarSimNao } from "./perguntar.js";
+import { pintar, secao, temCor } from "./visual.js";
 const TENTATIVAS = 3;
-function listarSkills(p) {
-    p.escrever("\nQuais skills instalar neste projeto?\n\n");
-    CATALOGO.forEach((s, i) => {
-        const marca = s.camada ? " (camada)" : "";
-        p.escrever(`  ${String(i + 1)}. ${s.nome}${marca} — ${s.papel}\n`);
-    });
-    p.escrever("\nResponda com os numeros separados por virgula (ex.: 1,5).\n");
+/** Cancelar no menu (Esc/Ctrl+C) vira erro; aqui vira "cancelado", não travamento. */
+function foiCancelado(e) {
+    return e instanceof Error && (e.name === "ExitPromptError" || e.name === "AbortPromptError");
 }
-async function escolherSkills(p) {
-    listarSkills(p);
+function rotuloDaSkill(nome, papel, camada, cor) {
+    const marca = camada ? ` ${pintar("(camada)", "cinza", cor)}` : "";
+    return `${pintar(nome, "branco", cor)}${marca}  ${pintar(papel, "cinza", cor)}`;
+}
+async function marcarSkills(p) {
+    const cor = temCor();
     for (let tentativa = 0; tentativa < TENTATIVAS; tentativa++) {
-        const resposta = await p.linha("skills: ");
-        const indices = interpretarEscolhaMultipla(resposta, CATALOGO.length);
-        if (indices === undefined) {
-            p.escrever(`numero invalido: responda entre 1 e ${String(CATALOGO.length)}\n`);
-            continue;
+        let selecao;
+        if (p.marcar !== undefined) {
+            const escolhido = await p.marcar({
+                titulo: "Quais skills instalar neste projeto?",
+                itens: CATALOGO.map((s) => ({
+                    valor: s.nome,
+                    rotulo: rotuloDaSkill(s.nome, s.papel, s.camada, cor),
+                })),
+            });
+            if (escolhido === undefined)
+                return undefined;
+            selecao = escolhido;
         }
-        if (indices.length === 0) {
-            p.escrever("nenhuma skill escolhida: escolha ao menos uma\n");
+        else {
+            const lido = await escolherPorNumero(p);
+            if (lido === undefined)
+                continue;
+            selecao = lido;
+        }
+        if (selecao.length === 0) {
+            p.escrever(`${pintar("nenhuma skill marcada: marque ao menos uma", "cinza", cor)}\n`);
             continue;
         }
-        const selecao = indices.map((i) => CATALOGO[i]?.nome ?? "");
         const aval = avaliarSelecao(selecao);
         // Aviso nunca impede: a combinação incomum pode ser exatamente a pedida.
         // O CLI explica a consequência e deixa a pessoa confirmar (selecao.ts).
         if (aval.precisaConfirmar) {
             for (const a of aval.avisos)
-                p.escrever(`\naviso: ${a}\n`);
-            const segue = interpretarSimNao(await p.linha("seguir assim mesmo? [s/N] "), false);
-            if (!segue) {
+                p.escrever(`\n${pintar("aviso:", "negrito", cor)} ${a}\n`);
+            if (!(await p.confirmar("seguir assim mesmo?", false))) {
                 p.escrever("\nescolha de novo:\n");
                 continue;
             }
         }
         for (const i of aval.integracoes) {
-            p.escrever(`integracao disponivel: ${i} se conecta com as skills escolhidas\n`);
+            p.escrever(`${pintar("integracao:", "azulClaro", cor)} ${i} se conecta com as skills escolhidas\n`);
         }
         return selecao;
     }
     return undefined;
 }
-async function escolherHarness(p) {
-    p.escrever("\nQual harness configurar?\n\n");
-    p.escrever("  1. claude — Claude Code\n");
-    p.escrever("  2. opencode — OpenCode\n");
-    p.escrever("\nOs dois: 1,2. Vazio usa claude.\n");
+/** O caminho sem navegação: a lista numerada e uma linha de resposta. */
+async function escolherPorNumero(p) {
+    const cor = temCor();
+    p.escrever(secao("Quais skills instalar neste projeto?", cor));
+    CATALOGO.forEach((s, i) => {
+        p.escrever(`  ${String(i + 1)}. ${rotuloDaSkill(s.nome, s.papel, s.camada, cor)}\n`);
+    });
+    p.escrever(`\n${pintar("numeros separados por virgula (ex.: 1,5)", "cinza", cor)}\n`);
+    const indices = interpretarEscolhaMultipla(await p.linha("skills: "), CATALOGO.length);
+    if (indices === undefined) {
+        p.escrever(`numero invalido: responda entre 1 e ${String(CATALOGO.length)}\n`);
+        return undefined;
+    }
+    return indices.map((i) => CATALOGO[i]?.nome ?? "");
+}
+async function marcarHarness(p) {
+    const cor = temCor();
+    const descricao = {
+        claude: "Claude Code",
+        opencode: "OpenCode",
+    };
+    if (p.marcar !== undefined) {
+        for (let tentativa = 0; tentativa < TENTATIVAS; tentativa++) {
+            const escolhido = await p.marcar({
+                titulo: "Qual harness configurar?",
+                itens: HARNESS_VALIDOS.map((h) => ({
+                    valor: h,
+                    rotulo: `${pintar(h, "branco", cor)}  ${pintar(descricao[h], "cinza", cor)}`,
+                    marcado: h === "claude",
+                })),
+            });
+            if (escolhido === undefined)
+                return undefined;
+            if (escolhido.length > 0)
+                return escolhido;
+            p.escrever(`${pintar("marque ao menos um harness", "cinza", cor)}\n`);
+        }
+        return undefined;
+    }
+    p.escrever(secao("Qual harness configurar?", cor));
+    HARNESS_VALIDOS.forEach((h, i) => {
+        p.escrever(`  ${String(i + 1)}. ${h} — ${descricao[h]}\n`);
+    });
+    p.escrever(`\n${pintar("os dois: 1,2. vazio usa claude.", "cinza", cor)}\n`);
     for (let tentativa = 0; tentativa < TENTATIVAS; tentativa++) {
         const resposta = await p.linha("harness [1]: ");
         if (resposta.trim() === "")
@@ -72,30 +123,45 @@ async function escolherHarness(p) {
 async function confirmarReconfiguracao(p, raiz) {
     if (!detectarProjeto(raiz).existe)
         return true;
-    p.escrever("\nEste projeto ja tem um .expx/ instalado.\n");
-    p.escrever("Seguir remonta a instalacao a partir da nova selecao, substituindo a atual.\n");
-    return interpretarSimNao(await p.linha("reconfigurar? [s/N] "), false);
+    const cor = temCor();
+    p.escrever(`\n${pintar("este projeto ja tem um .expx/ instalado", "negrito", cor)}\n`);
+    p.escrever(`${pintar("seguir remonta a instalacao a partir da nova selecao", "cinza", cor)}\n`);
+    return p.confirmar("reconfigurar?", false);
 }
 export async function executarWizard(p, parciais, raiz) {
-    if (!(await confirmarReconfiguracao(p, raiz))) {
-        return { ok: false, erro: "reconfiguracao cancelada: nada foi alterado" };
+    const cor = temCor();
+    try {
+        if (!(await confirmarReconfiguracao(p, raiz))) {
+            return { ok: false, erro: "reconfiguracao cancelada: nada foi alterado" };
+        }
+        const skills = parciais.skills.length > 0 ? parciais.skills : await marcarSkills(p);
+        if (skills === undefined)
+            return { ok: false, erro: "cancelado: nada foi alterado" };
+        const harness = parciais.harness.length > 0 ? parciais.harness : await marcarHarness(p);
+        if (harness === undefined)
+            return { ok: false, erro: "cancelado: nada foi alterado" };
+        const painel = parciais.painel
+            ? true
+            : await p.confirmar("instalar o painel como devDependency?", false);
+        p.escrever(secao("Resumo", cor));
+        p.escrever(`  skills   ${pintar(skills.join(", "), "branco", cor)}\n`);
+        p.escrever(`  harness  ${pintar(harness.join(", "), "branco", cor)}\n`);
+        if (painel)
+            p.escrever(`  painel   ${pintar("sim", "branco", cor)}\n`);
+        p.escrever("\n");
+        if (!(await p.confirmar("confirmar?", true))) {
+            return { ok: false, erro: "cancelado: nada foi alterado" };
+        }
+        return {
+            ok: true,
+            opcoes: { skills: [...skills], harness: [...harness], painel, sim: true, simular: parciais.simular },
+        };
     }
-    const skills = parciais.skills.length > 0 ? parciais.skills : await escolherSkills(p);
-    if (skills === undefined)
-        return { ok: false, erro: "selecao de skills invalida apos varias tentativas" };
-    const harness = parciais.harness.length > 0 ? parciais.harness : await escolherHarness(p);
-    if (harness === undefined)
-        return { ok: false, erro: "harness invalido apos varias tentativas" };
-    const painel = parciais.painel
-        ? true
-        : interpretarSimNao(await p.linha("\nInstalar o painel como devDependency? [s/N] "), false);
-    p.escrever(`\nvai instalar: ${skills.join(", ")}\n`);
-    p.escrever(`harness: ${harness.join(", ")}\n`);
-    if (painel)
-        p.escrever("painel: sim\n");
-    if (!interpretarSimNao(await p.linha("\nconfirmar? [S/n] "), true)) {
-        return { ok: false, erro: "cancelado: nada foi alterado" };
+    catch (e) {
+        if (foiCancelado(e))
+            return { ok: false, erro: "cancelado: nada foi alterado" };
+        throw e;
     }
-    return { ok: true, opcoes: { skills: [...skills], harness: [...harness], painel, sim: true, simular: parciais.simular } };
 }
+export { interpretarSimNao };
 //# sourceMappingURL=wizard.js.map

package/dist/cli/wizard.js.map

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

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"}

package/dist/watch/fontes/estado-schema.d.ts

@@ -0,0 +1,78 @@
+import { z } from "zod";
+/**
+ * Contrato `expx-estado` v1 — o arquivo que a barra de status lê.
+ *
+ * Primeiro leitor deste contrato no repositório: a busca por
+ * `estado.json|expx_estado` em `src/`, `ui/` e `nucleo/` não devolvia nada.
+ *
+ * Os enums vêm do `expx-schema` de propósito. A regra 7 do contrato manda que
+ * sejam os MESMOS ("minúsculo, sem acento; `e3`, não `E3`"), e redeclará-los
+ * aqui criaria duas listas que divergem com o tempo — foi exatamente assim que
+ * as listas de chaves do rastro divergiram entre duas skills
+ * (ver `src/parser/esquema/evento.ts`).
+ */
+/** A versão que este leitor entende. Diferente disso é degradado (D-12). */
+export declare const VERSAO_ESTADO = 1;
+/**
+ * As quinze chaves do contrato, na ordem do documento.
+ *
+ * Exportada porque o teste percorre a lista removendo uma por vez: sem ela, a
+ * verificação da R6 seria quinze blocos copiados.
+ */
+export declare const CHAVES_ESTADO: readonly ["expx_estado", "atualizado_em", "trabalho", "ferramenta", "titulo_curto", "fase", "task", "tasks_concluidas", "tasks_total", "raio", "orcamento_arquivos", "orcamento_linhas", "branch", "pr_estado", "bloqueios"];
+/** Faixa de raio do modo legado. `null` fora dele (regra 2 do contrato). */
+export declare const Raio: z.ZodEnum<{
+    baixo: "baixo";
+    medio: "medio";
+    alto: "alto";
+}>;
+/**
+ * Nenhum campo é `.optional()`: a regra 2 do contrato ("chave nunca omitida")
+ * é o que permite ao leitor distinguir "não se aplica" de "esqueceram de
+ * escrever". Ausente é `null`, e `null` é um valor presente.
+ *
+ * Sem `.passthrough()`: ao contrário do rastro, que declara chaves extras por
+ * skill, o `expx-estado` fixa quinze chaves e um limite de 1 KB. Chave a mais
+ * aqui é sinal de escritor fora do contrato, não de extensão legítima.
+ */
+export declare const EstadoExpx: z.ZodObject<{
+    expx_estado: z.ZodLiteral<1>;
+    atualizado_em: z.ZodString;
+    trabalho: z.ZodNullable<z.ZodString>;
+    ferramenta: z.ZodNullable<z.ZodEnum<{
+        sprintx: "sprintx";
+        runx: "runx";
+        mergex: "mergex";
+        legadox: "legadox";
+        stackx: "stackx";
+        memox: "memox";
+    }>>;
+    titulo_curto: z.ZodNullable<z.ZodString>;
+    fase: z.ZodNullable<z.ZodEnum<{
+        f1: "f1";
+        f2: "f2";
+        f3: "f3";
+        f4: "f4";
+        f5: "f5";
+        f6: "f6";
+        e1: "e1";
+        e2: "e2";
+        e3: "e3";
+        e4: "e4";
+        e5: "e5";
+    }>>;
+    task: z.ZodNullable<z.ZodString>;
+    tasks_concluidas: z.ZodNumber;
+    tasks_total: z.ZodNumber;
+    raio: z.ZodNullable<z.ZodEnum<{
+        baixo: "baixo";
+        medio: "medio";
+        alto: "alto";
+    }>>;
+    orcamento_arquivos: z.ZodNullable<z.ZodString>;
+    orcamento_linhas: z.ZodNullable<z.ZodString>;
+    branch: z.ZodNullable<z.ZodString>;
+    pr_estado: z.ZodNullable<z.ZodString>;
+    bloqueios: z.ZodNumber;
+}, z.core.$strip>;
+export type EstadoExpx = z.infer<typeof EstadoExpx>;

package/dist/watch/fontes/estado-schema.js

@@ -0,0 +1,72 @@
+import { z } from "zod";
+import { Estagio, Ferramenta } from "../../parser/esquema/enums.js";
+/**
+ * Contrato `expx-estado` v1 — o arquivo que a barra de status lê.
+ *
+ * Primeiro leitor deste contrato no repositório: a busca por
+ * `estado.json|expx_estado` em `src/`, `ui/` e `nucleo/` não devolvia nada.
+ *
+ * Os enums vêm do `expx-schema` de propósito. A regra 7 do contrato manda que
+ * sejam os MESMOS ("minúsculo, sem acento; `e3`, não `E3`"), e redeclará-los
+ * aqui criaria duas listas que divergem com o tempo — foi exatamente assim que
+ * as listas de chaves do rastro divergiram entre duas skills
+ * (ver `src/parser/esquema/evento.ts`).
+ */
+/** A versão que este leitor entende. Diferente disso é degradado (D-12). */
+export const VERSAO_ESTADO = 1;
+/**
+ * As quinze chaves do contrato, na ordem do documento.
+ *
+ * Exportada porque o teste percorre a lista removendo uma por vez: sem ela, a
+ * verificação da R6 seria quinze blocos copiados.
+ */
+export const CHAVES_ESTADO = [
+    "expx_estado",
+    "atualizado_em",
+    "trabalho",
+    "ferramenta",
+    "titulo_curto",
+    "fase",
+    "task",
+    "tasks_concluidas",
+    "tasks_total",
+    "raio",
+    "orcamento_arquivos",
+    "orcamento_linhas",
+    "branch",
+    "pr_estado",
+    "bloqueios",
+];
+/** Faixa de raio do modo legado. `null` fora dele (regra 2 do contrato). */
+export const Raio = z.enum(["baixo", "medio", "alto"]);
+/** Timestamp do contrato: ISO-8601 em UTC, com `Z` (R4). */
+const TimestampUtc = z
+    .string()
+    .regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/, "atualizado_em deve ser AAAA-MM-DDTHH:MM:SSZ");
+/**
+ * Nenhum campo é `.optional()`: a regra 2 do contrato ("chave nunca omitida")
+ * é o que permite ao leitor distinguir "não se aplica" de "esqueceram de
+ * escrever". Ausente é `null`, e `null` é um valor presente.
+ *
+ * Sem `.passthrough()`: ao contrário do rastro, que declara chaves extras por
+ * skill, o `expx-estado` fixa quinze chaves e um limite de 1 KB. Chave a mais
+ * aqui é sinal de escritor fora do contrato, não de extensão legítima.
+ */
+export const EstadoExpx = z.object({
+    expx_estado: z.literal(VERSAO_ESTADO),
+    atualizado_em: TimestampUtc,
+    trabalho: z.string().min(1).nullable(),
+    ferramenta: Ferramenta.nullable(),
+    titulo_curto: z.string().nullable(),
+    fase: Estagio.nullable(),
+    task: z.string().nullable(),
+    tasks_concluidas: z.number().int().min(0),
+    tasks_total: z.number().int().min(0),
+    raio: Raio.nullable(),
+    orcamento_arquivos: z.string().nullable(),
+    orcamento_linhas: z.string().nullable(),
+    branch: z.string().nullable(),
+    pr_estado: z.string().nullable(),
+    bloqueios: z.number().int().min(0),
+});
+//# sourceMappingURL=estado-schema.js.map

package/dist/watch/fontes/estado-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estado-schema.js","sourceRoot":"","sources":["../../../src/watch/fontes/estado-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEpE;;;;;;;;;;;GAWG;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,aAAa;IACb,eAAe;IACf,UAAU;IACV,YAAY;IACZ,cAAc;IACd,MAAM;IACN,MAAM;IACN,kBAAkB;IAClB,aAAa;IACb,MAAM;IACN,oBAAoB;IACpB,kBAAkB;IAClB,QAAQ;IACR,WAAW;IACX,WAAW;CACH,CAAC;AAEX,4EAA4E;AAC5E,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvD,4DAA4D;AAC5D,MAAM,YAAY,GAAG,CAAC;KACnB,MAAM,EAAE;KACR,KAAK,CACJ,wCAAwC,EACxC,6CAA6C,CAC9C,CAAC;AAEJ;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IACrC,aAAa,EAAE,YAAY;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,UAAU,EAAE,UAAU,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;IACrB,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACnC,CAAC,CAAC"}

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

@@ -0,0 +1,18 @@
+import { EstadoExpx } from "./estado-schema.js";
+/**
+ * Lê `.expx/estado.json` a partir da raiz do projeto.
+ *
+ * Falha SEMPRE para `null`, nunca lança. A regra 1 do contrato `expx-estado`
+ * declara o arquivo "derivado e descartável; apagá-lo não pode quebrar nada" —
+ * e o watch inteiro depende disso: a tolerância a falha "estado.json inválido
+ * cai para leitura direta do plano" é justamente este `null`.
+ *
+ * A leitura é de uma vez só porque o contrato exige escrita atômica (regra 3:
+ * temporário + rename). Não existe janela de leitura parcial: ou o arquivo
+ * antigo inteiro, ou o novo inteiro.
+ *
+ * Versão diferente de 1 é `null` de propósito (decisão D-12): o `EstadoExpx`
+ * declara `expx_estado: z.literal(1)`, então um arquivo de versão futura
+ * reprova no parse como qualquer outro defeito, e quem chama vai para o plano.
+ */
+export declare function lerEstadoExpx(raizProjeto: string): EstadoExpx | null;

package/dist/watch/fontes/estado.js

@@ -0,0 +1,38 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { EstadoExpx } from "./estado-schema.js";
+/**
+ * Lê `.expx/estado.json` a partir da raiz do projeto.
+ *
+ * Falha SEMPRE para `null`, nunca lança. A regra 1 do contrato `expx-estado`
+ * declara o arquivo "derivado e descartável; apagá-lo não pode quebrar nada" —
+ * e o watch inteiro depende disso: a tolerância a falha "estado.json inválido
+ * cai para leitura direta do plano" é justamente este `null`.
+ *
+ * A leitura é de uma vez só porque o contrato exige escrita atômica (regra 3:
+ * temporário + rename). Não existe janela de leitura parcial: ou o arquivo
+ * antigo inteiro, ou o novo inteiro.
+ *
+ * Versão diferente de 1 é `null` de propósito (decisão D-12): o `EstadoExpx`
+ * declara `expx_estado: z.literal(1)`, então um arquivo de versão futura
+ * reprova no parse como qualquer outro defeito, e quem chama vai para o plano.
+ */
+export function lerEstadoExpx(raizProjeto) {
+    let bruto;
+    try {
+        bruto = readFileSync(join(raizProjeto, ".expx", "estado.json"), "utf8");
+    }
+    catch {
+        return null; // ausente, sem permissão, é um diretório: tudo é "não há estado"
+    }
+    let dados;
+    try {
+        dados = JSON.parse(bruto);
+    }
+    catch {
+        return null;
+    }
+    const r = EstadoExpx.safeParse(dados);
+    return r.success ? r.data : null;
+}
+//# sourceMappingURL=estado.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"estado.js","sourceRoot":"","sources":["../../../src/watch/fontes/estado.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,IAAI,KAAa,CAAC;IAClB,IAAI,CAAC;QACH,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,iEAAiE;IAChF,CAAC;IAED,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,17 @@
+import { LinhaEvento } from "../../parser/esquema/evento.js";
+/**
+ * Lê as últimas linhas do rastro de um trabalho, da mais recente para a mais
+ * antiga.
+ *
+ * O que o repositório já tinha era `validarRastro`, que conta defeitos e não
+ * devolve evento nenhum. O schema `LinhaEvento` e os enums, esses sim, são
+ * reaproveitados inteiros: são a fonte única do vocabulário do contrato.
+ *
+ * Rotação: acima de 5 MB o arquivo corrente vira `<id>.1.jsonl` e um novo
+ * começa (contrato `expx-eventos`), e "o painel lê os dois". O `.1` é o mais
+ * ANTIGO — inverter isso mostraria o rastro fora de ordem logo após uma
+ * rotação, que é justamente quando ninguém está olhando com atenção.
+ */
+/** Quantas linhas o watch exibe por padrão (decisão D-09). */
+export declare const LINHAS_PADRAO = 10;
+export declare function lerRastro(raizProjeto: string, trabalhoId: string, limite?: number): LinhaEvento[];

package/dist/watch/fontes/rastro.js

@@ -0,0 +1,43 @@
+import { join } from "node:path";
+import { LinhaEvento } from "../../parser/esquema/evento.js";
+import { lerCauda } from "./cauda.js";
+/**
+ * Lê as últimas linhas do rastro de um trabalho, da mais recente para a mais
+ * antiga.
+ *
+ * O que o repositório já tinha era `validarRastro`, que conta defeitos e não
+ * devolve evento nenhum. O schema `LinhaEvento` e os enums, esses sim, são
+ * reaproveitados inteiros: são a fonte única do vocabulário do contrato.
+ *
+ * Rotação: acima de 5 MB o arquivo corrente vira `<id>.1.jsonl` e um novo
+ * começa (contrato `expx-eventos`), e "o painel lê os dois". O `.1` é o mais
+ * ANTIGO — inverter isso mostraria o rastro fora de ordem logo após uma
+ * rotação, que é justamente quando ninguém está olhando com atenção.
+ */
+/** Quantas linhas o watch exibe por padrão (decisão D-09). */
+export const LINHAS_PADRAO = 10;
+export function lerRastro(raizProjeto, trabalhoId, limite = LINHAS_PADRAO) {
+    const dir = join(raizProjeto, "docs", "eventos");
+    // corrente primeiro, rotacionado depois: os dois já vêm em ordem
+    // cronológica crescente dentro de cada arquivo.
+    const cronologicas = [
+        ...lerCauda(join(dir, `${trabalhoId}.1.jsonl`)),
+        ...lerCauda(join(dir, `${trabalhoId}.jsonl`)),
+    ];
+    const validas = [];
+    for (const bruta of cronologicas) {
+        let obj;
+        try {
+            obj = JSON.parse(bruta);
+        }
+        catch {
+            continue; // linha malformada não derruba o resto do rastro
+        }
+        const r = LinhaEvento.safeParse(obj);
+        if (r.success)
+            validas.push(r.data);
+    }
+    // as N mais recentes, já invertidas para exibição
+    return validas.slice(-limite).reverse();
+}
+//# sourceMappingURL=rastro.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rastro.js","sourceRoot":"","sources":["../../../src/watch/fontes/rastro.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;;;;GAYG;AAEH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEhC,MAAM,UAAU,SAAS,CACvB,WAAmB,EACnB,UAAkB,EAClB,SAAiB,aAAa;IAE9B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAEjD,iEAAiE;IACjE,gDAAgD;IAChD,MAAM,YAAY,GAAG;QACnB,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,UAAU,CAAC,CAAC;QAC/C,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,QAAQ,CAAC,CAAC;KAC9C,CAAC;IAEF,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,IAAI,GAAY,CAAC;QACjB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,CAAC,iDAAiD;QAC7D,CAAC;QACD,MAAM,CAAC,GAAG,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,CAAC,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,kDAAkD;IAClD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;AAC1C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expxdev",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "CLI do metodo Expx: instala, atualiza e opera o ecossistema de skills, e sobe o painel de operacao",
   "type": "module",
   "bin": {
@@ -29,6 +29,7 @@
   ],
   "license": "MIT",
   "dependencies": {
+    "@inquirer/prompts": "^8.7.0",
     "chokidar": "^5.0.0",
     "ws": "^8.18.0",
     "yaml": "^2.5.0",
@@ -41,7 +42,7 @@
     "@types/react": "^18.3.0",
     "@types/react-dom": "^18.3.0",
     "@types/ws": "^8.5.0",
-    "@vitejs/plugin-react": "^4.3.0",
+    "@vitejs/plugin-react": "^6.1.1",
     "gray-matter": "^4.0.3",
     "jsdom": "^25.0.0",
     "react": "^18.3.1",