loki-mode 11.87.0 → 11.89.0

package/SKILL.md

@@ -3,7 +3,7 @@ name: loki-mode
 description: Runs an autonomous software factory that knows what it is supposed to deliver and proves it did, with a signed receipt. Use when the user says Loki Mode or asks to build, fix or verify software autonomously.
 ---
 
-# Loki Mode v11.87.0
+# Loki Mode v11.89.0
 
 **Current entry points (Loki 10 engine):** `loki "<task>"`, `loki owner/repo#N` and `loki quick "<task>"` run the Loki 10 engine and end with a signed receipt (`loki verify`). `loki backlog owner/repo --all` runs many issues in parallel. Guide: `docs/v10/GUIDE.md`. The skill instructions below, and `loki start`, describe the previous bash loop. PRD-file starts (`loki start ./prd.md`) and the opencode provider still run on it until FC38-SWEEP ports them; the legacy-engine command and the LOKI_ENGINE switch remain removed. Prefer `loki owner/repo#N` for issues.
 
@@ -475,4 +475,4 @@ Implemented, planned and deprecated items, with the version each landed in: `ski
 
 ---
 
-**v11.87.0 | [Autonomi](https://www.autonomi.dev/) flagship product | core skill**
+**v11.89.0 | [Autonomi](https://www.autonomi.dev/) flagship product | core skill**

package/VERSION

@@ -1 +1 @@
-11.87.0
+11.89.0

package/autonomy/lib/claude-flags.sh

@@ -1174,3 +1174,16 @@ _loki_claude_permission_argv() {
     _LOKI_PERM_ARGV=()
     while IFS= read -r _a; do _LOKI_PERM_ARGV+=("$_a"); done <<< "$_out"
 }
+
+# SHELL value for a claude child. Claude Code's Bash tool replays the aliases of
+# the shell named in SHELL, so a user's `alias ls=eza` hangs agent Bash commands.
+# Pin /bin/bash when executable (same rule as the engine10 route,
+# loki-ts/src/runner/worker_proc.ts pinBashShellEnv); LOKI_E10_KEEP_USER_SHELL=1
+# keeps the user's shell. Only SHELL changes; claude spawn sites only.
+_loki_claude_shell_value() {
+    if [ "${LOKI_E10_KEEP_USER_SHELL:-}" != "1" ] && [ -x /bin/bash ]; then
+        printf '%s' "/bin/bash"
+    else
+        printf '%s' "${SHELL-}"
+    fi
+}

package/autonomy/lib/telemetry-schema.json

@@ -51,6 +51,26 @@
    "gates_passed": {"type": "int", "min": 0, "max": 1000},
    "gates_total": {"type": "int", "min": 0, "max": 1000},
    "gate_pass_rate": {"type": "number", "min": 0, "max": 1}
+  },
+  "run_started": {
+   "engine": {"type": "enum", "values": ["engine10"]}
+  },
+  "run_finished": {
+   "engine": {"type": "enum", "values": ["engine10"]},
+   "verdict": {"type": "enum", "values": ["VERIFIED", "PARTIAL", "ALREADY_SATISFIED", "SPEC_CONFLICT", "FAILED", "INTERRUPTED", "BLOCKED"]},
+   "duration_s": {"type": "int", "min": 0, "max": 31536000},
+   "fix_rounds": {"type": "int", "min": 0, "max": 1000},
+   "exit_code": {"type": "int", "min": 0, "max": 255},
+   "stage_s_intake": {"type": "int", "min": 0, "max": 31536000},
+   "stage_s_plan": {"type": "int", "min": 0, "max": 31536000},
+   "stage_s_wall": {"type": "int", "min": 0, "max": 31536000},
+   "stage_s_implement": {"type": "int", "min": 0, "max": 31536000},
+   "stage_s_verify": {"type": "int", "min": 0, "max": 31536000},
+   "stage_s_fix": {"type": "int", "min": 0, "max": 31536000},
+   "stage_s_commit": {"type": "int", "min": 0, "max": 31536000},
+   "stage_s_seal": {"type": "int", "min": 0, "max": 31536000},
+   "stage_s_pr": {"type": "int", "min": 0, "max": 31536000},
+   "stage_s_deep": {"type": "int", "min": 0, "max": 31536000}
   }
  }
 }

package/autonomy/route.sh

@@ -60,9 +60,60 @@ _route_json_str() {
     printf '%s' "$1" | tr '\n\t\r' '   ' | sed -e 's/\\/\\\\/g' -e 's/"/\\"/g'
 }
 
+# Echoes the canonical https://github.com/owner/repo/pull/N for a github.com pull request URL
+# (host case-insensitive, optional www., http or https, optional /files style suffix); echoes nothing otherwise.
+# The owner/repo shape mirrors parsePrRef in loki-ts/src/commands/verify_pr.ts.
+_route_pr_url() {
+    local re='^[Hh][Tt][Tt][Pp][Ss]?://([Ww][Ww][Ww]\.)?[Gg][Ii][Tt][Hh][Uu][Bb]\.[Cc][Oo][Mm]/([A-Za-z0-9][A-Za-z0-9_.-]*/[A-Za-z0-9][A-Za-z0-9_.-]*)/pull/([0-9]+)([/?#].*)?$'
+    if [[ "$1" =~ $re ]]; then printf 'https://github.com/%s/pull/%s' "${BASH_REMATCH[2]}" "${BASH_REMATCH[3]}"; fi
+}
+
+# `loki start <PR URL> [--json] [--out DIR] [--no-pr]` is the verify-pr command, whatever the flag order.
+# Returns 1 when no argument is a PR URL (the caller carries on). Otherwise sets R_* (R_PR_ARGS = the verify-pr argv)
+# and returns 0; an unsupported flag or a second input sets R_ERR.
+# shellcheck disable=SC2034
+_route_pr_mode() {
+    local a pr="" bad="" badref="" extra="" i=0 n=$# u
+    local -a argv=("$@") eargs=()
+    for u in "$@"; do
+        case "$u" in --help|-h) return 1 ;; esac
+    done
+    while [ "$i" -lt "$n" ]; do
+        a="${argv[$i]}"; i=$((i + 1))
+        case "$a" in
+            --explain-route) R_EXPLAIN=1 ;;
+            --json) eargs+=(--json); R_JSON=1 ;;
+            --no-pr) ;;
+            --out) eargs+=(--out "${argv[$i]:-}"); i=$((i + 1)) ;;
+            --out=*) eargs+=(--out "${a#--out=}") ;;
+            -*) [ -n "$bad" ] || bad="${a%%=*}" ;;
+            *)
+                u="$(_route_pr_url "$a")"
+                # PR-shaped but invalid (a ".." in owner/repo): refused, like parsePrRef in verify_pr.ts.
+                if [ -n "$u" ]; then case "${u#https://github.com/}" in *..*) [ -n "$badref" ] || badref="$a" ;; esac; fi
+                if [ -n "$u" ] && [ -z "$pr" ]; then pr="$u"; else extra="${extra:+$extra }$a"; fi ;;
+        esac
+    done
+    [ -n "$pr" ] || return 1
+    R_DECIDED=1; R_INPUT_TYPE="pr"; R_INPUT="$pr"; R_ENGINE="verify-pr"; R_ADAPTER="verify-pr"
+    R_PROVIDER="n/a"; R_MODEL="n/a (no model call)"
+    R_REASON="pull request URL: verify-pr seals it; no plan or implement stage, nothing is pushed"
+    if [ -n "$badref" ]; then
+        R_ERR="loki: start <PR url>: not a valid pull request URL: $badref"
+    elif [ -n "$bad" ]; then
+        R_ERR="loki: start <PR url>: flag $bad is not supported (verify-pr takes --out DIR, --json and --no-pr)"
+    elif [ -n "$extra" ]; then
+        R_ERR="loki: start <PR url> takes one input; also got: $extra"
+    else
+        R_PR_ARGS=("$pr" ${eargs[@]+"${eargs[@]}"})
+    fi
+    return 0
+}
+
 _route_classify() {
-    # $1 = single positional. Echoes: issue | prd | task | brief | missing-prd
+    # $1 = single positional. Echoes: pr | issue | prd | task | brief | missing-prd
     local p="$1"
+    if [ -n "$(_route_pr_url "$p")" ]; then echo pr; return 0; fi
     case "$p" in
         */*\#[0-9]*|http*://*/issues/*|http*://*/browse/*|jira:*|linear:*|https://linear.app/*/issue/*) echo issue; return 0 ;;
     esac
@@ -83,7 +134,8 @@ loki_route_resolve() {
     local verb="$1"; shift
     R_DECIDED=0; R_E10=0; R_HARD=0; R_ENGINE=""; R_REASON=""; R_INPUT_TYPE=""; R_INPUT=""
     R_PROVIDER=""; R_MODEL=""; R_NOTICE=""; R_ERR=""; R_EXPLAIN=0; R_JSON=0; R_SESSION_MODEL=""; R_VERB=""
-    R_E10_ARGS=(); R_CLEAN=(); R_ADAPTER=""; R_CAPDIFF=(); R_E10_CAP_S=""; R_DRY=0; R_MAXCOST=""
+    R_E10_ARGS=(); R_CLEAN=(); R_ADAPTER=""; R_CAPDIFF=(); R_E10_CAP_S=""; R_DRY=0; R_MAXCOST=""; R_PR_ARGS=()
+    if [ "$verb" = "start" ] && _route_pr_mode "$@"; then return 0; fi
 
     local a engine_req="" dry=0 help=0 legacy_flag="" session_model="" provider_flag="" max_duration="" cap_err="" input_flag=""
     local -a positionals=() passthru=()
@@ -171,6 +223,8 @@ loki_route_resolve() {
         R_INPUT="(from --spec)"
     elif [ "$npos" -eq 1 ]; then
         R_INPUT_TYPE=$(_route_classify "${positionals[0]}")
+        # Only `loki start` sends a PR URL to verify-pr (_route_pr_mode); on any other verb engine10 runs it as a brief.
+        if [ "$R_INPUT_TYPE" = "pr" ]; then R_INPUT_TYPE=brief; fi
         R_INPUT="${positionals[0]}"
     else
         R_INPUT_TYPE=task

package/autonomy/run.sh

@@ -6874,12 +6874,12 @@ spawn_worktree_session() {
                 _LOKI_PERM_ARGV=(--dangerously-skip-permissions)
                 ! type _loki_claude_permission_argv >/dev/null 2>&1 || _loki_claude_permission_argv
                 if [ -n "$_loki_wt_cm" ]; then
-                    CAVEMAN_DEFAULT_MODE="$_loki_wt_cm" claude "${_LOKI_PERM_ARGV[@]}" \
+                    SHELL="$(_loki_claude_shell_value)" CAVEMAN_DEFAULT_MODE="$_loki_wt_cm" claude "${_LOKI_PERM_ARGV[@]}" \
                         "${_LOKI_WT_AUTO_FLAGS[@]+"${_LOKI_WT_AUTO_FLAGS[@]}"}" \
                         -p "Loki Mode: $task_prompt. Read .loki/CONTINUITY.md for context." \
                         >> "$log_file" 2>&1 || _wt_exit=$?
                 else
-                    claude "${_LOKI_PERM_ARGV[@]}" \
+                    SHELL="$(_loki_claude_shell_value)" claude "${_LOKI_PERM_ARGV[@]}" \
                         "${_LOKI_WT_AUTO_FLAGS[@]+"${_LOKI_WT_AUTO_FLAGS[@]}"}" \
                         -p "Loki Mode: $task_prompt. Read .loki/CONTINUITY.md for context." \
                         >> "$log_file" 2>&1 || _wt_exit=$?
@@ -7124,7 +7124,7 @@ Output ONLY the resolved file content with no conflict markers. No explanations.
                 # the EXACT resolved file content (the shell writes it verbatim).
                 # Compressing prose into the merged source would corrupt the file,
                 # so disable caveman unconditionally here. No-op when absent.
-                resolution=$(CAVEMAN_DEFAULT_MODE=off claude "${_cr_argv[@]}" -p "$conflict_prompt" --output-format text < /dev/null 2>/dev/null)
+                resolution=$(SHELL="$(_loki_claude_shell_value)" CAVEMAN_DEFAULT_MODE=off claude "${_cr_argv[@]}" -p "$conflict_prompt" --output-format text < /dev/null 2>/dev/null)
                 ;;
             codex)
                 resolution=$(codex exec --sandbox workspace-write --skip-git-repo-check "$conflict_prompt" 2>/dev/null)
@@ -16821,7 +16821,7 @@ _dispatch_reviewer() {
                         }
                 fi
                 _loki_with_deadline_stdin_text "$_cr_req_cap" "$prompt_text" \
-                    "${_cr_provider_env[@]}" CAVEMAN_DEFAULT_MODE=off \
+                    "${_cr_provider_env[@]}" "SHELL=$(_loki_claude_shell_value)" CAVEMAN_DEFAULT_MODE=off \
                         claude "${_rv_argv[@]}" -p \
                         --output-format text > "$_cr_req_raw" \
                     || _cr_req_rc=$?
@@ -16872,7 +16872,7 @@ _dispatch_reviewer() {
                         _cr_cap=$(_loki_review_deadline_remaining "$_review_deadline_ms") || return 124
                     fi
                     _cr_json="$(_loki_with_deadline_stdin_text "$_cr_cap" "$prompt_text" \
-                        "${_cr_provider_env[@]}" CAVEMAN_DEFAULT_MODE=off \
+                        "${_cr_provider_env[@]}" "SHELL=$(_loki_claude_shell_value)" CAVEMAN_DEFAULT_MODE=off \
                             claude "${_rv_argv[@]}" -p \
                             --json-schema "$_cr_schema_content" \
                             --output-format json)" || _cr_rc=$?
@@ -16902,7 +16902,7 @@ _dispatch_reviewer() {
                 _cr_text_cap=$(_loki_review_deadline_remaining "$_review_deadline_ms") || return 124
             fi
             _loki_with_deadline_stdin_text "$_cr_text_cap" "$prompt_text" \
-                "${_cr_provider_env[@]}" CAVEMAN_DEFAULT_MODE=off claude "${_rv_argv[@]}" -p \
+                "${_cr_provider_env[@]}" "SHELL=$(_loki_claude_shell_value)" CAVEMAN_DEFAULT_MODE=off claude "${_rv_argv[@]}" -p \
                 --output-format text > "$review_output"
             ;;
         codex)
@@ -21774,9 +21774,20 @@ ${_commits}"
     # would fail that check or produce caveman-style USAGE text, so disable
     # caveman unconditionally. Inlined on `claude` only (does not cross the pipe
     # to head). No-op when caveman is absent.
+    # A non-claude provider with LOKI_ALLOW_CLAUDE_SIDECALLS=1 never loads
+    # claude.sh, so compute the pinned shell in a subshell: the helper's
+    # top-level exports (caveman vars) must not leak into this process.
+    local _ic_shell
+    _ic_shell="$(
+        # shellcheck source=/dev/null
+        type _loki_claude_shell_value >/dev/null 2>&1 \
+            || . "$PROJECT_DIR/autonomy/lib/claude-flags.sh" >/dev/null 2>&1 || exit 1
+        _loki_claude_shell_value
+    )" || _ic_shell=""
+    [ -n "$_ic_shell" ] || _ic_shell="${SHELL-}"
     local _ic_out
     _ic_out=$(printf '%s' "$_ic_prompt" \
-        | timeout 60 env CAVEMAN_DEFAULT_MODE=off claude "${_ic_argv[@]}" -p - 2>/dev/null \
+        | timeout 60 env "SHELL=$_ic_shell" CAVEMAN_DEFAULT_MODE=off claude "${_ic_argv[@]}" -p - 2>/dev/null \
         | head -200)
     # Sanity check: response must look like Markdown (starts with # or ##).
     if [ -z "$_ic_out" ] || ! printf '%s' "$_ic_out" | head -1 | grep -qE '^#'; then
@@ -26174,11 +26185,13 @@ except Exception as exc:
                 CAVEMAN_DEFAULT_MODE="$_loki_cm_level" \
                 LOKI_DEADLINE_IDLE_TIMEOUT="${LOKI_PROVIDER_IDLE_TIMEOUT:-0}" \
                 _loki_with_deadline "${LOKI_PROVIDER_CALL_TIMEOUT:-0}" \
+                env "SHELL=$(_loki_claude_shell_value)" \
                 claude "${_loki_claude_argv[@]}" -p "$prompt" \
             --output-format stream-json --verbose < /dev/null 2>&1
                 else
                 LOKI_DEADLINE_IDLE_TIMEOUT="${LOKI_PROVIDER_IDLE_TIMEOUT:-0}" \
                 _loki_with_deadline "${LOKI_PROVIDER_CALL_TIMEOUT:-0}" \
+                env "SHELL=$(_loki_claude_shell_value)" \
                 claude "${_loki_claude_argv[@]}" -p "$prompt" \
             --output-format stream-json --verbose < /dev/null 2>&1
                 fi | \

package/autonomy/telemetry.sh

@@ -432,3 +432,36 @@ loki_emit_build_verified_enum() {
     loki_telemetry "build_verified" "headline=VERIFIED" "route=engine10"
     return 0
 }
+
+# loki_emit_run_started: one run_started event for a default-route (engine10)
+# run. Fixed engine value, no caller input. Same strict analytics gate as the
+# other run-outcome events, so every existing opt-out wins.
+loki_emit_run_started() {
+    _loki_analytics_enabled || return 0
+    loki_telemetry "run_started" "engine=engine10"
+    return 0
+}
+
+# loki_emit_run_finished <verdict> [key=value...]: one run_finished event.
+# Enum and integer args only: a verdict outside the fixed list sends nothing,
+# and a pair is forwarded only when its key is duration_s, fix_rounds, exit_code
+# or stage_s_<engine stage> AND its value is a plain non-negative integer. Never
+# a path, repo, branch, prompt or error text; the schema re-filters at send.
+loki_emit_run_finished() {
+    _loki_analytics_enabled || return 0
+    local _verdict="${1:-}"; shift
+    case "$_verdict" in VERIFIED|PARTIAL|ALREADY_SATISFIED|SPEC_CONFLICT|FAILED|INTERRUPTED|BLOCKED) ;; *) return 0 ;; esac
+    local _args=("engine=engine10" "verdict=${_verdict}") _kv _k _v
+    for _kv in "$@"; do
+        _k="${_kv%%=*}"; _v="${_kv#*=}"
+        case "$_k" in
+            duration_s|fix_rounds|exit_code|stage_s_intake|stage_s_plan|stage_s_wall|stage_s_implement|stage_s_verify|stage_s_fix|stage_s_commit|stage_s_seal|stage_s_pr|stage_s_deep) ;;
+            *) continue ;;
+        esac
+        case "$_v" in ''|*[!0-9]*) continue ;; esac
+        [ "${#_v}" -le 9 ] || continue
+        _args+=("${_k}=${_v}")
+    done
+    loki_telemetry "run_finished" "${_args[@]}"
+    return 0
+}

package/bin/loki

@@ -643,7 +643,9 @@ if [ -f "$REPO_ROOT/autonomy/route.sh" ] && { [ "$_LOKI_START_ATTEMPTS" != "1" ]
             export LOKI_SESSION_MODEL="$R_SESSION_MODEL"
         fi
         if [ "$R_E10" = "1" ] && [ -n "${R_E10_CAP_S:-}" ]; then export LOKI_E10_CAP_S="$R_E10_CAP_S"; fi
-        if [ "$R_E10" != "1" ]; then
+        if [ "$R_ENGINE" = "verify-pr" ]; then
+            set -- verify-pr "${R_PR_ARGS[@]}"
+        elif [ "$R_E10" != "1" ]; then
             set -- "$([ "$R_VERB" = "bare" ] && echo start || echo "$R_VERB")" ${R_CLEAN[@]+"${R_CLEAN[@]}"}
         fi
     fi

package/dashboard/__init__.py

@@ -7,6 +7,6 @@ Modules:
     control: Session control helpers (status, atomic writes, origin check)
 """
 
-__version__ = "11.87.0"
+__version__ = "11.89.0"
 
 __all__ = ["__version__"]

package/docs/CLI-REFERENCE.md

@@ -1,6 +1,6 @@
 # CLI reference
 
-Generated from `loki-ts/src/cli/registry.ts` by `scripts/generate-stale-zero.sh` for v11.87.0. Do not edit by hand.
+Generated from `loki-ts/src/cli/registry.ts` by `scripts/generate-stale-zero.sh` for v11.89.0. Do not edit by hand.
 Hidden and legacy-only commands are omitted; see `docs/CLI-INVENTORY.md` for the full inventory.
 
 | Command | Description |

package/docs/INSTALLATION.md

@@ -2,7 +2,7 @@
 
 Loki Mode, by [Autonomi](https://www.autonomi.dev/), turns a spec or an issue into a verified pull request with a receipt you can check. This page covers installing it, a first run, and the options around it.
 
-**Version:** v11.87.0
+**Version:** v11.89.0
 
 **Engine note:** `loki start` is the primary command. `loki start`, `loki "<task>"`, `loki owner/repo#N` and `loki quick` all run the Loki 10 engine, whatever the flag order or input form (PRD file, issue ref, task or one-word brief). The previous loop runs only on `--engine legacy`, `LOKI_ENGINE=legacy`, or for one call when a flag Loki 10 cannot honor is present. See the [user guide](v10/GUIDE.md) and the [5-minute quickstart](QUICKSTART.md).
 

