brainlayer 1.4.0__tar.gz → 1.4.2__tar.gz

{brainlayer-1.4.0 → brainlayer-1.4.2}/.gitignore

@@ -29,6 +29,9 @@ htmlcov/
 *.db-wal
 *.db-shm
 data/
+!src/brainlayer/data/
+!src/brainlayer/data/sandbox_seeds/
+!src/brainlayer/data/sandbox_seeds/*.json
 
 # Secrets
 .env

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: brainlayer
-Version: 1.4.0
+Version: 1.4.2
 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.4.0 → brainlayer-1.4.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "brainlayer"
-version = "1.4.0"
+version = "1.4.2"
 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"
@@ -97,6 +97,7 @@ Issues = "https://github.com/EtanHey/brainlayer/issues"
 [project.scripts]
 brainlayer = "brainlayer.cli:app"
 brainlayer-mcp = "brainlayer.mcp:serve"
+brainlayer-mcp-stdio-bridge = "brainlayer.mcp_stdio_bridge:main"
 
 [build-system]
 requires = ["hatchling"]
@@ -129,6 +130,15 @@ exclude = [
 ]
 
 [tool.hatch.build.targets.sdist]
+only-include = [
+    "src/brainlayer",
+    "scripts/launchd",
+    "README.md",
+    "LICENSE",
+    "server.json",
+]
 exclude = [
+    "docs.local/**",
+    "brain-bar/docs.local/**",
     "src/brainlayer/dashboard/**",
 ]

{brainlayer-1.4.0 → brainlayer-1.4.2}/scripts/launchd/com.brainlayer.hotlane-brainbar.plist

@@ -20,7 +20,7 @@
 		<string>--enrich-interval</string>
 		<string>10.0</string>
 		<string>--enrich-limit</string>
-		<string>5</string>
+		<string>0</string>
 		<string>--enrich-since-hours</string>
 		<string>87600</string>
 	</array>

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

@@ -21,15 +21,44 @@
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+stable_brainlayer_path() {
+    local value="${1:-}"
+    local prefix
+    local after_cellar
+    local after_version
+
+    if [ -z "$value" ]; then
+        printf "%s" "$value"
+        return 0
+    fi
+
+    case "$value" in
+        */Cellar/brainlayer/*)
+            prefix="${value%%/Cellar/brainlayer/*}"
+            after_cellar="${value#*/Cellar/brainlayer/}"
+            after_version="${after_cellar#*/}"
+            if [ "$after_version" = "$after_cellar" ]; then
+                printf "%s/opt/brainlayer" "$prefix"
+            else
+                printf "%s/opt/brainlayer/%s" "$prefix" "$after_version"
+            fi
+            ;;
+        *)
+            printf "%s" "$value"
+            ;;
+    esac
+}
+
 LAUNCH_DIR="$HOME/Library/LaunchAgents"
 LOG_DIR="$HOME/Library/Logs"
 BRAINLAYER_LOG_DIR="$HOME/.local/share/brainlayer/logs"
 BRAINLAYER_LIB_DIR="$HOME/.local/lib/brainlayer"
-BRAINLAYER_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
-BRAINLAYER_LAUNCHD_DIR="${BRAINLAYER_LAUNCHD_DIR:-$SCRIPT_DIR}"
-BRAINLAYER_BIN="${BRAINLAYER_BIN:-$(which brainlayer 2>/dev/null || echo "$HOME/.local/bin/brainlayer")}"
-PYTHON_BIN="${PYTHON_BIN:-$(command -v python3)}"
-BRAINLAYER_PYTHON="${BRAINLAYER_PYTHON:-$PYTHON_BIN}"
+BRAINLAYER_DIR="$(stable_brainlayer_path "$(cd "$SCRIPT_DIR/../.." && pwd)")"
+BRAINLAYER_LAUNCHD_DIR="$(stable_brainlayer_path "${BRAINLAYER_LAUNCHD_DIR:-$SCRIPT_DIR}")"
+BRAINLAYER_BIN="$(stable_brainlayer_path "${BRAINLAYER_BIN:-$(which brainlayer 2>/dev/null || echo "$HOME/.local/bin/brainlayer")}")"
+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"
 
