hoi4-agent-tools 3.0.9 → 3.2.0

package/docs/technology.md

@@ -6,7 +6,7 @@ Use the three technology tools directly from the target mod.
 
 ## Inspect
 
-`hoi4.tech_inspect` provides eight focused modes:
+`hoi4.tech_inspect` provides nine focused modes:
 
 - `scan`: build the technology graph and report its inventory, diagnostics, analysis limits, and revision. Small graphs include the complete graph in the report; large graphs return exact counts, grouped findings, samples, and the revision for focused follow-up queries.
 - `folders`: list folder roots and source placements, or inspect one `folderId`.
@@ -16,6 +16,7 @@ Use the three technology tools directly from the target mod.
 - `bonus_coverage`: show which technologies or categories are covered by discovered research bonuses.
 - `lint`: filter source-linked findings by classification, diagnostic code, folder, or technology.
 - `impact`: find the definitions, placements, edges, grants, bonuses, unlocks, localisation, sprites, and files affected by a proposed removal or rename.
+- `helper_expansion`: stream source-linked scripted-effect call paths and helper-owned technology references with bounded pages and revision-bound continuation.
 
 Example trace:
 
@@ -45,7 +46,10 @@ Impact mode takes a subject with `kind` set to `technology`, `category`, `folder
 
 Findings are separated into confirmed errors, probable defects, design warnings, and unresolved analysis. Roots, grant-only technologies, early dates, zero AI weights, repeated effects, and routing nodes are evaluated in context instead of being treated as automatic defects. The viewer keeps its authoritative graph in memory while the linked scan artifact remains a bounded summary; use its revision with the focused inspect modes or a render resource to inspect the relevant records.
 
-Game-backed and otherwise large workspaces automatically use focused analysis mode. It keeps direct grants, bonuses, unlocks, definitions, and the source-linked scripted-effect call index while deferring the full helper projection that can otherwise make a vanilla-plus-mod scan take minutes or exhaust the server process. The result is marked partial and names this boundary in `analysisBoundary`; no direct source evidence is discarded.
+Ordinary technology inspection uses the materialized graph and its explicit helper-depth and projection limits.
+A truncated helper expansion reports incomplete coverage.
+For a large helper closure, [bounded helper expansion](helper-expansion.md) uses the structural call inventory and streams source-linked paths without first materializing the full projection.
+It preserves separate conditional call sites and identifies source, cycle, and depth boundaries without simulating trigger outcomes.
 
 ## Render
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "hoi4-agent-tools",
   "mcpName": "io.github.klimPaskov/hoi4-agent-tools",
-  "version": "3.0.9",
-  "description": "Analyze HOI4 events, tech trees, AI weights, and MTTH; build focus trees, GUIs, and maps.",
+  "version": "3.2.0",
+  "description": "Analyze HOI4 events, decisions, impact, tech, AI, and MTTH; build focus trees, GUIs, and maps.",
   "type": "module",
   "license": "Apache-2.0",
   "author": "HOI4 Agent Tools contributors",
@@ -22,6 +22,8 @@
     "clausewitz",
     "focus-trees",
     "event-chains",
+    "impact-analysis",
+    "decisions",
     "technology-trees",
     "doctrines",
     "ai-weights",
@@ -39,6 +41,7 @@
     "docs/README.md",
     "docs/setup.md",
     "docs/events.md",
+    "docs/analysis.md",
     "docs/technology.md",
     "docs/probability.md",
     "docs/research/probability-adapter-evidence.md",
@@ -47,6 +50,8 @@
     "docs/map.md",
     "docs/http.md",
     "docs/development.md",
+    "docs/jobs.md",
+    "docs/helper-expansion.md",
     "docs/images/readme/",
     "examples/clients/",
     "examples/probability/",
@@ -99,23 +104,27 @@
   },
   "dependencies": {
     "@fontsource-variable/roboto": "5.3.0",
+    "@modelcontextprotocol/core": "2.0.0",
+    "@modelcontextprotocol/node": "2.0.0",
     "@modelcontextprotocol/sdk": "1.30.0",
+    "@modelcontextprotocol/server": "2.0.0",
     "express": "5.2.1",
     "fast-glob": "3.3.3",
     "fontkit": "2.0.4",
     "iconv-lite": "0.7.3",
     "jose": "6.2.8",
-    "sharp": "0.35.3",
+    "sharp": "0.35.4",
     "zod": "4.4.3"
   },
   "devDependencies": {
     "@eslint/js": "10.0.1",
+    "@modelcontextprotocol/client": "2.0.0",
     "@modelcontextprotocol/inspector": "2.1.0",
     "@types/express": "5.0.6",
     "@types/fontkit": "2.0.9",
     "@types/node": "22.20.1",
     "@types/pixelmatch": "5.2.6",
-    "@vitest/coverage-v8": "4.1.10",
+    "@vitest/coverage-v8": "4.1.11",
     "ajv": "8.20.0",
     "ajv-formats": "3.0.1",
     "eslint": "10.8.1",
@@ -125,14 +134,14 @@
     "tsx": "4.23.11",
     "typescript": "6.0.3",
     "typescript-eslint": "8.66.0",
-    "vitest": "4.1.10"
+    "vitest": "4.1.11"
   },
   "overrides": {
     "@hono/node-server": "2.1.0",
     "brace-expansion": "5.0.9",
     "fast-uri": "3.1.7",
     "qs": "6.16.0",
-    "hono": "4.13.1",
+    "hono": "4.13.8",
     "nanoid": "3.3.18",
     "ip-address": "10.4.0",
     "postcss": "8.5.26",

package/schemas/configuration.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v3.0.9/schemas/configuration.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v3.2.0/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/v3.0.9/schemas/continuous-focus-palette.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v3.2.0/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/v3.0.9/schemas/custom-weighted-pool.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v3.2.0/schemas/custom-weighted-pool.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

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

@@ -0,0 +1,290 @@
+{
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v3.2.0/schemas/decision-inspect-input.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "workspaceId": {
+      "$ref": "#/$defs/__schema0"
+    },
+    "mode": {
+      "$ref": "#/$defs/__schema1"
+    },
+    "id": {
+      "$ref": "#/$defs/__schema2"
+    },
+    "scenarios": {
+      "$ref": "#/$defs/__schema3"
+    },
+    "proposedSources": {
+      "$ref": "#/$defs/__schema13"
+    },
+    "expectedRevision": {
+      "$ref": "#/$defs/__schema15"
+    },
+    "refresh": {
+      "$ref": "#/$defs/__schema16"
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "__schema0": {
+      "default": "current",
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+    },
+    "__schema1": {
+      "default": "inventory",
+      "type": "string",
+      "enum": [
+        "inventory",
+        "inspect",
+        "compare"
+      ]
+    },
+    "__schema2": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512
+    },
+    "__schema3": {
+      "default": [],
+      "maxItems": 64,
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/__schema4"
+      }
+    },
+    "__schema4": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        },
+        "actor": {
+          "type": "string",
+          "maxLength": 256
+        },
+        "date": {
+          "type": "string",
+          "maxLength": 64
+        },
+        "state": {
+          "$ref": "#/$defs/__schema5"
+        },
+        "flags": {
+          "maxItems": 10000,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/__schema9"
+          }
+        },
+        "eventTargets": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "maxLength": 512
+          },
+          "additionalProperties": {
+            "type": "string",
+            "maxLength": 512
+          }
+        },
+        "scopes": {
+          "type": "object",
+          "propertyNames": {
+            "$ref": "#/$defs/__schema10"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/__schema11"
+          }
+        },
+        "candidateOverrides": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "maxLength": 512
+          },
+          "additionalProperties": {
+            "type": "boolean"
+          }
+        },
+        "closedFlags": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "id",
+        "state"
+      ],
+      "additionalProperties": false
+    },
+    "__schema5": {
+      "type": "object",
+      "propertyNames": {
+        "$ref": "#/$defs/__schema6"
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/__schema7"
+      }
+    },
+    "__schema6": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1024
+    },
+    "__schema7": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/__schema8"
+        },
+        {
+          "maxItems": 10000,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/__schema8"
+          }
+        }
+      ]
+    },
+    "__schema8": {
+      "anyOf": [
+        {
+          "type": "string",
+          "maxLength": 4096
+        },
+        {
+          "type": "number"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "__schema9": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512
+    },
+    "__schema10": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "__schema11": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "country",
+            "state",
+            "character",
+            "unit_leader",
+            "operative",
+            "strategic_region",
+            "province",
+            "unknown"
+          ]
+        },
+        "actor": {
+          "type": "string",
+          "maxLength": 256
+        },
+        "state": {
+          "$ref": "#/$defs/__schema5"
+        },
+        "flags": {
+          "maxItems": 10000,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/__schema12"
+          }
+        },
+        "eventTargets": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "maxLength": 512
+          },
+          "additionalProperties": {
+            "type": "string",
+            "maxLength": 512
+          }
+        },
+        "weight": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "string",
+              "maxLength": 1024
+            }
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "state"
+      ],
+      "additionalProperties": false
+    },
+    "__schema12": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512
+    },
+    "__schema13": {
+      "minItems": 1,
+      "maxItems": 64,
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/__schema14"
+      }
+    },
+    "__schema14": {
+      "type": "object",
+      "properties": {
+        "relativePath": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 1024
+        },
+        "content": {
+          "anyOf": [
+            {
+              "type": "string",
+              "maxLength": 8388608
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "relativePath",
+        "content"
+      ],
+      "additionalProperties": false
+    },
+    "__schema15": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "__schema16": {
+      "default": false,
+      "type": "boolean"
+    }
+  }
+}

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

@@ -1,5 +1,5 @@
 {
-  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v3.0.9/schemas/event-feature-manifest.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v3.2.0/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/v3.0.9/schemas/focus-plan.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v3.2.0/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/v3.0.9/schemas/focus-planning-sidecar.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v3.2.0/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/v3.0.9/schemas/gui-animation-source.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v3.2.0/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/v3.0.9/schemas/gui-helper.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v3.2.0/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/v3.0.9/schemas/gui-scenario.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v3.2.0/schemas/gui-scenario.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "properties": {

package/schemas/helper-expansion-request.schema.json

@@ -0,0 +1,44 @@
+{
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v3.2.0/schemas/helper-expansion-request.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "rootIds": {
+      "minItems": 1,
+      "maxItems": 2000,
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/__schema0"
+      }
+    },
+    "maxDepth": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 256
+    },
+    "maxRecords": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 5000
+    },
+    "maxWork": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 100000
+    },
+    "continuationUri": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 8192,
+      "pattern": "^hoi4-agent:\\/\\/"
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "__schema0": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1024
+    }
+  }
+}

package/schemas/helper-expansion-summary.schema.json

@@ -0,0 +1,70 @@
+{
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v3.2.0/schemas/helper-expansion-summary.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "complete": {
+      "type": "boolean"
+    },
+    "finished": {
+      "type": "boolean"
+    },
+    "sourceComplete": {
+      "type": "boolean"
+    },
+    "maxDepth": {
+      "$ref": "#/$defs/__schema0"
+    },
+    "records": {
+      "$ref": "#/$defs/__schema0"
+    },
+    "totalRecords": {
+      "$ref": "#/$defs/__schema0"
+    },
+    "work": {
+      "$ref": "#/$defs/__schema0"
+    },
+    "totalWork": {
+      "$ref": "#/$defs/__schema0"
+    },
+    "completedRoots": {
+      "$ref": "#/$defs/__schema0"
+    },
+    "totalRoots": {
+      "$ref": "#/$defs/__schema0"
+    },
+    "cycles": {
+      "$ref": "#/$defs/__schema0"
+    },
+    "depthStops": {
+      "$ref": "#/$defs/__schema0"
+    },
+    "continuationUri": {
+      "type": "string",
+      "maxLength": 8192,
+      "pattern": "^hoi4-agent:\\/\\/"
+    }
+  },
+  "required": [
+    "complete",
+    "finished",
+    "sourceComplete",
+    "maxDepth",
+    "records",
+    "totalRecords",
+    "work",
+    "totalWork",
+    "completedRoots",
+    "totalRoots",
+    "cycles",
+    "depthStops"
+  ],
+  "additionalProperties": false,
+  "$defs": {
+    "__schema0": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 9007199254740991
+    }
+  }
+}