brainlayer 1.4.2__tar.gz → 1.4.4__tar.gz

{brainlayer-1.4.2 → brainlayer-1.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: brainlayer
-Version: 1.4.2
+Version: 1.4.4
 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
@@ -54,6 +54,7 @@ Requires-Dist: pytest>=7.0.0; extra == 'dev'
 Requires-Dist: ruff>=0.1.0; extra == 'dev'
 Requires-Dist: scikit-learn<1.6; extra == 'dev'
 Requires-Dist: setuptools<81,>=70.0.0; extra == 'dev'
+Requires-Dist: tiktoken>=0.7.0; extra == 'dev'
 Requires-Dist: umap-learn>=0.5.0; extra == 'dev'
 Provides-Extra: docs
 Requires-Dist: mkdocs-material>=9.5.0; extra == 'docs'
@@ -80,9 +81,9 @@ Description-Content-Type: text/markdown
 [![Tests](https://img.shields.io/badge/tests-1%2C848%20Python%20%2B%2054%20Swift-brightgreen.svg)](#testing)
 [![Website](https://img.shields.io/badge/site-brainlayer.etanheyman.com-d4956a.svg)](https://brainlayer.etanheyman.com)
 
-Every architecture decision, every debugging session, every preference you've expressed — **gone between sessions.** You repeat yourself constantly. Your agent rediscovers bugs it already fixed.
+Every architecture decision, every debugging session, every preference you've expressed — **gone between sessions.** You repeat yourself constantly. Your agents rediscover bugs they already fixed, and re-make choices the team already reasoned through.
 
-BrainLayer gives any MCP-compatible AI agent persistent memory across conversations. One SQLite file. No cloud. No Docker. Just `pip install`.
+BrainLayer gives any MCP-compatible AI agent persistent memory across conversations — and gives a whole **fleet** of agents a shared organizational memory: what one agent learns (a fix, a decision, what eroded and why) becomes experience the others inherit before they repeat the mistake. One SQLite file. No cloud. No Docker. Just `pip install`.
 
 ```text
 "What approach did I use for auth last month?"     →  brain_search

{brainlayer-1.4.2 → brainlayer-1.4.4}/README.md

@@ -9,9 +9,9 @@
 [![Tests](https://img.shields.io/badge/tests-1%2C848%20Python%20%2B%2054%20Swift-brightgreen.svg)](#testing)
 [![Website](https://img.shields.io/badge/site-brainlayer.etanheyman.com-d4956a.svg)](https://brainlayer.etanheyman.com)
 
-Every architecture decision, every debugging session, every preference you've expressed — **gone between sessions.** You repeat yourself constantly. Your agent rediscovers bugs it already fixed.
+Every architecture decision, every debugging session, every preference you've expressed — **gone between sessions.** You repeat yourself constantly. Your agents rediscover bugs they already fixed, and re-make choices the team already reasoned through.
 
-BrainLayer gives any MCP-compatible AI agent persistent memory across conversations. One SQLite file. No cloud. No Docker. Just `pip install`.
+BrainLayer gives any MCP-compatible AI agent persistent memory across conversations — and gives a whole **fleet** of agents a shared organizational memory: what one agent learns (a fix, a decision, what eroded and why) becomes experience the others inherit before they repeat the mistake. One SQLite file. No cloud. No Docker. Just `pip install`.
 
 ```text
 "What approach did I use for auth last month?"     →  brain_search

{brainlayer-1.4.2 → brainlayer-1.4.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "brainlayer"
-version = "1.4.2"
+version = "1.4.4"
 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"
@@ -82,6 +82,7 @@ dev = [
     "ruff>=0.1.0",
     "scikit-learn<1.6",
     "setuptools>=70.0.0,<81",
+    "tiktoken>=0.7.0",
     "umap-learn>=0.5.0",
 ]
 docs = [
@@ -124,15 +125,19 @@ markers = [
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/brainlayer"]
-force-include = {"scripts/launchd" = "brainlayer/launchd"}
 exclude = [
     "src/brainlayer/dashboard",
 ]
 
+[tool.hatch.build.targets.wheel.force-include]
+"scripts/launchd" = "brainlayer/launchd"
+"scripts/tier0-watchdog.sh" = "brainlayer/launchd/tier0-watchdog.sh"
+
 [tool.hatch.build.targets.sdist]
 only-include = [
     "src/brainlayer",
     "scripts/launchd",
+    "scripts/tier0-watchdog.sh",
     "README.md",
     "LICENSE",
     "server.json",

{brainlayer-1.4.2 → brainlayer-1.4.4}/scripts/launchd/com.brainlayer.drain.plist

@@ -7,9 +7,11 @@
 	<key>ProgramArguments</key>
 	<array>
 		<string>__BRAINLAYER_ENV_RUN__</string>
-		<string>__PYTHON_BIN__</string>
-		<string>-m</string>
-		<string>brainlayer.drain</string>
+		<string>/usr/bin/env</string>
+		<string>BRAINLAYER_DRAIN_EMBED=0</string>
+		<string>__BRAINLAYER_BIN__</string>
+		<string>drain</string>
+		<string>--daemon</string>
 		<string>--batch-size</string>
 		<string>50</string>
 	</array>
@@ -25,9 +27,6 @@
 		<string>__BRAINLAYER_ENV_FILE__</string>
 		<key>BRAINLAYER_LAUNCHD_SERVICE</key>
 		<string>drain</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.4.4/scripts/launchd/com.brainlayer.p0-counter.plist

@@ -0,0 +1,49 @@
+<?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.p0-counter</string>
+	<key>ProgramArguments</key>
+	<array>
+		<string>__BRAINLAYER_ENV_RUN__</string>
+		<string>__BRAINLAYER_BIN__</string>
+		<string>p0-counter</string>
+	</array>
+	<key>EnvironmentVariables</key>
+	<dict>
+		<key>PATH</key>
+		<string>/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:__HOME__/.local/bin</string>
+		<key>PYTHONUNBUFFERED</key>
+		<string>1</string>
+		<key>BRAINLAYER_REPO_ROOT</key>
+		<string>__BRAINLAYER_DIR__</string>
+		<key>BRAINLAYER_ENV_FILE</key>
+		<string>__BRAINLAYER_ENV_FILE__</string>
+		<key>BRAINLAYER_LAUNCHD_SERVICE</key>
+		<string>p0-counter</string>
+	</dict>
+	<key>StandardOutPath</key>
+	<string>__HOME__/Library/Logs/brainlayer/p0-counter.out.log</string>
+	<key>StandardErrorPath</key>
+	<string>__HOME__/Library/Logs/brainlayer/p0-counter.err.log</string>
+	<key>StartCalendarInterval</key>
+	<dict>
+		<key>Hour</key>
+		<integer>5</integer>
+		<key>Minute</key>
+		<integer>0</integer>
+	</dict>
+	<key>ProcessType</key>
+	<string>Background</string>
+	<key>ExitTimeOut</key>
+	<integer>60</integer>
+	<key>LowPriorityIO</key>
+	<true/>
+	<key>SoftResourceLimits</key>
+	<dict>
+		<key>NumberOfFiles</key>
+		<integer>4096</integer>
+	</dict>
+</dict>
+</plist>

brainlayer-1.4.4/scripts/launchd/com.brainlayer.throughput-watchdog.plist

@@ -0,0 +1,47 @@
+<?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.throughput-watchdog</string>
+	<key>ProgramArguments</key>
+	<array>
+		<string>__BRAINLAYER_ENV_RUN__</string>
+		<string>__PYTHON_BIN__</string>
+		<string>__THROUGHPUT_WATCHDOG_SCRIPT__</string>
+		<string>--json</string>
+	</array>
+	<key>EnvironmentVariables</key>
+	<dict>
+		<key>HOME</key>
+		<string>__HOME__</string>
+		<key>BRAINLAYER_ENV_FILE</key>
+		<string>__BRAINLAYER_ENV_FILE__</string>
+		<key>BRAINLAYER_LAUNCHD_SERVICE</key>
+		<string>watch</string>
+		<key>PATH</key>
+		<string>/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
+	</dict>
+	<key>RunAtLoad</key>
+	<true/>
+	<key>StartInterval</key>
+	<integer>60</integer>
+	<key>ProcessType</key>
+	<string>Background</string>
+	<key>Nice</key>
+	<integer>10</integer>
+	<key>LowPriorityIO</key>
+	<true/>
+	<key>ExitTimeOut</key>
+	<integer>30</integer>
+	<key>SoftResourceLimits</key>
+	<dict>
+		<key>NumberOfFiles</key>
+		<integer>4096</integer>
+	</dict>
+	<key>StandardOutPath</key>
+	<string>__HOME__/Library/Logs/brainlayer/throughput-watchdog.out.log</string>
+	<key>StandardErrorPath</key>
+	<string>__HOME__/Library/Logs/brainlayer/throughput-watchdog.err.log</string>
+</dict>
+</plist>

brainlayer-1.4.4/scripts/launchd/com.brainlayer.tier0-watchdog.plist

@@ -0,0 +1,45 @@
+<?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.tier0-watchdog</string>
+	<key>ProgramArguments</key>
+	<array>
+		<string>/bin/sh</string>
+		<string>__TIER0_WATCHDOG_SCRIPT__</string>
+	</array>
+	<key>EnvironmentVariables</key>
+	<dict>
+		<key>HOME</key>
+		<string>__HOME__</string>
+		<key>PATH</key>
+		<string>/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
+		<key>TIER0_ALERT_STATE_PATH</key>
+		<string>__HOME__/.local/share/brainlayer/tier0-watchdog-alert-state</string>
+		<key>TIER0_REPEAT_ALERT_SECONDS</key>
+		<string>1800</string>
+		<key>TIER0_STALE_SECONDS</key>
+		<string>900</string>
+	</dict>
+	<key>StandardOutPath</key>
+	<string>__HOME__/Library/Logs/brainlayer/tier0-watchdog.out.log</string>
+	<key>StandardErrorPath</key>
+	<string>__HOME__/Library/Logs/brainlayer/tier0-watchdog.err.log</string>
+	<key>StartInterval</key>
+	<integer>300</integer>
+	<key>RunAtLoad</key>
+	<true/>
+	<key>Nice</key>
+	<integer>10</integer>
+	<key>ProcessType</key>
+	<string>Background</string>
+	<key>ExitTimeOut</key>
+	<integer>15</integer>
+	<key>SoftResourceLimits</key>
+	<dict>
+		<key>NumberOfFiles</key>
+		<integer>4096</integer>
+	</dict>
+</dict>
+</plist>

{brainlayer-1.4.2 → brainlayer-1.4.4}/scripts/launchd/install.sh

@@ -16,7 +16,10 @@
 #   ./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 tier0-watchdog # Install /bin/sh meta-watchdog only
+#   ./scripts/launchd/install.sh throughput-watchdog # Install watcher throughput watchdog only
 #   ./scripts/launchd/install.sh hotlane      # Install BrainBar hotlane embed/enrich daemon only
+#   ./scripts/launchd/install.sh p0-counter   # Install daily P0 longitudinal counter only
 #   ./scripts/launchd/install.sh remove       # Unload and remove all
 set -euo pipefail
 
@@ -61,6 +64,8 @@ PYTHON_BIN="$(stable_brainlayer_path "${PYTHON_BIN:-$(command -v python3)}")"
 BRAINLAYER_PYTHON="$(stable_brainlayer_path "${BRAINLAYER_PYTHON:-$PYTHON_BIN}")"
 BRAINLAYER_ENV_FILE="${BRAINLAYER_ENV_FILE:-$HOME/.config/brainlayer/brainlayer.env}"
 BRAINLAYER_ENV_RUN="$BRAINLAYER_LIB_DIR/brainlayer-env-run.sh"
+TIER0_WATCHDOG_DST="$BRAINLAYER_LIB_DIR/tier0-watchdog.sh"
+THROUGHPUT_WATCHDOG_DST="$BRAINLAYER_LIB_DIR/throughput-watchdog.py"
 
 if [ -z "$PYTHON_BIN" ]; then
     echo "ERROR: python3 not found in PATH"
@@ -265,6 +270,104 @@ install_jsonl_backup_script() {
     echo "Installed: $dst"
 }
 
+install_tier0_watchdog() {
+    local script_src="$SCRIPT_DIR/tier0-watchdog.sh"
+    local plist_src="$SCRIPT_DIR/com.brainlayer.tier0-watchdog.plist"
+    local plist_dst="$LAUNCH_DIR/com.brainlayer.tier0-watchdog.plist"
+    local escaped_home
+    local escaped_tier0_watchdog_dst
+
+    if [ ! -f "$script_src" ]; then
+        script_src="$SCRIPT_DIR/../tier0-watchdog.sh"
+    fi
+    if [ ! -f "$script_src" ]; then
+        echo "ERROR: tier0-watchdog.sh not found beside or above $SCRIPT_DIR"
+        return 1
+    fi
+    if [ ! -f "$plist_src" ]; then
+        echo "ERROR: $plist_src not found"
+        return 1
+    fi
+
+    escaped_home="$(
+        printf '%s' "$HOME" \
+            | sed -e 's/&/\&amp;/g' -e 's/</\&lt;/g' -e 's/>/\&gt;/g' -e 's/[\\&|]/\\&/g'
+    )" || return 1
+    escaped_tier0_watchdog_dst="$(
+        printf '%s' "$TIER0_WATCHDOG_DST" \
+            | sed -e 's/&/\&amp;/g' -e 's/</\&lt;/g' -e 's/>/\&gt;/g' -e 's/[\\&|]/\\&/g'
+    )" || return 1
+
+    install -m 0755 "$script_src" "$TIER0_WATCHDOG_DST" || return 1
+    sed \
+        -e "s|__HOME__|$escaped_home|g" \
+        -e "s|__TIER0_WATCHDOG_SCRIPT__|$escaped_tier0_watchdog_dst|g" \
+        "$plist_src" > "$plist_dst" || return 1
+
+    echo "Installed: $TIER0_WATCHDOG_DST"
+    echo "Installed: $plist_dst"
+    echo "  Logs: $LOG_DIR/ and $BRAINLAYER_LOG_DIR/"
+    load_plist tier0-watchdog
+}
+
+install_throughput_watchdog() {
+    local script_src="$SCRIPT_DIR/throughput-watchdog.py"
+    local plist_src="$SCRIPT_DIR/com.brainlayer.throughput-watchdog.plist"
+    local plist_dst="$LAUNCH_DIR/com.brainlayer.throughput-watchdog.plist"
+    local escaped_env_file
+    local escaped_env_run
+    local escaped_home
+    local escaped_python_bin
+    local escaped_watchdog_dst
+
+    if [ ! -f "$script_src" ]; then
+        echo "ERROR: throughput-watchdog.py not found in $SCRIPT_DIR"
+        return 1
+    fi
+    if [ ! -f "$plist_src" ]; then
+        echo "ERROR: $plist_src not found"
+        return 1
+    fi
+
+    install_env_runner || return 1
+    verify_config_file || return 1
+
+    escaped_home="$(
+        printf '%s' "$HOME" \
+            | sed -e 's/&/\&amp;/g' -e 's/</\&lt;/g' -e 's/>/\&gt;/g' -e 's/[\\&|]/\\&/g'
+    )" || return 1
+    escaped_env_file="$(
+        printf '%s' "$BRAINLAYER_ENV_FILE" \
+            | sed -e 's/&/\&amp;/g' -e 's/</\&lt;/g' -e 's/>/\&gt;/g' -e 's/[\\&|]/\\&/g'
+    )" || return 1
+    escaped_env_run="$(
+        printf '%s' "$BRAINLAYER_ENV_RUN" \
+            | sed -e 's/&/\&amp;/g' -e 's/</\&lt;/g' -e 's/>/\&gt;/g' -e 's/[\\&|]/\\&/g'
+    )" || return 1
+    escaped_watchdog_dst="$(
+        printf '%s' "$THROUGHPUT_WATCHDOG_DST" \
+            | sed -e 's/&/\&amp;/g' -e 's/</\&lt;/g' -e 's/>/\&gt;/g' -e 's/[\\&|]/\\&/g'
+    )" || return 1
+    escaped_python_bin="$(
+        printf '%s' "$PYTHON_BIN" \
+            | sed -e 's/&/\&amp;/g' -e 's/</\&lt;/g' -e 's/>/\&gt;/g' -e 's/[\\&|]/\\&/g'
+    )" || return 1
+
+    install -m 0755 "$script_src" "$THROUGHPUT_WATCHDOG_DST" || return 1
+    sed \
+        -e "s|__HOME__|$escaped_home|g" \
+        -e "s|__BRAINLAYER_ENV_FILE__|$escaped_env_file|g" \
+        -e "s|__BRAINLAYER_ENV_RUN__|$escaped_env_run|g" \
+        -e "s|__PYTHON_BIN__|$escaped_python_bin|g" \
+        -e "s|__THROUGHPUT_WATCHDOG_SCRIPT__|$escaped_watchdog_dst|g" \
+        "$plist_src" > "$plist_dst" || return 1
+
+    echo "Installed: $THROUGHPUT_WATCHDOG_DST"
+    echo "Installed: $plist_dst"
+    echo "  Logs: $LOG_DIR/ and $BRAINLAYER_LOG_DIR/"
+    load_plist throughput-watchdog
+}
+
 remove_plist() {
     local name="$1"
     local dst="$LAUNCH_DIR/com.brainlayer.${name}.plist"
@@ -326,10 +429,19 @@ case "${1:-all}" in
     health-check)
         install_plist health-check
         ;;
+    tier0|tier0-watchdog)
+        install_tier0_watchdog
+        ;;
+    throughput-watchdog)
+        install_throughput_watchdog
+        ;;
     hotlane|hotlane-brainbar)
         verify_gemini_env_file
         install_plist hotlane-brainbar
         ;;
