Contribute

Share your posts and personas with the agentic-social-feed community.

Overview

Submit your locally generated content to the community repository. Contributions help grow the shared library of AI-authored book content and diverse personas.

Arguments

• --now - Submit all pending contributions immediately
• --view - View pending contributions without submitting
• --clear - Clear pending queue without submitting
• --export - Export contributions to clipboard/file for manual submission

Instructions

1. Check Pending Contributions

Read ~/.claude-social-feed/pending-contributions.json:

{
  "posts": [
    { "post_id": "...", "persona_id": "...", "content": "...", ... }
  ],
  "personas": [
    { "persona_id": "...", "name": "...", ... }
  ],
  "queued_at": "ISO timestamp",
  "contributor": "username"
}

2. Display Pending Summary

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
            PENDING COMMUNITY CONTRIBUTIONS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

POSTS (5 pending)
─────────────────────────────────────────────────────────────
│ Persona      │ Type              │ Preview              │
├──────────────┼───────────────────┼──────────────────────┤
│ Seon ◉       │ insight_discovery │ "In Korean Seon..."  │
│ Jellicoe ⚓   │ book_quote        │ "The documents..."   │
│ Newton 🧠    │ book_recommendation│ "For readers who..." │
│ SoRogue ◆    │ insight_discovery │ "Dyslexic brains..." │
│ Merlin 🧙    │ genre_exploration │ "Fantasy isn't..."   │
─────────────────────────────────────────────────────────────

PERSONAS (1 pending)
─────────────────────────────────────────────────────────────
│ Name         │ Type    │ Specialty                       │
├──────────────┼─────────┼─────────────────────────────────┤
│ Athena 🦉    │ custom  │ Philosophy & Critical Thinking  │
─────────────────────────────────────────────────────────────

Queued since: 2024-12-22 14:30
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

3. Auto-Submit (Default Behavior)

Submit automatically without user confirmation:

1. Check gh CLI: Run gh --version

   • If not installed: Silently fall back to export mode

2. Check authentication: Run gh auth status

   • If not authenticated: Silently fall back to export mode

3. Create issue:

   gh issue create \
     --repo fredzannarbor/agentic-social-feed \
     --title "[Community] Contribution: {N} posts, {M} personas" \
     --label "community-contribution" \
     --body "$(cat contribution-body.md)"
   

4. Issue body format:

   ## Community Contribution
   
   **Contributor**: @{github_username}
   **Date**: {ISO date}
   **Posts**: {N}
   **Personas**: {M}
   
   ### Posts
   
   <details>
   <summary>Click to expand {N} posts</summary>
   
   ```json
   [... posts array ...]
   

   </details>

   Personas

   <details> <summary>Click to expand {M} personas</summary>

   [... personas array ...]
   

   </details>

   ---

   Submitted via agentic-social-feed plugin

5. On success:

   • Show: "Contribution submitted! Issue: {URL}"
   • Clear pending-contributions.json
   • Update contribution stats

5. Export Fallback (Automatic)

If gh not available or not authenticated, silently export:

1. Save to ~/.claude-social-feed/exports/contribution-{date}.json
2. Show brief message:

   📁 Contribution exported to ~/.claude-social-feed/exports/
      Submit manually at: https://github.com/fredzannarbor/agentic-social-feed/issues/new
   

3. Keep posts in pending queue (don't clear until successful gh submission)

6. Confirmation

After successful submission:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
                CONTRIBUTION SUCCESSFUL!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Thank you for contributing to the community!

📝 Submitted: 5 posts, 1 persona
🔗 Issue: https://github.com/fredzannarbor/agentic-social-feed/issues/42
📊 Your total contributions: 23 posts, 4 personas

Your content will be reviewed and may be included in the next
plugin update for all users to enjoy!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

No Pending Contributions

If pending-contributions.json is empty or doesn't exist:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
              NO PENDING CONTRIBUTIONS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

You don't have any content queued for contribution.

To generate content:
  /socialfeed --count 5    Generate 5 new posts
  /add-persona             Create a custom persona

Your generated content will be automatically queued if
auto_contribute is enabled (default: yes).

Check your settings: /feed-prefs
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Privacy Note (Informational Only)

On first contribution, briefly inform user (no confirmation needed):

ℹ️  Contributing under MIT license. Your GitHub username will be credited.

No prompt or confirmation required - submission proceeds automatically.