@fprad0/skill-master-mcp 0.0.12 → 1.0.1

package/bin/skill-master-menu.mjs

@@ -1,405 +1,516 @@
-#!/usr/bin/env node
-
-import prompts from 'prompts';
-import readline from 'node:readline';
-import { dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import {
-  buildMenuCommands,
-  formatActionHeader,
-  formatCyberConfirmFrame,
-  formatCyberMenuFrame,
-  formatHelp,
-  formatRunningActionFrame,
-  formatResultMessage,
-  formatSkillMasterIntroFrame,
-  formatStatusReport,
-  getMenuStatus,
-  isInteractiveTerminal,
-  resolveActionKey,
-  runCommand,
-} from './lib/menu-core.mjs';
-
-const currentFile = fileURLToPath(import.meta.url);
-const rootDir = dirname(dirname(currentFile));
-const invocationCwd = process.cwd();
-const commands = buildMenuCommands({ rootDir, currentFile, invocationCwd });
-readline.emitKeypressEvents(process.stdin);
-const CONTROL = {
-  alternateScreenIn: '\x1b[?1049h',
-  alternateScreenOut: '\x1b[?1049l',
-  hideCursor: '\x1b[?25l',
-  showCursor: '\x1b[?25h',
-  cursorHome: '\x1b[H',
-  clearScreen: '\x1b[2J',
-  clearToEnd: '\x1b[0J',
-  reset: '\x1b[0m',
-  syncStart: '\x1b[?2026h',
-  syncEnd: '\x1b[?2026l',
-};
-
-function parseArgs(argv) {
-  const parsed = {
-    help: false,
-    status: false,
-    yes: false,
-    run: null,
-  };
-
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    switch (arg) {
-      case '--help':
-      case '-h':
-        parsed.help = true;
-        break;
-      case '--status':
-        parsed.status = true;
-        break;
+#!/usr/bin/env node
+
+import prompts from 'prompts';
+import readline from 'node:readline';
+import { dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import {
+  buildMenuCommands,
+  formatActionHeader,
+  formatCyberConfirmFrame,
+  formatCyberMenuFrame,
+  formatHelp,
+  formatRunningActionFrame,
+  formatResultMessage,
+  formatSkillMasterIntroFrame,
+  formatSkillMasterDnaHeroFrame,
+  formatStatusReport,
+  getMenuStatus,
+  isInteractiveTerminal,
+  resolveActionKey,
+  resolveInitialSelectedIndex,
+  runCommand,
+} from './lib/menu-core.mjs';
+
+const currentFile = fileURLToPath(import.meta.url);
+const rootDir = dirname(dirname(currentFile));
+const invocationCwd = process.cwd();
+const commands = buildMenuCommands({ rootDir, currentFile, invocationCwd });
+readline.emitKeypressEvents(process.stdin);
+const CONTROL = {
+  alternateScreenIn: '\x1b[?1049h',
+  alternateScreenOut: '\x1b[?1049l',
+  hideCursor: '\x1b[?25l',
+  showCursor: '\x1b[?25h',
+  cursorHome: '\x1b[H',
+  clearScreen: '\x1b[2J',
+  clearToEnd: '\x1b[0J',
+  reset: '\x1b[0m',
+  syncStart: '\x1b[?2026h',
+  syncEnd: '\x1b[?2026l',
+};
+
+function parseArgs(argv) {
+  const parsed = {
+    help: false,
+    manifest: null,
+    overwrite: false,
+    prompt: null,
+    status: false,
+    yes: false,
+    run: null,
+    prompt: null,
+    manifest: null,
+    list: false,
+    overwrite: false,
+  };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    switch (arg) {
+      case '--help':
+      case '-h':
+        parsed.help = true;
+        break;
+      case '--status':
+        parsed.status = true;
+        break;
       case '--yes':
         parsed.yes = true;
         break;
-      case '--run':
-        parsed.run = argv[++i] ?? null;
+      case '--prompt':
+        parsed.prompt = argv[++i] ?? null;
         break;
-      default:
-        throw new Error(`Unknown argument: ${arg}`);
+      case '--manifest':
+        parsed.manifest = argv[++i] ?? null;
+        break;
+      case '--list':
+        parsed.list = true;
+        break;
+      case '--overwrite':
+        parsed.overwrite = true;
+        break;
+      case '--run':
+        parsed.run = argv[++i] ?? null;
+        break;
+      default:
+        throw new Error(`Unknown argument: ${arg}`);
+    }
+  }
+
+  return parsed;
+}
+
+function printHelp() {
+  console.log(formatHelp(commands));
+}
+
+function printStatus() {
+  console.log(formatStatusReport(getMenuStatus(rootDir)));
+}
+
+function prepareActionForRun(action, args) {
+  if (action.key === 'promptRecommendation') {
+    if (args.prompt) {
+      return {
+        ...action,
+        description: 'Avalia o prompt informado pelo router local.',
+        args: [action.args[0], '--route-prompt', args.prompt],
+      };
+    }
+
+    if (!isInteractiveTerminal()) {
+      throw new Error('prompt-router precisa de --prompt fora do TTY. Exemplo: skill-master-menu --run prompt-router --prompt "validar menu nota 10"');
+    }
+  }
+
+  if (action.key === 'activateLearnedLocal' || action.key === 'activateLearnedGlobal') {
+    const target = action.key === 'activateLearnedLocal' ? 'local' : 'global';
+    if (args.list) {
+      return {
+        ...action,
+        label: 'Listar drafts de skills aprendidas',
+        description: 'Lista manifests disponiveis para aprovacao ou ativacao humana.',
+        details: ['Nao instala skill.', 'Use um Manifest listado com --manifest <manifest.json> --yes para ativar.'],
+        success: 'Drafts pendentes listados com caminhos de manifest quando existirem.',
+        confirmMessage: null,
+        args: [action.args[0], '--list'],
+      };
+    }
+
+    if (args.manifest) {
+      return {
+        ...action,
+        description: `Ativa a skill aprendida informada em ${target}.`,
+        args: [
+          action.args[0],
+          '--activate',
+          args.manifest,
+          '--target',
+          target,
+          ...(args.yes ? ['--yes'] : []),
+          ...(args.overwrite ? ['--overwrite'] : []),
+        ],
+      };
     }
-  }
-
-  return parsed;
-}
 
-function printHelp() {
-  console.log(formatHelp(commands));
-}
-
-function printStatus() {
-  console.log(formatStatusReport(getMenuStatus(rootDir)));
-}
-
-async function runSelectedAction(action, { yes = false, useColor = false } = {}) {
-  if (action.disabledReason) {
-    throw new Error(`Action ${action.key} is unavailable here: ${action.disabledReason}`);
-  }
-
-  if (action.confirmMessage && !yes) {
     if (!isInteractiveTerminal()) {
-      throw new Error(`Action ${action.key} requires --yes outside an interactive terminal.`);
-    }
-
-    const confirmation = await prompts({
-      type: 'confirm',
-      name: 'confirmed',
-      message: action.confirmMessage,
-      initial: false,
-    });
-
-    if (!confirmation.confirmed) {
-      return { cancelled: true, code: 0 };
-    }
-  }
-
-  console.log('');
-  console.log(formatActionHeader(action, { useColor }));
-  console.log('');
-  const code = await runCommand(action, { cwd: action.cwd ?? rootDir });
-  console.log('');
-  console.log(formatResultMessage(code, { useColor }));
-  return { cancelled: false, code };
-}
-
-const readKey = () => new Promise((resolve) => {
-  process.stdin.once('keypress', (_str, key) => resolve(key));
-});
-
-function createKeyReader() {
-  const queue = [];
-  const waiters = [];
-  const onKeypress = (_str, key) => {
-    const waiter = waiters.shift();
-    if (waiter) {
-      clearTimeout(waiter.timer);
-      waiter.resolve(key);
-      return;
-    }
-    queue.push(key);
-  };
-
-  process.stdin.on('keypress', onKeypress);
-
-  return {
-    read(timeoutMs) {
-      if (queue.length) return Promise.resolve(queue.shift());
-      return new Promise((resolve) => {
-        const waiter = {
-          resolve,
-          timer: setTimeout(() => {
-            const index = waiters.indexOf(waiter);
-            if (index >= 0) waiters.splice(index, 1);
-            resolve(null);
-          }, timeoutMs),
+      if (args.yes) {
+        return {
+          ...action,
+          description: `Ativa automaticamente o unico draft pronto em ${target}, quando existir.`,
+          args: [
+            action.args[0],
+            '--activate-ready',
+            '--target',
+            target,
+            '--yes',
+            ...(args.overwrite ? ['--overwrite'] : []),
+          ],
         };
-        waiters.push(waiter);
-      });
-    },
-    close() {
-      for (const waiter of waiters.splice(0)) {
-        clearTimeout(waiter.timer);
-        waiter.resolve(null);
       }
-      process.stdin.off('keypress', onKeypress);
-    },
-  };
-}
-
-function setRawInput(enabled) {
-  if (typeof process.stdin.setRawMode === 'function') {
-    process.stdin.setRawMode(enabled);
-  }
-  if (enabled) process.stdin.resume();
-}
 
-function restoreMenuInput() {
-  setRawInput(true);
-  process.stdin.resume();
-}
-
-function enterVisualScreen() {
-  process.stdout.write(`${CONTROL.alternateScreenIn}${CONTROL.hideCursor}${CONTROL.clearScreen}${CONTROL.cursorHome}`);
-}
-
-function leaveVisualScreen() {
-  process.stdout.write(`${CONTROL.reset}${CONTROL.showCursor}${CONTROL.alternateScreenOut}`);
-}
-
-function writeStableFrame(frame, { clear = false } = {}) {
-  const prefix = clear ? CONTROL.clearScreen : '';
-  process.stdout.write([
-    CONTROL.syncStart,
-    CONTROL.cursorHome,
-    prefix,
-    frame,
-    '\n',
-    CONTROL.clearToEnd,
-    CONTROL.syncEnd,
-  ].join(''));
-}
-
-function visualHudAllowed() {
-  return isInteractiveTerminal()
-    && process.env.SKILL_MASTER_NO_VISUAL !== '1'
-    && process.env.CI !== 'true'
-    && process.env.TERM !== 'dumb';
-}
-
-function renderCyberMenu(selectedIndex, tick, { clear = false } = {}) {
-  const status = getMenuStatus(rootDir);
-  const frame = formatCyberMenuFrame(status, commands, selectedIndex, tick, {
-    columns: process.stdout.columns ?? 120,
-    rows: process.stdout.rows ?? 32,
-    useColor: true,
-  });
-  writeStableFrame(frame, { clear });
-}
-
-function renderRunningAction(action, tick) {
-  const status = getMenuStatus(rootDir);
-  const frame = formatRunningActionFrame(status, action, tick, {
-    columns: process.stdout.columns ?? 120,
-    rows: process.stdout.rows ?? 32,
-    useColor: true,
-  });
-  writeStableFrame(frame, { clear: true });
-}
-
-function renderIntro(tick, message) {
-  const status = getMenuStatus(rootDir);
-  const frame = formatSkillMasterIntroFrame(status, tick, {
-    columns: process.stdout.columns ?? 120,
-    rows: process.stdout.rows ?? 32,
-    useColor: true,
-    message,
-  });
-  writeStableFrame(frame, { clear: tick === 0 });
-}
-
-function renderConfirmAction(action, tick) {
-  const status = getMenuStatus(rootDir);
-  const frame = formatCyberConfirmFrame(status, action, tick, {
-    columns: process.stdout.columns ?? 120,
-    rows: process.stdout.rows ?? 32,
-    useColor: true,
-  });
-  writeStableFrame(frame, { clear: tick === 0 });
-}
-
-const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-
-async function animateIntro(message = 'skill_master assumindo o workflow', frames = 6) {
-  for (let frame = 0; frame < frames; frame += 1) {
-    renderIntro(frame, message);
-    await sleep(70);
-  }
-}
-
-async function animateRunningAction(action, startTick) {
-  for (let frame = 0; frame < 5; frame += 1) {
-    renderRunningAction(action, startTick + frame);
-    await sleep(90);
-  }
-}
-
-async function confirmVisualAction(action, startTick) {
-  let tick = startTick;
-  const reader = createKeyReader();
-
-  try {
-    while (true) {
-      renderConfirmAction(action, tick);
-      const key = await reader.read(180);
-      if (!key) {
-        tick += 1;
-        continue;
-      }
-
-      if (key.ctrl && key.name === 'c') return { confirmed: false, code: 130 };
-      if (key.name === 'return' || key.name === 'enter' || key.name === 'y') return { confirmed: true, code: 0 };
-      if (key.name === 'escape' || key.name === 'q' || key.name === 'n') return { confirmed: false, code: 0 };
+      throw new Error(`A acao ${action.aliases[0]} precisa de selecao explicita fora do TTY. Use: skill-master-menu --run ${action.aliases[0]} --manifest <manifest.json> --yes, ou skill-master-menu --run ${action.aliases[0]} --yes quando exatamente um draft estiver pronto. Para listar manifests: skill-master-menu --run ${action.aliases[0]} --list`);
     }
-  } finally {
-    reader.close();
   }
-}
-
-async function waitForAnyKey(message = 'Pressione qualquer tecla para voltar ao menu...') {
-  process.stdout.write(`\n${message}`);
-  setRawInput(true);
-  await readKey();
-  setRawInput(false);
-}
-
-async function runVisualMenu() {
-  let selectedIndex = 0;
-  let tick = 0;
-  let lastCode = 0;
-  let keyReader = createKeyReader();
-  let previousColumns = process.stdout.columns ?? 120;
-  let previousRows = process.stdout.rows ?? 32;
-  let needsClear = true;
-
-  enterVisualScreen();
-  restoreMenuInput();
 
-  try {
-    await animateIntro('skill_master online / carregando menu operacional', 7);
-
-    while (true) {
-      const columns = process.stdout.columns ?? 120;
-      const rows = process.stdout.rows ?? 32;
-      const resized = columns !== previousColumns || rows !== previousRows;
-      previousColumns = columns;
-      previousRows = rows;
-      renderCyberMenu(selectedIndex, tick, { clear: needsClear || resized });
-      needsClear = false;
-      const key = await keyReader.read(160);
-
-      if (!key) {
-        tick += 1;
-        continue;
-      }
-
-      if (key.ctrl && key.name === 'c') return 130;
-      if (key.name === 'escape' || key.name === 'q') return lastCode;
-      if (key.name === 'up' || key.name === 'k') {
-        selectedIndex = selectedIndex === 0 ? commands.length - 1 : selectedIndex - 1;
-        continue;
-      }
-      if (key.name === 'down' || key.name === 'j') {
-        selectedIndex = selectedIndex === commands.length - 1 ? 0 : selectedIndex + 1;
-        continue;
-      }
-      if (key.name === 'return' || key.name === 'enter') {
-        const action = commands[selectedIndex];
-        keyReader.close();
-        if (action.confirmMessage) {
-          const confirmation = await confirmVisualAction(action, tick);
-          if (confirmation.code === 130) return 130;
-          if (!confirmation.confirmed) {
-            keyReader = createKeyReader();
-            needsClear = true;
-            continue;
-          }
-        }
-        await animateRunningAction(action, tick);
-        setRawInput(false);
-        leaveVisualScreen();
-        try {
-          const result = await runSelectedAction(action, { yes: Boolean(action.confirmMessage), useColor: true });
-          lastCode = result.code;
-        } catch (error) {
-          const message = error instanceof Error ? error.message : String(error);
-          process.stderr.write(`[skill_master] ${message}\n`);
-          lastCode = 1;
-        }
-        await waitForAnyKey();
-        keyReader = createKeyReader();
-        restoreMenuInput();
-        enterVisualScreen();
-        needsClear = true;
-      }
-    }
-  } finally {
-    keyReader.close();
-    setRawInput(false);
-    process.stdin.pause();
-    leaveVisualScreen();
-  }
+  return action;
 }
 
-async function main() {
-  const args = parseArgs(process.argv.slice(2));
-
-  if (args.help) {
-    printHelp();
-    return 0;
-  }
-
-  if (args.status) {
-    printStatus();
-    return 0;
-  }
-
-  if (args.run) {
-    const actionKey = resolveActionKey(args.run, commands);
-    if (!actionKey) {
-      throw new Error(`Unknown action: ${args.run}`);
-    }
+async function runSelectedAction(action, { yes = false, useColor = false, cliArgs = {} } = {}) {
+  action = prepareActionForRun(action, { ...cliArgs, yes });
+
+  if (action.disabledReason) {
+    throw new Error(`Action ${action.key} is unavailable here: ${action.disabledReason}`);
+  }
+
+  if (action.confirmMessage && !yes) {
+    if (!isInteractiveTerminal()) {
+      throw new Error(`Action ${action.key} requires --yes outside an interactive terminal.`);
+    }
+
+    const confirmation = await prompts({
+      type: 'confirm',
+      name: 'confirmed',
+      message: action.confirmMessage,
+      initial: false,
+    });
+
+    if (!confirmation.confirmed) {
+      return { cancelled: true, code: 0 };
+    }
+  }
+
+  console.log('');
+  console.log(formatActionHeader(action, { useColor }));
+  console.log('');
+  const code = await runCommand(action, { cwd: action.cwd ?? rootDir });
+  console.log('');
+  console.log(formatResultMessage(code, { useColor }));
+  return { cancelled: false, code };
+}
+
+const readKey = () => new Promise((resolve) => {
+  process.stdin.once('keypress', (_str, key) => resolve(key));
+});
+
+function createKeyReader() {
+  const queue = [];
+  const waiters = [];
+  const onKeypress = (_str, key) => {
+    const waiter = waiters.shift();
+    if (waiter) {
+      clearTimeout(waiter.timer);
+      waiter.resolve(key);
+      return;
+    }
+    queue.push(key);
+  };
+
+  process.stdin.on('keypress', onKeypress);
+
+  return {
+    read(timeoutMs) {
+      if (queue.length) return Promise.resolve(queue.shift());
+      return new Promise((resolve) => {
+        const waiter = {
+          resolve,
+          timer: setTimeout(() => {
+            const index = waiters.indexOf(waiter);
+            if (index >= 0) waiters.splice(index, 1);
+            resolve(null);
+          }, timeoutMs),
+        };
+        waiters.push(waiter);
+      });
+    },
+    close() {
+      for (const waiter of waiters.splice(0)) {
+        clearTimeout(waiter.timer);
+        waiter.resolve(null);
+      }
+      process.stdin.off('keypress', onKeypress);
+    },
+  };
+}
+
+function setRawInput(enabled) {
+  if (typeof process.stdin.setRawMode === 'function') {
+    process.stdin.setRawMode(enabled);
+  }
+  if (enabled) process.stdin.resume();
+}
+
+function restoreMenuInput() {
+  setRawInput(true);
+  process.stdin.resume();
+}
+
+function enterVisualScreen() {
+  process.stdout.write(`${CONTROL.alternateScreenIn}${CONTROL.hideCursor}${CONTROL.clearScreen}${CONTROL.cursorHome}`);
+}
+
+function leaveVisualScreen() {
+  process.stdout.write(`${CONTROL.reset}${CONTROL.showCursor}${CONTROL.alternateScreenOut}`);
+}
+
+function writeStableFrame(frame, { clear = false } = {}) {
+  const prefix = clear ? CONTROL.clearScreen : '';
+  process.stdout.write([
+    CONTROL.syncStart,
+    CONTROL.cursorHome,
+    prefix,
+    frame,
+    '\n',
+    CONTROL.clearToEnd,
+    CONTROL.syncEnd,
+  ].join(''));
+}
+
+function visualHudAllowed() {
+  return isInteractiveTerminal()
+    && process.env.SKILL_MASTER_NO_VISUAL !== '1'
+    && process.env.CI !== 'true'
+    && process.env.TERM !== 'dumb';
+}
+
+function renderCyberMenu(selectedIndex, tick, { clear = false } = {}) {
+  const status = getMenuStatus(rootDir);
+  const frame = formatCyberMenuFrame(status, commands, selectedIndex, tick, {
+    columns: process.stdout.columns ?? 120,
+    rows: process.stdout.rows ?? 32,
+    useColor: true,
+  });
+  writeStableFrame(frame, { clear });
+}
+
+function renderRunningAction(action, tick) {
+  const status = getMenuStatus(rootDir);
+  const frame = formatRunningActionFrame(status, action, tick, {
+    columns: process.stdout.columns ?? 120,
+    rows: process.stdout.rows ?? 32,
+    useColor: true,
+  });
+  writeStableFrame(frame, { clear: true });
+}
+
+function renderIntro(tick, message) {
+  const status = getMenuStatus(rootDir);
+  const frame = formatSkillMasterIntroFrame(status, tick, {
+    columns: process.stdout.columns ?? 120,
+    rows: process.stdout.rows ?? 32,
+    useColor: true,
+    message,
+  });
+  writeStableFrame(frame, { clear: tick === 0 });
+}
+
+function renderDnaHero(tick) {
+  const status = getMenuStatus(rootDir);
+  const frame = formatSkillMasterDnaHeroFrame(status, tick, {
+    columns: process.stdout.columns ?? 120,
+    rows: process.stdout.rows ?? 32,
+    useColor: true,
+  });
+  writeStableFrame(frame, { clear: tick === 0 });
+}
+
+function renderConfirmAction(action, tick) {
+  const status = getMenuStatus(rootDir);
+  const frame = formatCyberConfirmFrame(status, action, tick, {
+    columns: process.stdout.columns ?? 120,
+    rows: process.stdout.rows ?? 32,
+    useColor: true,
+  });
+  writeStableFrame(frame, { clear: tick === 0 });
+}
+
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+async function animateIntro(message = 'skill_master assumindo o workflow', frames = 6) {
+  for (let frame = 0; frame < frames; frame += 1) {
+    renderIntro(frame, message);
+    await sleep(70);
+  }
+}
+
+async function animateDnaHeroIntro(frames = 5) {
+  if (!visualHudAllowed()) return;
+  for (let frame = 0; frame < frames; frame += 1) {
+    renderDnaHero(frame);
+    await sleep(220);
+  }
+}
+
+async function animateRunningAction(action, startTick) {
+  for (let frame = 0; frame < 5; frame += 1) {
+    renderRunningAction(action, startTick + frame);
+    await sleep(90);
+  }
+}
+
+async function confirmVisualAction(action, startTick) {
+  let tick = startTick;
+  const reader = createKeyReader();
+
+  try {
+    while (true) {
+      renderConfirmAction(action, tick);
+      const key = await reader.read(180);
+      if (!key) {
+        tick += 1;
+        continue;
+      }
+
+      if (key.ctrl && key.name === 'c') return { confirmed: false, code: 130 };
+      if (key.name === 'return' || key.name === 'enter' || key.name === 'y') return { confirmed: true, code: 0 };
+      if (key.name === 'escape' || key.name === 'q' || key.name === 'n') return { confirmed: false, code: 0 };
+    }
+  } finally {
+    reader.close();
+  }
+}
+
+async function waitForAnyKey(message = 'Pressione qualquer tecla para voltar ao menu...') {
+  process.stdout.write(`\n${message}`);
+  setRawInput(true);
+  await readKey();
+  setRawInput(false);
+}
+
+async function runVisualMenu() {
+  let selectedIndex = resolveInitialSelectedIndex(getMenuStatus(rootDir), commands);
+  let tick = 0;
+  let lastCode = 0;
+  let keyReader = createKeyReader();
+  let previousColumns = process.stdout.columns ?? 120;
+  let previousRows = process.stdout.rows ?? 32;
+  let needsClear = true;
+
+  enterVisualScreen();
+  restoreMenuInput();
+
+  try {
+    await animateDnaHeroIntro(5);
+    await animateIntro('skill_master online / carregando menu operacional', 7);
+
+    while (true) {
+      const columns = process.stdout.columns ?? 120;
+      const rows = process.stdout.rows ?? 32;
+      const resized = columns !== previousColumns || rows !== previousRows;
+      previousColumns = columns;
+      previousRows = rows;
+      renderCyberMenu(selectedIndex, tick, { clear: needsClear || resized });
+      needsClear = false;
+      const key = await keyReader.read(160);
+
+      if (!key) {
+        tick += 1;
+        continue;
+      }
+
+      if (key.ctrl && key.name === 'c') return 130;
+      if (key.name === 'escape' || key.name === 'q') return lastCode;
+      if (key.name === 'up' || key.name === 'k') {
+        selectedIndex = selectedIndex === 0 ? commands.length - 1 : selectedIndex - 1;
+        continue;
+      }
+      if (key.name === 'down' || key.name === 'j') {
+        selectedIndex = selectedIndex === commands.length - 1 ? 0 : selectedIndex + 1;
+        continue;
+      }
+      if (key.name === 'return' || key.name === 'enter') {
+        const action = commands[selectedIndex];
+        keyReader.close();
+        if (action.confirmMessage) {
+          const confirmation = await confirmVisualAction(action, tick);
+          if (confirmation.code === 130) return 130;
+          if (!confirmation.confirmed) {
+            keyReader = createKeyReader();
+            needsClear = true;
+            continue;
+          }
+        }
+        await animateRunningAction(action, tick);
+        setRawInput(false);
+        leaveVisualScreen();
+        try {
+          const result = await runSelectedAction(action, { yes: Boolean(action.confirmMessage), useColor: true });
+          lastCode = result.code;
+        } catch (error) {
+          const message = error instanceof Error ? error.message : String(error);
+          process.stderr.write(`[skill_master] ${message}\n`);
+          lastCode = 1;
+        }
+        await waitForAnyKey();
+        keyReader = createKeyReader();
+        restoreMenuInput();
+        enterVisualScreen();
+        needsClear = true;
+      }
+    }
+  } finally {
+    keyReader.close();
+    setRawInput(false);
+    process.stdin.pause();
+    leaveVisualScreen();
+  }
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+
+  if (args.help) {
+    printHelp();
+    return 0;
+  }
+
+  if (args.status) {
+    printStatus();
+    return 0;
+  }
+
+  if (args.run) {
+    const actionKey = resolveActionKey(args.run, commands);
+    if (!actionKey) {
+      throw new Error(`Unknown action: ${args.run}`);
+    }
 
     const action = commands.find((entry) => entry.key === actionKey);
     if (visualHudAllowed()) {
       enterVisualScreen();
       try {
+        await animateDnaHeroIntro(4);
         await animateIntro(`skill_master executando ${action.label}`, 6);
       } finally {
         leaveVisualScreen();
       }
     }
-    const result = await runSelectedAction(action, { yes: args.yes, useColor: isInteractiveTerminal() });
+    const result = await runSelectedAction(action, { yes: args.yes, useColor: isInteractiveTerminal(), cliArgs: args });
     return result.code;
   }
-
-  if (!isInteractiveTerminal()) {
-    throw new Error('Interactive menu requires a TTY. Use --run <acao> or --status in automated environments.');
-  }
-
-  return runVisualMenu();
-}
-
-try {
-  process.exitCode = await main();
-} catch (error) {
-  const message = error instanceof Error ? error.message : String(error);
-  process.stderr.write(`[skill_master] ${message}\n`);
-  process.exitCode = 1;
-}
+
+  if (!isInteractiveTerminal()) {
+    throw new Error('Interactive menu requires a TTY. Use --run <acao> or --status in automated environments.');
+  }
+
+  return runVisualMenu();
+}
+
+try {
+  process.exitCode = await main();
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  process.stderr.write(`[skill_master] ${message}\n`);
+  process.exitCode = 1;
+}