id.sifa.endorsement
Schema Diff
+13 -4
Compatibility Analysis
Breaking Changes Detected
1 breaking change, 6 non-breaking changes.
Breaking Changes (1)
- RequiredEdgeRemoved RequiredEdgeRemoved { vertex_id: "id.sifa.endorsement:body", src: "id.sifa.endorsement:body", tgt: "id.sifa.endorsement:body.skill", kind: "prop", name: Some("skill") }
Non-Breaking Changes (6)
- AddedVertex AddedVertex { vertex_id: "id.sifa.endorsement:body.credentialRef" }
- AddedVertex AddedVertex { vertex_id: "id.sifa.endorsement:body.positionRef" }
- AddedEdge AddedEdge { src: "id.sifa.endorsement:body", tgt: "id.sifa.endorsement:body.credentialRef", kind: "prop", name: Some("credentialRef") }
- AddedEdge AddedEdge { src: "id.sifa.endorsement:body", tgt: "id.sifa.endorsement:body.positionRef", kind: "prop", name: Some("positionRef") }
- AddedEdge AddedEdge { src: "id.sifa.endorsement:body.credentialRef", tgt: "com.atproto.repo.strongRef", kind: "ref", name: None }
- AddedEdge AddedEdge { src: "id.sifa.endorsement:body.positionRef", tgt: "com.atproto.repo.strongRef", kind: "ref", name: None }
Migration Guidance
Added Elements
AddedVertex { vertex_id: "id.sifa.endorsement:body.credentialRef" }AddedVertex { vertex_id: "id.sifa.endorsement:body.positionRef" }
Additional Notes
- Breaking: RequiredEdgeRemoved { vertex_id: "id.sifa.endorsement:body", src: "id.sifa.endorsement:body", tgt: "id.sifa.endorsement:body.skill", kind: "prop", name: Some("skill") }
- Non-breaking: AddedEdge { src: "id.sifa.endorsement:body", tgt: "id.sifa.endorsement:body.credentialRef", kind: "prop", name: Some("credentialRef") }
- Non-breaking: AddedEdge { src: "id.sifa.endorsement:body", tgt: "id.sifa.endorsement:body.positionRef", kind: "prop", name: Some("positionRef") }
- Non-breaking: AddedEdge { src: "id.sifa.endorsement:body.credentialRef", tgt: "com.atproto.repo.strongRef", kind: "ref", name: None }
- Non-breaking: AddedEdge { src: "id.sifa.endorsement:body.positionRef", tgt: "com.atproto.repo.strongRef", kind: "ref", name: None }
1
1
{
2
2
"id": "id.sifa.endorsement",
3
3
"defs": {
4
4
"main": {
5
5
"key": "tid",
6
6
"type": "record",
7
7
"record": {
8
8
"type": "object",
9
9
"required": [
10
10
"subject",
11
-
"skill",
12
11
"skillName",
13
12
"createdAt"
14
13
],
15
14
"properties": {
16
15
"skill": {
17
16
"ref": "com.atproto.repo.strongRef",
18
17
"type": "ref",
19
-
"description": "StrongRef to the id.sifa.profile.skill record being endorsed. The AT-URI identifies the skill, and the CID pins the version."
18
+
"description": "StrongRef to the id.sifa.profile.skill record being endorsed. The AT-URI identifies the skill, and the CID pins the version. Optional: when absent, the endorser is proposing a skill the subject has not listed, named by skillName. The subject materialises the skill record on acceptance and links it from their id.sifa.endorsement.confirmation, since only they can write to their own repository."
20
19
},
21
20
"comment": {
22
21
"type": "string",
23
22
"maxLength": 3000,
24
23
"description": "Optional brief comment explaining the endorsement.",
25
24
"maxGraphemes": 300
26
25
},
27
26
"subject": {
28
27
"type": "string",
29
28
"format": "did",
30
29
"description": "DID of the user whose skill is being endorsed."
31
30
},
32
31
"createdAt": {
33
32
"type": "string",
34
33
"format": "datetime",
35
34
"description": "Client-declared timestamp when this endorsement was created."
36
35
},
37
36
"skillName": {
38
37
"type": "string",
39
38
"maxLength": 640,
40
39
"minLength": 1,
41
-
"description": "Skill name at endorsement time, captured from the endorsed record. This is the anchor field: if the skill is later renamed, this value lets the AppView detect that the endorsed claim may no longer match the current record. Stored in the endorser's PDS, so the endorsee cannot modify it.",
40
+
"description": "Skill name at endorsement time. When skill is present this is captured from the endorsed record and acts as the anchor: if the skill is later renamed, this value lets the AppView detect that the endorsed claim may no longer match the current record. When skill is absent this is the proposed name for a skill the subject does not yet have. Stored in the endorser's PDS, so the endorsee cannot modify it.",
42
41
"maxGraphemes": 64
42
+
},
43
+
"positionRef": {
44
+
"ref": "com.atproto.repo.strongRef",
45
+
"type": "ref",
46
+
"description": "Optional reference to the id.sifa.position record this endorsement relates to. When present, indicates the endorsement is contextualised to a specific role rather than a general skill."
47
+
},
48
+
"credentialRef": {
49
+
"ref": "com.atproto.repo.strongRef",
50
+
"type": "ref",
51
+
"description": "Optional reference to an education or credential record this endorsement confirms. May be set alongside positionRef when the endorsement relates to both a role and a credential."
43
52
}
44
53
}
45
54
},
46
55
"description": "Record representing an endorsement of another user's claimed skill."
47
56
}
48
57
},
49
58
"$type": "com.atproto.lexicon.schema",
50
59
"lexicon": 1,
51
-
"description": "An endorsement of another user's skill. Lives in the endorser's PDS; the endorser is implicit (whoever owns the repository)."
60
+
"description": "An endorsement of another user's skill. Lives in the endorser's PDS; the endorser is implicit (whoever owns the repository). May endorse a skill the subject already lists, or propose one they do not."
52
61
}