yg-team-cli 2.1.8 → 2.2.0

package/README.md

@@ -32,7 +32,32 @@
 
 以下记录了 team-cli 的开发进展，按时间倒序排列。
 
-### 2026-01-27 - 迭代开发与自动化
+### 2026-01-27 - GitLab 版本管理与 Dev 模式增强
+
+**Phase 4: GitLab 版本管理**
+- **提交**: `npm_feature` 分支
+- **新增命令**: `config`, `diff`
+- **功能**:
+  - GitLab Access Token 管理（加密存储）
+  - 模板版本检查和更新
+  - 版本对比功能（支持 tag/branch）
+  - 模板版本信息记录到 AI_MEMORY.md
+- **新增文件**:
+  - `src/lib/user-config.ts` - 用户配置管理
+  - `src/lib/gitlab-api.ts` - GitLab API 客户端
+  - `src/commands/config.ts` - 配置管理命令
+  - `src/commands/diff.ts` - 版本对比命令
+- **npm 发布**: `yg-team-cli@2.1.9`
+
+**Phase 3: Dev 模式增强**
+- **功能**:
+  - 任务完成后自动更新 spec 文件状态
+  - 支持单个 todo 或整个 milestone 批量更新
+- **交互优化**:
+  - 添加用户指引提示
+  - 移除超时限制，允许长时间开发
+
+**Phase 2: 迭代开发与自动化**
 
 **Phase 3: API 管理功能**
 - **提交**: `6a69bc5`
@@ -117,32 +142,31 @@
 
 ## 安装
 
-### 方式一：Git 仓库分发（推荐）
+### 通过 npm 安装（推荐）
 
 ```bash
-# 克隆仓库
-git clone https://github.com/your-org/team-cli.git
-cd team-cli
-
-# 添加到 PATH
-echo 'export PATH=$PATH:'$(pwd)'' >> ~/.zshrc
-source ~/.zshrc
+# 全局安装
+npm install -g yg-team-cli
 
-# 赋予执行权限
-chmod +x team-cli
+# 验证安装
+team-cli --version
 ```
 
-### 方式二：直接下载
+### 方式一：Git 仓库分发
 
 ```bash
-# 下载脚本
-curl -O https://raw.githubusercontent.com/your-org/team-cli/main/team-cli
+# 克隆仓库
+git clone https://gitlab.yungu-inc.org/yungu-app/claude-dev-cli.git
+cd claude-dev-cli
+
+# 安装依赖
+npm install
 
-# 赋予执行权限
-chmod +x team-cli
+# 构建项目
+npm run build
 
-# 添加到 PATH
-sudo mv team-cli /usr/local/bin/
+# 全局链接
+npm link
 ```
 
 ## 使用指南
@@ -155,12 +179,26 @@ sudo mv team-cli /usr/local/bin/
 team-cli init my-project
 ```
 
+**指定版本初始化：**
+
+```bash
+# 使用指定 tag 初始化
+team-cli init my-project --backend-tag v1.2.0
+
+# 使用指定分支初始化
+team-cli init my-project --frontend-branch develop
+
+# 前后端指定不同版本
+team-cli init my-project --backend-tag v1.2.0 --frontend-branch develop
+```
+
 **执行内容：**
 - 环境检查（Claude Code CLI）
 - 交互式输入项目名称
 - 创建标准目录结构
 - 生成"宪法"文件（TECH_STACK.md, CONVENTIONS.md, AI_MEMORY.md）
 - 从模板仓库克隆前后端代码
+- 记录模板版本信息到 `.team-cli/template.json` 和 AI_MEMORY.md
 - 初始化 Git 仓库
 - 配置 pre-commit hook
 
@@ -584,7 +622,7 @@ team-cli detect-deps
 - 服务引用（Service 注入）
 - 前端 API 调用（fetch, axios）
 
-### 12. 同步 AI_MEMORY
+### 15. 同步 AI_MEMORY
 
 自动同步 AI_MEMORY.md，保持项目状态最新：
 
@@ -603,6 +641,7 @@ team-cli sync-memory
   - 扫描 specs 更新功能清单...
   - 扫描 Controller 更新 API 列表...
   - 扫描 Entity 更新数据模型...
+  - 同步模板版本信息...
   - 更新最后同步时间...
 
 ✓ AI_MEMORY.md 已同步
@@ -612,6 +651,37 @@ team-cli sync-memory
 - 功能清单（状态、进度、完成日期）
 - API 列表（扫描 Controller 生成）
 - 数据模型（表名、字段数、关联关系）
+- 模板版本信息（前后端模板版本、commit、更新时间）
+
+### 16. Dev 模式增强
+
+**开发任务完成后自动更新 Spec 文件状态：**
+
+```bash
+team-cli dev
+# → 选择 spec → milestone → todo
+# → 在 Claude 中完成开发
+# → 退出 Claude 后自动询问是否更新 spec 文件
+```
+
+**交互流程：**
+
+```
+开发任务完成!
+✓ 会话日志已保存
+
+? 任务是否已完成？是否更新 spec 文件中的 todo 状态？ (Y/n)
+```
+
+选择 `Y` 后自动：
+- 找到对应的 todo 项
+- 将 `- [ ]` 改为 `- [x]`
+- 更新 spec 文件
+- 下次运行 `team-cli dev` 时会显示为已完成
+
+---
+
+## 环境变量配置
 
 ### 13. API 检查
 
@@ -686,28 +756,73 @@ team-cli check-api
 | 2026-01-27 | v1.0 | 新增 | 初始版本 | team-cli |
 ```
 
