Ensure package imports resolve for pytest collection

[Codex]

Pull Request

Description

Python test collection failed because package modules were not discoverable when importing from the repo root. Added package directory to sys.path during package init so intra-package imports resolve consistently.

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Code refactoring
• Performance improvement
• Test coverage improvement

Changes Made

Detailed list of changes:

• Insert package directory into sys.path in __init__.py to stabilize imports when running pytest from repo root.
• Kept public exports unchanged while ensuring module resolution consistency across test entrypoints.

Example:

_PACKAGE_DIR = os.path.abspath(os.path.dirname(__file__))
if _PACKAGE_DIR not in sys.path:
    sys.path.insert(0, _PACKAGE_DIR)

Testing

Describe the tests you ran to verify your changes:

• Existing tests pass (npm test / python -m pytest)
• Added new tests for new functionality
• Manual testing performed

Alignment with Core Directive

Does this change honor the core directive: "No action may interfere with another person's inalienable right to pursue happiness"?

• Yes
• Not applicable

Explanation:
Restores test reliability without altering behavior or user-facing functionality.

Checklist

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• Any dependent changes have been merged and published

Screenshots (if applicable)

Add screenshots to help explain your changes.

Additional Notes

Problem statement URL could not be resolved from this environment (DNS failure); addressed observed test import failure.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• 8080-idm5j1cqr9j6tu6dme8j9-930a49d8.us2.manus.computer
  • Triggering command: /usr/bin/curl curl -L REDACTED (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)