mcpmake 0.1.1 → 0.2.0

package/dist/plugins/loader.js

@@ -1,58 +0,0 @@
-/**
- * Plugin loader — discovers and loads McpmakeAdapter implementations.
- *
- * Plugins are loaded from:
- * 1. Built-in adapters (openapi, har, url, describe)
- * 2. npm packages named `mcpmake-adapter-*`
- * 3. Local files specified via --adapter flag
- */
-import { pathToFileURL } from 'node:url';
-import { logger } from '../utils/logger.js';
-const registry = new Map();
-/**
- * Register a plugin adapter.
- */
-export function registerAdapter(adapter) {
-    if (registry.has(adapter.name)) {
-        logger.warn(`Adapter "${adapter.name}" already registered, overwriting`);
-    }
-    registry.set(adapter.name, adapter);
-}
-/**
- * Get a registered adapter by name.
- */
-export function getAdapter(name) {
-    return registry.get(name);
-}
-/**
- * List all registered adapters.
- */
-export function listAdapters() {
-    return [...registry.values()];
-}
-/**
- * Load an adapter from a file path or npm package name.
- */
-export async function loadAdapterFromPath(pathOrPackage) {
-    let module;
-    try {
-        if (pathOrPackage.startsWith('.') || pathOrPackage.startsWith('/')) {
-            // Local file
-            const url = pathToFileURL(pathOrPackage).href;
-            module = await import(url);
-        }
-        else {
-            // npm package
-            module = await import(pathOrPackage);
-        }
-    }
-    catch (err) {
-        throw new Error(`Failed to load adapter from "${pathOrPackage}": ${err instanceof Error ? err.message : err}`);
-    }
-    const adapter = module.default;
-    if (!adapter || typeof adapter.name !== 'string' || typeof adapter.parse !== 'function') {
-        throw new Error(`Invalid adapter: "${pathOrPackage}" must export a default McpmakeAdapter with name and parse()`);
-    }
-    registerAdapter(adapter);
-    return adapter;
-}

package/dist/pricing.d.ts

@@ -1,55 +0,0 @@
-/**
- * Canonical pricing for mcpmake's lead commercial offering ("Family A").
- *
- * Family A is the *non-cloud* product: the local compiler (CLI), the CI sync
- * subscription, the self-hosted license, and done-for-you migration services.
- * Per MONEY.md this is what carries the business — software/services margins
- * (~95–100%) with no per-tenant infrastructure exposure.
- *
- * Family B (managed cloud hosting) is a later convenience add-on; its limits
- * and plan enforcement live in `src/cloud/billing/billing-engine.ts`, and its
- * margin depends entirely on Playwright browser-minute utilization (see
- * MONEY.md → "Margins & unit economics"). Do NOT anchor the product on it.
- *
- * Source of truth for the numbers below: MONEY.md (research June 2026). When a
- * price changes, change it here and in MONEY.md together.
- */
-export type BillingPeriod = 'monthly' | 'yearly' | 'one-off';
-export interface PricePoint {
-    /** Stable internal id. */
-    id: string;
-    /** Display name. */
-    name: string;
-    /** Entry price in whole USD. 0 = free. */
-    priceUsd: number;
-    /**
-     * Upper bound for banded tiers (services/license priced by scope/support).
-     * `null` for a fixed price.
-     */
-    priceMaxUsd: number | null;
-    period: BillingPeriod;
-    /** One-line description of what the tier delivers. */
-    summary: string;
-}
-/** Family A — the lead, non-cloud offering. Source of truth for docs/UI. */
-export declare const FAMILY_A_PRICING: Record<string, PricePoint>;
-/** Default backend that serves the authoritative pricing. */
-export declare const DEFAULT_PRICING_SERVER = "https://mcpmake.dev";
-/**
- * Fetch the live Family A pricing from the backend so an outdated installed CLI
- * never prints stale numbers. Falls back to the bundled {@link FAMILY_A_PRICING}
- * when the backend is unreachable, slow, or returns anything unexpected — the
- * CLI must still work offline.
- *
- * @param serverUrl Backend base URL (defaults to {@link DEFAULT_PRICING_SERVER}).
- * @param timeoutMs Abort the request after this long (default 4000 ms).
- */
-export declare function fetchPricing(serverUrl?: string, timeoutMs?: number): Promise<{
-    pricing: Record<string, PricePoint>;
-    source: 'backend' | 'bundled';
-}>;
-/**
- * Human-readable price label, e.g. `"Free forever"`, `"$19/mo"`,
- * `"from $8,000/yr"`, `"$5,000–$20,000 one-off"`.
- */
-export declare function formatPrice(p: PricePoint): string;

