docs(gfql): add temporal predicates documentation

CHANGELOG.md

@@ -12,6 +12,9 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
   * Support for datetime, date, and time comparisons with operators: `gt`, `lt`, `ge`, `le`, `eq`, `ne`, `between`, `is_in`
   * Proper timezone handling for datetime comparisons
   * Type-safe temporal value handling with TypeGuard annotations
+  * Temporal value classes: `DateTimeValue`, `DateValue`, `TimeValue` for explicit temporal types
+  * Wire protocol support for JSON serialization of temporal predicates
+  * Comprehensive documentation: datetime filtering guide, wire protocol reference, and examples notebook
 * CI: Enable notebook validation by default in docs builds (set VALIDATE_NOTEBOOK_EXECUTION=0 to disable)
 * CI: Run notebook validation after doc generation for faster error detection
 

docs/docker/build-docs.sh

@@ -45,6 +45,7 @@ esac
 # Validate notebooks after building docs
 NOTEBOOKS_TO_VALIDATE=(
     "/docs/test_notebooks/test_graphistry_import.ipynb"
+    "/docs/source/demos/gfql/temporal_predicates.ipynb"
 )
 
 for notebook in "${NOTEBOOKS_TO_VALIDATE[@]}"; do

docs/source/api/gfql/predicates.rst

@@ -53,3 +53,12 @@ Temporal
    :undoc-members:
    :show-inheritance:
    :noindex:
+
+Temporal Values
+---------------
+
+.. automodule:: graphistry.compute.ast_temporal
+   :members:
+   :undoc-members:
+   :show-inheritance:
+   :noindex: