@stackmemoryai/stackmemory 0.5.58 → 0.5.59

package/dist/src/integrations/ralph/state/state-reconciler.js

@@ -0,0 +1,404 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import * as fs from "fs/promises";
+import * as path from "path";
+import { execSync } from "child_process";
+import { logger } from "../../../core/monitoring/logger.js";
+class StateReconciler {
+  config;
+  ralphDir = ".ralph";
+  reconciliationLog = [];
+  constructor(config) {
+    this.config = {
+      precedence: config?.precedence || ["git", "files", "memory"],
+      conflictResolution: config?.conflictResolution || "automatic",
+      syncInterval: config?.syncInterval || 5e3,
+      validateConsistency: config?.validateConsistency ?? true
+    };
+  }
+  /**
+   * Reconcile state from multiple sources
+   */
+  async reconcile(sources) {
+    logger.info("Reconciling state from sources", {
+      sources: sources.map((s) => ({ type: s.type, confidence: s.confidence }))
+    });
+    const sortedSources = this.sortByPrecedence(sources);
+    const conflicts = this.detectConflicts(sortedSources);
+    if (conflicts.length > 0) {
+      logger.warn("State conflicts detected", {
+        count: conflicts.length,
+        fields: conflicts.map((c) => c.field)
+      });
+      const resolutions = await this.resolveConflicts(conflicts);
+      return this.applyResolutions(sortedSources[0].state, resolutions);
+    }
+    return this.mergeStates(sortedSources);
+  }
+  /**
+   * Detect conflicts between state sources
+   */
+  detectConflicts(sources) {
+    const conflicts = [];
+    const fields = /* @__PURE__ */ new Set();
+    sources.forEach((source) => {
+      Object.keys(source.state).forEach((field) => fields.add(field));
+    });
+    for (const field of fields) {
+      const values = sources.filter((s) => s.state[field] !== void 0).map((s) => ({
+        source: s,
+        value: s.state[field]
+      }));
+      if (values.length > 1 && !this.valuesMatch(values.map((v) => v.value))) {
+        conflicts.push({
+          field,
+          sources: values.map((v) => v.source),
+          severity: this.assessConflictSeverity(field),
+          suggestedResolution: this.suggestResolution(field, values.map((v) => v.source))
+        });
+      }
+    }
+    return conflicts;
+  }
+  /**
+   * Resolve a single conflict
+   */
+  async resolveConflict(conflict) {
+    const resolution = await this.resolveConflictByStrategy(conflict);
+    this.reconciliationLog.push(resolution);
+    logger.debug("Conflict resolved", {
+      field: conflict.field,
+      resolution: resolution.source,
+      rationale: resolution.rationale
+    });
+    return resolution;
+  }
+  /**
+   * Validate state consistency
+   */
+  async validateConsistency(state) {
+    const errors = [];
+    const warnings = [];
+    try {
+      await this.validateFileSystemState(state, errors, warnings);
+      this.validateGitState(state, errors, warnings);
+      this.validateLogicalConsistency(state, errors, warnings);
+      return {
+        testsPass: errors.length === 0,
+        lintClean: true,
+        buildSuccess: true,
+        errors,
+        warnings
+      };
+    } catch (error) {
+      errors.push(`Validation failed: ${error.message}`);
+      return {
+        testsPass: false,
+        lintClean: false,
+        buildSuccess: false,
+        errors,
+        warnings
+      };
+    }
+  }
+  /**
+   * Get state from git
+   */
+  async getGitState() {
+    try {
+      const currentCommit = execSync("git rev-parse HEAD", { encoding: "utf8" }).trim();
+      const branch = execSync("git branch --show-current", { encoding: "utf8" }).trim();
+      const uncommittedChanges = execSync("git status --porcelain", { encoding: "utf8" });
+      const ralphCommits = execSync('git log --oneline --grep="Ralph iteration"', {
+        encoding: "utf8"
+      }).split("\n").filter(Boolean);
+      const lastRalphCommit = ralphCommits[0]?.split(" ")[0];
+      const iteration = ralphCommits.length;
+      return {
+        type: "git",
+        state: {
+          currentCommit,
+          startCommit: lastRalphCommit,
+          iteration,
+          status: uncommittedChanges ? "running" : "completed"
+        },
+        timestamp: Date.now(),
+        confidence: 0.9
+      };
+    } catch (error) {
+      logger.error("Failed to get git state", { error: error.message });
+      return {
+        type: "git",
+        state: {},
+        timestamp: Date.now(),
+        confidence: 0.1
+      };
+    }
+  }
+  /**
+   * Get state from file system
+   */
+  async getFileState() {
+    try {
+      const statePath = path.join(this.ralphDir, "state.json");
+      const iterationPath = path.join(this.ralphDir, "iteration.txt");
+      const feedbackPath = path.join(this.ralphDir, "feedback.txt");
+      const taskPath = path.join(this.ralphDir, "task.md");
+      const criteriaPath = path.join(this.ralphDir, "completion-criteria.md");
+      const [stateData, iteration, feedback, task, criteria] = await Promise.all([
+        fs.readFile(statePath, "utf8").catch(() => "{}"),
+        fs.readFile(iterationPath, "utf8").catch(() => "0"),
+        fs.readFile(feedbackPath, "utf8").catch(() => ""),
+        fs.readFile(taskPath, "utf8").catch(() => ""),
+        fs.readFile(criteriaPath, "utf8").catch(() => "")
+      ]);
+      const state = JSON.parse(stateData);
+      return {
+        type: "files",
+        state: {
+          ...state,
+          iteration: parseInt(iteration.trim()),
+          feedback: feedback.trim() || void 0,
+          task: task.trim(),
+          criteria: criteria.trim()
+        },
+        timestamp: Date.now(),
+        confidence: 0.95
+      };
+    } catch (error) {
+      logger.error("Failed to get file state", { error: error.message });
+      return {
+        type: "files",
+        state: {},
+        timestamp: Date.now(),
+        confidence: 0.1
+      };
+    }
+  }
+  /**
+   * Get state from memory (StackMemory)
+   */
+  async getMemoryState(loopId) {
+    try {
+      return {
+        type: "memory",
+        state: {
+          loopId,
+          lastUpdateTime: Date.now()
+        },
+        timestamp: Date.now(),
+        confidence: 0.8
+      };
+    } catch (error) {
+      logger.error("Failed to get memory state", { error: error.message });
+      return {
+        type: "memory",
+        state: {},
+        timestamp: Date.now(),
+        confidence: 0.1
+      };
+    }
+  }
+  /**
+   * Sort sources by configured precedence
+   */
+  sortByPrecedence(sources) {
+    return sources.sort((a, b) => {
+      const aIndex = this.config.precedence.indexOf(a.type);
+      const bIndex = this.config.precedence.indexOf(b.type);
+      if (aIndex === -1 && bIndex === -1) {
+        return b.confidence - a.confidence;
+      }
+      if (aIndex === -1) return 1;
+      if (bIndex === -1) return -1;
+      return aIndex - bIndex;
+    });
+  }
+  /**
+   * Check if values match
+   */
+  valuesMatch(values) {
+    if (values.length === 0) return true;
+    const first = JSON.stringify(values[0]);
+    return values.every((v) => JSON.stringify(v) === first);
+  }
+  /**
+   * Assess conflict severity
+   */
+  assessConflictSeverity(field) {
+    const highSeverityFields = ["loopId", "task", "criteria", "status"];
+    const mediumSeverityFields = ["iteration", "currentCommit", "feedback"];
+    if (highSeverityFields.includes(field)) return "high";
+    if (mediumSeverityFields.includes(field)) return "medium";
+    return "low";
+  }
+  /**
+   * Suggest resolution based on field and sources
+   */
+  suggestResolution(field, sources) {
+    const sorted = this.sortByPrecedence(sources);
+    const highestConfidence = sorted.reduce(
+      (max, s) => s.confidence > max.confidence ? s : max
+    );
+    return highestConfidence.state[field];
+  }
+  /**
+   * Resolve conflicts based on configured strategy
+   */
+  async resolveConflicts(conflicts) {
+    const resolutions = [];
+    for (const conflict of conflicts) {
+      const resolution = await this.resolveConflictByStrategy(conflict);
+      resolutions.push(resolution);
+    }
+    return resolutions;
+  }
+  /**
+   * Resolve conflict based on strategy
+   */
+  async resolveConflictByStrategy(conflict) {
+    switch (this.config.conflictResolution) {
+      case "automatic":
+        return this.automaticResolution(conflict);
+      case "manual":
+        return this.manualResolution(conflict);
+      case "interactive":
+        return this.interactiveResolution(conflict);
+      default:
+        return this.automaticResolution(conflict);
+    }
+  }
+  /**
+   * Automatic resolution based on precedence and confidence
+   */
+  automaticResolution(conflict) {
+    const sorted = this.sortByPrecedence(conflict.sources);
+    const winner = sorted[0];
+    return {
+      field: conflict.field,
+      value: winner.state[conflict.field],
+      source: winner.type,
+      rationale: `Automatic resolution: ${winner.type} has highest precedence (confidence: ${winner.confidence})`
+    };
+  }
+  /**
+   * Manual resolution (uses suggested resolution)
+   */
+  manualResolution(conflict) {
+    return {
+      field: conflict.field,
+      value: conflict.suggestedResolution,
+      source: "manual",
+      rationale: "Manual resolution: using suggested value"
+    };
+  }
+  /**
+   * Interactive resolution (would prompt user in real implementation)
+   */
+  async interactiveResolution(conflict) {
+    logger.info("Interactive resolution required", {
+      field: conflict.field,
+      options: conflict.sources.map((s) => ({
+        type: s.type,
+        value: s.state[conflict.field],
+        confidence: s.confidence
+      }))
+    });
+    return this.automaticResolution(conflict);
+  }
+  /**
+   * Apply resolutions to base state
+   */
+  applyResolutions(baseState, resolutions) {
+    const resolvedState = { ...baseState };
+    for (const resolution of resolutions) {
+      resolvedState[resolution.field] = resolution.value;
+    }
+    return resolvedState;
+  }
+  /**
+   * Merge states without conflicts
+   */
+  mergeStates(sources) {
+    const merged = {};
+    for (const source of sources) {
+      Object.assign(merged, source.state);
+    }
+    return merged;
+  }
+  /**
+   * Validate file system state
+   */
+  async validateFileSystemState(state, errors, warnings) {
+    try {
+      const ralphDirExists = await fs.stat(this.ralphDir).then(() => true).catch(() => false);
+      if (!ralphDirExists) {
+        warnings.push("Ralph directory does not exist");
+        return;
+      }
+      const requiredFiles = ["task.md", "state.json", "iteration.txt"];
+      for (const file of requiredFiles) {
+        const filePath = path.join(this.ralphDir, file);
+        const exists = await fs.stat(filePath).then(() => true).catch(() => false);
+        if (!exists) {
+          warnings.push(`Missing file: ${file}`);
+        }
+      }
+    } catch (error) {
+      errors.push(`File system validation failed: ${error.message}`);
+    }
+  }
+  /**
+   * Validate git state
+   */
+  validateGitState(state, errors, warnings) {
+    try {
+      const isGitRepo = execSync("git rev-parse --is-inside-work-tree", {
+        encoding: "utf8"
+      }).trim() === "true";
+      if (!isGitRepo) {
+        warnings.push("Not in a git repository");
+      }
+      if (state.currentCommit && state.startCommit) {
+        try {
+          execSync(`git rev-parse ${state.currentCommit}`, { encoding: "utf8" });
+        } catch {
+          errors.push(`Invalid current commit: ${state.currentCommit}`);
+        }
+        try {
+          execSync(`git rev-parse ${state.startCommit}`, { encoding: "utf8" });
+        } catch {
+          warnings.push(`Invalid start commit: ${state.startCommit}`);
+        }
+      }
+    } catch (error) {
+      warnings.push(`Git validation failed: ${error.message}`);
+    }
+  }
+  /**
+   * Validate logical consistency
+   */
+  validateLogicalConsistency(state, errors, warnings) {
+    if (state.iteration < 0) {
+      errors.push("Invalid iteration number: cannot be negative");
+    }
+    if (state.status === "completed" && !state.completionData) {
+      warnings.push("Status is completed but no completion data");
+    }
+    if (state.lastUpdateTime && state.startTime && state.lastUpdateTime < state.startTime) {
+      errors.push("Last update time is before start time");
+    }
+    if (!state.task) {
+      errors.push("No task defined");
+    }
+    if (!state.criteria) {
+      warnings.push("No completion criteria defined");
+    }
+  }
+}
+export {
+  StateReconciler
+};
+//# sourceMappingURL=state-reconciler.js.map

