brainlayer 1.0.0__tar.gz → 1.2.0__tar.gz

brainlayer-1.2.0/.claude-plugin/marketplace.json

@@ -0,0 +1,13 @@
+{
+  "name": "brainlayer",
+  "owner": {
+    "name": "Etan Heyman",
+    "url": "https://github.com/EtanHey"
+  },
+  "plugins": [
+    {
+      "name": "brainlayer",
+      "source": "./extensions/brainlayer-plugin"
+    }
+  ]
+}

brainlayer-1.2.0/.claude.local.md.example

@@ -0,0 +1,21 @@
+# .claude.local.md — Machine-Specific Config
+# Copy to .claude.local.md and customize for your machine.
+# This file is gitignored — safe for local paths, ports, and overrides.
+
+## Local Paths
+# - Repo: /Users/YOURUSERNAME/Gits/brainlayer
+# - Python venv: /Users/YOURUSERNAME/Gits/brainlayer/.venv
+# - BrainLayer DB: /Users/YOURUSERNAME/Library/Application Support/BrainBar/brainlayer.db
+
+## BrainBar Daemon
+# - Socket: /tmp/brainbar.sock
+# - App: /Users/YOURUSERNAME/Applications/BrainBar.app
+
+## Enrichment Config
+# - BRAINLAYER_ENRICH_BACKEND: mlx (default on Apple Silicon) or ollama
+# - Auto-enrich on brain_store uses Gemini Flash Lite (separate from backend)
+# - Gemini API key location: 1Password vault "development"
+
+## Dev Flags
+# - debug_mode: false
+# - test_db_path: /tmp/brainlayer-test.db

brainlayer-1.2.0/.gitattributes

