ccman 2.1.3 → 2.1.5

package/docs/npm-publish-guide.md

@@ -1,71 +0,0 @@
-# NPM 发布配置指南
-
-## 🔐 步骤一：获取 NPM Token
-
-```bash
-# 1. 登录 NPM
-npm login
-
-# 2. 创建发布权限的 token
-npm token create --read-only=false
-```
-
-复制生成的 token（格式：`npm_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`）
-
-## 🔧 步骤二：设置 GitHub Secrets
-
-1. 访问：`https://github.com/2ue/ccm/settings/secrets/actions`
-2. 点击 **"New repository secret"**
-3. 设置：
-   - **Name**: `NPM_TOKEN`
-   - **Secret**: 粘贴你的 NPM token
-4. 点击 **"Add secret"**
-
-### 验证设置
-设置完成后，应看到：
-```
-Repository secrets:
-• NPM_TOKEN  ••••••••••••••••••••••••••••••••••••••••
-```
-
-### 关于 GITHUB_TOKEN
-**无需手动设置** - GitHub Actions 自动提供此 token
-
-## 🚀 步骤三：发布
-
-### 自动发布（推荐）
-```bash
-# 交互式选择版本
-pnpm run release:interactive
-
-# 或指定版本类型
-pnpm run release:patch
-pnpm run release:minor
-pnpm run release:major
-```
-
-### 本地发布（备用）
-```bash
-pnpm run publish:local
-```
-
-## 🔍 故障排查
-
-### 401 Unauthorized
-- 检查 NPM token 是否正确设置
-- 重新生成 token: `npm token create --read-only=false`
-
-### 403 Forbidden  
-- 包名已存在：修改 package.json 中的 name
-- 检查发布权限：`npm owner ls ccman`
-
-### 测试发布权限
-```bash
-npm publish --dry-run
-```
-
-## 🛡️ 安全提醒
-
-- NPM token 只存储在 GitHub Secrets 中
-- 定期轮换 token（建议 90 天）
-- Token 泄露时立即删除并重新创建

package/docs/release-guide.md

@@ -1,144 +0,0 @@
-# 发布指南
-
-## 📋 发布前准备
-
-1. **设置 NPM Token**：参见 [npm-publish-guide.md](./npm-publish-guide.md)
-2. **确保工作目录干净**：`git status`
-3. **确保在主分支**：`git checkout main`
-
-## 🚀 发布方式
-
-> 💡 **强烈推荐**: 使用新的模块化智能发布脚本，详见 [Scripts使用指南](./scripts-guide.md)
-
-### 🌟 方式一：智能发布脚本（强烈推荐）
-
-#### 使用 smart-release-v3.sh
-```bash
-# 完整智能发布流程（推荐）
-./scripts/smart-release-v3.sh
-# 或使用 npm script
-pnpm run release:smart
-
-# 跳过版本升级，使用当前版本
-./scripts/smart-release-v3.sh --skip-version
-
-# 直接指定版本类型
-./scripts/smart-release-v3.sh --version-type minor
-
-# 不监控发布状态（快速完成）
-./scripts/smart-release-v3.sh --no-monitor
-
-# 查看帮助
-./scripts/smart-release-v3.sh --help
-```
-
-#### ✨ 智能发布特性
-- **智能未提交代码处理**: 3种处理选项（提交/暂存/取消）
-- **智能版本推荐**: 基于git提交历史分析  
-- **实时发布监控**: 5分钟监控GitHub Actions、NPM、Release
-- **完整链接输出**: 自动生成所有相关链接
-- **模块化架构**: 每个步骤可独立测试和调试
-
-### 方式二：经典发布脚本
-
-#### Scripts发布
-```bash
-# 快速发布（日常推荐）
-./scripts/quick-release.sh patch   # 修订版本
-./scripts/quick-release.sh minor   # 次版本  
-./scripts/quick-release.sh major   # 主版本
-
-# 完整发布流程（重要版本）
-./scripts/release.sh               # 交互式完整流程
-```
-
-#### NPM Scripts发布
-```bash
-# 交互选择版本类型
-pnpm run release:interactive
-
-# 指定版本类型
-pnpm run release:patch   # 0.0.1 → 0.0.2
-pnpm run release:minor   # 0.0.1 → 0.1.0  
-pnpm run release:major   # 0.0.1 → 1.0.0
-
-# 完整发布流程
-pnpm run release
-```
-
-### 方式三：本地发布（备用）
-```bash
-# 直接发布到 NPM（跳过 GitHub Actions）
-pnpm run publish:local
-# 或
-./scripts/publish-local.sh
-```
-
-## 🔧 独立模块使用
-
-模块化脚本支持独立使用，便于测试和调试：
-
-```bash
-# 仅检查代码状态
-./scripts/modules/check-uncommitted.sh
-
-# 仅进行版本升级
-./scripts/modules/version-bump.sh minor
-
-# 仅创建tag并推送
-./scripts/modules/create-tag.sh
-
-# 仅监控发布状态
-./scripts/modules/monitor-release.sh
-```
-
-## 📊 发布后验证
-
-### 1. 检查 GitHub Actions
-访问：https://github.com/2ue/ccm/actions
-- 等待构建完成（约 2-3 分钟）
-- 确认状态为 ✅ 成功
-
-### 2. 验证结果
-- **NPM 包**：https://www.npmjs.com/package/ccman
-- **GitHub Release**：https://github.com/2ue/ccm/releases
-- **测试安装**：`npm install -g ccman`
-
-## 🔧 故障排查
-
-### GitHub Actions 失败
-1. 检查 `NPM_TOKEN` 设置是否正确
-2. 查看 Actions 日志获取详细错误信息
-3. 确认包名未被占用
-
-### 版本冲突
-```bash
-# 检查已存在的版本
-npm view ccman versions --json
-
-# 使用新版本号重新发布
-pnpm run release:patch
-```
-
-### 手动创建标签（高级）
-```bash
-# 如果脚本失败，可手动操作
-pnpm version patch --no-git-tag-version
-git add . && git commit -m "chore: 发布版本 v0.0.2"
-git tag -a v0.0.2 -m "Release v0.0.2"
-git push origin main && git push origin v0.0.2
-```
-
-## ✅ 发布检查清单
-
-### 发布前
-- [ ] NPM token 已设置
-- [ ] 工作目录干净
-- [ ] 在主分支
-- [ ] 构建和测试通过
-
-### 发布后  
-- [ ] GitHub Actions 成功
-- [ ] NPM 包可安装
-- [ ] GitHub Release 创建
-- [ ] 版本号正确

