@ariasbruno/skillbase 0.2.0 → 1.1.0

package/src/cli.js

@@ -14,75 +14,118 @@ import {
   removeSkill,
   updateSkills
 } from './core.js';
+import {
+  bold,
+  dim,
+  dim2,
+  text,
+  grayLogo,
+  cyan,
+  yellow,
+  green,
+  red,
+  S_DIAMOND,
+  S_BULLET,
+  S_CHECK,
+  S_POINTER,
+  S_WARNING,
+  S_BAR,
+  S_BAR_START,
+  S_BAR_END,
+  S_STEP
+} from './styles.js';
+import { createRequire } from 'node:module';
+import { t, setLanguage } from './i18n.js';
+import { getConfig, saveConfig } from './config.js';
+
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+
+function printLogo() {
+  const LOGO_LINES = [
+    ' ███████╗██╗  ██╗██╗██╗     ██╗     ██████╗  █████╗ ███████╗███████╗',
+    ' ██╔════╝██║ ██╔╝██║██║     ██║     ██╔══██╗██╔══██╗██╔════╝██╔════╝',
+    ' ███████╗█████╔╝ ██║██║     ██║     ██████╔╝███████║███████╗█████╗  ',
+    ' ╚════██║██╔═██╗ ██║██║     ██║     ██╔══██╗██╔══██║╚════██║██╔══╝  ',
+    ' ███████║██║  ██╗██║███████╗███████╗██████╔╝██║  ██║███████║███████╗',
+    ' ╚══════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝╚═════╝ ╚═╝  ╚═╝╚══════╝╚══════╝',
+  ];
+
+  console.log();
+  LOGO_LINES.forEach((line, i) => {
+    console.log(grayLogo(line, i));
+  });
+  console.log(`  ${dim2(pkg.description)} ${dim2(`v${pkg.version}`)}`);
+  console.log();
+}
 
+/**
+ * Muestra la ayuda principal de la CLI con el estilo Clack.
+ */
 function printHelp() {
-  console.log(`skillbase - Gestor de skills locales/remotas
-
-Uso:
-  skillbase -h
-  skillbase h
-  skillbase ls [--project]
-  skillbase l [-p]
-  skillbase init [--hard]
-  skillbase add <skill> [--sym]
-  skillbase add
-  skillbase a <skill> [-s]
-  skillbase install
-  skillbase i
-  skillbase install <skill|repo-url> --remote [--skill <name>] [--force]
-  skillbase remove <skill> [--g]
-  skillbase rm <skill> [--g]
-  skillbase check [--remote]
-  skillbase c [-r]
-  skillbase update [<skill>] [--remote] [--force]
-  skillbase up [<skill>] [-r] [-f]
-  skillbase migrate [--project] [--force]
-  skillbase m [--project] [-f]
-
-Descripción breve de comandos:
-  ls        Lista skills instaladas globalmente (~/.skillbase/skills) o del proyecto con --project.
-  init      Sugiere skills globales según tecnologías del proyecto.
-  add       Instala una skill global (o abre selector interactivo sin argumentos).
-  install   Instala desde skillbase.json o una skill remota con --remote.
-  remove    Elimina una skill del proyecto o global con --g.
-  check     Revisa si hay versiones más nuevas disponibles.
-  update    Actualiza skills del manifiesto (todas o una puntual).
-  migrate   Migra skills desde .agents hacia ~/skillbase/skills.
-
-Aliases:
-  l=ls, h=-h, a=add, i=install, rm=remove, c=check, up=update, m=migrate
-
-Short flags:
-  -s=--sym, -r=--remote, -f=--force, -k=--skill, -p=--project
-
-Notas:
-  - Carpeta global por defecto: ~/.skillbase/skills
-  - Puedes cambiarla con SKILLBASE_HOME
-  - Las skills de proyecto viven en .agents/skills
-  - El manifiesto del proyecto es skillbase.json
-`);
+  printLogo();
+  console.log(`${cyan(S_BAR_START)}  ${bold(t('USAGE'))}`);
+  console.log(`${cyan(S_BAR)}  ${green('skillbase')} ${text('<command> [args] [options]')}`);
+  console.log(`${cyan(S_BAR)}`);
+
+  console.log(`${cyan(S_BAR)}  ${bold(t('COMMANDS'))}`);
+  const commands = [
+    ['ls', `[args]`, t('DESC_LS')],
+    ['init', ``, t('DESC_INIT')],
+    ['add', `<skill>`, t('DESC_ADD')],
+    ['install', `[url]`, t('DESC_INSTALL')],
+    ['remove', `<skill>`, t('DESC_REMOVE')],
+    ['check', ``, t('DESC_CHECK')],
+    ['update', `[skill]`, t('DESC_UPDATE')],
+    ['migrate', ``, t('DESC_MIGRATE')],
+    ['lang', `<lang>`, t('DESC_LANG')],
+  ];
+
+  commands.forEach(([cmd, args, desc]) => {
+    const fullCmd = `${bold(cmd.padEnd(8))} ${dim2(args.padEnd(8))}`;
+    console.log(`${cyan(S_BAR)}  ${fullCmd} ${text(desc)}`);
+  });
+
+  console.log(`${cyan(S_BAR)}`);
+  console.log(`${cyan(S_BAR)}  ${bold(t('OPTIONS'))}`);
+  const options = [
+    ['-r, --remote ', t('OPT_REMOTE')],
+    ['-f, --force  ', t('OPT_FORCE')],
+    ['-s, --sym    ', t('OPT_SYM')],
+    ['-g, --global ', t('OPT_GLOBAL')],
+    ['-h, --help   ', t('OPT_HELP')],
+  ];
+
+  options.forEach(([opt, desc]) => {
+    console.log(`${cyan(S_BAR)}  ${dim2(opt.padEnd(14))}  ${dim2(desc)}`);
+  });
+
+  console.log(`${cyan(S_BAR)}`);
+  console.log(`${cyan(S_BAR_END)}  ${dim2(t('SHORTCUTS'))}\n`);
 }
 