@@ -57,7 +86,7 @@ install_env_runner() {
         return 1
     fi
 
-    install -m 0755 "$src" "$BRAINLAYER_ENV_RUN"
+    install -m 0755 "$src" "$BRAINLAYER_ENV_RUN" || return 1
     echo "Installed: $BRAINLAYER_ENV_RUN"
 }
 
@@ -108,10 +137,33 @@ load_plist() {
     local name="$1"
     local dst="$LAUNCH_DIR/com.brainlayer.${name}.plist"
     local label="com.brainlayer.${name}"
-    launchctl enable "gui/$UID/$label"
+    local enable_error=""
+    local retry_enable_after_bootstrap=0
     launchctl bootout "gui/$UID/$label" 2>/dev/null || true
-    launchctl bootstrap "gui/$UID" "$dst"
-    launchctl print "gui/$UID/$label" >/dev/null
+    if ! enable_error="$(launchctl enable "gui/$UID/$label" 2>&1)"; then
+        if printf "%s" "$enable_error" | grep -qi "could not find service"; then
+            echo "WARN: launchctl enable could not find $label before bootstrap; retrying after bootstrap" >&2
+            retry_enable_after_bootstrap=1
+        else
+            printf "%s\n" "$enable_error" >&2
+            echo "ERROR: launchctl enable failed for $label" >&2
+            return 1
+        fi
+    fi
+    if ! launchctl bootstrap "gui/$UID" "$dst"; then
+        echo "ERROR: launchctl bootstrap failed for $label" >&2
+        return 1
+    fi
+    if [ "$retry_enable_after_bootstrap" -ne 0 ]; then
+        if ! launchctl enable "gui/$UID/$label"; then
+            echo "ERROR: launchctl enable failed for $label after bootstrap" >&2
+            return 1
+        fi
+    fi
+    if ! launchctl print "gui/$UID/$label" >/dev/null; then
+        echo "ERROR: launchctl print failed for $label after bootstrap" >&2
+        return 1
+    fi
     echo "  Loaded: com.brainlayer.${name}"
 }
 
@@ -132,11 +184,11 @@ install_plist() {
         return 1
     fi
 
-    install_env_runner
-    verify_config_file
+    install_env_runner || return 1
+    verify_config_file || return 1
 
     if [ "$name" = "enrichment" ] || [ "$name" = "enrich" ]; then
-        verify_gemini_env_file
+        verify_gemini_env_file || return 1
     fi
 
     # Replace placeholders
@@ -150,12 +202,31 @@ install_plist() {
         -e "s|__REPO_ROOT__|$BRAINLAYER_DIR|g" \
         -e "s|__BRAINLAYER_ENV_FILE__|$BRAINLAYER_ENV_FILE|g" \
         -e "s|__BRAINLAYER_ENV_RUN__|$BRAINLAYER_ENV_RUN|g" \
-        "$src" > "$dst"
+        "$src" > "$dst" || return 1
 
     echo "Installed: $dst"
     echo "  Logs: $LOG_DIR/ and $BRAINLAYER_LOG_DIR/"
 
-    load_plist "$name"
+    if ! load_plist "$name"; then
+        return 1
+    fi
+}
+
+install_many() {
+    local failures=0
+    local name
+
+    for name in "$@"; do
+        if ! install_plist "$name"; then
+            echo "ERROR: failed to install/load com.brainlayer.${name}" >&2
+            failures=$((failures + 1))
+        fi
+    done
+
+    if [ "$failures" -ne 0 ]; then
+        echo "ERROR: failed to install/load $failures launchd service(s)" >&2
+        return 1
+    fi
 }
 
 install_backup_script() {
@@ -168,11 +239,11 @@ install_backup_script() {
         return 1
     fi
 
-    escaped_brainlayer_dir="$(printf '%s' "$BRAINLAYER_DIR" | sed 's/[\\&|]/\\&/g')"
+    escaped_brainlayer_dir="$(printf '%s' "$BRAINLAYER_DIR" | sed 's/[\\&|]/\\&/g')" || return 1
     sed \
         -e "s|__BRAINLAYER_DIR_VALUE__|$escaped_brainlayer_dir|g" \
-        "$src" > "$dst"
-    chmod 755 "$dst"
+        "$src" > "$dst" || return 1
+    chmod 755 "$dst" || return 1
     echo "Installed: $dst"
 }
 
@@ -186,11 +257,11 @@ install_jsonl_backup_script() {
         return 1
     fi
 
-    escaped_brainlayer_dir="$(printf '%s' "$BRAINLAYER_DIR" | sed 's/[\\&|]/\\&/g')"
+    escaped_brainlayer_dir="$(printf '%s' "$BRAINLAYER_DIR" | sed 's/[\\&|]/\\&/g')" || return 1
     sed \
         -e "s|__BRAINLAYER_DIR_VALUE__|$escaped_brainlayer_dir|g" \
-        "$src" > "$dst"
-    chmod 755 "$dst"
+        "$src" > "$dst" || return 1
+    chmod 755 "$dst" || return 1
     echo "Installed: $dst"
 }
 
@@ -250,8 +321,7 @@ case "${1:-all}" in
         install_plist maintenance-weekly
         ;;
     maintenance)
-        install_plist maintenance-nightly
-        install_plist maintenance-weekly
+        install_many maintenance-nightly maintenance-weekly
         ;;
     health-check)
         install_plist health-check