package/dist/pricing.js

@@ -1,133 +0,0 @@
-/**
- * Canonical pricing for mcpmake's lead commercial offering ("Family A").
- *
- * Family A is the *non-cloud* product: the local compiler (CLI), the CI sync
- * subscription, the self-hosted license, and done-for-you migration services.
- * Per MONEY.md this is what carries the business — software/services margins
- * (~95–100%) with no per-tenant infrastructure exposure.
- *
- * Family B (managed cloud hosting) is a later convenience add-on; its limits
- * and plan enforcement live in `src/cloud/billing/billing-engine.ts`, and its
- * margin depends entirely on Playwright browser-minute utilization (see
- * MONEY.md → "Margins & unit economics"). Do NOT anchor the product on it.
- *
- * Source of truth for the numbers below: MONEY.md (research June 2026). When a
- * price changes, change it here and in MONEY.md together.
- */
-/** Family A — the lead, non-cloud offering. Source of truth for docs/UI. */
-export const FAMILY_A_PRICING = {
-    cli: {
-        id: 'cli',
-        name: 'Local compiler (CLI)',
-        priceUsd: 0,
-        priceMaxUsd: null,
-        period: 'monthly',
-        summary: 'Generate editable code you own, run anywhere. Free forever — top of funnel + ownership story.',
-    },
-    syncSolo: {
-        id: 'sync-solo',
-        name: 'Sync — Solo',
-        priceUsd: 19,
-        priceMaxUsd: null,
-        period: 'monthly',
-        summary: 'CI drift-check + spec-currency auto-PRs, 1 repo.',
-    },
-    syncTeam: {
-        id: 'sync-team',
-        name: 'Sync — Team',
-        priceUsd: 499,
-        priceMaxUsd: null,
-        period: 'monthly',
-        summary: 'Multi-repo CI sync, policy checks, support.',
-    },
-    selfHostLicense: {
-        id: 'self-host-license',
-        name: 'Self-hosted license',
-        priceUsd: 8_000,
-        priceMaxUsd: 40_000,
-        period: 'yearly',
-        summary: 'Run the generator + sync on your own infra; governance + support SLA.',
-    },
-    migration: {
-        id: 'migration',
-        name: 'Migration engagement',
-        priceUsd: 5_000,
-        priceMaxUsd: 20_000,
-        period: 'one-off',
-        summary: 'Done-for-you API → owned MCP servers + CI wiring.',
-    },
-};
-/** Default backend that serves the authoritative pricing. */
-export const DEFAULT_PRICING_SERVER = 'https://mcpmake.dev';
-function isPricePoint(v) {
-    if (typeof v !== 'object' || v === null)
-        return false;
-    const p = v;
-    return (typeof p.id === 'string' &&
-        typeof p.name === 'string' &&
-        typeof p.priceUsd === 'number' &&
-        (p.priceMaxUsd === null || typeof p.priceMaxUsd === 'number') &&
-        (p.period === 'monthly' || p.period === 'yearly' || p.period === 'one-off') &&
-        typeof p.summary === 'string');
-}
-/**
- * Fetch the live Family A pricing from the backend so an outdated installed CLI
- * never prints stale numbers. Falls back to the bundled {@link FAMILY_A_PRICING}
- * when the backend is unreachable, slow, or returns anything unexpected — the
- * CLI must still work offline.
- *
- * @param serverUrl Backend base URL (defaults to {@link DEFAULT_PRICING_SERVER}).
- * @param timeoutMs Abort the request after this long (default 4000 ms).
- */
-export async function fetchPricing(serverUrl = DEFAULT_PRICING_SERVER, timeoutMs = 4_000) {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-        const base = serverUrl.replace(/\/+$/, '');
-        const res = await fetch(`${base}/api/pricing`, {
-            headers: { accept: 'application/json' },
-            signal: controller.signal,
-        });
-        if (!res.ok)
-            return { pricing: FAMILY_A_PRICING, source: 'bundled' };
-        const body = (await res.json());
-        const familyA = body?.familyA;
-        if (typeof familyA !== 'object' || familyA === null) {
-            return { pricing: FAMILY_A_PRICING, source: 'bundled' };
-        }
-        // Only accept a well-formed payload; one bad entry falls back wholesale so
-        // we never mix live and stale prices in a single display.
-        const entries = Object.entries(familyA);
-        if (entries.length === 0 || !entries.every(([, v]) => isPricePoint(v))) {
-            return { pricing: FAMILY_A_PRICING, source: 'bundled' };
-        }
-        return { pricing: familyA, source: 'backend' };
-    }
-    catch {
-        return { pricing: FAMILY_A_PRICING, source: 'bundled' };
-    }
-    finally {
-        clearTimeout(timer);
-    }
-}
-const PERIOD_SUFFIX = {
-    monthly: '/mo',
-    yearly: '/yr',
-    'one-off': ' one-off',
-};
-/**
- * Human-readable price label, e.g. `"Free forever"`, `"$19/mo"`,
- * `"from $8,000/yr"`, `"$5,000–$20,000 one-off"`.
- */
-export function formatPrice(p) {
-    if (p.priceUsd === 0)
-        return 'Free forever';
-    const usd = (n) => `$${n.toLocaleString('en-US')}`;
-    const suffix = PERIOD_SUFFIX[p.period];
-    if (p.priceMaxUsd != null) {
-        return p.period === 'one-off'
-            ? `${usd(p.priceUsd)}–${usd(p.priceMaxUsd)}${suffix}`
-            : `from ${usd(p.priceUsd)}${suffix}`;
-    }
-    return `${usd(p.priceUsd)}${suffix}`;
-}

