ask-marcel-office-cli 0.5.5 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (197) hide show
  1. package/CHANGELOG.md +92 -0
  2. package/README.md +147 -221
  3. package/dist/cli.js +99348 -14825
  4. package/dist/commands.json +5870 -789
  5. package/dist/composition/build-deps.d.ts +1 -0
  6. package/dist/composition/cli.d.ts +2 -0
  7. package/dist/domain/iso-datetime.d.ts +30 -0
  8. package/dist/index.js +97246 -13703
  9. package/dist/infra/auth.d.ts +61 -3
  10. package/dist/infra/browser-auth.d.ts +163 -1
  11. package/dist/infra/graph-client.d.ts +99 -2
  12. package/dist/infra/mammoth-adapter.d.ts +4 -0
  13. package/dist/infra/network-error.d.ts +9 -0
  14. package/dist/infra/sheetjs-adapter.d.ts +9 -0
  15. package/dist/infra/turndown-adapter.d.ts +4 -0
  16. package/dist/presenter/error-hints.d.ts +41 -0
  17. package/dist/presenter/output-text.d.ts +2 -0
  18. package/dist/presenter/output.d.ts +5 -2
  19. package/dist/use-cases/commands/build-command.d.ts +67 -1
  20. package/dist/use-cases/commands/command-types.d.ts +108 -3
  21. package/dist/use-cases/commands/convert-mail-attachment-to-markdown.d.ts +11 -0
  22. package/dist/use-cases/commands/convert-mail-attachment-to-pdf.d.ts +11 -0
  23. package/dist/use-cases/commands/convert-mail-to-markdown.d.ts +14 -0
  24. package/dist/use-cases/commands/docs-render.d.ts +10 -1
  25. package/dist/use-cases/commands/docs.d.ts +44 -1
  26. package/dist/use-cases/commands/docx-to-markdown.d.ts +11 -0
  27. package/dist/use-cases/commands/{download-drive-item-version-content.d.ts → download-drive-item-as-markdown.d.ts} +0 -1
  28. package/dist/use-cases/commands/download-drive-item-as-pdf.d.ts +11 -0
  29. package/dist/use-cases/commands/download-drive-item-version.d.ts +17 -0
  30. package/dist/use-cases/commands/download-onedrive-file-content.d.ts +2 -2
  31. package/dist/use-cases/commands/embedded-item-to-markdown.d.ts +59 -0
  32. package/dist/use-cases/commands/excel-error.d.ts +6 -0
  33. package/dist/use-cases/commands/extract-sharepoint-links-in-mail.d.ts +26 -0
  34. package/dist/use-cases/commands/fetch-raw-bytes.d.ts +56 -0
  35. package/dist/use-cases/commands/find-chats-with-user.d.ts +10 -0
  36. package/dist/use-cases/commands/format-zod-error.d.ts +14 -0
  37. package/dist/use-cases/commands/get-calendar-event.d.ts +1 -5
  38. package/dist/use-cases/commands/get-calendar-view.d.ts +1 -6
  39. package/dist/use-cases/commands/get-channel-files-folder.d.ts +4 -0
  40. package/dist/use-cases/commands/get-chat.d.ts +4 -0
  41. package/dist/use-cases/commands/get-current-user.d.ts +1 -3
  42. package/dist/use-cases/commands/get-drive-delta.d.ts +1 -6
  43. package/dist/use-cases/commands/get-drive-item-analytics.d.ts +9 -0
  44. package/dist/use-cases/commands/get-drive-item-created-by-user.d.ts +4 -0
  45. package/dist/use-cases/commands/get-drive-item-last-modified-by-user.d.ts +4 -0
  46. package/dist/use-cases/commands/get-drive-item-list-item.d.ts +4 -0
  47. package/dist/use-cases/commands/get-drive-item.d.ts +1 -6
  48. package/dist/use-cases/commands/get-drive-root-delta.d.ts +4 -0
  49. package/dist/use-cases/commands/get-drive-root-item.d.ts +1 -5
  50. package/dist/use-cases/commands/get-drive-special-folder.d.ts +4 -0
  51. package/dist/use-cases/commands/get-excel-range.d.ts +1 -1
  52. package/dist/use-cases/commands/get-excel-table.d.ts +1 -1
  53. package/dist/use-cases/commands/get-excel-used-range.d.ts +15 -0
  54. package/dist/use-cases/commands/get-group-calendar-view.d.ts +4 -0
  55. package/dist/use-cases/commands/get-group.d.ts +4 -0
  56. package/dist/use-cases/commands/get-mail-attachment.d.ts +4 -2
  57. package/dist/use-cases/commands/get-mail-message-mime.d.ts +8 -0
  58. package/dist/use-cases/commands/get-mail-message.d.ts +1 -5
  59. package/dist/use-cases/commands/get-mail-rule.d.ts +9 -0
  60. package/dist/use-cases/commands/get-mailbox-settings.d.ts +1 -1
  61. package/dist/use-cases/commands/get-my-calendar.d.ts +4 -0
  62. package/dist/use-cases/commands/get-my-manager.d.ts +9 -0
  63. package/dist/use-cases/commands/get-onenote-page-as-markdown.d.ts +10 -0
  64. package/dist/use-cases/commands/get-organization.d.ts +4 -0
  65. package/dist/use-cases/commands/get-shared-calendar-view.d.ts +4 -0
  66. package/dist/use-cases/commands/get-shared-mailbox-message.d.ts +4 -0
  67. package/dist/use-cases/commands/get-sharepoint-list-column.d.ts +4 -0
  68. package/dist/use-cases/commands/get-sharepoint-site-drive-by-id.d.ts +1 -6
  69. package/dist/use-cases/commands/get-sharepoint-site-list-item.d.ts +1 -7
  70. package/dist/use-cases/commands/get-sharepoint-site-list.d.ts +1 -6
  71. package/dist/use-cases/commands/get-sharepoint-site-onenote-page-content.d.ts +9 -0
  72. package/dist/use-cases/commands/get-sharepoint-site.d.ts +1 -5
  73. package/dist/use-cases/commands/get-site-analytics.d.ts +8 -0
  74. package/dist/use-cases/commands/get-specific-calendar-event.d.ts +1 -6
  75. package/dist/use-cases/commands/get-specific-calendar-view.d.ts +1 -7
  76. package/dist/use-cases/commands/get-team-channel.d.ts +3 -7
  77. package/dist/use-cases/commands/get-team-primary-channel.d.ts +4 -0
  78. package/dist/use-cases/commands/get-team.d.ts +1 -5
  79. package/dist/use-cases/commands/get-teams-chat-message.d.ts +9 -0
  80. package/dist/use-cases/commands/get-todo-task.d.ts +1 -6
  81. package/dist/use-cases/commands/get-user-manager.d.ts +10 -0
  82. package/dist/use-cases/commands/graph-scopes.d.ts +29 -0
  83. package/dist/use-cases/commands/inline-image-embedder.d.ts +20 -0
  84. package/dist/use-cases/commands/iso-datetime-schema.d.ts +21 -0
  85. package/dist/use-cases/commands/link-shape.d.ts +13 -0
  86. package/dist/use-cases/commands/list-all-onenote-sections.d.ts +1 -3
  87. package/dist/use-cases/commands/list-calendar-event-instances.d.ts +3 -9
  88. package/dist/use-cases/commands/list-calendar-events-delta.d.ts +5 -3
  89. package/dist/use-cases/commands/list-calendar-events.d.ts +1 -3
  90. package/dist/use-cases/commands/list-calendar-group-calendars.d.ts +4 -0
  91. package/dist/use-cases/commands/list-calendar-groups.d.ts +4 -0
  92. package/dist/use-cases/commands/list-calendar-view-delta.d.ts +5 -4
  93. package/dist/use-cases/commands/list-calendars.d.ts +1 -3
  94. package/dist/use-cases/commands/list-chat-members.d.ts +3 -6
  95. package/dist/use-cases/commands/list-chats.d.ts +4 -0
  96. package/dist/use-cases/commands/list-conversation-messages.d.ts +12 -0
  97. package/dist/use-cases/commands/list-drive-item-permissions.d.ts +1 -6
  98. package/dist/use-cases/commands/list-drive-item-thumbnails.d.ts +4 -0
  99. package/dist/use-cases/commands/list-drive-item-versions.d.ts +1 -6
  100. package/dist/use-cases/commands/list-drives.d.ts +1 -3
  101. package/dist/use-cases/commands/list-excel-comments.d.ts +5 -0
  102. package/dist/use-cases/commands/list-excel-defined-names.d.ts +5 -0
  103. package/dist/use-cases/commands/list-excel-table-rows.d.ts +2 -7
  104. package/dist/use-cases/commands/list-excel-tables.d.ts +2 -6
  105. package/dist/use-cases/commands/list-excel-worksheet-charts.d.ts +5 -0
  106. package/dist/use-cases/commands/list-excel-worksheet-pivot-tables.d.ts +5 -0
  107. package/dist/use-cases/commands/list-excel-worksheets.d.ts +2 -6
  108. package/dist/use-cases/commands/list-focused-inbox-overrides.d.ts +4 -0
  109. package/dist/use-cases/commands/list-folder-files.d.ts +1 -6
  110. package/dist/use-cases/commands/list-followed-drive-items.d.ts +4 -0
  111. package/dist/use-cases/commands/list-group-conversations.d.ts +4 -0
  112. package/dist/use-cases/commands/list-group-events.d.ts +4 -0
  113. package/dist/use-cases/commands/list-group-members.d.ts +4 -0
  114. package/dist/use-cases/commands/list-group-owners.d.ts +4 -0
  115. package/dist/use-cases/commands/list-group-threads.d.ts +4 -0
  116. package/dist/use-cases/commands/list-groups.d.ts +4 -0
  117. package/dist/use-cases/commands/list-incomplete-planner-tasks.d.ts +10 -3
  118. package/dist/use-cases/commands/list-incomplete-todo-tasks.d.ts +8 -2
  119. package/dist/use-cases/commands/list-mail-attachments.d.ts +8 -2
  120. package/dist/use-cases/commands/list-mail-child-folders.d.ts +1 -5
  121. package/dist/use-cases/commands/list-mail-folder-messages-delta.d.ts +4 -0
  122. package/dist/use-cases/commands/list-mail-folder-messages.d.ts +1 -5
  123. package/dist/use-cases/commands/list-mail-folders.d.ts +1 -3
  124. package/dist/use-cases/commands/list-mail-messages.d.ts +1 -3
  125. package/dist/use-cases/commands/list-mail-rules.d.ts +1 -1
  126. package/dist/use-cases/commands/list-my-direct-reports.d.ts +13 -0
  127. package/dist/use-cases/commands/list-my-memberships.d.ts +4 -0
  128. package/dist/use-cases/commands/list-my-transitive-memberships.d.ts +4 -0
  129. package/dist/use-cases/commands/list-onenote-notebook-sections.d.ts +1 -5
  130. package/dist/use-cases/commands/list-onenote-notebooks.d.ts +1 -3
  131. package/dist/use-cases/commands/list-onenote-section-pages.d.ts +1 -5
  132. package/dist/use-cases/commands/list-outlook-categories.d.ts +6 -0
  133. package/dist/use-cases/commands/list-plan-buckets.d.ts +1 -5
  134. package/dist/use-cases/commands/list-planner-plans.d.ts +1 -3
  135. package/dist/use-cases/commands/list-planner-tasks.d.ts +1 -3
  136. package/dist/use-cases/commands/list-recent-files.d.ts +4 -0
  137. package/dist/use-cases/commands/list-recently-used-insights.d.ts +4 -0
  138. package/dist/use-cases/commands/list-relevant-people.d.ts +4 -0
  139. package/dist/use-cases/commands/list-room-lists.d.ts +4 -0
  140. package/dist/use-cases/commands/list-rooms.d.ts +4 -0
  141. package/dist/use-cases/commands/list-sensitivity-labels.d.ts +4 -0
  142. package/dist/use-cases/commands/list-shared-calendar-events.d.ts +4 -0
  143. package/dist/use-cases/commands/list-shared-insights.d.ts +4 -0
  144. package/dist/use-cases/commands/list-shared-mailbox-folder-messages.d.ts +4 -0
  145. package/dist/use-cases/commands/list-shared-mailbox-messages.d.ts +4 -0
  146. package/dist/use-cases/commands/list-shared-with-me.d.ts +6 -0
  147. package/dist/use-cases/commands/list-sharepoint-list-columns.d.ts +4 -0
  148. package/dist/use-cases/commands/list-sharepoint-list-item-versions.d.ts +4 -0
  149. package/dist/use-cases/commands/list-sharepoint-site-drives.d.ts +1 -5
  150. package/dist/use-cases/commands/list-sharepoint-site-list-items.d.ts +1 -6
  151. package/dist/use-cases/commands/list-sharepoint-site-lists.d.ts +7 -2
  152. package/dist/use-cases/commands/list-sharepoint-site-onenote-notebook-sections.d.ts +5 -0
  153. package/dist/use-cases/commands/list-sharepoint-site-onenote-notebooks.d.ts +5 -0
  154. package/dist/use-cases/commands/list-sharepoint-site-onenote-section-pages.d.ts +5 -0
  155. package/dist/use-cases/commands/list-sharepoint-site-pages.d.ts +4 -0
  156. package/dist/use-cases/commands/list-site-columns.d.ts +4 -0
  157. package/dist/use-cases/commands/list-site-content-types.d.ts +4 -0
  158. package/dist/use-cases/commands/list-specific-calendar-events.d.ts +1 -5
  159. package/dist/use-cases/commands/list-team-channels.d.ts +1 -5
  160. package/dist/use-cases/commands/list-team-installed-apps.d.ts +8 -0
  161. package/dist/use-cases/commands/list-teams-chat-history.d.ts +16 -0
  162. package/dist/use-cases/commands/list-teams-chat-messages.d.ts +8 -0
  163. package/dist/use-cases/commands/list-teams-chats-with-messages.d.ts +9 -0
  164. package/dist/use-cases/commands/list-todo-linked-resources.d.ts +1 -6
  165. package/dist/use-cases/commands/list-todo-task-lists.d.ts +1 -3
  166. package/dist/use-cases/commands/list-todo-tasks-delta.d.ts +8 -0
  167. package/dist/use-cases/commands/list-todo-tasks.d.ts +8 -2
  168. package/dist/use-cases/commands/list-trending-insights.d.ts +4 -0
  169. package/dist/use-cases/commands/list-user-direct-reports.d.ts +4 -0
  170. package/dist/use-cases/commands/markdown-pipeline.d.ts +23 -0
  171. package/dist/use-cases/commands/microsoft-search-query.d.ts +8 -0
  172. package/dist/use-cases/commands/my-quick-context.d.ts +6 -0
  173. package/dist/use-cases/commands/next-page.d.ts +2 -2
  174. package/dist/use-cases/commands/odata-query.d.ts +90 -0
  175. package/dist/use-cases/commands/office-to-markdown.d.ts +6 -0
  176. package/dist/use-cases/commands/onenote-5k-limit.d.ts +3 -0
  177. package/dist/use-cases/commands/output-path.d.ts +37 -0
  178. package/dist/use-cases/commands/resolve-calendar-link.d.ts +8 -0
  179. package/dist/use-cases/commands/resolve-drive-share-link.d.ts +8 -0
  180. package/dist/use-cases/commands/resolve-mail-link.d.ts +8 -0
  181. package/dist/use-cases/commands/resolve-teams-link.d.ts +8 -0
  182. package/dist/use-cases/commands/scopes-check.d.ts +6 -0
  183. package/dist/use-cases/commands/search-mail-messages.d.ts +3 -6
  184. package/dist/use-cases/commands/search-my-documents.d.ts +1 -5
  185. package/dist/use-cases/commands/search-onedrive-files.d.ts +1 -8
  186. package/dist/use-cases/commands/search-onenote-pages.d.ts +7 -2
  187. package/dist/use-cases/commands/search-sharepoint-sites-by-name.d.ts +1 -5
  188. package/dist/use-cases/commands/sharepoint-link-extractor.d.ts +14 -0
  189. package/dist/use-cases/commands/text-passthrough.d.ts +24 -0
  190. package/dist/use-cases/commands/version-id.d.ts +19 -0
  191. package/dist/use-cases/commands/xlsx-to-markdown.d.ts +6 -0
  192. package/dist/use-cases/ports/filesystem.d.ts +8 -0
  193. package/docs/COMMANDS.md +243 -0
  194. package/docs/USAGE.md +249 -0
  195. package/docs/commands.json +5870 -789
  196. package/package.json +11 -2
  197. /package/dist/use-cases/commands/{search-sharepoint-sites.d.ts → list-mail-folders-delta.d.ts} +0 -0
