@ginkoai/cli 1.0.0

package/dist/core/platform/hook-templates.js

@@ -0,0 +1,352 @@
+/**
+ * @fileType: config
+ * @status: current
+ * @updated: 2025-09-21
+ * @tags: [hooks, templates, cross-platform, windows, macos, linux, path-config]
+ * @related: [platform-adapter.ts, hook-migration.ts, path-config.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: [platform-adapter, path-config]
+ */
+import { pathManager } from '../utils/paths.js';
+/**
+ * Platform-specific hook templates for ginko integration
+ * Now uses pathManager for configuration-based paths
+ */
+export class HookTemplates {
+    /**
+     * Get all available hook templates for a platform
+     */
+    static getTemplatesForPlatform(platform) {
+        switch (platform) {
+            case 'windows':
+                return this.getWindowsTemplates();
+            case 'macos':
+            case 'linux':
+                return this.getUnixTemplates();
+            default:
+                return this.getUnixTemplates();
+        }
+    }
+    /**
+     * Get specific hook template by name and platform
+     */
+    static getTemplate(hookName, platform) {
+        const templates = this.getTemplatesForPlatform(platform);
+        return templates.find(t => t.name === hookName) || null;
+    }
+    /**
+     * Get template with dynamic path variables substituted
+     */
+    static getTemplateWithPaths(hookName, platform) {
+        const template = this.getTemplate(hookName, platform);
+        if (!template)
+            return null;
+        // Get paths from pathManager
+        const pathConfig = pathManager.getConfig();
+        const tempDir = platform === 'windows'
+            ? process.env.TEMP || 'C:\\\\temp'
+            : '/tmp';
+        // Replace path variables in template content
+        let content = template.content;
+        content = content.replace(/\\.ginko/g, pathManager.getRelativePath(pathConfig.ginko.root));
+        content = content.replace(/\/tmp\/ginko-\*/g, `${tempDir}/ginko-*`);
+        return {
+            ...template,
+            content
+        };
+    }
+    /**
+     * Windows batch script templates
+     */
+    static getWindowsTemplates() {
+        return [
+            {
+                name: 'session_start',
+                platform: 'windows',
+                extension: '.bat',
+                description: 'Executes when a Claude session starts',
+                content: `@echo off
+REM Ginko session-start hook for Windows
+REM This script runs when a Claude session starts
+
+echo Starting ginko session on Windows...
+
+REM Example: Load previous session context
+if exist "{{GINKO_ROOT}}" (
+    ginko start --resume
+) else (
+    echo No previous session found, starting fresh
+)
+
+REM Example: Set environment variables
+set GINKO_SESSION_START=%DATE% %TIME%
+
+REM Example: Log session start
+echo Session started at %GINKO_SESSION_START% >> "{{GINKO_ROOT}}\\sessions\\session.log"
+
+exit 0`
+            },
+            {
+                name: 'session_end',
+                platform: 'windows',
+                extension: '.bat',
+                description: 'Executes when a Claude session ends',
+                content: `@echo off
+REM Ginko session-end hook for Windows
+REM This script runs when a Claude session ends
+
+echo Ending ginko session on Windows...
+
+REM Example: Save session data
+if exist "{{GINKO_ROOT}}" (
+    ginko handoff --auto "Session ended on Windows"
+)
+
+REM Example: Cleanup temporary files
+del /q "{{TEMP_DIR}}\\ginko-*" 2>nul
+
+REM Example: Log session end
+echo Session ended at %DATE% %TIME% >> "{{GINKO_ROOT}}\\sessions\\session.log"
+
+exit 0`
+            },
+            {
+                name: 'pre_commit',
+                platform: 'windows',
+                extension: '.bat',
+                description: 'Executes before git commits',
+                content: `@echo off
+REM Ginko pre-commit hook for Windows
+REM This script runs before git commits
+
+echo Running ginko pre-commit checks...
+
+REM Example: Update context before commit
+if exist "{{GINKO_ROOT}}" (
+    ginko context --update
+)
+
+REM Example: Run tests if they exist
+if exist "package.json" (
+    npm test
+    if errorlevel 1 (
+        echo Tests failed, commit aborted
+        exit 1
+    )
+)
+
+echo Pre-commit checks passed
+exit 0`
+            },
+            {
+                name: 'post_commit',
+                platform: 'windows',
+                extension: '.bat',
+                description: 'Executes after git commits',
+                content: `@echo off
+REM Ginko post-commit hook for Windows
+REM This script runs after git commits
+
+echo Running ginko post-commit actions...
+
+REM Example: Update session with commit info
+if exist "{{GINKO_ROOT}}" (
+    for /f "delims=" %%i in ('git log -1 --pretty=format:"%%h %%s"') do set LAST_COMMIT=%%i
+    echo Last commit: !LAST_COMMIT! >> "{{GINKO_ROOT}}\\sessions\\commits.log"
+)
+
+exit 0`
+            }
+        ];
+    }
+    /**
+     * Unix shell script templates (macOS/Linux)
+     */
+    static getUnixTemplates() {
+        return [
+            {
+                name: 'session_start',
+                platform: 'linux',
+                extension: '.sh',
+                description: 'Executes when a Claude session starts',
+                content: `#!/bin/bash
+# Ginko session-start hook for Unix systems (macOS/Linux)
+# This script runs when a Claude session starts
+
+set -e
+
+echo "Starting ginko session on $(uname)..."
+
+# Example: Load previous session context
+if [ -d "{{GINKO_ROOT}}" ]; then
+    ginko start --resume
+else
+    echo "No previous session found, starting fresh"
+fi
+
+# Example: Set environment variables
+export GINKO_SESSION_START="$(date)"
+
+# Example: Log session start
+echo "Session started at $GINKO_SESSION_START" >> "{{GINKO_ROOT}}/sessions/session.log"
+
+exit 0`
+            },
+            {
+                name: 'session_end',
+                platform: 'linux',
+                extension: '.sh',
+                description: 'Executes when a Claude session ends',
+                content: `#!/bin/bash
+# Ginko session-end hook for Unix systems (macOS/Linux)
+# This script runs when a Claude session ends
+
+set -e
+
+echo "Ending ginko session on $(uname)..."
+
+# Example: Save session data
+if [ -d "{{GINKO_ROOT}}" ]; then
+    ginko handoff --auto "Session ended on $(uname)"
+fi
+
+# Example: Cleanup temporary files
+rm -f "{{TEMP_DIR}}/ginko-*"
+
+# Example: Platform-specific cleanup
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    # macOS-specific cleanup
+    :
+elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+    # Linux-specific cleanup
+    :
+fi
+
+exit 0`
+            },
+            {
+                name: 'pre_commit',
+                platform: 'linux',
+                extension: '.sh',
+                description: 'Executes before git commits',
+                content: `#!/bin/bash
+# Ginko pre-commit hook for Unix systems (macOS/Linux)
+# This script runs before git commits
+
+set -e
+
+echo "Running ginko pre-commit checks..."
+
+# Example: Update context before commit
+if [ -d "{{GINKO_ROOT}}" ]; then
+    ginko context --update
+fi
+
+# Example: Run tests if they exist
+if [ -f "package.json" ]; then
+    npm test
+fi
+
+echo "Pre-commit checks passed"
+exit 0`
+            },
+            {
+                name: 'post_commit',
+                platform: 'linux',
+                extension: '.sh',
+                description: 'Executes after git commits',
+                content: `#!/bin/bash
+# Ginko post-commit hook for Unix systems (macOS/Linux)
+# This script runs after git commits
+
+set -e
+
+echo "Running ginko post-commit actions..."
+
+# Example: Update session with commit info
+if [ -d "{{GINKO_ROOT}}" ]; then
+    LAST_COMMIT=$(git log -1 --pretty=format:"%h %s")
+    echo "Last commit: $LAST_COMMIT" >> "{{GINKO_ROOT}}/sessions/commits.log"
+fi
+
+exit 0`
+            }
+        ];
+    }
+    /**
+     * Get default hook template content for a platform with path substitution
+     */
+    static getDefaultTemplate(platform) {
+        const pathConfig = pathManager.getConfig();
+        const ginkoRoot = pathManager.getRelativePath(pathConfig.ginko.root);
+        const tempDir = platform === 'windows'
+            ? process.env.TEMP || 'C:\\\\temp'
+            : '/tmp';
+        switch (platform) {
+            case 'windows':
+                return `@echo off
+REM Ginko hook for Windows
+REM Replace this with your custom logic
+
+echo Ginko hook executed on Windows
+
+REM Check if ginko is available
+if exist "${ginkoRoot}" (
+    echo Ginko directory found
+) else (
+    echo Ginko not initialized
+)
+
+exit 0`;
+            default:
+                return `#!/bin/bash
+# Ginko hook for Unix systems (macOS/Linux)
+# Replace this with your custom logic
+
+set -e
+
+echo "Ginko hook executed on $(uname)"
+
+# Check if ginko is available
+if [ -d "${ginkoRoot}" ]; then
+    echo "Ginko directory found"
+else
+    echo "Ginko not initialized"
+fi
+
+exit 0`;
+        }
+    }
+    /**
+     * Get available hook names for a platform
+     */
+    static getAvailableHooks(platform) {
+        const templates = this.getTemplatesForPlatform(platform);
+        return templates.map(t => t.name);
+    }
+    /**
+     * Validate hook template content
+     */
+    static validateTemplate(template) {
+        const errors = [];
+        if (!template.name || template.name.trim() === '') {
+            errors.push('Hook name is required');
+        }
+        if (!template.content || template.content.trim() === '') {
+            errors.push('Hook content is required');
+        }
+        if (template.platform === 'windows' && !template.content.includes('@echo off')) {
+            errors.push('Windows batch scripts should start with "@echo off"');
+        }
+        if ((template.platform === 'linux' || template.platform === 'macos') &&
+            !template.content.includes('#!/bin/bash')) {
+            errors.push('Unix shell scripts should start with "#!/bin/bash"');
+        }
+        return {
+            valid: errors.length === 0,
+            errors
+        };
+    }
+}
+//# sourceMappingURL=hook-templates.js.map

