feat: experimental API

[jolovicdev]

Summary of Changes

Added

• FastAPI-based REST API for the blackgeorge framework
• Worker management endpoints (create, list, get, delete)
• Workforce management endpoints (create, list, get, delete)
• Job execution endpoints for workers and workforces
• Run status and resume endpoints
• Event tracking endpoints
• Health check endpoint
• Pydantic request/response models
• Structured JSON logging middleware
• Custom exception classes with proper HTTP status codes
• OpenAPI/Swagger auto-documentation at /docs
• 32 API tests with full coverage

Changed

• Added list_runs() method to RunStore base class and implementations
• Added httpx to dev dependencies for test client support
• Configured ruff to ignore B008 for API routes (standard FastAPI pattern)

Documentation

• Added docs/api.md with API usage examples

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 908ee1aa38

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".