Local LLM Server Manager

Appearance

Software Requirements Specification (SRS) & Traceability Matrix ​

LocalLLMServerManager v3.5.0 | .NET 10 LTS | Avalonia UI & WebAssembly | Model Context Protocol

This document establishes the formal Software Requirements Specification (SRS) and Requirements Traceability Matrix (RTM) for LocalLLMServerManager. Each requirement is derived from the codebase and test suites, mapping functional capabilities directly to implementation source files, automated test cases, and verification statuses.

📋 Requirement Taxonomy ​

Requirements are categorized into 12 functional domains using standardized identifiers:

Domain PrefixCategory DescriptionTarget Area
CORE-xxxCore Host & InfrastructureASP.NET Core Kestrel Host, Windows Service, Linux systemd, Win32 Job Objects, Settings
LLM-xxxLLM & Ollama ManagementOllama health, local model library, KV Cache calculator, capability profiles, model pulling
HUB-xxxHugging Face Hub IntegrationGGUF, Video, and Audio model discovery, quantization trees, chunked download streaming
DIFF-xxxStable Diffusion & CivitAISD WebUI / Forge health, CivitAI model gallery, direct-to-disk checkpoint/LoRA downloader
3D-xxx3D Mesh & ComfyUI GenerationComfyUI proxy, TRELLIS V2 / Hunyuan3D v2 workflows, WebGL <model-viewer> canvas
VID-xxxVideo Generation & StudioWan 2.2 / LTX-2.5 / HunyuanVideo presets, generation endpoints, interactive video player
AUD-xxxAudio & TTS GenerationKokoro TTS, OpenAI /v1/audio/speech, Stable Audio Open, YuE, waveform visualizer
PACK-xxxModular Feature PacksOptional component installer (ext_video, ext_audio), --with-* flags, fallback banners
VRAM-xxxGPU Telemetry & VRAM OrchestrationNVML CUDA telemetry, OS fallbacks, stacked memory visualizer, auto-unload OOM prevention
MCP-xxxModel Context Protocol APIStreamable HTTP / SSE endpoint (/mcp), JSON-RPC 2.0, 11 native AI tools
INST-xxxInstaller & Upgrade LifecycleInno Setup Windows installer, PowerShell update/install scripts, Linux systemd installer, settings preservation
DISC-xxxTool Discovery & Flexible PathsMulti-drive filesystem scanner (IToolDiscoveryService), /api/tools/* endpoints, status badges
UI-xxxUser Interface & ExperienceFluent dark theme tokens, SOLID UserControls, MVVM bindings, toast notifications, URL launcher
WASM-xxxWebAssembly Client PlatformAvalonia WASM compilation, Kestrel static MIME type mappings, browser proxy routing
E2E-xxxEnd-to-End Automation & QAHeadless Playwright browser harness, zero-error WASM validation, screenshot generator

🎯 Software Requirements Specification (SRS) ​

1. Core Host & Infrastructure (CORE-xxx) ​

  • CORE-001: The application shall bootstrap an ASP.NET Core Minimal API server on Kestrel listening on configurable port (default :5246), hosting both REST endpoints and WebAssembly static assets.
  • CORE-002: The application shall support running as a headless Windows Service on machine boot prior to user login.
  • CORE-003: The application shall support running as a headless Linux systemd daemon (localllmmanager.service) on boot.
  • CORE-004: The Avalonia Desktop application shall display an interactive System Tray icon with right-click actions (Open Dashboard, View Health, Exit) and automatically attach to the background service when a desktop session begins.
  • CORE-005: On Windows, child AI engine processes shall be bound to a Win32 Job Object with kill-on-close semantics and hard memory limits, with graceful fallback to standard process management on Linux.
  • CORE-006: The application shall support in-app self-updating by executing automated Git fetch, checkout, and pull operations.
  • CORE-007: Configuration file paths shall dynamically resolve environment variables (such as %APPDATA%) with robust fallback defaults.
  • CORE-008: Application settings shall persist to and reload from a local JSON file (appsettings.json / settings.json) across sessions.

2. LLM & Ollama Management (LLM-xxx) ​

  • LLM-001: The application shall probe the health and availability of the local Ollama instance (:11434).
  • LLM-002: The application shall query and display all installed Ollama models with disk footprints, family tags, and parameter counts.
  • LLM-003: The application shall provide an interactive KV Cache Context Calculator allowing users to slide token length (up to 32,768 tokens) and preview combined model weight and context memory consumption.
  • LLM-004: The application shall classify model families (Llama, Gemma, Qwen, Phi, Mistral, DeepSeek) with capability profile badges (Coding, Reasoning, Math, Chat).
  • LLM-005: The application shall provide quick-pull cards for popular models with single-click installation triggers.
  • LLM-006: The application shall allow pulling arbitrary user/model:tag specifications with real-time SSE progress streaming.
  • LLM-007: The application shall allow locking models in GPU VRAM indefinitely via keep_alive: -1.
  • LLM-008: The application shall provide a one-click VRAM unload action sending keep_alive: 0 to release all loaded Ollama weights from GPU memory.

3. Hugging Face Hub Integration (HUB-xxx) ​

  • HUB-001: The application shall query the Hugging Face Hub API to search and filter GGUF model repositories.
  • HUB-002: The application shall inspect GGUF repository file trees to list available quantizations (Q4_K_M, Q5_K_M, Q8_0, FP16) with exact file sizes.
  • HUB-003: The application shall download selected GGUF files directly to the local model store with chunked progress reporting.

4. Stable Diffusion & CivitAI (DIFF-xxx) ​

  • DIFF-001: The application shall monitor the health and task progress of Stable Diffusion WebUI / Forge (:7860).
  • DIFF-002: The application shall search CivitAI for models with filters for model type (Checkpoint, LoRA, VAE, ControlNet) and sort order.
  • DIFF-003: The application shall display preview thumbnail cards, star ratings, and download counts from CivitAI.
  • DIFF-004: The application shall stream CivitAI model files directly to disk into the configured model repository.
  • DIFF-005: The application shall allow users to configure custom target directories for Stable Diffusion / Forge checkpoints.

5. 3D Mesh & ComfyUI Generation (3D-xxx) ​

  • 3D-001: The application shall verify ComfyUI backend connectivity via /system_stats.
  • 3D-002: The application shall transparently proxy ComfyUI REST routes and WebSocket progress feeds through port 5246 via YARP reverse proxy.
  • 3D-003: The application shall bundle and execute ready-to-run API workflow presets for TRELLIS V2 and Hunyuan3D v2 3D mesh generation.
  • 3D-004: The application shall render generated .glb and .gltf 3D meshes inside an interactive WebGL <model-viewer> canvas with 360° orbital controls, lighting presets, and wireframe options.
  • 3D-005: The application shall allow users to inspect and download generated 3D GLB assets.
  • 3D-006: The application shall provide an engine preference selector to switch between Forge and ComfyUI.

6. Video Generation & Studio (VID-xxx) ​

  • VID-001: The application shall bundle workflow presets and execute video generation for Wan 2.2 (Text-to-Video and Image-to-Video), LTX-2.5, and HunyuanVideo 1.5.
  • VID-002: The backend shall expose /api/video/workflows, /api/video/generate, and /api/video/files endpoints.
  • VID-003: The UI shall host an interactive Video Player Preview component supporting play/pause, scrub, looping, playback speed, and metadata badges (resolution, fps, frame count).

7. Audio & Speech Synthesis (AUD-xxx) ​

  • AUD-001: The application shall supervise and manage local Kokoro TTS engine instances and expose an OpenAI-compatible POST /v1/audio/speech endpoint.
  • AUD-002: The backend shall expose /api/audio/workflows, /api/audio/generate, and /api/audio/files for ComfyUI audio synthesis with Stable Audio Open 3.0 and YuE.
  • AUD-003: The UI shall host an integrated Audio Studio with waveform visualization, audio player controls, and voice selection.

8. Modular Feature Packs & Component Installer (PACK-xxx) ​

  • PACK-001: The installer and application shall support optional feature packs (ext_video, ext_audio) via --with-video / --with-audio CLI flags and Inno Setup components.
  • PACK-002: The ComponentManagerService shall detect installed components and handle on-demand installation/uninstallation via /api/components.
  • PACK-003: The UI shall gracefully render an install prompt banner when accessing video/audio features if the corresponding feature pack is not yet installed.

9. GPU Telemetry & VRAM Orchestration (VRAM-xxx) ​

  • VRAM-001: The application shall read real-time GPU name and VRAM memory telemetry via NVML CUDA (nvidia-smi).
  • VRAM-002: The application shall provide fallback telemetry resolution via Windows Registry and Linux /proc/meminfo when NVML is unavailable.
  • VRAM-003: The application shall display a stacked visualizer indicating loaded model VRAM vs free GPU headroom.
  • VRAM-004: The VRAM Orchestrator shall automatically detect active LLMs in VRAM and release them before initiating heavy Stable Diffusion, ComfyUI 3D, or Video render jobs to prevent Out-Of-Memory (OOM) errors.
  • VRAM-005: The application shall allow customizing telemetry polling intervals and auto-unload thresholds.

10. Model Context Protocol API (MCP-xxx) ​

  • MCP-001: The application shall expose a Model Context Protocol (MCP) server over Streamable HTTP and SSE transports mapped to /mcp compliant with the official 2026-07-28 stateless MCP specification via ModelContextProtocol.AspNetCore.
  • MCP-002: The MCP server shall implement tool schema discovery (tools/list) exposing 11 management and generation tools (get_gpu_vram, check_health, list_models, pull_model, unload_vram, start_engine, stop_engine, detect_tools, generate_video, synthesize_speech, generate_audio) with rich descriptions and parameter metadata.
  • MCP-003: The MCP server shall implement tool execution dispatch (tools/call) allowing AI assistants (Claude Desktop, Cursor, Antigravity) to execute GPU telemetry queries, health probing, model pulling/unloading, engine start/stop, video generation, speech synthesis, and audio generation.
  • MCP-004: The MCP tools class (LocalLlmMcpTools) shall resolve required services (IGpuTelemetryProvider, IAiEngineManager, IOllamaModelService, IToolDiscoveryService, IHttpClientFactory, ISettingsService, VramOrchestrator) via dependency injection with robust error handling and structured JSON responses.

8. Installer & Upgrade Lifecycle (INST-xxx) ​

  • INST-001: The Inno Setup Windows installer shall detect running instances of the LocalLLMServerManager Windows Service and desktop tray applications, stop them cleanly prior to file extraction, and reconfigure and restart the service post-installation.
  • INST-002: The Windows and Linux installer and update pipelines shall preserve user-configured settings.json across in-place upgrades without overwriting custom directories or URLs.
  • INST-003: The PowerShell installation and update scripts (scripts/install.ps1, scripts/update.ps1) shall detect running processes, terminate active services and tray apps to prevent file lock errors, perform backup/restore configuration preservation, and restart background services.
  • INST-004: The Linux installation script (scripts/install_linux.sh) shall detect active systemd services (localllmmanager.service), stop them before updating /usr/local/share binaries, preserve existing configurations, and execute systemctl daemon-reload and systemctl restart.

9. Tool Discovery & Flexible Paths (DISC-xxx) ​

  • DISC-001: The application shall scan all accessible drive roots and common directories on Windows and Linux to auto-detect installed AI tools (Ollama executable and models, ComfyUI launch scripts and models, SD WebUI/Forge scripts and models).
  • DISC-002: The backend shall expose POST /api/tools/detect to discover installed tools and return suggested path configurations.
  • DISC-003: The backend shall expose POST /api/tools/validate-path to dynamically validate file or directory accessibility and report status (Valid, NotFound, Invalid).
  • DISC-004: The Settings UI shall provide one-click auto-detection, native file and directory pickers for every tool path, and real-time visual status badges (Valid 🟢, Missing 🔴, Unset ⚪).
  • DISC-005: All deployment and setup helper scripts shall accept parameter overrides for tool paths and model directories.

10. User Interface & Experience (UI-xxx) ​

  • UI-001: The UI shall apply a curated Fluent dark theme palette (#0F172A, #1E293B, #38BDF8, #EC4899, #A855F7).
  • UI-002: The UI shall be organized into modular, SOLID Avalonia XAML UserControls strongly typed to dedicated sub-ViewModels.
  • UI-003: The application shall display non-blocking, timed toast notifications for status updates and error alerts.
  • UI-004: The application shall support launching external URLs in the default system browser across Windows (explorer.exe) and Linux (xdg-open).

11. WebAssembly Client Platform (WASM-xxx) ​

  • WASM-001: The application shall compile Avalonia XAML UI to WebAssembly, delivering full desktop-parity features in standard web browsers.
  • WASM-002: The Kestrel host shall configure custom MIME types for WebAssembly assets (.wasm, .dat, .json, .glb, .png, .js, .css).
  • WASM-003: The backend shall proxy /api/models to bypass browser CORS restrictions.

12. End-to-End Automation & Quality Assurance (E2E-xxx) ​

  • E2E-001: The test harness shall boot headless Chromium with WebGL SwiftShader acceleration against a live Kestrel test server instance.
  • E2E-002: The Playwright test suite shall verify that the WASM client renders the #out canvas container with zero 404 network errors and zero unhandled console errors.
  • E2E-003: The Playwright screenshot generator shall navigate all 5 UI tabs and automatically capture crisp PNG documentation images to docs/images/, verifying visual distinctness across all tabs.

🔗 Bidirectional Requirements Traceability Matrix (RTM) ​

Req IDRequirement SummaryImplementing Source FilesVerifying Test Method(s)Status
CORE-001ASP.NET Core Minimal API HostProgram.csProgramEndpointsAndServicesTests.HealthCheck_ReturnsStatus200_WithOkPayload100% VERIFIED
CORE-002Windows Service Headless BootProgram.cs, LocalLLMServerManager.csprojProgramEndpointsAndServicesTests.ServiceMode_InitializesWithoutAvalonia100% VERIFIED
CORE-003Linux systemd Daemon HostingProgram.cs, scripts/localllmmanager.serviceProgramEndpointsAndServicesTests.ServiceMode_InitializesWithoutAvalonia100% VERIFIED
CORE-004Avalonia Desktop System TrayApp.axaml.csAvaloniaAppAndWindowCoverageTests.App_Initializes_DesktopMode100% VERIFIED
CORE-005Win32 Job Object Memory LimitsServices/Win32JobObject.cs, Services/AiEngineManager.csServicesAndEngineManagerCoverageTests.Win32JobObject_ExecutesSafely
DeepCoveragePushTests.Win32JobObject_LinuxFallback		100% VERIFIED
CORE-006In-App Git Self-UpdateServices/GitUpdateService.csCoverageThresholdTargetedPushTests.GitUpdateService_HandlesExecution100% VERIFIED
CORE-007Dynamic Env Path ResolutionLocalLLMServerManager.Shared/Models/AppSettings.cs, Program.csAppSettingsTests.ResolvePath_ExpandsEnvironmentVariables_Correctly
AppSettingsTests.ResolvePath_WithNullOrEmpty_UsesFallback		100% VERIFIED
CORE-008Persistent JSON SettingsServices/SettingsService.cs, Endpoints/EngineEndpoints.csAppSettingsTests.AppSettings_SerializationAndDeserialization_PreservesData
ProgramEndpointsAndServicesTests.SettingsEndpoints_GetAndPost_UpdatesConfiguration		100% VERIFIED
LLM-001Ollama Health ProbingLocalLLMServerManager.Shared/Services/OllamaModelService.csSearchServicesCoverageTests.OllamaModelService_CheckHealthAsync_ReturnsStatus
VramOrchestratorTests.IsOllamaHealthyAsync_ReturnsTrue_WhenApiReturnsSuccess		100% VERIFIED
LLM-002Installed Model InventoryLocalLLMServerManager.Shared/ViewModels/OllamaLibraryViewModel.csMainViewModelCoverageTests.OllamaLibraryViewModel_LoadsModels_Successfully
FinalPushTo90CoverageTests.OllamaLibrary_PopulatesInstalledModels		100% VERIFIED
LLM-003Interactive KV Cache CalculatorLocalLLMServerManager.Shared/ViewModels/OllamaLibraryViewModel.csMainViewModelCoverageTests.OllamaLibraryViewModel_CalculatesKvCache_Correctly
NinetyPercentThresholdTests.KvCacheCalculator_BoundaryConditions		100% VERIFIED
LLM-004Model Capability Profile BadgesLocalLLMServerManager.Shared/ViewModels/OllamaLibraryViewModel.csMainViewModelCoverageTests.OllamaLibraryViewModel_AssignsCapabilityTags100% VERIFIED
LLM-005Popular Model Quick-Pull CardsLocalLLMServerManager.Shared/Views/Controls/OllamaModelsTabControl.axamlMainWindowUiTests.OllamaModelsTab_RendersQuickPullButtons100% VERIFIED
LLM-006Custom Model Pull with SSE StreamLocalLLMServerManager.Shared/ViewModels/OllamaLibraryViewModel.csReachNinetyPercentCoverageTests.MainViewModel_PullModel_WithOllamaStreamingMock_ExecutesStreamReader
FinalPushTo90CoverageTests.PullModelAsync_StreamsProgress		100% VERIFIED
LLM-007Indefinite VRAM PreloadingLocalLLMServerManager.Shared/ViewModels/OllamaLibraryViewModel.csCoverageThresholdTargetedPushTests.OllamaModelService_PreloadsModelWithKeepAlive100% VERIFIED
LLM-008One-Click VRAM UnloadLocalLLMServerManager.Shared/ViewModels/MainViewModel.csReachNinetyPercentCoverageTests.MainViewModel_UnloadAllVram_WithOllamaMockServer_ExecutesUnloadPost
MainViewModelCoverageTests.MainViewModel_UnloadAllVram_ExecutesCleanly		100% VERIFIED
HUB-001Hugging Face GGUF Repo SearchLocalLLMServerManager.Shared/Services/HuggingFaceSearchService.csSearchServicesCoverageTests.HuggingFaceSearchService_SearchGgufAsync_ReturnsResults
OllamaAndHfMockServerTests.HuggingFaceSearch_ReturnsMockResults		100% VERIFIED
HUB-002GGUF Quantization Tree & SizesLocalLLMServerManager.Shared/ViewModels/HuggingFaceSearchViewModel.csMainViewModelCoverageTests.HuggingFaceSearchViewModel_ParsesQuantizationBranches100% VERIFIED
HUB-003Direct GGUF Download StreamingEndpoints/ModelProxyEndpoints.cs, HuggingFaceSearchViewModel.csProgramEndpointsAndServicesTests.HfDownloadEndpoint_StreamsContent
CoverageThresholdTargetedPushTests.HuggingFaceDownload_ProgressReporting		100% VERIFIED
DIFF-001Forge Health MonitoringServices/VramOrchestrator.csVramOrchestratorTests.IsForgeHealthyAsync_ReturnsTrue_WhenProgressEndpointReturns200100% VERIFIED
DIFF-002CivitAI Query & Type FiltersLocalLLMServerManager.Shared/Services/CivitaiSearchService.csSearchServicesCoverageTests.CivitaiSearchService_SearchModelsAsync_AppliesFilters100% VERIFIED
DIFF-003CivitAI Preview ThumbnailsLocalLLMServerManager.Shared/ViewModels/CivitaiSearchViewModel.csMainViewModelCoverageTests.CivitaiSearchViewModel_CachesThumbnails100% VERIFIED
DIFF-004Direct-to-Disk Checkpoint DownloadEndpoints/ModelProxyEndpoints.cs, CivitaiSearchViewModel.csProgramEndpointsAndServicesTests.CivitaiDownloadEndpoint_DirectToDisk100% VERIFIED
DIFF-005Configurable Forge Models PathLocalLLMServerManager.Shared/Models/AppSettings.csAppSettingsTests.AppSettings_DefaultValues_UseAppDataAiPaths
ProgramEndpointsAndServicesTests.SettingsEndpoints_GetAndPost_UpdatesConfiguration		100% VERIFIED
3D-001ComfyUI Health ProbeServices/VramOrchestrator.csVramOrchestratorTests.IsComfyUiHealthyAsync_ReturnsTrue_WhenSystemStatsReturns200100% VERIFIED
3D-002ComfyUI YARP Reverse ProxyProgram.cs, Endpoints/EngineEndpoints.csProgramEndpointsAndServicesTests.ComfyUiReverseProxy_RoutesTraffic100% VERIFIED
3D-003TRELLIS & Hunyuan3D WorkflowsEndpoints/WorkflowEndpoints.csWorkflowPerformanceTests.WorkflowEndpoints_LoadsPresetTemplates
WorkflowPerformanceTests.TrellisWorkflow_ParsesCorrectly		100% VERIFIED
3D-004Interactive WebGL 3D CanvasLocalLLMServerManager.Shared/Views/Controls/EngineStudioTabControl.axamlWorkflowPerformanceTests.ModelViewer_WebGLCanvas_Initializes100% VERIFIED
3D-0053D GLB Export & File InspectionEndpoints/WorkflowEndpoints.csWorkflowPerformanceTests.ExportGlbEndpoint_ReturnsValidBinaryHeader100% VERIFIED
3D-006Engine Preference SwitcherLocalLLMServerManager.Shared/ViewModels/SettingsViewModel.csAppSettingsTests.AppSettings_SerializationAndDeserialization_PreservesData
MainViewModelCoverageTests.SettingsViewModel_TogglesPreferredEngine		100% VERIFIED
VID-001Wan / LTX / Hunyuan Video PresetsEndpoints/WorkflowEndpoints.cs, Workflows/Video/*WorkflowEndpointsTests.GetVideoWorkflows_ReturnsAvailablePresets
WorkflowEndpointsTests.GenerateVideo_QueuesPrompt_AndReturnsResponse		100% VERIFIED
VID-002Video Generation & Media EndpointsEndpoints/WorkflowEndpoints.csWorkflowEndpointsTests.GenerateVideo_QueuesPrompt_AndReturnsResponse
WorkflowEndpointsTests.GetVideoFiles_ReturnsGeneratedVideos		100% VERIFIED
VID-003Interactive Video Player UIEngineStudioTabControl.axaml, MainViewModel.csMainViewModelTests.VideoPlayer_PlaybackControls_WorkAsExpected100% VERIFIED
AUD-001Kokoro TTS & OpenAI ProxyEndpoints/ModelProxyEndpoints.cs, AiEngineManager.csManagedTtsEngineTests.SynthesizeSpeech_ReturnsAudioStream
ManagedTtsEngineTests.OpenAiSpeechProxy_RoutesCorrectly		100% VERIFIED
AUD-002Stable Audio & YuE WorkflowsEndpoints/WorkflowEndpoints.cs, Workflows/Audio/*AudioWorkflowEndpointsTests.GenerateAudio_QueuesPrompt_AndReturnsResponse100% VERIFIED
AUD-003Waveform Visualizer & Audio UIEngineStudioTabControl.axaml, MainViewModel.csMainViewModelTests.AudioStudio_Playback_UpdatesState100% VERIFIED
PACK-001Modular Feature Pack Installersscripts/installer.iss, scripts/install.ps1, scripts/install_linux.shComponentManagerAndEndpointsTests.ComponentManager_DetectsPacks100% VERIFIED
PACK-002Component Manager Service & APIServices/ComponentManagerService.cs, Endpoints/ComponentEndpoints.csComponentManagerAndEndpointsTests.GetComponentsEndpoint_ReturnsList
ComponentManagerAndEndpointsTests.InstallComponentEndpoint_InstallsPack		100% VERIFIED
PACK-003Feature Pack Missing Banner UIControls/FeaturePackBannerControl.axamlMainViewModelTests.FeaturePackBanner_RendersGracefully100% VERIFIED
VRAM-001NVML CUDA GPU TelemetryServices/GpuTelemetryProvider.csProgramEndpointsAndServicesTests.GpuVramEndpoint_ReturnsHardwareTelemetry
ServicesAndEngineManagerCoverageTests.GpuTelemetryProvider_ParsesNvidiaSmi		100% VERIFIED
VRAM-002OS Telemetry FallbacksServices/GpuTelemetryProvider.csServicesAndEngineManagerCoverageTests.GpuTelemetryProvider_LinuxProcMemInfoFallback
DeepCoveragePushTests.GpuTelemetryProvider_RegistryFallback		100% VERIFIED
VRAM-003Real-Time Stacked VisualizerLocalLLMServerManager.Shared/ViewModels/TelemetryViewModel.csMainViewModelCoverageTests.TelemetryViewModel_CalculatesAllocatedPercentage100% VERIFIED
VRAM-004Proactive OOM OrchestratorServices/VramOrchestrator.csVramOrchestratorTests.EnsureVramForImageGenerationAsync_ExecutesCleanly
VramOrchestratorTests.EnsureVramForComfyUiAsync_ExecutesCleanly
VramOrchestratorTests.FreeComfyUiVramAsync_SendsPostToFreeEndpoint		100% VERIFIED
VRAM-005Configurable Telemetry ThresholdsLocalLLMServerManager.Shared/Models/AppSettings.csAppSettingsTests.AppSettings_SerializationAndDeserialization_PreservesData100% VERIFIED
MCP-001MCP Streamable HTTP / SSE HostProgram.cs, Endpoints/McpEndpoints.csMcpServerIntegrationTests.McpEndpoint_IsRegisteredAndAccessible100% VERIFIED
MCP-002MCP Tool Schema DiscoveryServices/LocalLlmMcpTools.cs, Endpoints/McpEndpoints.csMcpServerIntegrationTests.McpToolsClass_HasCorrectAttributesAndDescriptions
McpServerIntegrationTests.McpEndpoint_IsRegisteredAndAccessible		100% VERIFIED
MCP-003MCP Tool Invocation DispatchServices/LocalLlmMcpTools.csMcpServerIntegrationTests.GetGpuVram_ReturnsTelemetryData
McpServerIntegrationTests.CheckHealth_ReturnsStatusForBackends_WhenOnline
McpServerIntegrationTests.ListModels_ReturnsInstalledOllamaModels
McpServerIntegrationTests.PullModel_ValidName_InitiatesPull
McpServerIntegrationTests.UnloadVram_SendsKeepAliveZeroToOllama_Success
McpServerIntegrationTests.StartEngine_CallsEngineManagerAndReturnsResult
McpServerIntegrationTests.StopEngine_CallsEngineManagerAndReturnsResult
McpServerIntegrationTests.DetectTools_ReturnsDiscoveredToolsResult		100% VERIFIED
MCP-004MCP DI & Error HandlingServices/LocalLlmMcpTools.cs, Program.csMcpServerIntegrationTests.McpServer_DependencyInjectionResolution_Succeeds
McpServerIntegrationTests.CheckHealth_WhenHttpExceptionThrown_ReturnsErrorGracefully
McpServerIntegrationTests.UnloadVram_WhenHttpExceptionThrown_CatchesAndReturnsError
McpServerIntegrationTests.PullModel_NullOrWhitespaceName_ReturnsError		100% VERIFIED
INST-001Inno Setup Service & Process Controlscripts/installer.issVerified in Inno Setup pre-install service termination and post-install reconfiguration routines100% VERIFIED
INST-002Configuration Preservationscripts/installer.iss, scripts/install.ps1, scripts/update.ps1, scripts/install_linux.shVerified via onlyifdoesntexist flags and backup/restore handling preserving settings.json100% VERIFIED
INST-003PowerShell Update & Recoveryscripts/install.ps1, scripts/update.ps1Verified in PowerShell process termination, backup/restore, and service restart pipelines100% VERIFIED
INST-004Linux systemd In-Place Updatescripts/install_linux.shVerified in Linux bash systemd lifecycle detection, graceful stop, binary upgrade, and restart100% VERIFIED
DISC-001Multi-Drive Tool DiscoveryServices/ToolDiscoveryService.cs, Interfaces/IToolDiscoveryService.csToolDiscoveryServiceTests.DetectOllama_WhenInstalledInCustomRoot_DiscoversProperties
ToolDiscoveryServiceTests.DetectComfyUi_WhenPortableInstalled_DiscoversBatchAndDirectories
ToolDiscoveryServiceTests.DetectForge_WhenInstalled_DiscoversBatchAndModelsDirectory
ToolDiscoveryServiceTests.DetectAllToolsAsync_ReturnsAggregatedResultsAndSuggestions		100% VERIFIED
DISC-002Tool Detection REST APIEndpoints/DiscoveryEndpoints.csDiscoveryEndpointsTests.DetectToolsEndpoint_ReturnsToolDiscoveryResult100% VERIFIED
DISC-003Dynamic Path Validation APIEndpoints/DiscoveryEndpoints.csDiscoveryEndpointsTests.ValidatePathEndpoint_WithExistingDirectory_ReturnsValid
DiscoveryEndpointsTests.ValidatePathEndpoint_WithInvalidPath_ReturnsNotFound		100% VERIFIED
DISC-004Settings UI Pickers & Status BadgesSettingsViewModel.cs, SettingsTabControl.axamlSettingsViewModelCoverageTests.PathChanges_UpdateStatusIndicatorsDynamically
SettingsViewModelCoverageTests.AutoDetectToolsAsync_PopulatesEmptyPathsAndDiscoveredStatus
SettingsViewModelCoverageTests.BrowseFileCommands_WithStorageProvider_SetsSelectedPath
SettingsViewModelCoverageTests.BrowseFolderCommands_WithStorageProvider_SetsSelectedPath		100% VERIFIED
DISC-005Parameterized Automation Scriptsscripts/*.ps1, scripts/*.shManual and automated script syntax tests across Windows and Linux100% VERIFIED
UI-001Fluent Dark Theme Design TokensLocalLLMServerManager.Shared/Styles/DesignTokens.axamlMainWindowUiTests.AppStyles_AppliesDarkTheme100% VERIFIED
UI-002Modular SOLID UserControlsLocalLLMServerManager.Shared/Views/Controls/*MainWindowUiTests.MainView_LoadsAllUserControls100% VERIFIED
UI-003Toast Notification DispatcherLocalLLMServerManager.Shared/Services/ToastService.csMainViewModelCoverageTests.ToastService_DispatchesAndAutoDismisses100% VERIFIED
UI-004Cross-Platform URL LauncherLocalLLMServerManager.Shared/Services/BrowserLauncher.csBrowserLauncherTests.LaunchUrl_Windows_ExecutesShell
BrowserLauncherTests.LaunchUrl_Linux_ExecutesXdgOpen
BrowserLauncherTests.LaunchUrl_InvalidUrl_DoesNotThrow		100% VERIFIED
WASM-001Avalonia WebAssembly ClientLocalLLMServerManager.Web/Program.csPlaywrightWasmE2ETests.WebDashboard_BootsCleanlyWithoutConsoleOr404Errors100% VERIFIED
WASM-002Kestrel Static MIME ProviderProgram.csStaticFileMimeTypeTests.StaticFileMimeTypes_MapsWasmAndGlbCorrectly
PlaywrightWasmE2ETests.WebDashboard_BootsCleanlyWithoutConsoleOr404Errors		100% VERIFIED
WASM-003Browser Model Proxy RoutingEndpoints/ModelProxyEndpoints.csProgramEndpointsAndServicesTests.ModelsProxyEndpoint_ReturnsAggregatedModels100% VERIFIED
E2E-001Headless Playwright SwiftShader HarnessLocalLLMServerManager.Tests/PlaywrightWasmE2ETests.csPlaywrightWasmE2ETests.WebDashboard_BootsCleanlyWithoutConsoleOr404Errors100% VERIFIED
E2E-002Zero-Error WebAssembly Boot AssertionLocalLLMServerManager.Tests/PlaywrightWasmE2ETests.csPlaywrightWasmE2ETests.WebDashboard_BootsCleanlyWithoutConsoleOr404Errors100% VERIFIED
E2E-003Automated Documentation Screenshot GeneratorLocalLLMServerManager.Tests/PlaywrightScreenshotGenerator.csPlaywrightScreenshotGenerator.GenerateRealDocScreenshots100% VERIFIED

🔍 Requirements Gap Analysis & Future Roadmap ​

The following auxiliary items and future enhancements represent capabilities that are intentionally cataloged for future versions and are not yet covered by automated tests:

Gap IdentifierTitle & DescriptionImpact & Planned Roadmap
GAP-GPU-001Multi-GPU Telemetry & Device SelectorCurrently, telemetry queries the primary GPU index (gpu:0). Future versions will add a dropdown to select between multiple installed discrete GPUs and show aggregated multi-GPU telemetry.
GAP-GPU-002AMD ROCm & Apple Silicon Metal TelemetryCurrent telemetry uses NVML (nvidia-smi) for NVIDIA GPUs with CPU/RAM fallback. Direct telemetry for AMD ROCm (rocm-smi) and Apple Silicon unified memory will be added in a future update.
GAP-MCP-001OAuth2 / Bearer Token Auth for MCP EndpointsThe Model Context Protocol endpoint /mcp is currently open for local loopback AI assistants. External remote network access will incorporate token authentication in v4.0.
GAP-UI-001Mobile Touch Swipe Tab Navigation in WASMOn mobile browser viewports, tabs are accessible via the header navigation bar. Direct touch swipe gestures across tabs are planned for an upcoming WASM UI polish release.

Released under the MIT License.

Copyright © Spelech