package/dist/core/platform/hook-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-templates.js","sourceRoot":"","sources":["../../../src/core/platform/hook-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAUhD;;;GAGG;AACH,MAAM,OAAO,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,QAAkB;QAC/C,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,SAAS;gBACZ,OAAO,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACpC,KAAK,OAAO,CAAC;YACb,KAAK,OAAO;gBACV,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACjC;gBACE,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAgB,EAAE,QAAkB;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QACzD,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,QAAgB,EAAE,QAAkB;QAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAE3B,6BAA6B;QAC7B,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,QAAQ,KAAK,SAAS;YACpC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,YAAY;YAClC,CAAC,CAAC,MAAM,CAAC;QAEX,6CAA6C;QAC7C,IAAI,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QAC/B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3F,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,OAAO,UAAU,CAAC,CAAC;QAEpE,OAAO;YACL,GAAG,QAAQ;YACX,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,mBAAmB;QAChC,OAAO;YACL;gBACE,IAAI,EAAE,eAAe;gBACrB,QAAQ,EAAE,SAAS;gBACnB,SAAS,EAAE,MAAM;gBACjB,WAAW,EAAE,uCAAuC;gBACpD,OAAO,EAAE;;;;;;;;;;;;;;;;;;;OAmBV;aACA;YACD;gBACE,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,SAAS;gBACnB,SAAS,EAAE,MAAM;gBACjB,WAAW,EAAE,qCAAqC;gBAClD,OAAO,EAAE;;;;;;;;;;;;;;;;;OAiBV;aACA;YACD;gBACE,IAAI,EAAE,YAAY;gBAClB,QAAQ,EAAE,SAAS;gBACnB,SAAS,EAAE,MAAM;gBACjB,WAAW,EAAE,6BAA6B;gBAC1C,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;OAqBV;aACA;YACD;gBACE,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,SAAS;gBACnB,SAAS,EAAE,MAAM;gBACjB,WAAW,EAAE,4BAA4B;gBACzC,OAAO,EAAE;;;;;;;;;;;;OAYV;aACA;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,gBAAgB;QAC7B,OAAO;YACL;gBACE,IAAI,EAAE,eAAe;gBACrB,QAAQ,EAAE,OAAO;gBACjB,SAAS,EAAE,KAAK;gBAChB,WAAW,EAAE,uCAAuC;gBACpD,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;OAqBV;aACA;YACD;gBACE,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,OAAO;gBACjB,SAAS,EAAE,KAAK;gBAChB,WAAW,EAAE,qCAAqC;gBAClD,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;OAyBV;aACA;YACD;gBACE,IAAI,EAAE,YAAY;gBAClB,QAAQ,EAAE,OAAO;gBACjB,SAAS,EAAE,KAAK;gBAChB,WAAW,EAAE,6BAA6B;gBAC1C,OAAO,EAAE;;;;;;;;;;;;;;;;;;;OAmBV;aACA;YACD;gBACE,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,OAAO;gBACjB,SAAS,EAAE,KAAK;gBAChB,WAAW,EAAE,4BAA4B;gBACzC,OAAO,EAAE;;;;;;;;;;;;;;OAcV;aACA;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,QAAkB;QAC1C,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,QAAQ,KAAK,SAAS;YACpC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,YAAY;YAClC,CAAC,CAAC,MAAM,CAAC;QAEX,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,SAAS;gBACZ,OAAO;;;;;;;YAOH,SAAS;;;;;;OAMd,CAAC;YAEF;gBACE,OAAO;;;;;;;;;WASJ,SAAS;;;;;;OAMb,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAkB;QACzC,MAAM,SAAS,GAAG,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QACzD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAsB;QAC5C,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACxD,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,QAAQ,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/E,MAAM,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,OAAO,IAAI,QAAQ,CAAC,QAAQ,KAAK,OAAO,CAAC;YAChE,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;QACpE,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;SACP,CAAC;IACJ,CAAC;CACF"}

