draft-board 0.1.0-beta.0

package/app/backend/app/schemas/evidence.py

@@ -0,0 +1,87 @@
+"""Pydantic schemas for Evidence entity."""
+
+from datetime import datetime
+from enum import StrEnum
+
+from pydantic import BaseModel, Field
+
+
+class EvidenceKind(StrEnum):
+    """Enum representing the kind of evidence.
+
+    Metadata evidence (JSON in stdout_path):
+    - EXECUTOR_META: JSON with exit_code, duration, executor_type, mode, command
+    - VERIFY_META: JSON with exit_code, commands_run, duration, results per command
+
+    Evidence types for execution:
+    - EXECUTOR_STDOUT: stdout from executor CLI (Claude/Cursor)
+    - EXECUTOR_STDERR: stderr from executor CLI
+    - GIT_DIFF_STAT: output of `git diff --stat`
+    - GIT_DIFF_PATCH: full git diff patch
+
+    Evidence types for verification:
+    - VERIFY_STDOUT: stdout from verification command
+    - VERIFY_STDERR: stderr from verification command
+
+    Legacy types (kept for backwards compatibility):
+    - COMMAND_LOG: generic command output
+    - TEST_REPORT: test framework report
+    """
+
+    # Metadata evidence (JSON)
+    EXECUTOR_META = "executor_meta"
+    VERIFY_META = "verify_meta"
+
+    # Executor evidence
+    EXECUTOR_STDOUT = "executor_stdout"
+    EXECUTOR_STDERR = "executor_stderr"
+
+    # Git diff evidence
+    GIT_DIFF_STAT = "git_diff_stat"
+    GIT_DIFF_PATCH = "git_diff_patch"
+
+    # Verification evidence
+    VERIFY_STDOUT = "verify_stdout"
+    VERIFY_STDERR = "verify_stderr"
+
+    # Merge evidence
+    MERGE_STDOUT = "merge_stdout"
+    MERGE_STDERR = "merge_stderr"
+    MERGE_META = "merge_meta"
+
+    # Legacy types (backwards compatibility)
+    COMMAND_LOG = "command_log"
+    TEST_REPORT = "test_report"
+
+
+class EvidenceResponse(BaseModel):
+    """Schema for evidence response."""
+
+    id: str
+    ticket_id: str
+    job_id: str
+    kind: EvidenceKind
+    command: str
+    exit_code: int
+    stdout_path: str | None
+    stderr_path: str | None
+    created_at: datetime
+    succeeded: bool = Field(
+        description="Whether the command succeeded (exit_code == 0)"
+    )
+
+    model_config = {"from_attributes": True}
+
+
+class EvidenceDetailResponse(EvidenceResponse):
+    """Schema for detailed evidence response including stdout/stderr content."""
+
+    stdout: str | None = Field(None, description="Content of stdout (if available)")
+    stderr: str | None = Field(None, description="Content of stderr (if available)")
+
+
+class EvidenceListResponse(BaseModel):
+    """Schema for list of evidence records."""
+
+    evidence: list[EvidenceResponse]
+    total: int

package/app/backend/app/schemas/goal.py

