@hypercerts-org/lexicon 0.10.0-beta.14 → 0.10.0-beta.16

package/dist/types/org/hypercerts/workscope/tag.d.ts

@@ -0,0 +1,36 @@
+/**
+ * GENERATED CODE - DO NOT MODIFY
+ */
+import { type ValidationResult } from '@atproto/lexicon';
+import { type $Typed } from '../../../../util';
+import type * as ComAtprotoRepoStrongRef from '../../../com/atproto/repo/strongRef.js';
+import type * as OrgHypercertsDefs from '../defs.js';
+export interface Main {
+    $type: 'org.hypercerts.workscope.tag';
+    /** Lowercase, underscore-separated machine-readable key for this scope (e.g., 'mangrove_restoration', 'biodiversity_monitoring'). Used as the canonical identifier in CEL expressions. */
+    key: string;
+    /** Human-readable name for this scope. */
+    name: string;
+    /** Category type of this scope. */
+    category?: 'topic' | 'language' | 'domain' | 'method' | (string & {});
+    /** Optional longer description of this scope. */
+    description?: string;
+    parent?: ComAtprotoRepoStrongRef.Main;
+    /** Lifecycle status of this tag. Communities propose tags, curators accept them, deprecated tags point to replacements via supersededBy. */
+    status?: 'proposed' | 'accepted' | 'deprecated' | (string & {});
+    supersededBy?: ComAtprotoRepoStrongRef.Main;
+    /** Alternative human-readable names for this scope (e.g., translations, abbreviations, or common synonyms). Unlike sameAs, these are plain-text labels, not links to external ontologies. */
+    aliases?: string[];
+    /** URIs to semantically equivalent concepts in external ontologies or taxonomies (e.g., Wikidata QIDs, ENVO terms, SDG targets). Used for interoperability, not as documentation. */
+    sameAs?: string[];
+    referenceDocument?: $Typed<OrgHypercertsDefs.Uri> | $Typed<OrgHypercertsDefs.SmallBlob> | {
+        $type: string;
+    };
+    /** Client-declared timestamp when this record was originally created. */
+    createdAt: string;
+    [k: string]: unknown;
+}
+export declare function isMain<V>(v: V): v is import("../../../../util").$TypedObject<V, "org.hypercerts.workscope.tag", "main">;
+export declare function validateMain<V>(v: V): ValidationResult<Main & V>;
+export { type Main as Record, isMain as isRecord, validateMain as validateRecord, };
+//# sourceMappingURL=tag.d.ts.map

package/dist/types/org/hypercerts/workscope/tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../../../../generated/types/org/hypercerts/workscope/tag.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,gBAAgB,EAAW,MAAM,kBAAkB,CAAA;AAGjE,OAAO,EACL,KAAK,MAAM,EAGZ,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,KAAK,uBAAuB,MAAM,wCAAwC,CAAA;AACtF,OAAO,KAAK,KAAK,iBAAiB,MAAM,YAAY,CAAA;AAMpD,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,8BAA8B,CAAA;IACrC,0LAA0L;IAC1L,GAAG,EAAE,MAAM,CAAA;IACX,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IACrE,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,uBAAuB,CAAC,IAAI,CAAA;IACrC,4IAA4I;IAC5I,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IAC/D,YAAY,CAAC,EAAE,uBAAuB,CAAC,IAAI,CAAA;IAC3C,6LAA6L;IAC7L,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,qLAAqL;IACrL,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,iBAAiB,CAAC,EACd,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAC7B,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,GACnC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACrB,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAA;IACjB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACrB;AAID,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,2FAE7B;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,8BAEnC;AAED,OAAO,EACL,KAAK,IAAI,IAAI,MAAM,EACnB,MAAM,IAAI,QAAQ,EAClB,YAAY,IAAI,cAAc,GAC/B,CAAA"}

package/lexicons/app/certified/actor/organization.json

