Release Healer Man 0.1.20

scripts/dungeon-pipeline/audit-wow-dungeon-content.mjs

@@ -116,10 +116,12 @@ function reportMarkdown(report) {
     dungeon.proceduralModels, "|", dungeon.status, "|",
   ].join(" "));
   return [
-    "# WoW dungeon content report",
+    "# WoW dungeon combat and animation report",
     "",
     "Status: **" + report.status + "**",
     "",
+    "Scope: executable combat populations and creature animation bindings. This report does not certify instance scripts, doors, interactables, escorts, waves, vehicles, or navigation.",
+    "",
     "Coverage: " + report.summary.dungeons + " dungeons, " + report.summary.mobs
       + " mobs, " + report.summary.bosses + " bosses, " + report.summary.attacks
       + " executable attacks, and " + report.summary.specialAttacks + " special attacks/mechanics.",
@@ -177,6 +179,10 @@ for (const dungeon of definitions) {
   let specialAttacks = 0;
   let nativeModels = 0;
   let proceduralModels = 0;
+  const optionalBossEntityIds = new Set((dungeon.objectiveOrder ?? [])
+    .filter((objective) => objective.optional)
+    .map((objective) => dungeon.staticSpawns?.find((spawn) => spawn.id === objective.id)?.entityId)
+    .filter(Boolean));
 
   if (!entities.length) dungeonIssues.push("has no combat entities.");
   if (!bosses.length) dungeonIssues.push("has no bosses.");
@@ -203,7 +209,7 @@ for (const dungeon of definitions) {
     attacks += entityAttacks.length;
     const specials = entityAttacks.filter((attack) => attack.id !== "basic-attack");
     specialAttacks += specials.length;
-    if (entity.kind === "boss" && !specials.length) {
+    if (entity.kind === "boss" && !specials.length && !optionalBossEntityIds.has(entityId)) {
       const exceptionKey = dungeon.id + ":" + entityId;
       if (!basicOnlyBossExceptions.has(exceptionKey)) {
         dungeonIssues.push(entityId + " has no boss mechanic beyond its basic attack.");
@@ -297,7 +303,7 @@ const summary = dungeons.reduce((result, dungeon) => ({
 const report = {
   schemaVersion: 1,
   status: issues.length ? "blocked" : "green",
-  scope: "HealerMan WoW five-player campaign",
+  scope: "HealerMan WoW five-player combat and animation coverage",
   summary,
   documentedExceptions,
   animationFallbacks,
@@ -317,4 +323,4 @@ console.log(JSON.stringify({
   documentedExceptions: report.documentedExceptions,
   issues: report.issues,
 }, null, 2));
-if (issues.length) process.exitCode = 1;
+if (issues.length) process.exitCode = 1;