mcplane 0.1.0 → 0.3.0

package/dist/publish.d.ts

@@ -0,0 +1,52 @@
+import type { Manifest, StoreId } from './types.js';
+export interface PublishResult {
+    store: StoreId;
+    done: boolean;
+    lines: string[];
+    url?: string;
+}
+export declare function registryName(m: Manifest): string;
+export declare function serverJson(m: Manifest): {
+    version: string;
+    remotes: {
+        type: string;
+        url: string;
+    }[];
+    repository?: {
+        url: string;
+        source: string;
+    } | undefined;
+    websiteUrl?: string | undefined;
+    $schema: string;
+    name: string;
+    title: string;
+    description: string;
+};
+declare function grokEntry(m: Manifest, sha: string): {
+    keywords: string[];
+    domains: string[];
+    homepage?: string | undefined;
+    name: string;
+    description: string;
+    category: string;
+    source: {
+        source: string;
+        url: string;
+        sha: string;
+    };
+};
+/** Adds or re-pins our entry without reformatting the rest of the file. */
+declare function editMarketplace(text: string, entry: ReturnType<typeof grokEntry>): {
+    text: string;
+    mode: 'add' | 'bump' | 'same';
+};
+export declare function publish(m: Manifest, store: StoreId, opts?: {
+    yes?: boolean;
+    dir?: string;
+}): Promise<PublishResult>;
+export declare const _test: {
+    editMarketplace: typeof editMarketplace;
+    grokEntry: typeof grokEntry;
+    nextPrerelease: (v: string) => string;
+};
+export {};

package/dist/publish.js

@@ -59,7 +59,7 @@ async function registryVersions(name) {
 }
 /** 1.2.0 → 1.2.0-1, 1.2.0-1 → 1.2.0-2: the registry's way to change metadata without a new release. */
 const nextPrerelease = (v) => (/-(\d+)$/.test(v) ? v.replace(/-(\d+)$/, (_, n) => `-${Number(n) + 1}`) : `${v}-1`);
