{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://lydiahub.online/public-signal-schema.json",
  "title": "ResetPulse public signal packet",
  "description": "Public, source-private schema for validating the compact ResetPulse status packet.",
  "type": "object",
  "required": ["schema", "generatedAt", "checkedAt", "freshness", "primarySignal", "latestContext", "boundary", "links"],
  "properties": {
    "schema": { "const": "resetpulse.public-signal.v1" },
    "generatedAt": { "type": "string", "format": "date-time" },
    "checkedAt": { "type": "string", "format": "date-time" },
    "signalVersion": { "type": "string", "pattern": "^v1-[0-9a-f]{8}$" },
    "freshness": {
      "type": "object",
      "required": ["label", "ageSeconds"],
      "properties": {
        "label": { "enum": ["fresh", "delayed", "stale", "unknown"] },
        "ageSeconds": { "type": ["integer", "null"], "minimum": 0 }
      },
      "additionalProperties": false
    },
    "primarySignal": { "$ref": "#/$defs/signal" },
    "latestContext": { "anyOf": [{ "$ref": "#/$defs/signal" }, { "type": "null" }] },
    "boundary": {
      "type": "object",
      "required": ["primaryIsTheDefaultEvidenceTarget", "contextDoesNotReplacePrimary", "privateAccountTelemetry", "credentialsRequired", "note"],
      "properties": {
        "primaryIsTheDefaultEvidenceTarget": { "const": true },
        "contextDoesNotReplacePrimary": { "const": true },
        "privateAccountTelemetry": { "const": false },
        "credentialsRequired": { "const": false },
        "note": { "type": "string" }
      },
      "additionalProperties": false
    },
    "links": {
      "type": "object",
      "required": ["liveTimeline", "verify", "schema", "publicSignalSchema", "monitorHealth"],
      "properties": {
        "liveTimeline": { "type": "string", "format": "uri" },
        "verify": { "type": "string", "format": "uri" },
        "schema": { "type": "string", "format": "uri" },
        "publicSignalSchema": { "type": "string", "format": "uri" },
        "monitorHealth": { "type": "string", "format": "uri" }
      },
      "additionalProperties": false
    }
  },
  "$defs": {
    "signal": {
      "type": "object",
      "required": ["id", "month", "title", "summary", "publishedAt", "status", "confidence", "detectedSeconds", "firstObservedAt", "confirmedAt", "claimScope", "claimScopeNote", "eventType", "eventTypeNote", "timingQuality", "links"],
      "properties": {
        "id": { "type": "string", "pattern": "^event-[0-9]+$" },
        "month": { "type": "string" },
        "title": { "type": "string" },
        "summary": { "type": "string" },
        "publishedAt": { "type": "string", "format": "date-time" },
        "status": { "enum": ["confirmed", "signal"] },
        "confidence": { "type": "number", "minimum": 0, "maximum": 100 },
        "detectedSeconds": { "type": "number", "minimum": 0 },
        "firstObservedAt": { "type": ["string", "null"], "format": "date-time" },
        "confirmedAt": { "type": ["string", "null"], "format": "date-time" },
        "sourceRole": { "enum": ["primary", "corroborating", "contextual", "user-observed"] },
        "claimScope": { "enum": ["broad-public", "plan-specific", "unknown"] },
        "claimScopeNote": { "type": "string" },
        "eventType": { "enum": ["full-refresh", "banked-credit", "announcement", "unknown"] },
        "eventTypeNote": { "type": "string" },
        "timingQuality": { "enum": ["measured", "historical", "migration-backfill", "external", "unknown"] },
        "links": {
          "type": "object",
          "required": ["evidencePage", "jsonReceipt"],
          "properties": {
            "evidencePage": { "type": "string", "format": "uri" },
            "jsonReceipt": { "type": "string", "format": "uri" }
          },
          "additionalProperties": false
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}