context-preservation

• Serialize current spec state (tasks, statuses, acceptance criteria)
• Capture quality pipeline state (last lint/format/typecheck results)
• Save TDD progress (current phase, iteration count, scores)
• Store context monitor metrics
• Write to .pilot-shell/state.json

2. State Restore (SessionStart / post_compact_restore)

• Read .pilot-shell/state.json on session start
• Restore spec task tracking state
• Restore quality baseline
• Resume TDD from last known position
• Log restoration summary

3. Threshold Monitoring

• Track context usage percentage (default threshold: 70%)
• Trigger preservation when threshold approached
• Calculate optimal preservation timing

State Schema

{
  "version": "1.0.0",
  "timestamp": "2026-03-02T12:00:00Z",
  "spec": {
    "title": "...",
    "taskStatuses": [{ "id": "...", "status": "COMPLETE" }],
    "currentPhase": "implement"
  },
  "quality": {
    "lastScore": 87,
    "lint": { "passed": true },
    "format": { "passed": true },
    "typecheck": { "passed": true }
  },
  "tdd": {
    "iteration": 2,
    "score": 92,
    "compliant": true
  },
  "context": {
    "usagePercent": 72,
    "preservedAt": "2026-03-02T12:00:00Z"
  }
}