spelech · Sep 18, 2026 · Sep 18, 2026 · Sep 18, 2026 · Sep 18, 2026 · Sep 18, 2026
diff --git a/.github/workflows/deploy-pages.yml b/.github/workflows/deploy-pages.yml
@@ -0,0 +1,58 @@
+name: Deploy VitePress Documentation to Pages
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'docs/**'
+      - '.github/workflows/deploy-pages.yml'
+      - 'package.json'
+      - 'package-lock.json'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install Dependencies
+        run: npm ci
+
+      - name: Build VitePress Site
+        run: npm run docs:build
+
+      - name: Upload Pages Artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/.vitepress/dist
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    needs: build
+    runs-on: ubuntu-latest
+    name: Deploy
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
diff --git a/LocalLLMServerManager.Shared/Views/Controls/DocumentationTabControl.axaml b/LocalLLMServerManager.Shared/Views/Controls/DocumentationTabControl.axaml
@@ -10,7 +10,7 @@
             <Grid RowDefinitions="Auto, *">
                 <StackPanel Grid.Row="0" Spacing="4" Margin="0,0,0,12">
                     <TextBlock Text="📖 User Manual &amp; Guides" FontSize="14" FontWeight="Bold" Foreground="{StaticResource TextMainBrush}"/>
-                    <TextBlock Text="ASD-STE100 Simplified Technical English" FontSize="10" Foreground="{StaticResource TextMutedBrush}"/>
+                    <TextBlock Text="Step-by-Step Instructions" FontSize="10" Foreground="{StaticResource TextMutedBrush}"/>
                 </StackPanel>
 
                 <ScrollViewer Grid.Row="1">
@@ -53,7 +53,7 @@
                             <TextBlock Text="{Binding Summary}" FontSize="13" Foreground="{StaticResource TextMutedBrush}" TextWrapping="Wrap" Margin="0,2,0,0"/>
                         </StackPanel>
                         <Border Grid.Column="1" Classes="matte-pill" Padding="8,4" VerticalAlignment="Top" Background="#1A2234" BorderBrush="{StaticResource PrimaryBrush}" BorderThickness="1">
-                            <TextBlock Text="ASD-STE100 Verified" FontSize="10" Foreground="{StaticResource PrimaryBrush}" FontWeight="Bold"/>
+                            <TextBlock Text="Verified Guide" FontSize="10" Foreground="{StaticResource PrimaryBrush}" FontWeight="Bold"/>
                         </Border>
                     </Grid>
 

diff --git a/LocalLLMServerManager.Shared/Views/MainView.axaml b/LocalLLMServerManager.Shared/Views/MainView.axaml
@@ -47,7 +47,7 @@
                 <controls:AiAssistantTabControl DataContext="{Binding Assistant}"/>
             </TabItem>
 
-            <!-- TAB 5: In-App ASD-STE100 Documentation -->
+            <!-- TAB 5: In-App Documentation -->
             <TabItem Header="📖 Documentation">
                 <controls:DocumentationTabControl DataContext="{Binding Documentation}"/>
             </TabItem>

diff --git a/Prompts/app-control.md b/Prompts/app-control.md
@@ -37,7 +37,7 @@ You have access to tools that allow you to directly inspect and manage LocalLLMS
 - **Trigger**: User asks "read this aloud", "generate audio for...".
 
 ### 9. `query_app_documentation(query)`
-- **Purpose**: Search the in-app ASD-STE100 technical documentation for specific questions.
+- **Purpose**: Search the in-app technical documentation guides for specific questions.
 - **Trigger**: User asks specific questions about how features work or how to configure complex settings.
 
 ## Execution Rules

diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
@@ -0,0 +1,113 @@
+import { defineConfig } from 'vitepress';
+
+// https://vitepress.dev/reference/site-config
+export default defineConfig({
+  title: 'Local LLM Server Manager',
+  description: 'User Guide and Documentation for Local AI Engines, Multimodal Studio, and MCP Tools',
+  base: '/LocalLLMServerManager/',
+  cleanUrls: true,
+  srcExclude: [
+    'superpowers/**',
+    'legacy-web-dash/**'
+  ],
+
+  themeConfig: {
+    logo: '/images/logo.png',
+    siteTitle: 'Local LLM Server Manager',
+
+    nav: [
+      { text: 'Guide', link: '/getting-started/installation' },
+      { text: 'Engines', link: '/engines/' },
+      { text: 'Studio', link: '/studio/' },
+      { text: 'AI & MCP', link: '/ai-and-mcp/' },
+      { text: 'Technical Reference', link: '/technical/' },
+      { text: 'Style Guide', link: '/standards/ste-100' }
+    ],
+
+    sidebar: {
+      '/getting-started/': [
+        {
+          text: 'Getting Started',
+          items: [
+            { text: 'Overview & Requirements', link: '/getting-started/' },
+            { text: 'Installation', link: '/getting-started/installation' },
+            { text: 'Configuration', link: '/getting-started/configuration' },
+            { text: 'Quickstart Guide', link: '/getting-started/quickstart' },
+            { text: 'Troubleshooting', link: '/getting-started/troubleshooting' }
+          ]
+        }
+      ],
+      '/engines/': [
+        {
+          text: 'Engines & Model Management',
+          items: [
+            { text: 'Engines Overview & VRAM', link: '/engines/' },
+            { text: 'Ollama LLM Engine', link: '/engines/ollama' },
+            { text: 'Stable Diffusion Forge', link: '/engines/sd-forge' },
+            { text: 'ComfyUI Engine', link: '/engines/comfyui' },
+            { text: 'Kokoro TTS Engine', link: '/engines/kokoro-tts' },
+            { text: 'Model Hubs & Downloads', link: '/engines/model-management' }
+          ]
+        }
+      ],
+      '/studio/': [
+        {
+          text: 'Multimodal Studio',
+          items: [
+            { text: 'Studio Overview', link: '/studio/' },
+            { text: 'Image Generation', link: '/studio/image-generation' },
+            { text: 'Video Generation', link: '/studio/video-generation' },
+            { text: 'Audio & Music Synthesis', link: '/studio/audio-and-music' },
+            { text: '3D Mesh Reconstruction', link: '/studio/3d-mesh' }
+          ]
+        }
+      ],
+      '/ai-and-mcp/': [
+        {
+          text: 'AI & MCP Tools',
+          items: [
+            { text: 'Overview', link: '/ai-and-mcp/' },
+            { text: 'AI Chat Assistant', link: '/ai-and-mcp/assistant' },
+            { text: 'Model Context Protocol (MCP)', link: '/ai-and-mcp/mcp-tools' },
+            { text: 'Workflow Presets', link: '/ai-and-mcp/flows-and-presets' }
+          ]
+        }
+      ],
+      '/technical/': [
+        {
+          text: 'Technical Reference (Developers & Agents)',
+          items: [
+            { text: 'Technical Overview', link: '/technical/' },
+            { text: 'System Architecture', link: '/technical/architecture' },
+            { text: 'Development & Build Guide', link: '/technical/development' },
+            { text: 'Requirements Specification', link: '/technical/requirements' },
+            { text: 'Windows Process Validation', link: '/technical/validation' },
+            { text: 'Test Coverage Benchmarks', link: '/technical/test-coverage' },
+            { text: 'AI Assistant Internals', link: '/technical/ai-assistant-internals' }
+          ]
+        }
+      ],
+      '/standards/': [
+        {
+          text: 'Writing Guidelines',
+          items: [
+            { text: 'Documentation Style Guide', link: '/standards/ste-100' }
+          ]
+        }
+      ]
+    },
+
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/spelech/LocalLLMServerManager' }
+    ],
+
+    search: {
+      provider: 'local'
+    },
+
+    footer: {
+      message: 'Released under the MIT License.',
+      copyright: 'Copyright © Spelech'
+    }
+  }
+});
diff --git a/docs/ai-and-mcp/assistant.md b/docs/ai-and-mcp/assistant.md
@@ -0,0 +1,184 @@
+---
+title: AI Chat Assistant
+description: User guide for the in-app AI Chat Assistant, model selection, capability badges, multimodal attachments, and tool approval.
+outline: deep
+---
+
+# AI Chat Assistant
+
+The AI Chat Assistant provides an interactive copilot directly inside Local LLM Server Manager. You can control local engines, inspect hardware metrics, and troubleshoot generation errors through plain-language dialogue.
+
+---
+
+## Open the AI Assistant
+
+Follow these steps to access the assistant interface:
+
+1. Launch **Local LLM Server Manager**.
+2. Click the **AI Assistant** tab in the top navigation bar.
+3. Verify that the chat view loads with the header toolbar, suggestion chips, and composer bar.
+
+```
++-----------------------------------------------------------------------+
+|  🤖 AI Assistant & App Copilot       Model: gemini-2.5-flash   [Setup]|
++-----------------------------------------------------------------------+
+|                                                                       |
+|  [Chat Message History Area]                                          |
+|                                                                       |
++-----------------------------------------------------------------------+
+|  [⚡ Check live VRAM]  [🦙 Can I run Llama 70B?]  [🎨 Generate image]  |
++-----------------------------------------------------------------------+
+|  [📎] [Enter prompt here...]                    [👁️ ⚡ 1M] [🚀 Send]    |
++-----------------------------------------------------------------------+
+```
+
+---
+
+## Configure the Connection Gateway
+
+The assistant requires a connection to an external gateway, such as a LiteLLM proxy or Vertex AI endpoint.
+
+Follow these steps to configure your connection:
+
+1. Click **⚙️ Setup & Endpoint** in the upper-right toolbar.
+2. Enter your gateway URL in the **OpenAI-Compatible Endpoint URL** field (for example, `http://127.0.0.1:4000/v1`).
+3. Enter your secret credential in the **API Key** field. Leave this field blank if your local LiteLLM server does not require authentication.
+4. Enter the default model name in the **Model Identifier** field (for example, `vertex_ai/gemini-2.5-flash`).
+5. Click **⚡ Test Connection**. The application validates network latency and queries available models.
+6. Click **💾 Save Settings** to store your configuration in `settings.json`.
+
+> [!TIP]
+> Run a local LiteLLM container on port `4000`. LiteLLM translates OpenAI format requests into Google Vertex AI Gemini Flash calls with zero local GPU usage.
+
+---
+
+## Select Models & Inspect Capability Badges
+
+The composer bar features a dynamic model selector dropdown. The discovery engine inspects remote model metadata and renders compact capability badges.
+
+```mermaid
+flowchart LR
+    Discovery["LiteLLM /model/info\nor /v1/models"] --> Parser["Capability Discovery Engine"]
+    Parser --> Badge["Summary Badge\n👁️ ⚡ 1M [vertex_ai]"]
+    Badge --> UI["Model Selector Dropdown"]
+```
+
+### Capability Badge Reference
+
+Each badge informs you about the features supported by that specific model:
+
+| Badge Icon | Capability Name | Meaning |
+| :--- | :--- | :--- |
+| `👁️` | **Vision** | The model accepts image attachments alongside text prompts. |
+| `⚡` | **Function Calling** | The model supports autonomous tool calling and application control. |
+| `1M` / `128k` | **Context Window** | The maximum input token capacity (`1M` = 1,000,000 tokens, `128k` = 128,000 tokens). |
+| `[provider]` | **Provider Tag** | Identifies the hosting backend (e.g. `[vertex_ai]`, `[openai]`, `[anthropic]`). |
+
+### Common Model Examples
+
+* `👁️ ⚡ 1M [vertex_ai]` (`vertex_ai/gemini-2.5-flash`): Accepts images, executes tools, and supports massive 1-million-token contexts.
+* `👁️ ⚡ 128k [openai]` (`gpt-4o`): Accepts images and executes tools with a 128,000-token context.
+* `⚡ 128k [anthropic]` (`claude-3-5-haiku`): Fast text reasoning and tool calling without image input.
+
+### Local Model Exclusion Filter
+
+By default, the assistant excludes local LLMs (such as models hosted directly in Ollama) from the assistant dropdown.
+
+> [!IMPORTANT]
+> The assistant excludes local LLMs intentionally. Running assistant queries on local GPUs consumes memory needed for diffusion rendering and audio synthesis. External models guarantee zero VRAM impact on your creative engines.
+
+---
+
+## Attach Multimodal Images
+
+You can supply visual context to vision-enabled models. Attach screenshots of ComfyUI errors, generation outputs, or reference pictures.
+
+### Add Attachments
+
+Choose one of the following methods to attach an image:
+
+* **File Browser**: Click the attachment button (**📎**) next to the prompt text box. Select a `PNG`, `JPG`, `WEBP`, or `GIF` image.
+* **Clipboard Paste**: Capture a screenshot with your operating system shortcut. Click inside the prompt text box and press **Ctrl+V**.
+
+### Manage the Staged Image Tray
+
+Staged images appear in a preview tray directly above the text box:
+
+1. Review the generated thumbnail and filename.
+2. Click the remove button (**✕**) on any card to delete unwanted attachments before sending.
+3. Type your question (for example: *"Review this error message and suggest the correct resolution"*).
+4. Click **🚀 Send** or press **Enter**.
+
+```
++-----------------------------------------------------------------------+
+| Staged Attachments:                                                   |
+| [🖼️ error_screenshot.png  ✕]  [🖼️ comfyui_graph.png  ✕]              |
++-----------------------------------------------------------------------+
+| [📎] Why did this ComfyUI node fail?            [👁️ ⚡ 1M] [🚀 Send]   |
++-----------------------------------------------------------------------+
+```
+
+---
+
+## Tool Execution & Safety Controls
+
+When you ask the assistant to perform an action, the model executes native C# tools autonomously.
+
+### Inline Execution Cards
+
+During tool calling, the assistant displays an execution card inside the chat response bubble:
+
+* **Tool Name**: Displays the executed function (e.g., `get_gpu_vram_telemetry`).
+* **Execution Time**: Shows tool duration in milliseconds.
+* **Arguments**: Details the parameter values sent to the tool.
+* **Result**: Displays the response data returned to the model.
+
+```
++-------------------------------------------------------------------+
+| 🤖 Copilot                                               14:32    |
+|                                                                   |
+| +---------------------------------------------------------------+ |
+| | ⚡ Tool: calculate_hardware_fit                       12 ms   | |
+| | Args: {"modelName": "llama3.3:70b", "quantization": "Q4_K_M"} | |
+| | Result: {"verdict": "PERFECT FIT", "vramRequiredMb": 41200}   | |
+| +---------------------------------------------------------------+ |
+|                                                                   |
+| Llama 3.3 70B in Q4_K_M quantization fits comfortably in your    |
+| configured 48 GB VRAM pool.                                       |
++-------------------------------------------------------------------+
+```
+
+### Safety and Approval Boundaries
+
+The assistant operates under strict safety policies defined in `Prompts/app-control.md`:
+
+* The assistant cannot modify sensitive system directories or arbitrary executable paths.
+* Sensitive values like API keys appear masked in tool outputs.
+* You can cancel any running operation immediately by clicking **⏹️ Stop**.
+
+> [!WARNING]
+> Do not share your screen or logs while displaying unmasked API tokens. Always keep secret credentials in your private configuration files.
+
+---
+
+## Toolbar Actions & Quick Chips
+
+### Suggestion Chips
+Click any suggestion chip above the composer to trigger pre-built diagnostic tasks:
+
+* **⚡ Check live VRAM and GPU telemetry**: Queries active VRAM allocation.
+* **🦙 Can I run Llama 3.3 70B**: Runs a memory fit calculation.
+* **🎨 Generate a scenic landscape**: Submits a prompt to your default image engine.
+* **🛑 Unload all models from VRAM**: Frees GPU memory immediately.
+
+### Header Controls
+* **🔄 Reload Prompts**: Flushes cached markdown prompt files from memory immediately.
+* **🧹 Clear Chat**: Deletes conversation history and resets token context.
+
+---
+
+## Related Documentation
+
+* [Model Context Protocol (MCP) Tools](./mcp-tools.md): Learn how external agents access application tools.
+* [Living Prompts & Workflow Presets](./flows-and-presets.md): Customize system prompts and automated workflows.
+* [AI Assistant Technical Internals](../technical/ai-assistant-internals.md): Read the technical architecture specification.