ace-tmux 0.11.2 → 0.14.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ea74f6180f273e9190b38ec92b90c59b7c6ea379e849ce1294b93ae25a6cee4
-  data.tar.gz: fea5f9376872d9ab0cf9f9d4504ab1866931131c320e0678491467dffde577e7
+  metadata.gz: 42e752d75968cab4e3af63e513247dd29b626e28f1ac0c88847c7fe036726df4
+  data.tar.gz: 9b4aad5052e103fe757001d03d487cb221d4af0c989af41097c11d3db4cad1ea
 SHA512:
-  metadata.gz: 75a941be03f8588a5710f12e6d457ce204d1c80a6b538687855391dbd4501429d3b2087a0236740e661c21cf87c436c5d33d22d40b9bc2cc33a47c7a0782f0d5
-  data.tar.gz: 782c0f5ecf18f99317a180756190bff21511c3e619d403620452b0b360832ba0c89aca3e8634732df553e28f01e77e3211455228cf784a29c3406056cdbf4e57
+  metadata.gz: 2f5de2adedeccbc4acb9cb1d876ececc32be10255b967daf764888b484d4af5fe02f26662f5979fc8978f0766f62f24faf0c32bb6915aeee3b42094235a3b001
+  data.tar.gz: d1b4c69d036364e760299cde7ac47a3540d7889e51b4e053683d4b18e75afe39813bfdda22fbb30e5c4294153200006899b8f6e141fe58f3bbc2d1dc35e3a7a0

data/CHANGELOG.md

@@ -7,6 +7,58 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.14.3] - 2026-04-16
+
+### Technical
+- Hardened retained tmux preset and existing-session E2E verification to avoid false missing-artifact requirements and to accept stable session continuity evidence across lifecycle commands.
+
+## [0.14.2] - 2026-04-16
+
+### Technical
+- Relaxed existing-session E2E verification to judge session reuse from lifecycle continuity and captured state instead of brittle wording differences in tmux output.
+
+## [0.14.1] - 2026-04-16
+
+### Fixed
+- Routed tmux commands through an explicit sandbox socket path and enforced safe socket-directory permissions so isolated E2E sessions can be reused reliably.
+
+## [0.14.0] - 2026-04-15
+
+### Added
+- Added `TS-TMUX-002` to validate the outside-tmux `ace-tmux window --session` public workflow with explicit success and constrained-execution branches.
+
+### Changed
+- Expanded `TS-TMUX-001` with an existing-session lifecycle goal and tightened goal-style verifier contracts for preset/start/window evidence continuity.
+- Clarified outside-tmux session-targeting usage in command help and usage documentation.
+
+## [0.13.0] - 2026-04-13
+
+### Added
+- Added `ace-tmux start --name` so one preset can launch multiple concurrent tmux sessions with explicit runtime names.
+
+### Changed
+- Tightened the tmux management E2E contract to require isolated run-scoped sessions and explicit cleanup instead of mutating the current tmux session.
+
+## [0.12.1] - 2026-04-13
+
+### Changed
+- Completed the batch i05 migration follow-through for this package and aligned it with the restarted `fast` / `feat` / `e2e` verification model.
+
+### Technical
+- Included in the coordinated assignment-driven patch release for batch i05 package updates.
+
+
+## [0.12.0] - 2026-04-12
+
+### Changed
+- Migrated deterministic tests to the restarted layout under `test/fast/` and updated E2E scenario metadata to reference the new deterministic paths.
+- Added explicit package testing contract guidance for `ace-test ace-tmux`, `ace-test ace-tmux feat`, `ace-test ace-tmux all`, and `ace-test-e2e ace-tmux` in README and docs.
+
+## [0.11.3] - 2026-03-29
+
+### Technical
+- Normalized published gem metadata so RubyGems and Ruby Toolbox use current release information instead of the 1980 fallback date.
+
 
 ## [0.11.2] - 2026-03-29
 

data/README.md

@@ -21,12 +21,12 @@
 ## How It Works
 
 1. Define session and window layouts in YAML presets stored in `.ace/tmux/` (project), `~/.ace/tmux/` (user), or gem defaults.
-2. Run `ace-tmux start [PRESET]` to create a full session or `ace-tmux window [PRESET]` to inject a window into the current session.
+2. Run `ace-tmux start [PRESET]` to create a full session or `ace-tmux window [PRESET]` to inject a window into the current session. Use `ace-tmux start ... --name <session>` when you need multiple concurrent sessions from the same preset.
 3. Presets are deep-merged through the config cascade, so project-level overrides layer cleanly on top of shared defaults.
 
 ## Use Cases
 
