ace-herdr 0.1.0

data/lib/ace/herdr.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+require_relative "herdr/version"
+require "ace/support/config"
+
+module Ace
+  module Herdr
+    class Error < StandardError; end
+
+    # Raised when the caller's herdr workspace/session/pane cannot be resolved
+    class TargetResolutionError < Error; end
+
+    # Raised when arguments or refs fail validation
+    class ValidationError < Error; end
+
+    # Raised when a bounded wait exceeds its timeout
+    class WaitTimeoutError < Error; end
+  end
+end
+
+# Executor error hierarchy (subclasses Ace::Herdr::Error)
+require_relative "herdr/errors"
+
+# Load all ace-herdr components
+require_relative "herdr/atoms/answer_digest"
+require_relative "herdr/models/delivery_record"
+require_relative "herdr/models/dispatch_outcome"
+require_relative "herdr/molecules/herdr_executor"
+require_relative "herdr/molecules/pane_tidy_probe"
+require_relative "herdr/molecules/delivery_record_store"
+require_relative "herdr/molecules/preset_loader"
+require_relative "herdr/molecules/preset_resolver"
+require_relative "herdr/organisms/deliverer"
+require_relative "herdr/organisms/dispatcher"
+require_relative "herdr/organisms/control_surface"
+require_relative "herdr/organisms/tidy"
+require_relative "herdr/cli"
+
+module Ace
+  module Herdr
+    # Returns the gem root directory
+    # @return [String] Path to the gem root directory
+    def self.gem_root
+      @gem_root ||= Gem.loaded_specs["ace-herdr"]&.gem_dir ||
+        File.expand_path("../..", __dir__)
+    end
+
+    # Check if debug mode is enabled
+    # @return [Boolean]
+    def self.debug?
+      ENV["ACE_DEBUG"] == "1" || ENV["DEBUG"] == "1"
+    end
+
+    # Load ace-herdr configuration using ace-config cascade
+    # Thread-safe: uses mutex for initialization
+    # @return [Hash] Merged configuration hash with defaults
+    def self.config
+      return @config if defined?(@config) && @config
+
+      @config_mutex.synchronize do
+        @config ||= load_config
+      end
+    end
+
+    # Reset config cache (useful for testing)
+    def self.reset_config!
+      @config_mutex.synchronize do
+        @config = nil
+      end
+    end
+
+    @config_mutex = Mutex.new
+
+    # Load configuration using Ace::Support::Config cascade
+    # @return [Hash] Merged configuration
+    def self.load_config
+      resolver = Ace::Support::Config.create(
+        config_dir: ".ace",
+        defaults_dir: ".ace-defaults",
+        gem_path: gem_root
+      )
+
+      resolver.resolve_namespace("herdr").data
+    rescue => e
+      warn "ace-herdr: Could not load config: #{e.class} - #{e.message}" if debug?
+      load_gem_defaults_fallback
+    end
+    private_class_method :load_config
+
+    # Load gem defaults directly as fallback
+    # @return [Hash] Defaults hash or empty hash
+    def self.load_gem_defaults_fallback
+      defaults_path = File.join(gem_root, ".ace-defaults", "herdr", "config.yml")
+      return {} unless File.exist?(defaults_path)
+
+      require "yaml"
+      YAML.safe_load_file(defaults_path, permitted_classes: [Date], aliases: true) || {}
+    rescue
+      {}
+    end
+    private_class_method :load_gem_defaults_fallback
+  end
+end

metadata

@@ -0,0 +1,224 @@
+--- !ruby/object:Gem::Specification
+name: ace-herdr
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Michal Czyz
+bindir: exe
+cert_chain: []
+date: 2026-09-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ace-hitl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: ace-support-cli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: ace-support-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.31'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.31'
+- !ruby/object:Gem::Dependency
+  name: ace-support-config
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
+- !ruby/object:Gem::Dependency
+  name: ace-support-test-helpers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.88'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.88'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+description: 'Push delivery and agent bootstrap for the Herdr runtime: deliver(ref,
+  answer) -> herdr agent prompt <pane>, bootstrap missing agents, and dispatch agents
+  with deterministic defaults. Implements the ace-hitl provider delivery contract.'
+email:
+- mc@cs3b.com
+executables:
+- ace-herdr
+extensions: []
+extra_rdoc_files: []
+files:
+- ".ace-defaults/herdr/config.yml"
+- ".ace-defaults/herdr/tabs/agent.yml"
+- ".ace-defaults/herdr/workspaces/development.yml"
+- CHANGELOG.md
+- LICENSE
+- README.md
+- Rakefile
+- docs/usage.md
+- exe/ace-herdr
+- lib/ace/herdr.rb
+- lib/ace/herdr/atoms/answer_digest.rb
+- lib/ace/herdr/cli.rb
+- lib/ace/herdr/cli/commands/capture.rb
+- lib/ace/herdr/cli/commands/close.rb
+- lib/ace/herdr/cli/commands/deliver.rb
+- lib/ace/herdr/cli/commands/dispatch.rb
+- lib/ace/herdr/cli/commands/list.rb
+- lib/ace/herdr/cli/commands/list_presets.rb
+- lib/ace/herdr/cli/commands/send.rb
+- lib/ace/herdr/cli/commands/support.rb
+- lib/ace/herdr/cli/commands/tab.rb
+- lib/ace/herdr/cli/commands/tidy.rb
+- lib/ace/herdr/cli/commands/wait.rb
+- lib/ace/herdr/cli/commands/workspace.rb
+- lib/ace/herdr/errors.rb
+- lib/ace/herdr/models/delivery_record.rb
+- lib/ace/herdr/models/dispatch_outcome.rb
+- lib/ace/herdr/molecules/delivery_record_store.rb
+- lib/ace/herdr/molecules/herdr_executor.rb
+- lib/ace/herdr/molecules/pane_tidy_probe.rb
+- lib/ace/herdr/molecules/preset_loader.rb
+- lib/ace/herdr/molecules/preset_resolver.rb
+- lib/ace/herdr/organisms/control_surface.rb
+- lib/ace/herdr/organisms/deliverer.rb
+- lib/ace/herdr/organisms/dispatcher.rb
+- lib/ace/herdr/organisms/tidy.rb
+- lib/ace/herdr/version.rb
+homepage: https://github.com/cs3b/ace
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/cs3b/ace
+  source_code_uri: https://github.com/cs3b/ace/tree/main/ace-herdr/
+  changelog_uri: https://github.com/cs3b/ace/blob/main/ace-herdr/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Zero-token ergonomic wrapper over the herdr CLI for agent panes
+test_files: []