@mplp/schema 1.0.4 → 1.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/LICENSE +17 -0
  2. package/LICENSE.txt +201 -201
  3. package/README.md +25 -7
  4. package/dist/index.d.ts +1 -0
  5. package/dist/index.js +15 -0
  6. package/dist/kernel-duties.d.ts +9 -0
  7. package/dist/kernel-duties.js +19 -0
  8. package/package.json +17 -7
  9. package/schemas/common/common-types.schema.json +49 -49
  10. package/schemas/common/events.schema.json +66 -66
  11. package/schemas/common/identifiers.schema.json +13 -13
  12. package/schemas/common/learning-sample.schema.json +194 -194
  13. package/schemas/common/metadata.schema.json +115 -113
  14. package/schemas/common/trace-base.schema.json +43 -43
  15. package/schemas/events/mplp-event-core.schema.json +58 -58
  16. package/schemas/events/mplp-graph-update-event.schema.json +58 -58
  17. package/schemas/events/mplp-map-event.schema.json +147 -147
  18. package/schemas/events/mplp-pipeline-stage-event.schema.json +56 -56
  19. package/schemas/events/mplp-runtime-execution-event.schema.json +58 -58
  20. package/schemas/events/mplp-sa-event.schema.json +109 -109
  21. package/schemas/integration/mplp-ci-event.schema.json +130 -130
  22. package/schemas/integration/mplp-file-update-event.schema.json +70 -70
  23. package/schemas/integration/mplp-git-event.schema.json +98 -98
  24. package/schemas/integration/mplp-tool-event.schema.json +83 -83
  25. package/schemas/invariants/integration-invariants.yaml +139 -147
  26. package/schemas/invariants/learning-invariants.yaml +98 -106
  27. package/schemas/invariants/map-invariants.yaml +65 -73
  28. package/schemas/invariants/observability-invariants.yaml +98 -106
  29. package/schemas/invariants/sa-invariants.yaml +64 -72
  30. package/schemas/kernel-duties.json +18 -0
  31. package/schemas/learning/mplp-learning-sample-core.schema.json +94 -94
  32. package/schemas/learning/mplp-learning-sample-delta.schema.json +137 -137
  33. package/schemas/learning/mplp-learning-sample-intent.schema.json +119 -119
  34. package/schemas/mplp-collab.schema.json +243 -243
  35. package/schemas/mplp-confirm.schema.json +226 -226
  36. package/schemas/mplp-context.schema.json +246 -246
  37. package/schemas/mplp-core.schema.json +183 -183
  38. package/schemas/mplp-dialog.schema.json +198 -198
  39. package/schemas/mplp-extension.schema.json +179 -179
  40. package/schemas/mplp-network.schema.json +230 -230
  41. package/schemas/mplp-plan.schema.json +193 -193
  42. package/schemas/mplp-role.schema.json +139 -139
  43. package/schemas/mplp-trace.schema.json +216 -216
