@mplp/schema 1.0.4 → 1.0.6

package/schemas/common/metadata.schema.json

@@ -1,113 +1,115 @@
-{
-  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2025 邦士（北京）网络科技有限公司\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
-  "$id": "https://schemas.mplp.dev/v1.0/common/metadata.schema.json",
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "MPLP Metadata",
-  "description": "Common metadata structure for all MPLP objects. Provides version control, creation info, tags, and cross-cutting concern declarations. All top-level objects in L2/L3/L4 should include the meta field.",
-  "type": "object",
-  "properties": {
-    "protocol_version": {
-      "type": "string",
-      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
-      "description": "MPLP protocol version, using Semantic Versioning.",
-      "examples": [
-        "1.0.0",
-        "1.1.0"
-      ]
-    },
-    "schema_version": {
-      "type": "string",
-      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
-      "description": "Schema version used by the current object, using Semantic Versioning.",
-      "examples": [
-        "2.0.0",
-        "2.1.0"
-      ]
-    },
-    "created_at": {
-      "type": "string",
-      "format": "date-time",
-      "description": "Object creation time (ISO 8601 format).",
-      "examples": [
-        "2025-01-28T15:30:00.000Z"
-      ]
-    },
-    "created_by": {
-      "type": "string",
-      "description": "Creator identifier (User ID / Agent Name / System ID).",
-      "examples": [
-        "user-123",
-        "agent-planner",
-        "system"
-      ]
-    },
-    "updated_at": {
-      "type": "string",
-      "format": "date-time",
-      "description": "Object last update time (ISO 8601 format).",
-      "examples": [
-        "2025-01-28T16:45:00.000Z"
-      ]
-    },
-    "updated_by": {
-      "type": "string",
-      "description": "Last updater identifier.",
-      "examples": [
-        "user-456",
-        "agent-executor"
-      ]
-    },
-    "tags": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      },
-      "description": "Set of tags for indexing/search. Supports custom classification and retrieval.",
-      "uniqueItems": true,
-      "examples": [
-        [
-          "production",
-          "high-priority"
-        ],
-        [
-          "development",
-          "experimental"
-        ]
-      ]
-    },
-    "cross_cutting": {
-      "type": "array",
-      "description": "Declares cross-cutting concerns enabled for the current object (one of the 9 concerns in Governance Plane).",
-      "items": {
-        "type": "string",
-        "enum": [
-          "coordination",
-          "error-handling",
-          "event-bus",
-          "orchestration",
-          "performance",
-          "protocol-version",
-          "security",
-          "state-sync",
-          "transaction"
-        ]
-      },
-      "uniqueItems": true,
-      "examples": [
-        [
-          "security",
-          "transaction"
-        ],
-        [
-          "performance",
-          "event-bus"
-        ]
-      ]
-    }
-  },
-  "required": [
-    "protocol_version",
-    "schema_version"
-  ],
-  "additionalProperties": false
-}
+{
+  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2026 Bangshi Beijing Network Technology Limited Company\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
+  "$id": "https://schemas.mplp.dev/v1.0/common/metadata.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MPLP Metadata",
+  "description": "Common metadata structure for all MPLP objects. Provides version control, creation info, tags, and cross-cutting concern declarations. All top-level objects in L2/L3/L4 should include the meta field.",
+  "type": "object",
+  "properties": {
+    "protocol_version": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+      "description": "MPLP protocol version, using Semantic Versioning.",
+      "examples": [
+        "1.0.0",
+        "1.1.0"
+      ]
+    },
+    "schema_version": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+      "description": "Schema version used by the current object, using Semantic Versioning.",
+      "examples": [
+        "2.0.0",
+        "2.1.0"
+      ]
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Object creation time (ISO 8601 format).",
+      "examples": [
+        "2025-01-28T15:30:00.000Z"
+      ]
+    },
+    "created_by": {
+      "type": "string",
+      "description": "Creator identifier (User ID / Agent Name / System ID).",
+      "examples": [
+        "user-123",
+        "agent-planner",
+        "system"
+      ]
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Object last update time (ISO 8601 format).",
+      "examples": [
+        "2025-01-28T16:45:00.000Z"
+      ]
+    },
+    "updated_by": {
+      "type": "string",
+      "description": "Last updater identifier.",
+      "examples": [
+        "user-456",
+        "agent-executor"
+      ]
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Set of tags for indexing/search. Supports custom classification and retrieval.",
+      "uniqueItems": true,
+      "examples": [
+        [
+          "production",
+          "high-priority"
+        ],
+        [
+          "development",
+          "experimental"
+        ]
+      ]
+    },
+    "cross_cutting": {
+      "type": "array",
+      "description": "Declares cross-cutting concerns enabled for the current object (one of the 11 concerns in Governance Plane).",
+      "items": {
+        "type": "string",
+        "enum": [
+          "coordination",
+          "error-handling",
+          "event-bus",
+          "learning-feedback",
+          "observability",
+          "orchestration",
+          "performance",
+          "protocol-versioning",
+          "security",
+          "state-sync",
+          "transaction"
+        ]
+      },
+      "uniqueItems": true,
+      "examples": [
+        [
+          "security",
+          "transaction"
+        ],
+        [
+          "performance",
+          "event-bus"
+        ]
+      ]
+    }
+  },
+  "required": [
+    "protocol_version",
+    "schema_version"
+  ],
+  "additionalProperties": false
+}

