@ginkoai/cli 1.6.2 → 1.7.0

package/dist/lib/notification-hooks.js

@@ -0,0 +1,223 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [notifications, hooks, epic-004, resilience, alerts]
+ * @related: [notifications/index.ts, event-logger.ts, orchestrator-state.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra, minimatch]
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import minimatch from 'minimatch';
+import { getProjectRoot } from '../utils/config-loader.js';
+/**
+ * Load notification hooks from ginko.config.json
+ *
+ * @returns Array of notification hooks
+ */
+export async function loadNotificationHooks() {
+    try {
+        const projectRoot = await getProjectRoot();
+        const configPath = path.join(projectRoot, 'ginko.config.json');
+        // Check if config file exists
+        if (!await fs.pathExists(configPath)) {
+            console.log('[NotificationHooks] No ginko.config.json found, no hooks configured');
+            return [];
+        }
+        // Load config
+        const config = await fs.readJSON(configPath);
+        // Extract notification hooks
+        if (!config.notifications?.hooks) {
+            console.log('[NotificationHooks] No notification hooks configured');
+            return [];
+        }
+        const hooks = config.notifications.hooks;
+        // Validate hooks
+        const validHooks = hooks.filter(hook => {
+            if (!hook.id || !hook.events || !hook.destination) {
+                console.warn(`[NotificationHooks] Invalid hook configuration (missing id, events, or destination)`);
+                return false;
+            }
+            if (!Array.isArray(hook.events) || hook.events.length === 0) {
+                console.warn(`[NotificationHooks] Invalid hook ${hook.id}: events must be non-empty array`);
+                return false;
+            }
+            if (!hook.destination.type || !hook.destination.config) {
+                console.warn(`[NotificationHooks] Invalid hook ${hook.id}: destination must have type and config`);
+                return false;
+            }
+            return true;
+        });
+        // Filter enabled hooks (default: true)
+        const enabledHooks = validHooks.filter(hook => hook.enabled !== false);
+        console.log(`[NotificationHooks] Loaded ${enabledHooks.length} notification hooks`);
+        return enabledHooks;
+    }
+    catch (error) {
+        console.error('[NotificationHooks] Failed to load notification hooks:', error instanceof Error ? error.message : String(error));
+        return [];
+    }
+}
+/**
+ * Check if a hook matches the given payload based on filters
+ *
+ * @param hook - Notification hook to check
+ * @param payload - Notification payload to match against
+ * @returns True if hook matches filters
+ */
+export function matchesFilter(hook, payload) {
+    const filter = hook.filter;
+    // No filter means match all
+    if (!filter) {
+        return true;
+    }
+    // Check severity filter
+    if (filter.severity && filter.severity.length > 0) {
+        if (!filter.severity.includes(payload.severity)) {
+            return false;
+        }
+    }
+    // Check epic ID filter
+    if (filter.epicId && payload.epicId) {
+        if (filter.epicId !== payload.epicId) {
+            return false;
+        }
+    }
+    // Check task pattern filter (glob)
+    if (filter.taskPattern && payload.taskId) {
+        if (!minimatch(payload.taskId, filter.taskPattern)) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Trigger a notification to all matching hooks
+ *
+ * @param event - Notification event type
+ * @param payload - Notification payload
+ */
+export async function triggerNotification(event, payload) {
+    try {
+        // Load hooks
+        const hooks = await loadNotificationHooks();
+        if (hooks.length === 0) {
+            console.log(`[NotificationHooks] No hooks configured for event: ${event}`);
+            return;
+        }
+        // Filter hooks that match this event
+        const matchingHooks = hooks.filter(hook => {
+            // Check if hook listens for this event type
+            if (!hook.events.includes(event)) {
+                return false;
+            }
+            // Check if hook matches filters
+            return matchesFilter(hook, payload);
+        });
+        if (matchingHooks.length === 0) {
+            console.log(`[NotificationHooks] No matching hooks for event: ${event}`);
+            return;
+        }
+        console.log(`[NotificationHooks] Triggering ${matchingHooks.length} hooks for event: ${event}`);
+        // Dispatch to each matching hook (in parallel, non-blocking)
+        const dispatchPromises = matchingHooks.map(async (hook) => {
+            try {
+                const success = await dispatchToDestination(hook.destination, payload);
+                if (success) {
+                    console.log(`[NotificationHooks] ✓ Notification sent to ${hook.id} (${hook.destination.type})`);
+                }
+                else {
+                    console.warn(`[NotificationHooks] ✗ Notification failed for ${hook.id} (${hook.destination.type})`);
+                }
+            }
+            catch (error) {
+                // Log error but don't propagate - notification failures shouldn't block workflow
+                console.error(`[NotificationHooks] Error dispatching to ${hook.id}:`, error instanceof Error ? error.message : String(error));
+            }
+        });
+        // Wait for all dispatches to complete (but don't block on errors)
+        await Promise.allSettled(dispatchPromises);
+    }
+    catch (error) {
+        // Top-level error handling - log but don't propagate
+        console.error('[NotificationHooks] Failed to trigger notifications:', error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Dispatch a notification to a specific destination
+ *
+ * @param destination - Notification destination config
+ * @param payload - Notification payload
+ * @returns Promise<boolean> - True if dispatch succeeded
+ */
+export async function dispatchToDestination(destination, payload) {
+    try {
+        // Dynamically import the appropriate adapter
+        const { sendNotification } = await import(`./notifications/${destination.type}.js`);
+        // Call adapter's sendNotification function
+        const result = await sendNotification(destination.config, payload);
+        return result;
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('Cannot find module')) {
+            console.error(`[NotificationHooks] Unsupported destination type: ${destination.type}`);
+            return false;
+        }
+        console.error(`[NotificationHooks] Dispatch error for ${destination.type}:`, error instanceof Error ? error.message : String(error));
+        return false;
+    }
+}
+/**
+ * Validate notification hook configuration
+ *
+ * @param hook - Hook configuration to validate
+ * @returns Validation result with errors
+ */
+export function validateHook(hook) {
+    const errors = [];
+    if (!hook.id) {
+        errors.push('Hook must have an id');
+    }
+    if (!hook.events || !Array.isArray(hook.events) || hook.events.length === 0) {
+        errors.push('Hook must have a non-empty events array');
+    }
+    if (!hook.destination) {
+        errors.push('Hook must have a destination');
+    }
+    else {
+        if (!hook.destination.type) {
+            errors.push('Destination must have a type');
+        }
+        if (!hook.destination.config || typeof hook.destination.config !== 'object') {
+            errors.push('Destination must have a config object');
+        }
+    }
+    // Validate event types
+    const validEvents = [
+        'escalation',
+        'blocker',
+        'failure',
+        'milestone',
+        'completion',
+        'stale_agent',
+        'human_required'
+    ];
+    if (hook.events) {
+        const invalidEvents = hook.events.filter(e => !validEvents.includes(e));
+        if (invalidEvents.length > 0) {
+            errors.push(`Invalid event types: ${invalidEvents.join(', ')}`);
+        }
+    }
+    // Validate destination type
+    const validDestinations = ['slack', 'discord', 'teams', 'webhook', 'email'];
+    if (hook.destination?.type && !validDestinations.includes(hook.destination.type)) {
+        errors.push(`Invalid destination type: ${hook.destination.type}. Must be one of: ${validDestinations.join(', ')}`);
+    }
+    return {
+        valid: errors.length === 0,
+        errors
+    };
+}
+//# sourceMappingURL=notification-hooks.js.map

package/dist/lib/notification-hooks.js.map

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

package/dist/lib/notifications/discord.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [notifications, discord, webhook, epic-004]
+ * @related: [index.ts, notification-hooks.ts, slack.ts, teams.ts, webhook.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: []
+ */
+import { NotificationPayload } from '../notification-hooks.js';
+/**
+ * Send notification to Discord via webhook
+ *
+ * @param config - Discord configuration (must include webhook_url)
+ * @param payload - Notification payload
+ * @returns Promise<boolean> - True if notification sent successfully
+ */
+export declare function sendNotification(config: Record<string, string>, payload: NotificationPayload): Promise<boolean>;
+//# sourceMappingURL=discord.d.ts.map

package/dist/lib/notifications/discord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord.d.ts","sourceRoot":"","sources":["../../../src/lib/notifications/discord.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAU/D;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAoClB"}

package/dist/lib/notifications/discord.js

@@ -0,0 +1,140 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [notifications, discord, webhook, epic-004]
+ * @related: [index.ts, notification-hooks.ts, slack.ts, teams.ts, webhook.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: []
+ */
+import { retryWithBackoff, truncate } from './index.js';
+/**
+ * Send notification to Discord via webhook
+ *
+ * @param config - Discord configuration (must include webhook_url)
+ * @param payload - Notification payload
+ * @returns Promise<boolean> - True if notification sent successfully
+ */
+export async function sendNotification(config, payload) {
+    const discordConfig = config;
+    // Validate required config
+    if (!discordConfig.webhook_url) {
+        console.error('[DiscordNotification] Missing webhook_url in config');
+        return false;
+    }
+    try {
+        // Build Discord message
+        const message = buildDiscordMessage(payload);
+        // Send with retry logic
+        await retryWithBackoff(async () => {
+            const response = await fetch(discordConfig.webhook_url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(message),
+                signal: AbortSignal.timeout(5000), // 5 second timeout
+            });
+            if (!response.ok) {
+                throw new Error(`Discord webhook returned ${response.status}: ${response.statusText}`);
+            }
+            return response;
+        });
+        return true;
+    }
+    catch (error) {
+        console.error('[DiscordNotification] Failed to send notification:', error instanceof Error ? error.message : String(error));
+        return false;
+    }
+}
+/**
+ * Build Discord message with embed
+ *
+ * @param payload - Notification payload
+ * @returns Discord message object
+ */
+function buildDiscordMessage(payload) {
+    const embed = {
+        title: truncate(payload.title, 256), // Discord limit: 256 chars
+        description: truncate(payload.description, 4096), // Discord limit: 4096 chars
+        color: getSeverityColor(payload.severity),
+        fields: [],
+        timestamp: payload.timestamp,
+        footer: {
+            text: `Ginko ${payload.event}`,
+        },
+    };
+    // Add fields
+    if (payload.severity) {
+        embed.fields.push({
+            name: 'Severity',
+            value: capitalizeFirst(payload.severity),
+            inline: true,
+        });
+    }
+    if (payload.taskId) {
+        embed.fields.push({
+            name: 'Task',
+            value: payload.taskId,
+            inline: true,
+        });
+    }
+    if (payload.epicId) {
+        embed.fields.push({
+            name: 'Epic',
+            value: payload.epicId,
+            inline: true,
+        });
+    }
+    if (payload.agentId) {
+        embed.fields.push({
+            name: 'Agent',
+            value: payload.agentId,
+            inline: true,
+        });
+    }
+    // Add custom metadata fields (limit to 25 fields total - Discord limit)
+    if (payload.metadata) {
+        for (const [key, value] of Object.entries(payload.metadata)) {
+            if (embed.fields.length >= 25)
+                break;
+            embed.fields.push({
+                name: capitalizeFirst(key),
+                value: truncate(String(value), 1024), // Discord limit: 1024 chars per field
+                inline: true,
+            });
+        }
+    }
+    return { embeds: [embed] };
+}
+/**
+ * Get color for severity level (Discord uses decimal color codes)
+ *
+ * @param severity - Severity level
+ * @returns Discord color code
+ */
+function getSeverityColor(severity) {
+    switch (severity) {
+        case 'critical':
+            return 0xFF0000; // Red
+        case 'high':
+            return 0xFF8C00; // Orange
+        case 'medium':
+            return 0xFFD700; // Yellow/Gold
+        case 'low':
+            return 0x1E90FF; // Blue
+        default:
+            return 0x808080; // Gray
+    }
+}
+/**
+ * Capitalize first letter of string
+ *
+ * @param str - String to capitalize
+ * @returns Capitalized string
+ */
+function capitalizeFirst(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=discord.js.map

package/dist/lib/notifications/discord.js.map

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

package/dist/lib/notifications/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [notifications, adapters, epic-004, resilience]
+ * @related: [notification-hooks.ts, slack.ts, discord.ts, teams.ts, webhook.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: []
+ */
+import { NotificationPayload } from '../notification-hooks.js';
+/**
+ * Standard notification adapter interface
+ * All adapters must implement this interface
+ */
+export interface NotificationAdapter {
+    /**
+     * Send a notification via this adapter
+     *
+     * @param config - Adapter-specific configuration
+     * @param payload - Notification payload
+     * @returns Promise<boolean> - True if notification sent successfully
+     */
+    sendNotification(config: Record<string, string>, payload: NotificationPayload): Promise<boolean>;
+}
+/**
+ * Retry configuration for notification dispatches
+ */
+export interface RetryConfig {
+    maxAttempts: number;
+    initialDelayMs: number;
+    maxDelayMs: number;
+    backoffMultiplier: number;
+}
+/**
+ * Retry helper for notification dispatches
+ * Implements exponential backoff with configurable limits
+ *
+ * @param fn - Async function to retry
+ * @param config - Retry configuration
+ * @returns Promise with function result
+ */
+export declare function retryWithBackoff<T>(fn: () => Promise<T>, config?: Partial<RetryConfig>): Promise<T>;
+/**
+ * Format severity with emoji for notifications
+ *
+ * @param severity - Severity level
+ * @returns Formatted severity string with emoji
+ */
+export declare function formatSeverity(severity: string): string;
+/**
+ * Truncate text to a maximum length
+ *
+ * @param text - Text to truncate
+ * @param maxLength - Maximum length
+ * @returns Truncated text
+ */
+export declare function truncate(text: string, maxLength: number): string;
+/**
+ * Format timestamp for display
+ *
+ * @param timestamp - ISO timestamp string
+ * @returns Formatted timestamp
+ */
+export declare function formatTimestamp(timestamp: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/notifications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,gBAAgB,CACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AASD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAChC,OAAO,CAAC,CAAC,CAAC,CA2BZ;AA0BD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAavD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKhE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAUzD"}

package/dist/lib/notifications/index.js

@@ -0,0 +1,120 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [notifications, adapters, epic-004, resilience]
+ * @related: [notification-hooks.ts, slack.ts, discord.ts, teams.ts, webhook.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: []
+ */
+const DEFAULT_RETRY_CONFIG = {
+    maxAttempts: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 5000,
+    backoffMultiplier: 2
+};
+/**
+ * Retry helper for notification dispatches
+ * Implements exponential backoff with configurable limits
+ *
+ * @param fn - Async function to retry
+ * @param config - Retry configuration
+ * @returns Promise with function result
+ */
+export async function retryWithBackoff(fn, config = {}) {
+    const finalConfig = { ...DEFAULT_RETRY_CONFIG, ...config };
+    let lastError = null;
+    let delay = finalConfig.initialDelayMs;
+    for (let attempt = 1; attempt <= finalConfig.maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // Check if error is retryable (4xx errors are not retryable)
+            if (isNonRetryableError(error)) {
+                throw lastError;
+            }
+            if (attempt < finalConfig.maxAttempts) {
+                console.log(`[NotificationRetry] Attempt ${attempt}/${finalConfig.maxAttempts} failed, retrying in ${delay}ms...`);
+                await new Promise(resolve => setTimeout(resolve, delay));
+                // Exponential backoff with max delay cap
+                delay = Math.min(delay * finalConfig.backoffMultiplier, finalConfig.maxDelayMs);
+            }
+        }
+    }
+    throw lastError || new Error('Retry failed with unknown error');
+}
+/**
+ * Check if an error is non-retryable (client errors)
+ *
+ * @param error - Error to check
+ * @returns True if error should not be retried
+ */
+function isNonRetryableError(error) {
+    // Check for HTTP client errors (4xx)
+    if (error.response?.status) {
+        const status = error.response.status;
+        return status >= 400 && status < 500 && status !== 429; // Retry 429 (rate limit)
+    }
+    // Check for specific error messages
+    if (error instanceof Error) {
+        const message = error.message.toLowerCase();
+        if (message.includes('invalid') || message.includes('unauthorized') || message.includes('forbidden')) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Format severity with emoji for notifications
+ *
+ * @param severity - Severity level
+ * @returns Formatted severity string with emoji
+ */
+export function formatSeverity(severity) {
+    switch (severity) {
+        case 'critical':
+            return '🚨 Critical';
+        case 'high':
+            return '⚠️  High';
+        case 'medium':
+            return '💡 Medium';
+        case 'low':
+            return 'ℹ️  Low';
+        default:
+            return severity;
+    }
+}
+/**
+ * Truncate text to a maximum length
+ *
+ * @param text - Text to truncate
+ * @param maxLength - Maximum length
+ * @returns Truncated text
+ */
+export function truncate(text, maxLength) {
+    if (text.length <= maxLength) {
+        return text;
+    }
+    return text.substring(0, maxLength - 3) + '...';
+}
+/**
+ * Format timestamp for display
+ *
+ * @param timestamp - ISO timestamp string
+ * @returns Formatted timestamp
+ */
+export function formatTimestamp(timestamp) {
+    const date = new Date(timestamp);
+    return date.toLocaleString('en-US', {
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit',
+        timeZoneName: 'short'
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/notifications/index.js.map

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

package/dist/lib/notifications/slack.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [notifications, slack, webhook, epic-004]
+ * @related: [index.ts, notification-hooks.ts, discord.ts, teams.ts, webhook.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: []
+ */
+import { NotificationPayload } from '../notification-hooks.js';
+/**
+ * Send notification to Slack via webhook
+ *
+ * @param config - Slack configuration (must include webhook_url)
+ * @param payload - Notification payload
+ * @returns Promise<boolean> - True if notification sent successfully
+ */
+export declare function sendNotification(config: Record<string, string>, payload: NotificationPayload): Promise<boolean>;
+//# sourceMappingURL=slack.d.ts.map

package/dist/lib/notifications/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../../src/lib/notifications/slack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AA6B/D;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAoClB"}