commit 2fde1bc6d1a5960a2b038e0a0ed3fcb2020e8e59 · bretton.dev/coves

.env.dev

···

       128
        
       PDS_INSTANCE_HANDLE=testuser123.local.coves.dev

     

       129
        
       PDS_INSTANCE_PASSWORD=test-password-123

     

       130
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       131
        
       # =============================================================================

     

       132
        
       # Development Settings

     

       133
        
       # =============================================================================

···

       128
        
       PDS_INSTANCE_HANDLE=testuser123.local.coves.dev

     

       129
        
       PDS_INSTANCE_PASSWORD=test-password-123

     

       130
        
       

     

       131
       +
       # Kagi News Aggregator DID (for trusted thumbnail URLs)

     

       132
       +
       KAGI_AGGREGATOR_DID=did:plc:yyf34padpfjknejyutxtionr

     

       133
       +
       

     

       134
        
       # =============================================================================

     

       135
        
       # Development Settings

     

       136
        
       # =============================================================================

+1 -1

aggregators/kagi-news/README.md

···

       8
        
       - Fetches RSS feeds from Kagi News daily via CRON

     

       9
        
       - Parses HTML descriptions to extract structured content (highlights, perspectives, sources)

     

       10
        
       - Formats posts using Coves rich text with facets (bold, italic, links)

     

       11
       -
       - Hot-links images from Kagi's proxy (no blob upload)

     

       12
        
       - Posts to configured communities via XRPC

     

       13
        
       

     

       14
        
       ## Project Structure

···

       8
        
       - Fetches RSS feeds from Kagi News daily via CRON

     

       9
        
       - Parses HTML descriptions to extract structured content (highlights, perspectives, sources)

     

       10
        
       - Formats posts using Coves rich text with facets (bold, italic, links)

     

       11
       +
       - Thumbnails are automatically extracted by the server's unfurl service

     

       12
        
       - Posts to configured communities via XRPC

     

       13
        
       

     

       14
        
       ## Project Structure

+13 -14

aggregators/kagi-news/src/coves_client.py

···

       72
        
               content: str,

     

       73
        
               facets: List[Dict],

     

       74
        
               title: Optional[str] = None,

     

       75
       -
               embed: Optional[Dict] = None

     

       0
        
       
     

       76
        
           ) -> str:

     

       77
        
               """

     

       78
        
               Create a post in a community.

     
···

       83
        
                   facets: Rich text facets (formatting, links)

     

       84
        
                   title: Optional post title

     

       85
        
                   embed: Optional external embed

     

       0
        
       
     

       86
        
       

     

       87
        
               Returns:

     

       88
        
                   AT Proto URI of created post (e.g., "at://did:plc:.../social.coves.post/...")

     
···

       109
        
                   if embed:

     

       110
        
                       post_data["embed"] = embed

     

       111
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       112
        
                   # Use Coves-specific endpoint (not direct PDS write)

     

       113
        
                   # This provides validation, authorization, and business logic

     

       114
        
                   logger.info(f"Creating post in community: {community_handle}")

     
···

       141
        
               self,

     

       142
        
               uri: str,

     

       143
        
               title: str,

     

       144
       -
               description: str,

     

       145
       -
               thumb: Optional[str] = None

     

       146
        
           ) -> Dict:

     

       147
        
               """

     

       148
        
               Create external embed object for hot-linked content.

     

       149
        
       

     

       150
        
               Args:

     

       151
       -
                   uri: External URL (story link)

     

       152
       -
                   title: Story title

     

       153
       -
                   description: Story description/summary

     

       154
       -
                   thumb: Optional thumbnail image URL

     

       155
        
       

     

       156
        
               Returns:

     

       157
       -
                   External embed dictionary

     

       158
        
               """

     

       159
       -
               embed = {

     

       160
        
                   "$type": "social.coves.embed.external",

     

       161
        
                   "external": {

     

       162
        
                       "uri": uri,

     
···

       164
        
                       "description": description

     

       165
        
                   }

     

       166
        
               }

     

       167
       -
       

     

       168
       -
               if thumb:

     

       169
       -
                   embed["external"]["thumb"] = thumb

     

       170
       -
       

     

       171
       -
               return embed

     

       172
        
       

     

       173
        
           def _get_timestamp(self) -> str:

     

       174
        
               """

···

       72
        
               content: str,

     

       73
        
               facets: List[Dict],

     

       74
        
               title: Optional[str] = None,

     

       75
       +
               embed: Optional[Dict] = None,

     

       76
       +
               thumbnail_url: Optional[str] = None

     

       77
        
           ) -> str:

     

       78
        
               """

     

       79
        
               Create a post in a community.

     
···

       84
        
                   facets: Rich text facets (formatting, links)

     

       85
        
                   title: Optional post title

     

       86
        
                   embed: Optional external embed

     

       87
       +
                   thumbnail_url: Optional thumbnail URL (for trusted aggregators only)

     

       88
        
       

     

       89
        
               Returns:

     

       90
        
                   AT Proto URI of created post (e.g., "at://did:plc:.../social.coves.post/...")

     
···

       111
        
                   if embed:

     

       112
        
                       post_data["embed"] = embed

     

       113
        
       

     

       114
       +
                   # Add thumbnail URL at top level if provided (for trusted aggregators)

     

       115
       +
                   if thumbnail_url:

     

       116
       +
                       post_data["thumbnailUrl"] = thumbnail_url

     

       117
       +
       

     

       118
        
                   # Use Coves-specific endpoint (not direct PDS write)

     

       119
        
                   # This provides validation, authorization, and business logic

     

       120
        
                   logger.info(f"Creating post in community: {community_handle}")

     
···

       147
        
               self,

     

       148
        
               uri: str,

     

       149
        
               title: str,

     

       150
       +
               description: str

     

       0
        
       
     

       151
        
           ) -> Dict:

     

       152
        
               """

     

       153
        
               Create external embed object for hot-linked content.

     

       154
        
       

     

       155
        
               Args:

     

       156
       +
                   uri: URL of the external content

     

       157
       +
                   title: Title of the content

     

       158
       +
                   description: Description/summary

     

       0
        
       
     

       159
        
       

     

       160
        
               Returns:

     

       161
       +
                   Embed dictionary ready for post creation

     

       162
        
               """

     

       163
       +
               return {

     

       164
        
                   "$type": "social.coves.embed.external",

     

       165
        
                   "external": {

     

       166
        
                       "uri": uri,

     
···

       168
        
                       "description": description

     

       169
        
                   }

     

       170
        
               }

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       171
        
       

     

       172
        
           def _get_timestamp(self) -> str:

     

       173
        
               """

