wegamekinglc / calc-flow / 32910460747

94%

Build Type

push

github

Committed by web-flow

Commit Message

feat: compile symbolic row expressions (#194)

* feat: compile symbolic row expressions

Lower row-local symbolic programs to strict project-v3 expression
nodes with deterministic fusion and CSE: literal, field, arithmetic,
comparison, boolean, where, coalesce, log/exp/sqrt/abs/clip/cast, and
select/filter/with_columns resolve into one fused node per output,
with shared non-trivial subexpressions materialized once through
tiered CSE nodes. The Rust graph compiler keeps final port, schema,
and topology validation; generated node IDs and plan fingerprints are
deterministic and carry strict JSON only.

Stream compilation now rejects read-only queries that call volatile
built-in functions, so the expression/sql operator deterministic and
replay-safe capability claims stay truthful (SCE-04 handoff). The
portable timestamp[us, UTC] spelling is accepted in port schemas.

Stateful rolling, cross-section, event-window, array, and
static-parameter declarations fail loudly with the frozen
unknown_primitive_version issue code in both modes; a stream
aggregate or SQL window is never silently made batch-local. Batch and
stream outputs are verified equivalent across 1/7/1000-row
segmentation, and execution performs zero symbolic Python calls.

Co-authored-by: multica-agent <github@multica.ai>

* docs: reconcile symbolic compilation docs with SCE-05 behavior

PR #194 review confirmed two wording errors in docs/python-api.md:
array outputs are rejected with unknown_primitive_version in batch
mode but earlier, at analysis, with unbounded_state in stream mode
(SCE-03 stream-safety rule), and the volatile guard resolves against
the built-in default function registry, not a runtime registry. The
same review confirmed the capability paragraph was stale: volatile
built-in SQL functions such as random() in read-only SELECTs are now
rejected at stream compile time, not outside validation.

The sweep also reconciled lagging surfaces: introduction.md and
api-reference.md still ... (continued)

Coverage Stats

531 of 553 new or added lines in 9 files covered. (96.02%)

10 existing lines in 1 file now uncovered.

65318 of 71547 relevant lines covered (91.29%)

3318.94 hits per line