@wavyx/pdcli 0.6.0 → 0.8.0

package/CHANGELOG.md

@@ -4,6 +4,77 @@ All notable changes to `pdcli` are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/); versions follow
 [SemVer](https://semver.org/).
 
+## [0.8.0] - 2026-06-05
+
+### Added
+
+- `person merge <id> --into <survivor>` and `org merge <id> --into <survivor>`
+  — fold duplicate records via Pipedrive's native merge. The positional id is
+  the losing record (deleted); the confirmation names both records and
+  defaults to No. `--yes` skips the prompt for scripts.
+- `funnel --exact` — mines real stage transitions from each deal's changelog
+  instead of approximating from final stages. Stage entry is derived from the
+  transition graph, so deals created mid-funnel count only the stages they
+  actually entered. Failed changelog fetches are skipped with a warning.
+  Machine output is `{ rows, won }`.
+- `metrics coverage` — open pipeline vs the revenue still needed for quota.
+  The classic 3x rule drives the verdict on raw pipeline value; a
+  probability-weighted coverage ratio is reported alongside. Quota comes from
+  active revenue goals (Goals API) or `--target`. Goals in mixed currencies
+  refuse to sum (exit 64).
+- `alias set/list/unset` — user-defined command shortcuts, expanded by the
+  command-not-found hook. Cycles, self-references, topic shadowing, and
+  dotted names are rejected at write time; runtime expansion is guarded
+  against cycles and runaway depth. Destructive payloads warn at set time.
+- `--resolve-fields` — opt-in resolution of custom-field hash keys to names
+  (and option ids to labels) in JSON/yaml/csv output of single-record get
+  commands. Duplicate field names disambiguate instead of clobbering.
+- `audit` duplicate-orgs now also reports fuzzy near-matches
+  (Jaro-Winkler 0.92+) with original org names and a score, tagged
+  `kind: "fuzzy"`.
+- `config unset <key>`; `config set default_output` validates its value.
+- `lead label list` and `file remote-link` (link a Google Drive file to a
+  deal, person, or organization).
+- Animated terminal demo in the README; CONTRIBUTING guide (repo + docs site).
+
+### Changed
+
+- **audit output contract:** duplicate-orgs items now carry a `kind` field
+  (`exact` | `fuzzy` | `note`); fuzzy items use `names` (plural) and `score`.
+  The per-check `count` counts findings only (informational notes excluded)
+  and now includes fuzzy matches — consumers gating on duplicate-orgs counts
+  should account for the new kinds.
+- Aborting a confirmation prompt with Ctrl-C or a closed stdin now exits
+  cleanly as "Aborted" instead of an internal error.
+
+## [0.7.0] - 2026-06-05
+
+### Added
+
+- `default_output` profile config key is now honored: set
+  `pdcli config set default_output json` and every command (including
+  error output) defaults to that format when no `--output` flag is given.
+  An explicit flag still wins; invalid stored values fall back to the
+  table-in-TTY / JSON-when-piped default.
+- Docs website redesigned with the "Clarity" design system: new landing
+  page (animated terminal, quickstart, feature grid, live CLI stats),
+  light-first theme with dark mode, custom header/footer, social cards,
+  and brand fonts (Plus Jakarta Sans + JetBrains Mono) across all pages.
+- Homepage stats (version, command/topic/format counts) are generated
+  from the CLI manifest at docs-build time so they can never drift.
+
+### Fixed
+
+- Command-reference, config, and exit-code tables on the docs site
+  rendered as raw pipe characters; all GFM tables now render properly.
+- Documentation corrected against the implementation: autocomplete
+  shells, exit-code 64 semantics, JSON error-output trigger, rate-limit
+  header behavior, `--company`/`--api-token` flag scoping, and the
+  audit `--verbose` example.
+- Accessibility on the docs site: theme-toggle labeling, decorative
+  terminal/SVG content hidden from screen readers, heading hierarchy,
+  and WCAG AA contrast for footer and small-text elements.
+
 ## [0.6.0] - 2026-06-04
 
 ### Added
@@ -16,7 +87,7 @@ All notable changes to `pdcli` are documented here. Format follows
   `llms-small.txt`.
 - Native tarballs (linux x64/arm64, macOS x64/arm64, Windows x64) attached
   to every GitHub Release for non-npm installs.
-- Shell completion docs (`pdcli autocomplete bash|zsh|fish`).
+- Shell completion docs (`pdcli autocomplete bash|zsh|powershell`).
 - `bin/dev.js` development runner (no manifest cache).
 
 ## [0.5.0] - 2026-06-04
@@ -100,7 +171,7 @@ All notable changes to `pdcli` are documented here. Format follows
   pagination and `--limit`.
 - Custom-field discovery and resolution: `field list/get` plus automatic
   name/label resolution in table output.
-- Global `search` (itemSearch).
+- Global `search` (itemSearch) and `user me` (v1 users endpoint).
 - Host-locked raw escape hatch: `pdcli api <METHOD> <path>` (v1 + v2).
 - `doctor` diagnostics and `version`.
 - Dual-API client: token-budget-aware 429 backoff, 429→403 hard stop,

package/README.md

@@ -4,6 +4,10 @@
 [![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)
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/wavyx/pdcli/main/docs/demo.svg" alt="pdcli demo — running pipeline health and a winning deal update" width="720">
+</p>
+
 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.
@@ -74,9 +78,12 @@ pdcli person import people.csv                         # custom fields by name
 ```bash
 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)
+pdcli metrics coverage --target 500000   # weighted pipeline vs quota — the 3x coverage rule
 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
+pdcli person merge 123 --into 456        # fold a duplicate into the survivor (deletes 123)
 ```
 
 ## Files, webhooks, backup
@@ -93,6 +100,7 @@ pdcli backup --dir ./pipedrive-backup    # full account → JSON tree, --resume
 ```bash
 pdcli api GET /api/v2/pipelines          # raw, host-locked to YOUR domain
 pdcli api POST /api/v2/deals --body '{"title":"Raw deal"}'
+pdcli alias set wd "deal list --status won"   # save a shortcut, then run: pdcli wd
 pdcli doctor                             # diagnose auth/keychain/connectivity
 ```