+4 -3

aggregators/kagi-news/src/main.py

···

       173
        
                       embed = self.coves_client.create_external_embed(

     

       174
        
                           uri=story.link,

     

       175
        
                           title=story.title,

     

       176
       -
                           description=story.summary[:200] if len(story.summary) > 200 else story.summary,

     

       177
       -
                           thumb=story.image_url

     

       178
        
                       )

     

       179
        
       

     

       180
        
                       # Post to community

     

       0
        
       
     

       181
        
                       try:

     

       182
        
                           post_uri = self.coves_client.create_post(

     

       183
        
                               community_handle=feed_config.community_handle,

     

       184
        
                               title=story.title,

     

       185
        
                               content=rich_text["content"],

     

       186
        
                               facets=rich_text["facets"],

     

       187
       -
                               embed=embed

     

       0
        
       
     

       188
        
                           )

     

       189
        
       

     

       190
        
                           # Mark as posted (only if successful)

···

       173
        
                       embed = self.coves_client.create_external_embed(

     

       174
        
                           uri=story.link,

     

       175
        
                           title=story.title,

     

       176
       +
                           description=story.summary[:200] if len(story.summary) > 200 else story.summary

     

       0
        
       
     

       177
        
                       )

     

       178
        
       

     

       179
        
                       # Post to community

     

       180
       +
                       # Pass thumbnail URL from RSS feed at top level for trusted aggregator upload

     

       181
        
                       try:

     

       182
        
                           post_uri = self.coves_client.create_post(

     

       183
        
                               community_handle=feed_config.community_handle,

     

       184
        
                               title=story.title,

     

       185
        
                               content=rich_text["content"],

     

       186
        
                               facets=rich_text["facets"],

     

       187
       +
                               embed=embed,

     

       188
       +
                               thumbnail_url=story.image_url  # From RSS feed - server will validate and upload

     

       189
        
                           )

     

       190
        
       

     

       191
        
                           # Mark as posted (only if successful)

+5 -14

aggregators/kagi-news/tests/test_e2e.py

···

       398
        
           Verifies:

     

       399
        
           - Embed structure matches social.coves.embed.external

     

       400
        
           - All required fields are present

     

       401
       -
           - Optional thumbnail is included when provided

     

       402
        
           """

     

       403
        
           handle, password = aggregator_credentials

     

       404
        
       

     
···

       408
        
               password=password

     

       409
        
           )

     

       410
        
       

     

       411
       -
           # Test with thumbnail

     

       412
        
           embed = client.create_external_embed(

     

       413
        
               uri="https://example.com/story",

     

       414
        
               title="Test Story",

     

       415
       -
               description="Test description",

     

       416
       -
               thumb="https://example.com/image.jpg"

     

       417
        
           )

     

       418
        
       

     

       419
        
           assert embed["$type"] == "social.coves.embed.external"

     

       420
        
           assert embed["external"]["uri"] == "https://example.com/story"

     

       421
        
           assert embed["external"]["title"] == "Test Story"

     

       422
        
           assert embed["external"]["description"] == "Test description"

     

       423
       -
           assert embed["external"]["thumb"] == "https://example.com/image.jpg"

     

       424
       -
       

     

       425
       -
           # Test without thumbnail

     

       426
       -
           embed_no_thumb = client.create_external_embed(

     

       427
       -
               uri="https://example.com/story2",

     

       428
       -
               title="Test Story 2",

     

       429
       -
               description="Test description 2"

     

       430
       -
           )

     

       431
       -
       

     

       432
       -
           assert "thumb" not in embed_no_thumb["external"]

     

       433
        
           print("\n✅ External embed format correct")

···

       398
        
           Verifies:

     

       399
        
           - Embed structure matches social.coves.embed.external

     

       400
        
           - All required fields are present

     

       401
       +
           - Thumbnails are handled by server's unfurl service (not included in client)

     

       402
        
           """

     

       403
        
           handle, password = aggregator_credentials

     

       404
        
       

     
···

       408
        
               password=password

     

       409
        
           )

     

       410
        
       

     

       411
       +
           # Create external embed (server will handle thumbnail extraction)

     

       412
        
           embed = client.create_external_embed(

     

       413
        
               uri="https://example.com/story",

     

       414
        
               title="Test Story",

     

       415
       +
               description="Test description"

     

       0
        
       
     

       416
        
           )

     

       417
        
       

     

       418
        
           assert embed["$type"] == "social.coves.embed.external"

     

       419
        
           assert embed["external"]["uri"] == "https://example.com/story"

     

       420
        
           assert embed["external"]["title"] == "Test Story"

     

       421
        
           assert embed["external"]["description"] == "Test description"

     

       422
       +
           # Thumbnail is not included - server's unfurl service handles it

     

       423
       +
           assert "thumb" not in embed["external"]

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       424
        
           print("\n✅ External embed format correct")

+4 -3

aggregators/kagi-news/tests/test_main.py

