glab-tool 1.0.4

package/.glabrc.example

@@ -0,0 +1,11 @@
+# GitLab configuration file
+# Place this file in your current working directory as .glabrc
+
+# GitLab API URL
+GITLAB_URL=https://gitlab.example.com/api/v4
+
+# GitLab Personal Access Token
+GITLAB_TOKEN=your_personal_access_token_here
+
+# Project ID or path
+PROJECT_ID=my-group/my-project

package/README.md

@@ -0,0 +1,193 @@
+# glab-tool - GitLab Extended CLI Tool
+
+一个多功能的 GitLab 命令行工具集。
+
+## 功能特性
+
+- **列出分支** - 显示项目所有分支及其详细信息（创建日期、作者、保护状态）
+- **智能清理** - 清理已合并或已关闭的合并请求对应的源分支
+- **交互式选择** - 使用 inquirer 进行交互式分支选择
+- **按状态分组** - 分支按 "已合并" 和 "已关闭" 分组展示
+- **干运行模式** - 预览将删除的分支而不实际执行
+- **强制删除** - 支持强制删除受保护分支
+- **通配符支持** - 目标分支支持通配符匹配（如 `release/*`）
+
+## 安装
+
+```bash
+npm install -g glab-tool
+```
+
+## 快速开始
+
+1. 创建配置文件 `.glabrc`：
+```ini
+gitlab_url=https://gitlab.example.com/api/v4
+gitlab_token=your_access_token
+project_id=your_project_id
+```
+
+2. 列出所有分支：
+```bash
+glabx list
+```
+
+3. 清理分支（交互式选择）：
+```bash
+glabx clean
+```
+
+## 使用说明
+
+### 全局选项
+
+- `--config <file>`: 配置文件路径（默认: `.glabrc`）
+
+### 命令
+
+#### `glabx list`
+
+列出 GitLab 项目的所有分支。
+
+```bash
+glabx list
+```
+
+输出示例：
+```
+Found 15 branches:
++-------------------+--------------+------------------+-----------+
+| Branch            | Created Date | Author           | Protected |
++-------------------+--------------+------------------+-----------+
+| main              | 2024-01-15   | John Doe         | Yes       |
+| feature/user-auth | 2024-02-20   | Jane Smith       | No        |
+| bugfix/login      | 2024-02-22   | Bob Wilson       | No        |
++-------------------+--------------+------------------+-----------+
+```
+
+#### `glabx clean`
+
+清理目标分支的已合并/已关闭合并请求对应的源分支。
+
+```bash
+glabx clean [options]
+```
+
+**选项**:
+- `--target <branch>`: 目标分支（默认: `main`），支持通配符如 `release/*`
+- `--force`: 强制删除受保护分支
+- `-d, --dry-run`: 预览模式，显示将删除的分支但不实际删除
+
+**使用示例**:
+
+```bash
+# 清理 targeting main 分支的分支
+glabx clean --target main
+
+# 预览将删除的分支
+glabx clean --target main --dry-run
+
+# 强制删除（包括受保护分支）
+glabx clean --target main --force
+
+# 使用通配符匹配多个目标分支
+glabx clean --target release/*
+
+# 交互式选择（无参数）
+glabx clean
+```
+
+## 配置
+
+支持三种配置方式（优先级从高到低）:
+
+### 1. 配置文件 `.glabrc`
+
+```ini
+# GitLab API 地址
+gitlab_url=https://gitlab.example.com/api/v4
+
+# GitLab 访问令牌
+gitlab_token=glpat-xxxxxxxxxxxx
+
+# 项目 ID 或路径（如 group/project）
+project_id=123
+```
+
+### 2. 环境变量
+
+```bash
+export GITLAB_URL=https://gitlab.example.com/api/v4
+export GITLAB_TOKEN=glpat-xxxxxxxxxxxx
+export PROJECT_ID=123
+```
+
+### 3. 命令行参数
+
+（当前版本通过配置文件或环境变量配置）
+
+## 技术栈
+
+- **Node.js** >= 18.0.0
+- **Commander** ^13.1.0 - CLI 命令解析
+- **Axios** ^1.6.0 - GitLab API 客户端
+- **Inquirer** ^9.2.12 - 交互式提示
+
+## 项目结构
+
+```
+git-clean/
+├── index.js              # 主入口，CLI 命令定义
+├── package.json
+├── src/
+│   ├── list.js           # 列出分支功能
+│   └── cleanup.js        # 清理分支功能
+└── README.md
+```
+
+## 架构说明
+
+```
+CLI 层 (index.js)
+    ↓
+业务层 (list.js / cleanup.js)
+    ↓
+工具层 (配置读取、API 调用)
+    ↓
+外部层 (GitLab API、配置文件)
+```
+
+## 数据流向
+
+### 列出分支流程
+1. 读取配置（文件 → 环境变量）
+2. 创建 GitLab API 客户端
+3. 分页获取所有分支
+4. 对每个分支获取最后提交信息
+5. 格式化输出表格
+
+### 清理分支流程
+1. 读取配置
+2. 获取目标分支的已合并/已关闭 MR
+3. 获取当前存在的分支
+4. 过滤出可清理的分支
+5. 交互式选择 → 确认 → 删除
+
+## 开发
+
+```bash
+# 克隆项目
+git clone <repo>
+cd git-clean
+
+# 安装依赖
+npm install
+
+# 本地运行
+node index.js list
+node index.js clean
+```
+
+## 许可证
+
+MIT

