ask-marcel-office-cli 1.0.0 → 1.5.0

package/CHANGELOG.md

@@ -2,6 +2,71 @@
 
 All notable changes to `ask-marcel-office-cli` are documented here.
 
+## 1.5.0
+
+Agent-ergonomics, a faster cold-start, a new command, and an LLM-safety pass.
+Mostly additive; the one rename keeps its old name as an alias. **One behaviour
+change to note**: byte commands now refuse to inline a payload over ~1 MB without
+`--output-path` (see _Changed_).
+
+### Added
+
+- **`read-mail-attachment`** — a polymorphic "read any attachment" command that
+  auto-routes by content-type: a `.zip` is unpacked and every entry converted
+  (the `{ count, files }` envelope), everything else (docx/xlsx/pptx/odf/csv/pdf/
+  `.msg`/legacy/text, reference + embedded items) runs through the markdown
+  dispatch. Images / scanned PDFs / legacy `.ppt` return the actionable
+  vision-model hint. Use the explicit `convert-mail-attachment-*` siblings only
+  to force a specific output format. (Surface: 176 → 177 commands.)
+- **`pageCount`** on the born-digital PDF text envelope (every PDF→markdown entry
+  point) so an LLM can chunk its reads without a second parse.
+- **`--id`** is now accepted by *every* command with a single required `*-id`
+  flag (was mail-message-only) — e.g. `get-calendar-event --id`, `get-team --id`.
+- **`--start` / `--end`** aliases for `--start-date-time` / `--end-date-time`
+  across the calendar-view family.
+- **Token-tier flags in the manifest** — `needsElevatedToken` (now serialized to
+  `commands.json` too, not only `help-json`) and a new `needsSubstrateToken` mark
+  the Teams elevated / chat-substrate commands, so an agent can warm up an
+  interactive login before calling them instead of dead-ending on a timeout.
+
+### Changed
+
+- **`download-onedrive-file-content` → `download-drive-item-content`** (it works
+  on any driveItem, not just OneDrive). The old name keeps working as a
+  back-compat alias.
+- **Friendlier error for a mistyped flag**: a bare word like `item--id` (instead
+  of `--item-id`) now explains flags need their leading `--`, rather than
+  commander's opaque "too many arguments".
+- **Byte commands refuse to inline a multi-MB payload** without `--output-path`:
+  `get-mail-attachment`, `get-mail-message-mime`, the `download-*` family, etc.
+  now return an actionable `inline_too_large` error above ~1 MB instead of
+  flooding an LLM's context with a base64 blob. Small payloads still inline.
+- **`read-mail-attachment` prefers content-type when the filename misleads** — a
+  real spreadsheet saved as `report.jpg` now converts as a table instead of
+  returning an image hint. The explicit `convert-*` siblings stay
+  extension-deterministic by design.
+- **Unified `--drive-id` guidance** — the 11 terse drive-item commands now point
+  at `list-drives` / `list-sharepoint-site-drives` like the rest.
+
+### Fixed
+
+- **Auth no longer pops a browser per command on re-auth.** A command whose token
+  needed refreshing used to launch the Chrome extension-capture window — once per
+  process, with no cross-process throttle, so a batch/agent run stacked up
+  windows. Command re-auth now uses a headed Edge sign-in (one login re-caches all
+  tokens); the extension capture is reserved for explicit `login --use-extension`.
+- **Stale doc numbers** — the `help-json` size hints (terse-category ~16 → ~6 KB
+  after the trim) and the README command list now match reality.
+
+### Performance
+
+- **Cold-start**: the heavy conversion deps are `--external` to the npm bundle
+  (`dist/cli.js` 7.4 MB → 1.2 MB; `node --version` ~1.0 s → 0.58 s). The compiled
+  standalone binaries (`build:bin`) stay self-contained.
+- **`help-json --terse`** summaries are compacted to their first sentence, so a
+  per-category discovery fetch drops well under budget (drive 17.9 KB → 6.5 KB,
+  mail 16.8 KB → 5.2 KB; full terse 83 KB → 31 KB).
+
 ## 1.0.0
 
 The first stable release. Two breaking changes consolidate the public output