···

       404
        
               mock_client.create_post.return_value = "at://did:plc:test/social.coves.post/abc123"

     

       405
        
       

     

       406
        
               # Mock create_external_embed to return proper embed structure

     

       0
        
       
     

       407
        
               mock_client.create_external_embed.return_value = {

     

       408
        
                   "$type": "social.coves.embed.external",

     

       409
        
                   "external": {

     

       410
        
                       "uri": sample_story.link,

     

       411
        
                       "title": sample_story.title,

     

       412
       -
                       "description": sample_story.summary,

     

       413
       -
                       "thumb": sample_story.image_url

     

       414
        
                   }

     

       415
        
               }

     

       416
        
       

     
···

       457
        
                   assert call_kwargs["embed"]["$type"] == "social.coves.embed.external"

     

       458
        
                   assert call_kwargs["embed"]["external"]["uri"] == sample_story.link

     

       459
        
                   assert call_kwargs["embed"]["external"]["title"] == sample_story.title

     

       460
       -
                   assert call_kwargs["embed"]["external"]["thumb"] == sample_story.image_url

     

       0

···

       404
        
               mock_client.create_post.return_value = "at://did:plc:test/social.coves.post/abc123"

     

       405
        
       

     

       406
        
               # Mock create_external_embed to return proper embed structure

     

       407
       +
               # Note: Thumbnails are handled by server's unfurl service, not client

     

       408
        
               mock_client.create_external_embed.return_value = {

     

       409
        
                   "$type": "social.coves.embed.external",

     

       410
        
                   "external": {

     

       411
        
                       "uri": sample_story.link,

     

       412
        
                       "title": sample_story.title,

     

       413
       +
                       "description": sample_story.summary

     

       0
        
       
     

       414
        
                   }

     

       415
        
               }

     

       416
        
       

     
···

       457
        
                   assert call_kwargs["embed"]["$type"] == "social.coves.embed.external"

     

       458
        
                   assert call_kwargs["embed"]["external"]["uri"] == sample_story.link

     

       459
        
                   assert call_kwargs["embed"]["external"]["title"] == sample_story.title

     

       460
       +
                   # Thumbnail is not included - server's unfurl service handles it

     

       461
       +
                   assert "thumb" not in call_kwargs["embed"]["external"]

+60

docs/PRD_BACKLOG.md

···

       601
        
       

     

       602
        
       ---

     

       603
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       604
        
       ## 🔵 P3: Technical Debt

     

       605
        
       

     

       606
        
       ### Consolidate Environment Variable Validation

···

       601
        
       

     

       602
        
       ---

     

       603
        
       

     

       604
       +
       ### Unfurl Cache Cleanup Background Job

     

       605
       +
       **Added:** 2025-11-07 | **Effort:** 2-3 hours | **Priority:** Performance/Maintenance

     

       606
       +
       

     

       607
       +
       **Problem:** The `unfurl_cache` table will grow indefinitely as expired entries are not deleted. While the cache uses lazy expiration (checking `expires_at` on read), old records remain in the database consuming disk space.

     

       608
       +
       

     

       609
       +
       **Impact:**

     

       610
       +
       - 📊 ~1KB per cached URL

     

       611
       +
       - 📈 At 10K cached URLs = ~10MB (negligible for alpha)

     

       612
       +
       - ⚠️ At 1M cached URLs = ~1GB (potential issue at scale)

     

       613
       +
       - 🐌 Table bloat can slow down queries over time

     

       614
       +
       

     

       615
       +
       **Current Mitigation:**

     

       616
       +
       - ✅ Lazy expiration: Cache hits check `expires_at` and refetch if expired

     

       617
       +
       - ✅ Indexed on `expires_at` for efficient expiration queries

     

       618
       +
       - ✅ Not critical for alpha (growth is gradual)

     

       619
       +
       

     

       620
       +
       **Solution (Beta/Production):**

     

       621
       +
       Implement background cleanup job to delete expired entries:

     

       622
       +
       

     

       623
       +
       ```go

     

       624
       +
       // Periodic cleanup (run daily or weekly)

     

       625
       +
       func (r *unfurlRepository) CleanupExpired(ctx context.Context) (int64, error) {

     

       626
       +
           query := `DELETE FROM unfurl_cache WHERE expires_at < NOW()`

     

       627
       +
           result, err := r.db.ExecContext(ctx, query)

     

       628
       +
           if err != nil {

     

       629
       +
               return 0, err

     

       630
       +
           }

     

       631
       +
           return result.RowsAffected()

     

       632
       +
       }

     

       633
       +
       ```

     

       634
       +
       

     

       635
       +
       **Implementation Options:**

     

       636
       +
       1. **Cron job**: Separate process runs cleanup on schedule

     

       637
       +
       2. **Background goroutine**: Service-level background task with configurable interval

     

       638
       +
       3. **PostgreSQL pg_cron extension**: Database-level scheduled cleanup

     

       639
       +
       

     

       640
       +
       **Recommended Approach:**

     

       641
       +
       - Phase 1 (Beta): Background goroutine running weekly cleanup

     

       642
       +
       - Phase 2 (Production): Migrate to pg_cron or external cron for reliability

     

       643
       +
       

     

       644
       +
       **Configuration:**

     

       645
       +
       ```bash

     

       646
       +
       UNFURL_CACHE_CLEANUP_ENABLED=true

     

       647
       +
       UNFURL_CACHE_CLEANUP_INTERVAL=168h  # 7 days

     

       648
       +
       ```

     

       649
       +
       

     

       650
       +
       **Monitoring:**

     

       651
       +
       - Log cleanup operations: `[UNFURL-CACHE-CLEANUP] Deleted 1234 expired entries`

     

       652
       +
       - Track table size growth over time

     

       653
       +
       - Alert if table exceeds threshold (e.g., 100MB)

     

       654
       +
       

     

       655
       +
       **Files to Create:**

     

       656
       +
       - `internal/core/unfurl/cleanup.go` - Background cleanup service

     

       657
       +
       

     

       658
       +
       **Related:**

     

       659
       +
       - Implemented in oEmbed unfurling feature (2025-11-07)

     

       660
       +
       - Cache table: [migration XXX_create_unfurl_cache.sql](../internal/db/migrations/)

     

       661
       +
       

     

       662
       +
       ---

     

       663
       +
       

     

       664
        
       ## 🔵 P3: Technical Debt

     

       665
        
       

     

       666
        
       ### Consolidate Environment Variable Validation

