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 { mergePreferences, BrainMergeError } from "../../../core/brain/merge.ts";
import {
  brainVerbContext,
  fail,
  ok,
  okJson,
  parse,
  readSingleLine,
  resolveBrainAgent,
} from "../helpers.ts";

export async function cmdBrainMerge(argv: string[]): Promise<number> {
  const { flags, positional } = parse(argv, {
    vault: { type: "string" },
    "dry-run": { type: "boolean" },
    force: { type: "boolean" },
    agent: { type: "string" },
    json: { type: "boolean" },
  });
  if (positional.length !== 2)
    return fail("brain merge requires exactly two positional ids: <keep-pref-id> <drop-pref-id>");
  const [keepId, dropId] = positional as [string, string];
  const { config, vault } = brainVerbContext(flags);
  const agent = resolveBrainAgent(flags, config);
  const dryRun = flags["dry-run"] === true;
  const force = flags["force"] === true;
  const wantJson = flags["json"] === true;

  let plan;
  try {
    plan = mergePreferences(vault, keepId, dropId, {
      now: new Date(),
      agentName: agent,
      dryRun: true,
      bypassEntityGuard: force,
    });
  } catch (exc) {
    if (exc instanceof BrainMergeError) return fail(`brain merge: ${exc.message}`);
    return fail(`brain merge: failed to plan merge: ${(exc as Error).message ?? exc}`);
  }

  const planLines = [
    `merge plan:`,
    `  keep: ${plan.keep_id}`,
    `  drop: ${plan.drop_id} → ${plan.retired_path}`,
    `  topic: ${plan.topic}${plan.scope ? `, scope: ${plan.scope}` : ""}`,
    `  evidenced_by union: ${plan.merged_evidenced_by.length}`,
    `  applied_sum: ${plan.applied_sum}`,
    `  violated_sum: ${plan.violated_sum}`,
    `  last_evidence_at: ${plan.last_evidence_at ?? "—"}`,
  ];

  if (dryRun) {
    if (wantJson) {
      okJson({ dry_run: true, plan });
    } else {
      for (const line of planLines) ok(line);
      ok("dry-run; no changes written");
    }
    return 0;
  }

  if (!force) {
    if (wantJson)
      return fail(
        "brain merge: --json without --force is not supported (interactive prompt cannot render)",
      );
    if (!process.stdin.isTTY)
      return fail(
        "brain merge: --force required when stdin is not a TTY (cannot prompt for confirmation)",
      );
    for (const line of planLines) process.stderr.write(line + "\n");
    process.stderr.write("Proceed? [y/N] ");
    const ans = (await readSingleLine()).toLowerCase();
    if (ans !== "y" && ans !== "yes") {
      ok("merge cancelled");
      return 0;
    }
  }

  try {
    mergePreferences(vault, keepId, dropId, {
      now: new Date(),
      agentName: agent,
      bypassEntityGuard: force,
    });
  } catch (exc) {
    if (exc instanceof BrainMergeError) return fail(`brain merge: ${exc.message}`);
    return fail(`brain merge: failed to commit merge: ${(exc as Error).message ?? exc}`);
  }

  if (wantJson) {
    okJson({ merged: true, plan });
  } else {
    ok(`merged: ${plan.drop_id} → ${plan.keep_id} (retired as merged-into)`);
  }
  return 0;
}