@ainecto/mcp 0.3.0 → 0.6.0

package/dist/bin/ainecto.js

@@ -5,23 +5,52 @@ 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 = "ainecto:role:";
+var ROLE_HEADER = "X-AiNecto-Role";
+var ROLE_ENV_VAR = "AINECTO_ROLE";
+function resolveRole(input = {}) {
+  if (input.role !== void 0) {
+    return { role: assertRole(input.role), source: "flag" };
+  }
+  const envVars = input.envVars ?? process.env;
+  const fromEnv = envVars[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/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 +85,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 +120,9 @@ import { URLSearchParams } from "url";
 
 // src/core/config/endpoints.ts
 var DEFAULT_ENDPOINTS = {
-  prod: "https://ai-erd.com/mcp",
-  dev: "https://dev.ai-erd.com/mcp"
+  prod: "https://ainecto.com/mcp",
+  dev: "https://dev.ainecto.com/mcp"
 };
-var LEGACY_DEFAULT_ENDPOINTS = [
-  "https://ainecto.com/mcp",
-  "https://dev.ainecto.com/mcp"
-];
 function resolveEndpoint(input = {}) {
   const envVars = input.envVars ?? process.env;
   const env = input.env ?? "prod";
@@ -114,7 +145,7 @@ function isDefaultEndpointFor(env, endpoint) {
 }
 function isDefaultEndpoint(endpoint) {
   const normalized = normalizeEndpoint(endpoint);
-  return Object.values(DEFAULT_ENDPOINTS).includes(normalized) || LEGACY_DEFAULT_ENDPOINTS.includes(normalized);
+  return Object.values(DEFAULT_ENDPOINTS).includes(normalized);
 }
 function assertTrustedEndpointUrl(value, label = "URL") {
   const url = typeof value === "string" ? new URL(value) : value;
@@ -154,7 +185,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 +208,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 +235,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.options.tokenStore.load(this.options.endpoint);
     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.options.tokenStore.load(this.options.endpoint);
+    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 +272,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 +290,17 @@ 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();
     }
   }
   async logout() {
-    await this.options.tokenStore.delete(this.options.endpoint, this.options.role);
+    await this.options.tokenStore.delete(this.options.endpoint);
   }
+  /** 부르는 쪽이 refresh token 이 있음을 이미 확인했다 — 타입이 그것을 요구한다. */
   async refreshStoredToken(stored) {
-    if (!stored.refreshToken) {
-      return stored.accessToken;
-    }
     const metadata = await discoverOAuthMetadata(this.options.endpoint, this.fetchImpl);
     const token = await exchangeToken(metadata.tokenEndpoint, {
       grant_type: "refresh_token",
@@ -289,7 +310,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 +322,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 +435,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 +450,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 +467,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 +484,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 +511,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 +614,11 @@ async function readAllStdin(stdin) {
   return text;
 }
 
+// src/core/version.ts
+var CLI_VERSION = true ? "0.6.0" : "dev";
+var PACKAGE_NAME = "@ainecto/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 +641,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 +816,73 @@ 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_comments", "commandPath": ["comments", "create"], "group": "generic", "description": "Add comments, questions, or replies to a document. Anyone who can read the document may comment and reply. Set parentCommentId to reply to a top-level comment. To mention people, get their userId and displayName from list_mention_candidates, write @<displayName> in the body, and list their userIds in mentionUserIds (clientMutationId is then required). Items are applied in order and each one commits on its own; results report each item (ok, or status and error).", "inputSchema": { "additionalProperties": false, "properties": { "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" }, "items": { "description": "Comments to add, applied in order", "items": { "additionalProperties": false, "properties": { "body": { "description": "Comment text (plain text, 1..10000 characters). To mention someone, include @<displayName> exactly as returned by mcp__ainecto__list_mention_candidates.", "maxLength": 1e4, "minLength": 1, "type": "string" }, "clientMutationId": { "description": "Idempotency key (visible ASCII, at most 128 characters). Required when mentionUserIds is not empty; reuse the same value when retrying the same item so the mention email is not sent twice.", "maxLength": 128, "type": "string" }, "kind": { "description": "Top-level comments only: COMMENT (default) or QUESTION. A QUESTION can later be resolved with mcp__ainecto__resolve_comments.", "enum": ["COMMENT", "QUESTION"], "type": "string" }, "mentionUserIds": { "description": "userIds to mention (from mcp__ainecto__list_mention_candidates). Each one's @<displayName> must appear in body; newly mentioned people get a notification email.", "items": { "type": "string" }, "maxItems": 20, "type": "array", "uniqueItems": true }, "parentCommentId": { "description": "Reply to this top-level comment id (from mcp__ainecto__list_comments). Replies are one level deep: replying to a reply is rejected.", "minimum": 1, "type": "integer" } }, "required": ["body"], "type": "object" }, "minItems": 1, "type": "array" }, "mailLanguage": { "description": "Language of the mention notification email. Defaults to en.", "enum": ["en", "ko"], "type": "string" } }, "required": ["documentUuid", "items"], "type": "object" }, "required": ["documentUuid", "items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "a673b909d16835ef" },
+  { "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, file.", "enum": ["erd", "markdown", "diagram", "openapi", "html", "file"], "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); file: no JSON payload \u2014 bytes go through request_upload_token(purpose=document.create, scopeJson={projectUuid,folderUuid?,type:"file",title,filename}) then one curl PUT (images\xB7PDF\xB7mp4/webm\xB7audio\xB7text/code\xB7CSV only).', "type": "object" } }, "required": ["projectUuid", "type", "title"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "aa868b0e2821006a" },
+  { "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_comments", "commandPath": ["comments", "delete"], "group": "generic", "description": "Delete your own comments on a document. Only the author can delete. A resolved question and a top-level comment that still has replies cannot be deleted. Each id is applied on its own; results report each id.", "inputSchema": { "additionalProperties": false, "properties": { "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" }, "ids": { "description": "Comment ids to delete (from mcp__ainecto__list_comments)", "items": { "minimum": 1, "type": "integer" }, "minItems": 1, "type": "array" } }, "required": ["documentUuid", "ids"], "type": "object" }, "required": ["documentUuid", "ids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "17b9658b5a47f866" },
+  { "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": "Omit (null) for a plain node-to-node edge. Set only when a group is an endpoint: GROUP_TO_GROUP|NODE_TO_GROUP|GROUP_TO_NODE", "enum": ["GROUP_TO_GROUP", "NODE_TO_GROUP", "GROUP_TO_NODE"], "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": "2c829103f86f4168" },
+  { "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); file \u2192 file {filename, contentType, sizeBytes, viewerKind} + content for text/CSV (first 64 KB); 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": "2efef592c2d6dd7a" },
+  { "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_comments", "commandPath": ["comments", "list"], "group": "generic", "description": "List the active comments on a document, oldest first, including replies (a reply has parentCommentId set; replies are one level deep). Each comment has id, kind (COMMENT or QUESTION), body, author, mentions (userId, label and position in the body), and for questions questionState (UNANSWERED, ANSWERED, RESOLVED) and resolvedAt. Anyone who can read the document can list its comments.", "inputSchema": { "additionalProperties": false, "properties": { "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4c60115a00f61404" },
+  { "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, file.", "enum": ["erd", "markdown", "diagram", "openapi", "html", "file"], "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "2171496b44dc2abf" },
+  { "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_mention_candidates", "commandPath": ["mention-candidates", "list"], "group": "generic", "description": "List the people you can mention in comments on a document: userId and displayName. Only people who can read the document are listed. To mention someone, write @<displayName> exactly in the comment body and pass their userId in mentionUserIds of create_comments or update_comments. Page with nextCursor while hasMore is true.", "inputSchema": { "additionalProperties": false, "properties": { "cursor": { "description": "nextCursor from the previous page (same documentUuid and query).", "type": "string" }, "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" }, "limit": { "description": "Page size, 1..50. Defaults to 20.", "maximum": 50, "minimum": 1, "type": "integer" }, "query": { "description": "Name filter, 0..100 characters. Omit or leave empty for the first page of everyone.", "maxLength": 100, "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "896a5a6ff357268b" },
+  { "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, file. document.update/document.append \uB294 documentUuid \uB97C \uD3EC\uD568. type=file \uC740 filename \uB3C4 \uD3EC\uD568(\uD655\uC7A5\uC790\uB85C \uD615\uC2DD \uD310\uC815) \u2014 PUT \uC758 Content-Type \uC740 \uD30C\uC77C MIME, \uBCF8\uBB38\uC740 \uD30C\uC77C \uBC14\uC774\uD2B8. attachment.upload: {documentUuid, filename}; storageKey \uB294 \uC11C\uBC84\uAC00 \uBC1C\uAE09 scope \uC5D0 \uB123\uB294\uB2E4.", "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": "fe1984b3979abf86" },
+  { "mcpName": "resolve_comments", "commandPath": ["tools", "run", "resolve-comments"], "group": "generic", "description": "Mark questions on a document as resolved. Only top-level comments with kind QUESTION can be resolved, and it needs edit access to the document (readers can comment but cannot resolve). Resolving cannot be undone. Each id is applied on its own; results report each id.", "inputSchema": { "additionalProperties": false, "properties": { "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" }, "ids": { "description": "Question ids to resolve (top-level comments with kind QUESTION)", "items": { "minimum": 1, "type": "integer" }, "minItems": 1, "type": "array" } }, "required": ["documentUuid", "ids"], "type": "object" }, "required": ["documentUuid", "ids"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "7b32b72b3a0d64ba" },
+  { "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, file.", "enum": ["erd", "markdown", "diagram", "openapi", "html", "file"], "type": "string" } }, "required": ["q"], "type": "object" }, "required": ["q"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "e82abba1358754e8" },
+  { "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_comments", "commandPath": ["comments", "update"], "group": "generic", "description": "Edit your own comments on a document. Only the author can edit, and only while they can still read the document. A resolved question and a top-level comment that already has replies are locked. Items are applied in order and each one commits on its own; results report each item.", "inputSchema": { "additionalProperties": false, "properties": { "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" }, "items": { "description": "Edits, applied in order", "items": { "additionalProperties": false, "properties": { "body": { "description": "New comment text (replaces the old text).", "maxLength": 1e4, "minLength": 1, "type": "string" }, "clientMutationId": { "description": "Idempotency key (visible ASCII, at most 128 characters). Required when mentionUserIds is not empty; reuse the same value when retrying the same item so the mention email is not sent twice.", "maxLength": 128, "type": "string" }, "id": { "description": "Comment id (from mcp__ainecto__list_comments)", "minimum": 1, "type": "integer" }, "mentionUserIds": { "description": "The complete set of userIds mentioned after the edit; omit to remove all mentions. Each one's @<displayName> must appear in body. Only people who were not mentioned before get a notification email.", "items": { "type": "string" }, "maxItems": 20, "type": "array", "uniqueItems": true } }, "required": ["id", "body"], "type": "object" }, "minItems": 1, "type": "array" }, "mailLanguage": { "description": "Language of the mention notification email. Defaults to en.", "enum": ["en", "ko"], "type": "string" } }, "required": ["documentUuid", "items"], "type": "object" }, "required": ["documentUuid", "items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "fa37fedfdebd8d54" },
+  { "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); file: {file:{filename,contentType,sizeBytes,viewerKind}} (+content for text/CSV, first 64 KB).", "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": "c2088f9ef5b49c6c" },
+  { "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 +975,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 +1145,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 +1155,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 +1178,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 +1265,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 +1282,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 +1310,7 @@ function formatCell(value) {
   }
   return String(value);
 }
-function isRecord4(value) {
+function isRecord5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -1124,7 +1363,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 +1467,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 +1487,7 @@ function requireValue(flag, value) {
   }
   return value;
 }
-function isRecord5(value) {
+function isRecord6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -1290,9 +1529,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 +1546,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 +1709,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 +1779,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 +1812,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 +1857,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 +1982,12 @@ 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 AGENT_TARGETS = [
   { id: "claude-code", label: "Claude Code", path: ".mcp.json" },
   { id: "cursor", label: "Cursor", path: ".cursor/mcp.json" }
@@ -1765,7 +2003,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,11 +2016,26 @@ function readServerEntry(existing) {
   }
   try {
     const parsed = JSON.parse(existing);
-    return parsed?.mcpServers?.[SERVER_NAME];
+    const servers = parsed?.mcpServers;
+    return isRecord8(servers) ? servers[SERVER_NAME] : void 0;
   } catch {
     return void 0;
   }
 }
+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) => arg === PACKAGE_NAME || arg.startsWith(`${PACKAGE_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"];
 function mergeServerEntry(existing, entry) {
   const root = parseConfigObject(existing);
   const servers = readServers(root);
@@ -1802,7 +2055,9 @@ function removeServerEntry(existing, restore) {
     servers[SERVER_NAME] = restore.value;
     return { content: stringify({ ...root, mcpServers: servers }), removed, emptied: false };
   }
-  delete servers[SERVER_NAME];
+  if (removed) {
+    delete servers[SERVER_NAME];
+  }
   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 +2087,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 +2106,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 +2115,18 @@ 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 MARKERS = { begin: MARKER_BEGIN, end: MARKER_END };
+var HARNESS_DIR = ".ainecto";
+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,
@@ -1897,9 +2154,9 @@ function documentContractProblem(key, 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 +2165,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 +2196,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,10 +2207,10 @@ 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, {
@@ -1960,15 +2219,15 @@ function renderAgentNote(template) {
   });
 }
 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 +2279,47 @@ 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 hit2 = ownedMarker(content, kind, 0); hit2 !== void 0; hit2 = ownedMarker(content, kind, hit2.at + 1)) {
     count += 1;
   }
   return count;
 }
+function ownedMarker(content, kind, from) {
+  return hit(ownedMarkerIndex(content, MARKERS[kind], from), MARKERS[kind]);
+}
+function anyMarker(content, kind, from) {
+  return hit(content.indexOf(MARKERS[kind], from), MARKERS[kind]);
+}
+function hit(at, marker) {
+  return at >= 0 ? { at, length: marker.length } : void 0;
+}
 function isInsideFencedBlock(content, index) {
   let open;
   let offset = 0;
@@ -2116,24 +2384,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 +2418,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,7 +2448,7 @@ function ownedMarkerIndex(content, marker, from) {
 }
 
 // src/core/harness/initRecord.ts
-var RECORD_KIND = "ai-erd/init-record";
+var RECORD_KIND = "ainecto/init-record";
 var RECORD_VERSION = 2;
 var ABSENT = { at: "absent" };
 function emptyRecord() {
@@ -2202,7 +2470,7 @@ function readRecord(content) {
   if (parsed.kind !== 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_PATH} exists but is not an AiNecto init record (kind=${JSON.stringify(parsed.kind)})`
     };
   }
   if (parsed.version !== RECORD_VERSION) {
@@ -2239,46 +2507,6 @@ function readRecord(content) {
     }
   };
 }
-var LEGACY_MANAGED_KEYS = [
-  "created",
-  "originals",
-  "lastWritten",
-  "lastWrittenFragment",
-  "lastWrittenBody",
-  "replacedEntries",
-  "replacedBlocks",
-  "blockAdded",
-  "foreignMarkers"
-];
-function legacyManagedRecord(configContent) {
-  if (configContent === void 0) {
-    return false;
-  }
-  let parsed;
-  try {
-    parsed = JSON.parse(configContent);
-  } catch {
-    return false;
-  }
-  if (!isObject(parsed) || !isObject(parsed.managed)) {
-    return false;
-  }
-  const managed = parsed.managed;
-  const hasLegacyShape = LEGACY_MANAGED_KEYS.some(
-    (key) => Object.prototype.hasOwnProperty.call(managed, key)
-  );
-  if (!hasLegacyShape) {
-    return false;
-  }
-  if (typeof parsed.generatedBy === "string") {
-    return true;
-  }
-  const lastWritten = managed.lastWritten;
-  return isObject(lastWritten) && Object.prototype.hasOwnProperty.call(lastWritten, HARNESS_CONFIG_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.`;
-}
 function serializeRecord(record) {
   return `${JSON.stringify({
     kind: RECORD_KIND,
@@ -2297,7 +2525,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 +2533,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 +2618,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 +2646,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 +2664,176 @@ 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) ? { kind: "problem", reason: `${path} is not valid JSON` } : { kind: "absent" };
+  }
+  const entry = servers[SERVER_NAME];
+  if (!isOurBridge(entry)) {
+    return { kind: "absent" };
+  }
+  const role = readRoleFromEntry(entry);
+  if (role === void 0) {
+    return { kind: "problem", reason: `${path} has the "${SERVER_NAME}" bridge without a valid --role` };
+  }
+  return { kind: "role", role };
+}
+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 +2861,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 +2875,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);
   }
@@ -2513,9 +2910,6 @@ function initRefusal(files, previous) {
   if (state.state === "corrupt" || state.state === "legacy") {
     return `${state.reason}. Nothing was changed \u2014 move that file aside (or restore it) and run again.`;
   }
-  if (state.state === "absent" && legacyManagedRecord(files.get(HARNESS_CONFIG_PATH))) {
-    return legacyManagedNotice(HARNESS_CONFIG_PATH);
-  }
   const carried = state.state === "valid" ? state.record : emptyRecord();
   for (const [path, contract] of Object.entries(carried.files)) {
     if (contract.scope !== "fields") {
@@ -2558,7 +2952,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 +2963,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 +3019,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 +3029,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 +3066,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 });
@@ -2725,7 +3119,7 @@ function planUndo(input) {
     notes.push(`If you set ${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.`);
+    notes.push(`No record of a previous init in ${HARNESS_RECORD_PATH} \u2014 no local file was changed.`);
     tail();
     return { writes, deletes, codexCommand: codexRemoveCommand(), notes };
   }
@@ -2810,7 +3204,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 +3234,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 +3249,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 +3266,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 +3275,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 +3305,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 +3327,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 +3340,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 +3355,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 +3375,9 @@ 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) {
-      continue;
-    }
-    found.set(target.path, previousRole(existing));
-  }
-  return found;
-}
-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 previousRole(path, existing) {
+  const read = readConfigRole(path, existing);
+  return read.kind === "role" ? read.role : void 0;
 }
 
 // src/core/harness/documentFetch.ts
@@ -3057,10 +3433,97 @@ 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 root = resolve2(options.cwd);
+  const rootNotes = await repositoryRootNotes(root);
   const files = await readSnapshot(root);
   if (args.undo) {
     const plan2 = planUndo({ files });
@@ -3070,23 +3533,34 @@ async function executeInitCommand(options) {
         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);
-  if (!role) {
-    throw new Error(
-      `--role is required on first run. Pick one of: ${HARNESS_ROLES.join(", ")}.`
-    );
-  }
   const refusal = initRefusal(files);
   if (refusal !== void 0) {
     throw new Error(refusal);
   }
-  const project = await resolveProject(options, args, files, root);
+  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(
+      `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 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,7 +3574,8 @@ async function executeInitCommand(options) {
   const documents = args.dryRun ? { versions: {}, fallbacks: {}, unavailableReason: "skipped in --dry-run" } : await fetchHarnessDocuments({
     endpoint: options.endpoint,
     accessToken: await options.accessToken?.(),
-    client: "ai-erd-cli",
+    // 서버가 문서의 클라이언트별 변형 키를 이 이름으로 찾는다.
+    client: "ainecto-cli",
     fetchImpl: options.fetchImpl
   });
   const plan = planInit({
@@ -3117,6 +3592,10 @@ async function executeInitCommand(options) {
     throw new Error(plan.refusal);
   }
   await applyPlan(root, plan, args.dryRun, files);
+  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",
@@ -3130,36 +3609,34 @@ async function executeInitCommand(options) {
       // ⚠조용히 기본값으로 떨어지지 않는다 — 서버에서 규칙을 고쳐도 안 바뀌는 이유를
       //   사용자가 영영 못 찾게 된다. ★요청 자체의 실패와 «문서별» 되돌림을 둘 다 적는다
       //   (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\`).`,
+        "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 +3651,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 +3765,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 +3791,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 +3813,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 +3832,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
@@ -3290,47 +3865,6 @@ async function readSnapshot(root) {
   }
   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 +3879,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;
+    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 +3917,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 +3940,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 +3952,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 +3960,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 +3978,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 +3995,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 +4033,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 +4089,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 +4161,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 +4179,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" ? `${ROLE_ENV_VAR}=${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 +4214,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 +4250,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 +4269,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 +4302,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 +4328,9 @@ 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",
     ""
   ].join("\n");
 }