Skip to main content
← Back to list
01Issue
FeatureShippedSwamp ClubPublic
AssigneesNone

Relationships

↔ sibling #4556

#4417 Docs: usage-telemetry reference should describe the telemetry stats empty state and the last-flush record

Opened by stack72 · 11/5/2026· Shipped 11/10/2026

swamp-club#3833 changes swamp telemetry stats so its empty state explains why it is empty. The CLI keeps a small last-flush record (flush-state.json beside the user-global spool: last attempt time and result, last success time and entry count). When stats finds no entries it still prints No telemetry data found, then one line: telemetry is opted out (user-level preference or SWAMP_NO_TELEMETRY / DO_NOT_TRACK), or the spool is empty because the last flush sent N entries at a given time (with a pointer to the telemetryKeepFlushed repository key), or the last attempt failed, or nothing has been recorded yet. JSON output keeps message and adds telemetryEnabled, disabledBy, lastFlush and keepFlushedKey fields.

Manual page to update: content/manual/reference usage-telemetry-events, Local spool section. Add flush-state.json to the spool description, describe the empty-state output in log and JSON mode, and state that with telemetryKeepFlushed on, stats counts the kept .flushed.json entries. Land after #3833 ships.

02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPEDLINKED+ 3 MOREPR_LINKED+ 1 MORESESSION_SUMMARIZED

Shipped

11/10/2026, 7:10:31 AM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 linked sibling of #455611/9/2026, 11:34:03 PM

Sign in to post a ripple.