@go-labs-sg/gosh 0.5.0 → 0.7.0

package/README.md

@@ -65,13 +65,75 @@ 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
+
+Template commands use the selected organization as their scope. Provide its ID in
+the input when listing or retrieving a template:
+
+```bash
+gosh template list --input '{"organizationId":"acme"}'
+gosh template get --input '{"organizationId":"acme","templateId":"template-id"}'
+```
+
+Organization members can use only templates from that organization. Global admins
+can inspect templates from all organizations with `allOrganizations: true`, then
+use any returned template when creating an event for a chosen organization:
+
+```bash
+gosh template list --input '{"allOrganizations":true}'
+gosh event create-from-template \
+	--input '{"name":"Team challenge","organizationId":"acme","templateId":"template-id"}' \
+	--target template-id \
+	--allow-state-change
+```
+
+### Shared stations and team routes
+
+Create each station once for an event. In a team event, link the same station to
+each team's route with its own order. `team set-station-routes` replaces one
+team's complete route, so provide every station that team should see in order:
+
+```bash
+gosh team station-routes --input '{"eventId":"event-id"}'
+gosh team set-station-routes \
+  --input '{"eventId":"event-id","teamId":"team-red","stationIds":["station-2","station-1"]}' \
+  --target team-red \
+  --allow-state-change
+```
+
+To update an existing route's ordering without changing its station links, use
+`gosh station reorder` with the team as `scopeTeamId`.
+
+`gosh station clone` preserves the source station's team links when
+`targetTeamId` is omitted, appending the clone to each linked team's route.
+Provide a team ID to target only that team, or `null` to add the clone to the
+event catalog without explicit team links.
+
+When creating or replacing a template, each station can include `teamOrders` to
+preserve its route order for specific teams. `teamOrder` identifies the matching
+value in that template team's `order` field:
+
+```json
+{
+  "stations": [
+    {
+      "name": "Welcome station",
+      "teamOrders": [{ "teamOrder": 0, "order": 2 }]
+    }
+  ]
+}
+```
+
 ### Local file uploads
 
 Upload commands add the local file metadata to the supplied API input, request a permission-scoped signed URL, and upload the bytes directly to storage without sending the GOSH CLI access token to storage:
@@ -147,3 +209,17 @@ Without the allow flags, an interactive terminal prints a workflow preview and r
 ## Output
 
 One-shot commands write one JSON envelope to stdout. Watch commands write newline-delimited JSON envelopes. Failures and opt-in `--debug` diagnostics go to stderr, and known secrets, payloads, join codes, share tokens, and signed URLs are redacted. `--quiet` or `-q` suppresses diagnostics.
+
+## Release verification
+
+The `gosh-cli-v*` release workflow runs
+`bun run packages/scripts/monorepo/verify-cli-release-baseline.ts gosh` to check
+and typecheck the shared credential store, typecheck the retained test setup,
+and check, typecheck, and build the GOSH CLI. It then validates the packed
+artifact and runs both the installed entry point and `gosh version` before
+publishing.
+
+Behavior changes are verified with focused temporary tests before the PR,
+following the repository's temporary-test workflow in `AGENTS.md`. Those tests
+are removed before delivery, so the release workflow does not invoke the retired
+credential-store, architecture, or product regression suites.

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",
@@ -750,7 +759,7 @@
 		"path": ["station", "reorder"],
 		"procedure": "event.reorderStations",
 		"requiresAuth": true,
-		"summary": "Reorder an event's stations.",
+		"summary": "Reorder shared stations, or a selected team's station route when scopeTeamId is supplied.",
 		"targetKeys": [
 			"id",
 			"memberId",
@@ -912,6 +921,15 @@
 		"requiresAuth": true,
 		"summary": "List teams and their current members."
 	},
+	{
+		"effects": [],
+		"input": "json",
+		"operation": "query",
+		"path": ["team", "station-routes"],
+		"procedure": "team.getStationRoutes",
+		"requiresAuth": true,
+		"summary": "List each team's linked stations and team-specific route order."
+	},
 	{
 		"effects": ["state-change"],
 		"input": "json",
@@ -1104,6 +1122,38 @@
 			"name"
 		]
 	},
