GeezerVison

{
  "headSha": "04cc2af838a62cfaaf8186604d2f8006abf2ed11",
  "result": {
    "overallSummary": "Fixes a bug where a message-feed consumer reconnecting to a restarted Hub could reuse a stale version number and receive an incomplete delta instead of a full snapshot. The host now tags each result with an instance ID, and both the numeric version and the instance ID must match for a delta to be returned; otherwise a full snapshot is sent. Consumers, RPC plumbing, docs, tests and generated type snapshots are updated accordingly.",
    "groups": [
      {
        "key": "core-fix",
        "label": "Instance-aware listSince",
        "summary": "Core fix: the messages host now stamps each result with its own instance ID and only computes a delta when the caller's cursor matches that instance; otherwise it returns a full snapshot. This prevents a consumer reconnecting to a restarted Hub from applying a delta computed against a stale clock.",
        "category": "core",
        "filePaths": [
          "packages/hub/src/node/host-messages.ts",
          "packages/hub/src/types/messages.ts",
          "plugins/messages/src/node/rpc/functions/list.ts"
        ],
        "critical": true,
        "fileNotes": [
          {
            "path": "packages/hub/src/node/host-messages.ts",
            "text": "`listSince` now requires the instance ID to match before trusting the numeric cursor; a mismatch (including legacy callers that omit it) forces `full: true`.",
            "critical": true
          }
        ]
      },
      {
        "key": "consumers",
        "label": "Consumer cursor forwarding",
        "summary": "Both message-feed consumers (Hub UI panel and the plugin's client state) now store the returned `instanceId` alongside the version and pass it back on the next poll.",
        "category": "core",
        "filePaths": [
          "packages/hub-ui/src/client/state/messages.ts",
          "plugins/messages/app/client/state/messages.ts"
        ]
      },
      {
        "key": "tests",
        "label": "Tests for instance-scoped cursors",
        "summary": "Regression coverage for the fix: host-level tests for foreign/legacy cursors, RPC-level tests over a real server, and consumer tests verifying cache replacement and instance-ID forwarding in both readers.",
        "category": "tests",
        "filePaths": [
          "packages/hub-ui/src/client/state/messages.test.ts",
          "packages/hub/src/node/__tests__/host-messages.test.ts",
          "plugins/messages/test/dev-server.test.ts",
          "plugins/messages/test/message-state.test.ts"
        ]
      },
      {
        "key": "docs",
        "label": "Hub API docs",
        "summary": "Documents `listSince(version, instanceId)` usage and the full-snapshot fallback behavior.",
        "category": "docs",
        "filePaths": [
          "docs/content/8.references/6.hub-api.md"
        ]
      },
      {
        "key": "snapshots",
        "label": "Generated type snapshots",
        "summary": "Auto-generated public API snapshots updated to reflect the new `instanceId` parameter and field.",
        "category": "other",
        "filePaths": [
          "tests/__snapshots__/tsnapi/@devframes/hub/index.snapshot.d.ts",
          "tests/__snapshots__/tsnapi/@devframes/hub/node.snapshot.d.ts",
          "tests/__snapshots__/tsnapi/@devframes/hub/node.snapshot.js",
          "tests/__snapshots__/tsnapi/@devframes/hub/types.snapshot.d.ts",
          "tests/__snapshots__/tsnapi/@devframes/plugin-messages/rpc.snapshot.d.ts"
        ]
      }
    ],
    "schemaVersion": 1,
    "source": "llm",
    "generatedAt": "2026-11-05T08:55:38.206Z",
    "model": "vercel-ai-gateway/anthropic/claude-sonnet-5",
    "locale": "en"
  }
}