@alpaca-software/40kdc-data 0.5.12 → 0.5.15

package/dist/integrity.js

@@ -0,0 +1,120 @@
+import { readFileSync } from "node:fs";
+import { glob } from "glob";
+import { resolve, basename, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+const DATA_ROOT = resolve(__dirname, "../../data");
+/**
+ * Factions whose units carry exactly one bare legion/faction faction_keyword.
+ *
+ * These are the shared-datasheet factions where contamination has been observed:
+ * a unit materialized from a parent template keeps the parent's faction keyword
+ * (e.g. a World Eaters Chaos Rhino left carrying `Emperor's Children`, or a Chaos
+ * Space Marines unit carrying the full multi-legion union line). For a faction in
+ * this map, every unit's `faction_keywords` must be a subset of `{home}`.
+ *
+ * Factions absent from this map (e.g. Space Marine chapters, which legitimately
+ * carry several faction_keywords) are not subject to the membership check, so the
+ * guard never produces a false positive on them. Extend this map as other
+ * single-token factions adopt the convention.
+ */
+export const FACTION_HOME_KEYWORD = {
+    "chaos-space-marines": "Heretic Astartes",
+    "world-eaters": "World Eaters",
+    "death-guard": "Death Guard",
+    "thousand-sons": "Thousand Sons",
+    "emperors-children": "Emperor’s Children",
+};
+function readArray(file) {
+    return JSON.parse(readFileSync(file, "utf-8"));
+}
+function loadAbilityIds(file, into) {
+    try {
+        for (const a of readArray(file)) {
+            if (a.ability_id)
+                into.add(a.ability_id);
+        }
+    }
+    catch {
+        // file absent — faction has no enrichment abilities, or no shared core pool
+    }
+}
+/**
+ * Cross-entity referential integrity that per-file JSON Schema validation cannot
+ * express:
+ *
+ *  - every unit `ability_id` must resolve to an ability defined in that faction's
+ *    `enrichment/<faction>/abilities.json` (or the shared `enrichment/_core` pool).
+ *    Same-faction scoping is deliberate — a union check would pass shared-unit
+ *    contaminants because they happen to be defined in some *other* faction's
+ *    enrichment.
+ *  - every unit `faction_keywords` entry must be permitted for the unit's faction
+ *    (see {@link FACTION_HOME_KEYWORD}).
+ *
+ * Results reuse {@link ValidationResult} so the CLI reporter can render them.
+ */
+export async function checkReferentialIntegrity(dataRoot) {
+    const root = dataRoot ?? DATA_ROOT;
+    const result = {
+        totalFiles: 0,
+        totalItems: 0,
+        passed: 0,
+        failed: 0,
+        errors: [],
+    };
+    // Shared core ability pool, available to every faction (optional).
+    const coreAbilities = new Set();
+    loadAbilityIds(resolve(root, "enrichment/_core/abilities.json"), coreAbilities);
+    const unitFiles = await glob("core/*/units.json", { cwd: root, absolute: true });
+    unitFiles.sort();
+    for (const file of unitFiles) {
+        const faction = basename(dirname(file));
+        if (faction.startsWith("_"))
+            continue; // scratch/example/report dirs
+        let units;
+        try {
+            units = readArray(file);
+        }
+        catch {
+            continue; // structural problems are the AJV pass's job
+        }
+        if (!Array.isArray(units))
+            continue;
+        const defined = new Set(coreAbilities);
+        loadAbilityIds(resolve(root, `enrichment/${faction}/abilities.json`), defined);
+        const home = FACTION_HOME_KEYWORD[faction];
+        result.totalFiles++;
+        for (let i = 0; i < units.length; i++) {
+            const u = units[i];
+            result.totalItems++;
+            const errs = [];
+            for (const aid of u.ability_ids ?? []) {
+                if (!defined.has(aid)) {
+                    errs.push({
+                        path: `/${i}/ability_ids`,
+                        message: `unit "${u.id}": ability_id "${aid}" is not defined in ${faction} enrichment`,
+                    });
+                }
+            }
+            if (home !== undefined) {
+                for (const fk of u.faction_keywords ?? []) {
+                    if (fk !== home) {
+                        errs.push({
+                            path: `/${i}/faction_keywords`,
+                            message: `unit "${u.id}": faction_keyword "${fk}" is not permitted for ${faction} (expected only "${home}")`,
+                        });
+                    }
+                }
+            }
+            if (errs.length > 0) {
+                result.failed++;
+                result.errors.push({ file, index: i, errors: errs });
+            }
+            else {
+                result.passed++;
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=integrity.js.map

package/dist/integrity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.js","sourceRoot":"","sources":["../src/integrity.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { glob } from \"glob\";\nimport { resolve, basename, dirname } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type { ValidationResult } from \"./validate.js\";\n\nconst __dirname = fileURLToPath(new URL(\".\", import.meta.url));\nconst DATA_ROOT = resolve(__dirname, \"../../data\");\n\n/**\n * Factions whose units carry exactly one bare legion/faction faction_keyword.\n *\n * These are the shared-datasheet factions where contamination has been observed:\n * a unit materialized from a parent template keeps the parent's faction keyword\n * (e.g. a World Eaters Chaos Rhino left carrying `Emperor's Children`, or a Chaos\n * Space Marines unit carrying the full multi-legion union line). For a faction in\n * this map, every unit's `faction_keywords` must be a subset of `{home}`.\n *\n * Factions absent from this map (e.g. Space Marine chapters, which legitimately\n * carry several faction_keywords) are not subject to the membership check, so the\n * guard never produces a false positive on them. Extend this map as other\n * single-token factions adopt the convention.\n */\nexport const FACTION_HOME_KEYWORD: Record<string, string> = {\n  \"chaos-space-marines\": \"Heretic Astartes\",\n  \"world-eaters\": \"World Eaters\",\n  \"death-guard\": \"Death Guard\",\n  \"thousand-sons\": \"Thousand Sons\",\n  \"emperors-children\": \"Emperor’s Children\",\n};\n\ninterface UnitLike {\n  id?: string;\n  ability_ids?: string[];\n  faction_keywords?: string[];\n}\ninterface AbilityLike {\n  ability_id?: string;\n}\n\nfunction readArray<T>(file: string): T[] {\n  return JSON.parse(readFileSync(file, \"utf-8\")) as T[];\n}\n\nfunction loadAbilityIds(file: string, into: Set<string>): void {\n  try {\n    for (const a of readArray<AbilityLike>(file)) {\n      if (a.ability_id) into.add(a.ability_id);\n    }\n  } catch {\n    // file absent — faction has no enrichment abilities, or no shared core pool\n  }\n}\n\n/**\n * Cross-entity referential integrity that per-file JSON Schema validation cannot\n * express:\n *\n *  - every unit `ability_id` must resolve to an ability defined in that faction's\n *    `enrichment/<faction>/abilities.json` (or the shared `enrichment/_core` pool).\n *    Same-faction scoping is deliberate — a union check would pass shared-unit\n *    contaminants because they happen to be defined in some *other* faction's\n *    enrichment.\n *  - every unit `faction_keywords` entry must be permitted for the unit's faction\n *    (see {@link FACTION_HOME_KEYWORD}).\n *\n * Results reuse {@link ValidationResult} so the CLI reporter can render them.\n */\nexport async function checkReferentialIntegrity(dataRoot?: string): Promise<ValidationResult> {\n  const root = dataRoot ?? DATA_ROOT;\n  const result: ValidationResult = {\n    totalFiles: 0,\n    totalItems: 0,\n    passed: 0,\n    failed: 0,\n    errors: [],\n  };\n\n  // Shared core ability pool, available to every faction (optional).\n  const coreAbilities = new Set<string>();\n  loadAbilityIds(resolve(root, \"enrichment/_core/abilities.json\"), coreAbilities);\n\n  const unitFiles = await glob(\"core/*/units.json\", { cwd: root, absolute: true });\n  unitFiles.sort();\n\n  for (const file of unitFiles) {\n    const faction = basename(dirname(file));\n    if (faction.startsWith(\"_\")) continue; // scratch/example/report dirs\n\n    let units: UnitLike[];\n    try {\n      units = readArray<UnitLike>(file);\n    } catch {\n      continue; // structural problems are the AJV pass's job\n    }\n    if (!Array.isArray(units)) continue;\n\n    const defined = new Set<string>(coreAbilities);\n    loadAbilityIds(resolve(root, `enrichment/${faction}/abilities.json`), defined);\n    const home = FACTION_HOME_KEYWORD[faction];\n\n    result.totalFiles++;\n    for (let i = 0; i < units.length; i++) {\n      const u = units[i];\n      result.totalItems++;\n      const errs: Array<{ path: string; message: string }> = [];\n\n      for (const aid of u.ability_ids ?? []) {\n        if (!defined.has(aid)) {\n          errs.push({\n            path: `/${i}/ability_ids`,\n            message: `unit \"${u.id}\": ability_id \"${aid}\" is not defined in ${faction} enrichment`,\n          });\n        }\n      }\n\n      if (home !== undefined) {\n        for (const fk of u.faction_keywords ?? []) {\n          if (fk !== home) {\n            errs.push({\n              path: `/${i}/faction_keywords`,\n              message: `unit \"${u.id}\": faction_keyword \"${fk}\" is not permitted for ${faction} (expected only \"${home}\")`,\n            });\n          }\n        }\n      }\n\n      if (errs.length > 0) {\n        result.failed++;\n        result.errors.push({ file, index: i, errors: errs });\n      } else {\n        result.passed++;\n      }\n    }\n  }\n\n  return result;\n}\n"]}

package/dist/merge-faction-pack.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=merge-faction-pack.d.ts.map

package/dist/merge-faction-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-faction-pack.d.ts","sourceRoot":"","sources":["../src/merge-faction-pack.ts"],"names":[],"mappings":""}

package/dist/merge-faction-pack.js

@@ -0,0 +1,157 @@
+/**
+ * Merge IP-safe faction-pack staging (`data/_audit/faction-pack-input/<faction>.json`,
+ * produced by `extract-faction-pack.ts`) into `data/core/<faction>/`.
+ *
+ * For every staged detachment whose *core* entry is still a bare shell — empty
+ * `stratagem_ids` AND empty `enhancement_ids` — this creates the core stratagem
+ * and enhancement entities from the staged metadata and wires their ids onto the
+ * detachment. Detachments that already carry entities (converted from army-assist,
+ * or merged earlier) are left untouched, so re-running is additive and safe.
+ *
+ * The DSL link stays open: every created entity gets `ability_id: null`. Authoring
+ * the mechanic happens separately via the `author:*` pipeline.
+ *
+ * Field provenance (mirrors the hand-merged Space Marine packs):
+ *  - stratagem: name + cp_cost + phases + player_turn straight from staging; the
+ *    GW `type` is omitted (faction packs don't print it for new detachments) and
+ *    `timing` defaults to `once-per-phase` when the pack didn't state a frequency.
+ *  - enhancement: name from staging; `cost: 0` + `points_provisional: true` until
+ *    the Munitorum Field Manual lands; `keyword_restrictions` is the faction's
+ *    army keyword; `upgrade_tag: true` (faction-pack enhancements are upgrades).
+ *
+ * IP firewall: staging carries names + numeric/enum metadata only — never prose —
+ * so nothing this tool writes is GW rules text.
+ *
+ * Usage:
+ *   tsx tools/src/merge-faction-pack.ts <faction-id> [<faction-id> …]
+ *   tsx tools/src/merge-faction-pack.ts --all-xenos
+ */
+import { readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+const DATA_ROOT = resolve(__dirname, "../../data");
+/** Faction-id → the army keyword that gates its enhancements. */
+const FACTION_KEYWORD = {
+    orks: "Orks",
+    aeldari: "Aeldari",
+    drukhari: "Drukhari",
+    tyranids: "Tyranids",
+    "genestealer-cults": "Genestealer Cults",
+    necrons: "Necrons",
+    "leagues-of-votann": "Leagues of Votann",
+    "tau-empire": "T’au Empire",
+};
+const XENOS = Object.keys(FACTION_KEYWORD);
+const GAME_VERSION = { edition: "11th", dataslate: "pre-launch-provisional" };
+function readJson(path) {
+    return JSON.parse(readFileSync(path, "utf-8"));
+}
+function writeJson(path, value) {
+    writeFileSync(path, JSON.stringify(value, null, 2) + "\n");
+}
+function mergeFaction(faction) {
+    const keyword = FACTION_KEYWORD[faction];
+    if (!keyword)
+        throw new Error(`no faction keyword mapping for ${faction}`);
+    const dir = resolve(DATA_ROOT, "core", faction);
+    const staging = readJson(resolve(DATA_ROOT, "_audit", "faction-pack-input", `${faction}.json`));
+    const detachments = readJson(resolve(dir, "detachments.json"));
+    const stratagems = readJson(resolve(dir, "stratagems.json"));
+    const enhancements = readJson(resolve(dir, "enhancements.json"));
+    const detById = new Map(detachments.map((d) => [d.id, d]));
+    const stratIds = new Set(stratagems.map((s) => s.id));
+    const enhIds = new Set(enhancements.map((e) => e.id));
+    let addedStrat = 0;
+    let addedEnh = 0;
+    let wiredDets = 0;
+    const skipped = [];
+    const renames = [];
+    /**
+     * A globally-unique id for a new entity. GW reuses stratagem/enhancement names
+     * across detachments (e.g. Ork "Long, Uncontrolled Bursts" is in both More Dakka!
+     * and Rollin' Deff) — distinct mechanics that collide on the bare name kebab. On
+     * collision we detachment-scope the id so existing ids stay stable and the entity
+     * collection (keyed by id) never overwrites. The staging entry is renamed to match.
+     */
+    function uniqueId(baseId, detId, taken) {
+        if (!taken.has(baseId))
+            return baseId;
+        const scoped = `${detId}-${baseId}`;
+        if (taken.has(scoped))
+            throw new Error(`cannot disambiguate id ${baseId} for ${detId}`);
+        renames.push(`${baseId} → ${scoped}`);
+        return scoped;
+    }
+    for (const sd of staging.detachments) {
+        const det = detById.get(sd.id);
+        if (!det) {
+            skipped.push(`${sd.id} (no core detachment)`);
+            continue;
+        }
+        const isBareShell = (det.stratagem_ids ?? []).length === 0 &&
+            (det.enhancement_ids ?? []).length === 0;
+        if (!isBareShell)
+            continue; // already populated — leave it.
+        for (const s of sd.stratagems) {
+            s.id = uniqueId(s.id, sd.id, stratIds); // mutate staging to stay consistent
+            stratagems.push({
+                id: s.id,
+                name: s.name,
+                category: "detachment",
+                detachment_id: sd.id,
+                cp_cost: s.cp_cost ?? 1,
+                phases: s.phases,
+                player_turn: s.player_turn ?? "either",
+                timing: s.timing ?? "once-per-phase",
+                target_restrictions: null,
+                ability_id: null,
+                game_version: { ...GAME_VERSION },
+            });
+            stratIds.add(s.id);
+            addedStrat++;
+        }
+        for (const e of sd.enhancements) {
+            e.id = uniqueId(e.id, sd.id, enhIds);
+            enhancements.push({
+                id: e.id,
+                name: e.name,
+                detachment_id: sd.id,
+                cost: e.cost ?? 0,
+                keyword_restrictions: [keyword],
+                ability_id: null,
+                is_unique: true,
+                game_version: { ...GAME_VERSION },
+                points_provisional: true,
+                upgrade_tag: true,
+                max_targets: 1,
+            });
+            enhIds.add(e.id);
+            addedEnh++;
+        }
+        det.stratagem_ids = sd.stratagems.map((s) => s.id);
+        det.enhancement_ids = sd.enhancements.map((e) => e.id);
+        wiredDets++;
+    }
+    writeJson(resolve(dir, "detachments.json"), detachments);
+    writeJson(resolve(dir, "stratagems.json"), stratagems);
+    writeJson(resolve(dir, "enhancements.json"), enhancements);
+    // Persist any id renames back to staging so it stays the source for authoring.
+    if (renames.length)
+        writeJson(resolve(DATA_ROOT, "_audit", "faction-pack-input", `${faction}.json`), staging);
+    console.log(`${faction}: wired ${wiredDets} detachment(s), +${addedStrat} stratagems, +${addedEnh} enhancements` +
+        (renames.length ? `; renamed ${renames.join("; ")}` : "") +
+        (skipped.length ? `; skipped ${skipped.join(", ")}` : ""));
+}
+function main() {
+    const args = process.argv.slice(2);
+    const factions = args.includes("--all-xenos") ? XENOS : args;
+    if (factions.length === 0) {
+        console.error("usage: merge-faction-pack.ts <faction-id>… | --all-xenos");
+        process.exit(1);
+    }
+    for (const f of factions)
+        mergeFaction(f);
+}
+main();
+//# sourceMappingURL=merge-faction-pack.js.map

package/dist/merge-faction-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-faction-pack.js","sourceRoot":"","sources":["../src/merge-faction-pack.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Merge IP-safe faction-pack staging (`data/_audit/faction-pack-input/<faction>.json`,\n * produced by `extract-faction-pack.ts`) into `data/core/<faction>/`.\n *\n * For every staged detachment whose *core* entry is still a bare shell — empty\n * `stratagem_ids` AND empty `enhancement_ids` — this creates the core stratagem\n * and enhancement entities from the staged metadata and wires their ids onto the\n * detachment. Detachments that already carry entities (converted from army-assist,\n * or merged earlier) are left untouched, so re-running is additive and safe.\n *\n * The DSL link stays open: every created entity gets `ability_id: null`. Authoring\n * the mechanic happens separately via the `author:*` pipeline.\n *\n * Field provenance (mirrors the hand-merged Space Marine packs):\n *  - stratagem: name + cp_cost + phases + player_turn straight from staging; the\n *    GW `type` is omitted (faction packs don't print it for new detachments) and\n *    `timing` defaults to `once-per-phase` when the pack didn't state a frequency.\n *  - enhancement: name from staging; `cost: 0` + `points_provisional: true` until\n *    the Munitorum Field Manual lands; `keyword_restrictions` is the faction's\n *    army keyword; `upgrade_tag: true` (faction-pack enhancements are upgrades).\n *\n * IP firewall: staging carries names + numeric/enum metadata only — never prose —\n * so nothing this tool writes is GW rules text.\n *\n * Usage:\n *   tsx tools/src/merge-faction-pack.ts <faction-id> [<faction-id> …]\n *   tsx tools/src/merge-faction-pack.ts --all-xenos\n */\nimport { readFileSync, writeFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst __dirname = fileURLToPath(new URL(\".\", import.meta.url));\nconst DATA_ROOT = resolve(__dirname, \"../../data\");\n\n/** Faction-id → the army keyword that gates its enhancements. */\nconst FACTION_KEYWORD: Record<string, string> = {\n  orks: \"Orks\",\n  aeldari: \"Aeldari\",\n  drukhari: \"Drukhari\",\n  tyranids: \"Tyranids\",\n  \"genestealer-cults\": \"Genestealer Cults\",\n  necrons: \"Necrons\",\n  \"leagues-of-votann\": \"Leagues of Votann\",\n  \"tau-empire\": \"T’au Empire\",\n};\n\nconst XENOS = Object.keys(FACTION_KEYWORD);\n\nconst GAME_VERSION = { edition: \"11th\", dataslate: \"pre-launch-provisional\" } as const;\n\ninterface StagedStratagem {\n  id: string;\n  name: string;\n  type: string | null;\n  cp_cost: number | null;\n  phases: string[];\n  player_turn: string | null;\n  timing: string | null;\n}\ninterface StagedEnhancement {\n  id: string;\n  name: string;\n  cost: number | null;\n}\ninterface StagedDetachment {\n  id: string;\n  name: string;\n  detachment_rule_name: string | null;\n  stratagems: StagedStratagem[];\n  enhancements: StagedEnhancement[];\n}\ninterface Staging {\n  faction_id: string;\n  detachments: StagedDetachment[];\n}\n\nfunction readJson<T>(path: string): T {\n  return JSON.parse(readFileSync(path, \"utf-8\")) as T;\n}\nfunction writeJson(path: string, value: unknown): void {\n  writeFileSync(path, JSON.stringify(value, null, 2) + \"\\n\");\n}\n\nfunction mergeFaction(faction: string): void {\n  const keyword = FACTION_KEYWORD[faction];\n  if (!keyword) throw new Error(`no faction keyword mapping for ${faction}`);\n\n  const dir = resolve(DATA_ROOT, \"core\", faction);\n  const staging = readJson<Staging>(\n    resolve(DATA_ROOT, \"_audit\", \"faction-pack-input\", `${faction}.json`),\n  );\n  const detachments = readJson<Record<string, unknown>[]>(resolve(dir, \"detachments.json\"));\n  const stratagems = readJson<Record<string, unknown>[]>(resolve(dir, \"stratagems.json\"));\n  const enhancements = readJson<Record<string, unknown>[]>(resolve(dir, \"enhancements.json\"));\n\n  const detById = new Map(detachments.map((d) => [d.id as string, d]));\n  const stratIds = new Set(stratagems.map((s) => s.id as string));\n  const enhIds = new Set(enhancements.map((e) => e.id as string));\n\n  let addedStrat = 0;\n  let addedEnh = 0;\n  let wiredDets = 0;\n  const skipped: string[] = [];\n  const renames: string[] = [];\n\n  /**\n   * A globally-unique id for a new entity. GW reuses stratagem/enhancement names\n   * across detachments (e.g. Ork \"Long, Uncontrolled Bursts\" is in both More Dakka!\n   * and Rollin' Deff) — distinct mechanics that collide on the bare name kebab. On\n   * collision we detachment-scope the id so existing ids stay stable and the entity\n   * collection (keyed by id) never overwrites. The staging entry is renamed to match.\n   */\n  function uniqueId(baseId: string, detId: string, taken: Set<string>): string {\n    if (!taken.has(baseId)) return baseId;\n    const scoped = `${detId}-${baseId}`;\n    if (taken.has(scoped)) throw new Error(`cannot disambiguate id ${baseId} for ${detId}`);\n    renames.push(`${baseId} → ${scoped}`);\n    return scoped;\n  }\n\n  for (const sd of staging.detachments) {\n    const det = detById.get(sd.id);\n    if (!det) {\n      skipped.push(`${sd.id} (no core detachment)`);\n      continue;\n    }\n    const isBareShell =\n      ((det.stratagem_ids as unknown[]) ?? []).length === 0 &&\n      ((det.enhancement_ids as unknown[]) ?? []).length === 0;\n    if (!isBareShell) continue; // already populated — leave it.\n\n    for (const s of sd.stratagems) {\n      s.id = uniqueId(s.id, sd.id, stratIds); // mutate staging to stay consistent\n      stratagems.push({\n        id: s.id,\n        name: s.name,\n        category: \"detachment\",\n        detachment_id: sd.id,\n        cp_cost: s.cp_cost ?? 1,\n        phases: s.phases,\n        player_turn: s.player_turn ?? \"either\",\n        timing: s.timing ?? \"once-per-phase\",\n        target_restrictions: null,\n        ability_id: null,\n        game_version: { ...GAME_VERSION },\n      });\n      stratIds.add(s.id);\n      addedStrat++;\n    }\n    for (const e of sd.enhancements) {\n      e.id = uniqueId(e.id, sd.id, enhIds);\n      enhancements.push({\n        id: e.id,\n        name: e.name,\n        detachment_id: sd.id,\n        cost: e.cost ?? 0,\n        keyword_restrictions: [keyword],\n        ability_id: null,\n        is_unique: true,\n        game_version: { ...GAME_VERSION },\n        points_provisional: true,\n        upgrade_tag: true,\n        max_targets: 1,\n      });\n      enhIds.add(e.id);\n      addedEnh++;\n    }\n\n    det.stratagem_ids = sd.stratagems.map((s) => s.id);\n    det.enhancement_ids = sd.enhancements.map((e) => e.id);\n    wiredDets++;\n  }\n\n  writeJson(resolve(dir, \"detachments.json\"), detachments);\n  writeJson(resolve(dir, \"stratagems.json\"), stratagems);\n  writeJson(resolve(dir, \"enhancements.json\"), enhancements);\n  // Persist any id renames back to staging so it stays the source for authoring.\n  if (renames.length)\n    writeJson(\n      resolve(DATA_ROOT, \"_audit\", \"faction-pack-input\", `${faction}.json`),\n      staging,\n    );\n\n  console.log(\n    `${faction}: wired ${wiredDets} detachment(s), +${addedStrat} stratagems, +${addedEnh} enhancements` +\n      (renames.length ? `; renamed ${renames.join(\"; \")}` : \"\") +\n      (skipped.length ? `; skipped ${skipped.join(\", \")}` : \"\"),\n  );\n}\n\nfunction main(): void {\n  const args = process.argv.slice(2);\n  const factions = args.includes(\"--all-xenos\") ? XENOS : args;\n  if (factions.length === 0) {\n    console.error(\"usage: merge-faction-pack.ts <faction-id>… | --all-xenos\");\n    process.exit(1);\n  }\n  for (const f of factions) mergeFaction(f);\n}\n\nmain();\n"]}

package/dist/pack-blocks.d.ts

@@ -0,0 +1,32 @@
+/** A positioned text block from `pdftotext -bbox-layout`. `gy` is page-globalised y. */
+export interface Block {
+    x: number;
+    gy: number;
+    text: string;
+}
+/** Section headers (caps) that are never card/enhancement names. */
+export declare const SECTION_WORDS: RegExp;
+export declare function runPdftotext(args: string[]): string;
+export declare const decodeEntities: (s: string) => string;
+/**
+ * Parse the whole pack's bbox-layout HTML into positioned blocks. `gy` globalises
+ * y across pages (pageIndex × 100000 + y) so blocks sort in reading order without
+ * relying on printed page numbers (which drift from physical pages on later pages
+ * when full-bleed art is inserted).
+ */
+export declare function allBlocks(pdf: string): Block[];
+/** Title/caps name → kebab id, matching existing entity-id conventions. */
+export declare function slug(name: string): string;
+/** Title-case a pack ALL-CAPS header for storage as a display name. */
+export declare function titleCase(raw: string): string;
+export declare const normCaps: (s: string) => string;
+/** A card/enhancement name candidate: a real caps header, not a section word or token. */
+export declare const isCapsHeader: (t: string) => boolean;
+/** Two blocks share a column when their left edges are within tolerance. */
+export declare const sameColumn: (a: number, b: number) => boolean;
+/** Split a trailing "… N CP" off a name block. */
+export declare const stripCp: (t: string) => {
+    name: string;
+    cp: number | null;
+};
+//# sourceMappingURL=pack-blocks.d.ts.map

package/dist/pack-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-blocks.d.ts","sourceRoot":"","sources":["../src/pack-blocks.ts"],"names":[],"mappings":"AAsBA,wFAAwF;AACxF,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oEAAoE;AACpE,eAAO,MAAM,aAAa,QAA4E,CAAC;AAEvG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CASnD;AAED,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,KAAG,MAMf,CAAC;AAE7B;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,EAAE,CAc9C;AAED,2EAA2E;AAC3E,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOzC;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ7C;AAED,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,KAAG,MAC8B,CAAC;AAEpE,0FAA0F;AAC1F,eAAO,MAAM,YAAY,GAAI,GAAG,MAAM,KAAG,OAQhB,CAAC;AAE1B,4EAA4E;AAC5E,eAAO,MAAM,UAAU,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,OAA+B,CAAC;AAElF,kDAAkD;AAClD,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,KAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CAGpE,CAAC"}

package/dist/pack-blocks.js

@@ -0,0 +1,99 @@
+/**
+ * Shared bbox-coordinate primitives for parsing GW 11e Faction Pack PDFs.
+ *
+ * GW lays each card out as discrete, positioned text blocks. `pdftotext
+ * -bbox-layout` emits per-word coordinates; we group them into blocks and locate
+ * cards by coordinate (column + reading-order y) rather than by the linear text
+ * stream — `-layout` interleaves the packs' 2-column stratagem cards into garbage.
+ *
+ * These primitives are layout-independent (column positions differ across packs)
+ * and are shared by two tools:
+ *   - `extract-faction-pack.ts` — emits names + numeric/enum metadata only (the
+ *     committed, IP-safe staging file). It never writes prose.
+ *   - `author-input-pack.ts` — captures each card's rule body (prose) into the
+ *     gitignored authoring worklist. It is the only consumer that emits prose.
+ *
+ * Keeping the coordinate machinery here lets both share it without weakening the
+ * first tool's "never emits prose" property.
+ *
+ * Requires `pdftotext` (poppler) on PATH — authoring-time only, not CI.
+ */
+import { execFileSync } from "node:child_process";
+/** Section headers (caps) that are never card/enhancement names. */
+export const SECTION_WORDS = /^(DETACHMENT RULES?|ENHANCEMENTS?|STRATAGEMS?|KEYWORDS?|RESTRICTIONS?)$/;
+export function runPdftotext(args) {
+    try {
+        return execFileSync("pdftotext", args, { encoding: "utf-8", maxBuffer: 128 * 1024 * 1024 });
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            throw new Error("pdftotext not found — install poppler (e.g. `brew install poppler`).");
+        }
+        throw err;
+    }
+}
+export const decodeEntities = (s) => s
+    .replace(/&/g, "&")
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&#39;/g, "'")
+    .replace(/&quot;/g, '"');
+/**
+ * Parse the whole pack's bbox-layout HTML into positioned blocks. `gy` globalises
+ * y across pages (pageIndex × 100000 + y) so blocks sort in reading order without
+ * relying on printed page numbers (which drift from physical pages on later pages
+ * when full-bleed art is inserted).
+ */
+export function allBlocks(pdf) {
+    const html = runPdftotext(["-bbox-layout", pdf, "-"]);
+    const blocks = [];
+    html.split(/<page\b/).slice(1).forEach((pageHtml, pageIdx) => {
+        const offset = pageIdx * 100000;
+        for (const m of pageHtml.matchAll(/<block\b([^>]*)>([\s\S]*?)<\/block>/g)) {
+            const x = Number(/xMin="([\d.]+)"/.exec(m[1])?.[1] ?? "0");
+            const y = Number(/yMin="([\d.]+)"/.exec(m[1])?.[1] ?? "0");
+            const words = [...m[2].matchAll(/<word[^>]*>([^<]*)<\/word>/g)].map((w) => decodeEntities(w[1]));
+            const text = words.join(" ").replace(/\s+/g, " ").trim();
+            if (text)
+                blocks.push({ x, gy: offset + y, text });
+        }
+    });
+    return blocks;
+}
+/** Title/caps name → kebab id, matching existing entity-id conventions. */
+export function slug(name) {
+    return name
+        .toLowerCase()
+        .replace(/[’']/g, "")
+        .replace(/&/g, " and ")
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+/** Title-case a pack ALL-CAPS header for storage as a display name. */
+export function titleCase(raw) {
+    const small = new Set(["of", "the", "and", "to", "a", "in", "for"]);
+    return raw
+        .trim()
+        .toLowerCase()
+        .split(/\s+/)
+        .map((w, i) => (i > 0 && small.has(w) ? w : w.charAt(0).toUpperCase() + w.slice(1)))
+        .join(" ");
+}
+export const normCaps = (s) => s.toUpperCase().replace(/[’']/g, "'").replace(/\s+/g, " ").trim();
+/** A card/enhancement name candidate: a real caps header, not a section word or token. */
+export const isCapsHeader = (t) => /^[A-Z0-9][A-Z0-9'’.,!&/()\- ]*$/.test(t) &&
+    /[A-Z]{3,}/.test(t) && // a real word, not a "1CP"/"D6" token
+    t.length >= 3 &&
+    t.length <= 46 &&
+    t.split(" ").length <= 7 &&
+    !SECTION_WORDS.test(t) &&
+    !/^\d+\s?CP$/.test(t) &&
+    !/\bSTRATAGEM$/.test(t);
+/** Two blocks share a column when their left edges are within tolerance. */
+export const sameColumn = (a, b) => Math.abs(a - b) < 46;
+/** Split a trailing "… N CP" off a name block. */
+export const stripCp = (t) => {
+    const m = t.match(/^(.*?)[\s]+(\d+)\s?CP$/);
+    return m ? { name: m[1].trim(), cp: Number(m[2]) } : { name: t, cp: null };
+};
+//# sourceMappingURL=pack-blocks.js.map

package/dist/pack-blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-blocks.js","sourceRoot":"","sources":["../src/pack-blocks.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared bbox-coordinate primitives for parsing GW 11e Faction Pack PDFs.\n *\n * GW lays each card out as discrete, positioned text blocks. `pdftotext\n * -bbox-layout` emits per-word coordinates; we group them into blocks and locate\n * cards by coordinate (column + reading-order y) rather than by the linear text\n * stream — `-layout` interleaves the packs' 2-column stratagem cards into garbage.\n *\n * These primitives are layout-independent (column positions differ across packs)\n * and are shared by two tools:\n *   - `extract-faction-pack.ts` — emits names + numeric/enum metadata only (the\n *     committed, IP-safe staging file). It never writes prose.\n *   - `author-input-pack.ts` — captures each card's rule body (prose) into the\n *     gitignored authoring worklist. It is the only consumer that emits prose.\n *\n * Keeping the coordinate machinery here lets both share it without weakening the\n * first tool's \"never emits prose\" property.\n *\n * Requires `pdftotext` (poppler) on PATH — authoring-time only, not CI.\n */\nimport { execFileSync } from \"node:child_process\";\n\n/** A positioned text block from `pdftotext -bbox-layout`. `gy` is page-globalised y. */\nexport interface Block {\n  x: number;\n  gy: number;\n  text: string;\n}\n\n/** Section headers (caps) that are never card/enhancement names. */\nexport const SECTION_WORDS = /^(DETACHMENT RULES?|ENHANCEMENTS?|STRATAGEMS?|KEYWORDS?|RESTRICTIONS?)$/;\n\nexport function runPdftotext(args: string[]): string {\n  try {\n    return execFileSync(\"pdftotext\", args, { encoding: \"utf-8\", maxBuffer: 128 * 1024 * 1024 });\n  } catch (err: unknown) {\n    if ((err as { code?: string }).code === \"ENOENT\") {\n      throw new Error(\"pdftotext not found — install poppler (e.g. `brew install poppler`).\");\n    }\n    throw err;\n  }\n}\n\nexport const decodeEntities = (s: string): string =>\n  s\n    .replace(/&amp;/g, \"&\")\n    .replace(/&lt;/g, \"<\")\n    .replace(/&gt;/g, \">\")\n    .replace(/&#39;/g, \"'\")\n    .replace(/&quot;/g, '\"');\n\n/**\n * Parse the whole pack's bbox-layout HTML into positioned blocks. `gy` globalises\n * y across pages (pageIndex × 100000 + y) so blocks sort in reading order without\n * relying on printed page numbers (which drift from physical pages on later pages\n * when full-bleed art is inserted).\n */\nexport function allBlocks(pdf: string): Block[] {\n  const html = runPdftotext([\"-bbox-layout\", pdf, \"-\"]);\n  const blocks: Block[] = [];\n  html.split(/<page\\b/).slice(1).forEach((pageHtml, pageIdx) => {\n    const offset = pageIdx * 100000;\n    for (const m of pageHtml.matchAll(/<block\\b([^>]*)>([\\s\\S]*?)<\\/block>/g)) {\n      const x = Number(/xMin=\"([\\d.]+)\"/.exec(m[1])?.[1] ?? \"0\");\n      const y = Number(/yMin=\"([\\d.]+)\"/.exec(m[1])?.[1] ?? \"0\");\n      const words = [...m[2].matchAll(/<word[^>]*>([^<]*)<\\/word>/g)].map((w) => decodeEntities(w[1]));\n      const text = words.join(\" \").replace(/\\s+/g, \" \").trim();\n      if (text) blocks.push({ x, gy: offset + y, text });\n    }\n  });\n  return blocks;\n}\n\n/** Title/caps name → kebab id, matching existing entity-id conventions. */\nexport function slug(name: string): string {\n  return name\n    .toLowerCase()\n    .replace(/[’']/g, \"\")\n    .replace(/&/g, \" and \")\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n}\n\n/** Title-case a pack ALL-CAPS header for storage as a display name. */\nexport function titleCase(raw: string): string {\n  const small = new Set([\"of\", \"the\", \"and\", \"to\", \"a\", \"in\", \"for\"]);\n  return raw\n    .trim()\n    .toLowerCase()\n    .split(/\\s+/)\n    .map((w, i) => (i > 0 && small.has(w) ? w : w.charAt(0).toUpperCase() + w.slice(1)))\n    .join(\" \");\n}\n\nexport const normCaps = (s: string): string =>\n  s.toUpperCase().replace(/[’']/g, \"'\").replace(/\\s+/g, \" \").trim();\n\n/** A card/enhancement name candidate: a real caps header, not a section word or token. */\nexport const isCapsHeader = (t: string): boolean =>\n  /^[A-Z0-9][A-Z0-9'’.,!&/()\\- ]*$/.test(t) &&\n  /[A-Z]{3,}/.test(t) && // a real word, not a \"1CP\"/\"D6\" token\n  t.length >= 3 &&\n  t.length <= 46 &&\n  t.split(\" \").length <= 7 &&\n  !SECTION_WORDS.test(t) &&\n  !/^\\d+\\s?CP$/.test(t) &&\n  !/\\bSTRATAGEM$/.test(t);\n\n/** Two blocks share a column when their left edges are within tolerance. */\nexport const sameColumn = (a: number, b: number): boolean => Math.abs(a - b) < 46;\n\n/** Split a trailing \"… N CP\" off a name block. */\nexport const stripCp = (t: string): { name: string; cp: number | null } => {\n  const m = t.match(/^(.*?)[\\s]+(\\d+)\\s?CP$/);\n  return m ? { name: m[1].trim(), cp: Number(m[2]) } : { name: t, cp: null };\n};\n"]}

package/dist/report.d.ts

@@ -1,4 +1,4 @@
 import type { ValidationResult } from "./validate.js";
 export type ReporterMode = "pretty" | "json";
-export declare function formatReport(result: ValidationResult, mode: ReporterMode): string;
+export declare function formatReport(result: ValidationResult, mode: ReporterMode, title?: string): string;
 //# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7C,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAgCjF"}
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7C,wBAAgB,YAAY,CAC1B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,YAAY,EAClB,KAAK,SAAiC,GACrC,MAAM,CAgCR"}

package/dist/report.js

@@ -1,11 +1,11 @@
 import chalk from "chalk";
-export function formatReport(result, mode) {
+export function formatReport(result, mode, title = "40kdc Data Validation Report") {
     if (mode === "json") {
         return JSON.stringify(result, null, 2);
     }
     const lines = [];
     lines.push("");
-    lines.push(chalk.bold("40kdc Data Validation Report"));
+    lines.push(chalk.bold(title));
     lines.push(chalk.gray("─".repeat(40)));
     lines.push(`Files scanned:  ${result.totalFiles}`);
     lines.push(`Items validated: ${result.totalItems}`);

package/dist/report.js.map

@@ -1 +1 @@
-{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,MAAM,UAAU,YAAY,CAAC,MAAwB,EAAE,IAAkB;IACvE,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAEpD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;YAC/C,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["import chalk from \"chalk\";\nimport type { ValidationResult } from \"./validate.js\";\n\nexport type ReporterMode = \"pretty\" | \"json\";\n\nexport function formatReport(result: ValidationResult, mode: ReporterMode): string {\n  if (mode === \"json\") {\n    return JSON.stringify(result, null, 2);\n  }\n\n  const lines: string[] = [];\n  lines.push(\"\");\n  lines.push(chalk.bold(\"40kdc Data Validation Report\"));\n  lines.push(chalk.gray(\"─\".repeat(40)));\n  lines.push(`Files scanned:  ${result.totalFiles}`);\n  lines.push(`Items validated: ${result.totalItems}`);\n  lines.push(chalk.green(`Passed: ${result.passed}`));\n\n  if (result.failed > 0) {\n    lines.push(chalk.red(`Failed: ${result.failed}`));\n    lines.push(\"\");\n\n    for (const err of result.errors) {\n      const loc = err.index >= 0 ? `[${err.index}]` : \"\";\n      lines.push(chalk.red(`  ✗ ${err.file}${loc}`));\n      for (const e of err.errors) {\n        lines.push(chalk.yellow(`    ${e.path}: ${e.message}`));\n      }\n    }\n  } else {\n    lines.push(chalk.green(`Failed: 0`));\n    lines.push(\"\");\n    lines.push(chalk.green(\"All validations passed.\"));\n  }\n\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n"]}
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,MAAM,UAAU,YAAY,CAC1B,MAAwB,EACxB,IAAkB,EAClB,KAAK,GAAG,8BAA8B;IAEtC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAEpD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;YAC/C,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["import chalk from \"chalk\";\nimport type { ValidationResult } from \"./validate.js\";\n\nexport type ReporterMode = \"pretty\" | \"json\";\n\nexport function formatReport(\n  result: ValidationResult,\n  mode: ReporterMode,\n  title = \"40kdc Data Validation Report\",\n): string {\n  if (mode === \"json\") {\n    return JSON.stringify(result, null, 2);\n  }\n\n  const lines: string[] = [];\n  lines.push(\"\");\n  lines.push(chalk.bold(title));\n  lines.push(chalk.gray(\"─\".repeat(40)));\n  lines.push(`Files scanned:  ${result.totalFiles}`);\n  lines.push(`Items validated: ${result.totalItems}`);\n  lines.push(chalk.green(`Passed: ${result.passed}`));\n\n  if (result.failed > 0) {\n    lines.push(chalk.red(`Failed: ${result.failed}`));\n    lines.push(\"\");\n\n    for (const err of result.errors) {\n      const loc = err.index >= 0 ? `[${err.index}]` : \"\";\n      lines.push(chalk.red(`  ✗ ${err.file}${loc}`));\n      for (const e of err.errors) {\n        lines.push(chalk.yellow(`    ${e.path}: ${e.message}`));\n      }\n    }\n  } else {\n    lines.push(chalk.green(`Failed: 0`));\n    lines.push(\"\");\n    lines.push(chalk.green(\"All validations passed.\"));\n  }\n\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n"]}

package/dist/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":";AAsBA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAsC5C,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AA8C3B,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,SAAS,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAElE,QAAA,MAAM,WAAW,oJASP,CAAC;AACX,KAAK,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAgB9C,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,GAAG,CAAC;CACjB;AAED,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C;AAmID;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,CAAC,EACG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACrG,IAAI,GACJ,SAAS,GACZ,MAAM,GAAG,IAAI,CAQf;AA0mBD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,CAkDhG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc9E"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":";AAsBA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAuC5C,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AA8C3B,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,SAAS,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAElE,QAAA,MAAM,WAAW,oJASP,CAAC;AACX,KAAK,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAgB9C,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,GAAG,CAAC;CACjB;AAED,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C;AAgKD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,CAAC,EACG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACrG,IAAI,GACJ,SAAS,GACZ,MAAM,GAAG,IAAI,CAQf;AAmnBD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,CAsDhG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc9E"}

package/dist/runner.js

@@ -23,6 +23,7 @@ import { Dataset } from "./data/dataset.js";
 import { normalizeName } from "./data/normalize.js";
 import { maximalLoadout } from "./data/loadout.js";
 import { exportRoster } from "./export/index.js";
+import { decodeShareToken, encodeShareToken } from "./share/index.js";
 import { importRoster, tryImportRoster } from "./import/import-roster.js";
 import { createValidator } from "./schema-loader.js";
 import { attributeStages, crunch } from "./cruncher/index.js";
@@ -215,6 +216,34 @@ function handleExport(args) {
         return err("EXPORT_FAILED", { detail: e.message });
     }
 }
+function handleShareEncode(args) {
+    if (typeof args !== "object" || args === null) {
+        return err("INVALID_INPUT", { detail: "share_encode args must be an object" });
+    }
+    const a = args;
+    if (typeof a.list !== "object" || a.list === null) {
+        return err("INVALID_INPUT", { detail: "share_encode.list must be an object" });
+    }
+    try {
+        return ok(encodeShareToken(a.list));
+    }
+    catch (e) {
+        // An id absent from the embedded registry is the only expected throw.
+        return err("INVALID_INPUT", { detail: e.message });
+    }
+}
+function handleShareDecode(args) {
+    if (typeof args !== "object" || args === null) {
+        return err("INVALID_INPUT", { detail: "share_decode args must be an object" });
+    }
+    const a = args;
+    if (typeof a.token !== "string") {
+        return err("INVALID_INPUT", { detail: "share_decode.token must be a string" });
+    }
+    // The DecodeResult ({ ok, list } | { ok, reason }) is the compared value;
+    // a malformed/stale token is a normal result, not a protocol error.
+    return ok(decodeShareToken(a.token));
+}
 /**
  * Canonical string encoding of a base size for cross-impl comparison (mirrors the
  * string-encoding used by `maximal_loadout`). Returns null for an absent base.
@@ -318,6 +347,15 @@ function handleLinkedQuery(state, args) {
                     return err("UNKNOWN_ENTITY", { kind: "faction", id: input.factionId });
                 return ok(f.weapons.map((x) => x.id));
             }
+            case "units_with_keyword":
+                return ok(ds.unitsWithKeyword(input.keyword ?? "").map((u) => u.id));
+            case "allies_for": {
+                const raw = input.detachmentIds;
+                const detachmentIds = Array.isArray(raw) ? raw : [];
+                return ok(ds.alliesFor(input.factionId ?? "", detachmentIds).map((r) => r.id));
+            }
+            case "ally_units_for":
+                return ok(ds.allyUnitsFor(input.ruleId ?? "").map((u) => u.id));
             default:
                 return err("INVALID_INPUT", { detail: `unknown linked_query: ${a.query}` });
         }
@@ -856,6 +894,10 @@ export function dispatch(state, req) {
             return handleResolveTerrain(req.args);
         case "keystones":
             return handleKeystones(req.args);
+        case "share_encode":
+            return handleShareEncode(req.args);
+        case "share_decode":
+            return handleShareDecode(req.args);
         case "shutdown":
             return ok(null);
         default: