docs(readme): note npx/ephemeral invocation under daemon model - #1541
Open
wassolles wants to merge 1 commit into
Open
docs(readme): note npx/ephemeral invocation under daemon model#1541wassolles wants to merge 1 commit into
wassolles wants to merge 1 commit into
Conversation
Under v0.10+'s daemon model, a client launched via npx runs from an ephemeral
cache path the daemon cannot fingerprint, so it is rejected as
image_unverifiable and dies after its admission timeout with no JSON-RPC on
stdout (surfaced by MCP clients as a silent -32000: Connection closed).
Document the cause and the managed-install workaround in two places:
- Session Coordination Daemon: a paragraph next to the existing
package-manager/admission-barrier discussion.
- Troubleshooting table: a row for the -32000 symptom.
Refs DeusData#1539
Signed-off-by: wassolles <136268174+wassolles@users.noreply.github.com>
|
Thanks for opening this — it has been seen, and it is queued. This note is automated, but it is not a brush-off: it exists so you know where your PR stands instead of having to guess from silence. Current review status: working through a backlog. What that means for this PR, concretely:
Things that will genuinely speed it up whenever review does happen:
If this fixes a bug, a reproduction we can run is worth more than a description of the symptom. Thanks for contributing, and sorry in advance for the wait. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Docs-only PR adding the "npx / ephemeral invocation under the daemon model" note requested in #1539, so people hitting
-32000: Connection closedtoday can find the cause and the managed-install fix.Under v0.10+'s daemon model, a client launched via
npx -y codebase-memory-mcpruns from an ephemeral package cache (~/.npm/_npx/<hash>/...). The daemon's admission barrier fingerprints each connecting client's running executable, and an ephemeral cache binary can't be fingerprinted, so the daemon rejects it asimage_unverifiable. The rejected client then waits for admission until its timeout and exits with no JSON-RPC on stdout, which MCP clients surface as a silent connection failure (e.g.-32000: Connection closed). A managed install (codebase-memory-mcp install) places the binary at a stable, fingerprintable path and works.Changes (README.md only, +3 lines)
npxinvocation is rejected and pointing to the managed install.-32000/ silent-startup symptom with the managed-install fix, cross-linked to the daemon section.Scope
Docs only — no code, no behavior change, no new dependencies, no tool/ABI surface. Does not close #1539 (the code-level fail-open/loud-failure work is separate); this only documents the current behavior and workaround as @maintainer asked for in #1539.
Refs #1539.
Verification
npxand the success via the managed binary on Linux x86_64 (WSL2,ptrace_scope=1); details in the #1539 root-cause comment.#installation,#session-coordination-daemon) resolve to existing headings.DCO: commit signed off (
Signed-off-by: wassolles <136268174+wassolles@users.noreply.github.com>).