bretton.dev / coves
A community based topic aggregation platform built on atproto
fork atom

refactor(lexicon): apply atProto best practices to actor and community schemas

Actor changes:
- Remove handle from actor.profile record (resolved from DID, not stored)
- Remove geoLocation from actor.profile (not implemented)
- Remove verification fields from profile (AppView concern, not record data)
- Remove federation fields from profile (AppView concern, not record data)
- Remove moderation fields from profile (AppView concern, not record data)
- Update actor.getProfile to return profileViewDetailed from defs
- Update actor.updateProfile to remove geoLocation reference

Community changes:
- Remove handle from community.profile record (resolved from DID, not stored)
- Remove memberCount, subscriberCount from record (AppView cached stats)
- Remove federatedFrom, federatedId from record (AppView metadata)
- Remove federation and contentRules from record (not implemented)
- Update community.get to return communityViewDetailed from defs
- Update community.list to return communityView array from defs

Key principle: Records contain only user-controlled data. Computed stats,
cached values, and viewer state live in AppView views (defs.json), not records.

Following atProto best practices per:
https://github.com/bluesky-social/atproto/discussions/4245

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

bretton.dev 1cf72790 efdb10cb

options
unified split
Changed files
+9 -469
internal
atproto
lexicon
social
coves
actor
getProfile.json
profile.json
updateProfile.json
community
get.json
list.json
profile.json
+3 -76
internal/atproto/lexicon/social/coves/actor/getProfile.json 
···

       
19

       
 

       
      "output": {


     

       
20

       
 

       
        "encoding": "application/json",


     

       
21

       
 

       
        "schema": {


     

       
22

       
-

       
          "type": "object",


     

       
23

       
-

       
          "required": ["did", "profile"],


     

       
24

       
-

       
          "properties": {


     

       
25

       
-

       
            "did": {


     

       
26

       
-

       
              "type": "string",


     

       
27

       
-

       
              "format": "did"


     

       
28

       
-

       
            },


     

       
29

       
-

       
            "profile": {


     

       
30

       
-

       
              "type": "ref",


     

       
31

       
-

       
              "ref": "social.coves.actor.profile"


     

       
32

       
-

       
            },


     

       
33

       
-

       
            "stats": {


     

       
34

       
-

       
              "type": "ref",


     

       
35

       
-

       
              "ref": "#profileStats"


     

       
36

       
-

       
            },


     

       
37

       
-

       
            "viewer": {


     

       
38

       
-

       
              "type": "ref",


     

       
39

       
-

       
              "ref": "#viewerState",


     

       
40

       
-

       
              "description": "Viewer's relationship to this profile"


     

       
41

       
-

       
            }


     

       
42

       
-

       
          }


     

       
43

       
-

       
        }


     

       
44

       
-

       
      }


     

       
45

       
-

       
    },


     

       
46

       
-

       
    "profileStats": {


     

       
47

       
-

       
      "type": "object",


     

       
48

       
-

       
      "description": "Aggregated statistics for a user profile",


     

       
49

       
-

       
      "required": ["postCount", "commentCount", "communityCount", "savedCount", "reputation"],


     

       
50

       
-

       
      "properties": {


     

       
51

       
-

       
        "postCount": {


     

       
52

       
-

       
          "type": "integer",


     

       
53

       
-

       
          "minimum": 0,


     

       
54

       
-

       
          "description": "Total number of posts created"


     

       
55

       
-

       
        },


     

       
56

       
-

       
        "commentCount": {


     

       
57

       
-

       
          "type": "integer",


     

       
58

       
-

       
          "minimum": 0,


     

       
59

       
-

       
          "description": "Total number of comments made"


     

       
60

       
-

       
        },


     

       
61

       
-

       
        "communityCount": {


     

       
62

       
-

       
          "type": "integer",


     

       
63

       
-

       
          "minimum": 0,


     

       
64

       
-

       
          "description": "Number of communities subscribed to"


     

       
65

       
-

       
        },


     

       
66

       
-

       
        "savedCount": {


     

       
67

       
-

       
          "type": "integer",


     

       
68

       
-

       
          "minimum": 0,


     

       
69

       
-

       
          "description": "Number of saved items"


     

       
70

       
-

       
        },


     

       
71

       
-

       
        "reputation": {


     

       
72

       
-

       
          "type": "integer",


     

       
73

       
-

       
          "description": "Global reputation score"


     

       
74

       
-

       
        },


     

       
75

       
-

       
        "membershipCount": {


     

       
76

       
-

       
          "type": "integer",


     

       
77

       
-

       
          "minimum": 0,


     

       
78

       
-

       
          "description": "Number of communities with membership status"


     

       
79

       
-

       
        }


     

       
80

       
-

       
      }


     

       
81

       
-

       
    },


     

       
