d365fo-mcp 1.0.0

package/dist/bridge/debouncedRefresh.js

@@ -0,0 +1,77 @@
+/**
+ * Coalesces multiple rapid refreshProvider() calls into a single call, so that
+ * a burst of create/modify operations triggers only one DiskProvider refresh.
+ */
+const SETTLE_MS = 400;
+const MAX_WAIT_MS = 2_000;
+let pending = null;
+/**
+ * Request a bridge refresh. If one is already pending, the settle timer
+ * resets (up to MAX_WAIT_MS). All callers receive the same result.
+ */
+export function refresh(bridge) {
+    if (!bridge?.isReady || !bridge.metadataAvailable) {
+        return Promise.resolve(null);
+    }
+    // If there's already a pending refresh for a DIFFERENT bridge instance, flush it
+    if (pending && pending.bridge !== bridge) {
+        clearTimeout(pending.timer);
+        executeRefresh();
+    }
+    if (pending) {
+        // Reset the settle timer (but respect MAX_WAIT_MS)
+        clearTimeout(pending.timer);
+        const elapsed = Date.now() - pending.firstRequestTime;
+        const remaining = Math.max(0, MAX_WAIT_MS - elapsed);
+        const delay = Math.min(SETTLE_MS, remaining);
+        if (delay > 0) {
+            pending.timer = setTimeout(executeRefresh, delay);
+        }
+        else {
+            // Max wait exceeded — fire immediately
+            executeRefresh();
+        }
+        return pending.promise;
+    }
+    // First request — create a new pending entry
+    let resolve;
+    const promise = new Promise(r => { resolve = r; });
+    pending = {
+        promise,
+        resolve,
+        timer: setTimeout(executeRefresh, SETTLE_MS),
+        firstRequestTime: Date.now(),
+        bridge,
+    };
+    return promise;
+}
+function executeRefresh() {
+    if (!pending)
+        return;
+    const { resolve, bridge } = pending;
+    pending = null;
+    bridge.refreshProvider()
+        .then(result => resolve(result))
+        .catch(err => {
+        console.error(`[debouncedRefresh] refreshProvider failed: ${err}`);
+        resolve(null);
+    });
+}
+/** Flush any pending refresh immediately (used in tests or shutdown). */
+export function flush() {
+    if (!pending)
+        return Promise.resolve(null);
+    clearTimeout(pending.timer);
+    const p = pending.promise;
+    executeRefresh();
+    return p;
+}
+/** Cancel any pending refresh without executing it (test cleanup). */
+export function cancel() {
+    if (!pending)
+        return;
+    clearTimeout(pending.timer);
+    pending.resolve(null);
+    pending = null;
+}
+//# sourceMappingURL=debouncedRefresh.js.map

package/dist/bridge/debouncedRefresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debouncedRefresh.js","sourceRoot":"","sources":["../../src/bridge/debouncedRefresh.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,WAAW,GAAG,KAAK,CAAC;AAE1B,IAAI,OAAO,GAMA,IAAI,CAAC;AAEhB;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,MAAoB;IAC1C,IAAI,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAClD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,iFAAiF;IACjF,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QACzC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5B,cAAc,EAAE,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,mDAAmD;QACnD,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;QACtD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAE7C,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,uCAAuC;YACvC,cAAc,EAAE,CAAC;QACnB,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC;IACzB,CAAC;IAED,6CAA6C;IAC7C,IAAI,OAAiD,CAAC;IACtD,MAAM,OAAO,GAAG,IAAI,OAAO,CAA6B,CAAC,CAAC,EAAE,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/E,OAAO,GAAG;QACR,OAAO;QACP,OAAO;QACP,KAAK,EAAE,UAAU,CAAC,cAAc,EAAE,SAAS,CAAC;QAC5C,gBAAgB,EAAE,IAAI,CAAC,GAAG,EAAE;QAC5B,MAAM;KACP,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,cAAc;IACrB,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACpC,OAAO,GAAG,IAAI,CAAC;IAEf,MAAM,CAAC,eAAe,EAAE;SACrB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;SAC/B,KAAK,CAAC,GAAG,CAAC,EAAE;QACX,OAAO,CAAC,KAAK,CAAC,8CAA8C,GAAG,EAAE,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;AACP,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,KAAK;IACnB,IAAI,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAC1B,cAAc,EAAE,CAAC;IACjB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,MAAM;IACpB,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC"}

