@maka/maka-cli 5.121.0 → 5.122.0

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

@@ -2,35 +2,55 @@ import { Player } from './models/player.js';
 import { Item } from './models/item.js';
 import { Size, Category, Rating } from './types/shared/item-enum.js';
 import { getAug } from './augmentations.js';
-import { creationSplit } from './qualities.js';
-const gearDef = (partial) => ({
-    size: Size.Small,
-    weight: 1,
-    shape: 'Gear',
-    color: 'Black',
-    texture: 'Matte',
-    ...partial,
-});
+import { creationSplit, getQuality, 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 = [
     {
         // No qualities at all IS the identity: nothing bought, nothing owed --
         // the untouched 25 ledger splits per RAW into 7 karma + 20,000 nuyen.
         name: 'Runner',
+        priorities: { metatype: 'C', attributes: 'A', magic: 'E', skills: 'B', resources: 'D' },
         description: 'The balanced default: decent at everything, spectacular at nothing.',
-        combat: { body: 4, agility: 4, reaction: 4, combatSkill: 3, strength: 3, willpower: 3, logic: 3, intuition: 3, charisma: 3, edge: 2, magic: 0,
-            skills: { automatics: 3, pistols: 3, longarms: 3, blades: 2, unarmed: 3, sneaking: 2, perception: 3, gymnastics: 2, running: 2, swimming: 2, hacking: 1, locksmith: 1, negotiation: 2, con: 1, etiquette: 1, 'first-aid': 2 } },
+        combat: { body: 4, agility: 4, reaction: 4, combatSkill: 3, strength: 4, willpower: 4, logic: 4, intuition: 4, charisma: 4, edge: 3, magic: 0,
+            skills: { automatics: 3, pistols: 3, longarms: 3, blades: 2, unarmed: 3, sneaking: 3, perception: 4, gymnastics: 2, running: 2, swimming: 2, hacking: 1, locksmith: 1, negotiation: 3, con: 1, etiquette: 1, 'first-aid': 2 } },
+        // Nothing owed and nothing exotic -- the generalist spends the ledger
+        // on noticing things and shrugging off wounds.
+        qualities: ['perceptive', 'quick-healer'],
+        augs: [
+            'datajack', 'smartlink', 'reaction-enhancers-1', 'synaptic-booster'
+        ],
+        gearSlugs: [
+            'ares-predator-v', 'quick-draw-holster', 'spare-clip', 'regular-ammo',
+            'gel-rounds', 'defiance-t-250', 'armor-jacket', 'combat-boots',
+            'erika-elite', 'fake-sin-4', 'fake-license-4', 'medkit-3', 'trauma-patch',
+            'stim-patch', 'ear-buds', 'glasses', 'microtransceiver', 'lockpick-set',
+            'tool-kit', 'climbing-gear', 'stealth-rope', 'survival-kit',
+            'respirator-4', 'smoke-grenade', 'flash-bang', 'tag-eraser',
+            'white-noise-generator', 'mapsoft', 'credstick-silver'
+        ],
     },
     {
         name: 'Street Samurai',
+        priorities: { metatype: 'C', attributes: 'B', magic: 'E', skills: 'A', resources: 'D' },
         description: 'Chrome and trigger discipline. Hits hard, soaks harder, thinks later.',
         combat: { body: 5, agility: 5, reaction: 4, combatSkill: 5, strength: 4, willpower: 3, logic: 2, intuition: 3, charisma: 2, edge: 2, magic: 0,
-            skills: { automatics: 6, pistols: 6, longarms: 6, blades: 4, unarmed: 5, gymnastics: 4, running: 4, swimming: 4, perception: 3, intimidation: 4, sneaking: 2, 'first-aid': 1 } },
-        augs: ['wired-reflexes-1', 'smartlink'],
+            skills: { automatics: 6, pistols: 6, longarms: 6, blades: 4, unarmed: 5, gymnastics: 4, running: 3, swimming: 3, perception: 3, intimidation: 4, sneaking: 2 } },
         // Built to take a beating; the record says the beatings went both
         // ways. Ledger 25 - 16 + 10 = 19 -> 7 karma + 20,000 nuyen.
-        qualities: ['toughness', 'high-pain-tolerance', 'sinner-criminal'],
-        gear: [
-            gearDef({ name: 'Ares Predator V', description: 'The iconic heavy pistol of the shadows -- smartgun-linked, and it never jams when it matters.', category: Category.RangedWeapon, rating: Rating.Rare, shape: 'Pistol', weight: 2 }),
+        qualities: ['toughness', 'high-pain-tolerance', 'quick-healer', 'sinner-criminal'],
+        // The book's own sam (p.112): the Predator with its smartgun, and a
+        // lined coat -- Armor 9 under the street jacket.
+        augs: [
+            'wired-reflexes-1', 'smartlink', 'bone-lacing', 'dermal-plating-2',
+            'platelet-factories', 'cybereyes', 'vision-enhancement-2'
+        ],
+        gearSlugs: [
+            'ares-predator-v', 'quick-draw-holster', 'spare-clip', 'regular-ammo',
+            'apds', 'ares-alpha', 'combat-knife', 'lined-coat', 'armored-pants',
+            'combat-boots', 'helmet', 'hermes-ikon', 'fake-sin-4', 'fake-license-4',
+            'medkit-6', 'trauma-patch', 'stim-patch', 'ear-buds', 'glasses',
+            'microtransceiver', 'white-noise-generator', 'survival-kit',
+            'credstick-silver'
         ],
     },
     {
@@ -38,6 +58,7 @@ export const ARCHETYPES = [
         // nothing and cannot project -- half their magic rides every meat
         // attack and defense pool instead (see Player.adept).
         name: 'Adept',
+        priorities: { metatype: 'D', attributes: 'B', magic: 'C', skills: 'A', resources: 'E' },
         description: 'Magic as muscle: faster than chrome, no spells, no projection -- the body IS the focus.',
         // CHOSEN POWERS (regen 2026-09-01): Magic 5 = 5 free Power Points
         // (p.69), spent to the last half-point -- Improved Reflexes 2 (2.5) +
@@ -45,14 +66,19 @@ export const ARCHETYPES = [
         // Sense 1 (0.5) + Mystic Armor 1 (0.5). Richer than the compressed
         // floor(5/2) bonus this replaces: real initiative, physical fists,
         // armor that was never worn.
-        combat: { body: 4, agility: 4, reaction: 4, combatSkill: 4, strength: 4, willpower: 4, logic: 2, intuition: 3, charisma: 2, edge: 2, magic: 5, adept: true,
+        combat: { body: 4, agility: 4, reaction: 4, combatSkill: 4, strength: 4, willpower: 4, logic: 2, intuition: 3, charisma: 3, edge: 2, magic: 5, adept: true,
             adeptPowers: { 'improved-reflexes': 2, 'improved-ability-combat': 2, 'killing-hands': 1, 'combat-sense': 1, 'mystic-armor': 1 },
             skills: { blades: 6, unarmed: 5, gymnastics: 5, running: 5, swimming: 5, sneaking: 4, perception: 3, assensing: 3, intimidation: 2, automatics: 2, pistols: 2, longarms: 2 } },
         // The body IS the focus -- and it rejects the sim the way it rejects
         // chrome. Ledger 25 - 14 + 5 = 16 -> 7 karma + 18,000 nuyen.
         qualities: ['catlike', 'natural-athlete', 'simsense-vertigo'],
-        gear: [
-            gearDef({ name: 'Weapon Focus Katana', description: 'A blade that drinks its wielder\'s magic -- the edge sings at frequencies steel shouldn\'t reach.', category: Category.MeleeWeapon, rating: Rating.Rare, size: Size.Medium, shape: 'Sword', color: 'Silver', texture: 'Folded Steel', weight: 1.5 }),
+        // The katana is the p.423 row (Acc 7, STR+3, AP -3); the bonded weapon
+        // focus rides beside it as the Force 1 row.
+        gearSlugs: [
+            'katana', 'weapon-focus-1', 'qi-focus-1', 'combat-knife', 'armor-jacket',
+            'combat-boots', 'fake-sin-2', 'meta-link', 'medkit-3', 'trauma-patch',
+            'stim-patch', 'ear-buds', 'glasses', 'climbing-gear', 'stealth-rope',
+            'gecko-tape-gloves', 'survival-kit', 'credstick-silver'
         ],
     },
     {
@@ -63,6 +89,7 @@ export const ARCHETYPES = [
         // body, and NEVER astrally projects -- the one place the path sides
         // with the adept.
         name: 'Mystic Adept',
+        priorities: { metatype: 'D', attributes: 'C', magic: 'A', skills: 'B', resources: 'E' },
         description: 'Spell in one hand, killing hands on the other -- both worlds, and the astral door stays shut.',
         // Ledger: 25 - 10 (2 Power Points) + 10 (Astral Beacon) = 25 -> 7
         // karma + 20,000 nuyen. The beacon is the price of burning on both
@@ -70,34 +97,48 @@ export const ARCHETYPES = [
         // Powers: Improved Reflexes 1 (1.5) + Killing Hands (0.5) = 2.0 --
         // the bought points, spent whole. Spells: Magic 6 allows 12; eight
         // chosen, breadth over artillery.
-        combat: { body: 3, agility: 3, reaction: 3, combatSkill: 3, strength: 3, willpower: 4, logic: 3, intuition: 4, charisma: 3, edge: 2, magic: 6, adept: false, powerPoints: 2,
+        combat: { body: 3, agility: 3, reaction: 3, combatSkill: 3, strength: 2, willpower: 4, logic: 3, intuition: 4, charisma: 2, edge: 2, magic: 6, adept: false, powerPoints: 2,
             knownSpells: ['manabolt', 'stunbolt', 'fireball', 'heal', 'armor', 'invisibility', 'reflexes', 'barrier'],
             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: ['astral-beacon'],
-        gear: [
-            gearDef({ name: 'Twin-Path Amulet', description: 'A focus worn where the two disciplines meet -- half orichalcum lens, half knuckle charm.', category: Category.Focus, rating: Rating.Standard, size: Size.Tiny, shape: 'Amulet', color: 'Copper', texture: 'Braided Metal', weight: 0.1 }),
+        qualities: ['focused-concentration', 'mentor-spirit', 'astral-beacon'],
+        gearSlugs: [
+            'power-focus-1', 'reagents', 'armor-jacket', 'combat-boots', 'meta-link',
+            'medkit-3', 'trauma-patch', 'stim-patch', 'ear-buds', 'glasses',
+            'survival-kit', 'credstick-silver'
         ],
     },
     {
         name: 'Covert Ops',
+        priorities: { metatype: 'C', attributes: 'B', magic: 'E', skills: 'A', resources: 'D' },
         description: 'In through the vents, out before the alarm. Locks are suggestions.',
-        combat: { body: 3, agility: 5, reaction: 4, combatSkill: 3, strength: 3, willpower: 3, logic: 3, intuition: 5, charisma: 3, edge: 3, magic: 0,
+        combat: { body: 3, agility: 5, reaction: 4, combatSkill: 3, strength: 3, willpower: 2, logic: 3, intuition: 5, charisma: 3, edge: 3, magic: 0,
             skills: { sneaking: 6, locksmith: 5, perception: 4, gymnastics: 4, running: 4, swimming: 4, automatics: 3, pistols: 3, longarms: 3, unarmed: 3, con: 3, hacking: 2 } },
-        augs: ['cybereyes'],
         // Quiet, charmed, and never quite off duty -- the paranoia that keeps
         // you alive doesn't sleep either. Ledger 25 - 19 + 15 = 21 -> 7 karma
         // + 20,000 nuyen.
-        qualities: ['catlike', 'lucky', 'sinner-national', 'insomnia'],
-        gear: [
-            gearDef({ name: 'Lockpick Set', description: 'Precision picks, tension bars, and a maglock passkey of arguable legality.', category: Category.Tool, rating: Rating.Standard, size: Size.Tiny, weight: 0.3 }),
-            gearDef({ name: 'Chameleon Suit', description: 'Ruthenium-coated infiltration wear that drinks the light around it.', category: Category.ArmorClothing, rating: Rating.Standard, size: Size.Medium, shape: 'Suit', color: 'Shifting Gray', texture: 'Ruthenium Weave', weight: 2 }),
+        qualities: ['catlike', 'lucky', 'innocuous', 'sinner-national', 'insomnia'],
+        // The picks, and a Sequencer that now rolls its rating against the
+        // lock's (pick.ts). "Locks are suggestions" has teeth.
+        augs: [
+            'cybereyes', 'vision-enhancement-2', 'datajack', 'muscle-toner-1'
+        ],
+        gearSlugs: [
+            'chameleon-suit', 'lockpick-set', 'sequencer-4', 'autopicker-3',
+            'keycard-copier-4', 'grapple-gun', 'stealth-rope', 'climbing-gear',
+            'rappelling-gloves', 'gecko-tape-gloves', 'tag-eraser', 'stealth-tags',
+            'micro-camera', 'data-tap', 'white-noise-generator', 'erika-elite',
+            'fake-sin-4', 'fake-license-4', 'ares-light-fire-70', 'silencer',
+            'spare-clip', 'regular-ammo', 'medkit-3', 'trauma-patch', 'stim-patch',
+            'ear-buds', 'glasses', 'respirator-4', 'chisel-crowbar', 'survival-kit',
+            'combat-boots', 'credstick-silver'
         ],
     },
     {
         name: 'Face',
+        priorities: { metatype: 'C', attributes: 'B', magic: 'E', skills: 'A', resources: 'D' },
         description: 'Talks the job open before anyone draws. Charm, luck, and just enough gun.',
-        combat: { body: 3, agility: 3, reaction: 3, combatSkill: 3, strength: 3, willpower: 4, logic: 3, intuition: 4, charisma: 6, edge: 3, magic: 0,
+        combat: { body: 3, agility: 3, reaction: 3, combatSkill: 3, strength: 2, willpower: 4, logic: 3, intuition: 4, charisma: 6, edge: 3, magic: 0,
             // Etiquette in for sneaking: the Face blends SOCIALLY (RAW p.138:
             // "a social version of Sneak") -- vents are someone else's job.
             // Leadership in for intimidation (same Cha-social slot, ledger
@@ -107,44 +148,69 @@ export const ARCHETYPES = [
         // opens doors is exactly what witnesses describe to Knight Errant.
         // Ledger 25 - 23 + 10 = 12 -> 7 karma + 10,000 nuyen.
         qualities: ['first-impression', 'lucky', 'distinctive-style', 'sinner-national'],
-        gear: [
-            gearDef({ name: 'Transys Avalon', description: 'A top-shelf commlink -- the AR overlay alone is worth the felony it took to afford it.', category: Category.Commlink, rating: Rating.Rare, size: Size.Tiny, weight: 0.2 }),
-            gearDef({ name: 'Berwick Suit', description: 'Tailored armor-weave that reads boardroom, not battlefield.', category: Category.ArmorClothing, rating: Rating.Standard, size: Size.Medium, shape: 'Suit', color: 'Charcoal', texture: 'Armored Silk', weight: 2 }),
+        // The book's Face (p.119): the Avalon, Actioneer Business Clothes
+        // (Armor 8), and a Shopsoft on the link for the haggle.
+        augs: [
+            'tailored-pheromones-2', 'cybereyes', 'vision-enhancement-1', 'datajack'
+        ],
+        gearSlugs: [
+            'transys-avalon', 'actioneer-business-clothes', 'shopsoft',
+            'electrochromic-clothing', 'fake-sin-4', 'fake-license-4',
+            'ares-light-fire-70', 'quick-draw-holster', 'spare-clip', 'regular-ammo',
+            'micro-camera', 'data-tap', 'tag-eraser', 'white-noise-generator',
+            'microtransceiver', 'ear-buds', 'glasses', 'medkit-3', 'stim-patch',
+            'mapsoft', 'combat-boots', 'credstick-gold'
         ],
     },
     {
         name: 'Street Doc',
+        priorities: { metatype: 'B', attributes: 'A', magic: 'E', skills: 'C', resources: 'D' },
         description: 'Keeps the team breathing: brains, steady hands, and a bag full of trauma kits.',
-        combat: { body: 3, agility: 3, reaction: 3, combatSkill: 2, strength: 3, willpower: 4, logic: 6, intuition: 4, charisma: 3, edge: 2, magic: 0,
+        combat: { body: 4, agility: 4, reaction: 4, combatSkill: 2, strength: 3, willpower: 4, logic: 6, intuition: 4, charisma: 3, edge: 4, magic: 0,
             skills: { 'first-aid': 6, perception: 4, negotiation: 3, automatics: 2, pistols: 2, longarms: 2, unarmed: 2, hacking: 2, con: 2 } },
         // Brilliant hands that freeze when the shooting starts -- which is
         // why they became the one who patches, not the one who charges.
         // Ledger 25 - 8 + 12 = 29 -> 7 karma + 20,000 nuyen.
-        qualities: ['quick-healer', 'analytical-mind', 'combat-paralysis'],
-        gear: [
-            gearDef({ name: 'Trauma Kit', description: 'A doc-grade field kit: sprays, staples, and things that hiss.', category: Category.Medical, rating: Rating.Rare, weight: 1.5 }),
-            gearDef({ name: 'Kamikaze Stim Patch', description: 'A combat stim slap-patch. The crash is tomorrow\'s problem.', category: Category.StimPatch, rating: Rating.Standard, size: Size.Tiny, weight: 0.1 }),
+        qualities: ['quick-healer', 'analytical-mind', 'photographic-memory', 'resistance-pathogens-and-toxins', 'combat-paralysis'],
+        // The Rating 6 medkit is the kit that thinks (first-aid.ts).
+        augs: [
+            'cybereyes', 'vision-enhancement-1', 'datajack', 'cerebral-booster-1',
+            'symbiotes-1'
+        ],
+        gearSlugs: [
+            'medkit-6', 'medkit-supplies', 'disposable-syringe', 'antidote-patch-4',
+            'tranq-patch-6', 'biomonitor', 'trauma-patch', 'stim-patch',
+            'armor-jacket', 'combat-boots', 'renraku-sensei', 'fake-sin-4',
+            'fake-license-4', 'ares-light-fire-70', 'quick-draw-holster', 'spare-clip',
+            'regular-ammo', 'ear-buds', 'glasses', 'tool-kit', 'gas-mask',
+            'respirator-4', 'survival-kit', 'credstick-silver'
         ],
     },
     {
         name: 'Combat Mage',
+        priorities: { metatype: 'D', attributes: 'B', magic: 'A', skills: 'C', resources: 'E' },
         description: 'Awakened artillery: manabolts through milspec armor, if the drain doesn\'t eat you first.',
         // CHOSEN SPELLBOOK (regen 2026-09-01): Magic 6 knows up to 12 (p.300)
         // and the artillery build takes all 12 -- every combat spell in the
         // catalog plus the sustains that keep the caster standing.
-        combat: { body: 3, agility: 3, reaction: 3, combatSkill: 2, strength: 2, willpower: 5, logic: 4, intuition: 4, charisma: 3, edge: 2, magic: 6,
+        combat: { body: 4, agility: 3, reaction: 3, combatSkill: 2, strength: 2, willpower: 5, logic: 4, intuition: 4, charisma: 3, edge: 2, magic: 6,
             knownSpells: ['manabolt', 'stunbolt', 'powerbolt', 'fireball', 'lightning-bolt', 'ball-lightning', 'manaball', 'stunball', 'armor', 'heal', 'reflexes', 'barrier'],
             skills: { spellcasting: 6, counterspelling: 4, assensing: 4, conjuring: 3, perception: 3, unarmed: 2, automatics: 2, pistols: 2, longarms: 2 } },
         // Drain taught them what pain is worth ignoring; the astral bleeds
         // into their dreams and calls it rent. Ledger 25 - 7 + 10 = 28 -> 7
         // karma + 20,000 nuyen.
-        qualities: ['high-pain-tolerance', 'insomnia'],
-        gear: [
-            gearDef({ name: 'Spellcasting Focus', description: 'An orichalcum-threaded ring that gathers mana the way a lens gathers light.', category: Category.Focus, rating: Rating.Standard, size: Size.Tiny, shape: 'Ring', color: 'Gold', texture: 'Orichalcum', weight: 0.1 }),
+        qualities: ['high-pain-tolerance', 'focused-concentration', 'mentor-spirit', 'quick-healer', 'insomnia'],
+        gearSlugs: [
+            'spell-focus-1', 'combat-spell-formula', 'reagents', 'lodge-materials-3',
+            'armor-jacket', 'combat-boots', 'fake-sin-2', 'fake-license-4',
+            'meta-link', 'ares-light-fire-70', 'spare-clip', 'regular-ammo',
+            'medkit-3', 'trauma-patch', 'stim-patch', 'ear-buds', 'glasses',
+            'credstick-silver'
         ],
     },
     {
         name: 'Street Shaman',
+        priorities: { metatype: 'D', attributes: 'B', magic: 'C', skills: 'A', resources: 'E' },
         description: 'Awakened the hard way: iron will, sharp instincts, spirits on speed dial.',
         // CHOSEN SPELLBOOK (regen 2026-09-01): Magic 5 knows up to 10 (p.300)
         // -- the mender's list: mercy settings, wards, and the heal that is
@@ -156,8 +222,71 @@ export const ARCHETYPES = [
         // but nobody forgets the one draped in bones and braided wire.
         // Ledger 25 - 15 + 5 = 15 -> 7 karma + 16,000 nuyen.
         qualities: ['lucky', 'quick-healer', 'distinctive-style'],
-        gear: [
-            gearDef({ name: 'Spirit Talisman', description: 'Feathers, bone, and braided wire -- a focus that hums when the other world leans close.', category: Category.Focus, rating: Rating.Standard, size: Size.Tiny, shape: 'Talisman', color: 'Bone White', texture: 'Feather and Wire', weight: 0.2 }),
+        gearSlugs: [
+            'spirit-focus-1', 'lodge-materials-3', 'reagents', 'armor-jacket',
+            'combat-boots', 'fake-sin-2', 'meta-link', 'ares-light-fire-70',
+            'spare-clip', 'regular-ammo', 'medkit-3', 'trauma-patch', 'stim-patch',
+            'ear-buds', 'glasses', 'survival-kit', 'credstick-silver'
+        ],
+    },
+    {
+        // THE ASPECTED MAGICIAN, FINALLY PLAYABLE FROM THE MENU (user ask,
+        // 2026-09-03: "how about the aspected magician?"). aspects.ts, the
+        // Player.aspect field, the chargen path and the verb gates in
+        // summon.ts / cast.ts / dispel.ts have all been here since
+        // 2026-09-02 -- there was simply no pregen carrying `aspect`, so the
+        // fifth magical path existed everywhere except where a player picks
+        // a character. Two of them, because the engine honours exactly two
+        // aspects: Enchanter waits on alchemy (UNAVAILABLE_ASPECTS).
+        //
+        // Magic B on the Aspected row is Magic 5 (p.65, ASPECTED_PRIORITY) --
+        // the same rating the full magician gets at B, which is the trade:
+        // half the art, none of the discount.
+        name: 'Sorcerer',
+        priorities: { metatype: 'C', attributes: 'A', magic: 'B', skills: 'E', resources: 'D' },
+        description: 'Spells and nothing else: no spirits will ever answer you, and the astral is a window you cannot climb through.',
+        combat: { body: 3, agility: 3, reaction: 3, combatSkill: 2, strength: 2, willpower: 6, logic: 5, intuition: 5, charisma: 5, edge: 3, magic: 5, aspect: 'sorcerer',
+            // Magic x 2 at creation (p.69), the same cap a full magician's
+            // spellbook uses -- an aspected caster is not a smaller caster.
+            knownSpells: ['manabolt', 'stunbolt', 'powerbolt', 'manaball', 'stunball', 'lightning-bolt', 'armor', 'heal', 'reflexes', 'barrier'],
+            // Sorcery only. `conjuring` is absent on purpose and enforced twice
+            // over: the chargen payload check (forbiddenSkillsFor) and
+            // summon.ts's aspect gate.
+            skills: { spellcasting: 4, counterspelling: 4, 'ritual-spellcasting': 4, assensing: 4, perception: 4, negotiation: 3, unarmed: 3, gymnastics: 2, sneaking: 2 } },
+        // One art, held deeper than a generalist holds two -- and a mentor
+        // who never let them look at the other half.
+        // Ledger 25 - 9 = 16 -> 7 karma + 18,000 nuyen.
+        qualities: ['focused-concentration', 'mentor-spirit'],
+        gearSlugs: [
+            'spell-focus-1', 'power-focus-1', 'combat-spell-formula', 'reagents',
+            'lodge-materials-3', 'armor-jacket', 'combat-boots', 'fake-sin-4',
+            'fake-license-4', 'renraku-sensei', 'mage-sight-goggles', 'medkit-3',
+            'trauma-patch', 'stim-patch', 'ear-buds', 'glasses', 'microtransceiver',
+            'white-noise-generator', 'survival-kit', 'ares-light-fire-70',
+            'spare-clip', 'regular-ammo', 'credstick-silver'
+        ],
+    },
+    {
+        // The other half of the same coin. Charisma is the maxed attribute
+        // here rather than Willpower: summoning is a negotiation with
+        // something that does not want to be there.
+        name: 'Conjurer',
+        priorities: { metatype: 'C', attributes: 'A', magic: 'B', skills: 'E', resources: 'D' },
+        description: 'Spirits answer you and nothing else does -- no spells, no counterspelling, and the astral stays a window.',
+        combat: { body: 3, agility: 3, reaction: 3, combatSkill: 2, strength: 2, willpower: 5, logic: 5, intuition: 5, charisma: 6, edge: 3, magic: 5, aspect: 'conjurer',
+            // No spellbook at all: "they cannot perform any of the magical
+            // skills associated with the two groups they did not select"
+            // (p.69), and cast.ts refuses them by aspect, not by empty list.
+            skills: { conjuring: 6, summoning: 4, binding: 4, banishing: 4, assensing: 4, perception: 4, negotiation: 2, unarmed: 2 } },
+        // 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'],
+        gearSlugs: [
+            'spirit-focus-1', 'power-focus-1', 'lodge-materials-3', 'reagents',
+            'armor-jacket', 'combat-boots', 'fake-sin-4', 'fake-license-4',
+            'renraku-sensei', 'medkit-3', 'trauma-patch', 'stim-patch', 'ear-buds',
+            'glasses', 'microtransceiver', 'survival-kit', 'ares-light-fire-70',
+            'spare-clip', 'regular-ammo', 'credstick-silver'
         ],
     },
     {
@@ -166,24 +295,40 @@ export const ARCHETYPES = [
         // deck is the requisite: its quality feeds program damage and
         // firewall, and its hardware track is what the ice chews on.
         name: 'Decker',
+        priorities: { metatype: 'D', attributes: 'B', magic: 'E', skills: 'C', resources: 'A' },
         description: 'A ghost in the grid: hosts crack, ice burns, maglocks open. Just don\'t get caught in meatspace.',
-        combat: { body: 3, agility: 2, reaction: 3, combatSkill: 2, strength: 2, willpower: 4, logic: 7, intuition: 5, charisma: 2, edge: 3, magic: 0,
+        combat: { body: 4, agility: 2, reaction: 3, combatSkill: 2, strength: 2, willpower: 4, logic: 6, intuition: 5, charisma: 2, edge: 3, magic: 0,
             skills: { hacking: 6, perception: 4, locksmith: 3, sneaking: 3, automatics: 2, pistols: 2, longarms: 2, unarmed: 2, con: 2 } },
-        augs: ['datajack'],
         // Hosts are puzzles and hardware is clay -- meatspace gunfire is
         // neither, and the freeze proves it. Ledger 25 - 15 + 12 = 22 -> 7
         // karma + 20,000 nuyen.
-        qualities: ['analytical-mind', 'juryrigger', 'combat-paralysis'],
-        gear: [
-            gearDef({ name: 'Novatech Navigator', description: 'A workhorse cyberdeck -- scuffed case, immaculate boards. Your ticket into the Matrix.', category: Category.Cyberdeck, rating: Rating.Standard, weight: 2 }),
+        qualities: ['analytical-mind', 'juryrigger', 'codeslinger-hack-on-the-fly', 'combat-paralysis'],
+        // The Navigator (DR 3, three programs running) and the book's own
+        // decker kit (p.121) trimmed to what the deck can run: the chips file
+        // into its storage on pickup (Player.addInventory).
+        augs: [
+            'datajack', 'cerebral-booster-1', 'headware-cyberdeck', 'cybereyes',
+            'vision-enhancement-1', 'sleep-regulator', 'reaction-enhancers-1'
+        ],
+        gearSlugs: [
+            'novatech-navigator', 'exploit-program', 'armor-program',
+            'biofeedback-filter-program', 'encryption-program', 'toolbox-program',
+            'signal-scrub-program', 'browse-program', 'sneak-program',
+            'hammer-program', 'decryption-program', 'agent-rating-4', 'trodes',
+            'sim-module', 'hermes-ikon', 'armor-jacket', 'combat-boots', 'fake-sin-4',
+            'fake-license-4', 'lockpick-set', 'sequencer-4', 'data-tap', 'tag-eraser',
+            'white-noise-generator', 'microtransceiver', 'medkit-6', 'trauma-patch',
+            'stim-patch', 'ear-buds', 'glasses', 'ares-light-fire-70', 'spare-clip',
+            'regular-ammo', 'mapsoft', 'shopsoft', 'credstick-silver'
         ],
     },
     {
         // The living persona (see ICombatAttributes.resonance): no deck, no
         // commlink -- and no hardware between their stun track and the ice.
         name: 'Technomancer',
+        priorities: { metatype: 'D', attributes: 'C', magic: 'A', skills: 'B', resources: 'E' },
         description: 'The Matrix answers when they think at it. No deck to brick -- only a mind to burn.',
-        combat: { body: 2, agility: 2, reaction: 3, combatSkill: 2, strength: 2, willpower: 5, logic: 5, intuition: 4, charisma: 3, edge: 3, magic: 0, resonance: 6,
+        combat: { body: 2, agility: 2, reaction: 3, combatSkill: 2, strength: 2, willpower: 5, logic: 5, intuition: 3, charisma: 2, edge: 3, magic: 0, resonance: 6,
             // The Resonance trio are three skills and the books test each by
             // name (SR5 p.250). A Technomancer who could compile and register
             // at 4 but decompile at the unskilled -1 would be an odd graduate;
@@ -194,26 +339,87 @@ export const ARCHETYPES = [
         // its 20% cut of everything) followed them into the shadows, and the
         // taxman never stops collecting. Ledger 25 - 5 + 15 = 35 -> 7 karma
         // + 20,000 nuyen (the rest went into that resonance).
-        qualities: ['analytical-mind', 'sinner-corp'],
+        qualities: ['analytical-mind', 'natural-hardening', 'prime-datahaven-membership', 'focused-concentration', 'sinner-corp'],
+        gearSlugs: [
+            'armor-jacket', 'combat-boots', 'fake-sin-4', 'meta-link',
+            'microtransceiver', 'data-tap', 'micro-camera', 'stealth-tags',
+            'tag-eraser', 'white-noise-generator', 'medkit-3', 'trauma-patch',
+            'stim-patch', 'ear-buds', 'glasses', 'tool-kit', 'survival-kit', 'mapsoft',
+            'credstick-silver'
+        ],
     },
     {
         // The drone is the mechanic: "drone" launches the Fly-Spy for live
         // recon of every adjacent room (see commands/drone.ts). Jumped-in
         // drone rigging can build on this later.
         name: 'Rigger',
+        priorities: { metatype: 'C', attributes: 'B', magic: 'E', skills: 'A', resources: 'D' },
         description: 'Eyes everywhere: the Fly-Spy scouts the next room so your body never has to.',
         combat: { body: 3, agility: 3, reaction: 5, combatSkill: 3, strength: 3, willpower: 3, logic: 5, intuition: 4, charisma: 2, edge: 2, magic: 0,
             skills: { piloting: 6, hacking: 4, perception: 4, automatics: 3, pistols: 3, longarms: 3, locksmith: 3, unarmed: 2, 'first-aid': 2 } },
-        augs: ['control-rig'],
         // Anything with a motor runs better under their hands; the drone
         // feeds run all night, and so do they. Ledger 25 - 10 + 10 = 25 -> 7
         // karma + 20,000 nuyen.
-        qualities: ['juryrigger', 'insomnia'],
-        gear: [
-            gearDef({ name: 'Fly-Spy Drone', description: 'A palm-sized surveillance drone, quiet as a moth and twice as nosy.', category: Category.Drone, rating: Rating.Standard, size: Size.Tiny, shape: 'Insectoid', color: 'Gunmetal', texture: 'Micro-rotor', weight: 0.5 }),
+        qualities: ['juryrigger', 'gearhead', 'insomnia'],
+        // The p.466 row: Pilot 3, Body 1, a real hull.
+        augs: [
+            'control-rig', 'datajack', 'reaction-enhancers-1', 'cybereyes',
+            'vision-enhancement-1'
+        ],
+        gearSlugs: [
+            'fly-spy', 'mct-nissan-roto-drone', 'ferret-rpd-5x', 'autosoft-3',
+            'tool-kit', 'miniwelder', 'erika-elite', 'fake-sin-4', 'fake-license-4',
+            'armor-jacket', 'combat-boots', 'ares-light-fire-70', 'quick-draw-holster',
+            'spare-clip', 'regular-ammo', 'medkit-3', 'trauma-patch', 'stim-patch',
+            'ear-buds', 'glasses', 'microtransceiver', 'mapsoft', 'credstick-silver'
         ],
     },
 ];
+/** The p.65 Resources column, lowest to highest. */
+export const RESOURCES_PRIORITY = { E: 6_000, D: 50_000, C: 140_000, B: 275_000, A: 450_000 };
+/**
+ * THE CREATION LEDGER, THE WAY THE CHARGEN VALIDATOR RUNS IT (user,
+ * 2026-09-03: "ensure the starting nuyen is appropriate for the archetype
+ * -- use the chargen api to validate"). maka-cli.com's validateWorksheet
+ * prices a build as: budget = the Resources column + converted karma x
+ * 2,000 (at most 10 karma, after 7 carry over, p.98); spent = gear at
+ * catalog price + 'ware at its cost x grade + the first month's
+ * lifestyle; and the factory caps what a runner may HOLD out of the
+ * remainder at 5,000 (p.95) -- the rest is gone into the build. Same
+ * constants, same prices, same rows; mirrored here because a pregen has
+ * no worksheet to POST (its skill spread is a spread, not a priority
+ * column, and the validator would refuse it on that before it priced
+ * it). The column is the archetype's own (IArchetype.priorities): the book's
+ * pregens are priority builds, and now so are these.
+ *
+ * Before this, outfitArchetype handed the converted karma over as CASH
+ * (up to 20,000): a pregen started with four times what a web-built
+ * runner may hold. Street lifestyle (the scenes' tier) costs nothing.
+ */
+export function archetypeLedger(archetype) {
+    const gearNuyen = (archetype.gearSlugs ?? []).reduce((n, slug) => {
+        const row = catalogRowFor(slug);
+        if (!row)
+            throw new Error(`Archetype "${archetype.name}" names catalog slug "${slug}", which has no row.`);
+        return n + row.price;
+    }, 0);
+    const augNuyen = (archetype.augs ?? []).reduce((n, key) => n + (getAug(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);
+    }, 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);
+    const karmaCarry = Math.min(Math.max(0, karmaRemainder), KARMA_CARRYOVER_MAX);
+    const kit = gearNuyen + augNuyen;
+    // The DECLARED column (IArchetype.priorities) -- the build's own row, the
+    // one the wizard validates against. archetype-priorities.test.ts proves
+    // it affords the kit.
+    const resources = archetype.priorities.resources;
+    const nuyenBudget = RESOURCES_PRIORITY[resources] + karmaConverted * KARMA_NUYEN_RATE;
+    const nuyenRemaining = nuyenBudget - kit;
+    return { gearNuyen, augNuyen, karmaRemainder, karmaCarry, karmaConverted, resources, nuyenBudget, nuyenRemaining, held: Math.max(0, Math.min(nuyenRemaining, HELD_NUYEN_MAX)) };
+}
 export function getArchetype(name) {
     return ARCHETYPES.find(a => a.name === name) ?? ARCHETYPES[0];
 }
@@ -223,7 +429,24 @@ export function getArchetype(name) {
  * ones -- a samurai starts with the Predator IN HAND, not in a duffel.
  */
 export function createArchetypeGear(archetype) {
-    return instantiateGear(archetype.gear ?? []);
+    return instantiateGear(archetypeGearDefs(archetype));
+}
+/**
+ * Every piece an archetype starts with, as constructor configs: the
+ * catalog rows first (by slug, converted once in utilities/catalog.ts),
+ * then any custom pieces. The harness serializes these into a save; the
+ * game instantiates them. A slug with no row throws -- at build time, in
+ * the tests that walk every archetype -- rather than shipping a runner
+ * without her gun.
+ */
+export function archetypeGearDefs(archetype) {
+    const fromRows = (archetype.gearSlugs ?? []).map(slug => {
+        const def = catalogGearDef(slug);
+        if (!def)
+            throw new Error(`Archetype "${archetype.name}" names catalog slug "${slug}", which has no row.`);
+        return def;
+    });
+    return [...fromRows, ...(archetype.gear ?? [])];
 }
 function instantiateGear(defs) {
     return defs.map(def => new Item({
@@ -285,18 +508,23 @@ export function outfitArchetype(player, archetype) {
         powerPoints: archetype.combat.powerPoints ?? 0,
     });
     player.karma += split.karma;
-    // The converted karma arrives as a CREDSTICK, not a floating number --
+    // WHAT IS HELD arrives as a CREDSTICK, not a floating number --
     // currency only counts when a carrier in the pack holds it (see
     // Player.currency), same pattern as the job-payment stick (scene.ts).
-    if (split.nuyen > 0) {
+    // The amount is the chargen ledger's (archetypeLedger): what remains of
+    // the Resources column after the kit, capped at the 5,000 a runner may
+    // hold (p.95) -- not the converted karma as cash, which was four times
+    // what a web-built runner walks in with.
+    const ledger = archetypeLedger(archetype);
+    if (ledger.held > 0) {
         const gearStick = new Item({
             name: 'Certified Credstick (gear money)',
-            description: 'Whatever was left when the outfitting was done -- certified, anonymous, and spending fast.',
+            description: `What was left when the outfitting was done -- certified, anonymous, and spending fast. (Resources ${ledger.resources}: ${ledger.nuyenRemaining.toLocaleString()} left after the kit, ${HELD_NUYEN_MAX.toLocaleString()} the most anyone walks out holding.)`,
             size: Size.Tiny, category: Category.Credstick,
             shape: 'Rectangle', color: 'Gunmetal', texture: 'Smooth',
             rating: Rating.Standard, weight: 0.05, transferable: true,
         });
-        gearStick.addCurrency(split.nuyen);
+        gearStick.addCurrency(ledger.held);
         player.addInventory(gearStick);
         gearStick.owner = player.name;
     }
@@ -313,10 +541,21 @@ export function outfitArchetype(player, archetype) {
         player.addInventory(item);
         item.owner = player.name;
         if (EQUIP_ON_START.has(item.category)) {
+            // THE FIRST WEAPON LISTED IS THE SIGNATURE ONE, and a later one
+            // does not take its place (2026-09-03, found the moment loadouts
+            // grew past a single gun: a Street Samurai walked out holding a
+            // combat knife because it came after the Predator and the Alpha).
+            // The catch below already SAID "a second weapon just stays
+            // holstered" -- equip swaps, so it never did. Armor still layers
+            // over the baseline wardrobe on purpose, so only weapons are
+            // guarded here.
+            const isWeapon = item.category === Category.Weapon || item.category === Category.MeleeWeapon || item.category === Category.RangedWeapon;
+            if (isWeapon && player.getCarriedWeapon())
+                continue;
             try {
                 player.equip(item);
             }
-            catch { /* a second weapon just stays holstered */ }
+            catch { /* nothing to slot it into */ }
         }
     }
 }