@unbox-plus/cli 0.20.4 → 0.20.5

package/README.md

@@ -12,7 +12,7 @@ neutros), cores e nome da loja.
 Navegue até a pasta onde queira criar o projeto e rode:
 
 ```bash
-npx @unbox-plus/cli create-unbox-store
+npx --package=@unbox-plus/cli create-unbox-store
 ```
 
 O `npx` roda o CLI direto do pacote publicado no NPM, sem instalar nada global.
@@ -76,7 +76,7 @@ node bin/cli.js
 ## Uso não-interativo (scripts/CI)
 
 ```bash
-npx @unbox-plus/cli create-unbox-store minha-loja --yes --no-install
+npx --package=@unbox-plus/cli create-unbox-store minha-loja --yes --no-install
 ```
 
 Gera com as cores/nome default e o estilo **essencial** — use `--estilo <nome>`

package/bin/cli.js

@@ -129,7 +129,7 @@ function printHelp() {
   create-unbox-store: gera um storefront Next.js integrado à Unbox
 
   Uso:
-    npx --package=./create-unbox-store.tgz create-unbox-store [pasta] [flags]
+    npx --package=@unbox-plus/cli create-unbox-store [pasta] [flags]
 
   Sem flags, roda o wizard interativo: nome da loja, cores, estilo visual,
   credenciais da Unbox (Enter pra pular = modo mockup) e checkout.
@@ -143,8 +143,8 @@ function printHelp() {
     --help, -h         esta ajuda
 
   Exemplos:
-    npx --package=./create-unbox-store.tgz create-unbox-store minha-loja
-    npx --package=./create-unbox-store.tgz create-unbox-store loja-x --yes --no-install --estilo boutique
+    npx --package=@unbox-plus/cli create-unbox-store minha-loja
+    npx --package=@unbox-plus/cli create-unbox-store loja-x --yes --no-install --estilo boutique
 
   Depois de gerar: cd <pasta> && claude  (o briefing de marca abre sozinho)
   Docs completas: README.md dentro do zip da beta.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbox-plus/cli",
-  "version": "0.20.4",
+  "version": "0.20.5",
   "author": {
     "name": "Unbox Development Team",
     "email": "devs@unbox.com.br",

package/tools/notion-doc.mjs

@@ -6,11 +6,11 @@
 //
 // Existe pra que "manter a página atualizada" seja um comando, não um trabalho manual que
 // ninguém lembra de fazer no dia do release. A versão vem do package.json e o changelog é
-// extraído do README.md — as duas únicas fontes da verdade. Rode depois de todo release e
-// atualize a página com a saída.
+// extraído do CHANGELOG.md — as duas únicas fontes da verdade. Rode depois de todo release
+// e atualize a página com a saída.
 //
 // A prosa de apresentação é curada aqui (uma página de Notion para o time não é um despejo
-// do README). O changelog é mecânico: toda entrada "### vX.Y.Z" do README vira um toggle.
+// do README). O changelog é mecânico: toda entrada "### vX.Y.Z" do CHANGELOD vira um toggle.
 // ═══════════════════════════════════════════════════════════════════════════════════════
 import fs from "node:fs";
 import path from "node:path";
@@ -18,14 +18,14 @@ import { fileURLToPath } from "node:url";
 
 const RAIZ = path.join(path.dirname(fileURLToPath(import.meta.url)), "..");
 const pkg = JSON.parse(fs.readFileSync(path.join(RAIZ, "package.json"), "utf8"));
-const readme = fs.readFileSync(path.join(RAIZ, "README.md"), "utf8");
+const changelog = fs.readFileSync(path.join(RAIZ, "CHANGELOG.md"), "utf8");
 const VERSAO = pkg.version;
 
-// ── Changelog: extrai as entradas "### vX" / "### Beta vX" do README ────────────────────
+// ── Changelog: extrai as entradas "### vX" / "### Beta vX" do CHANGELOG ─────────────────
 function extrairChangelog() {
-  const linhas = readme.split("\n");
+  const linhas = changelog.split("\n");
   const ini = linhas.findIndex((l) => l.trim() === "## Changelog");
-  if (ini === -1) throw new Error("seção '## Changelog' não encontrada no README.md");
+  if (ini === -1) throw new Error("seção '## Changelog' não encontrada no CHANGELOG.md");
 
   const entradas = [];
   let atual = null;
@@ -75,7 +75,7 @@ function escaparAngulos(texto) {
 const entradas = extrairChangelog();
 // Detalhe integral só na era da arquitetura atual (v0.12.13+, quando o versionamento foi
 // unificado). O histórico anterior vira uma linha por versão dentro de um toggle: ninguém lê
-// 35 changelogs completos, e o texto integral continua no README do pacote.
+// 35 changelogs completos, e o texto integral continua no CHANGELOG do pacote.
 const DETALHADAS = entradas.findIndex((e) => /^Beta v/.test(e.titulo));
 const corte = DETALHADAS === -1 ? entradas.length : DETALHADAS;
 
@@ -95,23 +95,24 @@ const antigas = entradas.slice(corte).map((e) => {
   return `- **${e.titulo}** — ${resumo}`;
 }).join("\n");
 
-const changelog = detalhadas + `
+const changelogFinal = detalhadas + `
 
 <details>
 <summary>Histórico anterior (${entradas.length - corte} versões, era "Beta")</summary>
 ` + antigas.split("\n").map((l) => "\t" + l).join("\n") + `
 \t
-\tO texto integral de cada uma está no \`README.md\` dentro do pacote.
+\tO texto integral de cada uma está no \`CHANGELOG.md\` dentro do pacote.
 </details>`;
 
 // ── A página ────────────────────────────────────────────────────────────────────────────
 const pagina = `<callout icon="📦" color="blue_bg">
 	**Versão atual: v${VERSAO}** — entregue como \`CLI - Unbox v${VERSAO}.zip\`, que contém \`create-unbox-store.tgz\` e o README completo.
 	O nome do tarball é sempre \`create-unbox-store.tgz\`, **sem versão** — a versão fica dentro do pacote. Zips antigos traziam a versão no nome do arquivo e isso gerava erro de \`npx\` quando o comando não batia com o nome real.
+  O pacote também está sendo distribuído como [@unbox-plus/cli](https://www.npmjs.com/package/@unbox-plus/cli) no NPM.
 </callout>
 
 <callout icon="🔄" color="gray_bg">
-	Esta página é gerada a partir do \`README.md\` e do \`package.json\` do CLI. Para atualizá-la depois de um release, rode \`node tools/notion-doc.mjs\` no repositório do CLI e substitua o conteúdo com a saída. Não edite o changelog aqui à mão: ele será sobrescrito.
+	Esta página é gerada a partir do \`CHANGELOG.md\` e do \`package.json\` do CLI. Para atualizá-la depois de um release, rode \`node tools/notion-doc.mjs\` no repositório do CLI e substitua o conteúdo com a saída. Não edite o changelog aqui à mão: ele será sobrescrito.
 </callout>
 
 ## O que é
@@ -122,14 +123,14 @@ O que sai do CLI é **fundação**, não loja pronta. A personalização de verd
 
 ## Como usar
 
-Único pré-requisito da máquina: **Node.js** ([nodejs.org](https://nodejs.org), botão LTS). Coloque o \`create-unbox-store.tgz\` na pasta onde quer criar o projeto e rode:
+Único pré-requisito da máquina: **Node.js** ([nodejs.org](https://nodejs.org), botão LTS). Navegue até a pasta onde queira criar o projeto e rode:
 
 \`\`\`bash
-npx --package=./create-unbox-store.tgz create-unbox-store
+npx --package=@unbox-plus/cli create-unbox-store
 \`\`\`
 
 <callout icon="⚠️" color="yellow_bg">
-	Use sempre a forma com \`--package=\`. O \`npx ./create-unbox-store.tgz\` sem ela dá erro de permissão em algumas versões do npm.
+	Use sempre a forma com \`--package=\` para detecção correta do pacote.
 </callout>
 
 O CLI pergunta 12 coisas: nome do projeto e da loja, cor primária e de CTA, site e Instagram da marca, objetivo em uma frase, **estilo visual** (Essencial, Promocional, Editorial ou Boutique), credenciais da Unbox, tipo de checkout, o segredo de captcha (só com key de parceiro) e se roda \`npm install\`. Tudo menos as credenciais fica em \`marca/briefing.json\`, para o agente de marca não reperguntar.
@@ -148,7 +149,7 @@ O Claude Code abre direto no briefing de marca e conduz a personalização. Ence
 ### Sem interação (CI ou testes)
 
 \`\`\`bash
-npx --package=./create-unbox-store.tgz create-unbox-store minha-loja --yes --no-install
+npx --package=@unbox-plus/cli create-unbox-store minha-loja --yes --no-install
 \`\`\`
 
 Use \`--estilo <essencial|promocional|editorial|boutique>\` para escolher o preset sem interação.
@@ -185,7 +186,7 @@ A fundação traz placeholders que funcionam mas **precisam de uma decisão cons
 
 ## Changelog
 
-${changelog}
+${changelogFinal}
 `;
 
 process.stdout.write(pagina);