d365fo-mcp 1.0.0

package/dist/utils/modelClassifier.js

@@ -0,0 +1,373 @@
+/**
+ * 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
+ */
+// Runtime registry for auto-detected custom models
+const autoDetectedCustomModels = new Set();
+/**
+ * Register a model as custom (e.g., from auto-detection)
+ * This allows dynamically detected models to be treated as custom
+ */
+export function registerCustomModel(modelName) {
+    autoDetectedCustomModels.add(modelName);
+    console.error(`[ModelClassifier] Registered "${modelName}" as custom model (auto-detected)`);
+}
+/**
+ * Clear all auto-detected custom models (for test isolation)
+ */
+export function clearAutoDetectedModels() {
+    autoDetectedCustomModels.clear();
+}
+/**
+ * Check if a model is registered as auto-detected custom
+ */
+export function isAutoDetectedCustomModel(modelName) {
+    return autoDetectedCustomModels.has(modelName);
+}
+/**
+ * Get list of custom models from environment
+ */
+export function getCustomModels() {
+    return process.env.CUSTOM_MODELS?.split(',').map(m => m.trim()).filter(Boolean) || [];
+}
+/**
+ * Get extension prefix from environment
+ */
+export function getExtensionPrefix() {
+    return process.env.EXTENSION_PREFIX || '';
+}
+/**
+ * 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 function getConfiguredModelName() {
+    return process.env.D365FO_MODEL_NAME?.trim() || '';
+}
+/**
+ * Get configurable object suffix from environment.
+ * Returns the raw EXTENSION_SUFFIX value (trailing underscores stripped).
+ * Empty string when not configured.
+ */
+export function getObjectSuffix() {
+    return process.env.EXTENSION_SUFFIX?.trim().replace(/_+$/, '') || '';
+}
+/**
+ * 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 function getExtensionNamingStyle() {
+    return process.env.EXTENSION_NAMING_STYLE?.trim().toLowerCase() === 'model-name'
+        ? 'model-name'
+        : 'prefix';
+}
+/**
+ * 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 function applyObjectSuffix(objectName, suffix) {
+    if (!suffix)
+        return objectName;
+    // Skip extension elements — suffix would break MS naming conventions
+    if (objectName.includes('.') && objectName.toLowerCase().endsWith('extension')) {
+        return objectName;
+    }
+    if (objectName.endsWith('_Extension')) {
+        return objectName;
+    }
+    // Already has the suffix (case-insensitive)
+    if (objectName.toLowerCase().endsWith(suffix.toLowerCase())) {
+        return objectName;
+    }
+    return `${objectName}${suffix}`;
+}
+/**
+ * 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 function resolveObjectPrefix(modelName) {
+    const envPrefix = process.env.EXTENSION_PREFIX?.trim();
+    if (envPrefix) {
+        return envPrefix.replace(/_+$/, '');
+    }
+    if (modelName) {
+        return modelName.replace(/_+$/, '');
+    }
+    return '';
+}
+/**
+ * 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 function deriveExtensionInfix(resolvedPrefix) {
+    if (!resolvedPrefix)
+        return '';
+    const rawEnvPrefix = process.env.EXTENSION_PREFIX?.trim() ?? '';
+    const envHasUnderscore = rawEnvPrefix.endsWith('_');
+    if (envHasUnderscore) {
+        // XY_ → Xy  (first char uppercase, remaining chars lowercase)
+        return resolvedPrefix.charAt(0).toUpperCase() + resolvedPrefix.slice(1).toLowerCase();
+    }
+    // Normal PascalCase — just capitalize first letter, keep the rest as-is
+    return resolvedPrefix.charAt(0).toUpperCase() + resolvedPrefix.slice(1);
+}
+/**
+ * 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 function resolveRegularObjectPrefixToken(modelName) {
+    const resolved = resolveObjectPrefix(modelName ?? '');
+    if (!resolved)
+        return '';
+    const rawEnvPrefix = process.env.EXTENSION_PREFIX?.trim() ?? '';
+    const envHasUnderscore = rawEnvPrefix.endsWith('_');
+    return envHasUnderscore ? rawEnvPrefix : resolved.charAt(0).toUpperCase() + resolved.slice(1);
+}
+/**
+ * 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 function applyObjectPrefix(objectName, prefix, modelName) {
+    if (!prefix)
+        return objectName;
+    // model-name style embeds the model name instead of the prefix infix for extension
+    // elements/classes only (VS default); regular new objects are unaffected.
+    const useModelName = !!modelName && getExtensionNamingStyle() === 'model-name';
+    // Extension infix form — PascalCase without underscore (e.g. "XY" → "Xy" when env had "XY_")
+    const extensionInfix = deriveExtensionInfix(prefix);
+    // Regular object prefix keeps the underscore for underscore-style env prefixes
+    //   EXTENSION_PREFIX="XY_" → regularPrefix="XY_" → XY_CustTable
+    //   EXTENSION_PREFIX="Contoso" → regularPrefix="Contoso" → ContosoCustTable
+    const rawEnvPrefix = process.env.EXTENSION_PREFIX?.trim() ?? '';
+    const envHasUnderscore = rawEnvPrefix.endsWith('_');
+    const regularPrefix = envHasUnderscore
+        ? rawEnvPrefix
+        : prefix.charAt(0).toUpperCase() + prefix.slice(1);
+    // Dot-notation extension elements: BaseObject.{Infix}Extension (standard AOT naming)
+    // or BaseObject.ModelName (bare model name, as VS generates for model-name style).
+    if (objectName.includes('.')) {
+        const dotIdx = objectName.lastIndexOf('.');
+        const basePart = objectName.slice(0, dotIdx);
+        const suffixPart = objectName.slice(dotIdx + 1);
+        // Replaces whatever follows the dot, so re-running is idempotent.
+        if (useModelName) {
+            return `${basePart}.${modelName}`;
+        }
+        if (suffixPart.toLowerCase().endsWith('extension')) {
+            // Always normalize casing (e.g. "CTSOExtension" → "CtsoExtension").
+            const correctSuffix = `${extensionInfix}Extension`;
+            return `${basePart}.${correctSuffix}`;
+        }
+        // Bare model-name suffix (no "extension" word) — return as-is.
+        return objectName;
+    }
+    // Extension classes: infix goes before "_Extension".
+    // objectName must be the base class name + "_Extension" without any prefix infix.
+    if (objectName.endsWith('_Extension')) {
+        const baseName = objectName.slice(0, -'_Extension'.length);
+        // Strip any trailing model-name token first so re-running stays idempotent
+        // (avoids Base_ModelName_ModelName_Extension).
+        if (useModelName) {
+            let cleanBase = baseName.replace(/_+$/, '');
+            const lowerModel = modelName.toLowerCase();
+            if (cleanBase.toLowerCase().endsWith('_' + lowerModel)) {
+                cleanBase = cleanBase.slice(0, cleanBase.length - lowerModel.length - 1);
+            }
+            else if (cleanBase.toLowerCase().endsWith(lowerModel)) {
+                cleanBase = cleanBase.slice(0, cleanBase.length - lowerModel.length);
+            }
+            cleanBase = cleanBase.replace(/_+$/, '');
+            return `${cleanBase}_${modelName}_Extension`;
+        }
+        // Check if the extension infix is already present at the end (case-insensitive)
+        if (baseName.toLowerCase().endsWith(extensionInfix.toLowerCase())) {
+            return objectName; // Already has the correct infix, return as-is
+        }
+        // Inject the extension infix before "_Extension"
+        return `${baseName}${extensionInfix}_Extension`;
+    }
+    // Regular objects: prefix at the start. Check both the full regular prefix and,
+    // for underscore-style prefixes, the clean prefix without underscore, to avoid
+    // re-prefixing an already-prefixed name.
+    if (objectName.toLowerCase().startsWith(regularPrefix.toLowerCase())) {
+        return objectName;
+    }
+    if (envHasUnderscore && objectName.toLowerCase().startsWith(prefix.toLowerCase())) {
+        return objectName;
+    }
+    const normalizedName = objectName.charAt(0).toUpperCase() + objectName.slice(1);
+    return `${regularPrefix}${normalizedName}`;
+}
+/**
+ * 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 function buildExtensionElementName(baseElement, prefix) {
+    if (!prefix) {
+        throw new Error(`Extension element name requires a prefix. ` +
+            `Set EXTENSION_PREFIX in .env or pass modelName. ` +
+            `Bad pattern: "${baseElement}.Extension" (too generic, risk of conflicts).`);
+    }
+    const infix = deriveExtensionInfix(prefix);
+    return `${baseElement}.${infix}Extension`;
+}
+/**
+ * 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 function buildExtensionClassName(baseClass, prefix) {
+    if (!prefix) {
+        throw new Error(`Extension class name requires a prefix/infix. ` +
+            `Set EXTENSION_PREFIX in .env or pass modelName. ` +
+            `Bad pattern: "${baseClass}_Extension" (too generic, risk of conflicts).`);
+    }
+    // Derive the PascalCase infix form (e.g. "XY_" env → "Xy" infix, "Contoso" → "Contoso")
+    const infix = deriveExtensionInfix(prefix);
+    // Avoid double infix if baseClass already contains the infix
+    const infixToAdd = baseClass.toLowerCase().includes(infix.toLowerCase()) ? '' : infix;
+    return `${baseClass}${infixToAdd}_Extension`;
+}
+/**
+ * Check if a pattern matches a model name (supports wildcards)
+ * @param pattern - Pattern to match (e.g., "Custom*", "*Test", "*Extension*")
+ * @param modelName - Model name to check
+ * @returns true if pattern matches
+ */
+function matchesPattern(pattern, modelName) {
+    const patternLower = pattern.toLowerCase();
+    const modelLower = modelName.toLowerCase();
+    if (!patternLower.includes('*')) {
+        return patternLower === modelLower;
+    }
+    const regexPattern = patternLower
+        .replace(/[.+?^${}()|[\]\\]/g, '\\$&')
+        .replace(/\*/g, '.*');
+    const regex = new RegExp(`^${regexPattern}$`);
+    return regex.test(modelLower);
+}
+/**
+ * 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 function isCustomModel(modelName) {
+    if (isAutoDetectedCustomModel(modelName)) {
+        return true;
+    }
+    // The configured target model (D365FO_MODEL_NAME) is custom by definition — it was
+    // named deliberately as the write target. Checked independently of the ISV prefix,
+    // which is often just an abbreviation of the model name and would fail startsWith() below.
+    const configuredModel = getConfiguredModelName();
+    if (configuredModel && configuredModel.toLowerCase() === modelName.toLowerCase()) {
+        return true;
+    }
+    const customModels = getCustomModels();
+    const extensionPrefix = getExtensionPrefix();
+    const isInCustomList = customModels.some(pattern => matchesPattern(pattern, modelName));
+    const hasExtensionPrefix = !!(extensionPrefix && modelName.startsWith(extensionPrefix));
+    return isInCustomList || hasExtensionPrefix;
+}
+/**
+ * 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 function isStandardModel(modelName) {
+    return !isCustomModel(modelName);
+}
+/**
+ * Filter models by type
+ * @param models - Array of model names
+ * @param type - 'custom' or 'standard'
+ * @returns Filtered array of model names
+ */
+export function filterModelsByType(models, type) {
+    if (type === 'custom') {
+        return models.filter(m => isCustomModel(m));
+    }
+    return models.filter(m => isStandardModel(m));
+}
+//# sourceMappingURL=modelClassifier.js.map

