@georgedong32/ccs 7.66.0

package/lib/prompt.sh

@@ -0,0 +1,99 @@
+#!/usr/bin/env bash
+# CCS Interactive Prompt Utilities (bash 3.2+ compatible)
+# NO external dependencies
+
+set -euo pipefail
+
+# Interactive confirmation prompt
+# Usage: confirm_action "message" "yes"|"no"
+# Returns: 0 (true) or 1 (false)
+confirm_action() {
+  local message="$1"
+  local default="${2:-no}"  # Default to NO for safety
+
+  # Check for --yes flag (automation) - always returns true (0)
+  if [[ "${CCS_YES:-}" == "1" ]]; then
+    return 0
+  fi
+
+  # Check for --no-input flag (CI)
+  if [[ "${CCS_NO_INPUT:-}" == "1" ]]; then
+    echo "[X] Interactive input required but --no-input specified" >&2
+    exit 1
+  fi
+
+  # Non-TTY: use default
+  if [[ ! -t 0 ]]; then
+    [[ "$default" == "yes" ]] && return 0 || return 1
+  fi
+
+  # Interactive prompt
+  local prompt
+  if [[ "$default" == "yes" ]]; then
+    prompt="$message [Y/n]: "
+  else
+    prompt="$message [y/N]: "
+  fi
+
+  while true; do
+    read -r -p "$prompt" response >&2
+    response=$(echo "$response" | tr '[:upper:]' '[:lower:]')
+
+    case "$response" in
+      ""|" ")
+        # Empty answer: use default
+        [[ "$default" == "yes" ]] && return 0 || return 1
+        ;;
+      y|yes)
+        return 0
+        ;;
+      n|no)
+        return 1
+        ;;
+      *)
+        echo "[!] Please answer y or n" >&2
+        ;;
+    esac
+  done
+}
+
+# Interactive text input
+# Usage: prompt_input "message" "default_value"
+# Outputs: user input to stdout
+prompt_input() {
+  local message="$1"
+  local default="${2:-}"
+
+  # Non-TTY: use default or error
+  if [[ ! -t 0 ]]; then
+    if [[ -n "$default" ]]; then
+      echo "$default"
+      return 0
+    else
+      echo "[X] Interactive input required but stdin is not a TTY" >&2
+      exit 1
+    fi
+  fi
+
+  # Interactive prompt
+  local prompt
+  if [[ -n "$default" ]]; then
+    prompt="$message [$default]: "
+  else
+    prompt="$message: "
+  fi
+
+  read -r -p "$prompt" response >&2
+
+  # Return user input or default
+  if [[ -z "$response" ]]; then
+    echo "$default"
+  else
+    echo "$response"
+  fi
+}
+
+# Check if running in non-interactive mode
+is_non_interactive() {
+  [[ ! -t 0 ]] || [[ "${CCS_YES:-}" == "1" ]] || [[ "${CCS_NO_INPUT:-}" == "1" ]]
+}

package/lib/prompts/image-analysis-default.txt

@@ -0,0 +1,12 @@
+Analyze this image/document thoroughly and provide a detailed description.
+
+Include:
+1. Overall content and purpose
+2. Text content (if any) - transcribe important text verbatim
+3. Visual elements (diagrams, charts, UI components, icons)
+4. Layout and structure (sections, hierarchy, flow)
+5. Colors, styling, notable design elements
+6. Any actionable information (buttons, links, code snippets)
+
+Be comprehensive - this description replaces direct visual access.
+The AI assistant reading this cannot see the original image.

package/lib/prompts/image-analysis-document.txt

@@ -0,0 +1,13 @@
+Analyze this document/PDF thoroughly for a developer.
+
+Extract and provide:
+1. Document title, type, and structure
+2. All text content - transcribe in reading order
+3. Tables - format as markdown tables
+4. Lists and bullet points - preserve structure
+5. Code blocks or technical content
+6. Diagrams or flowcharts - describe in detail
+7. Headers and section organization
+8. Any important metadata visible
+
+Accuracy in text extraction is critical.

