org.hypercerts.claim.activity

hypercerts.org

Schema Diff

+59 -27

From

CID
bafyreic4txdwd7t...
Indexed At
2026-02-18 19:46 UTC
View this version

To

CID
bafyreiavdo7b5xz...
Indexed At
2026-07-26 20:13 UTC
View this version

Compatibility Analysis

Breaking Changes Detected

15 breaking changes, 27 non-breaking changes.

Breaking Changes (15)
  • RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "org.hypercerts.claim.activity#workScopeString", src: "org.hypercerts.claim.activity#workScopeString", tgt: "org.hypercerts.claim.activity#workScopeString.scope", kind: "prop", name: Some("scope") }
  • RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "org.hypercerts.claim.activity#contributorRole", src: "org.hypercerts.claim.activity#contributorRole", tgt: "org.hypercerts.claim.activity#contributorRole.role", kind: "prop", name: Some("role") }
  • RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "org.hypercerts.claim.activity#contributorIdentity", src: "org.hypercerts.claim.activity#contributorIdentity", tgt: "org.hypercerts.claim.activity#contributorIdentity.identity", kind: "prop", name: Some("identity") }
  • RemovedVertex RemovedVertex { vertex_id: "org.hypercerts.claim.activity:body.descriptionFacets" }
  • RemovedVertex RemovedVertex { vertex_id: "org.hypercerts.claim.activity:body.descriptionFacets:items" }
  • RemovedEdge RemovedEdge { src: "org.hypercerts.claim.activity:body", tgt: "org.hypercerts.claim.activity:body.descriptionFacets", kind: "prop", name: Some("descriptionFacets") }
  • RemovedEdge RemovedEdge { src: "org.hypercerts.claim.activity:body.descriptionFacets", tgt: "org.hypercerts.claim.activity:body.descriptionFacets:items", kind: "items", name: None }
  • RemovedEdge RemovedEdge { src: "org.hypercerts.claim.activity:body.descriptionFacets:items", tgt: "app.bsky.richtext.facet", kind: "ref", name: None }
  • RemovedEdge RemovedEdge { src: "org.hypercerts.claim.activity:body.workScope", tgt: "org.hypercerts.claim.activity:body.workScope:variant0", kind: "variant", name: Some("com.atproto.repo.strongRef") }
  • RemovedEdge RemovedEdge { src: "org.hypercerts.claim.activity:body.workScope:variant0", tgt: "com.atproto.repo.strongRef", kind: "ref", name: None }
  • KindChanged KindChanged { vertex_id: "org.hypercerts.claim.activity#contributorIdentity", old_kind: "string", new_kind: "object" }
  • KindChanged KindChanged { vertex_id: "org.hypercerts.claim.activity#contributorRole", old_kind: "string", new_kind: "object" }
  • KindChanged KindChanged { vertex_id: "org.hypercerts.claim.activity#workScopeString", old_kind: "string", new_kind: "object" }
  • KindChanged KindChanged { vertex_id: "org.hypercerts.claim.activity:body.description", old_kind: "string", new_kind: "union" }
  • ConstraintAdded ConstraintAdded { vertex_id: "org.hypercerts.claim.activity#contributor.contributionWeight", sort: "maxLength", value: "100" }
