v1.8.0
Changelog
All notable changes to this project will be documented in this file.
[Unreleased]
[1.8.0] - 2026-04-11
Added
- Deployed skill packaging for no-clone installs, including runtime-safe
SKILL.mdandREFERENCE.mddeployment into<memoria-home>/.agents/memoria-memory-sync. - Release-time validation for deployed skill version alignment, required asset completeness, and repo-only instruction leakage.
Changed
setupnow ships a localbin/memoriawrapper with the deployed skill so installed agents can execute skill workflows without a cloned repo.- README, install guide, and release SOP now document deployed skill discovery, packaging guards, and no-clone release expectations.
[1.7.0] - 2026-04-07
Added
- Compiled wiki workflows for Memoria, including raw source import, generated
knowledge/index.md/log.md/overview.md, query file-back, and durable wiki lint findings. - Focused wiki coverage in CI for ingest, build, query filing, and governance lint flows.
Changed
- Agent guidance, operations docs, release SOP, and skill instructions now treat the compiled wiki as a first-class runtime workflow.
[1.6.0] - 2026-04-01
Added
- No-clone release packaging via
pnpm run release:package, including a Linux x64 runtime tarball with packagedbetter-sqlite3dependencies. - Artifact-based installer flow and no-clone end-to-end coverage for
preflight,setup --serve --json,remember, andrecall.
Changed
preflightandsetupnow distinguish repo mode from installed mode, so packaged runtimes no longer requirepnpmor repo-local dependency installation.- README, install guide, release SOP, and CI now document and validate the release-asset installation path.
[1.5.1] - 2026-04-01
Added
- Native ESM adapter runtime regression test at
scripts/test-adapter-runtime.shand CI coverage for bootstrap + adapter runtime verification.
Fixed
./cli setupnow resolves the project install directory from the CLI entrypoint instead ofMEMORIA_HOME, so bootstrap setup no longer runspnpm installin the wrong location.scripts/test-bootstrap.shnow resolves repo root correctly.BaseAdapternow constructsMemoriaClientwithout CommonJSrequire(), so URL-string configuration works under native ESM runtime.
Changed
- Release and operations docs now include the bootstrap + adapter runtime verification steps in the patch release SOP.
[1.5.0] - 2026-03-17
Added
- Adaptive retrieval gate for trivial recall queries (greetings, emoji-only messages, short confirmations) when no explicit recall mode or memory-intent phrase is present.
- Import guardrails that suppress exact duplicate events within a session and derive a better session summary from higher-signal events when the provided summary is trivial.
- Lightweight scope isolation: sessions can carry optional
scope, which defaults toproject:<project>orglobal, and recall/index flows can filter by scope. - Governance review command (
memoria govern review) for deterministic surfacing of repeated decisions and skills worth extracting.
Changed
- Recall telemetry and stats now include
route_mode=skippedwhen adaptive retrieval intentionally bypasses lookup.
[1.4.0] - 2026-03-03
Added
- Time-decay scoring for recall: memory relevance now decreases with age using
1 / (1 + age/halfLife)(halfLife=90 days). Newer memories rank higher when token match is equal. - Keyword recall (
recallKeyword) now computes relevance scores and sorts by score instead of timestamp-only ordering. - Recall hit tracking:
recallTreeupdateslast_synced_aton matchedmemory_nodesfor stale detection. prune --consolidate-days <N>: merges old session nodes under the same topic node (keeps newest, removes ≥3 old children).prune --stale-days <N>: removesmemory_nodes(level=2) never recalled and orphan sessions older than N days.prune --allnow includes--consolidate-days 90and--stale-days 180by default.
Changed
scoreNode()accepts optional timestamp parameter for time-decay weighting.recallKeyword()return type now includesscorefield.recall()inMemoriaCoreno longer synthesises position-based scores; uses actual computed scores.
[1.3.0] - 2026-02-26
Added
- Tree memory index schema (
memory_nodes,memory_node_sources) andmemoria index buildcommand. - Tree/hybrid recall mode with explainable
reasoning_pathmetadata. - Recall routing telemetry with aggregated stats and raw API endpoint (
GET /v1/telemetry/recall). - MCP sync cursor state (
memory_sync_state) and post-ingest cursor commit script. - Incremental MCP payload mode (
MEMORIA_MCP_PAYLOAD_MODE=incremental, default) with compatibility fallback tofull.
Changed
memoria syncnow auto-builds incremental tree index by default (MEMORIA_INDEX_AUTOBUILD=0to disable).- Hybrid MCP flow now supports true no-op second sync (entities/relations unchanged when no deltas).
memoria statsnow reports 7-day recall routing quality (fallback rate, route counts, latency, hit count).- Operations and MCP docs updated for tree recall observability and incremental sync controls.
[1.2.0] - 2026-02-14
Added
memoria sync --dry-runfor validation and write-preview without mutating files.memoria statscommand for sessions/events/skills summary and top skills.memoria verifycommand for runtime/schema/writeability validation with--jsonoutput.- Agent Skill at
skills/memoria-memory-sync/SKILL.mdwith references, resources, and helper scripts. - Hybrid MCP bridge automation (
run-sync-with-enhancement.sh) for optionalmcp-memory-libsqlingestion. - Installer preflight checks for common container tools (
node,pnpm,npm,git,unzip,python3). - Explicit path env support:
MEMORIA_DB_PATH,MEMORIA_SESSIONS_PATH,MEMORIA_CONFIG_PATH. - Bundled CLI build output at
dist/cli.mjswithpnpm run build.
Changed
- Session JSON parsing now validates schema with clearer error messages.
- README now documents dry-run and stats command usage.
- Documentation now includes agentskills integration and MCP/libSQL auto-ingest workflow.
- Installer now supports npm fallback and
--minimal/--no-gitmodes. - CLI launcher now works with pnpm or npm (no hard pnpm requirement at runtime).
./clinow prefers built artifact (dist/cli.mjs) when available.
[1.1.1] - 2026-02-13
Added
- GitHub Actions CI workflow for TypeScript and shell validation.
- Smoke test script at
scripts/test-smoke.shfor end-to-endinit+syncverification. SECURITY.mdwith private reporting and open-source data safety guidance.- MIT
LICENSEfile.
Changed
- Documentation now includes open-source safety guidance and sample sync test flow.
[1.1.0] - 2026-02-13
Added
- TypeScript CLI (
cli,src/cli.ts) withinit,sync, anddoctorcommands. - Sample session file at
examples/session.sample.json.
Changed
- Install and hook flow updated to TS-only runtime.
- Path handling aligned around
MEMORIA_HOME. - Ignore rules hardened for safer open-source sharing.