[TENT] Add IntentType enum to Request for Transfer Intent API

[catyans]

Summary

Define standard intent categories for TENT's Transfer Intent API, so the engine can identify a request's business semantics (KV foreground read vs background prefetch vs migration, etc.) before scheduling.

Changes

tent/include/tent/common/types.h (+11):

• Add enum class IntentType: INTENT_UNSPEC, FOREGROUND_GET, BACKGROUND_PREFETCH, MIGRATION, CHECKPOINT, WEIGHT_LOADING, STAGING_INTERNAL
• Add Request::intent_type field (default IntentType::INTENT_UNSPEC, behavior byte-identical to today)

tent/src/python/pybind.cpp (+26/-3):

• Export IntentType enum to Python
• Add intent_type, policy_name, deadline_ns to Request.__init__ constructor (all with backward-compatible defaults)
• Add def_readwrite for all three fields

tent/tests/intent_type_test.cpp (new, 95 lines):

• 6 gtest cases: defaults, assignment, integer values, field independence, copy, batch usage

Test plan

• gtest: 6 cases passed on cluster (lingjun-099, gcc-13.3)
• clang-format-20: passed on all modified files
• GitHub CI: tent-ci (cuda-on/off), build-wheel, build-arm64, build-musa, format check — all passed

Performance note

This PR adds a metadata-only field (4-byte int) to Request. No runtime logic reads it yet — behavior is byte-identical to before. No performance regression possible.

Design notes

• Uses enum class (scoped enum) to prevent namespace pollution per reviewer feedback.
• Opt-in, default-off: INTENT_UNSPEC means "no intent declared" — engine behaves identically to today.
• The enum is intentionally flat (not a bitfield) because a request has exactly one business intent.
• Future PRs will use intent_type to drive policy selection, admission priority, or telemetry tagging — this PR only defines the vocabulary.

Relates to: TENT roadmap "Transfer Intent API"

[gemini-code-assist]

Code Review

This pull request introduces a new IntentType enum and integrates it into the Request struct, its Python bindings, and corresponding unit tests. The reviewer recommends refactoring the plain IntentType enum to a scoped enum class to prevent namespace pollution and improve type safety, along with updating the default initializer and unit tests to use the scoped enum values.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[alogfans]

LGTM after merging conflicts

[catyans]

Merged current upstream/main and resolved the pybind conflict in 5905bea5. The binding keeps main’s policy_name and deadline_ns fields and adds this PR’s intent_type without changing the existing positional field order. Cluster smoke build completed, and tent_intent_type_test passes 6/6. The PR is mergeable and approved again; remaining CI jobs are still running.