@@ -15,5 +15,6 @@ export type BuiltDeps = Readonly<{
15
15
  auth: AuthManager;
16
16
  graph: GraphClient;
17
17
  processRunner: ProcessRunner;
18
+ fs: FileSystem;
18
19
  }>;
19
20
  export declare const buildDeps: (config?: BuildDepsConfig) => BuiltDeps;
@@ -1,6 +1,7 @@
1
1
  import { Command } from 'commander';
2
2
  import type { AuthManager } from '../infra/auth.js';
3
3
  import type { GraphClient } from '../infra/graph-client.js';
4
+ import type { FileSystem } from '../use-cases/ports/filesystem.js';
4
5
  import type { Logger } from '../use-cases/ports/logger.js';
5
6
  import type { ProcessRunner } from '../use-cases/ports/process-runner.js';
6
7
  type BuildCliDeps = {
@@ -8,6 +9,7 @@ type BuildCliDeps = {
8
9
  readonly graph: GraphClient;
9
10
  readonly logger: Logger;
10
11
  readonly processRunner: ProcessRunner;
12
+ readonly fs: FileSystem;
11
13
  readonly version?: string;
12
14
  readonly packageManager?: 'npm' | 'bun';
13
15
  readonly onCommandError?: () => void;
@@ -0,0 +1,30 @@
1
+ import type { Result } from './result.js';
2
+ /**
3
+ * Branded ISO-8601 UTC datetime string ("2026-04-01T00:00:00Z"). Constructed
4
+ * only via `parseIsoDateTime` (or the unsafe escape hatch); every Graph URL
5
+ * built from a calendar-window parameter accepts this type so an unvalidated
6
+ * `string` can't slip through.
7
+ *
8
+ * Audit Hervé-session §C: the previous calendar commands accepted any
9
+ * `z.string().min(1)`, so the LLM had to compute "last week" → ISO by hand.
10
+ * `parseIsoDateTime` turns "7d" / "monday" / "today" / "2026-04-01" / a strict
11
+ * ISO timestamp into the canonical ISO form, so the URL builders stay
12
+ * unchanged.
13
+ */
14
+ export type IsoDateTime = string & {
15
+ readonly __brand: 'IsoDateTime';
16
+ };
17
+ export declare const isoDateTimeUnsafe: (raw: string) => IsoDateTime;
18
+ export type DateParseError = {
19
+ readonly type: 'invalid_format';
20
+ readonly input: string;
21
+ readonly hint: string;
22
+ };
23
+ /**
24
+ * Parse a free-form date input into the canonical `2026-04-01T00:00:00Z`
25
+ * shape (`IsoDateTime`). Returns `err(invalid_format)` with a multi-line
26
+ * hint listing every accepted shape — surfaces directly through the CLI's
27
+ * validation envelope so an LLM gets all the alternatives without an extra
28
+ * round-trip. See `HINT` above for the full list.
29
+ */
30
+ export declare const parseIsoDateTime: (rawInput: string, now?: Date) => Result<IsoDateTime, DateParseError>;