Add CI/CD workflows and polish README/CHANGELOG for crates.io

- Add GitHub Actions CI workflow (test on stable + MSRV 1.83, clippy,
  fmt, doc build, package check)
- Add publish workflow triggered on version tags (verify, publish to
  crates.io, create GitHub release)
- Polish README with badges, API coverage table with credit costs,
  feature flags table, MSRV section
- Clean up CHANGELOG with link references
- Add crates.io metadata to Cargo.toml (keywords, categories, homepage,
  documentation, exclude docs/ and CLAUDE.md from package)
- Run cargo fmt on all source files

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

Author: mivertowski

.github/workflows/ci.yml

@@ -0,0 +1,73 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  CARGO_TERM_COLOR: always
+  RUSTFLAGS: -Dwarnings
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        rust: [stable, "1.83"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@master
+        with:
+          toolchain: ${{ matrix.rust }}
+      - uses: Swatinem/rust-cache@v2
+      - name: Install libssl-dev
+        run: sudo apt-get update && sudo apt-get install -y libssl-dev
+      - run: cargo test --all-features
+
+  clippy:
+    name: Clippy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+      - uses: Swatinem/rust-cache@v2
+      - name: Install libssl-dev
+        run: sudo apt-get update && sudo apt-get install -y libssl-dev
+      - run: cargo clippy --all-features -- -D warnings
+
+  fmt:
+    name: Format
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt
+      - run: cargo fmt --check
+
+  doc:
+    name: Documentation
+    runs-on: ubuntu-latest
+    env:
+      RUSTDOCFLAGS: -Dwarnings
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - name: Install libssl-dev
+        run: sudo apt-get update && sudo apt-get install -y libssl-dev
+      - run: cargo doc --no-deps --all-features
+
+  package:
+    name: Package
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo package

.github/workflows/publish.yml

@@ -0,0 +1,48 @@
+name: Publish to crates.io
+
+on:
+  push:
+    tags:
+      - "v*"
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  verify:
+    name: Verify
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo test --all-features
+      - run: cargo clippy --all-features -- -D warnings
+      - run: cargo fmt --check
+      - run: cargo package
+
+  publish:
+    name: Publish
+    needs: verify
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo publish
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
+
+  release:
+    name: GitHub Release
+    needs: publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          TAG_NAME: ${{ github.ref_name }}
+        run: gh release create "$TAG_NAME" --generate-notes --title "$TAG_NAME"

CHANGELOG.md

@@ -7,65 +7,63 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [1.0.0] - 2026-03-18
 
-### Breaking Changes
-
-- **Base URL** changed from `/v1` to `/api/v1` to match production API
-- **`PaginatedResponse`** field renamed: `total` → `total_count`
-- **`Company`** model restructured: removed `legal_seat`, `capital_nominal`, `capital_currency`, `auditor_name`, `registration_date`, `deletion_date`, `data_source`, `last_modified`; added `address`, `auditor_category`, `created_at`, `updated_at`
-- **`Person`** model simplified: `first_name`/`last_name` → `name`, `roles` is now `Vec<String>`, added `companies: Vec<String>`
-- **`Dossier`** model restructured: removed `id`, `status`, `executive_summary`, `key_insights`, `risk_factors`; added `company_name`, `summary`, `risk_score`
-- **`GenerateDossierRequest`** field renamed: `level` → `dossier_type` (serialized as `"type"`)
-- **Dossier generation** path changed from `POST /dossiers` to `POST /dossiers/{uid}/generate`
-- **`ApiKeyInfo`** renamed to `ApiKey` with simplified fields; `ApiKeyCreated.raw_key` → `key`
-- **`CreateApiKeyRequest`** simplified: removed `permissions`, `is_test` → `is_test_key`
-- **`UsageBreakdown.period`** changed from `Option<UsagePeriod>` to `Option<String>`; removed `UsagePeriod` and `UsageOperation.count`
-- **Billing types** unified: `CheckoutSessionResponse`/`PortalSessionResponse` → `SessionUrlResponse`; billing methods now take `CheckoutRequest` instead of `&str`
-- **Billing paths** changed: `/billing/checkout` → `/billing/checkout-session`, `/billing/portal` → `/billing/portal-session`
-- **`CreateTeamRequest`** now includes optional `owner_email` and `owner_name`
-- **`Team`** now includes `updated_at`
-- **Companies resource**: `search()` renamed to `list()`, old `count()` now takes `CompanyCountParams` instead of `CompanySearchParams`
-- **Removed resources**: `webhooks()`, `users()`, `settings()` — not in final API spec
+First stable release, aligned with the VynCo OpenAPI 1.0.0 specification.
 
 ### Added
 
-- **7 new resource modules** with 23 new endpoints:
-  - `changes()` — `list`, `by_company`, `statistics`, `by_sogc`, `review`, `batch`
-  - `analytics()` — `cluster`, `anomalies`, `cohorts`, `cantons`, `auditors`, `rfm_segments`, `velocity`
-  - `watches()` — `list`, `create`, `remove`, `notifications`
-  - `news()` — `for_company`, `recent`
-  - `reports()` — `for_company`
-  - `relationships()` — `for_company`, `hierarchy`
-  - `health()` — `check`
-- **New company endpoints**: `search` (POST full-text), `batch` (multi-UID lookup), `compare` (side-by-side)
-- **Expanded persons**: `list`, `roles`, `connections`, `board_members`, `network_stats`
-- **Expanded dossiers**: `list`, `get`, `statistics`
-- **Expanded teams**: `members`, `invite_member`, `update_member_role`, `remove_member`, `billing_summary`
-- **New types**: `CompanyStatistics`, `CompanyRelationship`, `RelationshipResponse`, `CompanyWatch`, `CreateWatchRequest`, `ChangeNotification`, `TeamMember`, `InviteMemberRequest`, `UpdateMemberRoleRequest`, `BillingSummary`, `MemberUsage`, `CreditLedgerEntry`, `HealthResponse`, `HealthCheck`, `ChangeStatistics`, `ReviewChangeRequest`, `ReviewChangeResponse`, `BatchChangeRequest`, `CompanySearchRequest`, `BatchCompanyRequest`, `CompareCompaniesRequest`, `ClusterRequest`, `AnomalyRequest`, `CohortParams`, `CompanyNewsResponse`, `RecentNewsResponse`, `CompanyReportsResponse`
-- **`ErrorBody`** now includes `error_type` and `title` fields for RFC 7807 compliance
+- **7 new resource modules** (23 endpoints):
+  - `changes()` — list, by_company, statistics, by_sogc, review, batch
+  - `analytics()` — cluster, anomalies, cohorts, cantons, auditors, rfm_segments, velocity
+  - `watches()` — list, create, remove, notifications
+  - `news()` — for_company, recent
+  - `reports()` — for_company
+  - `relationships()` — for_company, hierarchy
+  - `health()` — check
+- **New company endpoints**: full-text search (POST), batch lookup, compare
+- **Expanded persons**: list, roles, connections, board_members, network_stats
+- **Expanded dossiers**: list, get, statistics
+- **Expanded teams**: members, invite_member, update_member_role, remove_member, billing_summary
 - **`VyncoError::Conflict`** variant for HTTP 409
-- **`ResponseMeta`** now includes `rate_limit_remaining` (`X-RateLimit-Remaining`) and `rate_limit_reset` (`X-RateLimit-Reset`)
-- **16 integration tests** covering all error variants, company endpoints, changes, health, API keys, credits, and response metadata
+- **RFC 7807 ProblemDetails** fields on `ErrorBody` (`error_type`, `title`)
+- **Rate limit headers** on `ResponseMeta` (`rate_limit_remaining`, `rate_limit_reset`)
+- **CI/CD** via GitHub Actions with automated crates.io publishing on tags
+
+### Changed
+
+- **Base URL**: `/v1` → `/api/v1`
+- **`PaginatedResponse`**: `total` → `total_count`
+- **`Company`** model: replaced `legal_seat`, `capital_nominal`, `capital_currency`, `auditor_name`, `registration_date`, `deletion_date`, `data_source`, `last_modified` with `address`, `auditor_category`, `created_at`, `updated_at`
+- **`Person`** model: simplified to `name`, `roles: Vec<String>`, `companies: Vec<String>`
+- **`Dossier`** model: now uses `company_name`, `summary`, `risk_score`
+- **`GenerateDossierRequest`**: `level` → `dossier_type` (serialized as `"type"`)
+- **Dossier generation path**: `POST /dossiers` → `POST /dossiers/{uid}/generate`
+- **`ApiKeyInfo`** → `ApiKey`; `ApiKeyCreated.raw_key` → `key`
+- **`CreateApiKeyRequest`**: simplified (removed `permissions`, `is_test` → `is_test_key`)
+- **Billing types**: unified `CheckoutSessionResponse`/`PortalSessionResponse` → `SessionUrlResponse`
+- **Billing paths**: `/billing/checkout` → `/billing/checkout-session`, `/billing/portal` → `/billing/portal-session`
+- **Companies resource**: `search()` → `list()`, `count()` now takes `CompanyCountParams`
+- **Tests**: expanded from 12 → 16 covering new endpoints and error variants
 
 ### Removed
 
-- `Webhooks` resource and related types (`Webhook`, `WebhookCreated`, `CreateWebhookRequest`, `UpdateWebhookRequest`)
-- `Users` resource and related types (`UserProfile`, `UpdateProfileRequest`)
-- `Settings` resource
-- `PersonRole` type (person roles are now `Vec<String>`)
-- `PersonSearchParams` type (replaced by `PersonListParams`)
-- `CompanySearchParams` type (replaced by `CompanyListParams` and `CompanyCountParams`)
-- `UsagePeriod` type
+- `webhooks()`, `users()`, `settings()` resources (not in final API)
+- Types: `Webhook`, `WebhookCreated`, `CreateWebhookRequest`, `UpdateWebhookRequest`, `UserProfile`, `UpdateProfileRequest`, `PersonRole`, `PersonSearchParams`, `CompanySearchParams`, `UsagePeriod`
 
 ## [0.1.0] - 2026-03-17
 
+Initial release (draft API).
+
 ### Added
 
-- **Async client** with builder pattern (`Client::builder(api_key).build()`)
-- **Blocking client** behind `blocking` feature flag for synchronous usage
-- **10 resource modules** covering the VynCo draft API
-- **Response metadata** via `Response<T>` wrapper exposing API headers
-- **Typed error handling** with `VyncoError` enum mapping HTTP status codes
-- **Automatic retry** with exponential backoff on 429 and 5xx responses
-- **Retry-After header** support for rate-limited requests
-- **TLS backend selection** via `rustls-tls` (default) or `native-tls` features
-- **12 integration tests** with mockito
+- Async client with builder pattern
+- Blocking client behind `blocking` feature flag
+- 10 resource modules (30 endpoints)
+- Response metadata wrapper (`Response<T>`) with 5 API headers
+- Typed error handling with `VyncoError` enum (7 HTTP status variants)
+- Automatic retry with exponential backoff on 429/5xx
+- Retry-After header support
+- TLS backend selection (rustls default, native-tls optional)
+- 12 integration tests with mockito
+
+[1.0.0]: https://github.com/VynCorp/vc-rust/compare/v0.1.0...v1.0.0
+[0.1.0]: https://github.com/VynCorp/vc-rust/releases/tag/v0.1.0

Cargo.toml

@@ -7,6 +7,12 @@ license = "Apache-2.0"
 authors = ["VynCo <hello@vynco.ch>"]
 description = "Rust SDK for the VynCo Swiss Corporate Intelligence API"
 repository = "https://github.com/VynCorp/vc-rust"
+homepage = "https://vynco.ch"
+documentation = "https://docs.rs/vynco"
+readme = "README.md"
+keywords = ["vynco", "swiss", "corporate", "zefix", "sdk"]
+categories = ["api-bindings", "web-programming::http-client"]
+exclude = ["docs/", "CLAUDE.md"]
 
 [dependencies]
 reqwest = { version = "0.12", default-features = false, features = ["json", "rustls-tls"] }