botrun-horse 2.29.2 → 2.30.0

package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-pr-create.mjs

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+/**
+ * GitHub Create Pull Request Script
+ * 建立 Pull Request
+ *
+ * Usage:
+ *   node github-pr-create.mjs --userId "user123" --repo "owner/repo" --title "PR Title" --head "feature-branch" --base "main"
+ *   node github-pr-create.mjs --userId "user123" --repo "owner/repo" --title "PR Title" --head "feature" --base "main" --body "Description" --draft
+ */
+
+import { parseArgs } from 'node:util';
+
+const API_URL = process.env.API_URL || 'http://localhost:8080';
+const INTERNAL_API_KEY = process.env.INTERNAL_API_KEY || '';
+
+async function main() {
+  const { values } = parseArgs({
+    options: {
+      userId: { type: 'string' },
+      repo: { type: 'string' },
+      title: { type: 'string' },
+      head: { type: 'string' },
+      base: { type: 'string' },
+      body: { type: 'string' },
+      draft: { type: 'boolean', default: false },
+    },
+  });
+
+  const { userId, repo, title, head, base, body, draft } = values;
+
+  if (!userId || !repo || !title || !head || !base) {
+    console.error(JSON.stringify({
+      error: 'userId, repo, title, head, and base are required',
+      usage: 'node github-pr-create.mjs --userId "user123" --repo "owner/repo" --title "Title" --head "feature" --base "main" [--body "Description"] [--draft]',
+    }));
+    process.exit(1);
+  }
+
+  try {
+    const [owner, repoName] = repo.split('/');
+
+    if (!owner || !repoName) {
+      throw new Error('Invalid repo format. Expected: owner/repo');
+    }
+
+    const response = await fetch(`${API_URL}/api/github/repos/${owner}/${repoName}/pulls`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'X-User-Id': userId,
+        'X-Internal-Key': INTERNAL_API_KEY,
+      },
+      body: JSON.stringify({ title, head, base, body: body || '', draft }),
+    });
+
+    const data = await response.json();
+
+    if (!data.success) {
+      throw new Error(data.error || data.message || 'Failed to create pull request');
+    }
+
+    console.log(JSON.stringify({
+      success: true,
+      number: data.data?.number,
+      title: data.data?.title,
+      htmlUrl: data.data?.htmlUrl,
+      head: data.data?.head,
+      base: data.data?.base,
+      message: data.message || `Pull request #${data.data?.number} created successfully`,
+    }, null, 2));
+
+  } catch (error) {
+    console.error(JSON.stringify({
+      success: false,
+      error: error.message,
+    }));
+    process.exit(1);
+  }
+}
+
+main();

package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-pr-list.mjs

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+/**
+ * GitHub List Pull Requests Script
+ * 列出 Pull Requests
+ *
+ * Usage:
+ *   node github-pr-list.mjs --userId "user123" --repo "owner/repo"
+ *   node github-pr-list.mjs --userId "user123" --repo "owner/repo" --state all
+ */
+
+import { parseArgs } from 'node:util';
+
+const API_URL = process.env.API_URL || 'http://localhost:8080';
+const INTERNAL_API_KEY = process.env.INTERNAL_API_KEY || '';
+
+async function main() {
+  const { values } = parseArgs({
+    options: {
+      userId: { type: 'string' },
+      repo: { type: 'string' },
+      state: { type: 'string', default: 'open' }, // open, closed, all
+    },
+  });
+
+  const { userId, repo, state } = values;
+
+  if (!userId || !repo) {
+    console.error(JSON.stringify({
+      error: 'userId and repo are required',
+      usage: 'node github-pr-list.mjs --userId "user123" --repo "owner/repo" [--state open|closed|all]',
+    }));
+    process.exit(1);
+  }
+
+  try {
+    const [owner, repoName] = repo.split('/');
+
+    if (!owner || !repoName) {
+      throw new Error('Invalid repo format. Expected: owner/repo');
+    }
+
+    const response = await fetch(`${API_URL}/api/github/repos/${owner}/${repoName}/pulls?state=${state}`, {
+      method: 'GET',
+      headers: {
+        'Content-Type': 'application/json',
+        'X-User-Id': userId,
+        'X-Internal-Key': INTERNAL_API_KEY,
+      },
+    });
+
+    const data = await response.json();
+
+    if (!data.success) {
+      throw new Error(data.error || data.message || 'Failed to list pull requests');
+    }
+
+    console.log(JSON.stringify({
+      success: true,
+      state,
+      pullRequests: data.data?.pullRequests || [],
+      totalCount: data.data?.pullRequests?.length || 0,
+      message: data.message,
+    }, null, 2));
+
+  } catch (error) {
+    console.error(JSON.stringify({
+      success: false,
+      error: error.message,
+    }));
+    process.exit(1);
+  }
+}
+
+main();

