@mplp/schema 1.0.4 → 1.0.6

package/schemas/invariants/sa-invariants.yaml

@@ -1,72 +1,64 @@
-# MPLP v1.0.0 FROZEN – Invariant Set
-# © 2025 邦士（北京）网络科技有限公司 – Apache-2.0
-# Governance: MPLP Protocol Governance Committee (MPGC)
-
-# MPLP Protocol v1.0.0 — Frozen Specification
-# Freeze Date: 2025-12-03
-# Status: FROZEN (no breaking changes permitted)
-# Governance: MPLP Protocol Governance Committee (MPGC)
-# © 2025 邦士（北京）网络科技有限公司
-# License: Apache-2.0
-# Any normative change requires a new protocol version.
-
-# MPLP Protocol 1.0.0 — Frozen Specification
-# Status: Frozen as of 2025-11-30
-# Copyright: © 2025 邦士（北京）网络科技有限公司
-# License: Apache-2.0 (see LICENSE at repository root)
-# Any normative change requires a new protocol version.
-
-invariants:
-  - id: sa_requires_context
-    scope: context
-    path: context_id
-    rule: uuid-v4
-    description: "SA execution requires a valid Context with UUID v4 identifier"
-
-  - id: sa_context_must_be_active
-    scope: context
-    path: status
-    rule: enum(active)
-    description: "SA can only execute when Context status is 'active'"
-
-  - id: sa_plan_context_binding
-    scope: plan
-    path: context_id
-    rule: eq(context.context_id)
-    description: "Plan's context_id must match SA's loaded Context"
-
-  - id: sa_plan_has_steps
-    scope: plan
-    path: steps
-    rule: min-length(1)
-    description: "Plan must contain at least one executable step"
-
-  - id: sa_steps_have_valid_ids
-    scope: plan
-    path: steps[*].step_id
-    rule: uuid-v4
-    description: "All plan steps must have valid UUID v4 identifiers"
-
-  - id: sa_steps_have_agent_role
-    scope: plan
-    path: steps[*].agent_role
-    rule: non-empty-string
-    description: "All steps must specify an agent_role for executor selection"
-
-  - id: sa_trace_not_empty
-    scope: trace
-    path: events
-    rule: min-length(1)
-    description: "SA must emit at least one trace event before completion"
-
-  - id: sa_trace_context_binding
-    scope: trace
-    path: context_id
-    rule: eq(context.context_id)
-    description: "Trace context_id must match SA's Context"
-
-  - id: sa_trace_plan_binding
-    scope: trace
-    path: plan_id
-    rule: eq(plan.plan_id)
-    description: "Trace plan_id must match SA's Plan"
+# MPLP v1.0.0 FROZEN – Invariant Set
+# © 2026 Bangshi Beijing Network Technology Limited Company – Apache-2.0
+# Governance: MPLP Protocol Governance Committee (MPGC)
+
+# MPLP Protocol 1.0.0 — Frozen Specification
+# Status: Frozen as of 2025-11-30
+# Copyright: © 2026 Bangshi Beijing Network Technology Limited Company
+# License: Apache-2.0 (see LICENSE at repository root)
+# Any normative change requires a new protocol version.
+
+invariants:
+  - id: sa_requires_context
+    scope: context
+    path: context_id
+    rule: uuid-v4
+    description: "SA execution requires a valid Context with UUID v4 identifier"
+
+  - id: sa_context_must_be_active
+    scope: context
+    path: status
+    rule: enum(active)
+    description: "SA can only execute when Context status is 'active'"
+
+  - id: sa_plan_context_binding
+    scope: plan
+    path: context_id
+    rule: eq(context.context_id)
+    description: "Plan's context_id must match SA's loaded Context"
+
+  - id: sa_plan_has_steps
+    scope: plan
+    path: steps
+    rule: min-length(1)
+    description: "Plan must contain at least one executable step"
+
+  - id: sa_steps_have_valid_ids
+    scope: plan
+    path: steps[*].step_id
+    rule: uuid-v4
+    description: "All plan steps must have valid UUID v4 identifiers"
+
+  - id: sa_steps_have_agent_role
+    scope: plan
+    path: steps[*].agent_role
+    rule: non-empty-string
+    description: "All steps must specify an agent_role for executor selection"
+
+  - id: sa_trace_not_empty
+    scope: trace
+    path: events
+    rule: min-length(1)
+    description: "SA must emit at least one trace event before completion"
+
+  - id: sa_trace_context_binding
+    scope: trace
+    path: context_id
+    rule: eq(context.context_id)
+    description: "Trace context_id must match SA's Context"
+
+  - id: sa_trace_plan_binding
+    scope: trace
+    path: plan_id
+    rule: eq(plan.plan_id)
+    description: "Trace plan_id must match SA's Plan"