package/schemas/common/trace-base.schema.json

@@ -1,43 +1,43 @@
-{
-  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2025 邦士（北京）网络科技有限公司\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
-  "$id": "https://schemas.mplp.dev/v1.0/common/trace-base.schema.json",
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "MPLP Trace Base",
-  "description": "Common base fields for Trace / Span structures. Designed based on W3C Trace Context standard, providing a unified tracing context for the MPLP execution chain. Supports distributed tracing and parent-child relationships of execution steps.",
-  "type": "object",
-  "properties": {
-    "trace_id": {
-      "$ref": "identifiers.schema.json",
-      "description": "Identifier for a complete execution chain. All related Spans share the same trace_id."
-    },
-    "span_id": {
-      "$ref": "identifiers.schema.json",
-      "description": "Identifier for the current step or operation. Each Span has a unique span_id."
-    },
-    "parent_span_id": {
-      "$ref": "identifiers.schema.json",
-      "description": "Identifier of the parent step's span_id. Can be omitted if it is a root span."
-    },
-    "context_id": {
-      "$ref": "identifiers.schema.json",
-      "description": "Identifier of the Context Root. Associates the Trace with a specific project context."
-    },
-    "attributes": {
-      "type": "object",
-      "description": "Additional attributes (key-value pairs) to extend trace information. Can contain custom metadata, tags, etc.",
-      "additionalProperties": true,
-      "examples": [
-        {
-          "module": "plan",
-          "operation": "create",
-          "user_id": "user-123"
-        }
-      ]
-    }
-  },
-  "required": [
-    "trace_id",
-    "span_id"
-  ],
-  "additionalProperties": false
-}
+{
+  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2026 Bangshi Beijing Network Technology Limited Company\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
+  "$id": "https://schemas.mplp.dev/v1.0/common/trace-base.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MPLP Trace Base",
+  "description": "Common base fields for Trace / Span structures. Designed based on W3C Trace Context standard, providing a unified tracing context for the MPLP execution chain. Supports distributed tracing and parent-child relationships of execution steps.",
+  "type": "object",
+  "properties": {
+    "trace_id": {
+      "$ref": "identifiers.schema.json",
+      "description": "Identifier for a complete execution chain. All related Spans share the same trace_id."
+    },
+    "span_id": {
+      "$ref": "identifiers.schema.json",
+      "description": "Identifier for the current step or operation. Each Span has a unique span_id."
+    },
+    "parent_span_id": {
+      "$ref": "identifiers.schema.json",
+      "description": "Identifier of the parent step's span_id. Can be omitted if it is a root span."
+    },
+    "context_id": {
+      "$ref": "identifiers.schema.json",
+      "description": "Identifier of the Context Root. Associates the Trace with a specific project context."
+    },
+    "attributes": {
+      "type": "object",
+      "description": "Additional attributes (key-value pairs) to extend trace information. Can contain custom metadata, tags, etc.",
+      "additionalProperties": true,
+      "examples": [
+        {
+          "module": "plan",
+          "operation": "create",
+          "user_id": "user-123"
+        }
+      ]
+    }
+  },
+  "required": [
+    "trace_id",
+    "span_id"
+  ],
+  "additionalProperties": false
+}

package/schemas/events/mplp-event-core.schema.json