@@ -0,0 +1,2 @@
+# Mark test fixtures as generated to exclude from language stats
+tests/fixtures/*.json linguist-generated=true

brainlayer-1.2.0/.githooks/pre-push

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# Pre-push hook — regression harness gate
+#
+# NOT FRICTION — discipline. The 5-day regression cycle in this repo
+# exists because past pushes bypassed checks. This hook stops that.
+#
+# DO NOT BYPASS:
+#   git push --no-verify          ← sneaks past the hook
+#   chmod -x .githooks/pre-push   ← disables it
+#
+# DO NOT SILENCE FAILURES:
+#   A failing test = a real bug. The Zero-RMS Hang recurred Apr 2 → Apr 27
+#   because symptomatic fixes shipped without root-cause coverage.
+#   Treat each failure as CRITICAL REVIEW TIME.
+
+set -uo pipefail
+[ ! -f scripts/run_tests.sh ] && { echo "⚠️  no scripts/run_tests.sh — skipping"; exit 0; }
+BRAINLAYER_PREPUSH=1 bash scripts/run_tests.sh
+exit_status=$?
+
+if [ $exit_status -ne 0 ]; then
+  cat <<'BANNER'
+
+🛑 PUSH BLOCKED — regression harness failed.
+
+This is a real regression. DO NOT bypass with --no-verify or silence the test.
+  1. Read the failure carefully
+  2. Reproduce locally
+  3. Fix the underlying bug
+  4. If the test IS wrong, separate PR with rationale
+
+The 5-day regression cycle exists because past pushes bypassed checks.
+
+BANNER
+  exit $exit_status
+fi
+
+exit 0

brainlayer-1.2.0/.github/workflows/ci.yml

@@ -0,0 +1,113 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Free runner disk
+        run: |
+          df -h
+          sudo rm -rf /usr/local/lib/android /usr/share/dotnet /opt/ghc /opt/hostedtoolcache/CodeQL || true
+          df -h
+
+      - name: Cache pip
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ matrix.python-version }}-${{ hashFiles('pyproject.toml') }}
+          restore-keys: ${{ runner.os }}-pip-${{ matrix.python-version }}-
+
+      - name: Cache Hugging Face models
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/huggingface
+          key: ${{ runner.os }}-hf-bge-large-en-v1.5-bge-m3
+
+      - name: Install
+        run: pip install -e ".[dev]"
+
+      - name: Warm Hugging Face model cache
+        run: |
+          python - <<'PY'
+          import time
+
+          from huggingface_hub import snapshot_download
+
+          model_ids = ["BAAI/bge-large-en-v1.5", "BAAI/bge-m3"]
+          delays = [5, 15, 30]
+
+          for model_id in model_ids:
+              for attempt in range(1, len(delays) + 2):
+                  try:
+                      snapshot_download(repo_id=model_id)
+                      print(f"Warmed Hugging Face cache for {model_id}")
+                      break
+                  except Exception as exc:
+                      if attempt == len(delays) + 1:
+                          print(f"::warning::Unable to warm Hugging Face cache for {model_id}: {exc!r}")
+                          break
+                      delay = delays[attempt - 1]
+                      print(f"Unable to warm Hugging Face cache for {model_id} on attempt {attempt}; retrying in {delay}s: {exc!r}")
+                      time.sleep(delay)
+          PY
+
+      - name: Unit tests
+        env:
+          HF_HUB_OFFLINE: "1"
+          TRANSFORMERS_OFFLINE: "1"
+        run: >
+          pytest tests/ -v --tb=short -m "not integration and not live" -x
+          --ignore=tests/test_eval_framework.py
+          --ignore=tests/test_follow_up_rewrite.py
+          --ignore=tests/test_prompt_classification.py
+
+      - name: Isolated eval and hook routing tests
+        env:
+          HF_HUB_OFFLINE: "1"
+          TRANSFORMERS_OFFLINE: "1"
+        run: >
+          pytest
+          tests/test_eval_framework.py
+          tests/test_follow_up_rewrite.py
+          tests/test_prompt_classification.py
+          -v --tb=short -x
+
+      - name: MCP tool registration
+        env:
+          HF_HUB_OFFLINE: "1"
+          TRANSFORMERS_OFFLINE: "1"
+        run: pytest tests/test_think_recall_integration.py::TestMCPToolCount -v --tb=short
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Cache pip
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-lint-${{ hashFiles('pyproject.toml') }}
+
+      - run: pip install ruff
+      - run: ruff check src/ tests/
+      - run: ruff format --check src/ tests/

brainlayer-1.2.0/.gitignore

@@ -0,0 +1,84 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.venv/
+venv/
+env/
+
+# Build
+dist/
+build/
+*.egg-info/
+*.egg
+# MkDocs build output (not our Next.js site/ directory)
+docs/site/
+site/node_modules/
+site/.next/
+
+# Testing
+.pytest_cache/
+.ruff_cache/
+htmlcov/
+.coverage
+.tox/
+
+# Data
+*.db
+*.db-wal
+*.db-shm
+data/
+
+# Secrets
+.env
+.env.local
+.env.*.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Local working files (audit logs, prompts, scratch)
+.tmp-*
+grill*/
+docs.local/
+
+# Internal planning docs (contain cross-repo references)
+docs/plan/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Lock files (reproducible installs handled via pyproject.toml)
+uv.lock
+
+# Claude scratchpad
+claude.scratchpad.md
+
+# MCP config (contains secrets)
+.mcp.json
+.mcp.json.bak
+!extensions/brainlayer-plugin/.mcp.json
+
+# Claude Code project settings
+.claude/
+
+# Local eval outputs (tracked baselines remain tracked)
+tests/eval_results/
+
+# Raw enriched eval rows contain PERSONAL chunk content — NEVER commit (privacy).
+# Aggregate metrics go in results/ instead; raw rows archived to Brain Drive.
+eval_results/*.jsonl
+
+# Progress trackers (ephemeral)
+scripts/.kg_rebuild_progress.json
+
+# Machine-local Claude config
+.claude.local.md
+.vercel
+site/

brainlayer-1.2.0/.mcp.json.example

@@ -0,0 +1,19 @@
+{
+  "_comment": "Run: ~/Gits/orchestrator/scripts/mcp-setup.sh ~/Gits/brainlayer",
+  "_comment2": "brainlayer-socat: BrainBar daemon on Unix socket (replaces 9 Python processes)",
+  "mcpServers": {
+    "brainlayer": {
+      "command": "socat",
+      "args": ["STDIO", "UNIX-CONNECT:/tmp/brainbar.sock"]
+    },
+    "voicelayer": {
+      "command": "voicelayer-mcp"
+    },
+    "cmux": {
+      "command": "node",
+      "args": [
+        "/Users/etanheyman/Gits/orchestrator/tools/cmux-mcp/dist/index.js"
+      ]
+    }
+  }
+}

brainlayer-1.2.0/AGENTS.md

@@ -0,0 +1,43 @@
+# BrainLayer Agent Notes
+
+BrainLayer is the memory layer for the entire ecosystem. If it breaks, every golem degrades into a vanilla LLM with no durable recall.
+
+## Review Guidelines
+- Treat retrieval correctness, write safety, and MCP stability as critical-path concerns.
+- Prefer finding regressions in search quality, lock handling, and tool contracts before style or refactor nits.
+- Flag risky DB or concurrency changes explicitly. Do not hand-wave lock behavior.
+
+## Key Paths
+- `src/brainlayer/`
+- `scripts/`
+- `tests/`
+
+## Database
+- Canonical DB: `~/.local/share/brainlayer/brainlayer.db`
+
+## MCP Tools
+- `brain_search`
+- `brain_store`
+- `brain_recall`
+- `brain_expand`
+- `brain_digest`
+- `brain_entity`
+- `brain_update`
+- `brain_tags`
+
+## Concurrency Rules
+- One write at a time.
+- Reads are safe.
+- `brain_digest` is write-heavy; do not run it in parallel with other MCP work.
+
+## Tests
+- Run `pytest` before claiming behavior changed safely.
+- Current suite size: 929 tests.
+
+## PR Workflow
+- Request `@codex review`.
+- Request `@cursor` and `@bugbot` review.
+
+## Known Issues
+- DB locking during enrichment.
+- WAL can grow to 4.7GB.