v25.0.0 — Multi-Model Safety and Benchmark Reliability

Tag: v25.0.0
Title: v25.0.0 — Multi-Model Safety and Benchmark Reliability
Asset: MLXServerManager-v25.0.0-unsigned.zip
Pre-release: No

Summary

v25.0.0 is an app-code release focused on safer multi-model operation, more dependable benchmark comparison, and Swift concurrency readiness.

It preserves Direct Mode while adding endpoint collision prevention, available-port suggestions, projected memory checks before model launch, deterministic auto-unload planning, and benchmark context that prevents unlike runs from being presented as directly comparable.

Changes

• Added managed endpoint collision prevention across equivalent loopback and wildcard hosts.
• Added available-port suggestions for model profile creation and editing.
• Added pre-launch multi-model memory assessment with an explicit confirmation step for critical projected pressure.
• Extracted deterministic auto-unload planning from the periodic UI update path.
• Added real-process integration coverage for independent multi-model start, stop, unexpected exit, and listening-port detection.
• Added benchmark warm-up support before measured samples.
• Added benchmark execution fingerprints so runtime configuration changes invalidate stale comparisons.
• Added host thermal-state capture and exclusion guidance for thermally constrained benchmark runs.
• Added structured benchmark exclusion reasons for suite, chip, backend, runtime configuration, thermal pressure, and insufficient successful samples.
• Improved benchmark result persistence compatibility and comparison diagnostics.
• Hardened process pipe handling, registry ownership checks, download output delivery, and asynchronous callbacks.
• Cleaned up Swift concurrency isolation boundaries and validated the code under Swift 6 language mode.
• Updated README install guidance for the v25.0.0 unsigned app asset.

Direct Mode Boundary

Direct Mode remains unchanged. This release does not add inference proxying, request rewriting, model request inspection, credential storage, model-file deletion, cache cleanup, telemetry, or LAN Web UI. Clients continue to connect directly to the selected mlx_lm.server or Rapid-MLX endpoint.

Validation

• Full Debug test suite passed.
• Release build passed.
• Swift 6 compatibility tests and Release build passed.
• Static Analyzer passed with no app-code findings.
• git diff --check passed.
• Release zip contents were checked for runtime settings, model files, Hugging Face cache, logs, secrets, dSYM, DerivedData, and AppleDouble metadata.
• App bundle version was verified as 25.0.0.

Asset

• MLXServerManager-v25.0.0-unsigned.zip
• SHA-256: b629f08daa1fa8a0c2814a7f05bbd44174acd373562644609ac07eae97983ba2

v24.0.0 — Integrated Workspace UI and Performance Polish

Tag: v24.0.0
Title: v24.0.0 — Integrated Workspace UI and Performance Polish
Asset: MLXServerManager-v24.0.0-unsigned.zip
Pre-release: No

Summary

v24.0.0 is an app-code release focused on integrated workspace UI stabilization, model-management workflow polish, Hermes Agent connection support, and lightweight performance cleanup.

It keeps the app in Direct Mode while refining the main model operations surface, Hugging Face download workflow, settings and localization behavior, diagnostics copy surfaces, and log/model-list state calculations.

Changes

• Refined the integrated macOS workspace layout and sidebar behavior.
• Stabilized the model list as the primary daily-operations surface.
• Added and polished Hugging Face model search, preview, and download workflows.
• Added model profile add/edit flow polish and safer delete confirmation behavior.
• Added Hermes Agent connection information and configuration apply support.
• Improved English/Japanese visible text coverage and localization consistency.
• Simplified and optimized model list state calculations.
• Cached model size, system information rows, and log-derived display state to reduce repeated UI work.
• Removed unused model list helper code without changing current UI behavior.
• Updated README install guidance for the v24.0.0 unsigned app asset.

Direct Mode Boundary

Direct Mode remains unchanged. This release does not add inference proxying, request rewriting, multi-backend routing, credential storage, model-file deletion, cache cleanup, telemetry, or LAN Web UI. The diagnostic Test Chat remains a direct endpoint smoke test for checking whether the selected OpenAI-compatible endpoint can respond.

Validation

• Debug build passed.
• Focused regression tests passed.
• Release build passed.
• git diff --check passed.
• Published release asset was downloaded again from GitHub and SHA-256 verified.
• Release zip contents were checked for runtime settings, model files, Hugging Face cache, logs, secrets, dSYM, DerivedData, and AppleDouble metadata.

Asset