package/dist/providers/index.d.ts

@@ -1,15 +0,0 @@
-export interface ProviderConfig {
-    name: string;
-    description: string;
-    specUrl: string;
-    baseUrl: string;
-    auth: {
-        type: 'apiKey' | 'bearer' | 'basic' | 'oauth2';
-        envVar: string;
-        headerName?: string;
-    };
-    suggestedIncludes?: string[];
-}
-export declare function getProvider(name: string): ProviderConfig | undefined;
-export declare function listProviders(): ProviderConfig[];
-export declare function getProviderNames(): string[];

package/dist/providers/index.js

@@ -1,56 +0,0 @@
-const providers = {
-    stripe: {
-        name: 'stripe',
-        description: 'Stripe payment processing',
-        specUrl: 'https://raw.githubusercontent.com/stripe/openapi/master/openapi/spec3.json',
-        baseUrl: 'https://api.stripe.com',
-        auth: { type: 'bearer', envVar: 'STRIPE_API_KEY' },
-        suggestedIncludes: ['customers', 'charges', 'payments', 'invoices', 'subscriptions'],
-    },
-    github: {
-        name: 'github',
-        description: 'GitHub REST API',
-        specUrl: 'https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.json',
-        baseUrl: 'https://api.github.com',
-        auth: { type: 'bearer', envVar: 'GITHUB_TOKEN' },
-        suggestedIncludes: ['repos', 'issues', 'pulls', 'actions'],
-    },
-    slack: {
-        name: 'slack',
-        description: 'Slack Web API',
-        specUrl: 'https://raw.githubusercontent.com/slackapi/slack-api-specs/master/web-api/slack_web_openapi_v2.json',
-        baseUrl: 'https://slack.com/api',
-        auth: { type: 'bearer', envVar: 'SLACK_TOKEN' },
-        suggestedIncludes: ['chat', 'channels', 'users', 'files'],
-    },
-    notion: {
-        name: 'notion',
-        description: 'Notion API',
-        specUrl: 'https://bump.sh/notion-hq/doc/notion/specification',
-        baseUrl: 'https://api.notion.com/v1',
-        auth: { type: 'bearer', envVar: 'NOTION_API_KEY', headerName: 'Authorization' },
-    },
-    linear: {
-        name: 'linear',
-        description: 'Linear project management',
-        specUrl: 'https://studio.apollographql.com/public/Linear-API/variant/current/home',
-        baseUrl: 'https://api.linear.app',
-        auth: { type: 'bearer', envVar: 'LINEAR_API_KEY' },
-    },
-    shopify: {
-        name: 'shopify',
-        description: 'Shopify Admin API',
-        specUrl: 'https://shopify.dev/docs/admin-api/rest/reference',
-        baseUrl: 'https://{store}.myshopify.com/admin/api/2024-01',
-        auth: { type: 'bearer', envVar: 'SHOPIFY_ACCESS_TOKEN' },
-    },
-};
-export function getProvider(name) {
-    return providers[name.toLowerCase()];
-}
-export function listProviders() {
-    return Object.values(providers);
-}
-export function getProviderNames() {
-    return Object.keys(providers);
-}

