@ginkoai/cli 1.0.0

package/dist/core/platform/path-resolver.js

@@ -0,0 +1,339 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-20
+ * @tags: [path, resolution, cross-platform, windows, unix, config]
+ * @related: [platform-adapter.ts, config-loader.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [path, os, platform-adapter]
+ */
+import * as path from 'path';
+import * as os from 'path';
+import { PlatformAdapter } from './platform-adapter';
+/**
+ * CrossPlatformPathResolver handles path resolution across different operating systems
+ */
+export class CrossPlatformPathResolver {
+    platformAdapter;
+    config;
+    constructor(platformAdapter) {
+        this.platformAdapter = platformAdapter || new PlatformAdapter();
+        this.config = this.initializeConfig();
+    }
+    /**
+     * Initialize platform-specific path configuration
+     */
+    initializeConfig() {
+        const platform = this.platformAdapter.detectPlatform();
+        const homeDir = os.homedir();
+        const config = {
+            platform,
+            separators: {
+                path: platform === 'windows' ? '\\' : '/',
+                drive: platform === 'windows' ? ':' : ''
+            },
+            roots: {
+                home: homeDir,
+                temp: platform === 'windows' ? process.env.TEMP || 'C:\\temp' : '/tmp',
+                config: this.platformAdapter.getClaudeConfigPath()
+            },
+            patterns: {
+                absolute: platform === 'windows'
+                    ? /^[A-Za-z]:\\/
+                    : /^\//,
+                relative: /^\.\.?\//,
+                home: /^~\//
+            }
+        };
+        return config;
+    }
+    /**
+     * Resolve a path for the current platform
+     */
+    resolvePath(inputPath, basePath) {
+        const normalizedInput = this.normalizeSeparators(inputPath);
+        let resolved;
+        let isAbsolute = false;
+        let isHome = false;
+        // Handle different path types
+        if (this.config.patterns.home.test(normalizedInput)) {
+            // Home directory path (~/)
+            resolved = this.resolveHomePath(normalizedInput);
+            isHome = true;
+            isAbsolute = true;
+        }
+        else if (this.config.patterns.absolute.test(normalizedInput)) {
+            // Absolute path
+            resolved = this.resolveAbsolutePath(normalizedInput);
+            isAbsolute = true;
+        }
+        else {
+            // Relative path
+            resolved = this.resolveRelativePath(normalizedInput, basePath);
+            isAbsolute = false;
+        }
+        // Normalize for current platform
+        resolved = this.normalizePath(resolved);
+        return {
+            original: inputPath,
+            resolved,
+            platform: this.config.platform,
+            isAbsolute,
+            isHome,
+            components: this.splitPath(resolved)
+        };
+    }
+    /**
+     * Resolve home directory path
+     */
+    resolveHomePath(homePath) {
+        const relativePart = homePath.substring(2); // Remove ~/
+        return path.join(this.config.roots.home, relativePart);
+    }
+    /**
+     * Resolve absolute path
+     */
+    resolveAbsolutePath(absolutePath) {
+        // Convert foreign platform absolute paths
+        if (this.config.platform === 'windows' && absolutePath.startsWith('/')) {
+            // Unix path on Windows - convert to Windows format
+            return 'C:' + absolutePath.replace(/\//g, '\\');
+        }
+        else if (this.config.platform !== 'windows' && /^[A-Za-z]:/.test(absolutePath)) {
+            // Windows path on Unix - convert to Unix format
+            const driveLetter = absolutePath[0].toLowerCase();
+            const pathPart = absolutePath.substring(2).replace(/\\/g, '/');
+            return `/mnt/${driveLetter}${pathPart}`;
+        }
+        return absolutePath;
+    }
+    /**
+     * Resolve relative path
+     */
+    resolveRelativePath(relativePath, basePath) {
+        const base = basePath || process.cwd();
+        return path.resolve(base, relativePath);
+    }
+    /**
+     * Normalize path separators for current platform
+     */
+    normalizeSeparators(inputPath) {
+        if (this.config.platform === 'windows') {
+            return inputPath.replace(/\//g, '\\');
+        }
+        else {
+            return inputPath.replace(/\\/g, '/');
+        }
+    }
+    /**
+     * Normalize path for current platform
+     */
+    normalizePath(inputPath) {
+        return path.normalize(this.normalizeSeparators(inputPath));
+    }
+    /**
+     * Split path into components
+     */
+    splitPath(inputPath) {
+        const normalized = this.normalizePath(inputPath);
+        const separator = this.config.separators.path;
+        return normalized.split(separator).filter(component => component.length > 0);
+    }
+    /**
+     * Join path components for current platform
+     */
+    joinPath(...components) {
+        return this.normalizePath(path.join(...components));
+    }
+    /**
+     * Convert path to platform-specific format
+     */
+    convertPathToPlatform(inputPath, targetPlatform) {
+        const resolved = this.resolvePath(inputPath);
+        if (targetPlatform === 'windows') {
+            // Convert to Windows format
+            if (resolved.resolved.startsWith('/')) {
+                // Unix absolute path
+                return 'C:' + resolved.resolved.replace(/\//g, '\\');
+            }
+            return resolved.resolved.replace(/\//g, '\\');
+        }
+        else {
+            // Convert to Unix format
+            if (/^[A-Za-z]:/.test(resolved.resolved)) {
+                // Windows absolute path
+                const driveLetter = resolved.resolved[0].toLowerCase();
+                const pathPart = resolved.resolved.substring(2).replace(/\\/g, '/');
+                return `/mnt/${driveLetter}${pathPart}`;
+            }
+            return resolved.resolved.replace(/\\/g, '/');
+        }
+    }
+    /**
+     * Get platform-specific special directories
+     */
+    getSpecialDirectory(type) {
+        const homeDir = this.config.roots.home;
+        switch (type) {
+            case 'home':
+                return homeDir;
+            case 'temp':
+                return this.config.roots.temp;
+            case 'config':
+                return this.config.roots.config;
+            case 'desktop':
+                if (this.config.platform === 'windows') {
+                    return path.join(homeDir, 'Desktop');
+                }
+                else if (this.config.platform === 'macos') {
+                    return path.join(homeDir, 'Desktop');
+                }
+                else {
+                    return path.join(homeDir, 'Desktop');
+                }
+            case 'documents':
+                if (this.config.platform === 'windows') {
+                    return path.join(homeDir, 'Documents');
+                }
+                else if (this.config.platform === 'macos') {
+                    return path.join(homeDir, 'Documents');
+                }
+                else {
+                    return path.join(homeDir, 'Documents');
+                }
+            default:
+                return homeDir;
+        }
+    }
+    /**
+     * Create portable path that works across platforms
+     */
+    createPortablePath(inputPath) {
+        const resolved = this.resolvePath(inputPath);
+        // Convert to portable format using forward slashes
+        let portable = resolved.resolved.replace(/\\/g, '/');
+        // Replace home directory with ~ if applicable
+        if (portable.startsWith(this.config.roots.home)) {
+            portable = portable.replace(this.config.roots.home, '~');
+        }
+        // Remove drive letters for Windows paths
+        if (this.config.platform === 'windows' && /^[A-Za-z]:/.test(portable)) {
+            portable = portable.substring(2);
+        }
+        return portable;
+    }
+    /**
+     * Validate path for platform compatibility
+     */
+    validatePath(inputPath, targetPlatform) {
+        const target = targetPlatform || this.config.platform;
+        const issues = [];
+        const suggestions = [];
+        // Check for platform-specific issues
+        if (target === 'windows') {
+            // Windows path validation
+            if (inputPath.includes('/') && !inputPath.includes('\\')) {
+                issues.push('Uses Unix path separators on Windows');
+                suggestions.push('Replace forward slashes with backslashes');
+            }
+            if (inputPath.length > 260) {
+                issues.push('Path exceeds Windows MAX_PATH limit (260 characters)');
+                suggestions.push('Shorten path or use long path support');
+            }
+            if (/[<>:"|?*]/.test(inputPath)) {
+                issues.push('Contains invalid Windows filename characters');
+                suggestions.push('Remove or replace invalid characters: < > : " | ? *');
+            }
+            if (inputPath.endsWith(' ') || inputPath.endsWith('.')) {
+                issues.push('Windows paths cannot end with space or period');
+                suggestions.push('Remove trailing spaces and periods');
+            }
+        }
+        else {
+            // Unix path validation
+            if (inputPath.includes('\\') && !inputPath.includes('/')) {
+                issues.push('Uses Windows path separators on Unix');
+                suggestions.push('Replace backslashes with forward slashes');
+            }
+            if (/^[A-Za-z]:/.test(inputPath)) {
+                issues.push('Contains Windows drive letter on Unix system');
+                suggestions.push('Remove drive letter and adjust path');
+            }
+        }
+        // Check for reserved names (Windows)
+        if (target === 'windows') {
+            const reservedNames = ['CON', 'PRN', 'AUX', 'NUL', 'COM1', 'COM2', 'COM3', 'COM4', 'COM5', 'COM6', 'COM7', 'COM8', 'COM9', 'LPT1', 'LPT2', 'LPT3', 'LPT4', 'LPT5', 'LPT6', 'LPT7', 'LPT8', 'LPT9'];
+            const filename = path.basename(inputPath).toUpperCase();
+            if (reservedNames.includes(filename)) {
+                issues.push(`Uses reserved Windows filename: ${filename}`);
+                suggestions.push('Choose a different filename');
+            }
+        }
+        return {
+            valid: issues.length === 0,
+            issues,
+            suggestions
+        };
+    }
+    /**
+     * Get relative path between two paths
+     */
+    getRelativePath(from, to) {
+        const resolvedFrom = this.resolvePath(from);
+        const resolvedTo = this.resolvePath(to);
+        return path.relative(resolvedFrom.resolved, resolvedTo.resolved);
+    }
+    /**
+     * Check if path exists and is accessible
+     */
+    async checkPathAccess(inputPath) {
+        const fs = await import('fs');
+        const resolved = this.resolvePath(inputPath);
+        try {
+            const stats = await fs.promises.stat(resolved.resolved);
+            // Test read access
+            let readable = false;
+            try {
+                await fs.promises.access(resolved.resolved, fs.constants.R_OK);
+                readable = true;
+            }
+            catch {
+                readable = false;
+            }
+            // Test write access
+            let writable = false;
+            try {
+                await fs.promises.access(resolved.resolved, fs.constants.W_OK);
+                writable = true;
+            }
+            catch {
+                writable = false;
+            }
+            return {
+                exists: true,
+                readable,
+                writable,
+                isDirectory: stats.isDirectory(),
+                isFile: stats.isFile()
+            };
+        }
+        catch {
+            return {
+                exists: false,
+                readable: false,
+                writable: false,
+                isDirectory: false,
+                isFile: false
+            };
+        }
+    }
+    /**
+     * Get current platform configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+export default CrossPlatformPathResolver;
+//# sourceMappingURL=path-resolver.js.map

package/dist/core/platform/path-resolver.js.map

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

package/dist/core/platform/platform-adapter.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-20
+ * @tags: [platform, cross-platform, hooks, compatibility, adapter]
+ * @related: [config-loader.ts, git-validator.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [os, path, fs]
+ */
+export type Platform = 'windows' | 'macos' | 'linux';
+export interface PlatformConfig {
+    platform: Platform;
+    hookExtension: string;
+    shellExtension: string;
+    pathSeparator: string;
+    homeDirectory: string;
+    claudeConfigPath: string;
+    hookDirectory: string;
+}
+export interface HookInfo {
+    name: string;
+    platform: Platform;
+    path: string;
+    extension: string;
+    content?: string;
+}
+/**
+ * PlatformAdapter handles cross-platform compatibility for ginko CLI
+ * Provides platform detection, path resolution, and hook management
+ */
+export declare class PlatformAdapter {
+    private _platform;
+    private _config;
+    /**
+     * Detect current operating system platform
+     */
+    detectPlatform(): Platform;
+    /**
+     * Get platform-specific configuration
+     */
+    getPlatformConfig(): PlatformConfig;
+    /**
+     * Get appropriate hook file extension for platform
+     */
+    getHookExtension(platform?: Platform): string;
+    /**
+     * Get appropriate shell script extension for platform
+     */
+    getShellExtension(platform?: Platform): string;
+    /**
+     * Get Claude configuration directory path for platform
+     */
+    getClaudeConfigPath(platform?: Platform, homeDir?: string): string;
+    /**
+     * Get hook directory path for platform
+     */
+    getHookDirectory(platform?: Platform, homeDir?: string): string;
+    /**
+     * Adapt hook path for current platform
+     */
+    adaptHookPath(hookName: string, platform?: Platform): string;
+    /**
+     * Find all existing hooks in the system
+     */
+    findExistingHooks(): Promise<HookInfo[]>;
+    /**
+     * Check if hooks directory exists and create it if needed
+     */
+    ensureHookDirectory(): Promise<void>;
+    /**
+     * Check if current platform is Windows
+     */
+    isWindows(): boolean;
+    /**
+     * Check if current platform is macOS
+     */
+    isMacOS(): boolean;
+    /**
+     * Check if current platform is Linux
+     */
+    isLinux(): boolean;
+    /**
+     * Check if current platform is Unix-like (macOS or Linux)
+     */
+    isUnix(): boolean;
+    /**
+     * Get platform-appropriate path separator
+     */
+    getPathSeparator(): string;
+    /**
+     * Normalize path for current platform
+     */
+    normalizePath(inputPath: string): string;
+    /**
+     * Get platform display name for user messages
+     */
+    getPlatformDisplayName(platform?: Platform): string;
+}
+export declare const platformAdapter: PlatformAdapter;
+//# sourceMappingURL=platform-adapter.d.ts.map

package/dist/core/platform/platform-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-adapter.d.ts","sourceRoot":"","sources":["../../../src/core/platform/platform-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,OAAO,CAA+B;IAE9C;;OAEG;IACH,cAAc,IAAI,QAAQ;IAkB1B;;OAEG;IACH,iBAAiB,IAAI,cAAc;IAqBnC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM;IAc7C;;OAEG;IACH,iBAAiB,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM;IAc9C;;OAEG;IACH,mBAAmB,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAgBlE;;OAEG;IACH,gBAAgB,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAK/D;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM;IAc5D;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IA4C9C;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAU1C;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,MAAM,IAAI,OAAO;IAKjB;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAYxC;;OAEG;IACH,sBAAsB,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM;CAcpD;AAGD,eAAO,MAAM,eAAe,iBAAwB,CAAC"}