d365fo-mcp 1.0.0

package/dist/utils/indexStaleness.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Index staleness detection.
+ *
+ * Compares the newest XML mtime in the active model's metadata folder with
+ * the index's last_indexed_at timestamp and produces a warning when the
+ * workspace has changed since the last (re)index.
+ */
+export interface MtimeScanResult {
+    /** Epoch ms of the newest .xml/.label.txt file found */
+    newestMtime: number;
+    newestFile: string;
+    scannedFiles: number;
+    /** True when the scan stopped at MAX_SCANNED_FILES */
+    truncated: boolean;
+}
+/**
+ * Recursively find the newest metadata file mtime under rootDir.
+ * Returns null when the directory does not exist or contains no metadata files.
+ */
+export declare function findNewestMetadataMtime(rootDir: string): MtimeScanResult | null;
+export interface StalenessReport {
+    status: 'fresh' | 'stale' | 'unknown';
+    lines: string[];
+}
+/**
+ * Compare workspace mtimes against the index timestamp and render a report
+ * section for get_workspace_info.
+ */
+export declare function checkIndexStaleness(lastIndexedAt: string | null, modelMetadataDir: string | null): StalenessReport;
+//# sourceMappingURL=indexStaleness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"indexStaleness.d.ts","sourceRoot":"","sources":["../../src/utils/indexStaleness.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA+C/E;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IACtC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAC9B,eAAe,CA6CjB"}

package/dist/utils/indexStaleness.js

@@ -0,0 +1,104 @@
+/**
+ * Index staleness detection.
+ *
+ * Compares the newest XML mtime in the active model's metadata folder with
+ * the index's last_indexed_at timestamp and produces a warning when the
+ * workspace has changed since the last (re)index.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/** Hard cap on stat'ed files so the scan stays fast on huge models. */
+const MAX_SCANNED_FILES = 5000;
+/** Files newer than the index by less than this are tolerated (clock skew, in-flight writes). */
+const TOLERANCE_MS = 60_000;
+/**
+ * Recursively find the newest metadata file mtime under rootDir.
+ * Returns null when the directory does not exist or contains no metadata files.
+ */
+export function findNewestMetadataMtime(rootDir) {
+    let newestMtime = 0;
+    let newestFile = '';
+    let scannedFiles = 0;
+    let truncated = false;
+    const walk = (dir) => {
+        if (truncated)
+            return;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (truncated)
+                return;
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                // Skip build output and VCS noise
+                const lower = entry.name.toLowerCase();
+                if (lower === 'bin' || lower === '.git' || lower === 'xppmetadata')
+                    continue;
+                walk(full);
+            }
+            else if (/\.(xml|label\.txt)$/i.test(entry.name)) {
+                scannedFiles++;
+                if (scannedFiles > MAX_SCANNED_FILES) {
+                    truncated = true;
+                    return;
+                }
+                try {
+                    const mtime = fs.statSync(full).mtimeMs;
+                    if (mtime > newestMtime) {
+                        newestMtime = mtime;
+                        newestFile = full;
+                    }
+                }
+                catch { /* file vanished mid-scan */ }
+            }
+        }
+    };
+    try {
+        if (!fs.existsSync(rootDir) || !fs.statSync(rootDir).isDirectory())
+            return null;
+    }
+    catch {
+        return null;
+    }
+    walk(rootDir);
+    if (scannedFiles === 0)
+        return null;
+    return { newestMtime, newestFile, scannedFiles, truncated };
+}
+/**
+ * Compare workspace mtimes against the index timestamp and render a report
+ * section for get_workspace_info.
+ */
+export function checkIndexStaleness(lastIndexedAt, modelMetadataDir) {
+    const lines = ['## Index Freshness', ''];
+    if (!lastIndexedAt) {
+        lines.push('ℹ️  Index has no freshness timestamp yet (built before this feature or never built).', '   It will be recorded on the next build-database run or update_symbol_index call.');
+        return { status: 'unknown', lines };
+    }
+    const indexedAtMs = Date.parse(lastIndexedAt);
+    const ageHours = Math.round((Date.now() - indexedAtMs) / 3_600_000);
+    lines.push(`Last indexed   : ${lastIndexedAt} (${ageHours} h ago)`);
+    if (!modelMetadataDir) {
+        lines.push('ℹ️  Model metadata folder not resolved — cannot compare workspace mtimes.');
+        return { status: 'unknown', lines };
+    }
+    const scan = findNewestMetadataMtime(modelMetadataDir);
+    if (!scan) {
+        lines.push(`ℹ️  No metadata files found under ${modelMetadataDir} — nothing to compare.`);
+        return { status: 'unknown', lines };
+    }
+    lines.push(`Newest file    : ${path.basename(scan.newestFile)} (${new Date(scan.newestMtime).toISOString()})` +
+        (scan.truncated ? ` — scanned first ${MAX_SCANNED_FILES} files` : ` — ${scan.scannedFiles} files scanned`));
+    if (scan.newestMtime > indexedAtMs + TOLERANCE_MS) {
+        lines.push('', '⚠️  **INDEX IS STALE** — the workspace contains files newer than the last index update.', `   Newest change: ${scan.newestFile}`, '   Symbol lookups may return outdated signatures/fields for recently edited objects.', `   Fix: call \`update_symbol_index(filePath="${scan.newestFile.replace(/\\/g, '\\\\')}")\` for the changed file(s),`, '   or run `npm run build-database` (EXTRACT_MODE=custom) for a full custom-model refresh.');
+        return { status: 'stale', lines };
+    }
+    lines.push('✅ Index is up to date with the workspace.');
+    return { status: 'fresh', lines };
+}
+//# sourceMappingURL=indexStaleness.js.map

