ainecto 0.6.0 → 0.8.0

package/dist/bin/ainecto.js

@@ -5,34 +5,6 @@ import { createHash } from "crypto";
 import { mkdir, readFile, rename, rm, stat, writeFile, chmod } from "fs/promises";
 import { homedir } from "os";
 import { dirname, join } from "path";
-
-// src/core/harness/role.ts
-var HARNESS_ROLES = ["design", "development", "test", "validation"];
-var ROLE_SCOPE_PREFIX = "ainecto:role:";
-var ROLE_HEADER = "X-AiNecto-Role";
-var ROLE_ENV_VAR = "AINECTO_ROLE";
-function resolveRole(input = {}) {
-  if (input.role !== void 0) {
-    return { role: assertRole(input.role), source: "flag" };
-  }
-  const envVars = input.envVars ?? process.env;
-  const fromEnv = envVars[ROLE_ENV_VAR];
-  if (fromEnv && fromEnv.trim()) {
-    return { role: assertRole(fromEnv), source: "env" };
-  }
-  return { source: "none" };
-}
-function assertRole(value) {
-  const normalized = value.trim().toLowerCase();
-  if (HARNESS_ROLES.includes(normalized)) {
-    return normalized;
-  }
-  throw new Error(
-    `Invalid role "${value}". Expected one of: ${HARNESS_ROLES.join(", ")}.`
-  );
-}
-
-// src/core/auth/tokenStore.ts
 var FileTokenStore = class {
   filePath;
   constructor(rootDir = join(homedir(), ".ainecto")) {
@@ -43,7 +15,6 @@ 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);
@@ -88,13 +59,6 @@ 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;
 }
@@ -176,6 +140,9 @@ function assertEnv(value) {
   }
   throw new Error(`Invalid --env value "${value}". Expected "prod" or "dev".`);
 }
