feat: Add three states to document submission and change the names to more align with intent vs business logic behaviour.

Author: stevenj

specs/signed_docs/docs/payload_schemas/proposal_submission_action.schema.json

@@ -20,8 +20,9 @@
             "type": "string",
             "description": "The action being performed on the Proposal.",
             "enum": [
-                "submission",
-                "retraction"
+                "final",
+                "draft",
+                "hide"
             ]
         }
     },

specs/signed_docs/docs/proposal_submission_action.cue

@@ -38,6 +38,13 @@ docs: #DocumentDefinitions & {
 			description: """
 				The kind of action is controlled by this payload.
 				The Payload is a JSON Document, and must conform to this schema.
+
+				States:
+
+				* `final` : All collaborators must publish a `final` status for the proposal to be `final`.
+				* `draft` : Reverses the previous `final` state for a signer.  
+				* `hide`  : Requests the proposal be hidden (not final, but a hidden draft).  
+							`hide` is only actioned if sent by the author, for a collaborator its synonymous with `draft`.
 				"""
 			schema: _ @embed(file="payload_schemas/proposal_submission_action.schema.json")
 		}