Aletheia release notes

Aletheia 0.1.12

2026-11-01T00:00:00Z

Added

The release workflow now publishes to the official MCP registry on every tag: it bumps server.json to the tag and publishes the manifest with the registry's pinned, signature-verified mcp-publisher CLI (v1.8.7) using OIDC authentication. release.mjs --prepare bumps server.json with package.json, --sync-server-json back-fills a hand-made release, and --verify fails when the manifest drifts. The mechanism follows the registry's GitHub Actions guide (https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/github-actions.mdx, fetched 2026-11-01); the registry accepts no server-listing pull requests.
scripts/build-site.mjs generates a docs changelog page (site/docs/changelog.html) from CHANGELOG.md, with a sitemap entry and a link from llms.txt; the release workflow rebuilds it and pushes it to main on every tag.

Changed

The documentation site moves from https://mohamed-ashraf-elsaed.github.io/aletheia-mem/ to https://aletheia.mohamedashrafelsaed.com/. Canonical URLs, Open Graph tags, structured data, the sitemap, robots.txt, llms.txt, llms-full.txt, the README links and the plugin manifests use the new address. Paths are unchanged, and GitHub Pages redirects the old address. Every docs page has a footer credit that links to the author's site, and the author in the structured data carries his URL.
Package metadata: the npm homepage is the project page at https://mohamedashrafelsaed.com/projects/aletheia/, and author is an object with name, email and URL. The README link row adds the project page. No code changed.
The Settings page lists only the three settings that code reads: facts.minConfidence, context.facts and rules.reviewDays. The seven that nothing read (provider, providers, factBudget.*, redaction, excludedProjects, apiKey) are removed, along with the masked-secret handling. Use the environment variables for the provider, fact budgets and excluded projects; redaction is always on.

Aletheia 0.1.11

2026-10-30T00:00:00Z

Added

A full documentation site: 49 pages in eight sections (Get started, Concepts, Connect your tools, Guides, Reference, Compare, Project, Internals) with a sidebar, breadcrumbs, previous and next links and a search box on the index. Pages cover installation, a quickstart, a page for each tool, the CLI, MCP tools, configuration, hooks, migration from claude-mem, backup, running as a service, model providers, troubleshooting, comparisons and benchmarks.
llms.txt and llms-full.txt for AI readers, a plain Markdown copy beside every page, per-page Open Graph and structured data (TechArticle, BreadcrumbList, FAQPage), and a robots.txt that names the main search and AI crawlers.
scripts/build-wiki.mjs builds a GitHub wiki from the same pages.
Search keywords in the package metadata, the registry description and the README tagline.

Changed

The landing page no longer shows an old test count, the old "My Work" card or the old latency note.
CONTRIBUTING.md explains set-up, the checks to run and how to write a documentation page.

Fixed

Redaction now covers every write path. The store redacts in add() and update(), so notes written through POST /v1/memories or the dashboard, edits, import bundle and import claude-mem no longer store secrets as typed. Names with a prefix (MY_API_KEY, DB_PASSWORD, AUTH_TOKEN), JSON-quoted keys ({"password":"..."}) and secret_key are matched, and a redacted JSON value stays valid JSON. An unclosed <private> tag drops the rest of the text.
New aletheia scrub [--apply] redacts rows stored by earlier versions.
/healthz and aletheia doctor no longer report fts5: corruption found while another process writes. quick_check was the cause: it failed about 1 time in 40 on a busy database, while real searches never failed. The check now retries and confirms with a real search query.
aletheia compress no longer downloads an embedding model by default. Set ALETHEIA_EMBED_FACTS=1 to embed new facts. aletheia embed and aletheia search --semantic still load the model because you ask for vectors.
The MCP search tool description now says that an omitted project searches all projects, which is what the code does.
aletheia uninstall no longer prints (no aletheia hooks) on a line that removes hooks.
A read-scope token on the HTTP MCP endpoint could call work_state_write. It is now a write tool and needs a sync or admin token.

Aletheia 0.1.10

2026-10-29T00:00:00Z

Added

