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

refactor(lexicon): Simplify community profile to single handle field

Remove redundant atprotoHandle field in favor of single DNS-resolvable
handle field. This matches Bluesky's pattern (app.bsky.actor.profile)
and follows atProto best practices.

Changes:
- Remove atprotoHandle field from social.coves.community.profile
- Update handle field description to indicate DNS-resolvable format
- Add format: "handle" validation
- Update test data to use DNS-valid handles

Rationale:
- Single source of truth for community handle
- Reduces confusion about which handle is "real"
- Client-side UI derives display format (!name@instance) from name + instance
- Follows separation of concerns: protocol vs presentation layer

Example:
- Before: handle="!gaming@coves.social", atprotoHandle="gaming.communities.coves.social"
- After: handle="gaming.communities.coves.social", display derived client-side

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

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

bretton.dev 1d6f9169 1ed4235f

options
unified split
Changed files
+3 -9
internal
atproto
lexicon
social
coves
community
profile.json
tests
lexicon-test-data
community
profile-valid.json
+2 -6
internal/atproto/lexicon/social/coves/community/profile.json 
···

       
13

       
 

       
          "handle": {


     

       
14

       
 

       
            "type": "string",


     

       
15

       
 

       
            "maxLength": 253,


     

       
16

       
-

       
            "description": "Scoped handle (!name@instance.com) for UI display"


     

       
17

       
-

       
          },


     

       
18

       
-

       
          "atprotoHandle": {


     

       
19

       
-

       
            "type": "string",


     

       
20

       
-

       
            "maxLength": 253,


     

       
21

       
-

       
            "description": "V2: Real atProto handle (e.g., gaming.coves.social) matching the community's DID"


     

       
22

       
 

       
          },


     

       
23

       
 

       
          "name": {


     

       
24

       
 

       
            "type": "string",


     
···

       
13

       
 

       
          "handle": {


     

       
14

       
 

       
            "type": "string",


     

       
15

       
 

       
            "maxLength": 253,


     

       
16

       
+

       
            "format": "handle",


     

       
17

       
+

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


     

       

       

       
     

       

       

       
     

       

       

       
     

       

       

       
     

       
18

       
 

       
          },


     

       
19

       
 

       
          "name": {


     

       
20

       
 

       
            "type": "string",
+1 -3
tests/lexicon-test-data/community/profile-valid.json 
···

       
1

       
 

       
{


     

       
2

       
 

       
  "$type": "social.coves.community.profile",


     

       
3

       
-

       
  "did": "did:plc:community123456789abc",


     

       
4

       
-

       
  "handle": "!programming@coves.social",


     

       
5

       
 

       
  "name": "programming",


     

       
6

       
 

       
  "displayName": "Programming Community",


     

       
7

       
 

       
  "description": "A community for programmers",


     

       
8

       
-

       
  "owner": "did:plc:instance123456",


     

       
9

       
 

       
  "createdBy": "did:plc:creator123456",


     

       
10

       
 

       
  "hostedBy": "did:plc:instance123456",


     

       
11

       
 

       
  "visibility": "public",


     
···

       
1

       
 

       
{


     

       
2

       
 

       
  "$type": "social.coves.community.profile",


     

       
3

       
+

       
  "handle": "programming.communities.coves.social",


     

       

       

       
     

       
4

       
 

       
  "name": "programming",


     

       
5

       
 

       
  "displayName": "Programming Community",


     

       
6

       
 

       
  "description": "A community for programmers",


     

       

       

       
     

       
7

       
 

       
  "createdBy": "did:plc:creator123456",


     

       
8

       
 

       
  "hostedBy": "did:plc:instance123456",


     

       
9

       
 

       
  "visibility": "public",