feat(lifecycle): expose pool allocation summary

[cwj2001]

Summary

Adds an optional lifecycle Sandbox.allocation summary for a currently confirmed Kubernetes Pool allocation:

{
  "allocation": {
    "mode": "pool",
    "poolRef": "example-pool",
    "state": "allocated"
  }
}

This is a narrow runtime core change only. It does not update SDKs, Gateway integrations, business APIs, CRDs, Pool scheduling behavior, or CreateSandbox responses.

Confirmation semantics

The Pool controller extends its existing internal allocation record with the concrete Pool reference and allocation generation. The lifecycle mapper emits the public summary only when it finds a non-deleting workload with a concrete non-wildcard spec.poolRef, the Pool allocation finalizer, valid nonempty unique Pod evidence, an exact internal-record Pool-ref match, and matching allocated Pod count.

The summary omits all unconfirmed cases, including direct sandboxes, legacy Pods-only records, missing/mismatched Pool references, invalid allocation records, deletion, and count mismatch. It does not expose Pod names, namespace, node/IP/UID, raw annotations, finalizers, or generation.

The internal generation is recorded for controller traceability but is intentionally not used as a public-evidence predicate: renewal of spec.expireTime and other non-allocation spec changes can advance CR generation without changing a valid Pool allocation.

Closes #1479.

Verification

• go test ./internal/controller -run "Test(Schedule|SetAllocation|SyncSandboxAllocation)" -count=1
• uv run --no-sync pytest tests/k8s/test_workload_mapper.py tests/test_routes_get_sandbox.py — 28 passed
• uv run --no-sync ruff check opensandbox_server/api/schema.py opensandbox_server/services/k8s/workload_mapper.py tests/k8s/test_workload_mapper.py tests/test_routes_get_sandbox.py
• git diff --check

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b41c366172

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[cwj2001]

SDK consumer follow-up is now included in 9dcb245.

Updated the affected stable get/list sandbox surfaces for Python, JavaScript, Kotlin, Go, and C#, with optional allocation omitted unchanged for legacy/non-Pool responses.

• Python and JavaScript lifecycle generated clients were regenerated from specs/sandbox-lifecycle.yml; their stable layers and conversion coverage were added.
• Kotlin lifecycle generation completed through the official Gradle task; generated build output remains uncommitted per SDK rules.
• Go and C# handwritten lifecycle clients/models/adapters and get/list parsing tests were updated.

Verification passed:

• server focused suite: 28 passed; ruff clean
• controller allocation-focused Go test
• Python ruff, pyright, and 80 focused tests
• JavaScript generator, lint, typecheck, build, and 90 tests
• Kotlin offline lifecycle generation and focused SandboxesAdapterTest
• Go SDK go test ./...

C# tests are present but could not run locally because this host has only .NET SDK 8.0.129 while the project targets net10.0. Broader Kubernetes env/e2e suites are environment-blocked before assertions (missing envtest/KIND and disk exhaustion); the focused controller test passes.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9dcb24550c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 180f3c18e0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".