docs(cayenne): refresh_append_overlap is supported from v2.2.1

[claudespice]

Summary

Cayenne used to refuse to load a file-mode dataset that set acceleration.refresh_append_overlap. spiceai/spiceai#13574 removed that rejection and made the engine honor the window; git tag --contains puts it in v2.2.1 only.

The rejection string tracks the change exactly:

Tag	not yet support refresh_append_overlap in crates/
v1.11.6, v2.0.1, v2.1.5, v2.2.0	present
v2.2.1, trunk	gone

#2186 dropped the limitation bullet from the vNext Cayenne page — correctly — but the same claim is still standing on the two spicepod reference pages, which restate per-engine capability claims and are the standard miss for a component-page-only fix (the #1928 → #1940 shape). So reference/spicepod/datasets.md and views.md currently tell a vNext reader that a supported setting will fail their Spicepod to load:

Not supported by the Spice Cayenne (cayenne) acceleration engine: a file-mode Cayenne dataset that sets this fails to load.

That is a false negative capability claim on a reference page — it reads as a limitation rather than a bug, so nothing flags it, and the reader's remedy is to not use a feature that works.

What changed

vNext — claim removed from:

• website/docs/reference/spicepod/datasets.md
• website/docs/reference/spicepod/views.md

version-2.2.x — the line splits mid-release, so it is documented per patch rather than flattened:

• components/data-accelerators/cayenne/index.md — bullet retitled "No refresh_append_overlap in v2.2.0", keeping the v2.2.0 error string and the mode: memory exemption, and adding that v2.2.1 supports the window
• reference/spicepod/datasets.md, reference/spicepod/views.md — "Supported … from v2.2.1. In v2.2.0 a file-mode Cayenne dataset/view that sets this fails to load."

version-2.1.x, 2.0.x, 1.11.x, 1.10.x, 1.9.x — untouched. Those releases really do reject it, so their pages are correct as they stand.

Behavior in v2.2.1

Not just "stops erroring" — crates/runtime/tests/acceleration/cayenne_append_overlap.rs exists at v2.2.1 and covers both halves: the high-water mark is moved back by the configured duration so a late row is fetched, and the re-fetched rows inside the window are dropped by an exact-row comparison before the write rather than appended again. That is what the 2.2.x wording claims, and no more.

Source refs

• fix(cayenne): stop a predicate DELETE destroying live rows on an upsert table spiceai#13574 (merged 2026-08-30) — removed the rejection; git tag --contains → v2.2.1
• crates/runtime/tests/acceleration/cayenne_append_overlap.rs at v2.2.1 — cayenne_append_refresh_honours_refresh_append_overlap
• crates/accelerators/accelerator-cayenne/src/lib.rs at v2.2.0 — the release that still carries the rejection

Original documentation of the limitation: #2138.

Test plan

• cd website && npm run build passes (#limitations still exists on the 2.2.x Cayenne page)
• Cross-page + cross-version sweep: grep -rln "Not supported by the Spice Cayenne" website/ now returns only 2.1.x / 2.0.x / 1.11.x / 1.10.x / 1.9.x, all correct; grep -rn "Cayenne data accelerator does not yet support" website/ leaves no vNext hit
• Files updated: 5

[github-actions]

✅ Pull with Spice Passed

Passing checks:

• ✅ Title meets minimum length requirement (10 characters)
• ✅ Has at least one of the required labels: area/blog, area/docs, area/cookbook, dependencies
• ✅ No banned labels detected
• ✅ Has at least one assignee: claudespice

[github-actions]

🔍 Pull with Spice Failed

Passing checks:

• ✅ Title meets minimum length requirement (10 characters)
• ✅ Has at least one of the required labels: area/blog, area/docs, area/cookbook, dependencies
• ✅ No banned labels detected

Failed checks:

• ❌ At least one assignee is required for this pull request.

Please address these issues and update your pull request.

[github-actions]

🔍 Pull with Spice Failed

Passing checks:

• ✅ Title meets minimum length requirement (10 characters)
• ✅ Has at least one of the required labels: area/blog, area/docs, area/cookbook, dependencies
• ✅ No banned labels detected

Failed checks:

• ❌ At least one assignee is required for this pull request.

Please address these issues and update your pull request.

[github-actions]

🚀 deployed to https://839405f0.spiceai-org-website.pages.dev