@kaitranntt/ccs 4.3.4 → 4.3.5

package/README.md

@@ -323,8 +323,7 @@ graph LR
 ~/.ccs/
 ├── .claude/                 # CCS items (ships with package, v4.1)
 │   ├── commands/ccs/        # Delegation commands (/ccs, /ccs:continue)
-│   ├── skills/ccs-delegation/  # AI decision framework
-│   └── agents/ccs-delegator.md # Proactive delegation agent
+│   └── skills/ccs-delegation/  # AI decision framework (replaces deprecated agents)
 ├── shared/                  # Symlinks to ~/.claude/ (for profiles)
 │   ├── agents@ → ~/.claude/agents/
 │   ├── commands@ → ~/.claude/commands/
@@ -341,7 +340,7 @@ graph LR
 ~/.claude/                   # User's Claude directory
 ├── commands/ccs@ → ~/.ccs/.claude/commands/ccs/  # Selective symlink
 ├── skills/ccs-delegation@ → ~/.ccs/.claude/skills/ccs-delegation/
-└── agents/ccs-delegator.md@ → ~/.ccs/.claude/agents/ccs-delegator.md
+# agents/ccs-delegator.md@ → ~/.ccs/.claude/agents/ccs-delegator.md  # Deprecated in v4.3.2
 ```
 
 **Symlink Chain**: `work profile → ~/.ccs/shared/ → ~/.claude/ → ~/.ccs/.claude/` (CCS items)
@@ -507,8 +506,8 @@ Savings:                        $0.0275 (86% reduction)
 ### Documentation
 
 - **Workflow Diagrams**: See [docs/ccs-delegation-diagrams.md](docs/ccs-delegation-diagrams.md) for visual architecture
-- **Skill Reference**: `.claude/skills/ccs-delegation/` for AI decision framework
-- **Agent Docs**: `.claude/agents/ccs-delegator.md` for orchestration patterns
+- **Skill Reference**: `.claude/skills/ccs-delegation/` for AI decision framework (replaces deprecated agents)
+- **Agent Docs**: `.claude/agents/ccs-delegator.md` was deprecated in v4.3.2, functionality moved to ccs-delegation skill
 
 <br>
 

package/VERSION

@@ -1 +1 @@
-4.3.4
+4.3.5

package/bin/ccs.js

@@ -286,6 +286,11 @@ async function handleSyncCommand() {
 
   console.log('');
 
+  const cleanupResult = installer.cleanupDeprecated();
+  if (cleanupResult.success && cleanupResult.cleanedFiles.length > 0) {
+    console.log('');
+  }
+
   // Then, create symlinks from ~/.ccs/.claude/ to ~/.claude/
   const ClaudeSymlinkManager = require('./utils/claude-symlink-manager');
   const manager = new ClaudeSymlinkManager();

package/bin/utils/claude-dir-installer.js

@@ -148,6 +148,108 @@ class ClaudeDirInstaller {
     return { files, dirs };
   }
 
+  /**
+   * Clean up deprecated files from previous installations
+   * Removes ccs-delegator.md that was deprecated in v4.3.2
+   * @param {boolean} silent - Suppress console output
+   */
+  cleanupDeprecated(silent = false) {
+    const deprecatedFile = path.join(this.ccsClaudeDir, 'agents', 'ccs-delegator.md');
+    const userSymlinkFile = path.join(this.homeDir, '.claude', 'agents', 'ccs-delegator.md');
+    const migrationMarker = path.join(this.homeDir, '.ccs', '.migrations', 'v435-delegator-cleanup');
+
+    let cleanedFiles = [];
+
+    try {
+      // Check if cleanup already done
+      if (fs.existsSync(migrationMarker)) {
+        return { success: true, cleanedFiles: [] }; // Already cleaned
+      }
+
+      // Clean up user symlink in ~/.claude/agents/ccs-delegator.md FIRST
+      // This ensures we can detect broken symlinks before deleting the target
+      try {
+        const userStats = fs.lstatSync(userSymlinkFile);
+        if (userStats.isSymbolicLink()) {
+          fs.unlinkSync(userSymlinkFile);
+          cleanedFiles.push('user symlink');
+        } else {
+          // It's not a symlink (user created their own file), backup it
+          const timestamp = new Date().toISOString().replace(/[:.]/g, '-').split('T')[0];
+          const backupPath = `${userSymlinkFile}.backup-${timestamp}`;
+          fs.renameSync(userSymlinkFile, backupPath);
+          if (!silent) console.log(`[i] Backed up user file to ${path.basename(backupPath)}`);
+          cleanedFiles.push('user file (backed up)');
+        }
+      } catch (err) {
+        // File doesn't exist or other error - that's okay
+        if (err.code !== 'ENOENT' && !silent) {
+          console.log(`[!] Failed to remove user symlink: ${err.message}`);
+        }
+      }
+
+      // Clean up package copy in ~/.ccs/.claude/agents/ccs-delegator.md
+      if (fs.existsSync(deprecatedFile)) {
+        try {
+          // Check if file was modified by user (compare with expected content)
+          const shouldBackup = this._shouldBackupDeprecatedFile(deprecatedFile);
+
+          if (shouldBackup) {
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-').split('T')[0];
+            const backupPath = `${deprecatedFile}.backup-${timestamp}`;
+            fs.renameSync(deprecatedFile, backupPath);
+            if (!silent) console.log(`[i] Backed up modified deprecated file to ${path.basename(backupPath)}`);
+          } else {
+            fs.rmSync(deprecatedFile, { force: true });
+          }
+          cleanedFiles.push('package copy');
+        } catch (err) {
+          if (!silent) console.log(`[!] Failed to remove package copy: ${err.message}`);
+        }
+      }
+
+      // Create migration marker
+      if (cleanedFiles.length > 0) {
+        const migrationsDir = path.dirname(migrationMarker);
+        if (!fs.existsSync(migrationsDir)) {
+          fs.mkdirSync(migrationsDir, { recursive: true, mode: 0o700 });
+        }
+        fs.writeFileSync(migrationMarker, new Date().toISOString());
+
+        if (!silent) {
+          console.log(`[OK] Cleaned up deprecated agent files: ${cleanedFiles.join(', ')}`);
+        }
+      }
+
+      return { success: true, cleanedFiles };
+    } catch (err) {
+      if (!silent) console.log(`[!] Cleanup failed: ${err.message}`);
+      return { success: false, error: err.message, cleanedFiles };
+    }
+  }
+
+  /**
+   * Check if deprecated file should be backed up (user modified)
+   * @param {string} filePath - Path to check
+   * @returns {boolean} True if file should be backed up
+   * @private
+   */
+  _shouldBackupDeprecatedFile(filePath) {
+    try {
+      // Simple heuristic: if file size differs significantly from expected, assume user modified
+      // Expected size for ccs-delegator.md was around 2-3KB
+      const stats = fs.statSync(filePath);
+      const expectedMinSize = 1000; // 1KB minimum
+      const expectedMaxSize = 10000; // 10KB maximum
+
+      // If size is outside expected range, likely user modified
+      return stats.size < expectedMinSize || stats.size > expectedMaxSize;
+    } catch (err) {
+      // If we can't determine, err on side of caution and backup
+      return true;
+    }
+  }
+
   /**
    * Check if ~/.ccs/.claude/ exists and is valid
    * @returns {boolean} True if directory exists

package/bin/utils/claude-symlink-manager.js

@@ -28,8 +28,7 @@ class ClaudeSymlinkManager {
     // CCS items to symlink (selective, item-level)
     this.ccsItems = [
       { source: 'commands/ccs', target: 'commands/ccs', type: 'directory' },
-      { source: 'skills/ccs-delegation', target: 'skills/ccs-delegation', type: 'directory' },
-      { source: 'agents/ccs-delegator.md', target: 'agents/ccs-delegator.md', type: 'file' }
+      { source: 'skills/ccs-delegation', target: 'skills/ccs-delegation', type: 'directory' }
     ];
   }
 

package/lib/ccs

@@ -2,7 +2,7 @@
 set -euo pipefail
 
 # Version (updated by scripts/bump-version.sh)
-CCS_VERSION="4.3.4"
+CCS_VERSION="4.3.5"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 readonly CONFIG_FILE="${CCS_CONFIG:-$HOME/.ccs/config.json}"
 readonly PROFILES_JSON="$HOME/.ccs/profiles.json"

package/lib/ccs.ps1

@@ -12,7 +12,7 @@ param(
 $ErrorActionPreference = "Stop"
 
 # Version (updated by scripts/bump-version.sh)
-$CcsVersion = "4.3.4"
+$CcsVersion = "4.3.5"
 $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": "4.3.4",
+  "version": "4.3.5",
   "description": "Claude Code Switch - Instant profile switching between Claude Sonnet 4.5 and GLM 4.6",
   "keywords": [
     "cli",
@@ -59,7 +59,7 @@
   },
   "dependencies": {
     "cli-table3": "^0.6.5",
-    "ora": "^5.4.1"
+    "ora": "^9.0.0"
   },
   "devDependencies": {
     "mocha": "^11.7.5"

package/scripts/postinstall.js

@@ -109,6 +109,9 @@ function createConfigFiles() {
       const installer = new ClaudeDirInstaller();
       const packageDir = path.join(__dirname, '..');
       installer.install(packageDir);
+
+      // Clean up deprecated files (v4.3.2)
+      installer.cleanupDeprecated();
     } catch (err) {
       console.warn('[!] Failed to install .claude/ directory:', err.message);
       console.warn('    CCS items may not be available');