@@ -0,0 +1,70 @@
+{
+  "lexicon": 1,
+  "id": "app.certified.actor.organization",
+  "defs": {
+    "main": {
+      "type": "record",
+      "description": "Extended metadata for an organization actor. Complements the base actor profile with organization-specific fields like legal structure and reference links.",
+      "key": "literal:self",
+      "record": {
+        "type": "object",
+        "required": ["createdAt"],
+        "properties": {
+          "organizationType": {
+            "type": "array",
+            "description": "Legal or operational structures of the organization (e.g. 'nonprofit', 'ngo', 'government', 'social-enterprise', 'cooperative').",
+            "items": {
+              "type": "string",
+              "maxLength": 128,
+              "maxGraphemes": 100
+            },
+            "maxLength": 10
+          },
+          "urls": {
+            "type": "array",
+            "description": "Additional reference URLs (social media profiles, contact pages, donation links, etc.) with a display label for each URL.",
+            "items": {
+              "type": "ref",
+              "ref": "#urlItem"
+            }
+          },
+          "location": {
+            "type": "ref",
+            "ref": "com.atproto.repo.strongRef",
+            "description": "A strong reference to the location where the organization is based. The record referenced must conform with the lexicon app.certified.location."
+          },
+          "foundedDate": {
+            "type": "string",
+            "format": "datetime",
+            "description": "When the organization was established. Stored as datetime per ATProto conventions (no date-only format exists). Clients should use midnight UTC (e.g., '2005-01-01T00:00:00.000Z'); consumers should treat only the date portion as canonical."
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "datetime",
+            "description": "Client-declared timestamp when this record was originally created."
+          }
+        }
+      }
+    },
+    "urlItem": {
+      "type": "object",
+      "description": "A labeled URL reference.",
+      "required": ["url"],
+      "properties": {
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "The URL.",
+          "maxLength": 10000,
+          "maxGraphemes": 2048
+        },
+        "label": {
+          "type": "string",
+          "description": "Optional human-readable label for this URL (e.g. 'Support page', 'Donation page').",
+          "maxLength": 640,
+          "maxGraphemes": 64
+        }
+      }
+    }
+  }
+}

package/lexicons/app/certified/actor/profile.json

@@ -4,13 +4,15 @@
   "defs": {
     "main": {
       "type": "record",
-      "description": "A declaration of a Hypercert account profile.",
+      "description": "A declaration of a Certified account profile.",
       "key": "literal:self",
       "record": {
         "type": "object",
+        "required": ["createdAt"],
         "properties": {
           "displayName": {
             "type": "string",
+            "description": "Display name for the account",
             "maxGraphemes": 64,
             "maxLength": 640
           },
@@ -26,7 +28,11 @@
             "maxGraphemes": 20,
             "maxLength": 200
           },
-          "website": { "type": "string", "format": "uri" },
+          "website": {
+            "type": "string",
+            "format": "uri",
+            "description": "Account website URL"
+          },
           "avatar": {
             "type": "union",
             "refs": [
@@ -43,7 +49,11 @@
             ],
             "description": "Larger horizontal image to display behind profile view."
           },
-          "createdAt": { "type": "string", "format": "datetime" }
+          "createdAt": {
+            "type": "string",
+            "format": "datetime",
+            "description": "Client-declared timestamp when this record was originally created"
+          }
         }
       }
     }

package/lexicons/app/certified/badge/award.json

