@mplp/schema 1.0.1 → 1.0.3

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 +61 -0
  2. package/dist/index.d.ts +0 -11
  3. package/dist/index.js +7 -11
  4. package/package.json +24 -5
  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/learning/mplp-learning-sample-delta.schema.json CHANGED
@@ -1,137 +1,137 @@
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://mplp.dev/schemas/v1.0/learning/mplp-learning-sample-delta.schema.json",
5
- "title": "MPLP LearningSample – Delta Impact v1.0",
6
- "description": "Specialized schema for delta_impact samples capturing change effect analysis and compensation planning",
7
- "allOf": [
8
- {
9
- "$ref": "mplp-learning-sample-core.schema.json"
10
- },
11
- {
12
- "type": "object",
13
- "properties": {
14
- "sample_family": {
15
- "const": "delta_impact",
16
- "description": "Must be 'delta_impact' for this sample type"
17
- },
18
- "input": {
19
- "type": "object",
20
- "properties": {
21
- "delta_id": {
22
- "type": "string",
23
- "description": "Delta Intent identifier"
24
- },
25
- "intent_id": {
26
- "type": "string",
27
- "description": "Original intent being modified"
28
- },
29
- "delta_type": {
30
- "type": "string",
31
- "enum": [
32
- "refinement",
33
- "correction",
34
- "expansion",
35
- "reduction",
36
- "pivot"
37
- ],
38
- "description": "Type of delta change"
39
- },
40
- "change_summary": {
41
- "type": "string",
42
- "description": "Abstracted summary of requested change"
43
- }
44
- },
45
- "required": [
46
- "delta_id",
47
- "intent_id",
48
- "change_summary"
49
- ],
50
- "additionalProperties": true
51
- },
52
- "state": {
53
- "type": "object",
54
- "properties": {
55
- "affected_artifact_count": {
56
- "type": "integer",
57
- "minimum": 0,
58
- "description": "Optional: Number of artifacts potentially affected"
59
- },
60
- "risk_level": {
61
- "type": "string",
62
- "enum": [
63
- "low",
64
- "medium",
65
- "high",
66
- "critical"
67
- ],
68
- "description": "Assessed risk level before change"
69
- },
70
- "psg_complexity_score": {
71
- "type": "number",
72
- "minimum": 0,
73
- "description": "Optional: PSG complexity metric before change"
74
- }
75
- },
76
- "additionalProperties": true
77
- },
78
- "output": {
79
- "type": "object",
80
- "properties": {
81
- "actual_impact_summary": {
82
- "type": "string",
83
- "description": "Summary of actual impact after analysis"
84
- },
85
- "impact_scope": {
86
- "type": "string",
87
- "enum": [
88
- "local",
89
- "module",
90
- "system",
91
- "global"
92
- ],
93
- "description": "Scope of detected impact"
94
- },
95
- "comp_plan_required": {
96
- "type": "boolean",
97
- "description": "Whether compensation plan was needed"
98
- },
99
- "comp_plan_applied": {
100
- "type": "boolean",
101
- "description": "Optional: Whether compensation was actually applied"
102
- },
103
- "rollback_used": {
104
- "type": "boolean",
105
- "description": "Optional: Whether rollback mechanism was triggered"
106
- }
107
- },
108
- "required": [
109
- "actual_impact_summary",
110
- "impact_scope"
111
- ],
112
- "additionalProperties": true
113
- },
114
- "meta": {
115
- "type": "object",
116
- "properties": {
117
- "impact_analysis_duration_ms": {
118
- "type": "integer",
119
- "minimum": 0,
120
- "description": "Optional: Time spent on impact analysis"
121
- },
122
- "predicted_vs_actual_accuracy": {
123
- "type": "string",
124
- "enum": [
125
- "accurate",
126
- "underestimated",
127
- "overestimated"
128
- ],
129
- "description": "Optional: Accuracy of impact prediction"
130
- }
131
- },
132
- "additionalProperties": true
133
- }
134
- }
135
- }
136
- ]
137
- }
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://mplp.dev/schemas/v1.0/learning/mplp-learning-sample-delta.schema.json",
5
+ "title": "MPLP LearningSample – Delta Impact v1.0",
6
+ "description": "Specialized schema for delta_impact samples capturing change effect analysis and compensation planning",
7
+ "allOf": [
8
+ {
9
+ "$ref": "mplp-learning-sample-core.schema.json"
10
+ },
11
+ {
12
+ "type": "object",
13
+ "properties": {
14
+ "sample_family": {
15
+ "const": "delta_impact",
16
+ "description": "Must be 'delta_impact' for this sample type"
17
+ },
18
+ "input": {
19
+ "type": "object",
20
+ "properties": {
21
+ "delta_id": {
22
+ "type": "string",
23
+ "description": "Delta Intent identifier"
24
+ },
25
+ "intent_id": {
26
+ "type": "string",
27
+ "description": "Original intent being modified"
28
+ },
29
+ "delta_type": {
30
+ "type": "string",
31
+ "enum": [
32
+ "refinement",
33
+ "correction",
34
+ "expansion",
35
+ "reduction",
36
+ "pivot"
37
+ ],
38
+ "description": "Type of delta change"
39
+ },
40
+ "change_summary": {
41
+ "type": "string",
42
+ "description": "Abstracted summary of requested change"
43
+ }
44
+ },
45
+ "required": [
46
+ "delta_id",
47
+ "intent_id",
48
+ "change_summary"
49
+ ],
50
+ "additionalProperties": true
51
+ },
52
+ "state": {
53
+ "type": "object",
54
+ "properties": {
55
+ "affected_artifact_count": {
56
+ "type": "integer",
57
+ "minimum": 0,
58
+ "description": "Optional: Number of artifacts potentially affected"
59
+ },
60
+ "risk_level": {
61
+ "type": "string",
62
+ "enum": [
63
+ "low",
64
+ "medium",
65
+ "high",
66
+ "critical"
67
+ ],
68
+ "description": "Assessed risk level before change"
69
+ },
70
+ "psg_complexity_score": {
71
+ "type": "number",
72
+ "minimum": 0,
73
+ "description": "Optional: PSG complexity metric before change"
74
+ }
75
+ },
76
+ "additionalProperties": true
77
+ },
78
+ "output": {
79
+ "type": "object",
80
+ "properties": {
81
+ "actual_impact_summary": {
82
+ "type": "string",
83
+ "description": "Summary of actual impact after analysis"
84
+ },
85
+ "impact_scope": {
86
+ "type": "string",
87
+ "enum": [
88
+ "local",
89
+ "module",
90
+ "system",
91
+ "global"
92
+ ],
93
+ "description": "Scope of detected impact"
94
+ },
95
+ "comp_plan_required": {
96
+ "type": "boolean",
97
+ "description": "Whether compensation plan was needed"
98
+ },
99
+ "comp_plan_applied": {
100
+ "type": "boolean",
101
+ "description": "Optional: Whether compensation was actually applied"
102
+ },
103
+ "rollback_used": {
104
+ "type": "boolean",
105
+ "description": "Optional: Whether rollback mechanism was triggered"
106
+ }
107
+ },
108
+ "required": [
109
+ "actual_impact_summary",
110
+ "impact_scope"
111
+ ],
112
+ "additionalProperties": true
113
+ },
114
+ "meta": {
115
+ "type": "object",
116
+ "properties": {
117
+ "impact_analysis_duration_ms": {
118
+ "type": "integer",
119
+ "minimum": 0,
120
+ "description": "Optional: Time spent on impact analysis"
121
+ },
122
+ "predicted_vs_actual_accuracy": {
123
+ "type": "string",
124
+ "enum": [
125
+ "accurate",
126
+ "underestimated",
127
+ "overestimated"
128
+ ],
129
+ "description": "Optional: Accuracy of impact prediction"
130
+ }
131
+ },
132
+ "additionalProperties": true
133
+ }
134
+ }
135
+ }
136
+ ]
137
+ }
package/schemas/learning/mplp-learning-sample-intent.schema.json CHANGED
@@ -1,119 +1,119 @@
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://mplp.dev/schemas/v1.0/learning/mplp-learning-sample-intent.schema.json",
5
- "title": "MPLP LearningSample – Intent Resolution v1.0",
6
- "description": "Specialized schema for intent_resolution samples capturing user intent clarification and plan generation",
7
- "allOf": [
8
- {
9
- "$ref": "mplp-learning-sample-core.schema.json"
10
- },
11
- {
12
- "type": "object",
13
- "properties": {
14
- "sample_family": {
15
- "const": "intent_resolution",
16
- "description": "Must be 'intent_resolution' for this sample type"
17
- },
18
- "input": {
19
- "type": "object",
20
- "properties": {
21
- "intent_id": {
22
- "type": "string",
23
- "description": "Intent identifier from IntentEvent or Plan.intent_model"
24
- },
25
- "raw_request_summary": {
26
- "type": "string",
27
- "description": "Abstracted summary of original user request (PII-scrubbed if needed)"
28
- },
29
- "constraints_summary": {
30
- "type": "string",
31
- "description": "Optional: Key constraints mentioned (timeline, budget, resources, etc.)"
32
- },
33
- "dialog_turns_count": {
34
- "type": "integer",
35
- "minimum": 0,
36
- "description": "Optional: Number of dialog exchanges before intent resolution"
37
- }
38
- },
39
- "required": [
40
- "intent_id",
41
- "raw_request_summary"
42
- ],
43
- "additionalProperties": true
44
- },
45
- "state": {
46
- "type": "object",
47
- "properties": {
48
- "project_phase": {
49
- "type": "string",
50
- "description": "Optional: Project state (greenfield, brownfield, maintenance, etc.)"
51
- },
52
- "psg_node_count": {
53
- "type": "integer",
54
- "minimum": 0,
55
- "description": "Optional: PSG size before intent application"
56
- },
57
- "existing_plan_count": {
58
- "type": "integer",
59
- "minimum": 0,
60
- "description": "Optional: Number of existing plans in context"
61
- }
62
- },
63
- "additionalProperties": true
64
- },
65
- "output": {
66
- "type": "object",
67
- "properties": {
68
- "final_intent_summary": {
69
- "type": "string",
70
- "description": "Refined/clarified intent after resolution process"
71
- },
72
- "plan_id": {
73
- "type": "string",
74
- "format": "uuid",
75
- "description": "Optional: Generated Plan identifier (if plan created)"
76
- },
77
- "plan_step_count": {
78
- "type": "integer",
79
- "minimum": 0,
80
- "description": "Optional: Number of steps in generated plan"
81
- },
82
- "resolution_quality_label": {
83
- "type": "string",
84
- "enum": [
85
- "good",
86
- "acceptable",
87
- "bad",
88
- "unknown"
89
- ],
90
- "description": "Assessment of intent resolution quality"
91
- }
92
- },
93
- "required": [
94
- "final_intent_summary"
95
- ],
96
- "additionalProperties": true
97
- },
98
- "meta": {
99
- "type": "object",
100
- "properties": {
101
- "clarification_rounds": {
102
- "type": "integer",
103
- "minimum": 0,
104
- "description": "Optional: Clarification rounds needed before resolution"
105
- },
106
- "ambiguity_flags": {
107
- "type": "array",
108
- "items": {
109
- "type": "string"
110
- },
111
- "description": "Optional: Detected ambiguity types (vague_scope, missing_constraints, etc.)"
112
- }
113
- },
114
- "additionalProperties": true
115
- }
116
- }
117
- }
118
- ]
119
- }
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://mplp.dev/schemas/v1.0/learning/mplp-learning-sample-intent.schema.json",
5
+ "title": "MPLP LearningSample – Intent Resolution v1.0",
6
+ "description": "Specialized schema for intent_resolution samples capturing user intent clarification and plan generation",
7
+ "allOf": [
8
+ {
9
+ "$ref": "mplp-learning-sample-core.schema.json"
10
+ },
11
+ {
12
+ "type": "object",
13
+ "properties": {
14
+ "sample_family": {
15
+ "const": "intent_resolution",
16
+ "description": "Must be 'intent_resolution' for this sample type"
17
+ },
18
+ "input": {
19
+ "type": "object",
20
+ "properties": {
21
+ "intent_id": {
22
+ "type": "string",
23
+ "description": "Intent identifier from IntentEvent or Plan.intent_model"
24
+ },
25
+ "raw_request_summary": {
26
+ "type": "string",
27
+ "description": "Abstracted summary of original user request (PII-scrubbed if needed)"
28
+ },
29
+ "constraints_summary": {
30
+ "type": "string",
31
+ "description": "Optional: Key constraints mentioned (timeline, budget, resources, etc.)"
32
+ },
33
+ "dialog_turns_count": {
34
+ "type": "integer",
35
+ "minimum": 0,
36
+ "description": "Optional: Number of dialog exchanges before intent resolution"
37
+ }
38
+ },
39
+ "required": [
40
+ "intent_id",
41
+ "raw_request_summary"
42
+ ],
43
+ "additionalProperties": true
44
+ },
45
+ "state": {
46
+ "type": "object",
47
+ "properties": {
48
+ "project_phase": {
49
+ "type": "string",
50
+ "description": "Optional: Project state (greenfield, brownfield, maintenance, etc.)"
51
+ },
52
+ "psg_node_count": {
53
+ "type": "integer",
54
+ "minimum": 0,
55
+ "description": "Optional: PSG size before intent application"
56
+ },
57
+ "existing_plan_count": {
58
+ "type": "integer",
59
+ "minimum": 0,
60
+ "description": "Optional: Number of existing plans in context"
61
+ }
62
+ },
63
+ "additionalProperties": true
64
+ },
65
+ "output": {
66
+ "type": "object",
67
+ "properties": {
68
+ "final_intent_summary": {
69
+ "type": "string",
70
+ "description": "Refined/clarified intent after resolution process"
71
+ },
72
+ "plan_id": {
73
+ "type": "string",
74
+ "format": "uuid",
75
+ "description": "Optional: Generated Plan identifier (if plan created)"
76
+ },
77
+ "plan_step_count": {
78
+ "type": "integer",
79
+ "minimum": 0,
80
+ "description": "Optional: Number of steps in generated plan"
81
+ },
82
+ "resolution_quality_label": {
83
+ "type": "string",
84
+ "enum": [
85
+ "good",
86
+ "acceptable",
87
+ "bad",
88
+ "unknown"
89
+ ],
90
+ "description": "Assessment of intent resolution quality"
91
+ }
92
+ },
93
+ "required": [
94
+ "final_intent_summary"
95
+ ],
96
+ "additionalProperties": true
97
+ },
98
+ "meta": {
99
+ "type": "object",
100
+ "properties": {
101
+ "clarification_rounds": {
102
+ "type": "integer",
103
+ "minimum": 0,
104
+ "description": "Optional: Clarification rounds needed before resolution"
105
+ },
106
+ "ambiguity_flags": {
107
+ "type": "array",
108
+ "items": {
109
+ "type": "string"
110
+ },
111
+ "description": "Optional: Detected ambiguity types (vague_scope, missing_constraints, etc.)"
112
+ }
113
+ },
114
+ "additionalProperties": true
115
+ }
116
+ }
117
+ }
118
+ ]
119
+ }