@stackmemoryai/stackmemory/scripts/test-simple-ralph-state-sync.ts

Project-scoped memory for AI coding tools. Durable context across sessions with MCP integration, frames, smart retrieval, Claude Code skills, and automatic hooks.

#!/usr/bin/env npx tsx

/**
 * Simple test to verify Ralph state synchronization fix
 * Tests just the state saving/loading functionality
 */

import 'dotenv/config';
import * as fs from 'fs/promises';
import * as path from 'path';
import { existsSync } from 'fs';

const RALPH_DIR = './.ralph-test';

/**
 * Mock RalphLoopState for testing
 */
interface RalphLoopState {
  loopId: string;
  task: string;
  criteria: string;
  iteration: number;
  status: string;
  startTime: number;
  lastUpdateTime: number;
}

/**
 * Save loop state (same logic as in bridge)
 */
async function saveLoopState(state: RalphLoopState): Promise<void> {
  // Save state.json
  await fs.writeFile(
    path.join(RALPH_DIR, 'state.json'),
    JSON.stringify(state, null, 2)
  );

  // Synchronize iteration.txt with current iteration
  await fs.writeFile(
    path.join(RALPH_DIR, 'iteration.txt'),
    state.iteration.toString()
  );

  console.log(
    `   Saved state: iteration=${state.iteration}, status=${state.status}`
  );
}

/**
 * Load state from files
 */
async function loadState(): Promise<{
  stateFile: RalphLoopState;
  iterationFile: number;
}> {
  const stateData = await fs.readFile(
    path.join(RALPH_DIR, 'state.json'),
    'utf8'
  );
  const stateFile = JSON.parse(stateData) as RalphLoopState;

  const iterationData = await fs.readFile(
    path.join(RALPH_DIR, 'iteration.txt'),
    'utf8'
  );
  const iterationFile = parseInt(iterationData.trim());

  return { stateFile, iterationFile };
}

async function testStateSynchronization() {
  try {
    console.log('🧪 Testing Ralph State Synchronization Fix...');

    // Create test directory
    if (existsSync(RALPH_DIR)) {
      await fs.rm(RALPH_DIR, { recursive: true });
    }
    await fs.mkdir(RALPH_DIR, { recursive: true });

    // Create initial state
    const state: RalphLoopState = {
      loopId: 'test-loop-123',
      task: 'Test state synchronization',
      criteria: 'state.json and iteration.txt should match',
      iteration: 0,
      status: 'initialized',
      startTime: Date.now(),
      lastUpdateTime: Date.now(),
    };

    console.log('📊 Testing initial state save...');
    await saveLoopState(state);

    // Verify initial state
    const initial = await loadState();
    console.log(`   State file: iteration=${initial.stateFile.iteration}`);
    console.log(`   Iteration file: ${initial.iterationFile}`);

    if (initial.stateFile.iteration === initial.iterationFile) {
      console.log('   ✅ Initial synchronization correct');
    } else {
      throw new Error('Initial state synchronization failed');
    }

    // Test iteration updates
    for (let i = 1; i <= 5; i++) {
      console.log(`🔄 Testing iteration ${i}...`);

      state.iteration = i;
      state.lastUpdateTime = Date.now();
      state.status = i < 5 ? 'running' : 'completed';

      await saveLoopState(state);

      // Verify synchronization
      const current = await loadState();
      console.log(`   State file: iteration=${current.stateFile.iteration}`);
      console.log(`   Iteration file: ${current.iterationFile}`);

      if (current.stateFile.iteration === current.iterationFile) {
        console.log(`   ✅ Iteration ${i} synchronization correct`);
      } else {
        throw new Error(
          `Iteration ${i} synchronization failed: state=${current.stateFile.iteration}, file=${current.iterationFile}`
        );
      }
    }

    // Test the old broken scenario
    console.log('🔍 Testing fix for old broken scenario...');

    // Simulate the old bug by manually creating mismatched files
    const brokenState = { ...state, iteration: 10 };
    await fs.writeFile(
      path.join(RALPH_DIR, 'state.json'),
      JSON.stringify(brokenState, null, 2)
    );
    await fs.writeFile(
      path.join(RALPH_DIR, 'iteration.txt'),
      '0' // Old broken state
    );

    console.log('   Created broken state: state.json=10, iteration.txt=0');

    // Fix it by saving properly
    await saveLoopState(brokenState);

    const fixed = await loadState();
    if (
      fixed.stateFile.iteration === fixed.iterationFile &&
      fixed.iterationFile === 10
    ) {
      console.log('   ✅ Fixed broken state successfully');
    } else {
      throw new Error('Failed to fix broken state');
    }

    // Cleanup
    await fs.rm(RALPH_DIR, { recursive: true });

    console.log('');
    console.log('🎉 Ralph state synchronization test completed successfully!');
    console.log('');
    console.log('✅ Fixed Issues:');
    console.log('   - state.json and iteration.txt now stay synchronized');
    console.log('   - saveLoopState() updates both files atomically');
    console.log('   - Iteration counter properly increments in both files');
    console.log('   - Old broken states can be fixed by re-saving');
    console.log('');
  } catch (error: unknown) {
    console.error('❌ Test failed:', (error as Error).message);
    process.exit(1);
  }
}

// Run the test
testStateSynchronization();