@nio-cli/cli 0.1.0 → 0.2.0

package/dist/cli/commands/docs/content.js

@@ -0,0 +1,199 @@
+export const TAGLINE = 'Orquestrador de ambientes de desenvolvimento — perfil + wizard, e a CLI (com IA via MCP) materializa toolchains, linguagens, frameworks, dotfiles e IDE.';
+export const SECTIONS = [
+    {
+        id: 'o-que-e',
+        title: 'O que é',
+        blocks: [
+            {
+                kind: 'p',
+                text: 'A NIO-CLI monta ambientes de desenvolvimento reproduzíveis. Você escolhe um perfil (fullstack, analyst, scientist, dba, qa, bi), responde um wizard, e a CLI garante os toolchains, resolve os MCPs, escreve dotfiles/aliases e abre a IDE.',
+            },
+            {
+                kind: 'p',
+                text: 'A entidade central é a Sessão: um ambiente isolado com UUID, persistido no Postgres. Uma sessão ativa por usuário por vez; sessões antigas ficam no banco e podem ser reativadas.',
+            },
+            {
+                kind: 'p',
+                text: 'O Postgres é a fonte da verdade. A CLI e o gateway só falam com o banco que VOCÊ configurar — não há default silencioso nem banco embutido no pacote.',
+            },
+        ],
+    },
+    {
+        id: 'como-funciona',
+        title: 'Como funciona',
+        blocks: [
+            {
+                kind: 'code',
+                text: [
+                    'você → nio (CLI) ──► nio-gateway ──► Postgres     login: senha + JWT (2º fator opcional)',
+                    '          │',
+                    '          ├──► SessionManager / EnvironmentBuilder    materializa toolchains, MCPs, dotfiles',
+                    '          │',
+                    '          └──► opencode.json ──► OpenCode (operador de IA)',
+                    '                                  └── MCP nio (tools nio_*) ──► SessionManager ──► Postgres',
+                ].join('\n'),
+            },
+            {
+                kind: 'list',
+                items: [
+                    'Autenticação — `nio register` / `nio login`. O nio-gateway (serviço HTTP loopback) verifica a senha (argon2id), dispara o 2º fator se ativo, e devolve um JWT salvo em ~/.nio/session.json.',
+                    'Sessão — `nio init`. O wizard pergunta perfil + recipe; o EnvironmentBuilder garante os toolchains, resolve os MCPs e grava o config materializado na linha `sessions` do Postgres.',
+                    'Handoff — a CLI registra o MCP `nio` no opencode.json e entrega o terminal pro OpenCode (modelo opencode/big-pickle). O agente passa a ter as tools nio_*.',
+                ],
+            },
+            {
+                kind: 'p',
+                text: 'O nio-gateway só é necessário pros comandos de auth. Todo o resto (init, sessions, tools MCP) fala com o Postgres direto usando o JWT local.',
+            },
+        ],
+    },
+    {
+        id: 'instalacao',
+        title: 'Instalação e pré-requisitos',
+        blocks: [
+            { kind: 'code', text: 'npm i -g @nio-cli/cli' },
+            {
+                kind: 'p',
+                text: 'Precisa de Node.js 20.12+. Ficam no PATH: nio (CLI), nio-gateway (auth), nio-cli e nio-lang (servidores MCP).',
+            },
+            {
+                kind: 'table',
+                head: ['Requisito', 'Pra quê'],
+                rows: [
+                    ['PostgreSQL alcançável', 'fonte da verdade — schema de db/schema.sql aplicado uma vez'],
+                    ['JWT_SECRET (segredo do time)', 'assinar/validar as sessões — mesmo valor em toda máquina'],
+                    ['OpenCode', 'operador de IA — o `nio init` oferece instalar'],
+                    ['provedor de SMS (opcional)', '2º fator — SMS_ENDPOINT_URL + SMS_AUTH_HEADER + SMS_BODY_TEMPLATE'],
+                ],
+            },
+        ],
+    },
+    {
+        id: 'config',
+        title: 'Configuração',
+        blurb: 'Você não precisa exportar nada no shell.',
+        blocks: [
+            {
+                kind: 'p',
+                text: '`nio config setup` — wizard que pede o `NIO_DATABASE_URL` (o time te passa) e o `JWT_SECRET`, testa a conexão e grava em ~/.nio/config.env (chmod 600). `nio init`/`register`/`login` disparam esse wizard sozinhos se a config faltar; se estiver errada, param dizendo o quê.',
+            },
+            {
+                kind: 'code',
+                text: [
+                    'nio config setup     wizard (cola os valores, testa, salva)',
+                    'nio config check     completa? banco responde?  (--json pra CI)',
+                    'nio config path      ~/.nio/config.env',
+                ].join('\n'),
+            },
+            {
+                kind: 'p',
+                text: 'Precedência ao carregar: env do shell > $NIO_ENV_FILE > ./.env > ~/.nio/config.env.',
+            },
+            {
+                kind: 'table',
+                head: ['Variável', 'Lida por'],
+                rows: [
+                    ['NIO_DATABASE_URL / NIO_DATABASE_SSL', 'tudo que toca o banco'],
+                    ['JWT_SECRET / JWT_EXPIRES_IN (sem prefixo)', 'nio-gateway + nio-cli'],
+                    ['SMS_* (sem prefixo)', 'nio-gateway'],
+                    ['NIO_GATEWAY_HOST (default 127.0.0.1)', 'nio-gateway — 0.0.0.0 p/ Kong em container'],
+                    ['NIO_GATEWAY_URL (default http://127.0.0.1:8000)', 'a CLI, pra achar o gateway/Kong'],
+                ],
+            },
+        ],
+    },
+    {
+        id: 'primeiros-passos',
+        title: 'Primeiros passos',
+        blocks: [
+            {
+                kind: 'code',
+                text: [
+                    'nio config setup       # cola NIO_DATABASE_URL + JWT_SECRET, testa, salva',
+                    'nio-gateway &          # gateway de auth no ar',
+                    'nio register           # cria seu usuário na base compartilhada',
+                    'nio login              # salva o JWT em ~/.nio/session.json',
+                    'nio security enable-2fa # (opcional) 2º fator',
+                    'nio init               # monta o ambiente da sessão',
+                ].join('\n'),
+            },
+            { kind: 'p', text: 'A qualquer momento, `nio debug` mostra o que está ok e o que falta.' },
+        ],
+    },
+    {
+        id: 'arquitetura',
+        title: 'Como é construída',
+        blurb: 'Hexagonal — o núcleo não conhece IO; os adapters implementam os contratos.',
+        blocks: [
+            {
+                kind: 'code',
+                text: [
+                    'entrypoints:  src/cli.ts (nio)         src/gateway/index.ts (nio-gateway)',
+                    '              src/mcp-server.ts (nio-cli)  src/mcp-server-lang.ts (nio-lang)',
+                    'app:          SessionManager · EnvironmentBuilder · DependencyWatcher · DockerManager',
+                    'core/:        entidades  +  ports (interfaces, sem IO nenhum)',
+                    'adapters/:    pg/ (Postgres)  ide/  pkg/ (npm,pip,…)  docker/  sms/  skills/',
+                    'profiles/:    catálogo dos 6 perfis (fixos no fonte)',
+                ].join('\n'),
+            },
+            {
+                kind: 'list',
+                items: [
+                    'Runtime: Node 20.12+. Bun roda em dev, mas nada depende de API exclusiva do Bun.',
+                    'Build: tsc puro → dist/. Sem bundler.',
+                    'Banco: driver pg + um Pool único. Sem Supabase, sem PostgREST, sem Bun.sql.',
+                    'Gateway: http.createServer nativo, loopback, atrás do Kong OSS (opcional, rate-limiting). JWT HS256, jti = id da auth_session. Trilha de auth em stderr — nunca a senha nem o OTP em texto puro.',
+                    'Contrato "nunca lança" nos ports de IO: falha vira { status, error? }.',
+                ],
+            },
+        ],
+    },
+    {
+        id: '2fa',
+        title: '2º fator (SMS)',
+        blocks: [
+            {
+                kind: 'p',
+                text: 'Opt-in por conta. Com auth_2 ativo, o `nio login` pede um código de 6 dígitos por SMS; se o SMS não chega, vale um dos 10 códigos de backup (mostrados uma vez no enable-2fa).',
+            },
+            {
+                kind: 'code',
+                text: [
+                    'nio security enable-2fa               cadastra o celular, confirma via SMS, mostra os backups',
+                    'nio security status                   ativo? número (mascarado)? quantos backups restam?',
+                    'nio security disable-2fa',
+                    'nio security regenerate-backup-codes',
+                ].join('\n'),
+            },
+            {
+                kind: 'p',
+                text: 'O gateway gera/valida o OTP em processo (sem Twilio, sem broker), guarda só o HMAC do código (TTL 5 min, 3 tentativas, uso único) e manda o SMS por um adapter HTTP genérico. Sem SMS_ENDPOINT_URL, o login com auth_2 responde 503 — o de 1 fator segue normal.',
+            },
+        ],
+    },
+    {
+        id: 'debug',
+        title: 'Debug da própria CLI',
+        blocks: [
+            {
+                kind: 'p',
+                text: '`nio debug` roda uma bateria de checagens read-only e mostra ✓ / ⚠ / ✗ com uma dica acionável em cada: nio.json no diretório, login local, conexão Postgres, sessão ativa, OpenCode no PATH, cache de skills.',
+            },
+            {
+                kind: 'list',
+                items: [
+                    '"NIO_DATABASE_URL não definida" → ponha em ~/.nio/config.env (o bin publicado não lê o .env de dev via bun).',
+                    '"Não consegui falar com o nio-gateway" → suba `nio-gateway &`.',
+                    '"Não autenticado" → `nio register` (1ª vez) e `nio login`.',
+                    '"2FA não configurado no servidor" (503) → faltam as SMS_* no ambiente do nio-gateway.',
+                    'Tools não aparecem no cliente → reinicie o cliente depois do `nio init`; cheque com /mcp.',
+                ],
+            },
+            {
+                kind: 'p',
+                text: 'Logs do gateway saem em stderr como JSON estruturado (event: gateway_request / auth_attempt) — nunca com senha ou OTP.',
+            },
+        ],
+    },
+];
+//# sourceMappingURL=content.js.map

