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
6.9 KB
Raw Blame
/**
 * Write-Time Integrity & Governance Suite - end-to-end integration
 * over one vault: ontology declaration through schema mutations
 * (Task 1), label assignment + filterable recall (t_7a41f42d), a
 * constraint-violating typed edge blocked at materialization
 * (t_15453235), attribute validation teaching the vocabulary
 * (t_f5633190), a hand-edited identity key detected and restored
 * (t_3f92d3f1), secret custody with redacted exec (t_0b134404), and
 * the lease-guarded maintenance lane (t_166d1226).
 */

import { afterEach, beforeEach, expect, test } from "bun:test";
import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";

import { applySchemaMutations } from "../../src/core/brain/schema-mutate.ts";
import { loadSchemaPack } from "../../src/core/brain/schema-pack.ts";
import { assignNoteLabel } from "../../src/core/brain/labels.ts";
import { assignNoteAttribute, AttributeVocabularyError } from "../../src/core/brain/attributes.ts";
import { bootstrapBrain } from "../../src/core/brain/init.ts";
import { runWithSecret } from "../../src/core/brain/secrets/exec.ts";
import { setSecret } from "../../src/core/brain/secrets/store.ts";
import { runMaintenance } from "../../src/core/brain/maintenance/lane.ts";
import { listJournal } from "../../src/core/brain/maintenance/journal.ts";
import { atomicWriteFileSync } from "../../src/core/fs-atomic.ts";
import { indexVault } from "../../src/core/search/indexer.ts";
import { search } from "../../src/core/search/search.ts";
import { Store } from "../../src/core/search/store.ts";
import { makeConfig } from "../helpers/search-fixtures.ts";

/** Schema tokens used by the cases below. */
const DEPENDS_ON = "depends_on";

const NOW = new Date("2026-06-05T03:00:00Z");

let vault: string;
let configHome: string;

beforeEach(() => {
  vault = mkdtempSync(join(tmpdir(), "o2b-wtig-e2e-"));
  configHome = mkdtempSync(join(tmpdir(), "o2b-wtig-cfg-"));
  const configPath = join(configHome, "config.yaml");
  atomicWriteFileSync(configPath, `vault: ${vault}\n`);
  bootstrapBrain(vault, { configPath });
});

afterEach(() => {
  rmSync(vault, { recursive: true, force: true });
  rmSync(configHome, { recursive: true, force: true });
});

