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.3 KB
Raw Blame
/**
 * `o2b brain actions` - ranked maintenance action list. Aggregates
 * inputs from {@link findDuplicateCandidates}, {@link lintConsolidate}
 * (dry-run), and {@link computeTokenFootprint}, runs them through
 * {@link scoreActions}, and emits the top-N actionable items ordered
 * by impact descending.
 */

import { findDuplicateCandidates } from "../../../core/brain/page-dedup.ts";
import { lintConsolidate } from "../../../core/brain/lint-consolidate.ts";
import { computeTokenFootprint } from "../../../core/brain/token-footprint.ts";
import { scoreActions, type ActionInputs } from "../../../core/brain/maintenance/action-scorer.ts";
import { brainVerbContext, fail, okJson, parse } from "../helpers.ts";

export async function cmdBrainActions(argv: string[]): Promise<number> {
  const { flags } = parse(argv, {
    vault: { type: "string" },
    json: { type: "boolean" },
    "top-n": { type: "string" },
  });
  const { vault } = brainVerbContext(flags);
  const topNRaw = flags["top-n"] as string | undefined;
  let topN = 10;
  if (topNRaw !== undefined) {
    const parsed = Number(topNRaw);
    if (!Number.isInteger(parsed) || parsed <= 0) {
      return fail(`brain actions: --top-n must be a positive integer; got ${topNRaw}`);
    }
    topN = parsed;
  }

  const dedup = findDuplicateCandidates(vault);
  const lint = lintConsolidate(vault, { apply: false });
  const footprint = computeTokenFootprint(vault);

  const inputs: ActionInputs = {
    dedupCandidates: dedup.candidates.map((c) => ({
      canonicalId: c.canonical.id,
      secondaryCount: c.secondaries.length,
    })),
    staleByLifecycle: lint.demotions.map((d) => ({
      id: d.id,
      ageDays: d.ageDays,
    })),
    brokenLinks: lint.fixes.map((f) => ({ path: f.path, from: f.from })),
    tokenFootprint: {
      total: footprint.total,
      warnThreshold: footprint.warnThreshold,
    },
  };

  const items = scoreActions(inputs, { topN });

  if (flags["json"]) {
    okJson({ items });
    return 0;
  }

  if (items.length === 0) {
    process.stdout.write("no maintenance actions queued.\n");
    return 0;
  }
  process.stdout.write(`top ${items.length} maintenance action(s):\n`);
  for (const it of items) {
    process.stdout.write(
      `  [${it.category.padEnd(15)}] impact=${String(it.impact).padStart(4)}  ${it.title}\n`,
    );
  }
  return 0;
}