@go-labs-sg/gosh 0.8.2 → 0.9.0

package/README.md

@@ -73,7 +73,7 @@ Commands use `--input '<json>'` for the exact validated tRPC input object. This
 
 `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.
+The command registry exposes the supported GOSH tRPC procedures across organizer and global-admin operations, organization invitations and membership, player workflows, public results/login procedures, uploads, and realtime subscriptions. Update the registry alongside API changes, then run `bun run generate:commands` to regenerate the manifest, reference, and typed operations.
 
 ### Templates and organization scope
 
@@ -154,6 +154,79 @@ value in that template team's `order` field:
 }
 ```
 
+### Gameplay progression and routing groups
+
+Events default to `OPEN` progression, which keeps the existing open-play flow.
+Sequential progression starts each team or individual on an ordered station
+route. Group routing is available only for `TEAM` play mode. Create teams and
+assign them to routing groups before launching the event; setup freezes when
+play starts. A group shares its ordered station route, while each team keeps
+independent progress through that route.
+
+Configure gameplay, then manage the event's routing groups and their complete
+station lists:
+
+```bash
+gosh event set-gameplay \
+  --input '{"eventId":"event-id","progression":"SEQUENTIAL","groupRoutingEnabled":true,"allowMissionSkipping":true}' \
+  --target event-id \
+  --allow-state-change
+
+gosh routing-group list --input '{"eventId":"event-id"}'
+gosh routing-group create \
+  --input '{"eventId":"event-id","name":"North route"}' \
+  --target event-id \
+  --allow-state-change
+gosh routing-group rename \
+  --input '{"eventId":"event-id","groupId":"group-id","name":"East route"}' \
+  --target group-id \
+  --allow-state-change
+gosh routing-group set-stations \
+  --input '{"eventId":"event-id","groupId":"group-id","stationIds":["station-1","station-2"]}' \
+  --target group-id \
+  --allow-state-change
+gosh routing-group assign-team \
+  --input '{"eventId":"event-id","teamId":"team-id","groupId":"group-id"}' \
+  --target team-id \
+  --allow-state-change
+gosh routing-group delete \
+  --input '{"eventId":"event-id","groupId":"group-id"}' \
+  --target group-id \
+  --allow-state-change \
+  --allow-delete
+```
+
+`set-stations` replaces the group's entire route, so include every station in
+the desired order. Use `groupId: null` with `assign-team` to unassign a team.
+Group names are trimmed and limited to 80 characters. The delete command
+requires the additional `--allow-delete` effect flag.
+
+For sequential player actions, complete any required location check-in with
+`gosh player station-check-in` first. The server checks the signed-in player’s
+current check-in record; a successful check-in also starts the station timer.
+Use `player station start` when check-in is disabled. Skipping is an individual
+mission action available only when enabled in event gameplay settings:
+
+```bash
+gosh player station start \
+  --input '{"eventId":"event-id","stationId":"station-1"}' \
+  --target station-1 \
+  --allow-state-change
+gosh player mission skip \
+  --input '{"eventId":"event-id","missionId":"mission-1"}' \
+  --target mission-1 \
+  --allow-state-change
+```
+
+Player actions require event enrollment and the configured team submission
+permissions. A skipped mission is irreversible and earns zero points; it resolves only that mission,
+preserves points from the station's other submitted missions, and advances the
+route once all station missions are submitted or skipped. The station timer
+runs from check-in/start through the final mission submission or skip. It
+measures mission work only: travel between stations and staff review time are
+excluded. Existing leaderboard and results commands include the resulting
+timing information.
+
 ### 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:

package/command-manifest.json

@@ -1154,6 +1154,75 @@
 			"name"
 		]
 	},