82

       
-

       
    "viewerState": {


     

       
83

       
-

       
      "type": "object",


     

       
84

       
-

       
      "description": "The viewing user's relationship to this profile",


     

       
85

       
-

       
      "properties": {


     

       
86

       
-

       
        "blocked": {


     

       
87

       
-

       
          "type": "boolean",


     

       
88

       
-

       
          "description": "Whether the viewer has blocked this user"


     

       
89

       
-

       
        },


     

       
90

       
-

       
        "blockedBy": {


     

       
91

       
-

       
          "type": "boolean",


     

       
92

       
-

       
          "description": "Whether the viewer is blocked by this user"


     

       
93

       
-

       
        },


     

       
94

       
-

       
        "blockUri": {


     

       
95

       
-

       
          "type": "string",


     

       
96

       
-

       
          "format": "at-uri",


     

       
97

       
-

       
          "description": "AT-URI of the block record if viewer blocked this user"


     

       
98

       
 

       
        }


     

       
99

       
 

       
      }


     

       
100

       
 

       
    }


     
···

       
19

       
 

       
      "output": {


     

       
20

       
 

       
        "encoding": "application/json",


     

       
21

       
 

       
        "schema": {


     

       
22

       
+

       
          "type": "ref",


     

       
23

       
+

       
          "ref": "social.coves.actor.defs#profileViewDetailed",


     

       
24

       
+

       
          "description": "Detailed profile view with stats and viewer state"


     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       
25

       
 

       
        }


     

       
26

       
 

       
      }


     

       
27

       
 

       
    }
+1 -172
internal/atproto/lexicon/social/coves/actor/profile.json 
···

       
8

       
 

       
      "key": "literal:self",


     

       
9

       
 

       
      "record": {


     

       
10

       
 

       
        "type": "object",


     

       
11

       
-

       
        "required": ["handle", "createdAt"],


     

       
12

       
 

       
        "properties": {


     

       
13

       
-

       
          "handle": {


     

       
14

       
-

       
            "type": "string",


     

       
15

       
-

       
            "format": "handle",


     

       
16

       
-

       
            "maxLength": 253,


     

       
17

       
-

       
            "description": "User's handle"


     

       
18

       
-

       
          },


     

       
19

       
 

       
          "displayName": {


     

       
20

       
 

       
            "type": "string",


     

       
21

       
 

       
            "maxGraphemes": 64,


     
···

       
46

       
 

       
            "accept": ["image/png", "image/jpeg", "image/webp"],


     

       
47

       
 

       
            "maxSize": 2000000


     

       
48

       
 

       
          },


     

       
49

       
-

       
          "verified": {


     

       
50

       
-

       
            "type": "boolean",


     

       
51

       
-

       
            "default": false,


     

       
52

       
-

       
            "description": "Whether the user has completed phone verification"


     

       
53

       
-

       
          },


     

       
54

       
-

       
          "verifiedAt": {


     

       
55

       
-

       
            "type": "string",


     

       
56

       
-

       
            "format": "datetime",


     

       
57

       
-

       
            "description": "When the user was verified"


     

       
58

       
-

       
          },


     

       
59

       
-

       
          "verificationExpiresAt": {


     

       
60

       
-

       
            "type": "string",


     

       
61

       
-

       
            "format": "datetime",


     

       
62

       
-

       
            "description": "When verification expires"


     

       
63

       
-

       
          },


     

       
64

       
-

       
          "federatedFrom": {


     

       
65

       
-

       
            "type": "string",


     

       
66

       
-

       
            "knownValues": ["bluesky", "lemmy", "mastodon", "coves"],


     

       
67

       
-

       
            "description": "Platform user federated from"


     

       
68

       
-

       
          },


     

       
69

       
-

       
          "federatedIdentity": {


     

       
70

       
-

       
            "type": "ref",


     

       
71

       
-

       
            "ref": "#federatedIdentity",


     

       
72

       
-

       
            "description": "Identity information from federated platform"


     

       
73

       
-

       
          },


     

       
74

       
-

       
          "location": {


     

       
75

       
-

       
            "type": "ref",


     

       
76

       
-

       
            "ref": "#geoLocation"


     

       
77

       
-

       
          },


     

       
78

       
 

       
          "createdAt": {


     

       
79

       
 

       
            "type": "string",


     

       
80

       
 

       
            "format": "datetime"


     

       
81

       
-

       
          },


     

       
82

       
-

       
          "moderatedCommunities": {


     

       
83

       
-

       
            "type": "array",


     

       
84

       
-

       
            "description": "Communities the user currently moderates",


     

       
85

       
-

       
            "items": {


     

       
86

       
-

       
              "type": "string",


     

       
87

       
-

       
              "format": "did"


     

       
88

       
-

       
            }


     

       
89

       
-

       
          },


     

       
90

       
-

       
          "moderationHistory": {


     

       
91

       
-

       
            "type": "array",


     

       
92

       
-

       
            "description": "Historical record of all moderation roles",


     

       
93

       
-

       
            "items": {


     

       
94

       
-

       
              "type": "ref",


     

       
95

       
-

       
              "ref": "#moderationRole"


     

       
96

       
-

       
            }


     

       
97

       
-

       
          },


     

       
98

       
-

       
          "violations": {


     

       
99

       
-

       
            "type": "array",


     

       
100

       
-

       
            "description": "Record of rule violations across communities",


     

       
101

       
-

       
            "items": {


     

       
102

       
-

       
              "type": "ref",


     

       
103

       
-

       
              "ref": "#violation"


     

       
104

       
-

       
            }


     

       
105

       
 

       
          }


     

       
106

       
-

       
        }


     

       
107

       
-

       
      }


     

       
