polish: overhaul CLI, README, CHANGELOG, and crate metadata for publishing

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: mivertowski

CHANGELOG.md

@@ -9,26 +9,45 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [2.0.0] - 2026-03-30
 
+Major version — SDK rewritten to align with the new Rust-based VynCo API.
+
 ### Added
 
-- 6 new resource modules (22 endpoints): auditors, dashboard, screening, watchlists, webhooks, exports, ai
-- 9 new resource modules (41 endpoints): api_keys, credits, teams, billing, changes, persons, analytics, dossiers, graph
-- 8 new company sub-endpoints: statistics, compare, news, reports, relationships, hierarchy, fingerprint, nearby
-- `Client::request_bytes()` for binary file downloads
-- `ExportFile` type for downloaded export data
+- **18 resource modules** covering 69 endpoints:
+  - `companies` — list, get, count, events, statistics, compare, news, reports, relationships, hierarchy, fingerprint, nearby
+  - `auditors` — history, tenures
+  - `dashboard` — get
+  - `screening` — screen
+  - `watchlists` — list, create, delete, companies, add_companies, remove_company, events
+  - `webhooks` — list, create, update, delete, test, deliveries
+  - `exports` — create, get, download
+  - `ai` — dossier, search, risk_score
+  - `api_keys` — list, create, revoke
+  - `credits` — balance, usage, history
+  - `billing` — create_checkout, create_portal
+  - `teams` — me, create, members, invite_member, update_member_role, remove_member, billing_summary
+  - `changes` — list, by_company, statistics
+  - `persons` — board_members
+  - `analytics` — statistics, cantons, auditors, cluster, anomalies, rfm_segments, cohorts, candidates
+  - `dossiers` — create, list, get, delete
+  - `graph` — get, export, analyze
+  - `health` — check
+- `Client::request_bytes()` for binary file downloads (exports, graph XML)
+- `ExportFile` type for downloaded export data with content-type and filename
 - Company events via `companies().events(uid, limit)` (CloudEvents format)
-- `ErrorBody.instance` field (RFC 7807)
-
-### Changed
-
-- Base URL: `https://api.vynco.ch/api/v1` → `https://api.vynco.ch`
-- Serde: Dropped `rename_all = "camelCase"` — API uses snake_case natively
-- `HealthResponse`: now `status`, `database`, `redis`, `version` (was `status`, `uptime`, `checks`)
-- `Company`: removed `address`, `purpose`; added `share_capital`, `industry`; fields now `Option<String>`
-- `PagedResponse<T>`: `total_count: u64` → `total: i64`, `page_size: u32` → `page_size: i64`
-- `CompanyListParams`: removed `status`, `auditor_category`, `sort_by`, `sort_desc`, `target_status`; added `changed_since`; page types i64
-- `ErrorBody`: `detail: String` → `Option<String>`; removed `message`; added `instance: Option<String>`
-- Companies `count()` no longer takes params
+- Network graph and analysis endpoints
+- Sanctions screening against SECO, FINMA, OpenSanctions
+- AI-powered dossier generation, natural language search, multi-signal risk scoring
+
+### Changed (from v1.0.0)
+
+- **Base URL**: `https://api.vynco.ch/api/v1` → `https://api.vynco.ch`
+- **`Company`**: fields now `Option<String>`; added `share_capital`, `industry`; removed `address`, `purpose`
+- **`Company` + `PagedResponse<T>`**: now use `#[serde(rename_all = "camelCase")]`
+- **`PagedResponse<T>`**: `total_count: u64` → `total: i64`
+- **`HealthResponse`**: now `status`, `database`, `redis`, `version` (was `status`, `uptime`, `checks`)
+- **`ErrorBody`**: `detail` is now `Option<String>`; removed `message`; added `instance`
+- **`ResponseMeta`**: fixed `X-RateLimit-Limit` header name (was `X-Rate-Limit-Limit`)
 
 ### Removed
 

CLAUDE.md

@@ -64,8 +64,8 @@ cargo test -- --nocapture      # Run tests with stdout visible
 
 ### Serde Conventions
 
-- `#[serde(rename_all = "camelCase")]` on `Company` and `PagedResponse<T>` (API returns camelCase for these types)
-- Other response types use snake_case natively (no `rename_all` needed)
+- `#[serde(rename_all = "camelCase")]` on all API response types (Company, PagedResponse, and all new v2 types)
+- Request parameter types use snake_case (no rename_all) since query params are built manually
 - `#[serde(default)]` on fields that may be absent
 - `#[serde(skip_serializing_if = "Option::is_none")]` on optional request params
 