+	{
+		"effects": ["state-change"],
+		"input": "json",
+		"operation": "mutation",
+		"path": ["event", "set-gameplay"],
+		"procedure": "team.setGameplaySettings",
+		"requiresAuth": true,
+		"summary": "Set open or sequential progression, group routing, and per-mission skipping before play starts.",
+		"targetKeys": ["eventId"]
+	},
+	{
+		"effects": [],
+		"input": "json",
+		"operation": "query",
+		"path": ["routing-group", "list"],
+		"procedure": "team.listRoutingGroups",
+		"requiresAuth": true,
+		"summary": "List an event's routing groups, ordered stations, and assigned teams."
+	},
+	{
+		"effects": ["state-change"],
+		"input": "json",
+		"operation": "mutation",
+		"path": ["routing-group", "create"],
+		"procedure": "team.createRoutingGroup",
+		"requiresAuth": true,
+		"summary": "Create a routing group within an event before play starts.",
+		"targetKeys": ["eventId"]
+	},
+	{
+		"effects": ["state-change"],
+		"input": "json",
+		"operation": "mutation",
+		"path": ["routing-group", "rename"],
+		"procedure": "team.renameRoutingGroup",
+		"requiresAuth": true,
+		"summary": "Rename an event's routing group before play starts.",
+		"targetKeys": ["groupId"]
+	},
+	{
+		"effects": ["state-change", "delete"],
+		"input": "json",
+		"operation": "mutation",
+		"path": ["routing-group", "delete"],
+		"procedure": "team.deleteRoutingGroup",
+		"requiresAuth": true,
+		"summary": "Delete an unassigned routing group before play starts.",
+		"targetKeys": ["groupId"]
+	},
+	{
+		"effects": ["state-change"],
+		"input": "json",
+		"operation": "mutation",
+		"path": ["routing-group", "set-stations"],
+		"procedure": "team.setRoutingGroupStations",
+		"requiresAuth": true,
+		"summary": "Replace a group's complete station route in the supplied order before play starts.",
+		"targetKeys": ["groupId"]
+	},
+	{
+		"effects": ["state-change"],
+		"input": "json",
+		"operation": "mutation",
+		"path": ["routing-group", "assign-team"],
+		"procedure": "team.assignTeamRoutingGroup",
+		"requiresAuth": true,
+		"summary": "Assign a team to a routing group, or clear its assignment with groupId null, before play starts.",
+		"targetKeys": ["teamId"]
+	},
 	{
 		"effects": [],
 		"input": "json",
@@ -2190,6 +2259,26 @@
 			"name"
 		]
 	},
+	{
+		"effects": ["state-change"],
+		"input": "json",
+		"operation": "mutation",
+		"path": ["player", "station", "start"],
+		"procedure": "event.startStation",
+		"requiresAuth": true,
+		"summary": "Start the current sequential station's shared mission timer and reveal its missions; required check-in still applies.",
+		"targetKeys": ["stationId"]
+	},
+	{
+		"effects": ["state-change"],
+		"input": "json",
+		"operation": "mutation",
+		"path": ["player", "mission", "skip"],
+		"procedure": "event.skipMission",
+		"requiresAuth": true,
+		"summary": "Permanently skip one unresolved mission for zero points when enabled; retain other points and elapsed station time.",
+		"targetKeys": ["missionId"]
+	},
 	{
 		"effects": ["state-change"],
 		"input": "json",

package/command-reference.md

@@ -434,6 +434,62 @@ Replace a team's linked station route and set its order.
 - Input: `--input '<json>'` required
 - Effects: state-change
 
+## `gosh event set-gameplay`
+
+Set open or sequential progression, group routing, and per-mission skipping before play starts.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh routing-group list`
+
+List an event's routing groups, ordered stations, and assigned teams.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh routing-group create`
+
+Create a routing group within an event before play starts.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh routing-group rename`
+
+Rename an event's routing group before play starts.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh routing-group delete`
+
+Delete an unassigned routing group before play starts.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change, delete
+
+## `gosh routing-group set-stations`
+
+Replace a group's complete station route in the supplied order before play starts.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh routing-group assign-team`
+
+Assign a team to a routing group, or clear its assignment with groupId null, before play starts.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
 ## `gosh template list`
 
 List templates visible in an organization; global admins can include every organization.
@@ -842,6 +898,22 @@ Create an expiring station check-in proof.
 - Input: `--input '<json>'` required
 - Effects: state-change
 
+## `gosh player station start`
+
+Start the current sequential station's shared mission timer and reveal its missions; required check-in still applies.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh player mission skip`
+
+Permanently skip one unresolved mission for zero points when enabled; retain other points and elapsed station time.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
 ## `gosh player mission submit`
 
 Submit a mission response.