@@ -22,7 +22,14 @@
           },
           "note": {
             "type": "string",
-            "description": "Optional statement explaining the reason for this badge award."
+            "description": "Optional statement explaining the reason for this badge award.",
+            "maxLength": 500
+          },
+          "url": {
+            "type": "string",
+            "format": "uri",
+            "description": "Optional URL the badge award links to.",
+            "maxLength": 2048
           },
           "createdAt": {
             "type": "string",

package/lexicons/app/certified/badge/definition.json

@@ -12,11 +12,13 @@
         "properties": {
           "badgeType": {
             "type": "string",
-            "description": "Category of the badge (e.g. endorsement, participation, affiliation)."
+            "description": "Category of the badge (e.g. endorsement, participation, affiliation).",
+            "maxLength": 100
           },
           "title": {
             "type": "string",
-            "description": "Human-readable title of the badge."
+            "description": "Human-readable title of the badge.",
+            "maxLength": 256
           },
           "icon": {
             "type": "blob",
@@ -31,11 +33,14 @@
           },
           "description": {
             "type": "string",
-            "description": "Optional short statement describing what the badge represents."
+            "description": "Optional short statement describing what the badge represents.",
+            "maxLength": 5000,
+            "maxGraphemes": 500
           },
           "allowedIssuers": {
             "type": "array",
             "description": "Optional allowlist of DIDs allowed to issue this badge. If omitted, anyone may issue it.",
+            "maxLength": 100,
             "items": {
               "type": "ref",
               "ref": "app.certified.defs#did"

package/lexicons/app/certified/badge/response.json

@@ -17,12 +17,13 @@
           },
           "response": {
             "type": "string",
-            "enum": ["accepted", "rejected"],
+            "knownValues": ["accepted", "rejected"],
             "description": "The recipient’s response for the badge (accepted or rejected)."
           },
           "weight": {
             "type": "string",
-            "description": "Optional relative weight for accepted badges, assigned by the recipient."
+            "description": "Optional relative weight for accepted badges, assigned by the recipient.",
+            "maxLength": 50
           },
           "createdAt": {
             "type": "string",

package/lexicons/app/certified/location.json

@@ -29,8 +29,17 @@
           },
           "locationType": {
             "type": "string",
-            "description": "An identifier for the format of the location data (e.g., coordinate-decimal, geojson-point)",
-            "knownValues": ["coordinate-decimal", "geojson-point"],
+            "description": "An identifier for the format of the location data (e.g., coordinate-decimal, geojson-point). See the Location Protocol spec for the full registry: https://spec.decentralizedgeo.org/specification/location-types/#location-type-registry",
+            "knownValues": [
+              "coordinate-decimal",
+              "geojson-point",
+              "geojson",
+              "h3",
+              "geohash",
+              "wkt",
+              "address",
+              "scaledCoordinates"
+            ],
             "maxLength": 20
           },
           "location": {
@@ -44,13 +53,13 @@
           },
           "name": {
             "type": "string",
-            "description": "Optional name for this location",
+            "description": "Human-readable name for this location (e.g. 'Golden Gate Park', 'San Francisco Bay Area')",
             "maxLength": 1000,
             "maxGraphemes": 100
           },
           "description": {
             "type": "string",
-            "description": "Optional description for this location",
+            "description": "Additional context about this location, such as its significance to the work or specific boundaries",
             "maxLength": 2000,
             "maxGraphemes": 500
           },

package/lexicons/org/hyperboards/board.json

@@ -0,0 +1,152 @@
+{
+  "lexicon": 1,
+  "id": "org.hyperboards.board",
+  "defs": {
+    "main": {
+      "type": "record",
+      "description": "Configuration record for a hyperboard, wrapping an underlying activity or collection with visual presentation settings. Stored in the creator's PDS.",
+      "key": "tid",
+      "record": {
+        "type": "object",
+        "required": ["subject", "createdAt"],
+        "properties": {
+          "subject": {
+            "type": "ref",
+            "ref": "com.atproto.repo.strongRef",
+            "description": "Reference to the org.hypercerts.claim.activity or org.hypercerts.claim.collection this board visualizes."
+          },
+          "config": {
+            "type": "ref",
+            "ref": "#boardConfig",
+            "description": "Board-level visual configuration (background, colors, aspect ratio)."
+          },
+          "contributorConfigs": {
+            "type": "array",
+            "description": "Per-contributor configuration entries for this board.",
+            "maxLength": 1000,
+            "items": {
+              "type": "ref",
+              "ref": "#contributorConfig"
+            }
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "datetime",
+            "description": "Client-declared timestamp when this record was originally created."
+          }
+        }
+      }
+    },
+    "boardConfig": {
+      "type": "object",
+      "description": "Visual configuration for a hyperboard's background, colors, and layout.",
+      "properties": {
+        "backgroundType": {
+          "type": "string",
+          "description": "Type of background content.",
+          "knownValues": ["image", "iframe"],
+          "maxLength": 10
+        },
+        "backgroundImage": {
+          "type": "union",
+          "refs": ["org.hypercerts.defs#uri", "org.hypercerts.defs#smallImage"],
+          "description": "Background image as a URI or image blob."
+        },
+        "backgroundIframeUrl": {
+          "type": "string",
+          "format": "uri",
+          "description": "URI of the background iframe.",
+          "maxLength": 2048
+        },
+        "backgroundGrayscale": {
+          "type": "boolean",
+          "description": "Whether the background is rendered in grayscale. Default: true."
+        },
+        "backgroundOpacity": {
+          "type": "integer",
+          "description": "Background opacity as a percentage (0–100).",
+          "minimum": 0,
+          "maximum": 100
+        },
+        "backgroundColor": {
+          "type": "string",
+          "description": "Background color as a hex string (e.g. '#ffffff').",
+          "maxLength": 20
+        },
+        "borderColor": {
+          "type": "string",
+          "description": "Border color as a hex string (e.g. '#000000').",
+          "maxLength": 20
+        },
+        "grayscaleImages": {
+          "type": "boolean",
+          "description": "Whether contributor images are rendered in grayscale. Default: false."
+        },
+        "imageShape": {
+          "type": "string",
+          "description": "Shape used to crop contributor images on this board.",
+          "knownValues": ["circular", "square"],
+          "maxLength": 20
+        },
+        "aspectRatio": {
+          "type": "string",
+          "description": "Display aspect ratio of the board.",
+          "knownValues": ["16:9", "4:3", "1:1"],
+          "maxLength": 10
+        }
+      }
+    },
+    "contributorConfig": {
+      "type": "object",
+      "description": "Configuration for a specific contributor within a board. Values serve as fallbacks when the contributor has not defined them on their profile. It can also be used to override contributor settings on this board without changing their global profile.",
+      "required": ["contributor"],
+      "properties": {
+        "contributor": {
+          "type": "union",
+          "refs": [
+            "com.atproto.repo.strongRef",
+            "org.hypercerts.claim.activity#contributorIdentity"
+          ],
+          "description": "Identifies the contributor being styled. A strong reference to an org.hypercerts.claim.contributorInformation record, or a contributorIdentity (DID or identifier string) for contributors without a dedicated record."
+        },
+        "override": {
+          "type": "boolean",
+          "description": "When true, these values take precedence over the contributor's own profile and display settings. When false or omitted, they are only used as fallbacks if the contributor has not set their own settings."
+        },
+        "displayName": {
+          "type": "string",
+          "description": "Display name for this contributor on this board.",
+          "maxLength": 640,
+          "maxGraphemes": 64
+        },
+        "image": {
+          "type": "union",
+          "refs": ["org.hypercerts.defs#uri", "org.hypercerts.defs#smallImage"],
+          "description": "Avatar or face image for this contributor on this board, as a URI or image blob."
+        },
+        "video": {
+          "type": "union",
+          "refs": ["org.hypercerts.defs#uri", "org.hypercerts.defs#smallVideo"],
+          "description": "Video for this contributor, as a URI (embed/direct link) or uploaded video blob."
+        },
+        "hoverImage": {
+          "type": "union",
+          "refs": ["org.hypercerts.defs#uri", "org.hypercerts.defs#smallImage"],
+          "description": "Image overlay shown when hovering over this contributor, as a URI or image blob."
+        },
+        "hoverIframeUrl": {
+          "type": "string",
+          "format": "uri",
+          "description": "Iframe overlay shown when hovering over this contributor.",
+          "maxLength": 2048
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "Click-through link URL for this contributor.",
+          "maxLength": 2048
+        }
+      }
+    }
+  }
+}

package/lexicons/org/hyperboards/displayProfile.json

@@ -0,0 +1,64 @@
+{
+  "lexicon": 1,
+  "id": "org.hyperboards.displayProfile",
+  "defs": {
+    "main": {
+      "type": "record",
+      "description": "User-declared visual presentation defaults for how a contributor appears on hyperboards. Stored in the contributor's own PDS and reusable across multiple boards.",
+      "key": "literal:self",
+      "record": {
+        "type": "object",
+        "required": ["createdAt"],
+        "properties": {
+          "displayName": {
+            "type": "string",
+            "description": "Display name override for this user on hyperboards.",
+            "maxLength": 640,
+            "maxGraphemes": 64
+          },
+          "image": {
+            "type": "union",
+            "refs": [
+              "org.hypercerts.defs#uri",
+              "org.hypercerts.defs#smallImage"
+            ],
+            "description": "Avatar or face image override for this user on hyperboards, as a URI or image blob."
+          },
+          "video": {
+            "type": "union",
+            "refs": [
+              "org.hypercerts.defs#uri",
+              "org.hypercerts.defs#smallVideo"
+            ],
+            "description": "Default video for this user across boards, as a URI (embed/direct link) or uploaded video blob."
+          },
+          "hoverImage": {
+            "type": "union",
+            "refs": [
+              "org.hypercerts.defs#uri",
+              "org.hypercerts.defs#smallImage"
+            ],
+            "description": "Default hover image for this user across boards, as a URI or image blob."
+          },
+          "hoverIframeUrl": {
+            "type": "string",
+            "format": "uri",
+            "description": "Default hover iframe URL for this user across boards.",
+            "maxLength": 2048
+          },
+          "url": {
+            "type": "string",
+            "format": "uri",
+            "description": "Default click-through link URL for this user across boards.",
+            "maxLength": 2048
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "datetime",
+            "description": "Client-declared timestamp when this record was originally created."
+          }
+        }
+      }
+    }
+  }
+}

package/lexicons/org/hypercerts/claim/activity.json

@@ -12,7 +12,7 @@
         "properties": {
           "title": {
             "type": "string",
-            "description": "Title of the hypercert.",
+            "description": "Display title summarizing the impact work (e.g. 'Reforestation in Amazon Basin 2024')",
             "maxLength": 256
           },
           "shortDescription": {
@@ -30,18 +30,9 @@
             }
           },
           "description": {
-            "type": "string",
-            "description": "Optional longer description of this activity claim, including context or interpretation. Rich text annotations may be provided via `descriptionFacets`.",
-            "maxLength": 30000,
-            "maxGraphemes": 3000
-          },
-          "descriptionFacets": {
-            "type": "array",
-            "description": "Rich text annotations for `description` (mentions, URLs, hashtags, etc).",
-            "items": {
-              "type": "ref",
-              "ref": "app.bsky.richtext.facet"
-            }
+            "type": "ref",
+            "ref": "pub.leaflet.pages.linearDocument#main",
+            "description": "Rich-text description, represented as a Leaflet linear document."
           },
           "image": {
             "type": "union",
@@ -51,10 +42,19 @@
             ],
             "description": "The hypercert visual representation as a URI or image blob."
           },
+          "contributors": {
+            "type": "array",
+            "description": "An array of contributor objects, each containing contributor information, weight, and contribution details.",
+            "maxLength": 1000,
+            "items": {
+              "type": "ref",
+              "ref": "#contributor"
+            }
+          },
           "workScope": {
             "type": "union",
-            "refs": ["com.atproto.repo.strongRef", "#workScopeString"],
-            "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."
+            "refs": ["org.hypercerts.workscope.cel", "#workScopeString"],
+            "description": "Work scope definition. A CEL expression for structured, machine-evaluable scopes or a free-form string for simple and legacy scopes."
           },
           "startDate": {
             "type": "string",
@@ -66,12 +66,13 @@
             "format": "datetime",
             "description": "When the work ended"
           },
-          "contributors": {
+          "locations": {
             "type": "array",
-            "description": "An array of contributor objects, each containing contributor information, weight, and contribution details.",
+            "description": "An array of strong references to the location where activity was performed. The record referenced must conform with the lexicon app.certified.location.",
+            "maxLength": 1000,
             "items": {
               "type": "ref",
-              "ref": "#contributor"
+              "ref": "com.atproto.repo.strongRef"
             }
           },
           "rights": {
@@ -79,14 +80,6 @@
             "ref": "com.atproto.repo.strongRef",
             "description": "A strong reference to the rights that this hypercert has. The record referenced must conform with the lexicon org.hypercerts.claim.rights."
           },
-          "locations": {
-            "type": "array",
-            "description": "An array of strong references to the location where activity was performed. The record referenced must conform with the lexicon app.certified.location.",
-            "items": {
-              "type": "ref",
-              "ref": "com.atproto.repo.strongRef"
-            }
-          },
           "createdAt": {
             "type": "string",
             "format": "datetime",
@@ -102,16 +95,17 @@
         "contributorIdentity": {
           "type": "union",
           "refs": ["#contributorIdentity", "com.atproto.repo.strongRef"],
-          "description": "Contributor identity as a string (DID or identifier) via org.hypercerts.claim.activity#contributorIdentity, or a strong reference to a contributor information record."
+          "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."
         },
         "contributionWeight": {
           "type": "string",
-          "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."
+          "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.",
+          "maxLength": 100
         },
         "contributionDetails": {
           "type": "union",
           "refs": ["#contributorRole", "com.atproto.repo.strongRef"],
-          "description": "Contribution details as a string via org.hypercerts.claim.activity#contributorRole, or a strong reference to a contribution details record."
+          "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."
         }
       }
     },

package/lexicons/org/hypercerts/claim/{contributionDetails.json → contribution.json}

@@ -1,6 +1,6 @@
 {
   "lexicon": 1,
-  "id": "org.hypercerts.claim.contributionDetails",
+  "id": "org.hypercerts.claim.contribution",
   "defs": {
     "main": {
       "type": "record",
@@ -17,19 +17,19 @@
           },
           "contributionDescription": {
             "type": "string",
-            "description": "What the contribution concretely was.",
+            "description": "Description of what the contribution concretely involved.",
             "maxLength": 10000,
             "maxGraphemes": 1000
           },
           "startDate": {
             "type": "string",
             "format": "datetime",
-            "description": "When this contribution started. This should be a subset of the hypercert timeframe."
+            "description": "When this contribution started. Should fall within the parent hypercert's timeframe."
           },
           "endDate": {
             "type": "string",
             "format": "datetime",
-            "description": "When this contribution finished. This should be a subset of the hypercert timeframe."
+            "description": "When this contribution finished. Should fall within the parent hypercert's timeframe."
           },
           "createdAt": {
             "type": "string",

package/lexicons/org/hypercerts/claim/contributorInformation.json

@@ -12,11 +12,12 @@
         "properties": {
           "identifier": {
             "type": "string",
-            "description": "DID or a URI to a social profile of the contributor."
+            "description": "DID (did:plc:...) or URI to a social profile of the contributor.",
+            "maxLength": 2048
           },
           "displayName": {
             "type": "string",
-            "description": "Display name of the contributor.",
+            "description": "Human-readable name for the contributor as it should appear in UI.",
             "maxLength": 100
           },
           "image": {

package/lexicons/org/hypercerts/claim/rights.json

@@ -17,17 +17,19 @@
         "properties": {
           "rightsName": {
             "type": "string",
-            "description": "Full name of the rights",
+            "description": "Human-readable name for these rights (e.g. 'All Rights Reserved', 'CC BY-SA 4.0')",
             "maxLength": 100
           },
           "rightsType": {
             "type": "string",
-            "description": "Short rights identifier for easier search",
+            "description": "Short identifier code for this rights type (e.g. 'ARR', 'CC-BY-SA') to facilitate filtering and search",
             "maxLength": 10
           },
           "rightsDescription": {
             "type": "string",
-            "description": "Description of the rights of this hypercert"
+            "description": "Detailed explanation of the rights holders' permissions, restrictions, and conditions",
+            "maxLength": 10000,
+            "maxGraphemes": 1000
           },
           "attachment": {
             "type": "union",