aboutsummaryrefslogtreecommitdiffstats
path: root/docs/superpowers/specs/2026-09-17-network-slackware-widgets-design.md
AgeCommit message (Collapse)AuthorFilesLines
2026-09-17docs: correct the claim about counting a symlinked directoryDanilo M.1-5/+7
GNU ls follows a symlink to a directory with or without a trailing slash, so both forms count the packages correctly. Only -d lists the link itself. The original claim came from a count taken where the path did not resolve at all, and it reached the spec, the plan and two commit messages. The count was always right; the reason given for it was not, and a comment that teaches the next reader something false is worse than no comment. Records the real trap in its place: ls aliased to a long format counts its "total" header as a package. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17docs: design the network and slackware widgetsDanilo M.1-0/+313
Two new cards and three fixes to existing ones. The network card reads the interface byte counters directly and keeps its own history, one sample per pixel column, so the chart never interpolates. Both series share one autoscale: drawn independently, a 200kB/s upload would look like a 40MB/s download. The public address moves from the old config's 5 minute poll to 30 minutes, since a residential address is stable for days. The slackware card takes its numbers from a sampler rather than the draw hook, and stores epochs instead of reconstructed dates. The shell function it replaces parses ls -l output and hardcodes the year, which breaks every January and on any file older than six months. Records two things found while checking real values against the design: /var/log/packages is a symlink, so counting it without a trailing slash reports 1 package rather than 2817, and the ChangeLog mtime on this machine currently reads in the future, so the age arithmetic has to survive a negative difference. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>