@maka/maka-cli 5.127.0 → 5.129.0

package/bundle/typescript/package.json

@@ -1,12 +1,15 @@
 {
   "name": "@maka/maka-cli",
-  "version": "5.127.0",
+  "version": "5.129.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.",
+  "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.",
   "homepage": "https://github.com/maka-io/maka-cli",
   "files": [
-    "bundle/typescript"
+    "bundle/typescript",
+    "!bundle/typescript/**/*.map",
+    "!bundle/typescript/**/*.d.ts",
+    "bundle/typescript/src/templates"
   ],
   "main": "./bundle/typescript/src/maka.js",
   "bin": {
@@ -52,12 +55,10 @@
     "cli-cursor": "^5.0.0",
     "cli-table": "^0.3.11",
     "cross-spawn": "^7.0.6",
-    "date-fns": "^4.1.0",
     "ejs": "^6.0.1",
     "elegant-spinner": "^3.0.0",
     "http-proxy": "^1.18.1",
     "humps": "^2.0.1",
-    "husky": "^9.1.6",
     "latest-version": "^9.0.0",
     "minimist": "^1.2.8",
     "node-forge": "^1.3.1",
@@ -96,6 +97,7 @@
     "esbuild": "^0.28.2",
     "eslint": "^9.13.0",
     "globals": "^17.11.0",
+    "husky": "^9.1.6",
     "jest": "^30.4.2",
     "ts-jest": "^29.2.5",
     "typescript": "^6.0.3",

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

@@ -2,7 +2,7 @@ import { Player } from './models/player.js';
 import { Item } from './models/item.js';
 import { Size, Category, Rating } from './types/shared/item-enum.js';
 import { augFor } from './utilities/catalog.js';
-import { creationSplit, getQuality, CREATION_KARMA, KARMA_CARRYOVER_MAX, KARMA_TO_NUYEN_MAX, KARMA_NUYEN_RATE, HELD_NUYEN_MAX } from './qualities.js';
+import { creationSplit, getQuality, qualityKarma, CREATION_KARMA, KARMA_CARRYOVER_MAX, KARMA_TO_NUYEN_MAX, KARMA_NUYEN_RATE, HELD_NUYEN_MAX } from './qualities.js';
 import { catalogGearDef, catalogRowFor } from './utilities/catalog.js';
 export const ARCHETYPES = [
     {
@@ -103,6 +103,9 @@ export const ARCHETYPES = [
             adeptPowers: { 'improved-reflexes': 1, 'killing-hands': 1 },
             skills: { spellcasting: 5, counterspelling: 3, assensing: 3, unarmed: 4, blades: 3, gymnastics: 3, running: 3, swimming: 2, perception: 3, sneaking: 3, pistols: 2 } },
         qualities: ['focused-concentration', 'mentor-spirit', 'astral-beacon'],
+        // Rating 2 (p.74, 4 karma a rating): a Force 2 working held free.
+        // The ledger above priced rating 1; each rating past it is 4 more.
+        qualityRatings: { 'focused-concentration': 2 },
         gearSlugs: [
             'power-focus-1', 'reagents', 'armor-jacket', 'combat-boots', 'meta-link',
             'medkit-3', 'trauma-patch', 'stim-patch', 'ear-buds', 'glasses',
@@ -203,6 +206,9 @@ export const ARCHETYPES = [
         // into their dreams and calls it rent. Ledger 25 - 7 + 10 = 28 -> 7
         // karma + 20,000 nuyen.
         qualities: ['high-pain-tolerance', 'focused-concentration', 'mentor-spirit', 'quick-healer', 'insomnia'],
+        // Rating 2 (p.74, 4 karma a rating): a Force 2 working held free.
+        // The ledger above priced rating 1; each rating past it is 4 more.
+        qualityRatings: { 'focused-concentration': 2 },
         gearSlugs: [
             // A formula for a spell they do NOT know: that is what a formula
             // is for. Same 2,000 as the Combat category row it replaces, so
@@ -263,6 +269,10 @@ export const ARCHETYPES = [
         // who never let them look at the other half.
         // Ledger 25 - 9 = 16 -> 7 karma + 18,000 nuyen.
         qualities: ['focused-concentration', 'mentor-spirit'],
+        // Rating 3 (p.74, 4 karma a rating): the pure spellslinger holds a
+        // drain-neutral Force 3 working free -- Increase Reflexes, a barrier.
+        // The ledger above priced rating 1; each rating past it is 4 more.
+        qualityRatings: { 'focused-concentration': 3 },
         gearSlugs: [
             // Was Combat + Detection + Health category formulae (2,000 + 500
             // + 500). The Detection one was for a category this engine has no
@@ -294,6 +304,9 @@ export const ARCHETYPES = [
         // The spirits like them, which is not the same as the spirits being
         // safe. Ledger 25 - 11 = 14 -> 7 karma + 14,000 nuyen.
         qualities: ['spirit-affinity', 'focused-concentration'],
+        // Rating 2 (p.74, 4 karma a rating): a Force 2 working held free.
+        // The ledger above priced rating 1; each rating past it is 4 more.
+        qualityRatings: { 'focused-concentration': 2 },
         gearSlugs: [
             'spirit-focus-1', 'power-focus-1', 'lodge-materials-3',
             'reagents', 'transys-avalon', 'medkit-6',
@@ -360,6 +373,10 @@ export const ARCHETYPES = [
         // taxman never stops collecting. Ledger 25 - 5 + 15 = 35 -> 7 karma
         // + 20,000 nuyen (the rest went into that resonance).
         qualities: ['analytical-mind', 'natural-hardening', 'prime-datahaven-membership', 'focused-concentration', 'sinner-corp'],
+        // Rating 2 (p.74, 4 karma a rating): a Level 2 complex form held
+        // free -- the quality covers a form exactly as it covers a spell.
+        // The ledger above priced rating 1; each rating past it is 4 more.
+        qualityRatings: { 'focused-concentration': 2 },
         gearSlugs: [
             'armor-jacket', 'combat-boots', 'fake-sin-4', 'meta-link',
             'microtransceiver', 'data-tap', 'micro-camera', 'stealth-tags',
@@ -426,7 +443,10 @@ export function archetypeLedger(archetype) {
     const augNuyen = (archetype.augs ?? []).reduce((n, key) => n + (augFor(key)?.cost ?? 0), 0);
     const spent = (archetype.qualities ?? []).reduce((n, key) => {
         const q = getQuality(key);
-        return n + (q ? (q.kind === 'positive' ? q.karma : -q.karma) : 0);
+        if (!q)
+            return n;
+        const cost = qualityKarma(q, archetype.qualityRatings?.[key]);
+        return n + (q.kind === 'positive' ? cost : -cost);
     }, 0) + (archetype.combat.powerPoints ?? 0) * 5;
     const karmaRemainder = CREATION_KARMA - spent;
     const karmaConverted = Math.min(Math.max(0, karmaRemainder - KARMA_CARRYOVER_MAX), KARMA_TO_NUYEN_MAX);
@@ -523,7 +543,7 @@ export function outfitArchetype(player, archetype) {
         player.picks.set(key, pick);
     }
     for (const key of archetype.qualities ?? []) {
-        player.addQuality(key);
+        player.addQuality(key, archetype.qualityRatings?.[key]);
     }
     // Power Points ride the SAME pool (SR5 p.69-70, 5 karma each): a mystic
     // adept archetype pays for its points exactly as a web-built one does.
@@ -531,6 +551,7 @@ export function outfitArchetype(player, archetype) {
     // exactly as before.
     const split = creationSplit({
         qualities: archetype.qualities ?? [],
+        qualityRatings: archetype.qualityRatings,
         powerPoints: archetype.combat.powerPoints ?? 0,
     });
     player.karma += split.karma;

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

@@ -1,3 +1,4 @@
+import { sustainBurden } from '../utilities/sustaining.js';
 import { BypassCommand } from './bypass-command.js';
 import { hint } from '../utilities/hints.js';
 import { CombatExchange } from '../utilities/combat-exchange.js';
@@ -801,9 +802,12 @@ export class CastCommand extends BypassCommand {
         this.actor.performAction('casts armor', self ? '' : `on ${target.name}`);
         this.scene.addWorldEvent(`${this.actor.name} wrapped ${self ? 'themselves' : target.name} in a shimmering armor spell.`);
         this.scene.updateStatus();
+        // The burden is the bearer's ledger's, not a restated -2: a Focused
+        // Concentration holder is told "no penalty" the moment it applies.
+        const burden = sustainBurden(target.sustainedLedger().find(w => w.key === 'armor'), ` to everything else ${self ? 'you do' : 'they do'}`);
         const lines = [
             `${this.actor.name} casts armor at Force ${force}${self ? '' : ` on ${target.name}`}, ${this.castingLabel()}:`,
-            `  The air hardens around ${self ? 'you' : target.name} -- +${bonus} soak dice while sustained, -2 dice to everything else ${self ? 'you do' : 'they do'}.`,
+            `  The air hardens around ${self ? 'you' : target.name} -- +${bonus} soak dice while sustained, ${burden}.`,
             hint(`  (Cast armor${self ? '' : ` on ${target.name}`} again to release it.)`),
             ...this.applyDrain(spell, force, overcast),
         ];
@@ -864,11 +868,12 @@ export class CastCommand extends BypassCommand {
             ? `${actor.name} wove a mana barrier across the way ${direction} in ${room.name}.`
             : `${actor.name} raised a shimmering force barrier across the way ${direction} in ${room.name}.`);
         this.scene.updateStatus();
+        const burden = sustainBurden(actor.sustainedLedger().find(w => w.key === spellKey), ' to everything else you do');
         const lines = [
             `${actor.name} casts ${mana ? 'mana barrier' : 'barrier'} at Force ${force}, ${this.castingLabel()}:`,
             mana
-                ? `  A lattice of woven mana settles across the way ${direction} -- invisible to meat eyes, Force ${force}. SPIRITS and astral forms stop at it; the living walk through without noticing. -2 dice to everything else you do.`
-                : `  The air itself hardens across the way ${direction} -- a faint heat-shimmer wall, Force ${force}. NOBODY passes while you hold it (you included), and -2 dice to everything else you do.`,
+                ? `  A lattice of woven mana settles across the way ${direction} -- invisible to meat eyes, Force ${force}. SPIRITS and astral forms stop at it; the living walk through without noticing. ${burden.charAt(0).toUpperCase()}${burden.slice(1)}.`
+                : `  The air itself hardens across the way ${direction} -- a faint heat-shimmer wall, Force ${force}. NOBODY passes while you hold it (you included), and ${burden}.`,
             hint(`  (Cast ${spellKey} again to release it; "dispel ${mana ? 'mana barrier' : 'barrier'}" unweaves it from either side.)`),
             ...this.applyDrain(spell, force, overcast),
         ];
@@ -911,9 +916,10 @@ export class CastCommand extends BypassCommand {
             ? `${this.actor.name} wove an invisibility spell${self ? '' : ` over ${target.name}`}.`
             : `${this.actor.name} cast increase reflexes${self ? '' : ` on ${target.name}`}.`);
         this.scene.updateStatus();
+        const burden = sustainBurden(target.sustainedLedger().find(w => w.key === spellKey), ` to everything else ${self ? 'you do' : 'they do'}`);
         const effectLine = spellKey === 'invisibility'
-            ? `  The light slides around ${self ? 'you' : target.name} like water around a stone -- +3 dice on sneak contests while sustained, -2 dice to everything else ${self ? 'you do' : 'they do'}. Loud acts still announce ${self ? 'you' : 'them'}.`
-            : `  ${self ? 'Your' : `${target.name}'s`} nerves run HOT -- +2 initiative while sustained, -2 dice to everything else ${self ? 'you do' : 'they do'}.`;
+            ? `  The light slides around ${self ? 'you' : target.name} like water around a stone -- +3 dice on sneak contests while sustained, ${burden}. Loud acts still announce ${self ? 'you' : 'them'}.`
+            : `  ${self ? 'Your' : `${target.name}'s`} nerves run HOT -- +2 initiative while sustained, ${burden}.`;
         const lines = [
             `${this.actor.name} casts ${label} at Force ${force}${self ? '' : ` on ${target.name}`}, ${this.castingLabel()}:`,
             effectLine,

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

@@ -3,11 +3,13 @@ import { hint } from '../utilities/hints.js';
 import { fuzzyPickName } from '../utilities/fuzzy-match.js';
 import { catalogMetamagics } from '../utilities/catalog.js';
 // THE PICKS ARE CATALOG ROWS (kind 'metamagic' on maka-cli.com), read
-// through catalogMetamagics(); the shape is ../metamagics.ts. The five
-// metamagics whose rule is not expressible as dice (quickening,
-// overclocking, the two Matrix upgrades, power-point) are keyed by name
-// in models/player.ts -- a row with a new key does nothing until the
-// engine grows a seat for it.
+// through catalogMetamagics(); the shape is ../metamagics.ts. The four
+// metamagics whose rule is not expressible as dice (overclocking, the
+// two Matrix upgrades, power-point) are keyed by name in
+// models/player.ts -- a row with a new key does nothing until the
+// engine grows a seat for it. Quickening left that list on 2026-09-06:
+// its row carries a `sustain` effect (utilities/effects.ts) and the
+// engine reads that, not the slug.
 export class InitiateCommand extends Command {
     static verb = 'initiate';
     static description = 'Initiation/submersion at your hideout (10 + grade x3 karma): each grade lifts Magic/Resonance past 6 and grants a metamagic (or echo). "initiate" lists; "initiate <pick>" pays.';

package/bundle/typescript/src/commands/game/sideQuest/commands/quality-trade.js

@@ -19,7 +19,7 @@ const onSale = () => catalogQualities().filter(q => !q.retired);
  */
 export class QualityTradeCommand extends Command {
     static verb = 'qualities';
-    static description = 'Trade qualities with karma at your hideout (SR5e x2 rates): "qualities" lists, "qualities <name>" buys a positive or buys off a negative.';
+    static description = 'Trade qualities with karma at your hideout (SR5e x2 rates): "qualities" lists, "qualities <name>" buys a positive or buys off a negative; "qualities <name> <rating>" buys or raises a rated one.';
     async execute(args = []) {
         const actor = this.actor;
         if (actor.inExchange) {
@@ -34,10 +34,19 @@ export class QualityTradeCommand extends Command {
         if (!args || args.length === 0) {
             return this.listBoard();
         }
+        // A trailing number is the RATING wanted for a rated quality
+        // ("qualities focused concentration 3"); everything before it names
+        // the quality. Parsed off first so the name match never sees it.
+        let words = [...args];
+        let wanted;
+        if (words.length > 1 && /^\d+$/.test(words[words.length - 1])) {
+            wanted = parseInt(words[words.length - 1], 10);
+            words = words.slice(0, -1);
+        }
         // Exact key first ("qualities sinner-criminal" works verbatim), then
         // fuzzy over display names ONLY -- names and keys together made every
         // single-word quality ambiguous with its own key.
-        const input = args.join(' ');
+        const input = words.join(' ');
         const byKey = onSale().find(q => q.key === input.toLowerCase().replace(/\s+/g, '-'));
         const picked = byKey?.name ?? fuzzyPickName(input, onSale().map(q => q.name));
         const quality = onSale().find(q => q.name === picked);
@@ -45,30 +54,55 @@ export class QualityTradeCommand extends Command {
             return `That's not a quality this street knows. "qualities" lists the board.`;
         }
         if (quality.kind === 'positive') {
-            return this.buyPositive(quality);
+            return this.buyPositive(quality, wanted);
         }
         return this.buyOffNegative(quality);
     }
-    buyPositive(quality) {
+    /**
+     * A RATED quality (IQuality.maxRating) is bought at a rating and
+     * priced per rating (p.74 Focused Concentration: 4 karma a rating, x2
+     * in play), and a holder may RAISE one by paying for the ratings they
+     * do not yet have. Until 2026-09-06 this verb bought every quality at
+     * rating 1 and refused to touch it again, so Focused Concentration
+     * bought here covered a Force 1 spell for the rest of the character's
+     * life.
+     */
+    buyPositive(quality, wanted) {
         const actor = this.actor;
-        if (actor.hasQuality(quality.key)) {
-            return `${quality.name} is already part of who you are.`;
+        const held = actor.hasQuality(quality.key) ? actor.qualityRating(quality.key) : 0;
+        if (!quality.maxRating) {
+            if (held > 0)
+                return `${quality.name} is already part of who you are.`;
+            if (wanted !== undefined)
+                return `${quality.name} takes no rating -- "qualities ${quality.key}" alone buys it.`;
+        }
+        const rating = quality.maxRating ? Math.max(1, Math.floor(wanted ?? (held > 0 ? held + 1 : 1))) : 1;
+        if (quality.maxRating && rating > quality.maxRating) {
+            return `${quality.name} tops out at rating ${quality.maxRating}${hint(` (${quality.page})`)}.`;
+        }
+        if (quality.maxRating && rating <= held) {
+            return `You already hold ${quality.name} at rating ${held}${hint(` -- "qualities ${quality.key} ${held + 1}" raises it`)}.`;
         }
         // RAW forbids the one stacking this catalog can produce: High Pain
         // Tolerance never combines with a pain editor (p.74).
         if (quality.key === 'high-pain-tolerance' && actor.hasAug('pain-editor')) {
             return `The pain editor already owns that circuit -- High Pain Tolerance can't grow where chrome filters first${hint(' (SR5e p.74)')}.`;
         }
-        const cost = quality.karma * 2;
+        // Per rating, for the ratings not yet held: raising 2 -> 4 pays for
+        // two, not four.
+        const cost = quality.karma * (rating - held) * 2;
+        const label = quality.maxRating ? `${quality.name} ${rating}` : quality.name;
         if (actor.karma < cost) {
-            return `${quality.name} costs ${cost} karma in play${hint(` (listed ${quality.karma} x2, ${quality.page})`)} -- you have ${actor.karma}.`;
+            return `${label} costs ${cost} karma in play${hint(` (listed ${quality.karma}${quality.maxRating ? ' a rating' : ''} x2, ${quality.page})`)} -- you have ${actor.karma}.`;
         }
         actor.karma -= cost;
-        actor.addQuality(quality.key);
-        this.actor.performAction('grows into', quality.name);
-        this.logger.write(`${actor.name} bought quality ${quality.key} (${cost} karma, ${actor.karma} left).`);
+        actor.addQuality(quality.key, rating);
+        this.actor.performAction(held > 0 ? 'deepens' : 'grows into', label);
+        this.logger.write(`${actor.name} bought quality ${quality.key}${quality.maxRating ? ` at rating ${rating}` : ''} (${cost} karma, ${actor.karma} left).`);
         this.scene.updateStatus();
-        return `It took the downtime to make it true, but it's true now: ${quality.name}. ${quality.effect}. (${cost} karma spent, ${actor.karma} left.)`;
+        return held > 0
+            ? `The discipline deepens: ${label}. ${quality.effect}. (${cost} karma spent, ${actor.karma} left.)`
+            : `It took the downtime to make it true, but it's true now: ${label}. ${quality.effect}. (${cost} karma spent, ${actor.karma} left.)`;
     }
     buyOffNegative(quality) {
         const actor = this.actor;
@@ -106,10 +140,14 @@ export class QualityTradeCommand extends Command {
         if (owned.length > 0) {
             lines.push(`Yours:`);
             for (const q of owned) {
+                const held = actor.qualityRating(q.key);
                 const trade = q.kind === 'negative'
                     ? `  buy off for ${q.karma * 2} karma${actor.karma >= q.karma * 2 ? '' : ' (short)'}`
-                    : ` (yours to keep)`;
-                lines.push(`  ${(q.kind === 'positive' ? '+ ' : '- ') + q.name.padEnd(24)} ${q.effect}${trade}`);
+                    : q.maxRating && held < q.maxRating
+                        ? ` (rating ${held} of ${q.maxRating} -- ${q.karma * 2} karma a rating to raise)`
+                        : ` (yours to keep)`;
+                const name = q.maxRating ? `${q.name} ${held}` : q.name;
+                lines.push(`  ${(q.kind === 'positive' ? '+ ' : '- ') + name.padEnd(24)} ${q.effect}${trade}`);
             }
         }
         const buyable = onSale().filter(q => q.kind === 'positive' && !actor.hasQuality(q.key));
@@ -117,7 +155,7 @@ export class QualityTradeCommand extends Command {
             lines.push(`On the board${hint(' (listed x2 to learn in play)')}:`);
             for (const q of buyable) {
                 const blocked = q.key === 'high-pain-tolerance' && actor.hasAug('pain-editor');
-                lines.push(`  + ${q.name.padEnd(24)} ${q.effect} -- ${q.karma * 2} karma${blocked ? ' (BLOCKED: pain editor)' : actor.karma >= q.karma * 2 ? '' : ' (short)'}`);
+                lines.push(`  + ${q.name.padEnd(24)} ${q.effect} -- ${q.karma * 2} karma${q.maxRating ? ` a rating (to ${q.maxRating})` : ''}${blocked ? ' (BLOCKED: pain editor)' : actor.karma >= q.karma * 2 ? '' : ' (short)'}`);
             }
         }
         const footer = hint(`"qualities <name>" buys a positive or buys off a negative. Negatives can't be taken on for karma -- the street hands those out for free (see your sheet's Stains).`);

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

@@ -1,3 +1,4 @@
+import { sustainBurden } from '../utilities/sustaining.js';
 import { Command } from './command.js';
 import { homeGrid } from '../utilities/grids.js';
 import { getAspect } from '../aspects.js';
@@ -172,7 +173,7 @@ export class SheetCommand extends Command {
             ...(a.initiationGrade > 0 ? [row(a.isTechnomancer() ? 'Submersion' : 'Initiation', `grade ${a.initiationGrade} -- ${catalogMetamagics().filter(m => a.hasMetamagic(m.key)).map(m => m.name).join(', ')}`)] : []),
             ...(a.lockedFatigue > 0 ? [row('Fatigue', `${a.lockedFatigue} stun LOCKED until the need is met`)] : []),
             ...(a.woundModifier < 0 ? [row('Wounds', `${a.woundModifier} dice on everything`)] : []),
-            ...(a.sustainedArmor > 0 ? [row('Sustained', `armor +${a.sustainedArmor} soak (-2 dice)`)] : []),
+            ...(a.sustainedArmor > 0 ? [row('Sustained', `armor +${a.sustainedArmor} soak (${sustainBurden(a.sustainedLedger().find(w => w.key === 'armor'))})`)] : []),
         ];
         return lines.join('\n');
     }

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

@@ -1,3 +1,4 @@
+import { sustainBurden } from '../utilities/sustaining.js';
 import { Command } from './command.js';
 import { Category } from '../types/shared/item-enum.js';
 import { hint } from '../utilities/hints.js';
@@ -66,20 +67,25 @@ export class SpellsCommand extends Command {
         // The sustained STATE is data; the release coaching is a hint
         // (player ruling: the spellbook's reference facts stay, its
         // tutorials go behind the hints toggle).
+        // The cost per working is the engine's (Player.sustainedLedger): a
+        // Focused Concentration holder reads "no penalty" here, not a
+        // restated -2.
+        const ledger = actor.sustainedLedger();
+        const burden = (key) => sustainBurden(ledger.find(w => w.key === key), ' to everything else');
         if (actor.sustainedArmor > 0) {
-            lines.push(`Sustained: armor spell, +${actor.sustainedArmor} soak (-2 dice to everything else).${hint(' Cast armor again to release.')}`);
+            lines.push(`Sustained: armor spell, +${actor.sustainedArmor} soak (${burden('armor')}).${hint(' Cast armor again to release.')}`);
         }
         if (actor.sustainedInvisibility) {
-            lines.push(`Sustained: invisibility, +3 on sneak contests (-2 dice to everything else).${hint(' Cast invisibility again to release.')}`);
+            lines.push(`Sustained: invisibility, +3 on sneak contests (${burden('invisibility')}).${hint(' Cast invisibility again to release.')}`);
         }
         if (actor.sustainedBarrier) {
-            lines.push(`Sustained: force barrier sealing ${actor.sustainedBarrier.direction} in ${actor.sustainedBarrier.roomName}, Force ${actor.sustainedBarrier.force} (-2 dice to everything else).${hint(' Cast barrier again to release.')}`);
+            lines.push(`Sustained: force barrier sealing ${actor.sustainedBarrier.direction} in ${actor.sustainedBarrier.roomName}, Force ${actor.sustainedBarrier.force} (${burden('barrier')}).${hint(' Cast barrier again to release.')}`);
         }
         if (actor.sustainedManaBarrier) {
-            lines.push(`Sustained: mana barrier sealing ${actor.sustainedManaBarrier.direction} in ${actor.sustainedManaBarrier.roomName}, Force ${actor.sustainedManaBarrier.force} (-2 dice to everything else).${hint(' Cast manabarrier again to release.')}`);
+            lines.push(`Sustained: mana barrier sealing ${actor.sustainedManaBarrier.direction} in ${actor.sustainedManaBarrier.roomName}, Force ${actor.sustainedManaBarrier.force} (${burden('manabarrier')}).${hint(' Cast manabarrier again to release.')}`);
         }
         if (actor.sustainedReflexes) {
-            lines.push(`Sustained: increase reflexes, +2 initiative (-2 dice to everything else).${hint(' Cast it again to release.')}`);
+            lines.push(`Sustained: increase reflexes, +2 initiative (${burden('reflexes')}).${hint(' Cast it again to release.')}`);
         }
         // The spells themselves -- only what this actor actually knows.
         // Grouped RAW-style (p.283-293): combat's direct/indirect split is

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

@@ -1,3 +1,4 @@
+import { sustainTotal } from '../utilities/sustaining.js';
 import { Command } from './command.js';
 import { hint } from '../utilities/hints.js';
 import { fuzzyPickName } from '../utilities/fuzzy-match.js';
@@ -93,14 +94,17 @@ export class SustainCommand extends Command {
                     // "Machine Sprite (Level 1) (Level 1)". Caught on a bench --
                     // the kind of thing that reads as a rendering bug and gets
                     // the whole item bounced.
-                    lines.push(`  ${h.npc.name} holds ${h.npc.sustainedForms.map(f => f.key).join(', ')} -- ${h.npc.sustainedForms.length * 2} dice off THEIR pools, none off yours.`);
+                    lines.push(`  ${h.npc.name} holds ${h.npc.sustainedForms.map(f => f.key).join(', ')} -- ${h.npc.sustainedLedger().filter(w => w.kind === 'form').reduce((n, w) => n + w.cost, 0)} dice off THEIR pools, none off yours.`);
                 }
             }
             if (mine.length === 0 && lines.length === 0) {
                 return `You hold no complex forms, and nothing of yours is holding one for you.${hint(` ("thread <form>" weaves one.)`)}`;
             }
+            // The cost is the engine's (Player.sustainedLedger): Focused
+            // Concentration covers a complex form exactly as it covers a spell
+            // (p.74), and this line says so rather than restating -2.
             const yours = mine.length > 0
-                ? `You are sustaining ${mine.map(f => f.key).join(', ')} yourself -- ${mine.length * 2} dice off everything you do.`
+                ? `You are sustaining ${mine.map(f => f.key).join(', ')} yourself -- ${sustainTotal(actor.sustainedLedger().filter(w => w.kind === 'form'), ' off everything you do')}.`
                 : `You are sustaining nothing yourself.`;
             const offer = mine.length > 0 && sprites.length > 0
                 ? hint(`\n("sustain <form>" hands one to a registered sprite for a task.)`)

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

@@ -1,3 +1,4 @@
+import { sustainBurden, sustainTotal } from '../utilities/sustaining.js';
 import { Command } from './command.js';
 import { matrixConstructsInReach } from '../utilities/matrix-roster.js';
 import { rollPool, formatRoll } from '../utilities/dice.js';
@@ -69,7 +70,7 @@ export class ThreadCommand extends Command {
                 lines.push(`  ${f.name.padEnd(16)} ${f.kind === 'sustained' ? '[sustained]' : '[instant]  '} ${f.blurb}${held ? ' {cyan-fg}(HELD){/cyan-fg}' : ''}`);
             }
             if (actor.sustainedForms.length > 0) {
-                lines.push('', `  Holding ${actor.sustainedForms.length} form${actor.sustainedForms.length === 1 ? '' : 's'} (-${actor.sustainedForms.length * 2} dice).${hint(` ("thread drop <form>" releases.)`)}`);
+                lines.push('', `  Holding ${actor.sustainedForms.length} form${actor.sustainedForms.length === 1 ? '' : 's'} (${sustainTotal(actor.sustainedLedger().filter(w => w.kind === 'form'))}).${hint(` ("thread drop <form>" releases.)`)}`);
             }
             return lines.join('\n');
         }
@@ -310,7 +311,8 @@ export class ThreadCommand extends Command {
                 // how ambitious it was and not how well it went.
                 actor.sustainedForms.push({ key: form.key, level, hits });
                 const effect = form.key === 'diagnostics' ? '+2 to your Matrix pools' : '+2 Matrix defense';
-                return [`  ${form.name} settles over your persona and HOLDS -- ${effect} while you sustain it (-2 dice to everything else).${hint(` ("thread drop ${form.key}" releases.)`)}`];
+                const burden = sustainBurden(actor.sustainedLedger().find(w => w.key === form.key), ' to everything else');
+                return [`  ${form.name} settles over your persona and HOLDS -- ${effect} while you sustain it (${burden}).${hint(` ("thread drop ${form.key}" releases.)`)}`];
             }
             default:
                 return [`  The form resolves and fades.`];

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

@@ -1,3 +1,4 @@
+import { sustainBurden, sustainTotal } from './utilities/sustaining.js';
 import { agentRatingFromName } from './utilities/programs.js';
 import { MATRIX_STANCE_ACTION } from './models/player.js';
 import { buildDossierUrl } from './utilities/web-character-generator.js';
@@ -5276,8 +5277,13 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         lines.push(`${armorNote}${arSlot}  |  ${link}  |  ${docwagon}`);
         // Lines 4+: transient states, present only while active. Future
         // contexts (astral projection, VR hot-sim) join here the same way.
+        // THE COST IS THE ENGINE'S. Every one of these lines printed a
+        // literal -2 until 2026-09-06, while sustainingPenalty was already
+        // waiving a Focused Concentration holder's spell -- the HUD told the
+        // player they were paying for what the pools were not charging.
+        const ledger = player.sustainedLedger();
         if (player.sustainedArmor > 0) {
-            lines.push(`{magenta-fg}Sustained: armor +${player.sustainedArmor} soak (-2 dice to everything else){/magenta-fg}`);
+            lines.push(`{magenta-fg}Sustained: armor +${player.sustainedArmor} soak (${sustainBurden(ledger.find(w => w.key === 'armor'), ' to everything else')}){/magenta-fg}`);
         }
         // THE MAGE'S HALF OF THE SAME QUESTION (TNf9WrZGxCmCzqA4L, scope
         // completed by ruling).
@@ -5317,7 +5323,8 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             heldSpells.push(`mana barrier (${player.sustainedManaBarrier.roomName} ${player.sustainedManaBarrier.direction})`);
         }
         if (heldSpells.length > 0) {
-            lines.push(`{magenta-fg}✴ Sustained: ${heldSpells.join(', ')} (-${heldSpells.length * 2} dice){/magenta-fg}`);
+            const these = ledger.filter(w => w.kind === 'spell' && w.key !== 'armor');
+            lines.push(`{magenta-fg}✴ Sustained: ${heldSpells.join(', ')} (${sustainTotal(these)}){/magenta-fg}`);
         }
         // ACTIVE THREADS, WITHOUT ASKING (TNf9WrZGxCmCzqA4L: "instead of
         // saying 'sustain' to see the active threads, list the threads in
@@ -5348,7 +5355,7 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             : [];
         if (ownThreads.length > 0 || spriteHeld.length > 0) {
             const mine = ownThreads.length > 0
-                ? `${ownThreads.map(f => f.key).join(', ')} (-${ownThreads.length * 2} dice)`
+                ? `${ownThreads.map(f => f.key).join(', ')} (${sustainTotal(ledger.filter(w => w.kind === 'form'))})`
                 : `none yourself`;
             const carried = spriteHeld.length > 0 ? `  |  ${spriteHeld.join('; ')}` : '';
             lines.push(`{magenta-fg}✴ Threads: ${mine}${carried}{/magenta-fg}`);