refactor: Implement Split-Directory Workspace with PEP 420 Namespace Packaging

[jhutar]

Summary

This PR reorganizes the repository structure to eliminate code duplication between the core library and the full installation.

Implementation detail: We have transitioned to a modern workspace/monorepo layout using PEP 420 Implicit Namespace Packages, allowing the opl namespace to be shared across physically separate directories.

Architectural Changes

• Directory Split: Migrated all source code into core/opl/ (minimal dependencies) and extras/opl/ (heavy dependencies).
• Deduplication: Removed the duplicated source tree in core/, establishing a single source of truth for all modules.
• Meta-Packaging: Converted the root setup.py into a "meta-package" that orchestrates the installation of both sub-packages.

AI Software Architect Framework

This repository now utilizes the AI Software Architect framework for tracking architectural decisions and conducting specialist reviews.

It's core concept (as far as I understand it) is to allow you breaking changes into manageable steps and employing a automatic review by different AI personas to achieve better outcome.

Key Commands for AI Assistants

If you are using an AI assistant in this repository, you can now issue commands such as:

• "What is our architecture status?"
• "Create ADR for [Topic]"
• "Start architecture review for [Version/Feature]"
• "Ask [Specialist Role] to review [File/PR]"

Detailed architectural reasoning for this refactor can be found in (check is as an example of what can be done):

• ADR-012: Reorganize Repository Structure using Split Directories - see file .architecture/decisions/adrs/ADR-012-reorganize-repository-structure-for-core-and-full-installations.md
• Review: Architecture Review: ADR-012 split-directories - see file .architecture/reviews/ADR-012-split-directories.md

Validation

To test this, I successfully ran this test:

set -x
set -ue

rm -rf venv-*

python -m venv venv-extras-e
python -m venv venv-extras
python -m venv venv-core-e
python -m venv venv-core
python -m venv venv-all-e
python -m venv venv-all
python -m venv venv-dev-e

source venv-all/bin/activate
python -m pip install git+https://github.com/redhat-performance/opl.git@jhutar3
status_data.py -h
script-skip-to-end.py -h
deactivate

source venv-all/bin/activate
python -m pip install -e "git+https://github.com/redhat-performance/opl.git@jhutar3#egg=opl-rhcloud-perf-team"
status_data.py -h
script-skip-to-end.py -h
deactivate

source venv-core/bin/activate
python3 -m pip install "git+https://github.com/redhat-performance/opl.git@jhutar3#egg=opl-rhcloud-perf-team-core&subdirectory=core"
status_data.py -h
script-skip-to-end.py -h && false
deactivate

source venv-core-e/bin/activate
python3 -m pip install -e "git+https://github.com/redhat-performance/opl.git@jhutar3#egg=opl-rhcloud-perf-team-core&subdirectory=core"
status_data.py -h
script-skip-to-end.py -h && false
deactivate

source venv-extras/bin/activate
python3 -m pip install "git+https://github.com/redhat-performance/opl.git@jhutar3#egg=opl-rhcloud-perf-team-core&subdirectory=core"
python3 -m pip install "git+https://github.com/redhat-performance/opl.git@jhutar3#egg=opl-rhcloud-perf-team-extras&subdirectory=extras"
status_data.py -h
script-skip-to-end.py -h
deactivate

source venv-extras-e/bin/activate
python3 -m pip install -e "git+https://github.com/redhat-performance/opl.git@jhutar3#egg=opl-rhcloud-perf-team-core&subdirectory=core"
python3 -m pip install -e "git+https://github.com/redhat-performance/opl.git@jhutar3#egg=opl-rhcloud-perf-team-extras&subdirectory=extras"
status_data.py -h
script-skip-to-end.py -h
deactivate

source venv-extras-e/bin/activate
python -m pip install -e .[dev]
status_data.py -h
script-skip-to-end.py -h
deactivate

echo "ALL GOOD"

[jhutar]

Checked current linter errors, and these are false positives I think.

No feedback, merging.

[jhutar]

Oops, had to delete bunch of DELME/* files :)