@ainecto/mcp 0.3.0 → 0.5.0

package/dist/bin/ainecto.js

@@ -5,23 +5,55 @@ import { createHash } from "crypto";
 import { mkdir, readFile, rename, rm, stat, writeFile, chmod } from "fs/promises";
 import { homedir } from "os";
 import { dirname, join } from "path";
+
+// src/core/harness/role.ts
+var HARNESS_ROLES = ["design", "development", "test", "validation"];
+var ROLE_SCOPE_PREFIX = "ai-erd:role:";
+var ROLE_HEADER = "X-AI-ERD-Role";
+var ROLE_ENV_VAR = "AINECTO_ROLE";
+var LEGACY_ROLE_ENV_VAR = "AI_ERD_ROLE";
+function resolveRole(input = {}) {
+  if (input.role !== void 0) {
+    return { role: assertRole(input.role), source: "flag" };
+  }
+  const envVars = input.envVars ?? process.env;
+  for (const envVar of [ROLE_ENV_VAR, LEGACY_ROLE_ENV_VAR]) {
+    const fromEnv = envVars[envVar];
+    if (fromEnv && fromEnv.trim()) {
+      return { role: assertRole(fromEnv), source: "env", envVar };
+    }
+  }
+  return { source: "none" };
+}
+function assertRole(value) {
+  const normalized = value.trim().toLowerCase();
+  if (HARNESS_ROLES.includes(normalized)) {
+    return normalized;
+  }
+  throw new Error(
+    `Invalid role "${value}". Expected one of: ${HARNESS_ROLES.join(", ")}.`
+  );
+}
+
+// src/core/auth/tokenStore.ts
 var FileTokenStore = class {
   filePath;
   constructor(rootDir = join(homedir(), ".ainecto")) {
     this.filePath = join(rootDir, "tokens.json");
   }
-  async load(endpoint, role) {
+  async load(endpoint) {
     const file = await this.readFile();
-    return file[tokenKey(endpoint, role)];
+    return file[tokenKey(endpoint)];
   }
-  async save(endpoint, token, role) {
+  async save(endpoint, token) {
+    assertNoRoleScope(token);
     const file = await this.readFile();
-    file[tokenKey(endpoint, role)] = { ...token, endpoint, updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
+    file[tokenKey(endpoint)] = { ...token, endpoint, updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
     await this.writeFile(file);
   }
-  async delete(endpoint, role) {
+  async delete(endpoint) {
     const file = await this.readFile();
-    delete file[tokenKey(endpoint, role)];
+    delete file[tokenKey(endpoint)];
     await this.writeFile(file);
   }
   async readFile() {
@@ -56,9 +88,15 @@ var FileTokenStore = class {
     await chmodIfPermissive(this.filePath, 384);
   }
 };
-function tokenKey(endpoint, role) {
-  const material = role && role.trim() ? `${endpoint}#role=${role.trim().toLowerCase()}` : endpoint;
-  return createHash("sha256").update(material).digest("hex");
+function tokenKey(endpoint) {
+  return createHash("sha256").update(endpoint).digest("hex");
+}
+function assertNoRoleScope(token) {
+  if (token.scope?.split(/\s+/).some((scope) => scope.startsWith(ROLE_SCOPE_PREFIX))) {
+    throw new Error(
+      "Refusing to store a role-scoped access token: sign-in is one per machine and the role comes from the repository. Run `ainecto auth login` again."
+    );
+  }
 }
 function isNodeError(error, code) {
   return error instanceof Error && "code" in error && error.code === code;
@@ -85,13 +123,20 @@ import { URLSearchParams } from "url";
 
 // src/core/config/endpoints.ts
 var DEFAULT_ENDPOINTS = {
-  prod: "https://ai-erd.com/mcp",
+  prod: "https://ainecto.com/mcp",
   dev: "https://dev.ai-erd.com/mcp"
 };
+var LEGACY_PROD_ENDPOINT = "https://ai-erd.com/mcp";
 var LEGACY_DEFAULT_ENDPOINTS = [
-  "https://ainecto.com/mcp",
+  LEGACY_PROD_ENDPOINT,
   "https://dev.ainecto.com/mcp"
 ];
+var TOKEN_SLOT_FALLBACKS = {
+  [DEFAULT_ENDPOINTS.prod]: [LEGACY_PROD_ENDPOINT]
+};
+function fallbackTokenEndpointsFor(endpoint) {
+  return TOKEN_SLOT_FALLBACKS[normalizeEndpoint(endpoint)] ?? [];
+}
 function resolveEndpoint(input = {}) {
   const envVars = input.envVars ?? process.env;
   const env = input.env ?? "prod";
@@ -154,7 +199,7 @@ async function registerPublicClient(registrationEndpoint, redirectUri, fetchImpl
     method: "POST",
     headers: { "content-type": "application/json", accept: "application/json" },
     body: JSON.stringify({
-      client_name: "Ainecto CLI",
+      client_name: "AiNecto CLI",
       redirect_uris: [redirectUri],
       token_endpoint_auth_method: "none",
       grant_types: ["authorization_code", "refresh_token"],
@@ -177,32 +222,16 @@ function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
-// src/core/harness/role.ts
-var HARNESS_ROLES = ["design", "development", "test", "validation"];
-var ROLE_SCOPE_PREFIX = "ai-erd:role:";
-var ROLE_HEADER = "X-AI-ERD-Role";
-var ROLE_ENV_VAR = "AI_ERD_ROLE";
-function resolveRole(input = {}) {
-  if (input.role !== void 0) {
-    return { role: assertRole(input.role), source: "flag" };
-  }
-  const fromEnv = (input.envVars ?? process.env)[ROLE_ENV_VAR];
-  if (fromEnv && fromEnv.trim()) {
-    return { role: assertRole(fromEnv), source: "env" };
-  }
-  return { source: "none" };
-}
-function assertRole(value) {
-  const normalized = value.trim().toLowerCase();
-  if (HARNESS_ROLES.includes(normalized)) {
-    return normalized;
-  }
-  throw new Error(
-    `Invalid role "${value}". Expected one of: ${HARNESS_ROLES.join(", ")}.`
-  );
-}
-
 // src/core/auth/oauth.ts
+var DEFAULT_LOGIN_TIMEOUT_MS = 3e5;
+var OAuthLoginError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "OAuthLoginError";
+  }
+  code;
+};
 var OAuthClient = class {
   constructor(options) {
     this.options = options;
@@ -220,21 +249,27 @@ var OAuthClient = class {
       assertEnvTokenEndpointAllowed(this.options.endpoint, this.envVars);
       return envToken;
     }
-    const stored = await this.options.tokenStore.load(this.options.endpoint, this.options.role);
+    const stored = await this.loadStored();
     if (!stored) {
       return void 0;
     }
     if (!shouldRefresh(stored)) {
       return stored.accessToken;
     }
-    return this.refreshStoredToken(stored);
+    if (this.options.readOnly) {
+      return isExpired(stored) ? void 0 : stored.accessToken;
+    }
+    if (!stored.refreshToken) {
+      return isExpired(stored) ? void 0 : stored.accessToken;
+    }
+    return this.refreshStoredToken({ ...stored, refreshToken: stored.refreshToken });
   }
   async refreshAfterUnauthorized() {
-    const stored = await this.options.tokenStore.load(this.options.endpoint, this.options.role);
-    if (!stored?.refreshToken) {
+    const stored = await this.loadStored();
+    if (this.options.readOnly || !stored?.refreshToken) {
       return void 0;
     }
-    return this.refreshStoredToken(stored);
+    return this.refreshStoredToken({ ...stored, refreshToken: stored.refreshToken });
   }
   async login() {
     const pkce = generatePkcePair();
@@ -251,12 +286,14 @@ var OAuthClient = class {
       authorizeUrl.searchParams.set("code_challenge_method", "S256");
       authorizeUrl.searchParams.set("resource", this.options.endpoint);
       authorizeUrl.searchParams.set("state", state);
-      if (this.options.role) {
-        authorizeUrl.searchParams.set("scope", `mcp ${ROLE_SCOPE_PREFIX}${this.options.role}`);
-      }
       assertTrustedEndpointUrl(authorizeUrl, "OAuth authorization URL");
-      await this.openBrowserImpl(authorizeUrl.toString());
-      const code = await loopback.waitForCode();
+      const url = authorizeUrl.toString();
+      this.options.onAuthorizeUrl?.(url);
+      const browserFailure = this.openBrowserImpl(url).then(() => new Promise(() => void 0));
+      const code = await withTimeout(
+        Promise.race([loopback.waitForCode(), browserFailure]),
+        this.options.loginTimeoutMs ?? DEFAULT_LOGIN_TIMEOUT_MS
+      );
       const token = await exchangeToken(metadata.tokenEndpoint, {
         grant_type: "authorization_code",
         code,
@@ -267,19 +304,38 @@ var OAuthClient = class {
         ...registration.clientSecret ? { client_secret: registration.clientSecret } : {}
       }, this.fetchImpl);
       const stored = toStoredToken(this.options.endpoint, token, metadata, registration);
-      await this.options.tokenStore.save(this.options.endpoint, stored, this.options.role);
+      await this.options.tokenStore.save(this.options.endpoint, stored);
       return stored;
     } finally {
       await loopback.close();
     }
   }
+  /**
+   * ★대체로 읽는 옛 칸도 함께 지운다. 새 칸만 지우면 다음 읽기가 곧바로 옛 칸으로 대체돼
+   * «로그아웃했는데 여전히 로그인됨»이 된다. 로그인은 기계당 한 번이므로 옛 CLI 의 칸도 같이 끝난다.
+   */
   async logout() {
-    await this.options.tokenStore.delete(this.options.endpoint, this.options.role);
+    await this.options.tokenStore.delete(this.options.endpoint);
+    for (const fallback of fallbackTokenEndpointsFor(this.options.endpoint)) {
+      await this.options.tokenStore.delete(fallback);
+    }
   }
-  async refreshStoredToken(stored) {
-    if (!stored.refreshToken) {
-      return stored.accessToken;
+  /** 이 주소의 칸, 비었으면 옛 기본 주소의 칸({@link fallbackTokenEndpointsFor}). 쓰기는 늘 이 주소의 칸이다. */
+  async loadStored() {
+    const own = await this.options.tokenStore.load(this.options.endpoint);
+    if (own) {
+      return own;
+    }
+    for (const fallback of fallbackTokenEndpointsFor(this.options.endpoint)) {
+      const stored = await this.options.tokenStore.load(fallback);
+      if (stored) {
+        return stored;
+      }
     }
+    return void 0;
+  }
+  /** 부르는 쪽이 refresh token 이 있음을 이미 확인했다 — 타입이 그것을 요구한다. */
+  async refreshStoredToken(stored) {
     const metadata = await discoverOAuthMetadata(this.options.endpoint, this.fetchImpl);
     const token = await exchangeToken(metadata.tokenEndpoint, {
       grant_type: "refresh_token",
@@ -289,7 +345,7 @@ var OAuthClient = class {
       resource: this.options.endpoint
     }, this.fetchImpl);
     const next = toStoredToken(this.options.endpoint, token, metadata, stored);
-    await this.options.tokenStore.save(this.options.endpoint, next, this.options.role);
+    await this.options.tokenStore.save(this.options.endpoint, next);
     return next.accessToken;
   }
 };
@@ -301,6 +357,27 @@ function generatePkcePair() {
 function generateOAuthState() {
   return randomBytes(32).toString("base64url");
 }
+function isExpired(token, now = Date.now()) {
+  return token.expiresAt !== void 0 && token.expiresAt <= now;
+}
+async function withTimeout(work, timeoutMs) {
+  let timer;
+  const timeout = new Promise((_, reject) => {
+    timer = setTimeout(() => {
+      const minutes = timeoutMs / 6e4;
+      const span = Number.isInteger(minutes) ? `${minutes} minute${minutes === 1 ? "" : "s"}` : `${timeoutMs} ms`;
+      reject(new OAuthLoginError(
+        "LOGIN_TIMEOUT",
+        `Sign-in was not completed within ${span}. Nothing was saved \u2014 run the same command again.`
+      ));
+    }, timeoutMs);
+  });
+  try {
+    return await Promise.race([work, timeout]);
+  } finally {
+    clearTimeout(timer);
+  }
+}
 function shouldRefresh(token, now = Date.now()) {
   if (!token.expiresAt) {
     return false;
@@ -393,11 +470,11 @@ function toStoredToken(endpoint, token, metadata, previous) {
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
 }
-async function createLoopbackReceiver(expectedState) {
+async function createLoopbackReceiver(expectedState, host = "127.0.0.1") {
   let resolveCode;
   let rejectCode;
-  const codePromise = new Promise((resolve2, reject) => {
-    resolveCode = resolve2;
+  const codePromise = new Promise((resolve3, reject) => {
+    resolveCode = resolve3;
     rejectCode = reject;
   });
   codePromise.catch(() => void 0);
@@ -408,13 +485,13 @@ async function createLoopbackReceiver(expectedState) {
     const state = url.searchParams.get("state");
     if (error) {
       res.writeHead(400, { "content-type": "text/plain" });
-      res.end("Ainecto CLI authorization failed. You can close this tab.");
+      res.end("AiNecto CLI authorization failed. You can close this tab.");
       rejectCode(new Error(`OAuth authorization failed: ${error}`));
       return;
     }
     if (!state || state !== expectedState) {
       res.writeHead(400, { "content-type": "text/plain" });
-      res.end("Ainecto CLI authorization state mismatch. You can close this tab.");
+      res.end("AiNecto CLI authorization state mismatch. You can close this tab.");
       rejectCode(new Error("OAuth state mismatch."));
       return;
     }
@@ -425,10 +502,16 @@ async function createLoopbackReceiver(expectedState) {
       return;
     }
     res.writeHead(200, { "content-type": "text/plain" });
-    res.end("Ainecto CLI authorization complete. You can close this tab.");
+    res.end("AiNecto CLI authorization complete. You can close this tab.");
     resolveCode(code);
   });
-  await new Promise((resolve2) => server.listen(0, "127.0.0.1", resolve2));
+  await new Promise((resolve3, reject) => {
+    server.once("error", (error) => reject(new OAuthLoginError(
+      "CALLBACK_UNAVAILABLE",
+      `Could not start the local sign-in callback on ${host} (${error.message}). If this command runs in a sandbox, allow local network binding or run it outside the sandbox.`
+    )));
+    server.listen(0, host, () => resolve3());
+  });
   const address = server.address();
   if (!address || typeof address === "string") {
     throw new Error("Loopback OAuth server did not bind to a TCP port.");
@@ -436,7 +519,10 @@ async function createLoopbackReceiver(expectedState) {
   return {
     redirectUri: `http://127.0.0.1:${address.port}/callback`,
     waitForCode: () => codePromise,
-    close: () => new Promise((resolve2, reject) => server.close((error) => error ? reject(error) : resolve2()))
+    close: () => new Promise((resolve3, reject) => {
+      server.closeAllConnections?.();
+      server.close((error) => error ? reject(error) : resolve3());
+    })
   };
 }
 function parseStringArray(value) {
@@ -460,10 +546,39 @@ function getBrowserOpenCommand(url, platform = process.platform) {
   }
   return { command: "xdg-open", args: [url] };
 }
-async function openBrowser(url) {
-  const { command, args } = getBrowserOpenCommand(url);
-  const child = spawn(command, args, { stdio: "ignore", detached: true });
-  child.unref();
+function launchBrowser(url, deps = {}) {
+  const platform = deps.platform ?? process.platform;
+  const { command, args } = getBrowserOpenCommand(url, platform);
+  const spawnImpl = deps.spawnImpl ?? spawn;
+  return new Promise((resolve3, reject) => {
+    const unavailable = (reason) => new OAuthLoginError(
+      "BROWSER_UNAVAILABLE",
+      `Could not open a browser on this machine (${command}: ${reason}). Sign-in needs a browser here.`
+    );
+    let child;
+    try {
+      child = spawnImpl(command, args, { stdio: "ignore", detached: true });
+    } catch (error) {
+      reject(unavailable(error instanceof Error ? error.message : String(error)));
+      return;
+    }
+    child.once("error", (error) => reject(unavailable(error.message)));
+    if (platform === "win32") {
+      child.once("spawn", () => resolve3());
+    } else {
+      child.once("exit", (code, signal) => {
+        if (code === 0) {
+          resolve3();
+        } else {
+          reject(unavailable(code === null ? `stopped by ${signal ?? "a signal"}` : `exited with code ${code}`));
+        }
+      });
+    }
+    child.unref();
+  });
+}
+function openBrowser(url) {
+  return launchBrowser(url);
 }
 function assertEnvTokenEndpointAllowed(endpoint, envVars) {
   if (envVars.AINECTO_ALLOW_CUSTOM_ENDPOINT_TOKEN === "1") {
@@ -534,6 +649,12 @@ async function readAllStdin(stdin) {
   return text;
 }
 
+// src/core/version.ts
+var CLI_VERSION = true ? "0.5.0" : "dev";
+var PACKAGE_NAME = "@ainecto/mcp";
+var LEGACY_PACKAGE_NAME = "@ai-erd/mcp";
+var CLI_USER_AGENT = `${PACKAGE_NAME} ${CLI_VERSION}`;
+
 // src/core/mcp/rpcClient.ts
 var McpRpcError = class extends Error {
   constructor(message, code, details) {
@@ -556,7 +677,7 @@ var McpRpcClient = class {
     return this.request("initialize", {
       protocolVersion: "2024-11-05",
       capabilities: {},
-      clientInfo: { name: "@ainecto/mcp", version: "0.1.0" }
+      clientInfo: { name: PACKAGE_NAME, version: CLI_VERSION }
     });
   }
   async toolsList() {
@@ -731,55 +852,67 @@ function redactSecretString(value) {
 
 // src/core/catalog/generated.prod.ts
 var generatedTools = [
-  { "mcpName": "mcp__ainecto__create_documents", "commandPath": ["documents", "create"], "group": "document", "description": "Create documents. If a document body is tens of KB or more, prefer request_upload_token (purpose=document.create) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Documents", "items": { "properties": { "body": { "description": "Deprecated compatibility alias for typePayload.body when document type is markdown. \uBCF8\uBB38\uC774 \uC218\uC2ED KB \uC774\uC0C1\uC73C\uB85C \uD06C\uBA74 LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.create)` \uB97C \uD638\uCD9C\uD574 uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C \uC9C1\uC811 PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "folderUuid": { "description": "Optional folder UUID", "type": "string" }, "projectUuid": { "description": "Project UUID", "type": "string" }, "title": { "description": "Document title", "type": "string" }, "type": { "description": "Document type. Enabled values: erd, markdown.", "enum": ["erd", "markdown"], "type": "string" }, "typePayload": { "description": "Type-specific payload for enabled document types. markdown: {body}.", "type": "object" } }, "required": ["projectUuid", "type", "title"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4aa976b9bb3b0eb6" },
-  { "mcpName": "mcp__ainecto__create_folders", "commandPath": ["folders", "create"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Folders", "items": { "properties": { "name": { "description": "Folder name", "type": "string" }, "parentFolderUuid": { "description": "Parent folder UUID", "type": "string" }, "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid", "name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "d423d3c265631664" },
-  { "mcpName": "mcp__ainecto__create_projects", "commandPath": ["projects", "create"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Projects", "items": { "properties": { "description": { "description": "Description", "type": "string" }, "name": { "description": "Project name", "type": "string" }, "projectKey": { "description": "Unique project key", "type": "string" }, "workspaceUuid": { "description": "Workspace UUID \u2014 null uses user's default workspace", "type": "string" } }, "required": ["name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "396c80c6cc2ba41a" },
-  { "mcpName": "mcp__ainecto__create_workspaces", "commandPath": ["workspaces", "create"], "group": "workspace", "description": "", "inputSchema": { "properties": { "items": { "description": "Workspaces", "items": { "properties": { "description": { "description": "Description", "type": "string" }, "name": { "description": "Workspace name", "type": "string" } }, "required": ["name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "d663d461f9c9da65" },
-  { "mcpName": "mcp__ainecto__delete_attachments", "commandPath": ["attachments", "delete"], "group": "attachment", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Attachment UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "6e55e6511d732199" },
-  { "mcpName": "mcp__ainecto__delete_documents", "commandPath": ["documents", "delete"], "group": "document", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Document UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "5fbc7c142bb4a49d" },
-  { "mcpName": "mcp__ainecto__delete_folders", "commandPath": ["folders", "delete"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Folder UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "49fa7c0f823871b2" },
-  { "mcpName": "mcp__ainecto__delete_projects", "commandPath": ["projects", "delete"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Project UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "e1a86ddaa9638298" },
-  { "mcpName": "mcp__ainecto__delete_workspaces", "commandPath": ["workspaces", "delete"], "group": "workspace", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Workspace UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "2aca644f7a105b06" },
-  { "mcpName": "mcp__ainecto__disable_shares", "commandPath": ["tools", "run", "disable-shares"], "group": "generic", "description": "", "inputSchema": { "properties": { "targetType": { "description": "Share target type", "enum": ["project", "folder", "document"], "type": "string" }, "targetUuids": { "description": "Target UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["targetType", "targetUuids"], "type": "object" }, "required": ["targetType", "targetUuids"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "a4b4358eff0faa97" },
-  { "mcpName": "mcp__ainecto__enable_shares", "commandPath": ["tools", "run", "enable-shares"], "group": "generic", "description": "", "inputSchema": { "properties": { "targetType": { "description": "Share target type", "enum": ["project", "folder", "document"], "type": "string" }, "targetUuids": { "description": "Target UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["targetType", "targetUuids"], "type": "object" }, "required": ["targetType", "targetUuids"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "ebace643de07e826" },
-  { "mcpName": "mcp__ainecto__erd_apply_changes", "commandPath": ["erd", "apply-changes"], "group": "erd", "description": 'Required single-call mutation path for ERD create/update/delete changes. Put tables, columns, indexes, refs, enums, enum_values, and table groups in one operations array and call this once.\nRules: (1) all data field names are snake_case; (2) for create, generate your own UUIDs and put them in data.uuid, then later operations in the same batch may reference those UUIDs without read-back calls; (3) enum values are separate enum_value operations, not inline on enum; (4) ref.relationship uses short dbdiagram-style symbols: >, <, or -; (5) ref_column operations map FK columns explicitly, never automatically.\nDo not look for type-specific ERD CUD tools; this tool is the only ERD CUD entry point. If operations is very large, use mcp__ainecto__request_upload_token with purpose=mcp.call and send the tools/call payload with curl to save LLM tokens.\nOne-call worked example:\n{\n  "documentUuid": "erd-doc-uuid",\n  "description": "create users/posts ERD",\n  "operations": [\n    {"op":"create","type":"table","data":{"uuid":"tbl_users","name":"users","display_order":1}},\n    {"op":"create","type":"column","data":{"uuid":"col_users_id","table_uuid":"tbl_users","name":"id","type":"bigint","is_pk":true,"is_not_null":true,"display_order":1}},\n    {"op":"create","type":"column","data":{"uuid":"col_users_email","table_uuid":"tbl_users","name":"email","type":"varchar(255)","is_unique":true,"is_not_null":true,"display_order":2}},\n    {"op":"create","type":"table","data":{"uuid":"tbl_posts","name":"posts","display_order":2}},\n    {"op":"create","type":"column","data":{"uuid":"col_posts_id","table_uuid":"tbl_posts","name":"id","type":"bigint","is_pk":true,"is_not_null":true,"display_order":1}},\n    {"op":"create","type":"column","data":{"uuid":"col_posts_author_id","table_uuid":"tbl_posts","name":"author_id","type":"bigint","is_not_null":true,"display_order":2}},\n    {"op":"create","type":"column","data":{"uuid":"col_posts_status","table_uuid":"tbl_posts","name":"status","type":"post_status","is_not_null":true,"display_order":3}},\n    {"op":"create","type":"enum","data":{"uuid":"enum_post_status","name":"post_status"}},\n    {"op":"create","type":"enum_value","data":{"uuid":"enum_post_status_draft","enum_uuid":"enum_post_status","value":"draft","display_order":1}},\n    {"op":"create","type":"enum_value","data":{"uuid":"enum_post_status_published","enum_uuid":"enum_post_status","value":"published","display_order":2}},\n    {"op":"create","type":"ref","data":{"uuid":"ref_posts_author","name":"fk_posts_author","from_table_uuid":"tbl_posts","to_table_uuid":"tbl_users","relationship":">","on_delete":"cascade"}},\n    {"op":"create","type":"ref_column","data":{"uuid":"refcol_posts_author","ref_uuid":"ref_posts_author","from_column_uuid":"col_posts_author_id","to_column_uuid":"col_users_id","display_order":1}}\n  ]\n}', "inputSchema": { "properties": { "arrangeNewTables": { "description": "Whether to auto-place newly-created tables after the batch; defaults to true", "type": "boolean" }, "description": { "description": "Reason for batch (audit)", "type": "string" }, "documentUuid": { "description": "ERD document UUID", "type": "string" }, "operations": { "description": "Atomic create/update/delete operations", "items": { "description": "One ERD mutation. Use a single operations array with client-generated data.uuid values to create cross-referenced tables, columns, enums, refs, and ref_columns without read-back calls.", "discriminator": { "propertyName": "type" }, "oneOf": [{ "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='table'.", "properties": { "alias": { "description": "Display alias.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "header_color": { "description": "Header color.", "type": "string" }, "name": { "description": "Table name. Required for create.", "type": "string" }, "note": { "description": "Table note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "required": ["name"], "title": "table data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='table'.", "properties": { "alias": { "description": "Display alias.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "header_color": { "description": "Header color.", "type": "string" }, "name": { "description": "Table name. Required for create.", "type": "string" }, "note": { "description": "Table note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "table", "description": "Must be 'table' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "table operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='column'.", "properties": { "default_value": { "description": "Default value.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "is_increment": { "description": "Auto-increment flag.", "type": "boolean" }, "is_not_null": { "description": "Not-null flag.", "type": "boolean" }, "is_pk": { "description": "Primary key flag.", "type": "boolean" }, "is_unique": { "description": "Unique flag.", "type": "boolean" }, "name": { "description": "Column name.", "type": "string" }, "note": { "description": "Column note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create; may be a data.uuid from an earlier table operation in this batch.", "type": "string" }, "type": { "description": "SQL data type. Use this exact field name; do not send data_type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "required": ["table_uuid"], "title": "column data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='column'.", "properties": { "default_value": { "description": "Default value.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "is_increment": { "description": "Auto-increment flag.", "type": "boolean" }, "is_not_null": { "description": "Not-null flag.", "type": "boolean" }, "is_pk": { "description": "Primary key flag.", "type": "boolean" }, "is_unique": { "description": "Unique flag.", "type": "boolean" }, "name": { "description": "Column name.", "type": "string" }, "note": { "description": "Column note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create; may be a data.uuid from an earlier table operation in this batch.", "type": "string" }, "type": { "description": "SQL data type. Use this exact field name; do not send data_type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "column data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "column", "description": "Must be 'column' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "column operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='index'.", "properties": { "is_pk": { "description": "Primary key index flag.", "type": "boolean" }, "is_unique": { "description": "Unique index flag.", "type": "boolean" }, "name": { "description": "Index name.", "type": "string" }, "note": { "description": "Index note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create.", "type": "string" }, "type": { "description": "Index type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "required": ["table_uuid"], "title": "index data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='index'.", "properties": { "is_pk": { "description": "Primary key index flag.", "type": "boolean" }, "is_unique": { "description": "Unique index flag.", "type": "boolean" }, "name": { "description": "Index name.", "type": "string" }, "note": { "description": "Index note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create.", "type": "string" }, "type": { "description": "Index type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "index data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "index", "description": "Must be 'index' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "index operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='index_column'.", "properties": { "column_uuid": { "description": "Column UUID. Required for create.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "index_uuid": { "description": "Index UUID. Required for create.", "type": "string" }, "sort_order": { "description": "Sort order, for example ASC or DESC.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "required": ["index_uuid", "column_uuid"], "title": "index_column data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='index_column'.", "properties": { "column_uuid": { "description": "Column UUID. Required for create.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "index_uuid": { "description": "Index UUID. Required for create.", "type": "string" }, "sort_order": { "description": "Sort order, for example ASC or DESC.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "index_column data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "index_column", "description": "Must be 'index_column' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "index_column operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='ref'.", "properties": { "from_table_uuid": { "description": "Source table UUID. Required for create.", "type": "string" }, "name": { "description": "Reference name.", "type": "string" }, "on_delete": { "description": "ON DELETE action.", "type": "string" }, "on_update": { "description": "ON UPDATE action.", "type": "string" }, "relationship": { "description": "Required for create. Use short dbdiagram-style relationship symbols.", "enum": [">", "<", "-"], "type": "string" }, "to_table_uuid": { "description": "Target table UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "required": ["from_table_uuid", "to_table_uuid", "relationship"], "title": "ref data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='ref'.", "properties": { "from_table_uuid": { "description": "Source table UUID. Required for create.", "type": "string" }, "name": { "description": "Reference name.", "type": "string" }, "on_delete": { "description": "ON DELETE action.", "type": "string" }, "on_update": { "description": "ON UPDATE action.", "type": "string" }, "relationship": { "description": "Required for create. Use short dbdiagram-style relationship symbols.", "enum": [">", "<", "-"], "type": "string" }, "to_table_uuid": { "description": "Target table UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "ref data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "ref", "description": "Must be 'ref' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "ref operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='ref_column'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "from_column_uuid": { "description": "Source column UUID. Required for create.", "type": "string" }, "ref_uuid": { "description": "Reference UUID. Required for create; may be a data.uuid from an earlier ref operation.", "type": "string" }, "to_column_uuid": { "description": "Target column UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "required": ["ref_uuid", "from_column_uuid", "to_column_uuid"], "title": "ref_column data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='ref_column'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "from_column_uuid": { "description": "Source column UUID. Required for create.", "type": "string" }, "ref_uuid": { "description": "Reference UUID. Required for create; may be a data.uuid from an earlier ref operation.", "type": "string" }, "to_column_uuid": { "description": "Target column UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "ref_column data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "ref_column", "description": "Must be 'ref_column' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "ref_column operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='enum'.", "properties": { "name": { "description": "Enum name.", "type": "string" }, "note": { "description": "Enum note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "enum data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='enum'.", "properties": { "name": { "description": "Enum name.", "type": "string" }, "note": { "description": "Enum note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "enum data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "enum", "description": "Must be 'enum' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "enum operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='enum_value'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "enum_uuid": { "description": "Parent enum UUID. Required for create; may be a data.uuid from an earlier enum operation.", "type": "string" }, "note": { "description": "Enum value note.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" }, "value": { "description": "Enum value. Inline enum values on enum are not persisted; create enum_value operations.", "type": "string" } }, "required": ["enum_uuid"], "title": "enum_value data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='enum_value'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "enum_uuid": { "description": "Parent enum UUID. Required for create; may be a data.uuid from an earlier enum operation.", "type": "string" }, "note": { "description": "Enum value note.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" }, "value": { "description": "Enum value. Inline enum values on enum are not persisted; create enum_value operations.", "type": "string" } }, "title": "enum_value data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "enum_value", "description": "Must be 'enum_value' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "enum_value operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='table_group'.", "properties": { "color": { "description": "Group color.", "type": "string" }, "name": { "description": "Table group name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table_group data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='table_group'.", "properties": { "color": { "description": "Group color.", "type": "string" }, "name": { "description": "Table group name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table_group data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "table_group", "description": "Must be 'table_group' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "table_group operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='table_group_table'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "schema_name": { "description": "Table schema name.", "type": "string" }, "table_name": { "description": "Table name. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "required": ["group_uuid", "table_name"], "title": "table_group_table data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='table_group_table'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "schema_name": { "description": "Table schema name.", "type": "string" }, "table_name": { "description": "Table name. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table_group_table data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "table_group_table", "description": "Must be 'table_group_table' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "table_group_table operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='table_group_note'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "note_uuid": { "description": "Note UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "required": ["group_uuid", "note_uuid"], "title": "table_group_note data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='table_group_note'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "note_uuid": { "description": "Note UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table_group_note data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "table_group_note", "description": "Must be 'table_group_note' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "table_group_note operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='filter'.", "properties": { "included_tables": { "description": "JSON string/list of included tables.", "type": "string" }, "is_default": { "description": "Default filter flag.", "type": "boolean" }, "name": { "description": "Filter name.", "type": "string" }, "table_groups": { "description": "JSON string/object of table groups.", "type": "string" }, "table_positions": { "description": "JSON string/object of table positions.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "filter data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='filter'.", "properties": { "included_tables": { "description": "JSON string/list of included tables.", "type": "string" }, "is_default": { "description": "Default filter flag.", "type": "boolean" }, "name": { "description": "Filter name.", "type": "string" }, "table_groups": { "description": "JSON string/object of table groups.", "type": "string" }, "table_positions": { "description": "JSON string/object of table positions.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "filter data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "filter", "description": "Must be 'filter' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "filter operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='note'.", "properties": { "color": { "description": "Note color.", "type": "string" }, "content": { "description": "Note content.", "type": "string" }, "height": { "description": "Height.", "type": "integer" }, "icon_name": { "description": "Icon name.", "type": "string" }, "position_x": { "description": "X position.", "type": "integer" }, "position_y": { "description": "Y position.", "type": "integer" }, "title": { "description": "Note title.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" }, "width": { "description": "Width.", "type": "integer" } }, "title": "note data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='note'.", "properties": { "color": { "description": "Note color.", "type": "string" }, "content": { "description": "Note content.", "type": "string" }, "height": { "description": "Height.", "type": "integer" }, "icon_name": { "description": "Icon name.", "type": "string" }, "position_x": { "description": "X position.", "type": "integer" }, "position_y": { "description": "Y position.", "type": "integer" }, "title": { "description": "Note title.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" }, "width": { "description": "Width.", "type": "integer" } }, "title": "note data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "note", "description": "Must be 'note' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "note operation", "type": "object" }], "properties": { "data": { "description": "Type-specific payload. All field names are snake_case. For create, data.uuid may be client-supplied and referenced by later operations in the same batch.", "oneOf": [{ "description": "Payload for operation.type='table'.", "properties": { "alias": { "description": "Display alias.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "header_color": { "description": "Header color.", "type": "string" }, "name": { "description": "Table name. Required for create.", "type": "string" }, "note": { "description": "Table note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table data", "type": "object" }, { "description": "Payload for operation.type='column'.", "properties": { "default_value": { "description": "Default value.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "is_increment": { "description": "Auto-increment flag.", "type": "boolean" }, "is_not_null": { "description": "Not-null flag.", "type": "boolean" }, "is_pk": { "description": "Primary key flag.", "type": "boolean" }, "is_unique": { "description": "Unique flag.", "type": "boolean" }, "name": { "description": "Column name.", "type": "string" }, "note": { "description": "Column note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create; may be a data.uuid from an earlier table operation in this batch.", "type": "string" }, "type": { "description": "SQL data type. Use this exact field name; do not send data_type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "column data", "type": "object" }, { "description": "Payload for operation.type='index'.", "properties": { "is_pk": { "description": "Primary key index flag.", "type": "boolean" }, "is_unique": { "description": "Unique index flag.", "type": "boolean" }, "name": { "description": "Index name.", "type": "string" }, "note": { "description": "Index note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create.", "type": "string" }, "type": { "description": "Index type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "index data", "type": "object" }, { "description": "Payload for operation.type='index_column'.", "properties": { "column_uuid": { "description": "Column UUID. Required for create.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "index_uuid": { "description": "Index UUID. Required for create.", "type": "string" }, "sort_order": { "description": "Sort order, for example ASC or DESC.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "index_column data", "type": "object" }, { "description": "Payload for operation.type='ref'.", "properties": { "from_table_uuid": { "description": "Source table UUID. Required for create.", "type": "string" }, "name": { "description": "Reference name.", "type": "string" }, "on_delete": { "description": "ON DELETE action.", "type": "string" }, "on_update": { "description": "ON UPDATE action.", "type": "string" }, "relationship": { "description": "Required for create. Use short dbdiagram-style relationship symbols.", "enum": [">", "<", "-"], "type": "string" }, "to_table_uuid": { "description": "Target table UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "ref data", "type": "object" }, { "description": "Payload for operation.type='ref_column'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "from_column_uuid": { "description": "Source column UUID. Required for create.", "type": "string" }, "ref_uuid": { "description": "Reference UUID. Required for create; may be a data.uuid from an earlier ref operation.", "type": "string" }, "to_column_uuid": { "description": "Target column UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "ref_column data", "type": "object" }, { "description": "Payload for operation.type='enum'.", "properties": { "name": { "description": "Enum name.", "type": "string" }, "note": { "description": "Enum note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "enum data", "type": "object" }, { "description": "Payload for operation.type='enum_value'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "enum_uuid": { "description": "Parent enum UUID. Required for create; may be a data.uuid from an earlier enum operation.", "type": "string" }, "note": { "description": "Enum value note.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" }, "value": { "description": "Enum value. Inline enum values on enum are not persisted; create enum_value operations.", "type": "string" } }, "title": "enum_value data", "type": "object" }, { "description": "Payload for operation.type='table_group'.", "properties": { "color": { "description": "Group color.", "type": "string" }, "name": { "description": "Table group name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table_group data", "type": "object" }, { "description": "Payload for operation.type='table_group_table'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "schema_name": { "description": "Table schema name.", "type": "string" }, "table_name": { "description": "Table name. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table_group_table data", "type": "object" }, { "description": "Payload for operation.type='table_group_note'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "note_uuid": { "description": "Note UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table_group_note data", "type": "object" }, { "description": "Payload for operation.type='filter'.", "properties": { "included_tables": { "description": "JSON string/list of included tables.", "type": "string" }, "is_default": { "description": "Default filter flag.", "type": "boolean" }, "name": { "description": "Filter name.", "type": "string" }, "table_groups": { "description": "JSON string/object of table groups.", "type": "string" }, "table_positions": { "description": "JSON string/object of table positions.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "filter data", "type": "object" }, { "description": "Payload for operation.type='note'.", "properties": { "color": { "description": "Note color.", "type": "string" }, "content": { "description": "Note content.", "type": "string" }, "height": { "description": "Height.", "type": "integer" }, "icon_name": { "description": "Icon name.", "type": "string" }, "position_x": { "description": "X position.", "type": "integer" }, "position_y": { "description": "Y position.", "type": "integer" }, "title": { "description": "Note title.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" }, "width": { "description": "Width.", "type": "integer" } }, "title": "note data", "type": "object" }], "type": "object" }, "op": { "description": "Operation. For create, put any new UUID in data.uuid; for update/delete, put target UUID in operation.uuid.", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "description": "ERD entity type. This selects the operation.data shape.", "enum": ["table", "column", "index", "index_column", "ref", "ref_column", "enum", "enum_value", "table_group", "table_group_table", "table_group_note", "filter", "note"], "type": "string" }, "uuid": { "description": "Target UUID for update/delete. Do not use this for create; use data.uuid instead.", "type": "string" } }, "required": ["op", "type"], "type": "object" }, "type": "array" } }, "required": ["documentUuid", "description", "operations"], "type": "object" }, "required": ["description", "documentUuid", "operations"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "dd64d1f996060ab1" },
-  { "mcpName": "mcp__ainecto__erd_arrange_tables", "commandPath": ["erd", "arrange-tables"], "group": "erd", "description": "Arrange ERD tables after edits. Default incremental mode places newly-created tables while preserving existing positions; full=true re-layouts the entire diagram. Use after several separate table edits to tidy the canvas.", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "full": { "description": "Re-layout the ENTIRE diagram (overwrites existing positions). Default false = arrange only newly-added (uncoordinated) tables to the top-right while preserving existing table positions. Call this after creating several tables to tidy them up.", "type": "boolean" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "d2e66548e3d60d30" },
-  { "mcpName": "mcp__ainecto__erd_get_enum", "commandPath": ["erd", "get-enum"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "enumUuid": { "description": "Enum UUID", "type": "string" } }, "required": ["documentUuid", "enumUuid"], "type": "object" }, "required": ["documentUuid", "enumUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "1e477b3fadb50c6b" },
-  { "mcpName": "mcp__ainecto__erd_get_ref", "commandPath": ["erd", "get-ref"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "refUuid": { "description": "Relationship UUID", "type": "string" } }, "required": ["documentUuid", "refUuid"], "type": "object" }, "required": ["documentUuid", "refUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "40bf1eb02e7a9730" },
-  { "mcpName": "mcp__ainecto__erd_get_table", "commandPath": ["erd", "get-table"], "group": "erd", "description": "Get one ERD table with nested columns and indexes. Returns persistent table/column/index UUIDs usable directly as mcp__ainecto__erd_apply_changes update/delete targets and ref_column column references. Column fields use apply_changes snake_case names: uuid, table_uuid, name, type, is_pk, is_unique, is_not_null, is_increment, default_value, note, display_order. Index fields include uuid, name, columns (column UUIDs), is_unique, is_pk, type.", "inputSchema": { "description": "Get one ERD table with nested columns and indexes. Returns persistent table/column/index UUIDs usable directly as mcp__ainecto__erd_apply_changes update/delete targets and ref_column column references. Column fields use apply_changes snake_case names: uuid, table_uuid, name, type, is_pk, is_unique, is_not_null, is_increment, default_value, note, display_order. Index fields include uuid, name, columns (column UUIDs), is_unique, is_pk, type.", "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "tableUuid": { "description": "Table UUID. Response includes columns[] and indexes[] with persistent UUIDs for apply_changes.", "type": "string" } }, "required": ["documentUuid", "tableUuid"], "type": "object" }, "required": ["documentUuid", "tableUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "8edd40794f39f47a" },
-  { "mcpName": "mcp__ainecto__erd_get_table_group", "commandPath": ["erd", "get-table-group"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "tableGroupUuid": { "description": "Table group UUID", "type": "string" } }, "required": ["documentUuid", "tableGroupUuid"], "type": "object" }, "required": ["documentUuid", "tableGroupUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "bcd417344639c0c9" },
-  { "mcpName": "mcp__ainecto__erd_list_enums", "commandPath": ["erd", "list-enums"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "e0c2207905dbb068" },
-  { "mcpName": "mcp__ainecto__erd_list_refs", "commandPath": ["erd", "list-refs"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "9ae2e04c310b57f2" },
-  { "mcpName": "mcp__ainecto__erd_list_table_groups", "commandPath": ["erd", "list-table-groups"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "dc8811071df04ac2" },
-  { "mcpName": "mcp__ainecto__erd_list_tables", "commandPath": ["erd", "list-tables"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "ca05b35b174fc209" },
-  { "mcpName": "mcp__ainecto__get_attachment", "commandPath": ["attachment", "get"], "group": "attachment", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Attachment UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "12bee70f6d254a5d" },
-  { "mcpName": "mcp__ainecto__get_document", "commandPath": ["document", "get"], "group": "document", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4949c8a5bb425491" },
-  { "mcpName": "mcp__ainecto__get_project", "commandPath": ["project", "get"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Project UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "b4ee9097f4b80df4" },
-  { "mcpName": "mcp__ainecto__get_version", "commandPath": ["version", "get"], "group": "generic", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "Document UUID", "type": "string" }, "versionNumber": { "description": "Version number", "type": "integer" } }, "required": ["documentUuid", "versionNumber"], "type": "object" }, "required": ["documentUuid", "versionNumber"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "ad81d04200d3d7f5" },
-  { "mcpName": "mcp__ainecto__get_workspace", "commandPath": ["workspace", "get"], "group": "workspace", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Workspace UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "ef7bae555463116e" },
-  { "mcpName": "mcp__ainecto__list_attachments", "commandPath": ["attachments", "list"], "group": "attachment", "description": "", "inputSchema": { "properties": { "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid"], "type": "object" }, "required": ["projectUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "a75657bb2e5eb383" },
-  { "mcpName": "mcp__ainecto__list_documents", "commandPath": ["documents", "list"], "group": "document", "description": "", "inputSchema": { "properties": { "folderUuid": { "description": "Optional folder UUID", "type": "string" }, "limit": { "description": "Result cap when q is set (default 50)", "type": "integer" }, "projectUuid": { "description": "Project UUID", "type": "string" }, "q": { "description": "Optional full-text query. When provided, results come from the search index instead of folder listing.", "type": "string" }, "type": { "description": "Optional document type filter. Enabled values: erd, markdown.", "enum": ["erd", "markdown"], "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "8dca77c1db9372c4" },
-  { "mcpName": "mcp__ainecto__list_folders", "commandPath": ["folders", "list"], "group": "generic", "description": "", "inputSchema": { "properties": { "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid"], "type": "object" }, "required": ["projectUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "f3cde57fe87d375c" },
-  { "mcpName": "mcp__ainecto__list_projects", "commandPath": ["projects", "list"], "group": "generic", "description": "", "inputSchema": { "properties": { "limit": { "description": "Result cap when q is set (default 50)", "type": "integer" }, "q": { "description": "Optional full-text query", "type": "string" }, "workspaceUuid": { "description": "Optional Workspace UUID", "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "9174d6965d7e53f5" },
-  { "mcpName": "mcp__ainecto__list_trash", "commandPath": ["trash", "list"], "group": "generic", "description": "", "inputSchema": { "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "82f8586d68bfcd7d" },
-  { "mcpName": "mcp__ainecto__list_versions", "commandPath": ["versions", "list"], "group": "generic", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "Document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "370e4b8b8ec18e18" },
-  { "mcpName": "mcp__ainecto__list_workspaces", "commandPath": ["workspaces", "list"], "group": "workspace", "description": "", "inputSchema": { "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "7c32c74000696b2f" },
-  { "mcpName": "mcp__ainecto__markdown_append_document", "commandPath": ["markdown", "append-document"], "group": "markdown", "description": "Append to Markdown documents. If the appended body is tens of KB or more, prefer request_upload_token (purpose=document.append) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Appends", "items": { "properties": { "addition": { "description": "Body addition. \uCD94\uAC00\uD560 \uB0B4\uC6A9\uC774 \uD06C\uBA74 (\uC218\uC2ED KB \uC774\uC0C1) LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.append, scopeJson={documentUuid, separator})` \uB85C uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "separator": { "description": "Separator between existing body and addition", "type": "string" }, "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid", "addition"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "f189514b3cccd1cc" },
-  { "mcpName": "mcp__ainecto__markdown_generate_document", "commandPath": ["markdown", "generate-document"], "group": "markdown", "description": "", "inputSchema": { "properties": { "items": { "description": "Generation requests", "items": { "properties": { "context": { "description": "Optional JSON context", "type": "string" }, "documentUuid": { "description": "Target document UUID", "type": "string" }, "prompt": { "description": "Generation prompt", "type": "string" } }, "required": ["documentUuid", "prompt"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "72114a2d2642ed92" },
-  { "mcpName": "mcp__ainecto__move_documents", "commandPath": ["documents", "move"], "group": "document", "description": "", "inputSchema": { "properties": { "clientMutationId": { "description": "Optional mutation identifier for client retry tracing", "maxLength": 128, "minLength": 1, "pattern": "^[\\x21-\\x7E]{1,128}$", "type": "string" }, "items": { "description": "Moves", "items": { "properties": { "newFolderUuid": { "description": "New folder UUID \u2014 null/empty for root", "type": "string" }, "targetProjectUuid": { "description": "Target project UUID \u2014 omit to stay in current project", "type": "string" }, "targetWorkspaceUuid": { "description": "Guard only: must match targetProjectUuid workspace", "type": "string" }, "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "9758d6a262913a3f" },
-  { "mcpName": "mcp__ainecto__move_folders", "commandPath": ["folders", "move"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Moves", "items": { "properties": { "newParentFolderUuid": { "description": "New parent UUID \u2014 null/empty for root", "type": "string" }, "uuid": { "description": "Folder UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "612a779b1fd176bb" },
-  { "mcpName": "mcp__ainecto__request_upload_token", "commandPath": ["tools", "run", "request-upload-token"], "group": "attachment", "description": "Use this for large payloads of tens of KB or more to save LLM tokens. purpose=mcp.call returns a short-lived bearer token that can call any MCP tool, including mcp__ainecto__erd_apply_changes, via curl. purpose=document.create/update/append uploads document bodies directly to the upload endpoint with PUT/curl. Tokens are reusable for 5 minutes by default.", "inputSchema": { "properties": { "maxBytes": { "description": "\uCD5C\uB300 \uC5C5\uB85C\uB4DC byte (\uC11C\uBC84 \uCE21 \uD55C\uB3C4)", "type": "integer" }, "purpose": { "description": "Token \uC6A9\uB3C4. `mcp.call` \uC740 curl \uB85C /mcp \uD638\uCD9C, `document.create/update/append` \uB294 PUT body \uB85C \uBCF8\uBB38 \uC5C5\uB85C\uB4DC, `attachment.upload` \uB294 \uD30C\uC77C bytes \uC5C5\uB85C\uB4DC. \uCF58\uD150\uCE20\uAC00 \uD06C\uBA74 (\uC218\uC2ED KB \uC774\uC0C1) LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 \uC774 \uB3C4\uAD6C\uB85C 5\uBD84 \uC7AC\uC0AC\uC6A9 \uD1A0\uD070\uC744 \uBC1B\uACE0 curl \uB85C \uBCF4\uB0B4\uB294 \uAC83\uC744 \uAC15\uB825 \uAD8C\uC7A5.", "enum": ["mcp.call", "document.create", "document.update", "document.append", "attachment.upload"], "type": "string" }, "scopeJson": { "description": "\uC120\uD0DD \u2014 JSON scope. document.create \uB294 projectUuid, type, title \uC744 \uD3EC\uD568\uD558\uACE0 enabled type values \uB294 erd, markdown. document.update/document.append \uB294 documentUuid \uB97C \uD3EC\uD568. attachment.upload: {documentUuid, filename, contentType?, sizeBytes?}; storageKey \uB294 \uC11C\uBC84\uAC00 \uBC1C\uAE09 scope \uC5D0 \uCD94\uAC00.", "type": "string" }, "ttlSeconds": { "description": "TTL (\uCD08). \uAE30\uBCF8 300 (5\uBD84)", "type": "integer" } }, "required": ["purpose"], "type": "object" }, "required": ["purpose"], "payloadMode": "binary-upload", "destructive": false, "sourceCatalog": "prod", "schemaHash": "f1eb94523f43e72b" },
-  { "mcpName": "mcp__ainecto__restore_versions", "commandPath": ["versions", "restore"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Restores", "items": { "properties": { "documentUuid": { "description": "Document UUID", "type": "string" }, "versionNumber": { "description": "Version number to restore", "type": "integer" } }, "required": ["documentUuid", "versionNumber"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "c4f448cc3b96c7a6" },
-  { "mcpName": "mcp__ainecto__search_documents", "commandPath": ["documents", "search"], "group": "document", "description": "", "inputSchema": { "properties": { "limit": { "description": "\uACB0\uACFC \uAC1C\uC218 (\uAE30\uBCF8 20, \uCD5C\uB300 50)", "type": "integer" }, "offset": { "description": "\uD398\uC774\uC9C0\uB124\uC774\uC158 offset (\uAE30\uBCF8 0)", "type": "integer" }, "projectUuid": { "description": "\uD2B9\uC815 \uD504\uB85C\uC81D\uD2B8\uB85C \uD55C\uC815 (\uC120\uD0DD)", "type": "string" }, "q": { "description": "\uAC80\uC0C9 \uD0A4\uC6CC\uB4DC", "type": "string" }, "type": { "description": "Optional document type filter. Enabled values: erd, markdown.", "enum": ["erd", "markdown"], "type": "string" } }, "required": ["q"], "type": "object" }, "required": ["q"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "b88c3537086d0c7a" },
-  { "mcpName": "mcp__ainecto__unarchive_documents", "commandPath": ["documents", "unarchive"], "group": "document", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Document UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "4aae7df04fba8779" },
-  { "mcpName": "mcp__ainecto__unarchive_folders", "commandPath": ["folders", "unarchive"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Folder UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "e307cab0ebafd179" },
-  { "mcpName": "mcp__ainecto__unarchive_projects", "commandPath": ["projects", "unarchive"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Project UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "15ea4a409d1549de" },
-  { "mcpName": "mcp__ainecto__unarchive_workspaces", "commandPath": ["workspaces", "unarchive"], "group": "workspace", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Workspace UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "641de5b64ec75ab2" },
-  { "mcpName": "mcp__ainecto__update_documents", "commandPath": ["documents", "update"], "group": "document", "description": "Update documents. If a replacement body is tens of KB or more, prefer request_upload_token (purpose=document.update) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "body": { "description": "Deprecated compatibility alias for typePayload.body when document type is markdown. \uBCF8\uBB38\uC774 \uC218\uC2ED KB \uC774\uC0C1\uC73C\uB85C \uD06C\uBA74 LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.update)` \uB97C \uD638\uCD9C\uD574 uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C \uC9C1\uC811 PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "title": { "description": "New title", "type": "string" }, "typePayload": { "description": "Type-specific payload for enabled document types. markdown: {body}.", "type": "object" }, "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "5bedb6e5f5ba4f8d" },
-  { "mcpName": "mcp__ainecto__update_folders", "commandPath": ["folders", "update"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "name": { "description": "New name", "type": "string" }, "uuid": { "description": "Folder UUID", "type": "string" } }, "required": ["uuid", "name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "7bef3b4702df1f00" },
-  { "mcpName": "mcp__ainecto__update_projects", "commandPath": ["projects", "update"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "description": { "description": "New description", "type": "string" }, "name": { "description": "New name", "type": "string" }, "uuid": { "description": "Project UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "10cc0d84aeb2192b" },
-  { "mcpName": "mcp__ainecto__update_workspaces", "commandPath": ["workspaces", "update"], "group": "workspace", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "description": { "description": "New description", "type": "string" }, "name": { "description": "New name", "type": "string" }, "uuid": { "description": "Workspace UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "723e4f6d36ee9d02" },
-  { "mcpName": "mcp__ainecto__upload_attachments", "commandPath": ["tools", "run", "upload-attachments"], "group": "attachment", "description": "", "inputSchema": { "properties": { "items": { "description": "Attachments to register", "items": { "properties": { "contentType": { "description": "MIME type", "type": "string" }, "documentUuid": { "description": "Parent document UUID", "type": "string" }, "filename": { "description": "Original file name", "type": "string" }, "sizeBytes": { "description": "Size in bytes", "type": "integer" }, "storageKey": { "description": "Storage key returned by request_upload_token purpose=attachment.upload", "type": "string" } }, "required": ["documentUuid", "filename", "storageKey"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "binary-upload", "destructive": false, "sourceCatalog": "prod", "schemaHash": "0622e590de3404dd" }
+  { "mcpName": "create_documents", "commandPath": ["documents", "create"], "group": "document", "description": "Create documents. If a document body is tens of KB or more, prefer request_upload_token (purpose=document.create) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Documents", "items": { "properties": { "body": { "description": "Deprecated compatibility alias for typePayload.body when document type is markdown. \uBCF8\uBB38\uC774 \uC218\uC2ED KB \uC774\uC0C1\uC73C\uB85C \uD06C\uBA74 LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.create)` \uB97C \uD638\uCD9C\uD574 uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C \uC9C1\uC811 PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "folderUuid": { "description": "Optional folder UUID", "type": "string" }, "projectUuid": { "description": "Project UUID", "type": "string" }, "title": { "description": "Document title", "type": "string" }, "type": { "description": "Document type. Creatable values: erd, markdown, diagram, openapi, html.", "enum": ["erd", "markdown", "diagram", "openapi", "html"], "type": "string" }, "typePayload": { "description": "Type-specific payload for enabled document types. markdown: {body}; diagram: {diagramSource,sourceLanguage,edgeStyle,isModule,metadata}; openapi: {content}; html: {content} (a full HTML page).", "type": "object" } }, "required": ["projectUuid", "type", "title"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "105d051791cf595b" },
+  { "mcpName": "create_folders", "commandPath": ["folders", "create"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Folders", "items": { "properties": { "name": { "description": "Folder name", "type": "string" }, "parentFolderUuid": { "description": "Parent folder UUID", "type": "string" }, "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid", "name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "30f45b887259609f" },
+  { "mcpName": "create_projects", "commandPath": ["projects", "create"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Projects", "items": { "properties": { "description": { "description": "Description", "type": "string" }, "name": { "description": "Project name", "type": "string" }, "projectKey": { "description": "Unique project key", "type": "string" }, "workspaceUuid": { "description": "Workspace UUID \u2014 null uses user's default workspace", "type": "string" } }, "required": ["name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "edf5cf688d7c039a" },
+  { "mcpName": "create_workspaces", "commandPath": ["workspaces", "create"], "group": "workspace", "description": "", "inputSchema": { "properties": { "items": { "description": "Workspaces", "items": { "properties": { "description": { "description": "Description", "type": "string" }, "name": { "description": "Workspace name", "type": "string" } }, "required": ["name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "d9d1b0d561828b8e" },
+  { "mcpName": "delete_attachments", "commandPath": ["attachments", "delete"], "group": "attachment", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Attachment UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "b22c24bffdfe3d7d" },
+  { "mcpName": "delete_documents", "commandPath": ["documents", "delete"], "group": "document", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Document UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "3a725ae70956c270" },
+  { "mcpName": "delete_folders", "commandPath": ["folders", "delete"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Folder UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "2254cde89c9e8f06" },
+  { "mcpName": "delete_projects", "commandPath": ["projects", "delete"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Project UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "6521c33a28cb5465" },
+  { "mcpName": "delete_workspaces", "commandPath": ["workspaces", "delete"], "group": "workspace", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Workspace UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "3177868221137066" },
+  { "mcpName": "diagram_apply_changes", "commandPath": ["tools", "run", "diagram-apply-changes"], "group": "generic", "description": "Required single-call mutation path for diagram node/edge/group create/update/delete changes. Put nodes, edges, and groups in one request and call this once. Do not look for type-specific diagram CUD tools; this tool is the only diagram CUD entry point.", "inputSchema": { "properties": { "description": { "description": "Reason for batch (audit)", "type": "string" }, "diagramUuid": { "description": "Diagram UUID", "type": "string" }, "edges": { "description": "Edge operations", "items": { "properties": { "action": { "description": "Operation kind", "enum": ["create", "update", "delete"], "type": "string" }, "bridgeType": { "description": "Bridge type", "type": "string" }, "fromUuid": { "description": "Source", "type": "string" }, "label": { "description": "Edge label", "type": "string" }, "lineStyle": { "description": "Line style", "type": "string" }, "strokeColor": { "description": "Stroke color", "type": "string" }, "strokeWidth": { "description": "Stroke width", "type": "integer" }, "toUuid": { "description": "Target", "type": "string" }, "uuid": { "description": "Required for update/delete", "type": "string" } }, "required": ["action"], "type": "object" }, "type": "array" }, "groups": { "description": "Group operations", "items": { "properties": { "action": { "description": "Operation kind", "enum": ["create", "update", "delete"], "type": "string" }, "collapsed": { "description": "Collapsed state", "type": "boolean" }, "color": { "description": "Group color", "type": "string" }, "height": { "description": "Explicit height; omit to keep it derived from member nodes", "type": "number" }, "linkMode": { "description": "Link mode", "type": "string" }, "linkedDiagramUuid": { "description": "Linked diagram UUID", "type": "string" }, "name": { "description": "Group name", "type": "string" }, "parentGroupUuid": { "description": "Parent group UUID", "type": "string" }, "sortOrder": { "description": "Sort order", "type": "integer" }, "uuid": { "description": "Required for update/delete", "type": "string" }, "width": { "description": "Explicit width; omit to keep it derived from member nodes", "type": "number" } }, "required": ["action"], "type": "object" }, "type": "array" }, "nodes": { "description": "Node operations", "items": { "properties": { "action": { "description": "Operation kind", "enum": ["create", "update", "delete"], "type": "string" }, "fillColor": { "description": "Fill color", "type": "string" }, "groupUuid": { "description": "Group UUID; empty string clears membership", "type": "string" }, "height": { "description": "Height", "type": "number" }, "shape": { "description": "Node shape (start/end/diamond/cylinder/parallelogram/stadium/hexagon/rect/roundRect/...)", "enum": ["rect", "roundRect", "stadium", "diamond", "decision", "circle", "start", "doubleCircle", "end", "hexagon", "cylinder", "parallelogram"], "type": "string" }, "strokeColor": { "description": "Stroke color", "type": "string" }, "text": { "description": "Node text/label. Supports newlines (\\n) for multi-line display.", "maxLength": 4e3, "type": "string" }, "textColor": { "description": "Text color", "type": "string" }, "type": { "description": "Node type", "type": "string" }, "uuid": { "description": "Required for update/delete; optional for create", "type": "string" }, "width": { "description": "Width", "type": "number" }, "x": { "description": "X", "type": "number" }, "y": { "description": "Y", "type": "number" } }, "required": ["action"], "type": "object" }, "type": "array" } }, "required": ["diagramUuid", "description"], "type": "object" }, "required": ["description", "diagramUuid"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "add78d8edce88c86" },
+  { "mcpName": "diagram_get_edge", "commandPath": ["tools", "run", "diagram-get-edge"], "group": "generic", "description": "", "inputSchema": { "properties": { "edgeUuid": { "description": "Edge UUID", "type": "string" } }, "required": ["edgeUuid"], "type": "object" }, "required": ["edgeUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "2c03c4f7daa69898" },
+  { "mcpName": "diagram_get_group", "commandPath": ["tools", "run", "diagram-get-group"], "group": "generic", "description": "", "inputSchema": { "properties": { "groupUuid": { "description": "Group UUID", "type": "string" } }, "required": ["groupUuid"], "type": "object" }, "required": ["groupUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "55c5aa27b8cf489d" },
+  { "mcpName": "diagram_get_node", "commandPath": ["tools", "run", "diagram-get-node"], "group": "generic", "description": "", "inputSchema": { "properties": { "nodeUuid": { "description": "Node UUID", "type": "string" } }, "required": ["nodeUuid"], "type": "object" }, "required": ["nodeUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "646d553238328a9e" },
+  { "mcpName": "diagram_get_pending_llm_requests", "commandPath": ["tools", "run", "diagram-get-pending-llm-requests"], "group": "generic", "description": "", "inputSchema": { "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "2143d616cf7822bf" },
+  { "mcpName": "diagram_list_edges", "commandPath": ["tools", "run", "diagram-list-edges"], "group": "generic", "description": "", "inputSchema": { "properties": { "diagramUuid": { "description": "Diagram document UUID", "type": "string" } }, "required": ["diagramUuid"], "type": "object" }, "required": ["diagramUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4645085bde616381" },
+  { "mcpName": "diagram_list_groups", "commandPath": ["tools", "run", "diagram-list-groups"], "group": "generic", "description": "", "inputSchema": { "properties": { "diagramUuid": { "description": "Diagram document UUID", "type": "string" } }, "required": ["diagramUuid"], "type": "object" }, "required": ["diagramUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "8a7ca45dd34d1aef" },
+  { "mcpName": "diagram_list_nodes", "commandPath": ["tools", "run", "diagram-list-nodes"], "group": "generic", "description": "", "inputSchema": { "properties": { "diagramUuid": { "description": "Diagram document UUID", "type": "string" } }, "required": ["diagramUuid"], "type": "object" }, "required": ["diagramUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "d444066b5ca6eeb4" },
+  { "mcpName": "diagram_submit_llm_result", "commandPath": ["tools", "run", "diagram-submit-llm-result"], "group": "generic", "description": "", "inputSchema": { "properties": { "cachedInputTokens": { "description": "Cached subset of provider total input tokens", "type": "integer" }, "creditsCharged": { "description": "Deprecated; ignored. Credits are calculated server-side from tokens.", "type": "integer" }, "inputTokens": { "description": "Provider total input tokens; Java persists uncached input after one normalization", "type": "integer" }, "outputTokens": { "description": "Output token count", "type": "integer" }, "result": { "description": "LLM result text", "type": "string" }, "uuid": { "description": "LLM request UUID", "type": "string" } }, "required": ["uuid", "result"], "type": "object" }, "required": ["result", "uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "870ace32642a770a" },
+  { "mcpName": "diagram_update_llm_request_status", "commandPath": ["tools", "run", "diagram-update-llm-request-status"], "group": "generic", "description": "", "inputSchema": { "properties": { "errorMessage": { "description": "Error message (when status=FAILED)", "type": "string" }, "status": { "description": "Target status \u2014 currently only FAILED is mutable from caller side", "enum": ["FAILED"], "type": "string" }, "uuid": { "description": "LLM request UUID", "type": "string" } }, "required": ["uuid", "status"], "type": "object" }, "required": ["status", "uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "9ad96e3dc5fd2a8f" },
+  { "mcpName": "disable_shares", "commandPath": ["tools", "run", "disable-shares"], "group": "generic", "description": "", "inputSchema": { "properties": { "targetType": { "description": "Share target type", "enum": ["project", "folder", "document"], "type": "string" }, "targetUuids": { "description": "Target UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["targetType", "targetUuids"], "type": "object" }, "required": ["targetType", "targetUuids"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "bd1b310200b78420" },
+  { "mcpName": "enable_shares", "commandPath": ["tools", "run", "enable-shares"], "group": "generic", "description": "", "inputSchema": { "properties": { "targetType": { "description": "Share target type. A document gets a shareUrl anyone can open; a project gets a public API path only (there is no public project page); a folder token is stored but nothing public reads it yet.", "enum": ["project", "folder", "document"], "type": "string" }, "targetUuids": { "description": "Target UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["targetType", "targetUuids"], "type": "object" }, "required": ["targetType", "targetUuids"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "18559d7c0af09d2c" },
+  { "mcpName": "erd_apply_changes", "commandPath": ["erd", "apply-changes"], "group": "erd", "description": 'Required single-call mutation path for ERD create/update/delete changes. Put tables, columns, indexes, refs, enums, enum_values, and table groups in one operations array and call this once.\nRules: (1) all data field names are snake_case; (2) for create, generate your own UUIDs and put them in data.uuid, then later operations in the same batch may reference those UUIDs without read-back calls; (3) enum values are separate enum_value operations, not inline on enum; (4) ref.relationship uses short dbdiagram-style symbols: >, <, or -; (5) ref_column operations map FK columns explicitly, never automatically.\nDo not look for type-specific ERD CUD tools; this tool is the only ERD CUD entry point. If operations is very large, use request_upload_token with purpose=mcp.call and send the tools/call payload with curl to save LLM tokens.\nOne-call worked example:\n{\n  "documentUuid": "erd-doc-uuid",\n  "description": "create users/posts ERD",\n  "operations": [\n    {"op":"create","type":"table","data":{"uuid":"tbl_users","name":"users","display_order":1}},\n    {"op":"create","type":"column","data":{"uuid":"col_users_id","table_uuid":"tbl_users","name":"id","type":"bigint","is_pk":true,"is_not_null":true,"display_order":1}},\n    {"op":"create","type":"column","data":{"uuid":"col_users_email","table_uuid":"tbl_users","name":"email","type":"varchar(255)","is_unique":true,"is_not_null":true,"display_order":2}},\n    {"op":"create","type":"table","data":{"uuid":"tbl_posts","name":"posts","display_order":2}},\n    {"op":"create","type":"column","data":{"uuid":"col_posts_id","table_uuid":"tbl_posts","name":"id","type":"bigint","is_pk":true,"is_not_null":true,"display_order":1}},\n    {"op":"create","type":"column","data":{"uuid":"col_posts_author_id","table_uuid":"tbl_posts","name":"author_id","type":"bigint","is_not_null":true,"display_order":2}},\n    {"op":"create","type":"column","data":{"uuid":"col_posts_status","table_uuid":"tbl_posts","name":"status","type":"post_status","is_not_null":true,"display_order":3}},\n    {"op":"create","type":"enum","data":{"uuid":"enum_post_status","name":"post_status"}},\n    {"op":"create","type":"enum_value","data":{"uuid":"enum_post_status_draft","enum_uuid":"enum_post_status","value":"draft","display_order":1}},\n    {"op":"create","type":"enum_value","data":{"uuid":"enum_post_status_published","enum_uuid":"enum_post_status","value":"published","display_order":2}},\n    {"op":"create","type":"ref","data":{"uuid":"ref_posts_author","name":"fk_posts_author","from_table_uuid":"tbl_posts","to_table_uuid":"tbl_users","relationship":">","on_delete":"cascade"}},\n    {"op":"create","type":"ref_column","data":{"uuid":"refcol_posts_author","ref_uuid":"ref_posts_author","from_column_uuid":"col_posts_author_id","to_column_uuid":"col_users_id","display_order":1}}\n  ]\n}', "inputSchema": { "properties": { "arrangeNewTables": { "description": "Whether to auto-place newly-created tables after the batch; defaults to true", "type": "boolean" }, "description": { "description": "Reason for batch (audit)", "type": "string" }, "documentUuid": { "description": "ERD document UUID", "type": "string" }, "operations": { "description": "Atomic create/update/delete operations", "items": { "description": "One ERD mutation. Use a single operations array with client-generated data.uuid values to create cross-referenced tables, columns, enums, refs, and ref_columns without read-back calls.", "discriminator": { "propertyName": "type" }, "oneOf": [{ "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='table'.", "properties": { "alias": { "description": "Display alias.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "header_color": { "description": "Header color.", "type": "string" }, "name": { "description": "Table name. Required for create.", "type": "string" }, "note": { "description": "Table note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "required": ["name"], "title": "table data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='table'.", "properties": { "alias": { "description": "Display alias.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "header_color": { "description": "Header color.", "type": "string" }, "name": { "description": "Table name. Required for create.", "type": "string" }, "note": { "description": "Table note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "table", "description": "Must be 'table' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "table operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='column'.", "properties": { "default_value": { "description": "Default value.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "is_increment": { "description": "Auto-increment flag.", "type": "boolean" }, "is_not_null": { "description": "Not-null flag.", "type": "boolean" }, "is_pk": { "description": "Primary key flag.", "type": "boolean" }, "is_unique": { "description": "Unique flag.", "type": "boolean" }, "name": { "description": "Column name.", "type": "string" }, "note": { "description": "Column note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create; may be a data.uuid from an earlier table operation in this batch.", "type": "string" }, "type": { "description": "SQL data type. Use this exact field name; do not send data_type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "required": ["table_uuid"], "title": "column data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='column'.", "properties": { "default_value": { "description": "Default value.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "is_increment": { "description": "Auto-increment flag.", "type": "boolean" }, "is_not_null": { "description": "Not-null flag.", "type": "boolean" }, "is_pk": { "description": "Primary key flag.", "type": "boolean" }, "is_unique": { "description": "Unique flag.", "type": "boolean" }, "name": { "description": "Column name.", "type": "string" }, "note": { "description": "Column note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create; may be a data.uuid from an earlier table operation in this batch.", "type": "string" }, "type": { "description": "SQL data type. Use this exact field name; do not send data_type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "column data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "column", "description": "Must be 'column' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "column operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='index'.", "properties": { "is_pk": { "description": "Primary key index flag.", "type": "boolean" }, "is_unique": { "description": "Unique index flag.", "type": "boolean" }, "name": { "description": "Index name.", "type": "string" }, "note": { "description": "Index note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create.", "type": "string" }, "type": { "description": "Index type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "required": ["table_uuid"], "title": "index data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='index'.", "properties": { "is_pk": { "description": "Primary key index flag.", "type": "boolean" }, "is_unique": { "description": "Unique index flag.", "type": "boolean" }, "name": { "description": "Index name.", "type": "string" }, "note": { "description": "Index note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create.", "type": "string" }, "type": { "description": "Index type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "index data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "index", "description": "Must be 'index' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "index operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='index_column'.", "properties": { "column_uuid": { "description": "Column UUID. Required for create.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "index_uuid": { "description": "Index UUID. Required for create.", "type": "string" }, "sort_order": { "description": "Sort order, for example ASC or DESC.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "required": ["index_uuid", "column_uuid"], "title": "index_column data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='index_column'.", "properties": { "column_uuid": { "description": "Column UUID. Required for create.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "index_uuid": { "description": "Index UUID. Required for create.", "type": "string" }, "sort_order": { "description": "Sort order, for example ASC or DESC.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "index_column data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "index_column", "description": "Must be 'index_column' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "index_column operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='ref'.", "properties": { "from_table_uuid": { "description": "Source table UUID. Required for create.", "type": "string" }, "name": { "description": "Reference name.", "type": "string" }, "on_delete": { "description": "ON DELETE action.", "type": "string" }, "on_update": { "description": "ON UPDATE action.", "type": "string" }, "relationship": { "description": "Required for create. Use short dbdiagram-style relationship symbols.", "enum": [">", "<", "-"], "type": "string" }, "to_table_uuid": { "description": "Target table UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "required": ["from_table_uuid", "to_table_uuid", "relationship"], "title": "ref data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='ref'.", "properties": { "from_table_uuid": { "description": "Source table UUID. Required for create.", "type": "string" }, "name": { "description": "Reference name.", "type": "string" }, "on_delete": { "description": "ON DELETE action.", "type": "string" }, "on_update": { "description": "ON UPDATE action.", "type": "string" }, "relationship": { "description": "Required for create. Use short dbdiagram-style relationship symbols.", "enum": [">", "<", "-"], "type": "string" }, "to_table_uuid": { "description": "Target table UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "ref data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "ref", "description": "Must be 'ref' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "ref operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='ref_column'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "from_column_uuid": { "description": "Source column UUID. Required for create.", "type": "string" }, "ref_uuid": { "description": "Reference UUID. Required for create; may be a data.uuid from an earlier ref operation.", "type": "string" }, "to_column_uuid": { "description": "Target column UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "required": ["ref_uuid", "from_column_uuid", "to_column_uuid"], "title": "ref_column data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='ref_column'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "from_column_uuid": { "description": "Source column UUID. Required for create.", "type": "string" }, "ref_uuid": { "description": "Reference UUID. Required for create; may be a data.uuid from an earlier ref operation.", "type": "string" }, "to_column_uuid": { "description": "Target column UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "ref_column data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "ref_column", "description": "Must be 'ref_column' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "ref_column operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='enum'.", "properties": { "name": { "description": "Enum name.", "type": "string" }, "note": { "description": "Enum note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "enum data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='enum'.", "properties": { "name": { "description": "Enum name.", "type": "string" }, "note": { "description": "Enum note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "enum data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "enum", "description": "Must be 'enum' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "enum operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='enum_value'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "enum_uuid": { "description": "Parent enum UUID. Required for create; may be a data.uuid from an earlier enum operation.", "type": "string" }, "note": { "description": "Enum value note.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" }, "value": { "description": "Enum value. Inline enum values on enum are not persisted; create enum_value operations.", "type": "string" } }, "required": ["enum_uuid"], "title": "enum_value data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='enum_value'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "enum_uuid": { "description": "Parent enum UUID. Required for create; may be a data.uuid from an earlier enum operation.", "type": "string" }, "note": { "description": "Enum value note.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" }, "value": { "description": "Enum value. Inline enum values on enum are not persisted; create enum_value operations.", "type": "string" } }, "title": "enum_value data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "enum_value", "description": "Must be 'enum_value' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "enum_value operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='table_group'.", "properties": { "color": { "description": "Group color.", "type": "string" }, "name": { "description": "Table group name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table_group data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='table_group'.", "properties": { "color": { "description": "Group color.", "type": "string" }, "name": { "description": "Table group name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table_group data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "table_group", "description": "Must be 'table_group' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "table_group operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='table_group_table'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "schema_name": { "description": "Table schema name.", "type": "string" }, "table_name": { "description": "Table name. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "required": ["group_uuid", "table_name"], "title": "table_group_table data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='table_group_table'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "schema_name": { "description": "Table schema name.", "type": "string" }, "table_name": { "description": "Table name. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table_group_table data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "table_group_table", "description": "Must be 'table_group_table' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "table_group_table operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='table_group_note'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "note_uuid": { "description": "Note UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "required": ["group_uuid", "note_uuid"], "title": "table_group_note data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='table_group_note'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "note_uuid": { "description": "Note UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table_group_note data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "table_group_note", "description": "Must be 'table_group_note' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "table_group_note operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='filter'.", "properties": { "included_tables": { "description": "JSON string/list of included tables.", "type": "string" }, "is_default": { "description": "Default filter flag.", "type": "boolean" }, "name": { "description": "Filter name.", "type": "string" }, "table_groups": { "description": "JSON string/object of table groups.", "type": "string" }, "table_positions": { "description": "JSON string/object of table positions.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "filter data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='filter'.", "properties": { "included_tables": { "description": "JSON string/list of included tables.", "type": "string" }, "is_default": { "description": "Default filter flag.", "type": "boolean" }, "name": { "description": "Filter name.", "type": "string" }, "table_groups": { "description": "JSON string/object of table groups.", "type": "string" }, "table_positions": { "description": "JSON string/object of table positions.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "filter data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "filter", "description": "Must be 'filter' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "filter operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='note'.", "properties": { "color": { "description": "Note color.", "type": "string" }, "content": { "description": "Note content.", "type": "string" }, "height": { "description": "Height.", "type": "integer" }, "icon_name": { "description": "Icon name.", "type": "string" }, "position_x": { "description": "X position.", "type": "integer" }, "position_y": { "description": "Y position.", "type": "integer" }, "title": { "description": "Note title.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" }, "width": { "description": "Width.", "type": "integer" } }, "title": "note data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='note'.", "properties": { "color": { "description": "Note color.", "type": "string" }, "content": { "description": "Note content.", "type": "string" }, "height": { "description": "Height.", "type": "integer" }, "icon_name": { "description": "Icon name.", "type": "string" }, "position_x": { "description": "X position.", "type": "integer" }, "position_y": { "description": "Y position.", "type": "integer" }, "title": { "description": "Note title.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" }, "width": { "description": "Width.", "type": "integer" } }, "title": "note data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "note", "description": "Must be 'note' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "note operation", "type": "object" }], "properties": { "data": { "description": "Type-specific payload. All field names are snake_case. For create, data.uuid may be client-supplied and referenced by later operations in the same batch.", "oneOf": [{ "description": "Payload for operation.type='table'.", "properties": { "alias": { "description": "Display alias.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "header_color": { "description": "Header color.", "type": "string" }, "name": { "description": "Table name. Required for create.", "type": "string" }, "note": { "description": "Table note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table data", "type": "object" }, { "description": "Payload for operation.type='column'.", "properties": { "default_value": { "description": "Default value.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "is_increment": { "description": "Auto-increment flag.", "type": "boolean" }, "is_not_null": { "description": "Not-null flag.", "type": "boolean" }, "is_pk": { "description": "Primary key flag.", "type": "boolean" }, "is_unique": { "description": "Unique flag.", "type": "boolean" }, "name": { "description": "Column name.", "type": "string" }, "note": { "description": "Column note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create; may be a data.uuid from an earlier table operation in this batch.", "type": "string" }, "type": { "description": "SQL data type. Use this exact field name; do not send data_type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "column data", "type": "object" }, { "description": "Payload for operation.type='index'.", "properties": { "is_pk": { "description": "Primary key index flag.", "type": "boolean" }, "is_unique": { "description": "Unique index flag.", "type": "boolean" }, "name": { "description": "Index name.", "type": "string" }, "note": { "description": "Index note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create.", "type": "string" }, "type": { "description": "Index type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "index data", "type": "object" }, { "description": "Payload for operation.type='index_column'.", "properties": { "column_uuid": { "description": "Column UUID. Required for create.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "index_uuid": { "description": "Index UUID. Required for create.", "type": "string" }, "sort_order": { "description": "Sort order, for example ASC or DESC.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "index_column data", "type": "object" }, { "description": "Payload for operation.type='ref'.", "properties": { "from_table_uuid": { "description": "Source table UUID. Required for create.", "type": "string" }, "name": { "description": "Reference name.", "type": "string" }, "on_delete": { "description": "ON DELETE action.", "type": "string" }, "on_update": { "description": "ON UPDATE action.", "type": "string" }, "relationship": { "description": "Required for create. Use short dbdiagram-style relationship symbols.", "enum": [">", "<", "-"], "type": "string" }, "to_table_uuid": { "description": "Target table UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "ref data", "type": "object" }, { "description": "Payload for operation.type='ref_column'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "from_column_uuid": { "description": "Source column UUID. Required for create.", "type": "string" }, "ref_uuid": { "description": "Reference UUID. Required for create; may be a data.uuid from an earlier ref operation.", "type": "string" }, "to_column_uuid": { "description": "Target column UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "ref_column data", "type": "object" }, { "description": "Payload for operation.type='enum'.", "properties": { "name": { "description": "Enum name.", "type": "string" }, "note": { "description": "Enum note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "enum data", "type": "object" }, { "description": "Payload for operation.type='enum_value'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "enum_uuid": { "description": "Parent enum UUID. Required for create; may be a data.uuid from an earlier enum operation.", "type": "string" }, "note": { "description": "Enum value note.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" }, "value": { "description": "Enum value. Inline enum values on enum are not persisted; create enum_value operations.", "type": "string" } }, "title": "enum_value data", "type": "object" }, { "description": "Payload for operation.type='table_group'.", "properties": { "color": { "description": "Group color.", "type": "string" }, "name": { "description": "Table group name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table_group data", "type": "object" }, { "description": "Payload for operation.type='table_group_table'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "schema_name": { "description": "Table schema name.", "type": "string" }, "table_name": { "description": "Table name. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table_group_table data", "type": "object" }, { "description": "Payload for operation.type='table_group_note'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "note_uuid": { "description": "Note UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table_group_note data", "type": "object" }, { "description": "Payload for operation.type='filter'.", "properties": { "included_tables": { "description": "JSON string/list of included tables.", "type": "string" }, "is_default": { "description": "Default filter flag.", "type": "boolean" }, "name": { "description": "Filter name.", "type": "string" }, "table_groups": { "description": "JSON string/object of table groups.", "type": "string" }, "table_positions": { "description": "JSON string/object of table positions.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "filter data", "type": "object" }, { "description": "Payload for operation.type='note'.", "properties": { "color": { "description": "Note color.", "type": "string" }, "content": { "description": "Note content.", "type": "string" }, "height": { "description": "Height.", "type": "integer" }, "icon_name": { "description": "Icon name.", "type": "string" }, "position_x": { "description": "X position.", "type": "integer" }, "position_y": { "description": "Y position.", "type": "integer" }, "title": { "description": "Note title.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" }, "width": { "description": "Width.", "type": "integer" } }, "title": "note data", "type": "object" }], "type": "object" }, "op": { "description": "Operation. For create, put any new UUID in data.uuid; for update/delete, put target UUID in operation.uuid.", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "description": "ERD entity type. This selects the operation.data shape.", "enum": ["table", "column", "index", "index_column", "ref", "ref_column", "enum", "enum_value", "table_group", "table_group_table", "table_group_note", "filter", "note"], "type": "string" }, "uuid": { "description": "Target UUID for update/delete. Do not use this for create; use data.uuid instead.", "type": "string" } }, "required": ["op", "type"], "type": "object" }, "type": "array" } }, "required": ["documentUuid", "description", "operations"], "type": "object" }, "required": ["description", "documentUuid", "operations"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "87f5bcf5a253815a" },
+  { "mcpName": "erd_arrange_tables", "commandPath": ["erd", "arrange-tables"], "group": "erd", "description": "Arrange ERD tables after edits. Default incremental mode places newly-created tables while preserving existing positions; full=true re-layouts the entire diagram. Use after several separate table edits to tidy the canvas.", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "full": { "description": "Re-layout the ENTIRE diagram (overwrites existing positions). Default false = arrange only newly-added (uncoordinated) tables to the top-right while preserving existing table positions. Call this after creating several tables to tidy them up.", "type": "boolean" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "651fd0d54e3635ff" },
+  { "mcpName": "erd_get_enum", "commandPath": ["erd", "get-enum"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "enumUuid": { "description": "Enum UUID", "type": "string" } }, "required": ["documentUuid", "enumUuid"], "type": "object" }, "required": ["documentUuid", "enumUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "f0d79d7a1996939c" },
+  { "mcpName": "erd_get_ref", "commandPath": ["erd", "get-ref"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "refUuid": { "description": "Relationship UUID", "type": "string" } }, "required": ["documentUuid", "refUuid"], "type": "object" }, "required": ["documentUuid", "refUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "5b47fe7d99e60d4d" },
+  { "mcpName": "erd_get_table", "commandPath": ["erd", "get-table"], "group": "erd", "description": "Get one ERD table with nested columns and indexes. Returns persistent table/column/index UUIDs usable directly as erd_apply_changes update/delete targets and ref_column column references. Column fields use apply_changes snake_case names: uuid, table_uuid, name, type, is_pk, is_unique, is_not_null, is_increment, default_value, note, display_order. Index fields include uuid, name, columns (column UUIDs), is_unique, is_pk, type.", "inputSchema": { "description": "Get one ERD table with nested columns and indexes. Returns persistent table/column/index UUIDs usable directly as mcp__ainecto__erd_apply_changes update/delete targets and ref_column column references. Column fields use apply_changes snake_case names: uuid, table_uuid, name, type, is_pk, is_unique, is_not_null, is_increment, default_value, note, display_order. Index fields include uuid, name, columns (column UUIDs), is_unique, is_pk, type.", "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "tableUuid": { "description": "Table UUID. Response includes columns[] and indexes[] with persistent UUIDs for apply_changes.", "type": "string" } }, "required": ["documentUuid", "tableUuid"], "type": "object" }, "required": ["documentUuid", "tableUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "0dc13648bf3fbf8f" },
+  { "mcpName": "erd_get_table_group", "commandPath": ["erd", "get-table-group"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "tableGroupUuid": { "description": "Table group UUID", "type": "string" } }, "required": ["documentUuid", "tableGroupUuid"], "type": "object" }, "required": ["documentUuid", "tableGroupUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "3db246dfe8663370" },
+  { "mcpName": "erd_list_enums", "commandPath": ["erd", "list-enums"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4d1f602fa487a0e4" },
+  { "mcpName": "erd_list_refs", "commandPath": ["erd", "list-refs"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "307d766c777bbe8c" },
+  { "mcpName": "erd_list_table_groups", "commandPath": ["erd", "list-table-groups"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "775bff53bbc21c9e" },
+  { "mcpName": "erd_list_tables", "commandPath": ["erd", "list-tables"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "34324dfc7ef461c8" },
+  { "mcpName": "get_attachment", "commandPath": ["attachment", "get"], "group": "attachment", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Attachment UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "1e0e7f1bf33b669c" },
+  { "mcpName": "get_document", "commandPath": ["document", "get"], "group": "document", "description": "Read a document. The body comes back for the types whose create/update take one: markdown \u2192 content; openapi \u2192 content (the spec text) + format/specVersion/pathCount/operationCount; html \u2192 content (the HTML text); diagram \u2192 diagramSource/sourceLanguage/edgeStyle/isModule/metadata; erd \u2192 metadata only (read tables/refs via erd_list_*).", "inputSchema": { "properties": { "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "5de278aad6b11bc5" },
+  { "mcpName": "get_project", "commandPath": ["project", "get"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Project UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "192403c3484ac774" },
+  { "mcpName": "get_version", "commandPath": ["version", "get"], "group": "generic", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "Document UUID", "type": "string" }, "versionNumber": { "description": "Version number", "type": "integer" } }, "required": ["documentUuid", "versionNumber"], "type": "object" }, "required": ["documentUuid", "versionNumber"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4e308c1a8c7203d1" },
+  { "mcpName": "get_workspace", "commandPath": ["workspace", "get"], "group": "workspace", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Workspace UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "db6d1b4879d57c56" },
+  { "mcpName": "identity_get_self", "commandPath": ["tools", "run", "identity-get-self"], "group": "generic", "description": "Return the authenticated MCP caller identity summary; never returns email or token claims.", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "f29c86804eb91700" },
+  { "mcpName": "list_attachments", "commandPath": ["attachments", "list"], "group": "attachment", "description": "", "inputSchema": { "properties": { "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid"], "type": "object" }, "required": ["projectUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "fae7152d1e4a930b" },
+  { "mcpName": "list_documents", "commandPath": ["documents", "list"], "group": "document", "description": "", "inputSchema": { "properties": { "folderUuid": { "description": "Optional folder UUID", "type": "string" }, "limit": { "description": "Result cap when q is set (default 50)", "type": "integer" }, "projectUuid": { "description": "Project UUID", "type": "string" }, "q": { "description": "Optional full-text query. When provided, results come from the search index instead of folder listing.", "type": "string" }, "type": { "description": "Optional document type filter. Readable values: erd, markdown, diagram, openapi, html.", "enum": ["erd", "markdown", "diagram", "openapi", "html"], "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4086c52be4dd0c15" },
+  { "mcpName": "list_folders", "commandPath": ["folders", "list"], "group": "generic", "description": "", "inputSchema": { "properties": { "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid"], "type": "object" }, "required": ["projectUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "461dc6735ac92c3b" },
+  { "mcpName": "list_projects", "commandPath": ["projects", "list"], "group": "generic", "description": "", "inputSchema": { "properties": { "limit": { "description": "Result cap when q is set (default 50)", "type": "integer" }, "q": { "description": "Optional full-text query", "type": "string" }, "workspaceUuid": { "description": "Optional Workspace UUID", "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "939bfcc088425771" },
+  { "mcpName": "list_trash", "commandPath": ["trash", "list"], "group": "generic", "description": "", "inputSchema": { "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "329250aecc06a298" },
+  { "mcpName": "list_versions", "commandPath": ["versions", "list"], "group": "generic", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "Document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "f08f9faee3ba9107" },
+  { "mcpName": "list_workspaces", "commandPath": ["workspaces", "list"], "group": "workspace", "description": "", "inputSchema": { "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "39dba0089fdbdf6a" },
+  { "mcpName": "markdown_append_document", "commandPath": ["markdown", "append-document"], "group": "markdown", "description": "Append to Markdown documents. If the appended body is tens of KB or more, prefer request_upload_token (purpose=document.append) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Appends", "items": { "properties": { "addition": { "description": "Body addition. \uCD94\uAC00\uD560 \uB0B4\uC6A9\uC774 \uD06C\uBA74 (\uC218\uC2ED KB \uC774\uC0C1) LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.append, scopeJson={documentUuid, separator})` \uB85C uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "separator": { "description": "Separator between existing body and addition", "type": "string" }, "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid", "addition"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "bf82401f055f29b0" },
+  { "mcpName": "markdown_generate_document", "commandPath": ["markdown", "generate-document"], "group": "markdown", "description": "", "inputSchema": { "properties": { "items": { "description": "Generation requests", "items": { "properties": { "context": { "description": "Optional JSON context", "type": "string" }, "documentUuid": { "description": "Target document UUID", "type": "string" }, "prompt": { "description": "Generation prompt", "type": "string" } }, "required": ["documentUuid", "prompt"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "1e4724ea42f25743" },
+  { "mcpName": "move_documents", "commandPath": ["documents", "move"], "group": "document", "description": "", "inputSchema": { "properties": { "clientMutationId": { "description": "Optional mutation identifier for client retry tracing", "maxLength": 128, "minLength": 1, "pattern": "^[\\x21-\\x7E]{1,128}$", "type": "string" }, "items": { "description": "Moves", "items": { "properties": { "newFolderUuid": { "description": "New folder UUID \u2014 null/empty for root", "type": "string" }, "targetProjectUuid": { "description": "Target project UUID \u2014 omit to stay in current project", "type": "string" }, "targetWorkspaceUuid": { "description": "Guard only: must match targetProjectUuid workspace", "type": "string" }, "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "45899053743a0c1e" },
+  { "mcpName": "move_folders", "commandPath": ["folders", "move"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Moves", "items": { "properties": { "newParentFolderUuid": { "description": "New parent UUID \u2014 null/empty for root", "type": "string" }, "uuid": { "description": "Folder UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "eff4458d2f35587a" },
+  { "mcpName": "move_projects", "commandPath": ["projects", "move"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Moves", "items": { "properties": { "targetWorkspaceUuid": { "description": "Destination workspace UUID (you need write access there)", "type": "string" }, "uuid": { "description": "Project UUID", "type": "string" } }, "required": ["uuid", "targetWorkspaceUuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "abe0196da3c48ad5" },
+  { "mcpName": "request_upload_token", "commandPath": ["tools", "run", "request-upload-token"], "group": "attachment", "description": "Use this for large payloads of tens of KB or more to save LLM tokens. purpose=mcp.call returns a short-lived bearer token that can call any MCP tool, including erd_apply_changes, via curl. purpose=document.create/update/append uploads document bodies directly to the upload endpoint with PUT/curl. Tokens are reusable for 5 minutes by default.", "inputSchema": { "properties": { "maxBytes": { "description": "\uCD5C\uB300 \uC5C5\uB85C\uB4DC byte (\uC11C\uBC84 \uCE21 \uD55C\uB3C4)", "type": "integer" }, "purpose": { "description": "Token \uC6A9\uB3C4. `mcp.call` \uC740 curl \uB85C /mcp \uD638\uCD9C, `document.create/update/append` \uB294 PUT body \uB85C \uBCF8\uBB38 \uC5C5\uB85C\uB4DC, `attachment.upload` \uB294 \uD30C\uC77C bytes \uC5C5\uB85C\uB4DC. \uCF58\uD150\uCE20\uAC00 \uD06C\uBA74 (\uC218\uC2ED KB \uC774\uC0C1) LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 \uC774 \uB3C4\uAD6C\uB85C 5\uBD84 \uC7AC\uC0AC\uC6A9 \uD1A0\uD070\uC744 \uBC1B\uACE0 curl \uB85C \uBCF4\uB0B4\uB294 \uAC83\uC744 \uAC15\uB825 \uAD8C\uC7A5.", "enum": ["mcp.call", "document.create", "document.update", "document.append", "attachment.upload"], "type": "string" }, "scopeJson": { "description": "\uC120\uD0DD \u2014 JSON scope. document.create \uB294 projectUuid, type, title \uC744 \uD3EC\uD568\uD558\uACE0 creatable type values \uB294 erd, markdown, diagram, openapi, html. document.update/document.append \uB294 documentUuid \uB97C \uD3EC\uD568. attachment.upload typed: {parentType:TEST_CASE|TEST_EXECUTION,parentUuid,filename,contentType,sizeBytes}.", "type": "string" }, "ttlSeconds": { "description": "TTL (\uCD08). \uAE30\uBCF8 300 (5\uBD84)", "type": "integer" } }, "required": ["purpose"], "type": "object" }, "required": ["purpose"], "payloadMode": "binary-upload", "destructive": false, "sourceCatalog": "prod", "schemaHash": "85867a646f6c652f" },
+  { "mcpName": "restore_versions", "commandPath": ["versions", "restore"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Restores", "items": { "properties": { "documentUuid": { "description": "Document UUID", "type": "string" }, "versionNumber": { "description": "Version number to restore", "type": "integer" } }, "required": ["documentUuid", "versionNumber"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "005b5b08a19fc605" },
+  { "mcpName": "search_documents", "commandPath": ["documents", "search"], "group": "document", "description": "", "inputSchema": { "properties": { "limit": { "description": "\uACB0\uACFC \uAC1C\uC218 (\uAE30\uBCF8 20, \uCD5C\uB300 50)", "type": "integer" }, "offset": { "description": "\uD398\uC774\uC9C0\uB124\uC774\uC158 offset (\uAE30\uBCF8 0)", "type": "integer" }, "projectUuid": { "description": "\uD2B9\uC815 \uD504\uB85C\uC81D\uD2B8\uB85C \uD55C\uC815 (\uC120\uD0DD)", "type": "string" }, "q": { "description": "\uAC80\uC0C9 \uD0A4\uC6CC\uB4DC", "type": "string" }, "type": { "description": "Optional document type filter. Readable values: erd, markdown, diagram, openapi, html.", "enum": ["erd", "markdown", "diagram", "openapi", "html"], "type": "string" } }, "required": ["q"], "type": "object" }, "required": ["q"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "d24e109383700433" },
+  { "mcpName": "unarchive_documents", "commandPath": ["documents", "unarchive"], "group": "document", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Document UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "f2810e71583a320f" },
+  { "mcpName": "unarchive_folders", "commandPath": ["folders", "unarchive"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Folder UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "2a24cc44696b7906" },
+  { "mcpName": "unarchive_projects", "commandPath": ["projects", "unarchive"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Project UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "6925e444671afe19" },
+  { "mcpName": "unarchive_workspaces", "commandPath": ["workspaces", "unarchive"], "group": "workspace", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Workspace UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "8dafe9bc6378c3f2" },
+  { "mcpName": "update_documents", "commandPath": ["documents", "update"], "group": "document", "description": "Update documents. If a replacement body is tens of KB or more, prefer request_upload_token (purpose=document.update) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "body": { "description": "Deprecated compatibility alias for typePayload.body when document type is markdown. \uBCF8\uBB38\uC774 \uC218\uC2ED KB \uC774\uC0C1\uC73C\uB85C \uD06C\uBA74 LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.update)` \uB97C \uD638\uCD9C\uD574 uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C \uC9C1\uC811 PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "title": { "description": "New title", "type": "string" }, "typePayload": { "description": "Type-specific payload for enabled document types. markdown: {body}; diagram: {diagramSource,sourceLanguage,edgeStyle,isModule,metadata}; openapi: {content}; html: {content} (a full HTML page).", "type": "object" }, "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4c3cfe4d25def672" },
+  { "mcpName": "update_folders", "commandPath": ["folders", "update"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "name": { "description": "New name", "type": "string" }, "uuid": { "description": "Folder UUID", "type": "string" } }, "required": ["uuid", "name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "43c58a96ee632b5f" },
+  { "mcpName": "update_projects", "commandPath": ["projects", "update"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "description": { "description": "New description", "type": "string" }, "name": { "description": "New name", "type": "string" }, "uuid": { "description": "Project UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "7d849ef0a830aa8c" },
+  { "mcpName": "update_workspaces", "commandPath": ["workspaces", "update"], "group": "workspace", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "description": { "description": "New description", "type": "string" }, "name": { "description": "New name", "type": "string" }, "uuid": { "description": "Workspace UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "553275e6da799c5a" },
+  { "mcpName": "upload_attachments", "commandPath": ["tools", "run", "upload-attachments"], "group": "attachment", "description": "", "inputSchema": { "properties": { "items": { "description": "Attachments to register", "items": { "properties": { "contentType": { "description": "MIME type", "type": "string" }, "documentUuid": { "description": "Parent document UUID", "type": "string" }, "filename": { "description": "Original file name", "type": "string" }, "sizeBytes": { "description": "Size in bytes", "type": "integer" }, "storageKey": { "description": "Storage key returned by request_upload_token purpose=attachment.upload", "type": "string" } }, "required": ["documentUuid", "filename", "storageKey"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "binary-upload", "destructive": false, "sourceCatalog": "prod", "schemaHash": "deda4a56fbbe064f" }
 ];
 
 // src/core/catalog/generated.dev.ts
@@ -872,10 +1005,147 @@ var generatedTools2 = [
   { "mcpName": "mcp__ainecto__upload_attachments", "commandPath": ["tools", "run", "upload-attachments"], "group": "attachment", "description": "", "inputSchema": { "properties": { "items": { "description": "Attachments to register", "items": { "properties": { "contentType": { "description": "MIME type", "type": "string" }, "documentUuid": { "description": "Parent document UUID", "type": "string" }, "filename": { "description": "Original file name", "type": "string" }, "sizeBytes": { "description": "Size in bytes", "type": "integer" }, "storageKey": { "description": "Storage key returned by request_upload_token purpose=attachment.upload", "type": "string" } }, "required": ["documentUuid", "filename", "storageKey"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "binary-upload", "destructive": false, "sourceCatalog": "dev", "schemaHash": "0622e590de3404dd" }
 ];
 
+// src/core/catalog/generator.ts
+import { createHash as createHash3 } from "crypto";
+var LEGACY_PREFIX = "mcp__ainecto__";
+function bareToolName(name) {
+  return name.startsWith(LEGACY_PREFIX) ? name.slice(LEGACY_PREFIX.length) : name;
+}
+var DESTRUCTIVE_PREFIXES = [
+  "delete_",
+  "remove_",
+  "archive_",
+  "unarchive_",
+  "restore_",
+  "move_",
+  "erd_delete_",
+  "erd_remove_",
+  "task_delete_",
+  "testcase_delete_"
+];
+function generateCatalog(tools, sourceCatalog) {
+  return tools.map((tool) => normalizeTool(tool, sourceCatalog)).sort((a, b) => a.mcpName.localeCompare(b.mcpName));
+}
+function normalizeTool(tool, sourceCatalog) {
+  if (!tool.name) {
+    throw new Error("Unsupported tool name: empty.");
+  }
+  const stripped = bareToolName(tool.name);
+  const group = inferGroup(stripped);
+  const inputSchema = normalizeSchema(tool.inputSchema ?? { type: "object", properties: {} });
+  const required = Array.isArray(inputSchema.required) ? inputSchema.required.filter((value) => typeof value === "string").sort() : [];
+  const definition = {
+    mcpName: tool.name,
+    commandPath: generateCommandPath(stripped, group),
+    group,
+    description: tool.description ?? "",
+    inputSchema,
+    required,
+    payloadMode: inferPayloadMode(stripped, inputSchema),
+    destructive: inferDestructive(stripped, tool),
+    sourceCatalog,
+    schemaHash: ""
+  };
+  return { ...definition, schemaHash: computeSchemaHash(definition) };
+}
+function inferGroup(strippedName) {
+  if (strippedName.startsWith("erd_")) return "erd";
+  if (strippedName.startsWith("flow_")) return "flow";
+  if (strippedName.startsWith("testcase_")) return "testcase";
+  if (strippedName.startsWith("markdown_")) return "markdown";
+  if (strippedName.includes("attachment") || strippedName.includes("upload")) return "attachment";
+  if (strippedName.startsWith("task_")) return "task";
+  if (strippedName.includes("workspace")) return "workspace";
+  if (strippedName.includes("document")) return "document";
+  return "generic";
+}
+function generateCommandPath(strippedName, group) {
+  if (group !== "generic" && strippedName.startsWith(`${group}_`)) {
+    return [group, snakeToKebab(strippedName.slice(group.length + 1))];
+  }
+  const [verb, ...rest] = strippedName.split("_");
+  if (verb && rest.length > 0 && isVerb(verb)) {
+    return [rest.join("-"), verb];
+  }
+  return ["tools", "run", snakeToKebab(strippedName)];
+}
+function inferPayloadMode(strippedName, inputSchema) {
+  if (strippedName.includes("upload") || strippedName.includes("attachment_upload")) {
+    return "binary-upload";
+  }
+  const properties = inputSchema.properties;
+  if (!isRecord3(properties)) {
+    return "flags";
+  }
+  const values = Object.values(properties);
+  if (values.length === 0) {
+    return "flags";
+  }
+  if (values.every(isScalarSchema)) {
+    return "flags";
+  }
+  return "file-json";
+}
+function inferDestructive(strippedName, tool) {
+  if (tool.annotations?.destructiveHint === true) {
+    return true;
+  }
+  return DESTRUCTIVE_PREFIXES.some((prefix) => strippedName.startsWith(prefix));
+}
+function computeSchemaHash(tool) {
+  return createHash3("sha256").update(stableStringify({
+    name: tool.mcpName,
+    description: tool.description,
+    inputSchema: tool.inputSchema
+  })).digest("hex").slice(0, 16);
+}
+function stableStringify(value) {
+  if (Array.isArray(value)) {
+    return `[${value.map(stableStringify).join(",")}]`;
+  }
+  if (isRecord3(value)) {
+    return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${stableStringify(value[key])}`).join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+function normalizeSchema(schema) {
+  return JSON.parse(stableStringify(schema));
+}
+function isScalarSchema(value) {
+  if (!isRecord3(value)) {
+    return false;
+  }
+  const type = value.type;
+  return type === "string" || type === "number" || type === "integer" || type === "boolean";
+}
+function isVerb(value) {
+  return [
+    "list",
+    "get",
+    "create",
+    "update",
+    "delete",
+    "move",
+    "restore",
+    "archive",
+    "unarchive",
+    "search"
+  ].includes(value);
+}
+function snakeToKebab(value) {
+  return value.replaceAll("_", "-");
+}
+function isRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 // src/core/catalog/index.ts
 function getGeneratedTools(env) {
   return env === "dev" ? generatedTools2 : generatedTools;
 }
+async function loadLiveTools(env, client) {
+  return generateCatalog(await client.toolsList(), env);
+}
 
 // src/core/mcp/stdioBridge.ts
 import { createInterface } from "readline";
@@ -905,7 +1175,7 @@ async function runStdioBridge(options) {
 }
 function parseJsonRpcRequest(line) {
   const parsed = JSON.parse(line);
-  if (!isRecord3(parsed) || parsed.jsonrpc !== "2.0" || typeof parsed.method !== "string") {
+  if (!isRecord4(parsed) || parsed.jsonrpc !== "2.0" || typeof parsed.method !== "string") {
     throw new Error("Invalid JSON-RPC request.");
   }
   return {
@@ -915,14 +1185,13 @@ function parseJsonRpcRequest(line) {
     params: parsed.params
   };
 }
-function isRecord3(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
 // src/adapters/mcp/connector.ts
 async function runConnector(options) {
-  const tokenStore = new FileTokenStore();
-  const auth = new OAuthClient({ endpoint: options.endpoint, tokenStore, role: options.role });
+  const auth = new OAuthClient({ endpoint: options.endpoint, tokenStore: new FileTokenStore() });
   const client = new McpRpcClient({
     endpoint: options.endpoint,
     tokenProvider: auth,
@@ -939,85 +1208,85 @@ async function runConnector(options) {
 // src/core/catalog/enrichments.ts
 var enrichments = [
   {
-    mcpName: "mcp__ainecto__list_projects",
+    mcpName: "list_projects",
     outputHint: "table",
     tableColumns: ["uuid", "name", "projectKey", "workspaceUuid", "updatedAt"],
     displayName: "List projects",
     examples: ["ainecto projects list --env dev"]
   },
   {
-    mcpName: "mcp__ainecto__list_workspaces",
+    mcpName: "list_workspaces",
     outputHint: "table",
     tableColumns: ["uuid", "name", "updatedAt"],
     displayName: "List workspaces"
   },
   {
-    mcpName: "mcp__ainecto__list_folders",
+    mcpName: "list_folders",
     outputHint: "table",
     tableColumns: ["uuid", "name", "projectUuid", "parentFolderUuid", "updatedAt"],
     displayName: "List folders"
   },
   {
-    mcpName: "mcp__ainecto__list_documents",
+    mcpName: "list_documents",
     outputHint: "table",
     tableColumns: ["uuid", "title", "type", "projectUuid", "folderUuid", "updatedAt"],
     displayName: "List documents"
   },
   {
-    mcpName: "mcp__ainecto__search_documents",
+    mcpName: "search_documents",
     outputHint: "table",
     tableColumns: ["uuid", "title", "type", "projectUuid", "updatedAt"],
     displayName: "Search documents"
   },
   {
-    mcpName: "mcp__ainecto__list_attachments",
+    mcpName: "list_attachments",
     outputHint: "table",
     tableColumns: ["uuid", "filename", "contentType", "sizeBytes", "documentUuid"],
     displayName: "List attachments"
   },
   {
-    mcpName: "mcp__ainecto__erd_list_tables",
+    mcpName: "erd_list_tables",
     outputHint: "table",
     tableColumns: ["uuid", "name", "schema_name", "display_order"],
     displayName: "List ERD tables"
   },
   {
-    mcpName: "mcp__ainecto__erd_list_refs",
+    mcpName: "erd_list_refs",
     outputHint: "table",
     tableColumns: ["uuid", "name", "from_table_uuid", "to_table_uuid", "relationship"],
     displayName: "List ERD refs"
   },
   {
-    mcpName: "mcp__ainecto__erd_list_enums",
+    mcpName: "erd_list_enums",
     outputHint: "table",
     tableColumns: ["uuid", "name", "display_order"],
     displayName: "List ERD enums"
   },
   {
-    mcpName: "mcp__ainecto__erd_list_table_groups",
+    mcpName: "erd_list_table_groups",
     outputHint: "table",
     tableColumns: ["uuid", "name", "display_order"],
     displayName: "List ERD table groups"
   },
   {
-    mcpName: "mcp__ainecto__task_list_tasks",
+    mcpName: "task_list_tasks",
     outputHint: "table",
     tableColumns: ["uuid", "title", "statusUuid", "assigneeId", "updatedAt"],
     displayName: "List tasks"
   },
   {
-    mcpName: "mcp__ainecto__task_list_statuses",
+    mcpName: "task_list_statuses",
     outputHint: "table",
     tableColumns: ["uuid", "name", "displayOrder"],
     displayName: "List task statuses"
   },
   {
-    mcpName: "mcp__ainecto__enable_shares",
+    mcpName: "enable_shares",
     aliases: ["shares enable"],
     displayName: "Enable shares"
   },
   {
-    mcpName: "mcp__ainecto__disable_shares",
+    mcpName: "disable_shares",
     aliases: ["shares disable"],
     displayName: "Disable shares"
   }
@@ -1026,7 +1295,7 @@ var enrichments = [
 // src/core/output/table.ts
 function renderTable(data, options = {}) {
   const rows = extractRows(data);
-  if (!rows.length || !rows.every(isRecord4)) {
+  if (!rows.length || !rows.every(isRecord5)) {
     return void 0;
   }
   const columns = options.columns?.length ? options.columns : inferColumns(rows);
@@ -1043,7 +1312,7 @@ function extractRows(data) {
   if (Array.isArray(data)) {
     return data;
   }
-  if (isRecord4(data)) {
+  if (isRecord5(data)) {
     for (const key of ["items", "projects", "workspaces", "folders", "documents", "tasks", "attachments", "results", "data"]) {
       const value = data[key];
       if (Array.isArray(value)) {
@@ -1071,7 +1340,7 @@ function formatCell(value) {
   }
   return String(value);
 }
-function isRecord4(value) {
+function isRecord5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -1124,7 +1393,7 @@ function payloadToArgs(value) {
   if (value === void 0 || value === null) {
     return {};
   }
-  if (!isRecord5(value)) {
+  if (!isRecord6(value)) {
     throw new CliCommandError("INVALID_PAYLOAD", "Generated command payload must be a JSON object.", { value });
   }
   return { ...value };
@@ -1228,12 +1497,12 @@ function coerceFlagValue(value, schema, key) {
 }
 function getSchemaProperties(schema) {
   const properties = schema.properties;
-  if (!isRecord5(properties)) {
+  if (!isRecord6(properties)) {
     return {};
   }
   const result = {};
   for (const [key, value] of Object.entries(properties)) {
-    if (isRecord5(value)) {
+    if (isRecord6(value)) {
       result[key] = value;
     }
   }
@@ -1248,7 +1517,7 @@ function requireValue(flag, value) {
   }
   return value;
 }
-function isRecord5(value) {
+function isRecord6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -1290,9 +1559,8 @@ async function promptConfirmation(io, message) {
 var ATTACHMENTS_UPLOAD_COMMAND_PATH = ["attachments", "upload"];
 
 // src/adapters/cli/generatedCommandRouter.ts
-function matchGeneratedCommand(env, argv) {
+function matchGeneratedCommand(tools, argv) {
   const commandTokens = argv.filter((arg) => !arg.startsWith("-"));
-  const tools = getGeneratedTools(env);
   const entries = buildRouteEntries(tools, enrichments);
   const match = entries.filter((entry) => isPrefix(entry.path, commandTokens)).sort((a, b) => b.path.length - a.path.length)[0];
   if (!match) {
@@ -1308,7 +1576,7 @@ function matchGeneratedCommand(env, argv) {
   };
 }
 async function executeGeneratedCommand(options) {
-  const route = matchGeneratedCommand(options.env, options.argv);
+  const route = matchGeneratedCommand(options.tools, options.argv);
   if (!route) {
     return 2;
   }
@@ -1471,7 +1739,7 @@ async function requestUploadToken(client, metadata, context) {
     requestArgs.ttlSeconds = context.ttlSeconds;
   }
   const response = unwrapMcpToolPayload(await client.toolsCall(context.requestToolName, requestArgs));
-  if (!isRecord6(response)) {
+  if (!isRecord7(response)) {
     throw new AttachmentUploadError("UPLOAD_TOKEN_PROTOCOL_ERROR", "request_upload_token response was not an object.");
   }
   const token = response.token;
@@ -1541,7 +1809,7 @@ function parsePutResponse(text) {
   } catch {
     throw new AttachmentUploadError("ATTACHMENT_UPLOAD_PROTOCOL_ERROR", "Attachment PUT response was not valid JSON.");
   }
-  if (!isRecord6(parsed)) {
+  if (!isRecord7(parsed)) {
     throw new AttachmentUploadError("ATTACHMENT_UPLOAD_PROTOCOL_ERROR", "Attachment PUT response was not an object.");
   }
   if (typeof parsed.storageKey !== "string") {
@@ -1574,10 +1842,10 @@ function validatePutResult(token, metadata, putResult) {
   }
 }
 function unwrapMcpToolPayload(value) {
-  if (!isRecord6(value) || !Array.isArray(value.content)) {
+  if (!isRecord7(value) || !Array.isArray(value.content)) {
     return value;
   }
-  const text = value.content.map((item) => isRecord6(item) && typeof item.text === "string" ? item.text : "").find((itemText) => itemText.trim().startsWith("{"));
+  const text = value.content.map((item) => isRecord7(item) && typeof item.text === "string" ? item.text : "").find((itemText) => itemText.trim().startsWith("{"));
   if (!text) {
     return value;
   }
@@ -1619,7 +1887,7 @@ var MIME_BY_EXTENSION = {
   ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
   ".zip": "application/zip"
 };
-function isRecord6(value) {
+function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -1744,12 +2012,13 @@ function renderAttachmentUploadResult(result, json) {
 }
 
 // src/adapters/cli/initCommand.ts
-import { chmod as chmod2, lstat, mkdir as mkdir2, readFile as readFile4, realpath, rename as rename2, rm as rm2, rmdir, stat as stat3, writeFile as writeFile2 } from "fs/promises";
-import { dirname as dirname2, join as join2, relative, resolve, sep } from "path";
+import { chmod as chmod2, mkdir as mkdir2, rename as rename2, rm as rm2, rmdir, stat as stat3, writeFile as writeFile2 } from "fs/promises";
+import { dirname as dirname3, join as join3, relative, resolve as resolve2, sep as sep2 } from "path";
 
 // src/core/harness/agentTargets.ts
-var SERVER_NAME = "ai-erd";
-var PACKAGE_NAME = "@ai-erd/mcp";
+import { basename as basename2 } from "path";
+var SERVER_NAME = "ainecto";
+var LEGACY_SERVER_NAME = "ai-erd";
 var AGENT_TARGETS = [
   { id: "claude-code", label: "Claude Code", path: ".mcp.json" },
   { id: "cursor", label: "Cursor", path: ".cursor/mcp.json" }
@@ -1765,7 +2034,7 @@ function buildServerEntry(input) {
   return { command: "npx", args };
 }
 function readRoleFromEntry(entry) {
-  if (!isRecord7(entry) || !Array.isArray(entry.args)) {
+  if (!isRecord8(entry) || !Array.isArray(entry.args)) {
     return void 0;
   }
   const index = entry.args.indexOf("--role");
@@ -1778,16 +2047,44 @@ function readServerEntry(existing) {
   }
   try {
     const parsed = JSON.parse(existing);
-    return parsed?.mcpServers?.[SERVER_NAME];
+    const servers = parsed?.mcpServers;
+    return isRecord8(servers) ? servers[ourKeyIn(servers) ?? SERVER_NAME] : void 0;
   } catch {
     return void 0;
   }
 }
+function ourKeyIn(servers) {
+  if (Object.prototype.hasOwnProperty.call(servers, SERVER_NAME)) {
+    return SERVER_NAME;
+  }
+  return isOurBridge(servers[LEGACY_SERVER_NAME]) ? LEGACY_SERVER_NAME : void 0;
+}
+function legacyBridgeIn(servers) {
+  return isOurBridge(servers[LEGACY_SERVER_NAME]);
+}
+function isOurBridge(entry) {
+  if (!isRecord8(entry)) {
+    return false;
+  }
+  const { command, args } = entry;
+  const argList = Array.isArray(args) ? args.filter((arg) => typeof arg === "string") : [];
+  const isOurPackage = (arg) => [PACKAGE_NAME, LEGACY_PACKAGE_NAME].some((name) => arg === name || arg.startsWith(`${name}@`));
+  if (argList.some((arg) => isOurPackage(arg) || arg === "--role")) {
+    return true;
+  }
+  const bin = typeof command === "string" ? basename2(command) : "";
+  return OUR_BINS.includes(bin);
+}
+var OUR_BINS = ["ainecto", "ai-erd", "ai-erd-mcp"];
 function mergeServerEntry(existing, entry) {
   const root = parseConfigObject(existing);
   const servers = readServers(root);
-  const replaced = Object.prototype.hasOwnProperty.call(servers, SERVER_NAME);
-  const replacedEntry = replaced ? servers[SERVER_NAME] : void 0;
+  const ourKey = ourKeyIn(servers);
+  const replaced = ourKey !== void 0;
+  const replacedEntry = ourKey === void 0 ? void 0 : servers[ourKey];
+  if (legacyBridgeIn(servers)) {
+    delete servers[LEGACY_SERVER_NAME];
+  }
   servers[SERVER_NAME] = entry;
   return { content: stringify({ ...root, mcpServers: servers }), replaced, replacedEntry };
 }
@@ -1797,12 +2094,15 @@ function removeServerEntry(existing, restore) {
   }
   const root = parseConfigObject(existing);
   const servers = readServers(root);
-  const removed = Object.prototype.hasOwnProperty.call(servers, SERVER_NAME);
+  const ourKey = ourKeyIn(servers);
+  const removed = ourKey !== void 0;
   if (restore !== void 0) {
-    servers[SERVER_NAME] = restore.value;
+    servers[ourKey ?? SERVER_NAME] = restore.value;
     return { content: stringify({ ...root, mcpServers: servers }), removed, emptied: false };
   }
-  delete servers[SERVER_NAME];
+  if (ourKey !== void 0) {
+    delete servers[ourKey];
+  }
   const otherKeys = Object.keys(root).filter((key) => key !== "mcpServers");
   const emptied = Object.keys(servers).length === 0 && otherKeys.length === 0;
   return { content: stringify({ ...root, mcpServers: servers }), removed, emptied };
@@ -1832,7 +2132,7 @@ function readServers(root) {
   if (servers === void 0) {
     return {};
   }
-  if (!isRecord7(servers)) {
+  if (!isRecord8(servers)) {
     throw new Error(
       'Existing MCP config has an "mcpServers" value that is not an object, so it was left untouched. Fix it by hand and run init again.'
     );
@@ -1851,7 +2151,7 @@ function parseConfigObject(existing) {
       `Existing MCP config is not valid JSON, so it was left untouched. Fix it by hand and run init again. (${error instanceof Error ? error.message : String(error)})`
     );
   }
-  if (!isRecord7(parsed)) {
+  if (!isRecord8(parsed)) {
     throw new Error("Existing MCP config must be a JSON object; it was left untouched.");
   }
   return parsed;
@@ -1860,16 +2160,24 @@ function stringify(value) {
   return `${JSON.stringify(value, null, 2)}
 `;
 }
-function isRecord7(value) {
+function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
 // src/core/harness/harnessDoc.ts
-var MARKER_BEGIN = "<!-- ai-erd:begin -->";
-var MARKER_END = "<!-- ai-erd:end -->";
-var HARNESS_DOC_PATH = ".ai-erd/HARNESS.md";
-var HARNESS_CONFIG_PATH = ".ai-erd/config.json";
-var HARNESS_RECORD_PATH = ".ai-erd/init-record.json";
+var MARKER_BEGIN = "<!-- ainecto:begin -->";
+var MARKER_END = "<!-- ainecto:end -->";
+var LEGACY_MARKER_BEGIN = "<!-- ai-erd:begin -->";
+var LEGACY_MARKER_END = "<!-- ai-erd:end -->";
+var MARKERS = {
+  begin: [MARKER_BEGIN, LEGACY_MARKER_BEGIN],
+  end: [MARKER_END, LEGACY_MARKER_END]
+};
+var HARNESS_DIR = ".ainecto";
+var LEGACY_HARNESS_DIR = ".ai-erd";
+var HARNESS_DOC_PATH = `${HARNESS_DIR}/HARNESS.md`;
+var HARNESS_CONFIG_PATH = `${HARNESS_DIR}/config.json`;
+var HARNESS_RECORD_PATH = `${HARNESS_DIR}/init-record.json`;
 function renderHarnessDoc(input, template) {
   return fillTemplate(template ?? DEFAULT_HARNESS_DOC, {
     projectName: input.projectName,
@@ -1893,13 +2201,13 @@ function documentContractProblem(key, body) {
     }
   }
   if (key === AGENT_NOTE_KEY) {
-    return managedBlockProblem(key, body);
+    return managedBlockProblem(key, withCurrentMarkers(body));
   }
   return void 0;
 }
-var DEFAULT_HARNESS_DOC = `# AI-ERD Harness
+var DEFAULT_HARNESS_DOC = `# AiNecto Harness
 
-This repository is wired to an AI-ERD project. The design source of truth lives in AI-ERD,
+This repository is wired to an AiNecto project. The design source of truth lives in AiNecto,
 not in this repository's files.
 
 - Project: **{{projectName}}** (\`{{projectUuid}}\`)
@@ -1908,9 +2216,11 @@ not in this repository's files.
 ## One session, one role
 
 A session picks exactly one role and keeps it for the whole session. The role comes from the
-MCP server configuration \u2014 not from this file, and not from anything an agent can change at
-runtime. The server exposes only the tools that role is allowed to use, so a tool that is out
-of role is not merely discouraged: it is absent.
+MCP server configuration \u2014 not from this file \u2014 and it does not change during a session. The
+user picks the role; an agent applies a new one only when the user asks, and it takes effect in
+the next session. This is a working guardrail, not a security boundary. The server exposes only
+the tools that role is allowed to use, so a tool that is out of role is not merely discouraged:
+it is absent.
 
 | Role | Owns | Must not |
 | --- | --- | --- |
@@ -1937,7 +2247,7 @@ and which session should pick it up next.
 
 ## Not every change needs four sessions
 
-A small change that fits the design already recorded in AI-ERD starts at Development. The rule
+A small change that fits the design already recorded in AiNecto starts at Development. The rule
 is not "always run four steps" \u2014 it is that when a step is needed, it does not happen inside
 another role's session.
 
@@ -1948,27 +2258,30 @@ Change the role in the MCP server configuration and start a new session:
 ${AGENT_TARGETS.map((target) => `    ${target.label.padEnd(12)} ${target.path}`).join("\n")}
     Codex        global config \u2014 use a profile: codex -p <role>, or set ${ROLE_ENV_VAR}
 
-Or run \`ai-erd init --role <design|development|test|validation>\` to rewrite them.
+Or run \`ainecto init --role <design|development|test|validation>\` to rewrite them.
 
 ---
-Generated by \`ai-erd init\`. Remove everything it wrote with \`ai-erd init --undo\`.
+Generated by \`ainecto init\`. Remove everything it wrote with \`ainecto init --undo\`.
 `;
 function renderAgentNote(template) {
-  return fillTemplate(template ?? DEFAULT_AGENT_NOTE, {
+  return fillTemplate(withCurrentMarkers(template ?? DEFAULT_AGENT_NOTE), {
     harnessDocPath: HARNESS_DOC_PATH,
     serverName: SERVER_NAME
   });
 }
+function withCurrentMarkers(template) {
+  return template.split(LEGACY_MARKER_BEGIN).join(MARKER_BEGIN).split(LEGACY_MARKER_END).join(MARKER_END);
+}
 var DEFAULT_AGENT_NOTE = `${MARKER_BEGIN}
-## AI-ERD Harness
+## AiNecto Harness
 
-This repository uses AI-ERD as its design source of truth, and each session has one role
+This repository uses AiNecto as its design source of truth, and each session has one role
 (Design / Development / Test / Validation). Read \`{{harnessDocPath}}\` before doing work that
 touches requirements, the ERD, or architecture.
 
-The role of this session comes from the \`{{serverName}}\` MCP server configuration, and from the
-access token when you signed in with a role; the server states it in its \`initialize\`
-instructions and exposes only that role's tools. If the work needs something outside the role,
+The role of this session comes from the \`{{serverName}}\` MCP server configuration that
+\`ainecto init\` wrote; the server states it in its \`initialize\` instructions and exposes only
+that role's tools. If the work needs something outside the role,
 stop and report which session is required.
 ${MARKER_END}`;
 function managedBlockProblem(key, body) {
@@ -2020,38 +2333,58 @@ function upsertMarkerBlock(existing, block) {
   return composed;
 }
 function assertComposedBlockIsOurs(composed, existing) {
-  if (ownedMarkerCount(composed, MARKER_BEGIN) === 1 && ownedMarkerCount(composed, MARKER_END) === 1) {
+  if (ownedMarkerCount(composed, "begin") === 1 && ownedMarkerCount(composed, "end") === 1) {
     return;
   }
   const reason = hasUnclosedFence(existing) ? "this file ends inside an unclosed code fence, so the block would sit inside it" : "the block could not be found again once merged into this file";
   throw new Error(
-    `ai-erd could not place its block where --undo would find it again \u2014 ${reason}. The file was left untouched; fix that and run again.`
+    `ainecto could not place its block where --undo would find it again \u2014 ${reason}. The file was left untouched; fix that and run again.`
   );
 }
 function assertNoDanglingMarker(content) {
-  const begins = ownedMarkerCount(content, MARKER_BEGIN);
-  const ends = ownedMarkerCount(content, MARKER_END);
+  const begins = ownedMarkerCount(content, "begin");
+  const ends = ownedMarkerCount(content, "end");
   if (begins !== ends || begins > 1) {
     throw new Error(
-      `ai-erd markers are unbalanced (${begins} begin, ${ends} end). The file was left untouched \u2014 remove the stray ${MARKER_BEGIN} / ${MARKER_END} by hand and run again.`
+      `AiNecto markers are unbalanced (${begins} begin, ${ends} end). The file was left untouched \u2014 remove the stray ${MARKER_BEGIN} / ${MARKER_END} by hand and run again.`
     );
   }
   if (begins === 0) {
     return;
   }
-  if (ownedMarkerIndex(content, MARKER_END, 0) < ownedMarkerIndex(content, MARKER_BEGIN, 0)) {
+  if (ownedMarker(content, "end", 0).at < ownedMarker(content, "begin", 0).at) {
     throw new Error(
-      `ai-erd markers are out of order (${MARKER_END} appears before ${MARKER_BEGIN}). The file was left untouched \u2014 fix the markers by hand and run again.`
+      `AiNecto markers are out of order (${MARKER_END} appears before ${MARKER_BEGIN}). The file was left untouched \u2014 fix the markers by hand and run again.`
     );
   }
 }
-function ownedMarkerCount(content, marker) {
+function ownedMarkerCount(content, kind) {
   let count = 0;
-  for (let at = ownedMarkerIndex(content, marker, 0); at >= 0; at = ownedMarkerIndex(content, marker, at + 1)) {
+  for (let hit = ownedMarker(content, kind, 0); hit !== void 0; hit = ownedMarker(content, kind, hit.at + 1)) {
     count += 1;
   }
   return count;
 }
+function ownedMarker(content, kind, from) {
+  let best;
+  for (const marker of MARKERS[kind]) {
+    const at = ownedMarkerIndex(content, marker, from);
+    if (at >= 0 && (best === void 0 || at < best.at)) {
+      best = { at, length: marker.length };
+    }
+  }
+  return best;
+}
+function anyMarker(content, kind, from) {
+  let best;
+  for (const marker of MARKERS[kind]) {
+    const at = content.indexOf(marker, from);
+    if (at >= 0 && (best === void 0 || at < best.at)) {
+      best = { at, length: marker.length };
+    }
+  }
+  return best;
+}
 function isInsideFencedBlock(content, index) {
   let open;
   let offset = 0;
@@ -2116,24 +2449,24 @@ function markerEvidence(content) {
   let begins = 0;
   let ends = 0;
   while (true) {
-    const begin = rest.indexOf(MARKER_BEGIN, cursor);
-    const close = rest.indexOf(MARKER_END, cursor);
-    if (begin < 0 && close < 0) {
+    const begin = anyMarker(rest, "begin", cursor);
+    const close = anyMarker(rest, "end", cursor);
+    if (begin === void 0 && close === void 0) {
       break;
     }
-    if (begin < 0 || close >= 0 && close < begin) {
+    if (begin === void 0 || close !== void 0 && close.at < begin.at) {
       ends += 1;
-      cursor = close + MARKER_END.length;
+      cursor = close.at + close.length;
       continue;
     }
-    const pairEnd = rest.indexOf(MARKER_END, begin + MARKER_BEGIN.length);
-    if (pairEnd < 0) {
+    const pairEnd = anyMarker(rest, "end", begin.at + begin.length);
+    if (pairEnd === void 0) {
       begins += 1;
-      cursor = begin + MARKER_BEGIN.length;
+      cursor = begin.at + begin.length;
       continue;
     }
-    evidence.push(blockShape(rest.slice(begin, pairEnd + MARKER_END.length)));
-    cursor = pairEnd + MARKER_END.length;
+    evidence.push(blockShape(rest.slice(begin.at, pairEnd.at + pairEnd.length)));
+    cursor = pairEnd.at + pairEnd.length;
   }
   for (let i = 0; i < begins; i += 1) evidence.push(UNPAIRED_BEGIN);
   for (let i = 0; i < ends; i += 1) evidence.push(UNPAIRED_END);
@@ -2150,15 +2483,15 @@ function existingMarkerBlock(content) {
   return range ? content.slice(range.start, range.end) : void 0;
 }
 function markerRange(content) {
-  const start = ownedMarkerIndex(content, MARKER_BEGIN, 0);
-  if (start < 0) {
+  const start = ownedMarker(content, "begin", 0);
+  if (start === void 0) {
     return void 0;
   }
-  const endMarker = ownedMarkerIndex(content, MARKER_END, start);
-  if (endMarker < 0) {
+  const endMarker = ownedMarker(content, "end", start.at);
+  if (endMarker === void 0) {
     return void 0;
   }
-  return { start, end: endMarker + MARKER_END.length };
+  return { start: start.at, end: endMarker.at + endMarker.length };
 }
 function ownedMarkerIndex(content, marker, from) {
   for (let at = content.indexOf(marker, from); at >= 0; at = content.indexOf(marker, at + 1)) {
@@ -2180,13 +2513,15 @@ function ownedMarkerIndex(content, marker, from) {
 }
 
 // src/core/harness/initRecord.ts
-var RECORD_KIND = "ai-erd/init-record";
+var RECORD_KIND = "ainecto/init-record";
+var LEGACY_RECORD_KIND = "ai-erd/init-record";
 var RECORD_VERSION = 2;
 var ABSENT = { at: "absent" };
 function emptyRecord() {
   return { version: RECORD_VERSION, files: {}, createdDirectories: [] };
 }
-function readRecord(content) {
+function readRecord(content, recordPath = HARNESS_RECORD_PATH) {
+  const HARNESS_RECORD_PATH2 = recordPath;
   if (content === void 0) {
     return { state: "absent" };
   }
@@ -2194,26 +2529,26 @@ function readRecord(content) {
   try {
     parsed = JSON.parse(content);
   } catch {
-    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH} is not valid JSON` };
+    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH2} is not valid JSON` };
   }
   if (!isObject(parsed)) {
-    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH} is not a JSON object` };
+    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH2} is not a JSON object` };
   }
-  if (parsed.kind !== RECORD_KIND) {
+  if (parsed.kind !== RECORD_KIND && parsed.kind !== LEGACY_RECORD_KIND) {
     return {
       state: "corrupt",
-      reason: `${HARNESS_RECORD_PATH} exists but is not an ai-erd record (kind=${JSON.stringify(parsed.kind)})`
+      reason: `${HARNESS_RECORD_PATH2} exists but is not an AiNecto init record (kind=${JSON.stringify(parsed.kind)})`
     };
   }
   if (parsed.version !== RECORD_VERSION) {
     return {
       state: "legacy",
-      reason: `${HARNESS_RECORD_PATH} was written by another version of this CLI (record version ${JSON.stringify(parsed.version)}, this CLI reads ${RECORD_VERSION})`
+      reason: `${HARNESS_RECORD_PATH2} was written by another version of this CLI (record version ${JSON.stringify(parsed.version)}, this CLI reads ${RECORD_VERSION})`
     };
   }
   const files = parsed.files;
   if (!isObject(files)) {
-    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH} has no "files" object` };
+    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH2} has no "files" object` };
   }
   const out = {};
   for (const [path, raw] of Object.entries(files)) {
@@ -2221,14 +2556,14 @@ function readRecord(content) {
     if ("problem" in read) {
       return {
         state: "corrupt",
-        reason: `${HARNESS_RECORD_PATH} has an unusable entry for ${path} \u2014 it ${read.problem}`
+        reason: `${HARNESS_RECORD_PATH2} has an unusable entry for ${path} \u2014 it ${read.problem}`
       };
     }
     out[path] = read.contract;
   }
   const directories = parsed.createdDirectories;
   if (directories !== void 0 && !isStringArray(directories)) {
-    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH} has a malformed createdDirectories` };
+    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH2} has a malformed createdDirectories` };
   }
   return {
     state: "valid",
@@ -2274,10 +2609,10 @@ function legacyManagedRecord(configContent) {
     return true;
   }
   const lastWritten = managed.lastWritten;
-  return isObject(lastWritten) && Object.prototype.hasOwnProperty.call(lastWritten, HARNESS_CONFIG_PATH);
+  return isObject(lastWritten) && [HARNESS_CONFIG_PATH, `${LEGACY_HARNESS_DIR}/config.json`].some((path) => Object.prototype.hasOwnProperty.call(lastWritten, path));
 }
 function legacyManagedNotice(configPath) {
-  return `${configPath} holds an init record written by an older version of this CLI (a "managed" field). This version keeps its record in ${HARNESS_RECORD_PATH} and cannot read that one, so your saved originals are still in there and nothing was changed. Undo with the version that wrote it (for example: npx @ai-erd/mcp@0.2 ai-erd init --undo), then run this version again.`;
+  return `${configPath} holds an init record written by an older version of this CLI (a "managed" field). This version keeps its record in ${HARNESS_RECORD_PATH} and cannot read that one, so your saved originals are still in there and nothing was changed. Undo with the version that wrote it (for example: npx -y -p @ai-erd/mcp@0.2 ai-erd init --undo), then run this version again.`;
 }
 function serializeRecord(record) {
   return `${JSON.stringify({
@@ -2297,7 +2632,7 @@ function readContract(raw) {
     return { problem: `has an unknown scope (${JSON.stringify(raw.scope)})` };
   }
   if (typeof raw.createdByUs !== "boolean") {
-    return { problem: "does not say whether ai-erd created the file" };
+    return { problem: "does not say whether ainecto created the file" };
   }
   const original = readOwned(raw.original);
   const written = readOwned(raw.written);
@@ -2305,7 +2640,7 @@ function readContract(raw) {
     return { problem: "has no readable record of what was there before" };
   }
   if (written === void 0) {
-    return { problem: "has no readable record of what ai-erd wrote" };
+    return { problem: "has no readable record of what ainecto wrote" };
   }
   if (raw.fileFingerprint !== void 0 && typeof raw.fileFingerprint !== "string") {
     return { problem: "has a malformed fileFingerprint" };
@@ -2390,7 +2725,7 @@ function fieldsContractProblem(contract, ownedFields) {
     if (!Object.prototype.hasOwnProperty.call(body, key)) {
       return `says it wrote ${key}, but that field is not in the file body it recorded`;
     }
-    if (stableStringify(body[key]) !== stableStringify(writtenFields[key])) {
+    if (stableStringify2(body[key]) !== stableStringify2(writtenFields[key])) {
       return `records a different value for ${key} than the file body it wrote`;
     }
   }
@@ -2418,13 +2753,13 @@ function readOwned(raw) {
   }
   return void 0;
 }
-function stableStringify(value) {
+function stableStringify2(value) {
   if (Array.isArray(value)) {
-    return `[${value.map(stableStringify).join(",")}]`;
+    return `[${value.map(stableStringify2).join(",")}]`;
   }
   if (value && typeof value === "object") {
     const entries = Object.entries(value).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0);
-    return `{${entries.map(([key, item]) => `${JSON.stringify(key)}:${stableStringify(item)}`).join(",")}}`;
+    return `{${entries.map(([key, item]) => `${JSON.stringify(key)}:${stableStringify2(item)}`).join(",")}}`;
   }
   return JSON.stringify(value) ?? "null";
 }
@@ -2436,7 +2771,188 @@ function isStringArray(value) {
 }
 
 // src/core/harness/initPlan.ts
-import { createHash as createHash3 } from "crypto";
+import { createHash as createHash4 } from "crypto";
+
+// src/core/harness/repositoryRole.ts
+import { lstat, readFile as readFile4, realpath } from "fs/promises";
+import { homedir as homedir2 } from "os";
+import { dirname as dirname2, join as join2, resolve, sep } from "path";
+function readConfigRole(path, content) {
+  if (content === void 0 || !content.trim()) {
+    return { kind: "absent" };
+  }
+  let servers;
+  try {
+    const parsed = JSON.parse(content);
+    const raw = parsed?.mcpServers;
+    servers = typeof raw === "object" && raw !== null && !Array.isArray(raw) ? raw : {};
+  } catch {
+    return content.includes(SERVER_NAME) || content.includes(LEGACY_SERVER_NAME) ? { kind: "problem", reason: `${path} is not valid JSON` } : { kind: "absent" };
+  }
+  const roles = [];
+  for (const key of [SERVER_NAME, LEGACY_SERVER_NAME]) {
+    const entry = servers[key];
+    if (!isOurBridge(entry)) {
+      continue;
+    }
+    const role = readRoleFromEntry(entry);
+    if (role === void 0) {
+      return { kind: "problem", reason: `${path} has the "${key}" bridge without a valid --role` };
+    }
+    if (!roles.includes(role)) {
+      roles.push(role);
+    }
+  }
+  if (roles.length > 1) {
+    return {
+      kind: "problem",
+      reason: `${path} has both the "${SERVER_NAME}" and the "${LEGACY_SERVER_NAME}" bridge with different roles (${roles.join(", ")})`
+    };
+  }
+  return roles.length === 0 ? { kind: "absent" } : { kind: "role", role: roles[0] };
+}
+function rolesInFiles(files) {
+  const roles = [];
+  const problems = [];
+  for (const target of AGENT_TARGETS) {
+    const read = readConfigRole(target.path, files.get(target.path));
+    if (read.kind === "problem") {
+      problems.push(read.reason);
+    } else if (read.kind === "role" && !roles.includes(read.role)) {
+      roles.push(read.role);
+    }
+  }
+  return { roles, problems, found: roles.length > 0 || problems.length > 0 };
+}
+async function findRepositoryRole(cwd, home = homedir2()) {
+  const stopAt = await realOrResolved(home);
+  for (let dir = await realOrResolved(cwd); ; dir = dirname2(dir)) {
+    if (samePath(dir, stopAt)) {
+      return { kind: "none" };
+    }
+    const files = /* @__PURE__ */ new Map();
+    let readProblem;
+    for (const target of AGENT_TARGETS) {
+      try {
+        files.set(target.path, await readConfigInside(dir, target.path));
+      } catch (error) {
+        readProblem = error instanceof Error ? error.message : String(error);
+      }
+    }
+    if (readProblem !== void 0) {
+      return { kind: "conflict", dir, reason: readProblem };
+    }
+    const result = rolesInFiles(files);
+    if (result.found) {
+      if (result.problems.length > 0) {
+        return { kind: "conflict", dir, reason: result.problems.join("; ") };
+      }
+      if (result.roles.length > 1) {
+        return {
+          kind: "conflict",
+          dir,
+          reason: `agent configs disagree about the session role (${result.roles.join(", ")})`
+        };
+      }
+      return { kind: "role", role: result.roles[0], dir };
+    }
+    if (dirname2(dir) === dir) {
+      return { kind: "none" };
+    }
+  }
+}
+async function askTheUserToFixRole(dir, reason) {
+  const gitRoot = await findGitRoot(dir);
+  const roles = HARNESS_ROLES.join(", ");
+  if (gitRoot !== void 0 && !samePath(await realOrResolved(gitRoot), await realOrResolved(dir))) {
+    return `Cannot tell this folder's AI session role: ${reason} (in ${dir}, inside the git repository at ${gitRoot}). Ask the user how that AiNecto setting should look \u2014 \`ainecto init\` only sets up a repository root (${gitRoot}).`;
+  }
+  return `Cannot tell this repository's AI session role: ${reason} (in ${dir}). Ask the user which role this repository's AI sessions should have (${roles}), then run \`ainecto init --role <role>\` in ${dir}.`;
+}
+async function realOrResolved(path) {
+  try {
+    return await realpath(path);
+  } catch {
+    return resolve(path);
+  }
+}
+function samePath(left, right) {
+  return process.platform === "win32" ? left.toLowerCase() === right.toLowerCase() : left === right;
+}
+async function readConfigInside(dir, path) {
+  let real;
+  try {
+    real = await realpath(join2(dir, path));
+  } catch (error) {
+    if (isNodeError2(error, "ENOENT") || isNodeError2(error, "ENOTDIR")) {
+      return void 0;
+    }
+    throw error;
+  }
+  const realDir = await realOrResolved(dir);
+  if (!samePath(real, realDir) && !real.startsWith(realDir + sep) && !(process.platform === "win32" && real.toLowerCase().startsWith((realDir + sep).toLowerCase()))) {
+    throw new Error(`${path} points outside ${dir} (${real})`);
+  }
+  return readFile4(real, "utf8");
+}
+async function findGitRoot(cwd) {
+  for (let at = resolve(cwd); ; at = dirname2(at)) {
+    try {
+      await lstat(join2(at, ".git"));
+      return at;
+    } catch {
+    }
+    if (dirname2(at) === at) {
+      return void 0;
+    }
+  }
+}
+async function readManagedFile(root, path) {
+  await assertInsideRepository(root, path);
+  return readIfExists(join2(root, path));
+}
+async function readIfExists(absolutePath) {
+  try {
+    return await readFile4(absolutePath, "utf8");
+  } catch (error) {
+    if (isNodeError2(error, "ENOENT")) {
+      return void 0;
+    }
+    throw error;
+  }
+}
+async function assertInsideRepository(root, relativePath) {
+  const absolutePath = join2(root, relativePath);
+  const realRoot = await realpath(root);
+  let realParent;
+  try {
+    realParent = await realpath(dirname2(absolutePath));
+  } catch (error) {
+    if (isNodeError2(error, "ENOENT")) {
+      return;
+    }
+    throw error;
+  }
+  if (realParent !== realRoot && !realParent.startsWith(realRoot + sep)) {
+    throw new Error(
+      `${relativePath} resolves outside the repository (${realParent}); refusing to touch it.`
+    );
+  }
+  try {
+    if ((await lstat(absolutePath)).isSymbolicLink()) {
+      throw new Error(`${relativePath} is a symbolic link; refusing to write through it.`);
+    }
+  } catch (error) {
+    if (!isNodeError2(error, "ENOENT")) {
+      throw error;
+    }
+  }
+}
+function isNodeError2(error, code) {
+  return typeof error === "object" && error !== null && error.code === code;
+}
+
+// src/core/harness/initPlan.ts
 var NOTE_TARGETS = [
   { path: "AGENTS.md", createIfMissing: true },
   { path: "CLAUDE.md", createIfMissing: false }
@@ -2464,10 +2980,10 @@ function sameOwned(left, right) {
   if (left.at === "text" && right.at === "text") {
     return left.text === right.text;
   }
-  return left.at === "json" && right.at === "json" && stableStringify(left.value) === stableStringify(right.value);
+  return left.at === "json" && right.at === "json" && stableStringify2(left.value) === stableStringify2(right.value);
 }
 function contentFingerprint(content) {
-  return createHash3("sha256").update(content).digest("hex");
+  return createHash4("sha256").update(content).digest("hex");
 }
 function serialize(body) {
   return `${JSON.stringify(body, null, 2)}
@@ -2478,7 +2994,7 @@ function fingerprintFor(path, content) {
     return contentFingerprint(content);
   }
   try {
-    return contentFingerprint(stableStringify(JSON.parse(content)));
+    return contentFingerprint(stableStringify2(JSON.parse(content)));
   } catch {
     return contentFingerprint(content);
   }
@@ -2558,7 +3074,7 @@ function planInit(input) {
       return prior;
     }
     delete record.files[path];
-    notes.push(`${path}: it changed outside ai-erd, so the older backup was dropped and this is the new baseline.`);
+    notes.push(`${path}: it changed outside ainecto, so the older backup was dropped and this is the new baseline.`);
     return void 0;
   };
   for (const target of AGENT_TARGETS) {
@@ -2569,7 +3085,7 @@ function planInit(input) {
     if (existing === merged.content) {
       continue;
     }
-    const before = previousRole(existing);
+    const before = previousRole(target.path, existing);
     if (merged.replaced && before && before !== input.role) {
       notes.push(`${target.path}: role ${before} \u2192 ${input.role}`);
     }
@@ -2625,7 +3141,7 @@ function planInit(input) {
     }
     if (carried?.scope === "block" && unexplainedMarkers(existing, carried) > 0) {
       notes.push(
-        `${target.path}: this file has an ai-erd marker block that is not where ai-erd can find it again (inside a code fence, a quote, or edited). Left untouched and the earlier backup kept \u2014 move that block back to the top level, or remove it, then run again.`
+        `${target.path}: this file has an ainecto marker block that is not where ainecto can find it again (inside a code fence, a quote, or edited). Left untouched and the earlier backup kept \u2014 move that block back to the top level, or remove it, then run again.`
       );
       continue;
     }
@@ -2635,7 +3151,7 @@ function planInit(input) {
     }
     const original = prior?.original ?? ownedText(blockNow);
     if (prior === void 0 && original.at !== "absent") {
-      notes.push(`${target.path}: an existing ai-erd block was saved and will be restored by --undo`);
+      notes.push(`${target.path}: an existing ainecto block was saved and will be restored by --undo`);
     }
     record.files[target.path] = {
       scope: "block",
@@ -2672,11 +3188,11 @@ function planInit(input) {
       const currentValue = presentNow ? theirConfig[field] : void 0;
       const priorOriginal = priorConfig?.originalFields?.[field];
       const priorWritten = priorConfig?.writtenFields;
-      const untouchedByUser = priorWritten !== void 0 && hasField(priorWritten, field) && stableStringify(currentValue) === stableStringify(priorWritten[field]);
+      const untouchedByUser = priorWritten !== void 0 && hasField(priorWritten, field) && stableStringify2(currentValue) === stableStringify2(priorWritten[field]);
       const next = untouchedByUser && priorOriginal !== void 0 ? priorOriginal : ownedJson(currentValue, presentNow);
       originalFields[field] = next;
       if (priorOriginal !== void 0 && !sameOwned(next, priorOriginal)) {
-        notes.push(`${HARNESS_CONFIG_PATH}: you changed ${field} \u2014 ai-erd now treats your value as the one to put back.`);
+        notes.push(`${HARNESS_CONFIG_PATH}: you changed ${field} \u2014 ainecto now treats your value as the one to put back.`);
       }
     }
     const mergedConfig = serialize({ ...theirConfig ?? {}, ...ourFields });
@@ -2722,7 +3238,7 @@ function planUndo(input) {
   const notes = [];
   const tail = () => {
     notes.push(`Codex keeps its own global config \u2014 remove it with: ${codexRemoveCommand()}`);
-    notes.push(`If you set ${ROLE_ENV_VAR} anywhere, unset it too.`);
+    notes.push(`If you set ${ROLE_ENV_VAR} (or the older ${LEGACY_ROLE_ENV_VAR}) anywhere, unset it too.`);
   };
   if (state.state === "absent") {
     notes.push(legacyManagedRecord(input.files.get(HARNESS_CONFIG_PATH)) ? legacyManagedNotice(HARNESS_CONFIG_PATH) : `No record of a previous init in ${HARNESS_RECORD_PATH} \u2014 no local file was changed.`);
@@ -2810,7 +3326,7 @@ function undoEntry(path, contract, existing) {
   if (sameOwned(currentOwned, contract.original)) {
     return {
       kind: "done",
-      note: contract.original.at === "absent" ? `${path}: the "${SERVER_NAME}" entry ai-erd added is already gone.` : `${path}: your original "${SERVER_NAME}" entry is already back in place.`
+      note: contract.original.at === "absent" ? `${path}: the "${SERVER_NAME}" entry ainecto added is already gone.` : `${path}: your original "${SERVER_NAME}" entry is already back in place.`
     };
   }
   const goneButWeHoldTheOriginal = current === void 0 && contract.original.at !== "absent";
@@ -2840,13 +3356,13 @@ function undoBlock(path, contract, existing) {
   if (unexplainedMarkers(existing, contract) > 0) {
     return {
       kind: "unresolved",
-      note: `${path}: this file has an ai-erd marker block that --undo cannot account for (inside a code fence, a quote, or edited). Remove it by hand, then run --undo again.`
+      note: `${path}: this file has an ainecto marker block that --undo cannot account for (inside a code fence, a quote, or edited). Remove it by hand, then run --undo again.`
     };
   }
   if (sameOwned(currentOwned, contract.original)) {
     return {
       kind: "done",
-      note: contract.original.at === "absent" ? `${path}: the ai-erd block is already gone.` : `${path}: the ai-erd block that was there before is already back in place.`
+      note: contract.original.at === "absent" ? `${path}: the ainecto block is already gone.` : `${path}: the ainecto block that was there before is already back in place.`
     };
   }
   if (current === void 0 && contract.original.at === "text") {
@@ -2855,12 +3371,12 @@ function undoBlock(path, contract, existing) {
 ${contract.original.text}
 ` : `${contract.original.text}
 `;
-    return { kind: "write", content: body, note: `${path}: restored the ai-erd block that was there before.` };
+    return { kind: "write", content: body, note: `${path}: restored the ainecto block that was there before.` };
   }
   if (!sameOwned(currentOwned, contract.written)) {
     return {
       kind: "unresolved",
-      note: `${path}: the ai-erd block was edited after init \u2014 left in place. Remove the block by hand if you meant to, then run --undo again.`
+      note: `${path}: the ainecto block was edited after init \u2014 left in place. Remove the block by hand if you meant to, then run --undo again.`
     };
   }
   let result;
@@ -2872,7 +3388,7 @@ ${contract.original.text}
   if (!result.removed) {
     return {
       kind: "unresolved",
-      note: `${path}: the ai-erd block could not be removed \u2014 it is still in the file. Remove it by hand, then run --undo again.`
+      note: `${path}: the ainecto block could not be removed \u2014 it is still in the file. Remove it by hand, then run --undo again.`
     };
   }
   if (result.emptied && contract.createdByUs) {
@@ -2881,7 +3397,7 @@ ${contract.original.text}
   return {
     kind: "write",
     content: result.content,
-    note: contract.original.at === "text" ? `${path}: restored the ai-erd block that was there before.` : void 0
+    note: contract.original.at === "text" ? `${path}: restored the ainecto block that was there before.` : void 0
   };
 }
 function undoWhole(path, contract, existing) {
@@ -2911,14 +3427,14 @@ function undoFields(path, contract, existing) {
   if (parsed === void 0) {
     return {
       kind: "unresolved",
-      note: `${path} is not a JSON object any more, so ai-erd could not take its fields back out \u2014 the backup is kept. Fix the file and run --undo again.`
+      note: `${path} is not a JSON object any more, so ainecto could not take its fields back out \u2014 the backup is kept. Fix the file and run --undo again.`
     };
   }
   const contractProblem = fieldsContractProblem(contract, OUR_CONFIG_FIELDS);
   if (contractProblem !== void 0) {
     return {
       kind: "unresolved",
-      note: `${path}: ai-erd's record of the fields it wrote ${contractProblem}, so its fields were left in place \u2014 the backup is kept. Restore that record, or remove the fields by hand.`
+      note: `${path}: ainecto's record of the fields it wrote ${contractProblem}, so its fields were left in place \u2014 the backup is kept. Restore that record, or remove the fields by hand.`
     };
   }
   const written = contract.writtenFields;
@@ -2933,10 +3449,10 @@ function undoFields(path, contract, existing) {
     if (!hasField(written, field)) {
       return {
         kind: "unresolved",
-        note: `${path}: ai-erd has no record of what it wrote for ${field}, so its fields were left in place \u2014 the backup is kept. Restore that record, or remove the field by hand.`
+        note: `${path}: ainecto has no record of what it wrote for ${field}, so its fields were left in place \u2014 the backup is kept. Restore that record, or remove the field by hand.`
       };
     }
-    const stillOurs = stableStringify(value) === stableStringify(written[field]);
+    const stillOurs = stableStringify2(value) === stableStringify2(written[field]);
     if (!stillOurs) {
       next[field] = value;
       kept.push(field);
@@ -2946,7 +3462,7 @@ function undoFields(path, contract, existing) {
     if (original === void 0 || original.at !== "json" && original.at !== "absent") {
       return {
         kind: "unresolved",
-        note: `${path}: ai-erd cannot tell what was in ${field} before it wrote there, so the file was left as it is \u2014 the backup is kept. Remove the field by hand if you meant to.`
+        note: `${path}: ainecto cannot tell what was in ${field} before it wrote there, so the file was left as it is \u2014 the backup is kept. Remove the field by hand if you meant to.`
       };
     }
     if (original.at === "json") {
@@ -2961,7 +3477,7 @@ function undoFields(path, contract, existing) {
   return body === existing ? { kind: "done", note } : {
     kind: "write",
     content: body,
-    note: note ?? `${path}: removed what ai-erd wrote and kept the rest.`
+    note: note ?? `${path}: removed what ainecto wrote and kept the rest.`
   };
 }
 function withCreatedDirectories(current, directories) {
@@ -2981,27 +3497,98 @@ function parentsOf(paths) {
   }
   return [...directories].sort((left, right) => right.length - left.length);
 }
-function detectRoles(files) {
-  const found = /* @__PURE__ */ new Map();
-  for (const target of AGENT_TARGETS) {
-    const existing = files.get(target.path);
-    if (existing === void 0) {
+function previousRole(path, existing) {
+  const read = readConfigRole(path, existing);
+  return read.kind === "role" ? read.role : void 0;
+}
+
+// src/core/harness/legacyLayout.ts
+var LEGACY_PATHS = new Map(
+  [HARNESS_DOC_PATH, HARNESS_CONFIG_PATH, HARNESS_RECORD_PATH].map((path) => [path, toLegacy(path)])
+);
+var LEGACY_RECORD_PATH = toLegacy(HARNESS_RECORD_PATH);
+var LEGACY_SNAPSHOT_PATHS = [...LEGACY_PATHS.values()];
+function adoptLegacyLayout(disk) {
+  const files = /* @__PURE__ */ new Map();
+  for (const [path, content] of disk) {
+    if (!LEGACY_SNAPSHOT_PATHS.includes(path)) {
+      files.set(path, content);
+    }
+  }
+  const view = { files, moves: [], legacyDirCreatedByUs: false, notes: [] };
+  if (!LEGACY_SNAPSHOT_PATHS.some((path) => disk.get(path) !== void 0)) {
+    return view;
+  }
+  const legacyRecord = disk.get(LEGACY_RECORD_PATH);
+  if (legacyRecord === void 0) {
+    const legacyConfig = LEGACY_PATHS.get(HARNESS_CONFIG_PATH);
+    if (disk.get(HARNESS_RECORD_PATH) === void 0 && legacyManagedRecord(disk.get(legacyConfig))) {
+      return { ...view, refusal: legacyManagedNotice(legacyConfig) };
+    }
+    view.notes.push(
+      `${LEGACY_HARNESS_DIR}/ was left in place \u2014 there is no ${LEGACY_RECORD_PATH} showing that an earlier version of this CLI wrote it. Remove it by hand if it is a leftover.`
+    );
+    return view;
+  }
+  const state = readRecord(legacyRecord, LEGACY_RECORD_PATH);
+  if (state.state !== "valid") {
+    return {
+      ...view,
+      refusal: state.state === "absent" ? `${LEGACY_RECORD_PATH} could not be read. Nothing was changed.` : `${state.reason}. Nothing was changed \u2014 move that file aside (or restore it) and run again.`
+    };
+  }
+  const clash = [...LEGACY_PATHS].filter(([to, from]) => disk.get(to) !== void 0 && disk.get(from) !== void 0).map(([to]) => to);
+  if (clash.length > 0) {
+    return {
+      ...view,
+      refusal: `Both ${LEGACY_HARNESS_DIR}/ and ${HARNESS_DIR}/ hold AiNecto setup files (${clash.join(", ")}): an older version of this CLI (0.4.x) ran here after this one, or a move was interrupted. Nothing was changed. Undo the older setup with \`npx -y -p @ai-erd/mcp@0.4.6 ai-erd init --undo\` (or remove the ${LEGACY_HARNESS_DIR}/ leftovers by hand), then run again.`
+    };
+  }
+  const record = state.record;
+  const renamed = {
+    ...record,
+    files: Object.fromEntries(Object.entries(record.files).map(([path, contract]) => [toCurrent(path), contract])),
+    // «하네스 폴더를 우리가 만들었다»는 같은 사실이다 — 이름만 옮긴다. 새 폴더를 이번에 만들면 적용이 또 적는다.
+    createdDirectories: record.createdDirectories.map(toCurrent)
+  };
+  const moves = [];
+  for (const [to, from] of LEGACY_PATHS) {
+    const content = disk.get(from);
+    if (content === void 0) {
       continue;
     }
-    found.set(target.path, previousRole(existing));
+    files.set(to, to === HARNESS_RECORD_PATH ? serializeRecord(renamed) : content);
+    moves.push({ from, to });
   }
-  return found;
+  return {
+    files,
+    moves,
+    legacyDirCreatedByUs: record.createdDirectories.includes(LEGACY_HARNESS_DIR),
+    notes: [`${LEGACY_HARNESS_DIR}/ \u2192 ${HARNESS_DIR}/: moved what an earlier version of this CLI wrote (the folder was renamed).`]
+  };
 }
-function previousRole(existing) {
-  if (existing === void 0) {
-    return void 0;
-  }
-  try {
-    const parsed = JSON.parse(existing);
-    return readRoleFromEntry(parsed.mcpServers?.[SERVER_NAME]);
-  } catch {
-    return void 0;
+function withLegacyMoves(plan, view) {
+  if (view.moves.length === 0) {
+    return view.notes.length === 0 ? plan : { ...plan, notes: [...view.notes, ...plan.notes] };
   }
+  const movedTo = new Set(view.moves.map((move) => move.to));
+  const planned = /* @__PURE__ */ new Set([...plan.writes.map((write) => write.path), ...plan.deletes]);
+  const carried = view.moves.filter((move) => !planned.has(move.to)).map((move) => ({ path: move.to, content: view.files.get(move.to), existed: false }));
+  return {
+    ...plan,
+    // 새 경로는 디스크에 아직 없다 — «만든다»가 사실이다.
+    writes: [...plan.writes.map((write) => movedTo.has(write.path) ? { ...write, existed: false } : write), ...carried],
+    // 새 경로의 삭제는 디스크에 없는 파일이다 — 대신 옛 파일을 지운다.
+    deletes: [...plan.deletes.filter((path) => !movedTo.has(path)), ...view.moves.map((move) => move.from)],
+    notes: [...view.notes, ...plan.notes],
+    removableDirectories: view.legacyDirCreatedByUs ? [...plan.removableDirectories ?? [], LEGACY_HARNESS_DIR] : plan.removableDirectories
+  };
+}
+function toLegacy(path) {
+  return `${LEGACY_HARNESS_DIR}${path.slice(HARNESS_DIR.length)}`;
+}
+function toCurrent(path) {
+  return path === LEGACY_HARNESS_DIR || path.startsWith(`${LEGACY_HARNESS_DIR}/`) ? `${HARNESS_DIR}${path.slice(LEGACY_HARNESS_DIR.length)}` : path;
 }
 
 // src/core/harness/documentFetch.ts
@@ -3057,36 +3644,143 @@ function usableBodyProblem(key, entry) {
   return documentContractProblem(key, entry.body);
 }
 
+// src/adapters/cli/prompter.ts
+import { createInterface as createInterface3 } from "readline";
+var PromptCancelled = class extends Error {
+  constructor() {
+    super("Cancelled \u2014 no repository files were written. A sign-in you already completed stays saved.");
+    this.name = "PromptCancelled";
+  }
+};
+var AGENT_ENV_MARKERS = ["CLAUDECODE", "CI", "GEMINI_CLI", "CODEX_SANDBOX", "CURSOR_AGENT"];
+function agentEnvironment(env = process.env) {
+  return AGENT_ENV_MARKERS.find((name) => {
+    const value = env[name]?.trim().toLowerCase();
+    return value !== void 0 && value !== "" && value !== "0" && value !== "false";
+  });
+}
+function isInteractive(io, json, env = process.env) {
+  return io.stdin?.isTTY === true && io.stdout?.isTTY === true && !json && agentEnvironment(env) === void 0;
+}
+function createReadlinePrompter(io) {
+  let rl;
+  let lines;
+  const readLine = async (prompt) => {
+    io.stderr.write(prompt);
+    if (!rl) {
+      rl = createInterface3({ input: io.stdin, terminal: false });
+      lines = rl[Symbol.asyncIterator]();
+    }
+    const next = await lines.next();
+    if (next.done) {
+      io.stderr.write("\n");
+      throw new PromptCancelled();
+    }
+    return next.value;
+  };
+  return {
+    choose: (question, choices, defaultIndex) => chooseWith(readLine, (text) => io.stderr.write(text), question, choices, defaultIndex),
+    text: async (question, defaultValue) => {
+      const answer = (await readLine(`${question} [${defaultValue}]: `)).trim();
+      return answer || defaultValue;
+    },
+    close: () => {
+      rl?.close();
+    }
+  };
+}
+async function chooseWith(readLine, write, question, choices, defaultIndex) {
+  if (choices.length === 0) {
+    throw new Error(`Nothing to choose for: ${question}`);
+  }
+  write(`${question}
+`);
+  choices.forEach((choice, index) => write(`  [${index + 1}] ${choice.label}
+`));
+  const hint = defaultIndex === void 0 ? "" : ` [${defaultIndex + 1}]`;
+  for (; ; ) {
+    const answer = (await readLine(`Enter a number (1-${choices.length})${hint}: `)).trim();
+    if (answer === "" && defaultIndex !== void 0) {
+      return choices[defaultIndex].value;
+    }
+    const picked = /^\d+$/.test(answer) ? Number(answer) : NaN;
+    if (picked >= 1 && picked <= choices.length) {
+      return choices[picked - 1].value;
+    }
+    write(answer === "" ? "Please choose one \u2014 there is no default here.\n" : `"${answer}" is not one of the numbers above.
+`);
+  }
+}
+
 // src/adapters/cli/initCommand.ts
+function singleRole(roles) {
+  return roles.length === 1 ? roles[0] : void 0;
+}
 async function executeInitCommand(options) {
+  try {
+    return await runInit(options);
+  } catch (error) {
+    if (error instanceof PromptCancelled) {
+      options.io.stderr.write(`${error.message}
+`);
+      return 130;
+    }
+    throw error;
+  } finally {
+    options.prompter?.close();
+  }
+}
+async function runInit(initialOptions) {
+  let options = initialOptions;
   const args = parseInitArgs(options.argv);
-  const root = resolve(options.cwd);
-  const files = await readSnapshot(root);
+  const root = resolve2(options.cwd);
+  const rootNotes = await repositoryRootNotes(root);
+  const disk = await readSnapshot(root);
+  const layout = adoptLegacyLayout(disk);
+  const files = layout.files;
   if (args.undo) {
-    const plan2 = planUndo({ files });
-    await applyPlan(root, plan2, args.dryRun, files, false);
+    if (layout.refusal !== void 0) {
+      options.io.stdout.write(renderSuccess(
+        { action: args.dryRun ? "undo (dry-run)" : "undo", updated: [], removed: [], notes: [...rootNotes, layout.refusal] },
+        { json: options.json }
+      ));
+      return 0;
+    }
+    const plan2 = withLegacyMoves(planUndo({ files }), layout);
+    await applyPlan(root, plan2, args.dryRun, disk, false);
     options.io.stdout.write(renderSuccess(
       {
         action: args.dryRun ? "undo (dry-run)" : "undo",
         updated: plan2.writes.map((write) => write.path),
         removed: plan2.deletes,
-        notes: plan2.notes
+        notes: [...rootNotes, ...plan2.notes]
       },
       { json: options.json }
     ));
     return 0;
   }
-  const role = options.role ?? currentRole(files);
+  const refusal = layout.refusal ?? initRefusal(files);
+  if (refusal !== void 0) {
+    throw new Error(refusal);
+  }
+  const prompter = options.prompter;
+  const role = options.role ?? (prompter ? await askRole(prompter, singleRole(rolesInFiles(files).roles)) : currentRole(files));
+  const previousRole2 = (() => {
+    try {
+      return currentRole(files);
+    } catch {
+      return void 0;
+    }
+  })();
   if (!role) {
     throw new Error(
-      `--role is required on first run. Pick one of: ${HARNESS_ROLES.join(", ")}.`
+      `No role given. Ask the user which role this repository's AI sessions should have (${HARNESS_ROLES.join(", ")}), then re-run with --role <role>.`
     );
   }
-  const refusal = initRefusal(files);
-  if (refusal !== void 0) {
-    throw new Error(refusal);
-  }
-  const project = await resolveProject(options, args, files, root);
+  const connected = connectAs(options, role);
+  options = connected;
+  await ensureSignedIn(connected, role, args.dryRun);
+  const project = await resolveProject(connected, args, files, root, role);
   if ("choices" in project) {
     options.io.stdout.write(renderSuccess(
       {
@@ -3100,10 +3794,12 @@ async function executeInitCommand(options) {
   const documents = args.dryRun ? { versions: {}, fallbacks: {}, unavailableReason: "skipped in --dry-run" } : await fetchHarnessDocuments({
     endpoint: options.endpoint,
     accessToken: await options.accessToken?.(),
+    // ⛔이 이름은 바꾸지 않는다 — 서버가 문서의 클라이언트별 변형 키(HARNESS.DOC.AI_ERD_CLI 등)를 이것으로
+    //   찾는다. 사람에게 안 보이는 서버 쪽 식별자다(역할 헤더·scope 와 같은 이유, 2026-10-11).
     client: "ai-erd-cli",
     fetchImpl: options.fetchImpl
   });
-  const plan = planInit({
+  const plan = withLegacyMoves(planInit({
     role,
     env: options.env,
     projectName: project.name,
@@ -3112,11 +3808,15 @@ async function executeInitCommand(options) {
     cliVersion: options.cliVersion,
     files,
     documents
-  });
+  }), layout);
   if (plan.refusal !== void 0) {
     throw new Error(plan.refusal);
   }
-  await applyPlan(root, plan, args.dryRun, files);
+  await applyPlan(root, plan, args.dryRun, disk);
+  if (!args.dryRun && previousRole2 !== void 0 && previousRole2 !== role) {
+    options.io.stderr.write(`Role changes from ${previousRole2} to ${role}: \`ainecto\` commands now, MCP tools from a new session.
+`);
+  }
   options.io.stdout.write(renderSuccess(
     {
       action: args.dryRun ? "init (dry-run)" : "init",
@@ -3124,42 +3824,45 @@ async function executeInitCommand(options) {
       project: { uuid: project.uuid, name: project.name },
       endpoint: options.endpoint,
       written: plan.writes.map((write) => `${write.existed ? "updated" : "created"} ${write.path}`),
+      // 옛 폴더(.ai-erd/)를 옮길 때만 생긴다 — 지운 것을 말하지 않으면 사용자는 옛 파일이 어디 갔는지 모른다.
+      ...plan.deletes.length > 0 ? { removed: plan.deletes } : {},
       codex: `Codex keeps a single global config, so init does not touch it. Run: ${plan.codexCommand}`,
       codexPerSession: plan.codexProfile,
       codexEnvFallback: `Without a profile, start the session with ${ROLE_ENV_VAR}=${role}.`,
       // ⚠조용히 기본값으로 떨어지지 않는다 — 서버에서 규칙을 고쳐도 안 바뀌는 이유를
       //   사용자가 영영 못 찾게 된다. ★요청 자체의 실패와 «문서별» 되돌림을 둘 다 적는다
       //   (2026-09-23 독립 재리뷰 I5: HTTP 200 으로 온 빈 문서가 조용히 패키지 판이 됐다).
-      notes: [...plan.notes, ...fallbackNotes(documents)],
+      notes: [...rootNotes, ...plan.notes, ...fallbackNotes(documents)],
+      // ★「Enforce this on the server too: ainecto auth login …」 줄은 뺐다. init 이 이미 그 역할로
+      //   로그인했으므로 참이 아니고, 남아 있으면 에이전트가 따라 쳐서 사람이 한 번 더 승인하게 된다
+      //   (2026-09-29 독립 리뷰 P1-1).
+      // ★재시작 없이 이어간다(2026-09-30 사용자 결정). 셸의 `ainecto` 는 부를 때마다 저장소 역할을 읽어
+      //   역할 헤더로 싣는다 — 서버가 요청마다 강제하므로 MCP 연결과 무관하게 이 세션에서 바로 맞다.
+      //   재시작은 «그 역할의 MCP 도구»를 더할 뿐인 선택이다.
       next: [
-        "Restart the agent so it picks up the new MCP server.",
-        role === "design" ? "Ask it to change a table \u2014 a Design session may, and the change lands in AI-ERD." : `Ask it to change a table \u2014 a ${role} session will be told to stop.`,
-        `Enforce this on the server too: ${loginCommand(options, role)}`,
-        "Undo everything with: ai-erd init --undo"
+        `Keep working in this session \u2014 no restart is needed. \`ainecto\` commands run from this repository use the ${role} role at once.`,
+        `Read ${HARNESS_DOC_PATH} first, then \`ainecto tools list\` shows the role's tools and \`ainecto tools call <tool> '<json>'\` calls one.`,
+        "Do not use MCP tools this session started with for this work \u2014 they keep the role (or no role) the session started with.",
+        "Optional, to add the role's MCP tools: start a new session.",
+        `Claude Code: exit and run \`claude -c\` in this folder, then approve the "${SERVER_NAME}" server from .mcp.json when asked.`,
+        `Codex: save the profile above as $CODEX_HOME/${role}.config.toml and start with \`codex -p ${role}\`.`,
+        role === "design" ? "To check the role, change a table through `ainecto` \u2014 Design may, and the change lands in AiNecto." : `To check the role, try changing a table through \`ainecto\` \u2014 ${role} is told to stop.`,
+        `If the new Claude Code session still has no role, run \`claude mcp get ${SERVER_NAME}\`: a local-scope "${SERVER_NAME}" entry hides .mcp.json (remove it with \`claude mcp remove ${SERVER_NAME} -s local\`).`,
+        // ★서버 이름이 바뀌었다(0.5.0). 예전에 같은 이름("ai-erd")이라 .mcp.json 이 덮던 사용자·Codex 전역 항목이
+        //   이제는 «따로» 붙어, 그 세션이 역할 없는 서버를 하나 더 본다. 그 항목을 지우는 법을 같이 말한다.
+        `If you added AiNecto earlier as "${LEGACY_SERVER_NAME}" (Claude Code user scope, or Codex), remove it \u2014 it no longer hides behind this "${SERVER_NAME}" entry: \`claude mcp remove ${LEGACY_SERVER_NAME} -s user\`, \`codex mcp remove ${LEGACY_SERVER_NAME}\`.`,
+        "Undo everything with: ainecto init --undo"
       ]
     },
     { json: options.json }
   ));
   return 0;
 }
-async function readRepositoryRole(cwd) {
-  const root = resolve(cwd);
-  const files = /* @__PURE__ */ new Map();
-  for (const target of AGENT_TARGETS) {
-    files.set(target.path, await readManagedFile(root, target.path));
-  }
-  try {
-    return currentRole(files);
-  } catch {
-    return void 0;
-  }
-}
 function currentRole(files) {
-  const found = [...detectRoles(files).values()].filter((role) => role !== void 0);
-  const unique = [...new Set(found)];
+  const unique = rolesInFiles(files).roles;
   if (unique.length > 1) {
     throw new Error(
-      `Agent configs disagree about the session role (${unique.join(", ")}). Re-run with an explicit --role to line them up.`
+      `Agent configs in this repository disagree about the session role (${unique.join(", ")}). Ask the user which role this repository's AI sessions should have (${HARNESS_ROLES.join(", ")}), then re-run with --role <role> to line them up.`
     );
   }
   return unique[0];
@@ -3174,13 +3877,108 @@ function fallbackNotes(documents) {
   }
   return notes;
 }
-async function resolveProject(options, args, files, root) {
+async function ensureSignedIn(options, role, dryRun) {
+  if (options.login === void 0) {
+    return;
+  }
+  if (await options.accessToken?.()) {
+    return;
+  }
+  if (dryRun) {
+    throw new Error(
+      `No usable AiNecto sign-in on this machine, and --dry-run neither refreshes it nor opens a browser.
+
+    ${loginCommand(options)}
+
+Then run init again.`
+    );
+  }
+  await options.login();
+  options.io.stderr.write("Signed in.\n");
+}
+async function repositoryRootNotes(cwd) {
+  const gitRoot = await findGitRoot(cwd);
+  if (gitRoot === void 0) {
+    return [`${cwd} is not inside a git repository, so this folder was used as the repository root.`];
+  }
+  if (gitRoot !== cwd) {
+    throw new Error(
+      `This folder is inside the git repository at ${gitRoot}, not at its root. Agents read their MCP config from the repository root, so run init there:
+
+    cd ${gitRoot}
+
+Nothing was changed.`
+    );
+  }
+  return [];
+}
+function connectAs(options, role) {
+  if (options.connect) {
+    const connection = options.connect(role);
+    return { ...options, ...connection };
+  }
+  if (!options.client) {
+    throw new Error("init needs either a client or a way to connect once the role is known.");
+  }
+  return { ...options, client: options.client };
+}
+var ROLE_CHOICES = [
+  { label: "Design       requirements, ERD, boundaries, tasks", value: "design" },
+  { label: "Development  product code, following the approved design", value: "development" },
+  { label: "Test         test scenarios and test code", value: "test" },
+  { label: "Validation   judges the result; changes nothing", value: "validation" }
+];
+async function askRole(prompter, current) {
+  const index = current === void 0 ? void 0 : ROLE_CHOICES.findIndex((choice) => choice.value === current);
+  return prompter.choose(
+    current === void 0 ? "Which role should AI sessions in this repository have?" : `Which role should AI sessions in this repository have? (now: ${current})`,
+    ROLE_CHOICES,
+    index
+  );
+}
+async function askProject(options, args, projects, bound, root, role, prompter) {
+  const canCreate = role === "design" && !args.dryRun;
+  const askNameAndCreate = async () => {
+    const name = await prompter.text("New project name", args.projectName ?? basenameOf(root));
+    return createProject(options, name);
+  };
+  if (projects.length === 0) {
+    if (role !== "design") {
+      throw new Error(noProjectForRole(options, role));
+    }
+    if (args.dryRun) {
+      throw new Error(dryRunCannotCreate(args.projectName ?? basenameOf(root)));
+    }
+    return askNameAndCreate();
+  }
+  const choices = projects.map((project) => ({
+    label: `${project.name}  (${project.uuid})`,
+    value: { project }
+  }));
+  if (canCreate) {
+    choices.push({ label: "Create a new project", value: { create: true } });
+  }
+  const boundIndex = bound === void 0 ? -1 : projects.findIndex((project) => project.uuid === bound);
+  const defaultIndex = boundIndex >= 0 ? boundIndex : projects.length === 1 ? 0 : void 0;
+  const picked = await prompter.choose("Which AiNecto project should this repository use?", choices, defaultIndex);
+  return "create" in picked ? askNameAndCreate() : picked.project;
+}
+function noProjectForRole(options, role) {
+  return `No project found in your AiNecto account, and only a Design session can create one. Ask the user: create the project at ${new URL(options.endpoint).origin} or in a Design session, then run init again with --role ${role}.`;
+}
+function dryRunCannotCreate(name) {
+  return `--dry-run cannot continue: there is no project to bind, and creating "${name}" would be a real change. Re-run without --dry-run, or pass --project <uuid>.`;
+}
+async function resolveProject(options, args, files, root, role) {
   const projects = await listProjects(options);
   if (args.projectUuid) {
     const found = projects.find((project) => project.uuid === args.projectUuid);
     return found ?? { uuid: args.projectUuid, name: args.projectName ?? args.projectUuid };
   }
   const bound = boundProjectUuid(files.get(HARNESS_CONFIG_PATH));
+  if (options.prompter) {
+    return askProject(options, args, projects, bound, root, role, options.prompter);
+  }
   if (bound) {
     const found = projects.find((project) => project.uuid === bound);
     if (found) {
@@ -3193,16 +3991,17 @@ async function resolveProject(options, args, files, root) {
   if (projects.length > 1) {
     return { choices: projects };
   }
+  if (role !== "design") {
+    throw new Error(noProjectForRole(options, role));
+  }
   const name = args.projectName ?? basenameOf(root);
   if (!args.yes) {
     throw new Error(
-      `No project found in your AI-ERD account. Re-run with --yes to create "${name}", or --project-name <name> --yes to pick the name.`
+      `No project found in your AiNecto account. Re-run with --yes to create "${name}", or --project-name <name> --yes to pick the name.`
     );
   }
   if (args.dryRun) {
-    throw new Error(
-      `--dry-run cannot continue: there is no project to bind, and creating "${name}" would be a real change. Re-run without --dry-run, or pass --project <uuid>.`
-    );
+    throw new Error(dryRunCannotCreate(name));
   }
   return createProject(options, name);
 }
@@ -3218,17 +4017,17 @@ async function callOrExplainSignIn(options, run) {
       throw error;
     }
     throw new Error(
-      `Not signed in for this role, so ${options.endpoint} refused the request (HTTP 401).
+      `Not signed in, so ${options.endpoint} refused the request (HTTP 401).
 
-    ${loginCommand(options, options.role)}
+    ${loginCommand(options)}
 
-Then run init again. The role is carried by the access token, so each role signs in once.`
+Then run init again. Sign-in is one per machine; the role comes from this repository.`
     );
   }
 }
-function loginCommand(options, role) {
+function loginCommand(options) {
   const target = isDefaultEndpointFor(options.env, options.endpoint) ? options.env === "prod" ? "" : ` --env ${options.env}` : ` --endpoint ${options.endpoint}`;
-  return `ai-erd auth login --role ${role ?? "<design|development|test|validation>"}${target}`;
+  return `ainecto auth login${target}`;
 }
 function isUnauthorized(error) {
   return error instanceof McpRpcError && error.code === "MCP_HTTP_ERROR" && error.details?.status === 401;
@@ -3240,14 +4039,16 @@ async function createProject(options, name) {
   if (!first) {
     throw new Error("Project creation did not return a project uuid.");
   }
+  options.io.stderr.write(`Created project ${first.name} (${first.uuid}).
+`);
   return first;
 }
 function unwrapToolJson(result) {
-  if (!isRecord8(result) || !Array.isArray(result.content)) {
+  if (!isRecord9(result) || !Array.isArray(result.content)) {
     return result;
   }
-  const first = result.content.find((item) => isRecord8(item) && item.type === "text");
-  if (!isRecord8(first) || typeof first.text !== "string") {
+  const first = result.content.find((item) => isRecord9(item) && item.type === "text");
+  if (!isRecord9(first) || typeof first.text !== "string") {
     return result;
   }
   try {
@@ -3257,13 +4058,13 @@ function unwrapToolJson(result) {
   }
 }
 function extractProjects(value) {
-  const candidates = Array.isArray(value) ? value : isRecord8(value) ? ["projects", "items", "created", "data", "hits"].flatMap((key) => {
+  const candidates = Array.isArray(value) ? value : isRecord9(value) ? ["projects", "items", "created", "data", "hits"].flatMap((key) => {
     const nested = value[key];
     return Array.isArray(nested) ? nested : [];
   }) : [];
   const projects = [];
   for (const candidate of candidates) {
-    if (isRecord8(candidate) && typeof candidate.uuid === "string") {
+    if (isRecord9(candidate) && typeof candidate.uuid === "string") {
       projects.push({
         uuid: candidate.uuid,
         name: typeof candidate.name === "string" ? candidate.name : candidate.uuid
@@ -3285,52 +4086,11 @@ function boundProjectUuid(config) {
 }
 async function readSnapshot(root) {
   const snapshot = /* @__PURE__ */ new Map();
-  for (const path of MANAGED_PATHS) {
+  for (const path of [...MANAGED_PATHS, ...LEGACY_SNAPSHOT_PATHS]) {
     snapshot.set(path, await readManagedFile(root, path));
   }
   return snapshot;
 }
-async function readManagedFile(root, path) {
-  await assertInsideRepository(root, path);
-  return readIfExists(join2(root, path));
-}
-async function readIfExists(absolutePath) {
-  try {
-    return await readFile4(absolutePath, "utf8");
-  } catch (error) {
-    if (isRecord8(error) && error.code === "ENOENT") {
-      return void 0;
-    }
-    throw error;
-  }
-}
-async function assertInsideRepository(root, relativePath) {
-  const absolutePath = join2(root, relativePath);
-  const realRoot = await realpath(root);
-  let realParent;
-  try {
-    realParent = await realpath(dirname2(absolutePath));
-  } catch (error) {
-    if (isRecord8(error) && error.code === "ENOENT") {
-      return;
-    }
-    throw error;
-  }
-  if (realParent !== realRoot && !realParent.startsWith(realRoot + sep)) {
-    throw new Error(
-      `${relativePath} resolves outside the repository (${realParent}); refusing to touch it.`
-    );
-  }
-  try {
-    if ((await lstat(absolutePath)).isSymbolicLink()) {
-      throw new Error(`${relativePath} is a symbolic link; refusing to write through it.`);
-    }
-  } catch (error) {
-    if (!isRecord8(error) || error.code !== "ENOENT") {
-      throw error;
-    }
-  }
-}
 async function applyPlan(root, plan, dryRun, snapshot, recordFirst = true) {
   for (const write of plan.writes) {
     await assertInsideRepository(root, write.path);
@@ -3345,9 +4105,9 @@ async function applyPlan(root, plan, dryRun, snapshot, recordFirst = true) {
   }
   const applied = [];
   try {
-    const isRecord9 = (path) => !recordFirst && path === HARNESS_RECORD_PATH;
-    const recordWrites = plan.writes.filter((write) => isRecord9(write.path));
-    const recordDeletes = plan.deletes.filter((path) => isRecord9(path));
+    const isRecord10 = (path) => !recordFirst && (path === HARNESS_RECORD_PATH || path === LEGACY_RECORD_PATH);
+    const recordWrites = plan.writes.filter((write) => isRecord10(write.path));
+    const recordDeletes = plan.deletes.filter((path) => isRecord10(path));
     const createdDirectories = [...plan.record?.createdDirectories ?? []];
     const rememberDirectories = (directories) => {
       for (const directory of directories) {
@@ -3383,14 +4143,14 @@ async function applyPlan(root, plan, dryRun, snapshot, recordFirst = true) {
       }
       for (const path of deletes) {
         await assertUnchangedSinceSnapshot(root, path, snapshot);
-        await rm2(join2(root, path), { force: true });
+        await rm2(join3(root, path), { force: true });
         applied.push(path);
       }
     };
     try {
       await apply(
-        orderedWrites(plan.writes.filter((write) => !isRecord9(write.path)), recordFirst),
-        plan.deletes.filter((path) => !isRecord9(path))
+        orderedWrites(plan.writes.filter((write) => !isRecord10(write.path)), recordFirst),
+        plan.deletes.filter((path) => !isRecord10(path))
       );
       await recordDirectoriesOrExplain(false);
       await apply(recordWrites, recordDeletes);
@@ -3406,7 +4166,7 @@ Already applied before this failure: ${applied.join(", ") || "(nothing)"}`
     );
   }
   for (const directory of plan.removableDirectories ?? []) {
-    await rmdir(join2(root, directory)).catch(() => void 0);
+    await rmdir(join3(root, directory)).catch(() => void 0);
   }
 }
 function orderedWrites(writes, recordFirst) {
@@ -3418,7 +4178,7 @@ async function assertUnchangedSinceSnapshot(root, relativePath, snapshot) {
   if (!snapshot.has(relativePath)) {
     return;
   }
-  const now = await readIfExists(join2(root, relativePath));
+  const now = await readIfExists(join3(root, relativePath));
   if (now !== snapshot.get(relativePath)) {
     throw new Error(
       `${relativePath} changed while init was running; nothing was written. Run init again.`
@@ -3426,8 +4186,8 @@ async function assertUnchangedSinceSnapshot(root, relativePath, snapshot) {
   }
 }
 async function writeManagedFile(root, write, onDirectoriesCreated) {
-  const absolutePath = join2(root, write.path);
-  const targetDirectory = dirname2(absolutePath);
+  const absolutePath = join3(root, write.path);
+  const targetDirectory = dirname3(absolutePath);
   const firstCreated = await mkdir2(targetDirectory, { recursive: true });
   const created = createdChain(root, firstCreated, targetDirectory);
   onDirectoriesCreated?.(created);
@@ -3444,14 +4204,14 @@ function createdChain(root, firstCreated, targetDirectory) {
   if (firstCreated === void 0) {
     return [];
   }
-  const stop = resolve(firstCreated);
+  const stop = resolve2(firstCreated);
   const made = [];
-  for (let at = resolve(targetDirectory); ; at = dirname2(at)) {
+  for (let at = resolve2(targetDirectory); ; at = dirname3(at)) {
     const asRelative = relative(root, at);
     if (asRelative && !asRelative.startsWith("..")) {
-      made.push(asRelative.split(sep).join("/"));
+      made.push(asRelative.split(sep2).join("/"));
     }
-    if (at === stop || dirname2(at) === at) {
+    if (at === stop || dirname3(at) === at) {
       break;
     }
   }
@@ -3461,7 +4221,7 @@ async function fileMode(absolutePath) {
   try {
     return (await stat3(absolutePath)).mode & 4095;
   } catch (error) {
-    if (isRecord8(error) && error.code === "ENOENT") {
+    if (isRecord9(error) && error.code === "ENOENT") {
       return void 0;
     }
     throw error;
@@ -3499,43 +4259,53 @@ function requireValue3(flag, value) {
 }
 function basenameOf(path) {
   const parts = path.split(/[\\/]/).filter(Boolean);
-  return parts[parts.length - 1] ?? "ai-erd-project";
+  return parts[parts.length - 1] ?? "ainecto-project";
 }
-function isRecord8(value) {
+function isRecord9(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
-// src/core/version.ts
-var CLI_VERSION = true ? "0.3.0" : "dev";
-var CLI_USER_AGENT = `@ai-erd/mcp ${CLI_VERSION}`;
-
 // src/adapters/cli/ainectoCli.ts
 async function runAinectoCli(argv, io) {
-  let parsed = { json: argv.includes("--json"), help: false, positionals: [] };
+  let parsed = { json: argv.includes("--json"), help: false, version: false, positionals: [] };
   try {
     parsed = parseGlobalArgs(argv);
+    if (parsed.version || parsed.positionals[0] === "version") {
+      io.stdout.write(renderSuccess({ version: CLI_VERSION }, { json: parsed.json }));
+      return 0;
+    }
     if (parsed.help || parsed.positionals.length === 0) {
       io.stdout.write(helpText());
       return 0;
     }
     const resolved = resolveEndpoint({ env: parsed.env, endpoint: parsed.endpoint });
-    let sessionRole = resolveRole({ role: parsed.role }).role;
-    if (parsed.positionals[0] === "init" && sessionRole === void 0 && !argv.includes("--undo")) {
-      sessionRole = await readRepositoryRole(process.cwd());
-    }
+    const explicitRole = () => resolveRole({ role: parsed.role });
     const tokenStore = new FileTokenStore();
-    const auth = new OAuthClient({ endpoint: resolved.endpoint, tokenStore, role: sessionRole });
-    const client = new McpRpcClient({
-      endpoint: resolved.endpoint,
-      tokenProvider: auth,
-      role: sessionRole
-    });
+    const connect = (role) => {
+      const auth = new OAuthClient({
+        endpoint: resolved.endpoint,
+        tokenStore,
+        // ★init --dry-run 은 토큰을 갱신하지도 않는다 — 「아무것도 바꾸지 않는다」에 로그인 상태도 든다.
+        //   (init 의 플래그는 positional 로 흘러온다.)
+        readOnly: parsed.positionals[0] === "init" && parsed.positionals.includes("--dry-run"),
+        // ★URL 을 «브라우저를 열기 전에» 알린다. stdout 은 결과 전용이라 stderr 에 쓴다.
+        //   --json 이면 JSON 한 줄이다(설계 §21-3 (가)). 로그인이 역할과 무관해져 role 칸은 없다(0.4.2 §2-5).
+        onAuthorizeUrl: (url) => {
+          io.stderr.write(parsed.json ? `${JSON.stringify({ event: "login_url", url })}
+` : `Opening your browser to sign in to AiNecto. If it does not open, visit:
+  ${url}
+`);
+        }
+      });
+      const client2 = new McpRpcClient({ endpoint: resolved.endpoint, tokenProvider: auth, role });
+      return { auth, client: client2 };
+    };
     const [domain, action, ...rest] = parsed.positionals;
     if (domain === "mcp") {
       await runConnector({
         endpoint: resolved.endpoint,
-        // `ai-erd mcp` 로 붙는 경로도 같은 역할을 쓴다 — bin/mcp.ts 와 같은 규칙.
-        role: sessionRole,
+        // 브리지의 역할은 인자·환경변수에서만 온다 — bin/mcp.ts 와 같은 규칙. 저장소를 적용하지 않는다.
+        role: explicitRole().role ?? null,
         input: io.stdin,
         output: io.stdout,
         errorOutput: io.stderr
@@ -3545,22 +4315,69 @@ async function runAinectoCli(argv, io) {
     if (domain === "init") {
       return await executeInitCommand({
         argv: parsed.positionals.slice(1),
-        role: sessionRole,
-        // 문서는 인증 후에 받는다 — 토큰이 없으면 패키지 기본값으로 가고, 그 사실을 보고한다.
-        // ★«필요할 때» 가져온다. --undo 는 로컬 작업이라 토큰을 건드릴 이유가 없다(S1).
-        accessToken: () => auth.getAccessToken().catch(() => void 0),
-        client,
+        role: explicitRole().role,
+        connect: (role) => {
+          const { auth, client: client2 } = connect(role);
+          return {
+            client: client2,
+            // 문서는 인증 후에 받는다 — 토큰이 없으면 패키지 기본값으로 가고, 그 사실을 보고한다.
+            // ★«필요할 때» 가져온다. --undo 는 로컬 작업이라 토큰을 건드릴 이유가 없다(S1) — undo 는
+            //   connect 자체를 부르지 않는다.
+            // ★갱신 실패는 «토큰 없음»(→ 로그인)이지만, AINECTO_TOKEN 을 못 쓰는 주소라는 거절은 삼키지 않는다 —
+            //   삼키면 그 설정 오류가 브라우저 로그인으로 둔갑한다.
+            accessToken: async () => {
+              try {
+                return await auth.getAccessToken();
+              } catch (error) {
+                if (process.env.AINECTO_TOKEN) {
+                  throw error;
+                }
+                return void 0;
+              }
+            },
+            // 로그인한다 — `ainecto auth login` 과 같은 함수다. 서버마다 한 번이다(0.4.2).
+            login: async () => {
+              await auth.login();
+            }
+          };
+        },
+        // ★대화형일 때만 묻는다(판정은 isInteractive 한 곳). 에이전트·CI 는 TTY 가 아니다.
+        prompter: isInteractive(io, parsed.json) ? createReadlinePrompter(io) : void 0,
         endpoint: resolved.endpoint,
         env: resolved.env,
-        cliVersion: `@ai-erd/mcp ${CLI_VERSION}`,
+        cliVersion: `${PACKAGE_NAME} ${CLI_VERSION}`,
         cwd: process.cwd(),
         json: parsed.json,
         io
       });
     }
     if (domain === "auth") {
-      return await handleAuth(action, auth, resolved.endpoint, parsed.json, io);
+      if (parsed.role !== void 0) {
+        io.stderr.write("Sign-in is one per machine; --role is not used by auth.\n");
+      }
+      return await handleAuth(action, connect(null).auth, resolved.endpoint, parsed.json, io);
+    }
+    const env = parsed.env ?? "prod";
+    if (domain === "tools" && action === "catalog") {
+      return await printCatalog(parsed, io, resolved.endpoint, async () => {
+        const explicit2 = explicitRole();
+        return connect(await commandRole(explicit2, process.cwd())).client;
+      });
+    }
+    let routeTools = getGeneratedTools(env);
+    let remote = isAttachmentsUploadCommand(domain, action) || domain === "tools" && (action === "list" || action === "call") || matchGeneratedCommand(routeTools, parsed.positionals) !== void 0;
+    if (!remote) {
+      const live = await loadLiveTools(env, connect(null).client).catch(() => void 0);
+      if (live && matchGeneratedCommand(live, parsed.positionals)) {
+        routeTools = live;
+        remote = true;
+      }
     }
+    if (!remote) {
+      throw new Error(domain === "tools" ? "Expected tools list, tools call <mcpName>, or tools catalog." : `Unknown command "${domain}".`);
+    }
+    const explicit = explicitRole();
+    const { client } = connect(await commandRole(explicit, process.cwd()));
     if (isAttachmentsUploadCommand(domain, action)) {
       return await executeAttachmentsUploadCommand({
         argv: rest,
@@ -3570,7 +4387,7 @@ async function runAinectoCli(argv, io) {
       });
     }
     const generatedResult = await executeGeneratedCommand({
-      env: parsed.env ?? "prod",
+      tools: routeTools,
       argv: parsed.positionals,
       client,
       json: parsed.json,
@@ -3588,15 +4405,32 @@ async function runAinectoCli(argv, io) {
     return 1;
   }
 }
+async function commandRole(explicit, cwd) {
+  const explicitRole = explicit.role ?? null;
+  const found = await findRepositoryRole(cwd);
+  if (found.kind === "conflict") {
+    throw new Error(await askTheUserToFixRole(found.dir, found.reason));
+  }
+  if (found.kind === "none") {
+    return explicitRole;
+  }
+  if (explicitRole !== null && explicitRole !== found.role) {
+    const given = explicit.source === "env" ? `${explicit.envVar}=${explicitRole}` : `--role ${explicitRole}`;
+    throw new Error(
+      `This repository's AI sessions have the role ${found.role} (set in ${found.dir}). ${given} does not match \u2014 the role changes only with \`ainecto init --role <role>\`, after asking the user.`
+    );
+  }
+  return found.role;
+}
 async function handleAuth(action, auth, endpoint, json, io) {
   if (action === "login") {
     await auth.login();
-    io.stdout.write(renderSuccess({ endpoint, authenticated: true }, { json }));
+    io.stdout.write(renderSuccess({ ...await nextStep(), endpoint, authenticated: true }, { json }));
     return 0;
   }
   if (action === "status") {
     const token = await auth.getAccessToken();
-    io.stdout.write(renderSuccess({ endpoint, authenticated: Boolean(token) }, { json }));
+    io.stdout.write(renderSuccess({ ...await nextStep(), endpoint, authenticated: Boolean(token) }, { json }));
     return 0;
   }
   if (action === "logout") {
@@ -3606,6 +4440,20 @@ async function handleAuth(action, auth, endpoint, json, io) {
   }
   throw new Error("Expected auth login, auth status, or auth logout.");
 }
+async function printCatalog(parsed, io, endpoint, liveClient) {
+  const catalogEnv = parsed.env ?? "prod";
+  try {
+    const tools = await loadLiveTools(catalogEnv, await liveClient());
+    io.stdout.write(renderSuccess(tools, { json: parsed.json }));
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    io.stdout.write(renderSuccess(getGeneratedTools(catalogEnv), {
+      json: parsed.json,
+      warnings: [`Could not read the live tool list from ${endpoint} (${reason}). Showing the ${catalogEnv} catalog checked in when this CLI version was built \u2014 a snapshot of that server's tools/list that may miss newer document types and tools. Run \`ainecto auth login\`, then retry.`]
+    }));
+  }
+  return 0;
+}
 async function handleTools(action, rest, parsed, client, io) {
   if (action === "list") {
     const tools = await client.toolsList();
@@ -3628,18 +4476,10 @@ async function handleTools(action, rest, parsed, client, io) {
     io.stdout.write(renderSuccess(result, { json: parsed.json, warnings: payload.warnings }));
     return isToolError(result) ? 1 : 0;
   }
-  if (action === "catalog") {
-    const catalogEnv = parsed.env ?? "prod";
-    io.stdout.write(renderSuccess(getGeneratedTools(parsed.env ?? "prod"), {
-      json: parsed.json,
-      warnings: [catalogEnv === "dev" ? "Local dev catalog is a checked-in live sync snapshot; rerun sync:tools --env dev to refresh it." : "Local prod catalog is seed fixture only until authenticated prod live sync updates generated catalogs."]
-    }));
-    return 0;
-  }
   throw new Error("Expected tools list, tools call <mcpName>, or tools catalog.");
 }
 function parseGlobalArgs(argv) {
-  const result = { json: false, help: false, positionals: [] };
+  const result = { json: false, help: false, version: false, positionals: [] };
   for (let index = 0; index < argv.length; index += 1) {
     const arg = argv[index];
     if (!arg) {
@@ -3655,6 +4495,8 @@ function parseGlobalArgs(argv) {
       result.json = true;
     } else if (arg === "--help" || arg === "-h") {
       result.help = true;
+    } else if (arg === "--version" || arg === "-v" || arg === "-V") {
+      result.version = true;
     } else {
       result.positionals.push(arg);
     }
@@ -3686,13 +4528,25 @@ function requireValue4(flag, value) {
   }
   return value;
 }
+async function nextStep() {
+  const found = await findRepositoryRole(process.cwd());
+  return found.kind === "none" ? { setup: "incomplete", next: NEXT_STEP_INIT } : {};
+}
+var NEXT_STEP_INIT = [
+  "AiNecto setup is not finished until `npx -y ainecto@latest init` runs in the repository.",
+  "AI agents: tell the user this now, even if they only asked to install, update, or sign in. Then ask",
+  "which role this repository's AI sessions should have \u2014 Design, Development, Test, or Validation \u2014",
+  "never pick one yourself, and run `npx -y ainecto@latest init --role <role>` from the repository root.",
+  "In a terminal: `npx -y ainecto@latest init` asks for the role and the project."
+].join("\n");
 function helpText() {
   return [
-    "Ainecto CLI",
+    "AiNecto CLI",
+    "",
+    NEXT_STEP_INIT,
     "",
     "Usage:",
-    "  ainecto auth login --role <design|development|test|validation> [--env prod|dev] [--json]",
-    "  ainecto auth status|logout [--role <role>] [--env prod|dev] [--json]",
+    "  ainecto auth login|status|logout [--env prod|dev] [--json]   (one sign-in per machine)",
     "  ainecto tools list [--env prod|dev] [--endpoint URL] [--json]",
     "  ainecto tools call <mcpName> [-f payload.json|@-] [inline-json] [--json]",
     "  ainecto attachments upload --document-uuid <uuid> <file...> [--json]",
@@ -3700,8 +4554,11 @@ function helpText() {
     "  ainecto mcp [--env prod|dev] [--endpoint URL] [--role design|development|test|validation]",
     "",
     "Harness:",
-    "  ai-erd init --role <design|development|test|validation> [--project <uuid>] [--dry-run]",
-    "  ai-erd init --undo",
+    "  ainecto init [--role <design|development|test|validation>] [--project <uuid>] [--dry-run]",
+    "      In a terminal, asks for the role and project when they are not given.",
+    "  ainecto init --undo",
+    "",
+    "`ai-erd` (the older name) is the same command and still works.",
     ""
   ].join("\n");
 }