forkfeed-mcp 1.3.2 → 1.3.4

package/dist/guide-content.js

@@ -79,18 +79,18 @@ Only 5 fields + cards. Everything else is auto-populated.
 
 ## The 8 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 |
+| 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")
@@ -108,7 +108,7 @@ Each card = array of detail variants (cover is auto-generated). Provide 1+ varia
 
 - Exactly 8 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
+- 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)

package/dist/index.js

@@ -63,13 +63,14 @@ const manifestSchema = z.object({
     feeds: z.array(feedSchema).min(1, 'Manifest must have at least one feed'),
     cards: z.array(cardSchema).min(1, 'Manifest must have at least one card'),
 });
-/** Cross-reference checks that Zod can't express. Returns error string or null. */
-function crossValidate(manifest) {
+/** Cross-reference checks that Zod can't express. Returns error string or null.
+ *  knownFeedIds: feed IDs that exist server-side but aren't in this manifest (skip fork ref check for these). */
+function crossValidate(manifest, knownFeedIds) {
     const feedIds = new Set(manifest.feeds.map((f) => f._id));
     const errors = [];
     for (const fork of manifest.forks) {
         for (const fid of fork.feedIds) {
-            if (!feedIds.has(fid))
+            if (!feedIds.has(fid) && !knownFeedIds?.has(fid))
                 errors.push(`Fork "${fork._id}" references feed "${fid}" which is not in feeds array`);
         }
     }
@@ -437,7 +438,7 @@ async function buildManifest(input) {
             variants: [coverVariant, ...detailVariants],
         };
     });
-    return { forks: [fork], feeds: [feed], cards };
+    return { manifest: { forks: [fork], feeds: [feed], cards }, existingFeedIds };
 }
 async function pushManifestToServer(manifest) {
     if (!TOKEN) {
@@ -481,31 +482,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 {
@@ -652,8 +654,9 @@ server.tool('forkfeed_build', 'Build a forkfeed manifest from simplified content
     const shouldPush = push !== false;
     // Build the full manifest from simplified input
     let manifest;
+    let existingFeedIds;
     try {
-        manifest = await buildManifest(content);
+        ({ manifest, existingFeedIds } = await buildManifest(content));
     }
     catch (err) {
         return {
@@ -672,7 +675,7 @@ server.tool('forkfeed_build', 'Build a forkfeed manifest from simplified content
             isError: true,
         };
     }
-    const crossErr = crossValidate(parsed.data);
+    const crossErr = crossValidate(parsed.data, new Set(existingFeedIds));
     if (crossErr) {
         return {
             content: [{ type: 'text', text: `Built manifest cross-reference errors:\n${crossErr}` }],
@@ -754,6 +757,7 @@ server.prompt('forkfeed', 'Turn GitHub commits into swipeable forkfeed content.
 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.
 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.2",
+  "version": "1.3.4",
   "description": "MCP server for pushing GitHub commits to forkfeed",
   "type": "module",
   "bin": {