package/dist/bridge/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Bridge module — C# D365MetadataBridge integration.
+ *
+ * Provides access to Microsoft's official Dev Tools API (IMetadataProvider)
+ * and cross-reference database (DYNAMICSXREFDB) via a child process.
+ *
+ * Usage:
+ *   import { BridgeClient, createBridgeClient } from './bridge/index.js';
+ *
+ *   // In server startup:
+ *   const bridge = await createBridgeClient({ packagesPath: 'K:\\AosService\\PackagesLocalDirectory' });
+ *   if (bridge) {
+ *     const table = await bridge.readTable('CustTable');
+ *     const refs = await bridge.findReferences('CustTable');
+ *   }
+ */
+export { BridgeClient, createBridgeClient } from './bridgeClient.js';
+export type { BridgeClientOptions, BridgeReadyPayload, BridgeInfoPayload } from './bridgeClient.js';
+export * from './bridgeTypes.js';
+export { tryBridgeTable, tryBridgeClass, tryBridgeMethodSource, tryBridgeEnum, tryBridgeEdt, tryBridgeForm, tryBridgeReferences, tryBridgeSearch, tryBridgeQuery, tryBridgeView, tryBridgeDataEntity, tryBridgeReport, bridgeRefreshProvider, bridgeValidateAfterWrite, bridgeResolveObject, canBridgeCreate, canBridgeModify, bridgeCreateObject, bridgeCreateSmartTable, bridgeAddMethod, bridgeRemoveMethod, bridgeAddField, bridgeModifyField, bridgeRenameField, bridgeRemoveField, bridgeReplaceAllFields, bridgeAddIndex, bridgeRemoveIndex, bridgeAddRelation, bridgeRemoveRelation, bridgeAddFieldGroup, bridgeRemoveFieldGroup, bridgeAddFieldToFieldGroup, bridgeAddEnumValue, bridgeModifyEnumValue, bridgeRemoveEnumValue, bridgeAddControl, bridgeAddDataSource, bridgeSetProperty, bridgeReplaceCode, bridgeAddFieldModification, bridgeAddMenuItemToMenu, bridgeBatchModify, bridgeGetCapabilities, bridgeDiscoverFormPatterns, tryBridgeSecurityArtifact, tryBridgeMenuItem, tryBridgeTableExtensions, tryBridgeCompletion, tryBridgeCocExtensions, tryBridgeEventHandlers, tryBridgeApiUsageCallers, } from './bridgeAdapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/bridge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACrE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACpG,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}

package/dist/bridge/index.js

