docs: describe admin Slack author filtering and options
An administrator can narrow Coding Agent Slack analytics to one author and request distinct author options, but the reference omits both. Document optional tag on GET /api/admins/coding/slack and add admin-only GET /api/admins/coding-agent/slack-tags with schemas, populated/empty examples and one navigation entry.
The filter trims a case-sensitive nonblank ID and computes totals after collection/filtering; omitted filtering preserves results and unknown IDs return zero. Options deduplicate IDs, retain the first collected profile and sort display names; avatar is required and nullable. Each authorized options request scans existing all-period data once. Preserve admin access, current channel/retention/history/thread/partial-failure limits and both401 envelopes/query400. This is not a complete all-time directory, free cached metadata or reduced collection work; no automatic caller/UI/poller/job/send/new scope is added.
Runtime API #1093 actual eb342015246823cd110af7935bcf4737f7f0f106 and fixture/test API #1094 actual 1d2109f1d313ea4cd02e6a294467823c6989c5d1 both match their accepted trees. The inventory pins actual API #1094, whose post-merge test/compatibility checks pass. Fixtures are byte-identical. The final delta from reviewed 6c09b24226383d2bbfea7c73ae8d77a0484d9ad7 changes only that API revision reference; contributor guidance and all other bytes are preserved.
API240 focused tests, producer28/site506 tests, docs generation/check, inventory/fixture/whitespace and normal production build before commit pass. Whole API TypeScript retains211 byte-identical baseline diagnostics, no new test diagnostics; it is not clean. Full-source and final-delta independent Spec/Standards reviews report zero current findings at ff4f85c6bfd240f487a202aadace134489e34bae, with the contributor-guidance finding resolved. CurrentCI, inventory, CodeRabbit and Vercel preview pass; no unresolved threads. The purpose-named producer and isolated-copy list freeze declarations/examples/resolved responses, with real GET/query/auth tests under mocked lookup/Slack leaves and network/database fences. FullAI239 bodies/214 operations preserve237 prior bodies and212 prior operation sections; only coding analytics changes and authors is added. Existing operation/MCP records and unrelated contracts remain exact, with matching derived page/nav/count changes. Prices, charges and runtime code are unchanged.
Ready for Records/coordinator acceptance and guarded merge. Based on actual Marketing #219 548ed38b9f72a5689ca63f7c9feb87c1744408f4. After actual Marketing merge, prepare the retained copy preserving verified Docs #400 actual 4549cc45a91560d77fb9995ea58f11f449a17c7d and host settings; new Slack publication is separate from accepted tool-count captures. Docs does not merge. No production admin access, Slack coverage/latency/quota, customer/provider/database/billing operation, installation or original-ticket closure is verified. API #1095 actual-main refresh/check/delta-review readiness remains with its runtime owner/coordinator.
Summary by cubic
Documents the optional tag filter for admin Coding Agent Slack mentions and adds the new admin-only author-options endpoint page, pinned to the released API contract source.
GET /api/admins/coding/slacknow accepts an exact, case-sensitivetag(Slack author ID) that filters collected mentions before totals are computed; blank values return 400 and unknown IDs return empty results with zero totals.- Adds the
GET /api/admins/coding-agent/slack-tagspage: it runs the existing all-period Slack collector, deduplicates by author ID, retains the first profile, and sorts by display name; avatar is nullable and an empty dataset returns an explicit empty list. - Adds
scripts/build_admin_coding_slack_contract.pyto freeze both operations' declarations, examples, and schemas, and documents the contributor workflow inAGENTS.md, including keeping the script in the isolated producer test helper list. - Updates the 401 schema to the actual authentication envelope and refreshes navigation, inventory, generated examples, and
llms-full.txt.