release: prepare v4.25.0

rcourtman · rcourtman · commit f928becc84dc · 2025-10-22T10:46:18.000Z
diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-4.24.0
+4.25.0
diff --git a/deploy/helm/pulse/Chart.yaml b/deploy/helm/pulse/Chart.yaml
@@ -2,8 +2,8 @@ apiVersion: v2
 name: pulse
 description: Helm chart for deploying the Pulse hub and optional Docker monitoring agent.
 type: application
-version: 0.1.0
-appVersion: "4.24.0"
+version: 4.25.0
+appVersion: "4.25.0"
 icon: https://raw.githubusercontent.com/rcourtman/Pulse/main/docs/images/pulse-logo.svg
 keywords:
   - monitoring
diff --git a/docs/FAQ.md b/docs/FAQ.md
@@ -93,6 +93,8 @@ Yes! When you add one cluster node, Pulse automatically discovers and monitors a
 Reduce `metricsRetentionDays` in settings and restart
 
 ### How do I monitor adaptive polling?
+**New in v4.25.0:** The adaptive scheduler now exposes staleness scores, circuit breaker state, and per-resource poll metrics so you can trace why work was delayed.
+
 **New in v4.24.0:** Pulse includes adaptive polling that automatically adjusts polling intervals based on system load.
 
 **Monitor adaptive polling:**
@@ -111,7 +113,8 @@ Reduce `metricsRetentionDays` in settings and restart
 
 See [Adaptive Polling Documentation](monitoring/ADAPTIVE_POLLING.md) for complete details.
 
-### What's new about rate limiting in v4.24.0?
+### What's new about rate limiting in v4.25.0?
+**New in v4.25.0:** Adaptive polling metrics and circuit breaker states are now exposed alongside rate-limit headers, making throttling decisions easier to interpret.
 Pulse now returns standard rate limit headers with all API responses:
 
 **Response Headers:**
diff --git a/docs/INSTALL.md b/docs/INSTALL.md
@@ -107,6 +107,7 @@ systemctl status pulse-update.timer         # Check status
 - Creates backup before updating
 - Automatically rolls back if update fails
 - Logs all activity to systemd journal
+- **New in v4.25.0**: Adaptive monitoring now ships with circuit breakers, staleness tracking, and richer poll metrics while the Helm chart streamlines Kubernetes installs bundled with the binary.
 - **New in v4.24.0**: Rollback history is retained in Settings → System → Updates; use the new 'Restore previous version' button if the latest build regresses
 
 #### View Update Logs
@@ -138,7 +139,7 @@ docker run -d --name pulse -p 7655:7655 -v pulse_data:/data rcourtman/pulse:late
 
 ### Rollback to Previous Version
 
-**New in v4.24.0:** Pulse retains previous versions and allows easy rollback if an update causes issues.
+**New in v4.25.0:** Pulse retains previous versions and allows easy rollback if an update causes issues, now backed by detailed scheduler metrics so you can see why a rollback triggered.
 
 #### Via UI (Recommended)
 1. Navigate to **Settings → System → Updates**
@@ -187,7 +188,7 @@ curl -fsSL https://raw.githubusercontent.com/rcourtman/Pulse/main/install.sh | b
 
 ### Runtime Logging Configuration
 
-**New in v4.24.0:** Adjust logging settings without restarting Pulse.
+**New in v4.25.0:** Adjust logging settings without restarting Pulse; the structured logging subsystem now centralizes format, destinations, and rotation controls.
 
 #### Via UI
 Navigate to **Settings → System → Logging** to configure:
@@ -209,7 +210,7 @@ docker run -e LOG_LEVEL=debug -e LOG_FORMAT=json rcourtman/pulse:latest
 
 ### Adaptive Polling
 
