Changelog
This page is the maintained version index for TeaQL documentation. It separates the current verified component baseline from historical narrative material.
The date on a baseline entry is its verification date unless an authoritative artifact publication date is explicitly cited. It must not be reinterpreted as the release date of every component in the row.
2026-07-15 — Current Verified Baseline
The official server, Maven, and crates.io checks found no component-version change from the 2026-07-14 baseline.
| Component | Current version | Version authority | Maintained evidence |
|---|---|---|---|
| Generator Server | 20260813.231514 | Official latest-version endpoint | Live version check and generated-target verification. |
| teaql-java | 1.528-RELEASE | Latest-version endpoint and TeaQL Maven repository | Full reactor tests, deploy and fresh-repository artifact resolution. |
| teaql-rs | 4.2.10 | Latest-version endpoint and published crate set | Full workspace checks and 18 publishable crates verified on crates.io. |
| TeaQL Maven plugin | 1.1.0 | Plugin Maven metadata | Installed help/source, live target catalog, evaluation, generation, and regeneration. |
cargo-teaql | 2.0.11 | crates.io package | Current published Rust generator client baseline. |
Run npm run check:latest-versions to compare this baseline with the official
server, Maven, and crates.io sources.
Current Observed Behavior
These are current-version observations and migration boundaries. Unless the source explicitly says so, they are not claims that a behavior was first introduced by the exact artifact version in the table.
- Cargo
2.0.8usesevaluate; generation targets such asrust-lib-coreandrust-app-consoleare invoked directly after queryingservices. - Maven plugin
1.1.0useslist-servicesand one dynamicgenerategoal with-Dservice=<target>; target names are obtained from the live catalog. - Current handwritten queries end with
comment→purpose→executeForXxx/execute_for_xxx;purposeis immediately before execution. - Current entity persistence carries a concrete
auditAs/audit_asbeforesaveorupdate. - Rust generated workspaces use the narrower
teaql-provider-postgres,teaql-provider-mysql, andteaql-provider-sqlitearchitecture rather than the historical SQLx-centered provider names. - The recorded Rust SQLite combination generated, tested, started, queried, mutated with audit intent, and regenerated successfully.
- Java evaluation,
java-lib-coregeneration, and regeneration succeeded, but the current generated workspace is not a runnable release baseline.
Known Limitations
- Generated Java uses nonexistent
io.teaql:teaql-data-service-sqlite:1.525-RELEASE; the published artifact isio.teaql:teaql-sqlite:1.525-RELEASE. - Generated Java entity dispatch uses
internalSet/internalGet, while released teaql-core1.525-RELEASEexposes__internalSet/__internalGet. java-app-consolegeneration reports a missing server-sideapplication.properties.stgtemplate.- Generated Rust
sample_data.rscontains query calls withpurposebut nocomment; generated output was preserved rather than patched. - Java query/audited-mutation execution and all current non-SQLite provider combinations remain unverified in the maintained Golden Path.
- No formal LTS, maintenance-duration, security-backport, or end-of-life policy has been published.
Use Migration Notes, Compatibility Matrix, and Verification Evidence before adopting this baseline.
Historical Published Material
These entries preserve the site's release and architecture chronology. They are not automatically compatible with the current baseline.
| Publication date | Material | Recorded subject | Current treatment |
|---|---|---|---|
| 2026-07-02 | Why TeaQL Rust Removed SQLx | Move from SQLx-centered providers to narrower TeaQL provider contracts. | Current architecture direction; regenerate and use current crate names/versions. Code terminals in historical prose may not satisfy the current intent order. |
| 2026-06-16 | Spring Boot 4.1 and Java 21 | Generated Java target using Java 21 and Spring Boot 4.1.0. | Observed again in current java-lib-core output, but not proof of every Java module/framework combination or a clean build. |
| 2026-06-10 | Java Runtime Modular Refactor | JPMS, non-Spring direction, audit/policy alignment, and module boundaries. | Architecture narrative; current public interfaces must be taken from teaql-java 1.525-RELEASE, not copied from the post. |
| 2026-05-30 | TeaQL 1.0.0 Release Notes | Umbrella Rust/Java API, audit, query-prefix, transaction, and agent-workflow changes. | Historical migration material. Its component coordinates, provider names, and command/version advice are not the current baseline. |
| 2026-05-01 | TeaQL Rust v0.7.0 | Aggregation cache, debug logging, query expressions, and the then-current provider layout. | Historical only; listed SQLx/rusqlite provider crate names are obsolete for current generated workspaces. |
Component History Gaps
The official repositories and artifact channels do not currently provide one
complete, aligned set of release notes and publication dates for Generator
Server 20260813.231514, teaql-java 1.528-RELEASE, teaql-rs 4.2.10, Maven
plugin 1.1.0, and cargo-teaql 2.0.11.
Repository tags also use version lines that do not map cleanly to the current published artifact versions. Consequently, this changelog does not infer release dates, commit ranges, or “introduced in” claims from tag names.
To close the gap, each component release should publish a tag or immutable artifact-to-commit mapping and a release note using the structure below.
Required Shape for New Entries
Every new entry must include:
- component and exact version;
- publication date and immutable source/tag/artifact link;
- added, changed, deprecated, removed, and fixed behavior;
- generated API and dependency impact;
- configuration/environment impact;
- provider/schema/transaction impact;
- security, audit, tenancy, and masking impact;
- migration and rollback instructions;
- exact verification commands, expected result, and evidence artifact;
- known limitations and support status.
Do not publish an empty category as “none” unless the component owner reviewed that category. Unknown information should remain explicitly unknown.