@ainecto/mcp 0.2.0 → 0.5.0

package/dist/bin/ainecto.js

@@ -5,6 +5,37 @@ import { createHash } from "crypto";
 import { mkdir, readFile, rename, rm, stat, writeFile, chmod } from "fs/promises";
 import { homedir } from "os";
 import { dirname, join } from "path";
+
+// src/core/harness/role.ts
+var HARNESS_ROLES = ["design", "development", "test", "validation"];
+var ROLE_SCOPE_PREFIX = "ai-erd:role:";
+var ROLE_HEADER = "X-AI-ERD-Role";
+var ROLE_ENV_VAR = "AINECTO_ROLE";
+var LEGACY_ROLE_ENV_VAR = "AI_ERD_ROLE";
+function resolveRole(input = {}) {
+  if (input.role !== void 0) {
+    return { role: assertRole(input.role), source: "flag" };
+  }
+  const envVars = input.envVars ?? process.env;
+  for (const envVar of [ROLE_ENV_VAR, LEGACY_ROLE_ENV_VAR]) {
+    const fromEnv = envVars[envVar];
+    if (fromEnv && fromEnv.trim()) {
+      return { role: assertRole(fromEnv), source: "env", envVar };
+    }
+  }
+  return { source: "none" };
+}
+function assertRole(value) {
+  const normalized = value.trim().toLowerCase();
+  if (HARNESS_ROLES.includes(normalized)) {
+    return normalized;
+  }
+  throw new Error(
+    `Invalid role "${value}". Expected one of: ${HARNESS_ROLES.join(", ")}.`
+  );
+}
+
+// src/core/auth/tokenStore.ts
 var FileTokenStore = class {
   filePath;
   constructor(rootDir = join(homedir(), ".ainecto")) {
@@ -15,6 +46,7 @@ var FileTokenStore = class {
     return file[tokenKey(endpoint)];
   }
   async save(endpoint, token) {
+    assertNoRoleScope(token);
     const file = await this.readFile();
     file[tokenKey(endpoint)] = { ...token, endpoint, updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
     await this.writeFile(file);
@@ -59,6 +91,13 @@ var FileTokenStore = class {
 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;
 }
@@ -84,13 +123,20 @@ import { URLSearchParams } from "url";
 
 // src/core/config/endpoints.ts
 var DEFAULT_ENDPOINTS = {
-  prod: "https://ai-erd.com/mcp",
+  prod: "https://ainecto.com/mcp",
   dev: "https://dev.ai-erd.com/mcp"
 };
+var LEGACY_PROD_ENDPOINT = "https://ai-erd.com/mcp";
 var LEGACY_DEFAULT_ENDPOINTS = [
-  "https://ainecto.com/mcp",
+  LEGACY_PROD_ENDPOINT,
   "https://dev.ainecto.com/mcp"
 ];
+var TOKEN_SLOT_FALLBACKS = {
+  [DEFAULT_ENDPOINTS.prod]: [LEGACY_PROD_ENDPOINT]
+};
+function fallbackTokenEndpointsFor(endpoint) {
+  return TOKEN_SLOT_FALLBACKS[normalizeEndpoint(endpoint)] ?? [];
+}
 function resolveEndpoint(input = {}) {
   const envVars = input.envVars ?? process.env;
   const env = input.env ?? "prod";
@@ -108,6 +154,9 @@ function normalizeEndpoint(endpoint) {
   url.hash = "";
   return url.toString().replace(/\/$/, "");
 }
+function isDefaultEndpointFor(env, endpoint) {
+  return normalizeEndpoint(endpoint) === DEFAULT_ENDPOINTS[env];
+}
 function isDefaultEndpoint(endpoint) {
   const normalized = normalizeEndpoint(endpoint);
   return Object.values(DEFAULT_ENDPOINTS).includes(normalized) || LEGACY_DEFAULT_ENDPOINTS.includes(normalized);
@@ -150,7 +199,7 @@ async function registerPublicClient(registrationEndpoint, redirectUri, fetchImpl
     method: "POST",
     headers: { "content-type": "application/json", accept: "application/json" },
     body: JSON.stringify({
-      client_name: "Ainecto CLI",
+      client_name: "AiNecto CLI",
       redirect_uris: [redirectUri],
       token_endpoint_auth_method: "none",
       grant_types: ["authorization_code", "refresh_token"],
@@ -174,6 +223,15 @@ function isRecord(value) {
 }
 
 // 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;
@@ -191,21 +249,27 @@ var OAuthClient = class {
       assertEnvTokenEndpointAllowed(this.options.endpoint, this.envVars);
       return envToken;
     }
-    const stored = await this.options.tokenStore.load(this.options.endpoint);
+    const stored = await this.loadStored();
     if (!stored) {
       return void 0;
     }
     if (!shouldRefresh(stored)) {
       return stored.accessToken;
     }
-    return this.refreshStoredToken(stored);
+    if (this.options.readOnly) {
+      return isExpired(stored) ? void 0 : stored.accessToken;
+    }
+    if (!stored.refreshToken) {
+      return isExpired(stored) ? void 0 : stored.accessToken;
+    }
+    return this.refreshStoredToken({ ...stored, refreshToken: stored.refreshToken });
   }
   async refreshAfterUnauthorized() {
-    const stored = await this.options.tokenStore.load(this.options.endpoint);
-    if (!stored?.refreshToken) {
+    const stored = await this.loadStored();
+    if (this.options.readOnly || !stored?.refreshToken) {
       return void 0;
     }
-    return this.refreshStoredToken(stored);
+    return this.refreshStoredToken({ ...stored, refreshToken: stored.refreshToken });
   }
   async login() {
     const pkce = generatePkcePair();
@@ -223,8 +287,13 @@ var OAuthClient = class {
       authorizeUrl.searchParams.set("resource", this.options.endpoint);
       authorizeUrl.searchParams.set("state", state);
       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,
@@ -241,13 +310,32 @@ var OAuthClient = class {
       await loopback.close();
     }
   }
+  /**
+   * ★대체로 읽는 옛 칸도 함께 지운다. 새 칸만 지우면 다음 읽기가 곧바로 옛 칸으로 대체돼
+   * «로그아웃했는데 여전히 로그인됨»이 된다. 로그인은 기계당 한 번이므로 옛 CLI 의 칸도 같이 끝난다.
+   */
   async logout() {
     await this.options.tokenStore.delete(this.options.endpoint);
+    for (const fallback of fallbackTokenEndpointsFor(this.options.endpoint)) {
+      await this.options.tokenStore.delete(fallback);
+    }
   }
-  async refreshStoredToken(stored) {
-    if (!stored.refreshToken) {
-      return stored.accessToken;
+  /** 이 주소의 칸, 비었으면 옛 기본 주소의 칸({@link fallbackTokenEndpointsFor}). 쓰기는 늘 이 주소의 칸이다. */
+  async loadStored() {
+    const own = await this.options.tokenStore.load(this.options.endpoint);
+    if (own) {
+      return own;
+    }
+    for (const fallback of fallbackTokenEndpointsFor(this.options.endpoint)) {
+      const stored = await this.options.tokenStore.load(fallback);
+      if (stored) {
+        return stored;
+      }
     }
+    return void 0;
+  }
+  /** 부르는 쪽이 refresh token 이 있음을 이미 확인했다 — 타입이 그것을 요구한다. */
+  async refreshStoredToken(stored) {
     const metadata = await discoverOAuthMetadata(this.options.endpoint, this.fetchImpl);
     const token = await exchangeToken(metadata.tokenEndpoint, {
       grant_type: "refresh_token",
@@ -269,6 +357,27 @@ function generatePkcePair() {
 function generateOAuthState() {
   return randomBytes(32).toString("base64url");
 }
+function isExpired(token, now = Date.now()) {
+  return token.expiresAt !== void 0 && token.expiresAt <= now;
+}
+async function withTimeout(work, timeoutMs) {
+  let timer;
+  const timeout = new Promise((_, reject) => {
+    timer = setTimeout(() => {
+      const minutes = timeoutMs / 6e4;
+      const span = Number.isInteger(minutes) ? `${minutes} minute${minutes === 1 ? "" : "s"}` : `${timeoutMs} ms`;
+      reject(new OAuthLoginError(
+        "LOGIN_TIMEOUT",
+        `Sign-in was not completed within ${span}. Nothing was saved \u2014 run the same command again.`
+      ));
+    }, timeoutMs);
+  });
+  try {
+    return await Promise.race([work, timeout]);
+  } finally {
+    clearTimeout(timer);
+  }
+}
 function shouldRefresh(token, now = Date.now()) {
   if (!token.expiresAt) {
     return false;
@@ -361,11 +470,11 @@ function toStoredToken(endpoint, token, metadata, previous) {
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
 }
-async function createLoopbackReceiver(expectedState) {
+async function createLoopbackReceiver(expectedState, host = "127.0.0.1") {
   let resolveCode;
   let rejectCode;
-  const codePromise = new Promise((resolve, reject) => {
-    resolveCode = resolve;
+  const codePromise = new Promise((resolve3, reject) => {
+    resolveCode = resolve3;
     rejectCode = reject;
   });
   codePromise.catch(() => void 0);
@@ -376,13 +485,13 @@ async function createLoopbackReceiver(expectedState) {
     const state = url.searchParams.get("state");
     if (error) {
       res.writeHead(400, { "content-type": "text/plain" });
-      res.end("Ainecto CLI authorization failed. You can close this tab.");
+      res.end("AiNecto CLI authorization failed. You can close this tab.");
       rejectCode(new Error(`OAuth authorization failed: ${error}`));
       return;
     }
     if (!state || state !== expectedState) {
       res.writeHead(400, { "content-type": "text/plain" });
-      res.end("Ainecto CLI authorization state mismatch. You can close this tab.");
+      res.end("AiNecto CLI authorization state mismatch. You can close this tab.");
       rejectCode(new Error("OAuth state mismatch."));
       return;
     }
@@ -393,10 +502,16 @@ async function createLoopbackReceiver(expectedState) {
       return;
     }
     res.writeHead(200, { "content-type": "text/plain" });
-    res.end("Ainecto CLI authorization complete. You can close this tab.");
+    res.end("AiNecto CLI authorization complete. You can close this tab.");
     resolveCode(code);
   });
-  await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+  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.");
@@ -404,7 +519,10 @@ async function createLoopbackReceiver(expectedState) {
   return {
     redirectUri: `http://127.0.0.1:${address.port}/callback`,
     waitForCode: () => codePromise,
-    close: () => new Promise((resolve, reject) => server.close((error) => error ? reject(error) : resolve()))
+    close: () => new Promise((resolve3, reject) => {
+      server.closeAllConnections?.();
+      server.close((error) => error ? reject(error) : resolve3());
+    })
   };
 }
 function parseStringArray(value) {
@@ -428,10 +546,39 @@ function getBrowserOpenCommand(url, platform = process.platform) {
   }
   return { command: "xdg-open", args: [url] };
 }
-async function openBrowser(url) {
-  const { command, args } = getBrowserOpenCommand(url);
-  const child = spawn(command, args, { stdio: "ignore", detached: true });
-  child.unref();
+function launchBrowser(url, deps = {}) {
+  const platform = deps.platform ?? process.platform;
+  const { command, args } = getBrowserOpenCommand(url, platform);
+  const spawnImpl = deps.spawnImpl ?? spawn;
+  return new Promise((resolve3, reject) => {
+    const unavailable = (reason) => new OAuthLoginError(
+      "BROWSER_UNAVAILABLE",
+      `Could not open a browser on this machine (${command}: ${reason}). Sign-in needs a browser here.`
+    );
+    let child;
+    try {
+      child = spawnImpl(command, args, { stdio: "ignore", detached: true });
+    } catch (error) {
+      reject(unavailable(error instanceof Error ? error.message : String(error)));
+      return;
+    }
+    child.once("error", (error) => reject(unavailable(error.message)));
+    if (platform === "win32") {
+      child.once("spawn", () => resolve3());
+    } else {
+      child.once("exit", (code, signal) => {
+        if (code === 0) {
+          resolve3();
+        } else {
+          reject(unavailable(code === null ? `stopped by ${signal ?? "a signal"}` : `exited with code ${code}`));
+        }
+      });
+    }
+    child.unref();
+  });
+}
+function openBrowser(url) {
+  return launchBrowser(url);
 }
 function assertEnvTokenEndpointAllowed(endpoint, envVars) {
   if (envVars.AINECTO_ALLOW_CUSTOM_ENDPOINT_TOKEN === "1") {
@@ -502,6 +649,12 @@ async function readAllStdin(stdin) {
   return text;
 }
 
+// src/core/version.ts
+var CLI_VERSION = true ? "0.5.0" : "dev";
+var PACKAGE_NAME = "@ainecto/mcp";
+var LEGACY_PACKAGE_NAME = "@ai-erd/mcp";
+var CLI_USER_AGENT = `${PACKAGE_NAME} ${CLI_VERSION}`;
+
 // src/core/mcp/rpcClient.ts
 var McpRpcError = class extends Error {
   constructor(message, code, details) {
@@ -524,7 +677,7 @@ var McpRpcClient = class {
     return this.request("initialize", {
       protocolVersion: "2024-11-05",
       capabilities: {},
-      clientInfo: { name: "@ainecto/mcp", version: "0.1.0" }
+      clientInfo: { name: PACKAGE_NAME, version: CLI_VERSION }
     });
   }
   async toolsList() {
@@ -589,6 +742,9 @@ var McpRpcClient = class {
     if (token) {
       headers.authorization = `Bearer ${token}`;
     }
+    if (this.options.role) {
+      headers[ROLE_HEADER.toLowerCase()] = this.options.role;
+    }
     return this.fetchImpl(this.options.endpoint, {
       method: "POST",
       headers,
@@ -596,6 +752,9 @@ var McpRpcClient = class {
     });
   }
 };
+function isToolError(result) {
+  return isRecord2(result) && result.isError === true;
+}
 function isJsonRpcResponse(value) {
   return isRecord2(value) && value.jsonrpc === "2.0" && ("result" in value || "error" in value);
 }
@@ -693,55 +852,67 @@ function redactSecretString(value) {
 
 // src/core/catalog/generated.prod.ts
 var generatedTools = [
-  { "mcpName": "mcp__ainecto__create_documents", "commandPath": ["documents", "create"], "group": "document", "description": "Create documents. If a document body is tens of KB or more, prefer request_upload_token (purpose=document.create) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Documents", "items": { "properties": { "body": { "description": "Deprecated compatibility alias for typePayload.body when document type is markdown. \uBCF8\uBB38\uC774 \uC218\uC2ED KB \uC774\uC0C1\uC73C\uB85C \uD06C\uBA74 LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.create)` \uB97C \uD638\uCD9C\uD574 uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C \uC9C1\uC811 PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "folderUuid": { "description": "Optional folder UUID", "type": "string" }, "projectUuid": { "description": "Project UUID", "type": "string" }, "title": { "description": "Document title", "type": "string" }, "type": { "description": "Document type. Enabled values: erd, markdown.", "enum": ["erd", "markdown"], "type": "string" }, "typePayload": { "description": "Type-specific payload for enabled document types. markdown: {body}.", "type": "object" } }, "required": ["projectUuid", "type", "title"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4aa976b9bb3b0eb6" },
-  { "mcpName": "mcp__ainecto__create_folders", "commandPath": ["folders", "create"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Folders", "items": { "properties": { "name": { "description": "Folder name", "type": "string" }, "parentFolderUuid": { "description": "Parent folder UUID", "type": "string" }, "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid", "name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "d423d3c265631664" },
-  { "mcpName": "mcp__ainecto__create_projects", "commandPath": ["projects", "create"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Projects", "items": { "properties": { "description": { "description": "Description", "type": "string" }, "name": { "description": "Project name", "type": "string" }, "projectKey": { "description": "Unique project key", "type": "string" }, "workspaceUuid": { "description": "Workspace UUID \u2014 null uses user's default workspace", "type": "string" } }, "required": ["name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "396c80c6cc2ba41a" },
-  { "mcpName": "mcp__ainecto__create_workspaces", "commandPath": ["workspaces", "create"], "group": "workspace", "description": "", "inputSchema": { "properties": { "items": { "description": "Workspaces", "items": { "properties": { "description": { "description": "Description", "type": "string" }, "name": { "description": "Workspace name", "type": "string" } }, "required": ["name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "d663d461f9c9da65" },
-  { "mcpName": "mcp__ainecto__delete_attachments", "commandPath": ["attachments", "delete"], "group": "attachment", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Attachment UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "6e55e6511d732199" },
-  { "mcpName": "mcp__ainecto__delete_documents", "commandPath": ["documents", "delete"], "group": "document", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Document UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "5fbc7c142bb4a49d" },
-  { "mcpName": "mcp__ainecto__delete_folders", "commandPath": ["folders", "delete"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Folder UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "49fa7c0f823871b2" },
-  { "mcpName": "mcp__ainecto__delete_projects", "commandPath": ["projects", "delete"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Project UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "e1a86ddaa9638298" },
-  { "mcpName": "mcp__ainecto__delete_workspaces", "commandPath": ["workspaces", "delete"], "group": "workspace", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Workspace UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "2aca644f7a105b06" },
-  { "mcpName": "mcp__ainecto__disable_shares", "commandPath": ["tools", "run", "disable-shares"], "group": "generic", "description": "", "inputSchema": { "properties": { "targetType": { "description": "Share target type", "enum": ["project", "folder", "document"], "type": "string" }, "targetUuids": { "description": "Target UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["targetType", "targetUuids"], "type": "object" }, "required": ["targetType", "targetUuids"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "a4b4358eff0faa97" },
-  { "mcpName": "mcp__ainecto__enable_shares", "commandPath": ["tools", "run", "enable-shares"], "group": "generic", "description": "", "inputSchema": { "properties": { "targetType": { "description": "Share target type", "enum": ["project", "folder", "document"], "type": "string" }, "targetUuids": { "description": "Target UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["targetType", "targetUuids"], "type": "object" }, "required": ["targetType", "targetUuids"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "ebace643de07e826" },
-  { "mcpName": "mcp__ainecto__erd_apply_changes", "commandPath": ["erd", "apply-changes"], "group": "erd", "description": 'Required single-call mutation path for ERD create/update/delete changes. Put tables, columns, indexes, refs, enums, enum_values, and table groups in one operations array and call this once.\nRules: (1) all data field names are snake_case; (2) for create, generate your own UUIDs and put them in data.uuid, then later operations in the same batch may reference those UUIDs without read-back calls; (3) enum values are separate enum_value operations, not inline on enum; (4) ref.relationship uses short dbdiagram-style symbols: >, <, or -; (5) ref_column operations map FK columns explicitly, never automatically.\nDo not look for type-specific ERD CUD tools; this tool is the only ERD CUD entry point. If operations is very large, use mcp__ainecto__request_upload_token with purpose=mcp.call and send the tools/call payload with curl to save LLM tokens.\nOne-call worked example:\n{\n  "documentUuid": "erd-doc-uuid",\n  "description": "create users/posts ERD",\n  "operations": [\n    {"op":"create","type":"table","data":{"uuid":"tbl_users","name":"users","display_order":1}},\n    {"op":"create","type":"column","data":{"uuid":"col_users_id","table_uuid":"tbl_users","name":"id","type":"bigint","is_pk":true,"is_not_null":true,"display_order":1}},\n    {"op":"create","type":"column","data":{"uuid":"col_users_email","table_uuid":"tbl_users","name":"email","type":"varchar(255)","is_unique":true,"is_not_null":true,"display_order":2}},\n    {"op":"create","type":"table","data":{"uuid":"tbl_posts","name":"posts","display_order":2}},\n    {"op":"create","type":"column","data":{"uuid":"col_posts_id","table_uuid":"tbl_posts","name":"id","type":"bigint","is_pk":true,"is_not_null":true,"display_order":1}},\n    {"op":"create","type":"column","data":{"uuid":"col_posts_author_id","table_uuid":"tbl_posts","name":"author_id","type":"bigint","is_not_null":true,"display_order":2}},\n    {"op":"create","type":"column","data":{"uuid":"col_posts_status","table_uuid":"tbl_posts","name":"status","type":"post_status","is_not_null":true,"display_order":3}},\n    {"op":"create","type":"enum","data":{"uuid":"enum_post_status","name":"post_status"}},\n    {"op":"create","type":"enum_value","data":{"uuid":"enum_post_status_draft","enum_uuid":"enum_post_status","value":"draft","display_order":1}},\n    {"op":"create","type":"enum_value","data":{"uuid":"enum_post_status_published","enum_uuid":"enum_post_status","value":"published","display_order":2}},\n    {"op":"create","type":"ref","data":{"uuid":"ref_posts_author","name":"fk_posts_author","from_table_uuid":"tbl_posts","to_table_uuid":"tbl_users","relationship":">","on_delete":"cascade"}},\n    {"op":"create","type":"ref_column","data":{"uuid":"refcol_posts_author","ref_uuid":"ref_posts_author","from_column_uuid":"col_posts_author_id","to_column_uuid":"col_users_id","display_order":1}}\n  ]\n}', "inputSchema": { "properties": { "arrangeNewTables": { "description": "Whether to auto-place newly-created tables after the batch; defaults to true", "type": "boolean" }, "description": { "description": "Reason for batch (audit)", "type": "string" }, "documentUuid": { "description": "ERD document UUID", "type": "string" }, "operations": { "description": "Atomic create/update/delete operations", "items": { "description": "One ERD mutation. Use a single operations array with client-generated data.uuid values to create cross-referenced tables, columns, enums, refs, and ref_columns without read-back calls.", "discriminator": { "propertyName": "type" }, "oneOf": [{ "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='table'.", "properties": { "alias": { "description": "Display alias.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "header_color": { "description": "Header color.", "type": "string" }, "name": { "description": "Table name. Required for create.", "type": "string" }, "note": { "description": "Table note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "required": ["name"], "title": "table data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='table'.", "properties": { "alias": { "description": "Display alias.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "header_color": { "description": "Header color.", "type": "string" }, "name": { "description": "Table name. Required for create.", "type": "string" }, "note": { "description": "Table note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "table", "description": "Must be 'table' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "table operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='column'.", "properties": { "default_value": { "description": "Default value.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "is_increment": { "description": "Auto-increment flag.", "type": "boolean" }, "is_not_null": { "description": "Not-null flag.", "type": "boolean" }, "is_pk": { "description": "Primary key flag.", "type": "boolean" }, "is_unique": { "description": "Unique flag.", "type": "boolean" }, "name": { "description": "Column name.", "type": "string" }, "note": { "description": "Column note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create; may be a data.uuid from an earlier table operation in this batch.", "type": "string" }, "type": { "description": "SQL data type. Use this exact field name; do not send data_type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "required": ["table_uuid"], "title": "column data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='column'.", "properties": { "default_value": { "description": "Default value.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "is_increment": { "description": "Auto-increment flag.", "type": "boolean" }, "is_not_null": { "description": "Not-null flag.", "type": "boolean" }, "is_pk": { "description": "Primary key flag.", "type": "boolean" }, "is_unique": { "description": "Unique flag.", "type": "boolean" }, "name": { "description": "Column name.", "type": "string" }, "note": { "description": "Column note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create; may be a data.uuid from an earlier table operation in this batch.", "type": "string" }, "type": { "description": "SQL data type. Use this exact field name; do not send data_type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "column data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "column", "description": "Must be 'column' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "column operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='index'.", "properties": { "is_pk": { "description": "Primary key index flag.", "type": "boolean" }, "is_unique": { "description": "Unique index flag.", "type": "boolean" }, "name": { "description": "Index name.", "type": "string" }, "note": { "description": "Index note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create.", "type": "string" }, "type": { "description": "Index type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "required": ["table_uuid"], "title": "index data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='index'.", "properties": { "is_pk": { "description": "Primary key index flag.", "type": "boolean" }, "is_unique": { "description": "Unique index flag.", "type": "boolean" }, "name": { "description": "Index name.", "type": "string" }, "note": { "description": "Index note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create.", "type": "string" }, "type": { "description": "Index type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "index data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "index", "description": "Must be 'index' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "index operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='index_column'.", "properties": { "column_uuid": { "description": "Column UUID. Required for create.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "index_uuid": { "description": "Index UUID. Required for create.", "type": "string" }, "sort_order": { "description": "Sort order, for example ASC or DESC.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "required": ["index_uuid", "column_uuid"], "title": "index_column data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='index_column'.", "properties": { "column_uuid": { "description": "Column UUID. Required for create.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "index_uuid": { "description": "Index UUID. Required for create.", "type": "string" }, "sort_order": { "description": "Sort order, for example ASC or DESC.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "index_column data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "index_column", "description": "Must be 'index_column' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "index_column operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='ref'.", "properties": { "from_table_uuid": { "description": "Source table UUID. Required for create.", "type": "string" }, "name": { "description": "Reference name.", "type": "string" }, "on_delete": { "description": "ON DELETE action.", "type": "string" }, "on_update": { "description": "ON UPDATE action.", "type": "string" }, "relationship": { "description": "Required for create. Use short dbdiagram-style relationship symbols.", "enum": [">", "<", "-"], "type": "string" }, "to_table_uuid": { "description": "Target table UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "required": ["from_table_uuid", "to_table_uuid", "relationship"], "title": "ref data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='ref'.", "properties": { "from_table_uuid": { "description": "Source table UUID. Required for create.", "type": "string" }, "name": { "description": "Reference name.", "type": "string" }, "on_delete": { "description": "ON DELETE action.", "type": "string" }, "on_update": { "description": "ON UPDATE action.", "type": "string" }, "relationship": { "description": "Required for create. Use short dbdiagram-style relationship symbols.", "enum": [">", "<", "-"], "type": "string" }, "to_table_uuid": { "description": "Target table UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "ref data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "ref", "description": "Must be 'ref' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "ref operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='ref_column'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "from_column_uuid": { "description": "Source column UUID. Required for create.", "type": "string" }, "ref_uuid": { "description": "Reference UUID. Required for create; may be a data.uuid from an earlier ref operation.", "type": "string" }, "to_column_uuid": { "description": "Target column UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "required": ["ref_uuid", "from_column_uuid", "to_column_uuid"], "title": "ref_column data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='ref_column'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "from_column_uuid": { "description": "Source column UUID. Required for create.", "type": "string" }, "ref_uuid": { "description": "Reference UUID. Required for create; may be a data.uuid from an earlier ref operation.", "type": "string" }, "to_column_uuid": { "description": "Target column UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "ref_column data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "ref_column", "description": "Must be 'ref_column' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "ref_column operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='enum'.", "properties": { "name": { "description": "Enum name.", "type": "string" }, "note": { "description": "Enum note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "enum data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='enum'.", "properties": { "name": { "description": "Enum name.", "type": "string" }, "note": { "description": "Enum note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "enum data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "enum", "description": "Must be 'enum' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "enum operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='enum_value'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "enum_uuid": { "description": "Parent enum UUID. Required for create; may be a data.uuid from an earlier enum operation.", "type": "string" }, "note": { "description": "Enum value note.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" }, "value": { "description": "Enum value. Inline enum values on enum are not persisted; create enum_value operations.", "type": "string" } }, "required": ["enum_uuid"], "title": "enum_value data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='enum_value'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "enum_uuid": { "description": "Parent enum UUID. Required for create; may be a data.uuid from an earlier enum operation.", "type": "string" }, "note": { "description": "Enum value note.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" }, "value": { "description": "Enum value. Inline enum values on enum are not persisted; create enum_value operations.", "type": "string" } }, "title": "enum_value data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "enum_value", "description": "Must be 'enum_value' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "enum_value operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='table_group'.", "properties": { "color": { "description": "Group color.", "type": "string" }, "name": { "description": "Table group name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table_group data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='table_group'.", "properties": { "color": { "description": "Group color.", "type": "string" }, "name": { "description": "Table group name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table_group data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "table_group", "description": "Must be 'table_group' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "table_group operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='table_group_table'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "schema_name": { "description": "Table schema name.", "type": "string" }, "table_name": { "description": "Table name. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "required": ["group_uuid", "table_name"], "title": "table_group_table data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='table_group_table'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "schema_name": { "description": "Table schema name.", "type": "string" }, "table_name": { "description": "Table name. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table_group_table data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "table_group_table", "description": "Must be 'table_group_table' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "table_group_table operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='table_group_note'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "note_uuid": { "description": "Note UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "required": ["group_uuid", "note_uuid"], "title": "table_group_note data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='table_group_note'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "note_uuid": { "description": "Note UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table_group_note data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "table_group_note", "description": "Must be 'table_group_note' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "table_group_note operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='filter'.", "properties": { "included_tables": { "description": "JSON string/list of included tables.", "type": "string" }, "is_default": { "description": "Default filter flag.", "type": "boolean" }, "name": { "description": "Filter name.", "type": "string" }, "table_groups": { "description": "JSON string/object of table groups.", "type": "string" }, "table_positions": { "description": "JSON string/object of table positions.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "filter data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='filter'.", "properties": { "included_tables": { "description": "JSON string/list of included tables.", "type": "string" }, "is_default": { "description": "Default filter flag.", "type": "boolean" }, "name": { "description": "Filter name.", "type": "string" }, "table_groups": { "description": "JSON string/object of table groups.", "type": "string" }, "table_positions": { "description": "JSON string/object of table positions.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "filter data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "filter", "description": "Must be 'filter' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "filter operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='note'.", "properties": { "color": { "description": "Note color.", "type": "string" }, "content": { "description": "Note content.", "type": "string" }, "height": { "description": "Height.", "type": "integer" }, "icon_name": { "description": "Icon name.", "type": "string" }, "position_x": { "description": "X position.", "type": "integer" }, "position_y": { "description": "Y position.", "type": "integer" }, "title": { "description": "Note title.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" }, "width": { "description": "Width.", "type": "integer" } }, "title": "note data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='note'.", "properties": { "color": { "description": "Note color.", "type": "string" }, "content": { "description": "Note content.", "type": "string" }, "height": { "description": "Height.", "type": "integer" }, "icon_name": { "description": "Icon name.", "type": "string" }, "position_x": { "description": "X position.", "type": "integer" }, "position_y": { "description": "Y position.", "type": "integer" }, "title": { "description": "Note title.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" }, "width": { "description": "Width.", "type": "integer" } }, "title": "note data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "note", "description": "Must be 'note' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "note operation", "type": "object" }], "properties": { "data": { "description": "Type-specific payload. All field names are snake_case. For create, data.uuid may be client-supplied and referenced by later operations in the same batch.", "oneOf": [{ "description": "Payload for operation.type='table'.", "properties": { "alias": { "description": "Display alias.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "header_color": { "description": "Header color.", "type": "string" }, "name": { "description": "Table name. Required for create.", "type": "string" }, "note": { "description": "Table note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table data", "type": "object" }, { "description": "Payload for operation.type='column'.", "properties": { "default_value": { "description": "Default value.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "is_increment": { "description": "Auto-increment flag.", "type": "boolean" }, "is_not_null": { "description": "Not-null flag.", "type": "boolean" }, "is_pk": { "description": "Primary key flag.", "type": "boolean" }, "is_unique": { "description": "Unique flag.", "type": "boolean" }, "name": { "description": "Column name.", "type": "string" }, "note": { "description": "Column note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create; may be a data.uuid from an earlier table operation in this batch.", "type": "string" }, "type": { "description": "SQL data type. Use this exact field name; do not send data_type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "column data", "type": "object" }, { "description": "Payload for operation.type='index'.", "properties": { "is_pk": { "description": "Primary key index flag.", "type": "boolean" }, "is_unique": { "description": "Unique index flag.", "type": "boolean" }, "name": { "description": "Index name.", "type": "string" }, "note": { "description": "Index note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create.", "type": "string" }, "type": { "description": "Index type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "index data", "type": "object" }, { "description": "Payload for operation.type='index_column'.", "properties": { "column_uuid": { "description": "Column UUID. Required for create.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "index_uuid": { "description": "Index UUID. Required for create.", "type": "string" }, "sort_order": { "description": "Sort order, for example ASC or DESC.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "index_column data", "type": "object" }, { "description": "Payload for operation.type='ref'.", "properties": { "from_table_uuid": { "description": "Source table UUID. Required for create.", "type": "string" }, "name": { "description": "Reference name.", "type": "string" }, "on_delete": { "description": "ON DELETE action.", "type": "string" }, "on_update": { "description": "ON UPDATE action.", "type": "string" }, "relationship": { "description": "Required for create. Use short dbdiagram-style relationship symbols.", "enum": [">", "<", "-"], "type": "string" }, "to_table_uuid": { "description": "Target table UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "ref data", "type": "object" }, { "description": "Payload for operation.type='ref_column'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "from_column_uuid": { "description": "Source column UUID. Required for create.", "type": "string" }, "ref_uuid": { "description": "Reference UUID. Required for create; may be a data.uuid from an earlier ref operation.", "type": "string" }, "to_column_uuid": { "description": "Target column UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "ref_column data", "type": "object" }, { "description": "Payload for operation.type='enum'.", "properties": { "name": { "description": "Enum name.", "type": "string" }, "note": { "description": "Enum note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "enum data", "type": "object" }, { "description": "Payload for operation.type='enum_value'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "enum_uuid": { "description": "Parent enum UUID. Required for create; may be a data.uuid from an earlier enum operation.", "type": "string" }, "note": { "description": "Enum value note.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" }, "value": { "description": "Enum value. Inline enum values on enum are not persisted; create enum_value operations.", "type": "string" } }, "title": "enum_value data", "type": "object" }, { "description": "Payload for operation.type='table_group'.", "properties": { "color": { "description": "Group color.", "type": "string" }, "name": { "description": "Table group name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table_group data", "type": "object" }, { "description": "Payload for operation.type='table_group_table'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "schema_name": { "description": "Table schema name.", "type": "string" }, "table_name": { "description": "Table name. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table_group_table data", "type": "object" }, { "description": "Payload for operation.type='table_group_note'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "note_uuid": { "description": "Note UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "table_group_note data", "type": "object" }, { "description": "Payload for operation.type='filter'.", "properties": { "included_tables": { "description": "JSON string/list of included tables.", "type": "string" }, "is_default": { "description": "Default filter flag.", "type": "boolean" }, "name": { "description": "Filter name.", "type": "string" }, "table_groups": { "description": "JSON string/object of table groups.", "type": "string" }, "table_positions": { "description": "JSON string/object of table positions.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" } }, "title": "filter data", "type": "object" }, { "description": "Payload for operation.type='note'.", "properties": { "color": { "description": "Note color.", "type": "string" }, "content": { "description": "Note content.", "type": "string" }, "height": { "description": "Height.", "type": "integer" }, "icon_name": { "description": "Icon name.", "type": "string" }, "position_x": { "description": "X position.", "type": "integer" }, "position_y": { "description": "Y position.", "type": "integer" }, "title": { "description": "Note title.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID. If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "type": "string" }, "width": { "description": "Width.", "type": "integer" } }, "title": "note data", "type": "object" }], "type": "object" }, "op": { "description": "Operation. For create, put any new UUID in data.uuid; for update/delete, put target UUID in operation.uuid.", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "description": "ERD entity type. This selects the operation.data shape.", "enum": ["table", "column", "index", "index_column", "ref", "ref_column", "enum", "enum_value", "table_group", "table_group_table", "table_group_note", "filter", "note"], "type": "string" }, "uuid": { "description": "Target UUID for update/delete. Do not use this for create; use data.uuid instead.", "type": "string" } }, "required": ["op", "type"], "type": "object" }, "type": "array" } }, "required": ["documentUuid", "description", "operations"], "type": "object" }, "required": ["description", "documentUuid", "operations"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "dd64d1f996060ab1" },
-  { "mcpName": "mcp__ainecto__erd_arrange_tables", "commandPath": ["erd", "arrange-tables"], "group": "erd", "description": "Arrange ERD tables after edits. Default incremental mode places newly-created tables while preserving existing positions; full=true re-layouts the entire diagram. Use after several separate table edits to tidy the canvas.", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "full": { "description": "Re-layout the ENTIRE diagram (overwrites existing positions). Default false = arrange only newly-added (uncoordinated) tables to the top-right while preserving existing table positions. Call this after creating several tables to tidy them up.", "type": "boolean" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "d2e66548e3d60d30" },
-  { "mcpName": "mcp__ainecto__erd_get_enum", "commandPath": ["erd", "get-enum"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "enumUuid": { "description": "Enum UUID", "type": "string" } }, "required": ["documentUuid", "enumUuid"], "type": "object" }, "required": ["documentUuid", "enumUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "1e477b3fadb50c6b" },
-  { "mcpName": "mcp__ainecto__erd_get_ref", "commandPath": ["erd", "get-ref"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "refUuid": { "description": "Relationship UUID", "type": "string" } }, "required": ["documentUuid", "refUuid"], "type": "object" }, "required": ["documentUuid", "refUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "40bf1eb02e7a9730" },
-  { "mcpName": "mcp__ainecto__erd_get_table", "commandPath": ["erd", "get-table"], "group": "erd", "description": "Get one ERD table with nested columns and indexes. Returns persistent table/column/index UUIDs usable directly as mcp__ainecto__erd_apply_changes update/delete targets and ref_column column references. Column fields use apply_changes snake_case names: uuid, table_uuid, name, type, is_pk, is_unique, is_not_null, is_increment, default_value, note, display_order. Index fields include uuid, name, columns (column UUIDs), is_unique, is_pk, type.", "inputSchema": { "description": "Get one ERD table with nested columns and indexes. Returns persistent table/column/index UUIDs usable directly as mcp__ainecto__erd_apply_changes update/delete targets and ref_column column references. Column fields use apply_changes snake_case names: uuid, table_uuid, name, type, is_pk, is_unique, is_not_null, is_increment, default_value, note, display_order. Index fields include uuid, name, columns (column UUIDs), is_unique, is_pk, type.", "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "tableUuid": { "description": "Table UUID. Response includes columns[] and indexes[] with persistent UUIDs for apply_changes.", "type": "string" } }, "required": ["documentUuid", "tableUuid"], "type": "object" }, "required": ["documentUuid", "tableUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "8edd40794f39f47a" },
-  { "mcpName": "mcp__ainecto__erd_get_table_group", "commandPath": ["erd", "get-table-group"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "tableGroupUuid": { "description": "Table group UUID", "type": "string" } }, "required": ["documentUuid", "tableGroupUuid"], "type": "object" }, "required": ["documentUuid", "tableGroupUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "bcd417344639c0c9" },
-  { "mcpName": "mcp__ainecto__erd_list_enums", "commandPath": ["erd", "list-enums"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "e0c2207905dbb068" },
-  { "mcpName": "mcp__ainecto__erd_list_refs", "commandPath": ["erd", "list-refs"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "9ae2e04c310b57f2" },
-  { "mcpName": "mcp__ainecto__erd_list_table_groups", "commandPath": ["erd", "list-table-groups"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "dc8811071df04ac2" },
-  { "mcpName": "mcp__ainecto__erd_list_tables", "commandPath": ["erd", "list-tables"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "ca05b35b174fc209" },
-  { "mcpName": "mcp__ainecto__get_attachment", "commandPath": ["attachment", "get"], "group": "attachment", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Attachment UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "12bee70f6d254a5d" },
-  { "mcpName": "mcp__ainecto__get_document", "commandPath": ["document", "get"], "group": "document", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4949c8a5bb425491" },
-  { "mcpName": "mcp__ainecto__get_project", "commandPath": ["project", "get"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Project UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "b4ee9097f4b80df4" },
-  { "mcpName": "mcp__ainecto__get_version", "commandPath": ["version", "get"], "group": "generic", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "Document UUID", "type": "string" }, "versionNumber": { "description": "Version number", "type": "integer" } }, "required": ["documentUuid", "versionNumber"], "type": "object" }, "required": ["documentUuid", "versionNumber"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "ad81d04200d3d7f5" },
-  { "mcpName": "mcp__ainecto__get_workspace", "commandPath": ["workspace", "get"], "group": "workspace", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Workspace UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "ef7bae555463116e" },
-  { "mcpName": "mcp__ainecto__list_attachments", "commandPath": ["attachments", "list"], "group": "attachment", "description": "", "inputSchema": { "properties": { "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid"], "type": "object" }, "required": ["projectUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "a75657bb2e5eb383" },
-  { "mcpName": "mcp__ainecto__list_documents", "commandPath": ["documents", "list"], "group": "document", "description": "", "inputSchema": { "properties": { "folderUuid": { "description": "Optional folder UUID", "type": "string" }, "limit": { "description": "Result cap when q is set (default 50)", "type": "integer" }, "projectUuid": { "description": "Project UUID", "type": "string" }, "q": { "description": "Optional full-text query. When provided, results come from the search index instead of folder listing.", "type": "string" }, "type": { "description": "Optional document type filter. Enabled values: erd, markdown.", "enum": ["erd", "markdown"], "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "8dca77c1db9372c4" },
-  { "mcpName": "mcp__ainecto__list_folders", "commandPath": ["folders", "list"], "group": "generic", "description": "", "inputSchema": { "properties": { "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid"], "type": "object" }, "required": ["projectUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "f3cde57fe87d375c" },
-  { "mcpName": "mcp__ainecto__list_projects", "commandPath": ["projects", "list"], "group": "generic", "description": "", "inputSchema": { "properties": { "limit": { "description": "Result cap when q is set (default 50)", "type": "integer" }, "q": { "description": "Optional full-text query", "type": "string" }, "workspaceUuid": { "description": "Optional Workspace UUID", "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "9174d6965d7e53f5" },
-  { "mcpName": "mcp__ainecto__list_trash", "commandPath": ["trash", "list"], "group": "generic", "description": "", "inputSchema": { "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "82f8586d68bfcd7d" },
-  { "mcpName": "mcp__ainecto__list_versions", "commandPath": ["versions", "list"], "group": "generic", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "Document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "370e4b8b8ec18e18" },
-  { "mcpName": "mcp__ainecto__list_workspaces", "commandPath": ["workspaces", "list"], "group": "workspace", "description": "", "inputSchema": { "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "7c32c74000696b2f" },
-  { "mcpName": "mcp__ainecto__markdown_append_document", "commandPath": ["markdown", "append-document"], "group": "markdown", "description": "Append to Markdown documents. If the appended body is tens of KB or more, prefer request_upload_token (purpose=document.append) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Appends", "items": { "properties": { "addition": { "description": "Body addition. \uCD94\uAC00\uD560 \uB0B4\uC6A9\uC774 \uD06C\uBA74 (\uC218\uC2ED KB \uC774\uC0C1) LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.append, scopeJson={documentUuid, separator})` \uB85C uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "separator": { "description": "Separator between existing body and addition", "type": "string" }, "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid", "addition"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "f189514b3cccd1cc" },
-  { "mcpName": "mcp__ainecto__markdown_generate_document", "commandPath": ["markdown", "generate-document"], "group": "markdown", "description": "", "inputSchema": { "properties": { "items": { "description": "Generation requests", "items": { "properties": { "context": { "description": "Optional JSON context", "type": "string" }, "documentUuid": { "description": "Target document UUID", "type": "string" }, "prompt": { "description": "Generation prompt", "type": "string" } }, "required": ["documentUuid", "prompt"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "72114a2d2642ed92" },
-  { "mcpName": "mcp__ainecto__move_documents", "commandPath": ["documents", "move"], "group": "document", "description": "", "inputSchema": { "properties": { "clientMutationId": { "description": "Optional mutation identifier for client retry tracing", "maxLength": 128, "minLength": 1, "pattern": "^[\\x21-\\x7E]{1,128}$", "type": "string" }, "items": { "description": "Moves", "items": { "properties": { "newFolderUuid": { "description": "New folder UUID \u2014 null/empty for root", "type": "string" }, "targetProjectUuid": { "description": "Target project UUID \u2014 omit to stay in current project", "type": "string" }, "targetWorkspaceUuid": { "description": "Guard only: must match targetProjectUuid workspace", "type": "string" }, "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "9758d6a262913a3f" },
-  { "mcpName": "mcp__ainecto__move_folders", "commandPath": ["folders", "move"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Moves", "items": { "properties": { "newParentFolderUuid": { "description": "New parent UUID \u2014 null/empty for root", "type": "string" }, "uuid": { "description": "Folder UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "612a779b1fd176bb" },
-  { "mcpName": "mcp__ainecto__request_upload_token", "commandPath": ["tools", "run", "request-upload-token"], "group": "attachment", "description": "Use this for large payloads of tens of KB or more to save LLM tokens. purpose=mcp.call returns a short-lived bearer token that can call any MCP tool, including mcp__ainecto__erd_apply_changes, via curl. purpose=document.create/update/append uploads document bodies directly to the upload endpoint with PUT/curl. Tokens are reusable for 5 minutes by default.", "inputSchema": { "properties": { "maxBytes": { "description": "\uCD5C\uB300 \uC5C5\uB85C\uB4DC byte (\uC11C\uBC84 \uCE21 \uD55C\uB3C4)", "type": "integer" }, "purpose": { "description": "Token \uC6A9\uB3C4. `mcp.call` \uC740 curl \uB85C /mcp \uD638\uCD9C, `document.create/update/append` \uB294 PUT body \uB85C \uBCF8\uBB38 \uC5C5\uB85C\uB4DC, `attachment.upload` \uB294 \uD30C\uC77C bytes \uC5C5\uB85C\uB4DC. \uCF58\uD150\uCE20\uAC00 \uD06C\uBA74 (\uC218\uC2ED KB \uC774\uC0C1) LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 \uC774 \uB3C4\uAD6C\uB85C 5\uBD84 \uC7AC\uC0AC\uC6A9 \uD1A0\uD070\uC744 \uBC1B\uACE0 curl \uB85C \uBCF4\uB0B4\uB294 \uAC83\uC744 \uAC15\uB825 \uAD8C\uC7A5.", "enum": ["mcp.call", "document.create", "document.update", "document.append", "attachment.upload"], "type": "string" }, "scopeJson": { "description": "\uC120\uD0DD \u2014 JSON scope. document.create \uB294 projectUuid, type, title \uC744 \uD3EC\uD568\uD558\uACE0 enabled type values \uB294 erd, markdown. document.update/document.append \uB294 documentUuid \uB97C \uD3EC\uD568. attachment.upload: {documentUuid, filename, contentType?, sizeBytes?}; storageKey \uB294 \uC11C\uBC84\uAC00 \uBC1C\uAE09 scope \uC5D0 \uCD94\uAC00.", "type": "string" }, "ttlSeconds": { "description": "TTL (\uCD08). \uAE30\uBCF8 300 (5\uBD84)", "type": "integer" } }, "required": ["purpose"], "type": "object" }, "required": ["purpose"], "payloadMode": "binary-upload", "destructive": false, "sourceCatalog": "prod", "schemaHash": "f1eb94523f43e72b" },
-  { "mcpName": "mcp__ainecto__restore_versions", "commandPath": ["versions", "restore"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Restores", "items": { "properties": { "documentUuid": { "description": "Document UUID", "type": "string" }, "versionNumber": { "description": "Version number to restore", "type": "integer" } }, "required": ["documentUuid", "versionNumber"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "c4f448cc3b96c7a6" },
-  { "mcpName": "mcp__ainecto__search_documents", "commandPath": ["documents", "search"], "group": "document", "description": "", "inputSchema": { "properties": { "limit": { "description": "\uACB0\uACFC \uAC1C\uC218 (\uAE30\uBCF8 20, \uCD5C\uB300 50)", "type": "integer" }, "offset": { "description": "\uD398\uC774\uC9C0\uB124\uC774\uC158 offset (\uAE30\uBCF8 0)", "type": "integer" }, "projectUuid": { "description": "\uD2B9\uC815 \uD504\uB85C\uC81D\uD2B8\uB85C \uD55C\uC815 (\uC120\uD0DD)", "type": "string" }, "q": { "description": "\uAC80\uC0C9 \uD0A4\uC6CC\uB4DC", "type": "string" }, "type": { "description": "Optional document type filter. Enabled values: erd, markdown.", "enum": ["erd", "markdown"], "type": "string" } }, "required": ["q"], "type": "object" }, "required": ["q"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "b88c3537086d0c7a" },
-  { "mcpName": "mcp__ainecto__unarchive_documents", "commandPath": ["documents", "unarchive"], "group": "document", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Document UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "4aae7df04fba8779" },
-  { "mcpName": "mcp__ainecto__unarchive_folders", "commandPath": ["folders", "unarchive"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Folder UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "e307cab0ebafd179" },
-  { "mcpName": "mcp__ainecto__unarchive_projects", "commandPath": ["projects", "unarchive"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Project UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "15ea4a409d1549de" },
-  { "mcpName": "mcp__ainecto__unarchive_workspaces", "commandPath": ["workspaces", "unarchive"], "group": "workspace", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Workspace UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "641de5b64ec75ab2" },
-  { "mcpName": "mcp__ainecto__update_documents", "commandPath": ["documents", "update"], "group": "document", "description": "Update documents. If a replacement body is tens of KB or more, prefer request_upload_token (purpose=document.update) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "body": { "description": "Deprecated compatibility alias for typePayload.body when document type is markdown. \uBCF8\uBB38\uC774 \uC218\uC2ED KB \uC774\uC0C1\uC73C\uB85C \uD06C\uBA74 LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.update)` \uB97C \uD638\uCD9C\uD574 uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C \uC9C1\uC811 PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "title": { "description": "New title", "type": "string" }, "typePayload": { "description": "Type-specific payload for enabled document types. markdown: {body}.", "type": "object" }, "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "5bedb6e5f5ba4f8d" },
-  { "mcpName": "mcp__ainecto__update_folders", "commandPath": ["folders", "update"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "name": { "description": "New name", "type": "string" }, "uuid": { "description": "Folder UUID", "type": "string" } }, "required": ["uuid", "name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "7bef3b4702df1f00" },
-  { "mcpName": "mcp__ainecto__update_projects", "commandPath": ["projects", "update"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "description": { "description": "New description", "type": "string" }, "name": { "description": "New name", "type": "string" }, "uuid": { "description": "Project UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "10cc0d84aeb2192b" },
-  { "mcpName": "mcp__ainecto__update_workspaces", "commandPath": ["workspaces", "update"], "group": "workspace", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "description": { "description": "New description", "type": "string" }, "name": { "description": "New name", "type": "string" }, "uuid": { "description": "Workspace UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "723e4f6d36ee9d02" },
-  { "mcpName": "mcp__ainecto__upload_attachments", "commandPath": ["tools", "run", "upload-attachments"], "group": "attachment", "description": "", "inputSchema": { "properties": { "items": { "description": "Attachments to register", "items": { "properties": { "contentType": { "description": "MIME type", "type": "string" }, "documentUuid": { "description": "Parent document UUID", "type": "string" }, "filename": { "description": "Original file name", "type": "string" }, "sizeBytes": { "description": "Size in bytes", "type": "integer" }, "storageKey": { "description": "Storage key returned by request_upload_token purpose=attachment.upload", "type": "string" } }, "required": ["documentUuid", "filename", "storageKey"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "binary-upload", "destructive": false, "sourceCatalog": "prod", "schemaHash": "0622e590de3404dd" }
+  { "mcpName": "create_documents", "commandPath": ["documents", "create"], "group": "document", "description": "Create documents. If a document body is tens of KB or more, prefer request_upload_token (purpose=document.create) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Documents", "items": { "properties": { "body": { "description": "Deprecated compatibility alias for typePayload.body when document type is markdown. \uBCF8\uBB38\uC774 \uC218\uC2ED KB \uC774\uC0C1\uC73C\uB85C \uD06C\uBA74 LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.create)` \uB97C \uD638\uCD9C\uD574 uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C \uC9C1\uC811 PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "folderUuid": { "description": "Optional folder UUID", "type": "string" }, "projectUuid": { "description": "Project UUID", "type": "string" }, "title": { "description": "Document title", "type": "string" }, "type": { "description": "Document type. Creatable values: erd, markdown, diagram, openapi, html.", "enum": ["erd", "markdown", "diagram", "openapi", "html"], "type": "string" }, "typePayload": { "description": "Type-specific payload for enabled document types. markdown: {body}; diagram: {diagramSource,sourceLanguage,edgeStyle,isModule,metadata}; openapi: {content}; html: {content} (a full HTML page).", "type": "object" } }, "required": ["projectUuid", "type", "title"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "105d051791cf595b" },
+  { "mcpName": "create_folders", "commandPath": ["folders", "create"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Folders", "items": { "properties": { "name": { "description": "Folder name", "type": "string" }, "parentFolderUuid": { "description": "Parent folder UUID", "type": "string" }, "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid", "name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "30f45b887259609f" },
+  { "mcpName": "create_projects", "commandPath": ["projects", "create"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Projects", "items": { "properties": { "description": { "description": "Description", "type": "string" }, "name": { "description": "Project name", "type": "string" }, "projectKey": { "description": "Unique project key", "type": "string" }, "workspaceUuid": { "description": "Workspace UUID \u2014 null uses user's default workspace", "type": "string" } }, "required": ["name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "edf5cf688d7c039a" },
+  { "mcpName": "create_workspaces", "commandPath": ["workspaces", "create"], "group": "workspace", "description": "", "inputSchema": { "properties": { "items": { "description": "Workspaces", "items": { "properties": { "description": { "description": "Description", "type": "string" }, "name": { "description": "Workspace name", "type": "string" } }, "required": ["name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "d9d1b0d561828b8e" },
+  { "mcpName": "delete_attachments", "commandPath": ["attachments", "delete"], "group": "attachment", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Attachment UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "b22c24bffdfe3d7d" },
+  { "mcpName": "delete_documents", "commandPath": ["documents", "delete"], "group": "document", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Document UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "3a725ae70956c270" },
+  { "mcpName": "delete_folders", "commandPath": ["folders", "delete"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Folder UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "2254cde89c9e8f06" },
+  { "mcpName": "delete_projects", "commandPath": ["projects", "delete"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Project UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "6521c33a28cb5465" },
+  { "mcpName": "delete_workspaces", "commandPath": ["workspaces", "delete"], "group": "workspace", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Workspace UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "3177868221137066" },
+  { "mcpName": "diagram_apply_changes", "commandPath": ["tools", "run", "diagram-apply-changes"], "group": "generic", "description": "Required single-call mutation path for diagram node/edge/group create/update/delete changes. Put nodes, edges, and groups in one request and call this once. Do not look for type-specific diagram CUD tools; this tool is the only diagram CUD entry point.", "inputSchema": { "properties": { "description": { "description": "Reason for batch (audit)", "type": "string" }, "diagramUuid": { "description": "Diagram UUID", "type": "string" }, "edges": { "description": "Edge operations", "items": { "properties": { "action": { "description": "Operation kind", "enum": ["create", "update", "delete"], "type": "string" }, "bridgeType": { "description": "Bridge type", "type": "string" }, "fromUuid": { "description": "Source", "type": "string" }, "label": { "description": "Edge label", "type": "string" }, "lineStyle": { "description": "Line style", "type": "string" }, "strokeColor": { "description": "Stroke color", "type": "string" }, "strokeWidth": { "description": "Stroke width", "type": "integer" }, "toUuid": { "description": "Target", "type": "string" }, "uuid": { "description": "Required for update/delete", "type": "string" } }, "required": ["action"], "type": "object" }, "type": "array" }, "groups": { "description": "Group operations", "items": { "properties": { "action": { "description": "Operation kind", "enum": ["create", "update", "delete"], "type": "string" }, "collapsed": { "description": "Collapsed state", "type": "boolean" }, "color": { "description": "Group color", "type": "string" }, "height": { "description": "Explicit height; omit to keep it derived from member nodes", "type": "number" }, "linkMode": { "description": "Link mode", "type": "string" }, "linkedDiagramUuid": { "description": "Linked diagram UUID", "type": "string" }, "name": { "description": "Group name", "type": "string" }, "parentGroupUuid": { "description": "Parent group UUID", "type": "string" }, "sortOrder": { "description": "Sort order", "type": "integer" }, "uuid": { "description": "Required for update/delete", "type": "string" }, "width": { "description": "Explicit width; omit to keep it derived from member nodes", "type": "number" } }, "required": ["action"], "type": "object" }, "type": "array" }, "nodes": { "description": "Node operations", "items": { "properties": { "action": { "description": "Operation kind", "enum": ["create", "update", "delete"], "type": "string" }, "fillColor": { "description": "Fill color", "type": "string" }, "groupUuid": { "description": "Group UUID; empty string clears membership", "type": "string" }, "height": { "description": "Height", "type": "number" }, "shape": { "description": "Node shape (start/end/diamond/cylinder/parallelogram/stadium/hexagon/rect/roundRect/...)", "enum": ["rect", "roundRect", "stadium", "diamond", "decision", "circle", "start", "doubleCircle", "end", "hexagon", "cylinder", "parallelogram"], "type": "string" }, "strokeColor": { "description": "Stroke color", "type": "string" }, "text": { "description": "Node text/label. Supports newlines (\\n) for multi-line display.", "maxLength": 4e3, "type": "string" }, "textColor": { "description": "Text color", "type": "string" }, "type": { "description": "Node type", "type": "string" }, "uuid": { "description": "Required for update/delete; optional for create", "type": "string" }, "width": { "description": "Width", "type": "number" }, "x": { "description": "X", "type": "number" }, "y": { "description": "Y", "type": "number" } }, "required": ["action"], "type": "object" }, "type": "array" } }, "required": ["diagramUuid", "description"], "type": "object" }, "required": ["description", "diagramUuid"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "add78d8edce88c86" },
+  { "mcpName": "diagram_get_edge", "commandPath": ["tools", "run", "diagram-get-edge"], "group": "generic", "description": "", "inputSchema": { "properties": { "edgeUuid": { "description": "Edge UUID", "type": "string" } }, "required": ["edgeUuid"], "type": "object" }, "required": ["edgeUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "2c03c4f7daa69898" },
+  { "mcpName": "diagram_get_group", "commandPath": ["tools", "run", "diagram-get-group"], "group": "generic", "description": "", "inputSchema": { "properties": { "groupUuid": { "description": "Group UUID", "type": "string" } }, "required": ["groupUuid"], "type": "object" }, "required": ["groupUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "55c5aa27b8cf489d" },
+  { "mcpName": "diagram_get_node", "commandPath": ["tools", "run", "diagram-get-node"], "group": "generic", "description": "", "inputSchema": { "properties": { "nodeUuid": { "description": "Node UUID", "type": "string" } }, "required": ["nodeUuid"], "type": "object" }, "required": ["nodeUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "646d553238328a9e" },
+  { "mcpName": "diagram_get_pending_llm_requests", "commandPath": ["tools", "run", "diagram-get-pending-llm-requests"], "group": "generic", "description": "", "inputSchema": { "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "2143d616cf7822bf" },
+  { "mcpName": "diagram_list_edges", "commandPath": ["tools", "run", "diagram-list-edges"], "group": "generic", "description": "", "inputSchema": { "properties": { "diagramUuid": { "description": "Diagram document UUID", "type": "string" } }, "required": ["diagramUuid"], "type": "object" }, "required": ["diagramUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4645085bde616381" },
+  { "mcpName": "diagram_list_groups", "commandPath": ["tools", "run", "diagram-list-groups"], "group": "generic", "description": "", "inputSchema": { "properties": { "diagramUuid": { "description": "Diagram document UUID", "type": "string" } }, "required": ["diagramUuid"], "type": "object" }, "required": ["diagramUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "8a7ca45dd34d1aef" },
+  { "mcpName": "diagram_list_nodes", "commandPath": ["tools", "run", "diagram-list-nodes"], "group": "generic", "description": "", "inputSchema": { "properties": { "diagramUuid": { "description": "Diagram document UUID", "type": "string" } }, "required": ["diagramUuid"], "type": "object" }, "required": ["diagramUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "d444066b5ca6eeb4" },
+  { "mcpName": "diagram_submit_llm_result", "commandPath": ["tools", "run", "diagram-submit-llm-result"], "group": "generic", "description": "", "inputSchema": { "properties": { "cachedInputTokens": { "description": "Cached subset of provider total input tokens", "type": "integer" }, "creditsCharged": { "description": "Deprecated; ignored. Credits are calculated server-side from tokens.", "type": "integer" }, "inputTokens": { "description": "Provider total input tokens; Java persists uncached input after one normalization", "type": "integer" }, "outputTokens": { "description": "Output token count", "type": "integer" }, "result": { "description": "LLM result text", "type": "string" }, "uuid": { "description": "LLM request UUID", "type": "string" } }, "required": ["uuid", "result"], "type": "object" }, "required": ["result", "uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "870ace32642a770a" },
+  { "mcpName": "diagram_update_llm_request_status", "commandPath": ["tools", "run", "diagram-update-llm-request-status"], "group": "generic", "description": "", "inputSchema": { "properties": { "errorMessage": { "description": "Error message (when status=FAILED)", "type": "string" }, "status": { "description": "Target status \u2014 currently only FAILED is mutable from caller side", "enum": ["FAILED"], "type": "string" }, "uuid": { "description": "LLM request UUID", "type": "string" } }, "required": ["uuid", "status"], "type": "object" }, "required": ["status", "uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "9ad96e3dc5fd2a8f" },
+  { "mcpName": "disable_shares", "commandPath": ["tools", "run", "disable-shares"], "group": "generic", "description": "", "inputSchema": { "properties": { "targetType": { "description": "Share target type", "enum": ["project", "folder", "document"], "type": "string" }, "targetUuids": { "description": "Target UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["targetType", "targetUuids"], "type": "object" }, "required": ["targetType", "targetUuids"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "bd1b310200b78420" },
+  { "mcpName": "enable_shares", "commandPath": ["tools", "run", "enable-shares"], "group": "generic", "description": "", "inputSchema": { "properties": { "targetType": { "description": "Share target type. A document gets a shareUrl anyone can open; a project gets a public API path only (there is no public project page); a folder token is stored but nothing public reads it yet.", "enum": ["project", "folder", "document"], "type": "string" }, "targetUuids": { "description": "Target UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["targetType", "targetUuids"], "type": "object" }, "required": ["targetType", "targetUuids"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "18559d7c0af09d2c" },
+  { "mcpName": "erd_apply_changes", "commandPath": ["erd", "apply-changes"], "group": "erd", "description": 'Required single-call mutation path for ERD create/update/delete changes. Put tables, columns, indexes, refs, enums, enum_values, and table groups in one operations array and call this once.\nRules: (1) all data field names are snake_case; (2) for create, generate your own UUIDs and put them in data.uuid, then later operations in the same batch may reference those UUIDs without read-back calls; (3) enum values are separate enum_value operations, not inline on enum; (4) ref.relationship uses short dbdiagram-style symbols: >, <, or -; (5) ref_column operations map FK columns explicitly, never automatically.\nDo not look for type-specific ERD CUD tools; this tool is the only ERD CUD entry point. If operations is very large, use request_upload_token with purpose=mcp.call and send the tools/call payload with curl to save LLM tokens.\nOne-call worked example:\n{\n  "documentUuid": "erd-doc-uuid",\n  "description": "create users/posts ERD",\n  "operations": [\n    {"op":"create","type":"table","data":{"uuid":"tbl_users","name":"users","display_order":1}},\n    {"op":"create","type":"column","data":{"uuid":"col_users_id","table_uuid":"tbl_users","name":"id","type":"bigint","is_pk":true,"is_not_null":true,"display_order":1}},\n    {"op":"create","type":"column","data":{"uuid":"col_users_email","table_uuid":"tbl_users","name":"email","type":"varchar(255)","is_unique":true,"is_not_null":true,"display_order":2}},\n    {"op":"create","type":"table","data":{"uuid":"tbl_posts","name":"posts","display_order":2}},\n    {"op":"create","type":"column","data":{"uuid":"col_posts_id","table_uuid":"tbl_posts","name":"id","type":"bigint","is_pk":true,"is_not_null":true,"display_order":1}},\n    {"op":"create","type":"column","data":{"uuid":"col_posts_author_id","table_uuid":"tbl_posts","name":"author_id","type":"bigint","is_not_null":true,"display_order":2}},\n    {"op":"create","type":"column","data":{"uuid":"col_posts_status","table_uuid":"tbl_posts","name":"status","type":"post_status","is_not_null":true,"display_order":3}},\n    {"op":"create","type":"enum","data":{"uuid":"enum_post_status","name":"post_status"}},\n    {"op":"create","type":"enum_value","data":{"uuid":"enum_post_status_draft","enum_uuid":"enum_post_status","value":"draft","display_order":1}},\n    {"op":"create","type":"enum_value","data":{"uuid":"enum_post_status_published","enum_uuid":"enum_post_status","value":"published","display_order":2}},\n    {"op":"create","type":"ref","data":{"uuid":"ref_posts_author","name":"fk_posts_author","from_table_uuid":"tbl_posts","to_table_uuid":"tbl_users","relationship":">","on_delete":"cascade"}},\n    {"op":"create","type":"ref_column","data":{"uuid":"refcol_posts_author","ref_uuid":"ref_posts_author","from_column_uuid":"col_posts_author_id","to_column_uuid":"col_users_id","display_order":1}}\n  ]\n}', "inputSchema": { "properties": { "arrangeNewTables": { "description": "Whether to auto-place newly-created tables after the batch; defaults to true", "type": "boolean" }, "description": { "description": "Reason for batch (audit)", "type": "string" }, "documentUuid": { "description": "ERD document UUID", "type": "string" }, "operations": { "description": "Atomic create/update/delete operations", "items": { "description": "One ERD mutation. Use a single operations array with client-generated data.uuid values to create cross-referenced tables, columns, enums, refs, and ref_columns without read-back calls.", "discriminator": { "propertyName": "type" }, "oneOf": [{ "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='table'.", "properties": { "alias": { "description": "Display alias.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "header_color": { "description": "Header color.", "type": "string" }, "name": { "description": "Table name. Required for create.", "type": "string" }, "note": { "description": "Table note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "required": ["name"], "title": "table data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='table'.", "properties": { "alias": { "description": "Display alias.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "header_color": { "description": "Header color.", "type": "string" }, "name": { "description": "Table name. Required for create.", "type": "string" }, "note": { "description": "Table note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "table", "description": "Must be 'table' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "table operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='column'.", "properties": { "default_value": { "description": "Default value.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "is_increment": { "description": "Auto-increment flag.", "type": "boolean" }, "is_not_null": { "description": "Not-null flag.", "type": "boolean" }, "is_pk": { "description": "Primary key flag.", "type": "boolean" }, "is_unique": { "description": "Unique flag.", "type": "boolean" }, "name": { "description": "Column name.", "type": "string" }, "note": { "description": "Column note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create; may be a data.uuid from an earlier table operation in this batch.", "type": "string" }, "type": { "description": "SQL data type. Use this exact field name; do not send data_type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "required": ["table_uuid"], "title": "column data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='column'.", "properties": { "default_value": { "description": "Default value.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "is_increment": { "description": "Auto-increment flag.", "type": "boolean" }, "is_not_null": { "description": "Not-null flag.", "type": "boolean" }, "is_pk": { "description": "Primary key flag.", "type": "boolean" }, "is_unique": { "description": "Unique flag.", "type": "boolean" }, "name": { "description": "Column name.", "type": "string" }, "note": { "description": "Column note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create; may be a data.uuid from an earlier table operation in this batch.", "type": "string" }, "type": { "description": "SQL data type. Use this exact field name; do not send data_type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "column data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "column", "description": "Must be 'column' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "column operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='index'.", "properties": { "is_pk": { "description": "Primary key index flag.", "type": "boolean" }, "is_unique": { "description": "Unique index flag.", "type": "boolean" }, "name": { "description": "Index name.", "type": "string" }, "note": { "description": "Index note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create.", "type": "string" }, "type": { "description": "Index type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "required": ["table_uuid"], "title": "index data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='index'.", "properties": { "is_pk": { "description": "Primary key index flag.", "type": "boolean" }, "is_unique": { "description": "Unique index flag.", "type": "boolean" }, "name": { "description": "Index name.", "type": "string" }, "note": { "description": "Index note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create.", "type": "string" }, "type": { "description": "Index type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "index data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "index", "description": "Must be 'index' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "index operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='index_column'.", "properties": { "column_uuid": { "description": "Column UUID. Required for create.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "index_uuid": { "description": "Index UUID. Required for create.", "type": "string" }, "sort_order": { "description": "Sort order, for example ASC or DESC.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "required": ["index_uuid", "column_uuid"], "title": "index_column data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='index_column'.", "properties": { "column_uuid": { "description": "Column UUID. Required for create.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "index_uuid": { "description": "Index UUID. Required for create.", "type": "string" }, "sort_order": { "description": "Sort order, for example ASC or DESC.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "index_column data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "index_column", "description": "Must be 'index_column' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "index_column operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='ref'.", "properties": { "from_table_uuid": { "description": "Source table UUID. Required for create.", "type": "string" }, "name": { "description": "Reference name.", "type": "string" }, "on_delete": { "description": "ON DELETE action.", "type": "string" }, "on_update": { "description": "ON UPDATE action.", "type": "string" }, "relationship": { "description": "Required for create. Use short dbdiagram-style relationship symbols.", "enum": [">", "<", "-"], "type": "string" }, "to_table_uuid": { "description": "Target table UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "required": ["from_table_uuid", "to_table_uuid", "relationship"], "title": "ref data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='ref'.", "properties": { "from_table_uuid": { "description": "Source table UUID. Required for create.", "type": "string" }, "name": { "description": "Reference name.", "type": "string" }, "on_delete": { "description": "ON DELETE action.", "type": "string" }, "on_update": { "description": "ON UPDATE action.", "type": "string" }, "relationship": { "description": "Required for create. Use short dbdiagram-style relationship symbols.", "enum": [">", "<", "-"], "type": "string" }, "to_table_uuid": { "description": "Target table UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "ref data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "ref", "description": "Must be 'ref' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "ref operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='ref_column'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "from_column_uuid": { "description": "Source column UUID. Required for create.", "type": "string" }, "ref_uuid": { "description": "Reference UUID. Required for create; may be a data.uuid from an earlier ref operation.", "type": "string" }, "to_column_uuid": { "description": "Target column UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "required": ["ref_uuid", "from_column_uuid", "to_column_uuid"], "title": "ref_column data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='ref_column'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "from_column_uuid": { "description": "Source column UUID. Required for create.", "type": "string" }, "ref_uuid": { "description": "Reference UUID. Required for create; may be a data.uuid from an earlier ref operation.", "type": "string" }, "to_column_uuid": { "description": "Target column UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "ref_column data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "ref_column", "description": "Must be 'ref_column' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "ref_column operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='enum'.", "properties": { "name": { "description": "Enum name.", "type": "string" }, "note": { "description": "Enum note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "enum data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='enum'.", "properties": { "name": { "description": "Enum name.", "type": "string" }, "note": { "description": "Enum note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "enum data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "enum", "description": "Must be 'enum' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "enum operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='enum_value'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "enum_uuid": { "description": "Parent enum UUID. Required for create; may be a data.uuid from an earlier enum operation.", "type": "string" }, "note": { "description": "Enum value note.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" }, "value": { "description": "Enum value. Inline enum values on enum are not persisted; create enum_value operations.", "type": "string" } }, "required": ["enum_uuid"], "title": "enum_value data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='enum_value'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "enum_uuid": { "description": "Parent enum UUID. Required for create; may be a data.uuid from an earlier enum operation.", "type": "string" }, "note": { "description": "Enum value note.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" }, "value": { "description": "Enum value. Inline enum values on enum are not persisted; create enum_value operations.", "type": "string" } }, "title": "enum_value data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "enum_value", "description": "Must be 'enum_value' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "enum_value operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='table_group'.", "properties": { "color": { "description": "Group color.", "type": "string" }, "name": { "description": "Table group name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table_group data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='table_group'.", "properties": { "color": { "description": "Group color.", "type": "string" }, "name": { "description": "Table group name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table_group data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "table_group", "description": "Must be 'table_group' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "table_group operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='table_group_table'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "schema_name": { "description": "Table schema name.", "type": "string" }, "table_name": { "description": "Table name. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "required": ["group_uuid", "table_name"], "title": "table_group_table data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='table_group_table'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "schema_name": { "description": "Table schema name.", "type": "string" }, "table_name": { "description": "Table name. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table_group_table data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "table_group_table", "description": "Must be 'table_group_table' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "table_group_table operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='table_group_note'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "note_uuid": { "description": "Note UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "required": ["group_uuid", "note_uuid"], "title": "table_group_note data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='table_group_note'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "note_uuid": { "description": "Note UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table_group_note data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "table_group_note", "description": "Must be 'table_group_note' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "table_group_note operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='filter'.", "properties": { "included_tables": { "description": "JSON string/list of included tables.", "type": "string" }, "is_default": { "description": "Default filter flag.", "type": "boolean" }, "name": { "description": "Filter name.", "type": "string" }, "table_groups": { "description": "JSON string/object of table groups.", "type": "string" }, "table_positions": { "description": "JSON string/object of table positions.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "filter data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='filter'.", "properties": { "included_tables": { "description": "JSON string/list of included tables.", "type": "string" }, "is_default": { "description": "Default filter flag.", "type": "boolean" }, "name": { "description": "Filter name.", "type": "string" }, "table_groups": { "description": "JSON string/object of table groups.", "type": "string" }, "table_positions": { "description": "JSON string/object of table positions.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "filter data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "filter", "description": "Must be 'filter' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "filter operation", "type": "object" }, { "allOf": [{ "if": { "properties": { "op": { "const": "create", "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": { "data": { "description": "Payload for operation.type='note'.", "properties": { "color": { "description": "Note color.", "type": "string" }, "content": { "description": "Note content.", "type": "string" }, "height": { "description": "Height.", "type": "integer" }, "icon_name": { "description": "Icon name.", "type": "string" }, "position_x": { "description": "X position.", "type": "integer" }, "position_y": { "description": "Y position.", "type": "integer" }, "title": { "description": "Note title.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" }, "width": { "description": "Width.", "type": "integer" } }, "title": "note data", "type": "object" } }, "required": ["data"], "type": "object" } }, { "if": { "properties": { "op": { "enum": ["update", "delete"], "type": "string" } }, "required": ["op"], "type": "object" }, "then": { "properties": {}, "required": ["uuid"], "type": "object" } }], "properties": { "data": { "description": "Payload for operation.type='note'.", "properties": { "color": { "description": "Note color.", "type": "string" }, "content": { "description": "Note content.", "type": "string" }, "height": { "description": "Height.", "type": "integer" }, "icon_name": { "description": "Icon name.", "type": "string" }, "position_x": { "description": "X position.", "type": "integer" }, "position_y": { "description": "Y position.", "type": "integer" }, "title": { "description": "Note title.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" }, "width": { "description": "Width.", "type": "integer" } }, "title": "note data", "type": "object" }, "op": { "description": "Operation", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "const": "note", "description": "Must be 'note' for this payload.", "type": "string" }, "uuid": { "description": "Target UUID for update/delete.", "type": "string" } }, "required": ["op", "type"], "title": "note operation", "type": "object" }], "properties": { "data": { "description": "Type-specific payload. All field names are snake_case. For create, data.uuid may be client-supplied and referenced by later operations in the same batch.", "oneOf": [{ "description": "Payload for operation.type='table'.", "properties": { "alias": { "description": "Display alias.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "header_color": { "description": "Header color.", "type": "string" }, "name": { "description": "Table name. Required for create.", "type": "string" }, "note": { "description": "Table note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table data", "type": "object" }, { "description": "Payload for operation.type='column'.", "properties": { "default_value": { "description": "Default value.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "is_increment": { "description": "Auto-increment flag.", "type": "boolean" }, "is_not_null": { "description": "Not-null flag.", "type": "boolean" }, "is_pk": { "description": "Primary key flag.", "type": "boolean" }, "is_unique": { "description": "Unique flag.", "type": "boolean" }, "name": { "description": "Column name.", "type": "string" }, "note": { "description": "Column note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create; may be a data.uuid from an earlier table operation in this batch.", "type": "string" }, "type": { "description": "SQL data type. Use this exact field name; do not send data_type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "column data", "type": "object" }, { "description": "Payload for operation.type='index'.", "properties": { "is_pk": { "description": "Primary key index flag.", "type": "boolean" }, "is_unique": { "description": "Unique index flag.", "type": "boolean" }, "name": { "description": "Index name.", "type": "string" }, "note": { "description": "Index note.", "type": "string" }, "table_uuid": { "description": "Parent table UUID. Required for create.", "type": "string" }, "type": { "description": "Index type.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "index data", "type": "object" }, { "description": "Payload for operation.type='index_column'.", "properties": { "column_uuid": { "description": "Column UUID. Required for create.", "type": "string" }, "display_order": { "description": "Display order.", "type": "integer" }, "index_uuid": { "description": "Index UUID. Required for create.", "type": "string" }, "sort_order": { "description": "Sort order, for example ASC or DESC.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "index_column data", "type": "object" }, { "description": "Payload for operation.type='ref'.", "properties": { "from_table_uuid": { "description": "Source table UUID. Required for create.", "type": "string" }, "name": { "description": "Reference name.", "type": "string" }, "on_delete": { "description": "ON DELETE action.", "type": "string" }, "on_update": { "description": "ON UPDATE action.", "type": "string" }, "relationship": { "description": "Required for create. Use short dbdiagram-style relationship symbols.", "enum": [">", "<", "-"], "type": "string" }, "to_table_uuid": { "description": "Target table UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "ref data", "type": "object" }, { "description": "Payload for operation.type='ref_column'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "from_column_uuid": { "description": "Source column UUID. Required for create.", "type": "string" }, "ref_uuid": { "description": "Reference UUID. Required for create; may be a data.uuid from an earlier ref operation.", "type": "string" }, "to_column_uuid": { "description": "Target column UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "ref_column data", "type": "object" }, { "description": "Payload for operation.type='enum'.", "properties": { "name": { "description": "Enum name.", "type": "string" }, "note": { "description": "Enum note.", "type": "string" }, "schema_name": { "description": "Schema name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "enum data", "type": "object" }, { "description": "Payload for operation.type='enum_value'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "enum_uuid": { "description": "Parent enum UUID. Required for create; may be a data.uuid from an earlier enum operation.", "type": "string" }, "note": { "description": "Enum value note.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" }, "value": { "description": "Enum value. Inline enum values on enum are not persisted; create enum_value operations.", "type": "string" } }, "title": "enum_value data", "type": "object" }, { "description": "Payload for operation.type='table_group'.", "properties": { "color": { "description": "Group color.", "type": "string" }, "name": { "description": "Table group name.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table_group data", "type": "object" }, { "description": "Payload for operation.type='table_group_table'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "schema_name": { "description": "Table schema name.", "type": "string" }, "table_name": { "description": "Table name. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table_group_table data", "type": "object" }, { "description": "Payload for operation.type='table_group_note'.", "properties": { "display_order": { "description": "Display order.", "type": "integer" }, "group_uuid": { "description": "Table group UUID. Required for create.", "type": "string" }, "note_uuid": { "description": "Note UUID. Required for create.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "table_group_note data", "type": "object" }, { "description": "Payload for operation.type='filter'.", "properties": { "included_tables": { "description": "JSON string/list of included tables.", "type": "string" }, "is_default": { "description": "Default filter flag.", "type": "boolean" }, "name": { "description": "Filter name.", "type": "string" }, "table_groups": { "description": "JSON string/object of table groups.", "type": "string" }, "table_positions": { "description": "JSON string/object of table positions.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" } }, "title": "filter data", "type": "object" }, { "description": "Payload for operation.type='note'.", "properties": { "color": { "description": "Note color.", "type": "string" }, "content": { "description": "Note content.", "type": "string" }, "height": { "description": "Height.", "type": "integer" }, "icon_name": { "description": "Icon name.", "type": "string" }, "position_x": { "description": "X position.", "type": "integer" }, "position_y": { "description": "Y position.", "type": "integer" }, "title": { "description": "Note title.", "type": "string" }, "uuid": { "description": "Optional on create: client-generated UUID (at most 36 characters, e.g. a standard UUID v4). If supplied, later operations in the same batch can reference it. Do not put create UUIDs in operation.uuid; operation.uuid is only the update/delete target.", "maxLength": 36, "type": "string" }, "width": { "description": "Width.", "type": "integer" } }, "title": "note data", "type": "object" }], "type": "object" }, "op": { "description": "Operation. For create, put any new UUID in data.uuid; for update/delete, put target UUID in operation.uuid.", "enum": ["create", "update", "delete"], "type": "string" }, "type": { "description": "ERD entity type. This selects the operation.data shape.", "enum": ["table", "column", "index", "index_column", "ref", "ref_column", "enum", "enum_value", "table_group", "table_group_table", "table_group_note", "filter", "note"], "type": "string" }, "uuid": { "description": "Target UUID for update/delete. Do not use this for create; use data.uuid instead.", "type": "string" } }, "required": ["op", "type"], "type": "object" }, "type": "array" } }, "required": ["documentUuid", "description", "operations"], "type": "object" }, "required": ["description", "documentUuid", "operations"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "87f5bcf5a253815a" },
+  { "mcpName": "erd_arrange_tables", "commandPath": ["erd", "arrange-tables"], "group": "erd", "description": "Arrange ERD tables after edits. Default incremental mode places newly-created tables while preserving existing positions; full=true re-layouts the entire diagram. Use after several separate table edits to tidy the canvas.", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "full": { "description": "Re-layout the ENTIRE diagram (overwrites existing positions). Default false = arrange only newly-added (uncoordinated) tables to the top-right while preserving existing table positions. Call this after creating several tables to tidy them up.", "type": "boolean" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "651fd0d54e3635ff" },
+  { "mcpName": "erd_get_enum", "commandPath": ["erd", "get-enum"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "enumUuid": { "description": "Enum UUID", "type": "string" } }, "required": ["documentUuid", "enumUuid"], "type": "object" }, "required": ["documentUuid", "enumUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "f0d79d7a1996939c" },
+  { "mcpName": "erd_get_ref", "commandPath": ["erd", "get-ref"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "refUuid": { "description": "Relationship UUID", "type": "string" } }, "required": ["documentUuid", "refUuid"], "type": "object" }, "required": ["documentUuid", "refUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "5b47fe7d99e60d4d" },
+  { "mcpName": "erd_get_table", "commandPath": ["erd", "get-table"], "group": "erd", "description": "Get one ERD table with nested columns and indexes. Returns persistent table/column/index UUIDs usable directly as erd_apply_changes update/delete targets and ref_column column references. Column fields use apply_changes snake_case names: uuid, table_uuid, name, type, is_pk, is_unique, is_not_null, is_increment, default_value, note, display_order. Index fields include uuid, name, columns (column UUIDs), is_unique, is_pk, type.", "inputSchema": { "description": "Get one ERD table with nested columns and indexes. Returns persistent table/column/index UUIDs usable directly as mcp__ainecto__erd_apply_changes update/delete targets and ref_column column references. Column fields use apply_changes snake_case names: uuid, table_uuid, name, type, is_pk, is_unique, is_not_null, is_increment, default_value, note, display_order. Index fields include uuid, name, columns (column UUIDs), is_unique, is_pk, type.", "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "tableUuid": { "description": "Table UUID. Response includes columns[] and indexes[] with persistent UUIDs for apply_changes.", "type": "string" } }, "required": ["documentUuid", "tableUuid"], "type": "object" }, "required": ["documentUuid", "tableUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "0dc13648bf3fbf8f" },
+  { "mcpName": "erd_get_table_group", "commandPath": ["erd", "get-table-group"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" }, "tableGroupUuid": { "description": "Table group UUID", "type": "string" } }, "required": ["documentUuid", "tableGroupUuid"], "type": "object" }, "required": ["documentUuid", "tableGroupUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "3db246dfe8663370" },
+  { "mcpName": "erd_list_enums", "commandPath": ["erd", "list-enums"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4d1f602fa487a0e4" },
+  { "mcpName": "erd_list_refs", "commandPath": ["erd", "list-refs"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "307d766c777bbe8c" },
+  { "mcpName": "erd_list_table_groups", "commandPath": ["erd", "list-table-groups"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "775bff53bbc21c9e" },
+  { "mcpName": "erd_list_tables", "commandPath": ["erd", "list-tables"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "34324dfc7ef461c8" },
+  { "mcpName": "get_attachment", "commandPath": ["attachment", "get"], "group": "attachment", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Attachment UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "1e0e7f1bf33b669c" },
+  { "mcpName": "get_document", "commandPath": ["document", "get"], "group": "document", "description": "Read a document. The body comes back for the types whose create/update take one: markdown \u2192 content; openapi \u2192 content (the spec text) + format/specVersion/pathCount/operationCount; html \u2192 content (the HTML text); diagram \u2192 diagramSource/sourceLanguage/edgeStyle/isModule/metadata; erd \u2192 metadata only (read tables/refs via erd_list_*).", "inputSchema": { "properties": { "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "5de278aad6b11bc5" },
+  { "mcpName": "get_project", "commandPath": ["project", "get"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Project UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "192403c3484ac774" },
+  { "mcpName": "get_version", "commandPath": ["version", "get"], "group": "generic", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "Document UUID", "type": "string" }, "versionNumber": { "description": "Version number", "type": "integer" } }, "required": ["documentUuid", "versionNumber"], "type": "object" }, "required": ["documentUuid", "versionNumber"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4e308c1a8c7203d1" },
+  { "mcpName": "get_workspace", "commandPath": ["workspace", "get"], "group": "workspace", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Workspace UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "db6d1b4879d57c56" },
+  { "mcpName": "identity_get_self", "commandPath": ["tools", "run", "identity-get-self"], "group": "generic", "description": "Return the authenticated MCP caller identity summary; never returns email or token claims.", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "f29c86804eb91700" },
+  { "mcpName": "list_attachments", "commandPath": ["attachments", "list"], "group": "attachment", "description": "", "inputSchema": { "properties": { "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid"], "type": "object" }, "required": ["projectUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "fae7152d1e4a930b" },
+  { "mcpName": "list_documents", "commandPath": ["documents", "list"], "group": "document", "description": "", "inputSchema": { "properties": { "folderUuid": { "description": "Optional folder UUID", "type": "string" }, "limit": { "description": "Result cap when q is set (default 50)", "type": "integer" }, "projectUuid": { "description": "Project UUID", "type": "string" }, "q": { "description": "Optional full-text query. When provided, results come from the search index instead of folder listing.", "type": "string" }, "type": { "description": "Optional document type filter. Readable values: erd, markdown, diagram, openapi, html.", "enum": ["erd", "markdown", "diagram", "openapi", "html"], "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4086c52be4dd0c15" },
+  { "mcpName": "list_folders", "commandPath": ["folders", "list"], "group": "generic", "description": "", "inputSchema": { "properties": { "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid"], "type": "object" }, "required": ["projectUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "461dc6735ac92c3b" },
+  { "mcpName": "list_projects", "commandPath": ["projects", "list"], "group": "generic", "description": "", "inputSchema": { "properties": { "limit": { "description": "Result cap when q is set (default 50)", "type": "integer" }, "q": { "description": "Optional full-text query", "type": "string" }, "workspaceUuid": { "description": "Optional Workspace UUID", "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "939bfcc088425771" },
+  { "mcpName": "list_trash", "commandPath": ["trash", "list"], "group": "generic", "description": "", "inputSchema": { "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "329250aecc06a298" },
+  { "mcpName": "list_versions", "commandPath": ["versions", "list"], "group": "generic", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "Document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "f08f9faee3ba9107" },
+  { "mcpName": "list_workspaces", "commandPath": ["workspaces", "list"], "group": "workspace", "description": "", "inputSchema": { "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "39dba0089fdbdf6a" },
+  { "mcpName": "markdown_append_document", "commandPath": ["markdown", "append-document"], "group": "markdown", "description": "Append to Markdown documents. If the appended body is tens of KB or more, prefer request_upload_token (purpose=document.append) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Appends", "items": { "properties": { "addition": { "description": "Body addition. \uCD94\uAC00\uD560 \uB0B4\uC6A9\uC774 \uD06C\uBA74 (\uC218\uC2ED KB \uC774\uC0C1) LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.append, scopeJson={documentUuid, separator})` \uB85C uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "separator": { "description": "Separator between existing body and addition", "type": "string" }, "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid", "addition"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "bf82401f055f29b0" },
+  { "mcpName": "markdown_generate_document", "commandPath": ["markdown", "generate-document"], "group": "markdown", "description": "", "inputSchema": { "properties": { "items": { "description": "Generation requests", "items": { "properties": { "context": { "description": "Optional JSON context", "type": "string" }, "documentUuid": { "description": "Target document UUID", "type": "string" }, "prompt": { "description": "Generation prompt", "type": "string" } }, "required": ["documentUuid", "prompt"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "1e4724ea42f25743" },
+  { "mcpName": "move_documents", "commandPath": ["documents", "move"], "group": "document", "description": "", "inputSchema": { "properties": { "clientMutationId": { "description": "Optional mutation identifier for client retry tracing", "maxLength": 128, "minLength": 1, "pattern": "^[\\x21-\\x7E]{1,128}$", "type": "string" }, "items": { "description": "Moves", "items": { "properties": { "newFolderUuid": { "description": "New folder UUID \u2014 null/empty for root", "type": "string" }, "targetProjectUuid": { "description": "Target project UUID \u2014 omit to stay in current project", "type": "string" }, "targetWorkspaceUuid": { "description": "Guard only: must match targetProjectUuid workspace", "type": "string" }, "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "45899053743a0c1e" },
+  { "mcpName": "move_folders", "commandPath": ["folders", "move"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Moves", "items": { "properties": { "newParentFolderUuid": { "description": "New parent UUID \u2014 null/empty for root", "type": "string" }, "uuid": { "description": "Folder UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "eff4458d2f35587a" },
+  { "mcpName": "move_projects", "commandPath": ["projects", "move"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Moves", "items": { "properties": { "targetWorkspaceUuid": { "description": "Destination workspace UUID (you need write access there)", "type": "string" }, "uuid": { "description": "Project UUID", "type": "string" } }, "required": ["uuid", "targetWorkspaceUuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "abe0196da3c48ad5" },
+  { "mcpName": "request_upload_token", "commandPath": ["tools", "run", "request-upload-token"], "group": "attachment", "description": "Use this for large payloads of tens of KB or more to save LLM tokens. purpose=mcp.call returns a short-lived bearer token that can call any MCP tool, including erd_apply_changes, via curl. purpose=document.create/update/append uploads document bodies directly to the upload endpoint with PUT/curl. Tokens are reusable for 5 minutes by default.", "inputSchema": { "properties": { "maxBytes": { "description": "\uCD5C\uB300 \uC5C5\uB85C\uB4DC byte (\uC11C\uBC84 \uCE21 \uD55C\uB3C4)", "type": "integer" }, "purpose": { "description": "Token \uC6A9\uB3C4. `mcp.call` \uC740 curl \uB85C /mcp \uD638\uCD9C, `document.create/update/append` \uB294 PUT body \uB85C \uBCF8\uBB38 \uC5C5\uB85C\uB4DC, `attachment.upload` \uB294 \uD30C\uC77C bytes \uC5C5\uB85C\uB4DC. \uCF58\uD150\uCE20\uAC00 \uD06C\uBA74 (\uC218\uC2ED KB \uC774\uC0C1) LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 \uC774 \uB3C4\uAD6C\uB85C 5\uBD84 \uC7AC\uC0AC\uC6A9 \uD1A0\uD070\uC744 \uBC1B\uACE0 curl \uB85C \uBCF4\uB0B4\uB294 \uAC83\uC744 \uAC15\uB825 \uAD8C\uC7A5.", "enum": ["mcp.call", "document.create", "document.update", "document.append", "attachment.upload"], "type": "string" }, "scopeJson": { "description": "\uC120\uD0DD \u2014 JSON scope. document.create \uB294 projectUuid, type, title \uC744 \uD3EC\uD568\uD558\uACE0 creatable type values \uB294 erd, markdown, diagram, openapi, html. document.update/document.append \uB294 documentUuid \uB97C \uD3EC\uD568. attachment.upload typed: {parentType:TEST_CASE|TEST_EXECUTION,parentUuid,filename,contentType,sizeBytes}.", "type": "string" }, "ttlSeconds": { "description": "TTL (\uCD08). \uAE30\uBCF8 300 (5\uBD84)", "type": "integer" } }, "required": ["purpose"], "type": "object" }, "required": ["purpose"], "payloadMode": "binary-upload", "destructive": false, "sourceCatalog": "prod", "schemaHash": "85867a646f6c652f" },
+  { "mcpName": "restore_versions", "commandPath": ["versions", "restore"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Restores", "items": { "properties": { "documentUuid": { "description": "Document UUID", "type": "string" }, "versionNumber": { "description": "Version number to restore", "type": "integer" } }, "required": ["documentUuid", "versionNumber"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "005b5b08a19fc605" },
+  { "mcpName": "search_documents", "commandPath": ["documents", "search"], "group": "document", "description": "", "inputSchema": { "properties": { "limit": { "description": "\uACB0\uACFC \uAC1C\uC218 (\uAE30\uBCF8 20, \uCD5C\uB300 50)", "type": "integer" }, "offset": { "description": "\uD398\uC774\uC9C0\uB124\uC774\uC158 offset (\uAE30\uBCF8 0)", "type": "integer" }, "projectUuid": { "description": "\uD2B9\uC815 \uD504\uB85C\uC81D\uD2B8\uB85C \uD55C\uC815 (\uC120\uD0DD)", "type": "string" }, "q": { "description": "\uAC80\uC0C9 \uD0A4\uC6CC\uB4DC", "type": "string" }, "type": { "description": "Optional document type filter. Readable values: erd, markdown, diagram, openapi, html.", "enum": ["erd", "markdown", "diagram", "openapi", "html"], "type": "string" } }, "required": ["q"], "type": "object" }, "required": ["q"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "d24e109383700433" },
+  { "mcpName": "unarchive_documents", "commandPath": ["documents", "unarchive"], "group": "document", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Document UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "f2810e71583a320f" },
+  { "mcpName": "unarchive_folders", "commandPath": ["folders", "unarchive"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Folder UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "2a24cc44696b7906" },
+  { "mcpName": "unarchive_projects", "commandPath": ["projects", "unarchive"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Project UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "6925e444671afe19" },
+  { "mcpName": "unarchive_workspaces", "commandPath": ["workspaces", "unarchive"], "group": "workspace", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Workspace UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "8dafe9bc6378c3f2" },
+  { "mcpName": "update_documents", "commandPath": ["documents", "update"], "group": "document", "description": "Update documents. If a replacement body is tens of KB or more, prefer request_upload_token (purpose=document.update) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "body": { "description": "Deprecated compatibility alias for typePayload.body when document type is markdown. \uBCF8\uBB38\uC774 \uC218\uC2ED KB \uC774\uC0C1\uC73C\uB85C \uD06C\uBA74 LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.update)` \uB97C \uD638\uCD9C\uD574 uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C \uC9C1\uC811 PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "title": { "description": "New title", "type": "string" }, "typePayload": { "description": "Type-specific payload for enabled document types. markdown: {body}; diagram: {diagramSource,sourceLanguage,edgeStyle,isModule,metadata}; openapi: {content}; html: {content} (a full HTML page).", "type": "object" }, "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4c3cfe4d25def672" },
+  { "mcpName": "update_folders", "commandPath": ["folders", "update"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "name": { "description": "New name", "type": "string" }, "uuid": { "description": "Folder UUID", "type": "string" } }, "required": ["uuid", "name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "43c58a96ee632b5f" },
+  { "mcpName": "update_projects", "commandPath": ["projects", "update"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "description": { "description": "New description", "type": "string" }, "name": { "description": "New name", "type": "string" }, "uuid": { "description": "Project UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "7d849ef0a830aa8c" },
+  { "mcpName": "update_workspaces", "commandPath": ["workspaces", "update"], "group": "workspace", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "description": { "description": "New description", "type": "string" }, "name": { "description": "New name", "type": "string" }, "uuid": { "description": "Workspace UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "553275e6da799c5a" },
+  { "mcpName": "upload_attachments", "commandPath": ["tools", "run", "upload-attachments"], "group": "attachment", "description": "", "inputSchema": { "properties": { "items": { "description": "Attachments to register", "items": { "properties": { "contentType": { "description": "MIME type", "type": "string" }, "documentUuid": { "description": "Parent document UUID", "type": "string" }, "filename": { "description": "Original file name", "type": "string" }, "sizeBytes": { "description": "Size in bytes", "type": "integer" }, "storageKey": { "description": "Storage key returned by request_upload_token purpose=attachment.upload", "type": "string" } }, "required": ["documentUuid", "filename", "storageKey"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "binary-upload", "destructive": false, "sourceCatalog": "prod", "schemaHash": "deda4a56fbbe064f" }
 ];
 
 // src/core/catalog/generated.dev.ts
@@ -834,10 +1005,147 @@ var generatedTools2 = [
   { "mcpName": "mcp__ainecto__upload_attachments", "commandPath": ["tools", "run", "upload-attachments"], "group": "attachment", "description": "", "inputSchema": { "properties": { "items": { "description": "Attachments to register", "items": { "properties": { "contentType": { "description": "MIME type", "type": "string" }, "documentUuid": { "description": "Parent document UUID", "type": "string" }, "filename": { "description": "Original file name", "type": "string" }, "sizeBytes": { "description": "Size in bytes", "type": "integer" }, "storageKey": { "description": "Storage key returned by request_upload_token purpose=attachment.upload", "type": "string" } }, "required": ["documentUuid", "filename", "storageKey"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "binary-upload", "destructive": false, "sourceCatalog": "dev", "schemaHash": "0622e590de3404dd" }
 ];
 
+// src/core/catalog/generator.ts
+import { createHash as createHash3 } from "crypto";
+var LEGACY_PREFIX = "mcp__ainecto__";
+function bareToolName(name) {
+  return name.startsWith(LEGACY_PREFIX) ? name.slice(LEGACY_PREFIX.length) : name;
+}
+var DESTRUCTIVE_PREFIXES = [
+  "delete_",
+  "remove_",
+  "archive_",
+  "unarchive_",
+  "restore_",
+  "move_",
+  "erd_delete_",
+  "erd_remove_",
+  "task_delete_",
+  "testcase_delete_"
+];
+function generateCatalog(tools, sourceCatalog) {
+  return tools.map((tool) => normalizeTool(tool, sourceCatalog)).sort((a, b) => a.mcpName.localeCompare(b.mcpName));
+}
+function normalizeTool(tool, sourceCatalog) {
+  if (!tool.name) {
+    throw new Error("Unsupported tool name: empty.");
+  }
+  const stripped = bareToolName(tool.name);
+  const group = inferGroup(stripped);
+  const inputSchema = normalizeSchema(tool.inputSchema ?? { type: "object", properties: {} });
+  const required = Array.isArray(inputSchema.required) ? inputSchema.required.filter((value) => typeof value === "string").sort() : [];
+  const definition = {
+    mcpName: tool.name,
+    commandPath: generateCommandPath(stripped, group),
+    group,
+    description: tool.description ?? "",
+    inputSchema,
+    required,
+    payloadMode: inferPayloadMode(stripped, inputSchema),
+    destructive: inferDestructive(stripped, tool),
+    sourceCatalog,
+    schemaHash: ""
+  };
+  return { ...definition, schemaHash: computeSchemaHash(definition) };
+}
+function inferGroup(strippedName) {
+  if (strippedName.startsWith("erd_")) return "erd";
+  if (strippedName.startsWith("flow_")) return "flow";
+  if (strippedName.startsWith("testcase_")) return "testcase";
+  if (strippedName.startsWith("markdown_")) return "markdown";
+  if (strippedName.includes("attachment") || strippedName.includes("upload")) return "attachment";
+  if (strippedName.startsWith("task_")) return "task";
+  if (strippedName.includes("workspace")) return "workspace";
+  if (strippedName.includes("document")) return "document";
+  return "generic";
+}
+function generateCommandPath(strippedName, group) {
+  if (group !== "generic" && strippedName.startsWith(`${group}_`)) {
+    return [group, snakeToKebab(strippedName.slice(group.length + 1))];
+  }
+  const [verb, ...rest] = strippedName.split("_");
+  if (verb && rest.length > 0 && isVerb(verb)) {
+    return [rest.join("-"), verb];
+  }
+  return ["tools", "run", snakeToKebab(strippedName)];
+}
+function inferPayloadMode(strippedName, inputSchema) {
+  if (strippedName.includes("upload") || strippedName.includes("attachment_upload")) {
+    return "binary-upload";
+  }
+  const properties = inputSchema.properties;
+  if (!isRecord3(properties)) {
+    return "flags";
+  }
+  const values = Object.values(properties);
+  if (values.length === 0) {
+    return "flags";
+  }
+  if (values.every(isScalarSchema)) {
+    return "flags";
+  }
+  return "file-json";
+}
+function inferDestructive(strippedName, tool) {
+  if (tool.annotations?.destructiveHint === true) {
+    return true;
+  }
+  return DESTRUCTIVE_PREFIXES.some((prefix) => strippedName.startsWith(prefix));
+}
+function computeSchemaHash(tool) {
+  return createHash3("sha256").update(stableStringify({
+    name: tool.mcpName,
+    description: tool.description,
+    inputSchema: tool.inputSchema
+  })).digest("hex").slice(0, 16);
+}
+function stableStringify(value) {
+  if (Array.isArray(value)) {
+    return `[${value.map(stableStringify).join(",")}]`;
+  }
+  if (isRecord3(value)) {
+    return `{${Object.keys(value).sort().map((key) => `${JSON.stringify(key)}:${stableStringify(value[key])}`).join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+function normalizeSchema(schema) {
+  return JSON.parse(stableStringify(schema));
+}
+function isScalarSchema(value) {
+  if (!isRecord3(value)) {
+    return false;
+  }
+  const type = value.type;
+  return type === "string" || type === "number" || type === "integer" || type === "boolean";
+}
+function isVerb(value) {
+  return [
+    "list",
+    "get",
+    "create",
+    "update",
+    "delete",
+    "move",
+    "restore",
+    "archive",
+    "unarchive",
+    "search"
+  ].includes(value);
+}
+function snakeToKebab(value) {
+  return value.replaceAll("_", "-");
+}
+function isRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 // src/core/catalog/index.ts
 function getGeneratedTools(env) {
   return env === "dev" ? generatedTools2 : generatedTools;
 }
+async function loadLiveTools(env, client) {
+  return generateCatalog(await client.toolsList(), env);
+}
 
 // src/core/mcp/stdioBridge.ts
 import { createInterface } from "readline";
@@ -867,7 +1175,7 @@ async function runStdioBridge(options) {
 }
 function parseJsonRpcRequest(line) {
   const parsed = JSON.parse(line);
-  if (!isRecord3(parsed) || parsed.jsonrpc !== "2.0" || typeof parsed.method !== "string") {
+  if (!isRecord4(parsed) || parsed.jsonrpc !== "2.0" || typeof parsed.method !== "string") {
     throw new Error("Invalid JSON-RPC request.");
   }
   return {
@@ -877,15 +1185,18 @@ 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 });
-  const client = new McpRpcClient({ endpoint: options.endpoint, tokenProvider: auth });
+  const auth = new OAuthClient({ endpoint: options.endpoint, tokenStore: new FileTokenStore() });
+  const client = new McpRpcClient({
+    endpoint: options.endpoint,
+    tokenProvider: auth,
+    role: options.role
+  });
   await runStdioBridge({
     input: options.input,
     output: options.output,
@@ -897,85 +1208,85 @@ async function runConnector(options) {
 // src/core/catalog/enrichments.ts
 var enrichments = [
   {
-    mcpName: "mcp__ainecto__list_projects",
+    mcpName: "list_projects",
     outputHint: "table",
     tableColumns: ["uuid", "name", "projectKey", "workspaceUuid", "updatedAt"],
     displayName: "List projects",
     examples: ["ainecto projects list --env dev"]
   },
   {
-    mcpName: "mcp__ainecto__list_workspaces",
+    mcpName: "list_workspaces",
     outputHint: "table",
     tableColumns: ["uuid", "name", "updatedAt"],
     displayName: "List workspaces"
   },
   {
-    mcpName: "mcp__ainecto__list_folders",
+    mcpName: "list_folders",
     outputHint: "table",
     tableColumns: ["uuid", "name", "projectUuid", "parentFolderUuid", "updatedAt"],
     displayName: "List folders"
   },
   {
-    mcpName: "mcp__ainecto__list_documents",
+    mcpName: "list_documents",
     outputHint: "table",
     tableColumns: ["uuid", "title", "type", "projectUuid", "folderUuid", "updatedAt"],
     displayName: "List documents"
   },
   {
-    mcpName: "mcp__ainecto__search_documents",
+    mcpName: "search_documents",
     outputHint: "table",
     tableColumns: ["uuid", "title", "type", "projectUuid", "updatedAt"],
     displayName: "Search documents"
   },
   {
-    mcpName: "mcp__ainecto__list_attachments",
+    mcpName: "list_attachments",
     outputHint: "table",
     tableColumns: ["uuid", "filename", "contentType", "sizeBytes", "documentUuid"],
     displayName: "List attachments"
   },
   {
-    mcpName: "mcp__ainecto__erd_list_tables",
+    mcpName: "erd_list_tables",
     outputHint: "table",
     tableColumns: ["uuid", "name", "schema_name", "display_order"],
     displayName: "List ERD tables"
   },
   {
-    mcpName: "mcp__ainecto__erd_list_refs",
+    mcpName: "erd_list_refs",
     outputHint: "table",
     tableColumns: ["uuid", "name", "from_table_uuid", "to_table_uuid", "relationship"],
     displayName: "List ERD refs"
   },
   {
-    mcpName: "mcp__ainecto__erd_list_enums",
+    mcpName: "erd_list_enums",
     outputHint: "table",
     tableColumns: ["uuid", "name", "display_order"],
     displayName: "List ERD enums"
   },
   {
-    mcpName: "mcp__ainecto__erd_list_table_groups",
+    mcpName: "erd_list_table_groups",
     outputHint: "table",
     tableColumns: ["uuid", "name", "display_order"],
     displayName: "List ERD table groups"
   },
   {
-    mcpName: "mcp__ainecto__task_list_tasks",
+    mcpName: "task_list_tasks",
     outputHint: "table",
     tableColumns: ["uuid", "title", "statusUuid", "assigneeId", "updatedAt"],
     displayName: "List tasks"
   },
   {
-    mcpName: "mcp__ainecto__task_list_statuses",
+    mcpName: "task_list_statuses",
     outputHint: "table",
     tableColumns: ["uuid", "name", "displayOrder"],
     displayName: "List task statuses"
   },
   {
-    mcpName: "mcp__ainecto__enable_shares",
+    mcpName: "enable_shares",
     aliases: ["shares enable"],
     displayName: "Enable shares"
   },
   {
-    mcpName: "mcp__ainecto__disable_shares",
+    mcpName: "disable_shares",
     aliases: ["shares disable"],
     displayName: "Disable shares"
   }
@@ -984,7 +1295,7 @@ var enrichments = [
 // src/core/output/table.ts
 function renderTable(data, options = {}) {
   const rows = extractRows(data);
-  if (!rows.length || !rows.every(isRecord4)) {
+  if (!rows.length || !rows.every(isRecord5)) {
     return void 0;
   }
   const columns = options.columns?.length ? options.columns : inferColumns(rows);
@@ -1001,7 +1312,7 @@ function extractRows(data) {
   if (Array.isArray(data)) {
     return data;
   }
-  if (isRecord4(data)) {
+  if (isRecord5(data)) {
     for (const key of ["items", "projects", "workspaces", "folders", "documents", "tasks", "attachments", "results", "data"]) {
       const value = data[key];
       if (Array.isArray(value)) {
@@ -1029,7 +1340,7 @@ function formatCell(value) {
   }
   return String(value);
 }
-function isRecord4(value) {
+function isRecord5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -1082,7 +1393,7 @@ function payloadToArgs(value) {
   if (value === void 0 || value === null) {
     return {};
   }
-  if (!isRecord5(value)) {
+  if (!isRecord6(value)) {
     throw new CliCommandError("INVALID_PAYLOAD", "Generated command payload must be a JSON object.", { value });
   }
   return { ...value };
@@ -1186,12 +1497,12 @@ function coerceFlagValue(value, schema, key) {
 }
 function getSchemaProperties(schema) {
   const properties = schema.properties;
-  if (!isRecord5(properties)) {
+  if (!isRecord6(properties)) {
     return {};
   }
   const result = {};
   for (const [key, value] of Object.entries(properties)) {
-    if (isRecord5(value)) {
+    if (isRecord6(value)) {
       result[key] = value;
     }
   }
@@ -1206,7 +1517,7 @@ function requireValue(flag, value) {
   }
   return value;
 }
-function isRecord5(value) {
+function isRecord6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -1248,9 +1559,8 @@ async function promptConfirmation(io, message) {
 var ATTACHMENTS_UPLOAD_COMMAND_PATH = ["attachments", "upload"];
 
 // src/adapters/cli/generatedCommandRouter.ts
-function matchGeneratedCommand(env, argv) {
+function matchGeneratedCommand(tools, argv) {
   const commandTokens = argv.filter((arg) => !arg.startsWith("-"));
-  const tools = getGeneratedTools(env);
   const entries = buildRouteEntries(tools, enrichments);
   const match = entries.filter((entry) => isPrefix(entry.path, commandTokens)).sort((a, b) => b.path.length - a.path.length)[0];
   if (!match) {
@@ -1266,7 +1576,7 @@ function matchGeneratedCommand(env, argv) {
   };
 }
 async function executeGeneratedCommand(options) {
-  const route = matchGeneratedCommand(options.env, options.argv);
+  const route = matchGeneratedCommand(options.tools, options.argv);
   if (!route) {
     return 2;
   }
@@ -1284,7 +1594,7 @@ async function executeGeneratedCommand(options) {
     warnings,
     presentation: route.presentation
   }));
-  return 0;
+  return isToolError(result) ? 1 : 0;
 }
 function renderGeneratedResult(result, options) {
   if (!options.json && options.presentation?.outputHint === "table") {
@@ -1429,7 +1739,7 @@ async function requestUploadToken(client, metadata, context) {
     requestArgs.ttlSeconds = context.ttlSeconds;
   }
   const response = unwrapMcpToolPayload(await client.toolsCall(context.requestToolName, requestArgs));
-  if (!isRecord6(response)) {
+  if (!isRecord7(response)) {
     throw new AttachmentUploadError("UPLOAD_TOKEN_PROTOCOL_ERROR", "request_upload_token response was not an object.");
   }
   const token = response.token;
@@ -1499,7 +1809,7 @@ function parsePutResponse(text) {
   } catch {
     throw new AttachmentUploadError("ATTACHMENT_UPLOAD_PROTOCOL_ERROR", "Attachment PUT response was not valid JSON.");
   }
-  if (!isRecord6(parsed)) {
+  if (!isRecord7(parsed)) {
     throw new AttachmentUploadError("ATTACHMENT_UPLOAD_PROTOCOL_ERROR", "Attachment PUT response was not an object.");
   }
   if (typeof parsed.storageKey !== "string") {
@@ -1532,10 +1842,10 @@ function validatePutResult(token, metadata, putResult) {
   }
 }
 function unwrapMcpToolPayload(value) {
-  if (!isRecord6(value) || !Array.isArray(value.content)) {
+  if (!isRecord7(value) || !Array.isArray(value.content)) {
     return value;
   }
-  const text = value.content.map((item) => isRecord6(item) && typeof item.text === "string" ? item.text : "").find((itemText) => itemText.trim().startsWith("{"));
+  const text = value.content.map((item) => isRecord7(item) && typeof item.text === "string" ? item.text : "").find((itemText) => itemText.trim().startsWith("{"));
   if (!text) {
     return value;
   }
@@ -1577,7 +1887,7 @@ var MIME_BY_EXTENSION = {
   ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
   ".zip": "application/zip"
 };
-function isRecord6(value) {
+function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -1701,166 +2011,2554 @@ function renderAttachmentUploadResult(result, json) {
   return renderSuccess(lines.join("\n"), { json: false });
 }
 
-// src/adapters/cli/ainectoCli.ts
-async function runAinectoCli(argv, io) {
-  let parsed = { json: argv.includes("--json"), help: false, positionals: [] };
-  try {
-    parsed = parseGlobalArgs(argv);
-    if (parsed.help || parsed.positionals.length === 0) {
-      io.stdout.write(helpText());
-      return 0;
-    }
-    const resolved = resolveEndpoint({ env: parsed.env, endpoint: parsed.endpoint });
-    const tokenStore = new FileTokenStore();
-    const auth = new OAuthClient({ endpoint: resolved.endpoint, tokenStore });
-    const client = new McpRpcClient({ endpoint: resolved.endpoint, tokenProvider: auth });
-    const [domain, action, ...rest] = parsed.positionals;
-    if (domain === "mcp") {
-      await runConnector({
-        endpoint: resolved.endpoint,
-        input: io.stdin,
-        output: io.stdout,
-        errorOutput: io.stderr
-      });
-      return 0;
-    }
-    if (domain === "auth") {
-      return handleAuth(action, auth, resolved.endpoint, parsed.json, io);
-    }
-    if (isAttachmentsUploadCommand(domain, action)) {
-      return await executeAttachmentsUploadCommand({
-        argv: rest,
-        client,
-        json: parsed.json,
-        io
-      });
-    }
-    const generatedResult = await executeGeneratedCommand({
-      env: parsed.env ?? "prod",
-      argv: parsed.positionals,
-      client,
-      json: parsed.json,
-      io
-    });
-    if (generatedResult !== 2) {
-      return generatedResult;
-    }
-    if (domain === "tools") {
-      return handleTools(action, rest, parsed, client, io);
-    }
-    throw new Error(`Unknown command "${domain}".`);
-  } catch (error) {
-    io.stderr.write(renderError(error, { json: parsed.json }));
-    return 1;
+// src/adapters/cli/initCommand.ts
+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
+import { basename as basename2 } from "path";
+var SERVER_NAME = "ainecto";
+var LEGACY_SERVER_NAME = "ai-erd";
+var AGENT_TARGETS = [
+  { id: "claude-code", label: "Claude Code", path: ".mcp.json" },
+  { id: "cursor", label: "Cursor", path: ".cursor/mcp.json" }
+];
+function buildServerEntry(input) {
+  const args = ["-y", PACKAGE_NAME, "--role", input.role];
+  if (input.env && input.env !== "prod") {
+    args.push("--env", input.env);
+  }
+  if (input.endpoint && !isDefaultEndpointFor(input.env ?? "prod", input.endpoint)) {
+    args.push("--endpoint", input.endpoint);
   }
+  return { command: "npx", args };
 }
-async function handleAuth(action, auth, endpoint, json, io) {
-  if (action === "login") {
-    await auth.login();
-    io.stdout.write(renderSuccess({ endpoint, authenticated: true }, { json }));
-    return 0;
+function readRoleFromEntry(entry) {
+  if (!isRecord8(entry) || !Array.isArray(entry.args)) {
+    return void 0;
   }
-  if (action === "status") {
-    const token = await auth.getAccessToken();
-    io.stdout.write(renderSuccess({ endpoint, authenticated: Boolean(token) }, { json }));
-    return 0;
+  const index = entry.args.indexOf("--role");
+  const value = index >= 0 ? entry.args[index + 1] : void 0;
+  return typeof value === "string" && HARNESS_ROLES.includes(value) ? value : void 0;
+}
+function readServerEntry(existing) {
+  if (existing === void 0) {
+    return void 0;
   }
-  if (action === "logout") {
-    await auth.logout();
-    io.stdout.write(renderSuccess({ endpoint, authenticated: false }, { json }));
-    return 0;
+  try {
+    const parsed = JSON.parse(existing);
+    const servers = parsed?.mcpServers;
+    return isRecord8(servers) ? servers[ourKeyIn(servers) ?? SERVER_NAME] : void 0;
+  } catch {
+    return void 0;
   }
-  throw new Error("Expected auth login, auth status, or auth logout.");
 }
-async function handleTools(action, rest, parsed, client, io) {
-  if (action === "list") {
-    const tools = await client.toolsList();
-    io.stdout.write(renderSuccess(tools, { json: parsed.json }));
-    return 0;
+function ourKeyIn(servers) {
+  if (Object.prototype.hasOwnProperty.call(servers, SERVER_NAME)) {
+    return SERVER_NAME;
   }
-  if (action === "call") {
-    const toolName = rest[0];
-    if (!toolName) {
-      throw new Error("Expected MCP tool name after tools call.");
-    }
-    const toolArgs = rest.slice(1);
-    const payloadOptions = parsePayloadArgs(toolArgs);
-    const payload = await parsePayloadSource({
-      file: payloadOptions.file,
-      inline: payloadOptions.inline,
-      stdin: io.stdin
-    });
-    const result = await client.toolsCall(toolName, payload.value);
-    io.stdout.write(renderSuccess(result, { json: parsed.json, warnings: payload.warnings }));
-    return 0;
+  return isOurBridge(servers[LEGACY_SERVER_NAME]) ? LEGACY_SERVER_NAME : void 0;
+}
+function legacyBridgeIn(servers) {
+  return isOurBridge(servers[LEGACY_SERVER_NAME]);
+}
+function isOurBridge(entry) {
+  if (!isRecord8(entry)) {
+    return false;
   }
-  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;
+  const { command, args } = entry;
+  const argList = Array.isArray(args) ? args.filter((arg) => typeof arg === "string") : [];
+  const isOurPackage = (arg) => [PACKAGE_NAME, LEGACY_PACKAGE_NAME].some((name) => arg === name || arg.startsWith(`${name}@`));
+  if (argList.some((arg) => isOurPackage(arg) || arg === "--role")) {
+    return true;
   }
-  throw new Error("Expected tools list, tools call <mcpName>, or tools catalog.");
+  const bin = typeof command === "string" ? basename2(command) : "";
+  return OUR_BINS.includes(bin);
 }
-function parseGlobalArgs(argv) {
-  const result = { json: false, help: false, positionals: [] };
-  for (let index = 0; index < argv.length; index += 1) {
-    const arg = argv[index];
-    if (!arg) {
-      continue;
-    }
-    if (arg === "--env") {
-      result.env = assertEnv(requireValue3(arg, argv[++index]));
-    } else if (arg === "--endpoint") {
-      result.endpoint = requireValue3(arg, argv[++index]);
-    } else if (arg === "--json") {
-      result.json = true;
-    } else if (arg === "--help" || arg === "-h") {
-      result.help = true;
-    } else {
-      result.positionals.push(arg);
-    }
+var OUR_BINS = ["ainecto", "ai-erd", "ai-erd-mcp"];
+function mergeServerEntry(existing, entry) {
+  const root = parseConfigObject(existing);
+  const servers = readServers(root);
+  const ourKey = ourKeyIn(servers);
+  const replaced = ourKey !== void 0;
+  const replacedEntry = ourKey === void 0 ? void 0 : servers[ourKey];
+  if (legacyBridgeIn(servers)) {
+    delete servers[LEGACY_SERVER_NAME];
+  }
+  servers[SERVER_NAME] = entry;
+  return { content: stringify({ ...root, mcpServers: servers }), replaced, replacedEntry };
+}
+function removeServerEntry(existing, restore) {
+  if (existing === void 0) {
+    return { removed: false, emptied: false };
+  }
+  const root = parseConfigObject(existing);
+  const servers = readServers(root);
+  const ourKey = ourKeyIn(servers);
+  const removed = ourKey !== void 0;
+  if (restore !== void 0) {
+    servers[ourKey ?? SERVER_NAME] = restore.value;
+    return { content: stringify({ ...root, mcpServers: servers }), removed, emptied: false };
+  }
+  if (ourKey !== void 0) {
+    delete servers[ourKey];
+  }
+  const otherKeys = Object.keys(root).filter((key) => key !== "mcpServers");
+  const emptied = Object.keys(servers).length === 0 && otherKeys.length === 0;
+  return { content: stringify({ ...root, mcpServers: servers }), removed, emptied };
+}
+function codexAddCommand(input) {
+  const entry = buildServerEntry(input);
+  return `codex mcp add ${SERVER_NAME} -- ${entry.command} ${entry.args.join(" ")}`;
+}
+function codexProfileSetup(input) {
+  const entry = buildServerEntry(input);
+  return [
+    `Per-session roles in Codex use profiles. Put this in $CODEX_HOME/${input.role}.config.toml:`,
+    "",
+    `    [mcp_servers.${SERVER_NAME}]`,
+    `    command = "${entry.command}"`,
+    `    args = ${JSON.stringify(entry.args)}`,
+    "",
+    `Then start that session with: codex -p ${input.role}`,
+    "A profile entry with the same server name replaces the global one, so the session still sees exactly one."
+  ];
+}
+function codexRemoveCommand() {
+  return `codex mcp remove ${SERVER_NAME}`;
+}
+function readServers(root) {
+  const servers = root.mcpServers;
+  if (servers === void 0) {
+    return {};
   }
-  return result;
+  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.'
+    );
+  }
+  return { ...servers };
 }
-function parsePayloadArgs(argv) {
-  const result = {};
-  const inline = [];
-  for (let index = 0; index < argv.length; index += 1) {
-    const arg = argv[index];
-    if (!arg) {
-      continue;
-    }
-    if (arg === "--file" || arg === "-f") {
-      result.file = requireValue3(arg, argv[++index]);
-    } else {
-      inline.push(arg);
-    }
+function parseConfigObject(existing) {
+  if (existing === void 0 || !existing.trim()) {
+    return {};
   }
-  if (inline.length > 0) {
-    result.inline = inline.join(" ");
+  let parsed;
+  try {
+    parsed = JSON.parse(existing);
+  } catch (error) {
+    throw new Error(
+      `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)})`
+    );
   }
-  return result;
+  if (!isRecord8(parsed)) {
+    throw new Error("Existing MCP config must be a JSON object; it was left untouched.");
+  }
+  return parsed;
 }
-function requireValue3(flag, value) {
-  if (!value || value.startsWith("--")) {
-    throw new Error(`${flag} requires a value.`);
+function stringify(value) {
+  return `${JSON.stringify(value, null, 2)}
+`;
+}
+function isRecord8(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+// src/core/harness/harnessDoc.ts
+var MARKER_BEGIN = "<!-- ainecto:begin -->";
+var MARKER_END = "<!-- ainecto:end -->";
+var LEGACY_MARKER_BEGIN = "<!-- ai-erd:begin -->";
+var LEGACY_MARKER_END = "<!-- ai-erd:end -->";
+var MARKERS = {
+  begin: [MARKER_BEGIN, LEGACY_MARKER_BEGIN],
+  end: [MARKER_END, LEGACY_MARKER_END]
+};
+var HARNESS_DIR = ".ainecto";
+var LEGACY_HARNESS_DIR = ".ai-erd";
+var HARNESS_DOC_PATH = `${HARNESS_DIR}/HARNESS.md`;
+var HARNESS_CONFIG_PATH = `${HARNESS_DIR}/config.json`;
+var HARNESS_RECORD_PATH = `${HARNESS_DIR}/init-record.json`;
+function renderHarnessDoc(input, template) {
+  return fillTemplate(template ?? DEFAULT_HARNESS_DOC, {
+    projectName: input.projectName,
+    projectUuid: input.projectUuid,
+    endpoint: input.endpoint
+  });
+}
+function fillTemplate(template, values) {
+  return template.replace(/\{\{([a-zA-Z0-9_]+)}}/g, (whole, name) => Object.prototype.hasOwnProperty.call(values, name) ? values[name] : whole);
+}
+var DOC_KEY = "HARNESS.DOC";
+var AGENT_NOTE_KEY = "HARNESS.AGENT_NOTE";
+var REQUIRED_VARIABLES = {
+  [DOC_KEY]: ["projectName", "projectUuid", "endpoint"],
+  [AGENT_NOTE_KEY]: ["harnessDocPath", "serverName"]
+};
+function documentContractProblem(key, body) {
+  for (const name of REQUIRED_VARIABLES[key] ?? []) {
+    if (!body.includes(`{{${name}}}`)) {
+      return `${key} is missing the required {{${name}}} placeholder`;
+    }
   }
-  return value;
+  if (key === AGENT_NOTE_KEY) {
+    return managedBlockProblem(key, withCurrentMarkers(body));
+  }
+  return void 0;
 }
-function helpText() {
-  return [
-    "Ainecto CLI",
-    "",
-    "Usage:",
-    "  ainecto auth login|status|logout [--env prod|dev] [--endpoint URL] [--json]",
-    "  ainecto tools list [--env prod|dev] [--endpoint URL] [--json]",
-    "  ainecto tools call <mcpName> [-f payload.json|@-] [inline-json] [--json]",
+var DEFAULT_HARNESS_DOC = `# AiNecto Harness
+
+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}}\`)
+- MCP endpoint: {{endpoint}}
+
+## 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 \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 |
+| --- | --- | --- |
+| Design | Requirements, ERD, domain and module boundaries, dependency direction, tasks | Write product or test code |
+| Development | Product code, following the approved design | Change requirements, ERD, architecture, or data ownership |
+| Test | Test scenarios and test code, running them and reading results | Change product code to make a test pass; change the design |
+| Validation | Judging the result against the design and the rules | Change anything; it reports PASS or FAIL with evidence |
+
+Every role can **read** the whole source of truth. Reading the design is how the other roles
+do their job. A session that cannot do something reports it in the session, to you.
+
+## When you are blocked
+
+If the work needs something your role cannot do, **stop and say so**. Do not look for a way
+around it: not by editing files the tools would have written, not by asking for the role to be
+changed mid-session, not by deferring the decision into the implementation.
+
+    The work needs a design change.
+    This is a Development Session, so I cannot make it.
+    Settle it in a Design Session, then continue here.
+
+Validation reports \`PASS\`, or \`FAIL\` with the rule violated, where it happened, the evidence,
+and which session should pick it up next.
+
+## Not every change needs four sessions
+
+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.
+
+## Switching roles
+
+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 \`ainecto init --role <design|development|test|validation>\` to rewrite them.
+
+---
+Generated by \`ainecto init\`. Remove everything it wrote with \`ainecto init --undo\`.
+`;
+function renderAgentNote(template) {
+  return fillTemplate(withCurrentMarkers(template ?? DEFAULT_AGENT_NOTE), {
+    harnessDocPath: HARNESS_DOC_PATH,
+    serverName: SERVER_NAME
+  });
+}
+function withCurrentMarkers(template) {
+  return template.split(LEGACY_MARKER_BEGIN).join(MARKER_BEGIN).split(LEGACY_MARKER_END).join(MARKER_END);
+}
+var DEFAULT_AGENT_NOTE = `${MARKER_BEGIN}
+## AiNecto Harness
+
+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 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) {
+  const trimmed = body.trim();
+  if (!trimmed.startsWith(MARKER_BEGIN)) {
+    return `${key} must begin with ${MARKER_BEGIN} \u2014 text outside the block is never removed by --undo`;
+  }
+  if (!trimmed.endsWith(MARKER_END)) {
+    return `${key} must end with ${MARKER_END} \u2014 text outside the block is never removed by --undo`;
+  }
+  const inner = trimmed.slice(MARKER_BEGIN.length, trimmed.length - MARKER_END.length);
+  if (inner.includes(MARKER_BEGIN) || inner.includes(MARKER_END)) {
+    return `${key} must contain exactly one ${MARKER_BEGIN} and one ${MARKER_END}`;
+  }
+  if (!inner.startsWith("\n")) {
+    return `${key} must put ${MARKER_BEGIN} alone on its own line`;
+  }
+  if (!inner.endsWith("\n")) {
+    return `${key} must put ${MARKER_END} alone on its own line`;
+  }
+  if (hasUnclosedFence(inner)) {
+    return `${key} contains an unclosed code fence \u2014 the closing marker would fall inside it`;
+  }
+  return void 0;
+}
+function hasUnclosedFence(content) {
+  let open;
+  for (const line of content.split("\n")) {
+    const fence = fenceOf(line);
+    if (!fence) continue;
+    if (!open) open = { char: fence.char, length: fence.length };
+    else if (fence.char === open.char && fence.length >= open.length && fence.info === "") open = void 0;
+  }
+  return open !== void 0;
+}
+function canonicalManagedBlock(block) {
+  return block.trim();
+}
+function upsertMarkerBlock(existing, block) {
+  const current = existing ?? "";
+  assertNoDanglingMarker(current);
+  const normalized = canonicalManagedBlock(block);
+  const range = markerRange(current);
+  const composed = range ? `${current.slice(0, range.start)}${normalized}${current.slice(range.end)}` : `${current.trim() ? `${current.replace(/\s*$/, "")}
+
+` : ""}${normalized}
+`;
+  assertComposedBlockIsOurs(composed, current);
+  return composed;
+}
+function assertComposedBlockIsOurs(composed, existing) {
+  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(
+    `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, "begin");
+  const ends = ownedMarkerCount(content, "end");
+  if (begins !== ends || begins > 1) {
+    throw new Error(
+      `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 (ownedMarker(content, "end", 0).at < ownedMarker(content, "begin", 0).at) {
+    throw new Error(
+      `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, kind) {
+  let count = 0;
+  for (let hit = ownedMarker(content, kind, 0); hit !== void 0; hit = ownedMarker(content, kind, hit.at + 1)) {
+    count += 1;
+  }
+  return count;
+}
+function ownedMarker(content, kind, from) {
+  let best;
+  for (const marker of MARKERS[kind]) {
+    const at = ownedMarkerIndex(content, marker, from);
+    if (at >= 0 && (best === void 0 || at < best.at)) {
+      best = { at, length: marker.length };
+    }
+  }
+  return best;
+}
+function anyMarker(content, kind, from) {
+  let best;
+  for (const marker of MARKERS[kind]) {
+    const at = content.indexOf(marker, from);
+    if (at >= 0 && (best === void 0 || at < best.at)) {
+      best = { at, length: marker.length };
+    }
+  }
+  return best;
+}
+function isInsideFencedBlock(content, index) {
+  let open;
+  let offset = 0;
+  for (const line of content.split("\n")) {
+    const nextOffset = offset + line.length + 1;
+    if (index < nextOffset) {
+      return open !== void 0;
+    }
+    const fence = fenceOf(line);
+    if (fence) {
+      if (!open) {
+        open = { char: fence.char, length: fence.length };
+      } else if (fence.char === open.char && fence.length >= open.length && fence.info === "") {
+        open = void 0;
+      }
+    }
+    offset = nextOffset;
+  }
+  return open !== void 0;
+}
+function fenceOf(line) {
+  const match = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line);
+  if (!match) {
+    return void 0;
+  }
+  const run = match[1];
+  const info = match[2].trim();
+  if (run.startsWith("`") && info.includes("`")) {
+    return void 0;
+  }
+  return { char: run[0], length: run.length, info };
+}
+function removeMarkerBlock(existing) {
+  const current = existing ?? "";
+  assertNoDanglingMarker(current);
+  const range = markerRange(current);
+  if (!range) {
+    return { content: current, removed: false, emptied: !current.trim() };
+  }
+  const before = current.slice(0, range.start).replace(/\n*$/, "");
+  const after = current.slice(range.end).replace(/^\n*/, "");
+  const stripped = before && after ? `${before}
+
+${after}` : before ? `${before}
+` : after;
+  return { content: stripped.trim() ? stripped : "", removed: true, emptied: !stripped.trim() };
+}
+function replaceMarkerBlockWith(content, block) {
+  const range = markerRange(content);
+  return range ? `${content.slice(0, range.start)}${block}${content.slice(range.end)}` : content;
+}
+var UNPAIRED_BEGIN = "(unpaired ai-erd begin)";
+var UNPAIRED_END = "(unpaired ai-erd end)";
+function markerEvidence(content) {
+  if (!content) {
+    return [];
+  }
+  const owned = markerRange(content);
+  const rest = owned === void 0 ? content : content.slice(0, owned.start) + content.slice(owned.end);
+  const evidence = [];
+  let cursor = 0;
+  let begins = 0;
+  let ends = 0;
+  while (true) {
+    const begin = anyMarker(rest, "begin", cursor);
+    const close = anyMarker(rest, "end", cursor);
+    if (begin === void 0 && close === void 0) {
+      break;
+    }
+    if (begin === void 0 || close !== void 0 && close.at < begin.at) {
+      ends += 1;
+      cursor = close.at + close.length;
+      continue;
+    }
+    const pairEnd = anyMarker(rest, "end", begin.at + begin.length);
+    if (pairEnd === void 0) {
+      begins += 1;
+      cursor = begin.at + begin.length;
+      continue;
+    }
+    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);
+  return evidence;
+}
+function blockShape(block) {
+  return block.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).join("\n");
+}
+function existingMarkerBlock(content) {
+  if (!content) {
+    return void 0;
+  }
+  const range = markerRange(content);
+  return range ? content.slice(range.start, range.end) : void 0;
+}
+function markerRange(content) {
+  const start = ownedMarker(content, "begin", 0);
+  if (start === void 0) {
+    return void 0;
+  }
+  const endMarker = ownedMarker(content, "end", start.at);
+  if (endMarker === void 0) {
+    return void 0;
+  }
+  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)) {
+    const lineStart = content.lastIndexOf("\n", at - 1) + 1;
+    if (lineStart !== at) {
+      continue;
+    }
+    const lineEnd = content.indexOf("\n", at);
+    const rest = (lineEnd < 0 ? content.slice(at) : content.slice(at, lineEnd)).slice(marker.length);
+    if (rest.trim() !== "") {
+      continue;
+    }
+    if (isInsideFencedBlock(content, at)) {
+      continue;
+    }
+    return at;
+  }
+  return -1;
+}
+
+// src/core/harness/initRecord.ts
+var RECORD_KIND = "ainecto/init-record";
+var LEGACY_RECORD_KIND = "ai-erd/init-record";
+var RECORD_VERSION = 2;
+var ABSENT = { at: "absent" };
+function emptyRecord() {
+  return { version: RECORD_VERSION, files: {}, createdDirectories: [] };
+}
+function readRecord(content, recordPath = HARNESS_RECORD_PATH) {
+  const HARNESS_RECORD_PATH2 = recordPath;
+  if (content === void 0) {
+    return { state: "absent" };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(content);
+  } catch {
+    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH2} is not valid JSON` };
+  }
+  if (!isObject(parsed)) {
+    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH2} is not a JSON object` };
+  }
+  if (parsed.kind !== RECORD_KIND && parsed.kind !== LEGACY_RECORD_KIND) {
+    return {
+      state: "corrupt",
+      reason: `${HARNESS_RECORD_PATH2} exists but is not an AiNecto init record (kind=${JSON.stringify(parsed.kind)})`
+    };
+  }
+  if (parsed.version !== RECORD_VERSION) {
+    return {
+      state: "legacy",
+      reason: `${HARNESS_RECORD_PATH2} was written by another version of this CLI (record version ${JSON.stringify(parsed.version)}, this CLI reads ${RECORD_VERSION})`
+    };
+  }
+  const files = parsed.files;
+  if (!isObject(files)) {
+    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH2} has no "files" object` };
+  }
+  const out = {};
+  for (const [path, raw] of Object.entries(files)) {
+    const read = readContract(raw);
+    if ("problem" in read) {
+      return {
+        state: "corrupt",
+        reason: `${HARNESS_RECORD_PATH2} has an unusable entry for ${path} \u2014 it ${read.problem}`
+      };
+    }
+    out[path] = read.contract;
+  }
+  const directories = parsed.createdDirectories;
+  if (directories !== void 0 && !isStringArray(directories)) {
+    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH2} has a malformed createdDirectories` };
+  }
+  return {
+    state: "valid",
+    record: {
+      version: RECORD_VERSION,
+      files: out,
+      createdDirectories: directories === void 0 ? [] : [...directories]
+    }
+  };
+}
+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) && [HARNESS_CONFIG_PATH, `${LEGACY_HARNESS_DIR}/config.json`].some((path) => Object.prototype.hasOwnProperty.call(lastWritten, path));
+}
+function legacyManagedNotice(configPath) {
+  return `${configPath} holds an init record written by an older version of this CLI (a "managed" field). This version keeps its record in ${HARNESS_RECORD_PATH} and cannot read that one, so your saved originals are still in there and nothing was changed. Undo with the version that wrote it (for example: npx -y -p @ai-erd/mcp@0.2 ai-erd init --undo), then run this version again.`;
+}
+function serializeRecord(record) {
+  return `${JSON.stringify({
+    kind: RECORD_KIND,
+    version: RECORD_VERSION,
+    files: record.files,
+    createdDirectories: record.createdDirectories
+  }, null, 2)}
+`;
+}
+function readContract(raw) {
+  if (!isObject(raw)) {
+    return { problem: "is not a JSON object" };
+  }
+  const scope = raw.scope;
+  if (scope !== "whole" && scope !== "entry" && scope !== "block" && scope !== "fields") {
+    return { problem: `has an unknown scope (${JSON.stringify(raw.scope)})` };
+  }
+  if (typeof raw.createdByUs !== "boolean") {
+    return { problem: "does not say whether ainecto created the file" };
+  }
+  const original = readOwned(raw.original);
+  const written = readOwned(raw.written);
+  if (original === void 0) {
+    return { problem: "has no readable record of what was there before" };
+  }
+  if (written === void 0) {
+    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" };
+  }
+  if (raw.writtenFields !== void 0 && !isObject(raw.writtenFields)) {
+    return { problem: "has a malformed writtenFields" };
+  }
+  let originalFields;
+  if (raw.originalFields !== void 0) {
+    if (!isObject(raw.originalFields)) {
+      return { problem: "has a malformed originalFields" };
+    }
+    originalFields = {};
+    for (const [field, value] of Object.entries(raw.originalFields)) {
+      const owned = readOwned(value);
+      if (owned === void 0) {
+        return { problem: `has no readable original for the field ${field}` };
+      }
+      originalFields[field] = owned;
+    }
+  }
+  if (raw.foreignBlocks !== void 0 && !isStringArray(raw.foreignBlocks)) {
+    return { problem: "has a malformed foreignBlocks" };
+  }
+  if (scope === "block" && raw.foreignBlocks === void 0) {
+    return { problem: "owns a marker block but does not say what marker blocks were already in the file" };
+  }
+  if (scope === "fields") {
+    const problem = fieldsContractProblem({
+      written,
+      writtenFields: isObject(raw.writtenFields) ? raw.writtenFields : void 0,
+      originalFields
+    });
+    if (problem !== void 0) {
+      return { problem };
+    }
+  }
+  const contract = {
+    scope,
+    createdByUs: raw.createdByUs,
+    original,
+    written
+  };
+  if (typeof raw.fileFingerprint === "string") contract.fileFingerprint = raw.fileFingerprint;
+  if (isObject(raw.writtenFields)) contract.writtenFields = { ...raw.writtenFields };
+  if (originalFields !== void 0) contract.originalFields = originalFields;
+  if (isStringArray(raw.foreignBlocks)) contract.foreignBlocks = [...raw.foreignBlocks];
+  return { contract };
+}
+function fieldsContractProblem(contract, ownedFields) {
+  const { written, writtenFields, originalFields } = contract;
+  if (writtenFields === void 0) {
+    return "owns only some fields of the file but does not say which ones it wrote (writtenFields)";
+  }
+  if (originalFields === void 0) {
+    return "owns only some fields of the file but does not say what was in them before (originalFields)";
+  }
+  const writtenKeys = Object.keys(writtenFields).sort();
+  const originalKeys = Object.keys(originalFields).sort();
+  if (writtenKeys.length !== originalKeys.length || writtenKeys.some((key, at) => key !== originalKeys[at])) {
+    return `lists different fields as written (${writtenKeys.join(", ") || "none"}) and as backed up (${originalKeys.join(", ") || "none"})`;
+  }
+  for (const key of writtenKeys) {
+    const original = originalFields[key];
+    if (original.at !== "absent" && original.at !== "json") {
+      return `records the original of ${key} as ${original.at}, which is not something --undo can put back into a JSON field`;
+    }
+  }
+  if (written.at !== "text") {
+    return "owns only some fields of the file but does not hold the file text it wrote";
+  }
+  let body;
+  try {
+    body = JSON.parse(written.text);
+  } catch {
+    return "holds a written file body that is not valid JSON";
+  }
+  if (!isObject(body)) {
+    return "holds a written file body that is not a JSON object";
+  }
+  for (const key of writtenKeys) {
+    if (!Object.prototype.hasOwnProperty.call(body, key)) {
+      return `says it wrote ${key}, but that field is not in the file body it recorded`;
+    }
+    if (stableStringify2(body[key]) !== stableStringify2(writtenFields[key])) {
+      return `records a different value for ${key} than the file body it wrote`;
+    }
+  }
+  if (ownedFields !== void 0) {
+    for (const key of ownedFields) {
+      if (Object.prototype.hasOwnProperty.call(body, key) && !Object.prototype.hasOwnProperty.call(writtenFields, key)) {
+        return `wrote ${key} into the file but does not record what it put there`;
+      }
+    }
+  }
+  return void 0;
+}
+function readOwned(raw) {
+  if (!isObject(raw)) {
+    return void 0;
+  }
+  if (raw.at === "absent") {
+    return ABSENT;
+  }
+  if (raw.at === "json") {
+    return Object.prototype.hasOwnProperty.call(raw, "value") ? { at: "json", value: raw.value } : void 0;
+  }
+  if (raw.at === "text") {
+    return typeof raw.text === "string" ? { at: "text", text: raw.text } : void 0;
+  }
+  return void 0;
+}
+function stableStringify2(value) {
+  if (Array.isArray(value)) {
+    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)}:${stableStringify2(item)}`).join(",")}}`;
+  }
+  return JSON.stringify(value) ?? "null";
+}
+function isObject(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function isStringArray(value) {
+  return Array.isArray(value) && value.every((entry) => typeof entry === "string");
+}
+
+// src/core/harness/initPlan.ts
+import { createHash as createHash4 } from "crypto";
+
+// src/core/harness/repositoryRole.ts
+import { lstat, readFile as readFile4, realpath } from "fs/promises";
+import { homedir as homedir2 } from "os";
+import { dirname as dirname2, join as join2, resolve, sep } from "path";
+function readConfigRole(path, content) {
+  if (content === void 0 || !content.trim()) {
+    return { kind: "absent" };
+  }
+  let servers;
+  try {
+    const parsed = JSON.parse(content);
+    const raw = parsed?.mcpServers;
+    servers = typeof raw === "object" && raw !== null && !Array.isArray(raw) ? raw : {};
+  } catch {
+    return content.includes(SERVER_NAME) || content.includes(LEGACY_SERVER_NAME) ? { kind: "problem", reason: `${path} is not valid JSON` } : { kind: "absent" };
+  }
+  const roles = [];
+  for (const key of [SERVER_NAME, LEGACY_SERVER_NAME]) {
+    const entry = servers[key];
+    if (!isOurBridge(entry)) {
+      continue;
+    }
+    const role = readRoleFromEntry(entry);
+    if (role === void 0) {
+      return { kind: "problem", reason: `${path} has the "${key}" bridge without a valid --role` };
+    }
+    if (!roles.includes(role)) {
+      roles.push(role);
+    }
+  }
+  if (roles.length > 1) {
+    return {
+      kind: "problem",
+      reason: `${path} has both the "${SERVER_NAME}" and the "${LEGACY_SERVER_NAME}" bridge with different roles (${roles.join(", ")})`
+    };
+  }
+  return roles.length === 0 ? { kind: "absent" } : { kind: "role", role: roles[0] };
+}
+function rolesInFiles(files) {
+  const roles = [];
+  const problems = [];
+  for (const target of AGENT_TARGETS) {
+    const read = readConfigRole(target.path, files.get(target.path));
+    if (read.kind === "problem") {
+      problems.push(read.reason);
+    } else if (read.kind === "role" && !roles.includes(read.role)) {
+      roles.push(read.role);
+    }
+  }
+  return { roles, problems, found: roles.length > 0 || problems.length > 0 };
+}
+async function findRepositoryRole(cwd, home = homedir2()) {
+  const stopAt = await realOrResolved(home);
+  for (let dir = await realOrResolved(cwd); ; dir = dirname2(dir)) {
+    if (samePath(dir, stopAt)) {
+      return { kind: "none" };
+    }
+    const files = /* @__PURE__ */ new Map();
+    let readProblem;
+    for (const target of AGENT_TARGETS) {
+      try {
+        files.set(target.path, await readConfigInside(dir, target.path));
+      } catch (error) {
+        readProblem = error instanceof Error ? error.message : String(error);
+      }
+    }
+    if (readProblem !== void 0) {
+      return { kind: "conflict", dir, reason: readProblem };
+    }
+    const result = rolesInFiles(files);
+    if (result.found) {
+      if (result.problems.length > 0) {
+        return { kind: "conflict", dir, reason: result.problems.join("; ") };
+      }
+      if (result.roles.length > 1) {
+        return {
+          kind: "conflict",
+          dir,
+          reason: `agent configs disagree about the session role (${result.roles.join(", ")})`
+        };
+      }
+      return { kind: "role", role: result.roles[0], dir };
+    }
+    if (dirname2(dir) === dir) {
+      return { kind: "none" };
+    }
+  }
+}
+async function askTheUserToFixRole(dir, reason) {
+  const gitRoot = await findGitRoot(dir);
+  const roles = HARNESS_ROLES.join(", ");
+  if (gitRoot !== void 0 && !samePath(await realOrResolved(gitRoot), await realOrResolved(dir))) {
+    return `Cannot tell this folder's AI session role: ${reason} (in ${dir}, inside the git repository at ${gitRoot}). Ask the user how that AiNecto setting should look \u2014 \`ainecto init\` only sets up a repository root (${gitRoot}).`;
+  }
+  return `Cannot tell this repository's AI session role: ${reason} (in ${dir}). Ask the user which role this repository's AI sessions should have (${roles}), then run \`ainecto init --role <role>\` in ${dir}.`;
+}
+async function realOrResolved(path) {
+  try {
+    return await realpath(path);
+  } catch {
+    return resolve(path);
+  }
+}
+function samePath(left, right) {
+  return process.platform === "win32" ? left.toLowerCase() === right.toLowerCase() : left === right;
+}
+async function readConfigInside(dir, path) {
+  let real;
+  try {
+    real = await realpath(join2(dir, path));
+  } catch (error) {
+    if (isNodeError2(error, "ENOENT") || isNodeError2(error, "ENOTDIR")) {
+      return void 0;
+    }
+    throw error;
+  }
+  const realDir = await realOrResolved(dir);
+  if (!samePath(real, realDir) && !real.startsWith(realDir + sep) && !(process.platform === "win32" && real.toLowerCase().startsWith((realDir + sep).toLowerCase()))) {
+    throw new Error(`${path} points outside ${dir} (${real})`);
+  }
+  return readFile4(real, "utf8");
+}
+async function findGitRoot(cwd) {
+  for (let at = resolve(cwd); ; at = dirname2(at)) {
+    try {
+      await lstat(join2(at, ".git"));
+      return at;
+    } catch {
+    }
+    if (dirname2(at) === at) {
+      return void 0;
+    }
+  }
+}
+async function readManagedFile(root, path) {
+  await assertInsideRepository(root, path);
+  return readIfExists(join2(root, path));
+}
+async function readIfExists(absolutePath) {
+  try {
+    return await readFile4(absolutePath, "utf8");
+  } catch (error) {
+    if (isNodeError2(error, "ENOENT")) {
+      return void 0;
+    }
+    throw error;
+  }
+}
+async function assertInsideRepository(root, relativePath) {
+  const absolutePath = join2(root, relativePath);
+  const realRoot = await realpath(root);
+  let realParent;
+  try {
+    realParent = await realpath(dirname2(absolutePath));
+  } catch (error) {
+    if (isNodeError2(error, "ENOENT")) {
+      return;
+    }
+    throw error;
+  }
+  if (realParent !== realRoot && !realParent.startsWith(realRoot + sep)) {
+    throw new Error(
+      `${relativePath} resolves outside the repository (${realParent}); refusing to touch it.`
+    );
+  }
+  try {
+    if ((await lstat(absolutePath)).isSymbolicLink()) {
+      throw new Error(`${relativePath} is a symbolic link; refusing to write through it.`);
+    }
+  } catch (error) {
+    if (!isNodeError2(error, "ENOENT")) {
+      throw error;
+    }
+  }
+}
+function isNodeError2(error, code) {
+  return typeof error === "object" && error !== null && error.code === code;
+}
+
+// src/core/harness/initPlan.ts
+var NOTE_TARGETS = [
+  { path: "AGENTS.md", createIfMissing: true },
+  { path: "CLAUDE.md", createIfMissing: false }
+];
+var MANAGED_PATHS = [
+  ...AGENT_TARGETS.map((target) => target.path),
+  ...NOTE_TARGETS.map((target) => target.path),
+  HARNESS_DOC_PATH,
+  HARNESS_CONFIG_PATH,
+  HARNESS_RECORD_PATH
+];
+function ownedJson(value, present) {
+  return present ? { at: "json", value } : ABSENT;
+}
+function ownedText(text) {
+  return text === void 0 ? ABSENT : { at: "text", text };
+}
+function sameOwned(left, right) {
+  if (left.at !== right.at) {
+    return false;
+  }
+  if (left.at === "absent") {
+    return true;
+  }
+  if (left.at === "text" && right.at === "text") {
+    return left.text === right.text;
+  }
+  return left.at === "json" && right.at === "json" && stableStringify2(left.value) === stableStringify2(right.value);
+}
+function contentFingerprint(content) {
+  return createHash4("sha256").update(content).digest("hex");
+}
+function serialize(body) {
+  return `${JSON.stringify(body, null, 2)}
+`;
+}
+function fingerprintFor(path, content) {
+  if (!path.endsWith(".json")) {
+    return contentFingerprint(content);
+  }
+  try {
+    return contentFingerprint(stableStringify2(JSON.parse(content)));
+  } catch {
+    return contentFingerprint(content);
+  }
+}
+function parseJsonObject(content) {
+  try {
+    const parsed = JSON.parse(content);
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function configBodyOf(values) {
+  return {
+    version: 1,
+    project: { uuid: values.projectUuid, name: values.projectName },
+    endpoint: values.endpoint,
+    generatedBy: values.cliVersion,
+    promptVersions: values.versions
+  };
+}
+var OUR_CONFIG_FIELDS = Object.keys(configBodyOf({
+  projectUuid: "",
+  projectName: "",
+  endpoint: "",
+  cliVersion: "",
+  versions: {}
+}));
+var hasField = (object, field) => Object.prototype.hasOwnProperty.call(object, field);
+function initRefusal(files, previous) {
+  const state = previous ?? readRecord(files.get(HARNESS_RECORD_PATH));
+  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") {
+      continue;
+    }
+    const problem = fieldsContractProblem(contract, OUR_CONFIG_FIELDS);
+    if (problem !== void 0) {
+      return `${HARNESS_RECORD_PATH}'s record for ${path} ${problem}. Nothing was changed \u2014 restore that file (or move it aside) and run again.`;
+    }
+  }
+  return void 0;
+}
+function planInit(input) {
+  const previous = input.previous ?? readRecord(input.files.get(HARNESS_RECORD_PATH));
+  const refusal = initRefusal(input.files, previous);
+  if (refusal !== void 0) {
+    return {
+      writes: [],
+      deletes: [],
+      notes: [],
+      codexCommand: codexAddCommand({ role: input.role, env: input.env, endpoint: input.endpoint }),
+      refusal
+    };
+  }
+  const carriedRecord = previous.state === "valid" ? previous.record : emptyRecord();
+  const entry = buildServerEntry({ role: input.role, env: input.env, endpoint: input.endpoint });
+  const writes = [];
+  const notes = [];
+  const record = {
+    version: carriedRecord.version,
+    files: { ...carriedRecord.files },
+    createdDirectories: [...carriedRecord.createdDirectories]
+  };
+  const priorOf = (path, current) => {
+    const prior = record.files[path];
+    if (prior === void 0) {
+      return void 0;
+    }
+    if (sameOwned(prior.written, current) || sameOwned(prior.original, current)) {
+      return prior;
+    }
+    delete record.files[path];
+    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) {
+    const existing = input.files.get(target.path);
+    const currentEntry = existing === void 0 ? void 0 : readServerEntry(existing);
+    const prior = priorOf(target.path, ownedJson(currentEntry, currentEntry !== void 0));
+    const merged = mergeServerEntry(existing, entry);
+    if (existing === merged.content) {
+      continue;
+    }
+    const before = previousRole(target.path, existing);
+    if (merged.replaced && before && before !== input.role) {
+      notes.push(`${target.path}: role ${before} \u2192 ${input.role}`);
+    }
+    const original = prior?.original ?? ownedJson(merged.replacedEntry, merged.replaced);
+    if (prior === void 0 && original.at !== "absent") {
+      notes.push(`${target.path}: your existing "${SERVER_NAME}" entry was saved and will be restored by --undo`);
+    }
+    record.files[target.path] = {
+      scope: "entry",
+      createdByUs: prior?.createdByUs ?? existing === void 0,
+      original,
+      written: ownedJson(readServerEntry(merged.content), true),
+      fileFingerprint: fingerprintFor(target.path, merged.content)
+    };
+    writes.push({ path: target.path, content: merged.content, existed: existing !== void 0 });
+  }
+  const existingDoc = input.files.get(HARNESS_DOC_PATH);
+  const priorDoc = priorOf(HARNESS_DOC_PATH, ownedText(existingDoc));
+  const docContent = renderHarnessDoc({
+    projectName: input.projectName,
+    projectUuid: input.projectUuid,
+    endpoint: input.endpoint
+  }, input.documents?.doc);
+  const docOriginal = priorDoc?.original ?? ownedText(existingDoc);
+  if (priorDoc === void 0 && docOriginal.at !== "absent") {
+    notes.push(`${HARNESS_DOC_PATH} already existed; its original was saved and --undo will restore it.`);
+  }
+  record.files[HARNESS_DOC_PATH] = {
+    scope: "whole",
+    createdByUs: priorDoc?.createdByUs ?? existingDoc === void 0,
+    original: docOriginal,
+    written: ownedText(docContent),
+    fileFingerprint: fingerprintFor(HARNESS_DOC_PATH, docContent)
+  };
+  if (docContent !== existingDoc) {
+    writes.push({ path: HARNESS_DOC_PATH, content: docContent, existed: existingDoc !== void 0 });
+  }
+  const note = renderAgentNote(input.documents?.agentNote);
+  for (const target of NOTE_TARGETS) {
+    const existing = input.files.get(target.path);
+    if (existing === void 0 && !target.createIfMissing) {
+      notes.push(`${target.path} not found \u2014 skipped; AGENTS.md already reaches this agent.`);
+      continue;
+    }
+    const blockNow = existing === void 0 ? void 0 : existingMarkerBlock(existing);
+    const carried = record.files[target.path];
+    let content;
+    try {
+      content = upsertMarkerBlock(existing, note);
+    } catch (error) {
+      notes.push(`${target.path}: ${error instanceof Error ? error.message : String(error)}`);
+      continue;
+    }
+    if (carried?.scope === "block" && unexplainedMarkers(existing, carried) > 0) {
+      notes.push(
+        `${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;
+    }
+    const prior = blockNow === void 0 ? carried : priorOf(target.path, ownedText(blockNow));
+    if (content === existing) {
+      continue;
+    }
+    const original = prior?.original ?? ownedText(blockNow);
+    if (prior === void 0 && original.at !== "absent") {
+      notes.push(`${target.path}: an existing ainecto block was saved and will be restored by --undo`);
+    }
+    record.files[target.path] = {
+      scope: "block",
+      createdByUs: prior?.createdByUs ?? existing === void 0,
+      original,
+      written: ownedText(existingMarkerBlock(content)),
+      fileFingerprint: fingerprintFor(target.path, content),
+      // init «전»에 이 파일에 있던 관리 블록들의 신원. 되돌리기가 「남은 마커를 설명할 수 있나」를
+      // 이것으로 묻는다. ★재init 은 이어받는다 — 다시 재면 우리가 쓴 블록이 «원래 있던 것»이 된다.
+      // ★{@code carried} 를 먼저 본다 — {@code priorOf} 가 새 기준을 세웠다는 것이 「남의 예제
+      //   목록을 다시 모아도 된다」는 허가가 아니다. 다시 모으면 «우리가 옮겨 둔 사본»이
+      //   「원래 있던 예제」로 등록되고, 그다음 되돌리기가 그것을 남긴 채 끝났다(3차 리뷰 B2).
+      foreignBlocks: carried?.foreignBlocks ?? prior?.foreignBlocks ?? markerEvidence(existing)
+    };
+    writes.push({ path: target.path, content, existed: existing !== void 0 });
+  }
+  const existingConfig = input.files.get(HARNESS_CONFIG_PATH);
+  const ourFields = configBodyOf({
+    projectUuid: input.projectUuid,
+    projectName: input.projectName,
+    endpoint: input.endpoint,
+    cliVersion: input.cliVersion,
+    // ★어느 판의 규칙으로 썼나. 이게 없으면 「무엇이 적혀 있었나」를 나중에 못 되짚는다.
+    versions: input.documents?.versions ?? {}
+  });
+  const theirConfig = existingConfig === void 0 ? void 0 : parseJsonObject(existingConfig);
+  if (existingConfig !== void 0 && theirConfig === void 0) {
+    notes.push(`${HARNESS_CONFIG_PATH} is not a JSON object \u2014 left untouched.`);
+  } else {
+    const priorConfig = record.files[HARNESS_CONFIG_PATH];
+    const originalFields = {};
+    for (const field of OUR_CONFIG_FIELDS) {
+      const presentNow = theirConfig !== void 0 && hasField(theirConfig, field);
+      const currentValue = presentNow ? theirConfig[field] : void 0;
+      const priorOriginal = priorConfig?.originalFields?.[field];
+      const priorWritten = priorConfig?.writtenFields;
+      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 ainecto now treats your value as the one to put back.`);
+      }
+    }
+    const mergedConfig = serialize({ ...theirConfig ?? {}, ...ourFields });
+    record.files[HARNESS_CONFIG_PATH] = {
+      scope: "fields",
+      createdByUs: priorConfig?.createdByUs ?? existingConfig === void 0,
+      original: ABSENT,
+      written: ownedText(mergedConfig),
+      fileFingerprint: fingerprintFor(HARNESS_CONFIG_PATH, mergedConfig),
+      writtenFields: { ...ourFields },
+      originalFields
+    };
+    if (mergedConfig !== existingConfig) {
+      writes.push({
+        path: HARNESS_CONFIG_PATH,
+        content: mergedConfig,
+        existed: existingConfig !== void 0
+      });
+    }
+  }
+  const existingRecord = input.files.get(HARNESS_RECORD_PATH);
+  const recordContent = serializeRecord(record);
+  if (recordContent !== existingRecord) {
+    writes.push({
+      path: HARNESS_RECORD_PATH,
+      content: recordContent,
+      existed: existingRecord !== void 0
+    });
+  }
+  return {
+    writes,
+    deletes: [],
+    codexCommand: codexAddCommand({ role: input.role, env: input.env, endpoint: input.endpoint }),
+    codexProfile: codexProfileSetup({ role: input.role, env: input.env, endpoint: input.endpoint }),
+    notes,
+    record
+  };
+}
+function planUndo(input) {
+  const state = input.record ?? readRecord(input.files.get(HARNESS_RECORD_PATH));
+  const writes = [];
+  const deletes = [];
+  const notes = [];
+  const tail = () => {
+    notes.push(`Codex keeps its own global config \u2014 remove it with: ${codexRemoveCommand()}`);
+    notes.push(`If you set ${ROLE_ENV_VAR} (or the older ${LEGACY_ROLE_ENV_VAR}) anywhere, unset it too.`);
+  };
+  if (state.state === "absent") {
+    notes.push(legacyManagedRecord(input.files.get(HARNESS_CONFIG_PATH)) ? legacyManagedNotice(HARNESS_CONFIG_PATH) : `No record of a previous init in ${HARNESS_RECORD_PATH} \u2014 no local file was changed.`);
+    tail();
+    return { writes, deletes, codexCommand: codexRemoveCommand(), notes };
+  }
+  if (state.state !== "valid") {
+    notes.push(
+      `${state.reason}. Nothing was changed \u2014 that file is kept because it may hold backups --undo still needs. Restore it, or finish the undo with the CLI version that wrote it.`
+    );
+    tail();
+    return { writes, deletes, codexCommand: codexRemoveCommand(), notes };
+  }
+  const record = state.record;
+  const remaining = { ...record.files };
+  for (const [path, contract] of Object.entries(record.files)) {
+    const outcome = undoOne(path, contract, input.files.get(path));
+    if (outcome.kind !== "unresolved" && outcome.kind !== "keep" && outcome.note !== void 0) {
+      notes.push(outcome.note);
+    } else if (outcome.kind === "unresolved" || outcome.kind === "keep") {
+      notes.push(outcome.note);
+    }
+    if (outcome.kind === "unresolved") {
+      continue;
+    }
+    delete remaining[path];
+    if (outcome.kind === "write") {
+      writes.push({ path, content: outcome.content, existed: true });
+    } else if (outcome.kind === "delete") {
+      deletes.push(path);
+    }
+  }
+  tail();
+  if (input.files.get(HARNESS_RECORD_PATH) !== void 0) {
+    if (Object.keys(remaining).length > 0) {
+      const reduced = { ...record, files: remaining };
+      writes.push({ path: HARNESS_RECORD_PATH, content: serializeRecord(reduced), existed: true });
+      notes.push(
+        `${HARNESS_RECORD_PATH}: kept, with the finished items removed \u2014 it still holds the backups --undo needs. Run --undo again once the items above are resolved.`
+      );
+    } else {
+      deletes.push(HARNESS_RECORD_PATH);
+    }
+  }
+  const removableDirectories = parentsOf(deletes).filter((directory) => record.createdDirectories.includes(directory));
+  return { writes, deletes, codexCommand: codexRemoveCommand(), notes, removableDirectories };
+}
+function unexplainedMarkers(existing, contract) {
+  const recorded = [...contract.foreignBlocks ?? []];
+  let unexplained = 0;
+  for (const print of markerEvidence(existing)) {
+    const at = recorded.indexOf(print);
+    if (at >= 0) {
+      recorded.splice(at, 1);
+    } else {
+      unexplained += 1;
+    }
+  }
+  return unexplained;
+}
+function undoOne(path, contract, existing) {
+  if (existing === void 0) {
+    if (contract.original.at !== "absent" || contract.scope === "fields") {
+      return {
+        kind: "unresolved",
+        note: `${path} is gone, so what was there before init could not be put back \u2014 the backup is kept. Restore the file and run --undo again.`
+      };
+    }
+    return { kind: "done" };
+  }
+  switch (contract.scope) {
+    case "entry":
+      return undoEntry(path, contract, existing);
+    case "block":
+      return undoBlock(path, contract, existing);
+    case "fields":
+      return undoFields(path, contract, existing);
+    case "whole":
+      return undoWhole(path, contract, existing);
+  }
+}
+function undoEntry(path, contract, existing) {
+  const current = readServerEntry(existing);
+  const currentOwned = ownedJson(current, current !== void 0);
+  if (sameOwned(currentOwned, contract.original)) {
+    return {
+      kind: "done",
+      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";
+  if (!goneButWeHoldTheOriginal && !sameOwned(currentOwned, contract.written)) {
+    return {
+      kind: "unresolved",
+      note: `${path}: the "${SERVER_NAME}" entry was edited after init \u2014 left in place. Remove it by hand if you meant to, then run --undo again.`
+    };
+  }
+  const restore = contract.original.at === "json" ? { value: contract.original.value } : void 0;
+  const result = removeServerEntry(existing, restore);
+  if (result.emptied && contract.createdByUs) {
+    return { kind: "delete" };
+  }
+  if (result.content !== void 0 && result.content !== existing) {
+    return {
+      kind: "write",
+      content: result.content,
+      note: restore === void 0 ? void 0 : `${path}: restored your original "${SERVER_NAME}" entry.`
+    };
+  }
+  return { kind: "done" };
+}
+function undoBlock(path, contract, existing) {
+  const current = existingMarkerBlock(existing);
+  const currentOwned = ownedText(current);
+  if (unexplainedMarkers(existing, contract) > 0) {
+    return {
+      kind: "unresolved",
+      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 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") {
+    const body = existing.trim() ? `${existing.replace(/\s*$/, "")}
+
+${contract.original.text}
+` : `${contract.original.text}
+`;
+    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 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;
+  try {
+    result = contract.original.at === "text" ? { content: replaceMarkerBlockWith(existing, contract.original.text), removed: true, emptied: false } : removeMarkerBlock(existing);
+  } catch (error) {
+    return { kind: "unresolved", note: `${path}: ${error instanceof Error ? error.message : String(error)}` };
+  }
+  if (!result.removed) {
+    return {
+      kind: "unresolved",
+      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) {
+    return { kind: "delete" };
+  }
+  return {
+    kind: "write",
+    content: result.content,
+    note: contract.original.at === "text" ? `${path}: restored the ainecto block that was there before.` : void 0
+  };
+}
+function undoWhole(path, contract, existing) {
+  if (sameOwned(ownedText(existing), contract.original)) {
+    return { kind: "done", note: `${path} is already the file that existed before init.` };
+  }
+  if (!sameOwned(ownedText(existing), contract.written)) {
+    if (contract.original.at === "text") {
+      return {
+        kind: "unresolved",
+        note: `${path} was edited after init \u2014 left in place instead of restoring the pre-init file. The backup is kept; run --undo again once you have resolved it.`
+      };
+    }
+    return { kind: "keep", note: `${path} was edited after init \u2014 left in place instead of deleting it.` };
+  }
+  if (contract.original.at === "text") {
+    return {
+      kind: "write",
+      content: contract.original.text,
+      note: `${path}: restored the file that existed before init.`
+    };
+  }
+  return contract.createdByUs ? { kind: "delete" } : { kind: "done" };
+}
+function undoFields(path, contract, existing) {
+  const parsed = parseJsonObject(existing);
+  if (parsed === void 0) {
+    return {
+      kind: "unresolved",
+      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}: 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;
+  const originals = contract.originalFields;
+  const next = {};
+  const kept = [];
+  for (const [field, value] of Object.entries(parsed)) {
+    if (!OUR_CONFIG_FIELDS.includes(field)) {
+      next[field] = value;
+      continue;
+    }
+    if (!hasField(written, field)) {
+      return {
+        kind: "unresolved",
+        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 = stableStringify2(value) === stableStringify2(written[field]);
+    if (!stillOurs) {
+      next[field] = value;
+      kept.push(field);
+      continue;
+    }
+    const original = originals[field];
+    if (original === void 0 || original.at !== "json" && original.at !== "absent") {
+      return {
+        kind: "unresolved",
+        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") {
+      next[field] = original.value;
+    }
+  }
+  const note = kept.length === 0 ? void 0 : `${path}: you changed ${kept.join(", ")} after init \u2014 left as you set it instead of putting the pre-init value back.`;
+  if (Object.keys(next).length === 0 && contract.createdByUs) {
+    return { kind: "delete", note };
+  }
+  const body = serialize(next);
+  return body === existing ? { kind: "done", note } : {
+    kind: "write",
+    content: body,
+    note: note ?? `${path}: removed what ainecto wrote and kept the rest.`
+  };
+}
+function withCreatedDirectories(current, directories) {
+  const state = readRecord(current);
+  if (state.state !== "valid") {
+    return current;
+  }
+  return serializeRecord({ ...state.record, createdDirectories: [...directories] });
+}
+function parentsOf(paths) {
+  const directories = /* @__PURE__ */ new Set();
+  for (const path of paths) {
+    const parent = path.includes("/") ? path.slice(0, path.lastIndexOf("/")) : "";
+    if (parent) {
+      directories.add(parent);
+    }
+  }
+  return [...directories].sort((left, right) => right.length - left.length);
+}
+function previousRole(path, existing) {
+  const read = readConfigRole(path, existing);
+  return read.kind === "role" ? read.role : void 0;
+}
+
+// src/core/harness/legacyLayout.ts
+var LEGACY_PATHS = new Map(
+  [HARNESS_DOC_PATH, HARNESS_CONFIG_PATH, HARNESS_RECORD_PATH].map((path) => [path, toLegacy(path)])
+);
+var LEGACY_RECORD_PATH = toLegacy(HARNESS_RECORD_PATH);
+var LEGACY_SNAPSHOT_PATHS = [...LEGACY_PATHS.values()];
+function adoptLegacyLayout(disk) {
+  const files = /* @__PURE__ */ new Map();
+  for (const [path, content] of disk) {
+    if (!LEGACY_SNAPSHOT_PATHS.includes(path)) {
+      files.set(path, content);
+    }
+  }
+  const view = { files, moves: [], legacyDirCreatedByUs: false, notes: [] };
+  if (!LEGACY_SNAPSHOT_PATHS.some((path) => disk.get(path) !== void 0)) {
+    return view;
+  }
+  const legacyRecord = disk.get(LEGACY_RECORD_PATH);
+  if (legacyRecord === void 0) {
+    const legacyConfig = LEGACY_PATHS.get(HARNESS_CONFIG_PATH);
+    if (disk.get(HARNESS_RECORD_PATH) === void 0 && legacyManagedRecord(disk.get(legacyConfig))) {
+      return { ...view, refusal: legacyManagedNotice(legacyConfig) };
+    }
+    view.notes.push(
+      `${LEGACY_HARNESS_DIR}/ was left in place \u2014 there is no ${LEGACY_RECORD_PATH} showing that an earlier version of this CLI wrote it. Remove it by hand if it is a leftover.`
+    );
+    return view;
+  }
+  const state = readRecord(legacyRecord, LEGACY_RECORD_PATH);
+  if (state.state !== "valid") {
+    return {
+      ...view,
+      refusal: state.state === "absent" ? `${LEGACY_RECORD_PATH} could not be read. Nothing was changed.` : `${state.reason}. Nothing was changed \u2014 move that file aside (or restore it) and run again.`
+    };
+  }
+  const clash = [...LEGACY_PATHS].filter(([to, from]) => disk.get(to) !== void 0 && disk.get(from) !== void 0).map(([to]) => to);
+  if (clash.length > 0) {
+    return {
+      ...view,
+      refusal: `Both ${LEGACY_HARNESS_DIR}/ and ${HARNESS_DIR}/ hold AiNecto setup files (${clash.join(", ")}): an older version of this CLI (0.4.x) ran here after this one, or a move was interrupted. Nothing was changed. Undo the older setup with \`npx -y -p @ai-erd/mcp@0.4.6 ai-erd init --undo\` (or remove the ${LEGACY_HARNESS_DIR}/ leftovers by hand), then run again.`
+    };
+  }
+  const record = state.record;
+  const renamed = {
+    ...record,
+    files: Object.fromEntries(Object.entries(record.files).map(([path, contract]) => [toCurrent(path), contract])),
+    // «하네스 폴더를 우리가 만들었다»는 같은 사실이다 — 이름만 옮긴다. 새 폴더를 이번에 만들면 적용이 또 적는다.
+    createdDirectories: record.createdDirectories.map(toCurrent)
+  };
+  const moves = [];
+  for (const [to, from] of LEGACY_PATHS) {
+    const content = disk.get(from);
+    if (content === void 0) {
+      continue;
+    }
+    files.set(to, to === HARNESS_RECORD_PATH ? serializeRecord(renamed) : content);
+    moves.push({ from, to });
+  }
+  return {
+    files,
+    moves,
+    legacyDirCreatedByUs: record.createdDirectories.includes(LEGACY_HARNESS_DIR),
+    notes: [`${LEGACY_HARNESS_DIR}/ \u2192 ${HARNESS_DIR}/: moved what an earlier version of this CLI wrote (the folder was renamed).`]
+  };
+}
+function withLegacyMoves(plan, view) {
+  if (view.moves.length === 0) {
+    return view.notes.length === 0 ? plan : { ...plan, notes: [...view.notes, ...plan.notes] };
+  }
+  const movedTo = new Set(view.moves.map((move) => move.to));
+  const planned = /* @__PURE__ */ new Set([...plan.writes.map((write) => write.path), ...plan.deletes]);
+  const carried = view.moves.filter((move) => !planned.has(move.to)).map((move) => ({ path: move.to, content: view.files.get(move.to), existed: false }));
+  return {
+    ...plan,
+    // 새 경로는 디스크에 아직 없다 — «만든다»가 사실이다.
+    writes: [...plan.writes.map((write) => movedTo.has(write.path) ? { ...write, existed: false } : write), ...carried],
+    // 새 경로의 삭제는 디스크에 없는 파일이다 — 대신 옛 파일을 지운다.
+    deletes: [...plan.deletes.filter((path) => !movedTo.has(path)), ...view.moves.map((move) => move.from)],
+    notes: [...view.notes, ...plan.notes],
+    removableDirectories: view.legacyDirCreatedByUs ? [...plan.removableDirectories ?? [], LEGACY_HARNESS_DIR] : plan.removableDirectories
+  };
+}
+function toLegacy(path) {
+  return `${LEGACY_HARNESS_DIR}${path.slice(HARNESS_DIR.length)}`;
+}
+function toCurrent(path) {
+  return path === LEGACY_HARNESS_DIR || path.startsWith(`${LEGACY_HARNESS_DIR}/`) ? `${HARNESS_DIR}${path.slice(LEGACY_HARNESS_DIR.length)}` : path;
+}
+
+// src/core/harness/documentFetch.ts
+var DOC_KEY2 = "HARNESS.DOC";
+var AGENT_NOTE_KEY2 = "HARNESS.AGENT_NOTE";
+async function fetchHarnessDocuments(input) {
+  const url = new URL(`${input.endpoint.replace(/\/$/, "")}/harness/documents`);
+  assertTrustedEndpointUrl(url, "harness documents URL");
+  if (input.client) {
+    url.searchParams.set("client", input.client);
+  }
+  const fetchImpl = input.fetchImpl ?? fetch;
+  try {
+    const response = await fetchImpl(url.toString(), {
+      headers: {
+        accept: "application/json",
+        ...input.accessToken ? { authorization: `Bearer ${input.accessToken}` } : {}
+      }
+    });
+    if (!response.ok) {
+      return { versions: {}, fallbacks: {}, unavailableReason: `server answered HTTP ${response.status}` };
+    }
+    const payload = await response.json();
+    const documents = payload.documents ?? {};
+    const versions = {};
+    const fallbacks = {};
+    const bodies = {};
+    for (const key of [DOC_KEY2, AGENT_NOTE_KEY2]) {
+      const entry = documents[key];
+      const problem = usableBodyProblem(key, entry);
+      if (problem) {
+        fallbacks[key] = typeof entry?.reason === "string" && entry.reason ? entry.reason : problem;
+        continue;
+      }
+      bodies[key] = entry.body;
+      if (typeof entry?.version === "string") {
+        versions[key] = entry.version;
+      }
+    }
+    return { doc: bodies[DOC_KEY2], agentNote: bodies[AGENT_NOTE_KEY2], versions, fallbacks };
+  } catch (error) {
+    return {
+      versions: {},
+      fallbacks: {},
+      unavailableReason: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+function usableBodyProblem(key, entry) {
+  if (typeof entry?.body !== "string" || !entry.body.trim()) {
+    return `server returned no body for ${key}`;
+  }
+  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 = resolve2(options.cwd);
+  const rootNotes = await repositoryRootNotes(root);
+  const disk = await readSnapshot(root);
+  const layout = adoptLegacyLayout(disk);
+  const files = layout.files;
+  if (args.undo) {
+    if (layout.refusal !== void 0) {
+      options.io.stdout.write(renderSuccess(
+        { action: args.dryRun ? "undo (dry-run)" : "undo", updated: [], removed: [], notes: [...rootNotes, layout.refusal] },
+        { json: options.json }
+      ));
+      return 0;
+    }
+    const plan2 = withLegacyMoves(planUndo({ files }), layout);
+    await applyPlan(root, plan2, args.dryRun, disk, false);
+    options.io.stdout.write(renderSuccess(
+      {
+        action: args.dryRun ? "undo (dry-run)" : "undo",
+        updated: plan2.writes.map((write) => write.path),
+        removed: plan2.deletes,
+        notes: [...rootNotes, ...plan2.notes]
+      },
+      { json: options.json }
+    ));
+    return 0;
+  }
+  const refusal = layout.refusal ?? initRefusal(files);
+  if (refusal !== void 0) {
+    throw new Error(refusal);
+  }
+  const prompter = options.prompter;
+  const role = options.role ?? (prompter ? await askRole(prompter, singleRole(rolesInFiles(files).roles)) : currentRole(files));
+  const previousRole2 = (() => {
+    try {
+      return currentRole(files);
+    } catch {
+      return void 0;
+    }
+  })();
+  if (!role) {
+    throw new Error(
+      `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(
+      {
+        message: "More than one project found. Re-run with --project <uuid>.",
+        projects: project.choices
+      },
+      { json: options.json }
+    ));
+    return 1;
+  }
+  const documents = args.dryRun ? { versions: {}, fallbacks: {}, unavailableReason: "skipped in --dry-run" } : await fetchHarnessDocuments({
+    endpoint: options.endpoint,
+    accessToken: await options.accessToken?.(),
+    // ⛔이 이름은 바꾸지 않는다 — 서버가 문서의 클라이언트별 변형 키(HARNESS.DOC.AI_ERD_CLI 등)를 이것으로
+    //   찾는다. 사람에게 안 보이는 서버 쪽 식별자다(역할 헤더·scope 와 같은 이유, 2026-10-11).
+    client: "ai-erd-cli",
+    fetchImpl: options.fetchImpl
+  });
+  const plan = withLegacyMoves(planInit({
+    role,
+    env: options.env,
+    projectName: project.name,
+    projectUuid: project.uuid,
+    endpoint: options.endpoint,
+    cliVersion: options.cliVersion,
+    files,
+    documents
+  }), layout);
+  if (plan.refusal !== void 0) {
+    throw new Error(plan.refusal);
+  }
+  await applyPlan(root, plan, args.dryRun, disk);
+  if (!args.dryRun && previousRole2 !== void 0 && previousRole2 !== role) {
+    options.io.stderr.write(`Role changes from ${previousRole2} to ${role}: \`ainecto\` commands now, MCP tools from a new session.
+`);
+  }
+  options.io.stdout.write(renderSuccess(
+    {
+      action: args.dryRun ? "init (dry-run)" : "init",
+      role,
+      project: { uuid: project.uuid, name: project.name },
+      endpoint: options.endpoint,
+      written: plan.writes.map((write) => `${write.existed ? "updated" : "created"} ${write.path}`),
+      // 옛 폴더(.ai-erd/)를 옮길 때만 생긴다 — 지운 것을 말하지 않으면 사용자는 옛 파일이 어디 갔는지 모른다.
+      ...plan.deletes.length > 0 ? { removed: plan.deletes } : {},
+      codex: `Codex keeps a single global config, so init does not touch it. Run: ${plan.codexCommand}`,
+      codexPerSession: plan.codexProfile,
+      codexEnvFallback: `Without a profile, start the session with ${ROLE_ENV_VAR}=${role}.`,
+      // ⚠조용히 기본값으로 떨어지지 않는다 — 서버에서 규칙을 고쳐도 안 바뀌는 이유를
+      //   사용자가 영영 못 찾게 된다. ★요청 자체의 실패와 «문서별» 되돌림을 둘 다 적는다
+      //   (2026-09-23 독립 재리뷰 I5: HTTP 200 으로 온 빈 문서가 조용히 패키지 판이 됐다).
+      notes: [...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: [
+        `Keep working in this session \u2014 no restart is needed. \`ainecto\` commands run from this repository use the ${role} role at once.`,
+        `Read ${HARNESS_DOC_PATH} first, then \`ainecto tools list\` shows the role's tools and \`ainecto tools call <tool> '<json>'\` calls one.`,
+        "Do not use MCP tools this session started with for this work \u2014 they keep the role (or no role) the session started with.",
+        "Optional, to add the role's MCP tools: start a new session.",
+        `Claude Code: exit and run \`claude -c\` in this folder, then approve the "${SERVER_NAME}" server from .mcp.json when asked.`,
+        `Codex: save the profile above as $CODEX_HOME/${role}.config.toml and start with \`codex -p ${role}\`.`,
+        role === "design" ? "To check the role, change a table through `ainecto` \u2014 Design may, and the change lands in AiNecto." : `To check the role, try changing a table through \`ainecto\` \u2014 ${role} is told to stop.`,
+        `If the new Claude Code session still has no role, run \`claude mcp get ${SERVER_NAME}\`: a local-scope "${SERVER_NAME}" entry hides .mcp.json (remove it with \`claude mcp remove ${SERVER_NAME} -s local\`).`,
+        // ★서버 이름이 바뀌었다(0.5.0). 예전에 같은 이름("ai-erd")이라 .mcp.json 이 덮던 사용자·Codex 전역 항목이
+        //   이제는 «따로» 붙어, 그 세션이 역할 없는 서버를 하나 더 본다. 그 항목을 지우는 법을 같이 말한다.
+        `If you added AiNecto earlier as "${LEGACY_SERVER_NAME}" (Claude Code user scope, or Codex), remove it \u2014 it no longer hides behind this "${SERVER_NAME}" entry: \`claude mcp remove ${LEGACY_SERVER_NAME} -s user\`, \`codex mcp remove ${LEGACY_SERVER_NAME}\`.`,
+        "Undo everything with: ainecto init --undo"
+      ]
+    },
+    { json: options.json }
+  ));
+  return 0;
+}
+function currentRole(files) {
+  const unique = rolesInFiles(files).roles;
+  if (unique.length > 1) {
+    throw new Error(
+      `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];
+}
+function fallbackNotes(documents) {
+  const notes = [];
+  if (documents.unavailableReason) {
+    notes.push(`Harness rules came from this package, not the server (${documents.unavailableReason}).`);
+  }
+  for (const [key, reason] of Object.entries(documents.fallbacks)) {
+    notes.push(`${key} came from this package, not the server (${reason}).`);
+  }
+  return notes;
+}
+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) {
+      return found;
+    }
+  }
+  if (projects.length === 1) {
+    return projects[0];
+  }
+  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 AiNecto account. Re-run with --yes to create "${name}", or --project-name <name> --yes to pick the name.`
+    );
+  }
+  if (args.dryRun) {
+    throw new Error(dryRunCannotCreate(name));
+  }
+  return createProject(options, name);
+}
+async function listProjects(options) {
+  const result = await callOrExplainSignIn(options, () => options.client.toolsCall("list_projects", {}));
+  return extractProjects(unwrapToolJson(result));
+}
+async function callOrExplainSignIn(options, run) {
+  try {
+    return await run();
+  } catch (error) {
+    if (!isUnauthorized(error)) {
+      throw error;
+    }
+    throw new Error(
+      `Not signed in, so ${options.endpoint} refused the request (HTTP 401).
+
+    ${loginCommand(options)}
+
+Then run init again. Sign-in is one per machine; the role comes from this repository.`
+    );
+  }
+}
+function loginCommand(options) {
+  const target = isDefaultEndpointFor(options.env, options.endpoint) ? options.env === "prod" ? "" : ` --env ${options.env}` : ` --endpoint ${options.endpoint}`;
+  return `ainecto auth login${target}`;
+}
+function isUnauthorized(error) {
+  return error instanceof McpRpcError && error.code === "MCP_HTTP_ERROR" && error.details?.status === 401;
+}
+async function createProject(options, name) {
+  const result = await callOrExplainSignIn(options, () => options.client.toolsCall("create_projects", { items: [{ name }] }));
+  const created = extractProjects(unwrapToolJson(result));
+  const first = created[0];
+  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 (!isRecord9(result) || !Array.isArray(result.content)) {
+    return result;
+  }
+  const first = result.content.find((item) => isRecord9(item) && item.type === "text");
+  if (!isRecord9(first) || typeof first.text !== "string") {
+    return result;
+  }
+  try {
+    return JSON.parse(first.text);
+  } catch {
+    return first.text;
+  }
+}
+function extractProjects(value) {
+  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 (isRecord9(candidate) && typeof candidate.uuid === "string") {
+      projects.push({
+        uuid: candidate.uuid,
+        name: typeof candidate.name === "string" ? candidate.name : candidate.uuid
+      });
+    }
+  }
+  return projects;
+}
+function boundProjectUuid(config) {
+  if (!config) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(config);
+    return typeof parsed.project?.uuid === "string" ? parsed.project.uuid : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function readSnapshot(root) {
+  const snapshot = /* @__PURE__ */ new Map();
+  for (const path of [...MANAGED_PATHS, ...LEGACY_SNAPSHOT_PATHS]) {
+    snapshot.set(path, await readManagedFile(root, path));
+  }
+  return snapshot;
+}
+async function applyPlan(root, plan, dryRun, snapshot, recordFirst = true) {
+  for (const write of plan.writes) {
+    await assertInsideRepository(root, write.path);
+    await assertUnchangedSinceSnapshot(root, write.path, snapshot);
+  }
+  for (const path of plan.deletes) {
+    await assertInsideRepository(root, path);
+    await assertUnchangedSinceSnapshot(root, path, snapshot);
+  }
+  if (dryRun) {
+    return;
+  }
+  const applied = [];
+  try {
+    const isRecord10 = (path) => !recordFirst && (path === HARNESS_RECORD_PATH || path === LEGACY_RECORD_PATH);
+    const recordWrites = plan.writes.filter((write) => isRecord10(write.path));
+    const recordDeletes = plan.deletes.filter((path) => isRecord10(path));
+    const createdDirectories = [...plan.record?.createdDirectories ?? []];
+    const rememberDirectories = (directories) => {
+      for (const directory of directories) {
+        if (!createdDirectories.includes(directory)) {
+          createdDirectories.push(directory);
+        }
+      }
+    };
+    const recordActualDirectories = async () => {
+      const write = plan.writes.find((w) => w.path === HARNESS_RECORD_PATH);
+      if (!recordFirst || !plan.record || !write || !applied.includes(HARNESS_RECORD_PATH)) {
+        return;
+      }
+      await writeManagedFile(root, {
+        ...write,
+        content: withCreatedDirectories(write.content, createdDirectories)
+      });
+    };
+    const recordDirectoriesOrExplain = async (failing) => {
+      try {
+        await recordActualDirectories();
+      } catch (error) {
+        if (!failing) {
+          throw error;
+        }
+      }
+    };
+    const apply = async (writes, deletes) => {
+      for (const write of writes) {
+        await assertUnchangedSinceSnapshot(root, write.path, snapshot);
+        await writeManagedFile(root, write, rememberDirectories);
+        applied.push(write.path);
+      }
+      for (const path of deletes) {
+        await assertUnchangedSinceSnapshot(root, path, snapshot);
+        await rm2(join3(root, path), { force: true });
+        applied.push(path);
+      }
+    };
+    try {
+      await apply(
+        orderedWrites(plan.writes.filter((write) => !isRecord10(write.path)), recordFirst),
+        plan.deletes.filter((path) => !isRecord10(path))
+      );
+      await recordDirectoriesOrExplain(false);
+      await apply(recordWrites, recordDeletes);
+    } catch (error) {
+      await recordDirectoriesOrExplain(true);
+      throw error;
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(
+      `${message}
+Already applied before this failure: ${applied.join(", ") || "(nothing)"}`
+    );
+  }
+  for (const directory of plan.removableDirectories ?? []) {
+    await rmdir(join3(root, directory)).catch(() => void 0);
+  }
+}
+function orderedWrites(writes, recordFirst) {
+  const record = writes.filter((write) => write.path === HARNESS_RECORD_PATH);
+  const rest = writes.filter((write) => write.path !== HARNESS_RECORD_PATH);
+  return recordFirst ? [...record, ...rest] : [...rest, ...record];
+}
+async function assertUnchangedSinceSnapshot(root, relativePath, snapshot) {
+  if (!snapshot.has(relativePath)) {
+    return;
+  }
+  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.`
+    );
+  }
+}
+async function writeManagedFile(root, write, onDirectoriesCreated) {
+  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);
+  const previousMode = await fileMode(absolutePath);
+  const tmpPath = `${absolutePath}.${process.pid}.${Date.now()}.tmp`;
+  await writeFile2(tmpPath, write.content, { encoding: "utf8", mode: previousMode ?? 384 });
+  if (previousMode !== void 0) {
+    await chmod2(tmpPath, previousMode);
+  }
+  await rename2(tmpPath, absolutePath);
+  return created;
+}
+function createdChain(root, firstCreated, targetDirectory) {
+  if (firstCreated === void 0) {
+    return [];
+  }
+  const stop = resolve2(firstCreated);
+  const made = [];
+  for (let at = resolve2(targetDirectory); ; at = dirname3(at)) {
+    const asRelative = relative(root, at);
+    if (asRelative && !asRelative.startsWith("..")) {
+      made.push(asRelative.split(sep2).join("/"));
+    }
+    if (at === stop || dirname3(at) === at) {
+      break;
+    }
+  }
+  return made;
+}
+async function fileMode(absolutePath) {
+  try {
+    return (await stat3(absolutePath)).mode & 4095;
+  } catch (error) {
+    if (isRecord9(error) && error.code === "ENOENT") {
+      return void 0;
+    }
+    throw error;
+  }
+}
+function parseInitArgs(argv) {
+  const args = { dryRun: false, undo: false, yes: false };
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (!arg) {
+      continue;
+    }
+    if (arg === "--project") {
+      args.projectUuid = requireValue3(arg, argv[++index]);
+    } else if (arg === "--project-name") {
+      args.projectName = requireValue3(arg, argv[++index]);
+    } else if (arg === "--dry-run") {
+      args.dryRun = true;
+    } else if (arg === "--undo") {
+      args.undo = true;
+    } else if (arg === "--yes" || arg === "-y") {
+      args.yes = true;
+    } else if (arg === "--json") {
+    } else {
+      throw new Error(`Unknown argument: ${arg}`);
+    }
+  }
+  return args;
+}
+function requireValue3(flag, value) {
+  if (!value || value.startsWith("--")) {
+    throw new Error(`${flag} requires a value.`);
+  }
+  return value;
+}
+function basenameOf(path) {
+  const parts = path.split(/[\\/]/).filter(Boolean);
+  return parts[parts.length - 1] ?? "ainecto-project";
+}
+function isRecord9(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+// src/adapters/cli/ainectoCli.ts
+async function runAinectoCli(argv, io) {
+  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 });
+    const explicitRole = () => resolveRole({ role: parsed.role });
+    const tokenStore = new FileTokenStore();
+    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,
+        // 브리지의 역할은 인자·환경변수에서만 온다 — bin/mcp.ts 와 같은 규칙. 저장소를 적용하지 않는다.
+        role: explicitRole().role ?? null,
+        input: io.stdin,
+        output: io.stdout,
+        errorOutput: io.stderr
+      });
+      return 0;
+    }
+    if (domain === "init") {
+      return await executeInitCommand({
+        argv: parsed.positionals.slice(1),
+        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: `${PACKAGE_NAME} ${CLI_VERSION}`,
+        cwd: process.cwd(),
+        json: parsed.json,
+        io
+      });
+    }
+    if (domain === "auth") {
+      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,
+        client,
+        json: parsed.json,
+        io
+      });
+    }
+    const generatedResult = await executeGeneratedCommand({
+      tools: routeTools,
+      argv: parsed.positionals,
+      client,
+      json: parsed.json,
+      io
+    });
+    if (generatedResult !== 2) {
+      return generatedResult;
+    }
+    if (domain === "tools") {
+      return await handleTools(action, rest, parsed, client, io);
+    }
+    throw new Error(`Unknown command "${domain}".`);
+  } catch (error) {
+    io.stderr.write(renderError(error, { json: parsed.json }));
+    return 1;
+  }
+}
+async function commandRole(explicit, cwd) {
+  const explicitRole = explicit.role ?? null;
+  const found = await findRepositoryRole(cwd);
+  if (found.kind === "conflict") {
+    throw new Error(await askTheUserToFixRole(found.dir, found.reason));
+  }
+  if (found.kind === "none") {
+    return explicitRole;
+  }
+  if (explicitRole !== null && explicitRole !== found.role) {
+    const given = explicit.source === "env" ? `${explicit.envVar}=${explicitRole}` : `--role ${explicitRole}`;
+    throw new Error(
+      `This repository's AI sessions have the role ${found.role} (set in ${found.dir}). ${given} does not match \u2014 the role changes only with \`ainecto init --role <role>\`, after asking the user.`
+    );
+  }
+  return found.role;
+}
+async function handleAuth(action, auth, endpoint, json, io) {
+  if (action === "login") {
+    await auth.login();
+    io.stdout.write(renderSuccess({ ...await nextStep(), endpoint, authenticated: true }, { json }));
+    return 0;
+  }
+  if (action === "status") {
+    const token = await auth.getAccessToken();
+    io.stdout.write(renderSuccess({ ...await nextStep(), endpoint, authenticated: Boolean(token) }, { json }));
+    return 0;
+  }
+  if (action === "logout") {
+    await auth.logout();
+    io.stdout.write(renderSuccess({ endpoint, authenticated: false }, { json }));
+    return 0;
+  }
+  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();
+    io.stdout.write(renderSuccess(tools, { json: parsed.json }));
+    return 0;
+  }
+  if (action === "call") {
+    const toolName = rest[0];
+    if (!toolName) {
+      throw new Error("Expected MCP tool name after tools call.");
+    }
+    const toolArgs = rest.slice(1);
+    const payloadOptions = parsePayloadArgs(toolArgs);
+    const payload = await parsePayloadSource({
+      file: payloadOptions.file,
+      inline: payloadOptions.inline,
+      stdin: io.stdin
+    });
+    const result = await client.toolsCall(toolName, payload.value);
+    io.stdout.write(renderSuccess(result, { json: parsed.json, warnings: payload.warnings }));
+    return isToolError(result) ? 1 : 0;
+  }
+  throw new Error("Expected tools list, tools call <mcpName>, or tools catalog.");
+}
+function parseGlobalArgs(argv) {
+  const result = { json: false, help: false, version: false, positionals: [] };
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (!arg) {
+      continue;
+    }
+    if (arg === "--env") {
+      result.env = assertEnv(requireValue4(arg, argv[++index]));
+    } else if (arg === "--endpoint") {
+      result.endpoint = requireValue4(arg, argv[++index]);
+    } else if (arg === "--role") {
+      result.role = assertRole(requireValue4(arg, argv[++index]));
+    } else if (arg === "--json") {
+      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);
+    }
+  }
+  return result;
+}
+function parsePayloadArgs(argv) {
+  const result = {};
+  const inline = [];
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (!arg) {
+      continue;
+    }
+    if (arg === "--file" || arg === "-f") {
+      result.file = requireValue4(arg, argv[++index]);
+    } else {
+      inline.push(arg);
+    }
+  }
+  if (inline.length > 0) {
+    result.inline = inline.join(" ");
+  }
+  return result;
+}
+function requireValue4(flag, value) {
+  if (!value || value.startsWith("--")) {
+    throw new Error(`${flag} requires a 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",
+    "",
+    NEXT_STEP_INIT,
+    "",
+    "Usage:",
+    "  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]",
     "  ainecto <generated-command> [flags] [-f payload.json] [--yes] [--json]",
-    "  ainecto mcp [--env prod|dev] [--endpoint URL]",
+    "  ainecto mcp [--env prod|dev] [--endpoint URL] [--role design|development|test|validation]",
+    "",
+    "Harness:",
+    "  ainecto init [--role <design|development|test|validation>] [--project <uuid>] [--dry-run]",
+    "      In a terminal, asks for the role and project when they are not given.",
+    "  ainecto init --undo",
+    "",
+    "`ai-erd` (the older name) is the same command and still works.",
     ""
   ].join("\n");
 }