teahubxyzandClaude Opus 5.5 e11a2b14c5 editor: open from Teahub; imported steps named and given TeaTalk emoji
TEAHUB panel lists a repo workflows (.github/.gitea) over the API (CORS for this origin) and opens one with a click. Steps are named by their name:, else their action, else their first shell line, and get an emoji by what they do; the trigger is the first node. Export keeps the original file (frame) and name, so a workflow round-trips with only the graph env added. Long chains snake in rows of five; labels truncate with the full name on hover. Checked headless on all 16 teahubxyz/time workflows.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Claude-Session: https://claude.ai/code/session_01FAqjv3zFxJCi2vHvdEMqCr
2026-10-29 18:37:13 +00:00
2026-10-28 23:30:42 +00:00

🧜‍♂️ Merman

Possibility graphs with time.

flowchart LR
  A["💬"] --> B["🍵💭"] --> C["🔎"] --> G{"🛣️"} --> D["🛠️"] --> E["🧪"] --> F["✅"]
  E --> D
  E --> H["🚩👤"] --> D

Mermaid tells you which edges exist. Merman tells you what a token does when it hits them, and when.

  • Graph = all legal futures. Path = one of them, played through time. Emoji string = a path collapsed to one dimension.
  • Projections: possible (the route you picked), happy (the simple path), trace (what actually happened, interventions included). One graph, never deleted branches.
  • Learning is a rewrite, not a traversal. Traversal changes where you are; a rewrite (G₀ → G₁) changes what can happen next.
  • The graph is not the source of truth. raw events → semantic keyframes → Merman projection → evidence/replay. Merman is the middle layer: more legible than an event stream, lighter than a full replay.

Lineage: started as mermaid × manim, became user-flow graphs for Teahub. Ported here from matcha/greentea on hb-5 (Oct 2026). Owned by the factory's CEO lane.

What's here

path what
merman/ the interactive playground (pick two nodes, enumerate paths, press play)
merman/v0/ the v0 visual editor
film/ the narrated explainer (story.json is the script)
docs/merman-user-journey.md the Teahub happy path, emoji-only
docs/spec.md where it goes next: typed edges, gates, freeze, exits
ops/, tests/ legacy publish route + tests from greentea

TeaTalk

Emoji are a redundant semantic channel, not decoration. 🍵 Tea/agent · 💭 think · 🔎 inspect · 🛣️ route · 🛠️ work · 🧪 verify · ⏳ wait · 🚩 andon · 👤 human · 🎛️ cockpit · ✅ accepted · 🌱 learn.

Compact checksum: 🍵💭 → 🔎 → 🛠️ → 🧪 → ✅

S
Description
🧜‍♂️ Merman — possibility graphs with time: happy paths, traces, gates and rewrites for agent flows. Mermaid is the editable projection; evidence underneath.
Readme
2.1 MiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 38.8%
JavaScript 29.7%
HTML 19.8%
Python 10.1%
Shell 1.6%