@deepdiver_sj/claude-settings 0.1.0

package/dist/core/constants.js

@@ -0,0 +1,463 @@
+/**
+ * @file src/core/constants.ts
+ * @description Claude Settings 전역 상수 정의
+ * @author Claude
+ *
+ * 포함 내용:
+ * - 앱 메타데이터
+ * - 버전 정보
+ * - 폴더 구조 표준
+ * - 설정 파일명
+ * - 프로세스 상수
+ */
+/**
+ * 앱 메타데이터
+ *
+ * @constant
+ */
+export const APP_METADATA = {
+    /** 애플리케이션 이름 */
+    name: 'Claude Settings CLI',
+    /** 짧은 이름 (명령어용) */
+    shortName: 'claude-settings',
+    /** 애플리케이션 설명 */
+    description: 'Manage Claude global settings across Windows, Linux, and macOS',
+    /** 저자 */
+    author: 'Anthropic',
+    /** 라이선스 */
+    license: 'MIT',
+};
+/**
+ * 버전 정보
+ *
+ * @constant
+ * @note package.json과 동기화 필수
+ */
+export const VERSION = {
+    /** 주 버전 */
+    major: 0,
+    /** 부 버전 */
+    minor: 1,
+    /** 패치 버전 */
+    patch: 0,
+    /** 프리릴리즈 (alpha, beta, rc)*/
+    prerelease: 'alpha',
+    /**
+     * 전체 버전 문자열
+     * @example "0.1.0-alpha"
+     */
+    get full() {
+        const base = `${this.major}.${this.minor}.${this.patch}`;
+        return this.prerelease ? `${base}-${this.prerelease}` : base;
+    },
+};
+/**
+ * 표준화된 폴더 구조
+ *
+ * @constant
+ *
+ * Phase 1 마이그레이션의 목표 구조:
+ * ```
+ * claude/
+ * ├── config/          ← 설정 파일만
+ * ├── data/            ← 사용자 데이터
+ * ├── cache/           ← 캐시/임시
+ * ├── backup/          ← 백업
+ * └── state/           ← 런타임 상태
+ * ```
+ */
+export const FOLDER_STRUCTURE = {
+    // 주요 폴더
+    config: 'config',
+    data: 'data',
+    cache: 'cache',
+    backup: 'backup',
+    state: 'state',
+    // 데이터 하위 폴더
+    skills: 'skills',
+    plugins: 'plugins',
+    templates: 'templates',
+    teams: 'teams',
+    tasks: 'tasks',
+    // 캐시 하위 폴더
+    fileHistory: 'file-history',
+    pasteCache: 'paste-cache',
+    chrome: 'chrome',
+    // 상태 하위 폴더
+    hud: 'hud',
+    ide: 'ide',
+    wezterm: 'wezterm-shim',
+    // 마이그레이션용 (레거시 폴더)
+    legacyFileHistory: '%file-history%',
+    legacyHooks: '%hooks%',
+    legacyExecutables: '%executables%',
+};
+/**
+ * 설정 파일명
+ *
+ * @constant
+ */
+export const CONFIG_FILES = {
+    // 메인 설정
+    settings: 'settings.json',
+    settingsYaml: 'settings.yaml',
+    // 플러그인/스킬
+    plugins: 'plugins.json',
+    skills: 'skills.json',
+    // 사용자 설정
+    preferences: 'preferences.yaml',
+    userConfig: 'user.config.json',
+    // 시스템 설정
+    system: 'system.json',
+    environment: '.env',
+    // 메타데이터
+    manifest: 'manifest.json',
+    metadata: 'metadata.json',
+    // 버전 정보
+    version: '.version',
+    lastSync: '.last-sync',
+};
+/**
+ * 환경 이름
+ *
+ * @constant
+ */
+export const ENVIRONMENT = {
+    development: 'development',
+    production: 'production',
+    testing: 'testing',
+    staging: 'staging',
+};
+/**
+ * 로그 레벨
+ *
+ * @constant
+ * @see https://en.wikipedia.org/wiki/Syslog
+ */
+export const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    fatal: 4,
+};
+/**
+ * 플랫폼 이름 매핑
+ *
+ * @constant
+ */
+export const PLATFORM_NAMES = {
+    win32: 'Windows',
+    linux: 'Linux',
+    darwin: 'macOS',
+};
+/**
+ * 기본 타임아웃 (밀리초)
+ *
+ * @constant
+ */
+export const TIMEOUTS = {
+    /** 파일 읽기/쓰기 타임아웃 */
+    fileIO: 5000,
+    /** 네트워크 요청 타임아웃 */
+    network: 10000,
+    /** 프로세스 타임아웃 */
+    process: 30000,
+    /** 일반 작업 타임아웃 */
+    default: 15000,
+};
+/**
+ * 재시도 정책
+ *
+ * @constant
+ */
+export const RETRY_POLICY = {
+    /** 최대 재시도 횟수 */
+    maxAttempts: 3,
+    /** 초기 대기 시간 (밀리초) */
+    initialDelay: 100,
+    /** 최대 대기 시간 (밀리초) */
+    maxDelay: 5000,
+    /** 지수 백오프 배수 */
+    backoffMultiplier: 2,
+};
+/**
+ * 패턴 (정규표현식)
+ *
+ * @constant
+ */
+export const PATTERNS = {
+    // UUID v4 매칭
+    uuid: /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,
+    // 이메일
+    email: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
+    // 시맨틱 버전 (e.g., 1.2.3-alpha.4)
+    semver: /^\d+\.\d+\.\d+(?:-[a-z0-9.]+)?$/i,
+    // ISO 8601 날짜 (e.g., 2024-01-15T10:30:00Z)
+    isoDate: /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z?$/,
+    // 파일 경로 (Windows/Unix)
+    filePath: /^[a-zA-Z0-9._\-/\\~@:]+$/,
+};
+/**
+ * 권한 (chmod 값)
+ *
+ * @constant
+ */
+export const PERMISSIONS = {
+    // 폴더 권한
+    folderDefault: 0o755, // drwxr-xr-x
+    folderPrivate: 0o700, // drwx------
+    folderShared: 0o770, // drwxrwx---
+    // 파일 권한
+    fileDefault: 0o644, // -rw-r--r--
+    filePrivate: 0o600, // -rw-------
+    fileExecutable: 0o755, // -rwxr-xr-x
+};
+/**
+ * 파일 크기 상수 (바이트)
+ *
+ * @constant
+ */
+export const FILE_SIZES = {
+    KB: 1024,
+    MB: 1024 * 1024,
+    GB: 1024 * 1024 * 1024,
+};
+/**
+ * 마이그레이션 버전
+ *
+ * @constant
+ *
+ * 마이그레이션 히스토리:
+ * - 1.0: 초기 구조 (혼합형)
+ * - 2.0: Phase 1 표준화 (config/data/cache 분리)
+ * - 3.0: OS별 경로 표준화
+ */
+export const MIGRATION_VERSION = {
+    current: 3,
+    legacy: 1,
+    // 마이그레이션 타입
+    types: {
+        folderRestructure: 'folder_restructure',
+        pathStandardization: 'path_standardization',
+        uuidFolderRename: 'uuid_folder_rename',
+        cacheCleanup: 'cache_cleanup',
+    },
+};
+/**
+ * 지원하는 파일 인코딩
+ *
+ * @constant
+ */
+export const ENCODINGS = {
+    utf8: 'utf8',
+    utf16: 'utf16le',
+    ascii: 'ascii',
+    latin1: 'latin1',
+};
+/**
+ * 줄바꿈 타입
+ *
+ * @constant
+ */
+export const LINE_ENDINGS = {
+    lf: '\n', // Unix (Linux, macOS)
+    crlf: '\r\n', // Windows
+    cr: '\r', // Old Mac (레거시)
+};
+/**
+ * 캐시 만료 시간 (초)
+ *
+ * @constant
+ */
+export const CACHE_EXPIRY = {
+    short: 60 * 5, // 5분
+    medium: 60 * 60, // 1시간
+    long: 60 * 60 * 24, // 1일
+    veryLong: 60 * 60 * 24 * 7, // 1주
+};
+/**
+ * 에러 코드
+ *
+ * @constant
+ */
+export const ERROR_CODES = {
+    // 환경 에러
+    ENV_VAR_NOT_SET: 'ENV_VAR_NOT_SET',
+    UNSUPPORTED_PLATFORM: 'UNSUPPORTED_PLATFORM',
+    // 파일 에러
+    FILE_NOT_FOUND: 'FILE_NOT_FOUND',
+    FILE_WRITE_ERROR: 'FILE_WRITE_ERROR',
+    FILE_READ_ERROR: 'FILE_READ_ERROR',
+    // 경로 에러
+    INVALID_PATH: 'INVALID_PATH',
+    PATH_NORMALIZE_ERROR: 'PATH_NORMALIZE_ERROR',
+    // 권한 에러
+    PERMISSION_DENIED: 'PERMISSION_DENIED',
+    PERMISSION_ERROR: 'PERMISSION_ERROR',
+    // 설정 에러
+    CONFIG_PARSE_ERROR: 'CONFIG_PARSE_ERROR',
+    CONFIG_INVALID: 'CONFIG_INVALID',
+    // 마이그레이션 에러
+    MIGRATION_FAILED: 'MIGRATION_FAILED',
+    MIGRATION_CONFLICT: 'MIGRATION_CONFLICT',
+};
+/**
+ * 자주 사용되는 환경변수명
+ *
+ * @constant
+ */
+export const ENV_VARS = {
+    // Windows
+    appData: 'APPDATA',
+    localAppData: 'LOCALAPPDATA',
+    userProfile: 'USERPROFILE',
+    // Unix/Linux
+    home: 'HOME',
+    shell: 'SHELL',
+    // XDG (Linux)
+    xdgConfigHome: 'XDG_CONFIG_HOME',
+    xdgDataHome: 'XDG_DATA_HOME',
+    xdgCacheHome: 'XDG_CACHE_HOME',
+    xdgRuntimeDir: 'XDG_RUNTIME_DIR',
+    // 커스텀
+    claudeHome: 'CLAUDE_HOME',
+    claudeConfig: 'CLAUDE_CONFIG_HOME',
+    claudeData: 'CLAUDE_DATA_HOME',
+    claudeCache: 'CLAUDE_CACHE_HOME',
+    // 일반
+    temp: 'TEMP',
+    tmp: 'TMP',
+    user: 'USER',
+    username: 'USERNAME',
+    lang: 'LANG',
+    logLevel: 'LOG_LEVEL',
+    nodeEnv: 'NODE_ENV',
+};
+/**
+ * 플러그인 메타데이터 스키마 버전
+ *
+ * @constant
+ */
+export const PLUGIN_SCHEMA_VERSION = {
+    current: '1.0.0',
+    minSupported: '1.0.0',
+};
+/**
+ * 스킬 메타데이터 스키마 버전
+ *
+ * @constant
+ */
+export const SKILL_SCHEMA_VERSION = {
+    current: '1.0.0',
+    minSupported: '1.0.0',
+};
+/**
+ * 지원하는 파일 형식
+ *
+ * @constant
+ */
+export const FILE_FORMATS = {
+    json: '.json',
+    yaml: '.yaml',
+    yml: '.yml',
+    env: '.env',
+    toml: '.toml',
+    xml: '.xml',
+    js: '.js',
+    ts: '.ts',
+    mjs: '.mjs',
+};
+/**
+ * 마이그레이션 전략
+ *
+ * @constant
+ */
+export const MIGRATION_STRATEGY = {
+    // 백업 전략
+    backup: {
+        /** 마이그레이션 전 백업 생성 */
+        createBefore: true,
+        /** 마이그레이션 실패 시 롤백 */
+        rollbackOnFailure: true,
+        /** 백업 보관 기간 (일) */
+        retentionDays: 30,
+    },
+    // 검증 전략
+    validation: {
+        /** 마이그레이션 후 파일 무결성 검사 */
+        checkIntegrity: true,
+        /** 설정 유효성 검사 */
+        validateSchema: true,
+    },
+    // 성능 전략
+    performance: {
+        /** 병렬 처리 활성화 */
+        parallel: true,
+        /** 배치 크기 */
+        batchSize: 50,
+    },
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Snapshot (export / import) constants
+// ─────────────────────────────────────────────────────────────────────────────
+export const SNAPSHOT = {
+    /** Directories to copy relative to ~/.claude */
+    INCLUDE_DIRS: ['executables', 'rules'],
+    /** Top-level files to copy */
+    INCLUDE_FILES: ['CLAUDE.md', 'settings.json', '.omc-config.json'],
+    /** Directories to skip entirely */
+    EXCLUDE_DIRS: [
+        'file-history',
+        'backups',
+        'cache',
+        'paste-cache',
+        'debug',
+        'hud',
+        'ide',
+        'plans',
+        'projects',
+        'plugins/cache',
+        'todos',
+        'chrome',
+        'tmp',
+    ],
+    /** Top-level files to never export */
+    EXCLUDE_FILES: [
+        '.credentials.json',
+        '.session-stats.json',
+        '.omc/update-check.json',
+        '.omc/update-state.json',
+    ],
+    /** Directories containing plugin install manifests (re-install on import) */
+    INSTALL_META_DIRS: ['plugins/.install-manifests'],
+    /** Placeholder used in exported hooks paths */
+    CLAUDE_HOME_PLACEHOLDER: '{{CLAUDE_HOME}}',
+    /** Current snapshot format version */
+    SNAPSHOT_VERSION: '1',
+};
+export default {
+    APP_METADATA,
+    VERSION,
+    FOLDER_STRUCTURE,
+    CONFIG_FILES,
+    ENVIRONMENT,
+    LOG_LEVELS,
+    PLATFORM_NAMES,
+    TIMEOUTS,
+    RETRY_POLICY,
+    PATTERNS,
+    PERMISSIONS,
+    FILE_SIZES,
+    MIGRATION_VERSION,
+    ENCODINGS,
+    LINE_ENDINGS,
+    CACHE_EXPIRY,
+    ERROR_CODES,
+    ENV_VARS,
+    PLUGIN_SCHEMA_VERSION,
+    SKILL_SCHEMA_VERSION,
+    FILE_FORMATS,
+    MIGRATION_STRATEGY,
+};
+//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

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

package/dist/core/paths.d.ts

@@ -0,0 +1,134 @@
+/**
+ * @file src/core/paths.ts
+ * @description Claude Settings OS별 경로 계산 핵심 로직
+ * @author Claude
+ *
+ * 기능:
+ * - Windows: %APPDATA%, %LOCALAPPDATA% 처리
+ * - Linux: XDG Base Directory 표준 준수
+ * - macOS: ~/Library 구조 지원
+ * - 경로 정규화 및 검증
+ */
+/**
+ * 경로 설정 인터페이스
+ *
+ * @interface PathsConfig
+ * @property {string} config - 설정 파일 저장 경로
+ * @property {string} data - 사용자 데이터 저장 경로
+ * @property {string} cache - 캐시 저장 경로
+ * @property {string} [backup] - 백업 저장 경로 (선택)
+ * @property {string} [state] - 런타임 상태 저장 경로 (선택)
+ * @property {string} [runtime] - XDG_RUNTIME_DIR (Linux 전용)
+ *
+ * @example
+ * const config: PathsConfig = {
+ *   config: '/home/user/.config/claude',
+ *   data: '/home/user/.local/share/claude',
+ *   cache: '/home/user/.cache/claude',
+ * };
+ */
+export interface PathsConfig {
+    config: string;
+    data: string;
+    cache: string;
+    backup?: string;
+    state?: string;
+    runtime?: string;
+}
+/**
+ * 경로 계산 결과 인터페이스
+ *
+ * @interface PathsResult
+ * @property {string} config - 설정 폴더 절대경로
+ * @property {string} data - 데이터 폴더 절대경로
+ * @property {string} cache - 캐시 폴더 절대경로
+ * @property {string} [backup] - 백업 폴더 절대경로
+ * @property {string} [state] - 상태 폴더 절대경로
+ * @property {string} [runtime] - 런타임 폴더 절대경로
+ */
+export interface PathsResult extends PathsConfig {
+}
+/**
+ * 플랫폼 타입 정의
+ *
+ * @type PlatformType
+ */
+export type PlatformType = 'win32' | 'linux' | 'darwin';
+/**
+ * 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 declare function getPaths(platform?: PlatformType, customConfig?: Partial<PathsConfig>): PathsResult;
+/**
+ * 현재 환경의 경로 빠르게 획득
+ *
+ * getPaths()의 래퍼 함수로, 플랫폼과 커스텀 설정 없이 기본값만 사용합니다.
+ *
+ * @param {Partial<PathsConfig>} [customConfig] - 커스텀 설정
+ * @returns {PathsResult} 현재 환경의 경로
+ *
+ * @example
+ * const paths = getDefaultPaths();
+ */
+export declare function getDefaultPaths(customConfig?: Partial<PathsConfig>): PathsResult;
+/**
+ * 경로 검증
+ *
+ * @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 declare function isValidPath(pathStr: string, platform: PlatformType): boolean;
+/**
+ * 경로의 부모 폴더 확장
+ *
+ * @param {string} pathStr - 입력 경로
+ * @param {number} [levels=1] - 올라갈 폴더 레벨
+ * @returns {string} 부모 폴더 경로
+ *
+ * @example
+ * getParentPath('/home/user/.config/claude/data', 2)
+ * // => '/home/user/.config/claude'
+ */
+export declare function getParentPath(pathStr: string, levels?: number): string;
+/**
+ * Returns the actual Claude Code home directory (same on all platforms).
+ * Claude Code always uses ~/.claude regardless of OS.
+ */
+export declare function getClaudeHomePath(): string;
+declare const _default: {
+    getPaths: typeof getPaths;
+    getDefaultPaths: typeof getDefaultPaths;
+    isValidPath: typeof isValidPath;
+    getParentPath: typeof getParentPath;
+};
+export default _default;
+//# sourceMappingURL=paths.d.ts.map

package/dist/core/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAY,SAAQ,WAAW;CAAG;AAEnD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AA0LxD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,GAAE,YAAiD,EAC3D,YAAY,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAClC,WAAW,CA0Cb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAEhF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAgB5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM,CAMzE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;;;;;;;AAED,wBAKE"}