@kaitranntt/ccs 4.3.10 → 5.0.0

package/lib/error-codes.ps1

@@ -36,7 +36,8 @@ $script:E_INVALID_STATE = "E901"
 # Get error documentation URL
 function Get-ErrorDocUrl {
     param([string]$ErrorCode)
-    return "https://github.com/kaitranntt/ccs/blob/main/docs/errors/README.md#$($ErrorCode.ToLower())"
+    $LowerCode = $ErrorCode.ToLower()
+    return "https://github.com/kaitranntt/ccs/blob/main/docs/errors/README.md#$LowerCode"
 }
 
 # Get error category from code

package/lib/prompt.ps1

@@ -77,9 +77,9 @@ function Read-Input {
 
     # Interactive prompt
     $PromptText = if ($Default) {
-        "$Message [$Default]: "
+        "${Message} [$Default]: "
     } else {
-        "$Message: "
+        "${Message}: "
     }
 
     while ($true) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaitranntt/ccs",
-  "version": "4.3.10",
+  "version": "5.0.0",
   "description": "Claude Code Switch - Instant profile switching between Claude Sonnet 4.5 and GLM 4.6",
   "keywords": [
     "cli",
@@ -23,11 +23,13 @@
     "name": "Tam Nhu Tran (Kai)",
     "email": "kaitranntt@users.noreply.github.com"
   },
+  "main": "dist/ccs.js",
+  "types": "dist/ccs.d.ts",
   "bin": {
-    "ccs": "bin/ccs.js"
+    "ccs": "dist/ccs.js"
   },
   "files": [
-    "bin/",
+    "dist/",
     "lib/",
     "scripts/",
     "config/",
@@ -37,8 +39,10 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=14.0.0",
+    "bun": ">=1.0.0"
   },
+  "packageManager": "bun@1.2.21",
   "os": [
     "darwin",
     "linux",
@@ -46,14 +50,23 @@
   ],
   "preferGlobal": true,
   "scripts": {
-    "test": "npm run test:all",
-    "test:all": "npm run test:unit && npm run test:npm",
-    "test:unit": "npx mocha tests/shared/unit/**/*.test.js --timeout 5000",
-    "test:npm": "npx mocha tests/npm/**/*.test.js --timeout 10000",
+    "build": "tsc && node scripts/add-shebang.js",
+    "build:watch": "tsc --watch",
+    "prebuild": "rm -rf dist tsconfig.tsbuildinfo",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/",
+    "validate": "bun run typecheck && bun run lint && bun run format:check && bun run test",
+    "test": "bun run build && bun run test:all",
+    "test:all": "bun run test:unit && bun run test:npm",
+    "test:unit": "mocha tests/shared/unit/**/*.test.js --timeout 5000",
+    "test:npm": "mocha tests/npm/**/*.test.js --timeout 10000",
     "test:native": "bash tests/native/unix/edge-cases.sh",
     "test:edge-cases": "bash tests/edge-cases.sh",
-    "prepublishOnly": "node scripts/sync-version.js",
-    "prepack": "node scripts/sync-version.js",
+    "prepublishOnly": "npm run validate && node scripts/sync-version.js",
+    "prepack": "npm run validate && node scripts/sync-version.js",
     "prepare": "node scripts/check-executables.js",
     "postinstall": "node scripts/postinstall.js"
   },
@@ -62,6 +75,13 @@
     "ora": "^9.0.0"
   },
   "devDependencies": {
-    "mocha": "^11.7.5"
+    "@types/node": "^20.19.25",
+    "@typescript-eslint/eslint-plugin": "^8.48.0",
+    "@typescript-eslint/parser": "^8.48.0",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.8",
+    "mocha": "^11.7.5",
+    "prettier": "^3.6.2",
+    "typescript": "5.3"
   }
 }

package/scripts/add-shebang.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Add shebang to dist/ccs.js and make executable
+ * Run after: tsc
+ */
+function addShebang() {
+  const ccsPath = path.join(__dirname, '../dist/ccs.js');
+
+  if (!fs.existsSync(ccsPath)) {
+    console.error('[X] dist/ccs.js not found. Run tsc first.');
+    process.exit(1);
+  }
+
+  let content = fs.readFileSync(ccsPath, 'utf8');
+
+  // Add shebang if missing
+  if (!content.startsWith('#!/usr/bin/env node')) {
+    content = '#!/usr/bin/env node\n' + content;
+    fs.writeFileSync(ccsPath, content);
+    console.log('[OK] Shebang added to dist/ccs.js');
+  }
+
+  // Make executable (Unix-like systems)
+  if (process.platform !== 'win32') {
+    try {
+      fs.chmodSync(ccsPath, 0o755);
+      console.log('[OK] dist/ccs.js is now executable');
+    } catch (err) {
+      console.warn('[!] Could not chmod dist/ccs.js:', err.message);
+    }
+  }
+}
+
+addShebang();

