feat: add archived status and update form listing documentation

Author: dytsou

src/forms/models.tsp

@@ -140,10 +140,13 @@ namespace CoreSystem.Forms {
 		submitted: "SUBMITTED",
 	}
 
-	@doc("The current status of form ")
+	@doc("The current status of a form.")
 	enum FormStatus {
 		draft: "DRAFT",
 		published: "PUBLISHED",
+
+		@doc("Archived: form is hidden from default listings but is still stored and can be accessed directly.")
+		archived: "ARCHIVED",
 	}
 
 	@doc("The visibility setting of a form. Public forms are visible to all logged-in users. Private forms require a direct link to access.")

src/forms/operations.tsp

@@ -23,7 +23,7 @@ namespace CoreSystem.Forms {
 	op getFormById(@path id: uuid): Form;
 
 	@summary("List Forms")
-	@doc("List all existing forms.")
+	@doc("List all existing forms. Archived forms are excluded by default.")
 	@route("/forms")
 	@get
 	op listForms(): Form[];
@@ -89,6 +89,15 @@ namespace CoreSystem.Forms {
 		@body response: FormPublishResponse;
 	};
 
+	@summary("Archive Form")
+	@doc("Archive a form. Set status to 'ARCHIVED'. Archived forms are hidden from default lists but can still be accessed directly by ID.")
+	@route("/forms/{id}/archive")
+	@post
+	op archiveForm(@path id: uuid): {
+		@statusCode statusCode: 200;
+		@body response: Form;
+	};
+
 	@summary("Get Google Sheet Email")
 	@doc("Get the Gmail address that should be added to Google Sheet permissions. This address needs to be granted access to the Google Sheet so the system can modify the form.")
 	@route("/forms/google-sheet-email")