+348

scripts/generate_test_comments.go

···

       1
       +
       package main

     

       2
       +
       

     

       3
       +
       import (

     

       4
       +
       	"database/sql"

     

       5
       +
       	"fmt"

     

       6
       +
       	"log"

     

       7
       +
       	"math/rand"

     

       8
       +
       	"time"

     

       9
       +
       

     

       10
       +
       	_ "github.com/lib/pq"

     

       11
       +
       )

     

       12
       +
       

     

       13
       +
       // Post URI: at://did:plc:hcuo3qx2lr7h7dquusbeobht/social.coves.community.post/3m4yohkzbkc2b

     

       14
       +
       // Community DID: did:plc:hcuo3qx2lr7h7dquusbeobht

     

       15
       +
       // Community Handle: test-usnews.community.coves.social

     

       16
       +
       

     

       17
       +
       const (

     

       18
       +
       	postURI      = "at://did:plc:hcuo3qx2lr7h7dquusbeobht/social.coves.community.post/3m4yohkzbkc2b"

     

       19
       +
       	postCID      = "bafyzohran123"

     

       20
       +
       	communityDID = "did:plc:hcuo3qx2lr7h7dquusbeobht"

     

       21
       +
       )

     

       22
       +
       

     

       23
       +
       type User struct {

     

       24
       +
       	DID    string

     

       25
       +
       	Handle string

     

       26
       +
       	Name   string

     

       27
       +
       }

     

       28
       +
       

     

       29
       +
       type Comment struct {

     

       30
       +
       	URI       string

     

       31
       +
       	CID       string

     

       32
       +
       	RKey      string

     

       33
       +
       	DID       string

     

       34
       +
       	RootURI   string

     

       35
       +
       	RootCID   string

     

       36
       +
       	ParentURI string

     

       37
       +
       	ParentCID string

     

       38
       +
       	Content   string

     

       39
       +
       	CreatedAt time.Time

     

       40
       +
       }

     

       41
       +
       

     

       42
       +
       var userNames = []string{

     

       43
       +
       	"sarah_jenkins", "michael_chen", "jessica_rodriguez", "david_nguyen",

     

       44
       +
       	"emily_williams", "james_patel", "ashley_garcia", "robert_kim",

     

       45
       +
       	"jennifer_lee", "william_martinez", "amanda_johnson", "daniel_brown",

     

       46
       +
       	"melissa_davis", "christopher_wilson", "rebecca_anderson", "matthew_taylor",

     

       47
       +
       	"laura_thomas", "anthony_moore", "stephanie_jackson", "joshua_white",

     

       48
       +
       	"nicole_harris", "ryan_martin", "rachel_thompson", "kevin_garcia",

     

       49
       +
       	"michelle_robinson", "brandon_clark", "samantha_lewis", "justin_walker",

     

       50
       +
       	"kimberly_hall", "tyler_allen", "brittany_young", "andrew_king",

     

       51
       +
       }

     

       52
       +
       

     

       53
       +
       var positiveComments = []string{

     

       54
       +
       	"This is such fantastic news! Zohran represents real progressive values and I couldn't be happier with this outcome!",

     

       55
       +
       	"Finally! A mayor who actually understands the needs of working families. This is a historic moment for NYC!",

     

       56
       +
       	"What an incredible victory! Zohran's grassroots campaign shows that people power still matters in politics.",

     

       57
       +
       	"I'm so proud of our city today. This win gives me hope for the future of progressive politics!",

     

       58
       +
       	"This is exactly what NYC needed. Zohran's policies on housing and healthcare are going to transform our city!",

     

       59
       +
       	"Congratulations to Zohran! His commitment to affordable housing is going to make such a difference.",

     

       60
       +
       	"I've been following his campaign since day one and I'm thrilled to see him win. He truly deserves this!",

     

       61
       +
       	"This victory is proof that authentic progressive candidates can win. So excited for what's ahead!",

     

       62
       +
       	"Zohran's dedication to public transit and climate action is exactly what we need. Great day for NYC!",

     

       63
       +
       	"What a momentous occasion! His policies on education are going to help so many families.",

     

       64
       +
       	"I'm emotional reading this! Zohran gives me so much hope for the direction of our city.",

     

       65
       +
       	"This is the change we've been waiting for! Can't wait to see his vision become reality.",

     

       66
       +
       	"His campaign was inspiring from start to finish. This win is well-deserved!",

     

       67
       +
       	"Finally, a mayor who will prioritize working people over corporate interests!",

     

       68
       +
       	"The grassroots organizing that made this happen was incredible to witness. Democracy in action!",

     

       69
       +
       	"Zohran's focus on social justice is refreshing. This is a win for all New Yorkers!",

     

       70
       +
       	"I volunteered for his campaign and this victory means everything. So proud!",

     

       71
       +
       	"This gives me faith in our democratic process. People-powered campaigns can still win!",

     

       72
       +
       	"His policies on criminal justice reform are exactly what NYC needs right now.",

     

       73
       +
       	"What an amazing day for progressive politics! Zohran is going to do great things.",

     

       74
       +
       }

     

       75
       +
       

     

       76
       +
       var replyComments = []string{

     

       77
       +
       	"Absolutely agree! This is going to be transformative.",

     

       78
       +
       	"Couldn't have said it better myself!",

     

       79
       +
       	"Yes! This is exactly right.",

     

       80
       +
       	"100% this! So well said.",

     

       81
       +
       	"This perfectly captures how I feel too!",

     

       82
       +
       	"Exactly my thoughts! Great perspective.",

     

       83
       +
       	"So true! I'm equally excited.",

     

       84
       +
       	"Well put! I share your optimism.",

     

       85
       +
       	"This! Absolutely this!",

     

       86
       +
       	"I feel the same way! Great comment.",

     

       87
       +
       	"You took the words right out of my mouth!",

     

       88
       +
       	"Perfectly stated! I agree completely.",

     

       89
       +
       	"Yes yes yes! This is it exactly.",

     

       90
       +
       	"This is spot on! Thank you for sharing.",

     

       91
       +
       	"I couldn't agree more with this take!",

     

       92
       +
       	"Exactly what I was thinking! Well said.",

     

       93
       +
       	"This captures it perfectly!",

     

       94
       +
       	"So much this! Great comment.",

     

       95
       +
       	"You nailed it! I feel exactly the same.",

     

       96
       +
       	"This is the best take I've seen! Agreed!",

     

       97
       +
       }

     

       98
       +
       

     

       99
       +
       var deepReplyComments = []string{

     

       100
       +
       	"And it's not just about the policies, it's about the movement he's building!",

     

       101
       +
       	"This thread is giving me life! So glad to see so many people excited.",

     

       102
       +
       	"I love seeing all this positive energy! We're going to change NYC together.",

     

       103
       +
       	"Reading these comments makes me even more hopeful. We did this!",

     

       104
       +
       	"The solidarity in this thread is beautiful. This is what democracy looks like!",

     

       105
       +
       	"I'm so grateful to be part of this community right now. Historic moment!",

     

       106
       +
       	"This conversation shows how ready people are for real change.",

     

       107
       +
       	"Seeing this support gives me so much hope for what's possible.",

     

       108
       +
       	"This is the kind of energy we need to keep up! Let's go!",

     

       109
       +
       	"I'm saving this thread to look back on this incredible moment.",

     

       110
       +
       }

     

       111
       +
       

     

       112
       +
       func generateTID() string {

     

       113
       +
       	// Simple TID generator for testing (timestamp in microseconds + random)

     

       114
       +
       	now := time.Now().UnixMicro()

     

       115
       +
       	return fmt.Sprintf("%d%04d", now, rand.Intn(10000))

     

       116
       +
       }

     

       117
       +
       

     

       118
       +
       func createUser(db *sql.DB, handle, name string, idx int) (*User, error) {

     

       119
       +
       	did := fmt.Sprintf("did:plc:testuser%d%d", time.Now().Unix(), idx)

     

       120
       +
       	user := &User{

     

       121
       +
       		DID:    did,

     

       122
       +
       		Handle: handle,

     

       123
       +
       		Name:   name,

     

       124
       +
       	}

     

       125
       +
       

     

       126
       +
       	query := `

     

       127
       +
       		INSERT INTO users (did, handle, pds_url, created_at, updated_at)

     

       128
       +
       		VALUES ($1, $2, $3, NOW(), NOW())

     

       129
       +
       		ON CONFLICT (did) DO NOTHING

     

       130
       +
       	`

     

       131
       +
       

     

       132
       +
       	_, err := db.Exec(query, user.DID, user.Handle, "http://localhost:3001")

     

       133
       +
       	if err != nil {

     

       134
       +
       		return nil, fmt.Errorf("failed to create user: %w", err)

     

       135
       +
       	}

     

       136
       +
       

     

       137
       +
       	log.Printf("Created user: %s (%s)", user.Handle, user.DID)

     

       138
       +
       	return user, nil

     

       139
       +
       }

     

       140
       +
       

     

       141
       +
       func createComment(db *sql.DB, user *User, content, parentURI, parentCID string, createdAt time.Time) (*Comment, error) {

     

       142
       +
       	rkey := generateTID()

     

       143
       +
       	uri := fmt.Sprintf("at://%s/social.coves.feed.comment/%s", user.DID, rkey)

     

       144
       +
       	cid := fmt.Sprintf("bafy%s", rkey)

     

       145
       +
       

     

       146
       +
       	comment := &Comment{

     

       147
       +
       		URI:       uri,

     

       148
       +
       		CID:       cid,

     

       149
       +
       		RKey:      rkey,

     

       150
       +
       		DID:       user.DID,

     

       151
       +
       		RootURI:   postURI,

     

       152
       +
       		RootCID:   postCID,

     

       153
       +
       		ParentURI: parentURI,

     

       154
       +
       		ParentCID: parentCID,

     

       155
       +
       		Content:   content,

     

       156
       +
       		CreatedAt: createdAt,

     

       157
       +
       	}

     

       158
       +
       

     

       159
       +
       	query := `

     

       160
       +
       		INSERT INTO comments (

     

       161
       +
       			uri, cid, rkey, commenter_did, root_uri, root_cid,

     

       162
       +
       			parent_uri, parent_cid, content, created_at, indexed_at

     

       163
       +
       		) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, NOW())

     

       164
       +
       		ON CONFLICT (uri) DO NOTHING

     

       165
       +
       		RETURNING id

     

       166
       +
       	`

     

       167
       +
       

     

       168
       +
       	var id int64

     

       169
       +
       	err := db.QueryRow(query,

     

       170
       +
       		comment.URI, comment.CID, comment.RKey, comment.DID,

     

       171
       +
       		comment.RootURI, comment.RootCID, comment.ParentURI, comment.ParentCID,

     

       172
       +
       		comment.Content, comment.CreatedAt,

     

       173
       +
       	).Scan(&id)

     

       174
       +
       	if err != nil {

     

       175
       +
       		return nil, fmt.Errorf("failed to create comment: %w", err)

     

       176
       +
       	}

     

       177
       +
       

     

       178
       +
       	log.Printf("Created comment by %s: %.50s...", user.Handle, content)

     

       179
       +
       	return comment, nil

     

       180
       +
       }

     

       181
       +
       

     

       182
       +
       func updateCommentCount(db *sql.DB, parentURI string, isPost bool) error {

     

       183
       +
       	if isPost {

     

       184
       +
       		_, err := db.Exec(`

     

       185
       +
       			UPDATE posts

     

       186
       +
       			SET comment_count = comment_count + 1

     

       187
       +
       			WHERE uri = $1

     

       188
       +
       		`, parentURI)

     

       189
       +
       		return err

     

       190
       +
       	}

     

       191
       +
       

     

       192
       +
       	_, err := db.Exec(`

     

       193
       +
       		UPDATE comments

     

       194
       +
       		SET reply_count = reply_count + 1

     

       195
       +
       		WHERE uri = $1

     

       196
       +
       	`, parentURI)

     

       197
       +
       	return err

     

       198
       +
       }

     

       199
       +
       

     

       200
       +
       func main() {

     

       201
       +
       	// Connect to dev database

     

       202
       +
       	dbURL := "postgres://dev_user:dev_password@localhost:5435/coves_dev?sslmode=disable"

     

       203
       +
       	db, err := sql.Open("postgres", dbURL)

     

       204
       +
       	if err != nil {

     

       205
       +
       		log.Fatalf("Failed to connect to database: %v", err)

     

       206
       +
       	}

     

       207
       +
       	defer db.Close()

     

       208
       +
       

     

       209
       +
       	if err := db.Ping(); err != nil {

     

       210
       +
       		log.Fatalf("Failed to ping database: %v", err)

     

       211
       +
       	}

     

       212
       +
       

     

       213
       +
       	log.Println("Connected to database successfully!")

     

       214
       +
       	log.Printf("Post URI: %s", postURI)

     

       215
       +
       	log.Println("Starting to generate test data...")

     

       216
       +
       

     

       217
       +
       	rand.Seed(time.Now().UnixNano())

     

       218
       +
       

     

       219
       +
       	// Create users

     

       220
       +
       	log.Println("\n=== Creating Users ===")

     

       221
       +
       	users := make([]*User, 0, len(userNames))

     

       222
       +
       	for i, name := range userNames {

     

       223
       +
       		handle := fmt.Sprintf("%s.bsky.social", name)

     

       224
       +
       		user, err := createUser(db, handle, name, i)

     

       225
       +
       		if err != nil {

     

       226
       +
       			log.Printf("Warning: Failed to create user %s: %v", name, err)

     

       227
       +
       			continue

     

       228
       +
       		}

     

       229
       +
       		users = append(users, user)

     

       230
       +
       	}

     

       231
       +
       

     

       232
       +
       	log.Printf("\nCreated %d users", len(users))

     

       233
       +
       

     

       234
       +
       	// Generate comments with varied timing

     

       235
       +
       	log.Println("\n=== Creating Top-Level Comments ===")

     

       236
       +
       	baseTime := time.Now().Add(-2 * time.Hour) // Comments from 2 hours ago

     

       237
       +
       	topLevelComments := make([]*Comment, 0)

     

       238
       +
       

     

       239
       +
       	// Create 15-20 top-level comments

     

       240
       +
       	numTopLevel := 15 + rand.Intn(6)

     

       241
       +
       	for i := 0; i < numTopLevel && i < len(users); i++ {

     

       242
       +
       		user := users[i]

     

       243
       +
       		content := positiveComments[i%len(positiveComments)]

     

       244
       +
       		createdAt := baseTime.Add(time.Duration(i*5+rand.Intn(3)) * time.Minute)

     

       245
       +
       

     

       246
       +
       		comment, err := createComment(db, user, content, postURI, postCID, createdAt)

     

       247
       +
       		if err != nil {

     

       248
       +
       			log.Printf("Warning: Failed to create top-level comment: %v", err)

     

       249
       +
       			continue

     

       250
       +
       		}

     

       251
       +
       

     

       252
       +
       		topLevelComments = append(topLevelComments, comment)

     

       253
       +
       

     

       254
       +
       		// Update post comment count

     

       255
       +
       		if err := updateCommentCount(db, postURI, true); err != nil {

     

       256
       +
       			log.Printf("Warning: Failed to update post comment count: %v", err)

     

       257
       +
       		}

     

       258
       +
       

     

       259
       +
       		// Small delay to avoid timestamp collisions

     

       260
       +
       		time.Sleep(10 * time.Millisecond)

     

       261
       +
       	}

     

       262
       +
       

     

       263
       +
       	log.Printf("Created %d top-level comments", len(topLevelComments))

     

       264
       +
       

     

       265
       +
       	// Create first-level replies (replies to top-level comments)

     

       266
       +
       	log.Println("\n=== Creating First-Level Replies ===")

     

       267
       +
       	firstLevelReplies := make([]*Comment, 0)

     

       268
       +
       

     

       269
       +
       	for i, parentComment := range topLevelComments {

     

       270
       +
       		// 60% chance of having replies

     

       271
       +
       		if rand.Float64() > 0.6 {

     

       272
       +
       			continue

     

       273
       +
       		}

     

       274
       +
       

     

       275
       +
       		// 1-3 replies per comment

     

       276
       +
       		numReplies := 1 + rand.Intn(3)

     

       277
       +
       		for j := 0; j < numReplies; j++ {

     

       278
       +
       			userIdx := (i*3 + j + len(topLevelComments)) % len(users)

     

       279
       +
       			user := users[userIdx]

     

       280
       +
       			content := replyComments[rand.Intn(len(replyComments))]

     

       281
       +
       			createdAt := parentComment.CreatedAt.Add(time.Duration(5+rand.Intn(10)) * time.Minute)

     

       282
       +
       

     

       283
       +
       			comment, err := createComment(db, user, content, parentComment.URI, parentComment.CID, createdAt)

     

       284
       +
       			if err != nil {

     

       285
       +
       				log.Printf("Warning: Failed to create first-level reply: %v", err)

     

       286
       +
       				continue

     

       287
       +
       			}

     

       288
       +
       

     

       289
       +
       			firstLevelReplies = append(firstLevelReplies, comment)

     

       290
       +
       

     

       291
       +
       			// Update parent comment reply count

     

       292
       +
       			if err := updateCommentCount(db, parentComment.URI, false); err != nil {

     

       293
       +
       				log.Printf("Warning: Failed to update comment reply count: %v", err)

     

       294
       +
       			}

     

       295
       +
       

     

       296
       +
       			time.Sleep(10 * time.Millisecond)

     

       297
       +
       		}

     

       298
       +
       	}

     

       299
       +
       

     

       300
       +
       	log.Printf("Created %d first-level replies", len(firstLevelReplies))

     

       301
       +
       

     

       302
       +
       	// Create second-level replies (replies to replies) - testing nested threading

     

       303
       +
       	log.Println("\n=== Creating Second-Level Replies ===")

     

       304
       +
       	secondLevelCount := 0

     

       305
       +
       

     

       306
       +
       	for i, parentComment := range firstLevelReplies {

     

       307
       +
       		// 40% chance of having deep replies

     

       308
       +
       		if rand.Float64() > 0.4 {

     

       309
       +
       			continue

     

       310
       +
       		}

     

       311
       +
       

     

       312
       +
       		// 1-2 deep replies

     

       313
       +
       		numReplies := 1 + rand.Intn(2)

     

       314
       +
       		for j := 0; j < numReplies; j++ {

     

       315
       +
       			userIdx := (i*2 + j + len(topLevelComments) + len(firstLevelReplies)) % len(users)

     

       316
       +
       			user := users[userIdx]

     

       317
       +
       			content := deepReplyComments[rand.Intn(len(deepReplyComments))]

     

       318
       +
       			createdAt := parentComment.CreatedAt.Add(time.Duration(3+rand.Intn(7)) * time.Minute)

     

       319
       +
       

     

       320
       +
       			_, err := createComment(db, user, content, parentComment.URI, parentComment.CID, createdAt)

     

       321
       +
       			if err != nil {

     

       322
       +
       				log.Printf("Warning: Failed to create second-level reply: %v", err)

     

       323
       +
       				continue

     

       324
       +
       			}

     

       325
       +
       

     

       326
       +
       			secondLevelCount++

     

       327
       +
       

     

       328
       +
       			// Update parent comment reply count

     

       329
       +
       			if err := updateCommentCount(db, parentComment.URI, false); err != nil {

     

       330
       +
       				log.Printf("Warning: Failed to update comment reply count: %v", err)

     

       331
       +
       			}

     

       332
       +
       

     

       333
       +
       			time.Sleep(10 * time.Millisecond)

     

       334
       +
       		}

     

       335
       +
       	}

     

       336
       +
       

     

       337
       +
       	log.Printf("Created %d second-level replies", secondLevelCount)

     

       338
       +
       

     

       339
       +
       	// Print summary

     

       340
       +
       	totalComments := len(topLevelComments) + len(firstLevelReplies) + secondLevelCount

     

       341
       +
       	log.Println("\n=== Summary ===")

     

       342
       +
       	log.Printf("Total users created: %d", len(users))

     

       343
       +
       	log.Printf("Total comments created: %d", totalComments)

     

       344
       +
       	log.Printf("  - Top-level comments: %d", len(topLevelComments))

     

       345
       +
       	log.Printf("  - First-level replies: %d", len(firstLevelReplies))

     

       346
       +
       	log.Printf("  - Second-level replies: %d", secondLevelCount)

     

       347
       +
       	log.Println("\nDone! Check the post at !test-usnews for the comments.")

     

       348
       +
       }

