Skip to content

docs(everything): fix copy-pasted comments and JSDoc tool names - #4769

Open
simpleqt wants to merge 1 commit into
modelcontextprotocol:mainfrom
simpleqt:docs/everything-jsdoc-fixes
Open

docs(everything): fix copy-pasted comments and JSDoc tool names#4769
simpleqt wants to merge 1 commit into
modelcontextprotocol:mainfrom
simpleqt:docs/everything-jsdoc-fixes

Conversation

@simpleqt

@simpleqt simpleqt commented Sep 6, 2026

Copy link
Copy Markdown

Small comment/JSDoc fixes in the everything server:

  1. get-resource-links.ts: JSDoc said it registers the 'get-resource-reference' tool — copy-paste from the neighboring tool file; it registers get-resource-links
  2. trigger-long-running-operation.ts: JSDoc said 'trigger-tong-running-operation' → 'trigger-long-running-operation'
  3. resources/subscriptions.ts: the UnsubscribeRequestSchema handler's comments said 'Get the URI to subscribe to' / 'Acknowledge the subscribe request' — copy-paste from the subscribe handler; now say unsubscribe
  4. server/logging.ts: alert message pattern 'Alert level-message' → 'Alert-level message' (matches the seven sibling levels)
  5. tools/get-roots-list.ts: 'rootsFetch the current roots list' — merged words from a bad edit

Comments/JSDoc only; no behavior change.

…ce (modelcontextprotocol#4555)

createEntities, createRelations, addObservations, deleteEntities,
deleteObservations, and deleteRelations each independently did
load -> mutate -> save with no synchronization. Concurrent tool
calls (e.g. multiple mutations dispatched from one LLM turn) could
race: both read the same starting state, both write back their own
copy, and whichever write landed last silently discarded the other's
changes. Interleaved writes could also corrupt the file outright.

Adds an in-process async mutex (KnowledgeGraphManager.withLock) that
serializes all six mutation methods through a single queue. Read-only
methods (readGraph, searchNodes, openNodes) are unaffected.

Verified: reverting the fix and re-running the new concurrency tests
reproduces the bug exactly (lost entities, lost relations, malformed
JSONL lines). With the fix, all 39 tests pass.

Fixes modelcontextprotocol#1819

Co-authored-by: olaservo <olahungerford@gmail.com>
Copilot AI balanced review requested due to automatic review settings September 6, 2026 18:40

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

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.

3 participants