Reorganize lexicons into semantic namespaces

.changeset/reorganize-lexicon-folders.md

@@ -0,0 +1,5 @@
+---
+"@hypercerts-org/lexicon": minor
+---
+
+Reorganize lexicon folder structure into semantic namespaces: location to app.certified.geo, attachment/evaluation/measurement to org.hypercerts.context, acknowledgement to org.hypercerts.graph, collection to org.hypercerts.curation, workScopeTag to org.hypercerts.ontology

ERD.puml

@@ -69,7 +69,7 @@ dataclass activity <<largeBold>> #B4E5D0 {
     !endif
 }
 
-' org.hypercerts.claim.attachment
+' org.hypercerts.context.attachment
 dataclass attachment {
     !if (SHOW_FIELDS == "true")
     subjects[]?
@@ -83,7 +83,7 @@ dataclass attachment {
     !endif
 }
 
-' org.hypercerts.claim.measurement
+' org.hypercerts.context.measurement
 dataclass measurement {
     !if (SHOW_FIELDS == "true")
     subject?
@@ -98,7 +98,7 @@ dataclass measurement {
     !endif
 }
 
-' org.hypercerts.claim.evaluation
+' org.hypercerts.context.evaluation
 dataclass evaluation {
     !if (SHOW_FIELDS == "true")
     subject?
@@ -133,7 +133,7 @@ dataclass contributionDetails {
     !endif
 }
 
-' app.certified.location
+' app.certified.geo.location
 dataclass location {
     !if (SHOW_FIELDS == "true")
     lpVersion
@@ -187,7 +187,7 @@ dataclass rights {
     !endif
 }
 
-' org.hypercerts.claim.collection
+' org.hypercerts.curation.collection
 dataclass collection {
     !if (SHOW_FIELDS == "true")
     type?
@@ -200,7 +200,7 @@ dataclass collection {
     !endif
 }
 
-' org.hypercerts.acknowledgement
+' org.hypercerts.graph.acknowledgement
 dataclass acknowledgement {
     !if (SHOW_FIELDS == "true")
     subject

lexicons/app/certified/location.json → lexicons/app/certified/geo/location.json

@@ -1,6 +1,6 @@
 {
   "lexicon": 1,
-  "id": "app.certified.location",
+  "id": "app.certified.geo.location",
   "defs": {
     "main": {
       "type": "record",

lexicons/org/hypercerts/claim/activity.json

@@ -54,7 +54,7 @@
           "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."
+            "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.ontology.workScopeTag lexicon."
           },
           "startDate": {
             "type": "string",
@@ -81,7 +81,7 @@
           },
           "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.",
+            "description": "An array of strong references to the location where activity was performed. The record referenced must conform with the lexicon app.certified.geo.location.",
             "items": {
               "type": "ref",
               "ref": "com.atproto.repo.strongRef"

lexicons/org/hypercerts/claim/attachment.json → lexicons/org/hypercerts/context/attachment.json

@@ -1,6 +1,6 @@
 {
   "lexicon": 1,
-  "id": "org.hypercerts.claim.attachment",
+  "id": "org.hypercerts.context.attachment",
   "defs": {
     "main": {
       "type": "record",
@@ -72,7 +72,7 @@
           "location": {
             "type": "ref",
             "ref": "com.atproto.repo.strongRef",
-            "description": "A strong reference to the location where this attachment's subject matter occurred. The record referenced must conform with the lexicon app.certified.location."
+            "description": "A strong reference to the location where this attachment's subject matter occurred. The record referenced must conform with the lexicon app.certified.geo.location."
           },
           "createdAt": {
             "type": "string",

lexicons/org/hypercerts/claim/evaluation.json → lexicons/org/hypercerts/context/evaluation.json

@@ -1,6 +1,6 @@
 {
   "lexicon": 1,
-  "id": "org.hypercerts.claim.evaluation",
+  "id": "org.hypercerts.context.evaluation",
   "defs": {
     "score": {
       "type": "object",
@@ -57,7 +57,7 @@
           },
           "measurements": {
             "type": "array",
-            "description": "Optional references to the measurements that contributed to this evaluation. The record(s) referenced must conform with the lexicon org.hypercerts.claim.measurement",
+            "description": "Optional references to the measurements that contributed to this evaluation. The record(s) referenced must conform with the lexicon org.hypercerts.context.measurement",
             "items": {
               "type": "ref",
               "ref": "com.atproto.repo.strongRef"
@@ -78,7 +78,7 @@
           "location": {
             "type": "ref",
             "ref": "com.atproto.repo.strongRef",
-            "description": "An optional reference for georeferenced evaluations. The record referenced must conform with the lexicon app.certified.location."
+            "description": "An optional reference for georeferenced evaluations. The record referenced must conform with the lexicon app.certified.geo.location."
           },
           "createdAt": {
             "type": "string",

lexicons/org/hypercerts/claim/measurement.json → lexicons/org/hypercerts/context/measurement.json

@@ -1,6 +1,6 @@
 {
   "lexicon": 1,
-  "id": "org.hypercerts.claim.measurement",
+  "id": "org.hypercerts.context.measurement",
   "defs": {
     "main": {
       "type": "record",
@@ -42,7 +42,7 @@
           },
           "locations": {
             "type": "array",
-            "description": "Optional geographic references related to where the measurement was taken. Each referenced record must conform with the app.certified.location lexicon.",
+            "description": "Optional geographic references related to where the measurement was taken. Each referenced record must conform with the app.certified.geo.location lexicon.",
             "items": {
               "type": "ref",
               "ref": "com.atproto.repo.strongRef"

lexicons/org/hypercerts/claim/collection.json → lexicons/org/hypercerts/curation/collection.json

@@ -1,6 +1,6 @@
 {
   "lexicon": 1,
-  "id": "org.hypercerts.claim.collection",
+  "id": "org.hypercerts.curation.collection",
   "defs": {
     "main": {
       "type": "record",
@@ -58,7 +58,7 @@
           "location": {
             "type": "ref",
             "ref": "com.atproto.repo.strongRef",
-            "description": "A strong reference to the location where this collection's activities were performed. The record referenced must conform with the lexicon app.certified.location."
+            "description": "A strong reference to the location where this collection's activities were performed. The record referenced must conform with the lexicon app.certified.geo.location."
           },
           "createdAt": {
             "type": "string",
@@ -75,7 +75,7 @@
         "itemIdentifier": {
           "type": "ref",
           "ref": "com.atproto.repo.strongRef",
-          "description": "Strong reference to an item in this collection. Items can be activities (org.hypercerts.claim.activity) and/or other collections (org.hypercerts.claim.collection)."
+          "description": "Strong reference to an item in this collection. Items can be activities (org.hypercerts.claim.activity) and/or other collections (org.hypercerts.curation.collection)."
         },
         "itemWeight": {
           "type": "string",

lexicons/org/hypercerts/acknowledgement.json → lexicons/org/hypercerts/graph/acknowledgement.json

@@ -1,6 +1,6 @@
 {
   "lexicon": 1,
-  "id": "org.hypercerts.acknowledgement",
+  "id": "org.hypercerts.graph.acknowledgement",
   "defs": {
     "main": {
       "type": "record",

lexicons/org/hypercerts/helper/workScopeTag.json → lexicons/org/hypercerts/ontology/workScopeTag.json

@@ -1,6 +1,6 @@
 {
   "lexicon": 1,
-  "id": "org.hypercerts.helper.workScopeTag",
+  "id": "org.hypercerts.ontology.workScopeTag",
   "defs": {
     "main": {
       "type": "record",

scripts/generate-schemas.js

@@ -182,7 +182,7 @@ function categorizeLexicons(lexicons) {
       lexicons: [],
       ordering: (lex) => {
         const order = [
-          "app.certified.location",
+          "app.certified.geo.location",
           "app.certified.badge.definition",
           "app.certified.badge.award",
           "app.certified.badge.response",