package/dist/cli/commands/docs/content.js.map

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

package/dist/cli/commands/docs/dynamic.js

@@ -0,0 +1,42 @@
+import { toolDefinitions } from '../../../tools/index.js';
+function firstSentence(text) {
+    const flat = text.replace(/\s+/g, ' ').trim();
+    const stop = flat.search(/\.(\s|$)/);
+    return stop > 0 ? flat.slice(0, stop + 1) : flat;
+}
+function walk(cmd, prefix = '') {
+    const rows = [];
+    for (const sub of cmd.commands) {
+        const nm = sub.name();
+        if (nm === 'help')
+            continue;
+        const full = prefix ? `${prefix} ${nm}` : nm;
+        const args = sub.commands.length > 0 ? '' : sub.usage().replace(/^\[options\]\s*/, '').trim();
+        const desc = sub.description();
+        if (desc)
+            rows.push([args ? `${full} ${args}` : full, firstSentence(desc)]);
+        rows.push(...walk(sub, full));
+    }
+    return rows;
+}
+export function commandSection(program) {
+    const rows = walk(program).sort((a, b) => a[0].localeCompare(b[0]));
+    return {
+        id: 'comandos',
+        title: 'Comandos',
+        blurb: `${rows.length} comandos. Ajuda de qualquer um: nio <cmd> --help`,
+        blocks: [{ kind: 'table', head: ['Comando', 'O que faz'], rows }],
+    };
+}
+export function toolSection() {
+    const rows = [...toolDefinitions]
+        .sort((a, b) => a.name.localeCompare(b.name))
+        .map((t) => [t.name, firstSentence(t.description ?? '')]);
+    return {
+        id: 'tools-mcp',
+        title: 'Tools MCP',
+        blurb: 'Expostas pelo servidor nio-cli ao operador de IA. Todas passam pelo SessionManager e exigem nio login.',
+        blocks: [{ kind: 'table', head: ['Tool', 'O que faz'], rows }],
+    };
+}
+//# sourceMappingURL=dynamic.js.map

