@nio-cli/cli 0.1.0

package/dist/auth.js

@@ -0,0 +1,118 @@
+import { mkdir, readFile, writeFile, chmod, rm } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { CREDENTIALS_FILE, PAT_REGEX, SUPABASE_ANON_KEY, TOKEN_EXCHANGE_URL, } from './constants.js';
+import { env } from './brand.js';
+export async function loadCredentials(file = CREDENTIALS_FILE) {
+    const stored = await readCredentialsFile(file);
+    // Precedência pro ambiente: usado por Desktop Extensions / Cowork, onde o PAT
+    // chega via user_config (NIO_PAT) em vez de `nio login`.
+    const envPat = env('PAT')?.trim();
+    if (envPat) {
+        // Cache do arquivo só serve se for do mesmo PAT.
+        return stored?.pat === envPat ? stored : { pat: envPat };
+    }
+    return stored;
+}
+async function readCredentialsFile(file) {
+    try {
+        const raw = await readFile(file, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed.pat !== 'string') {
+            return null;
+        }
+        return parsed;
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return null;
+        }
+        throw err;
+    }
+}
+export async function saveCredentials(creds, file = CREDENTIALS_FILE) {
+    await mkdir(dirname(file), { recursive: true });
+    await writeFile(file, JSON.stringify(creds, null, 2) + '\n', 'utf8');
+    try {
+        await chmod(file, 0o600);
+    }
+    catch {
+        // chmod pode falhar em Windows — ignoramos silenciosamente.
+    }
+}
+/**
+ * Identidade do cache quando houver; senão uma troca de PAT, populando o cache.
+ * 401/403 invalida o cache e propaga o erro (o chamador pede re-login).
+ */
+export async function resolveIdentity(creds, opts = {}) {
+    const file = opts.file ?? CREDENTIALS_FILE;
+    if (!opts.refresh && creds.user && creds.fetched_at) {
+        return { ...creds.user, fetched_at: creds.fetched_at };
+    }
+    let result;
+    try {
+        result = await exchangePatForJwt(creds.pat);
+    }
+    catch (err) {
+        const status = err.status;
+        if (status === 401 || status === 403) {
+            await patchCachedUser(file, null);
+        }
+        throw err;
+    }
+    const identity = { ...result.user, fetched_at: new Date().toISOString() };
+    await patchCachedUser(file, identity);
+    return identity;
+}
+// Só mexe num arquivo já existente: ambiente com PAT via env e sem credencial
+// gravada responde sem persistir nada.
+async function patchCachedUser(file, identity) {
+    const creds = await readCredentialsFile(file).catch(() => null);
+    if (!creds)
+        return;
+    if (identity) {
+        const { fetched_at, ...user } = identity;
+        creds.user = user;
+        creds.fetched_at = fetched_at;
+    }
+    else {
+        delete creds.user;
+        delete creds.fetched_at;
+    }
+    await saveCredentials(creds, file).catch(() => {
+        // filesystem read-only — cache é conveniência, segue sem persistir.
+    });
+}
+export async function clearCredentials() {
+    await rm(CREDENTIALS_FILE, { force: true });
+}
+export function validatePatFormat(pat) {
+    return PAT_REGEX.test(pat);
+}
+export async function exchangePatForJwt(pat) {
+    const response = await fetch(TOKEN_EXCHANGE_URL, {
+        method: 'POST',
+        headers: {
+            apikey: SUPABASE_ANON_KEY,
+            Authorization: `Bearer ${SUPABASE_ANON_KEY}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ token: pat }),
+    });
+    if (!response.ok) {
+        let message = response.statusText;
+        try {
+            const body = (await response.json());
+            if (body && typeof body.error === 'string' && body.error.length > 0) {
+                message = body.error;
+            }
+        }
+        catch {
+            // body não era JSON — mantém statusText
+        }
+        const err = new Error(message);
+        err.status = response.status;
+        throw err;
+    }
+    return (await response.json());
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/brand.js

@@ -0,0 +1,91 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Fonte única de verdade de marca/atribuição do CLI. Rebrandear = editar este arquivo — ao
+ * trocar, casar em lockstep: `package.json` (`name`/`bin`/`description`/`keywords`/`repository`)
+ * e os docs .md que citam tools literalmente (CLAUDE.md, SKILL.md, docs/specs/**\/*.md, e o `brand.skillsRepo` externo).
+ * A tabela de tools do README é GERADA — depois de editar aqui, rode `bun run gen:docs`.
+ *
+ * Rebrand NIO (docs/specs/rebrand/0005-noclaf-to-nio.md): sem compat com o nome antigo — nenhum
+ * fallback de `NOCLAF_*`/`~/.noclaf` no código. Duas pendências cross-sistema documentadas na
+ * spec, não resolvidas só por este arquivo: `patPrefix` (backend precisa aceitar o prefixo novo
+ * antes do deploy) e `webUrl` (auth desacoplada do domínio antigo — mecanismo definitivo em
+ * docs/specs/auth/0002-cli-native-login.md, ainda em aberto).
+ */
+export const brand = {
+    // --- Identidade / display ---
+    /** Nome do comando/binário principal (nome no help do CLI + `bin` do package.json). */
+    name: 'nio',
+    /** Nome curto do produto, mostrado a usuários e agentes. */
+    productName: 'NOS',
+    /** Nome completo do produto. PENDENTE: expansão real a confirmar (não pode reintroduzir "Noclaf"). */
+    productFullName: 'NOS',
+    /** Empresa / fornecedor. */
+    company: 'Falcao-Tech',
+    /** Org/usuário do GitHub que hospeda o repo atual da CLI. */
+    githubOrg: 'hugoreiis12-png',
+    /** Nome do repo no GitHub (casing exato, como criado). */
+    githubRepo: 'NIO-CLI',
+    /** Pacote npm — usado nas mensagens de atualização. Org real confirmada: `nio-cli` (não `nio`). */
+    packageName: '@nio-cli/cli',
+    /** Binário do servidor MCP (segundo `bin` do package.json). */
+    mcpBinName: 'nio-cli',
+    /** Chave sob a qual o servidor MCP é registrado nos configs dos clientes. */
+    mcpServerKey: 'nio',
+    // --- URLs / endpoints ---
+    /**
+     * Base do app web — DESACOPLADA por decisão do rebrand: a CLI não depende mais de um
+     * domínio externo pra autenticação. Vazio até `docs/specs/auth/0002-cli-native-login.md`
+     * definir o mecanismo; os pontos de uso (`cli/commands/auth.ts`, `init/auth-step.ts`) já
+     * tratam string vazia sem imprimir link quebrado.
+     */
+    webUrl: '',
+    supabaseUrl: 'https://wdshvtlsjoegjvmpqobx.supabase.co',
+    /** COPIE o literal de `src/constants.ts:6` — não redigite. */
+    supabaseAnonKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6Indkc2h2dGxzam9lZ2p2bXBxb2J4Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzU3NDA4OTQsImV4cCI6MjA5MTMxNjg5NH0.4wlAsT_D5gDiBQ19WA-q5zu105fT9TsD1NKI_tGQt-4',
+    // --- Filesystem / namespacing ---
+    /** Dir de dados no home → `~/.nio`. */
+    homeDirName: '.nio',
+    /** Arquivo de binding do projeto na raiz do repo. */
+    projectConfigFile: 'nio.json',
+    // --- Contratos ---
+    /** Prefixo das env vars: `NIO` → `NIO_PAT`, `NIO_CLIENT`, … Contrato externo: Cowork/Codex setam `NIO_CLIENT` de fora — trocar aqui exige trocar lá também. */
+    envPrefix: 'NIO',
+    /**
+     * Prefixo do PAT. ⚠️ MUDANÇA COORDENADA: o backend hoje só valida `noc_`. Publicar com
+     * `nio_` antes do backend aceitar o prefixo novo quebra login de todo mundo — ver nota
+     * na spec de rebrand (F11-T0.4).
+     */
+    patPrefix: 'nio_',
+    // --- Repo de skills ---
+    /** Refatorado por outro time (`noclaf-skills` → `nio-skills`). */
+    skillsRepo: 'hugoreiis12-png/NIO-SKILLS-',
+    skillsRef: 'main',
+    /** Pacote npm das skills — citado em mensagens de erro de "pacote não encontrado". ASSUME mesma org (`nio-cli`) do pacote da CLI — confirmar se as skills publicam em outro escopo. */
+    skillsPackage: '@nio-cli/skills',
+    // --- Prefixos dos nomes das tools MCP --- (dois por decisão de domínio: produto vs. CLI — mantidos separados no rebrand; formato validado pelos clientes MCP como `^[a-zA-Z0-9_-]{1,64}$`, só minúsculas/dígitos, termine com `_`)
+    /** Tools de domínio do produto: `nos_list_tasks`, `nos_move_task`, … (16 tools). Mantido — nomeia o produto NOS, não a marca da CLI. */
+    toolPrefix: 'nos_',
+    /** Tools que espelham verbos do CLI: `nio_plan`, `nio_exec_status`, … (4 tools). */
+    cliToolPrefix: 'nio_',
+};
+// Arte ASCII do `--help`/login — efeito Matrix, gerada por `renderMatrixLogo()`
+// em `./matrix-logo.js` (fora deste objeto: é lógica de renderização, não
+// valor de marca).
+// ponytail: prefixo do PAT assumido alfanumérico + `_`; se um dia tiver metachar de
+// regex, escapar antes de interpolar.
+/** Regex do formato do PAT, derivada do prefixo: `nio_` + 64 hex. */
+export const patRegex = new RegExp(`^${brand.patPrefix}[a-f0-9]{64}$`);
+/** Caminho dentro do dir de dados: `homePath('skills')` → `~/.nio/skills`. */
+export function homePath(...parts) {
+    return join(homedir(), brand.homeDirName, ...parts);
+}
+/** NOME completo da env var: `envName('CLIENT')` → `'NIO_CLIENT'`. */
+export function envName(name) {
+    return `${brand.envPrefix}_${name}`;
+}
+/** VALOR da env var prefixada: `env('PAT')` → `process.env.NIO_PAT`. */
+export function env(name) {
+    return process.env[envName(name)];
+}
+//# sourceMappingURL=brand.js.map

package/dist/brand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.js","sourceRoot":"","sources":["../src/brand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,+BAA+B;IAC/B,uFAAuF;IACvF,IAAI,EAAE,KAAK;IACX,4DAA4D;IAC5D,WAAW,EAAE,KAAK;IAClB,sGAAsG;IACtG,eAAe,EAAE,KAAK;IACtB,4BAA4B;IAC5B,OAAO,EAAE,aAAa;IACtB,6DAA6D;IAC7D,SAAS,EAAE,iBAAiB;IAC5B,0DAA0D;IAC1D,UAAU,EAAE,SAAS;IACrB,mGAAmG;IACnG,WAAW,EAAE,cAAc;IAC3B,+DAA+D;IAC/D,UAAU,EAAE,SAAS;IACrB,6EAA6E;IAC7E,YAAY,EAAE,KAAK;IAEnB,2BAA2B;IAC3B;;;;;OAKG;IACH,MAAM,EAAE,EAAE;IACV,WAAW,EAAE,0CAA0C;IACvD,8DAA8D;IAC9D,eAAe,EAAE,kNAAkN;IAEnO,mCAAmC;IACnC,uCAAuC;IACvC,WAAW,EAAE,MAAM;IACnB,qDAAqD;IACrD,iBAAiB,EAAE,UAAU;IAE7B,oBAAoB;IACpB,+JAA+J;IAC/J,SAAS,EAAE,KAAK;IAChB;;;;OAIG;IACH,SAAS,EAAE,MAAM;IAEjB,yBAAyB;IACzB,kEAAkE;IAClE,UAAU,EAAE,6BAA6B;IACzC,SAAS,EAAE,MAAM;IACjB,uLAAuL;IACvL,aAAa,EAAE,iBAAiB;IAEhC,oOAAoO;IACpO,wIAAwI;IACxI,UAAU,EAAE,MAAM;IAClB,oFAAoF;IACpF,aAAa,EAAE,MAAM;CACb,CAAC;AAEX,gFAAgF;AAChF,0EAA0E;AAC1E,mBAAmB;AAEnB,oFAAoF;AACpF,sCAAsC;AACtC,qEAAqE;AACrE,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,eAAe,CAAC,CAAC;AAEvE,8EAA8E;AAC9E,MAAM,UAAU,QAAQ,CAAC,GAAG,KAAe;IACzC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;AACtC,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,GAAG,CAAC,IAAY;IAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AACpC,CAAC"}

package/dist/cli/commands/auth.js

@@ -0,0 +1,128 @@
+import { password } from "../../lib/prompts.js";
+import { brand } from "../../brand.js";
+import { renderMatrixLogo } from "../../matrix-logo.js";
+import { startSpinner } from "../../spinner.js";
+import { clearCredentials, exchangePatForJwt, loadCredentials, resolveIdentity, saveCredentials, validatePatFormat, } from "../../auth.js";
+import { authCopy } from "../copy.js";
+/** Obtém o PAT: usa o argumento se veio preenchido, senão pede via prompt mascarado. */
+async function resolvePat(patArg) {
+    const trimmed = patArg?.trim();
+    if (trimmed)
+        return trimmed;
+    if (brand.webUrl)
+        console.log(`Gere um token pessoal em: ${brand.webUrl}/profile#mcp`);
+    const answer = await password({
+        message: authCopy.login.patPrompt,
+        mask: "*",
+        validate: (input) => validatePatFormat(input.trim()) || authCopy.login.patInvalid,
+    });
+    return answer.trim();
+}
+/** Troca o PAT por sessão e persiste as credenciais localmente. */
+async function performLogin(pat) {
+    const result = await exchangePatForJwt(pat);
+    await saveCredentials({
+        pat,
+        user: result.user,
+        fetched_at: new Date().toISOString(),
+    });
+    return result;
+}
+function printLoginSuccess(u) {
+    console.log(renderMatrixLogo());
+    console.log("[ok] Autenticado!");
+    console.log(`Nome:    ${u.full_name || "(sem nome)"}`);
+    console.log(`Usuário: ${u.username ? `@${u.username}` : "(sem username)"}`);
+    console.log(`Email:   ${u.email}`);
+}
+/** Decide se dá pra pular o spinner de validação: só quando a sessão já está em
+ * cache (usuário + data de fetch salvos) e o caller não pediu revalidação forçada. */
+export function shouldSkipWhoamiSpinner(creds, refresh) {
+    return !refresh && Boolean(creds.user && creds.fetched_at);
+}
+/** Traduz o erro de `resolveIdentity` pra mensagem exibida ao usuário. */
+export function whoamiErrorMessage(err) {
+    const status = err.status;
+    return status === 401 || status === 403
+        ? `Sessão inválida. Rode \`${brand.name} login <PAT>\` novamente.`
+        : `Falha ao validar token: ${err.message}`;
+}
+function printWhoamiIdentity(u) {
+    console.log(renderMatrixLogo());
+    console.log(`Nome:    ${u.full_name || "(sem nome)"}`);
+    console.log(`Email:   ${u.email}`);
+    console.log(`Usuário: ${u.username ? `@${u.username}` : "(sem username)"}`);
+    console.log(`ID:      ${u.id}`);
+}
+function registerLoginCommand(program) {
+    program
+        .command("login")
+        .description("Salva o token de acesso pessoal (PAT) localmente")
+        .argument("[pat]", "Token gerado em /profile#mcp do NOS (opcional — será pedido se omitido)")
+        .action(async (patArg) => {
+        const pat = await resolvePat(patArg);
+        if (!validatePatFormat(pat)) {
+            console.error(`Token inválido. Formato esperado: \`${brand.patPrefix}\` + 64 caracteres hexadecimais.`);
+            process.exit(1);
+        }
+        const spinner = startSpinner("Autenticando...");
+        try {
+            const result = await performLogin(pat);
+            spinner.stop();
+            printLoginSuccess(result.user);
+        }
+        catch (err) {
+            spinner.fail(`Falha ao autenticar: ${err.message}`);
+            process.exit(1);
+        }
+    });
+}
+function registerLogoutCommand(program) {
+    program
+        .command("logout")
+        .description("Remove credenciais locais")
+        .action(async () => {
+        await clearCredentials();
+        console.log("Sessão removida.");
+    });
+}
+async function runWhoamiAction(opts) {
+    const creds = await loadCredentials();
+    if (!creds) {
+        console.error(`Não autenticado. Rode \`${brand.name} login <PAT>\`.`);
+        process.exit(1);
+    }
+    const cached = shouldSkipWhoamiSpinner(creds, opts.refresh);
+    const spinner = cached || opts.json ? null : startSpinner("Validando sessão...");
+    try {
+        const u = await resolveIdentity(creds, { refresh: opts.refresh });
+        spinner?.stop();
+        if (opts.json) {
+            console.log(JSON.stringify(u, null, 2));
+            return;
+        }
+        printWhoamiIdentity(u);
+    }
+    catch (err) {
+        const message = whoamiErrorMessage(err);
+        if (spinner)
+            spinner.fail(message);
+        else
+            console.error(message);
+        process.exit(1);
+    }
+}
+function registerWhoamiCommand(program) {
+    program
+        .command("whoami")
+        .description("Mostra o usuário autenticado")
+        .option("--json", "Emite a identidade como JSON")
+        .option("--refresh", "Ignora o cache e revalida o token")
+        .action(runWhoamiAction);
+}
+export function registerAuthCommands(program) {
+    registerLoginCommand(program);
+    registerLogoutCommand(program);
+    registerWhoamiCommand(program);
+}
+//# sourceMappingURL=auth.js.map

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

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

package/dist/cli/commands/clean.js

@@ -0,0 +1,120 @@
+import { rmSync, lstatSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { confirm } from "../../lib/prompts.js";
+import { readSkillDocs } from "../../lib/skills.js";
+import { c, sym } from "../../lib/colors.js";
+/**
+ * Comando de limpeza: remove artefatos **legados** que versões antigas do nio
+ * instalaram e que hoje foram substituídos — commands que viraram skills, ou
+ * commands removidos de vez. Roda em `~/.claude` (Claude Code) e `~/.codex` (Codex).
+ */
+// Removidos de vez (não existem mais em nenhum formato).
+const FULLY_REMOVED = [
+    "new-spec",
+    "new-bug",
+    "new-adr",
+    "apply-spec",
+    "apply-bug",
+    "to-skill",
+];
+// Eram commands e viraram skills — só o **command** legado deve sair (a skill atual fica).
+const COMMAND_TO_SKILL = ["init-sdd", "to-tickets"];
+/** Existe no disco (inclui symlink pendurado, que `existsSync` não pega)? */
+function present(path) {
+    try {
+        lstatSync(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Ids atualmente válidos no bundle — guarda pra nunca remover algo em uso. */
+function currentIds() {
+    try {
+        const docs = readSkillDocs();
+        return {
+            skills: new Set(docs.filter((d) => d.type === "skill").map((d) => d.id)),
+            commands: new Set(docs.filter((d) => d.type === "command").map((d) => d.id)),
+        };
+    }
+    catch {
+        return { skills: new Set(), commands: new Set() };
+    }
+}
+function collectLegacy() {
+    const cur = currentIds();
+    const out = [];
+    const add = (path, kind) => {
+        if (present(path))
+            out.push({ path, kind });
+    };
+    const claude = join(homedir(), ".claude");
+    const codex = join(homedir(), ".codex");
+    // Claude Code — commands legados (nenhum desses é command atual).
+    for (const id of [...FULLY_REMOVED, ...COMMAND_TO_SKILL]) {
+        if (!cur.commands.has(id))
+            add(join(claude, "commands", `${id}.md`), "claude command");
+    }
+    // Claude Code — skills só dos removidos de vez (init-sdd/to-tickets são skills atuais).
+    for (const id of FULLY_REMOVED) {
+        if (!cur.skills.has(id))
+            add(join(claude, "skills", id), "claude skill");
+    }
+    // Codex — dual-write dos removidos de vez (prompt + skill traduzida).
+    for (const id of FULLY_REMOVED) {
+        if (!cur.commands.has(id) && !cur.skills.has(id)) {
+            add(join(codex, "prompts", `${id}.md`), "codex prompt");
+            add(join(codex, "skills", id), "codex skill");
+        }
+    }
+    return out;
+}
+export function registerCleanCommand(program) {
+    program
+        .command("clean-legacy")
+        .description("Remove commands/skills legados (substituídos) de ~/.claude e ~/.codex")
+        .option("--dry-run", "só lista o que seria removido, sem apagar")
+        .option("-y, --yes", "remove sem pedir confirmação")
+        .action(async (opts) => {
+        const targets = collectLegacy();
+        if (targets.length === 0) {
+            console.log("");
+            console.log(`  ${c.green(sym.ok)} nada legado encontrado — já está limpo.`);
+            return;
+        }
+        console.log("");
+        console.log(`  ${c.bold("Artefatos legados encontrados:")}`);
+        for (const t of targets) {
+            console.log(`    ${c.red("-")} ${t.path} ${c.dim(`(${t.kind})`)}`);
+        }
+        if (opts.dryRun) {
+            console.log("");
+            console.log(`  ${c.dim("[dry-run] nada removido.")}`);
+            return;
+        }
+        const ok = opts.yes === true ||
+            (await confirm({
+                message: `Remover ${targets.length} item(ns) legado(s)?`,
+                default: false,
+            }));
+        if (!ok) {
+            console.log(`  ${c.dim("cancelado.")}`);
+            return;
+        }
+        let removed = 0;
+        for (const t of targets) {
+            try {
+                rmSync(t.path, { recursive: true, force: true });
+                removed++;
+            }
+            catch (err) {
+                console.error(`  ${c.red(sym.err)} falha ao remover ${t.path}: ${err.message}`);
+            }
+        }
+        console.log("");
+        console.log(`  ${c.green(sym.ok)} ${removed} removido(s). Reinicie os clientes pra refletir.`);
+    });
+}
+//# sourceMappingURL=clean.js.map

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

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

package/dist/cli/commands/completion.js

@@ -0,0 +1,114 @@
+import { c, cmd } from "../../lib/colors.js";
+import { brand } from "../../brand.js";
+/** Nome do binário — vai literal nos scripts de completion gerados. */
+const bin = brand.name;
+function optFlags(command) {
+    const flags = [];
+    const opts = command.options;
+    for (const o of opts) {
+        if (o.long)
+            flags.push(o.long);
+        if (o.short)
+            flags.push(o.short);
+    }
+    flags.push("--help");
+    return flags;
+}
+function walk(command) {
+    return {
+        name: command.name(),
+        subs: command.commands.map(walk),
+        opts: optFlags(command),
+    };
+}
+/** Candidatos no nível 2 de um comando: seus subcomandos + suas flags. */
+function level2(node) {
+    return [...node.subs.map((s) => s.name), ...node.opts].join(" ");
+}
+function bashScript(root) {
+    const top = root.subs.map((s) => s.name).join(" ");
+    const arms = root.subs
+        .filter((s) => s.subs.length > 0 || s.opts.length > 1)
+        .map((s) => `    ${s.name}) __c="${level2(s)}" ;;`)
+        .join("\n");
+    return `# ${bin} bash completion — gere com: ${bin} completion bash
+_${bin}() {
+  local cur="\${COMP_WORDS[COMP_CWORD]}"
+  local __c=""
+  if [ "\$COMP_CWORD" -eq 1 ]; then
+    __c="${top}"
+  else
+    case "\${COMP_WORDS[1]}" in
+${arms}
+    *) __c="--help" ;;
+    esac
+  fi
+  COMPREPLY=( \$(compgen -W "\$__c" -- "\$cur") )
+}
+complete -F _${bin} ${bin}`;
+}
+function zshScript(root) {
+    const top = root.subs.map((s) => s.name).join(" ");
+    const arms = root.subs
+        .filter((s) => s.subs.length > 0 || s.opts.length > 1)
+        .map((s) => `      ${s.name}) __c=(${level2(s)}) ;;`)
+        .join("\n");
+    return `#compdef ${bin}
+# ${bin} zsh completion — gere com: ${bin} completion zsh
+_${bin}() {
+  local -a __c
+  if (( CURRENT == 2 )); then
+    __c=(${top})
+  else
+    case $words[2] in
+${arms}
+    *) __c=(--help) ;;
+    esac
+  fi
+  compadd -a __c
+}
+compdef _${bin} ${bin}`;
+}
+function fishScript(root) {
+    const lines = [
+        `# ${bin} fish completion — gere com: ${bin} completion fish`,
+        `complete -c ${bin} -f`,
+    ];
+    const top = root.subs.map((s) => s.name).join(" ");
+    lines.push(`complete -c ${bin} -n '__fish_use_subcommand' -a '${top}'`);
+    for (const s of root.subs) {
+        const cands = [...s.subs.map((x) => x.name), ...s.opts].join(" ");
+        lines.push(`complete -c ${bin} -n '__fish_seen_subcommand_from ${s.name}' -a '${cands}'`);
+    }
+    return lines.join("\n");
+}
+function detectShell() {
+    const sh = (process.env.SHELL ?? "").split("/").pop();
+    if (sh === "bash" || sh === "zsh" || sh === "fish")
+        return sh;
+    return null;
+}
+export function registerCompletionCommand(program) {
+    program
+        .command("completion [shell]")
+        .description(`Imprime o script de autocomplete (bash|zsh|fish). Ex.: eval "$(${bin} completion zsh)"`)
+        .action((shellArg) => {
+        const shell = shellArg ?? detectShell();
+        if (shell !== "bash" && shell !== "zsh" && shell !== "fish") {
+            console.error(`${c.yellow("shell não reconhecido.")} Use: ${cmd(`${bin} completion`)} ` +
+                `${c.dim("bash|zsh|fish")}`);
+            process.exitCode = 1;
+            return;
+        }
+        const root = walk(program);
+        const script = shell === "bash"
+            ? bashScript(root)
+            : shell === "zsh"
+                ? zshScript(root)
+                : fishScript(root);
+        // Dica no stderr (o `eval "$(...)"` captura só o stdout, então não polui).
+        console.error(`${c.dim("# adicione ao seu rc:")} ${cmd(`eval "$(${bin} completion ${shell})"`)}`);
+        console.log(script);
+    });
+}
+//# sourceMappingURL=completion.js.map

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

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