expxdev 0.1.0

package/dist/servidor/painel.js

@@ -0,0 +1,49 @@
+import { WebSocketServer } from "ws";
+import { criarServidor } from "./http.js";
+import { observar } from "./observador.js";
+/**
+ * Junta servidor, observador e websocket.
+ *
+ * O websocket envia o ESTADO INTEIRO a cada atualização (decisão D-28), não
+ * um delta. O estado de um projeto documental é pequeno, e mandar tudo
+ * elimina a classe de bug em que servidor e tela discordam depois de uma
+ * mensagem perdida.
+ */
+export async function iniciarPainel(op) {
+    const servidor = await criarServidor({
+        raiz: op.raiz,
+        porta: op.porta,
+        ...(op.diasBloqueio !== undefined ? { diasBloqueio: op.diasBloqueio } : {}),
+        ...(op.estaticos !== undefined ? { estaticos: op.estaticos } : {}),
+    });
+    const wss = new WebSocketServer({ server: servidor.http, path: "/ws" });
+    function difundir(estado) {
+        const corpo = JSON.stringify({ tipo: "estado", estado });
+        for (const cliente of wss.clients) {
+            if (cliente.readyState === 1)
+                cliente.send(corpo);
+        }
+    }
+    // todo cliente recebe o estado atual assim que conecta
+    wss.on("connection", (cliente) => {
+        cliente.send(JSON.stringify({ tipo: "estado", estado: servidor.estado() }));
+    });
+    servidor.aoAtualizar(difundir);
+    const observador = await observar(op.raiz, () => {
+        servidor.recarregar();
+    }, op.debounceMs ?? 300);
+    return {
+        url: () => servidor.url(),
+        urlWebsocket: () => `${servidor.url().replace("http://", "ws://")}/ws`,
+        porta: () => servidor.endereco().port,
+        estado: () => servidor.estado(),
+        parar: async () => {
+            await observador.parar();
+            for (const c of wss.clients)
+                c.terminate();
+            await new Promise((ok) => wss.close(() => ok()));
+            await servidor.fechar();
+        },
+    };
+}
+//# sourceMappingURL=painel.js.map

