Local-first 🧠memory for Hermes Agent that lives in your Obsidian vault and remembers project context. Nightly 😴 dream passes turn repeat corrections into confirmed preferences with measurable confidence. Adapters ship for Claude Code, Codex, and OpenClaw, with an MCP server for anything else.
TypeScript
/**
* The typed failure vocabulary of the storage lifecycle: the closed
* code union and the {@link StorageCapacityError} carrier.
*
* A LEAF by construction - it imports nothing, exactly like
* `SearchError` in `src/core/search/search-error.ts`, so every module
* that raises or catches a capacity condition can depend on it without
* dragging the storage modules (or the policy layer) into its import
* graph.
*
* Two codes, and the difference is the whole vocabulary:
*
* - `capacity_unmeasurable` - the census could not be taken, so no
* capacity question has an answer. Refusal by name is the honest
* state: a gate that read an unmeasurable store as "plenty of room"
* would be the silent no-op this project forbids.
* - `capacity_exhausted` - the store measured past the critical
* threshold, and the write that asked is refused before it lands.
*/
export const STORAGE_ERROR_CODES = ["capacity_unmeasurable", "capacity_exhausted"] as const;
export type StorageErrorCode = (typeof STORAGE_ERROR_CODES)[number];
export class StorageCapacityError extends Error {
readonly code: StorageErrorCode;
/**
* The structured fields a refusal envelope carries beside the code,
* when the thrower has facts to add (the tier reading behind an
* admission refusal). Still a leaf: no imports, and the registered
* classification reads the code alone, so these ride only where a
* caller maps the leaf onto its envelope deliberately.
*/
readonly details?: Readonly<Record<string, unknown>>;
constructor(
code: StorageErrorCode,
message: string,
details?: Readonly<Record<string, unknown>>,
) {
super(message);
this.name = "StorageCapacityError";
this.code = code;
this.details = details;
}
}