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
/**
 * `o2b brain sgrep <query> [path]` (Workspace Insight Suite,
 * t_323a9a83): grep-shaped semantic Brain search. Ordinary shell
 * reflexes - positional query, optional path scope, `path:line:`
 * output lines - over the existing search pipeline. Exact `grep`
 * stays untouched; this is a separate verb, never a wrapper.
 */

import { defaultConfigPath } from "../../../core/config.ts";
import { resolveSearchConfig, search, SearchError } from "../../../core/search/index.ts";
import { fail, ok, okJson, parse, resolveBrainVault } from "../helpers.ts";
import { CLI_TRANSPORT_REACH } from "../../transport-reach.ts";

export async function cmdBrainSgrep(argv: string[]): Promise<number> {
  const { flags, positional } = parse(argv, {
    vault: { type: "string" },
    limit: { type: "string" },
    "keyword-only": { type: "boolean" },
    "agent-scope": { type: "string" },
    json: { type: "boolean" },
  });
  const config = defaultConfigPath();
  const json = flags["json"] === true;

  const query = positional[0];
  if (!query || query.trim() === "") {
    return fail(
      "usage: o2b brain sgrep <query> [path-prefix] [--limit N] [--keyword-only]" +
        " [--agent-scope NAME] [--json]",
    );
  }
  const pathPrefix = positional[1];
  const limitRaw = flags["limit"];
  const limit = typeof limitRaw === "string" && limitRaw.trim() !== "" ? Number(limitRaw) : 10;
  if (!Number.isInteger(limit) || limit < 1 || limit > 100) {
    return fail("--limit must be an integer in 1..100");
  }

  try {
    const vault = resolveBrainVault(flags["vault"] as string | undefined, config);
    const searchConfig = resolveSearchConfig({ vault, configPath: config });
    const outcome = await search(searchConfig, {
      query,
      limit,
      transportReach: CLI_TRANSPORT_REACH,
      keywordOnly: flags["keyword-only"] === true,
      ...(pathPrefix !== undefined ? { pathPrefix } : {}),
      ...(typeof flags["agent-scope"] === "string"
        ? { agentScope: flags["agent-scope"] as string }
        : {}),
    });
    if (json) {
      okJson({
        ok: true,
        results: outcome.results.map((r) => ({
          path: r.path,
          line: r.startLine,
          score: r.score,
          snippet: r.content.trim().replace(/\s+/gu, " ").slice(0, 200),
        })),
        total: outcome.total,
        warnings: outcome.warnings,
      });
      // Grep-like contract holds in JSON mode too: no matches -> 1.
      return outcome.results.length > 0 ? 0 : 1;
    }
    for (const r of outcome.results) {
      const snippet = r.content.trim().replace(/\s+/gu, " ").slice(0, 160);
      ok(`${r.path}:${r.startLine}: ${snippet}`);
    }
    if (outcome.results.length === 0) ok("(no matches)");
    for (const warning of outcome.warnings) ok(`warning: ${warning}`);
    return outcome.results.length > 0 ? 0 : 1;
  } catch (err) {
    if (err instanceof SearchError) return fail(`${err.message} [${err.code}]`);
    return fail((err as Error).message ?? String(err));
  }
}