ask-marcel-office-cli 2.2.0 → 2.3.0

package/dist/cli.js

@@ -13916,8 +13916,41 @@ var init_zod = __esm(() => {
   init_external();
 });
 
+// src/use-cases/commands/reject-unknown-params.ts
+var camelToKebab = (value) => value.replaceAll(/[A-Z]/g, (c) => `-${c.toLowerCase()}`), allowedKeys = (schema) => {
+  if (!(schema instanceof exports_external.ZodObject))
+    return [];
+  return Object.keys(schema.shape);
+}, unknownParamError = (unknown2, allowed) => {
+  const named = unknown2.map((k) => `--${camelToKebab(k)}`).join(", ");
+  const supported = allowed.map((k) => `--${camelToKebab(k)}`).toSorted((a, b) => a.localeCompare(b)).join(", ");
+  return {
+    type: "validation_error",
+    code: "unknown_parameter",
+    message: `${named} ${unknown2.length === 1 ? "is not a parameter" : "are not parameters"} of this command, so it would have been ignored rather than applied. Supported: ${supported || "(none)"}.`
+  };
+}, rejectUnknownParams = (schema, params) => {
+  const allowed = allowedKeys(schema);
+  if (allowed.length === 0)
+    return;
+  const unknown2 = Object.keys(params).filter((key) => !allowed.includes(key));
+  if (unknown2.length === 0)
+    return;
+  return err(unknownParamError(unknown2, allowed));
+}, withUnknownParamRejection = (command) => {
+  const { executeLocal } = command;
+  return {
+    ...command,
+    execute: async (graph, params) => rejectUnknownParams(command.schema, params) ?? await command.execute(graph, params),
+    ...executeLocal === undefined ? {} : { executeLocal: async (fs, params) => rejectUnknownParams(command.schema, params) ?? await executeLocal(fs, params) }
+  };
+};
+var init_reject_unknown_params = __esm(() => {
+  init_zod();
+});
+
 // src/use-cases/commands/format-zod-error.ts
-var camelToKebab = (s) => s.replaceAll(/([A-Z])/g, "-$1").toLowerCase(), humanize = (issue2) => {
+var camelToKebab2 = (s) => s.replaceAll(/([A-Z])/g, "-$1").toLowerCase(), humanize = (issue2) => {
   if (issue2.code === "invalid_type")
     return "is missing";
   if (issue2.code === "too_small") {
@@ -13933,7 +13966,7 @@ var camelToKebab = (s) => s.replaceAll(/([A-Z])/g, "-$1").toLowerCase(), humaniz
     if (issue2.path.length === 0)
       return `<root>: ${issue2.message}`;
     const path = renderPath(issue2.path);
-    const flag = `--${camelToKebab(path)}`;
+    const flag = `--${camelToKebab2(path)}`;
     return `${flag} ${humanize(issue2)}`;
   }).join("; ");
 };
