feat(BA-6892): add kernel scheduling-history adapter and REST v2 endpoints

[jopemachine]

📚 Stacked PRs

• fix(BA-6887): reference the real from_status/to_status columns in kernel history conditions #12857 — BA-6887 fix: kernel history conditions reference the real status columns ✅
• feat(BA-6889): add kernel scheduling-history query conditions and orders #12867 — BA-6889 models: kernel query conditions and orders ✅
• feat(BA-6890): add kernel scheduling-history repository search scope #12868 — BA-6890 repository: kernel search scope and scoped search ✅
• feat(BA-6891): add kernel scheduling-history v2 DTOs and service actions #12869 — BA-6891 DTO + service: kernel v2 DTOs and search actions
• feat(BA-6892): add kernel scheduling-history adapter and REST v2 endpoints #12870 — BA-6892 adapter + REST v2: kernel endpoints ← you are here
• feat(BA-6893): add kernel scheduling-history SDK v2 client and CLI commands #12866 — BA-6893 SDK + CLI: kernel commands

Merge in order, bottom-up. Each PR is based on the one above it, so its diff shows only its own layer.

What

The adapter and the two REST v2 endpoints:

Route	Auth
POST /v2/scheduling-history/kernels/search	superadmin_required
POST /v2/scheduling-history/kernels/scoped/search	auth_required

Two deliberate departures from the existing slices

Both follow the forward direction documented in api/rest/v2/AGENTS.md and client/v2/AGENTS.md, which the session / deployment / route slices predate.

1. The scope is a request body field, not a path param. A kernel query is scoped by session_id, kernel_id, or both, and an empty scope must be rejected — none of which a path param can express. api/rest/v2/AGENTS.md names this exact shape as the forward direction:

Forward direction: fixed path /v2/{entity}/scoped/search + scope as a request body field (not a path param). Consistent with SDK scoped_search and GQL scopedFoosV2.

Hence /kernels/scoped/search and the scoped_ handler prefix, rather than /kernels/{kernel_id}/search.

2. The scoped route uses auth_required, not superadmin_required. api/rest/v2/AGENTS.md states that all scoped search routes use auth_required, and BA-6882's acceptance criteria require a non-admin scoped search.

⚠️ Note the existing session / deployment / route scoped routes are all registered superadmin_required, which appears to defeat the purpose of a scoped search (a superadmin needs no scope). That looks like a bug in those routes, but changing them is out of scope here — flagging it for a separate decision.

Review notes

_convert_kernel_filter is the bulk of the diff and mirrors _convert_session_filter axis for axis. Tests cover filter conversion per axis, OR conjunction collapsing to one condition, order direction, and data→DTO conversion including null statuses.

The SDK and CLI that call these endpoints are #12866.

🤖 Generated with Claude Code

---

📚 Documentation preview 📚: https://sorna--12870.org.readthedocs.build/en/12870/

---

📚 Documentation preview 📚: https://sorna-ko--12870.org.readthedocs.build/ko/12870/

---

📚 Documentation preview 📚: https://sorna--12870.org.readthedocs.build/en/12870/

---

📚 Documentation preview 📚: https://sorna-ko--12870.org.readthedocs.build/ko/12870/