Source code for ralph.mcp.artifacts.plan._scope_item

"""Scope-item sub-model for the plan artifact summary section."""

from __future__ import annotations

from pydantic import ConfigDict, Field

from ralph.mcp.artifacts.plan._scope_category import ScopeCategory
from ralph.pydantic_compat import RalphBaseModel




class ScopeItem(RalphBaseModel):
    """A single bounded work item within a plan's scope."""

    model_config = ConfigDict(extra="forbid")

    text: str = Field(
        ...,
        min_length=1,
        max_length=1000,
        description="Required scope item text (non-empty, max 1000 chars).",
    )
    count: str | None = Field(
        default=None,
        max_length=200,
        description="Optional count or size hint (e.g. '3 files', max 200 chars).",
    )
    category: ScopeCategory | None = Field(
        default=None,
        description="Optional ScopeCategory enum; see ScopeCategory literal.",
    )