yg-team-cli 2.1.9 → 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;