@maind-dev/mcp-bridge 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,89 @@
1
+ // Final-report structure for the install sub-command.
2
+ //
3
+ // Every step's outcome lands here. At the end of the run the orchestrator
4
+ // prints a Markdown-table snapshot, decides the exit code, and (optionally)
5
+ // forwards the summary to telemetry.
6
+ export class InstallReport {
7
+ results = [];
8
+ add(result) {
9
+ this.results.push(result);
10
+ }
11
+ results_() {
12
+ return this.results;
13
+ }
14
+ summary() {
15
+ let ok = 0;
16
+ let needsDecision = 0;
17
+ let failed = 0;
18
+ for (const r of this.results) {
19
+ if (r.status === "created" ||
20
+ r.status === "merged" ||
21
+ r.status === "skipped" ||
22
+ r.status === "would-create" ||
23
+ r.status === "would-merge" ||
24
+ r.status === "would-pair")
25
+ ok++;
26
+ else if (r.status === "needs-user-decision")
27
+ needsDecision++;
28
+ else if (r.status === "failed")
29
+ failed++;
30
+ }
31
+ return {
32
+ total: this.results.length,
33
+ ok,
34
+ needsDecision,
35
+ failed,
36
+ };
37
+ }
38
+ hasFailures() {
39
+ return this.results.some((r) => r.status === "failed");
40
+ }
41
+ hasUserDecisionPending() {
42
+ return this.results.some((r) => r.status === "needs-user-decision");
43
+ }
44
+ /**
45
+ * Exit code mapping for the install command:
46
+ * 0 — all OK (everything created/merged/skipped without failure)
47
+ * 1 — partial (at least one failure OR pending user decision); MCP setup
48
+ * likely usable but some target was skipped due to error or unresolved prompt
49
+ * 2 — reserved for fatal pre-flight errors (project-root undecidable, etc.) —
50
+ * set by the orchestrator before any step runs, NOT inferred here.
51
+ */
52
+ exitCode() {
53
+ if (this.hasFailures() || this.hasUserDecisionPending())
54
+ return 1;
55
+ return 0;
56
+ }
57
+ toMarkdownTable() {
58
+ if (this.results.length === 0) {
59
+ return "_no steps were attempted_\n";
60
+ }
61
+ const headers = ["Target", "Action", "Status", "Detail"];
62
+ const targetWidth = Math.max(headers[0].length, ...this.results.map((r) => r.target.length));
63
+ const actionWidth = Math.max(headers[1].length, ...this.results.map((r) => r.action.length));
64
+ const statusWidth = Math.max(headers[2].length, ...this.results.map((r) => r.status.length));
65
+ const detailWidth = Math.max(headers[3].length, ...this.results.map((r) => (r.detail ?? "").length));
66
+ const pad = (s, w) => s + " ".repeat(Math.max(0, w - s.length));
67
+ const sep = `| ${"-".repeat(targetWidth)} | ${"-".repeat(actionWidth)} | ${"-".repeat(statusWidth)} | ${"-".repeat(detailWidth)} |`;
68
+ const lines = [];
69
+ lines.push(`| ${pad(headers[0], targetWidth)} | ${pad(headers[1], actionWidth)} | ${pad(headers[2], statusWidth)} | ${pad(headers[3], detailWidth)} |`);
70
+ lines.push(sep);
71
+ for (const r of this.results) {
72
+ lines.push(`| ${pad(r.target, targetWidth)} | ${pad(r.action, actionWidth)} | ${pad(r.status, statusWidth)} | ${pad(r.detail ?? "", detailWidth)} |`);
73
+ }
74
+ return lines.join("\n") + "\n";
75
+ }
76
+ print(stream) {
77
+ const s = this.summary();
78
+ stream.write("\n");
79
+ stream.write(this.toMarkdownTable());
80
+ stream.write(`\nSummary: ${s.ok}/${s.total} OK · ${s.needsDecision} pending · ${s.failed} failed\n`);
81
+ }
82
+ toJson() {
83
+ return {
84
+ steps: [...this.results],
85
+ summary: this.summary(),
86
+ };
87
+ }
88
+ }
89
+ //# sourceMappingURL=report.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/install/report.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,83 @@
1
+ // Opt-in install telemetry (ADR-009 consent-model + ADR-142).
2
+ //
3
+ // What we send (anonymized aggregates only):
4
+ // - Step counts by status (ok / skipped / failed / needs-decision)
5
+ // - Wall-clock duration
6
+ // - OS family (`darwin` / `win32` / `linux`)
7
+ // - Node major version
8
+ // - Installer (bridge) version
9
+ //
10
+ // What we DON'T send:
11
+ // - File paths
12
+ // - User-id (server can infer from the api-key if it chooses to)
13
+ // - Tokens
14
+ // - PROJECT_ROOT or any project-identifying string
15
+ //
16
+ // Failure is silent — telemetry is best-effort and MUST NOT block the
17
+ // install exit code. We swallow network errors, timeouts, non-2xx.
18
+ const DEFAULT_FUNCTIONS_ORIGIN = "https://vsddmiosisvfrairepxv.supabase.co/functions/v1";
19
+ const TELEMETRY_PATH = "/install-completed";
20
+ const TELEMETRY_TIMEOUT_MS = 3_000;
21
+ export async function postInstallTelemetry(input) {
22
+ if (!input.enabled)
23
+ return;
24
+ if (input.apiKey === null)
25
+ return; // no auth — silent skip
26
+ const origin = (process.env.MAIND_FUNCTIONS_ORIGIN ?? "").trim().replace(/\/+$/, "") ||
27
+ DEFAULT_FUNCTIONS_ORIGIN;
28
+ const url = `${origin}${TELEMETRY_PATH}`;
29
+ const payload = {
30
+ installer_version: input.installerVersion,
31
+ wall_clock_ms: input.wallClockMs,
32
+ os_family: process.platform,
33
+ node_major: parseNodeMajor(process.version),
34
+ summary: {
35
+ total: input.summary.total,
36
+ ok: input.summary.ok,
37
+ needs_decision: input.summary.needsDecision,
38
+ failed: input.summary.failed,
39
+ },
40
+ step_status_counts: countStatuses(input.steps),
41
+ client_family_filter: input.clientFamilyFilter ?? null,
42
+ };
43
+ const controller = new AbortController();
44
+ const t = setTimeout(() => controller.abort(), TELEMETRY_TIMEOUT_MS);
45
+ try {
46
+ await fetch(url, {
47
+ method: "POST",
48
+ headers: {
49
+ "content-type": "application/json",
50
+ authorization: `Bearer ${input.apiKey}`,
51
+ "user-agent": `@maind-dev/mcp-bridge install/${input.installerVersion}`,
52
+ },
53
+ body: JSON.stringify(payload),
54
+ signal: controller.signal,
55
+ });
56
+ }
57
+ catch {
58
+ // Silent — telemetry is best-effort.
59
+ }
60
+ finally {
61
+ clearTimeout(t);
62
+ }
63
+ }
64
+ function countStatuses(steps) {
65
+ const counts = {
66
+ created: 0,
67
+ merged: 0,
68
+ skipped: 0,
69
+ "needs-user-decision": 0,
70
+ failed: 0,
71
+ };
72
+ for (const s of steps) {
73
+ counts[s.status] = (counts[s.status] ?? 0) + 1;
74
+ }
75
+ return counts;
76
+ }
77
+ function parseNodeMajor(version) {
78
+ const m = /^v?(\d+)\./.exec(version);
79
+ if (m === null)
80
+ return 0;
81
+ return Number.parseInt(m[1], 10);
82
+ }
83
+ //# sourceMappingURL=telemetry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/install/telemetry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,148 @@
1
+ // Idempotent TOML-config merge — currently used only for the Codex CLI
2
+ // (`~/.codex/config.toml`) since Codex is the one client that ships TOML.
3
+ //
4
+ // Semantics:
5
+ // - Parse the existing TOML.
6
+ // - Replace ONLY `[mcp_servers.maind]` and `[mcp_servers.maind.env]`.
7
+ // - Preserve every other section verbatim — Codex configs typically include
8
+ // unrelated `[model]`, `[ui]`, `[mcp_servers.<other>]` blocks.
9
+ // - Write back using smol-toml's stringify (stable key order).
10
+ //
11
+ // Why a full parse+rewrite instead of regex-replace: smol-toml is ~30 KB and
12
+ // gives us correct handling of nested tables, quoted keys, multiline strings,
13
+ // and comments-in-values. Regex-based section replacement would mis-handle
14
+ // nested `mcp_servers.maind.<sub>` and arrays-of-tables.
15
+ import { parse as parseToml, stringify as stringifyToml } from "smol-toml";
16
+ import { atomicWriteFile, readFileSafe } from "./atomic-write.js";
17
+ export async function mergeTomlConfig(target, serverEntry, dryRun = false) {
18
+ if (target.kind !== "toml") {
19
+ return {
20
+ target: target.key,
21
+ action: "merge",
22
+ status: "failed",
23
+ detail: `expected toml target, got ${target.kind}`,
24
+ };
25
+ }
26
+ let raw;
27
+ try {
28
+ raw = await readFileSafe(target.path);
29
+ }
30
+ catch (err) {
31
+ return failed(target, "read", err);
32
+ }
33
+ let parsed;
34
+ let action = "create";
35
+ if (raw === null || raw.trim().length === 0) {
36
+ parsed = {};
37
+ }
38
+ else {
39
+ action = "merge";
40
+ try {
41
+ const result = parseToml(raw);
42
+ if (!isObject(result)) {
43
+ return {
44
+ target: target.key,
45
+ action: "merge",
46
+ status: "failed",
47
+ detail: "parsed TOML is not an object at root",
48
+ };
49
+ }
50
+ parsed = result;
51
+ }
52
+ catch (err) {
53
+ return failed(target, "parse", err);
54
+ }
55
+ }
56
+ const mcpServers = isObject(parsed.mcp_servers) ? parsed.mcp_servers : {};
57
+ const existing = mcpServers.maind;
58
+ if (isObject(existing) && tomlServerEntryEqual(existing, serverEntry)) {
59
+ return {
60
+ target: target.key,
61
+ action: "merge",
62
+ status: "skipped",
63
+ detail: "maind entry already up-to-date",
64
+ };
65
+ }
66
+ const maindBlock = {
67
+ command: serverEntry.command,
68
+ args: [...serverEntry.args],
69
+ env: { ...serverEntry.env },
70
+ };
71
+ const nextConfig = {
72
+ ...parsed,
73
+ mcp_servers: { ...mcpServers, maind: maindBlock },
74
+ };
75
+ let nextRaw;
76
+ try {
77
+ nextRaw = stringifyToml(nextConfig);
78
+ if (!nextRaw.endsWith("\n"))
79
+ nextRaw += "\n";
80
+ }
81
+ catch (err) {
82
+ return failed(target, "write", err);
83
+ }
84
+ // Post-write-verification (ADR-142): the stringified output must contain
85
+ // exactly one [mcp_servers.maind] section header. Catches degenerate cases
86
+ // where smol-toml might emit duplicates for arrays-of-tables-shaped input.
87
+ const headerMatches = nextRaw.match(/^\[mcp_servers\.maind\]/gm) ?? [];
88
+ if (headerMatches.length !== 1) {
89
+ return {
90
+ target: target.key,
91
+ action: "merge",
92
+ status: "failed",
93
+ detail: `expected exactly one [mcp_servers.maind] section, got ${headerMatches.length}`,
94
+ };
95
+ }
96
+ if (dryRun) {
97
+ return {
98
+ target: target.key,
99
+ action: action === "create" ? "write" : "merge",
100
+ status: action === "create" ? "would-create" : "would-merge",
101
+ detail: target.path,
102
+ };
103
+ }
104
+ try {
105
+ await atomicWriteFile(target.path, nextRaw);
106
+ }
107
+ catch (err) {
108
+ return failed(target, "write", err);
109
+ }
110
+ return {
111
+ target: target.key,
112
+ action: action === "create" ? "write" : "merge",
113
+ status: action === "create" ? "created" : "merged",
114
+ detail: target.path,
115
+ };
116
+ }
117
+ function tomlServerEntryEqual(a, b) {
118
+ if (!isObject(a))
119
+ return false;
120
+ if (a.command !== b.command)
121
+ return false;
122
+ if (!Array.isArray(a.args) || a.args.length !== b.args.length)
123
+ return false;
124
+ for (let i = 0; i < a.args.length; i++) {
125
+ if (a.args[i] !== b.args[i])
126
+ return false;
127
+ }
128
+ if (!isObject(a.env))
129
+ return false;
130
+ for (const key of Object.keys(b.env)) {
131
+ if (a.env[key] !== b.env[key])
132
+ return false;
133
+ }
134
+ return true;
135
+ }
136
+ function isObject(v) {
137
+ return typeof v === "object" && v !== null && !Array.isArray(v);
138
+ }
139
+ function failed(target, phase, err) {
140
+ const message = err instanceof Error ? err.message : String(err);
141
+ return {
142
+ target: target.key,
143
+ action: "merge",
144
+ status: "failed",
145
+ detail: `${phase}: ${message}`,
146
+ };
147
+ }
148
+ //# sourceMappingURL=toml-merge.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"toml-merge.js","sourceRoot":"","sources":["../../src/install/toml-merge.ts"],"names":[],"mappings":"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"}
package/build/version.js CHANGED
@@ -3,5 +3,5 @@
3
3
  // import shape under Node16 module resolution.
