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.7 KB
Raw Blame
/**
 * `o2b brain summary` - operator dashboard (v0.10.16). Aggregates
 * doctor, dream (dry-run), verification delta, instruction-file
 * ceiling, and ranked maintenance actions into one output.
 *
 * Defaults to markdown so an operator can paste the report into
 * their notes; `--json` returns the structured envelope for tooling.
 */

import { dream } from "../../../core/brain/dream.ts";
import {
  buildOperatorSummary,
  renderOperatorSummaryMarkdown,
} from "../../../core/brain/trust/operator-summary.ts";
import { brainVerbContext, fail, okJson, parse } from "../helpers.ts";

export async function cmdBrainSummary(argv: string[]): Promise<number> {
  const { flags } = parse(argv, {
    vault: { type: "string" },
    json: { type: "boolean" },
    "skip-dream": { type: "boolean" },
    "top-actions": { type: "string" },
  });
  const { vault } = brainVerbContext(flags);

  let topActionsN: number | undefined;
  const topRaw = flags["top-actions"] as string | undefined;
  if (topRaw !== undefined) {
    const n = Number(topRaw);
    if (!Number.isInteger(n) || n < 0) {
      return fail(`brain summary: --top-actions must be a non-negative integer; got ${topRaw}`);
    }
    topActionsN = n;
  }

  let dreamSummary;
  let dreamError: string | undefined;
  if (!flags["skip-dream"]) {
    try {
      dreamSummary = dream(vault, { dryRun: true });
    } catch (err) {
      // Surface the failure rather than silently producing a partial
      // dashboard. stderr keeps the human-readable text channel
      // separate from the structured payload; the `dream_error`
      // field on the JSON output lets automation react.
      dreamError = (err as Error).message ?? String(err);
      process.stderr.write(`warning: dry-run dream failed: ${dreamError}\n`);
    }
  }

  const summary = buildOperatorSummary(vault, {
    ...(dreamSummary ? { dreamSummary } : {}),
    ...(topActionsN !== undefined ? { topActionsN } : {}),
  });

  if (flags["json"]) {
    okJson({
      trust_verdict: summary.trust_verdict,
      digest_summary: summary.digest_summary,
      doctor_summary: {
        warning_count: summary.doctor_summary.warning_count,
        error_count: summary.doctor_summary.error_count,
      },
      dream_summary: summary.dream_summary,
      verification_delta: {
        summary: summary.verification_delta.summary,
        entries: summary.verification_delta.entries,
      },
      top_actions: summary.top_actions,
      instruction_file_warnings: summary.instruction_file_warnings,
      ...(dreamError !== undefined ? { dream_error: dreamError } : {}),
    });
    return 0;
  }

  process.stdout.write(renderOperatorSummaryMarkdown(summary));
  if (dreamError !== undefined) {
    process.stdout.write(`\nDream error: ${dreamError}\n`);
  }
  return 0;
}