@kaitranntt/ccs 4.4.0 → 5.0.0

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

@@ -0,0 +1,289 @@
+"use strict";
+/**
+ * ClaudeDirInstaller - Manages copying .claude/ directory from package to ~/.ccs/.claude/
+ * v4.1.1: Fix for npm install not copying .claude/ directory
+ */
+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.ClaudeDirInstaller = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const helpers_1 = require("./helpers");
+// 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
+    ora = function (text) {
+        return {
+            start: () => ({
+                succeed: (msg) => console.log(msg || `[OK] ${text}`),
+                fail: (msg) => console.log(msg || `[X] ${text}`),
+                warn: (msg) => console.log(msg || `[!] ${text}`),
+                info: (msg) => console.log(msg || `[i] ${text}`),
+                text: '',
+            }),
+        };
+    };
+}
+/**
+ * ClaudeDirInstaller - Manages copying .claude/ directory from package to ~/.ccs/.claude/
+ */
+class ClaudeDirInstaller {
+    constructor() {
+        this.homeDir = os.homedir();
+        this.ccsClaudeDir = path.join(this.homeDir, '.ccs', '.claude');
+    }
+    /**
+     * Copy .claude/ directory from package to ~/.ccs/.claude/
+     * @param packageDir - Package installation directory (default: auto-detect)
+     * @param silent - Suppress spinner output
+     */
+    install(packageDir, silent = false) {
+        const spinner = silent || !ora ? null : ora('Copying .claude/ items to ~/.ccs/.claude/').start();
+        try {
+            // Auto-detect package directory if not provided
+            if (!packageDir) {
+                // Try to find package root by going up from this file
+                packageDir = path.join(__dirname, '..', '..');
+            }
+            const packageClaudeDir = path.join(packageDir, '.claude');
+            if (!fs.existsSync(packageClaudeDir)) {
+                const msg = 'Package .claude/ directory not found';
+                if (spinner) {
+                    spinner.warn(`[!] ${msg}`);
+                    console.log(`    Searched in: ${packageClaudeDir}`);
+                    console.log('    This may be a development installation');
+                }
+                else {
+                    console.log(`[!] ${msg}`);
+                    console.log(`    Searched in: ${packageClaudeDir}`);
+                    console.log('    This may be a development installation');
+                }
+                return false;
+            }
+            // Remove old version before copying new one
+            if (fs.existsSync(this.ccsClaudeDir)) {
+                if (spinner)
+                    spinner.text = 'Removing old .claude/ items...';
+                fs.rmSync(this.ccsClaudeDir, { recursive: true, force: true });
+            }
+            // Use fs.cpSync for recursive copy (Node.js 16.7.0+)
+            if (spinner)
+                spinner.text = 'Copying .claude/ items...';
+            if (fs.cpSync) {
+                fs.cpSync(packageClaudeDir, this.ccsClaudeDir, { recursive: true });
+            }
+            else {
+                // Fallback for Node.js < 16.7.0
+                this.copyDirRecursive(packageClaudeDir, this.ccsClaudeDir);
+            }
+            // Count files and directories
+            const itemCount = this.countItems(this.ccsClaudeDir);
+            const msg = `Copied .claude/ items (${itemCount.files} files, ${itemCount.dirs} directories)`;
+            if (spinner) {
+                spinner.succeed((0, helpers_1.colored)('[OK]', 'green') + ` ${msg}`);
+            }
+            else {
+                console.log(`[OK] ${msg}`);
+            }
+            return true;
+        }
+        catch (err) {
+            const error = err;
+            const msg = `Failed to copy .claude/ directory: ${error.message}`;
+            if (spinner) {
+                spinner.fail((0, helpers_1.colored)('[!]', 'yellow') + ` ${msg}`);
+                console.warn('    CCS items may not be available');
+            }
+            else {
+                console.warn(`[!] ${msg}`);
+                console.warn('    CCS items may not be available');
+            }
+            return false;
+        }
+    }
+    /**
+     * Recursively copy directory (fallback for Node.js < 16.7.0)
+     */
+    copyDirRecursive(src, dest) {
+        // Create destination directory
+        if (!fs.existsSync(dest)) {
+            fs.mkdirSync(dest, { recursive: true });
+        }
+        // Read source directory
+        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()) {
+                // Recursively copy subdirectory
+                this.copyDirRecursive(srcPath, destPath);
+            }
+            else {
+                // Copy file
+                fs.copyFileSync(srcPath, destPath);
+            }
+        }
+    }
+    /**
+     * Count files and directories in a path
+     */
+    countItems(dirPath) {
+        let files = 0;
+        let dirs = 0;
+        const countRecursive = (p) => {
+            const entries = fs.readdirSync(p, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    dirs++;
+                    countRecursive(path.join(p, entry.name));
+                }
+                else {
+                    files++;
+                }
+            }
+        };
+        try {
+            countRecursive(dirPath);
+        }
+        catch {
+            // Ignore errors
+        }
+        return { files, dirs };
+    }
+    /**
+     * Clean up deprecated files from previous installations
+     * Removes ccs-delegator.md that was deprecated in v4.3.2
+     */
+    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');
+        const 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
+            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) {
+                const error = err;
+                // File doesn't exist or other error - that's okay
+                if (error.code !== 'ENOENT' && !silent) {
+                    console.log(`[!] Failed to remove user symlink: ${error.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) {
+                    const error = err;
+                    if (!silent)
+                        console.log(`[!] Failed to remove package copy: ${error.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) {
+            const error = err;
+            if (!silent)
+                console.log(`[!] Cleanup failed: ${error.message}`);
+            return { success: false, error: error.message, cleanedFiles };
+        }
+    }
+    /**
+     * Check if deprecated file should be backed up (user modified)
+     */
+    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 {
+            // If we can't determine, err on side of caution and backup
+            return true;
+        }
+    }
+    /**
+     * Check if ~/.ccs/.claude/ exists and is valid
+     */
+    isInstalled() {
+        return fs.existsSync(this.ccsClaudeDir);
+    }
+}
+exports.ClaudeDirInstaller = ClaudeDirInstaller;
+exports.default = ClaudeDirInstaller;
+//# sourceMappingURL=claude-dir-installer.js.map

