From cf6d3cbe086ca986043828e98c1d084ce6501f53 Mon Sep 17 00:00:00 2001
From: Kosmos <me@kosmos.ac>
Date: Tue, 21 Apr 2026 20:59:09 +0000
Subject: [PATCH] Explain notices and reorder result sections

---
 lang/de.json                     |  1 +
 lang/en.json                     |  1 +
 module.json                      |  2 +-
 scripts/apps/audit-report-app.js | 23 +++++++++++++----------
 4 files changed, 16 insertions(+), 11 deletions(-)

diff --git a/lang/de.json b/lang/de.json
index 9ff2172..ae75fe6 100644
--- a/lang/de.json
+++ b/lang/de.json
@@ -45,6 +45,7 @@
     },
     "Notice": {
       "Title": "Hinweise",
+      "ExcludedFromFindings": "Diese Fälle werden zur Einordnung separat angezeigt und bewusst nicht als Findings in die Ergebnisliste aufgenommen.",
       "InactiveModuleReferences": "Die aktive Welt referenziert Dateien aus inaktiven Modulen: {modules}",
       "MissingModuleReferences": "Die aktive Welt referenziert Dateien aus Modulordnern, die von Foundry derzeit nicht als Module erkannt werden: {modules}"
     },
diff --git a/lang/en.json b/lang/en.json
index 5d69397..26d661c 100644
--- a/lang/en.json
+++ b/lang/en.json
@@ -45,6 +45,7 @@
     },
     "Notice": {
       "Title": "Notes",
+      "ExcludedFromFindings": "These cases are shown separately for context and are intentionally excluded from the findings list.",
       "InactiveModuleReferences": "The active world references files from inactive modules: {modules}",
       "MissingModuleReferences": "The active world references files from module folders that Foundry does not currently recognize as installed modules: {modules}"
     },
diff --git a/module.json b/module.json
index f9b9192..1e8c4c5 100644
--- a/module.json
+++ b/module.json
@@ -2,7 +2,7 @@
   "id": "kosmos-storage-audit",
   "title": "Kosmos Storage Audit",
   "description": "Analyzes media references and risky storage locations across Foundry data and public roots.",
-  "version": "0.0.34",
+  "version": "0.0.35",
   "compatibility": {
     "minimum": "13",
     "verified": "13"
diff --git a/scripts/apps/audit-report-app.js b/scripts/apps/audit-report-app.js
index f927b93..406e905 100644
--- a/scripts/apps/audit-report-app.js
+++ b/scripts/apps/audit-report-app.js
@@ -225,6 +225,7 @@ function renderNotices(notices, loading) {
   return `
     <section class="storage-audit__summary storage-audit__summary--notices">
       <h3>${localize("KSA.Notice.Title")}</h3>
+      <p>${localize("KSA.Notice.ExcludedFromFindings")}</p>
       <ul class="storage-audit__notice-list">${items}</ul>
     </section>
   `;
@@ -267,24 +268,26 @@ function renderGroupedFindingList(groupedFindings, hasAnalysis, loading, orphanF
   if (loading || !hasAnalysis) return "";
 
   const sections = [];
-  if (groupedFindings.nonPackageToPackage.length) {
+  if (groupedFindings.brokenReferences.length) {
     sections.push(renderGroupedSection(
-      localize("KSA.Section.UnanchoredPackageTargets"),
-      localize("KSA.Section.UnanchoredPackageTargetsDesc"),
-      renderGroupedTable(groupedFindings.nonPackageToPackage, {
-        includeOwner: true,
+      localize("KSA.Section.BrokenTargets"),
+      localize("KSA.Section.BrokenTargetsDesc"),
+      "",
+      renderGroupedTable(groupedFindings.brokenReferences, {
+        includeOwner: false,
         includeReason: true,
         includeSources: true
       })
     ));
   }
 
-  if (groupedFindings.brokenReferences.length) {
+  if (groupedFindings.nonPackageToPackage.length) {
     sections.push(renderGroupedSection(
-      localize("KSA.Section.BrokenTargets"),
-      localize("KSA.Section.BrokenTargetsDesc"),
-      renderGroupedTable(groupedFindings.brokenReferences, {
-        includeOwner: false,
+      localize("KSA.Section.UnanchoredPackageTargets"),
+      localize("KSA.Section.UnanchoredPackageTargetsDesc"),
+      "",
+      renderGroupedTable(groupedFindings.nonPackageToPackage, {
+        includeOwner: true,
         includeReason: true,
         includeSources: true
       })