package/lib/prompts/image-analysis-screenshot.txt

@@ -0,0 +1,13 @@
+Analyze this screenshot in detail for a developer who cannot see it.
+
+Focus on:
+1. Application/website type and state
+2. UI elements visible (buttons, inputs, menus, modals)
+3. All text content - transcribe exactly
+4. Error messages or notifications (quote exactly)
+5. Layout and component hierarchy
+6. Interactive elements and their states
+7. Console output or logs if visible
+8. Any code snippets shown
+
+Be precise - this enables the assistant to help debug or understand the UI.

package/package.json

@@ -0,0 +1,149 @@
+{
+  "name": "@georgedong32/ccs",
+  "version": "7.66.0",
+  "description": "Claude Code Switch - Instant profile switching between Claude, GLM, Kimi, and more",
+  "keywords": [
+    "cli",
+    "claude",
+    "glm",
+    "ai",
+    "profile",
+    "switch"
+  ],
+  "homepage": "https://github.com/kaitranntt/ccs",
+  "bugs": {
+    "url": "https://github.com/kaitranntt/ccs/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kaitranntt/ccs.git"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Tam Nhu Tran (Kai)",
+    "email": "kaitranntt@users.noreply.github.com"
+  },
+  "main": "dist/ccs.js",
+  "types": "dist/ccs.d.ts",
+  "bin": {
+    "ccs": "dist/ccs.js",
+    "ccs-droid": "dist/bin/droid-runtime.js",
+    "ccsd": "dist/bin/droid-runtime.js",
+    "ccs-codex": "dist/bin/codex-runtime.js",
+    "ccsx": "dist/bin/codex-runtime.js",
+    "ccsxp": "dist/bin/ccsxp-runtime.js"
+  },
+  "files": [
+    "dist/",
+    "lib/",
+    "scripts/",
+    "config/",
+    ".claude/",
+    "VERSION",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0",
+    "bun": ">=1.0.0"
+  },
+  "packageManager": "bun@1.3.9",
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "preferGlobal": true,
+  "scripts": {
+    "preinstall": "node scripts/preinstall.js",
+    "postuninstall": "node scripts/postuninstall.js",
+    "build": "tsc && node scripts/add-shebang.js",
+    "build:watch": "tsc --watch",
+    "build:server": "tsc && node scripts/add-shebang.js",
+    "build:all": "bun run ui:build && bun run build:server",
+    "prebuild": "node scripts/clean-dist.js",
+    "prebuild:server": "node scripts/clean-dist.js",
+    "prebuild:all": "rm -rf dist tsconfig.tsbuildinfo",
+    "postbuild:all": "node scripts/verify-bundle.js",
+    "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:fix && bun run format:check && bun run test:all",
+    "validate:ci-parity": "bash scripts/ci-parity-gate.sh",
+    "verify:bundle": "node scripts/verify-bundle.js",
+    "test": "bun run build && bun run test:all",
+    "test:ci": "bun run test:all",
+    "test:all": "bun test tests/unit tests/integration tests/npm",
+    "test:unit": "bun test tests/unit",
+    "test:npm": "bun test tests/npm/",
+    "test:native": "bash tests/native/unix/edge-cases.sh",
+    "test:e2e": "bun test tests/e2e/ --bail --timeout 60000",
+    "report:hardening": "node scripts/hardening-inventory.js",
+    "dev": "bun run build:server && node dist/ccs.js config --dev",
+    "dev:symlink": "bash scripts/dev-symlink.sh",
+    "dev:unlink": "bash scripts/dev-symlink.sh --restore",
+    "ui:build": "cd ui && bun run build",
+    "ui:preview": "cd ui && bun run preview",
+    "ui:validate": "cd ui && bun run validate",
+    "prepack": "bun run build:all",
+    "prepare": "husky",
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "dependencies": {
+    "bcrypt": "^6.0.0",
+    "boxen": "^5.1.2",
+    "chalk": "^4.1.2",
+    "chokidar": "^3.6.0",
+    "cli-table3": "^0.6.5",
+    "express": "^4.18.2",
+    "express-rate-limit": "^8.2.1",
+    "express-session": "^1.18.2",
+    "get-port": "^5.1.1",
+    "gradient-string": "^2.0.2",
+    "http-proxy-agent": "^7.0.2",
+    "https-proxy-agent": "^7.0.6",
+    "js-yaml": "^4.1.1",
+    "listr2": "^3.14.0",
+    "open": "^8.4.2",
+    "ora": "^5.4.1",
+    "proper-lockfile": "^4.1.2",
+    "smol-toml": "^1.6.1",
+    "undici": "^5.29.0",
+    "ws": "^8.16.0"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.1.0",
+    "@commitlint/config-conventional": "^20.0.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.2",
+    "@semantic-release/npm": "^13.1.3",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "@tailwindcss/vite": "^4.1.17",
+    "@types/bcrypt": "^6.0.0",
+    "@types/chokidar": "^2.1.7",
+    "@types/express": "^4.17.21",
+    "@types/express-rate-limit": "6.0.0",
+    "@types/express-session": "^1.18.2",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.19.25",
+    "@types/proper-lockfile": "^4.1.4",
+    "@types/ws": "^8.5.10",
+    "@typescript-eslint/eslint-plugin": "^8.48.0",
+    "@typescript-eslint/parser": "^8.48.0",
+    "@vitejs/plugin-react": "^5.1.1",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.8",
+    "husky": "^9.1.7",
+    "marked": "^15.0.12",
+    "mocha": "^11.7.5",
+    "prettier": "^3.6.2",
+    "semantic-release": "^25.0.2",
+    "typescript": "5.3",
+    "vite": "^7.2.4"
+  }
+}

package/scripts/add-shebang.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+function getExecutablePaths() {
+  const packageJsonPath = path.join(__dirname, '../package.json');
+  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+  const binEntries = packageJson.bin || {};
+  const uniqueRelativePaths = [...new Set(Object.values(binEntries))];
+
+  return uniqueRelativePaths.map((relativePath) => path.join(__dirname, '..', relativePath));
+}
+
+/**
+ * Add shebangs to all published bin entrypoints and make them executable.
+ * Run after: tsc
+ */
+function addShebang() {
+  const executablePaths = getExecutablePaths();
+  const missingPaths = executablePaths.filter((executablePath) => !fs.existsSync(executablePath));
+  if (missingPaths.length > 0) {
+    console.error(`[X] Missing built executable(s): ${missingPaths.join(', ')}. Run tsc first.`);
+    process.exit(1);
+  }
+
+  for (const executablePath of executablePaths) {
+    let content = fs.readFileSync(executablePath, 'utf8');
+
+    if (!content.startsWith('#!/usr/bin/env node')) {
+      content = '#!/usr/bin/env node\n' + content;
+      fs.writeFileSync(executablePath, content);
+      console.log(`[OK] Shebang added to ${path.relative(path.join(__dirname, '..'), executablePath)}`);
+    }
+
+    if (process.platform !== 'win32') {
+      try {
+        fs.chmodSync(executablePath, 0o755);
+        console.log(
+          `[OK] ${path.relative(path.join(__dirname, '..'), executablePath)} is now executable`
+        );
+      } catch (err) {
+        console.warn(
+          `[!] Could not chmod ${path.relative(path.join(__dirname, '..'), executablePath)}: ${err.message}`
+        );
+      }
+    }
+  }
+}
+
+addShebang();

package/scripts/bump-version.sh

@@ -0,0 +1,153 @@
+#!/usr/bin/env bash
+# =============================================================================
+# DEPRECATED: This script is kept for emergency manual releases only.
+#
+# Releases are now automated via semantic-release:
+#   - Merge to main  → stable release (npm @latest)
+#   - Merge to dev   → dev release (npm @dev)
+#
+# Version is determined automatically from conventional commits:
+#   - feat: commit   → MINOR bump (5.0.2 → 5.1.0)
+#   - fix: commit    → PATCH bump (5.0.2 → 5.0.3)
+#   - feat!: commit  → MAJOR bump (5.0.2 → 6.0.0)
+#
+# See: docs/version-management.md
+# =============================================================================
+#
+# Legacy usage (emergency only): ./scripts/bump-version.sh [major|minor|patch]
+
+set -euo pipefail
+
+# Show deprecation warning
+echo "============================================================="
+echo "[!] DEPRECATED: This script is for emergency use only."
+echo ""
+echo "    Releases are now automated via semantic-release."
+echo "    Simply merge to 'main' or 'dev' branch."
+echo ""
+echo "    Version is determined from conventional commits:"
+echo "      feat: commit   -> MINOR (5.0.2 -> 5.1.0)"
+echo "      fix: commit    -> PATCH (5.0.2 -> 5.0.3)"
+echo "      feat!: commit  -> MAJOR (5.0.2 -> 6.0.0)"
+echo "============================================================="
+echo ""
+
+# Require explicit confirmation
+read -p "Continue with manual bump? (y/N) " -n 1 -r
+echo
+if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+    echo "Cancelled. Use conventional commits + merge to main instead."
+    exit 0
+fi
+echo ""
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CCS_DIR="$(dirname "$SCRIPT_DIR")"
+VERSION_FILE="$CCS_DIR/VERSION"
+
+# Check VERSION file exists
+if [[ ! -f "$VERSION_FILE" ]]; then
+    echo "[X] Error: VERSION file not found at $VERSION_FILE"
+    exit 1
+fi
+
+# Read current version
+CURRENT_VERSION=$(cat "$VERSION_FILE")
+echo "Current version: $CURRENT_VERSION"
+
+# Parse version
+if [[ ! "$CURRENT_VERSION" =~ ^([0-9]+)\.([0-9]+)\.([0-9]+)$ ]]; then
+    echo "[X] Error: Invalid version format in VERSION file"
+    echo "Expected: MAJOR.MINOR.PATCH (e.g., 1.2.3)"
+    exit 1
+fi
+
+MAJOR="${BASH_REMATCH[1]}"
+MINOR="${BASH_REMATCH[2]}"
+PATCH="${BASH_REMATCH[3]}"
+
+# Determine bump type
+BUMP_TYPE="${1:-patch}"
+
+case "$BUMP_TYPE" in
+    major)
+        MAJOR=$((MAJOR + 1))
+        MINOR=0
+        PATCH=0
+        ;;
+    minor)
+        MINOR=$((MINOR + 1))
+        PATCH=0
+        ;;
+    patch)
+        PATCH=$((PATCH + 1))
+        ;;
+    *)
+        echo "[X] Error: Invalid bump type '$BUMP_TYPE'"
+        echo "Usage: $0 [major|minor|patch]"
+        exit 1
+        ;;
+esac
+
+NEW_VERSION="$MAJOR.$MINOR.$PATCH"
+
+echo "New version: $NEW_VERSION"
+echo ""
+echo "This will update hardcoded versions in:"
+echo "  1. VERSION file"
+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 ""
+
+# Already confirmed above in deprecation warning
+
+# Update VERSION file
+echo "$NEW_VERSION" > "$VERSION_FILE"
+echo "[OK] Updated VERSION file to $NEW_VERSION"
+
+# 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 "[OK] Updated installers/install.sh"
+else
+    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"
+    rm -f "$INSTALL_PS1.bak"
+    echo "[OK] Updated installers/install.ps1"
+else
+    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 "[OK] Synced version to package.json"
+else
+    echo "[X] Error: Failed to sync version to package.json"
+    exit 1
+fi
+
+echo ""
+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 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/check-executables.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+
+// Ensure executables have correct permissions (Unix only)
+if (process.platform !== 'win32') {
+  const executables = [
+    path.join(__dirname, '..', 'bin', 'ccs.js'),
+    path.join(__dirname, '..', 'lib', 'ccs'),
+  ];
+
+  for (const file of executables) {
+    if (fs.existsSync(file)) {
+      fs.chmodSync(file, '755');
+      console.log(`✓ Set executable: ${path.basename(file)}`);
+    }
+  }
+}