• MLXServerManager-v24.0.0-unsigned.zip
• SHA-256: f43ac5b19147bb5019803885ab7fa59155deddc37c93bdaf3c25bf8c42bb9635

v20.2.0 — Integrated Workspace Operations Polish

Tag: v20.2.0
Title: v20.2.0 — Integrated Workspace Operations Polish
Asset: MLXServerManager-v20.2.0-unsigned.zip
Pre-release: No

Summary

v20.2.0 is an app-code release focused on integrated workspace operations polish.

It reworks the model list into a more direct daily-operations surface with status-driven load/unload controls, sortable columns, model size display, reasoning toggles, functional auto-unload, and updated SYSTEM resource panels.

Changes

• Removed the integrated Help menu.
• Expanded integrated sidebar menu hit targets beyond visible label text.
• Reworked the model list columns for daily use:
  • Model name / usage
  • Size
  • Status
  • Server port
  • Process memory
  • Auto unload
  • Reasoning
• Added model size display from local model weight files.
• Added sortable model list headers with ascending / descending indicators.
• Added status-driven Load / Unload behavior:
  • Ready
  • Load on hover
  • Loading
  • Loaded
  • Unload on hover
  • Unloading
• Added fixed-size rounded status buttons.
• Added green Load / Loaded styling and red Unload hover styling.
• Removed central Start / Stop / Restart / Speed Test buttons from the integrated model list workflow.
• Added per-model reasoning toggles.
• Added functional auto-unload monitoring for app-managed servers.
• Added Activity Monitor-style memory and CPU history panels.
• Removed GPU usage display because a stable Activity Monitor-equivalent public API is not available.
• Added SYSTEM hardware summary rows for Mac model, chip, cores, memory, and storage used / total.
• Simplified memory, CPU, and uptime helper text.

Auto-Unload Behavior

Auto-unload is now functional rather than display-only. When an app-managed model is loaded and auto-unload is enabled, the app checks once per second whether the configured minute threshold has elapsed. If the model is not currently loading or unloading, the app logs the auto-unload event and calls the managed stop path.

Direct Mode Boundary

Direct Mode remains unchanged. This release does not add inference proxying, request rewriting, a Chat UI, multi-backend routing, credential storage, model deletion, or cache cleanup.

Validation

• Debug build passed.
• Test suite passed.
• Release build passed.
• git diff --check passed.

Asset

• MLXServerManager-v20.2.0-unsigned.zip
• SHA-256: 8f36dde1514fb52e702b00e1926e6443ad4a2ee00c8dd24fd78d253906435afc

v20.1.0 — Current State Documentation Alignment

Tag: v20.1.0
Title: v20.1.0 — Current State Documentation Alignment
Asset: none — docs-only release; use MLXServerManager-v20.0.0-unsigned.zip for the latest app-code binary
Pre-release: No

Summary

• Align README current-state wording with v20.x implemented behavior.
• Refresh Known Limitations so Hugging Face search/download and integrated GUI behavior are described as implemented where applicable.
• Add docs/v20_1_current_state_alignment.md to record that v20.1.0 is docs-only.
• Update stable scope, product direction, and distribution boundaries to keep Direct Mode, no proxy, no Chat UI, no credential storage, no model deletion, and no cache cleanup clear.

Verification

• xcodebuild Debug build: passed
• xcodebuild test: passed
• git diff --check: passed

Notes

No Swift source behavior changes are included. No new app zip is produced. The current app-code binary remains MLXServerManager-v20.0.0-unsigned.zip.

v20.0.0 — Daily Operations Stable

v20.0.0

Release Settings

• Tag: v20.0.0
• Title: v20.0.0 — Daily Operations Stable
• Asset: MLXServerManager-v20.0.0-unsigned.zip
• Pre-release: No

Summary

Daily operations stable milestone. This release prioritizes GUI/implementation alignment and removes visible UI for unavailable connection-port behavior. It also makes unsampled CPU/GPU state explicit, switches automatic unload wording to manual stop, uses process-memory and last-check wording, and adds Start guardrails while preserving Direct Mode.

Changed

• Removed visible unavailable connection-port UI from the integrated model table, right settings panel, safety rows, and footer
• Kept Hermes Agent connection guidance Direct Mode only
• Replaced auto-unload wording with manual-stop wording
• Replaced CPU/GPU usage wording with explicit unsampled labels
• Renamed model memory display to process memory
• Renamed last-use display to last-check / activity semantics
• Added Start guardrail state for missing selection, missing executable, missing model path, and unavailable server port
• Routed recovery actions through the integrated workspace entry point
• Updated ModelOperationsSafetyTests to assert implemented safety rows only
• Added v20 daily operations stable readiness documentation

