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.0 KB
Raw Blame
import type { BrainEventCounts } from "./log-counts.ts";
import type { GitActivity } from "./activity-git.ts";
import type { VaultDelta } from "./vault-delta.ts";
import type { TranscriptActivity } from "./transcripts/types.ts";
import type { ComplexityReport } from "./complexity.ts";

export interface RepoActivityRow {
  readonly path: string;
  readonly git: GitActivity;
}
export interface NonRepoActivityRow {
  readonly path: string;
  readonly modifiedFiles: number;
}

export interface ActivitySummary {
  readonly repo: ReadonlyArray<RepoActivityRow>;
  readonly nonRepo: ReadonlyArray<NonRepoActivityRow>;
  readonly vaultDelta: VaultDelta;
  /** Productivity-trap detector: structure churn compared to thinking output. */
  readonly complexity?: ComplexityReport;
  /**
   * Per-runtime session-transcript activity (v0.10.11). Optional so
   * the type is back-compat with callers / tests that have not been
   * migrated yet. When present and non-empty it adds a
   * `transcript-confirmed` sub-reason to an `alert` row.
   */
  readonly transcripts?: TranscriptActivity;
}

/**
 * Did at least one per-runtime transcript surface activity in the
 * report window? Used by the renderer to add a `transcript-confirmed`
 * hint to an `alert` row.
 */
export function transcriptConfirmed(activity: ActivitySummary): boolean {
  return (activity.transcripts?.totalFiles ?? 0) > 0;
}

/**
 * Runtimes whose transcript store exists and could not be enumerated, so
 * their contribution to `totalFiles` is a lower bound rather than a
 * measurement. Separate from {@link transcriptConfirmed} because the two
 * answer opposite questions: one asks whether activity was seen, this one
 * asks whether the looking worked.
 */
export function transcriptsUnreadable(activity: ActivitySummary): ReadonlyArray<string> {
  return activity.transcripts?.unreadableRuntimes ?? [];
}

export type DisciplineStatus = "ok" | "info" | "alert";

export function decideStatus(
  events: BrainEventCounts,
  activity: ActivitySummary,
): DisciplineStatus {
  // Taste events only: feedback + apply_evidence. The `other` bucket
  // (snapshot / dream-pass / import-claude-memory)
  // would otherwise mask a real "agent shipped artifacts but recorded
  // zero taste signals" day — exactly the regression §D exists to catch.
  let tasteEvents = 0;
  for (const c of Object.values(events.byAgent)) {
    tasteEvents += c.feedback + c.apply_evidence;
  }
  for (const u of events.unknownAgents) {
    tasteEvents += u.counts.feedback + u.counts.apply_evidence;
  }
  const complexityWarning = activity.complexity?.warning === true;
  if (tasteEvents > 0 && !complexityWarning) return "ok";
  const repoCommits = activity.repo.reduce((a, r) => a + r.git.commits, 0);
  const mtimeFiles = activity.nonRepo.reduce((a, r) => a + r.modifiedFiles, 0);
  const vaultActive = activity.vaultDelta.total > 0;
  const activitySignal = repoCommits > 0 || mtimeFiles >= 3 || vaultActive || complexityWarning;
  return activitySignal ? "alert" : "info";
}