package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-pr-merge.mjs

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+/**
+ * GitHub Merge Pull Request Script
+ * 合併 Pull Request
+ *
+ * Usage:
+ *   node github-pr-merge.mjs --userId "user123" --repo "owner/repo" --number 123
+ *   node github-pr-merge.mjs --userId "user123" --repo "owner/repo" --number 123 --method squash
+ */
+
+import { parseArgs } from 'node:util';
+
+const API_URL = process.env.API_URL || 'http://localhost:8080';
+const INTERNAL_API_KEY = process.env.INTERNAL_API_KEY || '';
+
+async function main() {
+  const { values } = parseArgs({
+    options: {
+      userId: { type: 'string' },
+      repo: { type: 'string' },
+      number: { type: 'string' },
+      method: { type: 'string', default: 'merge' }, // merge, squash, rebase
+    },
+  });
+
+  const { userId, repo, number, method } = values;
+
+  if (!userId || !repo || !number) {
+    console.error(JSON.stringify({
+      error: 'userId, repo, and number are required',
+      usage: 'node github-pr-merge.mjs --userId "user123" --repo "owner/repo" --number 123 [--method merge|squash|rebase]',
+    }));
+    process.exit(1);
+  }
+
+  if (!['merge', 'squash', 'rebase'].includes(method)) {
+    console.error(JSON.stringify({
+      error: `Invalid merge method: ${method}. Must be one of: merge, squash, rebase`,
+    }));
+    process.exit(1);
+  }
+
+  try {
+    const [owner, repoName] = repo.split('/');
+
+    if (!owner || !repoName) {
+      throw new Error('Invalid repo format. Expected: owner/repo');
+    }
+
+    const response = await fetch(`${API_URL}/api/github/repos/${owner}/${repoName}/pulls/${number}/merge`, {
+      method: 'PUT',
+      headers: {
+        'Content-Type': 'application/json',
+        'X-User-Id': userId,
+        'X-Internal-Key': INTERNAL_API_KEY,
+      },
+      body: JSON.stringify({ mergeMethod: method }),
+    });
+
+    const data = await response.json();
+
+    if (!data.success) {
+      throw new Error(data.error || data.message || 'Failed to merge pull request');
+    }
+
+    console.log(JSON.stringify({
+      success: true,
+      pullNumber: parseInt(number, 10),
+      mergeMethod: method,
+      sha: data.data?.sha,
+      message: data.message || `Pull request #${number} merged successfully`,
+    }, null, 2));
+
+  } catch (error) {
+    console.error(JSON.stringify({
+      success: false,
+      error: error.message,
+    }));
+    process.exit(1);
+  }
+}
+
+main();

package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-pr-view.mjs

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+/**
+ * GitHub View Pull Request Script
+ * 查看特定 Pull Request 詳情
+ *
+ * Usage:
+ *   node github-pr-view.mjs --userId "user123" --repo "owner/repo" --number 123
+ */
+
+import { parseArgs } from 'node:util';
+
+const API_URL = process.env.API_URL || 'http://localhost:8080';
+const INTERNAL_API_KEY = process.env.INTERNAL_API_KEY || '';
+
+async function main() {
+  const { values } = parseArgs({
+    options: {
+      userId: { type: 'string' },
+      repo: { type: 'string' },
+      number: { type: 'string' },
+    },
+  });
+
+  const { userId, repo, number } = values;
+
+  if (!userId || !repo || !number) {
+    console.error(JSON.stringify({
+      error: 'userId, repo, and number are required',
+      usage: 'node github-pr-view.mjs --userId "user123" --repo "owner/repo" --number 123',
+    }));
+    process.exit(1);
+  }
+
+  try {
+    const [owner, repoName] = repo.split('/');
+
+    if (!owner || !repoName) {
+      throw new Error('Invalid repo format. Expected: owner/repo');
+    }
+
+    const response = await fetch(`${API_URL}/api/github/repos/${owner}/${repoName}/pulls/${number}`, {
+      method: 'GET',
+      headers: {
+        'Content-Type': 'application/json',
+        'X-User-Id': userId,
+        'X-Internal-Key': INTERNAL_API_KEY,
+      },
+    });
+
+    const data = await response.json();
+
+    if (!data.success) {
+      throw new Error(data.error || data.message || 'Failed to get pull request');
+    }
+
+    console.log(JSON.stringify({
+      success: true,
+      ...data.data,
+      message: data.message,
+    }, null, 2));
+
+  } catch (error) {
+    console.error(JSON.stringify({
+      success: false,
+      error: error.message,
+    }));
+    process.exit(1);
+  }
+}
+
+main();

