@mplp/schema 1.0.4 → 1.0.6

package/schemas/integration/mplp-git-event.schema.json

@@ -1,98 +1,98 @@
-{
-  "$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/integration/mplp-git-event.json",
-  "title": "MPLP Git Event v1.0",
-  "description": "Git operations (commit, push, branch/merge/tag)",
-  "type": "object",
-  "additionalProperties": false,
-  "properties": {
-    "repo_url": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Repository URL or identifier",
-      "examples": [
-        "https://github.com/org/repo.git",
-        "git@github.com:org/repo.git"
-      ]
-    },
-    "commit_id": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Commit SHA or identifier",
-      "examples": [
-        "abc123def456",
-        "1a2b3c4d5e6f7g8h9i0j"
-      ]
-    },
-    "ref_name": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Branch, tag, or ref name",
-      "examples": [
-        "refs/heads/main",
-        "refs/tags/v1.0.0",
-        "main"
-      ]
-    },
-    "event_kind": {
-      "type": "string",
-      "enum": [
-        "commit",
-        "push",
-        "merge",
-        "tag",
-        "branch_create",
-        "branch_delete"
-      ],
-      "description": "Type of Git operation"
-    },
-    "author_name": {
-      "type": "string",
-      "description": "Commit author name"
-    },
-    "author_email": {
-      "type": "string",
-      "format": "email",
-      "description": "Commit author email"
-    },
-    "commit_message": {
-      "type": "string",
-      "description": "Commit message (first line or summary)"
-    },
-    "timestamp": {
-      "type": "string",
-      "format": "date-time",
-      "description": "When the Git operation occurred (ISO 8601)"
-    },
-    "files_changed": {
-      "type": "integer",
-      "minimum": 0,
-      "description": "Number of files changed in commit"
-    },
-    "insertions": {
-      "type": "integer",
-      "minimum": 0,
-      "description": "Total lines inserted"
-    },
-    "deletions": {
-      "type": "integer",
-      "minimum": 0,
-      "description": "Total lines deleted"
-    },
-    "parent_commits": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      },
-      "description": "Parent commit SHA(s) - multiple for merges"
-    }
-  },
-  "required": [
-    "repo_url",
-    "commit_id",
-    "ref_name",
-    "event_kind",
-    "timestamp"
-  ]
-}
+{
+  "$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/integration/mplp-git-event.json",
+  "title": "MPLP Git Event v1.0",
+  "description": "Git operations (commit, push, branch/merge/tag)",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "repo_url": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Repository URL or identifier",
+      "examples": [
+        "https://github.com/org/repo.git",
+        "git@github.com:org/repo.git"
+      ]
+    },
+    "commit_id": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Commit SHA or identifier",
+      "examples": [
+        "abc123def456",
+        "1a2b3c4d5e6f7g8h9i0j"
+      ]
+    },
+    "ref_name": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Branch, tag, or ref name",
+      "examples": [
+        "refs/heads/main",
+        "refs/tags/v1.0.0",
+        "main"
+      ]
+    },
+    "event_kind": {
+      "type": "string",
+      "enum": [
+        "commit",
+        "push",
+        "merge",
+        "tag",
+        "branch_create",
+        "branch_delete"
+      ],
+      "description": "Type of Git operation"
+    },
+    "author_name": {
+      "type": "string",
+      "description": "Commit author name"
+    },
+    "author_email": {
+      "type": "string",
+      "format": "email",
+      "description": "Commit author email"
+    },
+    "commit_message": {
+      "type": "string",
+      "description": "Commit message (first line or summary)"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "When the Git operation occurred (ISO 8601)"
+    },
+    "files_changed": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of files changed in commit"
+    },
+    "insertions": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Total lines inserted"
+    },
+    "deletions": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Total lines deleted"
+    },
+    "parent_commits": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Parent commit SHA(s) - multiple for merges"
+    }
+  },
+  "required": [
+    "repo_url",
+    "commit_id",
+    "ref_name",
+    "event_kind",
+    "timestamp"
+  ]
+}