108

       
-

       
    },


     

       
109

       
-

       
    "moderationRole": {


     

       
110

       
-

       
      "type": "object",


     

       
111

       
-

       
      "required": ["communityDid", "role", "startedAt"],


     

       
112

       
-

       
      "properties": {


     

       
113

       
-

       
        "communityDid": {


     

       
114

       
-

       
          "type": "string",


     

       
115

       
-

       
          "format": "did",


     

       
116

       
-

       
          "description": "Community where moderation role was held"


     

       
117

       
-

       
        },


     

       
118

       
-

       
        "role": {


     

       
119

       
-

       
          "type": "string",


     

       
120

       
-

       
          "knownValues": ["moderator", "admin"],


     

       
121

       
-

       
          "description": "Type of moderation role"


     

       
122

       
-

       
        },


     

       
123

       
-

       
        "startedAt": {


     

       
124

       
-

       
          "type": "string",


     

       
125

       
-

       
          "format": "datetime",


     

       
126

       
-

       
          "description": "When the role began"


     

       
127

       
-

       
        },


     

       
128

       
-

       
        "endedAt": {


     

       
129

       
-

       
          "type": "string",


     

       
130

       
-

       
          "format": "datetime",


     

       
131

       
-

       
          "description": "When the role ended (null if current)"


     

       
132

       
-

       
        }


     

       
133

       
-

       
      }


     

       
134

       
-

       
    },


     

       
135

       
-

       
    "violation": {


     

       
136

       
-

       
      "type": "object",


     

       
137

       
-

       
      "required": ["communityDid", "ruleViolated", "timestamp", "severity"],


     

       
138

       
-

       
      "properties": {


     

       
139

       
-

       
        "communityDid": {


     

       
140

       
-

       
          "type": "string",


     

       
141

       
-

       
          "format": "did",


     

       
142

       
-

       
          "description": "Community where violation occurred"


     

       
143

       
-

       
        },


     

       
144

       
-

       
        "ruleViolated": {


     

       
145

       
-

       
          "type": "string",


     

       
146

       
-

       
          "description": "Description of the rule that was violated"


     

       
147

       
-

       
        },


     

       
148

       
-

       
        "timestamp": {


     

       
149

       
-

       
          "type": "string",


     

       
150

       
-

       
          "format": "datetime",


     

       
151

       
-

       
          "description": "When the violation occurred"


     

       
152

       
-

       
        },


     

       
153

       
-

       
        "severity": {


     

       
154

       
-

       
          "type": "string",


     

       
155

       
-

       
          "knownValues": ["minor", "moderate", "major", "severe"],


     

       
156

       
-

       
          "description": "Severity level of the violation"


     

       
157

       
-

       
        },


     

       
158

       
-

       
        "resolution": {


     

       
159

       
-

       
          "type": "string",


     

       
160

       
-

       
          "description": "How the violation was resolved"


     

       
161

       
-

       
        },


     

       
162

       
-

       
        "postUri": {


     

       
163

       
-

       
          "type": "string",


     

       
164

       
-

       
          "format": "at-uri",


     

       
165

       
-

       
          "description": "Optional reference to the violating content"


     

       
166

       
-

       
        }


     

       
167

       
-

       
      }


     

       
168

       
-

       
    },


     

       
