@wavyx/pdcli 0.9.0 → 0.11.0

package/CHANGELOG.md

@@ -4,6 +4,79 @@ All notable changes to `pdcli` are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/); versions follow
 [SemVer](https://semver.org/).
 
+## [0.11.0] - 2026-06-06
+
+### Added
+
+- Custom-field lifecycle: `field create/update/delete` plus
+  `field option add/remove` for enum/set fields (v2 Fields write API).
+  Deleting a field or option confirms with a default of No — record
+  data stored in it is lost. `field list/get` now also cover `lead`
+  and `note` fields.
+- Relations: `deal participant list/add/remove` (the buying
+  committee), `deal/person/org follower list/add/remove`, and
+  `org relationship list/add/remove` (parent/related hierarchies).
+- `task list/get/create/update/delete` — v2-native project tasks
+  (requires the Projects add-on; accounts without it get a clean
+  configuration error).
+- Conversions: `lead convert <id>` and `deal convert <id>` (async jobs
+  with `--wait` polling and `--timeout-secs`). Converting a deal
+  deletes the source deal on success and confirms with a default of
+  No.
+- `deal summary` — server-side per-currency totals, weighted values,
+  and counts in a single call (`--status/--pipeline/--stage/--filter`).
+- Scoped search: a single `--item-types` value routes `search` to the
+  per-entity v2 endpoints; the deal scope adds
+  `--status/--person/--org` filters.
+- `deal list --archived` and `project list --archived`.
+- `activity type list` (the `key_string` column feeds
+  `activity --type`), `file update/delete`, `filter delete`, and
+  `note comment list/add/update/delete`.
+
+### Changed
+
+- Every destructive command added in this release confirms with a
+  default of No — pressing Enter aborts.
+
+## [0.10.0] - 2026-06-06
+
+### Added
+
+- `deal product list/add/update/remove` — line items on deals at last.
+  Cursor-paginated listing with sort options; `add` takes `--product`,
+  `--price`, and `--quantity` (default 1) plus discount/tax/comments;
+  amounts are validated client-side (exit 64 on garbage). No
+  `--duration` flag: product durations were retired by Pipedrive in
+  2024 in favor of billing frequencies.
+- `user list` and `user find <term>` (`--by-email` for exact lookups) —
+  every `--owner <id>` flag in the CLI is finally usable without
+  copying ids out of the web app.
+- List power-params on `deal`, `person`, `org`, `activity`, and
+  `product` lists: `--filter <saved-filter-id>`, `--ids` (max 100),
+  `--sort-by`/`--sort-direction`, `--updated-since`/`--updated-until`
+  where the endpoint supports them. `--ids` and `--filter` are mutually
+  exclusive — the API silently ignores ids when a filter is present.
+- `deal history <id>` — field-change audit trail, newest-first, with
+  `--field` filtering and `--resolve-fields` rendering custom-field
+  names and option labels.
+- `webhook create --event-object` accepts the six v2 object types added
+  for projects and line items (project, task, board, phase,
+  deal_product, deal_installment).
+- Daily-budget awareness: a 429 with `x-daily-ratelimit-token-remaining: 0`
+  fails fast with a clear message instead of backing off blindly;
+  `--verbose` logs the remaining daily token budget on every request.
+
+### Changed
+
+- List page size raised from 100 to 500 rows per request (the v2
+  maximum) — large pulls use 5x fewer requests and rate-limit tokens.
+
+### Fixed
+
+- `activity list --type` never worked against the live API (the v2
+  endpoint rejects a `type` query parameter); the flag now filters
+  client-side.
+
 ## [0.9.0] - 2026-06-05
 
 ### Changed

package/README.md

@@ -42,6 +42,8 @@ pdcli note list --deal 42
 pdcli pipeline list && pdcli stage list --pipeline 1
 pdcli search "acme"
 pdcli field list deal           # custom fields with their hash keys
+pdcli user list                 # resolve owner IDs to names
+pdcli deal history 42           # field-change audit trail: who changed what, when
 ```
 
 Output everywhere: `--output table|json|yaml|csv`, `--jq '<expr>'`, `--fields id,name`.
@@ -53,6 +55,7 @@ pdcli deal create --title "Acme renewal" --value 5000 --currency EUR --stage 3
 pdcli deal update 42 --status won
 pdcli activity create --subject "Follow up" --type call --due-date 2026-06-10 --deal 42
 pdcli product create --name "Consulting" --price 150 --currency EUR
+pdcli lead convert <id> --wait  # promote a lead to a deal; --wait polls the async job
 pdcli deal delete 42            # asks first; --yes to skip
 ```
 
@@ -61,6 +64,17 @@ Custom fields by **human name** — labels and option IDs resolve automatically:
 ```bash
 pdcli deal create --title "Sized" --field "Deal Size=Large" --field "Score=4.5"
 pdcli deal update 42 --body '{"probability":75}'   # raw JSON escape hatch
+pdcli field create deal --name "Budget" --type double   # manage the field schema itself
+```
+
+## Line items & relations
+
+```bash
+pdcli deal product add 42 --product 10 --price 150 --quantity 4   # attach a product to a deal
+pdcli deal product list 42                                        # lines, with server-computed sums
+pdcli deal participant add 42 --person 10                         # add to the buying committee
+pdcli deal follower add 42 --user 5                               # follow a deal/person/org
+pdcli org relationship add --type parent --owner 1481 --linked 1480  # org hierarchy
 ```
 
 ## Bulk
@@ -76,6 +90,7 @@ pdcli person import people.csv                         # custom fields by name
 ## Analytics & housekeeping
 
 ```bash
+pdcli deal summary --status open         # server-side per-currency totals, weighted, count
 pdcli metrics velocity --period 90d      # the Sales Velocity Equation, in your terminal
 pdcli funnel --pipeline 1                # stage-to-stage conversion
 pdcli funnel --exact                     # mine real stage transitions per deal (one call each)