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 { proceduralHintsPath } from "./paths.ts";
import {
readProceduralState,
readProceduralGraph,
writeMachineStateText,
type ProceduralGraphProjection,
} from "./procedural-graph.ts";
import { assertLaneWrite } from "../store/lane-pages.ts";
export interface ProceduralHintEntry {
readonly node_id: string;
readonly cues: ReadonlyArray<string>;
}
export interface ProceduralHintsProjection {
readonly schema_version: 1;
readonly generated_at: string;
readonly entries: ReadonlyArray<ProceduralHintEntry>;
}
export function rebuildProceduralHints(
vault: string,
opts: { now?: Date; graph?: ProceduralGraphProjection } = {},
): ProceduralHintsProjection {
// Vault-identity write guard (context-integrity-gates, Unit J).
assertLaneWrite(vault);
const graph = opts.graph ?? readProceduralGraph(vault);
const now = opts.now ?? new Date();
const entries: ProceduralHintEntry[] = [];
if (graph !== null) {
for (const node of graph.nodes) {
if (node.kind === "entity") continue;
const cues = new Set<string>();
for (const token of tokenizeCue(node.title)) cues.add(token);
if (node.sourcePath) {
for (const token of tokenizeCue(node.sourcePath)) cues.add(token);
}
for (const value of Object.values(node.metadata)) {
if (Array.isArray(value)) {
for (const item of value) {
if (typeof item === "string") {
for (const token of tokenizeCue(item)) cues.add(token);
}
}
} else if (typeof value === "string") {
for (const token of tokenizeCue(value)) cues.add(token);
}
}
entries.push({
node_id: node.id,
cues: Object.freeze([...cues].filter((item) => item.length >= 3).toSorted()),
});
}
}
const projection: ProceduralHintsProjection = {
schema_version: 1,
generated_at: now.toISOString(),
entries: Object.freeze(entries.toSorted((l, r) => l.node_id.localeCompare(r.node_id))),
};
writeMachineStateText(proceduralHintsPath(vault), `${JSON.stringify(projection, null, 2)}\n`);
return projection;
}
export function readProceduralHints(vault: string): ProceduralHintsProjection | null {
const text = readProceduralState(vault, proceduralHintsPath(vault));
if (text === null) return null;
try {
const parsed = JSON.parse(text) as ProceduralHintsProjection;
if (parsed.schema_version !== 1) return null;
if (!Array.isArray(parsed.entries)) return null;
return parsed;
} catch {
return null;
}
}
function tokenizeCue(input: string): string[] {
return input
.toLowerCase()
.split(/[^a-z0-9]+/g)
.map((item) => item.trim())
.filter((item) => item.length >= 3);
}