d365fo-mcp 1.0.0

package/dist/cli/settingsPrompt.js

@@ -0,0 +1,150 @@
+/**
+ * Generic prompt for one registry setting.
+ *
+ * Every question is rendered the same way — label, then the setting's own
+ * description dimmed underneath — so a user never has to guess what a value
+ * does or go looking for it in .env.example. The prompt type follows the
+ * setting's `type`, and the answer is written straight into the store.
+ */
+import { c } from '../utils/terminalUi.js';
+import { multiselect } from '@clack/prompts';
+import { SECTIONS, settingsInSection } from '../config/settings.js';
+import { initialText, readSetting, readSettingOrDefault, writeSetting } from './settingsStore.js';
+import { askConfirm, askSelect, askText, ensure, p } from './ui.js';
+/** "Label\n  description" — the uniform question layout. */
+function message(setting, suffix) {
+    const head = suffix ? `${setting.label} ${suffix}` : setting.label;
+    return `${head}\n${c.dim(wrapText(setting.description, 76, '  '))}`;
+}
+function wrapText(text, width, indent) {
+    const words = text.split(/\s+/);
+    const lines = [];
+    let line = '';
+    for (const word of words) {
+        if (line && (line + ' ' + word).length > width) {
+            lines.push(indent + line);
+            line = word;
+        }
+        else {
+            line = line ? `${line} ${word}` : word;
+        }
+    }
+    if (line)
+        lines.push(indent + line);
+    return lines.join('\n');
+}
+/**
+ * Ask for one setting and persist the answer.
+ * Returns the value that ended up in the store (or undefined when skipped).
+ */
+export async function askSetting(store, setting, opts) {
+    const required = opts?.required ?? setting.required ?? false;
+    // Secrets are never echoed and never pre-filled; an empty answer keeps
+    // whatever is already stored (or leaves the value to an environment variable).
+    if (setting.tier === 'secret') {
+        const existing = readSettingOrDefault(store, setting);
+        const entered = ensure(await p.password({
+            message: message(setting, existing ? c.dim('(set — Enter keeps it)') : c.dim('(Enter to skip)')),
+        }));
+        if (entered)
+            writeSetting(store, setting, entered);
+        return entered || existing;
+    }
+    switch (setting.type) {
+        case 'boolean': {
+            const value = await askConfirm(message(setting), readSettingOrDefault(store, setting) === true);
+            writeSetting(store, setting, value);
+            return value;
+        }
+        case 'enum': {
+            const choices = setting.choices ?? [];
+            // A stored value wins over the caller's suggestion — re-running setup must
+            // not silently move an installation onto a freshly detected default.
+            const current = String(readSetting(store, setting) ?? opts?.initial ?? setting.default ?? choices[0]?.value ?? '');
+            const value = await askSelect(message(setting), choices.map(choice => ({ value: choice.value, label: choice.value, hint: choice.hint })), current);
+            writeSetting(store, setting, value);
+            return value;
+        }
+        case 'int': {
+            const raw = await askText({
+                message: message(setting),
+                initialValue: initialText(store, setting),
+                required,
+            });
+            if (!raw) {
+                writeSetting(store, setting, undefined);
+                return undefined;
+            }
+            const parsed = parseInt(raw, 10);
+            if (!Number.isFinite(parsed)) {
+                p.log.warn(`'${raw}' is not a number — keeping the default (${setting.default}).`);
+                return undefined;
+            }
+            writeSetting(store, setting, parsed);
+            return parsed;
+        }
+        case 'list': {
+            const raw = await askText({
+                message: message(setting, c.dim('(comma-separated)')),
+                initialValue: initialText(store, setting),
+                placeholder: setting.placeholder,
+                required,
+            });
+            const list = raw.split(',').map(s => s.trim()).filter(Boolean);
+            writeSetting(store, setting, list.length > 0 ? list : undefined);
+            return list;
+        }
+        default: {
+            const raw = await askText({
+                message: message(setting, required ? '' : c.dim('(Enter to skip)')),
+                initialValue: initialText(store, setting),
+                placeholder: setting.placeholder,
+                required,
+            });
+            writeSetting(store, setting, raw || undefined);
+            return raw || undefined;
+        }
+    }
+}
+/** Ask a whole list of settings in order. */
+export async function askSettings(store, settings) {
+    for (const setting of settings) {
+        await askSetting(store, setting);
+    }
+}
+/**
+ * Optional deep-dive: pick sections, then walk their advanced settings.
+ * Everything here has a working default, so skipping is always safe.
+ */
+export async function askAdvanced(store, sections) {
+    const available = sections.filter(id => settingsInSection(id, 'advanced').length > 0);
+    if (available.length === 0)
+        return;
+    if (!await askConfirm('Review advanced settings? (timeouts, index layout, quality gates — all have defaults)', false)) {
+        return;
+    }
+    const options = available.map(id => {
+        const section = SECTIONS.find(s => s.id === id);
+        const count = settingsInSection(id, 'advanced').length;
+        return { value: id, label: `${section.title} (${count})`, hint: section.description };
+    });
+    const picked = ensure(await multiselect({
+        message: 'Which areas do you want to tune? (space selects, Enter confirms)',
+        options,
+        required: false,
+    }));
+    for (const id of picked) {
+        const section = SECTIONS.find(s => s.id === id);
+        p.log.step(`${section.title} — ${section.description}`);
+        await askSettings(store, settingsInSection(id, 'advanced'));
+    }
+}
+/** Ask for the secrets of the given sections, skipping any already set. */
+export async function askSecrets(store, sections) {
+    for (const id of sections) {
+        for (const setting of settingsInSection(id, 'secret')) {
+            await askSetting(store, setting);
+        }
+    }
+}
+//# sourceMappingURL=settingsPrompt.js.map