@@ -264,23 +334,39 @@ case "${1:-all}" in
         install_env_runner
         verify_config_file
         verify_gemini_env_file
-        install_plist index
-        install_plist drain
-        install_plist watch
-        install_plist hotlane-brainbar
-        install_plist enrichment
-        install_plist decay
-        install_plist wal-checkpoint
-        install_plist repair-fts
-        install_backup_script
-        install_plist backup-daily
-        install_jsonl_backup_script
-        install_plist jsonl-backup
-        install_plist maintenance-nightly
-        install_plist maintenance-weekly
-        install_plist health-check
-        # Remove old enrich plist if present
-        remove_plist enrich 2>/dev/null || true
+        failures=0
+        enrichment_ok=0
+        if ! install_many index drain watch hotlane-brainbar; then
+            failures=1
+        fi
+        if install_plist enrichment; then
+            enrichment_ok=1
+        else
+            failures=1
+        fi
+        if ! install_many decay wal-checkpoint repair-fts; then
+            failures=1
+        fi
+        if ! install_backup_script; then
+            failures=1
+        elif ! install_many backup-daily; then
+            failures=1
+        fi
+        if ! install_jsonl_backup_script; then
+            failures=1
+        elif ! install_many jsonl-backup; then
+            failures=1
+        fi
+        if ! install_many maintenance-nightly maintenance-weekly health-check; then
+            failures=1
+        fi
+        # Remove old enrich plist only after the replacement enrichment service loads.
+        if [ "$enrichment_ok" -eq 1 ]; then
+            remove_plist enrich 2>/dev/null || true
+        fi
+        if [ "$failures" -ne 0 ]; then
+            exit 1
+        fi
         ;;
     remove)
         remove_plist index

