feat!: echo the query and return the answer under a in batch results

[dragonee]

Summary

Batch-style results now echo their query and carry the answer under a, instead of the lean {"username": ...}:

{"u":"test@example.org","s":"jira","q":"slack","a":"U123456"}

This makes each result self-describing — clients can correlate by content, not only by position.

Changes

• POST /api/whose-name/query/batch — each item echoes u, s, q and the answer a:

  [{"u":"test@example.org","s":"jira","q":"slack","a":"U123456"},
   {"u":"unknown","s":"unknown","q":"unknown","a":null}]
  

• GET /api/whose-name/pool — same shape per member, with the pool mapping: u = member name, s = the pool's field, q = asked service, a = answer:

  ?p=Slackers&q=email →
  [{"u":"U123456","s":"slack","q":"email","a":"single@example.org"},
   {"u":"U234567","s":"slack","q":"email","a":["other@example.org","new@example.org"]}]
  

Status semantics are unchanged: 200 all resolved · 207 any null · 422 malformed body · 404 unknown pool.

Design

• Presentation only. The /pool route reads the pool (for its members/field) and zips it with PoolService::whatAreTheNamesOf, which still returns a plain list — so whoseNamesAreThere and the flattened /pool/names endpoint ({"names":[...]}) are unaffected.
• The single GET /query endpoint is intentionally left as {"username": ...}.

Docs

• README batch and pool examples updated.
• The 2026-07-06 batch ADL is marked superseded for its response shape (its status/validation decisions still hold); new ADL 2026-07-08-batch-query-echoes-input.md records the echo decision and /pool adopting the same shape.

Testing

Full suite passes via ./vendor/bin/sail test — 51 passed, 2 skipped (pre-existing filesystem-atime skips). Batch and pool endpoint tests updated to assert the {u,s,q,a} shape across 200/207/404 and the same-field shortcut.

⚠️ Breaking change

Batch (/query/batch) and pool (/pool) result items changed their key from username to a and gained u, s, q. Clients of those endpoints must migrate — notably whose-name-client (not touched here). The single /query endpoint is unchanged.

🤖 Generated with Claude Code