Skip to content

docs: README, agent skill and MCP hint after 1.0.2 and 1.0.3 - #25

Merged
leejpsd merged 1 commit into
mainfrom
docs/post-1.0.3
Nov 13, 2026
Merged

leejpsd merged 1 commit into
mainfrom
docs/post-1.0.3

Conversation

@leejpsd

@leejpsd leejpsd commented Nov 13, 2026

Copy link
Copy Markdown
Owner

Documentation follow-up to #17, #20, #21 and #23. No handler code changes.

  • README: note on Next.js 16.3.8+ route-scoped keys and the seed version they need, 1.0.2 and 1.0.3 in the version history, and which Next.js versions those releases were run against.
  • Agent skill: single-argument revalidateTag(tag) is a hard invalidation (it was listed as soft). Adds version checks for the 1.0.2 and 1.0.3 fixes.
  • MCP 0.1.3: the tag_state hint described expired as always hitting every entry kind. Since 1.0.2, expired next to stale is the soft deadline. Tool behaviour is unchanged.

Checked: root lint, typecheck, 196 unit tests; MCP typecheck and smoke test; and a live run against Redis where the MCP server's soft and hard invalidate_tag writes were read back by the 1.0.3 handler as STALE and MISS.

README: note on Next.js 16.3.8+ route-scoped keys and the seed version
they need, the 1.0.2 and 1.0.3 entries in the version history, and
which Next.js versions those releases were run against.

Agent skill: single-argument revalidateTag(tag) is a hard invalidation
(it was listed as soft). Add the version checks for the 1.0.2 and 1.0.3
fixes and what an unreachable Redis looks like from the caller's side.

MCP 0.1.3: the tag_state hint said a present 'expired' hits all entry
kinds. Since 1.0.2 an 'expired' next to 'stale' is the soft deadline
and only counts once it has passed. Tool behaviour is unchanged.
@leejpsd
leejpsd merged commit 3389fd3 into main Nov 13, 2026
5 checks passed
@leejpsd
leejpsd deleted the docs/post-1.0.3 branch November 13, 2026 07:22
@github-actions github-actions Bot mentioned this pull request Nov 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant