Epic #322: connector skill contracts — 6/6 complete

[bradtaylorsf]

Session Summary

Branch: session/epic-322-epic-connector-skill-contracts-teach-every-connector-enforce-every-payload
Epic: #322
Issues completed: 6 (6 succeeded, 0 failed)
Recovered after interrupted finalization: yes

Issues

• fix: enforce connector skill contracts before task enqueue #316: fix: enforce connector skill contracts before task enqueue — SUCCESS (batch PR #395)
• feat: require connector skill files for every registered direct connector #317: feat: require connector skill files for every registered direct connector — SUCCESS (batch PR #395)
• feat: connector skills for civic and API-backed connectors #318: feat: connector skills for civic and API-backed connectors — SUCCESS (batch PR #395)
• feat: connector skills for site-navigation connectors #319: feat: connector skills for site-navigation connectors — SUCCESS (batch PR #395)
• feat: connector skills for paid gated and sanctions connectors #320: feat: connector skills for paid gated and sanctions connectors — SUCCESS (batch PR #396)
• test: backtest connector-contract planner handoff on 2026 candidate roster #321: test: backtest connector-contract planner handoff on 2026 candidate roster — SUCCESS (batch PR #396)

Closes #316
Closes #317
Closes #318
Closes #319
Closes #320
Closes #321

Verification

• bash scripts/test.sh — PASS (2534 passed, 2 skipped)
• uv run pytest tests/test_orchestrator_connector_contracts.py tests/test_candidate_roster_backtest.py tests/test_skills_content.py tests/test_doctor.py tests/research_agent/tools/test_registry.py tests/test_orchestrator_loop.py::test_connector_search_passthrough_covers_registered_payload_contracts -q — PASS (259 passed)
• uv run research doctor --json — PASS (ok: true; registry contract, skill, planner allowlist, and TaskKind coherence all ok)
• Manual registry smoke: state-election full-name payload repairs to CA; FEC empty candidate sweep repairs to kind=candidates_enumerate; sanctions kinds payload validates.

Review Fix

Independent review found that validated connector schema knobs accepted by connector search() functions could still be dropped by the dispatch passthrough whitelist. This branch adds kinds, provider, and timeout to the whitelist plus a registry-wide regression test so planner-visible connector knobs cannot silently disappear before dispatch.

Notes

This PR was recovered onto current origin/main after the original alpha-loop finalization force-pushed an incomplete session branch. The recovered branch is based on origin/main and contains the two successful batch commits with the docs/CONFIG.md conflict resolved by keeping both current config documentation and the new candidate-roster backtest guidance.

---

Automated by alpha-loop, recovered and independently verified by Codex.