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
1.8 KB
Raw Blame
import { importOkfBundle, readOkfBundle } from "../../../core/brain/portability/okf.ts";
import { brainVerbContext, fail, parse } from "../helpers.ts";

/**
 * `o2b brain okf-import <dir> [--trusted]` — read an Open Knowledge
 * Format bundle directory and import its pages. By default pages are
 * staged under `OKF Review/` with `okf_review: pending` (review
 * candidates); `--trusted` writes each page directly to its recorded
 * vault-relative path. Foreign-producer bundles get producer + raw type
 * provenance stamped, with producer-specific (`x-*`) frontmatter
 * preserved. The bundle's `producer` claim is never a credential:
 * `--trusted` alone decides whether machinery frontmatter survives and
 * whether the Brain page lanes are writable.
 */
export async function cmdBrainOkfImport(argv: string[]): Promise<number> {
  const { positional, flags } = parse(argv, {
    vault: { type: "string" },
    trusted: { type: "boolean" },
  });
  const { vault } = brainVerbContext(flags);
  const dir = positional[0];
  if (dir === undefined) {
    return fail("usage: o2b brain okf-import <bundle-dir> [--trusted]");
  }

  try {
    const parsed = readOkfBundle(dir);
    const result = importOkfBundle(vault, parsed, { trusted: flags["trusted"] === true });
    const provenance = result.foreign ? " (foreign producer; provenance stamped)" : "";
    process.stdout.write(
      `imported ${result.written.length} page(s) in ${result.mode} mode${provenance}; ` +
        `${result.skipped.length} skipped, ${result.errors.length} error(s)\n`,
    );
    for (const err of result.errors) {
      process.stderr.write(`  error: ${err.path}: ${err.message}\n`);
    }
    return result.errors.length > 0 ? 1 : 0;
  } catch (exc) {
    return fail(`okf-import failed: ${(exc as Error).message ?? exc}`);
  }
}