@go-labs-sg/gosh 0.6.1 → 0.8.0

package/README.md

@@ -65,11 +65,14 @@ gosh help event list
 gosh health status
 gosh organization list
 gosh event list --input '{"organizationId":"acme"}'
+gosh event list-page --input '{"organizationId":"acme","page":1,"pageSize":25,"search":"race","status":"LIVE"}'
 gosh event get --input '{"organizationId":"acme","eventId":"event-id"}'
 ```
 
 Commands use `--input '<json>'` for the exact validated tRPC input object. This preserves the GOSH API's typed validation without maintaining a second set of lossy CLI flags. See [command-reference.md](./command-reference.md) or import `@go-labs-sg/gosh/command-manifest` for the generated catalogue.
 
+`gosh event list-page` returns `{ items, page, pageSize, pageCount, totalCount }`. It defaults to page 1 with 25 results, accepts page sizes from 1 to 100, and supports server-side `search` and `status` filters. Archived events are excluded unless an explicit status is supplied. Request subsequent pages explicitly; the CLI does not automatically fetch every page. The existing `gosh event list` command and its array response remain unchanged.
+
 The command registry covers every callable GOSH tRPC procedure: organizer and global-admin operations, organization invitations and membership, player workflows, public results/login procedures, uploads, and realtime subscriptions. The compile-time registry test fails whenever a new API procedure is added without a CLI command.
 
 ### Templates and organization scope
@@ -94,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

@@ -53,6 +53,15 @@
 		"requiresAuth": true,
 		"summary": "List active events in an organization."
 	},
+	{
+		"effects": [],
+		"input": "json",
+		"operation": "query",
+		"path": ["event", "list-page"],
+		"procedure": "event.listPage",
+		"requiresAuth": true,
+		"summary": "List a filtered page of organization events using page, pageSize, search, and status."
+	},
 	{
 		"effects": [],
 		"input": "json",
@@ -2434,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

@@ -50,6 +50,14 @@ List active events in an organization.
 - Input: `--input '<json>'` required
 - Effects: read-only
 
+## `gosh event list-page`
+
+List a filtered page of organization events using page, pageSize, search, and status.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
 ## `gosh event get`
 
 Get an event by ID or slug.
@@ -932,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`
 

package/dist/index.js

@@ -19912,6 +19912,10 @@ var typedOperations = {
     kind: "query",
     invoke: (client, input2) => client.event.list.query(input2)
   },
+  "event.listPage": {
+    kind: "query",
+    invoke: (client, input2) => client.event.listPage.query(input2)
+  },
   "event.getById": {
     kind: "query",
     invoke: (client, input2) => client.event.getById.query(input2)
@@ -20534,6 +20538,7 @@ var commands = [
   query(["organization", "get"], "organization.getById", "Get one organization by ID or slug."),
   query(["organization", "members"], "organization.listMembers", "List an organization's members and pending invitations."),
   query(["event", "list"], "event.list", "List active events in an organization."),
+  query(["event", "list-page"], "event.listPage", "List a filtered page of organization events using page, pageSize, search, and status."),
   query(["event", "get"], "event.getById", "Get an event by ID or slug."),
   query(["event", "setup"], "event.getAdminSetup", "Get the organizer setup view for an event."),
   query(["event", "participants"], "event.getAdminParticipants", "Get the organizer participant view for an event."),
@@ -20661,7 +20666,7 @@ var commands = [
   mutation(["player", "mission", "upload-abort"], "event.abortMissionMediaMultipartUpload", "Abort a low-level multipart mission upload.", ["state-change", "delete", "external-write"]),
   subscription(["player", "watch"], "event.onPlayerEventChanged", "Watch player event changes as newline-delimited JSON."),
   subscription(["submission", "watch"], "event.onSubmissionReviewQueueChanged", "Watch submission review queue changes as newline-delimited JSON."),
-  mutation(["organization", "create"], "organization.create", "Create an organization.", ["state-change"]),
+  mutation(["organization", "create"], "organization.create", "Provision an organization and email its pending first owner invitation.", ["state-change", "email", "external-write"]),
   mutation(["organization", "update"], "organization.update", "Update an organization.", ["state-change"]),
   mutation(["organization", "slug-check"], "organization.checkSlug", "Check whether an organization slug is available.", []),
   query(["organization", "access-check"], "organization.checkOrganizationAccess", "Check access to an organization."),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@go-labs-sg/gosh",
-  "version": "0.6.1",
+  "version": "0.8.0",
   "description": "GOSH CLI for organizers and AI agents — manage organizations, events, teams, stations, missions, templates, and live operations through the GOSH API.",
   "type": "module",
   "main": "./dist/index.js",