grafeo-memory 0.2.2__tar.gz → 0.4.0__tar.gz

{grafeo_memory-0.2.2 → grafeo_memory-0.4.0}/.env.example

@@ -1,4 +1,4 @@
-# grafeo-memory — Environment Variables
+# grafeo-memory: environment variables
 #
 # Copy this file to .env and fill in the keys for your provider(s).
 # Only the provider you use needs to be set.
@@ -9,7 +9,7 @@
 
 # ── grafeo-memory config ────────────────────────────────────────────
 # GRAFEO_MEMORY_MODEL=mistral:mistral-small-latest
-# GRAFEO_MEMORY_DB=./memory.db
+# GRAFEO_MEMORY_DB=./memory.grafeo
 # GRAFEO_MEMORY_USER=default
 
 # ── LLM Providers (pydantic-ai) ─────────────────────────────────────
@@ -60,3 +60,19 @@ OPENROUTER_API_KEY=
 
 # Mistral embeddings (used automatically when model is mistral:*)
 # MISTRAL_API_KEY=  (same key as above)
+
+# ── LLM call cache (in-memory LRU + optional JSONL persistence) ──────────
+# GRAFEO_MEMORY_CACHE_ENABLED=true
+# GRAFEO_MEMORY_CACHE_MAX_ENTRIES=10000
+# GRAFEO_MEMORY_CACHE_MAX_MEMORY_MB=128      # in-memory hot cache cap
+# GRAFEO_MEMORY_CACHE_MAX_STORAGE_MB=512     # JSONL persistence file cap
+# GRAFEO_MEMORY_CACHE_PERSIST_PATH=./memory.grafeo.llmcache.jsonl  # default: <db>.llmcache.jsonl
+
+# ── GrafeoDB engine limits (MB; unset = grafeo's detected machine default) ──
+# GRAFEO_MEMORY_DB_MEMORY_LIMIT_MB=2048   # enforced per write; cold chunks spill
+# GRAFEO_MEMORY_DB_SPILL_LIMIT_MB=4096    # on-disk spill/WAL cap
+
+# ── Decision models (Typesafe Jev / System One) ─────────────────────────
+# TYPESAFE_API_KEY=<template>
+# GRAFEO_MEMORY_DECISION_MODEL=jev        # registered name or entry point; unset = LLM-only pipeline
+# GRAFEO_MEMORY_JEV_MODEL=jev-latest      # Jev model version

{grafeo_memory-0.2.2 → grafeo_memory-0.4.0}/.github/workflows/ci.yml

@@ -10,8 +10,8 @@ jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v6
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.3.0
       - run: uv sync
       - run: uv run ruff check .
       - run: uv run ruff format --check .
@@ -19,20 +19,21 @@ jobs:
   typecheck:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v6
-      - run: uv sync
-      - run: uv run ty check src/ tests/
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.3.0
+      - run: uv sync --all-extras  # optional imports (mcp, httpx, openai, ...) must resolve
+      - run: uv run ty check
 
   test:
     runs-on: ${{ matrix.os }}
     strategy:
+      fail-fast: false  # one failing job must not cancel the others: every OS and version reports
       matrix:
         os: [ubuntu-latest, windows-latest]
-        python-version: ["3.12", "3.13", "3.14"]
+        python-version: ["3.13", "3.14", "3.15"]
     steps:
-      - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v6
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.3.0
         with:
           python-version: ${{ matrix.python-version }}
       - run: uv sync --all-extras
@@ -42,13 +43,13 @@ jobs:
     name: Code Coverage
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v6
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.3.0
       - run: uv sync --all-extras
       - name: Generate coverage report
         run: uv run pytest --cov=grafeo_memory --cov-report=xml:coverage.xml
       - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@v7
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           files: coverage.xml

grafeo_memory-0.4.0/.github/workflows/engine-compat.yml

