rakpak 1.0.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5bddb74dac931f5f6744b5a1c820c1f5452b3f938e3b3a1e928157926c40ce45
-  data.tar.gz: b4391576a37aa27785f58ddc5ed24237f6f346b67b252d9fb4537f2a1a122406
+  metadata.gz: 2eb31aeb19c23cee757195d888132a931ea62030b0df07e88585c9e15fa5eea1
+  data.tar.gz: 9edb48577409aa19d2f1cb03115c881b2a7a1c755ccc8005d419e95428266db3
 SHA512:
-  metadata.gz: 93794a7b3228f6b4064880ebdc637a12194c7eac375e27a5daa3b102dedbdf42fefc998ad9e8854fa22f0393e85c0e590757e1ef8ceb562655920ce4a6a721a6
-  data.tar.gz: '049724035061aa5da75235a1424cbc3927bd24e8738c01c85a4ee60810ffff738f9976a307424086eb41a04f7a804ff1bca0d06f79a73bbd9ae71085f30feabe'
+  metadata.gz: d629766dd61b2c108c34e500a38e73cb465262ec36454d1e8714572f6104359cecc8712fbef2314a784d2070681a15fa821c081e39e292eb42794bdd508e0f10
+  data.tar.gz: cd9fae98590a0d321f061588eebece2f015a74937a58c345a46d4f6b18b1a04492c85b7e1c11a474397d9fded85173bbb4d4fe1032974f03c3c33550eb08ffc4

data/README.md

@@ -1,10 +1,20 @@
-# rakpak
+<p align="center">
+  <img src="https://res.cloudinary.com/noqoikpl/image/upload/f_auto,q_auto/rakpak-upper" alt="rakpak" width="520">
+</p>
 
-Tag files and folders anywhere on your filesystem, then archive them all at once.
+<p align="center">
+  <a href="https://github.com/eof0/rakpak/actions/workflows/ci.yml"><img src="https://github.com/eof0/rakpak/actions/workflows/ci.yml/badge.svg" alt="tests"></a>
+  <a href="https://rubygems.org/gems/rakpak"><img src="https://img.shields.io/gem/v/rakpak" alt="gem version"></a>
+  <a href="https://rubygems.org/gems/rakpak"><img src="https://img.shields.io/gem/dt/rakpak" alt="downloads"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/eof0/rakpak" alt="license"></a>
+</p>
+
+<p align="center">Tag files and folders anywhere on your filesystem, then archive them all at once, or unpack one you already have.</p>
 
 You walk around, press `space` on anything you want, press `p`, answer a few
 questions, and it builds the archive. The progress view can be sent to the
-background while you keep browsing.
+background while you keep browsing. Press `u` on an archive instead and it
+unpacks, wherever you want it.
 
 Needs Ruby 3.0 or newer and nothing else.
 
@@ -30,6 +40,8 @@ rakpak ~/Documents        browse from there instead
 rakpak .                  browse from the current folder
 rakpak -p ~/Documents     pack that folder: opens on the archive prompts
 rakpak -p a.txt b/ c      pack several things at once
