d365fo-mcp 1.0.0

package/dist/cli/xppConfig.js

@@ -0,0 +1,97 @@
+/**
+ * XPP config discovery (UDE / Power Platform Tools) — TypeScript counterpart
+ * of scripts/select-xpp-config.ps1 and the helpers in instances/*.ps1.
+ *
+ * Configs live in %LOCALAPPDATA%\Microsoft\Dynamics365\XPPConfig as
+ * "<name>___<version>.json"; Windows-only by nature — callers on other
+ * platforms get an empty list.
+ */
+import * as fs from 'node:fs';
+import { join } from 'node:path';
+import { settingByPath } from '../config/settings.js';
+import { getValue } from './envFile.js';
+import { readSetting, saveStore, writeSetting } from './settingsStore.js';
+const xppConfigNameSetting = settingByPath('environment.xppConfigName');
+const envTypeSetting = settingByPath('environment.type');
+export function xppConfigDir() {
+    const localAppData = process.env.LOCALAPPDATA;
+    if (!localAppData)
+        return null;
+    return join(localAppData, 'Microsoft', 'Dynamics365', 'XPPConfig');
+}
+/** All versioned configs, newest first. Empty when the directory is absent. */
+export function listXppConfigs() {
+    const dir = xppConfigDir();
+    if (!dir || !fs.existsSync(dir))
+        return [];
+    const configs = [];
+    for (const entry of fs.readdirSync(dir)) {
+        const m = entry.match(/^(.+)___(.+)\.json$/);
+        if (!m)
+            continue;
+        const file = join(dir, entry);
+        let modelStoreFolder;
+        let frameworkDirectory;
+        try {
+            const json = JSON.parse(fs.readFileSync(file, 'utf8'));
+            modelStoreFolder = json.ModelStoreFolder;
+            frameworkDirectory = json.FrameworkDirectory;
+        }
+        catch { /* unreadable config — still list it */ }
+        configs.push({
+            fullName: entry.replace(/\.json$/, ''),
+            name: m[1],
+            version: m[2],
+            file,
+            mtimeMs: fs.statSync(file).mtimeMs,
+            modelStoreFolder,
+            frameworkDirectory,
+        });
+    }
+    return configs.sort((a, b) => b.mtimeMs - a.mtimeMs);
+}
+/** Pinned config name of a target, from its JSON config or legacy .env. */
+function pinnedConfigName(store) {
+    const value = readSetting(store, xppConfigNameSetting);
+    return typeof value === 'string' && value ? value : null;
+}
+/**
+ * Expand a short config name (e.g. "myenv-dev") to the newest full versioned
+ * name ("myenv-dev___10.0.2345.153") so a later staleness check is a plain
+ * file-exists test, and persist the expansion. No-op for traditional
+ * environments, full names, or when nothing matches.
+ * Returns the expansion that happened, or null.
+ */
+export function normalizeXppConfigName(store) {
+    if (readSetting(store, envTypeSetting) === 'traditional')
+        return null;
+    const current = pinnedConfigName(store);
+    if (!current || /___/.test(current))
+        return null;
+    const match = listXppConfigs().filter(c => c.name === current);
+    if (match.length === 0)
+        return null;
+    const full = match[0].fullName;
+    writeSetting(store, xppConfigNameSetting, full);
+    saveStore(store);
+    return { from: current, to: full };
+}
+/**
+ * True when the pinned config name no longer resolves to a file — i.e. the UDE
+ * was upgraded since the instance was configured and its database is stale.
+ * Only meaningful after normalizeXppConfigName.
+ */
+export function isXppConfigStale(store) {
+    if (readSetting(store, envTypeSetting) === 'traditional')
+        return false;
+    const configName = pinnedConfigName(store);
+    if (!configName)
+        return false;
+    const dir = xppConfigDir();
+    if (!dir || !fs.existsSync(dir))
+        return false;
+    return !fs.existsSync(join(dir, `${configName}.json`));
+}
+// Re-export for callers that work on content strings in tests.
+export { getValue as _getValue };
+//# sourceMappingURL=xppConfig.js.map

package/dist/cli/xppConfig.js.map

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

package/dist/config/configFile.d.ts

