Subject: Analytics endpoints are available (stubbed) — local run guide included

Hi team,

Analytics endpoints are now available and callable in the local environment.
For this hand-off, /analytics/{query, plan, act, feedback} are exposed in OpenAPI/Swagger.

• query works against the DB (simple read).
• plan/act/feedback currently return stub responses (header X-Stub: true, field "stub": true).
• The API contract is frozen for this sprint.

How to run locally

1. Start Ingress port-forward:

kubectl -n ingress-nginx port-forward svc/ingress-nginx-controller 8080:80

2. Open Swagger:

http://api.local:8080/docs

(If hosts not set: use curl -H 'Host: api.local' http://127.0.0.1:8080/openapi.json)

Smoke

# list analytics paths
curl -s -H 'Host: api.local' http://127.0.0.1:8080/openapi.json | jq -r '.paths | keys[]' | grep '^/analytics'

# simple query
curl -s -H 'Content-Type: application/json' \
     -H 'Host: api.local' \
     -d '{"sql":"select 1 as ok","limit":10}' \
     http://127.0.0.1:8080/analytics/query | jq .

We’ll replace stubs with full logic in a later update.
For now, please proceed with integration and UI wiring based on this contract.