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-6883): expose kernel scheduling history over GraphQL v2 #12989 — BA-6883 GraphQL v2: kernel history roots
• 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 kernel slice of the v2 scheduling-history adapter, plus the two REST v2 routes that expose it.

Route	Auth
POST /v2/scheduling-history/kernels/search	superadmin_required
POST /v2/scheduling-history/kernels/{kernel_id}/search	auth_required

Shape matches the session / deployment / route slices already in this module: the scope is a
path parameter, and the adapter method takes it as a separate argument
(kernel_scoped_search(kernel_id, input)).

The scoped route runs through the existing ScopeActionProcessor, so access is resolved
against the RBAC scope rather than a role gate. That is why it is auth_required and not
superadmin_required — unlike the sibling scoped routes, which are all registered
superadmin_required.

DTO naming

One input and one payload, shared by both routes:

	Type
Input	SearchKernelHistoriesInput
Payload	SearchKernelHistoriesPayload

No Admin-prefixed variants. The scope arrives in the path, so both routes take an identical
body, and the response shape does not depend on the caller either. KernelHistoryScopeDTO
sits in types.py next to SessionHistoryScopeDTO / DeploymentHistoryScopeDTO /
RouteHistoryScopeDTO for the GraphQL layer to use.

Not yet verifiable end-to-end

kernel_scheduling_history has no writer — KernelSchedulingHistoryCreatorSpec is defined but
called from nowhere, so the table is empty. BA-6852 adds the writer; live verification against a
running manager has to wait for it.

🤖 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/

[Copilot]

Pull request overview

Adds REST v2 access to kernel scheduling history through the existing adapter/service architecture.

Changes:

• Adds admin and authenticated kernel-scoped search routes.
• Converts kernel filters, ordering, pagination, and response DTOs.
• Updates OpenAPI documentation and changelog.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
registry.py	Registers kernel history routes and authorization middleware.
handler.py	Adds REST request handlers.
path_params.py	Adds the kernel UUID path model.
adapter.py	Implements query conversion and processor integration.
openapi.json	Documents schemas and endpoints.
12870.feature.md	Records the feature change.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[HyeockJinKim]

I didn't just want the kernel ID as the scope; I wanted to receive values that could be assigned to multiple scopes in the body, but it seems like something was set up incorrectly.