@maka/maka-cli 5.148.0 → 5.150.0

package/bundle/typescript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maka/maka-cli",
-  "version": "5.148.0",
+  "version": "5.150.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

@@ -38,10 +38,11 @@ export class BacklogCommand extends Command {
     static verb = "backlog";
     // Writes to the player OWN board over their auth token -- never an NPC.
     static humanOnly = true;
-    static description = 'File a play-tester item that somebody acts on -- it goes to maka-cli.com, keeps a link to this session, and comes back checked against the rulebooks. "backlog <what you noticed>" files one; "backlog list [status]" reads the board. For private scribbles, use "note".';
+    static description = 'File a play-tester item that somebody acts on -- it goes to maka-cli.com, keeps a link to this session, and comes back checked against the rulebooks. "backlog <what you noticed>" files one; "backlog list [status]" reads the board; "backlog web" opens the live board in your browser. For private scribbles, use "note".';
     static subcommands = [
         { usage: 'backlog <text>', short: 'File an item against this session.' },
         { usage: 'backlog list', short: 'The whole board, what needs you last.' },
+        { usage: 'backlog web', short: 'Open the live backlog board in your browser.' },
         { usage: 'backlog <n>', short: 'Read board item n in full.' },
         { usage: 'backlog repro <n>', short: 'Play the repro bench for board item n.' },
         { usage: 'backlog close <n> [why]', short: 'Close item n outright -- filed in error, duplicate, no longer real.' },
@@ -71,6 +72,12 @@ export class BacklogCommand extends Command {
         if (args.length === 0 || sub === 'list') {
             return this.list(args[1]);
         }
+        // Claimed here, same reason "accept"/"reject"/"repro"/"close" are:
+        // every unclaimed word past this point is report text, and "backlog
+        // web" must open the board, not file an item whose text is "web".
+        if (sub === 'web') {
+            return this.webBoard();
+        }
         // A BARE NUMBER READS THAT ROW OF THE BOARD, and it has to be caught
         // here for the same reason `list` and `review` are: everything that
         // reaches the bottom of this method FILES AN ITEM. Without this,
@@ -118,6 +125,23 @@ export class BacklogCommand extends Command {
         }
         return this.file(args.join(' '));
     }
+    /**
+     * "backlog web" (user request, 2026-09-10): the same /cli-login
+     * handoff as "sheet web" (sheet.ts), landing on the shared board --
+     * /backlog, already on the NEXT_ALLOWLIST. The token is guaranteed
+     * present here: execute() already refused above if authToken() was
+     * empty, before any subcommand (this one included) could be reached.
+     */
+    async webBoard() {
+        const { buildBacklogBoardUrl } = 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');
+    }
     async file(text) {
         const game = this.game;
         // LAZY, and not for speed: shared-run.ts pulls in tools/version/

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

@@ -51,6 +51,21 @@ export class LookCommand extends Command {
                 return `${containerHit.description}\n  Open. ${items.length === 0 ? 'Empty.'
                     : `Inside: ${items.map(i => i.quantity > 1 ? `${i.name} ×${i.quantity}` : i.name).join(', ')}.`}`;
             }
+            // "look deck" (W7fzZRb6Asa7Qqjzg): a decker's cyberdeck is
+            // usually branded gear ("Sony CIY-720"), not literally named
+            // "deck" -- so the generic name-match below missed it entirely
+            // and "look deck" read "You cannot see deck" even carrying one.
+            // Resolved through the SAME lookup "deck" (deck.ts) already uses
+            // for the active/best-carried deck, then handed to the ordinary
+            // inspectItem by its real name so the two verbs describe one
+            // object identically.
+            if (target === 'deck') {
+                const carried = this.actor.getAnyCyberdeck();
+                if (carried) {
+                    this.logger.write(`Looking at active deck '${carried.name}' in ${this.actor.name} inventory.`);
+                    return this.inspectItem(carried.name, this.actor.inventory);
+                }
+            }
             if (this.actor.inventory.hasItem(target)) {
                 this.logger.write(`Looking at item '${target}' in ${this.actor.name} inventory.`);
                 return this.inspectItem(target, this.actor.inventory);

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

@@ -185,6 +185,7 @@ import { clockTime, worldNow } from './utilities/world-clock.js';
 import { CommandFactory } from './factories/command-factory.js';
 import { SceneSynthesizer } from './factories/scene-factory.js';
 import { SceneSeedGenerator, FIXER_NAME, isFixerName } from './factories/scene-seed-generator.js';
+import { draftFailureNote } from './utilities/draft-failure-note.js';
 import { CALL_ICON, CALL_COLOR, END_CALL_SENTINEL } from './utilities/comm-style.js';
 import { AI } from '../../../tools/ai/ai.class.js';
 import { BULLET } from './utilities/log-style.js';
@@ -4147,33 +4148,7 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         // caller but the ask-for-data-work door passes.
         const nextSeed = await SceneSeedGenerator.generate(this._logFilePath, nextTier, this.player, this.activeRumor, localCrew, undefined, runType);
         if (!nextSeed) {
-            // NAME the cause when it's the PROVIDER, not luck (real session:
-            // six Krow calls into an out-of-credits key, indistinguishable
-            // from flaky clients). Credit/auth failures are the player's to
-            // fix -- say so, out of character, once per ping.
-            const why = SceneSeedGenerator.lastFailure ?? '';
-            // TELL THE TRUTH ABOUT WHOSE FAULT IT IS (playtest 2026-08-26).
-            // The old test carried `invalid.*key`, meant for "invalid API
-            // key" -- but `.*` spans the whole message, so a skeleton
-            // validation error reading "Skeleton INVALID: ... locked doors
-            // and KEY placements" matched, and a map-generation bug was
-            // reported to the player as a billing problem. Sending someone to
-            // rotate a working key is worse than saying nothing.
-            //
-            // Every pattern here is now anchored to the phrase it actually
-            // means: a bare "invalid" or a stray "key" no longer counts, and
-            // the status codes need word boundaries so they can't match
-            // inside some other number.
-            const providerDown = /credit balance|billing|quota|insufficient (?:credit|fund|quota|balance)|invalid[\s_-]*api[\s_-]*key|api[\s_-]*key (?:is )?(?:invalid|expired|missing|not)|unauthorized|authentication|\b(?:401|403|429)\b|Plans & Billing/i.test(why);
-            // A structural failure is OURS, not the player's -- name it as
-            // the generator's problem so nobody goes hunting their billing
-            // page, and keep it short: the fiction already covers the beat.
-            const structural = !providerDown && /^Skeleton invalid|validation failed|isn't placed|unreachable from the start/i.test(why);
-            const opsNote = providerDown
-                ? `\n{yellow-fg}(Out of character: the AI provider refused -- "${why.slice(0, 120)}". Jobs can't generate until the API key/credits are fixed.){/yellow-fg}`
-                : structural
-                    ? `\n{yellow-fg}(Out of character: the job generator couldn't lay out a solvable map this time -- nothing wrong with your key or credits. Call again; the next draft usually takes.){/yellow-fg}`
-                    : '';
+            const opsNote = draftFailureNote(SceneSeedGenerator.lastFailure ?? '');
             return `Incoming call -- ${FIXER_NAME}: "Job fell through, chummer. Client got cold feet before the ink dried. Give me another call in a bit -- I'll shake something loose."${opsNote}`;
         }
         // HUB sessions: the draft lands as a MESSAGE, never a teleport (real

package/bundle/typescript/src/commands/game/sideQuest/utilities/draft-failure-note.js

@@ -0,0 +1,66 @@
+/**
+ * THE OUT-OF-CHARACTER NOTE ON A FAILED JOB DRAFT (game.ts's
+ * draftNextScene). SceneSeedGenerator.generate() gives up after three
+ * pipeline attempts and hands back a bare error string; Krow's "Job
+ * fell through" callback fires either way, and this decides what --
+ * if anything -- rides after it, so the player can tell "you did
+ * something wrong" from "this is on us" from "pure bad luck, try
+ * again."
+ *
+ * Extracted to its own module (2026-09-10) so the classification --
+ * pure string matching against known provider/generator error prose --
+ * can be pinned directly, without standing up a Game instance or
+ * mocking SceneSeedGenerator to reach it.
+ *
+ * TELL THE TRUTH ABOUT WHOSE FAULT IT IS (playtest 2026-08-26). The old
+ * test carried `invalid.*key`, meant for "invalid API key" -- but `.*`
+ * spans the whole message, so a skeleton validation error reading
+ * "Skeleton INVALID: ... locked doors and KEY placements" matched, and
+ * a map-generation bug was reported to the player as a billing problem.
+ * Sending someone to rotate a working key is worse than saying nothing.
+ * Every pattern here is anchored to the phrase it actually means: a
+ * bare "invalid" or a stray "key" no longer counts, and the status
+ * codes need word boundaries so they can't match inside some other
+ * number.
+ */
+export function draftFailureNote(why) {
+    // NAME THE CAUSE WHEN IT'S THE PROVIDER, NOT LUCK (real session: six
+    // Krow calls into an out-of-credits key, indistinguishable from flaky
+    // clients). Credit/auth failures are the player's to fix -- say so,
+    // out of character, once per ping.
+    // Widened 2026-09-10: the site's own current wording (ai-error-envelope.ts
+    // classifyUpstream's upstream_billing branch) reads "has run out of
+    // credit at its provider, or its key was rejected" -- neither phrase
+    // matched any pattern below, so the ORIGINAL motivating bug (the "six
+    // Krow calls into an out-of-credits key" session) would silently fall
+    // through to no note again today, on the site's real current message.
+    const providerDown = /credit balance|billing|quota|insufficient (?:credit|fund|quota|balance)|run out of credit|key was rejected|invalid[\s_-]*api[\s_-]*key|api[\s_-]*key (?:is )?(?:invalid|expired|missing|not)|unauthorized|authentication|\b(?:401|403|429)\b|Plans & Billing/i.test(why);
+    // TRANSIENT INFRASTRUCTURE, not billing and not a generation bug
+    // (real session, e8dLKM9j5P9yQn5yz's sibling report: a fresh
+    // character's very first homecoming draft, plus four manual "call
+    // Krow" retries, all failed in under half a second each against "The
+    // AI provider behind maka-cli.com is overloaded or down" --
+    // ai-error-envelope.ts's upstream_unavailable/rate_limited/
+    // upstream_timeout/upstream_error text, none of which this classifier
+    // recognized, so every one of those five calls read as the same
+    // unexplained "Job fell through" with nothing after it --
+    // indistinguishable from a broken loop rather than one outage. These
+    // are OURS and retryable, same tone as `structural` below, but a
+    // different truth: nothing was malformed, the provider just wasn't
+    // answering. Matched on the SITE'S OWN wording (ai-error-envelope.ts
+    // classifyUpstream/classifyTransportFailure) rather than status
+    // codes, since only the prose crosses the wire.
+    const providerOutage = !providerDown && /overloaded or down|rate-limited by its provider|took too long to answer|could not (?:complete that request|reach its ai provider)/i.test(why);
+    // A structural failure is OURS, not the player's -- name it as the
+    // generator's problem so nobody goes hunting their billing page, and
+    // keep it short: the fiction already covers the beat.
+    const structural = !providerDown && !providerOutage && /^Skeleton invalid|validation failed|isn't placed|unreachable from the start/i.test(why);
+    return providerDown
+        ? `\n{yellow-fg}(Out of character: the AI provider refused -- "${why.slice(0, 120)}". Jobs can't generate until the API key/credits are fixed.){/yellow-fg}`
+        : providerOutage
+            ? `\n{yellow-fg}(Out of character: the AI provider maka-cli.com talks to is overloaded, rate-limited, or unreachable right now -- nothing wrong with your account or your key. Give it a few minutes and call again.){/yellow-fg}`
+            : structural
+                ? `\n{yellow-fg}(Out of character: the job generator couldn't lay out a solvable map this time -- nothing wrong with your key or credits. Call again; the next draft usually takes.){/yellow-fg}`
+                : '';
+}
+//# sourceMappingURL=draft-failure-note.js.map

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

@@ -82,6 +82,18 @@ export function buildCharacterSheetUrl(resumeToken, slug) {
     const next = `${CHARACTERS_PAGE}/${encodeURIComponent(slug)}`;
     return `${cliLoginUrl()}?t=${Date.now()}#token=${encodeURIComponent(resumeToken)}&next=${next}`;
 }
+const BACKLOG_PAGE = '/backlog';
+/**
+ * "backlog web" (user request, 2026-09-10): the same /cli-login handoff
+ * as the live sheet, landing on the shared backlog board -- /backlog,
+ * already on cli-login-next.ts's NEXT_ALLOWLIST as a bare path. Unlike
+ * buildCharacterSheetUrl/buildDossierUrl there is no per-item deep link
+ * to validate here: the board itself is the destination, not a row on
+ * it.
+ */
+export function buildBacklogBoardUrl(resumeToken) {
+    return `${cliLoginUrl()}?t=${Date.now()}#token=${encodeURIComponent(resumeToken)}&next=${BACKLOG_PAGE}`;
+}
 /**
  * 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maka/maka-cli",
-  "version": "5.148.0",
+  "version": "5.150.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.",