@deepdiver_sj/claude-settings 0.1.0

package/dist/core/paths.js

@@ -0,0 +1,318 @@
+/**
+ * @file src/core/paths.ts
+ * @description Claude Settings OS별 경로 계산 핵심 로직
+ * @author Claude
+ *
+ * 기능:
+ * - Windows: %APPDATA%, %LOCALAPPDATA% 처리
+ * - Linux: XDG Base Directory 표준 준수
+ * - macOS: ~/Library 구조 지원
+ * - 경로 정규화 및 검증
+ */
+import * as path from 'path';
+import * as os from 'os';
+/**
+ * 경로 문자열 정규화
+ *
+ * 기능:
+ * 1. OS별로 경로 구분자 통일
+ * 2. 더블 슬래시 제거
+ * 3. 끝 슬래시 제거
+ * 4. 틸드(~) 확장
+ *
+ * @param {string} inputPath - 입력 경로
+ * @param {PlatformType} platform - 운영체제 타입
+ * @returns {string} 정규화된 경로
+ *
+ * @example
+ * normalizePath('C:/Users/user//.config/', 'win32')
+ * // => 'C:\\Users\\user\\.config'
+ */
+function normalizePath(inputPath, platform) {
+    // 1️⃣ 틸드 확장
+    let normalizedPath = inputPath;
+    if (normalizedPath.startsWith('~')) {
+        const homeDir = os.homedir();
+        normalizedPath = normalizedPath.replace(/^~/, homeDir);
+    }
+    // 2️⃣ OS별 구분자로 통일
+    if (platform === 'win32') {
+        // Windows: 모든 슬래시를 백슬래시로 변환
+        normalizedPath = normalizedPath.replace(/\//g, '\\');
+    }
+    else {
+        // Linux, macOS: 모든 백슬래시를 슬래시로 변환
+        normalizedPath = normalizedPath.replace(/\\/g, '/');
+    }
+    // 3️⃣ 더블 슬래시 제거 (Windows UNC 경로 제외)
+    if (platform === 'win32') {
+        // Windows UNC 경로 (\\server\share) 보존
+        if (!normalizedPath.startsWith('\\\\')) {
+            normalizedPath = normalizedPath.replace(/\\\\/g, '\\');
+        }
+        else {
+            // UNC 경로 내부의 더블 슬래시만 제거
+            const unc = normalizedPath.substring(0, 2);
+            const rest = normalizedPath.substring(2).replace(/\\\\/g, '\\');
+            normalizedPath = unc + rest;
+        }
+    }
+    else {
+        // Unix: 더블 슬래시 제거 (단, 루트 경로 제외)
+        if (normalizedPath !== '/') {
+            normalizedPath = normalizedPath.replace(/\/+/g, '/');
+        }
+    }
+    // 4️⃣ 끝의 슬래시 제거
+    if (normalizedPath.length > 1) {
+        const sep = platform === 'win32' ? '\\' : '/';
+        normalizedPath = normalizedPath.replace(new RegExp(`${sep}+$`), '');
+    }
+    return normalizedPath;
+}
+/**
+ * Windows 경로 계산
+ *
+ * 우선순위:
+ * 1. %APPDATA% (설정 + 데이터)
+ * 2. %LOCALAPPDATA% (캐시)
+ * 3. %USERPROFILE% (폴백)
+ *
+ * @param {Partial<PathsConfig>} [customConfig] - 커스텀 설정
+ * @returns {PathsConfig} Windows 경로 설정
+ * @throws {Error} APPDATA 환경변수가 없을 때
+ *
+ * @example
+ * const paths = getWindowsPaths();
+ * // => {
+ * //   config: 'C:\\Users\\User\\AppData\\Roaming\\claude',
+ * //   data: 'C:\\Users\\User\\AppData\\Roaming\\claude\\data',
+ * //   cache: 'C:\\Users\\User\\AppData\\Local\\claude\\cache'
+ * // }
+ */
+function getWindowsPaths(customConfig) {
+    // 환경변수 확인
+    const appData = process.env.APPDATA;
+    const localAppData = process.env.LOCALAPPDATA || process.env.APPDATA;
+    const userProfile = process.env.USERPROFILE;
+    if (!appData && !userProfile) {
+        throw new Error('APPDATA environment variable not set. Please ensure you are running on Windows.');
+    }
+    // 기본값 설정
+    const baseAppData = appData || path.join(userProfile || '', 'AppData', 'Roaming');
+    const baseLocalAppData = localAppData || path.join(userProfile || '', 'AppData', 'Local');
+    return {
+        config: customConfig?.config || path.join(baseAppData, 'claude'),
+        data: customConfig?.data || path.join(baseAppData, 'claude', 'data'),
+        cache: customConfig?.cache || path.join(baseLocalAppData, 'claude', 'cache'),
+        backup: customConfig?.backup || path.join(baseAppData, 'claude', 'backup'),
+        state: customConfig?.state || path.join(baseAppData, 'claude', 'state'),
+    };
+}
+/**
+ * Linux 경로 계산 (XDG Base Directory 표준)
+ *
+ * XDG 환경변수:
+ * - $XDG_CONFIG_HOME (~/.config)
+ * - $XDG_DATA_HOME (~/.local/share)
+ * - $XDG_CACHE_HOME (~/.cache)
+ * - $XDG_RUNTIME_DIR (/run/user/{UID})
+ *
+ * @param {Partial<PathsConfig>} [customConfig] - 커스텀 설정
+ * @returns {PathsConfig} Linux 경로 설정
+ * @throws {Error} HOME 환경변수가 없을 때
+ *
+ * @example
+ * const paths = getLinuxPaths();
+ * // => {
+ * //   config: '/home/user/.config/claude',
+ * //   data: '/home/user/.local/share/claude',
+ * //   cache: '/home/user/.cache/claude',
+ * //   runtime: '/run/user/1000/claude'
+ * // }
+ */
+function getLinuxPaths(customConfig) {
+    // 홈 디렉토리 확인
+    const homeDir = process.env.HOME || os.homedir();
+    if (!homeDir) {
+        throw new Error('HOME environment variable not set');
+    }
+    // XDG Base Directory 환경변수 (기본값 설정)
+    const xdgConfigHome = process.env.XDG_CONFIG_HOME || path.join(homeDir, '.config');
+    const xdgDataHome = process.env.XDG_DATA_HOME || path.join(homeDir, '.local', 'share');
+    const xdgCacheHome = process.env.XDG_CACHE_HOME || path.join(homeDir, '.cache');
+    const xdgRuntimeDir = process.env.XDG_RUNTIME_DIR;
+    return {
+        config: customConfig?.config || path.join(xdgConfigHome, 'claude'),
+        data: customConfig?.data || path.join(xdgDataHome, 'claude'),
+        cache: customConfig?.cache || path.join(xdgCacheHome, 'claude'),
+        backup: customConfig?.backup || path.join(xdgDataHome, 'claude', 'backup'),
+        state: customConfig?.state || path.join(xdgDataHome, 'claude', 'state'),
+        runtime: customConfig?.runtime || (xdgRuntimeDir ? path.join(xdgRuntimeDir, 'claude') : undefined),
+    };
+}
+/**
+ * macOS 경로 계산
+ *
+ * macOS는 Linux와 달리 XDG 표준을 사용하지 않음.
+ * 대신 ~/Library 아래 Apple 가이드라인을 따름:
+ *
+ * - ~/Library/Preferences: 설정
+ * - ~/Library/Application Support: 데이터
+ * - ~/Library/Caches: 캐시
+ *
+ * @param {Partial<PathsConfig>} [customConfig] - 커스텀 설정
+ * @returns {PathsConfig} macOS 경로 설정
+ *
+ * @example
+ * const paths = getMacOSPaths();
+ * // => {
+ * //   config: '/Users/user/Library/Preferences/claude',
+ * //   data: '/Users/user/Library/Application Support/claude',
+ * //   cache: '/Users/user/Library/Caches/claude'
+ * // }
+ */
+function getMacOSPaths(customConfig) {
+    const homeDir = os.homedir();
+    return {
+        config: customConfig?.config || path.join(homeDir, 'Library', 'Preferences', 'claude'),
+        data: customConfig?.data || path.join(homeDir, 'Library', 'Application Support', 'claude'),
+        cache: customConfig?.cache || path.join(homeDir, 'Library', 'Caches', 'claude'),
+        backup: customConfig?.backup || path.join(homeDir, 'Library', 'Application Support', 'claude', 'backup'),
+        state: customConfig?.state || path.join(homeDir, 'Library', 'Application Support', 'claude', 'state'),
+    };
+}
+/**
+ * OS별 경로 계산 (메인 함수)
+ *
+ * @param {PlatformType} [platform] - 운영체제 타입 (기본값: process.platform)
+ * @param {Partial<PathsConfig>} [customConfig] - 커스텀 설정
+ * @returns {PathsResult} OS별 정규화된 경로
+ * @throws {Error} 필수 환경변수가 없거나 지원하지 않는 OS일 때
+ *
+ * @example
+ * // 현재 OS의 경로 획득
+ * const paths = getPaths();
+ * console.log(paths.config);
+ *
+ * @example
+ * // 특정 OS의 경로 획득
+ * const winPaths = getPaths('win32');
+ * const linuxPaths = getPaths('linux');
+ *
+ * @example
+ * // 커스텀 경로 적용
+ * const customPaths = getPaths('linux', {
+ *   cache: '/mnt/fast-ssd/claude-cache'
+ * });
+ */
+export function getPaths(platform = process.platform, customConfig) {
+    let pathsConfig;
+    // 플랫폼별 경로 계산
+    switch (platform) {
+        case 'win32':
+            pathsConfig = getWindowsPaths(customConfig);
+            break;
+        case 'linux':
+            pathsConfig = getLinuxPaths(customConfig);
+            break;
+        case 'darwin':
+            pathsConfig = getMacOSPaths(customConfig);
+            break;
+        default:
+            throw new Error(`Unsupported platform: ${platform}. Supported platforms: win32, linux, darwin`);
+    }
+    // 모든 경로 정규화
+    const normalizedPaths = {
+        config: normalizePath(pathsConfig.config, platform),
+        data: normalizePath(pathsConfig.data, platform),
+        cache: normalizePath(pathsConfig.cache, platform),
+    };
+    // 선택 경로 정규화
+    if (pathsConfig.backup) {
+        normalizedPaths.backup = normalizePath(pathsConfig.backup, platform);
+    }
+    if (pathsConfig.state) {
+        normalizedPaths.state = normalizePath(pathsConfig.state, platform);
+    }
+    if (pathsConfig.runtime) {
+        normalizedPaths.runtime = normalizePath(pathsConfig.runtime, platform);
+    }
+    return normalizedPaths;
+}
+/**
+ * 현재 환경의 경로 빠르게 획득
+ *
+ * getPaths()의 래퍼 함수로, 플랫폼과 커스텀 설정 없이 기본값만 사용합니다.
+ *
+ * @param {Partial<PathsConfig>} [customConfig] - 커스텀 설정
+ * @returns {PathsResult} 현재 환경의 경로
+ *
+ * @example
+ * const paths = getDefaultPaths();
+ */
+export function getDefaultPaths(customConfig) {
+    return getPaths(process.platform, customConfig);
+}
+/**
+ * 경로 검증
+ *
+ * @param {string} pathStr - 검증할 경로
+ * @param {PlatformType} platform - 운영체제 타입
+ * @returns {boolean} 유효한 경로일 경우 true
+ *
+ * 검증 항목:
+ * - 절대 경로인지 확인
+ * - OS별 금지 문자 없는지 확인
+ *
+ * @example
+ * isValidPath('C:\\Users\\test\\.config', 'win32') // => true
+ * isValidPath('/home/user/.config', 'linux')        // => true
+ */
+export function isValidPath(pathStr, platform) {
+    // 절대 경로 확인
+    if (!path.isAbsolute(pathStr)) {
+        return false;
+    }
+    // OS별 금지 문자 확인
+    if (platform === 'win32') {
+        // Windows 금지 문자: < > : " | ? *
+        const invalidCharsRegex = /[<>:"|?*]/;
+        if (invalidCharsRegex.test(pathStr)) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * 경로의 부모 폴더 확장
+ *
+ * @param {string} pathStr - 입력 경로
+ * @param {number} [levels=1] - 올라갈 폴더 레벨
+ * @returns {string} 부모 폴더 경로
+ *
+ * @example
+ * getParentPath('/home/user/.config/claude/data', 2)
+ * // => '/home/user/.config/claude'
+ */
+export function getParentPath(pathStr, levels = 1) {
+    let result = pathStr;
+    for (let i = 0; i < levels; i++) {
+        result = path.dirname(result);
+    }
+    return result;
+}
+/**
+ * Returns the actual Claude Code home directory (same on all platforms).
+ * Claude Code always uses ~/.claude regardless of OS.
+ */
+export function getClaudeHomePath() {
+    return path.join(os.homedir(), '.claude');
+}
+export default {
+    getPaths,
+    getDefaultPaths,
+    isValidPath,
+    getParentPath,
+};
+//# sourceMappingURL=paths.js.map

package/dist/core/paths.js.map

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

package/dist/snapshot/exporter.d.ts

@@ -0,0 +1,14 @@
+import type { ExportOptions, ExportResult } from './types.js';
+/**
+ * Replace absolute ~/.claude paths with the portable placeholder.
+ *
+ * Handles Windows  (C:\Users\foo\.claude\)
+ *         Linux    (/home/foo/.claude/)
+ *         macOS    (/Users/foo/.claude/)
+ */
+export declare function normalizeClaudePaths(text: string): string;
+/**
+ * Export the current ~/.claude environment to a portable snapshot JSON.
+ */
+export declare function exportSnapshot(options?: ExportOptions): Promise<ExportResult>;
+//# sourceMappingURL=exporter.d.ts.map

package/dist/snapshot/exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../../src/snapshot/exporter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,aAAa,EACb,YAAY,EAGb,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUzD;AA4ED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CA+EvB"}

package/dist/snapshot/exporter.js

@@ -0,0 +1,168 @@
+import fs from 'fs';
+import path from 'path';
+import { SNAPSHOT } from '../core/constants.js';
+import { getClaudeHomePath } from '../core/paths.js';
+/**
+ * Replace absolute ~/.claude paths with the portable placeholder.
+ *
+ * Handles Windows  (C:\Users\foo\.claude\)
+ *         Linux    (/home/foo/.claude/)
+ *         macOS    (/Users/foo/.claude/)
+ */
+export function normalizeClaudePaths(text) {
+    const placeholder = SNAPSHOT.CLAUDE_HOME_PLACEHOLDER + '/';
+    // Windows absolute path: any drive letter + path ending in .claude
+    const winPattern = /[A-Za-z]:\\[^"'\n]*?\.claude[\\\/]/g;
+    // POSIX absolute path
+    const posixPattern = /(?:\/home\/[^\/\n]+|\/Users\/[^\/\n]+)\/\.claude\//g;
+    return text
+        .replace(winPattern, () => placeholder)
+        .replace(posixPattern, () => placeholder);
+}
+/**
+ * Recursively collect files under `dirPath`.
+ * Paths stored relative to `baseDir`.
+ */
+function collectFiles(dirPath, baseDir, files) {
+    if (!fs.existsSync(dirPath))
+        return;
+    const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dirPath, entry.name);
+        const relPath = path
+            .relative(baseDir, fullPath)
+            .replace(/\\/g, '/'); // normalise to forward slashes
+        if (entry.isDirectory()) {
+            // Skip excluded sub-dirs
+            const relDir = path
+                .relative(baseDir, fullPath)
+                .replace(/\\/g, '/');
+            if (SNAPSHOT.EXCLUDE_DIRS.some((d) => relDir === d || relDir.startsWith(d + '/'))) {
+                continue;
+            }
+            collectFiles(fullPath, baseDir, files);
+        }
+        else if (entry.isFile()) {
+            // Skip excluded files
+            if (SNAPSHOT.EXCLUDE_FILES.includes(relPath))
+                continue;
+            try {
+                const content = fs.readFileSync(fullPath, 'utf8');
+                files.push({ relativePath: relPath, content });
+            }
+            catch {
+                // Binary or unreadable file — skip
+            }
+        }
+    }
+}
+/**
+ * Read plugin install manifests from plugins/.install-manifests/.
+ * Each manifest is expected to be a JSON file with { name, source, installCmd }.
+ */
+function collectPlugins(claudeHome) {
+    const plugins = [];
+    for (const metaDir of SNAPSHOT.INSTALL_META_DIRS) {
+        const manifestsDir = path.join(claudeHome, metaDir);
+        if (!fs.existsSync(manifestsDir))
+            continue;
+        const files = fs.readdirSync(manifestsDir);
+        for (const file of files) {
+            if (!file.endsWith('.json'))
+                continue;
+            try {
+                const raw = fs.readFileSync(path.join(manifestsDir, file), 'utf8');
+                const manifest = JSON.parse(raw);
+                if (manifest.name && manifest.source && manifest.installCmd) {
+                    plugins.push({
+                        name: manifest.name,
+                        source: manifest.source,
+                        installCmd: manifest.installCmd,
+                    });
+                }
+            }
+            catch {
+                // Malformed manifest — skip
+            }
+        }
+    }
+    return plugins;
+}
+/**
+ * Export the current ~/.claude environment to a portable snapshot JSON.
+ */
+export async function exportSnapshot(options = {}) {
+    try {
+        const claudeHome = getClaudeHomePath();
+        if (!fs.existsSync(claudeHome)) {
+            return {
+                success: false,
+                message: `Claude home directory not found: ${claudeHome}`,
+            };
+        }
+        const files = [];
+        // 1. Collect top-level include files
+        for (const fileName of SNAPSHOT.INCLUDE_FILES) {
+            const fullPath = path.join(claudeHome, fileName);
+            if (!fs.existsSync(fullPath))
+                continue;
+            try {
+                const content = fs.readFileSync(fullPath, 'utf8');
+                files.push({ relativePath: fileName, content });
+            }
+            catch {
+                // skip
+            }
+        }
+        // 2. Collect include directories recursively
+        for (const dir of SNAPSHOT.INCLUDE_DIRS) {
+            collectFiles(path.join(claudeHome, dir), claudeHome, files);
+        }
+        // 3. Normalise paths in all collected file contents
+        const normalizedFiles = files.map((f) => ({
+            ...f,
+            content: normalizeClaudePaths(f.content),
+        }));
+        // 4. Read & normalise settings.json separately (already included above,
+        //    but we also store it as a parsed object for easy import-time manipulation)
+        let settings = {};
+        const settingsPath = path.join(claudeHome, 'settings.json');
+        if (fs.existsSync(settingsPath)) {
+            try {
+                const raw = fs.readFileSync(settingsPath, 'utf8');
+                const normalised = normalizeClaudePaths(raw);
+                settings = JSON.parse(normalised);
+            }
+            catch {
+                // keep empty object
+            }
+        }
+        // 5. Collect plugin manifests
+        const plugins = collectPlugins(claudeHome);
+        const snapshot = {
+            version: SNAPSHOT.SNAPSHOT_VERSION,
+            exportedAt: new Date().toISOString(),
+            sourceOS: process.platform,
+            files: normalizedFiles,
+            settings,
+            plugins,
+        };
+        const outputPath = options.outputPath ?? path.join(process.cwd(), 'env-snapshot.json');
+        fs.writeFileSync(outputPath, JSON.stringify(snapshot, null, 2), 'utf8');
+        return {
+            success: true,
+            message: `Snapshot exported to ${outputPath}`,
+            outputPath,
+            fileCount: normalizedFiles.length,
+            pluginCount: plugins.length,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: `Export failed: ${error.message}`,
+            error: error,
+        };
+    }
+}
+//# sourceMappingURL=exporter.js.map

package/dist/snapshot/exporter.js.map

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

package/dist/snapshot/importer.d.ts

@@ -0,0 +1,11 @@
+import type { ImportOptions, ImportResult } from './types.js';
+/**
+ * Replace {{CLAUDE_HOME}} placeholders with the real target path.
+ * Uses the OS-native separator so hooks work correctly on the target machine.
+ */
+export declare function restoreClaudePaths(text: string, claudeHome: string): string;
+/**
+ * Import a snapshot JSON and restore the Claude environment on this machine.
+ */
+export declare function importSnapshot(options: ImportOptions): Promise<ImportResult>;
+//# sourceMappingURL=importer.d.ts.map

package/dist/snapshot/importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../src/snapshot/importer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAe,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3E;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAM3E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAwGlF"}

package/dist/snapshot/importer.js

@@ -0,0 +1,118 @@
+import fs from 'fs';
+import path from 'path';
+import { spawnSync } from 'child_process';
+import { SNAPSHOT } from '../core/constants.js';
+import { getClaudeHomePath } from '../core/paths.js';
+/**
+ * Replace {{CLAUDE_HOME}} placeholders with the real target path.
+ * Uses the OS-native separator so hooks work correctly on the target machine.
+ */
+export function restoreClaudePaths(text, claudeHome) {
+    // Normalise separator to forward slash for the replacement value
+    // because most shell / node scripts accept forward slashes on all platforms
+    const normalizedHome = claudeHome.replace(/\\/g, '/');
+    const placeholder = SNAPSHOT.CLAUDE_HOME_PLACEHOLDER;
+    return text.replaceAll(placeholder, normalizedHome);
+}
+/**
+ * Import a snapshot JSON and restore the Claude environment on this machine.
+ */
+export async function importSnapshot(options) {
+    const errors = [];
+    let filesWritten = 0;
+    let pluginsInstalled = 0;
+    try {
+        if (!fs.existsSync(options.snapshotPath)) {
+            return {
+                success: false,
+                message: `Snapshot file not found: ${options.snapshotPath}`,
+                errors: [`File not found: ${options.snapshotPath}`],
+            };
+        }
+        const raw = fs.readFileSync(options.snapshotPath, 'utf8');
+        const snapshot = JSON.parse(raw);
+        const claudeHome = getClaudeHomePath();
+        const dryRun = options.dryRun ?? false;
+        if (dryRun) {
+            console.log(`[dry-run] Target: ${claudeHome}`);
+        }
+        // 1. Write environment files
+        for (const file of snapshot.files) {
+            const targetPath = path.join(claudeHome, file.relativePath);
+            const restored = restoreClaudePaths(file.content, claudeHome);
+            if (dryRun) {
+                console.log(`[dry-run] Would write: ${targetPath}`);
+                continue;
+            }
+            try {
+                fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+                fs.writeFileSync(targetPath, restored, 'utf8');
+                filesWritten++;
+            }
+            catch (err) {
+                errors.push(`Failed to write ${file.relativePath}: ${err.message}`);
+            }
+        }
+        // 2. Write settings.json (path-restored version)
+        if (Object.keys(snapshot.settings).length > 0) {
+            const settingsStr = JSON.stringify(snapshot.settings, null, 2);
+            const restoredSettings = restoreClaudePaths(settingsStr, claudeHome);
+            const settingsTarget = path.join(claudeHome, 'settings.json');
+            if (dryRun) {
+                console.log(`[dry-run] Would write settings.json to ${settingsTarget}`);
+            }
+            else {
+                try {
+                    fs.mkdirSync(path.dirname(settingsTarget), { recursive: true });
+                    fs.writeFileSync(settingsTarget, restoredSettings, 'utf8');
+                    // Don't double-count settings.json (it's already in files[])
+                }
+                catch (err) {
+                    errors.push(`Failed to write settings.json: ${err.message}`);
+                }
+            }
+        }
+        // 3. Install plugins
+        for (const plugin of snapshot.plugins) {
+            const restoredCmd = restoreClaudePaths(plugin.installCmd, claudeHome);
+            if (dryRun) {
+                console.log(`[dry-run] Would install plugin "${plugin.name}": ${restoredCmd}`);
+                continue;
+            }
+            try {
+                const parts = restoredCmd.split(' ');
+                const result = spawnSync(parts[0] ?? '', parts.slice(1), {
+                    stdio: 'inherit',
+                    shell: true,
+                });
+                if (result.status !== 0) {
+                    errors.push(`Plugin "${plugin.name}" install exited with code ${result.status ?? 'unknown'}`);
+                }
+                else {
+                    pluginsInstalled++;
+                }
+            }
+            catch (err) {
+                errors.push(`Plugin "${plugin.name}" install error: ${err.message}`);
+            }
+        }
+        const success = errors.length === 0;
+        return {
+            success,
+            message: dryRun
+                ? `Dry-run complete. Would write ${snapshot.files.length} file(s), install ${snapshot.plugins.length} plugin(s).`
+                : `Import complete. Wrote ${filesWritten} file(s), installed ${pluginsInstalled} plugin(s).${errors.length ? ` ${errors.length} error(s).` : ''}`,
+            filesWritten,
+            pluginsInstalled,
+            errors: errors.length > 0 ? errors : undefined,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: `Import failed: ${error.message}`,
+            errors: [error.message],
+        };
+    }
+}
+//# sourceMappingURL=importer.js.map

package/dist/snapshot/importer.js.map

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