Tooling: publish a versioned token manifest + JSON Schema

[jackgranatowski]

Type: author-time tooling · Tier: v1.0

Summary

Promote the internal docs/api-index.json to a versioned, published artifact with a companion JSON Schema, so any external tool (the WP plugin, the configurator, editors, linters) can consume the token/class catalogue against a stable contract.

Why

The plugin and configurator already depend on this index; formalizing it as a schema'd public artifact prevents silent drift and unlocks third-party tooling.

Verified state (2026-06-20)

docs/api-index.json and scripts/gen-api-index.js exist but are repo-internal and unversioned. No *.schema.json exists anywhere in the repo.

Constraints

No runtime cost — this is build/release tooling. Schema should version independently and be validated in CI.

Acceptance criteria

• Author a JSON Schema for the manifest shape
• Validate api-index.json against it in CI
• Publish the manifest as a release/CDN artifact with a version field
• Document the contract + stability policy