chore(release): update EverOS to 1.1.1

.env.example

@@ -30,13 +30,6 @@ EVEROS_LLM__MODEL=openai/gpt-4.1-mini
 EVEROS_LLM__API_KEY=
 EVEROS_LLM__BASE_URL=https://openrouter.ai/api/v1
 
-# Aliyun Bailian (DashScope) alternative — one key also covers embedding +
-# rerank below, so the same value goes in all three API_KEY slots.
-# Uncomment these three lines and comment out the OpenRouter lines above:
-# EVEROS_LLM__MODEL=qwen-plus
-# EVEROS_LLM__API_KEY=<DASHSCOPE_API_KEY>
-# EVEROS_LLM__BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
-
 
 # ─── Multimodal LLM (independent from [llm]; vision/audio capable) ────
 # Separate model for parsing multimodal content items (image / pdf /
@@ -66,12 +59,6 @@ EVEROS_MULTIMODAL__BASE_URL=https://openrouter.ai/api/v1
 EVEROS_EMBEDDING__MODEL=Qwen/Qwen3-Embedding-4B
 EVEROS_EMBEDDING__API_KEY=
 EVEROS_EMBEDDING__BASE_URL=https://api.deepinfra.com/v1/openai
-
-# Aliyun Bailian (DashScope) alternative. Uncomment these three lines and
-# comment out the DeepInfra embedding lines above:
-# EVEROS_EMBEDDING__MODEL=text-embedding-v4
-# EVEROS_EMBEDDING__API_KEY=<DASHSCOPE_API_KEY>
-# EVEROS_EMBEDDING__BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
 # Runtime knobs — uncomment to override defaults (30s / 3 / 10 / 5):
 # EVEROS_EMBEDDING__TIMEOUT_SECONDS=30
 # EVEROS_EMBEDDING__MAX_RETRIES=3
@@ -81,21 +68,10 @@ EVEROS_EMBEDDING__BASE_URL=https://api.deepinfra.com/v1/openai
 
 # ─── Rerank (OpenAI-protocol /rerank) ────────────────
 # base_url should point at the rerank endpoint (e.g. .../v1/rerank).
-# EVEROS_RERANK__PROVIDER selects the request-shape: "deepinfra" (default),
-# "vllm", or "dashscope". Left unset, it is inferred from the base_url host
-# (dashscope.aliyuncs.com -> dashscope, *.deepinfra.com -> deepinfra).
 
 EVEROS_RERANK__MODEL=Qwen/Qwen3-Reranker-4B
 EVEROS_RERANK__API_KEY=
 EVEROS_RERANK__BASE_URL=https://api.deepinfra.com/v1/inference
-
-# Aliyun Bailian (DashScope) alternative. EverOS currently supports
-# DashScope rerank via gte-rerank-v2; provider is auto-inferred from host,
-# so EVEROS_RERANK__PROVIDER is optional. Uncomment these three lines and
-# comment out the DeepInfra rerank lines above:
-# EVEROS_RERANK__MODEL=gte-rerank-v2
-# EVEROS_RERANK__API_KEY=<DASHSCOPE_API_KEY>
-# EVEROS_RERANK__BASE_URL=https://dashscope.aliyuncs.com
 # Runtime knobs — uncomment to override defaults (30s / 3 / 10 / 5):
 # EVEROS_RERANK__TIMEOUT_SECONDS=30
 # EVEROS_RERANK__MAX_RETRIES=3

.github/workflows/ci.yml

@@ -1,3 +1,6 @@
+# CI is a thin wrapper over the Makefile — single source of truth for commands.
+# See docs/engineering.md and the Makefile for what each target does.
+
 name: CI
 
 on:
@@ -32,7 +35,7 @@ jobs:
       - name: Install dependencies (frozen)
         run: make install-deps
 
-      - name: Lint (ruff + import-linter + datetime + openapi drift)
+      - name: Lint (ruff + import-linter + repo gates + datetime + openapi drift)
         run: make lint
 
   unit:
@@ -56,6 +59,27 @@ jobs:
       - name: Unit tests
         run: make test
 
+  unit-py313:
+    name: unit tests (3.13)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.2.0
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Install dependencies (frozen)
+        run: make install-deps
+
+      - name: Unit tests
+        run: make test
+
   integration:
     name: integration tests
     runs-on: ubuntu-latest
@@ -77,6 +101,27 @@ jobs:
       - name: Integration tests
         run: make integration
 
+  integration-py313:
+    name: integration tests (3.13)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.2.0
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Install dependencies (frozen)
+        run: make install-deps
+
+      - name: Integration tests
+        run: make integration
+
   package:
     name: package build
     runs-on: ubuntu-latest

