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
3.2 KB
Raw Blame
import { buildTimelineIndex } from "../../../core/brain/temporal/build-index.ts";
import { buildDailyBrief } from "../../../core/brain/temporal/daily-brief.ts";
import { loadTemporalConfigSafe } from "../../../core/brain/policy.ts";
import { CliError, brainVerbContext, localTimeFields, parse } from "../helpers.ts";
import { captureReportDelta, renderReportDelta } from "../../../core/brain/report-snapshot.ts";

const ISO_DATE_ONLY_RE = /^\d{4}-\d{2}-\d{2}$/;

/**
 * `o2b brain daily [--vault PATH] [--date YYYY-MM-DD] [--json]`
 *
 * Per-day deterministic brief over the TimelineIndex. Defaults
 * `--date` to today UTC.
 */
export async function cmdBrainDaily(argv: string[]): Promise<number> {
  const { flags } = parse(argv, {
    vault: { type: "string" },
    date: { type: "string" },
    json: { type: "boolean" },
  });
  const { config, vault } = brainVerbContext(flags);
  const date = resolveDateArg(flags["date"]);
  const cfg = loadTemporalConfigSafe(vault);
  const index = buildTimelineIndex(vault, {});
  let brief;
  try {
    brief = buildDailyBrief(index, vault, date, {
      offsetHours: cfg.daily_window_offset_hours,
    });
  } catch (exc) {
    if (exc instanceof Error) throw new CliError(`brain daily: ${exc.message}`);
    throw exc;
  }

  const delta = captureReportDelta(
    vault,
    "daily",
    brief.date,
    brief,
    config ? { configPath: config } : {},
  );
  if (flags["json"]) {
    process.stdout.write(
      JSON.stringify(
        { ...brief, ...(delta !== null ? { delta } : {}), ...localTimeFields(config) },
        null,
        2,
      ) + "\n",
    );
    return 0;
  }

  process.stdout.write(`Daily brief ${brief.date}\n`);
  process.stdout.write(`  window: ${brief.window.since} .. ${brief.window.until}\n`);
  process.stdout.write(`  events by kind:\n`);
  for (const [kind, count] of Object.entries(brief.eventsByKind)) {
    process.stdout.write(`    ${kind}: ${count}\n`);
  }
  process.stdout.write(`  vault delta:\n`);
  process.stdout.write(`    new promotions: ${brief.vaultDelta.newPromotions}\n`);
  process.stdout.write(`    new retired: ${brief.vaultDelta.newRetired}\n`);
  process.stdout.write(`    new feedback: ${brief.vaultDelta.newFeedback}\n`);
  process.stdout.write(`    evidence applied: ${brief.vaultDelta.evidenceApplied}\n`);
  process.stdout.write(`    evidence violated: ${brief.vaultDelta.evidenceViolated}\n`);
  process.stdout.write(`  status transitions: ${brief.statusTransitions.length}\n`);
  if (delta !== null) process.stdout.write(renderReportDelta(delta) + "\n");
  process.stdout.write(`  source pointers: ${brief.sourcePointers.length}\n`);
  return 0;
}

/**
 * Validate / default the `--date` flag. Accepts a bare ISO date
 * (`YYYY-MM-DD`); rejects whitespace-only / malformed input as a
 * CLI error so the underlying helper does not see garbage.
 */
function resolveDateArg(raw: string | boolean | string[] | undefined): string {
  if (typeof raw !== "string" || raw.trim().length === 0) {
    return new Date().toISOString().slice(0, 10);
  }
  const v = raw.trim();
  if (!ISO_DATE_ONLY_RE.test(v)) {
    throw new CliError(
      `brain daily: --date must be a YYYY-MM-DD ISO date; got ${JSON.stringify(raw)}`,
    );
  }
  return v;
}