Docs: publish OpenAPI/JSON Schema and integration index

**Context:** ROADMAP.md → Exposed project specifications

---

## Doc area

Design / architecture (`docs/design/`)

## Describe the issue

ABCA lacks published **machine-readable API specs** and a single **integration/extension index**. Contributors and operators must reverse-engineer handlers and design docs to extend or fork the platform.

## Affected docs

- `docs/design/API_CONTRACT.md`
- `docs/guides/DEVELOPER_GUIDE.md`
- New: generated OpenAPI/JSON Schema artifact (location TBD, e.g. `docs/spec/` or release asset)
- Starlight site API reference page (after `mise //docs:sync`)

## Suggested change

1. Generate OpenAPI 3.x from REST handlers or maintain hand-authored spec with CI drift check.
2. Publish JSON Schema for key request/response types (sync with `cdk/src/handlers/shared/types.ts` / `cli/src/types.ts`).
3. Add **extension-point index**: webhooks, channels, workflows, Blueprint hooks, Cedar actions.
4. Stable permalinks from spec to architecture contracts listed at end of former ROADMAP.md.
5. CI gate: spec matches implementation (similar to types-sync check).

## Other information

- Complements **CDK constructs library** draft for external consumers.
- Does not replace narrative design docs.

Beginne mit docs/design/API_CONTRACT.md, docs/guides/DEVELOPER_GUIDE.md und den Typen in cdk/src/handlers/shared/types.ts und cli/src/types.ts; prüfe die REST-Handler und den vorhandenen types-sync-Check. Die Arbeit ist abgeschlossen, wenn veröffentlichte OpenAPI- und JSON-Schema-Artefakte, ein Index der Erweiterungspunkte, stabile Architektur-Links und ein CI-Drift-Check verfügbar sind und die Starlight-API-Referenz nach mise //docs:sync aktualisiert wurde.

Vom Indexierungsmodell aus dem Issue-Text verfasst.