@stackmemoryai/stackmemory 0.5.57 → 0.5.59

package/dist/src/integrations/ralph/lifecycle/iteration-lifecycle.js

@@ -0,0 +1,448 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { EventEmitter } from "events";
+import { execSync } from "child_process";
+import { logger } from "../../../core/monitoring/logger.js";
+class IterationLifecycle extends EventEmitter {
+  config;
+  hooks = {};
+  checkpoints = [];
+  currentIteration;
+  iterationHistory = [];
+  activeTimers = /* @__PURE__ */ new Map();
+  constructor(config, hooks) {
+    super();
+    this.config = {
+      hooks: {
+        preIteration: config?.hooks?.preIteration ?? true,
+        postIteration: config?.hooks?.postIteration ?? true,
+        onStateChange: config?.hooks?.onStateChange ?? true,
+        onError: config?.hooks?.onError ?? true,
+        onComplete: config?.hooks?.onComplete ?? true
+      },
+      checkpoints: {
+        enabled: config?.checkpoints?.enabled ?? true,
+        frequency: config?.checkpoints?.frequency || 5,
+        retentionDays: config?.checkpoints?.retentionDays || 7
+      }
+    };
+    if (hooks) {
+      this.registerHooks(hooks);
+    }
+    this.setupEventHandlers();
+  }
+  /**
+   * Register lifecycle hooks
+   */
+  registerHooks(hooks) {
+    this.hooks = { ...this.hooks, ...hooks };
+    logger.debug("Lifecycle hooks registered", {
+      registered: Object.keys(hooks)
+    });
+  }
+  /**
+   * Start iteration with lifecycle management
+   */
+  async startIteration(iterationNumber, context) {
+    logger.info("Starting iteration", { iteration: iterationNumber });
+    this.emitEvent({
+      type: "iteration.started",
+      timestamp: Date.now(),
+      iteration: iterationNumber,
+      data: { context }
+    });
+    let processedContext = context;
+    if (this.config.hooks.preIteration && this.hooks.preIteration) {
+      try {
+        processedContext = await this.hooks.preIteration(context);
+        logger.debug("Pre-iteration hook executed", {
+          original: context.tokenCount,
+          processed: processedContext.tokenCount
+        });
+      } catch (error) {
+        await this.handleError(error, { phase: "preIteration", context });
+      }
+    }
+    this.startTimer(`iteration-${iterationNumber}`);
+    return processedContext;
+  }
+  /**
+   * Complete iteration with lifecycle management
+   */
+  async completeIteration(iteration) {
+    logger.info("Completing iteration", { iteration: iteration.number });
+    this.currentIteration = iteration;
+    const duration = this.stopTimer(`iteration-${iteration.number}`);
+    if (this.config.hooks.postIteration && this.hooks.postIteration) {
+      try {
+        await this.hooks.postIteration(iteration);
+        logger.debug("Post-iteration hook executed");
+      } catch (error) {
+        await this.handleError(error, { phase: "postIteration", iteration });
+      }
+    }
+    if (this.shouldCreateCheckpoint(iteration.number)) {
+      await this.createCheckpoint(iteration);
+    }
+    this.emitEvent({
+      type: "iteration.completed",
+      timestamp: Date.now(),
+      iteration: iteration.number,
+      data: {
+        iteration,
+        duration,
+        success: iteration.validation.testsPass
+      }
+    });
+    await this.cleanOldCheckpoints();
+  }
+  /**
+   * Handle iteration failure
+   */
+  async failIteration(iterationNumber, error, context) {
+    logger.error("Iteration failed", {
+      iteration: iterationNumber,
+      error: error.message
+    });
+    this.stopTimer(`iteration-${iterationNumber}`);
+    if (this.config.hooks.onError && this.hooks.onError) {
+      try {
+        await this.hooks.onError(error, context);
+      } catch (hookError) {
+        logger.error("Error hook failed", { error: hookError.message });
+      }
+    }
+    this.emitEvent({
+      type: "iteration.failed",
+      timestamp: Date.now(),
+      iteration: iterationNumber,
+      data: {
+        error: error.message,
+        stack: error.stack,
+        context
+      }
+    });
+  }
+  /**
+   * Handle state change
+   */
+  async handleStateChange(oldState, newState) {
+    logger.debug("State change detected", {
+      old: oldState.status,
+      new: newState.status,
+      iteration: newState.iteration
+    });
+    if (this.config.hooks.onStateChange && this.hooks.onStateChange) {
+      try {
+        await this.hooks.onStateChange(oldState, newState);
+      } catch (error) {
+        await this.handleError(error, {
+          phase: "stateChange",
+          oldState,
+          newState
+        });
+      }
+    }
+    this.emitEvent({
+      type: "state.changed",
+      timestamp: Date.now(),
+      iteration: newState.iteration,
+      data: {
+        oldStatus: oldState.status,
+        newStatus: newState.status,
+        changes: this.detectStateChanges(oldState, newState)
+      }
+    });
+    if (newState.status === "completed" && oldState.status !== "completed") {
+      await this.handleCompletion(newState);
+    }
+  }
+  /**
+   * Handle loop completion
+   */
+  async handleCompletion(state) {
+    logger.info("Loop completed", {
+      iterations: state.iteration,
+      duration: state.lastUpdateTime - state.startTime
+    });
+    if (this.config.hooks.onComplete && this.hooks.onComplete) {
+      try {
+        await this.hooks.onComplete(state);
+      } catch (error) {
+        await this.handleError(error, { phase: "completion", state });
+      }
+    }
+    await this.createFinalCheckpoint(state);
+    this.cleanupTimers();
+  }
+  /**
+   * Create checkpoint
+   */
+  async createCheckpoint(iteration) {
+    const checkpoint = {
+      id: this.generateCheckpointId(),
+      iteration: iteration.number,
+      timestamp: Date.now(),
+      state: await this.captureCurrentState(),
+      gitCommit: await this.getCurrentGitCommit(),
+      verified: false
+    };
+    checkpoint.verified = await this.verifyCheckpoint(checkpoint);
+    this.checkpoints.push(checkpoint);
+    logger.info("Checkpoint created", {
+      id: checkpoint.id,
+      iteration: checkpoint.iteration,
+      verified: checkpoint.verified
+    });
+    if (this.hooks.onCheckpoint) {
+      try {
+        await this.hooks.onCheckpoint(checkpoint);
+      } catch (error) {
+        logger.error("Checkpoint hook failed", { error: error.message });
+      }
+    }
+    this.emitEvent({
+      type: "checkpoint.created",
+      timestamp: Date.now(),
+      iteration: iteration.number,
+      data: { checkpoint }
+    });
+    return checkpoint;
+  }
+  /**
+   * Get checkpoints
+   */
+  getCheckpoints() {
+    return [...this.checkpoints];
+  }
+  /**
+   * Get last checkpoint
+   */
+  getLastCheckpoint() {
+    return this.checkpoints[this.checkpoints.length - 1];
+  }
+  /**
+   * Restore from checkpoint
+   */
+  async restoreFromCheckpoint(checkpointId) {
+    const checkpoint = this.checkpoints.find((c) => c.id === checkpointId);
+    if (!checkpoint) {
+      throw new Error(`Checkpoint not found: ${checkpointId}`);
+    }
+    logger.info("Restoring from checkpoint", {
+      id: checkpoint.id,
+      iteration: checkpoint.iteration
+    });
+    if (checkpoint.gitCommit) {
+      await this.restoreGitState(checkpoint.gitCommit);
+    }
+    await this.restoreRalphState(checkpoint.state);
+    logger.info("Checkpoint restored successfully");
+  }
+  /**
+   * Get iteration events
+   */
+  getEvents(filter) {
+    let events = [...this.iterationHistory];
+    if (filter?.type) {
+      events = events.filter((e) => e.type === filter.type);
+    }
+    if (filter?.iteration !== void 0) {
+      events = events.filter((e) => e.iteration === filter.iteration);
+    }
+    if (filter?.since) {
+      events = events.filter((e) => e.timestamp >= filter.since);
+    }
+    return events;
+  }
+  /**
+   * Clean up resources
+   */
+  cleanup() {
+    this.cleanupTimers();
+    this.removeAllListeners();
+    this.iterationHistory = [];
+    this.checkpoints = [];
+  }
+  /**
+   * Setup internal event handlers
+   */
+  setupEventHandlers() {
+    this.on("*", (event) => {
+      logger.debug("Lifecycle event", {
+        type: event.type,
+        iteration: event.iteration
+      });
+    });
+  }
+  /**
+   * Emit and track event
+   */
+  emitEvent(event) {
+    this.iterationHistory.push(event);
+    this.emit(event.type, event);
+    this.emit("*", event);
+  }
+  /**
+   * Should create checkpoint based on frequency
+   */
+  shouldCreateCheckpoint(iteration) {
+    if (!this.config.checkpoints.enabled) {
+      return false;
+    }
+    return iteration % this.config.checkpoints.frequency === 0;
+  }
+  /**
+   * Generate checkpoint ID
+   */
+  generateCheckpointId() {
+    return `chk-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+  }
+  /**
+   * Capture current state
+   */
+  async captureCurrentState() {
+    return {
+      loopId: "current",
+      task: "",
+      criteria: "",
+      iteration: this.currentIteration?.number || 0,
+      status: "running",
+      startTime: Date.now(),
+      lastUpdateTime: Date.now()
+    };
+  }
+  /**
+   * Get current git commit
+   */
+  async getCurrentGitCommit() {
+    try {
+      return execSync("git rev-parse HEAD", { encoding: "utf8" }).trim();
+    } catch {
+      return "";
+    }
+  }
+  /**
+   * Verify checkpoint integrity
+   */
+  async verifyCheckpoint(checkpoint) {
+    try {
+      if (!checkpoint.state.loopId || !checkpoint.state.task) {
+        return false;
+      }
+      if (checkpoint.gitCommit) {
+        execSync(`git rev-parse ${checkpoint.gitCommit}`, { encoding: "utf8" });
+      }
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Clean old checkpoints based on retention
+   */
+  async cleanOldCheckpoints() {
+    const cutoff = Date.now() - this.config.checkpoints.retentionDays * 24 * 60 * 60 * 1e3;
+    const before = this.checkpoints.length;
+    this.checkpoints = this.checkpoints.filter((c) => c.timestamp >= cutoff);
+    const removed = before - this.checkpoints.length;
+    if (removed > 0) {
+      logger.debug("Cleaned old checkpoints", { removed });
+    }
+  }
+  /**
+   * Create final checkpoint
+   */
+  async createFinalCheckpoint(state) {
+    const checkpoint = {
+      id: `final-${this.generateCheckpointId()}`,
+      iteration: state.iteration,
+      timestamp: Date.now(),
+      state,
+      gitCommit: await this.getCurrentGitCommit(),
+      verified: true
+    };
+    this.checkpoints.push(checkpoint);
+    logger.info("Final checkpoint created", {
+      id: checkpoint.id,
+      iterations: state.iteration
+    });
+  }
+  /**
+   * Restore git state
+   */
+  async restoreGitState(commit) {
+    execSync("git stash", { encoding: "utf8" });
+    execSync(`git checkout ${commit}`, { encoding: "utf8" });
+  }
+  /**
+   * Restore Ralph state
+   */
+  async restoreRalphState(state) {
+    logger.debug("Ralph state restored", { iteration: state.iteration });
+  }
+  /**
+   * Detect state changes
+   */
+  detectStateChanges(oldState, newState) {
+    const changes = [];
+    for (const key of Object.keys(newState)) {
+      if (JSON.stringify(oldState[key]) !== JSON.stringify(newState[key])) {
+        changes.push(key);
+      }
+    }
+    return changes;
+  }
+  /**
+   * Handle errors
+   */
+  async handleError(error, context) {
+    logger.error("Lifecycle error", {
+      error: error.message,
+      context
+    });
+    if (this.config.hooks.onError && this.hooks.onError) {
+      try {
+        await this.hooks.onError(error, context);
+      } catch (hookError) {
+        logger.error("Error hook failed", { error: hookError.message });
+      }
+    }
+  }
+  /**
+   * Start timer for metrics
+   */
+  startTimer(name) {
+    const start = Date.now();
+    this.activeTimers.set(name, setTimeout(() => {
+      this.activeTimers.delete(name);
+    }, 0));
+    this.activeTimers.get(name).startTime = start;
+  }
+  /**
+   * Stop timer and get duration
+   */
+  stopTimer(name) {
+    const timer = this.activeTimers.get(name);
+    if (!timer) return 0;
+    const duration = Date.now() - timer.startTime;
+    clearTimeout(timer);
+    this.activeTimers.delete(name);
+    return duration;
+  }
+  /**
+   * Clean up all timers
+   */
+  cleanupTimers() {
+    for (const timer of this.activeTimers.values()) {
+      clearTimeout(timer);
+    }
+    this.activeTimers.clear();
+  }
+}
+export {
+  IterationLifecycle
+};
+//# sourceMappingURL=iteration-lifecycle.js.map

package/dist/src/integrations/ralph/lifecycle/iteration-lifecycle.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/integrations/ralph/lifecycle/iteration-lifecycle.ts"],
+  "sourcesContent": ["/**\n * Iteration Lifecycle Manager for Ralph-StackMemory Integration\n * Provides lifecycle hooks and event management for clean integration points\n */\n\nimport { EventEmitter } from 'events';\nimport { execSync } from 'child_process';\nimport { logger } from '../../../core/monitoring/logger.js';\nimport {\n  RalphLoopState,\n  RalphIteration,\n  IterationEvent,\n  IterationEventType,\n  RalphStackMemoryConfig,\n  Checkpoint,\n  IterationContext,\n} from '../types.js';\n\nexport interface LifecycleHooks {\n  preIteration?: (context: IterationContext) => Promise<IterationContext>;\n  postIteration?: (iteration: RalphIteration) => Promise<void>;\n  onStateChange?: (oldState: RalphLoopState, newState: RalphLoopState) => Promise<void>;\n  onError?: (error: Error, context: any) => Promise<void>;\n  onComplete?: (state: RalphLoopState) => Promise<void>;\n  onCheckpoint?: (checkpoint: Checkpoint) => Promise<void>;\n}\n\nexport class IterationLifecycle extends EventEmitter {\n  private config: RalphStackMemoryConfig['lifecycle'];\n  private hooks: LifecycleHooks = {};\n  private checkpoints: Checkpoint[] = [];\n  private currentIteration?: RalphIteration;\n  private iterationHistory: IterationEvent[] = [];\n  private activeTimers: Map<string, NodeJS.Timeout> = new Map();\n\n  constructor(\n    config?: Partial<RalphStackMemoryConfig['lifecycle']>,\n    hooks?: LifecycleHooks\n  ) {\n    super();\n    \n    this.config = {\n      hooks: {\n        preIteration: config?.hooks?.preIteration ?? true,\n        postIteration: config?.hooks?.postIteration ?? true,\n        onStateChange: config?.hooks?.onStateChange ?? true,\n        onError: config?.hooks?.onError ?? true,\n        onComplete: config?.hooks?.onComplete ?? true,\n      },\n      checkpoints: {\n        enabled: config?.checkpoints?.enabled ?? true,\n        frequency: config?.checkpoints?.frequency || 5,\n        retentionDays: config?.checkpoints?.retentionDays || 7,\n      },\n    };\n\n    if (hooks) {\n      this.registerHooks(hooks);\n    }\n\n    this.setupEventHandlers();\n  }\n\n  /**\n   * Register lifecycle hooks\n   */\n  registerHooks(hooks: LifecycleHooks): void {\n    this.hooks = { ...this.hooks, ...hooks };\n    \n    logger.debug('Lifecycle hooks registered', {\n      registered: Object.keys(hooks),\n    });\n  }\n\n  /**\n   * Start iteration with lifecycle management\n   */\n  async startIteration(\n    iterationNumber: number,\n    context: IterationContext\n  ): Promise<IterationContext> {\n    logger.info('Starting iteration', { iteration: iterationNumber });\n\n    // Emit start event\n    this.emitEvent({\n      type: 'iteration.started',\n      timestamp: Date.now(),\n      iteration: iterationNumber,\n      data: { context },\n    });\n\n    // Execute pre-iteration hook if configured\n    let processedContext = context;\n    if (this.config.hooks.preIteration && this.hooks.preIteration) {\n      try {\n        processedContext = await this.hooks.preIteration(context);\n        logger.debug('Pre-iteration hook executed', {\n          original: context.tokenCount,\n          processed: processedContext.tokenCount,\n        });\n      } catch (error: any) {\n        await this.handleError(error, { phase: 'preIteration', context });\n      }\n    }\n\n    // Start iteration timer for metrics\n    this.startTimer(`iteration-${iterationNumber}`);\n\n    return processedContext;\n  }\n\n  /**\n   * Complete iteration with lifecycle management\n   */\n  async completeIteration(iteration: RalphIteration): Promise<void> {\n    logger.info('Completing iteration', { iteration: iteration.number });\n\n    this.currentIteration = iteration;\n\n    // Stop iteration timer\n    const duration = this.stopTimer(`iteration-${iteration.number}`);\n\n    // Execute post-iteration hook if configured\n    if (this.config.hooks.postIteration && this.hooks.postIteration) {\n      try {\n        await this.hooks.postIteration(iteration);\n        logger.debug('Post-iteration hook executed');\n      } catch (error: any) {\n        await this.handleError(error, { phase: 'postIteration', iteration });\n      }\n    }\n\n    // Create checkpoint if needed\n    if (this.shouldCreateCheckpoint(iteration.number)) {\n      await this.createCheckpoint(iteration);\n    }\n\n    // Emit completion event\n    this.emitEvent({\n      type: 'iteration.completed',\n      timestamp: Date.now(),\n      iteration: iteration.number,\n      data: {\n        iteration,\n        duration,\n        success: iteration.validation.testsPass,\n      },\n    });\n\n    // Clean old checkpoints\n    await this.cleanOldCheckpoints();\n  }\n\n  /**\n   * Handle iteration failure\n   */\n  async failIteration(\n    iterationNumber: number,\n    error: Error,\n    context?: any\n  ): Promise<void> {\n    logger.error('Iteration failed', {\n      iteration: iterationNumber,\n      error: error.message,\n    });\n\n    // Stop iteration timer\n    this.stopTimer(`iteration-${iterationNumber}`);\n\n    // Execute error hook if configured\n    if (this.config.hooks.onError && this.hooks.onError) {\n      try {\n        await this.hooks.onError(error, context);\n      } catch (hookError: any) {\n        logger.error('Error hook failed', { error: hookError.message });\n      }\n    }\n\n    // Emit failure event\n    this.emitEvent({\n      type: 'iteration.failed',\n      timestamp: Date.now(),\n      iteration: iterationNumber,\n      data: {\n        error: error.message,\n        stack: error.stack,\n        context,\n      },\n    });\n  }\n\n  /**\n   * Handle state change\n   */\n  async handleStateChange(\n    oldState: RalphLoopState,\n    newState: RalphLoopState\n  ): Promise<void> {\n    logger.debug('State change detected', {\n      old: oldState.status,\n      new: newState.status,\n      iteration: newState.iteration,\n    });\n\n    // Execute state change hook if configured\n    if (this.config.hooks.onStateChange && this.hooks.onStateChange) {\n      try {\n        await this.hooks.onStateChange(oldState, newState);\n      } catch (error: any) {\n        await this.handleError(error, {\n          phase: 'stateChange',\n          oldState,\n          newState,\n        });\n      }\n    }\n\n    // Emit state change event\n    this.emitEvent({\n      type: 'state.changed',\n      timestamp: Date.now(),\n      iteration: newState.iteration,\n      data: {\n        oldStatus: oldState.status,\n        newStatus: newState.status,\n        changes: this.detectStateChanges(oldState, newState),\n      },\n    });\n\n    // Check for completion\n    if (newState.status === 'completed' && oldState.status !== 'completed') {\n      await this.handleCompletion(newState);\n    }\n  }\n\n  /**\n   * Handle loop completion\n   */\n  async handleCompletion(state: RalphLoopState): Promise<void> {\n    logger.info('Loop completed', {\n      iterations: state.iteration,\n      duration: state.lastUpdateTime - state.startTime,\n    });\n\n    // Execute completion hook if configured\n    if (this.config.hooks.onComplete && this.hooks.onComplete) {\n      try {\n        await this.hooks.onComplete(state);\n      } catch (error: any) {\n        await this.handleError(error, { phase: 'completion', state });\n      }\n    }\n\n    // Create final checkpoint\n    await this.createFinalCheckpoint(state);\n\n    // Clean up timers\n    this.cleanupTimers();\n  }\n\n  /**\n   * Create checkpoint\n   */\n  async createCheckpoint(iteration: RalphIteration): Promise<Checkpoint> {\n    const checkpoint: Checkpoint = {\n      id: this.generateCheckpointId(),\n      iteration: iteration.number,\n      timestamp: Date.now(),\n      state: await this.captureCurrentState(),\n      gitCommit: await this.getCurrentGitCommit(),\n      verified: false,\n    };\n\n    // Verify checkpoint\n    checkpoint.verified = await this.verifyCheckpoint(checkpoint);\n\n    this.checkpoints.push(checkpoint);\n\n    logger.info('Checkpoint created', {\n      id: checkpoint.id,\n      iteration: checkpoint.iteration,\n      verified: checkpoint.verified,\n    });\n\n    // Execute checkpoint hook if available\n    if (this.hooks.onCheckpoint) {\n      try {\n        await this.hooks.onCheckpoint(checkpoint);\n      } catch (error: any) {\n        logger.error('Checkpoint hook failed', { error: error.message });\n      }\n    }\n\n    // Emit checkpoint event\n    this.emitEvent({\n      type: 'checkpoint.created',\n      timestamp: Date.now(),\n      iteration: iteration.number,\n      data: { checkpoint },\n    });\n\n    return checkpoint;\n  }\n\n  /**\n   * Get checkpoints\n   */\n  getCheckpoints(): Checkpoint[] {\n    return [...this.checkpoints];\n  }\n\n  /**\n   * Get last checkpoint\n   */\n  getLastCheckpoint(): Checkpoint | undefined {\n    return this.checkpoints[this.checkpoints.length - 1];\n  }\n\n  /**\n   * Restore from checkpoint\n   */\n  async restoreFromCheckpoint(checkpointId: string): Promise<void> {\n    const checkpoint = this.checkpoints.find(c => c.id === checkpointId);\n    \n    if (!checkpoint) {\n      throw new Error(`Checkpoint not found: ${checkpointId}`);\n    }\n\n    logger.info('Restoring from checkpoint', {\n      id: checkpoint.id,\n      iteration: checkpoint.iteration,\n    });\n\n    // Restore git state\n    if (checkpoint.gitCommit) {\n      await this.restoreGitState(checkpoint.gitCommit);\n    }\n\n    // Restore Ralph state\n    await this.restoreRalphState(checkpoint.state);\n\n    logger.info('Checkpoint restored successfully');\n  }\n\n  /**\n   * Get iteration events\n   */\n  getEvents(filter?: {\n    type?: IterationEventType;\n    iteration?: number;\n    since?: number;\n  }): IterationEvent[] {\n    let events = [...this.iterationHistory];\n\n    if (filter?.type) {\n      events = events.filter(e => e.type === filter.type);\n    }\n\n    if (filter?.iteration !== undefined) {\n      events = events.filter(e => e.iteration === filter.iteration);\n    }\n\n    if (filter?.since) {\n      events = events.filter(e => e.timestamp >= filter.since);\n    }\n\n    return events;\n  }\n\n  /**\n   * Clean up resources\n   */\n  cleanup(): void {\n    this.cleanupTimers();\n    this.removeAllListeners();\n    this.iterationHistory = [];\n    this.checkpoints = [];\n  }\n\n  /**\n   * Setup internal event handlers\n   */\n  private setupEventHandlers(): void {\n    // Log all events in debug mode\n    this.on('*', (event: IterationEvent) => {\n      logger.debug('Lifecycle event', {\n        type: event.type,\n        iteration: event.iteration,\n      });\n    });\n  }\n\n  /**\n   * Emit and track event\n   */\n  private emitEvent(event: IterationEvent): void {\n    this.iterationHistory.push(event);\n    this.emit(event.type, event);\n    this.emit('*', event); // Wildcard for all events\n  }\n\n  /**\n   * Should create checkpoint based on frequency\n   */\n  private shouldCreateCheckpoint(iteration: number): boolean {\n    if (!this.config.checkpoints.enabled) {\n      return false;\n    }\n\n    return iteration % this.config.checkpoints.frequency === 0;\n  }\n\n  /**\n   * Generate checkpoint ID\n   */\n  private generateCheckpointId(): string {\n    return `chk-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\n  }\n\n  /**\n   * Capture current state\n   */\n  private async captureCurrentState(): Promise<RalphLoopState> {\n    // This would capture the full Ralph loop state\n    // Placeholder implementation\n    return {\n      loopId: 'current',\n      task: '',\n      criteria: '',\n      iteration: this.currentIteration?.number || 0,\n      status: 'running',\n      startTime: Date.now(),\n      lastUpdateTime: Date.now(),\n    };\n  }\n\n  /**\n   * Get current git commit\n   */\n  private async getCurrentGitCommit(): Promise<string> {\n    try {\n      // execSync already imported at top\n      return execSync('git rev-parse HEAD', { encoding: 'utf8' }).trim();\n    } catch {\n      return '';\n    }\n  }\n\n  /**\n   * Verify checkpoint integrity\n   */\n  private async verifyCheckpoint(checkpoint: Checkpoint): Promise<boolean> {\n    try {\n      // Verify state consistency\n      if (!checkpoint.state.loopId || !checkpoint.state.task) {\n        return false;\n      }\n\n      // Verify git commit exists\n      if (checkpoint.gitCommit) {\n        // execSync already imported at top\n        execSync(`git rev-parse ${checkpoint.gitCommit}`, { encoding: 'utf8' });\n      }\n\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Clean old checkpoints based on retention\n   */\n  private async cleanOldCheckpoints(): Promise<void> {\n    const cutoff = Date.now() - this.config.checkpoints.retentionDays * 24 * 60 * 60 * 1000;\n    \n    const before = this.checkpoints.length;\n    this.checkpoints = this.checkpoints.filter(c => c.timestamp >= cutoff);\n    const removed = before - this.checkpoints.length;\n\n    if (removed > 0) {\n      logger.debug('Cleaned old checkpoints', { removed });\n    }\n  }\n\n  /**\n   * Create final checkpoint\n   */\n  private async createFinalCheckpoint(state: RalphLoopState): Promise<void> {\n    const checkpoint: Checkpoint = {\n      id: `final-${this.generateCheckpointId()}`,\n      iteration: state.iteration,\n      timestamp: Date.now(),\n      state,\n      gitCommit: await this.getCurrentGitCommit(),\n      verified: true,\n    };\n\n    this.checkpoints.push(checkpoint);\n    \n    logger.info('Final checkpoint created', {\n      id: checkpoint.id,\n      iterations: state.iteration,\n    });\n  }\n\n  /**\n   * Restore git state\n   */\n  private async restoreGitState(commit: string): Promise<void> {\n    // Stash any uncommitted changes\n    execSync('git stash', { encoding: 'utf8' });\n    \n    // Checkout the commit\n    execSync(`git checkout ${commit}`, { encoding: 'utf8' });\n  }\n\n  /**\n   * Restore Ralph state\n   */\n  private async restoreRalphState(state: RalphLoopState): Promise<void> {\n    // This would restore the Ralph loop state files\n    // Placeholder implementation\n    logger.debug('Ralph state restored', { iteration: state.iteration });\n  }\n\n  /**\n   * Detect state changes\n   */\n  private detectStateChanges(\n    oldState: RalphLoopState,\n    newState: RalphLoopState\n  ): string[] {\n    const changes: string[] = [];\n\n    for (const key of Object.keys(newState) as (keyof RalphLoopState)[]) {\n      if (JSON.stringify(oldState[key]) !== JSON.stringify(newState[key])) {\n        changes.push(key);\n      }\n    }\n\n    return changes;\n  }\n\n  /**\n   * Handle errors\n   */\n  private async handleError(error: Error, context: any): Promise<void> {\n    logger.error('Lifecycle error', {\n      error: error.message,\n      context,\n    });\n\n    if (this.config.hooks.onError && this.hooks.onError) {\n      try {\n        await this.hooks.onError(error, context);\n      } catch (hookError: any) {\n        logger.error('Error hook failed', { error: hookError.message });\n      }\n    }\n  }\n\n  /**\n   * Start timer for metrics\n   */\n  private startTimer(name: string): void {\n    const start = Date.now();\n    this.activeTimers.set(name, setTimeout(() => {\n      this.activeTimers.delete(name);\n    }, 0) as any);\n    (this.activeTimers.get(name) as any).startTime = start;\n  }\n\n  /**\n   * Stop timer and get duration\n   */\n  private stopTimer(name: string): number {\n    const timer = this.activeTimers.get(name);\n    if (!timer) return 0;\n\n    const duration = Date.now() - (timer as any).startTime;\n    clearTimeout(timer);\n    this.activeTimers.delete(name);\n\n    return duration;\n  }\n\n  /**\n   * Clean up all timers\n   */\n  private cleanupTimers(): void {\n    for (const timer of this.activeTimers.values()) {\n      clearTimeout(timer);\n    }\n    this.activeTimers.clear();\n  }\n}"],
+  "mappings": "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",
+  "names": []
+}