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.

Inizia da docs/design/API_CONTRACT.md, docs/guides/DEVELOPER_GUIDE.md e dai tipi in cdk/src/handlers/shared/types.ts e cli/src/types.ts; esamina gli handler REST e il controllo types-sync esistente. Il lavoro è completato quando sono disponibili artefatti OpenAPI e JSON Schema pubblicati, un indice dei punti di estensione, link stabili all’architettura e un controllo del drift in CI, e il riferimento API di Starlight è stato aggiornato dopo mise //docs:sync.

Scritto dal modello di indicizzazione a partire dal testo della issue.