169

       
-

       
    "federatedIdentity": {


     

       
170

       
-

       
      "type": "object",


     

       
171

       
-

       
      "description": "Verified identity from a federated platform",


     

       
172

       
-

       
      "required": ["did", "handle", "verifiedAt"],


     

       
173

       
-

       
      "properties": {


     

       
174

       
-

       
        "did": {


     

       
175

       
-

       
          "type": "string",


     

       
176

       
-

       
          "format": "did",


     

       
177

       
-

       
          "description": "Original DID from the federated platform"


     

       
178

       
-

       
        },


     

       
179

       
-

       
        "handle": {


     

       
180

       
-

       
          "type": "string",


     

       
181

       
-

       
          "maxLength": 253,


     

       
182

       
-

       
          "description": "Original handle from the federated platform"


     

       
183

       
-

       
        },


     

       
184

       
-

       
        "verifiedAt": {


     

       
185

       
-

       
          "type": "string",


     

       
186

       
-

       
          "format": "datetime",


     

       
187

       
-

       
          "description": "When the federated identity was verified via OAuth"


     

       
188

       
-

       
        },


     

       
189

       
-

       
        "lastSyncedAt": {


     

       
190

       
-

       
          "type": "string",


     

       
191

       
-

       
          "format": "datetime",


     

       
192

       
-

       
          "description": "Last time profile data was synced from the federated platform"


     

       
193

       
-

       
        },


     

       
194

       
-

       
        "homePDS": {


     

       
195

       
-

       
          "type": "string",


     

       
196

       
-

       
          "description": "Home PDS server URL for the federated account"


     

       
197

       
-

       
        }


     

       
198

       
-

       
      }


     

       
199

       
-

       
    },


     

       
200

       
-

       
    "geoLocation": {


     

       
201

       
-

       
      "type": "object",


     

       
202

       
-

       
      "description": "Geographic location information",


     

       
203

       
-

       
      "properties": {


     

       
204

       
-

       
        "country": {


     

       
205

       
-

       
          "type": "string",


     

       
206

       
-

       
          "maxLength": 2,


     

       
207

       
-

       
          "description": "ISO 3166-1 alpha-2 country code"


     

       
208

       
-

       
        },


     

       
209

       
-

       
        "region": {


     

       
210

       
-

       
          "type": "string",


     

       
211

       
-

       
          "maxLength": 128,


     

       
212

       
-

       
          "description": "State/province/region name"


     

       
213

       
-

       
        },


     

       
214

       
-

       
        "displayName": {


     

       
215

       
-

       
          "type": "string",


     

       
216

       
-

       
          "maxLength": 256,


     

       
217

       
-

       
          "description": "Human-readable location name"


     

       
218

       
 

       
        }


     

       
219

       
 

       
      }


     

       
220

       
 

       
    }


     
···

       
8

       
 

       
      "key": "literal:self",


     

       
9

       
 

       
      "record": {


     

       
10

       
 

       
        "type": "object",


     

       
11

       
+

       
        "required": ["createdAt"],


     

       
12

       
 

       
        "properties": {


     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       
13

       
 

       
          "displayName": {


     

       
14

       
 

       
            "type": "string",


     

       
15

       
 

       
            "maxGraphemes": 64,


     
···

       
40

       
 

       
            "accept": ["image/png", "image/jpeg", "image/webp"],


     

       
41

       
 

       
            "maxSize": 2000000


     

       
42

       
 

       
          },


     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       
43

       
 

       
          "createdAt": {


     

       
44

       
 

       
            "type": "string",


     

       
45

       
 

       
            "format": "datetime"


     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       
46

       
 

       
          }


     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       
47

       
 

       
        }


     

       
48

       
 

       
      }


     

       
