forkfeed-mcp 1.0.12 → 1.0.13

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`;

package/package.json

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