Add runtime usage example and README reference.

Provide a concrete script demonstrating query execution, metadata, records, and normalized history/result helper usage in hotdata-runtime.

Author: eddietejeda

README.md

@@ -11,6 +11,12 @@ uv pip install hotdata-runtime
 # or: pip install hotdata-runtime
 ```
 
+Example:
+
+```bash
+python examples/basic_usage.py
+```
+
 Development (uses **uv**; creates `.venv/` in this repo):
 
 ```bash

examples/basic_usage.py

@@ -0,0 +1,25 @@
+"""Basic hotdata-runtime usage."""
+
+from hotdata_runtime import from_env
+
+
+def main() -> None:
+    client = from_env()
+    result = client.execute_sql("SELECT 1 AS ok")
+
+    print("result metadata:", result.metadata_dict())
+    print("records:", result.to_records(max_rows=5))
+
+    print("recent results:")
+    for item in client.list_recent_results(limit=5, offset=0):
+        print(item.to_dict())
+
+    print("run history:")
+    for item in client.list_run_history(limit=5, offset=0):
+        print(item.to_dict())
+
+    client.close()
+
+
+if __name__ == "__main__":
+    main()