Roadmap

Strategy: go deep, not wide. Logging, security, auth, and APM stay out of scope — doctreen's moat is making the route registry the single source of truth. Everything below extends that registry into adjacent capabilities, in each of the three packages. Feature depth lands in Node first; the Python and PHP ports pick it up at the last shipped behavior, held to parity by the shared conformance suite.

Node.js — `doctreen` on npm

Shipped

✅ Runtime validation middleware v1.6 — Zod schemas validate incoming requests; 422 on mismatch.
✅ OpenAPI 3.1 export v1.7 — same schema bag drives Scalar, Redoc, and Swagger UI via GET /docs/openapi.json.
✅ Security + hidden routes v1.8 — declare auth schemes once, attach to operations automatically; Authorization header auto-stripped; routes can opt out of docs entirely.
✅ headHtml config v1.9 — inject analytics scripts, custom CSS, favicons, or OG metadata into the docs UI <head> without forking.
✅ Schema drift detection — production grade v1.10 — structured pipeline with per-route aggregates and hourly buckets, opt-in sampling (default 1 %), onDrift callback + webhook dispatch, pluggable DriftStore interface, Drift tab in the UI, and npx doctreen drift report --fail-on-mismatch for CI.
✅ Drift reset endpoint, daily buckets, Redis store reference v1.10.1 — opt-in POST <docsPath>/drift/reset gated by drift.allowReset + optional resetToken, companion npx doctreen drift reset CLI, rolling 7-day dailyBuckets, and a complete Redis-backed DriftStore reference.
✅ OpenAPI polish v1.11 — $ref-based components.schemas dedup, first-class per-route + top-level tags, OpenAPI 3.1 callbacks and webhooks, multi-example bodies and responses, npx doctreen lint openapi.
✅ Mock server v1.12 — npx doctreen mock --from <url|file> spins up an Express-backed fake API in seconds. CRUD short-circuits, --latency, --error-rate, --persist, optional @faker-js/faker.
✅ Typed codegen v1.13 — npx doctreen codegen types emits strict TS declarations from components.schemas plus per-operation Params/Query/Body/Response shapes; npx doctreen codegen client emits a zero-dependency typed fetch client with createClient({ baseUrl, fetch?, headers?, onRequest? }). --watch for dev. Works with any OpenAPI 3.x doc.
✅ Schema builders v1.14 — s.enum / s.nullable / s.default / s.literal value-level facets, emitted everywhere (OpenAPI, docs UI, request examples).
✅ Validation completeness v1.15 — path-param schemas (request.params) with a structured 422, coerce/default write-back onto the request, dev-mode response assertions (validate: { response: 'warn' | 'throw' }), status-keyed responses (response: { 201: … }), config-level defaultErrors, a named DoctreenValidationError 422 envelope, defineSchema that works with Zod ($ref, no anonymous SchemaN), and offline getOpenApiDocument / doctreen emit-openapi.
✅ Status-aware response validation v1.16 — validate: { response } asserts each response against the schema declared for its actual status code, so error envelopes stop producing phantom success-schema warnings.

Next up

⏳ AI-native endpoints — /docs/llm.txt, /docs/agents.json, and npx doctreen mcp (Model Context Protocol server) so Claude and other agents discover your API as callable tools.
⏳ Contract testing & spec diff — npx doctreen verify --against <url> checks a deployed API against the spec; npx doctreen diff old.json new.json surfaces breaking changes with semver hints. GitHub Action included.
⏳ doctreen init CLI — detect the framework, inject adapter mount code, scaffold validation/OpenAPI config.

Python — `doctreen` on PyPI

Direct port of the Node behavior at its latest shipped state, held byte-identical on OpenAPI output by the shared conformance suite. Repo →

✅ Phase 0 — spec (SPEC.md), shared conformance fixtures, scaffold
✅ Phase 1 — schema builder, route registry, OpenAPI 3.1 export, Pydantic adapter, docs UI, Flask adapter
✅ Phase 2 — runtime validation (422), response assertion (status-aware from day one), schema drift + pluggable stores
✅ Phase 3 — FastAPI / Starlette adapter — drift over the app's own spec, mounted at /doctreen beside FastAPI's docs
✅ Phase 4 — Django / DRF adapter — URLconf introspection, serializer schemas, drift middleware
✅ Phase 5 — integration flows + a pytest plugin that runs them as tests (auto-registered on install), plus the doctreen-flow CLI
⏳ Phase 6 — mock server, Python client codegen (until then the npm CLI covers mock / codegen / lint / emit-openapi against any Python-served spec)

PHP — `doctreen/doctreen` on Packagist

Ports the full tooling surface, parity-tested against the npm exporter's output. Repo →

✅ Core — schema builder · route registry · ->doc() macro · docs UI · OpenAPI 3.1 export · request validation (422)
✅ Contract safety — status-aware response validation · default errors · schema drift detection
✅ Tooling — mock server · PHP codegen (typed DTOs + client) · flows
✅ Polish — lint openapi · emit-openapi · drift report / drift reset CLI
⏳ Beyond Laravel — Symfony and PSR-15 adapters

Long term

🔭 Go (chi / gin) adapters — once the Node story is fully baked.
🔭 DocTreen Cloud — hosted docs portal with versioning, custom domains, drift monitoring, and CI flow runs (private beta).

Have a feature request or use case we missed? Open an issue on the repo it concerns: Node · Python · PHP

Node.js — doctreen on npm

Shipped

Next up

Python — doctreen on PyPI

PHP — doctreen/doctreen on Packagist

Long term

On this page

Node.js — `doctreen` on npm

Python — `doctreen` on PyPI

PHP — `doctreen/doctreen` on Packagist