v0.7.0

[0.7.0] - 2026-10-08

Part of the coordinated MIF (Modeled Information Format) 1.4.2 release.
mnemonic targets MIF 1.4.2; its schemas are byte-identical to MIF 1.4.1, so
the 1.4.1 forms and section references below apply unchanged.
Memories written by earlier releases keep working unchanged: every legacy
form below is still read, and validators report it as a warning, never an
error.

Changed

• [MIF 1.4.1 write forms]: New memories, templates and library writers
  use MIF 1.4.1 spellings
  • camelCase concept frontmatter keys (MIF 1.4.1 section 3.3): validFrom,
    recordedAt, lastAccessed, decay.halfLife, provenance.sourceType,
    compressedAt, codeRefs, ...
  • provenance.sourceType values from the MIF enum (user_explicit,
    user_implicit, agent_inferred, external_import, system_generated)
  • capture templates nest confidence, strength, halfLife,
    lastAccessed and the decay model under provenance / temporal
    instead of writing them at the top level
  • relationships: kebab-case type tokens (relates-to, superseded-by),
    urn:mif:<uuid> targets, metadata.label, and every frontmatter
    relationship mirrored as a Markdown link under ## Relationships
    (section 5.3) instead of [[uuid]] wiki-links
  • citations: citationType, citationRole, "@type": Citation
• [Tolerant readers]: New lib/mif_compat.py resolves legacy and new
  spellings identically, preferring the new one. Used by the memory reader,
  relationship writer (legacy entries count as duplicates), custodian
  (decay, validators, link checker, bidirectional check) and
  mnemonic-validate
• [Ontology resolution]: Ontologies load from MIF 1.4.1 locations first
  (project .mif/ontologies/, user ~/.mif/ontologies/, ontology.yaml or
  *.ontology.yaml), falling back to the previous
  .claude/mnemonic/ontology.yaml and ${MNEMONIC_ROOT}/.../ontology.yaml
  locations (section 10.8.5)
• [Vendored ontology schema]: skills/ontology/fallback/schema/ontology/
  re-vendored verbatim from MIF 1.4.1; the previous copy matched no MIF
  release
• [Naming]: "MIF" is the Modeled Information Format (was misnamed
  "Memory Interchange Format" in README, docs, ADR-002)
• [mnemonic-validate]: Warns (does not fail) on legacy keys, legacy
  sourceType values, non-kebab relationship types, relationship label
  outside metadata, unmirrored relationships, wiki-link relationship lines
  and citations without citationType / citationRole; validates
  compressedAt in either spelling
• [Versioning]: pyproject.toml version realigned to the plugin
  release lineage (was 1.6.0, out of step with plugin.json and this
  changelog); both now read 0.7.0
• [MIF 1.4.2 target]: README, docs, the format skill and the vendored
  ontology schema provenance now name MIF 1.4.2 as the target release

Added

• [mnemonic-migrate-mif]: Opt-in tool that upgrades legacy memory files
  to the MIF 1.4.1 forms above. Dry run by default; --apply writes each
  changed file atomically after saving <file>.pre-mif-1.4.1.bak. Never
  renames files, never guesses values (legacy sourceType values, missing
  citationRole), and never overwrites a key whose camelCase twin exists.
  Not run automatically

• [Semantic Search]: QMD integration for vector and hybrid search

  • New skill /mnemonic:qmd-setup for automated setup
  • New skill /mnemonic:qmd-reindex for re-indexing after captures
  • Supports BM25 keyword, vector semantic, and hybrid search modes
  • Auto-discovers memory roots from config
  • Registered collections: org-level, default, and project-level memories
  • See docs/semantic-search.md for details

Planned

• Export/import functionality
• Web UI for memory browsing

v0.6.1

Release v0.6.1: MIF Spec Migration, Version Rewrite

Changed

• [MIF Spec Migration]: Replaced MIF git submodule with canonical mif-spec.dev schemas
  • Removed mif git submodule and .gitmodules
  • Bundled fallback ontologies are now the primary source (no submodule required)
  • All schema $id and schema_url references updated to https://mif-spec.dev/schema/
  • OntologyLoader resolution order simplified: bundled fallback -> user -> project
  • OntologyLoader exposes MIF_SCHEMA_URL and ONTOLOGY_SCHEMA_URL class constants

Removed

• [MIF Submodule]: Git submodule mif (https://github.com/zircote/MIF.git)
• [populate_fallback.py]: Obsolete script for copying from submodule to fallback

v0.6.0

Release v0.6.0: Capture Validation, Relationship Type Registry

Added

• Capture validation: namespace and memory type validation against ontology registry
• Relationship validation: type-safe management with bidirectional back-ref checks
• Relationship type registry: 9 core types with inverse mapping (lib/relationships.py)
• Team audit command: /mnemonic:team-audit
• Test coverage: 397 tests (up from 308)

Fixed

• Blank line accumulation in add_relationship() reassembly
• Namespace validation for unknown sub-namespaces
• Import cleanup across lib and tests

Changed

• Hook refactoring: all hooks import from shared lib/ modules
• Version lineage corrected to v0.x series

v0.5.0

Release v0.5.0: Shared Lib Modules, Relationship Registry, 397 Tests

Added

• Shared library modules: lib/ontology.py, lib/search.py, lib/memory_reader.py, lib/relationships.py
• Relationship write path with bidirectional linking
• Session-scoped blackboard isolation
• CLI path tool: tools/mnemonic-paths
• Configurable memory store via ~/.config/mnemonic/config.json
• 308 unit tests

Changed

• Hook refactoring: all hooks import from shared lib/ modules
• DRY refactoring: eliminated duplicated code across hooks
• Unified path alignment with $MNEMONIC_ROOT
• Claude Code exclusive identity (multi-tool references removed)

v0.4.0

Release v0.4.0: Custodian Skill, Unified Paths, Slug-Only Filenames

Added

• Custodian skill: unified memory maintenance (/mnemonic:custodian)
• Filename migration: auto-migration from UUID-prefixed to slug-only format
• Ontology discovery: enhanced pattern-based entity discovery
• Integration skill: Python-based memory integration with test suite
• Cognitive triad namespaces: _semantic/, _episodic/, _procedural/
• Path resolution library: centralized lib/paths.py

Changed

• Slug-only file naming ({slug}.memory.md)
• Unified path structure under ~/.claude/mnemonic/
• MIF spec alignment with ontology definitions