codeframe-ai 0.9.0__py3-none-any.whl

codeframe/ui/routers/events_v2.py

@@ -0,0 +1,75 @@
+"""Events API router for CodeFRAME v2.
+
+Provides endpoints for fetching workspace activity/event history.
+Delegates to codeframe.core.events module.
+
+TODO(#336): Add authentication to this router. All v2 routers are
+missing auth enforcement despite documentation stating it's required.
+"""
+
+from typing import Optional
+
+from fastapi import APIRouter, Depends, Query, Request
+from pydantic import BaseModel
+
+from codeframe.core.workspace import Workspace
+from codeframe.core import events
+from codeframe.lib.rate_limiter import rate_limit_standard
+from codeframe.ui.dependencies import get_v2_workspace
+
+router = APIRouter(prefix="/api/v2/events", tags=["events"])
+
+
+class EventResponse(BaseModel):
+    """Response model for a single event."""
+
+    id: int
+    workspace_id: str
+    event_type: str
+    payload: dict
+    created_at: str  # ISO format
+
+
+class EventListResponse(BaseModel):
+    """Response model for event list."""
+
+    events: list[EventResponse]
+    total: int
+
+
+@router.get("", response_model=EventListResponse)
+@rate_limit_standard()
+async def list_events(
+    request: Request,  # Required for rate limiting
+    workspace: Workspace = Depends(get_v2_workspace),
+    limit: int = Query(20, ge=1, le=100, description="Maximum events to return"),
+    since_id: Optional[int] = Query(None, description="Only return events after this ID"),
+):
+    """List recent events for a workspace.
+
+    Returns events in reverse chronological order (newest first).
+
+    Args:
+        request: HTTP request for rate limiting
+        workspace: Resolved workspace from workspace_path query param
+        limit: Maximum number of events (1-100, default 20)
+        since_id: Optional event ID for pagination
+
+    Returns:
+        List of events with total count
+    """
+    event_list = events.list_recent(workspace, limit=limit, since_id=since_id)
+
+    return EventListResponse(
+        events=[
+            EventResponse(
+                id=e.id,
+                workspace_id=e.workspace_id,
+                event_type=e.event_type,
+                payload=e.payload,
+                created_at=e.created_at.isoformat(),
+            )
+            for e in event_list
+        ],
+        total=len(event_list),
+    )

codeframe/ui/routers/gates_v2.py

@@ -0,0 +1,166 @@
+"""V2 Gates router - delegates to core/gates module.
+
+This module provides v2-style API endpoints for verification gates.
+Gates are automated checks (tests, lint) that run before code is considered complete.
+
+Routes:
+    POST /api/v2/gates/run  - Run verification gates
+    GET  /api/v2/gates      - List available gates
+"""
+
+import logging
+from typing import Optional
+
+from fastapi import APIRouter, Depends, HTTPException, Request
+from pydantic import BaseModel, Field
+
+from codeframe.core.workspace import Workspace
+from codeframe.lib.rate_limiter import rate_limit_standard
+from codeframe.core import gates
+from codeframe.core.gates import GateResult, GateCheck
+from codeframe.ui.dependencies import get_v2_workspace
+from codeframe.ui.response_models import api_error, ErrorCodes
+
+logger = logging.getLogger(__name__)
+
+router = APIRouter(prefix="/api/v2/gates", tags=["gates-v2"])
+
+
+# ============================================================================
+# Request/Response Models
+# ============================================================================
+
+
+class GateCheckResponse(BaseModel):
+    """Response for a single gate check."""
+
+    name: str
+    status: str  # GateStatus value
+    exit_code: Optional[int]
+    output: str
+    duration_ms: int
+
+
+class GateResultResponse(BaseModel):
+    """Response for gate run results."""
+
+    passed: bool
+    checks: list[GateCheckResponse]
+    summary: str
+    started_at: Optional[str]
+    completed_at: Optional[str]
+
+
+class RunGatesRequest(BaseModel):
+    """Request for running gates."""
+
+    gates: Optional[list[str]] = Field(None, description="Specific gates to run (None = all)")
+    verbose: bool = Field(False, description="Include verbose output")
+
+
+# ============================================================================
+# Helper Functions
+# ============================================================================
+
+
+def _check_to_response(check: GateCheck) -> GateCheckResponse:
+    """Convert a GateCheck to a GateCheckResponse."""
+    return GateCheckResponse(
+        name=check.name,
+        status=check.status.value,
+        exit_code=check.exit_code,
+        output=check.output,
+        duration_ms=check.duration_ms,
+    )
+
+
+def _result_to_response(result: GateResult) -> GateResultResponse:
+    """Convert a GateResult to a GateResultResponse."""
+    return GateResultResponse(
+        passed=result.passed,
+        checks=[_check_to_response(c) for c in result.checks],
+        summary=result.summary,
+        started_at=result.started_at.isoformat() if result.started_at else None,
+        completed_at=result.completed_at.isoformat() if result.completed_at else None,
+    )
+
+
+# ============================================================================
+# Endpoints
+# ============================================================================
+
+
+@router.post("/run", response_model=GateResultResponse)
+@rate_limit_standard()
+async def run_gates(
+    request: Request,
+    body: RunGatesRequest = None,
+    workspace: Workspace = Depends(get_v2_workspace),
+) -> GateResultResponse:
+    """Run verification gates.
+
+    Runs automated checks (tests, lint) on the workspace code.
+
+    Args:
+        request: HTTP request for rate limiting
+        body: Gate run options
+        workspace: v2 Workspace
+
+    Returns:
+        Gate results with pass/fail status for each check
+    """
+    gate_list = body.gates if body else None
+    verbose = body.verbose if body else False
+
+    try:
+        result = gates.run(workspace, gates=gate_list, verbose=verbose)
+        return _result_to_response(result)
+
+    except Exception as e:
+        logger.error(f"Failed to run gates: {e}", exc_info=True)
+        raise HTTPException(
+            status_code=500,
+            detail=api_error("Gate execution failed", ErrorCodes.EXECUTION_FAILED, str(e)),
+        )
+
+
+@router.get("", response_model=dict)
+@rate_limit_standard()
+async def list_gates(
+    request: Request,
+    workspace: Workspace = Depends(get_v2_workspace),
+) -> dict:
+    """List available verification gates.
+
+    Returns the gates that can be run on this workspace.
+
+    Args:
+        workspace: v2 Workspace
+
+    Returns:
+        List of available gates with descriptions
+    """
+    # Currently available gates
+    available_gates = [
+        {
+            "name": "pytest",
+            "description": "Run Python tests",
+            "command": "pytest",
+        },
+        {
+            "name": "ruff",
+            "description": "Run ruff linter",
+            "command": "ruff check",
+        },
+        {
+            "name": "ruff-fix",
+            "description": "Run ruff with auto-fix",
+            "command": "ruff check --fix",
+        },
+    ]
+
+    return {
+        "gates": available_gates,
+        "total": len(available_gates),
+        "message": "Use POST /api/v2/gates/run to execute gates",
+    }

