@zjex/git-workflow 0.3.9 → 0.4.0

package/tests/tag.test.ts

@@ -393,4 +393,240 @@ describe("Tag 功能测试", () => {
       });
     });
   });
+
+  describe("无效标签检测", () => {
+    it("应该识别不包含数字的标签为无效", () => {
+      const tag = "vnull";
+      const isInvalid = !/\d/.test(tag);
+
+      expect(isInvalid).toBe(true);
+    });
+
+    it("应该识别 vundefined 为无效标签", () => {
+      const tag = "vundefined";
+      const isInvalid = !/\d/.test(tag);
+
+      expect(isInvalid).toBe(true);
+    });
+
+    it("应该识别空版本号为无效标签", () => {
+      const tag = "v";
+      const isInvalid = !/\d/.test(tag);
+
+      expect(isInvalid).toBe(true);
+    });
+
+    it("应该识别纯字母标签为无效", () => {
+      const tag = "release";
+      const isInvalid = !/\d/.test(tag);
+
+      expect(isInvalid).toBe(true);
+    });
+
+    it("应该识别包含数字的标签为有效", () => {
+      const tag = "v1.0.0";
+      const isValid = /\d/.test(tag);
+
+      expect(isValid).toBe(true);
+    });
+
+    it("应该识别预发布版本为有效", () => {
+      const tag = "v1.0.0-beta.1";
+      const isValid = /\d/.test(tag);
+
+      expect(isValid).toBe(true);
+    });
+
+    it("应该识别无前缀版本号为有效", () => {
+      const tag = "1.0.0";
+      const isValid = /\d/.test(tag);
+
+      expect(isValid).toBe(true);
+    });
+
+    it("应该识别带前缀的单数字版本为有效", () => {
+      const tag = "v1";
+      const isValid = /\d/.test(tag);
+
+      expect(isValid).toBe(true);
+    });
+  });
+
+  describe("无效标签过滤", () => {
+    it("应该从标签列表中过滤出所有无效标签", () => {
+      const allTags = [
+        "v1.0.0",
+        "vnull",
+        "v1.1.0",
+        "vundefined",
+        "release-1.0.0",
+        "v",
+        "v2.0.0",
+      ];
+      const invalidTags = allTags.filter((tag) => !/\d/.test(tag));
+
+      expect(invalidTags).toEqual(["vnull", "vundefined", "v"]);
+      expect(invalidTags.length).toBe(3);
+    });
+
+    it("应该在没有无效标签时返回空数组", () => {
+      const allTags = ["v1.0.0", "v1.1.0", "v2.0.0", "release-1.0.0"];
+      const invalidTags = allTags.filter((tag) => !/\d/.test(tag));
+
+      expect(invalidTags).toEqual([]);
+      expect(invalidTags.length).toBe(0);
+    });
+
+    it("应该在全是无效标签时返回所有标签", () => {
+      const allTags = ["vnull", "vundefined", "v", "release"];
+      const invalidTags = allTags.filter((tag) => !/\d/.test(tag));
+
+      expect(invalidTags).toEqual(allTags);
+      expect(invalidTags.length).toBe(4);
+    });
+
+    it("应该保留有效标签", () => {
+      const allTags = [
+        "v1.0.0",
+        "vnull",
+        "v1.1.0",
+        "vundefined",
+        "v2.0.0-beta.1",
+      ];
+      const validTags = allTags.filter((tag) => /\d/.test(tag));
+
+      expect(validTags).toEqual(["v1.0.0", "v1.1.0", "v2.0.0-beta.1"]);
+      expect(validTags.length).toBe(3);
+    });
+
+    it("应该处理空标签列表", () => {
+      const allTags: string[] = [];
+      const invalidTags = allTags.filter((tag) => !/\d/.test(tag));
+
+      expect(invalidTags).toEqual([]);
+      expect(invalidTags.length).toBe(0);
+    });
+
+    it("应该处理混合前缀的无效标签", () => {
+      const allTags = [
+        "v1.0.0",
+        "vnull",
+        "release-",
+        "hotfix",
+        "g1.0.0",
+        "tag",
+      ];
+      const invalidTags = allTags.filter((tag) => !/\d/.test(tag));
+
+      expect(invalidTags).toEqual(["vnull", "release-", "hotfix", "tag"]);
+      expect(invalidTags.length).toBe(4);
+    });
+  });
+
+  describe("标签计数统计", () => {
+    it("应该正确统计无效标签数量", () => {
+      const allTags = ["v1.0.0", "vnull", "vundefined", "v2.0.0"];
+      const invalidTags = allTags.filter((tag) => !/\d/.test(tag));
+      const count = invalidTags.length;
+
+      expect(count).toBe(2);
+    });
+
+    it("应该正确统计删除成功和失败的数量", () => {
+      const invalidTags = ["vnull", "vundefined", "v"];
+      let success = 0;
+      let failed = 0;
+
+      // 模拟删除操作
+      invalidTags.forEach((tag) => {
+        // 模拟成功删除前两个，失败最后一个
+        if (tag !== "v") {
+          success++;
+        } else {
+          failed++;
+        }
+      });
+
+      expect(success).toBe(2);
+      expect(failed).toBe(1);
+    });
+
+    it("应该处理全部删除成功的情况", () => {
+      const invalidTags = ["vnull", "vundefined"];
+      let success = 0;
+      let failed = 0;
+
+      invalidTags.forEach(() => {
+        success++;
+      });
+
+      expect(success).toBe(2);
+      expect(failed).toBe(0);
+    });
+
+    it("应该处理全部删除失败的情况", () => {
+      const invalidTags = ["vnull", "vundefined"];
+      let success = 0;
+      let failed = 0;
+
+      invalidTags.forEach(() => {
+        failed++;
+      });
+
+      expect(success).toBe(0);
+      expect(failed).toBe(2);
+    });
+  });
+
+  describe("标签信息格式化", () => {
+    it("应该格式化标签详细信息", () => {
+      const tag = "vnull";
+      const commitHash = "abc1234";
+      const commitDate = "2026-01-14 10:00:00 +0800";
+      const commitMsg = "Release vnull";
+
+      const info = {
+        tag,
+        commit: commitHash,
+        date: commitDate,
+        message: commitMsg,
+      };
+
+      expect(info.tag).toBe("vnull");
+      expect(info.commit).toBe("abc1234");
+      expect(info.date).toBe("2026-01-14 10:00:00 +0800");
+      expect(info.message).toBe("Release vnull");
+    });
+
+    it("应该处理无法获取提交信息的情况", () => {
+      const tag = "vnull";
+      const info = {
+        tag,
+        commit: null,
+        date: null,
+        message: null,
+      };
+
+      expect(info.tag).toBe("vnull");
+      expect(info.commit).toBeNull();
+      expect(info.date).toBeNull();
+      expect(info.message).toBeNull();
+    });
+
+    it("应该格式化多个标签的信息列表", () => {
+      const invalidTags = ["vnull", "vundefined"];
+      const tagInfos = invalidTags.map((tag) => ({
+        tag,
+        commit: `${tag}-hash`,
+        date: "2026-01-14",
+        message: `Release ${tag}`,
+      }));
+
+      expect(tagInfos.length).toBe(2);
+      expect(tagInfos[0].tag).toBe("vnull");
+      expect(tagInfos[0].commit).toBe("vnull-hash");
+      expect(tagInfos[1].tag).toBe("vundefined");
+      expect(tagInfos[1].commit).toBe("vundefined-hash");
+    });
+  });
 });