package/schemas/integration/mplp-tool-event.schema.json

@@ -1,83 +1,83 @@
-{
-  "$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/integration/mplp-tool-event.json",
-  "title": "MPLP Tool Event v1.0",
-  "description": "External tool invocation and results (formatters, linters, test runners, generators)",
-  "type": "object",
-  "additionalProperties": false,
-  "properties": {
-    "tool_id": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Unique identifier for the tool",
-      "examples": [
-        "eslint-v8.50.0",
-        "prettier-v3.0.0",
-        "black-v23.10.0"
-      ]
-    },
-    "tool_kind": {
-      "type": "string",
-      "enum": [
-        "formatter",
-        "linter",
-        "test_runner",
-        "generator",
-        "other"
-      ],
-      "description": "Category of tool"
-    },
-    "invocation_id": {
-      "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}$",
-      "description": "UUID v4 identifier for this specific invocation"
-    },
-    "status": {
-      "type": "string",
-      "enum": [
-        "pending",
-        "running",
-        "succeeded",
-        "failed",
-        "cancelled"
-      ],
-      "description": "Current execution status"
-    },
-    "started_at": {
-      "type": "string",
-      "format": "date-time",
-      "description": "Invocation start timestamp (ISO 8601)"
-    },
-    "completed_at": {
-      "type": "string",
-      "format": "date-time",
-      "description": "Invocation completion timestamp (ISO 8601)"
-    },
-    "exit_code": {
-      "type": "integer",
-      "description": "Tool process exit code (if applicable)"
-    },
-    "output_summary": {
-      "type": "string",
-      "description": "Brief summary of tool output or errors"
-    },
-    "args": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      },
-      "description": "Command-line arguments passed to tool (optional)"
-    },
-    "working_directory": {
-      "type": "string",
-      "description": "Working directory where tool was executed (optional)"
-    }
-  },
-  "required": [
-    "tool_id",
-    "tool_kind",
-    "invocation_id",
-    "status"
-  ]
-}
+{
+  "$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/integration/mplp-tool-event.json",
+  "title": "MPLP Tool Event v1.0",
+  "description": "External tool invocation and results (formatters, linters, test runners, generators)",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "tool_id": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Unique identifier for the tool",
+      "examples": [
+        "eslint-v8.50.0",
+        "prettier-v3.0.0",
+        "black-v23.10.0"
+      ]
+    },
+    "tool_kind": {
+      "type": "string",
+      "enum": [
+        "formatter",
+        "linter",
+        "test_runner",
+        "generator",
+        "other"
+      ],
+      "description": "Category of tool"
+    },
+    "invocation_id": {
+      "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}$",
+      "description": "UUID v4 identifier for this specific invocation"
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "pending",
+        "running",
+        "succeeded",
+        "failed",
+        "cancelled"
+      ],
+      "description": "Current execution status"
+    },
+    "started_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Invocation start timestamp (ISO 8601)"
+    },
+    "completed_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Invocation completion timestamp (ISO 8601)"
+    },
+    "exit_code": {
+      "type": "integer",
+      "description": "Tool process exit code (if applicable)"
+    },
+    "output_summary": {
+      "type": "string",
+      "description": "Brief summary of tool output or errors"
+    },
+    "args": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Command-line arguments passed to tool (optional)"
+    },
+    "working_directory": {
+      "type": "string",
+      "description": "Working directory where tool was executed (optional)"
+    }
+  },
+  "required": [
+    "tool_id",
+    "tool_kind",
+    "invocation_id",
+    "status"
+  ]
+}

package/schemas/invariants/integration-invariants.yaml

