Locus v3.7.0 Release Notes
v3.7.0 is the Track D Codex memory reliability release.
It keeps the Track C richer recall work and adds stronger project isolation, date-aware recall, calendar discovery, freshness diagnostics, and current project-state summaries.
Added
- Project-scoped recall/search/timeline over Codex conversation events, semantic memories, and durable memories.
- Date-aware recall metadata:
localDate,weekKey,monthKey, resolved ranges, and searched date buckets. memory_calendarfor day/week/month activity buckets before drilling into a broad period question.memory_project_statefor normalized project root/hash, package metadata, git state, latest project conversation timestamp, active durable counts, warnings, and active next steps.- Codex freshness diagnostics in
memory_statusandmemory_doctor, including latest rollout timestamp versus latest imported event timestamp. - Codex surface diagnostics with
LOCUS_CODEX_SURFACE=desktop|extension|clias a diagnostic/debug override. - Same-topic durable lifecycle behavior where positive validation facts can supersede active Track D next steps.
Fixed
- Existing legacy durable memories with
NULL project_rootcan be used as a bounded fallback when strict scoped durable recall finds no current-project row. - Legacy V1 semantic memory tables without
project_rootremain writable before migration repair. - Hook subprocess tests now use an isolated test storage root instead of writing to the user's live Codex storage path.
Validation
- Focused Track D gate:
32files passed,297tests passed. - Full repository gate:
npm run checkpassed with122files and1343tests. - Build gate:
npm run buildpassed and regenerateddist/cli.jsanddist/server.js. - Local npm package smoke:
npm packproducedlocus-memory-3.7.0.tgzwith12intended runtime files.- The tarball contains fresh
dist, Codex README/config, canonical skill, plugin.mcp.json, plugin manifest, plugin skill, and these release notes. - Package and plugin manifest versions inside the tarball are both
3.7.0. - A clean temp install from the tarball reported
locus-memory --versionas3.7.0. - Pre-publish
install codex --yespassed withLOCUS_CODEX_RUNTIME_PACKAGE=<tgz>and a tempCODEX_HOME, configuring MCP throughnpm exec --package <tgz> -- locus-memory mcp.
- Registry npm package smoke:
npm view locus-memory@3.7.0 versionreturned3.7.0.npm view locus-memory dist-tags --jsonreturned"latest": "3.7.0".- A clean registry install from
C:\tmp\locus-registry-smoke-3.7.0reportednpx --yes locus-memory@3.7.0 --versionas3.7.0. npx --yes locus-memory@3.7.0 install codex --yescompleted with an isolatedCODEX_HOME.codex mcp get locusshowedcommand: npx.cmdandargs: -y locus-memory@3.7.0 mcp.
- Runtime smoke:
- PATH Codex CLI reported
codex-cli 0.138.0. - Codex Desktop-bundled CLI reported
codex-cli 0.137.0-alpha.4. - With
CODEX_HOME=C:\Users\Admin\.codex,codex mcp listandcodex mcp get locusconfirmedlocusis enabled and points at this repo'sdist/server.js. - The active Desktop MCP session answered
memory_status,memory_doctor, andmemory_recall, but still exposed the previous tool registry until reload; new live tools such asmemory_calendarandmemory_project_staterequire MCP/Desktop session reload before a live smoke can claim them.
- PATH Codex CLI reported
Known Boundaries
- Codex CLI remains the primary validated path.
- Codex Desktop MCP marker behavior is covered by Track D tests and local MCP config smoke; live Desktop sessions may need a reload to expose new tool schemas.
- Codex extension parity remains target-surface validation work.
LOCUS_CODEX_SURFACEis diagnostic/debug configuration, not normal user-facing setup.- Richer evidence-anchor display for commits, files, docs, command results, and timestamps remains a follow-up.
- Topic keys are isolated by
projectRoot; separate user-configurable topic namespace filters remain a follow-up unless project-root isolation proves insufficient. LOCUS_CODEX_RUNTIME_PACKAGEis release-validation-only for local tarball smoke; published user installs should use the default pinned registry runtime.