package/dist/core/platform/index.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @fileType: config
+ * @status: current
+ * @updated: 2025-09-19
+ * @tags: [platform, adapter, export, cross-platform, api]
+ * @related: [platform-detector.ts, hook-adapter.ts, path-normalizer.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: [platform-detector, hook-adapter, path-normalizer]
+ */
+export type { Platform, Shell, PackageManager, PlatformInfo, EnvironmentCapabilities } from './platform-detector.js';
+export type { HookInfo, ConversionResult, HookTemplate } from './hook-adapter.js';
+export type { PathConversionOptions, NormalizedPath } from './path-normalizer.js';
+export { PlatformDetector } from './platform-detector.js';
+export { HookAdapter } from './hook-adapter.js';
+export { PathNormalizer } from './path-normalizer.js';
+import { PlatformDetector } from './platform-detector.js';
+import { HookAdapter } from './hook-adapter.js';
+import { PathNormalizer } from './path-normalizer.js';
+/**
+ * Unified platform adapter that combines all cross-platform functionality
+ * Provides a single entry point for platform-specific operations
+ */
+export declare class PlatformAdapter {
+    private detector;
+    private hookAdapter;
+    private pathNormalizer;
+    constructor();
+    /**
+     * Get platform detection capabilities
+     */
+    get platform(): PlatformDetector;
+    /**
+     * Get hook conversion capabilities
+     */
+    get hooks(): HookAdapter;
+    /**
+     * Get path normalization capabilities
+     */
+    get paths(): PathNormalizer;
+    /**
+     * Perform complete platform adaptation for a new installation
+     */
+    adaptForCurrentPlatform(): Promise<{
+        platform: import('./platform-detector.js').PlatformInfo;
+        capabilities: import('./platform-detector.js').EnvironmentCapabilities;
+        hooksPath: string;
+        ginkoPath: string;
+        adaptationSuccess: boolean;
+        errors: string[];
+        warnings: string[];
+    }>;
+    /**
+     * Convert existing hooks to current platform
+     */
+    migrateHooks(hooksDirectory: string): Promise<import('./hook-adapter.js').ConversionResult>;
+    /**
+     * Normalize a path for current platform
+     */
+    normalizePath(inputPath: string): string;
+    /**
+     * Convert a path between platforms
+     */
+    convertPath(inputPath: string, fromPlatform: import('./platform-detector.js').Platform, toPlatform: import('./platform-detector.js').Platform): string;
+    /**
+     * Get diagnostic information for troubleshooting
+     */
+    getDiagnosticInfo(): Promise<{
+        platform: import('./platform-detector.js').PlatformInfo;
+        capabilities: import('./platform-detector.js').EnvironmentCapabilities;
+        paths: {
+            claudeHooks: string;
+            ginko: string;
+            home: string;
+            current: string;
+        };
+        issues: string[];
+        recommendations: string[];
+    }>;
+}
+export declare const platformAdapter: PlatformAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/platform/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/platform/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,YAAY,EACV,QAAQ,EACR,KAAK,EACL,cAAc,EACd,YAAY,EACZ,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,qBAAqB,EACrB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,cAAc,CAAiB;;IAQvC;;OAEG;IACH,IAAI,QAAQ,qBAEX;IAED;;OAEG;IACH,IAAI,KAAK,gBAER;IAED;;OAEG;IACH,IAAI,KAAK,mBAER;IAED;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC;QACvC,QAAQ,EAAE,OAAO,wBAAwB,EAAE,YAAY,CAAC;QACxD,YAAY,EAAE,OAAO,wBAAwB,EAAE,uBAAuB,CAAC;QACvE,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IAsEF;;OAEG;IACG,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,mBAAmB,EAAE,gBAAgB,CAAC;IAIjG;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIxC;;OAEG;IACH,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,OAAO,wBAAwB,EAAE,QAAQ,EACvD,UAAU,EAAE,OAAO,wBAAwB,EAAE,QAAQ,GACpD,MAAM;IAIT;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC;QACjC,QAAQ,EAAE,OAAO,wBAAwB,EAAE,YAAY,CAAC;QACxD,YAAY,EAAE,OAAO,wBAAwB,EAAE,uBAAuB,CAAC;QACvE,KAAK,EAAE;YACL,WAAW,EAAE,MAAM,CAAC;YACpB,KAAK,EAAE,MAAM,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;QACF,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;CAoCH;AAGD,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

package/dist/core/platform/index.js

@@ -0,0 +1,173 @@
+/**
+ * @fileType: config
+ * @status: current
+ * @updated: 2025-09-19
+ * @tags: [platform, adapter, export, cross-platform, api]
+ * @related: [platform-detector.ts, hook-adapter.ts, path-normalizer.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: [platform-detector, hook-adapter, path-normalizer]
+ */
+// Export classes
+export { PlatformDetector } from './platform-detector.js';
+export { HookAdapter } from './hook-adapter.js';
+export { PathNormalizer } from './path-normalizer.js';
+// Export a unified platform adapter facade
+import { PlatformDetector } from './platform-detector.js';
+import { HookAdapter } from './hook-adapter.js';
+import { PathNormalizer } from './path-normalizer.js';
+/**
+ * Unified platform adapter that combines all cross-platform functionality
+ * Provides a single entry point for platform-specific operations
+ */
+export class PlatformAdapter {
+    detector;
+    hookAdapter;
+    pathNormalizer;
+    constructor() {
+        this.detector = new PlatformDetector();
+        this.hookAdapter = new HookAdapter();
+        this.pathNormalizer = new PathNormalizer();
+    }
+    /**
+     * Get platform detection capabilities
+     */
+    get platform() {
+        return this.detector;
+    }
+    /**
+     * Get hook conversion capabilities
+     */
+    get hooks() {
+        return this.hookAdapter;
+    }
+    /**
+     * Get path normalization capabilities
+     */
+    get paths() {
+        return this.pathNormalizer;
+    }
+    /**
+     * Perform complete platform adaptation for a new installation
+     */
+    async adaptForCurrentPlatform() {
+        const errors = [];
+        const warnings = [];
+        try {
+            // Detect platform information
+            const platform = await this.detector.detect();
+            const capabilities = await this.detector.getCapabilities();
+            // Get platform-appropriate paths
+            const hooksPath = this.pathNormalizer.getClaudeHooksPath(platform.platform);
+            const ginkoPath = this.pathNormalizer.getGinkoPath(platform.platform);
+            // Generate hook templates if needed
+            try {
+                const hookResult = await this.hookAdapter.generateHookTemplates(hooksPath);
+                if (!hookResult.success) {
+                    errors.push(...hookResult.errors);
+                    warnings.push(...hookResult.warnings);
+                }
+            }
+            catch (error) {
+                warnings.push(`Could not generate hook templates: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            return {
+                platform,
+                capabilities,
+                hooksPath,
+                ginkoPath,
+                adaptationSuccess: errors.length === 0,
+                errors,
+                warnings
+            };
+        }
+        catch (error) {
+            errors.push(`Platform adaptation failed: ${error instanceof Error ? error.message : String(error)}`);
+            // Return minimal fallback information
+            return {
+                platform: {
+                    platform: 'linux',
+                    shell: 'bash',
+                    packageManager: 'npm',
+                    homeDirectory: require('os').homedir(),
+                    pathSeparator: '/',
+                    scriptExtension: '.sh',
+                    executableExtension: '',
+                    architecture: require('os').arch(),
+                    environmentVars: {}
+                },
+                capabilities: {
+                    hasGit: false,
+                    hasNode: false,
+                    hasNpm: false,
+                    hasYarn: false,
+                    hasPnpm: false,
+                    canExecuteShell: false,
+                    canExecuteBatch: false,
+                    canExecutePowerShell: false,
+                    supportedScriptTypes: []
+                },
+                hooksPath: '',
+                ginkoPath: '',
+                adaptationSuccess: false,
+                errors,
+                warnings
+            };
+        }
+    }
+    /**
+     * Convert existing hooks to current platform
+     */
+    async migrateHooks(hooksDirectory) {
+        return await this.hookAdapter.convertHooks(hooksDirectory);
+    }
+    /**
+     * Normalize a path for current platform
+     */
+    normalizePath(inputPath) {
+        return this.pathNormalizer.normalize(inputPath);
+    }
+    /**
+     * Convert a path between platforms
+     */
+    convertPath(inputPath, fromPlatform, toPlatform) {
+        return this.pathNormalizer.convertPath(inputPath, fromPlatform, toPlatform);
+    }
+    /**
+     * Get diagnostic information for troubleshooting
+     */
+    async getDiagnosticInfo() {
+        const platform = await this.detector.detect();
+        const capabilities = await this.detector.getCapabilities();
+        const issues = [];
+        const recommendations = [];
+        // Check for common issues
+        if (!capabilities.hasGit) {
+            issues.push('Git is not available in PATH');
+            recommendations.push('Install Git and ensure it is in your PATH');
+        }
+        if (!capabilities.hasNode) {
+            issues.push('Node.js is not available in PATH');
+            recommendations.push('Install Node.js and ensure it is in your PATH');
+        }
+        if (platform.platform === 'windows' && platform.shell === 'cmd') {
+            recommendations.push('Consider using PowerShell for better scripting capabilities');
+        }
+        const paths = {
+            claudeHooks: this.pathNormalizer.getClaudeHooksPath(platform.platform),
+            ginko: this.pathNormalizer.getGinkoPath(platform.platform),
+            home: platform.homeDirectory,
+            current: process.cwd()
+        };
+        return {
+            platform,
+            capabilities,
+            paths,
+            issues,
+            recommendations
+        };
+    }
+}
+// Export a default instance for convenience
+export const platformAdapter = new PlatformAdapter();
+//# sourceMappingURL=index.js.map

package/dist/core/platform/index.js.map

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