@go-labs-sg/gosh 0.8.3 → 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.

package/dist/index.js

@@ -7056,6 +7056,34 @@ var typedOperations = {
     kind: "mutation",
     invoke: (client, input) => client.team.setStationRoutes.mutate(input)
   },
+  "team.setGameplaySettings": {
+    kind: "mutation",
+    invoke: (client, input) => client.team.setGameplaySettings.mutate(input)
+  },
+  "team.listRoutingGroups": {
+    kind: "query",
+    invoke: (client, input) => client.team.listRoutingGroups.query(input)
+  },
+  "team.createRoutingGroup": {
+    kind: "mutation",
+    invoke: (client, input) => client.team.createRoutingGroup.mutate(input)
+  },
+  "team.renameRoutingGroup": {
+    kind: "mutation",
+    invoke: (client, input) => client.team.renameRoutingGroup.mutate(input)
+  },
+  "team.deleteRoutingGroup": {
+    kind: "mutation",
+    invoke: (client, input) => client.team.deleteRoutingGroup.mutate(input)
+  },
+  "team.setRoutingGroupStations": {
+    kind: "mutation",
+    invoke: (client, input) => client.team.setRoutingGroupStations.mutate(input)
+  },
+  "team.assignTeamRoutingGroup": {
+    kind: "mutation",
+    invoke: (client, input) => client.team.assignTeamRoutingGroup.mutate(input)
+  },
   "template.list": {
     kind: "query",
     invoke: (client, input) => client.template.list.query(input)
@@ -7260,6 +7288,14 @@ var typedOperations = {
     kind: "mutation",
     invoke: (client, input) => client.event.createStationCheckInProof.mutate(input)
   },
+  "event.startStation": {
+    kind: "mutation",
+    invoke: (client, input) => client.event.startStation.mutate(input)
+  },
+  "event.skipMission": {
+    kind: "mutation",
+    invoke: (client, input) => client.event.skipMission.mutate(input)
+  },
   "event.submitMission": {
     kind: "mutation",
     invoke: (client, input) => client.event.submitMission.mutate(input)
@@ -7440,6 +7476,14 @@ var defaultMutationTargetKeys = [
   "name"
 ];
 var mutationTargetKeys = {
+  "team.setGameplaySettings": ["eventId"],
+  "team.createRoutingGroup": ["eventId"],
+  "team.renameRoutingGroup": ["groupId"],
+  "team.deleteRoutingGroup": ["groupId"],
+  "team.setRoutingGroupStations": ["groupId"],
+  "team.assignTeamRoutingGroup": ["teamId"],
+  "event.startStation": ["stationId"],
+  "event.skipMission": ["missionId"],
   "event.create": ["organizationId", "name"],
   "event.createFromTemplate": ["organizationId", "templateId"],
   "event.requestLoginEmailOtp": ["eventId", "email"],
@@ -7550,6 +7594,13 @@ var commands = [
   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"]),
   mutation(["team", "set-station-routes"], "team.setStationRoutes", "Replace a team's linked station route and set its order.", ["state-change"]),
+  mutation(["event", "set-gameplay"], "team.setGameplaySettings", "Set open or sequential progression, group routing, and per-mission skipping before play starts.", ["state-change"]),
+  query(["routing-group", "list"], "team.listRoutingGroups", "List an event's routing groups, ordered stations, and assigned teams."),
+  mutation(["routing-group", "create"], "team.createRoutingGroup", "Create a routing group within an event before play starts.", ["state-change"]),
+  mutation(["routing-group", "rename"], "team.renameRoutingGroup", "Rename an event's routing group before play starts.", ["state-change"]),
+  mutation(["routing-group", "delete"], "team.deleteRoutingGroup", "Delete an unassigned routing group before play starts.", ["state-change", "delete"]),
+  mutation(["routing-group", "set-stations"], "team.setRoutingGroupStations", "Replace a group's complete station route in the supplied order before play starts.", ["state-change"]),
+  mutation(["routing-group", "assign-team"], "team.assignTeamRoutingGroup", "Assign a team to a routing group, or clear its assignment with groupId null, before play starts.", ["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"]),
@@ -7606,6 +7657,8 @@ var commands = [
   mutation(["player", "display-name", "update"], "event.updatePlayerDisplayName", "Update the player's display name.", ["state-change"]),
   mutation(["player", "resolve-join-code"], "event.resolveJoinCode", "Resolve an event or team join code.", []),
   mutation(["player", "station-check-in"], "event.createStationCheckInProof", "Create an expiring station check-in proof.", ["state-change"]),
+  mutation(["player", "station", "start"], "event.startStation", "Start the current sequential station's shared mission timer and reveal its missions; required check-in still applies.", ["state-change"]),
+  mutation(["player", "mission", "skip"], "event.skipMission", "Permanently skip one unresolved mission for zero points when enabled; retain other points and elapsed station time.", ["state-change"]),
   mutation(["player", "mission", "submit"], "event.submitMission", "Submit a mission response.", ["state-change"]),
   query(["public", "event-login"], "event.getPublicLoginDetails", "Get public event login details.", { requiresAuth: false }),
   query(["public", "results"], "event.getResultsPortal", "Get a shared public results portal.", { requiresAuth: false }),

package/package.json

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