@@ -0,0 +1,20 @@
+/**
+ * Bridge module — C# D365MetadataBridge integration.
+ *
+ * Provides access to Microsoft's official Dev Tools API (IMetadataProvider)
+ * and cross-reference database (DYNAMICSXREFDB) via a child process.
+ *
+ * Usage:
+ *   import { BridgeClient, createBridgeClient } from './bridge/index.js';
+ *
+ *   // In server startup:
+ *   const bridge = await createBridgeClient({ packagesPath: 'K:\\AosService\\PackagesLocalDirectory' });
+ *   if (bridge) {
+ *     const table = await bridge.readTable('CustTable');
+ *     const refs = await bridge.findReferences('CustTable');
+ *   }
+ */
+export { BridgeClient, createBridgeClient } from './bridgeClient.js';
+export * from './bridgeTypes.js';
+export { tryBridgeTable, tryBridgeClass, tryBridgeMethodSource, tryBridgeEnum, tryBridgeEdt, tryBridgeForm, tryBridgeReferences, tryBridgeSearch, tryBridgeQuery, tryBridgeView, tryBridgeDataEntity, tryBridgeReport, bridgeRefreshProvider, bridgeValidateAfterWrite, bridgeResolveObject, canBridgeCreate, canBridgeModify, bridgeCreateObject, bridgeCreateSmartTable, bridgeAddMethod, bridgeRemoveMethod, bridgeAddField, bridgeModifyField, bridgeRenameField, bridgeRemoveField, bridgeReplaceAllFields, bridgeAddIndex, bridgeRemoveIndex, bridgeAddRelation, bridgeRemoveRelation, bridgeAddFieldGroup, bridgeRemoveFieldGroup, bridgeAddFieldToFieldGroup, bridgeAddEnumValue, bridgeModifyEnumValue, bridgeRemoveEnumValue, bridgeAddControl, bridgeAddDataSource, bridgeSetProperty, bridgeReplaceCode, bridgeAddFieldModification, bridgeAddMenuItemToMenu, bridgeBatchModify, bridgeGetCapabilities, bridgeDiscoverFormPatterns, tryBridgeSecurityArtifact, tryBridgeMenuItem, tryBridgeTableExtensions, tryBridgeCompletion, tryBridgeCocExtensions, tryBridgeEventHandlers, tryBridgeApiUsageCallers, } from './bridgeAdapter.js';
+//# sourceMappingURL=index.js.map

package/dist/bridge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAErE,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC"}

package/dist/cli/commands/config.d.ts

