@neetru/cli 2.7.1 → 2.7.3

package/dist/commands/ui.js

@@ -6,8 +6,16 @@ import { apiRequest } from '../lib/api-client.js';
 import { config } from '../lib/config.js';
 import { resolveToken } from '../lib/cli-read.js';
 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 = '#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
@@ -74,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',
     },
@@ -99,6 +112,223 @@ export function buildMenuChoices(items) {
         short: item.label,
     }));
 }
+function clampMenuWidth(columns) {
+    const terminalWidth = columns && columns > 0 ? columns : 96;
+    return Math.max(MENU_MIN_WIDTH, Math.min(MENU_MAX_WIDTH, terminalWidth - 4));
+}
+function truncateMenuText(text, width) {
+    if (text.length <= width)
+        return text;
+    if (width <= 0)
+        return '';
+    if (width <= 3)
+        return '.'.repeat(width);
+    return `${text.slice(0, width - 3)}...`;
+}
+function padMenuText(text, width) {
+    return truncateMenuText(text, width).padEnd(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);
+        return [empty, empty];
+    }
+    if (selected) {
+        const labelWidth = width - 4;
+        const label = chalk.bgHex('#D7E9FF').hex(MENU_OUTLINE_COLOR).bold(padMenuText(item.label, labelWidth));
+        const detail = chalk.hex(MENU_OUTLINE_COLOR)(padMenuText(item.description ?? '', width - 2));
+        return [
+            `${menuBorder('>')} ${label} ${menuBorder('<')}`,
+            `  ${detail}`,
+        ];
+    }
+    return [
+        `  ${chalk.bold(padMenuText(item.label, width - 2))}`,
+        `  ${chalk.dim(padMenuText(item.description ?? '', width - 2))}`,
+    ];
+}
+export function moveMenuSelection(currentIndex, direction, totalItems, columns = MENU_COLUMNS) {
+    if (totalItems <= 0)
+        return 0;
+    const current = Math.max(0, Math.min(currentIndex, totalItems - 1));
+    const currentRow = Math.floor(current / columns);
+    const currentColumn = current % columns;
+    if (direction === 'left' || direction === 'right') {
+        const nextColumn = currentColumn + (direction === 'left' ? -1 : 1);
+        if (nextColumn < 0 || nextColumn >= columns)
+            return current;
+        const nextIndex = currentRow * columns + nextColumn;
+        return nextIndex < totalItems ? nextIndex : current;
+    }
+    const rowCount = Math.ceil(totalItems / columns);
+    const delta = direction === 'up' ? -1 : 1;
+    for (let step = 1; step <= rowCount; step += 1) {
+        const nextRow = (currentRow + delta * step + rowCount) % rowCount;
+        const nextIndex = nextRow * columns + currentColumn;
+        if (nextIndex < totalItems)
+            return nextIndex;
+    }
+    return current;
+}
+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;
+    const rows = Math.ceil(items.length / MENU_COLUMNS);
+    const lines = [
+        `  ${chalk.dim('Use ↑/↓/←/→. Enter abre. Ativo: > <.')}`,
+        `  ${menuBorder(`┌${'─'.repeat(innerWidth)}┐`)}`,
+    ];
+    for (let row = 0; row < rows; row += 1) {
+        const cells = Array.from({ length: MENU_COLUMNS }, (_, column) => {
+            const index = row * MENU_COLUMNS + column;
+            return renderMenuCell(items[index], index === selectedIndex, columnWidth);
+        });
+        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');
+}
+function decodeMenuKey(data) {
+    const key = data.toString('utf8');
+    if (key === '\r' || key === '\n')
+        return 'enter';
+    if (key === '\u0003' || key === '\x1B' || key.toLowerCase() === 'q')
+        return 'abort';
+    if (key === '\x1B[A' || key === '\x1BOA' || key.toLowerCase() === 'k' || key.toLowerCase() === 'w')
+        return 'up';
+    if (key === '\x1B[B' || key === '\x1BOB' || key.toLowerCase() === 'j' || key.toLowerCase() === 's')
+        return 'down';
+    if (key === '\x1B[D' || key === '\x1BOD' || key.toLowerCase() === 'h' || key.toLowerCase() === 'a')
+        return 'left';
+    if (key === '\x1B[C' || key === '\x1BOC' || key.toLowerCase() === 'l' || key.toLowerCase() === 'd')
+        return 'right';
+    return null;
+}
+function readMenuKey() {
+    return new Promise((resolve) => {
+        process.stdin.once('data', (data) => resolve(decodeMenuKey(data)));
+    });
+}
+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;
+    const wasRaw = process.stdin.isRaw === true;
+    const clearRenderedMenu = () => {
+        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 = 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)
+                selectedIndex = moveMenuSelection(selectedIndex, key, items.length);
+        }
+    }
+    finally {
+        clearRenderedMenu();
+        process.stdout.write('\x1B[?25h');
+        if (typeof process.stdin.setRawMode === 'function')
+            process.stdin.setRawMode(wasRaw);
+        if (!wasRaw)
+            process.stdin.pause();
+    }
+}
 function canPrompt() {
     return Boolean(process.stdin.isTTY) && Boolean(process.stdout.isTTY) && process.env.CI !== 'true';
 }
