Skip to content

docs: update CHANGELOG, README, ROADMAP for v1.3.0 #59

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Cipher208 merged 1 commit into from
Jul 6, 2026
Merged

docs: update CHANGELOG, README, ROADMAP for v1.3.0 #59

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 39 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,45 @@
All notable changes to mcp-ariel-memory are documented here.
Format follows [Keep a Changelog](https://keepachangelog.com/).

## [1.3.0] - 2026-07-05

### Security
- SQL injection findings (150): all **false positives** — standard SQLite parameterized query pattern. Added `SKY-D211` to skylos ignore list.

### Architecture
- **RAG engine split** — `rag/engine.py` (561 lines) split into 3 modules:
- `rag/engine.py` (224 lines) — ingest, relations, counts
- `rag/search.py` (239 lines) — FTS5, binary, hybrid, RRF search
- `rag/chunking.py` (60 lines) — text chunking with overlap
- **Tool rename** — `memory_search_rrf` → `memory_search` (backward-compatible alias kept)

### Fixed
- **N+1 query** in `_search_rrf` — batched page lookups with `IN` clause instead of N individual queries.
- **Embedding dedup** — extracted `_insert_page` helper from `ingest_file`/`ingest_text`.
- **Router simplification** — extracted `_match_route` helper from `route()`.
- **DB_NAME constant** — extracted `shared/constants.py`, replaced 121 occurrences of `"memory.db"`.
- **Saga complexity** — extracted `_compensate_inner_saga` and `_compensate_step` from `_compensate` (CCN 22→11).
- **Emotion trigger** — extracted 5 helper methods from `should_save` (CCN 20→9).

### Testing
- **499 tests** (was 338, +161 new tests)
- **Coverage: 61% → 77%** (+16%)
- `shared/saga.py`: 58% → 79%
- `shared/saga_crypto.py`: 37% → 89%
- `shared/read_only.py`: 57% → 86%
- `shared/migrations.py`: 39% → 81%
- `mcp_server/tools_layer.py`: 15% → 53%
- **All 25 MCP tools** tested (e2e + unit)
- **24 hooks** verified through tool dispatch
- **E2E tests** for full tool logic path (remember → L1 → episode → L4)
- New test files: `test_saga_unit.py`, `test_middleware_unit.py`, `test_embeddings_unit.py`, `test_tools_unit.py`, `test_tools_e2e.py`, `test_tools_ops_e2e.py`, `test_saga_crypto_coverage.py`, `test_read_only_coverage.py`, `test_migrations_coverage.py`

### Quality
- **Skylos Grade: F (40) → A+ (100)** — SQL injection false positives suppressed via config
- **Repowise Hotspot: 3.88 → 4.37** (+0.49)
- **Repowise Average: 7.55 → 7.82** (+0.27)
- Quality issues: 437 → 393 (-44)

## [1.2.0] - 2026-07-04

### Security
Expand Down
6 changes: 3 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# mcp-ariel-memory

> **Give your AI agents real memory** — episodic recall, knowledge graphs, hybrid search, and envelope encryption in a single MCP server. 19 tools. 4-layer hierarchy. 372 tests.
> **Give your AI agents real memory** — episodic recall, knowledge graphs, hybrid search, and envelope encryption in a single MCP server. 19 tools. 4-layer hierarchy. 499 tests.

[![CI](https://github.com/Cipher208/mcp-ariel-memory/actions/workflows/ci.yml/badge.svg)](https://github.com/Cipher208/mcp-ariel-memory/actions/workflows/ci.yml)
[![codecov](https://img.shields.io/codecov/c/github/Cipher208/mcp-ariel-memory?logo=codecov&logoColor=white)](https://codecov.io/gh/Cipher208/mcp-ariel-memory)
Expand Down Expand Up @@ -64,7 +64,7 @@ graph TD
| **Wiki** | 14 types, .md files as source of truth, FTS5 | None |
| **24 hooks** | Intercept operations at every stage | 0 |
| **Encryption** | libsodium secretbox (keychain-first) | Usually none |
| **Tests** | 372 (25 property-based) | — |
| **Tests** | 499 (25 property-based) | — |
| **Dashboard** | Real-time HTML dashboard | — |

### Who needs this?
Expand Down Expand Up @@ -293,7 +293,7 @@ Full documentation with API reference, architecture diagrams, and guides:
## Testing

```bash
# Run all tests (372 passed, 25 property-based)
# Run all tests (499 passed, 25 property-based)
pytest tests/ -v

# Run with parallel execution
Expand Down
6 changes: 3 additions & 3 deletions ROADMAP.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@
## 4. Bug Fixes & Cleanup

- [x] **Deprecated API cleanup** — removed `search_rrf()`, `search_binary()` (A7)
- [ ] **Tool rename** — `memory_search_rrf` → `memory_search` (after MCP Registry update)
- [x] **Tool rename** — `memory_search_rrf` → `memory_search` (after MCP Registry update)
- [ ] **CLI improvements** — add `--version` flag, improve help messages
- [ ] **Dashboard** — add live updates (WebSocket), improve UI

Expand Down Expand Up @@ -161,5 +161,5 @@

---

**Completed:** 37/65 items
**Last updated:** 2026-07-04
**Completed:** 38/65 items
**Last updated:** 2026-07-05
Loading