@@ -0,0 +1,50 @@
+import { type Setting } from './settings.js';
+/** Bumped only when the on-disk shape changes in a way the loader must handle. */
+export declare const CONFIG_VERSION = 1;
+export type ConfigObject = Record<string, any>;
+export interface ResolvedConfigFiles {
+    /** Directory holding the config file itself. */
+    dir: string;
+    /** Project directory — what relative paths resolve from (see configBaseDir). */
+    baseDir: string;
+    configPath: string;
+    secretsPath: string;
+    config: ConfigObject | null;
+    secrets: ConfigObject | null;
+}
+export declare function getAtPath(obj: ConfigObject | null | undefined, path: string): unknown;
+export declare function setAtPath(obj: ConfigObject, path: string, value: unknown): void;
+/** Candidate config paths for a given base directory (the .env directory). */
+export declare function configCandidates(baseDir: string): string[];
+/**
+ * Locate and read the config + secrets pair.
+ * `baseDir` is the directory of the active .env file (repo root, or an instance folder).
+ *
+ * `allowEnvOverride` is what the running server wants (D365FO_CONFIG points it
+ * at one specific instance); the CLI passes false, since it manages several
+ * targets in one process and must not collapse them all onto that one file.
+ */
+export declare function resolveConfigFiles(baseDir: string, opts?: {
+    allowEnvOverride?: boolean;
+}): ResolvedConfigFiles;
+/**
+ * Directory a relative path setting (./data/xpp-metadata.db) resolves from:
+ * the folder that owns the deployment, not the folder that happens to hold the
+ * JSON. For the repo layout config/d365fo-mcp.json that is the repo root; for
+ * instances/<name>/d365fo-mcp.json it is the instance folder. Keeping paths
+ * relative is what lets an instance folder be renamed or moved.
+ */
+export declare function configBaseDir(configPath: string): string;
+/**
+ * Flatten config + secrets into the environment variables the runtime reads.
+ * Relative `path`-typed values are resolved against `baseDir` so a config file
+ * can use portable values like ./data/xpp-metadata.db.
+ */
+export declare function toEnvRecord(files: Pick<ResolvedConfigFiles, 'baseDir' | 'config' | 'secrets'>): Record<string, string>;
+/** Write the config file, creating its directory. Keys are emitted in registry order. */
+export declare function writeConfigFile(configPath: string, config: ConfigObject): void;
+/** Write secrets.json with owner-only permissions where the platform supports them. */
+export declare function writeSecretsFile(secretsPath: string, secrets: ConfigObject): void;
+/** Settings whose value in the config differs from what the environment already provides. */
+export declare function shadowedSettings(env: NodeJS.ProcessEnv, envRecord: Record<string, string>): Setting[];
+//# sourceMappingURL=configFile.d.ts.map

package/dist/config/configFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configFile.d.ts","sourceRoot":"","sources":["../../src/config/configFile.ts"],"names":[],"mappings":"AAoBA,OAAO,EAA4B,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAEvE,kFAAkF;AAClF,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;CAC9B;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGrF;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAa/E;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAE1D;AAeD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,mBAAmB,CAe9G;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUtH;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAS9E;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAajF;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,EAAE,CAKrG"}

package/dist/config/configFile.js

