Changelog

Operational note: For API-level deltas, regenerate or diff Download OpenAPI JSON between tags. This page summarizes user-visible platform and documentation motions.

Unreleased / Next

Documentation tracks upcoming capabilities (for example deterministic replay) separately from GA behavior.

• API documentation parity: every app/api/.../route.ts module now has a co-located schema.ts; npm run audit:api enforces this in CI. New OpenAPI coverage includes GET /api/runs/{id}/logs, GET /api/system/status, GET /api/system/entitlements, GET /api/workflow-echo, /api/secrets, and integration /test routes that were not previously aggregated. Shared Zod helpers live under lib/schemas/; see Repository map. OTLP-only tracing is documented in OTLP tracing (export-only); API versioning explains the apiVersion label vs URL prefixes.
• Cross-linked the official Python SDK repository https://github.com/no1rstack/cascades-sdk from landing copy, docs index, OpenAPI overview, API quickstart, and authentication & access pages (alongside existing PyPI and /docs/sdks links).

Documentation — 2026-04

• Added Architecture end-to-end map (UI → API → workers → proofs → anchoring → storage).
• Expanded core concepts with executable + verification diagrams.
• Deepened workflow builder operational guidance + samples.
• New examples for incident, compliance, AI, and multi-agent patterns.
• New replay roadmap (labeled Coming soon).
• New access control, troubleshooting, and integrations + verification exemplar payloads.

How to propose entries

Maintain one bullet per noteworthy behavior, migration, deprecation. Link fixed issues or advisories inline when public.