test(agent-memory): Phase 11 — integration suite (real valkey-search)

[jamby77]

Stacked on #258 (Phase 10 — AgentMemory facade). Final core phase (0–11).

What

MemoryStore.integration.test.ts — a skip-guarded suite that exercises the full memory stack against a real Valkey + valkey-search server.

• Connects via VALKEY_URL (default redis://localhost:6380), lazyConnect + no-retry so it fails fast and skips when no server is present (CI stays green) — same pattern as semantic-cache/agent-cache.
• FT.CREATEs the {name}:mem:idx index (FLAT, FLOAT32, COSINE, dim 16; TAG scope/tags/source; NUMERIC importance/created_at/last_accessed_at/access_count; TEXT content) in beforeAll, since the package has no index-creation code of its own.

Coverage

1. remember → recall round trip — stored memory comes back at cosine distance < 0.01 (≈ exact match), with the right id and content.
2. scope/tag isolation — same text in two namespaces; recall filters server-side to the requested namespace and to a tag.
3. capacity eviction — maxItemsPerScope: 3, write 5; the evictions counter in __mem_stats increments and the scope stays bounded.
4. ttl expiry — a ttl: 1 memory exists, then is gone after expiry.
5. consolidation — old low-importance memories collapse into a source: 'summary' memory that is itself recallable; sources deleted; counts correct.

Robustness

• Polls for async HNSW indexing (pollUntil) rather than fixed sleeps; drops the index and deletes keys around the run.
• Adds iovalkey as a devDependency for the test client (lockfile updated).

Verification

Default vitest run → 100/100 green (integration skips, no server). Against the live valkey/valkey-bundle:9.1 on port 6384: 5/5 green, non-flaky across 3 consecutive runs. tsc clean · prettier clean.

This completes the agent-memory core (Phases 0–11). Optional follow-ups remain: Phase 12 (Python parity) and Phase 13 (MCP tools).

---

Note

Low Risk
Test-only changes with no production runtime impact; integration tests are skipped without a Valkey server.

Overview
Adds MemoryStore.integration.test.ts, an optional integration suite that runs MemoryStore against a live Valkey instance with valkey-search (connect via VALKEY_URL, default redis://localhost:6380). Tests skip when no server is reachable so default CI stays green, matching other packages’ integration pattern.

The suite bootstraps its own FT.CREATE index in beforeAll (the package does not create indexes), then covers remember/recall similarity, namespace and tag filtering, capacity eviction with stats, TTL expiry, and consolidation into a recallable summary.

Adds iovalkey as a devDependency for the test client; lockfile updated accordingly.

^{Reviewed by Cursor Bugbot for commit e517bec. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 80c4b1c. Configure here.}