+function profileSettingsUrl(endpoint) {
+  return `${new URL(endpoint).origin}/home/settings`;
+}
 
 // src/core/auth/clientRegistration.ts
 async function registerPublicClient(registrationEndpoint, redirectUri, fetchImpl = fetch) {
@@ -614,12 +581,28 @@ async function readAllStdin(stdin) {
   return text;
 }
 
+// src/core/harness/legacyRole.ts
+var LEGACY_ROLE_HEADER = "X-AiNecto-Role";
+var LEGACY_ROLE_ENV_VAR = "AINECTO_ROLE";
+var LEGACY_ROLE_NOTICE = "AiNecto session roles were removed; access follows your AiNecto permissions. Re-run `ainecto init` to tidy this repository.";
+function legacyRoleInput(flag, envVars = process.env) {
+  const value = flag ?? envVars[LEGACY_ROLE_ENV_VAR];
+  return value !== void 0 && value.trim() ? value.trim() : void 0;
+}
+
 // src/core/version.ts
-var CLI_VERSION = true ? "0.6.0" : "dev";
+var UNBUNDLED_VERSION = "dev";
+var CLI_VERSION = true ? "0.8.0" : UNBUNDLED_VERSION;
 var PACKAGE_NAME = "@ainecto/mcp";
 var CLI_USER_AGENT = `${PACKAGE_NAME} ${CLI_VERSION}`;
+function bridgePackageSpec(version = CLI_VERSION) {
+  return version === UNBUNDLED_VERSION ? PACKAGE_NAME : `${PACKAGE_NAME}@${version}`;
+}
 
 // src/core/mcp/rpcClient.ts
+var CHANNEL_HEADER = "X-AiNecto-Channel";
+var AGENT_HEADER = "X-AiNecto-Agent";
+var MAX_AGENT_NAME_LENGTH = 100;
 var McpRpcError = class extends Error {
   constructor(message, code, details) {
     super(message);
@@ -637,6 +620,14 @@ var McpRpcClient = class {
   options;
   fetchImpl;
   nextId = 1;
+  agent;
+  /**
+   * 브리지 전용 — 호스트 에이전트가 보낸 {@code initialize} 의 {@code clientInfo.name}(프로그램 고정 이름).
+   * 이후 모든 요청의 {@code X-AiNecto-Agent} 헤더로 싣는다. 직접 명령은 부르지 않는다(누가 셸을 돌렸는지 모른다).
+   */
+  useAgent(clientName) {
+    this.agent = agentHeaderValue(clientName);
+  }
   initialize() {
     return this.request("initialize", {
       protocolVersion: "2024-11-05",
@@ -706,8 +697,13 @@ var McpRpcClient = class {
     if (token) {
       headers.authorization = `Bearer ${token}`;
     }
-    if (this.options.role) {
-      headers[ROLE_HEADER.toLowerCase()] = this.options.role;
+    const legacyRole = printableHeaderValue(this.options.legacyRole);
+    if (legacyRole) {
+      headers[LEGACY_ROLE_HEADER.toLowerCase()] = legacyRole;
+    }
+    headers[CHANNEL_HEADER.toLowerCase()] = this.options.channel;
+    if (this.agent) {
+      headers[AGENT_HEADER.toLowerCase()] = this.agent;
     }
     return this.fetchImpl(this.options.endpoint, {
       method: "POST",
@@ -719,6 +715,16 @@ var McpRpcClient = class {
 function isToolError(result) {
   return isRecord2(result) && result.isError === true;
 }
+function agentHeaderValue(clientName) {
+  return printableHeaderValue(clientName);
+}
+function printableHeaderValue(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const printable = value.replace(/[^\x20-\x7E]/g, "").trim().slice(0, MAX_AGENT_NAME_LENGTH).trim();
+  return printable || void 0;
+}
 function isJsonRpcResponse(value) {
   return isRecord2(value) && value.jsonrpc === "2.0" && ("result" in value || "error" in value);
 }
@@ -816,7 +822,7 @@ function redactSecretString(value) {
 
 // src/core/catalog/generated.prod.ts
 var generatedTools = [
-  { "mcpName": "create_comments", "commandPath": ["comments", "create"], "group": "generic", "description": "Add comments, questions, or replies to a document. Anyone who can read the document may comment and reply. Set parentCommentId to reply to a top-level comment. To mention people, get their userId and displayName from list_mention_candidates, write @<displayName> in the body, and list their userIds in mentionUserIds (clientMutationId is then required). Items are applied in order and each one commits on its own; results report each item (ok, or status and error).", "inputSchema": { "additionalProperties": false, "properties": { "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" }, "items": { "description": "Comments to add, applied in order", "items": { "additionalProperties": false, "properties": { "body": { "description": "Comment text (plain text, 1..10000 characters). To mention someone, include @<displayName> exactly as returned by mcp__ainecto__list_mention_candidates.", "maxLength": 1e4, "minLength": 1, "type": "string" }, "clientMutationId": { "description": "Idempotency key (visible ASCII, at most 128 characters). Required when mentionUserIds is not empty; reuse the same value when retrying the same item so the mention email is not sent twice.", "maxLength": 128, "type": "string" }, "kind": { "description": "Top-level comments only: COMMENT (default) or QUESTION. A QUESTION can later be resolved with mcp__ainecto__resolve_comments.", "enum": ["COMMENT", "QUESTION"], "type": "string" }, "mentionUserIds": { "description": "userIds to mention (from mcp__ainecto__list_mention_candidates). Each one's @<displayName> must appear in body; newly mentioned people get a notification email.", "items": { "type": "string" }, "maxItems": 20, "type": "array", "uniqueItems": true }, "parentCommentId": { "description": "Reply to this top-level comment id (from mcp__ainecto__list_comments). Replies are one level deep: replying to a reply is rejected.", "minimum": 1, "type": "integer" } }, "required": ["body"], "type": "object" }, "minItems": 1, "type": "array" }, "mailLanguage": { "description": "Language of the mention notification email. Defaults to en.", "enum": ["en", "ko"], "type": "string" } }, "required": ["documentUuid", "items"], "type": "object" }, "required": ["documentUuid", "items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "a673b909d16835ef" },
+  { "mcpName": "create_comments", "commandPath": ["comments", "create"], "group": "generic", "description": "Add comments, questions, or replies to a document. Anyone who can read the document may comment and reply. Set parentCommentId to reply to a top-level comment. To mention people, get their userId and displayName from list_mention_candidates, write @<displayName> in the body, and list their userIds in mentionUserIds (clientMutationId is then required). Items are applied in order and each one commits on its own; results report each item (ok, or status and error).", "inputSchema": { "additionalProperties": false, "properties": { "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" }, "items": { "description": "Comments to add, applied in order", "items": { "additionalProperties": false, "properties": { "body": { "description": "Comment text (plain text, 1..10000 characters). To mention someone, include @<displayName> exactly as returned by mcp__ainecto__list_mention_candidates.", "maxLength": 1e4, "minLength": 1, "type": "string" }, "clientMutationId": { "description": "Idempotency key (visible ASCII, at most 128 characters). Required when mentionUserIds is not empty; reuse the same value when retrying the same item so the mention email is not sent twice.", "maxLength": 128, "type": "string" }, "kind": { "description": "Top-level comments only: COMMENT (default) or QUESTION. A QUESTION can later be resolved with mcp__ainecto__resolve_comments.", "enum": ["COMMENT", "QUESTION"], "type": "string" }, "mentionUserIds": { "description": "userIds to mention (from mcp__ainecto__list_mention_candidates). Each one's @<displayName> must appear in body; newly mentioned people get a notification email.", "items": { "type": "string" }, "maxItems": 20, "type": "array", "uniqueItems": true }, "parentCommentId": { "description": "Reply to this top-level comment id (from mcp__ainecto__list_comments). Replies are one level deep: replying to a reply is rejected. The thread's original author and earlier repliers get a notification email (except people mentioned in this reply, who get the mention email instead).", "minimum": 1, "type": "integer" } }, "required": ["body"], "type": "object" }, "minItems": 1, "type": "array" }, "mailLanguage": { "description": "Language of the comment notification email (mention or reply). Defaults to en.", "enum": ["en", "ko"], "type": "string" } }, "required": ["documentUuid", "items"], "type": "object" }, "required": ["documentUuid", "items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "b3ad621ef51c3003" },
   { "mcpName": "create_documents", "commandPath": ["documents", "create"], "group": "document", "description": "Create documents. If a document body is tens of KB or more, prefer request_upload_token (purpose=document.create) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Documents", "items": { "properties": { "body": { "description": "Deprecated compatibility alias for typePayload.body when document type is markdown. \uBCF8\uBB38\uC774 \uC218\uC2ED KB \uC774\uC0C1\uC73C\uB85C \uD06C\uBA74 LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.create)` \uB97C \uD638\uCD9C\uD574 uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C \uC9C1\uC811 PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "folderUuid": { "description": "Optional folder UUID", "type": "string" }, "projectUuid": { "description": "Project UUID", "type": "string" }, "title": { "description": "Document title", "type": "string" }, "type": { "description": "Document type. Creatable values: erd, markdown, diagram, openapi, html, file.", "enum": ["erd", "markdown", "diagram", "openapi", "html", "file"], "type": "string" }, "typePayload": { "description": 'Type-specific payload for enabled document types. markdown: {body}; diagram: {diagramSource,sourceLanguage,edgeStyle,isModule,metadata}; openapi: {content}; html: {content} (a full HTML page); file: no JSON payload \u2014 bytes go through request_upload_token(purpose=document.create, scopeJson={projectUuid,folderUuid?,type:"file",title,filename}) then one curl PUT (images\xB7PDF\xB7mp4/webm\xB7audio\xB7text/code\xB7CSV only).', "type": "object" } }, "required": ["projectUuid", "type", "title"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "aa868b0e2821006a" },
   { "mcpName": "create_folders", "commandPath": ["folders", "create"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Folders", "items": { "properties": { "name": { "description": "Folder name", "type": "string" }, "parentFolderUuid": { "description": "Parent folder UUID", "type": "string" }, "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid", "name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "30f45b887259609f" },
   { "mcpName": "create_projects", "commandPath": ["projects", "create"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Projects", "items": { "properties": { "description": { "description": "Description", "type": "string" }, "name": { "description": "Project name", "type": "string" }, "projectKey": { "description": "Unique project key", "type": "string" }, "workspaceUuid": { "description": "Workspace UUID \u2014 null uses user's default workspace", "type": "string" } }, "required": ["name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "edf5cf688d7c039a" },
@@ -851,15 +857,19 @@ var generatedTools = [
   { "mcpName": "erd_list_tables", "commandPath": ["erd", "list-tables"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "34324dfc7ef461c8" },
   { "mcpName": "get_attachment", "commandPath": ["attachment", "get"], "group": "attachment", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Attachment UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "1e0e7f1bf33b669c" },
   { "mcpName": "get_document", "commandPath": ["document", "get"], "group": "document", "description": "Read a document. The body comes back for the types whose create/update take one: markdown \u2192 content; openapi \u2192 content (the spec text) + format/specVersion/pathCount/operationCount; html \u2192 content (the HTML text); file \u2192 file {filename, contentType, sizeBytes, viewerKind} + content for text/CSV (first 64 KB); diagram \u2192 diagramSource/sourceLanguage/edgeStyle/isModule/metadata; erd \u2192 metadata only (read tables/refs via erd_list_*).", "inputSchema": { "properties": { "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "2efef592c2d6dd7a" },
+  { "mcpName": "get_my_work_summary", "commandPath": ["my-work-summary", "get"], "group": "generic", "description": `One-call summary of what is waiting for the signed-in user in AiNecto \u2014 call it when the user asks things like "do I have anything to do?", "anything new?", "anything to review?" or "did anyone ask me something?". Returns notifications {unread (not yet read by the person, newest 100 counted; unreadCapped when there are more), unreadByKind, newForThisConnection (not yet acknowledged by this connection \u2014 the same number as the line at the end of tool results)}, mentionsToRead {items the person has not read that mention them, each with target title and url}, and todos {open, leaseExpired, inProgress, items: questions and requests waiting for the user's agent}. For details use list_notifications and list_agent_todos; to read the document and its comments use get_document with the target uuid. Read-only: nothing is marked read or acknowledged.`, "inputSchema": { "additionalProperties": false, "properties": { "projectUuid": { "description": "Older single-value form of projectUuids.", "type": "string" }, "projectUuids": { "description": "Only items in any of these projects. Use it when the user names a project or the project you are working in is clear. With workspaceUuids too, both must match. A workspace or project you cannot see matches nothing.", "items": { "type": "string" }, "type": "array", "uniqueItems": true }, "workspaceUuids": { "description": "Only items in any of these workspaces.", "items": { "type": "string" }, "type": "array", "uniqueItems": true } }, "type": "object" }, "required": [], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "bc63904d51058f42" },
   { "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_agent_todos", "commandPath": ["agent-todos", "list"], "group": "generic", "description": "List the to-dos that ask the signed-in user's agent to act now (for example a question that mentions the user). This is the current state, not a feed: a to-do you have not finished comes back on every call until it is completed, dismissed, or closed because the person did it themselves. Each item has todoId, kind, obligation, openedAt, summary, target (title and url), action and state. To work on one, claim it with update_agent_todos and complete it with a one-line note. Actions that affect other people (assigning, approving, inviting) need the user's confirmation first.", "inputSchema": { "additionalProperties": false, "properties": { "after": { "description": "todoId of the last item of the previous page.", "type": "string" }, "kinds": { "description": "Only these kinds.", "items": { "enum": ["COMMENT_MENTIONED", "COMMENT_REPLIED", "QUESTION_ANSWERED", "QUESTION_RESOLVED", "QUESTION_MENTIONED"], "type": "string" }, "type": "array", "uniqueItems": true }, "limit": { "description": "Items per call, default 20.", "maximum": 50, "minimum": 1, "type": "integer" }, "projectUuid": { "description": "Older single-value form of projectUuids.", "type": "string" }, "projectUuids": { "description": "Only to-dos in any of these projects. Use it when the user names a project or the project you are working in is clear. With workspaceUuids too, both must match. A workspace or project you cannot see matches nothing.", "items": { "type": "string" }, "type": "array", "uniqueItems": true }, "state": { "description": "OPEN (default): to-dos you can take, including ones whose lease expired. MINE: to-dos currently leased (claimed) and not expired.", "items": { "enum": ["OPEN", "MINE"], "type": "string" }, "type": "array", "uniqueItems": true }, "workspaceUuids": { "description": "Only to-dos in any of these workspaces.", "items": { "type": "string" }, "type": "array", "uniqueItems": true } }, "type": "object" }, "required": [], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "9c228a3044a546cf" },
   { "mcpName": "list_attachments", "commandPath": ["attachments", "list"], "group": "attachment", "description": "", "inputSchema": { "properties": { "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid"], "type": "object" }, "required": ["projectUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "fae7152d1e4a930b" },
   { "mcpName": "list_comments", "commandPath": ["comments", "list"], "group": "generic", "description": "List the active comments on a document, oldest first, including replies (a reply has parentCommentId set; replies are one level deep). Each comment has id, kind (COMMENT or QUESTION), body, author, mentions (userId, label and position in the body), and for questions questionState (UNANSWERED, ANSWERED, RESOLVED) and resolvedAt. Anyone who can read the document can list its comments.", "inputSchema": { "additionalProperties": false, "properties": { "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4c60115a00f61404" },
   { "mcpName": "list_documents", "commandPath": ["documents", "list"], "group": "document", "description": "", "inputSchema": { "properties": { "folderUuid": { "description": "Optional folder UUID", "type": "string" }, "limit": { "description": "Result cap when q is set (default 50)", "type": "integer" }, "projectUuid": { "description": "Project UUID", "type": "string" }, "q": { "description": "Optional full-text query. When provided, results come from the search index instead of folder listing.", "type": "string" }, "type": { "description": "Optional document type filter. Readable values: erd, markdown, diagram, openapi, html, file.", "enum": ["erd", "markdown", "diagram", "openapi", "html", "file"], "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "2171496b44dc2abf" },
   { "mcpName": "list_folders", "commandPath": ["folders", "list"], "group": "generic", "description": "", "inputSchema": { "properties": { "projectUuid": { "description": "Project UUID", "type": "string" } }, "required": ["projectUuid"], "type": "object" }, "required": ["projectUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "461dc6735ac92c3b" },
+  { "mcpName": "list_history", "commandPath": ["history", "list"], "group": "generic", "description": "List recent activity (who did what, people and agents) in a workspace, a project, or on one resource, newest first. Give at least one of workspaceUuid, projectUuid, or resourceType with resourceUuid; you need editor access or higher in that scope. This is a list to refresh, not a gap-free feed: to see what is new, read the first page again and skip ids you have already seen; to get each new notification exactly once use list_notifications. Each item has id, kind, at, lastAt, coalesceCount, actor, target (title and url only when you can read it now), changes and summary.", "inputSchema": { "additionalProperties": false, "properties": { "actorType": { "description": "Only people (USER) or only agents (AGENT).", "enum": ["USER", "AGENT"], "type": "string" }, "before": { "description": "nextCursor of the previous page (older items).", "type": "string" }, "kinds": { "description": "Only these kinds.", "items": { "enum": ["COMMENT_MENTIONED", "COMMENT_REPLIED", "QUESTION_ANSWERED", "QUESTION_RESOLVED", "QUESTION_MENTIONED"], "type": "string" }, "type": "array", "uniqueItems": true }, "limit": { "description": "Items per call, default 20.", "maximum": 50, "minimum": 1, "type": "integer" }, "projectUuid": { "description": "Activity in this project.", "type": "string" }, "resourceType": { "description": "With resourceUuid: activity on one resource.", "enum": ["DOCUMENT", "PROJECT"], "type": "string" }, "resourceUuid": { "description": "UUID of the resource named by resourceType.", "type": "string" }, "workspaceUuid": { "description": "Activity in this workspace.", "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "235832683071654b" },
   { "mcpName": "list_mention_candidates", "commandPath": ["mention-candidates", "list"], "group": "generic", "description": "List the people you can mention in comments on a document: userId and displayName. Only people who can read the document are listed. To mention someone, write @<displayName> exactly in the comment body and pass their userId in mentionUserIds of create_comments or update_comments. Page with nextCursor while hasMore is true.", "inputSchema": { "additionalProperties": false, "properties": { "cursor": { "description": "nextCursor from the previous page (same documentUuid and query).", "type": "string" }, "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" }, "limit": { "description": "Page size, 1..50. Defaults to 20.", "maximum": 50, "minimum": 1, "type": "integer" }, "query": { "description": "Name filter, 0..100 characters. Omit or leave empty for the first page of everyone.", "maxLength": 100, "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "896a5a6ff357268b" },
+  { "mcpName": "list_notifications", "commandPath": ["notifications", "list"], "group": "generic", "description": "Read new notifications for the signed-in user, oldest first and without gaps \u2014 for an agent that checks the inbox periodically. The server remembers, per connection and per filter (kinds, workspaceUuids, projectUuids, directOnly), how far you have acknowledged; a new filter starts from now. Each response carries ackToken: pass it as ack in your next call (with the same filter) after you have handled the batch \u2014 if you do not, the next call returns the same batch again (identify duplicates by id and seq; an item that comes back with a higher seq and a larger groupCount is an update of the same entry). Each item has id, seq, kind, at, summary (one line), actor, target (title and url only when you can read it now), action (what the user is asked to do) and humanRead. An item you can no longer read comes back as {id, seq, at, redacted: true}. This tool never marks anything read for the person; open to-dos are in list_agent_todos. Calls closer than 30 seconds apart (except a call that carries ack) return retryAfterSeconds instead of items.", "inputSchema": { "additionalProperties": false, "properties": { "ack": { "description": "The ackToken of the previous response. Send it with the same filter once you have handled (or safely stored) that batch; only then does the saved position move past it. Without it, the same batch is returned again.", "type": "string" }, "cursor": { "description": 'Where to read from. "saved" (default): after what this connection last acknowledged for this same filter. "latest": from now on (moves the saved position to now). "earliest": everything still kept (90 days). Or a nextCursor from a previous response: read after it without using or changing the saved position.', "type": "string" }, "directOnly": { "description": "Only notifications that point at you directly (mentions, questions to you).", "type": "boolean" }, "kinds": { "description": "Only these notification kinds.", "items": { "enum": ["COMMENT_MENTIONED", "COMMENT_REPLIED", "QUESTION_ANSWERED", "QUESTION_RESOLVED", "QUESTION_MENTIONED"], "type": "string" }, "type": "array", "uniqueItems": true }, "limit": { "description": "Items per call, default 20.", "maximum": 50, "minimum": 1, "type": "integer" }, "projectUuid": { "description": "Older single-value form of projectUuids.", "type": "string" }, "projectUuids": { "description": "Only notifications in any of these projects. Use it when the user names a project or the project you are working in is clear. With workspaceUuids too, both must match. A workspace or project you cannot see matches nothing.", "items": { "type": "string" }, "type": "array", "uniqueItems": true }, "workspaceUuids": { "description": "Only notifications in any of these workspaces.", "items": { "type": "string" }, "type": "array", "uniqueItems": true } }, "type": "object" }, "required": [], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "0c2bb3fdc8291b03" },
   { "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" },
@@ -877,7 +887,8 @@ var generatedTools = [
   { "mcpName": "unarchive_folders", "commandPath": ["folders", "unarchive"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Folder UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "2a24cc44696b7906" },
   { "mcpName": "unarchive_projects", "commandPath": ["projects", "unarchive"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Project UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "6925e444671afe19" },
   { "mcpName": "unarchive_workspaces", "commandPath": ["workspaces", "unarchive"], "group": "workspace", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Workspace UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "8dafe9bc6378c3f2" },
-  { "mcpName": "update_comments", "commandPath": ["comments", "update"], "group": "generic", "description": "Edit your own comments on a document. Only the author can edit, and only while they can still read the document. A resolved question and a top-level comment that already has replies are locked. Items are applied in order and each one commits on its own; results report each item.", "inputSchema": { "additionalProperties": false, "properties": { "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" }, "items": { "description": "Edits, applied in order", "items": { "additionalProperties": false, "properties": { "body": { "description": "New comment text (replaces the old text).", "maxLength": 1e4, "minLength": 1, "type": "string" }, "clientMutationId": { "description": "Idempotency key (visible ASCII, at most 128 characters). Required when mentionUserIds is not empty; reuse the same value when retrying the same item so the mention email is not sent twice.", "maxLength": 128, "type": "string" }, "id": { "description": "Comment id (from mcp__ainecto__list_comments)", "minimum": 1, "type": "integer" }, "mentionUserIds": { "description": "The complete set of userIds mentioned after the edit; omit to remove all mentions. Each one's @<displayName> must appear in body. Only people who were not mentioned before get a notification email.", "items": { "type": "string" }, "maxItems": 20, "type": "array", "uniqueItems": true } }, "required": ["id", "body"], "type": "object" }, "minItems": 1, "type": "array" }, "mailLanguage": { "description": "Language of the mention notification email. Defaults to en.", "enum": ["en", "ko"], "type": "string" } }, "required": ["documentUuid", "items"], "type": "object" }, "required": ["documentUuid", "items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "fa37fedfdebd8d54" },
+  { "mcpName": "update_agent_todos", "commandPath": ["agent-todos", "update"], "group": "generic", "description": "Claim, renew, complete, release, or dismiss the signed-in user's agent to-dos. Only the session holding the current leaseToken may renew, release, or complete a claimed to-do \u2014 even another session of the same connection gets CLAIMED_BY_OTHER. Results are per item: {todoId, ok: true, state, leaseToken?, claimExpiresAt?} or {todoId, ok: false, error} with error one of CLAIMED_BY_OTHER, LEASE_LOST, ALREADY_DONE, CLOSED_BY_HUMAN, SUPERSEDED, ACCESS_LOST, NOT_FOUND, INVALID \u2014 on CLOSED_BY_HUMAN or SUPERSEDED stop working on it. Retrying the same complete or dismiss returns ok again. There is no tool to mark the person's notifications read.", "inputSchema": { "additionalProperties": false, "properties": { "items": { "description": "To-dos to update; each item is applied and reported on its own.", "items": { "additionalProperties": false, "properties": { "action": { "description": "claim: take it (returns leaseToken, valid 30 minutes). renew: extend your lease. complete: done (with leaseToken if you claimed it; without one only while it is still OPEN). release: give it back. dismiss: not a to-do.", "enum": ["claim", "renew", "complete", "release", "dismiss"], "type": "string" }, "leaseToken": { "description": "Required for renew and release, and for complete or dismiss of a to-do you claimed.", "type": "string" }, "note": { "description": "For complete or dismiss: one line on what you did (at most 500 characters, no document bodies). The person sees it in the inbox.", "maxLength": 500, "type": "string" }, "todoId": { "description": "todoId from list_agent_todos.", "type": "string" } }, "required": ["todoId", "action"], "type": "object" }, "maxItems": 50, "minItems": 1, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "da38f4f54f68dbce" },
+  { "mcpName": "update_comments", "commandPath": ["comments", "update"], "group": "generic", "description": "Edit your own comments on a document. Only the author can edit, and only while they can still read the document. A resolved question and a top-level comment that already has replies are locked. Items are applied in order and each one commits on its own; results report each item.", "inputSchema": { "additionalProperties": false, "properties": { "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" }, "items": { "description": "Edits, applied in order", "items": { "additionalProperties": false, "properties": { "body": { "description": "New comment text (replaces the old text).", "maxLength": 1e4, "minLength": 1, "type": "string" }, "clientMutationId": { "description": "Idempotency key (visible ASCII, at most 128 characters). Required when mentionUserIds is not empty; reuse the same value when retrying the same item so the mention email is not sent twice.", "maxLength": 128, "type": "string" }, "id": { "description": "Comment id (from mcp__ainecto__list_comments)", "minimum": 1, "type": "integer" }, "mentionUserIds": { "description": "The complete set of userIds mentioned after the edit; omit to remove all mentions. Each one's @<displayName> must appear in body. Only people who were not mentioned before get a notification email.", "items": { "type": "string" }, "maxItems": 20, "type": "array", "uniqueItems": true } }, "required": ["id", "body"], "type": "object" }, "minItems": 1, "type": "array" }, "mailLanguage": { "description": "Language of the comment notification email (mention or reply). Defaults to en.", "enum": ["en", "ko"], "type": "string" } }, "required": ["documentUuid", "items"], "type": "object" }, "required": ["documentUuid", "items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "3c13611a49c95979" },
   { "mcpName": "update_documents", "commandPath": ["documents", "update"], "group": "document", "description": "Update documents. If a replacement body is tens of KB or more, prefer request_upload_token (purpose=document.update) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "body": { "description": "Deprecated compatibility alias for typePayload.body when document type is markdown. \uBCF8\uBB38\uC774 \uC218\uC2ED KB \uC774\uC0C1\uC73C\uB85C \uD06C\uBA74 LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.update)` \uB97C \uD638\uCD9C\uD574 uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C \uC9C1\uC811 PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "title": { "description": "New title", "type": "string" }, "typePayload": { "description": "Type-specific payload for enabled document types. markdown: {body}; diagram: {diagramSource,sourceLanguage,edgeStyle,isModule,metadata}; openapi: {content}; html: {content} (a full HTML page); file: {file:{filename,contentType,sizeBytes,viewerKind}} (+content for text/CSV, first 64 KB).", "type": "object" }, "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "c2088f9ef5b49c6c" },
   { "mcpName": "update_folders", "commandPath": ["folders", "update"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "name": { "description": "New name", "type": "string" }, "uuid": { "description": "Folder UUID", "type": "string" } }, "required": ["uuid", "name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "43c58a96ee632b5f" },
   { "mcpName": "update_projects", "commandPath": ["projects", "update"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "description": { "description": "New description", "type": "string" }, "name": { "description": "New name", "type": "string" }, "uuid": { "description": "Project UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "7d849ef0a830aa8c" },
@@ -887,92 +898,81 @@ var generatedTools = [
 
 // src/core/catalog/generated.dev.ts
 var generatedTools2 = [
-  { "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, diagram, markdown, testcase, task.", "enum": ["erd", "diagram", "markdown", "testcase", "task"], "type": "string" }, "typePayload": { "description": "Type-specific payload for enabled document types. markdown: {body}; diagram: {diagramSource,sourceLanguage,edgeStyle,isModule,metadata}; testcase: {defaultEnvironment (max 50 chars), defaultTestAccount (max 100 chars)}; task: no typePayload; board and default statuses are seeded automatically.", "type": "object" } }, "required": ["projectUuid", "type", "title"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "6abbab093274fceb" },
-  { "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "schemaHash": "2aca644f7a105b06" },
-  { "mcpName": "mcp__ainecto__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" }, "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" } }, "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": "dev", "schemaHash": "1c87428fea4bb77a" },
-  { "mcpName": "mcp__ainecto__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": "dev", "schemaHash": "b147277e74d3b0f7" },
-  { "mcpName": "mcp__ainecto__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": "dev", "schemaHash": "4516fc00303ab8db" },
-  { "mcpName": "mcp__ainecto__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": "dev", "schemaHash": "20f370ff4438c4b0" },
-  { "mcpName": "mcp__ainecto__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": "dev", "schemaHash": "0ec4dd6d61584a98" },
-  { "mcpName": "mcp__ainecto__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": "dev", "schemaHash": "fee200dd1433daf9" },
-  { "mcpName": "mcp__ainecto__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": "dev", "schemaHash": "852a19cda307f863" },
-  { "mcpName": "mcp__ainecto__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": "dev", "schemaHash": "a8c41752151ade3e" },
-  { "mcpName": "mcp__ainecto__diagram_submit_llm_result", "commandPath": ["tools", "run", "diagram-submit-llm-result"], "group": "generic", "description": "", "inputSchema": { "properties": { "creditsCharged": { "description": "Deprecated; ignored. Credits are calculated server-side from tokens.", "type": "integer" }, "inputTokens": { "description": "Input token count", "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": "dev", "schemaHash": "374654baa87c1bb8" },
-  { "mcpName": "mcp__ainecto__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": "dev", "schemaHash": "25537b63698bc33d" },
-  { "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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, diagram, markdown, testcase, task.", "enum": ["erd", "diagram", "markdown", "testcase", "task"], "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "schemaHash": "e5d92431322ac0e3" },
-  { "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": "dev", "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": "dev", "schemaHash": "9174d6965d7e53f5" },
-  { "mcpName": "mcp__ainecto__list_trash", "commandPath": ["trash", "list"], "group": "generic", "description": "", "inputSchema": { "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "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": "dev", "schemaHash": "370e4b8b8ec18e18" },
-  { "mcpName": "mcp__ainecto__list_workspaces", "commandPath": ["workspaces", "list"], "group": "workspace", "description": "", "inputSchema": { "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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, diagram, markdown, testcase, task. 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": "dev", "schemaHash": "cc5db0cc4a9d9603" },
-  { "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": "dev", "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, diagram, markdown, testcase, task.", "enum": ["erd", "diagram", "markdown", "testcase", "task"], "type": "string" } }, "required": ["q"], "type": "object" }, "required": ["q"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "schemaHash": "89efa02eab3c01a1" },
-  { "mcpName": "mcp__ainecto__task_apply_changes", "commandPath": ["task", "apply-changes"], "group": "task", "description": "Task CUD entry point. Applies one atomic batch using operation objects shaped exactly as {op, uuid, data}. There is no partial success mode; any validation failure aborts the whole batch.", "inputSchema": { "examples": [{ "baseRevision": 1, "clientMutationId": "task-mutation-1", "documentUuid": "task-document-uuid", "operations": [{ "data": { "parentTaskUuid": null, "title": "Task title" }, "op": "create_task", "uuid": "client-task-uuid" }] }], "properties": { "baseRevision": { "description": "Current board revision from task_get_snapshot", "type": "integer" }, "clientMutationId": { "description": "Optional idempotency key. Visible ASCII, 1-128 chars; will become required in a later phase.", "maxLength": 128, "minLength": 1, "pattern": "^[\\x21-\\x7E]{1,128}$", "type": "string" }, "documentUuid": { "description": "Task document UUID", "type": "string" }, "operations": { "description": "Atomic batch. No partial success mode; validation failure aborts all operations.", "items": { "additionalProperties": false, "properties": { "data": { "description": "Operation payload. Keep all operation-specific fields inside data.", "type": "object" }, "op": { "description": "Operation type", "enum": ["create_task", "update_task", "archive_task", "restore_task", "move_task", "transition_task", "assign_task", "schedule_task", "set_progress"], "type": "string" }, "uuid": { "description": "Task UUID. For create_task this is the client-generated UUID.", "type": "string" } }, "required": ["op", "uuid", "data"], "type": "object" }, "type": "array" } }, "required": ["documentUuid", "baseRevision", "operations"], "type": "object" }, "required": ["baseRevision", "documentUuid", "operations"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "085eb6e8a3eae2c8" },
-  { "mcpName": "mcp__ainecto__task_get_snapshot", "commandPath": ["task", "get-snapshot"], "group": "task", "description": "Get one Task document snapshot. Returns board revision, statuses, tasks, member summaries, and permissions. Use before mutations to obtain baseRevision.", "inputSchema": { "properties": { "documentUuid": { "description": "Task document UUID", "type": "string" }, "includeArchived": { "description": "Whether to include archived tasks", "type": "boolean" }, "limit": { "description": "Maximum tasks to return; defaults to server snapshot cap", "type": "integer" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "schemaHash": "a11876f9b475338a" },
-  { "mcpName": "mcp__ainecto__task_get_task", "commandPath": ["task", "get-task"], "group": "task", "description": "Get one task by UUID from a Task document.", "inputSchema": { "properties": { "documentUuid": { "description": "Task document UUID", "type": "string" }, "taskUuid": { "description": "Task UUID", "type": "string" } }, "required": ["documentUuid", "taskUuid"], "type": "object" }, "required": ["documentUuid", "taskUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "schemaHash": "96b1ea530c583337" },
-  { "mcpName": "mcp__ainecto__task_list_statuses", "commandPath": ["task", "list-statuses"], "group": "task", "description": "List statuses for a Task document. Status slug is intentionally not returned.", "inputSchema": { "properties": { "documentUuid": { "description": "Task document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "schemaHash": "864ea509c54fe2e7" },
-  { "mcpName": "mcp__ainecto__task_list_tasks", "commandPath": ["task", "list-tasks"], "group": "task", "description": "List tasks in a Task document with optional parent/status/assignee filters.", "inputSchema": { "properties": { "assigneeUserId": { "description": "Optional assignee user id filter", "type": "string" }, "documentUuid": { "description": "Task document UUID", "type": "string" }, "includeArchived": { "description": "Whether to include archived tasks", "type": "boolean" }, "limit": { "description": "Maximum tasks to return", "type": "integer" }, "parentTaskUuid": { "description": "Optional parent filter", "type": "string" }, "statusUuid": { "description": "Optional status filter", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "schemaHash": "be8dc0a4ecd117a8" },
-  { "mcpName": "mcp__ainecto__testcase_archive_scenarios", "commandPath": ["testcase", "archive-scenarios"], "group": "testcase", "description": "", "inputSchema": { "properties": { "ids": { "description": "Scenario ids", "items": { "type": "integer" }, "type": "array" } }, "required": ["ids"], "type": "object" }, "required": ["ids"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "a5a8768d14ebaed7" },
-  { "mcpName": "mcp__ainecto__testcase_complete_runs", "commandPath": ["testcase", "complete-runs"], "group": "testcase", "description": "", "inputSchema": { "properties": { "ids": { "description": "Run ids", "items": { "type": "integer" }, "type": "array" } }, "required": ["ids"], "type": "object" }, "required": ["ids"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "84bc3dad482ac61a" },
-  { "mcpName": "mcp__ainecto__testcase_create_runs", "commandPath": ["testcase", "create-runs"], "group": "testcase", "description": "", "inputSchema": { "properties": { "items": { "description": "Runs", "items": { "properties": { "buildVersion": { "description": "Build version", "type": "string" }, "description": { "description": "Description", "type": "string" }, "environment": { "description": "Environment", "type": "string" }, "name": { "description": "Run name", "type": "string" }, "projectId": { "description": "Project id", "type": "integer" }, "testAccount": { "description": "SUT test account", "type": "string" }, "testCaseIds": { "description": "Test case ids to attach", "items": { "type": "integer" }, "type": "array" } }, "required": ["projectId", "name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "6a08117c79f589a1" },
-  { "mcpName": "mcp__ainecto__testcase_create_scenarios", "commandPath": ["testcase", "create-scenarios"], "group": "testcase", "description": "", "inputSchema": { "properties": { "items": { "description": "Scenarios", "items": { "properties": { "description": { "description": "Description", "type": "string" }, "documentUuid": { "description": "Parent testcase document UUID", "type": "string" }, "name": { "description": "Scenario name", "type": "string" }, "parentId": { "description": "Parent scenario id", "type": "integer" } }, "required": ["documentUuid", "name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "4686fd0f078a65e8" },
-  { "mcpName": "mcp__ainecto__testcase_create_testcases", "commandPath": ["testcase", "create-testcases"], "group": "testcase", "description": "", "inputSchema": { "properties": { "items": { "description": "Testcases", "items": { "properties": { "assigneeId": { "description": "Assignee user id", "type": "string" }, "expectedResult": { "description": "Expected result", "type": "string" }, "precondition": { "description": "Precondition", "type": "string" }, "priority": { "description": "Priority", "enum": ["LOW", "MEDIUM", "HIGH", "CRITICAL"], "type": "string" }, "scenarioId": { "description": "Scenario id (required)", "type": "integer" }, "source": { "description": "Source", "enum": ["MANUAL", "AI", "IMPORT", "MCP"], "type": "string" }, "status": { "description": "Status", "enum": ["DRAFT", "READY", "DEPRECATED"], "type": "string" }, "tags": { "description": "Tags", "type": "string" }, "testAccount": { "description": "SUT test account", "type": "string" }, "title": { "description": "Title", "type": "string" }, "type": { "description": "Type", "enum": ["FUNCTIONAL", "REGRESSION", "SMOKE", "PERFORMANCE", "SECURITY", "E2E", "UNIT", "INTEGRATION"], "type": "string" } }, "required": ["scenarioId", "title"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "ae90d4749debacf0" },
-  { "mcpName": "mcp__ainecto__testcase_delete_runs", "commandPath": ["testcase", "delete-runs"], "group": "testcase", "description": "", "inputSchema": { "properties": { "ids": { "description": "Run ids", "items": { "type": "integer" }, "type": "array" } }, "required": ["ids"], "type": "object" }, "required": ["ids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "dev", "schemaHash": "1ba26baf794bde57" },
-  { "mcpName": "mcp__ainecto__testcase_delete_testcases", "commandPath": ["testcase", "delete-testcases"], "group": "testcase", "description": "", "inputSchema": { "properties": { "ids": { "description": "Testcase ids", "items": { "type": "integer" }, "type": "array" } }, "required": ["ids"], "type": "object" }, "required": ["ids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "dev", "schemaHash": "ab095f553bf46937" },
-  { "mcpName": "mcp__ainecto__testcase_get_run", "commandPath": ["testcase", "get-run"], "group": "testcase", "description": "", "inputSchema": { "properties": { "id": { "description": "Run id", "type": "integer" } }, "required": ["id"], "type": "object" }, "required": ["id"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "schemaHash": "713c83514cf07d68" },
-  { "mcpName": "mcp__ainecto__testcase_get_testcase", "commandPath": ["testcase", "get-testcase"], "group": "testcase", "description": "", "inputSchema": { "properties": { "id": { "description": "Testcase id", "type": "integer" } }, "required": ["id"], "type": "object" }, "required": ["id"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "schemaHash": "54e497a2e3c9978d" },
-  { "mcpName": "mcp__ainecto__testcase_list_executions", "commandPath": ["testcase", "list-executions"], "group": "testcase", "description": "", "inputSchema": { "properties": { "runId": { "description": "Run id", "type": "integer" } }, "required": ["runId"], "type": "object" }, "required": ["runId"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "schemaHash": "a5a2abcf9e43225e" },
-  { "mcpName": "mcp__ainecto__testcase_list_runs", "commandPath": ["testcase", "list-runs"], "group": "testcase", "description": "", "inputSchema": { "properties": { "projectId": { "description": "Project id", "type": "integer" } }, "required": ["projectId"], "type": "object" }, "required": ["projectId"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "schemaHash": "b7d5275b67bb11d9" },
-  { "mcpName": "mcp__ainecto__testcase_list_scenarios", "commandPath": ["testcase", "list-scenarios"], "group": "testcase", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "Parent testcase document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "schemaHash": "2486ade3c9cb0984" },
-  { "mcpName": "mcp__ainecto__testcase_list_step_checks", "commandPath": ["testcase", "list-step-checks"], "group": "testcase", "description": "", "inputSchema": { "properties": { "caseId": { "description": "Testcase id", "type": "integer" }, "runId": { "description": "Run id", "type": "integer" } }, "required": ["runId", "caseId"], "type": "object" }, "required": ["caseId", "runId"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "schemaHash": "f2d5b45c0d64cd5c" },
-  { "mcpName": "mcp__ainecto__testcase_list_testcases", "commandPath": ["testcase", "list-testcases"], "group": "testcase", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "Parent testcase document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "schemaHash": "ef40927392d5a684" },
-  { "mcpName": "mcp__ainecto__testcase_record_executions", "commandPath": ["testcase", "record-executions"], "group": "testcase", "description": "", "inputSchema": { "properties": { "items": { "description": "Executions", "items": { "properties": { "comment": { "description": "Comment", "type": "string" }, "defectLinks": { "description": "Defect URLs", "type": "string" }, "durationSeconds": { "description": "Duration in seconds", "type": "integer" }, "result": { "description": "Result", "enum": ["PASSED", "FAILED", "BLOCKED", "SKIPPED", "UNTESTED", "IN_PROGRESS"], "type": "string" }, "runId": { "description": "Run id", "type": "integer" }, "testAccount": { "description": "SUT account", "type": "string" }, "testCaseId": { "description": "Testcase id", "type": "integer" } }, "required": ["runId", "testCaseId", "result"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "071a2075d00bff9b" },
-  { "mcpName": "mcp__ainecto__testcase_remove_run_cases", "commandPath": ["testcase", "remove-run-cases"], "group": "testcase", "description": "", "inputSchema": { "properties": { "runId": { "description": "Run id", "type": "integer" }, "testCaseIds": { "description": "Testcase ids to remove", "items": { "type": "integer" }, "type": "array" } }, "required": ["runId", "testCaseIds"], "type": "object" }, "required": ["runId", "testCaseIds"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "7aef8a39afe88c5c" },
-  { "mcpName": "mcp__ainecto__testcase_reorder_scenarios", "commandPath": ["testcase", "reorder-scenarios"], "group": "testcase", "description": "", "inputSchema": { "properties": { "ids": { "description": "Scenario ids in new order", "items": { "type": "integer" }, "type": "array" } }, "required": ["ids"], "type": "object" }, "required": ["ids"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "7faf43a0b53c2988" },
-  { "mcpName": "mcp__ainecto__testcase_reorder_testcases", "commandPath": ["testcase", "reorder-testcases"], "group": "testcase", "description": "", "inputSchema": { "properties": { "ids": { "description": "Testcase ids in new order", "items": { "type": "integer" }, "type": "array" } }, "required": ["ids"], "type": "object" }, "required": ["ids"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "5f27d8b94aca5334" },
-  { "mcpName": "mcp__ainecto__testcase_update_runs", "commandPath": ["testcase", "update-runs"], "group": "testcase", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "buildVersion": { "description": "New build version", "type": "string" }, "description": { "description": "New description", "type": "string" }, "environment": { "description": "New environment", "type": "string" }, "id": { "description": "Run id", "type": "integer" }, "name": { "description": "New name", "type": "string" }, "status": { "description": "New status", "enum": ["DRAFT", "IN_PROGRESS", "COMPLETED", "CANCELLED"], "type": "string" }, "testAccount": { "description": "New SUT account", "type": "string" } }, "required": ["id"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "370074b6681d495f" },
-  { "mcpName": "mcp__ainecto__testcase_update_scenarios", "commandPath": ["testcase", "update-scenarios"], "group": "testcase", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "id": { "description": "Scenario id", "type": "integer" }, "name": { "description": "New name", "type": "string" }, "parentId": { "description": "New parent id", "type": "integer" } }, "required": ["id"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "929c8647c06c5fdd" },
-  { "mcpName": "mcp__ainecto__testcase_update_testcases", "commandPath": ["testcase", "update-testcases"], "group": "testcase", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "assigneeId": { "description": "Assignee", "type": "string" }, "expectedResult": { "description": "New expected result", "type": "string" }, "id": { "description": "Testcase id", "type": "integer" }, "precondition": { "description": "New precondition", "type": "string" }, "priority": { "description": "Priority", "enum": ["LOW", "MEDIUM", "HIGH", "CRITICAL"], "type": "string" }, "scenarioId": { "description": "New scenario id", "type": "integer" }, "status": { "description": "Status", "enum": ["DRAFT", "READY", "DEPRECATED"], "type": "string" }, "tags": { "description": "Tags", "type": "string" }, "testAccount": { "description": "SUT account", "type": "string" }, "title": { "description": "New title", "type": "string" }, "type": { "description": "Type", "enum": ["FUNCTIONAL", "REGRESSION", "SMOKE", "PERFORMANCE", "SECURITY", "E2E", "UNIT", "INTEGRATION"], "type": "string" } }, "required": ["id"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "b562a7b860f6036c" },
-  { "mcpName": "mcp__ainecto__testcase_upsert_step_checks", "commandPath": ["testcase", "upsert-step-checks"], "group": "testcase", "description": "", "inputSchema": { "properties": { "caseId": { "description": "Testcase id", "type": "integer" }, "items": { "description": "Step checks", "items": { "properties": { "checked": { "description": "Checked state", "type": "boolean" }, "comment": { "description": "Per-step note", "type": "string" }, "stepId": { "description": "TestStep id", "type": "integer" } }, "required": ["stepId", "checked"], "type": "object" }, "type": "array" }, "runId": { "description": "Run id", "type": "integer" } }, "required": ["runId", "caseId", "items"], "type": "object" }, "required": ["caseId", "items", "runId"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "ac5768125a9fd15c" },
-  { "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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}; diagram: {diagramSource,sourceLanguage,edgeStyle,isModule,metadata}; testcase: {defaultEnvironment (max 50 chars), defaultTestAccount (max 100 chars)}; task: no typePayload; board and default statuses are seeded automatically.", "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": "dev", "schemaHash": "778908eec43aba81" },
-  { "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": "dev", "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": "dev", "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": "dev", "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": "dev", "schemaHash": "0622e590de3404dd" }
+  { "mcpName": "create_comments", "commandPath": ["comments", "create"], "group": "generic", "description": "Add comments, questions, or replies to a document or a kanban card (cardUuid). Anyone who can read it may comment and reply. Set parentCommentId to reply to a top-level comment. To mention people, get their userId and displayName from list_mention_candidates, write @<displayName> in the body, and list their userIds in mentionUserIds (clientMutationId is then required). Items are applied in order and each one commits on its own; results report each item (ok, or status and error).", "inputSchema": { "additionalProperties": false, "properties": { "cardUuid": { "description": "Kanban card UUID the comments belong to (from kanban_list_cards). Anyone who can read the card's board may comment. Give this or documentUuid, not both.", "type": "string" }, "documentUuid": { "description": "Document UUID the comments belong to. Give this or cardUuid, not both.", "type": "string" }, "items": { "description": "Comments to add, applied in order", "items": { "additionalProperties": false, "properties": { "body": { "description": "Comment text (plain text, 1..10000 characters). To mention someone, include @<displayName> exactly as returned by mcp__ainecto__list_mention_candidates.", "maxLength": 1e4, "minLength": 1, "type": "string" }, "clientMutationId": { "description": "Idempotency key (visible ASCII, at most 128 characters). Required when mentionUserIds is not empty; reuse the same value when retrying the same item so the mention email is not sent twice.", "maxLength": 128, "type": "string" }, "kind": { "description": "Top-level comments only: COMMENT (default) or QUESTION. A QUESTION can later be resolved with mcp__ainecto__resolve_comments.", "enum": ["COMMENT", "QUESTION"], "type": "string" }, "mentionUserIds": { "description": "userIds to mention (from mcp__ainecto__list_mention_candidates). Each one's @<displayName> must appear in body; newly mentioned people get a notification email.", "items": { "type": "string" }, "maxItems": 20, "type": "array", "uniqueItems": true }, "parentCommentId": { "description": "Reply to this top-level comment id (from mcp__ainecto__list_comments). Replies are one level deep: replying to a reply is rejected. The thread's original author and earlier repliers get a notification email (except people mentioned in this reply, who get the mention email instead).", "minimum": 1, "type": "integer" } }, "required": ["body"], "type": "object" }, "minItems": 1, "type": "array" }, "mailLanguage": { "description": "Language of the comment notification email (mention or reply). Defaults to en.", "enum": ["en", "ko"], "type": "string" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "d44acdedf00dfe76" },
+  { "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, diagram, markdown, openapi, html, file, kanban.", "enum": ["erd", "diagram", "markdown", "openapi", "html", "file", "kanban"], "type": "string" }, "typePayload": { "description": 'Type-specific payload for enabled document types. markdown: {body}; diagram: {diagramSource,sourceLanguage,edgeStyle,isModule,metadata}; openapi: {content}; html: {content} (a full HTML page); file: no JSON payload \u2014 bytes go through request_upload_token(purpose=document.create, scopeJson={projectUuid,folderUuid?,type:"file",title,filename}) then one curl PUT (images\xB7PDF\xB7mp4/webm\xB7audio\xB7text/code\xB7CSV only); kanban: no payload \u2014 creates an empty board; add cards with kanban_apply_changes.', "type": "object" } }, "required": ["projectUuid", "type", "title"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "65867cbf84bf78a8" },
+  { "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": "dev", "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": "dev", "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": "dev", "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": "dev", "schemaHash": "b22c24bffdfe3d7d" },
+  { "mcpName": "delete_comments", "commandPath": ["comments", "delete"], "group": "generic", "description": "Delete your own comments on a document or a kanban card (cardUuid). Only the author can delete. A resolved question and a top-level comment that still has replies cannot be deleted. Each id is applied on its own; results report each id.", "inputSchema": { "additionalProperties": false, "properties": { "cardUuid": { "description": "Kanban card UUID the comments belong to (from kanban_list_cards). Anyone who can read the card's board may comment. Give this or documentUuid, not both.", "type": "string" }, "documentUuid": { "description": "Document UUID the comments belong to. Give this or cardUuid, not both.", "type": "string" }, "ids": { "description": "Comment ids to delete (from mcp__ainecto__list_comments)", "items": { "minimum": 1, "type": "integer" }, "minItems": 1, "type": "array" } }, "required": ["ids"], "type": "object" }, "required": ["ids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "dev", "schemaHash": "082e4b4d9ba97fe0" },
+  { "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": "dev", "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": "dev", "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": "dev", "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": "dev", "schemaHash": "3177868221137066" },
+  { "mcpName": "diagram_apply_changes", "commandPath": ["tools", "run", "diagram-apply-changes"], "group": "generic", "description": "Required single-call mutation path for diagram node/edge/group create/update/delete changes. Put nodes, edges, and groups in one request and call this once. Do not look for type-specific diagram CUD tools; this tool is the only diagram CUD entry point.", "inputSchema": { "properties": { "description": { "description": "Reason for batch (audit)", "type": "string" }, "diagramUuid": { "description": "Diagram UUID", "type": "string" }, "edges": { "description": "Edge operations", "items": { "properties": { "action": { "description": "Operation kind", "enum": ["create", "update", "delete"], "type": "string" }, "bridgeType": { "description": "Omit (null) for a plain node-to-node edge. Set only when a group is an endpoint: GROUP_TO_GROUP|NODE_TO_GROUP|GROUP_TO_NODE", "enum": ["GROUP_TO_GROUP", "NODE_TO_GROUP", "GROUP_TO_NODE"], "type": "string" }, "fromUuid": { "description": "Source", "type": "string" }, "label": { "description": "Edge label", "type": "string" }, "lineStyle": { "description": "Line style", "type": "string" }, "strokeColor": { "description": "Stroke color", "type": "string" }, "strokeWidth": { "description": "Stroke width", "type": "integer" }, "toUuid": { "description": "Target", "type": "string" }, "uuid": { "description": "Required for update/delete", "type": "string" } }, "required": ["action"], "type": "object" }, "type": "array" }, "groups": { "description": "Group operations", "items": { "properties": { "action": { "description": "Operation kind", "enum": ["create", "update", "delete"], "type": "string" }, "collapsed": { "description": "Collapsed state", "type": "boolean" }, "color": { "description": "Group color", "type": "string" }, "height": { "description": "Explicit height; omit to keep it derived from member nodes", "type": "number" }, "linkMode": { "description": "Link mode", "type": "string" }, "linkedDiagramUuid": { "description": "Linked diagram UUID", "type": "string" }, "name": { "description": "Group name", "type": "string" }, "parentGroupUuid": { "description": "Parent group UUID", "type": "string" }, "sortOrder": { "description": "Sort order", "type": "integer" }, "uuid": { "description": "Required for update/delete", "type": "string" }, "width": { "description": "Explicit width; omit to keep it derived from member nodes", "type": "number" } }, "required": ["action"], "type": "object" }, "type": "array" }, "nodes": { "description": "Node operations", "items": { "properties": { "action": { "description": "Operation kind", "enum": ["create", "update", "delete"], "type": "string" }, "fillColor": { "description": "Fill color", "type": "string" }, "groupUuid": { "description": "Group UUID; empty string clears membership", "type": "string" }, "height": { "description": "Height", "type": "number" }, "shape": { "description": "Node shape (start/end/diamond/cylinder/parallelogram/stadium/hexagon/rect/roundRect/...)", "enum": ["rect", "roundRect", "stadium", "diamond", "decision", "circle", "start", "doubleCircle", "end", "hexagon", "cylinder", "parallelogram"], "type": "string" }, "strokeColor": { "description": "Stroke color", "type": "string" }, "text": { "description": "Node text/label. Supports newlines (\\n) for multi-line display.", "maxLength": 4e3, "type": "string" }, "textColor": { "description": "Text color", "type": "string" }, "type": { "description": "Node type", "type": "string" }, "uuid": { "description": "Required for update/delete; optional for create", "type": "string" }, "width": { "description": "Width", "type": "number" }, "x": { "description": "X", "type": "number" }, "y": { "description": "Y", "type": "number" } }, "required": ["action"], "type": "object" }, "type": "array" } }, "required": ["diagramUuid", "description"], "type": "object" }, "required": ["description", "diagramUuid"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "2c829103f86f4168" },
+  { "mcpName": "diagram_get_edge", "commandPath": ["tools", "run", "diagram-get-edge"], "group": "generic", "description": "", "inputSchema": { "properties": { "edgeUuid": { "description": "Edge UUID", "type": "string" } }, "required": ["edgeUuid"], "type": "object" }, "required": ["edgeUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "schemaHash": "1e0e7f1bf33b669c" },
+  { "mcpName": "get_document", "commandPath": ["document", "get"], "group": "document", "description": "Read a document. The body comes back for the types whose create/update take one: markdown \u2192 content; openapi \u2192 content (the spec text) + format/specVersion/pathCount/operationCount; html \u2192 content (the HTML text); file \u2192 file {filename, contentType, sizeBytes, viewerKind} + content for text/CSV (first 64 KB); diagram \u2192 diagramSource/sourceLanguage/edgeStyle/isModule/metadata; kanban \u2192 board {viewer, columns: each column's first 20 cards + hasMore} (more cards and card details via kanban_list_cards); 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": "dev", "schemaHash": "5c8e9d305fc15c1f" },
+  { "mcpName": "get_my_work_summary", "commandPath": ["my-work-summary", "get"], "group": "generic", "description": `One-call summary of what is waiting for the signed-in user in AiNecto \u2014 call it when the user asks things like "do I have anything to do?", "anything new?", "anything to review?" or "did anyone ask me something?". Returns notifications {unread (not yet read by the person, newest 100 counted; unreadCapped when there are more), unreadByKind, newForThisConnection (not yet acknowledged by this connection \u2014 the same number as the line at the end of tool results)}, mentionsToRead {items the person has not read that mention them, each with target title and url}, and todos {open, leaseExpired, inProgress, items: questions and requests waiting for the user's agent} and cards {kanban cards assigned to the user on boards they can read now: assignedOpen, pendingAcceptance (assigned but not yet accepted or declined), inProgress, inReview, blocked, items: the first page}. For details use list_notifications, list_agent_todos and kanban_list_cards; to read the document and its comments use get_document with the target uuid. Read-only: nothing is marked read or acknowledged.`, "inputSchema": { "additionalProperties": false, "properties": { "projectUuid": { "description": "Older single-value form of projectUuids.", "type": "string" }, "projectUuids": { "description": "Only items in any of these projects. Use it when the user names a project or the project you are working in is clear. With workspaceUuids too, both must match. A workspace or project you cannot see matches nothing.", "items": { "type": "string" }, "type": "array", "uniqueItems": true }, "workspaceUuids": { "description": "Only items in any of these workspaces.", "items": { "type": "string" }, "type": "array", "uniqueItems": true } }, "type": "object" }, "required": [], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "105cc4ba01f785d8" },
+  { "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": "dev", "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": "dev", "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": "dev", "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": "dev", "schemaHash": "f29c86804eb91700" },
+  { "mcpName": "kanban_apply_changes", "commandPath": ["kanban", "apply-changes"], "group": "kanban", "description": "Create, edit, reorder and link cards on one kanban board in a single atomic call (at most 100 operations; if one fails nothing is applied and the error carries operationIndex and code). Creating and editing cards needs edit access to the board; the assignee may also check acceptance criteria and add result links (DELIVERABLE, REVIEW_RESULT, TEST_EVIDENCE). To change a card's column, assign it, accept, approve, block, watch and similar, use kanban_card_action. Results list each operation's card uuid, revision, status and sortKey.", "inputSchema": { "additionalProperties": false, "properties": { "boardUuid": { "description": "Kanban board (document) UUID.", "type": "string" }, "mailLanguage": { "description": "Language of the emails these operations may send (review requests to newly named reviewers). Defaults to en.", "enum": ["en", "ko"], "type": "string" }, "operations": { "description": "Operations, applied in order in one transaction. If any fails, none is applied and the error names operationIndex.", "items": { "additionalProperties": false, "properties": { "afterCardUuid": { "description": "Place after this card in the column (create, move).", "type": "string" }, "beforeCardUuid": { "description": "move: place before this card in the column.", "type": "string" }, "cardType": { "description": "Card type (default TASK).", "enum": ["TASK", "REVIEW", "BUG", "DECISION"], "type": "string" }, "cardUuid": { "description": "Target card (update, move, link, unlink). It must be on this board.", "type": "string" }, "clientMutationId": { "description": "create: idempotency key \u2014 retrying with the same value returns the same card instead of creating another.", "type": "string" }, "criteria": { "description": "Acceptance criteria. update replaces the whole list; the assignee may only flip done.", "items": { "additionalProperties": false, "properties": { "done": { "description": "Checked (default false).", "type": "boolean" }, "text": { "description": "What must be true.", "type": "string" } }, "required": ["text"], "type": "object" }, "type": "array" }, "description": { "description": "Markdown description. Keep it short \u2014 link longer text as a document instead.", "type": "string" }, "documentUuid": { "description": "AiNecto document to link (you must be able to read it). Give this or url.", "type": "string" }, "dueAt": { "description": "Due time, ISO-8601 instant such as 2026-10-31T09:00:00Z.", "type": "string" }, "expectedRevision": { "description": "The card revision you last read. If the card changed since, the whole call fails with CARD_CHANGED and the current card. Send it when people may edit the card too.", "minimum": 0, "type": "integer" }, "label": { "description": "Optional label for an external URL.", "type": "string" }, "linkId": { "description": "unlink: the linkId from the card's links.", "minimum": 1, "type": "integer" }, "linkRole": { "description": "Link role. The assignee may add DELIVERABLE, REVIEW_RESULT and TEST_EVIDENCE links; other roles need edit access to the board.", "enum": ["REQUIREMENT", "REFERENCE", "DELIVERABLE", "REVIEW_RESULT", "DECISION", "TEST_EVIDENCE"], "type": "string" }, "links": { "description": "create only: links to attach.", "items": { "additionalProperties": false, "properties": { "documentUuid": { "description": "AiNecto document to link (you must be able to read it). Give this or url.", "type": "string" }, "label": { "description": "Optional label for an external URL.", "type": "string" }, "linkRole": { "description": "Link role. The assignee may add DELIVERABLE, REVIEW_RESULT and TEST_EVIDENCE links; other roles need edit access to the board.", "enum": ["REQUIREMENT", "REFERENCE", "DELIVERABLE", "REVIEW_RESULT", "DECISION", "TEST_EVIDENCE"], "type": "string" }, "url": { "description": "External http(s) URL to link, e.g. a pull request. Give this or documentUuid.", "type": "string" } }, "required": ["linkRole"], "type": "object" }, "type": "array" }, "op": { "description": "create: a new card in To Do (you become its requester). update: change only the fields you send (send null to clear description, dueAt). move: reorder within the card's column. link / unlink: attach or remove a document or an external URL.", "enum": ["create", "link", "move", "unlink", "update"], "type": "string" }, "priority": { "description": "Priority (default MEDIUM).", "enum": ["LOW", "MEDIUM", "HIGH", "URGENT"], "type": "string" }, "responderIds": { "description": "update only: who should answer while the card is blocked.", "items": { "type": "string" }, "type": "array", "uniqueItems": true }, "reviewerIds": { "description": "Reviewers (userIds from list_mention_candidates with cardUuid or the board's documentUuid). update replaces the whole list.", "items": { "type": "string" }, "type": "array", "uniqueItems": true }, "title": { "description": "Card title (required for create).", "type": "string" }, "url": { "description": "External http(s) URL to link, e.g. a pull request. Give this or documentUuid.", "type": "string" }, "watcherIds": { "description": "Watchers who get activity notifications. update replaces the whole list.", "items": { "type": "string" }, "type": "array", "uniqueItems": true } }, "required": ["op"], "type": "object" }, "maxItems": 100, "minItems": 1, "type": "array" } }, "required": ["boardUuid", "operations"], "type": "object" }, "required": ["boardUuid", "operations"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "77de7bc105852b87" },
+  { "mcpName": "kanban_card_action", "commandPath": ["kanban", "card-action"], "group": "kanban", "description": "Do one workflow action on a kanban card, the same as the buttons in the web app. \u2605Before assign (to someone other than the signed-in user), approve or quick_done, show the user what will happen and get their explicit confirmation \u2014 these change other people's work and notify them. Actions: assign / unassign; accept / decline (only the assignee \u2014 accepting closes the assignment to-do); start (To Do \u2192 In Progress; anyone who can edit the board, or the assignee \u2014 not while an assignment is waiting to be accepted); request_review (\u2192 In Review); approve (\u2192 Done) / request_changes (\u2192 In Progress) by the requester or a reviewer; quick_done (To Do \u2192 Done); reopen (Done \u2192 In Progress); block / unblock; archive / unarchive; set_requester; watch / unwatch (yourself). Doing the action is what closes the matching card to-dos \u2014 update_agent_todos cannot complete them. Returns the card after the action (status, assignment state, allowedActions) and reasonCommentId when a reason was saved.", "inputSchema": { "additionalProperties": false, "properties": { "action": { "description": "The action. Which ones you may do now is the card's allowedActions in kanban_list_cards (with cardUuids).", "enum": ["assign", "unassign", "accept", "decline", "start", "request_review", "approve", "request_changes", "quick_done", "reopen", "block", "unblock", "archive", "unarchive", "set_requester", "watch", "unwatch"], "type": "string" }, "assigneeUserId": { "description": "assign: who gets the card \u2014 someone who can read the board (list_mention_candidates with cardUuid). Your own userId assigns it to you and accepts at once.", "type": "string" }, "cardUuid": { "description": "Card UUID (from kanban_list_cards).", "type": "string" }, "expectedRevision": { "description": "The card revision you last read. If the card changed since, the call fails with CARD_CHANGED and the current card. Send it when people may act on the card too.", "minimum": 0, "type": "integer" }, "mailLanguage": { "description": "Language of the email this action may send (assignment or review request). Defaults to en.", "enum": ["en", "ko"], "type": "string" }, "reason": { "description": "Saved as a comment on the card. Required when the action's allowedActions entry says reasonRequired (e.g. decline, reopen).", "type": "string" }, "requesterUserId": { "description": "set_requester: the new requester.", "type": "string" }, "responderIds": { "description": "block: who should answer (people who can read the board). Omit to keep the card's current responders.", "items": { "type": "string" }, "type": "array", "uniqueItems": true } }, "required": ["cardUuid", "action"], "type": "object" }, "required": ["action", "cardUuid"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "77da9c03fd1ce5f4" },
+  { "mcpName": "kanban_list_cards", "commandPath": ["kanban", "list-cards"], "group": "kanban", "description": "Read kanban cards. Three ways: cardUuids \u2192 those cards in full, including allowedActions (what you may do now with kanban_card_action) and links; boardUuid \u2192 the board's columns To Do, In Progress, In Review, Done (each with hasMore and nextAfter); neither \u2192 cards across all boards you can read where you are the assignee (or requester / watcher), most recently updated first. Each card has uuid, title, status, assignee and assignmentState (PENDING = not yet accepted), blocked, revision and allowedTransitions.", "inputSchema": { "additionalProperties": false, "properties": { "boardUuid": { "description": "Board (document) UUID: list its columns, first page each (or one column with status).", "type": "string" }, "cardUuids": { "description": "Read these cards in full (description, people, links, allowedActions). Use alone.", "items": { "type": "string" }, "maxItems": 50, "minItems": 1, "type": "array", "uniqueItems": true }, "cursor": { "description": "Next page: nextCursor (without boardUuid) or a column's nextAfter (with boardUuid and status).", "type": "string" }, "includeDone": { "description": "Without boardUuid: also recently completed cards.", "type": "boolean" }, "limit": { "description": "Cards per page (per column with boardUuid). Default 20.", "maximum": 50, "minimum": 1, "type": "integer" }, "projectUuid": { "description": "Without boardUuid: only boards in this project.", "type": "string" }, "relation": { "description": "Without boardUuid: cards across boards where you are the assignee (default), the requester or a watcher.", "enum": ["ASSIGNEE", "REQUESTER", "WATCHER"], "type": "string" }, "status": { "description": "With boardUuid: only this column.", "enum": ["TODO", "IN_PROGRESS", "IN_REVIEW", "DONE"], "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "99ed9634a628eb3f" },
+  { "mcpName": "list_agent_todos", "commandPath": ["agent-todos", "list"], "group": "generic", "description": "List the to-dos that ask the signed-in user's agent to act now (for example a question that mentions the user). This is the current state, not a feed: a to-do you have not finished comes back on every call until it is completed, dismissed, or closed because the person did it themselves. Each item has todoId, kind, obligation, openedAt, summary, target (title and url), action and state. To work on one, claim it with update_agent_todos and complete it with a one-line note. Actions that affect other people (assigning, approving, inviting) need the user's confirmation first.", "inputSchema": { "additionalProperties": false, "properties": { "after": { "description": "todoId of the last item of the previous page.", "type": "string" }, "kinds": { "description": "Only these kinds.", "items": { "enum": ["COMMENT_MENTIONED", "COMMENT_REPLIED", "QUESTION_ANSWERED", "QUESTION_RESOLVED", "QUESTION_MENTIONED", "CARD_CREATED", "CARD_UPDATED", "CARD_ASSIGNED", "CARD_UNASSIGNED", "CARD_ASSIGNMENT_ACCEPTED", "CARD_ASSIGNMENT_DECLINED", "CARD_STATUS_CHANGED", "CARD_REVIEW_REQUESTED", "CARD_CHANGES_REQUESTED", "CARD_APPROVED", "CARD_QUICK_DONE", "CARD_REOPENED", "CARD_BLOCKED", "CARD_UNBLOCKED", "CARD_ARCHIVED", "CARD_COMMENTED"], "type": "string" }, "type": "array", "uniqueItems": true }, "limit": { "description": "Items per call, default 20.", "maximum": 50, "minimum": 1, "type": "integer" }, "projectUuid": { "description": "Older single-value form of projectUuids.", "type": "string" }, "projectUuids": { "description": "Only to-dos in any of these projects. Use it when the user names a project or the project you are working in is clear. With workspaceUuids too, both must match. A workspace or project you cannot see matches nothing.", "items": { "type": "string" }, "type": "array", "uniqueItems": true }, "state": { "description": "OPEN (default): to-dos you can take, including ones whose lease expired. MINE: to-dos currently leased (claimed) and not expired.", "items": { "enum": ["OPEN", "MINE"], "type": "string" }, "type": "array", "uniqueItems": true }, "workspaceUuids": { "description": "Only to-dos in any of these workspaces.", "items": { "type": "string" }, "type": "array", "uniqueItems": true } }, "type": "object" }, "required": [], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "ee1a536fc14ee727" },
+  { "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": "dev", "schemaHash": "fae7152d1e4a930b" },
+  { "mcpName": "list_comments", "commandPath": ["comments", "list"], "group": "generic", "description": "List the active comments on a document or a kanban card (cardUuid), oldest first, including replies (a reply has parentCommentId set; replies are one level deep). Each comment has id, kind (COMMENT or QUESTION), body, author, mentions (userId, label and position in the body), and for questions questionState (UNANSWERED, ANSWERED, RESOLVED) and resolvedAt. Anyone who can read it can list its comments.", "inputSchema": { "additionalProperties": false, "properties": { "cardUuid": { "description": "Kanban card UUID the comments belong to (from kanban_list_cards). Anyone who can read the card's board may comment. Give this or documentUuid, not both.", "type": "string" }, "documentUuid": { "description": "Document UUID the comments belong to. Give this or cardUuid, not both.", "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "schemaHash": "21dbfc4740a62df5" },
+  { "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, diagram, markdown, openapi, html, file, kanban.", "enum": ["erd", "diagram", "markdown", "openapi", "html", "file", "kanban"], "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "schemaHash": "0d7288c249fc715c" },
+  { "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": "dev", "schemaHash": "461dc6735ac92c3b" },
+  { "mcpName": "list_history", "commandPath": ["history", "list"], "group": "generic", "description": "List recent activity (who did what, people and agents) in a workspace, a project, or on one resource, newest first. Give at least one of workspaceUuid, projectUuid, or resourceType with resourceUuid; you need editor access or higher in that scope. This is a list to refresh, not a gap-free feed: to see what is new, read the first page again and skip ids you have already seen; to get each new notification exactly once use list_notifications. Each item has id, kind, at, lastAt, coalesceCount, actor, target (title and url only when you can read it now), changes and summary.", "inputSchema": { "additionalProperties": false, "properties": { "actorType": { "description": "Only people (USER) or only agents (AGENT).", "enum": ["USER", "AGENT"], "type": "string" }, "before": { "description": "nextCursor of the previous page (older items).", "type": "string" }, "kinds": { "description": "Only these kinds.", "items": { "enum": ["COMMENT_MENTIONED", "COMMENT_REPLIED", "QUESTION_ANSWERED", "QUESTION_RESOLVED", "QUESTION_MENTIONED", "CARD_CREATED", "CARD_UPDATED", "CARD_ASSIGNED", "CARD_UNASSIGNED", "CARD_ASSIGNMENT_ACCEPTED", "CARD_ASSIGNMENT_DECLINED", "CARD_STATUS_CHANGED", "CARD_REVIEW_REQUESTED", "CARD_CHANGES_REQUESTED", "CARD_APPROVED", "CARD_QUICK_DONE", "CARD_REOPENED", "CARD_BLOCKED", "CARD_UNBLOCKED", "CARD_ARCHIVED", "CARD_COMMENTED"], "type": "string" }, "type": "array", "uniqueItems": true }, "limit": { "description": "Items per call, default 20.", "maximum": 50, "minimum": 1, "type": "integer" }, "projectUuid": { "description": "Activity in this project.", "type": "string" }, "resourceType": { "description": "With resourceUuid: activity on one resource.", "enum": ["DOCUMENT", "PROJECT", "KANBAN_CARD"], "type": "string" }, "resourceUuid": { "description": "UUID of the resource named by resourceType.", "type": "string" }, "workspaceUuid": { "description": "Activity in this workspace.", "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "eef3e3be41cfb6b4" },
+  { "mcpName": "list_mention_candidates", "commandPath": ["mention-candidates", "list"], "group": "generic", "description": "List the people you can mention in comments on a document or a kanban card (cardUuid): userId and displayName. Only people who can read it are listed \u2014 for a card, the people who can read its board, which are also the people a card can be assigned to. To mention someone, write @<displayName> exactly in the comment body and pass their userId in mentionUserIds of create_comments or update_comments. Page with nextCursor while hasMore is true.", "inputSchema": { "additionalProperties": false, "properties": { "cardUuid": { "description": "Kanban card UUID the comments belong to (from kanban_list_cards). Anyone who can read the card's board may comment. Give this or documentUuid, not both.", "type": "string" }, "cursor": { "description": "nextCursor from the previous page (same parent and query).", "type": "string" }, "documentUuid": { "description": "Document UUID the comments belong to. Give this or cardUuid, not both.", "type": "string" }, "limit": { "description": "Page size, 1..50. Defaults to 20.", "maximum": 50, "minimum": 1, "type": "integer" }, "query": { "description": "Name filter, 0..100 characters. Omit or leave empty for the first page of everyone.", "maxLength": 100, "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "schemaHash": "e7585805859ccb73" },
+  { "mcpName": "list_notifications", "commandPath": ["notifications", "list"], "group": "generic", "description": "Read new notifications for the signed-in user, oldest first and without gaps \u2014 for an agent that checks the inbox periodically. The server remembers, per connection and per filter (kinds, workspaceUuids, projectUuids, directOnly), how far you have acknowledged; a new filter starts from now. Each response carries ackToken: pass it as ack in your next call (with the same filter) after you have handled the batch \u2014 if you do not, the next call returns the same batch again (identify duplicates by id and seq; an item that comes back with a higher seq and a larger groupCount is an update of the same entry). Each item has id, seq, kind, at, summary (one line), actor, target (title and url only when you can read it now), action (what the user is asked to do) and humanRead. An item you can no longer read comes back as {id, seq, at, redacted: true}. This tool never marks anything read for the person; open to-dos are in list_agent_todos. Calls closer than 30 seconds apart (except a call that carries ack) return retryAfterSeconds instead of items.", "inputSchema": { "additionalProperties": false, "properties": { "ack": { "description": "The ackToken of the previous response. Send it with the same filter once you have handled (or safely stored) that batch; only then does the saved position move past it. Without it, the same batch is returned again.", "type": "string" }, "cursor": { "description": 'Where to read from. "saved" (default): after what this connection last acknowledged for this same filter. "latest": from now on (moves the saved position to now). "earliest": everything still kept (90 days). Or a nextCursor from a previous response: read after it without using or changing the saved position.', "type": "string" }, "directOnly": { "description": "Only notifications that point at you directly (mentions, questions to you).", "type": "boolean" }, "kinds": { "description": "Only these notification kinds.", "items": { "enum": ["COMMENT_MENTIONED", "COMMENT_REPLIED", "QUESTION_ANSWERED", "QUESTION_RESOLVED", "QUESTION_MENTIONED", "CARD_CREATED", "CARD_UPDATED", "CARD_ASSIGNED", "CARD_UNASSIGNED", "CARD_ASSIGNMENT_ACCEPTED", "CARD_ASSIGNMENT_DECLINED", "CARD_STATUS_CHANGED", "CARD_REVIEW_REQUESTED", "CARD_CHANGES_REQUESTED", "CARD_APPROVED", "CARD_QUICK_DONE", "CARD_REOPENED", "CARD_BLOCKED", "CARD_UNBLOCKED", "CARD_ARCHIVED", "CARD_COMMENTED"], "type": "string" }, "type": "array", "uniqueItems": true }, "limit": { "description": "Items per call, default 20.", "maximum": 50, "minimum": 1, "type": "integer" }, "projectUuid": { "description": "Older single-value form of projectUuids.", "type": "string" }, "projectUuids": { "description": "Only notifications in any of these projects. Use it when the user names a project or the project you are working in is clear. With workspaceUuids too, both must match. A workspace or project you cannot see matches nothing.", "items": { "type": "string" }, "type": "array", "uniqueItems": true }, "workspaceUuids": { "description": "Only notifications in any of these workspaces.", "items": { "type": "string" }, "type": "array", "uniqueItems": true } }, "type": "object" }, "required": [], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "bedcd4375c7f8735" },
+  { "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": "dev", "schemaHash": "939bfcc088425771" },
+  { "mcpName": "list_trash", "commandPath": ["trash", "list"], "group": "generic", "description": "", "inputSchema": { "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "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": "dev", "schemaHash": "f08f9faee3ba9107" },
+  { "mcpName": "list_workspaces", "commandPath": ["workspaces", "list"], "group": "workspace", "description": "", "inputSchema": { "properties": {}, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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": "dev", "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, diagram, markdown, openapi, html, file, kanban. document.update/document.append \uB294 documentUuid \uB97C \uD3EC\uD568. type=file \uC740 filename \uB3C4 \uD3EC\uD568(\uD655\uC7A5\uC790\uB85C \uD615\uC2DD \uD310\uC815) \u2014 PUT \uC758 Content-Type \uC740 \uD30C\uC77C MIME, \uBCF8\uBB38\uC740 \uD30C\uC77C \uBC14\uC774\uD2B8. attachment.upload: {documentUuid, filename}; storageKey \uB294 \uC11C\uBC84\uAC00 \uBC1C\uAE09 scope \uC5D0 \uB123\uB294\uB2E4.", "type": "string" }, "ttlSeconds": { "description": "TTL (\uCD08). \uAE30\uBCF8 300 (5\uBD84)", "type": "integer" } }, "required": ["purpose"], "type": "object" }, "required": ["purpose"], "payloadMode": "binary-upload", "destructive": false, "sourceCatalog": "dev", "schemaHash": "99a4b6c77dd2368b" },
+  { "mcpName": "resolve_comments", "commandPath": ["tools", "run", "resolve-comments"], "group": "generic", "description": "Mark questions on a document or a kanban card (cardUuid) as resolved. Only top-level comments with kind QUESTION can be resolved, and it needs edit access to the document or board (readers can comment but cannot resolve). Resolving cannot be undone. Each id is applied on its own; results report each id.", "inputSchema": { "additionalProperties": false, "properties": { "cardUuid": { "description": "Kanban card UUID the comments belong to (from kanban_list_cards). Anyone who can read the card's board may comment. Give this or documentUuid, not both.", "type": "string" }, "documentUuid": { "description": "Document UUID the comments belong to. Give this or cardUuid, not both.", "type": "string" }, "ids": { "description": "Question ids to resolve (top-level comments with kind QUESTION)", "items": { "minimum": 1, "type": "integer" }, "minItems": 1, "type": "array" } }, "required": ["ids"], "type": "object" }, "required": ["ids"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "d996f083fd9e6acf" },
+  { "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": "dev", "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, diagram, markdown, openapi, html, file, kanban.", "enum": ["erd", "diagram", "markdown", "openapi", "html", "file", "kanban"], "type": "string" } }, "required": ["q"], "type": "object" }, "required": ["q"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "dev", "schemaHash": "40322499fb85e525" },
+  { "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": "dev", "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": "dev", "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": "dev", "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": "dev", "schemaHash": "8dafe9bc6378c3f2" },
+  { "mcpName": "update_agent_todos", "commandPath": ["agent-todos", "update"], "group": "generic", "description": "Claim, renew, complete, release, or dismiss the signed-in user's agent to-dos. Only the session holding the current leaseToken may renew, release, or complete a claimed to-do \u2014 even another session of the same connection gets CLAIMED_BY_OTHER. Results are per item: {todoId, ok: true, state, leaseToken?, claimExpiresAt?} or {todoId, ok: false, error} with error one of CLAIMED_BY_OTHER, LEASE_LOST, ALREADY_DONE, CLOSED_BY_HUMAN, SUPERSEDED, ACCESS_LOST, BUSINESS_ACTION_REQUIRED, NOT_FOUND, INVALID \u2014 on CLOSED_BY_HUMAN or SUPERSEDED stop working on it. BUSINESS_ACTION_REQUIRED: card to-dos (CARD_*) cannot be completed here; doing the card action closes them. Retrying the same complete or dismiss returns ok again. There is no tool to mark the person's notifications read.", "inputSchema": { "additionalProperties": false, "properties": { "items": { "description": "To-dos to update; each item is applied and reported on its own.", "items": { "additionalProperties": false, "properties": { "action": { "description": "claim: take it (returns leaseToken, valid 30 minutes). renew: extend your lease. complete: done (with leaseToken if you claimed it; without one only while it is still OPEN). release: give it back. dismiss: not a to-do.", "enum": ["claim", "renew", "complete", "release", "dismiss"], "type": "string" }, "leaseToken": { "description": "Required for renew and release, and for complete or dismiss of a to-do you claimed.", "type": "string" }, "note": { "description": "For complete or dismiss: one line on what you did (at most 500 characters, no document bodies). The person sees it in the inbox.", "maxLength": 500, "type": "string" }, "todoId": { "description": "todoId from list_agent_todos.", "type": "string" } }, "required": ["todoId", "action"], "type": "object" }, "maxItems": 50, "minItems": 1, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "d10fc0752ad55a12" },
+  { "mcpName": "update_comments", "commandPath": ["comments", "update"], "group": "generic", "description": "Edit your own comments on a document or a kanban card (cardUuid). Only the author can edit, and only while they can still read it. A resolved question and a top-level comment that already has replies are locked. Items are applied in order and each one commits on its own; results report each item.", "inputSchema": { "additionalProperties": false, "properties": { "cardUuid": { "description": "Kanban card UUID the comments belong to (from kanban_list_cards). Anyone who can read the card's board may comment. Give this or documentUuid, not both.", "type": "string" }, "documentUuid": { "description": "Document UUID the comments belong to. Give this or cardUuid, not both.", "type": "string" }, "items": { "description": "Edits, applied in order", "items": { "additionalProperties": false, "properties": { "body": { "description": "New comment text (replaces the old text).", "maxLength": 1e4, "minLength": 1, "type": "string" }, "clientMutationId": { "description": "Idempotency key (visible ASCII, at most 128 characters). Required when mentionUserIds is not empty; reuse the same value when retrying the same item so the mention email is not sent twice.", "maxLength": 128, "type": "string" }, "id": { "description": "Comment id (from mcp__ainecto__list_comments)", "minimum": 1, "type": "integer" }, "mentionUserIds": { "description": "The complete set of userIds mentioned after the edit; omit to remove all mentions. Each one's @<displayName> must appear in body. Only people who were not mentioned before get a notification email.", "items": { "type": "string" }, "maxItems": 20, "type": "array", "uniqueItems": true } }, "required": ["id", "body"], "type": "object" }, "minItems": 1, "type": "array" }, "mailLanguage": { "description": "Language of the comment notification email (mention or reply). Defaults to en.", "enum": ["en", "ko"], "type": "string" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "dev", "schemaHash": "a5bc050079e34361" },
+  { "mcpName": "update_documents", "commandPath": ["documents", "update"], "group": "document", "description": "Update documents. If a replacement body is tens of KB or more, prefer request_upload_token (purpose=document.update) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "body": { "description": "Deprecated compatibility alias for typePayload.body when document type is markdown. \uBCF8\uBB38\uC774 \uC218\uC2ED KB \uC774\uC0C1\uC73C\uB85C \uD06C\uBA74 LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.update)` \uB97C \uD638\uCD9C\uD574 uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C \uC9C1\uC811 PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "title": { "description": "New title", "type": "string" }, "typePayload": { "description": "Type-specific payload for enabled document types. markdown: {body}; diagram: {diagramSource,sourceLanguage,edgeStyle,isModule,metadata}; openapi: {content}; html: {content} (a full HTML page); file: {file:{filename,contentType,sizeBytes,viewerKind}} (+content for text/CSV, first 64 KB); kanban: no body \u2014 only the title can be updated; cards are changed with kanban_apply_changes and kanban_card_action.", "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": "dev", "schemaHash": "47485db860973df3" },
+  { "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": "dev", "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": "dev", "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": "dev", "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": "dev", "schemaHash": "deda4a56fbbe064f" }
 ];
 
 // src/core/catalog/generator.ts
@@ -990,7 +990,6 @@ var DESTRUCTIVE_PREFIXES = [
   "move_",
   "erd_delete_",
   "erd_remove_",
-  "task_delete_",
   "testcase_delete_"
 ];
 function generateCatalog(tools, sourceCatalog) {
@@ -1024,7 +1023,7 @@ function inferGroup(strippedName) {
   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.startsWith("kanban_")) return "kanban";
   if (strippedName.includes("workspace")) return "workspace";
   if (strippedName.includes("document")) return "document";
   return "generic";
@@ -1127,6 +1126,9 @@ async function runStdioBridge(options) {
     }
     try {
       const request = parseJsonRpcRequest(line);
+      if (request.method === "initialize") {
+        options.client.useAgent(clientInfoName(request.params));
+      }
       const response = await options.client.sendRaw(request);
       if (response && request.id !== void 0) {
         options.output.write(`${JSON.stringify(response)}
@@ -1155,17 +1157,27 @@ function parseJsonRpcRequest(line) {
     params: parsed.params
   };
 }
+function clientInfoName(params) {
+  return isRecord4(params) && isRecord4(params.clientInfo) ? params.clientInfo.name : void 0;
+}
 function isRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
 // src/adapters/mcp/connector.ts
 async function runConnector(options) {
+  const legacyRole = legacyRoleInput(options.legacyRoleFlag, options.envVars);
+  if (legacyRole !== void 0) {
+    options.errorOutput.write(`${LEGACY_ROLE_NOTICE}
+`);
+  }
   const auth = new OAuthClient({ endpoint: options.endpoint, tokenStore: new FileTokenStore() });
   const client = new McpRpcClient({
     endpoint: options.endpoint,
     tokenProvider: auth,
-    role: options.role
+    legacyRole,
+    // 에이전트의 MCP 연결 — 에이전트 이름은 브리지가 호스트의 initialize 에서 읽어 싣는다.
+    channel: "mcp"
   });
   await runStdioBridge({
     input: options.input,
@@ -1238,18 +1250,6 @@ var enrichments = [
     tableColumns: ["uuid", "name", "display_order"],
     displayName: "List ERD table groups"
   },
-  {
-    mcpName: "task_list_tasks",
-    outputHint: "table",
-    tableColumns: ["uuid", "title", "statusUuid", "assigneeId", "updatedAt"],
-    displayName: "List tasks"
-  },
-  {
-    mcpName: "task_list_statuses",
-    outputHint: "table",
-    tableColumns: ["uuid", "name", "displayOrder"],
-    displayName: "List task statuses"
-  },
   {
     mcpName: "enable_shares",
     aliases: ["shares enable"],
@@ -1527,6 +1527,9 @@ async function promptConfirmation(io, message) {
 
 // src/adapters/cli/bespokeCommands.ts
 var ATTACHMENTS_UPLOAD_COMMAND_PATH = ["attachments", "upload"];
+var NOTIFICATIONS_POLL_COMMAND_PATH = ["notifications", "poll"];
+var NOTIFICATIONS_ACK_COMMAND_PATH = ["notifications", "ack"];
+var AGENT_TODOS_POLL_COMMAND_PATH = ["agent-todos", "poll"];
 
 // src/adapters/cli/generatedCommandRouter.ts
 function matchGeneratedCommand(tools, argv) {
@@ -1612,6 +1615,50 @@ function findRestStart(argv, commandPath) {
 // src/core/upload/attachmentUpload.ts
 import { readFile as readFile3, stat as stat2 } from "fs/promises";
 import { basename, extname } from "path";
+
+// src/core/mcp/toolPayload.ts
+function unwrapMcpToolPayload(value) {
+  if (!isRecord7(value) || !Array.isArray(value.content)) {
+    return value;
+  }
+  const text = value.content.map((item) => isRecord7(item) && typeof item.text === "string" ? item.text : "").find((itemText) => itemText.trim().startsWith("{"));
+  if (!text) {
+    return value;
+  }
+  try {
+    return JSON.parse(text);
+  } catch {
+    return value;
+  }
+}
+function toolErrorText(value) {
+  if (!isRecord7(value) || !Array.isArray(value.content)) {
+    return "The tool returned an error.";
+  }
+  const text = value.content.map((item) => isRecord7(item) && typeof item.text === "string" ? item.text : "").filter(Boolean).join("\n");
+  return text || "The tool returned an error.";
+}
+function isRecord7(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function extractProjects(value) {
+  const candidates = Array.isArray(value) ? value : isRecord7(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 (isRecord7(candidate) && typeof candidate.uuid === "string") {
+      projects.push({
+        uuid: candidate.uuid,
+        name: typeof candidate.name === "string" ? candidate.name : candidate.uuid
+      });
+    }
+  }
+  return projects;
+}
+
+// src/core/upload/attachmentUpload.ts
 var AttachmentUploadError = class extends Error {
   constructor(code, message, details) {
     super(message);
@@ -1709,7 +1756,7 @@ async function requestUploadToken(client, metadata, context) {
     requestArgs.ttlSeconds = context.ttlSeconds;
   }
   const response = unwrapMcpToolPayload(await client.toolsCall(context.requestToolName, requestArgs));
-  if (!isRecord7(response)) {
+  if (!isRecord8(response)) {
     throw new AttachmentUploadError("UPLOAD_TOKEN_PROTOCOL_ERROR", "request_upload_token response was not an object.");
   }
   const token = response.token;
@@ -1779,7 +1826,7 @@ function parsePutResponse(text) {
   } catch {
     throw new AttachmentUploadError("ATTACHMENT_UPLOAD_PROTOCOL_ERROR", "Attachment PUT response was not valid JSON.");
   }
-  if (!isRecord7(parsed)) {
+  if (!isRecord8(parsed)) {
     throw new AttachmentUploadError("ATTACHMENT_UPLOAD_PROTOCOL_ERROR", "Attachment PUT response was not an object.");
   }
   if (typeof parsed.storageKey !== "string") {
@@ -1811,20 +1858,6 @@ function validatePutResult(token, metadata, putResult) {
     });
   }
 }
-function unwrapMcpToolPayload(value) {
-  if (!isRecord7(value) || !Array.isArray(value.content)) {
-    return value;
-  }
-  const text = value.content.map((item) => isRecord7(item) && typeof item.text === "string" ? item.text : "").find((itemText) => itemText.trim().startsWith("{"));
-  if (!text) {
-    return value;
-  }
-  try {
-    return JSON.parse(text);
-  } catch {
-    return value;
-  }
-}
 function emitProgress(context, stage, path, filename) {
   context.onProgress?.({
     stage,
@@ -1857,7 +1890,7 @@ var MIME_BY_EXTENSION = {
   ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
   ".zip": "application/zip"
 };
-function isRecord7(value) {
+function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -1981,9 +2014,256 @@ function renderAttachmentUploadResult(result, json) {
   return renderSuccess(lines.join("\n"), { json: false });
 }
 
+// src/adapters/cli/inboxPollCommands.ts
+import { mkdir as mkdir2, open, readFile as readFile4, rename as rename2 } from "fs/promises";
+import { dirname as dirname2 } from "path";
+var EXIT_NOTHING_NEW = 3;
+var LIST_NOTIFICATIONS = "mcp__ainecto__list_notifications";
+var LIST_AGENT_TODOS = "mcp__ainecto__list_agent_todos";
+function isInboxPollCommand(domain, action) {
+  return [NOTIFICATIONS_POLL_COMMAND_PATH, NOTIFICATIONS_ACK_COMMAND_PATH, AGENT_TODOS_POLL_COMMAND_PATH].some(([d, a]) => d === domain && a === action);
+}
+var EXIT_USAGE = 2;
+var USAGE_ERRORS = /* @__PURE__ */ new Set(["UNKNOWN_FLAG", "FLAG_REQUIRES_VALUE", "MISSING_REQUIRED_FLAG", "INVALID_FLAG_VALUE"]);
+async function executeInboxPollCommand(options) {
+  try {
+    if (options.domain === "agent-todos") return await agentTodosPoll(options);
+    if (options.action === "ack") return await notificationsAck(options);
+    return await notificationsPoll(options);
+  } catch (error) {
+    if (error instanceof CliCommandError && USAGE_ERRORS.has(error.code)) {
+      options.io.stderr.write(renderError(error, { json: options.json }));
+      return EXIT_USAGE;
+    }
+    throw error;
+  }
+}
+async function notificationsPoll(options) {
+  const flags = parseFlags(options.argv, ["--cursor-file", "--kinds", "--workspace", "--project", "--limit"], ["--direct-only"]);
+  const cursorPath = requireFlag(flags, "--cursor-file", "notifications poll");
+  const filter = {
+    kinds: flags.values["--kinds"]?.split(",").map((kind) => kind.trim()).filter(Boolean).sort(),
+    ...scopeFilter(flags),
+    directOnly: flags.switches.has("--direct-only")
+  };
+  if (filter.kinds?.length === 0) filter.kinds = void 0;
+  const limit = flags.values["--limit"] === void 0 ? void 0 : positiveInt("--limit", flags.values["--limit"]);
+  const saved = await readCursorFile(cursorPath);
+  if (saved?.ackToken && saved.pendingItems?.length) {
+    if (!sameFilter(saved.filter, filter)) {
+      throw new CliCommandError(
+        "PENDING_BATCH_OTHER_FILTER",
+        `${cursorPath} holds an unacknowledged batch for a different filter. Run \`ainecto notifications ack --cursor-file ${cursorPath}\` after handling it, or use another cursor file for this filter.`,
+        { cursorFile: cursorPath }
+      );
+    }
+    options.io.stdout.write(renderSuccess({ items: saved.pendingItems, pending: true, stream: saved.stream }, { json: options.json }));
+    return 0;
+  }
+  const result = await callTool(options.client, LIST_NOTIFICATIONS, {
+    cursor: "saved",
+    ...filter.kinds ? { kinds: filter.kinds } : {},
+    ...scopeArgs(filter),
+    ...filter.directOnly ? { directOnly: true } : {},
+    ...limit !== void 0 ? { limit } : {}
+  });
+  const items = Array.isArray(result.items) ? result.items : [];
+  const stream = typeof result.stream === "string" ? result.stream : void 0;
+  if (typeof result.retryAfterSeconds === "number") {
+    options.io.stderr.write(`Polled too soon; try again in ${result.retryAfterSeconds}s.
+`);
+    return EXIT_NOTHING_NEW;
+  }
+  if (items.length === 0) {
+    await writeCursorFile(cursorPath, { v: 1, filter, stream });
+    if (options.json) options.io.stdout.write(renderSuccess({ items: [], stream }, { json: true }));
+    return EXIT_NOTHING_NEW;
+  }
+  await writeCursorFile(cursorPath, {
+    v: 1,
+    filter,
+    stream,
+    ackToken: typeof result.ackToken === "string" ? result.ackToken : void 0,
+    pendingItems: items
+  });
+  options.io.stdout.write(renderSuccess({ items, hasMore: result.hasMore === true, stream }, { json: options.json }));
+  return 0;
+}
+async function notificationsAck(options) {
+  const flags = parseFlags(options.argv, ["--cursor-file"], []);
+  const cursorPath = requireFlag(flags, "--cursor-file", "notifications ack");
+  const saved = await readCursorFile(cursorPath);
+  if (!saved?.ackToken) {
+    if (options.json) options.io.stdout.write(renderSuccess({ acked: false }, { json: true }));
+    return EXIT_NOTHING_NEW;
+  }
+  await callTool(options.client, LIST_NOTIFICATIONS, {
+    cursor: "saved",
+    ack: saved.ackToken,
+    ...saved.filter.kinds ? { kinds: saved.filter.kinds } : {},
+    ...scopeArgs(saved.filter),
+    ...saved.filter.directOnly ? { directOnly: true } : {},
+    limit: 1
+  });
+  const acked = saved.pendingItems?.length ?? 0;
+  await writeCursorFile(cursorPath, { v: 1, filter: saved.filter, stream: saved.stream });
+  options.io.stdout.write(renderSuccess({ acked: true, items: acked }, { json: options.json }));
+  return 0;
+}
+async function agentTodosPoll(options) {
+  const flags = parseFlags(options.argv, ["--workspace", "--project", "--seen-file"], ["--only-new"]);
+  const scope = scopeArgs(scopeFilter(flags));
+  const onlyNew = flags.switches.has("--only-new");
+  const seenPath = flags.values["--seen-file"];
+  if (onlyNew && !seenPath) {
+    throw new CliCommandError("MISSING_REQUIRED_FLAG", "--only-new needs --seen-file <path>.", { flag: "--seen-file" });
+  }
+  const items = [];
+  let after;
+  for (let page = 0; page < 20; page += 1) {
+    const result = await callTool(options.client, LIST_AGENT_TODOS, { state: ["OPEN"], ...scope, limit: 50, ...after ? { after } : {} });
+    const pageItems = Array.isArray(result.items) ? result.items.filter(isRecord9) : [];
+    items.push(...pageItems);
+    const last = pageItems[pageItems.length - 1];
+    if (result.hasMore !== true || !last || typeof last.todoId !== "string") break;
+    after = last.todoId;
+  }
+  let shown = items;
+  if (onlyNew && seenPath) {
+    const seen = new Set(await readSeenFile(seenPath));
+    shown = items.filter((item) => typeof item.todoId === "string" && !seen.has(item.todoId));
+    await writeJsonAtomic(seenPath, items.map((item) => item.todoId).filter((id) => typeof id === "string"));
+  }
+  if (shown.length === 0) {
+    if (options.json) options.io.stdout.write(renderSuccess({ items: [] }, { json: true }));
+    return EXIT_NOTHING_NEW;
+  }
+  options.io.stdout.write(renderSuccess({ items: shown }, { json: options.json }));
+  return 0;
+}
+async function callTool(client, name, args) {
+  const raw = await client.toolsCall(name, args);
+  if (isToolError(raw)) {
+    throw new CliCommandError("TOOL_ERROR", toolErrorText(raw), { tool: name });
+  }
+  const payload = unwrapMcpToolPayload(raw);
+  if (!isRecord9(payload)) {
+    throw new CliCommandError("MCP_PROTOCOL_ERROR", `${name} did not return an object.`, { tool: name });
+  }
+  return payload;
+}
+function scopeFilter(flags) {
+  const workspaces = uuidSet(flags.lists["--workspace"]);
+  const projects = uuidSet(flags.lists["--project"]);
+  return {
+    ...workspaces.length ? { workspaceUuids: workspaces } : {},
+    ...projects.length ? { projectUuids: projects } : {}
+  };
+}
+function uuidSet(values) {
+  return [...new Set(values ?? [])].sort();
+}
+function scopeArgs(filter) {
+  const workspaces = filter.workspaceUuids ?? [];
+  const projects = filter.projectUuids ?? [];
+  if (workspaces.length === 0 && projects.length === 1) return { projectUuid: projects[0] };
+  return {
+    ...workspaces.length ? { workspaceUuids: workspaces } : {},
+    ...projects.length ? { projectUuids: projects } : {}
+  };
+}
+function parseFlags(argv, valueFlags, switchFlags) {
+  const values = {};
+  const lists = {};
+  const switches = /* @__PURE__ */ new Set();
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (!arg) continue;
+    if (valueFlags.includes(arg)) {
+      const value = argv[index + 1];
+      if (!value || value.startsWith("--")) {
+        throw new CliCommandError("FLAG_REQUIRES_VALUE", `${arg} requires a value.`, { flag: arg });
+      }
+      values[arg] = value;
+      (lists[arg] ??= []).push(value);
+      index += 1;
+    } else if (switchFlags.includes(arg)) {
+      switches.add(arg);
+    } else {
+      throw new CliCommandError("UNKNOWN_FLAG", `Unknown argument ${arg}.`, { flag: arg });
+    }
+  }
+  return { values, lists, switches };
+}
+function requireFlag(flags, flag, command) {
+  const value = flags.values[flag];
+  if (!value) throw new CliCommandError("MISSING_REQUIRED_FLAG", `${command} needs ${flag} <path>.`, { flag });
+  return value;
+}
+function positiveInt(flag, value) {
+  if (!value || !/^[1-9]\d*$/.test(value)) {
+    throw new CliCommandError("INVALID_FLAG_VALUE", `${flag} must be a positive integer.`, { flag, value });
+  }
+  return Number.parseInt(value, 10);
+}
+function sameFilter(a, b) {
+  return JSON.stringify(a.kinds ?? []) === JSON.stringify(b.kinds ?? []) && JSON.stringify(a.workspaceUuids ?? []) === JSON.stringify(b.workspaceUuids ?? []) && JSON.stringify(a.projectUuids ?? []) === JSON.stringify(b.projectUuids ?? []) && a.directOnly === b.directOnly;
+}
+function normalizeSavedFilter(saved) {
+  const { projectUuid, ...rest } = saved;
+  if (rest.projectUuids?.length || !projectUuid) return rest;
+  return { ...rest, projectUuids: [projectUuid] };
+}
+async function readCursorFile(path) {
+  const text = await readFile4(path, "utf8").catch((error) => {
+    if (error.code === "ENOENT") return void 0;
+    throw error;
+  });
+  if (text === void 0 || !text.trim()) return void 0;
+  try {
+    const parsed = JSON.parse(text);
+    if (parsed?.v !== 1 || !isRecord9(parsed.filter)) throw new Error("shape");
+    return { ...parsed, filter: normalizeSavedFilter(parsed.filter) };
+  } catch {
+    throw new CliCommandError("INVALID_CURSOR_FILE", `${path} is not a cursor file written by ainecto notifications poll.`, { cursorFile: path });
+  }
+}
+async function writeCursorFile(path, value) {
+  await writeJsonAtomic(path, value);
+}
+async function readSeenFile(path) {
+  const text = await readFile4(path, "utf8").catch((error) => {
+    if (error.code === "ENOENT") return void 0;
+    throw error;
+  });
+  if (!text?.trim()) return [];
+  try {
+    const parsed = JSON.parse(text);
+    return Array.isArray(parsed) ? parsed.filter((id) => typeof id === "string") : [];
+  } catch {
+    throw new CliCommandError("INVALID_SEEN_FILE", `${path} is not a seen file written by ainecto agent-todos poll.`, { seenFile: path });
+  }
+}
+async function writeJsonAtomic(path, value) {
+  await mkdir2(dirname2(path), { recursive: true });
+  const temp = `${path}.${process.pid}.tmp`;
+  const handle = await open(temp, "w", 384);
+  try {
+    await handle.writeFile(`${JSON.stringify(value, null, 2)}
+`, "utf8");
+    await handle.sync();
+  } finally {
+    await handle.close();
+  }
+  await rename2(temp, path);
+}
+function isRecord9(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 // 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";
+import { chmod as chmod2, mkdir as mkdir3, rename as rename3, rm as rm2, rmdir, stat as stat3, writeFile as writeFile2 } from "fs/promises";
+import { dirname as dirname4, join as join3, relative, resolve as resolve2, sep as sep2 } from "path";
 
 // src/core/harness/agentTargets.ts
 import { basename as basename2 } from "path";
@@ -1992,8 +2272,8 @@ 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];
+function buildServerEntry(input = {}) {
+  const args = ["-y", input.packageSpec ?? bridgePackageSpec()];
   if (input.env && input.env !== "prod") {
     args.push("--env", input.env);
   }
@@ -2002,13 +2282,15 @@ function buildServerEntry(input) {
   }
   return { command: "npx", args };
 }
-function readRoleFromEntry(entry) {
-  if (!isRecord8(entry) || !Array.isArray(entry.args)) {
+function entryCarriesRole(entry) {
+  return isRecord10(entry) && Array.isArray(entry.args) && entry.args.includes("--role");
+}
+function pinnedBridgeVersion(entry) {
+  if (!isRecord10(entry) || !Array.isArray(entry.args)) {
     return void 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;
+  const pinned = entry.args.find((arg) => typeof arg === "string" && arg.startsWith(`${PACKAGE_NAME}@`));
+  return pinned?.slice(PACKAGE_NAME.length + 1);
 }
 function readServerEntry(existing) {
   if (existing === void 0) {
@@ -2017,13 +2299,13 @@ function readServerEntry(existing) {
   try {
     const parsed = JSON.parse(existing);
     const servers = parsed?.mcpServers;
-    return isRecord8(servers) ? servers[SERVER_NAME] : void 0;
+    return isRecord10(servers) ? servers[SERVER_NAME] : void 0;
   } catch {
     return void 0;
   }
 }
 function isOurBridge(entry) {
-  if (!isRecord8(entry)) {
+  if (!isRecord10(entry)) {
     return false;
   }
   const { command, args } = entry;
@@ -2062,32 +2344,12 @@ function removeServerEntry(existing, restore) {
   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 {};
   }
-  if (!isRecord8(servers)) {
+  if (!isRecord10(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.'
     );
@@ -2106,7 +2368,7 @@ function parseConfigObject(existing) {
       `Existing MCP config is not valid JSON, so it was left untouched. Fix it by hand and run init again. (${error instanceof Error ? error.message : String(error)})`
     );
   }
-  if (!isRecord8(parsed)) {
+  if (!isRecord10(parsed)) {
     throw new Error("Existing MCP config must be a JSON object; it was left untouched.");
   }
   return parsed;
@@ -2115,7 +2377,7 @@ function stringify(value) {
   return `${JSON.stringify(value, null, 2)}
 `;
 }
-function isRecord8(value) {
+function isRecord10(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -2128,11 +2390,7 @@ 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
-  });
+  return fillTemplate(template ?? DEFAULT_HARNESS_DOC, { 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);
@@ -2140,15 +2398,21 @@ function fillTemplate(template, values) {
 var DOC_KEY = "HARNESS.DOC";
 var AGENT_NOTE_KEY = "HARNESS.AGENT_NOTE";
 var REQUIRED_VARIABLES = {
-  [DOC_KEY]: ["projectName", "projectUuid", "endpoint"],
+  [DOC_KEY]: ["endpoint"],
   [AGENT_NOTE_KEY]: ["harnessDocPath", "serverName"]
 };
 function documentContractProblem(key, body) {
-  for (const name of REQUIRED_VARIABLES[key] ?? []) {
+  const known = REQUIRED_VARIABLES[key] ?? [];
+  for (const name of known) {
     if (!body.includes(`{{${name}}}`)) {
       return `${key} is missing the required {{${name}}} placeholder`;
     }
   }
+  for (const [, name] of body.matchAll(/\{\{([a-zA-Z0-9_]+)}}/g)) {
+    if (!known.includes(name)) {
+      return `${key} has a {{${name}}} placeholder this CLI does not fill`;
+    }
+  }
   if (key === AGENT_NOTE_KEY) {
     return managedBlockProblem(key, body);
   }
@@ -2156,58 +2420,32 @@ function documentContractProblem(key, body) {
 }
 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.
+This repository works with AiNecto. The design source of truth \u2014 requirements, the ERD,
+diagrams, documents, and task boards \u2014 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
+## What you can do
 
-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.
+Every AI session sees the same AiNecto tools. What a tool may change is decided by the signed-in
+user's AiNecto permissions on the workspace, project, or document it touches \u2014 the server refuses
+what the user may not do. A refusal is an answer: report it to the user instead of looking for a
+way around it.
 
-    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.
+Find the project and document for the task with the tools (\`list_projects\`, \`search_documents\`,
+\`get_document\`) \u2014 this repository is not bound to one project.
 
-Validation reports \`PASS\`, or \`FAIL\` with the rule violated, where it happened, the evidence,
-and which session should pick it up next.
+## When a tool is missing
 
-## Not every change needs four sessions
+If a result names a tool that is not in your tool list, this session started before that tool
+was added. Start a new session, or call it from the repository with
+\`npx -y ainecto@latest tools call <tool> '<json>'\`.
 
-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.
+## Commands
 
-## 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.
+    npx -y ainecto@latest setup      connect this machine's coding agents (once per machine)
+    npx -y ainecto@latest status     who is signed in, and what is connected
+    npx -y ainecto@latest doctor     what is missing, and the command that fixes it
 
 ---
 Generated by \`ainecto init\`. Remove everything it wrote with \`ainecto init --undo\`.
@@ -2221,14 +2459,11 @@ function renderAgentNote(template) {
 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.
+This repository uses AiNecto as its design source of truth. 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.
+AiNecto tools come from the \`{{serverName}}\` MCP server. Every session sees the same tools; the
+signed-in user's AiNecto permissions decide what they may change, and the server refuses the rest.
 ${MARKER_END}`;
 function managedBlockProblem(key, body) {
   const trimmed = body.trim();
@@ -2254,14 +2489,14 @@ function managedBlockProblem(key, body) {
   return void 0;
 }
 function hasUnclosedFence(content) {
-  let open;
+  let open2;
   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;
+    if (!open2) open2 = { char: fence.char, length: fence.length };
+    else if (fence.char === open2.char && fence.length >= open2.length && fence.info === "") open2 = void 0;
   }
-  return open !== void 0;
+  return open2 !== void 0;
 }
 function canonicalManagedBlock(block) {
   return block.trim();
@@ -2321,24 +2556,24 @@ function hit(at, marker) {
   return at >= 0 ? { at, length: marker.length } : void 0;
 }
 function isInsideFencedBlock(content, index) {
-  let open;
+  let open2;
   let offset = 0;
   for (const line of content.split("\n")) {
     const nextOffset = offset + line.length + 1;
     if (index < nextOffset) {
-      return open !== void 0;
+      return open2 !== 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;
+      if (!open2) {
+        open2 = { char: fence.char, length: fence.length };
+      } else if (fence.char === open2.char && fence.length >= open2.length && fence.info === "") {
+        open2 = void 0;
       }
     }
     offset = nextOffset;
   }
-  return open !== void 0;
+  return open2 !== void 0;
 }
 function fenceOf(line) {
   const match = /^ {0,3}(`{3,}|~{3,})(.*)$/.exec(line);
@@ -2665,245 +2900,78 @@ function isStringArray(value) {
 
 // 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) ? { kind: "problem", reason: `${path} is not valid JSON` } : { kind: "absent" };
+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;
   }
-  const entry = servers[SERVER_NAME];
-  if (!isOurBridge(entry)) {
-    return { kind: "absent" };
+  if (left.at === "absent") {
+    return true;
   }
-  const role = readRoleFromEntry(entry);
-  if (role === void 0) {
-    return { kind: "problem", reason: `${path} has the "${SERVER_NAME}" bridge without a valid --role` };
+  if (left.at === "text" && right.at === "text") {
+    return left.text === right.text;
   }
-  return { kind: "role", role };
+  return left.at === "json" && right.at === "json" && stableStringify2(left.value) === stableStringify2(right.value);
 }
-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 };
+function contentFingerprint(content) {
+  return createHash4("sha256").update(content).digest("hex");
 }
-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" };
-    }
-  }
+function serialize(body) {
+  return `${JSON.stringify(body, null, 2)}
+`;
 }
-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}).`;
+function fingerprintFor(path, content) {
+  if (!path.endsWith(".json")) {
+    return contentFingerprint(content);
   }
-  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);
+    return contentFingerprint(stableStringify2(JSON.parse(content)));
   } catch {
-    return resolve(path);
+    return contentFingerprint(content);
   }
 }
-function samePath(left, right) {
-  return process.platform === "win32" ? left.toLowerCase() === right.toLowerCase() : left === right;
-}
-async function readConfigInside(dir, path) {
-  let real;
+function parseJsonObject(content) {
   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;
+    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 },
+    version: 2,
     endpoint: values.endpoint,
     generatedBy: values.cliVersion,
     promptVersions: values.versions
   };
 }
 var OUR_CONFIG_FIELDS = Object.keys(configBodyOf({
-  projectUuid: "",
-  projectName: "",
   endpoint: "",
   cliVersion: "",
   versions: {}
 }));
+var RETIRED_CONFIG_FIELDS = ["project"];
+function ownedConfigFields(contract) {
+  const written = contract?.writtenFields ?? {};
+  return [...OUR_CONFIG_FIELDS, ...RETIRED_CONFIG_FIELDS.filter((field) => hasField(written, field))];
+}
 var hasField = (object, field) => Object.prototype.hasOwnProperty.call(object, field);
 function initRefusal(files, previous) {
   const state = previous ?? readRecord(files.get(HARNESS_RECORD_PATH));
@@ -2926,16 +2994,10 @@ 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
-    };
+    return { writes: [], deletes: [], notes: [], refusal };
   }
   const carriedRecord = previous.state === "valid" ? previous.record : emptyRecord();
-  const entry = buildServerEntry({ role: input.role, env: input.env, endpoint: input.endpoint });
+  const entry = buildServerEntry({ env: input.env, endpoint: input.endpoint, packageSpec: input.packageSpec });
   const writes = [];
   const notes = [];
   const record = {
@@ -2958,15 +3020,14 @@ function planInit(input) {
   for (const target of AGENT_TARGETS) {
     const existing = input.files.get(target.path);
     const currentEntry = existing === void 0 ? void 0 : readServerEntry(existing);
+    if (!input.mcp && !isOurBridge(currentEntry)) {
+      continue;
+    }
     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`);
@@ -2982,11 +3043,7 @@ function planInit(input) {
   }
   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 docContent = renderHarnessDoc({ 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.`);
@@ -3048,8 +3105,6 @@ function planInit(input) {
   }
   const existingConfig = input.files.get(HARNESS_CONFIG_PATH);
   const ourFields = configBodyOf({
-    projectUuid: input.projectUuid,
-    projectName: input.projectName,
     endpoint: input.endpoint,
     cliVersion: input.cliVersion,
     // ★어느 판의 규칙으로 썼나. 이게 없으면 「무엇이 적혀 있었나」를 나중에 못 되짚는다.
@@ -3073,7 +3128,24 @@ function planInit(input) {
         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 });
+    const retained = { ...theirConfig ?? {} };
+    for (const field of RETIRED_CONFIG_FIELDS) {
+      const priorWritten = priorConfig?.writtenFields;
+      if (priorWritten === void 0 || !hasField(priorWritten, field) || !hasField(retained, field)) {
+        continue;
+      }
+      if (stableStringify2(retained[field]) !== stableStringify2(priorWritten[field])) {
+        notes.push(`${HARNESS_CONFIG_PATH}: you changed ${field} \u2014 left as you set it (ainecto no longer writes it).`);
+        continue;
+      }
+      const original = priorConfig?.originalFields?.[field];
+      if (original?.at === "json") {
+        retained[field] = original.value;
+      } else {
+        delete retained[field];
+      }
+    }
+    const mergedConfig = serialize({ ...retained, ...ourFields });
     record.files[HARNESS_CONFIG_PATH] = {
       scope: "fields",
       createdByUs: priorConfig?.createdByUs ?? existingConfig === void 0,
@@ -3100,14 +3172,7 @@ function planInit(input) {
       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
-  };
+  return { writes, deletes: [], notes, record };
 }
 function planUndo(input) {
   const state = input.record ?? readRecord(input.files.get(HARNESS_RECORD_PATH));
@@ -3115,20 +3180,19 @@ function planUndo(input) {
   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} anywhere, unset it too.`);
+    notes.push("Agent connections that `ainecto setup` made on this machine are removed with `ainecto setup --undo`.");
   };
   if (state.state === "absent") {
     notes.push(`No record of a previous init in ${HARNESS_RECORD_PATH} \u2014 no local file was changed.`);
     tail();
-    return { writes, deletes, codexCommand: codexRemoveCommand(), notes };
+    return { writes, deletes, 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 };
+    return { writes, deletes, notes };
   }
   const record = state.record;
   const remaining = { ...record.files };
@@ -3162,7 +3226,7 @@ function planUndo(input) {
     }
   }
   const removableDirectories = parentsOf(deletes).filter((directory) => record.createdDirectories.includes(directory));
-  return { writes, deletes, codexCommand: codexRemoveCommand(), notes, removableDirectories };
+  return { writes, deletes, notes, removableDirectories };
 }
 function unexplainedMarkers(existing, contract) {
   const recorded = [...contract.foreignBlocks ?? []];
@@ -3308,7 +3372,8 @@ function undoFields(path, contract, existing) {
       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);
+  const owned = ownedConfigFields(contract);
+  const contractProblem = fieldsContractProblem(contract, owned);
   if (contractProblem !== void 0) {
     return {
       kind: "unresolved",
@@ -3320,7 +3385,7 @@ function undoFields(path, contract, existing) {
   const next = {};
   const kept = [];
   for (const [field, value] of Object.entries(parsed)) {
-    if (!OUR_CONFIG_FIELDS.includes(field)) {
+    if (!owned.includes(field)) {
       next[field] = value;
       continue;
     }
@@ -3375,14 +3440,8 @@ function parentsOf(paths) {
   }
   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/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");
@@ -3405,7 +3464,7 @@ async function fetchHarnessDocuments(input) {
     const versions = {};
     const fallbacks = {};
     const bodies = {};
-    for (const key of [DOC_KEY2, AGENT_NOTE_KEY2]) {
+    for (const key of [DOC_KEY, AGENT_NOTE_KEY]) {
       const entry = documents[key];
       const problem = usableBodyProblem(key, entry);
       if (problem) {
@@ -3417,7 +3476,7 @@ async function fetchHarnessDocuments(input) {
         versions[key] = entry.version;
       }
     }
-    return { doc: bodies[DOC_KEY2], agentNote: bodies[AGENT_NOTE_KEY2], versions, fallbacks };
+    return { doc: bodies[DOC_KEY], agentNote: bodies[AGENT_NOTE_KEY], versions, fallbacks };
   } catch (error) {
     return {
       versions: {},
@@ -3433,95 +3492,75 @@ function usableBodyProblem(key, entry) {
   return documentContractProblem(key, entry.body);
 }
 
-// src/adapters/cli/prompter.ts
-import { createInterface as createInterface3 } from "readline";
-var PromptCancelled = class extends Error {
-  constructor() {
-    super("Cancelled \u2014 no repository files were written. A sign-in you already completed stays saved.");
-    this.name = "PromptCancelled";
+// src/core/harness/repositoryFiles.ts
+import { lstat, readFile as readFile5, realpath } from "fs/promises";
+import { dirname as dirname3, join as join2, resolve, sep } from "path";
+async function findGitRoot(cwd) {
+  for (let at = resolve(cwd); ; at = dirname3(at)) {
+    try {
+      await lstat(join2(at, ".git"));
+      return at;
+    } catch {
+    }
+    if (dirname3(at) === at) {
+      return void 0;
+    }
   }
-};
-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;
+async function readManagedFile(root, path) {
+  await assertInsideRepository(root, path);
+  return readIfExists(join2(root, path));
 }
-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 readIfExists(absolutePath) {
+  try {
+    return await readFile5(absolutePath, "utf8");
+  } catch (error) {
+    if (isNodeError2(error, "ENOENT")) {
+      return void 0;
     }
-  };
-}
-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.
-`);
+    throw error;
   }
 }
-
-// src/adapters/cli/initCommand.ts
-function singleRole(roles) {
-  return roles.length === 1 ? roles[0] : void 0;
-}
-async function executeInitCommand(options) {
+async function assertInsideRepository(root, relativePath) {
+  const absolutePath = join2(root, relativePath);
+  const realRoot = await realpath(root);
+  let realParent;
   try {
-    return await runInit(options);
+    realParent = await realpath(dirname3(absolutePath));
   } catch (error) {
-    if (error instanceof PromptCancelled) {
-      options.io.stderr.write(`${error.message}
-`);
-      return 130;
+    if (isNodeError2(error, "ENOENT")) {
+      return;
     }
     throw error;
-  } finally {
-    options.prompter?.close();
   }
+  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;
 }
-async function runInit(initialOptions) {
-  let options = initialOptions;
+
+// src/adapters/cli/initCommand.ts
+async function executeInitCommand(options) {
   const args = parseInitArgs(options.argv);
+  if (args.ignored.length > 0) {
+    options.io.stderr.write(
+      `Ignored ${args.ignored.join(", ")}: init no longer asks for a role or a project \u2014 every session sees the same tools and your AiNecto permissions decide what they may change.
+`
+    );
+  }
   const root = resolve2(options.cwd);
   const rootNotes = await repositoryRootNotes(root);
   const files = await readSnapshot(root);
@@ -3543,47 +3582,18 @@ async function runInit(initialOptions) {
   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({
+  const signedIn = await ensureSignedIn(options, args.dryRun);
+  const documents = signedIn ? await fetchHarnessDocuments({
     endpoint: options.endpoint,
     accessToken: await options.accessToken?.(),
     // 서버가 문서의 클라이언트별 변형 키를 이 이름으로 찾는다.
     client: "ainecto-cli",
     fetchImpl: options.fetchImpl
-  });
+  }) : { versions: {}, fallbacks: {}, unavailableReason: args.dryRun ? "not signed in, and --dry-run does not sign in" : "not signed in" };
   const plan = planInit({
-    role,
     env: options.env,
-    projectName: project.name,
-    projectUuid: project.uuid,
     endpoint: options.endpoint,
+    mcp: args.mcp,
     cliVersion: options.cliVersion,
     files,
     documents
@@ -3592,39 +3602,18 @@ async function runInit(initialOptions) {
     throw new Error(plan.refusal);
   }
   await applyPlan(root, plan, args.dryRun, files);
-  if (!args.dryRun && previousRole2 !== void 0 && previousRole2 !== role) {
-    options.io.stderr.write(`Role changes from ${previousRole2} to ${role}: \`ainecto\` commands now, MCP tools from a new session.
-`);
-  }
+  const mcpWritten = plan.writes.some((write) => AGENT_TARGETS.some((target) => target.path === write.path));
   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}`),
-      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 도구»를 더할 뿐인 선택이다.
+      // ⚠조용히 기본값으로 떨어지지 않는다 — 서버에서 규칙을 고쳐도 안 바뀌는 이유를 사용자가 영영 못 찾는다.
+      //   ★요청 자체의 실패와 «문서별» 되돌림을 둘 다, 어느 «파일»이 그 글을 받는지까지 적는다.
+      notes: [...rootNotes, ...plan.notes, ...fallbackNotes(documents, args.dryRun)],
       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\`).`,
+        `Read ${HARNESS_DOC_PATH} first. Every session sees the same AiNecto tools; your AiNecto permissions decide what they may change.`,
+        mcpWritten ? "Claude Code and Cursor pick up the repository's MCP config in a new session." : "To connect your coding agents on this machine, run `ainecto setup` once (or re-run init with --mcp to also write this repository's .mcp.json and .cursor/mcp.json).",
         "Undo everything with: ainecto init --undo"
       ]
     },
@@ -3632,43 +3621,29 @@ async function runInit(initialOptions) {
   ));
   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;
+function fallbackNotes(documents, dryRun) {
+  const filesOf = {
+    [DOC_KEY]: HARNESS_DOC_PATH,
+    [AGENT_NOTE_KEY]: "AGENTS.md / CLAUDE.md"
+  };
+  const caveat = dryRun ? " \u2014 the real run may write the server's version instead" : "";
+  const reasons = documents.unavailableReason ? { [DOC_KEY]: documents.unavailableReason, [AGENT_NOTE_KEY]: documents.unavailableReason } : documents.fallbacks;
+  return Object.entries(reasons).map(([key, reason]) => `${filesOf[key] ?? key}: written from this package's default ${key}, not the server's (${reason})${caveat}.`);
 }
-async function ensureSignedIn(options, role, dryRun) {
-  if (options.login === void 0) {
-    return;
-  }
+async function ensureSignedIn(options, dryRun) {
   if (await options.accessToken?.()) {
-    return;
+    return true;
   }
-  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.`
-    );
+  if (dryRun || options.login === void 0) {
+    if (dryRun) {
+      options.io.stderr.write(`No usable AiNecto sign-in, so this plan uses the package's default rules. Sign in with: ${loginCommand(options)}
+`);
+    }
+    return false;
   }
   await options.login();
   options.io.stderr.write("Signed in.\n");
+  return true;
 }
 async function repositoryRootNotes(cwd) {
   const gitRoot = await findGitRoot(cwd);
@@ -3686,202 +3661,34 @@ 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
-  );
+function loginCommand(options) {
+  const target = isDefaultEndpointFor(options.env, options.endpoint) ? options.env === "prod" ? "" : ` --env ${options.env}` : ` --endpoint ${options.endpoint}`;
+  return `ainecto auth login${target}`;
 }
-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 } });
+async function readSnapshot(root) {
+  const snapshot = /* @__PURE__ */ new Map();
+  for (const path of MANAGED_PATHS) {
+    snapshot.set(path, await readManagedFile(root, path));
   }
-  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>.`;
+  return snapshot;
 }
-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));
+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);
   }
-  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.`
-    );
+  for (const path of plan.deletes) {
+    await assertInsideRepository(root, path);
+    await assertUnchangedSinceSnapshot(root, path, snapshot);
   }
-  if (args.dryRun) {
-    throw new Error(dryRunCannotCreate(name));
+  if (dryRun) {
+    return;
   }
-  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) {
+  const applied = [];
   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) {
-    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;
-    const recordWrites = plan.writes.filter((write) => isRecord10(write.path));
-    const recordDeletes = plan.deletes.filter((path) => isRecord10(path));
+    const isRecord12 = (path) => !recordFirst && path === HARNESS_RECORD_PATH;
+    const recordWrites = plan.writes.filter((write) => isRecord12(write.path));
+    const recordDeletes = plan.deletes.filter((path) => isRecord12(path));
     const createdDirectories = [...plan.record?.createdDirectories ?? []];
     const rememberDirectories = (directories) => {
       for (const directory of directories) {
@@ -3923,8 +3730,8 @@ async function applyPlan(root, plan, dryRun, snapshot, recordFirst = true) {
     };
     try {
       await apply(
-        orderedWrites(plan.writes.filter((write) => !isRecord10(write.path)), recordFirst),
-        plan.deletes.filter((path) => !isRecord10(path))
+        orderedWrites(plan.writes.filter((write) => !isRecord12(write.path)), recordFirst),
+        plan.deletes.filter((path) => !isRecord12(path))
       );
       await recordDirectoriesOrExplain(false);
       await apply(recordWrites, recordDeletes);
@@ -3961,8 +3768,8 @@ async function assertUnchangedSinceSnapshot(root, relativePath, snapshot) {
 }
 async function writeManagedFile(root, write, onDirectoriesCreated) {
   const absolutePath = join3(root, write.path);
-  const targetDirectory = dirname3(absolutePath);
-  const firstCreated = await mkdir2(targetDirectory, { recursive: true });
+  const targetDirectory = dirname4(absolutePath);
+  const firstCreated = await mkdir3(targetDirectory, { recursive: true });
   const created = createdChain(root, firstCreated, targetDirectory);
   onDirectoriesCreated?.(created);
   const previousMode = await fileMode(absolutePath);
@@ -3971,7 +3778,7 @@ async function writeManagedFile(root, write, onDirectoriesCreated) {
   if (previousMode !== void 0) {
     await chmod2(tmpPath, previousMode);
   }
-  await rename2(tmpPath, absolutePath);
+  await rename3(tmpPath, absolutePath);
   return created;
 }
 function createdChain(root, firstCreated, targetDirectory) {
@@ -3980,12 +3787,12 @@ function createdChain(root, firstCreated, targetDirectory) {
   }
   const stop = resolve2(firstCreated);
   const made = [];
-  for (let at = resolve2(targetDirectory); ; at = dirname3(at)) {
+  for (let at = resolve2(targetDirectory); ; at = dirname4(at)) {
     const asRelative = relative(root, at);
     if (asRelative && !asRelative.startsWith("..")) {
       made.push(asRelative.split(sep2).join("/"));
     }
-    if (at === stop || dirname3(at) === at) {
+    if (at === stop || dirname4(at) === at) {
       break;
     }
   }
@@ -3995,29 +3802,33 @@ async function fileMode(absolutePath) {
   try {
     return (await stat3(absolutePath)).mode & 4095;
   } catch (error) {
-    if (isRecord9(error) && error.code === "ENOENT") {
+    if (isRecord11(error) && error.code === "ENOENT") {
       return void 0;
     }
     throw error;
   }
 }
 function parseInitArgs(argv) {
-  const args = { dryRun: false, undo: false, yes: false };
+  const args = { mcp: false, dryRun: false, undo: false, ignored: [] };
   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]);
+    if (arg === "--mcp") {
+      args.mcp = true;
     } else if (arg === "--dry-run") {
       args.dryRun = true;
     } else if (arg === "--undo") {
       args.undo = true;
+    } else if (arg === "--project" || arg === "--project-name") {
+      const value = argv[index + 1];
+      if (value !== void 0 && !value.startsWith("--")) {
+        index += 1;
+      }
+      args.ignored.push(arg);
     } else if (arg === "--yes" || arg === "-y") {
-      args.yes = true;
+      args.ignored.push(arg);
     } else if (arg === "--json") {
     } else {
       throw new Error(`Unknown argument: ${arg}`);
@@ -4025,21 +3836,730 @@ function parseInitArgs(argv) {
   }
   return args;
 }
-function requireValue3(flag, value) {
-  if (!value || value.startsWith("--")) {
-    throw new Error(`${flag} requires a value.`);
+function isRecord11(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+// src/core/setup/accountSummary.ts
+async function readAccount(client) {
+  const summary = {};
+  try {
+    await client.initialize();
+    const self = unwrapMcpToolPayload(await client.toolsCall("identity_get_self", {}));
+    if (typeof self?.userId === "string") summary.userId = self.userId;
+    if (typeof self?.displayName === "string") summary.displayName = self.displayName;
+    if ("jobProfile" in (self ?? {})) {
+      const profile = self.jobProfile;
+      summary.jobTitle = profile && typeof profile.title === "string" ? profile.title : null;
+    }
+    summary.projectCount = extractProjects(unwrapMcpToolPayload(await client.toolsCall("list_projects", {}))).length;
+  } catch (error) {
+    summary.problem = classify(error);
   }
-  return value;
+  return summary;
 }
-function basenameOf(path) {
-  const parts = path.split(/[\\/]/).filter(Boolean);
-  return parts[parts.length - 1] ?? "ainecto-project";
+function classify(error) {
+  const message = error instanceof Error ? error.message : String(error);
+  if (error instanceof McpRpcError && error.code === "MCP_HTTP_ERROR") {
+    const status = error.details?.status;
+    if (status === 401) return { kind: "unauthorized", message };
+    if (status === 403) return { kind: "forbidden", message };
+    return { kind: "other", message };
+  }
+  if (error instanceof McpRpcError) {
+    return { kind: "other", message };
+  }
+  return { kind: "network", message };
 }
-function isRecord9(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
+
+// src/core/setup/agentConnections.ts
+import { chmod as chmod3, mkdir as mkdir4, readFile as readFile6, rename as rename4, stat as stat4, writeFile as writeFile3 } from "fs/promises";
+import { dirname as dirname5, join as join4 } from "path";
+
+// src/core/setup/commandRunner.ts
+import { spawn as spawn2 } from "child_process";
+var COMMAND_TIMEOUT_MS = 9e4;
+function systemCommandRunner(options) {
+  return (command, args) => new Promise((resolve3) => {
+    let stdout = "";
+    let stderr = "";
+    let settled = false;
+    const finish = (result) => {
+      if (!settled) {
+        settled = true;
+        clearTimeout(timer);
+        resolve3(result);
+      }
+    };
+    const child = spawn2(command, [...args], {
+      cwd: options.cwd,
+      env: options.env ?? process.env,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    const timer = setTimeout(() => {
+      child.kill();
+      finish({ exitCode: null, stdout, stderr: `${stderr}
+${command} timed out after ${COMMAND_TIMEOUT_MS / 1e3}s`, missing: false });
+    }, COMMAND_TIMEOUT_MS);
+    child.stdout.on("data", (chunk) => {
+      stdout += String(chunk);
+    });
+    child.stderr.on("data", (chunk) => {
+      stderr += String(chunk);
+    });
+    child.on("error", (error) => {
+      finish({ exitCode: null, stdout, stderr: error.message, missing: error.code === "ENOENT" });
+    });
+    child.on("close", (code) => finish({ exitCode: code, stdout, stderr, missing: false }));
+  });
+}
+function recordingRunner(runner, log) {
+  return async (command, args) => {
+    const result = await runner(command, args);
+    const entry = { command: [command, ...args].join(" "), exitCode: result.exitCode };
+    if (result.missing) {
+      entry.missing = true;
+    } else if (result.exitCode !== 0) {
+      entry.error = lastLine(result.stderr) ?? lastLine(result.stdout);
+    }
+    log.push(entry);
+    return result;
+  };
+}
+function lastLine(text) {
+  const lines = text.split("\n").map((line) => line.trim()).filter(Boolean);
+  return lines[lines.length - 1];
+}
+
+// src/core/setup/agentConnections.ts
+var AGENT_CLIENT_LABELS = {
+  "claude-code": "Claude Code",
+  cursor: "Cursor",
+  codex: "Codex"
+};
+async function inspectAgents(context) {
+  return [await inspectClaude(context), await inspectCursor(context), await inspectCodex(context)];
+}
+var NOT_FOUND = /No MCP server named/i;
+async function inspectClaude({ runner }) {
+  const base = { client: "claude-code", ours: false, carriesRole: false };
+  const result = await runner("claude", ["mcp", "get", SERVER_NAME]);
+  if (result.missing) {
+    return { ...base, installed: false };
+  }
+  if (result.exitCode !== 0) {
+    return NOT_FOUND.test(result.stdout + result.stderr) ? { ...base, installed: true } : { ...base, installed: true, problem: lastLine(result.stderr) ?? `claude mcp get exited ${result.exitCode}` };
+  }
+  const field = (name) => result.stdout.match(new RegExp(`^\\s*${name}:\\s*(.*)$`, "m"))?.[1]?.trim();
+  const scopeText = field("Scope") ?? "";
+  const scope = /^user/i.test(scopeText) ? "user" : /^local/i.test(scopeText) ? "local" : /^project/i.test(scopeText) ? "project" : scopeText || void 0;
+  const url = field("URL");
+  const command = field("Command");
+  const entry = url ? { url } : command ? { command, args: (field("Args") ?? "").split(/\s+/).filter(Boolean) } : void 0;
+  return { ...base, installed: true, scope, ...describe(entry) };
+}
+async function inspectCursor({ home }) {
+  const base = { client: "cursor", ours: false, carriesRole: false, scope: "global" };
+  if (!await exists(join4(home, ".cursor"))) {
+    return { ...base, installed: false };
+  }
+  let content;
+  try {
+    content = await readFile6(cursorConfigPath(home), "utf8");
+  } catch (error) {
+    if (!isNodeError3(error, "ENOENT")) {
+      return { ...base, installed: true, problem: error instanceof Error ? error.message : String(error) };
+    }
+  }
+  if (content !== void 0 && content.trim()) {
+    try {
+      JSON.parse(content);
+    } catch {
+      return { ...base, installed: true, problem: `${cursorConfigPath(home)} is not valid JSON` };
+    }
+  }
+  const raw = readServerEntry(content);
+  return { ...base, installed: true, ...describe(toExisting(raw)) };
+}
+async function inspectCodex({ runner }) {
+  const base = { client: "codex", ours: false, carriesRole: false, scope: "global" };
+  const result = await runner("codex", ["mcp", "get", SERVER_NAME, "--json"]);
+  if (result.missing) {
+    return { ...base, installed: false };
+  }
+  if (result.exitCode !== 0) {
+    return NOT_FOUND.test(result.stdout + result.stderr) ? { ...base, installed: true } : { ...base, installed: true, problem: lastLine(result.stderr) ?? `codex mcp get exited ${result.exitCode}` };
+  }
+  try {
+    const parsed = JSON.parse(result.stdout);
+    const transport = parsed.transport ?? {};
+    return { ...base, installed: true, ...describe(toExisting(transport)) };
+  } catch {
+    return { ...base, installed: true, problem: "codex mcp get --json did not return JSON" };
+  }
+}
+async function connectAgent(state, desired, context, dryRun) {
+  const outcome = (status, detail) => ({
+    client: state.client,
+    label: AGENT_CLIENT_LABELS[state.client],
+    status,
+    ...dryRun && (status === "connected" || status === "updated") ? { planned: true } : {},
+    ...detail ? { detail } : {}
+  });
+  if (!state.installed) {
+    return outcome("not installed");
+  }
+  if (state.problem) {
+    return outcome("failed", state.problem);
+  }
+  if (state.entry && (!state.ours || state.client === "claude-code" && state.scope !== "user")) {
+    return outcome("kept", keptDetail(state));
+  }
+  if (state.entry && sameEntry(state.entry, desired)) {
+    return outcome("connected", "already connected");
+  }
+  const updating = state.entry !== void 0;
+  const commands = writeCommands(state.client, desired, updating);
+  if (dryRun) {
+    return outcome(updating ? "updated" : "connected", commands.length > 0 ? `would run: ${commands.map((c) => c.join(" ")).join(" && ")}` : `would write ${cursorConfigPath(context.home)}`);
+  }
+  try {
+    if (state.client === "cursor") {
+      const path = cursorConfigPath(context.home);
+      await writeKeepingMode(path, mergeServerEntry(await readIfExists2(path), desired).content);
+    }
+    for (const [command, ...args] of commands) {
+      const result = await context.runner(command, args);
+      if (result.exitCode !== 0) {
+        return outcome("failed", `${[command, ...args].join(" ")}: ${lastLine(result.stderr) ?? lastLine(result.stdout) ?? `exit ${result.exitCode}`}`);
+      }
+    }
+  } catch (error) {
+    return outcome("failed", error instanceof Error ? error.message : String(error));
+  }
+  return outcome(updating ? "updated" : "connected");
+}
+async function disconnectAgent(state, context, dryRun) {
+  const outcome = (status, detail) => ({
+    client: state.client,
+    label: AGENT_CLIENT_LABELS[state.client],
+    status,
+    ...dryRun && status === "removed" ? { planned: true } : {},
+    ...detail ? { detail } : {}
+  });
+  if (!state.installed) {
+    return outcome("not installed");
+  }
+  if (state.problem) {
+    return outcome("failed", state.problem);
+  }
+  if (!state.entry) {
+    return outcome("not connected");
+  }
+  if (!state.ours || state.client === "claude-code" && state.scope !== "user") {
+    return outcome("kept", keptDetail(state));
+  }
+  if (dryRun) {
+    return outcome("removed");
+  }
+  try {
+    if (state.client === "cursor") {
+      const path = cursorConfigPath(context.home);
+      const removed = removeServerEntry(await readIfExists2(path));
+      if (removed.content !== void 0) {
+        await writeKeepingMode(path, removed.content);
+      }
+    } else {
+      const [command, ...args] = removeCommand(state.client);
+      const result = await context.runner(command, args);
+      if (result.exitCode !== 0) {
+        return outcome("failed", `${[command, ...args].join(" ")}: ${lastLine(result.stderr) ?? `exit ${result.exitCode}`}`);
+      }
+    }
+  } catch (error) {
+    return outcome("failed", error instanceof Error ? error.message : String(error));
+  }
+  return outcome("removed");
+}
+function desiredEntry(input) {
+  return buildServerEntry({ env: input.env, endpoint: input.endpoint });
+}
+function cursorConfigPath(home) {
+  return join4(home, ".cursor", "mcp.json");
+}
+function writeCommands(client, entry, updating) {
+  const bridge = [entry.command, ...entry.args];
+  if (client === "claude-code") {
+    return [
+      ...updating ? [["claude", "mcp", "remove", "-s", "user", SERVER_NAME]] : [],
+      ["claude", "mcp", "add", "-s", "user", SERVER_NAME, "--", ...bridge]
+    ];
+  }
+  if (client === "codex") {
+    return [["codex", "mcp", "add", SERVER_NAME, "--", ...bridge]];
+  }
+  return [];
+}
+function removeCommand(client) {
+  return client === "claude-code" ? ["claude", "mcp", "remove", "-s", "user", SERVER_NAME] : ["codex", "mcp", "remove", SERVER_NAME];
+}
+function keptDetail(state) {
+  if (state.client === "claude-code" && state.ours && state.scope !== "user") {
+    return `a ${state.scope}-scope "${SERVER_NAME}" entry takes precedence here \u2014 left as it is`;
+  }
+  const where = state.scope ? ` (${state.scope})` : "";
+  return `someone else's "${SERVER_NAME}" entry${where} \u2014 left untouched`;
+}
+function describe(entry) {
+  if (!entry) {
+    return { ours: false, carriesRole: false };
+  }
+  if ("url" in entry) {
+    return { entry, ours: false, carriesRole: false };
+  }
+  const pinnedVersion = pinnedBridgeVersion(entry);
+  return {
+    entry,
+    ours: isOurBridge(entry),
+    carriesRole: entryCarriesRole(entry),
+    ...pinnedVersion ? { pinnedVersion } : {}
+  };
+}
+function toExisting(raw) {
+  if (typeof raw !== "object" || raw === null) {
+    return void 0;
+  }
+  const { command, args, url } = raw;
+  if (typeof url === "string" && url) {
+    return { url };
+  }
+  if (typeof command === "string") {
+    return { command, args: Array.isArray(args) ? args.filter((arg) => typeof arg === "string") : [] };
+  }
+  return void 0;
+}
+function sameEntry(entry, desired) {
+  return "command" in entry && entry.command === desired.command && entry.args.length === desired.args.length && entry.args.every((arg, at) => arg === desired.args[at]);
+}
+async function writeKeepingMode(path, content) {
+  await mkdir4(dirname5(path), { recursive: true });
+  let mode;
+  try {
+    mode = (await stat4(path)).mode & 4095;
+  } catch (error) {
+    if (!isNodeError3(error, "ENOENT")) {
+      throw error;
+    }
+  }
+  const tmp = `${path}.${process.pid}.${Date.now()}.tmp`;
+  await writeFile3(tmp, content, { encoding: "utf8", mode: mode ?? 384 });
+  if (mode !== void 0) {
+    await chmod3(tmp, mode);
+  }
+  await rename4(tmp, path);
+}
+async function readIfExists2(path) {
+  try {
+    return await readFile6(path, "utf8");
+  } catch (error) {
+    if (isNodeError3(error, "ENOENT")) {
+      return void 0;
+    }
+    throw error;
+  }
+}
+async function exists(path) {
+  try {
+    await stat4(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function isNodeError3(error, code) {
+  return typeof error === "object" && error !== null && error.code === code;
+}
+
+// src/adapters/cli/setupCommand.ts
+async function executeSetupCommand(options) {
+  const args = parseSetupArgs(options.argv);
+  const commands = [];
+  const context = { runner: recordingRunner(options.runner, commands), home: options.home };
+  if (args.undo) {
+    const states = await inspectAgents(context);
+    const agents2 = [];
+    for (const state of states) {
+      agents2.push(await disconnectAgent(state, context, args.dryRun));
+    }
+    const failed2 = agents2.some((agent) => agent.status === "failed");
+    options.io.stdout.write(renderSuccess({
+      action: args.dryRun ? "setup --undo (dry-run)" : "setup --undo",
+      agents: agents2,
+      commands,
+      notes: ["Your sign-in is kept \u2014 sign out with `ainecto auth logout`."]
+    }, { json: options.json }));
+    return failed2 ? 1 : 0;
+  }
+  let signedIn = Boolean(await options.auth.getAccessToken());
+  if (!signedIn && !args.dryRun) {
+    await options.auth.login();
+    options.io.stderr.write("Signed in.\n");
+    signedIn = true;
+  }
+  const account = signedIn ? await readAccount(options.client) : void 0;
+  const desired = desiredEntry({ env: options.env, endpoint: options.endpoint });
+  const agents = [];
+  for (const state of await inspectAgents(context)) {
+    agents.push(await connectAgent(state, desired, context, args.dryRun));
+  }
+  const failed = agents.some((agent) => agent.status === "failed") || account?.problem !== void 0;
+  options.io.stdout.write(renderSuccess({
+    action: args.dryRun ? "setup (dry-run)" : "setup",
+    setup: failed ? "partial" : "complete",
+    endpoint: options.endpoint,
+    account: accountView(account, signedIn, options.endpoint),
+    agents,
+    commands,
+    next: nextSteps(account, agents, options.endpoint)
+  }, { json: options.json }));
+  return failed ? 1 : 0;
+}
+function accountView(account, signedIn, endpoint) {
+  if (!signedIn) {
+    return { signedIn: false, note: "sign-in required \u2014 `ainecto setup` (without --dry-run) opens the browser once" };
+  }
+  const view = { signedIn: true };
+  if (account?.userId) view.userId = account.userId;
+  if (account?.displayName) view.name = account.displayName;
+  if (account?.jobTitle !== void 0) {
+    view.jobTitle = account.jobTitle ?? `not set \u2014 set it at ${profileSettingsUrl(endpoint)}`;
+  }
+  if (account?.projectCount !== void 0) view.projects = account.projectCount;
+  if (account?.problem) view.problem = `${account.problem.kind}: ${account.problem.message}`;
+  return view;
+}
+function nextSteps(account, agents, endpoint) {
+  const next = [];
+  if (agents.some((agent) => agent.status === "connected" || agent.status === "updated")) {
+    next.push("Start a new agent session to load the AiNecto tools. Every session sees the same tools; your AiNecto permissions decide what they may change.");
+  }
+  if (account?.jobTitle === null) {
+    next.push(`Set your AiNecto role (your job) at ${profileSettingsUrl(endpoint)} \u2014 AI uses it to pitch explanations; it does not change permissions.`);
+  }
+  next.push("To add AiNecto's working rules to a repository, run `ainecto init` from its root.");
+  next.push("`ainecto doctor` shows anything still missing.");
+  return next;
+}
+function parseSetupArgs(argv) {
+  const args = { dryRun: false, undo: false };
+  for (const arg of argv) {
+    if (arg === "--dry-run") {
+      args.dryRun = true;
+    } else if (arg === "--undo") {
+      args.undo = true;
+    } else if (arg === "--json") {
+    } else {
+      throw new Error(`Unknown argument: ${arg}`);
+    }
+  }
+  return args;
+}
+
+// src/core/setup/doctorChecks.ts
+function doctorChecks(status) {
+  const checks = [];
+  const settings = profileSettingsUrl(status.endpoint);
+  if (status.token.state === "not-signed-in") {
+    checks.push({ item: "sign-in", level: "fail", detail: `not signed in to ${status.endpoint}`, fix: "ainecto setup" });
+  } else if (status.token.state === "refresh-failed") {
+    checks.push({ item: "sign-in", level: "fail", detail: `sign-in expired and could not be renewed (${status.token.reason})`, fix: "ainecto setup" });
+  } else {
+    checks.push({ item: "sign-in", level: "ok", detail: status.token.state === "env" ? "AINECTO_TOKEN" : "signed in" });
+  }
+  const problem = status.account?.problem;
+  if (problem?.kind === "network") {
+    checks.push({ item: "server", level: "fail", detail: `cannot reach ${status.endpoint} (${problem.message})`, fix: "check the network, or the --endpoint you passed" });
+  } else if (problem?.kind === "unauthorized") {
+    checks.push({ item: "server", level: "fail", detail: `${status.endpoint} refused the sign-in (HTTP 401)`, fix: "ainecto auth login" });
+  } else if (problem?.kind === "forbidden") {
+    checks.push({ item: "server", level: "fail", detail: "the account's plan does not include MCP, or the account is not active (HTTP 403)", fix: `check your plan at ${settings}` });
+  } else if (problem) {
+    checks.push({ item: "server", level: "fail", detail: problem.message });
+  } else if (status.account) {
+    checks.push({ item: "server", level: "ok", detail: `${status.endpoint} answered; ${status.account.projectCount ?? 0} project(s) visible` });
+  }
+  for (const agent of status.agents) {
+    checks.push(agentCheck(agent, status.cliVersion));
+  }
+  if (status.claudeHere?.entry && status.claudeHere.scope === "local") {
+    const hereOursUpToDate = status.claudeHere.ours && !status.claudeHere.carriesRole;
+    if (!hereOursUpToDate) {
+      checks.push({
+        item: "Claude Code (this folder)",
+        level: "warn",
+        detail: `a local-scope "${SERVER_NAME}" entry in this folder hides the user-scope connection`,
+        fix: `claude mcp remove ${SERVER_NAME} -s local`
+      });
+    }
+  }
+  const repo = status.repository;
+  if (repo?.problem) {
+    checks.push({ item: "repository", level: "warn", detail: repo.problem });
+  } else if (repo) {
+    const leftovers = [
+      ...repo.mcpFiles.filter((file) => file.ours && file.carriesRole).map((file) => `${file.path} passes the removed --role`),
+      ...repo.mcpFiles.filter((file) => file.ours && olderThan(file.pinnedVersion, status.cliVersion)).map((file) => `${file.path} pins @ainecto/mcp@${file.pinnedVersion}`),
+      ...repo.configHasProject ? [".ainecto/config.json still has the old project field"] : []
+    ];
+    if (leftovers.length > 0) {
+      checks.push({ item: "repository", level: "warn", detail: leftovers.join("; "), fix: `ainecto init (in ${repo.root})` });
+    } else {
+      checks.push({
+        item: "repository",
+        level: "ok",
+        detail: repo.harnessDoc ? `AiNecto rules are set up in ${repo.root}` : `no AiNecto rules in ${repo.root} (optional \u2014 \`ainecto init\` adds them)`
+      });
+    }
+  }
+  for (const name of status.legacyEnv) {
+    checks.push({ item: name, level: "warn", detail: `${name} is set; roles were removed and it is ignored`, fix: `unset ${name} (it can be deleted)` });
+  }
+  if (status.legacyCodexProfiles.length > 0) {
+    checks.push({
+      item: "Codex role profiles",
+      level: "warn",
+      detail: `these Codex profiles still pass --role: ${status.legacyCodexProfiles.join(", ")}`,
+      fix: "delete them \u2014 `ainecto setup` connects Codex for every session"
+    });
+  }
+  if (status.globalCliVersion && olderThan(status.globalCliVersion, status.cliVersion)) {
+    checks.push({
+      item: "global ainecto",
+      level: "warn",
+      detail: `the ainecto on your PATH is ${status.globalCliVersion}, older than ${status.cliVersion}`,
+      fix: "npm i -g ainecto@latest"
+    });
+  }
+  if (status.account?.jobTitle === null) {
+    checks.push({ item: "AiNecto job title", level: "warn", detail: "not set \u2014 AI uses it to pitch explanations; it does not change permissions", fix: `set it at ${settings}` });
+  } else if (typeof status.account?.jobTitle === "string") {
+    checks.push({ item: "AiNecto job title", level: "ok", detail: status.account.jobTitle });
+  }
+  return checks;
+}
+function agentCheck(agent, cliVersion) {
+  const item = AGENT_CLIENT_LABELS[agent.client];
+  if (!agent.installed) {
+    return { item, level: "ok", detail: "not installed" };
+  }
+  if (agent.problem) {
+    return { item, level: "fail", detail: agent.problem, fix: "ainecto setup" };
+  }
+  if (!agent.entry) {
+    return { item, level: "warn", detail: "not connected to AiNecto", fix: "ainecto setup" };
+  }
+  if (!agent.ours) {
+    return {
+      item,
+      level: "warn",
+      detail: `someone else's "${SERVER_NAME}" entry${agent.scope ? ` (${agent.scope})` : ""} \u2014 AiNecto setup leaves it alone`,
+      fix: agent.client === "claude-code" ? `claude mcp get ${SERVER_NAME}` : "keep it, or remove it and run `ainecto setup`"
+    };
+  }
+  if (agent.client === "claude-code" && agent.scope !== "user") {
+    return { item, level: "warn", detail: `connected in the ${agent.scope} scope, not for every project`, fix: "ainecto setup" };
+  }
+  if (agent.carriesRole) {
+    return { item, level: "warn", detail: "connected, but still passes the removed --role", fix: "ainecto setup" };
+  }
+  if (olderThan(agent.pinnedVersion, cliVersion)) {
+    return { item, level: "warn", detail: `connected with @ainecto/mcp@${agent.pinnedVersion}; ${cliVersion} is available`, fix: "ainecto setup" };
+  }
+  return { item, level: "ok", detail: agent.pinnedVersion ? `connected (@ainecto/mcp@${agent.pinnedVersion})` : "connected" };
+}
+function olderThan(a, b) {
+  const left = parseVersion(a);
+  const right = parseVersion(b);
+  if (!left || !right) {
+    return false;
+  }
+  for (let at = 0; at < 3; at += 1) {
+    if (left[at] !== right[at]) {
+      return left[at] < right[at];
+    }
+  }
+  return false;
+}
+function parseVersion(value) {
+  const match = value?.match(/^(\d+)\.(\d+)\.(\d+)/);
+  return match ? [Number(match[1]), Number(match[2]), Number(match[3])] : void 0;
+}
+
+// src/core/setup/machineStatus.ts
+import { readdir, readFile as readFile7 } from "fs/promises";
+import { join as join5 } from "path";
+async function collectStatus(input) {
+  const token = await tokenStatus(input);
+  const usable = token.state === "env" || token.state === "signed-in";
+  const status = {
+    cliVersion: input.cliVersion,
+    endpoint: input.endpoint,
+    env: input.env,
+    token,
+    agents: await inspectAgents({ runner: input.runner, home: input.home }),
+    legacyEnv: [LEGACY_ROLE_ENV_VAR, "AI_ERD_ROLE"].filter((name) => input.envVars[name]?.trim()),
+    legacyCodexProfiles: await legacyCodexProfiles(input.envVars.CODEX_HOME ?? join5(input.home, ".codex"))
+  };
+  if (usable) {
+    status.account = await readAccount(input.client);
+  }
+  if (input.hereRunner && input.cwd !== input.home) {
+    status.claudeHere = await inspectClaude({ runner: input.hereRunner, home: input.home });
+  }
+  status.repository = await repositoryStatus(input.cwd);
+  const globalVersion = await globalCliVersion(input.runner);
+  if (globalVersion) {
+    status.globalCliVersion = globalVersion;
+  }
+  return status;
+}
+async function tokenStatus(input) {
+  if (input.envVars.AINECTO_TOKEN) {
+    return { state: "env" };
+  }
+  const stored = await input.tokenStore.load(input.endpoint);
+  const expiresAt = stored?.expiresAt ? new Date(stored.expiresAt).toISOString() : void 0;
+  try {
+    const token = await input.auth.getAccessToken();
+    if (token) {
+      return { state: "signed-in", ...expiresAt ? { expiresAt } : {} };
+    }
+    return stored ? { state: "refresh-failed", ...expiresAt ? { expiresAt } : {}, reason: "the stored sign-in expired and has no refresh token" } : { state: "not-signed-in" };
+  } catch (error) {
+    return {
+      state: "refresh-failed",
+      ...expiresAt ? { expiresAt } : {},
+      reason: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+async function repositoryStatus(cwd) {
+  const gitRoot = await findGitRoot(cwd);
+  const root = gitRoot ?? cwd;
+  const status = { root, git: gitRoot !== void 0, harnessDoc: false, configHasProject: false, mcpFiles: [] };
+  try {
+    status.harnessDoc = await readManagedFile(root, HARNESS_DOC_PATH) !== void 0;
+    const config = parseObject(await readManagedFile(root, HARNESS_CONFIG_PATH));
+    if (config) {
+      if (typeof config.version === "number") status.configVersion = config.version;
+      status.configHasProject = Object.prototype.hasOwnProperty.call(config, "project");
+      const versions = config.promptVersions;
+      if (typeof versions?.[DOC_KEY] === "string") status.harnessDocVersion = versions[DOC_KEY];
+    }
+    for (const target of AGENT_TARGETS) {
+      const entry = readServerEntry(await readManagedFile(root, target.path));
+      if (entry !== void 0) {
+        const pinnedVersion = pinnedBridgeVersion(entry);
+        status.mcpFiles.push({
+          path: target.path,
+          ours: isOurBridge(entry),
+          carriesRole: entryCarriesRole(entry),
+          ...pinnedVersion ? { pinnedVersion } : {}
+        });
+      }
+    }
+  } catch (error) {
+    status.problem = error instanceof Error ? error.message : String(error);
+  }
+  return status;
+}
+async function legacyCodexProfiles(codexHome) {
+  let names;
+  try {
+    names = await readdir(codexHome);
+  } catch {
+    return [];
+  }
+  const found = [];
+  for (const name of names.filter((file) => file.endsWith(".config.toml"))) {
+    const content = await readFile7(join5(codexHome, name), "utf8").catch(() => "");
+    if (content.includes(PACKAGE_NAME) && content.includes("--role")) {
+      found.push(join5(codexHome, name));
+    }
+  }
+  return found;
+}
+async function globalCliVersion(runner) {
+  const result = await runner("ainecto", ["--version", "--json"]);
+  if (result.missing || result.exitCode !== 0) {
+    return void 0;
+  }
+  try {
+    const version = JSON.parse(result.stdout).data?.version;
+    return typeof version === "string" ? version : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function parseObject(content) {
+  if (content === void 0) {
+    return void 0;
+  }
+  try {
+    const parsed = JSON.parse(content);
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+
+// src/adapters/cli/statusCommand.ts
+async function executeStatusCommand(options) {
+  assertNoArgs("status", options.argv);
+  const status = await collectStatus(options.collect);
+  options.io.stdout.write(renderSuccess(statusView(status), { json: options.json }));
+  return 0;
+}
+async function executeDoctorCommand(options) {
+  assertNoArgs("doctor", options.argv);
+  const status = await collectStatus(options.collect);
+  const checks = doctorChecks(status);
+  const failed = checks.filter((check) => check.level === "fail").length;
+  const warned = checks.filter((check) => check.level === "warn").length;
+  options.io.stdout.write(renderSuccess({
+    summary: failed > 0 ? `${failed} problem(s) to fix` : warned > 0 ? `working \u2014 ${warned} suggestion(s)` : "all good",
+    checks
+  }, { json: options.json }));
+  return failed > 0 ? 1 : 0;
+}
+function statusView(status) {
+  const signedIn = status.token.state === "env" || status.token.state === "signed-in";
+  return {
+    cli: status.cliVersion,
+    endpoint: status.endpoint,
+    env: status.env,
+    signIn: status.token,
+    account: accountView(status.account, signedIn, status.endpoint),
+    agents: status.agents.map((agent) => ({
+      client: AGENT_CLIENT_LABELS[agent.client],
+      state: !agent.installed ? "not installed" : agent.problem ? `unknown (${agent.problem})` : !agent.entry ? "not connected" : agent.ours ? `connected${agent.scope ? ` (${agent.scope})` : ""}` : `someone else's entry${agent.scope ? ` (${agent.scope})` : ""}`,
+      ...agent.pinnedVersion ? { bridge: `@ainecto/mcp@${agent.pinnedVersion}` } : {},
+      ...agent.carriesRole ? { legacyRole: true } : {}
+    })),
+    ...status.claudeHere?.entry ? { claudeCodeHere: { scope: status.claudeHere.scope, ours: status.claudeHere.ours } } : {},
+    repository: status.repository,
+    ...status.globalCliVersion ? { globalAinecto: status.globalCliVersion } : {}
+  };
+}
+function assertNoArgs(command, argv) {
+  const unknown = argv.filter((arg) => arg !== "--json");
+  if (unknown.length > 0) {
+    throw new Error(`Unknown argument for ${command}: ${unknown[0]}`);
+  }
 }
 
 // src/adapters/cli/ainectoCli.ts
+import { homedir as homedir2 } from "os";
 async function runAinectoCli(argv, io) {
   let parsed = { json: argv.includes("--json"), help: false, version: false, positionals: [] };
   try {
@@ -4053,15 +4573,21 @@ async function runAinectoCli(argv, io) {
       return 0;
     }
     const resolved = resolveEndpoint({ env: parsed.env, endpoint: parsed.endpoint });
-    const explicitRole = () => resolveRole({ role: parsed.role });
+    const [domain, action, ...rest] = parsed.positionals;
+    const legacyRole = legacyRoleInput(parsed.legacyRole);
+    if (legacyRole !== void 0 && domain !== "mcp") {
+      io.stderr.write(parsed.json ? `${JSON.stringify({ event: "legacy_role_ignored", message: LEGACY_ROLE_NOTICE })}
+` : `${LEGACY_ROLE_NOTICE}
+`);
+    }
     const tokenStore = new FileTokenStore();
-    const connect = (role) => {
+    const connect = () => {
       const auth = new OAuthClient({
         endpoint: resolved.endpoint,
         tokenStore,
-        // ★init --dry-run 은 토큰을 갱신하지도 않는다 — 「아무것도 바꾸지 않는다」에 로그인 상태도 든다.
-        //   (init 의 플래그는 positional 로 흘러온다.)
-        readOnly: parsed.positionals[0] === "init" && parsed.positionals.includes("--dry-run"),
+        // ★init·setup --dry-run 은 토큰을 갱신하지도 않는다 — 「아무것도 바꾸지 않는다」에 로그인 상태도 든다.
+        //   (하위 명령의 플래그는 positional 로 흘러온다.)
+        readOnly: (domain === "init" || domain === "setup") && parsed.positionals.includes("--dry-run"),
         // ★URL 을 «브라우저를 열기 전에» 알린다. stdout 은 결과 전용이라 stderr 에 쓴다.
         //   --json 이면 JSON 한 줄이다(설계 §21-3 (가)). 로그인이 역할과 무관해져 role 칸은 없다(0.4.2 §2-5).
         onAuthorizeUrl: (url) => {
@@ -4071,15 +4597,13 @@ async function runAinectoCli(argv, io) {
 `);
         }
       });
-      const client2 = new McpRpcClient({ endpoint: resolved.endpoint, tokenProvider: auth, role });
+      const client2 = new McpRpcClient({ endpoint: resolved.endpoint, tokenProvider: auth, legacyRole, channel: "cli" });
       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,
+        legacyRoleFlag: parsed.legacyRole,
         input: io.stdin,
         output: io.stdout,
         errorOutput: io.stderr
@@ -4087,36 +4611,27 @@ async function runAinectoCli(argv, io) {
       return 0;
     }
     if (domain === "init") {
+      const { auth } = connect();
       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();
+        // 문서는 인증 후에 받는다 — 토큰이 없으면 패키지 기본값으로 가고, 그 사실을 보고한다.
+        // ★«필요할 때» 가져온다. --undo 는 로컬 작업이라 토큰을 건드리지 않는다(S1).
+        // ★갱신 실패는 «토큰 없음»(→ 로그인)이지만, AINECTO_TOKEN 을 못 쓰는 주소라는 거절은 삼키지 않는다 —
+        //   삼키면 그 설정 오류가 브라우저 로그인으로 둔갑한다.
+        accessToken: async () => {
+          try {
+            return await auth.getAccessToken();
+          } catch (error) {
+            if (process.env.AINECTO_TOKEN) {
+              throw error;
             }
-          };
+            return void 0;
+          }
+        },
+        // 로그인한다 — `ainecto auth login` 과 같은 함수다. 서버마다 한 번이다.
+        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}`,
@@ -4125,23 +4640,54 @@ async function runAinectoCli(argv, io) {
         io
       });
     }
+    if (domain === "setup") {
+      const { auth, client: client2 } = connect();
+      return await executeSetupCommand({
+        argv: parsed.positionals.slice(1),
+        endpoint: resolved.endpoint,
+        env: resolved.env,
+        auth,
+        client: client2,
+        // ★외부 CLI 는 홈 폴더에서 돈다 — 지금 저장소의 local·project 범위 항목이 사용자 범위 판정에 끼지 않게.
+        runner: systemCommandRunner({ cwd: homedir2() }),
+        home: homedir2(),
+        json: parsed.json,
+        io
+      });
+    }
+    if (domain === "status" || domain === "doctor") {
+      const { auth, client: client2 } = connect();
+      const run = domain === "status" ? executeStatusCommand : executeDoctorCommand;
+      return await run({
+        argv: parsed.positionals.slice(1),
+        collect: {
+          endpoint: resolved.endpoint,
+          env: resolved.env,
+          cliVersion: CLI_VERSION,
+          tokenStore,
+          auth,
+          client: client2,
+          runner: systemCommandRunner({ cwd: homedir2() }),
+          hereRunner: systemCommandRunner({ cwd: process.cwd() }),
+          home: homedir2(),
+          cwd: process.cwd(),
+          envVars: process.env
+        },
+        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);
+      return await handleAuth(action, connect().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;
-      });
+      return await printCatalog(parsed, io, resolved.endpoint, async () => connect().client);
     }
     let routeTools = getGeneratedTools(env);
-    let remote = isAttachmentsUploadCommand(domain, action) || domain === "tools" && (action === "list" || action === "call") || matchGeneratedCommand(routeTools, parsed.positionals) !== void 0;
+    let remote = isAttachmentsUploadCommand(domain, action) || isInboxPollCommand(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);
+      const live = await loadLiveTools(env, connect().client).catch(() => void 0);
       if (live && matchGeneratedCommand(live, parsed.positionals)) {
         routeTools = live;
         remote = true;
@@ -4150,8 +4696,7 @@ async function runAinectoCli(argv, io) {
     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()));
+    const { client } = connect();
     if (isAttachmentsUploadCommand(domain, action)) {
       return await executeAttachmentsUploadCommand({
         argv: rest,
@@ -4160,6 +4705,9 @@ async function runAinectoCli(argv, io) {
         io
       });
     }
+    if (isInboxPollCommand(domain, action)) {
+      return await executeInboxPollCommand({ domain, action, argv: rest, client, json: parsed.json, io });
+    }
     const generatedResult = await executeGeneratedCommand({
       tools: routeTools,
       argv: parsed.positionals,
@@ -4179,23 +4727,6 @@ async function runAinectoCli(argv, io) {
     return 1;
   }
 }
-async function commandRole(explicit, cwd) {
-  const explicitRole = explicit.role ?? null;
-  const found = await findRepositoryRole(cwd);
-  if (found.kind === "conflict") {
-    throw new Error(await askTheUserToFixRole(found.dir, found.reason));
-  }
-  if (found.kind === "none") {
-    return explicitRole;
-  }
-  if (explicitRole !== null && explicitRole !== found.role) {
-    const given = explicit.source === "env" ? `${ROLE_ENV_VAR}=${explicitRole}` : `--role ${explicitRole}`;
-    throw new Error(
-      `This repository's AI sessions have the role ${found.role} (set in ${found.dir}). ${given} does not match \u2014 the role changes only with \`ainecto init --role <role>\`, after asking the user.`
-    );
-  }
-  return found.role;
-}
 async function handleAuth(action, auth, endpoint, json, io) {
   if (action === "login") {
     await auth.login();
@@ -4260,11 +4791,15 @@ function parseGlobalArgs(argv) {
       continue;
     }
     if (arg === "--env") {
-      result.env = assertEnv(requireValue4(arg, argv[++index]));
+      result.env = assertEnv(requireValue3(arg, argv[++index]));
     } else if (arg === "--endpoint") {
-      result.endpoint = requireValue4(arg, argv[++index]);
+      result.endpoint = requireValue3(arg, argv[++index]);
     } else if (arg === "--role") {
-      result.role = assertRole(requireValue4(arg, argv[++index]));
+      const value = argv[index + 1];
+      if (value !== void 0 && !value.startsWith("--")) {
+        result.legacyRole = value;
+        index += 1;
+      }
     } else if (arg === "--json") {
       result.json = true;
     } else if (arg === "--help" || arg === "-h") {
@@ -4286,7 +4821,7 @@ function parsePayloadArgs(argv) {
       continue;
     }
     if (arg === "--file" || arg === "-f") {
-      result.file = requireValue4(arg, argv[++index]);
+      result.file = requireValue3(arg, argv[++index]);
     } else {
       inline.push(arg);
     }
@@ -4296,40 +4831,48 @@ function parsePayloadArgs(argv) {
   }
   return result;
 }
-function requireValue4(flag, value) {
+function requireValue3(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."
+  return { next: NEXT_STEP };
+}
+var NEXT_STEP = [
+  "Connect your coding agents to AiNecto once per machine: `npx -y ainecto@latest setup`.",
+  "AI agents: tell the user this now, even if they only asked to install, update, or sign in.",
+  "To add AiNecto's working rules to a repository, run `npx -y ainecto@latest init` from its root.",
+  "`npx -y ainecto@latest doctor` shows what is still missing and the command that fixes it."
 ].join("\n");
 function helpText() {
   return [
     "AiNecto CLI",
     "",
-    NEXT_STEP_INIT,
+    NEXT_STEP,
     "",
     "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 notifications poll --cursor-file <path> [--kinds A,B] [--workspace <uuid>]... [--project <uuid>]... [--direct-only] [--limit N] [--json]",
+    "  ainecto notifications ack --cursor-file <path>     (after the agent handled the polled batch)",
+    "  ainecto agent-todos poll [--workspace <uuid>]... [--project <uuid>]... [--only-new --seen-file <path>] [--json]",
+    "      --workspace and --project may repeat: any of the given workspaces AND any of the given projects",
+    "      poll exit codes: 0 new items \xB7 3 nothing new \xB7 1 error \xB7 2 usage error",
     "  ainecto <generated-command> [flags] [-f payload.json] [--yes] [--json]",
-    "  ainecto mcp [--env prod|dev] [--endpoint URL] [--role design|development|test|validation]",
+    "  ainecto mcp [--env prod|dev] [--endpoint URL]",
+    "",
+    "Setup (once per machine):",
+    "  ainecto setup [--env prod|dev] [--endpoint URL] [--dry-run] [--json]   sign in and connect Claude Code, Cursor, and Codex",
+    "  ainecto setup --undo                                                   remove those connections (sign-in stays)",
+    "  ainecto status [--json]                                                who is signed in, and what is connected (read-only)",
+    "  ainecto doctor [--json]                                                status + what is missing and the command that fixes it",
     "",
     "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 [--mcp] [--dry-run] [--json]   AiNecto rules for this repository (--mcp also writes .mcp.json and .cursor/mcp.json)",
     "  ainecto init --undo",
     ""
   ].join("\n");