package/dist/utils/modelClassifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelClassifier.js","sourceRoot":"","sources":["../../src/utils/modelClassifier.ts"],"names":[],"mappings":"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"}

package/dist/utils/operationLocks.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Lightweight in-process async locks for serializing heavyweight local
+ * operations like builds, BP checks, DB syncs, and SysTest runs.
+ *
+ * Scope is primarily the local Windows VM companion. We combine:
+ * - in-process queueing for concurrent requests hitting the same Node process
+ * - filesystem-backed lock directories in os.tmpdir() for cross-process safety
+ *
+ * This covers the practical case of multiple local MCP companion processes on
+ * the same machine. It does NOT provide cross-machine / cross-instance locking;
+ * that would require a shared coordinator such as Redis or blob leases.
+ */
+export declare function withOperationLock<T>(lockKey: string, fn: () => Promise<T>): Promise<T>;
+export declare function getOperationLockCount(): number;
+/**
+ * Returns true if a lock for the given key is currently held (in-process or
+ * filesystem-backed by a living process). Dead-process and time-stale locks
+ * are treated as not-held so callers don't block after a crash/restart.
+ */
+export declare function isOperationLockHeld(lockKey: string): Promise<boolean>;
+/**
+ * Forcibly removes the filesystem lock directory for the given key, allowing
+ * a new operation to proceed even if a previous one is stuck.
+ */
+export declare function forceReleaseLock(lockKey: string): Promise<void>;
+//# sourceMappingURL=operationLocks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operationLocks.d.ts","sourceRoot":"","sources":["../../src/utils/operationLocks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA6GH,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAgC5F;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAyB3E;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrE"}

