optohub 0.1.4

Meta-package and manager for the OptoHub ecosystem

OptoHub

OptoHub is a specification-driven repository for ecosystem-level concept, ecosystem-level architecture, ecosystem-level rules, ecosystem member registry, ecosystem validation, and testing policy.

Repository Roles

• README.md is the human-oriented overview file in the repository root.
• AGENTS.md is the canonical AI entry point in the repository root.
• agent_docs/ contains the authoritative AI instruction hierarchy.
• This repository defines ecosystem-level structure and rules for OpticsEcoSys member projects.
• human_docs/ is reserved for optional human-facing detailed documentation.

Human Navigation

Human readers should start with this file for a high-level overview and use human_docs/ for any additional human-facing detail (including migration and consistency reports under human_docs/reports/ when present).

For the canonical AI-oriented interpretation of the repository structure and instruction hierarchy, see AGENTS.md.

Local ecosystem orchestration (developers)

Sibling repositories are expected next to the OptoHub checkout (same parent directory). Override the inferred workspace root with OPTOHUB_WORKSPACE_ROOT if your layout differs.

• python -m optohub.ecosystem.install_all — editable pip install -e for each registered sibling only (no tests). Writes human_docs/reports/runtime/optohub_install_report.json (gitignored).
• python -m optohub.ecosystem.run_all_tests — runs pytest in each sibling only (no installs). Writes human_docs/reports/runtime/optohub_test_report.json (gitignored).

tox: optohub-fast runs tests only; optohub-full recreates the env, runs install, then tests once.