@go-labs-sg/gosh 0.12.0 → 0.14.0

package/README.md

@@ -97,7 +97,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 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.
+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.
 
 ### Templates and organization scope
 
@@ -183,8 +183,9 @@ value in that template team's `order` field:
 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
+assign them to routing groups before launching the event; sequential setup
+freezes when play starts. Grouped OPEN events lock only a started team's group
+assignment, a started group's route and the gameplay settings. 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
@@ -225,6 +226,43 @@ 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.
 
+### Staggered group release
+
+`routing-group release` changes flag-off without changing routes. It requires
+launch permission and a draft, ready or live TEAM event with group routing. A
+different group already playing does not block it. Once a team in the target
+group has started, only HOLD (emergency hold) and RELEASE_SCHEDULED_HOLD (resume)
+are accepted.
+
+```bash
+gosh routing-group release \
+  --input '{"eventId":"event-id","groupId":"group-d","action":"SCHEDULE","releaseAt":"2030-01-01T09:20:00+08:00"}' \
+  --target group-d \
+  --allow-state-change
+gosh routing-group release \
+  --input '{"eventId":"event-id","groupId":"group-d","action":"HOLD"}' \
+  --target group-d \
+  --allow-state-change
+```
+
+Replace example IDs/time with your intended target and a future instant.
+SCHEDULE requires an ISO timestamp with `Z` or a numeric timezone offset;
+offsetless, invalid and past times are rejected. CLEAR sets the schedule to null
+but preserves a hold. HOLD overrides the clock. RELEASE_SCHEDULED_HOLD removes
+the hold and retains the schedule; an elapsed/no schedule releases immediately.
+RELEASE_NOW clears both schedule and hold. Omit `releaseAt` for non-schedule
+actions. Repeated no-op controls do not create duplicate audits. List routing
+groups to read back release values and editability, and use
+`gosh routing-group release-history --input '{"eventId":"event-id","groupId":"group-d"}'`
+for the five most recent actor/before/after changes; the existing event activity
+timeline provides the full audit history.
+
+The server evaluates deadlines without cron. Release never starts a timer or
+bypasses LIVE status, availability, check-in or captain permissions. Any team in
+a group beginning play locks that group's schedule; emergency HOLD/resume stays
+available and does not pause running station clocks. There is no
+untimed practice-mission exemption. See [the design notes](../../../docs/design/gosh-staggered-routing-group-release.md).
+
 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.
@@ -358,6 +396,20 @@ Without the allow flags, an interactive terminal prints a workflow preview and r
 
 One-shot commands write one JSON envelope to stdout. Watch commands write newline-delimited JSON envelopes. Failures and opt-in `--debug` diagnostics go to stderr, and known secrets, payloads, join codes, share tokens, and signed URLs are redacted. `--quiet` or `-q` suppresses diagnostics.
 
+## Monorepo development
+
+Follow the [development workflow](../../../docs/development-workflow.md#required-cli-coverage). App/API changes affecting this CLI must update its commands, types/input-output contracts, help/docs and verification in the same change. Use the existing authenticated product API rather than CLI-only business logic. Presentation-only changes do not require CLI edits; record why when no CLI update was needed.
+
+From the repository root after isolated-worktree initialization:
+
+```bash
+bun --filter @go-labs-sg/gosh typecheck
+bun --filter @go-labs-sg/gosh build
+bun run packages/gosh/cli/src/index.ts help
+```
+
+Building is not publication or permission to mutate live data. Use focused temporary business-behavior tests and the final pre-push gate from the shared workflow. Its existing build regenerates command artifacts; review the manifest/reference and typed operations after registry changes.
+
 ## Release verification
 
 The `gosh-cli-v*` release workflow runs

package/command-manifest.json

@@ -1173,6 +1173,25 @@
 		"requiresAuth": true,
 		"summary": "List an event's routing groups, ordered stations, and assigned teams."
 	},
