ops-toolkit 1.1.0

package/.commitlintrc.js

@@ -0,0 +1,25 @@
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [
+      2,
+      'always',
+      [
+        'feat',     // 新功能
+        'fix',      // 修复
+        'docs',     // 文档
+        'style',    // 格式
+        'refactor', // 重构
+        'perf',     // 性能
+        'test',     // 测试
+        'chore',    // 构建过程或辅助工具的变动
+        'ci',       // CI配置
+        'build',    // 构建系统
+        'revert',   // 回滚
+      ],
+    ],
+    'subject-max-length': [2, 'always', 50],
+    'body-max-line-length': [2, 'always', 72],
+    'subject-case': [2, 'never', ['start-case', 'pascal-case', 'upper-case']],
+  },
+};

package/.env.example

@@ -0,0 +1,25 @@
+# Environment variables for ops-toolkit
+# Copy this file to .env and fill in your values
+
+# Debug mode
+DEBUG=false
+NODE_ENV=development
+
+# CLI Options
+OPS_CONFIG_PATH=~/.ops-toolkit
+OPS_LOG_LEVEL=info
+
+# API Keys (if needed)
+# API_KEY=your_api_key_here
+
+# Deployment settings
+DEPLOY_ENV=development
+DEPLOY_TIMEOUT=300000
+
+# Monitoring settings
+MONITOR_REFRESH_INTERVAL=1000
+MONITOR_HISTORY_SIZE=100
+
+# Log settings
+LOG_MAX_LINES=1000
+LOG_DEFAULT_PATH=/var/log

package/.husky/commit-msg

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+. "$(dirname "$0")/_/husky.sh"
+
+npx --no -- commitlint --edit "${1}"

package/.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+. "$(dirname "$0")/_/husky.sh"
+
+bun run lint-staged

package/.opencode/README.md