package/dist/cli/commands/docs/dynamic.js.map

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

package/dist/cli/commands/docs/html.js

@@ -0,0 +1,108 @@
+const esc = (s) => s.replace(/[&<>"]/g, (ch) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' })[ch]);
+const inline = (s) => esc(s).replace(/`([^`]+)`/g, (_m, code) => `<code>${code}</code>`);
+const STYLE = `
+:root{
+  --bg:#f6f8f5; --surface:#fff; --ink:#16211a; --muted:#5a6b60; --line:#dde5dd;
+  --accent:#1a7f43; --accent-soft:#e3f2e6; --code-bg:#0d130f; --code-ink:#c8e6cf;
+  --font:"Inter",ui-sans-serif,-apple-system,"Segoe UI",Roboto,sans-serif;
+  --mono:ui-monospace,"SF Mono","JetBrains Mono",Menlo,Consolas,monospace;
+}
+@media (prefers-color-scheme:dark){:root:not([data-theme=light]){
+  --bg:#0a0e0b; --surface:#0f150f; --ink:#d7e5da; --muted:#7f9285; --line:#1e2a20;
+  --accent:#4ade80; --accent-soft:#122417; --code-bg:#060907; --code-ink:#bfe9c9;
+}}
+:root[data-theme=dark]{
+  --bg:#0a0e0b; --surface:#0f150f; --ink:#d7e5da; --muted:#7f9285; --line:#1e2a20;
+  --accent:#4ade80; --accent-soft:#122417; --code-bg:#060907; --code-ink:#bfe9c9;
+}
+*{box-sizing:border-box}
+body{margin:0;background:var(--bg);color:var(--ink);font-family:var(--font);
+  line-height:1.65;-webkit-font-smoothing:antialiased}
+a{color:var(--accent);text-decoration:none}
+a:hover{text-decoration:underline}
+code{font-family:var(--mono);font-size:.88em;background:var(--accent-soft);
+  color:var(--accent);padding:.1em .38em;border-radius:4px}
+header.top{border-bottom:1px solid var(--line);background:var(--surface);
+  position:sticky;top:0;z-index:5}
+.top .inner{max-width:1000px;margin:0 auto;padding:22px 24px;
+  display:flex;justify-content:space-between;align-items:baseline;gap:20px;flex-wrap:wrap}
+.brand{font-family:var(--mono);font-weight:700;font-size:1.35rem;letter-spacing:.02em}
+.brand .cursor{color:var(--accent)}
+.ver{font-family:var(--mono);font-size:.78rem;color:var(--muted);
+  border:1px solid var(--line);border-radius:999px;padding:.22em .7em;white-space:nowrap}
+button.theme{font:inherit;font-size:.78rem;color:var(--muted);background:none;
+  border:1px solid var(--line);border-radius:999px;padding:.28em .8em;cursor:pointer;margin-left:8px}
+.tag{max-width:1000px;margin:0 auto;padding:16px 24px 0;color:var(--muted);font-size:.95rem}
+nav.toc{max-width:1000px;margin:0 auto;padding:14px 24px 26px;display:flex;flex-wrap:wrap;
+  gap:6px 16px;font-size:.84rem;border-bottom:1px solid var(--line)}
+nav.toc a{color:var(--muted)}
+nav.toc a:hover,nav.toc a.on{color:var(--accent);text-decoration:none}
+main{max-width:1000px;margin:0 auto;padding:40px 24px 96px}
+section{margin:0 0 48px;scroll-margin-top:80px}
+h2{font-size:1.3rem;margin:0 0 4px;letter-spacing:-.01em}
+.blurb{color:var(--muted);margin:0 0 18px;font-size:.95rem}
+p{margin:0 0 14px;max-width:72ch}
+ul{margin:0 0 16px;padding-left:20px;max-width:74ch}
+li{margin:.4em 0}
+pre{background:var(--code-bg);color:var(--code-ink);font-family:var(--mono);
+  font-size:.82rem;line-height:1.6;padding:16px 18px;border-radius:10px;
+  overflow-x:auto;border:1px solid var(--line);margin:0 0 18px}
+pre code{background:none;color:inherit;padding:0;font-size:inherit}
+.tbl{overflow-x:auto;margin:0 0 18px;border:1px solid var(--line);border-radius:10px}
+table{border-collapse:collapse;width:100%;font-size:.9rem}
+th,td{text-align:left;padding:9px 14px;border-bottom:1px solid var(--line);vertical-align:top}
+tr:last-child td{border-bottom:0}
+th{font-weight:600;color:var(--muted);font-size:.78rem;text-transform:uppercase;letter-spacing:.04em}
+td:first-child{font-family:var(--mono);font-size:.85rem;white-space:nowrap}
+@media(max-width:640px){td:first-child{white-space:normal}}
+`;
+function renderBlock(b) {
+    if (b.kind === 'p')
+        return `<p>${inline(b.text)}</p>`;
+    if (b.kind === 'code')
+        return `<pre><code>${esc(b.text)}</code></pre>`;
+    if (b.kind === 'list')
+        return `<ul>${b.items.map((i) => `<li>${inline(i)}</li>`).join('')}</ul>`;
+    const head = b.head.map((h) => `<th>${esc(h)}</th>`).join('');
+    const rows = b.rows
+        .map((r) => `<tr>${r.map((cell) => `<td>${inline(cell)}</td>`).join('')}</tr>`)
+        .join('');
+    return `<div class="tbl"><table><thead><tr>${head}</tr></thead><tbody>${rows}</tbody></table></div>`;
+}
+const SCRIPT = `
+const root=document.documentElement,KEY='nio-docs-theme';
+try{const t=localStorage.getItem(KEY);if(t)root.dataset.theme=t}catch(e){}
+document.querySelector('button.theme').onclick=()=>{
+  const sysDark=matchMedia('(prefers-color-scheme:dark)').matches;
+  const cur=root.dataset.theme||(sysDark?'dark':'light');
+  const next=cur==='dark'?'light':'dark';root.dataset.theme=next;
+  try{localStorage.setItem(KEY,next)}catch(e){}};
+const links=[...document.querySelectorAll('nav.toc a')];
+addEventListener('scroll',()=>{let on=links[0];
+  for(const l of links){const el=document.getElementById(l.hash.slice(1));
+    if(el&&el.getBoundingClientRect().top<140)on=l}
+  links.forEach(l=>l.classList.toggle('on',l===on))},{passive:true});
+`;
+export function renderHtml(sections, version, tagline) {
+    const nav = sections
+        .map((s) => `<a href="#${s.id}">${esc(s.title)}</a>`)
+        .join(' ');
+    const body = sections
+        .map((s) => `<section id="${s.id}"><h2>${esc(s.title)}</h2>` +
+        (s.blurb ? `<p class="blurb">${inline(s.blurb)}</p>` : '') +
+        s.blocks.map(renderBlock).join('') +
+        `</section>`)
+        .join('');
+    return `<!doctype html><html lang="pt-BR"><head><meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>NIO-CLI — documentação</title><style>${STYLE}</style></head><body>
+<header class="top"><div class="inner">
+<div class="brand">nio<span class="cursor">_</span></div>
+<div style="white-space:nowrap"><span class="ver">v${esc(version)}</span>
+<button class="theme">tema</button></div></div></header>
+<p class="tag">${esc(tagline)}</p>
+<nav class="toc">${nav}</nav>
+<main>${body}</main>
+<script>${SCRIPT}</script></body></html>`;
+}
+//# sourceMappingURL=html.js.map

package/dist/cli/commands/docs/html.js.map

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

package/dist/cli/commands/docs/terminal.js

@@ -0,0 +1,42 @@
+import { c, sym, rule, highlightInlineCode, indent } from '../../../lib/colors.js';
+function codeBlock(text) {
+    return text
+        .split('\n')
+        .map((l) => `${c.dim('│')} ${c.cyan(l)}`)
+        .join('\n');
+}
+function defList(head, rows) {
+    return rows
+        .map((r) => {
+        const term = c.bold(r[0] ?? '');
+        const rest = r.slice(1).map((cell) => highlightInlineCode(cell)).join(' — ');
+        return rest ? `${term}\n${indent(c.dim(rest), 2)}` : term;
+    })
+        .join('\n');
+}
+function renderBlock(b) {
+    switch (b.kind) {
+        case 'p':
+            return highlightInlineCode(b.text);
+        case 'code':
+            return codeBlock(b.text);
+        case 'list':
+            return b.items.map((it) => `${c.dim(sym.bullet)} ${highlightInlineCode(it)}`).join('\n');
+        case 'table':
+            return defList(b.head, b.rows);
+    }
+}
+export function renderTerminal(sections, version) {
+    const parts = [c.bold(`NIO-CLI  ${c.dim('v' + version)}`), ''];
+    for (const s of sections) {
+        parts.push(rule(), c.bold.underline(s.title.toUpperCase()));
+        if (s.blurb)
+            parts.push(c.dim(s.blurb));
+        parts.push('');
+        for (const b of s.blocks)
+            parts.push(indent(renderBlock(b), 2), '');
+    }
+    parts.push(rule(), c.dim('Página com arte: nio docs --html --open'));
+    return parts.join('\n');
+}
+//# sourceMappingURL=terminal.js.map

package/dist/cli/commands/docs/terminal.js.map

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

package/dist/cli/commands/docs.js

@@ -0,0 +1,34 @@
+import { writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { VERSION } from "../../version.js";
+import { c, sym } from "../../lib/colors.js";
+import { openUrl } from "../../lib/open-url.js";
+import { homePath } from "../../brand.js";
+import { SECTIONS, TAGLINE } from "./docs/content.js";
+import { commandSection, toolSection } from "./docs/dynamic.js";
+import { renderTerminal } from "./docs/terminal.js";
+import { renderHtml } from "./docs/html.js";
+function allSections(program) {
+    return [...SECTIONS, commandSection(program), toolSection()];
+}
+export function registerDocsCommand(program) {
+    program
+        .command("docs")
+        .description("Documentação completa da CLI (terminal ou página com --html)")
+        .option("--html", "gera a página HTML em vez de imprimir no terminal")
+        .option("--open", "abre a página no navegador (implica --html)")
+        .option("-o, --out <path>", "caminho do HTML (default ~/.nio/nio-docs.html)")
+        .action((opts) => {
+        const sections = allSections(program);
+        if (!opts.html && !opts.open) {
+            console.log(renderTerminal(sections, VERSION));
+            return;
+        }
+        const out = resolve(opts.out ?? homePath("nio-docs.html"));
+        writeFileSync(out, renderHtml(sections, VERSION, TAGLINE), "utf8");
+        console.log(`${c.green(sym.ok)} página gerada: ${c.cyan(out)}`);
+        if (opts.open)
+            openUrl(out);
+    });
+}
+//# sourceMappingURL=docs.js.map

package/dist/cli/commands/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/cli/commands/docs.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,SAAS,WAAW,CAAC,OAAgB;IACnC,OAAO,CAAC,GAAG,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,8DAA8D,CAAC;SAC3E,MAAM,CAAC,QAAQ,EAAE,mDAAmD,CAAC;SACrE,MAAM,CAAC,QAAQ,EAAE,6CAA6C,CAAC;SAC/D,MAAM,CAAC,kBAAkB,EAAE,gDAAgD,CAAC;SAC5E,MAAM,CAAC,CAAC,IAAsD,EAAE,EAAE;QACjE,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QAEtC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;QAC3D,aAAa,CAAC,GAAG,EAAE,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChE,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/exec.js

@@ -1,11 +1,7 @@
 import { brand } from "../../brand.js";
 import { existsSync } from "node:fs";
-import { runExec, getJob } from "../../lib/exec-delegate.js";
-import { ENGINES, DEFAULT_ENGINE, parseEngine, } from "../../lib/exec-engines.js";
-/**
- * Superfície de CLI da delegação headless — o que o nio Studio (Tauri) chama.
- * Contrato: **stdout = JSON** (parseável), **stderr = log ao vivo** (streamável).
- */
+import { runExec, getJob } from "../../lib/exec/exec-delegate.js";
+import { ENGINES, DEFAULT_ENGINE, parseEngine, } from "../../lib/exec/exec-engines.js";
 function emit(payload) {
     process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
 }
@@ -42,7 +38,6 @@ export function registerExecCommand(program) {
         if (job.state !== "done")
             process.exitCode = 1;
     });
-    // Comando separado (não subcomando): opções `required` do pai bloqueariam o parse.
     program
         .command("exec-status <jobId>")
         .description(`Estado de um job de execução (\`${brand.name} exec\`), em JSON`)

package/dist/cli/commands/exec.js.map

@@ -1 +1 @@
-{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../../src/cli/commands/exec.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EACL,OAAO,EACP,cAAc,EACd,WAAW,GACZ,MAAM,2BAA2B,CAAC;AAEnC;;;GAGG;AAEH,SAAS,IAAI,CAAC,OAAgB;IAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CACV,sEAAsE;QACpE,mDAAmD,CACtD;SACA,cAAc,CACb,mBAAmB,EACnB,oDAAoD,CACrD;SACA,cAAc,CACb,uBAAuB,EACvB,wCAAwC,CACzC;SACA,MAAM,CACL,mBAAmB,EACnB,uBAAuB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAC7C,cAAc,CACf;SACA,MAAM,CAAC,SAAS,EAAE,uCAAuC,CAAC;SAC1D,MAAM,CACL,KAAK,EAAE,IAKN,EAAE,EAAE;QACH,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,KAAK,EAAE,oBAAoB,IAAI,CAAC,MAAM,kBAAkB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAC7E,CAAC,CAAC;YACH,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,EAAE,KAAK,EAAE,4BAA4B,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC7D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC;YACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM;YACN,IAAI,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,IAAI,GAAG,CAAC,KAAK,KAAK,MAAM;YAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACjD,CAAC,CACF,CAAC;IAEJ,mFAAmF;IACnF,OAAO;SACJ,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CAAC,mCAAmC,KAAK,CAAC,IAAI,mBAAmB,CAAC;SAC7E,MAAM,CAAC,CAAC,KAAa,EAAE,EAAE;QACxB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,IAAI,CAAC,EAAE,KAAK,EAAE,uBAAuB,KAAK,EAAE,EAAE,CAAC,CAAC;YAChD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,CAAC;IACZ,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../../src/cli/commands/exec.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EACL,OAAO,EACP,cAAc,EACd,WAAW,GACZ,MAAM,gCAAgC,CAAC;AAOxC,SAAS,IAAI,CAAC,OAAgB;IAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CACV,sEAAsE;QACpE,mDAAmD,CACtD;SACA,cAAc,CACb,mBAAmB,EACnB,oDAAoD,CACrD;SACA,cAAc,CACb,uBAAuB,EACvB,wCAAwC,CACzC;SACA,MAAM,CACL,mBAAmB,EACnB,uBAAuB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAC7C,cAAc,CACf;SACA,MAAM,CAAC,SAAS,EAAE,uCAAuC,CAAC;SAC1D,MAAM,CACL,KAAK,EAAE,IAKN,EAAE,EAAE;QACH,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,KAAK,EAAE,oBAAoB,IAAI,CAAC,MAAM,kBAAkB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAC7E,CAAC,CAAC;YACH,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,EAAE,KAAK,EAAE,4BAA4B,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC7D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC;YACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM;YACN,IAAI,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,IAAI,GAAG,CAAC,KAAK,KAAK,MAAM;YAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACjD,CAAC,CACF,CAAC;IAGJ,OAAO;SACJ,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CAAC,mCAAmC,KAAK,CAAC,IAAI,mBAAmB,CAAC;SAC7E,MAAM,CAAC,CAAC,KAAa,EAAE,EAAE;QACxB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,IAAI,CAAC,EAAE,KAAK,EAAE,uBAAuB,KAAK,EAAE,EAAE,CAAC,CAAC;YAChD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,CAAC;IACZ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/init/auth-step.js

@@ -1,49 +1,13 @@
-import { password } from "../../../lib/prompts.js";
+import { loadSession } from "../../../lib/auth/session-store.js";
 import { brand } from "../../../brand.js";
-import { exchangePatForJwt, loadCredentials, saveCredentials, validatePatFormat, } from "../../../auth.js";
-import { createAuthenticatedClient } from "../../../adapters/supabase/client.js";
-import { startSpinner } from "../../../spinner.js";
-import { initCopy } from "../../copy.js";
-/**
- * Garante que há credenciais locais antes de seguir com o wizard: se já há PAT
- * salvo, não faz nada; senão, pede o token, valida e troca por sessão.
- */
-export async function ensureAuthenticated() {
-    const existingCreds = await loadCredentials();
-    if (existingCreds)
-        return;
-    console.log("Você ainda não está autenticado.");
-    if (brand.webUrl)
-        console.log(`Gere um token pessoal em: ${brand.webUrl}/profile#mcp`);
-    const newPat = (await password({
-        message: initCopy.patPrompt,
-        mask: "*",
-        validate: (value) => validatePatFormat(value.trim()) || initCopy.patInvalid,
-    })).trim();
-    const loginSpinner = startSpinner("Validando token...");
-    try {
-        const result = await exchangePatForJwt(newPat);
-        await saveCredentials({ pat: newPat });
-        loginSpinner.stop();
-        const displayName = result.user.full_name || result.user.email;
-        console.log(`[ok] Autenticado como ${displayName}`);
-    }
-    catch (err) {
-        loginSpinner.fail(`Falha ao autenticar: ${err.message}`);
-        process.exit(1);
-    }
-}
-/** Cria a sessão autenticada (client Supabase + user) usada pelo resto do wizard. */
-export async function createSessionStep() {
-    const authSpinner = startSpinner("Carregando sessão...");
-    try {
-        const session = await createAuthenticatedClient();
-        authSpinner.stop();
+import { box, c, sym, cmd } from "../../../lib/colors.js";
+export async function requireLocalSessionStep() {
+    const session = await loadSession();
+    if (session)
         return session;
-    }
-    catch (err) {
-        authSpinner.fail(err.message);
-        process.exit(1);
-    }
+    console.log(box(`${c.yellow(sym.warn)} ${c.bold("Você ainda não está autenticado.")}\n` +
+        `${c.dim("crie um usuário:")} ${cmd(`${brand.name} register`)}\n` +
+        `${c.dim("depois entre com:")} ${cmd(`${brand.name} login`)}`, { borderColor: "yellow", title: "Autenticação necessária" }));
+    process.exit(1);
 }
 //# sourceMappingURL=auth-step.js.map

package/dist/cli/commands/init/auth-step.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth-step.js","sourceRoot":"","sources":["../../../../src/cli/commands/init/auth-step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,yBAAyB,EAA6B,MAAM,sCAAsC,CAAC;AAC5G,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,aAAa,GAAG,MAAM,eAAe,EAAE,CAAC;IAC9C,IAAI,aAAa;QAAE,OAAO;IAE1B,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,6BAA6B,KAAK,CAAC,MAAM,cAAc,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,CACb,MAAM,QAAQ,CAAC;QACb,OAAO,EAAE,QAAQ,CAAC,SAAS;QAC3B,IAAI,EAAE,GAAG;QACT,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAClB,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,QAAQ,CAAC,UAAU;KACzD,CAAC,CACH,CAAC,IAAI,EAAE,CAAC;IAET,MAAM,YAAY,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,eAAe,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QACvC,YAAY,CAAC,IAAI,EAAE,CAAC;QACpB,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,yBAAyB,WAAW,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,YAAY,CAAC,IAAI,CAAC,wBAAyB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,WAAW,GAAG,YAAY,CAAC,sBAAsB,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,yBAAyB,EAAE,CAAC;QAClD,WAAW,CAAC,IAAI,EAAE,CAAC;QACnB,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,WAAW,CAAC,IAAI,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"auth-step.js","sourceRoot":"","sources":["../../../../src/cli/commands/init/auth-step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAsB,MAAM,oCAAoC,CAAC;AACrF,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAQ1D,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,MAAM,OAAO,GAAG,MAAM,WAAW,EAAE,CAAC;IACpC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,OAAO,CAAC,GAAG,CACT,GAAG,CACD,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kCAAkC,CAAC,IAAI;QACrE,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,WAAW,CAAC,IAAI;QACjE,GAAG,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,QAAQ,CAAC,EAAE,EAC/D,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAC5D,CACF,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}