@dzhechkov/memory

The harness memory layer — records skill outcomes, ranks skills, and imports host memory files.

What it provides

| Module | Exports | Purpose | |---|---|---| | backend | MemoryBackend, MemoryRecord, MemoryQuery | The storage contract | | json-backend | JsonFileBackend | The default backend — pure JS, zero-dependency, JSON-file persistence, scored keyword retrieval | | cascade | selectBackend, BackendProbe | Probe optional backends, fall back gracefully | | reflexion | Reflexion | Record skill outcomes (record(skillId, outcome, score)); rank skills | | bridge | MemoryBridge, importMemoryMarkdown | Import a host memory markdown file into MemoryRecords |

Backend strategy

The default JsonFileBackend is pure JavaScript with zero dependencies — no native build, no WASM, no model download — so it works everywhere and is fully testable.

selectBackend is the cascade: it probes a list of optional backends (a vector/embedding backend can be registered here later) and falls back to a guaranteed backend if none is available. Heavier backends (agentdb, sql.js) are intentionally not hard dependencies — see features/extended-a-migration/autonomous-log/decisions.md (D7.1).

Status

0.1.0 — alpha, part of the extended-a-migration feature (Phase 7).