gabriel / musehub public
docs BREAKING mcp task/252-mcp-qa-v2 #1 / 1
AI Agent gabriel · 9 days ago · Nov 7, 2026 · Diff

docs(mcp): #252 MCP Tooling QA contract v2 — correct /muse/mcp against the live server, registry-rendered tool matrix, elicitation sequence, contract tests

105-claim audit (V60 I26 B8 M9 A1 N1) executed against the real /mcp router, session/context/elicitation modules, the stdio server, read-only staging probes and a disposable PostgreSQL race (musehub#252).

- Launch: `muse hub mcp` does not exist in Muse 0.2.1rc20; document the real paths (hosted /mcp, self-hosted stdio with DATABASE_URL) with an explicit not-available callout (owner decision on a launcher stays open). - Counts, groups, auth, agent scope and hints render from the registry (ui_docs.py::_mcp_catalogue, V3 matrix). - Elicitation rewritten from the transcript (GET push channel, elicit-{n}-{hex} IDs, real schema, decline = elicitation_declined); V1 sequence figure. - Auth, origins, error envelope, SSE frames and session behaviour corrected; known defects kept as contract plus warning: musehub#289 #290 #291 #292 #293 #294 #295 #300. - tests/docs_contract/test_mcp.py (DOC_MCP_04-08, strict xfails for #289-#295); `mcp` removed from _CLI_DEFECTS and _BROKEN_ANCHORS; page-scoped styles appended to _mcp-docs.scss (AA, no table scrolling).

Co-Authored-By: Claude Opus 5.5 <[email protected]>

sha256:417ffbc1d6761e3a4cd26ca5475d5a0b786ae8af936912b5ce31121e2e55c19a sha
+159 ~16 −12 symbols
6 changed · 1185 in snapshot files
sha256:977f60d75c7595f0a959813fac4312b75a2a15cce33d6aa4afdf494b40658ba4 snapshot
+159
symbols added
~16
symbols modified
−12
symbols removed
6
files changed
1185
files in snapshot
0
dead code introduced
Semantic Changes 187 symbols
~ tests/docs_contract/test_mcp.py .py 71 symbols added
+ HUB_ISSUES variable variable HUB_ISSUES L37–37
+ INIT variable variable INIT L41–43
+ PAGE variable variable PAGE L36–36
+ TestCatalogue class class TestCatalogue L94–146
+ test_group_counts_equal_the_registry method method test_group_counts_equal_the_registry L95–106
+ test_matrix_auth_scope_and_hints_match_the_gates_and_tools_list method method test_matrix_auth_scope_and_hints_match_the_gates_and_tools_list L108–125
+ test_resource_and_prompt_counts method method test_resource_and_prompt_counts L127–133
+ test_schema_example_is_the_registry_schema method method test_schema_example_is_the_registry_schema L140–146
+ test_server_version_is_the_served_one method method test_server_version_is_the_served_one L135–138
+ TestElicitation class class TestElicitation L317–351
+ test_accept_continues_into_the_review method method test_accept_continues_into_the_review L335–337
+ test_cancellation_is_keyed_by_request_id method method test_cancellation_is_keyed_by_request_id L339–351
+ test_decline_is_an_error_not_a_fallback method method test_decline_is_an_error_not_a_fallback L330–333
+ test_form_frame_matches_the_worked_example method method test_form_frame_matches_the_worked_example L318–328
+ TestKnownDefects class class TestKnownDefects L382–465
+ test_a_session_survives_a_request_on_another_worker method method test_a_session_survives_a_request_on_another_worker L389–397
+ test_destructive_tools_are_annotated method method test_destructive_tools_are_annotated L427–430
+ test_elicitation_complete_resolves_a_url_elicitation method method test_elicitation_complete_resolves_a_url_elicitation L409–423
+ test_events_carry_no_id_today method method test_events_carry_no_id_today L399–401
+ test_every_known_issue_links_its_ticket method method test_every_known_issue_links_its_ticket L383–386
+ test_gate_errors_carry_an_error_code method method test_gate_errors_carry_an_error_code L462–465
+ test_last_event_id_replays_later_events method method test_last_event_id_replays_later_events L404–406
+ test_one_dimension_vocabulary method method test_one_dimension_vocabulary L453–459
+ test_progress_echoes_the_request_token method method test_progress_echoes_the_request_token L433–450
+ TestLaunch class class TestLaunch L162–185
+ test_documented_stdio_command_answers_initialize method method test_documented_stdio_command_answers_initialize L171–185
+ test_the_muse_cli_has_no_mcp_launcher method method test_the_muse_cli_has_no_mcp_launcher L163–165
+ test_the_page_documents_no_launcher_command method method test_the_page_documents_no_launcher_command L167–169
+ TestPage class class TestPage L471–494
+ test_coordination_defaults method method test_coordination_defaults L488–494
+ test_every_sidebar_section_exists method method test_every_sidebar_section_exists L478–481
+ test_sequence_figure_steps method method test_sequence_figure_steps L483–486
+ test_superseded_claims_are_gone method method test_superseded_claims_are_gone L472–476
+ TestTransport class class TestTransport L196–288
+ test_every_msign_example_carries_alg method method test_every_msign_example_carries_alg L275–277
+ test_get_and_delete method method test_get_and_delete L243–247
+ test_initialize_result_and_session_header method method test_initialize_result_and_session_header L197–205
+ test_jsonrpc_error_codes method method test_jsonrpc_error_codes L249–259
+ test_malformed_msign_header_is_rejected method method test_malformed_msign_header_is_rejected L261–273
+ test_msign_tool_without_signature method method test_msign_tool_without_signature L231–241
+ test_origins_match_exactly method method test_origins_match_exactly L223–224
+ test_protocol_version_header method method test_protocol_version_header L227–229
+ test_session_properties method method test_session_properties L207–214
+ test_stateless_requests_and_unknown_sessions method method test_stateless_requests_and_unknown_sessions L216–219
+ test_tool_error_codes_on_the_page_are_emitted method method test_tool_error_codes_on_the_page_are_emitted L279–288
+ XFAIL variable variable XFAIL L39–39
+ _TICKETS variable variable _TICKETS L38–38
+ _call function function _call L84–88
+ _html_raw function function _html_raw L188–190
+ _progress_frames function async_function _progress_frames L357–379
+ _review function async_function _review L298–314
+ _rows function function _rows L51–53
+ _rows_text function function _rows_text L149–156
+ _run function function _run L294–295
+ _section function function _section L56–57
+ client function function client L64–74
+ html function function html L47–48
+ FastAPI import import FastAPI L30–30
+ Iterator import import Iterator L27–27
+ TestClient import import TestClient L31–31
+ annotations import import annotations L19–19
+ asyncio import import asyncio L21–21
+ cc import import cc L33–33
+ json import import json L22–22
+ os import import os L23–23
+ pytest import import pytest L29–29
+ rc import import rc L34–34
+ re import import re L24–24
+ subprocess import import subprocess L25–25
+ sys import import sys L26–26
+ sid function function sid L78–81
~ musehub/api/routes/musehub/ui_docs.py .py 4 symbols added, 1 symbol modified
+ _McpGroup class class _McpGroup L681–684
+ _McpTool class class _McpTool L671–678
+ _mcp_catalogue function function _mcp_catalogue L688–755
+ functools function import functools L9–9
~ musehub/templates/musehub/pages/docs_muse_mcp.html .html 37 symbols added, 12 symbols removed, 11 symbols modified
− aside@13 section aside@13 L13–36
− h2: Launching the server section h2: Launching the server L114–114
− h3: Claude Desktop section h3: Claude Desktop L164–164
− h3: Cursor section h3: Cursor L187–187
− h3: Event wire format (HTML Living Standard) section h3: Event wire format (HTML Living Standard) L509–509
− h3: HTTP Streamable (generic client) section h3: HTTP Streamable (generic client) L200–200
− h3: HTTP Streamable — production section h3: HTTP Streamable — production L86–86
− h3: Input schema pattern section h3: Input schema pattern L302–302
− h3: Stdio — local development section h3: Stdio — local development L76–76
− h3: Tool annotations (MCP 2025-11-25) section h3: Tool annotations (MCP 2025-11-25) L292–292
− h3: Tool-level error envelope section h3: Tool-level error envelope L635–635
− h3: curl — open the SSE channel section h3: curl — open the SSE channel L529–529
+ aside@17 section aside@17 L17–42
+ caption: Tools per group section caption: Tools per group L319–319
+ key }} section details#tools-{{ g.key }} L340–355
+ div#claim-race-warning section div#claim-race-warning L398–408
+ div#launch-not-available section div#launch-not-available L138–149
+ div#overview section div#overview L53–64
+ div#session-affinity-warning section div#session-affinity-warning L241–252
+ div#sse-replay-warning section div#sse-replay-warning L633–641
+ div#url-elicitation-warning section div#url-elicitation-warning L537–546
+ h2: Coordination tools section h2: Coordination tools L383–383
+ h2: Known issues in this release section h2: Known issues in this release L763–763
+ h2: Running the server section h2: Running the server L136–136
+ h3: Claude Desktop and Cursor (stdio, self-hosted) section h3: Claude Desktop and Cursor (stdio, self-hosted) L176–176
+ h3: Event wire format section h3: Event wire format L581–581
+ h3: HTTP Streamable (any client) section h3: HTTP Streamable (any client) L200–200
+ h3: Input schema example section h3: Input schema example L374–374
+ h3: Stdio — self-hosted MuseHub only section h3: Stdio — self-hosted MuseHub only L83–83
+ h3: Streamable HTTP — the hosted hub section h3: Streamable HTTP — the hosted hub L102–102
+ h3: Tool annotations section h3: Tool annotations L359–359
+ h3: Tool-level error result section h3: Tool-level error result L725–725
+ h3: curl — open the push channel section h3: curl — open the push channel L607–607
+ section#coordination section section#coordination L382–409
+ section#known-issues section section#known-issues L762–783
+ tools|length }} tools section summary: {{ g.label }} — {{ g.tools|length }} tools L341–341
+ table#annotations section table#annotations L364–372
+ table#auth-matrix section table#auth-matrix L678–690
+ table#coord-defaults section table#coord-defaults L389–397
+ table#http-endpoints section table#http-endpoints L106–125
+ table#jsonrpc-errors section table#jsonrpc-errors L711–723
+ table#known-issues-table section table#known-issues-table L765–777
+ table#launch-paths section table#launch-paths L151–158
+ key }} section table#mcp-tools-{{ g.key }} L342–354
+ table#server-properties section table#server-properties L66–77
+ table#session-properties section table#session-properties L265–275
+ table#sse-events section table#sse-events L594–601
+ table#tool-error-codes section table#tool-error-codes L744–758
+ table#tool-groups section table#tool-groups L318–331
~ src/scss/components/_mcp-docs.scss .scss 47 symbols added, 2 symbols modified
+ (forced-colors: active) rule (forced-colors: active) L614–617
+ (max-width: 480px) rule (max-width: 480px) L583–587
+ (min-width: 769px) rule (min-width: 769px) L528–532
+ mcpcat__group rule .devdocs--mcp .mcpseq__step, .devdocs--mcp .mcpcat__group L615–616
+ devdocs-callout rule .devdocs-callout L561–564
+ devdocs-callout > div rule .devdocs-callout > div L565–565
+ tok-cmt rule .devdocs-code-block .tok-cmt L606–606
+ devdocs-code-block pre code rule .devdocs-code-block pre, .devdocs-code-block pre code L604–605
+ tok-kw rule .devdocs-code-block--output .tok-kw L607–607
+ devdocs-phase-desc rule .devdocs-phase-desc L590–593
+ devdocs-section :is(p, li) code rule .devdocs-section :is(p, li) code L602–602
+ devdocs-section :is(p, li, td) a rule .devdocs-section :is(p, li, td) a L595–600
+ devdocs-section :is(p, li, td) a:focus-visible rule .devdocs-section :is(p, li, td) a:focus-visible L599–599
+ devdocs-table rule .devdocs-table L569–588
+ devdocs--mcp rule .devdocs.devdocs--mcp L438–608
+ mcpcat__note code rule .docfig .mcpseq code, .docfig .mcpcat__note code L539–549
+ docfig a rule .docfig a L551–556
+ docfig a:focus-visible rule .docfig a:focus-visible L555–555
+ mcpcat__group rule .mcpcat__group L483–499
+ mcpcat__note rule .mcpcat__note L481–481
+ mcpcat__summary rule .mcpcat__summary L473–473
+ mcpcat__summary tr[data-group="total"] td rule .mcpcat__summary tr[data-group="total"] th, .mcpcat__summary tr[data-group="total"] td L474–475
+ mcpcat__table rule .mcpcat__summary, .mcpcat__table L439–471
+ mcpcat__table thead th:nth-child(1) rule .mcpcat__table thead th:nth-child(1) L477–477
+ mcpcat__table thead th:nth-child(2) rule .mcpcat__table thead th:nth-child(2) L478–478
+ mcpcat__table thead th:nth-child(3) rule .mcpcat__table thead th:nth-child(3) L479–479
+ mcpseq rule .mcpseq L502–511
+ mcpseq__lane rule .mcpseq__lane L537–537
+ mcpseq__step rule .mcpseq__step L513–525
+ before rule .mcpseq__step::before L524–524
+ mcpseq__step[data-channel="get"] rule .mcpseq__step[data-channel="get"] L534–534
+ mcpseq__step[data-channel="stream"] rule .mcpseq__step[data-channel="post"], .mcpseq__step[data-channel="stream"] L529–530
+ mcpseq__step[data-channel="stream"] rule .mcpseq__step[data-channel="stream"] L535–535
+ :not(pre) > code rule :not(pre) > code L603–603
+ > summary rule > summary L487–496
+ > summary:focus-visible rule > summary:focus-visible L495–495
+ > table rule > table L496–498
+ tok-acc) rule [data-theme="light"] .devdocs.devdocs--mcp .devdocs-code-block :is(.tok-kw, .tok-str, .tok-num, .tok-key, .tok-fn, .tok-type, .tok-var, .tok-punc, .tok-acc) L610–612
+ a rule a L591–591
+ caption rule caption L447–447
+ tbody th rule tbody th L463–463
+ td, td:first-child, td:nth-child(2), td code rule td, td:first-child, td:nth-child(2), td code L575–578
+ td:first-child rule td:first-child L579–579
+ td:first-child, td:nth-child(2) rule td:first-child, td:nth-child(2) L586–586
+ th, td rule th, td L580–581
+ th, td rule th, td L585–585
+ thead th rule thead th L462–462
~ code
~ th
Files Changed
+1 ~5
1185 in snapshot
← Older Oldest on task/252-mcp-qa-v2
All commits
Newer → Latest on task/252-mcp-qa-v2

0 comments

No comments yet. Be the first to start the discussion.

To add a comment, use the Muse CLI: muse hub commit comment sha256:417ffbc1d6761e3a4cd26ca5475d5a0b786ae8af936912b5ce31121e2e55c19a --body "your comment"