@m2canvas/connect 0.11.0 → 0.12.0

package/README.md

@@ -14,11 +14,11 @@ It finds the supported clients you have installed, shows what it will change, an
 
 | Client | How it is set up | Sign-in |
 |---|---|---|
-| Claude Code | `claude mcp add --transport http --scope user m2 …` | `claude mcp login m2` |
-| Codex (CLI or the desktop app's bundled CLI) | appends `[mcp_servers.m2]` to `~/.codex/config.toml` | `codex mcp login m2` |
-| Cursor | merges `m2` into `~/.cursor/mcp.json`, then `cursor-agent mcp enable m2` | `cursor-agent mcp login m2` |
-| OpenCode | merges `m2` into `~/.config/opencode/opencode.json`, keeping the file's existing format | `opencode mcp auth m2` |
-| Qoder (CLI + desktop app) | `qodercli mcp add -s user -t http m2 …` | in Qoder: Extensions → Connectors → m2 → Authorize |
+| Claude Code | `claude mcp add --transport http --scope user patch …` | `claude mcp login patch` |
+| Codex (CLI or the desktop app's bundled CLI) | appends `[mcp_servers.patch]` to `~/.codex/config.toml` | `codex mcp login patch` |
+| Cursor | merges `patch` into `~/.cursor/mcp.json`, then `cursor-agent mcp enable patch` | `cursor-agent mcp login patch` |
+| OpenCode | merges `patch` into `~/.config/opencode/opencode.json`, keeping the file's existing format | `opencode mcp auth patch` |
+| Qoder (CLI + desktop app) | `qodercli mcp add -s user -t http patch …` | in Qoder: Extensions → Connectors → patch → Authorize |
 
 Clients that already have an entry pointing at `mcp.patch.design`, under any name, are skipped. Before a config file is edited, the original is copied to `<file>.bak-m2canvas`.
 

package/dist/bridge/precheck.js

@@ -16,6 +16,7 @@
  *   不退回本机的 claude（否则预检和会话看的是两个程序）。
  */
 import { join } from 'node:path';
+import { SERVER_NAME } from '../config-files.js';
 import { findM2Names } from './m2-config.js';
 import { ADAPTERS, CODEX_BIN_LINK, CODEX_SCRIPT } from './adapters.js';
 import { combinedOutput } from './exec.js';
@@ -57,7 +58,7 @@ function toLogin(parse, next) {
     return { state: parse.state, next: parse.state === 'logged_out' || parse.state === 'unknown' ? next : null, raw: parse.raw };
 }
 function toM2(parse, nextFor) {
-    const next = parse.state === 'not_configured' ? { kind: 'configure' } : nextFor(parse.state, parse.entry ?? 'm2');
+    const next = parse.state === 'not_configured' ? { kind: 'configure' } : nextFor(parse.state, parse.entry ?? SERVER_NAME);
     return { state: parse.state, entry: parse.entry, next, raw: parse.raw };
 }
 function plan(agent, deps) {

package/dist/clients.js

@@ -6,7 +6,7 @@ function jsonExisting(path, find) {
     const read = readJson(path);
     return read.kind === 'ok' ? find(read.value) : null;
 }
-/** 用户级 server 表里同名 `m2` 指向别处 → blocked 提示（D-C1）；读不出文件按无冲突，由客户端自己的 CLI 报错 */
+/** 用户级 server 表里同名（`SERVER_NAME`）入口指向别处 → blocked 提示（D-C1）；读不出文件按无冲突，由客户端自己的 CLI 报错 */
 function jsonConflict(path, servers) {
     const read = readJson(path);
     return read.kind === 'ok' && hasNameConflictInServers(servers(read.value)) ? nameConflictNote(path) : null;

package/dist/config-files.js

@@ -1,8 +1,13 @@
-// 各客户端配置文件的纯函数读写：查已有 m2 入口、按原格式合并。全部不碰磁盘，便于单测。
+// 各客户端配置文件的纯函数读写：查已有的本产品入口（按 MCP 主机认，不看名字）、按原格式合并。全部不碰磁盘，便于单测。
 // MCP 地址来自 site-config.ts（connect 唯一的站点配置来源），这里转出供 cli.ts / clients.ts 沿用原导出名。
 import { M2_MCP_URL, MCP_HOST } from './site-config.js';
 export { M2_MCP_URL };
-export const SERVER_NAME = 'm2';
+/**
+ * connect 写进各家 agent 配置的条目名（change mcp-entry-name-patch，2026-11-10 起由 `m2` 改为 `patch`）。
+ * 只用于新写入与同名冲突判断；识别已有条目一律按 MCP 主机（`isM2Url`），所以改名前写下、指向当前主机的 `m2`
+ * 照常认作已配置，不改名、不追加第二条（design D2）。网站接入片段与 `agent-setup.md` 用同一个名字，改动时同步。
+ */
+export const SERVER_NAME = 'patch';
 function isObject(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -28,9 +33,10 @@ export function findM2Entry(servers) {
     return null;
 }
 /**
- * server 表里已有名为 `m2`、但不指向 M2 的入口（change domain-cutover design D-C1）。
- * 我们只会以 `m2` 这个名字写入；同名入口指向别处时既不能追加（Codex 的 TOML 会出现重复表、整个文件解析失败），
- * 也不能覆盖（那可能是用户自己的 server，或换域名前留下的旧入口，静默改掉用户看不出发生了什么）。一律报冲突交给用户。
+ * server 表里已有名为 `SERVER_NAME`、但不指向当前 MCP 主机的入口（change domain-cutover design D-C1，
+ * mcp-entry-name-patch D3 起判的是 `patch`）。我们只会以这个名字写入；同名入口指向别处时既不能追加
+ * （Codex 的 TOML 会出现重复表、整个文件解析失败），也不能覆盖（那可能是用户自己的 server，静默改掉用户看不出发生了什么）。
+ * 一律报冲突交给用户。
  */
 export function hasNameConflictInServers(servers) {
     if (!isObject(servers) || !Object.hasOwn(servers, SERVER_NAME))
@@ -40,7 +46,7 @@ export function hasNameConflictInServers(servers) {
 }
 /** 同名冲突的提示（给 ClientPlan.blocked 用）：说明不改的原因与用户要做的事，不打印对方的地址 */
 export function nameConflictNote(where) {
-    return `${where} already has an MCP server named "${SERVER_NAME}" that does not point to M2 (for example one left from an old M2 address). Remove or rename it, then run this again.`;
+    return `${where} already has an MCP server named "${SERVER_NAME}" that does not point to Patch (${MCP_HOST}). Remove or rename it, then run this again.`;
 }
 /** Claude Code `~/.claude.json` 顶层 mcpServers = user scope。 */
 export function findInClaudeConfig(config) {
@@ -73,7 +79,7 @@ export function findInCodexToml(toml) {
     }
     return null;
 }
-/** Codex `config.toml` 里已有 `[mcp_servers.m2]` 段且段内 url 不指向 M2（判定见 `hasNameConflictInServers`） */
+/** Codex `config.toml` 里已有 `[mcp_servers.<SERVER_NAME>]` 段且段内 url 不指向当前 MCP 主机（判定见 `hasNameConflictInServers`） */
 export function hasCodexNameConflict(toml) {
     let inTarget = false;
     let found = false;
@@ -132,7 +138,7 @@ export function mergeOpencodeConfig(config) {
     return { existing: null, conflict: false, config: { ...base, mcp: nextMcp } };
 }
 /**
- * Codex `config.toml` 追加 m2 段。不走 `codex mcp add`：它在没有已存 token 时会顺手启动 OAuth
+ * Codex `config.toml` 追加 `[mcp_servers.<SERVER_NAME>]` 段。不走 `codex mcp add`：它在没有已存 token 时会顺手启动 OAuth
  * 并阻塞等浏览器回调（实测），agent 代跑时输出被捕获、链接不可见，命令永远不返回。
  * 只做追加、不解析重写，用户原有内容与注释逐字保留；调用方先用 findInCodexToml 判重。
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m2canvas/connect",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Connect your local agent clients (Claude Code, Codex, Cursor, OpenCode, Qoder) to M2 Canvas over MCP in one command, and run the local bridge that lets M2 drive them over ACP.",
   "type": "module",
   "bin": {