Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,15 @@
# Changelog

## 0.76.0 — 14.11.2026

### Changed — may break callers

- **`search meetings` without `--limit` shows 20 hits, not 100,** and a search by meaning keeps the same 20
(cli-core's shared page size). zm has no configured page size yet, so `--limit` is the only way to change it.
- **`meetings` commands take the program's `--json [fields]` and `--jsonl`** instead of their own on/off flags, so
`meetings list --json id,title` keeps only those fields.
- **Needs `@wirecat/cli-core` 0.663.0 and `@wirecat/cli-base` 0.100.0.**

## 0.75.0 — 14.11.2026

### Changed — may break callers
Expand Down
63 changes: 17 additions & 46 deletions docs/commands.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,8 +48,8 @@ zm runs list [query] [options]

| Option | What it does |
|---|---|
| `--limit <n>` | how many to show. Default: `20`. |
| `--page <n>` | which page, starting at 1. Default: `1`. |
| `--limit <n>` | how many to show. |
| `--page <n>` | which page, starting at 1. |

**Returns:** run — run_id, command, started_at, status, cli_version, profile, completed_at, requests, and 23 more; every field: zm commands info runs list

Expand Down Expand Up @@ -368,11 +368,9 @@ zm meetings list [query] [options]

| Option | What it does |
|---|---|
| `--json` | one JSON value. |
| `--jsonl` | one JSON object per item. |
| `--backend <archive\|server\|both>` | where to read: the store (archive), the service (server), or both, kept in the store (default: both). |
| `--limit <n>` | meetings per page. Default: `100`. |
| `--page <n>` | page number. Default: `1`. |
| `--limit <n>` | meetings per page; the profile's defaults.limit when absent. |
| `--page <n>` | which page, starting at 1. |

**Returns:** meeting — ref, id, provider_id, provider, account, title, url, started_at, and 11 more; every field: zm commands info meetings list

Expand All @@ -394,8 +392,6 @@ zm meetings show <meeting> [options]

| Option | What it does |
|---|---|
| `--json` | one JSON value. |
| `--jsonl` | one JSON object per item. |
| `--backend <archive\|server\|both>` | where to read: the store (archive), the service (server), or both, kept in the store (default: both). |

**Returns:** meeting details — ref, id, provider_id, provider, account, title, url, started_at, and 20 more; every field: zm commands info meetings show
Expand All @@ -419,8 +415,6 @@ zm meetings transcript <meeting> [options]
| Option | What it does |
|---|---|
| `--history` | include superseded transcript versions. |
| `--json` | one JSON value. |
| `--jsonl` | one JSON object per item. |

**Returns:** meeting transcript — ref, meeting, source, language, superseded_at, created_at, lines; every field: zm commands info meetings transcript

Expand All @@ -431,18 +425,13 @@ zm meetings transcript <meeting> [options]
show stored meeting summaries

```sh
zm meetings summary <meeting> [options]
zm meetings summary <meeting>
```

| Argument | | What it is |
|---|---|---|
| `meeting` | required | stored meeting id. |

| Option | What it does |
|---|---|
| `--json` | one JSON value. |
| `--jsonl` | one JSON object per item. |

**Returns:** meeting summary — id, meeting, source, title, overview, sections, next_steps, content, and 3 more; every field: zm commands info meetings summary

**Next usually:** `zm meetings show <meeting>`, `zm meetings transcript <meeting>`, `zm recordings show <meeting>`
Expand All @@ -468,8 +457,6 @@ zm meetings export <meeting> [options]
| `--format <format>` | export format. One of: `markdown`, `vtt`. Default: `markdown`. |
| `--transcript-id <id>` | export a specific transcript version. |
| `--output <file>` | write content to a new file through the host's writer. |
| `--json` | one JSON value. |
| `--jsonl` | one JSON object per item. |

**Returns:** meeting export — meeting_id, format, filename, content, output; every field: zm commands info meetings export

Expand All @@ -489,8 +476,6 @@ zm meetings people <query> [options]

| Option | What it does |
|---|---|
| `--json` | one JSON value. |
| `--jsonl` | one JSON object per item. |
| `--limit <n>` | most matching observations per page, 1–1000 (default 50). |
| `--scan-limit <n>` | most participant observations to inspect, 1–10000 (default 1000). |
| `--max-read-bytes <bytes>` | most stored name and email bytes to read (default 1048576). |
Expand All @@ -512,9 +497,7 @@ zm meetings sync [options]

| Option | What it does |
|---|---|
| `--json` | one JSON value. |
| `--jsonl` | one JSON object per item. |
| `--since-time <time>` | fetch meetings starting at or after this ISO 8601 date or time. |
| `--since-time <time>` | fetch meetings starting at or after this ISO 8601 date or time, or 30m, 2h, 7d ago. |
| `--lookback-days <days>` | revisit recent occurrences for late transcripts (0–31). |
| `--rescan` | read the last 30 days again, not only what came after the last sync. |

Expand All @@ -529,18 +512,13 @@ import downloaded meeting transcripts
**Changes local data.**

```sh
zm meetings import <folder> [options]
zm meetings import <folder>
```

| Argument | | What it is |
|---|---|---|
| `folder` | required | folder of transcripts downloaded from the provider. |

| Option | What it does |
|---|---|
| `--json` | one JSON value. |
| `--jsonl` | one JSON object per item. |

**Returns:** meeting ingestion — meetings, participants, transcript_rows, summaries, warnings, timezone; every field: zm commands info meetings import

**Example:** `zm personal meetings import ./downloaded-transcripts --json`
Expand All @@ -557,8 +535,6 @@ zm meetings repair [options]

| Option | What it does |
|---|---|
| `--json` | one JSON value. |
| `--jsonl` | one JSON object per item. |
| `--yes` | store the detected languages; otherwise only preview. |

**Returns:** meeting repair — account_id, applied, transcripts, languages; every field: zm commands info meetings repair
Expand All @@ -575,8 +551,8 @@ zm meetings scheduled [options]

| Option | What it does |
|---|---|
| `--since-time <time>` | absolute window start as ISO timestamp with zone (default now). |
| `--before-time <time>` | exclusive ISO window end (default seven days after start). |
| `--since-time <time>` | window start, an ISO date or time, local without a zone (default now). |
| `--before-time <time>` | exclusive window end, an ISO date or time; a date alone covers that day (default seven days after start). |
| `--limit <n>` | series candidates in one provider page, 1–100 (default 100). |
| `--max-read-bytes <bytes>` | normalized provider-page bytes, at most 1048576 (default 65536). |
| `--bytes <bytes>` | answer item UTF-8 JSON bytes, 2048–1048576 (default 65536). |
Expand Down Expand Up @@ -653,12 +629,12 @@ zm meetings prepare <series-id> [options]
|---|---|
| `--context-source <id=cursor>` | authorized communications selection ID, optionally ID=cursor; repeat. Default: ``. |
| `--context-query <words>` | literal words to find within the selected communications. |
| `--context-since-time <time>` | communications window start as zoned ISO timestamp (default fourteen days before end). |
| `--context-before-time <time>` | exclusive communications end as zoned ISO timestamp (default preparation start). |
| `--context-since-time <time>` | communications window start, an ISO date or time or 7d ago (default fourteen days before end). |
| `--context-before-time <time>` | exclusive communications end, an ISO date or time (default preparation start). |
| `--project <project>` | include unconfirmed word evidence for one existing project name, key or alias. |
| `--since-time <time>` | window start as ISO timestamp with zone (default now). |
| `--before-time <time>` | exclusive window end as ISO timestamp (default seven days after start). |
| `--history-since-time <time>` | history start as ISO timestamp (default thirty days before start). |
| `--since-time <time>` | window start, an ISO date or time, local without a zone (default now). |
| `--before-time <time>` | exclusive window end, an ISO date or time; a date alone covers that day (default seven days after start). |
| `--history-since-time <time>` | history start, an ISO date or time or 30d ago (default thirty days before start). |
| `--meetings <n>` | prior occurrences and separate related-meeting limit, 1–20 (default 5). |
| `--cues <n>` | cues per occurrence, 1–100 (default 10). |
| `--context-limit <n>` | entries per context category, 1–100 (default 20). |
Expand Down Expand Up @@ -892,18 +868,13 @@ the owner's stored events
list stored events

```sh
zm events list [query] [options]
zm events list [query]
```

| Argument | | What it is |
|---|---|---|
| `query` | optional | event id, origin or time fields that narrow the list. |

| Option | What it does |
|---|---|
| `--json` | one JSON value. |
| `--jsonl` | one JSON object per item. |

**Returns:** event — id, event_series_id, title, description, location, starts_at, ends_at, timezone, and 13 more; every field: zm commands info events list

**Example:** `zm personal events list --json`
Expand Down Expand Up @@ -1727,7 +1698,7 @@ zm search meetings <query> [options]
| `--topic-name <name>` | meetings with this topic, by name or alias. |
| `--since-time <time>` | meetings starting at or after this ISO 8601 date or time, or 30m, 2h, 7d ago. |
| `--until-time <time>` | meetings starting at or before this ISO 8601 date or time; a date alone covers that whole local day. |
| `--limit <n>` | how many hits, 1 through 1000 (default 100). |
| `--limit <n>` | how many hits, 1 through 1000; the profile's defaults.limit when absent. |
| `--cursor <cursor>` | continue from the previous page's page.next_cursor, with the same query and filters. |
| `--max-read-bytes <bytes>` | most stored bytes to read, 1 through 67108864 (default 4194304). |
| `--model <model>` | rank words and meaning together with this embedding model, building missing vectors first. |
Expand Down Expand Up @@ -1915,7 +1886,7 @@ zm searches create <name> <query> [options]
| `--topic-name <name>` | meetings with this topic, by name or alias. |
| `--since-time <time>` | meetings starting at or after this ISO 8601 date or time, or 30m, 2h, 7d ago. |
| `--until-time <time>` | meetings starting at or before this ISO 8601 date or time; a date alone covers that whole local day. |
| `--limit <n>` | how many hits, 1 through 1000 (default 100). |
| `--limit <n>` | how many hits, 1 through 1000; the profile's defaults.limit when absent. |
| `--max-read-bytes <bytes>` | most stored bytes to read, 1 through 67108864 (default 4194304). |
| `--model <model>` | rank words and meaning together with this embedding model, building missing vectors first. |
| `--base-url <url>` | remote embedding service for --model; OpenAI reads OPENAI_API_KEY. |
Expand Down
22 changes: 1 addition & 21 deletions docs/dev/test-matrix.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ ran it · ⛔ not tested offline, with the reason and where it is checked instea
Measured from the test run (`coverage/argv.jsonl`), not searched for — see
[TESTING.md](TESTING.md) for how, and for the states and failures that cut across commands.

**371 ✅ · 23 ⛔ · 0 ❌** — 97 commands, 297 options.
**351 ✅ · 23 ⛔ · 0 ❌** — 97 commands, 277 options.

| Command | Option | | Note |
|---|---|---|---|
Expand Down Expand Up @@ -54,47 +54,29 @@ Measured from the test run (`coverage/argv.jsonl`), not searched for — see
| `config migrate` | | ✅ | |
| `app` | | ✅ | |
| `meetings list` | | ✅ | |
| `meetings list` | `--json` | ✅ | |
| `meetings list` | `--jsonl` | ✅ | |
| `meetings list` | `--backend` | ⛔ | cli-core 0.660.0 src/store/meetings-read-through.test.ts drives archive, server and both on a shared source |
| `meetings list` | `--limit` | ✅ | |
| `meetings list` | `--page` | ✅ | |
| `meetings show` | | ✅ | |
| `meetings show` | `--json` | ✅ | |
| `meetings show` | `--jsonl` | ✅ | |
| `meetings show` | `--backend` | ⛔ | cli-core 0.660.0 src/store/meetings-read-through.test.ts drives archive, server and both on a shared source |
| `meetings transcript` | | ✅ | |
| `meetings transcript` | `--history` | ✅ | |
| `meetings transcript` | `--json` | ✅ | |
| `meetings transcript` | `--jsonl` | ✅ | |
| `meetings summary` | | ✅ | |
| `meetings summary` | `--json` | ✅ | |
| `meetings summary` | `--jsonl` | ✅ | |
| `meetings export` | | ✅ | |
| `meetings export` | `--format` | ✅ | |
| `meetings export` | `--transcript-id` | ✅ | |
| `meetings export` | `--output` | ✅ | |
| `meetings export` | `--json` | ✅ | |
| `meetings export` | `--jsonl` | ✅ | |
| `meetings people` | | ✅ | |
| `meetings people` | `--json` | ✅ | |
| `meetings people` | `--jsonl` | ✅ | |
| `meetings people` | `--limit` | ✅ | |
| `meetings people` | `--scan-limit` | ✅ | |
| `meetings people` | `--max-read-bytes` | ✅ | |
| `meetings people` | `--cursor` | ✅ | |
| `meetings sync` | | ✅ | |
| `meetings sync` | `--json` | ✅ | |
| `meetings sync` | `--jsonl` | ✅ | |
| `meetings sync` | `--since-time` | ✅ | |
| `meetings sync` | `--lookback-days` | ✅ | |
| `meetings sync` | `--rescan` | ✅ | |
| `meetings import` | | ✅ | |
| `meetings import` | `--json` | ✅ | |
| `meetings import` | `--jsonl` | ✅ | |
| `meetings repair` | | ✅ | |
| `meetings repair` | `--json` | ✅ | |
| `meetings repair` | `--jsonl` | ✅ | |
| `meetings repair` | `--yes` | ✅ | |
| `meetings scheduled` | | ✅ | |
| `meetings scheduled` | `--since-time` | ✅ | |
Expand Down Expand Up @@ -182,8 +164,6 @@ Measured from the test run (`coverage/argv.jsonl`), not searched for — see
| `meetings embeddings` | `--yes` | ✅ | |
| `meetings status` | | ✅ | |
| `events list` | | ✅ | |
| `events list` | `--json` | ✅ | |
| `events list` | `--jsonl` | ✅ | |
| `commands` | | ✅ | |
| `commands info` | | ✅ | |
| `store info` | | ✅ | |
Expand Down
6 changes: 3 additions & 3 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@wirecat/zoom-cli",
"version": "0.75.0",
"version": "0.76.0",
"description": "Zoom cloud recording archives, persistent transcripts and meeting tools",
"mcpName": "dev.wirecat/zoom-cli",
"license": "Apache-2.0",
Expand Down Expand Up @@ -64,8 +64,8 @@
"package:check": "node scripts/package-check.ts"
},
"dependencies": {
"@wirecat/cli-base": "0.99.0",
"@wirecat/cli-core": "0.662.0",
"@wirecat/cli-base": "0.100.0",
"@wirecat/cli-core": "0.663.0",
"commander": "15.0.0",
"valibot": "1.5.0"
},
Expand Down
24 changes: 12 additions & 12 deletions pnpm-lock.yaml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading
Loading