ccjk 7.0.0 → 7.0.2

package/skills/ccjk-config/SKILL.md

@@ -1,301 +0,0 @@
----
-name: ccjk-config
-description: "CRITICAL: Use for general CCJK configuration questions. Triggers on: ccjk config, ccjk configuration, ccjk settings"
-parents: ["ccjk"]
----
-
-# CCJK Config Skill
-
-> **Parent**: ccjk (inherits shared defaults and patterns)
-> **Purpose**: Handle general CCJK configuration management
-
-## 🎯 Quick Start
-
-**IMPORTANT**: Before generating config code, read `../ccjk/references/ccjk-defaults.md` for shared configuration patterns.
-
-## 🔄 Inherited from Parent
-
-From `ccjk` parent skill, this child skill inherits:
-- ✅ Default configuration structure
-- ✅ Cross-platform config paths
-- ✅ Validation patterns
-- ✅ Merge strategies
-
-See: [../ccjk/SKILL.md](../ccjk/SKILL.md)
-
-## 📋 CCJK Configuration Structure
-
-### Complete Config Schema
-```typescript
-// Inherited from ccjk-defaults.md
-interface CCJKConfig {
-  // Core settings
-  version: string
-  environment: 'development' | 'production' | 'test'
-
-  // API provider (inherited from layer1-api)
-  apiProvider: {
-    name: string  // 'anthropic', '302.ai', 'glm', etc.
-    apiKey: string
-    baseURL?: string
-    model?: string
-  }
-
-  // MCP servers (inherited from ccjk-mcp)
-  mcpServers: Record<string, MCPConfig>
-
-  // Workflows (inherited from layer1-workflow)
-  workflows: Record<string, WorkflowConfig>
-
-  // Sync (inherited from ccjk-sync)
-  sync: SyncConfig
-
-  // Features
-  features: {
-    cloudSync: boolean
-    remoteExecution: boolean
-    errorTerminator: boolean
-    skillsAutoLoad: boolean
-  }
-}
-```
-
-## 🎨 Child-Specific Features
-
-### Feature 1: Config Validation
-```typescript
-// Validate configuration (inherited patterns)
-async function validateConfig(config: CCJKConfig) {
-  const schema = CCJKConfigSchema
-
-  try {
-    await schema.validate(config)
-    return { valid: true }
-  } catch (error) {
-    return {
-      valid: false,
-      errors: error.errors
-    }
-  }
-}
-```
-
-### Feature 2: Config Merge
-```typescript
-// Merge user config with defaults (inherited pattern)
-async function mergeConfig(userConfig: Partial<CCJKConfig>) {
-  const defaults = await loadDefaults()
-
-  // Deep merge (inherited from ccjk-defaults.md)
-  return deepMerge(defaults, userConfig)
-}
-```
-
-### Feature 3: Config Migration
-```typescript
-// Migrate config from old version
-async function migrateConfig(oldConfig: any, targetVersion: string) {
-  const migrations = [
-    // v4 → v5
-    (config) => ({
-      ...config,
-      version: '5.0.0',
-      features: {
-        ...config.features,
-        skillsAutoLoad: true  // New in v5
-      }
-    })
-  ]
-
-  let migrated = oldConfig
-  for (const migration of migrations) {
-    if (semver.lt(migrated.version, targetVersion)) {
-      migrated = migration(migrated)
-    }
-  }
-
-  return migrated
-}
-```
-
-## 🚀 Override from Parent
-
-### Override: Config-Specific Error Handling
-```typescript
-// PARENT pattern (from ccjk-defaults.md):
-throw new CCJKError('Failed to load config', 'CONFIG_LOAD_FAILED')
-
-// CHILD override (config-specific):
-throw new CCJKError(
-  'Invalid configuration: Missing required field',
-  'CONFIG_VALIDATION_FAILED',
-  {
-    field: 'apiProvider.apiKey',
-    required: true,
-    suggestion: 'Set CCJK_API_KEY environment variable'
-  }
-)
-```
-
-## 📊 Config-Specific Patterns
-
-### Pattern 1: Config Hierarchy
-```typescript
-// Config loading priority (highest to lowest)
-async function loadConfigWithPriority() {
-  const sources = [
-    process.env.CCJK_CONFIG,  // Environment override
-    './.ccjk/config.json',    // Project config
-    path.join(os.homedir(), '.ccjk', 'config.json')  // User config
-  ]
-
-  for (const source of sources) {
-    if (source && existsSync(source)) {
-      return await loadConfig(source)
-    }
-  }
-
-  // Fallback to defaults
-  return await loadDefaults()
-}
-```
-
-### Pattern 2: Config Watcher
-```typescript
-// Watch config file for changes
-function watchConfig(callback: (config) => void) {
-  const watcher = chokidar.watch(getPath('config.json'))
-
-  watcher.on('change', async () => {
-    const newConfig = await loadConfig()
-    await validateConfig(newConfig)
-    callback(newConfig)
-  })
-
-  return watcher
-}
-```
-
-### Pattern 3: Config Encryption
-```typescript
-// Encrypt sensitive config fields (inherited from security patterns)
-async function encryptConfig(config: CCJKConfig) {
-  const sensitive = ['apiProvider.apiKey', 'sync.token']
-
-  for (const field of sensitive) {
-    const value = getNestedValue(config, field)
-    if (value) {
-      const encrypted = await encrypt(value, MASTER_KEY)
-      setNestedValue(config, field, encrypted)
-    }
-  }
-
-  return config
-}
-```
-
-## 🔧 CCJK Config Tools
-
-### Tool 1: Config Getter
-```typescript
-// Get config value with path support
-function getConfigValue(config: CCJKConfig, path: string) {
-  return getNestedValue(config, path)
-}
-
-// Usage
-const apiKey = getConfigValue(config, 'apiProvider.apiKey')
-```
-
-### Tool 2: Config Setter
-```typescript
-// Set config value with path support
-function setConfigValue(config: CCJKConfig, path: string, value: any) {
-  setNestedValue(config, path, value)
-  return config
-}
-
-// Usage
-setConfigValue(config, 'features.cloudSync', true)
-```
-
-### Tool 3: Config Reset
-```typescript
-// Reset config to defaults
-async function resetConfig(options: {
-  keepAPIKey?: boolean
-  keepMCP?: boolean
-}) {
-  const defaults = await loadDefaults()
-
-  if (options.keepAPIKey) {
-    const current = await loadConfig()
-    defaults.apiProvider.apiKey = current.apiProvider.apiKey
-  }
-
-  if (options.keepMCP) {
-    const current = await loadConfig()
-    defaults.mcpServers = current.mcpServers
-  }
-
-  await saveConfig(defaults)
-  console.log('✅ Config reset to defaults')
-}
-```
-
-## 🔗 Config + Skills Integration
-
-### Config for ccjk-init
-```typescript
-// Config initialization (uses ccjk-init patterns)
-const initConfig = {
-  version: '5.0.0',
-  environment: 'production',
-  apiProvider: {
-    name: 'anthropic',
-    apiKey: await promptForAPIKey()
-  }
-}
-```
-
-### Config for ccjk-mcp
-```typescript
-// MCP configuration (uses ccjk-mcp patterns)
-const mcpConfig = {
-  mcpServers: {
-    'ccjk-docs': CCJK_DEFAULT_MCP['ccjk-docs'],
-    ...userMCPServers
-  }
-}
-```
-
-### Config for ccjk-sync
-```typescript
-// Sync configuration (uses ccjk-sync patterns)
-const syncConfig = {
-  sync: {
-    adapter: 'local',
-    enabled: true,
-    autoSync: false
-  }
-}
-```
-
-## 🔗 Related Skills
-
-- **Parent**: [ccjk](../ccjk/SKILL.md) - Shared defaults
-- **Siblings**: [ccjk-init](../ccjk-init/SKILL.md), [ccjk-mcp](../ccjk-mcp/SKILL.md), [ccjk-sync](../ccjk-sync/SKILL.md)
-- **Related**: [layer1-api](../../layer1-api.md) - API provider config
-
-## 📚 References
-
-- [CCJK Defaults](../ccjk/references/ccjk-defaults.md)
-- [Platform Conventions](../ccjk/references/platform-conventions.md)
-- [Error Patterns](../ccjk/references/error-patterns.md)
-
----
-
-**Parent**: ccjk
-**Status**: ✅ Ready for use
-**Inherits**: Shared defaults + config structure
-**Extends**: Config management + validation + migration

