lux-hammer 0.3.30 → 0.8.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2ca175d7445c386d0c8bd3be6834b057e6b958ee3d0de48d72e49a53ef4da776
-  data.tar.gz: 3303a15ee74702d81ebfba70d15366870bfb8dccc2d5b0fc8c5304e2fe28ef0e
+  metadata.gz: 62f3507ae302513e173b9c4ee719b1c27448d47ef4a8568f0be0e8e8485410c5
+  data.tar.gz: 92983a6f6e7c0dd96c75f0dd3abca3bab91808c4f2c10b93205aa426932d7405
 SHA512:
-  metadata.gz: d925611cf831aa0e6c4198d4761bdcb04b7454afab82a8cc12100130e23dc63139f3bad8fbf0473cd67f7bf71ea46ef3ceeb91e266f6bddba51f4097469231dc
-  data.tar.gz: a489e910f4027422474b1741a0ff45e4e5729009af2d5c6ba7fbf79a7f11661e547b9947058c6b5c237e41fbecfc5baa9a2a2686158a95460a0c2be7ba4bf329
+  metadata.gz: 1fd6204a4915f166d68bbb51fe33474ae44dff46e088486e939b0f7b887378a150548cb5fb646c25699381fcfeb79c97ed4028ee0149a1f8872daac38b755eee
+  data.tar.gz: c798f9716fe791388075077034486e817dca3025a9f042bf04d8ac472c2af8e1c67d36b4914c8c100ecf7fd253d830738ccca619ce2aabe7808130232c980571

data/.version

@@ -1 +1 @@
-0.3.30
+0.8.4

data/AGENTS.md

