crewly 1.12.1 → 1.13.1

package/dist/cli/backend/src/services/orchestrator/safe-restart.service.js

@@ -0,0 +1,395 @@
+/**
+ * Safe Restart Service
+ *
+ * Manages graceful shutdown and restart of Crewly,
+ * preserving state and enabling seamless recovery.
+ *
+ * @module services/orchestrator/safe-restart
+ */
+import { spawn } from 'child_process';
+import * as path from 'path';
+import * as fs from 'fs/promises';
+import { getStatePersistenceService } from './state-persistence.service.js';
+import { getSlackBridgeLazy } from './slack-bridge-lazy.js';
+import { LoggerService } from '../core/logger.service.js';
+/**
+ * Safe restart service singleton
+ */
+let safeRestartInstance = null;
+/**
+ * SafeRestartService class
+ *
+ * Handles graceful shutdown, state preservation, and process restart.
+ * Integrates with state persistence and Slack for notifications.
+ *
+ * @example
+ * ```typescript
+ * const service = getSafeRestartService();
+ *
+ * // Handle startup and resume
+ * const instructions = await service.handleStartup();
+ * if (instructions) {
+ *   // Resume tasks and conversations
+ * }
+ *
+ * // Schedule restart for self-improvement
+ * service.scheduleRestart({
+ *   reason: 'Applying code changes',
+ *   delayMs: 5000,
+ *   notifySlack: true,
+ * });
+ * ```
+ */
+export class SafeRestartService {
+    isRestartingFlag = false;
+    restartTimer = null;
+    scheduledRestartReason = null;
+    scheduledRestartTime = null;
+    shutdownCallbacks = [];
+    startupCallbacks = [];
+    signalHandlersRegistered = false;
+    logger = LoggerService.getInstance().createComponentLogger('SafeRestart');
+    /**
+     * Create a new SafeRestartService
+     *
+     * Note: Does not automatically register signal handlers.
+     * Call registerProcessHandlers() explicitly to enable signal handling.
+     */
+    constructor() {
+        // Handlers are registered separately to allow testing
+    }
+    /**
+     * Register process signal handlers
+     *
+     * Sets up handlers for SIGTERM, SIGINT, and error events.
+     * Should be called during application initialization.
+     */
+    registerProcessHandlers() {
+        if (this.signalHandlersRegistered)
+            return;
+        // Handle graceful shutdown signals
+        const shutdownHandler = async (signal) => {
+            this.logger.info('Received signal, initiating graceful shutdown...', { signal });
+            await this.gracefulShutdown(`signal:${signal}`);
+            process.exit(0);
+        };
+        process.on('SIGTERM', () => shutdownHandler('SIGTERM'));
+        process.on('SIGINT', () => shutdownHandler('SIGINT'));
+        // Handle uncaught errors
+        process.on('uncaughtException', async (error) => {
+            this.logger.error('Uncaught exception', { error: error instanceof Error ? error.message : String(error) });
+            await this.emergencyShutdown(error.message);
+            process.exit(1);
+        });
+        process.on('unhandledRejection', async (reason) => {
+            this.logger.error('Unhandled rejection', { reason: reason instanceof Error ? reason.message : String(reason) });
+            // Don't exit, just log and try to recover
+        });
+        this.signalHandlersRegistered = true;
+        this.logger.info('Process handlers registered');
+    }
+    /**
+     * Register a callback to run before shutdown
+     *
+     * @param callback - Async function to run during shutdown
+     */
+    onShutdown(callback) {
+        this.shutdownCallbacks.push(callback);
+    }
+    /**
+     * Register a callback to run after startup
+     *
+     * @param callback - Async function to run with resume instructions
+     */
+    onStartup(callback) {
+        this.startupCallbacks.push(callback);
+    }
+    /**
+     * Handle application startup
+     *
+     * Initializes state persistence, loads previous state, and runs
+     * startup callbacks with resume instructions.
+     *
+     * @returns Resume instructions if restarting, null for fresh start
+     */
+    async handleStartup() {
+        const statePersistence = getStatePersistenceService();
+        const previousState = await statePersistence.initialize();
+        if (!previousState) {
+            this.logger.info('Fresh start - no previous state');
+            return null;
+        }
+        // Generate resume instructions
+        const instructions = statePersistence.generateResumeInstructions(previousState);
+        // Notify via Slack if available
+        try {
+            const slackBridge = await getSlackBridgeLazy();
+            for (const notification of instructions.notifications) {
+                if (notification.type === 'slack') {
+                    await slackBridge.sendNotification({
+                        type: 'alert',
+                        title: 'Crewly Restarted',
+                        message: notification.message,
+                        urgency: 'normal',
+                        timestamp: new Date().toISOString(),
+                    });
+                }
+            }
+        }
+        catch {
+            // Slack not available, continue without notification
+            this.logger.info('Slack notification skipped (not connected)');
+        }
+        // Run startup callbacks
+        for (const callback of this.startupCallbacks) {
+            try {
+                await callback(instructions);
+            }
+            catch (error) {
+                this.logger.error('Startup callback error', { error: error instanceof Error ? error.message : String(error) });
+            }
+        }
+        return instructions;
+    }
+    /**
+     * Initiate graceful shutdown
+     *
+     * Runs all shutdown callbacks and saves state before shutdown.
+     *
+     * @param reason - Reason for shutdown
+     */
+    async gracefulShutdown(reason) {
+        if (this.isRestartingFlag)
+            return;
+        this.isRestartingFlag = true;
+        this.logger.info('Graceful shutdown', { reason });
+        // Run shutdown callbacks
+        for (const callback of this.shutdownCallbacks) {
+            try {
+                await callback();
+            }
+            catch (error) {
+                this.logger.error('Shutdown callback error', { error: error instanceof Error ? error.message : String(error) });
+            }
+        }
+        // Save state
+        try {
+            const statePersistence = getStatePersistenceService();
+            await statePersistence.prepareForShutdown();
+        }
+        catch (error) {
+            this.logger.error('Failed to save state', { error: error instanceof Error ? error.message : String(error) });
+        }
+        // Notify Slack
+        try {
+            const slackBridge = await getSlackBridgeLazy();
+            await slackBridge.sendNotification({
+                type: 'alert',
+                title: 'Crewly Shutting Down',
+                message: `Reason: ${reason}. State has been saved and will resume on restart.`,
+                urgency: 'normal',
+                timestamp: new Date().toISOString(),
+            });
+        }
+        catch {
+            this.logger.info('Slack notification skipped (not connected)');
+        }
+        this.logger.info('Shutdown complete');
+    }
+    /**
+     * Emergency shutdown (minimal cleanup)
+     *
+     * Attempts to save state with minimal processing for error scenarios.
+     *
+     * @param reason - Reason for emergency shutdown
+     */
+    async emergencyShutdown(reason) {
+        this.logger.error('Emergency shutdown', { reason });
+        try {
+            const statePersistence = getStatePersistenceService();
+            await statePersistence.saveState('error_recovery');
+        }
+        catch (error) {
+            this.logger.error('Failed to save state in emergency', { error: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    /**
+     * Schedule a restart
+     *
+     * Schedules a restart after the specified delay.
+     *
+     * @param config - Restart configuration
+     */
+    scheduleRestart(config) {
+        const delayMs = config.delayMs ?? 5000;
+        this.logger.info('Restart scheduled', { delayMs, reason: config.reason });
+        this.scheduledRestartReason = config.reason;
+        this.scheduledRestartTime = new Date(Date.now() + delayMs);
+        // Notify Slack
+        if (config.notifySlack) {
+            this.notifyRestartScheduled(config.reason, delayMs);
+        }
+        this.restartTimer = setTimeout(async () => {
+            await this.executeRestart(config);
+        }, delayMs);
+    }
+    /**
+     * Cancel scheduled restart
+     *
+     * @returns True if a restart was cancelled, false if none scheduled
+     */
+    cancelScheduledRestart() {
+        if (this.restartTimer) {
+            clearTimeout(this.restartTimer);
+            this.restartTimer = null;
+            this.scheduledRestartReason = null;
+            this.scheduledRestartTime = null;
+            this.logger.info('Scheduled restart cancelled');
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Execute restart
+     *
+     * @param config - Restart configuration
+     */
+    async executeRestart(config) {
+        if (!config.skipStateSave) {
+            await this.gracefulShutdown(config.reason);
+        }
+        this.logger.info('Restarting process...');
+        // Write restart marker file
+        const markerPath = path.join(process.cwd(), '.restart-marker');
+        const marker = {
+            reason: config.reason,
+            timestamp: new Date().toISOString(),
+            postRestartCommand: config.postRestartCommand,
+        };
+        await fs.writeFile(markerPath, JSON.stringify(marker));
+        // Spawn new process
+        const args = process.argv.slice(1);
+        const newProcess = spawn(process.argv[0], args, {
+            detached: true,
+            stdio: 'inherit',
+            env: {
+                ...process.env,
+                CREWLY_RESTARTED: 'true',
+                CREWLY_RESTART_REASON: config.reason,
+            },
+        });
+        newProcess.unref();
+        // Exit current process
+        process.exit(0);
+    }
+    /**
+     * Notify about scheduled restart
+     *
+     * @param reason - Restart reason
+     * @param delayMs - Delay in milliseconds
+     */
+    async notifyRestartScheduled(reason, delayMs) {
+        try {
+            const slackBridge = await getSlackBridgeLazy();
+            await slackBridge.sendNotification({
+                type: 'alert',
+                title: 'Crewly Restart Scheduled',
+                message: `:hourglass: Restarting in ${Math.round(delayMs / 1000)} seconds\nReason: ${reason}`,
+                urgency: 'normal',
+                timestamp: new Date().toISOString(),
+            });
+        }
+        catch {
+            this.logger.info('Slack notification skipped (not connected)');
+        }
+    }
+    /**
+     * Get restart status
+     *
+     * @returns Current restart status
+     */
+    getStatus() {
+        const status = {
+            isRestarting: this.isRestartingFlag,
+        };
+        if (this.scheduledRestartTime) {
+            status.restartScheduledAt = this.scheduledRestartTime.toISOString();
+            status.restartReason = this.scheduledRestartReason ?? undefined;
+            status.countdown = Math.max(0, Math.round((this.scheduledRestartTime.getTime() - Date.now()) / 1000));
+        }
+        return status;
+    }
+    /**
+     * Check if this is a restart (vs fresh start)
+     *
+     * @returns True if this process was started after a restart
+     */
+    isRestart() {
+        return process.env.CREWLY_RESTARTED === 'true';
+    }
+    /**
+     * Get restart reason (if restarted)
+     *
+     * @returns Restart reason or undefined for fresh start
+     */
+    getRestartReason() {
+        return process.env.CREWLY_RESTART_REASON;
+    }
+    /**
+     * Check for and execute post-restart command
+     *
+     * Reads the restart marker file and executes any post-restart command.
+     */
+    async checkPostRestartCommand() {
+        const markerPath = path.join(process.cwd(), '.restart-marker');
+        try {
+            const data = await fs.readFile(markerPath, 'utf-8');
+            const marker = JSON.parse(data);
+            // Delete marker
+            await fs.unlink(markerPath);
+            if (marker.postRestartCommand) {
+                this.logger.info('Post-restart command found', { command: marker.postRestartCommand });
+                // Note: Actual command execution would be implemented here
+                // For safety, we just log for now
+            }
+        }
+        catch {
+            // No marker file, normal start
+        }
+    }
+    /**
+     * Clear shutdown callbacks (for testing)
+     */
+    clearShutdownCallbacks() {
+        this.shutdownCallbacks = [];
+    }
+    /**
+     * Clear startup callbacks (for testing)
+     */
+    clearStartupCallbacks() {
+        this.startupCallbacks = [];
+    }
+}
+/**
+ * Get singleton instance
+ *
+ * @returns SafeRestartService instance
+ */
+export function getSafeRestartService() {
+    if (!safeRestartInstance) {
+        safeRestartInstance = new SafeRestartService();
+    }
+    return safeRestartInstance;
+}
+/**
+ * Reset instance (for testing)
+ */
+export function resetSafeRestartService() {
+    if (safeRestartInstance) {
+        safeRestartInstance.cancelScheduledRestart();
+        safeRestartInstance.clearShutdownCallbacks();
+        safeRestartInstance.clearStartupCallbacks();
+    }
+    safeRestartInstance = null;
+}
+//# sourceMappingURL=safe-restart.service.js.map

package/dist/cli/backend/src/services/orchestrator/safe-restart.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-restart.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/orchestrator/safe-restart.service.ts"],"names":[],"mappings":"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"}

package/dist/cli/backend/src/services/orchestrator/self-improvement.service.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Self-Improvement Service
+ *
+ * Enables the orchestrator to safely modify the Crewly codebase,
+ * using the marker system to persist state across hot-reload restarts.
+ *
+ * @module services/orchestrator/self-improvement
+ */
+import { ImprovementMarker } from './improvement-marker.service.js';
+/**
+ * Improvement request configuration
+ */
+export interface ImprovementRequest {
+    /** Description of the improvement */
+    description: string;
+    /** Files that will be modified */
+    targetFiles: string[];
+    /** Planned changes to apply */
+    changes: Array<{
+        file: string;
+        type: 'create' | 'modify' | 'delete';
+        description: string;
+        content?: string;
+    }>;
+    /** Slack context for notifications */
+    slackContext?: {
+        channelId: string;
+        threadTs: string;
+        userId: string;
+    };
+}
+/**
+ * Improvement plan returned after planning
+ */
+export interface ImprovementPlan {
+    /** Unique improvement ID */
+    id: string;
+    /** Description of the improvement */
+    description: string;
+    /** Target files */
+    targetFiles: string[];
+    /** Planned changes */
+    changes: Array<{
+        file: string;
+        type: 'create' | 'modify' | 'delete';
+        description: string;
+    }>;
+    /** Risk level assessment */
+    riskLevel: 'low' | 'medium' | 'high';
+    /** Whether changes require restart */
+    requiresRestart: boolean;
+}
+/**
+ * Result of an improvement execution
+ */
+export interface ImprovementResult {
+    /** Whether the improvement was started */
+    started: boolean;
+    /** Message about what happened */
+    message: string;
+    /** Task ID for tracking */
+    taskId?: string;
+}
+/**
+ * SelfImprovementService class
+ *
+ * Manages the self-improvement workflow using the marker system
+ * to persist state across hot-reload restarts.
+ *
+ * Flow:
+ * 1. planImprovement() - Creates marker in 'planning' phase
+ * 2. executeImprovement() - Creates backups, applies changes
+ * 3. Process is killed by hot-reload
+ * 4. Startup hook handles validation and rollback
+ *
+ * @example
+ * ```typescript
+ * const service = getSelfImprovementService();
+ *
+ * const plan = await service.planImprovement({
+ *   description: 'Add new feature',
+ *   targetFiles: ['src/feature.ts'],
+ *   changes: [{ file: 'src/feature.ts', type: 'create', description: 'New feature', content: '...' }],
+ * });
+ *
+ * const result = await service.executeImprovement(request);
+ * // Hot-reload will kill the process, startup hook will validate
+ * ```
+ */
+export declare class SelfImprovementService {
+    private projectRoot;
+    private logger;
+    /**
+     * Create a new SelfImprovementService.
+     *
+     * @param projectRoot - Root directory of the project (defaults to process.cwd())
+     */
+    constructor(projectRoot?: string);
+    /**
+     * Plan an improvement (creates marker in 'planning' phase).
+     *
+     * @param request - The improvement request configuration
+     * @returns ImprovementPlan for review before execution
+     * @throws Error if another improvement is already pending
+     */
+    planImprovement(request: ImprovementRequest): Promise<ImprovementPlan>;
+    /**
+     * Execute the planned improvement.
+     *
+     * IMPORTANT: This method:
+     * 1. Creates backups
+     * 2. Writes marker with backup info
+     * 3. Applies changes (triggers hot-reload)
+     * 4. Process gets killed by hot-reload
+     * 5. Startup hook handles validation
+     *
+     * @param request - The improvement request with content
+     * @returns Result indicating that changes were started
+     * @throws Error if no improvement is planned
+     */
+    executeImprovement(request: ImprovementRequest): Promise<ImprovementResult>;
+    /**
+     * Cancel a planned improvement.
+     *
+     * @throws Error if improvement is past planning phase
+     */
+    cancelImprovement(): Promise<void>;
+    /**
+     * Get current improvement status.
+     *
+     * @returns Current improvement marker or null
+     */
+    getStatus(): Promise<ImprovementMarker | null>;
+    /**
+     * Get improvement history.
+     *
+     * @param limit - Maximum number of history items to return
+     * @returns Array of historical improvement markers
+     */
+    getHistory(limit?: number): Promise<ImprovementMarker[]>;
+    /**
+     * Create git checkpoint.
+     *
+     * @returns Git commit and branch info
+     */
+    private createGitCheckpoint;
+    /**
+     * Create file backups.
+     *
+     * @param files - Files to backup
+     * @returns Array of backup records
+     */
+    private createFileBackups;
+    /**
+     * Apply file changes.
+     *
+     * @param changes - Changes to apply
+     * @returns Array of applied changes
+     */
+    private applyChanges;
+    /**
+     * Analyze risk level.
+     *
+     * @param files - Files to analyze
+     * @returns Risk level
+     */
+    private analyzeRisk;
+    /**
+     * Check if changes require restart.
+     *
+     * @param files - Files being changed
+     * @returns True if restart is needed
+     */
+    private checkRequiresRestart;
+    /**
+     * Run shell command.
+     *
+     * @param cmd - Command to run
+     * @param args - Command arguments
+     * @returns Command output
+     */
+    private runCommand;
+    /**
+     * Send Slack notification.
+     *
+     * @param message - Message to send
+     * @param urgency - Urgency level
+     */
+    private notifySlack;
+}
+/**
+ * Get singleton instance.
+ *
+ * @returns SelfImprovementService instance
+ */
+export declare function getSelfImprovementService(): SelfImprovementService;
+/**
+ * Reset instance (for testing).
+ */
+export declare function resetSelfImprovementService(): void;
+//# sourceMappingURL=self-improvement.service.d.ts.map

package/dist/cli/backend/src/services/orchestrator/self-improvement.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-improvement.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/orchestrator/self-improvement.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAEL,iBAAiB,EAElB,MAAM,iCAAiC,CAAC;AAIzC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,+BAA+B;IAC/B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACrC,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,sCAAsC;IACtC,YAAY,CAAC,EAAE;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,sBAAsB;IACtB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACrC,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,4BAA4B;IAC5B,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,sCAAsC;IACtC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAyF;IAEvG;;;;OAIG;gBACS,WAAW,CAAC,EAAE,MAAM;IAIhC;;;;;;OAMG;IACG,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC;IAmD5E;;;;;;;;;;;;;OAaG;IACG,kBAAkB,CACtB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IAyE7B;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBxC;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAKpD;;;;;OAKG;IACG,UAAU,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAKlE;;;;OAIG;YACW,mBAAmB;IAWjC;;;;;OAKG;YACW,iBAAiB;IA+C/B;;;;;OAKG;YACW,YAAY;IAuC1B;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IA8BnB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IAyBlB;;;;;OAKG;YACW,WAAW;CAc1B;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,sBAAsB,CAKlE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}