hoi4-agent-tools 2.3.3 → 2.3.5

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 2.3.5 - 2026-08-02
+
+- Replaced all-domain scans in focus, map, probability, rewrite validation, and country-asset discovery with domain-specific source inventories.
+- Prevented large unrelated mod files from producing `SCAN_BYTE_LIMIT` errors in otherwise bounded MCP work and added low-ceiling regression coverage.
+
+## 2.3.4 - 2026-07-28
+
+- Bounded large game-backed event scans before workspace-wide lifecycle and helper analysis could exhaust the MCP process and close the stdio transport.
+- Added automatic focused event analysis for large workspaces, explicit deferred-analysis diagnostics, source-profile reporting, and deterministic regression coverage.
+
 ## 2.3.3 - 2026-07-26
 
 - Regenerated the npm lockfile with the pinned release npm so clean installs include the patched optional native runtime packages.

package/dist/hoi4_agent_tools/core/domain-scan-patterns.js

@@ -0,0 +1,66 @@
+import { compareCodeUnits } from './canonical.js';
+function under(roots, glob) {
+    return roots.map((root) => `${root.replaceAll('\\', '/').replace(/\/$/u, '')}/${glob}`);
+}
+function uniquePatterns(patterns) {
+    return [...new Set(patterns)].sort(compareCodeUnits);
+}
+function englishLocalisationPatterns(roots) {
+    return [...under(roots, 'english/**/*.{yml,yaml}'), ...under(roots, '*.{yml,yaml}')];
+}
+/** Sources required to import, link, lint, render, and rewrite focus content. */
+export function focusDomainScanPatterns(workspace) {
+    const roots = workspace.registration.roots;
+    return uniquePatterns([
+        ...under(roots.focus, '**/*.txt'),
+        ...under(roots.focus, '**/*.focus-plan.json'),
+        'common/continuous_focus/**/*.txt',
+        'common/decisions/**/*.txt',
+        'common/ideas/**/*.txt',
+        'common/characters/**/*.txt',
+        'common/scripted_effects/**/*.txt',
+        'common/scripted_triggers/**/*.txt',
+        'common/script_constants/**/*.txt',
+        'common/mtth/**/*.txt',
+        'events/**/*.txt',
+        ...under(roots.interface, '**/*.gfx'),
+        ...under(roots.gfx, '**/*.gfx'),
+        ...englishLocalisationPatterns(roots.localisation),
+    ]);
+}
+/** Weighted source surfaces and shared definitions used by probability analysis. */
+export function probabilityDomainScanPatterns(workspace, sourcePaths = []) {
+    const roots = workspace.registration.roots;
+    const normalizedSourcePaths = sourcePaths.map((sourcePath) => sourcePath.replace(/^.*?:/u, '').replaceAll('\\', '/').replace(/^\.\//u, ''));
+    return uniquePatterns([
+        ...normalizedSourcePaths,
+        ...under(roots.focus, '**/*.txt'),
+        'common/decisions/**/*.txt',
+        'common/technologies/**/*.txt',
+        'common/doctrines/**/*.txt',
+        'common/ai_strategy/**/*.txt',
+        'common/ai_strategy_plans/**/*.txt',
+        'common/ai_focuses/**/*.txt',
+        'common/on_actions/**/*.txt',
+        'common/scripted_effects/**/*.txt',
+        'common/scripted_triggers/**/*.txt',
+        'common/script_constants/**/*.txt',
+        'common/mtth/**/*.txt',
+        'events/**/*.txt',
+    ]);
+}
+/** Text sources needed to discover country flags and leader portraits. */
+export function countryAssetDiscoveryPatterns(workspace) {
+    const roots = workspace.registration.roots;
+    return uniquePatterns([
+        'history/countries/**/*.txt',
+        'common/characters/**/*.txt',
+        'common/scripted_effects/**/*.txt',
+        'events/**/*.txt',
+        ...under(roots.interface, '**/*.gfx'),
+        ...under(roots.gfx, '**/*.gfx'),
+    ]);
+}
+export function exactChangedFilePatterns(relativePaths) {
+    return uniquePatterns(relativePaths.map((relativePath) => relativePath.replaceAll('\\', '/').replace(/^\.\//u, '')));
+}

package/dist/hoi4_agent_tools/event/graph.js

@@ -1571,6 +1571,20 @@ export function buildEventGraph(snapshot, options = {}) {
     graph.stateAccesses = stableUnique(graph.stateAccesses);
     graph.unresolved = stableUnique(graph.unresolved);
     const focused = options.analysisMode === 'focused';
+    if (focused) {
+        graph.unresolved.push({
+            id: 'event-analysis-focused-boundary',
+            kind: 'partial_source',
+            expression: 'workspace-wide event helper projections and lifecycle diagnostics',
+            confidence: 'unresolved',
+            blockers: [
+                {
+                    code: 'EVENT_FOCUSED_ANALYSIS_DEFERRED',
+                    message: 'Large event workspaces defer workspace-wide helper projections and lifecycle passes; direct source evidence remains available.',
+                },
+            ],
+        });
+    }
     const stateLinks = focused ? [] : stateLinksFor(graph, budget);
     if (!focused) {
         duplicateAndReferenceIssues(graph);

package/dist/hoi4_agent_tools/event/service.js

@@ -45,6 +45,9 @@ class BoundedEventFragmentCache {
 function eventGraphCacheKey(workspaceId, projectHelpers, analysisMode = 'full') {
     return `${workspaceId}\0${projectHelpers ? 'expanded' : 'structural'}\0${analysisMode}`;
 }
+function isGameBackedWorkspace(workspace) {
+    return workspace.roots.some(({ kind }) => kind === 'game');
+}
 const serviceState = new WeakMap();
 const EVENT_GRAPH_ARTIFACT_MAX_BYTES = 67_108_864;
 const EVENT_GRAPH_ARTIFACT_MAX_CHUNKS = 1_024;
@@ -77,6 +80,7 @@ export function eventScanReport(graph, fullGraphRecordLimit = EVENT_SCAN_FULL_GR
         graphSummary: {
             schemaVersion: graph.schemaVersion,
             parserVersion: graph.parserVersion,
+            analysisMode: graph.analysisMode ?? 'full',
             workspaceId: graph.workspaceId,
             workspaceIdentity: graph.workspaceIdentity,
             revision: graph.revision,
@@ -122,6 +126,7 @@ function cachedEventGraphHash(graph, signal) {
         ? hashCanonical({
             schemaVersion: graph.schemaVersion,
             parserVersion: graph.parserVersion,
+            analysisMode: graph.analysisMode ?? 'full',
             workspaceIdentity: graph.workspaceIdentity,
             revision: graph.revision,
             statistics: graph.statistics,
@@ -146,9 +151,12 @@ function sharedState(engine) {
 function engineGeneration(engine, workspaceId) {
     return engine.generation(workspaceId);
 }
-function eventScanPatterns(workspace) {
+function eventScanPatterns(workspace, focused = false) {
     const roots = workspace.registration.roots;
     const under = (values, glob) => values.map((root) => `${root.replaceAll('\\', '/').replace(/\/$/u, '')}/${glob}`);
+    if (focused) {
+        return ['events/**/*.txt', 'common/on_actions/**/*.txt'].sort(compareCodeUnits);
+    }
     return [
         'events/**/*.txt',
         'history/countries/**/*.txt',
@@ -171,13 +179,16 @@ function eventScanPatterns(workspace) {
         ...under(roots.localisation, '*.{yml,yaml}'),
     ].sort(compareCodeUnits);
 }
-async function scanEventSources(engine, workspaceId, workspace, principal, signal) {
-    const patterns = eventScanPatterns(workspace);
+async function scanEventSources(engine, workspaceId, workspace, focused = false, principal, signal) {
+    const patterns = eventScanPatterns(workspace, focused);
+    const gamePatterns = eventScanPatterns(workspace, focused);
     const sourceKinds = ['mod', 'dependency', 'fixture'];
     const scans = await Promise.all([
         engine.scan(workspaceId, { patterns, rootKinds: sourceKinds }, principal, signal),
         ...(workspace.roots.some(({ kind }) => kind === 'game')
-            ? [engine.scan(workspaceId, { patterns, rootKinds: ['game'] }, principal, signal)]
+            ? [
+                engine.scan(workspaceId, { patterns: gamePatterns, rootKinds: ['game'] }, principal, signal),
+            ]
             : []),
     ]);
     const files = scans.flatMap(({ files }) => files.map((file) => ({ ...file })));
@@ -691,26 +702,32 @@ export class EventChainViewer {
         // principal bypass the resolver check for a later caller.
         const workspace = this.engine.resolver.get(workspaceId, options.principal);
         const generation = engineGeneration(this.engine, workspaceId);
-        const projectHelpers = options.projectHelpers ?? true;
-        const analysisMode = options.analysisMode ?? 'full';
-        const cacheKey = eventGraphCacheKey(workspaceId, projectHelpers, analysisMode);
+        const requestedProjectHelpers = options.projectHelpers ?? true;
+        const requestedAnalysisMode = options.analysisMode ?? 'full';
+        const autoFocused = isGameBackedWorkspace(workspace) && requestedAnalysisMode === 'full';
+        const cacheAnalysisMode = autoFocused ? 'focused' : requestedAnalysisMode;
+        const cacheProjectHelpers = cacheAnalysisMode === 'focused' ? false : requestedProjectHelpers;
+        const cacheKey = eventGraphCacheKey(workspaceId, cacheProjectHelpers, cacheAnalysisMode);
         const cached = this.#state.current.get(cacheKey);
         if (options.refresh !== true && cached?.generation === generation) {
             return cached.graph;
         }
-        const sibling = this.#state.current.get(eventGraphCacheKey(workspaceId, !projectHelpers, analysisMode)) ??
-            this.#state.current.get(eventGraphCacheKey(workspaceId, !projectHelpers)) ??
-            this.#state.current.get(eventGraphCacheKey(workspaceId, projectHelpers));
+        const sibling = this.#state.current.get(eventGraphCacheKey(workspaceId, !cacheProjectHelpers, cacheAnalysisMode)) ??
+            this.#state.current.get(eventGraphCacheKey(workspaceId, requestedProjectHelpers, requestedAnalysisMode)) ??
+            this.#state.current.get(eventGraphCacheKey(workspaceId, !requestedProjectHelpers)) ??
+            this.#state.current.get(eventGraphCacheKey(workspaceId, requestedProjectHelpers));
+        const scanFocused = autoFocused || requestedAnalysisMode === 'focused';
         const snapshot = options.refresh !== true && sibling?.generation === generation
             ? sibling.snapshot
-            : await scanEventSources(this.engine, workspaceId, workspace, options.principal, options.signal);
+            : await scanEventSources(this.engine, workspaceId, workspace, scanFocused, options.principal, options.signal);
         options.signal?.throwIfAborted();
         if (cached?.snapshot.revision === snapshot.revision && cached.generation === generation) {
             return cached.graph;
         }
-        const buildAnalysisMode = analysisMode === 'focused' && snapshot.files.length > EVENT_FOCUSED_GRAPH_FILE_THRESHOLD
+        const buildAnalysisMode = autoFocused || snapshot.files.length > EVENT_FOCUSED_GRAPH_FILE_THRESHOLD
             ? 'focused'
             : 'full';
+        const projectHelpers = buildAnalysisMode === 'focused' ? false : requestedProjectHelpers;
         const graph = buildEventGraph(snapshot, {
             ...(options.signal === undefined ? {} : { signal: options.signal }),
             cache: this.#state.fragments,
@@ -719,7 +736,7 @@ export class EventChainViewer {
             analysisMode: buildAnalysisMode,
         });
         this.#state.current.set(cacheKey, { generation, snapshot, graph });
-        if (analysisMode === 'full')
+        if (buildAnalysisMode === 'full')
             rememberGraph(this.#state, workspaceId, graph);
         return graph;
     }

package/dist/hoi4_agent_tools/mcp/server/base-tools.js

@@ -1,5 +1,6 @@
 import { boundedSourceHashEvidence, publicArtifactLink } from '../../core/artifacts.js';
 import { canonicalJson } from '../../core/canonical.js';
+import { exactChangedFilePatterns, focusDomainScanPatterns, } from '../../core/domain-scan-patterns.js';
 import { ServiceError } from '../../core/result.js';
 import { parseClausewitz } from '../../core/source/index.js';
 import { TRANSACTION_MAX_DIAGNOSTICS } from '../../core/transaction-limits.js';
@@ -35,7 +36,14 @@ function focusReferences(engineSnapshot) {
 }
 export async function postValidateTransaction(engine, transaction, principal, signal) {
     engine.invalidate(transaction.workspaceId);
-    const snapshot = await engine.scan(transaction.workspaceId, {}, principal, signal);
+    const workspace = engine.resolver.get(transaction.workspaceId, principal);
+    const focusTransaction = transaction.operationKind === 'focus-plan-changes' ||
+        transaction.operationKind === 'continuous-focus-plan-changes';
+    const snapshot = await engine.scan(transaction.workspaceId, {
+        patterns: focusTransaction
+            ? focusDomainScanPatterns(workspace)
+            : exactChangedFilePatterns(transaction.files.map(({ relativePath }) => relativePath)),
+    }, principal, signal);
     const changed = new Set(transaction.files.map(({ relativePath }) => sourcePathComparisonKey(relativePath)));
     const diagnostics = snapshot.diagnostics.filter(({ location }) => {
         if (location === undefined)

package/dist/hoi4_agent_tools/mcp/tools/chaosx.js

@@ -3,6 +3,7 @@ import sharp from 'sharp';
 import { z } from 'zod/v4';
 import { publicArtifactLink } from '../../core/artifacts.js';
 import { compareCodeUnits, hashCanonical } from '../../core/canonical.js';
+import { countryAssetDiscoveryPatterns } from '../../core/domain-scan-patterns.js';
 import { emptyServiceResult } from '../../core/result.js';
 import { RenderBudget } from '../../core/render-budget.js';
 import { workspaceIdSchema } from '../../schemas/common.js';
@@ -382,7 +383,8 @@ export function registerChaosxTools(server, engine, context) {
         try {
             const progress = progressReporter(extra);
             await progress.report(0, 3, 'Resolving ChaosX country assets');
-            const snapshot = await engine.scan(workspaceId, {}, context.principal, progress.signal);
+            const discoveryWorkspace = engine.resolver.get(workspaceId, context.principal);
+            const snapshot = await engine.scan(workspaceId, { patterns: countryAssetDiscoveryPatterns(discoveryWorkspace) }, context.principal, progress.signal);
             const tags = [...new Set(input.countryTags)];
             const { selections, catalog } = await selectCountryAssets(engine, snapshot, workspaceId, tags, input.eventId, context, progress.signal);
             await progress.report(1, 3, 'Rasterizing ChaosX country assets');

package/dist/hoi4_agent_tools/mcp/tools/event.js

@@ -122,6 +122,7 @@ const renderHashSchema = z
 const eventInspectOutputSchema = strictOperationResultSchema(z
     .object({
     mode: eventInspectModeSchema,
+    analysisMode: z.enum(['full', 'focused']),
     revision: sha256Schema,
     graphHash: sha256Schema,
     counts: eventGraphCountsSchema,
@@ -131,6 +132,7 @@ const eventInspectOutputSchema = strictOperationResultSchema(z
 const eventRenderOutputSchema = strictOperationResultSchema(z
     .object({
     view: eventRenderViewSchema,
+    analysisMode: z.enum(['full', 'focused']),
     revision: sha256Schema,
     graphHash: sha256Schema,
     layoutHash: sha256Schema,
@@ -223,15 +225,18 @@ function graphCounts(graph, artifacts) {
 }
 function graphValidation(graph) {
     const counts = graphCounts(graph, 0);
+    const focused = graph.analysisMode === 'focused';
     return {
         passed: graph.complete && counts.blockingDiagnostics === 0,
         checks: [
             {
                 id: 'event-analysis',
                 passed: graph.complete && counts.blockingDiagnostics === 0,
-                message: graph.complete
-                    ? `${counts.blockingDiagnostics} blocking event-chain diagnostics; full evidence is linked`
-                    : `${graph.skippedSourceCount} event-analysis source(s) were skipped; full evidence is linked`,
+                message: focused
+                    ? 'Large workspace analysis deferred workspace-wide helper projections and lifecycle passes; direct evidence is linked'
+                    : graph.complete
+                        ? `${counts.blockingDiagnostics} blocking event-chain diagnostics; full evidence is linked`
+                        : `${graph.skippedSourceCount} event-analysis source(s) were skipped; full evidence is linked`,
             },
         ],
     };
@@ -314,6 +319,7 @@ export function registerEventTools(server, engine, context) {
             await progress.report(2, 3, 'Linking complete event analysis');
             const result = emptyServiceResult(workspaceId, {
                 mode: inspected.mode,
+                analysisMode: inspected.graph.analysisMode ?? 'full',
                 revision: inspected.graph.revision,
                 graphHash: inspected.graphHash,
                 counts: graphCounts(inspected.graph, inspected.artifacts.length),
@@ -352,6 +358,7 @@ export function registerEventTools(server, engine, context) {
             await progress.report(2, 3, 'Linking complete event renders');
             const result = emptyServiceResult(workspaceId, {
                 view: rendered.render.view,
+                analysisMode: rendered.graph.analysisMode ?? 'full',
                 revision: rendered.graph.revision,
                 graphHash: rendered.graphHash,
                 layoutHash: rendered.render.layout.layoutHash,

package/dist/hoi4_agent_tools/mcp/tools/focus.js

@@ -1,6 +1,7 @@
 import { z } from 'zod/v4';
 import { boundedSourceHashEvidence, publicArtifactLink } from '../../core/artifacts.js';
 import { compareCodeUnits, canonicalJson, hashCanonical } from '../../core/canonical.js';
+import { focusDomainScanPatterns } from '../../core/domain-scan-patterns.js';
 import { RenderBudget } from '../../core/render-budget.js';
 import { emptyServiceResult, ServiceError } from '../../core/result.js';
 import { parseClausewitz } from '../../core/source/index.js';
@@ -351,9 +352,9 @@ async function executeFocusVisualTool(engine, workbench, context, input, extra,
     try {
         const progress = progressReporter(extra);
         await progress.report(0, 4, 'Importing and indexing focus source');
-        const snapshot = await engine.scan(workspaceId, {}, context.principal, progress.signal);
-        await progress.report(1, 4, 'Focus source index complete');
         const workspace = engine.resolver.get(workspaceId, context.principal);
+        const snapshot = await engine.scan(workspaceId, { patterns: focusDomainScanPatterns(workspace) }, context.principal, progress.signal);
+        await progress.report(1, 4, 'Focus source index complete');
         const renderBudget = new RenderBudget();
         if (input.mode === 'continuous') {
             selectedContinuousFocusFile(snapshot, relativePath);
@@ -610,8 +611,8 @@ export function registerFocusTools(server, engine, context) {
         try {
             const progress = progressReporter(extra);
             await progress.report(0, 3, 'Building shared workspace index');
-            const snapshot = await engine.scan(workspaceId, {}, context.principal, progress.signal);
             const workspace = engine.resolver.get(workspaceId, context.principal);
+            const snapshot = await engine.scan(workspaceId, { patterns: focusDomainScanPatterns(workspace) }, context.principal, progress.signal);
             if (input.mode === 'continuous') {
                 const selectedFiles = activeContinuousFocusFiles(snapshot).filter((file) => relativePath === undefined || file.relativePath === relativePath);
                 if (selectedFiles.length === 0) {
@@ -849,8 +850,8 @@ export function registerFocusTools(server, engine, context) {
             requireServerScope(context, 'hoi4:write');
             const progress = progressReporter(extra);
             await progress.report(0, 5, 'Validating shared index and current source');
-            const snapshot = await engine.scan(workspaceId, {}, context.principal, progress.signal);
             const workspace = engine.resolver.get(workspaceId, context.principal);
+            const snapshot = await engine.scan(workspaceId, { patterns: focusDomainScanPatterns(workspace) }, context.principal, progress.signal);
             if (input.mode === 'continuous') {
                 const plan = input.plan;
                 if (createIfMissing &&

package/dist/hoi4_agent_tools/mcp/tools/map.js

@@ -369,10 +369,8 @@ export function registerMapTools(server, engine, context) {
         try {
             const progress = progressReporter(extra);
             await progress.report(0, 3, 'Inspecting and validating the map');
-            const [shared, { snapshot, validation }] = await Promise.all([
-                engine.scan(workspaceId, {}, context.principal, progress.signal),
-                nudger.validate(workspaceId, context.principal, progress.signal),
-            ]);
+            const { snapshot, validation } = await nudger.validate(workspaceId, context.principal, progress.signal);
+            const sharedRevision = snapshot.revision;
             const selected = selectedMapEntities(snapshot, provinceIds, stateIds, regionIds);
             const provinceGeometry = provinceIds.length === 0
                 ? undefined
@@ -392,7 +390,7 @@ export function registerMapTools(server, engine, context) {
                 schemaVersion: 'map-inspect.v1',
                 sourceHashes: sourceEvidence.bounded.sourceHashes,
                 metadata: {
-                    sharedRevision: shared.revision,
+                    sharedRevision,
                     sourceHashInventory: sourceEvidence.bounded.inventory,
                 },
             };
@@ -403,7 +401,7 @@ export function registerMapTools(server, engine, context) {
                     content: `${canonicalJson({
                         schemaVersion: 1,
                         revision: snapshot.revision,
-                        sharedRevision: shared.revision,
+                        sharedRevision,
                         dimensions: snapshot.index.raster === undefined
                             ? null
                             : {
@@ -471,7 +469,7 @@ export function registerMapTools(server, engine, context) {
             const artifacts = await engine.artifacts.withAtomicChunkedWrites(workspace, artifactWrites, (stored) => Promise.resolve([...stored]), progress.signal);
             const result = emptyServiceResult(workspaceId, {
                 revision: snapshot.revision,
-                sharedRevision: shared.revision,
+                sharedRevision,
                 width: snapshot.index.raster?.width ?? null,
                 height: snapshot.index.raster?.height ?? null,
                 definitions: snapshot.index.definitions.length,

package/dist/hoi4_agent_tools/probability/service.js

@@ -2,6 +2,7 @@ import { readFile } from 'node:fs/promises';
 import path from 'node:path';
 import { canonicalJson, hashCanonical } from '../core/canonical.js';
 import { ClausewitzEvaluationDefinitions } from '../core/clausewitz-evaluation.js';
+import { probabilityDomainScanPatterns } from '../core/domain-scan-patterns.js';
 import { publicArtifactLink } from '../core/artifacts.js';
 import { ServiceError } from '../core/result.js';
 import { PACKAGE_VERSION } from '../version.js';
@@ -590,10 +591,13 @@ export class ProbabilityAnalyzer {
         this.engine = engine;
         this.state = analyzerState(engine);
     }
-    async scan(context) {
+    async scan(context, sourcePaths = []) {
         if (context.refresh === true)
             this.engine.invalidate(context.workspaceId);
-        return this.engine.scan(context.workspaceId, {}, context.principal, context.signal);
+        const workspace = this.engine.resolver.get(context.workspaceId, context.principal);
+        return this.engine.scan(context.workspaceId, {
+            patterns: probabilityDomainScanPatterns(workspace, sourcePaths.filter((sourcePath) => sourcePath !== undefined)),
+        }, context.principal, context.signal);
     }
     async verifyGameVersion(context, adapter) {
         const workspace = this.engine.resolver.get(context.workspaceId, context.principal);
@@ -774,7 +778,7 @@ export class ProbabilityAnalyzer {
         if (adapter === undefined || source === undefined)
             return { adapters: probabilityAdapters(), artifacts: [], filesScanned: [] };
         const gameVersionVerification = await this.verifyGameVersion(context, adapter);
-        const snapshot = await this.scan(context);
+        const snapshot = await this.scan(context, [source.path]);
         const surface = discoverWeightedSurface(snapshot, adapter, source, candidatePool);
         const definitions = ClausewitzEvaluationDefinitions.build(snapshot);
         const inspectedCandidates = evaluateExactCandidates(surface, { id: 'inspection', state: {} }, definitions);
@@ -838,7 +842,7 @@ export class ProbabilityAnalyzer {
             request.scenarioSet.workspaceId !== request.workspaceId)
             throw new ServiceError('PROBABILITY_SCENARIO_WORKSPACE_MISMATCH', 'Scenario set belongs to a different workspace');
         const gameVersionVerification = await this.verifyGameVersion(request, request.adapter);
-        const snapshot = await this.scan(request);
+        const snapshot = await this.scan(request, [request.source.path]);
         const surface = discoverWeightedSurface(snapshot, request.adapter, request.source, request.candidatePool ?? []);
         const definitions = ClausewitzEvaluationDefinitions.build(snapshot);
         const metadata = this.metadata(request, snapshot, surface, request.scenarioSet, request.candidatePool ?? [], gameVersionVerification, {

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.3.3';
+export const PACKAGE_VERSION = '2.3.5';
 export const MCP_PROTOCOL_VERSION = LATEST_PROTOCOL_VERSION;
 export const CONFIG_VERSION = 1;
 export const TRANSACTION_VERSION = 1;

package/docs/events.md

@@ -16,9 +16,9 @@ Use the three event tools directly from the target mod.
 - `lint`: find missing targets, unreachable events, suspicious cycles, conflicting definitions, invalid timing, and unresolved dynamic calls.
 - `impact`: identify callers, descendants, state dependencies, and files affected by a proposed event change.
 
-Use narrow identifiers, direction, and depth limits when the task concerns one chain. Broad scans build the structural event graph without expanding every scripted helper into duplicate paths. Focused trace and path calls traverse helper nodes and collapse only the selected bounded route, while state, impact, and render calls expand helper relationships when their workspace-wide evidence requires it.
+Use narrow identifiers, direction, and depth limits when the task concerns one chain. Broad scans build the structural event graph without expanding every scripted helper into duplicate paths. Game-backed or other large workspaces automatically use a focused source profile containing event definitions and on-actions, then defer workspace-wide helper projections and lifecycle passes. The result is marked partial and records that boundary in the linked evidence instead of waiting until the MCP transport times out. Focused trace and path calls collapse only the selected bounded route.
 
-The compact response summarizes the result. Small scan resources contain the complete graph; very large scan resources contain exact totals, grouped inventories, representative diagnostics, and the revision needed for focused follow-up queries. The viewer retains the complete in-memory graph for those follow-up queries, and the event issue ceiling is high enough for installed-game-scale diagnostic inventories. This keeps an agent's prompt and artifact storage bounded without reducing the results of those focused queries.
+The compact response summarizes the result. Small scan resources contain the complete graph; large scan resources contain exact totals, grouped inventories, representative diagnostics, and the revision needed for focused follow-up queries. Large focused scans keep direct event and on-action evidence, call sites, state accesses, and source locations while leaving helper expansion and workspace-wide lifecycle analysis explicit as deferred boundaries. This keeps an agent's prompt and artifact storage bounded without allowing a broad scan to exhaust the MCP process.
 
 Selectors use one of these forms:
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hoi4-agent-tools",
   "mcpName": "io.github.klimPaskov/hoi4-agent-tools",
-  "version": "2.3.3",
+  "version": "2.3.5",
   "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.3.3/schemas/configuration.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/continuous-focus-palette.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/custom-weighted-pool.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/event-feature-manifest.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/focus-plan.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/focus-planning-sidecar.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/gui-animation-source.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/gui-helper.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/gui-scenario.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/map-operation.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/operation-result.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/probability-analysis-result.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/probability-compare-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/probability-evaluate-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/probability-inspect-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/probability-render-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/probability-scenario-set.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/probability-sequence-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/probability-simulate-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3/schemas/probability-sweep-input.schema.json",
+  "$id": "https://github.com/klimPaskov/hoi4-agent-tools/blob/v2.3.5/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.3.3",
+  "version": "2.3.5",
   "repository": {
     "url": "https://github.com/klimPaskov/hoi4-agent-tools",
     "source": "github"
@@ -13,7 +13,7 @@
     {
       "registryType": "npm",
       "identifier": "hoi4-agent-tools",
-      "version": "2.3.3",
+      "version": "2.3.5",
       "transport": {
         "type": "stdio"
       }