docs: fix cache-service frontmatter, knowledge dead links, TCK glossary term (#1880 follow-up)#3279
Merged
Merged
Conversation
…ry term (#1880 follow-up) Three doc-accuracy fixes the #1880 audit surfaced but whose hard rules (preserve-frontmatter / no-fabrication) blocked in PR #3243: - kernel/contracts/cache-service.mdx frontmatter: drop "namespaces, and bulk operations" — the ICacheService contract only exposes get/set/delete/has/clear/stats (packages/spec/src/contracts/cache-service.ts). - protocol/knowledge.mdx: repoint 3 references from the removed `ai-capabilities.mdx` (dead since the docs reorg) to the real `actions-as-tools.mdx`, dropping the stale anchor. - getting-started/glossary.mdx: qualify the "TCK (Technology Compatibility Kit)" entry as planned / not-yet-implemented (grep-empty across packages). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012urEihGTAsQP2xizAqfCwt
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
github-actions
Bot
added
documentation
os-zhuang
marked this pull request as ready for review
July 19, 2026 13:13
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Small doc-accuracy follow-up to the #1880 implementation-accuracy audit (PR #3243, now merged). These three fixes were surfaced by that audit but its hard rules blocked them — preserve-frontmatter and no-fabrication — so they were carved out into this separate PR.
Fixes
kernel/contracts/cache-service.mdxfrontmatter — dropped "namespaces, and bulk operations" from thedescription. TheICacheServicecontract only exposesget/set(with optionalttl) /delete/has/clear/stats(packages/spec/src/contracts/cache-service.ts:35-68); TTL is real, namespaces and bulk ops are not. (The body Callout already said as much — the frontmatter was the last place still over-promising.) The audit couldn't touch this under the preserve-frontmatter rule.protocol/knowledge.mdx— repointed 3 references fromai-capabilities.mdx(a dead link since the docs reorg removed that file) to the realactions-as-tools.mdx, which covers permission-aware execution (its "Permission model" section). Dropped the stale#permission-aware-execution-rls-for-agentsanchor rather than guess a new one — the audit's no-fabrication rule had left these untouched.getting-started/glossary.mdx— qualified the "TCK (Technology Compatibility Kit)" entry as planned / not-yet-implemented. "TCK" / "Technology Compatibility Kit" is grep-empty acrosspackages/— there is no such certification mechanism today.Surgical, frontmatter-and-slug preserving; 3 files, ±5 lines. Draft for maintainer review.
🤖 Generated with Claude Code
https://claude.ai/code/session_012urEihGTAsQP2xizAqfCwt
Generated by Claude Code