package/dist/utils/indexStaleness.js.map

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

package/dist/utils/loadEnv.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Configuration loader: structured JSON config first, legacy .env as fallback.
+ *
+ * `npm run setup` writes config/d365fo-mcp.json (+ config/secrets.json); this
+ * module projects it onto process.env so every consumer keeps reading plain
+ * environment variables. Precedence, highest first:
+ *
+ *   1. the real environment — shell, .mcp.json env{} block, Azure App Settings
+ *   2. a .env named explicitly via ENV_FILE (an instance or eval profile the
+ *      caller picked on purpose)
+ *   3. config/d365fo-mcp.json + config/secrets.json
+ *   4. the ambient repo-root .env (pre-wizard installations keep working)
+ *
+ * Multiple instances run from one source folder by pointing each at its own
+ * config or .env file:
+ *
+ *   D365FO_CONFIG=instances/alpha/d365fo-mcp.json node dist/index.js
+ *   ENV_FILE=.env.alpha  npm run build-database
+ *
+ * Relative paths in DB_PATH, LABELS_DB_PATH, and METADATA_PATH are resolved
+ * relative to the config (or .env) file's directory, so instance files can use
+ * portable paths like ./data/xpp-metadata.db that survive folder renames.
+ */
+/**
+ * Load environment variables from a .env file.
+ *
+ * @param callerImportMetaUrl - pass `import.meta.url` from the calling module
+ *   so the default .env path resolves relative to the repo root regardless of
+ *   the process working directory.
+ */
+export declare function loadEnv(callerImportMetaUrl: string): void;
+//# sourceMappingURL=loadEnv.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loadEnv.d.ts","sourceRoot":"","sources":["../../src/utils/loadEnv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAUH;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAmDzD"}

package/dist/utils/loadEnv.js