+134

scripts/post_streamable.py

···

       1
       +
       #!/usr/bin/env python3

     

       2
       +
       """

     

       3
       +
       Quick script to post a Streamable video to test-usnews community.

     

       4
       +
       Uses the kagi-news CovesClient infrastructure.

     

       5
       +
       """

     

       6
       +
       

     

       7
       +
       import sys

     

       8
       +
       import os

     

       9
       +
       

     

       10
       +
       # Add kagi-news src to path to use CovesClient

     

       11
       +
       sys.path.insert(0, os.path.join(os.path.dirname(__file__), '../aggregators/kagi-news'))

     

       12
       +
       

     

       13
       +
       from src.coves_client import CovesClient

     

       14
       +
       

     

       15
       +
       def main():

     

       16
       +
           # Configuration

     

       17
       +
           COVES_API_URL = "http://localhost:8081"

     

       18
       +
           PDS_URL = "http://localhost:3001"

     

       19
       +
       

     

       20
       +
           # Use PDS instance credentials (from .env.dev)

     

       21
       +
           HANDLE = "testuser123.local.coves.dev"

     

       22
       +
           PASSWORD = "test-password-123"

     

       23
       +
       

     

       24
       +
           # Post details

     

       25
       +
           COMMUNITY_HANDLE = "test-usnews.community.coves.social"

     

       26
       +
       

     

       27
       +
           # Post 1: Streamable video

     

       28
       +
           STREAMABLE_URL = "https://streamable.com/7kpdft"

     

       29
       +
           STREAMABLE_TITLE = "NBACentral - \"Your son don't wanna be here, we know it's your last weekend. Enjoy ..."

     

       30
       +
       

     

       31
       +
           # Post 2: Reddit highlight

     

       32
       +
           REDDIT_URL = "https://www.reddit.com/r/nba/comments/1orfsgm/highlight_giannis_antetokounmpo_41_pts_15_reb_9/"

     

       33
       +
           REDDIT_TITLE = "[Highlight] Giannis Antetokounmpo (41 PTS, 15 REB, 9 AST) tallies his 56th career regular season game of 40+ points, passing Kareem Abdul-Jabbar for the most such games in franchise history. Milwaukee defeats Chicago 126-110 to win their NBA Cup opener."

     

       34
       +
       

     

       35
       +
           # Initialize client

     

       36
       +
           print(f"Initializing Coves client...")

     

       37
       +
           print(f"  API URL: {COVES_API_URL}")

     

       38
       +
           print(f"  PDS URL: {PDS_URL}")

     

       39
       +
           print(f"  Handle: {HANDLE}")

     

       40
       +
       

     

       41
       +
           client = CovesClient(

     

       42
       +
               api_url=COVES_API_URL,

     

       43
       +
               handle=HANDLE,

     

       44
       +
               password=PASSWORD,

     

       45
       +
               pds_url=PDS_URL

     

       46
       +
           )

     

       47
       +
       

     

       48
       +
           # Authenticate

     

       49
       +
           print("\nAuthenticating...")

     

       50
       +
           try:

     

       51
       +
               client.authenticate()

     

       52
       +
               print(f"✓ Authenticated as {client.did}")

     

       53
       +
           except Exception as e:

     

       54
       +
               print(f"✗ Authentication failed: {e}")

     

       55
       +
               return 1

     

       56
       +
       

     

       57
       +
           # Post 1: Streamable video

     

       58
       +
           print("\n" + "="*60)

     

       59
       +
           print("POST 1: STREAMABLE VIDEO")

     

       60
       +
           print("="*60)

     

       61
       +
       

     

       62
       +
           print("\nCreating minimal external embed (URI only)...")

     

       63
       +
           streamable_embed = {

     

       64
       +
               "$type": "social.coves.embed.external",

     

       65
       +
               "external": {

     

       66
       +
                   "uri": STREAMABLE_URL

     

       67
       +
               }

     

       68
       +
           }

     

       69
       +
           print(f"✓ Embed created with URI only (unfurl service should enrich)")

     

       70
       +
       

     

       71
       +
           print(f"\nPosting to {COMMUNITY_HANDLE}...")

     

       72
       +
           print(f"  Title: {STREAMABLE_TITLE}")

     

       73
       +
           print(f"  Video: {STREAMABLE_URL}")

     

       74
       +
       

     

       75
       +
           try:

     

       76
       +
               post_uri = client.create_post(

     

       77
       +
                   community_handle=COMMUNITY_HANDLE,

     

       78
       +
                   title=STREAMABLE_TITLE,

     

       79
       +
                   content="",

     

       80
       +
                   facets=[],

     

       81
       +
                   embed=streamable_embed

     

       82
       +
               )

     

       83
       +
       

     

       84
       +
               print(f"\n✓ Streamable post created successfully!")

     

       85
       +
               print(f"  URI: {post_uri}")

     

       86
       +
       

     

       87
       +
           except Exception as e:

     

       88
       +
               print(f"\n✗ Streamable post creation failed: {e}")

     

       89
       +
               import traceback

     

       90
       +
               traceback.print_exc()

     

       91
       +
               return 1

     

       92
       +
       

     

       93
       +
           # Post 2: Reddit highlight

     

       94
       +
           print("\n" + "="*60)

     

       95
       +
           print("POST 2: REDDIT HIGHLIGHT")

     

       96
       +
           print("="*60)

     

       97
       +
       

     

       98
       +
           print("\nCreating minimal external embed (URI only)...")

     

       99
       +
           reddit_embed = {

     

       100
       +
               "$type": "social.coves.embed.external",

     

       101
       +
               "external": {

     

       102
       +
                   "uri": REDDIT_URL

     

       103
       +
               }

     

       104
       +
           }

     

       105
       +
           print(f"✓ Embed created with URI only (unfurl service should enrich)")

     

       106
       +
       

     

       107
       +
           print(f"\nPosting to {COMMUNITY_HANDLE}...")

     

       108
       +
           print(f"  Title: {REDDIT_TITLE}")

     

       109
       +
           print(f"  URL: {REDDIT_URL}")

     

       110
       +
       

     

       111
       +
           try:

     

       112
       +
               post_uri = client.create_post(

     

       113
       +
                   community_handle=COMMUNITY_HANDLE,

     

       114
       +
                   title=REDDIT_TITLE,

     

       115
       +
                   content="",

     

       116
       +
                   facets=[],

     

       117
       +
                   embed=reddit_embed

     

       118
       +
               )

     

       119
       +
       

     

       120
       +
               print(f"\n✓ Reddit post created successfully!")

     

       121
       +
               print(f"  URI: {post_uri}")

     

       122
       +
               print(f"\n" + "="*60)

     

       123
       +
               print("Both posts created! Check them out at !test-usnews")

     

       124
       +
               print("="*60)

     

       125
       +
               return 0

     

       126
       +
       

     

       127
       +
           except Exception as e:

     

       128
       +
               print(f"\n✗ Reddit post creation failed: {e}")

     

       129
       +
               import traceback

     

       130
       +
               traceback.print_exc()

     

       131
       +
               return 1

     

       132
       +
       

     

       133
       +
       if __name__ == "__main__":

     

       134
       +
           sys.exit(main())