graphforge 0.3.6__tar.gz → 0.3.7__tar.gz

{graphforge-0.3.6 → graphforge-0.3.7}/CHANGELOG.md

@@ -5,6 +5,42 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.7] - 2026-04-07
+
+### Added - Functions
+- **Math functions: e, pi, exp, log, log10, trig, degrees, radians, timestamp** (#326) — full set of mathematical and trigonometric functions per openCypher spec
+- **`startNode()` and `endNode()` graph functions** (#318) — extract the start/end node from a relationship
+- **`properties()` and `keys()` graph functions** (#316) — inspect node/relationship property maps and key sets
+- **List concatenation `+` operator** (#315) — `[1,2] + [3,4]` → `[1,2,3,4]`
+- **Map subscript access `m['key']`** (#314) — dynamic map property lookup
+- **Exponent float notation and leading-dot floats** (#311) — `1.5e3`, `.5` now parsed correctly
+
+### Fixed - Sorting & Aggregation
+- **ORDER BY mixed-type sort ordering** (#320) — values of different Cypher types now sort in the correct openCypher type hierarchy order
+- **Aggregation in composite expressions and ORDER BY** (#329) — `count(n) + 1`, `ORDER BY count(n)` and similar patterns now evaluate correctly
+- **Validate ORDER BY aggregation expressions at compile time** (#331) — non-aggregated variables in aggregating ORDER BY now raise a clear error
+- **Detect non-projected ORDER BY aggregates at compile time** (#332) — aggregates in ORDER BY that aren't in the projection are caught early
+
+### Fixed - Expression Evaluation
+- **Operator precedence, null propagation, and type coercion** (#321) — `NOT`, `AND`, `OR` precedence; null propagation in arithmetic; integer/float coercion edge cases
+- **Type conversion TypeError/null per openCypher spec** (#327) — `toInteger()`, `toFloat()`, `toString()` now return `null` on unconvertible input per spec
+- **List equality with null uses three-valued logic** (#330) — `[1, null] = [1, null]` now correctly returns `null`
+- **NaN handling in comparisons, arithmetic, and sort** (#323) — NaN propagation and sort position per openCypher spec
+- **SKIP/LIMIT accept expression values** (#319) — `SKIP toInteger(n.offset)` and similar dynamic skip/limit values now work
+
+### Fixed - Parser & Clause Gaps
+- **WITH keyword position gaps** (#310) — `WITH` is now accepted after `SET`, `REMOVE`, `DELETE`, and in chained multi-part queries
+- **ASCENDING/DESCENDING keywords** (#312) — `ORDER BY n.name ASCENDING` / `DESCENDING` now parse correctly; removed stale xfail markers (#325)
+- **`NodeRef`/`EdgeRef` comparison methods** (#313) — nodes and relationships are now sortable and comparable by identity
+
+### Fixed - Graph Semantics
+- **Relationship uniqueness in MATCH patterns** (#333) — runtime enforcement that the same physical edge cannot fill two relationship variables in one MATCH pattern; extended to anonymous multi-hop rels and path-variable (`ExpandMultiHop`) patterns
+- **Temporal select-into constructors** (#334) — cross-type temporal projection (`date({date: other})`, `localdatetime({datetime: dt})`, etc.) with component overrides; null propagation, hour-overflow normalization, and timezone conversion all correct
+
+### TCK Coverage
+- **~2,894 passing** (up from ~2,507 at v0.3.6) — +387 net new passing scenarios
+- Theme: ORDER BY correctness, aggregation, operator precedence, graph semantics, temporal completeness
+
 ## [0.3.6] - 2026-02-28
 
 ### Fixed - TCK Harness Correctness

{graphforge-0.3.6 → graphforge-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: graphforge
-Version: 0.3.6
+Version: 0.3.7
 Summary: Composable graph tooling for analysis, construction, and refinement
 Project-URL: Homepage, https://github.com/DecisionNerd/graphforge
 Project-URL: Repository, https://github.com/DecisionNerd/graphforge

{graphforge-0.3.6 → graphforge-0.3.7}/docs/reference/opencypher-compatibility.md

@@ -1,7 +1,7 @@
 # OpenCypher Compatibility Status
 
-**Last Updated:** 2026-02-16
-**GraphForge Version:** v0.4.0 (in progress)
+**Last Updated:** 2026-04-07
+**GraphForge Version:** v0.3.7
 
 ---
 
@@ -45,7 +45,9 @@ GraphForge implements a **practical subset of OpenCypher** focused on common gra
 | v0.1.4 | 638/3,837 | ~30% | Released |
 | v0.2.0 | 638/3,837 | ~40% | Released |
 | v0.2.1 | 638/3,837 | ~45% | Released |
-| v0.3.0 | 1,303/1,626 (34%) | **~78%** | **Released** (February 2026) |
+| v0.3.0 | 1,303/1,626 (34%) | **~78%** | Released (February 2026) |
+| v0.3.6 | 2,507/3,837 (65%) | **~85%** | Released (March 2026) |
+| v0.3.7 | 2,894/3,837 (75%) | **~88%** | **Released** (April 2026) |
 | v1.0 | >3,800/3,837 | >99% | Goal (Full OpenCypher) |
 
 **Note:** TCK scenario counts updated to reflect actual passing scenarios (1,303 of 1,626 tested).

{graphforge-0.3.6 → graphforge-0.3.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "graphforge"
-version = "0.3.6"
+version = "0.3.7"
 description = "Composable graph tooling for analysis, construction, and refinement"
 readme = "README.md"
 requires-python = ">=3.10"

{graphforge-0.3.6 → graphforge-0.3.7}/src/graphforge/ast/clause.py

@@ -232,13 +232,13 @@ class LimitClause(BaseModel):
 
     Examples:
         LIMIT 10
-        LIMIT 100
+        LIMIT 2 * 5
         LIMIT 0  (valid - returns no rows)
     """
 
-    count: int = Field(..., ge=0, description="Maximum number of rows")
+    count: Any = Field(..., description="Maximum number of rows (integer expression)")
 
-    model_config = {"frozen": True}
+    model_config = {"frozen": True, "arbitrary_types_allowed": True}
 
 
 class SkipClause(BaseModel):
@@ -246,12 +246,12 @@ class SkipClause(BaseModel):
 
     Examples:
         SKIP 5
-        SKIP 20
+        SKIP 2 + 3
     """
 
-    count: int = Field(..., ge=0, description="Number of rows to skip")
+    count: Any = Field(..., description="Number of rows to skip (integer expression)")
 
-    model_config = {"frozen": True}
+    model_config = {"frozen": True, "arbitrary_types_allowed": True}
 
 
 class OrderByItem(BaseModel):