loki-mode 5.48.0 → 5.48.2

package/SKILL.md

@@ -3,7 +3,7 @@ name: loki-mode
 description: Multi-agent autonomous startup system. Triggers on "Loki Mode". Takes PRD to deployed product with zero human intervention. Requires --dangerously-skip-permissions flag.
 ---
 
-# Loki Mode v5.48.0
+# Loki Mode v5.48.2
 
 **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
 
@@ -68,15 +68,16 @@ VERIFY: Run tests. Check build. Validate against spec.
 
 ## PRIORITY 3: Autonomy Rules
 
-These rules are ABSOLUTE. Violating them is a critical failure.
+These rules guide autonomous operation. Test results and code quality always take precedence.
 
 | Rule | Meaning |
 |------|---------|
-| **NEVER ask** | Do not output questions. Decide and act. |
-| **NEVER wait** | Do not pause for confirmation. Execute immediately. |
-| **NEVER stop** | There is always another improvement. Find it. |
-| **ALWAYS verify** | Code without tests is incomplete. Run tests. |
+| **Decide and act** | Make decisions autonomously. Do not ask the user questions. |
+| **Keep momentum** | Do not pause for confirmation. Move to the next task. |
+| **Iterate continuously** | There is always another improvement. Find it. |
+| **ALWAYS verify** | Code without tests is incomplete. Run tests. **Never ignore or delete failing tests.** |
 | **ALWAYS commit** | Atomic commits after each task. Checkpoint progress. |
+| **Tests are sacred** | If tests fail, fix the code -- never delete or skip the tests. A passing test suite is a hard requirement. |
 
 ---
 
@@ -262,4 +263,4 @@ The following features are documented in skill modules but not yet fully automat
 | Quality gates 3-reviewer system | Implemented (v5.35.0) | 5 specialist reviewers in `skills/quality-gates.md`; execution in run.sh |
 | Benchmarks (HumanEval, SWE-bench) | Infrastructure only | Runner scripts and datasets exist in `benchmarks/`; no published results |
 
-**v5.48.0 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**
+**v5.48.2 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**

package/VERSION

@@ -1 +1 @@
-5.48.0
+5.48.2

package/autonomy/app-runner.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #===============================================================================
 # App Runner Module (v5.45.0)
 #

package/autonomy/completion-council.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #===============================================================================
 # Completion Council - Multi-Agent Completion Verification
 #

package/autonomy/hooks/quality-gate.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Loki Mode Stop Hook - Quality Gate Verification
 # Runs quality checks before allowing completion
 

package/autonomy/hooks/session-init.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Loki Mode SessionStart Hook
 # Loads memory context and initializes session state
 

package/autonomy/hooks/store-episode.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Loki Mode SessionEnd Hook - Episode Storage
 # Stores session as episodic memory
 

package/autonomy/hooks/track-metrics.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Loki Mode PostToolUse Hook - Metrics Tracking
 # Tracks tool usage for efficiency metrics (async)
 

package/autonomy/hooks/validate-bash.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Loki Mode PreToolUse Hook - Bash Command Validation
 # Blocks dangerous commands, logs all executions
 

package/autonomy/issue-parser.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #===============================================================================
 # Loki Mode - GitHub Issue Parser (v5.14.0)
 # Parses GitHub issues and extracts structured data for PRD generation

package/autonomy/loki

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #===============================================================================
 # Loki Mode CLI Wrapper
 # Command-line interface for Loki Mode