+	{
+		"effects": ["state-change"],
+		"input": "json",
+		"operation": "mutation",
+		"path": ["team", "set-station-routes"],
+		"procedure": "team.setStationRoutes",
+		"requiresAuth": true,
+		"summary": "Replace a team's linked station route and set its order.",
+		"targetKeys": [
+			"id",
+			"memberId",
+			"invitationId",
+			"broadcastId",
+			"rewardId",
+			"submissionId",
+			"participantId",
+			"participantIds",
+			"missionId",
+			"stationId",
+			"teamId",
+			"templateId",
+			"eventId",
+			"organizationId",
+			"userId",
+			"key",
+			"uploadId",
+			"email",
+			"joinCode",
+			"slug",
+			"name"
+		]
+	},
 	{
 		"effects": [],
 		"input": "json",
@@ -1111,7 +1161,7 @@
 		"path": ["template", "list"],
 		"procedure": "template.list",
 		"requiresAuth": true,
-		"summary": "List system and organization templates."
+		"summary": "List templates visible in an organization; global admins can include every organization."
 	},
 	{
 		"effects": [],
@@ -1120,7 +1170,7 @@
 		"path": ["template", "get"],
 		"procedure": "template.getById",
 		"requiresAuth": true,
-		"summary": "Get a template by ID."
+		"summary": "Get a template visible in the requested organization; global admins can get any template."
 	},
 	{
 		"effects": ["state-change"],
@@ -1129,7 +1179,7 @@
 		"path": ["template", "create"],
 		"procedure": "template.create",
 		"requiresAuth": true,
-		"summary": "Create an organization template.",
+		"summary": "Create an organization template, including shared stations with optional per-team route order.",
 		"targetKeys": ["organizationId", "name"]
 	},
 	{
@@ -1139,7 +1189,7 @@
 		"path": ["template", "update"],
 		"procedure": "template.update",
 		"requiresAuth": true,
-		"summary": "Replace a template's setup.",
+		"summary": "Replace a template's setup, including shared stations with optional per-team route order.",
 		"targetKeys": [
 			"id",
 			"memberId",

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.
@@ -316,7 +324,7 @@ Archive a station.
 
 ## `gosh station reorder`
 
-Reorder an event's stations.
+Reorder shared stations, or a selected team's station route when scopeTeamId is supplied.
 
 - Authentication: browser-authenticated CLI session required
 - Input: `--input '<json>'` required
@@ -362,6 +370,14 @@ List teams and their current members.
 - Input: `--input '<json>'` required
 - Effects: read-only
 
+## `gosh team station-routes`
+
+List each team's linked stations and team-specific route order.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
 ## `gosh team create`
 
 Create a team.
@@ -410,9 +426,17 @@ Change who can submit missions in team play.
 - Input: `--input '<json>'` required
 - Effects: state-change
 
+## `gosh team set-station-routes`
+
+Replace a team's linked station route and set its order.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
 ## `gosh template list`
 
-List system and organization templates.
+List templates visible in an organization; global admins can include every organization.
 
 - Authentication: browser-authenticated CLI session required
 - Input: `--input '<json>'` required
@@ -420,7 +444,7 @@ List system and organization templates.
 
 ## `gosh template get`
 
-Get a template by ID.
+Get a template visible in the requested organization; global admins can get any template.
 
 - Authentication: browser-authenticated CLI session required
 - Input: `--input '<json>'` required
@@ -428,7 +452,7 @@ Get a template by ID.
 
 ## `gosh template create`
 
-Create an organization template.
+Create an organization template, including shared stations with optional per-team route order.
 
 - Authentication: browser-authenticated CLI session required
 - Input: `--input '<json>'` required
@@ -436,7 +460,7 @@ Create an organization template.
 
 ## `gosh template update`
 
-Replace a template's setup.
+Replace a template's setup, including shared stations with optional per-team route order.
 
 - Authentication: browser-authenticated CLI session required
 - Input: `--input '<json>'` required

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)
@@ -20068,6 +20072,10 @@ var typedOperations = {
     kind: "query",
     invoke: (client, input2) => client.team.list.query(input2)
   },
+  "team.getStationRoutes": {
+    kind: "query",
+    invoke: (client, input2) => client.team.getStationRoutes.query(input2)
+  },
   "team.create": {
     kind: "mutation",
     invoke: (client, input2) => client.team.create.mutate(input2)
@@ -20092,6 +20100,10 @@ var typedOperations = {
     kind: "mutation",
     invoke: (client, input2) => client.team.setSubmissionAccess.mutate(input2)
   },
+  "team.setStationRoutes": {
+    kind: "mutation",
+    invoke: (client, input2) => client.team.setStationRoutes.mutate(input2)
+  },
   "template.list": {
     kind: "query",
     invoke: (client, input2) => client.template.list.query(input2)
@@ -20526,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."),
@@ -20565,7 +20578,7 @@ var commands = [
   ]),
   mutation(["station", "clone"], "event.cloneStation", "Clone a station and its missions.", ["state-change"]),
   mutation(["station", "archive"], "event.archiveStation", "Archive a station.", ["state-change", "delete"]),
-  mutation(["station", "reorder"], "event.reorderStations", "Reorder an event's stations.", ["state-change"]),
+  mutation(["station", "reorder"], "event.reorderStations", "Reorder shared stations, or a selected team's station route when scopeTeamId is supplied.", ["state-change"]),
   mutation(["mission", "create"], "event.createMission", "Create a mission in a station.", ["state-change"]),
   mutation(["mission", "update"], "event.updateMission", "Update a mission.", [
     "state-change"
@@ -20573,6 +20586,7 @@ var commands = [
   mutation(["mission", "archive"], "event.archiveMission", "Archive a mission.", ["state-change", "delete"]),
   mutation(["mission", "reorder"], "event.reorderMissions", "Reorder missions within a station.", ["state-change"]),
   query(["team", "list"], "team.list", "List teams and their current members."),
+  query(["team", "station-routes"], "team.getStationRoutes", "List each team's linked stations and team-specific route order."),
   mutation(["team", "create"], "team.create", "Create a team.", [
     "state-change"
   ]),
@@ -20583,10 +20597,11 @@ var commands = [
   mutation(["team", "remove-member"], "team.removeMember", "Remove a member from a team.", ["state-change", "delete"]),
   mutation(["team", "set-play-mode"], "team.setPlayMode", "Change an event between individual and team play.", ["state-change"]),
   mutation(["team", "set-submission-access"], "team.setSubmissionAccess", "Change who can submit missions in team play.", ["state-change"]),
-  query(["template", "list"], "template.list", "List system and organization templates."),
-  query(["template", "get"], "template.getById", "Get a template by ID."),
-  mutation(["template", "create"], "template.create", "Create an organization template.", ["state-change"]),
-  mutation(["template", "update"], "template.update", "Replace a template's setup.", ["state-change"]),
+  mutation(["team", "set-station-routes"], "team.setStationRoutes", "Replace a team's linked station route and set its order.", ["state-change"]),
+  query(["template", "list"], "template.list", "List templates visible in an organization; global admins can include every organization."),
+  query(["template", "get"], "template.getById", "Get a template visible in the requested organization; global admins can get any template."),
+  mutation(["template", "create"], "template.create", "Create an organization template, including shared stations with optional per-team route order.", ["state-change"]),
+  mutation(["template", "update"], "template.update", "Replace a template's setup, including shared stations with optional per-team route order.", ["state-change"]),
   mutation(["template", "update-metadata"], "template.updateMetadata", "Update template metadata.", ["state-change"]),
   mutation(["template", "delete"], "template.delete", "Delete a template.", [
     "state-change",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@go-labs-sg/gosh",
-  "version": "0.5.0",
+  "version": "0.7.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",