package/dist/src/integrations/ralph/state/state-reconciler.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/integrations/ralph/state/state-reconciler.ts"],
+  "sourcesContent": ["/**\n * State Reconciler for Ralph-StackMemory Integration\n * Handles conflict resolution and state consistency across git, files, and memory\n */\n\nimport * as fs from 'fs/promises';\nimport * as path from 'path';\nimport { execSync } from 'child_process';\nimport { logger } from '../../../core/monitoring/logger.js';\nimport {\n  RalphLoopState,\n  StateSource,\n  Conflict,\n  Resolution,\n  ValidationResult,\n  RalphStackMemoryConfig,\n} from '../types.js';\n\nexport class StateReconciler {\n  private config: RalphStackMemoryConfig['stateReconciliation'];\n  private readonly ralphDir = '.ralph';\n  private reconciliationLog: Resolution[] = [];\n\n  constructor(config?: Partial<RalphStackMemoryConfig['stateReconciliation']>) {\n    this.config = {\n      precedence: config?.precedence || ['git', 'files', 'memory'],\n      conflictResolution: config?.conflictResolution || 'automatic',\n      syncInterval: config?.syncInterval || 5000,\n      validateConsistency: config?.validateConsistency ?? true,\n    };\n  }\n\n  /**\n   * Reconcile state from multiple sources\n   */\n  async reconcile(sources: StateSource[]): Promise<RalphLoopState> {\n    logger.info('Reconciling state from sources', {\n      sources: sources.map(s => ({ type: s.type, confidence: s.confidence })),\n    });\n\n    // Sort sources by precedence\n    const sortedSources = this.sortByPrecedence(sources);\n    \n    // Detect conflicts\n    const conflicts = this.detectConflicts(sortedSources);\n    \n    if (conflicts.length > 0) {\n      logger.warn('State conflicts detected', {\n        count: conflicts.length,\n        fields: conflicts.map(c => c.field),\n      });\n\n      // Resolve conflicts based on configuration\n      const resolutions = await this.resolveConflicts(conflicts);\n      return this.applyResolutions(sortedSources[0].state as RalphLoopState, resolutions);\n    }\n\n    // No conflicts, merge states\n    return this.mergeStates(sortedSources);\n  }\n\n  /**\n   * Detect conflicts between state sources\n   */\n  detectConflicts(sources: StateSource[]): Conflict[] {\n    const conflicts: Conflict[] = [];\n    const fields = new Set<string>();\n\n    // Collect all fields across sources\n    sources.forEach(source => {\n      Object.keys(source.state).forEach(field => fields.add(field));\n    });\n\n    // Check each field for conflicts\n    for (const field of fields) {\n      const values = sources\n        .filter(s => s.state[field as keyof RalphLoopState] !== undefined)\n        .map(s => ({\n          source: s,\n          value: s.state[field as keyof RalphLoopState],\n        }));\n\n      if (values.length > 1 && !this.valuesMatch(values.map(v => v.value))) {\n        conflicts.push({\n          field,\n          sources: values.map(v => v.source),\n          severity: this.assessConflictSeverity(field),\n          suggestedResolution: this.suggestResolution(field, values.map(v => v.source)),\n        });\n      }\n    }\n\n    return conflicts;\n  }\n\n  /**\n   * Resolve a single conflict\n   */\n  async resolveConflict(conflict: Conflict): Promise<Resolution> {\n    const resolution = await this.resolveConflictByStrategy(conflict);\n    \n    this.reconciliationLog.push(resolution);\n    \n    logger.debug('Conflict resolved', {\n      field: conflict.field,\n      resolution: resolution.source,\n      rationale: resolution.rationale,\n    });\n\n    return resolution;\n  }\n\n  /**\n   * Validate state consistency\n   */\n  async validateConsistency(state: RalphLoopState): Promise<ValidationResult> {\n    const errors: string[] = [];\n    const warnings: string[] = [];\n\n    try {\n      // Validate file system state\n      await this.validateFileSystemState(state, errors, warnings);\n      \n      // Validate git state\n      this.validateGitState(state, errors, warnings);\n      \n      // Validate logical consistency\n      this.validateLogicalConsistency(state, errors, warnings);\n\n      return {\n        testsPass: errors.length === 0,\n        lintClean: true,\n        buildSuccess: true,\n        errors,\n        warnings,\n      };\n    } catch (error: any) {\n      errors.push(`Validation failed: ${error.message}`);\n      return {\n        testsPass: false,\n        lintClean: false,\n        buildSuccess: false,\n        errors,\n        warnings,\n      };\n    }\n  }\n\n  /**\n   * Get state from git\n   */\n  async getGitState(): Promise<StateSource> {\n    try {\n      const currentCommit = execSync('git rev-parse HEAD', { encoding: 'utf8' }).trim();\n      const branch = execSync('git branch --show-current', { encoding: 'utf8' }).trim();\n      const uncommittedChanges = execSync('git status --porcelain', { encoding: 'utf8' });\n      \n      // Check for Ralph commits\n      const ralphCommits = execSync('git log --oneline --grep=\"Ralph iteration\"', {\n        encoding: 'utf8',\n      }).split('\\n').filter(Boolean);\n\n      const lastRalphCommit = ralphCommits[0]?.split(' ')[0];\n      const iteration = ralphCommits.length;\n\n      return {\n        type: 'git',\n        state: {\n          currentCommit,\n          startCommit: lastRalphCommit,\n          iteration,\n          status: uncommittedChanges ? 'running' : 'completed',\n        },\n        timestamp: Date.now(),\n        confidence: 0.9,\n      };\n    } catch (error: any) {\n      logger.error('Failed to get git state', { error: error.message });\n      return {\n        type: 'git',\n        state: {},\n        timestamp: Date.now(),\n        confidence: 0.1,\n      };\n    }\n  }\n\n  /**\n   * Get state from file system\n   */\n  async getFileState(): Promise<StateSource> {\n    try {\n      const statePath = path.join(this.ralphDir, 'state.json');\n      const iterationPath = path.join(this.ralphDir, 'iteration.txt');\n      const feedbackPath = path.join(this.ralphDir, 'feedback.txt');\n      const taskPath = path.join(this.ralphDir, 'task.md');\n      const criteriaPath = path.join(this.ralphDir, 'completion-criteria.md');\n\n      const [stateData, iteration, feedback, task, criteria] = await Promise.all([\n        fs.readFile(statePath, 'utf8').catch(() => '{}'),\n        fs.readFile(iterationPath, 'utf8').catch(() => '0'),\n        fs.readFile(feedbackPath, 'utf8').catch(() => ''),\n        fs.readFile(taskPath, 'utf8').catch(() => ''),\n        fs.readFile(criteriaPath, 'utf8').catch(() => ''),\n      ]);\n\n      const state = JSON.parse(stateData);\n\n      return {\n        type: 'files',\n        state: {\n          ...state,\n          iteration: parseInt(iteration.trim()),\n          feedback: feedback.trim() || undefined,\n          task: task.trim(),\n          criteria: criteria.trim(),\n        },\n        timestamp: Date.now(),\n        confidence: 0.95,\n      };\n    } catch (error: any) {\n      logger.error('Failed to get file state', { error: error.message });\n      return {\n        type: 'files',\n        state: {},\n        timestamp: Date.now(),\n        confidence: 0.1,\n      };\n    }\n  }\n\n  /**\n   * Get state from memory (StackMemory)\n   */\n  async getMemoryState(loopId: string): Promise<StateSource> {\n    try {\n      // This would integrate with StackMemory's frame system\n      // For now, returning a placeholder\n      return {\n        type: 'memory',\n        state: {\n          loopId,\n          lastUpdateTime: Date.now(),\n        },\n        timestamp: Date.now(),\n        confidence: 0.8,\n      };\n    } catch (error: any) {\n      logger.error('Failed to get memory state', { error: error.message });\n      return {\n        type: 'memory',\n        state: {},\n        timestamp: Date.now(),\n        confidence: 0.1,\n      };\n    }\n  }\n\n  /**\n   * Sort sources by configured precedence\n   */\n  private sortByPrecedence(sources: StateSource[]): StateSource[] {\n    return sources.sort((a, b) => {\n      const aIndex = this.config.precedence.indexOf(a.type);\n      const bIndex = this.config.precedence.indexOf(b.type);\n      \n      if (aIndex === -1 && bIndex === -1) {\n        return b.confidence - a.confidence;\n      }\n      if (aIndex === -1) return 1;\n      if (bIndex === -1) return -1;\n      \n      return aIndex - bIndex;\n    });\n  }\n\n  /**\n   * Check if values match\n   */\n  private valuesMatch(values: any[]): boolean {\n    if (values.length === 0) return true;\n    const first = JSON.stringify(values[0]);\n    return values.every(v => JSON.stringify(v) === first);\n  }\n\n  /**\n   * Assess conflict severity\n   */\n  private assessConflictSeverity(field: string): 'low' | 'medium' | 'high' {\n    const highSeverityFields = ['loopId', 'task', 'criteria', 'status'];\n    const mediumSeverityFields = ['iteration', 'currentCommit', 'feedback'];\n    \n    if (highSeverityFields.includes(field)) return 'high';\n    if (mediumSeverityFields.includes(field)) return 'medium';\n    return 'low';\n  }\n\n  /**\n   * Suggest resolution based on field and sources\n   */\n  private suggestResolution(field: string, sources: StateSource[]): any {\n    // Sort by confidence and precedence\n    const sorted = this.sortByPrecedence(sources);\n    const highestConfidence = sorted.reduce((max, s) => \n      s.confidence > max.confidence ? s : max\n    );\n    \n    return highestConfidence.state[field as keyof RalphLoopState];\n  }\n\n  /**\n   * Resolve conflicts based on configured strategy\n   */\n  private async resolveConflicts(conflicts: Conflict[]): Promise<Resolution[]> {\n    const resolutions: Resolution[] = [];\n\n    for (const conflict of conflicts) {\n      const resolution = await this.resolveConflictByStrategy(conflict);\n      resolutions.push(resolution);\n    }\n\n    return resolutions;\n  }\n\n  /**\n   * Resolve conflict based on strategy\n   */\n  private async resolveConflictByStrategy(conflict: Conflict): Promise<Resolution> {\n    switch (this.config.conflictResolution) {\n      case 'automatic':\n        return this.automaticResolution(conflict);\n      \n      case 'manual':\n        return this.manualResolution(conflict);\n      \n      case 'interactive':\n        return this.interactiveResolution(conflict);\n      \n      default:\n        return this.automaticResolution(conflict);\n    }\n  }\n\n  /**\n   * Automatic resolution based on precedence and confidence\n   */\n  private automaticResolution(conflict: Conflict): Resolution {\n    const sorted = this.sortByPrecedence(conflict.sources);\n    const winner = sorted[0];\n    \n    return {\n      field: conflict.field,\n      value: winner.state[conflict.field as keyof RalphLoopState],\n      source: winner.type,\n      rationale: `Automatic resolution: ${winner.type} has highest precedence (confidence: ${winner.confidence})`,\n    };\n  }\n\n  /**\n   * Manual resolution (uses suggested resolution)\n   */\n  private manualResolution(conflict: Conflict): Resolution {\n    return {\n      field: conflict.field,\n      value: conflict.suggestedResolution,\n      source: 'manual',\n      rationale: 'Manual resolution: using suggested value',\n    };\n  }\n\n  /**\n   * Interactive resolution (would prompt user in real implementation)\n   */\n  private async interactiveResolution(conflict: Conflict): Promise<Resolution> {\n    // In real implementation, this would prompt the user\n    logger.info('Interactive resolution required', {\n      field: conflict.field,\n      options: conflict.sources.map(s => ({\n        type: s.type,\n        value: s.state[conflict.field as keyof RalphLoopState],\n        confidence: s.confidence,\n      })),\n    });\n\n    // For now, fallback to automatic\n    return this.automaticResolution(conflict);\n  }\n\n  /**\n   * Apply resolutions to base state\n   */\n  private applyResolutions(\n    baseState: RalphLoopState,\n    resolutions: Resolution[]\n  ): RalphLoopState {\n    const resolvedState = { ...baseState };\n\n    for (const resolution of resolutions) {\n      (resolvedState as any)[resolution.field] = resolution.value;\n    }\n\n    return resolvedState;\n  }\n\n  /**\n   * Merge states without conflicts\n   */\n  private mergeStates(sources: StateSource[]): RalphLoopState {\n    const merged: any = {};\n\n    // Apply in precedence order\n    for (const source of sources) {\n      Object.assign(merged, source.state);\n    }\n\n    return merged as RalphLoopState;\n  }\n\n  /**\n   * Validate file system state\n   */\n  private async validateFileSystemState(\n    state: RalphLoopState,\n    errors: string[],\n    warnings: string[]\n  ): Promise<void> {\n    try {\n      const ralphDirExists = await fs.stat(this.ralphDir).then(() => true).catch(() => false);\n      \n      if (!ralphDirExists) {\n        warnings.push('Ralph directory does not exist');\n        return;\n      }\n\n      const requiredFiles = ['task.md', 'state.json', 'iteration.txt'];\n      for (const file of requiredFiles) {\n        const filePath = path.join(this.ralphDir, file);\n        const exists = await fs.stat(filePath).then(() => true).catch(() => false);\n        \n        if (!exists) {\n          warnings.push(`Missing file: ${file}`);\n        }\n      }\n    } catch (error: any) {\n      errors.push(`File system validation failed: ${error.message}`);\n    }\n  }\n\n  /**\n   * Validate git state\n   */\n  private validateGitState(\n    state: RalphLoopState,\n    errors: string[],\n    warnings: string[]\n  ): void {\n    try {\n      const isGitRepo = execSync('git rev-parse --is-inside-work-tree', {\n        encoding: 'utf8',\n      }).trim() === 'true';\n      \n      if (!isGitRepo) {\n        warnings.push('Not in a git repository');\n      }\n\n      if (state.currentCommit && state.startCommit) {\n        try {\n          execSync(`git rev-parse ${state.currentCommit}`, { encoding: 'utf8' });\n        } catch {\n          errors.push(`Invalid current commit: ${state.currentCommit}`);\n        }\n\n        try {\n          execSync(`git rev-parse ${state.startCommit}`, { encoding: 'utf8' });\n        } catch {\n          warnings.push(`Invalid start commit: ${state.startCommit}`);\n        }\n      }\n    } catch (error: any) {\n      warnings.push(`Git validation failed: ${error.message}`);\n    }\n  }\n\n  /**\n   * Validate logical consistency\n   */\n  private validateLogicalConsistency(\n    state: RalphLoopState,\n    errors: string[],\n    warnings: string[]\n  ): void {\n    // Check iteration number\n    if (state.iteration < 0) {\n      errors.push('Invalid iteration number: cannot be negative');\n    }\n\n    // Check status consistency\n    if (state.status === 'completed' && !state.completionData) {\n      warnings.push('Status is completed but no completion data');\n    }\n\n    // Check time consistency\n    if (state.lastUpdateTime && state.startTime && state.lastUpdateTime < state.startTime) {\n      errors.push('Last update time is before start time');\n    }\n\n    // Check task and criteria\n    if (!state.task) {\n      errors.push('No task defined');\n    }\n\n    if (!state.criteria) {\n      warnings.push('No completion criteria defined');\n    }\n  }\n}"],
+  "mappings": ";;;;AAKA,YAAY,QAAQ;AACpB,YAAY,UAAU;AACtB,SAAS,gBAAgB;AACzB,SAAS,cAAc;AAUhB,MAAM,gBAAgB;AAAA,EACnB;AAAA,EACS,WAAW;AAAA,EACpB,oBAAkC,CAAC;AAAA,EAE3C,YAAY,QAAiE;AAC3E,SAAK,SAAS;AAAA,MACZ,YAAY,QAAQ,cAAc,CAAC,OAAO,SAAS,QAAQ;AAAA,MAC3D,oBAAoB,QAAQ,sBAAsB;AAAA,MAClD,cAAc,QAAQ,gBAAgB;AAAA,MACtC,qBAAqB,QAAQ,uBAAuB;AAAA,IACtD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,UAAU,SAAiD;AAC/D,WAAO,KAAK,kCAAkC;AAAA,MAC5C,SAAS,QAAQ,IAAI,QAAM,EAAE,MAAM,EAAE,MAAM,YAAY,EAAE,WAAW,EAAE;AAAA,IACxE,CAAC;AAGD,UAAM,gBAAgB,KAAK,iBAAiB,OAAO;AAGnD,UAAM,YAAY,KAAK,gBAAgB,aAAa;AAEpD,QAAI,UAAU,SAAS,GAAG;AACxB,aAAO,KAAK,4BAA4B;AAAA,QACtC,OAAO,UAAU;AAAA,QACjB,QAAQ,UAAU,IAAI,OAAK,EAAE,KAAK;AAAA,MACpC,CAAC;AAGD,YAAM,cAAc,MAAM,KAAK,iBAAiB,SAAS;AACzD,aAAO,KAAK,iBAAiB,cAAc,CAAC,EAAE,OAAyB,WAAW;AAAA,IACpF;AAGA,WAAO,KAAK,YAAY,aAAa;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAgB,SAAoC;AAClD,UAAM,YAAwB,CAAC;AAC/B,UAAM,SAAS,oBAAI,IAAY;AAG/B,YAAQ,QAAQ,YAAU;AACxB,aAAO,KAAK,OAAO,KAAK,EAAE,QAAQ,WAAS,OAAO,IAAI,KAAK,CAAC;AAAA,IAC9D,CAAC;AAGD,eAAW,SAAS,QAAQ;AAC1B,YAAM,SAAS,QACZ,OAAO,OAAK,EAAE,MAAM,KAA6B,MAAM,MAAS,EAChE,IAAI,QAAM;AAAA,QACT,QAAQ;AAAA,QACR,OAAO,EAAE,MAAM,KAA6B;AAAA,MAC9C,EAAE;AAEJ,UAAI,OAAO,SAAS,KAAK,CAAC,KAAK,YAAY,OAAO,IAAI,OAAK,EAAE,KAAK,CAAC,GAAG;AACpE,kBAAU,KAAK;AAAA,UACb;AAAA,UACA,SAAS,OAAO,IAAI,OAAK,EAAE,MAAM;AAAA,UACjC,UAAU,KAAK,uBAAuB,KAAK;AAAA,UAC3C,qBAAqB,KAAK,kBAAkB,OAAO,OAAO,IAAI,OAAK,EAAE,MAAM,CAAC;AAAA,QAC9E,CAAC;AAAA,MACH;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,gBAAgB,UAAyC;AAC7D,UAAM,aAAa,MAAM,KAAK,0BAA0B,QAAQ;AAEhE,SAAK,kBAAkB,KAAK,UAAU;AAEtC,WAAO,MAAM,qBAAqB;AAAA,MAChC,OAAO,SAAS;AAAA,MAChB,YAAY,WAAW;AAAA,MACvB,WAAW,WAAW;AAAA,IACxB,CAAC;AAED,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,oBAAoB,OAAkD;AAC1E,UAAM,SAAmB,CAAC;AAC1B,UAAM,WAAqB,CAAC;AAE5B,QAAI;AAEF,YAAM,KAAK,wBAAwB,OAAO,QAAQ,QAAQ;AAG1D,WAAK,iBAAiB,OAAO,QAAQ,QAAQ;AAG7C,WAAK,2BAA2B,OAAO,QAAQ,QAAQ;AAEvD,aAAO;AAAA,QACL,WAAW,OAAO,WAAW;AAAA,QAC7B,WAAW;AAAA,QACX,cAAc;AAAA,QACd;AAAA,QACA;AAAA,MACF;AAAA,IACF,SAAS,OAAY;AACnB,aAAO,KAAK,sBAAsB,MAAM,OAAO,EAAE;AACjD,aAAO;AAAA,QACL,WAAW;AAAA,QACX,WAAW;AAAA,QACX,cAAc;AAAA,QACd;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,cAAoC;AACxC,QAAI;AACF,YAAM,gBAAgB,SAAS,sBAAsB,EAAE,UAAU,OAAO,CAAC,EAAE,KAAK;AAChF,YAAM,SAAS,SAAS,6BAA6B,EAAE,UAAU,OAAO,CAAC,EAAE,KAAK;AAChF,YAAM,qBAAqB,SAAS,0BAA0B,EAAE,UAAU,OAAO,CAAC;AAGlF,YAAM,eAAe,SAAS,8CAA8C;AAAA,QAC1E,UAAU;AAAA,MACZ,CAAC,EAAE,MAAM,IAAI,EAAE,OAAO,OAAO;AAE7B,YAAM,kBAAkB,aAAa,CAAC,GAAG,MAAM,GAAG,EAAE,CAAC;AACrD,YAAM,YAAY,aAAa;AAE/B,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO;AAAA,UACL;AAAA,UACA,aAAa;AAAA,UACb;AAAA,UACA,QAAQ,qBAAqB,YAAY;AAAA,QAC3C;AAAA,QACA,WAAW,KAAK,IAAI;AAAA,QACpB,YAAY;AAAA,MACd;AAAA,IACF,SAAS,OAAY;AACnB,aAAO,MAAM,2BAA2B,EAAE,OAAO,MAAM,QAAQ,CAAC;AAChE,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,CAAC;AAAA,QACR,WAAW,KAAK,IAAI;AAAA,QACpB,YAAY;AAAA,MACd;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eAAqC;AACzC,QAAI;AACF,YAAM,YAAY,KAAK,KAAK,KAAK,UAAU,YAAY;AACvD,YAAM,gBAAgB,KAAK,KAAK,KAAK,UAAU,eAAe;AAC9D,YAAM,eAAe,KAAK,KAAK,KAAK,UAAU,cAAc;AAC5D,YAAM,WAAW,KAAK,KAAK,KAAK,UAAU,SAAS;AACnD,YAAM,eAAe,KAAK,KAAK,KAAK,UAAU,wBAAwB;AAEtE,YAAM,CAAC,WAAW,WAAW,UAAU,MAAM,QAAQ,IAAI,MAAM,QAAQ,IAAI;AAAA,QACzE,GAAG,SAAS,WAAW,MAAM,EAAE,MAAM,MAAM,IAAI;AAAA,QAC/C,GAAG,SAAS,eAAe,MAAM,EAAE,MAAM,MAAM,GAAG;AAAA,QAClD,GAAG,SAAS,cAAc,MAAM,EAAE,MAAM,MAAM,EAAE;AAAA,QAChD,GAAG,SAAS,UAAU,MAAM,EAAE,MAAM,MAAM,EAAE;AAAA,QAC5C,GAAG,SAAS,cAAc,MAAM,EAAE,MAAM,MAAM,EAAE;AAAA,MAClD,CAAC;AAED,YAAM,QAAQ,KAAK,MAAM,SAAS;AAElC,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO;AAAA,UACL,GAAG;AAAA,UACH,WAAW,SAAS,UAAU,KAAK,CAAC;AAAA,UACpC,UAAU,SAAS,KAAK,KAAK;AAAA,UAC7B,MAAM,KAAK,KAAK;AAAA,UAChB,UAAU,SAAS,KAAK;AAAA,QAC1B;AAAA,QACA,WAAW,KAAK,IAAI;AAAA,QACpB,YAAY;AAAA,MACd;AAAA,IACF,SAAS,OAAY;AACnB,aAAO,MAAM,4BAA4B,EAAE,OAAO,MAAM,QAAQ,CAAC;AACjE,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,CAAC;AAAA,QACR,WAAW,KAAK,IAAI;AAAA,QACpB,YAAY;AAAA,MACd;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eAAe,QAAsC;AACzD,QAAI;AAGF,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO;AAAA,UACL;AAAA,UACA,gBAAgB,KAAK,IAAI;AAAA,QAC3B;AAAA,QACA,WAAW,KAAK,IAAI;AAAA,QACpB,YAAY;AAAA,MACd;AAAA,IACF,SAAS,OAAY;AACnB,aAAO,MAAM,8BAA8B,EAAE,OAAO,MAAM,QAAQ,CAAC;AACnE,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO,CAAC;AAAA,QACR,WAAW,KAAK,IAAI;AAAA,QACpB,YAAY;AAAA,MACd;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,iBAAiB,SAAuC;AAC9D,WAAO,QAAQ,KAAK,CAAC,GAAG,MAAM;AAC5B,YAAM,SAAS,KAAK,OAAO,WAAW,QAAQ,EAAE,IAAI;AACpD,YAAM,SAAS,KAAK,OAAO,WAAW,QAAQ,EAAE,IAAI;AAEpD,UAAI,WAAW,MAAM,WAAW,IAAI;AAClC,eAAO,EAAE,aAAa,EAAE;AAAA,MAC1B;AACA,UAAI,WAAW,GAAI,QAAO;AAC1B,UAAI,WAAW,GAAI,QAAO;AAE1B,aAAO,SAAS;AAAA,IAClB,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKQ,YAAY,QAAwB;AAC1C,QAAI,OAAO,WAAW,EAAG,QAAO;AAChC,UAAM,QAAQ,KAAK,UAAU,OAAO,CAAC,CAAC;AACtC,WAAO,OAAO,MAAM,OAAK,KAAK,UAAU,CAAC,MAAM,KAAK;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA,EAKQ,uBAAuB,OAA0C;AACvE,UAAM,qBAAqB,CAAC,UAAU,QAAQ,YAAY,QAAQ;AAClE,UAAM,uBAAuB,CAAC,aAAa,iBAAiB,UAAU;AAEtE,QAAI,mBAAmB,SAAS,KAAK,EAAG,QAAO;AAC/C,QAAI,qBAAqB,SAAS,KAAK,EAAG,QAAO;AACjD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKQ,kBAAkB,OAAe,SAA6B;AAEpE,UAAM,SAAS,KAAK,iBAAiB,OAAO;AAC5C,UAAM,oBAAoB,OAAO;AAAA,MAAO,CAAC,KAAK,MAC5C,EAAE,aAAa,IAAI,aAAa,IAAI;AAAA,IACtC;AAEA,WAAO,kBAAkB,MAAM,KAA6B;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,iBAAiB,WAA8C;AAC3E,UAAM,cAA4B,CAAC;AAEnC,eAAW,YAAY,WAAW;AAChC,YAAM,aAAa,MAAM,KAAK,0BAA0B,QAAQ;AAChE,kBAAY,KAAK,UAAU;AAAA,IAC7B;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,0BAA0B,UAAyC;AAC/E,YAAQ,KAAK,OAAO,oBAAoB;AAAA,MACtC,KAAK;AACH,eAAO,KAAK,oBAAoB,QAAQ;AAAA,MAE1C,KAAK;AACH,eAAO,KAAK,iBAAiB,QAAQ;AAAA,MAEvC,KAAK;AACH,eAAO,KAAK,sBAAsB,QAAQ;AAAA,MAE5C;AACE,eAAO,KAAK,oBAAoB,QAAQ;AAAA,IAC5C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,oBAAoB,UAAgC;AAC1D,UAAM,SAAS,KAAK,iBAAiB,SAAS,OAAO;AACrD,UAAM,SAAS,OAAO,CAAC;AAEvB,WAAO;AAAA,MACL,OAAO,SAAS;AAAA,MAChB,OAAO,OAAO,MAAM,SAAS,KAA6B;AAAA,MAC1D,QAAQ,OAAO;AAAA,MACf,WAAW,yBAAyB,OAAO,IAAI,wCAAwC,OAAO,UAAU;AAAA,IAC1G;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,iBAAiB,UAAgC;AACvD,WAAO;AAAA,MACL,OAAO,SAAS;AAAA,MAChB,OAAO,SAAS;AAAA,MAChB,QAAQ;AAAA,MACR,WAAW;AAAA,IACb;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,sBAAsB,UAAyC;AAE3E,WAAO,KAAK,mCAAmC;AAAA,MAC7C,OAAO,SAAS;AAAA,MAChB,SAAS,SAAS,QAAQ,IAAI,QAAM;AAAA,QAClC,MAAM,EAAE;AAAA,QACR,OAAO,EAAE,MAAM,SAAS,KAA6B;AAAA,QACrD,YAAY,EAAE;AAAA,MAChB,EAAE;AAAA,IACJ,CAAC;AAGD,WAAO,KAAK,oBAAoB,QAAQ;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA,EAKQ,iBACN,WACA,aACgB;AAChB,UAAM,gBAAgB,EAAE,GAAG,UAAU;AAErC,eAAW,cAAc,aAAa;AACpC,MAAC,cAAsB,WAAW,KAAK,IAAI,WAAW;AAAA,IACxD;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKQ,YAAY,SAAwC;AAC1D,UAAM,SAAc,CAAC;AAGrB,eAAW,UAAU,SAAS;AAC5B,aAAO,OAAO,QAAQ,OAAO,KAAK;AAAA,IACpC;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,wBACZ,OACA,QACA,UACe;AACf,QAAI;AACF,YAAM,iBAAiB,MAAM,GAAG,KAAK,KAAK,QAAQ,EAAE,KAAK,MAAM,IAAI,EAAE,MAAM,MAAM,KAAK;AAEtF,UAAI,CAAC,gBAAgB;AACnB,iBAAS,KAAK,gCAAgC;AAC9C;AAAA,MACF;AAEA,YAAM,gBAAgB,CAAC,WAAW,cAAc,eAAe;AAC/D,iBAAW,QAAQ,eAAe;AAChC,cAAM,WAAW,KAAK,KAAK,KAAK,UAAU,IAAI;AAC9C,cAAM,SAAS,MAAM,GAAG,KAAK,QAAQ,EAAE,KAAK,MAAM,IAAI,EAAE,MAAM,MAAM,KAAK;AAEzE,YAAI,CAAC,QAAQ;AACX,mBAAS,KAAK,iBAAiB,IAAI,EAAE;AAAA,QACvC;AAAA,MACF;AAAA,IACF,SAAS,OAAY;AACnB,aAAO,KAAK,kCAAkC,MAAM,OAAO,EAAE;AAAA,IAC/D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,iBACN,OACA,QACA,UACM;AACN,QAAI;AACF,YAAM,YAAY,SAAS,uCAAuC;AAAA,QAChE,UAAU;AAAA,MACZ,CAAC,EAAE,KAAK,MAAM;AAEd,UAAI,CAAC,WAAW;AACd,iBAAS,KAAK,yBAAyB;AAAA,MACzC;AAEA,UAAI,MAAM,iBAAiB,MAAM,aAAa;AAC5C,YAAI;AACF,mBAAS,iBAAiB,MAAM,aAAa,IAAI,EAAE,UAAU,OAAO,CAAC;AAAA,QACvE,QAAQ;AACN,iBAAO,KAAK,2BAA2B,MAAM,aAAa,EAAE;AAAA,QAC9D;AAEA,YAAI;AACF,mBAAS,iBAAiB,MAAM,WAAW,IAAI,EAAE,UAAU,OAAO,CAAC;AAAA,QACrE,QAAQ;AACN,mBAAS,KAAK,yBAAyB,MAAM,WAAW,EAAE;AAAA,QAC5D;AAAA,MACF;AAAA,IACF,SAAS,OAAY;AACnB,eAAS,KAAK,0BAA0B,MAAM,OAAO,EAAE;AAAA,IACzD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,2BACN,OACA,QACA,UACM;AAEN,QAAI,MAAM,YAAY,GAAG;AACvB,aAAO,KAAK,8CAA8C;AAAA,IAC5D;AAGA,QAAI,MAAM,WAAW,eAAe,CAAC,MAAM,gBAAgB;AACzD,eAAS,KAAK,4CAA4C;AAAA,IAC5D;AAGA,QAAI,MAAM,kBAAkB,MAAM,aAAa,MAAM,iBAAiB,MAAM,WAAW;AACrF,aAAO,KAAK,uCAAuC;AAAA,IACrD;AAGA,QAAI,CAAC,MAAM,MAAM;AACf,aAAO,KAAK,iBAAiB;AAAA,IAC/B;AAEA,QAAI,CAAC,MAAM,UAAU;AACnB,eAAS,KAAK,gCAAgC;AAAA,IAChD;AAAA,EACF;AACF;",
+  "names": []
+}