@@ -107,7 +337,7 @@ async function pause() {
         {
             type: 'input',
             name: 'continue',
-            message: 'Enter para voltar ao menu',
+            message: 'Enter para continuar',
         },
     ]);
 }
@@ -121,13 +351,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);
@@ -210,285 +451,353 @@ async function quickstart() {
     });
 }
 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' },
-            ],
-        },
-    ]);
-    if (answer.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, {});
-    await pause();
+    for (;;) {
+        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' },
+                ],
+            },
+        ]);
+        if (answer.action === 'back')
+            return;
+        await runSubmenuAction(async () => {
+            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, {});
+        });
+    }
 }
 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 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;
+        await runSubmenuAction(async () => {
+            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, {});
+        });
+    }
 }
 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 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;
+        await runSubmenuAction(async () => {
+            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, {});
+        });
+    }
 }
 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 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;
+        await runSubmenuAction(async () => {
+            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, {});
+        });
+    }
 }
 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 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' },
+                ],
+            },
         ]);
-        await support.runSupportTicketsDescribe(id, {});
+        if (answer.action === 'back')
+            return;
+        await runSubmenuAction(async () => {
+            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, {});
+        });
     }
-    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 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' },
+                ],
+            },
         ]);
-        await support.runSupportTicketsReply(id, { message });
+        if (answer.action === 'back')
+            return;
+        await runSubmenuAction(async () => {
+            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 },
+                ]);
+                await support.runSupportTicketsDescribe(id, {});
+            }
+            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:' },
+                ]);
+                await support.runSupportTicketsReply(id, { message });
+            }
+            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 });
+            }
+        });
     }
-    if (answer.action === 'status') {
-        const { id, to } = await inquirer.prompt([
-            { type: 'input', name: 'id', message: 'Ticket ID:', validate: Boolean },
+}
+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 answer = await inquirer.prompt([
             {
                 type: 'list',
-                name: 'to',
-                message: 'Novo status:',
-                choices: ['open', 'in_progress', 'resolved', 'closed'],
+                name: 'action',
+                message: 'Docs live',
+                choices: buildDocsMenuChoices(docsInfo),
             },
         ]);
-        await support.runSupportTicketsStatus(id, { to });
+        if (answer.action === 'back')
+            return;
+        await runSubmenuAction(async () => {
+            const docs = await import('./docs.js');
+            if (answer.action.startsWith('recent:')) {
+                await docs.runDocsGet(answer.action.slice('recent:'.length), { metaOnly: false });
+            }
+            if (answer.action === 'list') {
+                await docs.runDocsList({});
+            }
+            if (answer.action === 'get' || answer.action === 'meta') {
+                const { slug } = await inquirer.prompt([
+                    { type: 'input', name: 'slug', message: 'Slug do doc:', validate: Boolean },
+                ]);
+                await docs.runDocsGet(slug, { metaOnly: answer.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 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;
+        await runSubmenuAction(async () => {
+            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({});
+            }
+        });
     }
-    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 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;
+        await runSubmenuAction(async () => {
+            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();
+            }
+        });
     }
-    await pause();
 }
 export async function runTerminalUi() {
     if (!canPrompt()) {
@@ -504,21 +813,17 @@ export async function runTerminalUi() {
         throw new CommandExitError(typeof code === 'number' ? code : 0);
     });
     try {
-        const email = await resolveSessionEmail();
-        log.banner(email);
+        const [email, version, docsInfo] = await Promise.all([
+            resolveSessionEmail(),
+            checkForUpdate(),
+            loadDocsBannerInfo(),
+        ]);
+        log.banner(email, version, docsInfo);
         let running = true;
         while (running) {
             let answer;
             try {
-                answer = await inquirer.prompt([
-                    {
-                        type: 'list',
-                        name: 'action',
-                        message: 'Neetru',
-                        pageSize: 24,
-                        choices: buildMenuChoices(MAIN_MENU),
-                    },
-                ]);
+                answer = await promptMainMenu(MAIN_MENU, { sessionEmail: email });
             }
             catch {
                 // Ctrl+C / fechamento do prompt = o usuário encerrando por vontade
@@ -526,6 +831,10 @@ export async function runTerminalUi() {
                 running = false;
                 continue;
             }
+            if (!answer) {
+                running = false;
+                continue;
+            }
             if (answer.action === 'exit') {
                 running = false;
                 continue;
@@ -550,6 +859,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')