@wootsup/mcp 0.1.0-rc.1

package/dist/setup/write-config.js

@@ -0,0 +1,247 @@
+// src/setup/write-config.ts — Phase 6.3.
+//
+// Idempotent JSON + TOML config writers. The writer:
+//
+//   • adds an `mcpServers.<key>` entry (or `[mcp_servers.<key>]` TOML block)
+//   • marks the entry with a managed-marker so future runs can recognise it
+//   • PRESERVES unrelated user config (theme settings, other MCP servers,
+//     comments outside our managed block)
+//   • refuses to clobber an existing unmanaged entry of the same key
+//   • writes atomically via tmp-then-rename
+//   • returns an `undo()` handle that can roll back the write
+//
+// We don't use a TOML parser library — Codex CLI configs are simple enough
+// that a hand-rolled, block-scoped writer keeps us dependency-free and
+// trivially safe to roll back.
+import { existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from "node:fs";
+import { dirname } from "node:path";
+export const MANAGED_MARKER = "x-managed-by";
+export const MANAGED_VALUE = "@wootsup/mcp";
+export const TOML_MANAGED_COMMENT = "# @apimapper-managed";
+// ── helpers ────────────────────────────────────────────────────────────
+function ensureDir(path) {
+    const dir = dirname(path);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+}
+function atomicWrite(path, contents) {
+    ensureDir(path);
+    const tmp = `${path}.${process.pid}.tmp`;
+    try {
+        writeFileSync(tmp, contents, "utf8");
+        renameSync(tmp, path);
+    }
+    catch (err) {
+        // Best-effort cleanup of the staging file on failure.
+        try {
+            if (existsSync(tmp))
+                unlinkSync(tmp);
+        }
+        catch {
+            /* ignore */
+        }
+        throw err;
+    }
+}
+function readIfExists(path) {
+    if (!existsSync(path))
+        return null;
+    return readFileSync(path, "utf8");
+}
+function makeUndo(path, beforeContent) {
+    return async () => {
+        if (beforeContent === null) {
+            // The file didn't exist before our write — remove it entirely.
+            if (existsSync(path)) {
+                try {
+                    unlinkSync(path);
+                }
+                catch {
+                    /* swallow — best-effort rollback */
+                }
+            }
+            return;
+        }
+        atomicWrite(path, beforeContent);
+    };
+}
+// ── JSON writer ────────────────────────────────────────────────────────
+export async function writeJsonConfig(path, key, entry) {
+    const before = readIfExists(path);
+    const noopUndo = makeUndo(path, before);
+    let parsed;
+    if (before === null) {
+        parsed = {};
+    }
+    else {
+        try {
+            const raw = JSON.parse(before);
+            if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+                // Treat non-object root as empty config — preserves nothing but
+                // also doesn't crash on a malformed file.
+                parsed = {};
+            }
+            else {
+                parsed = raw;
+            }
+        }
+        catch {
+            parsed = {};
+        }
+    }
+    // Ensure mcpServers is a plain object.
+    let servers;
+    const existing = parsed.mcpServers;
+    if (existing &&
+        typeof existing === "object" &&
+        !Array.isArray(existing)) {
+        servers = existing;
+    }
+    else {
+        servers = {};
+    }
+    const existingEntry = servers[key];
+    const isManaged = existingEntry &&
+        typeof existingEntry === "object" &&
+        !Array.isArray(existingEntry) &&
+        existingEntry[MANAGED_MARKER] ===
+            MANAGED_VALUE;
+    const keyPresent = existingEntry !== undefined;
+    if (keyPresent && !isManaged) {
+        // Don't clobber a user-managed entry of the same key.
+        return { added: false, alreadyManaged: false, undo: noopUndo };
+    }
+    // Build the new entry. Preserve unrelated fields the user may have
+    // added (e.g. transport metadata) when we're updating a managed entry.
+    const merged = isManaged && typeof existingEntry === "object" && existingEntry !== null
+        ? { ...existingEntry }
+        : {};
+    merged.command = entry.command;
+    merged.args = entry.args;
+    if (entry.env) {
+        merged.env = entry.env;
+    }
+    else {
+        delete merged.env;
+    }
+    merged[MANAGED_MARKER] = MANAGED_VALUE;
+    servers[key] = merged;
+    parsed.mcpServers = servers;
+    atomicWrite(path, `${JSON.stringify(parsed, null, 2)}\n`);
+    return {
+        added: true,
+        alreadyManaged: Boolean(isManaged),
+        undo: makeUndo(path, before),
+    };
+}
+// ── TOML writer ────────────────────────────────────────────────────────
+function tomlEscape(s) {
+    return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+function renderTomlEntry(key, entry) {
+    const lines = [];
+    lines.push(TOML_MANAGED_COMMENT);
+    lines.push(`[mcp_servers.${key}]`);
+    lines.push(`command = "${tomlEscape(entry.command)}"`);
+    const args = entry.args.map((a) => `"${tomlEscape(a)}"`).join(", ");
+    lines.push(`args = [${args}]`);
+    if (entry.env && Object.keys(entry.env).length > 0) {
+        lines.push(`[mcp_servers.${key}.env]`);
+        for (const [k, v] of Object.entries(entry.env)) {
+            lines.push(`${k} = "${tomlEscape(v)}"`);
+        }
+    }
+    lines.push(""); // trailing blank line for readability
+    return lines.join("\n");
+}
+/**
+ * Find the block boundaries for `[mcp_servers.<key>]` in `lines`. A block
+ * ends at the next `[...]` heading or at EOF. The "start" line is the
+ * managed-marker comment if it directly precedes the header, otherwise
+ * the header line itself.
+ */
+function findTomlBlock(lines, key) {
+    const headerExact = `[mcp_servers.${key}]`;
+    const subPrefix = `[mcp_servers.${key}.`;
+    let headerIdx = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const trimmed = lines[i].trim();
+        if (trimmed === headerExact) {
+            headerIdx = i;
+            break;
+        }
+    }
+    if (headerIdx === -1)
+        return null;
+    let endExclusive = lines.length;
+    for (let i = headerIdx + 1; i < lines.length; i++) {
+        const trimmed = lines[i].trim();
+        if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
+            // Sub-tables (e.g. `[mcp_servers.<key>.env]`) belong to this block.
+            if (trimmed.startsWith(subPrefix))
+                continue;
+            endExclusive = i;
+            break;
+        }
+    }
+    // Detect marker on the line immediately above the header.
+    let start = headerIdx;
+    let hasMarker = false;
+    if (headerIdx > 0 && lines[headerIdx - 1].trim() === TOML_MANAGED_COMMENT) {
+        start = headerIdx - 1;
+        hasMarker = true;
+    }
+    // Trim trailing blank lines from this block into the block-span so undo
+    // doesn't leave a double blank when the block is removed.
+    while (endExclusive > start &&
+        lines[endExclusive - 1] !== undefined &&
+        lines[endExclusive - 1].trim() === "") {
+        endExclusive--;
+    }
+    return { start, endExclusive, hasMarker };
+}
+export async function writeTomlConfig(path, key, entry) {
+    const before = readIfExists(path);
+    const noopUndo = makeUndo(path, before);
+    const original = before ?? "";
+    const lines = original.length === 0 ? [] : original.split("\n");
+    const span = findTomlBlock(lines, key);
+    if (span && !span.hasMarker) {
+        // Unmanaged user block — leave it alone.
+        return { added: false, alreadyManaged: false, undo: noopUndo };
+    }
+    const rendered = renderTomlEntry(key, entry);
+    let nextText;
+    if (span && span.hasMarker) {
+        // Replace the managed block in-place.
+        const head = lines.slice(0, span.start);
+        const tail = lines.slice(span.endExclusive);
+        // Re-join + ensure exactly one blank line separator between rendered
+        // block and following content (if any).
+        const headText = head.join("\n");
+        const tailText = tail.join("\n");
+        const sep = headText.length > 0 && !headText.endsWith("\n\n")
+            ? (headText.endsWith("\n") ? "" : "\n")
+            : "";
+        nextText = `${headText}${sep}${rendered}${tailText.length > 0 ? `\n${tailText.replace(/^\n+/, "")}` : ""}`;
+    }
+    else {
+        // Append rendered block to end.
+        const sep = original.length === 0 || original.endsWith("\n\n")
+            ? ""
+            : original.endsWith("\n")
+                ? "\n"
+                : "\n\n";
+        nextText = `${original}${sep}${rendered}`;
+    }
+    // Normalise trailing newline.
+    if (!nextText.endsWith("\n"))
+        nextText += "\n";
+    atomicWrite(path, nextText);
+    return {
+        added: true,
+        alreadyManaged: Boolean(span && span.hasMarker),
+        undo: makeUndo(path, before),
+    };
+}
+//# sourceMappingURL=write-config.js.map

