Module: Rubino::UI::ToolLabel

Defined in:
lib/rubino/ui/tool_label.rb

Overview

Shared vocabulary for the concise ‘name hint` tool label used across adapters — the interactive `● edit foo.rb` card open-row (UI::CLI) AND the non-interactive one-shot stderr trace (UI::HeadlessTrace) draw their hint from here so the two never drift. The hint is the single most-identifying argument (pattern / file_path / path / command), secrets-masked and terminal-sanitized so an untrusted filename/command can never drive the terminal from a label row (R3C-1, CWE-150).

Class Method Summary collapse

Class Method Details

.hint(arguments, max: 60, verbose: false) ⇒ Object

The concise, sanitized hint string for a tool’s arguments — the first line, secrets-masked, escape-stripped, truncated to ‘max` chars. Returns nil when there’s no identifying argument. ‘verbose:` raises the cap so a `–verbose` one-shot trace can show fuller args.



31
32
33
34
35
36
37
38
39
40
41
 
# File 'lib/rubino/ui/tool_label.rb', line 31

def hint(arguments, max: 60, verbose: false)
  picked = pick_hint(arguments)
  return nil unless picked

  raw_key, raw_value = picked
  masked = Util::SecretsMask.mask_value(raw_value, key: raw_key).to_s
  clean  = Util::Output.sanitize_terminal(masked)
  first  = clean.lines.first.to_s.strip
  cap    = verbose ? max * 4 : max
  first.length > cap ? "#{first[0, cap - 3]}..." : first
end

.label(name, arguments, max: 60, verbose: false) ⇒ Object

The full ‘name hint` label (e.g. `edit foo.rb`, `bash npm test`, `read README.md`). Falls back to the bare tool name when the tool has no identifying argument.



46
47
48
49
 
# File 'lib/rubino/ui/tool_label.rb', line 46

def label(name, arguments, max: 60, verbose: false)
  h = hint(arguments, max: max, verbose: verbose)
  h && !h.empty? ? "#{name} #{h}" : name.to_s
end

.pick_hint(arguments) ⇒ Object

Picks the most-identifying [key, value] pair from a tool’s arguments, in priority order. Returns nil when none of the known keys carry a value.



17
18
19
20
21
22
23
24
25
 
# File 'lib/rubino/ui/tool_label.rb', line 17

def pick_hint(arguments)
  return nil unless arguments.is_a?(Hash)

  %i[pattern file_path path command].each do |k|
    v = arguments[k] || arguments[k.to_s]
    return [k, v] if v && !v.to_s.empty?
  end
  nil
end