@kaged/memory-hindsight

Reference ceiling project plugin for agent memory — Hindsight-backed vector-graph-temporal memory with reflect synthesis, auto-retain, and compactor-grade compaction

8
source files
5
test files
~1.9k
lines
✓ 34 pass
tests
pass
typecheck
clean
lint

Test results 34

deriveBankId > static mode uses project id by default [0.210ms]
deriveBankId > static mode respects configured bank id and prefix [0.050ms]
deriveBankId > dynamic mode composes configured granularity [0.150ms]
deriveBankId > project isolation collapses dynamic ids to project only [0.040ms]
ensureBankMission > is idempotent [0.440ms]
ensureBankMission > caps the tracked mission set [3.71ms]
DEFAULT_CONFIG > matches manifest defaults [0.070ms]
mergeConfig > project overrides defaults and system overrides project [0.060ms]
debugLog > is silent when debug=false [0.040ms]
stripMemoryTags > removes hindsight and plugin tag blocks [0.150ms]
formatMemories > formats mixed entries [0.110ms]
composeRecallQuery > single-turn mode returns latest query [0.080ms]
composeRecallQuery > multi-turn mode includes prior context [0.100ms]
truncateRecallQuery > preserves latest query when truncating [0.200ms]
prepareRetentionTranscript > formats full window [0.120ms]
prepareRetentionTranscript > formats last turn only when requested [0.110ms]
sliceLastTurnsByUserBoundary > slices to last N user turns [0.060ms]
handleRetain > stores memory on success [0.360ms]
handleRetain > returns tool error on api failure [0.190ms]
handleRecall > formats successful results [0.390ms]
handleRecall > returns empty message for empty results [0.110ms]
handleReflect > returns synthesized answer [0.260ms]
handleReflect > returns empty reflection message [0.110ms]
handleOnSessionStart > auto_recall injects memories [0.320ms]
handleOnSessionStart > disabled auto_recall returns empty [0.120ms]
handleOnSessionIdle > retains only when enough new turns exist [0.470ms]
handleOnSessionIdle > supports last-turn mode [0.330ms]
handleOnCompact > observer injects recall results [0.450ms]
handleOnCompact > compactor retains, resets turn tracking, and appends injection [0.380ms]
initialize > returns manifest-facing metadata [0.490ms]
initialize > accepts initialized notification silently [0.110ms]
json-rpc routing > routes tool methods and hooks [0.930ms]
invalid input > handles parse, invalid request, missing method, and unknown method [0.260ms]
context extraction > uses defaults when _context is missing [0.050ms]

Mentioned in

Type Document
adr ADR-0023: Project-plugin lifecycle hooks, per-agent declaration, isolation as a core principle
adr ADR-0024: Context compaction is kaged-owned, layered, observable, and operator-tunable
spec Spec: Local config
spec Spec: Plugin Host