package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-push.mjs

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+/**
+ * GitHub Push Script
+ * 推送本地變更到遠端 Repository
+ *
+ * Usage:
+ *   node github-push.mjs --userId "user123" --repo "owner/repo"
+ */
+
+import { parseArgs } from 'node:util';
+
+const API_URL = process.env.API_URL || 'http://localhost:8080';
+const INTERNAL_API_KEY = process.env.INTERNAL_API_KEY || '';
+
+async function main() {
+  const { values } = parseArgs({
+    options: {
+      userId: { type: 'string' },
+      repo: { type: 'string' },
+    },
+  });
+
+  const { userId, repo } = values;
+
+  if (!userId || !repo) {
+    console.error(JSON.stringify({
+      error: 'userId and repo are required',
+      usage: 'node github-push.mjs --userId "user123" --repo "owner/repo"',
+    }));
+    process.exit(1);
+  }
+
+  try {
+    const [owner, repoName] = repo.split('/');
+
+    if (!owner || !repoName) {
+      throw new Error('Invalid repo format. Expected: owner/repo');
+    }
+
+    // 呼叫 API 推送變更（使用內部認證機制）
+    const response = await fetch(`${API_URL}/api/github/repos/${owner}/${repoName}/push`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'X-User-Id': userId,
+        'X-Internal-Key': INTERNAL_API_KEY,
+      },
+    });
+
+    const data = await response.json();
+
+    if (!data.success) {
+      throw new Error(data.error || data.message || 'Failed to push');
+    }
+
+    console.log(JSON.stringify({
+      success: true,
+      branch: data.data?.branch,
+      message: data.message || `Successfully pushed to ${repo}`,
+    }, null, 2));
+
+  } catch (error) {
+    console.error(JSON.stringify({
+      success: false,
+      error: error.message,
+    }));
+    process.exit(1);
+  }
+}
+
+main();

package/botrun-c/.claude/skills/GitHub/346/212/200/350/203/275/scripts/github-read.mjs

