docs: describe admin Slack author filtering and options

Merged
SI
1mo ago
+990-20

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/slack now accepts an exact, case-sensitive tag (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-tags page: 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.py to freeze both operations' declarations, examples, and schemas, and documents the contributor workflow in AGENTS.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.