@kaitranntt/ccs 3.5.0 → 4.1.1

package/bin/utils/delegation-validator.js

@@ -0,0 +1,154 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+/**
+ * Validates delegation profiles for CCS delegation system
+ * Ensures profiles exist and have valid API keys configured
+ */
+class DelegationValidator {
+  /**
+   * Validate a delegation profile
+   * @param {string} profileName - Name of profile to validate (e.g., 'glm', 'kimi')
+   * @returns {Object} Validation result { valid: boolean, error?: string, settingsPath?: string }
+   */
+  static validate(profileName) {
+    const homeDir = os.homedir();
+    const settingsPath = path.join(homeDir, '.ccs', `${profileName}.settings.json`);
+
+    // Check if profile directory exists
+    if (!fs.existsSync(settingsPath)) {
+      return {
+        valid: false,
+        error: `Profile not found: ${profileName}`,
+        suggestion: `Profile settings missing at: ${settingsPath}\n\n` +
+                   `To set up ${profileName} profile:\n` +
+                   `  1. Copy base settings: cp config/base-${profileName}.settings.json ~/.ccs/${profileName}.settings.json\n` +
+                   `  2. Edit settings: Edit ~/.ccs/${profileName}.settings.json\n` +
+                   `  3. Set your API key in ANTHROPIC_AUTH_TOKEN field`
+      };
+    }
+
+    // Read and parse settings.json
+    let settings;
+    try {
+      const settingsContent = fs.readFileSync(settingsPath, 'utf8');
+      settings = JSON.parse(settingsContent);
+    } catch (error) {
+      return {
+        valid: false,
+        error: `Failed to parse settings.json for ${profileName}`,
+        suggestion: `Settings file is corrupted or invalid JSON.\n\n` +
+                   `Location: ${settingsPath}\n` +
+                   `Parse error: ${error.message}\n\n` +
+                   `Fix: Restore from base config:\n` +
+                   `  cp config/base-${profileName}.settings.json ~/.ccs/${profileName}.settings.json`
+      };
+    }
+
+    // Validate API key exists and is not default
+    const apiKey = settings.env?.ANTHROPIC_AUTH_TOKEN;
+
+    if (!apiKey) {
+      return {
+        valid: false,
+        error: `API key not configured for ${profileName}`,
+        suggestion: `Missing ANTHROPIC_AUTH_TOKEN in settings.\n\n` +
+                   `Edit: ${settingsPath}\n` +
+                   `Set: env.ANTHROPIC_AUTH_TOKEN to your API key`
+      };
+    }
+
+    // Check for default placeholder values
+    const defaultPlaceholders = [
+      'YOUR_GLM_API_KEY_HERE',
+      'YOUR_KIMI_API_KEY_HERE',
+      'YOUR_API_KEY_HERE',
+      'your-api-key-here',
+      'PLACEHOLDER'
+    ];
+
+    if (defaultPlaceholders.some(placeholder => apiKey.includes(placeholder))) {
+      return {
+        valid: false,
+        error: `Default API key placeholder detected for ${profileName}`,
+        suggestion: `API key is still set to default placeholder.\n\n` +
+                   `To configure your profile:\n` +
+                   `  1. Edit: ${settingsPath}\n` +
+                   `  2. Replace ANTHROPIC_AUTH_TOKEN with your actual API key\n\n` +
+                   `Get API key:\n` +
+                   `  GLM: https://z.ai/manage-apikey/apikey-list\n` +
+                   `  Kimi: https://platform.moonshot.cn/console/api-keys`
+      };
+    }
+
+    // Validation passed
+    return {
+      valid: true,
+      settingsPath,
+      apiKey: apiKey.substring(0, 8) + '...' // Show first 8 chars for verification
+    };
+  }
+
+  /**
+   * Format validation error for display
+   * @param {Object} result - Validation result from validate()
+   * @returns {string} Formatted error message
+   */
+  static formatError(result) {
+    if (result.valid) {
+      return '';
+    }
+
+    let message = `\n[X] ${result.error}\n\n`;
+
+    if (result.suggestion) {
+      message += `${result.suggestion}\n`;
+    }
+
+    return message;
+  }
+
+  /**
+   * Check if profile is delegation-ready (shorthand)
+   * @param {string} profileName - Profile to check
+   * @returns {boolean} True if ready for delegation
+   */
+  static isReady(profileName) {
+    const result = this.validate(profileName);
+    return result.valid;
+  }
+
+  /**
+   * Get all delegation-ready profiles
+   * @returns {Array<string>} List of profile names ready for delegation
+   */
+  static getReadyProfiles() {
+    const homeDir = os.homedir();
+    const ccsDir = path.join(homeDir, '.ccs');
+
+    if (!fs.existsSync(ccsDir)) {
+      return [];
+    }
+
+    const profiles = [];
+    const entries = fs.readdirSync(ccsDir, { withFileTypes: true });
+
+    // Look for *.settings.json files
+    for (const entry of entries) {
+      if (entry.isFile() && entry.name.endsWith('.settings.json')) {
+        const profileName = entry.name.replace('.settings.json', '');
+        if (this.isReady(profileName)) {
+          profiles.push(profileName);
+        }
+      }
+    }
+
+    return profiles;
+  }
+}
+
+module.exports = { DelegationValidator };

