v0.1.12

v0.1.12 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.

Changelog

• efbbd85 fix(setup): align OpenClaw prompt path with MNEMON_DATA_DIR
• dd1d61d fix(setup): scope prompt files to MNEMON_DATA_DIR (#42)

v0.1.11

v0.1.11 improves the documentation and installed agent guidance around the mnemon import workflow introduced in v0.1.10.

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

Import guide internationalization

• Reworked docs/IMPORT.md into the English canonical import guide.
• Added docs/zh/IMPORT.md as the Chinese import guide with the same schema reference, examples, command usage, output explanation, FAQ, and LLM extraction prompt.
• Added language-switch links between the English and Chinese import guides.
• Linked the import guide from both README documentation indexes.

Setup skill guidance for import workflows

• Updated the installed mnemon skill templates for Codex, Claude Code, Nanobot, and OpenClaw.
• Added mnemon import --dry-run <file> and mnemon import <file> to each skill's command list.
• Added a short “Import Historical Chats” workflow so host agents know how to:
  • create a memory_draft.json with schema_version: "1"
  • include insight fields such as content, category, importance, tags, entities, and optional created_at
  • include optional explicit edges with source_index, target_index, edge_type, weight, and reason
  • validate with mnemon import --dry-run before writing
  • verify imports with mnemon status, mnemon search, or mnemon recall
  • check the errors field because imports can partially succeed

Validation

• go test ./...
• go build -o mnemon .
• git diff --check
• Release workflow passed make build and make test.

Links

• Full changelog: v0.1.10...v0.1.11

v0.1.10

v0.1.10 adds the first supported workflow for importing historical chat exports into Mnemon memory, plus a small Claude setup fix included since v0.1.9.

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

Historical memory import

• Added mnemon import <file> for bulk-importing memory draft JSON files into the active or selected store.
• Imported insights go through Mnemon's normal write behavior: duplicate/conflict detection, embedding generation when Ollama is available, entity/causal/semantic graph construction, lifecycle scoring, and automatic capacity pruning.
• Added mnemon import --dry-run to validate a draft without writing to SQLite.
• Added mnemon import --no-diff for trusted imports where every draft item should be inserted as new memory.

Versioned draft schema

• Added the schema_version: "1" memory draft schema under internal/importdraft.
• Draft files support top-level source, an insights array, and optional explicit edges.
• Insight fields include content, category, importance, tags, entities, per-insight source, and RFC 3339 created_at for preserving historical timestamps.
• Explicit edges use source_index, target_index, edge_type, weight, and optional reason, allowing LLM-generated imports to preserve strong relationships that heuristics may not infer.

Import documentation and LLM prompt

• Added docs/IMPORT.md with the full draft schema reference, field constraints, category guidance, importance guidance, edge-type guidance, examples, and operational notes.
• Included a copy-paste LLM extraction prompt for converting chat exports or notes into memory_draft.json.
• Updated docs/USAGE.md with the new import command examples.

Correctness fixes in the import path

• Historical imports no longer corrupt temporal ordering when importing older created_at memories into a store that already contains newer memories.
• The import path disables real-time temporal edge generation during writes, then repairs affected source timelines after all backdated insights are inserted so the imported memories are placed into the global chronological chain.
• Explicit draft edges now affect effective_importance before pruning. Import finalization inserts explicit edges, repairs temporal edges, refreshes touched insight scores, and only then runs AutoPrune.

Internal changes

• Added internal graph.EngineOptions and TemporalMode so import can skip real-time temporal edge generation without changing mnemon remember behavior.
• Added store helpers for source-ordered active insight scans and typed single-edge deletion, used by temporal repair.

Validation

• Added unit tests for draft validation, including required content, category and importance constraints, RFC 3339 timestamps, edge index bounds, and source fallback behavior.
• Added command integration tests for backdated temporal repair and effective-importance refresh after explicit draft edges.
• Release workflow passed make build and make test; local release prep also passed go test ./..., go build -o mnemon ., and git diff --check.

Also included since v0.1.9

• Fixed Claude setup to use a valid memory subagent type (#40).

Links

• Import PR: #41
• Related issue: #32
• Full changelog: v0.1.9...v0.1.10

v0.1.9

v0.1.9 makes mnemon recall lighter for routine agent use.

Changed

• BREAKING: mnemon recall now returns a compact JSON shape by default instead of the previous full debug payload.
• Default recall results now include the fields agents usually need: id, content, category, importance, intent, matched_via, confidence, and rounded score.
• Verbose/debug fields such as signals, timestamps, access_count, tags, entities, source, traversal metadata, and the full embedded insight object are omitted from the default output.

Migration

• Use mnemon recall <query> --verbose to restore the previous full payload shape.
• Scripts or SDKs that parse paths like .results[].insight.id, .results[].signals, or .meta should either add --verbose or migrate to the new compact fields.

Notes

• --basic recall output is unchanged.
• Stored data and the SQLite schema are unchanged; this is a CLI JSON output contract change only.
• Harness modules and harness evaluation assets remain experimental and are not part of this release public stability guarantee.

Changelog

• feat(recall): make default output LLM-friendly
• docs(release): prepare v0.1.9 notes

v0.1.8

v0.1.8 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.

Changelog

• f443aef docs(release): prepare v0.1.8 notes
• 638fdf6 feat(embed): add --embed-model CLI flag for runtime model override (#37)

v0.1.7

v0.1.7 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.

Changelog

• 6aa0751 docs(site): simplify lifecycle control plane model
• ced6cba feat(docs): add rendered docs navigation
• cd94385 feat: add privacy-safe memory receipts
• 4f7b827 fix: skip writes in IncrementAccessCount and LogOp when read-only

v0.1.6

v0.1.6 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.

Changelog

• 2269b43 chore(release): prepare v0.1.6 notes
• 7618e0d docs(contributing): centralize changelog updates at release time
• 3acdc34 feat(setup): add Codex integration
• 1e11a0d feat: Add Nanobot support
• 623426d fix: address nanobot PR review feedback

v0.1.5

v0.1.5 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.

Changelog

• 25cda94 chore(release): prepare v0.1.5 notes
• d70697a fix: raise cosine dedup threshold to prevent same-domain false UPDATE
• da43bfa fix: remove 'not' from negation words, gate conflict check at similarity>=0.7
• 439ca22 fix: sort diff matches by similarity
• 8dc68a9 fix: use Jaccard similarity in dedup to prevent same-domain false UPDATE

v0.1.4

v0.1.4 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 the v0.1.4 public stability guarantee.

Added

• remember --entity-mode to choose merge, provided, or auto entity handling.

Fixed

• Store name validation for resolved store paths.
• Query limit validation for recall and related command paths.
• Sidecar migration error reporting.
• Setup integration cleanup reliability.

Other

• Deployment environment configuration updates.

v0.1.3

Changelog

• e57a122 Add MNEMON_EMBED_DIMENSIONS for Matryoshka dimension truncation Support Matryoshka Representation Learning by passing the dimensions parameter to Ollama's /api/embed endpoint. When MNEMON_EMBED_DIMENSIONS is set (e.g., 256), Ollama truncates and re-normalizes the embedding vector, giving faster similarity search with minimal quality loss on MRL-trained models like nomic-embed-text. Backward compatible: when unset, behavior is identical to before.
• 7d6e33c Apply gofmt -s across codebase for Go Report Card A+
• f36a883 NanoClaw integration: read-only DB, skill assets, and docs
• 91e44dc NanoClaw skill: add lifecycle hook injection (prime/remind/nudge/compact)
• 39bfb5d feat: support MNEMON_DATA_DIR env var for data directory override