forkfeed-mcp 1.3.3 → 1.3.5

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, 7 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 6 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 4 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 7 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
@@ -77,27 +77,21 @@ Only 5 fields + cards. Everything else is auto-populated.
 
 ---
 
-## The 8 cards
+## The 7 cards
 
-Each card = array of detail variants (cover is auto-generated). Provide 1+ variants per card.
+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.
 
 | # | Section | Detail variants | Block pattern | Tone |
 |---|---------|----------------|---------------|------|
-| 0 | Explain like I'm 5 | 3-6 | img -> title -> text | Playful, zero jargon |
-| 1 | The roast | 3-6 | img -> title -> text, optional subtext | Maximum cheekiness, swearing ok |
-| 2 | Commit message, decoded | 2-4 | social -> title -> text -> optional code | Escalating absurdity |
-| 3 | The LinkedIn post | 2-4 | social -> title -> text -> subtext | Peak LinkedIn parody |
-| 4 | Statistics | 3-5 | img -> title -> code | Deadpan data humor |
-| 5 | Learning moment | 3-8 | img -> title -> text -> optional code -> button(last) | Teach with personality |
-| 6 | Alternatives | 3-6 | img -> title -> text -> optional code | Constructive snark |
-| 7 | Quiz | 10-15 | 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)
+| 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 | The LinkedIn post | 2-3 | social -> title -> text | Peak LinkedIn parody |
+| 3 | Statistics | 2-3 | img -> title -> code | Deadpan data humor |
+| 4 | Learning moment | 2-3 | img -> title -> text -> optional code -> button(last) | Teach with personality |
+| 5 | Alternatives | 2-3 | img -> title -> text -> optional code | Constructive snark |
+| 6 | 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 +100,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 7 cards in the cards array (one per section above)
 - Use short image IDs from forkfeed_commits output (img47, not full URLs)
-- 12-20 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)
+- 8-12 unique scene images (img*) across the feed, no duplicate within same card
+- Cards 0-4: code must be REAL from the diff (never fabricated)
+- Card 5: synthesized code IS allowed
+- Card 6: no img blocks, quiz blocks only (with title per variant)
+- Card 4: 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,12 +218,11 @@ 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
+    ['bg9', 'bg3'], // 3: Stats
+    ['bg12', 'bg13', 'bg14', 'bg15', 'bg17'], // 4: Learning (tech-match)
+    ['bg25', 'bg30'], // 5: Alternatives
+    ['bg18', 'bg5'], // 6: Quiz
 ];
 // Map language tags to preferred Learning card (index 5) backgrounds
 const LANG_BG = {
@@ -235,8 +234,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 4 (Learning), reorder prefs based on detected language tags
+    const learningPrefs = [...BG_PREFS[4]];
     for (const tag of tags) {
         const preferred = LANG_BG[tag];
         if (preferred && learningPrefs.includes(preferred)) {
@@ -247,7 +246,7 @@ function assignBackgrounds(tags) {
         }
     }
     return BG_PREFS.map((prefs, i) => {
-        const candidates = i === 5 ? learningPrefs : prefs;
+        const candidates = i === 4 ? learningPrefs : prefs;
         const pick = candidates.find((bg) => !used.has(bg)) || candidates[0];
         used.add(pick);
         return pick;
@@ -286,7 +285,6 @@ 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" },
@@ -358,10 +356,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(7),
     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(7).optional().describe('Override auto-assigned background IDs'),
+    coverOverride: z.array(z.string()).length(7).optional().describe('Override cover image IDs (defaults to backgrounds)'),
 });
 // ── Manifest builder ─────────────────────────────────────────────────
 async function buildManifest(input) {
@@ -407,7 +405,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 = {
@@ -482,31 +480,32 @@ async function pushManifestToServer(manifest) {
             const url = `https://forkfeed.link/fork/${forkId}`;
             try {
                 const qr = await QRCode.toString(url, { type: 'utf8', errorCorrectionLevel: 'L' });
-                qrBlock = ['', 'Scan to open in forkfeed:', '', qr, url].join('\n');
+                qrBlock = ['', 'Scan to open in forkfeed:', '', qr].join('\n');
             }
             catch {
-                qrBlock = `\nLink: ${url}`;
+                qrBlock = '';
             }
         }
-        return {
-            content: [{
-                    type: 'text',
-                    text: [
-                        'Content pushed successfully!',
-                        '',
-                        `Uploaded: ${data.uploaded?.feeds || 0} feeds, ${data.uploaded?.cards || 0} cards`,
-                        '',
-                        'Forks:',
-                        forkSummary || '  (none)',
-                        '',
-                        saveError || `Manifest saved to ${filepath}`,
-                        '',
-                        'Your content is now live in the forkfeed app. It starts as private.',
-                        'To make it public, change visibility in the app (requires admin approval).',
-                        qrBlock,
-                    ].join('\n'),
-                }],
-        };
+        const blocks = [{
+                type: 'text',
+                text: [
+                    'Content pushed successfully!',
+                    '',
+                    `Uploaded: ${data.uploaded?.feeds || 0} feeds, ${data.uploaded?.cards || 0} cards`,
+                    '',
+                    'Forks:',
+                    forkSummary || '  (none)',
+                    '',
+                    saveError || `Manifest saved to ${filepath}`,
+                    '',
+                    'Your content is now live in the forkfeed app. It starts as private.',
+                    'To make it public, change visibility in the app (requires admin approval).',
+                ].join('\n'),
+            }];
+        if (qrBlock) {
+            blocks.push({ type: 'text', text: qrBlock });
+        }
+        return { content: blocks };
     }
     catch (err) {
         return {
@@ -647,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 7 cards with blocks'),
     push: z.boolean().optional().describe('Push immediately after building (default: true)'),
 }, async ({ content, push }) => {
     const shouldPush = push !== false;
@@ -743,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 7-card feeds, and pushes them live.', async () => ({
     messages: [
         {
             role: 'user',
@@ -754,8 +753,9 @@ 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 7 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.
 
 Start now.`,
             },

package/package.json

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