ruby-progress 1.3.1 → 1.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f08082d9cebd17f7d3ece436ff76e4f4beb8f934d803719a6bdc3477fa8c97b
-  data.tar.gz: da85e2d2e2587c13f4c778094fb1dcd8e2aa832dd0cff34b947b90db0f4e6585
+  metadata.gz: 5c5a7ddc53059cb7f6d2b7bd1c066653058e1dbb281f4c23aa04229ce360a594
+  data.tar.gz: 0446a713142b93f16b9fe3e102c8a3c0db3194db17da25de7f1f7f31e5090907
 SHA512:
-  metadata.gz: f3a816024fd6cc2aba00edd334c8b82e3783d6be3916bc36238172add46c695febcd80689ba49179b0d48a2175f983dca6b381e482c143e72f2bb0d80804b247
-  data.tar.gz: 56fe19077105ebf00cdae2c939eb761d0b37ae4f4cb82b439207c0562ed46cd97abd9105e7b6c0789868fa6087f5d646736b3ad0a58d3df6d09e5028add6d4bf
+  metadata.gz: 3cda8e32c95b8bd03d6c8549de1b3f4fc488f868cb028a554ddc44654428978bfd1db4178a1cb0a0a71c9a0c8ea46a1cc8da844c4026ef9b84ed45c1b43f4691
+  data.tar.gz: 39c31e85f87ea2201cbf3267fefedff1f4946f6bef9b1ee6178b8e1b5ecf8569a8391c20519582a1077bd6d352d229b01997ceedb358eeb049cf484c895028ed

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-10-09 14:47:16 UTC using RuboCop version 1.75.7.
+# on 2025-10-13 12:49:46 UTC using RuboCop version 1.75.7.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -22,11 +22,10 @@ Layout/TrailingEmptyLines:
   Exclude:
     - 'test_worm_flags.rb'
 
-# Offense count: 4
+# Offense count: 2
 # Configuration parameters: IgnoreLiteralBranches, IgnoreConstantBranches, IgnoreDuplicateElseBranch.
 Lint/DuplicateBranch:
   Exclude:
-    - 'bin/prg'
     - 'lib/ruby-progress/utils.rb'
     - 'lib/ruby-progress/worm.rb'
 
@@ -36,6 +35,12 @@ Lint/EmptyBlock:
   Exclude:
     - 'spec/worm_integration_spec.rb'
 
+# Offense count: 1
+# Configuration parameters: MaximumRangeSize.
+Lint/MissingCopEnableDirective:
+  Exclude:
+    - 'lib/ruby-progress/fill_cli.rb'
+
 # Offense count: 2
 # This cop supports safe autocorrection (--autocorrect).
 Lint/ScriptPermission:
@@ -43,63 +48,49 @@ Lint/ScriptPermission:
     - 'demo_gem.rb'
     - 'demo_worm_infinite.rb'
 
-# Offense count: 1
-Lint/SelfAssignment:
-  Exclude:
-    - 'lib/ruby-progress/ripple.rb'
-
-# Offense count: 1
-# This cop supports safe autocorrection (--autocorrect).
-# Configuration parameters: AutoCorrect, AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
-# NotImplementedExceptions: NotImplementedError
-Lint/UnusedMethodArgument:
-  Exclude:
-    - 'lib/ruby-progress/worm.rb'
-
-# Offense count: 23
+# Offense count: 22
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AutoCorrect.
 Lint/UselessAssignment:
   Exclude:
     - 'demo_gem.rb'
-    - 'lib/ruby-progress/worm.rb'
     - 'spec/cli_integration_spec.rb'
 
-# Offense count: 20
+# Offense count: 52
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
 Metrics/AbcSize:
-  Max: 114
+  Max: 122
 
-# Offense count: 17
+# Offense count: 49
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 # AllowedMethods: refine
 Metrics/BlockLength:
-  Max: 109
+  Max: 111
 
-# Offense count: 2
+# Offense count: 4
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ClassLength:
-  Max: 254
+  Max: 268
 