@@ -1,58 +1,58 @@
-{
-  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2025 邦士（北京）网络科技有限公司\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://mplp.dev/schemas/v1.0/events/mplp-event-core.schema.json",
-  "title": "MPLP Core Event v1.0",
-  "description": "Base structure for MPLP observability events - provides common fields inherited by all event families",
-  "type": "object",
-  "properties": {
-    "event_id": {
-      "type": "string",
-      "format": "uuid",
-      "description": "Unique identifier for this event (UUID v4)"
-    },
-    "event_type": {
-      "type": "string",
-      "description": "Specific event subtype (e.g., 'import_started', 'pipeline_stage_completed')"
-    },
-    "event_family": {
-      "type": "string",
-      "enum": [
-        "import_process",
-        "intent",
-        "delta_intent",
-        "impact_analysis",
-        "compensation_plan",
-        "methodology",
-        "reasoning_graph",
-        "pipeline_stage",
-        "graph_update",
-        "runtime_execution",
-        "cost_budget",
-        "external_integration"
-      ],
-      "description": "Event family classification - determines which minimal fields are required"
-    },
-    "timestamp": {
-      "type": "string",
-      "format": "date-time",
-      "description": "ISO 8601 timestamp when event occurred"
-    },
-    "project_id": {
-      "type": "string",
-      "format": "uuid",
-      "description": "Project context identifier (optional for system-level events)"
-    },
-    "payload": {
-      "type": "object",
-      "description": "Event-specific payload data (schema varies by event_family)"
-    }
-  },
-  "required": [
-    "event_id",
-    "event_type",
-    "event_family",
-    "timestamp"
-  ],
-  "additionalProperties": true
-}
+{
+  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2026 Bangshi Beijing Network Technology Limited Company\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://mplp.dev/schemas/v1.0/events/mplp-event-core.schema.json",
+  "title": "MPLP Core Event v1.0",
+  "description": "Base structure for MPLP observability events - provides common fields inherited by all event families",
+  "type": "object",
+  "properties": {
+    "event_id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Unique identifier for this event (UUID v4)"
+    },
+    "event_type": {
+      "type": "string",
+      "description": "Specific event subtype (e.g., 'import_started', 'pipeline_stage_completed')"
+    },
+    "event_family": {
+      "type": "string",
+      "enum": [
+        "import_process",
+        "intent",
+        "delta_intent",
+        "impact_analysis",
+        "compensation_plan",
+        "methodology",
+        "reasoning_graph",
+        "pipeline_stage",
+        "graph_update",
+        "runtime_execution",
+        "cost_budget",
+        "external_integration"
+      ],
+      "description": "Event family classification - determines which minimal fields are required"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp when event occurred"
+    },
+    "project_id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Project context identifier (optional for system-level events)"
+    },
+    "payload": {
+      "type": "object",
+      "description": "Event-specific payload data (schema varies by event_family)"
+    }
+  },
+  "required": [
+    "event_id",
+    "event_type",
+    "event_family",
+    "timestamp"
+  ],
+  "additionalProperties": true
+}

package/schemas/events/mplp-graph-update-event.schema.json

@@ -1,58 +1,58 @@
-{
-  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2025 邦士（北京）网络科技有限公司\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://mplp.dev/schemas/v1.0/events/mplp-graph-update-event.schema.json",
-  "title": "MPLP GraphUpdateEvent v1.0",
-  "description": "**REQUIRED** - PSG structural update events (MANDATORY for v1.0 compliance)",
-  "allOf": [
-    {
-      "$ref": "mplp-event-core.schema.json"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "event_family": {
-          "const": "graph_update",
-          "description": "Must be 'graph_update' for this event type"
-        },
-        "graph_id": {
-          "type": "string",
-          "format": "uuid",
-          "description": "PSG identifier (typically project-level graph)"
-        },
-        "update_kind": {
-          "type": "string",
-          "enum": [
-            "node_add",
-            "node_update",
-            "node_delete",
-            "edge_add",
-            "edge_update",
-            "edge_delete",
-            "bulk"
-          ],
-          "description": "Type of graph mutation"
-        },
-        "node_delta": {
-          "type": "integer",
-          "description": "Node count delta (+/- or 0)"
-        },
-        "edge_delta": {
-          "type": "integer",
-          "description": "Edge count delta (+/- or 0)"
-        },
-        "source_module": {
-          "type": "string",
-          "description": "L2 module emitting this update (e.g., 'context', 'plan', 'collab')"
-        }
-      },
-      "required": [
-        "event_family",
-        "graph_id",
-        "update_kind",
-        "node_delta",
-        "edge_delta"
-      ]
-    }
-  ]
-}
+{
+  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2026 Bangshi Beijing Network Technology Limited Company\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://mplp.dev/schemas/v1.0/events/mplp-graph-update-event.schema.json",
+  "title": "MPLP GraphUpdateEvent v1.0",
+  "description": "**REQUIRED** - PSG structural update events (MANDATORY for v1.0 compliance)",
+  "allOf": [
+    {
+      "$ref": "mplp-event-core.schema.json"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "event_family": {
+          "const": "graph_update",
+          "description": "Must be 'graph_update' for this event type"
+        },
+        "graph_id": {
+          "type": "string",
+          "format": "uuid",
+          "description": "PSG identifier (typically project-level graph)"
+        },
+        "update_kind": {
+          "type": "string",
+          "enum": [
+            "node_add",
+            "node_update",
+            "node_delete",
+            "edge_add",
+            "edge_update",
+            "edge_delete",
+            "bulk"
+          ],
+          "description": "Type of graph mutation"
+        },
+        "node_delta": {
+          "type": "integer",
+          "description": "Node count delta (+/- or 0)"
+        },
+        "edge_delta": {
+          "type": "integer",
+          "description": "Edge count delta (+/- or 0)"
+        },
+        "source_module": {
+          "type": "string",
+          "description": "L2 module emitting this update (e.g., 'context', 'plan', 'collab')"
+        }
+      },
+      "required": [
+        "event_family",
+        "graph_id",
+        "update_kind",
+        "node_delta",
+        "edge_delta"
+      ]
+    }
+  ]
+}