@@ -0,0 +1,320 @@
+# OpenCode 自定义命令
+
+ops-toolkit 项目的 OpenCode 自定义命令配置，提高开发效率。
+
+## 📁 命令文件位置
+
+命令文件位于: `.opencode/command/`
+
+## 🚀 可用命令
+
+### `/add-cmd <command-name>`
+
+添加新的 CLI 命令。
+
+**用法**:
+
+```
+/add-cmd monitor
+```
+
+**功能**:
+
+- 在 `src/commands/` 创建命令文件
+- 在 `src/index.ts` 注册命令
+- 包含完整的 TypeScript 类型定义
+- 添加错误处理和彩色输出
+
+**示例**:
+
+```
+/add-cmd backup
+```
+
+---
+
+### `/fix <issue-description>`
+
+修复代码问题并运行检查。
+
+**用法**:
+
+```
+/fix monitor command not showing correct output
+```
+
+**功能**:
+
+- 分析问题并提供解决方案
+- 确保 TypeScript 严格模式
+- 包含适当的错误处理
+- 运行类型检查和 lint
+- 运行测试验证修复
+
+**示例**:
+
+```
+/fix TypeError: Cannot read property 'x' of undefined
+```
+
+---
+
+### `/test`
+
+运行测试套件并分析结果。
+
+**用法**:
+
+```
+/test
+```
+
+**功能**:
+
+- 运行所有测试
+- 识别失败的测试
+- 分析失败原因
+- 建议修复方案
+- 检查测试覆盖率
+- 推荐额外的测试用例
+
+**示例**:
+
+```
+/test
+```
+
+---
+
+### `/release`
+
+准备项目发布。
+
+**用法**:
+
+```
+/release
+```
+
+**功能**:
+
+- 检查测试是否通过
+- 运行类型检查
+- 运行 lint 修复
+- 查看最近的提交
+- 建议版本号变更类型
+- 建议提交信息格式
+
+**示例**:
+
+```
+/release
+```
+
+---
+
+### `/review <location>`
+
+审查代码更改。
+
+**用法**:
+
+```
+/review src/commands/monitor/index.ts
+```
+
+**功能**:
+
+- 代码质量检查
+- 性能分析
+- 安全审查
+- 代码风格检查
+- 测试覆盖率检查
+
+**审查清单**:
+
+1. ✅ TypeScript 最佳实践
+2. ✅ 没有使用 `any` 类型
+3. ✅ 良好的错误处理
+4. ✅ 性能优化
+5. ✅ 安全性检查
+6. ✅ 遵循 ESLint 规则
+
+**示例**:
+
+```
+/review src/utils/logger.ts
+```
+
+---
+
+### `/build`
+
+构建并验证项目。
+
+**用法**:
+
+```
+/build
+```
+
+**功能**:
+
+- 运行类型检查
+- 运行 lint
+- 执行构建
+- 运行测试
+- 报告所有问题
+
+**检查顺序**:
+
+1. Type Check → Lint → Build → Test
+
+**示例**:
+
+```
+/build
+```
+
+---
+
+### `/add-pkg <package-name>`
+
+添加新的依赖包。
+
+**用法**:
+
+```
+/add-pkg axios
+```
+
+**功能**:
+
+- 确定是运行时还是开发依赖
+- 使用 `bun add` 安装
+- 更新导入语句
+- 添加类型定义（如果需要）
+- 验证兼容性
+
+**示例**:
+
+```
+/add-pkg dotenv
+```
+
+---
+
+### `/debug <issue-description>`
+
+获取调试帮助。
+
+**用法**:
+
+```
+/debug async function not awaiting promise
+```
+
+**功能**:
+
+- 分析错误
+- 定位错误位置
+- 检查堆栈跟踪
+- 建议调试步骤
+- 提供修复方案
+- 验证修复
+
+**示例**:
+
+```
+/debug process.exit(1) not exiting program
+```
+
+---
+
+## 💡 使用技巧
+
+### 组合使用命令
+
+**添加新功能**:
+
+```
+1. /add-cmd my-command
+2. /review src/commands/my-command
+3. /test
+4. /release
+```
+
+**修复 Bug**:
+
+```
+1. /fix error message
+2. /review src/fixed-file.ts
+3. /test
+4. /build
+```
+
+**代码审查**:
+
+```
+1. /review src/changed-files/
+2. /test
+3. /build
+4. /release
+```
+
+### 参数使用
+
+大多数命令支持参数：
+
+```
+/add-cmd backup      # 添加 backup 命令
+/fix monitor bug    # 修复 monitor 命令的 bug
+/review src/utils/  # 审查 src/utils/ 目录
+```
+
+### Shell 命令集成
+
+某些命令会自动运行 shell 命令：
+
+- `/test` → 运行 `bun test`
+- `/build` → 运行 `bun run typecheck`, `bun run lint`, `bun run build`, `bun test`
+- `/release` → 运行 `git log`, `bun test`, `bun run typecheck`
+
+---
+
+## 🔧 自定义命令
+
+你可以创建自己的命令文件:
+
+1. 在 `.opencode/command/` 创建新的 `.md` 文件
+2. 文件名即为命令名（如 `my-cmd.md` → `/my-cmd`）
+3. 使用 frontmatter 配置命令属性
+
+**Frontmatter 选项**:
+
+```yaml
+---
+description: 命令描述
+agent: build | general
+model: anthropic/claude-3-5-sonnet-20241022
+---
+```
+
+**可用的占位符**:
+
+- `$ARGUMENTS` - 所有参数
+- `$1`, `$2`, `$3` - 位置参数
+- !`command` - Shell 命令输出
+- @filename - 文件引用
+
+---
+
+## 📚 更多资源
+
+- [OpenCode 命令文档](https://opencode.ai/docs/commands/)
+- [项目 AGENTS.md](../AGENTS.md)
+- [开发指南](./DEVELOPMENT_GUIDE.md)
+
+---
+
+**提示**: 使用 `/help` 查看所有可用命令。

package/.opencode/command/add-cmd.md

@@ -0,0 +1,38 @@
+---
+description: Add a new CLI command
+agent: build
+model: anthropic/claude-3-5-sonnet-20241022
+---
+
+Create a new CLI command named $ARGUMENTS for ops-toolkit.
+
+Follow these steps:
+
+1. Create command file in src/commands/$ARGUMENTS/index.ts
+2. Implement the command handler with TypeScript
+3. Register the command in src/index.ts using commander.js
+4. Add type definitions in src/types/ if needed
+5. Include error handling with try-catch
+6. Use chalk for colored terminal output
+
+Command structure:
+
+```typescript
+import { program } from 'commander';
+import chalk from 'chalk';
+
+program
+  .command('$ARGUMENTS')
+  .description('Description here')
+  .action(async () => {
+    try {
+      console.log(chalk.blue('$ARGUMENTS command'));
+      // Implementation here
+    } catch (error) {
+      console.error(chalk.red('❌ Error:'), error);
+      process.exit(1);
+    }
+  });
+```
+
+Make sure to follow the project's code style and conventions as defined in AGENTS.md.

package/.opencode/command/add-pkg.md

@@ -0,0 +1,28 @@
+---
+description: Add a new dependency
+agent: build
+---
+
+Add $ARGUMENTS to the project.
+
+Determine if it's a runtime dependency or dev dependency:
+
+- Runtime: Use `bun add <package>`
+- Dev: Use `bun add -d <package>`
+
+After adding:
+
+1. Check package.json for proper installation
+2. Update src/index.ts to import and use the package
+3. Add type definitions if needed (@types/package)
+4. Run `bun run typecheck` to verify types
+5. Run `bun run lint:fix` to check for issues
+6. Add basic usage example or documentation
+
+Ensure the package is compatible with:
+
+- Bun runtime
+- Project's TypeScript version (5.3.3+)
+- Node version requirement (18.0.0+)
+
+If the package replaces existing functionality, help refactor the code to use the new package.

package/.opencode/command/build.md

@@ -0,0 +1,27 @@
+---
+description: Build and verify project
+agent: build
+---
+
+Build and verify ops-toolkit project.
+
+Run these checks in order:
+
+1. **Type Check**
+   Execute: !`bun run typecheck`
+   Report any TypeScript errors
+
+2. **Lint**
+   Execute: !`bun run lint`
+   Report any linting issues
+
+3. **Build**
+   Execute: !`bun run build`
+   Verify build completes successfully
+
+4. **Test**
+   Execute: !`bun test`
+   Report any test failures
+
+Summary the results and identify any issues that need to be fixed before deployment.
+If all checks pass, confirm the project is ready for production.

package/.opencode/command/debug.md

@@ -0,0 +1,36 @@
+---
+description: Get help with debugging
+agent: build
+---
+
+Help debug the following issue: $ARGUMENTS
+
+Debugging approach:
+
+1. **Analyze the error**
+   - Identify error type and message
+   - Locate where the error occurs
+   - Check stack trace if available
+
+2. **Check common issues**
+   - Missing dependencies
+   - Type errors
+   - Async/await issues
+   - Missing error handling
+
+3. **Suggest debugging steps**
+   - Add appropriate breakpoints or console.log statements
+   - Verify input/output values
+   - Check environment variables
+
+4. **Provide fix**
+   - Write corrected code
+   - Ensure proper error handling
+   - Add comments explaining the fix
+
+5. **Verify fix**
+   - Run `bun run typecheck`
+   - Run `bun run lint:fix`
+   - Test the fix manually if possible
+
+Focus on providing a clear explanation of what went wrong and how to prevent similar issues in the future.

package/.opencode/command/fix.md

@@ -0,0 +1,23 @@
+---
+description: Fix code issues and run checks
+agent: build
+model: anthropic/claude-3-5-sonnet-20241022
+---
+
+Fix the following code issue: $ARGUMENTS
+
+Analyze the problem and provide a solution that:
+
+1. Follows TypeScript strict mode
+2. Includes proper error handling
+3. Uses project's utilities (chalk for colors, etc.)
+4. Passes ESLint checks
+5. Passes type checking
+
+After fixing, run these checks to verify:
+
+- `bun run typecheck` - TypeScript type checking
+- `bun run lint:fix` - ESLint auto-fix
+- `bun test` - Run tests if applicable
+
+Make sure the fix doesn't break existing functionality.

package/.opencode/command/release.md

@@ -0,0 +1,28 @@
+---
+description: Prepare for release
+agent: build
+---
+
+Prepare the ops-toolkit project for a new release.
+
+Complete these steps:
+
+1. Check if all tests pass: !`bun test`
+2. Run type checking: !`bun run typecheck`
+3. Run lint and fix issues: !`bun run lint:fix`
+4. Review recent changes: !`git log --oneline -5`
+
+Based on the changes, suggest:
+
+- Proper conventional commit message type (feat, fix, refactor, docs, etc.)
+- Version bump type (major, minor, patch)
+- Any additional documentation updates needed
+- Breaking changes that need to be mentioned
+
+After review, use:
+
+- `bun run release` - Standard patch release
+- `bun run release:minor` - Minor feature release
+- `bun run release:major` - Major breaking change release
+
+Ensure the changelog is properly updated and commit messages follow the project's conventional commits format.

package/.opencode/command/review.md

@@ -0,0 +1,36 @@
+---
+description: Review code changes
+agent: build
+---
+
+Review the code changes in the following location: $ARGUMENTS
+
+Review checklist:
+
+1. **Code Quality**
+   - Follows TypeScript best practices
+   - Uses proper types (no `any`)
+   - Has good error handling
+   - Uses project utilities appropriately
+
+2. **Performance**
+   - No blocking operations in event loop
+   - Efficient use of async/await
+   - Proper resource cleanup
+
+3. **Security**
+   - No exposed secrets or credentials
+   - Proper input validation
+   - Safe handling of user input
+
+4. **Style**
+   - Follows ESLint rules
+   - Uses chalk for terminal output
+   - Consistent code style
+
+5. **Testing**
+   - Has adequate test coverage
+   - Tests cover edge cases
+   - Tests are maintainable
+
+Provide specific suggestions for improvements and highlight any issues that need to be addressed before merging.

package/.opencode/command/test.md

@@ -0,0 +1,25 @@
+---
+description: Run tests and analyze results
+agent: build
+---
+
+Run the test suite and analyze the results.
+
+Execute: !`bun test`
+
+Based on the test results:
+
+1. Identify any failing tests
+2. Analyze why tests are failing
+3. Suggest fixes for failing tests
+4. Check for test coverage gaps
+5. Recommend additional test cases if needed
+
+If tests are failing, help me fix them by:
+
+- Updating test assertions
+- Fixing the implementation code
+- Adding proper mocking if needed
+- Handling edge cases properly
+
+Focus on ensuring all tests pass and the codebase remains robust.

package/.prettierrc

@@ -0,0 +1,16 @@
+{
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": true,
+  "singleQuote": true,
+  "quoteProps": "as-needed",
+  "trailingComma": "es5",
+  "bracketSpacing": true,
+  "bracketSameLine": false,
+  "arrowParens": "avoid",
+  "endOfLine": "lf",
+  "proseWrap": "preserve",
+  "htmlWhitespaceSensitivity": "css",
+  "embeddedLanguageFormatting": "auto"
+}

package/.release-it.json

@@ -0,0 +1,29 @@
+{
+  "git": {
+    "commit": true,
+    "tag": true,
+    "push": true,
+    "commitMessage": "chore(release): ${version}",
+    "tagName": "v${version}"
+  },
+  "github": {
+    "release": true,
+    "owner": "username",
+    "repo": "ops-toolkit"
+  },
+  "npm": {
+    "publish": true,
+    "access": "public"
+  },
+  "hooks": {
+    "before:init": ["bun run lint", "bun run typecheck", "bun run test"],
+    "after:bump": ["bun run build"],
+    "after:release": ["git push origin HEAD"]
+  },
+  "plugins": {
+    "@release-it/conventional-changelog": {
+      "preset": "angular",
+      "infile": "CHANGELOG.md"
+    }
+  }
+}

package/.versionrc.js

@@ -0,0 +1,18 @@
+module.exports = {
+  types: [
+    { type: 'feat', section: 'Features' },
+    { type: 'fix', section: 'Bug Fixes' },
+    { type: 'docs', section: 'Documentation' },
+    { type: 'style', section: 'Styles' },
+    { type: 'refactor', section: 'Code Refactoring' },
+    { type: 'perf', section: 'Performance Improvements' },
+    { type: 'test', section: 'Tests' },
+    { type: 'chore', section: 'Chores', hidden: true },
+    { type: 'ci', section: 'Continuous Integration', hidden: true },
+    { type: 'build', section: 'Builds', hidden: true },
+    { type: 'revert', section: 'Reverts' },
+  ],
+  commitUrlFormat: 'https://github.com/username/ops-toolkit/commits/{{hash}}',
+  compareUrlFormat: 'https://github.com/username/ops-toolkit/compare/{{previousTag}}...{{currentTag}}',
+  issueUrlFormat: 'https://github.com/username/ops-toolkit/issues/{{id}}',
+};