@@ -0,0 +1,277 @@
+#!/usr/bin/env node
+/**
+ * GitHub Read Script
+ * 安全地讀取 GitHub Repository 中的檔案
+ *
+ * 安全設計：
+ * - 僅允許存取 /tmp/{userId}/github/ 目錄（本地 SSD）
+ * - 禁止路徑遍歷攻擊 (../)
+ * - 限制檔案大小避免記憶體問題
+ *
+ * 路徑格式：/tmp/{userId}/github/{owner}/{repo}/
+ *
+ * Usage:
+ *   # 讀取完整檔案
+ *   node github-read.mjs --userId "user123" --repo "owner/repo" --file "README.md"
+ *
+ *   # 讀取特定行範圍
+ *   node github-read.mjs --userId "user123" --repo "owner/repo" --file "src/index.ts" --start 10 --end 50
+ *
+ *   # 使用完整路徑（repo 內的相對路徑）
+ *   node github-read.mjs --userId "user123" --repo "owner/repo" --file "docs/guide/getting-started.md"
+ *
+ *   # 輸出格式：json（預設）或 raw
+ *   node github-read.mjs --userId "user123" --repo "owner/repo" --file "README.md" --format raw
+ */
+
+import { parseArgs } from 'node:util';
+import { readFile, stat } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, relative, normalize, extname } from 'node:path';
+import { getGitHubBasePath, getRepoPath, resolveFilePath, validateUserId } from './lib/path-validator.mjs';
+
+const MAX_FILE_SIZE = 10 * 1024 * 1024; // 10MB
+const MAX_LINES = 5000; // 最大行數
+
+/**
+ * 驗證路徑安全性，防止路徑遍歷攻擊
+ * 路徑格式：/tmp/{userId}/github/{owner}/{repo}/
+ */
+function validateAndResolvePath(userId, repoName, filePath) {
+  // 使用共用的路徑驗證工具
+  const { repoPath, fullPath, relativePath } = resolveFilePath(userId, repoName, filePath);
+  return { baseDir: repoPath, fullPath, relativePath };
+}
+
+/**
+ * 判斷檔案類型
+ */
+function getFileType(filename) {
+  const ext = extname(filename).toLowerCase();
+
+  const types = {
+    // 程式碼
+    '.js': 'javascript', '.mjs': 'javascript', '.cjs': 'javascript',
+    '.ts': 'typescript', '.tsx': 'typescript', '.jsx': 'javascript',
+    '.py': 'python', '.rb': 'ruby', '.go': 'go', '.java': 'java',
+    '.c': 'c', '.cpp': 'cpp', '.h': 'c', '.hpp': 'cpp',
+    '.rs': 'rust', '.swift': 'swift', '.kt': 'kotlin',
+
+    // Web
+    '.html': 'html', '.htm': 'html', '.css': 'css',
+    '.scss': 'scss', '.sass': 'sass', '.less': 'less',
+    '.vue': 'vue', '.svelte': 'svelte',
+
+    // 資料
+    '.json': 'json', '.yaml': 'yaml', '.yml': 'yaml',
+    '.xml': 'xml', '.csv': 'csv', '.tsv': 'tsv',
+
+    // 文件
+    '.md': 'markdown', '.txt': 'text', '.rst': 'rst',
+
+    // Shell
+    '.sh': 'bash', '.bash': 'bash', '.zsh': 'zsh',
+
+    // 其他
+    '.sql': 'sql', '.graphql': 'graphql', '.gql': 'graphql',
+    '.env': 'dotenv', '.ini': 'ini', '.conf': 'config',
+  };
+
+  return types[ext] || 'text';
+}
+
+/**
+ * 取得所有本地 repos
+ * 路徑格式：/tmp/{userId}/github/{owner}/{repo}/
+ */
+async function getLocalRepos(userId) {
+  const repoDir = getGitHubBasePath(userId);
+  const repos = [];
+
+  if (!existsSync(repoDir)) {
+    return repos;
+  }
+
+  const { readdir } = await import('node:fs/promises');
+
+  // 第一層：owners
+  const ownerEntries = await readdir(repoDir, { withFileTypes: true });
+
+  for (const ownerEntry of ownerEntries) {
+    if (!ownerEntry.isDirectory()) continue;
+
+    const ownerPath = join(repoDir, ownerEntry.name);
+
+    // 第二層：repos
+    const repoEntries = await readdir(ownerPath, { withFileTypes: true });
+
+    for (const repoEntry of repoEntries) {
+      if (!repoEntry.isDirectory()) continue;
+
+      const repoPath = join(ownerPath, repoEntry.name);
+      const gitPath = join(repoPath, '.git');
+
+      if (existsSync(gitPath)) {
+        const repoFullName = `${ownerEntry.name}/${repoEntry.name}`;
+        repos.push({
+          repoFullName,
+          localPath: repoPath,
+          owner: ownerEntry.name,
+          name: repoEntry.name,
+        });
+      }
+    }
+  }
+
+  return repos;
+}
+
+async function main() {
+  const { values } = parseArgs({
+    options: {
+      userId: { type: 'string' },
+      repo: { type: 'string' },
+      file: { type: 'string' },
+      start: { type: 'string' },
+      end: { type: 'string' },
+      format: { type: 'string', default: 'json' }, // json | raw
+    },
+  });
+
+  const { userId, repo, file, start, end, format } = values;
+
+  // 驗證必要參數
+  if (!userId) {
+    console.log(JSON.stringify({ success: false, error: 'userId is required' }));
+    process.exit(1);
+  }
+
+  if (!repo) {
+    // 如果沒有指定 repo，列出可用的 repos
+    const repos = await getLocalRepos(userId);
+    console.log(JSON.stringify({
+      success: false,
+      error: 'repo is required',
+      availableRepos: repos.map(r => r.repoFullName),
+      usage: 'node github-read.mjs --userId "..." --repo "owner/repo" --file "path/to/file"',
+    }));
+    process.exit(1);
+  }
+
+  if (!file) {
+    console.log(JSON.stringify({
+      success: false,
+      error: 'file is required',
+      usage: 'node github-read.mjs --userId "..." --repo "owner/repo" --file "path/to/file"',
+    }));
+    process.exit(1);
+  }
+
+  try {
+    // 驗證並解析路徑
+    const { baseDir, fullPath, relativePath } = validateAndResolvePath(userId, repo, file);
+
+    // 檢查 repo 是否存在
+    if (!existsSync(baseDir)) {
+      const repos = await getLocalRepos(userId);
+      console.log(JSON.stringify({
+        success: false,
+        error: `Repository "${repo}" not found`,
+        availableRepos: repos.map(r => r.repoFullName),
+      }));
+      process.exit(1);
+    }
+
+    // 檢查檔案是否存在
+    if (!existsSync(fullPath)) {
+      console.log(JSON.stringify({
+        success: false,
+        error: `File "${file}" not found in repository "${repo}"`,
+        searchedPath: relativePath,
+      }));
+      process.exit(1);
+    }
+
+    // 檢查檔案大小
+    const stats = await stat(fullPath);
+
+    if (stats.isDirectory()) {
+      console.log(JSON.stringify({
+        success: false,
+        error: `"${file}" is a directory, not a file`,
+        hint: 'Use github-list-tree.mjs to list directory contents',
+      }));
+      process.exit(1);
+    }
+
+    if (stats.size > MAX_FILE_SIZE) {
+      console.log(JSON.stringify({
+        success: false,
+        error: `File too large (${(stats.size / 1024 / 1024).toFixed(1)}MB). Maximum: ${MAX_FILE_SIZE / 1024 / 1024}MB`,
+        hint: 'Use --start and --end to read specific lines',
+      }));
+      process.exit(1);
+    }
+
+    // 讀取檔案
+    const content = await readFile(fullPath, 'utf-8');
+    const lines = content.split('\n');
+    const totalLines = lines.length;
+
+    // 處理行範圍
+    let startLine = start ? parseInt(start, 10) : 1;
+    let endLine = end ? parseInt(end, 10) : totalLines;
+
+    // 邊界檢查
+    startLine = Math.max(1, Math.min(startLine, totalLines));
+    endLine = Math.max(startLine, Math.min(endLine, totalLines));
+
+    // 限制最大行數
+    if (endLine - startLine + 1 > MAX_LINES) {
+      endLine = startLine + MAX_LINES - 1;
+    }
+
+    // 擷取指定範圍
+    const selectedLines = lines.slice(startLine - 1, endLine);
+    const selectedContent = selectedLines.join('\n');
+
+    // 輸出結果
+    if (format === 'raw') {
+      // 純文字輸出（方便直接使用）
+      console.log(selectedContent);
+    } else {
+      // JSON 輸出（包含 metadata）
+      console.log(JSON.stringify({
+        success: true,
+        repo,
+        file: relativePath,
+        fullPath,
+        fileType: getFileType(file),
+        fileSize: stats.size,
+        fileSizeHuman: stats.size < 1024
+          ? `${stats.size}B`
+          : stats.size < 1024 * 1024
+            ? `${(stats.size / 1024).toFixed(1)}KB`
+            : `${(stats.size / 1024 / 1024).toFixed(1)}MB`,
+        totalLines,
+        startLine,
+        endLine,
+        linesReturned: selectedLines.length,
+        modifiedAt: stats.mtime.toISOString(),
+        content: selectedContent,
+        // 標示是否有更多內容
+        hasMoreBefore: startLine > 1,
+        hasMoreAfter: endLine < totalLines,
+      }, null, 2));
+    }
+
+  } catch (error) {
+    console.log(JSON.stringify({
+      success: false,
+      error: error.message,
+    }));
+    process.exit(1);
+  }
+}
+
+main();