Cargo.lock

@@ -18,7 +18,6 @@ exclude = ["docs/", "CLAUDE.md"]
 reqwest = { version = "0.12", default-features = false, features = ["json", "rustls-tls"] }
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
-chrono = { version = "0.4", features = ["serde"] }
 thiserror = "2"
 tokio = { version = "1", features = ["rt-multi-thread", "macros"] }
 

Cargo.toml

@@ -5,10 +5,7 @@
 [![CI](https://github.com/VynCorp/vc-rust/actions/workflows/ci.yml/badge.svg)](https://github.com/VynCorp/vc-rust/actions/workflows/ci.yml)
 [![License: Apache-2.0](https://img.shields.io/crates/l/vynco.svg)](LICENSE)
 
-Rust SDK for the [VynCo](https://vynco.ch) Swiss Corporate Intelligence API.
-
-Access 500,000+ Swiss companies with event tracking, sanctions screening, AI-powered analysis,
-watchlists, webhooks, and bulk data exports.
+Rust SDK for the [VynCo](https://vynco.ch) Swiss Corporate Intelligence API. Access 500,000+ Swiss companies from the commercial register with change tracking, sanctions screening, AI-powered risk analysis, network graphs, watchlists, webhooks, and bulk data exports.
 
 ## Installation
 
@@ -31,8 +28,7 @@ use vynco::{Client, CompanyListParams};
 
 #[tokio::main]
 async fn main() -> Result<(), vynco::VyncoError> {
-    let client = Client::builder("vc_live_your_api_key")
-        .build()?;
+    let client = Client::builder("vc_live_your_api_key").build()?;
 
     // List companies with filtering
     let params = CompanyListParams {
@@ -42,34 +38,27 @@ async fn main() -> Result<(), vynco::VyncoError> {
     };
     let resp = client.companies().list(&params).await?;
     println!("Found {} companies", resp.data.total);
-    println!("Credits used: {:?}", resp.meta.credits_used);
 
-    // Get company by UID
+    // Get a single company
     let company = client.companies().get("CHE-105.805.080").await?;
     println!("{}: {:?}", company.data.name, company.data.legal_form);
 
     // Sanctions screening
     let screening = client.screening().screen(&vynco::ScreeningRequest {
-        name: "Novartis AG".into(),
-        uid: None,
-        sources: None,
+        name: "Suspicious Corp".into(), uid: None, sources: None,
     }).await?;
-    println!("Risk level: {}", screening.data.risk_level);
+    println!("Risk: {} ({} hits)", screening.data.risk_level, screening.data.hit_count);
 
     // AI risk score
     let risk = client.ai().risk_score(&vynco::RiskScoreRequest {
         uid: "CHE-105.805.080".into(),
     }).await?;
-    println!("Risk score: {}/100", risk.data.overall_score);
+    println!("Risk score: {}/100 ({})", risk.data.overall_score, risk.data.risk_level);
 
     // Credit balance
     let credits = client.credits().balance().await?;
     println!("Credits remaining: {}", credits.data.balance);
 
-    // Team info
-    let team = client.teams().me().await?;
-    println!("Team: {} ({})", team.data.name, team.data.tier);
-
     Ok(())
 }
 ```
@@ -147,6 +136,10 @@ cargo run --example vynco_cli -- screen "Test Corp"                # Sanctions s
 cargo run --example vynco_cli -- dashboard                         # Admin dashboard
 cargo run --example vynco_cli -- auditors --min-years 10 --canton ZH  # Long-tenure auditors
 cargo run --example vynco_cli -- risk CHE-105.805.649              # AI risk score
+cargo run --example vynco_cli -- fingerprint CHE-105.805.649       # Company data fingerprint
+cargo run --example vynco_cli -- graph CHE-105.805.649             # Network graph
+cargo run --example vynco_cli -- dossier CHE-105.805.649           # Generate AI dossier
+cargo run --example vynco_cli -- compare CHE-105.805.649 CHE-109.340.740  # Compare companies
 cargo run --example vynco_cli -- credits                           # Credit balance
 cargo run --example vynco_cli -- team                              # Team info
 cargo run --example vynco_cli -- changes --page 1 --page-size 10  # Recent SOGC changes