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
/**
 * Timezone presentation layer (t_2ccadc6a,
 * upstream:tencentdb-agent-memory).
 *
 * Storage timestamps stay canonical UTC everywhere - frontmatter, log
 * headings, run ids, metrics (`time.ts` is untouched). This module
 * converts ONE instant at the presentation boundary: user-facing CLI
 * output and LLM-facing MCP envelopes render the operator's configured
 * IANA zone (`timezone` config field / `VAULT_TIMEZONE` env, resolved
 * by `resolveTimezone()` in core/config.ts).
 *
 * Output shape is the full-offset ISO-8601 form
 * `YYYY-MM-DDTHH:MM:SS+HH:MM` so a reader always sees both the local
 * wall time and how far it sits from the stored UTC value. Fail-soft:
 * a missing or invalid zone renders the canonical UTC `Z` form, and an
 * unparseable instant is returned verbatim - presentation must never
 * break the surface it decorates.
 */

const PART_TYPES = ["year", "month", "day", "hour", "minute", "second"] as const;

/**
 * Render one ISO-8601 UTC instant in the given IANA zone with an
 * explicit offset. `tz === null` (not configured) or an invalid zone
 * returns the canonical UTC `Z` rendering of the same instant.
 */
export function formatLocalTimestamp(isoUtc: string, tz: string | null): string {
  const date = new Date(isoUtc);
  if (Number.isNaN(date.getTime())) return isoUtc;
  const canonical = date.toISOString().replace(/\.\d{3}Z$/, "Z");
  if (tz === null) return canonical;

  let parts: Intl.DateTimeFormatPart[];
  try {
    parts = new Intl.DateTimeFormat("en-CA", {
      timeZone: tz,
      year: "numeric",
      month: "2-digit",
      day: "2-digit",
      hour: "2-digit",
      minute: "2-digit",
      second: "2-digit",
      hour12: false,
    }).formatToParts(date);
  } catch {
    return canonical;
  }

  const v: Record<string, string> = {};
  for (const part of parts) {
    if ((PART_TYPES as ReadonlyArray<string>).includes(part.type)) v[part.type] = part.value;
  }
  // `hour12: false` can render midnight as "24" in some engines.
  const hour = v["hour"] === "24" ? "00" : v["hour"]!;

  // Offset = local wall clock reinterpreted as UTC minus the instant.
  const wallAsUtc = Date.UTC(
    Number(v["year"]),
    Number(v["month"]) - 1,
    Number(v["day"]),
    Number(hour),
    Number(v["minute"]),
    Number(v["second"]),
  );
  const offsetMinutes = Math.round((wallAsUtc - date.getTime()) / 60_000);
  const sign = offsetMinutes < 0 ? "-" : "+";
  const abs = Math.abs(offsetMinutes);
  const offset = `${sign}${String(Math.floor(abs / 60)).padStart(2, "0")}:${String(abs % 60).padStart(2, "0")}`;

  return `${v["year"]}-${v["month"]}-${v["day"]}T${hour}:${v["minute"]}:${v["second"]}${offset}`;
}