Asset

MLXServerManager-v20.0.0-unsigned.zip

SHA-256: 6de6880b0d0da070cb52b1a4e99e3dc92897a946ee93e92121c84541dd5ec26e

Preserved Behavior

Direct Mode remains unchanged. No Chat UI, request inspection, response rewriting, credential storage, model-file deletion, cache cleanup, telemetry, LAN Web UI, App Intents, automatic download, automatic start, or automatic unload scheduler was added.

Verification

• Tests passed
• Release build passed
• SHA-256 verified

v19.0.0 — Daily Operations Recovery Stable

v19.0.0

Release Settings

• Tag: v19.0.0
• Title: v19.0.0 — Daily Operations Recovery Stable
• Asset: MLXServerManager-v19.0.0-unsigned.zip
• Pre-release: No

Summary

Daily operations recovery stable milestone. This release keeps the integrated GUI and adds failure classification, recovery action mapping, an integrated Recovery panel, runtime/download recovery wiring, troubleshooting summary copy, and explicit safety refresh.

Changed

• Added RecoveryIssue, RecoveryIssueCategory, RecoverySeverity, and RecoveryAction models
• Added failure classification for executable, model path, port, permission, readiness, process exit, HF CLI, HF access, network, destination, and unknown issues
• Added recovery action mapping with primary and secondary actions
• Added IntegratedRecoveryPanelView
• Wired runtime error, port busy, port check failed, and ready check failed states into Recovery
• Wired latest failed Hugging Face download into Recovery
• Added copyable troubleshooting summary with runtime, target, selected model, recovery issue, safety summary, and recent logs
• Added explicit Refresh Safety action
• Added no-recovery OK state and severity badges
• Expanded ModelOperationsSafetyTests
• Added v19 daily operations recovery readiness documentation

Asset

MLXServerManager-v19.0.0-unsigned.zip

SHA-256: d3dbebcb2c005ee949fc2b490d65d7578e1a92068c0750066416f32986604956

Preserved Behavior

Direct Mode remains unchanged. No inference proxy, proxy mode, chat UI, credential storage, model-file deletion, cache cleanup, telemetry, LAN Web UI, App Intents, automatic download, or automatic start was added.

Verification

• Tests passed
• Release build passed
• SHA-256 verified

v18.0.0 — Model Operations Safety Stable

v18.0.0

Release Settings

• Tag: v18.0.0
• Title: v18.0.0 — Model Operations Safety Stable
• Asset: MLXServerManager-v18.0.0-unsigned.zip
• Pre-release: No

Summary

Model operations safety stable milestone. This release keeps the integrated GUI and adds safety checks for executable readiness, model identity, server/proxy ports, duplicate profiles, runtime editing, and failed-start recovery.

Changed

• Added selected model safety rows in the integrated right-side model settings panel
• Added executable readiness safety summary
• Added model identity validation for local paths, Hugging Face IDs, full HF URLs, and review-needed values
• Added server port and informational proxy port safety summaries
• Added duplicate profile warnings for display name, model ID, and endpoint
• Added runtime editing safety guidance
• Added failed-start recovery guidance for executable, model, port, permission, and readiness issues
• Added copyable model operations safety summary
• Added ModelOperationsSafetyTests
• Added v18 model operations safety readiness documentation

Asset

MLXServerManager-v18.0.0-unsigned.zip

SHA-256: 2fab6114de262523620a80a4855b0a08ff6674259ec667a0cb20d6c4e26e0da6

Preserved Behavior

Direct Mode remains unchanged. No inference proxy, proxy mode, chat UI, credential storage, model-file deletion, cache cleanup, telemetry, LAN Web UI, App Intents, automatic download, or automatic start was added.

Verification

• Tests passed
• Release build passed
• SHA-256 verified

v17.0.0 — Integrated GUI Functional Stable

v17.0.0

Release Settings

• Tag: v17.0.0
• Title: v17.0.0 — Integrated GUI Functional Stable
• Asset: MLXServerManager-v17.0.0-unsigned.zip
• Pre-release: No

Summary