@@ -0,0 +1,8 @@
+import { type SettingsStore } from '../settingsStore.js';
+/** Pin an XPP config (UDE) — the `npm run select-config` flow. */
+export declare function selectXppConfig(store: SettingsStore): Promise<boolean>;
+export declare function configCommand(sectionArg: string | undefined, opts: {
+    instance?: string;
+    xppConfig?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/cli/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/config.ts"],"names":[],"mappings":"AASA,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQ/F,kEAAkE;AAClE,wBAAsB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAwB5E;AAED,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/C,OAAO,CAAC,IAAI,CAAC,CA8Cf"}

package/dist/cli/commands/config.js

@@ -0,0 +1,77 @@
+/**
+ * `d365fo-mcp config [section] [instance]` — revisit settings after setup.
+ *
+ * The setup wizard is scenario-shaped and asks a lot; this is the small door
+ * for "I just need to change the prefix" or "the UDE was upgraded, repoint the
+ * XPP config". Same registry, same descriptions, writes the same JSON.
+ */
+import { SECTIONS, settingByPath, settingsInSection } from '../../config/settings.js';
+import { askSecrets, askSetting, askSettings } from '../settingsPrompt.js';
+import { readSetting, saveStore, writeSetting } from '../settingsStore.js';
+import { pickTarget } from '../target.js';
+import { askSelect, p } from '../ui.js';
+import { listXppConfigs, xppConfigDir } from '../xppConfig.js';
+const xppConfigNameSetting = settingByPath('environment.xppConfigName');
+const envTypeSetting = settingByPath('environment.type');
+/** Pin an XPP config (UDE) — the `npm run select-config` flow. */
+export async function selectXppConfig(store) {
+    const configs = listXppConfigs();
+    if (configs.length === 0) {
+        p.log.error(`No XPP config files found${xppConfigDir() ? ` in ${xppConfigDir()}` : ''}.\n` +
+            '   This directory is created by Power Platform Tools in VS2022 (Windows only).');
+        return false;
+    }
+    const current = String(readSetting(store, xppConfigNameSetting) ?? '');
+    const pick = await askSelect(`${xppConfigNameSetting.label}\n  ${xppConfigNameSetting.description}`, [
+        { value: '', label: '(auto — always use the newest)' },
+        ...configs.map((cfg, i) => ({
+            value: cfg.fullName,
+            label: `${cfg.name}  v${cfg.version}${i === 0 ? ' (newest)' : ''}${cfg.fullName === current ? ' (current)' : ''}`,
+            hint: cfg.modelStoreFolder,
+        })),
+    ], current);
+    writeSetting(store, xppConfigNameSetting, pick || undefined);
+    saveStore(store);
+    p.log.success(pick ? `Pinned XPP config: ${pick}` : 'XPP config set to auto (newest).');
+    return true;
+}
+export async function configCommand(sectionArg, opts) {
+    p.intro('d365fo-mcp config');
+    const target = await pickTarget(opts.instance, 'Which configuration do you want to edit?');
+    const store = target.store;
+    p.log.info(`Editing ${target.label}: ${store.configPath}`);
+    if (opts.xppConfig) {
+        if (!await selectXppConfig(store))
+            process.exitCode = 1;
+        p.outro('Rebuild the index afterwards: d365fo-mcp index');
+        return;
+    }
+    const section = sectionArg ?? await askSelect('Which area?', SECTIONS.map(s => ({ value: s.id, label: s.title, hint: s.description })));
+    if (!SECTIONS.some(s => s.id === section)) {
+        p.log.error(`Unknown section '${section}'. Available: ${SECTIONS.map(s => s.id).join(', ')}`);
+        process.exitCode = 1;
+        return;
+    }
+    const skip = new Set();
+    if (section === 'environment') {
+        // The environment type drives the rest of the section, and the XPP config is
+        // a picker rather than free text — both need more than the generic walk.
+        await askSetting(store, envTypeSetting, {
+            initial: listXppConfigs().length > 0 ? 'ude' : 'traditional',
+        });
+        skip.add(envTypeSetting);
+        if (readSetting(store, envTypeSetting) === 'ude' && listXppConfigs().length > 0) {
+            await selectXppConfig(store);
+            skip.add(xppConfigNameSetting);
+        }
+    }
+    await askSettings(store, [
+        ...settingsInSection(section, 'basic').filter(s => !skip.has(s)),
+        ...settingsInSection(section, 'advanced'),
+    ]);
+    await askSecrets(store, [section]);
+    saveStore(store);
+    p.log.success(`Saved ${store.configPath}`);
+    p.outro('Restart the server (or Visual Studio) for the change to take effect.');
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/commands/config.js.map

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

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+export declare function doctorCommand(): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AA0GA,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CA+EnD"}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,177 @@
+/**
+ * `d365fo-mcp doctor` — environment and installation health check.
+ *
+ * Verifies everything SETUP.md lists as a prerequisite and prints a fix for
+ * each failed check. Exit code 1 when a hard failure is found (something that
+ * prevents the server from working at all), 0 otherwise.
+ */
+import * as fs from 'node:fs';
+import { relative, resolve } from 'node:path';
+import { p } from '../ui.js';
+import { settingByPath } from '../../config/settings.js';
+import { isWindows, paths, repoRoot } from '../context.js';
+import { listInstances } from '../instances.js';
+import { conflictingLegacyValues, readPath, readSetting } from '../settingsStore.js';
+import { instanceTarget, rootTarget } from '../target.js';
+import { isXppConfigStale, listXppConfigs, xppConfigDir } from '../xppConfig.js';
+const REQUIRED_NODE_MAJOR = 24;
+/** Below this size the index is almost certainly incomplete (SETUP.md troubleshooting). */
+const MIN_HEALTHY_DB_BYTES = 100 * 1024 * 1024;
+function report(r) {
+    const line = r.fix ? `${r.message}\n   fix: ${r.fix}` : r.message;
+    if (r.severity === 'ok')
+        p.log.success(line);
+    else if (r.severity === 'warn')
+        p.log.warn(line);
+    else if (r.severity === 'fail')
+        p.log.error(line);
+    else
+        p.log.info(line);
+}
+function checkDb(store, defaultDb, label) {
+    const dbPath = readPath(store, settingByPath('index.dbPath'), defaultDb);
+    if (!fs.existsSync(dbPath)) {
+        return {
+            severity: 'warn',
+            message: `${label}: database not found (${dbPath})`,
+            fix: 'd365fo-mcp index — not needed for hybrid/azure-client setups',
+        };
+    }
+    const size = fs.statSync(dbPath).size;
+    const mb = (size / 1024 / 1024).toFixed(0);
+    if (size < MIN_HEALTHY_DB_BYTES) {
+        return {
+            severity: 'warn',
+            message: `${label}: database is only ${mb} MB — index looks incomplete`,
+            fix: 'd365fo-mcp index',
+        };
+    }
+    return { severity: 'ok', message: `${label}: database OK (${mb} MB)` };
+}
+/** The structured config the setup wizard writes — absent means never set up. */
+function checkConfig(target, label) {
+    if (fs.existsSync(target.store.configPath)) {
+        const shown = relative(repoRoot, target.store.configPath) || target.store.configPath;
+        return { severity: 'ok', message: `${label}: configuration present (${shown})` };
+    }
+    if (target.envFile) {
+        return {
+            severity: 'warn',
+            message: `${label}: no d365fo-mcp.json — running on the legacy .env only`,
+            fix: 'npm run setup — imports the .env and writes the structured config',
+        };
+    }
+    return {
+        severity: 'info',
+        message: `${label}: not configured — fine when everything comes from the .mcp.json env block`,
+        fix: 'npm run setup',
+    };
+}
+/** A legacy .env that disagrees with the config is a trap: the config wins. */
+function legacyEnvChecks(target, label) {
+    if (!target.envFile || !fs.existsSync(target.store.configPath))
+        return [];
+    const conflicts = conflictingLegacyValues(target.store);
+    if (conflicts.length === 0) {
+        return [{ severity: 'info', message: `${label}: legacy .env present but not contradicting the config` }];
+    }
+    return [{
+            severity: 'warn',
+            message: `${label}: .env and d365fo-mcp.json disagree — the JSON config wins:\n` +
+                conflicts.map(c => `   ${c.setting.env}: .env=${c.envValue} · config=${c.configValue}`).join('\n'),
+            fix: 'delete the stale keys from .env (or the whole file once the config is complete)',
+        }];
+}
+async function probeHealth(port, label) {
+    try {
+        const res = await fetch(`http://localhost:${port}/health`, { signal: AbortSignal.timeout(1500) });
+        const body = (await res.json());
+        if (res.ok) {
+            return { severity: 'ok', message: `${label}: running on port ${port} (${body.symbols?.toLocaleString('en-US') ?? '?'} symbols)` };
+        }
+        return { severity: 'info', message: `${label}: starting on port ${port} (${body.status ?? res.status})` };
+    }
+    catch {
+        return { severity: 'info', message: `${label}: not running on port ${port} (fine unless you expect an HTTP server)` };
+    }
+}
+export async function doctorCommand() {
+    p.intro('d365fo-mcp doctor');
+    let failures = 0;
+    const emit = (r) => {
+        if (r.severity === 'fail')
+            failures++;
+        report(r);
+    };
+    // Runtime
+    const nodeMajor = parseInt(process.versions.node.split('.')[0], 10);
+    emit(nodeMajor >= REQUIRED_NODE_MAJOR
+        ? { severity: 'ok', message: `Node.js ${process.versions.node}` }
+        : { severity: 'fail', message: `Node.js ${process.versions.node} — ${REQUIRED_NODE_MAJOR}.x required (package.json engines)`, fix: 'install Node 24 LTS' });
+    // Install + build
+    emit(fs.existsSync(resolve(repoRoot, 'node_modules'))
+        ? { severity: 'ok', message: 'Dependencies installed (node_modules)' }
+        : { severity: 'fail', message: 'node_modules missing', fix: 'npm install' });
+    emit(fs.existsSync(paths.distEntry)
+        ? { severity: 'ok', message: 'Server built (dist/index.js)' }
+        : { severity: 'fail', message: 'dist/index.js missing — server not built', fix: 'npm run build' });
+    // Configuration
+    const root = rootTarget();
+    emit(checkConfig(root, 'Root'));
+    for (const r of legacyEnvChecks(root, 'Root'))
+        emit(r);
+    // Database (root)
+    emit(checkDb(root.store, paths.defaultDb, 'Root'));
+    // C# bridge: the only write path; Windows-only.
+    if (isWindows) {
+        emit(fs.existsSync(paths.bridgeExe)
+            ? { severity: 'ok', message: 'C# bridge built (D365MetadataBridge.exe)' }
+            : { severity: 'warn', message: 'C# bridge not built — server runs read-only', fix: 'cd bridge\\D365MetadataBridge && dotnet build -c Release' });
+        const dir = xppConfigDir();
+        const configs = listXppConfigs();
+        if (dir && fs.existsSync(dir)) {
+            emit({ severity: 'ok', message: `UDE: ${configs.length} XPP config(s) in ${dir}` });
+        }
+        else {
+            emit({ severity: 'info', message: 'No UDE XPPConfig directory — traditional VM or UDE tools not installed' });
+        }
+    }
+    else {
+        emit({ severity: 'info', message: `C# bridge skipped (Windows-only) — platform is ${process.platform}` });
+    }
+    // Instances
+    const instances = listInstances();
+    if (instances.length > 0) {
+        p.log.step(`Instances (${instances.length})`);
+        for (const inst of instances) {
+            const target = instanceTarget(inst);
+            emit(checkConfig(target, `Instance '${inst.name}'`));
+            for (const r of legacyEnvChecks(target, `Instance '${inst.name}'`))
+                emit(r);
+            emit(checkDb(target.store, resolve(inst.dir, 'data', 'xpp-metadata.db'), `Instance '${inst.name}'`));
+            if (isWindows && isXppConfigStale(target.store)) {
+                emit({
+                    severity: 'warn',
+                    message: `Instance '${inst.name}': XPP_CONFIG_NAME no longer resolves — UDE upgraded since configuration`,
+                    fix: `d365fo-mcp instance upgrade ${inst.name}`,
+                });
+            }
+        }
+    }
+    // Live servers
+    const configuredPort = readSetting(root.store, settingByPath('server.port'));
+    const rootPort = typeof configuredPort === 'number' ? configuredPort : 8080;
+    emit(await probeHealth(rootPort, 'Server'));
+    for (const inst of instances) {
+        if (inst.port !== null)
+            emit(await probeHealth(inst.port, `Instance '${inst.name}'`));
+    }
+    if (failures > 0) {
+        p.outro(`${failures} problem(s) found — apply the fixes above and re-run.`);
+        process.exitCode = 1;
+    }
+    else {
+        p.outro('No blocking problems found.');
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,UAAU,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,WAAW,EAAsB,MAAM,qBAAqB,CAAC;AACzG,OAAO,EAAE,cAAc,EAAE,UAAU,EAAe,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAUjF,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAC/B,2FAA2F;AAC3F,MAAM,oBAAoB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/C,SAAS,MAAM,CAAC,CAAc;IAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,aAAa,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAClE,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI;QAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;SACxC,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM;QAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAC5C,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM;QAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;;QAC7C,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,OAAO,CAAC,KAAoB,EAAE,SAAiB,EAAE,KAAa;IACrE,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAE,EAAE,SAAS,CAAC,CAAC;IAC1E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,GAAG,KAAK,yBAAyB,MAAM,GAAG;YACnD,GAAG,EAAE,8DAA8D;SACpE,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;IACtC,MAAM,EAAE,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3C,IAAI,IAAI,GAAG,oBAAoB,EAAE,CAAC;QAChC,OAAO;YACL,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,GAAG,KAAK,sBAAsB,EAAE,8BAA8B;YACvE,GAAG,EAAE,kBAAkB;SACxB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,kBAAkB,EAAE,MAAM,EAAE,CAAC;AACzE,CAAC;AAED,iFAAiF;AACjF,SAAS,WAAW,CAAC,MAAc,EAAE,KAAa;IAChD,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;QACrF,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,4BAA4B,KAAK,GAAG,EAAE,CAAC;IACnF,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO;YACL,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,GAAG,KAAK,wDAAwD;YACzE,GAAG,EAAE,mEAAmE;SACzE,CAAC;IACJ,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,GAAG,KAAK,4EAA4E;QAC7F,GAAG,EAAE,eAAe;KACrB,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,SAAS,eAAe,CAAC,MAAc,EAAE,KAAa;IACpD,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1E,MAAM,SAAS,GAAG,uBAAuB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,wDAAwD,EAAE,CAAC,CAAC;IAC3G,CAAC;IACD,OAAO,CAAC;YACN,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,GAAG,KAAK,+DAA+D;gBAC9E,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC,QAAQ,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACpG,GAAG,EAAE,iFAAiF;SACvF,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,KAAa;IACpD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,SAAS,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClG,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA0C,CAAC;QACzE,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;YACX,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,qBAAqB,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,IAAI,GAAG,WAAW,EAAE,CAAC;QACpI,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,sBAAsB,IAAI,KAAK,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;IAC5G,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,yBAAyB,IAAI,0CAA0C,EAAE,CAAC;IACxH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC7B,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,MAAM,IAAI,GAAG,CAAC,CAAc,EAAE,EAAE;QAC9B,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM;YAAE,QAAQ,EAAE,CAAC;QACtC,MAAM,CAAC,CAAC,CAAC,CAAC;IACZ,CAAC,CAAC;IAEF,UAAU;IACV,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpE,IAAI,CAAC,SAAS,IAAI,mBAAmB;QACnC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE;QACjE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,OAAO,CAAC,QAAQ,CAAC,IAAI,MAAM,mBAAmB,oCAAoC,EAAE,GAAG,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAE9J,kBAAkB;IAClB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QACnD,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,uCAAuC,EAAE;QACtE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC;IAC/E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC;QACjC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,8BAA8B,EAAE;QAC7D,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,0CAA0C,EAAE,GAAG,EAAE,eAAe,EAAE,CAAC,CAAC;IAErG,gBAAgB;IAChB,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC;QAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAEvD,kBAAkB;IAClB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAEnD,gDAAgD;IAChD,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC;YACjC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,0CAA0C,EAAE;YACzE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,6CAA6C,EAAE,GAAG,EAAE,0DAA0D,EAAE,CAAC,CAAC;QACnJ,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;QACjC,IAAI,GAAG,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,OAAO,CAAC,MAAM,qBAAqB,GAAG,EAAE,EAAE,CAAC,CAAC;QACtF,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,wEAAwE,EAAE,CAAC,CAAC;QAChH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,kDAAkD,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED,YAAY;IACZ,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;IAClC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,aAAa,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;YACrD,KAAK,MAAM,CAAC,IAAI,eAAe,CAAC,MAAM,EAAE,aAAa,IAAI,CAAC,IAAI,GAAG,CAAC;gBAAE,IAAI,CAAC,CAAC,CAAC,CAAC;YAC5E,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,aAAa,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;YACrG,IAAI,SAAS,IAAI,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChD,IAAI,CAAC;oBACH,QAAQ,EAAE,MAAM;oBAChB,OAAO,EAAE,aAAa,IAAI,CAAC,IAAI,0EAA0E;oBACzG,GAAG,EAAE,+BAA+B,IAAI,CAAC,IAAI,EAAE;iBAChD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,eAAe;IACf,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAE,CAAC,CAAC;IAC9E,MAAM,QAAQ,GAAG,OAAO,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5E,IAAI,CAAC,MAAM,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;YAAE,IAAI,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IACxF,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,CAAC,CAAC,KAAK,CAAC,GAAG,QAAQ,uDAAuD,CAAC,CAAC;QAC5E,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACzC,CAAC;AACH,CAAC"}

package/dist/cli/commands/indexCmd.d.ts

@@ -0,0 +1,8 @@
+import { Target } from '../target.js';
+/** Run extract + build-database for one target. Returns true on success. */
+export declare function rebuildIndex(target: Target): Promise<boolean>;
+export declare function indexCommand(instanceName: string | undefined, opts: {
+    all?: boolean;
+    yes?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=indexCmd.d.ts.map

package/dist/cli/commands/indexCmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexCmd.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/indexCmd.ts"],"names":[],"mappings":"AASA,OAAO,EAAqD,MAAM,EAAE,MAAM,cAAc,CAAC;AAIzF,4EAA4E;AAC5E,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAsBnE;AAED,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC1H"}

package/dist/cli/commands/indexCmd.js

@@ -0,0 +1,78 @@
+/**
+ * `d365fo-mcp index [instance] [--all]` — rebuild the metadata index
+ * (extract-metadata + build-database), the TS counterpart of
+ * instances/rebuild-instance.ps1 minus the git-pull step (that lives in
+ * `d365fo-mcp update`).
+ */
+import { isWindows, paths } from '../context.js';
+import { runNode } from '../exec.js';
+import { listInstances } from '../instances.js';
+import { instanceTarget, pickTarget, rootTarget, targetEnv } from '../target.js';
+import { askSelect, p, requireGitCheckout } from '../ui.js';
+import { normalizeXppConfigName } from '../xppConfig.js';
+/** Run extract + build-database for one target. Returns true on success. */
+export async function rebuildIndex(target) {
+    const env = targetEnv(target);
+    if (isWindows) {
+        const expanded = normalizeXppConfigName(target.store);
+        if (expanded)
+            p.log.info(`Expanded XPP config name: ${expanded.from} → ${expanded.to}`);
+    }
+    p.log.step(`[1/2] Extracting metadata (${target.label})…`);
+    if (await runNode(['--import', 'tsx/esm', paths.extractScript], { env }) !== 0) {
+        p.log.error(`Metadata extraction failed for ${target.label}`);
+        return false;
+    }
+    p.log.step(`[2/2] Building database (${target.label})…`);
+    if (await runNode(['--max-old-space-size=6144', '--import', 'tsx/esm', paths.buildDbScript], { env }) !== 0) {
+        p.log.error(`Database build failed for ${target.label}`);
+        return false;
+    }
+    p.log.success(`Index rebuilt: ${target.label}`);
+    return true;
+}
+export async function indexCommand(instanceName, opts) {
+    p.intro('d365fo-mcp index');
+    if (!requireGitCheckout())
+        return;
+    let targets;
+    if (opts.all) {
+        const instances = listInstances();
+        if (instances.length === 0) {
+            p.log.error('--all: no instances found under instances/.');
+            process.exitCode = 1;
+            return;
+        }
+        targets = instances.map(instanceTarget);
+    }
+    else if (!instanceName && opts.yes) {
+        // Fully non-interactive: no name + --yes targets the root server.
+        targets = [rootTarget()];
+    }
+    else if (!instanceName && listInstances().length > 0) {
+        // Interactive: offer "all instances" as a choice alongside a single target.
+        const choice = await askSelect('Rebuild which index?', [
+            { value: '__pick__', label: 'Choose a single target…' },
+            { value: '__all__', label: 'All instances' },
+        ]);
+        targets = choice === '__all__'
+            ? listInstances().map(instanceTarget)
+            : [await pickTarget(undefined, 'Which target?')];
+    }
+    else {
+        targets = [await pickTarget(instanceName, 'Which target?')];
+    }
+    const failed = [];
+    for (const target of targets) {
+        if (!await rebuildIndex(target))
+            failed.push(target.name);
+    }
+    if (failed.length > 0) {
+        p.outro(`Completed with errors. Failed: ${failed.join(', ')}`);
+        process.exitCode = 1;
+    }
+    else {
+        p.outro(targets.length > 1 ? `All ${targets.length} indexes rebuilt.` : 'Done.');
+    }
+}
+//# sourceMappingURL=indexCmd.js.map

package/dist/cli/commands/indexCmd.js.map

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

package/dist/cli/commands/instance.d.ts

@@ -0,0 +1,4 @@
+export declare function instanceListCommand(): Promise<void>;
+export declare function instanceAddCommand(name: string | undefined, portArg: string | undefined): Promise<void>;
+export declare function instanceUpgradeCommand(name: string | undefined): Promise<void>;
+//# sourceMappingURL=instance.d.ts.map

package/dist/cli/commands/instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/instance.ts"],"names":[],"mappings":"AAuCA,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIzD;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAiF7G;AAuBD,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CA2DpF"}