@@ -0,0 +1,152 @@
+/**
+ * Structured configuration file — config/d365fo-mcp.json (+ config/secrets.json).
+ *
+ * Replaces hand-editing .env: `npm run setup` writes these files and the server
+ * projects them onto process.env at startup, so every consumer keeps reading the
+ * same environment variables it always has (see src/config/settings.ts for the
+ * mapping).
+ *
+ * Precedence at runtime — first one that defines a variable wins:
+ *   1. the real environment (shell, .mcp.json env{} block, Azure App Settings)
+ *   2. config/d365fo-mcp.json + config/secrets.json
+ *   3. a legacy .env file, still honoured so existing installations keep working
+ *
+ * Lookup order for the config file itself:
+ *   1. D365FO_CONFIG (explicit path to a .json file)
+ *   2. <dir of the active .env>/d365fo-mcp.json      — instance layout
+ *   3. <dir of the active .env>/config/d365fo-mcp.json — repo layout
+ */
+import * as fs from 'node:fs';
+import { basename, dirname, isAbsolute, join, resolve } from 'node:path';
+import { SETTINGS, serializeValue } from './settings.js';
+/** Bumped only when the on-disk shape changes in a way the loader must handle. */
+export const CONFIG_VERSION = 1;
+export function getAtPath(obj, path) {
+    if (!obj)
+        return undefined;
+    return path.split('.').reduce((acc, key) => (acc == null ? undefined : acc[key]), obj);
+}
+export function setAtPath(obj, path, value) {
+    const keys = path.split('.');
+    const last = keys.pop();
+    let cursor = obj;
+    for (const key of keys) {
+        if (typeof cursor[key] !== 'object' || cursor[key] === null)
+            cursor[key] = {};
+        cursor = cursor[key];
+    }
+    if (value === undefined || value === null || value === '') {
+        delete cursor[last];
+    }
+    else {
+        cursor[last] = value;
+    }
+}
+/** Candidate config paths for a given base directory (the .env directory). */
+export function configCandidates(baseDir) {
+    return [join(baseDir, 'd365fo-mcp.json'), join(baseDir, 'config', 'd365fo-mcp.json')];
+}
+function readJson(file) {
+    try {
+        if (!fs.existsSync(file))
+            return null;
+        const parsed = JSON.parse(fs.readFileSync(file, 'utf8'));
+        return typeof parsed === 'object' && parsed !== null ? parsed : null;
+    }
+    catch (err) {
+        // A malformed config must be loud but must not prevent the server from
+        // starting on .env alone — it writes to stderr, never stdout (stdio mode).
+        process.stderr.write(`[config] Cannot parse ${file}: ${err instanceof Error ? err.message : String(err)}\n`);
+        return null;
+    }
+}
+/**
+ * Locate and read the config + secrets pair.
+ * `baseDir` is the directory of the active .env file (repo root, or an instance folder).
+ *
+ * `allowEnvOverride` is what the running server wants (D365FO_CONFIG points it
+ * at one specific instance); the CLI passes false, since it manages several
+ * targets in one process and must not collapse them all onto that one file.
+ */
+export function resolveConfigFiles(baseDir, opts) {
+    const explicit = opts?.allowEnvOverride === false ? undefined : process.env.D365FO_CONFIG?.trim();
+    const configPath = explicit
+        ? resolve(explicit)
+        : configCandidates(baseDir).find(p => fs.existsSync(p)) ?? join(baseDir, 'config', 'd365fo-mcp.json');
+    const dir = dirname(configPath);
+    return {
+        dir,
+        baseDir: configBaseDir(configPath),
+        configPath,
+        secretsPath: join(dir, 'secrets.json'),
+        config: readJson(configPath),
+        secrets: readJson(join(dir, 'secrets.json')),
+    };
+}
+/**
+ * Directory a relative path setting (./data/xpp-metadata.db) resolves from:
+ * the folder that owns the deployment, not the folder that happens to hold the
+ * JSON. For the repo layout config/d365fo-mcp.json that is the repo root; for
+ * instances/<name>/d365fo-mcp.json it is the instance folder. Keeping paths
+ * relative is what lets an instance folder be renamed or moved.
+ */
+export function configBaseDir(configPath) {
+    const dir = dirname(configPath);
+    return basename(dir).toLowerCase() === 'config' ? dirname(dir) : dir;
+}
+/**
+ * Flatten config + secrets into the environment variables the runtime reads.
+ * Relative `path`-typed values are resolved against `baseDir` so a config file
+ * can use portable values like ./data/xpp-metadata.db.
+ */
+export function toEnvRecord(files) {
+    const out = {};
+    for (const setting of SETTINGS) {
+        const source = setting.tier === 'secret' ? files.secrets : files.config;
+        const raw = getAtPath(source, setting.path);
+        const value = serializeValue(setting, raw);
+        if (value === null)
+            continue;
+        out[setting.env] = setting.type === 'path' && !isAbsolute(value) ? resolve(files.baseDir, value) : value;
+    }
+    return out;
+}
+/** Write the config file, creating its directory. Keys are emitted in registry order. */
+export function writeConfigFile(configPath, config) {
+    fs.mkdirSync(dirname(configPath), { recursive: true });
+    const ordered = { version: CONFIG_VERSION };
+    for (const setting of SETTINGS) {
+        if (setting.tier === 'secret')
+            continue;
+        const value = getAtPath(config, setting.path);
+        if (value !== undefined && value !== null && value !== '')
+            setAtPath(ordered, setting.path, value);
+    }
+    fs.writeFileSync(configPath, JSON.stringify(ordered, null, 2) + '\n', 'utf8');
+}
+/** Write secrets.json with owner-only permissions where the platform supports them. */
+export function writeSecretsFile(secretsPath, secrets) {
+    fs.mkdirSync(dirname(secretsPath), { recursive: true });
+    const ordered = {};
+    for (const setting of SETTINGS) {
+        if (setting.tier !== 'secret')
+            continue;
+        const value = getAtPath(secrets, setting.path);
+        if (value !== undefined && value !== null && value !== '')
+            setAtPath(ordered, setting.path, value);
+    }
+    if (Object.keys(ordered).length === 0) {
+        if (fs.existsSync(secretsPath))
+            fs.rmSync(secretsPath);
+        return;
+    }
+    fs.writeFileSync(secretsPath, JSON.stringify(ordered, null, 2) + '\n', { encoding: 'utf8', mode: 0o600 });
+}
+/** Settings whose value in the config differs from what the environment already provides. */
+export function shadowedSettings(env, envRecord) {
+    return SETTINGS.filter(s => {
+        const fromEnv = env[s.env];
+        return fromEnv !== undefined && envRecord[s.env] !== undefined && fromEnv !== envRecord[s.env];
+    });
+}
+//# sourceMappingURL=configFile.js.map

