@diagrammo/dgmo 0.32.1 → 0.34.0

package/src/gantt/renderer.ts

@@ -2,6 +2,7 @@
 // Gantt Chart Renderer
 // ============================================================
 
+import { tagAttrKey } from '../utils/tag-groups';
 import * as d3Scale from 'd3-scale';
 import * as d3Selection from 'd3-selection';
 import { FONT_FAMILY } from '../fonts';
@@ -660,7 +661,7 @@ export function renderGantt(
       (tg) => tg.name.toLowerCase() === currentSwimlaneGroup.toLowerCase()
     );
     if (tagGroup) {
-      const tagKey = tagGroup.name.toLowerCase();
+      const tagKey = tagAttrKey(tagGroup.name);
       for (const rt of resolved.tasks) {
         let value = rt.effectiveMetadata[tagKey];
         if (!value && tagGroup.defaultValue) value = tagGroup.defaultValue;
@@ -2091,7 +2092,7 @@ function renderTagLegend(
   const usedValues = new Map<string, Set<string>>();
   if (resolvedTasks) {
     for (const group of visibleGroups) {
-      const key = group.name.toLowerCase();
+      const key = tagAttrKey(group.name);
       const used = new Set<string>();
       for (const rt of resolvedTasks) {
         const val = rt.effectiveMetadata[key];
@@ -2104,7 +2105,7 @@ function renderTagLegend(
   // Filter entries to only those used in the current view
   const filteredEntries = new Map<string, readonly TagEntry[]>();
   for (const group of visibleGroups) {
-    const key = group.name.toLowerCase();
+    const key = tagAttrKey(group.name);
     const used = usedValues.get(key);
     if (used && used.size > 0) {
       filteredEntries.set(
@@ -2133,7 +2134,7 @@ function renderTagLegend(
     let groupW = pillW;
     if (isActive) {
       const entries =
-        filteredEntries.get(group.name.toLowerCase()) ?? group.entries;
+        filteredEntries.get(tagAttrKey(group.name)) ?? group.entries;
       let entriesW = 0;
       for (const entry of entries) {
         entriesW +=
@@ -2215,7 +2216,7 @@ function renderTagLegend(
       }),
       ...(onControlsToggle !== undefined && { onControlsToggle }),
       onEntryHover: (groupName, entryValue) => {
-        const tagKey = groupName.toLowerCase();
+        const tagKey = tagAttrKey(groupName);
         if (entryValue) {
           const ev = entryValue.toLowerCase();
           chartG
@@ -3388,7 +3389,7 @@ export function buildTagLaneRowList(
   );
   if (!tagGroup) return null;
 
-  const tagKey = tagGroup.name.toLowerCase();
+  const tagKey = tagAttrKey(tagGroup.name);
   const rows: Row[] = [];
 
   // Bucket tasks by tag value

package/src/index.ts

@@ -226,11 +226,16 @@ export { normalizeSvgForEmbed, getEmbedSvgViewBox } from './utils/svg-embed';
 // ============================================================
 // Pure + dependency-injected: the caller supplies the `Gazetteer` asset. Safe
 // to export from the main index — no d3-geo/topojson runtime imports.
-export { completeMapPlaces, completeMapRegions } from './map/completion';
+export {
+  completeMapPlaces,
+  completeMapRegions,
+  searchMapLocations,
+} from './map/completion';
 export type {
   MapPlaceCompletion,
   MapRegionCompletion,
   MapCompletionOptions,
+  MapLocationMatch,
 } from './map/completion';
 export type {
   Gazetteer,

package/src/infra/parser.ts

@@ -6,6 +6,7 @@
 // Handles: chart metadata, component blocks with indented properties
 // and connections, [Group] containers, tag groups, pipe metadata.
 
+import { tagAttrKey } from '../utils/tag-groups';
 import {
   descriptionBareRemovedMessage,
   formatDgmoError,
@@ -1054,7 +1055,7 @@ export function parseInfra(content: string): ParsedInfra {
   // Inject default tag values into nodes that don't have one
   for (const tg of result.tagGroups) {
     if (!tg.defaultValue) continue;
-    const key = (tg.alias ?? tg.name).toLowerCase();
+    const key = tagAttrKey(tg.alias ?? tg.name);
     for (const node of result.nodes) {
       if (node.isEdge) continue;
       if (!(key in node.tags)) {

package/src/infra/renderer.ts

@@ -2,6 +2,7 @@
 // Infra Chart SVG Renderer
 // ============================================================
 
+import { tagAttrKey } from '../utils/tag-groups';
 import * as d3Selection from 'd3-selection';
 import * as d3Shape from 'd3-shape';
 import { FONT_FAMILY } from '../fonts';
@@ -1388,7 +1389,7 @@ function resolveActiveTagStroke(
     (t) => t.name.toLowerCase() === activeGroup.toLowerCase()
   );
   if (!tg) return null;
-  const tagKey = (tg.alias ?? tg.name).toLowerCase();
+  const tagKey = tagAttrKey(tg.alias ?? tg.name);
   const tagVal = node.tags[tagKey];
   if (!tagVal) return null;
   const tv = tg.values.find(
@@ -2073,7 +2074,7 @@ export function computeInfraLegendGroups(
     groups.push({
       name: tg.name,
       type: 'tag',
-      tagKey: (tg.alias ?? tg.name).toLowerCase(),
+      tagKey: tagAttrKey(tg.alias ?? tg.name),
       entries,
       width: LEGEND_CAPSULE_PAD * 2 + pillWidth + 4 + entriesWidth,
       minifiedWidth: pillWidth,
@@ -2146,7 +2147,7 @@ function renderLegend(
   // Add infra-specific classes and data attributes for app interactivity
   legendG.selectAll('[data-legend-group]').classed('infra-legend-group', true);
   for (const group of legendGroups) {
-    const groupKey = group.name.toLowerCase();
+    const groupKey = tagAttrKey(group.name);
     for (const entry of group.entries) {
       const entryEl = legendG.select(
         `[data-legend-group="${groupKey}"] [data-legend-entry="${entry.value.toLowerCase()}"]`

package/src/journey-map/parser.ts

@@ -14,7 +14,11 @@ import {
   JOURNEY_MAP_REGISTRY,
   withTagAliases,
 } from '../utils/reserved-key-registry';
-import { splitNameAndMeta, warnUnknownMetaKeys } from '../utils/parsing';
+import {
+  splitNameAndMeta,
+  warnUnknownMetaKeys,
+  peelTrailingColorName,
+} from '../utils/parsing';
 import {
   matchTagBlockHeading,
   emitTagLegacyDiagnostic,
@@ -22,6 +26,7 @@ import {
   validateTagGroupNames,
   finalizeAutoTagColors,
   AUTO_TAG_COLOR_SENTINEL,
+  tagAttrKey,
 } from '../utils/tag-groups';
 import {
   measureIndent,
@@ -180,8 +185,10 @@ export function parseJourneyMap(
             }
           }
         } else {
-          // Same-line form (pipes removed in 0.18.0): peel a trailing
-          // `color: <token>` off the rest-of-line persona name.
+          // Same-line form (pipes removed in 0.18.0). Two ways to set color:
+          //   1. explicit `persona <name> color: <token>` (long form)
+          //   2. universal §1.5 trailing-token color (`persona <name> green`);
+          //      capitalize the word (`Green`) to keep it as literal name text.
           const colorMatch = afterKeyword.match(/^(.+?)\s+color:\s*(\S+)$/i);
           if (colorMatch) {
             personaName = colorMatch[1]!.trim();
@@ -193,7 +200,19 @@ export function parseJourneyMap(
                 palette
               ) ?? undefined;
           } else {
-            personaName = afterKeyword;
+            const { label, colorName } = peelTrailingColorName(afterKeyword);
+            if (colorName) {
+              personaName = label;
+              personaColor =
+                resolveColorWithDiagnostic(
+                  colorName,
+                  lineNumber,
+                  result.diagnostics,
+                  palette
+                ) ?? undefined;
+            } else {
+              personaName = afterKeyword;
+            }
           }
         }
 
@@ -246,12 +265,12 @@ export function parseJourneyMap(
         if (tagBlockMatch.alias) {
           aliasMap.set(
             tagBlockMatch.alias.toLowerCase(),
-            tagBlockMatch.name.toLowerCase()
+            tagAttrKey(tagBlockMatch.name)
           );
         }
         aliasMap.set(
-          tagBlockMatch.name.toLowerCase(),
-          tagBlockMatch.name.toLowerCase()
+          tagAttrKey(tagBlockMatch.name),
+          tagAttrKey(tagBlockMatch.name)
         );
         result.tagGroups.push(currentTagGroup);
         continue;
@@ -445,7 +464,7 @@ export function parseJourneyMap(
   // Build tag value sets
   for (const group of result.tagGroups) {
     const values = new Set(group.entries.map((e) => e.value.toLowerCase()));
-    tagValueSets.set(group.name.toLowerCase(), values);
+    tagValueSets.set(tagAttrKey(group.name), values);
   }
 
   // Validate tag values on all steps

package/src/journey-map/renderer.ts

@@ -1,3 +1,4 @@
+import { tagAttrKey } from '../utils/tag-groups';
 import * as d3 from 'd3-selection';
 import * as d3Shape from 'd3-shape';
 import type { PaletteColors } from '../palettes';
@@ -18,6 +19,7 @@ import type {
   JourneyMapStep,
 } from './types';
 import { renderInlineText } from '../utils/inline-markdown';
+import { wrapNoteBody, NOTE_BULLET_INDENT } from '../utils/note-box';
 import { renderIntegratedLegend } from '../utils/legend-integration';
 import { resolveActiveTagGroup } from '../utils/tag-groups';
 import { ScaleContext } from '../utils/scaling';
@@ -194,9 +196,10 @@ export function renderJourneyMap(
     const textAreaWidth = panelWidth - silhouetteZone - CARD_PADDING_X;
     const descLineH = 14;
 
-    // Wrap description text into lines
+    // Wrap description text into lines — bullet-aware (`- `/`* ` → hanging
+    // "•") + inline markdown, matching how note boxes render rich bodies.
     const descLines = parsed.persona.description
-      ? wrapText(parsed.persona.description, textAreaWidth, FONT_SIZE_META)
+      ? wrapNoteBody(parsed.persona.description, textAreaWidth, FONT_SIZE_META)
       : [];
     const descRowH =
       descLines.length > 0 ? descLines.length * descLineH + 8 : 0;
@@ -276,16 +279,30 @@ export function renderJourneyMap(
       .attr('fill', onPersonaText)
       .text(parsed.persona.name);
 
-    // Description — wrapped lines below divider, with inline markdown
+    // Description — wrapped lines below divider, with inline markdown.
+    // Bullet first-lines get a "•" glyph at the left edge with the body
+    // hanging-indented; continuation lines align under the body.
     for (let li = 0; li < descLines.length; li++) {
+      // In-bounds by loop guard.
+      const line = descLines[li]!;
+      const indent = line.kind === 'plain' ? 0 : NOTE_BULLET_INDENT;
+      const lineY = panelY + titleRowH + descLineH * (li + 1);
+      if (line.kind === 'bullet-first') {
+        personaG
+          .append('text')
+          .attr('x', textX)
+          .attr('y', lineY)
+          .attr('font-size', FONT_SIZE_META)
+          .attr('fill', onPersonaText)
+          .text('•');
+      }
       const lineEl = personaG
         .append('text')
-        .attr('x', textX)
-        .attr('y', panelY + titleRowH + descLineH * (li + 1))
+        .attr('x', textX + indent)
+        .attr('y', lineY)
         .attr('font-size', FONT_SIZE_META)
         .attr('fill', onPersonaText);
-      // In-bounds by loop guard.
-      renderInlineText(lineEl, descLines[li]!, palette, FONT_SIZE_META);
+      renderInlineText(lineEl, line.text, palette, FONT_SIZE_META);
     }
 
     if (onNavigateToLine) {
@@ -346,7 +363,7 @@ export function renderJourneyMap(
               const isScore = groupName === 'Score';
               const attrName = isScore
                 ? 'data-score'
-                : `data-tag-${groupName.toLowerCase()}`;
+                : `data-tag-${tagAttrKey(groupName)}`;
 
               const matches = (el: Element) =>
                 el.getAttribute(attrName) === entryValue;
@@ -1094,7 +1111,7 @@ function resolveStepColor(
   );
   if (!group) return undefined;
 
-  const tagValue = step.tags[group.name.toLowerCase()];
+  const tagValue = step.tags[tagAttrKey(group.name)];
   if (!tagValue) return undefined;
 
   const entry = group.entries.find(

package/src/kanban/parser.ts

@@ -19,6 +19,7 @@ import {
   validateTagGroupNames,
   finalizeAutoTagColors,
   AUTO_TAG_COLOR_SENTINEL,
+  tagAttrKey,
 } from '../utils/tag-groups';
 import {
   measureIndent,
@@ -168,14 +169,14 @@ export function parseKanban(
         if (tagBlockMatch.alias) {
           metaAliasMap.set(
             normalizeName(tagBlockMatch.alias),
-            tagBlockMatch.name.toLowerCase()
+            tagAttrKey(tagBlockMatch.name)
           );
         }
         // §1.4 dispatch: register the canonical tag name so `priority: X`
         // also dispatches as metadata (not just the optional `p: X` alias).
         metaAliasMap.set(
           normalizeName(tagBlockMatch.name),
-          tagBlockMatch.name.toLowerCase()
+          tagAttrKey(tagBlockMatch.name)
         );
         result.tagGroups.push(currentTagGroup);
         continue;
@@ -419,7 +420,7 @@ export function parseKanban(
   // Build tag value sets for validation
   for (const group of result.tagGroups) {
     const values = new Set(group.entries.map((e) => e.value.toLowerCase()));
-    tagValueSets.set(group.name.toLowerCase(), values);
+    tagValueSets.set(tagAttrKey(group.name), values);
   }
 
   // Validate WIP limits

package/src/kanban/renderer.ts

@@ -2,6 +2,7 @@
 // Kanban Board SVG Renderer
 // ============================================================
 
+import { tagAttrKey } from '../utils/tag-groups';
 import * as d3Selection from 'd3-selection';
 import { FONT_FAMILY } from '../fonts';
 import type { PaletteColors } from '../palettes';
@@ -82,7 +83,7 @@ function resolveCardTagMeta(
   const meta: { label: string; value: string; color?: string }[] = [];
   for (const group of tagGroups) {
     if (hiddenMetaGroups?.includes(group.name.toLowerCase())) continue;
-    const tagValue = card.tags[group.name.toLowerCase()];
+    const tagValue = card.tags[tagAttrKey(group.name)];
     const value = tagValue ?? group.defaultValue;
     if (!value) continue;
     const entry = group.entries.find(
@@ -107,7 +108,7 @@ function resolveCardTagColor(
     (g) => g.name.toLowerCase() === activeTagGroup.toLowerCase()
   );
   if (!group) return card.color;
-  const tagValue = card.tags[group.name.toLowerCase()];
+  const tagValue = card.tags[tagAttrKey(group.name)];
   const value = tagValue ?? group.defaultValue;
   if (!value) return undefined;
   const entry = group.entries.find(
@@ -639,7 +640,7 @@ export function renderKanban(
         .attr('data-line-number', card.lineNumber);
 
       if (activeTagGroup) {
-        const tagKey = activeTagGroup.toLowerCase();
+        const tagKey = tagAttrKey(activeTagGroup);
         const tagValue = card.tags[tagKey];
         const group = parsed.tagGroups.find(
           (tg) => tg.name.toLowerCase() === tagKey
@@ -806,7 +807,7 @@ function bucketCardsBySwimlane(
   columns: KanbanColumn[],
   swimlaneGroup: KanbanTagGroup
 ): SwimlaneBucket[] {
-  const tagKey = swimlaneGroup.name.toLowerCase();
+  const tagKey = tagAttrKey(swimlaneGroup.name);
   const buckets = new Map<string, SwimlaneBucket>();
 
   // Seed lanes from declaration order
@@ -1369,7 +1370,7 @@ function renderSwimlaneCard(
     .attr('data-line-number', card.lineNumber);
 
   if (activeTagGroup) {
-    const tagKey = activeTagGroup.toLowerCase();
+    const tagKey = tagAttrKey(activeTagGroup);
     const group = tagGroups.find((tg) => tg.name.toLowerCase() === tagKey);
     const value = card.tags[tagKey] ?? group?.defaultValue;
     if (value) {

package/src/map/completion.ts

@@ -151,6 +151,122 @@ export function completeMapPlaces(
   return [...cityItems, ...airportItems].slice(0, limit);
 }
 
+/** A POI search hit — a city or airport the resolver can resolve, with the
+ *  exact `token` to paste into DGMO (a `poi`/route endpoint). Powers the CLI
+ *  `dgmo map search` command and the MCP `lookup_map_location` tool, so authors
+ *  (and AI agents) can DISCOVER valid place tokens instead of guessing — e.g.
+ *  learn that "New York" must be `New York City` and that `JFK` is bundled. */
+export interface MapLocationMatch {
+  /** Canonical display name (cities) or full airport name. */
+  readonly name: string;
+  /** Exact text to use in DGMO. Cities: the name, ISO-qualified when ambiguous
+   *  (`Portland US-OR`). Airports: the upper-case IATA code (`JFK`). */
+  readonly token: string;
+  readonly kind: 'city' | 'airport';
+  readonly iso: string;
+  readonly sub?: string;
+  /** City population (0 for airports). */
+  readonly pop: number;
+  /** Human detail, e.g. `US-OR · 652,503` or `Airport · John F Kennedy Intl`. */
+  readonly detail: string;
+}
+
+/**
+ * Substring-search cities + airports for a discovery surface (CLI / MCP), so an
+ * author can find the exact token the resolver expects. Unlike
+ * {@link completeMapPlaces} (prefix-only, editor type-ahead), this matches
+ * anywhere in a city name OR an airport code/name, so "york" finds
+ * `New York City` and "kennedy" finds `JFK`.
+ *
+ * Ranking: exact-name (or exact-IATA) → prefix → substring; within a tier,
+ * cities by population desc (deterministic index tie-break), cities before
+ * airports. Pure + deterministic. Empty query → `[]`.
+ */
+export function searchMapLocations(
+  query: string,
+  gazetteer: Gazetteer,
+  opts?: { readonly limit?: number; readonly airports?: AirportData }
+): MapLocationMatch[] {
+  const q = fold(query);
+  if (!q) return [];
+  const limit = opts?.limit ?? 20;
+
+  // rank: 0 exact, 1 prefix, 2 substring; -1 = no match.
+  const rankOf = (hay: string): number =>
+    hay === q ? 0 : hay.startsWith(q) ? 1 : hay.includes(q) ? 2 : -1;
+
+  // Cities — match on folded display name (via byName keys) + aliases.
+  const cityRank = new Map<number, number>(); // city index → best rank
+  const consider = (idx: number, rank: number): void => {
+    if (rank < 0) return;
+    const prev = cityRank.get(idx);
+    if (prev === undefined || rank < prev) cityRank.set(idx, rank);
+  };
+  for (const [key, list] of Object.entries(gazetteer.byName)) {
+    const r = rankOf(key);
+    if (r >= 0) for (const i of list) consider(i, r);
+  }
+  for (const [key, idx] of Object.entries(gazetteer.alt)) {
+    consider(idx, rankOf(key));
+  }
+
+  const cityItems: Array<MapLocationMatch & { _rank: number }> = [...cityRank]
+    .filter(([i]) => gazetteer.cities[i] !== undefined)
+    .map(([i, rank]) => {
+      const c = gazetteer.cities[i]!;
+      const [, , iso, pop, name, sub] = c;
+      const ambiguous = (gazetteer.byName[fold(name)]?.length ?? 0) > 1;
+      const qualifier = sub ?? iso;
+      return {
+        name,
+        token: ambiguous ? `${name} ${qualifier}` : name,
+        kind: 'city' as const,
+        iso,
+        ...(sub !== undefined && { sub }),
+        pop,
+        detail: `${qualifier} · ${groupThousands(pop)}`,
+        _rank: rank,
+      };
+    });
+
+  // Airports — match on folded IATA code OR folded airport name.
+  const airports = opts?.airports;
+  const airportItems: Array<MapLocationMatch & { _rank: number }> = [];
+  if (airports?.airportIata) {
+    for (const [code, idx] of Object.entries(airports.airportIata)) {
+      const a = airports.airports[idx];
+      if (!a) continue;
+      const codeRank = rankOf(code);
+      const nameRank = rankOf(fold(a[4]));
+      const rank = Math.min(
+        codeRank < 0 ? 99 : codeRank,
+        nameRank < 0 ? 99 : nameRank
+      );
+      if (rank > 2) continue;
+      airportItems.push({
+        name: a[4],
+        token: code.toUpperCase(),
+        kind: 'airport',
+        iso: a[2],
+        pop: 0,
+        detail: `Airport · ${a[4]}`,
+        _rank: rank,
+      });
+    }
+  }
+
+  return [...cityItems, ...airportItems]
+    .sort(
+      (x, y) =>
+        x._rank - y._rank || // best match tier first
+        (x.kind === y.kind ? 0 : x.kind === 'city' ? -1 : 1) || // city before airport
+        y.pop - x.pop || // populous city first
+        (x.token < y.token ? -1 : x.token > y.token ? 1 : 0)
+    )
+    .slice(0, limit)
+    .map(({ _rank, ...rest }) => rest);
+}
+
 export interface MapRegionCompletion {
   /** Display name = insert text (the resolver disambiguates cross-layer
    *  collisions like Georgia by map scope, §24B.8). */

package/src/map/layout.ts

@@ -5,6 +5,7 @@
 // POI radii + edge widths, and places labels with per-cluster collision
 // escalation. The SVG emission is renderer.ts (it only draws what we compute).
 // See spec section 24B.3-.7/.11 + the tech-spec Adversarial Review Resolutions AR1-AR9.
+import { tagAttrKey } from '../utils/tag-groups';
 import {
   geoPath,
   geoNaturalEarth1,
@@ -1582,7 +1583,7 @@ export function layoutMap(
       (g) => g.name.toLowerCase() === groupName.toLowerCase()
     );
     if (!group) return null;
-    const val = tags[group.name.toLowerCase()] ?? group.defaultValue;
+    const val = tags[tagAttrKey(group.name)] ?? group.defaultValue;
     if (!val) return null;
     const entry = group.entries.find(
       (e) => e.value.toLowerCase() === val.toLowerCase()
@@ -2656,7 +2657,7 @@ export function layoutMap(
     if (directHex)
       return { fill: directHex, stroke: mix(directHex, palette.text, 18) };
     for (const group of resolved.tagGroups) {
-      const val = p.tags[group.name.toLowerCase()];
+      const val = p.tags[tagAttrKey(group.name)];
       if (!val) continue;
       const entry = group.entries.find(
         (e) => e.value.toLowerCase() === val.toLowerCase()
@@ -2678,7 +2679,7 @@ export function layoutMap(
   // or null → caller falls back to the neutral connector mix.
   const lineColor = (tags: Readonly<Record<string, string>>): string | null => {
     for (const group of resolved.tagGroups) {
-      const val = tags[group.name.toLowerCase()];
+      const val = tags[tagAttrKey(group.name)];
       if (!val) continue;
       const entry = group.entries.find(
         (e) => e.value.toLowerCase() === val.toLowerCase()

package/src/map/parser.ts

@@ -25,6 +25,7 @@ import {
   validateTagGroupNames,
   finalizeAutoTagColors,
   AUTO_TAG_COLOR_SENTINEL,
+  tagAttrKey,
 } from '../utils/tag-groups';
 import { parseInArrowLabel } from '../utils/arrows';
 import type {
@@ -157,7 +158,7 @@ export function parseMap(content: string, palette?: PaletteColors): ParsedMap {
   // Declared tag-group names (lowercased) — the keys `partitionMeta` treats as
   // tag values (resolved from aliases). Recomputed as groups are declared.
   const tagGroupNames = (): ReadonlySet<string> =>
-    new Set(tagGroups.map((g) => g.name.toLowerCase()));
+    new Set(tagGroups.map((g) => tagAttrKey(g.name)));
 
   const closeBlocks = (): void => {
     open.tag = null;
@@ -378,7 +379,7 @@ export function parseMap(content: string, palette?: PaletteColors): ParsedMap {
       entries: [],
       lineNumber: line,
     };
-    if (m.alias) aliasMap.set(m.alias.toLowerCase(), m.name.toLowerCase());
+    if (m.alias) aliasMap.set(m.alias.toLowerCase(), tagAttrKey(m.name));
     tagGroups.push(group);
     open.tag = group;
     // Inline form: `tag Market as m HQ indigo, Region teal` (R4).

package/src/mindmap/parser.ts

@@ -19,6 +19,7 @@ import {
   finalizeAutoTagColors,
   cascadeTagMetadata,
   AUTO_TAG_COLOR_SENTINEL,
+  tagAttrKey,
 } from '../utils/tag-groups';
 import {
   measureIndent,
@@ -167,12 +168,12 @@ export function parseMindmap(
       if (tagBlockMatch.alias) {
         aliasMap.set(
           tagBlockMatch.alias.toLowerCase(),
-          tagBlockMatch.name.toLowerCase()
+          tagAttrKey(tagBlockMatch.name)
         );
       }
       aliasMap.set(
-        tagBlockMatch.name.toLowerCase(),
-        tagBlockMatch.name.toLowerCase()
+        tagAttrKey(tagBlockMatch.name),
+        tagAttrKey(tagBlockMatch.name)
       );
       result.tagGroups.push(currentTagGroup);
       continue;

package/src/mindmap/renderer.ts

@@ -2,6 +2,7 @@
 // Mindmap SVG Renderer
 // ============================================================
 
+import { tagAttrKey } from '../utils/tag-groups';
 import * as d3Selection from 'd3-selection';
 import { FONT_FAMILY } from '../fonts';
 import {
@@ -389,7 +390,7 @@ export function renderMindmap(
 
     // Expose active tag group value for legend-entry hover dimming
     if (activeTagGroup) {
-      const tagKey = activeTagGroup.toLowerCase();
+      const tagKey = tagAttrKey(activeTagGroup);
       const metaValue = node.metadata[tagKey];
       if (metaValue) {
         nodeG.attr(`data-tag-${tagKey}`, metaValue.toLowerCase());

package/src/org/layout.ts

@@ -2,6 +2,7 @@
 // Org Chart Tree Layout Engine (d3-hierarchy)
 // ============================================================
 
+import { tagAttrKey } from '../utils/tag-groups';
 import { hierarchy, tree } from 'd3-hierarchy';
 import type { ParsedOrg, OrgNode } from './parser';
 import type { Writable } from '../utils/brand';
@@ -303,7 +304,7 @@ function computeLegendGroups(
     if (group.entries.length === 0) continue;
 
     // Filter entries to only values actually used by nodes (if provided)
-    const usedValues = usedValuesByGroup?.get(group.name.toLowerCase());
+    const usedValues = usedValuesByGroup?.get(tagAttrKey(group.name));
     const visibleEntries = usedValues
       ? group.entries.filter((e) => usedValues.has(e.value.toLowerCase()))
       : group.entries;
@@ -1185,7 +1186,7 @@ export function layoutOrg(
   // Collect which tag group values are actually used by nodes
   const usedValuesByGroup = new Map<string, Set<string>>();
   for (const group of parsed.tagGroups) {
-    const key = group.name.toLowerCase();
+    const key = tagAttrKey(group.name);
     const used = new Set<string>();
     const walk = (node: OrgNode) => {
       if (!node.isContainer && node.metadata[key]) {

package/src/org/parser.ts

@@ -20,6 +20,7 @@ import {
   stripDefaultModifier,
   finalizeAutoTagColors,
   AUTO_TAG_COLOR_SENTINEL,
+  tagAttrKey,
 } from '../utils/tag-groups';
 import {
   measureIndent,
@@ -219,14 +220,14 @@ export function parseOrg(content: string, palette?: PaletteColors): ParsedOrg {
       if (tagBlockMatch.alias) {
         metaAliasMap.set(
           normalizeName(tagBlockMatch.alias),
-          tagBlockMatch.name.toLowerCase()
+          tagAttrKey(tagBlockMatch.name)
         );
       }
       // §1.4 dispatch: register canonical name so `<name>:` triggers
       // the metadata cut even without an explicit `as <alias>`.
       metaAliasMap.set(
         normalizeName(tagBlockMatch.name),
-        tagBlockMatch.name.toLowerCase()
+        tagAttrKey(tagBlockMatch.name)
       );
       result.tagGroups.push(currentTagGroup);
       continue;