-# Offense count: 12
+# Offense count: 30
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/CyclomaticComplexity:
-  Max: 19
+  Max: 26
 
-# Offense count: 31
+# Offense count: 68
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
 Metrics/MethodLength:
-  Max: 131
+  Max: 156
 
-# Offense count: 3
+# Offense count: 9
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ModuleLength:
-  Max: 206
+  Max: 285
 
-# Offense count: 10
+# Offense count: 31
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/PerceivedComplexity:
-  Max: 20
+  Max: 27
 
 # Offense count: 1
 # Configuration parameters: ExpectMatchingDefinition, CheckDefinitionPathHierarchy, CheckDefinitionPathHierarchyRoots, Regex, IgnoreExecutableScripts, AllowedAcronyms.
@@ -110,7 +101,7 @@ Naming/FileName:
     - 'Rakefile.rb'
     - 'lib/ruby-progress.rb'
 
-# Offense count: 17
+# Offense count: 10
 # Configuration parameters: EnforcedStyle, CheckMethodNames, CheckSymbols, AllowedIdentifiers, AllowedPatterns.
 # SupportedStyles: snake_case, normalcase, non_integer
 # AllowedIdentifiers: TLS1_1, TLS1_2, capture3, iso8601, rfc1123_date, rfc822, rfc2822, rfc3339, x86_64
@@ -127,15 +118,6 @@ Style/Documentation:
     - 'lib/ruby-progress.rb'
     - 'lib/ruby-progress/daemon.rb'
 
-# Offense count: 4
-# This cop supports unsafe autocorrection (--autocorrect-all).
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: allowed_in_returns, forbidden
-Style/DoubleNegation:
-  Exclude:
-    - 'bin/prg'
-    - 'lib/ruby-progress/worm.rb'
-
 # Offense count: 1
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AutoCorrect, EnforcedStyle, AllowComments.
@@ -167,14 +149,13 @@ Style/InfiniteLoop:
   Exclude:
     - 'lib/ruby-progress/ripple.rb'
 
-# Offense count: 2
+# Offense count: 1
 # This cop supports unsafe autocorrection (--autocorrect-all).
 # Configuration parameters: EnforcedStyle, AllowedMethods, AllowedPatterns.
 # SupportedStyles: predicate, comparison
 Style/NumericPredicate:
   Exclude:
     - 'spec/**/*'
-    - 'bin/prg'
     - 'lib/ruby-progress/ripple.rb'
 
 # Offense count: 1
@@ -193,7 +174,7 @@ Style/StringLiterals:
   Exclude:
     - 'test_worm_flags.rb'
 
-# Offense count: 3
+# Offense count: 39
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns, SplitStrings.
 # URISchemes: http, https

data/CHANGELOG.md

@@ -27,7 +27,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Merge commit: 99d9c39 (squash-merge of feature/output-handling)
 
-## 1.3.1 - 2025-10-12
+## 1.3.2 - 2025-10-13
 
 ### Added
 
