Skip to content

Commit 514aa9f

Browse files
committed
docs: fix cache-service frontmatter, knowledge dead links, TCK glossary 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
1 parent 3ca5320 commit 514aa9f

3 files changed

Lines changed: 5 additions & 5 deletions

File tree

content/docs/getting-started/glossary.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -157,4 +157,4 @@ The default sharing level (Security Protocol) for records in an object. Determin
157157
A hierarchical access control model (Security Protocol) that grants data access based on geographic or organizational boundaries.
158158

159159
### TCK (Technology Compatibility Kit)
160-
A suite of tests that validates if a Driver or Renderer complies with the official ObjectStack Protocol. If a new driver passes the TCK, it is certified as compatible.
160+
A **planned** suite of tests that would validate whether a Driver or Renderer complies with the official ObjectStack Protocol, certifying a passing driver as compatible. _Not yet implemented — there is no TCK program or certification mechanism in the codebase today._

content/docs/kernel/contracts/cache-service.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: ICacheService Contract
3-
description: Reference for the Cache Service contract — key-value caching with TTL support, namespaces, and bulk operations
3+
description: Reference for the Cache Service contract — key-value caching with TTL support
44
---
55

66
# ICacheService Contract

content/docs/protocol/knowledge.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -169,7 +169,7 @@ interface IKnowledgeService {
169169

170170
`KnowledgeSearchOptions` includes `sourceIds`, `topK`, `filter`, and
171171
the all-important `executionContext` (from the permission-aware tool
172-
execution work — see `ai-capabilities.mdx`). `KnowledgeReindexOptions`
172+
execution work — see `actions-as-tools.mdx`). `KnowledgeReindexOptions`
173173
accepts `dryRun` and `limit`; `reindexSource` returns a
174174
`KnowledgeReindexResult` (`indexed`, `discovered`, `ok`, …).
175175

@@ -255,7 +255,7 @@ IKnowledgeService.search(q, { executionContext, sourceIds })
255255
```
256256

257257
This is the same pattern as the existing permission-aware data tools
258-
(see `ai-capabilities.mdx#permission-aware-execution-rls-for-agents`).
258+
(see `actions-as-tools.mdx`).
259259
No matter how aggressive an adapter's retrieval is, the user never
260260
sees a chunk extracted from a record they can't read.
261261

@@ -347,7 +347,7 @@ internally (RAGFlow, Dify, Vectara).
347347

348348
## 10. Related documents
349349

350-
- `ai-capabilities.mdx#permission-aware-execution-rls-for-agents`
350+
- `actions-as-tools.mdx`
351351
the `ExecutionContext` threading the Knowledge Protocol reuses.
352352
- `architecture.mdx` — overall service / plugin layering.
353353
- `packages/spec/src/ai/embedding.zod.ts` — pre-existing embedding /

0 commit comments

Comments
 (0)