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
import {
  buildMonthlyReview,
  normalizeMonthlyReviewMonth,
} from "../../../core/brain/monthly-review.ts";
import { CliError, brainVerbContext, localTimeFields, parse } from "../helpers.ts";

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

/**
 * `o2b brain monthly [--vault PATH] [--month YYYY-MM] [--json]`
 *
 * Read-only monthly synthesis over the Brain timeline.
 */
export async function cmdBrainMonthly(argv: string[]): Promise<number> {
  const { flags } = parse(argv, {
    vault: { type: "string" },
    month: { type: "string" },
    json: { type: "boolean" },
  });
  const { config, vault } = brainVerbContext(flags);
  const month = parseMonth(flags["month"]);
  const report = buildMonthlyReview(vault, month ? { month } : {});

  if (flags["json"]) {
    process.stdout.write(JSON.stringify({ ...report, ...localTimeFields(config) }, null, 2) + "\n");
    return 0;
  }

  process.stdout.write(`Monthly review ${report.month}\n`);
  process.stdout.write(`  window: ${report.window.since} .. ${report.window.until}\n`);
  process.stdout.write(`  events: ${report.summary.events}\n`);
  process.stdout.write(`  status transitions: ${report.summary.status_transitions}\n`);
  process.stdout.write(`  retired: ${report.summary.retired}\n`);
  process.stdout.write(`  contradictions: ${report.summary.contradictions}\n`);
  if (report.summary.neglected_areas.length > 0) {
    process.stdout.write(`  neglected areas: ${report.summary.neglected_areas.join(", ")}\n`);
  }
  return 0;
}

function parseMonth(raw: string | boolean | string[] | undefined): string | undefined {
  if (raw === undefined || raw === false) return undefined;
  if (typeof raw !== "string") {
    throw new CliError("brain monthly: --month must be YYYY-MM");
  }
  try {
    return normalizeMonthlyReviewMonth(raw);
  } catch {
    throw new CliError("brain monthly: --month must be YYYY-MM");
  }
}