package/scripts/bump-version.sh

@@ -1,6 +1,9 @@
 #!/usr/bin/env bash
 # Bump CCS version
 # Usage: ./scripts/bump-version.sh [major|minor|patch]
+#
+# v4.5.0+: Bootstrap architecture - shell scripts delegate to Node.js
+# Version is maintained in: VERSION, package.json, installers/*
 
 set -euo pipefail
 
@@ -10,7 +13,7 @@ VERSION_FILE="$CCS_DIR/VERSION"
 
 # Check VERSION file exists
 if [[ ! -f "$VERSION_FILE" ]]; then
-    echo "✗ Error: VERSION file not found at $VERSION_FILE"
+    echo "[X] Error: VERSION file not found at $VERSION_FILE"
     exit 1
 fi
 
@@ -20,7 +23,7 @@ echo "Current version: $CURRENT_VERSION"
 
 # Parse version
 if [[ ! "$CURRENT_VERSION" =~ ^([0-9]+)\.([0-9]+)\.([0-9]+)$ ]]; then
-    echo "✗ Error: Invalid version format in VERSION file"
+    echo "[X] Error: Invalid version format in VERSION file"
     echo "Expected: MAJOR.MINOR.PATCH (e.g., 1.2.3)"
     exit 1
 fi
@@ -46,7 +49,7 @@ case "$BUMP_TYPE" in
         PATCH=$((PATCH + 1))
         ;;
     *)
-        echo "✗ Error: Invalid bump type '$BUMP_TYPE'"
+        echo "[X] Error: Invalid bump type '$BUMP_TYPE'"
         echo "Usage: $0 [major|minor|patch]"
         exit 1
         ;;
@@ -58,11 +61,12 @@ echo "New version: $NEW_VERSION"
 echo ""
 echo "This will update hardcoded versions in:"
 echo "  1. VERSION file"
-echo "  2. lib/ccs (bash executable)"
-echo "  3. lib/ccs.ps1 (PowerShell executable)"
-echo "  4. package.json (via sync-version.js)"
-echo "  5. installers/install.sh"
-echo "  6. installers/install.ps1"
+echo "  2. package.json (via sync-version.js)"
+echo "  3. installers/install.sh"
+echo "  4. installers/install.ps1"
+echo ""
+echo "Note: lib/ccs and lib/ccs.ps1 are now bootstraps"
+echo "      (delegate to Node.js, no version hardcoded)"
 echo ""
 read -p "Continue? (y/N) " -n 1 -r
 echo
@@ -74,63 +78,47 @@ fi
 
 # Update VERSION file
 echo "$NEW_VERSION" > "$VERSION_FILE"
-echo "✓ Updated VERSION file to $NEW_VERSION"
-
-# Update ccs (bash executable)
-CCS_BASH="$CCS_DIR/lib/ccs"
-if [[ -f "$CCS_BASH" ]]; then
-    sed -i.bak "s/^CCS_VERSION=\".*\"/CCS_VERSION=\"$NEW_VERSION\"/" "$CCS_BASH"
-    rm -f "$CCS_BASH.bak"
-    echo "✓ Updated lib/ccs (bash executable)"
-else
-    echo "⚠  lib/ccs not found, skipping"
-fi
+echo "[OK] Updated VERSION file to $NEW_VERSION"
 
-# Update ccs.ps1 (PowerShell executable)
-CCS_PS1="$CCS_DIR/lib/ccs.ps1"
-if [[ -f "$CCS_PS1" ]]; then
-    sed -i.bak "s/^\$CcsVersion = \".*\"/\$CcsVersion = \"$NEW_VERSION\"/" "$CCS_PS1"
-    rm -f "$CCS_PS1.bak"
-    echo "✓ Updated lib/ccs.ps1 (PowerShell executable)"
-else
-    echo "⚠  lib/ccs.ps1 not found, skipping"
-fi
+# Note: lib/ccs and lib/ccs.ps1 are now lightweight bootstraps
+# They delegate to Node.js via npx - no version variable needed
+# Version is determined by the npm package at runtime
 
 # Update installers/install.sh
 INSTALL_SH="$CCS_DIR/installers/install.sh"
 if [[ -f "$INSTALL_SH" ]]; then
     sed -i.bak "s/^CCS_VERSION=\".*\"/CCS_VERSION=\"$NEW_VERSION\"/" "$INSTALL_SH"
     rm -f "$INSTALL_SH.bak"
