TDFRecord:
    id: str           # Clockchain canonical URL or Flash UUID
    version: str      # "1.0.0"
    source: str       # "clockchain" | "flash" | "proteus" | "snag-bench"
    timestamp: datetime
    provenance: TDFProvenance
        generator: str
        run_id: str
        confidence: float
        flash_id: str | None
    payload: dict     # Source-specific content
    tdf_hash: str     # SHA-256 of canonicalized payload

from timepoint_tdf import from_flash, from_clockchain

# From Flash scene
tdf_record = from_flash(flash_output)

# From Clockchain node
tdf_record = from_clockchain(node_data)

pip install -e "git+https://github.com/timepointai/timepoint-tdf.git#egg=timepoint-tdf"

                ┌──────────────┐
                │  TDF v1.0.0  │
                │  (pure lib)  │
                └──────┬───────┘
                       │
          ┌────────────┼─────────────┐
          │            │             │
     from_flash() from_clockchain() (planned)
          │            │             │
     ┌────▼───┐  ┌────▼──────┐  ┌────▼────┐
     │ Flash  │  │Clockchain │  │Proteus  │
     └────────┘  └───────────┘  └─────────┘