Non-Breaking Changes (27)
  • AddedVertex AddedVertex { vertex_id: "app.certified.signature.defs#list" }
  • AddedVertex AddedVertex { vertex_id: "org.hypercerts.claim.activity#contributorIdentity.identity" }
  • AddedVertex AddedVertex { vertex_id: "org.hypercerts.claim.activity#contributorRole.role" }
  • AddedVertex AddedVertex { vertex_id: "org.hypercerts.claim.activity#workScopeString.scope" }
  • AddedVertex AddedVertex { vertex_id: "org.hypercerts.claim.activity:body.description:variant0" }
  • AddedVertex AddedVertex { vertex_id: "org.hypercerts.claim.activity:body.description:variant1" }
  • AddedVertex AddedVertex { vertex_id: "org.hypercerts.claim.activity:body.description:variant2" }
  • AddedVertex AddedVertex { vertex_id: "org.hypercerts.claim.activity:body.signatures" }
  • AddedVertex AddedVertex { vertex_id: "org.hypercerts.defs#descriptionString" }
  • AddedVertex AddedVertex { vertex_id: "org.hypercerts.workscope.cel" }
  • AddedVertex AddedVertex { vertex_id: "pub.leaflet.pages.linearDocument" }
  • AddedEdge AddedEdge { src: "org.hypercerts.claim.activity:body", tgt: "org.hypercerts.claim.activity:body.signatures", kind: "prop", name: Some("signatures") }
  • AddedEdge AddedEdge { src: "org.hypercerts.claim.activity:body.description", tgt: "org.hypercerts.claim.activity:body.description:variant0", kind: "variant", name: Some("org.hypercerts.defs#descriptionString") }
  • AddedEdge AddedEdge { src: "org.hypercerts.claim.activity:body.description", tgt: "org.hypercerts.claim.activity:body.description:variant1", kind: "variant", name: Some("pub.leaflet.pages.linearDocument") }
  • AddedEdge AddedEdge { src: "org.hypercerts.claim.activity:body.description", tgt: "org.hypercerts.claim.activity:body.description:variant2", kind: "variant", name: Some("com.atproto.repo.strongRef") }
  • AddedEdge AddedEdge { src: "org.hypercerts.claim.activity:body.description:variant0", tgt: "org.hypercerts.defs#descriptionString", kind: "ref", name: None }
  • AddedEdge AddedEdge { src: "org.hypercerts.claim.activity:body.description:variant1", tgt: "pub.leaflet.pages.linearDocument", kind: "ref", name: None }
  • AddedEdge AddedEdge { src: "org.hypercerts.claim.activity:body.description:variant2", tgt: "com.atproto.repo.strongRef", kind: "ref", name: None }
  • AddedEdge AddedEdge { src: "org.hypercerts.claim.activity:body.signatures", tgt: "app.certified.signature.defs#list", kind: "ref", name: None }
  • AddedEdge AddedEdge { src: "org.hypercerts.claim.activity:body.workScope", tgt: "org.hypercerts.claim.activity:body.workScope:variant0", kind: "variant", name: Some("org.hypercerts.workscope.cel") }
  • AddedEdge AddedEdge { src: "org.hypercerts.claim.activity:body.workScope:variant0", tgt: "org.hypercerts.workscope.cel", kind: "ref", name: None }
  • ConstraintRemoved ConstraintRemoved { vertex_id: "org.hypercerts.claim.activity#contributorRole", sort: "maxLength" }
  • ConstraintRemoved ConstraintRemoved { vertex_id: "org.hypercerts.claim.activity#contributorRole", sort: "maxGraphemes" }
  • ConstraintRemoved ConstraintRemoved { vertex_id: "org.hypercerts.claim.activity:body.description", sort: "maxGraphemes" }
  • ConstraintRemoved ConstraintRemoved { vertex_id: "org.hypercerts.claim.activity:body.description", sort: "maxLength" }
  • ConstraintRemoved ConstraintRemoved { vertex_id: "org.hypercerts.claim.activity#workScopeString", sort: "maxGraphemes" }
  • ConstraintRemoved ConstraintRemoved { vertex_id: "org.hypercerts.claim.activity#workScopeString", sort: "maxLength" }

Migration Guidance

Removed Elements

  • RemovedVertex { vertex_id: "org.hypercerts.claim.activity:body.descriptionFacets" }
  • RemovedVertex { vertex_id: "org.hypercerts.claim.activity:body.descriptionFacets:items" }