-**New in v4.24.0:** Adaptive polling is now enabled by default, automatically adjusting polling intervals based on system load and responsiveness. Monitor status via **Settings → System → Monitoring** or the new Scheduler Health API at `/api/monitoring/scheduler/health`.
+**New in v4.25.0:** Adaptive polling now publishes staleness scores, circuit breaker states, and poll timings in `/api/monitoring/scheduler/health`, giving operators context when the scheduler slows down.
 
 ## Troubleshooting
 
diff --git a/docs/KUBERNETES.md b/docs/KUBERNETES.md
@@ -2,6 +2,8 @@
 
 Deploy Pulse to Kubernetes with the bundled Helm chart under `deploy/helm/pulse`. The chart provisions the Pulse hub (web UI + API) and can optionally run the Docker monitoring agent alongside it. Stable builds are published automatically to the GitHub Container Registry (GHCR) whenever a Pulse release goes out.
 
+> **New in v4.25.0:** The Helm chart is shipped with the release archives and pairs with the upgraded monitoring engine (staleness tracking, circuit breakers, detailed poll metrics) so Kubernetes clusters benefit from the same adaptive scheduling improvements as bare-metal installs.
+
 ## Prerequisites
 
 - Kubernetes 1.24 or newer with access to a default `StorageClass`
@@ -90,7 +92,7 @@ server:
       API_TOKENS: docker-agent-token
 ```
 
-### Runtime Logging Configuration (v4.24.0+)
+### Runtime Logging Configuration (v4.25.0+)
 
 Configure logging behavior via environment variables:
 
@@ -113,9 +115,9 @@ server:
 
 **Note:** Logging changes via environment variables require pod restart. Use **Settings → System → Logging** in the UI for runtime changes without restart.
 
-### Adaptive Polling Configuration (v4.24.0+)
+### Adaptive Polling Configuration (v4.25.0+)
 
-Adaptive polling is **enabled by default** in v4.24.0. Configure via environment variables:
+Adaptive polling is **enabled by default** in v4.25.0. Configure via environment variables:
 
 ```yaml
 server:
@@ -210,9 +212,9 @@ Notes:
 - **Rollback:** `helm rollback pulse <revision>`
 - **Uninstall:** `helm uninstall pulse -n pulse` (PVCs remain unless you delete them manually)
 
-### Post-Upgrade Verification (v4.24.0+)
+### Post-Upgrade Verification (v4.25.0+)
 
