@georgedong32/ccs 7.66.0

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

@@ -0,0 +1,393 @@
+"use strict";
+/**
+ * ClaudeSymlinkManager - Manages selective symlinks from ~/.ccs/.claude/ to ~/.claude/
+ * v4.1.0: Selective symlinking for CCS items
+ *
+ * Purpose: Ship CCS items (.claude/) with package and symlink them to user's ~/.claude/
+ * Architecture:
+ *   - ~/.ccs/.claude/* (source, ships with CCS)
+ *   - ~/.claude/* (target, gets selective symlinks)
+ *   - ~/.ccs/shared/ (UNTOUCHED, existing profile mechanism)
+ *
+ * Symlink Chain:
+ *   profile -> ~/.ccs/shared/ -> ~/.claude/ (which has symlinks to ~/.ccs/.claude/)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeSymlinkManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const ui_1 = require("./ui");
+const config_manager_1 = require("./config-manager");
+// Make ora optional (might not be available during npm install postinstall)
+let ora = null;
+try {
+    const oraModule = require('ora');
+    ora = oraModule.default || oraModule;
+}
+catch {
+    // ora not available, create fallback spinner that uses console.log with UI colors
+    ora = function (text) {
+        return {
+            start: () => ({
+                succeed: (msg) => console.log(msg || (0, ui_1.ok)(text)),
+                fail: (msg) => console.log(msg || (0, ui_1.fail)(text)),
+                warn: (msg) => console.log(msg || (0, ui_1.warn)(text)),
+                info: (msg) => console.log(msg || (0, ui_1.info)(text)),
+                text: '',
+            }),
+        };
+    };
+}
+/**
+ * ClaudeSymlinkManager - Manages selective symlinks from ~/.ccs/.claude/ to ~/.claude/
+ */
+class ClaudeSymlinkManager {
+    constructor() {
+        // Use getCcsHome() for test isolation - respects CCS_HOME env var
+        this.homeDir = (0, config_manager_1.getCcsHome)();
+        this.ccsClaudeDir = path.join((0, config_manager_1.getCcsDir)(), '.claude');
+        this.userClaudeDir = path.join(this.homeDir, '.claude');
+        // CCS items to symlink (selective, item-level)
+        this.ccsItems = [
+            { source: 'commands/ccs.md', target: 'commands/ccs.md', type: 'file' },
+            { source: 'commands/ccs', target: 'commands/ccs', type: 'directory' },
+            { source: 'skills/ccs-delegation', target: 'skills/ccs-delegation', type: 'directory' },
+        ];
+    }
+    /**
+     * Install CCS items to user's ~/.claude/ via selective symlinks
+     * Safe: backs up existing files before creating symlinks
+     */
+    install(silent = false) {
+        const spinner = silent || !ora ? null : ora('Installing CCS items to ~/.claude/').start();
+        // Ensure ~/.ccs/.claude/ exists (should be shipped with package)
+        if (!fs.existsSync(this.ccsClaudeDir)) {
+            const msg = 'CCS .claude/ directory not found, skipping symlink installation';
+            if (spinner) {
+                spinner.warn((0, ui_1.warn)(msg));
+            }
+            else {
+                console.log((0, ui_1.warn)(msg));
+            }
+            return;
+        }
+        // Create ~/.claude/ if missing
+        if (!fs.existsSync(this.userClaudeDir)) {
+            if (!silent) {
+                if (spinner)
+                    spinner.text = 'Creating ~/.claude/ directory';
+            }
+            fs.mkdirSync(this.userClaudeDir, { recursive: true, mode: 0o700 });
+        }
+        // Install each CCS item
+        let installed = 0;
+        for (const item of this.ccsItems) {
+            if (!silent && spinner) {
+                spinner.text = `Installing ${item.target}...`;
+            }
+            const result = this.installItem(item, silent);
+            if (result)
+                installed++;
+        }
+        const msg = `${installed}/${this.ccsItems.length} items installed to ~/.claude/`;
+        if (spinner) {
+            spinner.succeed((0, ui_1.ok)(msg));
+        }
+        else {
+            console.log((0, ui_1.ok)(msg));
+        }
+    }
+    /**
+     * Install a single CCS item with conflict handling
+     */
+    installItem(item, silent = false) {
+        const sourcePath = path.join(this.ccsClaudeDir, item.source);
+        const targetPath = path.join(this.userClaudeDir, item.target);
+        const targetDir = path.dirname(targetPath);
+        // Ensure source exists
+        if (!fs.existsSync(sourcePath)) {
+            if (!silent)
+                console.log((0, ui_1.warn)(`Source not found: ${item.source}, skipping`));
+            return false;
+        }
+        // Create target parent directory if needed
+        if (!fs.existsSync(targetDir)) {
+            fs.mkdirSync(targetDir, { recursive: true, mode: 0o700 });
+        }
+        // Check if target already exists
+        if (fs.existsSync(targetPath)) {
+            // Check if it's already the correct symlink
+            if (this.isOurSymlink(targetPath, sourcePath)) {
+                return true; // Already correct, counts as success
+            }
+            // On Windows, check if it's a valid copy (symlink fallback from previous sync)
+            // This prevents creating duplicate backups on every sync
+            if (process.platform === 'win32' && this.isCopiedItem(targetPath, sourcePath, item.type)) {
+                // Remove existing copy and refresh with latest source content
+                try {
+                    if (item.type === 'directory') {
+                        fs.rmSync(targetPath, { recursive: true, force: true });
+                    }
+                    else {
+                        fs.unlinkSync(targetPath);
+                    }
+                }
+                catch {
+                    // If removal fails, proceed to copy which will overwrite
+                }
+                return this.copyFallback(sourcePath, targetPath, item, silent);
+            }
+            // Backup existing file/directory (only for non-CCS items)
+            this.backupItem(targetPath, silent);
+        }
+        // Create symlink
+        try {
+            const symlinkType = item.type === 'directory' ? 'dir' : 'file';
+            fs.symlinkSync(sourcePath, targetPath, symlinkType);
+            if (!silent)
+                console.log((0, ui_1.ok)(`Symlinked ${item.target}`));
+            return true;
+        }
+        catch (err) {
+            // Windows fallback: copy instead of symlink when symlinks unavailable
+            if (process.platform === 'win32') {
+                return this.copyFallback(sourcePath, targetPath, item, silent);
+            }
+            else {
+                const error = err;
+                if (!silent)
+                    console.log((0, ui_1.warn)(`Failed to symlink ${item.target}: ${error.message}`));
+            }
+            return false;
+        }
+    }
+    /**
+     * Windows fallback: copy files/directories when symlinks unavailable
+     * Note: Changes won't auto-sync; user must run 'ccs sync' after updates
+     */
+    copyFallback(sourcePath, targetPath, item, silent = false) {
+        try {
+            if (item.type === 'directory') {
+                // Copy directory recursively
+                this.copyDirRecursive(sourcePath, targetPath);
+            }
+            else {
+                // Copy single file
+                fs.copyFileSync(sourcePath, targetPath);
+            }
+            if (!silent) {
+                console.log((0, ui_1.ok)(`Copied ${item.target} (symlink unavailable)`));
+                console.log((0, ui_1.info)("Run 'ccs sync' after CCS updates to refresh"));
+            }
+            return true;
+        }
+        catch (copyErr) {
+            const error = copyErr;
+            if (!silent) {
+                console.log((0, ui_1.warn)(`Failed to copy ${item.target}: ${error.message}`));
+                console.log((0, ui_1.info)('Enable Developer Mode for symlinks, or check permissions'));
+            }
+            return false;
+        }
+    }
+    /**
+     * Recursively copy directory (for Windows fallback)
+     */
+    copyDirRecursive(src, dest) {
+        if (!fs.existsSync(dest)) {
+            fs.mkdirSync(dest, { recursive: true });
+        }
+        const entries = fs.readdirSync(src, { withFileTypes: true });
+        for (const entry of entries) {
+            const srcPath = path.join(src, entry.name);
+            const destPath = path.join(dest, entry.name);
+            if (entry.isDirectory()) {
+                this.copyDirRecursive(srcPath, destPath);
+            }
+            else {
+                fs.copyFileSync(srcPath, destPath);
+            }
+        }
+    }
+    /**
+     * Check if target is already the correct symlink pointing to source
+     */
+    isOurSymlink(targetPath, expectedSource) {
+        try {
+            const stats = fs.lstatSync(targetPath);
+            if (!stats.isSymbolicLink()) {
+                return false;
+            }
+            const actualTarget = fs.readlinkSync(targetPath);
+            const resolvedTarget = path.resolve(path.dirname(targetPath), actualTarget);
+            return resolvedTarget === expectedSource;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Backup existing item before replacing with symlink
+     */
+    backupItem(itemPath, silent = false) {
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-').split('T')[0];
+        const backupPath = `${itemPath}.backup-${timestamp}`;
+        try {
+            // If backup already exists, use counter
+            let finalBackupPath = backupPath;
+            let counter = 1;
+            while (fs.existsSync(finalBackupPath)) {
+                finalBackupPath = `${backupPath}-${counter}`;
+                counter++;
+            }
+            fs.renameSync(itemPath, finalBackupPath);
+            if (!silent)
+                console.log((0, ui_1.info)(`Backed up existing item to ${path.basename(finalBackupPath)}`));
+        }
+        catch (err) {
+            const error = err;
+            if (!silent)
+                console.log((0, ui_1.warn)(`Failed to backup ${itemPath}: ${error.message}`));
+            throw err; // Don't proceed if backup fails
+        }
+    }
+    /**
+     * Uninstall CCS items from ~/.claude/ (remove symlinks or copied files)
+     * Safe: only removes items that are CCS symlinks or valid copies
+     * @returns number of items removed
+     */
+    uninstall() {
+        let removed = 0;
+        for (const item of this.ccsItems) {
+            const targetPath = path.join(this.userClaudeDir, item.target);
+            const sourcePath = path.join(this.ccsClaudeDir, item.source);
+            // Check if it's our symlink or a valid copy (Windows fallback)
+            const isSymlink = this.isOurSymlink(targetPath, sourcePath);
+            const isCopy = process.platform === 'win32' && this.isCopiedItem(targetPath, sourcePath, item.type);
+            if (fs.existsSync(targetPath) && (isSymlink || isCopy)) {
+                try {
+                    if (item.type === 'directory' && !isSymlink) {
+                        // Remove copied directory recursively
+                        fs.rmSync(targetPath, { recursive: true, force: true });
+                    }
+                    else {
+                        // Remove symlink or file
+                        fs.unlinkSync(targetPath);
+                    }
+                    console.log((0, ui_1.ok)(`Removed ${item.target}`));
+                    removed++;
+                }
+                catch (err) {
+                    const error = err;
+                    console.log((0, ui_1.warn)(`Failed to remove ${item.target}: ${error.message}`));
+                }
+            }
+        }
+        if (removed > 0) {
+            console.log((0, ui_1.ok)(`Removed ${removed} delegation commands and skills from ~/.claude/`));
+        }
+        else {
+            console.log((0, ui_1.info)('No delegation commands or skills to remove'));
+        }
+        return removed;
+    }
+    /**
+     * Check symlink health and report issues
+     * Used by 'ccs doctor' command
+     */
+    checkHealth() {
+        const issues = [];
+        let healthy = true;
+        // Check if ~/.ccs/.claude/ exists
+        if (!fs.existsSync(this.ccsClaudeDir)) {
+            issues.push('CCS .claude/ directory missing (reinstall CCS)');
+            healthy = false;
+            return { healthy, issues };
+        }
+        // Check each item
+        for (const item of this.ccsItems) {
+            const sourcePath = path.join(this.ccsClaudeDir, item.source);
+            const targetPath = path.join(this.userClaudeDir, item.target);
+            // Check source exists
+            if (!fs.existsSync(sourcePath)) {
+                issues.push(`Source missing: ${item.source}`);
+                healthy = false;
+                continue;
+            }
+            // Check target
+            if (!fs.existsSync(targetPath)) {
+                issues.push(`Not installed: ${item.target} (run 'ccs sync' to install)`);
+                healthy = false;
+            }
+            else if (!this.isOurSymlink(targetPath, sourcePath)) {
+                // On Windows, copied files are valid (symlink fallback)
+                if (process.platform === 'win32' && this.isCopiedItem(targetPath, sourcePath, item.type)) {
+                    // Copied file is valid on Windows, but note it's not a symlink
+                    issues.push(`${item.target} is a copy (not symlink) - run 'ccs sync' after updates`);
+                    // Still healthy, just a warning
+                }
+                else {
+                    issues.push(`Not a CCS symlink: ${item.target} (run 'ccs sync' to fix)`);
+                    healthy = false;
+                }
+            }
+        }
+        return { healthy, issues };
+    }
+    /**
+     * Check if target is a valid copy of source (Windows fallback check)
+     */
+    isCopiedItem(targetPath, sourcePath, type) {
+        try {
+            const targetStats = fs.statSync(targetPath);
+            const sourceStats = fs.statSync(sourcePath);
+            if (type === 'directory') {
+                // For directories, just check both exist and are directories
+                return targetStats.isDirectory() && sourceStats.isDirectory();
+            }
+            else {
+                // For files, compare size as basic validation
+                return (targetStats.isFile() && sourceStats.isFile() && targetStats.size === sourceStats.size);
+            }
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Sync delegation commands and skills to ~/.claude/ (used by 'ccs sync' command)
+     * Same as install() but with explicit sync message
+     */
+    sync() {
+        console.log('');
+        console.log((0, ui_1.color)('Syncing CCS Components...', 'info'));
+        console.log('');
+        this.install(false);
+    }
+}
+exports.ClaudeSymlinkManager = ClaudeSymlinkManager;
+exports.default = ClaudeSymlinkManager;
+//# sourceMappingURL=claude-symlink-manager.js.map

package/dist/utils/claude-symlink-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-symlink-manager.js","sourceRoot":"","sources":["../../src/utils/claude-symlink-manager.ts"],"names":[],"mappings":"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"}

package/dist/utils/config-manager.d.ts

@@ -0,0 +1,87 @@
+import type { Config, Settings } from '../types';
+export declare function runWithScopedConfig<T>(scope: {
+    ccsHome?: string;
+    ccsDir?: string;
+}, fn: () => Promise<T> | T): Promise<T>;
+export declare function runWithScopedCcsHome<T>(ccsHome: string, fn: () => Promise<T> | T): Promise<T>;
+export declare function runWithScopedConfigDir<T>(ccsDir: string, fn: () => Promise<T> | T): Promise<T>;
+/**
+ * Set global config directory from --config-dir CLI flag.
+ * Must be called before any config loading.
+ * Pass undefined to clear (useful for tests).
+ */
+export declare function setGlobalConfigDir(dir: string | undefined): void;
+/**
+ * Get the CCS home directory (respects CCS_HOME env var for test isolation)
+ * @returns Home directory path
+ */
+export declare function getCcsHome(): string;
+/**
+ * Get the CCS directory path.
+ * Precedence: --config-dir flag > CCS_DIR env > CCS_HOME env (legacy, appends .ccs) > ~/.ccs default
+ * @returns Path to CCS config directory
+ */
+export declare function getCcsDir(): string;
+/**
+ * Get which source determined the CCS directory (for diagnostics).
+ * @returns [source_label, resolved_path] tuple
+ */
+export declare function getCcsDirSource(): [string, string];
+/**
+ * Get the CCS directory as a user-facing display path.
+ * Keeps the default path concise while preserving explicit overrides.
+ */
+export declare function getCcsDirDisplay(): string;
+/**
+ * Check if a path is under a cloud-synced folder.
+ * @returns Detected service name or null
+ */
+export declare function detectCloudSyncPath(dir: string): string | null;
+/**
+ * Get CCS hooks directory (respects CCS_HOME for test isolation)
+ * @returns Path to hooks directory
+ */
+export declare function getCcsHooksDir(): string;
+/**
+ * Get config file path (legacy JSON path)
+ * @deprecated Use getActiveConfigPath() for mode-aware config path
+ */
+export declare function getConfigPath(): string;
+/**
+ * Get the active config file path based on current mode.
+ * Returns config.yaml in unified mode, config.json in legacy mode.
+ * @returns Path to the active config file
+ */
+export declare function getActiveConfigPath(): string;
+/**
+ * Load and validate config.json
+ */
+export declare function loadConfig(): Config;
+/**
+ * Load and validate settings.json
+ */
+export declare function loadSettings(settingsPath: string): Settings;
+/**
+ * Read and parse config (legacy compatibility)
+ */
+export declare function readConfig(): Config;
+/**
+ * Load config safely with unified mode support.
+ * Returns Config with profiles from unified config.yaml or legacy config.json.
+ * Throws on error (catchable) instead of process.exit.
+ * Use this in web server routes where try/catch is needed.
+ */
+export declare function loadConfigSafe(): Config;
+/**
+ * Get settings path for profile.
+ * In unified mode (config.yaml exists), reads from config.yaml first,
+ * then falls back to config.json for backward compatibility.
+ */
+export declare function getSettingsPath(profile: string): string;
+/**
+ * Get display name for a profile by reading ANTHROPIC_MODEL from settings
+ * @param profile - Profile name (glm, km, glmt compatibility, custom, etc.)
+ * @returns Formatted display name (e.g., 'GLM-4.7', 'Kimi', 'Custom-Model')
+ */
+export declare function getModelDisplayName(profile: string): string;
+//# sourceMappingURL=config-manager.d.ts.map

package/dist/utils/config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../src/utils/config-manager.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAiD,MAAM,UAAU,CAAC;AAiBhG,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,KAAK,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5C,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEhE;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAMnC;AAkBD;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAGlD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC;AAgBD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS9D;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAM5C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAmBnC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,CAa3D;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAiEvC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAiFvD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA2B3D"}