@maka/maka-cli 5.122.0 → 5.123.0

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

@@ -19,17 +19,22 @@ export const QUALITIES = [
     // ------------------------------ Positive ------------------------------
     {
         key: 'toughness', name: 'Toughness', kind: 'positive', karma: 9, page: 'p.77',
+        family: 'pool',
         effect: '+1 die on every damage soak roll',
+        effects: [{ type: 'dice', category: 'pools', property: 'soak', value: 1 }],
     },
     {
         // RAW: ignore one box per rating when counting wound modifiers, and it
         // cannot combine with a pain editor (woundModifier enforces that).
         key: 'high-pain-tolerance', name: 'High Pain Tolerance', kind: 'positive', karma: 7, page: 'p.74',
+        family: 'engine-rule',
         effect: 'ignore 1 box of damage when counting wound modifiers',
     },
     {
         key: 'catlike', name: 'Catlike', kind: 'positive', karma: 7, page: 'p.72',
+        family: 'pool',
         effect: '+2 dice on sneaking tests',
+        effects: [{ type: 'dice', category: 'pools', property: 'sneak', value: 2 }],
     },
     {
         // THE INVITE (Data Trails p.45-46, Prime Datahaven Membership). You
@@ -46,6 +51,7 @@ export const QUALITIES = [
         // named people you call, and inventing a group entry to carry two
         // numbers nothing reads would be a worse lie than the omission.
         key: 'prime-datahaven-membership', name: 'Prime Datahaven Membership',
+        family: 'engine-rule',
         kind: 'positive', karma: 7, page: 'Data Trails p.45-46',
         effect: 'JackPoint knows your handle -- the haven answers when you call it',
     },
@@ -53,38 +59,71 @@ export const QUALITIES = [
         // RAW: +2 on Running/Gymnastics -- here, the athletics sprint that
         // breaks off a fight (go.ts) is where that muscle shows.
         key: 'natural-athlete', name: 'Natural Athlete', kind: 'positive', karma: 7, page: 'p.76',
+        family: 'pool',
         effect: '+2 dice on athletics tests (including the sprint out of a fight)',
+        effects: [{ type: 'dice', category: 'pools', property: 'athletics', value: 2 }],
     },
     {
-        // RAW raises the Edge CEILING without granting the point; with no
-        // point-buy attributes here, the adaptation grants it outright.
+        // A CEILING, NOT A POINT -- RAG-checked p.76, which is explicit
+        // about the difference: "Lucky allows a character to possess an Edge
+        // attribute one point higher than his metatype maximum ... Note that
+        // taking this quality does not actually increase the character's
+        // current Edge rating, it just allows her the opportunity to do so;
+        // the Karma cost for gaining the extra point must still be paid."
+        // A human's Edge maximum goes 7 -> 8, and the eighth point is bought
+        // at "advance" like any other.
+        //
+        // THE COMMENT THAT USED TO SIT HERE said "RAW raises the Edge CEILING
+        // without granting the point; with no point-buy attributes here, the
+        // adaptation grants it outright" -- an honest approximation from the
+        // days when nothing in this file could express a ceiling. That excuse
+        // expired when `cap` effects arrived, and by then the approximation
+        // was costing something real: the web chargen applies the book's
+        // rule, so the same archetype built in the wizard and in the CLI
+        // disagreed about Edge by one. Reported by the user on 2026-09-04 --
+        // "I'm adding Lucky ... I don't see this updating in the chargen".
+        // The wizard was right.
+        //
+        // It is also WHY this quality and Exceptional Attribute exclude each
+        // other (p.65-66): they are the same mechanic, and Edge is the one
+        // attribute Exceptional Attribute may not name.
         key: 'lucky', name: 'Lucky', kind: 'positive', karma: 12, page: 'p.76',
-        effect: '+1 Edge -- luck past your natural ceiling',
+        family: 'ceiling',
+        excludesQuality: 'exceptional-attribute',
+        effect: 'your Edge may run 1 past its natural maximum -- buy the point at "advance"',
+        effects: [{ type: 'cap', category: 'attributes', property: 'edge', value: 1 }],
     },
     {
         // RAW: +2 social dice on a first meeting. Meetings aren't tracked
         // per-NPC, so the adaptation is per JOB: the first social play of
         // every job (persuade, bluff, haggle) gets the bonus.
         key: 'first-impression', name: 'First Impression', kind: 'positive', karma: 11, page: 'p.74',
+        family: 'engine-rule',
         effect: '+2 dice on the first social play of every job',
     },
     {
         // RAW: +2 on all Healing Tests -- exactly the first-aid roll (use.ts)
         // and the rest recovery roll (rest.ts).
         key: 'quick-healer', name: 'Quick Healer', kind: 'positive', karma: 3, page: 'p.77',
+        family: 'pool',
         effect: '+2 dice on every healing test made on or by you (first aid, rest)',
+        effects: [{ type: 'dice', category: 'pools', property: 'healing', value: 2 }],
     },
     {
         // RAW: +2 on Logic tests for pattern analysis / puzzle-cracking --
         // mapped to the hacking rolls, the game's logic-puzzle work.
         key: 'analytical-mind', name: 'Analytical Mind', kind: 'positive', karma: 5, page: 'p.72',
+        family: 'pool',
         effect: '+2 dice on hacking tests -- code is just a puzzle with rent',
+        effects: [{ type: 'dice', category: 'skills', property: 'hacking', value: 2 }],
     },
     {
         // RAW: +2 juryrigging mechanical/electronic gear -- mapped to the
         // piloting roll (drone work IS field rigging) and bench deck repair.
         key: 'juryrigger', name: 'Juryrigger', kind: 'positive', karma: 10, page: 'p.75',
+        family: 'pool',
         effect: '+2 dice on piloting and on bench-repairing a damaged deck',
+        effects: [{ type: 'dice', category: 'pools', property: 'piloting', value: 2 }],
     },
     {
         // RAW: +1 on ALL Perception Tests, and the book says "including
@@ -95,7 +134,9 @@ export const QUALITIES = [
         // and its shape is co-owned with the web chargen, so a second entry
         // would be inventing a rating system in the key names.
         key: 'perceptive', name: 'Perceptive', kind: 'positive', karma: 5, page: 'Run Faster p.148',
+        family: 'pool',
         effect: '+1 die on every perception test -- meat, astral or grid',
+        effects: [{ type: 'dice', category: 'pools', property: 'perception', value: 1 }],
     },
     {
         // RAW: +1 to every skill in the INFLUENCE group (Etiquette,
@@ -110,7 +151,9 @@ export const QUALITIES = [
         // social chrome does too -- a bigger change than this entry, made
         // sideways. The verbs named below are the ones that actually move.
         key: 'trustworthy', name: 'Trustworthy', kind: 'positive', karma: 15, page: 'Run Faster p.151',
+        family: 'pool',
         effect: '+1 die when you ask, bluff, haggle or persuade -- people believe you',
+        effects: [{ type: 'dice', category: 'pools', property: 'social', value: 1 }],
     },
     {
         // RAW: +2 to ONE Matrix action you choose when you take it (p.237's
@@ -123,9 +166,16 @@ export const QUALITIES = [
         // shipped because it is one the engine actually names: hack.ts logs
         // the sleaze route as "Hack on the Fly (sleaze)" per p.240, and
         // mark.ts states that placing a mark IS that same action.
-        key: 'codeslinger-hack-on-the-fly', name: 'Codeslinger (Hack on the Fly)',
+        key: 'codeslinger', name: 'Codeslinger',
+        family: 'pool',
         kind: 'positive', karma: 10, page: 'p.72',
-        effect: '+2 dice on the quiet route in -- sleaze hacks and sleaze marks',
+        effect: '+2 dice on ONE Matrix action you choose -- the route you made your own',
+        choice: {
+            of: 'matrix-action',
+            prompt: 'Which way in did you make your own -- the quiet one or the loud one?',
+            from: ['matrix-sleaze', 'matrix-attack'],
+        },
+        effects: [{ type: 'dice', category: 'pools', property: 'chosen', value: 2 }],
     },
     {
         // GOING FOR ALL THREE AT ONCE (Data Trails p.44, cited on
@@ -136,59 +186,94 @@ export const QUALITIES = [
         // pool bonus -- a -4 handed to every intrusion would be a different,
         // much stronger quality than the book's.
         key: 'go-big-or-go-home', name: 'Go Big or Go Home',
+        family: 'engine-rule',
         kind: 'positive', karma: 6, page: 'Data Trails p.44',
         effect: 'reaching for all three marks in one action costs -6 dice instead of -10',
     },
     // ------------------------------ Negative ------------------------------
     {
         key: 'sinner-national', name: 'SINner (National)', kind: 'negative', karma: 5, page: 'p.84',
+        family: 'engine-rule',
         effect: 'a legal SIN with taxes attached: 15% of every job and gig payout withheld',
     },
     {
         key: 'sinner-criminal', name: 'SINner (Criminal)', kind: 'negative', karma: 10, page: 'p.84',
+        family: 'engine-rule',
         effect: 'a felon\'s SIN, broadcast always: 15% of every payout withheld, and the law knows your face',
     },
     {
         key: 'sinner-corp', name: 'SINner (Corporate Limited)', kind: 'negative', karma: 15, page: 'p.84-85',
+        family: 'engine-rule',
         effect: 'a megacorp owns your file: 20% of every payout goes home to the company',
     },
     {
         key: 'low-pain-tolerance', name: 'Low Pain Tolerance', kind: 'negative', karma: 9, page: 'p.82',
+        family: 'engine-rule',
         effect: 'wound modifiers bite every 2 boxes instead of every 3',
     },
     {
         // RAW: first Initiative Score of a combat halved. Mapped to the
         // opening exchange of any fresh fight (combat-exchange.ts).
         key: 'combat-paralysis', name: 'Combat Paralysis', kind: 'negative', karma: 12, page: 'p.80',
+        family: 'engine-rule',
         effect: 'you freeze when it starts: initiative halved in a fight\'s opening exchange',
     },
     {
         // RAW: spent Edge can turn on you. Adaptation: burning edge rolls a
         // die -- on a 1 the point is gone and the boost never arms (edge.ts).
         key: 'bad-luck', name: 'Bad Luck', kind: 'negative', karma: 12, page: 'p.79',
+        family: 'engine-rule',
         effect: '1 in 6 edge burns curdle: the point is spent, the boost never comes',
     },
     {
         // RAW: a look people remember, easy to describe, easy to identify.
         // Adaptation: -2 on sneaking tests -- witnesses clock you.
         key: 'distinctive-style', name: 'Distinctive Style', kind: 'negative', karma: 5, page: 'p.80',
+        family: 'pool',
         effect: 'people remember you: -2 dice on sneaking tests',
+        effects: [{ type: 'dice', category: 'pools', property: 'sneak', value: -2 }],
     },
     {
         // RAW: rest may not restore you fully. Adaptation: rest recovery
         // halved (rest.ts) -- sleep never comes easy.
         key: 'insomnia', name: 'Insomnia', kind: 'negative', karma: 10, page: 'p.81',
+        family: 'engine-rule',
         effect: 'rest recovers half the stun it should -- sleep never comes easy',
     },
     {
         key: 'simsense-vertigo', name: 'Simsense Vertigo', kind: 'negative', karma: 5, page: 'p.83',
+        family: 'pool',
         effect: '-2 dice on Matrix actions -- the sim makes your inner ear lie',
+        effects: [{ type: 'dice', category: 'pools', property: 'matrix', value: -2 }],
     },
     {
         // RAW: an Active skill group you simply cannot have. skillRating
         // pins it to 0 and advance.ts refuses to train it.
-        key: 'incompetent-hacking', name: 'Incompetent (Hacking)', kind: 'negative', karma: 5, page: 'p.81',
-        effect: 'the Matrix bounces off you: hacking is 0 and can never be trained',
+        // PER SKILL GROUP, NOT PER SKILL, and RAG-checked after this entry
+        // first shipped as a single-skill pick: p.81 applies the quality to
+        // "a certain Active skill group" and treats the holder as unaware
+        // "for all skills in the skill group". Naming one skill was a
+        // deviation I introduced while retiring the old slug -- the slug
+        // said hacking, and I carried its narrowness across instead of
+        // reading the quality.
+        //
+        // FORBIDDEN, NOT ZEROED. Unaware (p.131) is "You cannot default the
+        // skill" -- so this is a `forbid` effect and not a ceiling, because
+        // no number says "absent". A -6 would read as 0 at creation and 6
+        // against the career ceiling, and even an absolute 0 would still
+        // default at -1 in this engine.
+        key: 'incompetent', name: 'Incompetent', kind: 'negative', karma: 5, page: 'p.81',
+        choice: {
+            of: 'skill-group',
+            prompt: 'Which whole set of skills has never taken, however hard anyone tried?',
+        },
+        effects: [{ type: 'forbid', category: 'skills', property: 'chosen' }],
+        // Half-live, and deliberately not tagged inert: advance.ts refuses
+        // to train the skill at any price (the "never trained" half of the
+        // rule). What is missing is the other half -- nothing forces the
+        // rating to 0 at creation, so an archetype could still hand one out.
+        family: 'engine-rule',
+        effect: 'one whole skill group is closed to you -- you cannot use it, train it, or even default on it',
     },
     {
         // RAW: you start play with 3 points of Notoriety. Read straight by
@@ -196,6 +281,7 @@ export const QUALITIES = [
         // awareness exactly as earned notoriety does -- the quality does not
         // need its own arithmetic, it needs the number the book gives it.
         key: 'bad-rep', name: 'Bad Rep', kind: 'negative', karma: 7, page: 'p.79',
+        family: 'engine-rule',
         effect: 'the street tells stories about you: 3 points of notoriety, before you have earned any',
     },
     {
@@ -206,16 +292,25 @@ export const QUALITIES = [
         // (skillRating already floors at 0 with an unskilled -1 default, so
         // there is no lower rung to drop to).
         key: 'uncouth', name: 'Uncouth', kind: 'negative', karma: 14, page: 'p.85-86',
+        family: 'pool',
         effect: '-2 dice when you ask, bluff, haggle or persuade -- you rub people wrong',
+        effects: [{ type: 'dice', category: 'pools', property: 'social', value: -2 }],
     },
     {
         // RAW: -2 on ONE Matrix action you choose. Same key-encoded choice
         // as Codeslinger above, and the same reason. Brute Force is the
         // action shipped: hack.ts logs the loud route as "Brute Force
         // (attack)" per p.238, so the engine names it.
-        key: 'codeblock-brute-force', name: 'Codeblock (Brute Force)',
+        key: 'codeblock', name: 'Codeblock',
+        family: 'pool',
         kind: 'negative', karma: 10, page: 'p.80',
-        effect: '-2 dice on the loud route in -- brute-force hacks and marks',
+        effect: '-2 dice on ONE Matrix action you choose -- the one that never sits right',
+        choice: {
+            of: 'matrix-action',
+            prompt: 'Which way in never sits right -- the quiet one or the loud one?',
+            from: ['matrix-sleaze', 'matrix-attack'],
+        },
+        effects: [{ type: 'dice', category: 'pools', property: 'chosen', value: -2 }],
     },
     // ================= THE FULL-CATALOG PASS (2026-09-01) =================
     // The user's report: "the qualities list is severely lacking" -- and it
@@ -230,145 +325,237 @@ export const QUALITIES = [
     // ------------------------------ Positive ------------------------------
     {
         key: 'ambidextrous', name: 'Ambidextrous', kind: 'positive', karma: 4, page: 'p.71',
+        inert: 'the engine applies no off-hand penalty (p.178), so there is none to waive',
+        family: 'engine-rule',
         effect: 'either hand works equally well -- no off-hand penalty (p.178)',
     },
     {
+        // RAG-checked p.72: the chosen skill may be rated 7 at creation
+        // (against the usual 6) and may eventually reach 13 (against 12).
+        // Both ends are the SAME delta -- one step further than anyone else
+        // gets -- so the engine applies +1 to its own ceiling at both ends
+        // rather than writing the book's absolute numbers over house ones.
+        // Taken once only.
         key: 'aptitude', name: 'Aptitude', kind: 'positive', karma: 14, page: 'p.72',
+        inert: 'the engine path is complete -- the web chargen does not yet ask which skill, and without an answer the ceiling lifts nothing',
+        family: 'ceiling',
         effect: 'one chosen skill may start at 7 and one day reach 13 -- past every limit',
+        choice: { of: 'skill', prompt: 'Which skill is the one you were born for?' },
+        effects: [{ type: 'cap', category: 'skills', property: 'chosen', value: 1 }],
     },
     {
         key: 'astral-chameleon', name: 'Astral Chameleon', kind: 'positive', karma: 10, page: 'p.72',
+        inert: 'no astral signature is recorded, so nothing can fade faster or read fainter',
+        family: 'engine-rule',
         requires: 'awakened',
         effect: 'your astral signature fades in half the time and reads at -2 to assensing',
     },
     {
         key: 'bilingual', name: 'Bilingual', kind: 'positive', karma: 5, page: 'p.72',
+        inert: 'the engine models no languages',
+        family: 'narrative',
         effect: 'a second language as a native tongue, free, from birth',
     },
     {
         key: 'blandness', name: 'Blandness', kind: 'positive', karma: 8, page: 'p.72',
+        inert: 'no test carries a threshold this could raise; recall and shadowing are not rolled',
+        family: 'threshold',
         effect: 'forgettable on purpose: +1 threshold to recall or shadow you (not vs magic or Matrix)',
     },
     {
         key: 'double-jointed', name: 'Double-Jointed', kind: 'positive', karma: 6, page: 'p.72',
+        family: 'pool',
         effect: '+2 dice on escape-artist work; squeeze where others cannot',
+        effects: [{ type: 'dice', category: 'skills', property: 'escape-artist', value: 2 }],
     },
     {
+        // RAG-checked p.73-74: +1 to the NATURAL MAXIMUM of one attribute,
+        // never Edge (p.65-66 -- Edge is Lucky's job, and the book says you
+        // may buy either quality, not both). It does not raise the
+        // attribute itself: it moves the ceiling and you still pay to climb.
         key: 'exceptional-attribute', name: 'Exceptional Attribute', kind: 'positive', karma: 14, page: 'p.72',
+        inert: 'the engine path is complete -- the web chargen does not yet ask which attribute, and without an answer the ceiling lifts nothing',
+        family: 'ceiling',
         effect: 'one attribute may run 1 above its natural maximum (never Edge -- that is Lucky)',
+        choice: {
+            of: 'attribute',
+            prompt: 'Which attribute runs past the human ceiling?',
+            excludes: ['edge'],
+        },
+        excludesQuality: 'lucky',
+        effects: [{ type: 'cap', category: 'attributes', property: 'chosen', value: 1 }],
     },
     {
         key: 'focused-concentration', name: 'Focused Concentration',
+        family: 'engine-rule',
         kind: 'positive', karma: 4, maxRating: 6, page: 'p.74', requires: 'caster-or-technomancer',
         effect: 'sustain one spell of Force up to your rating with no sustaining penalty',
     },
     {
         key: 'gearhead', name: 'Gearhead', kind: 'positive', karma: 11, page: 'p.74',
+        inert: 'the piloting roll has no notion of a hard maneuver, and no speed or Handling to boost',
+        family: 'pool',
         effect: 'behind any wheel or stick: +2 dice on hard maneuvers, +20% speed or +1 Handling for 1D6 minutes',
     },
     {
         key: 'guts', name: 'Guts', kind: 'positive', karma: 10, page: 'p.74',
+        inert: 'nothing rolls to resist fear -- brandish menaces, but the target never tests',
+        family: 'pool',
         effect: '+2 dice to resist fear and intimidation, mundane or magical',
     },
     {
         key: 'home-ground', name: 'Home Ground', kind: 'positive', karma: 10, page: 'p.74',
+        inert: 'needs a chosen domain (IQualityChoice) and a per-domain bonus seat',
+        family: 'pool',
         effect: 'your turf, one chosen edge on it: the streets, the people, the host, or the bolt-holes',
     },
     {
         key: 'magic-resistance', name: 'Magic Resistance',
+        family: 'engine-rule',
         kind: 'positive', karma: 6, maxRating: 4, page: 'p.76', requires: 'mundane',
         effect: '+1 die per rating when you resist a spell -- always on: friendly spells (Heal included) fail on you too',
     },
     {
         key: 'mentor-spirit', name: 'Mentor Spirit', kind: 'positive', karma: 5, page: 'p.76',
+        inert: 'needs a chosen patron and its per-mentor bonuses and demands (p.320)',
+        family: 'engine-rule',
         requires: 'awakened',
         effect: 'a patron spirit guides your magic -- its blessings and its demands (p.320)',
     },
     {
         key: 'natural-hardening', name: 'Natural Hardening', kind: 'positive', karma: 10, page: 'p.76',
+        family: 'pool',
         effect: '1 point of natural biofeedback filtering, cumulative with a filter or living firewall',
+        effects: [{ type: 'dice', category: 'pools', property: 'biofeedback', value: 1 }],
     },
     {
-        key: 'natural-immunity-natural', name: 'Natural Immunity (Natural)',
+        key: 'natural-immunity', name: 'Natural Immunity',
+        choice: {
+            of: 'hazard-class',
+            prompt: 'Which does your body simply refuse -- something natural, or something built?',
+            from: ['natural', 'synthetic'],
+        },
+        inert: 'no disease or toxin track exists to be immune to',
+        family: 'engine-rule',
         kind: 'positive', karma: 4, page: 'p.77',
         effect: 'immune to ONE chosen natural disease or toxin (never magical ones)',
     },
     {
         key: 'natural-immunity-synthetic', name: 'Natural Immunity (Synthetic)',
+        inert: 'no disease or toxin track exists to be immune to',
+        family: 'engine-rule',
         kind: 'positive', karma: 10, page: 'p.77',
         effect: 'immune to ONE chosen synthetic disease or toxin (never magical ones)',
     },
     {
         key: 'photographic-memory', name: 'Photographic Memory', kind: 'positive', karma: 6, page: 'p.77',
+        inert: 'nothing rolls a Memory Test',
+        family: 'pool',
         effect: '+2 dice on every Memory Test -- what you saw stays seen',
     },
     {
-        key: 'resistance-pathogens-or-toxins', name: 'Resistance to Pathogens OR Toxins',
+        key: 'resistance-one', name: 'Resistance (One Class)',
+        choice: {
+            of: 'hazard-class',
+            prompt: 'Which do you shrug off -- pathogens, or toxins?',
+            from: ['pathogens', 'toxins'],
+        },
+        inert: 'nothing rolls to resist a pathogen or a toxin',
+        family: 'pool',
         kind: 'positive', karma: 4, page: 'p.77',
         effect: '+1 die to resist one chosen class: pathogens, or toxins',
     },
     {
         key: 'resistance-pathogens-and-toxins', name: 'Resistance to Pathogens AND Toxins',
+        inert: 'nothing rolls to resist a pathogen or a toxin',
+        family: 'pool',
         kind: 'positive', karma: 8, page: 'p.77',
         effect: '+1 die to resist both pathogens and toxins',
     },
     {
         key: 'spirit-affinity', name: 'Spirit Affinity', kind: 'positive', karma: 7, page: 'p.77',
+        inert: 'needs a chosen spirit type; binding and services are not rolled per type',
+        family: 'engine-rule',
         requires: 'awakened',
         effect: 'one spirit type favors you: +1 service from them, +1 die to bind them',
     },
     // ------------------------------ Negative ------------------------------
     {
         key: 'addiction-mild', name: 'Addiction (Mild)', kind: 'negative', karma: 4, page: 'p.77-78',
+        inert: 'no craving clock and no withdrawal state',
+        family: 'condition',
         effect: 'hooked, mildly: cravings monthly; withdrawal bites your tests until fed',
     },
     {
         key: 'addiction-moderate', name: 'Addiction (Moderate)', kind: 'negative', karma: 9, page: 'p.77-78',
+        inert: 'no craving clock and no withdrawal state',
+        family: 'condition',
         effect: 'hooked: cravings every two weeks; withdrawal bites your tests until fed',
     },
     {
         key: 'allergy-common-mild', name: 'Allergy (Common, Mild)', kind: 'negative', karma: 10, page: 'p.78',
+        inert: 'no exposure state -- nothing knows you are standing in the sun',
+        family: 'condition',
         effect: 'allergic to something everywhere (sunlight, soy, pollutants): -1 die while exposed, -1 to resist it as a weapon',
     },
     {
         key: 'astral-beacon', name: 'Astral Beacon', kind: 'negative', karma: 10, page: 'p.78-79',
+        inert: 'no astral signature is recorded',
+        family: 'engine-rule',
         requires: 'awakened',
         effect: 'your astral signature burns bright and lasts twice as long -- easier to read, easier to trace',
     },
     {
         key: 'code-of-honor', name: 'Code of Honor', kind: 'negative', karma: 15, page: 'p.80',
+        inert: 'canon leaves this to the table; the engine adjudicates no vow',
+        family: 'narrative',
         effect: 'a group you will not kill, ever -- non-lethal only, whatever it costs the run',
     },
     {
         key: 'gremlins', name: 'Gremlins', kind: 'negative', karma: 4, maxRating: 4, page: 'p.81',
+        family: 'threshold',
         effect: 'machines hate you: on the deck, a glitch needs one fewer 1 per rating',
     },
     {
         key: 'loss-of-confidence', name: 'Loss of Confidence', kind: 'negative', karma: 10, page: 'p.82',
+        inert: 'specializations are not modelled, so none can be suspended',
+        family: 'condition',
         effect: 'one skill you were proud of, now doubted -- its specializations unusable while the doubt holds',
     },
     {
         key: 'scorched', name: 'Scorched', kind: 'negative', karma: 10, page: 'p.83',
+        inert: 'no neurological scar state, and nothing triggers on entering VR',
+        family: 'condition',
         effect: 'black IC or BTL left a mark: one chosen neurological scar that flares in VR',
     },
     {
         key: 'sensitive-system', name: 'Sensitive System', kind: 'negative', karma: 12, page: 'p.83',
+        inert: 'the clinic charges canon Essence; there is no doubling hook, and bioware is not rejected',
+        family: 'engine-rule',
         effect: 'implants hate you: DOUBLE Essence loss from cyberware; bioware is rejected outright',
     },
     {
         key: 'social-stress', name: 'Social Stress', kind: 'negative', karma: 8, page: 'p.85',
+        inert: 'no pressure state to read',
+        family: 'condition',
         effect: 'crowds and confrontation wear on you -- emotions interfere when the pressure is social',
     },
     {
         key: 'uneducated', name: 'Uneducated', kind: 'negative', karma: 8, page: 'p.87',
+        inert: 'knowledge skills are not modelled, and learning costs are flat',
+        family: 'engine-rule',
         effect: 'no schooling: unaware in Technical/Academic/Professional knowledge you do not hold; learning them costs double',
     },
     {
         key: 'unsteady-hands', name: 'Unsteady Hands', kind: 'negative', karma: 7, page: 'p.87',
+        inert: 'no symptom state, and no fine-handwork test to penalise',
+        family: 'condition',
         effect: 'the shakes: -2 dice on fine handwork when the symptoms surface',
     },
     {
         key: 'weak-immune-system', name: 'Weak Immune System', kind: 'negative', karma: 10, page: 'p.87',
+        inert: 'no disease track, so no Power to raise',
+        family: 'engine-rule',
         effect: 'disease hits harder: +2 Power on every disease you resist (excludes the immunity qualities)',
     },
     // ------------------------- Cutting Aces (2026-09-02) -------------------------
@@ -383,85 +570,133 @@ export const QUALITIES = [
     // ------------------------------ Positive ------------------------------
     {
         key: 'alibi', name: 'Alibi', kind: 'positive', karma: 4, page: 'Cutting Aces p.150',
+        inert: 'canon narrows it to plausible evidence, which nothing tracks',
+        family: 'pool',
         effect: 'always the +2 on Con tests for plausible-seeming evidence -- your excuses are pre-made',
     },
     {
         key: 'closer', name: 'Closer', kind: 'positive', karma: 4, page: 'Cutting Aces p.150',
+        inert: 'canon narrows it to life-or-death stakes, which nothing tracks',
+        family: 'pool',
         effect: '+2 dice on Negotiation when it is a matter of life or death',
     },
     {
         key: 'cynic', name: 'Cynic', kind: 'positive', karma: 6, page: 'Cutting Aces p.150',
+        inert: 'the engine rolls no opposed pool for an NPC acting socially ON you',
+        family: 'pool',
         effect: 'anyone making a Social test against you rolls at -1',
     },
     {
         key: 'empathic-listener', name: 'Empathic Listener', kind: 'positive', karma: 10, page: 'Cutting Aces p.150',
+        inert: 'no substitution seat: a pool is assembled from fixed attributes',
+        family: 'substitution',
         effect: 'Intuition stands in for Charisma on Etiquette tests',
     },
     {
         key: 'good-looking-and-knows-it', name: 'Good Looking and Knows It', kind: 'positive', karma: 10, page: 'Cutting Aces p.150',
+        inert: 'no modifier ledger to ignore two points of',
+        family: 'threshold',
         effect: 'ignore 2 points of negative modifiers on any Social test; +1 Notoriety, and people remember your face (+2 to recall you)',
     },
     {
         key: 'groupthink', name: 'Groupthink', kind: 'positive', karma: 5, page: 'Cutting Aces p.150-151',
+        inert: 'no social teamwork test, and the assistant/leader roles do not exist',
+        family: 'pool',
         effect: 'social teamwork: as an assistant +1 die and +1 Social limit; as the leader, take -2 to soften an assistant\'s glitch',
     },
     {
         key: 'honest-face', name: 'Honest Face', kind: 'positive', karma: 5, page: 'Cutting Aces p.151',
+        inert: 'nothing rolls Judge Intentions against you',
+        family: 'pool',
         effect: '+2 dice on your Charisma + Willpower when someone Judges your Intentions',
     },
     {
         key: 'innocuous', name: 'Innocuous', kind: 'positive', karma: 5, page: 'Cutting Aces p.151',
+        inert: 'canon narrows it to hiding in a crowd, which the room does not model',
+        family: 'pool',
         effect: '+2 on Sneaking tests to hide in a crowd',
     },
     {
         key: 'master-debater', name: 'Master Debater', kind: 'positive', karma: 10, page: 'Cutting Aces p.151',
+        inert: 'no substitution seat: a pool is assembled from fixed attributes',
+        family: 'substitution',
         effect: 'Logic stands in for Charisma on Diplomacy tests -- you win by crushing their logic',
     },
     {
         key: 'memory-palace', name: 'Memory Palace', kind: 'positive', karma: 6, page: 'Cutting Aces p.151',
+        inert: 'nothing rolls a Memory Test, and interrogation is not a test',
+        family: 'pool',
         effect: '+1 die on Memory tests and to resist Intimidation (Interrogation)',
     },
     {
         key: 'method-actor', name: 'Method Actor', kind: 'positive', karma: 7, page: 'Cutting Aces p.151',
+        inert: 'no immersion clock, and Impersonation is not rolled',
+        family: 'pool',
         effect: 'each full day immersed in a role: +1 die and +1 Social limit on Impersonation as that role, up to your Willpower',
     },
     {
         key: 'mnemonic-vault', name: 'Mnemonic Vault', kind: 'positive', karma: 8, page: 'Cutting Aces p.151',
+        inert: 'interrogation is not a test',
+        family: 'pool',
         requiresQuality: 'memory-palace',
         effect: 'lock memories away: +2 dice to resist Interrogation and anything that would compel you to talk; resist, and they believe that was all you knew',
     },
     {
         key: 'watch-the-suit', name: 'Watch the Suit', kind: 'positive', karma: 3, page: 'Cutting Aces p.151',
+        inert: 'appearance carries no Etiquette penalty to be spared',
+        family: 'engine-rule',
         effect: 'Stun never marks your appearance: no Etiquette penalty for looking roughed up after a fight you took no Physical damage in',
     },
     // ------------------------------ Negative ------------------------------
     {
         key: 'alpha-junkie', name: 'Alpha Junkie', kind: 'negative', karma: 12, page: 'Cutting Aces p.151-152',
+        inert: 'no leadership-over-you state to trigger the Composure test',
+        family: 'condition',
         effect: 'when someone takes charge over you (or wins a Leadership test against you): Charisma + Willpower (3) or you fight for control -- argue, intimidate, or attack',
     },
     {
         key: 'designated-omega', name: 'Designated Omega', kind: 'negative', karma: 5, page: 'Cutting Aces p.152',
+        family: 'pool',
         effect: '-2 dice on every Leadership test, initiating or resisting',
+        effects: [{ type: 'dice', category: 'skills', property: 'leadership', value: -2 }],
     },
     {
         key: 'disheveled', name: 'Disheveled', kind: 'negative', karma: 5, page: 'Cutting Aces p.152',
+        inert: 'no positive social modifier ledger to cap',
+        family: 'threshold',
         effect: 'clothing never gives you a positive Social dice pool or limit modifier',
     },
     {
         key: 'favored', name: 'Favored', kind: 'negative', karma: 5, page: 'Cutting Aces p.152',
+        family: 'pool',
         effect: 'a group you cannot see straight (common group, biased): -2 dice on Social tests with them, and they negotiate against you at +2',
+        effects: [{ type: 'dice', category: 'pools', property: 'social', value: -2 }],
     },
     {
         key: 'one-born-every-minute', name: 'One Born Every Minute', kind: 'negative', karma: 5, page: 'Cutting Aces p.152',
+        inert: 'nothing rolls for you to resist a Con made against you',
+        family: 'pool',
         effect: '-2 dice to resist every Con test made against you',
     },
     {
         key: 'the-goat', name: 'The Goat', kind: 'negative', karma: 8, page: 'Cutting Aces p.152',
+        family: 'pool',
         effect: 'you just look guilty: everyone meeting you for the first time is suspicious (-1 Social), and security watches you first',
+        effects: [{ type: 'dice', category: 'pools', property: 'social', value: -1 }],
     },
     {
         key: 'ugly-and-doesnt-care', name: "Ugly and Doesn't Care", kind: 'negative', karma: 10, page: 'Cutting Aces p.152-153',
+        family: 'attribute',
         effect: 'Charisma maximum -1 and starting Charisma -1 (minimum 1)',
+        effects: [
+            // BOTH HALVES of the printed line. The attribute effect is the
+            // "starting Charisma -1"; the cap is the "Charisma maximum -1",
+            // which nothing enforced until ceilings existed -- the same gap
+            // Lucky had, found by sweeping the family rather than by a second
+            // report.
+            { type: 'attribute', category: 'attributes', property: 'charisma', value: -1 },
+            { type: 'cap', category: 'attributes', property: 'charisma', value: -1 },
+        ],
     },
 ];
 /**
@@ -472,16 +707,22 @@ export const QUALITIES = [
 export const RETIRED_QUALITIES = [
     {
         key: 'indomitable', name: 'Indomitable', kind: 'positive', karma: 8, maxRating: 3, page: 'p.75',
+        inert: 'the engine models only the Social limit, and no limit may be chosen',
+        family: 'limit',
         effect: '+1 to one Inherent limit of your choice per rating',
         retired: 'the engine models only the Social limit, and the choice of limit has no seat yet',
     },
     {
         key: 'will-to-live', name: 'Will to Live', kind: 'positive', karma: 3, maxRating: 3, page: 'p.77',
+        inert: 'there is no overflow track',
+        family: 'engine-rule',
         effect: '+1 Damage Overflow box per rating -- more room between down and dead, no easier to knock out',
         retired: 'the engine has no overflow track: a full Physical track is death',
     },
     {
         key: 'social-appearance-anxiety', name: 'Social Appearance Anxiety', kind: 'negative', karma: 3, maxRating: 3, page: 'Cutting Aces p.152',
+        inert: 'there is no grooming state',
+        family: 'condition',
         effect: '-1 die per rating on all Social rolls whenever you are not clean, coiffed, and cutting',
         retired: 'the engine has no grooming state to judge "clean, coiffed, and cutting"',
     },
@@ -490,7 +731,43 @@ export const RETIRED_QUALITIES = [
  * A saved or offered key, resolved: the old fixed "<key>-1" entries
  * (every rated quality shipped as Rating 1 only) read as key + rating 1.
  */
+/**
+ * THE KEYS THAT BAKED A PLAYER-S CHOICE INTO THE SLUG, and what each
+ * one resolves to now.
+ *
+ * Before the shared choice lane existed, a quality whose effect named
+ * something the player picked had nowhere to put the answer, so the
+ * answer went into the key: incompetent-hacking, codeslinger-hack-on-
+ * the-fly, and five more. Seven slugs for what is really two qualities
+ * and a pick.
+ *
+ * These keys are written into every save that holds one, so they are
+ * not renamed -- they are RESOLVED, here, into the key plus the pick
+ * they always meant. An old save loads, the pick lands in Player.picks,
+ * and the character plays identically. Nothing has to be migrated and
+ * nothing can be missed, which is the same shape as the legacy
+ * "<key>-1" rated form below.
+ *
+ * A pick's VALUE is the engine's own word, never a label: Codeslinger's
+ * is the POOL it modifies (matrix-sleaze), so `property: 'chosen'`
+ * resolves with no translation table in between.
+ */
+const LEGACY_CHOICE_KEYS = {
+    // The old slug named a SKILL; the quality is per GROUP (p.81), so it
+    // resolves to the group hacking belongs to. A character who held
+    // incompetent-hacking was, in canon terms, always Incompetent
+    // (Cracking) -- the slug simply could not say so.
+    'incompetent-hacking': { key: 'incompetent', pick: 'cracking' },
+    'codeslinger-hack-on-the-fly': { key: 'codeslinger', pick: 'matrix-sleaze' },
+    'codeblock-brute-force': { key: 'codeblock', pick: 'matrix-attack' },
+    'natural-immunity-natural': { key: 'natural-immunity', pick: 'natural' },
+    'natural-immunity-synthetic': { key: 'natural-immunity', pick: 'synthetic' },
+    'resistance-pathogens-or-toxins': { key: 'resistance-one', pick: 'toxins' },
+};
 export function resolveQualityKey(key) {
+    const legacy = LEGACY_CHOICE_KEYS[key];
+    if (legacy)
+        return { key: legacy.key, rating: 1, pick: legacy.pick };
     const m = /^(.*)-1$/.exec(key);
     if (m) {
         const base = m[1];
@@ -499,6 +776,8 @@ export function resolveQualityKey(key) {
     }
     return { key, rating: 1 };
 }
+/** Every legacy slug that resolves to a key plus a pick, for tests and tooling. */
+export const LEGACY_CHOICE_SLUGS = Object.keys(LEGACY_CHOICE_KEYS);
 export function getQuality(key) {
     if (!key)
         return undefined;