@go-labs-sg/gosh 1.3.0 → 1.5.0

package/README.md

@@ -157,6 +157,42 @@ Deploy prerequisite: apply the additive GOSH database schema changes for both
 to `[]`, before deploying the updated server. Older event snapshots restore an
 empty list. Client generation alone does not apply these database changes.
 
+### Number range answers
+
+Fill-in-the-blank missions can accept any number in an inclusive range instead
+of text answers. Set `config.numberRange` with `min` and `max` (`min` must be
+less than or equal to `max`). Players must answer with a number such as `55`,
+`55.5`, `-3` or `1,000`; anything that is not a number is marked incorrect.
+Ranges cannot be combined with `acceptedAnswers` and are only available for
+fill-in-the-blank missions.
+
+```bash
+gosh mission create --input '{"stationId":"station-id","name":"Guess the height","type":"FILL_IN_THE_BLANK","config":{"numberRange":{"min":50,"max":60}}}'
+gosh mission update --input '{"missionId":"mission-id","name":"Guess the height","type":"FILL_IN_THE_BLANK","config":null,"correctAnswer":"55"}'
+```
+
+When updating, omit `config` to keep the saved range or pass `null` to switch
+back to text answers. Players see a number input but never the range itself.
+
+Rollout gate: the stored `correctAnswer` (`"50-60"`) is a display key, not a
+safe fallback. A server without number-range support grades it as plain text,
+so it accepts the literal `50-60` and rejects an in-range `55`, and its
+template, clone and version writers drop `config`. Apply the additive
+`Mission.config` and `GoshTemplateMission.config` columns, finish rolling out
+the server everywhere, then create range missions.
+
+Rollback: a range mission that has submissions cannot be switched back to text.
+The answer-key lock in `mission update` rejects that edit on purpose, so stored
+answers and points stay consistent. Do not loosen or bypass it. Instead:
+
+- Unused range missions (no submissions) and templates can be switched back to
+  text answers or removed before a rollback.
+- Used range missions: do not roll the server back past number-range support
+  while those events are live. Fix forward on a compatible build (any build
+  with number-range grading), or keep the previous image ready only for
+  events with no range missions. A lossless rollback for used range missions
+  needs its own approved plan; a normal edit cannot do it.
+
 ### Templates and organization scope
 
 Template commands use the selected organization as their scope. Provide its ID in
@@ -264,11 +300,15 @@ gosh team create \
 ```
 
 Configure gameplay, then manage the event's routing groups and their complete
-station lists:
+station lists. `requireLocationOnSubmit` (default false) makes players at a
+location-locked station check in again within the last two minutes before each
+answer or upload is accepted, not only once at check-in. A fresh QR scan counts
+at stations that also accept QR. It stays editable during live play; omit it,
+or `allowStationSkipping`, to keep the event's current value.
 
 ```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,"requireLocationOnSubmit":true}' \
   --target event-id \
   --allow-state-change
 
@@ -381,6 +421,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 +593,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

@@ -791,7 +791,7 @@
 		"path": ["mission", "create"],
 		"procedure": "event.createMission",
 		"requiresAuth": true,
