botrun-horse 2.29.2 → 2.30.0

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

@@ -0,0 +1,370 @@
+#!/usr/bin/env node
+/**
+ * GitHub Search Script (v2 - Pure Node.js)
+ * 在使用者已連結的 GitHub Repositories 中搜尋內容
+ *
+ * 重要改進：
+ * - 純 Node.js 實作，穩定高效
+ * - 支援上下文顯示（類似 rg -C）
+ * - 使用 /tmp 本地 SSD，速度極快
+ *
+ * 安全設計：
+ * - 僅允許存取 /tmp/{userId}/github/ 目錄
+ * - 禁止路徑遍歷攻擊 (../)
+ * - 限制結果數量避免記憶體爆炸
+ *
+ * 路徑格式：/tmp/{userId}/github/{owner}/{repo}/
+ *
+ * Usage:
+ *   # 基本搜尋
+ *   node github-search.mjs --userId "user123" --query "會議"
+ *
+ *   # 搜尋特定 repo
+ *   node github-search.mjs --userId "user123" --query "會議" --repo "owner/repo"
+ *
+ *   # 只搜尋特定檔案類型
+ *   node github-search.mjs --userId "user123" --query "API" --glob "*.md"
+ *
+ *   # 顯示上下文（類似 rg -C 3）
+ *   node github-search.mjs --userId "user123" --query "會議" --context 3
+ *
+ *   # 不區分大小寫（預設）
+ *   node github-search.mjs --userId "user123" --query "api" --ignoreCase
+ */
+
+import { parseArgs } from 'node:util';
+import { readdir, stat, readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, relative, extname } from 'node:path';
+import { getGitHubBasePath, validateUserId } from './lib/path-validator.mjs';
+
+const MAX_RESULTS = 100;        // 最大結果數
+const MAX_FILE_SIZE = 5 * 1024 * 1024;  // 5MB，超過則跳過
+const MAX_CONTENT_LENGTH = 300; // 單行內容最大顯示長度
+
+/**
+ * 檢查檔案是否符合 glob pattern
+ */
+function matchGlob(filename, pattern) {
+  if (!pattern) return true;
+
+  // 支援多個 pattern（逗號分隔）
+  const patterns = pattern.split(',').map(p => p.trim());
+
+  for (const p of patterns) {
+    // *.md, *.js, etc.
+    if (p.startsWith('*.')) {
+      const ext = p.slice(1);
+      if (filename.endsWith(ext)) return true;
+    }
+    // 包含匹配
+    else if (filename.includes(p)) {
+      return true;
+    }
+  }
+
+  return patterns.length === 0;
+}
+
+/**
+ * 判斷是否為文字檔（可搜尋）
+ */
+function isTextFile(filename) {
+  const textExtensions = [
+    '.md', '.txt', '.json', '.yaml', '.yml', '.xml', '.html', '.htm',
+    '.js', '.mjs', '.cjs', '.ts', '.tsx', '.jsx',
+    '.py', '.rb', '.go', '.java', '.c', '.cpp', '.h', '.hpp',
+    '.sh', '.bash', '.zsh', '.fish',
+    '.css', '.scss', '.less', '.sass',
+    '.sql', '.graphql', '.gql',
+    '.env', '.ini', '.conf', '.config', '.cfg',
+    '.gitignore', '.dockerignore', '.eslintrc', '.prettierrc',
+    '.vue', '.svelte', '.astro',
+    '.rst', '.adoc', '.org',
+    '.csv', '.tsv', '.log',
+  ];
+
+  const ext = extname(filename).toLowerCase();
+  const base = filename.toLowerCase();
+
+  // 檢查副檔名
+  if (textExtensions.includes(ext)) return true;
+
+  // 無副檔名但可能是文字檔
+  const textFilenames = ['readme', 'license', 'changelog', 'authors', 'contributing', 'makefile', 'dockerfile', 'vagrantfile'];
+  if (textFilenames.some(name => base.includes(name))) return true;
+
+  return false;
+}
+
+/**
+ * 在檔案內容中搜尋
+ */
+function searchInContent(content, query, options = {}) {
+  const { ignoreCase = true, context = 0 } = options;
+  const lines = content.split('\n');
+  const matches = [];
+
+  const searchQuery = ignoreCase ? query.toLowerCase() : query;
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const searchLine = ignoreCase ? line.toLowerCase() : line;
+
+    if (searchLine.includes(searchQuery)) {
+      // 計算上下文範圍
+      const startLine = Math.max(0, i - context);
+      const endLine = Math.min(lines.length - 1, i + context);
+
+      // 收集上下文
+      const contextLines = [];
+      for (let j = startLine; j <= endLine; j++) {
+        contextLines.push({
+          lineNumber: j + 1,
+          content: lines[j].substring(0, MAX_CONTENT_LENGTH),
+          isMatch: j === i,
+        });
+      }
+
+      matches.push({
+        line: i + 1,
+        content: line.trim().substring(0, MAX_CONTENT_LENGTH),
+        context: context > 0 ? contextLines : undefined,
+      });
+    }
+  }
+
+  return matches;
+}
+
+/**
+ * 遞迴搜尋目錄
+ */
+async function searchDirectory(dirPath, baseDir, query, options = {}) {
+  const { glob, ignoreCase = true, context = 0, maxResults = MAX_RESULTS } = options;
+  const results = [];
+  let totalScanned = 0;
+
+  async function scan(currentDir, depth = 0) {
+    if (results.length >= maxResults || depth > 10) return;
+
+    try {
+      const entries = await readdir(currentDir, { withFileTypes: true });
+
+      for (const entry of entries) {
+        if (results.length >= maxResults) break;
+
+        // 跳過隱藏檔案和 node_modules
+        if (entry.name.startsWith('.') || entry.name === 'node_modules') {
+          continue;
+        }
+
+        const fullPath = join(currentDir, entry.name);
+
+        if (entry.isDirectory()) {
+          await scan(fullPath, depth + 1);
+        } else if (entry.isFile()) {
+          // 檢查 glob 匹配
+          if (!matchGlob(entry.name, glob)) continue;
+
+          // 檢查是否為文字檔
+          if (!isTextFile(entry.name)) continue;
+
+          try {
+            // 檢查檔案大小
+            const stats = await stat(fullPath);
+            if (stats.size > MAX_FILE_SIZE) continue;
+
+            totalScanned++;
+
+            // 讀取並搜尋
+            const content = await readFile(fullPath, 'utf-8');
+            const matches = searchInContent(content, query, { ignoreCase, context });
+
+            if (matches.length > 0) {
+              const relativePath = relative(baseDir, fullPath);
+              results.push({
+                file: relativePath,
+                matches: matches.slice(0, 10), // 每個檔案最多 10 筆
+                matchCount: matches.length,
+                fileSize: stats.size,
+              });
+            }
+          } catch (readError) {
+            // 無法讀取檔案（可能是二進位或編碼問題），跳過
+          }
+        }
+      }
+    } catch (dirError) {
+      // 無法讀取目錄，跳過
+    }
+  }
+
+  await scan(dirPath);
+
+  return { results, totalScanned };
+}
+
+/**
+ * 取得所有本地 repos
+ * 路徑格式：/tmp/{userId}/github/{owner}/{repo}/
+ */
+async function getLocalRepos(userId) {
+  const repoDir = getGitHubBasePath(userId);
+  const repos = [];
+
+  if (!existsSync(repoDir)) {
+    return repos;
+  }
+
+  // 第一層：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,
+          owner: ownerEntry.name,
+          name: repoEntry.name,
+          localPath: repoPath,
+        });
+      }
+    }
+  }
+
+  return repos;
+}
+
+async function main() {
+  const { values } = parseArgs({
+    options: {
+      userId: { type: 'string' },
+      query: { type: 'string' },
+      repo: { type: 'string' },
+      glob: { type: 'string' },
+      context: { type: 'string' },
+      ignoreCase: { type: 'boolean', default: true },
+    },
+  });
+
+  const { userId, query, repo, glob, context, ignoreCase = true } = values;
+
+  if (!userId) {
+    console.log(JSON.stringify({ success: false, error: 'userId is required' }));
+    process.exit(1);
+  }
+
+  if (!query) {
+    console.log(JSON.stringify({ success: false, error: 'query is required' }));
+    process.exit(1);
+  }
+
+  // 驗證 userId 格式
+  if (!/^[a-zA-Z0-9_-]+$/.test(userId)) {
+    console.log(JSON.stringify({ success: false, error: 'Invalid userId format' }));
+    process.exit(1);
+  }
+
+  const contextLines = context ? parseInt(context, 10) : 0;
+
+  try {
+    const repos = await getLocalRepos(userId);
+
+    if (repos.length === 0) {
+      console.log(JSON.stringify({
+        success: false,
+        error: 'No GitHub repositories found',
+        message: '尚未 clone 任何 GitHub Repository。請先使用 github-clone.mjs 來 clone。',
+      }));
+      return;
+    }
+
+    // 篩選指定的 repo
+    let targetRepos = repos;
+    if (repo) {
+      targetRepos = repos.filter(r =>
+        r.repoFullName === repo ||
+        r.repoFullName.toLowerCase().includes(repo.toLowerCase()) ||
+        r.name.toLowerCase().includes(repo.toLowerCase())
+      );
+
+      if (targetRepos.length === 0) {
+        console.log(JSON.stringify({
+          success: false,
+          error: `Repository "${repo}" not found`,
+          availableRepos: repos.map(r => r.repoFullName),
+        }));
+        return;
+      }
+    }
+
+    // 搜尋每個 repo
+    const allResults = [];
+    let totalMatches = 0;
+    let totalFilesScanned = 0;
+
+    for (const targetRepo of targetRepos) {
+      const { results, totalScanned } = await searchDirectory(
+        targetRepo.localPath,
+        targetRepo.localPath,
+        query,
+        { glob, ignoreCase, context: contextLines }
+      );
+
+      totalFilesScanned += totalScanned;
+
+      if (results.length > 0) {
+        const repoMatches = results.reduce((sum, r) => sum + r.matchCount, 0);
+        totalMatches += repoMatches;
+
+        allResults.push({
+          repo: targetRepo.repoFullName,
+          localPath: targetRepo.localPath,
+          fileCount: results.length,
+          matchCount: repoMatches,
+          files: results,
+        });
+      }
+    }
+
+    // 輸出結果
+    console.log(JSON.stringify({
+      success: true,
+      query,
+      glob: glob || null,
+      context: contextLines,
+      ignoreCase,
+      searchedRepos: targetRepos.map(r => r.repoFullName),
+      totalFilesScanned,
+      totalMatches,
+      totalFilesWithMatches: allResults.reduce((sum, r) => sum + r.fileCount, 0),
+      results: allResults,
+      message: totalMatches > 0
+        ? `在 ${allResults.length} 個 Repository 中找到 ${totalMatches} 筆結果（掃描 ${totalFilesScanned} 個檔案）`
+        : `在 ${targetRepos.length} 個 Repository 中未找到符合 "${query}" 的內容（掃描 ${totalFilesScanned} 個檔案）`,
+    }, null, 2));
+
+  } catch (error) {
+    console.log(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-stash.mjs

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+/**
+ * GitHub Stash Script
+ * 暫存或還原變更
+ *
+ * Usage:
+ *   node github-stash.mjs --userId "user123" --repo "owner/repo" --action save
+ *   node github-stash.mjs --userId "user123" --repo "owner/repo" --action save --message "WIP: feature"
+ *   node github-stash.mjs --userId "user123" --repo "owner/repo" --action pop
+ *   node github-stash.mjs --userId "user123" --repo "owner/repo" --action list
+ */
+
+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' },
+      action: { type: 'string' }, // save, pop, list
+      message: { type: 'string' }, // Optional: stash message
+    },
+  });
+
+  const { userId, repo, action, message } = values;
+
+  if (!userId || !repo || !action) {
+    console.error(JSON.stringify({
+      error: 'userId, repo, and action are required',
+      usage: 'node github-stash.mjs --userId "user123" --repo "owner/repo" --action <save|pop|list> [--message "msg"]',
+      actions: {
+        save: 'Stash current changes',
+        pop: 'Apply and remove the latest stash',
+        list: 'List all stashes',
+      },
+    }));
+    process.exit(1);
+  }
+
+  if (!['save', 'pop', 'list'].includes(action)) {
+    console.error(JSON.stringify({
+      error: `Invalid action: ${action}. Must be one of: save, pop, list`,
+    }));
+    process.exit(1);
+  }
+
+  try {
+    const [owner, repoName] = repo.split('/');
+
+    if (!owner || !repoName) {
+      throw new Error('Invalid repo format. Expected: owner/repo');
+    }
+
+    let url = `${API_URL}/api/github/repos/${owner}/${repoName}/stash`;
+    let method = 'GET';
+    let body = undefined;
+
+    switch (action) {
+      case 'save':
+        method = 'POST';
+        body = JSON.stringify({ message });
+        break;
+      case 'pop':
+        url += '/pop';
+        method = 'POST';
+        break;
+      case 'list':
+        method = 'GET';
+        break;
+    }
+
+    const response = await fetch(url, {
+      method,
+      headers: {
+        'Content-Type': 'application/json',
+        'X-User-Id': userId,
+        'X-Internal-Key': INTERNAL_API_KEY,
+      },
+      ...(body && { body }),
+    });
+
+    const data = await response.json();
+
+    if (!data.success) {
+      throw new Error(data.error || data.message || `Failed to ${action} stash`);
+    }
+
+    // Format output based on action
+    if (action === 'list') {
+      console.log(JSON.stringify({
+        success: true,
+        stashes: data.data?.stashes || [],
+        totalCount: data.data?.stashes?.length || 0,
+        message: data.message,
+      }, null, 2));
+    } else {
+      console.log(JSON.stringify({
+        success: true,
+        action,
+        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-sync.mjs

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+/**
+ * GitHub Sync Script
+ * 同步（Pull）一個 Repository 的最新變更
+ *
+ * Usage:
+ *   node github-sync.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-sync.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 執行 Sync（使用內部認證機制）
+    const response = await fetch(`${API_URL}/api/github/repos/${owner}/${repoName}/sync`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'X-User-Id': userId,
+        'X-Internal-Key': INTERNAL_API_KEY,
+      },
+    });
+
+    const data = await response.json();
+
+    if (!response.ok || !data.success) {
+      throw new Error(data.error || data.message || 'Sync failed');
+    }
+
+    console.log(JSON.stringify({
+      success: true,
+      repo: data.repo,
+      message: data.message || `Successfully synced ${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-write.mjs

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+/**
+ * GitHub Write File Script
+ * 寫入/建立檔案到 Repository
+ *
+ * Usage:
+ *   node github-write.mjs --userId "user123" --repo "owner/repo" --file "path/to/file.txt" --content "file content"
+ */
+
+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' },
+      file: { type: 'string' },
+      content: { type: 'string' },
+    },
+  });
+
+  const { userId, repo, file, content } = values;
+
+  if (!userId || !repo || !file || content === undefined) {
+    console.error(JSON.stringify({
+      error: 'userId, repo, file, and content are required',
+      usage: 'node github-write.mjs --userId "user123" --repo "owner/repo" --file "path/to/file.txt" --content "content"',
+    }));
+    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}/files/${encodeURIComponent(file)}`, {
+      method: 'PUT',
+      headers: {
+        'Content-Type': 'application/json',
+        'X-User-Id': userId,
+        'X-Internal-Key': INTERNAL_API_KEY,
+      },
+      body: JSON.stringify({ content }),
+    });
+
+    const data = await response.json();
+
+    if (!data.success) {
+      throw new Error(data.error || data.message || 'Failed to write file');
+    }
+
+    console.log(JSON.stringify({
+      success: true,
+      filePath: data.filePath || file,
+      message: data.message || `File written successfully: ${file}`,
+    }, null, 2));
+
+  } catch (error) {
+    console.error(JSON.stringify({
+      success: false,
+      error: error.message,
+    }));
+    process.exit(1);
+  }
+}
+
+main();