Move the vertex analyses to a plugin (source-analytics-vertex); v0.8.0

[alexedmon1]

Summary

• Adds a plugin hook (src/source_analytics/plugins.py). A package registers through the source_analytics.plugins entry-point group. It provides ANALYSES, METADATA and ALIASES, and optionally register_figures(registry). core installs plugins when it is imported. A plugin that fails to import is logged and skipped. One that reuses an existing analysis name raises.
• Moves the vertex analyses to the private repo alexedmon1/source-analytics-vertex:
  • vertex_cluster, vertex_connectivity, vertex_cross_freq, vertex_directed, vertex_evoked, vertex_graph, vertex_nbs, vertex_network, vertex_signature, vertex_spatial, vertex_specparam, and fcd_comparison
  • spectral.vertex and spectral.vertex_aperiodic
  • the five R/vertex_*.R scripts
  • the vertex figure schemas and glass-brain summaries
  • their tests
• A config, --analysis or init --analyses that names a moved analysis fails with a message naming the plugin. --analysis now validates with a type function instead of choices=, so it can print that message.
• Bumps the version to 0.8.0 and adds a CHANGELOG entry.

Kept in core

These stay because core modules use them:

• spectral.vertex_connectivity (electrode_connectivity's kernels)
• viz.glass_brain
• analyses._network_base
• the cluster-permutation statistics
• the BaseAnalysis vertex helpers (_vertex_epoch_config, _label_vertex_regions, cluster-state persistence)

electrode_signature still compares against a vertex_signature table in its own paradigm, if one exists.

Needs attention after merging

• The plugin's [tool.uv.sources] points at this branch. Re-pin it to v0.8.0 once that tag exists.

Tests

• Core alone: 219 passed.
• Core with the plugin installed: 218 passed, 1 skipped. The skipped test checks the "unknown analysis names the plugin" error, which needs the plugin absent.
• Plugin: 23 passed.
• source-analytics list checked with and without the plugin.
• Figure types come back with the plugin: vertex_spatial gets effect_heatmap, volcano and glass_brain; vertex_cluster and vertex_specparam get glass_brain.
• The plugin's R lookup resolves to its own R/.
• ruff --select F,E9 on the touched files: no new findings compared with v0.7.1.

🤖 Generated with Claude Code

https://claude.ai/code/session_01RibM8Zep2YEjjUbc2LLkgj