package/dist/setup/write-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-config.js","sourceRoot":"","sources":["../../src/setup/write-config.ts"],"names":[],"mappings":"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"}

package/dist/setup-cli.d.ts

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import { installSkill as defaultInstallSkill } from "./install-skill.js";
+import { type TokenPayload } from "./auth/token.js";
+import { type DetectedClient } from "./setup/detect-clients.js";
+import { type McpEntry, type WriteConfigResult } from "./setup/write-config.js";
+import { type ProbeOptions, type ProbeResult } from "./setup/probe-handshake.js";
+export interface IdentityResponse {
+    platform: "wordpress" | "joomla" | "unknown";
+    siteurl: string;
+    plugin_version: string;
+}
+export interface WizardAnswers {
+    token: string;
+    siteUrl: string;
+    profileName: string;
+    /** IDs of clients the user wants wired up. */
+    selectedClients: string[];
+    confirmIdentity: boolean;
+}
+export interface WizardDeps {
+    /**
+     * Drive the wizard prompts. Returns the collected answers or `null` if
+     * the user cancelled at any step.
+     *
+     * The real implementation in this module uses @clack/prompts under the
+     * hood; tests inject a deterministic fake.
+     */
+    prompt: (input: {
+        detected: DetectedClient[];
+        decodeToken: (t: string) => TokenPayload | null;
+    }) => Promise<WizardAnswers | null>;
+    detectClients: () => Promise<DetectedClient[]>;
+    probeIdentity: (siteUrl: string) => Promise<IdentityResponse>;
+    writeJsonConfig: (path: string, key: string, entry: McpEntry) => Promise<WriteConfigResult>;
+    writeTomlConfig: (path: string, key: string, entry: McpEntry) => Promise<WriteConfigResult>;
+    probeHandshake: (opts: ProbeOptions) => Promise<ProbeResult>;
+    /**
+     * Sink for human-facing status lines. The default writes to stderr;
+     * tests can stub to a buffer.
+     */
+    log?: (line: string) => void;
+}
+interface RunCliDeps {
+    installSkill: typeof defaultInstallSkill;
+    runWizard: () => Promise<number>;
+}
+export declare function runWizard(deps?: WizardDeps): Promise<number>;
+export declare function runCli(argv: string[], deps?: Partial<RunCliDeps>): Promise<number>;
+export {};

