docs(v3): sync scalar-domain guide with implementation; drop deleted-Python refs

[tobyhede]

What

Two subagents cross-checked docs/reference/adding-a-scalar-encrypted-domain-type.md against the current eql-scalars / eql-codegen / SQLx harness implementation. This PR fixes the stale claims they found, then removes every dangling reference to the deleted Python codegen toolchain across the codebase.

Guide corrections

• Matrix macros unified. ordered_numeric_matrix! / eq_only_scalar_matrix! no longer exist — they were merged into a single scalar_matrix! wrapper selected by a caps = [eq] / caps = [eq, ord] marker (over the low-level scalar_domain_matrix!). Updated in §3 and §4.
• Term::returns is fictional. The real Term methods are json_key / extractor / ctor / role / operators / requires; the "Returns" column is eql_v3. + ctor.
• Schema constant is SCHEMA, not CORE_SCHEMA (crates/eql-codegen/src/consts.rs).
• Temporal impls are emitted by the temporal_values! declarative macro in scalar_domains.rs, not hand-written.

Deleted-Python cleanup

Removed/redirected every reference to the removed tasks/codegen/ Python system (terms.py, templates.py, operator_surface.py, test_operator_surface.py, generate.py, writer.py, the types/*.toml manifests, load_spec, TERM_CATALOG):

• crates/eql-scalars/src/lib.rs — module header, 6 × Mirrors terms.py::… lines, 2 × verbatim from …toml provenance lines.
• crates/eql-codegen/src/{generate,writer,operator_surface}.rs, consts.rs — (port of *.py) headers.
• tests/sqlx/tests/encrypted_domain/family/jsonb_operator_surface.rs — "source of truth" comments + assert message re-pointed to crates/eql-codegen/src/operator_surface.rs (OPERATORS).
• Guide load_spec reference reworded.

Intentionally left as-is: the CHANGELOG.md [Unreleased] entry that documents the Python removal (correct past-tense reference), and a coincidental .py} byte sequence inside an encrypted ciphertext blob in migrations/005_*.sql.

Verification

• cargo check -p eql-scalars -p eql-codegen passes (exit 0).
• All edits are comments / one assert-message string — no behavioral changes.
• Final repo-wide grep is clean of the deleted-Python tokens.

Summary by CodeRabbit

• New Features

  • Added public API for managing generated files, including validation, deletion, and safe writing with integrity checks.

• Documentation

  • Updated and clarified documentation for scalar types, encrypted domain implementations, and code generation processes.

• Tests

  • Improved test documentation to reflect current source of truth for operator definitions.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 1fddd4a4-ae07-4e43-92bb-ca18daa8e47e

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• ✅ Review completed - (🔄 Check again to review again)

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch v3-sync-guide

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}