@maka/maka-cli 5.158.0 → 5.159.0

package/bundle/typescript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maka/maka-cli",
-  "version": "5.158.0",
+  "version": "5.159.0",
   "type": "module",
   "summary": "A command line tool for scaffolding Meteor 3.x applications using either React.",
   "description": "A command line tool for scaffolding Meteor 3.x applications using React.",

package/bundle/typescript/src/commands/game/sideQuest/commands/backlog.js

@@ -133,14 +133,11 @@ export class BacklogCommand extends Command {
      * empty, before any subcommand (this one included) could be reached.
      */
     async webBoard() {
-        const { buildBacklogBoardUrl } = await import('../utilities/web-character-generator.js');
+        const { buildBacklogBoardUrl, backlogBoardHandoff } = await import('../utilities/web-character-generator.js');
         const url = buildBacklogBoardUrl(authToken());
         const { openBrowser } = await import('../../../../tools/browser/open-browser.js');
         openBrowser(url);
-        return [
-            `Your backlog board is opening in the browser -- the game keeps running right here.`,
-            `  ${url}`,
-        ].join('\n');
+        return backlogBoardHandoff(url, { gameRunning: true }).join('\n');
     }
     async file(text) {
         const game = this.game;

package/bundle/typescript/src/commands/game/sideQuest/utilities/web-character-generator.js

@@ -94,6 +94,23 @@ const BACKLOG_PAGE = '/backlog';
 export function buildBacklogBoardUrl(resumeToken) {
     return `${cliLoginUrl()}?t=${Date.now()}#token=${encodeURIComponent(resumeToken)}&next=${BACKLOG_PAGE}`;
 }
+/**
+ * WHAT IS SAID WHEN THE BOARD OPENS -- one wording for both doors into
+ * it: the in-game "backlog web" (the game keeps running) and the
+ * launcher's `maka play:backlog --web` (user request, 2026-09-10: "can
+ * I get a maka play:backlog --web to view the backlog in the browser?").
+ * The URL is ALWAYS in the lines, for the same reason
+ * characterForgeHandoff spells out: openBrowser is fire-and-forget, so
+ * the printed URL is the only thing that works headless or over SSH.
+ */
+export function backlogBoardHandoff(url, opts) {
+    return [
+        opts.gameRunning
+            ? `Your backlog board is opening in the browser -- the game keeps running right here.`
+            : `Your backlog board is opening in the browser.`,
+        `  ${url}`,
+    ];
+}
 /**
  * WHAT THE CLI SAYS ON ITS WAY OUT of the chargen handoff. Extracted
  * from the command handler so the two things that matter about it are

package/bundle/typescript/src/commands/game/sideQuest-backlog.sub.cmd.js

@@ -1,12 +1,13 @@
 import ShadowrunCommand, { ShadowrunCompat } from './sideQuest.sub.cmd.js';
 import { Command } from '../../command.js';
+import { Log } from '../../tools/log/log.class.js';
 import { registerBacklogMcp } from './sideQuest-backlog-mcp.sub.cmd.js';
 // Registered under BOTH the new spelling (play:backlog) and the compat
 // sub (play:shadowrun:backlog) from ONE definition -- two commands, one
 // options object, one handler, so the pair cannot drift.
 const registerBacklog = (parent) => Command.create({
     name: 'backlog',
-    usage: 'maka play:backlog [<item id>]',
+    usage: 'maka play:backlog [<item id>] [--web]',
     shortDesc: 'Read the play-tester board without starting a game.',
     description: `The play-tester backlog on maka-cli.com: what has been reported, what
   the rulebooks made of it, what closed it, and which items ship a repro
@@ -21,9 +22,11 @@ const registerBacklog = (parent) => Command.create({
         { name: 'all', boolFlag: true, description: 'Include closed items, which are hidden by default.' },
         { name: 'close', boolFlag: true, description: 'With an item id: close it outright -- filed in error, duplicate, no longer real. Remaining words are the reason.' },
         { name: 'detach', description: 'With an item id: take a wrongly attached commit back off it (a full sha, or several separated by commas). Admin only. Remaining words say why.' },
+        { name: 'web', boolFlag: true, description: 'Open the live board in your browser (the same handoff as "backlog web" in-game) instead of printing it here.' },
     ],
     examples: [
         'maka play:backlog',
+        'maka play:backlog --web',
         'maka play:backlog --filter in-review',
         'maka play:backlog --commit 359ad1fe',
         'maka play:backlog b9YeNqTNBJuk9dbrk',
@@ -31,6 +34,26 @@ const registerBacklog = (parent) => Command.create({
         'maka play:backlog b9YeNqTNBJuk9dbrk --detach 7ed04359 attached to the wrong row',
     ],
 }, async function (args, opts) {
+    // `--web` (user request, 2026-09-10): the browser board, from the
+    // launcher. Same /cli-login handoff the in-game "backlog web" uses --
+    // one URL builder, one wording -- and nothing else below runs: opening
+    // a page is not a dump with extra steps. Checked FIRST so it never
+    // needs the board fetched to say where the board is.
+    if (opts.web === true) {
+        const { authToken } = await import('./sideQuest/utilities/cloud-saves.js');
+        const token = authToken();
+        if (!token) {
+            Log.error('The backlog runs on your maka-cli.com login -- run `maka login` first.');
+            return;
+        }
+        const { buildBacklogBoardUrl, backlogBoardHandoff } = await import('./sideQuest/utilities/web-character-generator.js');
+        const url = buildBacklogBoardUrl(token);
+        const { openBrowser } = await import('../../tools/browser/open-browser.js');
+        openBrowser(url);
+        for (const line of backlogBoardHandoff(url, { gameRunning: false }))
+            Log.info(line);
+        return;
+    }
     const { dumpBacklog } = await import('./sideQuest/utilities/backlog-dump.js');
     // `--close` STILL ARRIVES AS A STRING when a reason follows it, even
     // here: minimist's boolean set is global to the CLI and teaching it

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maka/maka-cli",
-  "version": "5.158.0",
+  "version": "5.159.0",
   "type": "module",
   "summary": "A command line tool for scaffolding Meteor 3.x applications using either React.",
   "description": "A command line tool for scaffolding Meteor 3.x applications using React.",