Pedro
align coder summary schema and recover from validation errors
b8f6023
Raw History Blame Contribute Delete
3.11 kB
from typing import Annotated
from pydantic import BaseModel, ConfigDict, Field, StringConstraints, model_validator
NonBlankStr = Annotated[
str,
StringConstraints(
strip_whitespace=True,
min_length=1,
),
]
class CoderSummary(BaseModel):
model_config = ConfigDict(extra="forbid")
implementation_summary: NonBlankStr = Field(
description=(
"Brief factual summary of the production implementation completed "
"by the Coder. Do not include unverified test or quality claims."
)
)
completed_task_ids: list[NonBlankStr] = Field(
default_factory=list,
description=(
"Identifiers of Coder-owned plan tasks that were implemented. "
"Include only tasks supported by completed file operations."
),
)
modified_files: list[NonBlankStr] = Field(
default_factory=list,
description=(
"Project-relative paths of production files created or modified "
"by the Coder. Do not include test files."
),
)
runtime_dependencies: list[NonBlankStr] = Field(
default_factory=list,
description=(
"Production runtime dependencies added to the project. "
"Do not include testing, linting, coverage, or type-checking tools."
),
)
development_dependencies: list[NonBlankStr] = Field(
default_factory=list,
description=(
"Development dependencies added or changed by the Coder. "
"Do not include runtime dependencies or Tester-owned dependencies."
),
)
entry_points: list[NonBlankStr] = Field(
default_factory=list,
description=(
"Command-line entry-point names configured under [project.scripts]."
),
)
executed_operations: list[NonBlankStr] = Field(
default_factory=list,
description=(
"Operations actually executed by Coder tools and their observed "
"outcomes, such as successful uv sync or application launch."
),
)
unresolved_issues: list[NonBlankStr] = Field(
default_factory=list,
description=(
"Known implementation problems, blockers, uncertainties, or "
"failed operations that remain unresolved."
),
)
tester_notes: list[NonBlankStr] = Field(
default_factory=list,
description=(
"Concise handoff notes identifying behaviour or acceptance "
"criteria the Tester should verify. Do not claim they already pass."
),
)
@model_validator(mode="after") # TODO: Send error to the LLM later.
def validate_completion_evidence(self) -> "CoderSummary":
if not self.completed_task_ids and not self.unresolved_issues:
raise ValueError(
"The Coder summary must report at least one completed task "
"or at least one unresolved issue."
)
return self
class CoderCycle(BaseModel):
cycle_number: int
coder_summary: CoderSummary