@arzstack/hub 0.1.0

package/README.md

@@ -0,0 +1,52 @@
+# @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`.

package/package.json

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

package/src/index.mjs

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+// @arzstack/hub — instalador genérico de itens do ArzStack Hub.
+//   arzstack-hub login [--hub <url>] [--token <pat>]
+//   arzstack-hub install <id> [--global|--project] [--dir <path>] [--yes]
+//   arzstack-hub install <token-efêmero> ...   (atalho copiado da web)
+// Ver docs/specs/install-experience.md e docs/specs/cli-auth.md no repo do Hub.
+
+import { spawnSync } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { stdin, stdout } from 'node:process';
+import { createInterface } from 'node:readline/promises';
+
+const CONFIG_DIR = join(homedir(), '.config', 'arzstack');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+
+const fail = (m) => {
+  console.error(`\x1b[31m✗ ${m}\x1b[0m`);
+  process.exit(1);
+};
+const info = (m) => console.log(m);
+
+function loadConfig() {
+  try {
+    return JSON.parse(readFileSync(CONFIG_FILE, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+function saveConfig(cfg) {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(CONFIG_FILE, JSON.stringify(cfg, null, 2), { mode: 0o600 });
+}
+
+function parseArgs(argv) {
+  const [cmd, ...rest] = argv;
+  const flags = { target: 'global', yes: false, dir: null, token: null, hub: null };
+  let arg = null;
+  for (let i = 0; i < rest.length; i++) {
+    const a = rest[i];
+    if (a === '--global') flags.target = 'global';
+    else if (a === '--project') flags.target = 'project';
+    else if (a === '--yes' || a === '-y') flags.yes = true;
+    else if (a === '--dir') flags.dir = rest[++i];
+    else if (a === '--token') flags.token = rest[++i];
+    else if (a === '--hub') flags.hub = rest[++i];
+    else if (!a.startsWith('-') && arg === null) arg = a;
+  }
+  return { cmd, arg, flags };
+}
+
+function decodeToken(token) {
+  try {
+    return JSON.parse(Buffer.from(token.split('.')[0], 'base64url').toString('utf8'));
+  } catch {
+    return null;
+  }
+}
+
+async function prompt(q) {
+  const rl = createInterface({ input: stdin, output: stdout });
+  const a = await rl.question(q);
+  rl.close();
+  return a;
+}
+async function confirm(q, skip) {
+  if (skip) return true;
+  const a = (await prompt(`${q} [s/N] `)).trim().toLowerCase();
+  return a === 's' || a === 'sim' || a === 'y' || a === 'yes';
+}
+
+function run(cmd, args) {
+  info(`\x1b[2m$ ${cmd} ${args.join(' ')}\x1b[0m`);
+  const r = spawnSync(cmd, args, { stdio: 'inherit', shell: false });
+  if (r.status !== 0) fail(`Comando falhou (${cmd}).`);
+}
+
+function skillsDir(target, override) {
+  if (override) return resolve(override);
+  return target === 'global'
+    ? join(homedir(), '.agents', 'skills')
+    : join(process.cwd(), '.agents', 'skills');
+}
+
+async function installSkill(m, flags) {
+  if (m.source?.kind !== 'git') fail('Esta skill não tem repositório git. Veja "Abrir recurso".');
+  const dest = join(skillsDir(flags.target, flags.dir), m.slug);
+  if (existsSync(dest)) fail(`Já existe: ${dest}.`);
+  info(`\nSkill: \x1b[1m${m.title}\x1b[0m\nRepo:  ${m.source.repo}\nDest:  ${dest}\n`);
+  if (!(await confirm('Clonar e instalar?', flags.yes))) fail('Cancelado.');
+  run('git', ['clone', '--depth', '1', m.source.repo, dest]);
+  info(`\n\x1b[32m✓ Skill instalada em ${dest}\x1b[0m`);
+}
+
+async function installMcp(m, flags) {
+  if (!m.run) fail('Sem comando de configuração do MCP. Veja "Abrir recurso".');
+  info(`\nMCP: \x1b[1m${m.title}\x1b[0m\nComando: ${m.run}\n`);
+  if (!(await confirm('Rodar a configuração?', flags.yes))) fail('Cancelado.');
+  const win = process.platform === 'win32';
+  run(win ? 'cmd' : 'sh', [win ? '/c' : '-c', m.run]);
+  info('\n\x1b[32m✓ MCP configurado.\x1b[0m');
+}
+
+function installOther(m) {
+  info(`\n\x1b[1m${m.title}\x1b[0m (${m.type})`);
+  if (m.source) info(`Repositório: ${m.source.repo}`);
+  if (m.run) info(`Passo: ${m.run}`);
+  info('Este tipo não tem instalação automática — siga o material acima.');
+}
+
+async function report(hub, headers, body) {
+  try {
+    await fetch(`${hub}/api/install/report`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', ...headers },
+      body: JSON.stringify(body),
+    });
+  } catch {
+    /* best-effort */
+  }
+}
+
+async function cmdLogin(flags) {
+  const hub = (flags.hub || (await prompt('URL do Hub (ex.: https://hub.suaorg.com): '))).trim();
+  const token = (flags.token || (await prompt('Cole seu token (arz_…): '))).trim();
+  if (!token.startsWith('arz_')) fail('Token inválido (esperado arz_…).');
+  saveConfig({ hub: hub.replace(/\/+$/, ''), token });
+  info('\x1b[32m✓ Login salvo em ~/.config/arzstack/config.json\x1b[0m');
+}
+
+async function cmdInstall(arg, flags) {
+  if (!arg) fail('Informe o id do item (ou o token copiado da web).');
+
+  let hub;
+  let manifestUrl;
+  let headers = {};
+  let reportBody = { target: flags.target };
+
+  if (arg.includes('.')) {
+    // token efêmero (auto-contido)
+    const p = decodeToken(arg);
+    if (!p?.hub || !p?.item) fail('Token inválido.');
+    hub = p.hub;
+    manifestUrl = `${hub}/api/install/manifest?token=${encodeURIComponent(arg)}`;
+    reportBody.token = arg;
+  } else {
+    // id do item + PAT
+    const cfg = loadConfig();
+    const token = flags.token || process.env.ARZSTACK_TOKEN || cfg.token;
+    hub = (flags.hub || process.env.ARZSTACK_HUB || cfg.hub || '').replace(/\/+$/, '');
+    if (!token || !hub) {
+      fail('Faça login: arzstack-hub login (ou passe --hub e --token).');
+    }
+    manifestUrl = `${hub}/api/install/manifest?item=${encodeURIComponent(arg)}`;
+    headers = { Authorization: `Bearer ${token}` };
+    reportBody.item = arg;
+  }
+
+  let manifest;
+  try {
+    const res = await fetch(manifestUrl, { headers });
+    if (!res.ok) fail(`Hub respondeu ${res.status}. (token expirado/revogado?)`);
+    manifest = await res.json();
+  } catch (e) {
+    fail(`Não consegui falar com o Hub: ${e.message}`);
+  }
+
+  if (manifest.type === 'skill') await installSkill(manifest, flags);
+  else if (manifest.type === 'mcp_server') await installMcp(manifest, flags);
+  else installOther(manifest);
+
+  await report(hub, headers, reportBody);
+}
+
+async function main() {
+  const { cmd, arg, flags } = parseArgs(process.argv.slice(2));
+  if (cmd === 'login') return cmdLogin(flags);
+  if (cmd === 'install') return cmdInstall(arg, flags);
+  info('Uso:');
+  info('  arzstack-hub login [--hub <url>] [--token <pat>]');
+  info('  arzstack-hub install <id|token> [--global|--project] [--dir <path>] [--yes]');
+  process.exit(cmd ? 1 : 0);
+}
+
+main().catch((e) => fail(e?.message ?? String(e)));