{brainlayer-1.4.0 → brainlayer-1.4.2}/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.etanhey/brainlayer",
   "title": "BrainLayer",
   "description": "Persistent memory for AI agents — local-first semantic search, knowledge graph, and 12 MCP tools with ToolAnnotations. One SQLite file, no cloud, no API keys.",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "websiteUrl": "https://brainlayer.etanheyman.com",
   "repository": {
     "url": "https://github.com/EtanHey/brainlayer",
@@ -14,7 +14,7 @@
       "registryType": "pypi",
       "registryBaseUrl": "https://pypi.org",
       "identifier": "brainlayer",
-      "version": "1.4.0",
+      "version": "1.4.2",
       "runtimeHint": "pipx",
       "transport": {
         "type": "stdio"

{brainlayer-1.4.0 → brainlayer-1.4.2}/src/brainlayer/__init__.py

@@ -1,3 +1,3 @@
 """BrainLayer (זיכרון) - Local knowledge pipeline for Claude Code conversations."""
 
-__version__ = "1.4.0"
+__version__ = "1.4.2"

brainlayer-1.4.2/src/brainlayer/alarm.py

@@ -0,0 +1,115 @@
+"""Loud persistent alarms for never-silent degradation paths."""
+
+from __future__ import annotations
+
+import json
+import logging
+import sys
+import threading
+from typing import Any, NoReturn
+
+logger = logging.getLogger(__name__)
+
+ALARM_DATASET = "brainlayer-alarms"
+_TELEMETRY_JOIN_TIMEOUT_S = 0.05
+
+
+class BrainLayerAlarm(BaseException):
+    """Alarm that bypasses broad ``except Exception`` handlers."""
+
+    def __init__(
+        self,
+        code: str,
+        message: str,
+        context: dict[str, Any] | None = None,
+        *,
+        severity: str = "fatal",
+        exit_code: int = 1,
+    ) -> None:
+        super().__init__(f"{code}: {message}")
+        self.code = code
+        self.message = message
+        self.context = dict(context or {})
+        self.severity = severity
+        self.exit_code = exit_code
+
+    @property
+    def details(self) -> dict[str, Any]:
+        return self.context
+
+    def to_event(self) -> dict[str, Any]:
+        return {
+            "_type": "alarm",
+            "code": self.code,
+            "severity": self.severity,
+            "message": self.message,
+            "context": self.context,
+            "exit_code": self.exit_code,
+        }
+
+    def human_message(self) -> str:
+        context = ""
+        if self.context:
+            context = f" context={json.dumps(self.context, sort_keys=True, default=str)}"
+        return f"BRAINLAYER_ALARM {self.code}: {self.message}{context}"
+
+
+def build_alarm(
+    code: str,
+    message: str,
+    context: dict[str, Any] | None = None,
+    *,
+    severity: str = "fatal",
+    exit_code: int = 1,
+) -> BrainLayerAlarm:
+    return BrainLayerAlarm(code, message, context, severity=severity, exit_code=exit_code)
+
+
+def emit_alarm(alarm: BrainLayerAlarm) -> bool:
+    """Emit local loud alarm output and best-effort non-blocking telemetry.
+
+    stderr/logging are the guaranteed fatal alarm paths. Axiom telemetry stays
+    off the caller thread so a stalled network path cannot delay the alarm raise.
+    """
+    human_message = alarm.human_message()
+    logger.critical(human_message)
+    try:
+        print(human_message, file=sys.stderr, flush=True)
+    except Exception as exc:
+        logger.debug("Alarm stderr emit failed: %s", exc)
+
+    result: dict[str, bool] = {"ok": False}
+    event = alarm.to_event()
+
+    def emit_telemetry() -> None:
+        try:
+            from .telemetry import emit
+
+            result["ok"] = emit(ALARM_DATASET, event)
+        except Exception as exc:
+            logger.debug("Alarm telemetry emit failed: %s", exc)
+
+    try:
+        thread = threading.Thread(target=emit_telemetry, name=f"brainlayer-alarm-{alarm.code}", daemon=True)
+        thread.start()
+        thread.join(_TELEMETRY_JOIN_TIMEOUT_S)
+        if thread.is_alive():
+            logger.debug("Alarm telemetry emit still running in background: %s", alarm.code)
+            return True
+        return result["ok"]
+    except Exception as exc:
+        logger.debug("Alarm telemetry dispatch failed: %s", exc)
+        return False
+
+
+def raise_alarm(
+    code: str,
+    message: str,
+    context: dict[str, Any] | None = None,
+    *,
+    severity: str = "fatal",
+    exit_code: int = 1,
+) -> NoReturn:
+    alarm = build_alarm(code, message, context, severity=severity, exit_code=exit_code)
+    emit_alarm(alarm)
+    raise alarm