expxdev 0.1.0

package/dist/doctor/verificadores.js

@@ -0,0 +1,158 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { lerLock } from "../nucleo/lock.js";
+import { verificarCaminhos } from "../nucleo/caminhos.js";
+import { expxNoGitignore } from "../cli/projeto.js";
+import { verificarModificacaoLocal, pastaDaSkill } from "../update/modificacao.js";
+import { MarketplaceJson, PluginJson, ORIGEM_DO_PLUGIN, NOME_DO_PLUGIN, NOME_DO_MARKETPLACE } from "../plugin/manifestos.js";
+import { lerPluginsHabilitados, caminhoDoSettings } from "../harness/settings.js";
+function lerJson(caminho) {
+    if (!existsSync(caminho))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(caminho, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+export function diagnosticar(raiz) {
+    const achados = [];
+    const push = (a) => {
+        achados.push(a);
+    };
+    // O .gitignore é verificado ANTES de exigir o .expx/: um .gitignore que
+    // ignora .expx/ é justamente a causa provável de ele não estar ali para quem
+    // clonou o repositório. Sair cedo esconderia o defeito que explica o resto.
+    if (expxNoGitignore(raiz)) {
+        push({
+            id: "gitignore-ignora-expx",
+            severidade: "erro",
+            problema: "o .gitignore esta ignorando .expx/, que precisa ser commitado",
+            correcao: "remova a linha .expx do .gitignore: quem clona o projeto depende dela",
+        });
+    }
+    if (!existsSync(join(raiz, ".expx"))) {
+        push({
+            id: "sem-expx",
+            severidade: "erro",
+            problema: "este projeto nao tem .expx/",
+            correcao: "rode `expx init` para instalar as skills neste projeto",
+        });
+        return { saudavel: false, achados };
+    }
+    const l = lerLock(raiz);
+    if (!l.ok) {
+        push({
+            id: "lock-ilegivel",
+            severidade: "erro",
+            problema: `o lock nao pode ser lido: ${l.erro}`,
+            correcao: "rode `expx init` para reconstruir a instalacao",
+        });
+        return { saudavel: false, achados };
+    }
+    if (l.incompativel) {
+        push({
+            id: "lock-futuro",
+            severidade: "erro",
+            problema: "o .expx/ foi criado por uma versao MAIS NOVA deste CLI",
+            correcao: "atualize o CLI (`npx expxdev@latest`) antes de operar este projeto",
+        });
+    }
+    const raizPlugin = join(raiz, ".expx", "marketplace", ORIGEM_DO_PLUGIN);
+    const pj = PluginJson.safeParse(lerJson(join(raizPlugin, ".claude-plugin", "plugin.json")));
+    if (!pj.success) {
+        push({
+            id: "plugin-json-invalido",
+            severidade: "erro",
+            problema: `plugin.json ausente ou fora do formato (esperado name "${NOME_DO_PLUGIN}")`,
+            correcao: "rode `expx init` para remontar o plugin",
+        });
+    }
+    const mj = MarketplaceJson.safeParse(lerJson(join(raiz, ".expx", "marketplace", ".claude-plugin", "marketplace.json")));
+    if (!mj.success) {
+        push({
+            id: "marketplace-json-invalido",
+            severidade: "erro",
+            problema: `marketplace.json ausente ou fora do formato (esperado name "${NOME_DO_MARKETPLACE}")`,
+            correcao: "rode `expx init` para remontar o marketplace",
+        });
+    }
+    for (const [nome, travada] of Object.entries(l.lock.skills)) {
+        const pasta = pastaDaSkill(raiz, nome);
+        if (!existsSync(pasta)) {
+            push({
+                id: "skill-ausente",
+                severidade: "erro",
+                problema: `${nome} esta no lock mas nao esta em disco`,
+                correcao: `rode \`expx init\` ou \`expx add ${nome}\` para reinstalar`,
+            });
+            continue;
+        }
+        const fora = verificarCaminhos(pasta);
+        if (fora.length > 0) {
+            const amostra = fora.slice(0, 3).map((a) => `${a.arquivo}:${String(a.linha)} → ${a.referencia}`);
+            push({
+                id: "caminho-fora",
+                severidade: "erro",
+                problema: `${nome} referencia caminho fora da propria pasta: ${amostra.join("; ")}`,
+                correcao: "o plugin e copiado para o cache e esse caminho nao resolve la: reporte no repositorio da skill",
+            });
+        }
+        const mod = verificarModificacaoLocal(raiz, nome);
+        if (mod.temModificacao) {
+            const lista = [...mod.alterados, ...mod.removidos, ...mod.novos].slice(0, 5);
+            push({
+                id: "modificacao-local",
+                severidade: "aviso",
+                problema: `${nome} foi modificada localmente: ${lista.join(", ")}`,
+                correcao: "o update nao vai sobrescrever; decida manter, substituir ou salvar ao lado",
+            });
+        }
+        if (!travada.travado) {
+            push({
+                id: "skill-nao-travada",
+                severidade: "aviso",
+                problema: `${nome} nao esta travada em versao publicada (segue a branch ${travada.referencia})`,
+                correcao: "quando o repositorio publicar uma tag, rode `expx update` para travar",
+            });
+        }
+    }
+    if (l.lock.harness.includes("claude")) {
+        const s = lerJson(caminhoDoSettings(raiz));
+        if (s === undefined) {
+            push({
+                id: "settings-ausente",
+                severidade: "erro",
+                problema: ".claude/settings.json ausente ou invalido",
+                correcao: "rode `expx init` para reescrever a configuracao do harness",
+            });
+        }
+        else {
+            const d = s;
+            const habilitados = lerPluginsHabilitados(d["enabledPlugins"]);
+            if (habilitados[`${NOME_DO_PLUGIN}@${NOME_DO_MARKETPLACE}`] !== true) {
+                push({
+                    id: "plugin-nao-habilitado",
+                    severidade: "erro",
+                    problema: "o plugin expx nao esta habilitado no .claude/settings.json",
+                    correcao: "rode `expx init` para habilitar",
+                });
+            }
+        }
+    }
+    const skillsClaude = join(raiz, ".claude", "skills");
+    const skillsOpen = join(raiz, ".opencode", "skills");
+    for (const nome of Object.keys(l.lock.skills)) {
+        if (existsSync(join(skillsClaude, nome)) && existsSync(join(skillsOpen, nome))) {
+            push({
+                id: "colisao-de-nome",
+                severidade: "erro",
+                problema: `${nome} existe em .claude/skills e em .opencode/skills, e o OpenCode le os dois`,
+                correcao: "remova a copia em .opencode/skills: o OpenCode le .claude/skills nativamente",
+            });
+        }
+    }
+    return { saudavel: achados.filter((a) => a.severidade === "erro").length === 0, achados };
+}
+//# sourceMappingURL=verificadores.js.map

package/dist/doctor/verificadores.js.map

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

package/dist/harness/backup.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Cópia datada antes de qualquer escrita em arquivo do usuário.
+ *
+ * O `settings.json` costuma conter configuração que a pessoa ajustou à mão e
+ * que não está em lugar nenhum além dali. Um merge com defeito sem backup é
+ * perda de trabalho irrecuperável.
+ */
+/** `AAAA-MM-DD` do relógio do sistema. */
+export declare function hojeISO(agora?: Date): string;
+/**
+ * Copia para `<arquivo>.backup-AAAA-MM-DD[-N]`. Devolve o caminho criado.
+ * Se já existe backup do dia, cria um sufixo numérico em vez de sobrescrever —
+ * o backup de ontem não pode ser destruído pelo erro de hoje.
+ */
+export declare function fazerBackup(arquivo: string, agora?: Date): string;

package/dist/harness/backup.js

@@ -0,0 +1,29 @@
+import { copyFileSync, existsSync } from "node:fs";
+/**
+ * Cópia datada antes de qualquer escrita em arquivo do usuário.
+ *
+ * O `settings.json` costuma conter configuração que a pessoa ajustou à mão e
+ * que não está em lugar nenhum além dali. Um merge com defeito sem backup é
+ * perda de trabalho irrecuperável.
+ */
+/** `AAAA-MM-DD` do relógio do sistema. */
+export function hojeISO(agora = new Date()) {
+    return agora.toISOString().slice(0, 10);
+}
+/**
+ * Copia para `<arquivo>.backup-AAAA-MM-DD[-N]`. Devolve o caminho criado.
+ * Se já existe backup do dia, cria um sufixo numérico em vez de sobrescrever —
+ * o backup de ontem não pode ser destruído pelo erro de hoje.
+ */
+export function fazerBackup(arquivo, agora = new Date()) {
+    const base = `${arquivo}.backup-${hojeISO(agora)}`;
+    let destino = base;
+    let n = 1;
+    while (existsSync(destino)) {
+        destino = `${base}-${String(n)}`;
+        n += 1;
+    }
+    copyFileSync(arquivo, destino);
+    return destino;
+}
+//# sourceMappingURL=backup.js.map

package/dist/harness/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../src/harness/backup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;;GAMG;AAEH,0CAA0C;AAC1C,MAAM,UAAU,OAAO,CAAC,QAAc,IAAI,IAAI,EAAE;IAC9C,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,QAAc,IAAI,IAAI,EAAE;IACnE,MAAM,IAAI,GAAG,GAAG,OAAO,WAAW,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;IACnD,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,GAAG,GAAG,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IACD,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/harness/instalar.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A instalação de fato do plugin no Claude Code.
+ *
+ * Declarar o marketplace em `.claude/settings.json` NÃO instala nada: cinco
+ * sintaxes foram testadas em execução e nenhuma carregou o plugin (o
+ * experimento está em `docs/expx-cli/base/09-validacao-marketplace-local.md`).
+ * Quem instala é o próprio `claude`, por estes dois comandos.
+ *
+ * Consequência para quem clona o repositório: como o `marketplace add` grava um
+ * caminho ABSOLUTO no settings do usuário, esse passo não viaja no commit —
+ * cada pessoa roda o `expx init` na própria máquina.
+ */
+export type ComandoExterno = {
+    bin: string;
+    args: string[];
+};
+export declare function comandosDeInstalacao(caminhoMarketplace: string): ComandoExterno[];
+/** O que dizer quando o binário `claude` não está disponível. */
+export declare function instrucaoManual(caminhoMarketplace: string): string;
+export type ResultadoInstalacao = {
+    ok: boolean;
+    executados: string[];
+    /** Quando o binário falta, o texto que o usuário precisa ver. */
+    instrucao?: string;
+    erro?: string;
+};
+/**
+ * Roda os dois comandos. Binário ausente NÃO é falha fatal: o `.expx/` já está
+ * montado e a instalação pode ser concluída à mão.
+ */
+export declare function instalarPlugin(caminhoMarketplace: string): Promise<ResultadoInstalacao>;

package/dist/harness/instalar.js

@@ -0,0 +1,43 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const exec = promisify(execFile);
+export function comandosDeInstalacao(caminhoMarketplace) {
+    return [
+        { bin: "claude", args: ["plugin", "marketplace", "add", caminhoMarketplace] },
+        { bin: "claude", args: ["plugin", "install", "expx@expx-local"] },
+    ];
+}
+/** O que dizer quando o binário `claude` não está disponível. */
+export function instrucaoManual(caminhoMarketplace) {
+    return [
+        "O binario `claude` nao foi encontrado no PATH.",
+        "O .expx/ foi montado e esta pronto; falta apenas registrar o plugin:",
+        "",
+        `  claude plugin marketplace add ${caminhoMarketplace}`,
+        "  claude plugin install expx@expx-local",
+        "",
+        "Rode os dois comandos acima e o namespace /expx: ficara disponivel.",
+    ].join("\n");
+}
+/**
+ * Roda os dois comandos. Binário ausente NÃO é falha fatal: o `.expx/` já está
+ * montado e a instalação pode ser concluída à mão.
+ */
+export async function instalarPlugin(caminhoMarketplace) {
+    const executados = [];
+    for (const c of comandosDeInstalacao(caminhoMarketplace)) {
+        try {
+            await exec(c.bin, c.args);
+            executados.push(`${c.bin} ${c.args.join(" ")}`);
+        }
+        catch (e) {
+            const msg = String(e);
+            if (msg.includes("ENOENT")) {
+                return { ok: false, executados, instrucao: instrucaoManual(caminhoMarketplace) };
+            }
+            return { ok: false, executados, erro: msg };
+        }
+    }
+    return { ok: true, executados };
+}
+//# sourceMappingURL=instalar.js.map

package/dist/harness/instalar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instalar.js","sourceRoot":"","sources":["../../src/harness/instalar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAiBjC,MAAM,UAAU,oBAAoB,CAAC,kBAA0B;IAC7D,OAAO;QACL,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,kBAAkB,CAAC,EAAE;QAC7E,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,iBAAiB,CAAC,EAAE;KAClE,CAAC;AACJ,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,eAAe,CAAC,kBAA0B;IACxD,OAAO;QACL,gDAAgD;QAChD,sEAAsE;QACtE,EAAE;QACF,mCAAmC,kBAAkB,EAAE;QACvD,yCAAyC;QACzC,EAAE;QACF,qEAAqE;KACtE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAUD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,kBAA0B;IAC7D,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,oBAAoB,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAC1B,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACnF,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAClC,CAAC"}

package/dist/harness/opencode.d.ts

@@ -0,0 +1,18 @@
+import type { SkillMontavel } from "../plugin/montagem.js";
+/**
+ * Materializa as skills e comandos onde o OpenCode os encontra.
+ *
+ * O namespace de plugin é do Claude Code; no OpenCode ele não existe. Por isso
+ * os comandos vão sem prefixo.
+ *
+ * As skills vão SOMENTE para `.claude/skills/`, que o OpenCode lê nativamente.
+ * Copiar também para `.opencode/skills/` criaria duas cópias do mesmo `name`
+ * nas pastas que o OpenCode varre, e a duplicata é resolvida por
+ * last-writer-wins com apenas um aviso no log — ou seja, silenciosamente. O
+ * `doctor` detecta essa colisão caso ela apareça por outro caminho.
+ *
+ * `commands/` no plural é a forma documentada. Os repositórios reais divergem
+ * entre `.opencode/command/` e `.opencode/commands/`; normalizar aqui evita
+ * projetos inconsistentes.
+ */
+export declare function materializarOpenCode(raizProjeto: string, skills: readonly SkillMontavel[]): void;

package/dist/harness/opencode.js

@@ -0,0 +1,32 @@
+import { cpSync, mkdirSync } from "node:fs";
+import { basename, join } from "node:path";
+/**
+ * Materializa as skills e comandos onde o OpenCode os encontra.
+ *
+ * O namespace de plugin é do Claude Code; no OpenCode ele não existe. Por isso
+ * os comandos vão sem prefixo.
+ *
+ * As skills vão SOMENTE para `.claude/skills/`, que o OpenCode lê nativamente.
+ * Copiar também para `.opencode/skills/` criaria duas cópias do mesmo `name`
+ * nas pastas que o OpenCode varre, e a duplicata é resolvida por
+ * last-writer-wins com apenas um aviso no log — ou seja, silenciosamente. O
+ * `doctor` detecta essa colisão caso ela apareça por outro caminho.
+ *
+ * `commands/` no plural é a forma documentada. Os repositórios reais divergem
+ * entre `.opencode/command/` e `.opencode/commands/`; normalizar aqui evita
+ * projetos inconsistentes.
+ */
+export function materializarOpenCode(raizProjeto, skills) {
+    const dirSkills = join(raizProjeto, ".claude", "skills");
+    const dirComandos = join(raizProjeto, ".opencode", "commands");
+    mkdirSync(dirSkills, { recursive: true });
+    mkdirSync(dirComandos, { recursive: true });
+    for (const s of skills) {
+        // O nome da pasta precisa continuar igual ao `name` do frontmatter: o
+        // OpenCode exige que os dois batam para descobrir a skill.
+        cpSync(s.raizSkill, join(dirSkills, s.nome), { recursive: true });
+        for (const c of s.comandos)
+            cpSync(c, join(dirComandos, basename(c)));
+    }
+}
+//# sourceMappingURL=opencode.js.map

package/dist/harness/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../src/harness/opencode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAG3C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAmB,EAAE,MAAgC;IACxF,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IAC/D,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,sEAAsE;QACtE,2DAA2D;QAC3D,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ;YAAE,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;AACH,CAAC"}

package/dist/harness/settings.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Merge do `.claude/settings.json` — o ponto mais fácil de errar.
+ *
+ * Regras: faz backup antes de tocar, mescla APENAS as chaves necessárias,
+ * preserva todo o resto, e nunca sobrescreve o arquivo inteiro. JSON inválido
+ * não é consertado: avisa e sai.
+ *
+ * Duas formas de `enabledPlugins` circulam: a documentação mostra um array
+ * (`["p@m"]`), e o arquivo que o Claude Code realmente escreve usa um objeto
+ * (`{"p@m": true}`) — medido em
+ * `docs/expx-cli/base/09-validacao-marketplace-local.md`. Ler as duas e
+ * escrever a segunda evita corromper o arquivo do usuário.
+ *
+ * ATENÇÃO: escrever estas chaves NÃO instala o plugin. Foi testado: cinco
+ * sintaxes em `settings.json` de projeto e nenhuma carregou. A instalação de
+ * fato é feita pelo `claude plugin install` (ver `src/harness/instalar.ts`).
+ */
+export type ResultadoMerge = {
+    ok: true;
+    criado: boolean;
+    backup?: string;
+} | {
+    ok: false;
+    erro: string;
+};
+export type Habilitados = Record<string, boolean>;
+/** Aceita array (documentado) ou objeto (real). Qualquer outra coisa vira `{}`. */
+export declare function lerPluginsHabilitados(valor: unknown): Habilitados;
+export declare function caminhoDoSettings(raizProjeto: string): string;
+/**
+ * Acrescenta o marketplace local e habilita o plugin, preservando o resto.
+ *
+ * `caminhoMarketplace` é absoluto de propósito: é o que o `claude plugin
+ * marketplace add` grava, e um caminho relativo não é resolvido aqui.
+ */
+export declare function mesclarSettings(raizProjeto: string, caminhoMarketplace: string): ResultadoMerge;

package/dist/harness/settings.js

@@ -0,0 +1,66 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { NOME_DO_MARKETPLACE, NOME_DO_PLUGIN } from "../plugin/manifestos.js";
+import { fazerBackup } from "./backup.js";
+/** Aceita array (documentado) ou objeto (real). Qualquer outra coisa vira `{}`. */
+export function lerPluginsHabilitados(valor) {
+    if (Array.isArray(valor)) {
+        const saida = {};
+        for (const item of valor)
+            if (typeof item === "string")
+                saida[item] = true;
+        return saida;
+    }
+    if (typeof valor === "object" && valor !== null) {
+        const saida = {};
+        for (const [k, v] of Object.entries(valor)) {
+            if (typeof v === "boolean")
+                saida[k] = v;
+        }
+        return saida;
+    }
+    return {};
+}
+export function caminhoDoSettings(raizProjeto) {
+    return join(raizProjeto, ".claude", "settings.json");
+}
+/**
+ * Acrescenta o marketplace local e habilita o plugin, preservando o resto.
+ *
+ * `caminhoMarketplace` é absoluto de propósito: é o que o `claude plugin
+ * marketplace add` grava, e um caminho relativo não é resolvido aqui.
+ */
+export function mesclarSettings(raizProjeto, caminhoMarketplace) {
+    const caminho = caminhoDoSettings(raizProjeto);
+    const existe = existsSync(caminho);
+    let atual = {};
+    let backup;
+    if (existe) {
+        try {
+            atual = JSON.parse(readFileSync(caminho, "utf8"));
+        }
+        catch (e) {
+            return {
+                ok: false,
+                erro: `${caminho} nao e JSON valido e nao sera alterado: ${String(e)}`,
+            };
+        }
+        if (typeof atual !== "object" || atual === null || Array.isArray(atual)) {
+            return { ok: false, erro: `${caminho} nao contem um objeto JSON` };
+        }
+        backup = fazerBackup(caminho);
+    }
+    const marketplaces = {
+        ...(atual["extraKnownMarketplaces"] ?? {}),
+        [NOME_DO_MARKETPLACE]: { source: { source: "directory", path: caminhoMarketplace } },
+    };
+    const habilitados = {
+        ...lerPluginsHabilitados(atual["enabledPlugins"]),
+        [`${NOME_DO_PLUGIN}@${NOME_DO_MARKETPLACE}`]: true,
+    };
+    const novo = { ...atual, extraKnownMarketplaces: marketplaces, enabledPlugins: habilitados };
+    mkdirSync(join(caminho, ".."), { recursive: true });
+    writeFileSync(caminho, `${JSON.stringify(novo, null, 2)}\n`);
+    return backup === undefined ? { ok: true, criado: !existe } : { ok: true, criado: !existe, backup };
+}
+//# sourceMappingURL=settings.js.map

package/dist/harness/settings.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @expx/painel — ponto de entrada do pacote.
+ *
+ * O painel é somente leitura: nunca escreve nos arquivos do projeto observado
+ * e nunca executa comando algum. Ver docs/expx-panel/ORQUESTRADOR.md.
+ */
+/** Versão do contrato expx-schema que este painel sabe ler. */
+export declare const VERSAO_SCHEMA_SUPORTADA = 1;

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @expx/painel — ponto de entrada do pacote.
+ *
+ * O painel é somente leitura: nunca escreve nos arquivos do projeto observado
+ * e nunca executa comando algum. Ver docs/expx-panel/ORQUESTRADOR.md.
+ */
+/** Versão do contrato expx-schema que este painel sabe ler. */
+export const VERSAO_SCHEMA_SUPORTADA = 1;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC"}

package/dist/nucleo/busca.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Traz os arquivos de uma skill para o disco, na referência alvo.
+ *
+ * Usa o `git` do sistema em vez da API do GitHub: assim a credencial já
+ * configurada na máquina atende repositório privado sem que o CLI jamais peça
+ * ou armazene token, e não há limite de requisição para esbarrar.
+ *
+ * Falha de rede ou repositório inacessível NUNCA lança: devolve `ok: false`
+ * nomeando a skill, porque uma skill indisponível não pode abortar a
+ * instalação das outras quatro.
+ */
+export type PedidoBusca = {
+    nome: string;
+    repositorio: string;
+    referencia: string;
+};
+export type ResultadoBusca = {
+    ok: true;
+    nome: string;
+    caminho: string;
+    commit: string;
+} | {
+    ok: false;
+    nome: string;
+    erro: string;
+};
+/** Clona só a referência pedida, com profundidade 1. Devolve a pasta temporária. */
+export declare function buscarSkill(p: PedidoBusca): Promise<ResultadoBusca>;

package/dist/nucleo/busca.js

@@ -0,0 +1,29 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+const exec = promisify(execFile);
+/** Clona só a referência pedida, com profundidade 1. Devolve a pasta temporária. */
+export async function buscarSkill(p) {
+    const destino = mkdtempSync(join(tmpdir(), `expx-busca-${p.nome}-`));
+    try {
+        await exec("git", [
+            "clone",
+            "--quiet",
+            "--depth",
+            "1",
+            "--branch",
+            p.referencia,
+            p.repositorio,
+            destino,
+        ]);
+        const { stdout } = await exec("git", ["rev-parse", "HEAD"], { cwd: destino });
+        return { ok: true, nome: p.nome, caminho: destino, commit: stdout.trim() };
+    }
+    catch (e) {
+        rmSync(destino, { recursive: true, force: true });
+        return { ok: false, nome: p.nome, erro: String(e) };
+    }
+}
+//# sourceMappingURL=busca.js.map

package/dist/nucleo/busca.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"busca.js","sourceRoot":"","sources":["../../src/nucleo/busca.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAwBjC,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,CAAc;IAC9C,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IACrE,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,EAAE;YAChB,OAAO;YACP,SAAS;YACT,SAAS;YACT,GAAG;YACH,UAAU;YACV,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,WAAW;YACb,OAAO;SACR,CAAC,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IAC7E,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/nucleo/caminhos.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Recusa skill que referencie arquivo fora da própria raiz.
+ *
+ * Isto não é precaução teórica: foi medido. Ao instalar, o Claude Code COPIA o
+ * plugin para `~/.claude/plugins/cache/<marketplace>/<plugin>/<versao>/`, e só
+ * a pasta do plugin vai junto — qualquer `../` sai da árvore copiada e aponta
+ * para o vazio. O experimento está em
+ * `docs/expx-cli/base/09-validacao-marketplace-local.md`.
+ *
+ * Hoje as cinco skills reais estão limpas; a verificação existe para pegar a
+ * regressão futura antes que ela chegue no usuário.
+ */
+export type Achado = {
+    /** Caminho do arquivo, relativo à raiz da skill. */
+    arquivo: string;
+    /** A referência infratora, como aparece no texto. */
+    referencia: string;
+    linha: number;
+};
+/** Lista as referências que saem da raiz da skill. Lista vazia = skill sadia. */
+export declare function verificarCaminhos(raizSkill: string): Achado[];

package/dist/nucleo/caminhos.js

@@ -0,0 +1,64 @@
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+const EXTENSOES = new Set([".md", ".json", ".yaml", ".yml", ".txt"]);
+const IGNORADAS = new Set([".git", "node_modules"]);
+/** `../algo`, com ou sem `./` na frente. */
+const PADRAO = /(?:^|[\s`'"(\[])((?:\.\/)?(?:\.\.\/)+[\w./-]+)/g;
+function arquivosDe(raiz) {
+    const saida = [];
+    const fila = [raiz];
+    while (fila.length > 0) {
+        const dir = fila.shift();
+        if (dir === undefined)
+            break;
+        let entradas;
+        try {
+            entradas = readdirSync(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const e of entradas) {
+            if (IGNORADAS.has(e))
+                continue;
+            const p = join(dir, e);
+            try {
+                if (statSync(p).isDirectory())
+                    fila.push(p);
+                else if ([...EXTENSOES].some((x) => e.endsWith(x)))
+                    saida.push(p);
+            }
+            catch {
+                // entrada sumiu entre o readdir e o stat: ignora
+            }
+        }
+    }
+    return saida;
+}
+/** Lista as referências que saem da raiz da skill. Lista vazia = skill sadia. */
+export function verificarCaminhos(raizSkill) {
+    const achados = [];
+    for (const arquivo of arquivosDe(raizSkill)) {
+        let texto;
+        try {
+            texto = readFileSync(arquivo, "utf8");
+        }
+        catch {
+            continue;
+        }
+        texto.split("\n").forEach((linha, i) => {
+            for (const m of linha.matchAll(PADRAO)) {
+                const ref = m[1];
+                if (ref === undefined)
+                    continue;
+                achados.push({
+                    arquivo: relative(raizSkill, arquivo),
+                    referencia: ref,
+                    linha: i + 1,
+                });
+            }
+        });
+    }
+    return achados;
+}
+//# sourceMappingURL=caminhos.js.map

package/dist/nucleo/caminhos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caminhos.js","sourceRoot":"","sources":["../../src/nucleo/caminhos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAuB3C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AACrE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;AAEpD,4CAA4C;AAC5C,MAAM,MAAM,GAAG,iDAAiD,CAAC;AAEjE,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IACpB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM;QAC7B,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,SAAS;YAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACvB,IAAI,CAAC;gBACH,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;oBAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;qBACvC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpE,CAAC;YAAC,MAAM,CAAC;gBACP,iDAAiD;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5C,IAAI,KAAa,CAAC;QAClB,IAAI,CAAC;YACH,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YACrC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjB,IAAI,GAAG,KAAK,SAAS;oBAAE,SAAS;gBAChC,OAAO,CAAC,IAAI,CAAC;oBACX,OAAO,EAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;oBACrC,UAAU,EAAE,GAAG;oBACf,KAAK,EAAE,CAAC,GAAG,CAAC;iBACb,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}