mcplane 0.4.0 → 0.5.0

package/dist/video.js

@@ -0,0 +1,190 @@
+/**
+ * Recorded scenes to one mp4 with ffmpeg: a title card, then each scene at real
+ * speed with its caption burned in. A DevTools screencast only sends a frame when
+ * something on screen changes, so each frame is held until the next one arrives
+ * (ffmpeg's concat demuxer with a duration per frame).
+ */
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { writeFile } from 'node:fs/promises';
+import { delimiter, join, resolve } from 'node:path';
+const FPS = 30;
+const DARK = '0x16181d';
+const TITLE_SECONDS = 3;
+const FONTS = ['/System/Library/Fonts/SFNS.ttf', '/System/Library/Fonts/Helvetica.ttc', '/Library/Fonts/Arial Unicode.ttf'];
+/** ffmpeg's concat-demuxer list: each frame held until the next one, the last until `end`. */
+export function concatList(frames, end) {
+    if (!frames.length)
+        throw new Error('No frames were recorded for this scene.');
+    const sorted = [...frames].sort((a, b) => a.ts - b.ts);
+    const entry = (f) => `file '${f.file.replace(/'/g, "'\\''")}'`;
+    const lines = [];
+    sorted.forEach((f, i) => {
+        const until = i + 1 < sorted.length ? sorted[i + 1].ts : Math.max(end, f.ts + 1 / FPS);
+        lines.push(entry(f), `duration ${Math.max(0.001, until - f.ts).toFixed(3)}`);
+    });
+    // The demuxer ignores the last entry's duration, so the last frame is listed once more.
+    lines.push(entry(sorted[sorted.length - 1]));
+    return `${lines.join('\n')}\n`;
+}
+/** How long a scene runs once assembled. */
+export function sceneSeconds(s) {
+    if (!s.frames.length)
+        return 0;
+    return Math.max(s.end, Math.max(...s.frames.map((f) => f.ts))) - Math.min(...s.frames.map((f) => f.ts));
+}
+/**
+ * Escapes a value for a filter option inside an ffmpeg filtergraph. Two levels:
+ * the option value (\ ' :) and then the filtergraph itself (\ ' [ ] , ;).
+ */
+export function ffEscape(value) {
+    const option = value.replace(/[\\':]/g, (c) => `\\${c}`);
+    return option.replace(/[\\'[\],;]/g, (c) => `\\${c}`);
+}
+/**
+ * A caption as at most `maxLines` lines of about `width` characters. Control
+ * characters become spaces (drawtext would draw them as boxes); anything that
+ * doesn't fit ends in an ellipsis.
+ */
+export function wrapCaption(text, width = 64, maxLines = 2) {
+    const words = text.replace(/[\u0000-\u001f\u007f]+/g, ' ').trim().split(/\s+/).filter(Boolean);
+    const lines = [];
+    for (const w of words) {
+        const last = lines[lines.length - 1];
+        if (last !== undefined && `${last} ${w}`.length <= width)
+            lines[lines.length - 1] = `${last} ${w}`;
+        else
+            lines.push(w);
+    }
+    if (lines.length <= maxLines)
+        return lines;
+    const kept = lines.slice(0, maxLines);
+    let tail = kept[maxLines - 1];
+    while (tail.length > width - 1 && tail.includes(' '))
+        tail = tail.slice(0, tail.lastIndexOf(' '));
+    kept[maxLines - 1] = `${tail.replace(/[\s,;:.]+$/, '')}…`;
+    return kept;
+}
+/** Width and height from a JPEG's start-of-frame marker. */
+export function jpegSize(b) {
+    if (b.length < 4 || b[0] !== 0xff || b[1] !== 0xd8)
+        return null;
+    let i = 2;
+    while (i + 8 < b.length) {
+        if (b[i] !== 0xff) {
+            i++;
+            continue;
+        }
+        const marker = b[i + 1];
+        if (marker === 0xff) {
+            i++;
+            continue;
+        }
+        if (marker === 0x01 || (marker >= 0xd0 && marker <= 0xd8)) {
+            i += 2;
+            continue;
+        }
+        if (marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc) {
+            return { height: (b[i + 5] << 8) | b[i + 6], width: (b[i + 7] << 8) | b[i + 8] };
+        }
+        i += 2 + ((b[i + 2] << 8) | b[i + 3]);
+    }
+    return null;
+}
+/** Even dimensions (H.264 needs them) within the maximum, keeping the aspect ratio. */
+export function outputSize(width, height, maxWidth = 1920, maxHeight = 1200) {
+    const s = Math.min(1, maxWidth / width, maxHeight / height);
+    const even = (n) => Math.max(2, Math.floor((n * s) / 2) * 2);
+    return { width: even(width), height: even(height) };
+}
+export function findFfmpeg(path = process.env.PATH ?? '') {
+    for (const dir of [...path.split(delimiter), '/opt/homebrew/bin', '/usr/local/bin']) {
+        if (dir && existsSync(join(dir, 'ffmpeg')))
+            return join(dir, 'ffmpeg');
+    }
+    return null;
+}
+/** A drawtext filter reading its text from a file, so no caption needs filtergraph escaping. */
+function drawtext(o) {
+    return [`drawtext=fontfile=${ffEscape(o.font)}`, `textfile=${ffEscape(o.textfile)}`, 'expansion=none', `fontsize=${o.size}`, `fontcolor=${o.color}`, 'x=(w-tw)/2', `y=${o.y}`].join(':');
+}
+/** Text colours that read on a background, given as 0xRRGGBB: light on dark, dark on light. */
+export function inkFor(bg) {
+    const n = parseInt(bg.replace(/^(0x|#)/, ''), 16);
+    const [r, g, b] = [(n >> 16) & 255, (n >> 8) & 255, n & 255];
+    const light = 0.2126 * r + 0.7152 * g + 0.0722 * b > 140;
+    return light ? { text: '0x1d1d1f', muted: '0x5f6673' } : { text: 'white', muted: '0x9aa3b2' };
+}
+/** The app's background colour, from a frame's bottom-left corner, so the borders and caption band blend in. */
+function sampleBackground(ffmpeg, file, cwd) {
+    return new Promise((done) => {
+        const p = spawn(ffmpeg, ['-v', 'error', '-i', file, '-vf', 'format=rgb24,crop=1:1:4:ih-5', '-frames:v', '1', '-f', 'rawvideo', 'pipe:1'], { cwd, stdio: ['ignore', 'pipe', 'ignore'] });
+        const chunks = [];
+        p.stdout.on('data', (d) => chunks.push(d));
+        p.on('error', () => done(null));
+        p.on('close', (code) => {
+            const px = Buffer.concat(chunks);
+            done(code === 0 && px.length >= 3 ? `0x${[px[0], px[1], px[2]].map((v) => v.toString(16).padStart(2, '0')).join('')}` : null);
+        });
+    });
+}
+function run(cmd, args, cwd) {
+    return new Promise((done, fail) => {
+        const p = spawn(cmd, args, { cwd, stdio: ['ignore', 'ignore', 'pipe'] });
+        let err = '';
+        p.stderr.on('data', (d) => (err += d));
+        p.on('error', fail);
+        p.on('close', (code) => (code === 0 ? done() : fail(new Error(`ffmpeg failed: ${err.trim().split('\n').slice(-3).join(' ')}`))));
+    });
+}
+/**
+ * Builds the video in `work` (where the frames are) and writes it to `out`.
+ * Every part is encoded the same way so they join without re-encoding.
+ */
+export async function buildVideo(o) {
+    const { width: W, height: H } = o.size;
+    const k = H / 1200;
+    const font = FONTS.find((f) => existsSync(f));
+    if (!font)
+        throw new Error(`No font for captions; looked for ${FONTS.join(', ')}`);
+    const enc = ['-an', '-c:v', 'libx264', '-preset', 'medium', '-crf', '18', '-pix_fmt', 'yuv420p', '-r', String(FPS), '-video_track_timescale', '15360'];
+    const parts = [];
+    const first = o.scenes.find((s) => s.frames.length)?.frames[0];
+    const bg = (first && (await sampleBackground(o.ffmpeg, first.file, o.work))) ?? DARK;
+    const ink = inkFor(bg);
+    // Title card: the name large, one line of what it does underneath.
+    await writeFile(join(o.work, 'title.txt'), o.title);
+    const sub = o.subtitle ? wrapCaption(o.subtitle, 70) : [];
+    for (const [i, line] of sub.entries())
+        await writeFile(join(o.work, `title-${i}.txt`), line);
+    const titleSize = Math.round(76 * k);
+    const subSize = Math.round(38 * k);
+    const titleY = sub.length ? `(h/2)-th-${Math.round(24 * k)}` : '(h-th)/2';
+    const titleFilters = [
+        drawtext({ textfile: 'title.txt', font, size: titleSize, color: ink.text, y: titleY }),
+        ...sub.map((_, i) => drawtext({ textfile: `title-${i}.txt`, font, size: subSize, color: ink.muted, y: `(h/2)+${Math.round((24 + i * 54) * k)}` })),
+        'format=yuv420p',
+    ];
+    await run(o.ffmpeg, ['-y', '-v', 'error', '-f', 'lavfi', '-i', `color=c=${bg}:s=${W}x${H}:r=${FPS}:d=${TITLE_SECONDS}`, '-vf', titleFilters.join(','), ...enc, 'part-title.mp4'], o.work);
+    parts.push('part-title.mp4');
+    // Scenes: the window at real speed above a band that holds the caption, so it never covers the app.
+    const band = Math.round((136 * k) / 2) * 2;
+    const capSize = Math.round(38 * k);
+    const lineH = Math.round(50 * k);
+    for (const [i, s] of o.scenes.entries()) {
+        await writeFile(join(o.work, `scene-${i}.txt`), concatList(s.frames, s.end));
+        const lines = wrapCaption(s.caption, 80);
+        const filters = [`scale=${W}:${H - band}:force_original_aspect_ratio=decrease:flags=lanczos`, `pad=${W}:${H}:(ow-iw)/2:0:color=${bg}`, `fps=${FPS}`];
+        const top = H - band + Math.round((band - lines.length * lineH) / 2);
+        for (const [j, line] of lines.entries()) {
+            await writeFile(join(o.work, `caption-${i}-${j}.txt`), line);
+            filters.push(drawtext({ textfile: `caption-${i}-${j}.txt`, font, size: capSize, color: ink.text, y: `${top + j * lineH}+(${lineH}-th)/2` }));
+        }
+        filters.push('format=yuv420p');
+        await run(o.ffmpeg, ['-y', '-v', 'error', '-f', 'concat', '-safe', '0', '-i', `scene-${i}.txt`, '-vf', filters.join(','), ...enc, `part-${i}.mp4`], o.work);
+        parts.push(`part-${i}.mp4`);
+    }
+    await writeFile(join(o.work, 'parts.txt'), parts.map((p) => `file '${p}'`).join('\n') + '\n');
+    await run(o.ffmpeg, ['-y', '-v', 'error', '-f', 'concat', '-safe', '0', '-i', 'parts.txt', '-c', 'copy', '-movflags', '+faststart', resolve(o.out)], o.work);
+    return TITLE_SECONDS + o.scenes.reduce((n, s) => n + sceneSeconds(s), 0);
+}

package/dist/zip.d.ts

@@ -1,4 +1,18 @@
-export declare function zip(files: {
+/** 1980-01-01 00:00 in DOS format: (year - 1980) << 9 | month << 5 | day. */
+export declare const DOS_DATE: number;
+export interface ZipEntry {
     path: string;
     data: Uint8Array | string;
-}[]): Uint8Array;
+    /** Unix permission bits; 0o644 unless given. Use 0o755 for scripts. */
+    mode?: number;
+}
+export declare function zip(files: ZipEntry[]): Uint8Array;
+export interface UnzippedEntry {
+    path: string;
+    data: Uint8Array;
+    /** Unix permission bits, when the archive was made on Unix. */
+    mode: number | null;
+    dosDate: number;
+}
+/** Reads every entry from the central directory, inflating and checking each CRC. */
+export declare function unzip(buf: Uint8Array): UnzippedEntry[];

package/dist/zip.js

@@ -1,8 +1,13 @@
 /**
  * A minimal ZIP writer (deflate, no dependencies): enough to build the plugin
- * package ChatGPT's submission portal takes.
+ * package ChatGPT's submission portal takes, and a reader to check it.
+ *
+ * Every entry is dated 1980-01-01 00:00, the first valid DOS date (an all-zero
+ * date has month 0, which some readers reject), so the same files always give
+ * the same bytes. Entries carry Unix modes, so a script marked executable stays
+ * executable when the package is unpacked.
  */
-import { deflateRawSync } from 'node:zlib';
+import { deflateRawSync, inflateRawSync } from 'node:zlib';
 const CRC = (() => {
     const t = new Uint32Array(256);
     for (let n = 0; n < 256; n++) {
@@ -19,6 +24,13 @@ function crc32(buf) {
         c = CRC[(c ^ b) & 0xff] ^ (c >>> 8);
     return (c ^ 0xffffffff) >>> 0;
 }
+/** 1980-01-01 00:00 in DOS format: (year - 1980) << 9 | month << 5 | day. */
+export const DOS_DATE = (0 << 9) | (1 << 5) | 1;
+const DOS_TIME = 0;
+const UTF8 = 0x0800;
+/** "Version made by": Unix (3), ZIP 2.0, so readers apply the modes in the external attributes. */
+const MADE_BY_UNIX = (3 << 8) | 20;
+const REGULAR_FILE = 0o100000;
 export function zip(files) {
     const enc = new TextEncoder();
     const locals = [];
@@ -33,8 +45,10 @@ export function zip(files) {
         const lv = new DataView(local.buffer);
         lv.setUint32(0, 0x04034b50, true);
         lv.setUint16(4, 20, true);
-        lv.setUint16(6, 0x0800, true); // UTF-8 names
+        lv.setUint16(6, UTF8, true);
         lv.setUint16(8, 8, true); // deflate
+        lv.setUint16(10, DOS_TIME, true);
+        lv.setUint16(12, DOS_DATE, true);
         lv.setUint32(14, crc, true);
         lv.setUint32(18, body.length, true);
         lv.setUint32(22, raw.length, true);
@@ -43,14 +57,17 @@ export function zip(files) {
         const cen = new Uint8Array(46 + name.length);
         const cv = new DataView(cen.buffer);
         cv.setUint32(0, 0x02014b50, true);
-        cv.setUint16(4, 20, true);
+        cv.setUint16(4, MADE_BY_UNIX, true);
         cv.setUint16(6, 20, true);
-        cv.setUint16(8, 0x0800, true);
+        cv.setUint16(8, UTF8, true);
         cv.setUint16(10, 8, true);
+        cv.setUint16(12, DOS_TIME, true);
+        cv.setUint16(14, DOS_DATE, true);
         cv.setUint32(16, crc, true);
         cv.setUint32(20, body.length, true);
         cv.setUint32(24, raw.length, true);
         cv.setUint16(28, name.length, true);
+        cv.setUint32(38, ((REGULAR_FILE | ((f.mode ?? 0o644) & 0o777)) << 16) >>> 0, true);
         cv.setUint32(42, offset, true);
         cen.set(name, 46);
         locals.push(local, body);
@@ -73,3 +90,46 @@ export function zip(files) {
     }
     return out;
 }
+/** Reads every entry from the central directory, inflating and checking each CRC. */
+export function unzip(buf) {
+    const v = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    let eocd = -1;
+    for (let i = buf.length - 22; i >= Math.max(0, buf.length - 65_557); i--) {
+        if (v.getUint32(i, true) === 0x06054b50) {
+            eocd = i;
+            break;
+        }
+    }
+    if (eocd < 0)
+        throw new Error('not a ZIP: no end of central directory');
+    const count = v.getUint16(eocd + 10, true);
+    let p = v.getUint32(eocd + 16, true);
+    const dec = new TextDecoder();
+    const out = [];
+    for (let i = 0; i < count; i++) {
+        if (v.getUint32(p, true) !== 0x02014b50)
+            throw new Error(`bad central directory entry ${i}`);
+        const madeBy = v.getUint16(p + 4, true);
+        const method = v.getUint16(p + 10, true);
+        const dosDate = v.getUint16(p + 14, true);
+        const crc = v.getUint32(p + 16, true);
+        const csize = v.getUint32(p + 20, true);
+        const usize = v.getUint32(p + 24, true);
+        const nlen = v.getUint16(p + 28, true);
+        const xlen = v.getUint16(p + 30, true);
+        const clen = v.getUint16(p + 32, true);
+        const attrs = v.getUint32(p + 38, true);
+        const at = v.getUint32(p + 42, true);
+        const path = dec.decode(buf.subarray(p + 46, p + 46 + nlen));
+        const start = at + 30 + v.getUint16(at + 26, true) + v.getUint16(at + 28, true);
+        const body = buf.subarray(start, start + csize);
+        const data = method === 8 ? new Uint8Array(inflateRawSync(body)) : method === 0 ? body.slice() : null;
+        if (!data)
+            throw new Error(`${path}: unsupported compression method ${method}`);
+        if (data.length !== usize || crc32(data) !== crc)
+            throw new Error(`${path}: CRC or size mismatch`);
+        out.push({ path, data, mode: madeBy >> 8 === 3 ? (attrs >>> 16) & 0o777 : null, dosDate });
+        p += 46 + nlen + xlen + clen;
+    }
+    return out;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcplane",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "fastlane for MCP servers: preflight against every store's rejection causes, publish where you can, prepare the rest, track every review.",
   "type": "module",
   "bin": {
@@ -8,8 +8,10 @@
   },
   "files": [
     "dist",
+    "schemas",
     "schema.json",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "engines": {
@@ -41,6 +43,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.31.0",
+    "ajv": "^8.17.1",
     "zod": "^4.6.5"
   },
   "repository": {

package/schema.json

@@ -26,7 +26,8 @@
         "cline",
         "lobehub",
         "awesome-mcp-servers",
-        "awesome-remote-mcp-servers"
+        "awesome-remote-mcp-servers",
+        "vercel-connect"
       ]
     },
     "url": {
@@ -80,6 +81,13 @@
             "none",
             "oauth"
           ]
+        },
+        "signIn": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/url"
+          },
+          "description": "Sign-in pages and identity-provider URLs your consent screen sends people to. Preflight GETs them, with the authorization endpoint, to find bot challenges and 403s reviewers would hit."
         }
       }
     },
@@ -124,8 +132,8 @@
       }
     },
     "icon": {
-      "$ref": "#/$defs/url",
-      "description": "A direct link to a square PNG, 512px or larger. Not a page, not a favicon."
+      "type": "string",
+      "description": "A direct link to a square PNG, 512px or larger. Not a page, not a favicon. The ChatGPT package also takes a local path, relative to mcplane.json; other stores need the link."
     },
     "prompts": {
       "type": "array",
@@ -200,22 +208,20 @@
     },
     "justifications": {
       "type": "object",
-      "description": "Your own ChatGPT hint justifications per tool name. They replace mcplane's drafts. 200 characters each.",
+      "deprecated": true,
+      "description": "Deprecated: OpenAI no longer asks for hint justifications. Still accepted; the ChatGPT pack lists them as optional notes for an appeal if review flags a hint.",
       "additionalProperties": {
         "type": "object",
         "additionalProperties": false,
         "properties": {
           "readOnly": {
-            "type": "string",
-            "maxLength": 200
+            "type": "string"
           },
           "openWorld": {
-            "type": "string",
-            "maxLength": 200
+            "type": "string"
           },
           "destructive": {
-            "type": "string",
-            "maxLength": 200
+            "type": "string"
           }
         }
       }
@@ -266,6 +272,54 @@
         }
       }
     },
+    "vercelConnect": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Vercel Connect's Submit a Service fields with no shared equivalent.",
+      "properties": {
+        "apiBase": {
+          "$ref": "#/$defs/url",
+          "description": "Base URL of a REST API your users also call, listed as a second target."
+        },
+        "scopes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Default scopes for the OAuth method. Defaults to the discovery document's scopes_supported."
+        },
+        "apiKey": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Offer an API key connection method.",
+          "properties": {
+            "docs": {
+              "$ref": "#/$defs/url",
+              "description": "Where users create a key."
+            },
+            "header": {
+              "type": "string",
+              "description": "How the key is sent, e.g. \"x-api-key: <key>\". Defaults to Authorization: Bearer <key>."
+            }
+          }
+        }
+      }
+    },
+    "claudePlugin": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "The Claude Code plugin that ships this server, for \"mcplane pack claude-eval\". Read from the plugin repo when left out.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The plugin's name in its plugin.json."
+        },
+        "server": {
+          "type": "string",
+          "description": "The server's key in the plugin's .mcp.json (or plugin.json mcpServers)."
+        }
+      }
+    },
     "lanes": {
       "type": "object",
       "description": "Named workflows run with \"mcplane <lane>\". Each step is a command without \"mcplane\"; prefix \"?\" for optional, \"handoff:\" for a step only a person can do.",
@@ -339,11 +393,31 @@
           "description": "#RRGGBB with 2:1 contrast against #212121.",
           "pattern": "^#[0-9a-fA-F]{6}$"
         },
+        "logo": {
+          "type": "string",
+          "description": "The package's logo: an image URL or a local path relative to mcplane.json. Defaults to icon."
+        },
         "composerIcon": {
-          "$ref": "#/$defs/url"
+          "type": "string",
+          "description": "An image URL or a local path. Defaults to the logo."
         },
         "logoDark": {
-          "$ref": "#/$defs/url"
+          "type": "string",
+          "description": "An image URL or a local path, for dark mode."
+        },
+        "skills": {
+          "description": "Agent Skills to bundle under skills/ in the package: a folder whose subfolders each hold a SKILL.md, or a list of skill folders. Relative to mcplane.json.",
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ]
         },
         "demoVideo": {
           "$ref": "#/$defs/url",