cleveragents/cleveragents-core

Fork 3

UAT: runtime/ module directory is empty (no init.py) — ghost package pollutes module namespace #4138

New issue

Open

opened 2026-04-06 10:38:22 +00:00 by freemo · 1 comment

freemo commented

2026-04-06 10:38:22 +00:00

Owner

Metadata

Branch: fix/remove-ghost-runtime-package
Commit Message: fix(runtime): remove empty ghost package directory polluting module namespace
Milestone: Backlog
Parent Epic: #946

Bug Report

Feature Area: Code Organization and Module Structure
Tested by: UAT tester instance uat-tester-code-org-001
Severity: Medium (structural/organization issue)

What Was Tested

Checked the top-level module structure of src/cleveragents/ for empty or ghost package directories that pollute the module namespace without providing any functionality.

Expected Behavior

All directories under src/cleveragents/ that appear as Python packages should either:

Contain an __init__.py and provide actual functionality, OR
Be removed if they serve no purpose

Actual Behavior

src/cleveragents/runtime/ exists as a directory but contains only a __pycache__ directory — no __init__.py, no Python source files. This means:

It is not a valid Python package (no __init__.py)
It appears to be a ghost/stub directory with no content
It pollutes the module namespace

Evidence

$ ls src/cleveragents/runtime/
__pycache__

The directory contains only a __pycache__ directory with no source files.

Steps to Reproduce

ls src/cleveragents/runtime/

Impact

Confusing to developers who see runtime/ in the directory listing and expect it to contain something
The __pycache__ directory suggests this module once had content that was deleted without removing the directory
May indicate missing functionality that was planned but never implemented

Suggested Fix

Either:

Remove the src/cleveragents/runtime/ directory entirely if it serves no purpose
Add an __init__.py and implement the intended functionality if this module is planned

Code Location

src/cleveragents/runtime/

Subtasks

Investigate whether runtime/ is referenced anywhere in the codebase (imports, spec, docs)
Determine correct resolution: remove directory or scaffold proper package
If removing: delete src/cleveragents/runtime/ and its __pycache__ contents
If scaffolding: add __init__.py with appropriate module docstring and type annotations
Update .gitignore if needed to prevent stale __pycache__ directories from being committed
Verify no import errors introduced by the change
Run nox -e lint and nox -e typecheck to confirm clean state

Definition of Done

src/cleveragents/runtime/ either contains a valid __init__.py with functionality or is fully removed
No ghost/empty package directories remain under src/cleveragents/
All nox stages pass
Coverage >= 97%
PR merged and issue closed

Backlog note: This issue was discovered during autonomous operation
on milestone v3.6.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: UAT Testing | Agent: ca-new-issue-creator

## Metadata - **Branch**: `fix/remove-ghost-runtime-package` - **Commit Message**: `fix(runtime): remove empty ghost package directory polluting module namespace` - **Milestone**: Backlog - **Parent Epic**: #946 ## Bug Report **Feature Area:** Code Organization and Module Structure **Tested by:** UAT tester instance uat-tester-code-org-001 **Severity:** Medium (structural/organization issue) ### What Was Tested Checked the top-level module structure of `src/cleveragents/` for empty or ghost package directories that pollute the module namespace without providing any functionality. ### Expected Behavior All directories under `src/cleveragents/` that appear as Python packages should either: 1. Contain an `__init__.py` and provide actual functionality, OR 2. Be removed if they serve no purpose ### Actual Behavior `src/cleveragents/runtime/` exists as a directory but contains **only a `__pycache__` directory** — no `__init__.py`, no Python source files. This means: - It is not a valid Python package (no `__init__.py`) - It appears to be a ghost/stub directory with no content - It pollutes the module namespace ### Evidence ``` $ ls src/cleveragents/runtime/ __pycache__ ``` The directory contains only a `__pycache__` directory with no source files. ### Steps to Reproduce ```bash ls src/cleveragents/runtime/ ``` ### Impact - Confusing to developers who see `runtime/` in the directory listing and expect it to contain something - The `__pycache__` directory suggests this module once had content that was deleted without removing the directory - May indicate missing functionality that was planned but never implemented ### Suggested Fix Either: 1. Remove the `src/cleveragents/runtime/` directory entirely if it serves no purpose 2. Add an `__init__.py` and implement the intended functionality if this module is planned ### Code Location `src/cleveragents/runtime/` ## Subtasks - [ ] Investigate whether `runtime/` is referenced anywhere in the codebase (imports, spec, docs) - [ ] Determine correct resolution: remove directory or scaffold proper package - [ ] If removing: delete `src/cleveragents/runtime/` and its `__pycache__` contents - [ ] If scaffolding: add `__init__.py` with appropriate module docstring and type annotations - [ ] Update `.gitignore` if needed to prevent stale `__pycache__` directories from being committed - [ ] Verify no import errors introduced by the change - [ ] Run `nox -e lint` and `nox -e typecheck` to confirm clean state ## Definition of Done - [ ] `src/cleveragents/runtime/` either contains a valid `__init__.py` with functionality or is fully removed - [ ] No ghost/empty package directories remain under `src/cleveragents/` - [ ] All nox stages pass - [ ] Coverage >= 97% - [ ] PR merged and issue closed > **Backlog note:** This issue was discovered during autonomous operation > on milestone v3.6.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: UAT Testing | Agent: ca-new-issue-creator

freemo added a new dependency

2026-04-06 10:38:37 +00:00

#946 Epic: Stub Package Cleanup — Remove Ghost Packages and Empty Stub Modules

freemo referenced this issue

2026-04-06 10:39:53 +00:00

[Automated] CleverAgents Build Session - 2026-04-06 #3775

freemo referenced this issue

2026-04-06 10:40:01 +00:00

[Automated] CleverAgents Build Session - 2026-04-06 #3775

freemo added the

Points

label

2026-04-06 10:43:10 +00:00

freemo added this to the v3.5.0 milestone

2026-04-06 18:07:29 +00:00

freemo commented

2026-04-06 18:46:34 +00:00

Author

Owner

Milestone Triage Decision: Moved to Backlog

This cosmetic cleanup issue has been moved out of v3.5.0 during aggressive milestone triage. It does not block core autonomy hardening functionality.

Reasoning:

v3.5.0 focus: Essential autonomy hardening (guard enforcement, A2A facade, plan lifecycle)
This issue: Empty module directory cleanup - cosmetic/build hygiene
Impact: Code organization, not functional capability

Will be addressed in a future milestone focused on build and code organization cleanup.

**Milestone Triage Decision: Moved to Backlog** This cosmetic cleanup issue has been moved out of v3.5.0 during aggressive milestone triage. It does not block core autonomy hardening functionality. **Reasoning:** - v3.5.0 focus: Essential autonomy hardening (guard enforcement, A2A facade, plan lifecycle) - This issue: Empty module directory cleanup - cosmetic/build hygiene - Impact: Code organization, not functional capability Will be addressed in a future milestone focused on build and code organization cleanup.

freemo removed this from the v3.5.0 milestone

2026-04-06 20:39:48 +00:00