package/dist/cli/settingsPrompt.js.map

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

package/dist/cli/settingsStore.d.ts

@@ -0,0 +1,47 @@
+import { type ConfigObject } from '../config/configFile.js';
+import { type Setting } from '../config/settings.js';
+export interface SettingsStore {
+    /** Directory holding d365fo-mcp.json / secrets.json. */
+    dir: string;
+    /** Project directory relative path settings resolve from (repo root, or the instance folder). */
+    baseDir: string;
+    configPath: string;
+    secretsPath: string;
+    config: ConfigObject;
+    secrets: ConfigObject;
+    /** Legacy .env consulted as a fallback when a value is missing from the JSON. */
+    legacyEnvFile: string | null;
+}
+/**
+ * Open the store for a base directory (repo root, or an instance folder).
+ * `legacyEnvFile` is the .env that used to hold the same settings, if any.
+ */
+export declare function openStore(baseDir: string, legacyEnvFile: string | null): SettingsStore;
+/** Store rooted at an instance folder: instances/<name>/d365fo-mcp.json. */
+export declare function openInstanceStore(instanceDir: string): SettingsStore;
+/** Effective value of a setting, or undefined when nothing configures it. */
+export declare function readSetting(store: SettingsStore, setting: Setting): unknown;
+/** Effective value, falling back to the documented default. */
+export declare function readSettingOrDefault(store: SettingsStore, setting: Setting): unknown;
+/** Value as the wizard should pre-fill it in a text prompt. */
+export declare function initialText(store: SettingsStore, setting: Setting): string;
+/** Absolute form of a `path`-typed setting, or `fallback` when it is unset. */
+export declare function readPath(store: SettingsStore, setting: Setting, fallback: string): string;
+export declare function writeSetting(store: SettingsStore, setting: Setting, value: unknown): void;
+export declare function saveStore(store: SettingsStore): void;
+/**
+ * Copy every setting present in a legacy .env into the JSON config, so the
+ * first `setup` run after upgrading starts from the values already in use.
+ * Returns the settings that were carried over.
+ */
+export declare function migrateLegacyEnv(store: SettingsStore): Setting[];
+/**
+ * Settings a legacy .env still defines with a value different from the JSON.
+ * The JSON wins at runtime, so these are worth reporting rather than fixing.
+ */
+export declare function conflictingLegacyValues(store: SettingsStore): {
+    setting: Setting;
+    envValue: string;
+    configValue: string;
+}[];
+//# sourceMappingURL=settingsStore.d.ts.map

