Skip to content

v0.3.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 13 Jul 17:51
v0.3.0
7468ab6
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Umami Compass 0.3.0 — Traffic you can trust

Umami Compass 0.3.0 makes traffic investigations actionable: isolate direct visits, filter by channel, exclude known noise, and surface conservative referral-spam evidence without leaving the read-only analytics contract.

Important

The default read-only surface expands from 12 to 14 tools and the complete opt-in surface from 35 to 37. Restart the MCP process or client after upgrading so it can discover the new tools and capabilities.

Highlights

Channel-aware traffic analysis

  • Filter explain_traffic_change and analyze_release_impact by channel, including direct.
  • Isolate direct traffic with either referrer: "" or the structured is_empty operator.
  • Build bounded channel × dimension breakdowns such as channel by device in run_breakdown_report.
  • Include channel evidence automatically in traffic-change and release-impact explanations.

Human traffic and referral-spam signals

  • Detect suspicious referral domains conservatively from generated-looking hostnames, at least 90% bounce rate, at most two seconds average visit duration, and a minimum of three visits.
  • Return the evidence, thresholds, and confidence behind every referral-spam signal.
  • Apply the opt-in trafficSegment: "human" preset to exclude detected domains through native negative filters.
  • Connect referral-spam evidence to explain_traffic_change and tracking_health_check instead of returning only a generic causation caveat.

Note

Referral-spam detection is deliberately conservative and evidence-based. The human-traffic preset fails closed when traffic quality cannot be assessed for every required comparison period.

More expressive filters

  • Add equals, not_equals, contains, not_contains, regex, and not_regex operators.
  • Add is_empty and is_not_empty for direct and missing-value scenarios.
  • Accept arrays for native IN and NOT IN behavior, including path and referrer exclusions.

Faster investigations and capability discovery

  • Add compare_traffic_series for aligned current/baseline buckets, making the exact date of a traffic break visible.
  • Add get_server_info for local version, enabled toolsets, safety limits, and supported capabilities.
  • Preserve explicit truncation and incomplete-coverage metadata for bounded derived breakdowns.

Safety and data quality

  • All 37 tools remain read-only.
  • Human-traffic cleanup uses upstream negative referrer-domain filters; it does not mutate Umami data.
  • Derived channel cross-tabs are bounded to 50 candidate rows with four concurrent workers.
  • Incomplete candidate coverage and unavailable spam assessment are reported explicitly instead of being treated as complete data.

Upgrade

npx --yes --prefer-online umami-compass@latest

Pin this exact release when reproducibility matters:

npx --yes umami-compass@0.3.0

Restart the MCP process or client after upgrading.

Compatibility and verification

  • Umami Cloud and self-hosted Umami 3.2+.
  • Node.js 22 or newer.
  • 87 automated tests plus lint, typecheck, build, package smoke testing, and CI on Node.js 22, 24, and 26.
  • Packed-package verification covers CLI version, MCP initialization, and the 14-tool default surface.
  • npm publication includes SLSA provenance.

Release links

Assets 2
Loading