docs(swagger): #95 — move annotation examples to §3.7, add val-bound route example

[michael-conrad]

Summary

Move annotation examples from §11 into §3 (Annotation Rules), add a fourth example for the val-bound route pattern from ApiRepositoryStatusControllerBase.scala, and update §3.1 and §4 to distinguish the permitted route-level val binding from the prohibited operation(op) extraction pattern.

Outcome

• ✅ SC-1: §11 deleted from doc/swagger/swagger.md
• ✅ SC-2: §3.7 exists with four subsections (3.7.1, 3.7.2, 3.7.3, 3.7.4)
• ✅ SC-3: All three original before/after examples preserved
• ✅ SC-4: §3.7.4 contains listStatusesRoute and listStatusesRoute.action()
• ✅ SC-5: §3.7.4 references source file ApiRepositoryStatusControllerBase.scala
• ✅ SC-6: §3.7.4 after example has apiOperation on val declaration
• ✅ SC-7: §3.7.4 explains .action() inheritance
• ✅ SC-8: Route paths, authenticators, and parameter names verified against source
• ✅ SC-9: §3.1 updated with route-level val binding pattern and cross-reference to §3.7.4
• ✅ SC-10: §4 anti-pattern updated with operation(op) vs route-level val binding distinction

Fixes #95

🤖 Co-authored with AI: OpenCode (ollama-cloud/glm-5.1)