@@ -1460,9 +1460,12 @@ cmd_dashboard_start() {
         exit 1
     fi
 
-    # Determine python command
+    # Determine python command -- prefer dashboard venv if available
     local python_cmd="python3"
-    if ! command -v python3 &> /dev/null; then
+    local dashboard_venv="${SKILL_DIR}/dashboard/.venv"
+    if [ -x "${dashboard_venv}/bin/python3" ]; then
+        python_cmd="${dashboard_venv}/bin/python3"
+    elif ! command -v python3 &> /dev/null; then
         python_cmd="python"
     fi
 
@@ -1510,6 +1513,34 @@ cmd_dashboard_start() {
         tls_info=" (TLS enabled)"
     fi
 
+    # Ensure dashboard Python dependencies via virtualenv (PEP 668 safe)
+    if ! "$python_cmd" -c "import fastapi" 2>/dev/null; then
+        echo -e "${YELLOW}Setting up dashboard virtualenv...${NC}"
+        local req_file="${SKILL_DIR}/dashboard/requirements.txt"
+        if ! [ -d "$dashboard_venv" ]; then
+            python3 -m venv "$dashboard_venv" 2>/dev/null || python3.13 -m venv "$dashboard_venv" 2>/dev/null || true
+        fi
+        if [ -x "${dashboard_venv}/bin/python3" ]; then
+            python_cmd="${dashboard_venv}/bin/python3"
+            echo -e "${YELLOW}Installing dashboard dependencies into venv...${NC}"
+            if [ -f "$req_file" ]; then
+                "${dashboard_venv}/bin/pip" install -q -r "$req_file" 2>/dev/null || {
+                    echo -e "${YELLOW}Pinned deps failed, installing core deps...${NC}"
+                    "${dashboard_venv}/bin/pip" install -q fastapi uvicorn pydantic websockets 2>/dev/null || true
+                }
+            else
+                "${dashboard_venv}/bin/pip" install -q fastapi uvicorn pydantic websockets 2>/dev/null || true
+            fi
+        else
+            # Fallback: try direct pip (may fail on PEP 668 systems)
+            pip3 install -q fastapi uvicorn pydantic websockets 2>/dev/null || pip install -q fastapi uvicorn pydantic websockets 2>/dev/null || {
+                echo -e "${RED}Failed to install dashboard dependencies${NC}"
+                echo "Run manually: python3 -m venv ${dashboard_venv} && ${dashboard_venv}/bin/pip install fastapi uvicorn pydantic websockets"
+                exit 1
+            }
+        fi
+    fi
+
     echo -e "${GREEN}Starting dashboard server...${NC}"
     echo -e "${CYAN}Host:${NC} $host"
     echo -e "${CYAN}Port:${NC} $port"
@@ -3125,13 +3156,44 @@ cmd_api() {
                 fi
             fi
 
+            # Ensure dashboard Python dependencies via virtualenv (PEP 668 safe)
+            local dashboard_venv="${SKILL_DIR}/dashboard/.venv"
+            local api_python="python3"
+            if [ -x "${dashboard_venv}/bin/python3" ]; then
+                api_python="${dashboard_venv}/bin/python3"
+            fi
+            if ! "$api_python" -c "import fastapi" 2>/dev/null; then
+                echo -e "${YELLOW}Setting up dashboard virtualenv...${NC}"
+                if ! [ -d "$dashboard_venv" ]; then
+                    python3 -m venv "$dashboard_venv" 2>/dev/null || python3.13 -m venv "$dashboard_venv" 2>/dev/null || true
+                fi
+                if [ -x "${dashboard_venv}/bin/python3" ]; then
+                    api_python="${dashboard_venv}/bin/python3"
+                    local req_file="${SKILL_DIR}/dashboard/requirements.txt"
+                    if [ -f "$req_file" ]; then
+                        "${dashboard_venv}/bin/pip" install -q -r "$req_file" 2>/dev/null || {
+                            "${dashboard_venv}/bin/pip" install -q fastapi uvicorn pydantic websockets 2>/dev/null || true
+                        }
+                    else
+                        "${dashboard_venv}/bin/pip" install -q fastapi uvicorn pydantic websockets 2>/dev/null || true
+                    fi
+                else
+                    pip3 install -q fastapi uvicorn pydantic websockets 2>/dev/null || {
+                        echo -e "${RED}Failed to install dashboard dependencies${NC}"
+                        echo "Run manually: python3 -m venv ${dashboard_venv} && ${dashboard_venv}/bin/pip install fastapi uvicorn pydantic websockets"
+                        exit 1
+                    }
+                fi
+            fi
+
             # Start server
             mkdir -p "$LOKI_DIR/logs" "$LOKI_DIR/dashboard"
-            local uvicorn_args="--host 0.0.0.0 --port $port"
+            local host="${LOKI_DASHBOARD_HOST:-127.0.0.1}"
+            local uvicorn_args="--host $host --port $port"
             if [ -n "${LOKI_TLS_CERT:-}" ] && [ -n "${LOKI_TLS_KEY:-}" ]; then
                 uvicorn_args="$uvicorn_args --ssl-certfile ${LOKI_TLS_CERT} --ssl-keyfile ${LOKI_TLS_KEY}"
             fi
-            LOKI_DIR="$LOKI_DIR" PYTHONPATH="$SKILL_DIR" nohup python3 -m uvicorn dashboard.server:app $uvicorn_args > "$LOKI_DIR/logs/api.log" 2>&1 &
+            LOKI_DIR="$LOKI_DIR" PYTHONPATH="$SKILL_DIR" nohup "$api_python" -m uvicorn dashboard.server:app $uvicorn_args > "$LOKI_DIR/logs/api.log" 2>&1 &
             local new_pid=$!
             echo "$new_pid" > "$pid_file"
 

package/autonomy/playwright-verify.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #===============================================================================
 # Playwright Smoke Test Module (v5.46.0)
 #

package/autonomy/prd-checklist.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #===============================================================================
 # PRD Checklist Module (v5.44.0)
 #

package/autonomy/run.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # shellcheck disable=SC2034  # Many variables are used by sourced scripts
 # shellcheck disable=SC2155  # Declare and assign separately (acceptable in this codebase)
 # shellcheck disable=SC2329  # Functions may be invoked indirectly or via dynamic dispatch
@@ -5147,11 +5147,49 @@ start_dashboard() {
         log_info "TLS enabled for dashboard"
     fi
 
+    # Ensure dashboard Python dependencies via virtualenv (PEP 668 safe)
+    local skill_dir="${SCRIPT_DIR%/*}"
+    local req_file="${skill_dir}/dashboard/requirements.txt"
+    local dashboard_venv="${skill_dir}/dashboard/.venv"
+    local python_cmd="python3"
+
+    # Use venv python if available, otherwise set one up
+    if [ -x "${dashboard_venv}/bin/python3" ]; then
+        python_cmd="${dashboard_venv}/bin/python3"
+    fi
+
+    if ! "$python_cmd" -c "import fastapi" 2>/dev/null; then
+        log_step "Setting up dashboard virtualenv..."
+        if ! [ -d "$dashboard_venv" ]; then
+            python3 -m venv "$dashboard_venv" 2>/dev/null || python3.13 -m venv "$dashboard_venv" 2>/dev/null || {
+                log_warn "Failed to create virtualenv, trying direct pip install..."
+            }
+        fi
+        if [ -x "${dashboard_venv}/bin/python3" ]; then
+            python_cmd="${dashboard_venv}/bin/python3"
+            log_step "Installing dashboard dependencies into venv..."
+            if [ -f "$req_file" ]; then
+                "${dashboard_venv}/bin/pip" install -q -r "$req_file" 2>/dev/null || {
+                    log_warn "Pinned deps failed, installing core deps..."
+                    "${dashboard_venv}/bin/pip" install -q fastapi uvicorn pydantic websockets 2>/dev/null || true
+                }
+            else
+                "${dashboard_venv}/bin/pip" install -q fastapi uvicorn pydantic websockets 2>/dev/null || true
+            fi
+        else
+            # Fallback: try direct pip (may fail on PEP 668 systems)
+            pip3 install -q fastapi uvicorn pydantic websockets 2>/dev/null || pip install -q fastapi uvicorn pydantic websockets 2>/dev/null || {
+                log_warn "Failed to install dashboard dependencies"
+                log_warn "Run manually: python3 -m venv ${dashboard_venv} && ${dashboard_venv}/bin/pip install fastapi uvicorn pydantic websockets"
+            }
+        fi
+    fi
+
     # Start the FastAPI dashboard server
     # Dashboard module is at project root (parent of autonomy/)
     # LOKI_SKILL_DIR tells server.py where to find static files
     LOKI_TLS_CERT="${LOKI_TLS_CERT:-}" LOKI_TLS_KEY="${LOKI_TLS_KEY:-}" \
-        LOKI_SKILL_DIR="${SCRIPT_DIR%/*}" PYTHONPATH="${SCRIPT_DIR%/*}" nohup python3 -m dashboard.server > "$log_file" 2>&1 &
+        LOKI_SKILL_DIR="${skill_dir}" PYTHONPATH="${skill_dir}" nohup "$python_cmd" -m dashboard.server > "$log_file" 2>&1 &
     DASHBOARD_PID=$!
 
     # Save PID for later cleanup

package/autonomy/sandbox.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #===============================================================================
 # Loki Mode - Docker Sandbox Manager
 # Provides isolated container execution for enhanced security

package/autonomy/serve.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # shellcheck disable=SC2034  # Unused variables are for future use or exported
 # shellcheck disable=SC2155  # Declare and assign separately
 #===============================================================================

package/dashboard/__init__.py

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

package/docs/INSTALLATION.md

@@ -2,7 +2,7 @@
 
 The flagship product of [Autonomi](https://www.autonomi.dev/). Complete installation instructions for all platforms and use cases.
 
-**Version:** v5.48.0
+**Version:** v5.48.2
 
 ---
 

package/events/emit.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Loki Mode Event Emitter - Bash helper for emitting events
 #
 # Usage:

package/learning/aggregate.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Loki Mode Learning Aggregator - Bash CLI helper
 #
 # Runs learning signal aggregation and displays results.

package/learning/emit.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Loki Mode Learning Signal Emitter - Bash helper
 #
 # Emits learning signals by calling the Python learning emitter.

package/learning/suggest.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Loki Mode Learning Suggestions - Bash CLI helper
 #
 # Shows context-aware suggestions based on aggregated learnings.

package/mcp/__init__.py

@@ -21,4 +21,4 @@ try:
 except ImportError:
     __all__ = ['mcp']
 
-__version__ = '5.48.0'
+__version__ = '5.48.2'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loki-mode",
-  "version": "5.48.0",
+  "version": "5.48.2",
   "description": "Loki Mode by Autonomi - Multi-agent autonomous startup system for Claude Code, Codex CLI, and Gemini CLI",
   "keywords": [
     "autonomi",

package/providers/claude.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Claude Code Provider Configuration
 # Shell-sourceable config for loki-mode multi-provider support
 

package/providers/codex.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # OpenAI Codex CLI Provider Configuration
 # Shell-sourceable config for loki-mode multi-provider support
 

package/providers/gemini.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Google Gemini CLI Provider Configuration
 # Shell-sourceable config for loki-mode multi-provider support
 

package/providers/loader.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # Provider Loader for loki-mode
 # Sources the appropriate provider configuration based on LOKI_PROVIDER