Added Elements

  • AddedVertex { vertex_id: "app.certified.signature.defs#list" }
  • AddedVertex { vertex_id: "org.hypercerts.claim.activity#contributorIdentity.identity" }
  • AddedVertex { vertex_id: "org.hypercerts.claim.activity#contributorRole.role" }
  • AddedVertex { vertex_id: "org.hypercerts.claim.activity#workScopeString.scope" }
  • AddedVertex { vertex_id: "org.hypercerts.claim.activity:body.description:variant0" }
  • AddedVertex { vertex_id: "org.hypercerts.claim.activity:body.description:variant1" }
  • AddedVertex { vertex_id: "org.hypercerts.claim.activity:body.description:variant2" }
  • AddedVertex { vertex_id: "org.hypercerts.claim.activity:body.signatures" }
  • AddedVertex { vertex_id: "org.hypercerts.defs#descriptionString" }
  • AddedVertex { vertex_id: "org.hypercerts.workscope.cel" }
  • AddedVertex { vertex_id: "pub.leaflet.pages.linearDocument" }

Constraint Changes

  • ConstraintAdded ConstraintAdded { vertex_id: "org.hypercerts.claim.activity#contributor.contributionWeight", sort: "maxLength", value: "100" }
  • ConstraintRemoved ConstraintRemoved { vertex_id: "org.hypercerts.claim.activity:body.description", sort: "maxLength" }
  • ConstraintRemoved ConstraintRemoved { vertex_id: "org.hypercerts.claim.activity:body.description", sort: "maxGraphemes" }
  • ConstraintRemoved ConstraintRemoved { vertex_id: "org.hypercerts.claim.activity#contributorRole", sort: "maxLength" }
  • ConstraintRemoved ConstraintRemoved { vertex_id: "org.hypercerts.claim.activity#contributorRole", sort: "maxGraphemes" }
  • ConstraintRemoved ConstraintRemoved { vertex_id: "org.hypercerts.claim.activity#workScopeString", sort: "maxGraphemes" }
  • ConstraintRemoved ConstraintRemoved { vertex_id: "org.hypercerts.claim.activity#workScopeString", sort: "maxLength" }

