CLI

@legukeji/ai-toolkit TypeScript CLI 源码与测试目录。

目录结构

cli/
├─ src/                      # TypeScript CLI 源码
│  ├─ index.ts               # 命令入口
│  ├─ cli.ts                 # 命令定义与参数解析
│  ├─ constants.ts           # 常量定义
│  ├─ fs-utils.ts            # 文件系统工具
│  ├─ model.ts               # 数据模型
│  ├─ project.ts             # 项目配置管理
│  ├─ registry.ts            # 治理包注册表解析
│  ├─ render.ts              # 内容渲染引擎
│  ├─ repository.ts          # 仓库操作
│  ├─ state.ts               # 状态管理
│  ├─ utils.ts               # 通用工具函数
│  ├─ validate.ts            # Schema 验证
│  └─ test-support/          # 测试辅助工具
├─ test/                     # Node.js test 测试用例
│  ├─ fixtures/              # 测试夹具
│  └─ *.test.ts              # 单元测试文件
├─ packages/                 # 发布时同步的治理包（从 ../packages 复制）
├─ shared/                   # 发布时同步的治理内容（从 ../shared 复制）
├─ tools/                    # 发布时同步的工具适配器（从 ../tools 复制）
├─ schemas/                  # 发布时同步的 schema（从 ../schemas 复制）
├─ package.json              # npm 包配置
└─ tsconfig.json             # TypeScript 配置

主要职责

• 治理包解析：从 npm 包或本地仓库加载 package.yaml 定义
• 内容渲染：根据工具适配器（Codex、Claude、Gemini、OpenCode）渲染治理内容
• 项目管理：初始化 .ai-toolkit/project.yaml、管理 manifest 与 lock
• 更新与冲突检测：基于 baseline 比对实现 diff、update、doctor 命令
• Schema 验证：验证治理对象、包定义、适配器配置的有效性

支持的命令

ai-toolkit version                      # 输出版本信息
ai-toolkit list --repo .                # 列出治理包与适配器清单
ai-toolkit init --target <dir> ...      # 初始化项目配置
ai-toolkit install --target <dir> ...   # 安装治理内容
ai-toolkit doctor --target <dir> ...    # 健康检查
ai-toolkit diff --target <dir> ...      # 比对差异
ai-toolkit update --target <dir> ...    # 更新治理内容
ai-toolkit pin --target <dir> ...       # 锁定治理包版本
ai-toolkit validate-repo --repo .       # 验证治理仓

开发工作流

# 构建
npm run build

# 运行测试
npm run test

# 端到端测试
npm run test:e2e

# 验证治理仓
npm run validate

发布流程

发布前会自动执行 prepack 脚本，将 shared/、packages/、tools/、schemas/ 复制到包根目录：

npm publish --workspace @legukeji/ai-toolkit

详见 ../scripts/prepare-package.mjs。