@@ -35,6 +35,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- Added `--stop-id NAME` shorthand for targeting named daemons (implies `--stop` and normalizes the name to the canonical PID filename). This is a small convenience used by the demo and scripts.
+- Demo: updated `demo_screencast.rb` to call the local `bin/prg` when stopping the demo daemon to avoid conflicts with system-installed versions.
+
+### Changed
+
 - Bumped `FILL_VERSION` (patch) to reflect the new CLI behavior.
 
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    ruby-progress (1.3.1)
+    ruby-progress (1.3.2)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -98,6 +98,39 @@ echo "bundle exec rake db:migrate" | prg job send --stdin --daemon-name mytask
 prg job send --daemon-name mytask --command "./deploy-step.sh" --wait --timeout 30
 ```
 
+You can also send control/action jobs (no shell command) to a running daemon. These are JSON payloads with an `action` key handled by the daemon's job processor. The helper supports a few common actions:
+
+```bash
+# Send a simple 'advance' action (no value)
+prg job send --daemon-name demo --advance
+
+# Send a 'percent' action with a numeric value
+prg job send --daemon-name demo --percent 42
+
+# Example using `fill` as a named daemon and sending percent updates
+```bash
+# Start a named fill worker (non-detaching so animation remains visible)
+prg fill --daemon-as demo --no-detach --output-lines 3 --output-position top
+
+# Send percent updates to the named worker
+prg job send --daemon-name demo --percent 10 --wait
+prg job send --daemon-name demo --percent 50 --wait
+prg job send --daemon-name demo --percent 100 --wait
+```
+
+# Or use the generic action/value pair
+prg job send --daemon-name demo --action percent --value 42
+```
+
+Note about stopping named daemons:
+
+You can target named daemons directly using the `--stop-id NAME` shorthand which implies `--stop` and targets the named daemon (it is normalized to the canonical daemon name used for the PID file). This is convenient for scripts and demos. Example:
+
+```bash
+# Stop a named fill worker with a success message
+prg fill --stop-id demo --stop-success 'Demo finished'
+```
+
 Behavior and file layout:
 
 - Jobs are written as JSON files into the daemon's job directory, which is derived from the daemon PID file. For example, a PID file `/tmp/ruby-progress/mytask.pid` maps to the job directory `/tmp/ruby-progress/mytask.jobs`.
@@ -139,6 +172,21 @@ This file is intended for short messages and small captured output snippets (the
 Below is an example script that demonstrates starting a worm daemon, sending a job, waiting for the result, and stopping the daemon.
 ---
 
+If you want the background worker to continue writing to the same terminal (so you can visually watch the animation while your script continues), use the non-detaching background mode:
+
+```bash
+# Start a named worm worker that backgrounds but does not fully detach
+prg worm --daemon-as demo --no-detach
+
+# In the same script or a subsequent command, enqueue a job to that worker
+prg job send --daemon-name demo --command "echo hello; sleep 1; echo done" --wait
+
+# Stop the worker with a success message
+prg worm --stop-id demo --stop-success "Demo finished"
+```
+
+Note: Non-detaching mode keeps the child process attached to the controlling TTY. That means both the worker and the invoking shell may write to the terminal and outputs can interleave.
+
 ## Ripple
 
 Ripple is a sophisticated text animation library that creates ripple effects across text strings in the terminal. It supports various animation modes including bidirectional movement, and rainbow colors.

data/Rakefile

@@ -108,7 +108,6 @@ namespace :markdown do
     !!(line =~ /^\s*```|^\s*~~~/)
   end
 
-  # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
   def format_markdown(content)
     lines = content.split("\n", -1)
     out = []
@@ -167,8 +166,6 @@ namespace :markdown do
     out << '' if (last = out.last) && !last.empty?
     out.join("\n")
   end
-  # rubocop:enable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
-
   desc 'Lint markdown (reports files that would be changed)'
   task :lint do
     changed = []

data/bin/prg

@@ -148,6 +148,21 @@ module PrgCLI
     end
   end
 
+  # Spawn a background child but do NOT fully detach from the controlling
+  # terminal. This keeps the child attached to the same TTY so animations
+  # remain visible, while the parent exits immediately allowing the caller
+  # (shell or script) to continue. Use when the user requests a non-detaching
+  # background worker (e.g. `--daemon-as NAME --no-detach`).
+  def self.backgroundize
+    pid = fork
+    return unless pid
+
+    # parent: exit so the invoking shell/script continues
+    exit(0)
+
+    # child: continue without setsid/IO close so output remains on the TTY
+  end
+
   # Attempt to stop processes for the given subcommand. Return true if any
   # process was signaled/stopped; false otherwise. Keep quiet on missing
   # processes to satisfy integration tests.

data/demo_screencast.rb

@@ -13,6 +13,8 @@
 # and clear visual separation of different features.
 
 require 'io/console'
+require 'shellwords'
+require 'tmpdir'
 
 # Demo runner that exercises the major features of the ruby-progress gem
 # used by the documentation and screencast recordings.
@@ -26,6 +28,11 @@ class ProgressDemo
       header: "\e[1;36m",    # Bright cyan
       command: "\e[1;33m",   # Bright yellow
       description: "\e[0;32m", # Green