package/skills/ccjk-init/SKILL.md

@@ -1,201 +0,0 @@
----
-name: ccjk-init
-description: "CRITICAL: Use for CCJK initialization questions. Triggers on: ccjk init, initialize ccjk, setup ccjk, install ccjk, first time setup"
-parents: ["ccjk"]
----
-
-# CCJK Init Skill
-
-> **Parent**: ccjk (inherits shared defaults and patterns)
-> **Purpose**: Handle CCJK initialization and first-time setup
-
-## 🎯 Quick Start
-
-**IMPORTANT**: Before generating code, read `../ccjk/references/ccjk-defaults.md` for shared configuration patterns.
-
-## 🔄 Inherited from Parent
-
-From `ccjk` parent skill, this child skill inherits:
-- ✅ Code generation defaults (TypeScript, ESM)
-- ✅ Cross-platform path handling
-- ✅ Error handling patterns
-- ✅ i18n patterns for user messages
-- ✅ Testing patterns (TDD, 80% coverage)
-
-See: [../ccjk/SKILL.md](../ccjk/SKILL.md)
-
-## 📋 Initialization Steps
-
-### Step 1: Environment Check
-```typescript
-// Check prerequisites
-async function checkPrerequisites() {
-  const checks = {
-    nodeVersion: checkNodeVersion(),
-    npmAvailable: checkCommand('npm'),
-    gitAvailable: checkCommand('git'),
-    permissions: checkWritePermissions()
-  }
-
-  return checks
-}
-```
-
-### Step 2: Config Creation
-```typescript
-// Create default config (inherited from ccjk-defaults.md)
-async function createConfig() {
-  const defaultConfig: CCJKConfig = {
-    version: '5.0.0',
-    apiProvider: 'anthropic',
-    mcpServers: {},
-    workflows: {},
-    features: {
-      cloudSync: false,
-      remoteExecution: false
-    }
-  }
-
-  const configPath = getPath('config.json')
-  await writeFile(configPath, JSON.stringify(defaultConfig, null, 2))
-}
-```
-
-### Step 3: Directory Setup
-```typescript
-// Create CCJK directories (inherited platform-aware paths)
-async function setupDirectories() {
-  const dirs = [
-    PATHS.config,
-    PATHS.cache,
-    PATHS.data,
-    path.join(PATHS.data, 'backup')
-  ]
-
-  for (const dir of dirs) {
-    await mkdir(dir, { recursive: true })
-  }
-}
-```
-
-## 🎨 Child-Specific Features
-
-### Feature 1: Interactive Setup
-```typescript
-// Interactive prompts (skipped in CI mode)
-async function interactiveSetup() {
-  if (process.env.CI) {
-    console.log('CI detected: using default configuration')
-    return createDefaultConfig()
-  }
-
-  // Ask user questions
-  const apiProvider = await prompt('Select API provider', ['anthropic', '302.ai'])
-  const enableCloud = await confirm('Enable cloud sync?', false)
-
-  return { apiProvider, enableCloud }
-}
-```
-
-### Feature 2: Auto-Detection
-```typescript
-// Detect existing setup
-async function detectExistingSetup() {
-  const detections = {
-    hasClaudeCode: existsFile('claude-deskop-config.json'),
-    hasMCP: existsFile('.claude/mcp.json'),
-    hasWorkflows: existsDirectory('.claude/rules')
-  }
-
-  return detections
-}
-```
-
-### Feature 3: Migration
-```typescript
-// Migrate from old CCJK version
-async function migrateFromV4() {
-  const oldConfig = path.join(os.homedir(), '.ccjk', 'v4', 'config.json')
-
-  if (existsSync(oldConfig)) {
-    console.log('Detected CCJK v4 installation')
-    const migrated = await migrateV4ToV5(oldConfig)
-    await saveConfig(migrated)
-    console.log('✅ Migration complete')
-  }
-}
-```
-
-## 🚀 Override from Parent
-
-### Override: Special Error Handling
-While the parent skill defines general error handling, init requires specific errors:
-
-```typescript
-// PARENT pattern (from ccjk-defaults.md):
-throw new CCJKError('Failed to load config', 'CONFIG_LOAD_FAILED')
-
-// CHILD override (init-specific):
-throw new CCJKError(
-  'Initialization failed: Node.js version too old',
-  'INIT_NODE_VERSION',
-  { required: '18.0.0', found: process.version }
-)
-```
-
-## 📊 Init-Specific Patterns
-
-### Pattern 1: First-Run Detection
-```typescript
-function isFirstRun(): boolean {
-  return !existsSync(getPath('config.json'))
-}
-```
-
-### Pattern 2: Backup Before Init
-```typescript
-async function backupExisting() {
-  const configPath = getPath('config.json')
-  const backupPath = path.join(PATHS.data, 'backup', `config-${Date.now()}.json`)
-
-  if (existsSync(configPath)) {
-    console.log(`Backing up existing config to ${backupPath}`)
-    await copyFile(configPath, backupPath)
-  }
-}
-```
-
-### Pattern 3: Validation After Init
-```typescript
-async function validateInstallation() {
-  const checks = [
-    'Config file exists',
-    'Directories created',
-    'Permissions correct',
-    'CLI command available'
-  ]
-
-  for (const check of checks) {
-    // Run validation
-  }
-
-  console.log('✅ Installation validated')
-}
-```
-
-## 🔗 Related Skills
-
-- **Parent**: [ccjk](../ccjk/SKILL.md) - Shared defaults
-- **Siblings**: [ccjk-mcp](../ccjk-mcp/SKILL.md), [ccjk-sync](../ccjk-sync/SKILL.md)
-
-## 📚 References
-
-- [CCJK Defaults](../ccjk/references/ccjk-defaults.md)
-- [Platform Conventions](../ccjk/references/platform-conventions.md)
-- [Error Patterns](../ccjk/references/error-patterns.md)
-
----
-
-**Parent**: ccjk
-**Status**: ✅ Ready for use
-**Inherits**: Shared defaults + code patterns