Aletheia 0.2.0 release notes
npm 0.2.0GitHub releaseChanges since 0.1.13
npm install -g aletheia-mem@0.2.0
Security
- Remote mode (a non-loopback bind) served
/v1/*, the/v1/livesocket and/mcpto anyone who could reach the port whenALETHEIA_API_KEYwas not set; the login covered only/and/api/*. In remote mode/v1now needs a login session or the key,/mcpneeds the key, and the server warns at startup when no key is set. Loopback installs, the default, were not affected. - On a loopback bind with no key,
/mcpnow answers only this computer, like/v1. Behind a reverse proxy or tunnel it answered anyone. ALETHEIA_API_KEYnow guards every/apiand/v1route, not only/v1and/mcp. The dashboard asks for the key once per tab and sends it as a bearer header; the live socket uses a one-time ticket, so the key never goes in a URL. A key must be at least 32 characters in remote mode, and repeated wrong keys are throttled.- Every prompt is redacted again, and
<private>blocks dropped, before any model call: the Work view refresh, summaries, compress and fact extraction. - The sync hub checks the pairing lockout before the code, so a correct guess no longer succeeds while locked out.
- Hardening: a Host header that would change the routed path is refused; malformed percent sequences return 4xx instead of 500; the CSRF token is tied to the login session; logout closes that session's live streams; the login lockout map is bounded.
Added
aletheia backup run|list|statusandaletheia restore <file>: scheduled local snapshots ofhub.db(off by default, every 24 h, keep 7). Restore refuses while another process holds the database.- Git worktree sessions share their main project's memory (
project.worktrees, defaultmain).aletheia projectslists project keys, andaletheia projects fold-worktrees [--write]folds old worktree keys into their main project. Project merges move every table in one transaction. - Search finds Chinese, Japanese and Korean words inside stored text through a bigram channel.
- Dense (vector) results on
/v1/search, MCPsearchand the dashboard when the optional embeddings package is installed, with a keyword fallback and a note when it is not. - Opt-in cross-encoder rerank in search (
search.rerank), with a time budget; the rerank benchmark rows are labelled bench only. - Graph retrieval can be turned on with
graph.enabled(off by default; measured on synthetic data only).aletheia entitiesandGET /v1/entitieslist entities. - Claude Code hooks capture failed tool calls (
PostToolUseFailure) and subagent results (SubagentStop); subagent rows stay out of session-start context by default. - An opt-in file-read gate for Claude Code (
readGate.enabled, aPreToolUsehook) and afile_outlineMCP tool. team_briefandteam_searchMCP tools for team members, locally and on the sync hub.aletheia import claude-memoryimports Claude Code auto-memory files, read-only and redacted.aletheia connectwrites MCP config for GitHub Copilot CLI, Goose and Roo Code (from their docs, not tested on a real install).aletheia folder-context <dir> [--write], an explicit, dry-run-first command for folder context files.aletheia install claude-desktop [--write].- The dashboard has team write controls, an erasure screen and a project-merge screen with a preview.
- The dashboard can be switched into the ten README languages (machine-translated), with right-to-left layout for Arabic.
GET /api/hub/projects/merge-plan;docs/openapi.jsonnow documents every implemented route, and a test fails when one is missing.- A LoCoMo retrieval run against claude-mem 15.17.0 (Recall@5 43.5%, MRR 0.377, Chroma on), committed with its raw output.
Changed
- The compress queue no longer drops sessions past 200 when no worker runs; health and doctor report it.
aletheia install --list, doctor and the tools tables show capture and context separately; Windsurf has capture but no context.--helpandhelpexit 0 and list every command; known errors print one line;aletheia-server --helpprints usage./healthzanswers from a cache, and doctor waits up to about 3 s and reports a slow server as slow.retentionandcontext.formatare in the dashboard Settings.- The README interfaces table lists
aletheia mcpandnpx aletheia-mem mcpas ways to start the stdio MCP server, in all eleven languages.
Fixed
- The remote login page's Content-Security-Policy blocked its own login request, and the login and logout cookies were sent in one header, so browsers lost the CSRF cookie. Remote login, writes and logout work in a browser again.
- In remote mode the live socket refused the dashboard's own non-loopback origin.
test/refresh.test.mjsfailed from 2026-11-08 because it used the wall clock against fixture dates.- The test suite no longer rewrites tracked
site/files. - Two backups written in the same millisecond overwrote each other in
aletheia connect. gemini-extension.jsonstill said version 0.1.0. It now carries the package version, andscripts/release.mjs --preparebumps.claude-plugin/plugin.json,.claude-plugin/marketplace.jsonandgemini-extension.jsonwith the package.--verifyfails when one of them differs.
Removed
- The unused result cache module, the
setupStateFileconfig key and the always-501GET /api/work-stateroute.