Additional Notes

  • Breaking: RequiredEdgeAdded { vertex_id: "org.hypercerts.claim.activity#contributorIdentity", src: "org.hypercerts.claim.activity#contributorIdentity", tgt: "org.hypercerts.claim.activity#contributorIdentity.identity", kind: "prop", name: Some("identity") }
  • Breaking: RequiredEdgeAdded { vertex_id: "org.hypercerts.claim.activity#workScopeString", src: "org.hypercerts.claim.activity#workScopeString", tgt: "org.hypercerts.claim.activity#workScopeString.scope", kind: "prop", name: Some("scope") }
  • Breaking: RequiredEdgeAdded { vertex_id: "org.hypercerts.claim.activity#contributorRole", src: "org.hypercerts.claim.activity#contributorRole", tgt: "org.hypercerts.claim.activity#contributorRole.role", kind: "prop", name: Some("role") }
  • Breaking: RemovedEdge { src: "org.hypercerts.claim.activity:body", tgt: "org.hypercerts.claim.activity:body.descriptionFacets", kind: "prop", name: Some("descriptionFacets") }
  • Breaking: RemovedEdge { src: "org.hypercerts.claim.activity:body.descriptionFacets", tgt: "org.hypercerts.claim.activity:body.descriptionFacets:items", kind: "items", name: None }
  • Breaking: RemovedEdge { src: "org.hypercerts.claim.activity:body.descriptionFacets:items", tgt: "app.bsky.richtext.facet", kind: "ref", name: None }
  • Breaking: RemovedEdge { src: "org.hypercerts.claim.activity:body.workScope", tgt: "org.hypercerts.claim.activity:body.workScope:variant0", kind: "variant", name: Some("com.atproto.repo.strongRef") }
  • Breaking: RemovedEdge { src: "org.hypercerts.claim.activity:body.workScope:variant0", tgt: "com.atproto.repo.strongRef", kind: "ref", name: None }
  • Breaking: KindChanged { vertex_id: "org.hypercerts.claim.activity#contributorIdentity", old_kind: "string", new_kind: "object" }
  • Breaking: KindChanged { vertex_id: "org.hypercerts.claim.activity#contributorRole", old_kind: "string", new_kind: "object" }
  • Breaking: KindChanged { vertex_id: "org.hypercerts.claim.activity#workScopeString", old_kind: "string", new_kind: "object" }
  • Breaking: KindChanged { vertex_id: "org.hypercerts.claim.activity:body.description", old_kind: "string", new_kind: "union" }
  • Non-breaking: AddedEdge { src: "org.hypercerts.claim.activity:body", tgt: "org.hypercerts.claim.activity:body.signatures", kind: "prop", name: Some("signatures") }
  • Non-breaking: AddedEdge { src: "org.hypercerts.claim.activity:body.description", tgt: "org.hypercerts.claim.activity:body.description:variant0", kind: "variant", name: Some("org.hypercerts.defs#descriptionString") }
  • Non-breaking: AddedEdge { src: "org.hypercerts.claim.activity:body.description", tgt: "org.hypercerts.claim.activity:body.description:variant1", kind: "variant", name: Some("pub.leaflet.pages.linearDocument") }
  • Non-breaking: AddedEdge { src: "org.hypercerts.claim.activity:body.description", tgt: "org.hypercerts.claim.activity:body.description:variant2", kind: "variant", name: Some("com.atproto.repo.strongRef") }
  • Non-breaking: AddedEdge { src: "org.hypercerts.claim.activity:body.description:variant0", tgt: "org.hypercerts.defs#descriptionString", kind: "ref", name: None }
  • Non-breaking: AddedEdge { src: "org.hypercerts.claim.activity:body.description:variant1", tgt: "pub.leaflet.pages.linearDocument", kind: "ref", name: None }
  • Non-breaking: AddedEdge { src: "org.hypercerts.claim.activity:body.description:variant2", tgt: "com.atproto.repo.strongRef", kind: "ref", name: None }
  • Non-breaking: AddedEdge { src: "org.hypercerts.claim.activity:body.signatures", tgt: "app.certified.signature.defs#list", kind: "ref", name: None }
  • Non-breaking: AddedEdge { src: "org.hypercerts.claim.activity:body.workScope", tgt: "org.hypercerts.claim.activity:body.workScope:variant0", kind: "variant", name: Some("org.hypercerts.workscope.cel") }
  • Non-breaking: AddedEdge { src: "org.hypercerts.claim.activity:body.workScope:variant0", tgt: "org.hypercerts.workscope.cel", kind: "ref", name: None }
