ace-support-test-helpers 0.13.1 → 0.14.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 797c91f4ed7edb67463f2042099a58b4593ed205cf19bb20e3f4764920c6b554
-  data.tar.gz: 4c8d37930bf99c37d45d0209af77b83bfaf9be061bbc67b3f9d7a3877a7f17d6
+  metadata.gz: 93f08baa1e63663701ef39c9f56eac0a349bbd38328e9463d152a8a69de84ef0
+  data.tar.gz: de3ee440f9ccc69516c175b280d8e985d7d38568487e9fd407776d59f751b0a8
 SHA512:
-  metadata.gz: 3eefea572624e86e4989e6b74ea78ec22e0ebf892d210df335cc0776c34cdd7d4fe2552f18129521c1ddd8dd6cc2d74eaad0980a0fa794ac78acd7222b605699
-  data.tar.gz: be20e18cba6b24c7f5244a3db231ea5d7a30517a8f13d573e95ae58c20a3237d682b9f47d7e8ffe09fbac2858699116570d78f8bed16151013ec1418264a6fad
+  metadata.gz: 0be35ba10e00f96cb0ef286b0d86fb799bc332d46c8f38ee5eca93a4f55b01965e2b88a6bd2d759ea81798a03916d5b55a15b534e52bb390c17d23f402111dd4
+  data.tar.gz: 46155426b67b848c9c8678f0dccaadabab12cf4cb131d3e8d6f8177646773a839a3c86651b5dc788a1756802dd4c8b9f55e59201d5bbc0e5ba7b82e17375ed99

data/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.14.2] - 2026-04-13
+
+### Changed
+
+- **ace-support-test-helpers v0.14.2**: Standardized shared package tests to the fast-only layout and updated testing flow defaults.
+
+### Technical
+- Relaxed config-helper version assertions to validate semantic-version shape instead of a pinned placeholder value.
+## [0.14.1] - 2026-04-11
+
+### Changed
+- Migrated deterministic tests from `test/{atoms,molecules,fixtures}` to `test/fast/{atoms,molecules,fixtures}` to align with the fast/feat/e2e model as a fast-only package.
+- Updated README testing guidance to document the fast-only contract and canonical `ace-test` commands for this package.
+
+## [0.14.0] - 2026-04-10
+
+### Added
+- Added `SandboxPackageCopy`, a reusable helper for copying a target package into an isolated sandbox and owning the sandbox environment contract for restarted E2E flows.
+
 ## [0.13.1] - 2026-03-29
 
 ### Technical

data/README.md

@@ -24,6 +24,18 @@
 
 **Improve CI stability** - reduce flaky test behavior with shared deterministic helpers for directory management, configuration, and environment cleanup.
 
