forkfeed-mcp 1.0.11 → 1.0.13

package/dist/guide-content.js

@@ -8,20 +8,22 @@ export const GUIDE_CONTENT = `
 
 Turn GitHub commits into swipeable card content. One fork per repo, one feed per commit, 8 cards per feed (35-62 variants total).
 
+**Important: process exactly ONE commit at a time, never multiple commits in a single run.**
+
 ## Quick start
 
-1. Ask which repo and commits to process
+1. Ask which single commit to process
 2. Fetch commit data via git or gh CLI
 3. Generate 8-card manifest JSON
 4. Call forkfeed_push with the manifest
 
 ---
 
-## Phase 1: Resolve repo and commits
+## Phase 1: Resolve repo and commit
 
 Use the **current working directory** as the repo. Do not ask which repo.
 
-If the user didn't specify commits, use the latest commit. Otherwise respect what they asked (last N, specific SHA, since date).
+Process exactly one commit per run. If the user didn't specify, use the latest commit. If they ask for multiple commits, process only the first and tell them to run again for the next.
 
 Use **IT Scenes** images. Call **forkfeed_images** to get the full catalog (200 scene images + 30 backgrounds). Match images to content by tags and semantic similarity. Do not ask about image style.
 
@@ -201,7 +203,7 @@ Always call **forkfeed_status** before generating content. It lists published fe
 
 - **New commit**: Generate only the new feed and cards. The fork's feedIds must include ALL existing feed IDs plus the new one. Missing old IDs causes them to be deleted.
 - **Existing commit**: Warn the user that this commit already has a feed. Only regenerate if they confirm. The old cards will be replaced.
-- **Multiple commits**: Generate one feed per commit. Include all feed IDs (old + new) in the fork's feedIds array.
+- **One commit per run**: Never process multiple commits at once. If the user wants more, they run the command again.
 
 ---
 

package/dist/index.js

@@ -9,6 +9,86 @@ import { GUIDE_CONTENT } from './guide-content.js';
 import { IMAGE_CATALOG } from './image-catalog.js';
 const APP_SERVER_URL = (process.env.APP_SERVER_URL || 'https://api.forkfeed.link').replace(/\/+$/, '');
 const TOKEN = process.env.FORKFEED_TOKEN || '';
+// ── Manifest schemas ──────────────────────────────────────────────────
+const forkSchema = z.object({
+    _id: z.string().min(1, 'Fork _id is required'),
+    title: z.string().min(1, 'Fork title is required'),
+    description: z.string(),
+    imageSrc: z.string(),
+    feedIds: z.array(z.string().min(1)).min(1, 'Fork must reference at least one feed'),
+    actionLabel: z.string().optional(),
+    actionUrl: z.string().optional(),
+}).passthrough();
+const feedSchema = z.object({
+    _id: z.string().min(1, 'Feed _id is required'),
+    title: z.string().min(1, 'Feed title is required').max(60, 'Feed title max 60 chars'),
+    description: z.string().optional(),
+    imageSrc: z.string(),
+    mode: z.string(),
+    scrollDirection: z.string(),
+    engagement: z.boolean().optional(),
+}).passthrough();
+const sizingEnum = z.enum(['automatic', 'wide', 'portrait', 'square', 'small_portrait']);
+const socialSourceEnum = z.enum(['x', 'linkedin', 'instagram', 'facebook', 'threads', 'bluesky']);
+const buttonActionEnum = z.enum(['url', 'fork', 'feed', 'user']);
+const quizOptionSchema = z.object({
+    label: z.string().min(1),
+    correct: z.boolean(),
+}).passthrough();
+const contentBlockSchema = z.discriminatedUnion('type', [
+    z.object({ type: z.literal('CONTENT_IMAGE'), imageSrc: z.string().min(1), sizing: sizingEnum }).passthrough(),
+    z.object({ type: z.literal('CONTENT_TITLE'), title: z.string().min(1) }).passthrough(),
+    z.object({ type: z.literal('CONTENT_TEXT'), text: z.string().min(1) }).passthrough(),
+    z.object({ type: z.literal('CONTENT_CODE'), code: z.string().min(1), language: z.string().optional() }).passthrough(),
+    z.object({ type: z.literal('CONTENT_SOCIAL'), name: z.string().min(1), avatarSrc: z.string(), source: socialSourceEnum }).passthrough(),
+    z.object({ type: z.literal('CONTENT_SUBTEXT'), text: z.string().min(1) }).passthrough(),
+    z.object({ type: z.literal('CONTENT_QUIZ'), question: z.string().min(1), options: z.array(quizOptionSchema).min(2), explanation: z.string().optional() }).passthrough(),
+    z.object({ type: z.literal('CONTENT_BUTTON'), label: z.string().min(1), action: buttonActionEnum, target: z.string().min(1) }).passthrough(),
+]);
+const variantSchema = z.discriminatedUnion('type', [
+    z.object({ type: z.literal('FULL_IMAGE'), imageSrc: z.string().min(1, 'FULL_IMAGE requires imageSrc'), title: z.string().optional(), subtitle: z.string().optional() }).passthrough(),
+    z.object({ type: z.literal('FULL_VIDEO'), videoSrc: z.string().min(1), title: z.string().optional() }).passthrough(),
+    z.object({ type: z.literal('CONTENT'), blocks: z.array(contentBlockSchema).min(1, 'CONTENT variant needs at least one block'), backgroundSrc: z.string().optional() }).passthrough(),
+]);
+const cardSchema = z.object({
+    _id: z.string().min(1, 'Card _id is required'),
+    feedId: z.string().min(1, 'Card feedId is required'),
+    order: z.number().int().min(0),
+    variants: z.array(variantSchema).min(2, 'Card needs at least 2 variants (cover + detail)'),
+}).passthrough();
+const manifestSchema = z.object({
+    forks: z.array(forkSchema).min(1, 'Manifest must have at least one fork'),
+    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) {
+    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))
+                errors.push(`Fork "${fork._id}" references feed "${fid}" which is not in feeds array`);
+        }
+    }
+    for (const card of manifest.cards) {
+        if (!feedIds.has(card.feedId))
+            errors.push(`Card "${card._id}" references feed "${card.feedId}" which is not in feeds array`);
+        for (let vi = 0; vi < card.variants.length; vi++) {
+            const v = card.variants[vi];
+            if (v.type !== 'CONTENT')
+                continue;
+            for (const block of v.blocks) {
+                if (block.type === 'CONTENT_QUIZ') {
+                    const hasCorrect = block.options.some((o) => o.correct === true);
+                    if (!hasCorrect)
+                        errors.push(`Card "${card._id}" variants[${vi}]: CONTENT_QUIZ must have at least one correct option`);
+                }
+            }
+        }
+    }
+    return errors.length > 0 ? errors.join('\n') : null;
+}
 // ── Helpers ────────────────────────────────────────────────────────────
 function authHeaders() {
     return {
@@ -67,6 +147,24 @@ server.tool('forkfeed_push', 'Push a generated manifest (forks, feeds, cards) to
             isError: true,
         };
     }
+    // Validate manifest structure before pushing
+    const parsed = manifestSchema.safeParse(manifest);
+    if (!parsed.success) {
+        const issues = parsed.error.issues
+            .map((i) => `  ${i.path.join('.')}: ${i.message}`)
+            .join('\n');
+        return {
+            content: [{ type: 'text', text: `Manifest validation failed:\n${issues}\n\nFix the issues above and try again.` }],
+            isError: true,
+        };
+    }
+    const crossErr = crossValidate(parsed.data);
+    if (crossErr) {
+        return {
+            content: [{ type: 'text', text: `Manifest cross-reference errors:\n${crossErr}\n\nFix the issues above and try again.` }],
+            isError: true,
+        };
+    }
     // Save manifest locally before uploading (best-effort, doesn't block push)
     const forkId = manifest.forks?.[0]?._id;
     const filename = `${forkId || `manifest-${Date.now()}`}.json`;
@@ -233,7 +331,7 @@ server.prompt('forkfeed', 'Turn GitHub commits into swipeable forkfeed content.
 2. Call **forkfeed_images** to get the IT Scenes image catalog (200 scenes + 30 backgrounds).
 3. Call **forkfeed_status** to check for existing content. Note which feeds (commits) are already published.
 4. Detect the current repo from the working directory. Use git to get commit data.
-5. Ask which commits to process (default: latest). Do NOT ask about image style (always use IT Scenes). Show a table of commits with a column indicating whether each already has a published feed (match the 7-char SHA from forkfeed_status feed IDs against the commit SHAs). If the user selects a commit that already has a feed, warn and ask for confirmation before regenerating.
+5. Ask which ONE commit to process (default: latest). Only one commit at a time, never more. Do NOT ask about image style (always use IT Scenes). Show a table of recent commits with a column indicating whether each already has a published feed (match the 7-char SHA from forkfeed_status feed IDs against the commit SHAs). If the user selects a commit that already has a feed, warn and ask for confirmation before regenerating.
 6. Fetch the diff, analyze it, and generate the 8-card manifest following the guide exactly. Include ALL existing feed IDs in the fork's feedIds array (see "Incremental updates" in the guide).
 7. Match images from the catalog to card content by tags and semantic similarity.
 8. Validate the manifest against the checklist in the guide.

package/package.json

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