> ## Documentation Index
> Fetch the complete documentation index at: https://fastql.vachagan.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Project status

> Current FastQL capabilities, boundaries, and maturity.

FastQL is an early-stage framework with a working Python schema API, GraphQL
language pipeline, validation layer, async executor, introspection, SDL printer,
and local development server.

## Implemented

Core engine and authoring:

* Object, input, interface, enum, union, and custom scalar definitions
* Query, mutation, and subscription roots with full execution
* Python annotation and explicit `Field` declaration styles
* Arguments, defaults, descriptions, deprecations, and directives
* Parsing, validation, variable coercion, field collection, and async execution
* Context injection, dependency providers, field extensions, and permissions
* Introspection, SDL output, CLI serving, and a browser playground
* [Generic types](/build/generic-types) and configurable error masking

Data, performance, and observability:

* [DataLoader](/data/dataloader) batching and caching
* [Schema extensions](/data/schema-extensions) (lifecycle hooks + resolver wrapping)
* [Apollo tracing and OpenTelemetry](/operations/observability) instrumentation

Protocol and ecosystem:

* [Streaming subscriptions](/protocol/subscriptions) over `graphql-transport-ws`,
  SSE, and `multipart/mixed`
* [Incremental delivery](/protocol/incremental-delivery) with `@defer` / `@stream`
* [Relay pagination](/data/relay-pagination) and [Apollo Federation v2](/federation/overview)
* [Custom directives, field visibility, and enum customization](/build/directives-and-visibility)
* [File uploads and query batching](/protocol/uploads-and-batching)
* [Pydantic integration](/integrations/pydantic) and a [test client + schema-export CLI](/operations/testing-and-export)
* ASGI, Starlette, FastAPI, Flask, Django, plus
  [AIOHTTP, Sanic, Litestar, Quart, and Django Channels](/integrations/additional-frameworks) adapters

## Current boundaries

* The bundled development HTTP server is for local use only. It does not provide
  TLS, authentication, connection reuse, production hardening, or a streaming
  subscription transport — run subscriptions and federation through a production
  [framework adapter](/integrations/overview) instead.
* Schema stitching and persisted operations are outside the current capability set.
* Compatibility should be evaluated against the repository's tests and
  [canonical specifications](/specifications/capability-catalog), not inferred from
  another framework's API.

## Planned

The following documentation topics are deferred until their underlying feature or
policy exists. They are tracked here so readers can distinguish what is missing
documentation from what is a missing capability.

* **Schema / query codegen** — Generate TypeScript or Python client types from a
  FastQL schema. Blocked on agreeing a codegen strategy.
* **Editor integration / mypy guidance** — Typed stub generation, plugin for
  `mypy` or `pyright`, IDE support. Blocked on completing the public type surface.
* **Upgrading & breaking-changes** — Migration guides between major versions.
  Deferred until a versioning and stability policy exists post-1.0.
* **Dedicated field-extensions page** — A standalone guide to `FieldExtension`
  (currently documented alongside permissions). Planned once the API stabilises.
* **Federation entity interfaces** — `@interfaceObject` and entity interface
  patterns. Planned when support is implemented.

<Warning>
  Do not expose the development server directly to untrusted networks.
</Warning>