+    p0-counter)
+        install_plist p0-counter
+        ;;
     all)
         install_env_runner
         verify_config_file
@@ -357,7 +469,13 @@ case "${1:-all}" in
         elif ! install_many jsonl-backup; then
             failures=1
         fi
-        if ! install_many maintenance-nightly maintenance-weekly health-check; then
+        if ! install_many maintenance-nightly maintenance-weekly health-check p0-counter; then
+            failures=1
+        fi
+        if ! install_tier0_watchdog; then
+            failures=1
+        fi
+        if ! install_throughput_watchdog; then
             failures=1
         fi
         # Remove old enrich plist only after the replacement enrichment service loads.
@@ -382,12 +500,17 @@ 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 tier0-watchdog 2>/dev/null || true
+        remove_plist throughput-watchdog 2>/dev/null || true
         remove_plist hotlane-brainbar 2>/dev/null || true
+        remove_plist p0-counter 2>/dev/null || true
         rm -f "$BRAINLAYER_LIB_DIR/backup-daily.sh"
         rm -f "$BRAINLAYER_LIB_DIR/jsonl-backup.sh"
+        rm -f "$TIER0_WATCHDOG_DST"
+        rm -f "$THROUGHPUT_WATCHDOG_DST"
         ;;
     *)
-        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]"
+        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|tier0-watchdog|throughput-watchdog|p0-counter|all|remove]"
         exit 1
         ;;
 esac