Skip to content

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
2.6 KB
Raw Blame
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),
  });
}