ace-assign 0.37.0

data/lib/ace/assign/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Ace
+  module Assign
+    VERSION = "0.37.0"
+  end
+end

data/lib/ace/assign.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+require_relative "assign/version"
+require "ace/support/config"
+require "ace/support/fs"
+require "ace/support/nav"
+require "ace/support/cli"
+require "pathname"
+
+# CLI and commands
+require_relative "assign/cli"
+
+module Ace
+  module Assign
+    # Base error class for all ace-assign exceptions.
+    # Inherits from Ace::Support::Cli::Error to support exception-based
+    # exit code pattern (per ADR-023).
+    #
+    # Subclasses should call super with appropriate exit_code.
+    class Error < Ace::Support::Cli::Error
+      def initialize(message, exit_code: 1)
+        super
+      end
+    end
+
+    # Assignment-related errors
+    module AssignmentErrors
+      class NotFound < Error
+        def initialize(message = "Assignment not found")
+          super(message, exit_code: 2)
+        end
+      end
+
+      class NoActive < Error
+        def initialize(message = "No active assignment")
+          super(message, exit_code: 2)
+        end
+      end
+    end
+
+    # Config-related errors
+    module ConfigErrors
+      class NotFound < Error
+        def initialize(message = "Configuration not found")
+          super(message, exit_code: 3)
+        end
+      end
+    end
+
+    # Step-related errors
+    module StepErrors
+      class NotFound < Error
+        def initialize(message = "Step not found")
+          super(message, exit_code: 4)
+        end
+      end
+
+      class InvalidState < Error; end
+    end
+
+    # Define module namespaces
+    module Commands; end
+
+    # Check if debug mode is enabled
+    # @return [Boolean] True if debug mode is enabled
+    def self.debug?
+      ENV["ACE_DEBUG"] == "1" || ENV["DEBUG"] == "1"
+    end
+
+    # Configuration
+    # Follows ADR-022: Configuration Default and Override Pattern
+    # Uses Ace::Support::Config.create() for configuration cascade resolution
+    def self.config
+      @config ||= begin
+        gem_root = Gem.loaded_specs["ace-assign"]&.gem_dir ||
+          File.expand_path("../..", __dir__)
+
+        resolver = Ace::Support::Config.create(
+          config_dir: ".ace",
+          defaults_dir: ".ace-defaults",
+          gem_path: gem_root
+        )
+
+        # Resolve config for assign namespace
+        config = resolver.resolve_namespace("assign")
+        config.data
+      rescue => e
+        warn "ace-assign: Could not load config: #{e.class} - #{e.message}" if debug?
+        load_gem_defaults_fallback
+      end
+    end
+
+    # Reset config cache (useful for testing)
+    def self.reset_config!
+      @config = nil
+    end
+
+    # Default cache directory for assignments
+    # Returns an absolute path resolved from project root.
+    # Respects CACHE_BASE environment variable for sandboxed/isolated testing.
+    # Respects PROJECT_ROOT_PATH environment variable for sandboxed/isolated testing.
+    # @return [String] Cache directory path (absolute)
+    def self.cache_dir
+      # Allow explicit CACHE_BASE override for testing/sandboxing
+      cache_base = ENV["CACHE_BASE"]
+      if cache_base && !cache_base.empty?
+        return File.expand_path(cache_base)
+      end
+
+      relative_path = config["cache_dir"] || ".ace-local/assign"
+
+      # If already absolute, return as-is
+      return relative_path if Pathname.new(relative_path).absolute?
+
+      # Resolve relative to project root (respects PROJECT_ROOT_PATH)
+      project_root = Ace::Support::Fs::Molecules::ProjectRootFinder.find_or_current
+      File.join(project_root, relative_path)
+    end
+
+    # Load gem defaults from .ace-defaults/assign/config.yml
+    # @return [Hash] Gem defaults hash
+    def self.load_gem_defaults
+      gem_root = Gem.loaded_specs["ace-assign"]&.gem_dir ||
+        File.expand_path("../..", __dir__)
+      defaults_path = File.join(gem_root, ".ace-defaults", "assign", "config.yml")
+
+      return {} unless File.exist?(defaults_path)
+
+      YAML.safe_load_file(defaults_path, permitted_classes: [Date], aliases: true) || {}
+    end
+
+    # Load gem defaults directly as fallback
+    # @return [Hash] Defaults hash or empty hash if defaults also fail
+    def self.load_gem_defaults_fallback
+      load_gem_defaults
+    rescue
+      {}
+    end
+    private_class_method :load_gem_defaults_fallback
+  end
+end

