d365fo-mcp 1.8.5 → 1.9.0

package/.github/copilot-instructions.md

@@ -18,7 +18,7 @@ Call `get_workspace_info()` before doing anything with D365FO objects.
 |----------|--------|
 | Call fails | STOP. MCP server not connected. Ask user to start it. |
 | `⛔ CONFIGURATION PROBLEM` | STOP. Relay message. Wait for user. |
-| `✅ Configuration looks valid` | Note model name. Proceed. |
+| No `⛔` in the response | Note the `Model` / `Prefix` lines. Proceed. |
 
 ## Terminal Prohibition
 

package/dist/cli/copilotFiles.js

@@ -9,6 +9,10 @@
  * folder, or, when that is unknown, into a staging folder with a README
  * naming the two destinations.
  *
+ * The README belongs to the staging folder only. The solutions folder is the
+ * user's own projects directory, so the direct copy leaves nothing there but
+ * `.github\copilot-instructions.md` and says the rest on the console.
+ *
  * The README points at the one .mcp.json `mcpJsonNote()` writes in the data
  * root rather than copying it: the staging folder sits in that same data
  * root, so a second copy is only one more file to keep in sync.
@@ -22,7 +26,7 @@ import { dataRoot, paths, repoRoot } from './context.js';
 import { askConfirm, p } from './ui.js';
 /** The copy shipped with this installation — package root in both install modes. */
 const copilotSource = () => resolve(repoRoot, '.github', 'copilot-instructions.md');
