@mplp/schema 1.0.4 → 1.0.5

package/schemas/common/events.schema.json

@@ -1,66 +1,66 @@
-{
-  "$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/events.schema.json",
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "MPLP Base Event",
-  "description": "Base model for all event structures in MPLP. Designed based on CloudEvents v1.0 core fields, providing unified event identification, type, source, and timestamp. ExecutionEvent, StateTransitionEvent, etc., are extensions of this.",
-  "type": "object",
-  "properties": {
-    "event_id": {
-      "$ref": "identifiers.schema.json",
-      "description": "Unique identifier for the event (UUID v4)."
-    },
-    "event_type": {
-      "type": "string",
-      "description": "Event type identifier, e.g., execution.started / vsl.transition.applied / plan.created. Uses dot-separated namespace format.",
-      "pattern": "^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9]*)*$",
-      "examples": [
-        "execution.started",
-        "execution.completed",
-        "vsl.transition.applied",
-        "plan.created"
-      ]
-    },
-    "source": {
-      "type": "string",
-      "description": "Event source, typically a module or component identifier. Can be a module name (e.g., 'context') or component path (e.g., 'runtime.ael').",
-      "examples": [
-        "context",
-        "plan",
-        "runtime.ael",
-        "runtime.vsl"
-      ]
-    },
-    "timestamp": {
-      "type": "string",
-      "format": "date-time",
-      "description": "Event occurrence time (ISO 8601 format).",
-      "examples": [
-        "2025-01-28T15:30:00.000Z"
-      ]
-    },
-    "trace_id": {
-      "description": "Optional trace ID to associate the event with a specific Trace.",
-      "$ref": "identifiers.schema.json"
-    },
-    "data": {
-      "anyOf": [
-        {
-          "type": "object",
-          "description": "Business data related to the event, constrained by upper-layer structures. Can be any JSON object or null."
-        },
-        {
-          "type": "null",
-          "description": "Business data related to the event, constrained by upper-layer structures. Can be any JSON object or null."
-        }
-      ]
-    }
-  },
-  "required": [
-    "event_id",
-    "event_type",
-    "source",
-    "timestamp"
-  ],
-  "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: © 2025 邦士（北京）网络科技有限公司\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
+  "$id": "https://schemas.mplp.dev/v1.0/common/events.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MPLP Base Event",
+  "description": "Base model for all event structures in MPLP. Designed based on CloudEvents v1.0 core fields, providing unified event identification, type, source, and timestamp. ExecutionEvent, StateTransitionEvent, etc., are extensions of this.",
+  "type": "object",
+  "properties": {
+    "event_id": {
+      "$ref": "identifiers.schema.json",
+      "description": "Unique identifier for the event (UUID v4)."
+    },
+    "event_type": {
+      "type": "string",
+      "description": "Event type identifier, e.g., execution.started / vsl.transition.applied / plan.created. Uses dot-separated namespace format.",
+      "pattern": "^[a-z][a-z0-9]*(?:\\.[a-z][a-z0-9]*)*$",
+      "examples": [
+        "execution.started",
+        "execution.completed",
+        "vsl.transition.applied",
+        "plan.created"
+      ]
+    },
+    "source": {
+      "type": "string",
+      "description": "Event source, typically a module or component identifier. Can be a module name (e.g., 'context') or component path (e.g., 'runtime.ael').",
+      "examples": [
+        "context",
+        "plan",
+        "runtime.ael",
+        "runtime.vsl"
+      ]
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Event occurrence time (ISO 8601 format).",
+      "examples": [
+        "2025-01-28T15:30:00.000Z"
+      ]
+    },
+    "trace_id": {
+      "description": "Optional trace ID to associate the event with a specific Trace.",
+      "$ref": "identifiers.schema.json"
+    },
+    "data": {
+      "anyOf": [
+        {
+          "type": "object",
+          "description": "Business data related to the event, constrained by upper-layer structures. Can be any JSON object or null."
+        },
+        {
+          "type": "null",
+          "description": "Business data related to the event, constrained by upper-layer structures. Can be any JSON object or null."
+        }
+      ]
+    }
+  },
+  "required": [
+    "event_id",
+    "event_type",
+    "source",
+    "timestamp"
+  ],
+  "additionalProperties": false
+}

package/schemas/common/identifiers.schema.json

@@ -1,13 +1,13 @@
-{
-  "$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/identifiers.schema.json",
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "MPLP Identifier",
-  "description": "Unified identifier type used for contextId/planId/traceId/eventId, etc. Uses UUID v4 standard to ensure global uniqueness and collision-free generation in distributed environments.",
-  "type": "string",
-  "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
-  "examples": [
-    "123e4567-e89b-12d3-a456-426614174000",
-    "550e8400-e29b-41d4-a716-446655440000"
-  ]
-}
+{
+  "$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/identifiers.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MPLP Identifier",
+  "description": "Unified identifier type used for contextId/planId/traceId/eventId, etc. Uses UUID v4 standard to ensure global uniqueness and collision-free generation in distributed environments.",
+  "type": "string",
+  "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+  "examples": [
+    "123e4567-e89b-12d3-a456-426614174000",
+    "550e8400-e29b-41d4-a716-446655440000"
+  ]
+}