package/docs/PRIVACY.md

@@ -102,6 +102,8 @@ paths, keys, or repo names -- only anonymous diagnostics.
   | `first_start_attempted` | first `loki start`, strict opt-in (section 4) | `entry` (a known loki subcommand, else `other`) |
   | `first_run_blocked` | first run stopped, strict opt-in (section 5) | `blocker` (fixed enum, section 5) |
   | `seal_hook_decision` | the loki-seal Stop hook decides, strict opt-in (section 4) | `decision` (allow, block), `reason` (none, tests_failed, tests_weakened, no_tests, contract_unverified, released, error) |
+  | `run_started` | a default-route run ends, strict opt-in (section 4) | `engine` (engine10) |
+  | `run_finished` | a default-route run ends, strict opt-in (section 4) | `engine`, `verdict` (VERIFIED, PARTIAL, ALREADY_SATISFIED, SPEC_CONFLICT, FAILED, INTERRUPTED, BLOCKED), `duration_s`, `stage_s_<stage>` (seconds per engine stage), `fix_rounds` (count), `exit_code` (0 to 255) |
   | `build_verified` | a build finishes, strict opt-in (section 4) | see section 4 |
 
   The `install` event of older versions is now `installed`. The npm postinstall

package/docs/dev/release-checklist.md

