feat(mcp): add resource templates and a resources changed hook - #452

{
  "headSha": "8e5b23f875abd315968872962abead1f0c2317d9",
  "result": {
    "overallSummary": "Adds two new MCP route options — `resourceTemplates` (RFC 6570 level-1 URI templates served through `resources/templates/list`/`resources/read`) and `onResourcesChanged` (a host hook that pushes `notifications/resources/list_changed`) — and threads them through every MCP entry point (route options, hub, Next.js host, stdio, fetch handler), with a new DF0084 diagnostic, tests, docs and generated type snapshots.",
    "groups": [
      {
        "key": "mcp-resource-templates",
        "label": "Resource templates & hook",
        "summary": "Core implementation: compiles and matches `uriTemplate`s without regex/backtracking, serves them from `resources/list`/`resources/templates/list`/`resources/read`, adds the `onResourcesChanged` bridge to `bridgeListChanged`, defines the new types and the DF0084 diagnostic, and wires both options through `resolveMcpConfig`, the devframe/hub route mounting and the Next.js host so every MCP surface (HTTP fetch handler, stdio server, hub aggregate route) exposes them identically.",
        "category": "api",
        "filePaths": [
          "packages/agentic/src/mcp/build-server.ts",
          "packages/agentic/src/mcp/fetch.ts",
          "packages/devframe/src/types/mcp.ts",
          "packages/devframe/src/types/devframe.ts",
          "packages/devframe/src/node/diagnostics.ts",
          "packages/devframe/src/adapters/mcp.ts",
          "packages/devframe/src/adapters/_shared.ts",
          "packages/devframe/src/adapters/initiate.ts",
          "packages/hub/src/node/initiate.ts",
          "packages/next/src/host.ts"
        ],
        "critical": true,
        "fileNotes": [
          {
            "path": "packages/agentic/src/mcp/build-server.ts",
            "text": "`compileResourceTemplates`/`matchTemplate` implement RFC 6570 level-1 matching in one linear pass (no regex engine, no backtracking) so a crafted URI can't cause a pathological-time match; validation of the `uriTemplate` runs once at mount time and throws DF0084 for anything beyond a plain `{name}` expression.",
            "critical": true
          },
          {
            "path": "packages/agentic/src/mcp/fetch.ts",
            "text": "Templates are compiled once per endpoint (not per request) so an invalid template fails fast at mount time, and `onResourcesChanged` is wired into the same `bridgeListChanged` used for tool/resource change notifications."
          }
        ]
      },
      {
        "key": "tests",
        "label": "Tests",
        "summary": "Covers template listing/reading, parameter decoding and matching edge cases (percent-encoding, repeated/empty values, adjacent expressions, __proto__ names, ReDoS-style worst case), precedence over registered/shared-state resources, DF0084 for invalid templates, and `onResourcesChanged` notifying and unsubscribing on close, both in-memory, over Streamable HTTP, and through the hub's aggregate route.",
        "category": "tests",
        "filePaths": [
          "packages/agentic/src/mcp/__tests__/mcp-http.test.ts",
          "packages/agentic/src/mcp/__tests__/mcp-server.test.ts",
          "packages/hub/src/node/__tests__/initiate.test.ts"
        ]
      },
      {
        "key": "docs",
        "label": "Docs",
        "summary": "Documents the new `resourceTemplates` and `onResourcesChanged` route options and the new DF0084 error page.",
        "category": "docs",
        "filePaths": [
          "docs/content/1.guide/18.hub-initiate.md",
          "docs/content/2.adapters/7.mcp.md",
          "docs/content/6.errors/DF0084.md",
          "docs/content/6.errors/index.md"
        ]
      },
      {
        "key": "type-snapshots",
        "label": "Type snapshots",
        "summary": "Generated `.d.ts` snapshot updates reflecting the new public types and options; mechanical, follows directly from the type changes above.",
        "category": "other",
        "filePaths": [
          "tests/__snapshots__/tsnapi/@devframes/next/hub.snapshot.d.ts",
          "tests/__snapshots__/tsnapi/devframe/index.snapshot.d.ts",
          "tests/__snapshots__/tsnapi/devframe/internal.snapshot.d.ts",
          "tests/__snapshots__/tsnapi/devframe/types.snapshot.d.ts",
          "tests/__snapshots__/tsnapi/devframe/adapters/mcp.snapshot.d.ts"
        ]
      }
    ],
    "schemaVersion": 1,
    "source": "llm",
    "generatedAt": "2026-10-30T22:11:27.062Z",
    "model": "vercel-ai-gateway/anthropic/claude-sonnet-5",
    "locale": "en"
  }
}