{
  "schema_version": "qz.energy.public-export-contract/v1",
  "product_id": "qz-energy",
  "generated_at": "2026-07-25T15:41:35Z",
  "source_allowlist_path": "data/source-allowlist.json",
  "public_snapshot_path": "data/qz-energy-public-snapshot.json",
  "candidate_capture": {
    "state": "contract-ready",
    "public_path": null,
    "capture_command": "node scripts/reviewed-export.mjs capture-url <source-url> [source-id] [detected-period-or-date]",
    "scheduler_command": "node scripts/reviewed-export.mjs capture-reviewed-sources [snapshot-path] [candidate-jsonl-path] [limit]",
    "systemd_timer": "qz-energy-capture-reviewed-sources.timer",
    "required_fields": [
      "source_id",
      "source_url",
      "captured_at",
      "content_hash_sha256",
      "detected_period_or_date",
      "terms_status",
      "candidate_status"
    ],
    "allowed_candidate_statuses": [
      "captured",
      "needs-review",
      "rejected",
      "promoted-to-review"
    ]
  },
  "reviewed_public_record": {
    "required_fields": [
      "source_name",
      "source_url",
      "review_status"
    ],
    "allowed_review_statuses": [
      "published",
      "source_reviewed"
    ],
    "raw_candidate_statuses_forbidden": [
      "captured",
      "needs-review",
      "rejected",
      "promoted-to-review"
    ]
  },
  "reviewed_export": {
    "private_path": "private/reviewed-public-records.json",
    "public_path": null,
    "status_command": "node scripts/reviewed-export.mjs status",
    "promote_command": "node scripts/reviewed-export.mjs promote-reviewed <metric|asset|agenda> <record-json-path>",
    "export_command": "node scripts/reviewed-export.mjs export"
  },
  "public_safety": {
    "forbid_raw_candidate_export": true,
    "forbid_exact_sensitive_coordinates": true,
    "forbid_operational_modes": true,
    "forbid_unreviewed_qazpipe_qazlake_records": true
  }
}