-    echo "✓ Updated installers/install.sh"
+    echo "[OK] Updated installers/install.sh"
 else
-    echo "⚠  installers/install.sh not found, skipping"
+    echo "[!] installers/install.sh not found, skipping"
 fi
 
 # Update installers/install.ps1
 INSTALL_PS1="$CCS_DIR/installers/install.ps1"
 if [[ -f "$INSTALL_PS1" ]]; then
-    sed -i.bak "s/^\$CcsVersion = \".*\"/\$CcsVersion = \"$NEW_VERSION\"/" "$INSTALL_PS1"
+    sed -i.bak "s/^\\\$CcsVersion = \".*\"/\\\$CcsVersion = \"$NEW_VERSION\"/" "$INSTALL_PS1"
     rm -f "$INSTALL_PS1.bak"
-    echo "✓ Updated installers/install.ps1"
+    echo "[OK] Updated installers/install.ps1"
 else
-    echo "⚠  installers/install.ps1 not found, skipping"
+    echo "[!] installers/install.ps1 not found, skipping"
 fi
 
 # Sync version to package.json
 echo "Syncing version to package.json..."
 if node "$SCRIPT_DIR/sync-version.js"; then
-    echo "✓ Synced version to package.json"
+    echo "[OK] Synced version to package.json"
 else
-    echo "✗ Error: Failed to sync version to package.json"
+    echo "[X] Error: Failed to sync version to package.json"
     exit 1
 fi
 
 echo ""
-echo "✓ Version bumped to $NEW_VERSION"
+echo "[OK] Version bumped to $NEW_VERSION"
 echo ""
 echo "Next steps:"
 echo "  1. Review changes: git diff"
-echo "  2. Commit: git add VERSION package.json lib/ccs lib/ccs.ps1 installers/install.sh installers/install.ps1"
+echo "  2. Commit: git add VERSION package.json installers/install.sh installers/install.ps1"
 echo "  3. Commit: git commit -m \"chore: bump version to $NEW_VERSION\""
 echo "  4. Tag: git tag v$NEW_VERSION"
 echo "  5. Push: git push origin main && git push origin v$NEW_VERSION"

package/scripts/dev-install.sh

@@ -1,35 +1,56 @@
 #!/bin/bash
 # Auto-install CCS locally for testing changes
+# Usage: ./scripts/dev-install.sh
+#
+# Options:
+#   --skip-validate  Skip validation (faster, use when you're sure code is good)
 
 set -e
 
-echo "[CCS Dev Install] Starting..."
+SKIP_VALIDATE=false
+for arg in "$@"; do
+    case $arg in
+        --skip-validate) SKIP_VALIDATE=true ;;
+    esac
+done
+
+echo "[i] CCS Dev Install - Starting..."
 
 # Get to the right directory
 cd "$(dirname "$0")/.."
 
+# Build TypeScript first
+echo "[i] Building TypeScript..."
+bun run build
+
 # Pack the npm package
-echo "[CCS Dev Install] Creating package..."
-npm pack
+echo "[i] Creating package..."
+if [ "$SKIP_VALIDATE" = true ]; then
+    # Skip validation, just pack
+    bun pm pack --ignore-scripts
+else
+    # Full pack with validation (runs prepublishOnly)
+    bun pm pack
+fi
 
 # Find the tarball
-TARBALL=$(ls -t kaitranntt-ccs-*.tgz | head -1)
+TARBALL=$(ls -t kaitranntt-ccs-*.tgz 2>/dev/null | head -1)
 
 if [ -z "$TARBALL" ]; then
-    echo "[CCS Dev Install] ERROR: No tarball found"
+    echo "[X] ERROR: No tarball found"
     exit 1
 fi
 
-echo "[CCS Dev Install] Found tarball: $TARBALL"
+echo "[i] Found tarball: $TARBALL"
 
-# Install globally
-echo "[CCS Dev Install] Installing globally..."
+# Install globally using npm (handles bin linking correctly)
+echo "[i] Installing globally with npm..."
 npm install -g "$TARBALL"
 
 # Clean up