49

       
 

       
    }
-4
internal/atproto/lexicon/social/coves/actor/updateProfile.json 
···

       
39

       
 

       
              "type": "blob",


     

       
40

       
 

       
              "accept": ["image/png", "image/jpeg", "image/webp"],


     

       
41

       
 

       
              "maxSize": 2000000


     

       
42

       
-

       
            },


     

       
43

       
-

       
            "location": {


     

       
44

       
-

       
              "type": "ref",


     

       
45

       
-

       
              "ref": "social.coves.actor.profile#geoLocation"


     

       
46

       
 

       
            }


     

       
47

       
 

       
          }


     

       
48

       
 

       
        }


     
···

       
39

       
 

       
              "type": "blob",


     

       
40

       
 

       
              "accept": ["image/png", "image/jpeg", "image/webp"],


     

       
41

       
 

       
              "maxSize": 2000000


     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       
42

       
 

       
            }


     

       
43

       
 

       
          }


     

       
44

       
 

       
        }
+3 -83
internal/atproto/lexicon/social/coves/community/get.json 
···

       
19

       
 

       
      "output": {


     

       
20

       
 

       
        "encoding": "application/json",


     

       
21

       
 

       
        "schema": {


     

       
22

       
-

       
          "type": "object",


     

       
23

       
-

       
          "required": ["did", "profile"],


     

       
24

       
-

       
          "properties": {


     

       
25

       
-

       
            "did": {


     

       
26

       
-

       
              "type": "string",


     

       
27

       
-

       
              "format": "did"


     

       
28

       
-

       
            },


     

       
29

       
-

       
            "profile": {


     

       
30

       
-

       
              "type": "ref",


     

       
31

       
-

       
              "ref": "social.coves.community.profile"


     

       
32

       
-

       
            },


     

       
33

       
-

       
            "stats": {


     

       
34

       
-

       
              "type": "ref",


     

       
35

       
-

       
              "ref": "#communityStats"


     

       
36

       
-

       
            },


     

       
37

       
-

       
            "viewer": {


     

       
38

       
-

       
              "type": "ref",


     

       
39

       
-

       
              "ref": "#viewerState",


     

       
40

       
-

       
              "description": "Viewer's relationship to this community"


     

       
41

       
-

       
            }


     

       
42

       
-

       
          }


     

       
43

       
-

       
        }


     

       
44

       
-

       
      }


     

       
45

       
-

       
    },


     

       
46

       
-

       
    "communityStats": {


     

       
47

       
-

       
      "type": "object",


     

       
48

       
-

       
      "required": ["subscriberCount", "memberCount", "postCount", "activePostersCount"],


     

       
49

       
-

       
      "properties": {


     

       
50

       
-

       
        "subscriberCount": {


     

       
51

       
-

       
          "type": "integer",


     

       
52

       
-

       
          "minimum": 0,


     

       
53

       
-

       
          "description": "Number of users subscribed to this community"


     

       
54

       
-

       
        },


     

       
55

       
-

       
        "memberCount": {


     

       
56

       
-

       
          "type": "integer",


     

       
57

       
-

       
          "minimum": 0,


     

       
58

       
-

       
          "description": "Number of users with membership status"


     

       
59

       
-

       
        },


     

       
60

       
-

       
        "postCount": {


     

       
61

       
-

       
          "type": "integer",


     

       
62

       
-

       
          "minimum": 0,


     

       
63

       
-

       
          "description": "Total number of posts in this community"


     

       
64

       
-

       
        },


     

       
65

       
-

       
        "activePostersCount": {


     

       
66

       
-

       
          "type": "integer",


     

       
67

       
-

       
          "minimum": 0,


     

       
68

       
-

       
          "description": "Number of unique posters in the last 30 days"


     

       
69

       
-

       
        },


     

       
70

       
-

       
        "moderatorCount": {


     

       
71

       
-

       
          "type": "integer",


     

       
72

       
-

       
          "minimum": 0,


     

       
73

       
-

       
          "description": "Number of active moderators"


     

       
74

       
-

       
        }


     

       
75

       
-

       
      }


     

       
76

       
-

       
    },


     

       
