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.1 KB
Raw Blame
import { findUnlinkedMentions } from "../../../core/brain/link-graph/unlinked-mentions.ts";
import { normaliseWikilinkTarget } from "../../../core/brain/wikilink.ts";
import { brainVerbContext, fail, parse } from "../helpers.ts";

/**
 * `o2b brain unlinked <target-id> [--limit N] [--vault PATH] [--json]`
 *
 * Surface raw-text mentions of `<target-id>`'s title / aliases that
 * are NOT already inside `[[...]]` wikilinks. Read-only; walks
 * `Brain/preferences/` and `Brain/retired/` only. Match boundary is
 * Unicode-aware (codepoint class), language-agnostic.
 */
export async function cmdBrainUnlinked(argv: string[]): Promise<number> {
  const { positional, flags } = parse(argv, {
    vault: { type: "string" },
    limit: { type: "string" },
    json: { type: "boolean" },
  });
  const { vault } = brainVerbContext(flags);

  const id = positional[0];
  if (!id) {
    return fail("brain unlinked requires a target id (e.g. pref-foo, ret-bar)");
  }
  const target = normaliseWikilinkTarget(id);

  let limit: number | undefined;
  const limitFlag = flags["limit"];
  if (typeof limitFlag === "string" && limitFlag.length > 0) {
    if (!/^[0-9]+$/.test(limitFlag)) {
      return fail("brain unlinked: --limit must be a positive integer");
    }
    const parsed = Number.parseInt(limitFlag, 10);
    if (parsed < 1) {
      return fail("brain unlinked: --limit must be a positive integer");
    }
    limit = parsed;
  }

  const mentions = findUnlinkedMentions(vault, target, limit !== undefined ? { limit } : {});

  if (flags["json"]) {
    process.stdout.write(
      JSON.stringify(
        {
          id: target,
          count: mentions.length,
          mentions: mentions.map((m) => ({
            source: m.source,
            line: m.line,
            term: m.term,
            context: m.contextSnippet,
          })),
        },
        null,
        2,
      ) + "\n",
    );
    return 0;
  }

  process.stdout.write(`Unlinked mentions of ${target}: ${mentions.length}\n`);
  for (const m of mentions) {
    process.stdout.write(`  ${m.source}:${m.line}  (${m.term})  ${m.contextSnippet.trim()}\n`);
  }
  return 0;
}