loki-mode 5.48.1 → 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.1
+# 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.1 | [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.1
+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,19 +1513,29 @@ cmd_dashboard_start() {
         tls_info=" (TLS enabled)"
     fi
 
-    # Ensure dashboard Python dependencies are installed
+    # Ensure dashboard Python dependencies via virtualenv (PEP 668 safe)
     if ! "$python_cmd" -c "import fastapi" 2>/dev/null; then
-        echo -e "${YELLOW}Installing dashboard dependencies...${NC}"
+        echo -e "${YELLOW}Setting up dashboard virtualenv...${NC}"
         local req_file="${SKILL_DIR}/dashboard/requirements.txt"
-        if [ -f "$req_file" ]; then
-            pip3 install -q -r "$req_file" 2>/dev/null || pip install -q -r "$req_file" 2>/dev/null || {
-                echo -e "${RED}Failed to install dashboard dependencies${NC}"
-                echo "Run manually: pip install fastapi uvicorn pydantic websockets"
-                exit 1
-            }
+        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
@@ -3143,19 +3156,31 @@ cmd_api() {
                 fi
             fi
 
-            # Ensure dashboard Python dependencies are installed
-            if ! python3 -c "import fastapi" 2>/dev/null; then
-                echo -e "${YELLOW}Installing dashboard dependencies...${NC}"
-                local req_file="${SKILL_DIR}/dashboard/requirements.txt"
-                if [ -f "$req_file" ]; then
-                    pip3 install -q -r "$req_file" 2>/dev/null || pip install -q -r "$req_file" 2>/dev/null || {
-                        echo -e "${RED}Failed to install dashboard dependencies${NC}"
-                        echo "Run manually: pip install fastapi uvicorn pydantic websockets"
-                        exit 1
-                    }
+            # 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
@@ -3168,7 +3193,7 @@ cmd_api() {
             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,19 +5147,40 @@ start_dashboard() {
         log_info "TLS enabled for dashboard"
     fi
 
-    # Ensure dashboard Python dependencies are installed
+    # Ensure dashboard Python dependencies via virtualenv (PEP 668 safe)
     local skill_dir="${SCRIPT_DIR%/*}"
     local req_file="${skill_dir}/dashboard/requirements.txt"
-    if ! python3 -c "import fastapi" 2>/dev/null; then
-        log_step "Installing dashboard dependencies..."
-        if [ -f "$req_file" ]; then
-            pip3 install -q -r "$req_file" 2>/dev/null || pip install -q -r "$req_file" 2>/dev/null || {
-                log_warn "Failed to install dashboard dependencies"
-                log_warn "Run manually: pip install fastapi uvicorn pydantic websockets"
+    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
@@ -5168,7 +5189,7 @@ start_dashboard() {
     # 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="${skill_dir}" PYTHONPATH="${skill_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.1"
+__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.1
+**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.1'
+__version__ = '5.48.2'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loki-mode",
-  "version": "5.48.1",
+  "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