A Home page, now the default. It lists the projects you work in and, for one project, shows in plain words what Aletheia knows about it (readable titles, a Hide button, a box to save a note), the rules that apply (switches, a box to add a rule with example chips, and a preview-first button that writes them into each tool's file), the connected tools (on, needs setup or not installed, with the command to copy) and what happened lately. Every block has a hint and an example.

Changed

The tabs now use plain names: Home, Activity (was Work), Knowledge (was Memory), Rules and Connections (was Tools). The addresses (#/work, #/memory, #/tools) are unchanged. Sub-pages are renamed too: Needs a look, Hidden, Savings, Health checks, What tools receive and History.
The project list in the header no longer shows worktree folders, temporary folders or folders with almost nothing in them. The Home page lists them under "other folders".
Request cards on the Activity page show a readable title instead of pasted text, JSON or a row of numbers, and say "How we worked this out" and "What was done" instead of "Progress evidence" and "Came out of it".

Aletheia 0.1.9

2026-10-28T00:00:00Z

Added

A context.facts setting (auto, on, off, default auto) that controls which facts the session-start Facts section lists. auto lists only pinned, provider-extracted or confidence ≥ 0.6 facts, leaving the rule extractor's 0.45/0.35 output out; on keeps the historical behaviour; off hides the section. The measured context-economics line now counts only what is actually listed.
aletheia facts clean --ineligible-sources, which also dismisses facts whose source episode kind is not summary or note with reason quality:ineligible_source.

Changed

The fact quality gate now rejects narration with a narration reason: first/second person, moment words (now, today, yet, currently, right now), progress/status phrases, session/meta references and imperative openings.
The rule extractor's sentence splitter no longer cuts on a dot inside a version number, IP address, URL, file name or domain.

Aletheia 0.1.8

2026-10-28T00:00:00Z

Added

aletheia facts clean --dry-run (the default) and aletheia facts clean --apply. The command applies the fact quality gate to already-stored facts, reports counts and the first ten examples per rejection reason, and --apply dismisses the failures with quality:<reason> through the normal reversible dismissal path.
A facts.minConfidence setting (0.3–0.9, default 0.4). The existing confidence calculation is unchanged; the floor only stops weaker facts from being stored.

Fixed

scripts/release.mjs --prepare corrupted the changelog when a release note contained the text $ followed by a backtick: it expanded as a replacement pattern and copied the header into the note. Notes are now copied literally.

Changed

Fact extraction now keeps only assistant summaries and notes as eligible sources. User prompts and tool output/file contents (including raw back-filled transcripts) are no longer extracted into facts.
Every candidate fact passes a quality gate before it is stored: balanced quotes and brackets, no escaped newlines/tabs, no code-like tokens ($, ->, ::, =>, braces, backticks, SQL or HTML tags), 3–40 words and at most 200 characters, a 1–8 word subject that is not a bare pronoun/demonstrative and does not start with a continuation word, and an object that does not end mid-clause. Each rejection returns a stable reason code and is counted.
The session-start Facts section caps each fact line at 140 characters (dismissed facts were already skipped).
The CI regression gate now uses a harder seeded corpus (near-duplicate distractors, answers ranked 3rd and 6th, 50,000 rows). Its baseline is Recall@5 0.90 and p95 latency about 7.8 ms, above the 5 ms floor, so a latency regression of more than 20% now fails the build too.
The default test timeout is 20 s instead of 5 s, because three installer tests timed out on a slow Windows runner.

Aletheia 0.1.7

2026-10-28T00:00:00Z

Added

A recall and latency regression gate runs in CI on Linux: it fails a change that loses more than one point of Recall@5 on a seeded synthetic corpus. Its latency check is report-only below a 5 ms baseline.
The test suite now runs in CI on Windows as well as Linux and macOS. On Windows, the hook-execution checks for Windsurf and Gemini CLI and one temp-folder cleanup check are skipped, and no real tool was tried there.

Fixed

On Windows, aletheia uninstall codex left its block in ~/.codex/config.toml: the installer wrote the command path with TOML escapes, but the reader did not unescape them, so it did not recognise its own entry. The reader now parses TOML basic strings.

Changed

session_start_context, the SessionStart hook, /v1/context, /api/hub/context and aletheia context now return a compact index by default: recent memories are grouped by day and first file and printed one line each with no narrative, followed by session requests, facts and rules, plus a legend, a fetch-more hint and a measured context-economics line. The previous flat shape stays available through the context.format = "classic" setting.

Aletheia 0.1.6

2026-10-28T00:00:00Z

Fixed

The MCP initialize reply and GET /v1/info reported version 0.1.0 whatever the installed version. They now report the package version.
The hook checker counted session-end rows from every tool for each tool, so a tool with no Stop hook run could still pass. It now counts only rows for that tool's own sessions, and accepts --tool codex.

Changed

Corrected the public hook claims: hooks ran in real sessions of Claude Code (two days of use), Command Code (one short session) and Codex CLI (one interactive session), all on the author's machine and one user; Cursor, Gemini CLI, Windsurf and OpenCode hooks have not run.

Aletheia 0.1.5

2026-10-28T00:00:00Z

Changed

A rule flagged for re-check now carries its reason and "Verify before applying." into synced rules files and into the session context an agent receives, not only into list_rules. The rule is still delivered. Reading a rules file back strips the note, so it never becomes part of the rule text.
Recorded the first real-hook evidence: hooks ran in real Claude Code sessions on the author's machine over two days (prompts and tool events captured, secrets redacted, no leaks), and the hook checker now counts summary memories as the Stop/SessionEnd signal with the session-end table as a fallback.

Aletheia 0.1.4

2026-10-28T00:00:00Z

Added

A graph retrieval channel and entity pages, off by default behind a flag. On a synthetic test it found related memories that keyword search missed; it has not been measured on real data.
Rule-based entity summaries and belief tracking. No model is used.
A file-read gate and a smart outline for files.
Rules keep their date, source and evidence. A rule made from an approved suggestion copies the suggestion's source ids and dated quotes; add_rule and POST /api/hub/rules accept evidence ids. Rules made before this have no evidence.
A rule is flagged for re-check, with reasons, when an evidence fact is superseded or expired, an evidence memory is dismissed, a newer fact covers the same subject and predicate, or nobody confirmed it within the review window (rules.reviewDays, default 90). It is a flag, never a deletion: the rule stays on and keeps syncing.
POST /api/hub/rules/:id/confirm, aletheia rules confirm <id> and the confirm_rule MCP tool (13 tools now) record that a rule is still right. aletheia rules retire <id> turns a rule off without deleting it.
GET /api/hub/rules returns evidence, last_confirmed_epoch, stale and reasons, with ?stale=1 and ?older_than_days=N filters. aletheia rules lint reports a stale rule as a warning.
aletheia rules diff and GET /api/hub/rules/diff show, per tool file, rules only in the store, only in the file or worded differently, with file and line. Read-only. The Rules page shows how many tools are out of sync.
older_than_days on the memory list, /v1/search and the search MCP tool, so pruning old memories is a query.
aletheia audit export and GET /v1/audit/export (admin token) stream the sync audit log as JSONL or CSV.

Changed

Search is faster at 50,000 memories: project-scoped p95 fell from 67.5 ms to 32.7 ms on a synthetic test, and all-projects p95 is 58.6 ms. On the real LoCoMo set, Recall@5 did not change.
fact_history and GET /v1/facts accept as_of as epoch milliseconds as well as ISO 8601.
The README lists all 13 MCP tools.
list_rules prints each rule's date, source, last-confirmed date and a [re-check: reason] marker. get_observations and the memory detail panel show the source (tool, session, origin) and the files a memory touched.

Aletheia 0.1.3

2026-10-27T00:00:00Z

Added

GET /v1/facts and the fact_history MCP tool: how a fact changed over time.
Search by file: files are indexed, with file and file_suffix filters on search and in the MCP search tool.
work_state_write and work_state_read MCP tools for named to-do lists per project.
Folder context files and a connector verification status in the tools view and in doctor.
glama.json, so the Glama listing can be claimed.
A settings page in the Tools tab, with a settings API that validates every value and never returns the API key.
A live feed, session pages and a context preview in the app.
Query and result caching for search.
Rule-based query expansion, round-level indexing, and since and until filters on search.

Changed

MCP tool definitions now carry annotations and parameter descriptions.
The README platform badge says Linux and macOS, which CI covers.

Aletheia 0.1.2

2026-10-27T00:00:00Z

Changed

The npm package now ships code and licence files only. Version 0.1.1 also shipped the whole docs/ tree by mistake.
Search filters, OpenAPI document, MCP registry server.json, and a crash-safety test.

Aletheia 0.1.1 (yanked)

2026-10-27T00:00:00Z

Withdrawn from npm and never tagged: the package also shipped the whole docs/ tree by mistake. Version 0.1.2 replaced it.

Added

docs/releasing.md: versioning policy, the release sequence with the owner-only steps marked, and rollback notes.
scripts/release.mjs --prepare <version> bumps package.json and dates the CHANGELOG section; --verify checks versions, the tag, tarball contents and size, and that README images are absolute https URLs.
.github/workflows/release.yml: on a v* tag it tests, verifies, publishes to npm only when trusted publishing or NPM_TOKEN is set up, and creates the GitHub release.

Changed

README top block redone for the npm package page: centred logo, npm version badge, install and run lines, two screenshots and a link row, all with absolute URLs. The ten translations were not re-translated for it.

Aletheia 0.1.0

2026-10-27T00:00:00Z

First public release, published to npm as aletheia-mem@0.1.0. CI runs on Linux and macOS; Windows is not supported yet.

Added

Generated comparison, tool-support and measured-number tables. scripts/gen-tables.mjs --check fails when a marked block drifts from its source (docs/28-competitor-report.json, the installer registry, or bench/results/).
README restructured with real badges only: licence, test workflow, last commit, stars, open issues, status, Bun version and the Linux-tested platform. A test rejects a forbidden badge or a hand-typed count.
Issue forms for bugs, features and new hosts; a pull request template with the validation checklist; Contributor Covenant 2.1; and a security policy that names GitHub private vulnerability reporting.
CI workflow that runs the test suite, the task checker, the table drift check and the documentation link checker on Linux only.
check:claims, check:links and check:tables scripts.