loki-mode 5.30.0 → 5.32.0

package/autonomy/run.sh

@@ -712,15 +712,28 @@ emit_learning_signal() {
 
 # Track iteration timing for efficiency signals
 ITERATION_START_MS=""
+
+# Get current time in milliseconds (portable: works on macOS BSD date and GNU date)
+_now_ms() {
+    local ms
+    ms=$(date +%s%3N 2>/dev/null)
+    # macOS BSD date doesn't support %N -- outputs literal "N" or "%3N"
+    # Detect non-numeric output and fall back to seconds * 1000
+    case "$ms" in
+        *[!0-9]*) echo $(( $(date +%s) * 1000 )) ;;
+        *)        echo "$ms" ;;
+    esac
+}
+
 record_iteration_start() {
-    ITERATION_START_MS=$(date +%s%3N 2>/dev/null || echo $(($(date +%s) * 1000)))
+    ITERATION_START_MS=$(_now_ms)
 }
 
 # Get iteration duration in milliseconds
 get_iteration_duration_ms() {
     if [ -n "$ITERATION_START_MS" ]; then
         local end_ms
-        end_ms=$(date +%s%3N 2>/dev/null || echo $(($(date +%s) * 1000)))
+        end_ms=$(_now_ms)
         echo $((end_ms - ITERATION_START_MS))
     else
         echo "0"
@@ -2577,7 +2590,7 @@ track_iteration_complete() {
     elif [ "${PROVIDER_NAME:-claude}" = "gemini" ]; then
         model_tier="gemini-3-pro"
     fi
-    local phase="$current_phase"
+    local phase="${LAST_KNOWN_PHASE:-}"
     [ -z "$phase" ] && phase=$(python3 -c "import json; print(json.load(open('.loki/state/orchestrator.json')).get('currentPhase', 'unknown'))" 2>/dev/null || echo "unknown")
     cat > ".loki/metrics/efficiency/iteration-${iteration}.json" << EFF_EOF
 {

package/dashboard/__init__.py

@@ -7,7 +7,7 @@ Modules:
     control: Session control API (start/stop/pause/resume)
 """
 
-__version__ = "5.30.0"
+__version__ = "5.32.0"
 
 # Expose the control app for easy import
 try:

package/dashboard/server.py

@@ -2200,7 +2200,7 @@ except ImportError as e:
 # =============================================================================
 # Must be configured AFTER all API routes to avoid conflicts
 
-from fastapi.responses import FileResponse, HTMLResponse
+from fastapi.responses import FileResponse, HTMLResponse, Response
 
 # Find static files in multiple possible locations
 DASHBOARD_DIR = os.path.dirname(os.path.abspath(__file__))
@@ -2240,6 +2240,17 @@ if STATIC_DIR:
     if os.path.isdir(ASSETS_DIR):
         app.mount("/assets", StaticFiles(directory=ASSETS_DIR), name="assets")
 
+# Serve favicon.svg from static directory
+@app.get("/favicon.svg", include_in_schema=False)
+async def serve_favicon():
+    """Serve the dashboard favicon."""
+    if STATIC_DIR:
+        favicon_path = os.path.join(STATIC_DIR, "favicon.svg")
+        if os.path.isfile(favicon_path):
+            return FileResponse(favicon_path, media_type="image/svg+xml")
+    return Response(status_code=404)
+
+
 # Serve index.html or standalone HTML for root
 @app.get("/", include_in_schema=False)
 async def serve_index():

package/dashboard/static/favicon.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" width="32" height="32">
+  <path d="M16 6C8 6 2 16 2 16s6 10 14 10 14-10 14-10S24 6 16 6z" fill="none" stroke="#7c3aed" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+  <circle cx="16" cy="16" r="5" fill="#7c3aed"/>
+  <circle cx="16" cy="16" r="2" fill="#fff"/>
+</svg>

package/dashboard/static/index.html

@@ -6,7 +6,7 @@
   <meta name="description" content="Loki Mode Dashboard - Self-contained autonomous AI system monitor">
   <meta name="theme-color" content="#8b5cf6">
   <title>Loki Mode Dashboard</title>
-  <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><rect fill='%238b5cf6' rx='15' width='100' height='100'/><text x='50' y='72' font-size='60' font-weight='bold' text-anchor='middle' fill='white'>L</text></svg>">
+  <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32' width='32' height='32'><path d='M16 6C8 6 2 16 2 16s6 10 14 10 14-10 14-10S24 6 16 6z' fill='none' stroke='%237c3aed' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'/><circle cx='16' cy='16' r='5' fill='%237c3aed'/><circle cx='16' cy='16' r='2' fill='%23fff'/></svg>">
   <style>
     /* CSS Reset and Base Styles */
     :root {
@@ -351,6 +351,105 @@
     ::-webkit-scrollbar-track { background: transparent; }
     ::-webkit-scrollbar-thumb { background: rgba(0,0,0,0.1); border-radius: 3px; }
     ::-webkit-scrollbar-thumb:hover { background: rgba(0,0,0,0.2); }
+
+    /* Keyboard Shortcuts Help Overlay */
+    .shortcuts-overlay {
+      display: none;
+      position: fixed;
+      inset: 0;
+      background: rgba(0, 0, 0, 0.6);
+      z-index: 1000;
+      align-items: center;
+      justify-content: center;
+    }
+
+    .shortcuts-overlay.visible {
+      display: flex;
+    }
+
+    .shortcuts-dialog {
+      background: var(--loki-bg-card);
+      border: 1px solid var(--loki-border);
+      border-radius: 12px;
+      padding: 24px;
+      max-width: 480px;
+      width: 90%;
+      max-height: 80vh;
+      overflow-y: auto;
+      box-shadow: 0 8px 32px rgba(0, 0, 0, 0.3);
+    }
+
+    .shortcuts-header {
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+      margin-bottom: 16px;
+      padding-bottom: 12px;
+      border-bottom: 1px solid var(--loki-border);
+    }
+
+    .shortcuts-title {
+      font-size: 16px;
+      font-weight: 600;
+      color: var(--loki-text-primary);
+    }
+
+    .shortcuts-close {
+      background: none;
+      border: none;
+      color: var(--loki-text-muted);
+      cursor: pointer;
+      padding: 4px;
+      font-size: 18px;
+      line-height: 1;
+    }
+
+    .shortcuts-close:hover {
+      color: var(--loki-text-primary);
+    }
+
+    .shortcuts-group {
+      margin-bottom: 16px;
+    }
+
+    .shortcuts-group-title {
+      font-size: 11px;
+      font-weight: 600;
+      text-transform: uppercase;
+      letter-spacing: 0.5px;
+      color: var(--loki-text-muted);
+      margin-bottom: 8px;
+    }
+
+    .shortcut-row {
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+      padding: 4px 0;
+    }
+
+    .shortcut-keys {
+      display: flex;
+      gap: 4px;
+    }
+
+    .shortcut-key {
+      display: inline-block;
+      padding: 2px 8px;
+      background: var(--loki-bg-tertiary);
+      border: 1px solid var(--loki-border);
+      border-radius: 4px;
+      font-size: 12px;
+      font-family: 'JetBrains Mono', monospace;
+      color: var(--loki-text-primary);
+      min-width: 24px;
+      text-align: center;
+    }
+
+    .shortcut-desc {
+      font-size: 13px;
+      color: var(--loki-text-secondary);
+    }
   </style>
 </head>
 <body>
@@ -411,7 +510,9 @@
         <div class="sidebar-controls">
           <input type="text" class="api-url-input" id="api-url" placeholder="API URL">
           <button class="api-btn" id="connect-btn">Go</button>
-          <button class="theme-toggle" id="theme-toggle">
+          <button class="theme-toggle" id="theme-toggle" title="Toggle theme (T)">
+            <svg id="theme-icon-sun" width="14" height="14" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2" fill="none" style="display:none"><circle cx="12" cy="12" r="5"/><line x1="12" y1="1" x2="12" y2="3"/><line x1="12" y1="21" x2="12" y2="23"/><line x1="4.22" y1="4.22" x2="5.64" y2="5.64"/><line x1="18.36" y1="18.36" x2="19.78" y2="19.78"/><line x1="1" y1="12" x2="3" y2="12"/><line x1="21" y1="12" x2="23" y2="12"/><line x1="4.22" y1="19.78" x2="5.64" y2="18.36"/><line x1="18.36" y1="5.64" x2="19.78" y2="4.22"/></svg>
+            <svg id="theme-icon-moon" width="14" height="14" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2" fill="none" style="display:none"><path d="M21 12.79A9 9 0 1111.21 3 7 7 0 0021 12.79z"/></svg>
             <span id="theme-label">Dark</span>
           </button>
         </div>
@@ -475,6 +576,39 @@
     </main>
   </div>
 
+  <!-- Keyboard Shortcuts Help Overlay -->
+  <div class="shortcuts-overlay" id="shortcuts-overlay">
+    <div class="shortcuts-dialog">
+      <div class="shortcuts-header">
+        <span class="shortcuts-title">Keyboard Shortcuts</span>
+        <button class="shortcuts-close" id="shortcuts-close" aria-label="Close">&times;</button>
+      </div>
+      <div class="shortcuts-group">
+        <div class="shortcuts-group-title">Navigation</div>
+        <div class="shortcut-row"><span class="shortcut-desc">Overview</span><span class="shortcut-keys"><kbd class="shortcut-key">1</kbd></span></div>
+        <div class="shortcut-row"><span class="shortcut-desc">Tasks</span><span class="shortcut-keys"><kbd class="shortcut-key">2</kbd></span></div>
+        <div class="shortcut-row"><span class="shortcut-desc">Logs</span><span class="shortcut-keys"><kbd class="shortcut-key">3</kbd></span></div>
+        <div class="shortcut-row"><span class="shortcut-desc">Memory</span><span class="shortcut-keys"><kbd class="shortcut-key">4</kbd></span></div>
+        <div class="shortcut-row"><span class="shortcut-desc">Learning</span><span class="shortcut-keys"><kbd class="shortcut-key">5</kbd></span></div>
+        <div class="shortcut-row"><span class="shortcut-desc">Council</span><span class="shortcut-keys"><kbd class="shortcut-key">6</kbd></span></div>
+        <div class="shortcut-row"><span class="shortcut-desc">Cost</span><span class="shortcut-keys"><kbd class="shortcut-key">7</kbd></span></div>
+      </div>
+      <div class="shortcuts-group">
+        <div class="shortcuts-group-title">Session</div>
+        <div class="shortcut-row"><span class="shortcut-desc">Pause session</span><span class="shortcut-keys"><kbd class="shortcut-key">p</kbd></span></div>
+        <div class="shortcut-row"><span class="shortcut-desc">Resume session</span><span class="shortcut-keys"><kbd class="shortcut-key">r</kbd></span></div>
+        <div class="shortcut-row"><span class="shortcut-desc">Stop session</span><span class="shortcut-keys"><kbd class="shortcut-key">s</kbd></span></div>
+      </div>
+      <div class="shortcuts-group">
+        <div class="shortcuts-group-title">General</div>
+        <div class="shortcut-row"><span class="shortcut-desc">Toggle theme</span><span class="shortcut-keys"><kbd class="shortcut-key">t</kbd></span></div>
+        <div class="shortcut-row"><span class="shortcut-desc">Focus API URL</span><span class="shortcut-keys"><kbd class="shortcut-key">/</kbd></span></div>
+        <div class="shortcut-row"><span class="shortcut-desc">Show shortcuts</span><span class="shortcut-keys"><kbd class="shortcut-key">?</kbd></span></div>
+        <div class="shortcut-row"><span class="shortcut-desc">Close overlay</span><span class="shortcut-keys"><kbd class="shortcut-key">Esc</kbd></span></div>
+      </div>
+    </div>
+  </div>
+
   <!-- Inlined JavaScript Bundle -->
   <script>
 var LokiDashboard=(()=>{var N=Object.defineProperty;var se=Object.getOwnPropertyDescriptor;var re=Object.getOwnPropertyNames;var oe=Object.prototype.hasOwnProperty;var ne=(l,e,t)=>e in l?N(l,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):l[e]=t;var le=(l,e)=>{for(var t in e)N(l,t,{get:e[t],enumerable:!0})},de=(l,e,t,a)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of re(e))!oe.call(l,i)&&i!==t&&N(l,i,{get:()=>e[i],enumerable:!(a=se(e,i))||a.enumerable});return l};var ce=l=>de(N({},"__esModule",{value:!0}),l);var k=(l,e,t)=>ne(l,typeof e!="symbol"?e+"":e,t);var _e={};le(_e,{ANIMATION:()=>w,ARIA_PATTERNS:()=>G,ApiEvents:()=>o,BASE_STYLES:()=>I,BREAKPOINTS:()=>q,COMMON_STYLES:()=>X,KEYBOARD_SHORTCUTS:()=>K,KeyboardHandler:()=>A,LokiApiClient:()=>L,LokiCostDashboard:()=>F,LokiCouncilDashboard:()=>O,LokiElement:()=>c,LokiLearningDashboard:()=>H,LokiLogStream:()=>B,LokiMemoryBrowser:()=>U,LokiOverview:()=>M,LokiSessionControl:()=>j,LokiState:()=>R,LokiTaskBoard:()=>z,LokiTheme:()=>T,RADIUS:()=>y,SPACING:()=>_,STATE_CHANGE_EVENT:()=>Y,THEMES:()=>b,THEME_VARIABLES:()=>V,TYPOGRAPHY:()=>v,UnifiedThemeManager:()=>h,VERSION:()=>ke,Z_INDEX:()=>$,createApiClient:()=>ee,createStore:()=>te,generateThemeCSS:()=>m,generateTokensCSS:()=>P,getApiClient:()=>g,getState:()=>C,init:()=>fe});var b={light:{"--loki-bg-primary":"#fafafa","--loki-bg-secondary":"#f4f4f5","--loki-bg-tertiary":"#e4e4e7","--loki-bg-card":"#ffffff","--loki-bg-hover":"#f0f0f3","--loki-bg-active":"#e8e8ec","--loki-bg-overlay":"rgba(0, 0, 0, 0.5)","--loki-accent":"#7c3aed","--loki-accent-hover":"#6d28d9","--loki-accent-active":"#5b21b6","--loki-accent-light":"#8b5cf6","--loki-accent-muted":"rgba(124, 58, 237, 0.12)","--loki-text-primary":"#18181b","--loki-text-secondary":"#52525b","--loki-text-muted":"#a1a1aa","--loki-text-disabled":"#d4d4d8","--loki-text-inverse":"#ffffff","--loki-border":"#e4e4e7","--loki-border-light":"#d4d4d8","--loki-border-focus":"#7c3aed","--loki-success":"#16a34a","--loki-success-muted":"rgba(22, 163, 74, 0.12)","--loki-warning":"#ca8a04","--loki-warning-muted":"rgba(202, 138, 4, 0.12)","--loki-error":"#dc2626","--loki-error-muted":"rgba(220, 38, 38, 0.12)","--loki-info":"#2563eb","--loki-info-muted":"rgba(37, 99, 235, 0.12)","--loki-green":"#16a34a","--loki-green-muted":"rgba(22, 163, 74, 0.12)","--loki-yellow":"#ca8a04","--loki-yellow-muted":"rgba(202, 138, 4, 0.12)","--loki-red":"#dc2626","--loki-red-muted":"rgba(220, 38, 38, 0.12)","--loki-blue":"#2563eb","--loki-blue-muted":"rgba(37, 99, 235, 0.12)","--loki-purple":"#9333ea","--loki-purple-muted":"rgba(147, 51, 234, 0.12)","--loki-opus":"#d97706","--loki-sonnet":"#4f46e5","--loki-haiku":"#059669","--loki-shadow-sm":"0 1px 2px rgba(0, 0, 0, 0.05)","--loki-shadow-md":"0 4px 6px rgba(0, 0, 0, 0.07)","--loki-shadow-lg":"0 10px 15px rgba(0, 0, 0, 0.1)","--loki-shadow-focus":"0 0 0 3px rgba(124, 58, 237, 0.3)"},dark:{"--loki-bg-primary":"#09090b","--loki-bg-secondary":"#0c0c0f","--loki-bg-tertiary":"#111114","--loki-bg-card":"#18181b","--loki-bg-hover":"#1f1f23","--loki-bg-active":"#27272a","--loki-bg-overlay":"rgba(0, 0, 0, 0.8)","--loki-accent":"#8b5cf6","--loki-accent-hover":"#a78bfa","--loki-accent-active":"#7c3aed","--loki-accent-light":"#a78bfa","--loki-accent-muted":"rgba(139, 92, 246, 0.15)","--loki-text-primary":"#fafafa","--loki-text-secondary":"#a1a1aa","--loki-text-muted":"#52525b","--loki-text-disabled":"#3f3f46","--loki-text-inverse":"#09090b","--loki-border":"rgba(255, 255, 255, 0.06)","--loki-border-light":"rgba(255, 255, 255, 0.1)","--loki-border-focus":"#8b5cf6","--loki-success":"#22c55e","--loki-success-muted":"rgba(34, 197, 94, 0.15)","--loki-warning":"#eab308","--loki-warning-muted":"rgba(234, 179, 8, 0.15)","--loki-error":"#ef4444","--loki-error-muted":"rgba(239, 68, 68, 0.15)","--loki-info":"#3b82f6","--loki-info-muted":"rgba(59, 130, 246, 0.15)","--loki-green":"#22c55e","--loki-green-muted":"rgba(34, 197, 94, 0.15)","--loki-yellow":"#eab308","--loki-yellow-muted":"rgba(234, 179, 8, 0.15)","--loki-red":"#ef4444","--loki-red-muted":"rgba(239, 68, 68, 0.15)","--loki-blue":"#3b82f6","--loki-blue-muted":"rgba(59, 130, 246, 0.15)","--loki-purple":"#a78bfa","--loki-purple-muted":"rgba(167, 139, 250, 0.15)","--loki-opus":"#f59e0b","--loki-sonnet":"#818cf8","--loki-haiku":"#34d399","--loki-shadow-sm":"0 1px 2px rgba(0, 0, 0, 0.4)","--loki-shadow-md":"0 4px 12px rgba(0, 0, 0, 0.5)","--loki-shadow-lg":"0 10px 25px rgba(0, 0, 0, 0.6)","--loki-shadow-focus":"0 0 0 3px rgba(139, 92, 246, 0.25)"},"high-contrast":{"--loki-bg-primary":"#000000","--loki-bg-secondary":"#0a0a0a","--loki-bg-tertiary":"#141414","--loki-bg-card":"#0a0a0a","--loki-bg-hover":"#1a1a1a","--loki-bg-active":"#242424","--loki-bg-overlay":"rgba(0, 0, 0, 0.9)","--loki-accent":"#c084fc","--loki-accent-hover":"#d8b4fe","--loki-accent-active":"#e9d5ff","--loki-accent-light":"#d8b4fe","--loki-accent-muted":"rgba(192, 132, 252, 0.25)","--loki-text-primary":"#ffffff","--loki-text-secondary":"#e0e0e0","--loki-text-muted":"#b0b0b0","--loki-text-disabled":"#666666","--loki-text-inverse":"#000000","--loki-border":"#ffffff","--loki-border-light":"#cccccc","--loki-border-focus":"#c084fc","--loki-success":"#4ade80","--loki-success-muted":"rgba(74, 222, 128, 0.25)","--loki-warning":"#fde047","--loki-warning-muted":"rgba(253, 224, 71, 0.25)","--loki-error":"#f87171","--loki-error-muted":"rgba(248, 113, 113, 0.25)","--loki-info":"#60a5fa","--loki-info-muted":"rgba(96, 165, 250, 0.25)","--loki-green":"#4ade80","--loki-green-muted":"rgba(74, 222, 128, 0.25)","--loki-yellow":"#fde047","--loki-yellow-muted":"rgba(253, 224, 71, 0.25)","--loki-red":"#f87171","--loki-red-muted":"rgba(248, 113, 113, 0.25)","--loki-blue":"#60a5fa","--loki-blue-muted":"rgba(96, 165, 250, 0.25)","--loki-purple":"#c084fc","--loki-purple-muted":"rgba(192, 132, 252, 0.25)","--loki-opus":"#fbbf24","--loki-sonnet":"#818cf8","--loki-haiku":"#34d399","--loki-shadow-sm":"none","--loki-shadow-md":"none","--loki-shadow-lg":"none","--loki-shadow-focus":"0 0 0 3px #c084fc"},"vscode-light":{"--loki-bg-primary":"var(--vscode-editor-background, #ffffff)","--loki-bg-secondary":"var(--vscode-sideBar-background, #f3f3f3)","--loki-bg-tertiary":"var(--vscode-input-background, #ffffff)","--loki-bg-card":"var(--vscode-editor-background, #ffffff)","--loki-bg-hover":"var(--vscode-list-hoverBackground, #e8e8e8)","--loki-bg-active":"var(--vscode-list-activeSelectionBackground, #0060c0)","--loki-bg-overlay":"rgba(0, 0, 0, 0.4)","--loki-accent":"var(--vscode-focusBorder, #0066cc)","--loki-accent-hover":"var(--vscode-button-hoverBackground, #0055aa)","--loki-accent-active":"var(--vscode-button-background, #007acc)","--loki-accent-light":"var(--vscode-focusBorder, #0066cc)","--loki-accent-muted":"var(--vscode-editor-selectionBackground, rgba(0, 102, 204, 0.2))","--loki-text-primary":"var(--vscode-foreground, #333333)","--loki-text-secondary":"var(--vscode-descriptionForeground, #717171)","--loki-text-muted":"var(--vscode-disabledForeground, #a0a0a0)","--loki-text-disabled":"var(--vscode-disabledForeground, #cccccc)","--loki-text-inverse":"var(--vscode-button-foreground, #ffffff)","--loki-border":"var(--vscode-widget-border, #c8c8c8)","--loki-border-light":"var(--vscode-widget-border, #e0e0e0)","--loki-border-focus":"var(--vscode-focusBorder, #0066cc)","--loki-success":"var(--vscode-testing-iconPassed, #388a34)","--loki-success-muted":"rgba(56, 138, 52, 0.15)","--loki-warning":"var(--vscode-editorWarning-foreground, #bf8803)","--loki-warning-muted":"rgba(191, 136, 3, 0.15)","--loki-error":"var(--vscode-errorForeground, #e51400)","--loki-error-muted":"rgba(229, 20, 0, 0.15)","--loki-info":"var(--vscode-editorInfo-foreground, #1a85ff)","--loki-info-muted":"rgba(26, 133, 255, 0.15)","--loki-green":"var(--vscode-testing-iconPassed, #388a34)","--loki-green-muted":"rgba(56, 138, 52, 0.15)","--loki-yellow":"var(--vscode-editorWarning-foreground, #bf8803)","--loki-yellow-muted":"rgba(191, 136, 3, 0.15)","--loki-red":"var(--vscode-errorForeground, #e51400)","--loki-red-muted":"rgba(229, 20, 0, 0.15)","--loki-blue":"var(--vscode-editorInfo-foreground, #1a85ff)","--loki-blue-muted":"rgba(26, 133, 255, 0.15)","--loki-purple":"#9333ea","--loki-purple-muted":"rgba(147, 51, 234, 0.15)","--loki-opus":"#d97706","--loki-sonnet":"#4f46e5","--loki-haiku":"#059669","--loki-shadow-sm":"0 1px 2px rgba(0, 0, 0, 0.05)","--loki-shadow-md":"0 2px 4px rgba(0, 0, 0, 0.1)","--loki-shadow-lg":"0 4px 8px rgba(0, 0, 0, 0.15)","--loki-shadow-focus":"0 0 0 2px var(--vscode-focusBorder, #0066cc)"},"vscode-dark":{"--loki-bg-primary":"var(--vscode-editor-background, #1e1e1e)","--loki-bg-secondary":"var(--vscode-sideBar-background, #252526)","--loki-bg-tertiary":"var(--vscode-input-background, #3c3c3c)","--loki-bg-card":"var(--vscode-editor-background, #1e1e1e)","--loki-bg-hover":"var(--vscode-list-hoverBackground, #2a2d2e)","--loki-bg-active":"var(--vscode-list-activeSelectionBackground, #094771)","--loki-bg-overlay":"rgba(0, 0, 0, 0.6)","--loki-accent":"var(--vscode-focusBorder, #007fd4)","--loki-accent-hover":"var(--vscode-button-hoverBackground, #1177bb)","--loki-accent-active":"var(--vscode-button-background, #0e639c)","--loki-accent-light":"var(--vscode-focusBorder, #007fd4)","--loki-accent-muted":"var(--vscode-editor-selectionBackground, rgba(0, 127, 212, 0.25))","--loki-text-primary":"var(--vscode-foreground, #cccccc)","--loki-text-secondary":"var(--vscode-descriptionForeground, #9d9d9d)","--loki-text-muted":"var(--vscode-disabledForeground, #6b6b6b)","--loki-text-disabled":"var(--vscode-disabledForeground, #4d4d4d)","--loki-text-inverse":"var(--vscode-button-foreground, #ffffff)","--loki-border":"var(--vscode-widget-border, #454545)","--loki-border-light":"var(--vscode-widget-border, #5a5a5a)","--loki-border-focus":"var(--vscode-focusBorder, #007fd4)","--loki-success":"var(--vscode-testing-iconPassed, #89d185)","--loki-success-muted":"rgba(137, 209, 133, 0.2)","--loki-warning":"var(--vscode-editorWarning-foreground, #cca700)","--loki-warning-muted":"rgba(204, 167, 0, 0.2)","--loki-error":"var(--vscode-errorForeground, #f48771)","--loki-error-muted":"rgba(244, 135, 113, 0.2)","--loki-info":"var(--vscode-editorInfo-foreground, #75beff)","--loki-info-muted":"rgba(117, 190, 255, 0.2)","--loki-green":"var(--vscode-testing-iconPassed, #89d185)","--loki-green-muted":"rgba(137, 209, 133, 0.2)","--loki-yellow":"var(--vscode-editorWarning-foreground, #cca700)","--loki-yellow-muted":"rgba(204, 167, 0, 0.2)","--loki-red":"var(--vscode-errorForeground, #f48771)","--loki-red-muted":"rgba(244, 135, 113, 0.2)","--loki-blue":"var(--vscode-editorInfo-foreground, #75beff)","--loki-blue-muted":"rgba(117, 190, 255, 0.2)","--loki-purple":"#c084fc","--loki-purple-muted":"rgba(192, 132, 252, 0.2)","--loki-opus":"#f59e0b","--loki-sonnet":"#818cf8","--loki-haiku":"#34d399","--loki-shadow-sm":"0 1px 2px rgba(0, 0, 0, 0.3)","--loki-shadow-md":"0 2px 4px rgba(0, 0, 0, 0.4)","--loki-shadow-lg":"0 4px 8px rgba(0, 0, 0, 0.5)","--loki-shadow-focus":"0 0 0 2px var(--vscode-focusBorder, #007fd4)"}},_={xs:"4px",sm:"8px",md:"12px",lg:"16px",xl:"24px","2xl":"32px","3xl":"48px"},y={none:"0",sm:"4px",md:"6px",lg:"8px",xl:"10px",full:"9999px"},v={fontFamily:{sans:"'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif",mono:"'JetBrains Mono', 'Fira Code', 'SF Mono', Menlo, monospace"},fontSize:{xs:"10px",sm:"11px",base:"12px",md:"13px",lg:"14px",xl:"16px","2xl":"18px","3xl":"24px"},fontWeight:{normal:"400",medium:"500",semibold:"600",bold:"700"},lineHeight:{tight:"1.25",normal:"1.5",relaxed:"1.75"}},w={duration:{fast:"100ms",normal:"200ms",slow:"300ms",slower:"500ms"},easing:{default:"cubic-bezier(0.4, 0, 0.2, 1)",in:"cubic-bezier(0.4, 0, 1, 1)",out:"cubic-bezier(0, 0, 0.2, 1)",bounce:"cubic-bezier(0.68, -0.55, 0.265, 1.55)"}},q={sm:"640px",md:"768px",lg:"1024px",xl:"1280px","2xl":"1536px"},$={base:"0",dropdown:"100",sticky:"200",modal:"300",popover:"400",tooltip:"500",toast:"600"},K={"navigation.nextItem":{key:"ArrowDown",modifiers:[]},"navigation.prevItem":{key:"ArrowUp",modifiers:[]},"navigation.nextSection":{key:"Tab",modifiers:[]},"navigation.prevSection":{key:"Tab",modifiers:["Shift"]},"navigation.confirm":{key:"Enter",modifiers:[]},"navigation.cancel":{key:"Escape",modifiers:[]},"action.refresh":{key:"r",modifiers:["Meta"]},"action.search":{key:"k",modifiers:["Meta"]},"action.save":{key:"s",modifiers:["Meta"]},"action.close":{key:"w",modifiers:["Meta"]},"theme.toggle":{key:"d",modifiers:["Meta","Shift"]},"task.create":{key:"n",modifiers:["Meta"]},"task.complete":{key:"Enter",modifiers:["Meta"]},"view.toggleLogs":{key:"l",modifiers:["Meta","Shift"]},"view.toggleMemory":{key:"m",modifiers:["Meta","Shift"]}},G={button:{role:"button",tabIndex:0},tablist:{role:"tablist"},tab:{role:"tab",ariaSelected:!1,tabIndex:-1},tabpanel:{role:"tabpanel",tabIndex:0},list:{role:"list"},listitem:{role:"listitem"},livePolite:{ariaLive:"polite",ariaAtomic:!0},liveAssertive:{ariaLive:"assertive",ariaAtomic:!0},dialog:{role:"dialog",ariaModal:!0},alertdialog:{role:"alertdialog",ariaModal:!0},status:{role:"status",ariaLive:"polite"},alert:{role:"alert",ariaLive:"assertive"},log:{role:"log",ariaLive:"polite",ariaRelevant:"additions"}};function m(l){let e=b[l];return e?Object.entries(e).map(([t,a])=>`${t}: ${a};`).join(`
@@ -4613,18 +4747,27 @@ document.addEventListener('DOMContentLoaded', function() {
   var themeToggle = document.getElementById('theme-toggle');
   var themeLabel = document.getElementById('theme-label');
 
-  function updateThemeLabel() {
+  var sunIcon = document.getElementById('theme-icon-sun');
+  var moonIcon = document.getElementById('theme-icon-moon');
+
+  function updateThemeUI() {
     var theme = LokiDashboard.UnifiedThemeManager.getTheme();
-    themeLabel.textContent = theme.includes('dark') ? 'Light' : 'Dark';
+    var isDark = theme.includes('dark') || theme === 'high-contrast';
+    themeLabel.textContent = isDark ? 'Light' : 'Dark';
+    if (sunIcon) sunIcon.style.display = isDark ? 'inline' : 'none';
+    if (moonIcon) moonIcon.style.display = isDark ? 'none' : 'inline';
   }
 
   themeToggle.addEventListener('click', function() {
     LokiDashboard.UnifiedThemeManager.toggle();
-    updateThemeLabel();
+    updateThemeUI();
   });
 
-  // Initialize theme label
-  updateThemeLabel();
+  window.addEventListener('loki-theme-change', function() {
+    updateThemeUI();
+  });
+
+  updateThemeUI();
 
   // API URL configuration - auto-detect from current server
   var apiUrlInput = document.getElementById('api-url');
@@ -4736,6 +4879,116 @@ document.addEventListener('DOMContentLoaded', function() {
     }
   });
 
+  // --- Keyboard Shortcuts (Issue #18) ---
+  var shortcutsOverlay = document.getElementById('shortcuts-overlay');
+  var shortcutsClose = document.getElementById('shortcuts-close');
+
+  function toggleShortcutsOverlay() {
+    shortcutsOverlay.classList.toggle('visible');
+  }
+
+  function closeShortcutsOverlay() {
+    shortcutsOverlay.classList.remove('visible');
+  }
+
+  shortcutsClose.addEventListener('click', closeShortcutsOverlay);
+
+  // Close overlay when clicking outside the dialog
+  shortcutsOverlay.addEventListener('click', function(e) {
+    if (e.target === shortcutsOverlay) {
+      closeShortcutsOverlay();
+    }
+  });
+
+  document.addEventListener('keydown', function(e) {
+    // Skip shortcuts when typing in input, textarea, or select elements
+    var tag = (e.target.tagName || '').toLowerCase();
+    if (tag === 'input' || tag === 'textarea' || tag === 'select' || e.target.isContentEditable) {
+      // Allow Escape to blur input fields
+      if (e.key === 'Escape') {
+        e.target.blur();
+      }
+      return;
+    }
+
+    // Skip if modifier keys are held (let browser defaults work)
+    if (e.metaKey || e.ctrlKey || e.altKey) return;
+
+    var sections = ['overview', 'tasks', 'logs', 'memory', 'learning', 'council', 'cost'];
+
+    switch (e.key) {
+      // Section navigation: 1-7
+      case '1': case '2': case '3': case '4': case '5': case '6': case '7':
+        e.preventDefault();
+        switchSection(sections[parseInt(e.key) - 1]);
+        break;
+
+      // Help overlay
+      case '?':
+        e.preventDefault();
+        toggleShortcutsOverlay();
+        break;
+
+      // Close overlays
+      case 'Escape':
+        if (shortcutsOverlay.classList.contains('visible')) {
+          e.preventDefault();
+          closeShortcutsOverlay();
+        }
+        break;
+
+      // Focus API URL input
+      case '/':
+        e.preventDefault();
+        apiUrlInput.focus();
+        apiUrlInput.select();
+        break;
+
+      // Theme toggle
+      case 't':
+        e.preventDefault();
+        LokiDashboard.UnifiedThemeManager.toggle();
+        updateThemeLabel();
+        break;
+
+      // Session controls
+      case 'p':
+        e.preventDefault();
+        var sessionCtrl = document.getElementById('session-control');
+        if (sessionCtrl) {
+          var pauseBtn = sessionCtrl.shadowRoot && sessionCtrl.shadowRoot.getElementById('pause-btn');
+          if (pauseBtn && !pauseBtn.disabled) {
+            pauseBtn.click();
+          }
+        }
+        break;
+
+      case 'r':
+        e.preventDefault();
+        var sessionCtrl2 = document.getElementById('session-control');
+        if (sessionCtrl2) {
+          var resumeBtn = sessionCtrl2.shadowRoot && sessionCtrl2.shadowRoot.getElementById('resume-btn');
+          if (resumeBtn) {
+            resumeBtn.click();
+          }
+        }
+        break;
+
+      case 's':
+        e.preventDefault();
+        var sessionCtrl3 = document.getElementById('session-control');
+        if (sessionCtrl3) {
+          var stopBtn = sessionCtrl3.shadowRoot && sessionCtrl3.shadowRoot.getElementById('stop-btn');
+          if (stopBtn && !stopBtn.disabled) {
+            if (window.confirm('Are you sure you want to stop the session?')) {
+              stopBtn.click();
+            }
+          }
+        }
+        break;
+    }
+  });
+
   // Restore last section from localStorage
   var savedSection = localStorage.getItem('loki-active-section');
   if (savedSection) {

package/docs/INSTALLATION.md

@@ -2,7 +2,7 @@
 
 Complete installation instructions for all platforms and use cases.
 
-**Version:** v5.30.0
+**Version:** v5.32.0
 
 ---
 
@@ -20,6 +20,7 @@ Complete installation instructions for all platforms and use cases.
 - [Anthropic API Console](#anthropic-api-console)
 - [Verify Installation](#verify-installation)
 - [Ports](#ports)
+- [Shell Completions](#shell-completions)
 - [Troubleshooting](#troubleshooting)
 
 ---
@@ -36,7 +37,7 @@ npm install -g loki-mode
 brew tap asklokesh/tap && brew install loki-mode
 
 # Option C: Docker
-docker pull asklokesh/loki-mode:5.30.0
+docker pull asklokesh/loki-mode:5.32.0
 
 # Option D: Git clone
 git clone https://github.com/asklokesh/loki-mode.git ~/.claude/skills/loki-mode
@@ -227,7 +228,7 @@ Run Loki Mode in a container for isolated execution.
 
 ```bash
 # Pull the image
-docker pull asklokesh/loki-mode:5.30.0
+docker pull asklokesh/loki-mode:5.32.0
 
 # Or use docker-compose
 curl -o docker-compose.yml https://raw.githubusercontent.com/asklokesh/loki-mode/main/docker-compose.yml
@@ -237,10 +238,10 @@ curl -o docker-compose.yml https://raw.githubusercontent.com/asklokesh/loki-mode
 
 ```bash
 # Run with a PRD file
-docker run -v $(pwd):/workspace -w /workspace asklokesh/loki-mode:5.30.0 start ./my-prd.md
+docker run -v $(pwd):/workspace -w /workspace asklokesh/loki-mode:5.32.0 start ./my-prd.md
 
 # Interactive mode
-docker run -it -v $(pwd):/workspace -w /workspace asklokesh/loki-mode:5.30.0
+docker run -it -v $(pwd):/workspace -w /workspace asklokesh/loki-mode:5.32.0
 
 # Using docker-compose
 docker-compose run loki start ./my-prd.md
@@ -253,7 +254,7 @@ Pass your configuration via environment variables:
 ```bash
 docker run -e LOKI_MAX_RETRIES=100 -e LOKI_BASE_WAIT=120 \
   -v $(pwd):/workspace -w /workspace \
-  asklokesh/loki-mode:5.30.0 start ./my-prd.md
+  asklokesh/loki-mode:5.32.0 start ./my-prd.md
 ```
 
 ### Updating
@@ -369,12 +370,12 @@ Pass the provider as an environment variable:
 # Use Codex with Docker
 docker run -e LOKI_PROVIDER=codex \
   -v $(pwd):/workspace -w /workspace \
-  asklokesh/loki-mode:5.30.0 start ./my-prd.md
+  asklokesh/loki-mode:5.32.0 start ./my-prd.md
 
 # Use Gemini with Docker
 docker run -e LOKI_PROVIDER=gemini \
   -v $(pwd):/workspace -w /workspace \
-  asklokesh/loki-mode:5.30.0 start ./my-prd.md
+  asklokesh/loki-mode:5.32.0 start ./my-prd.md
 ```
 
 ### Degraded Mode
@@ -611,6 +612,107 @@ CORS_ALLOWED_ORIGINS="http://localhost:3000,https://my-dashboard.example.com" lo
 
 ---
 
+## Shell Completions
+
+Enable tab completion for the `loki` CLI to support subcommands, flags, and file arguments.
+
+---
+
+## Bash Setup
+
+### Option 1: Permanent Setup (Recommended)
+
+Add the source command to your startup file so completions load every time you open a terminal.
+
+Add this line to your `~/.bashrc` (Linux) or `~/.bash_profile` (macOS):
+
+```bash
+source /path/to/loki/completions/loki.bash
+```
+
+---
+
+### Option 2: Manual Sourcing (Temporary)
+
+If you only want to enable completions for your current terminal session (for example, for testing), run:
+
+```bash
+source completions/loki.bash
+```
+
+---
+
+### Optional: Smoother Bash Experience
+
+By default, Bash requires two **TAB** presses to show the completion menu. To make it instant (similar to Zsh) and cycle through options more easily, add the following lines to your `~/.inputrc` file:
+
+```bash
+# Show menu immediately on first TAB
+set show-all-if-ambiguous on
+
+# Case-insensitive completion (optional)
+set completion-ignore-case on
+```
+
+> **Note:** You will need to restart your terminal for `~/.inputrc` changes to take effect.
+
+---
+
+## Zsh Setup
+
+Zsh completions require the script to be located in a directory listed in your `$fpath`.
+
+### Permanent Setup
+
+Add the `loki` completions directory to your `$fpath` in `~/.zshrc` **before** initializing completions:
+
+```bash
+# 1. Add the completions directory to fpath
+fpath=(/path/to/loki/completions $fpath)
+
+# 2. Initialize completions
+autoload -Uz compinit && compinit
+```
+
+---
+
+## Testing Completions
+
+After installation, restart your shell or source your configuration file, then verify:
+
+### Bash
+
+```bash
+loki <TAB>            # Should immediately list subcommands
+loki start -<TAB>     # Should list flags (--provider, --parallel, etc.)
+```
+
+### Zsh
+
+```bash
+loki <TAB>                # Should show subcommands with descriptions
+loki start --pro<TAB>     # Should autocomplete to --provider
+```
+
+---
+
+## Completion Features
+
+The completion scripts support:
+
+* **Subcommands**
+  `start`, `stop`, `pause`, `resume`, `status`, `dashboard`, `import`, `council`, `memory`, `provider`, `config`, `help`, `completions`
+
+* **Smart Context**
+
+  * `loki start --provider <TAB>` shows only installed providers (`claude`, `codex`, `gemini`).
+  * `loki start <TAB>` defaults to file completion for PRD templates.
+
+* **Nested Commands**
+  Handles specific subcommands for `council`, `memory`, and `config`.
+
+---
+
 ## Troubleshooting
 
 ### Skill Not Found

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loki-mode",
-  "version": "5.30.0",
+  "version": "5.32.0",
   "description": "Multi-agent autonomous startup system for Claude Code, Codex CLI, and Gemini CLI",
   "keywords": [
     "claude",

package/templates/README.md

@@ -27,6 +27,7 @@ claude --dangerously-skip-permissions
 
 | Template | Description | Tech Stack | Est. Time |
 |----------|-------------|------------|-----------|
+| [rest-api-auth.md](rest-api-auth.md) | REST API with JWT auth, registration, login, refresh, rate limiting | Express/FastAPI, PostgreSQL, JWT, bcrypt | 30-45 min |
 | [full-stack-demo.md](full-stack-demo.md) | Bookmark manager with tags, search, and filtering | React, Express, SQLite, TailwindCSS | 30-60 min |
 | [cli-tool.md](cli-tool.md) | File organizer CLI with subcommands, config, watch mode, undo | Node.js, Commander.js, chalk, chokidar | 30-45 min |
 | [discord-bot.md](discord-bot.md) | Moderation bot with slash commands, auto-mod, reaction roles | discord.js, SQLite, node-cron | 45-60 min |
@@ -69,7 +70,7 @@ Every template follows a consistent structure:
 
 **Testing specific agent types:**
 - Frontend agent: `static-landing-page.md`, `chrome-extension.md`
-- Backend agent: `api-only.md`, `discord-bot.md`
+- Backend agent: `api-only.md`, `rest-api-auth.md`, `discord-bot.md`
 - Full-stack agent: `full-stack-demo.md`, `blog-platform.md`
 - DevOps/CLI agent: `cli-tool.md`
 - Mobile agent: `mobile-app.md`