+## Testing Contract
+
+This package is **fast-only** in the ACE testing model.
+
+- Deterministic coverage lives under `test/fast/`.
+- This migration does not introduce `test/feat/` or `test/e2e/` for this package.
+
+Run:
+
+- `ace-test ace-support-test-helpers`
+- `ace-test ace-support-test-helpers all`
+
 ---
 
 Part of [ACE](https://github.com/cs3b/ace)

data/lib/ace/test_support/coverage.rb

@@ -33,7 +33,7 @@ module Ace
       #   Ace::TestSupport::Coverage.start('ace-search', minimum_coverage: 85)
       #
       # @example Additional groups
-      #   Ace::TestSupport::Coverage.start('ace-taskflow', groups: {
+      #   Ace::TestSupport::Coverage.start('ace-task', groups: {
       #     'CLI' => 'lib/ace/taskflow/cli'
       #   })
       def self.start(gem_name, options = {})

data/lib/ace/test_support/fixtures/bundle_mocks.rb

@@ -62,7 +62,7 @@ module Ace
           This mock content provides enough substance to satisfy
           integration test requirements while avoiding the 30-second
           delay caused by executing expensive shell commands like
-          ace-taskflow queries and recursive directory scans.
+          ace-task queries and recursive directory scans.
 
           By mocking ace-bundle, we achieve 10x faster test execution
           without sacrificing test coverage or reliability.

data/lib/ace/test_support/fixtures/git_mocks.rb

@@ -136,7 +136,7 @@ module Ace
           Ace::Core.define_singleton_method(:get, original) if original
         end
 
-        # Stub ace-taskflow CLI output
+        # Stub ace-task CLI output
         # @param task_id [String] The task ID
         # @param output [String] The taskflow output
         # @yield Block where the stub is active

data/lib/ace/test_support/sandbox_package_copy.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require "fileutils"
+
+module Ace
+  module TestSupport
+    # Creates deterministic E2E sandboxes and copies package sources into them.
+    class SandboxPackageCopy
+      DEFAULT_SANDBOX_BASE = ".ace-local/test-e2e"
+
+      def initialize(source_root: Dir.pwd, sandbox_base: DEFAULT_SANDBOX_BASE)
+        @source_root = File.expand_path(source_root)
+        @sandbox_base = File.expand_path(sandbox_base, @source_root)
+      end
+
+      # Prepare a sandbox and copy a package into it.
+      #
+      # Exactly one of sandbox_name or sandbox_root must be provided.
+      #
+      # @param package_name [String] package directory to copy
+      # @param sandbox_name [String, nil] sandbox folder name under .ace-local/test-e2e
+      # @param sandbox_root [String, nil] explicit sandbox path
+      # @return [Hash] sandbox_root, package_root, source_root, and env contract
+      def prepare(package_name:, sandbox_name: nil, sandbox_root: nil)
+        package = package_name.to_s.strip
+        raise ArgumentError, "package_name is required" if package.empty?
+
+        root = resolve_sandbox_root(sandbox_name: sandbox_name, sandbox_root: sandbox_root)
+        source_package = File.join(@source_root, package)
+        target_package = File.join(root, package)
+
+        unless File.directory?(source_package)
+          raise ArgumentError, "Package source directory not found: #{source_package}"
+        end
+
+        FileUtils.mkdir_p(root)
+        FileUtils.cp_r(source_package, target_package) unless File.exist?(target_package)
+
+        {
+          sandbox_root: root,
+          package_root: target_package,
+          source_root: @source_root,
+          env: {
+            "PROJECT_ROOT_PATH" => root,
+            "ACE_E2E_SOURCE_ROOT" => @source_root
+          }
+        }
+      end
+
+      private
+
+      def resolve_sandbox_root(sandbox_name:, sandbox_root:)
+        if sandbox_name && sandbox_root
+          raise ArgumentError, "Specify only one of sandbox_name or sandbox_root"
+        end
+
+        if sandbox_name
+          name = sandbox_name.to_s.strip
+          raise ArgumentError, "sandbox_name cannot be empty" if name.empty?
+
+          return File.join(@sandbox_base, name)
+        end
+
+        if sandbox_root
+          root = sandbox_root.to_s.strip
+          raise ArgumentError, "sandbox_root cannot be empty" if root.empty?
+
+          return File.expand_path(root)
+        end
+
+        raise ArgumentError, "Either sandbox_name or sandbox_root is required"
+      end
+    end
+  end
+end

data/lib/ace/test_support/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module TestSupport
-    VERSION = "0.13.1"
+    VERSION = "0.14.2"
   end
 end

data/lib/ace/test_support.rb

@@ -14,6 +14,7 @@ require_relative "test_support/subprocess_runner"  # Subprocess isolation utilit
 require_relative "test_support/base_test_case"  # Then base test case that uses it
 require_relative "test_support/config_helpers"
 require_relative "test_support/test_environment"
+require_relative "test_support/sandbox_package_copy"
 require_relative "test_support/performance_helpers"  # Performance testing utilities
 require_relative "test_support/fixtures/bundle_mocks"  # Shared bundle mocks
 require_relative "test_support/fixtures/git_mocks"  # Shared git mocks

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-support-test-helpers
 version: !ruby/object:Gem::Version
-  version: 0.13.1
+  version: 0.14.2
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-03-29 00:00:00.000000000 Z
+date: 2026-04-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -62,6 +62,7 @@ files:
 - lib/ace/test_support/fixtures/prompt_helpers.rb
 - lib/ace/test_support/fixtures/test_runner_mocks.rb
 - lib/ace/test_support/performance_helpers.rb
+- lib/ace/test_support/sandbox_package_copy.rb
 - lib/ace/test_support/subprocess_runner.rb
 - lib/ace/test_support/test_environment.rb
 - lib/ace/test_support/test_helper.rb