-**Start or attach to a preset-backed session** - run `ace-tmux start [PRESET]` to create a session from YAML presets, or attach to an existing session with the same name, integrating panes for [ace-task](../ace-task) status, [ace-git](../ace-git) info, and editor windows.
+**Start or attach to a preset-backed session** - run `ace-tmux start [PRESET]` to create a session from YAML presets, or attach to an existing session with the same name, integrating panes for [ace-task](../ace-task) status, [ace-git](../ace-git) info, and editor windows. Add `--name` to reuse the preset under a different runtime session name.
 
 **Inject windows into running sessions** - run `ace-tmux window [PRESET]` to add a new window from presets without recreating the current session, useful for spinning up focused tool or test panes on the fly.
 
@@ -36,5 +36,12 @@
 
 **Orchestrate task-focused workspaces** - pair with [ace-overseer](../ace-overseer) and [ace-assign](../ace-assign) for assignment-driven worktree and tmux orchestration that spins up isolated workspaces per task.
 
+## Testing
+
+- `ace-test ace-tmux` runs deterministic fast-layer tests under `test/fast/`.
+- `ace-test ace-tmux feat` runs deterministic feature tests when `test/feat/` coverage exists.
+- `ace-test ace-tmux all` runs full package deterministic coverage.
+- `ace-test-e2e ace-tmux` runs retained workflow scenarios under `test/e2e/`.
+
 ---
 [Getting Started](docs/getting-started.md) | [Usage Guide](docs/usage.md) | [Handbook - Skills, Agents, Templates](docs/handbook.md) | Part of [ACE](https://github.com/cs3b/ace)

data/docs/getting-started.md

@@ -26,6 +26,9 @@ Run: `ace-tmux start`.
 
 `ace-tmux` resolves the default session preset from `defaults.session` in config.
 
+For parallel workspaces from the same preset, use a custom runtime session name:
+`ace-tmux start default --detach --name review-sandbox`.
+
 ## Add a Window to a Running Session
 
 From inside tmux, run: `ace-tmux window`.
@@ -83,4 +86,5 @@ Use it in a session or add it directly with `ace-tmux window cc`.
 
 - Define project-level presets in `.ace/tmux/`.
 - Override personal defaults in `~/.ace/tmux/`.
+- Validate package tests with `ace-test ace-tmux` and `ace-test-e2e ace-tmux`.
 - See [Usage Guide](usage.md) for full command and config reference.

data/docs/usage.md

@@ -26,12 +26,14 @@ Examples:
 - `ace-tmux start` uses `defaults.session`
 - `ace-tmux start dev`
 - `ace-tmux start dev --detach`
+- `ace-tmux start dev --detach --name qa-dev`
 - `ace-tmux start dev --force`
 
 Options:
 
 - `--detach`, `-D`: do not attach after creation
 - `--force`: kill existing session and recreate it
+- `--name`, `-n`: override the runtime tmux session name
 - `--root`, `-r`: override session working directory
 - `--verbose`, `-v`: verbose output
 - `--quiet`, `-q`: suppress non-essential output
@@ -40,6 +42,7 @@ Behavior notes:
 
 - If session exists, `--force` is not set, and `--detach` is not set, `start` attaches to the existing session.
 - If session exists, `--force` is not set, and `--detach` is set, `start` returns without attaching.
+- `--name` changes the tmux session name used at runtime without changing which preset is loaded.
 - If no preset is provided, `defaults.session` is used.
 
 ## `ace-tmux window`
@@ -51,6 +54,7 @@ Examples:
 - `ace-tmux window` uses `defaults.window`
 - `ace-tmux window cc`
 - `ace-tmux window cc --session dev`
+- `ace-tmux window cc --session dev` (outside tmux path)
 - `ace-tmux window cc --root ~/work/repo`
 
 Options:
@@ -195,3 +199,10 @@ Chained preset references are supported (depth-limited).
 
 - [Getting Started](getting-started.md)
 - [Handbook Reference](handbook.md)
+
+## Testing Contract
+
+- `ace-test ace-tmux` validates deterministic fast coverage in `test/fast/`.
+- `ace-test ace-tmux feat` validates deterministic feature coverage in `test/feat/` when present.
+- `ace-test ace-tmux all` validates full deterministic package coverage.
+- `ace-test-e2e ace-tmux` runs workflow scenarios in `test/e2e/`.

data/lib/ace/tmux/cli/commands/start.rb

@@ -33,6 +33,7 @@ module Ace
             "default                    # Start default session",
             "dev                        # Start dev session",
             "dev --detach               # Create without attaching",
+            "dev --detach --name qa     # Create under a custom session name",
             "dev --force                # Kill existing and recreate"
           ]
 
@@ -40,6 +41,7 @@ module Ace
 
           option :detach, type: :boolean, aliases: %w[-D], desc: "Don't attach after creating session"
           option :force, type: :boolean, desc: "Kill existing session and recreate"
+          option :name, type: :string, aliases: %w[-n], desc: "Override the tmux session name"
           option :root, type: :string, aliases: %w[-r], desc: "Working directory for the session"
           option :verbose, type: :boolean, aliases: %w[-v], desc: "Show verbose output"
           option :quiet, type: :boolean, aliases: %w[-q], desc: "Suppress non-essential output"
