@wavyx/pdcli 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -4,6 +4,38 @@ All notable changes to `pdcli` are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/); versions follow
 [SemVer](https://semver.org/).
 
+## [0.6.0] - 2026-06-04
+
+### Added
+
+- Documentation site (Astro + Starlight) at wavyx.github.io/pdcli:
+  quickstarts (including a dedicated AI-agent quickstart), guides for every
+  feature area, automation recipes, concepts, and a command reference
+  generated from the CLI manifest.
+- Machine-readable docs for AI agents: `llms.txt`, `llms-full.txt`, and
+  `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`).
+- `bin/dev.js` development runner (no manifest cache).
+
+## [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

package/README.md

@@ -69,6 +69,16 @@ pdcli person import people.csv --dry-run               # CSV headers map to fiel
 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
@@ -88,6 +98,7 @@ pdcli doctor                             # diagnose auth/keychain/connectivity
 
 - `--output table|json|yaml|csv` everywhere; table in a TTY, JSON when piped.
 - Deterministic [sysexits](https://man.freebsd.org/cgi/man.cgi?query=sysexits) exit codes for scripting.
+- **Docs: [wavyx.github.io/pdcli](https://wavyx.github.io/pdcli)** — guides, cookbook, AI-agent quickstart, [`llms.txt`](https://wavyx.github.io/pdcli/llms.txt).
 - Full reference: [docs/commands.md](docs/commands.md) (generated from the CLI manifest).
 
 ## License

package/bin/dev.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { execute } from '@oclif/core'
+
+const envFile = resolve(process.cwd(), '.env')
+if (existsSync(envFile)) {
+  for (const line of readFileSync(envFile, 'utf8').split('\n')) {
+    const trimmed = line.trim()
+    if (!trimmed || trimmed.startsWith('#')) continue
+    const eq = trimmed.indexOf('=')
+    if (eq === -1) continue
+    const key = trimmed.slice(0, eq).trim()
+    const value = trimmed.slice(eq + 1).trim()
+    if (!process.env[key]) process.env[key] = value
+  }
+}
+
+await execute({ dir: import.meta.url })