@wavyx/pdcli 0.3.0 → 0.5.0

package/CHANGELOG.md

@@ -4,6 +4,40 @@ All notable changes to `pdcli` are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/); versions follow
 [SemVer](https://semver.org/).
 
+## [0.5.0] - 2026-06-04
+
+### Added
+
+- `metrics velocity` — the Sales Velocity Equation ((open × win rate ×
+  avg won value) / cycle days) with all four levers, over a trailing
+  `--period` and optional `--pipeline`/`--owner` scope.
+- `funnel` — stage-to-stage conversion approximated from closed deals'
+  final stages, plus the current open distribution per stage.
+- `pipeline health` — per-stage snapshot: open count/value,
+  probability-weighted value, stale deals (>14d), deals without a next
+  step, deals past their close date.
+- `audit` — 11 data-hygiene checks (stale/ancient deals, missing fields,
+  duplicate persons by email, duplicate orgs by name, uncontactable
+  contacts, overdue pileups, …) with `--checks`, `--verbose`, and
+  `--strict` (exit 1 on must-severity findings — CI-able).
+
+## [0.4.0] - 2026-06-04
+
+### Added
+
+- `deal bulk-update` — update many deals at once by `--ids`, a Pipedrive
+  saved `--filter`, or ids piped on stdin. Paced sequentially inside the
+  rate-limit burst window, confirms before writing (`--yes` to skip),
+  `--dry-run` previews targets, partial failures are listed per deal and
+  exit 1.
+- `person import` / `org import` — bulk-create from CSV. Headers map to
+  fields, including custom fields by human name with option-label
+  resolution; `--dry-run` validates every row without writing.
+
+### Changed
+
+- CI actions bumped to checkout/setup-node v5.
+
 ## [0.3.0] - 2026-06-04
 
 ### Added

package/README.md

@@ -1,5 +1,9 @@
 # pdcli
 
+[![CI](https://github.com/wavyx/pdcli/actions/workflows/ci.yml/badge.svg)](https://github.com/wavyx/pdcli/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/wavyx/pdcli/branch/main/graph/badge.svg)](https://codecov.io/gh/wavyx/pdcli)
+[![npm](https://img.shields.io/npm/v/%40wavyx%2Fpdcli)](https://www.npmjs.com/package/@wavyx/pdcli)
+
 Command-line interface for [Pipedrive](https://www.pipedrive.com/) — fast, scriptable, built for terminals, CI pipelines, and AI agents.
 
 > Not affiliated with or endorsed by Pipedrive.
@@ -55,6 +59,26 @@ pdcli deal create --title "Sized" --field "Deal Size=Large" --field "Score=4.5"
 pdcli deal update 42 --body '{"probability":75}'   # raw JSON escape hatch
 ```
 
+## Bulk
+
+```bash
+pdcli deal bulk-update --filter 9 --stage 5            # saved filter → stage move
+pdcli deal bulk-update --ids 1,2,3 --status won --yes
+pdcli deal list --status open --jq '.[].id' | pdcli deal bulk-update --owner 42
+pdcli person import people.csv --dry-run               # CSV headers map to fields,
+pdcli person import people.csv                         # custom fields by name
+```
+
+## Analytics & housekeeping
+
+```bash
+pdcli metrics velocity --period 90d      # the Sales Velocity Equation, in your terminal
+pdcli funnel --pipeline 1                # stage-to-stage conversion
+pdcli pipeline health                    # per-stage value, weighted value, stale, no-next-step
+pdcli audit                              # 11 data-hygiene checks (duplicates, stale, gaps)
+pdcli audit --strict                     # exit 1 on must-severity findings — wire into CI
+```
+
 ## Files, webhooks, backup
 
 ```bash