@go-labs-sg/gosh 0.7.0 → 0.8.1

package/README.md

@@ -97,6 +97,26 @@ gosh event create-from-template \
 	--allow-state-change
 ```
 
+### Organization provisioning
+
+Only global administrators can provision an organization. `gosh organization create`
+requires `name`, `slug`, and `ownerEmail`; it creates the organization with a
+pending first-owner invitation and emails that address. The provisioner does not
+become a member or owner. The invited person must sign in with that email and
+accept the invitation before they can manage the organization.
+
+```bash
+gosh organization create \
+	--input '{"name":"Acme Events","slug":"acme-events","ownerEmail":"owner@example.com"}' \
+	--target acme-events \
+	--allow-state-change \
+	--allow-email \
+	--allow-external-write
+```
+
+The response includes the pending owner invitation and its delivery status; do
+not treat the provisioner as the customer owner.
+
 ### Shared stations and team routes
 
 Create each station once for an event. In a team event, link the same station to

package/command-manifest.json

@@ -2443,13 +2443,13 @@
 		"summary": "Watch submission review queue changes as newline-delimited JSON."
 	},
 	{
-		"effects": ["state-change"],
+		"effects": ["state-change", "email", "external-write"],
 		"input": "json",
 		"operation": "mutation",
 		"path": ["organization", "create"],
 		"procedure": "organization.create",
 		"requiresAuth": true,
-		"summary": "Create an organization.",
+		"summary": "Provision an organization and email its pending first owner invitation.",
 		"targetKeys": ["slug", "name"]
 	},
 	{

package/command-reference.md

@@ -940,11 +940,11 @@ Watch submission review queue changes as newline-delimited JSON.
 
 ## `gosh organization create`
 
-Create an organization.
+Provision an organization and email its pending first owner invitation.
 
 - Authentication: browser-authenticated CLI session required
 - Input: `--input '<json>'` required
-- Effects: state-change
+- Effects: state-change, email, external-write
 
 ## `gosh organization update`