@joao.dadas/lume 0.0.0-stage → 0.4.0

package/README.md

@@ -1,3 +1,21 @@
-# Temporary Holding Version
+# @joao.dadas/lume
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Adoção do [lume](https://github.com/joaodadas/lume) por agente. Cole no seu agente (Claude Code, Codex, Cursor), na raiz do projeto, novo ou existente:
+
+```text
+Aplique o lume neste projeto: rode `npx -y @joao.dadas/lume@latest init` e siga exatamente o que ele responder, uma etapa por vez, até o `next` ser `pronto`.
+```
+
+## Comandos
+
+| Comando | O que faz |
+|---|---|
+| `lume init [--layout=sidebar\|offcanvas\|topbar] [--atualizar=sim\|nao]` | Uma etapa por chamada, em JSON (`etapa`, `next`, `say`, `instruction`, `run`, `rules`, `details`): layout, atualização (quando o pacote é mais novo que o `lume.json`), base, todos os componentes, skill, migração e pronto |
+| `lume check [--json]` | Confere o projeto contra a registry da versão do `lume.json`; sai 1 se houver violação |
+| `lume prompt` | Imprime o texto para colar no agente |
+
+Em projeto existente, o lume substitui a interface antiga de uma vez: sem pasta paralela, sem alias desviado e sem componente antigo com a aparência do lume. O `init` grava o `lume.json` (`versao` e `layout`), que é o sinal de adoção que o CI usa para rodar o `check`.
+
+Os componentes vêm da registry do shadcn (`joaodadas/lume/<item>#vX.Y.Z`); este pacote traz só o `init` e o `check`, sem dependência. As regras de cada verificação estão em [docs/adocao/comando-unico.md](https://github.com/joaodadas/lume/blob/main/docs/adocao/comando-unico.md).
+
+Apache-2.0.

package/bin/lume.mjs

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+// lume: adoção do lume por agente.
+//   lume init [--layout=sidebar|offcanvas|topbar] [--atualizar=sim|nao]
+//                                                   uma etapa por chamada, em JSON
+//   lume check [--json]                             confere o projeto; sai 1 se houver violação
+//   lume prompt                                     o texto para colar no agente
+
+import { readFileSync } from "node:fs";
+import { conferir, relatorio } from "../src/check.mjs";
+import { passo } from "../src/init.mjs";
+
+const pkg = JSON.parse(
+  readFileSync(new URL("../package.json", import.meta.url), "utf8"),
+);
+
+const PROMPT = `Aplique o lume neste projeto: rode \`npx -y @joao.dadas/lume@latest init\` e siga exatamente o que ele responder, uma etapa por vez, até o \`next\` ser \`pronto\`.`;
+
+function argumento(nome) {
+  const a = process.argv.find((x) => x.startsWith(`--${nome}=`));
+  return a ? a.slice(nome.length + 3) : undefined;
+}
+
+const comando = process.argv[2];
+const versao = argumento("versao") ?? process.env.LUME_VERSAO ?? pkg.version;
+const raiz = argumento("dir") ?? process.cwd();
+
+async function main() {
+  if (comando === "init") {
+    const r = await passo(raiz, {
+      versao,
+      layout: argumento("layout"),
+      atualizar: argumento("atualizar"),
+    });
+    process.stdout.write(`${JSON.stringify(r, null, 2)}\n`);
+    return 0;
+  }
+  if (comando === "check") {
+    const r = await conferir(raiz, {
+      versao: argumento("versao"),
+      versaoPadrao: pkg.version,
+    });
+    if (process.argv.includes("--json"))
+      process.stdout.write(`${JSON.stringify(r, null, 2)}\n`);
+    else process.stdout.write(`${relatorio(r)}\n`);
+    return r.ok ? 0 : 1;
+  }
+  if (comando === "prompt") {
+    process.stdout.write(`${PROMPT}\n`);
+    return 0;
+  }
+  if (comando === "--version" || comando === "-v") {
+    process.stdout.write(`${pkg.version}\n`);
+    return 0;
+  }
+  process.stdout.write(
+    [
+      `lume ${pkg.version}`,
+      "",
+      "  lume init [--layout=sidebar|offcanvas|topbar] [--atualizar=sim|nao]  adota o lume, uma etapa por chamada (JSON para o agente)",
+      "  lume check [--json]                            confere o projeto; sai 1 se houver violação",
+      "  lume prompt                                    o texto para colar no seu agente",
+      "",
+      PROMPT,
+      "",
+    ].join("\n"),
+  );
+  return comando ? 2 : 0;
+}
+
+main().then(
+  (codigo) => {
+    process.exitCode = codigo;
+  },
+  (erro) => {
+    process.stderr.write(`lume: ${erro.message}\n`);
+    process.exitCode = 2;
+  },
+);

package/package.json

@@ -1,6 +1,30 @@
 {
   "name": "@joao.dadas/lume",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.4.0",
+  "description": "Adoção do lume por agente: um init guiado, etapa por etapa, e um check que confere o projeto contra a registry.",
+  "type": "module",
+  "bin": {
+    "lume": "./bin/lume.mjs"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "Apache-2.0",
+  "homepage": "https://lume-ashmont.vercel.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/joaodadas/lume.git",
+    "directory": "cli"
+  },
+  "keywords": [
+    "lume",
+    "shadcn",
+    "design-system",
+    "agent"
+  ]
+}