-const REGISTRY_READERS = 'GitHub’s MCP Registry (and VS Code), PulseMCP and MCP.Directory read from the official registry, so they pick this up on their own.';
+const REGISTRY_READERS = 'Glama and PulseMCP import from the official registry. GitHub’s MCP gallery (VS Code) needs a one-time manual onboarding, then syncs new versions. Run "mcplane listings" in a day or two to see where it landed.';
 async function publishRegistry(m, yes, dir) {
     const json = serverJson(m);
     const file = m.registry?.file ?? 'server.json';
@@ -201,6 +201,22 @@ async function publishGrok(m, yes) {
 function prepared(m, store) {
     const gh = ghRepo(m);
     const desc = m.oneLiner ?? m.subtitle ?? m.title;
+    if (store === 'awesome-remote-mcp-servers') {
+        const auth = m.server.auth === 'oauth' ? '🔐' : '🔓';
+        const reg = registryName(m);
+        const sentence = (desc.endsWith('.') ? desc : `${desc}.`).slice(0, 120);
+        return {
+            store,
+            done: false,
+            lines: [
+                'For hosted servers. Add this under the right category in punkpeye/awesome-remote-mcp-servers README.md (alphabetical):',
+                `- [${m.title}](${m.links?.website ?? m.server.url}) \`${m.server.url}\``,
+                `  [![${m.title} MCP connector](https://glama.ai/mcp/connectors/${reg}/badges/score.svg)](https://glama.ai/mcp/connectors/${reg})`,
+                `  ${auth} - ${sentence}`,
+                'Star the repo first (PRs from accounts that haven’t aren’t merged). CI sends an unauthenticated initialize: a 401 with WWW-Authenticate passes as OAuth. The Glama connector must exist ("mcplane listings"). Agent-opened PRs can end the title with 🤖🤖🤖 for the fast track.',
+            ],
+        };
+    }
     if (store === 'awesome-mcp-servers') {
         const link = gh ? `[${gh.owner}/${gh.repo}](https://github.com/${gh.owner}/${gh.repo})` : `[${m.title}](${m.links?.website ?? m.server.url})`;
         return {
@@ -222,10 +238,11 @@ function prepared(m, store) {
             store,
             done: false,
             lines: [
-                `Add ${gh ? `https://github.com/${gh.owner}/${gh.repo}` : 'your GitHub repo'} at https://glama.ai/mcp/servers ("Add MCP Server"). Glama runs its own checks (license, security, health) and scores the server.`,
-                'To claim the listing, commit glama.json at the repo root:',
+                `Hosted servers: Glama imports a connector from the official registry at https://glama.ai/mcp/connectors/${registryName(m)}. Publish there first, then claim it.`,
+                `Code on GitHub: add ${gh ? `https://github.com/${gh.owner}/${gh.repo}` : 'the repo'} at https://glama.ai/mcp/servers ("Add MCP Server"); Glama checks license, security and health, and scores it.`,
+                'To claim either, commit glama.json at the repo root:',
                 JSON.stringify({ $schema: 'https://glama.ai/mcp/schemas/server.json', maintainers: [owner] }, null, 2),
-                'awesome-mcp-servers asks for the Glama score badge on each entry, so do this first.',
+                'Both awesome lists require the Glama badge on each entry, so do this first.',
             ],
         };
     }

package/dist/report.d.ts

@@ -0,0 +1,4 @@
+import type { PreflightResult } from './preflight.js';
+export declare function printPreflight(r: PreflightResult, opts?: {
+    verbose?: boolean;
+}): void;

package/dist/submissions.d.ts

@@ -0,0 +1,33 @@
+import type { Manifest, StoreId } from './types.js';
+export interface Submission {
+    store: StoreId;
+    kind: 'new' | 'update' | 'resubmission';
+    version?: string;
+    submittedOn: string;
+    status: 'waiting' | 'approved' | 'rejected' | 'withdrawn';
+    decidedOn?: string;
+    reviewTimes?: {
+        token: string;
+        shareUrl: string | null;
+    };
+}
+export declare function load(dir?: string): Promise<Submission[]>;
+export declare function recordSubmitted(m: Manifest, store: StoreId, opts: {
+    date?: string;
+    kind?: Submission['kind'];
+    version?: string;
+    appId?: string;
+    share?: boolean;
+    token?: string;
+}, dir?: string): Promise<{
+    submission: Submission;
+    note: string;
+}>;
+export declare function recordDecision(store: StoreId, outcome: 'approved' | 'rejected' | 'withdrawn', date?: string, dir?: string): Promise<Submission>;
+export interface StatusRow {
+    submission: Submission;
+    days: number;
+    typical: string | null;
+}
+/** Refreshes each waiting submission from Review Times (the directory watch may have closed it) and adds the store's typical wait. */
+export declare function status(dir?: string): Promise<StatusRow[]>;

package/dist/types.d.ts

@@ -0,0 +1,97 @@
+export type Level = 'pass' | 'warn' | 'fail' | 'skip';
+export interface Check {
+    id: string;
+    level: Level;
+    title: string;
+    /** What we found. */
+    detail?: string;
+    /** How to fix it, when it isn't a pass. */
+    fix?: string;
+    /** The stores this matters for; empty means all. */
+    stores?: StoreId[];
+}
+export type StoreId = 'mcp-registry' | 'chatgpt' | 'claude-connectors' | 'claude-plugins' | 'cursor' | 'grok' | 'docker' | 'muse' | 'smithery' | 'glama' | 'cline' | 'lobehub' | 'awesome-mcp-servers' | 'awesome-remote-mcp-servers';
+export declare const STORE_NAMES: Record<StoreId, string>;
+export interface Manifest {
+    $schema?: string;
+    name: string;
+    title: string;
+    subtitle?: string;
+    oneLiner?: string;
+    description?: string;
+    category?: string;
+    server: {
+        url: string;
+        auth?: 'none' | 'oauth';
+    };
+    repository?: string;
+    author?: {
+        name: string;
+        url?: string;
+    };
+    links?: {
+        website?: string;
+        support?: string;
+        privacy?: string;
+        terms?: string;
+        docs?: string;
+    };
+    icon?: string;
+    prompts?: string[];
+    stores?: StoreId[];
+    /** Review test cases: ChatGPT wants exactly 5 positive and 3 negative. */
+    tests?: {
+        positive?: {
+            scenario: string;
+            prompt: string;
+            tools: string[];
+            expected: string;
+        }[];
+        negative?: {
+            scenario: string;
+            prompt: string;
+        }[];
+    };
+    /** Hand-written ChatGPT hint justifications, per tool; they replace mcplane's drafts. */
+    justifications?: Record<string, {
+        readOnly?: string;
+        openWorld?: string;
+        destructive?: string;
+    }>;
+    /** Your server's version, for the MCP Registry and your own records. */
+    version?: string;
+    /** MCP Registry overrides: reverse-DNS name (io.github.<owner>/<name> by default), description (100 max), file path. */
+    registry?: {
+        name?: string;
+        description?: string;
+        file?: string;
+    };
+    /** Grok marketplace entry overrides. */
+    grok?: {
+        description?: string;
+        category?: string;
+        keywords?: string[];
+        domains?: string[];
+    };
+    /** Named workflows, run with "mcplane <lane>": each step is a command line without "mcplane". */
+    lanes?: Record<string, string[]>;
+    /** How reviewers get in, for servers behind sign-in. Never put the password here; say where it lives. */
+    reviewerAccess?: string;
+}
+export interface Tool {
+    name: string;
+    title?: string;
+    description?: string;
+    inputSchema?: {
+        properties?: Record<string, unknown>;
+        required?: string[];
+    };
+    outputSchema?: unknown;
+    annotations?: {
+        title?: string;
+        readOnlyHint?: boolean;
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
+    };
+}

package/dist/types.js

@@ -12,4 +12,5 @@ export const STORE_NAMES = {
     cline: 'Cline MCP Marketplace',
     lobehub: 'LobeHub Market',
     'awesome-mcp-servers': 'awesome-mcp-servers',
+    'awesome-remote-mcp-servers': 'awesome-remote-mcp-servers',
 };

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION = "0.3.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.1.0';
+export const VERSION = '0.3.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcplane",
-  "version": "0.1.0",
+  "version": "0.3.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": {
@@ -52,5 +52,13 @@
     "url": "https://github.com/stevysmith/mcplane/issues"
   },
   "author": "Steve Smith",
-  "mcpName": "io.github.stevysmith/mcplane"
+  "mcpName": "io.github.stevysmith/mcplane",
+  "exports": {
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "default": "./dist/core.js"
+    },
+    "./schema.json": "./schema.json",
+    "./package.json": "./package.json"
+  }
 }

package/schema.json

@@ -25,7 +25,8 @@
         "glama",
         "cline",
         "lobehub",
-        "awesome-mcp-servers"
+        "awesome-mcp-servers",
+        "awesome-remote-mcp-servers"
       ]
     },
     "url": {