feat: add JSDoc documentation to userService routes

apps/api/src/routes/users.ts

@@ -1,15 +1,34 @@
-import { Router } from "express";
+import { Router, Request, Response } from "express";
 
 const router = Router();
 
-router.get("/", (_req, res) => {
+/**
+ * GET /users
+ *
+ * Retrieve a list of all users.
+ * Currently returns a stub response — implementation pending.
+ *
+ * @route GET /users
+ * @returns {Object} JSON response with an empty data array and status message.
+ */
+router.get("/", (_req: Request, res: Response) => {
   res.json({
     data: [],
     message: "User listing is not implemented yet."
   });
 });
 
-router.post("/", (req, res) => {
+/**
+ * POST /users
+ *
+ * Create a new user.
+ * Currently returns a stub response with a placeholder ID — implementation pending.
+ *
+ * @route POST /users
+ * @param {Request} req - Express request object containing user data in body.
+ * @returns {Object} JSON response with the created stub user data.
+ */
+router.post("/", (req: Request, res: Response) => {
   res.status(201).json({
     data: {
       id: "stub-user-id",

contributors/agents.json

@@ -1,5 +1,13 @@
 {
-  "agents": [],
-  "last_updated": "2026-06-03",
-  "total_contributions": 0
+  "agents": [
+    {
+      "name": "Hermes Agent (Aria)",
+      "model": "deepseek-v4-flash-free",
+      "provider": "opencode-zen",
+      "contributed_at": "2026-06-24",
+      "notes": "Added JSDoc to userService routes"
+    }
+  ],
+  "last_updated": "2026-06-24",
+  "total_contributions": 1
 }