77

       
-

       
    "viewerState": {


     

       
78

       
-

       
      "type": "object",


     

       
79

       
-

       
      "description": "The viewing user's relationship to this community",


     

       
80

       
-

       
      "properties": {


     

       
81

       
-

       
        "subscribed": {


     

       
82

       
-

       
          "type": "boolean",


     

       
83

       
-

       
          "description": "Whether the viewer is subscribed"


     

       
84

       
-

       
        },


     

       
85

       
-

       
        "subscriptionUri": {


     

       
86

       
-

       
          "type": "string",


     

       
87

       
-

       
          "format": "at-uri",


     

       
88

       
-

       
          "description": "AT-URI of the subscription record if subscribed"


     

       
89

       
-

       
        },


     

       
90

       
-

       
        "member": {


     

       
91

       
-

       
          "type": "boolean",


     

       
92

       
-

       
          "description": "Whether the viewer has membership status (AppView-computed)"


     

       
93

       
-

       
        },


     

       
94

       
-

       
        "reputation": {


     

       
95

       
-

       
          "type": "integer",


     

       
96

       
-

       
          "description": "Viewer's reputation in this community"


     

       
97

       
-

       
        },


     

       
98

       
-

       
        "moderator": {


     

       
99

       
-

       
          "type": "boolean",


     

       
100

       
-

       
          "description": "Whether the viewer is a moderator"


     

       
101

       
-

       
        },


     

       
102

       
-

       
        "banned": {


     

       
103

       
-

       
          "type": "boolean",


     

       
104

       
-

       
          "description": "Whether the viewer is banned from this community"


     

       
105

       
 

       
        }


     

       
106

       
 

       
      }


     

       
107

       
 

       
    }


     
···

       
19

       
 

       
      "output": {


     

       
20

       
 

       
        "encoding": "application/json",


     

       
21

       
 

       
        "schema": {


     

       
22

       
+

       
          "type": "ref",


     

       
23

       
+

       
          "ref": "social.coves.community.defs#communityViewDetailed",


     

       
24

       
+

       
          "description": "Detailed community view with stats and viewer state"


     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       
25

       
 

       
        }


     

       
26

       
 

       
      }


     

       
27

       
 

       
    }
+1 -38
internal/atproto/lexicon/social/coves/community/list.json 
···

       
46

       
 

       
              "type": "array",


     

       
47

       
 

       
              "items": {


     

       
48

       
 

       
                "type": "ref",


     

       
49

       
-

       
                "ref": "#communityView"


     

       
50

       
 

       
              }


     

       
51

       
 

       
            },


     

       
52

       
 

       
            "cursor": {


     

       
53

       
 

       
              "type": "string"


     

       
54

       
-

       
            }


     

       
55

       
-

       
          }


     

       
56

       
-

       
        }


     

       
57

       
-

       
      }


     

       
58

       
-

       
    },


     

       
59

       
-

       
    "communityView": {


     

       
60

       
-

       
      "type": "object",


     

       
61

       
-

       
      "required": ["did", "profile", "subscriberCount", "postCount"],


     

       
62

       
-

       
      "properties": {


     

       
63

       
-

       
        "did": {


     

       
64

       
-

       
          "type": "string",


     

       
65

       
-

       
          "format": "did"


     

       
66

       
-

       
        },


     

       
67

       
-

       
        "profile": {


     

       
68

       
-

       
          "type": "ref",


     

       
69

       
-

       
          "ref": "social.coves.community.profile"


     

       
70

       
-

       
        },


     

       
71

       
-

       
        "subscriberCount": {


     

       
72

       
-

       
          "type": "integer",


     

       
73

       
-

       
          "minimum": 0


     

       
74

       
-

       
        },


     

       
75

       
-

       
        "memberCount": {


     

       
76

       
-

       
          "type": "integer",


     

       
77

       
-

       
          "minimum": 0


     

       
78

       
-

       
        },


     

       
79

       
-

       
        "postCount": {


     

       
80

       
-

       
          "type": "integer",


     

       
81

       
-

       
          "minimum": 0


     

       
82

       
-

       
        },


     

       
83

       
-

       
        "viewer": {


     

       
84

       
-

       
          "type": "object",


     

       
85

       
-

       
          "properties": {


     

       
86

       
-

       
            "subscribed": {


     

       
87

       
-

       
              "type": "boolean"


     

       
88

       
-

       
            },


     

       
89

       
-

       
            "member": {


     

       
90

       
-

       
              "type": "boolean"


     

       
91

       
 

       
            }


     

       
92

       
 

       
          }


     

       
93

       
 

       
        }


     
···

       
46

       
 

       
              "type": "array",


     

       
47

       
 

       
              "items": {


     

       
48

       
 

       
                "type": "ref",


     

       
49

       
+

       
                "ref": "social.coves.community.defs#communityView"


     

       
50

       
 

       
              }


     

       
51

       
 

       
            },


     

       
52

       
 

       
            "cursor": {


     

       
53

       
 

       
              "type": "string"


     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       
54

       
 

       
            }


     

       
55

       
 

       
          }


     

       
