@autonsh/cli 0.17.2 → 0.19.0

package/dist/index.js

@@ -19,9 +19,15 @@ import { cmdModel, modelLs, modelSet, modelTest } from "./model.js";
 import { cmdChat } from "./chat.js";
 import { resolveAgent } from "./picker.js";
 import { getDefaultModel, getActiveProvider } from "./config.js";
-import { TEMPLATES, promptInit, promptConfirmUndeploy, promptGateApproval, promptGateQuestion, parseGateLine, } from "./prompts.js";
+import { AutonError, exitCodeFor, formatError } from "./errors.js";
+import { promptInit, promptConfirmUndeploy, promptGateApproval, promptGateQuestion, parseGateLine, listTemplatesForDisplay, } from "./prompts.js";
+import { getTemplateRegistry } from "./template-registry.js";
+import { renderTemplate } from "./template-engine.js";
 import { loadTaskManifest, MODES, SKILLS, EXIT, ExitError, } from "./task.js";
 import { runVerify } from "./verify.js";
+import { createUiLogger, parseVerboseFlag } from "./verbose.js";
+import { cmdDoctor } from "./doctor.js";
+import { cmdCompletion } from "./completion.js";
 const SRC = dirname(fileURLToPath(import.meta.url));
 // runtime package real (monorepo). CLI linka em node_modules/@autonsh/runtime
 // do diretório do agente → handler importa "@autonsh/runtime" de qualquer lugar.
@@ -109,59 +115,113 @@ async function installRuntime(dir) {
         bar.stop();
     }
 }
