loki-mode 7.4.12 → 7.4.14

package/README.md

@@ -35,12 +35,18 @@
 
 ## Get Started in 30 Seconds
 
+**Recommended (Bun, fastest):**
+
 ```bash
-npm install -g loki-mode
-loki doctor                        # verify environment
+# Install Bun once (skip if you already have it)
+curl -fsSL https://bun.sh/install | bash      # macOS / Linux
+# or: brew install oven-sh/bun/bun
+
+bun install -g loki-mode
+loki doctor                                   # verify environment
 loki init my-app --template simple-todo-app
 cd my-app
-loki start prd.md                  # autonomous build starts
+loki start prd.md                             # autonomous build starts
 ```
 
 Or skip scaffolding and go straight to a quick task:
@@ -49,6 +55,27 @@ Or skip scaffolding and go straight to a quick task:
 loki quick "build a landing page with a signup form"
 ```
 
+**Other install methods (all work, all keep working):**
+
+| Method | Command | Notes |
+|--------|---------|-------|
+| **Bun (recommended)** | `bun install -g loki-mode` | Fastest. v8 will be Bun-only. |
+| **Homebrew** | `brew tap asklokesh/tap && brew install loki-mode` | Auto-installs Bun as a dep |
+| **Docker** | `docker pull asklokesh/loki-mode && docker run --rm asklokesh/loki-mode start prd.md` | Bun pre-installed in image |
+| **npm (compat)** | `npm install -g loki-mode` | Works without Bun (bash fallback). Migrate any time with `loki self-update --to bun`. |
+
+**Upgrading:**
+
+```bash
+loki self-update                  # upgrade in place via current manager
+loki self-update --to bun         # switch from npm/brew to Bun
+loki self-update --check          # show current install path + manager
+```
+
+`loki self-update` auto-detects which package manager installed loki and runs the right upgrade. If you installed via npm and want to switch to Bun (recommended for v8.0.0 forward-compat), `loki self-update --to bun` does the migration in one command (installs via Bun first, then uninstalls the npm copy).
+
+See the [Installation Guide](docs/INSTALLATION.md) for the long form.
+
 ---
 
 ## Runtime Architecture

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 v7.4.12
+# Loki Mode v7.4.14
 
 **You are an autonomous agent. You make decisions. You do not ask questions. You do not stop.**
 
@@ -322,4 +322,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 |
 
-**v7.4.12 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**
+**v7.4.14 | [Autonomi](https://www.autonomi.dev/) flagship product | ~260 lines core**

package/VERSION

@@ -1 +1 @@
-7.4.12
+7.4.14

package/autonomy/loki

@@ -457,6 +457,7 @@ show_help() {
     echo "  reset [target]   Reset session state (all|retries|failed)"
     echo "  doctor [--json]  Check system prerequisites and skill symlinks"
     echo "  setup-skill      Create skill symlinks for all providers"
+    echo "  self-update      Upgrade loki via current manager (use --to bun|npm|brew to switch)"
     echo "  watchdog [cmd]   Process health monitoring (status|help)"
     echo "  telemetry [cmd]  OpenTelemetry management (status|enable|disable)"
     echo "  worktree [cmd]   Parallel worktree management (list|merge|clean|status)"
@@ -6230,6 +6231,198 @@ cmd_setup_skill() {
     return 0
 }
 
+# v7.4.14: cmd_self_update -- one upgrade command for everyone.
+#
+# Auto-detects which package manager installed `loki` (npm, bun, brew) by
+# resolving the binary path, and runs the right upgrade command.
+#
+# `--to <mgr>` switches managers (installs via the new one, then uninstalls
+# the old). Useful for npm users wanting to migrate to Bun (the v8.0.0
+# direction).
+#
+# Usage:
+#   loki self-update                Upgrade in-place via current manager
+#   loki self-update --to bun       Switch from current to Bun
+#   loki self-update --to npm       Switch from current to npm
+#   loki self-update --to brew      Switch from current to Homebrew
+#   loki self-update --check        Print detection result + exit 0
+#
+cmd_self_update() {
+    local target_manager=""
+    local check_only=false
+
+    while [ $# -gt 0 ]; do
+        case "$1" in
+            --to)
+                if [ -z "${2:-}" ]; then
+                    echo -e "${RED}--to requires an argument: bun|npm|brew${NC}" >&2
+                    return 1
+                fi
+                target_manager="$2"
+                shift 2
+                ;;
+            --check)
+                check_only=true
+                shift
+                ;;
+            --help|-h)
+                cat <<'EOF'
+loki self-update -- detect manager and upgrade in place, or switch managers
+
+Usage:
+  loki self-update                    Upgrade via current manager
+  loki self-update --to bun           Switch to Bun (recommended for v8)
+  loki self-update --to npm           Switch to npm
+  loki self-update --to brew          Switch to Homebrew
+  loki self-update --check            Print detected manager and exit
+  loki self-update --help             Show this help
+
+Auto-detection looks at the resolved path of the `loki` binary:
+  ~/.bun/bin/loki                  -> bun
+  /opt/homebrew/Cellar/loki-mode   -> brew (also /usr/local/Cellar)
+  npm prefix + /bin/loki           -> npm
+  anywhere else                    -> unknown
+
+Switching managers installs via the new one first (so a failed install
+does not leave you with no loki), then uninstalls the old one.
+EOF
+                return 0
+                ;;
+            *)
+                echo -e "${RED}Unknown argument: $1${NC}" >&2
+                echo "Run 'loki self-update --help' for usage." >&2
+                return 1
+                ;;
+        esac
+    done
+
+    # Detect current install path
+    local resolved current_mgr=""
+    if ! resolved=$(command -v loki 2>/dev/null); then
+        echo -e "${RED}loki is not on PATH. Cannot self-update.${NC}" >&2
+        return 1
+    fi
+
+    # Follow symlinks to find the real binary location
+    local resolved_real
+    if command -v realpath >/dev/null 2>&1; then
+        resolved_real=$(realpath "$resolved" 2>/dev/null || echo "$resolved")
+    else
+        resolved_real="$resolved"
+    fi
+
+    case "$resolved_real" in
+        */.bun/bin/*|*/.bun/install/global/*)
+            current_mgr="bun"
+            ;;
+        */Cellar/*|*/homebrew/Cellar/*|*/linuxbrew/Cellar/*)
+            current_mgr="brew"
+            ;;
+        *)
+            # Try matching against npm global prefix
+            if command -v npm >/dev/null 2>&1; then
+                local npm_prefix
+                npm_prefix=$(npm prefix -g 2>/dev/null || true)
+                if [ -n "$npm_prefix" ] && [[ "$resolved_real" == "$npm_prefix"/* ]]; then
+                    current_mgr="npm"
+                fi
+            fi
+            ;;
+    esac
+
+    [ -z "$current_mgr" ] && current_mgr="unknown"
+
+    if [ "$check_only" = "true" ]; then
+        echo "loki binary:    $resolved"
+        echo "resolved path:  $resolved_real"
+        echo "current mgr:    $current_mgr"
+        return 0
+    fi
+
+    # Default target: same as current (in-place upgrade)
+    [ -z "$target_manager" ] && target_manager="$current_mgr"
+
+    echo -e "${BOLD}loki self-update${NC}"
+    echo "  current: $current_mgr ($resolved_real)"
+    echo "  target:  $target_manager"
+    echo
+
+    # Same-manager upgrade
+    if [ "$target_manager" = "$current_mgr" ]; then
+        case "$current_mgr" in
+            npm)
+                echo "Running: npm install -g loki-mode@latest"
+                npm install -g loki-mode@latest
+                ;;
+            bun)
+                echo "Running: bun update -g loki-mode (falling back to install if not present)"
+                bun update -g loki-mode 2>/dev/null || bun install -g loki-mode@latest
+                ;;
+            brew)
+                echo "Running: brew upgrade loki-mode"
+                brew upgrade loki-mode
+                ;;
+            unknown)
+                echo -e "${RED}Cannot detect package manager from path: $resolved_real${NC}" >&2
+                echo "Run 'loki self-update --to bun' (or npm/brew) to install fresh via that manager." >&2
+                return 1
+                ;;
+        esac
+        local rc=$?
+        if [ "$rc" -eq 0 ]; then
+            echo
+            echo -e "${GREEN}Upgrade complete.${NC} Verify with: loki version"
+        fi
+        return "$rc"
+    fi
+
+    # Cross-manager switch: install new, then uninstall old
+    case "$target_manager" in
+        bun)
+            if ! command -v bun >/dev/null 2>&1; then
+                echo -e "${RED}bun is not installed.${NC} Install it first:" >&2
+                echo "  brew install oven-sh/bun/bun  # macOS via Homebrew" >&2
+                echo "  curl -fsSL https://bun.sh/install | bash  # any platform" >&2
+                return 1
+            fi
+            echo "Installing via Bun: bun install -g loki-mode@latest"
+            bun install -g loki-mode@latest || return 1
+            ;;
+        npm)
+            command -v npm >/dev/null 2>&1 || { echo -e "${RED}npm not found${NC}" >&2; return 1; }
+            echo "Installing via npm: npm install -g loki-mode@latest"
+            npm install -g loki-mode@latest || return 1
+            ;;
+        brew)
+            command -v brew >/dev/null 2>&1 || { echo -e "${RED}brew not found${NC}" >&2; return 1; }
+            echo "Tapping + installing via Homebrew"
+            brew tap asklokesh/tap 2>/dev/null || true
+            brew install loki-mode || brew upgrade loki-mode || return 1
+            ;;
+        *)
+            echo -e "${RED}Unknown target manager: $target_manager${NC} (use bun, npm, or brew)" >&2
+            return 1
+            ;;
+    esac
+
+    # New install succeeded -- uninstall old. Best-effort; failures are
+    # non-fatal because the user already has the new binary working.
+    if [ "$current_mgr" != "unknown" ]; then
+        echo
+        echo "Removing old install via $current_mgr..."
+        case "$current_mgr" in
+            npm) npm uninstall -g loki-mode 2>/dev/null || true ;;
+            bun) bun remove -g loki-mode 2>/dev/null || true ;;
+            brew) brew uninstall loki-mode 2>/dev/null || true ;;
+        esac
+    fi
+
+    echo
+    echo -e "${GREEN}Switched from $current_mgr to $target_manager.${NC}"
+    echo "New binary: $(command -v loki 2>/dev/null || echo 'restart your shell to pick up new PATH')"
+    return 0
+}
+
 # Check system prerequisites
 cmd_doctor() {
     local json_output=false
@@ -11536,18 +11729,9 @@ main() {
     local command="$1"
     shift
 
-    # v7.4.12: one-shot install/first-run telemetry. Replaces the
-    # bin/postinstall.js install event (postinstall removed because Bun
-    # blocks postinstalls by default and the prompt was confusing).
-    # Creates ~/.loki-first-run on first invocation; fires "installed"
-    # event ONCE per install with channel attribution. Idempotent + silent.
-    if [ -z "${LOKI_TELEMETRY_DISABLED:-}" ] && [ "${DO_NOT_TRACK:-}" != "1" ]; then
-        if [ ! -f "${HOME}/.loki-first-run" ] 2>/dev/null; then
-            touch "${HOME}/.loki-first-run" 2>/dev/null || true
-            loki_telemetry "installed" "first_command=$command" 2>/dev/null || true
-        fi
-    fi
-
+    # v7.4.13: first-run telemetry moved to bin/loki shim so it fires for
+    # both Bun-routed and bash-routed commands (autonomy/loki main() never
+    # runs for the 8 ported commands). Marker file: ~/.loki-first-run.
     loki_telemetry "cli_command" "command=$command" 2>/dev/null || true
 
     case "$command" in
@@ -11666,6 +11850,9 @@ main() {
         setup-skill)
             cmd_setup_skill "$@"
             ;;
+        self-update|self_update|update)
+            cmd_self_update "$@"
+            ;;
         watchdog)
             cmd_watchdog "$@"
             ;;

package/bin/loki

@@ -63,6 +63,22 @@ else
     exec "$BASH_CLI" "$@"
 fi
 
+# v7.4.13: one-shot first-run telemetry, MOVED from autonomy/loki main()
+# into the shim because the 8 ported commands (version, status, doctor,
+# stats, provider, memory) bypass main() entirely -- only unported
+# commands triggered the original hook. Now fires regardless of route.
+# Fire-and-forget; opt-out via LOKI_TELEMETRY_DISABLED=true or
+# DO_NOT_TRACK=1 (mirrors autonomy/telemetry.sh contract).
+if [ -z "${LOKI_TELEMETRY_DISABLED:-}" ] && [ "${DO_NOT_TRACK:-}" != "1" ] && [ ! -f "${HOME}/.loki-first-run" ] 2>/dev/null; then
+    touch "${HOME}/.loki-first-run" 2>/dev/null || true
+    if command -v curl &>/dev/null && [ -f "$REPO_ROOT/autonomy/telemetry.sh" ]; then
+        # Source telemetry helpers + fire installed event in background
+        # so the user does not pay latency on first invocation.
+        ( SCRIPT_DIR="$REPO_ROOT/autonomy"; source "$SCRIPT_DIR/telemetry.sh" 2>/dev/null && loki_telemetry "installed" "first_command=${1:-}" 2>/dev/null ) &
+        disown 2>/dev/null || true
+    fi
+fi
+
 # Force-fall-through to bash when the rollback flag is set.
 if [ "${LOKI_LEGACY_BASH:-0}" = "1" ] || [ "${LOKI_LEGACY_BASH:-}" = "true" ]; then
     exec "$BASH_CLI" "$@"

package/dashboard/__init__.py

@@ -7,7 +7,7 @@ Modules:
     control: Session control API (start/stop/pause/resume)
 """
 
-__version__ = "7.4.12"
+__version__ = "7.4.14"
 
 # 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:** v7.4.12
+**Version:** v7.4.14
 
 ---
 
@@ -94,7 +94,7 @@ loki setup-skill
 ## PyPI / Python SDK
 
 **The `loki` CLI is NOT available via `pip install loki-mode`.** PyPI hosts only the
-Python REST client SDK at `loki-mode-sdk` (v7.4.12+). The dashboard, MCP server,
+Python REST client SDK at `loki-mode-sdk` (v7.4.14+). The dashboard, MCP server,
 and orchestrator components ship via npm, Docker, and Homebrew only.
 
 ```bash