package/index.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { cleanup } from './src/cleanup.js';
+import { list } from './src/list.js';
+
+const program = new Command();
+
+program
+  .name('glabx')
+  .description('A CLI tool to clean up invalid GitLab branches')
+  .version('1.0.0');
+
+// 添加 clean 命令
+program
+  .command('clean')
+  .description('Clean up GitLab branches from merge requests targeting main branch')
+  .option('--target <branch>', 'Target branch to filter merge requests (default: main)', 'main')
+  .option('--force', 'Force delete protected branches')
+  .option('-d, --dry-run', 'Show what would be deleted without actually deleting')
+  .action(async (options) => {
+    await cleanup(options);
+  });
+
+// 添加 list 命令
+program
+  .command('list')
+  .description('List all GitLab branches')
+  .action(async (options) => {
+    await list(options);
+  });
+
+// 解析命令行参数
+program.parse();
+
+// 如果没有提供任何命令，则显示帮助
+if (!process.argv.slice(2).length) {
+  program.help();
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "glab-tool",
+  "version": "1.0.4",
+  "description": "GitLab Extended CLI Tool - A multi-purpose GitLab utility CLI",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "glabx": "./index.js"
+  },
+  "files": [
+    "src/*",
+    ".glabrc.example",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node index.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "gitlab",
+    "branch",
+    "cleanup",
+    "cli"
+  ],
+  "author": "GitLab Branch Cleaner",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.0",
+    "commander": "^13.1.0",
+    "inquirer": "^9.2.12"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/cleanup.js

