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
Today operator surface - implementation plan
Order follows dependency flow: grammar first (shared by loops and write-back), then the independent renderers, then the composing dashboard, then write-back, then surfaces. Each task is one atomic conventional commit; formatter + linter green before every commit; TDD (failing test first) within each task.
Tasks
Task 1: widen the @osb marker grammar to per-kind field sets
- Files:
src/core/brain/inline.ts,tests/core/brain.inline.test.ts(extend) - Acceptance:
parseInlineMarker/parseBlockMarkeracceptloop(free text, optionalid=) andset(requirednote=,field=,value=) kinds;loop close id=<id>parses as a close token;feedbackbehavior byte-identical (all existing tests pass unchanged); unknown kinds still reject. - Depends on: none
Task 2: open-loops live scan and open-set computation
- Files:
src/core/brain/open-loops.ts,tests/core/brain/open-loops.test.ts - Acceptance: scanning a tmp vault with loop markers across
configured note paths returns open loops with deterministic ids
(hash of normalized text, or explicit
id=); a close token removes the loop from the open set; consumed-sentinel and fence rules matchdiscoverMarkers; loop markers are never annotated or rewritten; size/ignore limits honored. - Depends on: Task 1
Task 3: merged chronological activity timeline renderer
- Files:
src/core/brain/temporal/activity-timeline.ts,tests/core/brain/temporal/activity-timeline.test.ts - Acceptance: given a
TimelineIndex, returns bullets merged chronologically across event kinds (newest first), each- [<kind>] <text> · <relative age>; window and limit options; deterministic under injectednow; ordering/tie-break behavior of the index pinned by tests. - Depends on: none
Task 4: today dashboard builder
- Files:
src/core/brain/today-dashboard.ts,tests/core/brain/today-dashboard.test.ts - Acceptance:
buildTodayDashboard(vault, { now, ... })returns a frozen envelope with four sections - obligations (due/overdue vialistObligations), open loops (Task 2), recent activity (Task 3), totals - plus rendered Markdown; a section that fails to compute yields an explicit per-section error entry, the rest still render; read-only (no writes to the vault). - Depends on: Tasks 2, 3
Task 5: exact-title note resolver
- Files:
src/core/brain/notes/note-title-resolver.ts,tests/core/brain/note-title-resolver.test.ts - Acceptance:
[[Title]]resolves to exactly one vault page by exact title match; zero or multiple matches throw a typed error listing candidates; path inputs delegate toresolveNotePath. - Depends on: none
Task 6: marker write-back engine
- Files:
src/core/brain/marker-writeback.ts,src/core/brain/types.ts(new log event kind),src/core/brain/policy.ts(guardrail flag),tests/core/brain/marker-writeback.test.ts - Acceptance: report mode lists pending
setmarkers with resolved targets and validation results without writing; apply mode requiresmarker_writebackguardrail (off - typed refusal), applies viaassignNoteAttribute, emits oneattribute-writelog event per applied mutation (prior value captured), annotates applied markers viarewriteMarkers; re-run applies nothing (idempotent); ambiguous or unresolvable targets fail that marker with a candidate-listing error and leave it unconsumed. - Depends on: Tasks 1, 5
Task 7: CLI verbs and MCP surface
- Files:
src/cli/brain/verbs/today.ts,src/cli/brain/verbs/apply-markers.ts,src/cli/brain.ts,src/cli/brain/helpers.ts,src/mcp/brain/brief-tools.ts(view=today; write-back stays CLI-only, no new MCP tool), test extensions for the touched surfaces - Acceptance:
o2b brain today [--json]renders the dashboard;o2b brain apply-markers [--apply] [--json]reports/applies;brain_brief view=todayreturns the dashboard envelope; existing views untouched (their tests unchanged); help text updated. - Depends on: Tasks 4, 6
Task 8: docs, changelog, version
- Files:
README.md,CHANGELOG.md,package.json+ manifest sync,docs/brainstorm/today-operator-surface/final status - Acceptance: README documents the dashboard, loop markers, close
convention, and guarded write-back; CHANGELOG entry under the next
version with link reference;
bun run scripts/sync-version.ts --checkgreen. - Depends on: Tasks 1-7