Skip to content

docs: writes honour the per-call workspace override - #9

Merged
chicagobuss merged 1 commit into
mainfrom
docs/workspace-write-override
Aug 3, 2026
Merged

docs: writes honour the per-call workspace override#9
chicagobuss merged 1 commit into
mainfrom
docs/workspace-write-override

Conversation

@chicagobuss

Copy link
Copy Markdown
Owner

web/usage.md (served at /llms.txt and /usage.md) still told agents:

To read elsewhere without reconnecting, pass workspace to any read tool […] Writes ignore it and always target your own workspace

That stopped being true in #8. mcp.go:100 applies scopeOverride to every non-registry tool, so all eight write tools honour workspace and place the write where it names.

The stale sentence is load-bearing for agents — it is the doc they are pointed at — and it caused a wrong conclusion today before the code was checked.

Verified against a running v1.4.3

Created, soft-deleted, restored and hard-deleted a probe document in test-temp-ws from a default-pinned connection. It resolved in test-temp-ws and returned not found in default throughout, and hard delete correctly rejected a mismatched confirm.

This PR

  • Lists the eight write tools that honour workspace
  • Notes that list_workspaces / create_workspace legitimately ignore it, acting on the registry rather than inside a workspace
  • Keeps the recommendation to pin a connection with X-Workspace for sustained work

Docs only; no behaviour change.

usage.md still said writes ignore the workspace argument and always target the
connection's own workspace. That stopped being true in #8: mcp.go applies
scopeOverride to every non-registry tool, so create_doc, update_doc, retag_doc,
soft_delete_doc, restore_doc, hard_delete_doc, create_folio and add_folio_file
all place the write in the named workspace.

Verified against a running v1.4.3 by creating, soft-deleting, restoring and
hard-deleting a probe document in another workspace from a default-pinned
connection: it resolved there throughout and returned not found in default.

Also notes the two registry tools that legitimately ignore it, and keeps the
recommendation to pin a connection for sustained work.
@chicagobuss
chicagobuss merged commit 0a493db into main Aug 3, 2026
3 checks passed
@chicagobuss
chicagobuss deleted the docs/workspace-write-override branch August 3, 2026 20:53
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