Skip to content

v0.1.14

Choose a tag to compare

@github-actions github-actions released this 08 Jun 13:19
· 1158 commits to master since this release

v0.1.14 focuses on stable CLI, storage, and entity-graph behavior.

Note: harness modules, harness documentation, and harness evaluation assets in this repository remain experimental and are not part of this release's public stability guarantee.

Highlights

  • Known-entity extraction now has an index-aware path that improves recall for seeded project names, internal codenames, and single-segment CamelCase entities without globally loosening first-mention extraction.
  • Embedding blobs are stored as little-endian float32 values going forward, reducing embedding storage size by roughly half while preserving float64 vector APIs and cosine calculations.
  • Claude Code setup now handles the $HOME/.claude collision case by writing absolute hook commands when an apparent project-local install is actually the user-global Claude config.

Added

  • Entity extraction now admits wider candidate tokens when they already exist in Mnemon's known-entity index. This lets a name seeded through provided entities or earlier extraction propagate through later insights and queries without treating arbitrary new wide tokens as first-class entities.
  • Store support for loading known entities from active insights. The graph engine uses this index to seed the new extraction path while continuing to ignore soft-deleted records.

Changed

  • New embeddings are serialized as float32 blobs instead of float64 blobs. For common 768-dimensional embeddings, this lowers each stored embedding from 6144 bytes to 3072 bytes.
  • Existing official databases migrate legacy float64 embedding blobs to float32 on open. The migration records completion in SQLite PRAGMA user_version and leaves malformed or non-legacy-looking blobs untouched rather than blocking startup.

Fixed

  • Running mnemon setup for Claude Code from $HOME no longer writes relative hook commands into the user-global ~/.claude/settings.json. Mnemon now detects this collision, resolves symlinks, honors CLAUDE_CONFIG_DIR, and writes absolute hook paths so hooks work from any future session directory.
  • Genuine project-local Claude Code installs continue to use relative hook commands, preserving the existing local-project behavior.

Tests and Validation

  • Added vector serialization tests for float32 round trips, invalid blob lengths, and legacy float64 deserialization.
  • Added store migration tests for normal legacy embeddings, malformed blobs, and non-legacy-looking blobs that should be skipped.
  • Added entity extraction and store tests for known-entity propagation and soft-delete filtering.
  • Release validation completed successfully:
    • go build -o mnemon .
    • make test (147 E2E checks)
    • go test ./... in a clean worktree
    • GitHub Release workflow for v0.1.14
    • GitHub master CI for commit 52fdd88

Artifacts

  • macOS: mnemon_0.1.14_darwin_amd64.tar.gz, mnemon_0.1.14_darwin_arm64.tar.gz
  • Linux: mnemon_0.1.14_linux_amd64.tar.gz, mnemon_0.1.14_linux_arm64.tar.gz
  • Windows: mnemon_0.1.14_windows_amd64.zip
  • Checksums: checksums.txt
  • Homebrew tap updated via GoReleaser.

Changelog

  • 9edfc4a Switch to float32 for storage (#55)
  • 545f625 feat(graph): add index-aware fourth path to entity extraction
  • 1982cff fix(setup): guard against project-local install colliding with the user-global Claude config (#53)