package/dist/config/configFile.js.map

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

package/dist/config/settings.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Setting registry — the single source of truth for every configurable value.
+ *
+ * One entry per setting describes, in one place:
+ *   • where it lives in config/d365fo-mcp.json (`path`, dotted)
+ *   • which environment variable the runtime actually reads (`env`)
+ *   • how to serialise it to that variable (`type`)
+ *   • what to ask the user and how to explain it (`label` / `description`)
+ *   • whether the setup wizard asks for it up front (`tier`)
+ *
+ * Everything else — the wizard, the config loader, the doctor and the docs
+ * table — is generated from this list, so a new setting only has to be added
+ * here. Purely operational variables the user should never have to set
+ * (NODE_ENV, WEBSITES_PORT, CI/TERM detection, ENV_FILE, MCP_STDIO_MODE) are
+ * deliberately absent: they are runtime/platform inputs, not configuration.
+ */
+export type SettingType = 'string' | 'path' | 'boolean' | 'int' | 'list' | 'enum';
+/** basic = asked during setup · advanced = asked only in the advanced pass · secret = stored in config/secrets.json */
+export type SettingTier = 'basic' | 'advanced' | 'secret';
+export type SectionId = 'environment' | 'workspace' | 'naming' | 'index' | 'server' | 'bridge' | 'behavior' | 'azure';
+export interface SettingChoice {
+    value: string;
+    hint: string;
+}
+export interface Setting {
+    /** Dotted path inside the JSON config, e.g. "environment.packagePath". */
+    path: string;
+    /** Environment variable the server/scripts read at runtime. */
+    env: string;
+    section: SectionId;
+    tier: SettingTier;
+    type: SettingType;
+    /** Question shown by the wizard. */
+    label: string;
+    /** Why this exists and what changes when you set it — shown as a hint and in the docs. */
+    description: string;
+    /** Effective default when the value is absent; documented, never written blindly. */
+    default?: string | number | boolean | string[];
+    choices?: SettingChoice[];
+    placeholder?: string;
+    /** Wizard refuses an empty answer. */
+    required?: boolean;
+}
+export interface Section {
+    id: SectionId;
+    title: string;
+    description: string;
+}
+export declare const SECTIONS: Section[];
+export declare const SETTINGS: Setting[];
+export declare function settingByPath(path: string): Setting | undefined;
+export declare function settingByEnv(env: string): Setting | undefined;
+export declare function settingsInSection(section: SectionId, tier?: SettingTier): Setting[];
+/** Serialise a config value to the string form the runtime expects in process.env. */
+export declare function serializeValue(setting: Setting, value: unknown): string | null;
+/** Parse a string (from a .env file or a prompt) into the typed config value. */
+export declare function parseValue(setting: Setting, raw: string): unknown;
+//# sourceMappingURL=settings.d.ts.map

package/dist/config/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/config/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAElF,uHAAuH;AACvH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE1D,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,WAAW,GACX,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,OAAO,CAAC;AAEZ,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,OAAO;IACtB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAClB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC;IAC/C,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,SAAS,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,QAAQ,EAAE,OAAO,EAyC7B,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,OAAO,EA6jB7B,CAAC;AAKF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE/D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE7D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,EAAE,CAEnF;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAc9E;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAcjE"}