hoi4-agent-tools 2.5.1 → 2.5.2

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## Unreleased
+
+No unreleased changes.
+
+## 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`.
+- Reverified the public Technology Tree Viewer MCP workflow across
+  `hoi4.tech_inspect`, `hoi4.tech_render`, and `hoi4.tech_compare` before
+  publication.
+
 ## 2.5.1 - 2026-08-13
 
 - Published artifact contents and provenance manifests atomically across independent MCP processes, preventing event, probability, GUI, and other concurrent inspections from observing partially written manifests.

package/dist/hoi4_agent_tools/technology/compare.js

@@ -92,6 +92,7 @@ function technologyMetadata(technology) {
         researchCost: technology.researchCost ?? null,
         doctrineName: technology.doctrineName ?? null,
         hidden: technology.hidden,
+        layoutSize: technology.layoutSize,
         folders: technology.folders,
         categories: technology.categories,
         tags: technology.tags,

package/dist/hoi4_agent_tools/technology/render.js

@@ -5,8 +5,10 @@ import { ServiceError } from '../core/result.js';
 import { DeterministicSvgTextRenderer } from '../core/svg-text.js';
 import { traceTechnology } from './queries.js';
 const MAX_RENDER_NODES = 2_000;
-const NODE_WIDTH = 210;
-const NODE_HEIGHT = 76;
+const LARGE_NODE_WIDTH = 183;
+const LARGE_NODE_HEIGHT = 84;
+const SMALL_NODE_WIDTH = 72;
+const SMALL_NODE_HEIGHT = 72;
 const GAP_X = 42;
 const GAP_Y = 42;
 const GENERATED_NODE_WIDTH = 180;
@@ -44,6 +46,7 @@ function technologyNode(graph, technologyId, placement) {
         kind: technology.kind,
         sourcePath: technology.source.path,
         sourceLine: technology.source.location.start.line,
+        layoutSize: technology.layoutSize,
         ...(placement === undefined ? {} : { placement }),
     };
 }
