@neetru/cli 2.7.2 → 2.7.4

package/dist/commands/ui.js

@@ -9,11 +9,13 @@ import { resolveSessionEmail } from '../lib/auth.js';
 import { checkForUpdate } from '../lib/version-check.js';
 import { CLI_VERSION } from '../version.js';
 import { log } from '../utils/logger.js';
-export const MENU_OUTLINE_COLOR = '#001F3F';
+export const MENU_OUTLINE_COLOR = '#334C65';
+export const MENU_FOOTER_TEXT_COLOR = '#CBD5E1';
 const MENU_COLUMNS = 2;
 const MENU_GAP = 2;
 const MENU_MIN_WIDTH = 58;
 const MENU_MAX_WIDTH = 112;
+const DOCS_RECENT_LIMIT = 5;
 /**
  * Erro lançado no lugar de `process.exit()` enquanto o menu interativo está
  * ativo. Os comandos do CLI chamam `process.exit()` em erro (ex.: "Nenhum
@@ -40,9 +42,9 @@ export const MAIN_MENU = [
         description: 'Projeto no diretório atual, login, versão e config',
     },
     {
-        label: 'Criar produto + workspace',
+        label: 'Começar um projeto',
         value: 'quickstart',
-        description: 'Fluxo guiado: novo produto, workspace e scaffold local',
+        description: 'Scaffold local (init), criar produto (new) e sobre o SDK',
     },
     {
         label: 'Produtos',
@@ -80,7 +82,12 @@ export const MAIN_MENU = [
         description: 'Tickets de suporte — listar, responder, mudar status',
     },
     {
-        label: 'Status e diagnóstico',
+        label: 'Docs live',
+        value: 'docs',
+        description: 'Registry publicado no Core - listar e ler markdown',
+    },
+    {
+        label: 'Status e diagnostico',
         value: 'health',
         description: 'Saúde das superfícies, doctor e whoami',
     },
@@ -124,6 +131,39 @@ function padMenuText(text, width) {
 function menuBorder(text) {
     return chalk.hex(MENU_OUTLINE_COLOR)(text);
 }
+function menuFooterText(text) {
+    return chalk.hex(MENU_FOOTER_TEXT_COLOR)(text);
+}
+function renderProgressBar(progress, width = 10) {
+    const safeProgress = Math.max(0, Math.min(100, Math.round(progress)));
+    const filled = Math.round((safeProgress / 100) * width);
+    return `${menuBorder('[')}${chalk.hex('#1E90FF')('#'.repeat(filled))}${chalk.dim('-'.repeat(width - filled))}${menuBorder(']')} ${safeProgress}%`;
+}
+function renderTaskFooter(tasks, width) {
+    if (!tasks || tasks.length === 0) {
+        return menuFooterText(padMenuText('tasks  sem tarefas ativas', width));
+    }
+    const task = tasks[0];
+    const remaining = tasks.length > 1 ? ` +${tasks.length - 1}` : '';
+    return menuFooterText(padMenuText(`task   ${task.label}${remaining} `, Math.max(0, width - 18))) + renderProgressBar(task.progress);
+}
+function renderFooterColumns(left, right, width) {
+    const gap = '  ';
+    const leftWidth = Math.max(20, Math.floor((width - gap.length) * 0.45));
+    const rightWidth = Math.max(10, width - leftWidth - gap.length);
+    return `${menuFooterText(padMenuText(left, leftWidth))}${gap}${menuFooterText(padMenuText(right, rightWidth))}`;
+}
+function renderMenuFooter(footer, width) {
+    const session = footer.sessionEmail
+        ? `logado como ${footer.sessionEmail}`
+        : 'sem login - neetru login';
+    const taskWidth = Math.max(18, Math.floor(width * 0.52));
+    return [
+        `  ${menuBorder('─'.repeat(width))}`,
+        `  ${renderFooterColumns('Neetru CLI', `Developer Kit  neetru.com  v${CLI_VERSION}`, width)}`,
+        `  ${menuFooterText(padMenuText(session, Math.max(20, width - taskWidth - 2)))}  ${renderTaskFooter(footer.tasks, taskWidth)}`,
+    ];
+}
 function renderMenuCell(item, selected, width) {
     if (!item) {
         const empty = ' '.repeat(width);
@@ -166,7 +206,7 @@ export function moveMenuSelection(currentIndex, direction, totalItems, columns =
     }
     return current;
 }
-export function renderMainMenu(items, selectedIndex, terminalColumns = process.stdout.columns) {
+export function renderMainMenu(items, selectedIndex, terminalColumns = process.stdout.columns, footer = {}) {
     const targetWidth = clampMenuWidth(terminalColumns);
     const columnWidth = Math.max(24, Math.floor((targetWidth - 2 - MENU_GAP) / MENU_COLUMNS));
     const innerWidth = columnWidth * MENU_COLUMNS + MENU_GAP;
@@ -182,8 +222,39 @@ export function renderMainMenu(items, selectedIndex, terminalColumns = process.s
         });
         lines.push(`  ${menuBorder('│')}${cells.map((cell) => cell[0]).join(' '.repeat(MENU_GAP))}${menuBorder('│')}`);
         lines.push(`  ${menuBorder('│')}${cells.map((cell) => cell[1]).join(' '.repeat(MENU_GAP))}${menuBorder('│')}`);
+        if (row < rows - 1) {
+            lines.push(`  ${menuBorder('│')}${' '.repeat(innerWidth)}${menuBorder('│')}`);
+        }
     }
     lines.push(`  ${menuBorder(`└${'─'.repeat(innerWidth)}┘`)}`);
+    lines.push(...renderMenuFooter(footer, innerWidth + 2));
+    return lines.join('\n');
+}
+/**
+ * Renderiza um submenu em coluna única, alinhado à esquerda, com a mesma
+ * moldura azul-marinho e o marcador `> <` do menu principal. A largura
+ * acompanha o item mais longo (clampada entre 18 e 48).
+ */
+export function renderSubMenu(title, items, selectedIndex) {
+    const longest = items.reduce((max, item) => Math.max(max, item.label.length), 0);
+    const labelWidth = Math.max(18, Math.min(48, longest));
+    const innerWidth = labelWidth + 6;
+    const lines = [
+        `  ${chalk.bold.hex(MENU_OUTLINE_COLOR)(title)}`,
+        `  ${chalk.dim('↑/↓ navega · Enter abre · Esc volta')}`,
+        `  ${menuBorder(`┌${'─'.repeat(innerWidth)}┐`)}`,
+    ];
+    items.forEach((item, index) => {
+        const padded = padMenuText(item.label, labelWidth);
+        if (index === selectedIndex) {
+            const label = chalk.bgHex('#D7E9FF').hex(MENU_OUTLINE_COLOR).bold(padded);
+            lines.push(`  ${menuBorder('│')} ${menuBorder('>')} ${label} ${menuBorder('<')} ${menuBorder('│')}`);
+        }
+        else {
+            lines.push(`  ${menuBorder('│')}   ${chalk.bold(padded)}   ${menuBorder('│')}`);
+        }
+    });
+    lines.push(`  ${menuBorder(`└${'─'.repeat(innerWidth)}┘`)}`);
     return lines.join('\n');
 }
 function decodeMenuKey(data) {
@@ -207,9 +278,50 @@ function readMenuKey() {
         process.stdin.once('data', (data) => resolve(decodeMenuKey(data)));
     });
 }
