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
6.1 KB
Raw Blame
/**
 * Brain configuration loader and validator (`Brain/_brain.yaml`).
 *
 * The Brain config is nested two levels deep (top-level keys, each
 * containing a flat `key: number` block) β€” too rich for the
 * `parseSimpleYaml` flat parser used by the plugin config, but a far cry
 * from needing a real YAML library. We ship a tiny indent-aware parser
 * limited to:
 *
 *   - `# comments` and blank lines
 *   - `key: <scalar>` (numbers parsed; quoted strings stripped)
 *   - `key:` followed by an indented block of the same form (one level)
 *   - `key: []` and simple inline scalar arrays (`[a, "b"]`)
 *
 * Anything else is treated as invalid and surfaces through
 * `validateBrainConfig` with a field-named error. No external
 * dependency, no eval, no surprise.
 *
 * Anchored in design doc Β§10.
 *
 * This module is the PUBLIC SURFACE only. The implementation lives under
 * `./policy/`, split so each part has one reason to change:
 *
 *   - `policy/errors.ts`       β€” the diagnostic vocabulary
 *   - `policy/field-checks.ts` β€” the scalar/shape constraints
 *   - `policy/key-index.ts`    β€” the by-construction key vocabulary
 *   - `policy/defaults.ts`     β€” the `_brain.yaml` a fresh vault gets
 *   - `policy/primary-agent.ts`β€” the agent-id grammar, read and written
 *   - `policy/blocks/*.ts`     β€” one module per configuration block,
 *                                each owning its defaults, its read-side
 *                                resolver and its parser together
 *   - `policy/validate.ts`     β€” the block sequence
 *   - `policy/load.ts`         β€” the disk read and its fallback policy
 */

export {
  BrainConfigError,
  BrainSettingsUnreadableError,
  type BrainConfigLoadWarning,
} from "./policy/errors.ts";
export { type BrainConfigKeyIndex } from "./policy/key-index.ts";
export {
  BRAIN_CONFIG_SUPPORTED_VERSIONS,
  DEFAULT_BRAIN_CONFIG,
  DERIVED_STORE_MAX_BYTES_DEFAULT,
} from "./policy/defaults.ts";
export { formatPrimaryAgentYamlValue } from "./policy/primary-agent.ts";
export {
  brainConfigKnownKeys,
  validateBrainConfig,
  validateBrainConfigDetailed,
  type ValidateResult,
} from "./policy/validate.ts";
export {
  brainConfigReadFailure,
  brainConfigUnreadableReport,
  loadActiveMostAppliedSafe,
  loadBrainConfig,
  loadBrainConfigDetailed,
  loadFeedbackDefaultScopeSafe,
  loadGuardrailsConfigSafe,
  loadIntegrityConfigForWrite,
  loadIntegrityConfigSafe,
  loadInstallBlockSafe,
  loadMaintenanceConfigSafe,
  loadNotesConfigSafe,
  loadSnapshotDerivedStorePolicySafe,
  loadSnapshotRetentionSafe,
  loadStorageConfigSafe,
  loadTemporalConfigSafe,
  type BrainDerivedStorePolicy,
  type LoadBrainConfigResult,
} from "./policy/load.ts";

export {
  BRAIN_MOST_APPLIED_DEFAULTS,
  INJECT_BUDGET_CHARS_DEFAULT,
  INJECT_BUDGET_CHARS_MAX,
  INJECT_BUDGET_CHARS_MIN,
  MOST_APPLIED_LIMIT_DEFAULT,
  MOST_APPLIED_LIMIT_MAX,
  MOST_APPLIED_LIMIT_MIN,
  MOST_APPLIED_WINDOW_DAYS_DEFAULT,
  MOST_APPLIED_WINDOW_DAYS_MAX,
  MOST_APPLIED_WINDOW_DAYS_MIN,
  resolveScopedRulesMaxChars,
  resolveStandingRulesMaxChars,
} from "./policy/blocks/active.ts";
/**
 * The standing-rules cap is declared beside the reader it governs
 * (`standing-rules.ts`) and re-exported here so every `active:` knob is
 * reachable from the one policy surface its neighbours already use.
 */