-After upgrading to v4.24.0 or newer, verify the deployment:
+After upgrading to v4.25.0 or newer, verify the deployment:
 
 1. **Check update history**
    ```bash
diff --git a/docs/RELEASE.md b/docs/RELEASE.md
diff --git a/frontend-modern/src/components/FirstRunSetup.tsx b/frontend-modern/src/components/FirstRunSetup.tsx
@@ -11,7 +11,6 @@ export const FirstRunSetup: Component = () => {
   const [password, setPassword] = createSignal('');
   const [confirmPassword, setConfirmPassword] = createSignal('');
   const [useCustomPassword, setUseCustomPassword] = createSignal(false);
-  const [generatedPassword, setGeneratedPassword] = createSignal('');
   const [, setApiToken] = createSignal('');
   const [isSettingUp, setIsSettingUp] = createSignal(false);
   const [showCredentials, setShowCredentials] = createSignal(false);
@@ -96,9 +95,6 @@ export const FirstRunSetup: Component = () => {
 
     // Generate password if not custom
     const finalPassword = useCustomPassword() ? password() : generatePassword();
-    if (!useCustomPassword()) {
-      setGeneratedPassword(finalPassword);
-    }
 
     // Generate API token
     const token = generateToken();
diff --git a/frontend-modern/src/components/Settings/Settings.tsx b/frontend-modern/src/components/Settings/Settings.tsx
@@ -18,6 +18,7 @@ import { UpdatesAPI } from '@/api/updates';
 import { Card } from '@/components/shared/Card';
 import { SectionHeader } from '@/components/shared/SectionHeader';
 import { Toggle } from '@/components/shared/Toggle';
+import type { ToggleChangeEvent } from '@/components/shared/Toggle';
 import { formField, labelClass, controlClass, formHelpText } from '@/components/shared/Form';
 import Server from 'lucide-solid/icons/server';
 import HardDrive from 'lucide-solid/icons/hard-drive';
@@ -1898,7 +1899,7 @@ const Settings: Component<SettingsProps> = (props) => {
                         </span>
                         <Toggle
                           checked={discoveryEnabled()}
-                          onChange={async (e) => {
+                          onChange={async (e: ToggleChangeEvent) => {
                             if (envOverrides().discoveryEnabled || savingDiscoverySettings()) {
                               e.preventDefault();
                               return;
@@ -2437,7 +2438,7 @@ const Settings: Component<SettingsProps> = (props) => {
                         </span>
                         <Toggle
                           checked={discoveryEnabled()}
-                          onChange={async (e) => {
+                          onChange={async (e: ToggleChangeEvent) => {
                             if (envOverrides().discoveryEnabled || savingDiscoverySettings()) {
                               e.preventDefault();
                               return;
@@ -2866,7 +2867,7 @@ const Settings: Component<SettingsProps> = (props) => {
                         </span>
                         <Toggle
                           checked={discoveryEnabled()}
-                          onChange={async (e) => {
+                          onChange={async (e: ToggleChangeEvent) => {
                             if (envOverrides().discoveryEnabled || savingDiscoverySettings()) {
                               e.preventDefault();
                               return;
@@ -3309,7 +3310,7 @@ const Settings: Component<SettingsProps> = (props) => {
                     </div>
                     <Toggle
                       checked={discoveryEnabled()}
-                      onChange={async (e) => {
+                      onChange={async (e: ToggleChangeEvent) => {
                         if (envOverrides().discoveryEnabled || savingDiscoverySettings()) {
                           e.preventDefault();
                           return;
diff --git a/frontend-modern/src/components/shared/NodeSummaryTable.tsx b/frontend-modern/src/components/shared/NodeSummaryTable.tsx
@@ -487,7 +487,7 @@ export const NodeSummaryTable: Component<NodeSummaryTableProps> = (props) => {
                     onClick={() => props.onNodeClick(nodeId, item.type)}
                   >
                     <td
-                      class={`pr-2 py-0.5 whitespace-nowrap ${showAlertHighlight ? 'pl-4' : 'pl-3'}`}
+                      class={`pr-2 py-0.5 whitespace-nowrap ${showAlertHighlight() ? 'pl-4' : 'pl-3'}`}
                     >
                       <div class="flex items-center gap-1">
                         <a
diff --git a/frontend-modern/src/components/shared/Toggle.tsx b/frontend-modern/src/components/shared/Toggle.tsx
@@ -2,10 +2,13 @@ import { JSX } from 'solid-js';
 
 type ToggleSize = 'xs' | 'sm' | 'md';
 
-interface ToggleChangeEvent {
+export interface ToggleChangeEvent {
   currentTarget: {
     checked: boolean;
   };
+  preventDefault: () => void;
+  stopPropagation: () => void;
+  readonly defaultPrevented: boolean;
 }
 
 interface BaseToggleProps {
@@ -37,8 +40,25 @@ export function TogglePrimitive(props: BaseToggleProps): JSX.Element {
   const handleClick = () => {
     if (isDisabled()) return;
     const next = !props.checked;
-    props.onToggle?.();
-    props.onChange?.({ currentTarget: { checked: next } });
+    let defaultPrevented = false;
+
+    const event: ToggleChangeEvent = {
+      currentTarget: { checked: next },
+      preventDefault() {
+        defaultPrevented = true;
+      },
+      stopPropagation() {
+        /* noop for synthetic toggle event */
+      },
+      get defaultPrevented() {
+        return defaultPrevented;
+      },
+    };
+
+    props.onChange?.(event);
+    if (!event.defaultPrevented) {
+      props.onToggle?.();
+    }
   };
 
   return (
diff --git a/frontend-modern/src/pages/Alerts.tsx b/frontend-modern/src/pages/Alerts.tsx
@@ -8,6 +8,7 @@ import type { RawOverrideConfig, PMGThresholdDefaults, SnapshotAlertConfig, Back
 import { Card } from '@/components/shared/Card';
 import { SectionHeader } from '@/components/shared/SectionHeader';
 import { SettingsPanel } from '@/components/shared/SettingsPanel';
+import { Toggle } from '@/components/shared/Toggle';
 import { formField, formControl, formHelpText, labelClass, controlClass } from '@/components/shared/Form';
 import { useWebSocket } from '@/App';
 import { showSuccess, showError } from '@/utils/toast';
@@ -3688,6 +3689,7 @@ function HistoryTab() {
   // Apply filters to get the final alert data
   const alertData = createMemo(() => {
     let filtered = severityAndSearchFilteredAlerts();
+    const currentTimeFilter = timeFilter();
 
     // Selected bar filter (takes precedence over time filter)
     if (selectedBarIndex() !== null) {
@@ -3700,13 +3702,14 @@ function HistoryTab() {
         const alertTime = new Date(alert.startTime).getTime();
         return alertTime >= bucketStart && alertTime < bucketEnd;
       });
-    } else if (timeFilter() !== 'all') {
+    } else if (currentTimeFilter !== 'all') {
       const now = Date.now();
-      const cutoff = {
+      const cutoffMap: Record<'24h' | '7d' | '30d', number> = {
         '24h': now - 24 * 60 * 60 * 1000,
         '7d': now - 7 * 24 * 60 * 60 * 1000,
         '30d': now - 30 * 24 * 60 * 60 * 1000,
-      }[timeFilter()];
+      };
+      const cutoff = cutoffMap[currentTimeFilter];
 
       if (cutoff) {
         filtered = filtered.filter((a) => new Date(a.startTime).getTime() > cutoff);
@@ -4217,7 +4220,7 @@ function HistoryTab() {
       <div class="flex flex-wrap gap-2 mb-4">
         <select
           value={timeFilter()}
-          onChange={(e) => setTimeFilter(e.currentTarget.value)}
+          onChange={(e) => setTimeFilter(e.currentTarget.value as '24h' | '7d' | '30d' | 'all')}
           class="px-3 py-2 text-sm border rounded-lg dark:bg-gray-700 dark:border-gray-600"
         >
           <option value="24h">Last 24h</option>
@@ -4228,7 +4231,7 @@ function HistoryTab() {
 
         <select
           value={severityFilter()}
-          onChange={(e) => setSeverityFilter(e.currentTarget.value)}
+          onChange={(e) => setSeverityFilter(e.currentTarget.value as 'warning' | 'critical' | 'all')}
           class="px-3 py-2 text-sm border rounded-lg dark:bg-gray-700 dark:border-gray-600"
         >
           <option value="all">All Levels</option>
diff --git a/internal/api/router_integration_test.go b/internal/api/router_integration_test.go
diff --git a/internal/monitoring/staleness_tracker.go b/internal/monitoring/staleness_tracker.go
diff --git a/internal/updates/version.go b/internal/updates/version.go
diff --git a/scripts/package-helm-chart.sh b/scripts/package-helm-chart.sh

Original file line number	Diff line number	Diff line change
`@@ -487,7 +487,7 @@ export const NodeSummaryTable: Component<NodeSummaryTableProps> = (props) => {`
`487`	`487`	`onClick={() => props.onNodeClick(nodeId, item.type)}`
`488`	`488`	`>`
`489`	`489`	`<td`
`490`		- class={`pr-2 py-0.5 whitespace-nowrap ${showAlertHighlight ? 'pl-4' : 'pl-3'}`}
	`490`	+ class={`pr-2 py-0.5 whitespace-nowrap ${showAlertHighlight() ? 'pl-4' : 'pl-3'}`}
`491`	`491`	`>`
`492`	`492`	`<div class="flex items-center gap-1">`
`493`	`493`	`<a`