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
import type { PageTier } from "./page-meta/tier.ts";
export type ContextLaneName = "directives" | "constraints" | "consider";
export interface ContextLaneSource {
readonly id: string;
readonly path: string;
readonly tier: PageTier;
readonly tokens: number;
readonly body: string;
readonly trimmed: boolean;
readonly sourceId: string;
readonly sourcePath: string;
}
export interface ContextLanesReport {
readonly directives: ReadonlyArray<ContextLaneSource>;
readonly constraints: ReadonlyArray<ContextLaneSource>;
readonly consider: ReadonlyArray<ContextLaneSource>;
}
export interface ContextLaneInput {
readonly id: string;
readonly path: string;
readonly tier: PageTier;
readonly tokens: number;
readonly body: string;
readonly trimmed: boolean;
readonly principle: string;
readonly manualLane?: ContextLaneName | null;
}
export function normalizeContextLane(raw: unknown): ContextLaneName | null {
if (typeof raw !== "string") return null;
const value = raw.trim().toLowerCase();
if (value === "directives" || value === "constraints" || value === "consider") return value;
return null;
}
/**
* Classify a source into a context lane.
*
* Language-agnostic by construction: the lane is never inferred from
* the words of the principle/body (an English/Russian "never/forbidden"
* prose scan would silently misclassify every other language). The
* `constraints` lane is opt-in via the explicit `context_lane:`
* frontmatter field (surfaced here as `manualLane`); without it, the
* lane follows only the structural page tier.
*/
export function classifyContextLane(input: ContextLaneInput): ContextLaneName {
if (input.manualLane) return input.manualLane;
if (input.tier === "peripheral") return "consider";
return "directives";
}
export function buildContextLanes(inputs: ReadonlyArray<ContextLaneInput>): ContextLanesReport {
const directives: ContextLaneSource[] = [];
const constraints: ContextLaneSource[] = [];
const consider: ContextLaneSource[] = [];
for (const input of inputs) {
const source = Object.freeze({
id: input.id,
path: input.path,
tier: input.tier,
tokens: input.tokens,
body: input.body,
trimmed: input.trimmed,
sourceId: input.id,
sourcePath: input.path,
});
const lane = classifyContextLane(input);
if (lane === "constraints") constraints.push(source);
else if (lane === "consider") consider.push(source);
else directives.push(source);
}
return Object.freeze({
directives: Object.freeze(directives),
constraints: Object.freeze(constraints),
consider: Object.freeze(consider),
});
}