@mplp/schema 1.0.1 → 1.0.2

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 (38) hide show
  1. package/README.md +11 -0
  2. package/dist/index.d.ts +0 -11
  3. package/dist/index.js +7 -11
  4. package/package.json +23 -4
  5. package/schemas/common/common-types.schema.json +49 -49
  6. package/schemas/common/events.schema.json +66 -66
  7. package/schemas/common/identifiers.schema.json +13 -13
  8. package/schemas/common/learning-sample.schema.json +194 -194
  9. package/schemas/common/metadata.schema.json +113 -113
  10. package/schemas/common/trace-base.schema.json +43 -43
  11. package/schemas/events/mplp-event-core.schema.json +58 -58
  12. package/schemas/events/mplp-graph-update-event.schema.json +58 -58
  13. package/schemas/events/mplp-map-event.schema.json +147 -147
  14. package/schemas/events/mplp-pipeline-stage-event.schema.json +56 -56
  15. package/schemas/events/mplp-runtime-execution-event.schema.json +58 -58
  16. package/schemas/events/mplp-sa-event.schema.json +109 -109
  17. package/schemas/integration/mplp-ci-event.schema.json +130 -130
  18. package/schemas/integration/mplp-file-update-event.schema.json +70 -70
  19. package/schemas/integration/mplp-git-event.schema.json +98 -98
  20. package/schemas/integration/mplp-tool-event.schema.json +83 -83
  21. package/schemas/invariants/integration-invariants.yaml +12 -8
  22. package/schemas/invariants/learning-invariants.yaml +12 -8
  23. package/schemas/invariants/map-invariants.yaml +12 -8
  24. package/schemas/invariants/observability-invariants.yaml +12 -8
  25. package/schemas/invariants/sa-invariants.yaml +12 -8
  26. package/schemas/learning/mplp-learning-sample-core.schema.json +94 -94
  27. package/schemas/learning/mplp-learning-sample-delta.schema.json +137 -137
  28. package/schemas/learning/mplp-learning-sample-intent.schema.json +119 -119
  29. package/schemas/mplp-collab.schema.json +243 -243
  30. package/schemas/mplp-confirm.schema.json +226 -226
  31. package/schemas/mplp-context.schema.json +246 -246
  32. package/schemas/mplp-core.schema.json +183 -183
  33. package/schemas/mplp-dialog.schema.json +198 -198
  34. package/schemas/mplp-extension.schema.json +179 -179
  35. package/schemas/mplp-network.schema.json +230 -230
  36. package/schemas/mplp-plan.schema.json +193 -193
  37. package/schemas/mplp-role.schema.json +139 -139
  38. package/schemas/mplp-trace.schema.json +216 -216
