TEST-INFRA: [test-architecture] Organize Robot test files into subdirectories #6895

New issue

Open

opened 2026-04-10 04:54:24 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-10 04:54:24 +00:00

Owner

Metadata

Branch: refactor/test-infra/organize-robot-subdirectories
Commit Message: refactor(robot): organize Robot Framework test files into logical subdirectories
Milestone: Backlog (no milestone — see backlog note below)
Parent Epic: #5407

Summary

The robot/ directory contains a large number of Robot Framework test files (.robot) and helper files (.py) in a flat structure. This makes it difficult to navigate, maintain, and understand the integration test suite.

Duplicate Check

Search queries: "organize robot", "robot subdirectories", "structure robot files"
Results: 0 relevant issues found.

Proposal

Create subdirectories within robot/ to group related test files by functionality. Additionally, move all helper files into a dedicated libs/ or helpers/ subdirectory.

Example Structure:

robot/
├── cli/
│   ├── cli.robot
│   ├── cli_core.robot
│   └── ...
├── core/
│   ├── architecture.robot
│   ├── concurrency_locks.robot
│   └── ...
├── e2e/
│   ├── ...
├── libs/
│   ├── helper_a2a_facade.py
│   ├── helper_acms_backends.py
│   └── ...
└── plans/
    ├── plan_actor_integration.robot
    ├── plan_cli_spec.robot
    └── ...

Subtasks

Identify logical groupings for existing Robot test files.
Create new subdirectories in robot/ based on these groupings.
Create a libs/ subdirectory for all Python helper files.
Move the test files and helper files into their respective subdirectories.
Update any necessary paths in the Robot Framework configuration (robot.cfg) and in the test files themselves.
Run nox -s integration_tests to verify the test suite runs successfully after reorganization.
Run nox (all default sessions), fix any errors.

Definition of Done

All subtasks checked off.
All Robot test files in robot/ are organized into logical subdirectories.
All Python helper files are moved to a libs/ subdirectory.
The Robot Framework test suite runs successfully after the reorganization (nox -s integration_tests passes).
The project's testing documentation is updated to reflect the new structure.
Commit with message refactor(robot): organize Robot Framework test files into logical subdirectories pushed to branch refactor/test-infra/organize-robot-subdirectories.
PR submitted, reviewed, and merged.
All nox stages pass.
Coverage >= 97%.

Backlog note: This issue was discovered during autonomous operation
on milestone v3.2.0. It does not block milestone completion and has been
placed in the backlog for human review and future milestone assignment.

Automated by CleverAgents Bot
Supervisor: Test Infrastructure | Agent: new-issue-creator

## Metadata - **Branch**: `refactor/test-infra/organize-robot-subdirectories` - **Commit Message**: `refactor(robot): organize Robot Framework test files into logical subdirectories` - **Milestone**: Backlog (no milestone — see backlog note below) - **Parent Epic**: #5407 ## Summary The `robot/` directory contains a large number of Robot Framework test files (`.robot`) and helper files (`.py`) in a flat structure. This makes it difficult to navigate, maintain, and understand the integration test suite. ### Duplicate Check - Search queries: "organize robot", "robot subdirectories", "structure robot files" - Results: 0 relevant issues found. ## Proposal Create subdirectories within `robot/` to group related test files by functionality. Additionally, move all helper files into a dedicated `libs/` or `helpers/` subdirectory. **Example Structure:** ``` robot/ ├── cli/ │ ├── cli.robot │ ├── cli_core.robot │ └── ... ├── core/ │ ├── architecture.robot │ ├── concurrency_locks.robot │ └── ... ├── e2e/ │ ├── ... ├── libs/ │ ├── helper_a2a_facade.py │ ├── helper_acms_backends.py │ └── ... └── plans/ ├── plan_actor_integration.robot ├── plan_cli_spec.robot └── ... ``` ## Subtasks - [ ] Identify logical groupings for existing Robot test files. - [ ] Create new subdirectories in `robot/` based on these groupings. - [ ] Create a `libs/` subdirectory for all Python helper files. - [ ] Move the test files and helper files into their respective subdirectories. - [ ] Update any necessary paths in the Robot Framework configuration (`robot.cfg`) and in the test files themselves. - [ ] Run `nox -s integration_tests` to verify the test suite runs successfully after reorganization. - [ ] Run `nox` (all default sessions), fix any errors. ## Definition of Done - [ ] All subtasks checked off. - [ ] All Robot test files in `robot/` are organized into logical subdirectories. - [ ] All Python helper files are moved to a `libs/` subdirectory. - [ ] The Robot Framework test suite runs successfully after the reorganization (`nox -s integration_tests` passes). - [ ] The project's testing documentation is updated to reflect the new structure. - [ ] Commit with message `refactor(robot): organize Robot Framework test files into logical subdirectories` pushed to branch `refactor/test-infra/organize-robot-subdirectories`. - [ ] PR submitted, reviewed, and merged. - [ ] All nox stages pass. - [ ] Coverage >= 97%. > **Backlog note:** This issue was discovered during autonomous operation > on milestone v3.2.0. It does not block milestone completion and has been > placed in the backlog for human review and future milestone assignment. --- **Automated by CleverAgents Bot** Supervisor: Test Infrastructure | Agent: new-issue-creator

Rows
Columns