package/dist/utils/operationLocks.js

@@ -0,0 +1,182 @@
+/**
+ * Lightweight in-process async locks for serializing heavyweight local
+ * operations like builds, BP checks, DB syncs, and SysTest runs.
+ *
+ * Scope is primarily the local Windows VM companion. We combine:
+ * - in-process queueing for concurrent requests hitting the same Node process
+ * - filesystem-backed lock directories in os.tmpdir() for cross-process safety
+ *
+ * This covers the practical case of multiple local MCP companion processes on
+ * the same machine. It does NOT provide cross-machine / cross-instance locking;
+ * that would require a shared coordinator such as Redis or blob leases.
+ */
+import { createHash } from 'crypto';
+import * as fs from 'fs/promises';
+import os from 'os';
+import path from 'path';
+const operationLocks = new Map();
+const LOCK_ROOT = path.join(os.tmpdir(), 'd365fo-mcp-locks');
+const LOCK_WAIT_TIMEOUT_MS = parseInt(process.env.OPERATION_LOCK_TIMEOUT_MS || '900000', 10); // 15 min
+const LOCK_POLL_INTERVAL_MS = parseInt(process.env.OPERATION_LOCK_POLL_MS || '250', 10);
+const LOCK_STALE_MS = parseInt(process.env.OPERATION_LOCK_STALE_MS || '1200000', 10); // 20 min
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+function getLockDirectory(normalizedKey) {
+    const hash = createHash('sha256').update(normalizedKey).digest('hex');
+    return path.join(LOCK_ROOT, hash);
+}
+/**
+ * Returns true if `pid` corresponds to a running process.
+ * On Windows, `process.kill(pid, 0)` throws ESRCH when the process is gone
+ * and EPERM when it's alive but owned by another user — both are usable.
+ */
+function isProcessAlive(pid) {
+    if (pid === process.pid)
+        return true;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        return e?.code === 'EPERM'; // EPERM = exists but not ours; ESRCH = gone
+    }
+}
+async function tryRemoveStaleLock(lockDir, normalizedKey) {
+    try {
+        const stat = await fs.stat(lockDir);
+        const ageMs = Date.now() - stat.mtimeMs;
+        // If the owning process is dead, remove immediately regardless of age.
+        const ownerFile = path.join(lockDir, 'owner.json');
+        try {
+            const ownerRaw = await fs.readFile(ownerFile, 'utf8');
+            const owner = JSON.parse(ownerRaw);
+            if (typeof owner.pid === 'number' && !isProcessAlive(owner.pid)) {
+                await fs.rm(lockDir, { recursive: true, force: true });
+                console.error(`[operationLocks] removed dead-process lock for ${normalizedKey} (pid ${owner.pid} no longer running, age ${ageMs} ms)`);
+                return true;
+            }
+        }
+        catch {
+            // owner.json missing or unparseable — fall through to age check
+        }
+        // Fallback: time-based stale detection
+        if (ageMs < LOCK_STALE_MS) {
+            return false;
+        }
+        await fs.rm(lockDir, { recursive: true, force: true });
+        console.error(`[operationLocks] removed stale filesystem lock for ${normalizedKey} (age ${ageMs} ms)`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function acquireFilesystemLock(normalizedKey) {
+    const lockDir = getLockDirectory(normalizedKey);
+    const ownerFile = path.join(lockDir, 'owner.json');
+    const start = Date.now();
+    await fs.mkdir(LOCK_ROOT, { recursive: true });
+    while (true) {
+        try {
+            await fs.mkdir(lockDir);
+            await fs.writeFile(ownerFile, JSON.stringify({
+                pid: process.pid,
+                key: normalizedKey,
+                acquiredAt: new Date().toISOString(),
+            }, null, 2), 'utf8').catch(() => { });
+            return async () => {
+                await fs.rm(lockDir, { recursive: true, force: true }).catch(() => { });
+            };
+        }
+        catch (error) {
+            if (error?.code !== 'EEXIST') {
+                throw error;
+            }
+            const removed = await tryRemoveStaleLock(lockDir, normalizedKey);
+            if (removed) {
+                continue;
+            }
+            const waitedMs = Date.now() - start;
+            if (waitedMs >= LOCK_WAIT_TIMEOUT_MS) {
+                throw new Error(`Timeout waiting for filesystem lock: ${normalizedKey}`);
+            }
+            await sleep(LOCK_POLL_INTERVAL_MS);
+        }
+    }
+}
+export async function withOperationLock(lockKey, fn) {
+    const normalizedKey = lockKey.trim().toLowerCase();
+    const previous = operationLocks.get(normalizedKey) ?? Promise.resolve();
+    let release;
+    const current = new Promise(resolve => {
+        release = resolve;
+    });
+    operationLocks.set(normalizedKey, current);
+    const waitStart = Date.now();
+    try {
+        await previous;
+        const releaseFilesystemLock = await acquireFilesystemLock(normalizedKey);
+        const waitedMs = Date.now() - waitStart;
+        if (waitedMs > 100) {
+            console.error(`[operationLocks] waited ${waitedMs} ms for ${normalizedKey}`);
+        }
+        try {
+            return await fn();
+        }
+        finally {
+            await releaseFilesystemLock();
+        }
+    }
+    finally {
+        release();
+        if (operationLocks.get(normalizedKey) === current) {
+            operationLocks.delete(normalizedKey);
+        }
+    }
+}
+export function getOperationLockCount() {
+    return operationLocks.size;
+}
+/**
+ * Returns true if a lock for the given key is currently held (in-process or
+ * filesystem-backed by a living process). Dead-process and time-stale locks
+ * are treated as not-held so callers don't block after a crash/restart.
+ */
+export async function isOperationLockHeld(lockKey) {
+    const normalizedKey = lockKey.trim().toLowerCase();
+    if (operationLocks.has(normalizedKey))
+        return true;
+    const lockDir = getLockDirectory(normalizedKey);
+    try {
+        const stat = await fs.stat(lockDir);
+        const ageMs = Date.now() - stat.mtimeMs;
+        const ownerFile = path.join(lockDir, 'owner.json');
+        try {
+            const ownerRaw = await fs.readFile(ownerFile, 'utf8');
+            const owner = JSON.parse(ownerRaw);
+            if (typeof owner.pid === 'number' && !isProcessAlive(owner.pid)) {
+                return false; // dead process — lock is orphaned, not held
+            }
+        }
+        catch {
+            // owner.json missing/unreadable — fall back to age check
+        }
+        return ageMs < LOCK_STALE_MS;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Forcibly removes the filesystem lock directory for the given key, allowing
+ * a new operation to proceed even if a previous one is stuck.
+ */
+export async function forceReleaseLock(lockKey) {
+    const normalizedKey = lockKey.trim().toLowerCase();
+    const lockDir = getLockDirectory(normalizedKey);
+    await fs.rm(lockDir, { recursive: true, force: true }).catch(() => { });
+    operationLocks.delete(normalizedKey);
+    console.error(`[operationLocks] force-released lock for ${normalizedKey}`);
+}
+//# sourceMappingURL=operationLocks.js.map

package/dist/utils/operationLocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operationLocks.js","sourceRoot":"","sources":["../../src/utils/operationLocks.ts"],"names":[],"mappings":"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"}

package/dist/utils/packageResolver.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Package Resolver
+ * Maps model names to package names using descriptor XML files
+ * and filesystem scanning.
+ *
+ * In D365FO, the metadata directory structure is:
+ *   {Root}/{PackageName}/{ModelName}/AxClass/...
+ *   {Root}/{PackageName}/Descriptor/{ModelName}.xml
+ *
+ * The descriptor XML contains <ModelModule> (package name) and <Name> (model name).
+ * A single package (e.g., "CustomExtensions") can contain many models
+ * (e.g., "Contoso Utilities", "Contoso Reporting").
+ *
+ * This resolver builds a map from model name -> package info by:
+ * 1. Reading descriptor XML files (primary strategy)
+ * 2. Falling back to filesystem scanning for directories with AOT-type folders
+ */
+export interface ResolvedPackage {
+    packageName: string;
+    modelName: string;
+    rootPath: string;
+}
+export declare class PackageResolver {
+    private roots;
+    private modelToPackageMap;
+    /** Lowercase lookup mirror of modelToPackageMap for case-insensitive resolve(). */
+    private lowercaseLookup;
+    private buildPromise;
+    constructor(roots: string[]);
+    /**
+     * Resolve a model name to its package name.
+     * Returns null if the model cannot be found in any root.
+     */
+    resolve(modelName: string): Promise<ResolvedPackage | null>;
+    /**
+     * Resolve with an explicit package name (bypasses lookup).
+     */
+    resolveWithPackage(modelName: string, packageName: string): ResolvedPackage;
+    /**
+     * Get all known model-to-package mappings.
+     */
+    getAllMappings(): Promise<Map<string, ResolvedPackage>>;
+    /**
+     * Invalidate the cache to force a rescan.
+     */
+    clearCache(): void;
+    private ensureBuilt;
+    private buildMap;
+    private static readonly AOT_FOLDERS;
+    private hasAotTypeFolder;
+}
+//# sourceMappingURL=packageResolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packageResolver.d.ts","sourceRoot":"","sources":["../../src/utils/packageResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAmBH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,iBAAiB,CAA6C;IACtE,mFAAmF;IACnF,OAAO,CAAC,eAAe,CAA6C;IACpE,OAAO,CAAC,YAAY,CAA8B;IAElD,YAAY,KAAK,EAAE,MAAM,EAAE,EAE1B;IAED;;;OAGG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAKhE;IAED;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,eAAe,CAM1E;IAED;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAG5D;IAED;;OAEG;IACH,UAAU,IAAI,IAAI,CAIjB;YAEa,WAAW;YAWX,QAAQ;IA4EtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAEhC;YAEW,gBAAgB;CAQ/B"}