Skip to content

Release v1.10.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 30 Sep 21:48
v1.10.0
346d221
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Summary

Git counting now sees work it used to miss, and reports gain weekly periods, period comparison, and Markdown and HTML output. Everyday flags can live in the config file, and the documentation moved into focused guides under docs/.

Added

  • Weekly periods: --period week, --group-by week and --week YYYY-Www|current|last group and filter a report by ISO 8601 week.
  • --compare previous (or a named YYYY-MM, YYYY-Www or YYYY window) shows the headline figures beside the previous period's, with changes labelled as estimates. Each side is exactly the report that window prints alone.
  • --format markdown and --format html for reports and workstats allocate. The HTML is a single self-contained file with no scripts or external references. Both formats escape every value, stop GitHub mentions and issue links, and replace your home directory with ~.
  • A defaults block in the config file for everyday flags (dir, depth, format, providers, group_by, gap_cap, human_idle, review_credit). A flag always wins, and the output names the defaults that applied.
  • --author can be given more than once, and the config file accepts authors, so several Git identities count as you.
  • model_rates in the config file overrides or adds per-model list rates for workstats allocate, and allocate warns when the built-in rate table is more than 90 days old.
  • A warning when a tool's history files are read but yield no usable activity, which usually means the tool changed its history format.

Changed

  • The documentation moved from the README into guides under docs/: install, usage, configuration, how it works, allocate, privacy and development.
  • The transcript index is also keyed on the workstats version, so an upgrade never answers from entries an older parser wrote.
  • A config file with an invalid authors, defaults or model_rates value is refused with an error naming the key, instead of being ignored as a whole.

Fixed

  • Commits on every local branch are counted, not only those reachable from the checked-out branch.
  • The report window is decided by author date, so rebased and amended commits are no longer dropped from the period they were written in. Reports for past periods also no longer diff every later commit.
  • workstats allocate names every window flag it accepts when no window is given.
Assets 9
Loading