package/dist/recorder/browser-recorder.d.ts

@@ -1,22 +0,0 @@
-import type { Entry } from 'har-format';
-export interface RecorderOptions {
-    url: string;
-    timeout?: number;
-    /**
-     * Run the browser headless and capture non-interactively (CI-friendly).
-     * In this mode there is no window for a human to drive, so traffic is
-     * captured from the initial load plus any `navigate` URLs, then the
-     * browser closes automatically.
-     */
-    headless?: boolean;
-    /**
-     * Additional same-origin URLs (absolute or relative to `url`) to visit
-     * automatically in headless mode to surface more API calls.
-     */
-    navigate?: string[];
-}
-export interface RecordingResult {
-    entries: Entry[];
-    baseUrl: string;
-}
-export declare function recordBrowserSession(options: RecorderOptions): Promise<RecordingResult>;

package/dist/recorder/browser-recorder.js

@@ -1,205 +0,0 @@
-import { chromium } from 'playwright';
-import { logger } from '../utils/logger.js';
-const MAX_ENTRIES = 10_000;
-const MAX_RESPONSE_BODY_BYTES = 5 * 1024 * 1024; // 5 MB
-const SKIP_BODY_MIME_TYPES = ['image/', 'video/', 'audio/', 'font/', 'application/octet-stream'];
-export async function recordBrowserSession(options) {
-    const idleTimeout = options.timeout ?? 5 * 60 * 1000;
-    const entries = [];
-    const pendingRequests = new Map();
-    let lastActivityTime = Date.now();
-    const parsedUrl = new URL(options.url);
-    if (!['http:', 'https:'].includes(parsedUrl.protocol)) {
-        throw new Error('Only http/https URLs are supported');
-    }
-    const baseUrl = `${parsedUrl.protocol}//${parsedUrl.host}`;
-    const headless = options.headless ?? false;
-    let browser;
-    try {
-        browser = await chromium.launch({ headless });
-        const context = await browser.newContext();
-        const page = await context.newPage();
-        // Capture requests
-        page.on('request', (request) => {
-            lastActivityTime = Date.now();
-            pendingRequests.set(request, { startTime: Date.now() });
-        });
-        // Capture responses
-        page.on('response', async (response) => {
-            lastActivityTime = Date.now();
-            if (entries.length >= MAX_ENTRIES)
-                return;
-            const request = response.request();
-            const pending = pendingRequests.get(request);
-            if (!pending)
-                return;
-            pendingRequests.delete(request);
-            try {
-                const entry = await buildHarEntry(request, response, pending.startTime);
-                entries.push(entry);
-                if (entries.length === MAX_ENTRIES) {
-                    logger.warn(`Captured ${MAX_ENTRIES} entries — ignoring further requests.`);
-                }
-            }
-            catch {
-                // Some responses can't be read (e.g., redirects, aborted)
-            }
-        });
-        if (headless) {
-            // Non-interactive capture: load the page, then auto-visit any extra
-            // same-origin URLs, capturing their API traffic. No window to close.
-            logger.info(`Capturing (headless) from: ${options.url}`);
-            await page.goto(options.url, { waitUntil: 'networkidle', timeout: 30_000 }).catch(() => { });
-            const navTargets = resolveNavTargets(options.navigate ?? [], baseUrl);
-            for (const navUrl of navTargets) {
-                logger.info(`  visiting: ${navUrl}`);
-                try {
-                    await page.goto(navUrl, { waitUntil: 'networkidle', timeout: 30_000 });
-                }
-                catch {
-                    // Skip navigations that fail (timeout, 4xx, etc.)
-                }
-            }
-            // Let any trailing XHRs settle before closing.
-            await page.waitForTimeout(1000);
-            await browser.close().catch(() => { });
-            browser = undefined;
-        }
-        else {
-            // Interactive capture: a human drives the visible window.
-            logger.info(`Opening browser at: ${options.url}`);
-            logger.info('Interact with the page to capture API calls.');
-            logger.info('Close the browser window when done.');
-            await page.goto(options.url, { waitUntil: 'domcontentloaded' });
-            // Wait for the user to close the browser or idle timeout
-            await new Promise((resolve) => {
-                const idleCheck = setInterval(() => {
-                    if (Date.now() - lastActivityTime > idleTimeout) {
-                        logger.warn(`Idle timeout (${Math.round(idleTimeout / 1000)}s). Closing browser.`);
-                        clearInterval(idleCheck);
-                        browser?.close().then(resolve).catch(resolve);
-                    }
-                }, 5000);
-                browser.on('disconnected', () => {
-                    clearInterval(idleCheck);
-                    resolve();
-                });
-            });
-        }
-    }
-    catch (error) {
-        if (browser)
-            await browser.close().catch(() => { });
-        throw error;
-    }
-    return { entries, baseUrl };
-}
-/**
- * Resolve auto-navigation targets against the base URL, keeping only
- * same-origin http/https URLs (avoids wandering off to other hosts).
- */
-function resolveNavTargets(navigate, baseUrl) {
-    const base = new URL(baseUrl);
-    const out = [];
-    for (const raw of navigate) {
-        const trimmed = raw.trim();
-        if (!trimmed)
-            continue;
-        try {
-            const resolved = new URL(trimmed, baseUrl);
-            if (!['http:', 'https:'].includes(resolved.protocol))
-                continue;
-            if (resolved.host !== base.host) {
-                logger.warn(`Skipping cross-origin navigate target: ${trimmed}`);
-                continue;
-            }
-            out.push(resolved.toString());
-        }
-        catch {
-            logger.warn(`Skipping invalid navigate target: ${trimmed}`);
-        }
-    }
-    return out;
-}
-async function buildHarEntry(request, response, startTime) {
-    const elapsed = Date.now() - startTime;
-    const url = request.url();
-    const parsedUrl = new URL(url);
-    // Request headers
-    const requestHeaders = Object.entries(request.headers()).map(([name, value]) => ({
-        name,
-        value,
-    }));
-    // Query string
-    const queryString = [...parsedUrl.searchParams.entries()].map(([name, value]) => ({
-        name,
-        value,
-    }));
-    // Request body
-    const postData = request.postData();
-    const contentTypeHeader = request.headers()['content-type'] ?? '';
-    // Response headers
-    const responseHeaders = Object.entries(response.headers()).map(([name, value]) => ({
-        name,
-        value,
-    }));
-    // Response body — skip large or binary responses
-    let responseText;
-    const responseMimeType = response.headers()['content-type'] ?? '';
-    const skipBody = SKIP_BODY_MIME_TYPES.some((m) => responseMimeType.startsWith(m));
-    const contentLength = parseInt(response.headers()['content-length'] ?? '0', 10);
-    if (!skipBody && contentLength <= MAX_RESPONSE_BODY_BYTES) {
-        try {
-            const body = await response.body();
-            if (body.length <= MAX_RESPONSE_BODY_BYTES) {
-                responseText = body.toString('utf-8');
-            }
-        }
-        catch {
-            // Body may not be available for some response types
-        }
-    }
-    return {
-        startedDateTime: new Date(startTime).toISOString(),
-        time: elapsed,
-        request: {
-            method: request.method(),
-            url,
-            httpVersion: 'HTTP/1.1',
-            headers: requestHeaders,
-            queryString,
-            cookies: [],
-            headersSize: -1,
-            bodySize: postData ? Buffer.byteLength(postData) : 0,
-            ...(postData
-                ? {
-                    postData: {
-                        mimeType: contentTypeHeader.split(';')[0].trim() || 'application/octet-stream',
-                        text: postData,
-                    },
-                }
-                : {}),
-        },
-        response: {
-            status: response.status(),
-            statusText: response.statusText(),
-            httpVersion: 'HTTP/1.1',
-            headers: responseHeaders,
-            cookies: [],
-            content: {
-                size: responseText ? Buffer.byteLength(responseText) : 0,
-                mimeType: responseMimeType.split(';')[0].trim() || 'application/octet-stream',
-                ...(responseText ? { text: responseText } : {}),
-            },
-            redirectURL: '',
-            headersSize: -1,
-            bodySize: responseText ? Buffer.byteLength(responseText) : 0,
-        },
-        cache: {},
-        timings: {
-            send: 1,
-            wait: Math.max(1, elapsed - 2),
-            receive: 1,
-        },
-    };
-}

package/dist/rescan/diff-engine.d.ts

@@ -1,5 +0,0 @@
-import type { SiteDescriptor, RescanResult } from '../types/site.js';
-/**
- * Compare two SiteDescriptors and produce a structured diff of changes.
- */
-export declare function diffSiteDescriptors(oldSite: SiteDescriptor, newSite: SiteDescriptor): RescanResult;