@mplp/schema 1.0.0

package/schemas/mplp-collab.schema.json

@@ -0,0 +1,243 @@
+{
+  "$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/mplp-collab.schema.json",
+  "title": "MPLP Collab Module – Core Protocol v1.0",
+  "description": "Collab Module Core Protocol: Describes the minimal required semantics (Core Profile) for multi-agent / multi-role collaboration sessions.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "meta": {
+      "$ref": "common/metadata.schema.json",
+      "description": "[PROTOCOL-CORE] Protocol and schema metadata."
+    },
+    "governance": {
+      "type": "object",
+      "description": "[PROTOCOL-CORE] Governance metadata for lifecycle management, truth domain authority, and locking status.",
+      "properties": {
+        "lifecyclePhase": {
+          "type": "string",
+          "description": "Current phase in the lifecycle fence (e.g., 'design', 'implementation', 'review')."
+        },
+        "truthDomain": {
+          "type": "string",
+          "description": "The truth domain this object belongs to (e.g., 'requirements', 'architecture')."
+        },
+        "locked": {
+          "type": "boolean",
+          "description": "If true, this object cannot be modified except by specific governance overrides."
+        },
+        "lastConfirmRef": {
+          "$ref": "common/common-types.schema.json#/definitions/Ref",
+          "description": "Reference to the last Confirm decision that validated this state."
+        }
+      },
+      "additionalProperties": false
+    },
+    "collab_id": {
+      "$ref": "common/identifiers.schema.json",
+      "description": "[PROTOCOL-CORE] Global unique identifier for the collaboration session."
+    },
+    "context_id": {
+      "$ref": "common/identifiers.schema.json",
+      "description": "[PROTOCOL-CORE] Identifier of the Context this collaboration session belongs to."
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "description": "[PROTOCOL-CORE] Collaboration session title."
+    },
+    "purpose": {
+      "type": "string",
+      "minLength": 1,
+      "description": "[PROTOCOL-CORE] Description of the purpose/goal of the collaboration."
+    },
+    "mode": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Collaboration mode (broadcast, round_robin, orchestrated, etc.).",
+      "enum": [
+        "broadcast",
+        "round_robin",
+        "orchestrated",
+        "swarm",
+        "pair"
+      ]
+    },
+    "status": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Collaboration session status.",
+      "enum": [
+        "draft",
+        "active",
+        "suspended",
+        "completed",
+        "cancelled"
+      ]
+    },
+    "participants": {
+      "type": "array",
+      "description": "[PROTOCOL-CORE] List of roles/Agents participating in the collaboration.",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/collab_participant_core"
+      }
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "[PROTOCOL-CORE] Creation time (ISO 8601)."
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "[PROTOCOL-CORE] Last update time (ISO 8601)."
+    },
+    "trace": {
+      "$ref": "common/trace-base.schema.json",
+      "description": "[PROTOCOL-CORE] Trace reference bound to this collaboration session."
+    },
+    "events": {
+      "type": "array",
+      "description": "[PROTOCOL-CORE] List of key events directly related to this collaboration.",
+      "items": {
+        "$ref": "common/events.schema.json"
+      }
+    }
+  },
+  "required": [
+    "meta",
+    "collab_id",
+    "context_id",
+    "title",
+    "purpose",
+    "mode",
+    "status",
+    "participants",
+    "created_at"
+  ],
+  "$defs": {
+    "collab_core_properties": {
+      "type": "object",
+      "properties": {
+        "meta": {
+          "$ref": "common/metadata.schema.json",
+          "description": "[PROTOCOL-CORE] Protocol and schema metadata."
+        },
+        "collab_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Global unique identifier for the collaboration session."
+        },
+        "context_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Identifier of the Context this collaboration session belongs to."
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1,
+          "description": "[PROTOCOL-CORE] Collaboration session title."
+        },
+        "purpose": {
+          "type": "string",
+          "minLength": 1,
+          "description": "[PROTOCOL-CORE] Description of the purpose/goal of the collaboration."
+        },
+        "mode": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Collaboration mode (broadcast, round_robin, orchestrated, etc.).",
+          "enum": [
+            "broadcast",
+            "round_robin",
+            "orchestrated",
+            "swarm",
+            "pair"
+          ]
+        },
+        "status": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Collaboration session status.",
+          "enum": [
+            "draft",
+            "active",
+            "suspended",
+            "completed",
+            "cancelled"
+          ]
+        },
+        "participants": {
+          "type": "array",
+          "description": "[PROTOCOL-CORE] List of roles/Agents participating in the collaboration.",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/collab_participant_core"
+          }
+        },
+        "created_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "[PROTOCOL-CORE] Creation time (ISO 8601)."
+        },
+        "updated_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "[PROTOCOL-CORE] Last update time (ISO 8601)."
+        },
+        "trace": {
+          "$ref": "common/trace-base.schema.json",
+          "description": "[PROTOCOL-CORE] Trace reference bound to this collaboration session."
+        },
+        "events": {
+          "type": "array",
+          "description": "[PROTOCOL-CORE] List of key events directly related to this collaboration.",
+          "items": {
+            "$ref": "common/events.schema.json"
+          }
+        }
+      },
+      "required": [
+        "meta",
+        "collab_id",
+        "context_id",
+        "title",
+        "purpose",
+        "mode",
+        "status",
+        "participants",
+        "created_at"
+      ]
+    },
+    "collab_participant_core": {
+      "type": "object",
+      "description": "[PROTOCOL-CORE] Minimal required semantics for a collaboration participant.",
+      "additionalProperties": false,
+      "properties": {
+        "participant_id": {
+          "type": "string",
+          "minLength": 1,
+          "description": "[PROTOCOL-CORE] Participant identifier (can be Role/Agent/External ID)."
+        },
+        "role_id": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Role ID bound to this participant (corresponds to role_id in Role module)."
+        },
+        "kind": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Participant type.",
+          "enum": [
+            "agent",
+            "human",
+            "system",
+            "external"
+          ]
+        },
+        "display_name": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Display name (for human identification)."
+        }
+      },
+      "required": [
+        "participant_id",
+        "kind"
+      ]
+    }
+  }
+}