4
4
  //
5
5
  // Keep in sync with the `version` field in package.json.
6
- export const BRIDGE_VERSION = "0.1.0";
6
+ export const BRIDGE_VERSION = "0.3.0";
7
7
  //# sourceMappingURL=version.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@maind-dev/mcp-bridge",
3
- "version": "0.1.0",
3
+ "version": "0.3.0",
4
4
  "description": "Local MCP bridge for maind.dev — wraps any MCP-compatible client (Claude Code, Cursor, Windsurf) and pins your API key to a single device via the maind device authorization flow.",
5
5
  "type": "module",
6
6
  "main": "./build/index.js",
@@ -11,15 +11,10 @@
11
11
  "build",
12
12
  "README.md"
13
13
  ],
14
- "scripts": {
15
- "build": "tsc",
16
- "start": "node build/index.js",
17
- "dev": "node --watch --watch-path=src --import tsx src/index.ts",
18
- "type-check": "tsc --noEmit",
19
- "typecheck": "tsc --noEmit"
20
- },
21
14
  "dependencies": {
22
- "@modelcontextprotocol/sdk": "^1.0.0"
15
+ "@modelcontextprotocol/sdk": "^1.0.0",
16
+ "smol-toml": "^1.3.1",
17
+ "@maind-dev/integration-snippets": "0.1.0"
23
18
  },
24
19
  "devDependencies": {
25
20
  "@types/node": "^20.11.0",
@@ -39,5 +34,13 @@
39
34
  "license": "MIT",
40
35
  "publishConfig": {
41
36
  "access": "public"
37
+ },
38
+ "scripts": {
39
+ "build": "tsc && chmod +x build/index.js",
40
+ "start": "node build/index.js",
41
+ "dev": "node --watch --watch-path=src --import tsx src/index.ts",
42
+ "test": "node --import tsx --test test/**/*.test.ts",
43
+ "type-check": "tsc --noEmit",
44
+ "typecheck": "tsc --noEmit"
42
45
  }
43
- }
46
+ }