package/tests/update-notifier.test.ts

@@ -403,4 +403,56 @@ describe("Update Notifier 模块测试", () => {
       );
     });
   });
+
+  describe("通知框样式配置", () => {
+    it("简单通知应该使用无边距配置", () => {
+      const marginConfig = { top: 0, bottom: 0, left: 0, right: 0 };
+
+      expect(marginConfig.top).toBe(0);
+      expect(marginConfig.bottom).toBe(0);
+      expect(marginConfig.left).toBe(0);
+      expect(marginConfig.right).toBe(0);
+    });
+
+    it("交互式通知应该使用最小边距配置", () => {
+      const marginConfig = { top: 0, bottom: 0, left: 1, right: 1 };
+
+      expect(marginConfig.top).toBe(0);
+      expect(marginConfig.bottom).toBe(0);
+      expect(marginConfig.left).toBeGreaterThanOrEqual(0);
+      expect(marginConfig.right).toBeGreaterThanOrEqual(0);
+    });
+
+    it("更新成功通知应该有底部边距", () => {
+      const marginConfig = { top: 0, bottom: 1, left: 2, right: 2 };
+
+      expect(marginConfig.top).toBe(0);
+      expect(marginConfig.bottom).toBe(1);
+    });
+
+    it("所有通知的顶部边距应该为 0", () => {
+      const configs = [
+        { top: 0, bottom: 0, left: 0, right: 0 },
+        { top: 0, bottom: 0, left: 1, right: 1 },
+        { top: 0, bottom: 1, left: 2, right: 2 },
+      ];
+
+      configs.forEach((config) => {
+        expect(config.top).toBe(0);
+      });
+    });
+
+    it("padding 配置应该合理", () => {
+      const paddingConfigs = [
+        { top: 0, bottom: 0, left: 2, right: 2 }, // 简单通知
+        { top: 1, bottom: 1, left: 3, right: 3 }, // 交互式通知
+        { top: 1, bottom: 1, left: 2, right: 2 }, // 成功通知
+      ];
+
+      paddingConfigs.forEach((padding) => {
+        expect(padding.left).toBeGreaterThanOrEqual(2);
+        expect(padding.right).toBeGreaterThanOrEqual(2);
+      });
+    });
+  });
 });

