cwtools-mcp 0.2.3 → 0.2.5

package/README.md

@@ -95,9 +95,8 @@ intentionally does not silently fall back to a separate language server.
 
 ### Optional Standalone Mode
 
-Use standalone mode only when you explicitly want the legacy behavior: the MCP
-process starts its own CWTools language server and builds its own diagnostic
-state.
+Use standalone mode only when you explicitly want the MCP process to start its
+own CWTools language server and build an independent diagnostic state.
 
 ```sh
 cwtools-mcp --standalone --workspace /path/to/mod --game stellaris --stdio

package/dist/config.js

@@ -189,7 +189,7 @@ function helpText() {
         '  or --workspace when supplied) must match the bridge workspace exactly. If the',
         '  compatible host is closed or the workspace does not match, tool calls return an',
         '  actionable unavailable error.',
-        '  Use --standalone only when you intentionally want the legacy self-hosted LSP mode.',
+        '  Use --standalone only when you intentionally want the standalone self-hosted LSP mode.',
         '',
         'Vanilla data (needed for vanilla IDs and correct mod-vs-vanilla diagnostics):',
         '  (auto)              If neither flag is given, the VS Code cwtools extension cache',

package/dist/cwtools-mcp.cjs

@@ -197,7 +197,7 @@ ${helpText()}`);
         "  or --workspace when supplied) must match the bridge workspace exactly. If the",
         "  compatible host is closed or the workspace does not match, tool calls return an",
         "  actionable unavailable error.",
-        "  Use --standalone only when you intentionally want the legacy self-hosted LSP mode.",
+        "  Use --standalone only when you intentionally want the standalone self-hosted LSP mode.",
         "",
         "Vanilla data (needed for vanilla IDs and correct mod-vs-vanilla diagnostics):",
         "  (auto)              If neither flag is given, the VS Code cwtools extension cache",