56

       
 

       
        }
+1 -96
internal/atproto/lexicon/social/coves/community/profile.json 
···

       
8

       
 

       
      "key": "literal:self",


     

       
9

       
 

       
      "record": {


     

       
10

       
 

       
        "type": "object",


     

       
11

       
-

       
        "required": ["handle", "name", "createdAt", "createdBy", "hostedBy"],


     

       
12

       
 

       
        "properties": {


     

       
13

       
-

       
          "handle": {


     

       
14

       
-

       
            "type": "string",


     

       
15

       
-

       
            "maxLength": 253,


     

       
16

       
-

       
            "format": "handle",


     

       
17

       
-

       
            "description": "atProto handle (e.g., gaming.community.coves.social) - DNS-resolvable name for this community"


     

       
18

       
-

       
          },


     

       
19

       
 

       
          "name": {


     

       
20

       
 

       
            "type": "string",


     

       
21

       
 

       
            "maxLength": 64,


     
···

       
68

       
 

       
            "maxLength": 64,


     

       
69

       
 

       
            "description": "Community visibility level"


     

       
70

       
 

       
          },


     

       
71

       
-

       
          "federation": {


     

       
72

       
-

       
            "type": "ref",


     

       
73

       
-

       
            "ref": "#federationConfig",


     

       
74

       
-

       
            "description": "Federation and discovery configuration"


     

       
75

       
-

       
          },


     

       
76

       
-

       
          "contentRules": {


     

       
77

       
-

       
            "type": "ref",


     

       
78

       
-

       
            "ref": "#contentRules",


     

       
79

       
-

       
            "description": "Content posting rules and restrictions for this community"


     

       
80

       
-

       
          },


     

       
81

       
 

       
          "moderationType": {


     

       
82

       
 

       
            "type": "string",


     

       
83

       
 

       
            "knownValues": ["moderator", "sortition"],


     
···

       
94

       
 

       
              "maxLength": 32


     

       
95

       
 

       
            }


     

       
96

       
 

       
          },


     

       
97

       
-

       
          "memberCount": {


     

       
98

       
-

       
            "type": "integer",


     

       
99

       
-

       
            "minimum": 0,


     

       
100

       
-

       
            "description": "Cached count of community members"


     

       
101

       
-

       
          },


     

       
102

       
-

       
          "subscriberCount": {


     

       
103

       
-

       
            "type": "integer",


     

       
104

       
-

       
            "minimum": 0,


     

       
105

       
-

       
            "description": "Cached count of community subscribers"


     

       
106

       
-

       
          },


     

       
107

       
-

       
          "federatedFrom": {


     

       
108

       
-

       
            "type": "string",


     

       
109

       
-

       
            "knownValues": ["lemmy", "coves"],


     

       
110

       
-

       
            "description": "Platform community originated from"


     

       
111

       
-

       
          },


     

       
112

       
-

       
          "federatedId": {


     

       
113

       
-

       
            "type": "string",


     

       
114

       
-

       
            "description": "Original ID on federated platform"


     

       
115

       
-

       
          },


     

       
116

       
 

       
          "createdAt": {


     

       
117

       
 

       
            "type": "string",


     

       
118

       
 

       
            "format": "datetime"


     

       
119

       
 

       
          }


     

       
120

       
-

       
        }


     

       
121

       
-

       
      }


     

       
122

       
-

       
    },


     

       
123

       
-

       
    "federationConfig": {


     

       
124

       
-

       
      "type": "object",


     

       
125

       
-

       
      "description": "Federation and discovery configuration for this community",


     

       
126

       
-

       
      "properties": {


     

       
127

       
-

       
        "allowExternalDiscovery": {


     

       
128

       
-

       
          "type": "boolean",


     

       
129

       
-

       
          "default": true,


     

       
130

       
-

       
          "description": "Whether other Coves instances can index and discover this community"


     

       
131

       
-

       
        }


     

       
132

       
-

       
      }


     

       
133

       
-

       
    },


     

       
