@fuxi-ailabs/crowdmemory-codex-plugin 0.0.0-stage → 0.1.1

package/contract/memory-agent-ingress-v1.schema.json

@@ -0,0 +1,2521 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://crowdmemory.local/schemas/agent/memory-agent-ingress-v1.schema.json",
+  "title": "memory-agent-ingress/v1 canonical event envelope",
+  "description": "Request body of POST /v1/agent-ingress/{adapter_id}/events/{kind}. Closed: unknown kinds and unknown fields are rejected before dispatch (spec FR-01). Responses are {ok:true,result} or {ok:false,error}; see x-results and $defs/response_<kind>. Idempotency: the same event_id with an identical body returns the original result; with a different body it is rejected with idempotency_conflict.",
+  "x-contract-id": "memory-agent-ingress/v1",
+  "x-protocol-major": 1,
+  "x-route": "/v1/agent-ingress/{adapter_id}/events/{kind}",
+  "x-l0-kinds": [
+    "session.start",
+    "step.before",
+    "tool.result",
+    "context.compaction",
+    "subagent.end",
+    "note",
+    "query",
+    "session.end"
+  ],
+  "x-capability-disabled-kinds": [
+    "workflow.start",
+    "workflow.phase",
+    "workflow.agent.start",
+    "workflow.agent.end",
+    "workflow.end",
+    "goal.changed"
+  ],
+  "x-error-codes": [
+    "bad_request",
+    "unknown_kind",
+    "schema_invalid",
+    "unauthorized",
+    "session_unbound",
+    "idempotency_conflict",
+    "capability_disabled",
+    "not_found",
+    "budget_exhausted",
+    "note_rejected",
+    "unavailable",
+    "internal"
+  ],
+  "x-payloads": {
+    "session.start": "#/$defs/payload_session_start",
+    "step.before": "#/$defs/payload_step_before",
+    "tool.result": "#/$defs/payload_tool_result",
+    "context.compaction": "#/$defs/payload_context_compaction",
+    "subagent.end": "#/$defs/payload_subagent_end",
+    "note": "#/$defs/payload_note",
+    "query": "#/$defs/payload_query",
+    "workflow.start": "#/$defs/payload_workflow_start",
+    "workflow.phase": "#/$defs/payload_workflow_phase",
+    "workflow.agent.start": "#/$defs/payload_workflow_agent_start",
+    "workflow.agent.end": "#/$defs/payload_workflow_agent_end",
+    "workflow.end": "#/$defs/payload_workflow_end",
+    "goal.changed": "#/$defs/payload_goal_changed",
+    "session.end": "#/$defs/payload_session_end"
+  },
+  "x-results": {
+    "session.start": "#/$defs/result_session_start",
+    "step.before": "#/$defs/result_step_before",
+    "tool.result": "#/$defs/result_tool_result",
+    "context.compaction": "#/$defs/result_ack",
+    "subagent.end": "#/$defs/result_ack",
+    "note": "#/$defs/result_note",
+    "query": "#/$defs/result_query",
+    "workflow.start": "#/$defs/result_ack",
+    "workflow.phase": "#/$defs/result_workflow_phase",
+    "workflow.agent.start": "#/$defs/result_ack",
+    "workflow.agent.end": "#/$defs/result_ack",
+    "workflow.end": "#/$defs/result_ack",
+    "goal.changed": "#/$defs/result_ack",
+    "session.end": "#/$defs/result_session_end"
+  },
+  "x-responses": {
+    "session.start": "#/$defs/response_session_start",
+    "step.before": "#/$defs/response_step_before",
+    "tool.result": "#/$defs/response_tool_result",
+    "context.compaction": "#/$defs/response_context_compaction",
+    "subagent.end": "#/$defs/response_subagent_end",
+    "note": "#/$defs/response_note",
+    "query": "#/$defs/response_query",
+    "workflow.start": "#/$defs/response_workflow_start",
+    "workflow.phase": "#/$defs/response_workflow_phase",
+    "workflow.agent.start": "#/$defs/response_workflow_agent_start",
+    "workflow.agent.end": "#/$defs/response_workflow_agent_end",
+    "workflow.end": "#/$defs/response_workflow_end",
+    "goal.changed": "#/$defs/response_goal_changed",
+    "session.end": "#/$defs/response_session_end"
+  },
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "adapter_id",
+    "event_id",
+    "session_ref",
+    "occurred_at",
+    "kind",
+    "payload"
+  ],
+  "properties": {
+    "adapter_id": {
+      "$ref": "#/$defs/adapter_id"
+    },
+    "event_id": {
+      "$ref": "#/$defs/digest"
+    },
+    "session_ref": {
+      "$ref": "#/$defs/ref"
+    },
+    "parent_ref": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/ref"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "occurred_at": {
+      "$ref": "#/$defs/timestamp"
+    },
+    "kind": {
+      "enum": [
+        "session.start",
+        "step.before",
+        "tool.result",
+        "context.compaction",
+        "subagent.end",
+        "note",
+        "query",
+        "workflow.start",
+        "workflow.phase",
+        "workflow.agent.start",
+        "workflow.agent.end",
+        "workflow.end",
+        "goal.changed",
+        "session.end"
+      ]
+    },
+    "payload": {
+      "type": "object"
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "session.start"
+          }
+        },
+        "required": [
+          "kind"
+        ]
+      },
+      "then": {
+        "properties": {
+          "payload": {
+            "$ref": "#/$defs/payload_session_start"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "step.before"
+          }
+        },
+        "required": [
+          "kind"
+        ]
+      },
+      "then": {
+        "properties": {
+          "payload": {
+            "$ref": "#/$defs/payload_step_before"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "tool.result"
+          }
+        },
+        "required": [
+          "kind"
+        ]
+      },
+      "then": {
+        "properties": {
+          "payload": {
+            "$ref": "#/$defs/payload_tool_result"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "context.compaction"
+          }
+        },
+        "required": [
+          "kind"
+        ]
+      },
+      "then": {
+        "properties": {
+          "payload": {
+            "$ref": "#/$defs/payload_context_compaction"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "subagent.end"
+          }
+        },
+        "required": [
+          "kind"
+        ]
+      },
+      "then": {
+        "properties": {
+          "payload": {
+            "$ref": "#/$defs/payload_subagent_end"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "note"
+          }
+        },
+        "required": [
+          "kind"
+        ]
+      },
+      "then": {
+        "properties": {
+          "payload": {
+            "$ref": "#/$defs/payload_note"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "query"
+          }
+        },
+        "required": [
+          "kind"
+        ]
+      },
+      "then": {
+        "properties": {
+          "payload": {
+            "$ref": "#/$defs/payload_query"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "workflow.start"
+          }
+        },
+        "required": [
+          "kind"
+        ]
+      },
+      "then": {
+        "properties": {
+          "payload": {
+            "$ref": "#/$defs/payload_workflow_start"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "workflow.phase"
+          }
+        },
+        "required": [
+          "kind"
+        ]
+      },
+      "then": {
+        "properties": {
+          "payload": {
+            "$ref": "#/$defs/payload_workflow_phase"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "workflow.agent.start"
+          }
+        },
+        "required": [
+          "kind"
+        ]
+      },
+      "then": {
+        "properties": {
+          "payload": {
+            "$ref": "#/$defs/payload_workflow_agent_start"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "workflow.agent.end"
+          }
+        },
+        "required": [
+          "kind"
+        ]
+      },
+      "then": {
+        "properties": {
+          "payload": {
+            "$ref": "#/$defs/payload_workflow_agent_end"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "workflow.end"
+          }
+        },
+        "required": [
+          "kind"
+        ]
+      },
+      "then": {
+        "properties": {
+          "payload": {
+            "$ref": "#/$defs/payload_workflow_end"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "goal.changed"
+          }
+        },
+        "required": [
+          "kind"
+        ]
+      },
+      "then": {
+        "properties": {
+          "payload": {
+            "$ref": "#/$defs/payload_goal_changed"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "session.end"
+          }
+        },
+        "required": [
+          "kind"
+        ]
+      },
+      "then": {
+        "properties": {
+          "payload": {
+            "$ref": "#/$defs/payload_session_end"
+          }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "adapter_id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+    },
+    "ref": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256,
+      "description": "Opaque runtime-side reference (session_ref, child_ref, run_ref…)."
+    },
+    "session_handle": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{1,128}$",
+      "description": "Issued by the Runtime in the session.start result; every later payload carries it."
+    },
+    "record_ref": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$",
+      "description": "Memory record reference (Release rr_… or local lr_…); opaque to adapters."
+    },
+    "timestamp": {
+      "type": "string",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{1,9})?(Z|[+-][0-9]{2}:[0-9]{2})$"
+    },
+    "trust": {
+      "enum": [
+        "raw",
+        "local_auto",
+        "reviewed",
+        "verified"
+      ]
+    },
+    "outcome": {
+      "enum": [
+        "pass",
+        "conditional_pass",
+        "fail",
+        "blocked",
+        "interrupted",
+        "unknown"
+      ]
+    },
+    "signal_name": {
+      "enum": [
+        "error_signature",
+        "code_symbol",
+        "tool_name",
+        "lexical",
+        "same_project",
+        "environment",
+        "evidence",
+        "recency",
+        "trust",
+        "negative",
+        "phase",
+        "dimension"
+      ],
+      "description": "Relevance signals (spec FR-12, FR-22, FR-38); same set as memory-profile/v1 signals. dimension: a soft template dimension matched (value name=value)."
+    },
+    "push_trigger": {
+      "enum": [
+        "session_start",
+        "after_failure",
+        "phase_start"
+      ]
+    },
+    "capability": {
+      "enum": [
+        "session_binding",
+        "step_injection",
+        "tool_capture",
+        "compaction_capture",
+        "subagent_capture",
+        "workflow_events",
+        "goal_events",
+        "note_tool",
+        "query_tools",
+        "workspace_snapshot"
+      ]
+    },
+    "phase_name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "match_reason": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "signal",
+        "value",
+        "contribution"
+      ],
+      "properties": {
+        "signal": {
+          "$ref": "#/$defs/signal_name"
+        },
+        "value": {
+          "type": "string",
+          "maxLength": 512,
+          "description": "The concrete value that matched (signature, symbol, term, project…)."
+        },
+        "contribution": {
+          "type": "number",
+          "description": "weight × normalized signal; negative for negative signals."
+        }
+      },
+      "description": "One entry of the match reasons (FR-13)."
+    },
+    "hit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "record_ref",
+        "title",
+        "trust",
+        "provenance_label",
+        "score",
+        "reasons"
+      ],
+      "properties": {
+        "record_ref": {
+          "$ref": "#/$defs/record_ref"
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        },
+        "trust": {
+          "$ref": "#/$defs/trust"
+        },
+        "provenance_label": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512,
+          "description": "Agent-facing source text, e.g. 「本机自动确认 · <项目> · <日期> · 记录时会话结局：<结局>」 (FR-10③)."
+        },
+        "score": {
+          "type": "number"
+        },
+        "reasons": {
+          "type": "array",
+          "maxItems": 32,
+          "items": {
+            "$ref": "#/$defs/match_reason"
+          }
+        },
+        "summary": {
+          "type": "string",
+          "maxLength": 4000,
+          "description": "First-paragraph summary (FR-16①)."
+        },
+        "excerpt": {
+          "type": "string",
+          "maxLength": 4000
+        },
+        "marks": {
+          "type": "array",
+          "maxItems": 16,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "task_failed",
+              "contradicted",
+              "superseded",
+              "used_then_passed"
+            ]
+          }
+        }
+      },
+      "description": "A ranked candidate as returned to adapters (inject hits, search hits, note similar[])."
+    },
+    "inject": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "text",
+        "record_refs",
+        "hits"
+      ],
+      "properties": {
+        "text": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 65536,
+          "description": "Ready-to-fold text for the next model request (DSH plugin message, form=recall)."
+        },
+        "record_refs": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 16,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/record_ref"
+          }
+        },
+        "hits": {
+          "type": "array",
+          "maxItems": 16,
+          "items": {
+            "$ref": "#/$defs/hit"
+          }
+        },
+        "trigger": {
+          "$ref": "#/$defs/push_trigger"
+        }
+      },
+      "description": "Push injection (COLLAB §3.2)."
+    },
+    "environment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [],
+      "properties": {
+        "os": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        },
+        "arch": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        },
+        "language": {
+          "type": "array",
+          "maxItems": 16,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64
+          }
+        }
+      },
+      "description": "Soft environment facts for the environment signal."
+    },
+    "dimensions": {
+      "type": "object",
+      "maxProperties": 32,
+      "patternProperties": {
+        "^[a-z][a-z0-9_]{0,63}$": {
+          "oneOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
+            },
+            {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 32,
+              "uniqueItems": true,
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 256
+              }
+            }
+          ]
+        }
+      },
+      "additionalProperties": false,
+      "description": "Task dimension values reported by the integrator (FR-38 ②, plan §13.2): name -> string (kind exact) or string list (kind set). Names follow memory-profile/v1 dimension.name; the Runtime rejects names the effective template does not declare (schema_invalid). Stored with the task; notes recorded in it inherit them."
+    },
+    "query_facts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [],
+      "properties": {
+        "tool_name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "error_signature": {
+          "$ref": "#/$defs/digest"
+        },
+        "error_tail": {
+          "type": "string",
+          "maxLength": 4096
+        },
+        "symbols": {
+          "type": "array",
+          "maxItems": 32,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256
+          }
+        },
+        "files": {
+          "type": "array",
+          "maxItems": 32,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 1024
+          }
+        }
+      },
+      "description": "Structured query facts (mode A, FR-14)."
+    },
+    "payload_query_search": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "session_handle",
+        "op",
+        "query"
+      ],
+      "properties": {
+        "session_handle": {
+          "$ref": "#/$defs/session_handle"
+        },
+        "op": {
+          "const": "search"
+        },
+        "query": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "limit": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 5
+        },
+        "phase": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/phase_name"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "facts": {
+          "$ref": "#/$defs/query_facts"
+        }
+      }
+    },
+    "payload_query_read": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "session_handle",
+        "op",
+        "ref"
+      ],
+      "properties": {
+        "session_handle": {
+          "$ref": "#/$defs/session_handle"
+        },
+        "op": {
+          "const": "read"
+        },
+        "ref": {
+          "$ref": "#/$defs/record_ref"
+        }
+      }
+    },
+    "payload_session_start": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "project",
+        "capabilities"
+      ],
+      "properties": {
+        "project": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256,
+          "description": "Integrator-configured project id, or the working-directory name."
+        },
+        "profile_ref": {
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^[a-z0-9][a-z0-9._-]{0,63}(@[A-Za-z0-9._-]{1,32})?$"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "capabilities": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/capability"
+          }
+        },
+        "adapter_version": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        },
+        "environment": {
+          "$ref": "#/$defs/environment"
+        },
+        "dimensions": {
+          "$ref": "#/$defs/dimensions"
+        },
+        "workspace_root": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 1024,
+          "description": "Absolute path of the session's working directory. Local only: the Runtime snapshots it at a failure when the adapter declares workspace_snapshot and the host enables snapshots (v1.1 FR-44 F1); it is never copied into Raw."
+        }
+      }
+    },
+    "payload_step_before": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "session_handle",
+        "step"
+      ],
+      "properties": {
+        "session_handle": {
+          "$ref": "#/$defs/session_handle"
+        },
+        "step": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "phase": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/phase_name"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "query_text": {
+          "type": "string",
+          "maxLength": 4000,
+          "description": "first user prompt or current task text, redacted by the adapter; used only as query facts (mode A)"
+        }
+      }
+    },
+    "payload_tool_result": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "session_handle",
+        "tool_name",
+        "ok"
+      ],
+      "properties": {
+        "session_handle": {
+          "$ref": "#/$defs/session_handle"
+        },
+        "tool_name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "ok": {
+          "type": "boolean"
+        },
+        "call_ref": {
+          "$ref": "#/$defs/ref"
+        },
+        "exit_code": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "error_tail": {
+          "anyOf": [
+            {
+              "type": "string",
+              "maxLength": 4096
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "error_signature": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/digest"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "path": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 1024,
+              "description": "Logical path for write-type tools; never file content."
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "symbols": {
+          "type": "array",
+          "maxItems": 32,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256
+          }
+        },
+        "command": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 4096
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The shell command, redacted by the adapter. On a failure it lets a replay reproduce the failing step (C2, C3); on a success (sent only after the session was shown memory) it lets the Runtime see that a pushed or read fix was run, or that a step that failed now passes (FR-18 applied). Never journaled."
+        }
+      }
+    },
+    "payload_context_compaction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "session_handle",
+        "summary_text"
+      ],
+      "properties": {
+        "session_handle": {
+          "$ref": "#/$defs/session_handle"
+        },
+        "summary_text": {
+          "type": "string",
+          "maxLength": 16384
+        }
+      }
+    },
+    "payload_subagent_end": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "session_handle",
+        "child_ref",
+        "stop_reason"
+      ],
+      "properties": {
+        "session_handle": {
+          "$ref": "#/$defs/session_handle"
+        },
+        "child_ref": {
+          "$ref": "#/$defs/ref"
+        },
+        "stop_reason": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        },
+        "agent_type": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "output_tail": {
+          "anyOf": [
+            {
+              "type": "string",
+              "maxLength": 4096
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      }
+    },
+    "payload_note": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "session_handle",
+        "title",
+        "type",
+        "scope",
+        "content"
+      ],
+      "properties": {
+        "session_handle": {
+          "$ref": "#/$defs/session_handle"
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 160
+        },
+        "type": {
+          "enum": [
+            "decision",
+            "bugfix",
+            "pattern",
+            "config",
+            "discovery",
+            "learning",
+            "pitfall"
+          ]
+        },
+        "scope": {
+          "enum": [
+            "project",
+            "global"
+          ]
+        },
+        "phase": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/phase_name"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "topic_key": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9_.-]{0,63}/[a-z0-9][a-z0-9_.-]{0,127}$",
+          "description": "family/description; omitted -> derived from type and title (FR-06②)."
+        },
+        "content": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "what",
+            "why",
+            "where",
+            "learned"
+          ],
+          "properties": {
+            "what": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 2000
+            },
+            "why": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 2000
+            },
+            "where": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 2000
+            },
+            "learned": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 2000
+            }
+          }
+        },
+        "evidence_refs": {
+          "type": "array",
+          "maxItems": 20,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          }
+        },
+        "relates_to": {
+          "type": "array",
+          "maxItems": 5,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "record_ref",
+              "relation"
+            ],
+            "properties": {
+              "record_ref": {
+                "$ref": "#/$defs/record_ref"
+              },
+              "relation": {
+                "enum": [
+                  "related",
+                  "compatible",
+                  "scoped",
+                  "conflicts_with",
+                  "supersedes",
+                  "not_conflict"
+                ]
+              }
+            }
+          }
+        },
+        "fix": {
+          "$ref": "#/$defs/fix"
+        }
+      }
+    },
+    "payload_query": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/payload_query_search"
+        },
+        {
+          "$ref": "#/$defs/payload_query_read"
+        }
+      ]
+    },
+    "payload_workflow_start": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "session_handle",
+        "run_ref",
+        "name",
+        "phases"
+      ],
+      "properties": {
+        "session_handle": {
+          "$ref": "#/$defs/session_handle"
+        },
+        "run_ref": {
+          "$ref": "#/$defs/ref"
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "description": {
+          "anyOf": [
+            {
+              "type": "string",
+              "maxLength": 4000
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "phases": {
+          "type": "array",
+          "maxItems": 64,
+          "items": {
+            "$ref": "#/$defs/phase_name"
+          }
+        },
+        "meta_digest": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/digest"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "script_digest": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/digest"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "dimensions": {
+          "$ref": "#/$defs/dimensions"
+        }
+      }
+    },
+    "payload_workflow_phase": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "session_handle",
+        "run_ref",
+        "title"
+      ],
+      "properties": {
+        "session_handle": {
+          "$ref": "#/$defs/session_handle"
+        },
+        "run_ref": {
+          "$ref": "#/$defs/ref"
+        },
+        "title": {
+          "$ref": "#/$defs/phase_name"
+        }
+      }
+    },
+    "payload_workflow_agent_start": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "session_handle",
+        "run_ref",
+        "seq"
+      ],
+      "properties": {
+        "session_handle": {
+          "$ref": "#/$defs/session_handle"
+        },
+        "run_ref": {
+          "$ref": "#/$defs/ref"
+        },
+        "seq": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "label": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "phase": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/phase_name"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "child_ref": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ref"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      }
+    },
+    "payload_workflow_agent_end": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "session_handle",
+        "run_ref",
+        "seq"
+      ],
+      "properties": {
+        "session_handle": {
+          "$ref": "#/$defs/session_handle"
+        },
+        "run_ref": {
+          "$ref": "#/$defs/ref"
+        },
+        "seq": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "label": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "phase": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/phase_name"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "child_ref": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ref"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "outcome": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 64
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      }
+    },
+    "payload_workflow_end": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "session_handle",
+        "run_ref",
+        "stop_reason"
+      ],
+      "properties": {
+        "session_handle": {
+          "$ref": "#/$defs/session_handle"
+        },
+        "run_ref": {
+          "$ref": "#/$defs/ref"
+        },
+        "stop_reason": {
+          "enum": [
+            "completed",
+            "cancelled",
+            "error"
+          ]
+        },
+        "error": {
+          "anyOf": [
+            {
+              "type": "string",
+              "maxLength": 4096
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "agents_started": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "result_outcome": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 64
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      }
+    },
+    "payload_goal_changed": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "session_handle",
+        "operation"
+      ],
+      "properties": {
+        "session_handle": {
+          "$ref": "#/$defs/session_handle"
+        },
+        "operation": {
+          "enum": [
+            "create",
+            "complete",
+            "block",
+            "pause",
+            "resume",
+            "clear"
+          ]
+        },
+        "objective_digest": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/digest"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      }
+    },
+    "payload_session_end": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "session_handle",
+        "reason"
+      ],
+      "properties": {
+        "session_handle": {
+          "$ref": "#/$defs/session_handle"
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        }
+      }
+    },
+    "result_ack": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [],
+      "properties": {},
+      "description": "Capture-type events: empty acknowledgement."
+    },
+    "read_record": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "record_ref",
+        "title",
+        "trust",
+        "provenance_label",
+        "text"
+      ],
+      "properties": {
+        "record_ref": {
+          "$ref": "#/$defs/record_ref"
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        },
+        "trust": {
+          "$ref": "#/$defs/trust"
+        },
+        "provenance_label": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        },
+        "text": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 65536,
+          "description": "Full agent-facing text."
+        },
+        "type": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        },
+        "scope": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        },
+        "topic_key": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "revision": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "project": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "phase": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/phase_name"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "content": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [],
+          "properties": {
+            "what": {
+              "type": "string",
+              "maxLength": 4000
+            },
+            "why": {
+              "type": "string",
+              "maxLength": 4000
+            },
+            "where": {
+              "type": "string",
+              "maxLength": 4000
+            },
+            "learned": {
+              "type": "string",
+              "maxLength": 4000
+            }
+          }
+        },
+        "evidence_refs": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 512
+          }
+        },
+        "marks": {
+          "type": "array",
+          "maxItems": 16,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "task_failed",
+              "contradicted",
+              "superseded",
+              "used_then_passed"
+            ]
+          }
+        },
+        "created_at": {
+          "$ref": "#/$defs/timestamp"
+        },
+        "updated_at": {
+          "$ref": "#/$defs/timestamp"
+        }
+      }
+    },
+    "result_query_search": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "op",
+        "hits"
+      ],
+      "properties": {
+        "op": {
+          "const": "search"
+        },
+        "hits": {
+          "type": "array",
+          "maxItems": 5,
+          "items": {
+            "$ref": "#/$defs/hit"
+          }
+        },
+        "status": {
+          "enum": [
+            "ok",
+            "no_match",
+            "budget_exhausted"
+          ]
+        }
+      }
+    },
+    "result_query_read": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "op",
+        "record"
+      ],
+      "properties": {
+        "op": {
+          "const": "read"
+        },
+        "record": {
+          "$ref": "#/$defs/read_record"
+        }
+      }
+    },
+    "result_session_start": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "session_handle",
+        "profile"
+      ],
+      "properties": {
+        "session_handle": {
+          "$ref": "#/$defs/session_handle"
+        },
+        "profile": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "revision",
+            "digest"
+          ],
+          "properties": {
+            "id": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 64
+            },
+            "revision": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 32
+            },
+            "digest": {
+              "$ref": "#/$defs/digest"
+            }
+          },
+          "description": "Pinned profile snapshot (FR-29)."
+        },
+        "profile_fallback": {
+          "anyOf": [
+            {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256,
+              "description": "Why the default profile was used instead (FR-29)."
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "capabilities_missing": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/capability"
+          }
+        },
+        "disabled_kinds": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "session.start",
+              "step.before",
+              "tool.result",
+              "context.compaction",
+              "subagent.end",
+              "note",
+              "query",
+              "workflow.start",
+              "workflow.phase",
+              "workflow.agent.start",
+              "workflow.agent.end",
+              "workflow.end",
+              "goal.changed",
+              "session.end"
+            ]
+          }
+        }
+      }
+    },
+    "result_step_before": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [],
+      "properties": {
+        "inject": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/inject"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      }
+    },
+    "result_tool_result": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [],
+      "properties": {
+        "inject": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/inject"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "description": "inject only when a failure triggers a push."
+    },
+    "result_note": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "record_ref",
+        "revision",
+        "topic_key",
+        "similar"
+      ],
+      "properties": {
+        "record_ref": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/record_ref"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "draft_ref": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/record_ref"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "revision": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "topic_key": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9_.-]{0,63}/[a-z0-9][a-z0-9_.-]{0,127}$"
+        },
+        "topic_key_derived": {
+          "type": "boolean"
+        },
+        "visible_from": {
+          "enum": [
+            "next_session"
+          ]
+        },
+        "similar": {
+          "type": "array",
+          "maxItems": 3,
+          "items": {
+            "$ref": "#/$defs/hit"
+          }
+        }
+      }
+    },
+    "result_query": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/result_query_search"
+        },
+        {
+          "$ref": "#/$defs/result_query_read"
+        }
+      ]
+    },
+    "result_workflow_phase": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [],
+      "properties": {
+        "inject": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/inject"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      }
+    },
+    "result_session_end": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "outcome",
+        "domain_status",
+        "exposures"
+      ],
+      "properties": {
+        "outcome": {
+          "$ref": "#/$defs/outcome"
+        },
+        "domain_status": {
+          "type": "string",
+          "minLength": 0,
+          "maxLength": 256
+        },
+        "task_id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "exposures": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "pushed",
+            "listed",
+            "read",
+            "cited"
+          ],
+          "properties": {
+            "pushed": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "listed": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "read": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "cited": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "applied": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Records whose fix the session ran after they were pushed or read (FR-18 applied)."
+            }
+          }
+        },
+        "record_refs": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/record_ref"
+          }
+        },
+        "notes": {
+          "type": "integer",
+          "minimum": 0
+        }
+      },
+      "description": "Receipt summary."
+    },
+    "error": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "code",
+        "message",
+        "retryable"
+      ],
+      "properties": {
+        "code": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_]{0,63}$",
+          "description": "See x-error-codes."
+        },
+        "message": {
+          "type": "string",
+          "maxLength": 2000
+        },
+        "retryable": {
+          "type": "boolean"
+        }
+      }
+    },
+    "response_error": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ok",
+        "error"
+      ],
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "error": {
+          "$ref": "#/$defs/error"
+        }
+      }
+    },
+    "response_session_start": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "ok",
+            "result"
+          ],
+          "properties": {
+            "ok": {
+              "const": true
+            },
+            "result": {
+              "$ref": "#/$defs/result_session_start"
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/response_error"
+        }
+      ]
+    },
+    "response_step_before": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "ok",
+            "result"
+          ],
+          "properties": {
+            "ok": {
+              "const": true
+            },
+            "result": {
+              "$ref": "#/$defs/result_step_before"
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/response_error"
+        }
+      ]
+    },
+    "response_tool_result": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "ok",
+            "result"
+          ],
+          "properties": {
+            "ok": {
+              "const": true
+            },
+            "result": {
+              "$ref": "#/$defs/result_tool_result"
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/response_error"
+        }
+      ]
+    },
+    "response_context_compaction": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "ok",
+            "result"
+          ],
+          "properties": {
+            "ok": {
+              "const": true
+            },
+            "result": {
+              "$ref": "#/$defs/result_ack"
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/response_error"
+        }
+      ]
+    },
+    "response_subagent_end": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "ok",
+            "result"
+          ],
+          "properties": {
+            "ok": {
+              "const": true
+            },
+            "result": {
+              "$ref": "#/$defs/result_ack"
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/response_error"
+        }
+      ]
+    },
+    "response_note": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "ok",
+            "result"
+          ],
+          "properties": {
+            "ok": {
+              "const": true
+            },
+            "result": {
+              "$ref": "#/$defs/result_note"
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/response_error"
+        }
+      ]
+    },
+    "response_query": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "ok",
+            "result"
+          ],
+          "properties": {
+            "ok": {
+              "const": true
+            },
+            "result": {
+              "$ref": "#/$defs/result_query"
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/response_error"
+        }
+      ]
+    },
+    "response_workflow_start": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "ok",
+            "result"
+          ],
+          "properties": {
+            "ok": {
+              "const": true
+            },
+            "result": {
+              "$ref": "#/$defs/result_ack"
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/response_error"
+        }
+      ]
+    },
+    "response_workflow_phase": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "ok",
+            "result"
+          ],
+          "properties": {
+            "ok": {
+              "const": true
+            },
+            "result": {
+              "$ref": "#/$defs/result_workflow_phase"
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/response_error"
+        }
+      ]
+    },
+    "response_workflow_agent_start": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "ok",
+            "result"
+          ],
+          "properties": {
+            "ok": {
+              "const": true
+            },
+            "result": {
+              "$ref": "#/$defs/result_ack"
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/response_error"
+        }
+      ]
+    },
+    "response_workflow_agent_end": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "ok",
+            "result"
+          ],
+          "properties": {
+            "ok": {
+              "const": true
+            },
+            "result": {
+              "$ref": "#/$defs/result_ack"
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/response_error"
+        }
+      ]
+    },
+    "response_workflow_end": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "ok",
+            "result"
+          ],
+          "properties": {
+            "ok": {
+              "const": true
+            },
+            "result": {
+              "$ref": "#/$defs/result_ack"
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/response_error"
+        }
+      ]
+    },
+    "response_goal_changed": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "ok",
+            "result"
+          ],
+          "properties": {
+            "ok": {
+              "const": true
+            },
+            "result": {
+              "$ref": "#/$defs/result_ack"
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/response_error"
+        }
+      ]
+    },
+    "response_session_end": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "ok",
+            "result"
+          ],
+          "properties": {
+            "ok": {
+              "const": true
+            },
+            "result": {
+              "$ref": "#/$defs/result_session_end"
+            }
+          }
+        },
+        {
+          "$ref": "#/$defs/response_error"
+        }
+      ]
+    },
+    "query_item_additions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [],
+      "properties": {
+        "record_ref": {
+          "$ref": "#/$defs/record_ref"
+        },
+        "match_reasons": {
+          "type": "array",
+          "maxItems": 32,
+          "items": {
+            "$ref": "#/$defs/match_reason"
+          }
+        },
+        "trust": {
+          "$ref": "#/$defs/trust"
+        },
+        "provenance_label": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        }
+      },
+      "description": "Additive fields for crowdmemory-query-response/v1 items (plan §4.3); old clients ignore them. Validate only these keys."
+    },
+    "receipt_mark_payload": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "mark",
+        "record_ref",
+        "task_id",
+        "phase",
+        "attempt"
+      ],
+      "properties": {
+        "mark": {
+          "enum": [
+            "task_failed",
+            "contradicted",
+            "superseded",
+            "used_success"
+          ]
+        },
+        "record_ref": {
+          "$ref": "#/$defs/record_ref"
+        },
+        "revision": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "task_id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "phase": {
+          "$ref": "#/$defs/phase_name"
+        },
+        "attempt": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "session_handle": {
+          "$ref": "#/$defs/session_handle"
+        },
+        "by_ref": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        }
+      },
+      "description": "payload of crowdmemory-receipt/v1 record_usage (task_failed|superseded|used_success) and contradiction (contradicted) receipts that seal a mark into Raw with the session that caused it (FR-09 ④)."
+    },
+    "receipt_exposure_payload": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "exposure_kind",
+        "record_ref",
+        "trust",
+        "task_id",
+        "phase",
+        "attempt"
+      ],
+      "properties": {
+        "exposure_kind": {
+          "enum": [
+            "pushed",
+            "listed",
+            "read",
+            "cited",
+            "applied"
+          ]
+        },
+        "applied_via": {
+          "enum": [
+            "fix_command",
+            "fix_path"
+          ],
+          "description": "applied only: the session ran the record's fix command (fix_command) or wrote a file its fix names (fix_path, config or diff fixes)."
+        },
+        "record_ref": {
+          "$ref": "#/$defs/record_ref"
+        },
+        "trust": {
+          "$ref": "#/$defs/trust"
+        },
+        "task_id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "phase": {
+          "$ref": "#/$defs/phase_name"
+        },
+        "attempt": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "session_handle": {
+          "$ref": "#/$defs/session_handle"
+        },
+        "trigger": {
+          "$ref": "#/$defs/push_trigger"
+        },
+        "score": {
+          "type": "number"
+        },
+        "reasons": {
+          "type": "array",
+          "maxItems": 32,
+          "items": {
+            "$ref": "#/$defs/match_reason"
+          }
+        },
+        "push_policy": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "max_items",
+            "max_chars",
+            "min_score"
+          ],
+          "properties": {
+            "max_items": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "max_chars": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "min_score": {
+              "type": "number"
+            },
+            "require": {
+              "type": "array",
+              "maxItems": 16,
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 64
+              }
+            },
+            "overridden": {
+              "type": "array",
+              "maxItems": 16,
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 64
+              }
+            }
+          },
+          "description": "pushed only: the trigger policy in effect and which keys a local override changed (FR-15)."
+        }
+      },
+      "description": "payload of crowdmemory-receipt/v1 view_exposure (pushed|listed) and record_usage (read|cited|applied) receipts (FR-18). applied: after the record was pushed to the task or read in the session, the agent ran its fix (deterministic match, no self-report).",
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "exposure_kind": {
+                "const": "applied"
+              }
+            },
+            "required": [
+              "exposure_kind"
+            ]
+          },
+          "then": {
+            "required": [
+              "applied_via"
+            ]
+          },
+          "else": {
+            "not": {
+              "required": [
+                "applied_via"
+              ]
+            }
+          }
+        }
+      ]
+    },
+    "fix": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind"
+      ],
+      "description": "The fix the agent attached to a note (v1.1 FR-39, T-B4): a shell command run in the workspace root, a unified diff with paths relative to it, or a whole config file. A note with a fix and a failure signature is a fix-type candidate; the center applies it mechanically (C3) without an agent.",
+      "properties": {
+        "kind": {
+          "enum": [
+            "command",
+            "diff",
+            "config"
+          ]
+        },
+        "command": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 4096
+        },
+        "diff": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 65536
+        },
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 1024
+        },
+        "content": {
+          "type": "string",
+          "maxLength": 65536
+        }
+      },
+      "oneOf": [
+        {
+          "properties": {
+            "kind": {
+              "const": "command"
+            }
+          },
+          "required": [
+            "command"
+          ]
+        },
+        {
+          "properties": {
+            "kind": {
+              "const": "diff"
+            }
+          },
+          "required": [
+            "diff"
+          ]
+        },
+        {
+          "properties": {
+            "kind": {
+              "const": "config"
+            }
+          },
+          "required": [
+            "path",
+            "content"
+          ]
+        }
+      ]
+    }
+  }
+}