forkfeed-mcp 1.3.4 → 1.3.6

package/dist/guide-content.js

@@ -6,7 +6,7 @@
 export const GUIDE_CONTENT = `
 # Forkfeed Content Guide - "The Fuck I Pushed"
 
-Turn GitHub commits into swipeable card content. One fork per repo, one feed per commit, 8 cards per feed.
+Turn GitHub commits into swipeable card content. One fork per repo, one feed per commit, 6 cards per feed.
 
 **Process exactly ONE commit at a time, never multiple.**
 
@@ -54,16 +54,16 @@ Only 5 fields + cards. Everything else is auto-populated.
 | \`{ "text": "Paragraph..." }\` | CONTENT_TEXT | 50-200 words, use \\\\n\\\\n for breaks |
 | \`{ "code": "const x = 1", "lang": "typescript" }\` | CONTENT_CODE | Real code from diff, 5-20 lines, strip +/- prefixes |
 | \`{ "subtext": "Pro tip..." }\` | CONTENT_SUBTEXT | Aside or protip |
-| \`{ "name": "Chad", "subtitle": "10x Engineer", "avatar": "img98", "source": "linkedin" }\` | CONTENT_SOCIAL | Cards 2-3 only. avatar can be image ID or URL. source: x, linkedin, threads, etc. |
-| \`{ "question": "What does X do?", "options": [{"label": "A", "correct": false}, {"label": "B", "correct": true}], "explanation": "Because..." }\` | CONTENT_QUIZ | Card 7 only. 4 options recommended, min 2, one correct, always include explanation |
-| \`{ "label": "Google it", "action": "url", "target": "https://google.com/search?q=topic" }\` | CONTENT_BUTTON | Card 5 only, MUST be last block in every detail variant |
+| \`{ "name": "Chad", "subtitle": "10x Engineer", "avatar": "img98", "source": "linkedin" }\` | CONTENT_SOCIAL | Card 2 only. avatar can be image ID or URL. source: x, linkedin, threads, etc. |
+| \`{ "question": "What does X do?", "options": [{"label": "A", "correct": false}, {"label": "B", "correct": true}], "explanation": "Because..." }\` | CONTENT_QUIZ | Card 5 only. 4 options recommended, min 2, one correct, always include explanation |
+| \`{ "label": "Google it", "action": "url", "target": "https://google.com/search?q=topic" }\` | CONTENT_BUTTON | Card 3 only, MUST be last block in every detail variant |
 
 ### What the builder does automatically
 - Detects repo owner/name from git remote
 - Generates fork/feed IDs from convention (tfip-{owner}-{repo}-{sha})
 - Constructs GitHub action URL
 - Fetches existing feed IDs from server (for incremental updates)
-- Assigns 8 unique card backgrounds from preference table + commit tags
+- Assigns 6 unique card backgrounds from preference table + commit tags
 - Generates UUID v4 for each card ID
 - Resolves short image IDs (img47, bg10) to full CDN URLs
 - Adds FULL_IMAGE cover variant with fixed title/subtitle per card type
@@ -71,13 +71,13 @@ Only 5 fields + cards. Everything else is auto-populated.
 - Validates the assembled manifest before pushing
 
 ### Optional overrides
-- \`bgOverride\`: array of 8 background IDs to override auto-assignment
-- \`coverOverride\`: array of 8 cover image IDs (defaults to backgrounds)
+- \`bgOverride\`: array of 6 background IDs to override auto-assignment
+- \`coverOverride\`: array of 6 cover image IDs (defaults to backgrounds)
 - \`cwd\`: working directory if not process.cwd()
 
 ---
 
-## The 8 cards
+## The 6 cards
 
 Each card = array of detail variants (cover is auto-generated). Provide 1+ variants per card. Quality over quantity: pick only the most impactful, funny, or educational content.
 
@@ -85,19 +85,12 @@ Each card = array of detail variants (cover is auto-generated). Provide 1+ varia
 |---|---------|----------------|---------------|------|
 | 0 | Explain like I'm 5 | 2-3 | img -> title -> text | Playful, zero jargon |
 | 1 | The roast | 2-3 | img -> title -> text, optional subtext | Maximum cheekiness, swearing ok |
-| 2 | Commit message, decoded | 2-3 | social -> title -> text -> optional code | Escalating absurdity |
-| 3 | The LinkedIn post | 2-3 | social -> title -> text -> subtext | Peak LinkedIn parody |
-| 4 | Statistics | 2-3 | img -> title -> code | Deadpan data humor |
-| 5 | Learning moment | 2-3 | img -> title -> text -> optional code -> button(last) | Teach with personality |
-| 6 | Alternatives | 2-3 | img -> title -> text -> optional code | Constructive snark |
-| 7 | Quiz | 4-6 | title -> quiz (no img blocks) | Quiz show energy |
-
-### Card 2 personas (Decoded)
-- "What you meant" (source: "x" or "threads")
-- "Corporate speak" (source: "linkedin")
-- Optional: "Shakespearean" (source: "x"), "Military briefing" (source: "x")
-
-### Card 3 personas (LinkedIn)
+| 2 | The LinkedIn post | 2-3 | social -> title -> text | Peak LinkedIn parody |
+| 3 | Learning moment | 2-3 | img -> title -> text -> optional code -> button(last) | Teach with personality |
+| 4 | Alternatives | 2-3 | img -> title -> text -> optional code | Constructive snark |
+| 5 | Quiz | 4-6 | title -> quiz (no img blocks) | Quiz show energy |
+
+### Card 2 personas (LinkedIn)
 - Chad Gitpush: "10x Engineer | Building in Public | DMs Open"
 - Alexandra Middleware: "VP of Forward Thinking at TechCorp"
 - Dave 'Shipping' Johnson: "Just a humble engineer doing humble things"
@@ -106,14 +99,14 @@ Each card = array of detail variants (cover is auto-generated). Provide 1+ varia
 
 ## Key rules
 
-- Exactly 8 cards in the cards array (one per section above)
+- Exactly 6 cards in the cards array (one per section above)
 - Use short image IDs from forkfeed_commits output (img47, not full URLs)
 - 8-12 unique scene images (img*) across the feed, no duplicate within same card
-- Cards 0-5: code must be REAL from the diff (never fabricated)
-- Card 6: synthesized code IS allowed
-- Card 7: no img blocks, quiz blocks only (with title per variant)
-- Card 5: every detail variant MUST end with a button block
-- Cards 2-3: first block should be social (not img)
+- Cards 0-3: code must be REAL from the diff (never fabricated)
+- Card 4: synthesized code IS allowed
+- Card 5: no img blocks, quiz blocks only (with title per variant)
+- Card 3: every detail variant MUST end with a button block
+- Card 2: first block should be social (not img), no engagement metrics subtext (reactions, comments, reposts)
 - CONTENT_QUIZ: 4 options recommended (min 2), exactly one correct, always include explanation
 - No em dashes, smart quotes, or non-ASCII characters
 - Feed title max 60 chars

package/dist/index.js

@@ -218,14 +218,12 @@ function parseFilePathsFromStats(stats) {
 const BG_PREFS = [
     ['bg10', 'bg27'], // 0: ELI5
     ['bg11', 'bg1'], // 1: Roast
-    ['bg20', 'bg11'], // 2: Decoded
-    ['bg25', 'bg24'], // 3: LinkedIn
-    ['bg9', 'bg3'], // 4: Stats
-    ['bg12', 'bg13', 'bg14', 'bg15', 'bg17'], // 5: Learning (tech-match)
-    ['bg25', 'bg30'], // 6: Alternatives
-    ['bg18', 'bg5'], // 7: Quiz
+    ['bg25', 'bg24'], // 2: LinkedIn
+    ['bg12', 'bg13', 'bg14', 'bg15', 'bg17'], // 3: Learning (tech-match)
+    ['bg25', 'bg30'], // 4: Alternatives
+    ['bg18', 'bg5'], // 5: Quiz
 ];
-// Map language tags to preferred Learning card (index 5) backgrounds
+// Map language tags to preferred Learning card (index 3) backgrounds
 const LANG_BG = {
     javascript: 'bg12', typescript: 'bg12',
     python: 'bg13',
@@ -235,8 +233,8 @@ const LANG_BG = {
 };
 function assignBackgrounds(tags) {
     const used = new Set();
-    // For card 5 (Learning), reorder prefs based on detected language tags
-    const learningPrefs = [...BG_PREFS[5]];
+    // For card 3 (Learning), reorder prefs based on detected language tags
+    const learningPrefs = [...BG_PREFS[3]];
     for (const tag of tags) {
         const preferred = LANG_BG[tag];
         if (preferred && learningPrefs.includes(preferred)) {
@@ -247,7 +245,7 @@ function assignBackgrounds(tags) {
         }
     }
     return BG_PREFS.map((prefs, i) => {
-        const candidates = i === 5 ? learningPrefs : prefs;
+        const candidates = i === 3 ? learningPrefs : prefs;
         const pick = candidates.find((bg) => !used.has(bg)) || candidates[0];
         used.add(pick);
         return pick;
@@ -286,9 +284,7 @@ async function fetchStatusData() {
 const COVERS = [
     { title: "Explain Like I'm 5", subtitle: "Hopefully now you'll understand what you pushed" },
     { title: "The Roast", subtitle: "Your code had it coming" },
-    { title: "Commit Message, Decoded", subtitle: "What you wrote vs what you meant vs what actually happened" },
     { title: "The LinkedIn Post", subtitle: "Mass cringe, freshly generated" },
-    { title: "Statistics", subtitle: "The numbers don't lie, but they do judge" },
     { title: "Learning Moment", subtitle: "Something useful buried in your chaos" },
     { title: "Alternatives", subtitle: "What you could have done instead" },
     { title: "Quiz", subtitle: "Let's see if you even understand your own code" },
@@ -358,10 +354,10 @@ const buildInputSchema = z.object({
         variants: z.array(z.object({
             blocks: z.array(z.record(z.string(), z.unknown())).min(1),
         })).min(1),
-    })).length(8),
+    })).length(6),
     cwd: z.string().optional().describe('Working directory (defaults to process.cwd())'),
-    bgOverride: z.array(z.string()).length(8).optional().describe('Override auto-assigned background IDs'),
-    coverOverride: z.array(z.string()).length(8).optional().describe('Override cover image IDs (defaults to backgrounds)'),
+    bgOverride: z.array(z.string()).length(6).optional().describe('Override auto-assigned background IDs'),
+    coverOverride: z.array(z.string()).length(6).optional().describe('Override cover image IDs (defaults to backgrounds)'),
 });
 // ── Manifest builder ─────────────────────────────────────────────────
 async function buildManifest(input) {
@@ -407,7 +403,7 @@ async function buildManifest(input) {
         title: input.forkTitle,
         description: input.forkDescription,
         imageSrc: coverUrls[0],
-        feedIds: [...existingFeedIds, feedId],
+        feedIds: [feedId, ...existingFeedIds],
         ...(actionUrl ? { actionLabel: 'View on GitHub', actionUrl } : {}),
     };
     const feed = {
@@ -477,9 +473,11 @@ async function pushManifestToServer(manifest) {
         const forkSummary = data.forks
             ?.map((f) => `  - ${f.title} (${f.feeds} feeds)`)
             .join('\n');
+        // Use the real MongoDB ObjectId returned by the server, not the manifest slug
+        const realForkId = data.forks?.[0]?.forkId || forkId;
         let qrBlock = '';
-        if (forkId) {
-            const url = `https://forkfeed.link/fork/${forkId}`;
+        if (realForkId) {
+            const url = `https://forkfeed.link/fork/${realForkId}`;
             try {
                 const qr = await QRCode.toString(url, { type: 'utf8', errorCorrectionLevel: 'L' });
                 qrBlock = ['', 'Scan to open in forkfeed:', '', qr].join('\n');
@@ -648,7 +646,7 @@ server.tool('forkfeed_push', 'Push a generated manifest (forks, feeds, cards) to
 });
 // ── Tool: forkfeed_build ──────────────────────────────────────────────
 server.tool('forkfeed_build', 'Build a forkfeed manifest from simplified content and push it. Auto-detects repo info, assigns backgrounds, fetches existing feeds. Use this instead of forkfeed_push.', {
-    content: buildInputSchema.describe('Simplified content: sha, titles, descriptions, and 8 cards with blocks'),
+    content: buildInputSchema.describe('Simplified content: sha, titles, descriptions, and 6 cards with blocks'),
     push: z.boolean().optional().describe('Push immediately after building (default: true)'),
 }, async ({ content, push }) => {
     const shouldPush = push !== false;
@@ -744,7 +742,7 @@ server.tool('forkfeed_status', 'Check your current forkfeed content: which forks
     }
 });
 // ── Prompt: /forkfeed ──────────────────────────────────────────────────
-server.prompt('forkfeed', 'Turn GitHub commits into swipeable forkfeed content. Analyzes your repo, generates 8-card feeds, and pushes them live.', async () => ({
+server.prompt('forkfeed', 'Turn GitHub commits into swipeable forkfeed content. Analyzes your repo, generates 6-card feeds, and pushes them live.', async () => ({
     messages: [
         {
             role: 'user',
@@ -755,7 +753,7 @@ server.prompt('forkfeed', 'Turn GitHub commits into swipeable forkfeed content.
 1. Call **forkfeed_guide** and **forkfeed_commits()** in parallel (no arguments for commits = list mode).
 2. Show the commits table from forkfeed_commits. It already indicates which commits have published feeds. Ask which ONE commit to process. One commit at a time, never more. Do NOT ask about image style.
 3. Call **forkfeed_commits** with the selected commit SHA. This returns the diff, file stats, and suggested scene images. Do NOT run git commands yourself.
-4. Generate the simplified content JSON: sha, feedTitle, feedDescription, forkTitle, forkDescription, and 8 cards with blocks. Use short image IDs (img47) for inline images. Do NOT provide owner, repo, backgrounds, existingFeedIds, UUIDs, covers, or type wrappers. The builder auto-detects and generates all of that.
+4. Generate the simplified content JSON: sha, feedTitle, feedDescription, forkTitle, forkDescription, and 6 cards with blocks. Use short image IDs (img47) for inline images. Do NOT provide owner, repo, backgrounds, existingFeedIds, UUIDs, covers, or type wrappers. The builder auto-detects and generates all of that.
 5. Call **forkfeed_build** with the simplified content (push defaults to true).
 6. Display the QR code block from the push result exactly as returned, so the user can scan it.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forkfeed-mcp",
-  "version": "1.3.4",
+  "version": "1.3.6",
   "description": "MCP server for pushing GitHub commits to forkfeed",
   "type": "module",
   "bin": {