package/dist/servidor/painel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"painel.js","sourceRoot":"","sources":["../../src/servidor/painel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAkB,MAAM,IAAI,CAAC;AACrD,OAAO,EAAE,aAAa,EAAuB,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAmB,MAAM,iBAAiB,CAAC;AAmB5D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAAgB;IAClD,MAAM,QAAQ,GAAmB,MAAM,aAAa,CAAC;QACnD,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,KAAK,EAAE,EAAE,CAAC,KAAK;QACf,GAAG,CAAC,EAAE,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,EAAE,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAExE,SAAS,QAAQ,CAAC,MAAoB;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACzD,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,OAAO,CAAC,UAAU,KAAK,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,OAAkB,EAAE,EAAE;QAC1C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAE/B,MAAM,UAAU,GAAe,MAAM,QAAQ,CAC3C,EAAE,CAAC,IAAI,EACP,GAAG,EAAE;QACH,QAAQ,CAAC,UAAU,EAAE,CAAC;IACxB,CAAC,EACD,EAAE,CAAC,UAAU,IAAI,GAAG,CACrB,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE;QACzB,YAAY,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK;QACtE,KAAK,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI;QACrC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE;QAC/B,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;YACzB,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO;gBAAE,CAAC,CAAC,SAAS,EAAE,CAAC;YAC3C,MAAM,IAAI,OAAO,CAAO,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACvD,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/teste/layouts-fixture.d.ts

@@ -0,0 +1,16 @@
+/**
+ * O trio de repositórios que a suíte usa para exercitar layout e versão.
+ *
+ * Os repositórios reais têm dois layouts distintos e nenhuma tag (ver
+ * `base/08-repositorios-reais.md`). O trio cobre os dois layouts e o caso sem
+ * tag, que hoje é o de TODAS as skills reais.
+ */
+export type Trio = {
+    /** Layout do sprintx/stackx/mergex: `.claude/skills/<nome>/`. */
+    embutido: string;
+    /** Layout do runx/legadox: `skill/` na raiz. */
+    plano: string;
+    /** Repositório sem nenhuma tag — o caso real de hoje. */
+    semTag: string;
+};
+export declare function criarTrioDeLayouts(): Trio;

package/dist/teste/layouts-fixture.js

@@ -0,0 +1,9 @@
+import { criarRepoSkill } from "./repo-fixture.js";
+export function criarTrioDeLayouts() {
+    return {
+        embutido: criarRepoSkill({ nome: "sprintx", tags: ["v1.0.0", "v1.2.0"], layout: "embutido" }),
+        plano: criarRepoSkill({ nome: "runx", tags: ["v0.9.0"], layout: "plano" }),
+        semTag: criarRepoSkill({ nome: "stackx", tags: [], layout: "embutido" }),
+    };
+}
+//# sourceMappingURL=layouts-fixture.js.map

package/dist/teste/layouts-fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layouts-fixture.js","sourceRoot":"","sources":["../../src/teste/layouts-fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAkBnD,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,QAAQ,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAC7F,KAAK,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC1E,MAAM,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;KACzE,CAAC;AACJ,CAAC"}

package/dist/teste/projeto-temporario.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Pasta isolada para testes que escrevem em disco.
+ *
+ * O CLI escreve de verdade (`.expx/`, `.claude/settings.json`), então testá-lo
+ * exige um projeto real, não um mock de fs. Copiar a fixture para uma pasta
+ * temporária mantém as fixtures do repositório intactas: um teste que
+ * sobrescreve a origem contamina todos os outros.
+ */
+export type ProjetoTemporario = {
+    raiz: string;
+    descartar: () => void;
+};
+/** Cria a pasta; com `origem`, copia o conteúdo dela para dentro. */
+export declare function projetoTemporario(origem?: string): ProjetoTemporario;

package/dist/teste/projeto-temporario.js

@@ -0,0 +1,16 @@
+import { cpSync, mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+/** Cria a pasta; com `origem`, copia o conteúdo dela para dentro. */
+export function projetoTemporario(origem) {
+    const raiz = mkdtempSync(join(tmpdir(), "expx-projeto-"));
+    if (origem !== undefined)
+        cpSync(origem, raiz, { recursive: true });
+    return {
+        raiz,
+        descartar: () => {
+            rmSync(raiz, { recursive: true, force: true });
+        },
+    };
+}
+//# sourceMappingURL=projeto-temporario.js.map

package/dist/teste/projeto-temporario.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projeto-temporario.js","sourceRoot":"","sources":["../../src/teste/projeto-temporario.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAejC,qEAAqE;AACrE,MAAM,UAAU,iBAAiB,CAAC,MAAe;IAC/C,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;IAC1D,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,GAAG,EAAE;YACd,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/teste/repo-fixture.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Repositórios git locais no lugar da rede.
+ *
+ * A suíte precisa exercitar resolução de versão e busca de skill sem tocar o
+ * GitHub: sem rede a suíte não roda em CI offline, e com rede ela depende do
+ * estado de um repositório que ninguém controla. Um repositório local de
+ * verdade — não um mock — exercita o mesmo `git` que a implementação usa.
+ */
+/** Os dois layouts reais dos repositórios de skill (ver base/08-repositorios-reais.md). */
+export type Layout = "embutido" | "plano";
+export type OpcoesRepo = {
+    nome: string;
+    tags: readonly string[];
+    layout?: Layout;
+    /** Conteúdo extra do SKILL.md, para fixtures que precisam de um corpo específico. */
+    corpo?: string;
+};
+/**
+ * Onde o SKILL.md e os comandos ficam em cada layout. `embutido` é o do
+ * sprintx/stackx/mergex; `plano` é o do runx/legadox.
+ */
+export declare function caminhosDoLayout(nome: string, layout: Layout): {
+    skill: string;
+    comandos: string;
+};
+/** Cria um repositório git local com a skill e as tags pedidas. Devolve o caminho. */
+export declare function criarRepoSkill(op: OpcoesRepo): string;

package/dist/teste/repo-fixture.js

@@ -0,0 +1,49 @@
+import { execFileSync } from "node:child_process";
+import { mkdtempSync, mkdirSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+function git(cwd, ...args) {
+    execFileSync("git", [...args], {
+        cwd,
+        stdio: "ignore",
+        env: {
+            ...process.env,
+            GIT_AUTHOR_NAME: "expx",
+            GIT_AUTHOR_EMAIL: "expx@example.invalid",
+            GIT_COMMITTER_NAME: "expx",
+            GIT_COMMITTER_EMAIL: "expx@example.invalid",
+        },
+    });
+}
+/**
+ * Onde o SKILL.md e os comandos ficam em cada layout. `embutido` é o do
+ * sprintx/stackx/mergex; `plano` é o do runx/legadox.
+ */
+export function caminhosDoLayout(nome, layout) {
+    return layout === "embutido"
+        ? { skill: join(".claude", "skills", nome), comandos: join(".claude", "commands") }
+        : { skill: "skill", comandos: "commands" };
+}
+/** Cria um repositório git local com a skill e as tags pedidas. Devolve o caminho. */
+export function criarRepoSkill(op) {
+    const layout = op.layout ?? "embutido";
+    const raiz = mkdtempSync(join(tmpdir(), `expx-repo-${op.nome}-`));
+    const { skill, comandos } = caminhosDoLayout(op.nome, layout);
+    mkdirSync(join(raiz, skill, "references"), { recursive: true });
+    mkdirSync(join(raiz, comandos), { recursive: true });
+    writeFileSync(join(raiz, skill, "SKILL.md"), op.corpo ??
+        `---\nname: ${op.nome}\ndescription: Skill de fixture ${op.nome} para a suite do expx-cli\n---\n\n# ${op.nome}\n\nDetalhe em \`references/01.md\`.\n`);
+    writeFileSync(join(raiz, skill, "references", "01.md"), `# referencia de ${op.nome}\n`);
+    writeFileSync(join(raiz, comandos, `${op.nome}.md`), `---\ndescription: comando ${op.nome}\n---\n\nInvoque a skill \`${op.nome}\`.\n`);
+    git(raiz, "init", "-q", "-b", "main");
+    git(raiz, "add", "-A");
+    git(raiz, "commit", "-q", "-m", `${op.nome}: commit inicial`);
+    for (const tag of op.tags) {
+        writeFileSync(join(raiz, skill, "references", "01.md"), `# referencia de ${op.nome} em ${tag}\n`);
+        git(raiz, "add", "-A");
+        git(raiz, "commit", "-q", "-m", `${op.nome}: ${tag}`);
+        git(raiz, "tag", tag);
+    }
+    return raiz;
+}
+//# sourceMappingURL=repo-fixture.js.map

package/dist/teste/repo-fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-fixture.js","sourceRoot":"","sources":["../../src/teste/repo-fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAsBjC,SAAS,GAAG,CAAC,GAAW,EAAE,GAAG,IAAuB;IAClD,YAAY,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE;QAC7B,GAAG;QACH,KAAK,EAAE,QAAQ;QACf,GAAG,EAAE;YACH,GAAG,OAAO,CAAC,GAAG;YACd,eAAe,EAAE,MAAM;YACvB,gBAAgB,EAAE,sBAAsB;YACxC,kBAAkB,EAAE,MAAM;YAC1B,mBAAmB,EAAE,sBAAsB;SAC5C;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,MAAc;IAC3D,OAAO,MAAM,KAAK,UAAU;QAC1B,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE;QACnF,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAC/C,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,cAAc,CAAC,EAAc;IAC3C,MAAM,MAAM,GAAW,EAAE,CAAC,MAAM,IAAI,UAAU,CAAC;IAC/C,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAClE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE9D,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAErD,aAAa,CACX,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,EAC7B,EAAE,CAAC,KAAK;QACN,cAAc,EAAE,CAAC,IAAI,mCAAmC,EAAE,CAAC,IAAI,uCAAuC,EAAE,CAAC,IAAI,wCAAwC,CACxJ,CAAC;IACF,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC;IACxF,aAAa,CACX,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,KAAK,CAAC,EACrC,6BAA6B,EAAE,CAAC,IAAI,8BAA8B,EAAE,CAAC,IAAI,OAAO,CACjF,CAAC;IAEF,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACvB,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,kBAAkB,CAAC,CAAC;IAE9D,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QAC1B,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC,IAAI,OAAO,GAAG,IAAI,CAAC,CAAC;QAClG,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QACvB,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC;QACtD,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/update/comparar.d.ts

@@ -0,0 +1,33 @@
+/**
+ * O que mudaria num `update`, antes de aplicar qualquer coisa.
+ *
+ * Separar a comparação da aplicação é o que permite o `--check` e o resumo
+ * mostrado antes da confirmação: o usuário decide vendo o que vai acontecer, e
+ * não descobrindo depois.
+ */
+export type ItemComparacao = {
+    nome: string;
+    atual: string;
+    nova: string;
+    emDia: boolean;
+    travado: boolean;
+    /** CHANGELOG quando existir; senão, títulos dos commits entre as referências. */
+    mudancas: string[];
+    erro?: string;
+};
+export type Comparacao = {
+    ok: true;
+    itens: ItemComparacao[];
+    aAplicar: ItemComparacao[];
+} | {
+    ok: false;
+    erro: string;
+};
+export type OpcoesComparar = {
+    raiz: string;
+    /** Limita a comparação a estas skills; vazio compara todas as instaladas. */
+    somente?: readonly string[];
+    origens?: Record<string, string>;
+    referencias?: Record<string, string>;
+};
+export declare function compararComRemoto(op: OpcoesComparar): Promise<Comparacao>;

package/dist/update/comparar.js

@@ -0,0 +1,67 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { CATALOGO } from "../nucleo/catalogo.js";
+import { lerLock } from "../nucleo/lock.js";
+import { resolverAlvo } from "../nucleo/versao.js";
+const exec = promisify(execFile);
+function origemDe(nome, lockRepo, origens) {
+    return origens?.[nome] ?? lockRepo ?? CATALOGO.find((s) => s.nome === nome)?.repositorio ?? "";
+}
+/**
+ * Os títulos dos commits entre duas referências.
+ *
+ * Lê do repositório remoto por clone raso do intervalo. Falha aqui nunca
+ * derruba o update: sem o resumo, o usuário ainda pode decidir pela versão.
+ */
+async function mudancasEntre(repositorio, de, para) {
+    try {
+        const { stdout } = await exec("git", [
+            "-c", "core.pager=cat",
+            "log", "--format=%s", `${de}..${para}`,
+        ], { cwd: repositorio });
+        return stdout.split("\n").map((l) => l.trim()).filter((l) => l !== "");
+    }
+    catch {
+        return [];
+    }
+}
+export async function compararComRemoto(op) {
+    const l = lerLock(op.raiz);
+    if (!l.ok)
+        return { ok: false, erro: l.erro };
+    if (l.incompativel) {
+        return {
+            ok: false,
+            erro: "o .expx/ deste projeto foi criado por uma versao MAIS NOVA do CLI: atualize o expx antes de continuar",
+        };
+    }
+    const itens = [];
+    const alvos = Object.entries(l.lock.skills).filter(([nome]) => op.somente === undefined || op.somente.length === 0 || op.somente.includes(nome));
+    for (const [nome, travada] of alvos) {
+        const repositorio = origemDe(nome, travada.repositorio, op.origens);
+        const alvo = await resolverAlvo(repositorio, op.referencias?.[nome]);
+        if (!alvo.ok) {
+            itens.push({
+                nome,
+                atual: travada.referencia,
+                nova: travada.referencia,
+                emDia: true,
+                travado: travada.travado,
+                mudancas: [],
+                erro: alvo.erro ?? "repositorio inacessivel",
+            });
+            continue;
+        }
+        const emDia = alvo.referencia === travada.referencia;
+        itens.push({
+            nome,
+            atual: travada.referencia,
+            nova: alvo.referencia,
+            emDia,
+            travado: alvo.travado,
+            mudancas: emDia ? [] : await mudancasEntre(repositorio, travada.referencia, alvo.referencia),
+        });
+    }
+    return { ok: true, itens, aAplicar: itens.filter((i) => !i.emDia && i.erro === undefined) };
+}
+//# sourceMappingURL=comparar.js.map

package/dist/update/comparar.js.map

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

package/dist/update/compatibilidade.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Recusa skill que exija uma versão de `expx-schema` que este CLI não entende.
+ *
+ * Nenhuma das cinco skills declara essa versão hoje: o frontmatter delas tem só
+ * `name` e `description`. Como o CLI nunca escreve skill, ele não pode
+ * acrescentar a chave — então a AUSÊNCIA precisa ser válida e significar a
+ * versão 1, a única publicada. Uma skill futura que precise de mais passa a
+ * declarar `expx_schema:` e este CLI a bloqueia em vez de instalar algo que o
+ * painel não sabe ler.
+ */
+export type Compatibilidade = {
+    compativel: boolean;
+    exigido: number;
+    suportado: number;
+    motivo?: string;
+};
+/** Lê `expx_schema` do frontmatter do SKILL.md. Ausente ou ilegível = 1. */
+export declare function lerSchemaDaSkill(raizSkill: string): number;
+export declare function avaliarCompatibilidade(raizSkill: string, suportado?: number): Compatibilidade;

package/dist/update/compatibilidade.js

@@ -0,0 +1,36 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { VERSAO_SCHEMA_SUPORTADA } from "../index.js";
+/** Lê `expx_schema` do frontmatter do SKILL.md. Ausente ou ilegível = 1. */
+export function lerSchemaDaSkill(raizSkill) {
+    const caminho = join(raizSkill, "SKILL.md");
+    if (!existsSync(caminho))
+        return 1;
+    let bruto;
+    try {
+        bruto = readFileSync(caminho, "utf8");
+    }
+    catch {
+        return 1;
+    }
+    const bloco = /^---\r?\n([\s\S]*?)\r?\n---/.exec(bruto);
+    if (bloco === null)
+        return 1;
+    const linha = /^expx_schema:\s*(\d+)\s*$/m.exec(bloco[1] ?? "");
+    if (linha === null)
+        return 1;
+    const n = Number(linha[1]);
+    return Number.isInteger(n) && n > 0 ? n : 1;
+}
+export function avaliarCompatibilidade(raizSkill, suportado = VERSAO_SCHEMA_SUPORTADA) {
+    const exigido = lerSchemaDaSkill(raizSkill);
+    if (exigido <= suportado)
+        return { compativel: true, exigido, suportado };
+    return {
+        compativel: false,
+        exigido,
+        suportado,
+        motivo: `a skill exige expx-schema ${String(exigido)} e este CLI suporta ate ${String(suportado)}: e preciso atualizar o CLI antes de instalar esta versao`,
+    };
+}
+//# sourceMappingURL=compatibilidade.js.map

package/dist/update/compatibilidade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibilidade.js","sourceRoot":"","sources":["../../src/update/compatibilidade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAoBtD,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,CAAC,CAAC;IACnC,IAAI,KAAa,CAAC;IAClB,IAAI,CAAC;QACH,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,6BAA6B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChE,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,SAAiB,EACjB,YAAoB,uBAAuB;IAE3C,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC5C,IAAI,OAAO,IAAI,SAAS;QAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAC1E,OAAO;QACL,UAAU,EAAE,KAAK;QACjB,OAAO;QACP,SAAS;QACT,MAAM,EAAE,6BAA6B,MAAM,CAAC,OAAO,CAAC,2BAA2B,MAAM,CAAC,SAAS,CAAC,2DAA2D;KAC5J,CAAC;AACJ,CAAC"}

package/dist/update/flags.d.ts

@@ -0,0 +1,47 @@
+/**
+ * O `update`: descobre, mostra, confirma e aplica — nessa ordem.
+ *
+ * Rollback ficou por conta do versionador, e não por cópia da versão anterior
+ * dentro de `.expx/`. Como `.expx/` é commitado, `git checkout` devolve a
+ * versão antiga; em troca dessa simplificação, o CLI é OBRIGADO a dizer isso em
+ * toda execução que aplica alguma coisa, para que ninguém descubra a ausência
+ * do comando de desfazer no pior momento.
+ */
+export declare const AVISO_ROLLBACK = "para desfazer esta atualizacao, reverta o .expx/ pelo versionador (ex.: git checkout -- .expx)";
+export type OpcoesUpdateCli = {
+    skills: string[];
+    check: boolean;
+    to?: string;
+    latest: boolean;
+    sim: boolean;
+};
+export type ResultadoFlagsUpdate = {
+    ok: true;
+    opcoes: OpcoesUpdateCli;
+} | {
+    ok: false;
+    erro: string;
+};
+export declare function interpretarFlagsUpdate(argv: readonly string[]): ResultadoFlagsUpdate;
+export type OpcoesUpdate = {
+    raiz: string;
+    skills?: readonly string[];
+    check?: boolean;
+    to?: string;
+    latest?: boolean;
+    sim?: boolean;
+    interativo?: boolean;
+    origens?: Record<string, string>;
+};
+export type ResultadoUpdate = {
+    ok: boolean;
+    aplicou: boolean;
+    atualizadas: string[];
+    emDia: string[];
+    bloqueadas: Array<{
+        nome: string;
+        motivo: string;
+    }>;
+    mensagens: string[];
+};
+export declare function executarUpdate(op: OpcoesUpdate): Promise<ResultadoUpdate>;

package/dist/update/flags.js

@@ -0,0 +1,123 @@
+import { lerLock } from "../nucleo/lock.js";
+import { executarInit } from "../cli/init.js";
+import { compararComRemoto } from "./comparar.js";
+import { verificarModificacaoLocal } from "./modificacao.js";
+/**
+ * O `update`: descobre, mostra, confirma e aplica — nessa ordem.
+ *
+ * Rollback ficou por conta do versionador, e não por cópia da versão anterior
+ * dentro de `.expx/`. Como `.expx/` é commitado, `git checkout` devolve a
+ * versão antiga; em troca dessa simplificação, o CLI é OBRIGADO a dizer isso em
+ * toda execução que aplica alguma coisa, para que ninguém descubra a ausência
+ * do comando de desfazer no pior momento.
+ */
+export const AVISO_ROLLBACK = "para desfazer esta atualizacao, reverta o .expx/ pelo versionador (ex.: git checkout -- .expx)";
+export function interpretarFlagsUpdate(argv) {
+    const opcoes = { skills: [], check: false, latest: false, sim: false };
+    for (let i = 0; i < argv.length; i++) {
+        const bruto = argv[i] ?? "";
+        const igual = bruto.indexOf("=");
+        const nome = igual === -1 ? bruto : bruto.slice(0, igual);
+        const embutido = igual === -1 ? undefined : bruto.slice(igual + 1);
+        const proximo = () => embutido ?? argv[++i];
+        switch (nome) {
+            case "--check":
+                opcoes.check = true;
+                break;
+            case "--latest":
+                opcoes.latest = true;
+                break;
+            case "--yes":
+            case "--sim":
+                opcoes.sim = true;
+                break;
+            case "--to": {
+                const v = proximo();
+                if (v === undefined || v === "")
+                    return { ok: false, erro: "--to exige uma tag ou commit" };
+                opcoes.to = v;
+                break;
+            }
+            default:
+                if (nome.startsWith("-"))
+                    return { ok: false, erro: `opcao desconhecida em update: ${nome}` };
+                opcoes.skills.push(nome);
+        }
+    }
+    if (opcoes.to !== undefined && opcoes.skills.length !== 1) {
+        return { ok: false, erro: "--to exige exatamente uma skill nomeada" };
+    }
+    return { ok: true, opcoes };
+}
+export async function executarUpdate(op) {
+    const mensagens = [];
+    const bloqueadas = [];
+    const l = lerLock(op.raiz);
+    if (!l.ok) {
+        return { ok: false, aplicou: false, atualizadas: [], emDia: [], bloqueadas: [], mensagens: [l.erro] };
+    }
+    const referencias = op.to !== undefined && op.skills?.[0] !== undefined ? { [op.skills[0]]: op.to } : undefined;
+    const comparacao = await compararComRemoto({
+        raiz: op.raiz,
+        ...(op.skills !== undefined ? { somente: op.skills } : {}),
+        ...(op.origens !== undefined ? { origens: op.origens } : {}),
+        ...(referencias !== undefined ? { referencias } : {}),
+    });
+    if (!comparacao.ok) {
+        return { ok: false, aplicou: false, atualizadas: [], emDia: [], bloqueadas: [], mensagens: [comparacao.erro] };
+    }
+    const emDia = comparacao.itens.filter((i) => i.emDia).map((i) => i.nome);
+    const candidatas = [];
+    for (const item of comparacao.aAplicar) {
+        // Trabalho manual nunca é sobrescrito por um comando de rotina.
+        const mod = verificarModificacaoLocal(op.raiz, item.nome);
+        if (mod.temModificacao) {
+            bloqueadas.push({
+                nome: item.nome,
+                motivo: `modificacao local em: ${[...mod.alterados, ...mod.removidos].join(", ")}`,
+            });
+            continue;
+        }
+        candidatas.push(item);
+    }
+    for (const i of comparacao.itens) {
+        if (i.erro !== undefined)
+            bloqueadas.push({ nome: i.nome, motivo: i.erro });
+    }
+    for (const i of candidatas) {
+        mensagens.push(`${i.nome}: ${i.atual} → ${i.nova}${i.mudancas.length > 0 ? ` (${String(i.mudancas.length)} mudanca(s))` : ""}`);
+    }
+    const podeAplicar = (op.sim ?? false) || (op.interativo ?? false);
+    if (op.check === true || candidatas.length === 0 || !podeAplicar) {
+        if (op.check !== true && candidatas.length > 0 && !podeAplicar) {
+            mensagens.push("sem confirmacao disponivel: nada foi aplicado (use --yes para aplicar sem perguntar)");
+        }
+        return { ok: true, aplicou: false, atualizadas: [], emDia, bloqueadas, mensagens };
+    }
+    // Remonta do zero com as versões novas, mantendo a seleção e o harness.
+    const selecao = Object.keys(l.lock.skills);
+    const alvos = {};
+    for (const c of candidatas)
+        alvos[c.nome] = c.nova;
+    for (const [nome, travada] of Object.entries(l.lock.skills)) {
+        if (alvos[nome] === undefined)
+            alvos[nome] = travada.referencia;
+    }
+    const init = await executarInit({
+        raiz: op.raiz,
+        skills: selecao,
+        harness: l.lock.harness,
+        referencias: alvos,
+        ...(op.origens !== undefined ? { origens: op.origens } : {}),
+    });
+    mensagens.push(AVISO_ROLLBACK);
+    return {
+        ok: init.ok,
+        aplicou: true,
+        atualizadas: candidatas.map((c) => c.nome),
+        emDia,
+        bloqueadas,
+        mensagens,
+    };
+}
+//# sourceMappingURL=flags.js.map

package/dist/update/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../src/update/flags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAuB,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,cAAc,GACzB,gGAAgG,CAAC;AAcnG,MAAM,UAAU,sBAAsB,CAAC,IAAuB;IAC5D,MAAM,MAAM,GAAoB,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IAExF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACnE,MAAM,OAAO,GAAG,GAAuB,EAAE,CAAC,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAEhE,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,SAAS;gBACZ,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;gBACpB,MAAM;YACR,KAAK,UAAU;gBACb,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;gBACrB,MAAM;YACR,KAAK,OAAO,CAAC;YACb,KAAK,OAAO;gBACV,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC;gBAClB,MAAM;YACR,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;gBACpB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;oBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,8BAA8B,EAAE,CAAC;gBAC5F,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;gBACd,MAAM;YACR,CAAC;YACD;gBACE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;oBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,iCAAiC,IAAI,EAAE,EAAE,CAAC;gBAC9F,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,yCAAyC,EAAE,CAAC;IACxE,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC;AAsBD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EAAgB;IACnD,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,UAAU,GAA4C,EAAE,CAAC;IAE/D,MAAM,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACV,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;IACxG,CAAC;IAED,MAAM,WAAW,GAAG,EAAE,CAAC,EAAE,KAAK,SAAS,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAChH,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC;QACzC,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,GAAG,CAAC,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,EAAE,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC,CAAC;IACH,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;QACnB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;IACjH,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACzE,MAAM,UAAU,GAAqB,EAAE,CAAC;IAExC,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACvC,gEAAgE;QAChE,MAAM,GAAG,GAAG,yBAAyB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC;YACvB,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,yBAAyB,CAAC,GAAG,GAAG,CAAC,SAAS,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACnF,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClI,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC;IAClE,IAAI,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjE,IAAI,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/D,SAAS,CAAC,IAAI,CAAC,sFAAsF,CAAC,CAAC;QACzG,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;IACrF,CAAC;IAED,wEAAwE;IACxE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,UAAU;QAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IACnD,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5D,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAClE,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC;QAC9B,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO;QACvB,WAAW,EAAE,KAAK;QAClB,GAAG,CAAC,EAAE,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7D,CAAC,CAAC;IAEH,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC/B,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1C,KAAK;QACL,UAAU;QACV,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/update/modificacao.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Impede que o `update` apague trabalho manual.
+ *
+ * Quem ajustou uma skill à mão não pode perder o ajuste por rodar um comando de
+ * rotina. Quando o disco diverge do lock, o update NÃO sobrescreve: lista os
+ * arquivos e devolve a decisão para quem está no comando.
+ */
+export type OpcaoDecisao = {
+    id: string;
+    rotulo: string;
+};
+/** As três saídas oferecidas quando há modificação local. */
+export declare const OPCOES_DE_DECISAO: readonly OpcaoDecisao[];
+export type Verificacao = {
+    temModificacao: boolean;
+    alterados: string[];
+    removidos: string[];
+    novos: string[];
+    erro?: string;
+};
+/** A pasta onde a skill instalada vive dentro do projeto. */
+export declare function pastaDaSkill(raizProjeto: string, nome: string): string;
+export declare function verificarModificacaoLocal(raizProjeto: string, nome: string): Verificacao;

package/dist/update/modificacao.js

@@ -0,0 +1,36 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { lerLock } from "../nucleo/lock.js";
+import { compararComHashes } from "../nucleo/integridade.js";
+import { ORIGEM_DO_PLUGIN } from "../plugin/manifestos.js";
+/** As três saídas oferecidas quando há modificação local. */
+export const OPCOES_DE_DECISAO = [
+    { id: "manter", rotulo: "manter o local e nao atualizar esta skill" },
+    { id: "substituir", rotulo: "substituir pelo novo, descartando a alteracao local" },
+    { id: "salvar-ao-lado", rotulo: "salvar o local ao lado antes de substituir" },
+];
+/** A pasta onde a skill instalada vive dentro do projeto. */
+export function pastaDaSkill(raizProjeto, nome) {
+    return join(raizProjeto, ".expx", "marketplace", ORIGEM_DO_PLUGIN, "skills", nome);
+}
+export function verificarModificacaoLocal(raizProjeto, nome) {
+    const vazio = { temModificacao: false, alterados: [], removidos: [], novos: [] };
+    const l = lerLock(raizProjeto);
+    if (!l.ok)
+        return { ...vazio, erro: l.erro };
+    const travada = l.lock.skills[nome];
+    if (travada === undefined)
+        return { ...vazio, erro: `${nome} nao esta no lock deste projeto` };
+    const pasta = pastaDaSkill(raizProjeto, nome);
+    if (!existsSync(pasta)) {
+        return { ...vazio, temModificacao: true, erro: `${nome} esta no lock mas nao esta em disco` };
+    }
+    const d = compararComHashes(pasta, travada.arquivos);
+    return {
+        temModificacao: !d.limpo,
+        alterados: d.alterados,
+        removidos: d.removidos,
+        novos: d.novos,
+    };
+}
+//# sourceMappingURL=modificacao.js.map

package/dist/update/modificacao.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modificacao.js","sourceRoot":"","sources":["../../src/update/modificacao.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAY3D,6DAA6D;AAC7D,MAAM,CAAC,MAAM,iBAAiB,GAA4B;IACxD,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,2CAA2C,EAAE;IACrE,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,qDAAqD,EAAE;IACnF,EAAE,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,4CAA4C,EAAE;CACtE,CAAC;AAUX,6DAA6D;AAC7D,MAAM,UAAU,YAAY,CAAC,WAAmB,EAAE,IAAY;IAC5D,OAAO,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,WAAmB,EAAE,IAAY;IACzE,MAAM,KAAK,GAAgB,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAE9F,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC,CAAC,EAAE;QAAE,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAE7C,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,iCAAiC,EAAE,CAAC;IAE/F,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,qCAAqC,EAAE,CAAC;IAChG,CAAC;IAED,MAAM,CAAC,GAAG,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrD,OAAO;QACL,cAAc,EAAE,CAAC,CAAC,CAAC,KAAK;QACxB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,KAAK,EAAE,CAAC,CAAC,KAAK;KACf,CAAC;AACJ,CAAC"}