d365fo-mcp 1.8.4 → 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/scripts/build-database.js

@@ -1,6 +1,6 @@
 // src/utils/loadEnv.ts
 import dotenv from "dotenv";
-import { existsSync as existsSync2 } from "fs";
+import { existsSync as existsSync2, readFileSync as readFileSync2, statSync } from "fs";
 import { dirname as dirname2, isAbsolute as isAbsolute2, join as join2, resolve as resolve2 } from "path";
 import { fileURLToPath } from "url";
 
@@ -606,6 +606,12 @@ function defaultPathEnv(baseDir) {
 
 // src/utils/loadEnv.ts
 var PATH_VARS = ["DB_PATH", "LABELS_DB_PATH", "METADATA_PATH"];
+var WRITE_POLICY_VARS = [
+  "D365FO_ALLOW_CROSS_MODEL_WRITE",
+  "D365FO_CROSS_MODEL_WRITE_MODELS"
+];
+var writePolicySource = null;
+var writePolicyStamp = "";
 function installRootFrom(callerDir) {
   let dir = resolve2(callerDir, "..");
   for (let up = 0; up < 3; up++) {
@@ -621,6 +627,15 @@ function loadEnv(callerImportMetaUrl) {
   const callerDir = dirname2(fileURLToPath(callerImportMetaUrl));
   const envPath = process.env.ENV_FILE ? resolve2(process.env.ENV_FILE) : resolve2(installRootFrom(callerDir), ".env");
   const fromRealEnv = new Set(Object.keys(process.env));
+  writePolicySource = {
+    envPath,
+    pinned: new Set(WRITE_POLICY_VARS.filter((k) => fromRealEnv.has(k)))
+  };
+  try {
+    writePolicyStamp = String(statSync(envPath).mtimeMs);
+  } catch {
+    writePolicyStamp = "-";
+  }
   const result = dotenv.config({ path: envPath, quiet: true });
   if (result.error && !process.env.ENV_FILE) {
     dotenv.config({ quiet: true });

package/dist/scripts/build-fts.js

@@ -1,6 +1,6 @@
 // src/utils/loadEnv.ts
 import dotenv from "dotenv";
-import { existsSync as existsSync2 } from "fs";
+import { existsSync as existsSync2, readFileSync as readFileSync2, statSync } from "fs";
 import { dirname as dirname2, isAbsolute as isAbsolute2, join as join2, resolve as resolve2 } from "path";
 import { fileURLToPath } from "url";
 
@@ -606,6 +606,12 @@ function defaultPathEnv(baseDir) {
 
 // src/utils/loadEnv.ts
 var PATH_VARS = ["DB_PATH", "LABELS_DB_PATH", "METADATA_PATH"];
+var WRITE_POLICY_VARS = [
+  "D365FO_ALLOW_CROSS_MODEL_WRITE",
+  "D365FO_CROSS_MODEL_WRITE_MODELS"
+];
+var writePolicySource = null;
+var writePolicyStamp = "";
 function installRootFrom(callerDir) {
   let dir = resolve2(callerDir, "..");
   for (let up = 0; up < 3; up++) {
@@ -621,6 +627,15 @@ function loadEnv(callerImportMetaUrl) {
   const callerDir = dirname2(fileURLToPath(callerImportMetaUrl));
   const envPath = process.env.ENV_FILE ? resolve2(process.env.ENV_FILE) : resolve2(installRootFrom(callerDir), ".env");
   const fromRealEnv = new Set(Object.keys(process.env));
+  writePolicySource = {
+    envPath,
+    pinned: new Set(WRITE_POLICY_VARS.filter((k) => fromRealEnv.has(k)))
+  };
+  try {
+    writePolicyStamp = String(statSync(envPath).mtimeMs);
+  } catch {
+    writePolicyStamp = "-";
+  }
   const result = dotenv.config({ path: envPath, quiet: true });
   if (result.error && !process.env.ENV_FILE) {
     dotenv.config({ quiet: true });

package/dist/scripts/extract-metadata.js

@@ -1,6 +1,6 @@
 // src/utils/loadEnv.ts
 import dotenv from "dotenv";
-import { existsSync as existsSync2 } from "fs";
+import { existsSync as existsSync2, readFileSync as readFileSync2, statSync } from "fs";
 import { dirname as dirname2, isAbsolute as isAbsolute2, join as join2, resolve as resolve2 } from "path";
 import { fileURLToPath } from "url";
 
@@ -606,6 +606,12 @@ function defaultPathEnv(baseDir) {
 
 // src/utils/loadEnv.ts
 var PATH_VARS = ["DB_PATH", "LABELS_DB_PATH", "METADATA_PATH"];
+var WRITE_POLICY_VARS = [
+  "D365FO_ALLOW_CROSS_MODEL_WRITE",
+  "D365FO_CROSS_MODEL_WRITE_MODELS"
+];
+var writePolicySource = null;
+var writePolicyStamp = "";
 function installRootFrom(callerDir) {
   let dir = resolve2(callerDir, "..");
   for (let up = 0; up < 3; up++) {
@@ -621,6 +627,15 @@ function loadEnv(callerImportMetaUrl) {
   const callerDir = dirname2(fileURLToPath(callerImportMetaUrl));
   const envPath = process.env.ENV_FILE ? resolve2(process.env.ENV_FILE) : resolve2(installRootFrom(callerDir), ".env");
   const fromRealEnv = new Set(Object.keys(process.env));
+  writePolicySource = {
+    envPath,
+    pinned: new Set(WRITE_POLICY_VARS.filter((k) => fromRealEnv.has(k)))
+  };
+  try {
+    writePolicyStamp = String(statSync(envPath).mtimeMs);
+  } catch {
+    writePolicyStamp = "-";
+  }
   const result = dotenv.config({ path: envPath, quiet: true });
   if (result.error && !process.env.ENV_FILE) {
     dotenv.config({ quiet: true });

package/dist/server/toolSchemas/getWorkspaceInfo.js

@@ -5,13 +5,13 @@
  */
 export const getWorkspaceInfoTool = {
     name: 'get_workspace_info',
-    description: `ALWAYS call FIRST at session start. Returns model name, package path, framework directory, project path, environment type, and EXTENSION_PREFIX. Flags placeholder model names and missing prefix. Use projectName/projectPath params for solution switching. This is the authoritative source for target model — not search results.`,
+    description: `ALWAYS call FIRST at session start. Returns model name, package path, framework directory, project path, environment type, and EXTENSION_PREFIX. Flags placeholder model names and missing prefix. projectName/projectPath ONLY when the USER changed project. This is the authoritative source for target model — not search results.`,
     inputSchema: {
         type: 'object',
         properties: {
             projectName: {
                 type: 'string',
-                description: 'Preferred way to switch projects. Just the model name, e.g. "ContosoEDS" or "ContosoBank". The server resolves the full path from D365FO_SOLUTIONS_PATH automatically. Use this when the user says "switch to <project>" or opens a different solution.',
+                description: 'Only when the USER says "switch to <project>". Just the model name, e.g. "ContosoEDS"; path resolved from D365FO_SOLUTIONS_PATH. NOT a way to reach another model — reads span every model already, writes stay in the workspace model.',
             },
             projectPath: {
                 type: 'string',
@@ -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

@@ -3806,7 +3806,8 @@ export async function handleCreateD365File(request, context) {
             objectName: args.objectName,
             objectType: args.objectType,
             owningModel: actualModelName,
-            activeModel: getConfigManager().getModelName() ?? '',
+            activeModel: getConfigManager().getWriteAnchorModel() ?? '',
+            toolSwitchedModel: getConfigManager().getToolProjectSwitch()?.forcedModel ?? null,
             action: 'create',
         });
         if (crossModelCreateRefusal) {
@@ -4711,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/createLabel.js

@@ -456,7 +456,8 @@ export async function createLabelTool(request, context) {
             objectType: 'label',
             owningModel: model,
             owningPackage: resolvedPackageName,
-            activeModel: configManager.getModelName() ?? '',
+            activeModel: configManager.getWriteAnchorModel() ?? '',
+            toolSwitchedModel: configManager.getToolProjectSwitch()?.forcedModel ?? null,
             action: 'create',
         });
         if (crossModelLabelRefusal) {

package/dist/tools/d365foFileOpSpecs.js

@@ -73,7 +73,11 @@ export const D365FO_FILE_PARAM_SPECS = {
     fieldMandatory: { type: 'boolean', description: 'Mark the field Mandatory=Yes.' },
     fieldLabel: { type: 'string', description: 'Field label.' },
     fieldHelpText: { type: 'string', description: 'Field help text.' },
-    fieldEnumType: { type: 'string', description: 'Enum name to set on an enum-typed field.' },
+    fieldEnumType: {
+        type: 'string',
+        description: 'Enum name for an enum-typed field. On add-field this is all an enum field needs — ' +
+            'it writes AxTableFieldEnum + EnumType, no EDT.',
+    },
     fieldStringSize: { type: 'string', description: 'String size to set on a string-typed field.' },
     dataField: {
         type: 'string',
@@ -267,9 +271,12 @@ export const D365FO_FILE_OP_SPECS = {
     },
     'add-field': {
         required: ['fieldName'],
-        optional: ['fieldType', 'fieldBaseType', 'fieldMandatory', 'fieldLabel', 'dataField', 'dataSource', 'fieldGroupName'],
-        mutationOneOf: ['fieldType', 'dataField'],
-        note: 'Table/table-extension: fieldType (EDT) is REQUIRED. data-entity-extension: pass dataField AND ' +
+        optional: ['fieldType', 'fieldBaseType', 'fieldEnumType', 'fieldMandatory', 'fieldLabel', 'dataField', 'dataSource', 'fieldGroupName'],
+        mutationOneOf: ['fieldType', 'fieldEnumType', 'dataField'],
+        note: 'Enum field: pass fieldEnumType="<enum name>" and NO fieldType — an enum-typed table field ' +
+            'is an AxTableFieldEnum with an EnumType and needs no EDT. (fieldType is the EDT name here, ' +
+            'never an XML element name like "AxTableFieldEnum".) ' +
+            'Table/table-extension: otherwise fieldType (EDT) is REQUIRED. data-entity-extension: pass dataField AND ' +
             'dataSource instead — BOTH, or nothing is written; a mapped field has no EDT of its own, it points ' +
             'at dataField on the entity data source dataSource. fieldGroupName is optional and only applies to ' +
             'a data-entity-extension: it appends the field to that BASE-entity field group (shipped extensions ' +

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/generateSmartForm.js

@@ -21,6 +21,7 @@ import { methodStubsForPattern, injectMethodStubs } from '../knowledge/formPatte
 import { findBaseFormXml } from './modifyD365File.js';
 import { getFieldControlMap, getTableTitleField } from '../utils/fieldControlTypes.js';
 import { lookupSymbolNocase } from '../utils/symbolLookup.js';
+import { scaffoldWriteRefusalResult } from './writeAnchorGuard.js';
 /**
  * Symbol types a form datasource may bind to. Views are indexed as 'view'
  * (see symbolIndex.indexViews) and are legal in <Table> just like tables.
@@ -560,6 +561,15 @@ export async function handleGenerateSmartForm(args, symbolIndex) {
     if (finalName !== name) {
         console.log(`[generateSmartForm] Applied naming: ${name} → ${finalName}`);
     }
+    // See generateSmartTable: the resolved model follows the ACTIVE project, the
+    // write anchor does not. Checked before the first byte is written.
+    const anchorRefusal = scaffoldWriteRefusalResult({
+        objectName: finalName,
+        objectType: 'form',
+        targetModel: resolvedModel,
+    });
+    if (anchorRefusal)
+        return anchorRefusal;
     // Generate XML: clone an existing form (preferred) or build from a template.
     // Without an explicit pattern, default to the majority pattern mined from
     // standard models (property_stats), falling back to SimpleList.

package/dist/tools/generateSmartReport.js

@@ -32,6 +32,7 @@ import { resolveObjectPrefix, applyObjectPrefix, getObjectSuffix, applyObjectSuf
 import { extractModelFromProject, findProjectInSolution } from '../utils/projectUtils.js';
 import { normalizeD365Xml } from '../utils/d365XmlNormalizer.js';
 import { canonicalSymbolName, lookupSymbolNocase } from '../utils/symbolLookup.js';
+import { scaffoldWriteRefusalResult } from './writeAnchorGuard.js';
 export const generateSmartReportTool = {
     name: 'generate_smart_report',
     description: `🎨 AI-driven SSRS report generation — creates up to 7 D365FO objects in one call.
@@ -221,6 +222,16 @@ export async function handleGenerateSmartReport(args, symbolIndex, bridge) {
     finalName = applyObjectSuffix(finalName, objectSuffix);
     if (finalName !== name)
         log(`Applied naming: ${name} → ${finalName}`);
+    // See generateSmartTable: the resolved model follows the ACTIVE project, the
+    // write anchor does not. A report scaffold writes several objects at once, so
+    // this is checked before any of them exists.
+    const anchorRefusal = scaffoldWriteRefusalResult({
+        objectName: finalName,
+        objectType: 'report',
+        targetModel: resolvedModel,
+    });
+    if (anchorRefusal)
+        return anchorRefusal;
     // Derived object names
     const tmpTableName = `${finalName}Tmp`;
     const contractClassName = `${finalName}Contract`;

package/dist/tools/generateSmartTable.js

@@ -13,6 +13,7 @@ import { ProjectFileManager } from './createD365File.js';
 import { extractModelFromProject, findProjectInSolution } from '../utils/projectUtils.js';
 import { normalizeD365Xml } from '../utils/d365XmlNormalizer.js';
 import { lookupSymbolNocase } from '../utils/symbolLookup.js';
+import { scaffoldWriteRefusalResult } from './writeAnchorGuard.js';
 export const generateSmartTableTool = {
     name: 'generate_smart_table',
     description: 'Generate AxTable XML with AI-driven field/index/relation suggestions based on indexed patterns. Can copy structure from existing tables, analyze table group patterns, or use field hints.',
@@ -559,6 +560,16 @@ export async function handleGenerateSmartTable(args, symbolIndex, bridge) {
     if (finalName !== name) {
         console.log(`[generateSmartTable] Applied naming: ${name} → ${finalName}`);
     }
+    // Where this scaffold would land, checked before anything is written. The
+    // model above comes from the ACTIVE project, which a get_workspace_info switch
+    // moves; writes stay anchored to the model the workspace resolved on its own.
+    const anchorRefusal = scaffoldWriteRefusalResult({
+        objectName: finalName,
+        objectType: 'table',
+        targetModel: resolvedModel,
+    });
+    if (anchorRefusal)
+        return anchorRefusal;
     // Generate standard methods (find, exist) based on primary key fields
     const generatedMethods = [];
     if (requestedMethods && requestedMethods.length > 0) {