metadata

@@ -0,0 +1,289 @@
+--- !ruby/object:Gem::Specification
+name: ace-assign
+version: !ruby/object:Gem::Version
+  version: 0.37.0
+platform: ruby
+authors:
+- Michal Czyz
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ace-support-cli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: ace-support-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.25'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.25'
+- !ruby/object:Gem::Dependency
+  name: ace-support-config
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: ace-support-nav
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: ace-b36ts
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: ace-support-markdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: ace-llm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.26'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.26'
+- !ruby/object:Gem::Dependency
+  name: ace-support-test-helpers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+- !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'
+description: Turns work into multi-step assignments with nested substeps, fork delegation
+  to long-running agent subprocesses, and inspectable session traces. Steps are defined
+  from a catalog, assembled via presets, and driven through a restartable queue.
+email:
+- mc@cs3b.com
+executables:
+- ace-assign
+extensions: []
+extra_rdoc_files: []
+files:
+- ".ace-defaults/assign/catalog/composition-rules.yml"
+- ".ace-defaults/assign/catalog/recipes/batch-tasks.recipe.yml"
+- ".ace-defaults/assign/catalog/recipes/documentation.recipe.yml"
+- ".ace-defaults/assign/catalog/recipes/fix-and-review.recipe.yml"
+- ".ace-defaults/assign/catalog/recipes/implement-simple.recipe.yml"
+- ".ace-defaults/assign/catalog/recipes/implement-with-pr.recipe.yml"
+- ".ace-defaults/assign/catalog/recipes/release-only.recipe.yml"
+- ".ace-defaults/assign/catalog/steps/apply-feedback.step.yml"
+- ".ace-defaults/assign/catalog/steps/commit.step.yml"
+- ".ace-defaults/assign/catalog/steps/create-pr.step.yml"
+- ".ace-defaults/assign/catalog/steps/create-retro.step.yml"
+- ".ace-defaults/assign/catalog/steps/fix-tests.step.yml"
+- ".ace-defaults/assign/catalog/steps/lint.step.yml"
+- ".ace-defaults/assign/catalog/steps/mark-task-done.step.yml"
+- ".ace-defaults/assign/catalog/steps/onboard-base.step.yml"
+- ".ace-defaults/assign/catalog/steps/onboard.step.yml"
+- ".ace-defaults/assign/catalog/steps/plan-task.step.yml"
+- ".ace-defaults/assign/catalog/steps/pre-commit-review.step.yml"
+- ".ace-defaults/assign/catalog/steps/push-to-remote.step.yml"
+- ".ace-defaults/assign/catalog/steps/rebase-with-main.step.yml"
+- ".ace-defaults/assign/catalog/steps/reflect-and-refactor.step.yml"
+- ".ace-defaults/assign/catalog/steps/release-minor.step.yml"
+- ".ace-defaults/assign/catalog/steps/release.step.yml"
+- ".ace-defaults/assign/catalog/steps/reorganize-commits.step.yml"
+- ".ace-defaults/assign/catalog/steps/research.step.yml"
+- ".ace-defaults/assign/catalog/steps/review-pr.step.yml"
+- ".ace-defaults/assign/catalog/steps/security-audit.step.yml"
+- ".ace-defaults/assign/catalog/steps/split-subtree-root.step.yml"
+- ".ace-defaults/assign/catalog/steps/squash-changelog.step.yml"
+- ".ace-defaults/assign/catalog/steps/task-load.step.yml"
+- ".ace-defaults/assign/catalog/steps/update-docs.step.yml"
+- ".ace-defaults/assign/catalog/steps/update-pr-desc.step.yml"
+- ".ace-defaults/assign/catalog/steps/verify-e2e.step.yml"
+- ".ace-defaults/assign/catalog/steps/verify-test-suite.step.yml"
+- ".ace-defaults/assign/catalog/steps/verify-test.step.yml"
+- ".ace-defaults/assign/catalog/steps/work-on-task.step.yml"
+- ".ace-defaults/assign/config.yml"
+- ".ace-defaults/assign/presets/fix-bug.yml"
+- ".ace-defaults/assign/presets/quick-implement.yml"
+- ".ace-defaults/assign/presets/release-only.yml"
+- ".ace-defaults/assign/presets/work-on-docs.yml"
+- ".ace-defaults/assign/presets/work-on-task.yml"
+- ".ace-defaults/nav/protocols/skill-sources/ace-assign.yml"
+- ".ace-defaults/nav/protocols/wfi-sources/ace-assign.yml"
+- CHANGELOG.md
+- README.md
+- Rakefile
+- docs/exit-codes.md
+- docs/getting-started.md
+- docs/handbook.md
+- docs/usage.md
+- exe/ace-assign
+- handbook/guides/fork-context.g.md
+- handbook/skills/as-assign-compose/SKILL.md
+- handbook/skills/as-assign-create/SKILL.md
+- handbook/skills/as-assign-drive/SKILL.md
+- handbook/skills/as-assign-prepare/SKILL.md
+- handbook/skills/as-assign-recover-fork/SKILL.md
+- handbook/skills/as-assign-run-in-batches/SKILL.md
+- handbook/skills/as-assign-start/SKILL.md
+- handbook/workflow-instructions/assign/compose.wf.md
+- handbook/workflow-instructions/assign/create.wf.md
+- handbook/workflow-instructions/assign/drive.wf.md
+- handbook/workflow-instructions/assign/prepare.wf.md
+- handbook/workflow-instructions/assign/recover-fork.wf.md
+- handbook/workflow-instructions/assign/run-in-batches.wf.md
+- handbook/workflow-instructions/assign/start.wf.md
+- lib/ace/assign.rb
+- lib/ace/assign/atoms/assign_frontmatter_parser.rb
+- lib/ace/assign/atoms/catalog_loader.rb
+- lib/ace/assign/atoms/composition_rules.rb
+- lib/ace/assign/atoms/number_generator.rb
+- lib/ace/assign/atoms/preset_expander.rb
+- lib/ace/assign/atoms/step_file_parser.rb
+- lib/ace/assign/atoms/step_numbering.rb
+- lib/ace/assign/atoms/step_sorter.rb
+- lib/ace/assign/atoms/tree_formatter.rb
+- lib/ace/assign/cli.rb
+- lib/ace/assign/cli/commands/add.rb
+- lib/ace/assign/cli/commands/assignment_target.rb
+- lib/ace/assign/cli/commands/create.rb
+- lib/ace/assign/cli/commands/fail.rb
+- lib/ace/assign/cli/commands/finish.rb
+- lib/ace/assign/cli/commands/fork_run.rb
+- lib/ace/assign/cli/commands/list.rb
+- lib/ace/assign/cli/commands/retry_cmd.rb
+- lib/ace/assign/cli/commands/select.rb
+- lib/ace/assign/cli/commands/start.rb
+- lib/ace/assign/cli/commands/status.rb
+- lib/ace/assign/models/assignment.rb
+- lib/ace/assign/models/assignment_info.rb
+- lib/ace/assign/models/queue_state.rb
+- lib/ace/assign/models/step.rb
+- lib/ace/assign/molecules/assignment_discoverer.rb
+- lib/ace/assign/molecules/assignment_manager.rb
+- lib/ace/assign/molecules/fork_session_launcher.rb
+- lib/ace/assign/molecules/queue_scanner.rb
+- lib/ace/assign/molecules/skill_assign_source_resolver.rb
+- lib/ace/assign/molecules/step_renumberer.rb
+- lib/ace/assign/molecules/step_writer.rb
+- lib/ace/assign/organisms/assignment_executor.rb
+- lib/ace/assign/version.rb
+homepage: https://github.com/cs3b/ace
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/cs3b/ace
+  source_code_uri: https://github.com/cs3b/ace
+  changelog_uri: https://github.com/cs3b/ace/blob/main/ace-assign/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: Multi-step assignment execution with nesting, fork delegation, and inspectable
+  traces
+test_files: []