| name: ACRE |
| version: "1.0.0" |
| description: > |
| Autonomous Code Refactoring Environment - an RL environment where an |
| agent improves Python code quality using AST-level transformations. |
| author: "Nikhil Pratap Singh, Pranav Mangal, Ananya Gupta" |
| entrypoint: "server.app:app" |
| tags: |
| - openenv |
|
|
| tasks: |
| - id: rename_variables |
| name: "Rename Variables (Easy)" |
| description: "Rename generic variable names (x, tmp) to descriptive ones" |
| difficulty: easy |
| reward_range: [0.0, 1.0] |
| max_steps: 5 |
|
|
| - id: remove_dead_code |
| name: "Remove Dead Code (Medium)" |
| description: "Remove unreachable statements, if-False blocks, and unused assignments" |
| difficulty: medium |
| reward_range: [0.0, 1.0] |
| max_steps: 5 |
|
|
| - id: full_refactor |
| name: "Full Refactor (Hard)" |
| description: "Apply all transformations - rename, dead code removal, loop simplification, condition optimization, and function inlining" |
| difficulty: hard |
| reward_range: [0.0, 1.0] |
| max_steps: 5 |
|
|
| observation_space: |
| type: Box |
| shape: [4] |
| dtype: float32 |
| low: [0.0, 0.0, 0.0, 0.0] |
| high: [inf, inf, inf, 1.0] |
| fields: |
| - code_length |
| - complexity_score |
| - runtime_s |
| - error_flag |
|
|
| action_space: |
| type: Discrete |
| n: 5 |
| actions: |
| 0: rename_variable |
| 1: remove_dead_code |
| 2: simplify_loop |
| 3: optimize_condition |
| 4: inline_function |
|
|
| api: |
| health: "GET /" |
| reset: "POST /reset" |
| step: "POST /step" |
| state: "GET /state" |
| tasks: "GET /tasks" |
| grade: "POST /tasks/{task_id}/grade" |
|
|
| reward: |
| raw_range: [-32, 20] |
| normalized_range: [0.0, 1.0] |
| formula: "(raw + 32) / 52" |
| components: |
| success: { max: 10, min: -10 } |
| complexity: { max: 5, min: -5 } |
| performance: { max: 5, min: -2 } |
| error: { max: 0, min: -15 } |
| no_change: { max: 0, min: -2 } |
|
|
| validation: |
| python_api: |
| reset: "ObservationModel" |
| step: "(ObservationModel, RewardModel, done, info)" |
| state: "StateResponse" |
| http_api: |
| health: "GET /" |
| reset: "POST /reset" |
| step: "POST /step" |
| state: "GET /state" |
| tasks: "GET /tasks" |
| grade: "POST /tasks/{task_id}/grade" |
|
|
