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
3.1 KB
Raw Blame
/**
 * `o2b brain dead-end <record|list>` (t_be62c62d): the negative-
 * knowledge surface. `record` persists one tried-and-failed approach
 * as a markdown note (bounded active set, overflow archives);
 * `list` renders the active registry newest first.
 *
 * Exit codes: 0 on success, 1 on an operational failure, 2 on usage
 * errors.
 */

import { DEAD_END_MAX_ACTIVE, listDeadEnds, recordDeadEnd } from "../../../core/brain/dead-ends.ts";
import { brainVerbContext, fail, ok, okJson, parse, resolveBrainAgent } from "../helpers.ts";

const USAGE =
  "usage: o2b brain dead-end <record|list> " +
  "[--approach T --reason T [--context T]] [--max-active N] [--agent N] [--vault <path>] [--json]";

export async function cmdBrainDeadEnd(argv: string[]): Promise<number> {
  const { flags, positional } = parse(argv, {
    vault: { type: "string" },
    approach: { type: "string" },
    reason: { type: "string" },
    context: { type: "string" },
    "max-active": { type: "string" },
    agent: { type: "string" },
    json: { type: "boolean" },
  });
  const op = positional[0];
  if (op !== "record" && op !== "list") {
    process.stderr.write(`${USAGE}\n`);
    return 2;
  }
  const asJson = flags["json"] === true;
  const { config, vault } = brainVerbContext(flags);

  try {
    if (op === "record") {
      const approach = flags["approach"] as string | undefined;
      const reason = flags["reason"] as string | undefined;
      if (!approach?.trim() || !reason?.trim()) {
        process.stderr.write(`brain dead-end record: --approach and --reason required\n${USAGE}\n`);
        return 2;
      }
      const maxRaw = flags["max-active"] as string | undefined;
      const maxActive = maxRaw !== undefined ? Number(maxRaw) : DEAD_END_MAX_ACTIVE;
      if (!Number.isInteger(maxActive) || maxActive < 1) {
        process.stderr.write(`brain dead-end record: --max-active must be a positive integer\n`);
        return 2;
      }
      const result = recordDeadEnd(vault, {
        approach,
        reason,
        ...(typeof flags["context"] === "string" ? { context: flags["context"] as string } : {}),
        agent: resolveBrainAgent(flags, config),
        now: new Date(),
        maxActive,
      });
      if (asJson) {
        okJson({
          ok: true,
          id: result.entry.id,
          path: result.entry.path,
          archived: result.archived,
        });
      } else {
        ok(`dead-end recorded: ${result.entry.id}`);
        if (result.archived.length > 0) ok(`archived: ${result.archived.join(", ")}`);
      }
      return 0;
    }

    const { entries, warnings } = listDeadEnds(vault);
    if (asJson) {
      okJson({ entries, warnings });
    } else {
      ok(`dead-ends: ${entries.length} active`);
      for (const e of entries) {
        ok(`  ${e.created_at}  ${e.approach}`);
        ok(`    why: ${e.reason}`);
      }
      for (const w of warnings) ok(`  [warning] ${w.path}: ${w.message}`);
    }
    return 0;
  } catch (exc) {
    const message = `dead-end ${op} failed: ${(exc as Error).message ?? exc}`;
    if (asJson) {
      okJson({ ok: false, message });
      return 1;
    }
    return fail(message);
  }
}