@@ -0,0 +1,90 @@
+"""Pydantic schemas for Goal entity."""
+
+from datetime import datetime
+
+from pydantic import BaseModel, Field
+
+
+class AutonomySettings(BaseModel):
+    """Schema for autonomy settings on a goal."""
+
+    autonomy_enabled: bool = False
+    auto_approve_tickets: bool = False
+    auto_approve_revisions: bool = False
+    auto_merge: bool = False
+    auto_approve_followups: bool = False
+    max_auto_approvals: int | None = None
+
+
+class GoalCreate(BaseModel):
+    """Schema for creating a new goal."""
+
+    title: str = Field(..., min_length=1, max_length=255)
+    description: str | None = None
+    board_id: str | None = Field(
+        None,
+        description="Board ID to scope this goal to (recommended for multi-board setups)",
+    )
+    # Autonomy fields (optional at creation)
+    autonomy_enabled: bool = False
+    auto_approve_tickets: bool = False
+    auto_approve_revisions: bool = False
+    auto_merge: bool = False
+    auto_approve_followups: bool = False
+    max_auto_approvals: int | None = None
+
+
+class GoalUpdate(BaseModel):
+    """Schema for updating a goal."""
+
+    title: str | None = Field(None, min_length=1, max_length=255)
+    description: str | None = None
+    autonomy_enabled: bool | None = None
+    auto_approve_tickets: bool | None = None
+    auto_approve_revisions: bool | None = None
+    auto_merge: bool | None = None
+    auto_approve_followups: bool | None = None
+    max_auto_approvals: int | None = None
+
+
+class GoalResponse(BaseModel):
+    """Schema for goal response."""
+
+    id: str
+    board_id: str | None = None
+    title: str
+    description: str | None
+    created_at: datetime
+    updated_at: datetime
+    # Autonomy fields
+    autonomy_enabled: bool = False
+    auto_approve_tickets: bool = False
+    auto_approve_revisions: bool = False
+    auto_merge: bool = False
+    auto_approve_followups: bool = False
+    max_auto_approvals: int | None = None
+    auto_approval_count: int = 0
+
+    model_config = {"from_attributes": True}
+
+
+class GoalListResponse(BaseModel):
+    """Schema for list of goals response."""
+
+    goals: list[GoalResponse]
+    total: int
+
+
+class AutonomyStatusResponse(BaseModel):
+    """Schema for autonomy status response."""
+
+    goal_id: str
+    autonomy_enabled: bool
+    auto_approve_tickets: bool
+    auto_approve_revisions: bool
+    auto_merge: bool
+    auto_approve_followups: bool
+    max_auto_approvals: int | None
+    auto_approval_count: int
+    budget_remaining: float | None = None
+    safety_checks: list[dict] = Field(default_factory=list)

package/app/backend/app/schemas/job.py

@@ -0,0 +1,97 @@
+"""Pydantic schemas for Job entity."""
+
+from datetime import datetime
+from enum import StrEnum
+
+from pydantic import BaseModel, Field
+
+
+class JobKind(StrEnum):
+    """Enum representing the kind of job."""
+
+    EXECUTE = "execute"
+    VERIFY = "verify"
+    RESUME = "resume"
+
+
+class JobStatus(StrEnum):
+    """Enum representing the status of a job."""
+
+    QUEUED = "queued"
+    RUNNING = "running"
+    SUCCEEDED = "succeeded"
+    FAILED = "failed"
+    CANCELED = "canceled"
+
+
+class JobResponse(BaseModel):
+    """Schema for job response."""
+
+    id: str
+    ticket_id: str
+    kind: JobKind
+    status: JobStatus
+    created_at: datetime
+    started_at: datetime | None = None
+    finished_at: datetime | None = None
+    exit_code: int | None = None
+    log_path: str | None = None
+
+    model_config = {"from_attributes": True}
+
+
+class JobDetailResponse(JobResponse):
+    """Schema for detailed job response including logs."""
+
+    logs: str | None = Field(None, description="Job log content")
+
+
+class JobListResponse(BaseModel):
+    """Schema for list of jobs response."""
+
+    jobs: list[JobResponse]
+    total: int
+
+
+class JobCreateResponse(JobResponse):
+    """Schema for job creation response."""
+
+    celery_task_id: str | None = None
+
+
+class CancelJobResponse(BaseModel):
+    """Schema for job cancellation response."""
+
+    id: str
+    status: JobStatus
+    message: str
+
+
+class QueuedJobResponse(BaseModel):
+    """Schema for a job in the queue with ticket info."""
+
+    id: str
+    ticket_id: str
+    ticket_title: str
+    kind: JobKind
+    status: JobStatus
+    created_at: datetime
+    started_at: datetime | None = None
+    queue_position: int | None = Field(
+        None, description="Position in queue (1-based, None if running)"
+    )
+
+    model_config = {"from_attributes": True}
+
+
+class QueueStatusResponse(BaseModel):
+    """Schema for queue status response."""
+
+    running: list[QueuedJobResponse] = Field(
+        default_factory=list, description="Currently running jobs"
+    )
+    queued: list[QueuedJobResponse] = Field(
+        default_factory=list, description="Jobs waiting in queue (ordered)"
+    )
+    total_running: int = 0
+    total_queued: int = 0