+      exec: "\e[1;33m",      # executable (bright yellow)
+      tool: "\e[1;35m",      # prg/tool (bright magenta)
+      flag: "\e[1;36m",      # flags (bright cyan)
+      value: "\e[1;37m",     # flag values (bright white)
+      prompt: "\e[2m",       # prompt (dim)
       reset: "\e[0m",        # Reset
       dim: "\e[2m"           # Dim
     }
@@ -33,12 +40,12 @@ class ProgressDemo
 
   def run
     clear_screen
-    show_title
+    # show_title
 
     # Introduction
-    show_section_header('Ruby Progress Gem Demo')
-    show_description('Demonstrating terminal progress indicators with style!')
-    pause_for_narration(3)
+    # show_section_header('Ruby Progress Gem Demo')
+    # show_description('Demonstrating terminal progress indicators with style!')
+    # pause_for_narration(3)
 
     # Basic examples for each command
     demo_basic_commands
@@ -63,12 +70,12 @@ class ProgressDemo
 
     # Ripple - basic expanding circle animation
     show_demo_header('Ripple', 'Expanding circle animation for tasks with unknown duration')
-    run_command("#{ruby_cmd} ripple --command 'sleep 4' --success 'Download complete!' --checkmark")
+    run_command("#{ruby_cmd} ripple --command 'sleep 4' --success 'Download complete!' --checkmark PROCESSING")
     pause_between_demos
 
     # Worm - progress bar animation
     show_demo_header('Worm', 'Animated progress bar for visual feedback')
-    run_command("#{ruby_cmd} worm --length 10 --command 'sleep 5' --success 'Processing finished!' --checkmark")
+    run_command("#{ruby_cmd} worm --length 10 --command 'sleep 5' --success 'Processing finished!' --checkmark --message 'Loading'")
     pause_between_demos
 
     # Twirl - spinning indicator
@@ -83,31 +90,27 @@ class ProgressDemo
     # Ripple styles
     show_demo_header('Ripple Styles', 'Different visual patterns')
     show_command_info('Default ripple style')
-    run_command("#{ruby_cmd} ripple --command 'sleep 3' --success 'Default style'")
+    run_command("#{ruby_cmd} ripple --command 'sleep 3' --success 'Default style' 'Rippling Progress Default Style'")
     pause_between_demos(2)
 
     show_command_info('Pulse style')
-    run_command("#{ruby_cmd} ripple --style pulse --command 'sleep 3' --success 'Pulse style'")
+    run_command("#{ruby_cmd} ripple --style pulse --command 'sleep 3' --success 'Pulse style' 'Rippling Progress'")
     pause_between_demos
 
     # Worm styles
     show_demo_header('Worm Styles', 'Various progress bar animations')
     show_command_info('Classic worm style')
-    run_command("#{ruby_cmd} worm --length 10 --style classic --command 'sleep 4' --success 'Classic worm'")
-    pause_between_demos(2)
-
-    show_command_info('Emoji worm style')
-    run_command("#{ruby_cmd} worm --length 10 --style emoji --command 'sleep 4' --success 'Emoji worm! 🎉'")
+    run_command("#{ruby_cmd} worm --length 10 --style classic --command 'sleep 4' --success 'Classic worm' --message 'Classic'")
     pause_between_demos(2)
 
     show_command_info('Blocks worm style')
-    run_command("#{ruby_cmd} worm --length 10 --style blocks --command 'sleep 4' --success 'Block worm'")
+    run_command("#{ruby_cmd} worm --length 10 --style blocks --command 'sleep 4' --success 'Block worm' --message 'Blocks'")
     pause_between_demos
 
     # Twirl styles
     show_demo_header('Twirl Styles', 'Different spinning patterns')
     show_command_info('Classic spinner')
-    run_command("#{ruby_cmd} twirl --style classic --command 'sleep 3' --success 'Classic spin'")
+    run_command("#{ruby_cmd} twirl --style classic --command 'sleep 3' --success 'Classic spin' --message 'Loading'")
     pause_between_demos(2)
 
     show_command_info('Dots spinner')