-function writeCopilotSetupReadme(targetDir, opts) {
+function writeCopilotSetupReadme(targetDir) {
     const readmePath = resolve(targetDir, 'README.md');
     const lines = [
         '# VS setup quick guide',
@@ -35,9 +39,7 @@ function writeCopilotSetupReadme(targetDir, opts) {
         `   - Generated copy: ${paths.mcpSuggestion}`,
         '',
         '2. Copy .github/copilot-instructions.md',
-        opts.copilotAlreadyPlaced
-            ? '   - Already placed here: .github\\copilot-instructions.md'
-            : '   - Destination: a parent folder of your solution directories',
+        '   - Destination: a parent folder of your solution directories',
         '   - Why: provides mandatory D365FO tool-routing and safety rules for Copilot',
         '',
         '3. Restart Visual Studio after copying files.',
@@ -64,16 +66,16 @@ export async function maybePrepareCopilotInstructions(solutionsPath) {
         const targetDir = resolve(target, '.github');
         fs.mkdirSync(targetDir, { recursive: true });
         fs.copyFileSync(source, resolve(targetDir, 'copilot-instructions.md'));
-        writeCopilotSetupReadme(target, { copilotAlreadyPlaced: true });
         p.log.success(`Prepared: ${resolve(targetDir, 'copilot-instructions.md')}`);
-        p.log.success(`Prepared: ${resolve(target, 'README.md')}`);
+        p.log.info('Still to do: copy .mcp.json to %USERPROFILE%\\.mcp.json (or next to your .sln), then restart Visual Studio.\n' +
+            `   Generated copy: ${paths.mcpSuggestion}`);
         return;
     }
     const stageDir = resolve(dataRoot(), 'copilot-setup');
     const stageGitHubDir = resolve(stageDir, '.github');
     fs.mkdirSync(stageGitHubDir, { recursive: true });
     fs.copyFileSync(source, resolve(stageGitHubDir, 'copilot-instructions.md'));
-    writeCopilotSetupReadme(stageDir, { copilotAlreadyPlaced: false });
+    writeCopilotSetupReadme(stageDir);
     if (wantsDirectCopy && !target) {
         p.log.warn('Solutions folder is empty, so files were prepared in the local staging folder instead.');
     }

package/dist/prompts/systemInstructions.d.ts

@@ -8,7 +8,7 @@
  *
  * Kept deliberately under 200 lines: the prompt holds only the tool decision
  * tree and hard prohibitions. Everything that is a rule about CODE lives in
- * the queryable knowledge base — get_xpp_knowledge (see the ID table below).
+ * the queryable knowledge base — get_knowledge (see the ID table below).
  */
 /**
  * Get the system instructions prompt definition

package/dist/prompts/systemInstructions.js

@@ -8,7 +8,7 @@
  *
  * Kept deliberately under 200 lines: the prompt holds only the tool decision
  * tree and hard prohibitions. Everything that is a rule about CODE lives in
- * the queryable knowledge base — get_xpp_knowledge (see the ID table below).
+ * the queryable knowledge base — get_knowledge (see the ID table below).
  */
 /**
  * Get the system instructions prompt definition
@@ -117,7 +117,7 @@ You are an AI assistant with access to D365FO MCP tools, assisting with Dynamics
 - No literal strings in \`Info()\`/\`error()\`/labels — use \`@Model:LabelId\` (reuse via \`labels(action="search")\` first)
 - Every public/protected member needs a meaningful \`/// <summary>\` (not "MyClass class.")
 
-**For full rules and examples call \`get_xpp_knowledge(id)\` BEFORE generating code:**
+**For full rules and examples call \`get_knowledge(kind="knowledge", topic=<id>)\` BEFORE generating code:**
 
 | Knowledge ID | Covers |
 |---|---|

package/dist/server/toolSchemas/getWorkspaceInfo.js

@@ -20,7 +20,7 @@ export const getWorkspaceInfoTool = {
             diagnostics: {
                 type: 'boolean',
                 default: false,
-                description: 'Include verbose diagnostic sections (suffix breakdown, stdio session/handshake dump). Use when debugging client-server connectivity.',
+                description: 'Include verbose sections (config sources, suffix, project paths, index scan, stdio handshake). Use when debugging config or connectivity.',
             },
         },
         required: [],

package/dist/tools/codeGen.js

@@ -84,7 +84,7 @@ internal final class ${name}
 // D365FO Data Entity: ${name}Entity
 // ══════════════════════════════════════════════════════════════════
 // Data entities are AxDataEntityView XML objects (NOT X++ classes).
-// Use create_d365fo_file(objectType="view") or the VS designer.
+// Use d365fo_file(action="create", objectType="view") or the VS designer.
 //
 // Key properties to set in XML:
 //   PublicEntityName:       "${name}"  (OData singular name)
@@ -107,8 +107,8 @@ internal final class ${name}
 //
 // Workflow:
 //   1. get_object_info(objectType="data-entity", name="similar entity")  → study structure
-//   2. generate_d365fo_xml(objectType="data-entity", ...)  → preview XML
-//   3. create_d365fo_file(objectType="view", ...)  → create file
+//   2. generate_object(mode="scaffold", objectType="data-entity", ...)  → preview XML
+//   3. d365fo_file(action="create", objectType="view", ...)  → create file
 //   4. After deployment: refresh entity list in Data Management workspace
 `,
     'batch-job': (name) => `
@@ -646,7 +646,7 @@ function menuItemXmlTemplate(name, itemType, targetObject) {
 function ssrsReportFullTemplate(name) {
     return `// ══════════════════════════════════════════════════════════════════
 // SSRS Report: ${name}
-// 5 objects required (use create_d365fo_file for each):
+// 5 objects required (use d365fo_file(action="create") for each):
 //   1. ${name}TmpTable  — TempDB table (objectType="table", tableType="TempDB")
 //   2. ${name}Contract  — DataContract class (below)
 //   3. ${name}DP        — Data Provider class (below)
@@ -1053,14 +1053,14 @@ public class ${name}Controller extends MenuFunction
 function dataEntityStagingTemplate(name) {
     return `// ══════════════════════════════════════════════════════════════════════════
 // Data Entity with Staging Table: ${name}
-// 3 objects required (use create_d365fo_file for each):
+// 3 objects required (use d365fo_file(action="create") for each):
 //   1. ${name}StagingTable  — TempDB staging table
 //   2. ${name}Entity        — Data entity (AxDataEntityView)
 //   3. ${name}EntityService — Optional: AIF service class
 // ══════════════════════════════════════════════════════════════════════════
 
 // ── Object 1: Staging table ${name}Staging ─────────────────────────────────
-// create_d365fo_file(objectType="table", objectName="${name}Staging", xmlContent=...)
+// d365fo_file(action="create", objectType="table", objectName="${name}Staging", xmlContent=...)
 // Set: TableType=TempDB (NOT RegularTable), TableGroup=Main
 // Fields mirror the entity's public fields exactly (same names, same EDTs)
 
@@ -1661,7 +1661,7 @@ public class ${name}Service
     }
 }
 
-// ── 3. AOT objects (create via create_d365fo_file) ──────────────────────
+// ── 3. AOT objects (create via d365fo_file(action="create")) ────────────
 // Verify the result afterwards with get_object_info(objectType="service", name="${name}Service").
 // a) AxService XML (real schema: ServiceOperations / AxServiceOperation / Method):
 //    <AxService xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
@@ -1822,7 +1822,11 @@ export async function codeGenTool(request) {
             // Extension pattern — args.name is the BASE element; prefix becomes the infix
             // Grounding enforcement: extension patterns require proof that the AI looked at the
             // real codebase (via prepare_change) before generating extension code.
-            const groundingError = enforceGrounding(args.groundingToken, `generate_code(pattern="${args.pattern}", name="${args.name}")`, args.name);
+            const groundingError = enforceGrounding(args.groundingToken, 
+            // The MCP-visible name, not the internal one: this string is echoed back
+            // as the call the agent must repeat with a token, and `generate_code`
+            // has not been a registered tool since the mega-tool consolidation.
+            `generate_object(mode="pattern", pattern="${args.pattern}", name="${args.name}")`, args.name);
             if (groundingError)
                 return groundingError;
             // ── form-datasource-extension / form-control-extension (3-param templates) ──
@@ -1924,20 +1928,18 @@ export async function codeGenTool(request) {
                     text: `Generated ${args.pattern} template for "${displayName}":\n\n` +
                         `\`\`\`xpp${code}\n\`\`\`\n\n` +
                         `---\n\n` +
-                        `${namingNote}\n\n` +
+                        namingNote +
+                        // Only the CoC signature rule earns a line here: guessing static vs
+                        // instance produces code that fails to compile. The rest was a menu
+                        // of optional follow-ups — and it named tools that do not exist
+                        // (`find_coc_extensions`) with argument forms analyze_code rejects
+                        // (positional, not `className`/`methodName`), so following it cost a
+                        // failed call before the agent could get anything useful.
                         (args.pattern === 'class-extension'
-                            ? `💡 **Next Steps (class-extension CoC workflow):**\n\n` +
-                                `1. 🚨 Use \`get_method(include="signature", "${displayName}", "<methodName>")\` — **REQUIRED** to get the exact signature (static vs instance, return type, parameters) before writing any CoC method\n` +
-                                `2. ✅ Use \`find_coc_extensions("${displayName}", "<methodName>")\` - See existing CoC wrappers for reference\n` +
-                                `3. ✅ Use \`analyze_code(mode="implementations", "${displayName}", "<methodName>")\` - Get real implementation examples\n` +
-                                `4. ✅ Use \`analyze_code(mode="api-usage", "<ClassName>")\` - See how to use D365FO APIs correctly\n\n` +
-                                `⚠️ Never guess static vs instance — always use get_method(include="signature") first.`
-                            : `💡 **Next Steps for Better Code Quality:**\n\n` +
-                                `1. ✅ Use \`analyze_code(mode="patterns", "<scenario>")\` - Learn what D365FO classes are commonly used together\n` +
-                                `2. ✅ Use \`analyze_code(mode="implementations", "${displayName}", "<methodName>")\` - Get real implementation examples\n` +
-                                `3. ✅ Use \`analyze_code(mode="completeness", "${displayName}")\` - Check for missing common methods\n` +
-                                `4. ✅ Use \`analyze_code(mode="api-usage", "<ClassName>")\` - See how to use D365FO APIs correctly\n\n` +
-                                `These tools provide patterns from the actual codebase, not generic templates.`),
+                            ? `\n\n⚠️ Before writing any CoC method call \`get_method(include="signature", className="${displayName}", methodName="<methodName>")\` — ` +
+                                `never guess static vs instance, the return type or the parameter list. ` +
+                                `Existing wrappers: \`extension_info(mode="coc", target="${displayName}")\`.`
+                            : ``),
                 },
             ],
         };

package/dist/tools/createD365File.js

@@ -4712,16 +4712,13 @@ export async function handleCreateD365File(request, context) {
                     `\nUntil resolved, add the file manually in Visual Studio: right-click project → Add Existing Item → ${normalizedFullPath}\n`;
             }
         }
-        // Build success message
+        // Only the step the AGENT can take. "Reload the project in VS / refresh the
+        // AOT" is a human's UI chore, repeated on every object of a feature; when it
+        // matters (addToProject failed, no projectPath) `projectMessage` above
+        // already says so, in that specific case.
         const nextSteps = args.addToProject
-            ? `Next steps:\n` +
-                `1. Reload project in Visual Studio (or close/reopen solution)\n` +
-                `2. Build the project to synchronize the object\n` +
-                `3. Refresh AOT in Visual Studio to see the new object\n`
-            : `Next steps:\n` +
-                `1. Add the file to your Visual Studio project (.rnrproj)\n` +
-                `2. Build the project to synchronize the object\n` +
-                `3. Refresh AOT in Visual Studio to see the new object\n`;
+            ? `Next: build_d365fo_project to synchronize the object.\n`
+            : `Next: add the file to your .rnrproj, then build_d365fo_project to synchronize the object.\n`;
         // Record the freshly-created file for non-git undo (see the bridge paths above).
         if (!fileExisted) {
             recordCreatedArtifact({

package/dist/tools/extensionStrategyAdvisor.js

@@ -46,9 +46,9 @@ const STRATEGY_RULES = [
             { mechanism: 'Form data source validateWrite()', when: 'Validation is UI-specific and should NOT apply to service/entity imports' },
         ],
         nextSteps: [
-            'analyze_extension_points("TableName") — check available events and existing extensions',
-            'find_event_handlers("TableName") — see if someone already handles the same event',
-            'generate_code(pattern="event-handler") — generate the handler skeleton',
+            'extension_info(mode="points", target="TableName") — available events and existing extensions',
+            'extension_info(mode="events", target="TableName") — see if someone already handles the same event',
+            'generate_object(mode="pattern", pattern="event-handler", name="TableName") — handler skeleton',
         ],
         antiPatterns: [
             { wrong: 'Business Event', why: 'Business Events are for outbound notifications, not validation logic' },
@@ -73,8 +73,8 @@ const STRATEGY_RULES = [
             { mechanism: 'Form data source initValue()', when: 'Default depends on form context (e.g. header record of a lines form)' },
         ],
         nextSteps: [
-            'analyze_extension_points("TableName") — check initValue availability',
-            'get_method(include="signature", "TableName", "initValue", includeCocTemplate: true) — get CoC template',
+            'extension_info(mode="points", target="TableName") — check initValue availability',
+            'get_method(include="signature", className="TableName", methodName="initValue") — exact signature for the CoC wrapper',
         ],
         antiPatterns: [
             { wrong: 'Overriding insert()', why: 'insert() is for persistence — defaults belong in initValue()' },
@@ -110,9 +110,9 @@ const STRATEGY_RULES = [
             { mechanism: 'CoC on table.modifiedFieldValue()', when: 'You also need the previous value to decide what to do' },
         ],
         nextSteps: [
-            'analyze_extension_points("TableName") — confirm modifiedField is CoC-eligible and see existing extensions',
-            'get_method(include="signature", "TableName", "modifiedField", includeCocTemplate: true) — get the CoC skeleton',
-            'find_coc_extensions("TableName", "modifiedField") — check for existing wrappers',
+            'extension_info(mode="points", target="TableName") — confirm modifiedField is CoC-eligible and see existing extensions',
+            'get_method(include="signature", className="TableName", methodName="modifiedField") — exact signature for the CoC wrapper',
+            'extension_info(mode="coc", target="TableName", method="modifiedField") — check for existing wrappers',
         ],
         antiPatterns: [
             { wrong: 'CoC on initValue()', why: 'initValue fires only at record creation — it will NOT run when the user later changes the field' },
@@ -141,9 +141,9 @@ const STRATEGY_RULES = [
             { mechanism: 'Replaceable method', when: 'Method is marked [Replaceable] — you can fully replace it (rare in standard app)' },
         ],
         nextSteps: [
-            'analyze_extension_points("ClassName") — see CoC-eligible methods and delegates',
-            'get_method(include="signature", "ClassName", "methodName", includeCocTemplate: true) — get exact CoC skeleton',
-            'find_coc_extensions("ClassName", "methodName") — check for existing CoC wrappers',
+            'extension_info(mode="points", target="ClassName") — see CoC-eligible methods and delegates',
+            'get_method(include="signature", className="ClassName", methodName="methodName") — exact signature for the CoC wrapper',
+            'extension_info(mode="coc", target="ClassName", method="methodName") — check for existing CoC wrappers',
         ],
         antiPatterns: [
             { wrong: 'Copy-paste the entire class', why: 'Over-layering defeats the purpose of extensions and blocks upgrades' },
@@ -172,8 +172,8 @@ const STRATEGY_RULES = [
             { mechanism: 'Dual-write', when: 'Real-time bidirectional sync with Dataverse is needed' },
         ],
         nextSteps: [
-            'get_knowledge(kind="knowledge", "business events") — learn the pattern',
-            'generate_code(pattern="business-event", name="MyEvent") — generate skeleton',
+            'get_knowledge(kind="knowledge", topic="business events") — learn the pattern',
+            'generate_object(mode="pattern", pattern="business-event", name="MyEvent") — generate skeleton',
         ],
         antiPatterns: [
             { wrong: 'CoC calling HttpClient', why: 'Synchronous HTTP in a transaction blocks the user and risks timeout/rollback' },
@@ -203,9 +203,9 @@ const STRATEGY_RULES = [
             { mechanism: 'Composite entity', when: 'Header + lines structure needs to be imported as a document' },
         ],
         nextSteps: [
-            'get_knowledge(kind="knowledge", "data-management-framework") — learn DMF patterns',
-            'search("MyTable", "data-entity") — check if an entity already exists',
-            'generate_code(pattern="data-entity", name="MyEntity") — generate entity skeleton',
+            'get_knowledge(kind="knowledge", topic="data-management-framework") — learn DMF patterns',
+            'search(query="MyTable", type="data-entity") — check if an entity already exists',
+            'generate_object(mode="pattern", pattern="data-entity", name="MyEntity") — generate entity skeleton',
         ],
         antiPatterns: [
             { wrong: 'Direct table insert via custom endpoint', why: 'Bypasses validation, number sequences, and event handlers' },
@@ -234,7 +234,7 @@ const STRATEGY_RULES = [
         ],
         nextSteps: [
             'get_object_info(objectType="form", name="FormName", options={searchControl:"General"}) — find exact control names and hierarchy',
-            'analyze_extension_points("FormName") — check form extension points',
+            'extension_info(mode="points", target="FormName", objectType="form") — check form extension points',
             'd365fo_file(action="create", objectType="form-extension") — create the extension',
         ],
         antiPatterns: [
@@ -265,8 +265,8 @@ const STRATEGY_RULES = [
         ],
         nextSteps: [
             'get_object_info(objectType="report", name="ReportName") — inspect existing report structure',
-            'get_knowledge(kind="knowledge", "ssrs-reports") — patterns for SSRS',
-            'generate_smart(objectType="report", name="MyReport") — generate full SSRS stack',
+            'get_knowledge(kind="knowledge", topic="ssrs-reports") — patterns for SSRS',
+            'generate_object(mode="scaffold", objectType="report", name="MyReport") — generate full SSRS stack',
         ],
         antiPatterns: [
             { wrong: 'Business Event for document delivery', why: 'Business Events send notifications, not formatted documents' },
@@ -290,8 +290,8 @@ const STRATEGY_RULES = [
             { mechanism: 'Custom counter table', when: 'Simple auto-increment without legal entity scope or configurable format (rare — prefer the framework)' },
         ],
         nextSteps: [
-            'get_knowledge(kind="knowledge", "number-sequences") — full pattern reference',
-            'generate_code(pattern="number-seq-handler") — generate skeleton',
+            'get_knowledge(kind="knowledge", topic="number-sequences") — full pattern reference',
+            'generate_object(mode="pattern", pattern="number-seq-handler", name="MyModule") — generate skeleton',
         ],
         antiPatterns: [
             { wrong: 'Identity column / RecId as business number', why: 'RecId is internal — users need formatted, gapless (or configurable) business numbers' },
@@ -318,8 +318,8 @@ const STRATEGY_RULES = [
             { mechanism: 'Table permission framework override', when: 'Granting DML access without a menu item entry point (rare)' },
         ],
         nextSteps: [
-            'get_knowledge(kind="knowledge", "security-privileges-duties") — security pattern reference',
-            'security_info(mode="coverage", "ObjectName") — check existing security chain',
+            'get_knowledge(kind="knowledge", topic="security-privileges-duties") — security pattern reference',
+            'security_info(mode="coverage", objectName="ObjectName") — check existing security chain',
             'd365fo_file(action="create", objectType="security-privilege") — create privilege',
         ],
         antiPatterns: [
@@ -346,9 +346,9 @@ const STRATEGY_RULES = [
             { mechanism: 'Business Event + external processor', when: 'Processing should happen outside D365FO (e.g. Azure Function)' },
         ],
         nextSteps: [
-            'get_knowledge(kind="knowledge", "sysoperation") — SysOperation patterns',
-            'generate_code(pattern="sysoperation", name="MyProcess") — generate SysOperation skeleton',
-            'generate_code(pattern="batch-job", name="MyBatch") — generate RunBaseBatch skeleton',
+            'get_knowledge(kind="knowledge", topic="sysoperation") — SysOperation patterns',
+            'generate_object(mode="pattern", pattern="sysoperation", name="MyProcess") — generate SysOperation skeleton',
+            'generate_object(mode="pattern", pattern="batch-job", name="MyBatch") — generate RunBaseBatch skeleton',
         ],
         antiPatterns: [
             { wrong: 'Thread.Sleep / while-polling in batch', why: 'Use batch recurrence and alerts — polling wastes AOS resources' },

package/dist/tools/prefixDiagnostics.d.ts

@@ -24,8 +24,15 @@
  */
 export declare function modelWritesLandIn(anchorModel: string | null, activeModel: string | null): string | null;
 export interface PrefixDiagnostics {
-    /** Lines for the "## Prefix Configuration" section, blank line included. */
+    /**
+     * Compact default: one `Prefix : …` line, plus a note only when something is
+     * actually off (a switch is in effect, or the resolved prefix contradicts the
+     * configuration). Every call of get_workspace_info pays for these tokens, so
+     * the confirmations that only restate the value stay in `verboseLines`.
+     */
     lines: string[];
+    /** Full "## Prefix Configuration" section — diagnostics=true only. */
+    verboseLines: string[];
     /** The prefix a write would apply — for the Extension Naming samples. */
     effectivePrefix: string;
 }

package/dist/tools/prefixDiagnostics.js

@@ -67,23 +67,39 @@ export function buildPrefixDiagnostics(writeModel, readModel) {
     const disagrees = !!learned?.regular && !!extensionPrefixEnv &&
         bare(learned.regular) !== bare(extensionPrefixEnv);
     const switched = !!writeModel && !!readModel && !sameModel(writeModel, readModel);
-    const lines = [
+    const switchNote = `ℹ️  This is the prefix for WRITES, which are anchored to "${writeModel}". "${readModel}" is ` +
+        `merely the active project and its own prefix may differ — see the project-switch note below.`;
+    const disagreeNote = `⚠️  The model's own objects use "${learned?.regular}", which overrides EXTENSION_PREFIX="${extensionPrefixEnv}" — new objects will be named "${effectivePrefix}…". If that is wrong, the model's existing objects are the thing to check; set EXTENSION_PREFIX_SOURCE=config to pin the configured value instead.`;
+    const notConfiguredNote = `⚠️  EXTENSION_PREFIX is not set in the server environment. The model name "${writeModel}" will be used as prefix. Add EXTENSION_PREFIX=MY (or your ISV prefix) to the .env file and restart the server.`;
+    // Compact: the value, its origin, and a warning only when there is one. The
+    // warnings keep the fix but drop the explanation of it — the resolved prefix
+    // is one line above, so what is wrong is already visible.
+    const lines = [`Prefix      : ${effectivePrefix || '(none)'}  (${source})`];
+    if (switched)
+        lines.push(switchNote);
+    if (disagrees) {
+        lines.push(`⚠️  The model's own objects use "${learned?.regular}", overriding EXTENSION_PREFIX="${extensionPrefixEnv}". ` +
+            `To pin the configured value instead: EXTENSION_PREFIX_SOURCE=config.`);
+    }
+    else if (!learned?.regular && !extensionPrefixEnv) {
+        lines.push(`⚠️  EXTENSION_PREFIX is not set — the model name is being used as the prefix. ` +
+            `Add EXTENSION_PREFIX=MY (your ISV prefix) to .env and restart the server.`);
+    }
+    const verboseLines = [
         `## Prefix Configuration`,
         ``,
         `EXTENSION_PREFIX: ${extensionPrefixEnv ?? '(not set — falling back to model name)'}`,
         `Effective prefix: ${effectivePrefix || '(none)'}  (source: ${source})`,
     ];
-    if (switched) {
-        lines.push(`ℹ️  This is the prefix for WRITES, which are anchored to "${writeModel}". "${readModel}" is ` +
-            `merely the active project and its own prefix may differ — see the project-switch note below.`);
-    }
-    lines.push(disagrees
-        ? `⚠️  The model's own objects use "${learned.regular}", which overrides EXTENSION_PREFIX="${extensionPrefixEnv}" — new objects will be named "${effectivePrefix}…". If that is wrong, the model's existing objects are the thing to check; set EXTENSION_PREFIX_SOURCE=config to pin the configured value instead.`
+    if (switched)
+        verboseLines.push(switchNote);
+    verboseLines.push(disagrees
+        ? disagreeNote
         : learned?.regular
             ? `✅ Prefix "${effectivePrefix}" comes from the objects model "${writeModel}" already contains.`
             : extensionPrefixEnv
                 ? `✅ EXTENSION_PREFIX is set — all new objects will use prefix "${effectivePrefix}".`
-                : `⚠️  EXTENSION_PREFIX is not set in the server environment. The model name "${writeModel}" will be used as prefix. Add EXTENSION_PREFIX=MY (or your ISV prefix) to the .env file and restart the server.`, ``);
-    return { lines, effectivePrefix };
+                : notConfiguredNote, ``);
+    return { lines, verboseLines, effectivePrefix };
 }
 //# sourceMappingURL=prefixDiagnostics.js.map

package/dist/tools/search.js

@@ -237,7 +237,9 @@ async function performHybridSearch(args, context) {
             output += `\n• ${tip.tip}${toolHint}`;
         });
     }
-    output += `\n\n💡 **Workspace-aware search** includes both your local project files and D365FO external metadata.`;
+    // No trailing "this search is workspace-aware" note: the 🔹/📦 marker on every
+    // row already says which side a hit came from, and search is the most-called
+    // tool — a fixed footer here is paid for on every call for nothing actionable.
     return {
         content: [
             {

package/dist/tools/toolHandler.js

@@ -32,9 +32,11 @@ import { prepareTool } from './prepare.js';
 import { recordToolStart, startMetricsLogging, recordCallSequence } from '../utils/toolMetrics.js';
 import { DEDUP_EXCLUDED_TOOLS, DEDUP_TTL_MS, dedupKey, getDedupedResult, storeDedupResult, appendNote, getInFlight, registerInFlight, clearInFlight, } from '../utils/callDedup.js';
 import { checkIndexStaleness } from '../utils/indexStaleness.js';
-import { buildContextSnapshot, renderContextSnapshotSection } from '../workspace/contextSnapshot.js';
+import { buildContextSnapshot, renderContextSnapshotSection, renderContextSnapshotCompact, } from '../workspace/contextSnapshot.js';
 import * as nodePath from 'path';
 import { buildProgressMessage } from '../utils/toolProgressMessage.js';
+/** Models named inline by the compact project list before it summarises the rest. */
+const PROJECT_NAMES_SHOWN = 12;
 /**
  * Extract workspace path from GitHub Copilot _meta.
  * HTTP requests must not overwrite the shared runtimeContext (AsyncLocalStorage
@@ -86,6 +88,10 @@ const TOOL_CAP_SIZES = {
     build_d365fo_project: 'uncapped', // compiler errors can appear late in long logs
     security_info: 8000,
     extension_info: 6000,
+    // Default output is ~1 KB. The higher cap exists for diagnostics=true, whose
+    // whole point is the full dump — truncating that at 5000 hid the stdio
+    // handshake section behind the project table.
+    get_workspace_info: 20000,
     default: 5000,
 };
 function getCapForTool(toolName) {
@@ -304,7 +310,7 @@ export function registerToolHandler(server, context) {
                             // from — after a project switch those are different models (see
                             // buildPrefixDiagnostics and ConfigManager.getWriteAnchorModel).
                             const writeModel = modelWritesLandIn(configManager.getWriteAnchorModel() ?? modelName, modelName);
-                            const { lines: prefixLines, effectivePrefix } = buildPrefixDiagnostics(writeModel, modelName);
+                            const { lines: prefixLines, verboseLines: prefixVerboseLines, effectivePrefix, } = buildPrefixDiagnostics(writeModel, modelName);
                             const objectSuffixEnv = process.env.EXTENSION_SUFFIX?.trim() || null;
                             const effectiveSuffix = getObjectSuffix();
                             const PLACEHOLDER_NAMES = new Set([
@@ -327,42 +333,40 @@ export function registerToolHandler(server, context) {
                             const effectiveWriteSource = customPackagesPath ? customPackagesSource : packageSource;
                             // MS framework path shown in diagnostics; omitted for single-root traditional setups.
                             const msFrameworkPath = frameworkDirectory ?? (!customPackagesPath ? null : packagePath);
-                            // Verbose diagnostic sections cost tokens on every call — opt-in only.
+                            // get_workspace_info is called at the start of every session, so every
+                            // line here is paid for on a cold context. The default output carries
+                            // only what changes what the agent does next — identity, where writes
+                            // land, the naming it must apply, and anything that is actually wrong.
+                            // Sources, confirmations and the per-project path table are diagnostics.
                             const diagnostics = args.diagnostics === true;
-                            const lines = [
-                                `## D365FO Workspace Configuration`,
-                                ``,
-                                `Model name      : ${modelName ?? '(not configured)'}  (source: ${modelSource})`,
-                                `Custom write path: ${effectiveWritePath ?? '(not configured)'}  (custom metadata, source: ${effectiveWriteSource})`,
-                                `Framework dir   : ${msFrameworkPath ?? '(not applicable — single-root setup)'}  (Microsoft metadata, read-only)`,
-                                `Project path    : ${projectPath ?? '(not detected)'}  (source: ${projectSource})`,
-                                `Env type        : ${envType}`,
-                                ``,
-                                ...prefixLines,
-                            ];
-                            // A switch moves which project is ACTIVE — nothing else. Reads never
-                            // needed it (they span every model regardless) and writes stay anchored
-                            // to the model the workspace resolved on its own, so switching cannot be
-                            // used to reach an object the cross-model guard refused. Say both here,
-                            // before anything is written, so the switch is not mistaken for access.
-                            const toolSwitch = configManager.getToolProjectSwitch();
-                            if (toolSwitch) {
-                                lines.push(`## ⚠️  Project switched — writes are NOT switched`, ``, `"${toolSwitch.forcedModel}" is now the ACTIVE project. This did not change what you ` +
-                                    `can read: get_object_info, search and find_references span every model, switched or ` +
-                                    `not, so a switch is never needed to look at another model's code. Writes stay ` +
-                                    `anchored to "${toolSwitch.anchorModel}" — the model the open workspace targets — and ` +
-                                    `a create/modify into "${toolSwitch.forcedModel}" will be refused.`, `Tell the user the model they asked about is owned by "${toolSwitch.forcedModel}" and let ` +
-                                    `THEM decide: extend it from "${toolSwitch.anchorModel}", or allow the write by adding ` +
-                                    `D365FO_CROSS_MODEL_WRITE_MODELS=${toolSwitch.forcedModel} to the server's .env — that ` +
-                                    `applies to the next attempt, no restart. Do not decide this on your own.`, ``);
-                            }
+                            const lines = diagnostics
+                                ? [
+                                    `## D365FO Workspace Configuration`,
+                                    ``,
+                                    `Model name      : ${modelName ?? '(not configured)'}  (source: ${modelSource})`,
+                                    `Custom write path: ${effectiveWritePath ?? '(not configured)'}  (custom metadata, source: ${effectiveWriteSource})`,
+                                    `Framework dir   : ${msFrameworkPath ?? '(not applicable — single-root setup)'}  (Microsoft metadata, read-only)`,
+                                    `Project path    : ${projectPath ?? '(not detected)'}  (source: ${projectSource})`,
+                                    `Env type        : ${envType}`,
+                                    ``,
+                                    ...prefixVerboseLines,
+                                ]
+                                : [
+                                    `## D365FO Workspace`,
+                                    ``,
+                                    `Model       : ${modelName ?? '(not configured)'}  (${modelSource})`,
+                                    ...prefixLines,
+                                    `Write path  : ${effectiveWritePath ?? '(not configured)'}`,
+                                    `Project     : ${projectPath ?? '(not detected)'}`,
+                                    `Env         : ${envType}`,
+                                ];
                             if (diagnostics) {
                                 lines.push(`## Suffix Configuration`, ``, `EXTENSION_SUFFIX: ${objectSuffixEnv ?? '(not set)'}`, `Effective suffix: ${effectiveSuffix || '(none)'}`, effectiveSuffix
                                     ? `✅ EXTENSION_SUFFIX is set — new objects will have suffix "${effectiveSuffix}" appended (e.g. MyTable${effectiveSuffix}).`
                                     : `ℹ️  EXTENSION_SUFFIX is not set. No suffix will be applied. This is normal — most projects use prefixes only.`, ``);
                             }
                             else if (effectiveSuffix) {
-                                lines.push(`Suffix          : "${effectiveSuffix}" appended to new objects (EXTENSION_SUFFIX)`, ``);
+                                lines.push(`Suffix      : "${effectiveSuffix}" appended to new objects (EXTENSION_SUFFIX)`);
                             }
                             // Extension naming: prefix is the infix unless EXTENSION_NAMING_STYLE="model-name"
                             // (embeds the model name instead, VS default). Tool always normalises the token —
@@ -379,40 +383,48 @@ export function registerToolHandler(server, context) {
                             const sampleElemExt = extNamingStyle === 'model-name' && writeModel
                                 ? `CustTable.${writeModel}`
                                 : `CustTable.${extInfix}Extension`;
-                            lines.push(`## Extension Naming`, ``, `EXTENSION_NAMING_STYLE: ${process.env.EXTENSION_NAMING_STYLE?.trim() || '(not set → "prefix")'}`, extNamingStyle === 'model-name'
-                                ? `✅ model-name style — extension token is the MODEL NAME (Visual Studio default).`
-                                : `ℹ️  prefix style (default) — extension token is the EXTENSION_PREFIX infix.`, `  • Extension class  → ${sampleClassExt}`, `  • Element extension → ${sampleElemExt}`, `  ⚠️  Pass the BASE object name (e.g. "CustTable") to d365fo_file(action="create") and let the tool apply the token — any infix you embed will be normalised to the above.`, ``);
-                            if (isPlaceholder) {
-                                const rawDetectedModel = await configManager.getRawAutoDetectedModelName();
-                                const detectedHint = rawDetectedModel
-                                    ? `> ✅ Auto-detected from .rnrproj: **${rawDetectedModel}**\n` +
-                                        `> Update your .mcp.json: set \`modelName\` to \`"${rawDetectedModel}"\``
-                                    : `> ⚠️ No .rnrproj was found — make sure the MCP server is running in the right directory.`;
-                                lines.push(`⛔ CONFIGURATION PROBLEM — model name "${modelName}" is a placeholder, not a real D365FO model.`, ``, `**YOU MUST STOP** and tell the user:`, `> The configured model name "${modelName}" is a placeholder.`, detectedHint, `>`, `> Please check that:`, `> 1. The MCP server is running in the correct workspace directory`, `> 2. The .mcp.json / mcp.json file has the correct modelName`, `> 3. The projectPath points to a valid .rnrproj file`, `>`, `> Do you want to fix the configuration first, or continue with built-in tools (limited functionality)?`);
-                            }
-                            else if (isStandardMsModel) {
-                                const allProj = configManager.getAllDetectedProjects();
-                                const customCandidates = allProj.filter(p => isCustomModel(p.modelName));
-                                const hint = customCandidates.length > 0
-                                    ? `Available custom models: ${customCandidates.map(p => p.modelName).join(', ')}\n` +
-                                        `Switch with: get_workspace_info(projectName="<model>")`
-                                    : `No custom models found under D365FO_SOLUTIONS_PATH. Check your project configuration.`;
-                                lines.push(`⛔ CONFIGURATION PROBLEM — model name "${modelName}" is a Microsoft standard/demo model, not a custom model.`, ``, `**YOU MUST STOP** and tell the user:`, `> The auto-detected model "${modelName}" is a Microsoft standard model.`, `> This usually happens when a new VS project was created and the default model`, `> in the project wizard ("FleetManagement") was not changed to the correct custom model.`, `>`, `> How to fix:`, `> 1. In Visual Studio, open the .rnrproj file and change <Model>FleetManagement</Model>`, `>    to the correct model name (e.g. <Model>ContosoCore</Model>).`, `> 2. OR explicitly switch to a known project:`, `>    ${hint}`, `> 3. OR add the correct modelName to .mcp.json.`);
+                            if (diagnostics) {
+                                lines.push(`## Extension Naming`, ``, `EXTENSION_NAMING_STYLE: ${process.env.EXTENSION_NAMING_STYLE?.trim() || '(not set → "prefix")'}`, extNamingStyle === 'model-name'
+                                    ? `✅ model-name style — extension token is the MODEL NAME (Visual Studio default).`
+                                    : `ℹ️  prefix style (default) — extension token is the EXTENSION_PREFIX infix.`, `  • Extension class  → ${sampleClassExt}`, `  • Element extension → ${sampleElemExt}`, `  ⚠️  Pass the BASE object name (e.g. "CustTable") to d365fo_file(action="create") and let the tool apply the token — any infix you embed will be normalised to the above.`, ``);
                             }
                             else {
-                                lines.push(`✅ Configuration looks valid. Proceed with D365FO operations using model "${modelName}".`);
+                                // The samples ARE the instruction: the style name and the token rule
+                                // add nothing once the two produced names are in front of the agent.
+                                lines.push(`Extensions  : ${sampleClassExt} · ${sampleElemExt}  ` +
+                                    `(pass the BASE name to d365fo_file(create) — the tool applies the token)`);
                             }
                             const allProjects = configManager.getAllDetectedProjects();
                             if (allProjects.length > 1) {
-                                lines.push(``);
-                                lines.push(`## Available Projects`);
-                                lines.push(``);
-                                for (const p of allProjects) {
-                                    const active = p.projectPath === projectPath ? '▶ ' : '  ';
-                                    lines.push(`${active}${p.modelName.padEnd(40)} ${p.projectPath}`);
+                                if (diagnostics) {
+                                    lines.push(``);
+                                    lines.push(`## Available Projects`);
+                                    lines.push(``);
+                                    for (const p of allProjects) {
+                                        const active = p.projectPath === projectPath ? '▶ ' : '  ';
+                                        lines.push(`${active}${p.modelName.padEnd(40)} ${p.projectPath}`);
+                                    }
+                                    lines.push(``);
+                                    lines.push(`To switch project: call get_workspace_info with projectName = "<ModelName>"`);
+                                }
+                                else {
+                                    // Names only: a switch is by projectName, so the paths are dead
+                                    // weight — and one solution can hold dozens of them. Duplicated
+                                    // model names (several projects, one model) collapse to one entry.
+                                    const seen = new Set();
+                                    const names = [];
+                                    for (const p of allProjects) {
+                                        const key = p.modelName.toLowerCase();
+                                        if (seen.has(key))
+                                            continue;
+                                        seen.add(key);
+                                        names.push(p.projectPath === projectPath ? `▶${p.modelName}` : p.modelName);
+                                    }
+                                    const shown = names.slice(0, PROJECT_NAMES_SHOWN);
+                                    const rest = names.length - shown.length;
+                                    lines.push(`Projects    : ${shown.join(', ')}${rest > 0 ? `, +${rest} more` : ''}  ` +
+                                        `(switch: get_workspace_info(projectName="<ModelName>"))`);
                                 }
-                                lines.push(``);
-                                lines.push(`To switch project: call get_workspace_info with projectName = "<ModelName>"`);
                             }
                             // Index freshness — compare workspace mtimes vs last_indexed_at.
                             try {
@@ -421,7 +433,7 @@ export function registerToolHandler(server, context) {
                                     ? nodePath.join(effectiveWritePath, modelName)
                                     : null;
                                 const staleness = checkIndexStaleness(lastIndexedAt, modelMetadataDir);
-                                lines.push('', ...staleness.lines);
+                                lines.push(...(diagnostics ? ['', ...staleness.lines] : staleness.compactLines));
                             }
                             catch {
                                 // Freshness reporting is best-effort — never break get_workspace_info
@@ -471,11 +483,51 @@ export function registerToolHandler(server, context) {
                             // Context Snapshot — recently edited objects + uncommitted X++ changes. Best-effort.
                             try {
                                 const snapshot = await buildContextSnapshot(context);
-                                lines.push('', ...renderContextSnapshotSection(snapshot));
+                                lines.push(...(diagnostics
+                                    ? ['', ...renderContextSnapshotSection(snapshot)]
+                                    : renderContextSnapshotCompact(snapshot)));
                             }
                             catch {
                                 // Snapshot is additive — omit silently on failure.
                             }
+                            // Everything below is a broken/unusual state. It sits last so the facts
+                            // above stay one uninterrupted block in the normal case, and so the
+                            // instruction the agent must act on is the last thing it reads.
+                            // A switch moves which project is ACTIVE — nothing else. Reads never
+                            // needed it (they span every model regardless) and writes stay anchored
+                            // to the model the workspace resolved on its own, so switching cannot be
+                            // used to reach an object the cross-model guard refused. Say both here,
+                            // before anything is written, so the switch is not mistaken for access.
+                            const toolSwitch = configManager.getToolProjectSwitch();
+                            if (toolSwitch) {
+                                lines.push(``, `## ⚠️  Project switched — writes are NOT switched`, ``, `"${toolSwitch.forcedModel}" is now the ACTIVE project. This did not change what you ` +
+                                    `can read: get_object_info, search and find_references span every model, switched or ` +
+                                    `not, so a switch is never needed to look at another model's code. Writes stay ` +
+                                    `anchored to "${toolSwitch.anchorModel}" — the model the open workspace targets — and ` +
+                                    `a create/modify into "${toolSwitch.forcedModel}" will be refused.`, `Tell the user the model they asked about is owned by "${toolSwitch.forcedModel}" and let ` +
+                                    `THEM decide: extend it from "${toolSwitch.anchorModel}", or allow the write by adding ` +
+                                    `D365FO_CROSS_MODEL_WRITE_MODELS=${toolSwitch.forcedModel} to the server's .env — that ` +
+                                    `applies to the next attempt, no restart. Do not decide this on your own.`);
+                            }
+                            if (isPlaceholder) {
+                                const rawDetectedModel = await configManager.getRawAutoDetectedModelName();
+                                const detectedHint = rawDetectedModel
+                                    ? `> ✅ Auto-detected from .rnrproj: **${rawDetectedModel}**\n` +
+                                        `> Update your .mcp.json: set \`modelName\` to \`"${rawDetectedModel}"\``
+                                    : `> ⚠️ No .rnrproj was found — make sure the MCP server is running in the right directory.`;
+                                lines.push(``, `⛔ CONFIGURATION PROBLEM — model name "${modelName}" is a placeholder, not a real D365FO model.`, ``, `**YOU MUST STOP** and tell the user:`, `> The configured model name "${modelName}" is a placeholder.`, detectedHint, `>`, `> Please check that:`, `> 1. The MCP server is running in the correct workspace directory`, `> 2. The .mcp.json / mcp.json file has the correct modelName`, `> 3. The projectPath points to a valid .rnrproj file`, `>`, `> Do you want to fix the configuration first, or continue with built-in tools (limited functionality)?`);
+                            }
+                            else if (isStandardMsModel) {
+                                const customCandidates = allProjects.filter(p => isCustomModel(p.modelName));
+                                const hint = customCandidates.length > 0
+                                    ? `Available custom models: ${customCandidates.map(p => p.modelName).join(', ')}\n` +
+                                        `Switch with: get_workspace_info(projectName="<model>")`
+                                    : `No custom models found under D365FO_SOLUTIONS_PATH. Check your project configuration.`;
+                                lines.push(``, `⛔ CONFIGURATION PROBLEM — model name "${modelName}" is a Microsoft standard/demo model, not a custom model.`, ``, `**YOU MUST STOP** and tell the user:`, `> The auto-detected model "${modelName}" is a Microsoft standard model.`, `> This usually happens when a new VS project was created and the default model`, `> in the project wizard ("FleetManagement") was not changed to the correct custom model.`, `>`, `> How to fix:`, `> 1. In Visual Studio, open the .rnrproj file and change <Model>FleetManagement</Model>`, `>    to the correct model name (e.g. <Model>ContosoCore</Model>).`, `> 2. OR explicitly switch to a known project:`, `>    ${hint}`, `> 3. OR add the correct modelName to .mcp.json.`);
+                            }
+                            else if (diagnostics) {
+                                lines.push(``, `✅ Configuration looks valid. Proceed with D365FO operations using model "${modelName}".`);
+                            }
                             return { content: [{ type: 'text', text: lines.join('\n') }] };
                         }
                         default:

package/dist/tools/validateFormPattern.d.ts

@@ -26,7 +26,7 @@ export interface AddControlPatternVerdict {
     allowedTypes: string[] | 'any';
 }
 /**
- * Pre-flight for modify_d365fo_file(add-control): when the target parent
+ * Pre-flight for d365fo_file(action="modify", operation="add-control"): when the target parent
  * container declares a sub-pattern, check the new control's type against the
  * children that sub-pattern allows. Returns null when the parent cannot be
  * found, declares no pattern, or the pattern is unknown — those cases never

package/dist/tools/validateFormPattern.js

@@ -115,7 +115,7 @@ export function isFormPatternEnforceEnabled() {
     return v !== 'false' && v !== '0' && v !== 'off';
 }
 /**
- * Pre-flight for modify_d365fo_file(add-control): when the target parent
+ * Pre-flight for d365fo_file(action="modify", operation="add-control"): when the target parent
  * container declares a sub-pattern, check the new control's type against the
  * children that sub-pattern allows. Returns null when the parent cannot be
  * found, declares no pattern, or the pattern is unknown — those cases never

package/dist/utils/indexStaleness.d.ts

@@ -20,7 +20,14 @@ export interface MtimeScanResult {
 export declare function findNewestMetadataMtime(rootDir: string): MtimeScanResult | null;
 export interface StalenessReport {
     status: 'fresh' | 'stale' | 'unknown';
+    /** Full "## Index Freshness" section — diagnostics=true only. */
     lines: string[];
+    /**
+     * Compact default: one `Index : …` line, and the fix only when the index is
+     * actually stale. The scan detail (newest file, files scanned) is diagnostics
+     * material — it changes nothing about what the agent should do next.
+     */
+    compactLines: string[];
 }
 /**
  * Compare workspace mtimes against the index timestamp and render a report

package/dist/utils/indexStaleness.js

@@ -78,27 +78,50 @@ export function checkIndexStaleness(lastIndexedAt, modelMetadataDir) {
     const lines = ['## Index Freshness', ''];
     if (!lastIndexedAt) {
         lines.push('ℹ️  Index has no freshness timestamp yet (built before this feature or never built).', '   It will be recorded on the next build-database run or update_symbol_index call.');
-        return { status: 'unknown', lines };
+        return {
+            status: 'unknown',
+            lines,
+            compactLines: ['Index       : no freshness timestamp yet (never indexed?)'],
+        };
     }
     const indexedAtMs = Date.parse(lastIndexedAt);
     const ageHours = Math.round((Date.now() - indexedAtMs) / 3_600_000);
     lines.push(`Last indexed   : ${lastIndexedAt} (${ageHours} h ago)`);
     if (!modelMetadataDir) {
         lines.push('ℹ️  Model metadata folder not resolved — cannot compare workspace mtimes.');
-        return { status: 'unknown', lines };
+        return {
+            status: 'unknown',
+            lines,
+            compactLines: [`Index       : indexed ${ageHours} h ago (model folder not resolved — not compared)`],
+        };
     }
     const scan = findNewestMetadataMtime(modelMetadataDir);
     if (!scan) {
         lines.push(`ℹ️  No metadata files found under ${modelMetadataDir} — nothing to compare.`);
-        return { status: 'unknown', lines };
+        return {
+            status: 'unknown',
+            lines,
+            compactLines: [`Index       : indexed ${ageHours} h ago (no metadata files to compare)`],
+        };
     }
     lines.push(`Newest file    : ${path.basename(scan.newestFile)} (${new Date(scan.newestMtime).toISOString()})` +
         (scan.truncated ? ` — scanned first ${MAX_SCANNED_FILES} files` : ` — ${scan.scannedFiles} files scanned`));
     if (scan.newestMtime > indexedAtMs + TOLERANCE_MS) {
         lines.push('', '⚠️  **INDEX IS STALE** — the workspace contains files newer than the last index update.', `   Newest change: ${scan.newestFile}`, '   Symbol lookups may return outdated signatures/fields for recently edited objects.', `   Fix: call \`update_symbol_index(filePath="${scan.newestFile.replace(/\\/g, '\\\\')}")\` for the changed file(s),`, '   or run `npm run build-database` (EXTRACT_MODE=custom) for a full custom-model refresh.');
-        return { status: 'stale', lines };
+        return {
+            status: 'stale',
+            lines,
+            compactLines: [
+                `Index       : ⚠️  STALE — indexed ${ageHours} h ago, workspace has newer files (lookups may be outdated)`,
+                `              Fix: update_symbol_index(filePath="${scan.newestFile.replace(/\\/g, '\\\\')}")`,
+            ],
+        };
     }
     lines.push('✅ Index is up to date with the workspace.');
-    return { status: 'fresh', lines };
+    return {
+        status: 'fresh',
+        lines,
+        compactLines: [`Index       : up to date (indexed ${ageHours} h ago)`],
+    };
 }
 //# sourceMappingURL=indexStaleness.js.map

package/dist/workspace/contextSnapshot.d.ts

@@ -60,9 +60,11 @@ export interface ContextSnapshot {
  */
 export declare function buildContextSnapshot(context: XppServerContext): Promise<ContextSnapshot>;
 /**
- * Render the snapshot's "live" portion (recent objects + uncommitted changes)
- * as markdown lines for embedding in get_workspace_info. Identity/prefix/index
- * sections are already covered by that tool, so this only adds what is new.
+ * The same "live" portion as renderContextSnapshotSection, folded into at most
+ * two lines for get_workspace_info's default output. Names only enough recent
+ * objects to orient the agent — the full list, with timestamps and every
+ * uncommitted path, stays behind diagnostics=true and review_workspace_changes.
  */
+export declare function renderContextSnapshotCompact(snapshot: ContextSnapshot): string[];
 export declare function renderContextSnapshotSection(snapshot: ContextSnapshot): string[];
 //# sourceMappingURL=contextSnapshot.d.ts.map

package/dist/workspace/contextSnapshot.js

@@ -160,6 +160,28 @@ export async function buildContextSnapshot(context) {
  * as markdown lines for embedding in get_workspace_info. Identity/prefix/index
  * sections are already covered by that tool, so this only adds what is new.
  */
+/** How many recent objects the compact rendering names before summarising. */
+const COMPACT_RECENT_SHOWN = 3;
+/**
+ * The same "live" portion as renderContextSnapshotSection, folded into at most
+ * two lines for get_workspace_info's default output. Names only enough recent
+ * objects to orient the agent — the full list, with timestamps and every
+ * uncommitted path, stays behind diagnostics=true and review_workspace_changes.
+ */
+export function renderContextSnapshotCompact(snapshot) {
+    const lines = [];
+    if (snapshot.recentObjects.length > 0) {
+        const shown = snapshot.recentObjects
+            .slice(0, COMPACT_RECENT_SHOWN)
+            .map(o => `${o.name} [${o.type}]`);
+        const rest = snapshot.recentObjects.length - shown.length;
+        lines.push(`Recent edits: ${shown.join(', ')}${rest > 0 ? ` (+${rest} more)` : ''}`);
+    }
+    if (snapshot.uncommittedFiles.length > 0) {
+        lines.push(`Uncommitted : ${snapshot.uncommittedFiles.length} X++ file(s) — review_workspace_changes`);
+    }
+    return lines;
+}
 export function renderContextSnapshotSection(snapshot) {
     const lines = ['## Context Snapshot', ''];
     if (snapshot.activeObject) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "d365fo-mcp",
-  "version": "1.8.5",
+  "version": "1.9.0",
   "description": "MCP Server for X++ Code Completion in D365 Finance & Operations",
   "type": "module",
   "main": "dist/index.js",