package/schemas/kernel-duties.json

@@ -0,0 +1,18 @@
+{
+  "protocol_version": "1.0.0",
+  "source_of_truth": "schemas/v2/taxonomy/kernel-duties.yaml",
+  "count": 11,
+  "duties": [
+    { "id": "KD-01", "name": "Coordination", "slug": "coordination" },
+    { "id": "KD-02", "name": "Error Handling", "slug": "error-handling" },
+    { "id": "KD-03", "name": "Event Bus", "slug": "event-bus" },
+    { "id": "KD-04", "name": "Learning Feedback", "slug": "learning-feedback" },
+    { "id": "KD-05", "name": "Observability", "slug": "observability" },
+    { "id": "KD-06", "name": "Orchestration", "slug": "orchestration" },
+    { "id": "KD-07", "name": "Performance", "slug": "performance" },
+    { "id": "KD-08", "name": "Protocol Versioning", "slug": "protocol-versioning" },
+    { "id": "KD-09", "name": "Security", "slug": "security" },
+    { "id": "KD-10", "name": "State Sync", "slug": "state-sync" },
+    { "id": "KD-11", "name": "Transaction", "slug": "transaction" }
+  ]
+}

package/schemas/learning/mplp-learning-sample-core.schema.json

@@ -1,94 +1,94 @@
-{
-  "$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/learning/mplp-learning-sample-core.schema.json",
-  "title": "MPLP LearningSample Core v1.0",
-  "description": "Core structure for MPLP LearningSample entities - defines the universal format for learning samples generated from execution history",
-  "type": "object",
-  "properties": {
-    "sample_id": {
-      "type": "string",
-      "format": "uuid",
-      "description": "Unique identifier of the learning sample (UUID v4)"
-    },
-    "sample_family": {
-      "type": "string",
-      "description": "LearningSample family identifier - determines expected input/output structure",
-      "examples": [
-        "intent_resolution",
-        "delta_impact",
-        "pipeline_outcome",
-        "confirm_decision",
-        "graph_evolution",
-        "multi_agent_coordination"
-      ]
-    },
-    "created_at": {
-      "type": "string",
-      "format": "date-time",
-      "description": "ISO 8601 timestamp when sample was generated"
-    },
-    "input": {
-      "type": "object",
-      "description": "Abstracted representation of input conditions, intent, context at sample creation time",
-      "additionalProperties": true
-    },
-    "state": {
-      "type": "object",
-      "description": "Snapshot of relevant system state before execution (PSG summary, config, roles, etc.)",
-      "additionalProperties": true
-    },
-    "output": {
-      "type": "object",
-      "description": "Abstracted representation of actual outcomes, decisions, changes, results",
-      "additionalProperties": true
-    },
-    "meta": {
-      "type": "object",
-      "description": "Metadata, labels, quality signals, provenance IDs, human feedback annotations",
-      "properties": {
-        "source_flow_id": {
-          "type": "string",
-          "description": "Optional: Flow ID that generated this sample (e.g., FLOW-01, SA-01, MAP-01)"
-        },
-        "source_event_ids": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "format": "uuid"
-          },
-          "description": "Optional: Observability event IDs referenced by this sample"
-        },
-        "project_id": {
-          "type": "string",
-          "format": "uuid",
-          "description": "Optional: Project context identifier"
-        },
-        "human_feedback_label": {
-          "type": "string",
-          "enum": [
-            "approved",
-            "rejected",
-            "not_reviewed"
-          ],
-          "description": "Optional: Human quality assessment"
-        },
-        "quality_score": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "description": "Optional: Automated quality score (0.0-1.0)"
-        }
-      },
-      "additionalProperties": true
-    }
-  },
-  "required": [
-    "sample_id",
-    "sample_family",
-    "created_at",
-    "input",
-    "output"
-  ],
-  "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/learning/mplp-learning-sample-core.schema.json",
+  "title": "MPLP LearningSample Core v1.0",
+  "description": "Core structure for MPLP LearningSample entities - defines the universal format for learning samples generated from execution history",
+  "type": "object",
+  "properties": {
+    "sample_id": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Unique identifier of the learning sample (UUID v4)"
+    },
+    "sample_family": {
+      "type": "string",
+      "description": "LearningSample family identifier - determines expected input/output structure",
+      "examples": [
+        "intent_resolution",
+        "delta_impact",
+        "pipeline_outcome",
+        "confirm_decision",
+        "graph_evolution",
+        "multi_agent_coordination"
+      ]
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp when sample was generated"
+    },
+    "input": {
+      "type": "object",
+      "description": "Abstracted representation of input conditions, intent, context at sample creation time",
+      "additionalProperties": true
+    },
+    "state": {
+      "type": "object",
+      "description": "Snapshot of relevant system state before execution (PSG summary, config, roles, etc.)",
+      "additionalProperties": true
+    },
+    "output": {
+      "type": "object",
+      "description": "Abstracted representation of actual outcomes, decisions, changes, results",
+      "additionalProperties": true
+    },
+    "meta": {
+      "type": "object",
+      "description": "Metadata, labels, quality signals, provenance IDs, human feedback annotations",
+      "properties": {
+        "source_flow_id": {
+          "type": "string",
+          "description": "Optional: Flow ID that generated this sample (e.g., FLOW-01, SA-01, MAP-01)"
+        },
+        "source_event_ids": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "description": "Optional: Observability event IDs referenced by this sample"
+        },
+        "project_id": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Optional: Project context identifier"
+        },
+        "human_feedback_label": {
+          "type": "string",
+          "enum": [
+            "approved",
+            "rejected",
+            "not_reviewed"
+          ],
+          "description": "Optional: Human quality assessment"
+        },
+        "quality_score": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Optional: Automated quality score (0.0-1.0)"
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "required": [
+    "sample_id",
+    "sample_family",
+    "created_at",
+    "input",
+    "output"
+  ],
+  "additionalProperties": true
+}

