v0.2.1

# Release Notes for v0.2.1

  This release introduces **`memanto migrate`** a complete end-to-end migration command that imports memories from Mem0, Letta, and Supermemory (replacing the old `analyze` command), a new **`memanto forget`** endpoint for single-memory
  deletion, a production-ready **Claude Code Skills integration** with 8 composable skill templates for cross-session engineering memory and on-prem backend refinements.

  ## New Features

  - **`memanto migrate` command suite** (`memanto/cli/commands/migrate.py`,
    `memanto/cli/migrate/{mappers,runner}.py`)
    - Replaces the old `analyze` command with a full bidirectional migration
      workflow: export a provider's data (Mem0, Letta, Supermemory), map each
      source row onto Memanto memory types (auto-classified via the rule-based
      parser), bulk-write via `batch_remember` (100 items/request), and optionally
      generate a storage/token/latency savings report — all in one command.
    - Provider metadata (scope IDs, confidence scores, hashes) is preserved in a
      bounded `[Supporting data]` footer so nothing is lost; original
      `created_at`/`source`/`source_ref` map naturally onto schema.
    - `--dry-run` previews the mapping (shows types, confidence, tags) without
      writing. `--report` generates the Markdown comparison on real runs. Outputs
      live in `~/.memanto/migrate/<provider>/<timestamp>/` (separate from
      legacy `analyze/` artifacts).
    - Works on both cloud and on-prem backends; on-prem batch_remember respects
      the same chunking.

  - **`memanto forget` command and REST endpoint** (`memanto/app/routes/memory.py`,
    `memanto/cli/commands/memory.py`, `memanto/app/ui/static/index.html`)
    - New `DELETE /{agent_id}/memories/{memory_id}` endpoint for single-memory
      deletion. Checks session scope (session must own the agent) and removes the
      memory from Moorcheh.
    - CLI `memanto forget <memory_id>` for quick terminal deletion.
    - UI **Delete** button on each memory card in the Memory Explorer.

  - **Claude Code Skills integration** (`examples/claudecode-skills-memanto/`)
    - New full integration package (`memanto_skills` Python module + CLI
      entrypoint) that wires Memanto into Claude Code's extensible skill system.
      Every skill invocation can recall past engineering decisions and persist new
      ones — eliminating context resets at terminal close.
    - Eight pre-built skill templates (installed via `setup-memanto-skills`):
      - `tdd-with-memory`: TDD workflow with persisted test patterns
      - `grill-with-docs`: Code review with cached architectural decisions
      - `diagnose-with-memory`: Debugging with prior failure logs
      - `handoff-with-memory`: Pass context to teammates
      - `memanto-profile`: View/manage your engineering profile
      - `memanto-recall`: Direct memory search
      - `memanto-store`: Save arbitrary facts
    - CLI commands: `memanto-skills recall <skill> [--hint TEXT]`,
      `memanto-skills store <skill> "<insight>" [--type TYPE]`,
      `memanto-skills store-file <skill> <path>`, `memanto-skills profile`,
      `memanto-skills clear-agent`.
    - Skill definitions in `.claude-plugin/plugin.json` and `SKILL.md` per skill.
    - Includes session 1 & 2 demos showing before/after context fragmentation.


  ## Improvements

  - **On-prem backend enhancements** (`memanto/app/services/session_service.py`,
    `memanto/cli/commands/core.py`)
    - Session namespace creation now reuses existing namespace on-prem instead of
      error-ing when namespace already exists (idempotent namespace setup).
    - On-prem forget error messages are now clear and actionable (differentiate
      "memory not found" from "namespace issue").
    - On-prem threshold boundary checks fixed (no off-by-one on min similarity
      validation).

  - **Mapper robustness** (`memanto/cli/migrate/mappers.py`)
    - Mappers now extract **all** available info from source exports, including
      less-common fields like interaction hashes, scope IDs, and custom metadata,
      preserving them in the `[Supporting data]` footer for compliance and audit
      trails.

  - **Migrate + on-prem API key handling** (`memanto/app/routes/auth_deps.py`,
    `memanto/app/clients/moorcheh.py`)
    - Migrate command correctly propagates the API key dependency for on-prem
      backend (no double-init of backend client).

  ## Tests

  - New `tests/test_cli.py` coverage for `migrate` and `forget` commands
    (dry-run, report generation, single-memory delete flow).
  - New `tests/test_unit.py` coverage for mappers (all three providers) and
    session namespace idempotency.
  - Integration tests expanded across CrewAI and LangGraph tooling.

  ## Full Changelog

  Full Changelog: https://github.com/moorcheh-ai/memanto/compare/v0.2.0...v0.2.1