+/**
+ * Muestra una lista resumida de comandos cuando no se indica ninguno.
+ */
 function printCommandList() {
-  console.log(`Comandos disponibles:
-- skillbase ls [--project]
-- skillbase l [-p]
-- skillbase init [--hard]
-- skillbase add
-- skillbase add <skill> [--sym]
-- skillbase a <skill> [-s]
-- skillbase install | skillbase i
-- skillbase install <skill|repo-url> --remote [--skill <name>] [--force]
-- skillbase remove <skill> [--g]
-- skillbase rm <skill> [--g]
-- skillbase check [--remote]
-- skillbase c [-r]
-- skillbase update [<skill>] [--remote] [--force]
-- skillbase up [<skill>] [-r] [-f]
-- skillbase migrate [--project] [--force]
-- skillbase m [--project] [-f]
-
-Usa "skillbase -h" para ver detalles.`);
+  printLogo();
+  console.log(`${cyan(S_BAR_START)}  ${bold(t('COMMANDS_AVAILABLE'))}`);
+  
+  const quickList = [
+    ['ls', t('DESC_LS_SHORT')],
+    ['init', t('DESC_INIT_SHORT')],
+    ['add', t('DESC_ADD_SHORT')],
+    ['install', t('DESC_INSTALL_SHORT')],
+    ['migrate', t('DESC_MIGRATE_SHORT')],
+    ['lang', t('DESC_LANG_SHORT')],
+  ];
+
+  quickList.forEach(([cmd, desc]) => {
+    console.log(`${cyan(S_BAR)}  ${bold(cmd.padEnd(12))} ${dim2(desc)}`);
+  });
+
+  console.log(`${cyan(S_BAR)}`);
+  console.log(`${cyan(S_BAR_END)}  ${dim2(t('USE_HELP', { cmd: yellow('skillbase --help') }))}\n`);
 }
 
 function hasFlag(args, ...flags) {
@@ -96,6 +139,9 @@ function getFlagValue(args, ...flags) {
   return null;
 }
 
+/**
+ * Punto de entrada principal de la CLI.
+ */
 export async function runCLI(argv) {
   const args = argv.slice(2);
   const [rawCommand, maybeSkill] = args;
@@ -116,73 +162,89 @@ export async function runCLI(argv) {
     return;
   }
 
-  if (command === '-h' || command === '--help') {
+  if (command === '-h' || command === '--help' || hasFlag(args, '-h', '--help')) {
     printHelp();
     return;
   }
 
   switch (command) {
     case 'ls': {
-      const showProject = hasFlag(args, '--project', '-p');
-      if (showProject) {
-        const skills = await listProjectSkills();
+      const showGlobal = hasFlag(args, '--global', '-g');
+      if (showGlobal) {
+        const skills = await listGlobalSkills();
         if (!skills.length) {
-          console.log(`No hay skills instaladas localmente en ${getProjectSkillsDir()}`);
+          console.log(`${yellow(S_WARNING)} ${t('LS_GLOBAL_EMPTY', { dir: dim2(getGlobalSkillsDir()) })}`);
         } else {
-          console.log(`Skills del proyecto (${getProjectSkillsDir()}):`);
-          skills.forEach((skill) => console.log(`- ${skill}`));
+          console.log(`${cyan(S_BAR_START)}  ${bold(t('LS_GLOBAL_TITLE', { dir: dim2(getGlobalSkillsDir()) }))}`);
+          skills.forEach((skill) => console.log(`${cyan(S_BAR)}  ${green(S_CHECK)} ${text(skill)}`));
+          console.log(`${cyan(S_BAR_END)}\n`);
         }
       } else {
-        const skills = await listGlobalSkills();
+        const skills = await listProjectSkills();
         if (!skills.length) {
-          console.log(`No hay skills globales instaladas en ${getGlobalSkillsDir()}`);
+          console.log(`${yellow(S_WARNING)} ${t('LS_PROJECT_EMPTY', { dir: dim2(getProjectSkillsDir()) })}`);
         } else {
-          console.log(`Skills globales (${getGlobalSkillsDir()}):`);
-          skills.forEach((skill) => console.log(`- ${skill}`));
+          console.log(`${cyan(S_BAR_START)}  ${bold(t('LS_PROJECT_TITLE', { dir: dim2(getProjectSkillsDir()) }))}`);
+          skills.forEach((skill) => console.log(`${cyan(S_BAR)}  ${green(S_CHECK)} ${text(skill)}`));
+          console.log(`${cyan(S_BAR_END)}\n`);
         }
       }
       return;
     }
 
     case 'init': {
+      printLogo();
       const result = await initProject({ hard: hasFlag(args, '--hard') });
-      if (!result.technologies.length) {
-        console.log('No se detectaron tecnologías en el proyecto.');
-        return;
-      }
-      console.log(`Tecnologías detectadas: ${result.technologies.join(', ')}`);
-      if (!result.suggested.length) {
-        console.log('No se encontraron skills compatibles en ~/.skillbase/skills.');
+      
+      if (result.cancelled) {
+        console.log(`${cyan(S_BAR_START)}  ${dim2(t('CANCELLED'))}`);
+        console.log(`${cyan(S_BAR_END)}`);
         return;
       }
-      if (result.cancelled) {
-        console.log('Selección cancelada.');
+
+      if (!result.technologies.length) {
+        console.log(`${yellow(S_WARNING)} ${t('INIT_NO_STACK')}`);
         return;
       }
+
+      console.log(`${cyan(S_BAR_START)}  ${bold(t('INIT_ANALYSIS'))}`);
+      result.technologies.forEach((tech) => {
+        console.log(`${cyan(S_BAR)}  ${green(S_CHECK)} ${text(tech)}`);
+      });
+      console.log(`${cyan(S_BAR)}`);
+
       if (result.installed.length) {
-        console.log(`Skills instaladas: ${result.installed.join(', ')}`);
+        console.log(`${cyan(S_BAR_START)}  ${bold(t('INIT_RESUMEN'))}`);
+        console.log(`${cyan(S_BAR)}  ${green(S_CHECK)} ${t('INIT_INSTALLED', { list: bold(result.installed.join(', ')) })}`);
+        console.log(`${cyan(S_BAR_END)}\n`);
       } else {
-        console.log('No se seleccionaron skills para instalar.');
+        console.log(`${cyan(S_BAR_END)}  ${dim2(t('INIT_NONE'))}\n`);
       }
       return;
     }
 
     case 'add': {
       if (!maybeSkill) {
+        printLogo();
         const result = await addSkillsInteractive({ sym: hasFlag(args, '--sym', '-s') });
         if (result.cancelled) {
-          console.log('Selección cancelada.');
+          console.log(`${cyan(S_BAR_START)}  ${dim2(t('SELECTION_CANCELLED'))}`);
+          console.log(`${cyan(S_BAR_END)}`);
           return;
         }
         if (!result.selected.length) {
-          console.log('No se seleccionaron skills para instalar.');
+          console.log(`${cyan(S_BAR_END)}  ${dim2(t('ADD_NO_SELECTED'))}\n`);
           return;
         }
-        console.log(`Skills instaladas: ${result.selected.join(', ')}`);
+        console.log(`${cyan(S_BAR_START)}  ${bold(t('ADD_RESUMEN'))}`);
+        console.log(`${cyan(S_BAR)}  ${green(S_CHECK)} ${t('INIT_INSTALLED', { list: bold(result.selected.join(', ')) })}`);
+        console.log(`${cyan(S_BAR_END)}\n`);
         return;
       }
       await addSkill(maybeSkill, { sym: hasFlag(args, '--sym', '-s') });
-      console.log(`Skill "${maybeSkill}" instalada en el proyecto.`);
+      console.log(`${cyan(S_BAR_START)}  ${bold(t('ADD_RESUMEN'))}`);
+      console.log(`${cyan(S_BAR)}  ${green(S_CHECK)} ${t('ADD_SUCCESS', { skill: bold(maybeSkill) })}`);
+      console.log(`${cyan(S_BAR_END)}\n`);
       return;
     }
 
@@ -192,77 +254,117 @@ export async function runCLI(argv) {
           force: hasFlag(args, '--force', '-f'),
           skill: getFlagValue(args, '--skill', '-k')
         });
-        console.log(`Skill remota "${maybeSkill}" instalada.`);
+        console.log(`${cyan(S_BAR_START)}  ${bold(t('INIT_RESUMEN'))}`);
+        console.log(`${cyan(S_BAR)}  ${green(S_CHECK)} ${t('ADD_REMOTE_SUCCESS', { skill: bold(maybeSkill) })}`);
+        console.log(`${cyan(S_BAR_END)}\n`);
         return;
       }
       if (maybeSkill && !hasFlag(args, '--remote', '-r')) {
-        throw new Error('Para instalar una skill puntual usa "skillbase add <skill>" (global) o "skillbase install <skill|repo-url> --remote".');
+        throw new Error(t('INSTALL_ERROR_SINGLE'));
       }
       await installFromManifest({ remote: hasFlag(args, '--remote', '-r'), force: hasFlag(args, '--force', '-f') });
       const manifest = await readManifest();
-      console.log(`Instaladas ${manifest.skills.length} skills desde skillbase.json.`);
+      console.log(`${cyan(S_BAR_START)}  ${bold(t('INIT_RESUMEN'))}`);
+      console.log(`${cyan(S_BAR)}  ${green(S_CHECK)} ${t('INSTALL_MANIFEST_SUCCESS', { count: bold(manifest.skills.length) })}`);
+      console.log(`${cyan(S_BAR_END)}\n`);
       return;
     }
 
     case 'remove': {
-      if (!maybeSkill) throw new Error('Debes indicar una skill: skillbase remove <skill>');
-      await removeSkill(maybeSkill, { global: hasFlag(args, '--g') });
-      if (hasFlag(args, '--g')) {
-        console.log(`Skill global "${maybeSkill}" eliminada.`);
+      if (!maybeSkill) throw new Error(t('REMOVE_REQUIRED'));
+      const isGlobal = hasFlag(args, '-g', '--global');
+      await removeSkill(maybeSkill, { global: isGlobal });
+      console.log(`${cyan(S_BAR_START)}  ${bold(t('INIT_RESUMEN'))}`);
+      if (isGlobal) {
+        console.log(`${cyan(S_BAR)}  ${green(S_CHECK)} ${t('REMOVE_GLOBAL_SUCCESS', { skill: bold(maybeSkill) })}`);
       } else {
-        console.log(`Skill "${maybeSkill}" eliminada del proyecto.`);
+        console.log(`${cyan(S_BAR)}  ${green(S_CHECK)} ${t('REMOVE_PROJECT_SUCCESS', { skill: bold(maybeSkill) })}`);
       }
+      console.log(`${cyan(S_BAR_END)}\n`);
       return;
     }
 
     case 'check': {
+      console.log(`${cyan(S_BAR_START)}  ${dim2(t('CHECK_SEARCHING'))}`);
       const updates = await checkUpdates({ remoteOnly: hasFlag(args, '--remote', '-r') });
       if (!updates.length) {
-        console.log('No hay actualizaciones disponibles.');
+        console.log(`${cyan(S_BAR)}  ${green(S_CHECK)} ${t('CHECK_UP_TO_DATE')}`);
+        console.log(`${cyan(S_BAR_END)}\n`);
         return;
       }
-      console.log('Actualizaciones disponibles:');
+      console.log(`${cyan(S_BAR)}  ${bold(t('CHECK_UPDATES_FOUND'))}`);
       updates.forEach((item) => {
-        console.log(`- ${item.name}: ${item.current ?? 'desconocida'} -> ${item.latest} (${item.source})`);
+        console.log(`${cyan(S_BAR)}  ${yellow(S_POINTER)} ${item.name}: ${dim2(item.current ?? '?')} ${dim2(S_STEP)} ${green(item.latest)} ${dim2(`(${item.source})`)}`);
       });
+      console.log(`${cyan(S_BAR)}`);
+      console.log(`${cyan(S_BAR_END)}  ${dim2(t('CHECK_UPDATE_HINT', { cmd: yellow('skillbase update') }))}\n`);
       return;
     }
 
     case 'update': {
       const skill = maybeSkill && !maybeSkill.startsWith('-') ? maybeSkill : null;
+      console.log(`${cyan(S_BAR_START)}  ${dim2(t('UPDATE_START'))}`);
       await updateSkills({
         skillName: skill,
         remoteOnly: hasFlag(args, '--remote', '-remote', '-r'),
         force: hasFlag(args, '--force', '-f')
       });
+      console.log(`${cyan(S_BAR)}  ${bold(t('INIT_RESUMEN'))}`);
       if (skill) {
-        console.log(`Skill "${skill}" actualizada.`);
+        console.log(`${cyan(S_BAR)}  ${green(S_CHECK)} ${t('UPDATE_SINGLE_SUCCESS', { skill: bold(skill) })}`);
       } else {
-        console.log('Skills actualizadas.');
+        console.log(`${cyan(S_BAR)}  ${green(S_CHECK)} ${t('UPDATE_SUCCESS')}`);
       }
+      console.log(`${cyan(S_BAR_END)}\n`);
       return;
     }
 
     case 'migrate': {
-      const fromProject = hasFlag(args, '--project', '-p');
+      const fromProject = hasFlag(args, '--promote', '-p');
       const result = await migrateAgentsSkillsToSkillbase({
         force: hasFlag(args, '--force', '-f'),
         fromProject
       });
-      console.log(`Origen de migración: ${result.sourceRoot}/skills`);
-      console.log(`Skills encontradas: ${result.totalFound}`);
+      console.log(`${cyan(S_BAR_START)}  ${bold(t('MIGRATE_TITLE'))}`);
+      console.log(`${cyan(S_BAR)}  ${dim2(S_POINTER)} ${t('MIGRATE_SOURCE', { dir: dim2(`${result.sourceRoot}/skills`) })}`);
+      console.log(`${cyan(S_BAR)}  ${dim2(S_POINTER)} ${t('MIGRATE_FOUND', { count: bold(result.totalFound) })}`);
+
       if (result.migrated.length) {
-        console.log(`Migradas a ${getGlobalSkillsDir()}:`);
-        result.migrated.forEach((skill) => console.log(`- ${skill}`));
+        console.log(`${cyan(S_BAR)}`);
+        console.log(`${cyan(S_BAR)}  ${green(S_CHECK)} ${t('MIGRATE_SUCCESS_LIST', { dir: dim2(getGlobalSkillsDir()) })}`);
+        result.migrated.forEach((skill) => console.log(`${cyan(S_BAR)}    ${dim2('·')} ${text(skill)}`));
       }
       if (result.skipped.length) {
-        console.log('Omitidas (ya existen globalmente, usa --force para sobrescribir):');
-        result.skipped.forEach((skill) => console.log(`- ${skill}`));
+        console.log(`${cyan(S_BAR)}`);
+        console.log(`${cyan(S_BAR)}  ${yellow(S_POINTER)} ${t('MIGRATE_SKIPPED_LIST')}`);
+        result.skipped.forEach((skill) => console.log(`${cyan(S_BAR)}    ${dim2('·')} ${text(skill)}`));
+      }
+
+      if (result.migrated.length) {
+        console.log(`${cyan(S_BAR)}`);
+        console.log(`${cyan(S_BAR)}  ${bold(t('INIT_RESUMEN'))}`);
+        console.log(`${cyan(S_BAR)}  ${green(S_CHECK)} ${t('MIGRATE_RESUMEN_SUCCESS', { count: bold(result.migrated.length) })}`);
+        console.log(`${cyan(S_BAR)}  ${dim2(S_POINTER)} ${t('MIGRATE_RESUMEN_DEST', { dir: bold(getGlobalSkillsDir()) })}`);
+        console.log(`${cyan(S_BAR_END)}\n`);
+      } else {
+        console.log(`${cyan(S_BAR_END)}  ${dim2(t('MIGRATE_NONE'))}\n`);
+      }
+      return;
+    }
+
+    case 'lang': {
+      if (!maybeSkill || !['en', 'es'].includes(maybeSkill)) {
+        throw new Error(t('LANG_INVALID', { lang: maybeSkill || '??' }));
       }
+      const config = await getConfig();
+      config.lang = maybeSkill;
+      saveConfig(config);
+      console.log(`${cyan(S_BAR_START)}  ${bold(t('LANG_SUCCESS', { lang: maybeSkill === 'es' ? 'Español' : 'English' }))}`);
+      console.log(`${cyan(S_BAR_END)}\n`);
       return;
     }
 
     default:
-      throw new Error(`Comando desconocido: ${command}. Usa skillbase -h`);
+      throw new Error(t('UNKNOWN_COMMAND', { cmd: command }));
   }
 }

package/src/config.js

@@ -1,3 +1,5 @@
+import fs from 'node:fs';
+import fsp from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 
@@ -5,6 +7,16 @@ export const MANIFEST_FILE = 'skillbase.json';
 export const PROJECT_AGENTS_DIR = '.agents';
 export const PROJECT_SKILLS_DIR = 'skills';
 export const DEFAULT_GLOBAL_ROOTNAME = '.skillbase';
+export const CONFIG_FILE = 'config.json';
+
+export async function exists(target) {
+  try {
+    await fsp.access(target);
+    return true;
+  } catch {
+    return false;
+  }
+}
 
 export function getGlobalRootDir() {
   const fromEnv = process.env.SKILLBASE_HOME;
@@ -16,6 +28,31 @@ export function getGlobalSkillsDir() {
   return path.join(getGlobalRootDir(), PROJECT_SKILLS_DIR);
 }
 
+export function getGlobalConfigPath() {
+  return path.join(getGlobalRootDir(), CONFIG_FILE);
+}
+
+export function getConfig() {
+  const configPath = getGlobalConfigPath();
+  try {
+    if (fs.existsSync(configPath)) {
+      return JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    }
+  } catch {
+    // Omitir errores de lectura
+  }
+  return { lang: 'en' };
+}
+
+export function saveConfig(config) {
+  const configPath = getGlobalConfigPath();
+  const rootDir = getGlobalRootDir();
+  if (!fs.existsSync(rootDir)) {
+    fs.mkdirSync(rootDir, { recursive: true });
+  }
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+}
+
 export function getProjectRoot(cwd = process.cwd()) {
   return cwd;
 }