# Changelog and versioning

> Versioning policy for the Haszno API and a dated list of changes to the public developer preview.

## Versioning policy

The Haszno API is an **unversioned developer preview**. No version prefix exists in any path today (there is no `/v1/` or similar segment).

> [!WARNING]
> Breaking changes may occur without prior notice during the developer preview. Do not build production integrations against this API without coordinating with the Haszno team.

### When a stable version is introduced

The following contract will apply when the API moves to general availability. It is not in effect today.

- A stable version prefix (`/v1/`) will be introduced.
- A **6-month deprecation window** will be honoured before removing any endpoint or response field.
- Breaking changes will be announced in this changelog and via email to registered developers.

### What counts as a breaking change

Once a stable version exists, the following are breaking changes:

- Removing an endpoint or an HTTP method.
- Removing a response field that was previously always present.
- Changing the type of a response field (e.g. string to integer).
- Changing a required request parameter to have a different type or narrower valid range.
- Changing the meaning of an HTTP status code on a given endpoint.

The following are **not** breaking and may happen without notice:

- Adding new optional response fields.
- Adding new optional request parameters.
- Adding new endpoints.
- Relaxing validation (accepting values that previously returned `400`).

## Changelog

Changes listed below are sourced from the repository commit history (read-only `git log` of the `docs` and `web/public/docs` paths). The API is in active development; this list is not exhaustive.

### 2026-11-12

- **docs redesign** (`#86`) — `docs.haszno.com` rebuilt with a reading-first three-column layout, full-text search dialog, and updated navigation structure.
- **support hub** (`#81`) — `support.haszno.com` and in-API support chat (`POST /api/support/conversations`) launched.
- **security hardening** (`#39`) — per-path rate limiting, security headers (HSTS, CSP, X-Frame-Options), Vercel Cron guards, CI pipeline, legal pages, and SEO metadata applied.

### 2026-11-10

- **English documentation** (`#49`) — full EN translation of all docs pages with HU/EN language toggle and IP-based language default.
- **Public demo API** — read-only public GET endpoints serving synthetic data activated on `https://haszno.com`. Endpoints: `/api/categories`, `/api/products`, `/api/suppliers`, `/api/stats`, `/api/settings`, `/api/impact`, `/api/orders`, `/api/proposals`, `/api/peers/invites`, `/api/peers/links`, `/api/import-list`.
- **MCP / CLI / skill** — working install and health check (`haszno_ping`, `GET /api/health`) published for `haszno-mcp`, `haszno-cli`, and `haszno-skill`.

### 2026-11-08

- **Rename Árfutár → Haszno** (`#15`) — product and domain renamed. `ARFUTAR_API_KEY` and `ARFUTAR_API_URL` remain as silent legacy fallbacks in the CLI and MCP server config resolution.
- **Agent SDK** (`#10`) — MCP server (`haszno-labs/haszno-mcp`), CLI (`haszno-labs/haszno-cli`), and skill (`haszno-labs/haszno-skill`) first published.
- **Wave 2 features** (`#8`) — order routing, group buys, partner scoring, network insights, connections, fulfilment, invoicing, launcher, onboarding, and backend security hardening added.