cwtools-shared 0.1.0 → 0.2.0

package/dist/generated/mcpTools.d.ts

@@ -317,7 +317,7 @@ export declare const GENERATED_MCP_TOOLS: readonly [{
             readonly properties: {
                 readonly section: {
                     readonly type: "string";
-                    readonly enum: readonly ["summary", "routing", "directories", "localisation", "identifiers", "validation", "promptCards", "all"];
+                    readonly enum: readonly ["summary", "routing", "directories", "localisation", "identifiers", "validation", "compatibility", "promptCards", "all"];
                     readonly description: "Targeted profile section to return. Default summary. Use all only when you need the whole profile.";
                 };
                 readonly mode: {
@@ -450,7 +450,11 @@ export declare const GENERATED_MCP_TOOLS: readonly [{
                 };
                 readonly includeReferences: {
                     readonly type: "boolean";
-                    readonly description: "If true, include lightweight cross-file reference contexts captured by the index. Default false.";
+                    readonly description: "Include lightweight cross-file reference contexts. Default false.";
+                };
+                readonly includeAssetChain: {
+                    readonly type: "boolean";
+                    readonly description: "Check bounded GUI/GFX/model targets, path case, and DDS frame layout.";
                 };
                 readonly limit: {
                     readonly type: "number";
@@ -471,7 +475,7 @@ export declare const GENERATED_MCP_TOOLS: readonly [{
 }, {
     readonly tool: {
         readonly name: "explore_pdx_project";
-        readonly description: "Primary semantic exploration entry point for large Paradox projects. Queries the live CWTools type/reference graph and returns bounded entry points, typed nodes, dependency edges, file facts, provenance, truncation, and freshness without scanning or reading whole files. Use this FIRST for questions such as how an entity is connected, what calls or references an ID, what a file depends on, or what may be affected by a change. Follow with exact query_rules/query_scope/query_types/get_pdx_block checks before writing.";
+        readonly description: "Primary semantic exploration for large Paradox projects: live CWTools type/reference graph with bounded nodes, edges, file facts, provenance and freshness. Use FIRST for connectivity and impact; follow with exact query_rules/query_scope/query_types/get_pdx_block before writing.";
         readonly inputSchema: {
             readonly type: "object";
             readonly properties: {
@@ -513,6 +517,14 @@ export declare const GENERATED_MCP_TOOLS: readonly [{
                     readonly type: "boolean";
                     readonly description: "Include documentation, variables, event targets, and block metadata. Default true.";
                 };
+                readonly relationshipKinds: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly enum: readonly ["inline_invocation", "inline_expansion"];
+                    };
+                    readonly description: "Extra graph kinds: inline_invocation or inline_expansion.";
+                };
             };
             readonly required: readonly [];
         };
@@ -525,6 +537,103 @@ export declare const GENERATED_MCP_TOOLS: readonly [{
         readonly riskLevel: 0;
         readonly concurrencyClass: "lsp-limited";
     };
+}, {
+    readonly tool: {
+        readonly name: "query_inline_instantiation";
+        readonly description: "Preview one inline_script template instantiation: parameters, arguments, expanded symbol, and problems (missing/unused/unresolved). Precise template path or file+line only; no whole-project expansion. Use before editing a template or caller.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly template: {
+                    readonly type: "string";
+                    readonly description: "Template path, e.g. common/inline_scripts/example.txt.";
+                };
+                readonly file: {
+                    readonly type: "string";
+                    readonly description: "Caller file; narrows to one invocation.";
+                };
+                readonly line: {
+                    readonly type: "number";
+                    readonly description: "Caller line; combined with file selects one invocation.";
+                };
+                readonly limit: {
+                    readonly type: "number";
+                    readonly description: "Maximum invocations to return. Default 50, max 200.";
+                };
+            };
+            readonly required: readonly [];
+        };
+    };
+    readonly registry: {
+        readonly name: "query_inline_instantiation";
+        readonly isWrite: false;
+        readonly isReadOnly: true;
+        readonly effect: "workspace_read";
+        readonly riskLevel: 0;
+        readonly concurrencyClass: "lsp-limited";
+    };
+}, {
+    readonly tool: {
+        readonly name: "analyze_pdx_flow";
+        readonly description: "Static cost model and gameplay relations for a file or definition: traversals (every_*/while), pulse handlers, nested fan-out, and typed edges (tech prerequisites, special project events, megastructure upgrades). Relative weights only.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly file: {
+                    readonly type: "string";
+                    readonly description: "Optional file path to analyze; when omitted a definitionId must be given.";
+                };
+                readonly definitionId: {
+                    readonly type: "string";
+                    readonly description: "Optional exact definition ID; combined with file to scope the analysis.";
+                };
+                readonly entityType: {
+                    readonly type: "string";
+                    readonly description: "Optional exact CWTools entity type; use with definitionId to disambiguate duplicate IDs.";
+                };
+                readonly limit: {
+                    readonly type: "number";
+                    readonly description: "Maximum costs and relations returned per collection. Default 100, max 500.";
+                };
+            };
+            readonly required: readonly [];
+        };
+    };
+    readonly registry: {
+        readonly name: "analyze_pdx_flow";
+        readonly isWrite: false;
+        readonly isReadOnly: true;
+        readonly effect: "workspace_read";
+        readonly riskLevel: 0;
+        readonly concurrencyClass: "lsp-limited";
+    };
+}, {
+    readonly tool: {
+        readonly name: "compare_definition_with_vanilla";
+        readonly description: "Field-level diff of one definition against its vanilla counterpart: added, removed and modified fields with stable source locations. Accepts exact entityType + symbolId only; returns the resolved winner and never fabricates a conclusion when the winner is ambiguous. Use before editing any file that overrides vanilla.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly entityType: {
+                    readonly type: "string";
+                    readonly description: "Exact CWTools type name (e.g. event, technology, ship_size).";
+                };
+                readonly symbolId: {
+                    readonly type: "string";
+                    readonly description: "Exact definition ID shared by workspace and vanilla candidates.";
+                };
+            };
+            readonly required: readonly ["entityType", "symbolId"];
+        };
+    };
+    readonly registry: {
+        readonly name: "compare_definition_with_vanilla";
+        readonly isWrite: false;
+        readonly isReadOnly: true;
+        readonly effect: "workspace_read";
+        readonly riskLevel: 0;
+        readonly concurrencyClass: "lsp-limited";
+    };
 }, {
     readonly tool: {
         readonly name: "query_localisation_index";
@@ -552,6 +661,26 @@ export declare const GENERATED_MCP_TOOLS: readonly [{
                     readonly type: "boolean";
                     readonly description: "Only applies to prefix/contains searches. Default false.";
                 };
+                readonly includeDuplicates: {
+                    readonly type: "boolean";
+                    readonly description: "Include per-key duplicate groups with all occurrences (file/line), so duplicate keys are auditable instead of trusting the last write. Default false.";
+                };
+                readonly compareLanguages: {
+                    readonly type: "boolean";
+                    readonly description: "Include true missing/extra key-set differences per language, independent of result truncation. Default false.";
+                };
+                readonly referenceLanguage: {
+                    readonly type: "string";
+                    readonly description: "Reference language for missing/extra differences. Defaults to l_english when indexed.";
+                };
+                readonly referenceStatus: {
+                    readonly type: "boolean";
+                    readonly description: "Include bounded LSP reference status and origin; dynamic keys remain uncertain.";
+                };
+                readonly auditMode: {
+                    readonly type: "boolean";
+                    readonly description: "Include authoritative CWTools localisation diagnostics: completely missing script-referenced keys, inline/dynamic-key provenance, and localisation command/scope issues.";
+                };
                 readonly limit: {
                     readonly type: "number";
                     readonly description: "Maximum entries to return. Default 20, max 100.";

package/dist/generated/mcpTools.js

@@ -368,6 +368,7 @@ exports.GENERATED_MCP_TOOLS = [
                             "localisation",
                             "identifiers",
                             "validation",
+                            "compatibility",
                             "promptCards",
                             "all"
                         ],
@@ -527,7 +528,11 @@ exports.GENERATED_MCP_TOOLS = [
                     },
                     "includeReferences": {
                         "type": "boolean",
-                        "description": "If true, include lightweight cross-file reference contexts captured by the index. Default false."
+                        "description": "Include lightweight cross-file reference contexts. Default false."
+                    },
+                    "includeAssetChain": {
+                        "type": "boolean",
+                        "description": "Check bounded GUI/GFX/model targets, path case, and DDS frame layout."
                     },
                     "limit": {
                         "type": "number",
@@ -549,7 +554,7 @@ exports.GENERATED_MCP_TOOLS = [
     {
         "tool": {
             "name": "explore_pdx_project",
-            "description": "Primary semantic exploration entry point for large Paradox projects. Queries the live CWTools type/reference graph and returns bounded entry points, typed nodes, dependency edges, file facts, provenance, truncation, and freshness without scanning or reading whole files. Use this FIRST for questions such as how an entity is connected, what calls or references an ID, what a file depends on, or what may be affected by a change. Follow with exact query_rules/query_scope/query_types/get_pdx_block checks before writing.",
+            "description": "Primary semantic exploration for large Paradox projects: live CWTools type/reference graph with bounded nodes, edges, file facts, provenance and freshness. Use FIRST for connectivity and impact; follow with exact query_rules/query_scope/query_types/get_pdx_block before writing.",
             "inputSchema": {
                 "type": "object",
                 "properties": {
@@ -590,6 +595,17 @@ exports.GENERATED_MCP_TOOLS = [
                     "includeMetadata": {
                         "type": "boolean",
                         "description": "Include documentation, variables, event targets, and block metadata. Default true."
+                    },
+                    "relationshipKinds": {
+                        "type": "array",
+                        "items": {
+                            "type": "string",
+                            "enum": [
+                                "inline_invocation",
+                                "inline_expansion"
+                            ]
+                        },
+                        "description": "Extra graph kinds: inline_invocation or inline_expansion."
                     }
                 },
                 "required": []
@@ -604,6 +620,109 @@ exports.GENERATED_MCP_TOOLS = [
             "concurrencyClass": "lsp-limited"
         }
     },
+    {
+        "tool": {
+            "name": "query_inline_instantiation",
+            "description": "Preview one inline_script template instantiation: parameters, arguments, expanded symbol, and problems (missing/unused/unresolved). Precise template path or file+line only; no whole-project expansion. Use before editing a template or caller.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "template": {
+                        "type": "string",
+                        "description": "Template path, e.g. common/inline_scripts/example.txt."
+                    },
+                    "file": {
+                        "type": "string",
+                        "description": "Caller file; narrows to one invocation."
+                    },
+                    "line": {
+                        "type": "number",
+                        "description": "Caller line; combined with file selects one invocation."
+                    },
+                    "limit": {
+                        "type": "number",
+                        "description": "Maximum invocations to return. Default 50, max 200."
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "query_inline_instantiation",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "lsp-limited"
+        }
+    },
+    {
+        "tool": {
+            "name": "analyze_pdx_flow",
+            "description": "Static cost model and gameplay relations for a file or definition: traversals (every_*/while), pulse handlers, nested fan-out, and typed edges (tech prerequisites, special project events, megastructure upgrades). Relative weights only.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "file": {
+                        "type": "string",
+                        "description": "Optional file path to analyze; when omitted a definitionId must be given."
+                    },
+                    "definitionId": {
+                        "type": "string",
+                        "description": "Optional exact definition ID; combined with file to scope the analysis."
+                    },
+                    "entityType": {
+                        "type": "string",
+                        "description": "Optional exact CWTools entity type; use with definitionId to disambiguate duplicate IDs."
+                    },
+                    "limit": {
+                        "type": "number",
+                        "description": "Maximum costs and relations returned per collection. Default 100, max 500."
+                    }
+                },
+                "required": []
+            }
+        },
+        "registry": {
+            "name": "analyze_pdx_flow",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "lsp-limited"
+        }
+    },
+    {
+        "tool": {
+            "name": "compare_definition_with_vanilla",
+            "description": "Field-level diff of one definition against its vanilla counterpart: added, removed and modified fields with stable source locations. Accepts exact entityType + symbolId only; returns the resolved winner and never fabricates a conclusion when the winner is ambiguous. Use before editing any file that overrides vanilla.",
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "entityType": {
+                        "type": "string",
+                        "description": "Exact CWTools type name (e.g. event, technology, ship_size)."
+                    },
+                    "symbolId": {
+                        "type": "string",
+                        "description": "Exact definition ID shared by workspace and vanilla candidates."
+                    }
+                },
+                "required": [
+                    "entityType",
+                    "symbolId"
+                ]
+            }
+        },
+        "registry": {
+            "name": "compare_definition_with_vanilla",
+            "isWrite": false,
+            "isReadOnly": true,
+            "effect": "workspace_read",
+            "riskLevel": 0,
+            "concurrencyClass": "lsp-limited"
+        }
+    },
     {
         "tool": {
             "name": "query_localisation_index",
@@ -631,6 +750,26 @@ exports.GENERATED_MCP_TOOLS = [
                         "type": "boolean",
                         "description": "Only applies to prefix/contains searches. Default false."
                     },
+                    "includeDuplicates": {
+                        "type": "boolean",
+                        "description": "Include per-key duplicate groups with all occurrences (file/line), so duplicate keys are auditable instead of trusting the last write. Default false."
+                    },
+                    "compareLanguages": {
+                        "type": "boolean",
+                        "description": "Include true missing/extra key-set differences per language, independent of result truncation. Default false."
+                    },
+                    "referenceLanguage": {
+                        "type": "string",
+                        "description": "Reference language for missing/extra differences. Defaults to l_english when indexed."
+                    },
+                    "referenceStatus": {
+                        "type": "boolean",
+                        "description": "Include bounded LSP reference status and origin; dynamic keys remain uncertain."
+                    },
+                    "auditMode": {
+                        "type": "boolean",
+                        "description": "Include authoritative CWTools localisation diagnostics: completely missing script-referenced keys, inline/dynamic-key provenance, and localisation command/scope issues."
+                    },
                     "limit": {
                         "type": "number",
                         "description": "Maximum entries to return. Default 20, max 100."

package/dist/host/indexing.d.ts

@@ -28,6 +28,11 @@ export interface LocalisationIndexQuery {
     prefix?: boolean;
     contains?: boolean;
     caseSensitive?: boolean;
+    includeDuplicates?: boolean;
+    compareLanguages?: boolean;
+    referenceLanguage?: string;
+    referenceStatus?: boolean;
+    auditMode?: boolean;
     limit?: number;
 }
 export interface LocalisationIndexEntry {

package/dist/project/knowledge.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.queryProjectKnowledgeWithHost = queryProjectKnowledgeWithHost;
 const path = __importStar(require("path"));
 const KNOWLEDGE_DIR = path.join('.cwtools', 'project', 'knowledge');
+const CURRENT_KNOWLEDGE_SCHEMA_VERSION = 7;
 function asRecord(value) {
     return value && typeof value === 'object' && !Array.isArray(value)
         ? value
@@ -44,19 +45,6 @@ function asRecord(value) {
 function stringArray(value) {
     return Array.isArray(value) ? value.filter((item) => typeof item === 'string') : [];
 }
-function tokensFor(args) {
-    return [args.intent ?? '', ...(args.identifiers ?? []), ...(args.entityTypes ?? [])]
-        .join(' ')
-        .toLowerCase()
-        .match(/[@a-z0-9_.:-]{2,}/g)
-        ?.slice(0, 30) ?? [];
-}
-function score(value, tokens) {
-    if (tokens.length === 0)
-        return 1;
-    const text = JSON.stringify(value).toLowerCase();
-    return tokens.reduce((total, token) => total + (text.includes(token) ? 3 : 0), 0);
-}
 async function readJson(host, filePath) {
     const read = await host.filesystem.readTextFile(filePath);
     if (!read.exists)
@@ -69,19 +57,9 @@ async function readJson(host, filePath) {
     }
 }
 async function queryProjectKnowledgeWithHost(host, args = {}) {
-    let root = path.join(host.workspaceRoot, KNOWLEDGE_DIR);
-    let manifestPath = path.join(root, 'manifest.json');
-    let manifest = await readJson(host, manifestPath);
-    if (!manifest) {
-        const legacyRoot = path.join(host.workspaceRoot, '.cwtools-ai', 'project', 'knowledge');
-        const legacyManifestPath = path.join(legacyRoot, 'manifest.json');
-        const legacyManifest = await readJson(host, legacyManifestPath);
-        if (legacyManifest) {
-            root = legacyRoot;
-            manifestPath = legacyManifestPath;
-            manifest = legacyManifest;
-        }
-    }
+    const root = path.join(host.workspaceRoot, KNOWLEDGE_DIR);
+    const manifestPath = path.join(root, 'manifest.json');
+    const manifest = await readJson(host, manifestPath);
     if (!manifest) {
         return {
             ok: false,
@@ -98,8 +76,30 @@ async function queryProjectKnowledgeWithHost(host, args = {}) {
             },
         };
     }
-    if (Number(manifest.schemaVersion) >= 2) {
-        const database = asRecord(manifest.database);
+    const database = asRecord(manifest.database);
+    const foundSchemaVersion = Number(database.schemaVersion ?? manifest.schemaVersion) || 0;
+    if (Number(manifest.schemaVersion) !== CURRENT_KNOWLEDGE_SCHEMA_VERSION
+        || foundSchemaVersion !== CURRENT_KNOWLEDGE_SCHEMA_VERSION) {
+        return {
+            ok: false,
+            status: 'stale',
+            source: 'cwtools-project-knowledge-sqlite',
+            error: {
+                code: 'knowledge_schema_obsolete',
+                message: `Project knowledge schema V${foundSchemaVersion} is obsolete. Rebuild it with the current V${CURRENT_KNOWLEDGE_SCHEMA_VERSION} extension.`,
+            },
+            data: {
+                status: 'stale',
+                manifestPath,
+                rebuildRequired: true,
+                foundSchemaVersion,
+                currentSchemaVersion: CURRENT_KNOWLEDGE_SCHEMA_VERSION,
+                staleReasons: ['schema_version_obsolete'],
+                _hint: 'Run /init or reopen the project and wait for the automatic full rebuild. Old database schemas are not queried.',
+            },
+        };
+    }
+    {
         const relativeDatabasePath = typeof database.path === 'string' && database.path.trim()
             ? database.path
             : 'knowledge.sqlite';
@@ -143,67 +143,4 @@ async function queryProjectKnowledgeWithHost(host, args = {}) {
             },
         };
     }
-    const manifestDomains = stringArray(manifest.domains);
-    const domains = (args.domains?.length ? args.domains : manifestDomains)
-        .map(value => value.trim().toLowerCase())
-        .filter(Boolean)
-        .slice(0, 12);
-    const tokens = tokensFor(args);
-    const limit = Math.max(1, Math.min(Number(args.limit ?? 80) || 80, 300));
-    const evidence = [];
-    const capabilities = [];
-    for (const domain of domains) {
-        const capability = await readJson(host, path.join(root, 'capabilities', `${domain}.json`));
-        if (!capability)
-            continue;
-        capabilities.push({ domain, summary: capability.summary, evidencePolicy: capability.evidencePolicy });
-        const candidates = [];
-        if (Array.isArray(capability.definitions))
-            candidates.push(...capability.definitions.map(asRecord));
-        if (args.includeProjectPatterns !== false && Array.isArray(capability.projectExamples))
-            candidates.push(...capability.projectExamples.map(asRecord));
-        if (args.includeVanillaArchetypes !== false && Array.isArray(capability.vanillaArchetypes))
-            candidates.push(...capability.vanillaArchetypes.map(asRecord));
-        if (args.includeTopology !== false) {
-            const topology = asRecord(capability.topology);
-            if (Array.isArray(topology.edges))
-                candidates.push(...topology.edges.map(asRecord));
-        }
-        evidence.push(...candidates
-            .map(item => ({ ...item, domain, score: score(item, tokens) }))
-            .filter(item => tokens.length === 0 || Number(item.score) > 0)
-            .sort((a, b) => Number(b.score) - Number(a.score))
-            .slice(0, Math.max(5, Math.ceil(limit / Math.max(1, domains.length)))));
-    }
-    const unresolvedFile = args.includeUnresolved === false
-        ? undefined
-        : await readJson(host, path.join(root, 'unresolved.json'));
-    const unresolved = Array.isArray(unresolvedFile?.entries)
-        ? unresolvedFile.entries.map(asRecord).slice(0, 100)
-        : [];
-    const manifestStatus = String(manifest.status ?? 'stale');
-    const staleReasons = stringArray(manifest.staleReasons);
-    const ready = manifestStatus === 'ready' && staleReasons.length === 0;
-    return {
-        ok: true,
-        status: ready ? 'ready' : 'stale',
-        source: 'cwtools-project-knowledge',
-        data: {
-            status: ready ? 'ready' : 'stale',
-            manifestPath,
-            generatedAt: manifest.generatedAt,
-            game: manifest.game,
-            graphVersion: manifest.graphVersion,
-            staleReasons,
-            domains,
-            capabilities,
-            evidence: evidence.slice(0, limit),
-            unresolved,
-            requiredNextChecks: [
-                'Use query_cwt_schema/query_rules/query_scope for legality before writing.',
-                'Use query_override_modes for target directories with vanilla definitions.',
-                'Read exact source blocks before approving a complex blueprint.',
-            ],
-        },
-    };
 }

package/dist/project/profile.d.ts

@@ -2,21 +2,31 @@ import type { HostServices } from '../host/hostServices';
 import type { SharedToolResult } from '../tools/schema';
 export type AgentMode = 'build' | 'plan' | 'explore' | 'general' | 'utility' | 'review' | 'gui_expert' | 'script_reviewer' | 'loc_translator' | 'loc_writer' | 'orchestrator' | 'script';
 export interface QueryProjectProfileArgs {
-    section?: 'summary' | 'routing' | 'directories' | 'localisation' | 'identifiers' | 'validation' | 'promptCards' | 'all';
+    section?: 'summary' | 'routing' | 'directories' | 'localisation' | 'identifiers' | 'validation' | 'compatibility' | 'promptCards' | 'all';
     mode?: AgentMode | 'asset';
 }
 export interface ProjectProfile {
-    schemaVersion: 1;
+    schemaVersion: 2;
     generatedAt: string;
     workspaceRoot: string;
     workspaceKind: string;
     projectName: string;
+    /** True when a schemaVersion 1 profile was read and normalized. */
+    legacyProfile?: boolean;
     game: {
         id: string;
         displayName: string;
         confidence: 'high' | 'medium' | 'low';
         evidence: string[];
     };
+    modInfo?: {
+        name?: string;
+        version?: string;
+        tags?: string[];
+        supportedVersion?: string;
+        remoteFileId?: string;
+        dependencies?: string[];
+    };
     keyDirectories: Array<{
         key: string;
         path: string;
@@ -26,12 +36,16 @@ export interface ProjectProfile {
     localisation: {
         roots: string[];
         languages: string[];
+        defaultLanguage?: string;
         encoding: string;
+        encodingByLanguage?: Record<string, string>;
         sampleFiles: string[];
     };
     identifiers: Record<string, unknown>;
     routing: Record<string, unknown>;
     validation: Record<string, unknown>;
+    freshness?: Record<string, unknown>;
+    warnings?: string[];
     promptCards: Partial<Record<AgentMode | 'asset', string>>;
     efficiencyHints: string[];
     [key: string]: unknown;

package/dist/project/profile.js

@@ -60,7 +60,7 @@ function getProjectProfilePath(workspaceRoot) {
 function isProjectProfile(value) {
     return !!value
         && typeof value === 'object'
-        && value.schemaVersion === 1
+        && (value.schemaVersion === 1 || value.schemaVersion === 2)
         && typeof value.projectName === 'string';
 }
 function buildProfileSummary(profile) {
@@ -69,10 +69,11 @@ function buildProfileSummary(profile) {
         ? profile.identifiers.namespaces.slice(0, 8).join(', ') || 'none'
         : 'none';
     const languages = profile.localisation.languages.join(', ') || 'unknown';
+    const supportedVersion = typeof profile.modInfo?.supportedVersion === 'string' ? ` (${profile.modInfo.supportedVersion})` : '';
     return [
         `Project: ${profile.projectName}`,
         `Kind: ${profile.workspaceKind}`,
-        `Game: ${profile.game.displayName}`,
+        `Game: ${profile.game.displayName}${supportedVersion}`,
         `Key dirs: ${dirs}`,
         `Namespaces: ${namespaces}`,
         `Localisation: ${languages} (${profile.localisation.encoding})`,
@@ -96,6 +97,13 @@ function selectProfileSection(profile, section) {
         case 'localisation': return profile.localisation;
         case 'identifiers': return profile.identifiers;
         case 'validation': return profile.validation;
+        case 'compatibility': return {
+            supportedVersion: profile.modInfo?.supportedVersion,
+            remoteFileId: profile.modInfo?.remoteFileId,
+            dependencies: profile.modInfo?.dependencies ?? [],
+            vanillaCache: profile.validation?.vanillaCache,
+            game: profile.game,
+        };
         case 'promptCards': return profile.promptCards;
         case 'all': return profile;
         case 'summary':
@@ -104,7 +112,10 @@ function selectProfileSection(profile, section) {
                 workspaceKind: profile.workspaceKind,
                 projectName: profile.projectName,
                 game: profile.game,
+                supportedVersion: profile.modInfo?.supportedVersion,
                 generatedAt: profile.generatedAt,
+                freshness: profile.freshness,
+                warnings: profile.warnings ?? [],
                 efficiencyHints: profile.efficiencyHints,
             };
     }
@@ -137,7 +148,7 @@ async function queryProjectProfileWithHost(host, args = {}) {
                 source: 'cwtools-shared',
                 error: {
                     code: 'invalid_profile',
-                    message: 'Project profile exists but is not schemaVersion 1.',
+                    message: 'Project profile exists but is not a valid schemaVersion 1 or 2 profile.',
                 },
             };
         }

package/dist/tools/names.d.ts

@@ -1,6 +1,6 @@
-export declare const MCP_TOOL_NAMES: readonly ["query_types", "query_rules", "query_cwt_schema", "search_rule_capabilities", "explain_scope", "parse_pdx_fragment", "query_scope", "get_diagnostics", "analyze_diagnostic_error", "query_project_profile", "query_project_knowledge", "query_workspace_index", "explore_pdx_project", "query_localisation_index", "get_pdx_block", "get_completion_at", "document_symbols", "workspace_symbols", "query_definition", "query_definition_by_name", "query_references", "query_scripted_effects", "query_scripted_triggers", "query_enums", "query_static_modifiers", "query_variables", "get_entity_info", "query_shader_symbol", "query_shader_compile_unit", "query_shader_platform_variants", "query_shader_callers", "explain_shader_reachability", "validate_shader", "compare_shader_with_vanilla"];
+export declare const MCP_TOOL_NAMES: readonly ["query_types", "query_rules", "query_cwt_schema", "search_rule_capabilities", "explain_scope", "parse_pdx_fragment", "query_scope", "get_diagnostics", "analyze_diagnostic_error", "query_project_profile", "query_project_knowledge", "query_workspace_index", "explore_pdx_project", "query_inline_instantiation", "analyze_pdx_flow", "compare_definition_with_vanilla", "query_localisation_index", "get_pdx_block", "get_completion_at", "document_symbols", "workspace_symbols", "query_definition", "query_definition_by_name", "query_references", "query_scripted_effects", "query_scripted_triggers", "query_enums", "query_static_modifiers", "query_variables", "get_entity_info", "query_shader_symbol", "query_shader_compile_unit", "query_shader_platform_variants", "query_shader_callers", "explain_shader_reachability", "validate_shader", "compare_shader_with_vanilla"];
 export type McpToolName = typeof MCP_TOOL_NAMES[number];
 export declare const MCP_WRITE_TOOL_NAMES: readonly [];
-export declare const MCP_READONLY_TOOL_NAMES: readonly ["query_types", "query_rules", "query_cwt_schema", "search_rule_capabilities", "explain_scope", "parse_pdx_fragment", "query_scope", "get_diagnostics", "analyze_diagnostic_error", "query_project_profile", "query_project_knowledge", "query_workspace_index", "explore_pdx_project", "query_localisation_index", "get_pdx_block", "get_completion_at", "document_symbols", "workspace_symbols", "query_definition", "query_definition_by_name", "query_references", "query_scripted_effects", "query_scripted_triggers", "query_enums", "query_static_modifiers", "query_variables", "get_entity_info", "query_shader_symbol", "query_shader_compile_unit", "query_shader_platform_variants", "query_shader_callers", "explain_shader_reachability", "validate_shader", "compare_shader_with_vanilla"];
+export declare const MCP_READONLY_TOOL_NAMES: readonly ["query_types", "query_rules", "query_cwt_schema", "search_rule_capabilities", "explain_scope", "parse_pdx_fragment", "query_scope", "get_diagnostics", "analyze_diagnostic_error", "query_project_profile", "query_project_knowledge", "query_workspace_index", "explore_pdx_project", "query_inline_instantiation", "analyze_pdx_flow", "compare_definition_with_vanilla", "query_localisation_index", "get_pdx_block", "get_completion_at", "document_symbols", "workspace_symbols", "query_definition", "query_definition_by_name", "query_references", "query_scripted_effects", "query_scripted_triggers", "query_enums", "query_static_modifiers", "query_variables", "get_entity_info", "query_shader_symbol", "query_shader_compile_unit", "query_shader_platform_variants", "query_shader_callers", "explain_shader_reachability", "validate_shader", "compare_shader_with_vanilla"];
 export declare function isMcpToolName(value: string): value is McpToolName;
 export declare function isMcpWriteToolName(value: string): value is typeof MCP_WRITE_TOOL_NAMES[number];

package/dist/tools/names.js

@@ -17,6 +17,9 @@ exports.MCP_TOOL_NAMES = [
     'query_project_knowledge',
     'query_workspace_index',
     'explore_pdx_project',
+    'query_inline_instantiation',
+    'analyze_pdx_flow',
+    'compare_definition_with_vanilla',
     'query_localisation_index',
     'get_pdx_block',
     'get_completion_at',

package/dist/tools/toolHandlers.js

@@ -108,17 +108,83 @@ const defaultSharedToolDispatcher = async (host, name, rawArgs) => {
                 args.maxEdges ?? 80,
                 args.includeMetadata !== false,
             ], 'Start the CWTools LSP process and wait for the game model to load before exploring the semantic graph.');
+        case 'analyze_pdx_flow': {
+            const file = typeof args.file === 'string' ? args.file.trim() : '';
+            const definitionId = typeof args.definitionId === 'string' ? args.definitionId.trim() : '';
+            if (!file && !definitionId) {
+                return {
+                    ok: false,
+                    status: 'error',
+                    source: 'cwtools-shared',
+                    error: {
+                        code: 'invalid_arguments',
+                        message: 'analyze_pdx_flow requires a file or a definitionId.',
+                    },
+                };
+            }
+            return executeLspTool(host, 'cwtools.ai.analyzePdxFlow', [{
+                    ...(file ? { file } : {}),
+                    ...(definitionId ? { definitionId } : {}),
+                    ...(typeof args.entityType === 'string' && args.entityType.trim() ? { entityType: args.entityType.trim() } : {}),
+                    limit: Math.max(1, Math.min(Number(args.limit ?? 100) || 100, 500)),
+                }], 'Start the CWTools LSP process and wait for the game model to load before analyzing flow cost and gameplay relations.');
+        }
+        case 'compare_definition_with_vanilla': {
+            if (typeof args.entityType !== 'string' || typeof args.symbolId !== 'string' || !args.entityType.trim() || !args.symbolId.trim()) {
+                return {
+                    ok: false,
+                    status: 'error',
+                    source: 'cwtools-shared',
+                    error: {
+                        code: 'invalid_arguments',
+                        message: 'compare_definition_with_vanilla requires entityType and symbolId.',
+                    },
+                };
+            }
+            return executeLspTool(host, 'cwtools.ai.compareDefinitionWithVanilla', [args.entityType.trim(), args.symbolId.trim()], 'Start the CWTools LSP process and wait for the game model to load before comparing the definition with vanilla.');
+        }
+        case 'query_inline_instantiation': {
+            const template = typeof args.template === 'string' ? args.template.trim() : '';
+            const file = typeof args.file === 'string' ? args.file.trim() : '';
+            if (!template && !file) {
+                return {
+                    ok: false,
+                    status: 'error',
+                    source: 'cwtools-shared',
+                    error: {
+                        code: 'invalid_arguments',
+                        message: 'query_inline_instantiation requires a template path or a caller file (optionally with line).',
+                    },
+                };
+            }
+            return executeLspTool(host, 'cwtools.ai.exploreInlineGraph', [{
+                    ...(template ? { template } : {}),
+                    ...(file ? { file } : {}),
+                    ...(Number.isInteger(args.line) ? { line: Number(args.line) } : {}),
+                    limit: Math.max(1, Math.min(Number(args.limit ?? 50) || 50, 200)),
+                }], 'Start the CWTools LSP process and wait for the game model to load before resolving the inline template instantiation.');
+        }
         case 'query_localisation_index': {
             if (!host.indexing) {
                 return (0, schema_1.toolUnavailable)(name, 'Localisation index is not available in this host.', [
                     'Wire an LSP index command or a thin Node index before using this tool for localisation evidence.',
                 ]);
             }
+            const data = await host.indexing.queryLocalisation(args);
+            const semanticAudit = args.auditMode === true
+                ? await executeLspTool(host, 'cwtools.ai.queryLocalisationAudit', [{
+                        ...(typeof args.key === 'string' ? { key: args.key } : {}),
+                        prefix: args.prefix === true,
+                        contains: args.contains === true,
+                        caseSensitive: args.caseSensitive === true,
+                        limit: Math.max(1, Math.min(Number(args.limit ?? 100) || 100, 500)),
+                    }], 'Start the CWTools LSP process and wait for localisation validation before requesting auditMode.')
+                : undefined;
             return {
                 ok: true,
                 status: 'ready',
                 source: 'cwtools-index',
-                data: await host.indexing.queryLocalisation(args),
+                data: semanticAudit ? { ...data, semanticAudit } : data,
             };
         }
         case 'get_diagnostics':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cwtools-shared",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Shared protocol and tool contracts for the CWTools MCP server",
   "license": "MIT",
   "repository": {