package/dist/cli/settingsStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settingsStore.d.ts","sourceRoot":"","sources":["../../src/cli/settingsStore.ts"],"names":[],"mappings":"AAUA,OAAO,EAML,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAwB,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAG3E,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,iGAAiG;IACjG,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;IACtB,iFAAiF;IACjF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,aAAa,CAatF;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAEpE;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAQ3E;AAED,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAGpF;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAI1E;AAED,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIzF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAEzF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAGpD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,EAAE,CAsBhE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,aAAa,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,CAc3H"}

package/dist/cli/settingsStore.js

@@ -0,0 +1,144 @@
+/**
+ * CLI-side view of the structured configuration.
+ *
+ * Wraps src/config/configFile.ts with the bits only the CLI needs: reading the
+ * effective value of a setting (config → secrets → legacy .env → default),
+ * writing single values, and migrating an existing .env into the JSON shape so
+ * a returning user is never asked twice for something they already configured.
+ */
+import * as fs from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+import { getAtPath, resolveConfigFiles, setAtPath, writeConfigFile, writeSecretsFile, } from '../config/configFile.js';
+import { SETTINGS, parseValue } from '../config/settings.js';
+import { readEnvValue } from './envFile.js';
+/**
+ * Open the store for a base directory (repo root, or an instance folder).
+ * `legacyEnvFile` is the .env that used to hold the same settings, if any.
+ */
+export function openStore(baseDir, legacyEnvFile) {
+    // allowEnvOverride: false — the CLI opens several stores in one process, so a
+    // D365FO_CONFIG inherited from the shell must not redirect all of them.
+    const files = resolveConfigFiles(baseDir, { allowEnvOverride: false });
+    return {
+        dir: files.dir,
+        baseDir: files.baseDir,
+        configPath: files.configPath,
+        secretsPath: files.secretsPath,
+        config: files.config ?? {},
+        secrets: files.secrets ?? {},
+        legacyEnvFile: legacyEnvFile && fs.existsSync(legacyEnvFile) ? legacyEnvFile : null,
+    };
+}
+/** Store rooted at an instance folder: instances/<name>/d365fo-mcp.json. */
+export function openInstanceStore(instanceDir) {
+    return openStore(instanceDir, join(instanceDir, '.env'));
+}
+/** Effective value of a setting, or undefined when nothing configures it. */
+export function readSetting(store, setting) {
+    const fromJson = getAtPath(setting.tier === 'secret' ? store.secrets : store.config, setting.path);
+    if (fromJson !== undefined && fromJson !== null && fromJson !== '')
+        return fromJson;
+    if (store.legacyEnvFile) {
+        const raw = readEnvValue(store.legacyEnvFile, setting.env);
+        if (raw !== null && raw !== '')
+            return parseValue(setting, stripInlineComment(raw));
+    }
+    return undefined;
+}
+/** Effective value, falling back to the documented default. */
+export function readSettingOrDefault(store, setting) {
+    const value = readSetting(store, setting);
+    return value === undefined ? setting.default : value;
+}
+/** Value as the wizard should pre-fill it in a text prompt. */
+export function initialText(store, setting) {
+    const value = readSettingOrDefault(store, setting);
+    if (value === undefined || value === null)
+        return '';
+    return Array.isArray(value) ? value.join(',') : String(value);
+}
+/** Absolute form of a `path`-typed setting, or `fallback` when it is unset. */
+export function readPath(store, setting, fallback) {
+    const value = readSetting(store, setting) ?? setting.default;
+    if (typeof value !== 'string' || !value)
+        return fallback;
+    return isAbsolute(value) ? value : resolve(store.baseDir, value);
+}
+export function writeSetting(store, setting, value) {
+    setAtPath(setting.tier === 'secret' ? store.secrets : store.config, setting.path, value);
+}
+export function saveStore(store) {
+    writeConfigFile(store.configPath, store.config);
+    writeSecretsFile(store.secretsPath, store.secrets);
+}
+/**
+ * Copy every setting present in a legacy .env into the JSON config, so the
+ * first `setup` run after upgrading starts from the values already in use.
+ * Returns the settings that were carried over.
+ */
+export function migrateLegacyEnv(store) {
+    if (!store.legacyEnvFile)
+        return [];
+    const migrated = [];
+    for (const setting of SETTINGS) {
+        // Never move a secret into the JSON automatically — the user decides
+        // whether it lands in secrets.json or stays an environment variable.
+        if (setting.tier === 'secret')
+            continue;
+        if (getAtPath(store.config, setting.path) !== undefined)
+            continue;
+        const raw = readEnvValue(store.legacyEnvFile, setting.env);
+        if (raw === null)
+            continue;
+        const cleaned = stripInlineComment(raw);
+        if (!cleaned)
+            continue;
+        const parsed = parseValue(setting, cleaned);
+        if (parsed === undefined || (Array.isArray(parsed) && parsed.length === 0))
+            continue;
+        // A value the registry no longer offers (the retired
+        // D365FO_DEV_ENVIRONMENT_TYPE=auto, say) is left behind rather than carried
+        // into the new config, where it would show up as an unpickable choice.
+        if (setting.type === 'enum' && !setting.choices?.some(c => c.value === parsed))
+            continue;
+        setAtPath(store.config, setting.path, parsed);
+        migrated.push(setting);
+    }
+    return migrated;
+}
+/**
+ * Settings a legacy .env still defines with a value different from the JSON.
+ * The JSON wins at runtime, so these are worth reporting rather than fixing.
+ */
+export function conflictingLegacyValues(store) {
+    if (!store.legacyEnvFile)
+        return [];
+    const out = [];
+    for (const setting of SETTINGS) {
+        const raw = readEnvValue(store.legacyEnvFile, setting.env);
+        if (raw === null)
+            continue;
+        const envValue = stripInlineComment(raw);
+        if (!envValue)
+            continue;
+        const json = getAtPath(setting.tier === 'secret' ? store.secrets : store.config, setting.path);
+        if (json === undefined || json === null || json === '')
+            continue;
+        const configValue = Array.isArray(json) ? json.join(',') : String(json);
+        if (configValue !== envValue)
+            out.push({ setting, envValue, configValue });
+    }
+    return out;
+}
+/**
+ * Drop a trailing `# comment` from a .env value.
+ * .env.example documents defaults inline ("PORT=8080   # HTTP listen port"),
+ * and dotenv keeps everything after the value, so migration must not carry the
+ * comment into the JSON.
+ */
+function stripInlineComment(raw) {
+    const m = raw.match(/^\s*("[^"]*"|'[^']*'|[^#]*)/);
+    const value = (m ? m[1] : raw).trim();
+    return value.replace(/^(['"])(.*)\1$/, '$2').trim();
+}
+//# sourceMappingURL=settingsStore.js.map

package/dist/cli/settingsStore.js.map

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

package/dist/cli/target.d.ts

@@ -0,0 +1,23 @@
+import { Instance } from './instances.js';
+import { type SettingsStore } from './settingsStore.js';
+export interface Target {
+    /** 'root' or the instance name */
+    name: string;
+    label: string;
+    /** Legacy .env, when one exists — still read as a fallback by the server. */
+    envFile: string | null;
+    /** Structured configuration (config/d365fo-mcp.json or instances/<name>/d365fo-mcp.json). */
+    store: SettingsStore;
+    port: number | null;
+    instance?: Instance;
+}
+/** Environment for a child process so it loads this target's configuration. */
+export declare function targetEnv(target: Target): Record<string, string> | undefined;
+export declare function rootTarget(): Target;
+export declare function instanceTarget(inst: Instance): Target;
+/**
+ * Resolve the target: explicit name → that instance ('root' selects the root
+ * server); no name and no instances → root; otherwise ask.
+ */
+export declare function pickTarget(instanceName: string | undefined, message: string): Promise<Target>;
+//# sourceMappingURL=target.d.ts.map

package/dist/cli/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/cli/target.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAiB,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAgC,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGtF,MAAM,WAAW,MAAM;IACrB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,6FAA6F;IAC7F,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAK5E;AAED,wBAAgB,UAAU,IAAI,MAAM,CAQnC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CASrD;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBnG"}

package/dist/cli/target.js

@@ -0,0 +1,62 @@
+/**
+ * Target selection — commands like start/index operate either on the root
+ * server (repo .env) or on one instance under instances/. Resolves a
+ * positional instance name, or asks interactively when instances exist.
+ */
+import * as fs from 'node:fs';
+import { paths, repoRoot } from './context.js';
+import { listInstances } from './instances.js';
+import { openInstanceStore, openStore } from './settingsStore.js';
+import { askSelect } from './ui.js';
+/** Environment for a child process so it loads this target's configuration. */
+export function targetEnv(target) {
+    const env = {};
+    if (target.envFile)
+        env.ENV_FILE = target.envFile;
+    if (fs.existsSync(target.store.configPath))
+        env.D365FO_CONFIG = target.store.configPath;
+    return Object.keys(env).length > 0 ? env : undefined;
+}
+export function rootTarget() {
+    return {
+        name: 'root',
+        label: 'root server',
+        envFile: fs.existsSync(paths.rootEnv) ? paths.rootEnv : null,
+        store: openStore(repoRoot, paths.rootEnv),
+        port: null,
+    };
+}
+export function instanceTarget(inst) {
+    return {
+        name: inst.name,
+        label: `instance '${inst.name}'`,
+        envFile: fs.existsSync(inst.envFile) ? inst.envFile : null,
+        store: openInstanceStore(inst.dir),
+        port: inst.port,
+        instance: inst,
+    };
+}
+/**
+ * Resolve the target: explicit name → that instance ('root' selects the root
+ * server); no name and no instances → root; otherwise ask.
+ */
+export async function pickTarget(instanceName, message) {
+    const instances = listInstances();
+    if (instanceName) {
+        if (instanceName === 'root')
+            return rootTarget();
+        const inst = instances.find(i => i.name === instanceName);
+        if (!inst) {
+            throw new Error(`Instance '${instanceName}' not found. Available: ${instances.map(i => i.name).join(', ') || '(none)'}`);
+        }
+        return instanceTarget(inst);
+    }
+    if (instances.length === 0)
+        return rootTarget();
+    const choice = await askSelect(message, [
+        { value: 'root', label: 'root server', hint: repoRoot },
+        ...instances.map(i => ({ value: i.name, label: i.name, hint: i.port !== null ? `port ${i.port}` : undefined })),
+    ]);
+    return choice === 'root' ? rootTarget() : instanceTarget(instances.find(i => i.name === choice));
+}
+//# sourceMappingURL=target.js.map

package/dist/cli/target.js.map

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

package/dist/cli/ui.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Prompt helpers — thin wrapper over @clack/prompts with uniform
+ * cancel handling (Ctrl+C / Esc exits the CLI cleanly instead of
+ * returning a cancel symbol every caller must check).
+ */
+import * as p from '@clack/prompts';
+import type { Option } from '@clack/prompts';
+export { p };
+/** Unwrap a clack result; exit gracefully when the user cancelled. */
+export declare function ensure<T>(value: T | symbol): T;
+export declare function askText(opts: {
+    message: string;
+    placeholder?: string;
+    initialValue?: string;
+    required?: boolean;
+}): Promise<string>;
+export declare function askConfirm(message: string, initialValue?: boolean): Promise<boolean>;
+export declare function askSelect<T extends string>(message: string, options: Option<T>[], initialValue?: T): Promise<T>;
+/**
+ * Guard for commands that only work inside a git checkout (setup, update,
+ * index). Running from the npx cache or an unpacked release tarball lacks
+ * scripts/, devDependencies and git — point the user at the installer instead
+ * of failing halfway through.
+ */
+export declare function requireGitCheckout(): boolean;
+//# sourceMappingURL=ui.d.ts.map

package/dist/cli/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/cli/ui.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,EAAE,CAAC,EAAE,CAAC;AAEb,sEAAsE;AACtE,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,GAAG,CAAC,CAM9C;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAQzI;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAEvF;AAED,wBAAsB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAErH;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAU5C"}

package/dist/cli/ui.js

@@ -0,0 +1,48 @@
+/**
+ * Prompt helpers — thin wrapper over @clack/prompts with uniform
+ * cancel handling (Ctrl+C / Esc exits the CLI cleanly instead of
+ * returning a cancel symbol every caller must check).
+ */
+import * as p from '@clack/prompts';
+import { installOneLiner, isGitCheckout } from './context.js';
+export { p };
+/** Unwrap a clack result; exit gracefully when the user cancelled. */
+export function ensure(value) {
+    if (p.isCancel(value)) {
+        p.cancel('Cancelled.');
+        process.exit(0);
+    }
+    return value;
+}
+export async function askText(opts) {
+    const v = ensure(await p.text({
+        message: opts.message,
+        placeholder: opts.placeholder,
+        initialValue: opts.initialValue,
+        validate: opts.required ? (s) => (s?.trim() ? undefined : 'Required') : undefined,
+    }));
+    return (v ?? '').trim();
+}
+export async function askConfirm(message, initialValue = true) {
+    return ensure(await p.confirm({ message, initialValue }));
+}
+export async function askSelect(message, options, initialValue) {
+    return ensure(await p.select({ message, options, initialValue }));
+}
+/**
+ * Guard for commands that only work inside a git checkout (setup, update,
+ * index). Running from the npx cache or an unpacked release tarball lacks
+ * scripts/, devDependencies and git — point the user at the installer instead
+ * of failing halfway through.
+ */
+export function requireGitCheckout() {
+    if (isGitCheckout)
+        return true;
+    p.log.error('This copy of d365fo-mcp is not a full installation — no git checkout found.');
+    p.log.info('Install the server with PowerShell:\n' +
+        `  ${installOneLiner}\n` +
+        'then run this command again from the install directory (npm run cli -- <command>).');
+    process.exitCode = 1;
+    return false;
+}
+//# sourceMappingURL=ui.js.map

package/dist/cli/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/cli/ui.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,EAAE,CAAC,EAAE,CAAC;AAEb,sEAAsE;AACtE,MAAM,UAAU,MAAM,CAAI,KAAiB;IACzC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,KAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAA0F;IACtH,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;QAC5B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS;KAC3F,CAAC,CAAC,CAAC;IACJ,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAe,EAAE,YAAY,GAAG,IAAI;IACnE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAmB,OAAe,EAAE,OAAoB,EAAE,YAAgB;IACvG,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAI,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,aAAa;QAAE,OAAO,IAAI,CAAC;IAC/B,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,6EAA6E,CAAC,CAAC;IAC3F,CAAC,CAAC,GAAG,CAAC,IAAI,CACR,uCAAuC;QACvC,KAAK,eAAe,IAAI;QACxB,oFAAoF,CACrF,CAAC;IACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACrB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cli/xppConfig.d.ts

@@ -0,0 +1,35 @@
+import { getValue } from './envFile.js';
+import { type SettingsStore } from './settingsStore.js';
+export interface XppConfig {
+    /** Filename without .json, e.g. "contoso-dev___10.0.2428.63" */
+    fullName: string;
+    /** Environment name before the ___ separator */
+    name: string;
+    version: string;
+    file: string;
+    mtimeMs: number;
+    modelStoreFolder?: string;
+    frameworkDirectory?: string;
+}
+export declare function xppConfigDir(): string | null;
+/** All versioned configs, newest first. Empty when the directory is absent. */
+export declare function listXppConfigs(): XppConfig[];
+/**
+ * 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 declare function normalizeXppConfigName(store: SettingsStore): {
+    from: string;
+    to: string;
+} | null;
+/**
+ * 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 declare function isXppConfigStale(store: SettingsStore): boolean;
+export { getValue as _getValue };
+//# sourceMappingURL=xppConfig.d.ts.map

package/dist/cli/xppConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xppConfig.d.ts","sourceRoot":"","sources":["../../src/cli/xppConfig.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAK9F,MAAM,WAAW,SAAS;IACxB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAI5C;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,IAAI,SAAS,EAAE,CA0B5C;AAQD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAYhG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAO9D;AAGD,OAAO,EAAE,QAAQ,IAAI,SAAS,EAAE,CAAC"}