{
  "spec_version": "0.1",
  "jurisdiction": "US",
  "axis": "trademark",
  "tier": "PARTIAL",
  "rows_indexed": 6570000,
  "refresh_cadence": "weekly bulk + daily delta (delta cron wiring in flight; targets daily refresh after full-corpus gate-pass)",
  "max_staleness_hours": 192,
  "last_refresh": "2026-05-19T09:48:00Z",
  "inclusion_criteria": "All federally-registered US trademarks plus pending applications under the USPTO TRTYRAP bulk feed. Includes live and abandoned-within-recent-prosecution-history marks at the federal register tier. Excludes state trademark registers (out of scope per R13 D-R13-1). Excludes design-mark-only records where no word-element is registered.",
  "search_recall_pct": 94.7,
  "search_precision_pct": 96.2,
  "confidence_floor": 70,
  "known_gaps": [
    "Bulk re-ingest at 47% of target (6.57M of approximately 14M target rows). The greater-than-or-equal-to 3.5M live-row floor (gate-01) was met as of 2026-05-19; the full-corpus gate (greater-than-or-equal-to 14M rows) is scheduled 2026-06-01. Per R13 cardinal rule (D-R13-1), this spec flips to COVERED when the full-corpus gate passes and the daily delta cron has been operating for fourteen consecutive days.",
    "USPTO bulk index has up to 7-day refresh lag on the daily delta channel today; verdicts may miss marks filed within the last week.",
    "State trademark registers are out of scope (US_STATE_*, NOT_CHECKED per the per-jurisdiction Coverage Spec at /coverage).",
    "Common-law unregistered rights surveyed separately via the deep-diligence module; not consulted on the default /v1/verify path.",
    "TTAB (Trademark Trial and Appeal Board) precedent is tracked separately via the USPTO_TTAB spec; that spec is PARTIAL today (16-day delta lag pending R13 D-R13-7 cron resume target 2026-05-30)."
  ],
  "primary_registry_source": {
    "url": "https://www.uspto.gov/trademarks/search/bulk-data",
    "access_mechanic": "xml_bulk",
    "license_tag": "PUBLIC_DOMAIN_US",
    "attribution_required": false,
    "redistribution_permitted": true
  },
  "corroboration_path": {
    "description": "USPTO TRTYRAP weekly bulk is the primary source. The USPTO ODP (Open Data Portal) live API serves as a corroboration channel for recently-filed marks where the bulk feed is lagging. When the two sources disagree on a mark's status, the most-recent timestamp wins; if both are within 24 hours, the bulk feed is treated as authoritative for status fields and the ODP is treated as authoritative for prosecution-history fields.",
    "disagreement_policy": "most_recent_wins"
  },
  "audit_receipt_fields": {
    "jurisdictions_consulted": ["USPTO_bulk"],
    "platforms_consulted": [],
    "tlds_consulted": [],
    "cultural_sources_consulted": [],
    "sound_models_consulted": []
  },
  "failure_modes": [
    "USPTO bulk index has up to 7-day refresh lag on the daily delta channel; lag exceeds the max_staleness_hours when the upstream feed slips.",
    "Schema changes upstream (annual format adjustment by USPTO) require parser update; risk of ingest halt for 24-72 hours during the format rotation.",
    "Concurrent SQLite writers can corrupt the local index; serialized ingest is required and is enforced via a single-writer cron lock.",
    "Truncated bulk ZIPs from the upstream FTP have been observed (most recently 2026-05-19); SQLite .recover stream is the documented recovery path and was successfully exercised against the 2026-05-19 truncation."
  ],
  "measurement_methodology": {
    "ground_truth_corpus_version": "v3-naam-corpus-v7-tm-2026-05",
    "measured_at": "2026-05-15T00:00:00Z",
    "n": 24264,
    "methodology_url": "https://www.etymolt.com/methodology"
  },
  "wave": "Live (PARTIAL) — flips to COVERED on full-corpus gate-pass (target 2026-06-01)",
  "spec_path": "https://www.etymolt.com/coverage/us/spec-v1.json",
  "bureau_model_disclosure": "Etymolt surfaces signals derived from the USPTO federal trademark register (public domain, US Government). This is a clearance signal, not legal advice. Confirm with trademark counsel before adopting a name in commerce. The US bulk index is currently at 47% of target row count; verdicts may miss recently-filed marks until the full corpus loads on 2026-06-01. Data sources have stated freshness windows; refer to coverage_caveat per jurisdiction in the verdict payload.",
  "customer_facing_copy": {
    "verdict_card": "USPTO consulted (PARTIAL — 6.57M of approximately 14M target rows; up to 7-day delta lag). Verdict may miss marks filed in the last week.",
    "api_docs": "The USPTO_bulk jurisdiction is PARTIAL until the full-corpus gate passes on 2026-06-01. /v1/verify responses carry jurisdictions_consulted with USPTO_bulk listed when the source was queried; the coverage_caveat field surfaces freshness metadata when the refresh window has been exceeded.",
    "integrator_surface": "Etymolt consulted the USPTO TRTYRAP bulk register at PARTIAL tier; refer to /coverage/us/spec-v1.json for the full disclosure."
  },
  "promotion_criteria": "Row count greater-than-or-equal-to 14M AND search_precision_pct greater-than-or-equal-to 95.0 AND search_recall_pct greater-than-or-equal-to 94.0 AND continuous delta cron operating for greater-than-or-equal-to 14 consecutive days AND board-level gate review passed per R13 D-R13-10.",
  "demotion_criteria": "Row count drops below 10M; OR refresh cron fails for greater-than 3 consecutive cycles; OR precision drops below 90.0 for two consecutive quarterly recalibrations; OR upstream USPTO format change halts ingest for greater-than 7 days without parser update."
}