@@ -12,6 +12,19 @@ refs/heads/main` matches `git rev-parse HEAD`. `scripts/local-ci.sh` remains
 available for diagnosis on a quiet cycle -- it is no longer a push
 precondition, fast tier or full.
 
+Slice gate (run before reporting a slice built; a reviewer reruns the same command):
+`bash scripts/select-tests.sh --gate [--suite tests/test-foo.sh]... [--no-loki-ts]`.
+It checks that HEAD contains the current origin/main (and names how far behind
+it is, never rebasing for you), runs exactly the `--guards-only` row set (the
+`scripts/global-guards.tsv` rows plus the marker-only walkers, from one shared emitter) one
+at a time and names any red row, runs each `--suite`, then runs full engine10
+(`bun run test:engine10` in loki-ts, through the slot queue when the tree has that script) unless `--no-loki-ts` says the slice
+touched no loki-ts source. Every row, suite and the engine10 run is bounded by
+`timeout -k 15` (`LOKI_GATE_ROW_TIMEOUT`, `LOKI_GATE_SUITE_TIMEOUT`, `LOKI_GATE_ENGINE10_TIMEOUT`);
+a timeout, an empty guard list, a failed fetch (unless `--no-fetch`) or a missing
+`bun` fails the gate. It prints a pass/fail summary per step and exits
+non-zero on any failure.
+
 After a release ships, run post-release distribution validation:
 - npm: `npm pack loki-mode@<VERSION>`, untar, run `bash package/bin/loki version`
 - Docker: `docker pull asklokesh/loki-mode:<VERSION>`, `docker run --rm <img> version`,
@@ -113,6 +126,8 @@ For a manual push (`git push origin main`), run `bash scripts/local-ci.sh` first
 npm, then creates the tag and GitHub Release, builds/pushes Docker (including `:latest`), and updates the Homebrew tap. Do not manually
 create tags.
 
+Run the full Bun suite (including `tests/engine10`) only through `cd loki-ts && bun run test` or `bun run test:engine10`: both go through `scripts/test-slot.sh`, which allows at most 2 full runs per machine (`LOKI_ENGINE10_SLOTS` overrides; slots live in `~/.cache/loki-test-slots`, override `LOKI_TEST_SLOT_DIR`). A third run prints "waiting for a test slot" and starts when one frees; it is never killed, and a slot whose holder PID is dead is reclaimed. Filtered runs (`bun run test <file>`) take no slot. Never start the suite with a bare `bun test` for a full run. Test: `tests/test-test-slot.sh`.
+
 Before pushing the release commit, run `bash scripts/release.sh --check-clean`: it exits 1 naming any tracked file (for example a stamped `loki-ts/dist/loki.js.map`) the commit left modified; `--bump-only` prints the "stage these files:" list.
 
 ### 5. Verify ALL Distribution Channels