@@ -64,14 +66,16 @@ module Ace
               tmux: tmux_bin
             )
 
-            puts "Starting session '#{preset}'..." unless options[:quiet]
+            session_name = options[:name] || preset
+            puts "Starting session '#{session_name}'..." unless options[:quiet]
             manager.start(
               preset,
               detach: options[:detach] || false,
               force: options[:force] || false,
+              name: options[:name],
               root: options[:root]
             )
-            puts "Session '#{preset}' created." if options[:detach] && !options[:quiet]
+            puts "Session '#{session_name}' created." if options[:detach] && !options[:quiet]
           rescue Ace::Tmux::PresetNotFoundError => e
             raise Ace::Support::Cli::Error.new(e.message)
           end

data/lib/ace/tmux/cli/commands/window.rb

@@ -22,13 +22,13 @@ module Ace
               # Add code-editor window to current session
               $ ace-tmux window code-editor
 
-              # Add to a specific session
+              # Outside tmux, target a specific session explicitly
               $ ace-tmux window code-editor --session dev
           DESC
 
           example [
             "code-editor               # Add to current session",
-            "code-editor -s dev        # Add to specific session"
+            "code-editor -s dev        # Outside tmux path: add to specific session"
           ]
 
           argument :preset, required: false, desc: "Window preset name (default: from config)"

data/lib/ace/tmux/models/session.rb

@@ -7,7 +7,7 @@ module Ace
       class Session
         attr_reader :name, :root, :windows, :pre_window, :startup_window,
           :on_project_start, :on_project_exit, :attach, :tmux_options
-        attr_writer :root
+        attr_writer :name, :root
 
         # @param name [String] Session name
         # @param root [String, nil] Base working directory

data/lib/ace/tmux/molecules/tmux_executor.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
+require "fileutils"
 require "open3"
-
 module Ace
   module Tmux
     module Molecules
@@ -17,7 +17,7 @@ module Ace
         # @param cmd [Array<String>] Command array
         # @return [ExecutionResult] Result with stdout, stderr, success?
         def capture(cmd)
-          stdout, stderr, status = Open3.capture3(*cmd)
+          stdout, stderr, status = Open3.capture3(*with_socket_target(cmd))
           ExecutionResult.new(
             stdout: stdout.strip,
             stderr: stderr.strip,
@@ -31,7 +31,7 @@ module Ace
         # @param cmd [Array<String>] Command array
         # @return [Boolean] true if command succeeded
         def run(cmd)
-          system(*cmd)
+          system(*with_socket_target(cmd))
         end
 
         # Replace current process with command (for tmux attach)
@@ -39,7 +39,7 @@ module Ace
         # @param cmd [Array<String>] Command array
         # @return [void] Never returns (replaces process)
         def exec(cmd)
-          Kernel.exec(*cmd)
+          Kernel.exec(*with_socket_target(cmd))
         end
 
         # Check if tmux is available
@@ -52,6 +52,33 @@ module Ace
         rescue Errno::ENOENT
           false
         end
+
+        private
+
+        def with_socket_target(cmd)
+          return cmd unless tmux_command?(cmd)
+
+          socket = explicit_socket_path
+          return cmd unless socket
+
+          socket_dir = File.dirname(socket)
+          FileUtils.mkdir_p(socket_dir)
+          FileUtils.chmod(0o700, socket_dir)
+          executable, *rest = cmd
+          [executable, "-S", socket, *rest]
+        end
+
+        def tmux_command?(cmd)
+          Array(cmd).first == "tmux"
+        end
+
+        def explicit_socket_path
+          base = ENV["TMUX_TMPDIR"].to_s.strip
+          base = ENV["XDG_RUNTIME_DIR"].to_s.strip if base.empty?
+          return nil if base.empty?
+
+          File.join(base, "tmux-#{Process.uid}", "default")
+        end
       end
 
       # Immutable result of a tmux command execution

data/lib/ace/tmux/organisms/session_manager.rb

@@ -30,10 +30,12 @@ module Ace
         # @param preset_name [String] Session preset name
         # @param detach [Boolean] Skip attach after creation
         # @param force [Boolean] Kill existing session and recreate
+        # @param name [String, nil] Override runtime tmux session name
         # @param root [String, nil] Override working directory for the session
         # @return [void]
-        def start(preset_name, detach: false, force: false, root: nil)
+        def start(preset_name, detach: false, force: false, name: nil, root: nil)
           session = @session_builder.build(preset_name)
+          session.name = name if name
           session.root = root if root
 
           if session_exists?(session.name)

data/lib/ace/tmux/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module Tmux
-    VERSION = '0.11.2'
+    VERSION = '0.14.3'
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-tmux
 version: !ruby/object:Gem::Version
-  version: 0.11.2
+  version: 0.14.3
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-04-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-support-cli