package/schemas/common/learning-sample.schema.json

@@ -1,194 +1,194 @@
-{
-  "$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://schemas.mplp.dev/v1.0/common/learning-sample.schema.json",
-  "title": "MPLP Learning Sample – Schema v2.0",
-  "description": "Structured learning sample for MPLP v1.0 runtimes.",
-  "type": "object",
-  "additionalProperties": false,
-  "properties": {
-    "sample_id": {
-      "$ref": "identifiers.schema.json",
-      "description": "Unique identifier for this learning sample."
-    },
-    "project_id": {
-      "type": "string",
-      "description": "Project identifier this sample belongs to."
-    },
-    "intent_before": {
-      "type": "object",
-      "description": "Structured representation of the original intent (can reference Context/Plan).",
-      "additionalProperties": true
-    },
-    "plan": {
-      "type": "object",
-      "description": "Structured representation of the plan used (can reference Plan module).",
-      "additionalProperties": true
-    },
-    "delta_intents": {
-      "type": "array",
-      "description": "Array of delta intents proposed/applied.",
-      "items": {
-        "type": "object",
-        "additionalProperties": true
-      }
-    },
-    "graph_before": {
-      "type": "object",
-      "description": "Optional snapshot or summary of the knowledge graph before the change.",
-      "additionalProperties": true
-    },
-    "graph_after": {
-      "type": "object",
-      "description": "Optional snapshot or summary of the knowledge graph after the change.",
-      "additionalProperties": true
-    },
-    "pipeline_path": {
-      "type": "array",
-      "description": "Sequence of pipeline stages traversed.",
-      "items": {
-        "type": "string"
-      }
-    },
-    "success_flag": {
-      "type": "boolean",
-      "description": "Whether the action/intent succeeded."
-    },
-    "error_info": {
-      "type": "object",
-      "description": "Error details if action failed.",
-      "additionalProperties": false,
-      "properties": {
-        "error_code": {
-          "type": "string"
-        },
-        "error_message": {
-          "type": "string"
-        },
-        "stack_trace": {
-          "type": "string"
-        }
-      }
-    },
-    "token_usage": {
-      "type": "object",
-      "description": "LLM token consumption metrics.",
-      "additionalProperties": false,
-      "properties": {
-        "total_tokens": {
-          "type": "number",
-          "minimum": 0
-        },
-        "prompt_tokens": {
-          "type": "number",
-          "minimum": 0
-        },
-        "completion_tokens": {
-          "type": "number",
-          "minimum": 0
-        },
-        "by_agent": {
-          "type": "array",
-          "description": "Token usage breakdown by agent.",
-          "items": {
-            "type": "object",
-            "additionalProperties": false,
-            "properties": {
-              "agent_id": {
-                "type": "string"
-              },
-              "role": {
-                "type": "string"
-              },
-              "tokens": {
-                "type": "number",
-                "minimum": 0
-              }
-            },
-            "required": [
-              "agent_id",
-              "tokens"
-            ]
-          }
-        }
-      }
-    },
-    "execution_time_ms": {
-      "type": "number",
-      "description": "Execution time in milliseconds.",
-      "minimum": 0
-    },
-    "impact_score": {
-      "type": "number",
-      "description": "Impact score (0.0-1.0).",
-      "minimum": 0,
-      "maximum": 1
-    },
-    "user_feedback": {
-      "type": "object",
-      "description": "Human feedback on the action/result.",
-      "additionalProperties": false,
-      "properties": {
-        "decision": {
-          "type": "string",
-          "enum": [
-            "approve",
-            "reject",
-            "override",
-            "unknown"
-          ]
-        },
-        "comment": {
-          "type": "string"
-        },
-        "rating": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 5
-        }
-      }
-    },
-    "governance_decisions": {
-      "type": "array",
-      "description": "Governance rules evaluated during execution.",
-      "items": {
-        "type": "object",
-        "additionalProperties": true
-      }
-    },
-    "timestamps": {
-      "type": "object",
-      "description": "Execution timeline.",
-      "additionalProperties": false,
-      "properties": {
-        "started_at": {
-          "type": "string",
-          "format": "date-time"
-        },
-        "completed_at": {
-          "type": "string",
-          "format": "date-time"
-        }
-      },
-      "required": [
-        "started_at"
-      ]
-    },
-    "metadata": {
-      "type": "object",
-      "description": "Additional metadata (extensibility point).",
-      "additionalProperties": true
-    },
-    "vendor_extensions": {
-      "type": "object",
-      "description": "Optional vendor-specific extensions. Structure is implementation-defined and MUST NOT conflict with core protocol fields.",
-      "additionalProperties": true
-    }
-  },
-  "required": [
-    "sample_id",
-    "project_id",
-    "success_flag",
-    "timestamps"
-  ]
-}
+{
+  "$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://schemas.mplp.dev/v1.0/common/learning-sample.schema.json",
+  "title": "MPLP Learning Sample – Schema v2.0",
+  "description": "Structured learning sample for MPLP v1.0 runtimes.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "sample_id": {
+      "$ref": "identifiers.schema.json",
+      "description": "Unique identifier for this learning sample."
+    },
+    "project_id": {
+      "type": "string",
+      "description": "Project identifier this sample belongs to."
+    },
+    "intent_before": {
+      "type": "object",
+      "description": "Structured representation of the original intent (can reference Context/Plan).",
+      "additionalProperties": true
+    },
+    "plan": {
+      "type": "object",
+      "description": "Structured representation of the plan used (can reference Plan module).",
+      "additionalProperties": true
+    },
+    "delta_intents": {
+      "type": "array",
+      "description": "Array of delta intents proposed/applied.",
+      "items": {
+        "type": "object",
+        "additionalProperties": true
+      }
+    },
+    "graph_before": {
+      "type": "object",
+      "description": "Optional snapshot or summary of the knowledge graph before the change.",
+      "additionalProperties": true
+    },
+    "graph_after": {
+      "type": "object",
+      "description": "Optional snapshot or summary of the knowledge graph after the change.",
+      "additionalProperties": true
+    },
+    "pipeline_path": {
+      "type": "array",
+      "description": "Sequence of pipeline stages traversed.",
+      "items": {
+        "type": "string"
+      }
+    },
+    "success_flag": {
+      "type": "boolean",
+      "description": "Whether the action/intent succeeded."
+    },
+    "error_info": {
+      "type": "object",
+      "description": "Error details if action failed.",
+      "additionalProperties": false,
+      "properties": {
+        "error_code": {
+          "type": "string"
+        },
+        "error_message": {
+          "type": "string"
+        },
+        "stack_trace": {
+          "type": "string"
+        }
+      }
+    },
+    "token_usage": {
+      "type": "object",
+      "description": "LLM token consumption metrics.",
+      "additionalProperties": false,
+      "properties": {
+        "total_tokens": {
+          "type": "number",
+          "minimum": 0
+        },
+        "prompt_tokens": {
+          "type": "number",
+          "minimum": 0
+        },
+        "completion_tokens": {
+          "type": "number",
+          "minimum": 0
+        },
+        "by_agent": {
+          "type": "array",
+          "description": "Token usage breakdown by agent.",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "agent_id": {
+                "type": "string"
+              },
+              "role": {
+                "type": "string"
+              },
+              "tokens": {
+                "type": "number",
+                "minimum": 0
+              }
+            },
+            "required": [
+              "agent_id",
+              "tokens"
+            ]
+          }
+        }
+      }
+    },
+    "execution_time_ms": {
+      "type": "number",
+      "description": "Execution time in milliseconds.",
+      "minimum": 0
+    },
+    "impact_score": {
+      "type": "number",
+      "description": "Impact score (0.0-1.0).",
+      "minimum": 0,
+      "maximum": 1
+    },
+    "user_feedback": {
+      "type": "object",
+      "description": "Human feedback on the action/result.",
+      "additionalProperties": false,
+      "properties": {
+        "decision": {
+          "type": "string",
+          "enum": [
+            "approve",
+            "reject",
+            "override",
+            "unknown"
+          ]
+        },
+        "comment": {
+          "type": "string"
+        },
+        "rating": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 5
+        }
+      }
+    },
+    "governance_decisions": {
+      "type": "array",
+      "description": "Governance rules evaluated during execution.",
+      "items": {
+        "type": "object",
+        "additionalProperties": true
+      }
+    },
+    "timestamps": {
+      "type": "object",
+      "description": "Execution timeline.",
+      "additionalProperties": false,
+      "properties": {
+        "started_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "completed_at": {
+          "type": "string",
+          "format": "date-time"
+        }
+      },
+      "required": [
+        "started_at"
+      ]
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Additional metadata (extensibility point).",
+      "additionalProperties": true
+    },
+    "vendor_extensions": {
+      "type": "object",
+      "description": "Optional vendor-specific extensions. Structure is implementation-defined and MUST NOT conflict with core protocol fields.",
+      "additionalProperties": true
+    }
+  },
+  "required": [
+    "sample_id",
+    "project_id",
+    "success_flag",
+    "timestamps"
+  ]
+}