@@ -15,8 +15,9 @@ usable as a library (`require 'lux-hammer'`, subclass `Hammer`, call
 
 * **One root constant**: `Hammer`. Never pollute `Object` or introduce
   another top-level constant. Sub-types live as `Hammer::Shell`,
-  `Hammer::Option`, `Hammer::Parser`, `Hammer::Command`,
-  `Hammer::Loader`, `Hammer::Builder`, `Hammer::CommandBuilder`. The one
+  `Hammer::Version`, `Hammer::Option`, `Hammer::Parser`,
+  `Hammer::Command`, `Hammer::Loader`, `Hammer::Builder`,
+  `Hammer::CommandBuilder`. The one
   exception is `String#color(:name)` (defined in `lib/hammer/shell.rb`)
   - a tiny convenience for `"hi".color(:cyan)`. Do not add more
   monkey-patches.
@@ -39,6 +40,7 @@ usable as a library (`require 'lux-hammer'`, subclass `Hammer`, call
 bin/hammer                  # CLI entry point
 lib/lux-hammer.rb           # Entry - defines class Hammer and its DSL
 lib/hammer/shell.rb         # ANSI/IO helpers
+lib/hammer/version.rb       # Hammer::Version - git-count version + .version fallback
 lib/hammer/option.rb        # One option definition (types: string/boolean/integer/float/array/json)
 lib/hammer/input.rb         # opts[:stdin], prepare_json!, JSON @file / pipe helpers
 lib/hammer/parser.rb        # ARGV -> [positional, opts_hash]
@@ -58,6 +60,7 @@ test/parser_test.rb         # ARGV parsing edge cases
 test/option_test.rb         # Option declaration / casting
 test/command_test.rb        # Command data type
 test/shell_test.rb          # ANSI / IO helpers
+test/version_test.rb        # version formatting (git count -> dotted)
 test/cli_test.rb            # `hammer` binary end-to-end
 test/cron_test.rb           # schedule parser (matches?/due?/next_run)
 test/cron_server_test.rb    # job discovery, state, rotation, web UI
@@ -422,6 +425,22 @@ new code in this gem should show.
 * Inside a handler, just call `error 'msg'` - it resolves via the
   `Shell` mixin.
 
+## Versioning
+
+* `Hammer::VERSION` is the dboss-style formatted commit count on `main`
+  (falling back to `master`, then `HEAD`): `v82` -> `0.8.2`, `v1123` ->
+  `11.2.3`, left-padded so `v5` -> `0.0.5`. It is bare (no leading `v`)
+  so it stays a valid `Gem::Version`.
+* `Hammer::Version.string` is that value, `Hammer::Version.raw` is the
+  `v<count>` behind it, and `Hammer::Version.format` is the pure
+  formatter (a non-`v<digits>` string is returned unchanged).
+* A released gem has no `.git` and falls back to the committed
+  `.version` file. `hammer gem --inc` writes the git-count value into
+  `.version` (overwriting `.version.prev`), so the built gem's version
+  matches the checkout; the release workflow tags `v$(cat .version)`.
+* Don't reintroduce manual major/minor/patch bumps - the count is the
+  version.
+
 ## Coding rules
 
 * No trailing spaces on empty lines. End every file with a newline.

data/lib/hammer/version.rb

@@ -0,0 +1,52 @@
+class Hammer
+  # The running version, derived the way dboss derives its own: the number
+  # of commits reachable from main (or master, or HEAD) rendered as a dotted
+  # triple, so v82 -> 0.8.2 and v1123 -> 11.2.3. A released gem has no .git
+  # and falls back to the .version file baked in at build time, which is also
+  # what `hammer gem --inc` writes.
+  module Version
+    module_function
+
+    ROOT ||= File.expand_path('../..', __dir__)
+
+    # Dotted, no leading v, so it stays a valid Gem::Version (v1.2.3 -> 1.2.3).
+    def string
+      format(raw)
+    end
+
+    # v<commit count> in a git checkout, else the packaged .version string.
+    def raw
+      count = git_count
+      count ? "v#{count}" : file_version
+    end
+
+    # v123 -> 1.2.3, v1123 -> 11.2.3, v5 -> 0.0.5. Anything that is not
+    # v<digits> (dev, an already-dotted version) is returned unchanged.
+    def format(version)
+      text  = version.to_s
+      count = text.start_with?('v') ? text[1..] : nil
+      return text unless count && !count.empty? && count.match?(/\A\d+\z/)
+
+      count = count.rjust(3, '0')
+      "#{count[0...-2]}.#{count[-2]}.#{count[-1]}"
+    end
+
+    def git_count
+      return nil unless File.exist?(File.join(ROOT, '.git'))
+
+      %w[main master HEAD].each do |ref|
+        out = IO.popen(['git', '-C', ROOT, 'rev-list', '--count', ref],
+                       err: File::NULL, &:read).to_s.strip
+        return out.to_i if out.match?(/\A\d+\z/)
+      end
+      nil
+    rescue SystemCallError
+      nil
+    end
+
+    def file_version
+      path = File.join(ROOT, '.version')
+      File.exist?(path) ? File.read(path).strip : 'dev'
+    end
+  end
+end

data/lib/lux-hammer.rb

@@ -1,4 +1,5 @@
 require_relative 'hammer/shell'
+require_relative 'hammer/version'
 require_relative 'hammer/input'
 require_relative 'hammer/option'
 require_relative 'hammer/parser'
@@ -47,8 +48,9 @@ class Hammer
   Error          ||= Class.new(StandardError)
   AmbiguousMatch ||= Class.new(Error)
 
-  # Gem version, read once from the bundled .version file.
-  VERSION ||= File.read(File.expand_path('../.version', __dir__)).strip
+  # Gem version: the formatted main-branch commit count in a checkout, or the
+  # bundled .version baked into a released gem. See Hammer::Version.
+  VERSION ||= Version.string
 
   # Convenience aliases so recipes can write `Hammer.prepare_json!(opts)`
   # without the Input module path. See Hammer::Input.

data/recipes/lib/llm/usage.rb

@@ -770,12 +770,19 @@ module LlmUsage
 
   def row_cells(row, period)
     if period_label(period) == 'month'
-      [row.name, row.month_pct || '-', row.month_reset || '-']
+      [row.name, utilization_bar(row.month_pct), row.month_reset || '-']
     else
-      [row.name, row.session_pct, row.session_reset, row.week_pct, row.week_reset]
+      [row.name, utilization_bar(row.session_pct), row.session_reset, utilization_bar(row.week_pct), row.week_reset]
     end
   end
 
+  def utilization_bar(value)
+    return '-' if value.nil? || value == '-'
+
+    filled = (value.to_f.clamp(0, 100) / 10).round
+    "[#{'#' * filled}#{'-' * (10 - filled)}] #{value.rjust(4)}"
+  end
+
   def row_to_hash(row, period: nil)
     if period_label(period) == 'month'
       # Mirror row_cells: providers with no month window render '-', not null.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lux-hammer
 version: !ruby/object:Gem::Version
-  version: 0.3.30
+  version: 0.8.4
 platform: ruby
 authors:
 - Dino Reic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-26 00:00:00.000000000 Z
+date: 2026-10-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -52,6 +52,7 @@ files:
 - "./lib/hammer/parser.rb"
 - "./lib/hammer/recipe.rb"
 - "./lib/hammer/shell.rb"
+- "./lib/hammer/version.rb"
 - "./lib/lux-hammer.rb"
 - "./recipes/deploy.rb"
 - "./recipes/git-helper.rb"