# ============================================================================
# Estimation-Actor Action — Cost/Risk Estimation Before Execution
# ============================================================================
# Demonstrates the optional estimation_actor field for pre-execution
# cost and risk estimation.
# Create: agents action create --config examples/actions/estimation-actor.yaml
# ============================================================================

name: local/large-refactor
description: "Large-scale code refactoring with cost estimation"
long_description: |
  Performs a large-scale refactoring of a codebase module. An estimation
  actor runs after Strategize to predict cost, risk, and duration before
  execution proceeds.

strategy_actor: local/strategist
execution_actor: local/executor
estimation_actor: local/estimator
review_actor: local/reviewer

definition_of_done: |
  Refactoring complete. All tests pass. No regressions introduced.
  Code review approved by the review actor.

reusable: true
read_only: false

arguments:
  - name: target_module
    type: string
    required: true
    description: "Module path to refactor"
  - name: max_files_changed
    type: integer
    required: false
    description: "Maximum number of files to modify"
    default: 50
    min_value: 1
    max_value: 500

automation_profile: trusted

invariants:
  - "All existing tests must continue to pass"
  - "Public API signatures must not change without deprecation"