Interface Cache

The whole cache: data store and resume journal in one object.

interface Cache {
    commentsDone: string[];
    issues: Record<string, CachedIssue>;
    pendingExternalBlockers: PendingBlocker[];
    phase: ScanPhase;
    repos: Record<string, RepoState>;
    schemaVersion: number;
    updatedAt: string;
}

Properties

commentsDone: string[]

Issue keys whose comments have been fully fetched (phase-3 resume marker). Unique keys; order not significant.

issues: Record<string, CachedIssue>

Every cached issue, keyed by "owner/repo#number" (see issueKey).

pendingExternalBlockers: PendingBlocker[]

External-blocker references discovered in phase 2/4 that still need fetching.

phase: ScanPhase

Which of the four scan phases this cache is currently in.

repos: Record<string, RepoState>

Per-target-repo resume state, keyed by "owner/repo".

schemaVersion: number

On-disk schema version; bumped only on incompatible shape changes.

updatedAt: string

ISO timestamp this cache was last persisted by saveCache.