skills-refiner 1.0.3

package/bin/skills-refiner.js

@@ -0,0 +1,367 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import fs from 'fs/promises';
+import path from 'path';
+import osLocale from 'os-locale';
+import nodeMachineId from 'node-machine-id';
+const { machineId } = nodeMachineId;
+import Conf from 'conf';
+import chalk from 'chalk';
+import ora from 'ora';
+import open from 'open';
+import Table from 'cli-table3';
+import { languages } from '../languages.js';
+import axios from 'axios';
+import { select, password } from '@inquirer/prompts';
+import AdmZip from 'adm-zip';
+import http from 'http';
+
+const program = new Command();
+const config = new Conf({ projectName: 'skills-refiner' });
+
+const API_BASE = process.env.API_URL || 'https://skills-refiner.com/api/v1';
+
+async function getLanguage() {
+  return config.get('default_lang') || await detectOSLocale();
+}
+
+async function detectOSLocale() {
+  try {
+    const locale = await osLocale();
+    return locale.split('-')[0] || 'en';
+  } catch {
+    return 'en';
+  }
+}
+
+async function getDeviceId() {
+  let id = config.get('device_id');
+  if (!id) {
+    try {
+      id = await machineId();
+    } catch {
+      const crypto = await import('crypto');
+      id = crypto.randomUUID();
+    }
+    config.set('device_id', id);
+  }
+  return id;
+}
+
+async function handleServerAction(data) {
+  if (!data.action) return false;
+
+  const action = data.action;
+  const message = data.message || data.error || 'Action required';
+
+  switch (action.type) {
+    case 'OPEN_LOGIN':
+      console.log(chalk.yellow(`\n✖ ${message}`));
+      if (action.url) {
+        await handleAuthFlow(action.url);
+      }
+      return true;
+    case 'RECHARGE':
+      console.log(chalk.yellow(`\n✖ ${message}`));
+      if (action.url) {
+        console.log(chalk.cyan(`Opening recharge page: ${action.url}`));
+        await open(action.url);
+      }
+      process.exit(1);
+    case 'REQUIRE_UPDATE':
+      console.log(chalk.red(`\n✖ ${message}`));
+      console.log(chalk.yellow(`Please update your CLI tool.`));
+      if (action.url) {
+        console.log(chalk.dim(`More info: ${action.url}`));
+      }
+      console.log(chalk.white(`Run: npm install -g skills-refiner@latest`));
+      process.exit(1);
+    case 'CHECK_UPDATE':
+      console.log(chalk.cyan(`\nℹ Update available: ${message}`));
+      console.log(chalk.yellow(`Run: ${action.update_command || 'npm install -g skills-refiner@latest'}`));
+      process.exit(1);
+    default:
+      return false;
+  }
+}
+
+async function handleAuthFlow(loginUrl) {
+  // Start temporary local server to receive API Key
+  return new Promise((resolve) => {
+    const server = http.createServer((req, res) => {
+      // Handle CORS for browser
+      res.setHeader('Access-Control-Allow-Origin', '*');
+      res.setHeader('Access-Control-Allow-Methods', 'POST, OPTIONS');
+      res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+
+      if (req.method === 'OPTIONS') {
+        res.writeHead(204);
+        res.end();
+        return;
+      }
+
+      if (req.method === 'POST' && req.url === '/callback') {
+        let body = '';
+        req.on('data', chunk => { body += chunk; });
+        req.on('end', () => {
+          try {
+            const data = JSON.parse(body);
+            if (data.apiKey) {
+              config.set('api_key', data.apiKey);
+              console.log(chalk.green(`\n✔ API Key saved successfully!`));
+              console.log(chalk.cyan(`Please re-run your command to continue with your new points.`));
+              res.writeHead(200, { 'Content-Type': 'application/json' });
+              res.end(JSON.stringify({ success: true }));
+
+              setTimeout(() => {
+                server.close();
+                process.exit(0);
+              }, 1000);
+            }
+          } catch (e) {
+            res.writeHead(400);
+            res.end();
+          }
+        });
+      } else {
+        res.writeHead(404);
+        res.end();
+      }
+    });
+
+    const port = 3105; // Fixed port for easier browser callback or find free one
+    server.listen(port, async () => {
+      const authUrlWithCallback = `${loginUrl}&callback=http://localhost:${port}/callback`;
+      console.log(chalk.blue(`\nLogin URL: ${authUrlWithCallback}`));
+      console.log(chalk.yellow('Waiting for browser authentication...'));
+      await open(authUrlWithCallback);
+    });
+
+    server.on('error', (err) => {
+      console.log(chalk.red(`\nLocal server error: ${err.message}`));
+      console.log(chalk.yellow(`Fallback: After logging in, copy your API Key and run: skills-refiner config`));
+      resolve(false);
+    });
+
+    // Timeout if user takes too long
+    setTimeout(() => {
+      if (server.listening) {
+        server.close();
+        resolve(false);
+      }
+    }, 300000); // 5 mins
+  });
+}
+
+
+
+async function refineContent(content, lang, slugForDisplay = 'local', version = '1.0.0') {
+  const spinner = ora(chalk.cyan(`Refining ${slugForDisplay} into [${lang}]...`)).start();
+  const deviceId = await getDeviceId();
+  const apiKey = config.get('api_key');
+
+  try {
+    const response = await axios.post(`${API_BASE}/cli/refine`, {
+      content,
+      target_lang: lang,
+      client_type: 'cli',
+      client_version: version
+    }, {
+      headers: {
+        'X-Device-ID': deviceId,
+        'Authorization': apiKey ? `Bearer ${apiKey}` : undefined
+      }
+    });
+
+    spinner.succeed(chalk.green(`Refined successfully!`));
+    return response.data.refined_content;
+  } catch (err) {
+    spinner.stop();
+    if (err.response && err.response.data) {
+      const handled = await handleServerAction(err.response.data);
+      if (handled) return null;
+      console.log(chalk.red(`\nAPI Error: ${err.response.data.error || 'Unknown error'}`));
+    } else {
+      console.log(chalk.red(`\nNetwork Error: ${err.message}`));
+    }
+    process.exit(1);
+  }
+}
+
+async function downloadAndExtractSkill(slug, targetDir, refinedContent = null) {
+  const spinner = ora(chalk.cyan(`Downloading full skill bundle [${slug}]...`)).start();
+  try {
+    const response = await axios.post(`${API_BASE}/cli/skills/${slug}/download`, {
+      refined_content: refinedContent
+    }, {
+      responseType: 'arraybuffer',
+      timeout: 60000 // 60s timeout
+    });
+
+    const zip = new AdmZip(Buffer.from(response.data));
+    zip.extractAllTo(targetDir, true);
+    spinner.succeed(chalk.green(`Skill [${slug}] downloaded and extracted to ${targetDir}`));
+  } catch (err) {
+    spinner.fail(chalk.red(`Failed to download skill bundle: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+(async () => {
+  try {
+    // We can't always rely on package.json being relative if installed globally in a weird way,
+    // but standard node CLI structure usually keeps them together.
+    const pkgPath = new URL('../package.json', import.meta.url);
+    const pkg = JSON.parse(await fs.readFile(pkgPath, 'utf-8'));
+
+    // Alias -ls to --ls
+    process.argv = process.argv.map(arg => arg === '-ls' ? '--ls' : arg);
+
+    program
+      .name('skills-refiner')
+      .version(pkg.version)
+      .description('Refine your SKILL.md for AI Agents')
+      .argument('[skillName]', 'Optional: Name of the skill to download (e.g., OpenAI/doc)')
+      .option('-l, --lang <lang>', 'Target language (e.g., zh-CN)')
+      .option('--ls, --list', 'Show supported languages')
+      .action(async (skillName, options) => {
+        // --- 1. Handle --list / -ls ---
+        if (options.list) {
+          const table = new Table({ head: [chalk.cyan('Language'), chalk.cyan('Code')] });
+          languages.forEach(l => table.push([l.name, l.code]));
+          console.log(table.toString());
+          process.exit(0);
+        }
+
+        // --- 2. Determine Target Language ---
+        // For download (<skillName>), we ONLY refine if -l is explicitly provided (per latest user request).
+        // For local (no <skillName>), we use -l or config or auto-detect.
+        let targetLang = options.lang;
+        if (!skillName && !targetLang) {
+          targetLang = config.get('default_lang');
+        }
+
+        let content;
+
+        // --- 3. Scenario A: Download specific skill ---
+        if (skillName) {
+          // Fetch metadata first to ensure it exists
+          const skillMeta = await axios.get(`${API_BASE}/cli/skills/${skillName}`);
+          if (!skillMeta.data.success) {
+            console.log(chalk.red(`Skill not found: ${skillName}`));
+            process.exit(1);
+          }
+          content = skillMeta.data.data.content;
+          console.log(chalk.green(`Skill [${skillName}] found.`));
+        } else {
+          // --- 4. Scenario B: Local File Refinement ---
+          const localPath = path.resolve(process.cwd(), 'SKILL.md');
+          try {
+            content = await fs.readFile(localPath, 'utf-8');
+            console.log(chalk.blue(`Found local SKILL.md.`));
+          } catch {
+            console.log(chalk.yellow(`SKILL.md not found in current directory.`));
+            console.log(chalk.dim(`Usage:`));
+            console.log(chalk.dim(`  Download: skills-refiner <skill-name>   (e.g. OpenAI/doc)`));
+            console.log(chalk.dim(`  Refine:   skills-refiner -l <lang>      (Refine local SKILL.md)`));
+            process.exit(1);
+          }
+        }
+
+        // --- 5. Validate Language and Refine ---
+        let finalContent = content;
+
+        if (targetLang) {
+          const isValid = languages.some(l => l.code === targetLang || l.code.split('-')[0] === targetLang);
+          if (!isValid) {
+            console.log(chalk.red(`Invalid language code: ${targetLang}`));
+            console.log(chalk.yellow(`Use --ls to see available languages.`));
+            process.exit(1);
+          }
+
+          const refined = await refineContent(content, targetLang, skillName || 'local', pkg.version);
+          if (refined) finalContent = refined;
+        } else if (!skillName) {
+          // Local file, but no lang and no config. Auto-detect OS.
+          targetLang = await detectOSLocale();
+          console.log(chalk.dim(`No language specified. Defaulting to system locale: ${targetLang}`));
+          const refined = await refineContent(content, targetLang, 'local', pkg.version);
+          if (refined) finalContent = refined;
+        } else {
+          // Downloading raw
+          console.log(chalk.cyan(`Saving raw skill content...`));
+        }
+
+        // --- 6. Final Execution & Download ---
+        if (skillName) {
+          const targetDir = path.resolve(process.cwd(), skillName);
+          await downloadAndExtractSkill(skillName, targetDir, targetLang ? finalContent : null);
+
+          if (!targetLang) {
+            console.log(chalk.cyan(`\nTip: To refine/translate this skill, run:`));
+            console.log(chalk.white(`  skills-refiner -l zh-CN`));
+          }
+        } else {
+          // Local refinement save logic
+          const savePath = path.resolve(process.cwd(), 'SKILL.md');
+          const backupPath = path.resolve(process.cwd(), 'SKILL_BAK.md');
+
+          try {
+            await fs.access(savePath);
+            await fs.copyFile(savePath, backupPath);
+            console.log(chalk.dim(`Backed up existing SKILL.md to SKILL_BAK.md`));
+          } catch { }
+
+          await fs.writeFile(savePath, finalContent);
+          console.log(chalk.green(`\n✔ Refinement applied to SKILL.md`));
+        }
+      });
+
+    program
+      .command('config')
+      .description('Configure default settings')
+      .action(async () => {
+        const choice = await select({
+          message: 'What would you like to configure?',
+          choices: [
+            { name: 'Default Language', value: 'lang' },
+            { name: 'API Key', value: 'key' },
+            { name: 'Exit', value: 'exit' }
+          ]
+        });
+
+        if (choice === 'lang') {
+          const lang = await select({
+            message: 'Select default target language:',
+            choices: languages.map(l => ({ name: `${l.name} (${l.code})`, value: l.code })),
+            default: config.get('default_lang') || 'zh-CN'
+          });
+          config.set('default_lang', lang);
+          console.log(chalk.green(`Default language set to: ${lang}`));
+        } else if (choice === 'key') {
+          const key = await password({
+            message: 'Enter your API Key:',
+            mask: '*',
+          });
+          if (key) {
+            config.set('api_key', key);
+            console.log(chalk.green('API Key updated!'));
+          }
+        }
+      });
+
+    program
+      .command('logout')
+      .description('Remove API Key and login state')
+      .action(() => {
+        config.delete('api_key');
+        console.log(chalk.green('Logged out successfully.'));
+      });
+
+    program.parse();
+  } catch (err) {
+    console.error(chalk.red(`Fatal Error: ${err.message}`));
+    process.exit(1);
+  }
+})();

package/languages.js

@@ -0,0 +1,53 @@
+export const languages = [
+    { name: "English", code: "en-US" },
+    { name: "中文 (简体)", code: "zh-CN" },
+    { name: "中文 (繁體)", code: "zh-TW" },
+    { name: "हिन्दी (Hindi)", code: "hi-IN" },
+    { name: "Español", code: "es-ES" },
+    { name: "Français", code: "fr-FR" },
+    { name: "العربية (Arabic)", code: "ar-SA" },
+    { name: "বাংলা (Bengali)", code: "bn-BD" },
+    { name: "Português", code: "pt-BR" },
+    { name: "Русский (Russian)", code: "ru-RU" },
+    { name: "اردو (Urdu)", code: "ur-PK" },
+    { name: "Bahasa Indonesia", code: "id-ID" },
+    { name: "Deutsch", code: "de-DE" },
+    { name: "日本語 (Japanese)", code: "ja-JP" },
+    { name: "Nigerian Pidgin", code: "pcm-NG" },
+    { name: "मराठी (Marathi)", code: "mr-IN" },
+    { name: "తెలుగు (Telugu)", code: "te-IN" },
+    { name: "Türkçe", code: "tr-TR" },
+    { name: "தமிழ் (Tamil)", code: "ta-IN" },
+    { name: "廣東話 (Cantonese)", code: "yue-HK" },
+    { name: "Tiếng Việt", code: "vi-VN" },
+    { name: "Tagalog", code: "tl-PH" },
+    { name: "吴语 (Wu Chinese)", code: "wuu-CN" },
+    { name: "한국어 (Korean)", code: "ko-KR" },
+    { name: "فارسی (Persian)", code: "fa-IR" },
+    { name: "Hausa", code: "ha-NG" },
+    { name: "Kiswahili", code: "sw-KE" },
+    { name: "Basa Jawa (Javanese)", code: "jv-ID" },
+    { name: "Italiano", code: "it-IT" },
+    { name: "ਪੰਜਾਬੀ (Punjabi)", code: "pa-PK" },
+    { name: "ಕನ್ನಡ (Kannada)", code: "kn-IN" },
+    { name: "ગુજરાતી (Gujarati)", code: "gu-IN" },
+    { name: "ไทย (Thai)", code: "th-TH" },
+    { name: "አማርኛ (Amharic)", code: "am-ET" },
+    { name: "भोजपुरी (Bhojpuri)", code: "bho-IN" },
+    { name: "閩南語 (Hokkien)", code: "nan-TW" },
+    { name: "晋语 (Jin Chinese)", code: "cjy-CN" },
+    { name: "Yorùbá", code: "yo-NG" },
+    { name: "客家话 (Hakka)", code: "hak-CN" },
+    { name: "မြန်မာစာ (Burmese)", code: "my-MM" },
+    { name: "ଓଡ଼ିଆ (Odia)", code: "or-IN" },
+    { name: "Afaan Oromoo", code: "om-ET" },
+    { name: "پښتو (Pashto)", code: "ps-AF" },
+    { name: "Kurdî (Kurdish)", code: "ku-TR" },
+    { name: "Asụsụ Igbo", code: "ig-NG" },
+    { name: "മലയാളം (Malayalam)", code: "ml-IN" },
+    { name: "الدارجة (Algerian Arabic)", code: "ar-DZ" },
+    { name: "Azərbaycan dili", code: "az-AZ" },
+    { name: "Polski", code: "pl-PL" },
+    { name: "Oʻzbekcha", code: "uz-UZ" },
+    { name: "سنڌي (Sindhi)", code: "sd-PK" }
+];

package/locales/en.json

@@ -0,0 +1 @@
+{"description": "Refine your SKILL.md for AI Agents", "lang": "Target language (e.g., zh-CN, en)", "overwrite": "Overwrite original file with backup (Safe Mode)", "help": "display help for command", "config": "Configure default settings"}

package/locales/es.json

@@ -0,0 +1 @@
+{"description": "Refinar su SKILL.md para agentes de IA", "lang": "Idioma de destino (ej. es, en)", "overwrite": "Sobrescribir archivo original (Modo Seguro)", "help": "mostrar ayuda para el comando", "config": "Configurar ajustes predeterminados"}

package/locales/hi.json

@@ -0,0 +1 @@
+{"description": "AI एजेंटों के लिए अपने SKILL.md को सुधारें", "lang": "लक्ष्य भाषा (जैसे, hi, en)", "overwrite": "मूल फ़ाइल को बैकअप के साथ अधिलेखित करें (सुरक्षित मोड)", "help": "कमांड के लिए मदद दिखाएं", "config": "डिफ़ॉल्ट सेटिंग्स कॉन्फ़िगर करें"}

package/locales/ja.json

@@ -0,0 +1 @@
+{"description": "AIエージェント用にSKILL.mdを最適化", "lang": "対象言語 (例: ja, en)", "overwrite": "元のファイルを上書き (バックアップ付き安全モード)", "help": "ヘルプを表示", "config": "デフォルト設定を構成"}

package/locales/zh-CN.json

@@ -0,0 +1 @@
+{"description": "优化 SKILL.md 文档以供 AI Agent 使用", "lang": "目标语言 (例如: zh-CN, en)", "overwrite": "覆盖原文件 (安全模式，带备份)", "help": "显示命令帮助", "config": "配置默认设置"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "skills-refiner",
+  "version": "1.0.3",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "skills-refiner": "bin/skills-refiner.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "Skill Refiner Team",
+  "license": "ISC",
+  "description": "A geeky CLI tool to refine and translate SKILL.md for AI Agents.",
+  "dependencies": {
+    "@inquirer/prompts": "^8.2.0",
+    "adm-zip": "^0.5.16",
+    "axios": "^1.13.5",
+    "chalk": "^5.6.2",
+    "cli-table3": "^0.6.5",
+    "commander": "^14.0.3",
+    "conf": "^15.1.0",
+    "node-machine-id": "^1.1.12",
+    "open": "^11.0.0",
+    "ora": "^9.3.0",
+    "os-locale": "^8.0.0"
+  }
+}