twopy 0.2.1

Features

• Added a GitHub Pages documentation site for twopy.gumadeiras.com.
• Added stable custom-workflow access to converted recording metadata through ctx.recording_metadata(), including typed helpers for run and acquisition fields.

Changes

• Added a GitHub repository footer icon and copyright notice to the documentation site.
• Overhauled the documentation site for end users: rewrote the landing page, added a Getting Started walkthrough, split the GUI guide into per-task pages (Loading, ROIs, Plots, Custom tab, Group Matching, Saving) under docs/gui/, rewrote the Python API and custom-workflow writing guides in plainer language, and tightened the input-data and recording-file reference intros.
• Switched the documentation site to the Furo theme.
• Made the napari Plot tab's Show SEM toggle start unchecked.
• Made Custom-tab workflow results show one selectable compact output folder and avoid horizontal scrolling from long output paths.
• Changed native Response kernels defaults to 100 past stimulus samples and 10 future stimulus samples for both olfaction and vision.
• Changed Group Matching FOV and ROI card overlays and ROI trace chips to show recording labels as YYYY.MM.DD HH:MM.
• Added a developer function-inventory script that reports action-oriented per-function size, docstring size, direct call counts, direct test counts, API surface, domain, git churn, risk score, and simple complexity.
• Made the native Response kernels Stimulus control default to olfaction for OdorRig recordings and vision for other rigs.
• Reworked the napari Group Matching FOV and ROI assignment views with larger image previews, clearer staged headings, grouped file/action/preview sections, theme-aware colors, more legible primary and destructive actions, and a compact two-column FOV assignment layout with image-overlaid recording labels, vertical contrast sliders, a vertical-only scrollable left control column, and compact FOV ID step buttons.
• Made the Group Matching popup expand to the current display without entering macOS fullscreen, removed the maximum-height cap, added hover color feedback to matching buttons, and added a compact four-row current-FOV table that reselects assigned recording cards for edits.
• Moved the Group Matching ROI controls into a compact left sidebar, placed a selected-ROI chip panel above separate ROI-response and combined-response plot sections, and added numeric FOV IDs, numeric ROI dropdown labels, selectable ROI load-status paths, inline ROI color chips, resizable saved-group columns, epoch visibility controls, ROI-response plot toggles, and resize-safe response previews with size-aware plot text.
• Made Group Matching ROI cards select ROIs directly from mean-image overlay clicks, with a second click on the selected ROI returning the card to No ROI.
• Made Group Matching and live ROI response previews reuse selected ROI traces, response contexts, and compact epoch plot widgets more aggressively, while initial response heatmaps now compute in the existing background worker on recording load.
• Moved napari Group Matching into a package with shared card, table, image, response-preview, and style helpers, and made FOV cards use the same fixed-size responsive grid behavior as ROI cards.

Fixes

• Made ROI y-stripe background correction stop before dF/F when it over-subtracts any ROI baseline, with guidance to use shared y-stripe/global background or redraw ROIs with dim local background pixels.
• Made Group Matching Selected ROI chips sit directly next to each other while still wrapping to new rows when the window is narrow.
• Kept the Group Matching ROI assignment header and selected-ROI summary visible by placing ROI responses and combined responses side by side in horizontal-only scroll areas that reserve full plot height, plus a vertical-only ROI-card scroll area.
• Tightened the Group Matching popup's outer frame padding so both FOV assignment and ROI assignment use more of the available window.
• Made the Group Matching ROI plot-setting smoothing and normalization dropdowns show all choices without scrolling.
• Kept napari response-plot scrolling responsive for long recordings and many visible ROIs by caching epoch plot rasters and using pixel-density-aware trace drawing.
• Made Return in the napari database-search window search from filter fields and load selected result rows from the result tree.
• Kept the napari Metadata and Export tabs from widening the sidebar with a horizontal scrollbar when status paths are long, and made Metadata text selectable for copying.
• Made missing database-loaded recordings report every configured data_paths candidate instead of only the first cache fallback path.
• Kept Direction selectivity's metric window cap tied to the selected preferred/null stimulus epochs instead of unrelated shorter epochs such as gray interleaves.
• Cleared stale Custom-tab workflow outputs when loading, selecting, or clearing a recording.
• Kept native response-kernel mean plot legends focused on mean traces by omitting separate SEM band legend entries.
• Cleared stale Custom-tab workflow outputs after failed DSI or response-kernel runs and when a run returns no displayable outputs.
• Kept Group Matching's auto-managed ROI match CSV path following the current loaded-recordings CSV folder after unloading all recordings and loading a new CSV list, while preserving explicitly chosen ROI CSV paths.
• Kept Group Matching ROI-view selection changes from moving focus back to the main napari window, from flashing the response preview rows on each update, and from carrying hidden response chips into a newly selected saved group.
• Kept the Group Matching Selected ROIs panel showing a current trace-visibility status for single, all-visible, partially hidden, and fully hidden selections.
• Kept napari Load manually and Load CSV list dialog folders independent so choosing one no longer overwrites the other's remembered location.
• Kept napari response plots from carrying stale epoch visibility into newly loaded recordings, so gray/interleave epochs are hidden by default after loading a CSV list.