package/dist/setup-cli.js

@@ -0,0 +1,292 @@
+#!/usr/bin/env node
+// src/setup-cli.ts — Phase 6.1.
+//
+// Top-level CLI entry. Three subcommands:
+//
+//   setup (default)  — interactive @clack/prompts first-run wizard
+//   install-skill    — copy the bundled skill to ~/.claude/skills/
+//                      (preserved verbatim from Phase 7.5)
+//   --help / help    — usage
+//
+// The wizard logic lives in runWizard(), which accepts a WizardDeps
+// bag so the unit tests can drive a deterministic prompt/probe/write/
+// handshake sequence without touching real subprocesses or filesystems.
+// The default DEPS object plugs in the real @clack/prompts UI, the
+// real detect-clients, write-config, and probe-handshake modules.
+import { intro, outro, text, multiselect, spinner, cancel, isCancel, note, } from "@clack/prompts";
+import { installSkill as defaultInstallSkill } from "./install-skill.js";
+import { decodeToken } from "./auth/token.js";
+import { detectClients as defaultDetectClients, } from "./setup/detect-clients.js";
+import { writeJsonConfig as defaultWriteJsonConfig, writeTomlConfig as defaultWriteTomlConfig, } from "./setup/write-config.js";
+import { probeHandshake as defaultProbeHandshake, rollbackAll, } from "./setup/probe-handshake.js";
+const HELP_TEXT = `Usage: apimapper-mcp <command>
+
+Commands:
+  setup           Interactive first-run wizard (default if no command)
+  install-skill   Copy the bundled apimapper skill to ~/.claude/skills/
+                  and register it in ~/AGENTS.md.
+  help            Show this message.
+`;
+// ── identity probe (default impl) ───────────────────────────────────────
+const PROBE_TIMEOUT_MS = 5_000;
+/**
+ * Try WordPress + Joomla identity endpoints in parallel; the first
+ * successful response wins. Throws if neither responds (or both 404).
+ */
+async function probeIdentity(siteUrl) {
+    const base = siteUrl.replace(/\/+$/, "");
+    const wpUrl = `${base}/wp-json/api-mapper/v1/identity`;
+    const joomlaUrl = `${base}/index.php?option=com_ajax&plugin=apimapper&task=getIdentity&format=json`;
+    const ctrl = new AbortController();
+    const deadline = setTimeout(() => ctrl.abort(), PROBE_TIMEOUT_MS);
+    const fetchOne = async (url, expectPlatform) => {
+        const r = await fetch(url, { signal: ctrl.signal });
+        if (!r.ok)
+            throw new Error(`${expectPlatform} probe HTTP ${r.status}`);
+        const raw = (await r.json());
+        // Joomla wraps in {success, data}; WP returns the payload directly.
+        const body = expectPlatform === "joomla" && raw && typeof raw === "object" && "data" in raw
+            ? raw.data
+            : raw;
+        return {
+            platform: expectPlatform,
+            siteurl: typeof body.siteurl === "string" ? body.siteurl : base,
+            plugin_version: typeof body.plugin_version === "string" ? body.plugin_version : "unknown",
+        };
+    };
+    try {
+        return await Promise.any([
+            fetchOne(wpUrl, "wordpress"),
+            fetchOne(joomlaUrl, "joomla"),
+        ]);
+    }
+    catch (err) {
+        if (err instanceof AggregateError) {
+            const messages = err.errors.map((e) => e instanceof Error ? e.message : String(e));
+            throw new Error(`Identity probe failed (no WP or Joomla endpoint responded): ${messages.join("; ")}`);
+        }
+        throw err;
+    }
+    finally {
+        clearTimeout(deadline);
+    }
+}
+// ── default @clack/prompts driver ───────────────────────────────────────
+function bail(value, errStream) {
+    if (isCancel(value)) {
+        cancel("Setup cancelled. No config files were written.");
+        errStream("Setup cancelled by user.");
+        return null;
+    }
+    return value;
+}
+async function defaultPromptDriver(input) {
+    intro("🔌 Welcome to API Mapper MCP setup");
+    // 1. token
+    const tokenAns = await text({
+        message: "Paste your MCP key",
+        placeholder: "amk_live_…",
+        validate: (v) => typeof v === "string" && /^amk_(live|test)_/.test(v)
+            ? undefined
+            : "Must start with amk_live_ or amk_test_",
+    });
+    const token = bail(tokenAns, (s) => process.stderr.write(`${s}\n`));
+    if (token === null)
+        return null;
+    const payload = input.decodeToken(token);
+    if (!payload) {
+        cancel("Could not decode token (malformed payload).");
+        return null;
+    }
+    note([
+        `Key ID:  ${payload.kid}`,
+        `Issuer:  ${payload.iss}`,
+        `Scope:   ${payload.scope.join(", ") || "<none>"}`,
+    ].join("\n"), "Token payload");
+    // 2. site URL
+    const siteAns = await text({
+        message: "Site URL",
+        placeholder: "https://example.com",
+        initialValue: payload.iss,
+        validate: (v) => typeof v === "string" && /^https?:\/\//.test(v)
+            ? undefined
+            : "Must be a fully-qualified URL",
+    });
+    const siteUrl = bail(siteAns, (s) => process.stderr.write(`${s}\n`));
+    if (siteUrl === null)
+        return null;
+    // 3. profile name
+    const profileAns = await text({
+        message: "Profile name (for switching between sites)",
+        initialValue: "default",
+        validate: (v) => typeof v === "string" && /^[a-zA-Z0-9_-]+$/.test(v)
+            ? undefined
+            : "Use letters, digits, dashes, or underscores only",
+    });
+    const profileName = bail(profileAns, (s) => process.stderr.write(`${s}\n`));
+    if (profileName === null)
+        return null;
+    // 4. client selection
+    const clientAns = await multiselect({
+        message: "Which AI clients to wire up?",
+        options: input.detected.map((c) => ({
+            value: c.id,
+            label: `${c.label}${c.installed ? "" : " (not detected)"}`,
+        })),
+        required: true,
+    });
+    const selectedClients = bail(clientAns, (s) => process.stderr.write(`${s}\n`));
+    if (selectedClients === null)
+        return null;
+    // 5. identity confirmation gate (defer the actual confirm until after
+    // identity probe in the wizard body — see runWizard).
+    return {
+        token,
+        siteUrl,
+        profileName,
+        selectedClients,
+        confirmIdentity: true,
+    };
+}
+// ── wizard ──────────────────────────────────────────────────────────────
+const DEFAULT_DEPS = {
+    prompt: defaultPromptDriver,
+    detectClients: () => defaultDetectClients(),
+    probeIdentity,
+    writeJsonConfig: (p, k, e) => defaultWriteJsonConfig(p, k, e),
+    writeTomlConfig: (p, k, e) => defaultWriteTomlConfig(p, k, e),
+    probeHandshake: (o) => defaultProbeHandshake(o),
+};
+export async function runWizard(deps = DEFAULT_DEPS) {
+    const log = deps.log ?? ((line) => process.stderr.write(`${line}\n`));
+    // 1. Detect installed clients.
+    const detected = await deps.detectClients();
+    // 2. Collect answers via the prompt driver.
+    const answers = await deps.prompt({ detected, decodeToken });
+    if (!answers)
+        return 130; // standard "user cancelled" exit code
+    // 3. Re-decode token (defence in depth — drivers may not have done it).
+    const payload = decodeToken(answers.token);
+    if (!payload) {
+        log("Invalid MCP key — could not decode payload.");
+        return 1;
+    }
+    // 4. Probe identity (with a visible spinner in the default UI).
+    let identity;
+    const spin = deps.log === undefined
+        ? spinner()
+        : { start: () => { }, stop: (_msg) => { } };
+    try {
+        spin.start("Probing site for API Mapper plugin…");
+        identity = await deps.probeIdentity(answers.siteUrl);
+        spin.stop(`Detected ${identity.platform} (plugin v${identity.plugin_version})`);
+    }
+    catch (err) {
+        spin.stop("Identity probe failed");
+        log(`Could not reach ${answers.siteUrl}: ${err instanceof Error ? err.message : String(err)}`);
+        return 2;
+    }
+    // 5. Write configs to selected clients.
+    const undos = [];
+    const selectedDef = new Set(answers.selectedClients);
+    const entry = {
+        command: "npx",
+        args: ["-y", "@wootsup/mcp@latest"],
+        env: { APIMAPPER_PROFILE: answers.profileName },
+    };
+    for (const client of detected) {
+        if (!selectedDef.has(client.id))
+            continue;
+        try {
+            const writer = client.format === "toml"
+                ? deps.writeTomlConfig
+                : deps.writeJsonConfig;
+            const res = await writer(client.configPath, "apimapper", entry);
+            if (res.added) {
+                undos.push(res.undo);
+                log(`✓ ${client.label}: config written (${client.configPath})`);
+            }
+            else {
+                log(`! ${client.label}: existing unmanaged entry found — left untouched`);
+            }
+        }
+        catch (err) {
+            log(`✗ ${client.label}: write failed: ${err instanceof Error ? err.message : String(err)}`);
+            await rollbackAll(undos);
+            return 3;
+        }
+    }
+    if (undos.length === 0) {
+        log("No client configs were written.");
+        return 4;
+    }
+    // 6. Post-write probe — spawn the new MCP via stdio and verify the
+    // health tool is registered.
+    const probe = await deps.probeHandshake({
+        command: entry.command,
+        args: entry.args,
+        env: entry.env,
+    });
+    if (!probe.ok) {
+        log(`MCP handshake failed: ${probe.error ?? "unknown error"}`);
+        await rollbackAll(undos);
+        return 5;
+    }
+    outro(`🎉 Setup complete (${undos.length} client${undos.length === 1 ? "" : "s"} wired). ` +
+        "Restart your AI client and try: \"What MCP tools do I have?\"");
+    return 0;
+}
+// ── CLI dispatcher ──────────────────────────────────────────────────────
+export async function runCli(argv, deps) {
+    const installSkill = deps?.installSkill ?? defaultInstallSkill;
+    const wizard = deps?.runWizard ?? (() => runWizard());
+    const [subcommand] = argv;
+    // Default subcommand (no args, or `setup`) runs the wizard.
+    if (!subcommand || subcommand === "setup") {
+        return wizard();
+    }
+    switch (subcommand) {
+        case "install-skill":
+        case "install": {
+            try {
+                const result = await installSkill();
+                if (result.markerAlreadyPresent) {
+                    console.log("apimapper-mcp: skill refreshed (marker already in AGENTS.md).");
+                }
+                else {
+                    console.log("apimapper-mcp: skill installed + AGENTS.md updated.");
+                }
+                return 0;
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(`apimapper-mcp: install-skill failed: ${msg}`);
+                return 2;
+            }
+        }
+        case "--help":
+        case "-h":
+        case "help": {
+            console.log(HELP_TEXT);
+            return 0;
+        }
+        default: {
+            console.error(`apimapper-mcp: unknown command "${subcommand}".`);
+            console.error(HELP_TEXT);
+            return 1;
+        }
+    }
+}
+// Direct CLI entry — only run main() when this file is invoked, not when
+// it's imported from tests.
+const isMain = typeof process !== "undefined" &&
+    process.argv[1] &&
+    // Resolve __filename without relying on commonjs globals.
+    import.meta.url === `file://${process.argv[1]}`;
+if (isMain) {
+    runCli(process.argv.slice(2)).then((code) => process.exit(code), (err) => {
+        console.error("apimapper-mcp: fatal error:", err);
+        process.exit(99);
+    });
+}
+//# sourceMappingURL=setup-cli.js.map

package/dist/setup-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-cli.js","sourceRoot":"","sources":["../src/setup-cli.ts"],"names":[],"mappings":"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"}

package/dist/skill-instructions.d.ts

@@ -0,0 +1,10 @@
+export declare const FALLBACK_INSTRUCTIONS = "Use this MCP to manage API Mapper flows, connections, and sources across WordPress + Joomla.";
+/**
+ * Loads MCP server instructions from skills/apimapper/SKILL.md.
+ *
+ * @param rootDir - Override the package root directory (used by tests).
+ *                  Defaults to the directory two levels up from this file
+ *                  (i.e. the package root), so that `skills/apimapper/SKILL.md`
+ *                  resolves correctly both in dev (src/) and in build (dist/).
+ */
+export declare function loadSkillInstructions(rootDir?: string): string;