@@ -415,17 +418,22 @@ function issueKey(issue) {
     return sha256Bytes(canonicalJson({ code: issue.code, details: issue.details })).slice(0, 20);
 }
 function layoutFolder(nodes) {
+    const dimensions = (node) => node.layoutSize === 'small'
+        ? { width: SMALL_NODE_WIDTH, height: SMALL_NODE_HEIGHT }
+        : { width: LARGE_NODE_WIDTH, height: LARGE_NODE_HEIGHT };
     const sourcePixel = nodes.filter(({ placement }) => placement?.pixelX !== undefined && placement.pixelY !== undefined);
     if (sourcePixel.length === nodes.length && sourcePixel.length > 0) {
         const minimumX = Math.min(...sourcePixel.map(({ placement }) => placement.pixelX));
         const minimumY = Math.min(...sourcePixel.map(({ placement }) => placement.pixelY));
-        return sourcePixel.map((node) => ({
-            ...node,
-            x: PADDING + node.placement.pixelX - minimumX,
-            y: HEADER_HEIGHT + PADDING + node.placement.pixelY - minimumY,
-            width: NODE_WIDTH,
-            height: NODE_HEIGHT,
-        }));
+        return sourcePixel.map((node) => {
+            const size = dimensions(node);
+            return {
+                ...node,
+                x: PADDING + node.placement.pixelX - minimumX,
+                y: HEADER_HEIGHT + PADDING + node.placement.pixelY - minimumY,
+                ...size,
+            };
+        });
     }
     const branchRoots = [
         ...new Set(nodes.map(({ placement }) => placement?.branchRootId ?? '<unresolved>')),
@@ -434,9 +442,12 @@ function layoutFolder(nodes) {
     return nodes.map((node, index) => {
         const placement = node.placement;
         const lane = lanes.get(placement?.branchRootId ?? '<unresolved>') ?? 0;
-        const x = PADDING + lane * 680 + (placement?.x ?? index % 3) * (NODE_WIDTH + GAP_X);
-        const y = HEADER_HEIGHT + PADDING + (placement?.y ?? Math.floor(index / 3)) * (NODE_HEIGHT + GAP_Y);
-        return { ...node, x, y, width: NODE_WIDTH, height: NODE_HEIGHT };
+        const size = dimensions(node);
+        const x = PADDING + lane * 680 + (placement?.x ?? index % 3) * (LARGE_NODE_WIDTH + GAP_X);
+        const y = HEADER_HEIGHT +
+            PADDING +
+            (placement?.y ?? Math.floor(index / 3)) * (LARGE_NODE_HEIGHT + GAP_Y);
+        return { ...node, x, y, ...size };
     });
 }
 function layoutGenerated(nodes, edges) {
@@ -527,8 +538,8 @@ function colours(kind) {
     }[kind];
 }
 function svgFor(titleText, positioned, edges, sourceAccurate) {
-    const maximumX = Math.max(PADDING + NODE_WIDTH, ...positioned.map(({ x, width }) => x + width));
-    const maximumY = Math.max(HEADER_HEIGHT + NODE_HEIGHT, ...positioned.map(({ y, height }) => y + height));
+    const maximumX = Math.max(PADDING + LARGE_NODE_WIDTH, ...positioned.map(({ x, width }) => x + width));
+    const maximumY = Math.max(HEADER_HEIGHT + LARGE_NODE_HEIGHT, ...positioned.map(({ y, height }) => y + height));
     const width = Math.ceil(maximumX + PADDING);
     const height = Math.ceil(maximumY + PADDING);
     if (width > 16_384 || height > 16_384 || width * height > RENDER_MAX_PIXELS)
@@ -554,24 +565,29 @@ function svgFor(titleText, positioned, edges, sourceAccurate) {
     });
     const nodeSvg = positioned.map((node) => {
         const colour = colours(node.kind);
-        const label = node.label.length > 34 ? `${node.label.slice(0, 31)}…` : node.label;
+        const small = node.layoutSize === 'small';
+        const labelLimit = small ? 12 : 34;
+        const label = node.label.length > labelLimit
+            ? `${node.label.slice(0, Math.max(1, labelLimit - 1))}…`
+            : node.label;
         const subtitle = node.subtitle.length > 48 ? `${node.subtitle.slice(0, 45)}…` : node.subtitle;
         const labelSvg = text.render(label, {
-            x: node.x + 12,
-            y: node.y + 30,
-            fontSize: 15,
+            x: node.x + (small ? 6 : 12),
+            y: node.y + (small ? 27 : 30),
+            fontSize: small ? 9 : 15,
             fill: '#f1f5f8',
             weight: 600,
-            targetWidth: Math.min(node.width - 24, Math.max(1, text.measure(label, 15))),
+            targetWidth: Math.min(node.width - (small ? 12 : 24), Math.max(1, text.measure(label, small ? 9 : 15))),
         });
-        const subtitleSvg = text.render(subtitle, {
-            x: node.x + 12,
-            y: node.y + 56,
-            fontSize: 11,
+        const subtitleSvg = text.render(small ? 'SMALL' : subtitle, {
+            x: node.x + (small ? 6 : 12),
+            y: node.y + (small ? 51 : 58),
+            fontSize: small ? 8 : 11,
             fill: '#b8c4ce',
-            targetWidth: Math.min(node.width - 24, Math.max(1, text.measure(subtitle, 11))),
+            targetWidth: Math.min(node.width - (small ? 12 : 24), Math.max(1, text.measure(small ? 'SMALL' : subtitle, small ? 8 : 11))),
         });
-        return `<g data-node-id="${escapeXml(node.id)}"${node.sourcePath === undefined ? '' : ` data-source-path="${escapeXml(node.sourcePath)}" data-source-line="${node.sourceLine ?? 1}"`}><rect x="${node.x}" y="${node.y}" width="${node.width}" height="${node.height}" rx="8" fill="${colour.fill}" stroke="${colour.stroke}" stroke-width="2"/><title>${escapeXml(`${node.id}${node.sourcePath === undefined ? '' : ` · ${node.sourcePath}:${node.sourceLine ?? 1}`}`)}</title>${labelSvg}${subtitleSvg}</g>`;
+        const layoutAttribute = node.layoutSize === undefined ? '' : ` data-layout-size="${node.layoutSize}"`;
+        return `<g data-node-id="${escapeXml(node.id)}"${layoutAttribute}${node.sourcePath === undefined ? '' : ` data-source-path="${escapeXml(node.sourcePath)}" data-source-line="${node.sourceLine ?? 1}"`}><rect x="${node.x}" y="${node.y}" width="${node.width}" height="${node.height}" rx="8" fill="${colour.fill}" stroke="${colour.stroke}" stroke-width="2"/><title>${escapeXml(`${node.id}${node.layoutSize === undefined ? '' : ` · ${node.layoutSize} layout`}${node.sourcePath === undefined ? '' : ` · ${node.sourcePath}:${node.sourceLine ?? 1}`}`)}</title>${labelSvg}${subtitleSvg}</g>`;
     });
     const title = text.render(titleText, {
         x: PADDING,

package/dist/hoi4_agent_tools/technology/source-analysis.js

@@ -348,6 +348,13 @@ function parseTechnologyDefinitions(file, document, fragment) {
                     .map(({ key }) => key.value)
                     .filter((key) => !technologyStructuralFields.has(key) && !key.startsWith('@'))),
             ].sort(compareCodeUnits);
+            const layoutExpression = firstValue(block, 'force_use_small_tech_layout');
+            const smallLayout = booleanValue(layoutExpression);
+            const layoutSize = layoutExpression === undefined || smallLayout === false
+                ? 'large'
+                : smallLayout === true
+                    ? 'small'
+                    : 'unknown';
             const unsupportedFields = fragment.placements
                 .filter(({ technologyId, xExpression, yExpression }) => technologyId === id && (xExpression !== undefined || yExpression !== undefined))
                 .map((placement) => ({
@@ -355,7 +362,17 @@ function parseTechnologyDefinitions(file, document, fragment) {
                 expression: `${placement.xExpression ?? placement.x ?? '?'}:${placement.yExpression ?? placement.y ?? '?'}`,
                 location: placement.location,
                 reason: 'The source coordinate expression is not a resolvable file-local numeric constant',
-            }));
+            }))
+                .concat(layoutSize === 'unknown'
+                ? [
+                    {
+                        field: 'force_use_small_tech_layout',
+                        expression: layoutExpression,
+                        location: nodeLocation(document, block, id),
+                        reason: 'The technology layout-size expression is not a literal yes or no',
+                    },
+                ]
+                : []);
             const doctrine = booleanValue(firstValue(block, 'doctrine')) === true;
             fragment.technologies.push({
                 id,
@@ -372,6 +389,7 @@ function parseTechnologyDefinitions(file, document, fragment) {
                     ? {}
                     : { doctrineName: firstValue(block, 'doctrine_name') }),
                 hidden: hiddenStatus(block),
+                layoutSize,
                 folders: [...new Set(folders)].sort(compareCodeUnits),
                 categories: [...new Set(categories)].sort(compareCodeUnits),
                 tags: [...new Set(tags)].sort(compareCodeUnits),

package/dist/hoi4_agent_tools/version.js

@@ -1,6 +1,6 @@
 import { LATEST_PROTOCOL_VERSION } from '@modelcontextprotocol/sdk/types.js';
 export const PACKAGE_NAME = 'hoi4-agent-tools';
-export const PACKAGE_VERSION = '2.5.1';
+export const PACKAGE_VERSION = '2.5.2';
 export const MCP_PROTOCOL_VERSION = LATEST_PROTOCOL_VERSION;
 export const CONFIG_VERSION = 1;
 export const TRANSACTION_VERSION = 1;

package/docs/technology.md

@@ -51,7 +51,7 @@ Game-backed and otherwise large workspaces automatically use focused analysis mo
 
 `hoi4.tech_render` returns authoritative JSON with deterministic SVG and PNG resources; set `includeHtml` when a bundled static report is useful. Available views are `summary`, `folder`, `dependencies`, `technology`, `doctrine`, `exclusive`, `memberships`, `bonuses`, `grants`, `unlocks`, `metadata`, `assets`, and `unresolved`.
 
-Folder renders use the actual folder assignments, gridbox geometry, and technology coordinates found in source. Dependency and other semantic views are explicitly labelled as generated analysis layouts. Missing sprites, textures, or localisation remain identifiable from JSON and vector output even when no icon raster is decoded.
+Folder renders use the actual folder assignments, gridbox geometry, technology coordinates, and HOI4 item size found in source. Technologies with `force_use_small_tech_layout = yes` render as 72×72 small items; normal technologies render as large items. The authoritative JSON and SVG expose `layoutSize` for every technology. Dependency and other semantic views are explicitly labelled as generated analysis layouts. Missing sprites, textures, or localisation remain identifiable from JSON and vector output even when no icon raster is decoded.
 
 Example folder render:
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hoi4-agent-tools",
   "mcpName": "io.github.klimPaskov/hoi4-agent-tools",
-  "version": "2.5.1",
+  "version": "2.5.2",
   "description": "Analyze HOI4 events, tech trees, AI weights, and MTTH; build focus trees, GUIs, and maps.",
   "type": "module",
   "license": "Apache-2.0",

package/schemas/configuration.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/configuration.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/configuration.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/continuous-focus-palette.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/continuous-focus-palette.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/continuous-focus-palette.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/custom-weighted-pool.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/custom-weighted-pool.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/custom-weighted-pool.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/event-feature-manifest.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/event-feature-manifest.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/event-feature-manifest.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/focus-plan.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/focus-plan.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/focus-plan.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/focus-planning-sidecar.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/focus-planning-sidecar.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/focus-planning-sidecar.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/gui-animation-source.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/gui-animation-source.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/gui-animation-source.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/gui-helper.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/gui-helper.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/gui-helper.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/gui-scenario.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/gui-scenario.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/gui-scenario.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/map-operation.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/map-operation.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/map-operation.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "oneOf": [
     {

package/schemas/operation-result.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/operation-result.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/operation-result.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-analysis-result.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/probability-analysis-result.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/probability-analysis-result.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-compare-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/probability-compare-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/probability-compare-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-evaluate-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/probability-evaluate-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/probability-evaluate-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-inspect-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/probability-inspect-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/probability-inspect-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-render-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/probability-render-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/probability-render-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-scenario-set.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/probability-scenario-set.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/probability-scenario-set.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-sequence-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/probability-sequence-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/probability-sequence-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-simulate-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/probability-simulate-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/probability-simulate-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/probability-sweep-input.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.1/schemas/probability-sweep-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.5.2/schemas/probability-sweep-input.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.klimPaskov/hoi4-agent-tools",
   "title": "HOI4 Agent Tools",
   "description": "Analyze HOI4 events, tech trees, AI weights, and MTTH; build focus trees, GUIs, and maps.",
-  "version": "2.5.1",
+  "version": "2.5.2",
   "repository": {
     "url": "https://github.com/klimPaskov/hoi4-agent-tools",
     "source": "github"
@@ -13,7 +13,7 @@
     {
       "registryType": "npm",
       "identifier": "hoi4-agent-tools",
-      "version": "2.5.1",
+      "version": "2.5.2",
       "transport": {
         "type": "stdio"
       }