package/schemas/mplp-confirm.schema.json

@@ -0,0 +1,226 @@
+{
+  "$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/mplp-confirm.schema.json",
+  "title": "MPLP Confirm Module – Core Protocol v1.0",
+  "description": "Confirm Module Core Protocol: Describes the minimal required semantics (Core Profile) for approval requests and decision records.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "meta": {
+      "$ref": "common/metadata.schema.json",
+      "description": "[PROTOCOL-CORE] MPLP protocol schema metadata (version, source, cross-cutting tags, etc.)."
+    },
+    "governance": {
+      "type": "object",
+      "description": "[PROTOCOL-CORE] Governance metadata for lifecycle management, truth domain authority, and locking status.",
+      "properties": {
+        "lifecyclePhase": {
+          "type": "string",
+          "description": "Current phase in the lifecycle fence (e.g., 'design', 'implementation', 'review')."
+        },
+        "truthDomain": {
+          "type": "string",
+          "description": "The truth domain this object belongs to (e.g., 'requirements', 'architecture')."
+        },
+        "locked": {
+          "type": "boolean",
+          "description": "If true, this object cannot be modified except by specific governance overrides."
+        },
+        "lastConfirmRef": {
+          "$ref": "common/common-types.schema.json#/definitions/Ref",
+          "description": "Reference to the last Confirm decision that validated this state."
+        }
+      },
+      "additionalProperties": false
+    },
+    "confirm_id": {
+      "$ref": "common/identifiers.schema.json",
+      "description": "[PROTOCOL-CORE] Global unique identifier for the approval request."
+    },
+    "target_type": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Approval target type (type of the resource being approved).",
+      "enum": [
+        "context",
+        "plan",
+        "trace",
+        "extension",
+        "other"
+      ]
+    },
+    "target_id": {
+      "$ref": "common/identifiers.schema.json",
+      "description": "[PROTOCOL-CORE] Global unique identifier of the resource being approved."
+    },
+    "status": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Current status of the approval request.",
+      "enum": [
+        "pending",
+        "approved",
+        "rejected",
+        "cancelled"
+      ]
+    },
+    "requested_by_role": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Identifier of the role initiating the approval request (should correspond to role_id in Role module)."
+    },
+    "requested_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "[PROTOCOL-CORE] Approval request creation time (ISO 8601)."
+    },
+    "reason": {
+      "type": "string",
+      "description": "[PROTOCOL-CORE] Reason for the request, for humans and Agents."
+    },
+    "decisions": {
+      "type": "array",
+      "description": "[PROTOCOL-CORE] List of decision records related to this Confirm request.",
+      "items": {
+        "$ref": "#/$defs/confirm_decision_core"
+      }
+    },
+    "trace": {
+      "$ref": "common/trace-base.schema.json",
+      "description": "[PROTOCOL-CORE] Trace reference bound to this Confirm request (for cross-module tracing)."
+    },
+    "events": {
+      "type": "array",
+      "description": "[PROTOCOL-CORE] List of key events directly related to this Confirm request (creation, decision, cancellation, etc.).",
+      "items": {
+        "$ref": "common/events.schema.json"
+      }
+    }
+  },
+  "required": [
+    "meta",
+    "confirm_id",
+    "target_type",
+    "target_id",
+    "status",
+    "requested_by_role",
+    "requested_at"
+  ],
+  "$defs": {
+    "confirm_core_properties": {
+      "type": "object",
+      "properties": {
+        "meta": {
+          "$ref": "common/metadata.schema.json",
+          "description": "[PROTOCOL-CORE] MPLP protocol schema metadata (version, source, cross-cutting tags, etc.)."
+        },
+        "confirm_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Global unique identifier for the approval request."
+        },
+        "target_type": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Approval target type (type of the resource being approved).",
+          "enum": [
+            "context",
+            "plan",
+            "trace",
+            "extension",
+            "other"
+          ]
+        },
+        "target_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Global unique identifier of the resource being approved."
+        },
+        "status": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Current status of the approval request.",
+          "enum": [
+            "pending",
+            "approved",
+            "rejected",
+            "cancelled"
+          ]
+        },
+        "requested_by_role": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Identifier of the role initiating the approval request (should correspond to role_id in Role module)."
+        },
+        "requested_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "[PROTOCOL-CORE] Approval request creation time (ISO 8601)."
+        },
+        "reason": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Reason for the request, for humans and Agents."
+        },
+        "decisions": {
+          "type": "array",
+          "description": "[PROTOCOL-CORE] List of decision records related to this Confirm request.",
+          "items": {
+            "$ref": "#/$defs/confirm_decision_core"
+          }
+        },
+        "trace": {
+          "$ref": "common/trace-base.schema.json",
+          "description": "[PROTOCOL-CORE] Trace reference bound to this Confirm request (for cross-module tracing)."
+        },
+        "events": {
+          "type": "array",
+          "description": "[PROTOCOL-CORE] List of key events directly related to this Confirm request (creation, decision, cancellation, etc.).",
+          "items": {
+            "$ref": "common/events.schema.json"
+          }
+        }
+      },
+      "required": [
+        "meta",
+        "confirm_id",
+        "target_type",
+        "target_id",
+        "status",
+        "requested_by_role",
+        "requested_at"
+      ]
+    },
+    "confirm_decision_core": {
+      "type": "object",
+      "description": "[PROTOCOL-CORE] Minimal required semantics for a single approval decision record.",
+      "additionalProperties": false,
+      "properties": {
+        "decision_id": {
+          "$ref": "common/identifiers.schema.json",
+          "description": "[PROTOCOL-CORE] Global unique identifier for the decision record."
+        },
+        "status": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Decision result status.",
+          "enum": [
+            "approved",
+            "rejected",
+            "cancelled"
+          ]
+        },
+        "decided_by_role": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Identifier of the role making the decision (should correspond to role_id in Role module)."
+        },
+        "decided_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "[PROTOCOL-CORE] Decision time (ISO 8601)."
+        },
+        "reason": {
+          "type": "string",
+          "description": "[PROTOCOL-CORE] Summary of the decision reason (optional)."
+        }
+      },
+      "required": [
+        "decision_id",
+        "status",
+        "decided_by_role",
+        "decided_at"
+      ]
+    }
+  }
+}