@open-skills-hub/cli 1.0.0

package/dist/index.js

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+/**
+ * Open Skills Hub CLI - Entry Point
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { initConfig } from '@open-skills-hub/core';
+import { searchCommand } from './commands/search.js';
+import { getCommand } from './commands/get.js';
+import { publishCommand } from './commands/publish.js';
+import { validateCommand } from './commands/validate.js';
+import { createCommand } from './commands/create.js';
+import { scanCommand } from './commands/scan.js';
+import { feedbackCommand } from './commands/feedback.js';
+import { cacheCommand } from './commands/cache.js';
+import { configCommand } from './commands/config.js';
+// Package info
+const VERSION = '1.0.0';
+const DESCRIPTION = 'Open Skills Hub CLI - AI 时代的 npm + Docker Hub';
+// Create the CLI program
+const program = new Command();
+program
+    .name('skills')
+    .version(VERSION)
+    .description(DESCRIPTION)
+    .option('-v, --verbose', 'Enable verbose output')
+    .option('-q, --quiet', 'Suppress output')
+    .option('--config <path>', 'Path to configuration file')
+    .hook('preAction', async (thisCommand) => {
+    // Initialize configuration
+    const options = thisCommand.opts();
+    const config = initConfig(options['config']);
+    await config.load();
+    // Set log level based on flags
+    if (options['verbose']) {
+        config.setValue('logLevel', 'debug');
+    }
+    else if (options['quiet']) {
+        config.setValue('logLevel', 'error');
+    }
+});
+// Register commands
+program.addCommand(searchCommand);
+program.addCommand(getCommand);
+program.addCommand(createCommand);
+program.addCommand(validateCommand);
+program.addCommand(publishCommand);
+program.addCommand(scanCommand);
+program.addCommand(feedbackCommand);
+program.addCommand(cacheCommand);
+program.addCommand(configCommand);
+// Help text customization
+program.configureHelp({
+    sortSubcommands: true,
+    subcommandTerm: (cmd) => cmd.name(),
+});
+// Custom help
+program.addHelpText('after', `
+${chalk.bold('Examples:')}
+  ${chalk.gray('# Create a new skill')}
+  $ skills create my-skill
+  
+  ${chalk.gray('# Validate a skill')}
+  $ skills validate ./my-skill
+  
+  ${chalk.gray('# Publish a skill directory')}
+  $ skills publish ./my-skill
+  
+  ${chalk.gray('# Search for skills')}
+  $ skills search "code review"
+  
+  ${chalk.gray('# Get skill content')}
+  $ skills get code-reviewer
+  
+  ${chalk.gray('# Scan content for security issues')}
+  $ skills scan ./my-skill.md
+  
+${chalk.bold('Documentation:')}
+  https://github.com/OpenSkillsHub/open-skills-hub
+`);
+// Error handling
+program.exitOverride();
+// Run the CLI
+async function main() {
+    try {
+        await program.parseAsync(process.argv);
+        // Explicitly exit after successful command execution
+        // This ensures the process doesn't hang waiting for async operations
+        process.exit(0);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            // Commander's exit override throws errors for help/version
+            if (error.message.includes('(commander.helpDisplayed)') ||
+                error.message.includes('(commander.version)')) {
+                process.exit(0);
+            }
+            console.error(chalk.red('\nError:'), error.message);
+            if (process.env['DEBUG']) {
+                console.error(chalk.gray(error.stack));
+            }
+        }
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@open-skills-hub/cli",
+  "version": "1.0.0",
+  "description": "CLI for Open Skills Hub",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "skills": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@open-skills-hub/core": "1.0.0",
+    "commander": "^11.1.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.1",
+    "inquirer": "^9.2.12",
+    "cli-table3": "^0.6.3",
+    "yaml": "^2.3.4",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "tsx": "^4.7.0",
+    "@types/node": "^20.10.6",
+    "@types/inquirer": "^9.0.7"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/OpenSkillsHub/open-skills-hub.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/OpenSkillsHub/open-skills-hub/issues"
+  },
+  "homepage": "https://github.com/OpenSkillsHub/open-skills-hub#readme",
+  "keywords": [
+    "skills",
+    "ai",
+    "agent",
+    "cli",
+    "command-line",
+    "mcp"
+  ],
+  "author": "Open Skills Hub Team",
+  "license": "MIT"
+}

package/src/commands/cache.ts

@@ -0,0 +1,166 @@
+/**
+ * Open Skills Hub CLI - Cache Command
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import Table from 'cli-table3';
+import { getStorage, getConfig, formatBytes } from '@open-skills-hub/core';
+
+export const cacheCommand = new Command('cache')
+  .description('Manage local cache')
+  .addCommand(
+    new Command('list')
+      .description('List cached skills')
+      .option('--json', 'Output as JSON')
+      .action(async (options) => {
+        const spinner = ora('Loading cache info...').start();
+
+        try {
+          const storage = await getStorage();
+          await storage.initialize();
+
+          const cacheEntries = await storage.getAllCacheMetadata();
+          spinner.stop();
+
+          if (options.json) {
+            console.log(JSON.stringify(cacheEntries, null, 2));
+            return;
+          }
+
+          if (cacheEntries.length === 0) {
+            console.log(chalk.yellow('\nNo cached skills found.'));
+            return;
+          }
+
+          console.log(chalk.bold(`\nCached Skills (${cacheEntries.length}):\n`));
+
+          const table = new Table({
+            head: [
+              chalk.cyan('Skill'),
+              chalk.cyan('Version'),
+              chalk.cyan('Size'),
+              chalk.cyan('Hits'),
+              chalk.cyan('Cached At'),
+            ],
+            colWidths: [30, 12, 12, 8, 25],
+          });
+
+          let totalSize = 0;
+          let totalHits = 0;
+
+          for (const entry of cacheEntries) {
+            table.push([
+              entry.skillName,
+              entry.version,
+              formatBytes(entry.size ?? 0),
+              entry.hitCount.toString(),
+              entry.cachedAt.split('T')[0] ?? '',
+            ]);
+            totalSize += entry.size ?? 0;
+            totalHits += entry.hitCount;
+          }
+
+          console.log(table.toString());
+          console.log();
+          console.log(chalk.gray(`Total size: ${formatBytes(totalSize)}`));
+          console.log(chalk.gray(`Total hits: ${totalHits}`));
+
+          await storage.close();
+        } catch (error) {
+          spinner.fail('Failed to list cache');
+          throw error;
+        }
+      })
+  )
+  .addCommand(
+    new Command('clear')
+      .description('Clear cached skills')
+      .option('-n, --name <name>', 'Clear specific skill')
+      .option('-a, --all', 'Clear all cache')
+      .option('-e, --expired', 'Clear only expired entries')
+      .action(async (options) => {
+        const spinner = ora('Clearing cache...').start();
+
+        try {
+          const storage = await getStorage();
+          await storage.initialize();
+
+          let cleared = 0;
+
+          if (options.expired) {
+            const expiredEntries = await storage.getExpiredCacheEntries();
+            for (const entry of expiredEntries) {
+              await storage.deleteCacheMetadata(entry.skillName, entry.version);
+              cleared++;
+            }
+          } else if (options.name) {
+            const deleted = await storage.deleteCacheMetadata(options.name);
+            if (deleted) cleared++;
+          } else if (options.all) {
+            const allEntries = await storage.getAllCacheMetadata();
+            for (const entry of allEntries) {
+              await storage.deleteCacheMetadata(entry.skillName, entry.version);
+              cleared++;
+            }
+          } else {
+            spinner.info('Specify --all, --expired, or --name <skill>');
+            return;
+          }
+
+          spinner.succeed(`Cleared ${cleared} cache entries`);
+          await storage.close();
+        } catch (error) {
+          spinner.fail('Failed to clear cache');
+          throw error;
+        }
+      })
+  )
+  .addCommand(
+    new Command('stats')
+      .description('Show cache statistics')
+      .action(async () => {
+        const spinner = ora('Calculating statistics...').start();
+
+        try {
+          const storage = await getStorage();
+          await storage.initialize();
+          const config = getConfig();
+
+          const cacheEntries = await storage.getAllCacheMetadata();
+          const expiredEntries = await storage.getExpiredCacheEntries();
+
+          spinner.stop();
+
+          const totalSize = cacheEntries.reduce((sum, c) => sum + (c.size ?? 0), 0);
+          const totalHits = cacheEntries.reduce((sum, c) => sum + c.hitCount, 0);
+          const uniqueSkills = new Set(cacheEntries.map(c => c.skillName)).size;
+
+          console.log(chalk.bold('\nCache Statistics:\n'));
+          console.log(`  ${chalk.cyan('Total entries:')}   ${cacheEntries.length}`);
+          console.log(`  ${chalk.cyan('Unique skills:')}   ${uniqueSkills}`);
+          console.log(`  ${chalk.cyan('Total size:')}      ${formatBytes(totalSize)}`);
+          console.log(`  ${chalk.cyan('Max size:')}        ${formatBytes(config.get().cache.maxSize)}`);
+          console.log(`  ${chalk.cyan('Usage:')}           ${Math.round((totalSize / config.get().cache.maxSize) * 100)}%`);
+          console.log(`  ${chalk.cyan('Total hits:')}      ${totalHits}`);
+          console.log(`  ${chalk.cyan('Expired:')}         ${expiredEntries.length}`);
+          console.log(`  ${chalk.cyan('TTL:')}             ${config.get().cache.ttl}s`);
+          console.log();
+
+          // Most accessed
+          if (cacheEntries.length > 0) {
+            const sorted = [...cacheEntries].sort((a, b) => b.hitCount - a.hitCount);
+            console.log(chalk.bold('Most accessed:'));
+            for (const entry of sorted.slice(0, 5)) {
+              console.log(`  • ${entry.skillName}@${entry.version} (${entry.hitCount} hits)`);
+            }
+          }
+
+          await storage.close();
+        } catch (error) {
+          spinner.fail('Failed to get statistics');
+          throw error;
+        }
+      })
+  );

package/src/commands/config.ts

@@ -0,0 +1,142 @@
+/**
+ * Open Skills Hub CLI - Config Command
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import * as fs from 'fs';
+import { getConfig, initConfig } from '@open-skills-hub/core';
+import { stringify as stringifyYaml } from 'yaml';
+
+export const configCommand = new Command('config')
+  .description('Manage configuration')
+  .addCommand(
+    new Command('show')
+      .description('Show current configuration')
+      .option('--json', 'Output as JSON')
+      .action(async (options) => {
+        const config = getConfig();
+        const current = config.get();
+
+        if (options.json) {
+          console.log(JSON.stringify(current, null, 2));
+          return;
+        }
+
+        console.log(chalk.bold('\nCurrent Configuration:\n'));
+        console.log(stringifyYaml(current, { indent: 2 }));
+      })
+  )
+  .addCommand(
+    new Command('get')
+      .description('Get a specific configuration value')
+      .argument('<key>', 'Configuration key (e.g., mode, server.port)')
+      .action(async (key) => {
+        const config = getConfig();
+        const current = config.get();
+
+        // Navigate nested keys
+        const keys = key.split('.');
+        let value: unknown = current;
+        for (const k of keys) {
+          if (value && typeof value === 'object' && k in value) {
+            value = (value as Record<string, unknown>)[k];
+          } else {
+            console.log(chalk.red(`Key not found: ${key}`));
+            process.exit(1);
+          }
+        }
+
+        if (typeof value === 'object') {
+          console.log(JSON.stringify(value, null, 2));
+        } else {
+          console.log(value);
+        }
+      })
+  )
+  .addCommand(
+    new Command('set')
+      .description('Set a configuration value')
+      .argument('<key>', 'Configuration key')
+      .argument('<value>', 'Value to set')
+      .action(async (key, value) => {
+        const spinner = ora('Saving configuration...').start();
+
+        try {
+          const config = getConfig();
+          const current = config.get();
+
+          // Parse value
+          let parsedValue: unknown = value;
+          if (value === 'true') parsedValue = true;
+          else if (value === 'false') parsedValue = false;
+          else if (/^\d+$/.test(value)) parsedValue = parseInt(value, 10);
+          else if (/^\d+\.\d+$/.test(value)) parsedValue = parseFloat(value);
+
+          // Navigate and set nested keys
+          const keys = key.split('.');
+          if (keys.length === 1) {
+            config.setValue(key as keyof typeof current, parsedValue as typeof current[keyof typeof current]);
+          } else {
+            // Handle nested keys
+            let target: Record<string, unknown> = current;
+            for (let i = 0; i < keys.length - 1; i++) {
+              const k = keys[i]!;
+              if (!(k in target)) {
+                target[k] = {};
+              }
+              target = target[k] as Record<string, unknown>;
+            }
+            target[keys[keys.length - 1]!] = parsedValue;
+            config.set(current);
+          }
+
+          await config.save();
+          spinner.succeed(`Set ${key} = ${parsedValue}`);
+        } catch (error) {
+          spinner.fail('Failed to save configuration');
+          throw error;
+        }
+      })
+  )
+  .addCommand(
+    new Command('reset')
+      .description('Reset configuration to defaults')
+      .option('-y, --yes', 'Skip confirmation')
+      .action(async (options) => {
+        if (!options.yes) {
+          console.log(chalk.yellow('This will reset all configuration to defaults.'));
+          console.log('Use --yes to confirm.');
+          return;
+        }
+
+        const spinner = ora('Resetting configuration...').start();
+
+        try {
+          const config = getConfig();
+          config.reset();
+          await config.save();
+          spinner.succeed('Configuration reset to defaults');
+        } catch (error) {
+          spinner.fail('Failed to reset configuration');
+          throw error;
+        }
+      })
+  )
+  .addCommand(
+    new Command('path')
+      .description('Show configuration file paths')
+      .action(async () => {
+        const config = getConfig();
+        
+        console.log(chalk.bold('\nConfiguration Paths:\n'));
+        console.log(`  ${chalk.cyan('Storage:')}    ${config.getStoragePath()}`);
+        console.log(`  ${chalk.cyan('Database:')}   ${config.getDatabasePath()}`);
+        console.log(`  ${chalk.cyan('Cache:')}      ${config.getCachePath()}`);
+        console.log(`  ${chalk.cyan('Local:')}      ${config.getLocalSkillsPath()}`);
+        console.log(`  ${chalk.cyan('Logs:')}       ${config.getLogsPath()}`);
+        console.log(`  ${chalk.cyan('Queue:')}      ${config.getQueuePath()}`);
+        console.log();
+      })
+  );