Ralph Loop: Unmatched Candidate State Categories

Why

The live candidate-review packet already exposed unmatched semantic blockers and a global unmatched category tally, but it still hid whether uncovered inventory was clogging review_candidate or only the broader research_candidate queue.

Change

Added state-split unmatched semantic category diagnostics:

1. top_unmatched_review_candidate_categories
2. top_unmatched_research_candidate_categories

These now flow through:

1. research/candidate_review.py
2. research/continuous_loop.py
3. research/status.py
4. research/discord_status.py
5. research/README.md

Validation

Focused tests:

pytest -q tests/test_candidate_review.py tests/test_continuous_loop.py tests/test_research_status.py

Result:

32 passed in 0.23s

Live smoke:

python3 - <<'PY'
from research.candidate_review import build_live_candidate_review
from research.continuous_loop import _resolve_db_path
import json
review = build_live_candidate_review(_resolve_db_path({}), recent_runs=6, max_per_state=3, deployment_gate_ready=False, deployment_gate_reasons=[])
print(json.dumps({
    'counts_by_state': review.get('counts_by_state'),
    'unmatched_semantic_sleeve_count': review.get('unmatched_semantic_sleeve_count'),
    'top_unmatched_semantic_categories': review.get('top_unmatched_semantic_categories'),
    'top_unmatched_review_candidate_categories': review.get('top_unmatched_review_candidate_categories'),
    'top_unmatched_research_candidate_categories': review.get('top_unmatched_research_candidate_categories'),
}, indent=2))
PY

Observed current state:

1. counts_by_state = {"research_candidate": 18}
2. unmatched_semantic_sleeve_count = 15
3. top_unmatched_review_candidate_categories = []
4. top_unmatched_research_candidate_categories is dominated by Science and Technology=4, World=3, Companies=3, Economics=3, Politics=2

Outcome

Ralph can now distinguish “uncovered categories are blocking live review” from “uncovered categories only exist in the broader research queue,” which is a tighter candidate-review quality diagnostic than the previous global unmatched tally alone.