package/lib/ccs

@@ -2,7 +2,7 @@
 set -euo pipefail
 
 # Version (updated by scripts/bump-version.sh)
-CCS_VERSION="3.5.0"
+CCS_VERSION="4.1.1"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 readonly CONFIG_FILE="${CCS_CONFIG:-$HOME/.ccs/config.json}"
 readonly PROFILES_JSON="$HOME/.ccs/profiles.json"
@@ -187,6 +187,13 @@ show_help() {
   echo -e "  ${YELLOW}ccs work${RESET}                    Switch to work account"
   echo -e "  ${YELLOW}ccs personal${RESET}                Switch to personal account"
   echo ""
+  echo -e "${CYAN}Delegation (Token Optimization):${RESET}"
+  echo -e "  ${YELLOW}/ccs:glm \"task\"${RESET}             Delegate to GLM-4.6 within Claude session"
+  echo -e "  ${YELLOW}/ccs:kimi \"task\"${RESET}            Delegate to Kimi for long context"
+  echo -e "  ${YELLOW}/ccs:create m2${RESET}              Create custom delegation command"
+  echo -e "  Use delegation to save tokens on simple tasks"
+  echo -e "  Commands work inside Claude Code sessions only"
+  echo ""
   echo -e "${CYAN}Diagnostics:${RESET}"
   echo -e "  ${YELLOW}ccs doctor${RESET}                  Run health check and diagnostics"
   echo ""
@@ -522,6 +529,33 @@ show_version() {
   # Simple config display
   local config="${CCS_CONFIG:-$HOME/.ccs/config.json}"
   echo -e "  ${CYAN}Config:${RESET} ${config}"
+
+  # Delegation status
+  local delegation_rules="$HOME/.ccs/delegation-rules.json"
+  if [[ -f "$delegation_rules" ]]; then
+    echo -e "  ${CYAN}Delegation:${RESET} Enabled"
+
+    # Check which profiles are delegation-ready
+    local ready_profiles=()
+    for profile in glm kimi; do
+      local settings_file="$HOME/.ccs/profiles/$profile/settings.json"
+      if [[ -f "$settings_file" ]]; then
+        # Check if API key is configured (not a placeholder)
+        local api_key=$(jq -r '.env.ANTHROPIC_AUTH_TOKEN // empty' "$settings_file" 2>/dev/null)
+        if [[ -n "$api_key" ]] && [[ ! "$api_key" =~ YOUR_.*_API_KEY_HERE ]]; then
+          ready_profiles+=("$profile")
+        fi
+      fi
+    done
+
+    if [[ ${#ready_profiles[@]} -gt 0 ]]; then
+      echo -e "  ${CYAN}Ready:${RESET} ${ready_profiles[*]}"
+    else
+      echo -e "  ${CYAN}Ready:${RESET} None (configure profiles first)"
+    fi
+  else
+    echo -e "  ${CYAN}Delegation:${RESET} Not configured"
+  fi
   echo ""
 
   echo -e "${CYAN}Documentation:${RESET} https://github.com/kaitranntt/ccs"

package/lib/ccs.ps1

@@ -12,7 +12,7 @@ param(
 $ErrorActionPreference = "Stop"
 
 # Version (updated by scripts/bump-version.sh)
-$CcsVersion = "3.5.0"
+$CcsVersion = "4.1.1"
 $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
 $ConfigFile = if ($env:CCS_CONFIG) { $env:CCS_CONFIG } else { "$env:USERPROFILE\.ccs\config.json" }
 $ProfilesJson = "$env:USERPROFILE\.ccs\profiles.json"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaitranntt/ccs",
-  "version": "3.5.0",
+  "version": "4.1.1",
   "description": "Claude Code Switch - Instant profile switching between Claude Sonnet 4.5 and GLM 4.6",
   "keywords": [
     "cli",
@@ -31,6 +31,7 @@
     "lib/",
     "scripts/",
     "config/",
+    ".claude/",
     "VERSION",
     "README.md",
     "LICENSE"

package/scripts/postinstall.js

@@ -103,6 +103,28 @@ function createConfigFiles() {
     }
     console.log('');
 
+    // Copy .claude/ directory from package to ~/.ccs/.claude/ (v4.1.1)
+    try {
+      const ClaudeDirInstaller = require('../bin/utils/claude-dir-installer');
+      const installer = new ClaudeDirInstaller();
+      const packageDir = path.join(__dirname, '..');
+      installer.install(packageDir);
+    } catch (err) {
+      console.warn('[!] Failed to install .claude/ directory:', err.message);
+      console.warn('    CCS items may not be available');
+    }
+
+    // Install CCS items to ~/.claude/ (v4.1.0)
+    try {
+      const ClaudeSymlinkManager = require('../bin/utils/claude-symlink-manager');
+      const claudeSymlinkManager = new ClaudeSymlinkManager();
+      claudeSymlinkManager.install();
+    } catch (err) {
+      console.warn('[!] CCS item installation warning:', err.message);
+      console.warn('    Run "ccs update" to retry');
+    }
+    console.log('');
+
     // Create config.json if missing
     const configPath = path.join(ccsDir, 'config.json');
     if (!fs.existsSync(configPath)) {