1 1 
{
2 2 
  "id": "org.hypercerts.claim.activity",
3 3 
  "defs": {
4 4 
    "main": {
5 5 
      "key": "any",
6 6 
      "type": "record",
7 7 
      "record": {
8 8 
        "type": "object",
9 9 
        "required": [
10 10 
          "title",
11 11 
          "shortDescription",
12 12 
          "createdAt"
13 13 
        ],
14 14 
        "properties": {
15 15 
          "image": {
16 16 
            "refs": [
17 17 
              "org.hypercerts.defs#uri",
18 18 
              "org.hypercerts.defs#smallImage"
19 19 
            ],
20 20 
            "type": "union",
21 21 
            "description": "The hypercert visual representation as a URI or image blob."
22 22 
          },
23 23 
          "title": {
24 24 
            "type": "string",
25 25 
            "maxLength": 256,
26 - 
            "description": "Title of the hypercert."
26 + 
            "description": "Display title summarizing the impact work (e.g. 'Reforestation in Amazon Basin 2024')"
27 27 
          },
28 28 
          "rights": {
29 29 
            "ref": "com.atproto.repo.strongRef",
30 30 
            "type": "ref",
31 31 
            "description": "A strong reference to the rights that this hypercert has. The record referenced must conform with the lexicon org.hypercerts.claim.rights."
32 32 
          },
33 33 
          "endDate": {
34 34 
            "type": "string",
35 35 
            "format": "datetime",
36 36 
            "description": "When the work ended"
37 37 
          },
38 38 
          "createdAt": {
39 39 
            "type": "string",
40 40 
            "format": "datetime",
41 41 
            "description": "Client-declared timestamp when this record was originally created"
42 42 
          },
43 43 
          "locations": {
44 44 
            "type": "array",
45 45 
            "items": {
46 46 
              "ref": "com.atproto.repo.strongRef",
47 47 
              "type": "ref"
48 48 
            },
49 + 
            "maxLength": 1000,
49 50 
            "description": "An array of strong references to the location where activity was performed. The record referenced must conform with the lexicon app.certified.location."
50 51 
          },
51 52 
          "startDate": {
52 53 
            "type": "string",
53 54 
            "format": "datetime",
54 55 
            "description": "When the work began"
55 56 
          },
56 57 
          "workScope": {
57 58 
            "refs": [
58 - 
              "com.atproto.repo.strongRef",
59 + 
              "org.hypercerts.workscope.cel",
59 60 
              "#workScopeString"
60 61 
            ],
61 62 
            "type": "union",
62 - 
            "description": "Work scope definition. Either a strongRef to a work-scope logic record (structured, nested logic), or a free-form string for simple or legacy scopes. The work scope record should conform to the org.hypercerts.helper.workScopeTag lexicon."
63 + 
            "description": "Work scope definition. A CEL expression for structured, machine-evaluable scopes or a free-form string for simple and legacy scopes."
64 + 
          },
65 + 
          "signatures": {
66 + 
            "ref": "app.certified.signature.defs#list",
67 + 
            "type": "ref",
68 + 
            "description": "Optional cryptographic signatures attesting to this record's content."
63 69 
          },
64 70 
          "description": {
65 - 
            "type": "string",
66 - 
            "maxLength": 30000,
67 - 
            "description": "Optional longer description of this activity claim, including context or interpretation. Rich text annotations may be provided via `descriptionFacets`.",
68 - 
            "maxGraphemes": 3000
71 + 
            "refs": [
72 + 
              "org.hypercerts.defs#descriptionString",
73 + 
              "pub.leaflet.pages.linearDocument",
74 + 
              "com.atproto.repo.strongRef"
75 + 
            ],
76 + 
            "type": "union",
77 + 
            "description": "Long-form description of the activity. An inline string for plain text or markdown, a Leaflet linear document for rich-text content, or a strong reference to an external description record."
69 78 
          },
70 79 
          "contributors": {
71 80 
            "type": "array",
72 81 
            "items": {
73 82 
              "ref": "#contributor",
74 83 
              "type": "ref"
75 84 
            },
76 85 
            "description": "An array of contributor objects, each containing contributor information, weight, and contribution details."
77 86 
          },
78 87 
          "shortDescription": {
79 88 
            "type": "string",
80 89 
            "maxLength": 3000,
81 90 
            "description": "Short summary of this activity claim, suitable for previews and list views. Rich text annotations may be provided via `shortDescriptionFacets`.",
82 91 
            "maxGraphemes": 300
83 92 
          },
84 - 
          "descriptionFacets": {
85 - 
            "type": "array",
86 - 
            "items": {
87 - 
              "ref": "app.bsky.richtext.facet",
88 - 
              "type": "ref"
89 - 
            },
90 - 
            "description": "Rich text annotations for `description` (mentions, URLs, hashtags, etc)."
91 - 
          },
92 93 
          "shortDescriptionFacets": {
93 94 
            "type": "array",
94 95 
            "items": {
95 96 
              "ref": "app.bsky.richtext.facet",
96 97 
              "type": "ref"
97 98 
            },
98 99 
            "description": "Rich text annotations for `shortDescription` (mentions, URLs, hashtags, etc)."
99 100 
          }
100 101 
        }
101 102 
      },
102 103 
      "description": "A hypercert record tracking impact work."
103 104 
    },
104 105 
    "contributor": {
105 106 
      "type": "object",
106 107 
      "required": [
107 108 
        "contributorIdentity"
108 109 
      ],
109 110 
      "properties": {
110 111 
        "contributionWeight": {
111 112 
          "type": "string",
113 + 
          "maxLength": 100,
112 114 
          "description": "The relative weight/importance of this contribution (stored as a string to avoid float precision issues). Must be a positive numeric value. Weights do not need to sum to a specific total; normalization can be performed by the consuming application as needed."
113 115 
        },
114 116 
        "contributionDetails": {
115 117 
          "refs": [
116 118 
            "#contributorRole",
117 119 
            "com.atproto.repo.strongRef"
118 120 
          ],
119 121 
          "type": "union",
120 - 
          "description": "Contribution details as a string via org.hypercerts.claim.activity#contributorRole, or a strong reference to a contribution details record."
122 + 
          "description": "Inline contribution role object with a role string via org.hypercerts.claim.activity#contributorRole, or a strong reference to a contribution details record. The record referenced must conform with the lexicon org.hypercerts.claim.contribution."
121 123 
        },
122 124 
        "contributorIdentity": {
123 125 
          "refs": [
124 126 
            "#contributorIdentity",
125 127 
            "com.atproto.repo.strongRef"
126 128 
          ],
127 129 
          "type": "union",
128 - 
          "description": "Contributor identity as a string (DID or identifier) via org.hypercerts.claim.activity#contributorIdentity, or a strong reference to a contributor information record."
130 + 
          "description": "Inline contributor identity object with an identity string (DID or identifier) via org.hypercerts.claim.activity#contributorIdentity, or a strong reference to a contributor information record. The record referenced must conform with the lexicon org.hypercerts.claim.contributorInformation."
129 131 
        }
130 - 
      }
132 + 
      },
133 + 
      "description": "A contributor to the activity, with identity, weight, and contribution details."
131 134 
    },
132 135 
    "contributorRole": {
133 - 
      "type": "string",
134 - 
      "maxLength": 10000,
135 - 
      "description": "Contribution details as a string.",
136 - 
      "maxGraphemes": 1000
136 + 
      "type": "object",
137 + 
      "required": [
138 + 
        "role"
139 + 
      ],
140 + 
      "properties": {
141 + 
        "role": {
142 + 
          "type": "string",
143 + 
          "maxLength": 1000,
144 + 
          "description": "The contribution role or details.",
145 + 
          "maxGraphemes": 100
146 + 
        }
147 + 
      },
148 + 
      "description": "Contribution details as a string."
137 149 
    },
138 150 
    "workScopeString": {
139 - 
      "type": "string",
140 - 
      "maxLength": 10000,
141 - 
      "description": "A free-form string describing the work scope for simple or legacy scopes.",
142 - 
      "maxGraphemes": 1000
151 + 
      "type": "object",
152 + 
      "required": [
153 + 
        "scope"
154 + 
      ],
155 + 
      "properties": {
156 + 
        "scope": {
157 + 
          "type": "string",
158 + 
          "maxLength": 10000,
159 + 
          "description": "The work scope description string.",
160 + 
          "maxGraphemes": 1000
161 + 
        }
162 + 
      },
163 + 
      "description": "A free-form string describing the work scope for simple or legacy scopes."
143 164 
    },
144 165 
    "contributorIdentity": {
145 - 
      "type": "string",
166 + 
      "type": "object",
167 + 
      "required": [
168 + 
        "identity"
169 + 
      ],
170 + 
      "properties": {
171 + 
        "identity": {
172 + 
          "type": "string",
173 + 
          "maxLength": 1000,
174 + 
          "description": "The contributor identity string (DID or identifier).",
175 + 
          "maxGraphemes": 100
176 + 
        }
177 + 
      },
146 178 
      "description": "Contributor information as a string (DID or identifier)."
147 179 
    }
148 180 
  },
149 181 
  "$type": "com.atproto.lexicon.schema",
150 182 
  "lexicon": 1
151 183 
}

Compare Other Versions

Lexicon Garden

@