@@ -1,147 +1,139 @@
-# 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:
-  # ========================================
-  # Tool Event Invariants
-  # ========================================
-  - id: integration_tool_event_id_non_empty
-    scope: tool_event
-    path: tool_id
-    rule: non-empty-string
-    description: "Tool event must have non-empty tool_id"
-
-  - id: integration_tool_kind_valid
-    scope: tool_event
-    path: tool_kind
-    rule: enum(formatter,linter,test_runner,generator,other)
-    description: "Tool kind must be valid enum value"
-
-  - id: integration_tool_invocation_id_uuid
-    scope: tool_event
-    path: invocation_id
-    rule: uuid-v4
-    description: "Tool invocation_id must be UUID v4"
-
-  - id: integration_tool_status_valid
-    scope: tool_event
-    path: status
-    rule: enum(pending,running,succeeded,failed,cancelled)
-    description: "Tool event status must be valid enum value"
-
-  - id: integration_tool_started_at_iso
-    scope: tool_event
-    path: started_at
-    rule: iso-datetime
-    description: "If started_at present, must be ISO 8601 datetime"
-    note: "Apply only when started_at field exists"
-
-  # ========================================
-  # File Update Event Invariants
-  # ========================================
-  - id: integration_file_path_non_empty
-    scope: file_update_event
-    path: file_path
-    rule: non-empty-string
-    description: "File update event must have non-empty file_path"
-
-  - id: integration_file_change_type_valid
-    scope: file_update_event
-    path: change_type
-    rule: enum(created,modified,deleted,renamed)
-    description: "File change_type must be valid enum value"
-
-  - id: integration_file_timestamp_iso
-    scope: file_update_event
-    path: timestamp
-    rule: iso-datetime
-    description: "File update timestamp must be ISO 8601 datetime"
-
-  # ========================================
-  # Git Event Invariants
-  # ========================================
-  - id: integration_git_repo_url_non_empty
-    scope: git_event
-    path: repo_url
-    rule: non-empty-string
-    description: "Git event must have non-empty repo_url"
-
-  - id: integration_git_commit_id_non_empty
-    scope: git_event
-    path: commit_id
-    rule: non-empty-string
-    description: "Git event must have non-empty commit_id"
-
-  - id: integration_git_ref_name_non_empty
-    scope: git_event
-    path: ref_name
-    rule: non-empty-string
-    description: "Git event must have non-empty ref_name"
-
-  - id: integration_git_event_kind_valid
-    scope: git_event
-    path: event_kind
-    rule: enum(commit,push,merge,tag,branch_create,branch_delete)
-    description: "Git event_kind must be valid enum value"
-
-  - id: integration_git_timestamp_iso
-    scope: git_event
-    path: timestamp
-    rule: iso-datetime
-    description: "Git event timestamp must be ISO 8601 datetime"
-
-  # ========================================
-  # CI Event Invariants
-  # ========================================
-  - id: integration_ci_provider_non_empty
-    scope: ci_event
-    path: ci_provider
-    rule: non-empty-string
-    description: "CI event must have non-empty ci_provider"
-
-  - id: integration_ci_pipeline_id_non_empty
-    scope: ci_event
-    path: pipeline_id
-    rule: non-empty-string
-    description: "CI event must have non-empty pipeline_id"
-
-  - id: integration_ci_run_id_non_empty
-    scope: ci_event
-    path: run_id
-    rule: non-empty-string
-    description: "CI event must have non-empty run_id"
-
-  - id: integration_ci_status_valid
-    scope: ci_event
-    path: status
-    rule: enum(pending,running,succeeded,failed,cancelled)
-    description: "CI event status must be valid enum value"
-
-  - id: integration_ci_started_at_iso
-    scope: ci_event
-    path: started_at
-    rule: iso-datetime
-    description: "If started_at present, must be ISO 8601 datetime"
-    note: "Apply only when started_at field exists"
-
-  - id: integration_ci_completed_at_iso
-    scope: ci_event
-    path: completed_at
-    rule: iso-datetime
-    description: "If completed_at present, must be ISO 8601 datetime"
-    note: "Apply only when completed_at field exists"
+# 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:
+  # ========================================
+  # Tool Event Invariants
+  # ========================================
+  - id: integration_tool_event_id_non_empty
+    scope: tool_event
+    path: tool_id
+    rule: non-empty-string
+    description: "Tool event must have non-empty tool_id"
+
+  - id: integration_tool_kind_valid
+    scope: tool_event
+    path: tool_kind
+    rule: enum(formatter,linter,test_runner,generator,other)
+    description: "Tool kind must be valid enum value"
+
+  - id: integration_tool_invocation_id_uuid
+    scope: tool_event
+    path: invocation_id
+    rule: uuid-v4
+    description: "Tool invocation_id must be UUID v4"
+
+  - id: integration_tool_status_valid
+    scope: tool_event
+    path: status
+    rule: enum(pending,running,succeeded,failed,cancelled)
+    description: "Tool event status must be valid enum value"
+
+  - id: integration_tool_started_at_iso
+    scope: tool_event
+    path: started_at
+    rule: iso-datetime
+    description: "If started_at present, must be ISO 8601 datetime"
+    note: "Apply only when started_at field exists"
+
+  # ========================================
+  # File Update Event Invariants
+  # ========================================
+  - id: integration_file_path_non_empty
+    scope: file_update_event
+    path: file_path
+    rule: non-empty-string
+    description: "File update event must have non-empty file_path"
+
+  - id: integration_file_change_type_valid
+    scope: file_update_event
+    path: change_type
+    rule: enum(created,modified,deleted,renamed)
+    description: "File change_type must be valid enum value"
+
+  - id: integration_file_timestamp_iso
+    scope: file_update_event
+    path: timestamp
+    rule: iso-datetime
+    description: "File update timestamp must be ISO 8601 datetime"
+
+  # ========================================
+  # Git Event Invariants
+  # ========================================
+  - id: integration_git_repo_url_non_empty
+    scope: git_event
+    path: repo_url
+    rule: non-empty-string
+    description: "Git event must have non-empty repo_url"
+
+  - id: integration_git_commit_id_non_empty
+    scope: git_event
+    path: commit_id
+    rule: non-empty-string
+    description: "Git event must have non-empty commit_id"
+
+  - id: integration_git_ref_name_non_empty
+    scope: git_event
+    path: ref_name
+    rule: non-empty-string
+    description: "Git event must have non-empty ref_name"
+
+  - id: integration_git_event_kind_valid
+    scope: git_event
+    path: event_kind
+    rule: enum(commit,push,merge,tag,branch_create,branch_delete)
+    description: "Git event_kind must be valid enum value"
+
+  - id: integration_git_timestamp_iso
+    scope: git_event
+    path: timestamp
+    rule: iso-datetime
+    description: "Git event timestamp must be ISO 8601 datetime"
+
+  # ========================================
+  # CI Event Invariants
+  # ========================================
+  - id: integration_ci_provider_non_empty
+    scope: ci_event
+    path: ci_provider
+    rule: non-empty-string
+    description: "CI event must have non-empty ci_provider"
+
+  - id: integration_ci_pipeline_id_non_empty
+    scope: ci_event
+    path: pipeline_id
+    rule: non-empty-string
+    description: "CI event must have non-empty pipeline_id"
+
+  - id: integration_ci_run_id_non_empty
+    scope: ci_event
+    path: run_id
+    rule: non-empty-string
+    description: "CI event must have non-empty run_id"
+
+  - id: integration_ci_status_valid
+    scope: ci_event
+    path: status
+    rule: enum(pending,running,succeeded,failed,cancelled)
+    description: "CI event status must be valid enum value"
+
+  - id: integration_ci_started_at_iso
+    scope: ci_event
+    path: started_at
+    rule: iso-datetime
+    description: "If started_at present, must be ISO 8601 datetime"
+    note: "Apply only when started_at field exists"
+
+  - id: integration_ci_completed_at_iso
+    scope: ci_event
+    path: completed_at
+    rule: iso-datetime
+    description: "If completed_at present, must be ISO 8601 datetime"
+    note: "Apply only when completed_at field exists"