@@ -115,7 +118,7 @@ class ProgressDemo
     pause_between_demos(2)
 
     show_command_info('Arrow spinner')
-    run_command("#{ruby_cmd} twirl --style arrow --command 'sleep 3' --success 'Arrow spin'")
+    run_command("#{ruby_cmd} twirl --style arrow --command 'sleep 3' --success 'Arrow spin' --message 'Loading'")
     pause_between_demos
   end
 
@@ -125,17 +128,17 @@ class ProgressDemo
     # Error handling
     show_demo_header('Error Handling', 'Graceful failure with custom messages')
     show_command_info('Simulating a failed task')
-    run_command("#{ruby_cmd} worm --length 10 --command 'sleep 2 && exit 1' --error 'Something went wrong!' --fail-icon")
+    run_command("#{ruby_cmd} worm --length 10 --command 'sleep 2 && exit 1' --error 'Something went wrong!' --checkmark")
     pause_between_demos
 
     # Custom colors (if supported)
     show_demo_header('Success Messages', 'Custom completion messages')
     show_command_info('Custom success message with checkmark')
-    run_command("#{ruby_cmd} ripple --command 'sleep 3' --success 'Data synchronized successfully' --checkmark")
+    run_command("#{ruby_cmd} ripple --command 'sleep 3' --success 'Data synchronized successfully' --checkmark --message 'Syncing data...'")
     pause_between_demos(2)
 
     show_command_info('Different success icon')
-    run_command("#{ruby_cmd} twirl --command 'sleep 3' --success 'Backup completed' --icon '✓'")
+    run_command("#{ruby_cmd} twirl --command 'sleep 3' --success 'Backup completed' --success-icon '✓' --checkmark")
     pause_between_demos
 
     # No completion message
@@ -151,7 +154,7 @@ class ProgressDemo
     # Universal --ends flag
     show_demo_header('Universal --ends Flag', 'Add decorative start/end characters')
     show_command_info("Ripple with square brackets: --ends '[]'")
-    run_command("#{ruby_cmd} ripple --ends '[]' --command 'sleep 4' --success 'Framed ripple!'")
+    run_command("#{ruby_cmd} ripple --ends '[]' --command 'sleep 4' --success 'Framed ripple!' 'With a frame'")
     pause_between_demos(2)
 
     show_command_info("Worm with angle brackets: --ends '<<>>'")
@@ -194,11 +197,95 @@ class ProgressDemo
     part2 = "--ends '【】' --command 'sleep 5' --success 'Ultimate combo!' --checkmark"
     run_command(part1 + part2)
     pause_between_demos