134

       
-

       
    "contentRules": {


     

       
135

       
-

       
      "type": "object",


     

       
136

       
-

       
      "description": "Content posting rules and restrictions for this community. Rules are validated at post creation time.",


     

       
137

       
-

       
      "properties": {


     

       
138

       
-

       
        "allowedEmbedTypes": {


     

       
139

       
-

       
          "type": "array",


     

       
140

       
-

       
          "description": "Allowed embed types. Empty array = no embeds allowed. Null/undefined = all embed types allowed.",


     

       
141

       
-

       
          "items": {


     

       
142

       
-

       
            "type": "string",


     

       
143

       
-

       
            "knownValues": ["images", "video", "external", "record"]


     

       
144

       
-

       
          }


     

       
145

       
-

       
        },


     

       
146

       
-

       
        "requireText": {


     

       
147

       
-

       
          "type": "boolean",


     

       
148

       
-

       
          "default": false,


     

       
149

       
-

       
          "description": "Whether posts must have text content (non-empty content field)"


     

       
150

       
-

       
        },


     

       
151

       
-

       
        "minTextLength": {


     

       
152

       
-

       
          "type": "integer",


     

       
153

       
-

       
          "minimum": 0,


     

       
154

       
-

       
          "description": "Minimum character length for post content (0 = no minimum)"


     

       
155

       
-

       
        },


     

       
156

       
-

       
        "maxTextLength": {


     

       
157

       
-

       
          "type": "integer",


     

       
158

       
-

       
          "minimum": 1,


     

       
159

       
-

       
          "description": "Maximum character length for post content (overrides global limit if lower)"


     

       
160

       
-

       
        },


     

       
161

       
-

       
        "requireTitle": {


     

       
162

       
-

       
          "type": "boolean",


     

       
163

       
-

       
          "default": false,


     

       
164

       
-

       
          "description": "Whether posts must have a title"


     

       
165

       
-

       
        },


     

       
166

       
-

       
        "minImages": {


     

       
167

       
-

       
          "type": "integer",


     

       
168

       
-

       
          "minimum": 0,


     

       
169

       
-

       
          "description": "Minimum number of images required (0 = no minimum). Only enforced if images embed is present."


     

       
170

       
-

       
        },


     

       
171

       
-

       
        "maxImages": {


     

       
172

       
-

       
          "type": "integer",


     

       
173

       
-

       
          "minimum": 1,


     

       
174

       
-

       
          "description": "Maximum number of images allowed per post (overrides global limit if lower)"


     

       
175

       
-

       
        },


     

       
176

       
-

       
        "allowFederated": {


     

       
177

       
-

       
          "type": "boolean",


     

       
178

       
-

       
          "default": true,


     

       
179

       
-

       
          "description": "Whether federated posts (e.g., from app.bsky) are allowed in this community"


     

       
180

       
 

       
        }


     

       
181

       
 

       
      }


     

       
182

       
 

       
    }


     
···

       
8

       
 

       
      "key": "literal:self",


     

       
9

       
 

       
      "record": {


     

       
10

       
 

       
        "type": "object",


     

       
11

       
+

       
        "required": ["name", "createdAt", "createdBy", "hostedBy"],


     

       
12

       
 

       
        "properties": {


     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       
13

       
 

       
          "name": {


     

       
14

       
 

       
            "type": "string",


     

       
15

       
 

       
            "maxLength": 64,


     
···

       
62

       
 

       
            "maxLength": 64,


     

       
63

       
 

       
            "description": "Community visibility level"


     

       
64

       
 

       
          },


     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       
65

       
 

       
          "moderationType": {


     

       
66

       
 

       
            "type": "string",


     

       
67

       
 

       
            "knownValues": ["moderator", "sortition"],


     
···

       
78

       
 

       
              "maxLength": 32


     

       
79

       
 

       
            }


     

       
80

       
 

       
          },


     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       
81

       
 

       
          "createdAt": {


     

       
82

       
 

       
            "type": "string",


     

       
83

       
 

       
            "format": "datetime"


     

       
84

       
 

       
          }


     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       
85

       
 

       
        }


     

       
86

       
 

       
      }


     

       
87

       
 

       
    }