@macula-io/mcp 0.3.0

package/dist/bin/uninstall.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+// macula-mcp uninstall — remove the `macula` entry from every
+// detected MCP client's config. Idempotent.
+//
+// Does NOT remove the macula-cli binary or its persisted identity
+// (see macula-cli's own uninstall.sh/uninstall.ps1 for that). The
+// MCP integration is the only thing this command touches.
+import { ALL, detected } from "../install/mcp_clients/index.js";
+const VERSION = "0.3.0";
+function parseArgs(argv) {
+    const a = { all: false, help: false };
+    for (const arg of argv) {
+        if (arg === "--help" || arg === "-h")
+            a.help = true;
+        else if (arg === "--all")
+            a.all = true;
+        else {
+            console.error(`[macula-mcp uninstall] unknown flag: ${arg}`);
+            process.exit(1);
+        }
+    }
+    return a;
+}
+function help() {
+    console.log(`macula-mcp uninstall ${VERSION}
+
+Usage: npx @macula-io/mcp uninstall [--all]
+
+Removes the 'macula' MCP server entry from every detected MCP
+client's config. The macula-cli binary and your persisted identity
+are NOT touched.
+
+Flags:
+  --all     Touch every supported client config, not just those whose
+            install directories are present. Use this if you uninstalled
+            an editor but want to clean up its config file.
+  --help, -h
+`);
+}
+function info(msg) {
+    console.log(`[macula-mcp uninstall]   ${msg}`);
+}
+function ok(msg) {
+    console.log(`[macula-mcp uninstall] ✓ ${msg}`);
+}
+function err(msg) {
+    console.error(`[macula-mcp uninstall] ✗ ${msg}`);
+}
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.help) {
+        help();
+        return;
+    }
+    const targets = args.all ? ALL : detected();
+    if (targets.length === 0) {
+        ok("no MCP clients detected; nothing to do.");
+        return;
+    }
+    info(`targets: ${targets.map((c) => c.CLIENT_LABEL).join(", ")}`);
+    for (const client of targets) {
+        await uninstallOne(client);
+    }
+    ok("done.");
+}
+async function uninstallOne(c) {
+    try {
+        const result = await c.uninstall();
+        info(`${c.CLIENT_LABEL}: ${result.message} (${result.configPath})`);
+        if (result.backupPath)
+            info(`  backup: ${result.backupPath}`);
+    }
+    catch (e) {
+        err(`${c.CLIENT_LABEL}: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}
+main().catch((e) => {
+    err(`fatal: ${e instanceof Error ? e.stack ?? e.message : String(e)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=uninstall.js.map

package/dist/bin/uninstall.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+// macula-mcp — a Model Context Protocol server that exposes the Macula mesh to
+// any agent harness (Claude Code, Cursor, Cline, Continue, ...).
+//
+// Topology: thin client. macula-mcp speaks MCP over stdio to the agent, and
+// shells out to macula-cli (macula-io/macula-cli), a one-shot scriptable CLI
+// built directly on macula-go-sdk. macula-mcp owns no mesh logic of its
+// own -- macula-cli does the QUIC handshake/call/publish/watch/content
+// transfer as a subprocess per tool call.
+//
+//   agent harness  --MCP/stdio-->  macula-mcp  --spawns, parses stdout-->  macula-cli  --QUIC-->  mesh
+//
+// Reworked 2026-08-29 from a hecate-daemon-backed design (HTTP over a
+// local Unix socket) to this one: hecate-daemon is a leftover of an
+// abandoned local browser/UI plan and is no longer something this server
+// should depend on. This is a deliberately LEAN rework, not a like-for-
+// like swap -- macula-cli is a one-shot process with no daemon and no
+// storage, so standing subscriptions, an activity/inbox audit log, and
+// peer listing don't carry over; mesh_watch (bounded, synchronous)
+// replaces the old subscribe/unsubscribe/subscriptions/inbox quartet.
+// See macula-io/macula-cli's own project memory for the fuller tradeoff.
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerIdentity } from "./mesh_identity.js";
+import { registerMeshCall } from "./mesh_call.js";
+import { registerMeshArtifact } from "./mesh_artifact.js";
+import { registerMeshPublish } from "./mesh_publish.js";
+import { registerMeshWatch } from "./mesh_watch.js";
+const server = new McpServer({
+    name: "macula-mcp",
+    version: "0.3.0",
+});
+// Resources — read-only context an agent should consult before acting.
+registerIdentity(server);
+// Tools — actions, each a one-shot macula-cli subprocess call.
+registerMeshCall(server);
+registerMeshArtifact(server);
+registerMeshPublish(server);
+registerMeshWatch(server);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // stderr is safe; stdout is the MCP channel.
+    console.error("macula-mcp ready (stdio)");
+}
+main().catch((err) => {
+    console.error("macula-mcp fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,+EAA+E;AAC/E,iEAAiE;AACjE,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,wEAAwE;AACxE,uEAAuE;AACvE,0CAA0C;AAC1C,EAAE;AACF,uGAAuG;AACvG,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,yEAAyE;AACzE,wEAAwE;AACxE,sEAAsE;AACtE,uEAAuE;AACvE,mEAAmE;AACnE,sEAAsE;AACtE,yEAAyE;AAEzE,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,uEAAuE;AACvE,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAEzB,+DAA+D;AAC/D,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACzB,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAE1B,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,6CAA6C;IAC7C,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;AAC5C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/install/config_merge.d.ts

@@ -0,0 +1,24 @@
+export interface McpServerEntry {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export type MergeOutcome = "added" | "replaced" | "unchanged" | "skipped_conflict";
+export interface MergeResult {
+    outcome: MergeOutcome;
+    configPath: string;
+    backupPath?: string;
+    message: string;
+}
+/**
+ * Merge a single mcpServers entry into the config at `path`, under
+ * the top-level key `mcpServers` (the standard for Claude Code /
+ * Cursor / Windsurf). Idempotent + safe-merge.
+ */
+export declare function mergeMcpServer(path: string, name: string, entry: McpServerEntry, opts?: {
+    force?: boolean;
+}): Promise<MergeResult>;
+/**
+ * Remove a single mcpServers entry. Idempotent.
+ */
+export declare function removeMcpServer(path: string, name: string): Promise<MergeResult>;

package/dist/install/config_merge.js

@@ -0,0 +1,141 @@
+// Safe JSON-config merge for MCP-client configs.
+//
+// MCP clients store config as JSON files with a top-level shape like
+// `{ "mcpServers": { "<name>": { command, args, env? } } }` (Claude
+// Code / Cursor / Windsurf style) or a vendor-specific variant. This
+// utility:
+//
+//   * preserves existing entries (never overwrites unrelated servers)
+//   * writes a timestamped backup before any change
+//   * is idempotent: a re-run with the same entry is a no-op
+//   * never produces malformed JSON: parse-fail aborts with a clear
+//     remediation path
+//
+// The actual per-client write happens in `mcp_clients/<name>.ts`; this
+// module owns the JSON-handling primitives they all share.
+import { readFile, writeFile, mkdir, stat, copyFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { dirname } from "node:path";
+/**
+ * Read the JSON config at `path`. If absent, returns an empty object.
+ * If present but malformed, throws — never returns a partially-parsed
+ * value (callers can decide whether to abort or copy-aside and
+ * re-create).
+ */
+async function readConfig(path) {
+    if (!existsSync(path))
+        return {};
+    const raw = await readFile(path, "utf8");
+    if (raw.trim().length === 0)
+        return {};
+    try {
+        return JSON.parse(raw);
+    }
+    catch (e) {
+        throw new Error(`existing config at ${path} is not valid JSON. ` +
+            `Refusing to overwrite. Fix it manually or remove the file and re-run. ` +
+            `(parser said: ${e instanceof Error ? e.message : String(e)})`);
+    }
+}
+/**
+ * Write a backup copy alongside the original, named with a timestamp.
+ * Skipped if the file doesn't exist (nothing to back up).
+ */
+async function backup(path) {
+    if (!existsSync(path))
+        return undefined;
+    const ts = new Date().toISOString().replace(/[:.]/g, "-");
+    const bak = `${path}.macula-bak-${ts}`;
+    await copyFile(path, bak);
+    return bak;
+}
+/**
+ * Merge a single mcpServers entry into the config at `path`, under
+ * the top-level key `mcpServers` (the standard for Claude Code /
+ * Cursor / Windsurf). Idempotent + safe-merge.
+ */
+export async function mergeMcpServer(path, name, entry, opts = {}) {
+    const existing = await readConfig(path);
+    const servers = existing.mcpServers ?? {};
+    const current = servers[name];
+    if (current && deepEqual(current, entry)) {
+        return {
+            outcome: "unchanged",
+            configPath: path,
+            message: `entry '${name}' already present and matches; no-op`,
+        };
+    }
+    if (current && !opts.force) {
+        return {
+            outcome: "skipped_conflict",
+            configPath: path,
+            message: `entry '${name}' already present with different settings. ` +
+                `Re-run with --force to replace, or remove the entry manually.`,
+        };
+    }
+    const next = {
+        ...existing,
+        mcpServers: { ...servers, [name]: entry },
+    };
+    const bak = await backup(path);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, JSON.stringify(next, null, 2) + "\n", "utf8");
+    return {
+        outcome: current ? "replaced" : "added",
+        configPath: path,
+        backupPath: bak,
+        message: current ? "replaced existing entry" : "added entry",
+    };
+}
+/**
+ * Remove a single mcpServers entry. Idempotent.
+ */
+export async function removeMcpServer(path, name) {
+    if (!existsSync(path)) {
+        return {
+            outcome: "unchanged",
+            configPath: path,
+            message: "config does not exist; nothing to remove",
+        };
+    }
+    const existing = await readConfig(path);
+    const servers = existing.mcpServers ?? {};
+    if (!(name in servers)) {
+        return {
+            outcome: "unchanged",
+            configPath: path,
+            message: `entry '${name}' not present; no-op`,
+        };
+    }
+    const { [name]: _removed, ...rest } = servers;
+    const next = { ...existing, mcpServers: rest };
+    const bak = await backup(path);
+    await writeFile(path, JSON.stringify(next, null, 2) + "\n", "utf8");
+    return {
+        outcome: "replaced",
+        configPath: path,
+        backupPath: bak,
+        message: `removed entry '${name}'`,
+    };
+}
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== "object" || typeof b !== "object" || a === null || b === null)
+        return false;
+    const ka = Object.keys(a).sort();
+    const kb = Object.keys(b).sort();
+    if (ka.length !== kb.length)
+        return false;
+    for (let i = 0; i < ka.length; i++)
+        if (ka[i] !== kb[i])
+            return false;
+    for (const k of ka) {
+        if (!deepEqual(a[k], b[k]))
+            return false;
+    }
+    return true;
+}
+// Silence unused-warning for object-destructure rest pattern above.
+void stat;
+//# sourceMappingURL=config_merge.js.map

package/dist/install/config_merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config_merge.js","sourceRoot":"","sources":["../../src/install/config_merge.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,qEAAqE;AACrE,oEAAoE;AACpE,qEAAqE;AACrE,WAAW;AACX,EAAE;AACF,sEAAsE;AACtE,oDAAoD;AACpD,6DAA6D;AAC7D,oEAAoE;AACpE,uBAAuB;AACvB,EAAE;AACF,uEAAuE;AACvE,2DAA2D;AAE3D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC;;;;;GAKG;AACH,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;IACpD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,sBAAsB,IAAI,sBAAsB;YAC9C,wEAAwE;YACxE,iBAAiB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CACjE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,GAAG,IAAI,eAAe,EAAE,EAAE,CAAC;IACvC,MAAM,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1B,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,IAAY,EACZ,KAAqB,EACrB,OAA4B,EAAE;IAE9B,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,OAAO,GAAI,QAAQ,CAAC,UAA6C,IAAI,EAAE,CAAC;IAC9E,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,IAAI,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO;YACL,OAAO,EAAE,WAAW;YACpB,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,UAAU,IAAI,sCAAsC;SAC9D,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,kBAAkB;YAC3B,UAAU,EAAE,IAAI;YAChB,OAAO,EACL,UAAU,IAAI,6CAA6C;gBAC3D,+DAA+D;SAClE,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG;QACX,GAAG,QAAQ;QACX,UAAU,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE;KAC1C,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAEpE,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO;QACvC,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,GAAG;QACf,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,aAAa;KAC7D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,IAAY;IAEZ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,WAAW;YACpB,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,0CAA0C;SACpD,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,OAAO,GAAI,QAAQ,CAAC,UAA6C,IAAI,EAAE,CAAC;IAC9E,IAAI,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE,WAAW;YACpB,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,UAAU,IAAI,sBAAsB;SAC9C,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAC9C,MAAM,IAAI,GAAG,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAC/C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IACpE,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,GAAG;QACf,OAAO,EAAE,kBAAkB,IAAI,GAAG;KACnC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,CAAU,EAAE,CAAU;IACvC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC7F,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAW,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAW,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,IAAI,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IACtE,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,CAAE,CAA6B,CAAC,CAAC,CAAC,EAAG,CAA6B,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IACrG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oEAAoE;AACpE,KAAK,IAAI,CAAC"}

package/dist/install/existing_cli.d.ts

@@ -0,0 +1,6 @@
+export interface CliProbe {
+    available: boolean;
+    nodeId?: string;
+    reason?: string;
+}
+export declare function probe(): Promise<CliProbe>;

package/dist/install/existing_cli.js

@@ -0,0 +1,24 @@
+// Probe for an installed macula-cli binary.
+//
+// The installer's primary check: macula-mcp shells out to macula-cli for
+// every mesh operation (src/macula_cli.ts), so there's nothing to
+// register in an MCP client's config that will actually work without it
+// on PATH first. `macula-cli identity` is purely local -- no network, no
+// station -- so it's a clean "is this binary present and functional"
+// probe, not a mesh connectivity check.
+import { identity, MaculaCliUnavailable } from "../macula_cli.js";
+export async function probe() {
+    try {
+        const id = await identity();
+        return { available: true, nodeId: id.node_id };
+    }
+    catch (e) {
+        const reason = e instanceof MaculaCliUnavailable
+            ? e.message
+            : e instanceof Error
+                ? e.message
+                : String(e);
+        return { available: false, reason };
+    }
+}
+//# sourceMappingURL=existing_cli.js.map

package/dist/install/existing_cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"existing_cli.js","sourceRoot":"","sources":["../../src/install/existing_cli.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,EAAE;AACF,yEAAyE;AACzE,kEAAkE;AAClE,wEAAwE;AACxE,yEAAyE;AACzE,qEAAqE;AACrE,wCAAwC;AAExC,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAQlE,MAAM,CAAC,KAAK,UAAU,KAAK;IACzB,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,MAAM,GACV,CAAC,YAAY,oBAAoB;YAC/B,CAAC,CAAC,CAAC,CAAC,OAAO;YACX,CAAC,CAAC,CAAC,YAAY,KAAK;gBAClB,CAAC,CAAC,CAAC,CAAC,OAAO;gBACX,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAClB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/install/mcp_clients/claude_code.d.ts

@@ -0,0 +1,7 @@
+import { type MergeResult } from "../config_merge.js";
+export declare const CLIENT_ID = "claude-code";
+export declare const CLIENT_LABEL = "Claude Code";
+export declare function configPath(): string;
+export declare function isInstalled(): boolean;
+export declare function install(): Promise<MergeResult>;
+export declare function uninstall(): Promise<MergeResult>;

package/dist/install/mcp_clients/claude_code.js

@@ -0,0 +1,51 @@
+// Claude Code MCP client integration.
+//
+// Config path: ~/.claude/mcp.json (global) AND/OR project-local
+// .mcp.json. MVP writes the global file only; project-local is the
+// user's choice on a per-repo basis.
+//
+// Entry format (Claude Code's spec):
+//   {
+//     "mcpServers": {
+//       "macula": {
+//         "command": "npx",
+//         "args": ["-y", "-p", "@macula-io/mcp", "macula-mcp"]
+//       }
+//     }
+//   }
+//
+// The extra "-p @macula-io/mcp macula-mcp" (rather than bare "npx -y
+// @macula-io/mcp") is load-bearing, not decoration: this package
+// publishes FOUR bin entries (macula-mcp, macula-mcp-install,
+// macula-mcp-uninstall, macula-mcp-status), none of which is literally
+// "mcp" -- npx's default "run the bin matching the package's own short
+// name" heuristic has nothing to match and fails outright with "could
+// not determine executable to run". Confirmed live packing a real
+// tarball and running bare `npx -y <tarball>` before finding this --
+// `-p <pkg> <bin>` names the executable explicitly and works.
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+import { mergeMcpServer, removeMcpServer, } from "../config_merge.js";
+export const CLIENT_ID = "claude-code";
+export const CLIENT_LABEL = "Claude Code";
+export function configPath() {
+    return join(homedir(), ".claude", "mcp.json");
+}
+export function isInstalled() {
+    // Claude Code installs at ~/.claude — presence of that directory
+    // (or any of the canonical files) is a strong-enough signal for
+    // MVP. False positives are harmless (we just write a config file
+    // the client can pick up later).
+    return existsSync(join(homedir(), ".claude"));
+}
+export async function install() {
+    return mergeMcpServer(configPath(), "macula", {
+        command: "npx",
+        args: ["-y", "-p", "@macula-io/mcp", "macula-mcp"],
+    });
+}
+export async function uninstall() {
+    return removeMcpServer(configPath(), "macula");
+}
+//# sourceMappingURL=claude_code.js.map

package/dist/install/mcp_clients/claude_code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude_code.js","sourceRoot":"","sources":["../../../src/install/mcp_clients/claude_code.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,gEAAgE;AAChE,mEAAmE;AACnE,qCAAqC;AACrC,EAAE;AACF,qCAAqC;AACrC,MAAM;AACN,sBAAsB;AACtB,oBAAoB;AACpB,4BAA4B;AAC5B,+DAA+D;AAC/D,UAAU;AACV,QAAQ;AACR,MAAM;AACN,EAAE;AACF,qEAAqE;AACrE,iEAAiE;AACjE,8DAA8D;AAC9D,uEAAuE;AACvE,uEAAuE;AACvE,sEAAsE;AACtE,kEAAkE;AAClE,qEAAqE;AACrE,8DAA8D;AAE9D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EACL,cAAc,EACd,eAAe,GAEhB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,MAAM,SAAS,GAAG,aAAa,CAAC;AACvC,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;AAE1C,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,iEAAiE;IACjE,gEAAgE;IAChE,iEAAiE;IACjE,iCAAiC;IACjC,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,OAAO,cAAc,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE;QAC5C,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,YAAY,CAAC;KACnD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,OAAO,eAAe,CAAC,UAAU,EAAE,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC"}

package/dist/install/mcp_clients/claude_desktop.d.ts

@@ -0,0 +1,7 @@
+import { type MergeResult } from "../config_merge.js";
+export declare const CLIENT_ID = "claude-desktop";
+export declare const CLIENT_LABEL = "Claude Desktop";
+export declare function configPath(): string;
+export declare function isInstalled(): boolean;
+export declare function install(): Promise<MergeResult>;
+export declare function uninstall(): Promise<MergeResult>;

package/dist/install/mcp_clients/claude_desktop.js

@@ -0,0 +1,40 @@
+// Claude Desktop MCP client integration.
+//
+// Config paths vary by OS:
+//   macOS:   ~/Library/Application Support/Claude/claude_desktop_config.json
+//   Linux:   ~/.config/Claude/claude_desktop_config.json
+//   Windows: %APPDATA%\Claude\claude_desktop_config.json
+//
+// Schema is the same JSON shape as Claude Code:
+//   { "mcpServers": { "macula": { "command": ..., "args": ... } } }
+import { homedir, platform } from "node:os";
+import { join, dirname } from "node:path";
+import { existsSync } from "node:fs";
+import { mergeMcpServer, removeMcpServer, } from "../config_merge.js";
+export const CLIENT_ID = "claude-desktop";
+export const CLIENT_LABEL = "Claude Desktop";
+export function configPath() {
+    const p = platform();
+    if (p === "darwin") {
+        return join(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
+    }
+    if (p === "win32") {
+        const appData = process.env.APPDATA ?? join(homedir(), "AppData", "Roaming");
+        return join(appData, "Claude", "claude_desktop_config.json");
+    }
+    // linux + everything else
+    return join(homedir(), ".config", "Claude", "claude_desktop_config.json");
+}
+export function isInstalled() {
+    return existsSync(dirname(configPath()));
+}
+export async function install() {
+    return mergeMcpServer(configPath(), "macula", {
+        command: "npx",
+        args: ["-y", "-p", "@macula-io/mcp", "macula-mcp"],
+    });
+}
+export async function uninstall() {
+    return removeMcpServer(configPath(), "macula");
+}
+//# sourceMappingURL=claude_desktop.js.map

package/dist/install/mcp_clients/claude_desktop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude_desktop.js","sourceRoot":"","sources":["../../../src/install/mcp_clients/claude_desktop.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,2BAA2B;AAC3B,6EAA6E;AAC7E,yDAAyD;AACzD,yDAAyD;AACzD,EAAE;AACF,gDAAgD;AAChD,oEAAoE;AAEpE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EACL,cAAc,EACd,eAAe,GAEhB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,MAAM,SAAS,GAAG,gBAAgB,CAAC;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE7C,MAAM,UAAU,UAAU;IACxB,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC;IACrB,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QACnB,OAAO,IAAI,CACT,OAAO,EAAE,EACT,SAAS,EACT,qBAAqB,EACrB,QAAQ,EACR,4BAA4B,CAC7B,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAC7E,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,4BAA4B,CAAC,CAAC;IAC/D,CAAC;IACD,0BAA0B;IAC1B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,4BAA4B,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,UAAU,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,OAAO,cAAc,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE;QAC5C,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,YAAY,CAAC;KACnD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,OAAO,eAAe,CAAC,UAAU,EAAE,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC"}

package/dist/install/mcp_clients/cursor.d.ts

@@ -0,0 +1,7 @@
+import { type MergeResult } from "../config_merge.js";
+export declare const CLIENT_ID = "cursor";
+export declare const CLIENT_LABEL = "Cursor";
+export declare function configPath(): string;
+export declare function isInstalled(): boolean;
+export declare function install(): Promise<MergeResult>;
+export declare function uninstall(): Promise<MergeResult>;

package/dist/install/mcp_clients/cursor.js

@@ -0,0 +1,30 @@
+// Cursor MCP client integration.
+//
+// Config path: ~/.cursor/mcp.json
+// Schema: same { mcpServers: { ... } } as Claude Code.
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+import { mergeMcpServer, removeMcpServer, } from "../config_merge.js";
+export const CLIENT_ID = "cursor";
+export const CLIENT_LABEL = "Cursor";
+export function configPath() {
+    return join(homedir(), ".cursor", "mcp.json");
+}
+export function isInstalled() {
+    return existsSync(join(homedir(), ".cursor"));
+}
+export async function install() {
+    // "-p <pkg> <bin>", not bare "npx -y @macula-io/mcp": this package
+    // has 4 bin entries and none is literally "mcp", so npx's default
+    // heuristic can't pick one -- see claude_code.ts's doc comment for
+    // the full story (found running a real packed tarball through npx).
+    return mergeMcpServer(configPath(), "macula", {
+        command: "npx",
+        args: ["-y", "-p", "@macula-io/mcp", "macula-mcp"],
+    });
+}
+export async function uninstall() {
+    return removeMcpServer(configPath(), "macula");
+}
+//# sourceMappingURL=cursor.js.map

package/dist/install/mcp_clients/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../../src/install/mcp_clients/cursor.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,kCAAkC;AAClC,uDAAuD;AAEvD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EACL,cAAc,EACd,eAAe,GAEhB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC;AAClC,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AAErC,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,mEAAmE;IACnE,kEAAkE;IAClE,mEAAmE;IACnE,oEAAoE;IACpE,OAAO,cAAc,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE;QAC5C,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,YAAY,CAAC;KACnD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,OAAO,eAAe,CAAC,UAAU,EAAE,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC"}

package/dist/install/mcp_clients/index.d.ts

@@ -0,0 +1,11 @@
+import type { MergeResult } from "../config_merge.js";
+export interface ClientAdapter {
+    CLIENT_ID: string;
+    CLIENT_LABEL: string;
+    configPath: () => string;
+    isInstalled: () => boolean;
+    install: () => Promise<MergeResult>;
+    uninstall: () => Promise<MergeResult>;
+}
+export declare const ALL: ClientAdapter[];
+export declare function detected(): ClientAdapter[];

package/dist/install/mcp_clients/index.js

@@ -0,0 +1,12 @@
+// Registry of supported MCP clients. Used by bin/install,
+// bin/uninstall, and bin/status to iterate over the install matrix
+// without each command knowing about every client.
+import * as claudeCode from "./claude_code.js";
+import * as claudeDesktop from "./claude_desktop.js";
+import * as cursor from "./cursor.js";
+import * as windsurf from "./windsurf.js";
+export const ALL = [claudeCode, claudeDesktop, cursor, windsurf];
+export function detected() {
+    return ALL.filter((c) => c.isInstalled());
+}
+//# sourceMappingURL=index.js.map

package/dist/install/mcp_clients/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/install/mcp_clients/index.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,mEAAmE;AACnE,mDAAmD;AAEnD,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAY1C,MAAM,CAAC,MAAM,GAAG,GAAoB,CAAC,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAElF,MAAM,UAAU,QAAQ;IACtB,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/dist/install/mcp_clients/windsurf.d.ts

@@ -0,0 +1,7 @@
+import { type MergeResult } from "../config_merge.js";
+export declare const CLIENT_ID = "windsurf";
+export declare const CLIENT_LABEL = "Windsurf";
+export declare function configPath(): string;
+export declare function isInstalled(): boolean;
+export declare function install(): Promise<MergeResult>;
+export declare function uninstall(): Promise<MergeResult>;

package/dist/install/mcp_clients/windsurf.js

@@ -0,0 +1,30 @@
+// Windsurf MCP client integration.
+//
+// Config path: ~/.codeium/windsurf/mcp_config.json
+// Schema: same { mcpServers: { ... } } as Claude Code.
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+import { mergeMcpServer, removeMcpServer, } from "../config_merge.js";
+export const CLIENT_ID = "windsurf";
+export const CLIENT_LABEL = "Windsurf";
+export function configPath() {
+    return join(homedir(), ".codeium", "windsurf", "mcp_config.json");
+}
+export function isInstalled() {
+    return existsSync(join(homedir(), ".codeium", "windsurf"));
+}
+export async function install() {
+    // "-p <pkg> <bin>", not bare "npx -y @macula-io/mcp": this package
+    // has 4 bin entries and none is literally "mcp", so npx's default
+    // heuristic can't pick one -- see claude_code.ts's doc comment for
+    // the full story (found running a real packed tarball through npx).
+    return mergeMcpServer(configPath(), "macula", {
+        command: "npx",
+        args: ["-y", "-p", "@macula-io/mcp", "macula-mcp"],
+    });
+}
+export async function uninstall() {
+    return removeMcpServer(configPath(), "macula");
+}
+//# sourceMappingURL=windsurf.js.map

package/dist/install/mcp_clients/windsurf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.js","sourceRoot":"","sources":["../../../src/install/mcp_clients/windsurf.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,EAAE;AACF,mDAAmD;AACnD,uDAAuD;AAEvD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EACL,cAAc,EACd,eAAe,GAEhB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC;AACpC,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AAEvC,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,mEAAmE;IACnE,kEAAkE;IAClE,mEAAmE;IACnE,oEAAoE;IACpE,OAAO,cAAc,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE;QAC5C,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,YAAY,CAAC;KACnD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,OAAO,eAAe,CAAC,UAAU,EAAE,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC"}

package/dist/install/platform.d.ts

@@ -0,0 +1,9 @@
+export type OS = "linux" | "darwin" | "win32";
+export type Arch = "x64" | "arm64";
+export interface PlatformInfo {
+    os: OS;
+    arch: Arch;
+    /** Human-readable label used in install output. */
+    label: string;
+}
+export declare function detect(): PlatformInfo;

package/dist/install/platform.js

@@ -0,0 +1,34 @@
+// Platform detection for the installer. Used to pick MCP-client
+// config paths, which vary per OS. macula-cli's own install.sh/
+// install.ps1 handle platform detection for fetching that binary --
+// not this installer's job.
+import { platform, arch } from "node:os";
+export function detect() {
+    const rawOs = platform();
+    const rawArch = arch();
+    const os = mapOs(rawOs);
+    const cpu = mapArch(rawArch);
+    return {
+        os,
+        arch: cpu,
+        label: `${os}-${cpu}`,
+    };
+}
+function mapOs(p) {
+    if (p === "linux")
+        return "linux";
+    if (p === "darwin")
+        return "darwin";
+    if (p === "win32")
+        return "win32";
+    throw new Error(`unsupported platform: ${p}. Macula supports linux, darwin, win32. ` +
+        `File an issue at codeberg.org/macula-io/macula-mcp if you need ${p}.`);
+}
+function mapArch(a) {
+    if (a === "x64")
+        return "x64";
+    if (a === "arm64")
+        return "arm64";
+    throw new Error(`unsupported arch: ${a}. Macula supports x64 and arm64.`);
+}
+//# sourceMappingURL=platform.js.map