package/scripts/ci-parity-gate.sh

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$ROOT_DIR"
+
+if [[ "${CCS_SKIP_PREPUSH_GATE:-}" == "1" ]]; then
+  echo "[i] Skipping pre-push CI parity gate (CCS_SKIP_PREPUSH_GATE=1)."
+  exit 0
+fi
+
+if [[ ! -f AGENTS.md ]]; then
+  echo "[X] Missing AGENTS.md in this worktree."
+  echo "    Ensure you are in a valid CCS repository/worktree before pushing."
+  exit 1
+fi
+
+CURRENT_BRANCH="$(git rev-parse --abbrev-ref HEAD)"
+if [[ -z "$CURRENT_BRANCH" || "$CURRENT_BRANCH" == "HEAD" ]]; then
+  echo "[i] Detached HEAD detected. Skipping pre-push CI parity gate."
+  exit 0
+fi
+
+BASE_BRANCH="${CCS_PR_BASE:-}"
+if [[ -z "$BASE_BRANCH" ]]; then
+  if [[ "$CURRENT_BRANCH" == "main" || "$CURRENT_BRANCH" =~ ^hotfix/ || "$CURRENT_BRANCH" =~ ^kai/hotfix- ]]; then
+    BASE_BRANCH="main"
+  else
+    BASE_BRANCH="dev"
+  fi
+fi
+
+echo "[i] Pre-push CI parity gate"
+echo "    branch: $CURRENT_BRANCH"
+echo "    base:   $BASE_BRANCH"
+
+git fetch origin "$BASE_BRANCH" --quiet || true
+if git show-ref --verify --quiet "refs/remotes/origin/$BASE_BRANCH"; then
+  if ! git merge-base --is-ancestor "origin/$BASE_BRANCH" HEAD; then
+    echo "[X] Branch '$CURRENT_BRANCH' is behind origin/$BASE_BRANCH."
+    echo "    Rebase or merge before pushing:"
+    echo "    git pull --rebase origin $BASE_BRANCH"
+    exit 1
+  fi
+fi
+
+echo "[i] Running CI-equivalent local checks..."
+bun run build:all
+bun run validate
+
+echo "[OK] CI parity gate passed."

