anvil-dev-framework 0.1.7 → 0.1.9

package/global/tools/anvil-memory/src/__tests__/ccs/fixtures.ts

@@ -0,0 +1,405 @@
+/**
+ * CCS Test Fixtures
+ *
+ * Mock data and fixtures for Context Checkpoint System testing.
+ * Provides sample data for various scenarios and states.
+ */
+
+import type { RalphState, ContextWindowData } from './test-utils';
+
+/**
+ * Fixed base time for deterministic test fixtures.
+ * Using a fixed timestamp prevents flaky tests from time-dependent comparisons.
+ */
+const BASE_TIME = new Date('2026-01-17T15:00:00.000Z');
+
+/**
+ * Generate ISO timestamp with optional offset from BASE_TIME
+ * @param offsetMs - Milliseconds to offset from BASE_TIME (negative for past)
+ */
+const iso = (offsetMs = 0): string =>
+  new Date(BASE_TIME.getTime() + offsetMs).toISOString();
+
+/**
+ * Sample Ralph states for different scenarios
+ */
+export const RALPH_STATES: Record<string, Partial<RalphState>> = {
+  /**
+   * Fresh Ralph session just started
+   */
+  fresh: {
+    mode: 'ralph',
+    session_id: 'ralph-fresh-001',
+    iteration: 1,
+    started_at: iso(),
+    status: 'running',
+    task_list: ['Task 1', 'Task 2', 'Task 3'],
+    completed_tasks: [],
+    checkpoint_active: false,
+    context_history: [],
+  },
+
+  /**
+   * Ralph session mid-progress
+   */
+  inProgress: {
+    mode: 'ralph',
+    session_id: 'ralph-progress-002',
+    iteration: 3,
+    started_at: iso(-3600000), // 1 hour ago
+    status: 'running',
+    task_list: ['Task 1', 'Task 2', 'Task 3', 'Task 4'],
+    completed_tasks: ['Task 1', 'Task 2'],
+    checkpoint_active: false,
+    context_history: [
+      { iteration: 1, peak_percent: 45, checkpoint: false, level: 'L0' },
+      { iteration: 2, peak_percent: 58, checkpoint: false, level: 'L0' },
+    ],
+    linear_issue: 'ANV-42',
+  },
+
+  /**
+   * Ralph session with active checkpoint
+   */
+  checkpointActive: {
+    mode: 'ralph',
+    session_id: 'ralph-checkpoint-003',
+    iteration: 5,
+    started_at: iso(-7200000), // 2 hours ago
+    status: 'checkpointed',
+    task_list: ['Task 1', 'Task 2', 'Task 3', 'Task 4', 'Task 5'],
+    completed_tasks: ['Task 1', 'Task 2', 'Task 3'],
+    checkpoint_active: true,
+    context_history: [
+      { iteration: 3, peak_percent: 65, checkpoint: false, level: 'L0' },
+      { iteration: 4, peak_percent: 78, checkpoint: false, level: 'L1' },
+      { iteration: 5, peak_percent: 87, checkpoint: true, level: 'L2' },
+    ],
+    handoff_file: '.claude/handoffs/2026-01-17-1500.md',
+    linear_issue: 'ANV-100',
+  },
+
+  /**
+   * Ralph session at high context (approaching L3)
+   */
+  highContext: {
+    mode: 'ralph',
+    session_id: 'ralph-high-004',
+    iteration: 7,
+    started_at: iso(-10800000), // 3 hours ago
+    status: 'running',
+    task_list: ['Task 1', 'Task 2', 'Task 3'],
+    completed_tasks: ['Task 1', 'Task 2'],
+    checkpoint_active: false,
+    context_history: [
+      { iteration: 6, peak_percent: 82, checkpoint: false, level: 'L1' },
+      { iteration: 7, peak_percent: 91, checkpoint: false, level: 'L2' },
+    ],
+    linear_issue: 'ANV-200',
+  },
+
+  /**
+   * Manual mode (not Ralph)
+   */
+  manual: {
+    mode: 'manual',
+    session_id: 'manual-001',
+    iteration: 1,
+    started_at: iso(),
+    status: 'running',
+  },
+};
+
+/**
+ * Context window data for different percentage levels
+ */
+export const CONTEXT_DATA: Record<string, ContextWindowData> = {
+  /**
+   * Low context usage (50%)
+   */
+  low: {
+    context_window: {
+      current_usage: {
+        input_tokens: 100000,
+        output_tokens: 5000,
+        cache_read_input_tokens: 20000,
+        cache_creation_input_tokens: 0,
+      },
+      context_window_size: 200000,
+    },
+  },
+
+  /**
+   * L1 threshold (75%)
+   */
+  l1: {
+    context_window: {
+      current_usage: {
+        input_tokens: 150000,
+        output_tokens: 10000,
+        cache_read_input_tokens: 30000,
+        cache_creation_input_tokens: 0,
+      },
+      context_window_size: 200000,
+    },
+  },
+
+  /**
+   * L2 threshold (88%)
+   */
+  l2: {
+    context_window: {
+      current_usage: {
+        input_tokens: 176000,
+        output_tokens: 15000,
+        cache_read_input_tokens: 40000,
+        cache_creation_input_tokens: 0,
+      },
+      context_window_size: 200000,
+    },
+  },
+
+  /**
+   * L3 threshold (96%)
+   */
+  l3: {
+    context_window: {
+      current_usage: {
+        input_tokens: 192000,
+        output_tokens: 18000,
+        cache_read_input_tokens: 45000,
+        cache_creation_input_tokens: 0,
+      },
+      context_window_size: 200000,
+    },
+  },
+
+  /**
+   * Empty context
+   */
+  empty: {
+    context_window: {
+      current_usage: {
+        input_tokens: 0,
+        output_tokens: 0,
+        cache_read_input_tokens: 0,
+        cache_creation_input_tokens: 0,
+      },
+      context_window_size: 200000,
+    },
+  },
+
+  /**
+   * Zero-size context window (edge case)
+   */
+  zeroSize: {
+    context_window: {
+      current_usage: {
+        input_tokens: 1000,
+        output_tokens: 100,
+        cache_read_input_tokens: 0,
+        cache_creation_input_tokens: 0,
+      },
+      context_window_size: 0,
+    },
+  },
+};
+
+/**
+ * Sample handoff document content
+ */
+export const HANDOFF_TEMPLATES: Record<string, string> = {
+  /**
+   * Standard checkpoint handoff
+   */
+  checkpoint: `# Session Handoff: Checkpoint (L2)
+
+## Session Context
+- **Session ID**: ralph-progress-002
+- **Iteration**: 3
+- **Context**: 87% (L2 checkpoint triggered)
+- **Time**: ${iso()}
+
+## Current Task
+Implementing feature X with database migrations
+
+## Completed Items
+- [x] Created database schema
+- [x] Added migration scripts
+- [x] Updated types
+
+## Remaining Items
+- [ ] Write API endpoints
+- [ ] Add validation
+- [ ] Create tests
+
+## Key Decisions
+- Using SQLite for local storage
+- FTS5 for search functionality
+
+## Files Modified
+- src/db.ts (schema changes)
+- src/types.ts (type updates)
+- migrations/001_initial.sql (new)
+
+## Next Steps
+1. Resume with API endpoint implementation
+2. Focus on GET endpoint first
+3. Then implement POST with validation
+
+## Notes
+Context checkpoint triggered at 87%. Safe to resume.
+`,
+
+  /**
+   * Emergency L3 handoff
+   */
+  emergency: `# Session Handoff: EMERGENCY STOP (L3)
+
+## Critical Information
+- **Context**: 96% - EMERGENCY STOP
+- **Iteration**: 7
+- **Immediate Action Required**: Resume in new session
+
+## State at Stop
+- In the middle of file write operation
+- Changes may be partial
+
+## Uncommitted Changes
+- global/lib/feature.ts (partial)
+- global/lib/types.ts (complete)
+
+## Recovery Steps
+1. Check git status for uncommitted changes
+2. Review partial file changes
+3. Continue from last completed task
+
+## Last Completed Task
+Task 5: Database migration
+
+## Next Task to Resume
+Task 6: API endpoint implementation (PARTIAL)
+`,
+
+  /**
+   * Minimal handoff
+   */
+  minimal: `# Handoff
+
+## Summary
+- Context: 85%
+- Status: Checkpointed
+
+## Resume
+Continue with remaining tasks.
+`,
+};
+
+/**
+ * Sample PROMPT.md template content
+ */
+export const PROMPT_TEMPLATES: Record<string, string> = {
+  /**
+   * Standard resume prompt
+   */
+  resume: `# Resume Session: ralph-progress-002
+
+## Previous Context
+You were working on ANV-42 before a context checkpoint.
+
+## Completed Work
+- Task 1: Schema design
+- Task 2: Migration scripts
+
+## Current State
+- Iteration: 4 (resumed from 3)
+- Context checkpoint completed successfully
+- Files are in consistent state
+
+## Remaining Tasks
+- Task 3: API endpoints
+- Task 4: Tests
+
+## Instructions
+1. Review the handoff document at .claude/handoffs/2026-01-17-1500.md
+2. Check git status for any uncommitted changes
+3. Continue with Task 3: API endpoints
+
+Do NOT re-do completed work. Start fresh from the remaining items.
+`,
+
+  /**
+   * Emergency resume prompt
+   */
+  emergencyResume: `# EMERGENCY RESUME: ralph-high-004
+
+## Critical Context
+Previous session hit L3 (96% context). Immediate stop was triggered.
+
+## IMPORTANT
+- Some work may be incomplete
+- Check git status FIRST
+- Verify file integrity before continuing
+
+## Last Known State
+- Working on: Task 2
+- Status: PARTIAL (interrupted)
+
+## Recovery Steps
+1. Run: git status
+2. Review any uncommitted changes
+3. Decide: commit partial work OR revert
+4. Then continue with remaining tasks
+
+## Remaining Tasks
+- Task 2: API endpoints (MAY BE PARTIAL)
+- Task 3: Tests
+
+Proceed carefully.
+`,
+};
+
+/**
+ * Malformed/edge case inputs for error handling tests
+ */
+export const MALFORMED_INPUTS: Record<string, unknown> = {
+  /**
+   * Empty object
+   */
+  empty: {},
+
+  /**
+   * Null
+   */
+  null: null,
+
+  /**
+   * Missing context_window
+   */
+  missingContextWindow: {
+    tool_name: 'Write',
+    tool_result: 'Success',
+  },
+
+  /**
+   * Invalid JSON string (for stdin tests)
+   */
+  invalidJson: 'not valid json {{{',
+
+  /**
+   * Nested null values
+   */
+  nestedNull: {
+    context_window: null,
+  },
+
+  /**
+   * Wrong types
+   */
+  wrongTypes: {
+    context_window: {
+      current_usage: 'not an object',
+      context_window_size: 'not a number',
+    },
+  },
+};

package/global/tools/anvil-memory/src/__tests__/ccs/index.ts

@@ -0,0 +1,36 @@
+/**
+ * CCS Test Module Exports
+ *
+ * Central export for all CCS testing utilities and fixtures.
+ */
+
+// Test utilities
+export {
+  PROJECT_ROOT,
+  HOOKS_DIR,
+  LIB_DIR,
+  CCS_THRESHOLDS,
+  createTestDir,
+  createRalphStateFile,
+  readRalphStateFile,
+  createContextData,
+  runPythonHook,
+  runBashHook,
+  parseCCSSignal,
+  isJqAvailable,
+  createHandoffFile,
+  type HookResult,
+  type RalphState,
+  type ContextWindowData,
+  type ContextHistoryEntry,
+  type ContextCheckpoint,
+} from './test-utils';
+
+// Fixtures
+export {
+  RALPH_STATES,
+  CONTEXT_DATA,
+  HANDOFF_TEMPLATES,
+  PROMPT_TEMPLATES,
+  MALFORMED_INPUTS,
+} from './fixtures';