mcplane 0.4.1 → 0.5.0

package/dist/core.js

@@ -2,10 +2,15 @@
  * mcplane's checks for any runtime with fetch (Workers, Deno, browsers' servers).
  * Import from "mcplane/core".
  */
+import { ardChecks } from './checks/ard.js';
 import { authChecks } from './checks/auth.js';
+import { chainChecks } from './checks/chain.js';
 import { listingChecks, repoChecks } from './checks/listing.js';
+import { discover } from './checks/oauth.js';
+import { readinessChecks } from './checks/readiness.js';
 import { serverChecks } from './checks/server.js';
 import { toolChecks } from './checks/tools.js';
+import { VERCEL_REMINDERS, vercelChecks } from './checks/vercel.js';
 import { storesOf } from './draft.js';
 /** Things no script can see, which have still cost real submissions. */
 function reminders(m, stores) {
@@ -18,9 +23,9 @@ function reminders(m, stores) {
         r.push('If a tool writes somewhere public (posts, sends, publishes), give reviewers a safe target: a sandbox account or a "playground" option that validates and then discards. Reviewers test writes; they shouldn’t post to a real timeline.');
     }
     if (stores.includes('chatgpt')) {
-        r.push('ChatGPT needs a demo video recorded in developer mode that shows the tools your test cases use. Re-record it whenever tools change.');
+        r.push('ChatGPT needs a demo video recorded in developer mode that shows the tools your test cases use. Re-record it whenever tools change ("mcplane demo" records it on a Mac with ChatGPT desktop).');
         r.push('After "Submit for Review" the ChatGPT portal shows nothing for about 20 seconds. Confirm the status on the plugins list, not the button.');
-        r.push('Tool-annotation justifications are cut at 200 characters without warning.');
+        r.push('OpenAI no longer asks for hint justifications: its automated review checks each tool’s hints. If it flags one you believe is right, appeal with an explanation.');
         r.push('ChatGPT allows one version in review at a time. To change a submission, Cancel Review and resubmit the same draft.');
     }
     if (stores.includes('claude-connectors') || stores.includes('claude-plugins')) {
@@ -30,6 +35,8 @@ function reminders(m, stores) {
             r.push('Run "claude plugin validate --strict" in the plugin repo; the portal validates every commit on the branch it tracks.');
         r.push('Claude: "Passed review" is not the same as listed. Check claude.ai/directory for your listing after approval; with the new portal you choose when to publish.');
     }
+    if (stores.includes('vercel-connect') && m.server.auth === 'oauth')
+        r.push(...VERCEL_REMINDERS);
     return r;
 }
 /** Runtime-neutral: fetch only. Node adds socket checks (TLS 1.2) through extraChecks; see preflight-node. */
@@ -37,16 +44,25 @@ export async function preflight(m, opts = {}) {
     const stores = opts.stores?.length ? opts.stores : storesOf(m);
     const auth = m.server.auth ?? 'none';
     const server = await serverChecks(m.server.url, auth, opts.token, opts.extraChecks);
-    const [authC, listing, repo] = await Promise.all([
+    // One read of the OAuth discovery documents, shared by the sign-in chain, Vercel Connect and readiness checks.
+    const oauth = auth === 'oauth' ? await discover(m.server.url).catch(() => null) : null;
+    // A server that doesn't answer at all has already failed; probing it for the next revision adds nothing.
+    const down = server.checks.some((c) => c.id === 'server.reachable' && c.level === 'fail');
+    const [authC, chain, listing, repo, ard, readiness] = await Promise.all([
         auth === 'oauth' ? authChecks(m.server.url, { register: opts.register }) : Promise.resolve([]),
+        auth === 'oauth' ? chainChecks(m, oauth).catch(() => []) : Promise.resolve([]),
         listingChecks(m, server.tools, stores),
         repoChecks(m, stores),
+        ardChecks(m),
+        down ? Promise.resolve([]) : readinessChecks(m.server.url, auth, { token: opts.token, oauth }),
     ]);
-    const all = [...server.checks, ...authC, ...toolChecks(server.tools), ...listing, ...repo];
+    const vercel = stores.includes('vercel-connect') ? vercelChecks(m, oauth) : [];
+    const all = [...server.checks, ...authC, ...chain, ...toolChecks(server.tools), ...listing, ...repo, ...vercel, ...ard, ...readiness];
     // Keep checks that apply to every store or to one we're submitting to.
     const checks = all.filter((c) => !c.stores?.length || c.stores.some((s) => stores.includes(s)));
     return { checks, reminders: reminders(m, stores), stores };
 }
 export { draftManifest, forStore, storesOf, SCHEMA_URL } from './draft.js';
 export { toolChecks } from './checks/tools.js';
+export { validateArd, ardManifest } from './checks/ard.js';
 export { STORE_NAMES } from './types.js';

package/dist/demo.d.ts

@@ -0,0 +1,60 @@
+import type { Manifest } from './types.js';
+/**
+ * Every label mcplane relies on in ChatGPT desktop (checked against 26.903, 1 October 2026).
+ * When a release renames something, this is the one place to fix.
+ */
+export declare const UI: {
+    hideSidebar: string;
+    showSidebar: string;
+    newChat: string;
+    chatMode: string;
+    workMode: string;
+    addMenu: string;
+    send: string[];
+    stop: string[];
+    /** Buttons on a tool approval card. */
+    approval: string[];
+    /** What --approve clicks, first match wins. Never "Always allow": a demo shouldn't change your settings. */
+    allow: string[];
+    /** The collapsed summary of tool calls ("Worked for 5s"), opened at the end of each scene. */
+    activity: string;
+    signIn: string[];
+    /** Part of the message box's accessible name: "Message ChatGPT", "Ask ChatGPT", "Work with ChatGPT". */
+    composer: string;
+    /** The @mention pill keeps the plugin's id here; developer-mode plugins are "created-by-me". */
+    mentionAttr: string;
+    devMode: string;
+};
+/** "1,3" or "2-4" to zero-based indexes into the positive tests, in the order given. */
+export declare function pickTests(count: number, only?: string): number[];
+export interface DemoOptions {
+    /** Positive tests to record, e.g. "1,3" (default: all). */
+    only?: string;
+    /** Where to write the video (default: .mcplane/packs/chatgpt/demo.mp4). */
+    out?: string;
+    /** Click "Allow once" on tool approval cards. */
+    approve?: boolean;
+    /** Leave ChatGPT running afterwards (it keeps its debugging port open until you quit it). */
+    keepOpen?: boolean;
+    /** Don't ask first. */
+    yes?: boolean;
+    /** The plugin to @mention (default: the manifest's title). */
+    plugin?: string;
+    /** Record in Work mode instead of Chat. */
+    work?: boolean;
+    port?: number;
+    token?: string;
+    dir?: string;
+    log?: (line: string) => void;
+}
+export interface DemoResult {
+    out: string;
+    seconds: number;
+    scenes: number;
+    notes: string[];
+}
+export declare function demo(m: Manifest, o?: DemoOptions): Promise<DemoResult>;
+export declare const _test: {
+    pickTests: typeof pickTests;
+    PAGE: string;
+};