v3: shared/ is documented like api/ — deno doc --lint over api/ and shared/ goes from 385 errors to none — every module of shared/ opens with a /** … @module */ block; every export and every field of an exported interface has JSDoc, each request body naming the endpoint that takes it and each response its endpoint; the // comments that described declarations (the mention pattern, the permission union and table, four socket messages, the error message's optimistic-action context) are /** */ now, and the socket protocol's heading comment, which sat on no declaration, is its module doc. The lint wanted explicit types on MENTION_RE and DUMP_MAX_FILE_SIZE_BYTES. Along the way: the chat edit is allowed to moderators too, which the new ChatEditMessage doc says; UpdateUserRequest says that PATCH /api/users/me takes only its description and email; playlist-service's reorderPlaylist @throws is rewrapped. mod.ts and the README no longer call shared/ undocumented. No behaviour changes; 205 backend tests pass.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

mod.ts

@@ -137,8 +137,7 @@
  *
  * The types and constants both halves use: the API envelope, each domain's
  * types and request bodies, the socket protocol, the validation limits and the
- * role permissions. It imports nothing from either half. Its modules aren't
- * documented yet.
+ * role permissions. It imports nothing from either half.
  *
  * Modules: [api](./shared/api.ts/index.html),
  * [category](./shared/category.ts/index.html),