loki-mode 5.49.2 → 5.49.4

package/README.md

@@ -11,7 +11,7 @@
 [![Agent Types](https://img.shields.io/badge/Agent%20Types-41-blue)]()
 [![Benchmarks](https://img.shields.io/badge/Benchmarks-Infrastructure%20Ready-blue)](benchmarks/)
 
-**Current Version: v5.49.2**
+**Current Version: v5.49.4**
 
 **[Autonomi](https://www.autonomi.dev/)** | **[Documentation](https://www.autonomi.dev/docs)** | **[GitHub](https://github.com/asklokesh/loki-mode)**
 
@@ -41,56 +41,67 @@
 
 ## Installation
 
+### npm (Recommended)
+
 ```bash
-git clone https://github.com/asklokesh/loki-mode.git ~/.claude/skills/loki-mode
+npm install -g loki-mode
 ```
 
-That's it. Claude Code auto-discovers skills in `~/.claude/skills/`.
+Installs the `loki` CLI and automatically sets up the skill for Claude Code, Codex CLI, and Gemini CLI.
 
-### Use It
+### Homebrew
 
 ```bash
-claude --dangerously-skip-permissions
-# Then say: "Loki Mode with PRD at ./my-prd.md"
+brew tap asklokesh/tap && brew install loki-mode
 ```
 
-### Update
+Installs the `loki` CLI. To also install the skill for interactive use:
 
 ```bash
-cd ~/.claude/skills/loki-mode && git pull
+loki setup-skill
 ```
 
-### Troubleshooting
+### Quick Start
 
-| Problem | Fix |
-|---------|-----|
-| `SKILL.md` not found | Verify: `ls ~/.claude/skills/loki-mode/SKILL.md` |
-| Claude doesn't recognize "Loki Mode" | Restart Claude Code after cloning |
-| Permission denied on clone | Check SSH keys or use HTTPS URL above |
+```bash
+# CLI mode (works with any provider)
+loki start ./prd.md
+loki start ./prd.md --provider codex
+loki start ./prd.md --provider gemini
 
-### Other Installation Methods
+# Interactive mode (inside your coding agent)
+claude --dangerously-skip-permissions
+# Then say: "Loki Mode with PRD at ./my-prd.md"
 
-Also available via **npm**, **Homebrew**, **Docker**, **GitHub Action**, and **VS Code Extension**. See [docs/alternative-installations.md](docs/alternative-installations.md) for details and limitations of each method.
+# Or in Codex CLI:
+codex
+# Then say: "Use Loki Mode with PRD at ./my-prd.md"
 
-### Multi-Provider Support (v5.0.0)
+# Or in Gemini CLI:
+gemini
+# Then say: "Use Loki Mode with PRD at ./my-prd.md"
+```
 
-Loki Mode supports three AI providers:
+### Verify Installation
 
 ```bash
-# Claude Code (default - full features)
-loki start --provider claude ./my-prd.md
+loki --version    # Should print 5.49.4
+loki doctor       # Check skill symlinks and provider availability
+```
+
+### Other Methods
 
-# OpenAI Codex CLI (degraded mode)
-loki start --provider codex ./my-prd.md
+Git clone, Docker, GitHub Action, and VS Code Extension are also available. See [docs/alternative-installations.md](docs/alternative-installations.md).
 
-# Google Gemini CLI (degraded mode)
-loki start --provider gemini ./my-prd.md
+### Update
 
-# Or via environment variable
-LOKI_PROVIDER=codex loki start ./my-prd.md
+```bash
+npm update -g loki-mode    # npm
+brew upgrade loki-mode     # Homebrew
 ```
 
-**Provider Comparison:**
+### Multi-Provider Support (v5.0.0)
+
 | Provider | Features | Parallel Agents | Task Tool |
 |----------|----------|-----------------|-----------|
 | Claude | Full | Yes (10+) | Yes |
@@ -150,6 +161,16 @@ Loki Mode is powerful but not magic. Be aware of these honest limitations:
 - Human oversight is expected for: deployment credentials, domain setup, API keys, and critical business decisions
 - The system is as good as the underlying AI model -- it can make mistakes, especially on novel or complex problems
 
+## What To Expect
+
+| Project Type | Examples | Autonomy Level | Typical Experience |
+|---|---|---|---|
+| Simple | Landing page, todo app, static site, single API | High | Completes with minimal retries. Human reviews output. |
+| Standard | CRUD app with auth, REST API + React frontend | Medium | Completes most features. Complex components may need guidance. |
+| Complex | Microservices, real-time systems, ML pipelines | Guided | Use as accelerator. Human reviews between phases. |
+
+"Autonomous" means the system runs RARV cycles without prompting. It does NOT mean zero oversight.
+
 ---
 
 ## Why Loki Mode?

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 minimal human intervention. Requires --dangerously-skip-permissions flag.
 ---
 
-# Loki Mode v5.49.2
+# Loki Mode v5.49.4
 
 **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
 
@@ -263,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.49.2 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**
+**v5.49.4 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**

package/VERSION

@@ -1 +1 @@
-5.49.2
+5.49.4

package/autonomy/loki

@@ -340,7 +340,8 @@ show_help() {
     echo "  dogfood          Show self-development statistics"
     echo "  secrets [cmd]    API key status and validation (status|validate)"
     echo "  reset [target]   Reset session state (all|retries|failed)"
-    echo "  doctor [--json]  Check system prerequisites"
+    echo "  doctor [--json]  Check system prerequisites and skill symlinks"
+    echo "  setup-skill      Create skill symlinks for all providers"
     echo "  watchdog [cmd]   Process health monitoring (status|help)"
     echo "  version          Show version"
     echo "  help             Show this help"
@@ -2860,6 +2861,69 @@ cmd_config_path() {
     echo "Create a config file with: loki config init"
 }
 
+# Set up skill symlinks for all providers
+cmd_setup_skill() {
+    echo -e "${BOLD}Loki Mode Skill Setup${NC}"
+    echo ""
+
+    local skill_targets=(
+        "$HOME/.claude/skills/loki-mode:Claude Code"
+        "$HOME/.codex/skills/loki-mode:Codex CLI"
+        "$HOME/.gemini/skills/loki-mode:Gemini CLI"
+    )
+
+    local created=0
+    local skipped=0
+    local failed=0
+
+    for entry in "${skill_targets[@]}"; do
+        local target_dir="${entry%%:*}"
+        local target_name="${entry#*:}"
+        local parent_dir
+        parent_dir=$(dirname "$target_dir")
+        local short_path="${target_dir/#$HOME/\~}"
+
+        # Already exists and valid
+        if [ -f "$target_dir/SKILL.md" ]; then
+            echo -e "  ${GREEN}OK${NC}    $target_name  ${DIM}($short_path)${NC}"
+            skipped=$((skipped + 1))
+            continue
+        fi
+
+        # Remove broken symlink
+        if [ -L "$target_dir" ]; then
+            rm -f "$target_dir"
+        fi
+
+        # Create parent directory
+        if [ ! -d "$parent_dir" ]; then
+            mkdir -p "$parent_dir" 2>/dev/null || true
+        fi
+
+        # Create symlink to skill dir
+        if ln -sf "$SKILL_DIR" "$target_dir" 2>/dev/null; then
+            echo -e "  ${GREEN}NEW${NC}   $target_name  ${DIM}($short_path)${NC}"
+            created=$((created + 1))
+        else
+            echo -e "  ${RED}FAIL${NC}  $target_name  ${DIM}($short_path)${NC}"
+            failed=$((failed + 1))
+        fi
+    done
+
+    echo ""
+    if [ "$created" -gt 0 ]; then
+        echo -e "${GREEN}Created $created new skill symlink(s).${NC}"
+    fi
+    if [ "$skipped" -gt 0 ]; then
+        echo -e "${DIM}$skipped already installed.${NC}"
+    fi
+    if [ "$failed" -gt 0 ]; then
+        echo -e "${RED}$failed failed (check permissions).${NC}"
+        return 1
+    fi
+    return 0
+}
+
 # Check system prerequisites
 cmd_doctor() {
     local json_output=false
@@ -3001,6 +3065,29 @@ cmd_doctor() {
     doctor_check "Gemini CLI"          gemini   optional
     echo ""
 
+    echo -e "${CYAN}Skills:${NC}"
+    local skill_dirs=(
+        "$HOME/.claude/skills/loki-mode:Claude Code"
+        "$HOME/.codex/skills/loki-mode:Codex CLI"
+        "$HOME/.gemini/skills/loki-mode:Gemini CLI"
+    )
+    for entry in "${skill_dirs[@]}"; do
+        local sdir="${entry%%:*}"
+        local sname="${entry#*:}"
+        local short_path="${sdir/$HOME/~}"
+        if [ -f "$sdir/SKILL.md" ]; then
+            echo -e "  ${GREEN}PASS${NC}  $sname  ${DIM}$short_path${NC}"
+            pass_count=$((pass_count + 1))
+        elif [ -L "$sdir" ]; then
+            echo -e "  ${RED}FAIL${NC}  $sname  ${DIM}(broken symlink at $short_path)${NC}"
+            fail_count=$((fail_count + 1))
+        else
+            echo -e "  ${YELLOW}WARN${NC}  $sname  ${DIM}(not found - run 'loki setup-skill')${NC}"
+            warn_count=$((warn_count + 1))
+        fi
+    done
+    echo ""
+
     echo -e "${CYAN}System:${NC}"
     doctor_check "bash (>= 4.0)"      bash     recommended  4.0
 
@@ -4679,6 +4766,9 @@ main() {
         doctor)
             cmd_doctor "$@"
             ;;
+        setup-skill)
+            cmd_setup_skill "$@"
+            ;;
         watchdog)
             cmd_watchdog "$@"
             ;;

package/bin/postinstall.js

@@ -9,7 +9,6 @@ const path = require('path');
 const os = require('os');
 
 const homeDir = os.homedir();
-const skillDir = path.join(homeDir, '.claude', 'skills', 'loki-mode');
 const packageDir = path.join(__dirname, '..');
 
 const version = (() => {
@@ -21,73 +20,79 @@ console.log('');
 console.log(`Loki Mode v${version} installed!`);
 console.log('');
 
-// Try to create skill symlink
-try {
-  const skillParent = path.dirname(skillDir);
+// Multi-provider skill targets
+const skillTargets = [
+  { dir: path.join(homeDir, '.claude', 'skills', 'loki-mode'), name: 'Claude Code' },
+  { dir: path.join(homeDir, '.codex', 'skills', 'loki-mode'), name: 'Codex CLI' },
+  { dir: path.join(homeDir, '.gemini', 'skills', 'loki-mode'), name: 'Gemini CLI' },
+];
 
-  if (!fs.existsSync(skillParent)) {
-    fs.mkdirSync(skillParent, { recursive: true });
-  }
+const results = [];
+
+for (const target of skillTargets) {
+  try {
+    const skillParent = path.dirname(target.dir);
 
-  // Remove existing symlink/directory
-  if (fs.existsSync(skillDir)) {
-    const stats = fs.lstatSync(skillDir);
-    if (stats.isSymbolicLink()) {
-      fs.unlinkSync(skillDir);
-    } else {
-      // Existing real directory (not a symlink) - back it up and replace
-      const backupDir = skillDir + '.backup.' + Date.now();
-      console.log(`[WARNING] Existing non-symlink installation found at ${skillDir}`);
-      console.log(`  Active version: ${skillDir}`);
-      console.log(`  npm version:    ${packageDir}`);
-      console.log('');
-      console.log(`Backing up existing installation to: ${backupDir}`);
-      try {
-        fs.renameSync(skillDir, backupDir);
-        console.log('Backup complete. Creating symlink to npm installation.');
-        console.log('');
-        console.log(`To restore the old installation later:`);
-        console.log(`  rm "${skillDir}" && mv "${backupDir}" "${skillDir}"`);
-        console.log('');
-      } catch (backupErr) {
-        console.log(`Could not back up existing installation: ${backupErr.message}`);
-        console.log('');
-        console.log('To fix manually, remove the existing directory and reinstall:');
-        console.log(`  rm -rf "${skillDir}"`);
-        console.log('  npm install -g loki-mode');
-        console.log('');
+    if (!fs.existsSync(skillParent)) {
+      fs.mkdirSync(skillParent, { recursive: true });
+    }
+
+    // Remove existing symlink/directory
+    if (fs.existsSync(target.dir)) {
+      const stats = fs.lstatSync(target.dir);
+      if (stats.isSymbolicLink()) {
+        fs.unlinkSync(target.dir);
+      } else {
+        // Existing real directory (not a symlink) - back it up and replace
+        const backupDir = target.dir + '.backup.' + Date.now();
+        console.log(`[WARNING] Existing non-symlink installation found at ${target.dir}`);
+        console.log(`  Backing up to: ${backupDir}`);
+        try {
+          fs.renameSync(target.dir, backupDir);
+        } catch (backupErr) {
+          console.log(`  Could not back up: ${backupErr.message}`);
+          results.push({ name: target.name, path: target.dir, ok: false });
+          continue;
+        }
       }
     }
+
+    // Create symlink
+    if (!fs.existsSync(target.dir)) {
+      fs.symlinkSync(packageDir, target.dir);
+    }
+    results.push({ name: target.name, path: target.dir, ok: true });
+  } catch (err) {
+    results.push({ name: target.name, path: target.dir, ok: false, error: err.message });
   }
+}
 
-  // Create symlink
-  if (!fs.existsSync(skillDir)) {
-    fs.symlinkSync(packageDir, skillDir);
-    console.log(`Skill installed to: ${skillDir}`);
+// Print summary
+console.log('Skills installed:');
+for (const r of results) {
+  const icon = r.ok ? 'OK' : 'SKIP';
+  const shortPath = r.path.replace(homeDir, '~');
+  if (r.ok) {
+    console.log(`  [${icon}] ${r.name.padEnd(12)} (${shortPath})`);
+  } else {
+    console.log(`  [${icon}] ${r.name.padEnd(12)} (${shortPath}) - ${r.error || 'backup failed'}`);
   }
-} catch (err) {
-  console.log(`Could not auto-install skill: ${err.message}`);
+}
+
+if (results.some(r => !r.ok)) {
   console.log('');
-  console.log('Manual installation:');
-  console.log(`  ln -sf "${packageDir}" "${skillDir}"`);
+  console.log('To fix missing symlinks:');
+  console.log(`  loki setup-skill`);
 }
 
 console.log('');
-console.log('Usage:');
-console.log('  loki start [PRD]              - Start with Claude (default)');
-console.log('  loki start --provider codex   - Start with OpenAI Codex');
-console.log('  loki start --provider gemini  - Start with Google Gemini');
-console.log('  loki status                   - Check status');
-console.log('  loki --help                   - Show all commands');
-console.log('');
-console.log('Providers:');
-console.log('  claude  - Full features (parallel agents, Task tool, MCP)');
-console.log('  codex   - Degraded mode (sequential only)');
-console.log('  gemini  - Degraded mode (sequential only)');
-console.log('');
-console.log('Or in Claude Code:');
-console.log('  claude --dangerously-skip-permissions');
-console.log('  Then say: "Loki Mode"');
+console.log('CLI commands:');
+console.log('  loki start ./prd.md              Start with Claude (default)');
+console.log('  loki start --provider codex      Start with OpenAI Codex');
+console.log('  loki start --provider gemini     Start with Google Gemini');
+console.log('  loki status                      Check status');
+console.log('  loki doctor                      Verify installation');
+console.log('  loki --help                      Show all commands');
 console.log('');
 
 // Anonymous install telemetry (fire-and-forget, silent)
@@ -113,6 +118,7 @@ try {
         version: version,
         channel: 'npm',
         node_version: process.version,
+        providers_installed: results.filter(r => r.ok).map(r => r.name).join(','),
       },
     });
     const req = https.request({

package/dashboard/__init__.py

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

package/docs/COMPETITIVE-ANALYSIS.md

@@ -85,7 +85,7 @@ GSD is the closest competitor -- a context engineering system that spawns fresh
 
 **Strengths:**
 - 85.9-87.7% Pass@1 on HumanEval
-- 100% task completion rate in evaluations
+- High task completion rate in evaluations (100% reported by MetaGPT authors; not independently verified)
 - Standard Operating Procedures (SOPs) reduce hallucinations
 - Assembly line paradigm with role specialization
 - Low cost: ~$1.09 per project completion

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.49.2
+**Version:** v5.49.4
 
 ---
 
@@ -34,42 +34,95 @@ The flagship product of [Autonomi](https://www.autonomi.dev/). Complete installa
 
 ## Table of Contents
 
-- [Quick Install (Recommended)](#quick-install-recommended)
+- [npm (Recommended)](#npm-recommended)
+- [Homebrew](#homebrew)
+- [Quick Start](#quick-start)
+- [Verify Installation](#verify-installation)
+- [Other Methods](#other-methods)
 - [VS Code Extension](#vs-code-extension)
-- [npm (Node.js)](#npm-nodejs)
-- [Homebrew (macOS/Linux)](#homebrew-macoslinux)
-- [Docker](#docker)
 - [Sandbox Mode](#sandbox-mode)
 - [Multi-Provider Support](#multi-provider-support)
 - [Claude Code (CLI)](#claude-code-cli)
 - [Claude.ai (Web)](#claudeai-web)
 - [Anthropic API Console](#anthropic-api-console)
-- [Verify Installation](#verify-installation)
 - [Ports](#ports)
 - [Shell Completions](#shell-completions)
 - [Troubleshooting](#troubleshooting)
 
 ---
 
-## Quick Install (Recommended)
-
-Choose your preferred method:
+## npm (Recommended)
 
 ```bash
-# Option A: npm (easiest)
 npm install -g loki-mode
+```
+
+Installs the `loki` CLI and automatically sets up the skill for Claude Code, Codex CLI, and Gemini CLI via the postinstall script.
 
-# Option B: Homebrew (macOS/Linux)
+**Prerequisites:** Node.js 16+
+
+**What it does:**
+- Installs the `loki` CLI binary to your PATH
+- Creates skill symlinks at `~/.claude/skills/loki-mode`, `~/.codex/skills/loki-mode`, and `~/.gemini/skills/loki-mode`
+- Each provider auto-discovers skills in its respective directory
+
+**Opt out of anonymous install telemetry:**
+```bash
+LOKI_TELEMETRY_DISABLED=true npm install -g loki-mode
+# Or set DO_NOT_TRACK=1
+```
+
+**Update:** `npm update -g loki-mode`
+
+**Uninstall:** `npm uninstall -g loki-mode`
+
+---
+
+## Homebrew
+
+```bash
 brew tap asklokesh/tap && brew install loki-mode
+```
 
-# Option C: Docker
-docker pull asklokesh/loki-mode:latest
+Installs the `loki` CLI. To also install the skill for interactive use with all providers:
 
-# Option D: Git clone
-git clone https://github.com/asklokesh/loki-mode.git ~/.claude/skills/loki-mode
+```bash
+loki setup-skill
 ```
 
-**Done!** Skip to [Verify Installation](#verify-installation).
+**Update:** `brew upgrade loki-mode`
+
+**Uninstall:** `brew uninstall loki-mode`
+
+---
+
+## Quick Start
+
+```bash
+# CLI mode (works with any provider)
+loki start ./prd.md
+loki start ./prd.md --provider codex
+loki start ./prd.md --provider gemini
+
+# Interactive mode (inside your coding agent)
+claude --dangerously-skip-permissions
+# Then say: "Loki Mode with PRD at ./my-prd.md"
+```
+
+---
+
+## Verify Installation
+
+```bash
+loki --version    # Should print the current version
+loki doctor       # Check skill symlinks, providers, and system prerequisites
+```
+
+---
+
+## Other Methods
+
+Git clone, Docker, GitHub Action, and VS Code Extension are also available. See [alternative-installations.md](alternative-installations.md) for details and trade-offs.
 
 ---
 
@@ -145,156 +198,6 @@ The extension will automatically connect when it detects the server is running a
 
 ---
 
-## npm (Node.js)
-
-Install via npm for the easiest setup with automatic PATH configuration.
-
-### Prerequisites
-
-- Node.js 16.0.0 or later
-
-### Installation
-
-```bash
-# Global installation
-npm install -g loki-mode
-
-# The skill is automatically installed to ~/.claude/skills/loki-mode
-
-# Opt out of anonymous install telemetry:
-# LOKI_TELEMETRY_DISABLED=true npm install -g loki-mode
-# Or set DO_NOT_TRACK=1
-```
-
-### Usage
-
-```bash
-# Use the CLI
-loki start ./my-prd.md
-loki status
-loki dashboard
-
-# Or invoke in Claude Code
-claude --dangerously-skip-permissions
-> Loki Mode with PRD at ./my-prd.md
-```
-
-### Updating
-
-```bash
-npm update -g loki-mode
-```
-
-### Uninstalling
-
-```bash
-npm uninstall -g loki-mode
-rm -rf ~/.claude/skills/loki-mode
-```
-
----
-
-## Homebrew (macOS/Linux)
-
-Install via Homebrew with automatic dependency management.
-
-### Prerequisites
-
-- Homebrew (https://brew.sh)
-
-### Installation
-
-```bash
-# Add the tap
-brew tap asklokesh/tap
-
-# Install Loki Mode
-brew install loki-mode
-
-# Set up Claude Code skill integration (manual symlink required)
-ln -sf "$(brew --prefix)/opt/loki-mode/libexec" ~/.claude/skills/loki-mode
-```
-
-### Dependencies
-
-Homebrew automatically installs:
-- bash 4.0+ (for associative arrays)
-- jq (JSON processing)
-- gh (GitHub CLI for integration)
-
-### Usage
-
-```bash
-# Use the CLI
-loki start ./my-prd.md
-loki status
-loki --help
-```
-
-### Updating
-
-```bash
-brew upgrade loki-mode
-```
-
-### Uninstalling
-
-```bash
-brew uninstall loki-mode
-rm -rf ~/.claude/skills/loki-mode
-```
-
----
-
-## Docker
-
-Run Loki Mode in a container for isolated execution.
-
-### Prerequisites
-
-- Docker installed and running
-
-### Installation
-
-```bash
-# Pull the image
-docker pull asklokesh/loki-mode:latest
-
-# Or use docker-compose
-curl -o docker-compose.yml https://raw.githubusercontent.com/asklokesh/loki-mode/main/docker-compose.yml
-```
-
-### Usage
-
-```bash
-# Run with a PRD file
-docker run -v $(pwd):/workspace -w /workspace asklokesh/loki-mode:latest start ./my-prd.md
-
-# Interactive mode
-docker run -it -v $(pwd):/workspace -w /workspace asklokesh/loki-mode:latest
-
-# Using docker-compose
-docker-compose run loki start ./my-prd.md
-```
-
-### Environment Variables
-
-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:latest start ./my-prd.md
-```
-
-### Updating
-
-```bash
-docker pull asklokesh/loki-mode:latest
-```
-
----
-
 ## Sandbox Mode
 
 Run Loki Mode in an isolated Docker container for enhanced security.

package/docs/alternative-installations.md

@@ -1,70 +1,54 @@
 # Alternative Installation Methods
 
-The primary installation method is git clone (see [README](../README.md#installation)). These alternatives serve specific use cases.
+The recommended installation is via npm or Homebrew (see [README](../README.md#installation)). These alternatives serve specific use cases.
 
 ---
 
-## npm (Secondary)
+## Git Clone (Manual)
 
-**Status**: Working. Version tracks releases automatically.
+Best for: contributors, development, or environments without npm/brew.
 
 ```bash
-npm install -g loki-mode
-```
-
-**Limitation**: Installs to `node_modules`, not `~/.claude/skills/`. To use as a Claude Code skill, you must symlink:
-
-```bash
-npm install -g loki-mode
-ln -sf "$(npm root -g)/loki-mode" ~/.claude/skills/loki-mode
-```
-
-**Best for**: CI/CD pipelines, programmatic access via `loki` CLI.
-
----
-
-## Homebrew (Secondary)
+# Clone to Claude Code skills directory
+git clone https://github.com/asklokesh/loki-mode.git ~/.claude/skills/loki-mode
 
-**Status**: Working. Tap and formula exist, version current.
+# Optionally symlink for other providers:
+ln -sf ~/.claude/skills/loki-mode ~/.codex/skills/loki-mode
+ln -sf ~/.claude/skills/loki-mode ~/.gemini/skills/loki-mode
 
-```bash
-brew tap asklokesh/tap
-brew install loki-mode
+# Optionally add CLI to PATH:
+ln -sf ~/.claude/skills/loki-mode/autonomy/loki /usr/local/bin/loki
 ```
 
-**Limitation**: Installs the `loki` CLI binary only. Does NOT install the Claude Code skill. To use with Claude Code, also run:
-
-```bash
-git clone https://github.com/asklokesh/loki-mode.git ~/.claude/skills/loki-mode
-```
+**Update:** `cd ~/.claude/skills/loki-mode && git pull`
 
-**Best for**: Users who want the `loki` CLI wrapper for autonomous mode (`loki start`, `loki stop`, `loki cleanup`).
+**Limitation:** Does not install the `loki` CLI to PATH automatically. You must symlink or add to PATH manually.
 
 ---
 
-## Docker (Secondary)
+## Docker
 
-**Status**: Image exists on Docker Hub. Tags: `latest`, version-specific (e.g., `5.49.1`).
+**Status:** Image exists on Docker Hub. Tags: `latest`, version-specific (e.g., `5.49.4`).
 
 ```bash
 docker pull asklokesh/loki-mode:latest
 ```
 
-**Limitation**: Claude Code is an interactive CLI that requires API keys and terminal access. Running it inside a Docker container is not the standard workflow. Docker is useful for:
+**Limitation:** Claude Code is an interactive CLI that requires API keys and terminal access. Running it inside a Docker container is not the standard workflow. Docker is useful for:
 
 - CI/CD sandbox execution (running `loki` in isolated environments)
 - Testing Loki Mode without modifying your local system
 - Air-gapped environments with pre-built images
 
-**Not recommended for**: Interactive Claude Code sessions. Use the git clone method instead.
+**Not recommended for:** Interactive Claude Code sessions. Use npm or Homebrew instead.
 
 See [DOCKER_README.md](../DOCKER_README.md) for Docker-specific usage instructions.
 
 ---
 
-## GitHub Action (Secondary)
+## GitHub Action
 
-**Status**: Working. Adds automated AI code review to pull requests.
+**Status:** Working. Adds automated AI code review to pull requests.
 
 ```yaml
 # .github/workflows/loki-review.yml
@@ -114,27 +98,27 @@ jobs:
 | `fix` | Automatically fix issues found in the codebase |
 | `test` | Run autonomous test generation and validation |
 
-**Best for**: Automated PR review and CI/CD integration.
+**Best for:** Automated PR review and CI/CD integration.
 
 ---
 
-## GitHub Release Download (Secondary)
+## GitHub Release Download
 
-**Status**: Working. Release assets available for each version.
+**Status:** Working. Release assets available for each version.
 
 ```bash
 # Download and extract to skills directory
-curl -sL https://github.com/asklokesh/loki-mode/archive/refs/tags/v5.49.1.tar.gz | tar xz
-mv loki-mode-5.49.1 ~/.claude/skills/loki-mode
+curl -sL https://github.com/asklokesh/loki-mode/archive/refs/tags/v5.49.4.tar.gz | tar xz
+mv loki-mode-5.49.4 ~/.claude/skills/loki-mode
 ```
 
-**Best for**: Offline or air-gapped environments, pinned version deployments.
+**Best for:** Offline or air-gapped environments, pinned version deployments.
 
 ---
 
-## VS Code Extension (Secondary)
+## VS Code Extension
 
-**Status**: Available on VS Code Marketplace.
+**Status:** Available on VS Code Marketplace.
 
 Search for "Loki Mode" in VS Code Extensions, or:
 
@@ -142,4 +126,4 @@ Search for "Loki Mode" in VS Code Extensions, or:
 code --install-extension asklokesh.loki-mode
 ```
 
-**Best for**: VS Code users who want dashboard integration within their editor.
+**Best for:** VS Code users who want dashboard integration within their editor.

package/mcp/__init__.py

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

package/package.json

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

package/references/quality-control.md

@@ -165,6 +165,16 @@ IMPLEMENT -> BLIND REVIEW (parallel) -> DEBATE (if disagreement) -> AGGREGATE ->
 - NEVER dispatch reviewers sequentially (always parallel - 3x faster)
 - NEVER aggregate before all 3 reviewers complete
 
+### Test Quality Review (Apply to Every Review)
+
+Before approving, verify:
+- Are tests using real implementations or excessive mocks of internal code?
+- Were any assertion expected values changed in the same commit as implementation? (This is the top sign an agent cheated.)
+- Do tests verify meaningful behavior or just "runs without throwing"?
+- Could all tests pass while the feature is completely broken?
+
+Assertion manipulation in the same commit as implementation = CRITICAL finding = automatic REJECT.
+
 ### Anti-Sycophancy Protocol (CONSENSAGENT Research)
 
 **Problem:** Reviewers may reinforce each other's findings instead of critically engaging.

package/skills/quality-gates.md

@@ -14,6 +14,24 @@
 8. **Mock Detector** - Classifies internal vs external mocks; flags tests that never import source code, tautological assertions, and high internal mock ratios
 9. **Test Mutation Detector** - Detects assertion value changes alongside implementation changes (test fitting), low assertion density, and missing pass/fail tracking
 
+## Gate 8 and 9: Automated Test Integrity
+
+Gates 8 (Mock Detector) and 9 (Test Mutation Detector) run during the VERIFY phase and are enabled by default.
+
+**How they run:**
+- Gate 8 runs `tests/detect-mock-problems.sh` against all test files in the project
+- Gate 9 runs `tests/detect-test-mutations.sh` against recent commits (default: last 5, or use `--commit HASH` for targeted checks)
+- Both produce findings at HIGH/MEDIUM/LOW severity levels
+- HIGH findings = automatic FAIL (same as other blocking gates)
+
+**Disabling (not recommended):**
+```bash
+LOKI_GATE_MOCK_DETECTOR=false    # Disable gate 8
+LOKI_GATE_MUTATION_DETECTOR=false # Disable gate 9
+```
+
+---
+
 ## Guardrails Execution Modes
 
 - **Blocking**: Guardrail completes before agent starts (use for expensive operations)

package/skills/testing.md

@@ -1,5 +1,20 @@
 # Testing
 
+## Mandatory Testing Rules
+
+1. Write tests FIRST. Commit the test before writing implementation.
+2. Tests must call REAL functions with REAL inputs and assert REAL outputs.
+3. Mock ONLY external dependencies: HTTP APIs, databases, file system, third-party services.
+4. NEVER mock internal modules, utility functions, or any code that is part of this project.
+5. NEVER change a test's expected value to make it pass. If a test fails, the implementation is wrong. Fix the code, not the test.
+6. If you believe a test expectation is incorrect, document WHY and flag for council review. Do not silently change it.
+7. Every test file must have at least one assertion per tested function.
+
+Gate 8 (mock detector) and Gate 9 (mutation detector) enforce rules 3-5 automatically.
+Violations result in automatic FAIL during VERIFY phase.
+
+---
+
 ## E2E Testing with Playwright MCP
 
 **Use Playwright MCP for browser-based testing.**