@arzstack/hub 0.1.0 → 1.0.0

package/README.md

@@ -1,52 +1,40 @@
-# @arzstack/hub — instalador
-
-CLI que instala itens do **ArzStack Hub** (skills, MCPs…) com um comando só,
-type-aware e com escolha de destino. Scaffold — **a publicar no npm**.
-
-```bash
-npx @arzstack/hub install <token> --global   # ou --project
-```
-
-O `<token>` é gerado na página do item no Hub (botão "Instalar" → copiar). É curto,
-assinado e escopado a 1 item + 1 org. O CLI:
-
-1. lê o `hub` + `item` do token;
-2. busca o manifesto em `GET {hub}/api/install/manifest?token=…`;
-3. instala conforme o tipo:
-   - **skill** → `git clone` em `~/.agents/skills/<slug>` (`--global`) ou `.agents/skills/<slug>` (`--project`);
-   - **mcp_server** → roda o comando de configuração (ex.: `claude mcp add …`);
-   - outros → mostra repositório/passos.
-4. confirma antes de executar (`--yes` pula); reporta o uso pro Hub (analytics).
-
-Flags: `--global` | `--project` | `--dir <path>` | `--yes`.
-
-## Desenvolver / testar local (sem publicar)
-```bash
-cd tools/arzstack-installer
-node src/index.mjs login --hub http://localhost:3000 --token arz_...
-node src/index.mjs install <id-do-item> --project
-# ou deixe o comando `arzstack-hub` global apontando pro código local:
-npm link        # cria o bin; rode: arzstack-hub install <id> ...
-npm unlink -g @arzstack/hub   # quando terminar
-```
-
-## Publicar no npm
-Pré-requisitos (uma vez): conta npm (`npm login`) e o **scope `@arzstack`**
-(criar a org `arzstack` em npmjs.com — grátis pra pacotes públicos).
-```bash
-cd tools/arzstack-installer
-npm publish --access public      # --access public é obrigatório p/ scope
-```
-Pra novas versões: suba `version` no `package.json` e `npm publish` de novo.
-Recomendado **mover este diretório pra um repo próprio** (`arzstack-hub-cli`)
-e publicar de lá — versionamento independente do portal.
-
-## Usar (depois de publicado)
-```bash
-npx @arzstack/hub install <id> --global    # sem instalar (npx baixa na hora)
-# ou global:
-npm i -g @arzstack/hub && arzstack-hub install <id> --global
-```
-Antes, autentique uma vez: `arzstack-hub login` (cola hub + token do Perfil).
-
-Contrato completo: `docs/specs/install-experience.md` e `docs/specs/cli-auth.md`.
+# @arzstack/hub
+
+Instalador do **ArzStack Hub**: instala itens do catálogo (skills, MCPs…) com **um
+comando**, type-aware e com escolha de destino (projeto ou global).
+
+## Uso rápido
+```bash
+# 1) autentique uma vez (gere o token no Hub: Perfil → Tokens de CLI)
+npx @arzstack/hub login          # pergunta o hub + token
+
+# 2) instale um item (o id está na página do item no Hub)
+npx @arzstack/hub install <id> --global     # ou --project
+```
+Prefere instalar global? `npm i -g @arzstack/hub` e use `arzstack-hub …`.
+
+## O que ele faz, por tipo
+| tipo | ação | destino |
+|---|---|---|
+| **skill** | `git clone` da skill | `--global`: `~/.agents/skills/<slug>` · `--project`: `.agents/skills/<slug>` |
+| **mcp_server** | roda o comando de configuração (ex.: `claude mcp add …`) | — |
+| outros | mostra repositório / próximos passos | — |
+
+Sempre confirma antes de executar (use `--yes` pra pular).
+
+## Autenticação
+`arzstack-hub login` salva `hub` + `token` em `~/.config/arzstack/config.json`.
+Alternativas: variáveis `ARZSTACK_HUB` / `ARZSTACK_TOKEN` (bom pra CI), ou as flags
+`--hub` / `--token`. O token é pessoal, revogável e escopado à sua org (gere/gerencie
+no Hub em **Perfil → Tokens de CLI**).
+
+## Comandos e flags
+```
+arzstack-hub login   [--hub <url>] [--token <pat>]
+arzstack-hub install <id|token> [--global | --project] [--dir <path>] [--yes]
+```
+
+---
+<sub>Mantenedores: publicado via GitHub Actions (Trusted Publishing/OIDC) a cada bump de
+`version`. Fonte e contrato: repositório do ArzStack Hub (`docs/specs/install-experience.md`,
+`cli-auth.md`).</sub>

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "@arzstack/hub",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "Instalador genérico de itens do ArzStack Hub (skills, MCPs, etc.).",
   "type": "module",
   "bin": {
-    "arzstack-hub": "./src/index.mjs"
+    "arzstack-hub": "src/index.mjs"
   },
   "engines": {
     "node": ">=18"
   },
-  "files": ["src"],
+  "files": [
+    "src"
+  ],
   "license": "UNLICENSED",
   "private": false
 }