From 581ec2949283aee8e6716f2fe528c5f6454e25df Mon Sep 17 00:00:00 2001
From: Miguel Palhas <mpalhas@gmail.com>
Date: Mon, 24 Aug 2026 19:32:08 +0100
Subject: [PATCH] docs(maestro): name the activity dot in the card contract

---
 docs/SIDEBAR.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/docs/SIDEBAR.md b/docs/SIDEBAR.md
index c3e5eb4..55cbd49 100644
--- a/docs/SIDEBAR.md
+++ b/docs/SIDEBAR.md
@@ -41,9 +41,14 @@ Otherwise line 2 is absent — never an empty placeholder row.
 When present, line 2 reads left to right:
 
 ```
-<duration> [<state badge>] [<blocked work> | exited]
+<dot> <duration> [<blocked work> | exited]
 ```
 
+`<dot>` is a single filled glyph (`●` on both clients) carrying the activity
+state's colour, and `<duration>` follows in the same colour. There is no state
+word and no second badge: the dot exists so the state is still legible when a
+row is dimmed or the terminal renders the duration in the default fg.
+
 ## Colour per activity state
 
 The state word is never spelled out — the colour carries it.