hoi4-agent-tools 2.5.2 → 2.5.3

package/CHANGELOG.md

@@ -4,6 +4,13 @@
 
 No unreleased changes.
 
+## 2.5.3 - 2026-08-22
+
+- Resolved and embedded technology icons through the complete mod, dependency, and installed-game load order, including vanilla sprites used by mod content.
+- Recognized vanilla `SpriteType` capitalization consistently in the shared index and GUI source graph.
+- Decoded uncompressed vanilla DDS textures whose header stores total linear size instead of row pitch.
+- Added deterministic cross-root focus, scripted-GUI, and technology regressions plus an opt-in installed-game DDS render test.
+
 ## 2.5.2 - 2026-08-15
 
 - Distinguished HOI4 small and large technology layouts in graph data and source-positioned folder renders, including exact 72×72 small items selected by `force_use_small_tech_layout`.

package/dist/hoi4_agent_tools/core/index.js

@@ -2,6 +2,22 @@ import { compareCodeUnits } from './canonical.js';
 import path from 'node:path';
 import { sortDiagnostics } from './diagnostics.js';
 import { parseClausewitz, parseLocalisation, assignments, childBlocks, firstScalar, locationFor, sourcePartialLimitDiagnostics, SOURCE_MAX_BYTES, SOURCE_MAX_NESTING, nodeLocation, } from './source/index.js';
+const spriteDefinitionKeys = new Set([
+    'spritetype',
+    'textspritetype',
+    'frameanimatedspritetype',
+    'corneredtilespritetype',
+    'maskedshieldtype',
+]);
+function firstScalarInsensitiveNode(block, ...keys) {
+    const normalizedKeys = new Set(keys.map((key) => key.toLowerCase()));
+    for (const assignment of assignments(block)) {
+        if (assignment.value.type === 'scalar' &&
+            normalizedKeys.has(assignment.key.value.toLowerCase()))
+            return assignment.value;
+    }
+    return undefined;
+}
 const guiElementKeys = new Set([
     'containerWindowType',
     'windowType',
@@ -992,10 +1008,11 @@ export class SymbolIndex {
                     metadata: {},
                 });
             }