package/schemas/mplp-trace.schema.json CHANGED
@@ -1,216 +1,216 @@
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-trace.schema.json",
5
- "title": "MPLP Trace Module – Core Protocol v1.0",
6
- "description": "Trace Module Core Protocol: Describes the minimal required semantics (Core Profile) for execution trace resources (Trace) and their key segments and events.",
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."
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
- "trace_id": {
38
- "$ref": "common/identifiers.schema.json",
39
- "description": "[PROTOCOL-CORE] Global unique identifier for the Trace."
40
- },
41
- "context_id": {
42
- "$ref": "common/identifiers.schema.json",
43
- "description": "[PROTOCOL-CORE] Identifier of the Context this Trace belongs to."
44
- },
45
- "plan_id": {
46
- "$ref": "common/identifiers.schema.json",
47
- "description": "[PROTOCOL-CORE] Identifier of the Plan associated with this Trace (if any)."
48
- },
49
- "root_span": {
50
- "$ref": "common/trace-base.schema.json",
51
- "description": "[PROTOCOL-CORE] Root span definition of the Trace (follows L1 trace-base structure)."
52
- },
53
- "status": {
54
- "type": "string",
55
- "description": "[PROTOCOL-CORE] Current status of the Trace.",
56
- "enum": [
57
- "pending",
58
- "running",
59
- "completed",
60
- "failed",
61
- "cancelled"
62
- ]
63
- },
64
- "started_at": {
65
- "type": "string",
66
- "format": "date-time",
67
- "description": "[PROTOCOL-CORE] Trace start time (ISO 8601)."
68
- },
69
- "finished_at": {
70
- "type": "string",
71
- "format": "date-time",
72
- "description": "[PROTOCOL-CORE] Trace finish time (ISO 8601, optional if not finished)."
73
- },
74
- "segments": {
75
- "type": "array",
76
- "description": "[PROTOCOL-CORE] Key execution segments in the Trace (can correspond to multiple spans or phased aggregations).",
77
- "items": {
78
- "$ref": "#/$defs/trace_segment_core"
79
- }
80
- },
81
- "events": {
82
- "type": "array",
83
- "description": "[PROTOCOL-CORE] List of events directly related to this Trace (errors, retries, status changes, etc.).",
84
- "items": {
85
- "$ref": "common/events.schema.json"
86
- }
87
- }
88
- },
89
- "required": [
90
- "meta",
91
- "trace_id",
92
- "context_id",
93
- "root_span",
94
- "status"
95
- ],
96
- "$defs": {
97
- "trace_core_properties": {
98
- "type": "object",
99
- "properties": {
100
- "meta": {
101
- "$ref": "common/metadata.schema.json",
102
- "description": "[PROTOCOL-CORE] MPLP protocol and schema metadata."
103
- },
104
- "trace_id": {
105
- "$ref": "common/identifiers.schema.json",
106
- "description": "[PROTOCOL-CORE] Global unique identifier for the Trace."
107
- },
108
- "context_id": {
109
- "$ref": "common/identifiers.schema.json",
110
- "description": "[PROTOCOL-CORE] Identifier of the Context this Trace belongs to."
111
- },
112
- "plan_id": {
113
- "$ref": "common/identifiers.schema.json",
114
- "description": "[PROTOCOL-CORE] Identifier of the Plan associated with this Trace (if any)."
115
- },
116
- "root_span": {
117
- "$ref": "common/trace-base.schema.json",
118
- "description": "[PROTOCOL-CORE] Root span definition of the Trace (follows L1 trace-base structure)."
119
- },
120
- "status": {
121
- "type": "string",
122
- "description": "[PROTOCOL-CORE] Current status of the Trace.",
123
- "enum": [
124
- "pending",
125
- "running",
126
- "completed",
127
- "failed",
128
- "cancelled"
129
- ]
130
- },
131
- "started_at": {
132
- "type": "string",
133
- "format": "date-time",
134
- "description": "[PROTOCOL-CORE] Trace start time (ISO 8601)."
135
- },
136
- "finished_at": {
137
- "type": "string",
138
- "format": "date-time",
139
- "description": "[PROTOCOL-CORE] Trace finish time (ISO 8601, optional if not finished)."
140
- },
141
- "segments": {
142
- "type": "array",
143
- "description": "[PROTOCOL-CORE] Key execution segments in the Trace (can correspond to multiple spans or phased aggregations).",
144
- "items": {
145
- "$ref": "#/$defs/trace_segment_core"
146
- }
147
- },
148
- "events": {
149
- "type": "array",
150
- "description": "[PROTOCOL-CORE] List of events directly related to this Trace (errors, retries, status changes, etc.).",
151
- "items": {
152
- "$ref": "common/events.schema.json"
153
- }
154
- }
155
- },
156
- "required": [
157
- "meta",
158
- "trace_id",
159
- "context_id",
160
- "root_span",
161
- "status"
162
- ]
163
- },
164
- "trace_segment_core": {
165
- "type": "object",
166
- "description": "[PROTOCOL-CORE] Key segments in execution tracing, used to express an auditable execution interval at the protocol layer.",
167
- "additionalProperties": false,
168
- "properties": {
169
- "segment_id": {
170
- "$ref": "common/identifiers.schema.json",
171
- "description": "[PROTOCOL-CORE] Segment identifier."
172
- },
173
- "parent_segment_id": {
174
- "$ref": "common/identifiers.schema.json",
175
- "description": "[PROTOCOL-CORE] Parent segment identifier (optional if root segment)."
176
- },
177
- "label": {
178
- "type": "string",
179
- "description": "[PROTOCOL-CORE] Segment label/name, for human and Agent identification of the interval."
180
- },
181
- "status": {
182
- "type": "string",
183
- "description": "[PROTOCOL-CORE] Segment status.",
184
- "enum": [
185
- "pending",
186
- "running",
187
- "completed",
188
- "failed",
189
- "cancelled",
190
- "skipped"
191
- ]
192
- },
193
- "started_at": {
194
- "type": "string",
195
- "format": "date-time",
196
- "description": "[PROTOCOL-CORE] Segment start time."
197
- },
198
- "finished_at": {
199
- "type": "string",
200
- "format": "date-time",
201
- "description": "[PROTOCOL-CORE] Segment finish time (optional if not finished)."
202
- },
203
- "attributes": {
204
- "type": "object",
205
- "description": "[PROTOCOL-CORE] Key context attributes related to this segment (key-value form, for tracing and audit).",
206
- "additionalProperties": true
207
- }
208
- },
209
- "required": [
210
- "segment_id",
211
- "label",
212
- "status"
213
- ]
214
- }
215
- }
216
- }
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-trace.schema.json",
5
+ "title": "MPLP Trace Module – Core Protocol v1.0",
6
+ "description": "Trace Module Core Protocol: Describes the minimal required semantics (Core Profile) for execution trace resources (Trace) and their key segments and events.",
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."
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
+ "trace_id": {
38
+ "$ref": "common/identifiers.schema.json",
39
+ "description": "[PROTOCOL-CORE] Global unique identifier for the Trace."
40
+ },
41
+ "context_id": {
42
+ "$ref": "common/identifiers.schema.json",
43
+ "description": "[PROTOCOL-CORE] Identifier of the Context this Trace belongs to."
44
+ },
45
+ "plan_id": {
46
+ "$ref": "common/identifiers.schema.json",
47
+ "description": "[PROTOCOL-CORE] Identifier of the Plan associated with this Trace (if any)."
48
+ },
49
+ "root_span": {
50
+ "$ref": "common/trace-base.schema.json",
51
+ "description": "[PROTOCOL-CORE] Root span definition of the Trace (follows L1 trace-base structure)."
52
+ },
53
+ "status": {
54
+ "type": "string",
55
+ "description": "[PROTOCOL-CORE] Current status of the Trace.",
56
+ "enum": [
57
+ "pending",
58
+ "running",
59
+ "completed",
60
+ "failed",
61
+ "cancelled"
62
+ ]
63
+ },
64
+ "started_at": {
65
+ "type": "string",
66
+ "format": "date-time",
67
+ "description": "[PROTOCOL-CORE] Trace start time (ISO 8601)."
68
+ },
69
+ "finished_at": {
70
+ "type": "string",
71
+ "format": "date-time",
72
+ "description": "[PROTOCOL-CORE] Trace finish time (ISO 8601, optional if not finished)."
73
+ },
74
+ "segments": {
75
+ "type": "array",
76
+ "description": "[PROTOCOL-CORE] Key execution segments in the Trace (can correspond to multiple spans or phased aggregations).",
77
+ "items": {
78
+ "$ref": "#/$defs/trace_segment_core"
79
+ }
80
+ },
81
+ "events": {
82
+ "type": "array",
83
+ "description": "[PROTOCOL-CORE] List of events directly related to this Trace (errors, retries, status changes, etc.).",
84
+ "items": {
85
+ "$ref": "common/events.schema.json"
86
+ }
87
+ }
88
+ },
89
+ "required": [
90
+ "meta",
91
+ "trace_id",
92
+ "context_id",
93
+ "root_span",
94
+ "status"
95
+ ],
96
+ "$defs": {
97
+ "trace_core_properties": {
98
+ "type": "object",
99
+ "properties": {
100
+ "meta": {
101
+ "$ref": "common/metadata.schema.json",
102
+ "description": "[PROTOCOL-CORE] MPLP protocol and schema metadata."
103
+ },
104
+ "trace_id": {
105
+ "$ref": "common/identifiers.schema.json",
106
+ "description": "[PROTOCOL-CORE] Global unique identifier for the Trace."
107
+ },
108
+ "context_id": {
109
+ "$ref": "common/identifiers.schema.json",
110
+ "description": "[PROTOCOL-CORE] Identifier of the Context this Trace belongs to."
111
+ },
112
+ "plan_id": {
113
+ "$ref": "common/identifiers.schema.json",
114
+ "description": "[PROTOCOL-CORE] Identifier of the Plan associated with this Trace (if any)."
115
+ },
116
+ "root_span": {
117
+ "$ref": "common/trace-base.schema.json",
118
+ "description": "[PROTOCOL-CORE] Root span definition of the Trace (follows L1 trace-base structure)."
119
+ },
120
+ "status": {
121
+ "type": "string",
122
+ "description": "[PROTOCOL-CORE] Current status of the Trace.",
123
+ "enum": [
124
+ "pending",
125
+ "running",
126
+ "completed",
127
+ "failed",
128
+ "cancelled"
129
+ ]
130
+ },
131
+ "started_at": {
132
+ "type": "string",
133
+ "format": "date-time",
134
+ "description": "[PROTOCOL-CORE] Trace start time (ISO 8601)."
135
+ },
136
+ "finished_at": {
137
+ "type": "string",
138
+ "format": "date-time",
139
+ "description": "[PROTOCOL-CORE] Trace finish time (ISO 8601, optional if not finished)."
140
+ },
141
+ "segments": {
142
+ "type": "array",
143
+ "description": "[PROTOCOL-CORE] Key execution segments in the Trace (can correspond to multiple spans or phased aggregations).",
144
+ "items": {
145
+ "$ref": "#/$defs/trace_segment_core"
146
+ }
147
+ },
148
+ "events": {
149
+ "type": "array",
150
+ "description": "[PROTOCOL-CORE] List of events directly related to this Trace (errors, retries, status changes, etc.).",
151
+ "items": {
152
+ "$ref": "common/events.schema.json"
153
+ }
154
+ }
155
+ },
156
+ "required": [
157
+ "meta",
158
+ "trace_id",
159
+ "context_id",
160
+ "root_span",
161
+ "status"
162
+ ]
163
+ },
164
+ "trace_segment_core": {
165
+ "type": "object",
166
+ "description": "[PROTOCOL-CORE] Key segments in execution tracing, used to express an auditable execution interval at the protocol layer.",
167
+ "additionalProperties": false,
168
+ "properties": {
169
+ "segment_id": {
170
+ "$ref": "common/identifiers.schema.json",
171
+ "description": "[PROTOCOL-CORE] Segment identifier."
172
+ },
173
+ "parent_segment_id": {
174
+ "$ref": "common/identifiers.schema.json",
175
+ "description": "[PROTOCOL-CORE] Parent segment identifier (optional if root segment)."
176
+ },
177
+ "label": {
178
+ "type": "string",
179
+ "description": "[PROTOCOL-CORE] Segment label/name, for human and Agent identification of the interval."
180
+ },
181
+ "status": {
182
+ "type": "string",
183
+ "description": "[PROTOCOL-CORE] Segment status.",
184
+ "enum": [
185
+ "pending",
186
+ "running",
187
+ "completed",
188
+ "failed",
189
+ "cancelled",
190
+ "skipped"
191
+ ]
192
+ },
193
+ "started_at": {
194
+ "type": "string",
195
+ "format": "date-time",
196
+ "description": "[PROTOCOL-CORE] Segment start time."
197
+ },
198
+ "finished_at": {
199
+ "type": "string",
200
+ "format": "date-time",
201
+ "description": "[PROTOCOL-CORE] Segment finish time (optional if not finished)."
202
+ },
203
+ "attributes": {
204
+ "type": "object",
205
+ "description": "[PROTOCOL-CORE] Key context attributes related to this segment (key-value form, for tracing and audit).",
206
+ "additionalProperties": true
207
+ }
208
+ },
209
+ "required": [
210
+ "segment_id",
211
+ "label",
212
+ "status"
213
+ ]
214
+ }
215
+ }
216
+ }