-async function cmdInit(name, template, opts = {}) {
+async function cmdInit(name, templateId, opts = {}) {
+    const registry = await getTemplateRegistry();
+    const template = await registry.get(templateId);
+    if (!template) {
+        throw new ExitError(EXIT.USAGE, `template não encontrado: ${templateId}. Rode 'auton template list' para ver disponíveis.`);
+    }
     const plain = name === "." ? basename(process.cwd()) : name;
     const dir = resolve(name === "." ? process.cwd() : join(process.cwd(), name));
     if (existsSync(dir) && readdirSync(dir).length > 0) {
         throw new ExitError(EXIT.USAGE, `diretório não vazio: ${dir}`);
     }
+    // Prepara contexto de renderização
+    const context = {
+        name: plain,
+        ...opts.variables,
+    };
+    if (opts.dryRun) {
+        console.log(info(`[dry-run] Scaffold seria criado em: ${dir}`));
+        console.log(info(`[dry-run] Template: ${template.name} (${template.id})`));
+        console.log(info(`[dry-run] Variáveis: ${JSON.stringify(context, null, 2)}`));
+        return;
+    }
     mkdirSync(dir, { recursive: true });
-    cpSync(join(TEMPLATES_SRC, template), dir, { recursive: true });
-    // seta o nome real no manifest (task.yaml desde 0.9.1)
+    // Renderiza template via engine (Handlebars)
+    const result = await renderTemplate(template, context, dir);
+    // Substitui name no task.yaml (backward compat: templates built-in têm name hardcoded)
     const yamlPath = join(dir, "task.yaml");
-    const yaml = (await readFile(yamlPath, "utf8")).replace(/^name: .*$/m, `name: ${plain}`);
-    await writeFile(yamlPath, yaml);
-    // mode (pivô 0.11): permissões do worker; docs do modo viram agent.md do projeto.
+    if (existsSync(yamlPath)) {
+        let yaml = await readFile(yamlPath, "utf8");
+        yaml = yaml.replace(/^name: .*$/m, `name: ${plain}`);
+        await writeFile(yamlPath, yaml);
+    }
+    // Garante package.json (pode vir do template ou ser gerado)
+    const pkgPath = join(dir, "package.json");
+    if (!existsSync(pkgPath)) {
+        const pkgName = plain.toLowerCase().replace(/[^a-z0-9._-]/g, "-");
+        await writeFile(pkgPath, JSON.stringify({
+            name: pkgName || "agent",
+            version: "0.0.0",
+            private: true,
+            type: "module",
+            dependencies: { "@autonsh/runtime": "^0.11.0" },
+        }, null, 2) + "\n");
+    }
+    // Genesis custom (se fornecido via --genesis ou prompt)
+    if (opts.genesis) {
+        const yamlPath = join(dir, "task.yaml");
+        let yaml = await readFile(yamlPath, "utf8");
+        // Substitui ou adiciona bloco genesis
+        if (yaml.includes("genesis:")) {
+            yaml = yaml.replace(/^genesis:[\s\S]*?(?=\n\S|\n*$)/m, `genesis: |\n  ${opts.genesis.replace(/\n/g, "\n  ")}\n`);
+        }
+        else {
+            yaml += `\ngenesis: |\n  ${opts.genesis.replace(/\n/g, "\n  ")}\n`;
+        }
+        await writeFile(yamlPath, yaml);
+    }
+    // Mode + skills do template (podem ser sobrescritos por opts)
     const mode = opts.mode && MODES.includes(opts.mode)
         ? opts.mode
-        : "build";
+        : template.defaultMode;
+    const skills = (opts.skills ?? template.skills).filter((s) => SKILLS.includes(s));
+    // Atualiza task.yaml com mode/skills apenas se override explícito
+    if (opts.mode || opts.skills) {
+        const yamlPath2 = join(dir, "task.yaml");
+        let yaml = await readFile(yamlPath2, "utf8");
+        yaml = yaml
+            .split("\n")
+            .filter((line) => !/^(mode|skills):/m.test(line) && !/^\s*-\s/.test(line))
+            .join("\n")
+            .trimEnd()
+            .concat("\n", `mode: ${mode}`, skills.length > 0
+            ? `\nskills:\n${skills.map((s) => `  - ${s}`).join("\n")}`
+            : "")
+            .concat("\n");
+        await writeFile(yamlPath2, yaml);
+    }
+    // Copia agent.md do modo se não existir
     const modeDoc = join(TEMPLATES_SRC, "modes", mode, "agent.md");
-    if (existsSync(modeDoc)) {
+    if (existsSync(modeDoc) && !existsSync(join(dir, "agent.md"))) {
         cpSync(modeDoc, join(dir, "agent.md"));
     }
-    const skills = (opts.skills ?? []).filter((s) => SKILLS.includes(s));
+    // Skills built-in
     for (const s of skills) {
-        cpSync(join(TEMPLATES_SRC, "skills", s, "SKILL.md"), join(dir, "skills", s, "SKILL.md"), {
-            recursive: true,
-        });
+        try {
+            cpSync(join(TEMPLATES_SRC, "skills", s, "SKILL.md"), join(dir, "skills", s, "SKILL.md"), {
+                recursive: true,
+            });
+        }
+        catch {
+            // skill não existe — ignora
+        }
     }
-    await writeFile(yamlPath, yaml
-        .split("\n")
-        .filter((line) => !/^(mode|skills):/m.test(line))
-        .join("\n")
-        .trimEnd()
-        .concat("\n", `mode: ${mode}`, skills.length > 0
-        ? `\nskills:\n${skills.map((s) => `  - ${s}`).join("\n")}`
-        : "")
-        .concat("\n"));
-    // package.json do projeto (0.0.7): remove o passo manual de criar pacote.
-    // `npm install` abaixo salva/adiciona a dep se preciso; aqui o pacote já existe.
-    const pkgName = plain.toLowerCase().replace(/[^a-z0-9._-]/g, "-");
-    await writeFile(join(dir, "package.json"), JSON.stringify({
-        name: pkgName || "agent",
-        version: "0.0.0",
-        private: true,
-        type: "module",
-        dependencies: { "@autonsh/runtime": "^0.11.0" },
-    }, null, 2) + "\n");
     ensureRuntimeLink(dir);
     if (!HAS_LOCAL_RUNTIME) {
         await installRuntime(dir);
     }
     if (isTTY)
         console.log(logo());
-    console.log(ok(`${plain} (template: ${template}) em ${dim(dir)}`));
+    console.log(ok(`${plain} (template: ${template.name}) em ${dim(dir)}`));
     console.log(info(`próximo: ${bold(`cd ${plain} && auton run "<objetivo>"`)}`));
+    // Deploy opcional
+    if (opts.deploy) {
+        console.log(info(`deployando ${bold(plain)}...`));
+        await cmdDeploy(dir);
+        console.log(ok(`${plain} deployado`));
+    }
 }
 const VERSION = JSON.parse(readFileSync(resolve(SRC, "../package.json"), "utf8")).version;
 const API = process.env.AUTON_API ?? "http://localhost:8080";
@@ -170,69 +230,27 @@ let cpStarted = false;
 async function ensureCPRunning() {
     if (cpStarted)
         return;
-    try {
-        const res = await fetch(`${API}/v1/agents`, {
-            method: "GET",
-            headers: authHeaders(),
-            signal: AbortSignal.timeout(1000),
-        });
-        if (res.ok) {
-            cpStarted = true;
-            return;
-        }
-    }
-    catch {
-        // CP não responde — tenta iniciar
-    }
-    // Tenta achar binário do control-plane
-    const candidates = [
-        // monorepo dev
-        resolve(SRC, "../../control-plane/bin/control-plane"),
-        // npm install global (se publicado)
-        resolve(process.execPath, "../../lib/node_modules/@autonsh/server/bin/control-plane"),
-        // fallback PATH
-        "control-plane",
-    ];
-    let cpBin = null;
-    for (const c of candidates) {
-        try {
-            await import("node:fs/promises").then((fs) => fs.access(c, fs.constants.X_OK));
-            cpBin = c;
-            break;
-        }
-        catch {
-            // não existe ou não executável
-        }
-    }
-    if (!cpBin) {
-        console.log(dim("aviso: control-plane não encontrado — assumindo externo"));
-        return;
-    }
-    console.log(info(`iniciando control-plane (${cpBin})...`));
-    const child = spawn(cpBin, {
-        detached: true,
-        stdio: ["ignore", "ignore", "ignore"],
-    });
-    child.unref();
-    // Aguarda CP subir (max 5s)
-    for (let i = 0; i < 50; i++) {
-        await new Promise((r) => setTimeout(r, 100));
+    // Retry loop: 10x com 500ms = 5s total
+    for (let i = 0; i < 10; i++) {
         try {
             const res = await fetch(`${API}/v1/agents`, {
+                method: "GET",
                 headers: authHeaders(),
                 signal: AbortSignal.timeout(500),
             });
             if (res.ok) {
                 cpStarted = true;
-                console.log(ok("control-plane iniciado"));
                 return;
             }
         }
         catch {
-            // ainda subindo
+            // CP não responde ainda
         }
+        if (i < 9)
+            await new Promise((r) => setTimeout(r, 500));
     }
-    console.log(dim("aviso: control-plane pode não ter subido a tempo"));
+    // Não subiu em 5s — assume CP externo (já rodando em outra porta/host)
+    console.log(dim("aviso: control-plane não respondeu em 5s — assumindo externo"));
 }
 function authHeaders(extra) {
     const h = { ...extra };
@@ -261,29 +279,33 @@ Usage:
 
 Modelos:
   auton model                       Seletor interativo do modelo default
-                                     (local ollama + providers configurados)
+                                      (local ollama + providers configurados)
   auton model ls [--json]           Lista modelos locais + providers
   auton model set <spec>            Define default (ex: ollama:qwen3)
   auton model test                  Testa latência dos providers
+  auton model search <query> [--json] Busca fuzzy no registry (id/name/aliases)
+  auton model info <spec> [--json]  Detalhes do modelo (caps, context, cost, etc)
+  auton model pull <spec> [--json]  Baixa ollama:* ou valida credencial remota
+  auton model rm <id> [--json]      Remove provider do config pelo id
   auton login [provider] [--apikey X]
-                                    Conecta provider (gemini/groq/ollama)
+                                      Conecta provider (gemini/groq/ollama)
   auton logout [id]                 Remove provider configurado
 
 Agentes:
   auton [nome]                      Sessão de trabalho (estilo opencode): dá
-                                     tasks, acompanha o agente ao vivo, gates
-                                     inline. Sem nome: cwd/picker.
+                                      tasks, acompanha o agente ao vivo, gates
+                                      inline. Sem nome: cwd/picker.
   auton chat [name]                 Alias da sessão de trabalho
   auton agent [dir]                 Deploy do agente no diretório
   auton ps                          Lista agentes + status
   auton logs [name] [--tail N] [--follow] [--since X] [--turn N]
-                                    Stream de logs do agente (SSE)
+                                      Stream de logs do agente (SSE)
   auton status [name]               Status do agente
   auton restart [name]              Reinicia o agente
   auton invoke [name] [--stream] [-- prompt]
-                                    Roda 1 turno (legado v0)
+                                      Roda 1 turno (legado v0)
   auton approve|reject [name] [-- razão]
-                                    Decide o gate de aprovação
+                                      Decide o gate de aprovação
   auton answer [name] [-- texto]    Responde pergunta pendente (ctx.ask)
   auton context [name]              Work context: decisions/findings/artifacts
   auton undeploy [name]             Remove o agente (--all remove tudo)
@@ -296,13 +318,22 @@ Tasks:
   auton verify [dir] [--json]         Roda gates mecânicos do verify
   auton inspect [dir] [--json]        Inspeciona task + evidência
   auton continue [name] [goal]        Retoma a última task (sem redeploy)
-  auton init [nome] [template]        Scaffold de task (support|with-approval|...)
+  auton init [nome] [template] [--mode=X] [--skills=a,b] [--deploy] [--dry-run] [--genesis] [--var key=value]
+                                      Scaffold de task (templates built-in + custom)
+
+Templates:
+  auton template list [--json]        Lista templates (built-in + custom)
+  auton template create <id>          Cria template custom (futuro)
 
 Infra:
   auton kv get|set|ls [name] [key] [value]
-                                    Inspeciona o storage KV
+                                        Inspeciona o storage KV
   auton env set|get|ls [name] [key] [value]
-                                    Env vars por agente
+                                        Env vars por agente
+
+Sistema:
+  auton doctor [--json]                   Valida ambiente (config, creds, ollama, mcp, sandbox, disco, node, go)
+  auton completion <bash|zsh|fish>        Gera script de completion para shell
 
 Options:
   --help, -h                 Mostra ajuda
@@ -323,7 +354,7 @@ function pickEnv(keys) {
     }
     return out;
 }
-async function cmdDeploy(dir, extraEnv) {
+async function cmdDeploy(dir, extraEnv, models) {
     const manifest = await loadTaskManifest(dir);
     if (manifest.legacy) {
         console.log(dim(`aviso: ${bold("agent.yaml")} é legado v0 — renomeie para ${bold("task.yaml")}`));
@@ -338,7 +369,7 @@ async function cmdDeploy(dir, extraEnv) {
                 entry: manifest.entry,
                 dir,
                 env: { ...pickEnv(manifest.env), ...extraEnv },
-                models: manifest.models,
+                models: models ?? manifest.models,
                 cron: manifest.cron,
                 mode: manifest.mode,
                 invoke_timeout_ms: manifest.invokeTimeoutMs,
@@ -545,10 +576,11 @@ async function cmdRun(dir, goalArg, skipVerify, model) {
     }
     // 0.17: modelo efetivo = --model > task.yaml > env > config default (auton model)
     const defaultModel = getDefaultModel();
-    await precheckModel(model ?? manifest.models ?? process.env.AUTON_MODEL ?? defaultModel);
+    const resolvedModel = model ?? (manifest.models || undefined) ?? process.env.AUTON_MODEL ?? defaultModel;
+    await precheckModel(resolvedModel);
     // 0.15.1: credencial do `auton login` injetada no deploy (key/base);
     // --model (0.14.3) sobrescreve models: do task.yaml
-    await cmdDeploy(dir, { ...credentialEnv(), ...(model ? { AUTON_MODEL: model } : {}) });
+    await cmdDeploy(dir, { ...credentialEnv(), AUTON_MODEL: resolvedModel }, resolvedModel);
     const lines = await runWithGates(manifest.name, goal);
     await printTaskDone(manifest.name, goal, lines);
 }
@@ -562,8 +594,9 @@ async function cmdRunAsync(dir, goalArg, skipVerify, model) {
         throw new Error(`task ${manifest.name} sem objetivo — passe "auton run \"<objetivo>\" --async" ou defina 'goal' no task.yaml`);
     }
     const defaultModel = getDefaultModel();
-    await precheckModel(model ?? manifest.models ?? process.env.AUTON_MODEL ?? defaultModel);
-    await cmdDeploy(dir, { ...credentialEnv(), ...(model ? { AUTON_MODEL: model } : {}) });
+    const resolvedModel = model ?? (manifest.models || undefined) ?? process.env.AUTON_MODEL ?? defaultModel;
+    await precheckModel(resolvedModel);
+    await cmdDeploy(dir, { ...credentialEnv(), AUTON_MODEL: resolvedModel }, resolvedModel);
     // Gera task-id único: agent-name + timestamp + random
     const taskId = `${manifest.name}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
     // Dispara invoke sem aguardar (fire-and-forget)
@@ -1057,7 +1090,10 @@ async function cmdInvoke(name, prompt, stream) {
                 if (res.status === 408) {
                     // 0.16.11: aviso cedo + poll de logs em vez de exit 5 seco
                     console.log(info(`invoke estourou o timeout — turno segue em background, acompanhando...`));
-                    return await pollBackground(agent);
+                    const bgLines = await pollBackground(agent);
+                    for (const line of bgLines)
+                        console.log(line);
+                    return bgLines;
                 }
                 throw new Error(`control plane ${res.status}: ${await res.text()}`);
             }
@@ -1303,13 +1339,80 @@ async function cmdLogin(realArgs) {
 async function cmdLogout(providerId) {
     await logoutCmd(providerId);
 }
+/** Project mode: `auton` bare — se não há agente, cria + deploya + entra no chat. */
+async function cmdProject() {
+    // 1. Tenta achar agente no cwd (task.yaml)
+    let agentName;
+    try {
+        const { loadTaskManifest } = await import("./task.js");
+        const manifest = await loadTaskManifest(process.cwd());
+        if (manifest?.name)
+            agentName = manifest.name;
+    }
+    catch {
+        // sem task.yaml
+    }
+    // 2. Se não há no cwd, tenta deployed agents
+    if (!agentName) {
+        const deployed = await listAgentNames();
+        if (deployed.length === 1) {
+            agentName = deployed[0];
+        }
+        else if (deployed.length > 1) {
+            // Múltiplos deployados — usa picker (cmdChat já faz isso)
+            await cmdChat(undefined);
+            return;
+        }
+    }
+    // 3. Tem agente (cwd ou único deployado) → entra no chat
+    if (agentName) {
+        console.log(info(`entrando no agente ${bold(agentName)}...`));
+        await cmdChat(agentName);
+        return;
+    }
+    // 4. Nenhum agente — oferece init interativo
+    console.log(box("auton — nenhum agente encontrado", [
+        "Este diretório não tem task.yaml e não há agentes deployados.",
+        "Quer criar um novo agente aqui?",
+    ]));
+    const { confirm } = await import("@clack/prompts");
+    const create = await confirm({
+        message: "criar novo agente neste diretório?",
+        active: "sim",
+        inactive: "não",
+    });
+    if (!create) {
+        console.log(dim("até logo."));
+        return;
+    }
+    // Init interativo
+    const { promptInit } = await import("./prompts.js");
+    const p = await promptInit();
+    // Deploy automático
+    console.log(info(`criando e deployando ${bold(p.name)}...`));
+    await cmdInit(p.name, p.templateId, {
+        mode: p.mode,
+        skills: p.skills,
+        genesis: p.genesis,
+        deploy: true,
+        dryRun: false,
+        variables: p.variables,
+    });
+    // Entra no chat
+    console.log(info(`entrando no agente ${bold(p.name)}...`));
+    await cmdChat(p.name);
+}
 async function main() {
     let realArgs = process.argv.slice(2);
+    // Parse --verbose global flag
+    const { verbose, remainingArgs } = parseVerboseFlag(realArgs);
+    const logger = createUiLogger(verbose);
+    realArgs = remainingArgs;
     // G3: auto-start CP para comandos que precisam dele (--no-auto-cp desliga)
     const noAutoCP = realArgs.includes("--no-auto-cp");
-    const noCP = new Set(["login", "logout", "model", "--help", "-h", "--version", "-v", "init"]);
+    const noCP = new Set(["login", "logout", "model", "--help", "-h", "--version", "-v", "init", "doctor", "completion"]);
     const cmd = realArgs[0];
-    if (!noAutoCP && cmd && !noCP.has(cmd)) {
+    if (!noAutoCP && (!cmd || !noCP.has(cmd))) {
         await ensureCPRunning();
     }
     // Remove --no-auto-cp dos realArgs antes do switch
@@ -1317,8 +1420,9 @@ async function main() {
     if (realArgs.length === 0) {
         // 0.17.0 — `auton` bare: abre sessão de trabalho (estilo opencode):
         // cwd é agente → sessão nele; senão picker. Pipe: mosta ajuda.
+        // NOVO: project mode — se não há agente, oferece init + deploy + chat
         if (isTTY) {
-            await cmdChat(undefined);
+            await cmdProject();
             return;
         }
         console.log(USAGE);
@@ -1345,6 +1449,7 @@ async function main() {
         "login", "logout", "model", "agent", "logs", "status", "restart", "run",
         "verify", "inspect", "continue", "invoke", "undeploy", "approve", "reject",
         "ps", "context", "env", "init", "kv", "chat", "answer", "wait", "result",
+        "template", "doctor", "completion",
     ]);
     if (!KNOWN.has(realArgs[0]) && isTTY) {
         const deployed = await listAgentNames();
@@ -1594,27 +1699,88 @@ async function main() {
             break;
         }
         case "init": {
-            // deploy init [nome] [template] [--mode=X] [--skills=a,b] — sem argumentos (TTY): pergunta interativo
+            // auton init [nome] [template] [--mode=X] [--skills=a,b] [--deploy] [--dry-run] [--genesis] [--var key=value]
             const initFlags = realArgs.filter((a) => a.startsWith("--"));
             const initPos = realArgs.filter((a) => !a.startsWith("--"));
-            const initOpts = {
-                mode: initFlags.find((f) => f.startsWith("--mode="))?.slice(7),
-                skills: initFlags
-                    .find((f) => f.startsWith("--skills="))
-                    ?.slice(9)
-                    .split(",")
-                    .filter(Boolean),
-            };
+            // Parse flags
+            const deploy = initFlags.includes("--deploy");
+            const dryRun = initFlags.includes("--dry-run");
+            const mode = initFlags.find((f) => f.startsWith("--mode="))?.slice(7);
+            const skills = initFlags
+                .find((f) => f.startsWith("--skills="))
+                ?.slice(9)
+                .split(",")
+                .filter(Boolean);
+            const genesis = initFlags.find((f) => f.startsWith("--genesis="))?.slice(10);
+            // Parse --var key=value
+            const variables = {};
+            for (const f of initFlags) {
+                if (f.startsWith("--var=")) {
+                    const rest = f.slice(6); // remove "--var="
+                    const eqIdx = rest.indexOf("=");
+                    if (eqIdx > 0) {
+                        const key = rest.slice(0, eqIdx);
+                        const val = rest.slice(eqIdx + 1);
+                        variables[key] = val === "true" ? true : val === "false" ? false : val;
+                    }
+                }
+            }
             if (isTTY && !initPos[1] && !initPos[2]) {
                 const p = await promptInit();
-                await cmdInit(p.name, p.template, initOpts);
+                await cmdInit(p.name, p.templateId, {
+                    mode: p.mode ?? mode,
+                    skills: p.skills ?? skills,
+                    genesis: p.genesis ?? genesis,
+                    deploy,
+                    dryRun,
+                    variables,
+                });
             }
             else {
-                const tpl = (initPos[2] ?? "support");
-                if (!TEMPLATES.includes(tpl)) {
-                    throw new ExitError(EXIT.USAGE, `template desconhecido: ${tpl} (disponíveis: ${TEMPLATES.join(", ")})`);
+                const name = initPos[1] ?? ".";
+                const templateId = initPos[2];
+                if (!templateId) {
+                    throw new ExitError(EXIT.USAGE, "uso: auton init <nome> <template-id> [--deploy] [--dry-run] ...");
+                }
+                // Valida template existe
+                const registry = await getTemplateRegistry();
+                const tpl = await registry.get(templateId);
+                if (!tpl) {
+                    const list = await listTemplatesForDisplay();
+                    throw new ExitError(EXIT.USAGE, `template desconhecido: ${templateId}\nDisponíveis: ${list.map(t => `${t.id} (${t.category})`).join(", ")}`);
+                }
+                await cmdInit(name, templateId, {
+                    mode,
+                    skills,
+                    genesis,
+                    deploy,
+                    dryRun,
+                    variables,
+                });
+            }
+            break;
+        }
+        case "template": {
+            const sub = realArgs[1];
+            if (sub === "list" || sub === "ls" || !sub) {
+                const list = await listTemplatesForDisplay();
+                if (realArgs.includes("--json")) {
+                    console.log(JSON.stringify(list, null, 2));
+                }
+                else {
+                    console.log(bold("Templates disponíveis:"));
+                    for (const t of list) {
+                        const srcTag = t.source === "custom" ? pc.cyan("(custom)") : pc.dim("(builtin)");
+                        console.log(`  ${bold(t.id)} ${srcTag} — ${t.name} [${t.category}]`);
+                        console.log(`    ${dim(t.description)}`);
+                    }
                 }
-                await cmdInit(initPos[1] ?? ".", tpl, initOpts);
+            }
+            else if (sub === "create") {
+                console.log(info("Use 'auton init' com template custom — criação de template virá em versão futura"));
+            }
+            else {
+                console.log(USAGE);
             }
             break;
         }
@@ -1622,6 +1788,17 @@ async function main() {
             // deploy kv get|set|ls <nome> [chave] [valor]
             await cmdKv(realArgs[1], realArgs[2], realArgs[3], realArgs[4]);
             break;
+        case "doctor":
+            await cmdDoctor(realArgs.includes("--json"));
+            break;
+        case "completion": {
+            const shell = realArgs[1];
+            if (!shell || !["bash", "zsh", "fish"].includes(shell)) {
+                throw new ExitError(EXIT.USAGE, "uso: auton completion <bash|zsh|fish>");
+            }
+            await cmdCompletion(shell);
+            break;
+        }
         default: {
             console.error(fail(`comando desconhecido: ${realArgs[0]}`));
             console.error(USAGE);
@@ -1630,7 +1807,15 @@ async function main() {
     }
 }
 main().catch((err) => {
-    console.error(fail(`erro: ${err.message}`));
-    process.exit(err.code ?? EXIT.ERR);
+    console.error(fail(formatError(err)));
+    let code = EXIT.ERR;
+    if (err instanceof ExitError)
+        code = err.code;
+    else if (err instanceof AutonError)
+        code = exitCodeFor(err.code);
+    else if (err && typeof err === "object" && "code" in err && typeof err.code === "number") {
+        code = err.code;
+    }
+    process.exit(code);
 });
 //# sourceMappingURL=index.js.map