package/dist/utils/claude-dir-installer.js.map

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

package/dist/utils/claude-symlink-manager.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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/)
+ */
+interface HealthCheckResult {
+    healthy: boolean;
+    issues: string[];
+}
+/**
+ * ClaudeSymlinkManager - Manages selective symlinks from ~/.ccs/.claude/ to ~/.claude/
+ */
+export declare class ClaudeSymlinkManager {
+    private homeDir;
+    private ccsClaudeDir;
+    private userClaudeDir;
+    private ccsItems;
+    constructor();
+    /**
+     * Install CCS items to user's ~/.claude/ via selective symlinks
+     * Safe: backs up existing files before creating symlinks
+     */
+    install(silent?: boolean): void;
+    /**
+     * Install a single CCS item with conflict handling
+     */
+    private installItem;
+    /**
+     * Check if target is already the correct symlink pointing to source
+     */
+    private isOurSymlink;
+    /**
+     * Backup existing item before replacing with symlink
+     */
+    private backupItem;
+    /**
+     * Uninstall CCS items from ~/.claude/ (remove symlinks only)
+     * Safe: only removes items that are CCS symlinks
+     */
+    uninstall(): void;
+    /**
+     * Check symlink health and report issues
+     * Used by 'ccs doctor' command
+     */
+    checkHealth(): HealthCheckResult;
+    /**
+     * Sync delegation commands and skills to ~/.claude/ (used by 'ccs sync' command)
+     * Same as install() but with explicit sync message
+     */
+    sync(): void;
+}
+export default ClaudeSymlinkManager;
+//# sourceMappingURL=claude-symlink-manager.d.ts.map

package/dist/utils/claude-symlink-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-symlink-manager.d.ts","sourceRoot":"","sources":["../../src/utils/claude-symlink-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA8CH,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAY;;IAe5B;;;OAGG;IACH,OAAO,CAAC,MAAM,UAAQ,GAAG,IAAI;IAwC7B;;OAEG;IACH,OAAO,CAAC,WAAW;IAgDnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,OAAO,CAAC,UAAU;IAsBlB;;;OAGG;IACH,SAAS,IAAI,IAAI;IA2BjB;;;OAGG;IACH,WAAW,IAAI,iBAAiB;IAoChC;;;OAGG;IACH,IAAI,IAAI,IAAI;CAMb;AAED,eAAe,oBAAoB,CAAC"}

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

