@go-labs-sg/gosh 1.1.0 → 1.2.0

package/README.md

@@ -110,6 +110,53 @@ Commands use `--input '<json>'` for the exact validated tRPC input object. This
 
 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 --filter @go-labs-sg/gosh generate:commands` from the repository root to regenerate the manifest, reference, and typed operations.
 
+### Messages after submitting
+
+`gosh mission create` and `gosh mission update` accept optional `revealMessage`
+plain text (up to 2,000 characters, with line breaks) in `--input`. It is hidden
+from players until their team/player has a submission, regardless of review
+status. Skipping a mission does not reveal it. The player submit response includes
+`revealMessage`, including already-completed submissions; station and map reads
+include it only on submitted missions.
+
+```bash
+gosh mission create \
+  --input '{"stationId":"station-id","name":"Pavilion materials","type":"FILL_IN_THE_BLANK","points":10,"correctAnswer":"grocery bags","revealMessage":"The pavilion is clad with grocery bags.\nNotice how everyday materials are reused."}' \
+  --target station-id \
+  --allow-state-change
+```
+
+For updates, send the existing mission editor fields (including option IDs and
+answer keys) together with `missionId` and `revealMessage`. Omitting
+`revealMessage` preserves it; `"revealMessage":""` clears it. The message is
+display-only and can change during a live event without changing grading or
+saved playthroughs. Templates, station clones and event versions preserve it.
+
+### Multiple accepted text answers
+
+Fill-in-the-blank missions accept the primary `correctAnswer` or any of up to 50
+`acceptedAnswers` (each trimmed, non-empty and at most 200 characters). Case and
+repeated whitespace are ignored; no fuzzy or partial matching is used. Duplicate
+alternatives are removed after normalization. Alternatives require a primary
+answer and cannot be used for other mission types.
+
+```bash
+gosh mission create --input '{"stationId":"station-id","name":"Climbing plants","type":"FILL_IN_THE_BLANK","correctAnswer":"Mesh","acceptedAnswers":["Trellis","Scaffolding"]}'
+gosh mission update --input '{"missionId":"mission-id","name":"Climbing plants","type":"FILL_IN_THE_BLANK","correctAnswer":"Mesh","acceptedAnswers":["Trellis","Frame","Scaffolding"]}'
+```
+
+When updating, omit `acceptedAnswers` to preserve the saved list or pass `[]` to
+clear it. Alternative-answer changes affect future submissions only: stored
+answers and awarded points are never re-graded. Existing restrictions on changing
+the primary answer, mission type and choice options after submissions still apply.
+Templates, station clones and saved event versions preserve alternatives. Answer
+keys are visible to authorized admins/reviewers, never in player mission reads.
+
+Deploy prerequisite: apply the additive GOSH database schema changes for both
+`Mission.acceptedAnswers` and `GoshTemplateMission.acceptedAnswers`, each defaulting
+to `[]`, before deploying the updated server. Older event snapshots restore an
+empty list. Client generation alone does not apply these database changes.
+
 ### Templates and organization scope
 
 Template commands use the selected organization as their scope. Provide its ID in

package/command-manifest.json

@@ -791,7 +791,7 @@
 		"path": ["mission", "create"],
 		"procedure": "event.createMission",
 		"requiresAuth": true,
-		"summary": "Create a mission in a station.",
+		"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.",
 		"targetKeys": [
 			"id",
 			"memberId",
@@ -823,7 +823,7 @@
 		"path": ["mission", "update"],
 		"procedure": "event.updateMission",
 		"requiresAuth": true,
-		"summary": "Update a mission.",
+		"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.",
 		"targetKeys": [
 			"id",
 			"memberId",
@@ -2315,7 +2315,7 @@
 		"path": ["player", "mission", "submit"],
 		"procedure": "event.submitMission",
 		"requiresAuth": true,
-		"summary": "Submit a mission response.",
+		"summary": "Submit a mission response and return revealMessage, including already-completed submissions.",
 		"targetKeys": [
 			"id",
 			"memberId",

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.
+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.
 
 - Authentication: browser-authenticated CLI session required
 - Input: `--input '<json>'` required
@@ -340,7 +340,7 @@ Create a mission in a station.
 
 ## `gosh mission update`
 
-Update a mission.
+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.
 
 - Authentication: browser-authenticated CLI session required
 - Input: `--input '<json>'` required
@@ -940,7 +940,7 @@ Permanently skip one unresolved mission for zero points when enabled; retain oth
 
 ## `gosh player mission submit`
 
-Submit a mission response.
+Submit a mission response and return revealMessage, including already-completed submissions.
 
 - Authentication: browser-authenticated CLI session required
 - Input: `--input '<json>'` required

package/dist/index.js

@@ -8017,10 +8017,8 @@ 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.", ["state-change"]),
-  mutation(["mission", "update"], "event.updateMission", "Update a mission.", [
-    "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", "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."),
@@ -8104,7 +8102,7 @@ var commands = [
   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"]),
+  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 }),
   mutation(["public", "request-login-code"], "event.requestLoginEmailOtp", "Send an event login email code.", ["email", "external-write"], { requiresAuth: false }),

package/package.json

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