test(e2e): per-stub TODO markers instead of section comments

Author: felixweinberger

test/e2e/requirements.ts

@@ -2871,8 +2871,6 @@ export const REQUIREMENTS: Record<string, Requirement> = {
         ]
     },
 
-    // === Superseding 2026-07-28 requirements (added by the supersedes round; addedInSpecVersion gates them out of the 2025-11-25 matrix until 2026 joins ALL_SPEC_VERSIONS) ===
-
     'protocol:envelope:undeclared-capability-32003': {
         addedInSpecVersion: '2026-07-28',
         supersedes: ['lifecycle:capability:client-not-declared'],

test/e2e/scenarios/elicitation.test.ts

@@ -826,10 +826,11 @@ verifies('elicitation:capability:not-declared', async ({ transport }: TestArgs)
     expect(tap.received.filter(m => 'method' in m && m.method === 'elicitation/create')).toEqual([]);
 });
 
-// --- 2026-07-28 superseding requirement stubs (register zero cells until 2026 joins ALL_SPEC_VERSIONS) ---
 verifies('mrtr:caps-gated-elicitation-mode', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error('stub: not yet asserted — assert the server omits elicitation inputRequests for modes the client did not declare');
 });
 verifies('mrtr:url-elicitation-flow', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error('stub: not yet asserted — assert URL elicitation rides inputRequests with requestState and completes on retry');
 });

test/e2e/scenarios/handler-context.test.ts

@@ -166,7 +166,7 @@ verifies('hosting:context:web-request-headers', async (_args: TestArgs) => {
     }
 });
 
-// --- 2026-07-28 superseding requirement stubs (register zero cells until 2026 joins ALL_SPEC_VERSIONS) ---
 verifies('typescript:mcpserver:tool:extra-sessionless', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error('stub: not yet asserted — assert the 2026 handler context carries no session identifier');
 });

test/e2e/scenarios/hosting-http.test.ts

@@ -1037,10 +1037,11 @@ verifies('hosting:http:send-no-listener-noop', async (_args: TestArgs) => {
     }
 });
 
-// --- 2026-07-28 superseding requirement stubs (register zero cells until 2026 joins ALL_SPEC_VERSIONS) ---
 verifies('hosting:sessionless:delete-405', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error('stub: not yet asserted — assert DELETE on the 2026 MCP endpoint returns 405');
 });
 verifies('hosting:sessionless:no-batching', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error('stub: not yet asserted — assert a JSON-RPC batch-array POST is rejected with 400 in 2026 mode');
 });

test/e2e/scenarios/lifecycle.test.ts

@@ -560,22 +560,27 @@ verifies('lifecycle:capability:strict-mode-throws', async ({ transport }: TestAr
     }
 });
 
-// --- 2026-07-28 superseding requirement stubs (register zero cells until 2026 joins ALL_SPEC_VERSIONS) ---
 verifies('discover:basic', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error('stub: not yet asserted — assert server/discover returns supportedVersions, capabilities, and serverInfo');
 });
 verifies('discover:instructions-passthrough', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error('stub: not yet asserted — assert DiscoverResult.instructions is exposed on the client');
 });
 verifies('discover:capabilities-match-registrations', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error('stub: not yet asserted — assert DiscoverResult.capabilities matches the registered handlers');
 });
 verifies('lifecycle:version:2026-negotiable', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error('stub: not yet asserted — assert both sides agree on and report the 2026 version');
 });
 verifies('lifecycle:version:client-retries-from-supported', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error('stub: not yet asserted — assert the client retries with a version from supported[] on -32004');
 });
 verifies('lifecycle:version:unsupported-error', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error('stub: not yet asserted — assert the server returns -32004 with data.supported[] (HTTP 400 on streamable HTTP)');
 });

test/e2e/scenarios/logging.test.ts

@@ -227,7 +227,7 @@ verifies('logging:out-of-band:basic', async ({ transport }: TestArgs) => {
     expect(received).toEqual([{ level: 'info', logger: 'job-runner', data: 'nightly index rebuild started' }]);
 });
 
-// --- 2026-07-28 superseding requirement stubs (register zero cells until 2026 joins ALL_SPEC_VERSIONS) ---
 verifies('logging:per-request:level-respected', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error('stub: not yet asserted — assert per-request _meta logLevel filters the emitted log notifications for that request');
 });

test/e2e/scenarios/protocol.test.ts

@@ -1679,20 +1679,23 @@ verifies('protocol:transport-callbacks:wrappable-after-connect', async ({ transp
     }
 });
 
-// --- 2026-07-28 superseding requirement stubs (register zero cells until 2026 joins ALL_SPEC_VERSIONS) ---
 verifies('protocol:envelope:undeclared-capability-32003', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error(
         'stub: not yet asserted — assert -32003 MissingRequiredClientCapabilityError when a required capability is absent from _meta'
     );
 });
 verifies('protocol:envelope:ctx-capabilities-readable', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error('stub: not yet asserted — assert a handler reads the per-request client capabilities from its context');
 });
 verifies('protocol:request-id:outstanding-scope', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error(
         'stub: not yet asserted — assert an id may be reused once its response arrived; collisions among in-flight requests are rejected'
     );
 });
 verifies('protocol:cancel:sse-close-cancels', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error('stub: not yet asserted — assert closing the SSE response stream mid-request fires the handler abort signal');
 });

test/e2e/scenarios/resources.test.ts

@@ -746,10 +746,11 @@ verifies('mcpserver:resource:metadata-override', async ({ transport }: TestArgs)
     });
 });
 
-// --- 2026-07-28 superseding requirement stubs (register zero cells until 2026 joins ALL_SPEC_VERSIONS) ---
 verifies('subscriptions:resource-updates-via-listen', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error('stub: not yet asserted — assert a resourceSubscriptions filter on subscriptions/listen delivers resources/updated');
 });
 verifies('subscriptions:cancel-stops-delivery', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error('stub: not yet asserted — assert no further notifications are delivered after the subscription is cancelled');
 });

test/e2e/scenarios/roots.test.ts

@@ -170,7 +170,7 @@ verifies('roots:list-changed', async ({ transport }: TestArgs) => {
     expect(refetched[1]?.roots).toEqual(roots);
 });
 
-// --- 2026-07-28 superseding requirement stubs (register zero cells until 2026 joins ALL_SPEC_VERSIONS) ---
 verifies('mrtr:roots-via-input-required', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error('stub: not yet asserted — assert roots are requested via a ListRootsRequest inside an InputRequiredResult');
 });

test/e2e/scenarios/sampling.test.ts

@@ -578,18 +578,20 @@ verifies('sampling:create:not-supported', async ({ transport }: TestArgs) => {
     expect(tap.received.filter(m => 'method' in m && m.method === 'sampling/createMessage')).toEqual([]);
 });
 
-// --- 2026-07-28 superseding requirement stubs (register zero cells until 2026 joins ALL_SPEC_VERSIONS) ---
 verifies('mrtr:input-request:sampling', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error(
         'stub: not yet asserted — assert a CreateMessageRequest inside an InputRequiredResult routes to the sampling callback and keys the retry'
     );
 });
 verifies('mrtr:caps-gated-sampling-tools', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error(
         'stub: not yet asserted — assert the server omits tool-enabled sampling inputRequests for clients without the sampling.tools capability'
     );
 });
 verifies('mrtr:caps-gated-inputrequests', async () => {
+    // TODO(2026-07-28, @felixweinberger): to be implemented for 2026-07-28 spec release
     throw new Error(
         'stub: not yet asserted — assert the server never sends inputRequests for capabilities the client did not declare in _meta'
     );