-            else if ((key === 'spriteType' || key === 'frameAnimatedSpriteType') &&
-                firstScalar(child, 'name') !== undefined) {
-                const name = firstScalar(child, 'name');
-                const texture = firstScalar(child, 'texturefile');
+            else if (sourcePath.endsWith('.gfx') &&
+                spriteDefinitionKeys.has(key.toLowerCase()) &&
+                firstScalarInsensitiveNode(child, 'name') !== undefined) {
+                const name = firstScalarInsensitiveNode(child, 'name');
+                const texture = firstScalarInsensitiveNode(child, 'texturefile', 'textureFile');
                 this.addSymbol({
                     kind: 'sprite',
                     id: name.value,
@@ -1006,8 +1023,7 @@ export class SymbolIndex {
                     metadata: {
                         spriteType: key,
                         texture: texture?.value,
-                        frames: numeric(firstScalar(child, 'noOfFrames')?.value) ??
-                            numeric(firstScalar(child, 'noofframes')?.value),
+                        frames: numeric(firstScalarInsensitiveNode(child, 'noOfFrames', 'noofframes')?.value),
                     },
                 });
                 if (texture !== undefined)

package/dist/hoi4_agent_tools/focus/compact.js

@@ -90,6 +90,51 @@ function compactStructuralAnchorX(plan, focus, parents, preferredX, laneBases) {
     }
     return laneBases.get(focusLaneId(plan, focus)) ?? 0;
 }
+function structuralRows(plan) {
+    const focusIds = new Set(plan.focuses.map(({ id }) => id));
+    const parentsByFocus = new Map(plan.focuses.map((focus) => [
+        focus.id,
+        [...new Set(prerequisiteIds(plan, focus.id).filter((parentId) => focusIds.has(parentId)))],
+    ]));
+    const childrenByFocus = new Map();
+    const unresolvedParents = new Map();
+    for (const focus of plan.focuses) {
+        const parents = parentsByFocus.get(focus.id) ?? [];
+        unresolvedParents.set(focus.id, parents.length);
+        for (const parentId of parents) {
+            const children = childrenByFocus.get(parentId) ?? [];
+            children.push(focus.id);
+            childrenByFocus.set(parentId, children);
+        }
+    }
+    for (const children of childrenByFocus.values())
+        children.sort((left, right) => compareCodeUnits(left, right));
+    const rows = new Map();
+    const pending = [...plan.focuses]
+        .map(({ id }) => id)
+        .filter((focusId) => (unresolvedParents.get(focusId) ?? 0) === 0)
+        .sort((left, right) => compareCodeUnits(right, left));
+    for (const focusId of pending)
+        rows.set(focusId, 0);
+    let visited = 0;
+    while (pending.length > 0) {
+        const focusId = pending.pop();
+        if (focusId === undefined)
+            continue;
+        visited += 1;
+        const nextRow = (rows.get(focusId) ?? 0) + 1;
+        for (const childId of childrenByFocus.get(focusId) ?? []) {
+            rows.set(childId, Math.max(rows.get(childId) ?? 0, nextRow));
+            const remaining = (unresolvedParents.get(childId) ?? 0) - 1;
+            unresolvedParents.set(childId, remaining);
+            if (remaining === 0)
+                pending.push(childId);
+        }
+    }
+    // The layout engine reports dependency cycles. Keep authored row preferences
+    // for a cyclic graph instead of inventing a partial topological reflow.
+    return visited === plan.focuses.length ? rows : undefined;
+}
 function mirrorSiblingCohorts(plan, preferredX, preferredY) {
     const cohorts = new Map();
     const laneBases = compactLaneBases(plan);
@@ -182,7 +227,7 @@ function straightenLinearChains(plan, preferredX, preferredY) {
     }
 }
 function compactCandidate(plan, layout, strategy) {
-    const { scale, compressRows, mirrorSiblings, straightenChains } = strategy;
+    const { scale, compressRows, structuralRows: useStructuralRows, mirrorSiblings, straightenChains, } = strategy;
     const minimumX = Math.min(...layout.nodes.map(({ x }) => x));
     const maximumX = Math.max(...layout.nodes.map(({ x }) => x));
     const minimumY = Math.min(...layout.nodes.map(({ y }) => y));
@@ -194,11 +239,19 @@ function compactCandidate(plan, layout, strategy) {
         node.id,
         compressRows ? (compactRows.get(node.y) ?? node.y - minimumY) : node.y - minimumY,
     ]));
+    if (useStructuralRows) {
+        const normalizedRows = structuralRows(plan);
+        if (normalizedRows !== undefined) {
+            for (const [focusId, row] of normalizedRows)
+                preferredY.set(focusId, row);
+        }
+    }
     const rows = new Map();
     for (const node of layout.nodes) {
-        const row = rows.get(node.y) ?? [];
+        const y = preferredY.get(node.id) ?? node.y;
+        const row = rows.get(y) ?? [];
         row.push(node);
-        rows.set(node.y, row);
+        rows.set(y, row);
     }
     for (const row of rows.values()) {
         row.sort((left, right) => left.x - right.x || compareCodeUnits(left.id, right.id));
@@ -249,12 +302,12 @@ function compactScore(layout) {
         metrics.symmetry.offAnchorSiblingCohortCount,
         metrics.symmetry.totalSiblingDeviation,
         metrics.symmetry.totalSiblingAnchorDeviation,
-        metrics.bounds.rowCount,
-        metrics.bounds.columnCount,
         metrics.connectors.maximumHorizontalSpan,
-        metrics.connectors.totalHorizontalSpan,
         metrics.connectors.maximumManhattanSpan,
+        metrics.connectors.totalHorizontalSpan,
         metrics.connectors.totalVerticalSpan,
+        metrics.bounds.rowCount,
+        metrics.bounds.columnCount,
         layout.layoutHash,
     ];
 }
@@ -281,14 +334,50 @@ function compactScales(focusCount) {
 }
 function compactStrategies(focusCount) {
     const preservationStrategies = [
-        { scale: 1, compressRows: false, mirrorSiblings: false, straightenChains: false },
-        { scale: 1, compressRows: true, mirrorSiblings: false, straightenChains: false },
-        { scale: 1, compressRows: false, mirrorSiblings: false, straightenChains: true },
-        { scale: 1, compressRows: false, mirrorSiblings: true, straightenChains: false },
+        {
+            scale: 1,
+            compressRows: false,
+            structuralRows: false,
+            mirrorSiblings: false,
+            straightenChains: false,
+        },
+        {
+            scale: 1,
+            compressRows: true,
+            structuralRows: false,
+            mirrorSiblings: false,
+            straightenChains: false,
+        },
+        {
+            scale: 1,
+            compressRows: false,
+            structuralRows: false,
+            mirrorSiblings: false,
+            straightenChains: true,
+        },
+        {
+            scale: 1,
+            compressRows: false,
+            structuralRows: false,
+            mirrorSiblings: true,
+            straightenChains: false,
+        },
     ];
     const compactStrategies = compactScales(focusCount).flatMap((scale) => [
-        { scale, compressRows: false, mirrorSiblings: true, straightenChains: true },
-        { scale, compressRows: true, mirrorSiblings: true, straightenChains: true },
+        {
+            scale,
+            compressRows: false,
+            structuralRows: false,
+            mirrorSiblings: true,
+            straightenChains: true,
+        },
+        {
+            scale,
+            compressRows: false,
+            structuralRows: true,
+            mirrorSiblings: true,
+            straightenChains: true,
+        },
     ]);
     return [...preservationStrategies, ...compactStrategies];
 }
@@ -307,6 +396,7 @@ export function compactFocusTreePlan(plan) {
         ? compactCandidate(plan, currentLayout, {
             scale: 1,
             compressRows: false,
+            structuralRows: false,
             mirrorSiblings: false,
             straightenChains: false,
         })
@@ -358,6 +448,7 @@ export async function compactFocusTreePlanAsync(plan, options = {}) {
         ? compactCandidate(plan, currentLayout, {
             scale: 1,
             compressRows: false,
+            structuralRows: false,
             mirrorSiblings: false,
             straightenChains: false,
         })

package/dist/hoi4_agent_tools/focus/continuous-render.js

@@ -42,7 +42,7 @@ export async function renderContinuousFocusPalette(plan, diagnostics, options =
     const rows = Math.max(1, Math.ceil(plan.focuses.length / columns));
     const usedColumns = Math.max(1, Math.min(columns, plan.focuses.length));
     const width = padding * 2 + usedColumns * cardWidth + Math.max(0, usedColumns - 1) * gap;
-    const height = padding * 2 + 84 + rows * cardHeight + Math.max(0, rows - 1) * gap;
+    const height = padding * 2 + 52 + rows * cardHeight + Math.max(0, rows - 1) * gap;
     if (options.rasterize !== false) {
         budget.reserve(width, height, 'continuous focus palette PNG');
     }
@@ -61,7 +61,7 @@ export async function renderContinuousFocusPalette(plan, diagnostics, options =
         const column = index % columns;
         const row = Math.floor(index / columns);
         const x = padding + column * (cardWidth + gap);
-        const y = padding + 84 + row * (cardHeight + gap);
+        const y = padding + 52 + row * (cardHeight + gap);
         const entry = options.presentation?.entries[focus.id];
         const iconSprite = focus.icons[0]?.sprite;
         const icon = iconSprite === undefined ? undefined : options.presentation?.icons[iconSprite];
@@ -80,13 +80,7 @@ export async function renderContinuousFocusPalette(plan, diagnostics, options =
         weight: 700,
         fill: '#f3f6f8',
     });
-    const notice = toolText.render('OFFLINE SOURCE MODEL \u00b7 NOT HOI4', {
-        x: padding,
-        y: padding + 27,
-        fontSize: 12,
-        fill: '#d7b65b',
-    });
-    const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}"><title>${escapeXml(plan.id)} continuous focus palette</title><desc>Offline source-derived continuous focus palette; not an in-game screenshot.</desc><defs>${toolText.definitions()}</defs><rect width="${width}" height="${height}" fill="#101820"/>${heading}${notice}${cards.join('')}</svg>`;
+    const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}"><title>${escapeXml(plan.id)} continuous focus palette</title><desc>${plan.focuses.length} continuous focuses.</desc><defs>${toolText.definitions()}</defs><rect width="${width}" height="${height}" fill="#101820"/>${heading}${cards.join('')}</svg>`;
     const compiled = compileContinuousFocusPaletteWithSourceMap(plan);
     const json = `${canonicalJson({
         schemaVersion: 1,
@@ -122,7 +116,7 @@ export async function renderContinuousFocusPalette(plan, diagnostics, options =
         },
         renderProfile: options.renderProfile ?? {},
     })}\n`;
-    const html = `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width"><title>${escapeXml(plan.id)} continuous focus palette</title><style>html{background:#101820;color:#f3f6f8;font:14px system-ui}body{margin:0;padding:24px}.notice{color:#d7b65b}svg{max-width:100%;height:auto;border:1px solid #385064}pre{white-space:pre-wrap}</style></head><body><h1>${escapeXml(plan.id)}</h1><p class="notice">Offline source-derived review artifact &mdash; not an in-game screenshot or editor.</p>${svg}<details><summary>Structured source model</summary><pre>${escapeXml(json)}</pre></details></body></html>`;
+    const html = `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width"><title>${escapeXml(plan.id)} continuous focus palette</title><style>html{background:#101820;color:#f3f6f8;font:14px system-ui}body{margin:0;padding:24px}svg{max-width:100%;height:auto;border:1px solid #385064}pre{white-space:pre-wrap}</style></head><body><h1>${escapeXml(plan.id)}</h1>${svg}<details><summary>Structured source model</summary><pre>${escapeXml(json)}</pre></details></body></html>`;
     options.signal?.throwIfAborted();
     let png = Buffer.alloc(0);
     if (options.rasterize !== false) {

package/dist/hoi4_agent_tools/focus/layout.js

@@ -1529,6 +1529,7 @@ function siblingBatchConflicts(context, cohort, override) {
 }
 function* refineSiblingCohorts(context, edges, initial) {
     let current = initial;
+    let evaluatedEdges = edges;
     for (let pass = 0; pass < 2; pass += 1) {
         let accepted = false;
         for (const [cohortIndex, cohort] of context.siblingCohorts.entries()) {
@@ -1558,7 +1559,7 @@ function* refineSiblingCohorts(context, edges, initial) {
                     continue;
                 if (siblingBatchConflicts(context, cohortIds, override))
                     continue;
-                const candidateEdges = edgesWithXOverride(edges, override);
+                const candidateEdges = edgesWithXOverride(evaluatedEdges, override);
                 const crossingSummary = yield* connectorCrossings(candidateEdges, context);
                 if (crossingSummary.count > current.crossingCount)
                     continue;
@@ -1587,6 +1588,7 @@ function* refineSiblingCohorts(context, edges, initial) {
                 movePlacedFocusX(context, node, x);
             }
             current = best.score;
+            evaluatedEdges = edgesWithXOverride(evaluatedEdges, best.override);
             accepted = true;
         }
         if (!accepted)
@@ -1644,13 +1646,19 @@ const CONNECTOR_REFINEMENT_WORK_MAX = 7_000_000;
 function* refineConnectorQualityWithinBudget(context) {
     const maximumAcceptedMoves = context.aggressiveAestheticRepair ? 32 : 24;
     const maximumCandidateNodes = context.aggressiveAestheticRepair ? 48 : 32;
-    const edges = yield* connectorEdges(context);
-    const crossingSummary = yield* connectorCrossings(edges, context);
-    const intersectionSummary = yield* connectorNodeIntersectionSummary(context, edges);
-    const symmetry = siblingQuality(context);
+    let edges = yield* connectorEdges(context);
+    let crossingSummary = yield* connectorCrossings(edges, context);
+    let intersectionSummary = yield* connectorNodeIntersectionSummary(context, edges);
+    let symmetry = siblingQuality(context);
     let current = connectorQualityScore(context, edges, crossingSummary.count, intersectionSummary.count, symmetry);
-    if (context.aggressiveAestheticRepair)
-        current = yield* refineSiblingCohorts(context, edges, current);
+    if (context.aggressiveAestheticRepair) {
+        yield* refineSiblingCohorts(context, edges, current);
+        edges = yield* connectorEdges(context);
+        crossingSummary = yield* connectorCrossings(edges, context);
+        intersectionSummary = yield* connectorNodeIntersectionSummary(context, edges);
+        symmetry = siblingQuality(context);
+        current = connectorQualityScore(context, edges, crossingSummary.count, intersectionSummary.count, symmetry);
+    }
     const candidateIds = new Set(intersectionSummary.involvedFocusIds);
     const longFocusIds = new Set();
     for (const edge of edges.filter(longConnector)) {

package/dist/hoi4_agent_tools/focus/render.js

@@ -216,7 +216,7 @@ function svgDocument(plan, layout, diagnostics, options) {
     const parts = [
         `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${logicalWidth} ${logicalHeight}" role="img" aria-labelledby="title description">`,
         `<title id="title">${escapeXml(plan.id)} focus tree</title>`,
-        `<desc id="description">Offline HOI4 Agent Tools representation. ${plan.focuses.length} focuses.</desc>`,
+        `<desc id="description">${plan.focuses.length} focuses.</desc>`,
         '<defs>',
         '__DETERMINISTIC_FONT_DEFINITIONS__',
         '<marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse"><path d="M 0 0 L 10 5 L 0 10 z" fill="#8da2bc"/></marker>',
@@ -224,12 +224,6 @@ function svgDocument(plan, layout, diagnostics, options) {
         '</defs>',
         '<rect width="100%" height="100%" fill="#111723"/>',
         toolText.render(plan.id, { x: padding, y: 36, fontSize: 22, weight: 700, fill: '#e8edf5' }),
-        toolText.render(`Offline agent render · layout ${layout.layoutHash.slice(0, 12)}`, {
-            x: padding,
-            y: 58,
-            fontSize: 12,
-            fill: '#95a4b8',
-        }),
         '<g id="prerequisites">',
     ];
     for (const edge of prerequisiteEdges) {
@@ -403,7 +397,7 @@ function htmlDocument(plan, svg, graphJson, diagnostics) {
 <body>
 <main class="canvas" aria-label="Focus tree artifact">${svg}</main>
 <aside class="panel">
-<div class="controls"><h1>${escapeXml(plan.id)}</h1><p class="notice">Offline HOI4 Agent Tools representation — not an in-game screenshot or editor.</p><label>Find focus<input id="search" type="search" placeholder="ID, title, branch, or lane"></label></div>
+<div class="controls"><h1>${escapeXml(plan.id)}</h1><label>Find focus<input id="search" type="search" placeholder="ID, title, branch, or lane"></label></div>
 <h2>Diagnostics</h2><ol>${diagnosticsHtml}</ol>
 <p class="muted">Source revision: <code>${escapeXml(plan.provenance.sourceHash)}</code></p>
 </aside>

package/dist/hoi4_agent_tools/gui/dds.js

@@ -1,6 +1,7 @@
 import { RenderBudget, RENDER_MAX_DECODED_PIXELS } from '../core/render-budget.js';
 import { sha256Bytes } from '../core/canonical.js';
 const DDS_MAGIC = 0x2053_4444;
+const DDSD_PITCH = 0x8;
 const DDPF_FOURCC = 0x4;
 const DDPF_RGB = 0x40;
 function fourCc(bytes, offset) {
@@ -180,7 +181,9 @@ export function decodeDds(bytes, budget = new RenderBudget(), operationKey = `dd
     budget.reserve(width, height, 'DDS texture decode', {
         maximumPixels: RENDER_MAX_DECODED_PIXELS,
     });
-    const pitch = bytes.readUInt32LE(20);
+    const headerFlags = bytes.readUInt32LE(8);
+    const pitchOrLinearSize = bytes.readUInt32LE(20);
+    const rowPitch = (headerFlags & DDSD_PITCH) === 0 ? 0 : pitchOrLinearSize;
     const flags = bytes.readUInt32LE(80);
     const code = fourCc(bytes, 84).toUpperCase();
     if ((flags & DDPF_FOURCC) !== 0) {
@@ -236,7 +239,7 @@ export function decodeDds(bytes, budget = new RenderBudget(), operationKey = `dd
         bytes.readUInt32LE(100),
         bytes.readUInt32LE(104),
     ];
-    const output = decodeRgb(bytes, 128, width, height, bitCount, pitch, masks);
+    const output = decodeRgb(bytes, 128, width, height, bitCount, rowPitch, masks);
     const format = bitCount === 24 ? 'rgb24' : 'rgba32';
     return output === undefined
         ? unsupported(format, 'The DDS RGB pixel data is truncated.')

package/dist/hoi4_agent_tools/gui/layout.js

@@ -750,7 +750,7 @@ async function layoutElement(definition, parentRect, inheritedClip, parentScale,
         }
     }
 }
-/** Build a deterministic, offline approximation of a GUI window without launching HOI4. */
+/** Build a deterministic GUI scene from the connected source graph and scenario. */
 export async function buildGuiScene(graph, scannedFiles, windowName, scenario, catalog = new GuiAssetCatalog(graph, scannedFiles)) {
     if (graph.nodes.length > GUI_GRAPH_MAX_NODES ||
         graph.edges.length > GUI_GRAPH_MAX_EDGES ||

package/dist/hoi4_agent_tools/gui/renderer.js

@@ -214,13 +214,7 @@ export function sceneToSvg(scene, variant) {
         .map((element) => renderOverlay(element, variant, toolText))
         .join('');
     const fidelity = escapeXml(canonicalJson(scene.fidelity));
-    const banner = toolText.render('OFFLINE APPROXIMATION \u00b7 NOT HOI4', {
-        x: view.viewBox.x + 15,
-        y: view.viewBox.y + 22,
-        fontSize: 11,
-        fill: '#f1c75b',
-    });
-    return `<svg xmlns="http://www.w3.org/2000/svg" width="${view.width}" height="${view.height}" viewBox="${finite(view.viewBox.x)} ${finite(view.viewBox.y)} ${finite(view.viewBox.width)} ${finite(view.viewBox.height)}"><metadata data-renderer="hoi4-agent-tools" data-mode="offline">${fidelity}</metadata><defs>${clipDefinitions.join('')}${sceneGlyphDefinitions(scene)}${toolText.definitions()}</defs><rect ${rectAttributes(view.viewBox)} fill="#17202a"/>${body}${overlays}<g><rect x="${finite(view.viewBox.x + 8)}" y="${finite(view.viewBox.y + 8)}" width="215" height="20" rx="3" fill="#05080c" fill-opacity="0.82"/>${banner}</g></svg>`;
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${view.width}" height="${view.height}" viewBox="${finite(view.viewBox.x)} ${finite(view.viewBox.y)} ${finite(view.viewBox.width)} ${finite(view.viewBox.height)}"><metadata data-renderer="hoi4-agent-tools" data-mode="offline">${fidelity}</metadata><defs>${clipDefinitions.join('')}${sceneGlyphDefinitions(scene)}${toolText.definitions()}</defs><rect ${rectAttributes(view.viewBox)} fill="#17202a"/>${body}${overlays}</svg>`;
 }
 async function cooperativeParts(values, render, signal) {
     const output = [];
@@ -244,13 +238,7 @@ async function sceneToSvgCooperative(scene, variant, signal) {
     const body = await cooperativeParts(scene.elements, (element, index) => renderBaseElement(element, element.clipRect === undefined ? undefined : `clip-${index}`, toolText), signal);
     const overlays = await cooperativeParts(scene.elements, (element) => renderOverlay(element, variant, toolText), signal);
     const fidelity = escapeXml(canonicalJson(scene.fidelity));
-    const banner = toolText.render('OFFLINE APPROXIMATION \u00b7 NOT HOI4', {
-        x: view.viewBox.x + 15,
-        y: view.viewBox.y + 22,
-        fontSize: 11,
-        fill: '#f1c75b',
-    });
-    return `<svg xmlns="http://www.w3.org/2000/svg" width="${view.width}" height="${view.height}" viewBox="${finite(view.viewBox.x)} ${finite(view.viewBox.y)} ${finite(view.viewBox.width)} ${finite(view.viewBox.height)}"><metadata data-renderer="hoi4-agent-tools" data-mode="offline">${fidelity}</metadata><defs>${clipDefinitions}${sceneGlyphDefinitions(scene)}${toolText.definitions()}</defs><rect ${rectAttributes(view.viewBox)} fill="#17202a"/>${body}${overlays}<g><rect x="${finite(view.viewBox.x + 8)}" y="${finite(view.viewBox.y + 8)}" width="215" height="20" rx="3" fill="#05080c" fill-opacity="0.82"/>${banner}</g></svg>`;
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${view.width}" height="${view.height}" viewBox="${finite(view.viewBox.x)} ${finite(view.viewBox.y)} ${finite(view.viewBox.width)} ${finite(view.viewBox.height)}"><metadata data-renderer="hoi4-agent-tools" data-mode="offline">${fidelity}</metadata><defs>${clipDefinitions}${sceneGlyphDefinitions(scene)}${toolText.definitions()}</defs><rect ${rectAttributes(view.viewBox)} fill="#17202a"/>${body}${overlays}</svg>`;
 }
 export function hierarchyToSvg(scene) {
     const rows = scene.elements.toSorted((left, right) => left.depth - right.depth || left.zIndex - right.zIndex || compareCodeUnits(left.id, right.id));
@@ -283,7 +271,7 @@ export function hierarchyToSvg(scene) {
         return `${parentLine}<circle cx="${x}" cy="${y - 8}" r="4" fill="${colour}"/>${nameText}${detailText}`;
     })
         .join('');
-    const heading = toolText.render(`OFFLINE HIERARCHY \u00b7 ${scene.windowName}`, {
+    const heading = toolText.render(`${scene.windowName} \u00b7 HIERARCHY`, {
         x: 16,
         y: 20,
         fontSize: 12,
@@ -393,7 +381,7 @@ export function renderGallerySvg(title, items) {
         return `<g>${toolText.render(item.label, { x, y: y + 14, fontSize: 12, fill: '#f1c75b' })}<image x="${x}" y="${y + 22}" width="${finite(item.width * scale)}" height="${finite(item.height * scale)}" href="data:image/png;base64,${item.png.toString('base64')}"/></g>`;
     })
         .join('');
-    const heading = toolText.render(`${title} \u00b7 OFFLINE APPROXIMATION`, {
+    const heading = toolText.render(title, {
         x: 12,
         y: 24,
         fontSize: 15,

package/dist/hoi4_agent_tools/gui/source-graph.js

@@ -31,12 +31,12 @@ const explicitGuiElementTypes = new Set([
     'mapIconType',
 ]);
 const spriteTypes = new Set([
-    'spriteType',
-    'textSpriteType',
-    'frameAnimatedSpriteType',
-    'corneredTileSpriteType',
-    'progressbarType',
-    'maskedShieldType',
+    'spritetype',
+    'textspritetype',
+    'frameanimatedspritetype',
+    'corneredtilespritetype',
+    'progressbartype',
+    'maskedshieldtype',
 ]);
 const modelledElementAttributes = new Set([
     'name',
@@ -330,7 +330,8 @@ function indexSpritesAndFonts(document, file, fileNodeId, nodes, edges, sprites,
             if (assignment.value.type !== 'block')
                 continue;
             const child = assignment.value;
-            if (spriteTypes.has(assignment.key.value)) {
+            const spriteType = assignment.key.value.toLowerCase();
+            if (spriteTypes.has(spriteType)) {
                 const name = firstScalarInsensitive(child, 'name');
                 if (name !== undefined) {
                     const id = deterministicId('gui_sprite', { path: file.displayPath, name });
@@ -352,7 +353,7 @@ function indexSpritesAndFonts(document, file, fileNodeId, nodes, edges, sprites,
                         ...(texturePath === undefined ? {} : { texturePath }),
                         ...(texturePath2 === undefined ? {} : { texturePath2 }),
                         frameCount: Math.trunc(numberScalar(child, 'noOfFrames', 'noofframes') ?? 1),
-                        frameAnimated: assignment.key.value === 'frameAnimatedSpriteType',
+                        frameAnimated: spriteType === 'frameanimatedspritetype',
                         ...(animationRateFps === undefined ? {} : { animationRateFps }),
                         ...(looping === undefined ? {} : { looping }),
                         ...(playOnShow === undefined ? {} : { playOnShow }),

package/dist/hoi4_agent_tools/gui/studio.js

@@ -11,6 +11,7 @@ import { ServiceError } from '../core/result.js';
 import { WorkspaceScanner } from '../core/scanner.js';
 import { applyReplacements, decodeSource, encodeSource, parseClausewitz, parseLocalisation, SOURCE_MAX_BYTES, sourcePartialLimitDiagnostics, } from '../core/source/index.js';
 import { readDependenciesFromScannedFiles, } from '../core/transactions.js';
+import { TRANSACTION_MAX_DIAGNOSTICS } from '../core/transaction-limits.js';
 import { PACKAGE_VERSION } from '../version.js';
 import { isSafeAnimationSourcePath } from './animation-manifest.js';
 import { GuiAssetCatalog, parseBmFont } from './assets.js';
@@ -30,6 +31,43 @@ const staticGuiDefinitionPatterns = [
 ];
 export const GUI_TEXT_PACKAGE_MAX_FILES = 32;
 export const GUI_TEXT_PACKAGE_MAX_BYTES = 16_777_216;
+const GUI_TRANSACTION_PHASE_DIAGNOSTIC_BUDGET = Math.floor(TRANSACTION_MAX_DIAGNOSTICS / 3);
+function hardDiagnostic(diagnostic) {
+    return diagnostic.severity === 'error' || diagnostic.severity === 'blocker';
+}
+export function boundedGuiTransactionDiagnostics(diagnostics, maximumDiagnostics, evidenceArtifactName) {
+    if (diagnostics.length <= maximumDiagnostics)
+        return [...diagnostics];
+    if (maximumDiagnostics <= 0)
+        return [];
+    const retainedLimit = maximumDiagnostics - 1;
+    const hard = diagnostics.filter(hardDiagnostic);
+    const retainedHard = hard.slice(0, retainedLimit);
+    const retainedHardSet = new Set(retainedHard);
+    const retainedSoft = diagnostics
+        .filter((diagnostic) => !hardDiagnostic(diagnostic) && !retainedHardSet.has(diagnostic))
+        .slice(0, retainedLimit - retainedHard.length);
+    const omittedHard = hard.length - retainedHard.length;
+    return [
+        ...retainedHard,
+        ...retainedSoft,
+        {
+            code: 'GUI_REWRITE_DIAGNOSTICS_TRUNCATED',
+            severity: omittedHard > 0 ? 'blocker' : 'warning',
+            category: 'validation',
+            message: evidenceArtifactName === undefined
+                ? `GUI rewrite validation produced ${diagnostics.length} diagnostics; transaction evidence retains the highest-priority ${maximumDiagnostics}`
+                : `GUI rewrite validation produced ${diagnostics.length} diagnostics; complete evidence is stored in ${evidenceArtifactName}`,
+            details: {
+                total: diagnostics.length,
+                returned: maximumDiagnostics,
+                omitted: diagnostics.length - retainedLimit,
+                omittedHard,
+                ...(evidenceArtifactName === undefined ? {} : { evidenceArtifactName }),
+            },
+        },
+    ];
+}
 function normalizeConfiguredRoot(value) {
     const normalized = value.replaceAll('\\', '/').replace(/^\.\//u, '').replace(/\/$/u, '');
     if (!isSafeAnimationSourcePath(normalized)) {
@@ -439,7 +477,7 @@ export function guiArtifactProvenance(graph, kind, primaryScene, scenarioScenes
             })),
         },
         metadata: {
-            rendererLabel: 'OFFLINE APPROXIMATION · NOT HOI4',
+            rendererLabel: 'HOI4 Agent Tools deterministic GUI render',
             ...metadata,
             sourceHashInventory: sourceEvidence.inventory,
         },
@@ -859,6 +897,7 @@ export class ScriptedGuiStudio {
         const preflightDiagnostics = [];
         const preflightChecks = [];
         const preflightArtifacts = [];
+        let rewriteEvidenceArtifactName;
         let dependencyFiles = baseline.files;
         if (input.windowName !== undefined && input.scenario !== undefined) {
             let proposedFiles = overlayGuiTextPackageFiles(baseline.files, prepared);
@@ -942,6 +981,7 @@ export class ScriptedGuiStudio {
             }
             const comparison = await compareGuiImages(baselinePng, proposedImage.png, renderBudget, input.signal);
             const slug = safeSlug(input.windowName);
+            rewriteEvidenceArtifactName = `${slug}-rewrite-validation.json`;
             const metadata = {
                 relativePath: input.relativePath,
                 packageFiles: prepared.map(({ relativePath }) => relativePath),
@@ -982,10 +1022,24 @@ export class ScriptedGuiStudio {
                     })}\n`,
                     provenance: guiArtifactProvenance(proposedGraph, 'gui-proposed-fidelity', proposedScene, [proposedScene], metadata),
                 },
+                {
+                    name: rewriteEvidenceArtifactName,
+                    mimeType: 'application/json',
+                    content: `${canonicalJson({
+                        sourceDiagnostics: proposedSourceDiagnostics,
+                        graphDiagnostics: proposedGraph.diagnostics,
+                        sceneDiagnostics: proposedScene.diagnostics,
+                        validation: proposedValidation,
+                        transactionDiagnostics: preflightDiagnostics,
+                        transactionChecks: preflightChecks,
+                    })}\n`,
+                    provenance: guiArtifactProvenance(proposedGraph, 'gui-rewrite-validation', proposedScene, [proposedScene], metadata),
+                },
             ];
             const stored = await this.artifacts.withAtomicWrites(workspace, writes, (artifacts) => Promise.resolve([...artifacts]), input.signal);
             preflightArtifacts.push(...stored.map(publicArtifactLink));
         }
+        const transactionPreflightDiagnostics = boundedGuiTransactionDiagnostics(preflightDiagnostics, GUI_TRANSACTION_PHASE_DIAGNOSTIC_BUDGET, rewriteEvidenceArtifactName);
         const operationId = deterministicId('gui_source_change', {
             relativePath: input.relativePath,
             files: prepared.map(({ relativePath, bytes }) => ({
@@ -1020,7 +1074,7 @@ export class ScriptedGuiStudio {
             })),
             readDependencies: readDependenciesFromScannedFiles(dependencyFiles),
             artifacts: preflightArtifacts,
-            diagnostics: preflightDiagnostics,
+            diagnostics: transactionPreflightDiagnostics,
             validate: (proposed, signal) => {
                 const diagnostics = [];
                 let present = true;
@@ -1049,7 +1103,7 @@ export class ScriptedGuiStudio {
                     diagnostics.push(...blocking.map((diagnostic) => ({ ...diagnostic, operationId })));
                 }
                 return Promise.resolve({
-                    diagnostics,
+                    diagnostics: boundedGuiTransactionDiagnostics(diagnostics, GUI_TRANSACTION_PHASE_DIAGNOSTIC_BUDGET, rewriteEvidenceArtifactName),
                     checks: [
                         ...preflightChecks,
                         {
@@ -1077,7 +1131,7 @@ export class ScriptedGuiStudio {
                 const scanned = await this.scan(workspaceId, principal, validationSignal);
                 const passed = !scanned.graph.diagnostics.some(({ severity }) => severity === 'error' || severity === 'blocker');
                 return {
-                    diagnostics: scanned.graph.diagnostics,
+                    diagnostics: boundedGuiTransactionDiagnostics(scanned.graph.diagnostics, Math.max(0, TRANSACTION_MAX_DIAGNOSTICS - _manifest.diagnostics.length), _manifest.artifacts.find(({ name }) => name.endsWith('-rewrite-validation.json'))?.name),
                     checks: [
                         {
                             id: 'post-write-gui-graph',

package/dist/hoi4_agent_tools/map/render.js

@@ -433,7 +433,7 @@ function htmlDocument(title, png, json) {
         .replaceAll('<', '&lt;')
         .replaceAll('>', '&gt;');
     const escapedJson = json.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
-    return `<!doctype html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${escapedTitle}</title><style>html{background:#10151b;color:#edf2f7;font:14px system-ui}body{margin:20px}.controls{display:flex;gap:8px;align-items:center;margin:12px 0}button{background:#263241;color:#edf2f7;border:1px solid #526173;border-radius:4px;padding:6px 10px}.viewport{height:70vh;overflow:hidden;border:1px solid #48515c;background:#080b0f;position:relative;touch-action:none}.viewport img{image-rendering:pixelated;transform-origin:0 0;position:absolute;max-width:none;cursor:grab;user-select:none}.viewport img.dragging{cursor:grabbing}pre{white-space:pre-wrap;overflow-wrap:anywhere}</style></head><body><h1>${escapedTitle}</h1><p>Offline deterministic map representation; not an in-game screenshot or source editor.</p><div class="controls"><button id="out" type="button">-</button><button id="reset" type="button">Reset</button><button id="in" type="button">+</button><output id="zoom">100%</output></div><div class="viewport" id="viewport"><img id="map" draggable="false" alt="${escapedTitle}" src="data:image/png;base64,${png.toString('base64')}"></div><details><summary>Render metadata</summary><pre>${escapedJson}</pre></details><script>(()=>{const image=document.getElementById('map'),viewport=document.getElementById('viewport'),label=document.getElementById('zoom');let scale=1,x=0,y=0,drag=false,lastX=0,lastY=0;const draw=()=>{image.style.transform='translate('+x+'px,'+y+'px) scale('+scale+')';label.value=Math.round(scale*100)+'%'};const zoom=(factor,cx=viewport.clientWidth/2,cy=viewport.clientHeight/2)=>{const next=Math.min(16,Math.max(.1,scale*factor));x=cx-(cx-x)*(next/scale);y=cy-(cy-y)*(next/scale);scale=next;draw()};document.getElementById('in').onclick=()=>zoom(1.25);document.getElementById('out').onclick=()=>zoom(.8);document.getElementById('reset').onclick=()=>{scale=1;x=0;y=0;draw()};viewport.addEventListener('wheel',event=>{event.preventDefault();const bounds=viewport.getBoundingClientRect();zoom(event.deltaY<0?1.15:.87,event.clientX-bounds.left,event.clientY-bounds.top)},{passive:false});image.addEventListener('pointerdown',event=>{drag=true;lastX=event.clientX;lastY=event.clientY;image.setPointerCapture(event.pointerId);image.classList.add('dragging')});image.addEventListener('pointermove',event=>{if(!drag)return;x+=event.clientX-lastX;y+=event.clientY-lastY;lastX=event.clientX;lastY=event.clientY;draw()});image.addEventListener('pointerup',()=>{drag=false;image.classList.remove('dragging')});draw()})();</script></body></html>`;
+    return `<!doctype html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${escapedTitle}</title><style>html{background:#10151b;color:#edf2f7;font:14px system-ui}body{margin:20px}.controls{display:flex;gap:8px;align-items:center;margin:12px 0}button{background:#263241;color:#edf2f7;border:1px solid #526173;border-radius:4px;padding:6px 10px}.viewport{height:70vh;overflow:hidden;border:1px solid #48515c;background:#080b0f;position:relative;touch-action:none}.viewport img{image-rendering:pixelated;transform-origin:0 0;position:absolute;max-width:none;cursor:grab;user-select:none}.viewport img.dragging{cursor:grabbing}pre{white-space:pre-wrap;overflow-wrap:anywhere}</style></head><body><h1>${escapedTitle}</h1><div class="controls"><button id="out" type="button">-</button><button id="reset" type="button">Reset</button><button id="in" type="button">+</button><output id="zoom">100%</output></div><div class="viewport" id="viewport"><img id="map" draggable="false" alt="${escapedTitle}" src="data:image/png;base64,${png.toString('base64')}"></div><details><summary>Render metadata</summary><pre>${escapedJson}</pre></details><script>(()=>{const image=document.getElementById('map'),viewport=document.getElementById('viewport'),label=document.getElementById('zoom');let scale=1,x=0,y=0,drag=false,lastX=0,lastY=0;const draw=()=>{image.style.transform='translate('+x+'px,'+y+'px) scale('+scale+')';label.value=Math.round(scale*100)+'%'};const zoom=(factor,cx=viewport.clientWidth/2,cy=viewport.clientHeight/2)=>{const next=Math.min(16,Math.max(.1,scale*factor));x=cx-(cx-x)*(next/scale);y=cy-(cy-y)*(next/scale);scale=next;draw()};document.getElementById('in').onclick=()=>zoom(1.25);document.getElementById('out').onclick=()=>zoom(.8);document.getElementById('reset').onclick=()=>{scale=1;x=0;y=0;draw()};viewport.addEventListener('wheel',event=>{event.preventDefault();const bounds=viewport.getBoundingClientRect();zoom(event.deltaY<0?1.15:.87,event.clientX-bounds.left,event.clientY-bounds.top)},{passive:false});image.addEventListener('pointerdown',event=>{drag=true;lastX=event.clientX;lastY=event.clientY;image.setPointerCapture(event.pointerId);image.classList.add('dragging')});image.addEventListener('pointermove',event=>{if(!drag)return;x+=event.clientX-lastX;y+=event.clientY-lastY;lastX=event.clientX;lastY=event.clientY;draw()});image.addEventListener('pointerup',()=>{drag=false;image.classList.remove('dragging')});draw()})();</script></body></html>`;
 }
 async function encodePng(raw, width, height, scale) {
     assertRenderDimensions(width, height, 'map Sharp source raster');