jkpark 2.3.1 → 2.3.3

package/README.md

@@ -0,0 +1,15 @@
+# jkpark
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run src/index.ts
+```
+
+This project was created using `bun init` in bun v1.3.9. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

package/dist/index.js

@@ -22714,7 +22714,7 @@ var {
 } = import__.default;
 
 // src/index.ts
-import path5 from "path";
+import path6 from "path";
 import { fileURLToPath } from "url";
 
 // node_modules/@inquirer/core/dist/lib/key.js
@@ -25687,99 +25687,58 @@ var dist_default14 = inquirer;
 // src/commands/install.ts
 var import_fs_extra = __toESM(require_lib4(), 1);
 import path4 from "path";
-import fs3 from "fs";
+import fs2 from "fs";
 
 // src/core/path-manager.ts
 import path2 from "path";
 import os2 from "os";
-import fs from "fs";
 
 class PathManager {
-  static getOpenClawRoot() {
-    return path2.join(os2.homedir(), ".openclaw");
+  static getOpenClawWorkspaceRoot() {
+    return path2.join(os2.homedir(), ".openclaw", "workspace", "skills");
   }
-  static getClaudeRoot() {
-    return path2.join(os2.homedir(), ".claude");
+  static getAntigravityRoot(cwd) {
+    return path2.join(cwd, ".agent", "skills");
   }
-  static getGitHubRoot() {
-    return path2.join(os2.homedir(), ".config", "gh");
-  }
-  static getWorkspaces(root) {
-    if (!fs.existsSync(root))
-      return [];
-    let entries;
-    try {
-      entries = fs.readdirSync(root);
-    } catch (e) {
-      return [];
-    }
-    return entries.filter((f) => {
-      if (f.startsWith("."))
-        return false;
-      const fullPath = path2.join(root, f);
-      try {
-        return fs.statSync(fullPath).isDirectory();
-      } catch {
-        return false;
-      }
-    });
+  static getJkparkSkillsRoot() {
+    return path2.join(os2.homedir(), ".jkpark", "skills");
   }
   static resolveFinalPath(baseDir, relativeOrAbsolute) {
     return path2.isAbsolute(relativeOrAbsolute) ? relativeOrAbsolute : path2.resolve(baseDir, relativeOrAbsolute);
   }
 }
 
-// src/core/plugin-manager.ts
-import fs2 from "fs";
+// src/core/skill-manager.ts
+import fs from "fs";
 import path3 from "path";
 
-class PluginManager {
-  pluginsDir;
+class SkillManager {
+  skillsDir;
   constructor(baseDir) {
-    this.pluginsDir = path3.join(baseDir, "plugins");
+    this.skillsDir = path3.join(baseDir, "skills");
   }
-  async getCategories() {
-    if (!fs2.existsSync(this.pluginsDir))
+  async getAllSkills() {
+    if (!fs.existsSync(this.skillsDir))
       return [];
-    const dirs = fs2.readdirSync(this.pluginsDir).filter((f) => fs2.statSync(path3.join(this.pluginsDir, f)).isDirectory());
-    return dirs.map((dir) => {
-      const pluginJsonPath = path3.join(this.pluginsDir, dir, "plugin.json");
-      let config = { name: dir, description: "No description provided" };
-      if (fs2.existsSync(pluginJsonPath)) {
-        try {
-          config = { ...config, ...JSON.parse(fs2.readFileSync(pluginJsonPath, "utf8")) };
-        } catch (e) {
-          console.warn(`Failed to parse plugin config at ${pluginJsonPath}:`, e);
-        }
-      }
-      return { ...config, value: dir };
-    });
-  }
-  async getSkills(category) {
-    const skillsDir = path3.join(this.pluginsDir, category, "skills");
-    if (!fs2.existsSync(skillsDir))
-      return [];
-    const skills = fs2.readdirSync(skillsDir, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
+    const skills = fs.readdirSync(this.skillsDir, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
     return skills.map((skill) => {
-      const skillPath = path3.join(skillsDir, skill, "SKILL.md");
+      const skillPath = path3.join(this.skillsDir, skill, "SKILL.md");
       let description = "No description provided";
-      if (fs2.existsSync(skillPath)) {
-        const content = fs2.readFileSync(skillPath, "utf8");
+      if (fs.existsSync(skillPath)) {
+        const content = fs.readFileSync(skillPath, "utf8");
         const match = content.match(/^description:\s*(.*)$/m);
         if (match && match[1]) {
-          description = match[1].trim();
+          description = match[1].replace(/^["']|["']$/g, "").trim();
         }
       }
       return {
         name: skill,
         description,
-        value: skill
+        value: skill,
+        sourcePath: path3.join(this.skillsDir, skill)
       };
     });
   }
-  getSkillSourcePath(category, skill) {
-    return path3.join(this.pluginsDir, category, "skills", skill);
-  }
 }
 
 // src/commands/install.ts
@@ -25787,39 +25746,66 @@ async function runInstallWizard(projectRoot) {
   console.log(`
 \uD83D\uDC3E jkpark 설치 마법사에 오신 걸 환영합니다!
 `);
-  const pluginManager = new PluginManager(projectRoot);
-  const categoryChoices = await pluginManager.getCategories();
-  if (categoryChoices.length === 0) {
-    console.log("❌ 설치 가능한 플러그인이 없습니다. plugins 폴더를 확인해 주세요.");
-    return;
-  }
+  const cwd = process.cwd();
   const { targetType } = await dist_default14.prompt([
     {
-      type: "list",
+      type: "select",
       name: "targetType",
       message: "설치할 서비스(Target)를 선택하세요:",
       choices: [
-        { name: "\uD83C\uDFD7️  OpenClaw".padEnd(15) + " - OpenClaw Agents & Shared Skills", value: "openclaw" },
-        { name: "\uD83E\uDD16 Claude".padEnd(15) + " - Claude Code CLI & Global Skills", value: "claude" },
-        { name: "\uD83D\uDC19 GitHub".padEnd(15) + " - GitHub CLI Extensions (gh-extension)", value: "github" }
+        { name: "openclaw (workspace)", value: "openclaw" },
+        { name: "antigravity (workspace)", value: "antigravity" },
+        { name: "custom path", value: "custom" }
       ]
     }
   ]);
-  const { selectedCategory } = await dist_default14.prompt([
+  let targetPath = "";
+  if (targetType === "openclaw") {
+    targetPath = PathManager.getOpenClawWorkspaceRoot();
+  } else if (targetType === "antigravity") {
+    targetPath = PathManager.getAntigravityRoot(cwd);
+  } else {
+    const { customPath } = await dist_default14.prompt([
+      {
+        type: "input",
+        name: "customPath",
+        message: "설치 경로를 입력하세요:",
+        validate: (input) => input.trim() !== "" ? true : "경로를 입력해야 합니다."
+      }
+    ]);
+    targetPath = PathManager.resolveFinalPath(cwd, customPath);
+  }
+  console.log(`
+\uD83D\uDCCD 설정된 Target Path: ${targetPath}`);
+  const { pathConfirm } = await dist_default14.prompt([
     {
-      type: "list",
-      name: "selectedCategory",
-      message: "설치할 플러그인 카테고리를 선택하세요:",
-      choices: categoryChoices.map((c) => ({
-        name: `${c.name.padEnd(15)} - ${c.description}`,
-        value: c.value
-      }))
+      type: "confirm",
+      name: "pathConfirm",
+      message: "위 경로에 설치하시겠습니까?",
+      default: true
     }
   ]);
-  const skills = await pluginManager.getSkills(selectedCategory);
-  if (skills.length === 0) {
+  if (!pathConfirm) {
     console.log(`
