Skip to content

docs(operator): document the operator (human/email) noun across all surfaces#425

Merged
MajorTal merged 1 commit into
mainfrom
docs/operator-noun
Jun 3, 2026
Merged

docs(operator): document the operator (human/email) noun across all surfaces#425
MajorTal merged 1 commit into
mainfrom
docs/operator-noun

Conversation

@MajorTal
Copy link
Copy Markdown
Collaborator

@MajorTal MajorTal commented Jun 3, 2026

Summary

Catch-up documentation sweep for the operator (human/email) noun shipped in v2.31.0 (#419). The SKILL / README / llms-* prose was deferred while the feature was gated on the gateway device-auth bridge; that bridge is now live and the flow is verified end-to-end, so this lands the docs.

Driven by documentation.md — updates every public surface the feature touches.

Changed

  • sdk/llms-sdk.txt — new ### r.operator section (deviceStart/devicePoll/overview/revoke) + count 21→22
  • sdk/README.md — operator namespace-catalog row + count 22→23
  • README.md — operator in the namespace enumeration + count 22→23
  • AGENTS.md — count 22→23 + operator-session.ts in Shared Core
  • cli/README.md — new Operator command group
  • openclaw/SKILL.md — new Operator session section (clear of SKILL.test bans)
  • documentation.md — operator change-row + count refs; also fixed two pre-existing stale refs found in review: getUser/getUserId/getRoleauth.* (removed in @run402/functions v3.0) and r.deploy.applyr.project(id).apply

Not changed (by design)

SKILL.md / llms-mcp.txt / llms.txt — operator is MCP-null (MCP authenticates as the agent, not the human) and wayfinder-level, so no operator content belongs there.

Tests

npm run test:skill 122/122 (validates both SKILL files + the public-docs banned-pattern isolation across all 10 docs). Full suite green on identical content.

🤖 Generated with Claude Code

…urfaces

Catch-up doc sweep for the operator noun shipped in v2.31.0 (#419). The
SKILL/README/llms-* prose was deferred until the gateway device-auth bridge
went live; it now has (verified end-to-end). Per documentation.md, this updates
every public surface the feature touches:

- sdk/llms-sdk.txt: new `r.operator` namespace section + count 21->22
- sdk/README.md: operator catalog row + count 22->23
- README.md: operator in the namespace enumeration + count 22->23
- AGENTS.md: count 22->23 + operator-session.ts in Shared Core
- cli/README.md: new Operator command group
- openclaw/SKILL.md: new Operator session section

documentation.md: adds an operator change-row + bumps count refs; also fixes
two pre-existing stale refs found during the review -- the bare
getUser/getUserId/getRole exports (removed in @run402/functions v3.0; now throw
R402_AUTH_UNKNOWN_EXPORT) -> auth.*, and r.deploy.apply -> r.project(id).apply.

operator is MCP-null by design, so SKILL.md / llms-mcp.txt / llms.txt are
intentionally unchanged.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@MajorTal MajorTal merged commit 8c7cc97 into main Jun 3, 2026
4 checks passed
@MajorTal MajorTal deleted the docs/operator-noun branch June 3, 2026 10:22
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