-async function promptMainMenu(items) {
+function formatDocDate(value) {
+    if (!value)
+        return undefined;
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return undefined;
+    return date.toISOString().slice(0, 10);
+}
+function docPublishedTime(doc) {
+    const time = Date.parse(doc.publishedAt ?? '');
+    return Number.isNaN(time) ? 0 : time;
+}
+async function loadDocsBannerInfo() {
+    const token = await resolveToken();
+    if (!token)
+        return { message: 'login para consultar registry' };
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), 1500);
+    try {
+        const result = await apiRequest('/api/cli/v1/docs', {
+            token,
+            signal: ctrl.signal,
+        });
+        const recent = [...(result.docs ?? [])]
+            .sort((a, b) => docPublishedTime(b) - docPublishedTime(a))
+            .slice(0, DOCS_RECENT_LIMIT)
+            .map((doc) => ({
+            title: doc.title || doc.slug,
+            slug: doc.slug,
+            updated: formatDocDate(doc.publishedAt),
+        }));
+        return { count: result.count ?? result.docs?.length ?? 0, recent };
+    }
+    catch {
+        return { message: 'registry indisponivel agora' };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function promptMainMenu(items, footer = {}) {
     let selectedIndex = 0;
     let renderedLines = 0;
+    let result = null;
     const wasRaw = process.stdin.isRaw === true;
     const clearRenderedMenu = () => {
         if (renderedLines > 0) {
@@ -223,15 +335,19 @@ async function promptMainMenu(items) {
     process.stdout.write('\x1B[?25l');
     try {
         for (;;) {
-            const frame = renderMainMenu(items, selectedIndex);
+            const frame = renderMainMenu(items, selectedIndex, process.stdout.columns, footer);
             clearRenderedMenu();
             process.stdout.write(`${frame}\n`);
             renderedLines = frame.split('\n').length;
             const key = await readMenuKey();
-            if (key === 'abort')
-                return null;
-            if (key === 'enter')
-                return { action: items[selectedIndex].value };
+            if (key === 'abort') {
+                result = null;
+                break;
+            }
+            if (key === 'enter') {
+                result = { action: items[selectedIndex].value };
+                break;
+            }
             if (key)
                 selectedIndex = moveMenuSelection(selectedIndex, key, items.length);
         }
@@ -239,10 +355,58 @@ async function promptMainMenu(items) {
     finally {
         clearRenderedMenu();
         process.stdout.write('\x1B[?25h');
-        if (typeof process.stdin.setRawMode === 'function')
-            process.stdin.setRawMode(wasRaw);
-        if (!wasRaw)
-            process.stdin.pause();
+        // Só restaura/pausa o stdin ao DEIXAR o menu (Ctrl+C ou "Sair"). Quando
+        // uma ação/submenu roda a seguir, o stdin fica "quente" (raw + resumed)
+        // pro inquirer do submenu assumir o stream sem comer a 1ª seta — o
+        // pause()/toggle de raw mode aqui é o que engolia a primeira tecla.
+        const leavingMenu = result === null || result.action === 'exit';
+        if (leavingMenu) {
+            if (typeof process.stdin.setRawMode === 'function') {
+                process.stdin.setRawMode(wasRaw);
+            }
+            if (!wasRaw)
+                process.stdin.pause();
+        }
+    }
+    return result;
+}
+/**
+ * Submenu interativo em coluna única — espelha o `promptMainMenu`, mas com
+ * uma lista vertical estreita. Retorna o `value` do item escolhido; Esc ou
+ * Ctrl+C retornam `'back'`. Deixa o stdin "quente" na saída (a ação a seguir,
+ * ou o menu principal, assumem o stream sem comer a 1ª tecla).
+ */
+async function promptSubMenu(title, items) {
+    let selectedIndex = 0;
+    let renderedLines = 0;
+    const clearRendered = () => {
+        if (renderedLines > 0) {
+            process.stdout.write(`\x1B[${renderedLines}A\x1B[J`);
+            renderedLines = 0;
+        }
+    };
+    process.stdin.resume();
+    if (typeof process.stdin.setRawMode === 'function')
+        process.stdin.setRawMode(true);
+    process.stdout.write('\x1B[?25l');
+    try {
+        for (;;) {
+            const frame = renderSubMenu(title, items, selectedIndex);
+            clearRendered();
+            process.stdout.write(`${frame}\n`);
+            renderedLines = frame.split('\n').length;
+            const key = await readMenuKey();
+            if (key === 'abort')
+                return 'back';
+            if (key === 'enter')
+                return items[selectedIndex].value;
+            if (key)
+                selectedIndex = moveMenuSelection(selectedIndex, key, items.length, 1);
+        }
+    }
+    finally {
+        clearRendered();
+        process.stdout.write('\x1B[?25h');
     }
 }
 function canPrompt() {
@@ -253,7 +417,7 @@ async function pause() {
         {
             type: 'input',
             name: 'continue',
-            message: 'Enter para voltar ao menu',
+            message: 'Enter para continuar',
         },
     ]);
 }
@@ -267,13 +431,24 @@ async function safeRun(fn, opts = {}) {
         // `CommandExitError` = um comando chamou `process.exit()` e já imprimiu a
         // própria mensagem. Qualquer outro erro: mostramos a mensagem. Nos dois
         // casos pausamos (a função não chegou ao seu próprio `pause()`) e voltamos
-        // ao menu — o CLI NUNCA encerra por causa de um comando.
+        // ao fluxo interativo — o CLI NUNCA encerra por causa de um comando.
         if (!(error instanceof CommandExitError)) {
             log.error(error instanceof Error ? error.message : String(error));
         }
         await pause();
     }
 }
+async function runSubmenuAction(fn) {
+    try {
+        await fn();
+    }
+    catch (error) {
+        if (!(error instanceof CommandExitError)) {
+            log.error(error instanceof Error ? error.message : String(error));
+        }
+    }
+    await pause();
+}
 async function readLocalProject(cwd) {
     for (const file of ['neetru.config.json', '.neetru.json']) {
         const full = path.join(cwd, file);
@@ -355,286 +530,340 @@ async function quickstart() {
         skipOpen: answers.skipOpen,
     });
 }
-async function productsMenu() {
-    const answer = await inquirer.prompt([
-        {
-            type: 'list',
-            name: 'action',
-            message: 'Produtos',
-            choices: [
-                { name: 'Listar produtos', value: 'list' },
-                { name: 'Criar produto', value: 'create' },
-                { name: 'Publicar no catalogo', value: 'publish' },
-                { name: 'Remover do catalogo', value: 'unpublish' },
-                { name: 'Voltar', value: 'back' },
-            ],
-        },
+/** Tela de info sobre o SDK Neetru (@neetru/sdk). */
+function showSdkInfo() {
+    log.heading('SDK Neetru — @neetru/sdk');
+    console.log(`  ${chalk.dim('O que é')}      biblioteca que o SEU produto importa pra falar com o Core`);
+    console.log(`  ${chalk.dim('Instala')}      ${chalk.cyan('npm install @neetru/sdk')} (dependência do projeto)`);
+    console.log(`  ${chalk.dim('No scaffold')}  o ${chalk.cyan('neetru init')} já adiciona o @neetru/sdk + exemplos`);
+    console.log();
+    console.log(`  ${chalk.dim('Uso no código:')}`);
+    console.log(chalk.cyan("    import { createNeetruClient } from '@neetru/sdk';"));
+    console.log(chalk.cyan("    const neetru = createNeetruClient({ apiKey, env: 'prod' });"));
+    console.log(chalk.cyan('    await neetru.auth.signIn();'));
+    console.log();
+    console.log(`  ${chalk.dim('React:')}       ${chalk.cyan('@neetru/sdk/react')} — <EntitlementGate>, <CheckoutLink>`);
+}
+/**
+ * Sub-menu "Começar um projeto": scaffold local (`neetru init`), a macro
+ * de criação completa (`neetru new`) e a info do SDK.
+ */
+async function projectMenu() {
+    const action = await promptSubMenu('Começar um projeto', [
+        { label: 'Scaffold local — neetru init', value: 'init' },
+        { label: 'Criar produto + workspace — neetru new', value: 'new' },
+        { label: 'Sobre o SDK Neetru', value: 'sdk' },
+        { label: 'Voltar', value: 'back' },
     ]);
-    if (answer.action === 'back')
+    if (action === 'back')
         return;
-    const products = await import('./products.js');
-    if (answer.action === 'list')
-        await products.runProductsList({});
-    if (answer.action === 'create')
-        await products.runProductsCreate({});
-    if (answer.action === 'publish')
-        await products.runProductsPublish(undefined, {});
-    if (answer.action === 'unpublish')
-        await products.runProductsUnpublish(undefined, {});
+    if (action === 'init') {
+        const { name } = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'name',
+                message: 'Nome do projeto:',
+                validate: (v) => v.trim().length > 0 || 'Obrigatório.',
+            },
+        ]);
+        const { runInit } = await import('./init.js');
+        await runInit({ name, type: 'nextjs' });
+    }
+    if (action === 'new')
+        await quickstart();
+    if (action === 'sdk')
+        showSdkInfo();
     await pause();
 }
+async function productsMenu() {
+    for (;;) {
+        const action = await promptSubMenu('Produtos', [
+            { label: 'Listar produtos', value: 'list' },
+            { label: 'Criar produto', value: 'create' },
+            { label: 'Publicar no catálogo', value: 'publish' },
+            { label: 'Remover do catálogo', value: 'unpublish' },
+            { label: 'Voltar', value: 'back' },
+        ]);
+        if (action === 'back')
+            return;
+        await runSubmenuAction(async () => {
+            const products = await import('./products.js');
+            if (action === 'list')
+                await products.runProductsList({});
+            if (action === 'create')
+                await products.runProductsCreate({});
+            if (action === 'publish')
+                await products.runProductsPublish(undefined, {});
+            if (action === 'unpublish')
+                await products.runProductsUnpublish(undefined, {});
+        });
+    }
+}
 async function workspacesMenu() {
-    const answer = await inquirer.prompt([
-        {
-            type: 'list',
-            name: 'action',
-            message: 'Workspaces',
-            choices: [
-                { name: 'Listar workspaces', value: 'list' },
-                { name: 'Criar workspace', value: 'create' },
-                { name: 'Ver detalhes', value: 'get' },
-                { name: 'Abrir no painel', value: 'open' },
-                { name: 'Promover bundle', value: 'advance' },
-                { name: 'Voltar', value: 'back' },
-            ],
-        },
-    ]);
-    if (answer.action === 'back')
-        return;
-    const workspaces = await import('./workspaces.js');
-    if (answer.action === 'list')
-        await workspaces.runWorkspacesList({});
-    if (answer.action === 'create')
-        await workspaces.runWorkspacesCreate({});
-    if (answer.action === 'get')
-        await workspaces.runWorkspacesGet(undefined, {});
-    if (answer.action === 'open')
-        await workspaces.runWorkspacesOpen(undefined);
-    if (answer.action === 'advance')
-        await workspaces.runWorkspacesAdvance(undefined, {});
-    await pause();
+    for (;;) {
+        const action = await promptSubMenu('Workspaces', [
+            { label: 'Listar workspaces', value: 'list' },
+            { label: 'Criar workspace', value: 'create' },
+            { label: 'Ver detalhes', value: 'get' },
+            { label: 'Abrir no painel', value: 'open' },
+            { label: 'Promover bundle', value: 'advance' },
+            { label: 'Voltar', value: 'back' },
+        ]);
+        if (action === 'back')
+            return;
+        await runSubmenuAction(async () => {
+            const workspaces = await import('./workspaces.js');
+            if (action === 'list')
+                await workspaces.runWorkspacesList({});
+            if (action === 'create')
+                await workspaces.runWorkspacesCreate({});
+            if (action === 'get')
+                await workspaces.runWorkspacesGet(undefined, {});
+            if (action === 'open')
+                await workspaces.runWorkspacesOpen(undefined);
+            if (action === 'advance')
+                await workspaces.runWorkspacesAdvance(undefined, {});
+        });
+    }
 }
 async function serversMenu() {
-    const answer = await inquirer.prompt([
-        {
-            type: 'list',
-            name: 'action',
-            message: 'Servers',
-            choices: [
-                { name: 'Listar servers', value: 'list' },
-                { name: 'Provisionar VM', value: 'provision' },
-                { name: 'Despachar comando', value: 'dispatch' },
-                { name: 'Desativar server', value: 'deactivate' },
-                { name: 'Voltar', value: 'back' },
-            ],
-        },
-    ]);
-    if (answer.action === 'back')
-        return;
-    const servers = await import('./servers.js');
-    if (answer.action === 'list')
-        await servers.runServersList({ capacity: true });
-    if (answer.action === 'provision')
-        await servers.runServersProvision({});
-    if (answer.action === 'dispatch')
-        await servers.runServersDispatch(undefined, undefined, {});
-    if (answer.action === 'deactivate')
-        await servers.runServersDeactivate(undefined, {});
-    await pause();
+    for (;;) {
+        const action = await promptSubMenu('Servers', [
+            { label: 'Listar servers', value: 'list' },
+            { label: 'Provisionar VM', value: 'provision' },
+            { label: 'Despachar comando', value: 'dispatch' },
+            { label: 'Desativar server', value: 'deactivate' },
+            { label: 'Voltar', value: 'back' },
+        ]);
+        if (action === 'back')
+            return;
+        await runSubmenuAction(async () => {
+            const servers = await import('./servers.js');
+            if (action === 'list')
+                await servers.runServersList({ capacity: true });
+            if (action === 'provision')
+                await servers.runServersProvision({});
+            if (action === 'dispatch')
+                await servers.runServersDispatch(undefined, undefined, {});
+            if (action === 'deactivate')
+                await servers.runServersDeactivate(undefined, {});
+        });
+    }
 }
 async function databasesMenu() {
-    const answer = await inquirer.prompt([
-        {
-            type: 'list',
-            name: 'action',
-            message: 'Bancos de produto',
-            choices: [
-                { name: 'Listar bancos', value: 'list' },
-                { name: 'Criar banco', value: 'create' },
-                { name: 'Detalhar banco', value: 'get' },
-                { name: 'Listar engines', value: 'engines' },
-                { name: 'Retry provisionamento', value: 'retry' },
-                { name: 'Rotacionar credenciais', value: 'rotate' },
-                { name: 'Arquivar banco', value: 'delete' },
-                { name: 'Voltar', value: 'back' },
-            ],
-        },
-    ]);
-    if (answer.action === 'back')
-        return;
-    const db = await import('./products-db.js');
-    if (answer.action === 'list')
-        await db.runDbList({});
-    if (answer.action === 'create')
-        await db.runDbCreate({ region: 'us-central1' });
-    if (answer.action === 'get')
-        await db.runDbGet(undefined, {});
-    if (answer.action === 'engines')
-        await db.runDbEngines({});
-    if (answer.action === 'retry')
-        await db.runDbRetry(undefined, {});
-    if (answer.action === 'rotate')
-        await db.runDbRotate(undefined, {});
-    if (answer.action === 'delete')
-        await db.runDbDelete(undefined, {});
-    await pause();
+    for (;;) {
+        const action = await promptSubMenu('Bancos de produto', [
+            { label: 'Listar bancos', value: 'list' },
+            { label: 'Criar banco', value: 'create' },
+            { label: 'Detalhar banco', value: 'get' },
+            { label: 'Listar engines', value: 'engines' },
+            { label: 'Retry provisionamento', value: 'retry' },
+            { label: 'Rotacionar credenciais', value: 'rotate' },
+            { label: 'Arquivar banco', value: 'delete' },
+            { label: 'Voltar', value: 'back' },
+        ]);
+        if (action === 'back')
+            return;
+        await runSubmenuAction(async () => {
+            const db = await import('./products-db.js');
+            if (action === 'list')
+                await db.runDbList({});
+            if (action === 'create')
+                await db.runDbCreate({ region: 'us-central1' });
+            if (action === 'get')
+                await db.runDbGet(undefined, {});
+            if (action === 'engines')
+                await db.runDbEngines({});
+            if (action === 'retry')
+                await db.runDbRetry(undefined, {});
+            if (action === 'rotate')
+                await db.runDbRotate(undefined, {});
+            if (action === 'delete')
+                await db.runDbDelete(undefined, {});
+        });
+    }
 }
 async function tenantsMenu() {
-    const answer = await inquirer.prompt([
-        {
-            type: 'list',
-            name: 'action',
-            message: 'Tenants',
-            choices: [
-                { name: 'Listar tenants', value: 'list' },
-                { name: 'Detalhar tenant', value: 'get' },
-                { name: 'Criar tenant', value: 'create' },
-                { name: 'Atualizar tenant', value: 'update' },
-                { name: 'Suspender tenant', value: 'suspend' },
-                { name: 'Reativar tenant', value: 'reactivate' },
-                { name: 'Voltar', value: 'back' },
-            ],
-        },
-    ]);
-    if (answer.action === 'back')
-        return;
-    const tenants = await import('./tenants.js');
-    if (answer.action === 'list')
-        await tenants.runTenantsList({});
-    if (answer.action === 'get')
-        await tenants.runTenantsGet(undefined, {});
-    if (answer.action === 'create')
-        await tenants.runTenantsCreate({});
-    if (answer.action === 'update')
-        await tenants.runTenantsUpdate(undefined, {});
-    if (answer.action === 'suspend')
-        await tenants.runTenantsSuspend(undefined, {});
-    if (answer.action === 'reactivate')
-        await tenants.runTenantsReactivate(undefined, {});
-    await pause();
-}
-async function supportMenu() {
-    const answer = await inquirer.prompt([
-        {
-            type: 'list',
-            name: 'action',
-            message: 'Suporte',
-            choices: [
-                { name: 'Listar tickets', value: 'list' },
-                { name: 'Detalhar ticket', value: 'describe' },
-                { name: 'Responder ticket', value: 'reply' },
-                { name: 'Mudar status', value: 'status' },
-                { name: 'Voltar', value: 'back' },
-            ],
-        },
-    ]);
-    if (answer.action === 'back')
-        return;
-    const support = await import('./support.js');
-    if (answer.action === 'list')
-        await support.runSupportTicketsList({});
-    if (answer.action === 'describe') {
-        const { id } = await inquirer.prompt([
-            { type: 'input', name: 'id', message: 'Ticket ID:', validate: Boolean },
+    for (;;) {
+        const action = await promptSubMenu('Tenants', [
+            { label: 'Listar tenants', value: 'list' },
+            { label: 'Detalhar tenant', value: 'get' },
+            { label: 'Criar tenant', value: 'create' },
+            { label: 'Atualizar tenant', value: 'update' },
+            { label: 'Suspender tenant', value: 'suspend' },
+            { label: 'Reativar tenant', value: 'reactivate' },
+            { label: 'Voltar', value: 'back' },
         ]);
-        await support.runSupportTicketsDescribe(id, {});
+        if (action === 'back')
+            return;
+        await runSubmenuAction(async () => {
+            const tenants = await import('./tenants.js');
+            if (action === 'list')
+                await tenants.runTenantsList({});
+            if (action === 'get')
+                await tenants.runTenantsGet(undefined, {});
+            if (action === 'create')
+                await tenants.runTenantsCreate({});
+            if (action === 'update')
+                await tenants.runTenantsUpdate(undefined, {});
+            if (action === 'suspend')
+                await tenants.runTenantsSuspend(undefined, {});
+            if (action === 'reactivate')
+                await tenants.runTenantsReactivate(undefined, {});
+        });
     }
-    if (answer.action === 'reply') {
-        const { id, message } = await inquirer.prompt([
-            { type: 'input', name: 'id', message: 'Ticket ID:', validate: Boolean },
-            { type: 'editor', name: 'message', message: 'Mensagem:' },
+}
+async function supportMenu() {
+    for (;;) {
+        const action = await promptSubMenu('Suporte', [
+            { label: 'Listar tickets', value: 'list' },
+            { label: 'Detalhar ticket', value: 'describe' },
+            { label: 'Responder ticket', value: 'reply' },
+            { label: 'Mudar status', value: 'status' },
+            { label: 'Voltar', value: 'back' },
         ]);
-        await support.runSupportTicketsReply(id, { message });
+        if (action === 'back')
+            return;
+        await runSubmenuAction(async () => {
+            const support = await import('./support.js');
+            if (action === 'list')
+                await support.runSupportTicketsList({});
+            if (action === 'describe') {
+                const { id } = await inquirer.prompt([
+                    { type: 'input', name: 'id', message: 'Ticket ID:', validate: Boolean },
+                ]);
+                await support.runSupportTicketsDescribe(id, {});
+            }
+            if (action === 'reply') {
+                const { id, message } = await inquirer.prompt([
+                    { type: 'input', name: 'id', message: 'Ticket ID:', validate: Boolean },
+                    { type: 'editor', name: 'message', message: 'Mensagem:' },
+                ]);
+                await support.runSupportTicketsReply(id, { message });
+            }
+            if (action === 'status') {
+                const { id, to } = await inquirer.prompt([
+                    { type: 'input', name: 'id', message: 'Ticket ID:', validate: Boolean },
+                    {
+                        type: 'list',
+                        name: 'to',
+                        message: 'Novo status:',
+                        choices: ['open', 'in_progress', 'resolved', 'closed'],
+                    },
+                ]);
+                await support.runSupportTicketsStatus(id, { to });
+            }
+        });
     }
-    if (answer.action === 'status') {
-        const { id, to } = await inquirer.prompt([
-            { type: 'input', name: 'id', message: 'Ticket ID:', validate: Boolean },
-            {
-                type: 'list',
-                name: 'to',
-                message: 'Novo status:',
-                choices: ['open', 'in_progress', 'resolved', 'closed'],
-            },
-        ]);
-        await support.runSupportTicketsStatus(id, { to });
+}
+export function buildDocsMenuChoices(docsInfo) {
+    const recent = docsInfo?.recent?.slice(0, DOCS_RECENT_LIMIT) ?? [];
+    const recentChoices = recent.map((doc) => ({
+        name: `Abrir ${chalk.bold(doc.title)}${doc.updated ? chalk.dim(`  ${doc.updated}`) : ''}`,
+        value: `recent:${doc.slug}`,
+        short: doc.title,
+    }));
+    return [
+        ...recentChoices,
+        { name: 'Listar todos os docs publicados', value: 'list', short: 'Listar docs' },
+        { name: 'Buscar por slug', value: 'get', short: 'Buscar por slug' },
+        { name: 'Ler metadata por slug', value: 'meta', short: 'Ler metadata' },
+        { name: 'Voltar', value: 'back', short: 'Voltar' },
+    ];
+}
+async function docsMenu(docsInfo) {
+    for (;;) {
+        const items = buildDocsMenuChoices(docsInfo).map((choice) => ({
+            label: choice.short,
+            value: choice.value,
+        }));
+        const action = (await promptSubMenu('Docs live', items));
+        if (action === 'back')
+            return;
+        await runSubmenuAction(async () => {
+            const docs = await import('./docs.js');
+            if (action.startsWith('recent:')) {
+                await docs.runDocsGet(action.slice('recent:'.length), { metaOnly: false });
+            }
+            if (action === 'list') {
+                await docs.runDocsList({});
+            }
+            if (action === 'get' || action === 'meta') {
+                const { slug } = await inquirer.prompt([
+                    { type: 'input', name: 'slug', message: 'Slug do doc:', validate: Boolean },
+                ]);
+                await docs.runDocsGet(slug, { metaOnly: action === 'meta' });
+            }
+        });
     }
-    await pause();
 }
 async function healthMenu() {
-    const answer = await inquirer.prompt([
-        {
-            type: 'list',
-            name: 'action',
-            message: 'Status e diagnostico',
-            choices: [
-                { name: 'Status das superficies', value: 'status' },
-                { name: 'Doctor', value: 'doctor' },
-                { name: 'Whoami', value: 'whoami' },
-                { name: 'Voltar', value: 'back' },
-            ],
-        },
-    ]);
-    if (answer.action === 'back')
-        return;
-    if (answer.action === 'status') {
-        const { runSurfaceStatus } = await import('./surface-status.js');
-        await runSurfaceStatus({});
-    }
-    if (answer.action === 'doctor') {
-        const doctor = await import('./doctor.js');
-        const checks = [
-            await doctor.checkToken(),
-            await doctor.checkCoreHealth(),
-            await doctor.checkConfigSchema(process.cwd()),
-            await doctor.checkNeetruEnv(process.cwd()),
-            await doctor.checkCliVersion(),
-        ];
-        log.heading('Doctor');
-        for (const check of checks) {
-            const marker = check.ok ? chalk.green('*') : check.warning ? chalk.yellow('!') : chalk.red('x');
-            console.log(`  ${marker} ${check.name}${check.detail ? chalk.dim(` - ${check.detail}`) : ''}`);
-        }
-    }
-    if (answer.action === 'whoami') {
-        const { runWhoami } = await import('./whoami.js');
-        await runWhoami({});
+    for (;;) {
+        const action = await promptSubMenu('Status e diagnóstico', [
+            { label: 'Status das superfícies', value: 'status' },
+            { label: 'Doctor', value: 'doctor' },
+            { label: 'Whoami', value: 'whoami' },
+            { label: 'Voltar', value: 'back' },
+        ]);
+        if (action === 'back')
+            return;
+        await runSubmenuAction(async () => {
+            if (action === 'status') {
+                const { runSurfaceStatus } = await import('./surface-status.js');
+                await runSurfaceStatus({});
+            }
+            if (action === 'doctor') {
+                const doctor = await import('./doctor.js');
+                const checks = [
+                    await doctor.checkToken(),
+                    await doctor.checkCoreHealth(),
+                    await doctor.checkConfigSchema(process.cwd()),
+                    await doctor.checkNeetruEnv(process.cwd()),
+                    await doctor.checkCliVersion(),
+                ];
+                log.heading('Doctor');
+                for (const check of checks) {
+                    const marker = check.ok ? chalk.green('*') : check.warning ? chalk.yellow('!') : chalk.red('x');
+                    console.log(`  ${marker} ${check.name}${check.detail ? chalk.dim(` - ${check.detail}`) : ''}`);
+                }
+            }
+            if (action === 'whoami') {
+                const { runWhoami } = await import('./whoami.js');
+                await runWhoami({});
+            }
+        });
     }
-    await pause();
 }
 async function authMenu() {
-    const answer = await inquirer.prompt([
-        {
-            type: 'list',
-            name: 'action',
-            message: 'Login e configuracao',
-            choices: [
-                { name: 'Login', value: 'login' },
-                { name: 'Logout', value: 'logout' },
-                { name: 'Ver config', value: 'config' },
-                { name: 'Caminho da config', value: 'path' },
-                { name: 'Voltar', value: 'back' },
-            ],
-        },
-    ]);
-    if (answer.action === 'back')
-        return;
-    if (answer.action === 'login') {
-        const { runLogin } = await import('./login.js');
-        await runLogin({});
-    }
-    if (answer.action === 'logout') {
-        const { runLogout } = await import('./logout.js');
-        await runLogout();
-    }
-    if (answer.action === 'config') {
-        const { configGet } = await import('./config.js');
-        configGet();
-    }
-    if (answer.action === 'path') {
-        const { configPath } = await import('./config.js');
-        configPath();
+    for (;;) {
+        const action = await promptSubMenu('Login e configuração', [
+            { label: 'Login', value: 'login' },
+            { label: 'Logout', value: 'logout' },
+            { label: 'Ver config', value: 'config' },
+            { label: 'Caminho da config', value: 'path' },
+            { label: 'Voltar', value: 'back' },
+        ]);
+        if (action === 'back')
+            return;
+        await runSubmenuAction(async () => {
+            if (action === 'login') {
+                const { runLogin } = await import('./login.js');
+                await runLogin({});
+            }
+            if (action === 'logout') {
+                const { runLogout } = await import('./logout.js');
+                await runLogout();
+            }
+            if (action === 'config') {
+                const { configGet } = await import('./config.js');
+                configGet();
+            }
+            if (action === 'path') {
+                const { configPath } = await import('./config.js');
+                configPath();
+            }
+        });
     }
-    await pause();
 }
 export async function runTerminalUi() {
     if (!canPrompt()) {
@@ -650,16 +879,17 @@ export async function runTerminalUi() {
         throw new CommandExitError(typeof code === 'number' ? code : 0);
     });
     try {
-        const [email, version] = await Promise.all([
+        const [email, version, docsInfo] = await Promise.all([
             resolveSessionEmail(),
             checkForUpdate(),
+            loadDocsBannerInfo(),
         ]);
-        log.banner(email, version);
+        log.banner(email, version, docsInfo);
         let running = true;
         while (running) {
             let answer;
             try {
-                answer = await promptMainMenu(MAIN_MENU);
+                answer = await promptMainMenu(MAIN_MENU, { sessionEmail: email });
             }
             catch {
                 // Ctrl+C / fechamento do prompt = o usuário encerrando por vontade
@@ -678,7 +908,7 @@ export async function runTerminalUi() {
             if (answer.action === 'overview')
                 await safeRun(showOverview);
             if (answer.action === 'quickstart')
-                await safeRun(quickstart, { pauseAfter: false });
+                await safeRun(projectMenu, { pauseAfter: false });
             if (answer.action === 'products')
                 await safeRun(productsMenu, { pauseAfter: false });
             if (answer.action === 'workspaces')
@@ -695,6 +925,8 @@ export async function runTerminalUi() {
                 await safeRun(tenantsMenu, { pauseAfter: false });
             if (answer.action === 'support')
                 await safeRun(supportMenu, { pauseAfter: false });
+            if (answer.action === 'docs')
+                await safeRun(() => docsMenu(docsInfo), { pauseAfter: false });
             if (answer.action === 'health')
                 await safeRun(healthMenu, { pauseAfter: false });
             if (answer.action === 'auth')