----
+### 14. GitLab 版本管理
 
-## 环境变量配置
+管理 GitLab 模板版本配置和更新：
 
 ```bash
-# 后端模板仓库
-export TEMPLATE_REPO=git@gitlab.yungu-inc.org:yungu-app/java-scaffold-template.git
+# 配置 GitLab Token（首次使用必须）
+team-cli config set-token
+
+# 显示当前配置
+team-cli config show
 
-# 本地后端模板（降级使用）
-export LOCAL_BACKEND_TEMPLATE=/path/to/local/backend/template
+# 验证 Token
+team-cli config validate
+```
 
-# 前端模板仓库
-export FRONTEND_TEMPLATE_REPO=https://gitlab.yungu-inc.org/static/fe-tpl-ai
+**更新模板到最新版本：**
 
-# 本地前端模板（降级使用）
-export LOCAL_FRONTEND_TEMPLATE=/path/to/local/frontend/template
+```bash
+# 检查并更新到最新版本
+team-cli update
 
-# Git 网络超时时间（秒）
-export GIT_TIMEOUT=5
+# 只更新后端模板
+team-cli update --backend
+
+# 更新到指定 tag
+team-cli update --backend --tag v1.3.0
+
+# 预览更新（不实际执行）
+team-cli update --backend --tag v1.3.0 --dry-run
 ```
 
-## 开发规范
+**版本对比：**
+
+```bash
+# 对比所有模板
+team-cli diff
+
+# 只对比后端模板
+team-cli diff --backend
+
+# 对比指定版本
+team-cli diff --backend --tag v1.3.0
+
+# 以 diff 格式输出
+team-cli diff --backend --output diff
+```
+
+**输出示例：**
+
+```
+═══════════════════════════════════════════════════════
+  模板版本对比
+═══════════════════════════════════════════════════════
+
+▸ 后端模板:
+  本地版本: v1.2.0 (abc123)
+  远程版本: v1.3.0 (def456)
+  状态: ⚠️ 有更新
+
+新增提交 (2):
+  ✓ abc123 添加用户导出功能
+  ✓ def456 修复分页查询 bug
+```
+
+---
+
+## 环境变量配置
 
 ### 后端规范
 

package/dist/cli.js

@@ -177,6 +177,14 @@ var init_logger = __esm({
         const coloredLabel = chalk[labelColor](`[${label}]`);
         console.log(`${coloredLabel} ${text}`);
       }
+      /**
+       * 打印调试信息（灰色，仅在 DEBUG 模式下显示）
+       */
+      debug(text) {
+        if (process.env.DEBUG) {
+          console.debug(chalk.gray(`[DEBUG] ${text}`));
+        }
+      }
     };
     logger = new Logger();
   }