@@ -458,14 +458,16 @@ var require_mcpTools = __commonJS({
             "properties": {
               "file": {
                 "type": "string",
-                "description": "Absolute file path"
+                "description": "Absolute path inside the workspace or a configured game installation."
               },
               "line": {
-                "type": "number",
+                "type": "integer",
+                "minimum": 0,
                 "description": "Line number (0-based)"
               },
               "column": {
-                "type": "number",
+                "type": "integer",
+                "minimum": 0,
                 "description": "Column number (0-based)"
               }
             },
@@ -473,7 +475,8 @@ var require_mcpTools = __commonJS({
               "file",
               "line",
               "column"
-            ]
+            ],
+            "additionalProperties": false
           }
         },
         "registry": {
@@ -558,10 +561,6 @@ var require_mcpTools = __commonJS({
               "toolResult": {
                 "type": "object",
                 "description": "Optional raw failed tool result to classify without querying diagnostics again."
-              },
-              "reflection": {
-                "type": "string",
-                "description": "Optional legacy free-form analysis from the model. Kept for backward compatibility; the host still returns deterministic routing advice."
               }
             },
             "required": []
@@ -579,7 +578,7 @@ var require_mcpTools = __commonJS({
       {
         "tool": {
           "name": "query_project_profile",
-          "description": "Read the /init-generated Agent project profile from .cwtools/project/profile.json. Use this before broad scans to get workspace type, key directories, localisation languages/encoding, namespaces, workflow routing, validation hints, and mode-specific prompt cards.",
+          "description": "Read the /init-generated Agent project profile from .cwtools/project/profile.json. Use this before broad scans to get workspace type, key directories, localisation languages/encoding, namespaces, workflow routing, validation hints, and targeted guidance cards.",
           "inputSchema": {
             "type": "object",
             "properties": {
@@ -593,29 +592,25 @@ var require_mcpTools = __commonJS({
                   "identifiers",
                   "validation",
                   "compatibility",
-                  "promptCards",
+                  "guidanceCards",
                   "all"
                 ],
                 "description": "Targeted profile section to return. Default summary. Use all only when you need the whole profile."
               },
-              "mode": {
+              "guidance": {
                 "type": "string",
                 "enum": [
-                  "build",
-                  "plan",
-                  "explore",
-                  "general",
-                  "utility",
+                  "implementation",
+                  "planning",
+                  "exploration",
                   "review",
-                  "gui_expert",
-                  "script_reviewer",
-                  "loc_translator",
-                  "loc_writer",
-                  "orchestrator",
-                  "script",
-                  "asset"
+                  "utility",
+                  "localisation",
+                  "assets",
+                  "coordination",
+                  "paradox_coordination"
                 ],
-                "description": "Optional mode card to return, e.g. build, plan, loc_writer, asset, orchestrator, script."
+                "description": "Optional guidance card to return for the current task concern."
               }
             },
             "required": []
@@ -788,7 +783,7 @@ var require_mcpTools = __commonJS({
               },
               "file": {
                 "type": "string",
-                "description": "Optional workspace-relative or absolute file path used to restrict entry points."
+                "description": "Optional workspace-relative path or absolute path inside the workspace/configured game installation used to restrict entry points."
               },
               "typeName": {
                 "type": "string",
@@ -857,7 +852,7 @@ var require_mcpTools = __commonJS({
               },
               "file": {
                 "type": "string",
-                "description": "Caller file; narrows to one invocation."
+                "description": "Caller file inside the workspace or a configured game installation; narrows to one invocation."
               },
               "line": {
                 "type": "number",
@@ -883,13 +878,13 @@ var require_mcpTools = __commonJS({
       {
         "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.",
+          "description": "Static flow model for a file or definition: dynamic event subtypes, inline-instantiated state/calls, cross-event and scripted-effect state flow, pulse/on_action/scripted-effect cost propagation, traversals, loops, and typed gameplay edges. Costs are relative static scores, not runtime predictions.",
           "inputSchema": {
             "type": "object",
             "properties": {
               "file": {
                 "type": "string",
-                "description": "Optional file path to analyze; when omitted a definitionId must be given."
+                "description": "Optional path inside the workspace or a configured game installation; when omitted a definitionId must be given."
               },
               "definitionId": {
                 "type": "string",
@@ -1014,13 +1009,13 @@ var require_mcpTools = __commonJS({
       {
         "tool": {
           "name": "get_pdx_block",
-          "description": "Extract exactly one complete AST block by symbol name. Works with .txt (events, common), .gui (containerWindowType by name), and .gfx (pdxmesh by name). Returns 1-based startLine/endLine that can be passed directly to replace_lines. If the symbol is not found, the error response includes a full list of available symbols with line ranges so you can retry with the correct name.",
+          "description": "Extract exactly one complete AST block by symbol name from the workspace or a configured game installation. Works with .txt (events, common), .gui (containerWindowType by name), and .gfx (pdxmesh by name). Returns 1-based startLine/endLine that can be passed directly to replace_lines. If the symbol is not found, the error response includes a full list of available symbols with line ranges so you can retry with the correct name.",
           "inputSchema": {
             "type": "object",
             "properties": {
               "file": {
                 "type": "string",
-                "description": "Absolute file path"
+                "description": "Absolute path inside the workspace or a configured game installation."
               },
               "symbol": {
                 "type": "string",
@@ -1051,7 +1046,7 @@ var require_mcpTools = __commonJS({
             "properties": {
               "file": {
                 "type": "string",
-                "description": "Absolute file path (must be in the workspace)"
+                "description": "Absolute file path inside the workspace or a configured game installation."
               },
               "line": {
                 "type": "number",
@@ -1091,7 +1086,7 @@ var require_mcpTools = __commonJS({
             "properties": {
               "file": {
                 "type": "string",
-                "description": "Absolute file path"
+                "description": "Absolute path inside the workspace or a configured game installation."
               }
             },
             "required": [
@@ -1140,33 +1135,34 @@ var require_mcpTools = __commonJS({
       },
       {
         "tool": {
-          "name": "query_definition",
-          "description": "GoToDefinition at a position, or FindAllRefs if no definition exists. Uses CWTools AST - faster than grep. If you know the symbol name, prefer query_definition_by_name instead.",
+          "name": "go_to_definition",
+          "description": "Find a definition by exact symbol name or by a 0-based file position. Uses CWTools semantic lookup when available and falls back to the active VS Code language provider.",
           "inputSchema": {
             "type": "object",
             "properties": {
+              "symbolName": {
+                "type": "string",
+                "description": "Exact symbol name. Use this instead of file/line/column when the identifier is known."
+              },
               "file": {
                 "type": "string",
-                "description": "Absolute file path"
+                "description": "Absolute file path inside the workspace or a configured game installation."
               },
               "line": {
                 "type": "number",
-                "description": "Line number (0-based)"
+                "description": "Line number (0-based)."
               },
               "column": {
                 "type": "number",
-                "description": "Column number (0-based)"
+                "description": "Column number (0-based)."
               }
             },
-            "required": [
-              "file",
-              "line",
-              "column"
-            ]
+            "required": [],
+            "additionalProperties": false
           }
         },
         "registry": {
-          "name": "query_definition",
+          "name": "go_to_definition",
           "isWrite": false,
           "isReadOnly": true,
           "effect": "workspace_read",
@@ -1176,53 +1172,38 @@ var require_mcpTools = __commonJS({
       },
       {
         "tool": {
-          "name": "query_definition_by_name",
-          "description": "Find where a named symbol is defined - no file/position needed. Returns file path and line number. Works for any top-level PDXScript key (events, triggers, effects, etc.).",
-          "inputSchema": {
-            "type": "object",
-            "properties": {
-              "symbolName": {
-                "type": "string",
-                "description": 'The exact name of the symbol to find (e.g. "kuat_has_psionic_research", "distar.001")'
-              }
-            },
-            "required": [
-              "symbolName"
-            ]
-          }
-        },
-        "registry": {
-          "name": "query_definition_by_name",
-          "isWrite": false,
-          "isReadOnly": true,
-          "effect": "workspace_read",
-          "riskLevel": 0,
-          "concurrencyClass": "parallel"
-        }
-      },
-      {
-        "tool": {
-          "name": "query_references",
-          "description": "Find references to an identifier through the active language provider, with a bounded workspace text-search fallback.",
+          "name": "find_references",
+          "description": "Find references by exact identifier or by a 0-based file position. Identifier lookup uses workspace symbols plus a bounded text fallback; position lookup uses the active VS Code language provider.",
           "inputSchema": {
             "type": "object",
             "properties": {
               "identifier": {
                 "type": "string",
-                "description": "The identifier to search for"
+                "description": "Exact identifier. Use this instead of file/line/column when the name is known."
               },
               "file": {
                 "type": "string",
-                "description": "Optional file to limit search to"
+                "description": "Absolute file path inside the workspace or a configured game installation."
+              },
+              "line": {
+                "type": "number",
+                "description": "Line number (0-based)."
+              },
+              "column": {
+                "type": "number",
+                "description": "Column number (0-based)."
+              },
+              "limit": {
+                "type": "number",
+                "description": "Maximum references to return (default 100, max 500)."
               }
             },
-            "required": [
-              "identifier"
-            ]
+            "required": [],
+            "additionalProperties": false
           }
         },
         "registry": {
-          "name": "query_references",
+          "name": "find_references",
           "isWrite": false,
           "isReadOnly": true,
           "effect": "workspace_read",
@@ -1375,7 +1356,7 @@ var require_mcpTools = __commonJS({
             "properties": {
               "file": {
                 "type": "string",
-                "description": "Absolute file path (must be a parsed mod file)"
+                "description": "Absolute path to a parsed file inside the workspace or a configured game installation."
               }
             },
             "required": [
@@ -1444,7 +1425,7 @@ var require_mcpTools = __commonJS({
             "properties": {
               "file": {
                 "type": "string",
-                "description": "Absolute or workspace-relative path of the .shader/.fxh file."
+                "description": "Workspace-relative path or absolute path inside the workspace/configured game installation."
               }
             },
             "required": [
@@ -1470,7 +1451,7 @@ var require_mcpTools = __commonJS({
             "properties": {
               "file": {
                 "type": "string",
-                "description": "Absolute or workspace-relative path of the .shader/.fxh file."
+                "description": "Workspace-relative path or absolute path inside the workspace/configured game installation."
               }
             },
             "required": [
@@ -1530,7 +1511,7 @@ var require_mcpTools = __commonJS({
               },
               "file": {
                 "type": "string",
-                "description": "Absolute or workspace-relative path of a .shader/.fxh file; lists its Effects with cursor pagination."
+                "description": "Workspace-relative path or absolute path inside the workspace/configured game installation; lists its Effects with cursor pagination."
               },
               "limit": {
                 "type": "number",
@@ -1562,7 +1543,7 @@ var require_mcpTools = __commonJS({
             "properties": {
               "file": {
                 "type": "string",
-                "description": "Absolute or workspace-relative path of the .shader/.fxh file."
+                "description": "Workspace-relative path or absolute path inside the workspace/configured game installation."
               }
             },
             "required": [
@@ -1592,7 +1573,7 @@ var require_mcpTools = __commonJS({
               },
               "file": {
                 "type": "string",
-                "description": "Absolute or workspace-relative path of a .shader/.fxh file."
+                "description": "Workspace-relative path or absolute path inside the workspace/configured game installation."
               }
             },
             "required": []
@@ -1709,10 +1690,9 @@ var require_readiness = __commonJS({
       "parse_pdx_fragment",
       "query_scope",
       "get_completion_at",
-      "query_definition",
-      "query_definition_by_name",
+      "go_to_definition",
       "explore_pdx_project",
-      "query_references",
+      "find_references",
       "get_diagnostics",
       "query_scripted_effects",
       "query_scripted_triggers",
@@ -1787,11 +1767,10 @@ var require_vanillaCache = __commonJS({
       "query_types",
       "get_completion_at",
       "query_scope",
-      "query_definition",
-      "query_definition_by_name",
+      "go_to_definition",
       "explore_pdx_project",
       "query_project_knowledge",
-      "query_references",
+      "find_references",
       "get_diagnostics",
       "query_scripted_effects",
       "query_scripted_triggers",
@@ -1903,7 +1882,7 @@ var require_diagnosticRouting = __commonJS({
         code,
         category: "general",
         explanation: "No specialized diagnostic route matched; use LSP and indexed evidence before editing.",
-        suggestedTools: ["get_diagnostics", "explore_pdx_project", "query_cwt_schema", "query_definition_by_name", "query_workspace_index"],
+        suggestedTools: ["get_diagnostics", "explore_pdx_project", "query_cwt_schema", "go_to_definition", "query_workspace_index"],
         nextSteps: [
           "Group similar diagnostics and inspect a representative block.",
           "Verify identifiers through indexed tools before making changes."
@@ -2015,9 +1994,10 @@ var require_rules = __commonJS({
     async function queryRulesWithHost(host, args) {
       const { cache, meta } = await loadCwtRulesMemoized(host);
       let rules = args.category === "trigger" ? cache.triggers : args.category === "effect" ? cache.effects : args.category === "modifier" ? cache.modifiers : cache.scopeChanges;
+      const dottedScopeChain = args.name && args.category === "scope_change" ? buildDottedScopeChainRule(args.name, args.scope, cache.scopeChanges) : void 0;
       if (args.name) {
-        const needle = args.name.toLowerCase();
-        const filtered = rules.filter((rule) => rule.name.toLowerCase().includes(needle));
+        const needle = normalizeRuleNameQuery(args.name, args.category);
+        const filtered = rules.filter((rule) => rule.name.toLowerCase().includes(needle)).sort((a, b) => scoreRuleNameMatch(a.name, needle) - scoreRuleNameMatch(b.name, needle) || a.name.localeCompare(b.name));
         if (filtered.length === 0 && rules.length > 0) {
           rules = rules.map((rule) => ({ rule, score: levenshtein(needle, rule.name.toLowerCase()) })).sort((a, b) => a.score - b.score).slice(0, 5).map((item) => ({
             ...item.rule,
@@ -2027,6 +2007,12 @@ var require_rules = __commonJS({
           rules = filtered;
         }
       }
+      if (dottedScopeChain) {
+        rules = [
+          dottedScopeChain,
+          ...rules.filter((rule) => rule.name !== dottedScopeChain.name)
+        ];
+      }
       if (args.scope) {
         const scope = args.scope.toLowerCase();
         rules = rules.filter((rule) => rule.scopes.length === 0 || rule.scopes.some((candidate) => {
@@ -2264,13 +2250,41 @@ var require_rules = __commonJS({
     }
     async function findCwtSchemaFiles(host, root, maxFiles) {
       if (host.rules?.listCwtFiles) {
-        return (await host.rules.listCwtFiles(root, { limit: maxFiles })).slice(0, maxFiles);
+        return (await host.rules.listCwtFiles(root, { limit: maxFiles })).slice(0, maxFiles).sort((a, b) => a.localeCompare(b));
+      }
+      if (fs.existsSync(root)) {
+        const results2 = [];
+        const ignoredDirs2 = /* @__PURE__ */ new Set([".git", "node_modules", "logs", "config"]);
+        const walkDisk = (dir, depth) => {
+          if (results2.length >= maxFiles || depth > 8)
+            return;
+          let entries;
+          try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+          } catch {
+            return;
+          }
+          entries.sort((a, b) => a.name.localeCompare(b.name));
+          for (const entry of entries) {
+            if (results2.length >= maxFiles)
+              break;
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+              if (!ignoredDirs2.has(entry.name))
+                walkDisk(fullPath, depth + 1);
+            } else if (entry.isFile() && entry.name.toLowerCase().endsWith(".cwt")) {
+              results2.push(fullPath);
+            }
+          }
+        };
+        walkDisk(root, 0);
+        return results2.sort((a, b) => a.localeCompare(b));
       }
       const rootRelative = workspaceRelativePath(host.workspaceRoot, root);
       if (!rootRelative)
         return [];
       const results = [];
-      const ignoredDirs = /* @__PURE__ */ new Set([".git", "node_modules", "logs"]);
+      const ignoredDirs = /* @__PURE__ */ new Set([".git", "node_modules", "logs", "config"]);
       const walk = async (relativeDir, depth) => {
         if (results.length >= maxFiles || depth > 8)
           return;
@@ -2280,6 +2294,7 @@ var require_rules = __commonJS({
         } catch {
           return;
         }
+        entries.sort((a, b) => a.name.localeCompare(b.name));
         for (const entry of entries) {
           if (results.length >= maxFiles)
             break;
@@ -2294,7 +2309,16 @@ var require_rules = __commonJS({
         }
       };
       await walk(rootRelative, 0);
-      return results;
+      return results.sort((a, b) => a.localeCompare(b));
+    }
+    async function collectCwtRuleSourceFiles(host, root, includeMissingLogs) {
+      const files = await findCwtSchemaFiles(host, root, CWT_RULE_FILE_SCAN_LIMIT);
+      for (const relativeLog of CWT_RULE_LOG_CANDIDATES) {
+        const fullPath = path.join(root, relativeLog);
+        if (includeMissingLogs || fs.existsSync(fullPath))
+          files.push(fullPath);
+      }
+      return Array.from(new Set(files)).sort((a, b) => a.localeCompare(b));
     }
     function workspaceRelativePath(workspaceRoot, fullPath) {
       const relative = path.relative(workspaceRoot, fullPath);
@@ -2627,29 +2651,19 @@ var require_rules = __commonJS({
         score += 20;
       return score;
     }
-    var CWT_RULE_FILE_CANDIDATES = [
-      "scopes.cwt",
+    var CWT_RULE_LOG_CANDIDATES = [
       path.join("logs", "trigger_docs.log"),
-      path.join("logs", "modifiers.log"),
-      "triggers.cwt",
-      "trigger.cwt",
-      path.join("generated", "triggers.generated.cwt"),
-      "effects.cwt",
-      "effect.cwt",
-      path.join("generated", "effects.generated.cwt"),
-      "modifier.cwt",
-      "scope_changes.cwt",
-      path.join("generated", "scope_changes.generated.cwt")
+      path.join("logs", "modifiers.log")
     ];
+    var CWT_RULE_FILE_SCAN_LIMIT = 5e3;
     var CWT_RULES_MEMO_MAX_ENTRIES = 8;
     var CWT_RULES_MEMO_REFRESH_MS = 3e4;
     var cwtRulesMemo = /* @__PURE__ */ new Map();
-    function computeRulesSignature(configPaths) {
+    async function computeRulesSignature(host, configPaths) {
       const parts = [];
       let sawDiskFiles = false;
       for (const configPath of configPaths) {
-        for (const file of CWT_RULE_FILE_CANDIDATES) {
-          const fullPath = path.join(configPath, file);
+        for (const fullPath of await collectCwtRuleSourceFiles(host, configPath, true)) {
           try {
             const stat = fs.statSync(fullPath);
             parts.push(`${fullPath}:${stat.mtimeMs}:${stat.size}`);
@@ -2664,8 +2678,8 @@ var require_rules = __commonJS({
     async function computeRulesContentHash(host, configPaths) {
       const hash = crypto2.createHash("sha256");
       for (const configPath of configPaths) {
-        for (const file of CWT_RULE_FILE_CANDIDATES) {
-          const read = await readRulesTextFile(host, path.join(configPath, file)).catch(() => ({ exists: false, content: "", hasBom: false }));
+        for (const file of await collectCwtRuleSourceFiles(host, configPath, true)) {
+          const read = await readRulesTextFile(host, file).catch(() => ({ exists: false, content: "", hasBom: false }));
           if (!read.exists)
             continue;
           hash.update(`${read.content.length}:`);
@@ -2680,7 +2694,7 @@ var require_rules = __commonJS({
     async function loadCwtRulesMemoized(host) {
       const configPaths = await resolveRulesConfigPaths(host);
       const hostKey = cwtRulesHostKey(host);
-      const { signature, sawDiskFiles } = computeRulesSignature(configPaths);
+      const { signature, sawDiskFiles } = await computeRulesSignature(host, configPaths);
       const memo = cwtRulesMemo.get(hostKey);
       if (memo && memo.signature === signature && (memo.sawDiskFiles || host.now() - memo.computedAt < CWT_RULES_MEMO_REFRESH_MS)) {
         return { cache: memo.cache, meta: { generation: memo.generation, contentHash: memo.contentHash } };
@@ -2711,10 +2725,25 @@ var require_rules = __commonJS({
         const docs = triggerDocs.exists ? parseDocsLog(triggerDocs.content, path.join(configPath, "logs", "trigger_docs.log")) : /* @__PURE__ */ new Map();
         const scopesRead = await readRulesTextFile(host, path.join(configPath, "scopes.cwt")).catch(() => ({ exists: false, content: "", hasBom: false }));
         const scopes = scopesRead.exists ? parseScopesFile(scopesRead.content, path.join(configPath, "scopes.cwt")) : /* @__PURE__ */ new Map();
-        const triggers = await readRuleFiles(host, configPath, ["triggers.cwt", "trigger.cwt", path.join("generated", "triggers.generated.cwt")], "trigger", docs, scopes);
-        const effects = await readRuleFiles(host, configPath, ["effects.cwt", "effect.cwt", path.join("generated", "effects.generated.cwt")], "effect", docs, scopes);
-        const scopeChanges = await readRuleFiles(host, configPath, ["scope_changes.cwt", path.join("generated", "scope_changes.generated.cwt")], "scope_change", docs, scopes);
-        const modifierAliases = await readRuleFiles(host, configPath, ["modifier.cwt"], "modifier", docs, scopes);
+        const triggers = [];
+        const effects = [];
+        const scopeChanges = [];
+        const modifierAliases = [];
+        for (const file of await findCwtSchemaFiles(host, configPath, CWT_RULE_FILE_SCAN_LIMIT)) {
+          const relativeFile = path.relative(configPath, file).replace(/\\/g, "/");
+          const parsed = await readRulesFile(host, file, scopeChangeFileCategoryOverride(relativeFile), docs, scopes);
+          for (const rule of parsed) {
+            if (rule.category === "trigger")
+              triggers.push(rule);
+            else if (rule.category === "effect")
+              effects.push(rule);
+            else if (rule.category === "modifier")
+              modifierAliases.push(rule);
+            else
+              scopeChanges.push(rule);
+          }
+          scopeChanges.push(...await readLinksFile(host, file, scopes));
+        }
         const modifierLog = await readModifiersLog(host, path.join(configPath, "logs", "modifiers.log"));
         const modifiers = [...modifierAliases];
         const modifierNames = new Set(modifiers.map((rule) => rule.name.toLowerCase()));
@@ -2768,12 +2797,8 @@ var require_rules = __commonJS({
       return normalizeGameId(game.id);
     }
     async function readProjectProfileFile(host) {
-      let profilePath = path.join(host.workspaceRoot, ".cwtools", "project", "profile.json");
-      let read = await host.filesystem.readTextFile(profilePath).catch(() => ({ exists: false, content: "", hasBom: false }));
-      if (!read.exists) {
-        const legacyPath = path.join(host.workspaceRoot, ".cwtools-ai", "project", "profile.json");
-        read = await host.filesystem.readTextFile(legacyPath).catch(() => ({ exists: false, content: "", hasBom: false }));
-      }
+      const profilePath = path.join(host.workspaceRoot, ".cwtools", "project", "profile.json");
+      const read = await host.filesystem.readTextFile(profilePath).catch(() => ({ exists: false, content: "", hasBom: false }));
       if (!read.exists)
         return null;
       try {
@@ -2798,19 +2823,16 @@ var require_rules = __commonJS({
         return host.rules.readTextFile(filePath);
       return host.filesystem.readTextFile(filePath);
     }
-    async function readRuleFiles(host, configPath, relativeFiles, category, docs, scopes) {
-      const rules = [];
-      for (const relativeFile of relativeFiles) {
-        rules.push(...await readRulesFile(host, path.join(configPath, relativeFile), category, docs, scopes));
-      }
-      return rules;
-    }
     async function readRulesFile(host, filePath, category, docs, scopes) {
       const read = await readRulesTextFile(host, filePath).catch(() => ({ exists: false, content: "", hasBom: false }));
       if (!read.exists)
         return [];
       return parseCwtFile(read.content, filePath, category, docs, scopes);
     }
+    function scopeChangeFileCategoryOverride(relativeRuleFile) {
+      const base = path.posix.basename(relativeRuleFile.replace(/\\/g, "/")).toLowerCase();
+      return base === "scope_changes.cwt" || base === "scope_changes.generated.cwt" || base === "scope_change.cwt" ? "scope_change" : void 0;
+    }
     async function readModifiersLog(host, filePath) {
       const read = await readRulesTextFile(host, filePath).catch(() => ({ exists: false, content: "", hasBom: false }));
       if (!read.exists)
@@ -2921,7 +2943,7 @@ var require_rules = __commonJS({
       }
       return scopes;
     }
-    function parseCwtFile(content, filePath, category, docs, scopes) {
+    function parseCwtFile(content, filePath, categoryOverride, docs, scopes) {
       const results = [];
       let currentScopes = [];
       let currentSupportedScopes = [];
@@ -2966,13 +2988,15 @@ var require_rules = __commonJS({
             currentDesc = comment;
           continue;
         }
-        const nameMatch = line.match(/^alias\[(?:trigger|effect|modifier):([^\]]+)\]\s*=\s*(.*)/);
-        if (nameMatch?.[1]) {
-          const name = nameMatch[1];
+        const nameMatch = line.match(/^alias\[(trigger|effect|modifier):([^\]]+)\]\s*=\s*(.*)/);
+        if (nameMatch?.[1] && nameMatch[2]) {
+          const aliasKind = nameMatch[1];
+          const category = categoryOverride ?? aliasKind;
+          const name = nameMatch[2];
           const doc = docs.get(name);
           const cwtBlockText = collectCwtBlockText(lines, i);
           const scopesForRule = doc?.scopes.length ? doc.scopes : currentSupportedScopes.length ? currentSupportedScopes : currentScopes;
-          const syntax = doc?.syntax || normalizeInlineSyntax(name, nameMatch[2] ?? "");
+          const syntax = doc?.syntax || normalizeInlineSyntax(name, nameMatch[3] ?? "");
           const description = doc?.description || currentDesc;
           const semanticHints = buildSemanticHints({
             description,
@@ -3016,6 +3040,91 @@ var require_rules = __commonJS({
       }
       return results;
     }
+    async function readLinksFile(host, filePath, scopes) {
+      const read = await readRulesTextFile(host, filePath).catch(() => ({ exists: false, content: "", hasBom: false }));
+      if (!read.exists || !/^\s*links\s*=\s*\{/im.test(read.content))
+        return [];
+      return parseLinksCwtFile(read.content, filePath, scopes);
+    }
+    function parseLinksCwtFile(content, filePath, scopes) {
+      const results = [];
+      const lines = content.split(/\r?\n/);
+      let inLinks = false;
+      let depth = 0;
+      let current;
+      for (let i = 0; i < lines.length; i++) {
+        const rawLine = lines[i] ?? "";
+        const line = stripCwtLineComment(rawLine).trim();
+        if (!inLinks) {
+          if (/^links\s*=\s*\{/.test(line)) {
+            inLinks = true;
+            depth = countBraceDelta(line);
+          }
+          continue;
+        }
+        if (!current && depth === 1) {
+          const linkMatch = line.match(/^([A-Za-z_][\w.-]*)\s*=\s*\{\s*$/);
+          if (linkMatch?.[1])
+            current = { name: linkMatch[1], line: i + 1, inputScopes: [] };
+        } else if (current) {
+          const inputMatch = line.match(/^input_scopes\s*=\s*(.*)$/i);
+          if (inputMatch?.[1])
+            current.inputScopes = splitRuleValueList(inputMatch[1]).map(normalizeScopeName);
+          const outputMatch = line.match(/^output_scope\s*=\s*(.*)$/i);
+          if (outputMatch?.[1]) {
+            const outputScope = stripRuleValueBraces(outputMatch[1]).split(/\s+/)[0];
+            if (outputScope)
+              current.outputScope = normalizeScopeName(outputScope);
+          }
+        }
+        depth += countBraceDelta(line);
+        if (current && depth <= 1) {
+          if (current.outputScope) {
+            const inputScopes = current.inputScopes.length ? current.inputScopes : ["all"];
+            const syntax = `${current.name} = scope link (${inputScopes.join(" | ")} -> ${current.outputScope})`;
+            const linkHint = {
+              text: `Legal scope link '${current.name}' accepts input scopes { ${inputScopes.join(" ")} } and outputs '${current.outputScope}'. Context pointers such as from/prev/root/this select the current input scope; they are not fixed object fields.`,
+              source: "links.cwt",
+              file: filePath,
+              line: current.line,
+              confidence: "hint"
+            };
+            const scopeHints = buildSemanticHints({
+              description: "",
+              cwtDescription: "",
+              scopes,
+              relatedScopeNames: [...inputScopes, current.outputScope],
+              cwtFile: filePath,
+              cwtLine: current.line
+            });
+            results.push({
+              name: current.name,
+              description: `Legal scope link from { ${inputScopes.join(" ")} } to ${current.outputScope}.`,
+              scopes: inputScopes,
+              syntax,
+              category: "scope_change",
+              sourceFile: filePath,
+              sourceLine: current.line,
+              hardFacts: {
+                category: "scope_change",
+                supportedScopes: inputScopes,
+                pushScope: current.outputScope,
+                valueReferences: [],
+                syntax,
+                cwtSource: { file: filePath, line: current.line }
+              },
+              semanticHints: [linkHint, ...scopeHints].slice(0, 8)
+            });
+          }
+          current = void 0;
+        }
+        if (inLinks && depth <= 0) {
+          inLinks = false;
+          current = void 0;
+        }
+      }
+      return results;
+    }
     function buildSemanticHints(args) {
       const hints = [];
       const seen = /* @__PURE__ */ new Set();
@@ -3157,7 +3266,12 @@ var require_rules = __commonJS({
         [/触发器|觸發器/g, ["trigger"]],
         [/效果|效应|效應/g, ["effect"]]
       ];
-      const expanded = [...direct];
+      const expanded = [];
+      for (const token of direct) {
+        expanded.push(token);
+        if (/[.:]/.test(token))
+          expanded.push(...token.split(/[.:]+/).filter(Boolean));
+      }
       for (const [pattern, tokens] of synonyms) {
         pattern.lastIndex = 0;
         if (pattern.test(intent))
@@ -3233,6 +3347,94 @@ var require_rules = __commonJS({
     function stripRuleValueBraces(value) {
       return value.replace(/^\{\s*/, "").replace(/\s*\}$/, "").trim();
     }
+    function normalizeRuleNameQuery(name, category) {
+      const lowered = name.trim().toLowerCase();
+      if (category !== "scope_change" || !lowered.includes("."))
+        return lowered;
+      const parts = lowered.split(".").map((part) => part.trim()).filter(Boolean);
+      return parts[parts.length - 1] ?? lowered;
+    }
+    function buildDottedScopeChainRule(query, contextScope, scopeChanges) {
+      const rawParts = query.trim().split(".").map(normalizeScopeName).filter(Boolean);
+      if (rawParts.length < 2)
+        return void 0;
+      const contextPointers = /* @__PURE__ */ new Set(["from", "prev", "root", "this"]);
+      const first = rawParts[0];
+      const startsWithPointer = contextPointers.has(first);
+      const initialScope = startsWithPointer ? contextScope?.trim().toLowerCase() : first;
+      const linkNames = rawParts.slice(1);
+      if (!initialScope || linkNames.length === 0)
+        return void 0;
+      const hops = [];
+      let currentScope = initialScope;
+      for (const linkName of linkNames) {
+        const link = scopeChanges.find((rule) => rule.name.toLowerCase() === linkName && !!rule.hardFacts?.pushScope && scopeListContains(rule.hardFacts.supportedScopes ?? rule.scopes, currentScope));
+        const outputScope = link?.hardFacts?.pushScope?.trim().toLowerCase();
+        if (!link || !outputScope)
+          return void 0;
+        hops.push({ link, inputScope: currentScope, outputScope });
+        currentScope = outputScope;
+      }
+      if (hops.length === 0)
+        return void 0;
+      const normalizedQuery = rawParts.join(".");
+      const syntax = `${normalizedQuery} = { ... }`;
+      const source = hops[0].link;
+      const hopText = hops.map((hop) => `${hop.inputScope}.${hop.link.name} -> ${hop.outputScope}`).join("; ");
+      const linkHints = hops.map((hop) => ({
+        text: `Dotted scope chain hop '${hop.inputScope}.${hop.link.name}' is legal because links.cwt declares '${hop.link.name}' with input scope '${hop.inputScope}' and output scope '${hop.outputScope}'.`,
+        source: "links.cwt",
+        file: hop.link.sourceFile,
+        line: hop.link.sourceLine,
+        confidence: "hint"
+      }));
+      return {
+        name: normalizedQuery,
+        description: `Legal dotted scope chain from ${initialScope} to ${currentScope}. Hops: ${hopText}.`,
+        scopes: [initialScope],
+        syntax,
+        category: "scope_change",
+        sourceFile: source.sourceFile,
+        sourceLine: source.sourceLine,
+        hardFacts: {
+          category: "scope_change",
+          supportedScopes: [initialScope],
+          pushScope: currentScope,
+          valueReferences: [],
+          syntax,
+          cwtSource: source.sourceFile && source.sourceLine ? { file: source.sourceFile, line: source.sourceLine } : void 0
+        },
+        semanticHints: linkHints.slice(0, 8)
+      };
+    }
+    function scopeListContains(scopes, scope) {
+      const lowerScope = scope.toLowerCase();
+      return scopes.some((candidate) => {
+        const lower = candidate.toLowerCase();
+        return lower === lowerScope || lower === "all" || lower === "any";
+      });
+    }
+    function scoreRuleNameMatch(name, needle) {
+      const lower = name.toLowerCase();
+      if (lower === needle)
+        return 0;
+      if (lower.startsWith(needle))
+        return 1;
+      return 2;
+    }
+    function normalizeScopeName(scope) {
+      return scope.replace(/^["']|["']$/g, "").trim().toLowerCase();
+    }
+    function countBraceDelta(line) {
+      let delta = 0;
+      for (const ch of line) {
+        if (ch === "{")
+          delta += 1;
+        else if (ch === "}")
+          delta -= 1;
+      }
+      return delta;
+    }
     function splitWords(value) {
       return value.split(/\s+/).map((part) => part.trim()).filter(Boolean);
     }
@@ -3280,7 +3482,7 @@ var require_workflowHints = __commonJS({
             id: "entity-lookup",
             title: "Verify game identifiers",
             triggers: ["identifier", "reference", "definition", "entity"],
-            recommendedTools: ["query_project_knowledge", "explore_pdx_project", "query_cwt_schema", "search_rule_capabilities", "query_rules", "query_types", "query_workspace_index", "query_definition_by_name"],
+            recommendedTools: ["query_project_knowledge", "explore_pdx_project", "query_cwt_schema", "search_rule_capabilities", "query_rules", "query_types", "query_workspace_index", "go_to_definition"],
             guardrails: ["Treat empty text search results as inconclusive without indexed verification.", "Treat semanticHints as retrieval hints, not legality proof."]
           }
         ]
@@ -3335,27 +3537,16 @@ var require_profile = __commonJS({
     exports2.getProjectProfilePath = getProjectProfilePath;
     exports2.isProjectProfile = isProjectProfile;
     exports2.buildProfileSummary = buildProfileSummary;
-    exports2.getPromptCardForMode = getPromptCardForMode;
+    exports2.getGuidanceCard = getGuidanceCard;
     exports2.selectProfileSection = selectProfileSection;
     exports2.queryProjectProfileWithHost = queryProjectProfileWithHost;
     var path = __importStar(require("path"));
     exports2.PROJECT_PROFILE_RELATIVE_PATH = path.join(".cwtools", "project", "profile.json");
     function getProjectProfilePath(workspaceRoot) {
-      try {
-        const fs = require("fs");
-        const primary = path.join(workspaceRoot, ".cwtools", "project", "profile.json");
-        if (fs.existsSync(primary))
-          return primary;
-        const legacy = path.join(workspaceRoot, ".cwtools-ai", "project", "profile.json");
-        if (fs.existsSync(legacy))
-          return legacy;
-        return primary;
-      } catch {
-        return path.join(workspaceRoot, exports2.PROJECT_PROFILE_RELATIVE_PATH);
-      }
+      return path.join(workspaceRoot, exports2.PROJECT_PROFILE_RELATIVE_PATH);
     }
     function isProjectProfile(value) {
-      return !!value && typeof value === "object" && (value.schemaVersion === 1 || value.schemaVersion === 2) && typeof value.projectName === "string";
+      return !!value && typeof value === "object" && value.schemaVersion === 4 && typeof value.projectName === "string";
     }
     function buildProfileSummary(profile) {
       const dirs = profile.keyDirectories.filter((dir) => dir.exists).map((dir) => dir.path).slice(0, 8).join(", ") || "none";
@@ -3371,16 +3562,10 @@ var require_profile = __commonJS({
         `Localisation: ${languages} (${profile.localisation.encoding})`
       ].join("\n");
     }
-    function getPromptCardForMode(profile, mode) {
-      if (!mode)
+    function getGuidanceCard(profile, guidance) {
+      if (!guidance)
         return void 0;
-      if (mode === "loc_translator" || mode === "loc_writer")
-        return profile.promptCards.loc_writer ?? profile.promptCards.build;
-      if (mode === "gui_expert")
-        return profile.promptCards.asset ?? profile.promptCards.build;
-      if (mode === "script_reviewer")
-        return profile.promptCards.review;
-      return profile.promptCards[mode] ?? profile.promptCards.build;
+      return profile.guidanceCards[guidance] ?? profile.guidanceCards.implementation;
     }
     function selectProfileSection(profile, section) {
       switch (section) {
@@ -3402,8 +3587,8 @@ var require_profile = __commonJS({
             vanillaCache: profile.validation?.vanillaCache,
             game: profile.game
           };
-        case "promptCards":
-          return profile.promptCards;
+        case "guidanceCards":
+          return profile.guidanceCards;
         case "all":
           return profile;
         case "summary":
@@ -3448,7 +3633,7 @@ var require_profile = __commonJS({
             source: "cwtools-shared",
             error: {
               code: "invalid_profile",
-              message: "Project profile exists but is not a valid schemaVersion 1 or 2 profile."
+              message: "Project profile exists but is not a valid schemaVersion 4 profile."
             }
           };
         }
@@ -3465,8 +3650,8 @@ var require_profile = __commonJS({
             profile: section === "all" ? parsed : void 0,
             summary: buildProfileSummary(parsed),
             data: selectProfileSection(parsed, section),
-            promptCard: getPromptCardForMode(parsed, args.mode),
-            _hint: 'Use section="routing", "localisation", "identifiers", or a mode-specific promptCard for targeted context.'
+            guidanceCard: getGuidanceCard(parsed, args.guidance),
+            _hint: 'Use section="routing", "localisation", "identifiers", or a targeted guidance card for focused context.'
           }
         };
       } catch (error) {
@@ -3717,7 +3902,7 @@ var require_paths = __commonJS({
     }
     function isScratchRelativePath(relativePath) {
       const parts = relativePath.replace(/\\/g, "/").toLowerCase().split("/");
-      return parts.includes(".cwtools") || parts.includes(".cwtools-ai");
+      return parts.includes(".cwtools");
     }
     function validateLocalisationPath(workspaceRoot, inputPath) {
       const resolution = resolveWorkspacePath(workspaceRoot, inputPath);
@@ -3821,9 +4006,8 @@ var require_names = __commonJS({
       "get_completion_at",
       "document_symbols",
       "workspace_symbols",
-      "query_definition",
-      "query_definition_by_name",
-      "query_references",
+      "go_to_definition",
+      "find_references",
       "query_scripted_effects",
       "query_scripted_triggers",
       "query_enums",
@@ -4203,7 +4387,11 @@ var require_symbols = __commonJS({
       };
     }
     async function queryDefinitionWithHost(host, args) {
-      const resolution = resolveReadableFile(host, args.file);
+      const file = String(args.file ?? "").trim();
+      if (!file || !Number.isInteger(args.line) || args.line < 0 || !Number.isInteger(args.column) || args.column < 0) {
+        return (0, schema_1.toolDenied)("invalid_arguments", "go_to_definition requires symbolName or a non-negative file position.");
+      }
+      const resolution = resolveReadableFile(host, file);
       if ("error" in resolution)
         return resolution.error;
       const fileUri = toFileUri(resolution.resolvedPath);
@@ -4232,7 +4420,7 @@ var require_symbols = __commonJS({
     async function queryDefinitionByNameWithHost(host, args) {
       const symbolName = String(args.symbolName ?? "").trim();
       if (!symbolName)
-        return (0, schema_1.toolDenied)("invalid_arguments", "query_definition_by_name requires symbolName.");
+        return (0, schema_1.toolDenied)("invalid_arguments", "go_to_definition requires symbolName or a file position.");
       const commandResult = await host.lsp.executeCommand("cwtools.ai.queryDefinitionByName", [symbolName], { timeoutMs: 1e4 });
       if (!isUnavailable(commandResult)) {
         return {
@@ -4258,9 +4446,28 @@ var require_symbols = __commonJS({
     }
     async function queryReferencesWithHost(host, args) {
       const identifier = String(args.identifier ?? "").trim();
-      if (!identifier)
-        return (0, schema_1.toolDenied)("invalid_arguments", "query_references requires identifier.");
       const limit = clampNumber(args.limit, 50, 1, 200);
+      if (!identifier) {
+        if (!args.file || !Number.isInteger(args.line) || (args.line ?? -1) < 0 || !Number.isInteger(args.column) || (args.column ?? -1) < 0) {
+          return (0, schema_1.toolDenied)("invalid_arguments", "find_references requires identifier or file, line, and column.");
+        }
+        const resolution = resolveReadableFile(host, args.file);
+        if ("error" in resolution)
+          return resolution.error;
+        const requested = await requestLsp(host, "textDocument/references", {
+          textDocument: { uri: toFileUri(resolution.resolvedPath) },
+          position: { line: args.line, character: args.column },
+          context: { includeDeclaration: true }
+        }, 1e4);
+        const references2 = normalizeLocations(requested.data, host.workspaceRoot).slice(0, limit);
+        return {
+          ok: !requested.unavailable,
+          status: requested.unavailable ? "unavailable" : "ready",
+          source: "cwtools-lsp-references",
+          data: { references: references2, total: references2.length },
+          error: requested.unavailable ? { code: "lsp_unavailable", message: requested.message ?? "Reference provider is unavailable." } : void 0
+        };
+      }
       const definition = await queryDefinitionByNameWithHost(host, { symbolName: identifier });
       const firstMatch = definition.data && typeof definition.data === "object" ? getFirstDefinitionMatch(definition.data) : void 0;
       if (firstMatch?.file !== void 0 && firstMatch.line !== void 0 && host.lsp.request) {
@@ -4482,12 +4689,12 @@ var require_symbols = __commonJS({
         return "external";
       const normalized = filePath.replace(/\\/g, "/").toLowerCase();
       if ((0, paths_1.isPathInsideOrEqual)(workspaceRoot, filePath)) {
-        return normalized.includes("/generated/") || normalized.includes("/.cwtools/") || normalized.includes("/.cwtools-ai/") ? "generated" : "workspace";
+        return normalized.includes("/generated/") || normalized.includes("/.cwtools/") ? "generated" : "workspace";
       }
       if (normalized.includes("/vanilla/") || normalized.includes("/cache/") || normalized.includes("/steamapps/common/")) {
         return "vanilla";
       }
-      if (normalized.includes("/generated/") || normalized.includes("/.cwtools/") || normalized.includes("/.cwtools-ai/"))
+      if (normalized.includes("/generated/") || normalized.includes("/.cwtools/"))
         return "generated";
       return "external";
     }
@@ -4977,20 +5184,18 @@ var require_toolHandlers = __commonJS({
             query: String(args.query ?? ""),
             limit: typeof args.limit === "number" ? args.limit : void 0
           });
-        case "query_definition":
-          return (0, symbols_1.queryDefinitionWithHost)(host, {
+        case "go_to_definition":
+          return typeof args.symbolName === "string" && args.symbolName.trim() ? (0, symbols_1.queryDefinitionByNameWithHost)(host, { symbolName: args.symbolName }) : (0, symbols_1.queryDefinitionWithHost)(host, {
             file: String(args.file ?? ""),
             line: Number(args.line ?? 0),
             column: Number(args.column ?? 0)
           });
-        case "query_definition_by_name":
-          return (0, symbols_1.queryDefinitionByNameWithHost)(host, {
-            symbolName: String(args.symbolName ?? "")
-          });
-        case "query_references":
+        case "find_references":
           return (0, symbols_1.queryReferencesWithHost)(host, {
-            identifier: String(args.identifier ?? ""),
+            identifier: typeof args.identifier === "string" ? args.identifier : void 0,
             file: typeof args.file === "string" ? args.file : void 0,
+            line: typeof args.line === "number" ? args.line : void 0,
+            column: typeof args.column === "number" ? args.column : void 0,
             limit: typeof args.limit === "number" ? args.limit : void 0
           });
         case "query_scope":
@@ -10392,7 +10597,6 @@ var require_projectSettings = __commonJS({
     }
     var cache = /* @__PURE__ */ new Map();
     var SETTINGS_NAMESPACE = "stellarisLanguageServices";
-    var LEGACY_SETTINGS_NAMESPACE = "cwtools";
     function readSettingsObject(workspaceRoot) {
       const file = path.join(workspaceRoot, ".vscode", "settings.json");
       let mtimeMs;
@@ -10436,8 +10640,7 @@ var require_projectSettings = __commonJS({
       const settings = readSettingsObject(workspaceRoot);
       if (!settings)
         return void 0;
-      const current = resolveDotted(settings, `${SETTINGS_NAMESPACE}.${subKey}`);
-      return current !== void 0 ? current : resolveDotted(settings, `${LEGACY_SETTINGS_NAMESPACE}.${subKey}`);
+      return resolveDotted(settings, `${SETTINGS_NAMESPACE}.${subKey}`);
     }
     function asNonEmptyStringArray(value) {
       return Array.isArray(value) ? value.filter((v) => typeof v === "string" && v.length > 0) : [];
@@ -10745,7 +10948,7 @@ var require_lspProcessHost = __commonJS({
           return;
         const watcher = (0, chokidar_1.watch)(this.options.workspaceRoot, {
           ignoreInitial: true,
-          ignored: [/(^|[\\/])(?:node_modules|\.git|\.cwtools|\.cwtools-ai)(?:[\\/]|$)/],
+          ignored: [/(^|[\\/])(?:node_modules|\.(?!\.)[^\\/]+)(?:[\\/]|$)/],
           awaitWriteFinish: { stabilityThreshold: 120, pollInterval: 30 }
         });
         watcher.on("add", (filePath) => this.queueWatchedFileChange(filePath, 1));
@@ -10927,7 +11130,7 @@ var require_lspProcessHost = __commonJS({
       if (!relative || relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative))
         return false;
       const segments = relative.split(/[\\/]+/).map((segment) => segment.toLowerCase());
-      if (segments.some((segment) => segment === "node_modules" || segment === ".git" || segment === ".cwtools" || segment === ".cwtools-ai"))
+      if (segments.some((segment) => segment === "node_modules" || segment.startsWith(".") && !segment.startsWith("..")))
         return false;
       const extension = path.extname(filePath).toLowerCase();
       if (extension === ".csv" && game && game.toLowerCase() !== "ck2")
@@ -10984,7 +11187,7 @@ var require_projectDetect = __commonJS({
     var path = __importStar(require("path"));
     var ROOT_FILE_MARKERS = ["descriptor.mod"];
     var ROOT_NESTED_FILE_MARKERS = [path.join(".metadata", "metadata.json")];
-    var ROOT_DIR_MARKERS = [".cwtools", ".cwtools-ai"];
+    var ROOT_DIR_MARKERS = [".cwtools"];
     var CONTENT_DIR_MARKERS = ["common", "events", "localisation", "localization"];
     var MAX_ANCESTORS = 6;
     var MAX_CHILDREN = 64;
@@ -11129,7 +11332,7 @@ var require_revalidation = __commonJS({
     var path = __importStar(require("path"));
     var lspProcessHost_1 = require_lspProcessHost();
     var REVALIDATE_EXTS = /* @__PURE__ */ new Set([".txt", ".yml", ".gui", ".gfx", ".asset", ".shader", ".fxh"]);
-    var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "dist", "coverage", ".git", ".cwtools", ".cwtools-ai", ".vscode"]);
+    var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "dist", "coverage"]);
     var MAX_WALK_FILES = 2e4;
     var MAX_BATCH = 200;
     function numberOr(value, fallback) {
@@ -11669,7 +11872,7 @@ var require_nodeHostServices = __commonJS({
         return;
       const entries = await fs.readdir(root, { withFileTypes: true }).catch(() => []);
       for (const entry of entries) {
-        if (entry.name.startsWith(".") && entry.name !== ".cwtools" && entry.name !== ".cwtools-ai")
+        if (entry.name.startsWith(".") && entry.name !== ".cwtools")
           continue;
         if (entry.name === "node_modules" || entry.name === "dist" || entry.name === "coverage")
           continue;
@@ -46774,7 +46977,7 @@ var require_bridgeProxy = __commonJS({
           "CWTools MCP is served by the active VS Code-compatible extension host.",
           "This proxy does not start its own CWTools language server. If calls report",
           "bridge_unavailable, open the project in the compatible host where the extension",
-          "is installed and active, or rerun with --standalone to use the legacy isolated mode."
+          "is installed and active, or rerun with --standalone to use the standalone LSP host."
         ].join("\n")
       });
       server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
@@ -46863,7 +47066,7 @@ var require_bridgeProxy = __commonJS({
         throw new Error(`CWTools MCP bridge is unavailable: could not read ${manifestPath}. Open this project in a VS Code-compatible host with the extension active, or pass --standalone to start a separate CWTools server. Details: ${error instanceof Error ? error.message : String(error)}`);
       }
       if (parsed.kind !== "cwtools-mcp-extension-bridge" || parsed.protocolVersion !== BRIDGE_PROTOCOL_VERSION) {
-        throw new Error(`CWTools MCP bridge manifest at ${manifestPath} is not compatible with this proxy. Open the project in the updated extension host, or pass --standalone for legacy isolated mode.`);
+        throw new Error(`CWTools MCP bridge manifest at ${manifestPath} is not compatible with this proxy. Open the project in the updated extension host, or pass --standalone to use the standalone LSP host.`);
       }
       if (!parsed.rpcUrl || !parsed.token) {
         throw new Error(`CWTools MCP bridge manifest at ${manifestPath} is missing rpcUrl/token.`);
@@ -49516,7 +49719,7 @@ var require_server3 = __commonJS({
       "- Before declaring code correct, review get_diagnostics (whole project). Honor the",
       "  readiness/freshness fields: if readiness.ready is false the project is still loading \u2014",
       "  retry; an empty result then is not authoritative.",
-      "- Navigate with query_definition / query_definition_by_name / query_references /",
+      "- Navigate with go_to_definition / find_references /",
       "  document_symbols / workspace_symbols; read structured blocks with get_pdx_block",
       "  instead of reading whole files. get_entity_info gives a file's referenced types/vars.",
       "- Results carry vanillaCache metadata: if available is false, vanilla IDs are missing",

package/dist/hosts/lspProcessHost.js

@@ -212,7 +212,7 @@ class LspProcessHost {
             return;
         const watcher = (0, chokidar_1.watch)(this.options.workspaceRoot, {
             ignoreInitial: true,
-            ignored: [/(^|[\\/])(?:node_modules|\.git|\.cwtools|\.cwtools-ai)(?:[\\/]|$)/],
+            ignored: [/(^|[\\/])(?:node_modules|\.(?!\.)[^\\/]+)(?:[\\/]|$)/],
             awaitWriteFinish: { stabilityThreshold: 120, pollInterval: 30 },
         });
         watcher.on('add', filePath => this.queueWatchedFileChange(filePath, 1));
@@ -401,9 +401,7 @@ function isLspWatchedFile(workspaceRoot, filePath, game) {
         return false;
     const segments = relative.split(/[\\/]+/).map(segment => segment.toLowerCase());
     if (segments.some(segment => segment === 'node_modules'
-        || segment === '.git'
-        || segment === '.cwtools'
-        || segment === '.cwtools-ai'))
+        || (segment.startsWith('.') && !segment.startsWith('..'))))
         return false;
     const extension = path.extname(filePath).toLowerCase();
     if (extension === '.csv' && game && game.toLowerCase() !== 'ck2')

package/dist/hosts/nodeHostServices.js

@@ -439,7 +439,7 @@ async function walk(root, visit) {
         return;
     const entries = await fs.readdir(root, { withFileTypes: true }).catch(() => []);
     for (const entry of entries) {
-        if (entry.name.startsWith('.') && entry.name !== '.cwtools' && entry.name !== '.cwtools-ai')
+        if (entry.name.startsWith('.') && entry.name !== '.cwtools')
             continue;
         if (entry.name === 'node_modules' || entry.name === 'dist' || entry.name === 'coverage')
             continue;

package/dist/hosts/projectDetect.js

@@ -39,7 +39,7 @@ const path = __importStar(require("path"));
 // Strong, unambiguous "this directory is a mod root" signals.
 const ROOT_FILE_MARKERS = ['descriptor.mod'];
 const ROOT_NESTED_FILE_MARKERS = [path.join('.metadata', 'metadata.json')];
-const ROOT_DIR_MARKERS = ['.cwtools', '.cwtools-ai'];
+const ROOT_DIR_MARKERS = ['.cwtools'];
 // PDX content dirs — specific enough at a mod root, but too generic to trust in a
 // far-off ancestor. Generic graphics dirs (gfx/, interface/) are excluded.
 const CONTENT_DIR_MARKERS = ['common', 'events', 'localisation', 'localization'];

package/dist/hosts/projectSettings.js

@@ -106,7 +106,6 @@ function parseJsonc(text) {
 }
 const cache = new Map();
 const SETTINGS_NAMESPACE = 'stellarisLanguageServices';
-const LEGACY_SETTINGS_NAMESPACE = 'cwtools';
 function readSettingsObject(workspaceRoot) {
     const file = path.join(workspaceRoot, '.vscode', 'settings.json');
     let mtimeMs;
@@ -152,10 +151,7 @@ function getExtensionSetting(workspaceRoot, subKey) {
     const settings = readSettingsObject(workspaceRoot);
     if (!settings)
         return undefined;
-    const current = resolveDotted(settings, `${SETTINGS_NAMESPACE}.${subKey}`);
-    return current !== undefined
-        ? current
-        : resolveDotted(settings, `${LEGACY_SETTINGS_NAMESPACE}.${subKey}`);
+    return resolveDotted(settings, `${SETTINGS_NAMESPACE}.${subKey}`);
 }
 function asNonEmptyStringArray(value) {
     return Array.isArray(value)

package/dist/hosts/revalidation.js

@@ -39,7 +39,7 @@ const path = __importStar(require("path"));
 const lspProcessHost_1 = require("./lspProcessHost");
 // File extensions the language server validates — only these are worth revalidating.
 const REVALIDATE_EXTS = new Set(['.txt', '.yml', '.gui', '.gfx', '.asset', '.shader', '.fxh']);
-const SKIP_DIRS = new Set(['node_modules', 'dist', 'coverage', '.git', '.cwtools', '.cwtools-ai', '.vscode']);
+const SKIP_DIRS = new Set(['node_modules', 'dist', 'coverage']);
 const MAX_WALK_FILES = 20000;
 const MAX_BATCH = 200;
 function numberOr(value, fallback) {

package/dist/mcp/bridgeProxy.js

@@ -59,7 +59,7 @@ function createBridgeProxyMcpServer(config) {
             'CWTools MCP is served by the active VS Code-compatible extension host.',
             'This proxy does not start its own CWTools language server. If calls report',
             'bridge_unavailable, open the project in the compatible host where the extension',
-            'is installed and active, or rerun with --standalone to use the legacy isolated mode.',
+            'is installed and active, or rerun with --standalone to use the standalone LSP host.',
         ].join('\n'),
     });
     server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
@@ -158,7 +158,7 @@ async function readBridgeManifest(config, server) {
     }
     if (parsed.kind !== 'cwtools-mcp-extension-bridge' || parsed.protocolVersion !== BRIDGE_PROTOCOL_VERSION) {
         throw new Error(`CWTools MCP bridge manifest at ${manifestPath} is not compatible with this proxy. ` +
-            `Open the project in the updated extension host, or pass --standalone for legacy isolated mode.`);
+            `Open the project in the updated extension host, or pass --standalone to use the standalone LSP host.`);
     }
     if (!parsed.rpcUrl || !parsed.token) {
         throw new Error(`CWTools MCP bridge manifest at ${manifestPath} is missing rpcUrl/token.`);

package/dist/server.js

@@ -26,7 +26,7 @@ const SERVER_INSTRUCTIONS = [
     '- Before declaring code correct, review get_diagnostics (whole project). Honor the',
     '  readiness/freshness fields: if readiness.ready is false the project is still loading —',
     '  retry; an empty result then is not authoritative.',
-    '- Navigate with query_definition / query_definition_by_name / query_references /',
+    '- Navigate with go_to_definition / find_references /',
     '  document_symbols / workspace_symbols; read structured blocks with get_pdx_block',
     '  instead of reading whole files. get_entity_info gives a file\'s referenced types/vars.',
     '- Results carry vanillaCache metadata: if available is false, vanilla IDs are missing',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cwtools-mcp",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Read-only MCP server exposing CWTools Paradox/Stellaris semantic tools to external agents",
   "license": "MIT",
   "repository": {
@@ -37,7 +37,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "chokidar": "^4.0.3",
-    "cwtools-shared": "0.2.3",
+    "cwtools-shared": "0.2.5",
     "vscode-jsonrpc": "^8.2.0"
   },
   "devDependencies": {