d365fo-mcp 1.0.0

package/dist/utils/metadataResolver.js

@@ -0,0 +1,277 @@
+/**
+ * Metadata Resolver
+ *
+ * Resolves D365FO object metadata from the local extracted-metadata/ folder.
+ * The SQLite DB stores file_path values that point to the Azure DevOps build-agent
+ * (e.g. C:\home\vsts\work\1\...) which is never accessible at runtime.
+ * Instead, this module reads the pre-extracted JSON/XML from extracted-metadata/.
+ *
+ * Folder layout:
+ *   extracted-metadata/{ModelName}/classes/{ClassName}.json   → { name, model, methods[], ... }
+ *   extracted-metadata/{ModelName}/enums/{EnumName}.json      → { raw: "<xml>..." }
+ *   extracted-metadata/{ModelName}/tables/{TableName}.json    → { name, model, fields[], ... }
+ */
+import { promises as fs } from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import { getConfigManager, fallbackPackagePath } from './configManager.js';
+// Resolve path relative to this file, not to process.cwd().
+// METADATA_PATH env var allows multi-instance setups to point at different folders.
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+// METADATA_PATH env var lets each server instance point at its own extracted-metadata folder.
+const EXTRACTED_METADATA_BASE = process.env.METADATA_PATH
+    ? path.resolve(process.env.METADATA_PATH)
+    : path.resolve(__dirname, '../../extracted-metadata');
+// Legacy fallback (not overridden by METADATA_PATH): some DB file_path values point into metadata/.
+const METADATA_BASE = path.resolve(__dirname, '../../metadata');
+/**
+ * Build the absolute path to an extracted-metadata JSON file.
+ * Returns null if the file doesn't exist (no throw).
+ */
+export async function resolveMetadataJsonPath(model, objectType, name) {
+    const filePath = path.join(EXTRACTED_METADATA_BASE, model, objectType, `${name}.json`);
+    try {
+        await fs.access(filePath);
+        return filePath;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read class metadata from extracted-metadata JSON.
+ * Returns null if the file is not available.
+ */
+export async function readClassMetadata(model, className) {
+    const filePath = await resolveMetadataJsonPath(model, 'classes', className);
+    if (!filePath)
+        return null;
+    try {
+        const raw = await fs.readFile(filePath, 'utf-8');
+        const data = JSON.parse(raw);
+        // Parameters may be stored as raw PowerShell-serialized strings, e.g. "@{type=RecId; name=_legalEntityRecId}"
+        for (const method of data.methods ?? []) {
+            method.parameters = (method.parameters ?? []).map((p) => {
+                if (typeof p === 'string') {
+                    const typeMatch = p.match(/type=([^;}\s]+)/);
+                    const nameMatch = p.match(/name=([^;}\s]+)/);
+                    return {
+                        type: typeMatch?.[1] ?? 'var',
+                        name: nameMatch?.[1] ?? '_param',
+                    };
+                }
+                return p;
+            });
+        }
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read a specific method from extracted class metadata.
+ */
+export async function readMethodMetadata(model, className, methodName) {
+    const classData = await readClassMetadata(model, className);
+    if (!classData)
+        return null;
+    return classData.methods.find(m => m.name === methodName) ?? null;
+}
+/**
+ * Read the raw XML string from an extracted-metadata enum JSON file.
+ * Returns null if not available.
+ */
+export async function readEnumRawXml(model, enumName) {
+    // Try extracted-metadata/ first, then metadata/ (DB file_path may point here)
+    for (const base of [EXTRACTED_METADATA_BASE, METADATA_BASE]) {
+        const filePath = path.join(base, model, 'enums', `${enumName}.json`);
+        try {
+            await fs.access(filePath);
+            const raw = await fs.readFile(filePath, 'utf-8');
+            const data = JSON.parse(raw);
+            return typeof data.raw === 'string' ? data.raw : null;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+/**
+ * Read the raw XML string from an extracted-metadata EDT JSON file.
+ * Returns null if not available.
+ */
+export async function readEdtRawXml(model, edtName) {
+    // Try extracted-metadata/ first, then metadata/ (DB file_path may point here)
+    for (const base of [EXTRACTED_METADATA_BASE, METADATA_BASE]) {
+        const filePath = path.join(base, model, 'edts', `${edtName}.json`);
+        try {
+            await fs.access(filePath);
+            const raw = await fs.readFile(filePath, 'utf-8');
+            const data = JSON.parse(raw);
+            return typeof data.raw === 'string' ? data.raw : null;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+export async function readViewMetadata(model, viewName) {
+    const filePath = await resolveMetadataJsonPath(model, 'views', viewName);
+    if (!filePath)
+        return null;
+    try {
+        const raw = await fs.readFile(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Attempt to remap a build-agent file path to the locally configured packages path.
+ *
+ * The SQLite index stores paths from the Azure DevOps CI build agent, e.g.:
+ *   Linux:   /home/vsts/work/1/PackagesLocalDirectory/applicationsuite/Foundation/AxForm/CustTable.xml
+ *   Windows: C:\home\vsts\work\1\PackagesLocalDirectory\applicationsuite\Foundation\AxForm\CustTable.xml
+ *
+ * This extracts the relative part after "PackagesLocalDirectory" and joins it with
+ * the locally configured packagePath, so tools can read the XML from a local D365FO
+ * installation even though the DB path itself points to a non-existent CI machine.
+ *
+ * Returns null when the path cannot be remapped or the remapped file does not exist.
+ */
+export async function resolveDbPathLocally(dbFilePath) {
+    // Normalise separators so the regex matches both Linux and Windows DB paths
+    const normalised = dbFilePath.replace(/\\/g, '/');
+    const match = normalised.match(/PackagesLocalDirectory\/(.+)$/i);
+    if (!match)
+        return null;
+    const relativePart = match[1]; // e.g. "applicationsuite/Foundation/AxForm/CustTable.xml"
+    const configManager = getConfigManager();
+    await configManager.ensureLoaded();
+    const localPackagePath = configManager.getPackagePath() || fallbackPackagePath();
+    // Convert forward slashes back to the OS separator
+    const localPath = path.join(localPackagePath, ...relativePart.split('/'));
+    try {
+        await fs.access(localPath);
+        return localPath;
+    }
+    catch {
+        return null; // File does not exist locally
+    }
+}
+/**
+ * Query the symbol index DB to find what top-level types a given name exists as.
+ * Ignores 'method' and 'field' rows — those are children, not top-level objects.
+ *
+ * @param db - better-sqlite3 Database instance (symbolIndex.db)
+ * @param name - the object name to look up
+ */
+export function detectObjectTypeInDb(db, name) {
+    try {
+        const stmt = db.prepare(`
+      SELECT DISTINCT type, model
+      FROM symbols
+      WHERE name = ?
+        AND type NOT IN ('method', 'field')
+      ORDER BY type
+      LIMIT 10
+    `);
+        return stmt.all(name);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Build a Markdown warning section when an object was looked up as one type
+ * (e.g. 'class') but actually exists in the DB as a different type (form, table …).
+ *
+ * Returns an empty string when no mismatch is detected.
+ *
+ * @param db           - better-sqlite3 Database instance
+ * @param name         - the object name that was not found
+ * @param expectedType - the type that was searched for (default: 'class')
+ */
+export function buildObjectTypeMismatchMessage(db, name, expectedType = 'class') {
+    const existingTypes = detectObjectTypeInDb(db, name);
+    if (existingTypes.length === 0)
+        return '';
+    const expectedEntries = existingTypes.filter(t => t.type === expectedType);
+    const otherEntries = existingTypes.filter(t => t.type !== expectedType);
+    // Only emit a warning when the object does NOT exist as the expected type
+    if (expectedEntries.length > 0 || otherEntries.length === 0)
+        return '';
+    let section = `\n\n⚠️ **Type Mismatch:** \`${name}\` is not a **${expectedType}** — it exists in the index as:\n\n`;
+    for (const entry of otherEntries) {
+        section += `- **${entry.type}** (model: ${entry.model})\n`;
+    }
+    const uniqueTypes = [...new Map(otherEntries.map(e => [e.type, e])).values()];
+    section += `\n💡 **Use the correct tool instead:**\n`;
+    for (const entry of uniqueTypes) {
+        switch (entry.type) {
+            case 'form':
+                section += `- \`get_object_info(objectType="form", name="${name}")\` — inspect form datasources, controls, and methods\n`;
+                break;
+            case 'table':
+                section += `- \`get_object_info(objectType="table", name="${name}")\` — inspect table fields and methods\n`;
+                break;
+            case 'view':
+                section += `- \`get_object_info(objectType="view", name="${name}")\` — inspect view fields and methods\n`;
+                break;
+            case 'query':
+                section += `- \`get_object_info(objectType="query", name="${name}")\` — inspect query datasources\n`;
+                break;
+            case 'enum':
+                section += `- \`get_object_info(objectType="enum", name="${name}")\` — inspect enum values\n`;
+                break;
+        }
+    }
+    return section;
+}
+/**
+ * Heuristic: does a reader result's text indicate an object-resolution ("not found")
+ * failure, as opposed to a genuine operation error (parse failure, timeout, etc.)?
+ * Used to decide whether to append the not-found guidance below.
+ */
+export function isNotFoundResultText(text) {
+    if (!text)
+        return false;
+    return /\bnot found\b|could not resolve|does not exist/i.test(text);
+}
+/**
+ * Actionable guidance appended to a reader's "object not found" result.
+ *
+ * Steers the agent to the right MCP tools (search / update_symbol_index) and away
+ * from filesystem scanning (Get-ChildItem / Select-String / dir / ls / find), which
+ * is slow across 350+ model folders and can hang the VS 2022 MCP integration.
+ */
+export function buildNotFoundGuidance(name, objectType) {
+    return (`\n\n---\n` +
+        `🔎 **Resolve \`${name}\` (${objectType}) with the right tool — do not guess or grep the disk:**\n` +
+        `1. \`search\` / \`batch_search\` for \`${name}\` — the exact name may differ (model prefix, casing, suffix).\n` +
+        `2. Real object in a custom package that isn't indexed yet? Run ` +
+        `\`update_symbol_index({ filePath: "<absolute path to ${name}.xml>" })\`, and confirm ` +
+        `\`D365FO_CUSTOM_PACKAGES_PATH\` includes that package so the bridge + symbol index can see it.\n` +
+        `3. Just created it this session? The bridge may not have it yet — pass the file path, or it will be picked up after a refresh.\n\n` +
+        `⛔ Do NOT scan the filesystem (Get-ChildItem / Select-String / dir / ls / find) to locate D365FO objects — ` +
+        `it is slow, can hang the VS 2022 MCP integration, and bypasses metadata resolution. Use the tools above.`);
+}
+/**
+ * Build a friendly error explaining that the XML for this object type
+ * is not available in the current deployment (no D365FO installation).
+ */
+export function buildXmlNotAvailableMessage(objectType, objectName, dbFilePath) {
+    return (`❌ Cannot read ${objectType} metadata for "${objectName}".\n\n` +
+        `The metadata database was built on an Azure DevOps build agent and stores file paths\n` +
+        `that are not accessible in the current environment:\n` +
+        `  ${dbFilePath}\n\n` +
+        `To use this tool you need either:\n` +
+        `1. Run the MCP server locally on a D365FO Windows VM where that path exists, OR\n` +
+        `2. Ensure the ${objectType} XML files are accessible at the path above.\n\n` +
+        `Note: ${objectType}s are not included in the pre-extracted JSON metadata in older builds. Current extraction supports classes, tables, enums, EDTs, and views.`);
+}
+//# sourceMappingURL=metadataResolver.js.map

package/dist/utils/metadataResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadataResolver.js","sourceRoot":"","sources":["../../src/utils/metadataResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,4DAA4D;AAC5D,oFAAoF;AACpF,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,8FAA8F;AAC9F,MAAM,uBAAuB,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa;IACvD,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACzC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,0BAA0B,CAAC,CAAC;AACxD,oGAAoG;AACpG,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;AAyChE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAAa,EACb,UAA+B,EAC/B,IAAY;IAEZ,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IACvF,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AA8BD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAa,EACb,SAAiB;IAEjB,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC5E,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA2B,CAAC;QAEvD,8GAA8G;QAC9G,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YACxC,MAAM,CAAC,UAAU,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE;gBAC3D,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;oBAC1B,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;oBAC7C,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;oBAC7C,OAAO;wBACL,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK;wBAC7B,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ;qBACT,CAAC;gBAC5B,CAAC;gBACD,OAAO,CAAyB,CAAC;YACnC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAa,EACb,SAAiB,EACjB,UAAkB;IAElB,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC5D,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,OAAO,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI,IAAI,CAAC;AACpE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAa,EACb,QAAgB;IAEhB,8EAA8E;IAC9E,KAAK,MAAM,IAAI,IAAI,CAAC,uBAAuB,EAAE,aAAa,CAAC,EAAE,CAAC;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,OAAO,CAAC,CAAC;QACrE,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC1B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC7B,OAAO,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAa,EACb,OAAe;IAEf,8EAA8E;IAC9E,KAAK,MAAM,IAAI,IAAI,CAAC,uBAAuB,EAAE,aAAa,CAAC,EAAE,CAAC;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;QACnE,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC1B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC7B,OAAO,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAa,EACb,QAAgB;IAEhB,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACzE,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAA0B,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,UAAkB;IAC3D,4EAA4E;IAC5E,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAElD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACjE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,0DAA0D;IAEzF,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IACzC,MAAM,aAAa,CAAC,YAAY,EAAE,CAAC;IACnC,MAAM,gBAAgB,GACpB,aAAa,CAAC,cAAc,EAAE,IAAI,mBAAmB,EAAE,CAAC;IAE1D,mDAAmD;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAE1E,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,8BAA8B;IAC7C,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,EAAO,EACP,IAAY;IAEZ,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;;KAOvB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAA2C,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,8BAA8B,CAC5C,EAAO,EACP,IAAY,EACZ,YAAY,GAAW,OAAO;IAE9B,MAAM,aAAa,GAAG,oBAAoB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACrD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE1C,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;IAC3E,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;IAExE,0EAA0E;IAC1E,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEvE,IAAI,OAAO,GAAG,+BAA+B,IAAI,iBAAiB,YAAY,qCAAqC,CAAC;IACpH,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,OAAO,IAAI,OAAO,KAAK,CAAC,IAAI,cAAc,KAAK,CAAC,KAAK,KAAK,CAAC;IAC7D,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9E,OAAO,IAAI,0CAA0C,CAAC;IACtD,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,MAAM;gBACT,OAAO,IAAI,gDAAgD,IAAI,0DAA0D,CAAC;gBAC1H,MAAM;YACR,KAAK,OAAO;gBACV,OAAO,IAAI,iDAAiD,IAAI,2CAA2C,CAAC;gBAC5G,MAAM;YACR,KAAK,MAAM;gBACT,OAAO,IAAI,gDAAgD,IAAI,0CAA0C,CAAC;gBAC1G,MAAM;YACR,KAAK,OAAO;gBACV,OAAO,IAAI,iDAAiD,IAAI,oCAAoC,CAAC;gBACrG,MAAM;YACR,KAAK,MAAM;gBACT,OAAO,IAAI,gDAAgD,IAAI,8BAA8B,CAAC;gBAC9F,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAwB;IAC3D,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,iDAAiD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,UAAkB;IACpE,OAAO,CACL,WAAW;QACX,kBAAkB,IAAI,OAAO,UAAU,4DAA4D;QACnG,0CAA0C,IAAI,kEAAkE;QAChH,iEAAiE;QACjE,wDAAwD,IAAI,2BAA2B;QACvF,kGAAkG;QAClG,oIAAoI;QACpI,4GAA4G;QAC5G,0GAA0G,CAC3G,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAAkB,EAClB,UAAkB,EAClB,UAAkB;IAElB,OAAO,CACL,iBAAiB,UAAU,kBAAkB,UAAU,QAAQ;QAC/D,wFAAwF;QACxF,uDAAuD;QACvD,KAAK,UAAU,MAAM;QACrB,qCAAqC;QACrC,mFAAmF;QACnF,iBAAiB,UAAU,kDAAkD;QAC7E,SAAS,UAAU,6IAA6I,CACjK,CAAC;AACJ,CAAC"}

package/dist/utils/modelClassifier.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Model Classifier Utility
+ * Determines whether a D365 F&O model is custom or standard
+ *
+ * Logic:
+ * - Custom models are defined in CUSTOM_MODELS environment variable
+ * - Supports wildcards: Custom*, *Test, *Extension*
+ * - Models with EXTENSION_PREFIX are considered custom
+ * - Auto-detected models from workspace are automatically registered as custom
+ * - All other models are considered Microsoft standard models
+ */
+/**
+ * Register a model as custom (e.g., from auto-detection)
+ * This allows dynamically detected models to be treated as custom
+ */
+export declare function registerCustomModel(modelName: string): void;
+/**
+ * Clear all auto-detected custom models (for test isolation)
+ */
+export declare function clearAutoDetectedModels(): void;
+/**
+ * Check if a model is registered as auto-detected custom
+ */
+export declare function isAutoDetectedCustomModel(modelName: string): boolean;
+/**
+ * Get list of custom models from environment
+ */
+export declare function getCustomModels(): string[];
+/**
+ * Get extension prefix from environment
+ */
+export declare function getExtensionPrefix(): string;
+/**
+ * Get the explicitly configured target model name from the environment.
+ *
+ * D365FO_MODEL_NAME is the model the server was told to write into. It is set
+ * deliberately by the developer (e.g. per server instance), so the model it
+ * names is custom by definition — see isCustomModel().
+ *
+ * Returns empty string when not configured.
+ */
+export declare function getConfiguredModelName(): string;
+/**
+ * Get configurable object suffix from environment.
+ * Returns the raw EXTENSION_SUFFIX value (trailing underscores stripped).
+ * Empty string when not configured.
+ */
+export declare function getObjectSuffix(): string;
+/**
+ * Resolve the extension-naming style from the environment.
+ *
+ *  - 'prefix' (default): extension elements and extension classes embed the
+ *    EXTENSION_PREFIX as an infix, per Microsoft's prefix-based guideline
+ *    (e.g. CustTable.CrExtension, CustTableCr_Extension).
+ *
+ *  - 'model-name': extension elements and extension classes embed the MODEL NAME,
+ *    matching the Visual Studio developer-tools default
+ *    (e.g. CustTable.ContosoRobotics, CustTable_ContosoRobotics_Extension).
+ *    EXTENSION_PREFIX still applies to NEW objects and to fields/methods added
+ *    inside extensions — only the extension element/class token changes.
+ *
+ * Configured via EXTENSION_NAMING_STYLE. Any value other than 'model-name'
+ * (including unset) resolves to 'prefix' so existing setups are unchanged.
+ */
+export declare function getExtensionNamingStyle(): 'prefix' | 'model-name';
+/**
+ * Apply a configurable suffix to a NEW model element name.
+ * The suffix is appended at the end of the object name.
+ *
+ * Suffix does NOT apply to:
+ *  - Dot-notation extension elements (CustTable.XyExtension — suffix breaks MS naming)
+ *  - Extension classes ending with _Extension (SalesFormLetterXy_Extension)
+ *  - Names that already end with the suffix (case-insensitive)
+ *
+ * Examples with EXTENSION_SUFFIX="ZZ":
+ *   MyTable        → MyTableZZ
+ *   MyClass        → MyClassZZ
+ *   MyTableZZ      → MyTableZZ  (no double-suffix)
+ *   CustTable.XyExtension → CustTable.XyExtension (skip)
+ *   CustTableXy_Extension → CustTableXy_Extension (skip)
+ */
+export declare function applyObjectSuffix(objectName: string, suffix: string): string;
+/**
+ * Resolve the clean prefix to use when naming newly created D365FO objects.
+ *
+ * Microsoft naming guidelines (https://learn.microsoft.com/en-us/dynamics365/fin-ops-core/dev-itpro/extensibility/naming-guidelines-extensions):
+ *  - New model elements  → prefix concatenated directly: {Prefix}{ObjectName}  (e.g. WHSMyTable)
+ *  - Extension elements  → {BaseElement}.{Prefix}Extension                     (e.g. HCMWorker.WHSExtension)
+ *  - Extension classes   → {BaseElement}{Prefix}_Extension                     (e.g. SalesFormLetterContoso_Extension)
+ *  - Fields in extensions→ {Prefix}{FieldName}                                 (e.g. WHSApprovingWorker)
+ *
+ * Priority (EXTENSION_PREFIX has higher priority than modelName):
+ * 1. EXTENSION_PREFIX env var (trailing '_' stripped — the underscore is NOT part of the prefix)
+ * 2. modelName as fallback (only if EXTENSION_PREFIX is not set)
+ *
+ * Returns empty string when both are empty.
+ */
+export declare function resolveObjectPrefix(modelName: string): string;
+/**
+ * Derive the extension infix form from an already-resolved prefix.
+ *
+ * Extension elements (dot-notation and _Extension classes) embed the prefix
+ * as a PascalCase infix WITHOUT any underscore separator:
+ *   - Underscore-style EXTENSION_PREFIX "XY_"  → resolved prefix "XY"  → infix "Xy"
+ *   - Normal prefix "Contoso"                  → resolved prefix "Contoso" → infix "Contoso"
+ *   - All-caps prefix "WHS" with "WHS_" in env → infix "Whs"
+ *   - All-caps prefix "WHS" with "WHS" in env  → infix "WHS" (unchanged)
+ *
+ * Detection: if EXTENSION_PREFIX env var ends with '_', apply first-upper + rest-lower.
+ */
+export declare function deriveExtensionInfix(resolvedPrefix: string): string;
+/**
+ * Resolve the literal prefix TOKEN that `applyObjectPrefix` prepends to a
+ * REGULAR (non-extension) new object name for the CURRENT session — i.e. the
+ * exact substring that will appear at the start of e.g. an EDT/table/class
+ * Name in generated metadata (`{token}{ObjectName}`).
+ *
+ * Factored out of `applyObjectPrefix`'s "regular objects" branch (same
+ * underscore-style-vs-PascalCase derivation) so other callers that need to
+ * recognise/strip this token from ALREADY-GENERATED names — notably the eval
+ * golden oracle's prefix-agnostic comparison (src/eval/oracle/normalize.ts,
+ * see docs/AGENT_EVAL_LOOP.md §6.2) — don't have to duplicate the branching
+ * logic. Returns '' when no prefix is configured.
+ */
+export declare function resolveRegularObjectPrefixToken(modelName?: string): string;
+/**
+ * Apply prefix to a NEW model element name.
+ * Per MS guidelines, the prefix is concatenated directly (no separator):
+ *   WHSMyTable, MyPrefixMyClass, ContosoMyForm
+ *
+ * Underscore-style prefixes (EXTENSION_PREFIX="XY_") are handled specially:
+ *   - Regular objects (classes, tables, forms, …): prefix kept with underscore
+ *       XY_CustTable, XY_MyClass  (NOT XyCustTable)
+ *   - Extension elements (dot-notation or _Extension class infix): PascalCase, no underscore
+ *       CustTable.XyExtension, CustTableXy_Extension  (NOT CustTable.XY_Extension)
+ *
+ * CRITICAL for extension classes: If EXTENSION_PREFIX is set in .env,
+ * it should be used EXCLUSIVELY - never combined with modelName prefix.
+ * The function receives the ALREADY RESOLVED prefix (from resolveObjectPrefix),
+ * so it strips any existing suffix-prefix and replaces it with the current one.
+ *
+ * Case-insensitive check prevents double-prefixing.
+ */
+export declare function applyObjectPrefix(objectName: string, prefix: string, modelName?: string): string;
+/**
+ * Build the name of an EXTENSION ELEMENT (table extension, form extension, etc.)
+ * Format: {BaseElementName}.{Prefix}Extension
+ * Example: HCMWorker.WHSExtension, ContactPerson.ContosoCustomizations
+ *
+ * Never use just {BaseElement}.Extension — the prefix/infix is required to avoid conflicts.
+ */
+export declare function buildExtensionElementName(baseElement: string, prefix: string): string;
+/**
+ * Build the name of an EXTENSION CLASS (Chain of Command / augmentation class).
+ * Format: {BaseElement}{Prefix}_Extension
+ * Example: ContactPersonWHS_Extension, CustTableForm{Prefix}_Extension
+ *
+ * Never use just {BaseClass}_Extension — the infix is required.
+ */
+export declare function buildExtensionClassName(baseClass: string, prefix: string): string;
+/**
+ * Check if a model is custom (case-insensitive)
+ * @param modelName - Name of the model to check
+ * @returns true if model is custom, false if standard
+ */
+export declare function isCustomModel(modelName: string): boolean;
+/**
+ * Check if a model is standard (opposite of custom)
+ * @param modelName - Name of the model to check
+ * @returns true if model is standard Microsoft model
+ */
+export declare function isStandardModel(modelName: string): boolean;
+/**
+ * Filter models by type
+ * @param models - Array of model names
+ * @param type - 'custom' or 'standard'
+ * @returns Filtered array of model names
+ */
+export declare function filterModelsByType(models: string[], type: 'custom' | 'standard'): string[];
+//# sourceMappingURL=modelClassifier.d.ts.map

package/dist/utils/modelClassifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelClassifier.d.ts","sourceRoot":"","sources":["../../src/utils/modelClassifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAG3D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,IAAI,QAAQ,GAAG,YAAY,CAIjE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAiB5E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAY7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAUnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAiFhG;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUrF;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAajF;AAwBD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAoBxD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,EAAE,CAK1F"}