-echo "[CCS Dev Install] Cleaning up..."
+echo "[i] Cleaning up..."
 rm "$TARBALL"
 
-echo "[CCS Dev Install] ✓ Complete! CCS is now updated."
+echo "[OK] Complete! CCS is now updated."
 echo ""
-echo "Test with: ccs glmt --version"
+echo "Test with: ccs --version"

package/scripts/postinstall.js

@@ -12,14 +12,24 @@ const os = require('os');
  * Runs when: npm install -g @kaitranntt/ccs
  * Idempotent: Safe to run multiple times (won't overwrite existing configs)
  * Cross-platform: Works on Unix, macOS, Windows
+ *
+ * Test isolation: Set CCS_HOME env var to redirect all operations to a test directory
  */
 
+/**
+ * Get the CCS home directory (respects CCS_HOME env var for test isolation)
+ * @returns {string} Home directory path
+ */
+function getCcsHome() {
+  return process.env.CCS_HOME || os.homedir();
+}
+
 /**
  * Validate created configuration files
  * @returns {object} { success: boolean, errors: string[], warnings: string[] }
  */
 function validateConfiguration() {
-  const homedir = os.homedir();
+  const homedir = getCcsHome();
   const errors = [];
   const warnings = [];
 
@@ -63,8 +73,8 @@ function validateConfiguration() {
 
 function createConfigFiles() {
   try {
-    // Get user home directory (cross-platform)
-    const homedir = os.homedir();
+    // Get user home directory (cross-platform, respects CCS_HOME for test isolation)
+    const homedir = getCcsHome();
     const ccsDir = path.join(homedir, '.ccs');
 
     // Create ~/.ccs/ directory if missing
@@ -93,42 +103,26 @@ function createConfigFiles() {
     // Migrate from v3.1.1 to v3.2.0 (symlink architecture)
     console.log('');
     try {
-      const SharedManager = require('../bin/management/shared-manager');
+      const SharedManager = require('../dist/management/shared-manager').default;
       const sharedManager = new SharedManager();
       sharedManager.migrateFromV311();
       sharedManager.ensureSharedDirectories();
+
+      // Run v4.4 migration: Migrate instances to shared settings.json
+      sharedManager.migrateToSharedSettings();
     } catch (err) {
       console.warn('[!] Migration warning:', err.message);
       console.warn('    Migration will retry on next run');
     }
     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);
-
-      // 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');
-    }
-
-    // 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 sync" to retry');
-    }
-    console.log('');
+    // NOTE: .claude/ directory installation moved to "ccs sync" command
+    // Users can run "ccs sync" to install CCS commands/skills to ~/.claude/
+    // This gives users control over when to modify their Claude configuration
 
     // Create config.json if missing
+    // NOTE: gemini/codex profiles NOT included - they are added on-demand when user
+    // runs `ccs gemini` or `ccs codex` for first time (requires OAuth auth first)
     const configPath = path.join(ccsDir, 'config.json');
     if (!fs.existsSync(configPath)) {
       const config = {
@@ -153,12 +147,17 @@ function createConfigFiles() {
       if (!config.profiles) {
         config.profiles = {};
       }
+      let configUpdated = false;
       if (!config.profiles.glmt) {
         config.profiles.glmt = '~/.ccs/glmt.settings.json';
+        configUpdated = true;
+      }
+      // NOTE: gemini/codex profiles added on-demand, not during migration
+      if (configUpdated) {
         const tmpPath = `${configPath}.tmp`;
         fs.writeFileSync(tmpPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
         fs.renameSync(tmpPath, configPath);
-        console.log('[OK] Updated config with GLMT profile');
+        console.log('[OK] Updated config with glmt profile');
       } else {
         console.log('[OK] Config exists: ~/.ccs/config.json (preserved)');
       }
@@ -307,6 +306,10 @@ function createConfigFiles() {
       console.log('[OK] Kimi profile exists: ~/.ccs/kimi.settings.json (preserved)');
     }
 
+    // NOTE: gemini.settings.json and codex.settings.json are NOT created during install
+    // They are created on-demand when user runs `ccs gemini` or `ccs codex` for the first time
+    // This prevents confusion - users need to run `--auth` first anyway
+
     // Migrate existing Kimi configs to remove deprecated model fields (v4.1.2)
     // Kimi API changed - model fields now cause 401 errors
     if (fs.existsSync(kimiSettingsPath)) {