codeframe/ui/routers/git_v2.py

@@ -0,0 +1,284 @@
+"""V2 Git router - delegates to core modules.
+
+This module provides v2-style API endpoints for git operations
+that delegate to core modules. It uses the v2 Workspace model.
+
+The v1 router (git.py) remains for backwards compatibility.
+"""
+
+import logging
+from typing import Optional
+
+from fastapi import APIRouter, Depends, HTTPException, Request
+from pydantic import BaseModel, Field
+
+from codeframe.core.workspace import Workspace
+from codeframe.lib.rate_limiter import rate_limit_standard
+from codeframe.core import git
+from codeframe.ui.dependencies import get_v2_workspace
+
+logger = logging.getLogger(__name__)
+
+router = APIRouter(prefix="/api/v2/git", tags=["git-v2"])
+
+
+# ============================================================================
+# Response Models
+# ============================================================================
+
+
+class GitStatusResponse(BaseModel):
+    """Response model for git status."""
+
+    current_branch: str
+    is_dirty: bool
+    modified_files: list[str]
+    untracked_files: list[str]
+    staged_files: list[str]
+
+
+class CommitInfoResponse(BaseModel):
+    """Response model for commit information."""
+
+    hash: str
+    short_hash: str
+    message: str
+    author: str
+    timestamp: str
+
+
+class CommitListResponse(BaseModel):
+    """Response model for commit listing."""
+
+    commits: list[CommitInfoResponse]
+
+
+class CommitRequest(BaseModel):
+    """Request model for creating a commit."""
+
+    files: list[str] = Field(..., min_length=1, description="Files to commit")
+    message: str = Field(..., min_length=1, description="Commit message")
+
+
+class CommitResultResponse(BaseModel):
+    """Response model for commit result."""
+
+    commit_hash: str
+    commit_message: str
+    files_changed: int
+
+
+class DiffResponse(BaseModel):
+    """Response model for git diff."""
+
+    diff: str
+    staged: bool
+
+
+# ============================================================================
+# Git Endpoints
+# ============================================================================
+
+
+@router.get("/status", response_model=GitStatusResponse)
+@rate_limit_standard()
+async def get_git_status(
+    request: Request,
+    workspace: Workspace = Depends(get_v2_workspace),
+) -> GitStatusResponse:
+    """Get git working tree status.
+
+    Returns current branch, dirty state, and file lists.
+
+    Args:
+        workspace: v2 Workspace
+
+    Returns:
+        GitStatusResponse with status information
+    """
+    try:
+        status = git.get_status(workspace)
+
+        return GitStatusResponse(
+            current_branch=status.current_branch,
+            is_dirty=status.is_dirty,
+            modified_files=status.modified_files,
+            untracked_files=status.untracked_files,
+            staged_files=status.staged_files,
+        )
+
+    except ValueError as e:
+        logger.error(f"Git status failed: {e}")
+        raise HTTPException(status_code=400, detail=str(e))
+    except Exception as e:
+        logger.error(f"Failed to get git status: {e}", exc_info=True)
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/commits", response_model=CommitListResponse)
+@rate_limit_standard()
+async def list_commits(
+    request: Request,
+    branch: Optional[str] = None,
+    limit: int = 50,
+    workspace: Workspace = Depends(get_v2_workspace),
+) -> CommitListResponse:
+    """List git commits.
+
+    Args:
+        branch: Optional branch name (default: current branch)
+        limit: Maximum commits to return (default: 50)
+        workspace: v2 Workspace
+
+    Returns:
+        CommitListResponse with commit list
+    """
+    if limit < 1 or limit > 100:
+        raise HTTPException(status_code=400, detail="Limit must be between 1 and 100")
+
+    try:
+        commits = git.list_commits(workspace, branch=branch, limit=limit)
+
+        return CommitListResponse(
+            commits=[
+                CommitInfoResponse(
+                    hash=c.hash,
+                    short_hash=c.short_hash,
+                    message=c.message,
+                    author=c.author,
+                    timestamp=c.timestamp,
+                )
+                for c in commits
+            ]
+        )
+
+    except ValueError as e:
+        logger.error(f"List commits failed: {e}")
+        raise HTTPException(status_code=400, detail=str(e))
+    except Exception as e:
+        logger.error(f"Failed to list commits: {e}", exc_info=True)
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.post("/commit", response_model=CommitResultResponse, status_code=201)
+@rate_limit_standard()
+async def create_commit(
+    request: Request,
+    body: CommitRequest,
+    workspace: Workspace = Depends(get_v2_workspace),
+) -> CommitResultResponse:
+    """Create a git commit.
+
+    Stages the specified files and creates a commit.
+
+    Args:
+        request: HTTP request for rate limiting
+        body: CommitRequest with files and message
+        workspace: v2 Workspace
+
+    Returns:
+        CommitResultResponse with commit details
+    """
+    try:
+        result = git.create_commit(
+            workspace,
+            files=body.files,
+            message=body.message,
+        )
+
+        return CommitResultResponse(
+            commit_hash=result.commit_hash,
+            commit_message=result.commit_message,
+            files_changed=result.files_changed,
+        )
+
+    except ValueError as e:
+        logger.error(f"Create commit failed: {e}")
+        raise HTTPException(status_code=400, detail=str(e))
+    except Exception as e:
+        logger.error(f"Failed to create commit: {e}", exc_info=True)
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/diff", response_model=DiffResponse)
+@rate_limit_standard()
+async def get_diff(
+    request: Request,
+    staged: bool = False,
+    workspace: Workspace = Depends(get_v2_workspace),
+) -> DiffResponse:
+    """Get git diff.
+
+    Args:
+        staged: If True, show staged changes; if False, show unstaged
+        workspace: v2 Workspace
+
+    Returns:
+        DiffResponse with diff content
+    """
+    try:
+        diff_content = git.get_diff(workspace, staged=staged)
+
+        return DiffResponse(
+            diff=diff_content,
+            staged=staged,
+        )
+
+    except ValueError as e:
+        logger.error(f"Get diff failed: {e}")
+        raise HTTPException(status_code=400, detail=str(e))
+    except Exception as e:
+        logger.error(f"Failed to get diff: {e}", exc_info=True)
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/branch")
+@rate_limit_standard()
+async def get_current_branch(
+    request: Request,
+    workspace: Workspace = Depends(get_v2_workspace),
+) -> dict:
+    """Get current branch name.
+
+    Args:
+        workspace: v2 Workspace
+
+    Returns:
+        Dict with branch name
+    """
+    try:
+        branch = git.get_current_branch(workspace)
+        return {"branch": branch}
+
+    except ValueError as e:
+        logger.error(f"Get branch failed: {e}")
+        raise HTTPException(status_code=400, detail=str(e))
+    except Exception as e:
+        logger.error(f"Failed to get current branch: {e}", exc_info=True)
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@router.get("/clean")
+@rate_limit_standard()
+async def check_clean(
+    request: Request,
+    workspace: Workspace = Depends(get_v2_workspace),
+) -> dict:
+    """Check if working tree is clean.
+
+    Args:
+        workspace: v2 Workspace
+
+    Returns:
+        Dict with is_clean boolean
+    """
+    try:
+        is_clean = git.is_clean(workspace)
+        return {"is_clean": is_clean}
+
+    except ValueError as e:
+        logger.error(f"Check clean failed: {e}")
+        raise HTTPException(status_code=400, detail=str(e))
+    except Exception as e:
+        logger.error(f"Failed to check if clean: {e}", exc_info=True)
+        raise HTTPException(status_code=500, detail=str(e))