Integrated GUI functional stable milestone. This release keeps the v16 screenshot-like operation workspace and connects the visible GUI to real state and existing operations: menu navigation, system metrics, model table summaries, action-state guidance, profile edit/delete, Direct Mode connection copies, and log filtering.

Changed

• Split integrated sidebar menu into its own component and destination model
• Connected memory gauge to the managed-process memory monitor
• Added integrated CPU/GPU/uptime state labels
• Wired model table status, memory, latest-use, proxy-port display, and auto-unload summaries through ViewModel helpers
• Added action-state summary for Start / Stop / Restart / Speed Test
• Added Edit action to the right-side model settings panel
• Aligned Hermes Agent Base URL display with actual Direct Mode copy value
• Added Direct Mode note to the Hermes panel
• Added category filter, latest important log, copy, and clear actions to the integrated log panel
• Connected left menu to Downloads, Settings, Logs, and Help
• Added v17 integrated GUI functional readiness documentation

Asset

MLXServerManager-v17.0.0-unsigned.zip

SHA-256: b9cd32373f7e08ff8cbcf6832bb28c9ec7b01ddaef29afb203a6024ca89f6574

Preserved Behavior

Direct Mode remains unchanged. No inference proxy, chat UI, credential storage, model-file deletion, cache cleanup, telemetry, LAN Web UI, App Intents, automatic download, or automatic start was added.

Verification

• Tests passed
• Release build passed
• SHA-256 verified

v16.0.0 — Integrated Operations GUI

v16.0.0

Release Settings

• Tag: v16.0.0
• Title: v16.0.0 — Integrated Operations GUI
• Asset: MLXServerManager-v16.0.0-unsigned.zip
• Pre-release: No

Summary

Integrated GUI reconstruction milestone. The app now opens into a screenshot-oriented single operation workspace: left menu/system metrics, center model list/action bar/logs, and right selected-model settings/Hermes Agent connection information.

Changed

• Added IntegratedWorkspaceView as the primary app shell
• Rebuilt the main layout into left, center, and right operational columns
• Added left-side menu and system metrics block
• Added central model list with status, server port, proxy port, memory, last-used, and auto-unload placeholder columns
• Added central Start / Stop / Restart / Speed Test action bar
• Added central log panel
• Added right-side selected model settings panel
• Added right-side Hermes Agent connection panel with copy actions
• Added dark GUI appearance for the integrated workspace
• Added screenshot comparison review documentation

Asset

MLXServerManager-v16.0.0-unsigned.zip

SHA-256: db401a375b2a59ba32475557c32209d18c44c94f27bfd9f128a944d19d6f933b

Preserved Behavior

Direct Mode remains unchanged. No inference proxy, chat UI, credential storage, model-file deletion, cache cleanup, telemetry, LAN Web UI, App Intents, automatic download, or automatic start was added.

Verification

• Tests passed
• Release build passed
• SHA-256 verified

v15.0.0 — GUI Workflow Integration Stable

v15.0.0

Release Settings

• Tag: v15.0.0
• Title: v15.0.0 — GUI Workflow Integration Stable
• Asset: MLXServerManager-v15.0.0-unsigned.zip
• Pre-release: No

Summary

GUI workflow integration stable milestone. This release turns the v14 surface split into practical daily workflows: Dashboard launches work, Models manages profiles, Downloads manages acquisition and recovery, Runtime manages diagnostics and benchmark, Settings owns app configuration and language, and Logs owns troubleshooting context.

Changed

• Models surface now supports row selection, source filtering, text search, selected model inspector, Add / Edit / Delete, Import / Export, launch command preview, and advanced launch option preview
• Downloads surface now includes completion links to Models and Runtime
• Downloads recovery now has a visible latest-failure recovery card
• Runtime surface now explains Stop / Restart / Speed Test action states
• Settings surface now edits executable path, default host, default port, API key placeholder, and language
• Dashboard now links directly to Models, Downloads, Runtime, Settings, and Logs
• Logs surface now includes troubleshooting summary, latest important log, and copy / clear actions
• Added v15 workflow integration readiness documentation

Asset

MLXServerManager-v15.0.0-unsigned.zip

SHA-256: 0adf713862ce822cbb71161500730eb26025ec387e23978cdd8fa1402f63423f

Preserved Behavior

Direct Mode remains unchanged. No inference proxy, chat UI, credential storage, model-file deletion, cache cleanup, telemetry, LAN Web UI, App Intents, automatic download, or automatic start was added.

Verification

• Tests passed
• Release build passed
• SHA-256 verified