+
+    # v1.3.x additions: output capture and job queue demo snippets
+    show_section_header('New in v1.3.x - Output Capture & Job Queue')
+
+    show_demo_header('Fill --command (output capture)', 'Run a command and reserve terminal rows for output while preserving animation')
+    show_command_info('Capture command stdout/stderr into reserved rows:')
+    part_a = "#{ruby_cmd} fill --command \"bash -lc 'for i in 1 2 3; do echo line:$i; sleep 1; done'\" "
+    part_b = "--output-lines 3 --output-position top --success 'Captured!' --checkmark"
+    run_command(part_a + part_b)
+    pause_between_demos
+
+    show_demo_header('prg job send (enqueue a job)', 'Send a job to a running daemon using the file-based job queue')
+    show_command_info('Example: create a job payload and atomically enqueue it for the daemon')
+    show_command_info('Use the bundled helper to enqueue control/action jobs:')
+    puts "#{@colors[:command]}$ prg job send --daemon-name demo --advance#{@colors[:reset]}"
+    puts "#{@colors[:command]}$ prg job send --daemon-name demo --percent 42#{@colors[:reset]}"
+    puts
+    show_command_info('Or enqueue a shell command:')
+
+    # For the demo we run the worker in the foreground so you can see the
+    # live animation and completion message inline. Daemon mode (started with
+    # `--daemon` or `--daemon-as`) detaches to the background and processes
+    # jobs via the file-based queue; `prg job send` targets a background
+    # daemon and prints the job result JSON, but won't show the daemon's
+    # animation in the foreground.
+    show_command_info('Start a named fill daemon that processes percent/action jobs')
+    # Start the fill daemon in non-detaching background mode so animation remains visible
+    run_command("#{ruby_cmd} fill --daemon-as demo --no-detach --output-lines 3 --output-position top --success 'Captured!' --checkmark")
+    pause_between_demos(1)
+
+    show_command_info('We will enqueue several percent actions via a small shell script')
+    demo_script = <<~BASH
+          #!/usr/bin/env bash
+          set -eu
+          echo "Sending percent updates to demo daemon (atomic mktemp+mv writes)"
+
+          job_dir="/tmp/ruby-progress/demo.jobs"
+          mkdir -p "$job_dir"
+
+          enqueue_percent() {
+            percent=$1
+            # Build JSON payload
+            id=$(uuidgen 2>/dev/null || echo "job-$(date +%s%N)")
+            tmp=$(mktemp "$job_dir/${id}.json.tmp.XXXXXX")
+            printf '%s\n' '{"id":"'"${id}"'","action":"percent","value":'"${percent}"'}' > "$tmp"
+            mv "$tmp" "$job_dir/${id}.json"
+
+            # Wait for the daemon to process the job (poll for .processing.result)
+            result_path="$job_dir/${id}.json.processing.result"
+            start=$(date +%s)
+            timeout=10
+            while [ ! -f "$result_path" ]; do
+              sleep 0.1
+              now=$(date +%s)
+              if [ $((now - start)) -gt $timeout ]; then
+                echo "Timed out waiting for result for job ${id}" >&2
+                return 2
+              fi
+            done
+            cat "$result_path"
+          }
+
+          enqueue_percent 10
+          sleep 1
+          enqueue_percent 40
+          sleep 1
+          enqueue_percent 70
+          sleep 1
+          enqueue_percent 100
+
+      # After updates, stop the daemon cleanly (call local bin/prg to avoid global conflicts)
+      #{ruby_cmd} fill --stop-id demo --stop-success 'Demo daemon stopped'
+    BASH
+
+    # Show the simulated script contents
+    puts "#{@colors[:command]}$ cat demo_percent_updates.sh#{@colors[:reset]}"
+    puts demo_script
+
+    # Write and execute the script (run in a subshell so output doesn't interleave too badly)
+    script_path = File.join(Dir.tmpdir, "demo_percent_updates_#{Time.now.to_i}.sh")
+    File.write(script_path, demo_script)
+    File.chmod(0o755, script_path)
+    run_command("bash #{Shellwords.escape(script_path)}")
+    pause_between_demos
   end
 
   def show_finale
     show_section_header('Demo Complete!')
-    show_description('Ruby Progress Gem v1.2.0 - Making terminal progress beautiful! 🚀')
+    show_description('Ruby Progress Gem v1.3.2 - Making terminal progress beautiful! 🚀')
     puts
     show_description('Key features demonstrated:')
     puts "#{@colors[:description]}  • Three animation types: ripple, worm, twirl#{@colors[:reset]}"
@@ -217,7 +304,8 @@ class ProgressDemo
   # Utility methods
 
   def ruby_cmd
-    "ruby -I #{@lib_path} #{@gem_path}"
+    # "ruby -I #{@lib_path} #{@gem_path}"
+    'bin/prg'
   end
 
   def clear_screen
@@ -228,7 +316,7 @@ class ProgressDemo
     puts
     puts "#{@colors[:header]}#{'=' * 60}#{@colors[:reset]}"
     puts "#{@colors[:header]}  RUBY PROGRESS GEM - DEMO SCREENCAST#{@colors[:reset]}"
-    puts "#{@colors[:header]}  Version 1.2.0 Feature Demonstration#{@colors[:reset]}"
+    puts "#{@colors[:header]}  Version 1.3.2 Feature Demonstration#{@colors[:reset]}"
     puts "#{@colors[:header]}#{'=' * 60}#{@colors[:reset]}"
     puts
   end