@@ -0,0 +1,83 @@
+/**
+ * Configuration loader: structured JSON config first, legacy .env as fallback.
+ *
+ * `npm run setup` writes config/d365fo-mcp.json (+ config/secrets.json); this
+ * module projects it onto process.env so every consumer keeps reading plain
+ * environment variables. Precedence, highest first:
+ *
+ *   1. the real environment — shell, .mcp.json env{} block, Azure App Settings
+ *   2. a .env named explicitly via ENV_FILE (an instance or eval profile the
+ *      caller picked on purpose)
+ *   3. config/d365fo-mcp.json + config/secrets.json
+ *   4. the ambient repo-root .env (pre-wizard installations keep working)
+ *
+ * Multiple instances run from one source folder by pointing each at its own
+ * config or .env file:
+ *
+ *   D365FO_CONFIG=instances/alpha/d365fo-mcp.json node dist/index.js
+ *   ENV_FILE=.env.alpha  npm run build-database
+ *
+ * Relative paths in DB_PATH, LABELS_DB_PATH, and METADATA_PATH are resolved
+ * relative to the config (or .env) file's directory, so instance files can use
+ * portable paths like ./data/xpp-metadata.db that survive folder renames.
+ */
+import dotenv from 'dotenv';
+import { dirname, isAbsolute, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { resolveConfigFiles, toEnvRecord } from '../config/configFile.js';
+/** Env vars whose relative paths should resolve from the .env file directory. */
+const PATH_VARS = ['DB_PATH', 'LABELS_DB_PATH', 'METADATA_PATH'];
+/**
+ * Load environment variables from a .env file.
+ *
+ * @param callerImportMetaUrl - pass `import.meta.url` from the calling module
+ *   so the default .env path resolves relative to the repo root regardless of
+ *   the process working directory.
+ */
+export function loadEnv(callerImportMetaUrl) {
+    const callerDir = dirname(fileURLToPath(callerImportMetaUrl));
+    const envPath = process.env.ENV_FILE
+        ? resolve(process.env.ENV_FILE)
+        : resolve(callerDir, '../.env');
+    // Everything already present is a real environment variable (shell, .mcp.json
+    // env{} block, App Settings) and outranks both files below.
+    const fromRealEnv = new Set(Object.keys(process.env));
+    // quiet: true suppresses dotenv v17's stdout logging, which would otherwise
+    // corrupt the MCP JSON-RPC channel in stdio mode (writes to process.stdout
+    // before the MCP stdio redirects are set up).
+    const result = dotenv.config({ path: envPath, quiet: true });
+    if (result.error && !process.env.ENV_FILE) {
+        // Only fall back to process.cwd() when ENV_FILE wasn't explicitly set;
+        // an explicit-but-missing file should surface as an error, not fall back silently.
+        dotenv.config({ quiet: true });
+    }
+    // Resolve relative paths in key variables relative to the .env file's
+    // directory, not process.cwd(). This makes instance .env files portable.
+    const envDir = dirname(envPath);
+    for (const key of PATH_VARS) {
+        const val = process.env[key];
+        if (val && !isAbsolute(val)) {
+            process.env[key] = resolve(envDir, val);
+        }
+    }
+    // The structured config wins over an ambient .env — the wizard writes it, so a
+    // stale .env left over from a manual installation must not silently override
+    // the answers the user just gave. Two things still outrank it: the real
+    // environment, and a .env the caller asked for by name (ENV_FILE=.env.eval
+    // picks that file deliberately, and no D365FO_CONFIG was given to go with it).
+    const pinnedByEnvFile = process.env.ENV_FILE && !process.env.D365FO_CONFIG
+        ? new Set(Object.keys(result.parsed ?? {}))
+        : new Set();
+    const files = resolveConfigFiles(envDir);
+    for (const [key, value] of Object.entries(toEnvRecord(files))) {
+        if (!fromRealEnv.has(key) && !pinnedByEnvFile.has(key))
+            process.env[key] = value;
+    }
+    // Bridge the public D365FO_-prefixed setting name to the internal
+    // DEV_ENVIRONMENT_TYPE that consumers read. Prefixed wins when both are set;
+    // a lone plain entry is tolerated for backward compatibility.
+    if (process.env.D365FO_DEV_ENVIRONMENT_TYPE) {
+        process.env.DEV_ENVIRONMENT_TYPE = process.env.D365FO_DEV_ENVIRONMENT_TYPE;
+    }
+}
+//# sourceMappingURL=loadEnv.js.map

package/dist/utils/loadEnv.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,4 @@
+/** Set DEBUG_LOGGING=true to enable verbose logging via debugLog. */
+export declare function debugLog(...args: any[]): void;
+export declare function errorLog(...args: any[]): void;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAIrE,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAI7C;AAED,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAE7C"}

package/dist/utils/logger.js

@@ -0,0 +1,11 @@
+/** Set DEBUG_LOGGING=true to enable verbose logging via debugLog. */
+const DEBUG_LOGGING = process.env.DEBUG_LOGGING === 'true';
+export function debugLog(...args) {
+    if (DEBUG_LOGGING) {
+        console.error(...args);
+    }
+}
+export function errorLog(...args) {
+    console.error(...args);
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAErE,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,MAAM,CAAC;AAE3D,MAAM,UAAU,QAAQ,CAAC,GAAG,IAAW;IACrC,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAG,IAAW;IACrC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/utils/metadataResolver.d.ts

@@ -0,0 +1,155 @@
+/**
+ * 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[], ... }
+ */
+export type ExtractedObjectType = 'classes' | 'enums' | 'edts' | 'tables' | 'views';
+export interface ExtractedViewField {
+    name: string;
+    dataSource?: string;
+    dataField?: string;
+    dataMethod?: string;
+    labelId?: string;
+    isComputed: boolean;
+}
+export interface ExtractedViewRelationField {
+    field: string;
+    relatedField: string;
+}
+export interface ExtractedViewRelation {
+    name: string;
+    relatedTable: string;
+    relationType: string;
+    cardinality: string;
+    fields?: ExtractedViewRelationField[];
+}
+export interface ExtractedViewMetadata {
+    name: string;
+    model: string;
+    sourcePath: string;
+    type: 'view' | 'data-entity';
+    label?: string;
+    isPublic?: boolean;
+    isReadOnly?: boolean;
+    primaryKey?: string;
+    primaryKeyFields?: string[];
+    fields: ExtractedViewField[];
+    relations: ExtractedViewRelation[];
+    methods: Array<{
+        name: string;
+    } | string>;
+}
+/**
+ * Build the absolute path to an extracted-metadata JSON file.
+ * Returns null if the file doesn't exist (no throw).
+ */
+export declare function resolveMetadataJsonPath(model: string, objectType: ExtractedObjectType, name: string): Promise<string | null>;
+export interface ExtractedMethodParam {
+    type: string;
+    name: string;
+    defaultValue?: string;
+}
+export interface ExtractedMethod {
+    name: string;
+    visibility: string;
+    returnType: string;
+    parameters: ExtractedMethodParam[];
+    isStatic: boolean;
+    source?: string;
+    sourceSnippet?: string;
+}
+export interface ExtractedClassMetadata {
+    name: string;
+    model: string;
+    sourcePath: string;
+    declaration?: string;
+    extends?: string;
+    implements?: string[];
+    isAbstract?: boolean;
+    isFinal?: boolean;
+    methods: ExtractedMethod[];
+}
+/**
+ * Read class metadata from extracted-metadata JSON.
+ * Returns null if the file is not available.
+ */
+export declare function readClassMetadata(model: string, className: string): Promise<ExtractedClassMetadata | null>;
+/**
+ * Read a specific method from extracted class metadata.
+ */
+export declare function readMethodMetadata(model: string, className: string, methodName: string): Promise<ExtractedMethod | null>;
+/**
+ * Read the raw XML string from an extracted-metadata enum JSON file.
+ * Returns null if not available.
+ */
+export declare function readEnumRawXml(model: string, enumName: string): Promise<string | null>;
+/**
+ * Read the raw XML string from an extracted-metadata EDT JSON file.
+ * Returns null if not available.
+ */
+export declare function readEdtRawXml(model: string, edtName: string): Promise<string | null>;
+export declare function readViewMetadata(model: string, viewName: string): Promise<ExtractedViewMetadata | 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 declare function resolveDbPathLocally(dbFilePath: string): Promise<string | null>;
+/**
+ * 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 declare function detectObjectTypeInDb(db: any, name: string): Array<{
+    type: string;
+    model: string;
+}>;
+/**
+ * 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 declare function buildObjectTypeMismatchMessage(db: any, name: string, expectedType?: string): string;
+/**
+ * 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 declare function isNotFoundResultText(text: string | undefined): boolean;
+/**
+ * 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 declare function buildNotFoundGuidance(name: string, objectType: string): string;
+/**
+ * Build a friendly error explaining that the XML for this object type
+ * is not available in the current deployment (no D365FO installation).
+ */
+export declare function buildXmlNotAvailableMessage(objectType: string, objectName: string, dbFilePath: string): string;
+//# sourceMappingURL=metadataResolver.d.ts.map

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

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