@@ -0,0 +1,45 @@
+name: Engine compatibility
+
+# Runs the suite against the newest grafeo releases on PyPI, pre-releases
+# included, so an engine change that breaks grafeo-memory shows up before
+# users hit it. tests/test_core/test_grafeo_contract.py names the engine behavior that
+# changed.
+#
+# - within-pin: the newest grafeo that the requirement in pyproject.toml accepts
+# - newest:     the newest grafeo on PyPI, ignoring that requirement (early
+#               warning for the next minor release)
+#
+# Only grafeo moves: every other package stays at its locked version.
+
+on:
+  schedule:
+    - cron: "0 5 * * 1" # Mondays, 05:00 UTC
+  workflow_dispatch:
+
+jobs:
+  test:
+    name: grafeo ${{ matrix.grafeo }} (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        grafeo: [within-pin, newest]
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.3.0
+        with:
+          python-version: "3.13"
+      - run: uv sync --all-extras --no-sources
+      - name: Newest grafeo the requirement accepts
+        if: matrix.grafeo == 'within-pin'
+        run: uv pip install --no-sources -r pyproject.toml --upgrade-package grafeo --prerelease allow
+      - name: Newest grafeo on PyPI
+        if: matrix.grafeo == 'newest'
+        run: uv pip install --upgrade --prerelease allow grafeo
+      - name: Engine under test
+        run: uv run --no-sync python -c "import grafeo; print(grafeo.__version__, grafeo.build_info())"
+      - name: Engine contract
+        run: uv run --no-sync pytest tests/test_core/test_grafeo_contract.py -v --no-cov
+      - name: Full suite
+        run: uv run --no-sync pytest -v

{grafeo_memory-0.2.2 → grafeo_memory-0.4.0}/.github/workflows/pypi.yml

@@ -11,10 +11,10 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v6
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.3.0
       - run: uv build
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@v7
         with:
           name: dist
           path: dist/
@@ -24,7 +24,7 @@ jobs:
     runs-on: ubuntu-latest
     environment: pypi
     steps:
-      - uses: actions/download-artifact@v4
+      - uses: actions/download-artifact@v8
         with:
           name: dist
           path: dist/

{grafeo_memory-0.2.2 → grafeo_memory-0.4.0}/.gitignore

@@ -32,8 +32,33 @@ venv/
 # ── Testing & coverage ───────────────────────────────────────────────
 .pytest_cache/
 .coverage
+coverage.xml
 htmlcov/
 *.log
 
 # ── Database files (don't commit user data) ──────────────────────────
 *.db
+
+
+# benchmark run data and LLM caches (large, regenerable)
+.benchmarks/beam_runs/
+.benchmarks/beam_data/
+.benchmarks/lme_runs/
+.benchmarks/lme_data/
+.benchmarks/locomo_runs/
+.benchmarks/locomo_data/
+*.llmcache.jsonl
+*.grafeo
+*.grafeo.wal/
+# left by the 0.6 upgrade (full copies of the old database) and by queries that spill to disk
+*.grafeo.pre-0.6
+*.grafeo.pre-0.6.wal/
+*.db.pre-0.6/
+*.grafeo.spill/
+
+# Claude Code project context (internal)
+.claude/
+
+# grafeo 0.5 databases the upgrade tests open (tests/fixtures/grafeo_0_5/make_fixtures.py); after *.grafeo so they win
+!tests/fixtures/grafeo_0_5/*/memory_wal/wal/*.log
+!tests/fixtures/grafeo_0_5/*/memory.grafeo

grafeo_memory-0.4.0/.pre-commit-config.yaml

@@ -0,0 +1,68 @@
+# Pre-commit hooks for grafeo-memory: the same checks CI runs, so a push that passes here passes CI.
+# Install once per clone: cargo install prek && prek install   (installs the pre-commit and pre-push hooks)
+# Run manually: prek run --all-files   (pre-push stage: prek run --all-files --hook-stage pre-push)
+# Docs: https://github.com/j178/prek
+#
+# On commit: hygiene, typos, ruff check, ruff format, ty, lockfile check (fast).
+# On push: the full test suite, on this machine's OS (catches the Windows-only failures before CI).
+
+default_install_hook_types: [pre-commit, pre-push]
+default_stages: [pre-commit]
+
+repos:
+  # Built-in prek hooks
+  - repo: builtin
+    hooks:
+      # Markdown is prose; never rewrite it mechanically
+      - id: trailing-whitespace
+        exclude: '\.md$'
+      - id: end-of-file-fixer
+        exclude: '\.md$'
+      - id: check-yaml
+      - id: check-toml
+      - id: check-merge-conflict
+      - id: check-added-large-files
+        args: ['--maxkb=1000']
+
+  # Typo checker
+  - repo: https://github.com/crate-ci/typos
+    rev: v1.29.4
+    hooks:
+      - id: typos
+
+  # Python hooks
+  - repo: local
+    hooks:
+      - id: ruff-check
+        name: ruff check
+        entry: uv run --frozen ruff check --fix --exit-non-zero-on-fix
+        language: system
+        types: [python]
+
+      - id: ruff-format
+        name: ruff format
+        entry: uv run --frozen ruff format
+        language: system
+        types: [python]
+
+      - id: ty-check
+        name: ty check
+        entry: uv run --frozen ty check .
+        language: system
+        pass_filenames: false
+        types: [python]
+
+      - id: uv-lock-check
+        name: uv lock --check
+        entry: uv lock --check
+        language: system
+        pass_filenames: false
+        files: '^(pyproject\.toml|uv\.lock)$'
+
+      - id: pytest
+        name: pytest (full suite)
+        entry: uv run --frozen pytest -q -p no:cacheprovider --no-cov
+        language: system
+        pass_filenames: false
+        always_run: true
+        stages: [pre-push]