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.2 KB
Raw Blame
/**
 * `o2b brain refresh` - targeted recompile of stale derived pages
 * (continuity-hygiene-freshness suite).
 *
 *   o2b brain refresh --stale [--dry-run] [--json]
 *
 * Re-derives only pages whose recorded sources changed (handoff notes
 * re-derive in place from their transcript), stages orphan cleanup
 * into Brain/.snapshots, and leaves unknown pipelines as `manual`.
 * `--dry-run` previews the plan with zero writes.
 */

import { executeRecompile, planRecompile } from "../../../core/brain/recompile.ts";
import { brainVerbContext, fail, parse, resolveBrainAgent } from "../helpers.ts";

export async function cmdBrainRefresh(argv: string[]): Promise<number> {
  const { flags } = parse(argv, {
    vault: { type: "string" },
    agent: { type: "string" },
    stale: { type: "boolean" },
    "dry-run": { type: "boolean" },
    json: { type: "boolean" },
  });
  if (!flags["stale"]) {
    return fail("usage: o2b brain refresh --stale [--dry-run] [--json]");
  }
  const { config, vault } = brainVerbContext(flags);

  let plan;
  let result;
  try {
    const now = new Date();
    plan = planRecompile(vault, { now, includeActiveDigest: true });
    result = await executeRecompile(vault, plan, {
      dryRun: Boolean(flags["dry-run"]),
      agent: resolveBrainAgent(flags, config),
      now,
    });
  } catch (exc) {
    return fail(`refresh failed: ${(exc as Error).message ?? exc}`);
  }

  if (flags["json"]) {
    process.stdout.write(JSON.stringify({ plan, result }, null, 2) + "\n");
    return result.errors.length === 0 ? 0 : 1;
  }

  if (plan.entries.length === 0) {
    process.stdout.write("nothing to refresh: every tracked page is fresh\n");
    return 0;
  }
  for (const entry of plan.entries) {
    process.stdout.write(`${entry.kind}: ${entry.page}\n    ${entry.reason}\n`);
  }
  if (result.dry_run) {
    process.stdout.write(`dry run: ${plan.entries.length} entr(y/ies) planned, nothing written\n`);
    return 0;
  }
  process.stdout.write(
    `rederived ${result.rederived.length}, archived ${result.archived.length}, manual ${result.manual.length}\n`,
  );
  for (const error of result.errors) {
    process.stdout.write(`error on ${error.page}: ${error.message}\n`);
  }
  return result.errors.length === 0 ? 0 : 1;
}