@@ -0,0 +1,445 @@
+import axios from 'axios';
+import fs from 'fs';
+import inquirer from 'inquirer';
+
+// 从配置文件读取配置
+function readConfig(configPath) {
+  const config = {};
+  
+  if (fs.existsSync(configPath)) {
+    try {
+      const configContent = fs.readFileSync(configPath, 'utf8');
+      const lines = configContent.split('\n');
+      
+      for (const line of lines) {
+        const trimmedLine = line.trim();
+        // 跳过空行和注释
+        if (!trimmedLine || trimmedLine.startsWith('#')) {
+          continue;
+        }
+        
+        // 解析键值对格式 (key=value)
+        const [key, value] = trimmedLine.split('=').map(part => part.trim());
+        if (key && value) {
+          config[key.toLowerCase()] = value;
+        }
+      }
+    } catch (error) {
+      console.warn('Warning: Could not read config file:', error.message);
+    }
+  }
+  
+  return config;
+}
+
+// 获取配置值
+function getConfigValue(config, key) {
+  // 优先级：配置文件 > 环境变量 > 默认值
+  return config[key] || 
+         process.env[key.toUpperCase()] ||
+         null;
+}
+
+// 获取指定目标分支的合并请求（获取已合并和已关闭的）
+async function getMergeRequestsByTargetBranch(apiClient, projectId, targetBranch) {
+  const mergeRequests = [];
+  let page = 1;
+  let hasNextPage = true;
+
+  try {
+    // 先获取已合并的
+    while (hasNextPage) {
+      const response = await apiClient.get(`/projects/${projectId}/merge_requests`, {
+        params: {
+          page: page,
+          per_page: 100,
+          state: 'merged',
+          target_branch: targetBranch 
+        }
+      });
+      
+      mergeRequests.push(...response.data);
+      
+      // 检查是否有下一页
+      const linkHeader = response.headers.link;
+      hasNextPage = linkHeader && linkHeader.includes('rel="next"');
+      page++;
+    }
+  } catch (error) {
+    console.error('Error fetching merged merge requests:', error);
+    throw error;
+  }
+  
+  // 重置页码获取已关闭的
+  page = 1;
+  hasNextPage = true;
+  
+  try {
+    while (hasNextPage) {
+      const response = await apiClient.get(`/projects/${projectId}/merge_requests`, {
+        params: {
+          page: page,
+          per_page: 100,
+          state: 'closed',
+          target_branch: targetBranch 
+        }
+      });
+      
+      mergeRequests.push(...response.data);
+      
+      // 检查是否有下一页
+      const linkHeader = response.headers.link;
+      hasNextPage = linkHeader && linkHeader.includes('rel="next"');
+      page++;
+    }
+  } catch (error) {
+    console.error('Error fetching closed merge requests:', error);
+    throw error;
+  }
+  
+  return mergeRequests;
+}
+
+// 检查分支名称是否匹配模式（支持通配符 *）
+function matchesPattern(branchName, pattern) {
+  if (!pattern.includes('*')) {
+    // 不包含通配符，直接比较
+    return branchName === pattern;
+  }
+  
+  // 将通配符转换为正则表达式
+  const escapedPattern = pattern.replace(/[.+?^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*');
+  const regex = new RegExp(`^${escapedPattern}$`);
+  return regex.test(branchName);
+}
+
+// 删除分支
+async function deleteBranch(apiClient, projectId, branchName, force = false) {
+  try {
+    const deleteUrl = `/projects/${projectId}/repository/branches/${encodeURIComponent(branchName)}`;
+    
+    // 如果是强制删除，需要使用不同的API端点
+    if (force) {
+      // 使用强制删除的API端点
+      await apiClient.delete(deleteUrl, {
+        params: {
+          force: true
+        }
+      });
+    } else {
+      // 正常删除
+      await apiClient.delete(deleteUrl);
+    }
+    
+    console.log(`Successfully deleted branch: ${branchName}`);
+    return true;
+  } catch (error) {
+    if (error.response?.status === 403) {
+      console.error(`Error: Cannot delete protected branch "${branchName}". Use --force to override.`);
+    } else if (error.response?.status === 404) {
+      console.error(`Error: Branch "${branchName}" not found.`);
+    } else {
+      console.error(`Error deleting branch "${branchName}":`, error.message);
+    }
+    return false;
+  }
+}
+
+// 获取项目中的所有分支名称
+async function getAllBranches(apiClient, projectId) {
+  const branches = [];
+  let page = 1;
+  let hasNextPage = true;
+
+  try {
+    while (hasNextPage) {
+      const response = await apiClient.get(`/projects/${projectId}/repository/branches`, {
+        params: {
+          page: page,
+          per_page: 100
+        }
+      });
+      
+      branches.push(...response.data.map(branch => branch.name));
+      
+      // 检查是否有下一页
+      const linkHeader = response.headers.link;
+      hasNextPage = linkHeader && linkHeader.includes('rel="next"');
+      page++;
+    }
+    
+    return branches;
+  } catch (error) {
+    console.error('Error fetching branches:', error);
+    return [];
+  }
+}
+
+// 清理分支
+async function cleanup(options) {
+  // 读取配置
+  const configPath = options.config || '.glabrc';
+  const config = readConfig(configPath);
+  
+  // 获取配置值
+  const gitlabUrl = getConfigValue(config, 'gitlab_url');
+  const token = getConfigValue(config, 'gitlab_token');
+  const projectId = getConfigValue(config, 'project_id');
+  
+  // 验证必需选项
+  if (!gitlabUrl) {
+    console.error('Error: GitLab API URL is required');
+    process.exit(1);
+  }
+
+  if (!token) {
+    console.error('Error: GitLab token is required');
+    process.exit(1);
+  }
+
+  if (!projectId) {
+    console.error('Error: Project ID or path is required');
+    process.exit(1);
+  }
+
+  // 构建 GitLab API 基础 URL
+  const gitlabBaseUrl = gitlabUrl.replace(/\/$/, ''); // 移除末尾的斜杠
+
+  // 创建 axios 实例
+  const apiClient = axios.create({
+    baseURL: gitlabBaseUrl,
+    headers: {
+      'PRIVATE-TOKEN': token,
+      'Content-Type': 'application/json'
+    }
+  });
+
+  // 对项目ID进行URL编码（如果包含特殊字符）
+  const encodedProjectId = encodeURIComponent(projectId);
+
+  // 获取指定目标分支的合并请求
+  try {
+    const targetBranch = options.target || 'main';
+    let targetMergeRequests = [];
+    
+    // 如果目标分支包含通配符，则获取所有合并请求并在客户端过滤
+    if (targetBranch.includes('*')) {
+      // 获取所有合并请求，不指定目标分支（包括已合并和已关闭的）
+      const allMergeRequests = [];
+      let page = 1;
+      let hasNextPage = true;
+
+      // 先获取已合并的
+      while (hasNextPage) {
+        const response = await apiClient.get(`/projects/${encodedProjectId}/merge_requests`, {
+          params: {
+            page: page,
+            per_page: 100,
+            state: 'merged'
+          }
+        });
+        
+        allMergeRequests.push(...response.data);
+        
+        // 检查是否有下一页
+        const linkHeader = response.headers.link;
+        hasNextPage = linkHeader && linkHeader.includes('rel="next"');
+        page++;
+      }
+      
+      // 重置页码获取已关闭的
+      page = 1;
+      hasNextPage = true;
+      
+      while (hasNextPage) {
+        const response = await apiClient.get(`/projects/${encodedProjectId}/merge_requests`, {
+          params: {
+            page: page,
+            per_page: 100,
+            state: 'closed'
+          }
+        });
+        
+        allMergeRequests.push(...response.data);
+        
+        // 检查是否有下一页
+        const linkHeader = response.headers.link;
+        hasNextPage = linkHeader && linkHeader.includes('rel="next"');
+        page++;
+      }
+      
+      // 根据目标分支模式过滤合并请求
+      targetMergeRequests = allMergeRequests.filter(mr => matchesPattern(mr.target_branch, targetBranch));
+    } else {
+      // 如果不包含通配符，使用原来的 API 查询方式
+      targetMergeRequests = await getMergeRequestsByTargetBranch(apiClient, encodedProjectId, targetBranch);
+    }
+    
+    if (targetMergeRequests.length === 0) {
+      console.log(`No merge requests targeting the "${targetBranch}" branch found.`);
+      return;
+    }
+    
+    // 获取项目中所有实际存在的分支
+    const allBranches = await getAllBranches(apiClient, encodedProjectId);
+    
+    // 过滤出实际存在的分支，并按状态分组
+    const mergedBranches = [];
+    const closedBranches = [];
+    
+    for (const mr of targetMergeRequests) {
+      if (allBranches.includes(mr.source_branch)) {
+        if (mr.state === 'merged') {
+          mergedBranches.push(mr);
+        } else if (mr.state === 'closed') {
+          closedBranches.push(mr);
+        }
+      }
+    }
+    
+    // 如果两个分组都为空
+    if (mergedBranches.length === 0 && closedBranches.length === 0) {
+      console.log(`No existing merge requests targeting the "${targetBranch}" branch found.`);
+      return;
+    }
+    
+    // 询问用户是否确认删除
+    if (options.dryRun) {
+      console.log('Dry run mode: No branches will be deleted.');
+      // 显示分组统计信息
+      if (mergedBranches.length > 0) {
+        console.log(`\nMerged branches (${mergedBranches.length}):`);
+        mergedBranches.forEach(mr => console.log(`  - MR !${mr.iid}: ${mr.source_branch}`));
+      }
+      if (closedBranches.length > 0) {
+        console.log(`\nClosed branches (${closedBranches.length}):`);
+        closedBranches.forEach(mr => console.log(`  - MR !${mr.iid}: ${mr.source_branch}`));
+      }
+      return;
+    }
+    
+    // 如果有 --force 参数，直接删除所有分支
+    if (options.force) {
+      console.log('Force mode enabled: Deleting all branches without confirmation...');
+      const allBranchesToDelete = [...mergedBranches, ...closedBranches];
+      for (const mr of allBranchesToDelete) {
+        await deleteBranch(apiClient, encodedProjectId, mr.source_branch, true);
+      }
+      return;
+    }
+    
+    // 创建选择项数组，按状态分组显示
+    const choices = [];
+    
+    // 添加已合并分组
+    if (mergedBranches.length > 0) {
+      choices.push(new inquirer.Separator(' 📦 Merged branches (' + mergedBranches.length + ')'));
+      mergedBranches.forEach((mr, index) => {
+        choices.push({
+          name: `${index + 1}. MR !${mr.iid}: ${mr.title} (${mr.source_branch})`,
+          value: {
+            id: index + 1,
+            mrId: mr.iid,
+            sourceBranch: mr.source_branch,
+            title: mr.title,
+            state: 'merged'
+          }
+        });
+      });
+    }
+    
+    // 添加已关闭分组
+    if (closedBranches.length > 0) {
+      choices.push(new inquirer.Separator(' ❌ Closed branches (' + closedBranches.length + ')'));
+      closedBranches.forEach((mr, index) => {
+        choices.push({
+          name: `${mergedBranches.length + index + 1}. MR !${mr.iid}: ${mr.title} (${mr.source_branch})`,
+          value: {
+            id: mergedBranches.length + index + 1,
+            mrId: mr.iid,
+            sourceBranch: mr.source_branch,
+            title: mr.title,
+            state: 'closed'
+          }
+        });
+      });
+    }
+    
+    // 使用 inquirer 进行交互式选择
+    const questions = [
+      {
+        type: 'checkbox',
+        name: 'selectedBranches',
+        message: 'Select branches to delete:',
+        choices: choices,
+        validate: function (answer) {
+          if (answer.length < 1) {
+            return 'You must select at least one branch.';
+          }
+          return true;
+        },
+        pageSize: 100, // 设置较大的值以显示更多选项
+        loop: false, // 禁止循环选择，防止从最后一个回到第一个
+        // 添加额外的安全配置
+        searchable: false
+      }
+    ];
+    
+    const answers = await inquirer.prompt(questions);
+    
+    // 获取用户选择的分支信息
+    const selectedBranches = answers.selectedBranches;
+    
+    if (selectedBranches.length === 0) {
+      console.log('No branches selected for deletion.');
+      return;
+    }
+    
+    // 显示用户选择的分支（按状态分组显示）
+    console.log('\nSelected branches to delete:');
+    
+    const selectedMerged = selectedBranches.filter(b => b.state === 'merged');
+    const selectedClosed = selectedBranches.filter(b => b.state === 'closed');
+    
+    if (selectedMerged.length > 0) {
+      console.log(`\n📦 Merged branches (${selectedMerged.length}):`);
+      selectedMerged.forEach(branch => {
+        console.log(`  - MR !${branch.mrId}: ${branch.sourceBranch}`);
+      });
+    }
+    
+    if (selectedClosed.length > 0) {
+      console.log(`\n❌ Closed branches (${selectedClosed.length}):`);
+      selectedClosed.forEach(branch => {
+        console.log(`  - MR !${branch.mrId}: ${branch.sourceBranch}`);
+      });
+    }
+    
+    // 确认删除
+    const confirmQuestions = [
+      {
+        type: 'confirm',
+        name: 'confirmDelete',
+        message: '\nDo you want to delete these branches?',
+        default: false
+      }
+    ];
+    
+    const confirmAnswers = await inquirer.prompt(confirmQuestions);
+    
+    if (confirmAnswers.confirmDelete) {
+      console.log('\nDeleting branches...');
+      for (const branch of selectedBranches) {
+        await deleteBranch(apiClient, encodedProjectId, branch.sourceBranch, options.force);
+      }
+    } else {
+      console.log('\nOperation cancelled by user.');
+    }
+    
+  } catch (error) {
+    console.error('Error cleaning up branches:', error.message);
+    process.exit(1);
+  }
+}
+
+export { cleanup };

package/src/index.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+
+import { Command } from "commander";
+import { list } from "./list.js";
+
+const program = new Command();
+
+program
+  .name("glbc")
+  .description("A CLI tool to clean up invalid GitLab branches")
+  .version("1.0.0");
+
+// 添加 list 命令
+program
+  .command("list")
+  .description("List all GitLab branches")
+  .action(async (options) => {
+    await list(options);
+  });
+
+// 解析命令行参数
+program.parse();
+
+// 如果没有提供任何命令，则显示帮助
+if (!process.argv.slice(2).length) {
+  program.help();
+}

package/src/list.js

@@ -0,0 +1,208 @@
+import axios from 'axios';
+import fs from 'fs';
+
+// 从配置文件读取配置
+function readConfig(configPath) {
+  const config = {};
+  
+  if (fs.existsSync(configPath)) {
+    try {
+      const configContent = fs.readFileSync(configPath, 'utf8');
+      const lines = configContent.split('\n');
+      
+      for (const line of lines) {
+        const trimmedLine = line.trim();
+        // 跳过空行和注释
+        if (!trimmedLine || trimmedLine.startsWith('#')) {
+          continue;
+        }
+        
+        // 解析键值对格式 (key=value)
+        const [key, value] = trimmedLine.split('=').map(part => part.trim());
+        if (key && value) {
+          config[key.toLowerCase()] = value;
+        }
+      }
+    } catch (error) {
+      console.warn('Warning: Could not read config file:', error.message);
+    }
+  }
+  
+  return config;
+}
+
+// 获取配置值
+function getConfigValue(config, key) {
+  // 优先级：配置文件 > 环境变量 > 默认值
+  return config[key] || 
+         process.env[key.toUpperCase()] ||
+         null;
+}
+
+// 获取所有分支
+async function getAllBranches(apiClient, projectId) {
+  const branches = [];
+  let page = 1;
+  let hasNextPage = true;
+
+  try {
+    while (hasNextPage) {
+      const response = await apiClient.get(`/projects/${projectId}/repository/branches`, {
+        params: {
+          page: page,
+          per_page: 100
+        }
+      });
+      
+      branches.push(...response.data);
+      
+      // 检查是否有下一页
+      const linkHeader = response.headers.link;
+      hasNextPage = linkHeader && linkHeader.includes('rel="next"');
+      page++;
+    }
+    
+    return branches;
+  } catch (error) {
+    console.error('Error fetching branches:', error.message);
+    throw error;
+  }
+}
+
+// 获取分支最后提交信息（包括提交者信息）
+async function getLastCommitInfo(apiClient, projectId, branchName) {
+  try {
+    const response = await apiClient.get(`/projects/${projectId}/repository/commits`, {
+      params: {
+        ref_name: branchName,
+        per_page: 1
+      }
+    });
+    
+    if (response.data.length > 0) {
+      const commit = response.data[0];
+      return {
+        date: new Date(commit.committed_date),
+        author: commit.author_name || 'Unknown'
+      };
+    }
+    
+    return null;
+  } catch (error) {
+    console.error(`Error fetching commit info for branch ${branchName}:`, error.message);
+    return null;
+  }
+}
+
+// 列出所有分支
+async function list(options) {
+  // 读取配置
+  const configPath = options.config || '.glabrc';
+  const config = readConfig(configPath);
+  
+  // 获取配置值
+  const gitlabUrl = getConfigValue(config, 'gitlab_url');
+  const token = getConfigValue(config, 'gitlab_token');
+  const projectId = getConfigValue(config, 'project_id');
+  
+  // 验证必需选项
+  if (!gitlabUrl) {
+    console.error('Error: GitLab API URL is required');
+    process.exit(1);
+  }
+
+  if (!token) {
+    console.error('Error: GitLab token is required');
+    process.exit(1);
+  }
+
+  if (!projectId) {
+    console.error('Error: Project ID or path is required');
+    process.exit(1);
+  }
+
+  // 构建 GitLab API 基础 URL
+  const gitlabBaseUrl = gitlabUrl.replace(/\/$/, ''); // 移除末尾的斜杠
+
+  // 创建 axios 实例
+  const apiClient = axios.create({
+    baseURL: gitlabBaseUrl,
+    headers: {
+      'PRIVATE-TOKEN': token,
+      'Content-Type': 'application/json'
+    }
+  });
+
+  // 对项目ID进行URL编码（如果包含特殊字符）
+  const encodedProjectId = encodeURIComponent(projectId);
+
+  // 列出所有分支
+  try {
+    const branches = await getAllBranches(apiClient, encodedProjectId);
+    
+    // 计算每列的最大宽度
+    let maxBranchWidth = 6; // "Branch" header length
+    let maxDateWidth = 12; // "Created Date" header length
+    let maxAuthorWidth = 6; // "Author" header length
+    let maxProtectedWidth = 8; // "Protected" header length
+    
+    // 遍历所有分支计算最大宽度
+    for (const branch of branches) {
+      maxBranchWidth = Math.max(maxBranchWidth, branch.name.length);
+      // 日期格式通常是 YYYY-MM-DD，固定长度为 10
+      maxDateWidth = Math.max(maxDateWidth, 10);
+      // 作者名称可能较长，但通常不会太长
+      maxAuthorWidth = Math.max(maxAuthorWidth, 16);
+      maxProtectedWidth = Math.max(maxProtectedWidth, 8);
+    }
+    
+    // 确保最小宽度
+    maxBranchWidth = Math.max(maxBranchWidth, 6);
+    maxDateWidth = Math.max(maxDateWidth, 12);
+    maxAuthorWidth = Math.max(maxAuthorWidth, 6);
+    maxProtectedWidth = Math.max(maxProtectedWidth, 8);
+    
+    // 添加一些额外空间
+    maxBranchWidth += 2;
+    maxDateWidth += 2;
+    maxAuthorWidth += 2;
+    maxProtectedWidth += 2;
+    
+    // 构建分隔线
+    const separator = '+' + '-'.repeat(maxBranchWidth) + '+' + '-'.repeat(maxDateWidth) + '+' + '-'.repeat(maxAuthorWidth) + '+' + '-'.repeat(maxProtectedWidth) + '+';
+    
+    // 输出表格头部
+    console.log(`\nFound ${branches.length} branches:`);
+    console.log(separator);
+    console.log(`| ${'Branch'.padEnd(maxBranchWidth - 2)} | ${'Created Date'.padEnd(maxDateWidth - 2)} | ${'Author'.padEnd(maxAuthorWidth - 2)} | ${'Protected'.padEnd(maxProtectedWidth - 2)} |`);
+    console.log(separator);
+    
+    // 输出每个分支的信息
+    for (const branch of branches) {
+      // 获取最后提交信息
+      const commitInfo = await getLastCommitInfo(apiClient, encodedProjectId, branch.name);
+      
+      // 格式化分支名称（不截断）
+      const branchName = branch.name;
+      
+      // 格式化日期
+      const commitDate = commitInfo ? commitInfo.date.toISOString().split('T')[0] : 'Unknown';
+      
+      // 格式化作者名称
+      const author = commitInfo ? (commitInfo.author.length > maxAuthorWidth - 2 ? commitInfo.author.substring(0, maxAuthorWidth - 5) + '...' : commitInfo.author) : 'Unknown';
+      
+      // 格式化保护状态
+      const protectedStatus = branch.protected ? 'Yes' : 'No';
+      
+      // 输出表格行
+      console.log(`| ${branchName.padEnd(maxBranchWidth - 2)} | ${commitDate.padEnd(maxDateWidth - 2)} | ${author.padEnd(maxAuthorWidth - 2)} | ${protectedStatus.padEnd(maxProtectedWidth - 2)} |`);
+    }
+    
+    console.log(separator);
+  } catch (error) {
+    console.error('Error listing branches:', error.message);
+    process.exit(1);
+  }
+}
+
+export { list };