Reddit Discovery Adapter (Phase 1)

[bradygaster]

Overview

Implement Reddit JSON API adapter to discover community discussions about Aspire from key .NET/C# subreddits. Provides real-time signals for confusion, adoption stories, pain patterns, and community sentiment — critical blind spot in current ACCES coverage.

Background

Per gap analysis:

• Current blind spot: Real pain/confusion signals at 15% completeness
• Reddit value: High-yield source (40-80 posts/week) with zero authentication required
• Community priority: Bunk's Architecture Refactor: SourceAdapter Pattern + SourceRegistry #1 recommendation for Phase 1 (quick win)
• Signal types: Adoption friction, confusion patterns, developer questions, praise/complaints

Requirements

• Implement RedditSourceAdapter extending SourceAdapter interface
• Use Reddit JSON API (public, no auth): \https://www.reddit.com/r/{subreddit}/new.json\
• Target subreddits: r/dotnet, r/csharp, r/programming, r/aspnetcore
• Filter posts by keyword: "aspire", "dotnet aspire", ".net aspire"
• Extract: title, author, subreddit, post URL, score, comment count, timestamp, body text
• Map to ContentItem type with channel=subreddit name, source="reddit"
• Respect Reddit rate limits: max 60 requests/minute (add 1-second delay between subreddit calls)
• Handle deleted posts, removed content, and API errors gracefully

Squad SDK Integration

• Adapter registration: Auto-discovered by SourceRegistry via SourceAdapter interface
• Validation logic: RedditSourceAdapter.validate() returns true (no env vars needed)
• Error handling: Follows Squad SDK error boundary pattern (isolated failures, continue on error)

Acceptance Criteria

• AC1: Adapter discovers 10+ Aspire-related posts per run from target subreddits
• AC2: Each Reddit post maps to ContentItem with valid: id (sha256), title, url, author, publishedAt, content (post body)
• AC3: Duplicate posts detected via canonical ID (same URL = same sha256 hash)
• AC4: Adapter handles rate limits without crashing (1-second delay between subreddit requests)
• AC5: If Reddit API is unreachable, adapter logs warning and returns empty result (does not crash engine)
• AC6: Reddit posts appear in final reports with channel="r/dotnet" (or other subreddit name)

Dependencies

Depends on: Issue #1 (Architecture Refactor) — Must complete SourceAdapter pattern first

Assigned To

• Bunk (Community scout, implementation)

Estimated Effort

1 session

• Implement RedditSourceAdapter class
• Test against live Reddit API
• Validate signal quality with Beth

[github-actions]

🏗️ Squad Triage — Freamon (Lead / Editor-in-Chief)

Issue: #6 — Reddit Discovery Adapter (Phase 1)
Assigned to: Freamon (Lead / Editor-in-Chief)
Reason: No specific domain match — assigned to Lead for further analysis

@copilot evaluation: 🔴 Not suitable — issue involves work outside the coding agent's capability profile.

Team roster:

• Freamon (Lead / Editor-in-Chief) → label: squad:freamon
• McNulty (TypeScript Implementer) → label: squad:mcnulty
• Kima (Source Scout (Content)) → label: squad:kima
• Bunk (Source Scout (Community)) → label: squad:bunk
• Omar (Signal Analyst) → label: squad:omar
• Bubbles (Taxonomy + Dedupe Librarian) → label: squad:bubbles
• Daniels (Copilot SDK Specialist) → label: squad:daniels
• Stringer (Squad SDK Orchestrator) → label: squad:stringer
• Ralph (Work Monitor) → label: squad:ralph
• @copilot (Coding Agent) → label: squad:copilot

To reassign, remove the current squad:* label and add the correct one.

[github-actions]

🔄 Ralph — Auto-Triage

Assigned to: Freamon (Lead / Editor-in-Chief)
Reason: No domain match — routed to Lead

Ralph auto-triaged this issue via the squad heartbeat. To reassign, swap the squad:* label.

[github-actions]

🔄 Ralph — Auto-Triage

Assigned to: Freamon (Lead / Editor-in-Chief)
Reason: No domain match — routed to Lead

Ralph auto-triaged this issue via the squad heartbeat. To reassign, swap the squad:* label.

[github-actions]

🔄 Ralph — Auto-Triage

Assigned to: Freamon (Lead / Editor-in-Chief)
Reason: No domain match — routed to Lead

Ralph auto-triaged this issue via the squad heartbeat. To reassign, swap the squad:* label.