+	{
+		"effects": [],
+		"input": "json",
+		"operation": "query",
+		"path": ["routing-group", "release-history"],
+		"procedure": "team.listRoutingGroupReleaseHistory",
+		"requiresAuth": true,
+		"summary": "Show a routing group's five most recent release changes with actor, action and before/after UTC values."
+	},
+	{
+		"effects": ["state-change"],
+		"input": "json",
+		"operation": "mutation",
+		"path": ["routing-group", "release"],
+		"procedure": "team.updateRoutingGroupRelease",
+		"requiresAuth": true,
+		"summary": "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.",
+		"targetKeys": ["groupId", "eventId"]
+	},
 	{
 		"effects": ["state-change"],
 		"input": "json",

package/command-reference.md

@@ -450,6 +450,22 @@ List an event's routing groups, ordered stations, and assigned teams.
 - Input: `--input '<json>'` required
 - Effects: read-only
 
+## `gosh routing-group release-history`
+
+Show a routing group's five most recent release changes with actor, action and before/after UTC values.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: read-only
+
+## `gosh routing-group release`
+
+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.
+
+- Authentication: browser-authenticated CLI session required
+- Input: `--input '<json>'` required
+- Effects: state-change
+
 ## `gosh routing-group create`
 
 Create a routing group within an event before play starts.

package/dist/index.js

@@ -35,16 +35,16 @@ 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.5/node_modules/dotenv/dist/index.cjs
+// ../../../node_modules/.bun/dotenv@18.0.6/node_modules/dotenv/dist/index.cjs
 var require_dist = __commonJS(function(exports, module) {
-  var I = (e, o) => () => {
+  var S = (e, o) => () => {
     try {
       return o || e((o = { exports: {} }).exports, o), o.exports;
     } catch (t) {
       throw o = 0, t;
     }
   };
-  var S = I((xe, U) => {
+  var j = S((xe, U) => {
     function G(e) {
       return typeof e == "string" ? !["false", "0", "no", "off", ""].includes(e.toLowerCase()) : !!e;
     }
@@ -58,8 +58,8 @@ var require_dist = __commonJS(function(exports, module) {
     }
     U.exports = { parseBoolean: G, optionsFromEnv: X };
   });
-  var N = I((ye, x) => {
-    var Y = __require("fs"), j = __require("path"), z = __require("os"), { URL: Z, fileURLToPath: ee } = __require("url"), { parseBoolean: k, optionsFromEnv: B } = S(), te = /(?:^|^)\s*(?:export\s+)?([\w.-]+)(?:\s*=\s*?|:\s+?)(\s*'(?:\\'|[^'])*'|\s*"(?:\\"|[^"])*"|\s*`(?:\\`|[^`])*`|[^#\r\n]+)?\s*(?:#.*)?(?:$|$)/mg, b = new Uint8Array(256);
+  var N = S((ye, x) => {
+    var Y = __require("fs"), k = __require("path"), z = __require("os"), { URL: Z, fileURLToPath: ee } = __require("url"), { parseBoolean: $, optionsFromEnv: B } = j(), te = /(?:^|^)\s*(?:export\s+)?([\w.-]+)(?:\s*=\s*?|:\s+?)(\s*'(?:\\'|[^'])*'|\s*"(?:\\"|[^"])*"|\s*`(?:\\`|[^`])*`|[^#\r\n]+)?\s*(?:#.*)?(?:$|$)/mg, b = new Uint8Array(256);
     for (let e = 48;e <= 57; e++)
       b[e] = 1;
     for (let e = 65;e <= 90; e++)
@@ -185,7 +185,7 @@ var require_dist = __commonJS(function(exports, module) {
       return o;
     }
     function ne(e, o) {
-      return o && k(o.fast) ? oe(e) : re(e);
+      return o && $(o.fast) ? oe(e) : re(e);
     }
     function T(e) {
       console.log(`\u2506 ${e}`);
@@ -194,16 +194,16 @@ var require_dist = __commonJS(function(exports, module) {
       console.error(`\u25C7 ${e}`);
     }
     function V(e) {
-      return e[0] === "~" ? j.join(z.homedir(), e.slice(1)) : e;
+      return e[0] === "~" ? k.join(z.homedir(), e.slice(1)) : e;
     }
     function ie(e = {}) {
       return { ...B(), ...e };
     }
     function ce(e) {
       e = ie(e);
-      let o = j.resolve(process.cwd(), ".env"), t = "utf8", n = process.env;
+      let o = k.resolve(process.cwd(), ".env"), t = "utf8", n = process.env;
       e && e.processEnv != null && (n = e.processEnv);
-      let r = k(e && e.debug);
+      let r = $(e && e.debug);
       e && e.encoding ? t = e.encoding : r && T("no encoding is specified (UTF-8 is used by default)");
       let s = [o];
       if (e && e.path)
@@ -222,12 +222,12 @@ var require_dist = __commonJS(function(exports, module) {
         } catch (a) {
           r && T(`failed to load ${c} ${a.message}`), i = a;
         }
-      let p = A.populate(n, l, e), f = k(Object.prototype.hasOwnProperty.call(e, "quiet") ? e.quiet : B(n).quiet);
+      let p = A.populate(n, l, e), f = $(Object.prototype.hasOwnProperty.call(e, "quiet") ? e.quiet : B(n).quiet);
       if (r || !f) {
         let c = Object.keys(p).length, a = [];
         for (let g of s)
           try {
-            let h = j.relative(process.cwd(), g instanceof Z ? ee(g) : g);
+            let h = k.relative(process.cwd(), g instanceof Z ? ee(g) : g);
             a.push(h);
           } catch (h) {
             r && T(`failed to load ${g} ${h.message}`), i = h;
@@ -240,7 +240,7 @@ var require_dist = __commonJS(function(exports, module) {
       return A.configDotenv(e);
     }
     function le(e, o, t = {}) {
-      let n = !!(t && t.debug), r = !!(t && t.override), s = {};
+      let n = $(t && t.debug), r = $(t && t.override), s = {};
       if (e === null || typeof e != "object" || o === null || typeof o != "object") {
         let i = new Error("OBJECT_REQUIRED: Please check the processEnv argument being passed to populate");
         throw i.code = "OBJECT_REQUIRED", i;
@@ -256,7 +256,7 @@ var require_dist = __commonJS(function(exports, module) {
     x.exports.populate = A.populate;
     x.exports = A;
   });
-  var M = I((Te, W) => {
+  var M = S((Te, W) => {
     var _ = __require("child_process"), fe = __require("fs"), L = __require("path");
     function ue(e) {
       let o = ['"'], t = 0;
@@ -309,9 +309,9 @@ var require_dist = __commonJS(function(exports, module) {
     }
     W.exports = pe;
   });
-  var K = I(($e, F) => {
-    var he = __require("fs"), ge = __require("os"), Q = __require("path"), me = __require("child_process"), ve = M(), R = N(), { optionsFromEnv: Ce } = S();
-    function $() {
+  var K = S(($e, F) => {
+    var he = __require("fs"), ge = __require("os"), Q = __require("path"), me = __require("child_process"), ve = M(), R = N(), { optionsFromEnv: Ce } = j();
+    function D() {
       console.log(["Usage: dotenv run [--help] [-q|--quiet] [--debug] [--override] [--fast] [-f|--file <paths>] [--] <command> [args...]", "", "Run a command with environment variables from a .env file.", "Place dotenv options before the command; all following arguments go to the command.", "", "Options:", "  -f, --file <paths>  .env paths, comma-separated or repeated (default: .env)", "  -q, --quiet suppress the injected env message", "  --debug     enable debug logging", "  --override  override existing environment variables", "  --fast      use the faster character-scanner parser", "", "Environment variables (DOTENV_CONFIG_* names remain as fallbacks):", "  DOTENV_PATH, DOTENV_ENCODING, DOTENV_QUIET,", "  DOTENV_DEBUG, DOTENV_OVERRIDE,", "  DOTENV_FAST"].join(`
 `));
     }
@@ -383,24 +383,24 @@ var require_dist = __commonJS(function(exports, module) {
     function J(e) {
       let o = e[0];
       if (o === "--help" || o === "-h") {
-        $();
+        D();
         return;
       }
       if (o !== "run") {
-        $(), process.exitCode = 1;
+        D(), process.exitCode = 1;
         return;
       }
       let t = we(e.slice(1));
       if (t.help) {
-        $();
+        D();
         return;
       }
       if (t.error) {
-        console.error(`dotenv: ${t.error}`), $(), process.exitCode = 1;
+        console.error(`dotenv: ${t.error}`), D(), process.exitCode = 1;
         return;
       }
       if (t.command.length === 0) {
-        $(), process.exitCode = 1;
+        D(), process.exitCode = 1;
         return;
       }
       let n = Ee(t);
@@ -456,13 +456,13 @@ var require_dist = __commonJS(function(exports, module) {
     F.exports = J;
     F === __require.main && J(process.argv.slice(2));
   });
-  var D = N();
+  var I = N();
   var Oe = K();
-  module.exports = D;
-  module.exports.config = D.config;
-  module.exports.configDotenv = D.configDotenv;
-  module.exports.parse = D.parse;
-  module.exports.populate = D.populate;
+  module.exports = I;
+  module.exports.config = I.config;
+  module.exports.configDotenv = I.configDotenv;
+  module.exports.parse = I.parse;
+  module.exports.populate = I.populate;
 });
 
 // src/load-env.ts
@@ -7453,6 +7453,14 @@ var typedOperations = {
     kind: "query",
     invoke: (client, input) => client.team.listRoutingGroups.query(input)
   },
+  "team.listRoutingGroupReleaseHistory": {
+    kind: "query",
+    invoke: (client, input) => client.team.listRoutingGroupReleaseHistory.query(input)
+  },
+  "team.updateRoutingGroupRelease": {
+    kind: "mutation",
+    invoke: (client, input) => client.team.updateRoutingGroupRelease.mutate(input)
+  },
   "team.createRoutingGroup": {
     kind: "mutation",
     invoke: (client, input) => client.team.createRoutingGroup.mutate(input)
@@ -7865,6 +7873,7 @@ var defaultMutationTargetKeys = [
   "name"
 ];
 var mutationTargetKeys = {
+  "team.updateRoutingGroupRelease": ["groupId", "eventId"],
   "team.setGameplaySettings": ["eventId"],
   "team.createRoutingGroup": ["eventId"],
   "team.renameRoutingGroup": ["groupId"],
@@ -7985,6 +7994,8 @@ var commands = [
   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."),
+  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"]),
   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"]),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@go-labs-sg/gosh",
-  "version": "0.12.0",
+  "version": "0.14.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.1",
+    "dotenv": "^18.0.6",
     "superjson": "^2.2.6"
   },
   "engines": {