.gitignore

@@ -107,6 +107,7 @@ celerybeat.pid
 # Environments
 .env
 .env.*
+!.env.example
 .venv
 env/
 venv/
@@ -258,13 +259,17 @@ evaluation/locomo_evaluation/data/locomo10.json
 # Legacy src kept locally for migration reference; not under version control.
 src_old/
 
-# Benchmark checkpoints — Phase-level intermediate JSON dumps produced by
-# tests/test_locomo.py / tests/run_locomo_batch.sh. Per-conv final results
-# (benchmark_results/run_*/convN.json) and reports (REPORT.md / REPORT.html)
-# stay tracked; checkpoints are large, regeneratable, and not useful in
-# code review.
+# Benchmark results — JSONL outputs, reports, and run specs produced by
+# benchmarks/run.py. These are large, regeneratable, and not useful in
+# code review. Legacy benchmark_results/ and benchmark_checkpoints/ kept
+# for any lingering local data from pre-refactor runs.
+benchmarks/results/
 benchmark_results/
 benchmark_checkpoints/
 
+# Benchmark credentials — API keys + base URLs; covered by the top-level
+# .env pattern but listed explicitly for discoverability.
+benchmarks/.env
+
 # Local everos runtime data (memory root, indexes, OME state)
-.everos/
+.everos*/

CHANGELOG.md

@@ -7,6 +7,57 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.1.1] - 2026-07-06
+
+### Added
+
+- **DashScope rerank provider** — Aliyun Bailian `gte-rerank-v2` adapter;
+  configure with `rerank.provider = "dashscope"` in `everos.toml`.
+- **`everos demo` TUI command** — Textual-based interactive CLI demo for
+  showcasing EverOS core features.
+- **Benchmark runner** — full LoCoMo benchmark suite: `benchmarks/run.py`
+  with TOML configuration, automated ingestion, search evaluation, and
+  scoring.
+- **Hybrid search: heap-expand algorithm** — rewrote `hierarchy.py` to
+  heap-driven lazy expansion with global top-N competition, replacing the
+  serial four-layer pipeline.
+
+### Fixed
+
+- **Knowledge: atomic upsert prevents StaleDataError** — cascade handler
+  switched from get→update to `INSERT ... ON CONFLICT DO UPDATE`, fixing
+  concurrent cascade race conditions.
+- **API: OpenAPI version read from `__version__`** — no longer hardcoded to
+  `0.1.0`; version now stays in sync with `pyproject.toml`.
+- **Profile middleware no longer swallows exceptions** — inner handler
+  errors now re-raise correctly instead of silently returning HTTP 200.
+
+### Performance
+
+- **Cascade optimize throttle 1s → 10s** — reduced unnecessary LanceDB
+  `optimize()` I/O by raising the minimum interval between calls.
+
+### CI / Build
+
+- **CI Python version matrix** — test and integration jobs now run on both
+  Python 3.12 and 3.13.
+- **pyproject.toml improvements** — added `project.urls`, `Typing :: Typed`
+  classifier, relaxed `jieba` version constraint, removed unused
+  `python-dotenv` dependency, cleaned up sdist include list, added `RUF`
+  lint rules and coverage configuration.
+- **`make ci` includes coverage** — `ci` target now runs
+  `lint + test + integration + cov`.
+
+### Documentation
+
+- Fixed stale references across 13 files (v1.1.0 freshness sweep).
+- Added GitHub sync guide (`docs/github-sync.md`).
+- Added v1.1.0 release notes and v1.0.0 migration guide as standalone docs.
+- Added `README.zh-CN.md` (Chinese README).
+- Expanded `QUICKSTART.md` with source install instructions and `uv run`
+  usage notes.
+- Clarified cascade `optimize()` semantics in docstrings and runbook.
+
 ## [1.1.0] - 2026-06-24
 
 ### Added
@@ -164,7 +215,8 @@ for AI agents.
 - **Decoupled algorithms** — memory extraction algorithms live in the standalone
   `everalgo-*` libraries published on PyPI.
 
-[Unreleased]: https://github.com/EverMind-AI/everos/compare/v1.1.0...HEAD
+[Unreleased]: https://github.com/EverMind-AI/everos/compare/v1.1.1...HEAD
+[1.1.1]: https://github.com/EverMind-AI/everos/compare/v1.1.0...v1.1.1
 [1.1.0]: https://github.com/EverMind-AI/everos/compare/v1.0.1...v1.1.0
 [1.0.1]: https://github.com/EverMind-AI/everos/releases/tag/v1.0.1
 [1.0.0]: https://github.com/EverMind-AI/everos/releases/tag/v1.0.0