expxdev 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Expx
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,137 @@
+# expxdev
+
+CLI do método Expx. Instala, atualiza e diagnostica o ecossistema de skills por projeto,
+e sobe o painel de operação que lê a pasta `docs/`.
+
+## Instalação das skills
+
+```bash
+npx expxdev init
+```
+
+O `init` busca as skills escolhidas nos repositórios oficiais, empacota as selecionadas
+como um plugin local chamado `expx` e configura o harness. Os comandos ficam com namespace
+no Claude Code (`/expx:sprintx-sprints`) e sem namespace no OpenCode (`/sprintx-sprints`).
+
+| Skill | O que faz |
+|---|---|
+| [`sprintx`](https://github.com/bittencourtthulio/sprintx) | planeja e executa features novas |
+| [`runx`](https://github.com/bittencourtthulio/runx) | ocorrências de manutenção do dia a dia |
+| [`legadox`](https://github.com/bittencourtthulio/legadox) | camada para projetos legados |
+| [`stackx`](https://github.com/bittencourtthulio/stackx) | descobre o dialeto técnico do repositório |
+| [`mergex`](https://github.com/bittencourtthulio/mergex) | versionamento, entrega e revisão de PRs |
+
+### Subcomandos
+
+| Comando | O que faz |
+|---|---|
+| `expx init` | instala as skills escolhidas neste projeto |
+| `expx panel` | sobe o painel lendo o `docs/` do projeto |
+| `expx add <skill...>` | acrescenta skills à seleção |
+| `expx remove <skill...>` | remove skills da seleção |
+| `expx update [skill...]` | atualiza as skills instaladas |
+| `expx doctor` | diagnostica uma instalação quebrada |
+
+O painel funciona sem `init`: ele não precisa de nada instalado.
+
+Flags do `init` (todas as perguntas têm equivalente por flag, para uso em script):
+`--skills sprintx,runx` · `--harness claude,opencode` · `--painel` · `--yes`
+
+Flags do `update`: `--check` (só mostra) · `--to <ref>` · `--latest` · `--yes`
+
+### Versão, lock e atualização
+
+A instalação é travada por `.expx/expx-lock.json`, que é **commitado** junto com `.expx/`.
+Quem clona o projeto recebe as skills já em disco. Por padrão o CLI busca a maior tag de
+versão semântica de cada repositório; sem nenhuma tag, segue a branch padrão e **avisa**
+que a skill não está travada em versão publicada.
+
+O `update` compara com o lock, mostra o que mudou e pede confirmação antes de aplicar.
+Se algum arquivo da skill foi alterado à mão, ele **não sobrescreve**: lista os arquivos e
+pede a decisão. Para desfazer uma atualização, reverta o `.expx/` pelo versionador.
+
+> **Registro do plugin no Claude Code.** Declarar o marketplace no `settings.json` do
+> projeto não instala o plugin — o `init` chama `claude plugin marketplace add` e
+> `claude plugin install`. Como esse registro grava um caminho absoluto na configuração do
+> usuário, ele não viaja no commit: cada pessoa roda `expx init` na própria máquina.
+
+---
+
+# O painel
+
+Lê a pasta `docs/` de um projeto, descobre os trabalhos gravados pelas skills
+[`sprintx`](https://github.com/bittencourtthulio/sprintx) e
+[`runx`](https://github.com/bittencourtthulio/runx), e mostra no navegador o que foi
+planejado, o que está em execução, o que travou e o histórico do que já foi entregue.
+
+**Somente leitura.** O painel nunca escreve nos arquivos do projeto e nunca executa comando algum.
+
+## Uso
+
+```bash
+npx expxdev panel
+```
+
+| Flag | Padrão | O que faz |
+|---|---|---|
+| `--porta <n>` | `4000` | porta do servidor local |
+| `--dir <caminho>` | `./docs` | pasta de documentação a observar |
+| `--no-open` | — | não abre o navegador |
+| `--dias-bloqueio <n>` | `7` | a partir de quantos dias um bloqueio aberto é "antigo" |
+| `--ajuda` | — | mostra a ajuda |
+
+## O que o painel mostra
+
+- **Visão global** — trabalhos em planejamento, execução, bloqueados e concluídos, separando feature de ocorrência; bloqueios abertos; ocorrências por tipo.
+- **Quadro por estágio** — 11 colunas (`f1`–`f6` da sprintx, `e1`–`e5` da runx), com filtro por ferramenta, tipo e status.
+- **Detalhe do trabalho** — sprints, fases e tasks com barra de progresso, dependências, destaque do paralelizável e do caminho crítico, bloqueios em evidência.
+- **Conformidade com o método** — violações mecanicamente detectáveis pelo frontmatter, cada uma apontando arquivo e linha.
+- **Histórico** — linha do tempo de `docs/relatorios/`, com busca por módulo e tipo. O relatório de uso fica em aba própria, com botão de copiar: é o texto que o suporte devolve ao cliente.
+- **Fora do schema** — arquivos que não puderam ser lidos, com o motivo. Nunca derrubam o servidor.
+
+## Segurança
+
+O servidor escuta **exclusivamente em `127.0.0.1`**. Não há flag, variável de ambiente ou
+opção que mude isso: o painel serve documentação interna sem autenticação nenhuma, e expô-la
+na rede local entregaria o conteúdo a qualquer um no mesmo Wi-Fi. Todo método HTTP que não
+seja `GET` responde `405`.
+
+## Desenvolvimento
+
+```bash
+npm install
+npm test          # 89 testes
+npm run build     # tsc strict + vite
+```
+
+O projeto segue o próprio método que ele exibe. O planejamento inteiro está em
+[`docs/expx-panel/`](docs/expx-panel/): base de conhecimento, decisões, plano de sprints,
+auditoria e orquestrador. Apontar o painel para o próprio `docs/` deste repositório é o
+teste de aceitação mais honesto que existe:
+
+```bash
+node dist/cli/principal.js --dir docs
+```
+
+### Arquitetura
+
+Três camadas, sem regra de negócio vazando para cima:
+
+```
+src/parser/      recebe um caminho, devolve objeto tipado + rejeições + violações
+src/servidor/    expõe a API de leitura, observa o disco, difunde por websocket
+ui/src/          consome a API e renderiza — nenhuma regra de negócio aqui
+```
+
+O parser é testável sozinho, contra `fixtures/` em disco: `projeto-ok` cobre os 13 kinds
+do contrato; `projeto-ruim` cobre YAML inválido, enum errado, chave ausente, versão de
+schema futura, pasta sem orquestrador e task paralelizável com dependência.
+
+### O contrato
+
+[`docs/contrato/CONTRATO-expx-schema-v1.md`](docs/contrato/CONTRATO-expx-schema-v1.md) é a
+referência do formato. Onde ele diverge do que as skills realmente gravam, o painel segue
+as **skills** — elas é que escrevem os arquivos que ele lê. As duas divergências estão
+registradas em [`docs/expx-panel/00-DECISOES.md`](docs/expx-panel/00-DECISOES.md) (D-01 e
+D-02) e o parser aceita o superconjunto, de modo que nenhum arquivo real se perde seja qual
+for o lado que venha a ser atualizado.

package/dist/cli/argumentos.d.ts

@@ -0,0 +1,22 @@
+/** Contrato de linha de comando do `expx-painel`. */
+export declare const PADROES: {
+    readonly porta: 4000;
+    readonly dir: "./docs";
+    readonly diasBloqueio: 7;
+};
+export type Opcoes = {
+    porta: number;
+    dir: string;
+    abrir: boolean;
+    diasBloqueio: number;
+    ajuda: boolean;
+};
+export type Resultado = {
+    ok: true;
+    opcoes: Opcoes;
+} | {
+    ok: false;
+    erro: string;
+};
+export declare function textoDeAjuda(): string;
+export declare function interpretar(argv: readonly string[]): Resultado;

package/dist/cli/argumentos.js

@@ -0,0 +1,85 @@
+/** Contrato de linha de comando do `expx-painel`. */
+export const PADROES = {
+    porta: 4000,
+    dir: "./docs",
+    diasBloqueio: 7,
+};
+const AJUDA = `
+expx-painel — painel de operacao do metodo Expx (somente leitura)
+
+  npx expx-painel [opcoes]
+
+  --porta <n>           porta do servidor local (padrao ${String(PADROES.porta)})
+  --dir <caminho>       pasta de documentacao a observar (padrao ${PADROES.dir})
+  --no-open             nao abrir o navegador automaticamente
+  --dias-bloqueio <n>   dias a partir dos quais um bloqueio e antigo (padrao ${String(PADROES.diasBloqueio)})
+  --ajuda               mostra esta ajuda
+
+O servidor escuta apenas em 127.0.0.1 e nunca escreve nos arquivos do projeto.
+`.trim();
+export function textoDeAjuda() {
+    return AJUDA;
+}
+function inteiro(valor, campo) {
+    if (valor === undefined)
+        return `${campo} exige um valor`;
+    const n = Number(valor);
+    if (!Number.isInteger(n))
+        return `${campo} exige um numero inteiro, recebeu ${JSON.stringify(valor)}`;
+    return n;
+}
+export function interpretar(argv) {
+    const opcoes = {
+        porta: PADROES.porta,
+        dir: PADROES.dir,
+        abrir: true,
+        diasBloqueio: PADROES.diasBloqueio,
+        ajuda: false,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const bruto = argv[i] ?? "";
+        const [nome, embutido] = bruto.includes("=")
+            ? [bruto.slice(0, bruto.indexOf("=")), bruto.slice(bruto.indexOf("=") + 1)]
+            : [bruto, undefined];
+        const proximo = () => embutido ?? argv[++i];
+        switch (nome) {
+            case "--porta": {
+                const n = inteiro(proximo(), "--porta");
+                if (typeof n === "string")
+                    return { ok: false, erro: n };
+                if (n < 0 || n > 65535)
+                    return { ok: false, erro: `--porta fora da faixa valida: ${String(n)}` };
+                opcoes.porta = n;
+                break;
+            }
+            case "--dir": {
+                const v = proximo();
+                if (v === undefined || v === "")
+                    return { ok: false, erro: "--dir exige um caminho" };
+                opcoes.dir = v;
+                break;
+            }
+            case "--dias-bloqueio": {
+                const n = inteiro(proximo(), "--dias-bloqueio");
+                if (typeof n === "string")
+                    return { ok: false, erro: n };
+                if (n < 0)
+                    return { ok: false, erro: "--dias-bloqueio nao pode ser negativo" };
+                opcoes.diasBloqueio = n;
+                break;
+            }
+            case "--no-open":
+                opcoes.abrir = false;
+                break;
+            case "--ajuda":
+            case "--help":
+            case "-h":
+                opcoes.ajuda = true;
+                break;
+            default:
+                return { ok: false, erro: `opcao desconhecida: ${nome}` };
+        }
+    }
+    return { ok: true, opcoes };
+}
+//# sourceMappingURL=argumentos.js.map

package/dist/cli/argumentos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"argumentos.js","sourceRoot":"","sources":["../../src/cli/argumentos.ts"],"names":[],"mappings":"AAAA,qDAAqD;AAErD,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,KAAK,EAAE,IAAI;IACX,GAAG,EAAE,QAAQ;IACb,YAAY,EAAE,CAAC;CACP,CAAC;AAcX,MAAM,KAAK,GAAG;;;;;0DAK4C,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;mEACZ,OAAO,CAAC,GAAG;;+EAEC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;;;;CAI1G,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,UAAU,YAAY;IAC1B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,OAAO,CAAC,KAAyB,EAAE,KAAa;IACvD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,GAAG,KAAK,iBAAiB,CAAC;IAC1D,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAAE,OAAO,GAAG,KAAK,qCAAqC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IACtG,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAuB;IACjD,MAAM,MAAM,GAAW;QACrB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,KAAK,EAAE,KAAK;KACb,CAAC;IAEF,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,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;YAC1C,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3E,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACvB,MAAM,OAAO,GAAG,GAAuB,EAAE,CAAC,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAEhE,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;gBACxC,IAAI,OAAO,CAAC,KAAK,QAAQ;oBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBACzD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK;oBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,iCAAiC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACjG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;gBACjB,MAAM;YACR,CAAC;YACD,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;gBACpB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;oBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC;gBACtF,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;gBACf,MAAM;YACR,CAAC;YACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACvB,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAC;gBAChD,IAAI,OAAO,CAAC,KAAK,QAAQ;oBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBACzD,IAAI,CAAC,GAAG,CAAC;oBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,uCAAuC,EAAE,CAAC;gBAC/E,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC;gBACxB,MAAM;YACR,CAAC;YACD,KAAK,WAAW;gBACd,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;gBACrB,MAAM;YACR,KAAK,SAAS,CAAC;YACf,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;gBACpB,MAAM;YACR;gBACE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,uBAAuB,IAAI,EAAE,EAAE,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC"}

package/dist/cli/expx-bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/expx-bin.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { executarExpx } from "./expx.js";
+/**
+ * Só roda quando executado como programa.
+ *
+ * Comparar `argv[1]` com `import.meta.url` diretamente NÃO funciona quando o
+ * pacote está instalado: o npm cria `node_modules/.bin/expx` como symlink, a
+ * igualdade falha e o CLI simplesmente não roda, sem erro nenhum. `realpath`
+ * resolve os dois lados para o mesmo caminho. É o mesmo cuidado que
+ * `principal.ts` já tomava.
+ */
+function executadoComoPrograma() {
+    const argv = process.argv[1];
+    if (argv === undefined)
+        return false;
+    const real = (p) => {
+        try {
+            return realpathSync(p);
+        }
+        catch {
+            return resolve(p);
+        }
+    };
+    return real(argv) === real(fileURLToPath(import.meta.url));
+}
+if (executadoComoPrograma()) {
+    executarExpx(process.argv.slice(2))
+        .then((codigo) => {
+        if (codigo !== 0)
+            process.exit(codigo);
+    })
+        .catch((e) => {
+        process.stderr.write(`erro no expx: ${String(e)}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=expx-bin.js.map

package/dist/cli/expx-bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expx-bin.js","sourceRoot":"","sources":["../../src/cli/expx-bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;;;GAQG;AACH,SAAS,qBAAqB;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE;QACjC,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC;IACF,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,IAAI,qBAAqB,EAAE,EAAE,CAAC;IAC5B,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAChC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QACf,IAAI,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/expx.d.ts

@@ -0,0 +1,13 @@
+/**
+ * O entrypoint do binário `expx`.
+ *
+ * A saída é injetável para que os testes leiam o que o comando escreveu sem
+ * capturar `process.stdout` global — captura global vaza entre testes que rodam
+ * em paralelo e produz falha intermitente.
+ */
+export type Saida = {
+    escrever?: (texto: string) => void;
+    escreverErro?: (texto: string) => void;
+};
+export type Executor = (resto: readonly string[], saida: Required<Saida>) => Promise<number>;
+export declare function executarExpx(argv: readonly string[], saida?: Saida): Promise<number>;

package/dist/cli/expx.js

@@ -0,0 +1,123 @@
+import { interpretarSubcomando, ajudaGeral } from "./subcomandos.js";
+import { principal as principalPainel } from "./principal.js";
+import { interpretarFlagsInit } from "./init-flags.js";
+import { executarInit } from "./init.js";
+import { adicionarSkills, removerSkills } from "./selecionar.js";
+import { interpretarFlagsUpdate, executarUpdate } from "../update/flags.js";
+import { diagnosticar } from "../doctor/verificadores.js";
+import { avaliarSelecao } from "./selecao.js";
+import { instalarPlugin } from "../harness/instalar.js";
+import { join } from "node:path";
+const EXECUTORES = {
+    panel: async (resto) => principalPainel(resto),
+    init: async (resto, saida) => {
+        const f = interpretarFlagsInit(resto);
+        if (!f.ok) {
+            saida.escreverErro(`${f.erro}\n`);
+            return 1;
+        }
+        const aval = avaliarSelecao(f.opcoes.skills);
+        if (!aval.permitido) {
+            saida.escreverErro(`${aval.erros.join("\n")}\n`);
+            return 1;
+        }
+        for (const a of aval.avisos)
+            saida.escrever(`aviso: ${a}\n`);
+        const interativo = process.stdout.isTTY === true;
+        if (!f.opcoes.sim && !interativo) {
+            saida.escrever(`instalaria: ${f.opcoes.skills.join(", ")}\nuse --yes para aplicar sem perguntar\n`);
+            return 0;
+        }
+        const harness = f.opcoes.harness.length > 0 ? f.opcoes.harness : ["claude"];
+        const r = await executarInit({ raiz: process.cwd(), skills: f.opcoes.skills, harness });
+        for (const a of r.avisos)
+            saida.escrever(`aviso: ${a}\n`);
+        for (const x of r.falhas)
+            saida.escreverErro(`falhou ${x.nome}: ${x.erro}\n`);
+        if (!r.ok)
+            return 1;
+        saida.escrever(`instaladas: ${r.instaladas.join(", ")}\n`);
+        if (harness.includes("claude")) {
+            const inst = await instalarPlugin(join(process.cwd(), ".expx", "marketplace"));
+            if (inst.instrucao !== undefined)
+                saida.escrever(`\n${inst.instrucao}\n`);
+            else if (inst.erro !== undefined)
+                saida.escreverErro(`nao foi possivel registrar o plugin: ${inst.erro}\n`);
+            else
+                saida.escrever("plugin registrado: os comandos /expx: estao disponiveis\n");
+        }
+        return 0;
+    },
+    add: async (resto, saida) => {
+        const r = await adicionarSkills({ raiz: process.cwd(), skills: resto });
+        if (!r.ok) {
+            saida.escreverErro(`${r.erro}\n`);
+            return 1;
+        }
+        saida.escrever(`selecao agora: ${r.selecao.join(", ")}\n`);
+        return 0;
+    },
+    remove: async (resto, saida) => {
+        const r = await removerSkills({ raiz: process.cwd(), skills: resto });
+        if (!r.ok) {
+            saida.escreverErro(`${r.erro}\n`);
+            return 1;
+        }
+        saida.escrever(`selecao agora: ${r.selecao.join(", ")}\n`);
+        return 0;
+    },
+    update: async (resto, saida) => {
+        const f = interpretarFlagsUpdate(resto);
+        if (!f.ok) {
+            saida.escreverErro(`${f.erro}\n`);
+            return 1;
+        }
+        const r = await executarUpdate({
+            raiz: process.cwd(),
+            skills: f.opcoes.skills,
+            check: f.opcoes.check,
+            latest: f.opcoes.latest,
+            sim: f.opcoes.sim,
+            interativo: process.stdout.isTTY === true,
+            ...(f.opcoes.to !== undefined ? { to: f.opcoes.to } : {}),
+        });
+        for (const m of r.mensagens)
+            saida.escrever(`${m}\n`);
+        for (const b of r.bloqueadas)
+            saida.escrever(`bloqueada ${b.nome}: ${b.motivo}\n`);
+        if (r.emDia.length > 0)
+            saida.escrever(`em dia: ${r.emDia.join(", ")}\n`);
+        return r.ok ? 0 : 1;
+    },
+    doctor: async (_resto, saida) => {
+        const d = diagnosticar(process.cwd());
+        if (d.achados.length === 0) {
+            saida.escrever("nenhum problema encontrado\n");
+            return 0;
+        }
+        for (const a of d.achados) {
+            saida.escrever(`[${a.severidade}] ${a.problema}\n  correcao: ${a.correcao}\n`);
+        }
+        return d.saudavel ? 0 : 1;
+    },
+};
+export async function executarExpx(argv, saida = {}) {
+    const escrever = saida.escrever ?? ((t) => process.stdout.write(t));
+    const escreverErro = saida.escreverErro ?? ((t) => process.stderr.write(t));
+    const r = interpretarSubcomando(argv);
+    if (!r.ok) {
+        escreverErro(`${r.erro}\n\n${ajudaGeral()}\n`);
+        return 1;
+    }
+    if (r.ajuda) {
+        escrever(`${ajudaGeral()}\n`);
+        return 0;
+    }
+    const executor = EXECUTORES[r.subcomando];
+    if (executor === undefined) {
+        escreverErro(`o subcomando ${r.subcomando} ainda nao esta disponivel nesta versao\n`);
+        return 1;
+    }
+    return executor(r.resto, { escrever, escreverErro });
+}
+//# sourceMappingURL=expx.js.map

package/dist/cli/expx.js.map

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

package/dist/cli/init-flags.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Flags do `init` — o equivalente não interativo de cada pergunta.
+ *
+ * Sem isto o `init` só existiria com um humano na frente do terminal, e o CLI
+ * ficaria inutilizável em script, CI ou container. A regra que acompanha:
+ * sem interatividade e sem `--yes`, o comando mostra o que faria e sai sem
+ * aplicar — nunca assume a resposta que não recebeu.
+ */
+export declare const HARNESS_VALIDOS: readonly ["claude", "opencode"];
+export type Harness = (typeof HARNESS_VALIDOS)[number];
+export type OpcoesInitCli = {
+    skills: string[];
+    harness: Harness[];
+    painel: boolean;
+    sim: boolean;
+    /** Mostra o que faria e sai sem escrever. */
+    simular: boolean;
+};
+export type ResultadoFlags = {
+    ok: true;
+    opcoes: OpcoesInitCli;
+} | {
+    ok: false;
+    erro: string;
+};
+export declare function interpretarFlagsInit(argv: readonly string[]): ResultadoFlags;
+/**
+ * Pode aplicar mudança sem perguntar?
+ *
+ * Só com `--yes` explícito ou com um terminal de verdade para responder. Em
+ * pipe/CI sem `--yes`, a resposta é não — e o chamador mostra o plano em vez
+ * de executá-lo.
+ */
+export declare function podeAplicarSemPerguntar(op: OpcoesInitCli, interativo: boolean): boolean;

package/dist/cli/init-flags.js

@@ -0,0 +1,83 @@
+/**
+ * Flags do `init` — o equivalente não interativo de cada pergunta.
+ *
+ * Sem isto o `init` só existiria com um humano na frente do terminal, e o CLI
+ * ficaria inutilizável em script, CI ou container. A regra que acompanha:
+ * sem interatividade e sem `--yes`, o comando mostra o que faria e sai sem
+ * aplicar — nunca assume a resposta que não recebeu.
+ */
+export const HARNESS_VALIDOS = ["claude", "opencode"];
+function ehHarness(v) {
+    return HARNESS_VALIDOS.includes(v);
+}
+/** `a,b` e a repetição da flag acumulam na mesma lista, sem duplicar. */
+function acumular(destino, valor) {
+    for (const parte of valor.split(",").map((p) => p.trim())) {
+        if (parte !== "" && !destino.includes(parte))
+            destino.push(parte);
+    }
+}
+export function interpretarFlagsInit(argv) {
+    const opcoes = {
+        skills: [],
+        harness: [],
+        painel: false,
+        sim: false,
+        simular: 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 "--skills": {
+                const v = proximo();
+                if (v === undefined || v === "")
+                    return { ok: false, erro: "--skills exige uma lista de skills" };
+                acumular(opcoes.skills, v);
+                break;
+            }
+            case "--harness": {
+                const v = proximo();
+                if (v === undefined || v === "")
+                    return { ok: false, erro: "--harness exige claude, opencode ou os dois" };
+                const lidos = [];
+                acumular(lidos, v);
+                for (const h of lidos) {
+                    if (!ehHarness(h))
+                        return { ok: false, erro: `harness desconhecido: ${h}` };
+                    if (!opcoes.harness.includes(h))
+                        opcoes.harness.push(h);
+                }
+                break;
+            }
+            case "--painel":
+                opcoes.painel = true;
+                break;
+            case "--yes":
+            case "--sim":
+                opcoes.sim = true;
+                break;
+            case "--check":
+            case "--simular":
+                opcoes.simular = true;
+                break;
+            default:
+                return { ok: false, erro: `opcao desconhecida em init: ${nome}` };
+        }
+    }
+    return { ok: true, opcoes };
+}
+/**
+ * Pode aplicar mudança sem perguntar?
+ *
+ * Só com `--yes` explícito ou com um terminal de verdade para responder. Em
+ * pipe/CI sem `--yes`, a resposta é não — e o chamador mostra o plano em vez
+ * de executá-lo.
+ */
+export function podeAplicarSemPerguntar(op, interativo) {
+    return op.sim || interativo;
+}
+//# sourceMappingURL=init-flags.js.map

package/dist/cli/init-flags.js.map

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

package/dist/cli/init.d.ts

@@ -0,0 +1,34 @@
+import { ORIGEM_DO_PLUGIN } from "../plugin/manifestos.js";
+/**
+ * O fluxo do `init`: busca, monta, configura e trava.
+ *
+ * Uma skill inacessível NUNCA aborta as outras — é reportada em `falhas` e a
+ * instalação segue com as que deram certo, porque perder a instalação inteira
+ * por causa de um repositório fora do ar é pior que uma instalação parcial
+ * declarada.
+ *
+ * A montagem inteira acontece dentro de `escreverAtomico`: ou o `.expx/` novo
+ * aparece completo, ou o anterior permanece intocado.
+ */
+export type OpcoesInit = {
+    raiz: string;
+    skills: readonly string[];
+    harness: readonly string[];
+    /** Origem de cada skill. Nos testes, repositórios locais; em produção, o catálogo. */
+    origens?: Record<string, string>;
+    /** Referência fixa por skill, quando o usuário pediu uma específica. */
+    referencias?: Record<string, string>;
+};
+export type Falha = {
+    nome: string;
+    erro: string;
+};
+export type ResultadoInit = {
+    ok: boolean;
+    instaladas: string[];
+    falhas: Falha[];
+    naoTravadas: string[];
+    avisos: string[];
+};
+export declare function executarInit(op: OpcoesInit): Promise<ResultadoInit>;
+export { ORIGEM_DO_PLUGIN };