package/app/backend/app/schemas/merge.py

@@ -0,0 +1,139 @@
+"""Pydantic schemas for merge operations."""
+
+from enum import StrEnum
+
+from pydantic import BaseModel, Field
+
+
+class MergeStrategy(StrEnum):
+    """Supported merge strategies."""
+
+    MERGE = "merge"
+    REBASE = "rebase"
+
+
+class MergeRequest(BaseModel):
+    """Request body for merging a ticket's changes."""
+
+    strategy: MergeStrategy = MergeStrategy.MERGE
+    delete_worktree: bool = Field(
+        default=True,
+        description="Delete the worktree after successful merge",
+    )
+    cleanup_artifacts: bool = Field(
+        default=True,
+        description="Clean up evidence files after successful merge",
+    )
+
+
+class MergeResponse(BaseModel):
+    """Response from a merge operation."""
+
+    success: bool
+    message: str
+    exit_code: int
+    evidence_id: str | None = None
+    pull_warning: str | None = Field(
+        default=None,
+        description="Warning if merge succeeded without pulling latest (local-only merge)",
+    )
+
+
+class MergeStatusResponse(BaseModel):
+    """Response for merge status query."""
+
+    ticket_id: str
+    can_merge: bool = Field(
+        description="Whether the ticket can be merged (done state, approved revision, active worktree)"
+    )
+    is_merged: bool = Field(
+        description="Whether the ticket has been successfully merged"
+    )
+    has_approved_revision: bool
+    workspace: dict | None = Field(
+        description="Workspace info with worktree_path and branch_name"
+    )
+    last_merge_attempt: dict | None = Field(
+        description="Info about the last merge attempt event"
+    )
+
+
+class ConflictStatusResponse(BaseModel):
+    """Response for conflict status query."""
+
+    has_conflict: bool
+    operation: str | None = Field(
+        description="Type of conflict operation: rebase, merge, cherry_pick, revert"
+    )
+    conflicted_files: list[str] = Field(default_factory=list)
+    can_continue: bool = False
+    can_abort: bool = False
+    divergence: dict | None = Field(
+        default=None,
+        description="Branch divergence info (ahead/behind counts)",
+    )
+
+
+class RebaseResponse(BaseModel):
+    """Response from a rebase operation."""
+
+    success: bool
+    message: str
+    has_conflicts: bool = False
+    conflicted_files: list[str] = Field(default_factory=list)
+
+
+class AbortResponse(BaseModel):
+    """Response from an abort operation."""
+
+    success: bool
+    message: str
+
+
+class PushResponse(BaseModel):
+    """Response from a push operation."""
+
+    success: bool
+    message: str
+
+
+class PushStatusResponse(BaseModel):
+    """Response for push status query."""
+
+    ahead: int = 0
+    behind: int = 0
+    remote_exists: bool = False
+    needs_push: bool = False
+
+
+class CleanupRequest(BaseModel):
+    """Request body for maintenance cleanup."""
+
+    dry_run: bool = Field(
+        default=True,
+        description="If true, only report what would be deleted without actually deleting",
+    )
+    delete_worktrees: bool = Field(
+        default=True,
+        description="Delete stale and orphaned worktrees",
+    )
+    delete_evidence: bool = Field(
+        default=True,
+        description="Delete old evidence files",
+    )
+
+
+class CleanupResponse(BaseModel):
+    """Response from a cleanup operation."""
+
+    dry_run: bool
+    worktrees_deleted: int
+    worktrees_failed: int
+    worktrees_skipped: int = Field(
+        default=0,
+        description="Worktrees skipped due to ticket state (executing/verifying/needs_human)",
+    )
+    evidence_files_deleted: int
+    evidence_files_failed: int
+    bytes_freed: int
+    details: list[str]