package/schemas/mplp-context.schema.json CHANGED
@@ -1,246 +1,246 @@
1
- {
2
- "$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.",
3
- "$schema": "http://json-schema.org/draft-07/schema#",
4
- "$id": "https://schemas.mplp.dev/v1.0/mplp-context.schema.json",
5
- "title": "MPLP Context Module – Core Protocol v1.0",
6
- "description": "Context Module Core Protocol: Describes the context resources and their minimal required semantics (Core Profile) for a multi-agent collaboration project/session.",
7
- "type": "object",
8
- "additionalProperties": false,
9
- "properties": {
10
- "meta": {
11
- "$ref": "common/metadata.schema.json",
12
- "description": "[PROTOCOL-CORE] MPLP protocol and schema metadata (version, source, cross-cutting tags, etc.)."
13
- },
14
- "governance": {
15
- "type": "object",
16
- "description": "[PROTOCOL-CORE] Governance metadata for lifecycle management, truth domain authority, and locking status.",
17
- "properties": {
18
- "lifecyclePhase": {
19
- "type": "string",
20
- "description": "Current phase in the lifecycle fence (e.g., 'design', 'implementation', 'review')."
21
- },
22
- "truthDomain": {
23
- "type": "string",
24
- "description": "The truth domain this object belongs to (e.g., 'requirements', 'architecture')."
25
- },
26
- "locked": {
27
- "type": "boolean",
28
- "description": "If true, this object cannot be modified except by specific governance overrides."
29
- },
30
- "lastConfirmRef": {
31
- "$ref": "common/common-types.schema.json#/definitions/Ref",
32
- "description": "Reference to the last Confirm decision that validated this state."
33
- }
34
- },
35
- "additionalProperties": false
36
- },
37
- "context_id": {
38
- "$ref": "common/identifiers.schema.json",
39
- "description": "[PROTOCOL-CORE] Global unique identifier for the Context."
40
- },
41
- "root": {
42
- "type": "object",
43
- "description": "[PROTOCOL-CORE] Context root node definition (business domain, environment, entry point resources, etc.).",
44
- "properties": {
45
- "domain": {
46
- "type": "string",
47
- "description": "[PROTOCOL-CORE] Business domain identifier."
48
- },
49
- "environment": {
50
- "type": "string",
51
- "description": "[PROTOCOL-CORE] Runtime environment identifier (e.g., development, production)."
52
- },
53
- "entry_point": {
54
- "type": "string",
55
- "description": "[PROTOCOL-CORE] Entry point resource identifier."
56
- }
57
- },
58
- "required": [
59
- "domain",
60
- "environment"
61
- ],
62
- "additionalProperties": true
63
- },
64
- "title": {
65
- "type": "string",
66
- "minLength": 1,
67
- "description": "[PROTOCOL-CORE] Context title, used for human and Agent identification of the project/session."
68
- },
69
- "summary": {
70
- "type": "string",
71
- "description": "[PROTOCOL-CORE] Brief summary of the Context (background, scope, etc.)."
72
- },
73
- "status": {
74
- "type": "string",
75
- "description": "[PROTOCOL-CORE] Current lifecycle status of the Context.",
76
- "enum": [
77
- "draft",
78
- "active",
79
- "suspended",
80
- "archived",
81
- "closed"
82
- ]
83
- },
84
- "tags": {
85
- "type": "array",
86
- "description": "[PROTOCOL-CORE] List of tags for classification and retrieval.",
87
- "items": {
88
- "type": "string",
89
- "minLength": 1
90
- }
91
- },
92
- "language": {
93
- "type": "string",
94
- "description": "[PROTOCOL-CORE] Primary working language of the Context (e.g., en, zh-CN)."
95
- },
96
- "owner_role": {
97
- "type": "string",
98
- "description": "[PROTOCOL-CORE] Identifier of the primary owner role (should correspond to role_id in Role module)."
99
- },
100
- "constraints": {
101
- "type": "object",
102
- "description": "[PROTOCOL-CORE] Key constraints for the Context, such as security boundaries, compliance requirements, budget, or deadlines.",
103
- "additionalProperties": true
104
- },
105
- "created_at": {
106
- "type": "string",
107
- "format": "date-time",
108
- "description": "[PROTOCOL-CORE] Context creation time (ISO 8601)."
109
- },
110
- "updated_at": {
111
- "type": "string",
112
- "format": "date-time",
113
- "description": "[PROTOCOL-CORE] Context last update time (ISO 8601)."
114
- },
115
- "trace": {
116
- "$ref": "common/trace-base.schema.json",
117
- "description": "[PROTOCOL-CORE] Main Trace reference bound to this Context (for global tracing)."
118
- },
119
- "events": {
120
- "type": "array",
121
- "description": "[PROTOCOL-CORE] List of key events directly related to this Context (creation, status change, archiving, etc.).",
122
- "items": {
123
- "$ref": "common/events.schema.json"
124
- }
125
- }
126
- },
127
- "required": [
128
- "meta",
129
- "context_id",
130
- "root",
131
- "title",
132
- "status"
133
- ],
134
- "$defs": {
135
- "context_core_properties": {
136
- "type": "object",
137
- "properties": {
138
- "meta": {
139
- "$ref": "common/metadata.schema.json",
140
- "description": "[PROTOCOL-CORE] MPLP protocol and schema metadata (version, source, cross-cutting tags, etc.)."
141
- },
142
- "context_id": {
143
- "$ref": "common/identifiers.schema.json",
144
- "description": "[PROTOCOL-CORE] Global unique identifier for the Context."
145
- },
146
- "root": {
147
- "type": "object",
148
- "description": "[PROTOCOL-CORE] Context root node definition (business domain, environment, entry point resources, etc.).",
149
- "properties": {
150
- "domain": {
151
- "type": "string",
152
- "description": "[PROTOCOL-CORE] Business domain identifier."
153
- },
154
- "environment": {
155
- "type": "string",
156
- "description": "[PROTOCOL-CORE] Runtime environment identifier (e.g., development, production)."
157
- },
158
- "entry_point": {
159
- "type": "string",
160
- "description": "[PROTOCOL-CORE] Entry point resource identifier."
161
- }
162
- },
163
- "required": [
164
- "domain",
165
- "environment"
166
- ],
167
- "additionalProperties": true
168
- },
169
- "title": {
170
- "type": "string",
171
- "minLength": 1,
172
- "description": "[PROTOCOL-CORE] Context title, used for human and Agent identification of the project/session."
173
- },
174
- "summary": {
175
- "type": "string",
176
- "description": "[PROTOCOL-CORE] Brief summary of the Context (background, scope, etc.)."
177
- },
178
- "status": {
179
- "type": "string",
180
- "description": "[PROTOCOL-CORE] Current lifecycle status of the Context.",
181
- "enum": [
182
- "draft",
183
- "active",
184
- "suspended",
185
- "archived",
186
- "closed"
187
- ]
188
- },
189
- "tags": {
190
- "type": "array",
191
- "description": "[PROTOCOL-CORE] List of tags for classification and retrieval.",
192
- "items": {
193
- "type": "string",
194
- "minLength": 1
195
- }
196
- },
197
- "language": {
198
- "type": "string",
199
- "description": "[PROTOCOL-CORE] Primary working language of the Context (e.g., en, zh-CN)."
200
- },
201
- "owner_role": {
202
- "type": "string",
203
- "description": "[PROTOCOL-CORE] Identifier of the primary owner role (should correspond to role_id in Role module)."
204
- },
205
- "constraints": {
206
- "type": "object",
207
- "description": "[PROTOCOL-CORE] Key constraints for the Context, such as security boundaries, compliance requirements, budget, or deadlines.",
208
- "additionalProperties": true
209
- },
210
- "created_at": {
211
- "type": "string",
212
- "format": "date-time",
213
- "description": "[PROTOCOL-CORE] Context creation time (ISO 8601)."
214
- },
215
- "updated_at": {
216
- "type": "string",
217
- "format": "date-time",
218
- "description": "[PROTOCOL-CORE] Context last update time (ISO 8601)."
219
- },
220
- "trace": {
221
- "$ref": "common/trace-base.schema.json",
222
- "description": "[PROTOCOL-CORE] Main Trace reference bound to this Context (for global tracing)."
223
- },
224
- "events": {
225
- "type": "array",
226
- "description": "[PROTOCOL-CORE] List of key events directly related to this Context (creation, status change, archiving, etc.).",
227
- "items": {
228
- "$ref": "common/events.schema.json"
229
- }
230
- }
231
- },
232
- "required": [
233
- "meta",
234
- "context_id",
235
- "root",
236
- "title",
237
- "status"
238
- ]
239
- },
240
- "uuid": {
241
- "type": "string",
242
- "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
243
- "description": "[DEPRECATED] Please use common/identifiers.schema.json. This definition is retained for backward compatibility only and is no longer recommended for reference."
244
- }
245
- }
246
- }
1
+ {
2
+ "$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.",
3
+ "$schema": "http://json-schema.org/draft-07/schema#",
4
+ "$id": "https://schemas.mplp.dev/v1.0/mplp-context.schema.json",
5
+ "title": "MPLP Context Module – Core Protocol v1.0",
6
+ "description": "Context Module Core Protocol: Describes the context resources and their minimal required semantics (Core Profile) for a multi-agent collaboration project/session.",
7
+ "type": "object",
8
+ "additionalProperties": false,
9
+ "properties": {
10
+ "meta": {
11
+ "$ref": "common/metadata.schema.json",
12
+ "description": "[PROTOCOL-CORE] MPLP protocol and schema metadata (version, source, cross-cutting tags, etc.)."
13
+ },
14
+ "governance": {
15
+ "type": "object",
16
+ "description": "[PROTOCOL-CORE] Governance metadata for lifecycle management, truth domain authority, and locking status.",
17
+ "properties": {
18
+ "lifecyclePhase": {
19
+ "type": "string",
20
+ "description": "Current phase in the lifecycle fence (e.g., 'design', 'implementation', 'review')."
21
+ },
22
+ "truthDomain": {
23
+ "type": "string",
24
+ "description": "The truth domain this object belongs to (e.g., 'requirements', 'architecture')."
25
+ },
26
+ "locked": {
27
+ "type": "boolean",
28
+ "description": "If true, this object cannot be modified except by specific governance overrides."
29
+ },
30
+ "lastConfirmRef": {
31
+ "$ref": "common/common-types.schema.json#/definitions/Ref",
32
+ "description": "Reference to the last Confirm decision that validated this state."
33
+ }
34
+ },
35
+ "additionalProperties": false
36
+ },
37
+ "context_id": {
38
+ "$ref": "common/identifiers.schema.json",
39
+ "description": "[PROTOCOL-CORE] Global unique identifier for the Context."
40
+ },
41
+ "root": {
42
+ "type": "object",
43
+ "description": "[PROTOCOL-CORE] Context root node definition (business domain, environment, entry point resources, etc.).",
44
+ "properties": {
45
+ "domain": {
46
+ "type": "string",
47
+ "description": "[PROTOCOL-CORE] Business domain identifier."
48
+ },
49
+ "environment": {
50
+ "type": "string",
51
+ "description": "[PROTOCOL-CORE] Runtime environment identifier (e.g., development, production)."
52
+ },
53
+ "entry_point": {
54
+ "type": "string",
55
+ "description": "[PROTOCOL-CORE] Entry point resource identifier."
56
+ }
57
+ },
58
+ "required": [
59
+ "domain",
60
+ "environment"
61
+ ],
62
+ "additionalProperties": true
63
+ },
64
+ "title": {
65
+ "type": "string",
66
+ "minLength": 1,
67
+ "description": "[PROTOCOL-CORE] Context title, used for human and Agent identification of the project/session."
68
+ },
69
+ "summary": {
70
+ "type": "string",
71
+ "description": "[PROTOCOL-CORE] Brief summary of the Context (background, scope, etc.)."
72
+ },
73
+ "status": {
74
+ "type": "string",
75
+ "description": "[PROTOCOL-CORE] Current lifecycle status of the Context.",
76
+ "enum": [
77
+ "draft",
78
+ "active",
79
+ "suspended",
80
+ "archived",
81
+ "closed"
82
+ ]
83
+ },
84
+ "tags": {
85
+ "type": "array",
86
+ "description": "[PROTOCOL-CORE] List of tags for classification and retrieval.",
87
+ "items": {
88
+ "type": "string",
89
+ "minLength": 1
90
+ }
91
+ },
92
+ "language": {
93
+ "type": "string",
94
+ "description": "[PROTOCOL-CORE] Primary working language of the Context (e.g., en, zh-CN)."
95
+ },
96
+ "owner_role": {
97
+ "type": "string",
98
+ "description": "[PROTOCOL-CORE] Identifier of the primary owner role (should correspond to role_id in Role module)."
99
+ },
100
+ "constraints": {
101
+ "type": "object",
102
+ "description": "[PROTOCOL-CORE] Key constraints for the Context, such as security boundaries, compliance requirements, budget, or deadlines.",
103
+ "additionalProperties": true
104
+ },
105
+ "created_at": {
106
+ "type": "string",
107
+ "format": "date-time",
108
+ "description": "[PROTOCOL-CORE] Context creation time (ISO 8601)."
109
+ },
110
+ "updated_at": {
111
+ "type": "string",
112
+ "format": "date-time",
113
+ "description": "[PROTOCOL-CORE] Context last update time (ISO 8601)."
114
+ },
115
+ "trace": {
116
+ "$ref": "common/trace-base.schema.json",
117
+ "description": "[PROTOCOL-CORE] Main Trace reference bound to this Context (for global tracing)."
118
+ },
119
+ "events": {
120
+ "type": "array",
121
+ "description": "[PROTOCOL-CORE] List of key events directly related to this Context (creation, status change, archiving, etc.).",
122
+ "items": {
123
+ "$ref": "common/events.schema.json"
124
+ }
125
+ }
126
+ },
127
+ "required": [
128
+ "meta",
129
+ "context_id",
130
+ "root",
131
+ "title",
132
+ "status"
133
+ ],
134
+ "$defs": {
135
+ "context_core_properties": {
136
+ "type": "object",
137
+ "properties": {
138
+ "meta": {
139
+ "$ref": "common/metadata.schema.json",
140
+ "description": "[PROTOCOL-CORE] MPLP protocol and schema metadata (version, source, cross-cutting tags, etc.)."
141
+ },
142
+ "context_id": {
143
+ "$ref": "common/identifiers.schema.json",
144
+ "description": "[PROTOCOL-CORE] Global unique identifier for the Context."
145
+ },
146
+ "root": {
147
+ "type": "object",
148
+ "description": "[PROTOCOL-CORE] Context root node definition (business domain, environment, entry point resources, etc.).",
149
+ "properties": {
150
+ "domain": {
151
+ "type": "string",
152
+ "description": "[PROTOCOL-CORE] Business domain identifier."
153
+ },
154
+ "environment": {
155
+ "type": "string",
156
+ "description": "[PROTOCOL-CORE] Runtime environment identifier (e.g., development, production)."
157
+ },
158
+ "entry_point": {
159
+ "type": "string",
160
+ "description": "[PROTOCOL-CORE] Entry point resource identifier."
161
+ }
162
+ },
163
+ "required": [
164
+ "domain",
165
+ "environment"
166
+ ],
167
+ "additionalProperties": true
168
+ },
169
+ "title": {
170
+ "type": "string",
171
+ "minLength": 1,
172
+ "description": "[PROTOCOL-CORE] Context title, used for human and Agent identification of the project/session."
173
+ },
174
+ "summary": {
175
+ "type": "string",
176
+ "description": "[PROTOCOL-CORE] Brief summary of the Context (background, scope, etc.)."
177
+ },
178
+ "status": {
179
+ "type": "string",
180
+ "description": "[PROTOCOL-CORE] Current lifecycle status of the Context.",
181
+ "enum": [
182
+ "draft",
183
+ "active",
184
+ "suspended",
185
+ "archived",
186
+ "closed"
187
+ ]
188
+ },
189
+ "tags": {
190
+ "type": "array",
191
+ "description": "[PROTOCOL-CORE] List of tags for classification and retrieval.",
192
+ "items": {
193
+ "type": "string",
194
+ "minLength": 1
195
+ }
196
+ },
197
+ "language": {
198
+ "type": "string",
199
+ "description": "[PROTOCOL-CORE] Primary working language of the Context (e.g., en, zh-CN)."
200
+ },
201
+ "owner_role": {
202
+ "type": "string",
203
+ "description": "[PROTOCOL-CORE] Identifier of the primary owner role (should correspond to role_id in Role module)."
204
+ },
205
+ "constraints": {
206
+ "type": "object",
207
+ "description": "[PROTOCOL-CORE] Key constraints for the Context, such as security boundaries, compliance requirements, budget, or deadlines.",
208
+ "additionalProperties": true
209
+ },
210
+ "created_at": {
211
+ "type": "string",
212
+ "format": "date-time",
213
+ "description": "[PROTOCOL-CORE] Context creation time (ISO 8601)."
214
+ },
215
+ "updated_at": {
216
+ "type": "string",
217
+ "format": "date-time",
218
+ "description": "[PROTOCOL-CORE] Context last update time (ISO 8601)."
219
+ },
220
+ "trace": {
221
+ "$ref": "common/trace-base.schema.json",
222
+ "description": "[PROTOCOL-CORE] Main Trace reference bound to this Context (for global tracing)."
223
+ },
224
+ "events": {
225
+ "type": "array",
226
+ "description": "[PROTOCOL-CORE] List of key events directly related to this Context (creation, status change, archiving, etc.).",
227
+ "items": {
228
+ "$ref": "common/events.schema.json"
229
+ }
230
+ }
231
+ },
232
+ "required": [
233
+ "meta",
234
+ "context_id",
235
+ "root",
236
+ "title",
237
+ "status"
238
+ ]
239
+ },
240
+ "uuid": {
241
+ "type": "string",
242
+ "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
243
+ "description": "[DEPRECATED] Please use common/identifiers.schema.json. This definition is retained for backward compatibility only and is no longer recommended for reference."
244
+ }
245
+ }
246
+ }