diff --git a/BACKLOG.md b/BACKLOG.md index 763a706..7ada820 100644 --- a/BACKLOG.md +++ b/BACKLOG.md @@ -88,6 +88,7 @@ Dreams we'd love to make real when the stars align. | # | Task | Why It's Amazing | What We Need | |---|------|------------------|--------------| | 96 | Gemma 4 Self-Hosted LLM | Zero API costs, frontier AI for Trinity Codex, data never leaves TX1 | Time to test on TX1, validate t/s speed | +| 97 | Trinity Console Social Hub | Unified social media management (Buffer + Meta) in one dashboard | Buffer API + Meta Graph API integration, Arbiter normalizer middleware | **Task #96 Details:** - **What:** Deploy Gemma 4 26B A4B (MoE) on TX1 via Ollama @@ -97,6 +98,15 @@ Dreams we'd love to make real when the stars align. - **Commands:** `ollama pull gemma4:26b-a4b-q8_0` (~26GB) - **Consultation:** `docs/consultations/gemini-gemma4-selfhosting-2026-04-06.md` +**Task #97 Details:** +- **What:** Social Hub module for Trinity Console — unified view of all scheduled posts +- **Why:** Single dashboard instead of switching between Buffer and Meta Business Suite +- **APIs:** Buffer API (Bluesky, X, TikTok) + Meta Graph API (Facebook, Instagram) +- **Architecture:** Arbiter middleware normalizer, read-only MVP first +- **Reality Check:** Gemini recommends DEAD LAST priority — don't build until RV lifestyle stable +- **Alternative:** Zapier/Make.com for Meta integration to offload maintenance +- **Consultation:** `docs/consultations/gemini-social-hub-2026-04-07.md` + --- ## ✅ RECENTLY COMPLETED diff --git a/docs/consultations/gemini-social-hub-2026-04-07.md b/docs/consultations/gemini-social-hub-2026-04-07.md new file mode 100644 index 0000000..43e4780 --- /dev/null +++ b/docs/consultations/gemini-social-hub-2026-04-07.md @@ -0,0 +1,123 @@ +# Gemini Consultation: Trinity Console Social Hub Module + +## Context + +You helped architect Trinity Console 2.0 — our unified admin dashboard for Firefrost Gaming. The 1,776-line implementation guide covers server management, subscriber management, financials, and more. + +Now we're exploring adding a **Social Hub** module to unify social media management inside the console. + +## Current State + +**Platforms we post to:** +- Bluesky +- X (Twitter) +- TikTok +- Facebook +- Instagram + +**Current workflow:** Manual scheduling via Buffer (for Bluesky/X/TikTok) and Meta Business Suite (for Facebook/Instagram). Switching between apps. + +## APIs Available + +**Buffer API (Beta):** +- GraphQL endpoint: `https://api.buffer.com` +- Simple Bearer token auth +- Supports: Post creation/deletion/retrieval, Idea creation, Channel retrieval +- Does NOT support: Analytics +- Covers: Bluesky, X, TikTok +- Does NOT cover: Facebook, Instagram + +**Meta Graph API:** +- REST/GraphQL endpoints +- OAuth 2.0 + Facebook App Review process (can take weeks) +- Supports: Post scheduling/publishing, analytics, comments +- Covers: Facebook, Instagram (Business accounts only) +- Complexity: High (token management, App Review, etc.) + +## The Idea + +Add a "Social Hub" module to Trinity Console that: +1. Shows all scheduled posts across all 5 platforms in one view +2. Allows creating/scheduling new posts +3. Shows platform connection status +4. Eventually could show analytics (when Buffer adds it / via Meta API) + +## Architecture Question + +We'd need two integrations: +- Buffer API → Bluesky, X, TikTok +- Meta Graph API → Facebook, Instagram + +## Questions for You + +1. **Is this worth the complexity?** Two different APIs with different auth models, just to avoid switching between Buffer and Meta Business Suite? + +2. **Architecture approach:** Should the console talk directly to both APIs, or should we build a middleware layer (maybe in Arbiter?) that normalizes them into one unified social API? + +3. **Meta API pain:** Given the App Review process and token management overhead, is there a simpler path for FB/IG? Or do we just accept the one-time setup pain? + +4. **Priority:** Where does this fit against our other HIGH priority tasks? + - Task #26: ModpackChecker (commercial product) + - Task #93: Trinity Codex (RAG system) + - Task #94: Global Restart Scheduler + - Trinity Console 2.0 itself + +5. **MVP scope:** What's the minimum viable Social Hub? Read-only scheduled post viewer? Or does it need post creation to be useful? + +6. **Alternative:** Should we just embed Buffer's UI in an iframe and call it done? Less elegant but way less work. + +## Your Thoughts? + +Looking for your architectural wisdom on whether this is worth pursuing and, if so, the cleanest path forward. + +--- + +## Gemini's Response (April 7, 2026) + +### 1. Is it worth the complexity? + +**Short Answer: No. Not right now.** + +The Reality Check: You are proposing building a bespoke social media management tool (which is an entire SaaS category on its own) just to save Michael a few tabs of context switching. The Meta Graph API is notoriously brittle, requiring constant maintenance for token renewals and adapting to their frequent, often unannounced, endpoint changes. Integrating both Buffer and Meta into a unified interface will become a massive time sink. + +### 2. Architecture Approach (If you must build it) + +If you decide to proceed eventually, do not let the frontend console talk directly to these APIs. + +You must build a normalizer in your Arbiter middleware. Your console frontend should make a single call (e.g., `GET /api/arbiter/social/schedule`) and the Arbiter backend handles the messy logic of fetching from Buffer, fetching from Meta, standardizing the JSON structures into a unified format, and returning it to the console. This protects your frontend from breaking every time Meta changes a rule. + +### 3. Meta API Pain & Alternatives + +The Meta App Review process is painful, but the ongoing token management is worse. + +**The Alternative:** Many tools like Zapier or Make.com already have robust, maintained Meta integrations. You could theoretically build a system where the Trinity Console sends a webhook payload to Make.com, which then handles the Meta API formatting and posting. This offloads the maintenance burden entirely. + +### 4. Priority Alignment + +**This project ranks DEAD LAST against your current priorities.** + +1. **Task #26: ModpackChecker** — Commercial product generating revenue. Absolute highest priority. +2. **Task #93: Trinity Codex** — Essential for onboarding and support scaling. +3. **Task #94: Global Restart Scheduler** — Core infrastructure stability. +4. **Trinity Console 2.0** — Foundational admin tool. +5. **Social Hub** — A "nice to have" convenience feature. + +### 5. The MVP & The Alternative (The "RV-Ready" Path) + +Your alternative idea is the winner. + +**The MVP (Phase 1):** Build a read-only view. The easiest way to achieve this is via an iframe or simple embedded widgets if Buffer provides them. However, if you want a true "unified view," focus strictly on building a calendar UI that pulls scheduled data via the APIs but does not handle creation. Creation logic (handling image uploads, character limits per platform, thread creation) is where 90% of the complexity lies. + +**The "RV-Ready" Recommendation:** + +Do not build this module. You are a solo developer preparing for an RV lifestyle. You cannot afford to maintain a custom social media scheduler when robust, commercial tools exist. Stick to your current workflow: use Buffer and Meta Business Suite natively. Focus your development energy on projects that directly generate revenue (ModpackChecker) or stabilize your infrastructure (Restart Scheduler). + +--- + +## Decision + +**PARKED** — Added to Wish List as Task #97. Will revisit only after all HIGH/MEDIUM priorities are complete and RV lifestyle is stable. + +--- + +*Firefrost Gaming — Fire + Frost + Foundation*