@@ -16652,7 +16685,6 @@ var init_download_drive_item_content = __esm(() => {
   meta8 = {
     summary: 'Download the binary content of a file stored in OneDrive / SharePoint, with the bytes inlined. The CLI follows the Graph 302 → SharePoint media-transform redirect internally so the LLM never has to fetch an external URL. The bytes are CONTENT-SNIFFED, not judged by extension: if they decode as valid UTF-8 they come back as `{contentType: "text/plain", size, text}` (avoids ~33% base64 bloat, works for any text file regardless of name); otherwise as `{contentType, size, base64}`. A binary file that happens to be named `.txt` is returned faithfully as base64 — never silently corrupted into `�` by a forced text decode.',
     category: "drive",
-    commandAliases: ["download-onedrive-file-content"],
     graphMethod: "GET",
     graphPathTemplate: "/drives/{drive-id}/items/{item-id}/content",
     graphDocsUrl: "https://learn.microsoft.com/en-us/graph/api/driveitem-get-content",
@@ -16922,7 +16954,6 @@ var init_get_calendar_event = __esm(() => {
         name: "event-id",
         key: "eventId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Microsoft Graph event ID. Returned by `ask-marcel-office list-calendar-events` in the `id` field of each event."
       },
       ...selectExpandOptions
@@ -17104,8 +17135,8 @@ var init_get_calendar_view = __esm(() => {
     graphPathTemplate: "/me/calendarView?startDateTime={start-date-time}&endDateTime={end-date-time}",
     graphDocsUrl: "https://learn.microsoft.com/en-us/graph/api/user-list-calendarview",
     options: [
-      { name: "start-date-time", key: "startDateTime", required: true, aliases: [{ name: "start", key: "start" }], description: `Lower bound. ${RELATIVE_DATE_DESCRIPTION}` },
-      { name: "end-date-time", key: "endDateTime", required: true, aliases: [{ name: "end", key: "end" }], description: `Upper bound. ${RELATIVE_DATE_DESCRIPTION}` },
+      { name: "start-date-time", key: "startDateTime", required: true, description: `Lower bound. ${RELATIVE_DATE_DESCRIPTION}` },
+      { name: "end-date-time", key: "endDateTime", required: true, description: `Upper bound. ${RELATIVE_DATE_DESCRIPTION}` },
       ...odataQueryOptions
     ],
     example: "ask-marcel-office list-calendar-view --start-date-time 'start-of-week' --end-date-time 'end-of-week'",
@@ -17152,7 +17183,7 @@ var init_get_drive_delta = __esm(() => {
   init_build_command();
   init_odata_query();
   baseSchema4 = exports_external.object({ driveId: exports_external.string().min(1), itemId: exports_external.string().min(1) });
-  ({ execute: execute10, schema: schema10 } = buildNoSkipListCommand((p) => `/drives/${p.driveId}/items/${p.itemId}/delta()`, baseSchema4));
+  ({ execute: execute10, schema: schema10 } = buildPickODataListCommand((p) => `/drives/${p.driveId}/items/${p.itemId}/delta()`, baseSchema4, ["top", "select", "expand"]));
   meta12 = {
     summary: "Get the incremental change set (added / modified / deleted items) under a OneDrive / SharePoint folder. Use the `@odata.deltaLink` from a previous response to resume.",
     category: "drive",
@@ -17170,10 +17201,9 @@ var init_get_drive_delta = __esm(() => {
         name: "item-id",
         key: "itemId",
         required: true,
-        description: "driveItem ID of the folder whose subtree to track. Use the root folder ID from `get-drive-root-item` to track the entire drive. Accepts `--folder-id` as an alias for parity with `list-folder-files` (same concept, same flag name).",
-        aliases: [{ name: "folder-id", key: "folderId" }]
+        description: "driveItem ID of the folder whose subtree to track. Use the root folder ID from `get-drive-root-item` to track the entire drive."
       },
-      ...noSkipOptions
+      ...pickODataOptions(["top", "select", "expand"])
     ],
     example: "ask-marcel-office get-drive-delta --drive-id 'b!1234' --item-id '01ROOT'",
     responseShape: "collection of changed Microsoft Graph `driveItem` resources under `data.value[]`. Cursor tokens are hoisted to envelope level: top-level `nextLink` while paging, then top-level `deltaLink` on the final page.",
@@ -17244,7 +17274,6 @@ var init_get_drive_root_item = __esm(() => {
         name: "drive-id",
         key: "driveId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: DRIVE_ID_DESCRIPTION
       },
       ...selectExpandOptions
@@ -17530,8 +17559,7 @@ var init_get_mail_message = __esm(() => {
         name: "message-id",
         key: "messageId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
-        description: "Outlook message ID. Returned by `ask-marcel-office list-mail-messages` or `list-mail-folder-messages`. Accepts `--id` as an alias."
+        description: "Outlook message ID. Returned by `ask-marcel-office list-mail-messages` or `list-mail-folder-messages`."
       },
       ...selectExpandOptions
     ],
@@ -17725,8 +17753,7 @@ var init_convert_mail_to_markdown = __esm(() => {
         name: "message-id",
         key: "messageId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
-        description: "Outlook message ID. Returned by `list-mail-messages` or `list-mail-folder-messages`. Accepts `--id` as an alias."
+        description: "Outlook message ID. Returned by `list-mail-messages` or `list-mail-folder-messages`."
       },
       {
         name: "inline-images",
@@ -17872,8 +17899,7 @@ var init_get_mail_signature = __esm(() => {
         name: "message-id",
         key: "messageId",
         required: false,
-        aliases: [{ name: "id", key: "id" }],
-        description: "Read the signature from THIS message instead of scanning the sent folder. Use when the scan finds nothing (the message was composed in Outlook desktop) or to pin a specific signature. Source from list-mail-folder-messages --mail-folder-id sentitems. Accepts `--id` as an alias.",
+        description: "Read the signature from THIS message instead of scanning the sent folder. Use when the scan finds nothing (the message was composed in Outlook desktop) or to pin a specific signature. Source from list-mail-folder-messages --mail-folder-id sentitems.",
         argumentHint: { kind: "idOrName" }
       }
     ],
@@ -18143,11 +18169,7 @@ var init_get_onenote_page_as_markdown = __esm(() => {
         name: "onenote-page-id",
         key: "onenotePageId",
         required: true,
-        description: "OneNote page ID. Returned by `ask-marcel-office list-onenote-section-pages`.",
-        aliases: [
-          { name: "id", key: "id" },
-          { name: "page-id", key: "pageId" }
-        ]
+        description: "OneNote page ID. Returned by `ask-marcel-office list-onenote-section-pages`."
       },
       {
         name: "inline-images",
@@ -18198,11 +18220,7 @@ var init_get_onenote_page_content = __esm(() => {
         name: "onenote-page-id",
         key: "onenotePageId",
         required: true,
-        description: "OneNote page ID. Returned by `ask-marcel-office list-onenote-section-pages`.",
-        aliases: [
-          { name: "id", key: "id" },
-          { name: "page-id", key: "pageId" }
-        ]
+        description: "OneNote page ID. Returned by `ask-marcel-office list-onenote-section-pages`."
       }
     ],
     example: "ask-marcel-office get-onenote-page-content --onenote-page-id '1-abc...'",
@@ -18235,11 +18253,7 @@ var init_get_planner_bucket = __esm(() => {
         name: "planner-bucket-id",
         key: "plannerBucketId",
         required: true,
-        description: "Planner bucket ID. Returned by `ask-marcel-office list-plan-buckets`.",
-        aliases: [
-          { name: "id", key: "id" },
-          { name: "bucket-id", key: "bucketId" }
-        ]
+        description: "Planner bucket ID. Returned by `ask-marcel-office list-plan-buckets`."
       }
     ],
     example: "ask-marcel-office get-planner-bucket --planner-bucket-id 'sFNeQRFu_kqhxpwwAhmA15gAGfoT'",
@@ -18271,11 +18285,7 @@ var init_get_planner_plan = __esm(() => {
         name: "planner-plan-id",
         key: "plannerPlanId",
         required: true,
-        description: "Planner plan ID. Returned in the `planId` field of any task from `ask-marcel-office list-planner-tasks`.",
-        aliases: [
-          { name: "id", key: "id" },
-          { name: "plan-id", key: "planId" }
-        ]
+        description: "Planner plan ID. Returned in the `planId` field of any task from `ask-marcel-office list-planner-tasks`."
       }
     ],
     example: "ask-marcel-office get-planner-plan --planner-plan-id 'xqQg5FS2LkCp935s-FIFm5gAB6'",
@@ -18307,11 +18317,7 @@ var init_get_planner_task_details = __esm(() => {
         name: "planner-task-id",
         key: "plannerTaskId",
         required: true,
-        description: "Planner task ID. Returned by `ask-marcel-office list-planner-tasks` or `list-plan-tasks`. Accepts `--task-id` as a shorter alias (each task command targets exactly one of Planner or To Do, so within this command's flag set there is no ambiguity).",
-        aliases: [
-          { name: "id", key: "id" },
-          { name: "task-id", key: "taskId" }
-        ]
+        description: "Planner task ID. Returned by `ask-marcel-office list-planner-tasks` or `list-plan-tasks`."
       }
     ],
     example: "ask-marcel-office get-planner-task-details --planner-task-id '01tx7Ic7-USXEwt0lvR1cmgAH8gK'",
@@ -18343,11 +18349,7 @@ var init_get_planner_task = __esm(() => {
         name: "planner-task-id",
         key: "plannerTaskId",
         required: true,
-        description: "Planner task ID. Returned by `ask-marcel-office list-planner-tasks` or `list-plan-tasks`. Accepts `--task-id` as a shorter alias (each task command targets exactly one of Planner or To Do, so within this command's flag set there is no ambiguity).",
-        aliases: [
-          { name: "id", key: "id" },
-          { name: "task-id", key: "taskId" }
-        ]
+        description: "Planner task ID. Returned by `ask-marcel-office list-planner-tasks` or `list-plan-tasks`."
       }
     ],
     example: "ask-marcel-office get-planner-task --planner-task-id '01tx7Ic7-USXEwt0lvR1cmgAH8gK'",
@@ -18459,8 +18461,7 @@ var init_get_sharepoint_site_list_item = __esm(() => {
         name: "list-item-id",
         key: "listItemId",
         required: true,
-        description: "listItem ID (typically a small integer). Returned by `ask-marcel-office list-sharepoint-site-list-items`.",
-        aliases: [{ name: "item-id", key: "itemId" }]
+        description: "listItem ID (typically a small integer). Returned by `ask-marcel-office list-sharepoint-site-list-items`."
       },
       ...selectExpandOptions
     ],
@@ -18530,7 +18531,6 @@ var init_get_sharepoint_site = __esm(() => {
         name: "site-id",
         key: "siteId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "SharePoint site ID. Either the composite ID (`hostname,site-collection-id,site-id`) returned by `ask-marcel-office search-sharepoint-sites-by-name`, or the literal `root` to refer to the tenant root site."
       },
       ...selectExpandOptions
@@ -18587,21 +18587,18 @@ var init_get_schedule = __esm(() => {
         name: "schedules",
         key: "schedules",
         required: true,
-        aliases: [{ name: "emails", key: "emails" }],
         description: "Comma-separated SMTP addresses of the users and/or room resources to check (e.g. `alice@contoso.com,bob@contoso.com,room-4a@contoso.com`). Resolve names to addresses first via `list-relevant-people` or `microsoft-search-query`."
       },
       {
         name: "start-date-time",
         key: "startDateTime",
         required: true,
-        aliases: [{ name: "start", key: "start" }],
         description: `Window lower bound (interpreted as UTC). ${RELATIVE_DATE_DESCRIPTION}`
       },
       {
         name: "end-date-time",
         key: "endDateTime",
         required: true,
-        aliases: [{ name: "end", key: "end" }],
         description: `Window upper bound (interpreted as UTC). Graph caps the span at 62 days. ${RELATIVE_DATE_DESCRIPTION}`
       },
       {
@@ -18689,11 +18686,10 @@ var init_get_specific_calendar_view = __esm(() => {
         name: "calendar-id",
         key: "calendarId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Calendar ID, or `primary` / `default` for the signed-in user’s default calendar. Returned by `ask-marcel-office list-calendars`."
       },
-      { name: "start-date-time", key: "startDateTime", required: true, aliases: [{ name: "start", key: "start" }], description: `Lower bound. ${RELATIVE_DATE_DESCRIPTION}` },
-      { name: "end-date-time", key: "endDateTime", required: true, aliases: [{ name: "end", key: "end" }], description: `Upper bound. ${RELATIVE_DATE_DESCRIPTION}` },
+      { name: "start-date-time", key: "startDateTime", required: true, description: `Lower bound. ${RELATIVE_DATE_DESCRIPTION}` },
+      { name: "end-date-time", key: "endDateTime", required: true, description: `Upper bound. ${RELATIVE_DATE_DESCRIPTION}` },
       ...odataQueryOptions
     ],
     example: "ask-marcel-office list-specific-calendar-view --calendar-id 'primary' --start-date-time '2026-04-01T00:00:00Z' --end-date-time '2026-05-01T00:00:00Z'",
@@ -18771,7 +18767,6 @@ var init_get_team = __esm(() => {
         name: "team-id",
         key: "teamId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Microsoft Teams team ID. Returned by `ask-marcel-office list-joined-teams`."
       },
       ...selectExpandOptions
@@ -18838,18 +18833,13 @@ var init_get_todo_task = __esm(() => {
         name: "todo-task-list-id",
         key: "todoTaskListId",
         required: true,
-        description: "To Do task list ID. Returned by `ask-marcel-office list-todo-task-lists`.",
-        aliases: [
-          { name: "task-list-id", key: "taskListId" },
-          { name: "todo-list-id", key: "todoListId" }
-        ]
+        description: "To Do task list ID. Returned by `ask-marcel-office list-todo-task-lists`."
       },
       {
         name: "todo-task-id",
         key: "todoTaskId",
         required: true,
-        description: "To Do task ID. Returned by `ask-marcel-office list-todo-tasks`. Accepts `--task-id` as a shorter alias (within this command's flag set the To Do context is unambiguous).",
-        aliases: [{ name: "task-id", key: "taskId" }]
+        description: "To Do task ID. Returned by `ask-marcel-office list-todo-tasks`."
       },
       ...selectExpandOptions
     ],
@@ -18940,11 +18930,10 @@ var init_list_calendar_event_instances = __esm(() => {
         name: "event-id",
         key: "eventId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Recurring event ID. Returned by `ask-marcel-office list-specific-calendar-events`."
       },
-      { name: "start-date-time", key: "startDateTime", required: true, aliases: [{ name: "start", key: "start" }], description: `Lower bound. ${RELATIVE_DATE_DESCRIPTION}` },
-      { name: "end-date-time", key: "endDateTime", required: true, aliases: [{ name: "end", key: "end" }], description: `Upper bound. ${RELATIVE_DATE_DESCRIPTION}` },
+      { name: "start-date-time", key: "startDateTime", required: true, description: `Lower bound. ${RELATIVE_DATE_DESCRIPTION}` },
+      { name: "end-date-time", key: "endDateTime", required: true, description: `Upper bound. ${RELATIVE_DATE_DESCRIPTION}` },
       ...odataQueryOptions
     ],
     example: "ask-marcel-office list-calendar-event-instances --calendar-id 'AAMkAGI2THVS...' --event-id 'AAMkABC...' --start-date-time '2026-04-01T00:00:00Z' --end-date-time '2026-05-01T00:00:00Z'",
@@ -19063,14 +19052,12 @@ var init_list_calendar_view_delta = __esm(() => {
         name: "start-date-time",
         key: "startDateTime",
         required: true,
-        aliases: [{ name: "start", key: "start" }],
         description: `Lower bound (required on the first call only — the deltaLink token encodes it for resumes). ${RELATIVE_DATE_DESCRIPTION}`
       },
       {
         name: "end-date-time",
         key: "endDateTime",
         required: true,
-        aliases: [{ name: "end", key: "end" }],
         description: `Upper bound (required on the first call only — the deltaLink token encodes it for resumes). ${RELATIVE_DATE_DESCRIPTION}`
       },
       ...topOnlyOptions
@@ -19150,7 +19137,6 @@ var init_list_chat_members = __esm(() => {
         name: "chat-id",
         key: "chatId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Microsoft Teams chat ID, e.g. `19:abc...@thread.v2`. " + "Source the ID via `ask-marcel-office list-chats` (returns chat metadata for the signed-in user). " + "Alternative sources outside the CLI: the Teams desktop / web client (Open in browser → URL contains the chat thread ID), Microsoft Graph Explorer, " + "or URL-decode the `19%3ameeting_...%40thread.v2` segment of an `onlineMeeting.joinUrl` from `list-calendar-events`."
       },
       ...pickODataOptions(CHAT_MEMBERS_ODATA_KEYS)
@@ -19424,8 +19410,7 @@ var init_list_folder_files = __esm(() => {
         name: "item-id",
         key: "itemId",
         required: true,
-        description: 'driveItem ID of the folder (Graph identifies folders as driveItems too — there is no separate folder type). Use the root folder ID from `ask-marcel-office get-drive-root-item` to list the top of a drive. Accepts `--folder-id` as an alias since the command name implies "folder".',
-        aliases: [{ name: "folder-id", key: "folderId" }]
+        description: "driveItem ID of the folder (Graph identifies folders as driveItems too — there is no separate folder type). Use the root folder ID from `ask-marcel-office get-drive-root-item` to list the top of a drive."
       },
       ...noSkipOptions,
       TENANT_ID_OPTION
@@ -19516,12 +19501,7 @@ var init_list_incomplete_todo_tasks = __esm(() => {
         name: "todo-task-list-id",
         key: "todoTaskListId",
         required: true,
-        description: "todoTaskList ID. Returned by `ask-marcel-office list-todo-task-lists`. The well-known name `tasks` (the default list) is accepted on this incomplete-tasks endpoint specifically — sibling commands like `list-todo-tasks` and `list-todo-tasks-delta` only accept resolved IDs. There is no Graph endpoint that returns incomplete tasks across every list — call this once per list.",
-        aliases: [
-          { name: "id", key: "id" },
-          { name: "task-list-id", key: "taskListId" },
-          { name: "todo-list-id", key: "todoListId" }
-        ]
+        description: "todoTaskList ID. Returned by `ask-marcel-office list-todo-task-lists`. The well-known name `tasks` (the default list) is accepted on this incomplete-tasks endpoint specifically — sibling commands like `list-todo-tasks` and `list-todo-tasks-delta` only accept resolved IDs. There is no Graph endpoint that returns incomplete tasks across every list — call this once per list."
       },
       ...odataQueryOptions
     ],
@@ -19588,8 +19568,7 @@ var init_list_mail_attachments = __esm(() => {
         name: "message-id",
         key: "messageId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
-        description: "Outlook message ID. Returned by `ask-marcel-office list-mail-messages` or `list-mail-folder-messages`. Accepts `--id` as an alias."
+        description: "Outlook message ID. Returned by `ask-marcel-office list-mail-messages` or `list-mail-folder-messages`."
       },
       ...odataQueryOptions
     ],
@@ -19624,7 +19603,6 @@ var init_list_mail_child_folders = __esm(() => {
         name: "mail-folder-id",
         key: "mailFolderId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "mailFolder ID. Returned by `ask-marcel-office list-mail-folders`. Well-known names also work, e.g. `inbox`, `sentitems`, `drafts`."
       },
       ...odataQueryOptions
@@ -19660,7 +19638,6 @@ var init_list_mail_folder_messages = __esm(() => {
         name: "mail-folder-id",
         key: "mailFolderId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "mailFolder ID. Returned by `ask-marcel-office list-mail-folders`. Well-known names also work, e.g. `inbox`, `sentitems`, `drafts`. When listing `drafts`, a `conversationId` `$filter` is not a reliable check for whether a draft already exists on a thread: reply and forward drafts can split across several conversationIds, and `$filter` on Drafts is not read-your-writes consistent. Match client-side on subject and recipients instead, or use the `find-mail-drafts` command, which does exactly that."
       },
       ...odataQueryOptions
@@ -19782,7 +19759,6 @@ var init_list_onenote_notebook_sections = __esm(() => {
         name: "notebook-id",
         key: "notebookId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "OneNote notebook ID. Returned by `ask-marcel-office list-onenote-notebooks`."
       },
       ...odataQueryOptions
@@ -19845,11 +19821,7 @@ var init_list_onenote_section_pages = __esm(() => {
         name: "onenote-section-id",
         key: "onenoteSectionId",
         required: true,
-        description: "OneNote section ID. Returned by `ask-marcel-office list-onenote-notebook-sections` or `list-all-onenote-sections`.",
-        aliases: [
-          { name: "id", key: "id" },
-          { name: "section-id", key: "sectionId" }
-        ]
+        description: "OneNote section ID. Returned by `ask-marcel-office list-onenote-notebook-sections` or `list-all-onenote-sections`."
       },
       ...odataQueryOptions
     ],
@@ -19884,11 +19856,7 @@ var init_list_plan_buckets = __esm(() => {
         name: "planner-plan-id",
         key: "plannerPlanId",
         required: true,
-        description: "Planner plan ID. Returned in the `planId` field of any task from `ask-marcel-office list-planner-tasks`.",
-        aliases: [
-          { name: "id", key: "id" },
-          { name: "plan-id", key: "planId" }
-        ]
+        description: "Planner plan ID. Returned in the `planId` field of any task from `ask-marcel-office list-planner-tasks`."
       },
       ...selectOnlyOptions
     ],
@@ -19922,11 +19890,7 @@ var init_list_plan_tasks = __esm(() => {
         name: "planner-plan-id",
         key: "plannerPlanId",
         required: true,
-        description: "Planner plan ID. Returned in the `planId` field of any task from `ask-marcel-office list-planner-tasks`.",
-        aliases: [
-          { name: "id", key: "id" },
-          { name: "plan-id", key: "planId" }
-        ]
+        description: "Planner plan ID. Returned in the `planId` field of any task from `ask-marcel-office list-planner-tasks`."
       }
     ],
     example: "ask-marcel-office list-plan-tasks --planner-plan-id 'xqQg5FS2LkCp935s-FIFm5gAB6'",
@@ -20014,7 +19978,6 @@ var init_list_sharepoint_site_drives = __esm(() => {
         name: "site-id",
         key: "siteId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "SharePoint site ID. Returned by `ask-marcel-office search-sharepoint-sites-by-name`."
       },
       ...noSkipOptions
@@ -20094,7 +20057,6 @@ var init_list_sharepoint_site_lists = __esm(() => {
         name: "site-id",
         key: "siteId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "SharePoint site ID. Returned by `ask-marcel-office search-sharepoint-sites-by-name`."
       },
       ...noSkipOptions
@@ -20134,7 +20096,6 @@ var init_list_specific_calendar_events = __esm(() => {
         name: "calendar-id",
         key: "calendarId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Calendar ID, or the well-known short name `primary` / `default` for the signed-in user’s default calendar. Use `ask-marcel-office list-calendars` to discover non-default calendar IDs."
       },
       ...odataQueryOptions
@@ -20170,7 +20131,6 @@ var init_list_team_channels = __esm(() => {
         name: "team-id",
         key: "teamId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Microsoft Teams team ID. Returned by `ask-marcel-office list-joined-teams`."
       },
       ...filterSelectOptions
@@ -20205,18 +20165,13 @@ var init_list_todo_linked_resources = __esm(() => {
         name: "todo-task-list-id",
         key: "todoTaskListId",
         required: true,
-        description: "To Do task list ID. Returned by `ask-marcel-office list-todo-task-lists`.",
-        aliases: [
-          { name: "task-list-id", key: "taskListId" },
-          { name: "todo-list-id", key: "todoListId" }
-        ]
+        description: "To Do task list ID. Returned by `ask-marcel-office list-todo-task-lists`."
       },
       {
         name: "todo-task-id",
         key: "todoTaskId",
         required: true,
-        description: "To Do task ID. Returned by `ask-marcel-office list-todo-tasks`. Accepts `--task-id` as a shorter alias (within this command's flag set the To Do context is unambiguous).",
-        aliases: [{ name: "task-id", key: "taskId" }]
+        description: "To Do task ID. Returned by `ask-marcel-office list-todo-tasks`."
       },
       ...odataQueryOptions
     ],
@@ -20289,12 +20244,7 @@ var init_list_todo_tasks = __esm(() => {
         name: "todo-task-list-id",
         key: "todoTaskListId",
         required: true,
-        description: "To Do task list ID. Returned by `ask-marcel-office list-todo-task-lists`.",
-        aliases: [
-          { name: "id", key: "id" },
-          { name: "task-list-id", key: "taskListId" },
-          { name: "todo-list-id", key: "todoListId" }
-        ]
+        description: "To Do task list ID. Returned by `ask-marcel-office list-todo-task-lists`."
       },
       ...odataQueryOptions
     ],
@@ -20464,7 +20414,6 @@ var init_search_onedrive_files = __esm(() => {
         name: "drive-id",
         key: "driveId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Microsoft Graph drive ID to search inside. Use `ask-marcel-office list-drives` for the personal OneDrive, or `ask-marcel-office list-sharepoint-site-drives --site-id <id>` for a SharePoint document library."
       },
       { name: "query", key: "query", required: true, description: "Free-text search query. Matches filename, content, and metadata." },
@@ -20488,7 +20437,7 @@ var noFilterShape, noFilterOptions, schema82, execute82 = async (graph, params)
   const parsed = schema82.safeParse(params);
   if (!parsed.success)
     return err({ type: "validation_error", message: formatZodError(parsed.error) });
-  const path = appendOData(`/me/onenote/pages?$filter=contains(title,'${odataStringLiteral(parsed.data.titleSubstring)}')`, parsed.data);
+  const path = appendOData(`/me/onenote/pages?$filter=contains(title,'${odataStringLiteral(parsed.data.query)}')`, parsed.data);
   return graph.get(path);
 }, meta84;
 var init_search_onenote_pages = __esm(() => {
@@ -20497,24 +20446,23 @@ var init_search_onenote_pages = __esm(() => {
   init_odata_query();
   noFilterShape = Object.fromEntries(Object.entries(odataQuerySchema.shape).filter(([key]) => key !== "filter"));
   noFilterOptions = odataQueryOptions.filter((o) => o.name !== "filter");
-  schema82 = exports_external.object({ titleSubstring: exports_external.string().min(1) }).extend(noFilterShape);
+  schema82 = exports_external.object({ query: exports_external.string().min(1) }).extend(noFilterShape);
   meta84 = {
     summary: "Find OneNote pages whose title contains a substring (case-sensitive — page content is NOT searched). Microsoft removed full-text OneNote `?search=` from v1.0 Graph; only $filter against `title` remains, which is what this command runs. Accepts the OData passthrough flags top/skip/select/orderby/expand. The filter passthrough is intentionally omitted — the path already pins a `$filter` for the title-contains predicate, and Graph rejects two `$filter` query params.",
     category: "notes",
     graphMethod: "GET",
-    graphPathTemplate: "/me/onenote/pages?$filter=contains(title,'{title-substring}')",
+    graphPathTemplate: "/me/onenote/pages?$filter=contains(title,'{query}')",
     graphDocsUrl: "https://learn.microsoft.com/en-us/graph/api/onenote-list-pages",
     options: [
       {
-        name: "title-substring",
-        key: "titleSubstring",
+        name: "query",
+        key: "query",
         required: true,
-        description: "Substring to look for inside OneNote page titles (case-sensitive, exact substring). " + "This is title-only — full-text body search is not available on OneNote pages in v1.0 Graph. " + "Use `list-onenote-section-pages` if you already know the section.",
-        aliases: [{ name: "query", key: "query" }]
+        description: "Substring to look for inside OneNote page TITLES (case-sensitive, exact substring — not a full-text query, despite the flag name shared with the other search commands). " + "Full-text body search is not available on OneNote pages in v1.0 Graph. " + "Use `list-onenote-section-pages` if you already know the section."
       },
       ...noFilterOptions
     ],
-    example: "ask-marcel-office search-onenote-pages --title-substring 'meeting notes' --top 25",
+    example: "ask-marcel-office search-onenote-pages --query 'meeting notes' --top 25",
     responseShape: "collection of Microsoft Graph `onenotePage` resources under `value[]` whose title contains the substring",
     pagination: true
   };
@@ -21473,7 +21421,6 @@ var init_list_calendar_event_attachments = __esm(() => {
         name: "event-id",
         key: "eventId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Outlook calendar event ID. Returned by `ask-marcel-office list-calendar-events` or `get-calendar-event`."
       },
       ...odataQueryOptions
@@ -21578,7 +21525,7 @@ var init_convert_calendar_event_attachment_to_pdf = __esm(() => {
 var BODY_OPEN_TAG, escapeTextAsHtml = (text) => text.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;").replaceAll(/\r\n|\n/g, "<br>"), findBodyInsertStart = (html) => {
   const match = BODY_OPEN_TAG.exec(html);
   return match === null ? 0 : match.index + match[0].length;
-}, commentCarriesQuoteBoundary = (commentHtml) => findQuoteBoundary(commentHtml) !== -1, boundaryMarkerRefusal = (flagName) => `${flagName} carries a quoted-reply boundary marker (a pasted gmail_quote container, an Outlook divRplyFwdMsg / appendonsend / border-top separator, or a bold From: + Sent: header pair). It would be kept verbatim, and a later \`update-mail-draft --comment\` edit would cut the draft at that marker and lose the real quoted history below it. Remove the pasted quote from your text, or pass --body-content-type Text to have it escaped into literal characters.`, insertCommentAboveQuote = (html, commentHtml) => {
+}, commentCarriesQuoteBoundary = (commentHtml) => findQuoteBoundary(commentHtml) !== -1, bodyCarriesQuote = (contentType, content) => contentType.toLowerCase() === "html" ? findQuoteBoundary(content) !== -1 : findPlainTextQuoteBoundary(content) !== -1, boundaryMarkerRefusal = (flagName) => `${flagName} carries a quoted-reply boundary marker (a pasted gmail_quote container, an Outlook divRplyFwdMsg / appendonsend / border-top separator, or a bold From: + Sent: header pair). It would be kept verbatim, and a later \`update-mail-draft --comment\` edit would cut the draft at that marker and lose the real quoted history below it. Remove the pasted quote from your text, or pass --body-content-type Text to have it escaped into literal characters.`, insertCommentAboveQuote = (html, commentHtml) => {
   const at = findBodyInsertStart(html);
   return { html: `${html.slice(0, at)}${commentHtml}${html.slice(at)}`, boundaryFound: findQuoteBoundary(html) !== -1 };
 }, replaceCommentAboveQuote = (html, commentHtml) => {
@@ -21639,7 +21586,7 @@ var schema93, isUnsentDraft = (value) => typeof value === "object" && value !==
       type: "api_error",
       status: 500,
       code: "draft_body_unreadable",
-      message: `Draft ${draftId} was created but its body could not be read back, so the comment was never written into it. The draft exists - review it in Outlook Drafts, or set its body with \`update-mail-draft --message-id ${draftId} --body-content ...\`.`
+      message: `Draft ${draftId} was created but its body could not be read back, so the comment was never written into it. The draft exists - review it in Outlook Drafts, or revise it with \`update-mail-draft --message-id ${draftId}\` in comment mode (see \`ask-marcel-office docs update-mail-draft\`).`
     });
   }
   return ok(parsed.data.body);
@@ -21650,13 +21597,13 @@ var schema93, isUnsentDraft = (value) => typeof value === "object" && value !==
       type: "validation_error",
       message: formatZodError(parsed.error)
     });
-  const { forwardMessageId, toRecipients, ccRecipients, bodyContent, subject, bodyContentType } = parsed.data;
+  const { forwardMessageId, toRecipients, ccRecipients, comment, subject, bodyContentType } = parsed.data;
   const asHtml = bodyContentType === "HTML";
-  if (asHtml && commentCarriesQuoteBoundary(bodyContent)) {
-    return err({ type: "validation_error", message: boundaryMarkerRefusal("--body-content") });
+  if (asHtml && commentCarriesQuoteBoundary(comment)) {
+    return err({ type: "validation_error", message: boundaryMarkerRefusal("--comment") });
   }
   const created = await graph.post(`/me/messages/${forwardMessageId}/createForward`, {
-    comment: asHtml ? "" : bodyContent,
+    comment: asHtml ? "" : comment,
     toRecipients: parseRecipients2(toRecipients)
   });
   if (!created.ok)
@@ -21686,10 +21633,10 @@ var schema93, isUnsentDraft = (value) => typeof value === "object" && value !==
   if (draftBody.value.contentType.toLowerCase() !== "html") {
     return err({
       type: "validation_error",
-      message: `The forwarded draft's body is ${draftBody.value.contentType}, not HTML, so HTML cannot be placed above the quoted original without rewriting it. Draft ${draftId} was already created - set its text with \`update-mail-draft --message-id ${draftId} --comment "..."\`, or delete it in Outlook Drafts and retry without --body-content-type HTML.`
+      message: `The forwarded draft's body is ${draftBody.value.contentType}, not HTML, so HTML cannot be placed above the quoted original without rewriting it. Draft ${draftId} was already created - revise it with \`update-mail-draft --message-id ${draftId}\` in comment mode, or delete it in Outlook Drafts and retry without --body-content-type HTML.`
     });
   }
-  const spliced = insertCommentAboveQuote(draftBody.value.content, bodyContent);
+  const spliced = insertCommentAboveQuote(draftBody.value.content, comment);
   const patch = { body: { contentType: "HTML", content: spliced.html } };
   if (ccRecipients)
     patch.ccRecipients = parseRecipients2(ccRecipients);
@@ -21707,7 +21654,7 @@ var init_create_forward_draft = __esm(() => {
     forwardMessageId: exports_external.string().min(1),
     toRecipients: exports_external.string().min(1),
     ccRecipients: exports_external.string().optional(),
-    bodyContent: exports_external.string().min(1),
+    comment: exports_external.string().min(1),
     subject: exports_external.string().optional(),
     bodyContentType: exports_external.enum(["Text", "HTML"]).optional()
   });
@@ -21723,8 +21670,7 @@ var init_create_forward_draft = __esm(() => {
         name: "forward-message-id",
         key: "forwardMessageId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
-        description: "The message being forwarded. Source from list-mail-folder-messages or search-mail-messages. Accepts `--id` as an alias.",
+        description: "The message being forwarded. Source from list-mail-folder-messages or search-mail-messages.",
         argumentHint: { kind: "idOrName" }
       },
       {
@@ -21740,10 +21686,10 @@ var init_create_forward_draft = __esm(() => {
         description: "Comma-separated list of CC recipient email addresses."
       },
       {
-        name: "body-content",
-        key: "bodyContent",
+        name: "comment",
+        key: "comment",
         required: true,
-        description: "The comment text, placed above the quoted forwarded message. Plain text by default; pass --body-content-type HTML to send it as markup."
+        description: "The comment text, placed above the quoted forwarded message. Named for Graph's own createForward payload field, and the same word update-mail-draft uses for the same role. Plain text by default; pass --body-content-type HTML to send it as markup."
       },
       {
         name: "subject",
@@ -21755,12 +21701,12 @@ var init_create_forward_draft = __esm(() => {
         name: "body-content-type",
         key: "bodyContentType",
         required: false,
-        description: "Format of --body-content: Text (default) or HTML. Text is handed to Graph as the forward comment, which HTML-escapes it, so markup shows as literal characters. HTML instead creates the draft with an empty comment and splices your markup in at the TOP of the body — above Graph's separator (the `<hr>` line) and the forwarded original, so your comment leads the body content — leaving the original and its styles byte-identical. Rejected when your markup itself contains a quote boundary marker (a pasted reply chain), and when the original is a plain-text message.",
+        description: "Format of --comment: Text (default) or HTML. Text is handed to Graph as the forward comment, which HTML-escapes it, so markup shows as literal characters. HTML instead creates the draft with an empty comment and splices your markup in at the TOP of the body — above Graph's separator (the `<hr>` line) and the forwarded original, so your comment leads the body content — leaving the original and its styles byte-identical. Rejected when your markup itself contains a quote boundary marker (a pasted reply chain), and when the original is a plain-text message.",
         argumentHint: { kind: "magicValue", values: ["Text", "HTML"] }
       }
     ],
-    example: 'ask-marcel-office create-forward-draft --forward-message-id "AAMkAD..." --to-recipients "bob@example.com" --body-content "Bob owns this now, forwarding for your action."',
-    bodyTemplate: "Text: POST { comment: '{body-content}', toRecipients: '{to-recipients}' } then optional PATCH { ccRecipients?: '{cc-recipients}', subject?: '{subject}' }. HTML ({body-content-type}): POST { comment: '', toRecipients: '{to-recipients}' } then ONE PATCH { body: { contentType: 'HTML', content: <'{body-content}' spliced at the top of the body, above Graph's <hr> separator and the quote> }, ccRecipients?: '{cc-recipients}', subject?: '{subject}' }",
+    example: 'ask-marcel-office create-forward-draft --forward-message-id "AAMkAD..." --to-recipients "bob@example.com" --comment "Bob owns this now, forwarding for your action."',
+    bodyTemplate: "Text: POST { comment: '{comment}', toRecipients: '{to-recipients}' } then optional PATCH { ccRecipients?: '{cc-recipients}', subject?: '{subject}' }. HTML ({body-content-type}): POST { comment: '', toRecipients: '{to-recipients}' } then ONE PATCH { body: { contentType: 'HTML', content: <'{comment}' spliced at the top of the body, above Graph's <hr> separator and the quote> }, ccRecipients?: '{cc-recipients}', subject?: '{subject}' }",
     mutates: true,
     scopesRequired: ["Mail.ReadWrite"],
     responseShape: "A confirmation of the write, NOT the whole message: `{ id, subject, toRecipients, ccRecipients, bccRecipients, importance, bodyPreview, isDraft, webLink, conversationId }` (only the fields Graph returned; `{ ok: true }` when Graph answers 204). The `body` is deliberately omitted — you just wrote it, and echoing a long thread's quoted history back cost ~174 KB of context per call. Read the full body with `get-mail-message --id <the returned id>` when you actually need it; `bodyPreview` is Graph's ~255-char summary, enough to confirm WHICH draft answered. The `id` is the draft — refine it with `update-mail-draft`, or open Outlook Drafts to review and send. Dedup caveat: a `conversationId` `$filter` on the Drafts folder is not a reliable 'does a draft already exist on this thread' check. Reply and forward drafts do not always inherit the inbound message's `conversationId` (one thread can split across several), and Graph `$filter` on Drafts is not read-your-writes consistent, so a just-created draft can be missed. To find existing drafts, use the `find-mail-drafts` command, which scans recent drafts and matches client-side on subject and recipients; to revise a draft this session created, reuse the returned `id`."
@@ -21898,7 +21844,7 @@ var schema95, isUnsentDraft2 = (value) => typeof value === "object" && value !==
       type: "api_error",
       status: 500,
       code: "draft_body_unreadable",
-      message: `Draft ${draftId} was created but its body could not be read back, so the reply text was never written into it. The draft exists - review it in Outlook Drafts, or set its body with \`update-mail-draft --message-id ${draftId} --body-content ...\`.`
+      message: `Draft ${draftId} was created but its body could not be read back, so the reply text was never written into it. The draft exists - review it in Outlook Drafts, or revise it with \`update-mail-draft --message-id ${draftId}\` in comment mode (see \`ask-marcel-office docs update-mail-draft\`).`
     });
   }
   return ok(parsed.data.body);
@@ -21906,13 +21852,13 @@ var schema95, isUnsentDraft2 = (value) => typeof value === "object" && value !==
   const parsed = schema95.safeParse(params);
   if (!parsed.success)
     return err({ type: "validation_error", message: formatZodError(parsed.error) });
-  const { replyToMessageId, bodyContent, subject, replyAll, bodyContentType } = parsed.data;
+  const { replyToMessageId, comment, subject, replyAll, bodyContentType } = parsed.data;
   const action = replyAll === "false" ? "createReply" : "createReplyAll";
   const asHtml = bodyContentType === "HTML";
-  if (asHtml && commentCarriesQuoteBoundary(bodyContent)) {
-    return err({ type: "validation_error", message: boundaryMarkerRefusal("--body-content") });
+  if (asHtml && commentCarriesQuoteBoundary(comment)) {
+    return err({ type: "validation_error", message: boundaryMarkerRefusal("--comment") });
   }
-  const created = await graph.post(`/me/messages/${replyToMessageId}/${action}`, { comment: asHtml ? "" : bodyContent });
+  const created = await graph.post(`/me/messages/${replyToMessageId}/${action}`, { comment: asHtml ? "" : comment });
   if (!created.ok)
     return created;
   if (!isUnsentDraft2(created.value)) {
@@ -21938,10 +21884,10 @@ var schema95, isUnsentDraft2 = (value) => typeof value === "object" && value !==
   if (draftBody.value.contentType.toLowerCase() !== "html") {
     return err({
       type: "validation_error",
-      message: `The thread's draft body is ${draftBody.value.contentType}, not HTML, so HTML cannot be placed above its quoted history without rewriting the quote. Draft ${draftId} was already created - reply to it with \`update-mail-draft --message-id ${draftId} --comment "..."\`, or delete it in Outlook Drafts and retry without --body-content-type HTML.`
+      message: `The thread's draft body is ${draftBody.value.contentType}, not HTML, so HTML cannot be placed above its quoted history without rewriting the quote. Draft ${draftId} was already created - revise it with \`update-mail-draft --message-id ${draftId}\` in comment mode, or delete it in Outlook Drafts and retry without --body-content-type HTML.`
     });
   }
-  const spliced = insertCommentAboveQuote(draftBody.value.content, bodyContent);
+  const spliced = insertCommentAboveQuote(draftBody.value.content, comment);
   const patch = { body: { contentType: "HTML", content: spliced.html } };
   if (subject)
     patch.subject = subject;
@@ -21954,7 +21900,7 @@ var init_create_reply_draft = __esm(() => {
   init_format_zod_error();
   schema95 = exports_external.object({
     replyToMessageId: exports_external.string().min(1),
-    bodyContent: exports_external.string().min(1),
+    comment: exports_external.string().min(1),
     subject: exports_external.string().optional(),
     replyAll: exports_external.enum(["true", "false"]).optional(),
     bodyContentType: exports_external.enum(["Text", "HTML"]).optional()
@@ -21971,21 +21917,20 @@ var init_create_reply_draft = __esm(() => {
         name: "reply-to-message-id",
         key: "replyToMessageId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
-        description: "The message being replied to. Source from list-mail-folder-messages or search-mail-messages. Accepts `--id` as an alias.",
+        description: "The message being replied to. Source from list-mail-folder-messages or search-mail-messages.",
         argumentHint: { kind: "idOrName" }
       },
       {
-        name: "body-content",
-        key: "bodyContent",
+        name: "comment",
+        key: "comment",
         required: true,
-        description: "The reply text, placed above the quoted history. Plain text by default; pass --body-content-type HTML to send it as markup."
+        description: "The reply text, placed above the quoted history. Named for Graph's own createReply payload field, and the same word update-mail-draft uses for the same role. Plain text by default; pass --body-content-type HTML to send it as markup."
       },
       {
         name: "body-content-type",
         key: "bodyContentType",
         required: false,
-        description: "Format of --body-content: Text (default) or HTML. Text is handed to Graph as the reply comment, which HTML-escapes it, so markup shows as literal characters. HTML instead creates the draft with an empty comment and splices your markup in at the TOP of the body — above Graph's reply separator (the `<hr>` line) and the quoted thread, so your reply leads the body content — leaving the quoted thread and its styles byte-identical. Rejected when your markup itself contains a quote boundary marker (a pasted reply chain), and when the thread is a plain-text one.",
+        description: "Format of --comment: Text (default) or HTML. Text is handed to Graph as the reply comment, which HTML-escapes it, so markup shows as literal characters. HTML instead creates the draft with an empty comment and splices your markup in at the TOP of the body — above Graph's reply separator (the `<hr>` line) and the quoted thread, so your reply leads the body content — leaving the quoted thread and its styles byte-identical. Rejected when your markup itself contains a quote boundary marker (a pasted reply chain), and when the thread is a plain-text one.",
         argumentHint: { kind: "magicValue", values: ["Text", "HTML"] }
       },
       {
@@ -22002,8 +21947,8 @@ var init_create_reply_draft = __esm(() => {
         argumentHint: { kind: "magicValue", values: ["true", "false"] }
       }
     ],
-    example: 'ask-marcel-office create-reply-draft --reply-to-message-id "AAMkAD..." --body-content "Confirmed for Contoso, aligned with the group choice."',
-    bodyTemplate: "Text: POST { comment: '{body-content}' } then optional PATCH { subject?: '{subject}' }. HTML ({body-content-type}): POST { comment: '' } then ONE PATCH { body: { contentType: 'HTML', content: <'{body-content}' spliced at the top of the body, above Graph's <hr> separator and the quote> }, subject?: '{subject}' }",
+    example: 'ask-marcel-office create-reply-draft --reply-to-message-id "AAMkAD..." --comment "Confirmed for Contoso, aligned with the group choice."',
+    bodyTemplate: "Text: POST { comment: '{comment}' } then optional PATCH { subject?: '{subject}' }. HTML ({body-content-type}): POST { comment: '' } then ONE PATCH { body: { contentType: 'HTML', content: <'{comment}' spliced at the top of the body, above Graph's <hr> separator and the quote> }, subject?: '{subject}' }",
     mutates: true,
     scopesRequired: ["Mail.ReadWrite"],
     responseShape: "A confirmation of the write, NOT the whole message: `{ id, subject, toRecipients, ccRecipients, bccRecipients, importance, bodyPreview, isDraft, webLink, conversationId }` (only the fields Graph returned; `{ ok: true }` when Graph answers 204). The `body` is deliberately omitted — you just wrote it, and echoing a long thread's quoted history back cost ~174 KB of context per call. Read the full body with `get-mail-message --id <the returned id>` when you actually need it; `bodyPreview` is Graph's ~255-char summary, enough to confirm WHICH draft answered. The `id` is the draft — refine it with `update-mail-draft`, or open Outlook Drafts to review and send. Dedup caveat: a `conversationId` `$filter` on the Drafts folder is not a reliable 'does a draft already exist on this thread' check. Reply and forward drafts do not always inherit the inbound message's `conversationId` (one thread can split across several), and Graph `$filter` on Drafts is not read-your-writes consistent, so a just-created draft can be missed. To find existing drafts, use the `find-mail-drafts` command, which scans recent drafts and matches client-side on subject and recipients; to revise a draft this session created, reuse the returned `id`."
@@ -22020,6 +21965,9 @@ __export(exports_update_mail_draft, {
 var schema96, draftSchema2, noQuoteRefusal = (messageId) => ({
   type: "validation_error",
   message: `Draft ${messageId} has no quoted reply history to preserve, so there is nothing for --comment to sit above. Use --body-content to replace the whole body instead.`
+}), quotedHistoryRefusal = (messageId) => ({
+  type: "validation_error",
+  message: `Draft ${messageId} carries quoted reply history, and --body-content replaces the entire body, quote included. Revise only your own text with --comment, which keeps the quote byte-identical, or pass --replace-quoted-history true to drop the quote deliberately.`
 }), reviseBodyAboveQuote = (draft, messageId, comment, asHtml) => {
   if (draft.contentType.toLowerCase() !== "html") {
     if (asHtml) {
@@ -22052,11 +22000,18 @@ var schema96, draftSchema2, noQuoteRefusal = (messageId) => ({
     return err({ type: "validation_error", message: `Message ${messageId} is not a draft, so its body cannot be revised. Only unsent drafts can be updated.` });
   }
   return ok(parsed.data);
+}, guardQuotedHistory = async (graph, messageId) => {
+  const draft = await readDraft(graph, messageId);
+  if (!draft.ok)
+    return draft;
+  if (!bodyCarriesQuote(draft.value.body.contentType, draft.value.body.content))
+    return ok(undefined);
+  return err(quotedHistoryRefusal(messageId));
 }, execute96 = async (graph, params) => {
   const parsed = schema96.safeParse(params);
   if (!parsed.success)
     return err({ type: "validation_error", message: formatZodError(parsed.error) });
-  const { messageId, subject, bodyContent, comment, bodyContentType, toRecipients, ccRecipients, bccRecipients, importance } = parsed.data;
+  const { messageId, subject, bodyContent, comment, replaceQuotedHistory, bodyContentType, toRecipients, ccRecipients, bccRecipients, importance } = parsed.data;
   if ([subject, bodyContent, comment, toRecipients, ccRecipients, bccRecipients, importance].every((v) => v === undefined)) {
     return err({
       type: "validation_error",
@@ -22072,6 +22027,11 @@ var schema96, draftSchema2, noQuoteRefusal = (messageId) => ({
   if (comment !== undefined && bodyContentType === "HTML" && commentCarriesQuoteBoundary(comment)) {
     return err({ type: "validation_error", message: boundaryMarkerRefusal("--comment") });
   }
+  if (bodyContent !== undefined && replaceQuotedHistory !== "true") {
+    const guarded = await guardQuotedHistory(graph, messageId);
+    if (!guarded.ok)
+      return guarded;
+  }
   const body = {};
   if (subject !== undefined)
     body.subject = subject;
@@ -22107,6 +22067,7 @@ var init_update_mail_draft = __esm(() => {
     subject: exports_external.string().optional(),
     bodyContent: exports_external.string().optional(),
     comment: exports_external.string().min(1).optional(),
+    replaceQuotedHistory: exports_external.enum(["true", "false"]).optional(),
     bodyContentType: exports_external.enum(["Text", "HTML"]).optional(),
     toRecipients: exports_external.string().optional(),
     ccRecipients: exports_external.string().optional(),
@@ -22115,18 +22076,17 @@ var init_update_mail_draft = __esm(() => {
   });
   draftSchema2 = exports_external.object({ isDraft: exports_external.boolean(), body: exports_external.object({ contentType: exports_external.string(), content: exports_external.string() }) });
   meta98 = {
-    summary: "Update an existing mail draft. PATCH /me/messages/{id} — modifies a draft created by create-mail-draft (or any existing draft in the Drafts folder). Only the fields you pass are updated; omitted fields are left unchanged. At least one field must be provided. On a THREADED draft (one made by create-reply-draft / create-forward-draft), revise your text with --comment, which rewrites only what sits above the quoted history and leaves the quote byte-identical; --body-content would replace the whole body and drop the thread. Passing an EMPTY string to a recipient flag clears that list, which is how you drop recipients a reply-all or forward inherited; omitting the flag leaves the list alone. Returns a slim confirmation (id, subject, recipients, importance, bodyPreview, …) - NOT the full body, which you just wrote; read it back with get-mail-message if you need the whole draft before sending.",
+    summary: "Update an existing mail draft. PATCH /me/messages/{id} — modifies a draft created by create-mail-draft (or any existing draft in the Drafts folder). Only the fields you pass are updated; omitted fields are left unchanged. At least one field must be provided. On a THREADED draft (one made by create-reply-draft / create-forward-draft), revise your text with --comment, which rewrites only what sits above the quoted history and leaves the quote byte-identical; --body-content replaces the whole body and would drop the thread, so it is REFUSED on a draft that still carries a quote unless you pass --replace-quoted-history true. Passing an EMPTY string to a recipient flag clears that list, which is how you drop recipients a reply-all or forward inherited; omitting the flag leaves the list alone. Returns a slim confirmation (id, subject, recipients, importance, bodyPreview, …) - NOT the full body, which you just wrote; read it back with get-mail-message if you need the whole draft before sending.",
     category: "mail",
     graphMethod: "PATCH",
-    graphPathTemplate: "/me/messages/{message-id} (+ a GET of body,isDraft first when {comment} is used)",
+    graphPathTemplate: "/me/messages/{message-id} (+ a GET of body,isDraft first when {comment} is used, or when {body-content} is used without {replace-quoted-history})",
     graphDocsUrl: "https://learn.microsoft.com/en-us/graph/api/message-update",
     options: [
       {
         name: "message-id",
         key: "messageId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
-        description: "Draft message ID to update. Source from create-mail-draft response or list-mail-folder-messages --mail-folder-id drafts. Accepts `--id` as an alias.",
+        description: "Draft message ID to update. Source from create-mail-draft response or list-mail-folder-messages --mail-folder-id drafts.",
         argumentHint: { kind: "idOrName" }
       },
       {
@@ -22139,7 +22099,7 @@ var init_update_mail_draft = __esm(() => {
         name: "body-content",
         key: "bodyContent",
         required: false,
-        description: "New email body content. Replaces the ENTIRE body, quoted history included. On a threaded reply or forward draft this is almost never what you want - use --comment to revise only your own text and keep the quote. Pass --body-content-type HTML for rich text. Mutually exclusive with --comment."
+        description: "New email body content. Replaces the ENTIRE body, quoted history included. On a threaded reply or forward draft that is almost never what you want, so the command reads the draft first and REFUSES when it still carries a quote - use --comment to revise only your own text and keep the quote, or pass --replace-quoted-history true to drop it deliberately. Note the sibling commands: create-reply-draft / create-forward-draft name their above-the-quote text --comment; --body-content exists only here. Pass --body-content-type HTML for rich text. Mutually exclusive with --comment."
       },
       {
         name: "comment",
@@ -22147,6 +22107,13 @@ var init_update_mail_draft = __esm(() => {
         required: false,
         description: "Rewrite ONLY the reply text above the quoted history on a threaded draft, keeping the quote and its styles byte-identical. This is the flag for revising a draft made by create-reply-draft or create-forward-draft; repeated edits replace your text rather than stacking. Refused when the draft has no quoted history (use --body-content), when it is not a draft, and when HTML markup you pass carries a quote boundary marker of its own. Mutually exclusive with --body-content."
       },
+      {
+        name: "replace-quoted-history",
+        key: "replaceQuotedHistory",
+        required: false,
+        description: "Allow --body-content to drop the quoted history on a threaded draft. Without it, --body-content is REFUSED when the draft still carries a quote, because replacing the whole body there silently loses the thread; the refusal points at --comment, which revises only your own text. Pass `true` for the deliberate case: strip the quote but keep the draft threaded on its conversation. Ignored in comment mode, which never touches the quote.",
+        argumentHint: { kind: "magicValue", values: ["true", "false"] }
+      },
       {
         name: "body-content-type",
         key: "bodyContentType",
@@ -22181,7 +22148,7 @@ var init_update_mail_draft = __esm(() => {
       }
     ],
     example: 'ask-marcel-office update-mail-draft --message-id "AAMkAD..." --subject "Updated: Q3 Report" --to-recipients "alice@example.com,charlie@example.com"',
-    bodyTemplate: "{ subject?: '{subject}', body?: { contentType: '{body-content-type}', content: '{body-content}' }, toRecipients?: '{to-recipients}', ccRecipients?: '{cc-recipients}', bccRecipients?: '{bcc-recipients}', importance?: '{importance}' } — only provided fields are sent. With '{comment}': body.content is the draft's own body with the text above the quote replaced, and body.contentType is the draft's own, unchanged",
+    bodyTemplate: "{ subject?: '{subject}', body?: { contentType: '{body-content-type}', content: '{body-content}' }, toRecipients?: '{to-recipients}', ccRecipients?: '{cc-recipients}', bccRecipients?: '{bcc-recipients}', importance?: '{importance}' } — only provided fields are sent. With '{comment}': body.content is the draft's own body with the text above the quote replaced, and body.contentType is the draft's own, unchanged. A '{body-content}' aimed at a draft that still carries a quote costs one GET of body,isDraft and is refused unless '{replace-quoted-history}' is true",
     mutates: true,
     scopesRequired: ["Mail.ReadWrite"],
     responseShape: "A confirmation of the write, NOT the whole message: `{ id, subject, toRecipients, ccRecipients, bccRecipients, importance, bodyPreview, isDraft, webLink, conversationId }` (only the fields Graph returned; `{ ok: true }` when Graph answers 204). The `body` is deliberately omitted — you just wrote it, and echoing a long thread's quoted history back cost ~174 KB of context per call. Read the full body with `get-mail-message --id <the returned id>` when you actually need it; `bodyPreview` is Graph's ~255-char summary, enough to confirm WHICH draft answered. The `id` is the draft — refine it with `update-mail-draft`, or open Outlook Drafts to review and send. Dedup caveat: a `conversationId` `$filter` on the Drafts folder is not a reliable 'does a draft already exist on this thread' check. Reply and forward drafts do not always inherit the inbound message's `conversationId` (one thread can split across several), and Graph `$filter` on Drafts is not read-your-writes consistent, so a just-created draft can be missed. To find existing drafts, use the `find-mail-drafts` command, which scans recent drafts and matches client-side on subject and recipients; to revise a draft this session created, reuse the returned `id`."
@@ -22227,7 +22194,6 @@ var init_convert_drive_item_zip_to_markdown = __esm(() => {
   meta99 = {
     summary: "Unzip a `.zip` from a OneDrive / SharePoint item and convert every contained file in one call — so \"read the handover archive\" doesn't need a separate unzip + per-file conversion. Office files (docx/xlsx/pptx/odt/ods/odp and their macro-enabled / template variants) are converted to markdown via the local pipelines; plain-text entries (txt/md/csv/json/yaml/…) are decoded inline; legacy OLE .xls (sheetjs) and .doc (word-extractor, text only) are extracted; an Outlook .msg entry is rendered to markdown (headers + body, with its own attachments converted recursively); PDFs have their text layer extracted (text/plain); images, binaries, nested archives, legacy .ppt, and scanned/image-only PDFs (no text layer) are listed with a note (not unpacked) so one unsupported entry never fails the whole archive. Pass `--include-metadata true` to append each Office file's side-channel metadata block. Capped at 100 entries (the archive is buffered in memory); beyond that the response is flagged `truncated`.",
     category: "drive",
-    commandAliases: ["convert-drive-item-zip"],
     graphMethod: "GET",
     graphPathTemplate: "/drives/{drive-id}/items/{item-id}/content",
     graphDocsUrl: "https://learn.microsoft.com/en-us/graph/api/driveitem-get-content",
@@ -22312,7 +22278,6 @@ var init_convert_local_file_to_markdown = __esm(() => {
   meta100 = {
     summary: "Convert a file ON DISK to markdown — the only command that never calls Microsoft Graph (works offline, no login). Runs the same local pipelines as `download-drive-item-as-markdown`: docx (mammoth → turndown), xlsx (sheetjs tables, `--max-cells` OOM cap), pptx (per-slide text), odt/ods/odp, csv, pdf (text layer via unpdf), legacy OLE .xls / .doc, Outlook .msg (headers + body with the quoted reply chain stripped — `--keep-quoted true` restores it — and inline `cid:` images shown as placeholders, attachments converted recursively), plain-text passthrough — and a `.zip` is unpacked with every contained file converted in one call (legacy GBK / CP437 entry names decoded, not mojibaked). What it canNOT do locally: convert TO pdf, and Loop/Fluid/Whiteboard sources — both need a Graph server round-trip (upload to OneDrive and use the drive-item siblings). Pass `--include-metadata true` for the Office side-channel metadata blocks; `--inline-images true` to embed docx images as base64 data URIs.",
     category: "meta",
-    commandAliases: ["convert-local-file"],
     graphMethod: "GET",
     graphPathTemplate: "(local) reads {path} from the local filesystem; not a Graph endpoint",
     graphDocsUrl: "https://learn.microsoft.com/en-us/graph/",
@@ -22455,7 +22420,6 @@ var init_convert_mail_attachment_zip_to_markdown = __esm(() => {
   meta102 = {
     summary: "Unzip a `.zip` Outlook mail attachment and convert every contained file in one call — the mail-side mirror of `convert-drive-item-zip-to-markdown`, so reading a zipped vendor deck doesn't need `get-mail-attachment` + manual `unzip` + per-file conversion. Pulls the fileAttachment bytes, unzips them (legacy GBK / CP437 entry names — Chinese vendor archives written by WinRAR / Windows Explorer — are decoded correctly, not mojibaked), and runs each file through the local pipelines: Office files (docx/xlsx/pptx/odt/ods/odp and macro-enabled / template variants) → markdown; plain-text entries decoded inline; legacy OLE .xls (sheetjs) and .doc (word-extractor, text only) extracted; an inner Outlook .msg rendered; PDFs have their text layer extracted; images, binaries, nested archives, legacy .ppt, and scanned/image-only PDFs are listed with a note (not unpacked) so one unsupported entry never fails the whole archive. Pass `--include-metadata true` to append each Office file's side-channel metadata block. Capped at 100 entries; beyond that the response is flagged `truncated`. itemAttachment / referenceAttachment are rejected (no inline zip payload).",
     category: "mail",
-    commandAliases: ["convert-mail-attachment-zip"],
     graphMethod: "GET",
     graphPathTemplate: "/me/messages/{message-id}/attachments/{attachment-id}",
     graphDocsUrl: "https://learn.microsoft.com/en-us/graph/api/attachment-get",
@@ -22581,8 +22545,7 @@ var init_extract_sharepoint_links_in_mail = __esm(() => {
         name: "message-id",
         key: "messageId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
-        description: "Outlook message ID. Returned by `list-mail-messages` or `list-mail-folder-messages`. Accepts `--id` as an alias."
+        description: "Outlook message ID. Returned by `list-mail-messages` or `list-mail-folder-messages`."
       }
     ],
     example: "ask-marcel-office extract-sharepoint-links-in-mail --message-id 'AAMkADk0...'",
@@ -22644,7 +22607,6 @@ var init_get_chat = __esm(() => {
         name: "chat-id",
         key: "chatId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Microsoft Teams chat ID, e.g. `19:abc...@thread.v2`. Returned by `list-chats`."
       },
       ...selectExpandOptions
@@ -22738,7 +22700,6 @@ var init_list_teams_chat_messages = __esm(() => {
         name: "chat-id",
         key: "chatId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Teams chat ID — typically `19:<thread>@unq.gbl.spaces` (1:1) or `19:<thread>@thread.v2` (group). Source via `list-chats` or `list-teams-chats-with-messages`."
       }
     ],
@@ -22837,7 +22798,6 @@ var init_list_teams_chat_history = __esm(() => {
         name: "chat-id",
         key: "chatId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Teams chat ID — typically `19:<thread>@unq.gbl.spaces` (1:1) or `19:<thread>@thread.v2` (group). Source via `list-chats` or `list-teams-chats-with-messages`."
       },
       {
@@ -23558,7 +23518,6 @@ var init_list_user_direct_reports = __esm(() => {
         name: "user-id",
         key: "userId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Azure AD user ID or userPrincipalName (UPN) — typically the user's email address. Discover via `list-relevant-people` (relevance-ranked colleagues) or `microsoft-search-query --query <name>` (federated person search across the tenant directory)."
       },
       ...odataQueryOptions
@@ -23873,7 +23832,6 @@ var init_list_team_installed_apps = __esm(() => {
         name: "team-id",
         key: "teamId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Microsoft Teams team ID."
       }
     ],
@@ -23935,7 +23893,6 @@ var init_list_calendar_group_calendars = __esm(() => {
         name: "calendar-group-id",
         key: "calendarGroupId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Calendar group ID. Returned by `list-calendar-groups`."
       },
       ...odataQueryOptions
@@ -23997,7 +23954,6 @@ var init_list_site_columns = __esm(() => {
         name: "site-id",
         key: "siteId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "SharePoint site ID. Returned by `search-sharepoint-sites-by-name`."
       },
       ...selectExpandOptions
@@ -24032,7 +23988,6 @@ var init_list_site_content_types = __esm(() => {
         name: "site-id",
         key: "siteId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "SharePoint site ID."
       },
       ...noSkipOptions
@@ -24069,7 +24024,6 @@ var init_list_sharepoint_site_pages = __esm(() => {
         name: "site-id",
         key: "siteId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "SharePoint site ID."
       },
       ...noSkipOptions
@@ -24372,15 +24326,15 @@ var init_get_drive_root_delta = __esm(() => {
   init_zod();
   init_build_command();
   init_odata_query();
-  baseSchema67 = exports_external.object({}).strict();
-  ({ execute: execute138, schema: schema138 } = buildNoSkipListCommand(() => "/me/drive/root/delta()", baseSchema67));
+  baseSchema67 = exports_external.object({});
+  ({ execute: execute138, schema: schema138 } = buildPickODataListCommand(() => "/me/drive/root/delta()", baseSchema67, ["top", "select", "expand"]));
   meta140 = {
     summary: "Track incremental changes (added / modified / deleted items) anywhere under the signed-in user's OneDrive root. **Takes zero required arguments** — acts implicitly on the signed-in user's primary OneDrive; use `get-drive-delta` to target a specific drive by ID. The first call returns a snapshot plus `@odata.deltaLink`; subsequent calls with that link return only what has changed since. Cross-folder companion to `get-drive-delta` (which scopes to one specific folder).",
     category: "drive",
     graphMethod: "GET",
     graphPathTemplate: "/me/drive/root/delta()",
     graphDocsUrl: "https://learn.microsoft.com/en-us/graph/api/driveitem-delta",
-    options: [...noSkipOptions],
+    options: [...pickODataOptions(["top", "select", "expand"])],
     example: "ask-marcel-office get-drive-root-delta",
     responseShape: "collection of Microsoft Graph `driveItem` resources under `data.value[]`. Cursor tokens are hoisted to envelope level: top-level `nextLink` while paging, then top-level `deltaLink` on the final page.",
     pagination: true,
@@ -24520,7 +24474,6 @@ var init_get_site_analytics = __esm(() => {
         name: "site-id",
         key: "siteId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "SharePoint site ID."
       }
     ],
@@ -24566,8 +24519,7 @@ var init_list_sharepoint_list_item_versions = __esm(() => {
         name: "list-item-id",
         key: "listItemId",
         required: true,
-        description: "List item ID inside the list. Returned by `list-sharepoint-site-list-items`.",
-        aliases: [{ name: "item-id", key: "itemId" }]
+        description: "List item ID inside the list. Returned by `list-sharepoint-site-list-items`."
       },
       ...noSkipOptions
     ],
@@ -24608,11 +24560,7 @@ var init_get_mail_rule = __esm(() => {
         name: "message-rule-id",
         key: "messageRuleId",
         required: true,
-        description: "Message rule ID. Returned by `list-mail-rules`.",
-        aliases: [
-          { name: "id", key: "id" },
-          { name: "rule-id", key: "ruleId" }
-        ]
+        description: "Message rule ID. Returned by `list-mail-rules`."
       }
     ],
     example: "ask-marcel-office get-mail-rule --message-rule-id 'AQAAANC...'",
@@ -24794,7 +24742,6 @@ var init_get_team_primary_channel = __esm(() => {
         name: "team-id",
         key: "teamId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Microsoft Teams team ID. Returned by `list-joined-teams`."
       },
       ...selectExpandOptions
@@ -24828,12 +24775,7 @@ var init_list_todo_tasks_delta = __esm(() => {
         name: "todo-task-list-id",
         key: "todoTaskListId",
         required: true,
-        description: "Microsoft To Do task list ID. Returned by `list-todo-task-lists`.",
-        aliases: [
-          { name: "id", key: "id" },
-          { name: "task-list-id", key: "taskListId" },
-          { name: "todo-list-id", key: "todoListId" }
-        ]
+        description: "Microsoft To Do task list ID. Returned by `list-todo-task-lists`."
       }
     ],
     example: "ask-marcel-office list-todo-tasks-delta --todo-task-list-id 'AAMkAD...'",
@@ -24968,7 +24910,6 @@ var init_get_user = __esm(() => {
         name: "user-id",
         key: "userId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Azure AD user ID, UPN, or email (returns the full profile via the elevated token), OR a display name (returns relevant-people candidates on the basic token). Discover ids via `list-relevant-people` or `microsoft-search-query`."
       },
       ...selectExpandOptions
@@ -25015,7 +24956,6 @@ var init_get_user_manager = __esm(() => {
         name: "user-id",
         key: "userId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Azure AD user ID or UPN — typically the user's email address. Discover via `list-relevant-people` (relevance-ranked colleagues) or `microsoft-search-query --query <name>` (federated person search across the tenant directory)."
       },
       ...selectExpandOptions
@@ -25105,7 +25045,6 @@ var init_get_group = __esm(() => {
         name: "group-id",
         key: "groupId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Azure AD group object ID. Use `list-groups` to find one."
       },
       ...selectExpandOptions
@@ -25140,7 +25079,6 @@ var init_list_group_members = __esm(() => {
         name: "group-id",
         key: "groupId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Azure AD group object ID. Use `list-groups` to find one."
       },
       ...odataQueryOptions
@@ -25176,7 +25114,6 @@ var init_list_group_owners = __esm(() => {
         name: "group-id",
         key: "groupId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Azure AD group object ID. Use `list-groups` to find one."
       },
       ...odataQueryOptions
@@ -25212,7 +25149,6 @@ var init_list_group_events = __esm(() => {
         name: "group-id",
         key: "groupId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Azure AD group object ID for a unified (Microsoft 365) group. Use `list-groups` to find one."
       },
       ...odataQueryOptions
@@ -25249,17 +25185,15 @@ var init_get_group_calendar_view = __esm(() => {
         name: "group-id",
         key: "groupId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Azure AD group object ID for a unified (Microsoft 365) group."
       },
       {
         name: "start-date-time",
         key: "startDateTime",
         required: true,
-        aliases: [{ name: "start", key: "start" }],
         description: `Start of the window (recurrences are expanded across it). ${RELATIVE_DATE_DESCRIPTION}`
       },
-      { name: "end-date-time", key: "endDateTime", required: true, aliases: [{ name: "end", key: "end" }], description: `End of the window. ${RELATIVE_DATE_DESCRIPTION}` },
+      { name: "end-date-time", key: "endDateTime", required: true, description: `End of the window. ${RELATIVE_DATE_DESCRIPTION}` },
       ...odataQueryOptions
     ],
     example: "ask-marcel-office list-group-calendar-view --group-id 'a1b2c3d4-...' --start-date-time '2026-04-01T00:00:00Z' --end-date-time '2026-05-01T00:00:00Z'",
@@ -25293,7 +25227,6 @@ var init_list_group_conversations = __esm(() => {
         name: "group-id",
         key: "groupId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Azure AD group object ID for a unified (Microsoft 365) group."
       },
       ...odataQueryOptions
@@ -25329,7 +25262,6 @@ var init_list_group_threads = __esm(() => {
         name: "group-id",
         key: "groupId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Azure AD group object ID for a unified (Microsoft 365) group."
       },
       ...odataQueryOptions
@@ -25369,8 +25301,7 @@ var init_get_mail_message_mime = __esm(() => {
         name: "message-id",
         key: "messageId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
-        description: "Outlook message ID. Returned by `list-mail-messages` or `search-mail-messages`. Accepts `--id` as an alias."
+        description: "Outlook message ID. Returned by `list-mail-messages` or `search-mail-messages`."
       }
     ],
     example: "ask-marcel-office get-mail-message-mime --message-id 'AAMkAD...'",
@@ -25386,15 +25317,23 @@ __export(exports_list_mail_folder_messages_delta, {
   meta: () => meta167,
   execute: () => execute165
 });
-var baseSchema87, execute165, schema165, meta167;
+var schema165, execute165 = async (graph, params) => {
+  const parsed = schema165.safeParse(params);
+  if (!parsed.success)
+    return err({ type: "validation_error", message: formatZodError(parsed.error) });
+  const { mailFolderId, top, ...odata } = parsed.data;
+  const headers = {};
+  if (top !== undefined)
+    headers["Prefer"] = `odata.maxpagesize=${top}`;
+  return graph.get(appendOData(`/me/mailFolders/${mailFolderId}/messages/delta()`, odata), headers);
+}, meta167;
 var init_list_mail_folder_messages_delta = __esm(() => {
   init_zod();
-  init_build_command();
+  init_format_zod_error();
   init_odata_query();
-  baseSchema87 = exports_external.object({ mailFolderId: exports_external.string().min(1) });
-  ({ execute: execute165, schema: schema165 } = buildListCommand((p) => `/me/mailFolders/${p.mailFolderId}/messages/delta()`, baseSchema87));
+  schema165 = exports_external.object({ mailFolderId: exports_external.string().min(1) }).extend(pickODataShape(["top", "select", "filter", "expand"]));
   meta167 = {
-    summary: "Track incremental changes (added / updated / deleted messages) within a single mail folder using Microsoft Graph delta tokens. The first call returns the current snapshot plus a `@odata.deltaLink`; subsequent calls with that link return only what has changed since.",
+    summary: 'Track incremental changes (added / updated / deleted messages) within a single mail folder using Microsoft Graph delta tokens. The first call returns the current snapshot plus a `@odata.deltaLink`; subsequent calls with that link return only what has changed since. `--top` is translated into the `Prefer: odata.maxpagesize=N` header: as a `$top` query parameter Graph reads a satisfied count as "sync complete" and hands back a deltaLink after N items, silently abandoning the rest of the folder. `$skip` and `$orderby` are NOT exposed — Graph ignores the former on this endpoint and rejects the latter unless it merely restates the default `receivedDateTime desc`.',
     category: "mail",
     graphMethod: "GET",
     graphPathTemplate: "/me/mailFolders/{mail-folder-id}/messages/delta()",
@@ -25404,15 +25343,14 @@ var init_list_mail_folder_messages_delta = __esm(() => {
         name: "mail-folder-id",
         key: "mailFolderId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Mail folder ID or well-known name (`inbox`, `archive`, `sentitems`, `deleteditems`, `junkemail`, `drafts`). Returned by `list-mail-folders`."
       },
-      ...odataQueryOptions
+      ...pickODataOptions(["top", "select", "filter", "expand"])
     ],
     example: "ask-marcel-office list-mail-folder-messages-delta --mail-folder-id 'inbox'",
-    responseShape: "collection of Microsoft Graph `message` resources under `data.value[]`. Cursor tokens are hoisted to envelope level: top-level `nextLink` while paging, then top-level `deltaLink` on the final page (CLI strips the original `@odata.*` keys from `data`).",
+    responseShape: "collection of Microsoft Graph `message` resources under `data.value[]`. Cursor tokens are hoisted to envelope level: top-level `nextLink` while paging, then top-level `deltaLink` on the final page (CLI strips the original `@odata.*` keys from `data`). A `deltaLink` on the FIRST page means the folder is fully synced, not that it was truncated.",
     pagination: true,
-    paginationStrategy: "deltaLink"
+    paginationStrategy: "preferMaxPageSize"
   };
 });
 
@@ -25423,13 +25361,13 @@ __export(exports_list_shared_mailbox_messages, {
   meta: () => meta168,
   execute: () => execute166
 });
-var baseSchema88, execute166, schema166, meta168;
+var baseSchema87, execute166, schema166, meta168;
 var init_list_shared_mailbox_messages = __esm(() => {
   init_zod();
   init_build_command();
   init_odata_query();
-  baseSchema88 = exports_external.object({ userId: exports_external.string().min(1) });
-  ({ execute: execute166, schema: schema166 } = buildListCommand((p) => `/users/${encodeURIComponent(p.userId)}/messages`, baseSchema88));
+  baseSchema87 = exports_external.object({ userId: exports_external.string().min(1) });
+  ({ execute: execute166, schema: schema166 } = buildListCommand((p) => `/users/${encodeURIComponent(p.userId)}/messages`, baseSchema87));
   meta168 = {
     summary: "List messages from a shared or delegated mailbox the signed-in user has read access to. Same shape as `list-mail-messages` but scoped to a specific mailbox owner. 403 if the signed-in user does not have shared access to that mailbox.",
     category: "mail",
@@ -25441,7 +25379,6 @@ var init_list_shared_mailbox_messages = __esm(() => {
         name: "user-id",
         key: "userId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Azure AD user ID or UPN of the shared mailbox or delegated user. The signed-in user must have `Mail.Read.Shared` access (granted by the mailbox owner)."
       },
       ...odataQueryOptions
@@ -25459,13 +25396,13 @@ __export(exports_list_shared_mailbox_folder_messages, {
   meta: () => meta169,
   execute: () => execute167
 });
-var baseSchema89, execute167, schema167, meta169;
+var baseSchema88, execute167, schema167, meta169;
 var init_list_shared_mailbox_folder_messages = __esm(() => {
   init_zod();
   init_build_command();
   init_odata_query();
-  baseSchema89 = exports_external.object({ userId: exports_external.string().min(1), mailFolderId: exports_external.string().min(1) });
-  ({ execute: execute167, schema: schema167 } = buildListCommand((p) => `/users/${encodeURIComponent(p.userId)}/mailFolders/${p.mailFolderId}/messages`, baseSchema89));
+  baseSchema88 = exports_external.object({ userId: exports_external.string().min(1), mailFolderId: exports_external.string().min(1) });
+  ({ execute: execute167, schema: schema167 } = buildListCommand((p) => `/users/${encodeURIComponent(p.userId)}/mailFolders/${p.mailFolderId}/messages`, baseSchema88));
   meta169 = {
     summary: "List messages in a single folder of a shared / delegated mailbox.",
     category: "mail",
@@ -25500,13 +25437,13 @@ __export(exports_get_shared_mailbox_message, {
   meta: () => meta170,
   execute: () => execute168
 });
-var baseSchema90, execute168, schema168, meta170;
+var baseSchema89, execute168, schema168, meta170;
 var init_get_shared_mailbox_message = __esm(() => {
   init_zod();
   init_build_command();
   init_odata_query();
-  baseSchema90 = exports_external.object({ userId: exports_external.string().min(1), messageId: exports_external.string().min(1) });
-  ({ execute: execute168, schema: schema168 } = buildSelectableCommand((p) => `/users/${encodeURIComponent(p.userId)}/messages/${p.messageId}`, baseSchema90));
+  baseSchema89 = exports_external.object({ userId: exports_external.string().min(1), messageId: exports_external.string().min(1) });
+  ({ execute: execute168, schema: schema168 } = buildSelectableCommand((p) => `/users/${encodeURIComponent(p.userId)}/messages/${p.messageId}`, baseSchema89));
   meta170 = {
     summary: "Return a single message from a shared / delegated mailbox. Use `--select` to fetch only specific fields (e.g. `--select id,subject,from,receivedDateTime`) — sibling to `get-mail-message` for /me.",
     category: "mail",
@@ -25565,7 +25502,6 @@ var init_list_conversation_messages = __esm(() => {
         name: "conversation-id",
         key: "conversationId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Outlook `conversationId` of any message in the thread (returned by every mail-listing command and by `get-mail-message`)."
       },
       ...allowedOptions
@@ -25583,13 +25519,13 @@ __export(exports_list_focused_inbox_overrides, {
   meta: () => meta172,
   execute: () => execute170
 });
-var baseSchema91, execute170, schema170, meta172;
+var baseSchema90, execute170, schema170, meta172;
 var init_list_focused_inbox_overrides = __esm(() => {
   init_zod();
   init_build_command();
   init_odata_query();
-  baseSchema91 = exports_external.object({}).strict();
-  ({ execute: execute170, schema: schema170 } = buildListCommand(() => "/me/inferenceClassification/overrides", baseSchema91));
+  baseSchema90 = exports_external.object({}).strict();
+  ({ execute: execute170, schema: schema170 } = buildListCommand(() => "/me/inferenceClassification/overrides", baseSchema90));
   meta172 = {
     summary: "List the signed-in user's Focused Inbox classification overrides — sender addresses they've manually moved to Focused or Other, which override Microsoft's automatic classifier.",
     category: "mail",
@@ -25635,13 +25571,13 @@ __export(exports_list_shared_calendar_events, {
   meta: () => meta174,
   execute: () => execute172
 });
-var baseSchema92, execute172, schema172, meta174;
+var baseSchema91, execute172, schema172, meta174;
 var init_list_shared_calendar_events = __esm(() => {
   init_zod();
   init_build_command();
   init_odata_query();
-  baseSchema92 = exports_external.object({ userId: exports_external.string().min(1) });
-  ({ execute: execute172, schema: schema172 } = buildListCommand((p) => `/users/${encodeURIComponent(p.userId)}/calendar/events`, baseSchema92));
+  baseSchema91 = exports_external.object({ userId: exports_external.string().min(1) });
+  ({ execute: execute172, schema: schema172 } = buildListCommand((p) => `/users/${encodeURIComponent(p.userId)}/calendar/events`, baseSchema91));
   meta174 = {
     summary: "List events from another user's primary calendar (shared / delegated access). 403 without `Calendars.Read.Shared`.",
     category: "calendar",
@@ -25653,7 +25589,6 @@ var init_list_shared_calendar_events = __esm(() => {
         name: "user-id",
         key: "userId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Azure AD user ID or UPN whose calendar to read. Requires `Calendars.Read.Shared` access (granted by the calendar owner)."
       },
       ...odataQueryOptions
@@ -25671,14 +25606,14 @@ __export(exports_get_shared_calendar_view, {
   meta: () => meta175,
   execute: () => execute173
 });
-var baseSchema93, execute173, schema173, meta175;
+var baseSchema92, execute173, schema173, meta175;
 var init_get_shared_calendar_view = __esm(() => {
   init_zod();
   init_build_command();
   init_iso_datetime_schema();
   init_odata_query();
-  baseSchema93 = exports_external.object({ userId: exports_external.string().min(1), startDateTime: isoDateTimeField, endDateTime: isoDateTimeField });
-  ({ execute: execute173, schema: schema173 } = buildListCommand((p) => `/users/${encodeURIComponent(p.userId)}/calendarView?startDateTime=${encodeURIComponent(p.startDateTime)}&endDateTime=${encodeURIComponent(p.endDateTime)}`, baseSchema93));
+  baseSchema92 = exports_external.object({ userId: exports_external.string().min(1), startDateTime: isoDateTimeField, endDateTime: isoDateTimeField });
+  ({ execute: execute173, schema: schema173 } = buildListCommand((p) => `/users/${encodeURIComponent(p.userId)}/calendarView?startDateTime=${encodeURIComponent(p.startDateTime)}&endDateTime=${encodeURIComponent(p.endDateTime)}`, baseSchema92));
   meta175 = {
     summary: "Return a date-windowed calendar view from another user's primary calendar (shared / delegated access). Recurrences expanded into individual occurrences.",
     category: "calendar",
@@ -25690,11 +25625,10 @@ var init_get_shared_calendar_view = __esm(() => {
         name: "user-id",
         key: "userId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "Azure AD user ID or UPN of the calendar owner."
       },
-      { name: "start-date-time", key: "startDateTime", required: true, aliases: [{ name: "start", key: "start" }], description: `Start of the window. ${RELATIVE_DATE_DESCRIPTION}` },
-      { name: "end-date-time", key: "endDateTime", required: true, aliases: [{ name: "end", key: "end" }], description: `End of the window. ${RELATIVE_DATE_DESCRIPTION}` },
+      { name: "start-date-time", key: "startDateTime", required: true, description: `Start of the window. ${RELATIVE_DATE_DESCRIPTION}` },
+      { name: "end-date-time", key: "endDateTime", required: true, description: `End of the window. ${RELATIVE_DATE_DESCRIPTION}` },
       ...odataQueryOptions
     ],
     example: "ask-marcel-office list-shared-calendar-view --user-id 'colleague@contoso.com' --start-date-time '2026-04-01T00:00:00Z' --end-date-time '2026-05-01T00:00:00Z'",
@@ -25710,13 +25644,13 @@ __export(exports_list_sharepoint_list_columns, {
   meta: () => meta176,
   execute: () => execute174
 });
-var baseSchema94, execute174, schema174, meta176;
+var baseSchema93, execute174, schema174, meta176;
 var init_list_sharepoint_list_columns = __esm(() => {
   init_zod();
   init_build_command();
   init_odata_query();
-  baseSchema94 = exports_external.object({ siteId: exports_external.string().min(1), listId: exports_external.string().min(1) });
-  ({ execute: execute174, schema: schema174 } = buildSelectableCommand((p) => `/sites/${p.siteId}/lists/${p.listId}/columns`, baseSchema94));
+  baseSchema93 = exports_external.object({ siteId: exports_external.string().min(1), listId: exports_external.string().min(1) });
+  ({ execute: execute174, schema: schema174 } = buildSelectableCommand((p) => `/sites/${p.siteId}/lists/${p.listId}/columns`, baseSchema93));
   meta176 = {
     summary: "List the column definitions (schema) of a SharePoint list. Useful before reading list items so you know which fields exist and their types. Note: Graph silently ignores `$top` and `$skip` on this endpoint, so the CLI exposes only `--select` and `--expand`.",
     category: "sharepoint",
@@ -25750,13 +25684,13 @@ __export(exports_get_sharepoint_list_column, {
   meta: () => meta177,
   execute: () => execute175
 });
-var baseSchema95, execute175, schema175, meta177;
+var baseSchema94, execute175, schema175, meta177;
 var init_get_sharepoint_list_column = __esm(() => {
   init_zod();
   init_build_command();
   init_odata_query();
-  baseSchema95 = exports_external.object({ siteId: exports_external.string().min(1), listId: exports_external.string().min(1), columnId: exports_external.string().min(1) });
-  ({ execute: execute175, schema: schema175 } = buildSelectableCommand((p) => `/sites/${p.siteId}/lists/${p.listId}/columns/${p.columnId}`, baseSchema95));
+  baseSchema94 = exports_external.object({ siteId: exports_external.string().min(1), listId: exports_external.string().min(1), columnId: exports_external.string().min(1) });
+  ({ execute: execute175, schema: schema175 } = buildSelectableCommand((p) => `/sites/${p.siteId}/lists/${p.listId}/columns/${p.columnId}`, baseSchema94));
   meta177 = {
     summary: "Return a single column definition from a SharePoint list.",
     category: "sharepoint",
@@ -25814,14 +25748,14 @@ __export(exports_list_sharepoint_site_onenote_notebooks, {
   meta: () => meta178,
   execute: () => execute176
 });
-var baseSchema96, inner14, execute176, schema176, meta178;
+var baseSchema95, inner14, execute176, schema176, meta178;
 var init_list_sharepoint_site_onenote_notebooks = __esm(() => {
   init_zod();
   init_build_command();
   init_odata_query();
   init_onenote_5k_limit();
-  baseSchema96 = exports_external.object({ siteId: exports_external.string().min(1) });
-  inner14 = buildListCommand((p) => `/sites/${p.siteId}/onenote/notebooks`, baseSchema96);
+  baseSchema95 = exports_external.object({ siteId: exports_external.string().min(1) });
+  inner14 = buildListCommand((p) => `/sites/${p.siteId}/onenote/notebooks`, baseSchema95);
   execute176 = wrapOnenote5kLimit(inner14.execute);
   ({ schema: schema176 } = inner14);
   meta178 = {
@@ -25835,7 +25769,6 @@ var init_list_sharepoint_site_onenote_notebooks = __esm(() => {
         name: "site-id",
         key: "siteId",
         required: true,
-        aliases: [{ name: "id", key: "id" }],
         description: "SharePoint site ID."
       },
       ...odataQueryOptions
@@ -25853,14 +25786,14 @@ __export(exports_list_sharepoint_site_onenote_notebook_sections, {
   meta: () => meta179,
   execute: () => execute177
 });
-var baseSchema97, inner15, execute177, schema177, meta179;
+var baseSchema96, inner15, execute177, schema177, meta179;
 var init_list_sharepoint_site_onenote_notebook_sections = __esm(() => {
   init_zod();
   init_build_command();
   init_odata_query();
   init_onenote_5k_limit();
-  baseSchema97 = exports_external.object({ siteId: exports_external.string().min(1), notebookId: exports_external.string().min(1) });
-  inner15 = buildListCommand((p) => `/sites/${p.siteId}/onenote/notebooks/${p.notebookId}/sections`, baseSchema97);
+  baseSchema96 = exports_external.object({ siteId: exports_external.string().min(1), notebookId: exports_external.string().min(1) });
+  inner15 = buildListCommand((p) => `/sites/${p.siteId}/onenote/notebooks/${p.notebookId}/sections`, baseSchema96);
   execute177 = wrapOnenote5kLimit(inner15.execute);
   ({ schema: schema177 } = inner15);
   meta179 = {
@@ -25897,14 +25830,14 @@ __export(exports_list_sharepoint_site_onenote_section_pages, {
   meta: () => meta180,
   execute: () => execute178
 });
-var baseSchema98, inner16, execute178, schema178, meta180;
+var baseSchema97, inner16, execute178, schema178, meta180;
 var init_list_sharepoint_site_onenote_section_pages = __esm(() => {
   init_zod();
   init_build_command();
   init_odata_query();
   init_onenote_5k_limit();
-  baseSchema98 = exports_external.object({ siteId: exports_external.string().min(1), onenoteSectionId: exports_external.string().min(1) });
-  inner16 = buildListCommand((p) => `/sites/${p.siteId}/onenote/sections/${p.onenoteSectionId}/pages`, baseSchema98);
+  baseSchema97 = exports_external.object({ siteId: exports_external.string().min(1), onenoteSectionId: exports_external.string().min(1) });
+  inner16 = buildListCommand((p) => `/sites/${p.siteId}/onenote/sections/${p.onenoteSectionId}/pages`, baseSchema97);
   execute178 = wrapOnenote5kLimit(inner16.execute);
   ({ schema: schema178 } = inner16);
   meta180 = {
@@ -25924,8 +25857,7 @@ var init_list_sharepoint_site_onenote_section_pages = __esm(() => {
         name: "onenote-section-id",
         key: "onenoteSectionId",
         required: true,
-        description: "OneNote section ID inside the site.",
-        aliases: [{ name: "section-id", key: "sectionId" }]
+        description: "OneNote section ID inside the site."
       },
       ...odataQueryOptions
     ],
@@ -25971,8 +25903,7 @@ var init_get_sharepoint_site_onenote_page_content = __esm(() => {
         name: "onenote-page-id",
         key: "onenotePageId",
         required: true,
-        description: "OneNote page ID inside the site.",
-        aliases: [{ name: "page-id", key: "pageId" }]
+        description: "OneNote page ID inside the site."
       }
     ],
     example: "ask-marcel-office get-sharepoint-site-onenote-page-content --site-id 'contoso.sharepoint.com,...' --onenote-page-id 'p1'",
@@ -25988,14 +25919,14 @@ __export(exports_list_drive_item_thumbnails, {
   meta: () => meta182,
   execute: () => execute180
 });
-var baseSchema99, execute180, schema180, meta182;
+var baseSchema98, execute180, schema180, meta182;
 var init_list_drive_item_thumbnails = __esm(() => {
   init_zod();
   init_build_command();
   init_odata_query();
   init_tenant_option();
-  baseSchema99 = exports_external.object({ driveId: exports_external.string().min(1), itemId: exports_external.string().min(1), ...tenantIdShape });
-  ({ execute: execute180, schema: schema180 } = buildNoSkipListCommand((p) => `/drives/${p.driveId}/items/${p.itemId}/thumbnails`, baseSchema99));
+  baseSchema98 = exports_external.object({ driveId: exports_external.string().min(1), itemId: exports_external.string().min(1), ...tenantIdShape });
+  ({ execute: execute180, schema: schema180 } = buildNoSkipListCommand((p) => `/drives/${p.driveId}/items/${p.itemId}/thumbnails`, baseSchema98));
   meta182 = {
     summary: "List thumbnail URLs (small / medium / large) for a OneDrive / SharePoint file. Each thumbnail set has pre-signed CDN URLs you can render in a UI without further auth.",
     category: "drive",
@@ -26130,13 +26061,13 @@ __export(exports_list_rooms, {
   meta: () => meta184,
   execute: () => execute182
 });
-var baseSchema100, execute182, schema182, meta184;
+var baseSchema99, execute182, schema182, meta184;
 var init_list_rooms = __esm(() => {
   init_zod();
   init_build_command();
   init_odata_query();
-  baseSchema100 = exports_external.object({}).strict();
-  ({ execute: execute182, schema: schema182 } = buildListCommand(() => "/places/microsoft.graph.room", baseSchema100));
+  baseSchema99 = exports_external.object({}).strict();
+  ({ execute: execute182, schema: schema182 } = buildListCommand(() => "/places/microsoft.graph.room", baseSchema99));
   meta184 = {
     summary: "List bookable meeting rooms in the tenant. Each `room` has `displayName`, `emailAddress`, `capacity`, `building`, `floorNumber`, and `isWheelChairAccessible`. Use the `emailAddress` as a meeting `attendee` for room booking. Pass `--top 5` to limit the response — large tenants return tens of KB by default.",
     category: "calendar",
@@ -26157,13 +26088,13 @@ __export(exports_list_room_lists, {
   meta: () => meta185,
   execute: () => execute183
 });
-var baseSchema101, execute183, schema183, meta185;
+var baseSchema100, execute183, schema183, meta185;
 var init_list_room_lists = __esm(() => {
   init_zod();
   init_build_command();
   init_odata_query();
-  baseSchema101 = exports_external.object({}).strict();
-  ({ execute: execute183, schema: schema183 } = buildListCommand(() => "/places/microsoft.graph.roomList", baseSchema101));
+  baseSchema100 = exports_external.object({}).strict();
+  ({ execute: execute183, schema: schema183 } = buildListCommand(() => "/places/microsoft.graph.roomList", baseSchema100));
   meta185 = {
     summary: "List room lists — usually one per building. Use these to scope a room search by location: a roomList groups the rooms in one office, then `/places/{roomList}/rooms` lists just those rooms. Pass `--top N` to limit the response on large tenants.",
     category: "calendar",
@@ -26184,13 +26115,13 @@ __export(exports_list_trending_insights, {
   meta: () => meta186,
   execute: () => execute184
 });
-var baseSchema102, execute184, schema184, meta186;
+var baseSchema101, execute184, schema184, meta186;
 var init_list_trending_insights = __esm(() => {
   init_zod();
   init_build_command();
   init_odata_query();
-  baseSchema102 = exports_external.object({}).strict();
-  ({ execute: execute184, schema: schema184 } = buildListCommand(() => "/me/insights/trending", baseSchema102));
+  baseSchema101 = exports_external.object({}).strict();
+  ({ execute: execute184, schema: schema184 } = buildListCommand(() => "/me/insights/trending", baseSchema101));
   meta186 = {
     summary: "List documents trending around the signed-in user — files popular in their working network (colleagues' recent edits, shares, opens). Microsoft's relevance ranking, useful for surfacing unfamiliar but related work.",
     category: "drive",
@@ -26205,8 +26136,9 @@ var init_list_trending_insights = __esm(() => {
 });
 
 // src/use-cases/commands/index.ts
-var commands;
+var modules, commands;
 var init_commands = __esm(() => {
+  init_reject_unknown_params();
   init_download_drive_item_as_markdown();
   init_extract_drive_item_images();
   init_list_accessible_drives();
@@ -26391,7 +26323,7 @@ var init_commands = __esm(() => {
   init_list_rooms();
   init_list_room_lists();
   init_list_trending_insights();
-  commands = {
+  modules = {
     "list-drives": exports_list_drives,
     "get-drive-root-item": exports_get_drive_root_item,
     "list-folder-files": exports_list_folder_files,
@@ -26577,6 +26509,7 @@ var init_commands = __esm(() => {
     "list-todo-tasks-delta": exports_list_todo_tasks_delta,
     "next-page": exports_next_page
   };
+  commands = Object.fromEntries(Object.entries(modules).map(([name, command]) => [name, withUnknownParamRejection(command)]));
 });
 
 // node_modules/commander/lib/error.js
@@ -29021,7 +28954,17 @@ var init_output_text = __esm(() => {
 });
 
 // src/presenter/render-to-string.ts
-var SIZE_HINT_THRESHOLD_BYTES = 50000, buildSizeHint = (bytes) => `Response is ${Math.round(bytes / 1024)} KB (> 50 KB threshold). Universal remedy: \`--output-path <file>\` writes bytes to disk and keeps the envelope compact (works on every command). Per-item slimming via \`--select id,subject,...\` and item-count reduction via \`--top N\` work ONLY when the command's \`--help\` advertises those flags — endpoints like \`list-shared-with-me\`, \`microsoft-search-query\`, and the delta family silently ignore them.`, SELECT_HINT = "`value[]` contains entries but each is empty (only `@odata.etag`) — likely caused by `--select` field names Graph did not recognise. Graph silently drops unknown `$select` fields; check spelling against the command's `responseShape` in `ask-marcel-office docs <command>`.", isPlainRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value), isMeaningfulKey = (key) => !key.startsWith("@odata."), looksLikeBogusSelectResponse = (data) => {
+var SIZE_HINT_THRESHOLD_BYTES = 50000, bytesRemedy = (context) => context.surface === "mcp" ? "Set the `outputPath` param to write the body to a file; the envelope then carries `savedTo` instead of the bytes." : "Write the body to a file with `--output-path <file>`; the envelope then carries `savedTo` instead of the bytes.", jsonRemedy = (context) => context.surface === "mcp" ? `${context.commandName} returns plain JSON, so \`outputPath\` is refused here: there is no body to write.` : `${context.commandName} returns plain JSON, so \`--output-path\` is refused; redirect to a file instead: \`ask-marcel-office ${context.commandName} ... > out.json\`.`, slimmingRemedy = (context) => {
+  const levers = [...context.supportsSelect ? ["`--select id,subject,...` to slim each item"] : [], ...context.supportsTop ? ["`--top N` to cut the item count"] : []];
+  if (levers.length === 0)
+    return `${context.commandName} advertises no slimming flags, so narrow the query text itself and re-run.`;
+  return `Then re-run with ${levers.join(" and ")}.`;
+}, NEUTRAL_REMEDY = "Narrow the request and re-run; slimming flags apply only where the command advertises them (check `--help`).", buildSizeHint = (bytes, context) => {
+  const head = `Response is ${Math.round(bytes / 1024)} KB (> 50 KB threshold).`;
+  if (context === undefined)
+    return `${head} ${NEUTRAL_REMEDY}`;
+  return `${head} ${context.producesBytes ? bytesRemedy(context) : jsonRemedy(context)} ${slimmingRemedy(context)}`;
+}, SELECT_HINT = "`value[]` contains entries but each is empty (only `@odata.etag`) — likely caused by `--select` field names Graph did not recognise. Graph silently drops unknown `$select` fields; check spelling against the command's `responseShape` in `ask-marcel-office docs <command>`.", isPlainRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value), isMeaningfulKey = (key) => !key.startsWith("@odata."), looksLikeBogusSelectResponse = (data) => {
   if (!isPlainRecord(data))
     return false;
   const value = data["value"];
@@ -29055,24 +28998,24 @@ var SIZE_HINT_THRESHOLD_BYTES = 50000, buildSizeHint = (bytes) => `Response is $
     ...typeof deltaLink === "string" ? { deltaLink: canonicalizeGraphCursor(deltaLink) } : {},
     ...typeof count === "number" ? { count } : {}
   };
-}, renderJsonToString = (data) => {
+}, renderJsonToString = (data, context) => {
   const envelope = wrap(data);
   const selectHintField = looksLikeBogusSelectResponse(data) ? { selectHint: SELECT_HINT } : {};
   const initial = JSON.stringify({ ...envelope, ...selectHintField });
   if (initial.length <= SIZE_HINT_THRESHOLD_BYTES)
     return `${initial}
 `;
-  return `${JSON.stringify({ ...envelope, ...selectHintField, sizeHint: buildSizeHint(initial.length) })}
+  return `${JSON.stringify({ ...envelope, ...selectHintField, sizeHint: buildSizeHint(initial.length, context) })}
 `;
-}, renderTextToString = (data) => {
+}, renderTextToString = (data, context) => {
   const body = renderTextOutput(data);
   const selectHintLine = looksLikeBogusSelectResponse(data) ? `selectHint: ${SELECT_HINT}
 ` : "";
   if (body.length <= SIZE_HINT_THRESHOLD_BYTES)
     return `${selectHintLine}${body}`;
-  return `${selectHintLine}sizeHint: ${buildSizeHint(body.length)}
+  return `${selectHintLine}sizeHint: ${buildSizeHint(body.length, context)}
 ${body}`;
-}, renderToString = (data, format2) => format2 === "json" ? renderJsonToString(data) : renderTextToString(data), renderErrorToString = (message, format2, errorCode, explicitSource, retryAfterSeconds) => {
+}, renderToString = (data, format2, context) => format2 === "json" ? renderJsonToString(data, context) : renderTextToString(data, context), renderErrorToString = (message, format2, errorCode, explicitSource, retryAfterSeconds) => {
   const hint = findErrorHint(message, errorCode);
   const source = hint?.source ?? explicitSource;
   if (format2 === "json") {
@@ -29114,12 +29057,7 @@ var PAGINATION_HINT_NEXT_LINK = 'Paginated by Microsoft Graph. The CLI hoists `@
   if (strategy === "preferMaxPageSize")
     return PAGINATION_HINT_PREFER_MAX_PAGE_SIZE;
   return PAGINATION_HINT_NEXT_LINK;
-}, CATEGORY_LABELS, CATEGORY_ORDER, renderAliasSuffix = (aliases) => {
-  if (!aliases || aliases.length === 0)
-    return "";
-  const names = aliases.map((a) => `\`--${a.name}\``).join(", ");
-  return ` _(aliases: ${names})_`;
-}, renderCommandMarkdown = (entry) => {
+}, CATEGORY_LABELS, CATEGORY_ORDER, renderCommandMarkdown = (entry) => {
   const lines = [
     `# \`${entry.name}\``,
     "",
@@ -29129,10 +29067,6 @@ var PAGINATION_HINT_NEXT_LINK = 'Paginated by Microsoft Graph. The CLI hoists `@
     `- **Graph endpoint:** \`${entry.graphMethod} ${entry.graphPathTemplate}\``,
     `- **Microsoft Learn:** ${entry.graphDocsUrl}`
   ];
-  if (entry.commandAliases && entry.commandAliases.length > 0) {
-    const aliasNames = entry.commandAliases.map((a) => `\`${a}\``).join(", ");
-    lines.push(`- **Also invokable as (deprecated alias):** ${aliasNames}`);
-  }
   if (entry.responseShape)
     lines.push(`- **Response:** ${entry.responseShape}`);
   if (entry.pagination)
@@ -29157,7 +29091,7 @@ var PAGINATION_HINT_NEXT_LINK = 'Paginated by Microsoft Graph. The CLI hoists `@
     lines.push("", "## Options", "");
     lines.push("| Flag | Description |", "|------|-------------|");
     for (const o of entry.options)
-      lines.push(`| \`--${o.name}\` | ${o.description}${renderAliasSuffix(o.aliases)} |`);
+      lines.push(`| \`--${o.name}\` | ${o.description} |`);
   }
   if (entry.bodyTemplate)
     lines.push("", "## Request body", "", "```json", entry.bodyTemplate, "```");
@@ -29388,7 +29322,6 @@ var toEntry = (name, cmd) => {
     name,
     summary: cmd.meta.summary,
     category: cmd.meta.category,
-    ...cmd.meta.commandAliases ? { commandAliases: cmd.meta.commandAliases } : {},
     graphMethod: cmd.meta.graphMethod,
     graphPathTemplate: cmd.meta.graphPathTemplate,
     graphDocsUrl: cmd.meta.graphDocsUrl,
@@ -29625,9 +29558,15 @@ var sourceFromGraphError = (error48) => {
   if (error48.type === "auth_failed")
     return "cli";
   return "graph";
-}, bytesProducingCommands, mediaProducingCommands, formatOutputPathError = (error48, commandName) => {
+}, bytesProducingCommands, mediaProducingCommands, hasOption = (command, name) => command.meta.options.some((option) => option.name === name), buildSizeHintContext = (commandName, command, surface) => ({
+  commandName,
+  producesBytes: command.meta.producesBytes === true,
+  supportsSelect: hasOption(command, "select"),
+  supportsTop: hasOption(command, "top"),
+  surface
+}), noBodyRemedy = (commandName, surface) => surface === "mcp" ? "Narrow the request instead (fewer items, a tighter query); there is no body to write." : `Plain JSON commands (list-*, get-*-user, get-organization, etc.) don't have a body to write — drop the flag and use a shell redirect instead: \`ask-marcel-office ${commandName} ... > out.json\`.`, formatOutputPathError = (error48, commandName, surface) => {
   if (error48.type === "no_inlined_bytes")
-    return `--output-path: ${commandName} did not return inlined bytes — this flag works only with commands that produce a body to write. Supported: ${bytesProducingCommands.join(", ")}. Plain JSON commands (list-*, get-*-user, get-organization, etc.) don't have a body to write — drop the flag and use a shell redirect instead: \`ask-marcel-office ${commandName} ... > out.json\`.`;
+    return `--output-path: ${commandName} did not return inlined bytes — this flag works only with commands that produce a body to write. Supported: ${bytesProducingCommands.join(", ")}. ${noBodyRemedy(commandName, surface)}`;
   if (error48.type === "empty_path")
     return "--output-path: path argument is empty (likely a shell-quoting mistake — pass a real filesystem path)";
   if (error48.type === "is_directory")
@@ -29646,37 +29585,19 @@ var sourceFromGraphError = (error48) => {
   if (error48.type === "empty_path")
     return "--output-dir: directory argument is empty (likely a shell-quoting mistake — pass a real directory path)";
   return `--output-dir: write failed: ${error48.message}`;
-}, normalizeAliases = (command, params) => {
-  const normalized = { ...params };
-  const aliasUsedFor = {};
-  for (const opt of command.meta.options) {
-    for (const alias of opt.aliases ?? []) {
-      const aliasValue = params[alias.key];
-      if (typeof aliasValue === "string" && !Object.hasOwn(params, opt.key)) {
-        normalized[opt.key] = aliasValue;
-        aliasUsedFor[opt.name] = alias.name;
-      }
-    }
-  }
-  return { normalized, aliasUsedFor };
-}, toFailure = (command, error48, aliasUsedFor) => {
-  let message = error48.message;
-  for (const [canonical, alias] of Object.entries(aliasUsedFor)) {
-    message = message.replaceAll(`--${canonical}`, `--${alias}`);
-  }
+}, toFailure = (command, error48) => {
   const isLocalCommand = command.executeLocal !== undefined;
   return {
-    message,
+    message: error48.message,
     ...error48.code === undefined ? {} : { code: error48.code },
     source: isLocalCommand && error48.type !== "validation_error" ? "cli" : sourceFromGraphError(error48),
     ...error48.type === "api_error" && error48.retryAfterSeconds !== undefined ? { retryAfterSeconds: error48.retryAfterSeconds } : {}
   };
 }, runRegistryCommand = async (deps, request) => {
   const { command, name } = request;
-  const { normalized, aliasUsedFor } = normalizeAliases(command, request.params);
-  const result = command.executeLocal !== undefined ? await command.executeLocal(deps.fs, normalized) : await command.execute(deps.graph, normalized);
+  const result = command.executeLocal !== undefined ? await command.executeLocal(deps.fs, request.params) : await command.execute(deps.graph, request.params);
   if (!result.ok)
-    return err(toFailure(command, result.error, aliasUsedFor));
+    return err(toFailure(command, result.error));
   if (request.outputDir !== undefined) {
     const persistedMedia = await persistMediaIfRequested(deps.fs, request.outputDir, result.value);
     if (persistedMedia.ok)
@@ -29686,7 +29607,7 @@ var sourceFromGraphError = (error48) => {
   const persisted = await persistIfRequested(deps.fs, request.outputPath, result.value);
   if (persisted.ok)
     return ok(persisted.value);
-  return err({ message: formatOutputPathError(persisted.error, name), code: persisted.error.type });
+  return err({ message: formatOutputPathError(persisted.error, name, request.surface), code: persisted.error.type });
 };
 var init_run_registry_command = __esm(() => {
   init_commands();
@@ -44675,18 +44596,9 @@ var init_mcp = __esm(() => {
 });
 
 // src/use-cases/commands/resolve-command.ts
-var findByAlias = (registry2, name) => {
-  for (const [canonical, command] of Object.entries(registry2)) {
-    if (command.meta.commandAliases?.includes(name))
-      return { name: canonical, command };
-  }
-  return;
-}, availableNames = (registry2) => Object.entries(registry2).flatMap(([name, command]) => [name, ...command.meta.commandAliases ?? []]).toSorted((a, b) => a.localeCompare(b)), resolveCommand = (registry2, name) => {
+var availableNames = (registry2) => Object.keys(registry2).toSorted((a, b) => a.localeCompare(b)), resolveCommand = (registry2, name) => {
   if (Object.hasOwn(registry2, name))
     return ok({ name, command: registry2[name] });
-  const aliased = findByAlias(registry2, name);
-  if (aliased)
-    return ok(aliased);
   return err({ type: "unknown_command", name, available: availableNames(registry2) });
 };
 var init_resolve_command = () => {};
@@ -44723,7 +44635,7 @@ var PACKAGE_NAME = "ask-marcel-office-cli", okText = (text) => ({ content: [{ ty
     title: "Get command docs",
     description: "Full Markdown docs for ONE command: every option, its Graph endpoint, an example, and the response shape. Call this after list-commands and before run-command — it tells you exactly which params to pass. Also covers the lifecycle commands (login/logout/update/docs/help-json/mcp).",
     inputSchema: {
-      command: exports_external.string().describe("Command name, e.g. `list-mail-messages`. A deprecated former name also resolves.")
+      command: exports_external.string().describe("Command name, e.g. `list-mail-messages`.")
     },
     annotations: { readOnlyHint: true, idempotentHint: true }
   }, async ({ command }) => {
@@ -44748,10 +44660,11 @@ var PACKAGE_NAME = "ask-marcel-office-cli", okText = (text) => ({ content: [{ ty
       return errText(`"${resolved.value.name}" writes to Microsoft 365, so it is not available through run-command (which is declared read-only). Use run-write-command instead. Write commands: ${writeCommandNames.join(", ")}.`);
     if (!isMutating && wantMutating)
       return errText(`"${resolved.value.name}" is a read command — use run-command. run-write-command only accepts: ${writeCommandNames.join(", ")}.`);
-    const result = await runRegistryCommand({ graph, fs }, { name: resolved.value.name, command: resolved.value.command, params: params ?? {}, outputPath, outputDir });
+    const request = { name: resolved.value.name, command: resolved.value.command, params: params ?? {}, outputPath, outputDir, surface: "mcp" };
+    const result = await runRegistryCommand({ graph, fs }, request);
     if (!result.ok)
       return errText(result.error.message, result.error.code, result.error.source, result.error.retryAfterSeconds);
-    return okText(renderToString(result.value, "text"));
+    return okText(renderToString(result.value, "text", buildSizeHintContext(resolved.value.name, resolved.value.command, "mcp")));
   };
   server.registerTool("run-command", {
     title: "Run a read command",
@@ -44909,7 +44822,7 @@ import updateNotifier from "update-notifier";
 // package.json
 var package_default = {
   name: "ask-marcel-office-cli",
-  version: "2.2.0",
+  version: "2.3.0",
   description: "Microsoft Graph CLI + library — typed Bun/TypeScript wrapper around 150+ Graph operations (read + on-the-fly PDF/markdown conversion + federated Microsoft Search) reachable from a Teams browser-OAuth token.",
   license: "MIT",
   author: "Vincent Delacourt <vincent.delacourt@adama-development.com>",
@@ -46943,9 +46856,9 @@ var {
 
 // src/presenter/output.ts
 init_render_to_string();
-var render = (data, logger, format2) => {
+var render = (data, logger, format2, context) => {
   logger.info("output_rendered", {});
-  process.stdout.write(renderToString(data, format2));
+  process.stdout.write(renderToString(data, format2, context));
 };
 var renderError = (message, format2, errorCode, explicitSource, retryAfterSeconds) => {
   process.stdout.write(renderErrorToString(message, format2, errorCode, explicitSource, retryAfterSeconds));
@@ -46999,7 +46912,7 @@ var buildCli = (deps) => {
     const raw = program2.opts().output;
     return raw === "json" ? "json" : "text";
   };
-  const renderOut = (data) => render(data, logger, getFormat());
+  const renderOut = (data, sizeHintContext) => render(data, logger, getFormat(), sizeHintContext);
   const fail = (message, code, source, retryAfterSeconds) => {
     renderError(message, getFormat(), code, source, retryAfterSeconds);
     deps.onCommandError?.();
@@ -47016,7 +46929,7 @@ var buildCli = (deps) => {
       renderOut(persisted.value);
       return;
     }
-    fail(formatOutputPathError(persisted.error, commandName));
+    fail(formatOutputPathError(persisted.error, commandName, "cli"));
   };
   program2.configureOutput({
     writeErr: () => {
@@ -47190,8 +47103,6 @@ var buildCli = (deps) => {
     program2.commandsGroup(`${CATEGORY_LABELS[category]}:`);
     for (const [name, cmd] of entries) {
       const commandDef = program2.command(name).description(cmd.meta.summary);
-      for (const aliasName of cmd.meta.commandAliases ?? [])
-        commandDef.alias(aliasName);
       const noRepeatParser = (flagName) => (value, previous) => {
         if (typeof previous === "string") {
           throw new InvalidArgumentError(`--${flagName} cannot be passed more than once (previous: "${previous}", new: "${value}"). Single-value flags reject duplicate occurrences.`);
@@ -47199,12 +47110,7 @@ var buildCli = (deps) => {
         return value;
       };
       for (const opt of cmd.meta.options) {
-        if (opt.aliases && opt.aliases.length > 0) {
-          commandDef.option(`--${opt.name} <value>`, opt.description, noRepeatParser(opt.name));
-          for (const alias of opt.aliases) {
-            commandDef.option(`--${alias.name} <value>`, `(alias for --${opt.name})`, noRepeatParser(alias.name));
-          }
-        } else if (opt.required) {
+        if (opt.required) {
           commandDef.requiredOption(`--${opt.name} <value>`, opt.description, noRepeatParser(opt.name));
         } else {
           commandDef.option(`--${opt.name} <value>`, opt.description, noRepeatParser(opt.name));
@@ -47231,9 +47137,9 @@ Example:
 `));
       commandDef.action(async (opts) => {
         const globals = program2.opts();
-        const result = await runRegistryCommand({ graph, fs }, { name, command: cmd, params: opts, outputPath: globals.outputPath, outputDir: globals.outputDir });
+        const result = await runRegistryCommand({ graph, fs }, { name, command: cmd, params: opts, outputPath: globals.outputPath, outputDir: globals.outputDir, surface: "cli" });
         if (result.ok) {
-          renderOut(result.value);
+          renderOut(result.value, buildSizeHintContext(name, cmd, "cli"));
           return;
         }
         fail(result.error.message, result.error.code, result.error.source, result.error.retryAfterSeconds);