@maka/maka-cli 5.64.0 → 5.65.0

package/bundle/typescript/package.json

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

package/bundle/typescript/src/commands/game/sideQuest/commands/backlog.d.ts

@@ -22,12 +22,39 @@ import { Command, ICommand } from './command.js';
 export declare class BacklogCommand extends Command implements ICommand {
     protected static verb: string;
     protected static description: string;
-    protected static subcommands: {
+    protected static subcommands: ({
         usage: string;
         short: string;
-    }[];
+        long?: undefined;
+    } | {
+        usage: string;
+        short: string;
+        long: string;
+    })[];
     execute(args?: string[]): Promise<string>;
     private file;
+    /**
+     * THE REVIEW QUEUE (user request 2026-08-27). Bare "backlog review"
+     * lists what is waiting on you, numbered 1..n; "backlog review <n>
+     * <your words>" answers item n.
+     *
+     * The numbering is the delicate part and utilities/backlog-review.ts
+     * holds the invariant: a number resolves against the snapshot the
+     * player was SHOWN, never against a fresh fetch. Answering does not
+     * renumber the list on screen either.
+     */
+    private review;
+    /** Fetch and render the queue, adopting its order as the numbering. */
+    private showQueue;
+    /**
+     * One queue row. The two kinds of request READ DIFFERENTLY on purpose
+     * even though the server models both as a question awaiting the
+     * reporter: "somebody asked about your report" and "this is fixed,
+     * can you confirm it in play" are different jobs, and a play-tester
+     * skimming a list should be able to tell at a glance which one they
+     * are being asked for.
+     */
+    private renderItem;
     private list;
     /** One item: what it says, where it stands, and what the books said. */
     private row;

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

@@ -1,8 +1,16 @@
 import { Command } from './command.js';
 import { hint } from '../utilities/hints.js';
 import { authToken } from '../utilities/cloud-saves.js';
-import { submitBacklog, fetchBacklog, BACKLOG_STATUSES, } from '../utilities/backlog.js';
+import { submitBacklog, fetchBacklog, postBacklogComment, BACKLOG_STATUSES, } from '../utilities/backlog.js';
 import { noteBacklogOutcome } from '../utilities/playtester.js';
+import { takeIndex } from '../utilities/fuzzy-match.js';
+import { optionMark } from '../utilities/log-style.js';
+import { loadReviewQueue, reviewSnapshot, reviewItemAt, markReviewAnswered, isReviewAnswered, } from '../utilities/backlog-review.js';
+/** One line of somebody's report, kept to a skimmable width. */
+function truncate(text, max) {
+    const flat = text.replace(/\s+/g, ' ').trim();
+    return flat.length <= max ? flat : `${flat.slice(0, max - 1)}…`;
+}
 /**
  * THE BACKLOG -- play-tester feedback that somebody acts on.
  *
@@ -30,6 +38,16 @@ export class BacklogCommand extends Command {
         { usage: 'backlog <text>', short: 'File an item against this session.' },
         { usage: 'backlog list', short: 'The whole board, newest first.' },
         { usage: 'backlog list <status>', short: `Filter: ${BACKLOG_STATUSES.join(', ')}.` },
+        {
+            usage: 'backlog review',
+            short: 'What the board is waiting on YOU for, numbered.',
+            long: 'Items where somebody has asked you something and is waiting: a clarifying question about a report you filed, or a fix that has landed and wants confirming in play. Listed 1..n, oldest first.',
+        },
+        {
+            usage: 'backlog review <n> <your answer>',
+            short: 'Answer item n from that list.',
+            long: 'Posts your words against item n as an answer. The numbers come from the list you were last shown and do not move when you answer one, so you can work down them. "backlog review <n>" on its own reads that item in full without replying.',
+        },
     ];
     async execute(args = []) {
         // An anonymous runner's data never leaves the machine -- the same
@@ -45,6 +63,13 @@ export class BacklogCommand extends Command {
         if (args.length === 0 || sub === 'list') {
             return this.list(args[1]);
         }
+        // "review" is checked BEFORE the fall-through to file(), or
+        // answering an item would file a new one whose text begins with the
+        // word "review" -- the same shape as `backlog open` filing an item
+        // called "open", which is why list has subcommands at all.
+        if (sub === 'review') {
+            return this.review(args.slice(1));
+        }
         return this.file(args.join(' '));
     }
     async file(text) {
@@ -78,6 +103,122 @@ export class BacklogCommand extends Command {
             return this.explain(outcome);
         return `{cyan-fg}Filed. It'll come back checked against the books.${hint(` ("backlog list" reads the board.)`)}{/cyan-fg}`;
     }
+    /**
+     * THE REVIEW QUEUE (user request 2026-08-27). Bare "backlog review"
+     * lists what is waiting on you, numbered 1..n; "backlog review <n>
+     * <your words>" answers item n.
+     *
+     * The numbering is the delicate part and utilities/backlog-review.ts
+     * holds the invariant: a number resolves against the snapshot the
+     * player was SHOWN, never against a fresh fetch. Answering does not
+     * renumber the list on screen either.
+     */
+    async review(args) {
+        // Bare "backlog review": fetch, render, and adopt that order as the
+        // numbering. This is the ONLY place the queue is refetched.
+        if (args.length === 0)
+            return this.showQueue();
+        const queue = reviewSnapshot();
+        if (queue.length === 0) {
+            // No snapshot means no list they could have counted on, so we do
+            // not fetch one and hope the numbering matches what they had in
+            // mind. Show it and let them pick against what they can see.
+            const shown = await this.showQueue();
+            return `${shown}\n\n{white-fg}(Pick from the list above -- "backlog review <n> <your answer>".){/white-fg}`;
+        }
+        // ONE INDEX RESOLVER FOR THE WHOLE GAME (session-1's takeIndex).
+        // It is pure and holds no order, which it says out loud -- so the
+        // guarantee that this list has not reshuffled since it was printed
+        // stays MINE, and lives in utilities/backlog-review.ts. What it
+        // buys here is that "review 9" against a 3-item list refuses in the
+        // same words as picking the ninth exit or the ninth item on a
+        // vendor's shelf, and the remainder comes back VERBATIM -- this
+        // trailing text is a human's answer, not arguments.
+        const picked = takeIndex(args.join(' '), queue.length);
+        if (!picked.ok)
+            return `${picked.message}${hint(` "backlog review" shows the list again.`)}`;
+        const item = reviewItemAt(picked.at + 1);
+        if (!item)
+            return `There's no item ${picked.at + 1}. The list runs 1-${queue.length}.`;
+        const n = picked.at + 1;
+        const text = picked.rest;
+        if (text.length === 0) {
+            // A number on its own reads the item back rather than posting an
+            // empty answer -- most of the time that IS what they wanted.
+            return this.renderItem(item, n, { full: true });
+        }
+        const outcome = await postBacklogComment(item.id, text, {
+            kind: 'answer',
+            // The question is answered, so it is no longer awaiting them.
+            awaitingReporter: false,
+            runnerName: this.actor?.name,
+        });
+        noteBacklogOutcome(outcome);
+        if (outcome !== 'ok')
+            return this.explain(outcome);
+        markReviewAnswered(item.id);
+        const left = reviewSnapshot().filter(i => !isReviewAnswered(i.id)).length;
+        return [
+            `{cyan-fg}Answered item ${n}. It's on the record against your report.{/cyan-fg}`,
+            left > 0
+                ? `{white-fg}${left} still waiting on you -- the numbers above haven't moved.{/white-fg}`
+                : `{white-fg}That was the last one. Nothing else is waiting on you.{/white-fg}`,
+        ].join('\n');
+    }
+    /** Fetch and render the queue, adopting its order as the numbering. */
+    async showQueue() {
+        const { outcome, items } = await loadReviewQueue();
+        if (outcome !== 'ok' || !items)
+            return this.explain(outcome);
+        if (items.length === 0) {
+            return `Nothing's waiting on you. The board will say so when somebody needs a word back.`;
+        }
+        return [
+            `{cyan-fg}WAITING ON YOU{/cyan-fg}`,
+            ...items.map((it, i) => this.renderItem(it, i + 1, { full: false })),
+            hint(`"backlog review <n> <your answer>" replies. "backlog review <n>" alone reads one in full.`),
+        ].filter(Boolean).join('\n');
+    }
+    /**
+     * One queue row. The two kinds of request READ DIFFERENTLY on purpose
+     * even though the server models both as a question awaiting the
+     * reporter: "somebody asked about your report" and "this is fixed,
+     * can you confirm it in play" are different jobs, and a play-tester
+     * skimming a list should be able to tell at a glance which one they
+     * are being asked for.
+     */
+    renderItem(it, n, opts) {
+        // THE SERVER SAYS WHICH KIND; the status heuristic is only a
+        // fallback for a server too old to say. Deriving it from status was
+        // a client guess, and it guessed wrong for the obvious case: a
+        // clarifying question about an item that happens to be in-progress
+        // is still a question, not a request to go confirm a fix.
+        const validation = it.kind
+            ? it.kind === 'validation'
+            : it.status === 'complete' || it.status === 'in-review';
+        const lead = validation
+            ? `{cyan-fg}CAN YOU CONFIRM THIS IN PLAY?{/cyan-fg}`
+            : `{cyan-fg}QUESTION ABOUT YOUR REPORT{/cyan-fg}`;
+        const asker = it.asked?.by ? ` -- ${it.asked.by}` : '';
+        const yours = opts.full ? it.text : truncate(it.text, 72);
+        // optionMark, not a hand-rolled "1.", so this list sits in the same
+        // gutter as the exits, the shelves and the jobs board -- and so it
+        // keeps the promise that mark carries: a numbered row means the
+        // number works, and this one is resolved by the same takeIndex.
+        const rows = [`${optionMark(n)}${lead}${asker}`];
+        // `asked` is OPTIONAL on the wire. A review item should always have
+        // one -- and "should always" is how a render throws in front of a
+        // player. An item that arrives without one still lists, still
+        // numbers, and still takes an answer.
+        if (it.asked?.text)
+            rows.push(`     {white-fg}"${it.asked.text}"{/white-fg}`);
+        rows.push(`     {white-fg}your report: ${yours}{/white-fg}`);
+        // What changed, when the ask is to confirm that it did.
+        if (validation && it.commits?.length) {
+            rows.push(`     {white-fg}fixed by: ${it.commits.slice(0, 3).join(', ')}{/white-fg}`);
+        }
+        return rows.join('\n');
+    }
     async list(statusArg) {
         let status;
         if (statusArg) {
@@ -135,6 +276,10 @@ export class BacklogCommand extends Command {
         switch (status) {
             case 'complete': return '{green-fg}[done]{/green-fg}';
             case 'in-progress': return '{cyan-fg}[wip] {/cyan-fg}';
+            // Fixed, and waiting on the reporter to confirm it in play. It
+            // used to fall through to the default and read "[open]" -- an
+            // item awaiting your word shown as one nobody had touched.
+            case 'in-review': return '{cyan-fg}[you?] {/cyan-fg}';
             case 'wont-fix': return '{cyan-fg}[no]  {/cyan-fg}';
             default: return '{yellow-fg}[open]{/yellow-fg}';
         }

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

@@ -1 +1 @@
-{"version":3,"file":"backlog.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/commands/backlog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"backlog.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/commands/backlog.ts"],"names":[],"mappings":"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"}

package/bundle/typescript/src/commands/game/sideQuest/commands/bluff.d.ts

@@ -1,18 +1,45 @@
-import { BypassCommand } from './bypass-command.js';
-import { PuzzleBypassType } from '../types/seed/puzzle-seed.js';
+import { Command, ICommand } from './command.js';
 /**
- * The CON skill's barrier verb: fast-talk past a social gate -- a doorman,
- * an intercom challenge, a receptionist with a list (bypassType "con").
- * Same stakes as pick/hack/cast: a blown story burns the approach for
- * good -- they know exactly what you are now, and the district hears
- * about it. Rolled on Charisma + con.
+ * BLUFF IS SOCIAL, AND SOCIAL MEANS A PERSON (player ruling 2026-08-27:
+ * "'bluff' shouldn't work on Barriers like locks/wards/etc. Bluff is a
+ * social workaround. The real barrier, in this case, should be Coyote --
+ * NPCs can be barriers (can't move through them)").
+ *
+ * This used to be a BypassCommand: bluff was a bypassType on the barrier
+ * itself, so a keypad could be "really a doorman" and you talked the
+ * keypad round. That was a category error in two directions at once. A
+ * lock has no opinion to change, so there was nothing for the con to
+ * work on; and modelling the DOORMAN as a Puzzle to get the social route
+ * gave a human being a shortcut that could be BURNED, a coin flip in
+ * place of an opposed test, and a "BARRIER:" label in search.
+ *
+ * So bluff no longer touches barriers at all. What it does instead is
+ * the thing the ruling asked for: an OPPOSED SOCIAL TEST against a
+ * person who is holding a doorway. An obstructive NPC is one whose
+ * `guarding` flag makes utilities/spots.ts holdsGround() keep the way
+ * shut; winning clears it and they step aside.
+ *
+ * Charisma + con against their Willpower + Intuition -- the will not to
+ * be moved, and the read on you. Not a coin flip, because a coin flip is
+ * what you roll against a mechanism.
+ *
+ * Losing does NOT burn anything. They remember the story and won't hear
+ * it twice from you (conAttemptedBy), but they can still be leaned on,
+ * bought, or fought. That distinction is the ruling in miniature: a
+ * barrier gets burned, a person just doesn't buy it.
+ *
+ * Every refusal here NAMES THE ROUTE THAT WOULD WORK, per the standing
+ * rule from v5.63/v5.64 -- a bare denial in front of an obvious obstacle
+ * is what made a real session conclude the barrier was broken. Typing
+ * "bluff" at a maglock says the maglock was never the kind of thing you
+ * talk to, and points at what is.
  */
-export declare class BluffCommand extends BypassCommand {
+export declare class BluffCommand extends Command implements ICommand {
     protected static verb: string;
     protected static description: string;
-    protected bypassType: PuzzleBypassType;
-    protected verbName: string;
-    protected noPuzzleMessage: string;
-    execute(args: string[]): Promise<string>;
-    protected determineOutcome(): Promise<boolean>;
+    execute(args?: string[]): Promise<string>;
+    /** Is there a barrier in this room at all? Only used to word the
+     *  refusal correctly -- a player who typed "bluff" at a lock deserves
+     *  to be pointed at the verbs that do work on it. */
+    private roomHasBarrier;
 }

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

@@ -1,19 +1,46 @@
-import { BypassCommand } from './bypass-command.js';
+import { Command } from './command.js';
+import { hint } from '../utilities/hints.js';
+import { sameSpot, spotOf } from '../utilities/spots.js';
 import { rollPool, formatRoll } from '../utilities/dice.js';
 /**
- * The CON skill's barrier verb: fast-talk past a social gate -- a doorman,
- * an intercom challenge, a receptionist with a list (bypassType "con").
- * Same stakes as pick/hack/cast: a blown story burns the approach for
- * good -- they know exactly what you are now, and the district hears
- * about it. Rolled on Charisma + con.
+ * BLUFF IS SOCIAL, AND SOCIAL MEANS A PERSON (player ruling 2026-08-27:
+ * "'bluff' shouldn't work on Barriers like locks/wards/etc. Bluff is a
+ * social workaround. The real barrier, in this case, should be Coyote --
+ * NPCs can be barriers (can't move through them)").
+ *
+ * This used to be a BypassCommand: bluff was a bypassType on the barrier
+ * itself, so a keypad could be "really a doorman" and you talked the
+ * keypad round. That was a category error in two directions at once. A
+ * lock has no opinion to change, so there was nothing for the con to
+ * work on; and modelling the DOORMAN as a Puzzle to get the social route
+ * gave a human being a shortcut that could be BURNED, a coin flip in
+ * place of an opposed test, and a "BARRIER:" label in search.
+ *
+ * So bluff no longer touches barriers at all. What it does instead is
+ * the thing the ruling asked for: an OPPOSED SOCIAL TEST against a
+ * person who is holding a doorway. An obstructive NPC is one whose
+ * `guarding` flag makes utilities/spots.ts holdsGround() keep the way
+ * shut; winning clears it and they step aside.
+ *
+ * Charisma + con against their Willpower + Intuition -- the will not to
+ * be moved, and the read on you. Not a coin flip, because a coin flip is
+ * what you roll against a mechanism.
+ *
+ * Losing does NOT burn anything. They remember the story and won't hear
+ * it twice from you (conAttemptedBy), but they can still be leaned on,
+ * bought, or fought. That distinction is the ruling in miniature: a
+ * barrier gets burned, a person just doesn't buy it.
+ *
+ * Every refusal here NAMES THE ROUTE THAT WOULD WORK, per the standing
+ * rule from v5.63/v5.64 -- a bare denial in front of an obvious obstacle
+ * is what made a real session conclude the barrier was broken. Typing
+ * "bluff" at a maglock says the maglock was never the kind of thing you
+ * talk to, and points at what is.
  */
-export class BluffCommand extends BypassCommand {
+export class BluffCommand extends Command {
     static verb = 'bluff';
-    static description = 'Talk your way past a social barrier (a doorman, a voice-gate) without the passphrase -- Charisma + con. Blow the story and they\'ll never buy another word (the real credential still works).';
-    bypassType = 'con';
-    verbName = 'bluff';
-    noPuzzleMessage = `There's nobody here to bluff past.`;
-    async execute(args) {
+    static description = 'Talk a PERSON round -- Charisma + con. Locks, wards and terminals have no opinion to change; work those with "pick", "hack" or "cast".';
+    async execute(args = []) {
         // Fast-talk needs a face and a voice on the scene -- your meat ones.
         if (this.actor.plane === 'matrix') {
             return `Your silver tongue is meat-side, slumped with the rest of you. "jack out" to run your game in person.`;
@@ -24,25 +51,80 @@ export class BluffCommand extends BypassCommand {
         if (this.actor.plane === 'drone') {
             return `Nobody buys a story from a hovering drone with a tinny speaker -- a con needs a FACE. "jump" back to yours.`;
         }
+        const room = this.actor.currentLocation;
+        const here = room
+            ? this.scene.getActorsInRoom(room).filter((a) => a !== this.actor && !a.isIncapacitated())
+            : [];
+        // NAME THE PEOPLE, because "bluff" is now a question about people and
+        // the honest answer to "who?" is a list of who is actually here.
+        if (here.length === 0) {
+            return `There's nobody here to work. A con needs an audience -- ${room && this.roomHasBarrier() ? `and whatever's blocking you isn't one. It's a THING: work it with "pick", "hack" or "cast", or find the answer and "solve" it.` : `find someone who can say yes.`}`;
+        }
+        const named = args.join(' ').trim();
+        const target = named
+            ? here.find(a => a.name.toLowerCase().includes(named.toLowerCase()))
+            : undefined;
+        if (named && !target) {
+            return `You don't see anyone called "${named}" to work. Here: ${here.map(a => a.name).join(', ')}.`;
+        }
         // Working a mark out loud is the opposite of sneaking (see sneak.ts).
         this.actor.sneaking = false;
-        return super.execute(args);
-    }
-    async determineOutcome() {
-        // A CON test (Charisma + con, 2 hits; unskilled Charisma - 1) -- the
-        // Face's answer to the decker's terminal and the ops specialist's
-        // maglock.
+        const who = target ?? here[0];
+        if (!sameSpot(this.actor, who)) {
+            const spot = spotOf(who);
+            return `A story needs to be told close. ${who.name} is at the ${spot ?? 'other side of the room'} -- "move to ${spot ?? who.name}" first.`;
+        }
+        if (!who.guarding) {
+            return [
+                `You size ${who.name} up for a story -- but they aren't in your way. A con needs something to BE talked past.`,
+                hint(` (Say your piece with "talk-to ${who.name} <what you tell them>", or lean on them with "persuade"/"intimidate".)`),
+            ].join('');
+        }
+        // A MARK REMEMBERS. Not a burned route -- the distinction is the
+        // whole ruling. They didn't buy your story; they can still be leaned
+        // on, bought, or fought.
+        if (who.conAttemptedBy.has(this.actor.name)) {
+            return `${who.name} has heard your story once already, and they didn't buy it the first time. Try something that isn't talk.`;
+        }
+        who.conAttemptedBy.add(this.actor.name);
+        // OPPOSED, against the PERSON -- not a coin flip against a lock.
+        // Their Willpower + Intuition is what sees through a story: the will
+        // not to be moved, and the read on you.
         const skill = this.actor.skillRating('con');
-        // A drink beforehand loosens the delivery (see use.ts liquid courage).
-        // Public Awareness cuts AGAINST a con -- a face people can place is
-        // a face that can't claim to be someone else (capped at -2).
+        // Public Awareness cuts AGAINST a con: a face people can place is a
+        // face that can't claim to be someone else (capped at -2).
         const fame = Math.min(2, this.actor.publicAwareness);
-        const pool = Math.max(1, this.actor.charisma + (skill > 0 ? skill : -1) + this.actor.consumeLiquidCourage() + this.actor.consumeFirstImpression() + this.actor.augBonus('social') - fame + this.actor.woundModifier - this.actor.sustainingPenalty);
-        const roll = rollPool(pool);
+        const pool = Math.max(1, this.actor.charisma + (skill > 0 ? skill : -1)
+            + this.actor.consumeLiquidCourage() + this.actor.consumeFirstImpression()
+            + this.actor.augBonus('social') - fame
+            + this.actor.woundModifier - this.actor.sustainingPenalty);
+        const theirs = Math.max(1, who.willpower + who.intuition);
+        const mine = rollPool(pool);
+        const resist = rollPool(theirs);
         if (this.scene.isHumanControlled(this.actor)) {
-            this.logger.meta(`Con: ${formatRoll(roll)} (2+ to sell it)`);
+            this.logger.meta(`Con: ${formatRoll(mine)}`);
+            this.logger.meta(`  ${who.name} sees through it: ${formatRoll(resist)}`);
         }
-        return roll.hits >= 2;
+        this.actor.performAction('spins a story for', who.name);
+        this.logger.write(`Bluff: ${this.actor.name} vs ${who.name} -- ${mine.hits} vs ${resist.hits} (guarding).`);
+        if (mine.hits <= resist.hits) {
+            void Promise.resolve(who.hear(this.actor, `[System note: ${this.actor.name} just tried to talk their way past you and you DIDN'T buy it. You are still holding this doorway. Say so, in your own voice, in one short line.]`)).catch(() => undefined);
+            return `${who.name} lets you finish, then doesn't move. "Nice try."`;
+        }
+        // They stand down -- for everyone, deliberately (see Player.guarding).
+        who.guarding = false;
+        void Promise.resolve(who.hear(this.actor, `[System note: ${this.actor.name} just talked you round and you're STEPPING ASIDE -- you bought the story. One short line as you move, in your own voice. Don't re-block the way.]`)).catch(() => undefined);
+        return [
+            `${who.name} weighs it, decides you're somebody's problem but not theirs, and steps out of the way.`,
+            hint(` (The way is open while they stay stood down.)`),
+        ].join('');
+    }
+    /** Is there a barrier in this room at all? Only used to word the
+     *  refusal correctly -- a player who typed "bluff" at a lock deserves
+     *  to be pointed at the verbs that do work on it. */
+    roomHasBarrier() {
+        const room = this.actor.currentLocation;
+        return (room?.openableDevices?.() ?? []).length > 0;
     }
 }
 //# sourceMappingURL=bluff.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"bluff.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/commands/bluff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,OAAO,YAAa,SAAQ,aAAa;IACnC,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC;IACtB,MAAM,CAAC,WAAW,GAAG,+LAA+L,CAAC;IACrN,UAAU,GAAqB,KAAK,CAAC;IACrC,QAAQ,GAAG,OAAO,CAAC;IACnB,eAAe,GAAG,oCAAoC,CAAC;IAEjE,KAAK,CAAC,OAAO,CAAC,IAAc;QAC1B,qEAAqE;QACrE,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,uGAAuG,CAAC;QACjH,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,qFAAqF,CAAC;QAC/F,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YACjC,OAAO,6GAA6G,CAAC;QACvH,CAAC;QACD,sEAAsE;QACtE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC;QAC5B,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAES,KAAK,CAAC,gBAAgB;QAC9B,qEAAqE;QACrE,kEAAkE;QAClE,WAAW;QACX,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5C,uEAAuE;QACvE,oEAAoE;QACpE,6DAA6D;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACpP,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,UAAU,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;IACxB,CAAC"}
+{"version":3,"file":"bluff.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/commands/bluff.ts"],"names":[],"mappings":"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"}

package/bundle/typescript/src/commands/game/sideQuest/commands/breach.d.ts

@@ -1,34 +1,30 @@
 import { BypassCommand } from './bypass-command.js';
-import { PuzzleBypassType } from '../types/seed/puzzle-seed.js';
-import { PuzzleTarget } from '../models/room.js';
+import { Device } from '../models/device.js';
 /**
  * The FORCEFUL route past a physical barrier (player ruling: "solve" was
  * too broad -- a maglock wants finesse OR muscle, and muscle deserves its
- * own verb). Same barrier class as "pick" (bypassType lockpick), opposite
+ * own verb). Same device kind as "pick" (a lock), opposite
  * philosophy: raw Strength + Body instead of Agility + locksmith, and it
  * is LOUD no matter what -- a successful breach still raises the world
  * and ends any sneak (onBypassSuccess), where a clean pick stays quiet.
- * The two verbs share the barrier's one burned flag: a seized mechanism
- * or a sprung frame spends the shortcut for both -- the findable answer
- * remains untouched, as always. The SHARED flag is deliberate; the
- * shared WORDING was not. This used to carry a note calling it an
- * accepted wart that a breach-burned barrier re-refused with the
- * snapped-pick line -- it stopped being acceptable the moment a player
- * noticed being told about a pick they never owned (2026-08-27). Hence
- * burnedFlavor below: same flag, own fiction. Do not reinstate the wart.
+ * NOTHING BURNS ANY MORE. Both verbs used to share the barrier's one
+ * "burned" flag -- a failed attempt spent the shortcut for good -- and
+ * that flag went with the puzzle mechanic. A lock you failed to force
+ * is a lock you can throw yourself at again, which is what a lock is.
+ * The trade against "pick" is undiminished: breach is loud whether or
+ * not it works, and that is what you are choosing.
  */
 export declare class BreachCommand extends BypassCommand {
     protected static verb: string;
     protected static description: string;
-    protected bypassType: PuzzleBypassType;
+    protected deviceKind: "lock";
     protected verbName: string;
-    protected noPuzzleMessage: string;
+    protected noDeviceMessage: string;
     protected failureFlavor: string;
-    protected burnedFlavor: string;
     execute(args: string[]): Promise<string>;
     protected determineOutcome(): Promise<boolean>;
     /** Breaching is loud when it WORKS, too -- the defining trade against
      * pick. The world event lets every listening NPC react (same channel
      * the failure alarm uses); the sneak is over either way. */
-    protected onBypassSuccess(target: PuzzleTarget): Promise<string[]>;
+    protected onForceSuccess(device: Device): Promise<string[]>;
 }

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

@@ -3,27 +3,24 @@ import { rollPool, formatRoll } from '../utilities/dice.js';
 /**
  * The FORCEFUL route past a physical barrier (player ruling: "solve" was
  * too broad -- a maglock wants finesse OR muscle, and muscle deserves its
- * own verb). Same barrier class as "pick" (bypassType lockpick), opposite
+ * own verb). Same device kind as "pick" (a lock), opposite
  * philosophy: raw Strength + Body instead of Agility + locksmith, and it
  * is LOUD no matter what -- a successful breach still raises the world
  * and ends any sneak (onBypassSuccess), where a clean pick stays quiet.
- * The two verbs share the barrier's one burned flag: a seized mechanism
- * or a sprung frame spends the shortcut for both -- the findable answer
- * remains untouched, as always. The SHARED flag is deliberate; the
- * shared WORDING was not. This used to carry a note calling it an
- * accepted wart that a breach-burned barrier re-refused with the
- * snapped-pick line -- it stopped being acceptable the moment a player
- * noticed being told about a pick they never owned (2026-08-27). Hence
- * burnedFlavor below: same flag, own fiction. Do not reinstate the wart.
+ * NOTHING BURNS ANY MORE. Both verbs used to share the barrier's one
+ * "burned" flag -- a failed attempt spent the shortcut for good -- and
+ * that flag went with the puzzle mechanic. A lock you failed to force
+ * is a lock you can throw yourself at again, which is what a lock is.
+ * The trade against "pick" is undiminished: breach is loud whether or
+ * not it works, and that is what you are choosing.
  */
 export class BreachCommand extends BypassCommand {
     static verb = 'breach';
-    static description = 'Force a physical barrier open with raw muscle -- Strength + Body, no skill needed. Loud EVEN WHEN IT WORKS: the crash carries and any sneak is over. Fail, and the frame seizes for good (the real code still works). "breach north" or "breach <name>" if there\'s more than one.';
-    bypassType = 'lockpick';
+    static description = 'Force a physical barrier open with raw muscle -- Strength + Body, no skill needed. Loud EVEN WHEN IT WORKS: the crash carries and any sneak is over. Fail and it holds -- try again if you like, but the boom has already carried. "breach north" or "breach <name>" if there\'s more than one.';
+    deviceKind = 'lock';
     verbName = 'breach';
-    noPuzzleMessage = "There's nothing here to breach -- no physical barrier holds this room.";
+    noDeviceMessage = "There's nothing here to breach -- no physical barrier holds this room.";
     failureFlavor = `You slam into it and it HOLDS -- the frame seizes solid, and the boom rolls down every corridor on the floor.`;
-    burnedFlavor = `The frame is sprung and jammed hard in its seat -- you've already thrown everything you have at it, and it won't give twice. Only the real code opens it now.`;
     async execute(args) {
         // Shoulders are meat -- same plane fiction as pick.ts.
         if (this.actor.plane === 'matrix') {
@@ -51,11 +48,11 @@ export class BreachCommand extends BypassCommand {
     /** Breaching is loud when it WORKS, too -- the defining trade against
      * pick. The world event lets every listening NPC react (same channel
      * the failure alarm uses); the sneak is over either way. */
-    async onBypassSuccess(target) {
+    async onForceSuccess(device) {
         this.actor.sneaking = false;
-        this.scene.addWorldEvent(`${this.actor.name} breached "${target.puzzle.name}" in ${this.actor.currentLocation.name} -- the crash carried.`);
+        this.scene.addWorldEvent(`${this.actor.name} breached "${device.name}" in ${this.actor.currentLocation.name} -- the crash carried.`);
         // A breach is loud past the walls too (heat -- SINs & getting caught).
-        this.game?.addHeat(2, `breached "${target.puzzle.name}"`);
+        this.game?.addHeat(2, `breached "${device.name}"`);
         return [`  The crash CARRIES -- anyone nearby knows exactly where you are now.`];
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"breach.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/commands/breach.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,aAAc,SAAQ,aAAa;IACpC,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC;IACvB,MAAM,CAAC,WAAW,GAAG,oRAAoR,CAAC;IAC1S,UAAU,GAAqB,UAAU,CAAC;IAC1C,QAAQ,GAAG,QAAQ,CAAC;IACpB,eAAe,GAAG,wEAAwE,CAAC;IAC3F,aAAa,GAAG,+GAA+G,CAAC;IAChI,YAAY,GAAG,+JAA+J,CAAC;IAEzL,KAAK,CAAC,OAAO,CAAC,IAAc;QAC1B,uDAAuD;QACvD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,+DAA+D,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,IAAI,cAAc,uCAAuC,CAAC;QAC3J,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,uGAAuG,CAAC;QACjH,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YACjC,OAAO,4EAA4E,CAAC;QACtF,CAAC;QACD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAES,KAAK,CAAC,gBAAgB;QAC9B,kEAAkE;QAClE,qEAAqE;QACrE,6BAA6B;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC1H,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;IACxB,CAAC;IAED;;gEAE4D;IAClD,KAAK,CAAC,eAAe,CAAC,MAAoB;QAClD,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,cAAc,MAAM,CAAC,MAAM,CAAC,IAAI,QAAQ,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,wBAAwB,CAAC,CAAC;QAC5I,uEAAuE;QACvE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,aAAa,MAAM,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;QAC1D,OAAO,CAAC,uEAAuE,CAAC,CAAC;IACnF,CAAC"}
+{"version":3,"file":"breach.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/commands/breach.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,aAAc,SAAQ,aAAa;IACpC,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC;IACvB,MAAM,CAAC,WAAW,GAAG,iSAAiS,CAAC;IACvT,UAAU,GAAG,MAAe,CAAC;IAC7B,QAAQ,GAAG,QAAQ,CAAC;IACpB,eAAe,GAAG,wEAAwE,CAAC;IAC3F,aAAa,GAAG,+GAA+G,CAAC;IAE1I,KAAK,CAAC,OAAO,CAAC,IAAc;QAC1B,uDAAuD;QACvD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,+DAA+D,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,IAAI,cAAc,uCAAuC,CAAC;QAC3J,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,uGAAuG,CAAC;QACjH,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YACjC,OAAO,4EAA4E,CAAC;QACtF,CAAC;QACD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAES,KAAK,CAAC,gBAAgB;QAC9B,kEAAkE;QAClE,qEAAqE;QACrE,6BAA6B;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC1H,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;IACxB,CAAC;IAED;;gEAE4D;IAClD,KAAK,CAAC,cAAc,CAAC,MAAc;QAC3C,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,cAAc,MAAM,CAAC,IAAI,QAAQ,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,wBAAwB,CAAC,CAAC;QACrI,uEAAuE;QACvE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,aAAa,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;QACnD,OAAO,CAAC,uEAAuE,CAAC,CAAC;IACnF,CAAC"}