Definitions that keep This Indian Life reproducible.

type SeriesArtifact = {
  schemaVersion: 1;
  artifactType: "series";
  indicatorId: string;
  title: string;
  sourceId: string;
  sourceIndicatorId: string;
  sourceUrl: string;
  unit: string;
  frequency: "annual" | "quarterly" | "monthly" | "daily";
  geography: { type: string; id: string; name: string };
  fetchedAt: string;
  observations: Array<{ date: string; value: number | null }>;
};

type TableArtifact = {
  schemaVersion: 1;
  artifactType: "table";
  indicatorId: string;
  title: string;
  sourceId: string;
  sourceIndicatorId: string;
  sourceUrl: string;
  unit: string;
  geography: { type: string; id: string; name: string };
  fetchedAt: string;
  dimensions: string[];
  rows: Array<Record<string, unknown>>;
  metadata: Record<string, unknown>;
};

type EvidencePacket = {
  schemaVersion: 1;
  questionId: string;
  question: string;
  requiredIndicatorIds: string[];
  availableIndicatorIds: string[];
  lockedNumbers: Array<{
    label: string;
    value: number;
    date?: string;
    unit: string;
    sourceId: string;
    indicatorId: string;
  }>;
  sourceSummaries: Array<Record<string, unknown>>;
  caveats: string[];
  forbiddenClaims: string[];
};

type ExplanationArtifact = {
  schemaVersion: 1;
  questionId: string;
  status: "ready" | "work_in_progress" | "needs_data";
  short: { headline: string; dek: string; body: string };
  article: { title: string; standfirst: string; bodyMarkdown: string };
  sourceNotes: string[];
  caveats: string[];
  lockedNumbersUsed: string[];
  qualityFlags: string[];
  generatedAt: string;
  model: string;
  evidence: EvidencePacket;
};