package/tests/COVERAGE_REPORT.md

@@ -1,222 +0,0 @@
-# 测试覆盖率报告
-
-## 📊 总体统计
-
-✅ **153 个测试全部通过**
-
-- **7 个测试文件**
-- **153 个测试用例**
-- **0 个失败**
-- **运行时间**: ~230ms
-
-## 📁 测试文件清单
-
-| 文件                      | 测试数 | 状态 | 覆盖模块                 |
-| ------------------------- | ------ | ---- | ------------------------ |
-| `utils.test.ts`           | 23     | ✅   | 工具函数、颜色、命令执行 |
-| `config.test.ts`          | 12     | ✅   | 配置加载、合并、优先级   |
-| `ai-service.test.ts`      | 21     | ✅   | AI commit 生成、多提供商 |
-| `tag.test.ts`             | 37     | ✅   | Tag 管理、版本控制       |
-| `commit.test.ts`          | 7      | ✅   | 提交类型、消息格式       |
-| `update-notifier.test.ts` | 20     | ✅   | 更新检查、通知、缓存     |
-| `branch.test.ts`          | 33     | ✅   | 分支命名、验证、配置     |
-
-## ✅ 已测试的模块
-
-### 1. Utils 模块 (23 tests)
-
-- Colors 工具 (7)
-- TODAY 常量 (2)
-- exec 函数 (3)
-- execOutput 函数 (2)
-- checkGitRepo 函数 (2)
-- getMainBranch 函数 (3)
-- divider 函数 (1)
-- theme 对象 (3)
-
-### 2. Config 模块 (12 tests)
-
-- 默认配置 (1)
-- 项目配置 (3)
-- 全局配置 (1)
-- 配置合并 (2)
-- 错误处理 (2)
-- 其他 (3)
-
-### 3. AI Service 模块 (21 tests)
-
-- isAICommitAvailable (3)
-- getProviderInfo (5)
-- generateAICommitMessage (12)
-- Ollama 特殊情况 (1)
-
-### 4. Tag 功能 (37 tests)
-
-- 前缀提取 (7)
-- Tag 分组 (3)
-- 显示逻辑 (6)
-- 列宽计算 (4)
-- 版本号解析 (5)
-- 版本号递增 (5)
-- Tag 排序 (2)
-- 多列显示 (2)
-- 表头格式化 (3)
-
-### 5. Commit 功能 (7 tests)
-
-- 提交类型 (3)
-- 提交消息格式 (2)
-- Refactor 对齐处理 (2)
-
-### 6. Update Notifier 模块 (20 tests)
-
-- clearUpdateCache (3)
-- checkForUpdates (8)
-- Volta 检测 (2)
-- 版本比较 (1)
-- 缓存读写 (3)
-- 网络请求 (2)
-
-### 7. Branch 功能 (33 tests)
-
-- 分支命名规范 (5)
-- 分支前缀配置 (2)
-- ID 验证 (3)
-- 描述验证 (3)
-- 基础分支选择 (4)
-- 分支名称格式 (5)
-- 分支类型 (2)
-- autoPush 配置 (3)
-- 分支名称边界情况 (4)
-- 日期格式 (2)
-
-## ⚠️ 待测试的模块
-
-以下模块尚未添加测试：
-
-- ❌ `index.ts` - 主入口
-- ❌ `commands/help.ts` - 帮助命令
-- ❌ `commands/init.ts` - 初始化配置
-- ❌ `commands/release.ts` - 版本发布
-- ❌ `commands/stash.ts` - Stash 管理
-- ❌ `commands/update.ts` - 更新命令
-
-## 📈 覆盖率分析
-
-### 核心功能覆盖率
-
-| 模块            | 覆盖率 | 状态 |
-| --------------- | ------ | ---- |
-| Utils           | 100%   | ✅   |
-| Config          | 100%   | ✅   |
-| AI Service      | 100%   | ✅   |
-| Tag (逻辑)      | 100%   | ✅   |
-| Commit (逻辑)   | 100%   | ✅   |
-| Update Notifier | 100%   | ✅   |
-| Branch (逻辑)   | 100%   | ✅   |
-| Commands        | ~40%   | ⚠️   |
-
-### 测试类型分布
-
-```
-单元测试: 153 个 (100%)
-集成测试: 0 个 (0%)
-E2E 测试: 0 个 (0%)
-```
-
-## 🎯 测试质量指标
-
-### 测试特点
-
-- ✅ **快速** - 所有测试在 230ms 内完成
-- ✅ **独立** - 每个测试独立运行，互不影响
-- ✅ **可重复** - 使用 Mock 确保结果一致
-- ✅ **清晰** - 描述性的测试名称
-- ✅ **全面** - 覆盖正常流程和边界情况
-
-### 测试覆盖的场景
-
-- ✅ 正常流程
-- ✅ 边界情况
-- ✅ 错误处理
-- ✅ 配置缺失
-- ✅ API 失败
-- ✅ 无效输入
-- ✅ 空数据
-
-## 🚀 运行测试
-
-```bash
-# 运行所有测试
-npm test
-
-# 监听模式（开发时推荐）
-npm run test:watch
-
-# 可视化界面
-npm run test:ui
-
-# 生成覆盖率报告
-npm run test:coverage
-```
-
-## 🔒 质量保障
-
-### CI/CD 集成
-
-- ✅ GitHub Actions - 每次 push/PR 自动运行
-- ✅ Pre-commit Hook - 提交前自动运行
-- ✅ 多 Node 版本 - 18.x 和 20.x
-
-### 测试失败处理
-
-- ✅ 测试失败阻止提交
-- ✅ CI 失败阻止合并
-- ✅ 详细的错误信息
-
-## 📋 未来计划
-
-### 短期 (1-2 周)
-
-- [ ] 添加 Help 命令测试
-- [ ] 添加 Init 命令测试
-- [ ] 添加 Release 命令测试
-- [ ] 添加 Stash 命令测试
-- [ ] 添加 Update 命令测试
-- [ ] 添加 Index 入口测试
-
-### 中期 (1-2 月)
-
-- [ ] 添加集成测试
-- [ ] 添加 E2E 测试
-- [ ] 提高覆盖率到 95%+
-- [ ] 添加性能测试
-
-### 长期 (3+ 月)
-
-- [ ] 自动化测试报告
-- [ ] 测试覆盖率徽章
-- [ ] 持续改进测试质量
-- [ ] 添加快照测试
-
-## 💡 贡献指南
-
-添加新功能时，请确保：
-
-1. ✅ 为新功能编写测试
-2. ✅ 运行 `npm test` 确保所有测试通过
-3. ✅ 运行 `npm run test:coverage` 检查覆盖率
-4. ✅ 测试覆盖率不低于现有水平
-5. ✅ 测试名称清晰描述测试内容
-
-## 🎉 总结
-
-我们已经建立了一个全面的测试体系：
-
-- ✅ **153 个测试用例**全部通过
-- ✅ 覆盖**所有核心功能**
-- ✅ **自动化测试**集成到 CI/CD
-- ✅ **Pre-commit Hook**确保代码质量
-- ✅ **完善的文档**帮助开发者快速上手
-
-这个测试体系确保了每次代码变更都不会破坏现有功能，让我们可以放心地重构和添加新功能！🎉