Graphorin API reference v0.7.0

---

Graphorin API reference / @graphorin/memory / / DecayMemoryStoreExt

Interface: DecayMemoryStoreExt

Defined in: packages/memory/src/internal/storage-adapter.ts:576

Decay-aware extension of the typed SemanticMemoryStore. Phase 10c's light phase reads the strength + last-accessed columns and archives facts whose retention curve falls below the configured threshold. Adapters that do not maintain decay columns may omit the surface entirely - the light phase skips the archive step with an INFO log.

Stable

Methods

archiveFact()

archiveFact(
   id, 
   reason?, 
scope?): Promise<void>;

Defined in: packages/memory/src/internal/storage-adapter.ts:621

Soft-archive a fact (sets archived = 1). The audit row in memory_history records the archive event.

Parameters

Parameter	Type
id	string
reason?	string
scope?	SessionScope

Returns

Promise<void>

---

listDecaySignals()?

optional listDecaySignals(ids): Promise<readonly {
  createdAt: number;
  id: string;
  lastAccessedAt: number | null;
  strength: number;
}[]>;

Defined in: packages/memory/src/internal/storage-adapter.ts:640

Narrow decay-column read for exactly the given fact ids (MRET-8) - powers per-search decay re-ranking without the old O(scope) 1000-row window read. Optional; absent ⇒ the tier falls back to listForDecay.

Parameters

Parameter	Type
ids	readonly string[]

Returns

Promise<readonly { createdAt: number; id: string; lastAccessedAt: number | null; strength: number; }[]>

---

listForDecay()

listForDecay(
   scope, 
   limit?, 
   opts?): Promise<readonly {
  accessCount?: number;
  archived: boolean;
  createdAt: number;
  id: string;
  importance: number | null;
  lastAccessedAt: number | null;
  provenance: string | null;
  status: string;
  strength: number;
  text: string;
}[]>;

Defined in: packages/memory/src/internal/storage-adapter.ts:591

List facts for the scope ordered by lastAccessedAt ASC so the caller can apply Ebbinghaus retention without scanning the whole table. limit defaults to 1000.

Archived rows are EXCLUDED by default (MCON-6) - they never receive access bumps, so they would pin the LRU head and saturate the decay window, structurally stopping threshold-archiving and capacity eviction for live facts. Inspection paths pass { includeArchived: true }.

importance / status / provenance (X-1) feed the multi-signal salience score that orders capacity-bounded eviction.

Parameters

Parameter	Type
scope	SessionScope
limit?	number
opts?	{ includeArchived?: boolean; }
opts.includeArchived?	boolean

Returns

Promise<readonly { accessCount?: number; archived: boolean; createdAt: number; id: string; importance: number | null; lastAccessedAt: number | null; provenance: string | null; status: string; strength: number; text: string; }[]>

---

markAccessed()?

optional markAccessed(
   ids, 
   accessedAt?, 
scope?): Promise<void>;

Defined in: packages/memory/src/internal/storage-adapter.ts:629

Record a retrieval access for the given facts (MRET-7): stamp lastAccessedAt and reinforce strength (implementation-capped). Optional - adapters without decay columns may omit it; callers MUST treat failures as non-fatal (the read path never breaks on a bookkeeping write).

Parameters

Parameter	Type
ids	readonly string[]
accessedAt?	number
scope?	SessionScope

Returns

Promise&lt;void&gt;