-⚠️  ${selectedCategory} 카테고리에 설치 가능한 스킬이 없습니다.`);
+❌ 설치가 취소되었습니다.`);
+    return;
+  }
+  const { installOption } = await dist_default14.prompt([
+    {
+      type: "select",
+      name: "installOption",
+      message: "설치 옵션을 선택하세요:",
+      choices: [
+        { name: "Option 1: 직접 설치 (타겟 폴더에 직접 복사)", value: "direct" },
+        { name: "Option 2: 심볼릭 링크로 설치 (~/.jkpark/skills 에 설치 후 링크 생성)", value: "symlink" }
+      ]
+    }
+  ]);
+  const skillManager = new SkillManager(projectRoot);
+  const allSkills = await skillManager.getAllSkills();
+  if (allSkills.length === 0) {
+    console.log(`
+⚠️ 설치 가능한 스킬이 없습니다.`);
     return;
   }
   const { selectedSkills } = await dist_default14.prompt([
@@ -25827,119 +25813,174 @@ async function runInstallWizard(projectRoot) {
       type: "checkbox",
       name: "selectedSkills",
       message: "설치할 스킬들을 선택하세요 (Space로 선택, Enter로 완료):",
-      choices: skills.map((s) => ({
-        name: `${s.name.padEnd(25)} - ${s.description}`,
-        value: s.value
-      })),
+      choices: allSkills.map((s) => {
+        const desc = s.description.length > 65 ? s.description.substring(0, 65) + "..." : s.description;
+        return {
+          name: `${s.value.padEnd(25)} - ${desc}`,
+          value: s.value
+        };
+      }),
+      loop: false,
       validate: (answer) => answer.length > 0 ? true : "최소 하나 이상의 스킬을 선택해야 합니다."
     }
   ]);
