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.9 KB
Raw Blame
import {
  evaluateAttentionFlow,
  listAttentionFlows,
  renderAttentionFlow,
} from "../../../core/brain/attention-flows.ts";
import { CliError, brainVerbContext, parse } from "../helpers.ts";

export async function cmdBrainAttentionFlows(argv: string[]): Promise<number> {
  const sub = argv[0];
  const rest = argv.slice(1);
  if (sub === "list") return list(rest);
  if (sub === "evaluate") return evaluate(rest);
  if (sub === "render") return render(rest);
  throw new CliError("brain attention-flows: expected list, evaluate, or render");
}

function list(argv: string[]): number {
  const { flags } = parse(argv, {
    vault: { type: "string" },
    json: { type: "boolean" },
  });
  const vault = brainVerbContext(flags).vault;
  const flows = listAttentionFlows(vault);
  if (flags["json"]) {
    process.stdout.write(JSON.stringify({ total: flows.length, flows }, null, 2) + "\n");
    return 0;
  }
  process.stdout.write(`${flows.length} attention flow(s):\n`);
  for (const flow of flows) {
    process.stdout.write(`  ${flow.id}  actions=${flow.actions.join(",") || "-"}\n`);
  }
  return 0;
}

function evaluate(argv: string[]): number {
  const { flags, positional } = parse(argv, {
    vault: { type: "string" },
    json: { type: "boolean" },
  });
  const flowId = positional[0];
  if (!flowId) throw new CliError("brain attention-flows evaluate: flow id is required");
  const vault = brainVerbContext(flags).vault;
  let report;
  try {
    report = evaluateAttentionFlow(vault, flowId);
  } catch (error) {
    throw mapAttentionFlowError(error, flowId);
  }
  if (flags["json"]) {
    process.stdout.write(JSON.stringify(report, null, 2) + "\n");
    return 0;
  }
  process.stdout.write(`${report.flow_id}: ${report.title}\n`);
  for (const section of report.sections) {
    process.stdout.write(`  ${section.action}: ${section.items.length}\n`);
  }
  return 0;
}

function render(argv: string[]): number {
  const { flags, positional } = parse(argv, {
    vault: { type: "string" },
    json: { type: "boolean" },
  });
  const flowId = positional[0];
  if (!flowId) throw new CliError("brain attention-flows render: flow id is required");
  const vault = brainVerbContext(flags).vault;
  let text: string;
  try {
    text = renderAttentionFlow(vault, flowId);
  } catch (error) {
    throw mapAttentionFlowError(error, flowId);
  }
  if (flags["json"]) {
    process.stdout.write(JSON.stringify({ flow_id: flowId, text }, null, 2) + "\n");
    return 0;
  }
  process.stdout.write(text.endsWith("\n") ? text : text + "\n");
  return 0;
}

function mapAttentionFlowError(error: unknown, flowId: string): CliError {
  if (error instanceof Error) {
    if (error.message.startsWith("attention flow not found:")) {
      return new CliError(`brain attention-flows: unknown flow id: ${flowId}`);
    }
    return new CliError(error.message);
  }
  return new CliError("brain attention-flows: failed to evaluate flow");
}