aboutsummaryrefslogtreecommitdiffstats
path: root/docs/superpowers/specs
diff options
context:
space:
mode:
Diffstat (limited to 'docs/superpowers/specs')
-rw-r--r--docs/superpowers/specs/2026-09-17-system-widgets-design.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/superpowers/specs/2026-09-17-system-widgets-design.md b/docs/superpowers/specs/2026-09-17-system-widgets-design.md
index 9fee4a5..cd24ee0 100644
--- a/docs/superpowers/specs/2026-09-17-system-widgets-design.md
+++ b/docs/superpowers/specs/2026-09-17-system-widgets-design.md
@@ -239,6 +239,18 @@ crashed widget.
beside the heading, so an unreachable NFS server or a dead sampler is visible
rather than silently showing yesterday's numbers.
+> **Implementation note (deferred): the age marker is not drawn.** The
+> requirement above is deliberately unimplemented in this wave. The cache
+> formats and their parser fixtures are fixed by the plan, and the widgets
+> already implement the absent-file case (`no cache data` plus the sampler
+> name). Adding the marker means either embedding an epoch timestamp in each
+> cache file, which would disturb every fixture and the two parsers, or
+> stamping the file's mtime, which conky's Lua cannot stat: `lfs` is not
+> available in the environment. The accepted path when it is picked up is an
+> extra epoch line that the parser learns to skip, leaving the existing fields
+> and fixtures untouched; the widget then compares it against the sampling
+> interval and draws a dim age marker beside the heading.
+
## Tests
`test/test_data.lua` extends with fixtures under `test/fixtures/`: