Promote timing_source into PsychophysicalKernel primary key

[rojasgabriel]

Summary

Promotes timing_source into the PsychophysicalKernel primary key so NIDQ and Bpod fits of the same config can coexist as separate rows. Drops the mixed enum value and renames nidaq to nidq.

Closes #13.

Changes

• Schema (labdata_plugin/analysisschema.py): timing_source is now part of the primary key with enum nidq / bpod. key_source emits one row per available timing source via available_timing_sources().
• Loader (src/behavior_analyses/kernel_timing.py): fetch_pooled_kernel_inputs requires an explicit timing_source and raises when the selected trial sets cannot supply it. No auto-prefer or silent pooling across clocks.
• Tests: Updated kernel timing tests; added coverage for availability checks and dual-clock keys sharing a fit config.
• Docs: Updated MIGRATION.md to reflect the key semantics.

Validation

• ruff check . — pass
• ruff format --check . — pass (after format)
• pytest tests/test_kernel_timing.py tests/test_schema_imports.py::SchemaImportTests::test_analysis_schema_imports_with_fake_labdata tests/test_cli_and_migration_contracts.py::CliContractTests — 16 passed

Live populate validation (GRB006 under both clocks) requires the lab DataJoint connection and is not run in the cloud agent.

Migration note

This is a key change: drop and re-declare PsychophysicalKernel before importing. Run migrate_kernel_timing_source.py (dry run, then --apply) against the live schema after merge.

  

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit c2a4853. Configure here.}