export {
  STANDING_RULES_MAX_CHARS_DEFAULT,
  STANDING_RULES_MAX_CHARS_MAX,
  STANDING_RULES_MAX_CHARS_MIN,
} from "./standing-rules.ts";
export {
  LESSONS_CORROBORATION_MIN_DEFAULT,
  LESSONS_CORROBORATION_MIN_MAX,
  LESSONS_CORROBORATION_MIN_MIN,
  LESSONS_HALF_LIFE_DAYS_DEFAULT,
  LESSONS_HALF_LIFE_DAYS_MAX,
  LESSONS_HALF_LIFE_DAYS_MIN,
  LESSONS_LIMIT_DEFAULT,
  LESSONS_LIMIT_MAX,
  LESSONS_LIMIT_MIN,
} from "./policy/blocks/lessons.ts";
export {
  BRAIN_STORAGE_DEFAULTS,
  STORAGE_CAP_BYTES_MIN,
  STORAGE_DAYS_MIN,
  STORAGE_PERCENT_MAX,
  STORAGE_PERCENT_MIN,
  resolveStorage,
} from "./policy/blocks/storage.ts";
export {
  STORAGE_CRITICAL_DAYS_DEFAULT,
  STORAGE_CRITICAL_PERCENT_DEFAULT,
  STORAGE_WARN_DAYS_DEFAULT,
  STORAGE_WARN_PERCENT_DEFAULT,
} from "./storage/forecast.ts";
export {
  BRAIN_MAINTENANCE_DEFAULTS,
  MAINTENANCE_FAILURE_STREAK_LIMIT_DEFAULT,
  MAINTENANCE_FAILURE_STREAK_LIMIT_MAX,
  MAINTENANCE_FAILURE_STREAK_LIMIT_MIN,
  MAINTENANCE_HOST_PRESSURE_PERCENT_MAX,
  MAINTENANCE_HOST_PRESSURE_PERCENT_MIN,
  resolveMaintenance,
} from "./policy/blocks/maintenance.ts";
export {
  BRAIN_INSTALL_DEFAULTS,
  INSTALL_HOOK_TIMEOUT_SECONDS_DEFAULT,
  INSTALL_HOOK_TIMEOUT_SECONDS_MAX,
  INSTALL_HOOK_TIMEOUT_SECONDS_MIN,
  INSTALL_TOOL_PROFILE_DEFAULT,
  INSTALL_TOOL_PROFILE_NAMES,
} from "./policy/blocks/install.ts";
export {
  BRAIN_GUARDRAIL_DEFAULTS,
  INSTRUCTION_FILE_MAX_LINES_CEILING,
  resolveGuardrails,
} from "./policy/blocks/guardrails.ts";
export {
  BRAIN_INTEGRITY_DEFAULTS,
  BRAIN_INTEGRITY_STRICT_FALLBACK,
  PACK_VALIDITY_SECONDS_DEFAULT,
  resolveIntegrity,
} from "./policy/blocks/integrity.ts";
export { BRAIN_HEALTH_DEFAULTS, resolveHealth } from "./policy/blocks/health.ts";
export { BRAIN_TEMPORAL_DEFAULTS, resolveTemporal } from "./policy/blocks/temporal.ts";
export { BRAIN_LINK_GRAPH_DEFAULTS, resolveLinkGraph } from "./policy/blocks/link-graph.ts";
export { BRAIN_NOTES_DEFAULTS, resolveNotes } from "./policy/blocks/notes.ts";
export {
  BRAIN_SESSION_PAYLOAD_DEFAULTS,
  BRAIN_SESSIONS_DEFAULTS,
  resolveSessionPayloadPolicy,
  resolveSessions,
} from "./policy/blocks/sessions.ts";
export { resolveEmbeddingSunsetDeclaration } from "./policy/blocks/embeddings.ts";
export { decisionModelDisabledByVault } from "./policy/blocks/decision-model.ts";
/**
 * The cross-topic and context-window blocks (cycle 20261020 substrate).
 * The parsers are re-exported beside their default the way the other
 * blocks' resolvers are, so a consumer reaches every `cross_topic:` /
 * `context:` knob from the one policy surface its neighbours already use.
 * The `context` window's resolution and clamping live with the resolver
 * that consumes the stored value, not here: this surface only stores
 * what the operator declared.
 */
export {
  CONTEXT_WINDOW_TOKENS_DEFAULT,
  parseContextBlock,
  parseCrossTopicBlock,
} from "./policy/blocks/context.ts";