@@ -0,0 +1,291 @@
+"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 os = __importStar(require("os"));
+const helpers_1 = require("./helpers");
+// 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
+    ora = function (text) {
+        return {
+            start: () => ({
+                succeed: (msg) => console.log(msg || `[OK] ${text}`),
+                fail: (msg) => console.log(msg || `[X] ${text}`),
+                warn: (msg) => console.log(msg || `[!] ${text}`),
+                info: (msg) => console.log(msg || `[i] ${text}`),
+                text: '',
+            }),
+        };
+    };
+}
+/**
+ * ClaudeSymlinkManager - Manages selective symlinks from ~/.ccs/.claude/ to ~/.claude/
+ */
+class ClaudeSymlinkManager {
+    constructor() {
+        this.homeDir = os.homedir();
+        this.ccsClaudeDir = path.join(this.homeDir, '.ccs', '.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(`[!] ${msg}`);
+            }
+            else {
+                console.log(`[!] ${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, helpers_1.colored)('[OK]', 'green') + ` ${msg}`);
+        }
+        else {
+            console.log(`[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(`[!] 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
+            }
+            // Backup existing file/directory
+            this.backupItem(targetPath, silent);
+        }
+        // Create symlink
+        try {
+            const symlinkType = item.type === 'directory' ? 'dir' : 'file';
+            fs.symlinkSync(sourcePath, targetPath, symlinkType);
+            if (!silent)
+                console.log(`[OK] Symlinked ${item.target}`);
+            return true;
+        }
+        catch (err) {
+            // Windows fallback: stub for now, full implementation in v4.2
+            if (process.platform === 'win32') {
+                if (!silent) {
+                    console.log(`[!] Symlink failed for ${item.target} (Windows fallback deferred to v4.2)`);
+                    console.log(`[i] Enable Developer Mode or wait for next update`);
+                }
+            }
+            else {
+                const error = err;
+                if (!silent)
+                    console.log(`[!] Failed to symlink ${item.target}: ${error.message}`);
+            }
+            return false;
+        }
+    }
+    /**
+     * 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(`[i] Backed up existing item to ${path.basename(finalBackupPath)}`);
+        }
+        catch (err) {
+            const error = err;
+            if (!silent)
+                console.log(`[!] Failed to backup ${itemPath}: ${error.message}`);
+            throw err; // Don't proceed if backup fails
+        }
+    }
+    /**
+     * Uninstall CCS items from ~/.claude/ (remove symlinks only)
+     * Safe: only removes items that are CCS symlinks
+     */
+    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);
+            // Only remove if it's our symlink
+            if (fs.existsSync(targetPath) && this.isOurSymlink(targetPath, sourcePath)) {
+                try {
+                    fs.unlinkSync(targetPath);
+                    console.log(`[OK] Removed ${item.target}`);
+                    removed++;
+                }
+                catch (err) {
+                    const error = err;
+                    console.log(`[!] Failed to remove ${item.target}: ${error.message}`);
+                }
+            }
+        }
+        if (removed > 0) {
+            console.log(`[OK] Removed ${removed} delegation commands and skills from ~/.claude/`);
+        }
+        else {
+            console.log('[i] No delegation commands or skills to remove');
+        }
+    }
+    /**
+     * 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)) {
+                issues.push(`Not a CCS symlink: ${item.target} (run 'ccs sync' to fix)`);
+                healthy = false;
+            }
+        }
+        return { healthy, issues };
+    }
+    /**
+     * 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, helpers_1.colored)('Syncing CCS Components...', 'cyan'));
+        console.log('');
+        this.install(false);
+    }
+}
+exports.ClaudeSymlinkManager = ClaudeSymlinkManager;
+exports.default = ClaudeSymlinkManager;
+//# sourceMappingURL=claude-symlink-manager.js.map