This update introduces terms-v13 and terms-v14 scorers, significantly refining how the server ranks authoritative domain declarations and stored-token enums in PHP projects. It also synchronizes the Claude MCP plugin to v1.0.2, ensuring users get the latest improvements and compatibility fixes across the entire ecosystem.

This release upgrades the PHP compatibility evaluator to terms-v14, integrating refined ranking logic for authoritative domain declarations. By effectively scoping consumer detection and introducing specific intent-based guards for stored-token domain definitions, the implementation improves retrieval accuracy across complex PHP relationship contexts. The update also bumps the core Memento plugin to match the new server version for consistency.

Updated Memento MCP to version 1.0.2, bumping versions across manifests and the launcher configuration. This maintenance release ensures the plugin correctly references the latest server release.

This update promotes the previously advisory membership-freeze judgment to training and implements terms-v14 to better identify authoritative domain definitions. It refines the scorer to use provider-scoped intent for these definitions and excludes specific classifier vocabulary from the lexical search to prioritize correct domain term matching. A new independent holdout corpus for cold-chain disposition has been added, maintaining the scorer's robustness against complex, similar domain/presenter structures.

This update introduces terms-v13, which adds guarded ranking for stored-token domain definitions to improve retrieval precision. It ensures that queries accurately identify authoritative enum declarations while strictly excluding consumer-clause references, like serializers or presenters, from triggering these bonuses. These refinements were validated against new holdout benchmarks, maintaining the rigorous evaluation standards for the PHP compatibility suite.

The Memento Claude plugin has been updated to version 1.0.1 across the repository, reflecting the latest stable release. This update ensures documentation, manifest files, and launcher configurations correctly point to the new version.

This release introduces adaptive Git polling, which dynamically adjusts the polling frequency based on repository activity to improve resource efficiency. The interval now backs off from 2 seconds to a maximum of 30 seconds when idle, while automatically resetting to 2 seconds upon tool activity or new git changes. Additionally, per-process jitter has been added to prevent synchronized scanning across concurrent sessions, and the system now correctly recognizes linked worktrees without shelling out to Git.

We've upgraded the Git polling mechanism to be more adaptive, reducing resource usage on idle repositories while maintaining quick responsiveness. The polling interval now dynamically increases (from 2s up to 30s) during quiet periods and automatically resets to the fast 'hot' interval upon user activity or changes. Additionally, we've implemented jitter to prevent synchronized load and improved error resilience with a backoff strategy capped at 60 seconds.

Updated the retrieval evaluation baseline to incorporate recent documentation shifts and ensure continued benchmark integrity. The committed metrics remain consistent, reflecting only necessary anchor-only adjustments to keep the evaluation fixtures aligned with the current repository structure.

This milestone release marks v1.0.0 of the memento-mcp server, introducing significant architectural improvements like per-project child server auto-spawning for better workspace isolation, syntax-aware chunking with tree-sitter, and robust PHP/Composer compatibility. We've also added intent-aware repository context tools, credential-free workflow plugins for those preferring non-binary setups, and comprehensive evaluation harnesses for semantic and helpfulness metrics. This release solidifies Memento as a durable, language-aware memory companion that stays out of your way while keeping your agent grounded.

This update introduces version 12 of the term-aware retrieval scorer, which improves PHP durable-catalog ranking by filtering out high-confidence intent vocabulary during lexical competition. Additionally, the indexer's change detection strategy now defaults to Git polling for efficiency in Git worktrees, falling back to a recursive filesystem watcher only when necessary. These refinements enhance both search precision and indexing reliability.

This update introduces terms-v11 to improve the retrieval of backed-enum definitions when queries involve "durable catalog spellings." The scorer now recognizes synonym-gated enum headers and allows for additional structural units in those specific cases, while explicitly rejecting consumer loci to prevent misranking. This change promotes previous advisory evidence to training data and adds a new independent holdout query to track ongoing improvements.

This update introduces terms-v10, which generalizes how PHP domain value definitions are ranked by recognizing serialized closed-domain definitions compositionally. By requiring specific signals, this change improves ranking accuracy for domain enums, successfully moving previously observed transit-disposition misses to rank one. The update also adds a new advisory holdout case to ensure continued robustness against synonym gaps in domain-mapping language.

This update elevates PHP code retrieval by incorporating structural relationship evidence into the ranking algorithm. Using direct edges to prioritize provider-consumer pairs—such as enum definitions versus their presenters and shutdown hooks versus service handlers—this change eliminates residual ranking misses revealed by previous holdout evaluations. The implementation introduces a bounded RelationshipProvider that promotes lexically matched candidates during search, ensuring stable, deterministic results while maintaining high recall.

This release upgrades the retrieval scorer to terms-v8, significantly improving structural retrieval accuracy for complex PHP declarations and collection associations by training on isolated holdouts. We've also streamlined the installation process with a new verified installer that includes automated, idempotent client configuration for Codex and Claude Code. Developers will now notice improved context resolution, especially for framework-heavy projects, and faster onboarding with the new memento-mcp doctor command.

This release adds a fully verified, atomic installer script for memento-mcp, providing built-in sidecar SHA-256 validation, staged preflight testing, and atomic atomicity during CLI registration. It also ships the terms-v8 scorer, which significantly improves PHP compatibility retrieval precision and recall across framework-level associations and configuration definitions, as documented in new ADRs 0014 and 0015.

This release brings deep PHP support, including tree-sitter parsing for declarations, Composer autoloading, and framework relationships. We have introduced declaration-aware terms-v3 retrieval, complete with exact answer-line evaluation, hard-negative filtering, and robust train/validation/holdout splits for improved context accuracy. Additionally, binaries for all platforms are now checksum-protected, and the CI pipeline rigorously validates asset consistency before publishing.

Updated the release workflow and test suite to mandate precise validation checks for macOS release assets. The CI pipeline now explicitly verifies that all expected artifacts (including optional signed and notarized packages) are present and checksum-validated before finalizing a release.

This update makes macOS signing and notarization optional for server releases, controlled by an MACOS_NOTARIZATION_ENABLED repository variable. Raw macOS binaries are now consistently built for all release versions, while .pkg installers are generated only when notarization is enabled. This provides greater flexibility for development and local testing workflows while maintaining secure production standards.

We have officially prepared the release for server v0.10.0. This update involves bumping the version across the plugin manifest, marketplace configuration, and the launcher script. Testing configurations were also updated to ensure proper validation of the new release version.