[trissim]

What

Two fixes for the validate CI job:

1. source_schema.py: imported FilenameParseResult from interfaces.py where it doesn't exist — real declaration is in parser_metaprogramming.py. Another wrong import path hidden by the cascade of cycle crashes.

2. website-pages.yml: added pip install -e . after the local submodule installs. The validate job imports the entire openhcs runtime through gallery_catalog.py → ExecutionConnectionSpec, but only installed 4 local packages (metaclass-registry, polystore, python-introspect, zmqruntime). This crashed with ModuleNotFoundError: No module named 'pandas' because openhcs declares pandas/numba/scipy in pyproject.toml but nobody installed openhcs itself.

Handoff notes for whoever takes over

This PR is the tail end of a long cascade of hidden bugs unmasked by the import cycle fixes in PRs #1348–#1351 (all merged to main). Here's the state of play:

Done (on main)

• PlaneProvenance / PlaneMetadata ABCs created in core/payload/plane_provenance.py — the arraypipe extraction's abstract base types replacing concrete domain types in infrastructure signatures
• Zero module-level import cycles in core/ (verified by AST scanner in scratchpad/find_cycles.py)
• 91 files had slots=True removed from dataclasses with forward-ref annotations (Python 3.12 get_type_hints() incompatibility)
• Stray @dataclass decorators on enums, @lru_cache functions, and plain functions — all removed
• Phantom types (VariableAxisChoices, GroupingChoices, AxisChoices, 8 Lazy* types in AbstractStep) — all removed
• numba made optional with try/except in two core modules
• All prior PRs merged: Phase 1+2: isinstance cascade, boolean rosters, relative imports, TYPE_CHECKING guards #1348, Fix CI: break circular import through memory/decorators.py #1349, Fix validate CI: make numba imports optional in core/ #1350, Fix validate: add missing Axis import and AxisChoices to source_bindings #1351

This PR

• Commit 1: fix FilenameParseResult import path
• Commit 2: add pip install -e . to the validate workflow

What might still break after this lands

The pip install -e . should fix the missing-dependency errors (pandas, numba, scipy — all declared in pyproject.toml). But once those imports succeed, gallery_catalog.py will exercise deeper parts of the runtime. The pattern so far has been: every cycle fix reveals the next crash deeper in the import chain. If that happens:

1. Check the CI error — it'll be an ImportError or NameError
2. Trace the import chain
3. Push the import to a late (function-level) import, or fix the wrong import path
4. Push and wait for CI again

Structural debt remaining

• 32 import cycles remain in the authoring.session.* cluster — outside the validate chain, but structural debt
• scratchpad/ has useful tools: find_cycles.py (AST-based cycle scanner), fix_slots.py (automated slots=True remover), arraypipe-extraction-plan.md, arraypipe-modules.md

The validate CI error before this fix

ImportError: cannot import name 'update_metadata_for_zarr_conversion' from 'openhcs.core.steps.function_io'

That error was from the previous run before the pip install -e . fix. The root cause was that without openhcs installed, Python couldn't resolve the full dependency tree, so imports failed at arbitrary points.

---

🤖 Generated with Claude Code

https://claude.ai/code/session_01RnH6dSF2WY8h81JeVyNYgb

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota. Try requesting a review at a lower effort level.

An organization owner can choose the repository organization as the billing source for reviews requested by members with a paid Copilot license. Learn about Copilot code review billing.