@ginkoai/cli 1.0.0

package/dist/core/platform/platform-adapter.js

@@ -0,0 +1,243 @@
+/**
+ * @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]
+ */
+import * as os from 'os';
+import * as path from 'path';
+import * as fs from 'fs';
+/**
+ * PlatformAdapter handles cross-platform compatibility for ginko CLI
+ * Provides platform detection, path resolution, and hook management
+ */
+export class PlatformAdapter {
+    _platform = null;
+    _config = null;
+    /**
+     * Detect current operating system platform
+     */
+    detectPlatform() {
+        if (this._platform) {
+            return this._platform;
+        }
+        const platform = process.platform;
+        if (platform === 'win32') {
+            this._platform = 'windows';
+        }
+        else if (platform === 'darwin') {
+            this._platform = 'macos';
+        }
+        else {
+            this._platform = 'linux';
+        }
+        return this._platform;
+    }
+    /**
+     * Get platform-specific configuration
+     */
+    getPlatformConfig() {
+        if (this._config) {
+            return this._config;
+        }
+        const platform = this.detectPlatform();
+        const homeDir = os.homedir();
+        this._config = {
+            platform,
+            hookExtension: this.getHookExtension(platform),
+            shellExtension: this.getShellExtension(platform),
+            pathSeparator: platform === 'windows' ? '\\' : '/',
+            homeDirectory: homeDir,
+            claudeConfigPath: this.getClaudeConfigPath(platform, homeDir),
+            hookDirectory: this.getHookDirectory(platform, homeDir)
+        };
+        return this._config;
+    }
+    /**
+     * Get appropriate hook file extension for platform
+     */
+    getHookExtension(platform) {
+        const currentPlatform = platform || this.detectPlatform();
+        switch (currentPlatform) {
+            case 'windows':
+                return '.bat';
+            case 'macos':
+            case 'linux':
+                return '.sh';
+            default:
+                return '.sh';
+        }
+    }
+    /**
+     * Get appropriate shell script extension for platform
+     */
+    getShellExtension(platform) {
+        const currentPlatform = platform || this.detectPlatform();
+        switch (currentPlatform) {
+            case 'windows':
+                return '.bat';
+            case 'macos':
+            case 'linux':
+                return '.sh';
+            default:
+                return '.sh';
+        }
+    }
+    /**
+     * Get Claude configuration directory path for platform
+     */
+    getClaudeConfigPath(platform, homeDir) {
+        const currentPlatform = platform || this.detectPlatform();
+        const home = homeDir || os.homedir();
+        switch (currentPlatform) {
+            case 'windows':
+                return path.join(home, 'AppData', 'Roaming', 'Claude');
+            case 'macos':
+                return path.join(home, 'Library', 'Application Support', 'Claude');
+            case 'linux':
+                return path.join(home, '.config', 'claude');
+            default:
+                return path.join(home, '.claude');
+        }
+    }
+    /**
+     * Get hook directory path for platform
+     */
+    getHookDirectory(platform, homeDir) {
+        const claudeConfigPath = this.getClaudeConfigPath(platform, homeDir);
+        return path.join(claudeConfigPath, 'hooks');
+    }
+    /**
+     * Adapt hook path for current platform
+     */
+    adaptHookPath(hookName, platform) {
+        const config = this.getPlatformConfig();
+        const currentPlatform = platform || config.platform;
+        const ext = this.getHookExtension(currentPlatform);
+        // Remove any existing extension from hookName
+        const baseName = hookName.replace(/\.(sh|bat|ps1)$/, '');
+        return path.join(this.getHookDirectory(currentPlatform), `${baseName}${ext}`);
+    }
+    /**
+     * Find all existing hooks in the system
+     */
+    async findExistingHooks() {
+        const hooks = [];
+        const config = this.getPlatformConfig();
+        try {
+            if (!fs.existsSync(config.hookDirectory)) {
+                return hooks;
+            }
+            const files = await fs.promises.readdir(config.hookDirectory);
+            for (const file of files) {
+                const filePath = path.join(config.hookDirectory, file);
+                const stat = await fs.promises.stat(filePath);
+                if (stat.isFile()) {
+                    const ext = path.extname(file);
+                    const baseName = path.basename(file, ext);
+                    let platform;
+                    if (ext === '.bat') {
+                        platform = 'windows';
+                    }
+                    else if (ext === '.sh') {
+                        // Could be macOS or Linux, use current platform as default
+                        platform = config.platform === 'windows' ? 'linux' : config.platform;
+                    }
+                    else {
+                        continue; // Skip non-hook files
+                    }
+                    hooks.push({
+                        name: baseName,
+                        platform,
+                        path: filePath,
+                        extension: ext
+                    });
+                }
+            }
+        }
+        catch (error) {
+            console.warn(`Warning: Could not read hook directory: ${error}`);
+        }
+        return hooks;
+    }
+    /**
+     * Check if hooks directory exists and create it if needed
+     */
+    async ensureHookDirectory() {
+        const config = this.getPlatformConfig();
+        try {
+            await fs.promises.mkdir(config.hookDirectory, { recursive: true });
+        }
+        catch (error) {
+            throw new Error(`Failed to create hook directory: ${error}`);
+        }
+    }
+    /**
+     * Check if current platform is Windows
+     */
+    isWindows() {
+        return this.detectPlatform() === 'windows';
+    }
+    /**
+     * Check if current platform is macOS
+     */
+    isMacOS() {
+        return this.detectPlatform() === 'macos';
+    }
+    /**
+     * Check if current platform is Linux
+     */
+    isLinux() {
+        return this.detectPlatform() === 'linux';
+    }
+    /**
+     * Check if current platform is Unix-like (macOS or Linux)
+     */
+    isUnix() {
+        const platform = this.detectPlatform();
+        return platform === 'macos' || platform === 'linux';
+    }
+    /**
+     * Get platform-appropriate path separator
+     */
+    getPathSeparator() {
+        return this.getPlatformConfig().pathSeparator;
+    }
+    /**
+     * Normalize path for current platform
+     */
+    normalizePath(inputPath) {
+        const config = this.getPlatformConfig();
+        if (config.platform === 'windows') {
+            // Convert forward slashes to backslashes on Windows
+            return inputPath.replace(/\//g, '\\');
+        }
+        else {
+            // Convert backslashes to forward slashes on Unix-like systems
+            return inputPath.replace(/\\/g, '/');
+        }
+    }
+    /**
+     * Get platform display name for user messages
+     */
+    getPlatformDisplayName(platform) {
+        const currentPlatform = platform || this.detectPlatform();
+        switch (currentPlatform) {
+            case 'windows':
+                return 'Windows';
+            case 'macos':
+                return 'macOS';
+            case 'linux':
+                return 'Linux';
+            default:
+                return 'Unknown';
+        }
+    }
+}
+// Export singleton instance
+export const platformAdapter = new PlatformAdapter();
+//# sourceMappingURL=platform-adapter.js.map

package/dist/core/platform/platform-adapter.js.map

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

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

@@ -0,0 +1,122 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-19
+ * @tags: [platform, detection, os, environment, cross-platform]
+ * @related: [hook-adapter.ts, path-normalizer.ts, index.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra, os, child_process]
+ */
+export type Platform = 'windows' | 'macos' | 'linux';
+export type Shell = 'bash' | 'zsh' | 'powershell' | 'cmd' | 'fish' | 'unknown';
+export type PackageManager = 'npm' | 'yarn' | 'pnpm' | 'unknown';
+export interface PlatformInfo {
+    platform: Platform;
+    shell: Shell;
+    packageManager: PackageManager;
+    homeDirectory: string;
+    pathSeparator: string;
+    scriptExtension: string;
+    executableExtension: string;
+    nodeVersion?: string;
+    gitVersion?: string;
+    architecture: string;
+    environmentVars: Record<string, string>;
+}
+export interface EnvironmentCapabilities {
+    hasGit: boolean;
+    hasNode: boolean;
+    hasNpm: boolean;
+    hasYarn: boolean;
+    hasPnpm: boolean;
+    canExecuteShell: boolean;
+    canExecuteBatch: boolean;
+    canExecutePowerShell: boolean;
+    supportedScriptTypes: string[];
+}
+/**
+ * Detects platform, environment, and development tools
+ * Provides comprehensive information for cross-platform compatibility
+ */
+export declare class PlatformDetector {
+    private cachedInfo;
+    private cachedCapabilities;
+    /**
+     * Get comprehensive platform information
+     */
+    detect(): Promise<PlatformInfo>;
+    /**
+     * Get environment capabilities
+     */
+    getCapabilities(): Promise<EnvironmentCapabilities>;
+    /**
+     * Detect the current platform
+     */
+    private detectPlatform;
+    /**
+     * Detect the current shell
+     */
+    private detectShell;
+    /**
+     * Detect the preferred package manager
+     */
+    private detectPackageManager;
+    /**
+     * Get the appropriate script extension for the platform and shell
+     */
+    private getScriptExtension;
+    /**
+     * Get Node.js version
+     */
+    private getNodeVersion;
+    /**
+     * Get Git version
+     */
+    private getGitVersion;
+    /**
+     * Get relevant environment variables
+     */
+    private getRelevantEnvVars;
+    /**
+     * Check if a command is available
+     */
+    private checkCommand;
+    /**
+     * Check if we can execute a specific script type
+     */
+    private canExecuteType;
+    /**
+     * Get all supported script types for this environment
+     */
+    private getSupportedScriptTypes;
+    /**
+     * 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)
+     */
+    isUnixLike(): boolean;
+    /**
+     * Get the appropriate Claude hooks directory for this platform
+     */
+    getClaudeHooksDirectory(): string;
+    /**
+     * Get the appropriate ginko directory for this platform
+     */
+    getGinkoDirectory(): string;
+    /**
+     * Clear cached information (useful for testing)
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=platform-detector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform-detector.d.ts","sourceRoot":"","sources":["../../../src/core/platform/platform-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AACrD,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAC/E,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,kBAAkB,CAAwC;IAElE;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IA6BrC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAqBzD;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;YACW,WAAW;IA+BzB;;OAEG;YACW,oBAAoB;IA4BlC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;YACW,cAAc;IAa5B;;OAEG;YACW,aAAa;IAa3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;YACW,YAAY;IAiB1B;;OAEG;YACW,cAAc;IAiB5B;;OAEG;YACW,uBAAuB;IAWrC;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,UAAU,IAAI,OAAO;IAKrB;;OAEG;IACH,uBAAuB,IAAI,MAAM;IAKjC;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAK3B;;OAEG;IACH,UAAU,IAAI,IAAI;CAInB"}

package/dist/core/platform/platform-detector.js

@@ -0,0 +1,318 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-19
+ * @tags: [platform, detection, os, environment, cross-platform]
+ * @related: [hook-adapter.ts, path-normalizer.ts, index.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra, os, child_process]
+ */
+import * as os from 'os';
+import * as fs from 'fs-extra';
+import { execSync } from 'child_process';
+import * as path from 'path';
+/**
+ * Detects platform, environment, and development tools
+ * Provides comprehensive information for cross-platform compatibility
+ */
+export class PlatformDetector {
+    cachedInfo = null;
+    cachedCapabilities = null;
+    /**
+     * Get comprehensive platform information
+     */
+    async detect() {
+        if (this.cachedInfo) {
+            return this.cachedInfo;
+        }
+        const platform = this.detectPlatform();
+        const shell = await this.detectShell();
+        const packageManager = await this.detectPackageManager();
+        const homeDirectory = os.homedir();
+        const architecture = os.arch();
+        const info = {
+            platform,
+            shell,
+            packageManager,
+            homeDirectory,
+            pathSeparator: platform === 'windows' ? '\\' : '/',
+            scriptExtension: this.getScriptExtension(platform, shell),
+            executableExtension: platform === 'windows' ? '.exe' : '',
+            nodeVersion: await this.getNodeVersion(),
+            gitVersion: await this.getGitVersion(),
+            architecture,
+            environmentVars: this.getRelevantEnvVars()
+        };
+        this.cachedInfo = info;
+        return info;
+    }
+    /**
+     * Get environment capabilities
+     */
+    async getCapabilities() {
+        if (this.cachedCapabilities) {
+            return this.cachedCapabilities;
+        }
+        const capabilities = {
+            hasGit: await this.checkCommand('git'),
+            hasNode: await this.checkCommand('node'),
+            hasNpm: await this.checkCommand('npm'),
+            hasYarn: await this.checkCommand('yarn'),
+            hasPnpm: await this.checkCommand('pnpm'),
+            canExecuteShell: await this.canExecuteType('shell'),
+            canExecuteBatch: await this.canExecuteType('batch'),
+            canExecutePowerShell: await this.canExecuteType('powershell'),
+            supportedScriptTypes: await this.getSupportedScriptTypes()
+        };
+        this.cachedCapabilities = capabilities;
+        return capabilities;
+    }
+    /**
+     * Detect the current platform
+     */
+    detectPlatform() {
+        const platform = os.platform();
+        switch (platform) {
+            case 'win32':
+                return 'windows';
+            case 'darwin':
+                return 'macos';
+            case 'linux':
+                return 'linux';
+            default:
+                // Default to linux for other Unix-like systems
+                return 'linux';
+        }
+    }
+    /**
+     * Detect the current shell
+     */
+    async detectShell() {
+        try {
+            // Check environment variables first
+            const shell = process.env.SHELL || process.env.ComSpec || '';
+            if (shell.includes('bash'))
+                return 'bash';
+            if (shell.includes('zsh'))
+                return 'zsh';
+            if (shell.includes('powershell') || shell.includes('pwsh'))
+                return 'powershell';
+            if (shell.includes('cmd'))
+                return 'cmd';
+            if (shell.includes('fish'))
+                return 'fish';
+            // Try to detect by checking what's available
+            const platform = this.detectPlatform();
+            if (platform === 'windows') {
+                // Check for PowerShell first, then cmd
+                if (await this.checkCommand('powershell'))
+                    return 'powershell';
+                if (await this.checkCommand('pwsh'))
+                    return 'powershell';
+                return 'cmd';
+            }
+            else {
+                // Unix-like systems
+                if (await this.checkCommand('zsh'))
+                    return 'zsh';
+                if (await this.checkCommand('bash'))
+                    return 'bash';
+                if (await this.checkCommand('fish'))
+                    return 'fish';
+                return 'bash'; // Default fallback
+            }
+        }
+        catch {
+            return 'unknown';
+        }
+    }
+    /**
+     * Detect the preferred package manager
+     */
+    async detectPackageManager() {
+        try {
+            // Check for lock files first (most reliable)
+            const cwd = process.cwd();
+            if (await fs.pathExists(path.join(cwd, 'pnpm-lock.yaml'))) {
+                return 'pnpm';
+            }
+            if (await fs.pathExists(path.join(cwd, 'yarn.lock'))) {
+                return 'yarn';
+            }
+            if (await fs.pathExists(path.join(cwd, 'package-lock.json'))) {
+                return 'npm';
+            }
+            // Check for globally available package managers
+            if (await this.checkCommand('pnpm'))
+                return 'pnpm';
+            if (await this.checkCommand('yarn'))
+                return 'yarn';
+            if (await this.checkCommand('npm'))
+                return 'npm';
+            return 'unknown';
+        }
+        catch {
+            return 'unknown';
+        }
+    }
+    /**
+     * Get the appropriate script extension for the platform and shell
+     */
+    getScriptExtension(platform, shell) {
+        if (platform === 'windows') {
+            return shell === 'powershell' ? '.ps1' : '.bat';
+        }
+        return '.sh';
+    }
+    /**
+     * Get Node.js version
+     */
+    async getNodeVersion() {
+        try {
+            const version = execSync('node --version', {
+                encoding: 'utf8',
+                stdio: 'pipe',
+                timeout: 5000
+            }).trim();
+            return version;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Get Git version
+     */
+    async getGitVersion() {
+        try {
+            const version = execSync('git --version', {
+                encoding: 'utf8',
+                stdio: 'pipe',
+                timeout: 5000
+            }).trim();
+            return version;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Get relevant environment variables
+     */
+    getRelevantEnvVars() {
+        const relevantVars = [
+            'PATH', 'HOME', 'USER', 'USERNAME', 'USERPROFILE',
+            'SHELL', 'ComSpec', 'NODE_ENV', 'npm_config_prefix',
+            'CLAUDE_CONFIG_PATH', 'CLAUDE_HOOKS_PATH'
+        ];
+        const envVars = {};
+        for (const varName of relevantVars) {
+            const value = process.env[varName];
+            if (value) {
+                envVars[varName] = value;
+            }
+        }
+        return envVars;
+    }
+    /**
+     * Check if a command is available
+     */
+    async checkCommand(command) {
+        try {
+            const platform = this.detectPlatform();
+            const checkCmd = platform === 'windows'
+                ? `where ${command}`
+                : `which ${command}`;
+            execSync(checkCmd, {
+                stdio: 'pipe',
+                timeout: 3000
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if we can execute a specific script type
+     */
+    async canExecuteType(type) {
+        try {
+            switch (type) {
+                case 'shell':
+                    return await this.checkCommand('sh') || await this.checkCommand('bash');
+                case 'batch':
+                    return this.detectPlatform() === 'windows';
+                case 'powershell':
+                    return await this.checkCommand('powershell') || await this.checkCommand('pwsh');
+                default:
+                    return false;
+            }
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get all supported script types for this environment
+     */
+    async getSupportedScriptTypes() {
+        const types = [];
+        const capabilities = await this.getCapabilities();
+        if (capabilities.canExecuteShell)
+            types.push('.sh');
+        if (capabilities.canExecuteBatch)
+            types.push('.bat');
+        if (capabilities.canExecutePowerShell)
+            types.push('.ps1');
+        return types;
+    }
+    /**
+     * Check if current platform is Windows
+     */
+    isWindows() {
+        return this.detectPlatform() === 'windows';
+    }
+    /**
+     * Check if current platform is macOS
+     */
+    isMacOS() {
+        return this.detectPlatform() === 'macos';
+    }
+    /**
+     * Check if current platform is Linux
+     */
+    isLinux() {
+        return this.detectPlatform() === 'linux';
+    }
+    /**
+     * Check if current platform is Unix-like (macOS or Linux)
+     */
+    isUnixLike() {
+        const platform = this.detectPlatform();
+        return platform === 'macos' || platform === 'linux';
+    }
+    /**
+     * Get the appropriate Claude hooks directory for this platform
+     */
+    getClaudeHooksDirectory() {
+        const homeDir = os.homedir();
+        return path.join(homeDir, '.claude', 'hooks');
+    }
+    /**
+     * Get the appropriate ginko directory for this platform
+     */
+    getGinkoDirectory() {
+        const homeDir = os.homedir();
+        return path.join(homeDir, '.ginko');
+    }
+    /**
+     * Clear cached information (useful for testing)
+     */
+    clearCache() {
+        this.cachedInfo = null;
+        this.cachedCapabilities = null;
+    }
+}
+//# sourceMappingURL=platform-detector.js.map