ShrubberyDocs
Sign in

Timeline

Definition

The per-row Audit Trail rendered as a chronological event list inside the Detail Sheet. The Timeline is the visible surface of the audit trail for a single Shrubbery.

Avoid: history, log, activity feed.

Role

The Timeline gives both the Lead and the Knight a complete, ordered view of everything that happened to a Shrubbery: when it was created, by which capture path, when it was sent, who Handshaked and when, whether it was renegotiated and what changed, and who ultimately completed or refused it.

Each entry in the Timeline shows the event type, the actor (user display name or "API" for actor_kind = api_token), and the timestamp. Renegotiation entries show a diff of the changed fields. The Timeline is newest-first and is not paginated in the current implementation.

The Timeline is read-only and always up to date — it reflects the live audit trail with no caching delay.

Lifecycle

Not a stateful concept. The Timeline is a render of the Audit Trail for a single row; it has no state of its own.

Last updated: 22 June 2026