@@ -257,19 +345,75 @@ class ProgressDemo
   end
 
   def run_command(cmd)
-    puts "#{@colors[:command]}$ #{cmd}#{@colors[:reset]}"
+    # Type the command with syntax highlighting
+    type_command("$ #{cmd.sub(%r{^bin/}, '')}")
     puts
     system(cmd)
     puts
   end
 
+  # Type out a shell command with simple token-based syntax highlighting.
+  # - executable (first token) uses @colors[:exec]
+  # - flags (tokens starting with '-') use @colors[:flag]
+  # - values use @colors[:value]
+  # The function prints one character at a time to simulate typing.
+  def type_command(line, speed: 0.04)
+    tokens = line.scan(/'[^']*'|"[^"]*"|\S+/)
+    pos = 0
+
+    # Determine the executable token position (skip leading prompt '$' tokens)
+    exec_pos = tokens.find_index { |t| !t.start_with?('$') }
+    subcmd_pos = exec_pos ? exec_pos + 1 : nil
+
+    tokens.each_with_index do |token, idx|
+      # Find token in original line starting at pos (to preserve spacing)
+      start_idx = line.index(token, pos) || pos
+
+      # print any intermediate whitespace
+      inter = line[pos...start_idx]
+      $stdout.print(inter) if inter && !inter.empty?
+
+      # Default color for tokens is value
+      color = @colors[:value]
+
+      if token.start_with?('$')
+        color = @colors[:prompt]
+      elsif idx == exec_pos && token == 'prg'
+        # Highlight the bundled tool name in magenta
+        color = @colors[:tool]
+      elsif idx == exec_pos
+        # Executable token (e.g. ruby or other) - keep exec color
+        color = @colors[:exec]
+      elsif idx == subcmd_pos
+        # Subcommand (ripple/twirl/worm/fill etc.) highlighted in yellow
+        color = @colors[:command]
+      elsif token.start_with?('-')
+        color = @colors[:flag]
+      end
+
+      # Print the token one char at a time
+      token.each_char do |ch|
+        $stdout.print("#{color}#{ch}#{@colors[:reset]}")
+        $stdout.flush
+        sleep(speed)
+      end
+
+      pos = start_idx + token.length
+    end
+
+    # Print any trailing whitespace/newline
+    trailing = line[pos..-1]
+    $stdout.print(trailing) if trailing
+    $stdout.flush
+  end
+
   def pause_for_narration(seconds = 2)
-    puts "#{@colors[:dim]}[Pausing #{seconds}s for narration...]#{@colors[:reset]}"
-    sleep(seconds)
+    # puts "#{@colors[:dim]}[Pausing #{seconds}s for narration...]#{@colors[:reset]}"
+    # sleep(seconds)
   end
 
-  def pause_between_demos(seconds = 3)
-    puts "#{@colors[:dim]}[Pausing #{seconds}s between demos...]#{@colors[:reset]}"
+  def pause_between_demos(seconds = 2)
+    # puts "#{@colors[:dim]}[Pausing #{seconds}s between demos...]#{@colors[:reset]}"
     sleep(seconds)
   end
 end
@@ -278,14 +422,14 @@ end
 if __FILE__ == $PROGRAM_NAME
   demo = ProgressDemo.new
 
-  puts 'Ruby Progress Gem Demo Screencast'
-  puts '================================='
-  puts
-  puts 'This script will demonstrate various features of the ruby-progress gem.'
-  puts 'Press ENTER to start the demo, or Ctrl+C to exit.'
-  puts
-  print 'Ready? '
-  gets
+  # puts 'Ruby Progress Gem Demo Screencast'
+  # puts '================================='
+  # puts
+  # puts 'This script will demonstrate various features of the ruby-progress gem.'
+  # puts 'Press ENTER to start the demo, or Ctrl+C to exit.'
+  # puts
+  # print 'Ready? '
+  # gets
 
   begin
     demo.run