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
1.8 KB
Raw Blame
/**
 * `o2b brain profile` (Workspace Insight Suite, t_323a9a83): materialize
 * the compact `Brain/profile.md` digest plus the `.o2bfs` root marker.
 * Age-gated: an existing fresh profile is left alone unless --force.
 */

import { defaultConfigPath } from "../../../core/config.ts";
import { isProfileStale, writeProfileDoc } from "../../../core/brain/profile-doc.ts";
import { fail, ok, okJson, parse, resolveBrainVault } from "../helpers.ts";

const DEFAULT_STALE_SECONDS = 3600;

export async function cmdBrainProfile(argv: string[]): Promise<number> {
  const { flags } = parse(argv, {
    vault: { type: "string" },
    "stale-seconds": { type: "string" },
    force: { type: "boolean" },
    json: { type: "boolean" },
  });
  const config = defaultConfigPath();
  const json = flags["json"] === true;

  try {
    const vault = resolveBrainVault(flags["vault"] as string | undefined, config);
    const staleRaw = flags["stale-seconds"];
    const staleSeconds =
      typeof staleRaw === "string" && staleRaw.trim() !== ""
        ? Number(staleRaw)
        : DEFAULT_STALE_SECONDS;
    if (!Number.isFinite(staleSeconds) || staleSeconds < 0) {
      return fail("--stale-seconds must be a non-negative number");
    }
    const now = new Date();
    if (flags["force"] !== true && !isProfileStale(vault, staleSeconds, now)) {
      if (json) okJson({ ok: true, refreshed: false, reason: "fresh" });
      else ok("profile is fresh (use --force to regenerate)");
      return 0;
    }
    const result = writeProfileDoc(vault, { now });
    if (json) {
      okJson({
        ok: true,
        refreshed: true,
        path: result.path,
        marker: result.markerPath,
        generated_at: result.generatedAt,
      });
    } else ok(`profile written: ${result.path}`);
    return 0;
  } catch (err) {
    return fail((err as Error).message ?? String(err));
  }
}