ln-772-error-handler-setup

Type: L3 Worker Category: 7XX Project Bootstrap

Configures global error handling for .NET and Python backend applications.

Overview

Phase 1: Receive Context

Accept Context Store from coordinator.

Required Context:

• STACK

  : .NET or Python

• FRAMEWORK

  : ASP.NET Core or FastAPI

• PROJECT_ROOT

  : Project directory path

• ENVIRONMENT

  : Development or Production

Idempotency Check:

• .NET: Grep for

  GlobalExceptionMiddleware

  or

  UseExceptionHandler

• Python: Grep for

  @app.exception_handler

  or

  exception_handlers.py

• If found: Return

  { "status": "skipped" }

Phase 2: Research Error Handling Patterns

Use MCP tools to get up-to-date documentation.

For .NET:

MCP ref: "ASP.NET Core global exception handling middleware"
Context7: /dotnet/aspnetcore

For Python:

MCP ref: "FastAPI exception handlers custom exceptions"
Context7: /tiangolo/fastapi

Key Patterns to Research:

1. Middleware pipeline positioning
2. Exception type mapping to HTTP status codes
3. ProblemDetails (RFC 7807) format
4. Development vs Production error details
5. Logging integration

Phase 3: Decision Points

Q1: Error Response Format

Q2: Error Detail Level

Q3: Error Taxonomy

Define standard error codes:

VALIDATION_ERROR

UNAUTHORIZED

FORBIDDEN

NOT_FOUND

CONFLICT

INTERNAL_ERROR

Phase 4: Generate Configuration

.NET Output Files

Middleware/GlobalExceptionMiddleware.cs

Exceptions/AppException.cs

Exceptions/ValidationException.cs

Exceptions/NotFoundException.cs

Models/ErrorResponse.cs

Generation Process:

1. Use MCP ref to get current ASP.NET Core exception handling patterns
2. Generate GlobalExceptionMiddleware with:
   • Exception type to HTTP status mapping
   • Logging of exceptions
   • ProblemDetails response format
   • Environment-aware detail level
3. Generate custom exception classes

Registration Code:

app.UseMiddleware<GlobalExceptionMiddleware>();

Python Output Files

exceptions/app_exceptions.py

exceptions/handlers.py

models/error_response.py

Generation Process:

1. Use MCP ref to get current FastAPI exception handling patterns
2. Generate exception handlers with:
   • HTTPException handling
   • Custom AppException handling
   • Validation error handling
   • Request validation error handling
3. Generate custom exception classes

Registration Code:

app.add_exception_handler(AppException, app_exception_handler)
app.add_exception_handler(RequestValidationError, validation_exception_handler)

Phase 5: Validate

Validation Steps:

1. Syntax check:

   • .NET:

     dotnet build --no-restore

   • Python:

     python -m py_compile exceptions/handlers.py

2. Test error handling:

   • Create test endpoint that throws exception
   • Verify error response format
   • Check that stack trace hidden in Production

Expected Error Response (ProblemDetails):

{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "Validation Error",
  "status": 400,
  "detail": "Invalid input data",
  "instance": "/api/users",
  "errors": [
    { "field": "email", "message": "Invalid email format" }
  ],
  "traceId": "abc-123-def-456"
}

Return to Coordinator

{
  "status": "success",
  "files_created": [
    "Middleware/GlobalExceptionMiddleware.cs",
    "Exceptions/AppException.cs",
    "Models/ErrorResponse.cs"
  ],
  "packages_added": [],
  "registration_code": "app.UseMiddleware<GlobalExceptionMiddleware>();",
  "message": "Configured global exception handling"
}

Reference Links

• ASP.NET Core Error Handling
• FastAPI Handling Errors
• RFC 7807 Problem Details

Critical Rules

• Use ProblemDetails (RFC 7807) by default — standardized error response format
• Hide stack traces in Production — environment-aware detail level is mandatory
• Use MCP ref for current patterns — do not hardcode middleware from memory
• Idempotent — if

  GlobalExceptionMiddleware

  or

  exception_handlers.py

  exists, return

  status: "skipped"

• Map all custom exceptions to HTTP status codes — no unhandled exception types reaching the client

Definition of Done

• Context Store received (stack, framework, environment)
• Error handling patterns researched via MCP tools
• GlobalExceptionMiddleware generated (.NET) or exception handlers generated (Python)
• Custom exception classes created (AppException, ValidationException, NotFoundException)
• Error response model created (ProblemDetails format)
• Syntax validated (

  dotnet build

  or

  py_compile

  )
• Structured JSON response returned to ln-770 coordinator

Version: 2.0.0 Last Updated: 2026-01-10