test("the suite composes end to end on one vault", async () => {
  // -- 1. Declare the ontology through audited schema mutations --------
  await applySchemaMutations(
    vault,
    [
      { op: "add_type", category: "page_types", token: "paper" },
      { op: "add_type", category: "page_types", token: "receipt" },
      { op: "add_link_type", token: DEPENDS_ON },
      { op: "add_label_dimension", dimension: "priority", values: ["low", "high"] },
      { op: "add_link_constraint", link_type: "depends_on", source: "paper", target: "paper" },
      {
        op: "set_attribute_field",
        type: "paper",
        field: "status",
        description: "reading status, e.g. queued or finished",
      },
    ],
    { actor: "e2e", now: NOW },
  );
  const pack = loadSchemaPack(vault);
  expect(pack.labels["priority"]).toEqual(["low", "high"]);

  // -- 2. Notes: one conforming edge, one violating, one hand-edit bait --
  writeFileSync(
    join(vault, "notes-a.md"),
    '---\ntype: paper\ndepends_on: "[[notes-b]]"\nrelated: "[[notes-c]]"\n---\n\n# A\n\nGovernance pilot note.\n',
  );
  writeFileSync(join(vault, "notes-b.md"), "---\ntype: receipt\n---\n\n# B\n\nA receipt.\n");
  writeFileSync(join(vault, "notes-c.md"), "---\ntype: paper\n---\n\n# C\n\nCompanion paper.\n");
  writeFileSync(
    join(vault, "Brain", "preferences", "pref-canary.md"),
    "---\nkind: brain-preference\nid: pref-canary\ncreated_at: 2026-05-01T00:00:00Z\ntopic: deploys\n---\n\nCanary first.\n",
  );

  // -- 3. Labels: validated assignment, filterable recall ----------------
  assignNoteLabel(vault, "notes-a.md", {
    dimension: "priority",
    value: "high",
    pack,
    agent: "e2e",
    now: NOW,
  });

  const dbPath = join(vault, ".open-second-brain", "brain.sqlite");
  const config = makeConfig({ vault, dbPath });
  const first = await indexVault(config);

  // -- 4. Link constraint: paper->receipt blocked, paper->paper typed ----
  expect(first.relationViolations).toHaveLength(1);
  expect(first.relationViolations[0]).toMatchObject({
    relation: "depends_on",
    sourceType: "paper",
    targetType: "receipt",
  });

  const labeled = await search(config, {
    query: "governance pilot",
    properties: new Map([["labels", ["priority/high"]]]),
  });
  expect(labeled.results.some((r) => r.path === "notes-a.md")).toBe(true);

  // -- 5. Attributes: the error teaches the vocabulary -------------------
  expect(() =>
    assignNoteAttribute(vault, "notes-a.md", { field: "rating", value: "5", pack }),
  ).toThrow(AttributeVocabularyError);
  const attr = assignNoteAttribute(vault, "notes-a.md", {
    field: "status",
    value: "queued",
    pack,
  });
  expect(attr.attributes).toEqual(["status=queued"]);

  // -- 6. Tier drift: hand-edit the join key, detect, restore ------------
  writeFileSync(
    join(vault, "Brain", "preferences", "pref-canary.md"),
    "---\nkind: brain-preference\nid: pref-mangled\ncreated_at: 2026-05-01T00:00:00Z\ntopic: deploys\n---\n\nCanary first, edited by hand.\n",
  );
  const second = await indexVault(config);
  expect(second.tierDrift).toEqual([
    {
      path: "Brain/preferences/pref-canary.md",
      field: "id",
      expected: "pref-canary",
      actual: "pref-mangled",
    },
  ]);
  const store = await Store.open(config, { mode: "write" });
  try {
    const docId = store.getDocumentIdByPath("Brain/preferences/pref-canary.md")!;
    const drift = store.listTierDrift().find((r) => r.documentId === docId)!;
    expect(drift.expected).toBe("pref-canary");
    store.clearTierDrift(docId, "id");
  } finally {
    await store.close();
  }

  // -- 7. Secret custody: redacted exec under the allowlist --------------
  setSecret(vault, {
    name: "deploy-token",
    value: "tok-e2e-secret-31337",
    allow: ["bun -e *"],
    agent: "e2e",
    now: NOW,
  });
  const exec = await runWithSecret(
    vault,
    "deploy-token",
    ["bun", "-e", "console.log('t=' + process.env.DEPLOY_TOKEN)"],
    { agent: "e2e", now: NOW },
  );
  expect(exec.exitCode).toBe(0);
  expect(exec.stdout).not.toContain("tok-e2e-secret-31337");
  const storeRaw = readFileSync(
    join(vault, ".open-second-brain", "secrets", "secrets.json"),
    "utf8",
  );
  expect(storeRaw).not.toContain("tok-e2e-secret-31337");

  // -- 8. Maintenance lane: gated, leased, journaled ----------------------
  const lane = await runMaintenance(vault, {
    now: NOW,
    holder: "e2e@1",
    tasks: [
      {
        name: "reindex",
        run: async () => {
          await indexVault(config);
        },
      },
    ],
  });
  expect(lane.verdict).toBe("run");
  expect(lane.tasks[0]!.ok).toBe(true);
  expect(listJournal(vault).some((e) => e.task === "reindex" && e.ok === true)).toBe(true);
});