@go-labs-sg/gosh 1.3.0 → 1.4.0

package/README.md

@@ -268,7 +268,7 @@ station lists:
 
 ```bash
 gosh event set-gameplay \
-  --input '{"eventId":"event-id","progression":"SEQUENTIAL","groupRoutingEnabled":true,"allowMissionSkipping":true}' \
+  --input '{"eventId":"event-id","progression":"SEQUENTIAL","groupRoutingEnabled":true,"allowMissionSkipping":true,"allowStationSkipping":false}' \
   --target event-id \
   --allow-state-change
 
@@ -381,6 +381,46 @@ finish time are kept, and a finished station accepts the reopened mission
 until it is resolved. Pending submissions must be reviewed first, and a
 reopened mission that still holds earlier points cannot be skipped.
 
+#### Skipping a station
+
+When the event's `allowStationSkipping` gameplay setting is on, a player who
+can submit for their team can skip their current station. Check-in is not
+required, so a team that cannot pass geolock can still move on:
+
+```bash
+gosh player station skip \
+  --input '{"eventId":"event-id","stationId":"station-2"}' \
+  --target station-2 \
+  --allow-state-change
+```
+
+A host with `reviewSubmissions` can skip a team's (`teamId`) or individual
+player's (`eventPlayerId`) current station, or one open mission on it, while
+the event is live. This works whatever the player setting is. Check the route
+first, then pass an optional reason:
+
+```bash
+gosh route progress --input '{"eventId":"event-id","teamId":"team-1"}'
+
+gosh route skip-station \
+  --input '{"eventId":"event-id","teamId":"team-1","stationId":"station-2","reason":"Location closed"}' \
+  --target team-1 \
+  --allow-state-change
+
+gosh route skip-mission \
+  --input '{"eventId":"event-id","teamId":"team-1","missionId":"mission-3","reason":"Prop missing"}' \
+  --target team-1 \
+  --allow-state-change
+```
+
+Only the current station can be skipped, so route order stays intact. Its
+open missions score zero, the station completes (a stop nobody started records
+zero time), and the next stop unlocks immediately; skipping the last stop
+finishes the route. A station with a reopened mission that still holds earlier
+points cannot be skipped until it is resubmitted or reviewed. Who skipped and
+why appears in `route progress`, the activity log, and the results export's
+`skips.csv`.
+
 When reviewing, pass the submission's `updatedAt` from the review queue as
 `expectedUpdatedAt`. If the team resubmitted after you read it, the review is
 refused with `CONFLICT` instead of scoring the new answer blind:
@@ -513,6 +553,14 @@ gosh submission watch --input '{"organizationId":"acme","eventId":"event-id"}'
 
 Global admins can list users, change global roles, and ban or unban accounts under `gosh admin users …`. Banning an account atomically revokes its active browser and CLI sessions.
 
+Global admins can read every post-event experience review across organizations under `gosh admin reviews …`. `list` returns newest-first `{ items, pageInfo }` cursor pages (`limit` 1 to 100, default 25; pass `pageInfo.nextCursor` back as `cursor`), `count` returns the total, average rating and 5 to 1 star distribution, `filter-options` lists the organizations and events that have reviews, and `export` returns every matching row (up to 10,000). All four accept the same optional filters: `rating` (1 to 5), `organizationId`, `eventId`, `comment` (`with` or `without`) and `q` (comment, participant or event search):
+
+```bash
+gosh admin reviews list --input '{"rating":1,"limit":50}'
+gosh admin reviews count --input '{"comment":"with"}'
+gosh admin reviews export --input '{"organizationId":"org-id"}'
+```
+
 ## Mutation safety
 
 Mutations require `--target` to exactly match an identifier in `--input` (such as an `eventId`, `stationId`, slug, or name), binding the confirmation to the payload. In non-interactive automation, every applicable effect flag is also required:

package/command-manifest.json

@@ -921,6 +921,15 @@
 		"requiresAuth": true,
 		"summary": "List teams and their current members."
 	},
+	{
+		"effects": [],
+		"input": "json",
+		"operation": "query",
+		"path": ["route", "progress"],
+		"procedure": "team.getRouteProgress",
+		"requiresAuth": true,
+		"summary": "Show a team's (teamId) or individual player's (eventPlayerId) sequential route: stops, mission statuses, and who skipped what and why."
+	},
 	{
 		"effects": [],
 		"input": "json",
@@ -1660,6 +1669,26 @@
 			"name"
 		]
 	},
+	{
+		"effects": ["state-change"],
+		"input": "json",
+		"operation": "mutation",
+		"path": ["route", "skip-station"],
+		"procedure": "team.skipStation",
+		"requiresAuth": true,
+		"summary": "Skip a team's (teamId) or individual player's (eventPlayerId) current station on a fixed-order route while the event is live, with an optional reason. Its open missions score zero and the next stop unlocks; works whatever the player skipping setting is.",
+		"targetKeys": ["teamId", "eventPlayerId", "stationId"]
+	},
+	{
+		"effects": ["state-change"],
+		"input": "json",
+		"operation": "mutation",
+		"path": ["route", "skip-mission"],
+		"procedure": "team.skipMission",
+		"requiresAuth": true,
+		"summary": "Skip one open mission at a team's (teamId) or individual player's (eventPlayerId) current station for zero points, with an optional reason. Completes the station when it was the last open mission.",
+		"targetKeys": ["teamId", "eventPlayerId", "missionId"]
+	},
 	{
 		"effects": ["state-change"],
 		"input": "json",
@@ -1906,6 +1935,16 @@
 			"name"
 		]
 	},
+	{
+		"effects": ["state-change"],
+		"input": "json",
+		"operation": "mutation",
+		"path": ["event", "update-survey"],
+		"procedure": "event.updateSurveySettings",
+		"requiresAuth": true,
+		"summary": "Set the player survey: built-in, external link, or off, plus its copy and Google review prompt.",
+		"targetKeys": ["eventId"]
+	},
 	{
 		"effects": ["state-change"],
 		"input": "json",
@@ -2451,6 +2490,16 @@
 		"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",
+		"operation": "mutation",
+		"path": ["player", "station", "skip"],
+		"procedure": "event.skipStation",
+		"requiresAuth": true,
+		"summary": "Skip your current sequential station for zero points when the event allows station skipping. No check-in is needed; its missions cannot be played later.",
+		"targetKeys": ["stationId"]
+	},
 	{
 		"effects": ["state-change"],
 		"input": "json",
@@ -3120,6 +3169,42 @@
 			"name"
 		]
 	},
+	{
+		"effects": [],
+		"input": "json",
+		"operation": "query",
+		"path": ["admin", "reviews", "list"],
+		"procedure": "review.listAdmin",
+		"requiresAuth": true,
+		"summary": "List experience reviews across all events as a global admin. Input: optional rating, organizationId, eventId, comment (with|without), q, plus limit, cursor and direction; returns { items, pageInfo }."
+	},
+	{
+		"effects": [],
+		"input": "json",
+		"operation": "query",
+		"path": ["admin", "reviews", "count"],
+		"procedure": "review.getAdminSummary",
+		"requiresAuth": true,
+		"summary": "Count experience reviews for the given filters, with average rating and 5 to 1 star distribution."
+	},
+	{
+		"effects": [],
+		"input": "none",
+		"operation": "query",
+		"path": ["admin", "reviews", "filter-options"],
+		"procedure": "review.listAdminFilterOptions",
+		"requiresAuth": true,
+		"summary": "List organizations and events that have experience reviews."
+	},
+	{
+		"effects": [],
+		"input": "json",
+		"operation": "query",
+		"path": ["admin", "reviews", "export"],
+		"procedure": "review.exportAdmin",
+		"requiresAuth": true,
+		"summary": "Export every experience review matching the filters as rows (capped at 10,000)."
+	},
 	{
 		"path": ["assets", "requirements"],
 		"operation": "local",

package/command-reference.md

@@ -370,6 +370,14 @@ List teams and their current members.
 - Input: `--input '<json>'` required
 - Effects: read-only
 
+## `gosh route progress`
+
+Show a team's (teamId) or individual player's (eventPlayerId) sequential route: stops, mission statuses, and who skipped what and why.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
 ## `gosh team station-routes`
 
 List each team's linked stations and team-specific route order.
@@ -650,6 +658,22 @@ Review a mission submission.
 - Input: `--input '<json>'` required
 - Effects: state-change
 
+## `gosh route skip-station`
+
+Skip a team's (teamId) or individual player's (eventPlayerId) current station on a fixed-order route while the event is live, with an optional reason. Its open missions score zero and the next stop unlocks; works whatever the player skipping setting is.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
+## `gosh route skip-mission`
+
+Skip one open mission at a team's (teamId) or individual player's (eventPlayerId) current station for zero points, with an optional reason. Completes the station when it was the last open mission.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
 ## `gosh mission reopen`
 
 Reopen a submitted or skipped mission for one team (teamId) or player (eventPlayerId) on a fixed-order route. Earlier points count until they resubmit; then only the new submission counts. Finish times are kept.
@@ -786,6 +810,14 @@ Update event branding.
 - Input: `--input '<json>'` required
 - Effects: state-change
 
+## `gosh event update-survey`
+
+Set the player survey: built-in, external link, or off, plus its copy and Google review prompt.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
 ## `gosh station update-availability`
 
 Update station availability.
@@ -1002,6 +1034,14 @@ Permanently skip one unresolved mission for zero points when enabled; retain oth
 - Input: `--input '<json>'` required
 - Effects: state-change
 
+## `gosh player station skip`
+
+Skip your current sequential station for zero points when the event allows station skipping. No check-in is needed; its missions cannot be played later.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
 ## `gosh player mission submit`
 
 Submit a mission response and return revealMessage, including already-completed submissions.
@@ -1244,6 +1284,38 @@ Unban a user.
 - Input: `--input '<json>'` required
 - Effects: state-change
 
+## `gosh admin reviews list`
+
+List experience reviews across all events as a global admin. Input: optional rating, organizationId, eventId, comment (with|without), q, plus limit, cursor and direction; returns { items, pageInfo }.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh admin reviews count`
+
+Count experience reviews for the given filters, with average rating and 5 to 1 star distribution.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh admin reviews filter-options`
+
+List organizations and events that have experience reviews.
+
+- Authentication: browser-authenticated CLI session required
+- Input: none
+- Effects: read-only
+
+## `gosh admin reviews export`
+
+Export every experience review matching the filters as rows (capped at 10,000).
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
 ## `gosh assets requirements`
 
 Show upload limits and separate artwork recommendations without login or network access.

package/dist/index.js

@@ -7452,6 +7452,10 @@ var typedOperations = {
     kind: "query",
     invoke: (client, input) => client.team.list.query(input)
   },
+  "team.getRouteProgress": {
+    kind: "query",
+    invoke: (client, input) => client.team.getRouteProgress.query(input)
+  },
   "team.getStationRoutes": {
     kind: "query",
     invoke: (client, input) => client.team.getStationRoutes.query(input)
@@ -7592,6 +7596,14 @@ var typedOperations = {
     kind: "mutation",
     invoke: (client, input) => client.event.reviewSubmission.mutate(input)
   },
+  "team.skipStation": {
+    kind: "mutation",
+    invoke: (client, input) => client.team.skipStation.mutate(input)
+  },
+  "team.skipMission": {
+    kind: "mutation",
+    invoke: (client, input) => client.team.skipMission.mutate(input)
+  },
   "event.reopenMission": {
     kind: "mutation",
     invoke: (client, input) => client.event.reopenMission.mutate(input)
@@ -7660,6 +7672,10 @@ var typedOperations = {
     kind: "mutation",
     invoke: (client, input) => client.event.updateBranding.mutate(input)
   },
+  "event.updateSurveySettings": {
+    kind: "mutation",
+    invoke: (client, input) => client.event.updateSurveySettings.mutate(input)
+  },
   "event.updateStationAvailability": {
     kind: "mutation",
     invoke: (client, input) => client.event.updateStationAvailability.mutate(input)
@@ -7768,6 +7784,10 @@ var typedOperations = {
     kind: "mutation",
     invoke: (client, input) => client.event.skipMission.mutate(input)
   },
+  "event.skipStation": {
+    kind: "mutation",
+    invoke: (client, input) => client.event.skipStation.mutate(input)
+  },
   "event.submitMission": {
     kind: "mutation",
     invoke: (client, input) => client.event.submitMission.mutate(input)
@@ -7895,6 +7915,22 @@ var typedOperations = {
   "user.unban": {
     kind: "mutation",
     invoke: (client, input) => client.user.unban.mutate(input)
+  },
+  "review.listAdmin": {
+    kind: "query",
+    invoke: (client, input) => client.review.listAdmin.query(input)
+  },
+  "review.getAdminSummary": {
+    kind: "query",
+    invoke: (client, input) => client.review.getAdminSummary.query(input)
+  },
+  "review.listAdminFilterOptions": {
+    kind: "query",
+    invoke: (client, input) => client.review.listAdminFilterOptions.query(input)
+  },
+  "review.exportAdmin": {
+    kind: "query",
+    invoke: (client, input) => client.review.exportAdmin.query(input)
   }
 };
 
@@ -7950,6 +7986,7 @@ var defaultMutationTargetKeys = [
 var mutationTargetKeys = {
   "team.updateRoutingGroupRelease": ["groupId", "eventId"],
   "team.setGameplaySettings": ["eventId"],
+  "event.updateSurveySettings": ["eventId"],
   "team.createRoutingGroup": ["eventId"],
   "team.renameRoutingGroup": ["groupId"],
   "team.deleteRoutingGroup": ["groupId"],
@@ -7959,6 +7996,9 @@ var mutationTargetKeys = {
   "team.resolveRsvpCheckInReview": ["linkId"],
   "event.startStation": ["stationId"],
   "event.skipMission": ["missionId"],
+  "event.skipStation": ["stationId"],
+  "team.skipStation": ["teamId", "eventPlayerId", "stationId"],
+  "team.skipMission": ["teamId", "eventPlayerId", "missionId"],
   "event.reopenMission": ["teamId", "eventPlayerId", "missionId"],
   "event.create": ["organizationId", "name"],
   "event.createFromTemplate": ["organizationId", "templateId"],
@@ -8056,6 +8096,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(["route", "progress"], "team.getRouteProgress", "Show a team's (teamId) or individual player's (eventPlayerId) sequential route: stops, mission statuses, and who skipped what and why."),
   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"
@@ -8098,6 +8139,8 @@ var commands = [
   mutation(["reward", "update"], "event.updateReward", "Update an event reward.", ["state-change"]),
   mutation(["score", "adjust"], "event.createScoreAdjustment", "Create a manual score adjustment.", ["state-change"]),
   mutation(["submission", "review"], "event.reviewSubmission", "Review a mission submission.", ["state-change"]),
+  mutation(["route", "skip-station"], "team.skipStation", "Skip a team's (teamId) or individual player's (eventPlayerId) current station on a fixed-order route while the event is live, with an optional reason. Its open missions score zero and the next stop unlocks; works whatever the player skipping setting is.", ["state-change"]),
+  mutation(["route", "skip-mission"], "team.skipMission", "Skip one open mission at a team's (teamId) or individual player's (eventPlayerId) current station for zero points, with an optional reason. Completes the station when it was the last open mission.", ["state-change"]),
   mutation(["mission", "reopen"], "event.reopenMission", "Reopen a submitted or skipped mission for one team (teamId) or player (eventPlayerId) on a fixed-order route. Earlier points count until they resubmit; then only the new submission counts. Finish times are kept.", ["state-change"]),
   mutation(["results-share", "regenerate"], "event.regenerateResultsPortalShare", "Create a new results portal share token.", ["state-change"]),
   mutation(["results-share", "revoke"], "event.revokeResultsPortalShare", "Revoke the current results portal share token.", ["state-change", "delete"]),
@@ -8115,6 +8158,7 @@ var commands = [
   query(["results-share", "get"], "event.getResultsPortalShare", "Get the current results portal share."),
   mutation(["event", "update-access"], "event.updateAccess", "Update event access rules.", ["state-change"]),
   mutation(["event", "update-branding"], "event.updateBranding", "Update event branding.", ["state-change"]),
+  mutation(["event", "update-survey"], "event.updateSurveySettings", "Set the player survey: built-in, external link, or off, plus its copy and Google review prompt.", ["state-change"]),
   mutation(["station", "update-availability"], "event.updateStationAvailability", "Update station availability.", ["state-change"]),
   mutation(["station", "update-image"], "event.updateStationImage", "Update a station image.", ["state-change"]),
   mutation(["station", "update-location"], "event.updateStationLocation", "Update station location and geofence settings.", ["state-change"]),
@@ -8144,6 +8188,7 @@ var commands = [
   mutation(["player", "station-qr-check-in"], "event.createStationQrCheckInProof", "Check in to a station with its scanned QR or manual code.", ["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", "station", "skip"], "event.skipStation", "Skip your current sequential station for zero points when the event allows station skipping. No check-in is needed; its missions cannot be played later.", ["state-change"]),
   mutation(["player", "mission", "submit"], "event.submitMission", "Submit a mission response and return revealMessage, including already-completed submissions.", ["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 }),
@@ -8175,7 +8220,11 @@ var commands = [
   mutation(["admin", "users", "ban"], "user.ban", "Ban a user and revoke their sessions and API keys.", ["state-change", "delete"]),
   mutation(["admin", "users", "unban"], "user.unban", "Unban a user.", [
     "state-change"
-  ])
+  ]),
+  query(["admin", "reviews", "list"], "review.listAdmin", "List experience reviews across all events as a global admin. Input: optional rating, organizationId, eventId, comment (with|without), q, plus limit, cursor and direction; returns { items, pageInfo }."),
+  query(["admin", "reviews", "count"], "review.getAdminSummary", "Count experience reviews for the given filters, with average rating and 5 to 1 star distribution."),
+  query(["admin", "reviews", "filter-options"], "review.listAdminFilterOptions", "List organizations and events that have experience reviews.", { input: "none" }),
+  query(["admin", "reviews", "export"], "review.exportAdmin", "Export every experience review matching the filters as rows (capped at 10,000).")
 ];
 var commandManifest = commands.map((command) => ({
   effects: command.effects,

package/package.json

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