Skip to content

docs: fix cache-service frontmatter, knowledge dead links, TCK glossary term (#1880 follow-up) - #3279

Merged
os-zhuang merged 1 commit into
mainfrom
claude/docs-1880-followups
Jul 19, 2026
Merged

docs: fix cache-service frontmatter, knowledge dead links, TCK glossary term (#1880 follow-up)#3279
os-zhuang merged 1 commit into
mainfrom
claude/docs-1880-followups

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

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.mdx frontmatter — dropped "namespaces, and bulk operations" from the description. The ICacheService contract only exposes get / set (with optional ttl) / 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 from ai-capabilities.mdx (a dead link since the docs reorg removed that file) to the real actions-as-tools.mdx, which covers permission-aware execution (its "Permission model" section). Dropped the stale #permission-aware-execution-rls-for-agents anchor 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 across packages/ — 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

…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
@vercel

vercelBot commented Jul 19, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
specReadyReadyPreview, CommentJul 19, 2026 1:20pm

Request Review

@github-actionsgithub-actionsBot added documentation Improvements or additions to documentation size/s labels Jul 19, 2026
@os-zhuang
os-zhuang marked this pull request as ready for review July 19, 2026 13:13
@os-zhuang
os-zhuang merged commit 6d6fc35 into mainJul 19, 2026
15 checks passed
@os-zhuang
os-zhuang deleted the claude/docs-1880-followups branch July 19, 2026 13:25
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@os-zhuang@claude