Method setHeartbeatSettings

src/node/services/workspaceService.ts:4413–4503

(
    workspaceId: string,
    settings: WorkspaceHeartbeatSettingsUpdate
  )

  }

  async setHeartbeatSettings(
    workspaceId: string,
    settings: WorkspaceHeartbeatSettingsUpdate
  ): Promise<Result<WorkspaceHeartbeatSettings, string>> {
    try {
      assert(
        settings != null && typeof settings === "object",
        "setHeartbeatSettings requires settings"
      );

      const hasEnabledUpdate = Object.prototype.hasOwnProperty.call(settings, "enabled");
      assert(
        !hasEnabledUpdate || typeof settings.enabled === "boolean",
        "Heartbeat enabled flag must be a boolean when provided"
      );
      const hasIntervalUpdate = Object.prototype.hasOwnProperty.call(settings, "intervalMs");
      assert(
        !hasIntervalUpdate || Number.isInteger(settings.intervalMs),
        "Heartbeat interval must be an integer when provided"
      );
      assert(
        !hasIntervalUpdate ||
          (settings.intervalMs! >= HEARTBEAT_MIN_INTERVAL_MS &&
            settings.intervalMs! <= HEARTBEAT_MAX_INTERVAL_MS),
        `Heartbeat interval must be between ${HEARTBEAT_MIN_INTERVAL_MS} and ${HEARTBEAT_MAX_INTERVAL_MS} ms`
      );
      const hasMessageUpdate = Object.prototype.hasOwnProperty.call(settings, "message");
      assert(
        !hasMessageUpdate || settings.message == null || typeof settings.message === "string",
        "Heartbeat message must be a string when provided"
      );
      const hasContextModeUpdate = Object.prototype.hasOwnProperty.call(settings, "contextMode");
      assert(
        !hasContextModeUpdate ||
          settings.contextMode == null ||
          isHeartbeatContextMode(settings.contextMode),
        "Heartbeat context mode must be a supported value when provided"
      );

      const resolved = this.resolveHeartbeatWorkspaceEntry(workspaceId, "setHeartbeatSettings");
      if (!resolved.success) {
        return Err(resolved.error);
      }

      const { normalizedWorkspaceId, config, workspaceEntry } = resolved.data;
      const defaultIntervalMs = this.getHeartbeatDefaultIntervalMsFromConfig(config);
      const currentSettings = normalizeHeartbeatSettings(
        workspaceEntry.heartbeat,
        defaultIntervalMs
      );
      const nextMessage = hasMessageUpdate
        ? sanitizeHeartbeatMessage(settings.message)
        : currentSettings?.message;
      // Keep the interval on disk even when disabled so re-enabling restores the user's choice.
      const nextSettings: WorkspaceHeartbeatSettings = {
        enabled: hasEnabledUpdate ? settings.enabled! : (currentSettings?.enabled ?? true),
        intervalMs: hasIntervalUpdate
          ? settings.intervalMs!