package/loki-ts/dist/loki.js

@@ -263,7 +263,7 @@ Start a session with: loki start <prd>`}}let Z=m0(X);return{exitCode:0,stdout:Q?
 `),0}async function $3(z){let Q=!1;for(let $ of z)if($==="--json")Q=!0;else if($==="--help"||$==="-h")return e0(),0;else return process.stderr.write(`${S}Unknown option: ${$}${K}
 `),process.stderr.write(`Usage: loki doctor [--json]
 `),1;if(Q){let $=await i1();return process.stdout.write(JSON.stringify($,null,2)+`
-`),0}return z3()}var r0,s0,i0;var z0=g(()=>{m();Q1();p();r0=/(\d+\.\d+(?:\.\d+)*)/;s0=[{name:"Claude Code",dir:".claude/skills/loki-mode"},{name:"Codex CLI",dir:".codex/skills/loki-mode"},{name:"Gemini CLI",dir:".gemini/skills/loki-mode"},{name:"Cline CLI",dir:".cline/skills/loki-mode"},{name:"Aider CLI",dir:".aider/skills/loki-mode"}];i0=[{displayName:"Node.js (>= 18)",jsonName:"Node.js",cmd:"node",required:"required",min:"18.0"},{displayName:"Python 3 (>= 3.8)",jsonName:"Python 3",cmd:"python3",required:"required",min:"3.8"},{displayName:"jq",jsonName:"jq",cmd:"jq",required:"required"},{displayName:"git",jsonName:"git",cmd:"git",required:"required"},{displayName:"curl",jsonName:"curl",cmd:"curl",required:"required"},{displayName:"bash (>= 4.0)",jsonName:"bash",cmd:"bash",required:"recommended",min:"4.0"},{displayName:"Bun (>= 1.3)",jsonName:"Bun",cmd:"bun",required:"recommended",min:"1.3"},{displayName:"Claude CLI",jsonName:"Claude CLI",cmd:"claude",required:"optional"},{displayName:"Codex CLI",jsonName:"Codex CLI",cmd:"codex",required:"optional"},{displayName:"Gemini CLI",jsonName:"Gemini CLI",cmd:"gemini",required:"optional"},{displayName:"Cline CLI",jsonName:"Cline CLI",cmd:"cline",required:"optional"},{displayName:"Aider CLI",jsonName:"Aider CLI",cmd:"aider",required:"optional"}]});h();import{readFileSync as U0}from"fs";import{resolve as V0,dirname as q0}from"path";import{fileURLToPath as G0}from"url";var v=null;function k1(){if(v!==null)return v;let z="7.4.12";if(typeof z==="string"&&z.length>0)return v=z,v;try{let Q=q0(G0(import.meta.url)),$=U1(Q);v=U0(V0($,"VERSION"),"utf-8").trim()}catch{v="unknown"}return v}function R1(){return process.stdout.write(`Loki Mode v${k1()}
+`),0}return z3()}var r0,s0,i0;var z0=g(()=>{m();Q1();p();r0=/(\d+\.\d+(?:\.\d+)*)/;s0=[{name:"Claude Code",dir:".claude/skills/loki-mode"},{name:"Codex CLI",dir:".codex/skills/loki-mode"},{name:"Gemini CLI",dir:".gemini/skills/loki-mode"},{name:"Cline CLI",dir:".cline/skills/loki-mode"},{name:"Aider CLI",dir:".aider/skills/loki-mode"}];i0=[{displayName:"Node.js (>= 18)",jsonName:"Node.js",cmd:"node",required:"required",min:"18.0"},{displayName:"Python 3 (>= 3.8)",jsonName:"Python 3",cmd:"python3",required:"required",min:"3.8"},{displayName:"jq",jsonName:"jq",cmd:"jq",required:"required"},{displayName:"git",jsonName:"git",cmd:"git",required:"required"},{displayName:"curl",jsonName:"curl",cmd:"curl",required:"required"},{displayName:"bash (>= 4.0)",jsonName:"bash",cmd:"bash",required:"recommended",min:"4.0"},{displayName:"Bun (>= 1.3)",jsonName:"Bun",cmd:"bun",required:"recommended",min:"1.3"},{displayName:"Claude CLI",jsonName:"Claude CLI",cmd:"claude",required:"optional"},{displayName:"Codex CLI",jsonName:"Codex CLI",cmd:"codex",required:"optional"},{displayName:"Gemini CLI",jsonName:"Gemini CLI",cmd:"gemini",required:"optional"},{displayName:"Cline CLI",jsonName:"Cline CLI",cmd:"cline",required:"optional"},{displayName:"Aider CLI",jsonName:"Aider CLI",cmd:"aider",required:"optional"}]});h();import{readFileSync as U0}from"fs";import{resolve as V0,dirname as q0}from"path";import{fileURLToPath as G0}from"url";var v=null;function k1(){if(v!==null)return v;let z="7.4.14";if(typeof z==="string"&&z.length>0)return v=z,v;try{let Q=q0(G0(import.meta.url)),$=U1(Q);v=U0(V0($,"VERSION"),"utf-8").trim()}catch{v="unknown"}return v}function R1(){return process.stdout.write(`Loki Mode v${k1()}
 `),0}m();p();h();import{readFileSync as A0,existsSync as O0}from"fs";import{resolve as _0}from"path";var T0=["claude","codex","gemini","cline","aider"];function D1(){let z=_0(b(),"state","provider");if(!O0(z))return"";try{return A0(z,"utf-8").trim()}catch{return""}}function I0(z,Q){return z||Q||process.env.LOKI_PROVIDER||"claude"}function w0(z){let Q=D1(),$=I0(z,Q);switch(process.stdout.write(`${x}Current Provider${K}
 `),process.stdout.write(`
 `),process.stdout.write(`${G}Provider:${K} ${$}
@@ -339,4 +339,4 @@ Set LOKI_LEGACY_BASH=1 to force the bash CLI for every command.
 `;async function Q3(z){let Q=z[0],$=z.slice(1);switch(Q){case void 0:case"help":case"--help":case"-h":return process.stdout.write($0),0;case"version":case"--version":case"-v":return R1();case"provider":return E1($);case"memory":return N1($);case"status":{let{runStatus:X}=await Promise.resolve().then(() => (m1(),v1));return X($)}case"stats":{let{runStats:X}=await Promise.resolve().then(() => (d1(),l1));return X($)}case"doctor":{let{runDoctor:X}=await Promise.resolve().then(() => (z0(),e1));return X($)}default:return process.stderr.write(`Unknown command: ${Q}
 `),process.stderr.write($0),2}}process.on("SIGINT",()=>process.exit(130));process.on("SIGTERM",()=>process.exit(143));var X3=await Q3(Bun.argv.slice(2));process.exit(X3);
 
-//# debugId=4E61A1C5EB88576364756E2164756E21
+//# debugId=CE61E1449AF2B79464756E2164756E21

package/mcp/__init__.py

@@ -57,4 +57,4 @@ try:
 except ImportError:
     __all__ = ['mcp']
 
-__version__ = '7.4.12'
+__version__ = '7.4.14'

package/package.json

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