feat: extend taxonomy schema with relatedTerms and contrastsWith fields and add supporting UI rendering and documentation.

Author: mindpower

docs/data-schemas.md

@@ -16,6 +16,8 @@ Each entry in the master taxonomy array is a JavaScript object representing a co
   "broaderTerm": "Agentic Misbehavior",
   "definition": "An unintended deviation in an AI agent's behavior that causes it to pursue goals...",
   "scopeNote": "Raised during discussion of non-malicious agent misbehavior (2026-03-03)...",
+  "relatedTerms": ["Agent sabotage"],
+  "contrastsWith": ["Deterministic operation"],
   "workgroups": ["Security & Privacy", "Accuracy & Reliability"]
 }
 ```
@@ -36,8 +38,10 @@ Each entry in the master taxonomy array is a JavaScript object representing a co
     *   *Rule:* For example, the broader term of `Agent derailment` is `Agentic Misbehavior`.
     *   *Root nodes:* If the term is a top-level conceptual category, set this to `null`.
 *   **`definition`** *(String, Required):* A clear, technical, pre-competitive definition.
-    *   *Content Rule:* Vendor-neutral and objective. Do not mention proprietary commercial tools.
+    *   *Content Rule:* Vendor-neutral and objective. If the term represents an adjacent contrasting concept (e.g., *Tool* vs. *Skill*), the definition MUST explicitly state how it differs from its counterpart.
 *   **`scopeNote`** *(String, Optional):* Captures historical context, meeting review dates, or explanations of conceptual boundaries between working groups.
+*   **`relatedTerms`** *(Array of Strings, Optional):* Maps associative `skos:related` conceptual linkages (e.g., `["Skill", "Primitive"]`). Defaults to `[]`.
+*   **`contrastsWith`** *(Array of Strings, Optional):* Explicitly links paired contrasting terms (e.g., `["Tool"]`). Defaults to `[]`.
 *   **`workgroups`** *(Array of Strings, Required):* The working groups that share interest or joint ownership of this term (e.g., `["Security & Privacy", "Identity & Trust"]`).
 
 ---

taxonomy/app.js

@@ -365,6 +365,50 @@ document.addEventListener('DOMContentLoaded', () => {
       card.appendChild(notesDiv);
     }
 
+    if (activeItem.relatedTerms && activeItem.relatedTerms.length > 0) {
+      const relDiv = document.createElement('div');
+      relDiv.className = 'card-aliases';
+
+      const relLabel = document.createElement('span');
+      relLabel.className = 'alias-label';
+      relLabel.textContent = 'Related Concept:';
+      relDiv.appendChild(relLabel);
+
+      activeItem.relatedTerms.forEach(rel => {
+        const badge = document.createElement('span');
+        badge.className = 'alias-badge';
+        badge.style.background = 'rgba(14, 165, 233, 0.15)';
+        badge.style.border = '1px solid rgba(14, 165, 233, 0.3)';
+        badge.style.color = '#38bdf8';
+        appendHighlightedText(badge, rel, query);
+        relDiv.appendChild(badge);
+      });
+
+      card.appendChild(relDiv);
+    }
+
+    if (activeItem.contrastsWith && activeItem.contrastsWith.length > 0) {
+      const conDiv = document.createElement('div');
+      conDiv.className = 'card-aliases';
+
+      const conLabel = document.createElement('span');
+      conLabel.className = 'alias-label';
+      conLabel.textContent = 'Contrasts With:';
+      conDiv.appendChild(conLabel);
+
+      activeItem.contrastsWith.forEach(con => {
+        const badge = document.createElement('span');
+        badge.className = 'alias-badge';
+        badge.style.background = 'rgba(244, 63, 94, 0.15)';
+        badge.style.border = '1px solid rgba(244, 63, 94, 0.3)';
+        badge.style.color = '#fb7185';
+        appendHighlightedText(badge, con, query);
+        conDiv.appendChild(badge);
+      });
+
+      card.appendChild(conDiv);
+    }
+
     const wgDiv = document.createElement('div');
     wgDiv.className = 'card-workgroups';
 
@@ -520,6 +564,50 @@ document.addEventListener('DOMContentLoaded', () => {
         card.appendChild(notesDiv);
       }
 
+      if (item.relatedTerms && item.relatedTerms.length > 0) {
+        const relDiv = document.createElement('div');
+        relDiv.className = 'card-aliases';
+
+        const relLabel = document.createElement('span');
+        relLabel.className = 'alias-label';
+        relLabel.textContent = 'Related Concept:';
+        relDiv.appendChild(relLabel);
+
+        item.relatedTerms.forEach(rel => {
+          const badge = document.createElement('span');
+          badge.className = 'alias-badge';
+          badge.style.background = 'rgba(14, 165, 233, 0.15)';
+          badge.style.border = '1px solid rgba(14, 165, 233, 0.3)';
+          badge.style.color = '#38bdf8';
+          appendHighlightedText(badge, rel, query);
+          relDiv.appendChild(badge);
+        });
+
+        card.appendChild(relDiv);
+      }
+
+      if (item.contrastsWith && item.contrastsWith.length > 0) {
+        const conDiv = document.createElement('div');
+        conDiv.className = 'card-aliases';
+
+        const conLabel = document.createElement('span');
+        conLabel.className = 'alias-label';
+        conLabel.textContent = 'Contrasts With:';
+        conDiv.appendChild(conLabel);
+
+        item.contrastsWith.forEach(con => {
+          const badge = document.createElement('span');
+          badge.className = 'alias-badge';
+          badge.style.background = 'rgba(244, 63, 94, 0.15)';
+          badge.style.border = '1px solid rgba(244, 63, 94, 0.3)';
+          badge.style.color = '#fb7185';
+          appendHighlightedText(badge, con, query);
+          conDiv.appendChild(badge);
+        });
+
+        card.appendChild(conDiv);
+      }
+
       const wgDiv = document.createElement('div');
       wgDiv.className = 'card-workgroups';
 
@@ -803,6 +891,50 @@ document.addEventListener('DOMContentLoaded', () => {
       card.appendChild(notesDiv);
     }
 
+    if (activeItem.relatedTerms && activeItem.relatedTerms.length > 0) {
+      const relDiv = document.createElement('div');
+      relDiv.className = 'card-aliases';
+
+      const relLabel = document.createElement('span');
+      relLabel.className = 'alias-label';
+      relLabel.textContent = 'Related Concept:';
+      relDiv.appendChild(relLabel);
+
+      activeItem.relatedTerms.forEach(rel => {
+        const badge = document.createElement('span');
+        badge.className = 'alias-badge';
+        badge.style.background = 'rgba(14, 165, 233, 0.15)';
+        badge.style.border = '1px solid rgba(14, 165, 233, 0.3)';
+        badge.style.color = '#38bdf8';
+        appendHighlightedText(badge, rel, query);
+        relDiv.appendChild(badge);
+      });
+
+      card.appendChild(relDiv);
+    }
+
+    if (activeItem.contrastsWith && activeItem.contrastsWith.length > 0) {
+      const conDiv = document.createElement('div');
+      conDiv.className = 'card-aliases';
+
+      const conLabel = document.createElement('span');
+      conLabel.className = 'alias-label';
+      conLabel.textContent = 'Contrasts With:';
+      conDiv.appendChild(conLabel);
+
+      activeItem.contrastsWith.forEach(con => {
+        const badge = document.createElement('span');
+        badge.className = 'alias-badge';
+        badge.style.background = 'rgba(244, 63, 94, 0.15)';
+        badge.style.border = '1px solid rgba(244, 63, 94, 0.3)';
+        badge.style.color = '#fb7185';
+        appendHighlightedText(badge, con, query);
+        conDiv.appendChild(badge);
+      });
+
+      card.appendChild(conDiv);
+    }
+
     const wgDiv = document.createElement('div');
     wgDiv.className = 'card-workgroups';