Interface GbrainCheckpoint

bin/gstack-gbrain-sync.ts:165–171

* gbrain writes ~/.gbrain/import-checkpoint.json on every import run. If a * previous /sync-gbrain hit the timeout (SIGTERM = exit 143), the checkpoint * + its staging dir survive on disk. Detect both and let gbrain resume from * processedIndex+1 on the next run. If the staging dir is missing/emp

 * user sees we noticed. See #1611 + plan D1/C1.
 */
interface GbrainCheckpoint {
  dir?: string;
  totalFiles?: number;
  processedIndex?: number;
  completedFiles?: number;
  timestamp?: string;
}

export function readGbrainCheckpoint(): GbrainCheckpoint | null {
  // Read HOME from env so tests can redirect via process.env.HOME = ...