Skip to content

feat: add install metadata fields to the install heartbeat - #69

Merged
wavekat-eason merged 1 commit into
mainfrom
feat/install-heartbeat-metadata
Oct 9, 2026
Merged

wavekat-eason merged 1 commit into
mainfrom
feat/install-heartbeat-metadata

Conversation

@wavekat-eason

@wavekat-eason wavekat-eason commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

Adds optional install-metadata fields to InstallHeartbeatFleet (flattened into the POST /api/voice/installs/heartbeat body). All follow the existing style — Option<…> with #[serde(default, skip_serializing_if = "Option::is_none")], camelCase on the wire — and absent means "not reported by this build", never "no"/zero.

Rust field Wire key Type
timezone timezone Option<String> — IANA zone, e.g. Pacific/Auckland (never city/IP-derived)
app_language appLanguage Option<String> — the app's UI language code (en, zh-Hans, pt-BR), can differ from system locale
sip_accounts_total sipAccountsTotal Option<u32>
sip_accounts_registered sipAccountsRegistered Option<u32>
sip_accounts_failed sipAccountsFailed Option<u32>
recording_enabled recordingEnabled Option<bool>
automation_enabled automationEnabled Option<bool>
transcription_ready transcriptionReady Option<bool>
signed_in signedIn Option<bool> — yes/no only, no identity
cpu_cores cpuCores Option<u32> — logical CPUs
memory_gb memoryGb Option<u32> — total RAM rounded to whole GB

Release-train note: the platform (wavekat-platform) must accept these keys before a consumer sends them; this crate needs a release before wavekat-voice can use them.

Related PRs

Review together; merge top to bottom.

# PR What
1 wavekat/wavekat.com#226 Privacy page describes the new install-count details; bumps the privacy date to 2026-10-08
2 wavekat/wavekat.com#229 wavekat.com release that deploys #226 (the site only deploys on release)
3 wavekat/wavekat-platform#375 DB migration 0090: nullable metadata columns on voice_installs / voice_clients
4 wavekat/wavekat-platform#376 API accepts and stores the new heartbeat fields; fleet page shows them; PRIVACY_VERSION 2026-10-08
5 #69 Client fields on InstallHeartbeatFleet
6 #70 Client release 0.0.35 to crates.io
7 wavekat/wavekat-voice#496 App sends the new fields

Tests

  • Existing regression: all-None fleet serializes to exactly the pre-fleet key set.
  • Full fleet (shared full_install_heartbeat_fleet() helper, every field set) serializes each new key in camelCase with the right JSON type, and round-trips.
  • New: full fleet produces exactly the expected camelCase key set.
  • New: a body with the older fleet keys but none of the new ones deserializes with the new fields None; the existing no-fleet-keys body still parses to the default.

cargo test (122 + 2 passed), cargo clippy --all-targets -- -D warnings, cargo fmt clean.

🤖 Generated with Claude Code

https://claude.ai/code/session_012shihqNTmmedv4ukxLjCFr

Adds optional timezone, appLanguage, SIP account counts (total /
registered / failed), recordingEnabled, automationEnabled,
transcriptionReady, signedIn, cpuCores and memoryGb to
InstallHeartbeatFleet. All additive: an all-None fleet still serializes
to the same key set, and older bodies without the keys still parse.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012shihqNTmmedv4ukxLjCFr
@wavekat-eason
wavekat-eason marked this pull request as ready for review October 9, 2026 10:21
@wavekat-eason
wavekat-eason merged commit 448c0b8 into main Oct 9, 2026
1 check passed
@wavekat-eason
wavekat-eason deleted the feat/install-heartbeat-metadata branch October 9, 2026 10:21
@github-actions github-actions Bot mentioned this pull request Oct 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant