ccjk 7.0.0 → 7.0.2

package/agents/mcp-researcher.md

@@ -1,285 +0,0 @@
-# Agent: MCP Researcher
-
-> **Purpose**: Query MCP (Model Context Protocol) registry for server information
-> **Data Source**: https://registry.modelcontextprotocol.io, lib.rs
-> **Cache TTL**: 24 hours
-> **Run Mode**: Background
-
-## 🎯 What This Agent Does
-
-Researches MCP servers, their configurations, latest versions, and installation instructions from official MCP registry and community sources.
-
-## 📚 Data Sources
-
-### Primary Sources
-- **MCP Official Registry**: https://registry.modelcontextprotocol.io
-- **MCP GitHub**: https://github.com/modelcontextprotocol
-- **Awesome MCP List**: Community-maintained list
-- **Individual MCP Repos**: GitHub repositories of specific servers
-
-## 🔍 Research Queries
-
-### Common Queries
-```typescript
-// Search for MCP server
-"filesystem MCP server configuration"
-
-// Get server info
-"@modelcontextprotocol/server-filesystem version features"
-
-// List servers by category
-"MCP servers for database access"
-
-// Installation instructions
-"how to install @modelcontextprotocol/server-postgres"
-```
-
-## 📊 Cache Strategy
-
-```typescript
-const CACHE_CONFIG = {
-  mcpServers: {
-    ttl: 24 * 60 * 60 * 1000,  // 24 hours
-    key: (serverName) => `mcp:${serverName}`
-  },
-  mcpList: {
-    ttl: 12 * 60 * 60 * 1000,  // 12 hours (more frequent updates)
-    key: 'mcp:list'
-  }
-}
-```
-
-**Rationale**: MCP ecosystem is evolving rapidly with new servers and updates. 24-hour cache ensures current information while avoiding excessive API calls.
-
-## 🔄 Workflow
-
-```
-User Query: "Tell me about the filesystem MCP server"
-    ↓
-1. Check Cache
-    ↓
-2. If Cache Hit (< 24h old)
-    → Return cached server info
-    ↓
-3. If Cache Miss or Expired
-    → Query MCP registry
-    → Parse server metadata
-    → Extract: version, features, config, installation
-    → Store in cache
-    → Return to user
-```
-
-## 📋 Output Format
-
-```typescript
-interface MCPServerInfo {
-  name: string
-  version: string
-  description: string
-  repository: string
-  author: string
-  features: string[]
-  configuration: {
-    transport: 'stdio' | 'sse'
-    command?: string
-    args?: string[]
-    env?: Record<string, string>
-  }
-  installation: {
-    npm?: string
-    docker?: string
-    git?: string
-  }
-  lastUpdated: Date
-  cacheHit: boolean
-}
-```
-
-## 🎯 Key Features
-
-### 1. Server Metadata
-- Latest version number
-- Feature list
-- Configuration template
-- Installation instructions
-
-### 2. Transport Detection
-- Automatically detect stdio vs SSE
-- Provide recommendation based on use case
-- Example configurations for both
-
-### 3. Installation Guidance
-- NPM package installation
-- Docker setup (if available)
-- Git clone for development
-
-## 🔍 Query Examples
-
-### Example 1: Filesystem MCP Server
-```
-User: "How to configure filesystem MCP?"
-    ↓
-Agent: mcp-researcher
-    ↓
-Query: "filesystem MCP server @modelcontextprotocol/server-filesystem"
-    ↓
-Output:
-{
-  "name": "@modelcontextprotocol/server-filesystem",
-  "version": "2025.01.23",
-  "description": "MCP server for filesystem access",
-  "features": ["read", "write", "list", "watch"],
-  "configuration": {
-    "transport": "stdio",
-    "command": "npx",
-    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed"]
-  },
-  "installation": {
-    "npm": "npm install -g @modelcontextprotocol/server-filesystem"
-  }
-}
-```
-
-### Example 2: Database MCP Servers
-```
-User: "What MCP servers exist for databases?"
-    ↓
-Agent: mcp-researcher
-    ↓
-Query: "MCP servers database postgres mysql sqlite"
-    ↓
-Output:
-[
-  {
-    "name": "@modelcontextprotocol/server-postgres",
-    "description": "PostgreSQL database access",
-    "features": ["query", "schema", "transactions"]
-  },
-  {
-    "name": "mcp-server-sqlite",
-    "description": "SQLite database access",
-    "features": ["query", "schema", "backup"]
-  }
-]
-```
-
-## 🎨 Configuration Templates
-
-### Template 1: stdio Transport
-```json
-{
-  "mcpServers": {
-    "server-name": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/allowed/path"],
-      "transport": "stdio"
-    }
-  }
-}
-```
-
-### Template 2: SSE Transport
-```json
-{
-  "mcpServers": {
-    "server-name": {
-      "transport": "sse",
-      "url": "http://localhost:3000/sse",
-      "reconnect": true
-    }
-  }
-}
-```
-
-## ⚙️ Configuration
-
-```json
-{
-  "agent": "mcp-researcher",
-  "runMode": "background",
-  "cache": {
-    "enabled": true,
-    "ttl": 86400000
-  },
-  "sources": [
-    "https://registry.modelcontextprotocol.io",
-    "https://github.com/modelcontextprotocol"
-  ]
-}
-```
-
-## 🚫 Error Handling
-
-```typescript
-try {
-  const serverInfo = await fetchMCPInfo(serverName)
-  return serverInfo
-} catch (error) {
-  // Fallback to cached data
-  const cached = await getFromCache(`mcp:${serverName}`)
-  if (cached) {
-    return { ...cached, source: 'cache (possibly outdated)' }
-  }
-
-  // If no cache, search GitHub
-  const githubResult = await searchGitHub(serverName)
-  if (githubResult) {
-    return githubResult
-  }
-
-  throw new Error(`MCP server not found: ${serverName}`)
-}
-```
-
-## 🔐 Security Considerations
-
-### ⚠️ Security Warnings
-When providing MCP configurations, agent should:
-
-1. **Warn about file access**
-   ```typescript
-   if (server.features.includes('filesystem')) {
-     warnings.push("⚠️ Filesystem MCP server can access all files in allowed paths")
-   }
-   ```
-
-2. **Warn about network access**
-   ```typescript
-   if (server.features.includes('network')) {
-     warnings.push("⚠️ Network MCP server can make external requests")
-   }
-   ```
-
-3. **Recommend path restrictions**
-   ```typescript
-   recommendations.push("✅ Restrict filesystem access to specific directories")
-   ```
-
-## 📈 Performance Metrics
-
-- **Average Query Time**: ~1.5 seconds
-- **Cache Hit Rate**: Target > 70%
-- **Success Rate**: Target > 90%
-
-## 🔄 Related Agents
-
-- **doc-researcher**: Gets MCP documentation
-- **npm-researcher**: Gets NPM package info for MCP servers
-
-## 🔗 Related Skills
-
-- **layer1-mcp**: Uses MCP server information
-- **domain-cli**: Recommends stdio vs SSE for CLI
-- **domain-web**: Ensures CORS-compatible servers
-
-## 📚 References
-
-- [MCP Registry](https://registry.modelcontextprotocol.io)
-- [MCP Specification](https://modelcontextprotocol.io/)
-- [Official MCP Servers](https://github.com/modelcontextprotocol/servers)
-
----
-
-**Status**: ✅ Ready for implementation
-**Priority**: 🔴 High
-**Dependencies**: None (can run independently)

package/agents/npm-researcher.md

@@ -1,383 +0,0 @@
-# Agent: NPM Researcher
-
-> **Purpose**: Query npm registry for package information, versions, and metadata
-> **Data Source**: npm registry, unpkg.com, bundlephobia.com
-> **Cache TTL**: 24 hours
-> **Run Mode**: Background
-
-## 🎯 What This Agent Does
-
-Researches npm packages including versions, dependencies, file sizes, download counts, and installation instructions to help users make informed decisions about package usage.
-
-## 📚 Data Sources
-
-### Primary Sources
-- **NPM Registry**: https://www.npmjs.com
-- **Unpkg**: https://unpkg.com (package files explorer)
-- **Bundlephobia**: https://bundlephobia.com (package size analysis)
-- **GitHub**: Repository links from npm packages
-
-## 🔍 Research Queries
-
-### Common Queries
-```typescript
-// Package info
-"typescript package latest version"
-
-// Package size
-"react package size bundlephobia"
-
-// Dependencies
-"express dependencies list"
-
-// Comparison
-"webpack vs vite comparison"
-
-// Installation
-"how to install tailwindcss npm"
-```
-
-## 📊 Cache Strategy
-
-```typescript
-const CACHE_CONFIG = {
-  packageInfo: {
-    ttl: 24 * 60 * 60 * 1000,  // 24 hours
-    key: (packageName) => `npm:${packageName}`
-  },
-  packageSize: {
-    ttl: 7 * 24 * 60 * 60 * 1000,  // 7 days (package size stable)
-    key: (packageName) => `size:${packageName}`
-  },
-  dependencies: {
-    ttl: 24 * 60 * 60 * 1000,  // 24 hours
-    key: (packageName) => `deps:${packageName}`
-  }
-}
-```
-
-**Rationale**: Package metadata can change daily (new versions), but package size and structure are relatively stable.
-
-## 🔄 Workflow
-
-```
-User Query: "Tell me about the vite package"
-    ↓
-1. Check Cache
-    ↓
-2. If Cache Hit (< 24h old)
-    → Return cached package info
-    ↓
-3. If Cache Miss or Expired
-    → Query npm registry
-    → Get package metadata
-    → Fetch size from Bundlephobia
-    → Parse dependencies
-    → Store in cache
-    → Return to user
-```
-
-## 📋 Output Format
-
-```typescript
-interface NpmPackageInfo {
-  name: string
-  version: string
-  description: string
-  author: string
-  license: string
-  homepage: string
-  repository: {
-    type: string
-    url: string
-  }
-  keywords: string[]
-  dependencies?: Record<string, string>
-  devDependencies?: Record<string, string>
-  size?: {
-    gzip: string
-    size: string
-  }
-  weeklyDownloads: number
-  lastUpdated: Date
-  cacheHit: boolean
-}
-
-interface PackageComparison {
-  packages: NpmPackageInfo[]
-  comparison: {
-    smallest: string
-    largest: string
-    mostPopular: string
-    newest: string
-  }
-  recommendation: string
-}
-```
-
-## 🎯 Key Features
-
-### 1. Package Metadata
-- Latest version
-- Description and keywords
-- Author and license
-- Repository link
-- Weekly downloads
-
-### 2. Size Analysis
-- Minified size
-- Gzip size
-- Dependency tree size
-- Impact on bundle size
-
-### 3. Dependency Analysis
-- Production dependencies
-- Dev dependencies
-- Peer dependencies
-- Dependency tree visualization
-
-### 4. Package Comparison
-```typescript
-function comparePackages(packages: string[]): PackageComparison {
-  const infos = await Promise.all(
-    packages.map(pkg => fetchPackageInfo(pkg))
-  )
-
-  return {
-    packages: infos,
-    comparison: {
-      smallest: sortBySize(infos)[0].name,
-      largest: sortBySize(infos)[infos.length - 1].name,
-      mostPopular: sortByDownloads(infos)[0].name,
-      newest: sortByDate(infos)[0].name
-    },
-    recommendation: generateRecommendation(infos)
-  }
-}
-```
-
-## 🔍 Query Examples
-
-### Example 1: Package Information
-```
-User: "Tell me about vite"
-    ↓
-Agent: npm-researcher
-    ↓
-Query: "vite npm package info"
-    ↓
-Output:
-{
-  "name": "vite",
-  "version": "5.0.0",
-  "description": "Next generation frontend tooling",
-  "author": "Evan You",
-  "license": "MIT",
-  "size": {
-    "gzip": "56.3 kB",
-    "size": "185.2 kB"
-  },
-  "weeklyDownloads": 4250000,
-  "dependencies": {
-    "esbuild": "^0.19.0",
-    "postcss": "^8.4.0"
-  },
-  "installation": "npm install -D vite"
-}
-```
-
-### Example 2: Package Comparison
-```
-User: "Compare webpack and vite"
-    ↓
-Agent: npm-researcher
-    ↓
-Query: "webpack vs vite comparison bundle size"
-    ↓
-Output:
-{
-  "packages": [webpack_info, vite_info],
-  "comparison": {
-    "smallest": "vite (56 kB gzip)",
-    "largest": "webpack (420 kB gzip)",
-    "mostPopular": "vite (4.2M weekly downloads)",
-    "fastestBuild": "vite (10-100x faster)"
-  },
-  "recommendation": "✅ Use Vite for new projects (smaller, faster, modern). Use Webpack if you need extensive plugin ecosystem."
-}
-```
-
-### Example 3: Dependency Analysis
-```
-User: "What are express dependencies?"
-    ↓
-Agent: npm-researcher
-    ↓
-Query: "express npm dependencies"
-    ↓
-Output:
-{
-  "name": "express",
-  "version": "4.18.2",
-  "dependencies": {
-    "accepts": "~1.3.8",
-    "array-flatten": "1.1.1",
-    "body-parser": "1.20.1",
-    "content-disposition": "0.5.4",
-    // ... more dependencies
-  },
-  "dependencyCount": 27,
-  "totalTreeSize": "~2.1 MB",
-  "warnings": [
-    "⚠️ Some dependencies may have security vulnerabilities",
-    "ℹ️ Consider using fastify instead (smaller, faster)"
-  ]
-}
-```
-
-## 📊 Package Size Impact
-
-```typescript
-function analyzeSizeImpact(packageName: string): SizeImpact {
-  return {
-    package: packageName,
-    minified: "185.2 kB",
-    gzip: "56.3 kB",
-    impact: {
-      low: "✅ Small impact on bundle size",
-      medium: "⚠️ Moderate impact, consider code splitting",
-      high: "❌ Large impact, may affect load time"
-    },
-    alternatives: [
-      { name: "alternative-1", size: "25 kB gzip" },
-      { name: "alternative-2", size: "38 kB gzip" }
-    ]
-  }
-}
-```
-
-## 🎯 Installation Guidance
-
-### Standard Installation
-```bash
-# Production dependency
-npm install package-name
-
-# Development dependency
-npm install -D package-name
-
-# Global installation
-npm install -g package-name
-```
-
-### Version Specification
-```bash
-# Latest version
-npm install package-name
-
-# Specific version
-npm install package-name@1.2.3
-
-# Major version
-npm install package-name@^2.0.0
-
-# Compatible with version range
-npm install package-name@~1.2.0
-```
-
-## ⚙️ Configuration
-
-```json
-{
-  "agent": "npm-researcher",
-  "runMode": "background",
-  "cache": {
-    "enabled": true,
-    "ttl": 86400000
-  },
-  "sources": [
-    "https://www.npmjs.com",
-    "https://unpkg.com",
-    "https://bundlephobia.com"
-  ]
-}
-```
-
-## 🚫 Error Handling
-
-```typescript
-async function fetchPackageInfo(packageName: string): Promise<NpmPackageInfo> {
-  try {
-    const metadata = await fetchFromNPM(packageName)
-    const size = await fetchFromBundlephobia(packageName)
-
-    return {
-      ...metadata,
-      size
-    }
-  } catch (error) {
-    // Fallback to cache
-    const cached = await getFromCache(`npm:${packageName}`)
-    if (cached) {
-      return {
-        ...cached,
-        warning: '⚠️ Using cached data (fetch failed)'
-      }
-    }
-
-    // Try scoped search
-    const searchResult = await searchNPM(packageName)
-    if (searchResult) {
-      return searchResult
-    }
-
-    throw new Error(`Package not found: ${packageName}`)
-  }
-}
-```
-
-## 📈 Performance Metrics
-
-- **Average Query Time**: ~1 second
-- **Cache Hit Rate**: Target > 75%
-- **Success Rate**: Target > 95%
-
-## 🔐 Privacy & Security
-
-### Security Checks
-```typescript
-function checkSecurity(packageName: string): SecurityReport {
-  return {
-    vulnerabilities: checkKnownVulnerabilities(packageName),
-    deprecated: checkIfDeprecated(packageName),
-    licenseIssues: checkLicenseCompatibility(packageName),
-    maintenance: {
-      lastUpdate: getLastUpdateDate(packageName),
-      isActive: isActivePackage(packageName),
-      hasIssues: hasOpenSecurityIssues(packageName)
-    }
-  }
-}
-```
-
-## 🔗 Related Agents
-
-- **version-checker**: Latest version information
-- **doc-researcher**: Package documentation
-
-## 🔗 Related Skills
-
-- **layer2-best-practices**: Package selection best practices
-- **domain-web**: Frontend package recommendations
-
-## 📚 References
-
-- [NPM Registry](https://www.npmjs.com)
-- [Bundlephobia](https://bundlephobia.com)
-- [Unpkg](https://unpkg.com)
-
----
-
-**Status**: ✅ Ready for implementation
-**Priority**: 🟡 Medium
-**Dependencies**: None (can run independently)