RingBRP/tools/expand-spec.mjs

/**
 * Turning a posting or a trade into a full character.
 *
 * A roster agent is written as a job and a rank — `{ role: "lead", rank: "Senior Field
 * Officer" }` — and carries no skills and no kit of its own. Everything it can actually
 * do is derived from the register at build time by this function, which is why the
 * roster cannot drift from the generator: change TRADE_BANDS and every doctor changes
 * with it.
 *
 * This lived inside build-packs.mjs, where only the build could reach it. The lethality
 * harness needs the SAME expansion — a simulated Marta Holloway with no skills is not
 * Marta Holloway, she is a civilian with her hands up — and build-packs.mjs cannot be
 * imported to get at it because importing it runs the build. So it moved here, byte for
 * byte, and both sides import it. There is no second copy.
 */
import {
  SKILL_CATALOGUE, WEAPONS, ARMOURS, GEAR, DEVICES
} from "./content.mjs";

const WEAPON_LOOKUP = new Map(WEAPONS.map(w => [w.key, w]));
const ARMOUR_LOOKUP = new Map(ARMOURS.map(a => [a.key, a]));
const GEAR_LOOKUP   = new Map(GEAR.map(g => [g.key, g]));

const REG = await import("../postings.mjs");
const midBand = b => Math.round((b[0] + b[1]) / 2);

export function expandFromRegister(spec, { where = "roster", civilian = false } = {}) {
  const { ROLES, TRADES, INDUCTION, TRADE_BANDS, STANDING_ISSUE, TIER_ISSUE, TIERS } = REG;
  const isTrade = !!spec.trade;
  const R = isTrade ? TRADES[spec.trade] : ROLES[spec.role];
  if (!R) throw new Error(`${where}: no ${isTrade ? "trade" : "role"} "${spec.trade ?? spec.role}"`);
  const tierKey = { "Probationary": "probationary", "Field Officer": "officer",
                    "Senior Field Officer": "senior", "Case Officer": "veteran" }[spec.rank]
                  ?? "officer";
  const T = TIERS[tierKey];
  const coreV    = isTrade ? midBand(TRADE_BANDS.core)    : midBand(T.core);
  const supportV = isTrade ? midBand(TRADE_BANDS.support) : midBand(T.support);
  const inducV   = midBand(INDUCTION.bandByTier[tierKey] ?? INDUCTION.band);

  const skills = [];
  const seen = new Set();
  const addSkill = (id, val) => {
    if (seen.has(id)) return;                       // induction never demotes a trade
    seen.add(id);
    const [fam, sp = ""] = id.split(":");
    skills.push({ fam, spec: sp, val });
  };
  for (const k of R.core) addSkill(k, coreV);
  for (const k of R.support) addSkill(k, supportV);
  // Induction is a FLOOR for everyone the department employs, posting or trade — see the
  // note in ringbrp.mjs. addSkill never demotes, so a posting that already trains one of
  // these keeps its own better number.
  if (!civilian) for (const k of INDUCTION.skills) addSkill(k, inducV);
  if (!civilian) addSkill("language:trade_cant", 55);
  // Floors only ever RAISE a rating, so a posting already better stays better.
  for (const [id, floor] of Object.entries(spec.floors ?? {})) {
    const [fam, sp = ""] = id.split(":");
    const found = skills.find(x => x.fam === fam && x.spec === sp);
    if (found) found.val = Math.max(found.val, floor);
    else { skills.push({ fam, spec: sp, val: floor }); seen.add(id); }
  }

  // A civilian has never been near a crossing, so nothing anomalous and nothing that
  // costs Coherence to use — the criminal's trade kit contains a black mirror, which is
  // exactly the sort of thing you acquire AFTER the night the department noticed you.
  const isAnomalous = k => {
    const it = GEAR_LOOKUP.get(k) ?? WEAPON_LOOKUP.get(k) ?? ARMOUR_LOOKUP.get(k);
    return !!it && (it.era === "anomalous" || !!it.coherence);
  };
  // No firearm and no body armour either. The police trade kit contains a sidearm and a
  // stab vest, which is right for a serving officer and wrong for the person before the
  // department found them — this is Britain, and the two ex-police pregens were walking
  // into a civilian prologue armed and armoured. The department issues those. Playing
  // LAST ADMISSION found it: its only fight was over in one round because a punter had
  // a revolver. A criminal's knife stays; a knife is not an issued weapon.
  const isIssuedForce = k => {
    const w = WEAPON_LOOKUP.get(k);
    if (w) return w.cls !== "melee";
    return ARMOUR_LOOKUP.has(k);
  };
  const kitKeys = civilian
    ? [...R.kit, ...(spec.extraWeapons ?? []), ...(spec.extraGear ?? [])]
        .filter(k => !isAnomalous(k) && !isIssuedForce(k))
    : [...STANDING_ISSUE, ...R.kit,
       ...(isTrade ? INDUCTION.kit : []),
       ...(spec.extraWeapons ?? []), ...(spec.extraGear ?? []),
       ...(TIER_ISSUE[tierKey] ?? [])];
  const weapons = [], armour = [], gear = [];
  for (const k of new Set(kitKeys)) {
    if (WEAPON_LOOKUP.has(k)) weapons.push(k);
    else if (ARMOUR_LOOKUP.has(k)) armour.push(k);
    else if (GEAR_LOOKUP.has(k)) gear.push(k);
    else throw new Error(`${where}: ${spec.name} issued unknown item "${k}"`);
  }
  return { ...spec, label: R.label, blurb: R.blurb, skills, weapons, armour, gear };
}