ccjk 7.0.0 → 7.0.2

package/agents/version-checker.md

@@ -1,332 +0,0 @@
-# Agent: Version Checker
-
-> **Purpose**: Check for CCJK and related tool updates
-> **Data Source**: npm registry, GitHub releases
-> **Cache TTL**: 168 hours (7 days)
-> **Run Mode**: Background
-
-## 🎯 What This Agent Does
-
-Monitors CCJK version, related tools (CCR, CCUsage, Cometix), and dependency updates to ensure users have the latest information about available updates.
-
-## 📚 Data Sources
-
-### Primary Sources
-- **NPM Registry**: https://www.npmjs.com/package/ccjk
-- **GitHub Releases**: https://github.com/miounet11/ccjk/releases
-- **NPM Packages**:
-  - CCR: https://www.npmjs.com/package/claude-code-router
-  - CCUsage: https://www.npmjs.com/package/ccusage
-  - Cometix: https://www.npmjs.com/package/@cometix/client
-
-## 🔍 Research Queries
-
-### Common Queries
-```typescript
-// Check CCJK version
-"ccjk latest version"
-
-// Check for updates
-"ccjk updates available"
-
-// Compare versions
-"ccjk 4.0.0 vs 5.0.0"
-
-// Related tools
-"CCR latest version"
-"CCUsage latest version"
-```
-
-## 📊 Cache Strategy
-
-```typescript
-const CACHE_CONFIG = {
-  version: {
-    ttl: 168 * 60 * 60 * 1000,  // 7 days (versions don't change often)
-    key: (packageName) => `version:${packageName}`
-  },
-  releaseNotes: {
-    ttl: 168 * 60 * 60 * 1000,  // 7 days
-    key: (version) => `releases:${version}`
-  }
-}
-```
-
-**Rationale**: Version releases are infrequent (weekly/monthly). 7-day cache balance ensures we detect new versions without excessive polling.
-
-## 🔄 Workflow
-
-```
-User Query: "Is there a new version of CCJK?"
-    ↓
-1. Check Cache
-    ↓
-2. If Cache Hit (< 7 days old)
-    → Return cached version info
-    ↓
-3. If Cache Miss or Expired
-    → Query npm registry
-    → Parse version and release notes
-    → Compare with installed version
-    → Store in cache
-    → Return to user
-```
-
-## 📋 Output Format
-
-```typescript
-interface VersionInfo {
-  packageName: string
-  currentVersion: string
-  latestVersion: string
-  installedVersion?: string
-  updateAvailable: boolean
-  releaseNotes?: {
-    version: string
-    date: Date
-    changes: string[]
-  }
-  lastChecked: Date
-  cacheHit: boolean
-}
-
-interface UpdateReport {
-  ccjk: VersionInfo
-  relatedTools: {
-    ccr?: VersionInfo
-    ccusage?: VersionInfo
-    cometix?: VersionInfo
-  }
-  summary: string
-}
-```
-
-## 🎯 Key Features
-
-### 1. Version Comparison
-```typescript
-function compareVersions(installed: string, latest: string): UpdateStatus {
-  const installedSemver = semver.parse(installed)
-  const latestSemver = semver.parse(latest)
-
-  if (semver.lt(installedSemver, latestSemver)) {
-    return 'UPDATE_AVAILABLE'
-  } else if (semver.eq(installedSemver, latestSemver)) {
-    return 'UP_TO_DATE'
-  } else {
-    return 'PRERELEASE'
-  }
-}
-```
-
-### 2. Release Notes Extraction
-- Parse GitHub release notes
-- Extract changelog
-- Highlight breaking changes
-- Show new features
-
-### 3. Update Recommendations
-```typescript
-function recommendUpdate(info: VersionInfo): string {
-  if (!info.updateAvailable) {
-    return "✅ You're running the latest version!"
-  }
-
-  const majorUpdate = semver.diff(info.installedVersion, info.latestVersion) === 'major'
-  if (majorUpdate) {
-    return "⚠️ Major update available. Review breaking changes before updating."
-  }
-
-  return "🔄 Update available. Recommended to install."
-}
-```
-
-## 🔍 Query Examples
-
-### Example 1: Check CCJK Version
-```
-User: "What's the latest CCJK version?"
-    ↓
-Agent: version-checker
-    ↓
-Query: "ccjk latest version npm"
-    ↓
-Output:
-{
-  "packageName": "ccjk",
-  "currentVersion": "5.0.0",
-  "installedVersion": "4.0.0",
-  "updateAvailable": true,
-  "recommendation": "🔄 Update available. New features: Skills system, cloud sync, remote execution",
-  "releaseNotes": {
-    "version": "5.0.0",
-    "date": "2025-01-23",
-    "changes": [
-      "✨ Added Skills system with cognitive protocols",
-      "✨ Added cloud synchronization",
-      "✨ Added remote task execution",
-      "🐛 Fixed MCP connection issues",
-      "📚 Updated documentation"
-    ]
-  }
-}
-```
-
-### Example 2: Full Update Report
-```
-User: "Check for all updates"
-    ↓
-Agent: version-checker
-    ↓
-Query: "ccjk ccr ccusage cometix versions"
-    ↓
-Output:
-{
-  "ccjk": {
-    "updateAvailable": true,
-    "current": "5.0.0",
-    "installed": "4.0.0"
-  },
-  "ccr": {
-    "updateAvailable": false,
-    "current": "1.2.3",
-    "installed": "1.2.3"
-  },
-  "ccusage": {
-    "updateAvailable": true,
-    "current": "2.0.0",
-    "installed": "1.5.0"
-  },
-  "cometix": {
-    "updateAvailable": false,
-    "current": "3.1.0",
-    "installed": "3.1.0"
-  },
-  "summary": "2 updates available: CCJK (v5.0.0) and CCUsage (v2.0.0)"
-}
-```
-
-## 🚀 Update Commands
-
-### Automatic Update (Recommended)
-```bash
-# Update CCJK to latest
-npm update -g ccjk
-
-# Update specific package
-npm update -g @miounet11/ccr
-```
-
-### Manual Update
-```bash
-# Uninstall old version
-npm uninstall -g ccjk
-
-# Install new version
-npm install -g ccjk@latest
-```
-
-## ⚙️ Configuration
-
-```json
-{
-  "agent": "version-checker",
-  "runMode": "background",
-  "cache": {
-    "enabled": true,
-    "ttl": 604800000
-  },
-  "monitoredPackages": [
-    "ccjk",
-    "claude-code-router",
-    "ccusage",
-    "@cometix/client"
-  ],
-  "sources": [
-    "https://www.npmjs.com",
-    "https://github.com/miounet11/ccjk/releases"
-  ]
-}
-```
-
-## 🚫 Error Handling
-
-```typescript
-async function checkVersion(packageName: string): Promise<VersionInfo> {
-  try {
-    const info = await fetchFromNPM(packageName)
-    return parseVersionInfo(info)
-  } catch (error) {
-    // Fallback to GitHub
-    try {
-      const githubInfo = await fetchFromGitHub(packageName)
-      return parseVersionInfo(githubInfo)
-    } catch (githubError) {
-      // Last resort: Check cache
-      const cached = await getFromCache(`version:${packageName}`)
-      if (cached) {
-        return {
-          ...cached,
-          source: 'cache (fetch failed, data may be outdated)',
-          warning: '⚠️ Could not fetch latest version info'
-        }
-      }
-
-      throw new Error(`Failed to check version for ${packageName}`)
-    }
-  }
-}
-```
-
-## 🔔 Notification Strategy
-
-### When to Notify
-- ✅ **New major version**: Always notify
-- ✅ **Security updates**: Immediate notification
-- ⚠️ **Minor versions**: Weekly digest
-- ℹ️ **Patch versions**: Silent update available
-
-### Notification Format
-```typescript
-interface VersionNotification {
-  type: 'major' | 'minor' | 'patch' | 'security'
-  priority: 'high' | 'medium' | 'low'
-  message: string
-  actionItems: string[]
-}
-```
-
-## 📈 Performance Metrics
-
-- **Average Check Time**: ~0.5 seconds
-- **Cache Hit Rate**: Target > 90%
-- **Success Rate**: Target > 98%
-
-## 🔐 Privacy & Security
-
-- ✅ No personal data sent
-- ✅ Only public registry accessed
-- ✅ No tracking of version checks
-- ✅ Local storage only
-
-## 🔄 Related Agents
-
-- **doc-researcher**: Gets release documentation
-- **npm-researcher**: Detailed package information
-
-## 🔗 Related Skills
-
-- **layer2-best-practices**: Update best practices
-- **domain-cloud**: Cloud update notifications
-
-## 📚 References
-
-- [NPM Registry](https://www.npmjs.com/package/ccjk)
-- [GitHub Releases](https://github.com/miounet11/ccjk/releases)
-- [SemVer Specification](https://semver.org/)
-
----
-
-**Status**: ✅ Ready for implementation
-**Priority**: 🟡 Medium (versions don't change frequently)
-**Dependencies**: None (can run independently)

package/hooks/hooks.json

@@ -1,15 +0,0 @@
-{
-  "hooks": {
-    "UserPromptSubmit": [
-      {
-        "matcher": "(?i)(ccjk|claude code|config|mcp|workflow|api provider|初始化|init|安装|install|配置|不工作|not working|错误|error|失败|fail|E0\\d{3}|CCJK-\\d{3}|setup|配置文件|config\\.json|settings|claude_desktop_config|toml|prompt|output style|工作流|技能|skill|agent|插件|plugin|同步|sync|云服务|cloud|远程|remote|路由|router|代理|proxy|使用量|usage|分析|analytics|状态栏|status line|cometix|ccr|ccusage|检查更新|check update|更新|update|版本|version|卸载|uninstall|切换|switch|诊断|diagnose|调试|debug|问题|problem|怎么|how|如何|why|为什么|what|哪个|which|推荐|recommend|最佳实践|best practice|指南|guide|教程|tutorial|帮助|help|支持|support)",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/.claude/hooks/ccjk-diagnose-hook.sh"
-          }
-        ]
-      }
-    ]
-  }
-}

package/skills/ccjk/SKILL.md

@@ -1,224 +0,0 @@
----
-name: ccjk
-description: "CRITICAL: Parent skill for CCJK. Use for general CCJK knowledge and questions. Triggers on: ccjk, CCJK, Claude Code configuration"
----
-
-# CCJK Parent Skill
-
-> **Role**: Parent skill for all CCJK-related child skills
-> **Purpose**: Provide shared knowledge and baseline configuration used by all child skills
-
-## 🎯 Overview
-
-This is the **parent skill** for the ccjk skill family. Child skills inherit:
-- Shared configuration (`references/ccjk-defaults.md`)
-- Code style guidelines
-- Platform conventions
-- Error handling patterns
-
-Child skills:
-- `ccjk-init` - Initialization workflows
-- `ccjk-mcp` - MCP configuration
-- `ccjk-sync` - Cloud sync
-- `ccjk-config` - General configuration
-
-## 📁 Directory Structure
-
-```
-skills/ccjk/
-├── SKILL.md                      # This file (parent)
-└── references/
-    ├── ccjk-defaults.md          # Shared defaults (all children)
-    ├── coding-standards.md       # TypeScript, i18n standards
-    ├── platform-conventions.md   # Windows, macOS, Linux differences
-    └── error-patterns.md         # Common error patterns
-```
-
-## 📋 Shared Defaults
-
-All child skills SHOULD reference the shared defaults in `references/ccjk-defaults.md`:
-
-```markdown
-[In child skill]
-## Before generating code
-**IMPORTANT**: Read `../ccjk/references/ccjk-defaults.md` for shared configuration.
-```
-
-### What child skills inherit:
-
-1. **Code Generation Defaults**
-   - TypeScript version (5.4+)
-   - Module system (ESM)
-   - Error handling patterns
-
-2. **Configuration Patterns**
-   - Config file paths (cross-platform)
-   - Environment variable patterns
-   - Fallback strategies
-
-3. **Platform Conventions**
-   - Path separators
-   - Encoding standards
-   - Line endings
-
-## 🔗 Inherited References
-
-Child skills can reference these shared files:
-
-### 1. ccjk-defaults.md
-- Shared configuration defaults
-- Code generation patterns
-- Error handling templates
-
-### 2. coding-standards.md
-- TypeScript strict mode
-- i18n usage patterns
-- ESLint rules
-
-### 3. platform-conventions.md
-- Windows considerations (PowerShell, CMD)
-- macOS/Linux differences
-- Termux support notes
-
-### 4. error-patterns.md
-- Common error types
-- Debugging approaches
-- Log locations
-
-## 💡 Usage in Child Skills
-
-### Example 1: ccjk-init Skill
-
-```markdown
----
-name: ccjk-init
-description: "CRITICAL: Use for CCJK initialization questions. Triggers on: init, initialize, setup, install ccjk"
-parents: ["ccjk"]
----
-
-# CCJK Initialization
-
-**IMPORTANT**: Before generating code, read `../ccjk/references/ccjk-defaults.md`.
-
-## Initialization Steps
-[Child-specific content...]
-
-## Inherits from parent:
-- Default configurations
-- Platform-specific paths
-- Error handling patterns
-```
-
-### Example 2: ccjk-mcp Skill
-
-```markdown
----
-name: ccjk-mcp
-description: "CRITICAL: Use for CCJK MCP setup. Triggers on: ccjk mcp, ccjk-mcp"
-parents: ["ccjk"]
----
-
-# CCJK MCP Configuration
-
-**IMPORTANT**: Before generating MCP configs, read `../ccjk/references/ccjk-defaults.md`.
-
-## Parent-Inherited Patterns:
-- Error handling for MCP failures
-- Cross-platform config paths
-- Secure credential handling
-
-[Child-specific MCP content...]
-```
-
-## 🎯 Best Practices
-
-### DO ✅
-
-1. **Always declare parent in child skill**
-   ```markdown
-   ---
-   parents: ["ccjk"]
-   ---
-   ```
-
-2. **Reference shared defaults**
-   ```markdown
-   **IMPORTANT**: Read `../ccjk/references/ccjk-defaults.md`.
-   ```
-
-3. **Override defaults when needed**
-   ```markdown
-   **OVERRIDE**: For this specific use case, we do X instead of default Y.
-   ```
-
-4. **Add child-specific extensions**
-   ```markdown
-   ## From ccjk-parent:
-   - [x] Default config
-   - [x] Error handling
-
-   ## Child additions:
-   - [x] MCP-specific patterns
-   - [x] Tool setup
-   ```
-
-### DON'T ❌
-
-1. **Don't duplicate parent content**
-   ❌ Bad: Repeating entire ccjk-defaults.md in child
-   ✅ Good: Reference it with link
-
-2. **Don't override without explanation**
-   ❌ Bad: "Use `require()` instead of `import`"
-   ✅ Good: "Override: Use `require()` for CommonJS compatibility"
-
-3. **Don't skip parent reference**
-   ❌ Bad: Child skill without `parents: ["ccjk"]`
-   ✅ Good: Explicitly declare parent
-
-## 📋 Maintenance Benefits
-
-### 1. Centralized Updates
-When updating defaults or patterns:
-- **Before**: Update 5-10 child skills individually
-- **After**: Update `ccjk/references/ccjk-defaults.md` once
-- **Benefit**: Changes propagate to all children automatically
-
-### 2. Consistency Across Skills
-- All child skills use same configuration patterns
-- Same error handling approach
-- Same code style standards
-- Reduced contradictions or conflicts
-
-### 3. Reduced Maintenance Cost
-```
-Without inheritance:
-├─ Update TypeScript version → 10 skills × 5 minutes = 50 minutes
-├─ Update error pattern → 10 skills × 3 minutes = 30 minutes
-└─ Total: 80 minutes per change
-
-With inheritance:
-├─ Update ccjk-defaults.md → 1 file × 5 minutes = 5 minutes
-└─ Total: 5 minutes per change
-
-Savings: 84% time reduction (80 min → 5 min)
-```
-
-## 🔗 Child Skill Quick Reference
-
-| Child Skill | Purpose | Parent Dependencies |
-|-------------|---------|:-------------------:|
-| `ccjk-init` | Initialization workflows | ccjk-defaults, platform-conventions |
-| `ccjk-mcp` | MCP configuration | ccjk-defaults, error-patterns |
-| `ccjk-sync` | Cloud sync setup | ccjk-defaults, platform-conventions |
-| `ccjk-config` | General config | ccjk-defaults, coding-standards |
-
-## 📚 References
-
-- [Parent: ccjk-defaults.md](./references/ccjk-defaults.md)
-- [Child skill example: ccjk-init](../ccjk-init/SKILL.md)
-
----
-
-**Status**: ✅ Parent skill configured
-**Next**: Create child skills with inheritance links