ainecto 0.5.0 → 0.7.0

package/dist/bin/ainecto.js

@@ -8,20 +8,17 @@ import { dirname, join } from "path";
 
 // src/core/harness/role.ts
 var HARNESS_ROLES = ["design", "development", "test", "validation"];
-var ROLE_SCOPE_PREFIX = "ai-erd:role:";
-var ROLE_HEADER = "X-AI-ERD-Role";
+var ROLE_SCOPE_PREFIX = "ainecto:role:";
+var ROLE_HEADER = "X-AiNecto-Role";
 var ROLE_ENV_VAR = "AINECTO_ROLE";
-var LEGACY_ROLE_ENV_VAR = "AI_ERD_ROLE";
 function resolveRole(input = {}) {
   if (input.role !== void 0) {
     return { role: assertRole(input.role), source: "flag" };
   }
   const envVars = input.envVars ?? process.env;
-  for (const envVar of [ROLE_ENV_VAR, LEGACY_ROLE_ENV_VAR]) {
-    const fromEnv = envVars[envVar];
-    if (fromEnv && fromEnv.trim()) {
-      return { role: assertRole(fromEnv), source: "env", envVar };
-    }
+  const fromEnv = envVars[ROLE_ENV_VAR];
+  if (fromEnv && fromEnv.trim()) {
+    return { role: assertRole(fromEnv), source: "env" };
   }
   return { source: "none" };
 }
@@ -124,19 +121,8 @@ import { URLSearchParams } from "url";
 // src/core/config/endpoints.ts
 var DEFAULT_ENDPOINTS = {
   prod: "https://ainecto.com/mcp",
-  dev: "https://dev.ai-erd.com/mcp"
-};
-var LEGACY_PROD_ENDPOINT = "https://ai-erd.com/mcp";
-var LEGACY_DEFAULT_ENDPOINTS = [
-  LEGACY_PROD_ENDPOINT,
-  "https://dev.ainecto.com/mcp"
-];
-var TOKEN_SLOT_FALLBACKS = {
-  [DEFAULT_ENDPOINTS.prod]: [LEGACY_PROD_ENDPOINT]
+  dev: "https://dev.ainecto.com/mcp"
 };
-function fallbackTokenEndpointsFor(endpoint) {
-  return TOKEN_SLOT_FALLBACKS[normalizeEndpoint(endpoint)] ?? [];
-}
 function resolveEndpoint(input = {}) {
   const envVars = input.envVars ?? process.env;
   const env = input.env ?? "prod";
@@ -159,7 +145,7 @@ function isDefaultEndpointFor(env, endpoint) {
 }
 function isDefaultEndpoint(endpoint) {
   const normalized = normalizeEndpoint(endpoint);
-  return Object.values(DEFAULT_ENDPOINTS).includes(normalized) || LEGACY_DEFAULT_ENDPOINTS.includes(normalized);
+  return Object.values(DEFAULT_ENDPOINTS).includes(normalized);
 }
 function assertTrustedEndpointUrl(value, label = "URL") {
   const url = typeof value === "string" ? new URL(value) : value;
@@ -249,7 +235,7 @@ var OAuthClient = class {
       assertEnvTokenEndpointAllowed(this.options.endpoint, this.envVars);
       return envToken;
     }
-    const stored = await this.loadStored();
+    const stored = await this.options.tokenStore.load(this.options.endpoint);
     if (!stored) {
       return void 0;
     }
@@ -265,7 +251,7 @@ var OAuthClient = class {
     return this.refreshStoredToken({ ...stored, refreshToken: stored.refreshToken });
   }
   async refreshAfterUnauthorized() {
-    const stored = await this.loadStored();
+    const stored = await this.options.tokenStore.load(this.options.endpoint);
     if (this.options.readOnly || !stored?.refreshToken) {
       return void 0;
     }
@@ -310,29 +296,8 @@ var OAuthClient = class {
       await loopback.close();
     }
   }
-  /**
-   * ★대체로 읽는 옛 칸도 함께 지운다. 새 칸만 지우면 다음 읽기가 곧바로 옛 칸으로 대체돼
-   * «로그아웃했는데 여전히 로그인됨»이 된다. 로그인은 기계당 한 번이므로 옛 CLI 의 칸도 같이 끝난다.
-   */
   async logout() {
     await this.options.tokenStore.delete(this.options.endpoint);
-    for (const fallback of fallbackTokenEndpointsFor(this.options.endpoint)) {
-      await this.options.tokenStore.delete(fallback);
-    }
-  }
-  /** 이 주소의 칸, 비었으면 옛 기본 주소의 칸({@link fallbackTokenEndpointsFor}). 쓰기는 늘 이 주소의 칸이다. */
-  async loadStored() {
-    const own = await this.options.tokenStore.load(this.options.endpoint);
-    if (own) {
-      return own;
-    }
-    for (const fallback of fallbackTokenEndpointsFor(this.options.endpoint)) {
-      const stored = await this.options.tokenStore.load(fallback);
-      if (stored) {
-        return stored;
-      }
-    }
-    return void 0;
   }
   /** 부르는 쪽이 refresh token 이 있음을 이미 확인했다 — 타입이 그것을 요구한다. */
   async refreshStoredToken(stored) {
@@ -650,9 +615,8 @@ async function readAllStdin(stdin) {
 }
 
 // src/core/version.ts
-var CLI_VERSION = true ? "0.5.0" : "dev";
+var CLI_VERSION = true ? "0.7.0" : "dev";
 var PACKAGE_NAME = "@ainecto/mcp";
-var LEGACY_PACKAGE_NAME = "@ai-erd/mcp";
 var CLI_USER_AGENT = `${PACKAGE_NAME} ${CLI_VERSION}`;
 
 // src/core/mcp/rpcClient.ts
@@ -852,16 +816,18 @@ function redactSecretString(value) {
 
 // src/core/catalog/generated.prod.ts
 var generatedTools = [
-  { "mcpName": "create_documents", "commandPath": ["documents", "create"], "group": "document", "description": "Create documents. If a document body is tens of KB or more, prefer request_upload_token (purpose=document.create) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Documents", "items": { "properties": { "body": { "description": "Deprecated compatibility alias for typePayload.body when document type is markdown. \uBCF8\uBB38\uC774 \uC218\uC2ED KB \uC774\uC0C1\uC73C\uB85C \uD06C\uBA74 LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.create)` \uB97C \uD638\uCD9C\uD574 uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C \uC9C1\uC811 PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "folderUuid": { "description": "Optional folder UUID", "type": "string" }, "projectUuid": { "description": "Project UUID", "type": "string" }, "title": { "description": "Document title", "type": "string" }, "type": { "description": "Document type. Creatable values: erd, markdown, diagram, openapi, html.", "enum": ["erd", "markdown", "diagram", "openapi", "html"], "type": "string" }, "typePayload": { "description": "Type-specific payload for enabled document types. markdown: {body}; diagram: {diagramSource,sourceLanguage,edgeStyle,isModule,metadata}; openapi: {content}; html: {content} (a full HTML page).", "type": "object" } }, "required": ["projectUuid", "type", "title"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "105d051791cf595b" },
+  { "mcpName": "create_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" },
   { "mcpName": "create_workspaces", "commandPath": ["workspaces", "create"], "group": "workspace", "description": "", "inputSchema": { "properties": { "items": { "description": "Workspaces", "items": { "properties": { "description": { "description": "Description", "type": "string" }, "name": { "description": "Workspace name", "type": "string" } }, "required": ["name"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "d9d1b0d561828b8e" },
   { "mcpName": "delete_attachments", "commandPath": ["attachments", "delete"], "group": "attachment", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Attachment UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "b22c24bffdfe3d7d" },
+  { "mcpName": "delete_comments", "commandPath": ["comments", "delete"], "group": "generic", "description": "Delete your own comments on a document. Only the author can delete. A resolved question and a top-level comment that still has replies cannot be deleted. Each id is applied on its own; results report each id.", "inputSchema": { "additionalProperties": false, "properties": { "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" }, "ids": { "description": "Comment ids to delete (from mcp__ainecto__list_comments)", "items": { "minimum": 1, "type": "integer" }, "minItems": 1, "type": "array" } }, "required": ["documentUuid", "ids"], "type": "object" }, "required": ["documentUuid", "ids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "17b9658b5a47f866" },
   { "mcpName": "delete_documents", "commandPath": ["documents", "delete"], "group": "document", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Document UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "3a725ae70956c270" },
   { "mcpName": "delete_folders", "commandPath": ["folders", "delete"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Folder UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "2254cde89c9e8f06" },
   { "mcpName": "delete_projects", "commandPath": ["projects", "delete"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Project UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "6521c33a28cb5465" },
   { "mcpName": "delete_workspaces", "commandPath": ["workspaces", "delete"], "group": "workspace", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Workspace UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "3177868221137066" },
-  { "mcpName": "diagram_apply_changes", "commandPath": ["tools", "run", "diagram-apply-changes"], "group": "generic", "description": "Required single-call mutation path for diagram node/edge/group create/update/delete changes. Put nodes, edges, and groups in one request and call this once. Do not look for type-specific diagram CUD tools; this tool is the only diagram CUD entry point.", "inputSchema": { "properties": { "description": { "description": "Reason for batch (audit)", "type": "string" }, "diagramUuid": { "description": "Diagram UUID", "type": "string" }, "edges": { "description": "Edge operations", "items": { "properties": { "action": { "description": "Operation kind", "enum": ["create", "update", "delete"], "type": "string" }, "bridgeType": { "description": "Bridge type", "type": "string" }, "fromUuid": { "description": "Source", "type": "string" }, "label": { "description": "Edge label", "type": "string" }, "lineStyle": { "description": "Line style", "type": "string" }, "strokeColor": { "description": "Stroke color", "type": "string" }, "strokeWidth": { "description": "Stroke width", "type": "integer" }, "toUuid": { "description": "Target", "type": "string" }, "uuid": { "description": "Required for update/delete", "type": "string" } }, "required": ["action"], "type": "object" }, "type": "array" }, "groups": { "description": "Group operations", "items": { "properties": { "action": { "description": "Operation kind", "enum": ["create", "update", "delete"], "type": "string" }, "collapsed": { "description": "Collapsed state", "type": "boolean" }, "color": { "description": "Group color", "type": "string" }, "height": { "description": "Explicit height; omit to keep it derived from member nodes", "type": "number" }, "linkMode": { "description": "Link mode", "type": "string" }, "linkedDiagramUuid": { "description": "Linked diagram UUID", "type": "string" }, "name": { "description": "Group name", "type": "string" }, "parentGroupUuid": { "description": "Parent group UUID", "type": "string" }, "sortOrder": { "description": "Sort order", "type": "integer" }, "uuid": { "description": "Required for update/delete", "type": "string" }, "width": { "description": "Explicit width; omit to keep it derived from member nodes", "type": "number" } }, "required": ["action"], "type": "object" }, "type": "array" }, "nodes": { "description": "Node operations", "items": { "properties": { "action": { "description": "Operation kind", "enum": ["create", "update", "delete"], "type": "string" }, "fillColor": { "description": "Fill color", "type": "string" }, "groupUuid": { "description": "Group UUID; empty string clears membership", "type": "string" }, "height": { "description": "Height", "type": "number" }, "shape": { "description": "Node shape (start/end/diamond/cylinder/parallelogram/stadium/hexagon/rect/roundRect/...)", "enum": ["rect", "roundRect", "stadium", "diamond", "decision", "circle", "start", "doubleCircle", "end", "hexagon", "cylinder", "parallelogram"], "type": "string" }, "strokeColor": { "description": "Stroke color", "type": "string" }, "text": { "description": "Node text/label. Supports newlines (\\n) for multi-line display.", "maxLength": 4e3, "type": "string" }, "textColor": { "description": "Text color", "type": "string" }, "type": { "description": "Node type", "type": "string" }, "uuid": { "description": "Required for update/delete; optional for create", "type": "string" }, "width": { "description": "Width", "type": "number" }, "x": { "description": "X", "type": "number" }, "y": { "description": "Y", "type": "number" } }, "required": ["action"], "type": "object" }, "type": "array" } }, "required": ["diagramUuid", "description"], "type": "object" }, "required": ["description", "diagramUuid"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "add78d8edce88c86" },
+  { "mcpName": "diagram_apply_changes", "commandPath": ["tools", "run", "diagram-apply-changes"], "group": "generic", "description": "Required single-call mutation path for diagram node/edge/group create/update/delete changes. Put nodes, edges, and groups in one request and call this once. Do not look for type-specific diagram CUD tools; this tool is the only diagram CUD entry point.", "inputSchema": { "properties": { "description": { "description": "Reason for batch (audit)", "type": "string" }, "diagramUuid": { "description": "Diagram UUID", "type": "string" }, "edges": { "description": "Edge operations", "items": { "properties": { "action": { "description": "Operation kind", "enum": ["create", "update", "delete"], "type": "string" }, "bridgeType": { "description": "Omit (null) for a plain node-to-node edge. Set only when a group is an endpoint: GROUP_TO_GROUP|NODE_TO_GROUP|GROUP_TO_NODE", "enum": ["GROUP_TO_GROUP", "NODE_TO_GROUP", "GROUP_TO_NODE"], "type": "string" }, "fromUuid": { "description": "Source", "type": "string" }, "label": { "description": "Edge label", "type": "string" }, "lineStyle": { "description": "Line style", "type": "string" }, "strokeColor": { "description": "Stroke color", "type": "string" }, "strokeWidth": { "description": "Stroke width", "type": "integer" }, "toUuid": { "description": "Target", "type": "string" }, "uuid": { "description": "Required for update/delete", "type": "string" } }, "required": ["action"], "type": "object" }, "type": "array" }, "groups": { "description": "Group operations", "items": { "properties": { "action": { "description": "Operation kind", "enum": ["create", "update", "delete"], "type": "string" }, "collapsed": { "description": "Collapsed state", "type": "boolean" }, "color": { "description": "Group color", "type": "string" }, "height": { "description": "Explicit height; omit to keep it derived from member nodes", "type": "number" }, "linkMode": { "description": "Link mode", "type": "string" }, "linkedDiagramUuid": { "description": "Linked diagram UUID", "type": "string" }, "name": { "description": "Group name", "type": "string" }, "parentGroupUuid": { "description": "Parent group UUID", "type": "string" }, "sortOrder": { "description": "Sort order", "type": "integer" }, "uuid": { "description": "Required for update/delete", "type": "string" }, "width": { "description": "Explicit width; omit to keep it derived from member nodes", "type": "number" } }, "required": ["action"], "type": "object" }, "type": "array" }, "nodes": { "description": "Node operations", "items": { "properties": { "action": { "description": "Operation kind", "enum": ["create", "update", "delete"], "type": "string" }, "fillColor": { "description": "Fill color", "type": "string" }, "groupUuid": { "description": "Group UUID; empty string clears membership", "type": "string" }, "height": { "description": "Height", "type": "number" }, "shape": { "description": "Node shape (start/end/diamond/cylinder/parallelogram/stadium/hexagon/rect/roundRect/...)", "enum": ["rect", "roundRect", "stadium", "diamond", "decision", "circle", "start", "doubleCircle", "end", "hexagon", "cylinder", "parallelogram"], "type": "string" }, "strokeColor": { "description": "Stroke color", "type": "string" }, "text": { "description": "Node text/label. Supports newlines (\\n) for multi-line display.", "maxLength": 4e3, "type": "string" }, "textColor": { "description": "Text color", "type": "string" }, "type": { "description": "Node type", "type": "string" }, "uuid": { "description": "Required for update/delete; optional for create", "type": "string" }, "width": { "description": "Width", "type": "number" }, "x": { "description": "X", "type": "number" }, "y": { "description": "Y", "type": "number" } }, "required": ["action"], "type": "object" }, "type": "array" } }, "required": ["diagramUuid", "description"], "type": "object" }, "required": ["description", "diagramUuid"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "2c829103f86f4168" },
   { "mcpName": "diagram_get_edge", "commandPath": ["tools", "run", "diagram-get-edge"], "group": "generic", "description": "", "inputSchema": { "properties": { "edgeUuid": { "description": "Edge UUID", "type": "string" } }, "required": ["edgeUuid"], "type": "object" }, "required": ["edgeUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "2c03c4f7daa69898" },
   { "mcpName": "diagram_get_group", "commandPath": ["tools", "run", "diagram-get-group"], "group": "generic", "description": "", "inputSchema": { "properties": { "groupUuid": { "description": "Group UUID", "type": "string" } }, "required": ["groupUuid"], "type": "object" }, "required": ["groupUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "55c5aa27b8cf489d" },
   { "mcpName": "diagram_get_node", "commandPath": ["tools", "run", "diagram-get-node"], "group": "generic", "description": "", "inputSchema": { "properties": { "nodeUuid": { "description": "Node UUID", "type": "string" } }, "required": ["nodeUuid"], "type": "object" }, "required": ["nodeUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "646d553238328a9e" },
@@ -884,14 +850,20 @@ var generatedTools = [
   { "mcpName": "erd_list_table_groups", "commandPath": ["erd", "list-table-groups"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "775bff53bbc21c9e" },
   { "mcpName": "erd_list_tables", "commandPath": ["erd", "list-tables"], "group": "erd", "description": "", "inputSchema": { "properties": { "documentUuid": { "description": "ERD document UUID", "type": "string" } }, "required": ["documentUuid"], "type": "object" }, "required": ["documentUuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "34324dfc7ef461c8" },
   { "mcpName": "get_attachment", "commandPath": ["attachment", "get"], "group": "attachment", "description": "", "inputSchema": { "properties": { "uuid": { "description": "Attachment UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "1e0e7f1bf33b669c" },
-  { "mcpName": "get_document", "commandPath": ["document", "get"], "group": "document", "description": "Read a document. The body comes back for the types whose create/update take one: markdown \u2192 content; openapi \u2192 content (the spec text) + format/specVersion/pathCount/operationCount; html \u2192 content (the HTML text); diagram \u2192 diagramSource/sourceLanguage/edgeStyle/isModule/metadata; erd \u2192 metadata only (read tables/refs via erd_list_*).", "inputSchema": { "properties": { "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "required": ["uuid"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "5de278aad6b11bc5" },
+  { "mcpName": "get_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_documents", "commandPath": ["documents", "list"], "group": "document", "description": "", "inputSchema": { "properties": { "folderUuid": { "description": "Optional folder UUID", "type": "string" }, "limit": { "description": "Result cap when q is set (default 50)", "type": "integer" }, "projectUuid": { "description": "Project UUID", "type": "string" }, "q": { "description": "Optional full-text query. When provided, results come from the search index instead of folder listing.", "type": "string" }, "type": { "description": "Optional document type filter. Readable values: erd, markdown, diagram, openapi, html.", "enum": ["erd", "markdown", "diagram", "openapi", "html"], "type": "string" } }, "type": "object" }, "required": [], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4086c52be4dd0c15" },
+  { "mcpName": "list_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" },
@@ -901,14 +873,17 @@ var generatedTools = [
   { "mcpName": "move_documents", "commandPath": ["documents", "move"], "group": "document", "description": "", "inputSchema": { "properties": { "clientMutationId": { "description": "Optional mutation identifier for client retry tracing", "maxLength": 128, "minLength": 1, "pattern": "^[\\x21-\\x7E]{1,128}$", "type": "string" }, "items": { "description": "Moves", "items": { "properties": { "newFolderUuid": { "description": "New folder UUID \u2014 null/empty for root", "type": "string" }, "targetProjectUuid": { "description": "Target project UUID \u2014 omit to stay in current project", "type": "string" }, "targetWorkspaceUuid": { "description": "Guard only: must match targetProjectUuid workspace", "type": "string" }, "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "45899053743a0c1e" },
   { "mcpName": "move_folders", "commandPath": ["folders", "move"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Moves", "items": { "properties": { "newParentFolderUuid": { "description": "New parent UUID \u2014 null/empty for root", "type": "string" }, "uuid": { "description": "Folder UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "eff4458d2f35587a" },
   { "mcpName": "move_projects", "commandPath": ["projects", "move"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Moves", "items": { "properties": { "targetWorkspaceUuid": { "description": "Destination workspace UUID (you need write access there)", "type": "string" }, "uuid": { "description": "Project UUID", "type": "string" } }, "required": ["uuid", "targetWorkspaceUuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "abe0196da3c48ad5" },
-  { "mcpName": "request_upload_token", "commandPath": ["tools", "run", "request-upload-token"], "group": "attachment", "description": "Use this for large payloads of tens of KB or more to save LLM tokens. purpose=mcp.call returns a short-lived bearer token that can call any MCP tool, including erd_apply_changes, via curl. purpose=document.create/update/append uploads document bodies directly to the upload endpoint with PUT/curl. Tokens are reusable for 5 minutes by default.", "inputSchema": { "properties": { "maxBytes": { "description": "\uCD5C\uB300 \uC5C5\uB85C\uB4DC byte (\uC11C\uBC84 \uCE21 \uD55C\uB3C4)", "type": "integer" }, "purpose": { "description": "Token \uC6A9\uB3C4. `mcp.call` \uC740 curl \uB85C /mcp \uD638\uCD9C, `document.create/update/append` \uB294 PUT body \uB85C \uBCF8\uBB38 \uC5C5\uB85C\uB4DC, `attachment.upload` \uB294 \uD30C\uC77C bytes \uC5C5\uB85C\uB4DC. \uCF58\uD150\uCE20\uAC00 \uD06C\uBA74 (\uC218\uC2ED KB \uC774\uC0C1) LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 \uC774 \uB3C4\uAD6C\uB85C 5\uBD84 \uC7AC\uC0AC\uC6A9 \uD1A0\uD070\uC744 \uBC1B\uACE0 curl \uB85C \uBCF4\uB0B4\uB294 \uAC83\uC744 \uAC15\uB825 \uAD8C\uC7A5.", "enum": ["mcp.call", "document.create", "document.update", "document.append", "attachment.upload"], "type": "string" }, "scopeJson": { "description": "\uC120\uD0DD \u2014 JSON scope. document.create \uB294 projectUuid, type, title \uC744 \uD3EC\uD568\uD558\uACE0 creatable type values \uB294 erd, markdown, diagram, openapi, html. document.update/document.append \uB294 documentUuid \uB97C \uD3EC\uD568. attachment.upload typed: {parentType:TEST_CASE|TEST_EXECUTION,parentUuid,filename,contentType,sizeBytes}.", "type": "string" }, "ttlSeconds": { "description": "TTL (\uCD08). \uAE30\uBCF8 300 (5\uBD84)", "type": "integer" } }, "required": ["purpose"], "type": "object" }, "required": ["purpose"], "payloadMode": "binary-upload", "destructive": false, "sourceCatalog": "prod", "schemaHash": "85867a646f6c652f" },
+  { "mcpName": "request_upload_token", "commandPath": ["tools", "run", "request-upload-token"], "group": "attachment", "description": "Use this for large payloads of tens of KB or more to save LLM tokens. purpose=mcp.call returns a short-lived bearer token that can call any MCP tool, including erd_apply_changes, via curl. purpose=document.create/update/append uploads document bodies directly to the upload endpoint with PUT/curl. Tokens are reusable for 5 minutes by default.", "inputSchema": { "properties": { "maxBytes": { "description": "\uCD5C\uB300 \uC5C5\uB85C\uB4DC byte (\uC11C\uBC84 \uCE21 \uD55C\uB3C4)", "type": "integer" }, "purpose": { "description": "Token \uC6A9\uB3C4. `mcp.call` \uC740 curl \uB85C /mcp \uD638\uCD9C, `document.create/update/append` \uB294 PUT body \uB85C \uBCF8\uBB38 \uC5C5\uB85C\uB4DC, `attachment.upload` \uB294 \uD30C\uC77C bytes \uC5C5\uB85C\uB4DC. \uCF58\uD150\uCE20\uAC00 \uD06C\uBA74 (\uC218\uC2ED KB \uC774\uC0C1) LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 \uC774 \uB3C4\uAD6C\uB85C 5\uBD84 \uC7AC\uC0AC\uC6A9 \uD1A0\uD070\uC744 \uBC1B\uACE0 curl \uB85C \uBCF4\uB0B4\uB294 \uAC83\uC744 \uAC15\uB825 \uAD8C\uC7A5.", "enum": ["mcp.call", "document.create", "document.update", "document.append", "attachment.upload"], "type": "string" }, "scopeJson": { "description": "\uC120\uD0DD \u2014 JSON scope. document.create \uB294 projectUuid, type, title \uC744 \uD3EC\uD568\uD558\uACE0 creatable type values \uB294 erd, markdown, diagram, openapi, html, file. document.update/document.append \uB294 documentUuid \uB97C \uD3EC\uD568. type=file \uC740 filename \uB3C4 \uD3EC\uD568(\uD655\uC7A5\uC790\uB85C \uD615\uC2DD \uD310\uC815) \u2014 PUT \uC758 Content-Type \uC740 \uD30C\uC77C MIME, \uBCF8\uBB38\uC740 \uD30C\uC77C \uBC14\uC774\uD2B8. attachment.upload: {documentUuid, filename}; storageKey \uB294 \uC11C\uBC84\uAC00 \uBC1C\uAE09 scope \uC5D0 \uB123\uB294\uB2E4.", "type": "string" }, "ttlSeconds": { "description": "TTL (\uCD08). \uAE30\uBCF8 300 (5\uBD84)", "type": "integer" } }, "required": ["purpose"], "type": "object" }, "required": ["purpose"], "payloadMode": "binary-upload", "destructive": false, "sourceCatalog": "prod", "schemaHash": "fe1984b3979abf86" },
+  { "mcpName": "resolve_comments", "commandPath": ["tools", "run", "resolve-comments"], "group": "generic", "description": "Mark questions on a document as resolved. Only top-level comments with kind QUESTION can be resolved, and it needs edit access to the document (readers can comment but cannot resolve). Resolving cannot be undone. Each id is applied on its own; results report each id.", "inputSchema": { "additionalProperties": false, "properties": { "documentUuid": { "description": "Document UUID the comments belong to", "type": "string" }, "ids": { "description": "Question ids to resolve (top-level comments with kind QUESTION)", "items": { "minimum": 1, "type": "integer" }, "minItems": 1, "type": "array" } }, "required": ["documentUuid", "ids"], "type": "object" }, "required": ["documentUuid", "ids"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "7b32b72b3a0d64ba" },
   { "mcpName": "restore_versions", "commandPath": ["versions", "restore"], "group": "generic", "description": "", "inputSchema": { "properties": { "items": { "description": "Restores", "items": { "properties": { "documentUuid": { "description": "Document UUID", "type": "string" }, "versionNumber": { "description": "Version number to restore", "type": "integer" } }, "required": ["documentUuid", "versionNumber"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "005b5b08a19fc605" },
-  { "mcpName": "search_documents", "commandPath": ["documents", "search"], "group": "document", "description": "", "inputSchema": { "properties": { "limit": { "description": "\uACB0\uACFC \uAC1C\uC218 (\uAE30\uBCF8 20, \uCD5C\uB300 50)", "type": "integer" }, "offset": { "description": "\uD398\uC774\uC9C0\uB124\uC774\uC158 offset (\uAE30\uBCF8 0)", "type": "integer" }, "projectUuid": { "description": "\uD2B9\uC815 \uD504\uB85C\uC81D\uD2B8\uB85C \uD55C\uC815 (\uC120\uD0DD)", "type": "string" }, "q": { "description": "\uAC80\uC0C9 \uD0A4\uC6CC\uB4DC", "type": "string" }, "type": { "description": "Optional document type filter. Readable values: erd, markdown, diagram, openapi, html.", "enum": ["erd", "markdown", "diagram", "openapi", "html"], "type": "string" } }, "required": ["q"], "type": "object" }, "required": ["q"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "d24e109383700433" },
+  { "mcpName": "search_documents", "commandPath": ["documents", "search"], "group": "document", "description": "", "inputSchema": { "properties": { "limit": { "description": "\uACB0\uACFC \uAC1C\uC218 (\uAE30\uBCF8 20, \uCD5C\uB300 50)", "type": "integer" }, "offset": { "description": "\uD398\uC774\uC9C0\uB124\uC774\uC158 offset (\uAE30\uBCF8 0)", "type": "integer" }, "projectUuid": { "description": "\uD2B9\uC815 \uD504\uB85C\uC81D\uD2B8\uB85C \uD55C\uC815 (\uC120\uD0DD)", "type": "string" }, "q": { "description": "\uAC80\uC0C9 \uD0A4\uC6CC\uB4DC", "type": "string" }, "type": { "description": "Optional document type filter. Readable values: erd, markdown, diagram, openapi, html, file.", "enum": ["erd", "markdown", "diagram", "openapi", "html", "file"], "type": "string" } }, "required": ["q"], "type": "object" }, "required": ["q"], "payloadMode": "flags", "destructive": false, "sourceCatalog": "prod", "schemaHash": "e82abba1358754e8" },
   { "mcpName": "unarchive_documents", "commandPath": ["documents", "unarchive"], "group": "document", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Document UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "f2810e71583a320f" },
   { "mcpName": "unarchive_folders", "commandPath": ["folders", "unarchive"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Folder UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "2a24cc44696b7906" },
   { "mcpName": "unarchive_projects", "commandPath": ["projects", "unarchive"], "group": "generic", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Project UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "6925e444671afe19" },
   { "mcpName": "unarchive_workspaces", "commandPath": ["workspaces", "unarchive"], "group": "workspace", "description": "", "inputSchema": { "properties": { "uuids": { "description": "Workspace UUIDs", "items": { "type": "string" }, "type": "array" } }, "required": ["uuids"], "type": "object" }, "required": ["uuids"], "payloadMode": "file-json", "destructive": true, "sourceCatalog": "prod", "schemaHash": "8dafe9bc6378c3f2" },
-  { "mcpName": "update_documents", "commandPath": ["documents", "update"], "group": "document", "description": "Update documents. If a replacement body is tens of KB or more, prefer request_upload_token (purpose=document.update) and upload the body with curl.", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "body": { "description": "Deprecated compatibility alias for typePayload.body when document type is markdown. \uBCF8\uBB38\uC774 \uC218\uC2ED KB \uC774\uC0C1\uC73C\uB85C \uD06C\uBA74 LLM \uD1A0\uD070 \uC808\uC57D\uC744 \uC704\uD574 `request_upload_token (purpose=document.update)` \uB97C \uD638\uCD9C\uD574 uploadUrl \uC744 \uBC1B\uACE0 curl \uB85C \uC9C1\uC811 PUT \uC73C\uB85C \uBCF4\uB0BC \uAC83.", "type": "string" }, "title": { "description": "New title", "type": "string" }, "typePayload": { "description": "Type-specific payload for enabled document types. markdown: {body}; diagram: {diagramSource,sourceLanguage,edgeStyle,isModule,metadata}; openapi: {content}; html: {content} (a full HTML page).", "type": "object" }, "uuid": { "description": "Document UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "4c3cfe4d25def672" },
+  { "mcpName": "update_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" },
   { "mcpName": "update_workspaces", "commandPath": ["workspaces", "update"], "group": "workspace", "description": "", "inputSchema": { "properties": { "items": { "description": "Updates", "items": { "properties": { "description": { "description": "New description", "type": "string" }, "name": { "description": "New name", "type": "string" }, "uuid": { "description": "Workspace UUID", "type": "string" } }, "required": ["uuid"], "type": "object" }, "type": "array" } }, "required": ["items"], "type": "object" }, "required": ["items"], "payloadMode": "file-json", "destructive": false, "sourceCatalog": "prod", "schemaHash": "553275e6da799c5a" },
@@ -1557,6 +1532,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) {
@@ -1642,6 +1620,34 @@ 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);
+}
+
+// src/core/upload/attachmentUpload.ts
 var AttachmentUploadError = class extends Error {
   constructor(code, message, details) {
     super(message);
@@ -1739,7 +1745,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;
@@ -1809,7 +1815,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") {
@@ -1841,20 +1847,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,
@@ -1887,7 +1879,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);
 }
 
@@ -2011,14 +2003,260 @@ 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";
 var SERVER_NAME = "ainecto";
-var LEGACY_SERVER_NAME = "ai-erd";
 var AGENT_TARGETS = [
   { id: "claude-code", label: "Claude Code", path: ".mcp.json" },
   { id: "cursor", label: "Cursor", path: ".cursor/mcp.json" }
@@ -2034,7 +2272,7 @@ function buildServerEntry(input) {
   return { command: "npx", args };
 }
 function readRoleFromEntry(entry) {
-  if (!isRecord8(entry) || !Array.isArray(entry.args)) {
+  if (!isRecord10(entry) || !Array.isArray(entry.args)) {
     return void 0;
   }
   const index = entry.args.indexOf("--role");
@@ -2048,43 +2286,30 @@ function readServerEntry(existing) {
   try {
     const parsed = JSON.parse(existing);
     const servers = parsed?.mcpServers;
-    return isRecord8(servers) ? servers[ourKeyIn(servers) ?? SERVER_NAME] : void 0;
+    return isRecord10(servers) ? servers[SERVER_NAME] : void 0;
   } catch {
     return void 0;
   }
 }
-function ourKeyIn(servers) {
-  if (Object.prototype.hasOwnProperty.call(servers, SERVER_NAME)) {
-    return SERVER_NAME;
-  }
-  return isOurBridge(servers[LEGACY_SERVER_NAME]) ? LEGACY_SERVER_NAME : void 0;
-}
-function legacyBridgeIn(servers) {
-  return isOurBridge(servers[LEGACY_SERVER_NAME]);
-}
 function isOurBridge(entry) {
-  if (!isRecord8(entry)) {
+  if (!isRecord10(entry)) {
     return false;
   }
   const { command, args } = entry;
   const argList = Array.isArray(args) ? args.filter((arg) => typeof arg === "string") : [];
-  const isOurPackage = (arg) => [PACKAGE_NAME, LEGACY_PACKAGE_NAME].some((name) => arg === name || arg.startsWith(`${name}@`));
+  const isOurPackage = (arg) => arg === PACKAGE_NAME || arg.startsWith(`${PACKAGE_NAME}@`);
   if (argList.some((arg) => isOurPackage(arg) || arg === "--role")) {
     return true;
   }
   const bin = typeof command === "string" ? basename2(command) : "";
   return OUR_BINS.includes(bin);
 }
-var OUR_BINS = ["ainecto", "ai-erd", "ai-erd-mcp"];
+var OUR_BINS = ["ainecto"];
 function mergeServerEntry(existing, entry) {
   const root = parseConfigObject(existing);
   const servers = readServers(root);
-  const ourKey = ourKeyIn(servers);
-  const replaced = ourKey !== void 0;
-  const replacedEntry = ourKey === void 0 ? void 0 : servers[ourKey];
-  if (legacyBridgeIn(servers)) {
-    delete servers[LEGACY_SERVER_NAME];
-  }
+  const replaced = Object.prototype.hasOwnProperty.call(servers, SERVER_NAME);
+  const replacedEntry = replaced ? servers[SERVER_NAME] : void 0;
   servers[SERVER_NAME] = entry;
   return { content: stringify({ ...root, mcpServers: servers }), replaced, replacedEntry };
 }
@@ -2094,14 +2319,13 @@ function removeServerEntry(existing, restore) {
   }
   const root = parseConfigObject(existing);
   const servers = readServers(root);
-  const ourKey = ourKeyIn(servers);
-  const removed = ourKey !== void 0;
+  const removed = Object.prototype.hasOwnProperty.call(servers, SERVER_NAME);
   if (restore !== void 0) {
-    servers[ourKey ?? SERVER_NAME] = restore.value;
+    servers[SERVER_NAME] = restore.value;
     return { content: stringify({ ...root, mcpServers: servers }), removed, emptied: false };
   }
-  if (ourKey !== void 0) {
-    delete servers[ourKey];
+  if (removed) {
+    delete servers[SERVER_NAME];
   }
   const otherKeys = Object.keys(root).filter((key) => key !== "mcpServers");
   const emptied = Object.keys(servers).length === 0 && otherKeys.length === 0;
@@ -2132,7 +2356,7 @@ function readServers(root) {
   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.'
     );
@@ -2151,7 +2375,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;
@@ -2160,21 +2384,15 @@ function stringify(value) {
   return `${JSON.stringify(value, null, 2)}
 `;
 }
-function isRecord8(value) {
+function isRecord10(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
 // src/core/harness/harnessDoc.ts
 var MARKER_BEGIN = "<!-- ainecto:begin -->";
 var MARKER_END = "<!-- ainecto:end -->";
-var LEGACY_MARKER_BEGIN = "<!-- ai-erd:begin -->";
-var LEGACY_MARKER_END = "<!-- ai-erd:end -->";
-var MARKERS = {
-  begin: [MARKER_BEGIN, LEGACY_MARKER_BEGIN],
-  end: [MARKER_END, LEGACY_MARKER_END]
-};
+var MARKERS = { begin: MARKER_BEGIN, end: MARKER_END };
 var HARNESS_DIR = ".ainecto";
-var LEGACY_HARNESS_DIR = ".ai-erd";
 var HARNESS_DOC_PATH = `${HARNESS_DIR}/HARNESS.md`;
 var HARNESS_CONFIG_PATH = `${HARNESS_DIR}/config.json`;
 var HARNESS_RECORD_PATH = `${HARNESS_DIR}/init-record.json`;
@@ -2201,7 +2419,7 @@ function documentContractProblem(key, body) {
     }
   }
   if (key === AGENT_NOTE_KEY) {
-    return managedBlockProblem(key, withCurrentMarkers(body));
+    return managedBlockProblem(key, body);
   }
   return void 0;
 }
@@ -2264,14 +2482,11 @@ Or run \`ainecto init --role <design|development|test|validation>\` to rewrite t
 Generated by \`ainecto init\`. Remove everything it wrote with \`ainecto init --undo\`.
 `;
 function renderAgentNote(template) {
-  return fillTemplate(withCurrentMarkers(template ?? DEFAULT_AGENT_NOTE), {
+  return fillTemplate(template ?? DEFAULT_AGENT_NOTE, {
     harnessDocPath: HARNESS_DOC_PATH,
     serverName: SERVER_NAME
   });
 }
-function withCurrentMarkers(template) {
-  return template.split(LEGACY_MARKER_BEGIN).join(MARKER_BEGIN).split(LEGACY_MARKER_END).join(MARKER_END);
-}
 var DEFAULT_AGENT_NOTE = `${MARKER_BEGIN}
 ## AiNecto Harness
 
@@ -2308,14 +2523,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();
@@ -2360,50 +2575,39 @@ function assertNoDanglingMarker(content) {
 }
 function ownedMarkerCount(content, kind) {
   let count = 0;
-  for (let hit = ownedMarker(content, kind, 0); hit !== void 0; hit = ownedMarker(content, kind, hit.at + 1)) {
+  for (let hit2 = ownedMarker(content, kind, 0); hit2 !== void 0; hit2 = ownedMarker(content, kind, hit2.at + 1)) {
     count += 1;
   }
   return count;
 }
 function ownedMarker(content, kind, from) {
-  let best;
-  for (const marker of MARKERS[kind]) {
-    const at = ownedMarkerIndex(content, marker, from);
-    if (at >= 0 && (best === void 0 || at < best.at)) {
-      best = { at, length: marker.length };
-    }
-  }
-  return best;
+  return hit(ownedMarkerIndex(content, MARKERS[kind], from), MARKERS[kind]);
 }
 function anyMarker(content, kind, from) {
-  let best;
-  for (const marker of MARKERS[kind]) {
-    const at = content.indexOf(marker, from);
-    if (at >= 0 && (best === void 0 || at < best.at)) {
-      best = { at, length: marker.length };
-    }
-  }
-  return best;
+  return hit(content.indexOf(MARKERS[kind], from), MARKERS[kind]);
+}
+function hit(at, marker) {
+  return at >= 0 ? { at, length: marker.length } : void 0;
 }
 function isInsideFencedBlock(content, index) {
-  let open;
+  let 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);
@@ -2514,14 +2718,12 @@ function ownedMarkerIndex(content, marker, from) {
 
 // src/core/harness/initRecord.ts
 var RECORD_KIND = "ainecto/init-record";
-var LEGACY_RECORD_KIND = "ai-erd/init-record";
 var RECORD_VERSION = 2;
 var ABSENT = { at: "absent" };
 function emptyRecord() {
   return { version: RECORD_VERSION, files: {}, createdDirectories: [] };
 }
-function readRecord(content, recordPath = HARNESS_RECORD_PATH) {
-  const HARNESS_RECORD_PATH2 = recordPath;
+function readRecord(content) {
   if (content === void 0) {
     return { state: "absent" };
   }
@@ -2529,26 +2731,26 @@ function readRecord(content, recordPath = HARNESS_RECORD_PATH) {
   try {
     parsed = JSON.parse(content);
   } catch {
-    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH2} is not valid JSON` };
+    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH} is not valid JSON` };
   }
   if (!isObject(parsed)) {
-    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH2} is not a JSON object` };
+    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH} is not a JSON object` };
   }
-  if (parsed.kind !== RECORD_KIND && parsed.kind !== LEGACY_RECORD_KIND) {
+  if (parsed.kind !== RECORD_KIND) {
     return {
       state: "corrupt",
-      reason: `${HARNESS_RECORD_PATH2} exists but is not an AiNecto init record (kind=${JSON.stringify(parsed.kind)})`
+      reason: `${HARNESS_RECORD_PATH} exists but is not an AiNecto init record (kind=${JSON.stringify(parsed.kind)})`
     };
   }
   if (parsed.version !== RECORD_VERSION) {
     return {
       state: "legacy",
-      reason: `${HARNESS_RECORD_PATH2} was written by another version of this CLI (record version ${JSON.stringify(parsed.version)}, this CLI reads ${RECORD_VERSION})`
+      reason: `${HARNESS_RECORD_PATH} was written by another version of this CLI (record version ${JSON.stringify(parsed.version)}, this CLI reads ${RECORD_VERSION})`
     };
   }
   const files = parsed.files;
   if (!isObject(files)) {
-    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH2} has no "files" object` };
+    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH} has no "files" object` };
   }
   const out = {};
   for (const [path, raw] of Object.entries(files)) {
@@ -2556,14 +2758,14 @@ function readRecord(content, recordPath = HARNESS_RECORD_PATH) {
     if ("problem" in read) {
       return {
         state: "corrupt",
-        reason: `${HARNESS_RECORD_PATH2} has an unusable entry for ${path} \u2014 it ${read.problem}`
+        reason: `${HARNESS_RECORD_PATH} has an unusable entry for ${path} \u2014 it ${read.problem}`
       };
     }
     out[path] = read.contract;
   }
   const directories = parsed.createdDirectories;
   if (directories !== void 0 && !isStringArray(directories)) {
-    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH2} has a malformed createdDirectories` };
+    return { state: "corrupt", reason: `${HARNESS_RECORD_PATH} has a malformed createdDirectories` };
   }
   return {
     state: "valid",
@@ -2574,46 +2776,6 @@ function readRecord(content, recordPath = HARNESS_RECORD_PATH) {
     }
   };
 }
-var LEGACY_MANAGED_KEYS = [
-  "created",
-  "originals",
-  "lastWritten",
-  "lastWrittenFragment",
-  "lastWrittenBody",
-  "replacedEntries",
-  "replacedBlocks",
-  "blockAdded",
-  "foreignMarkers"
-];
-function legacyManagedRecord(configContent) {
-  if (configContent === void 0) {
-    return false;
-  }
-  let parsed;
-  try {
-    parsed = JSON.parse(configContent);
-  } catch {
-    return false;
-  }
-  if (!isObject(parsed) || !isObject(parsed.managed)) {
-    return false;
-  }
-  const managed = parsed.managed;
-  const hasLegacyShape = LEGACY_MANAGED_KEYS.some(
-    (key) => Object.prototype.hasOwnProperty.call(managed, key)
-  );
-  if (!hasLegacyShape) {
-    return false;
-  }
-  if (typeof parsed.generatedBy === "string") {
-    return true;
-  }
-  const lastWritten = managed.lastWritten;
-  return isObject(lastWritten) && [HARNESS_CONFIG_PATH, `${LEGACY_HARNESS_DIR}/config.json`].some((path) => Object.prototype.hasOwnProperty.call(lastWritten, path));
-}
-function legacyManagedNotice(configPath) {
-  return `${configPath} holds an init record written by an older version of this CLI (a "managed" field). This version keeps its record in ${HARNESS_RECORD_PATH} and cannot read that one, so your saved originals are still in there and nothing was changed. Undo with the version that wrote it (for example: npx -y -p @ai-erd/mcp@0.2 ai-erd init --undo), then run this version again.`;
-}
 function serializeRecord(record) {
   return `${JSON.stringify({
     kind: RECORD_KIND,
@@ -2774,9 +2936,9 @@ function isStringArray(value) {
 import { createHash as createHash4 } from "crypto";
 
 // src/core/harness/repositoryRole.ts
-import { lstat, readFile as readFile4, realpath } from "fs/promises";
+import { lstat, readFile as readFile5, realpath } from "fs/promises";
 import { homedir as homedir2 } from "os";
-import { dirname as dirname2, join as join2, resolve, sep } from "path";
+import { dirname as dirname3, join as join2, resolve, sep } from "path";
 function readConfigRole(path, content) {
   if (content === void 0 || !content.trim()) {
     return { kind: "absent" };
@@ -2787,29 +2949,17 @@ function readConfigRole(path, content) {
     const raw = parsed?.mcpServers;
     servers = typeof raw === "object" && raw !== null && !Array.isArray(raw) ? raw : {};
   } catch {
-    return content.includes(SERVER_NAME) || content.includes(LEGACY_SERVER_NAME) ? { kind: "problem", reason: `${path} is not valid JSON` } : { kind: "absent" };
+    return content.includes(SERVER_NAME) ? { kind: "problem", reason: `${path} is not valid JSON` } : { kind: "absent" };
   }
-  const roles = [];
-  for (const key of [SERVER_NAME, LEGACY_SERVER_NAME]) {
-    const entry = servers[key];
-    if (!isOurBridge(entry)) {
-      continue;
-    }
-    const role = readRoleFromEntry(entry);
-    if (role === void 0) {
-      return { kind: "problem", reason: `${path} has the "${key}" bridge without a valid --role` };
-    }
-    if (!roles.includes(role)) {
-      roles.push(role);
-    }
+  const entry = servers[SERVER_NAME];
+  if (!isOurBridge(entry)) {
+    return { kind: "absent" };
   }
-  if (roles.length > 1) {
-    return {
-      kind: "problem",
-      reason: `${path} has both the "${SERVER_NAME}" and the "${LEGACY_SERVER_NAME}" bridge with different roles (${roles.join(", ")})`
-    };
+  const role = readRoleFromEntry(entry);
+  if (role === void 0) {
+    return { kind: "problem", reason: `${path} has the "${SERVER_NAME}" bridge without a valid --role` };
   }
-  return roles.length === 0 ? { kind: "absent" } : { kind: "role", role: roles[0] };
+  return { kind: "role", role };
 }
 function rolesInFiles(files) {
   const roles = [];
@@ -2826,7 +2976,7 @@ function rolesInFiles(files) {
 }
 async function findRepositoryRole(cwd, home = homedir2()) {
   const stopAt = await realOrResolved(home);
-  for (let dir = await realOrResolved(cwd); ; dir = dirname2(dir)) {
+  for (let dir = await realOrResolved(cwd); ; dir = dirname3(dir)) {
     if (samePath(dir, stopAt)) {
       return { kind: "none" };
     }
@@ -2856,7 +3006,7 @@ async function findRepositoryRole(cwd, home = homedir2()) {
       }
       return { kind: "role", role: result.roles[0], dir };
     }
-    if (dirname2(dir) === dir) {
+    if (dirname3(dir) === dir) {
       return { kind: "none" };
     }
   }
@@ -2893,16 +3043,16 @@ async function readConfigInside(dir, path) {
   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");
+  return readFile5(real, "utf8");
 }
 async function findGitRoot(cwd) {
-  for (let at = resolve(cwd); ; at = dirname2(at)) {
+  for (let at = resolve(cwd); ; at = dirname3(at)) {
     try {
       await lstat(join2(at, ".git"));
       return at;
     } catch {
     }
-    if (dirname2(at) === at) {
+    if (dirname3(at) === at) {
       return void 0;
     }
   }
@@ -2913,7 +3063,7 @@ async function readManagedFile(root, path) {
 }
 async function readIfExists(absolutePath) {
   try {
-    return await readFile4(absolutePath, "utf8");
+    return await readFile5(absolutePath, "utf8");
   } catch (error) {
     if (isNodeError2(error, "ENOENT")) {
       return void 0;
@@ -2926,7 +3076,7 @@ async function assertInsideRepository(root, relativePath) {
   const realRoot = await realpath(root);
   let realParent;
   try {
-    realParent = await realpath(dirname2(absolutePath));
+    realParent = await realpath(dirname3(absolutePath));
   } catch (error) {
     if (isNodeError2(error, "ENOENT")) {
       return;
@@ -3029,9 +3179,6 @@ function initRefusal(files, previous) {
   if (state.state === "corrupt" || state.state === "legacy") {
     return `${state.reason}. Nothing was changed \u2014 move that file aside (or restore it) and run again.`;
   }
-  if (state.state === "absent" && legacyManagedRecord(files.get(HARNESS_CONFIG_PATH))) {
-    return legacyManagedNotice(HARNESS_CONFIG_PATH);
-  }
   const carried = state.state === "valid" ? state.record : emptyRecord();
   for (const [path, contract] of Object.entries(carried.files)) {
     if (contract.scope !== "fields") {
@@ -3238,10 +3385,10 @@ function planUndo(input) {
   const notes = [];
   const tail = () => {
     notes.push(`Codex keeps its own global config \u2014 remove it with: ${codexRemoveCommand()}`);
-    notes.push(`If you set ${ROLE_ENV_VAR} (or the older ${LEGACY_ROLE_ENV_VAR}) anywhere, unset it too.`);
+    notes.push(`If you set ${ROLE_ENV_VAR} anywhere, unset it too.`);
   };
   if (state.state === "absent") {
-    notes.push(legacyManagedRecord(input.files.get(HARNESS_CONFIG_PATH)) ? legacyManagedNotice(HARNESS_CONFIG_PATH) : `No record of a previous init in ${HARNESS_RECORD_PATH} \u2014 no local file was changed.`);
+    notes.push(`No record of a previous init in ${HARNESS_RECORD_PATH} \u2014 no local file was changed.`);
     tail();
     return { writes, deletes, codexCommand: codexRemoveCommand(), notes };
   }
@@ -3502,95 +3649,6 @@ function previousRole(path, existing) {
   return read.kind === "role" ? read.role : void 0;
 }
 
-// src/core/harness/legacyLayout.ts
-var LEGACY_PATHS = new Map(
-  [HARNESS_DOC_PATH, HARNESS_CONFIG_PATH, HARNESS_RECORD_PATH].map((path) => [path, toLegacy(path)])
-);
-var LEGACY_RECORD_PATH = toLegacy(HARNESS_RECORD_PATH);
-var LEGACY_SNAPSHOT_PATHS = [...LEGACY_PATHS.values()];
-function adoptLegacyLayout(disk) {
-  const files = /* @__PURE__ */ new Map();
-  for (const [path, content] of disk) {
-    if (!LEGACY_SNAPSHOT_PATHS.includes(path)) {
-      files.set(path, content);
-    }
-  }
-  const view = { files, moves: [], legacyDirCreatedByUs: false, notes: [] };
-  if (!LEGACY_SNAPSHOT_PATHS.some((path) => disk.get(path) !== void 0)) {
-    return view;
-  }
-  const legacyRecord = disk.get(LEGACY_RECORD_PATH);
-  if (legacyRecord === void 0) {
-    const legacyConfig = LEGACY_PATHS.get(HARNESS_CONFIG_PATH);
-    if (disk.get(HARNESS_RECORD_PATH) === void 0 && legacyManagedRecord(disk.get(legacyConfig))) {
-      return { ...view, refusal: legacyManagedNotice(legacyConfig) };
-    }
-    view.notes.push(
-      `${LEGACY_HARNESS_DIR}/ was left in place \u2014 there is no ${LEGACY_RECORD_PATH} showing that an earlier version of this CLI wrote it. Remove it by hand if it is a leftover.`
-    );
-    return view;
-  }
-  const state = readRecord(legacyRecord, LEGACY_RECORD_PATH);
-  if (state.state !== "valid") {
-    return {
-      ...view,
-      refusal: state.state === "absent" ? `${LEGACY_RECORD_PATH} could not be read. Nothing was changed.` : `${state.reason}. Nothing was changed \u2014 move that file aside (or restore it) and run again.`
-    };
-  }
-  const clash = [...LEGACY_PATHS].filter(([to, from]) => disk.get(to) !== void 0 && disk.get(from) !== void 0).map(([to]) => to);
-  if (clash.length > 0) {
-    return {
-      ...view,
-      refusal: `Both ${LEGACY_HARNESS_DIR}/ and ${HARNESS_DIR}/ hold AiNecto setup files (${clash.join(", ")}): an older version of this CLI (0.4.x) ran here after this one, or a move was interrupted. Nothing was changed. Undo the older setup with \`npx -y -p @ai-erd/mcp@0.4.6 ai-erd init --undo\` (or remove the ${LEGACY_HARNESS_DIR}/ leftovers by hand), then run again.`
-    };
-  }
-  const record = state.record;
-  const renamed = {
-    ...record,
-    files: Object.fromEntries(Object.entries(record.files).map(([path, contract]) => [toCurrent(path), contract])),
-    // «하네스 폴더를 우리가 만들었다»는 같은 사실이다 — 이름만 옮긴다. 새 폴더를 이번에 만들면 적용이 또 적는다.
-    createdDirectories: record.createdDirectories.map(toCurrent)
-  };
-  const moves = [];
-  for (const [to, from] of LEGACY_PATHS) {
-    const content = disk.get(from);
-    if (content === void 0) {
-      continue;
-    }
-    files.set(to, to === HARNESS_RECORD_PATH ? serializeRecord(renamed) : content);
-    moves.push({ from, to });
-  }
-  return {
-    files,
-    moves,
-    legacyDirCreatedByUs: record.createdDirectories.includes(LEGACY_HARNESS_DIR),
-    notes: [`${LEGACY_HARNESS_DIR}/ \u2192 ${HARNESS_DIR}/: moved what an earlier version of this CLI wrote (the folder was renamed).`]
-  };
-}
-function withLegacyMoves(plan, view) {
-  if (view.moves.length === 0) {
-    return view.notes.length === 0 ? plan : { ...plan, notes: [...view.notes, ...plan.notes] };
-  }
-  const movedTo = new Set(view.moves.map((move) => move.to));
-  const planned = /* @__PURE__ */ new Set([...plan.writes.map((write) => write.path), ...plan.deletes]);
-  const carried = view.moves.filter((move) => !planned.has(move.to)).map((move) => ({ path: move.to, content: view.files.get(move.to), existed: false }));
-  return {
-    ...plan,
-    // 새 경로는 디스크에 아직 없다 — «만든다»가 사실이다.
-    writes: [...plan.writes.map((write) => movedTo.has(write.path) ? { ...write, existed: false } : write), ...carried],
-    // 새 경로의 삭제는 디스크에 없는 파일이다 — 대신 옛 파일을 지운다.
-    deletes: [...plan.deletes.filter((path) => !movedTo.has(path)), ...view.moves.map((move) => move.from)],
-    notes: [...view.notes, ...plan.notes],
-    removableDirectories: view.legacyDirCreatedByUs ? [...plan.removableDirectories ?? [], LEGACY_HARNESS_DIR] : plan.removableDirectories
-  };
-}
-function toLegacy(path) {
-  return `${LEGACY_HARNESS_DIR}${path.slice(HARNESS_DIR.length)}`;
-}
-function toCurrent(path) {
-  return path === LEGACY_HARNESS_DIR || path.startsWith(`${LEGACY_HARNESS_DIR}/`) ? `${HARNESS_DIR}${path.slice(LEGACY_HARNESS_DIR.length)}` : path;
-}
-
 // src/core/harness/documentFetch.ts
 var DOC_KEY2 = "HARNESS.DOC";
 var AGENT_NOTE_KEY2 = "HARNESS.AGENT_NOTE";
@@ -3735,19 +3793,10 @@ async function runInit(initialOptions) {
   const args = parseInitArgs(options.argv);
   const root = resolve2(options.cwd);
   const rootNotes = await repositoryRootNotes(root);
-  const disk = await readSnapshot(root);
-  const layout = adoptLegacyLayout(disk);
-  const files = layout.files;
+  const files = await readSnapshot(root);
   if (args.undo) {
-    if (layout.refusal !== void 0) {
-      options.io.stdout.write(renderSuccess(
-        { action: args.dryRun ? "undo (dry-run)" : "undo", updated: [], removed: [], notes: [...rootNotes, layout.refusal] },
-        { json: options.json }
-      ));
-      return 0;
-    }
-    const plan2 = withLegacyMoves(planUndo({ files }), layout);
-    await applyPlan(root, plan2, args.dryRun, disk, false);
+    const plan2 = planUndo({ files });
+    await applyPlan(root, plan2, args.dryRun, files, false);
     options.io.stdout.write(renderSuccess(
       {
         action: args.dryRun ? "undo (dry-run)" : "undo",
@@ -3759,7 +3808,7 @@ async function runInit(initialOptions) {
     ));
     return 0;
   }
-  const refusal = layout.refusal ?? initRefusal(files);
+  const refusal = initRefusal(files);
   if (refusal !== void 0) {
     throw new Error(refusal);
   }
@@ -3794,12 +3843,11 @@ async function runInit(initialOptions) {
   const documents = args.dryRun ? { versions: {}, fallbacks: {}, unavailableReason: "skipped in --dry-run" } : await fetchHarnessDocuments({
     endpoint: options.endpoint,
     accessToken: await options.accessToken?.(),
-    // ⛔이 이름은 바꾸지 않는다 — 서버가 문서의 클라이언트별 변형 키(HARNESS.DOC.AI_ERD_CLI 등)를 이것으로
-    //   찾는다. 사람에게 안 보이는 서버 쪽 식별자다(역할 헤더·scope 와 같은 이유, 2026-10-11).
-    client: "ai-erd-cli",
+    // 서버가 문서의 클라이언트별 변형 키를 이 이름으로 찾는다.
+    client: "ainecto-cli",
     fetchImpl: options.fetchImpl
   });
-  const plan = withLegacyMoves(planInit({
+  const plan = planInit({
     role,
     env: options.env,
     projectName: project.name,
@@ -3808,11 +3856,11 @@ async function runInit(initialOptions) {
     cliVersion: options.cliVersion,
     files,
     documents
-  }), layout);
+  });
   if (plan.refusal !== void 0) {
     throw new Error(plan.refusal);
   }
-  await applyPlan(root, plan, args.dryRun, disk);
+  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.
 `);
@@ -3824,8 +3872,6 @@ async function runInit(initialOptions) {
       project: { uuid: project.uuid, name: project.name },
       endpoint: options.endpoint,
       written: plan.writes.map((write) => `${write.existed ? "updated" : "created"} ${write.path}`),
-      // 옛 폴더(.ai-erd/)를 옮길 때만 생긴다 — 지운 것을 말하지 않으면 사용자는 옛 파일이 어디 갔는지 모른다.
-      ...plan.deletes.length > 0 ? { removed: plan.deletes } : {},
       codex: `Codex keeps a single global config, so init does not touch it. Run: ${plan.codexCommand}`,
       codexPerSession: plan.codexProfile,
       codexEnvFallback: `Without a profile, start the session with ${ROLE_ENV_VAR}=${role}.`,
@@ -3848,9 +3894,6 @@ async function runInit(initialOptions) {
         `Codex: save the profile above as $CODEX_HOME/${role}.config.toml and start with \`codex -p ${role}\`.`,
         role === "design" ? "To check the role, change a table through `ainecto` \u2014 Design may, and the change lands in AiNecto." : `To check the role, try changing a table through \`ainecto\` \u2014 ${role} is told to stop.`,
         `If the new Claude Code session still has no role, run \`claude mcp get ${SERVER_NAME}\`: a local-scope "${SERVER_NAME}" entry hides .mcp.json (remove it with \`claude mcp remove ${SERVER_NAME} -s local\`).`,
-        // ★서버 이름이 바뀌었다(0.5.0). 예전에 같은 이름("ai-erd")이라 .mcp.json 이 덮던 사용자·Codex 전역 항목이
-        //   이제는 «따로» 붙어, 그 세션이 역할 없는 서버를 하나 더 본다. 그 항목을 지우는 법을 같이 말한다.
-        `If you added AiNecto earlier as "${LEGACY_SERVER_NAME}" (Claude Code user scope, or Codex), remove it \u2014 it no longer hides behind this "${SERVER_NAME}" entry: \`claude mcp remove ${LEGACY_SERVER_NAME} -s user\`, \`codex mcp remove ${LEGACY_SERVER_NAME}\`.`,
         "Undo everything with: ainecto init --undo"
       ]
     },
@@ -4044,11 +4087,11 @@ async function createProject(options, name) {
   return first;
 }
 function unwrapToolJson(result) {
-  if (!isRecord9(result) || !Array.isArray(result.content)) {
+  if (!isRecord11(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") {
+  const first = result.content.find((item) => isRecord11(item) && item.type === "text");
+  if (!isRecord11(first) || typeof first.text !== "string") {
     return result;
   }
   try {
@@ -4058,13 +4101,13 @@ function unwrapToolJson(result) {
   }
 }
 function extractProjects(value) {
-  const candidates = Array.isArray(value) ? value : isRecord9(value) ? ["projects", "items", "created", "data", "hits"].flatMap((key) => {
+  const candidates = Array.isArray(value) ? value : isRecord11(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") {
+    if (isRecord11(candidate) && typeof candidate.uuid === "string") {
       projects.push({
         uuid: candidate.uuid,
         name: typeof candidate.name === "string" ? candidate.name : candidate.uuid
@@ -4086,7 +4129,7 @@ function boundProjectUuid(config) {
 }
 async function readSnapshot(root) {
   const snapshot = /* @__PURE__ */ new Map();
-  for (const path of [...MANAGED_PATHS, ...LEGACY_SNAPSHOT_PATHS]) {
+  for (const path of MANAGED_PATHS) {
     snapshot.set(path, await readManagedFile(root, path));
   }
   return snapshot;
@@ -4105,9 +4148,9 @@ async function applyPlan(root, plan, dryRun, snapshot, recordFirst = true) {
   }
   const applied = [];
   try {
-    const isRecord10 = (path) => !recordFirst && (path === HARNESS_RECORD_PATH || path === LEGACY_RECORD_PATH);
-    const recordWrites = plan.writes.filter((write) => isRecord10(write.path));
-    const recordDeletes = plan.deletes.filter((path) => isRecord10(path));
+    const 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) {
@@ -4149,8 +4192,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);
@@ -4187,8 +4230,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);
@@ -4197,7 +4240,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) {
@@ -4206,12 +4249,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;
     }
   }
@@ -4221,7 +4264,7 @@ 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;
@@ -4261,7 +4304,7 @@ function basenameOf(path) {
   const parts = path.split(/[\\/]/).filter(Boolean);
   return parts[parts.length - 1] ?? "ainecto-project";
 }
-function isRecord9(value) {
+function isRecord11(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -4365,7 +4408,7 @@ async function runAinectoCli(argv, io) {
       });
     }
     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);
       if (live && matchGeneratedCommand(live, parsed.positionals)) {
@@ -4386,6 +4429,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,
@@ -4415,7 +4461,7 @@ async function commandRole(explicit, cwd) {
     return explicitRole;
   }
   if (explicitRole !== null && explicitRole !== found.role) {
-    const given = explicit.source === "env" ? `${explicit.envVar}=${explicitRole}` : `--role ${explicitRole}`;
+    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.`
     );
@@ -4550,6 +4596,11 @@ function helpText() {
     "  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]",
     "",
@@ -4557,8 +4608,6 @@ function helpText() {
     "  ainecto init [--role <design|development|test|validation>] [--project <uuid>] [--dry-run]",
     "      In a terminal, asks for the role and project when they are not given.",
     "  ainecto init --undo",
-    "",
-    "`ai-erd` (the older name) is the same command and still works.",
     ""
   ].join("\n");
 }