+rakpak -d site.tar.gz     unpack it here and now, into site/
+rakpak -d a.tgz b.zip     unpack several, each into its own folder
 ```
 
 ## Starting up
@@ -44,6 +56,13 @@ it, and the archive prompts appear at once, starting with the kind of archive
 and its compression. The archive is written next to that first path. Press
 `esc` on any prompt and you are back in the browser with the tags still set.
 
+`-d` (or `--depack`) does not open the browser at all. Each archive is
+unpacked straight into the folder you are standing in, the way `tar` would,
+each one into a folder of its own name: `site.tar.gz` gives you `site/`.
+A lone compressed file has nothing to wrap, so `notes.txt.gz` lands
+beside you as `notes.txt`. One bad archive does not stop the rest, and the
+exit status is non-zero if any of them failed.
+
 ## The flow
 
 1. **Browse and tag.** Vim keys or arrows. `space` tags whatever is under the
@@ -57,16 +76,39 @@ and its compression. The archive is written next to that first path. Press
 3. **Set the flags.** Compression method, level, and the switches for that
    format. Compressed tarballs default to gzip, the one every system can
    read.
-4. **Say where.** This directory, your home directory, or one you type
+4. **Leave things out.** Type names separated by commas, like
+   `node_modules, .cache, *.log`. Each one is left out wherever it turns
+   up, along with everything inside it. Or pick *Tag files and directories*
+   to walk the folders you are packing and press `space` on the exact spots
+   to skip; `p` brings you back. Skipped when only files are packed.
+5. **Say where.** This directory, your home directory, or one you type
    into the field right there. `~`, `$HOME` and absolute paths all work,
    and typing anything jumps to the field.
-5. **Name it.** The extension is added for you.
-6. **Confirm.** You see the exact command before anything runs. Only `enter`
+6. **Name it.** The extension is added for you.
+7. **Confirm.** You see the exact command before anything runs. Only `enter`
    starts it.
-7. **Watch it, or press `b`** to drop it into the background and keep browsing.
+8. **Watch it, or press `b`** to drop it into the background and keep browsing.
 
 If nothing is tagged, `p` archives whatever the cursor is on.
 
+## Unpacking
+
+`u` on an archive opens three prompts: which folder to unpack into, what to
+call the folder it makes there, and the usual confirm screen showing the
+exact command.
+
+Unlike `p`, this follows the cursor rather than the tag set: one archive, one
+destination. The folder is offered as the archive's own name with the
+extension taken off, so `site.tar.gz` suggests `site/`, which means nothing
+is ever sprayed across the folder you are standing in. Type `.` as
+the name to unpack straight into the folder you picked instead, and the
+folder prompt takes `~`, `$HOME` and any absolute path, so the contents can
+go anywhere. A lone compressed file skips the folder entirely.
+
+If the destination already has files in it, the confirm screen says so before
+anything runs. A failed extraction leaves whatever it managed to write; the
+files that were already there are never touched.
+
 ## Keys
 
 | | |
@@ -78,14 +120,16 @@ If nothing is tagged, `p` archives whatever the cursor is on.
 | `ctrl-d` `ctrl-u` | half page |
 | `gh` `~` / `gr` | home / root |
 | `space` | tag or untag, then move down |
+| `x` | exclude or include, then move down: left out of anything packed around it |
 | `a` / `d` | tag / untag everything in this folder |
-| `D` | clear all tags |
+| `D` | clear all tags and exclusions |
 | `T` | review tagged items (`space` removes) |
 | `t` | show or hide the queue pane |
 | `/` | filter this folder |
 | `.` | show hidden files |
 | `ctrl-r` | reload |
 | `p` | pack: archive what is tagged |
+| `u` | unpack the archive under the cursor |
 | `b` | watch a running job |
 | `?` | all keys |
 | `q` | quit |
@@ -110,9 +154,16 @@ here too, so `notes.txt` becomes `notes.txt.gz` or `notes.txt.zst` without a
 tarball around it. For a folder those are greyed out with the reason, since
 `gzip` alone cannot take a folder.
 
+Every one of those can be read back: `.tar`, `.tar.gz`, `.tar.zst`, `.tar.xz`,
+`.tar.bz2`, `.tar.lz4`, `.tar.br`, the `.tgz`, `.tzst`, `.txz` and `.tbz2`
+short forms, `.zip` via `unzip`, and `.gz`, `.zst`, `.xz`, `.bz2`, `.lz4` or
+`.br` on their own.
+
 Everything is probed at startup: `PATH` for the compressors, `tar --version` to
 tell GNU tar from bsdtar from busybox, and `zip -v` for its compiled-in methods.
 Anything that will not work on this machine is greyed out with the reason.
+Unpacking a `.zip` wants `unzip`, which is a different program from the `zip`
+used to write one, so it is checked on its own.
 
 ## How the archive is shaped
 
@@ -124,7 +175,10 @@ archive holds `a/b` and `c`.
 
 - Commands are run directly, not in a shell. Filenames containing spaces,
   quotes, `$`, `;` or a leading `-` are safe.
-- Cancelling kills the whole process group, so the compressor goes too.
+- Cancelling kills the whole process group, so the compressor goes too. A
+  cancelled pack removes its half-written archive; a cancelled unpack leaves
+  the files it had already extracted, since deleting a folder is not
+  rakpak's call to make.
 - Folder sizes are counted in the background. A folder too large to finish
   counting in a few seconds shows `≥`, meaning the real size is at least that.
 

data/lib/rakpak/app.rb

@@ -6,12 +6,11 @@ require_relative "browser"
 require_relative "modal"
 require_relative "formats"
 require_relative "plan"
+require_relative "unpack"
 require_relative "job"
 require_relative "sizer"
 
 module Rakpak
-  # Review panel for the tag set: the one place to see everything picked up
-  # across the filesystem, and drop entries without walking back to them.
   class TagsModal < Modal
     def initialize(tags:, sizer:)
       super(title: "tagged", footer: "space/d remove · D clear all · esc back")
@@ -62,10 +61,9 @@ module Rakpak
 
   class App
     SPINNER = "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏"
-    WIZARD = %i[target options where output confirm].freeze
+    WIZARD = %i[target options exclude where output confirm].freeze
+    UNPACK = %i[dest_where dest_name unpack_confirm].freeze
 
-    # `pack` is a list of paths to tag before the first frame; when it is
-    # non-empty the archive prompts open immediately (rakpak -p).
     def initialize(start_dir = Dir.home, pack: [])
       @sizer = Sizer.new
       @browser = Browser.new(start_dir, sizer: @sizer)
@@ -81,6 +79,7 @@ module Rakpak
       @notice = nil
       @notice_until = nil
       @plan = nil
+      @wizard = WIZARD
       @wizard_pos = nil
       @quit = false
       return if pack.empty?
@@ -110,8 +109,7 @@ module Rakpak
 
     private
 
-    # The quit dialog promises running jobs are stopped. Give each a moment
-    # to remove its half-written archive before the terminal is handed back.
+    # Give jobs a moment to remove half-written archives before the terminal is restored.
     def stop_jobs
       running = @jobs.select(&:running?)
       return if running.empty?
@@ -157,8 +155,6 @@ module Rakpak
        "#{Text.bytes(j.output_size)} · #{Text.duration(j.elapsed)}#{more}   [b] jobs", Theme::ACCENT]
     end
 
-    # ------------------------------------------------------------- drawing
-
     MIN_W = 40
     MIN_H = 10
 
@@ -194,24 +190,27 @@ module Rakpak
       @screen.put([(@screen.w - Text.width(want)) / 2, 0].max, (@screen.h / 2) + 1, want, Theme::DIM)
     end
 
+    def job_title(job, state)
+      case state
+      when :running then job.plan.gerund
+      when :done then "finished"
+      when :failed then "failed"
+      when :cancelled then "cancelled"
+      else "queued"
+      end
+    end
+
     def draw_job(job)
       s = @screen
       s.fill(0, 0, s.w, 1, " ", Theme::HEAD)
-      title = case job.state
-              when :running then "archiving"
-              when :done then "finished"
-              when :failed then "failed"
-              when :cancelled then "cancelled"
-              else "queued"
-              end
       s.put(1, 0, "rakpak", Theme::HEAD + "\e[1;38;5;39m")
-      s.put(9, 0, title, Theme::HEAD + "\e[38;5;231m")
+      s.put(9, 0, job_title(job, job.state), Theme::HEAD + "\e[38;5;231m")
       s.put(s.w - 20, 0, Text.duration(job.elapsed), Theme::HEAD + Theme::DIM)
 
       y = 2
       job.plan.outputs.each do |out|
         size = begin
-          File.size(out)
+          File.directory?(out) ? nil : File.size(out)
         rescue StandardError
           nil
         end
@@ -251,7 +250,7 @@ module Rakpak
 
       s.hline(0, y, s.w, Theme::BORDER)
       y += 1
-      rows = [s.h - y - 1, 0].max # a very short terminal leaves no room at all
+      rows = [s.h - y - 1, 0].max
       job.tail(rows).each_with_index do |line, i|
         style = if line.start_with?("▸") then Theme::ACCENT
                 elsif line.match?(/error|cannot|denied|warning/i) then Theme::WARN
@@ -278,8 +277,6 @@ module Rakpak
       end
     end
 
-    # ------------------------------------------------------------ dispatch
-
     def dispatch(key)
       return modal_key(key) if @modal
       return job_key(key) if @mode == :job
@@ -287,9 +284,12 @@ module Rakpak
       case @browser.handle(key)
       when :quit then request_quit
       when :archive then start_wizard
+      when :unpack then start_unpack
       when :tags then open_tags
       when :help then open_help
       when :jobs then open_jobs
+      when :resume then resume_wizard
+      when :unmarkable then notify("that one is being packed; untag it instead", Theme::WARN)
       end
     end
 
@@ -306,12 +306,12 @@ module Rakpak
         end
       when :enter
         @mode = :browse unless job.running?
-      when "q" then request_quit # the footer says quit, so it quits
+      when "q" then request_quit
       end
     end
 
     def modal_key(key)
-      # ctrl-c backs out of any panel; raw mode delivers it as a keystroke.
+      # Raw mode delivers ctrl-c as a keystroke.
       res = key == :ctrl_c ? :cancel : @modal.handle(key)
       return if res.nil?
 
@@ -330,13 +330,12 @@ module Rakpak
         return
       end
 
-      return unless @wizard_pos
+      # While exclusions are being marked the wizard is paused; help closing must not move it.
+      return if @wizard_pos.nil? || @browser.scoped?
 
       res == :done ? wizard_forward(modal) : wizard_back
     end
 
-    # -------------------------------------------------------------- wizard
-
     def start_wizard
       sel = @browser.selection
       if sel.empty?
@@ -349,16 +348,37 @@ module Rakpak
       sel.each { |p| @sizer.request(p) }
       @plan = Plan.new(paths: sel, outdir: @browser.cwd)
       @name_edited = false
+      @exclude_text = ""
       @where = 0
       @where_text = ""
+      @wizard = WIZARD
+      @wizard_pos = 0
+      open_wizard_step
+    end
+
+    def start_unpack
+      e = @browser.current
+      unless e && File.file?(e.path) && Unpack.archive?(e.path)
+        @modal = MessageModal.new(
+          title: "not an archive",
+          lines: ["rakpak unpacks tarballs, zips and single",
+                  "compressed files: .tar, .tar.gz, .tar.zst,",
+                  ".tar.xz, .tar.bz2, .tar.lz4, .tar.br, .zip,",
+                  "and .gz, .zst, .xz, .bz2, .lz4, .br on their own."],
+          style: Theme::WARN
+        )
+        return
+      end
+      @plan = Unpack.new(archive: e.path, dest: @browser.cwd)
+      @dest_parent = @browser.cwd
+      @dest_name = Unpack.default_subdir(e.path) || "."
+      @where = 0
+      @where_text = ""
+      @wizard = UNPACK
       @wizard_pos = 0
       open_wizard_step
     end
 
-    # A lone file loses its extension ("notes.txt" becomes notes.tar.gz)
-    # unless the output is that file compressed on its own (notes.txt.gz).
-    # A folder keeps its name whole, dots and all. Several items take the
-    # folder name.
     def default_basename(sel)
       name = if sel.size > 1 then File.basename(@browser.cwd)
              elsif File.directory?(sel.first) || @plan&.single_compress? then File.basename(sel.first)
@@ -369,7 +389,7 @@ module Rakpak
 
     def open_wizard_step
       loop do
-        step = WIZARD[@wizard_pos]
+        step = @wizard[@wizard_pos]
         return finish_wizard if step.nil?
 
         modal = build_step(step)
@@ -383,8 +403,8 @@ module Rakpak
     end
 
     def wizard_forward(modal)
-      apply_step(WIZARD[@wizard_pos], modal)
-      return if @wizard_pos.nil? # a step may have ended the wizard itself
+      # A step may have ended the wizard itself, or paused it.
+      return if apply_step(@wizard[@wizard_pos], modal) == :paused || @wizard_pos.nil?
 
       @wizard_pos += 1
       open_wizard_step
@@ -398,7 +418,7 @@ module Rakpak
           @plan = nil
           return
         end
-        modal = build_step(WIZARD[@wizard_pos])
+        modal = build_step(@wizard[@wizard_pos])
         next if modal.nil?
 
         @modal = modal
@@ -410,25 +430,42 @@ module Rakpak
       case step
       when :target then target_modal
       when :options then options_modal
+      when :exclude then exclude_modal
       when :where then where_modal
       when :output then output_modal
       when :confirm then confirm_modal
+      when :dest_where then dest_where_modal
+      when :dest_name then dest_name_modal
+      when :unpack_confirm then unpack_confirm_modal
       end
     end
 
     def apply_step(step, modal)
       case step
       when :target then @plan.target = modal.result
+      when :exclude
+        @exclude_text = modal.text
+        return pick_excludes if modal.result == :tag
+
+        @plan.excludes = Plan.parse_excludes(modal.text)
       when :where
         @where = modal.index
         @where_text = modal.text
-        # ~ and $HOME are for typed text; a browsed folder is taken as is,
-        # even one with a dollar sign in its name.
+        # Only typed text expands ~ and $HOME; a browsed folder may contain a literal $.
         @plan.outdir = @where == 2 ? Rakpak.expand_dir(modal.result) : modal.result
       when :output
         @name_edited = true
         @plan.basename = modal.result
       when :confirm then launch
+      when :dest_where
+        @where = modal.index
+        @where_text = modal.text
+        @dest_parent = @where == 2 ? Rakpak.expand_dir(modal.result) : modal.result
+        sync_dest
+      when :dest_name
+        @dest_name = modal.result
+        sync_dest
+      when :unpack_confirm then launch
       end
     end
 
@@ -470,7 +507,6 @@ module Rakpak
       end
     end
 
-    # A codec, its level, then that format's switches.
     def codec_form(side, title:, label:, flags_label:, flags_when_container: false)
       rows = [
         FormModal::Row.new(kind: :choice, label: label, hint: "", values: side.choices,
@@ -492,24 +528,79 @@ module Rakpak
       end
     end
 
+    # Nothing to exclude from inside a lone file.
+    def exclude_modal
+      return nil unless @plan.paths.any? { |p| File.directory?(p) }
+
+      @plan.excluded = @browser.excludes.to_a
+      ExcludeModal.new(text: @exclude_text,
+                       marked: @plan.excluded.map { |p| @plan.relative(p) })
+    end
+
+    def pick_excludes
+      @browser.scope_to(@plan.paths, @plan.base)
+      :paused
+    end
+
+    def resume_wizard
+      @browser.leave_scope
+      open_wizard_step
+    end
+
     def where_modal
       WhereModal.new(here: @browser.cwd, home: Dir.home, index: @where, text: @where_text,
-                     validate: lambda { |text|
-                       d = Rakpak.expand_dir(text)
-                       if !File.directory?(d) then "not a folder: #{d}"
-                       elsif !File.writable?(d) then "not writable: #{d}"
+                     validate: method(:writable_folder))
+    end
+
+    def writable_folder(text)
+      d = Rakpak.expand_dir(text)
+      if !File.directory?(d) then "not a folder: #{d}"
+      elsif !File.writable?(d) then "not writable: #{d}"
+      end
+    end
+
+    def dest_where_modal
+      WhereModal.new(here: @browser.cwd, home: Dir.home, index: @where, text: @where_text,
+                     validate: method(:writable_folder), title: "unpack it where?")
+    end
+
+    def dest_name_modal
+      return nil if @plan.single?
+
+      InputModal.new(title: "unpack into",
+                     value: @dest_name,
+                     hint: "a new folder in #{Text.tilde(@dest_parent)}  ·  . unpacks straight in",
+                     validate: lambda { |name|
+                       if name.include?("/") then "just a name, no slashes; the folder was picked already"
+                       elsif name.include?("\0") || name == ".." then "not a valid name"
                        end
                      })
     end
 
+    def sync_dest
+      @plan.dest = @dest_name == "." ? @dest_parent : File.join(@dest_parent, @dest_name)
+    end
+
+    def unpack_confirm_modal
+      lines = [[:head, "unpacks #{Text.tilde(@plan.archive)}"],
+               [:key, ""],
+               [:head, "into #{Text.tilde(@plan.dest)}"],
+               [:key, ""]]
+      @plan.preview.each do |label, cmd|
+        lines << [:head, "#{label}:"]
+        lines << [:cmd, "   #{cmd}"]
+      end
+      lines << [:key, ""]
+      ConfirmModal.new(title: "ready", lines: lines,
+                       warnings: @plan.warnings, errors: @plan.problems)
+    end
+
     def output_modal
       @plan.basename = default_basename(@plan.paths) unless @name_edited
       InputModal.new(title: "output name",
                      value: @plan.basename,
                      hint: "in #{Text.tilde(@plan.outdir)}  ·  #{@plan.ext} added automatically",
                      validate: lambda { |name|
-                       # The folder was chosen on the previous screen; this is
-                       # a bare filename, so it can never reach outside it.
                        if name.include?("/") then "just a name, no slashes; the folder was picked already"
                        elsif name.include?("\0") || [".", ".."].include?(name) then "not a valid name"
                        end
@@ -520,9 +611,12 @@ module Rakpak
       lines = []
       lines << [:head, "#{@plan.paths.size} item#{'s' unless @plan.paths.size == 1} " \
                        "from #{Text.tilde(@plan.base)}"]
-      @plan.members.first(6).each { |m| lines << [:key, "   #{m}"] }
-      lines << [:key, "   … #{@plan.members.size - 6} more"] if @plan.members.size > 6
-      lines << [:key, ""]
+      lines.concat(listing(@plan.members))
+      if @plan.excludes.any? || @plan.excluded.any?
+        lines << [:head, "leaves out"]
+        lines << [:key, "   #{@plan.excludes.join(', ')}"] if @plan.excludes.any?
+        lines.concat(listing(@plan.excluded.map { |p| @plan.relative(p) }))
+      end
       lines << [:head, "writes #{Text.tilde(@plan.output)}"]
       lines << [:key, ""]
       @plan.preview.each do |label, cmd|
@@ -534,14 +628,18 @@ module Rakpak
                        warnings: @plan.warnings, errors: @plan.problems)
     end
 
+    def listing(names)
+      lines = names.first(6).map { |m| [:key, "   #{m}"] }
+      lines << [:key, "   … #{names.size - 6} more"] if names.size > 6
+      lines << [:key, ""]
+    end
+
     def finish_wizard
       @wizard_pos = nil
     end
 
-    # Always opens the job view; b from there sends it to the background.
     def launch
-      total = @sizer.total(@plan.paths)
-      job = Job.new(@plan, total_files: total.files.positive? ? total.files : nil).start
+      job = Job.new(@plan, total_files: @plan.total_members(@sizer)).start
       @jobs << job
       @focus_job = job
       @wizard_pos = nil
@@ -557,17 +655,13 @@ module Rakpak
         next if @mode == :job && @focus_job == j
 
         case j.state
-        when :done
-          sizes = j.summary.map { |n, sz| "#{n} #{Text.bytes(sz)}" }.join(" · ")
-          notify("✓ #{sizes}", Theme::OK, 8)
+        when :done then notify("✓ #{j.plan.outcome}", Theme::OK, 8)
         when :failed then notify("✗ #{j.error}", Theme::ERR, 10)
         when :cancelled then notify("cancelled", Theme::WARN)
         end
       end
     end
 
-    # --------------------------------------------------------------- panels
-
     def open_tags
       list = @browser.tags.to_a.sort
       modal = TagsModal.new(tags: list, sizer: @sizer)
@@ -591,12 +685,14 @@ module Rakpak
         ["g g", "top"], ["G", "bottom"], ["ctrl-d ctrl-u", "half page"],
         ["g h", "home"], ["g r", "root"], ["~", "home"],
         ["space", "tag / untag, then move down"],
+        ["x", "exclude / include, then move down"],
         ["a", "tag everything here"], ["d", "untag everything here"],
-        ["D", "clear all tags"], ["T", "review tagged items"],
+        ["D", "clear all tags and exclusions"], ["T", "review tagged items"],
         ["t", "show / hide the queue pane"],
         ["/", "filter this folder"], [".", "show hidden"],
         ["ctrl-r", "reload"],
         ["p", "pack: archive the tagged items"],
+        ["u", "unpack the archive under the cursor"],
         ["b", "watch running jobs"], ["q", "quit"]
       ]
       w = keys.map { |k, _| Text.width(k) }.max
@@ -625,16 +721,12 @@ module Rakpak
       return if done.empty?
 
       done.each do |j|
-        # Printed after the TUI has gone, straight to the shell, so a folder
-        # or file name carrying an escape sequence must be defanged.
-        j.summary.each { |name, size| puts "#{Text.plain(File.join(j.plan.outdir, name))}  #{Text.bytes(size)}" }
+        # Printed to the shell after the TUI exits, so defang escape sequences in names.
+        puts "#{Text.plain(j.plan.outputs.first)}  #{Text.plain(j.plan.report_note)}"
       end
     end
   end
 
-  # The option form follows the codec the user just picked: the level row
-  # takes that codec's range, and rows that only apply to a zip container
-  # (its switches) appear only while a container method is selected.
   class DynamicForm < FormModal
     def initialize(title:, rows:, side:, extra: [], extra_when_container: false)
       super(title: title, rows: rows + extra)