# AgentFlight — Extended Website & Technical Knowledge Pack (`v1.5.0`)

> Live Website: https://codesphere-u.github.io/agentflight/
> Dedicated Pages: `/studio.html`, `/proof.html`, `/docs.html`, `/rules.html`
> Source Repository: https://github.com/codesphere-u/agentflight
> Author & Owner: Akandwanaho Ivan Alvin (`https://alvin.codesphereug.com/`)
> License: MIT

## Core Capabilities

1. **Tamper-Evident Black-Box Flight Recorder (`FlightRecorder`)**:
   - Captures every LLM turn, streamed chunk, MCP JSON-RPC call, and local Python tool execution into a canonical-JSON SHA-256 hash chain (`.flight.json` or `.flight.jsonl`).
   - Scrubs OpenAI, Anthropic, GitHub, AWS, Bearer, and JWT secrets automatically before hashing (`redact_secrets=True` by default).
   - Writes files atomically via temporary staging + `fsync` + `os.replace()`.
2. **Microsecond Deterministic Replay (`CassetteReplayer` & `pytest11`)**:
   - Replays multi-step agent trajectories offline at `0.08–2.83 us/span` (`353,356 spans/sec`) with `$0.00` token cost.
   - Auto-registered pytest plugin provides `flight_recorder`, `flight_guard`, `flight_session`, `@pytest.mark.flight_cassette`, and `--flight-mode={auto,record,replay}`.
   - Raises `TrajectoryDivergenceError` with exact key-level diff diagnostics when inputs drift.
3. **Real-Time Loop & Cost Circuit Breaker (`TrajectoryCircuitBreaker`)**:
   - Trips pre-execution on identical call repeats (`CB001`), ping-pong `A->B->A->B` oscillation (`CB002`), error storms (`CB003`), USD budget ceilings (`CB004`), and token limits (`CB005`).
4. **10-Rule MCP Tool-Smell Linter & Auto-Fix (`ToolSmellLinter`, `ToolSchemaOptimizer`)**:
   - Audits MCP tool definitions across `TS001`–`TS010` at `1,676 tools/sec` and repairs flaky schemas via `agentflight fix`.
5. **Post-Mortems & OpenTelemetry Export**:
   - Generates AAIB/NTSB Markdown/JSON incident reports (`agentflight post-mortem`) and W3C TraceContext spans (`agentflight export-otel`).
6. **Hosted & Local MCP Server**:
   - `agentflight serve-mcp` over stdio, plus hosted Streamable HTTP at `https://agentflight-tau.vercel.app/mcp`.