Skip to content

Kumo 0.0.6

Choose a tag to compare

@kumoappdev kumoappdev released this 14 May 12:12

Kumo 0.0.6 is an incremental release focused on making update discovery more reliable, improving the daily Overview experience, and documenting the new runtime update flow.

Important: Kumo is still at an early stage. Features and data formats may continue to evolve quickly across macOS environments and runtime setups. Keep backups of important profiles and settings, and treat this build as an early preview.

What changed since 0.0.5

Compared with 0.0.5, this release focuses on three practical tracks:

  1. Replacing APNs-dependent update discovery with app-local asynchronous polling.
  2. Making update notifications actionable and less noisy.
  3. Improving the Overview screen for daily proxy and traffic monitoring.

Highlights

Local update polling and notifications

Kumo now checks for app updates while the app is running, without requiring APNs, push tokens, or external push infrastructure.

  • Added a five-minute asynchronous release-manifest polling task owned by KumoAppStore.
  • Started update polling after the SwiftUI app attaches the live store, and cancelled polling when the app terminates.
  • Reused the same update-checking path for manual checks in About/Settings and background polling.
  • Kept manual checks user-visible while keeping background polling quiet: transient polling failures no longer overwrite the main UI error state, and background “up to date” results do not replace user-facing status text.

Actionable update notifications

Update notifications now provide a clearer path from discovery to installation.

  • Added update-available notifications with Install Now and Remind Me Later actions.
  • Added download/install progress notifications with replacement-style stage text.
  • Added restart-ready notifications with Restart Now.
  • Routed notification actions back into the existing in-app update installer flow.

Redesigned Overview experience

The Overview screen has been reworked around daily-use visibility: current profile context, live traffic, and proxy groups are easier to scan from the main window.

  • Added a proxy-node sidebar preview for the current profile while the core is stopped.
  • Added live proxy group rendering when the core is running.
  • Added richer Overview cards for profile, traffic, runtime state, and key actions.
  • Added a rolling traffic history buffer and expanded traffic sparkline for recent throughput.
  • Added proxy country detection/caching support so node lists can show region context when available.

Fixes and hardening

Fixed update discovery depending on unfinished APNs infrastructure

The previous update-notification direction registered for remote notifications, but the app did not have a complete APNs delivery path. Kumo now uses local runtime polling instead.

  • Removed remote-notification registration from the app launch path.
  • Removed stale APNs-oriented documentation claims.
  • Documented that update discovery is app-local and does not require APNs or a push token.

Reduced update notification spam

The five-minute polling loop is throttled so users are not repeatedly interrupted for the same release.

  • Update-available notifications are gated per version.
  • Remind Me Later removes the visible update notification and suppresses that version for six hours.
  • Newer versions are treated as fresh notification candidates.

Improved stopped-state Overview behavior

Overview no longer collapses into an empty proxy area just because the core is stopped.

  • Parsed configured proxy groups from the current profile YAML for stopped-state preview.
  • Kept live controller data as the source of truth once the core is running.
  • Added focused tests for profile node parsing and proxy country lookup behavior.

Documentation and tests

  • Added docs/operations/app-updates/ as the dedicated documentation home for app update polling, notifications, manifest checks, download verification, and installer handoff.
  • Updated release management docs to focus on release artifacts while linking runtime update behavior to the new App Updates docs.
  • Updated macOS SwiftUI interface docs for the new Overview and notification behavior.
  • Added/updated tests for profile node parsing, proxy country matching, and proxy geo lookup.
  • Verified the release build through the Makefile release artifact flow.

Assets

  • Kumo-macos-0.0.6-arm64.dmg
  • latest.yml

SHA-256 for the DMG:

af381b6d309624e707323e11b133277139e0ade894ffe2c20f2162c4174a702f