-  let rootPath;
-  if (targetType === "openclaw") {
-    rootPath = PathManager.getOpenClawRoot();
-  } else if (targetType === "claude") {
-    rootPath = PathManager.getClaudeRoot();
-  } else {
-    rootPath = PathManager.getGitHubRoot();
-  }
-  const workspaces = PathManager.getWorkspaces(rootPath);
-  const scopeChoices = [
-    { name: "Current Directory (현재 프로젝트)", value: process.cwd() }
-  ];
-  if (targetType === "openclaw") {
-    scopeChoices.push({ name: `Shared Skills (모든 에이전트 공유: ${path4.join(rootPath, "skills")})`, value: path4.join(rootPath, "skills") });
-  } else if (targetType === "claude") {
-    scopeChoices.push({ name: `Global Skills (~/.claude/skills)`, value: path4.join(rootPath, "skills") });
-  } else if (targetType === "github") {
-    scopeChoices.push({ name: `GitHub Extensions (~/.config/gh/extensions)`, value: path4.join(rootPath, "extensions") });
-  }
-  scopeChoices.push(...workspaces.map((ws) => ({ name: `Workspace: ${ws}`, value: path4.join(rootPath, ws) })));
-  scopeChoices.push({ name: "Custom Path (직접 입력)", value: "custom" });
-  const { scope } = await dist_default14.prompt([
-    {
-      type: "list",
-      name: "scope",
-      message: `${targetType} 설치 범위를 선택하세요 (Default: Current Directory):`,
-      choices: scopeChoices,
-      default: 0
-    }
-  ]);
-  let finalTargetDir;
-  if (scope === "custom") {
-    const { customPath } = await dist_default14.prompt([
-      {
-        type: "input",
-        name: "customPath",
-        message: "설치 경로를 입력하세요:",
-        validate: (input) => input.trim() !== "" ? true : "경로를 입력해야 합니다."
-      }
-    ]);
-    finalTargetDir = PathManager.resolveFinalPath(process.cwd(), customPath);
-  } else {
-    finalTargetDir = scope;
-  }
-  const skillsBaseDir = targetType === "github" && scope.endsWith("extensions") ? finalTargetDir : path4.join(finalTargetDir, "skills");
   console.log(`
-\uD83D\uDCCD Base Target Path: ${finalTargetDir}`);
-  console.log(`\uD83D\uDEE0️  Selected Skills: ${selectedSkills.join(", ")}`);
-  console.log(`\uD83D\uDE80 Installation Path: ${skillsBaseDir}/{skill_name}
-`);
-  const { proceed } = await dist_default14.prompt([
+\uD83D\uDEE0️ 선택된 스킬 목록:`);
+  selectedSkills.forEach((s) => console.log(`  - ${s}`));
+  const { skillConfirm } = await dist_default14.prompt([
     {
       type: "confirm",
-      name: "proceed",
-      message: "위 설정대로 설치를 진행할까요?",
+      name: "skillConfirm",
+      message: "위 스킬들을 설치하시겠습니까?",
       default: true
     }
   ]);
-  if (proceed) {
+  if (!skillConfirm) {
     console.log(`
+❌ 설치가 취소되었습니다.`);
+    return;
+  }
+  console.log(`
 \uD83D\uDE80 설치를 시작합니다...`);
-    if (!fs3.existsSync(skillsBaseDir)) {
-      fs3.mkdirSync(skillsBaseDir, { recursive: true });
+  const jkparkSkillsRoot = PathManager.getJkparkSkillsRoot();
+  if (installOption === "direct") {
+    if (!fs2.existsSync(targetPath)) {
+      fs2.mkdirSync(targetPath, { recursive: true });
+    }
+  } else {
+    if (!fs2.existsSync(jkparkSkillsRoot)) {
+      fs2.mkdirSync(jkparkSkillsRoot, { recursive: true });
+    }
+    if (!fs2.existsSync(targetPath)) {
+      fs2.mkdirSync(targetPath, { recursive: true });
     }
-    for (const skill of selectedSkills) {
-      const srcDir = pluginManager.getSkillSourcePath(selectedCategory, skill);
-      const destDir = path4.join(skillsBaseDir, skill);
+  }
+  for (const skillValue of selectedSkills) {
+    const skillObj = allSkills.find((s) => s.value === skillValue);
+    if (!skillObj || !skillObj.sourcePath)
+      continue;
+    if (installOption === "direct") {
+      const destDir = path4.join(targetPath, skillObj.name);
+      try {
+        console.log(`- [${skillValue}] 직접 복사 중...`);
+        await import_fs_extra.default.copy(skillObj.sourcePath, destDir);
+        console.log(`  ✅ [${skillValue}] 복사 완료`);
+      } catch (err) {
+        console.error(`  ❌ [${skillValue}] 복사 실패:`, err.message);
+      }
+    } else {
+      const baseDestDir = path4.join(jkparkSkillsRoot, skillObj.name);
+      const symlinkDestDir = path4.join(targetPath, skillObj.name);
       try {
-        console.log(`- [${skill}] 복사 중...`);
-        await import_fs_extra.default.copy(srcDir, destDir);
-        console.log(`  ✅ [${skill}] 설치 완료`);
+        console.log(`- [${skillValue}] ~/.jkpark/skills에 복사 중...`);
+        await import_fs_extra.default.copy(skillObj.sourcePath, baseDestDir);
+        console.log(`- [${skillValue}] 심볼릭 링크 생성 중...`);
+        if (fs2.existsSync(symlinkDestDir)) {
+          fs2.rmSync(symlinkDestDir, { recursive: true, force: true });
+        }
+        const symlinkType = process.platform === "win32" ? "junction" : "dir";
+        fs2.symlinkSync(baseDestDir, symlinkDestDir, symlinkType);
+        console.log(`  ✅ [${skillValue}] 링크 설치 완료 (${symlinkType} 방식)`);
       } catch (err) {
-        console.error(`  ❌ [${skill}] 설치 실패:`, err.message);
+        console.error(`  ❌ [${skillValue}] 설치 실패:`, err.message);
       }
     }
-    console.log(`
-✅ 모든 작업이 완료되었습니다. 형, 설치가 끝났어! \uD83D\uDC3E`);
-  } else {
-    console.log(`
-❌ 설치가 취소되었습니다.`);
   }
+  console.log(`
+✅ 모든 작업이 완료되었습니다! \uD83D\uDC3E`);
 }
 async function runListCommand(projectRoot) {
-  const pluginManager = new PluginManager(projectRoot);
-  const categories = await pluginManager.getCategories();
+  const skillManager = new SkillManager(projectRoot);
+  const allSkills = await skillManager.getAllSkills();
   console.log(`
-\uD83D\uDCE6 사용 가능한 플러그인 목록:
+\uD83D\uDCE6 사용 가능한 스킬 목록:
 `);
-  for (const cat of categories) {
-    console.log(`\uD83D\uDCC2 ${cat.name} (${cat.description})`);
-    const skills = await pluginManager.getSkills(cat.value);
-    for (const skill of skills) {
-      console.log(`  - ${skill.name}: ${skill.description}`);
+  if (allSkills.length === 0) {
+    console.log("  ⚠️ 설치 가능한 스킬이 없습니다.");
+    return;
+  }
+  for (const skill of allSkills) {
+    const desc = skill.description.length > 65 ? skill.description.substring(0, 65) + "..." : skill.description;
+    console.log(`  - ${skill.name}: ${desc}`);
+  }
+  console.log("");
+}
+
+// src/commands/clean.ts
+import fs3 from "fs";
+import path5 from "path";
+var import_fs_extra2 = __toESM(require_lib4(), 1);
+async function runCleanCommand() {
+  console.log(`
+\uD83E\uDDF9 jkpark 캐시 정리 마법사에 오신 걸 환영합니다!
+`);
+  const jkparkSkillsRoot = PathManager.getJkparkSkillsRoot();
+  const openClawTarget = PathManager.getOpenClawWorkspaceRoot();
+  const antigravityTarget = PathManager.getAntigravityRoot(process.cwd());
+  console.log(`\uD83D\uDCCD 캐시 폴더 경로: ${jkparkSkillsRoot}`);
+  console.log(`\uD83D\uDCCD 타겟 폴더 (openclaw): ${openClawTarget}`);
+  console.log(`\uD83D\uDCCD 타겟 폴더 (antigravity): ${antigravityTarget}`);
+  const { confirmClean } = await dist_default14.prompt([
+    {
+      type: "confirm",
+      name: "confirmClean",
+      message: `위 경로들의 스킬 캐시 공간을 비우고 각 타겟 폴더에 생성된 모든 심볼릭 링크(스킬 연결)를 삭제하시겠습니까?
+  (이 작업은 되돌릴 수 없으며 설치된 스킬 연결이 해제됩니다.)`,
+      default: false
     }
-    console.log("");
+  ]);
+  if (!confirmClean) {
+    console.log(`
+❌ 캐시 비우기가 취소되었습니다.`);
+    return;
+  }
+  try {
+    console.log(`
+\uD83D\uDDD1️ 원본 캐시 삭제 중...`);
+    if (fs3.existsSync(jkparkSkillsRoot)) {
+      import_fs_extra2.default.emptyDirSync(jkparkSkillsRoot);
+      console.log(`  ✨ [${jkparkSkillsRoot}] 내부 비우기 완료`);
+    } else {
+      console.log(`  ✅ 캐시 폴더가 이미 비어있거나 없습니다.`);
+    }
+    console.log(`
+\uD83D\uDDD1️ 타겟 심볼릭 링크 삭제 중...`);
+    const targets = [openClawTarget, antigravityTarget];
+    for (const target of targets) {
+      if (fs3.existsSync(target)) {
+        const items = fs3.readdirSync(target);
+        for (const item of items) {
+          const itemPath = path5.join(target, item);
+          try {
+            const stat = fs3.lstatSync(itemPath);
+            if (stat.isSymbolicLink()) {
+              fs3.rmSync(itemPath, { recursive: true, force: true });
+              console.log(`  \uD83D\uDD17 링크 삭제됨: ${itemPath}`);
+            }
+          } catch (e) {
+            console.log(`  ❌ 링크 삭제 실패: ${itemPath} (${e.message})`);
+          }
+        }
+      }
+    }
+    console.log(`
+✨ 캐시 정리 및 링크 해제 작업이 깔끔하게 완료되었습니다!`);
+  } catch (error) {
+    console.error(`
+❌ 삭제 프로세스 중 에러가 발생했습니다:`, error.message);
   }
 }
 
 // src/index.ts
 var __filename2 = fileURLToPath(import.meta.url);
-var __dirname2 = path5.dirname(__filename2);
-var projectRoot = process.env.JKPARK_CLI_ROOT || path5.join(__dirname2, "..");
+var __dirname2 = path6.dirname(__filename2);
+var projectRoot = process.env.JKPARK_CLI_ROOT || path6.join(__dirname2, "..");
 var program2 = new Command;
-program2.name("jkpark").description("JK Park의 개인용 패키지 관리 도구").version("2.3.0");
+var VERSION = "2.3.2";
+program2.name("jkpark").description("JK Park의 개인용 패키지 관리 도구").version(VERSION);
 program2.command("install").description("패키지 설치 마법사를 실행합니다").action(() => runInstallWizard(projectRoot));
 program2.command("list").description("사용 가능한 모든 플러그인과 스킬을 나열합니다").action(() => runListCommand(projectRoot));
+program2.command("clean").description("설치된 로컬 스킬 캐시(~/.jkpark/skills)를 모두 삭제하여 초기화합니다").action(() => runCleanCommand());
 if (!process.argv.slice(2).length) {
   program2.outputHelp();
 } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jkpark",
-  "version": "2.3.1",
+  "version": "2.3.3",
   "description": "JK Park's Personal Package Manager (Bun Powered)",
   "type": "module",
   "scripts": {

package/plugins/gcp/plugin.json

@@ -1 +0,0 @@
-{"name": "GCP Tools", "description": "Google Cloud Platform automation skills"}

package/plugins/gcp/skills/gcloud-compute-automation/SKILL.md

@@ -1,124 +0,0 @@
----
-name: gcloud-compute-automation
-description: "Automates Google Cloud Compute Engine instance management including setup, instance creation, and SSH connection. Use this skill when the user needs to: (1) Install or configure the gcloud CLI, (2) Create new VM instances, or (3) Connect to existing instances via SSH."
----
-
-# GCloud Compute Automation
-
-This skill provides a consolidated guide for managing Google Cloud Compute Engine instances directly using the `gcloud` CLI.
-
-## 1. Setup Guide
-
-If `gcloud` is not yet installed or configured, follow these steps:
-
-### Installation
-- **Debian/Ubuntu:**
-  ```bash
-  # Add Package Source
-  sudo apt-get install -y apt-transport-https ca-certificates gnupg curl
-  curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
-  echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee /etc/apt/sources.list.d/google-cloud-sdk.list
-
-  # Install
-  sudo apt-get update && sudo apt-get install -y google-cloud-cli
-  ```
-- **Other Linux Distributions:**
-  ```bash
-  curl https://sdk.cloud.google.com | bash
-  exec -l $SHELL
-  ```
-- **macOS:**
-  ```bash
-  brew install --cask google-cloud-sdk
-  ```
-
-### Initialization & Authentication
-1. **Initialize gcloud**:
-   ```bash
-   gcloud init
-   ```
-2. **Web-free Login**: If you are in a remote environment or prefer no browser, run:
-   ```bash
-   gcloud auth login --no-launch-browser
-   ```
-   - Copy the provided URL into your local browser.
-   - Authorize access and copy the verification code.
-   - Paste the code back into your terminal.
-
-## 2. Project Management
-
-After logging in, you must select or create a Google Cloud Project.
-
-### A. List Existing Projects
-Check if you already have a project to use:
-```bash
-gcloud projects list
-```
-
-### B. Create a New Project
-If you don't have a project, or want a new one for this VM, follow these steps:
-1. **Create the project**:
-   ```bash
-   gcloud projects create [PROJECT_ID] --name="[PROJECT_NAME]"
-   ```
-   *Note: [PROJECT_ID] must be unique across all of Google Cloud.*
-2. **Set as active**:
-   ```bash
-   gcloud config set project [PROJECT_ID]
-   ```
-3. **Enable Compute Engine API**:
-   ```bash
-   gcloud services enable compute.googleapis.com
-   ```
-   *Note: This requires billing to be enabled for the project.*
-
----
-
-## 3. VM Management Workflow
-
-Follow this workflow to create and connect to a VM.
-
-### Step A: Evaluate Machine Type and Cost
-Before creating an instance, check the available machine types and their specifications to estimate costs.
-
-1. **List Machine Types**: Display available machine types and their core/memory specs in your zone.
-   ```bash
-   gcloud compute machine-types list --zones=[ZONE]
-   ```
-   *Note: Costs vary by machine type. For example, `e2-micro` is generally the cheapest, while `e2-standard-4` provides more resources at a higher price.*
-
-2. **Estimate Cost**: Use the [Google Cloud Pricing Calculator](https://cloud.google.com/products/calculator) for precise estimates based on your selected machine type and region.
-
-### Step B: Create an Instance
-**Mandatory**: You must provide a unique name for your instance.
-
-```bash
-gcloud compute instances create [MANDATORY_INSTANCE_NAME] \
-    --zone=[ZONE] \
-    --machine-type=[MACHINE_TYPE] \
-    --image-family=debian-12 \
-    --image-project=debian-cloud
-```
-*Tip: Common zones include `us-central1-a`, `asia-northeast3-a` (Seoul). Recommended machine types: `e2-micro` (development), `e2-small` (standard).*
-
-### Step C: Connect via SSH
-Once the instance is running, connect using:
-```bash
-gcloud compute ssh [INSTANCE_NAME] --zone=[ZONE]
-```
-
----
-
-## 4. Quick Reference
-
-| Action | Command |
-| :--- | :--- |
-| **List Instances** | `gcloud compute instances list` |
-| **Stop Instance** | `gcloud compute instances stop [NAME]` |
-| **Start Instance** | `gcloud compute instances start [NAME]` |
-| **Delete Instance** | `gcloud compute instances delete [NAME]` |
-| **Check Config** | `gcloud config list` |
-
-## Tips for Efficiency
-- **Preemptible VMs:** Add `--preemptible` to the create command to save up to 80% on costs for short-lived tasks.
-- **Static External IP:** If you need a constant IP, use `--address=[IP_NAME]`.

package/plugins/trading/plugin.json

@@ -1 +0,0 @@
-{"name": "Trading Bot", "description": "Binance trading automation skills"}

package/plugins/trading/skills/binance-trader/SKILL.md

@@ -1,48 +0,0 @@
----
-name: binance-trader
-description: Interface with the Binance API using python-binance. Use for automated trading, account management, market data retrieval, and real-time socket streaming. Contains examples for orders, historical data, and async operations.
----
-
-# Binance Trader Skill
-
-This skill provides a structured way to interact with the Binance exchange using the `python-binance` Python wrapper.
-
-## Core Workflows
-
-### 1. Market Data Retrieval
-Fetch current prices, order books, or historical K-line (candle) data.
-- **Reference**: See [references/api_usage.md](references/api_usage.md)
-- **Example Script**: [scripts/historical_data.py](scripts/historical_data.py)
-
-### 2. Account & Portfolio Management
-Check balances and manage account settings.
-- **Example Script**: [scripts/basic_ops.py](scripts/basic_ops.py)
-
-### 3. Order Execution
-Place Market, Limit, or OCO (One-Cancels-the-Other) orders.
-- **Reference**: See [references/api_usage.md](references/api_usage.md)
-- **Example Script**: [scripts/order_examples.py](scripts/order_examples.py)
-
-### 4. Real-time Streaming (WebSockets)
-Stream ticker updates, trade data, or account updates using `asyncio`.
-- **Example Script**: [scripts/async_sockets.py](scripts/async_sockets.py)
-
-## Best Practices
-
-- **Security**: Always use environment variables (`BINANCE_API_KEY`, `BINANCE_API_SECRET` or `BINANCE_SECRET_KEY`) instead of hardcoding keys.
-- **.env file (required)**: Place your API keys in a `.env` file at the project root. If `.env` does not exist, create it from the provided template:
-
-  ```bash
-  cp skills/binance-trader/assets/.env.example .env
-  # then edit .env and fill in your keys
-  ```
-
-  Scripts shipped with this skill will automatically look for `.env` in the script directory, the `test/` folder, and the project root.
-
-- **Error Handling**: Wrap API calls in `try-except` blocks to handle `BinanceAPIException`.
-- **Rate Limits**: Be mindful of Binance's rate limits (weight-based).
-- **Testnet**: Use `testnet=True` during development to avoid losing real funds.
-
-## Resources
-- **Repository**: [sammchardy/python-binance](https://github.com/sammchardy/python-binance)
-- **Official Docs**: [python-binance.readthedocs.io](https://python-binance.readthedocs.io/en/latest/)

package/plugins/trading/skills/binance-trader/assets/.env.example

@@ -1,9 +0,0 @@
-# Binance API Credentials
-BINANCE_API_KEY=your_api_key_here
-BINANCE_API_SECRET=your_api_secret_here
-
-# Optional: Binance TLD (e.g., 'us' for binance.us)
-# BINANCE_TLD=com
-
-# Optional: Testnet mode (True/False)
-# BINANCE_TESTNET=False

package/plugins/trading/skills/binance-trader/references/api_usage.md

@@ -1,65 +0,0 @@
-# Binance API Guide (python-binance)
-
-This guide covers common tasks when using the `python-binance` library.
-
-## Setup
-
-Install the library:
-```bash
-pip install python-binance python-dotenv
-```
-
-## Credentials
-
-Create a `.env` file based on `assets/.env.example`:
-```bash
-cp skills/binance-trader/assets/.env.example .env
-```
-Edit `.env` and add your Binance API keys (required variables: `BINANCE_API_KEY` and `BINANCE_API_SECRET` — the scripts also support `BINANCE_SECRET_KEY`).
-
-If `.env` is missing, the scripts will try to find it in the script directory, the `test/` folder, and then the project root; if you prefer, place `.env` at the project root for consistency.
-
-## Client Initialization
-
-```python
-from binance import Client
-client = Client(api_key, api_secret)
-# For Testnet
-# client = Client(api_key, api_secret, testnet=True)
-```
-
-## Common REST API Methods
-
-| Method | Description |
-|--------|-------------|
-| `get_account()` | Fetch account information and balances |
-| `get_asset_balance(asset='BTC')` | Get balance for a specific asset |
-| `get_symbol_ticker(symbol='BTCUSDT')` | Get latest price |
-| `get_order_book(symbol='BTCUSDT')` | Get order book depth |
-| `get_historical_klines(symbol, interval, start_str, end_str=None)` | Get historical OHLCV data |
-
-## Order Types
-
-### Market Order
-```python
-client.create_order(symbol='BTCUSDT', side='BUY', type='MARKET', quantity=0.001)
-```
-
-### Limit Order
-```python
-client.create_order(symbol='BTCUSDT', side='SELL', type='LIMIT', timeInForce='GTC', quantity=0.001, price='70000')
-```
-
-### OCO Order
-```python
-client.create_oco_order(symbol='BTCUSDT', side='SELL', quantity=0.001, price='75000', stopPrice='60000', stopLimitPrice='59900', stopLimitTimeInForce='GTC')
-```
-
-## WebSockets (Async)
-
-Use `BinanceSocketManager` for real-time data.
-
-```python
-from binance import AsyncClient, BinanceSocketManager
-# See scripts/async_sockets.py for example
-```

package/plugins/trading/skills/binance-trader/scripts/async_sockets.py

@@ -1,29 +0,0 @@
-import asyncio
-from binance import AsyncClient, BinanceSocketManager
-import os
-
-# Manual .env loading if dotenv is missing
-if os.path.exists('.env'):
-    with open('.env', 'r') as f:
-        for line in f:
-            if '=' in line and not line.startswith('#'):
-                key, value = line.strip().split('=', 1)
-                os.environ[key] = value
-
-async def main():
-    client = await AsyncClient.create(
-        api_key=os.getenv('BINANCE_API_KEY'),
-        api_secret=os.getenv('BINANCE_API_SECRET') or os.getenv('BINANCE_SECRET_KEY')
-    )
-    bsm = BinanceSocketManager(client)
-    
-    # K-line socket
-    async with bsm.kline_socket(symbol='BTCUSDT') as stream:
-        for _ in range(5):
-            res = await stream.recv()
-            print(f"BTCUSDT K-line: {res['k']['c']}") # Current close price
-
-    await client.close_connection()
-
-if __name__ == "__main__":
-    asyncio.run(main())

package/plugins/trading/skills/binance-trader/scripts/basic_ops.py

@@ -1,31 +0,0 @@
-from binance import Client
-import os
-
-# Manual .env loading if dotenv is missing
-env_path = '.env'
-if not os.path.exists(env_path):
-    env_path = os.path.join(os.path.dirname(__file__), '..', '..', '.env') # From scripts/ to root
-
-if os.path.exists(env_path):
-    with open(env_path, 'r') as f:
-        for line in f:
-            if '=' in line and not line.startswith('#'):
-                key, value = line.strip().split('=', 1)
-                os.environ[key] = value.strip('"').strip("'")
-
-api_key = os.getenv('BINANCE_API_KEY')
-api_secret = os.getenv('BINANCE_API_SECRET') or os.getenv('BINANCE_SECRET_KEY')
-
-client = Client(api_key, api_secret)
-
-# Get market depth
-depth = client.get_order_book(symbol='BTCUSDT')
-print(f"Bids: {depth['bids'][:3]}")
-
-# Get account information
-account = client.get_account()
-print(f"Account balances: {[b for b in account['balances'] if float(b['free']) > 0]}")
-
-# Get asset balance
-balance = client.get_asset_balance(asset='BTC')
-print(f"BTC Balance: {balance}")

package/plugins/trading/skills/binance-trader/scripts/historical_data.py

@@ -1,28 +0,0 @@
-from binance import Client
-import os
-
-client = Client() # Public API doesn't require keys
-
-# Fetch 1 minute klines for the last day
-klines = client.get_historical_klines("BTCUSDT", Client.KLINE_INTERVAL_1MINUTE, "1 day ago UTC")
-
-# kline format:
-# [
-#   [
-#     1499040000000,      # Open time
-#     "0.01634790",       # Open
-#     "0.80000000",       # High
-#     "0.01575800",       # Low
-#     "0.01577100",       # Close
-#     "148976.11427815",  # Volume
-#     1499644799999,      # Close time
-#     "2434.19055334",    # Quote asset volume
-#     308,                # Number of trades
-#     "1756.87402397",    # Taker buy base asset volume
-#     "28.46694368",      # Taker buy quote asset volume
-#     "17928899.62484339" # Ignore
-#   ]
-# ]
-
-for k in klines[:5]:
-    print(f"Time: {k[0]}, Open: {k[1]}, Close: {k[4]}")

package/plugins/trading/skills/binance-trader/scripts/order_examples.py

@@ -1,48 +0,0 @@
-from binance import Client
-import os
-
-# Manual .env loading if dotenv is missing
-env_path = '.env'
-if not os.path.exists(env_path):
-    env_path = os.path.join(os.path.dirname(__file__), '..', '..', '.env')
-
-if os.path.exists(env_path):
-    with open(env_path, 'r') as f:
-        for line in f:
-            if '=' in line and not line.startswith('#'):
-                key, value = line.strip().split('=', 1)
-                os.environ[key] = value.strip('"').strip("'")
-
-api_key = os.getenv('BINANCE_API_KEY')
-api_secret = os.getenv('BINANCE_API_SECRET') or os.getenv('BINANCE_SECRET_KEY')
-
-client = Client(api_key, api_secret)
-
-# 1. Market Buy Order
-# order = client.create_order(
-#     symbol='BNBBTC',
-#     side=Client.SIDE_BUY,
-#     type=Client.ORDER_TYPE_MARKET,
-#     quantity=100)
-
-# 2. Limit Sell Order
-# order = client.create_order(
-#     symbol='BNBBTC',
-#     side=Client.SIDE_SELL,
-#     type=Client.ORDER_TYPE_LIMIT,
-#     timeInForce=Client.TIME_IN_FORCE_GTC,
-#     quantity=100,
-#     price='0.0001')
-
-# 3. OCO (One-Cancels-the-Other) Order
-# OCO orders are useful for setting both a take-profit and a stop-loss
-# order = client.create_oco_order(
-#     symbol='BTCUSDT',
-#     side=Client.SIDE_SELL,
-#     stopLimitTimeInForce=Client.TIME_IN_FORCE_GTC,
-#     quantity=0.001,
-#     stopPrice='60000',
-#     stopLimitPrice='59900',
-#     price='75000')
-
-print("Example script for order types. Uncomment code blocks to use.")