@fozikio/tools-maintenance

Memory maintenance plugin for cortex-engine. Retrieve, fade, deduplicate, and audit memories. Monitor consolidation health and sleep pressure.

Install

npm install @fozikio/tools-maintenance

Tools

Tool	Description
retrieve	Fetch a memory by ID or perform semantic search with text
forget	Intentionally reduce a concept's salience via FSRS lapse scheduling (fading, not deletion)
find_duplicates	Detect near-duplicate memories using embedding similarity above a threshold
sleep_pressure	Read unconsolidated observation count, last dream time, and hours since last dream
consolidation_status	Report last dream summary, quality trend, and current consolidation metrics
retrieval_audit	Analyze retrieval traces to find routing patterns and misfiring heuristics

Usage

# cortex-engine config
plugins:
  - package: "@fozikio/tools-maintenance"

import maintenancePlugin from "@fozikio/tools-maintenance";
import { CortexEngine } from "cortex-engine";

const engine = new CortexEngine({
  plugins: [maintenancePlugin],
});

Documentation

• Wiki — Guides, architecture, and full tool reference
• Plugin Authoring — Build your own plugins
• Contributing — How to contribute

License

MIT