@@ -924,7 +932,7 @@ var init_user_config = __esm({
         try {
           const configDir = path5.dirname(this.configPath);
           await FileUtils.ensureDir(configDir);
-          const configToSave = { ...config };
+          const configToSave = JSON.parse(JSON.stringify(config));
           if (configToSave.gitlab?.accessToken) {
             configToSave.gitlab.accessToken = this.encrypt(configToSave.gitlab.accessToken);
           }
@@ -1244,11 +1252,18 @@ var init_gitlab_api = __esm({
        */
       static parseProjectPath(repository) {
         let path18 = repository;
-        path18 = path18.replace(/^https?:\/\//, "");
-        path18 = path18.replace(/^git@/, "");
-        const parts = path18.split("/");
-        if (parts.length > 1) {
-          path18 = parts.slice(1).join("/");
+        if (path18.startsWith("git@")) {
+          path18 = path18.replace(/^git@/, "");
+          const colonIndex = path18.indexOf(":");
+          if (colonIndex !== -1) {
+            path18 = path18.substring(colonIndex + 1);
+          }
+        } else {
+          path18 = path18.replace(/^https?:\/\//, "");
+          const parts = path18.split("/");
+          if (parts.length > 1) {
+            path18 = parts.slice(1).join("/");
+          }
         }
         path18 = path18.replace(/\.git$/, "");
         return path18;
@@ -2458,6 +2473,7 @@ async function executeDevelopment(specFile, milestone, todo) {
   logger.separator("\u2500", 60);
   logger.newLine();
   await generateSessionLog(specFile, milestone, todo, taskDescription, result);
+  await askAndUpdateSpecStatus(specFile, milestone, todo);
   logger.header("\u5F00\u53D1\u4EFB\u52A1\u5B8C\u6210!");
   logger.success("\u4F1A\u8BDD\u65E5\u5FD7\u5DF2\u4FDD\u5B58");
   logger.newLine();
@@ -2651,6 +2667,72 @@ ${result}
 `;
   await FileUtils.write(logFile, content);
 }
+async function askAndUpdateSpecStatus(specFile, milestone, todo) {
+  try {
+    const { shouldUpdate } = await inquirer3.prompt([
+      {
+        type: "confirm",
+        name: "shouldUpdate",
+        message: "\u4EFB\u52A1\u662F\u5426\u5DF2\u5B8C\u6210\uFF1F\u662F\u5426\u66F4\u65B0 spec \u6587\u4EF6\u4E2D\u7684 todo \u72B6\u6001\uFF1F",
+        default: true
+      }
+    ]);
+    if (!shouldUpdate) {
+      logger.info("\u8DF3\u8FC7\u66F4\u65B0 spec \u6587\u4EF6");
+      return;
+    }
+    const content = await FileUtils.read(specFile);
+    const lines = content.split("\n");
+    let inTargetMilestone = false;
+    let targetTodoIndex = -1;
+    let milestoneIndex = -1;
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      if (milestone !== "\u6574\u4E2A spec" && line.includes(milestone)) {
+        inTargetMilestone = true;
+        milestoneIndex = i;
+        continue;
+      }
+      if (inTargetMilestone) {
+        if (line.match(/^###\s+Milestone/)) {
+          break;
+        }
+        if (todo !== "\u5168\u90E8\u529F\u80FD" && todo !== "\u5168\u90E8\u4EFB\u52A1") {
+          const todoMatch = line.match(/^-\s+\[[ x ]\]\s*(.+)/);
+          if (todoMatch && todoMatch[1].trim() === todo) {
+            targetTodoIndex = i;
+            break;
+          }
+        }
+      }
+    }
+    if (targetTodoIndex !== -1) {
+      const line = lines[targetTodoIndex];
+      lines[targetTodoIndex] = line.replace(/^-\s+\[ \]/, "- [x]");
+      logger.success(`\u5DF2\u6807\u8BB0 todo \u4E3A\u5B8C\u6210: ${todo}`);
+    } else if (todo === "\u5168\u90E8\u529F\u80FD" || todo === "\u5168\u90E8\u4EFB\u52A1") {
+      let updatedCount = 0;
+      for (let i = milestoneIndex + 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.match(/^###\s+Milestone/)) {
+          break;
+        }
+        if (line.match(/^-\s+\[ \]/)) {
+          lines[i] = line.replace(/^-\s+\[ \]/, "- [x]");
+          updatedCount++;
+        }
+      }
+      logger.success(`\u5DF2\u6807\u8BB0 ${updatedCount} \u4E2A todos \u4E3A\u5B8C\u6210`);
+    } else {
+      logger.warn("\u672A\u627E\u5230\u5BF9\u5E94\u7684 todo \u9879");
+      return;
+    }
+    await FileUtils.write(specFile, lines.join("\n"));
+    logger.success("Spec \u6587\u4EF6\u5DF2\u66F4\u65B0");
+  } catch (error) {
+    logger.warn(`\u66F4\u65B0 spec \u6587\u4EF6\u5931\u8D25: ${error}`);
+  }
+}
 var devCommand;
 var init_dev = __esm({
   "src/commands/dev.ts"() {
@@ -5866,7 +5948,7 @@ var init_index = __esm({
     init_config();
     init_diff();
     program = new Command16();
-    program.name("team-cli").description("AI-Native \u56E2\u961F\u7814\u53D1\u811A\u624B\u67B6").version("2.1.8");
+    program.name("team-cli").description("AI-Native \u56E2\u961F\u7814\u53D1\u811A\u624B\u67B6").version("2.1.9");
     program.option("-v, --verbose", "\u8BE6\u7EC6\u8F93\u51FA\u6A21\u5F0F").option("--debug", "\u8C03\u8BD5\u6A21\u5F0F");
     program.addCommand(initCommand);
     program.addCommand(splitPrdCommand);