-		"summary": "Create a mission in a station. Fill-in-the-blank inputs support correctAnswer and acceptedAnswers (up to 50 alternatives). Optional revealMessage (up to 2,000 characters) is shown only after submitting.",
+		"summary": "Create a mission in a station. Fill-in-the-blank inputs support correctAnswer and acceptedAnswers (up to 50 alternatives), or config.numberRange {min,max} to accept any number in that inclusive range instead. Optional revealMessage (up to 2,000 characters) is shown only after submitting.",
 		"targetKeys": [
 			"id",
 			"memberId",
@@ -823,7 +823,7 @@
 		"path": ["mission", "update"],
 		"procedure": "event.updateMission",
 		"requiresAuth": true,
-		"summary": "Update a mission. Fill-in-the-blank inputs support acceptedAnswers; omit to preserve or pass [] to clear. Existing submissions are not re-graded. Edit revealMessage during live play; omit it to preserve or use an empty string to clear.",
+		"summary": "Update a mission. Fill-in-the-blank inputs support acceptedAnswers; omit to preserve or pass [] to clear. Set config.numberRange {min,max} for a numeric range answer; omit config to preserve or pass null to return to text answers. Existing submissions are not re-graded. Edit revealMessage during live play; omit it to preserve or use an empty string to clear.",
 		"targetKeys": [
 			"id",
 			"memberId",
@@ -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",
@@ -1161,7 +1170,7 @@
 		"path": ["event", "set-gameplay"],
 		"procedure": "team.setGameplaySettings",
 		"requiresAuth": true,
-		"summary": "Set open or sequential progression, group routing, and per-mission skipping before play starts.",
+		"summary": "Set open or sequential progression, group routing, and per-mission skipping before play starts. Station skipping and requireLocationOnSubmit stay editable live.",
 		"targetKeys": ["eventId"]
 	},
 	{
@@ -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",
@@ -2161,6 +2200,15 @@
 		"requiresAuth": true,
 		"summary": "Get a playable station."
 	},
+	{
+		"effects": [],
+		"input": "json",
+		"operation": "query",
+		"path": ["player", "station", "presence"],
+		"procedure": "event.getPlayerStationPresence",
+		"requiresAuth": true,
+		"summary": "Check whether a location is within a station's submit range when the event asks players to stay at the station to submit. Returns a state and rounded distance, never coordinates."
+	},
 	{
 		"effects": [],
 		"input": "none",
@@ -2451,6 +2499,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 +3178,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

@@ -332,7 +332,7 @@ Reorder shared stations, or a selected team's station route when scopeTeamId is
 
 ## `gosh mission create`
 
-Create a mission in a station. Fill-in-the-blank inputs support correctAnswer and acceptedAnswers (up to 50 alternatives). Optional revealMessage (up to 2,000 characters) is shown only after submitting.
+Create a mission in a station. Fill-in-the-blank inputs support correctAnswer and acceptedAnswers (up to 50 alternatives), or config.numberRange {min,max} to accept any number in that inclusive range instead. Optional revealMessage (up to 2,000 characters) is shown only after submitting.
 
 - Authentication: browser-authenticated CLI session required
 - Input: `--input '<json>'` required
@@ -340,7 +340,7 @@ Create a mission in a station. Fill-in-the-blank inputs support correctAnswer an
 
 ## `gosh mission update`
 
-Update a mission. Fill-in-the-blank inputs support acceptedAnswers; omit to preserve or pass [] to clear. Existing submissions are not re-graded. Edit revealMessage during live play; omit it to preserve or use an empty string to clear.
+Update a mission. Fill-in-the-blank inputs support acceptedAnswers; omit to preserve or pass [] to clear. Set config.numberRange {min,max} for a numeric range answer; omit config to preserve or pass null to return to text answers. Existing submissions are not re-graded. Edit revealMessage during live play; omit it to preserve or use an empty string to clear.
 
 - Authentication: browser-authenticated CLI session required
 - Input: `--input '<json>'` required
@@ -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.
@@ -436,7 +444,7 @@ Replace a team's linked station route and set its order.
 
 ## `gosh event set-gameplay`
 
-Set open or sequential progression, group routing, and per-mission skipping before play starts.
+Set open or sequential progression, group routing, and per-mission skipping before play starts. Station skipping and requireLocationOnSubmit stay editable live.
 
 - Authentication: browser-authenticated CLI session required
 - Input: `--input '<json>'` required
@@ -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.
@@ -890,6 +922,14 @@ Get a playable station.
 - Input: `--input '<json>'` required
 - Effects: read-only
 
+## `gosh player station presence`
+
+Check whether a location is within a station's submit range when the event asks players to stay at the station to submit. Returns a state and rounded distance, never coordinates.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
 ## `gosh player events`
 
 List events joined by the current user.
@@ -1002,6 +1042,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 +1292,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

@@ -35,7 +35,7 @@ var __toESM = (mod, isNodeMode, target) => {
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __require = import.meta.require;
 
-// ../../../node_modules/.bun/dotenv@18.0.8/node_modules/dotenv/dist/index.cjs
+// ../../../node_modules/.bun/dotenv@18.0.9/node_modules/dotenv/dist/index.cjs
 var require_dist = __commonJS(function(exports, module) {
   var j = (e, n) => () => {
     try {
@@ -367,7 +367,7 @@ var require_dist = __commonJS(function(exports, module) {
     }
     function Ee(e) {
       let n = J(), t = { encoding: n.encoding || "utf8", quiet: n.quiet, debug: n.debug === true, override: n.override === true, fast: n.fast === true, paths: [".env"], defaultPath: true };
-      return n.path != null && (t.paths = [n.path], t.defaultPath = false), e.pathSet && (t.paths = e.paths, t.defaultPath = false), e.quiet != null && (t.quiet = e.quiet), e.debug != null && (t.debug = e.debug), e.override != null && (t.override = e.override), e.fast != null && (t.fast = e.fast), t;
+      return n.path && (t.paths = [n.path], t.defaultPath = false), e.pathSet && (t.paths = e.paths, t.defaultPath = false), e.quiet != null && (t.quiet = e.quiet), e.debug != null && (t.debug = e.debug), e.override != null && (t.override = e.override), e.fast != null && (t.fast = e.fast), t;
     }
     function be(e) {
       let n = {}, t = [], o = { override: e.override, debug: e.debug };
@@ -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)
@@ -7712,6 +7728,10 @@ var typedOperations = {
     kind: "query",
     invoke: (client, input) => client.event.getPlayerStation.query(input)
   },
+  "event.getPlayerStationPresence": {
+    kind: "query",
+    invoke: (client, input) => client.event.getPlayerStationPresence.query(input)
+  },
   "event.listJoined": {
     kind: "query",
     invoke: (client, input) => client.event.listJoined.query(input)
@@ -7768,6 +7788,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 +7919,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 +7990,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 +8000,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"],
@@ -8051,11 +8095,12 @@ 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 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. Fill-in-the-blank inputs support correctAnswer and acceptedAnswers (up to 50 alternatives). Optional revealMessage (up to 2,000 characters) is shown only after submitting.", ["state-change"]),
-  mutation(["mission", "update"], "event.updateMission", "Update a mission. Fill-in-the-blank inputs support acceptedAnswers; omit to preserve or pass [] to clear. Existing submissions are not re-graded. Edit revealMessage during live play; omit it to preserve or use an empty string to clear.", ["state-change"]),
+  mutation(["mission", "create"], "event.createMission", "Create a mission in a station. Fill-in-the-blank inputs support correctAnswer and acceptedAnswers (up to 50 alternatives), or config.numberRange {min,max} to accept any number in that inclusive range instead. Optional revealMessage (up to 2,000 characters) is shown only after submitting.", ["state-change"]),
+  mutation(["mission", "update"], "event.updateMission", "Update a mission. Fill-in-the-blank inputs support acceptedAnswers; omit to preserve or pass [] to clear. Set config.numberRange {min,max} for a numeric range answer; omit config to preserve or pass null to return to text answers. Existing submissions are not re-graded. Edit revealMessage during live play; omit it to preserve or use an empty string to clear.", ["state-change"]),
   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"
@@ -8068,7 +8113,7 @@ 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"]),
+  mutation(["event", "set-gameplay"], "team.setGameplaySettings", "Set open or sequential progression, group routing, and per-mission skipping before play starts. Station skipping and requireLocationOnSubmit stay editable live.", ["state-change"]),
   query(["routing-group", "list"], "team.listRoutingGroups", "List an event's routing groups, ordered stations, and assigned teams."),
   query(["routing-group", "release-history"], "team.listRoutingGroupReleaseHistory", "Show a routing group's five most recent release changes with actor, action and before/after UTC values."),
   mutation(["routing-group", "release"], "team.updateRoutingGroupRelease", "Schedule (future releaseAt ISO timestamp with offset), CLEAR schedule, HOLD, RELEASE_SCHEDULED_HOLD (keep schedule), or RELEASE_NOW for a routing group. After a group starts, only HOLD and RELEASE_SCHEDULED_HOLD are accepted. Requires launchEvent permission.", ["state-change"]),
@@ -8098,6 +8143,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 +8162,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"]),
@@ -8128,6 +8176,7 @@ var commands = [
   query(["player", "map"], "event.getPlayerMap", "Get the player event map."),
   query(["player", "shell"], "event.getPlayerShell", "Get the player application shell."),
   query(["player", "station"], "event.getPlayerStation", "Get a playable station."),
+  query(["player", "station", "presence"], "event.getPlayerStationPresence", "Check whether a location is within a station's submit range when the event asks players to stay at the station to submit. Returns a state and rounded distance, never coordinates."),
   query(["player", "events"], "event.listJoined", "List events joined by the current user.", { input: "none" }),
   query(["player", "broadcasts"], "event.listPlayerBroadcasts", "List broadcasts visible to the current player."),
   query(["player", "broadcast"], "event.getPlayerBroadcast", "Get one broadcast visible to the current player."),
@@ -8144,6 +8193,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 +8225,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.5.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",
@@ -19,7 +19,7 @@
   ],
   "dependencies": {
     "@trpc/client": "^11.19.0",
-    "dotenv": "^18.0.8",
+    "dotenv": "^18.0.9",
     "superjson": "^2.2.6"
   },
   "engines": {