package/schemas/learning/mplp-learning-sample-delta.schema.json

@@ -1,137 +1,137 @@
-{
-  "$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/learning/mplp-learning-sample-delta.schema.json",
-  "title": "MPLP LearningSample – Delta Impact v1.0",
-  "description": "Specialized schema for delta_impact samples capturing change effect analysis and compensation planning",
-  "allOf": [
-    {
-      "$ref": "mplp-learning-sample-core.schema.json"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "sample_family": {
-          "const": "delta_impact",
-          "description": "Must be 'delta_impact' for this sample type"
-        },
-        "input": {
-          "type": "object",
-          "properties": {
-            "delta_id": {
-              "type": "string",
-              "description": "Delta Intent identifier"
-            },
-            "intent_id": {
-              "type": "string",
-              "description": "Original intent being modified"
-            },
-            "delta_type": {
-              "type": "string",
-              "enum": [
-                "refinement",
-                "correction",
-                "expansion",
-                "reduction",
-                "pivot"
-              ],
-              "description": "Type of delta change"
-            },
-            "change_summary": {
-              "type": "string",
-              "description": "Abstracted summary of requested change"
-            }
-          },
-          "required": [
-            "delta_id",
-            "intent_id",
-            "change_summary"
-          ],
-          "additionalProperties": true
-        },
-        "state": {
-          "type": "object",
-          "properties": {
-            "affected_artifact_count": {
-              "type": "integer",
-              "minimum": 0,
-              "description": "Optional: Number of artifacts potentially affected"
-            },
-            "risk_level": {
-              "type": "string",
-              "enum": [
-                "low",
-                "medium",
-                "high",
-                "critical"
-              ],
-              "description": "Assessed risk level before change"
-            },
-            "psg_complexity_score": {
-              "type": "number",
-              "minimum": 0,
-              "description": "Optional: PSG complexity metric before change"
-            }
-          },
-          "additionalProperties": true
-        },
-        "output": {
-          "type": "object",
-          "properties": {
-            "actual_impact_summary": {
-              "type": "string",
-              "description": "Summary of actual impact after analysis"
-            },
-            "impact_scope": {
-              "type": "string",
-              "enum": [
-                "local",
-                "module",
-                "system",
-                "global"
-              ],
-              "description": "Scope of detected impact"
-            },
-            "comp_plan_required": {
-              "type": "boolean",
-              "description": "Whether compensation plan was needed"
-            },
-            "comp_plan_applied": {
-              "type": "boolean",
-              "description": "Optional: Whether compensation was actually applied"
-            },
-            "rollback_used": {
-              "type": "boolean",
-              "description": "Optional: Whether rollback mechanism was triggered"
-            }
-          },
-          "required": [
-            "actual_impact_summary",
-            "impact_scope"
-          ],
-          "additionalProperties": true
-        },
-        "meta": {
-          "type": "object",
-          "properties": {
-            "impact_analysis_duration_ms": {
-              "type": "integer",
-              "minimum": 0,
-              "description": "Optional: Time spent on impact analysis"
-            },
-            "predicted_vs_actual_accuracy": {
-              "type": "string",
-              "enum": [
-                "accurate",
-                "underestimated",
-                "overestimated"
-              ],
-              "description": "Optional: Accuracy of impact prediction"
-            }
-          },
-          "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/learning/mplp-learning-sample-delta.schema.json",
+  "title": "MPLP LearningSample – Delta Impact v1.0",
+  "description": "Specialized schema for delta_impact samples capturing change effect analysis and compensation planning",
+  "allOf": [
+    {
+      "$ref": "mplp-learning-sample-core.schema.json"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "sample_family": {
+          "const": "delta_impact",
+          "description": "Must be 'delta_impact' for this sample type"
+        },
+        "input": {
+          "type": "object",
+          "properties": {
+            "delta_id": {
+              "type": "string",
+              "description": "Delta Intent identifier"
+            },
+            "intent_id": {
+              "type": "string",
+              "description": "Original intent being modified"
+            },
+            "delta_type": {
+              "type": "string",
+              "enum": [
+                "refinement",
+                "correction",
+                "expansion",
+                "reduction",
+                "pivot"
+              ],
+              "description": "Type of delta change"
+            },
+            "change_summary": {
+              "type": "string",
+              "description": "Abstracted summary of requested change"
+            }
+          },
+          "required": [
+            "delta_id",
+            "intent_id",
+            "change_summary"
+          ],
+          "additionalProperties": true
+        },
+        "state": {
+          "type": "object",
+          "properties": {
+            "affected_artifact_count": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Optional: Number of artifacts potentially affected"
+            },
+            "risk_level": {
+              "type": "string",
+              "enum": [
+                "low",
+                "medium",
+                "high",
+                "critical"
+              ],
+              "description": "Assessed risk level before change"
+            },
+            "psg_complexity_score": {
+              "type": "number",
+              "minimum": 0,
+              "description": "Optional: PSG complexity metric before change"
+            }
+          },
+          "additionalProperties": true
+        },
+        "output": {
+          "type": "object",
+          "properties": {
+            "actual_impact_summary": {
+              "type": "string",
+              "description": "Summary of actual impact after analysis"
+            },
+            "impact_scope": {
+              "type": "string",
+              "enum": [
+                "local",
+                "module",
+                "system",
+                "global"
+              ],
+              "description": "Scope of detected impact"
+            },
+            "comp_plan_required": {
+              "type": "boolean",
+              "description": "Whether compensation plan was needed"
+            },
+            "comp_plan_applied": {
+              "type": "boolean",
+              "description": "Optional: Whether compensation was actually applied"
+            },
+            "rollback_used": {
+              "type": "boolean",
+              "description": "Optional: Whether rollback mechanism was triggered"
+            }
+          },
+          "required": [
+            "actual_impact_summary",
+            "impact_scope"
+          ],
+          "additionalProperties": true
+        },
+        "meta": {
+          "type": "object",
+          "properties": {
+            "impact_analysis_duration_ms": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Optional: Time spent on impact analysis"
+            },
+            "predicted_vs_actual_accuracy": {
+              "type": "string",
+              "enum": [
+                "accurate",
+                "underestimated",
+                "overestimated"
+              ],
+              "description": "Optional: Accuracy of impact prediction"
+            }
+          },
+          "additionalProperties": true
+        }
+      }
+    }
+  ]
+}