brainlayer 1.3.0__tar.gz → 1.4.0__tar.gz

{brainlayer-1.3.0 → brainlayer-1.4.0}/.github/workflows/ci.yml

@@ -76,6 +76,12 @@ jobs:
           --ignore=tests/test_follow_up_rewrite.py
           --ignore=tests/test_prompt_classification.py
 
+      - name: Doctor fixture gate
+        env:
+          HF_HUB_OFFLINE: "1"
+          TRANSFORMERS_OFFLINE: "1"
+        run: pytest tests/test_doctor.py -v --tb=short
+
       - name: Isolated eval and hook routing tests
         env:
           HF_HUB_OFFLINE: "1"

{brainlayer-1.3.0 → brainlayer-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: brainlayer
-Version: 1.3.0
+Version: 1.4.0
 Summary: Persistent memory MCP server for AI agents — 13 tools, semantic search, knowledge graph, on-device SQLite
 Project-URL: Homepage, https://brainlayer.etanheyman.com
 Project-URL: Repository, https://github.com/EtanHey/brainlayer

{brainlayer-1.3.0 → brainlayer-1.4.0}/brain-bar/Sources/BrainBar/BrainBarServer.swift

@@ -664,11 +664,20 @@ final class BrainBarServer: @unchecked Sendable {
 
         // Claude Desktop's MCPB utility process currently parses raw extension
         // stdout in 8192-byte chunks. Raw newline transport omits optional tool
-        // annotations; Content-Length transport keeps the canonical tools/list.
+        // annotations and the verbose human-readable description prose (both the
+        // top-level tool descriptions and the per-property inputSchema
+        // descriptions). The Content-Length transport keeps the canonical, fully
+        // described tools/list; the raw line keeps only the machine-required
+        // shape (name + inputSchema structure) so the response stays under the
+        // 8192-byte MCPB chunk limit without dropping any tool.
         var compactResult = result
         compactResult["tools"] = tools.map { tool in
             var compact = tool
             compact.removeValue(forKey: "annotations")
+            compact.removeValue(forKey: "description")
+            if let schema = compact["inputSchema"] as? [String: Any] {
+                compact["inputSchema"] = stripSchemaDescriptions(schema)
+            }
             return compact
         }
 
@@ -677,6 +686,30 @@ final class BrainBarServer: @unchecked Sendable {
         return compactResponse
     }
 
+    /// Recursively removes human-readable `description` keys from a JSON schema
+    /// so the raw-line tools/list stays under Claude Desktop's MCPB chunk limit.
+    /// Structural keys (type, properties, required, enum, items, maxLength, …)
+    /// are preserved so the tool remains callable.
+    private static func stripSchemaDescriptions(_ schema: [String: Any]) -> [String: Any] {
+        var stripped = schema
+        stripped.removeValue(forKey: "description")
+        if let properties = stripped["properties"] as? [String: Any] {
+            var newProperties: [String: Any] = [:]
+            for (key, value) in properties {
+                if let nested = value as? [String: Any] {
+                    newProperties[key] = stripSchemaDescriptions(nested)
+                } else {
+                    newProperties[key] = value
+                }
+            }
+            stripped["properties"] = newProperties
+        }
+        if let items = stripped["items"] as? [String: Any] {
+            stripped["items"] = stripSchemaDescriptions(items)
+        }
+        return stripped
+    }
+
     private func disconnectClient(fd: Int32) {
         if let subscriptionID = clients[fd]?.brainBusSubscriptionID {
             brainBus.unsubscribeSynchronously(subscriptionID)

{brainlayer-1.3.0 → brainlayer-1.4.0}/brain-bar/Sources/BrainBar/BrainBarWindowRootView.swift

@@ -2130,7 +2130,7 @@ struct BrainBarDashboardLayout {
         diagnosticItemColumns = containerSize.width >= 760 ? 2 : 1
 
         compactCards = compactWidth || compactHeight
-        outerPadding = compactCards ? 24 : 32
+        outerPadding = compactCards ? 24 : 36
         sectionSpacing = compactCards ? 20 : 28
         gridSpacing = compactCards ? 16 : 22
         cardPadding = compactCards ? 22 : 32

{brainlayer-1.3.0 → brainlayer-1.4.0}/brain-bar/Sources/BrainBar/MCPRouter.swift

@@ -14,8 +14,13 @@ final class MCPRouter: @unchecked Sendable {
     // for replay so brain_store returns well under the 1s prompt-queue budget.
     // Longer contention handling belongs in the deferred single-writer/backpressure
     // path, not in the synchronous MCP response.
-    private static let mcpStoreBusyTimeoutMillis: Int32 = 250
-    private static let mcpStoreRetries = 1
+    //
+    // Budget math: a contended BEGIN IMMEDIATE blocks up to the busy timeout, and
+    // each extra retry adds another busy-timeout block plus a retry sleep. To stay
+    // under the 200ms queue budget the synchronous path makes exactly one short
+    // attempt (retries == 0) with a sub-budget busy timeout, then queues on busy.
+    private static let mcpStoreBusyTimeoutMillis: Int32 = 100
+    private static let mcpStoreRetries = 0
 
     private struct ToolOutput {
         let text: String

{brainlayer-1.3.0 → brainlayer-1.4.0}/brain-bar/bundle/Info.plist

@@ -9,9 +9,9 @@
     <key>CFBundleIdentifier</key>
     <string>com.brainlayer.brainbar</string>
     <key>CFBundleVersion</key>
-    <string>1.0.0</string>
+    <string>1.4.0</string>
     <key>CFBundleShortVersionString</key>
-    <string>1.0.0</string>
+    <string>1.4.0</string>
     <key>CFBundlePackageType</key>
     <string>APPL</string>
     <key>CFBundleExecutable</key>

brainlayer-1.4.0/docs/brew-layer-conformance.md

@@ -0,0 +1,66 @@
+# BrainLayer — Robust Brew Layer Conformance
+
+> Self-audit of BrainLayer against the cross-layer **Robust Brew Layer Standard**
+> (`orchestrator/standards/robust-brew-layer.md`, owner: cmuxlayerClaude).
+> Status as of **2026-06-21**, after the M1-clone (`happycampr`) friction sprint.
+> Every ✅ below is verified either on the live M4 dev machine or the M1 clone
+> end-to-end install (`brew install --cask brainbar` → working `1.3.0,1`).
+
+## Headline (§0 / §0.1) — two-consumer split
+
+BrainLayer is the standard's reference **two-consumer split**:
+
+- **App / fleet (socket + daemon):** `BrainBarDaemon` serves `brain_search` over the
+  **canonical socket `/tmp/brainbar.sock`** for the live BrainBar UI and for
+  cross-repo fleet agents. This is the genuinely-needed daemon case (§0).
+- **Agents (stdio MCP):** `brainlayer-mcp` (`brainlayer serve`) is a **stdio** server
+  launched per-agent that talks to the SQLite store directly — *not* through the
+  app's socket. This removes the agent path's dependency on the socket/daemon
+  failure classes (7a/7b/7c) entirely.
+
+### Write-path invariant (§0.1 hard requirement)
+
+The store runs in **WAL mode**. The concurrency invariant is preserved as follows:
+
+- **Reads** (`brain_search`, both DB-direct stdio and socket-served): safe under WAL —
+  SQLite WAL permits concurrent readers alongside writers. Agent read connections
+  open read-only.
+- **Writes** (`brain_store`, watcher, enrichment): serialized through the
+  **`com.brainlayer.drain` queue → single applying writer** (`docs/configuration.md`:
+  "Drain queued writes as the single writer"), with `WAL` + `busy_timeout` retry on
+  `SQLITE_BUSY` for any direct writer. The single-writer consistency assumption is
+  thus held by the drain, not by the GUI daemon — so the DB-direct stdio agent MCP
+  is a **reader**, never a competing writer.
+
+This satisfies §0.1: consumers are documented (socket = app/fleet, stdio = agents),
+and the write-path invariant is stated.
+
+## Conformance matrix
+
+| § | Class | Status | Evidence |
+|---|---|---|---|
+| 0 / 0.1 | stdio-preferred / split + write-path invariant documented | ✅ | This doc; `brainlayer-mcp` stdio + `BrainBarDaemon` socket; drain = single writer |
+| 1 | account-rename self-heal (no interactive sudo) | ⚠️ **partial** | Cask `preflight` self-heals dangling `localaiengine`-tainted Caskroom symlinks (account-agnostic via `start_with?`, user-owned only, no sudo) — **M1-verified**. **Gap:** no standalone `brainlayer doctor --fix` CLI (the §1 MUST form). |
+| 2 | sudo-free cask uninstall / upgrade | ✅ | brainbar installs **user** LaunchAgents (`gui/$uid`), no privileged helper → uninstall needs no sudo; `zap` stanza present; caveats document the two genuine sudo edge-cases (root-owned leftover after rename; clone-upgrade heuristic) |
+| 3 | tap-add + trust documented | ✅ (shared runbook, orc-owned) | M1 install succeeded → tap trusted; brainbar resolves as `etanhey/layers/brainbar` |
+| 4 | venv-python everywhere | ✅ | Daemon resolves the formula venv python via `resolveHomebrewVenvPython` (PR #528) before any bare-python fallback; hooks self-resolve src via `sys.path.insert` + degrade gracefully under `except` guards (never hard-fail on bare `python3`) |
+| 5 | headless serve + daemon integrity | ✅ | **5a** canonical `/tmp/brainbar.sock`, zero stale `mcplayer-*` aliases in the bundle. **5b** `BrainBarDaemon` LaunchAgent (`RunAtLoad`/`KeepAlive`) brings the socket up headless. **5c** cask `postflight` re-bootstraps the daemon+UI LaunchAgents on reinstall (PR #525 / cask) — **M1-verified auto-bootstrap, PID assigned, no `setup --launchd` needed**. **5d** daemon is its own executable + LaunchAgent, not a GUI-app child |
+| 6 | declared deps + correct cask names + adopt | ✅ | Agent MCP is **stdio** → structurally immune to the socat 3-address footgun; fleet socket access verified **connecting** on M1 (`brain_search` 5 results, no `-32000`) |
+| 7 | read-only commands stay read-only | ⚠️ **review** | Action-verbs mutate appropriately (`reconcile-launchd`, `watch`, `wal-checkpoint`, `serve`); `health-check` is read-only. **Open:** `setup` ("create brainlayer.env…") and `init` (interactive wizard) mutate — but both are the **documented install entrypoints** (formula caveat: "Run setup after install"), not surprise-mutating inspect-verbs. Needs standard-owner ruling on whether documented-`setup`-as-install must be renamed `install`. |
+
+## Remaining work
+
+1. **§1 — `brainlayer doctor` / `doctor --fix` CLI (the one real MUST gap).**
+   The *friction* is functionally fixed and M1-verified (cask preflight heals the
+   reinstall case), but the standard prescribes a standalone non-interactive CLI:
+   detect stale Caskroom artifacts (account-agnostic), `--fix` heals without bare
+   sudo (`sudo -n` probe), root-owned → `STOP:` + distinct exit code, idempotent,
+   SHOULD scan the sibling manifest (brainbar, karabiner-elements, aldente,
+   wispr-flow, codex). The detection logic already exists in the cask preflight and
+   would be lifted into the CLI. **Scoped follow-on; the M1 already works without it.**
+
+2. **§7 — read-only ruling.** Confirm with the standard owner whether `setup`/`init`
+   may remain the documented install entrypoints or must move mutation behind an
+   explicit `install` subcommand.
+
+Everything else (§0, §2, §3, §4, §5, §6) is conformant and M1-clone-verified.

{brainlayer-1.3.0 → brainlayer-1.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "brainlayer"
-version = "1.3.0"
+version = "1.4.0"
 description = "Persistent memory MCP server for AI agents — 13 tools, semantic search, knowledge graph, on-device SQLite"
 license = {text = "Apache-2.0"}
 readme = "README.md"

{brainlayer-1.3.0 → brainlayer-1.4.0}/scripts/hotlane_brainbar_daemon.py

@@ -30,6 +30,7 @@ LOGGER = logging.getLogger("brainlayer.hotlane_brainbar")
 STOP = False
 DEFAULT_HOTLANE_ENRICH_LIMIT = 5
 DEFAULT_BACKLOG_BATCH = 4
+MAX_BACKLOG_BATCH = 16
 
 
 class CycleResult(NamedTuple):
@@ -83,6 +84,13 @@ def _queue_depth(queue_dir: Path) -> int:
         return 0
 
 
+def _high_priority_queue_depth(queue_dir: Path) -> int:
+    try:
+        return sum(1 for path in queue_dir.glob("*.jsonl") if not path.name.startswith("enrichment-"))
+    except OSError:
+        return 0
+
+
 def run_cycle(
     *,
     store: VectorStore,
@@ -143,6 +151,7 @@ def run(
     max_cycles: int | None = None,
     queue_dir: Path | None = None,
     queue_depth_fn: Callable[[Path], int] = _queue_depth,
+    high_priority_queue_depth_fn: Callable[[Path], int] = _high_priority_queue_depth,
 ) -> None:
     model = model_factory()
     embed_batch_fn = getattr(model, "embed_texts", None)
@@ -162,6 +171,7 @@ def run(
     last_enrich = 0.0
     enrich_disabled = False
     cycles = 0
+    backlog_batch = min(max(backlog_batch, 0), MAX_BACKLOG_BATCH)
     LOGGER.info("hotlane adapter started db=%s", db_path)
     while not STOP:
         if max_cycles is not None and cycles >= max_cycles:
@@ -169,14 +179,19 @@ def run(
         try:
             now = time_fn()
             queue_has_backlog = queue_depth_fn(queue_dir) > 0
+            queue_has_high_priority_backlog = queue_has_backlog and high_priority_queue_depth_fn(queue_dir) > 0
             if queue_has_backlog:
-                LOGGER.info("durable queue has backlog; yielding writer slot to drain")
+                LOGGER.info("durable queue has backlog; suppressing enrichment only")
+            if queue_has_high_priority_backlog:
+                LOGGER.info("durable high-priority queue has backlog; yielding writer slot to drain")
+                cycles += 1
+                sleep_fn(interval)
+                continue
             cycle_backlog_batch = backlog_batch if backlog_batch > 0 and now - last_backlog >= backlog_interval else 0
             cycle_enrich_limit = (
                 enrich_limit if not enrich_disabled and enrich_limit > 0 and now - last_enrich >= enrich_interval else 0
             )
             if queue_has_backlog:
-                cycle_backlog_batch = 0
                 cycle_enrich_limit = 0
             if cycle_backlog_batch > 0:
                 last_backlog = now
@@ -234,7 +249,7 @@ def main() -> None:
         interval=max(args.interval, 0.25),
         recent_limit=max(args.recent_limit, 1),
         backlog_interval=max(args.backlog_interval, 1.0),
-        backlog_batch=max(args.backlog_batch, 0),
+        backlog_batch=min(max(args.backlog_batch, 0), MAX_BACKLOG_BATCH),
         enrich_interval=max(args.enrich_interval, 1.0),
         enrich_limit=max(args.enrich_limit, 0),
         enrich_since_hours=max(args.enrich_since_hours, 0),

{brainlayer-1.3.0 → brainlayer-1.4.0}/scripts/launchd/brainlayer-env-run.sh

@@ -3,6 +3,7 @@
 set -euo pipefail
 
 ENV_FILE="${BRAINLAYER_ENV_FILE:-$HOME/.config/brainlayer/brainlayer.env}"
+export PATH="/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:$HOME/.local/bin:${PATH:-}"
 
 if [ ! -f "$ENV_FILE" ]; then
     echo "ERROR: BrainLayer env file not found at $ENV_FILE" >&2
@@ -22,10 +23,66 @@ if [ -n "$(find "$ENV_FILE" -prune -perm -0002 -print 2>/dev/null)" ]; then
     exit 78
 fi
 
-set -a
-# shellcheck disable=SC1090
-source "$ENV_FILE"
-set +a
+valid_env_key() {
+    case "$1" in
+        ""|[0-9]*|*[!A-Za-z0-9_]*)
+            return 1
+            ;;
+        *)
+            return 0
+            ;;
+    esac
+}
+
+strip_matching_quotes() {
+    local value="$1"
+    if [[ "$value" == \"*\" && "$value" == *\" ]]; then
+        printf '%s' "${value:1:${#value}-2}"
+    elif [[ "$value" == \'*\' && "$value" == *\' ]]; then
+        printf '%s' "${value:1:${#value}-2}"
+    else
+        printf '%s' "$value"
+    fi
+}
+
+load_simple_env_file() {
+    local raw_line line key value
+    while IFS= read -r raw_line || [ -n "$raw_line" ]; do
+        line="${raw_line#"${raw_line%%[![:space:]]*}"}"
+        line="${line%"${line##*[![:space:]]}"}"
+        case "$line" in
+            ""|\#*)
+                continue
+                ;;
+            export\ *)
+                line="${line#export }"
+                ;;
+        esac
+        case "$line" in
+            *=*) ;;
+            *) continue ;;
+        esac
+        key="${line%%=*}"
+        value="${line#*=}"
+        key="${key%"${key##*[![:space:]]}"}"
+        value="${value#"${value%%[![:space:]]*}"}"
+        if ! valid_env_key "$key"; then
+            continue
+        fi
+        case "$value" in
+            *'$('*|*'`'*)
+                continue
+                ;;
+        esac
+        export "$key=$(strip_matching_quotes "$value")"
+    done < "$ENV_FILE"
+}
+
+env_file_declares_google_key() {
+    grep -Eq '^[[:space:]]*(export[[:space:]]+)?GOOGLE(_GENERATIVE_AI)?_API_KEY[[:space:]]*=' "$ENV_FILE"
+}
+
+load_simple_env_file
 
 is_false() {
     case "${1:-}" in
@@ -68,7 +125,9 @@ if [ "${BRAINLAYER_SKIP_DISABLE_GATES:-0}" != "1" ]; then
     fi
 fi
 
-if [ "${BRAINLAYER_REQUIRE_GOOGLE_API_KEY:-0}" = "1" ] && [ -z "${GOOGLE_API_KEY:-${GOOGLE_GENERATIVE_AI_API_KEY:-}}" ]; then
+if [ "${BRAINLAYER_REQUIRE_GOOGLE_API_KEY:-0}" = "1" ] \
+    && [ -z "${GOOGLE_API_KEY:-${GOOGLE_GENERATIVE_AI_API_KEY:-}}" ] \
+    && ! env_file_declares_google_key; then
     echo "ERROR: GOOGLE_API_KEY not set by $ENV_FILE" >&2
     exit 78
 fi

{brainlayer-1.3.0 → brainlayer-1.4.0}/scripts/launchd/com.brainlayer.drain.plist

@@ -25,13 +25,9 @@
 		<string>__BRAINLAYER_ENV_FILE__</string>
 		<key>BRAINLAYER_LAUNCHD_SERVICE</key>
 		<string>drain</string>
-		<!-- Write chunks WITHOUT computing embeddings inside the drain's write
-		     transaction. Inline embedding lengthens the write-lock hold time and,
-		     under multi-writer contention (BrainBar/daemon/hybrid/watcher), starves
-		     the drain on SQLITE_BUSY so the realtime queue backs up. Vectors are
-		     backfilled out-of-band by enrichment/hotlane. (M1/throughput fix.) -->
-		<key>BRAINLAYER_DRAIN_EMBED</key>
-		<string>0</string>
+		<!-- Production leaves drain embedding enabled. Embeddings are precomputed
+		     before BEGIN IMMEDIATE, so vector coverage does not depend on hotlane
+		     liveness and the write-lock window stays bounded. -->
 	</dict>
 	<key>StandardOutPath</key>
 	<string>__HOME__/Library/Logs/brainlayer/drain.out.log</string>

{brainlayer-1.3.0 → brainlayer-1.4.0}/scripts/launchd/com.brainlayer.enrichment.plist

@@ -30,7 +30,9 @@
 		<key>BRAINLAYER_STALL_TIMEOUT</key>
 		<string>300</string>
 		<key>BRAINLAYER_ENRICHMENT_QUEUE_WRITES</key>
-		<string>0</string>
+		<string>1</string>
+		<key>BRAINLAYER_ENRICH_IDLE_BACKLOG</key>
+		<string>1</string>
 		<key>BRAINLAYER_ENV_FILE</key>
 		<string>__BRAINLAYER_ENV_FILE__</string>
 		<key>BRAINLAYER_REQUIRE_GOOGLE_API_KEY</key>

brainlayer-1.4.0/scripts/launchd/com.brainlayer.hotlane-brainbar.plist

@@ -0,0 +1,74 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>Label</key>
+	<string>com.brainlayer.hotlane-brainbar</string>
+	<key>ProgramArguments</key>
+	<array>
+		<string>__BRAINLAYER_ENV_RUN__</string>
+		<string>__BRAINLAYER_PYTHON__</string>
+		<string>__BRAINLAYER_DIR__/scripts/hotlane_brainbar_daemon.py</string>
+		<string>--interval</string>
+		<string>1.0</string>
+		<string>--recent-limit</string>
+		<string>5</string>
+		<string>--backlog-interval</string>
+		<string>10.0</string>
+		<string>--backlog-batch</string>
+		<string>4</string>
+		<string>--enrich-interval</string>
+		<string>10.0</string>
+		<string>--enrich-limit</string>
+		<string>5</string>
+		<string>--enrich-since-hours</string>
+		<string>87600</string>
+	</array>
+	<key>WorkingDirectory</key>
+	<string>__BRAINLAYER_DIR__</string>
+	<key>KeepAlive</key>
+	<true/>
+	<key>StandardOutPath</key>
+	<string>__HOME__/Library/Logs/brainlayer/hotlane-brainbar.out.log</string>
+	<key>StandardErrorPath</key>
+	<string>__HOME__/Library/Logs/brainlayer/hotlane-brainbar.err.log</string>
+	<key>EnvironmentVariables</key>
+	<dict>
+		<key>PATH</key>
+		<string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:__HOME__/.local/bin</string>
+		<key>PYTHONUNBUFFERED</key>
+		<string>1</string>
+		<key>BRAINLAYER_ENV_FILE</key>
+		<string>__BRAINLAYER_ENV_FILE__</string>
+		<key>BRAINLAYER_REQUIRE_GOOGLE_API_KEY</key>
+		<string>1</string>
+		<key>BRAINLAYER_REPO_ROOT</key>
+		<string>__BRAINLAYER_DIR__</string>
+		<key>BRAINLAYER_GEMINI_SERVICE_TIER</key>
+		<string>flex</string>
+		<key>BRAINLAYER_ENRICH_CONCURRENCY</key>
+		<string>4</string>
+		<key>BRAINLAYER_ENRICH_RATE</key>
+		<string>15</string>
+		<key>BRAINLAYER_LAUNCHD_SERVICE</key>
+		<string>hotlane-brainbar</string>
+	</dict>
+	<key>RunAtLoad</key>
+	<true/>
+	<key>ThrottleInterval</key>
+	<integer>5</integer>
+	<key>Nice</key>
+	<integer>10</integer>
+	<key>ProcessType</key>
+	<string>Background</string>
+	<key>ExitTimeOut</key>
+	<integer>30</integer>
+	<key>LowPriorityIO</key>
+	<true/>
+	<key>SoftResourceLimits</key>
+	<dict>
+		<key>NumberOfFiles</key>
+		<integer>4096</integer>
+	</dict>
+</dict>
+</plist>

{brainlayer-1.3.0 → brainlayer-1.4.0}/scripts/launchd/install.sh

@@ -16,6 +16,7 @@
 #   ./scripts/launchd/install.sh jsonl-backup # Install daily JSONL backup only
 #   ./scripts/launchd/install.sh maintenance  # Install recurring maintenance jobs
 #   ./scripts/launchd/install.sh health-check # Install stability health check only
+#   ./scripts/launchd/install.sh hotlane      # Install BrainBar hotlane embed/enrich daemon only
 #   ./scripts/launchd/install.sh remove       # Unload and remove all
 set -euo pipefail
 
@@ -255,6 +256,10 @@ case "${1:-all}" in
     health-check)
         install_plist health-check
         ;;
+    hotlane|hotlane-brainbar)
+        verify_gemini_env_file
+        install_plist hotlane-brainbar
+        ;;
     all)
         install_env_runner
         verify_config_file
@@ -262,6 +267,7 @@ case "${1:-all}" in
         install_plist index
         install_plist drain
         install_plist watch
+        install_plist hotlane-brainbar
         install_plist enrichment
         install_plist decay
         install_plist wal-checkpoint
@@ -290,11 +296,12 @@ case "${1:-all}" in
         remove_plist maintenance-nightly 2>/dev/null || true
         remove_plist maintenance-weekly 2>/dev/null || true
         remove_plist health-check 2>/dev/null || true
+        remove_plist hotlane-brainbar 2>/dev/null || true
         rm -f "$BRAINLAYER_LIB_DIR/backup-daily.sh"
         rm -f "$BRAINLAYER_LIB_DIR/jsonl-backup.sh"
         ;;
     *)
-        echo "Usage: $0 [index|watch|enrich|enrichment|decay|drain|repair-fts|load [name]|unload [name]|checkpoint|backup|jsonl-backup|maintenance|maintenance-nightly|maintenance-weekly|health-check|all|remove]"
+        echo "Usage: $0 [index|watch|enrich|enrichment|decay|drain|hotlane|repair-fts|load [name]|unload [name]|checkpoint|backup|jsonl-backup|maintenance|maintenance-nightly|maintenance-weekly|health-check|all|remove]"
         exit 1
         ;;
 esac