package/docs/scripts-guide.md

@@ -1,221 +0,0 @@
-# Scripts 使用指南
-
-项目提供了多个发布和管理脚本，位于 `./scripts/` 目录下。现已升级为**模块化架构**，提供更灵活、专业的发布体验。
-
-## 📂 Scripts 目录结构
-
-### 🆕 模块化架构 (v3.0)
-
-```
-scripts/
-├── modules/                        # 独立功能模块
-│   ├── check-uncommitted.sh       # 智能未提交代码处理
-│   ├── version-bump.sh             # 智能版本提升选择
-│   ├── create-tag.sh               # 创建tag和提交
-│   └── monitor-release.sh          # 发布状态监控
-├── smart-release-v3.sh             # 🌟 主控智能发布脚本
-├── release.sh                      # 完整发布流程（经典版本）
-├── quick-release.sh                # 快速发布流程（经典版本）
-└── publish-local.sh                # 本地发布脚本（调试用）
-```
-
-## 🌟 模块化智能发布脚本（推荐）
-
-### `smart-release-v3.sh` - 主控智能发布脚本
-
-**🎯 完全按照专业发布流程设计**，实现四个独立步骤的完美组合：
-
-#### 📋 发布流程
-1. **检查工作目录状态** - 智能处理未提交代码
-2. **版本管理** - 可选择版本升级或使用现有版本
-3. **创建tag和提交** - 纯tag操作，触发GitHub Actions
-4. **监控发布状态** - 5分钟实时监控，自动确认成功
-
-#### 🚀 使用方法
-
-```bash
-# 完整智能发布流程
-./scripts/smart-release-v3.sh
-
-# 跳过版本升级，使用当前版本
-./scripts/smart-release-v3.sh --skip-version
-
-# 直接指定版本类型
-./scripts/smart-release-v3.sh --version-type minor
-
-# 不监控发布状态
-./scripts/smart-release-v3.sh --no-monitor
-
-# 查看帮助
-./scripts/smart-release-v3.sh --help
-```
-
-#### ✨ 智能特性
-
-- **智能未提交代码处理**: 3种处理选项（提交/暂存/取消）
-- **智能版本推荐**: 基于git提交历史分析推荐合适版本
-- **实时发布监控**: 监控GitHub Actions、NPM包、GitHub Release状态
-- **完整链接输出**: 自动生成所有相关监控和访问链接
-- **专业错误处理**: 每步都有错误检查和恢复提示
-
-## 🔧 独立模块脚本
-
-每个模块都可以独立运行，便于测试和调试：
-
-### 1. `modules/check-uncommitted.sh` - 代码状态检查
-
-```bash
-# 检查工作目录状态
-./scripts/modules/check-uncommitted.sh
-```
-
-**功能**:
-- 检测未提交的更改
-- 提供3种智能处理选项：提交、暂存、取消
-- 给出清晰的操作指导
-
-### 2. `modules/version-bump.sh` - 版本管理
-
-```bash
-# 交互式版本选择
-./scripts/modules/version-bump.sh
-
-# 直接指定版本类型
-./scripts/modules/version-bump.sh patch
-./scripts/modules/version-bump.sh minor
-./scripts/modules/version-bump.sh major
-
-# 测试模式（不执行实际升级）
-./scripts/modules/version-bump.sh test
-```
-
-**功能**:
-- 基于git提交历史的智能版本推荐
-- 5种版本选择：patch、minor、major、prerelease、custom
-- 版本预览和确认机制
-
-### 3. `modules/create-tag.sh` - Tag创建
-
-```bash
-# 根据当前package.json版本创建tag
-./scripts/modules/create-tag.sh
-```
-
-**功能**:
-- 根据package.json版本号创建tag
-- 不进行版本升级，纯tag操作
-- 自动提交和推送，触发GitHub Actions
-
-### 4. `modules/monitor-release.sh` - 发布监控
-
-```bash
-# 监控当前版本的发布状态
-./scripts/modules/monitor-release.sh
-```
-
-**功能**:
-- 5分钟超时的实时监控
-- 并行检查GitHub Actions、NPM包、GitHub Release
-- 输出完整的监控链接
-- 生成发布状态总结报告
-
-## 📊 经典发布脚本
-
-### 1. `quick-release.sh` - 快速发布
-
-**适用场景**: 日常开发中的小版本发布
-
-```bash
-# 交互式选择版本类型
-./scripts/quick-release.sh
-
-# 直接指定版本类型
-./scripts/quick-release.sh patch   # 修订版本
-./scripts/quick-release.sh minor   # 次版本
-./scripts/quick-release.sh major   # 主版本
-```
-
-### 2. `release.sh` - 完整发布流程
-
-**适用场景**: 重要版本发布，需要分支管理
-
-```bash
-# 启动完整发布流程
-./scripts/release.sh
-```
-
-**特点**:
-- 创建专用的release分支
-- 智能版本建议和详细changelog
-- 支持prerelease和自定义版本
-
-## 🆚 版本对比
-
-| 特性 | smart-release-v3.sh | 经典脚本 | 独立模块 |
-|------|---------------------|----------|----------|
-| **模块化设计** | ✅ | ❌ | ✅ |
-| **发布监控** | ✅ 5分钟实时监控 | ❌ 仅提供链接 | ✅ |
-| **智能代码处理** | ✅ 3种选项 | ❌ 直接拒绝 | ✅ |
-| **参数支持** | ✅ 丰富的选项 | 🟡 基本支持 | ✅ |
-| **错误恢复** | ✅ 专业级 | 🟡 基本 | ✅ |
-| **可测试性** | ✅ 高 | 🟡 中等 | ✅ |
-
-## 💡 使用建议
-
-### 🎯 推荐使用场景
-
-1. **日常发布**: 使用 `smart-release-v3.sh` - 最完整的智能体验
-2. **快速测试**: 使用 `smart-release-v3.sh --no-monitor` - 跳过监控
-3. **仅升级版本**: 使用 `modules/version-bump.sh` - 独立版本管理
-4. **调试监控**: 使用 `modules/monitor-release.sh` - 独立测试监控功能
-5. **传统发布**: 使用经典脚本作为备用方案
-
-### 🚀 最佳实践
-
-1. **首次使用**: 先运行 `smart-release-v3.sh --help` 了解选项
-2. **测试环境**: 使用 `--no-monitor` 跳过监控，节省时间  
-3. **版本规划**: 遵循[语义化版本](https://semver.org/lang/zh-CN/)规范
-4. **提交规范**: 使用[约定式提交](https://www.conventionalcommits.org/zh-hans/)，获得智能版本推荐
-5. **模块测试**: 单独测试各模块功能，确保环境正确
-
-## 🔗 NPM Scripts 快捷方式
-
-在package.json中的快捷方式：
-
-```bash
-# 智能发布（推荐）
-pnpm run release:smart      # = ./scripts/smart-release-v3.sh
-
-# 经典发布
-pnpm run release            # = ./scripts/release.sh
-pnpm run release:patch      # = ./scripts/quick-release.sh patch
-pnpm run release:minor      # = ./scripts/quick-release.sh minor
-pnpm run release:major      # = ./scripts/quick-release.sh major
-
-# 本地发布
-pnpm run publish:local      # = ./scripts/publish-local.sh
-```
-
-## ⚠️ 注意事项
-
-### 1. 环境要求
-- ✅ Node.js 和 pnpm 已安装
-- ✅ Git 仓库，工作目录相对干净
-- ✅ NPM_TOKEN 已在 GitHub Secrets 中配置
-- ✅ curl 已安装（用于发布状态监控）
-
-### 2. 权限设置
-```bash
-# 给脚本添加执行权限（首次使用）
-chmod +x scripts/**/*.sh
-```
-
-### 3. 故障排查
-- **模块未找到**: 检查 `scripts/modules/` 目录是否存在
-- **权限错误**: 运行 `chmod +x scripts/**/*.sh`
-- **监控超时**: 5分钟后超时是正常的，请手动检查链接
-- **版本冲突**: 检查 package.json 版本号是否正确
-
----
-
-🎉 **推荐**: 立即体验 `./scripts/smart-release-v3.sh` 获得最佳的智能发布体验！

package/docs/version-management.md

@@ -1,64 +0,0 @@
-# 版本管理
-
-## 🎯 版本工具
-
-项目使用独立的版本工具模块 `src/utils/version.ts`：
-
-```typescript
-import { getCurrentVersion } from './utils/version';
-
-// CLI 自动获取版本
-program.version(getCurrentVersion());
-```
-
-## 📦 发布脚本功能
-
-### 智能版本推荐
-脚本会分析最近的 git 提交，自动推荐合适的版本类型：
-- `feat`, `feature` → minor 版本
-- `breaking`, `major` → major 版本  
-- 其他 → patch 版本
-
-### 交互式界面
-```bash
-📦 版本升级选项:
-
-✨ [推荐] 1) 🔧 patch (修订版本)    0.0.1 → 0.0.2
-          2) ✨ minor (次版本)     0.0.1 → 0.1.0  
-          3) 🚀 major (主版本)     0.0.1 → 1.0.0
-
-请选择版本类型 (1-3, 回车默认选择推荐项):
-```
-
-## 🚀 使用方式
-
-### 快速发布
-```bash
-pnpm run release:patch      # 直接发布 patch 版本
-pnpm run release:minor      # 直接发布 minor 版本
-pnpm run release:major      # 直接发布 major 版本
-```
-
-### 交互式发布
-```bash
-pnpm run release:interactive  # 交互选择版本类型
-pnpm run release             # 完整发布流程
-```
-
-### 本地发布
-```bash
-pnpm run publish:local      # 绕过 GitHub Actions
-```
-
-## 🎯 版本管理最佳实践
-
-### 语义化版本
-- **patch (0.0.x)**: Bug 修复、小改进
-- **minor (0.x.0)**: 新功能、向后兼容
-- **major (x.0.0)**: 破坏性更改、重大重构
-
-### 工具特性
-- ✅ 版本号统一管理（package.json）
-- ✅ 智能推荐基于 git 提交分析
-- ✅ 交互式界面友好
-- ✅ 支持多种发布模式

package/jest.config.js

@@ -1,22 +0,0 @@
-module.exports = {
-  preset: 'ts-jest',
-  testEnvironment: 'node',
-  roots: ['<rootDir>/src'],
-  testMatch: [
-    '**/__tests__/**/*.ts',
-    '**/?(*.)+(spec|test).ts'
-  ],
-  transform: {
-    '^.+\\.ts$': 'ts-jest'
-  },
-  collectCoverageFrom: [
-    'src/**/*.ts',
-    '!src/**/*.d.ts',
-    '!src/index.ts',  // 简单的导出文件
-    '!src/cli.ts'     // CLI入口文件，主要是命令定义
-  ],
-  coverageDirectory: 'coverage',
-  coverageReporters: ['text', 'lcov', 'html'],
-  moduleFileExtensions: ['ts', 'js', 'json'],
-  testTimeout: 10000
-};