@kaitranntt/ccs 7.48.0-dev.3 → 7.48.1-dev.1

package/README.md

@@ -241,6 +241,16 @@ ccs update --force      # Force reinstall
 ccs update --beta       # Install dev channel
 ```
 
+### CI Parity Gate (for contributors)
+
+Before opening or updating a PR, run:
+
+```bash
+bun run validate:ci-parity
+```
+
+This mirrors CI behavior (build + validate + base-branch freshness check) and is also enforced by the local `pre-push` hook.
+
 ### Sync Shared Items
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaitranntt/ccs",
-  "version": "7.48.0-dev.3",
+  "version": "7.48.1-dev.1",
   "description": "Claude Code Switch - Instant profile switching between Claude Sonnet 4.5 and GLM 4.6",
   "keywords": [
     "cli",
@@ -43,7 +43,7 @@
     "node": ">=18.0.0",
     "bun": ">=1.0.0"
   },
-  "packageManager": "bun@1.2.21",
+  "packageManager": "bun@1.3.9",
   "os": [
     "darwin",
     "linux",
@@ -66,6 +66,7 @@
     "format": "prettier --write src/",
     "format:check": "prettier --check src/",
     "validate": "bun run typecheck && bun run lint:fix && bun run format:check && bun run maintainability:check && bun run test:all",
+    "validate:ci-parity": "bash scripts/ci-parity-gate.sh",
     "verify:bundle": "node scripts/verify-bundle.js",
     "maintainability:baseline": "node scripts/maintainability-baseline.js --out docs/metrics/maintainability-baseline.json",
     "maintainability:check": "node scripts/maintainability-baseline.js --check docs/metrics/maintainability-baseline.json",

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."