package/scripts/clean-dist.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+
+/**
+ * Clean dist directory while preserving UI bundle
+ * The UI bundle is built separately and should not be deleted during regular builds
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const DIST_DIR = path.join(__dirname, '../dist');
+const TSCONFIG_BUILDINFO = path.join(__dirname, '../tsconfig.tsbuildinfo');
+
+// Directories to preserve (from UI build)
+const PRESERVE = new Set(['ui']);
+
+function cleanDist() {
+  // Remove tsconfig.tsbuildinfo
+  if (fs.existsSync(TSCONFIG_BUILDINFO)) {
+    fs.unlinkSync(TSCONFIG_BUILDINFO);
+  }
+
+  // If dist doesn't exist, nothing to clean
+  if (!fs.existsSync(DIST_DIR)) {
+    return;
+  }
+
+  const entries = fs.readdirSync(DIST_DIR, { withFileTypes: true });
+
+  for (const entry of entries) {
+    // Skip preserved directories
+    if (PRESERVE.has(entry.name)) {
+      continue;
+    }
+
+    const fullPath = path.join(DIST_DIR, entry.name);
+
+    if (entry.isDirectory()) {
+      fs.rmSync(fullPath, { recursive: true, force: true });
+    } else {
+      fs.unlinkSync(fullPath);
+    }
+  }
+}
+
+cleanDist();