d365fo-mcp 1.0.0

package/dist/cli/context.js

@@ -0,0 +1,38 @@
+/**
+ * CLI context — repo-root resolution shared by all commands.
+ *
+ * The CLI runs either from src/cli (tsx during development) or dist/cli
+ * (built). Both are exactly two levels below the repo root, so resolve
+ * relative to this file rather than process.cwd() — developers invoke the
+ * CLI from arbitrary directories.
+ */
+import * as fs from 'node:fs';
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+const __cliDir = dirname(fileURLToPath(import.meta.url));
+export const repoRoot = resolve(__cliDir, '../..');
+/**
+ * True when the CLI runs from a git checkout — the only supported layout for
+ * setup/update/index. Those commands need scripts/, devDependencies (tsx) and
+ * `git pull`, none of which exist when the package runs from the npx cache or
+ * a release tarball.
+ */
+export const isGitCheckout = fs.existsSync(resolve(repoRoot, '.git'));
+/** Bootstrap one-liner printed when a command needs a full installation. */
+export const installOneLiner = 'irm https://raw.githubusercontent.com/dynamics365ninja/d365fo-mcp-server/main/install.ps1 | iex';
+export const paths = {
+    /** Legacy configuration file — still read as a fallback, no longer written. */
+    rootEnv: resolve(repoRoot, '.env'),
+    rootConfig: resolve(repoRoot, 'config', 'd365fo-mcp.json'),
+    rootSecrets: resolve(repoRoot, 'config', 'secrets.json'),
+    instancesDir: resolve(repoRoot, 'instances'),
+    distEntry: resolve(repoRoot, 'dist', 'index.js'),
+    defaultDb: resolve(repoRoot, 'data', 'xpp-metadata.db'),
+    defaultLabelsDb: resolve(repoRoot, 'data', 'xpp-metadata-labels.db'),
+    bridgeDir: resolve(repoRoot, 'bridge', 'D365MetadataBridge'),
+    bridgeExe: resolve(repoRoot, 'bridge', 'D365MetadataBridge', 'bin', 'Release', 'D365MetadataBridge.exe'),
+    extractScript: resolve(repoRoot, 'scripts', 'extract-metadata.ts'),
+    buildDbScript: resolve(repoRoot, 'scripts', 'build-database.ts'),
+};
+export const isWindows = process.platform === 'win32';
+//# sourceMappingURL=context.js.map

package/dist/cli/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAExC,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAEtE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,eAAe,GAC1B,iGAAiG,CAAC;AAEpG,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC;IAClC,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,CAAC;IAC1D,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,cAAc,CAAC;IACxD,YAAY,EAAE,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC5C,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC;IAChD,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,iBAAiB,CAAC;IACvD,eAAe,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,wBAAwB,CAAC;IACpE,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,oBAAoB,CAAC;IAC5D,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,SAAS,EAAE,wBAAwB,CAAC;IACxG,aAAa,EAAE,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,qBAAqB,CAAC;IAClE,aAAa,EAAE,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,mBAAmB,CAAC;CACxD,CAAC;AAEX,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC"}

package/dist/cli/envFile.d.ts

@@ -0,0 +1,23 @@
+/** First active (non-commented) value of `key`, or null. */
+export declare function getValue(content: string, key: string): string | null;
+/** Replace the active line, else un-comment a commented one, else append. */
+export declare function setValue(content: string, key: string, value: string): string;
+/**
+ * All variable names present in the file. Commented-out assignments
+ * ("# KEY=value") count as present-but-disabled so the missing-settings
+ * check doesn't nag about vars a user intentionally left commented.
+ */
+export declare function varNames(content: string): string[];
+/** Vars in `exampleContent` that are absent from `envContent`, with example values. */
+export declare function missingVars(exampleContent: string, envContent: string): {
+    name: string;
+    value: string;
+}[];
+export declare function readEnvValue(envFile: string, key: string): string | null;
+export declare function writeEnvValue(envFile: string, key: string, value: string): void;
+/**
+ * Dev-environment type with the legacy fallback name, matching
+ * run-instance.ps1 / rebuild-instance.ps1 and the server itself.
+ */
+export declare function readDevEnvType(envFile: string): string | null;
+//# sourceMappingURL=envFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"envFile.d.ts","sourceRoot":"","sources":["../../src/cli/envFile.ts"],"names":[],"mappings":"AAYA,4DAA4D;AAC5D,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIpE;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAa5E;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAOlD;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CASzG;AAID,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGxE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAG/E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7D"}

package/dist/cli/envFile.js

@@ -0,0 +1,79 @@
+/**
+ * .env file helpers — read/update individual keys while preserving the rest
+ * of the file byte-for-byte (comments, ordering, blank lines).
+ *
+ * Mirrors the semantics of the PowerShell management scripts
+ * (instances/*.ps1, scripts/select-xpp-config.ps1) so both entry points stay
+ * interchangeable: an active line wins over a commented one, setting a key
+ * first replaces the active line, then un-comments a commented line, and
+ * finally appends.
+ */
+import * as fs from 'node:fs';
+/** First active (non-commented) value of `key`, or null. */
+export function getValue(content, key) {
+    const re = new RegExp(`^\\s*${escapeRe(key)}\\s*=(.*)$`, 'm');
+    const m = content.match(re);
+    return m ? m[1].trim() : null;
+}
+/** Replace the active line, else un-comment a commented one, else append. */
+export function setValue(content, key, value) {
+    // Replacer function, not a replacement string — values containing `$&`
+    // or `$'` must land in the file literally.
+    const line = () => `${key}=${value}`;
+    const active = new RegExp(`^\\s*${escapeRe(key)}\\s*=.*$`, 'm');
+    if (active.test(content)) {
+        return content.replace(active, line);
+    }
+    const commented = new RegExp(`^#\\s*${escapeRe(key)}\\s*=.*$`, 'm');
+    if (commented.test(content)) {
+        return content.replace(commented, line);
+    }
+    return content.replace(/\s*$/, '') + `\n${key}=${value}\n`;
+}
+/**
+ * All variable names present in the file. Commented-out assignments
+ * ("# KEY=value") count as present-but-disabled so the missing-settings
+ * check doesn't nag about vars a user intentionally left commented.
+ */
+export function varNames(content) {
+    const names = [];
+    for (const line of content.split(/\r?\n/)) {
+        const m = line.match(/^\s*#?\s*([A-Za-z_][A-Za-z0-9_]*)\s*=/);
+        if (m)
+            names.push(m[1]);
+    }
+    return names;
+}
+/** Vars in `exampleContent` that are absent from `envContent`, with example values. */
+export function missingVars(exampleContent, envContent) {
+    const have = new Set(varNames(envContent));
+    const missing = [];
+    for (const name of varNames(exampleContent)) {
+        if (have.has(name))
+            continue;
+        have.add(name); // report each var once
+        missing.push({ name, value: getValue(exampleContent, name) ?? '' });
+    }
+    return missing;
+}
+// File-backed wrappers
+export function readEnvValue(envFile, key) {
+    if (!fs.existsSync(envFile))
+        return null;
+    return getValue(fs.readFileSync(envFile, 'utf8'), key);
+}
+export function writeEnvValue(envFile, key, value) {
+    const content = fs.existsSync(envFile) ? fs.readFileSync(envFile, 'utf8') : '';
+    fs.writeFileSync(envFile, setValue(content, key, value));
+}
+/**
+ * Dev-environment type with the legacy fallback name, matching
+ * run-instance.ps1 / rebuild-instance.ps1 and the server itself.
+ */
+export function readDevEnvType(envFile) {
+    return readEnvValue(envFile, 'D365FO_DEV_ENVIRONMENT_TYPE') ?? readEnvValue(envFile, 'DEV_ENVIRONMENT_TYPE');
+}
+function escapeRe(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=envFile.js.map

package/dist/cli/envFile.js.map

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

package/dist/cli/exec.d.ts

@@ -0,0 +1,13 @@
+export interface RunOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+}
+/** Run a constant command line (e.g. 'npm install') through the shell. */
+export declare function runShell(command: string, opts?: RunOptions): Promise<number>;
+/** Run the current Node binary with the given args (no shell). */
+export declare function runNode(args: string[], opts?: RunOptions): Promise<number>;
+/** Run a real executable (dotnet, git) with an args array (no shell). */
+export declare function runExe(cmd: string, args: string[], opts?: RunOptions): Promise<number>;
+/** Throwing variant — use for steps where a failure must abort the flow. */
+export declare function mustSucceed(promise: Promise<number>, what: string): Promise<void>;
+//# sourceMappingURL=exec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/cli/exec.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAeD,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhF;AAED,kEAAkE;AAClE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAE9E;AAED,yEAAyE;AACzE,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1F;AAED,4EAA4E;AAC5E,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKvF"}

package/dist/cli/exec.js

@@ -0,0 +1,47 @@
+/**
+ * Subprocess helpers for the management CLI.
+ *
+ * Two flavours, chosen to avoid Windows quoting pitfalls:
+ *  - runShell: constant command strings (npm install, git pull, …) through the
+ *    platform shell — npm/npx are .cmd shims on Windows and cannot be spawned
+ *    directly (EINVAL since the Node 18 shell hardening).
+ *  - runNode / runExe: real executables (node itself, dotnet.exe) with an args
+ *    array and no shell, so paths with spaces need no quoting.
+ *
+ * All flavours stream output to the terminal (stdio: inherit) — extraction and
+ * database builds run for minutes and their progress must stay visible.
+ */
+import { spawn } from 'node:child_process';
+import { repoRoot } from './context.js';
+function spawnAndWait(cmd, args, opts, shell) {
+    return new Promise((resolvePromise, reject) => {
+        const child = spawn(cmd, args, {
+            cwd: opts.cwd ?? repoRoot,
+            env: { ...process.env, ...opts.env },
+            stdio: 'inherit',
+            shell,
+        });
+        child.on('error', reject);
+        child.on('close', code => resolvePromise(code ?? 1));
+    });
+}
+/** Run a constant command line (e.g. 'npm install') through the shell. */
+export function runShell(command, opts = {}) {
+    return spawnAndWait(command, [], opts, true);
+}
+/** Run the current Node binary with the given args (no shell). */
+export function runNode(args, opts = {}) {
+    return spawnAndWait(process.execPath, args, opts, false);
+}
+/** Run a real executable (dotnet, git) with an args array (no shell). */
+export function runExe(cmd, args, opts = {}) {
+    return spawnAndWait(cmd, args, opts, false);
+}
+/** Throwing variant — use for steps where a failure must abort the flow. */
+export async function mustSucceed(promise, what) {
+    const code = await promise;
+    if (code !== 0) {
+        throw new Error(`${what} failed with exit code ${code}`);
+    }
+}
+//# sourceMappingURL=exec.js.map

package/dist/cli/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/cli/exec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAOxC,SAAS,YAAY,CAAC,GAAW,EAAE,IAAc,EAAE,IAAgB,EAAE,KAAc;IACjF,OAAO,IAAI,OAAO,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE;QAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE;YAC7B,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,QAAQ;YACzB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;YACpC,KAAK,EAAE,SAAS;YAChB,KAAK;SACN,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,IAAI,GAAe,EAAE;IAC7D,OAAO,YAAY,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,OAAO,CAAC,IAAc,EAAE,IAAI,GAAe,EAAE;IAC3D,OAAO,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,MAAM,CAAC,GAAW,EAAE,IAAc,EAAE,IAAI,GAAe,EAAE;IACvE,OAAO,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAwB,EAAE,IAAY;IACtE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;IAC3B,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,0BAA0B,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+/**
+ * d365fo-mcp — interactive management CLI for the D365 F&O MCP Server.
+ *
+ * Every operation is a plain subcommand (scriptable, CI-friendly); running
+ * with no arguments opens an interactive menu, and any missing argument is
+ * asked for with predefined choices. The instances/*.ps1 scripts remain as a
+ * PowerShell fallback for the same flows.
+ *
+ *   d365fo-mcp                  interactive menu
+ *   d365fo-mcp setup            first-time setup wizard (scenarios A–F)
+ *   d365fo-mcp config [section] change settings after setup
+ *   d365fo-mcp doctor           environment & installation health check
+ *   d365fo-mcp start [name]     run the root server or an instance
+ *   d365fo-mcp update [--yes]   git pull + npm install + build (+ bridge/index)
+ *   d365fo-mcp index [name]     rebuild the metadata index (--all: all instances)
+ *   d365fo-mcp instance …       add | list | run | rebuild | upgrade
+ */
+import { Command } from 'commander';
+import { configCommand } from './commands/config.js';
+import { doctorCommand } from './commands/doctor.js';
+import { indexCommand } from './commands/indexCmd.js';
+import { instanceAddCommand, instanceListCommand, instanceUpgradeCommand } from './commands/instance.js';
+import { setupCommand } from './commands/setup.js';
+import { startCommand } from './commands/start.js';
+import { updateCommand } from './commands/update.js';
+import { askSelect, p } from './ui.js';
+import { listInstances } from './instances.js';
+const program = new Command();
+program
+    .name('d365fo-mcp')
+    .description('Manage the D365 F&O MCP Server: setup, updates, instances, index builds')
+    .version('1.0.0');
+program.command('setup')
+    .description('First-time setup wizard (deployment scenarios A–F from docs/SETUP.md)')
+    .action(setupCommand);
+program.command('config')
+    .argument('[section]', 'environment | workspace | naming | index | server | bridge | behavior | azure')
+    .option('-i, --instance <name>', 'edit an instance instead of the root server')
+    .option('--xpp-config', 'only repick the pinned XPP config (UDE)')
+    .description('Change settings after setup — every question explains itself (docs/CONFIGURATION.md)')
+    .action((section, opts) => configCommand(section, opts));
+program.command('doctor')
+    .description('Check the environment and installation; prints a fix for every problem')
+    .action(doctorCommand);
+program.command('start')
+    .argument('[instance]', "instance name, or 'root' for the repo-level .env")
+    .description('Start the server in the foreground (HTTP mode)')
+    .action(startCommand);
+program.command('update')
+    .option('-y, --yes', 'non-interactive: accept defaults, skip the reindex question')
+    .description('Update the installation: git pull + npm install + build (+ bridge, index)')
+    .action(updateCommand);
+program.command('index')
+    .argument('[instance]', "instance name, or 'root' for the repo-level .env")
+    .option('--all', 'rebuild every instance')
+    .option('-y, --yes', 'non-interactive: skip confirmation questions')
+    .description('Rebuild the metadata index (extract + build database)')
+    .action(indexCommand);
+const instance = program.command('instance').description('Manage multi-instance setups (Scenario F)');
+instance.command('add')
+    .argument('[name]', 'instance name')
+    .argument('[port]', 'HTTP port')
+    .description('Create a new instance (folder + .env from the template)')
+    .action(instanceAddCommand);
+instance.command('list')
+    .description('List instances with port, index size and pinned XPP config')
+    .action(instanceListCommand);
+instance.command('run')
+    .argument('[name]', 'instance name')
+    .description('Start an instance (alias of: d365fo-mcp start <name>)')
+    .action(startCommand);
+instance.command('rebuild')
+    .argument('[name]', 'instance name')
+    .option('--all', 'rebuild every instance')
+    .description('Rebuild the index of an instance (alias of: d365fo-mcp index <name>)')
+    .action((name, opts) => indexCommand(name, opts));
+instance.command('upgrade')
+    .argument('[name]', 'instance name')
+    .description('Repoint an instance at a new XPP config after a UDE upgrade, then rebuild')
+    .action(instanceUpgradeCommand);
+/** No arguments → interactive menu over the same commands. */
+async function mainMenu() {
+    p.intro('d365fo-mcp — D365 F&O MCP Server management');
+    const hasInstances = listInstances().length > 0;
+    const action = await askSelect('What do you want to do?', [
+        { value: 'setup', label: 'Setup', hint: 'first-time setup wizard' },
+        { value: 'config', label: 'Change settings', hint: 'edit one area of the configuration' },
+        { value: 'doctor', label: 'Doctor', hint: 'check environment & installation' },
+        { value: 'start', label: 'Start server', hint: hasInstances ? 'root or an instance' : 'root server' },
+        { value: 'update', label: 'Update', hint: 'git pull + install + build' },
+        { value: 'index', label: 'Rebuild index', hint: 'extract metadata + build database' },
+        { value: 'instance-add', label: 'Add instance', hint: 'new multi-instance environment' },
+        ...(hasInstances ? [
+            { value: 'instance-list', label: 'List instances' },
+            { value: 'instance-upgrade', label: 'Upgrade instance', hint: 'repoint at a new XPP config' },
+        ] : []),
+    ]);
+    switch (action) {
+        case 'setup': return setupCommand();
+        case 'config': return configCommand(undefined, {});
+        case 'doctor': return doctorCommand();
+        case 'start': return startCommand(undefined);
+        case 'update': return updateCommand({});
+        case 'index': return indexCommand(undefined, {});
+        case 'instance-add': return instanceAddCommand(undefined, undefined);
+        case 'instance-list': return instanceListCommand();
+        case 'instance-upgrade': return instanceUpgradeCommand(undefined);
+    }
+}
+async function main() {
+    if (process.argv.length <= 2) {
+        await mainMenu();
+        return;
+    }
+    await program.parseAsync(process.argv);
+}
+main().catch((err) => {
+    p.log.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACzG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,yEAAyE,CAAC;KACtF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;KACrB,WAAW,CAAC,uEAAuE,CAAC;KACpF,MAAM,CAAC,YAAY,CAAC,CAAC;AAExB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;KACtB,QAAQ,CAAC,WAAW,EAAE,+EAA+E,CAAC;KACtG,MAAM,CAAC,uBAAuB,EAAE,6CAA6C,CAAC;KAC9E,MAAM,CAAC,cAAc,EAAE,yCAAyC,CAAC;KACjE,WAAW,CAAC,sFAAsF,CAAC;KACnG,MAAM,CAAC,CAAC,OAA2B,EAAE,IAAgD,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;AAE3H,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;KACtB,WAAW,CAAC,wEAAwE,CAAC;KACrF,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;KACrB,QAAQ,CAAC,YAAY,EAAE,kDAAkD,CAAC;KAC1E,WAAW,CAAC,gDAAgD,CAAC;KAC7D,MAAM,CAAC,YAAY,CAAC,CAAC;AAExB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;KACtB,MAAM,CAAC,WAAW,EAAE,6DAA6D,CAAC;KAClF,WAAW,CAAC,2EAA2E,CAAC;KACxF,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;KACrB,QAAQ,CAAC,YAAY,EAAE,kDAAkD,CAAC;KAC1E,MAAM,CAAC,OAAO,EAAE,wBAAwB,CAAC;KACzC,MAAM,CAAC,WAAW,EAAE,8CAA8C,CAAC;KACnE,WAAW,CAAC,uDAAuD,CAAC;KACpE,MAAM,CAAC,YAAY,CAAC,CAAC;AAExB,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,2CAA2C,CAAC,CAAC;AACtG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;KACpB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;KACnC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;KAC/B,WAAW,CAAC,yDAAyD,CAAC;KACtE,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAC9B,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;KACrB,WAAW,CAAC,4DAA4D,CAAC;KACzE,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAC/B,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;KACpB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;KACnC,WAAW,CAAC,uDAAuD,CAAC;KACpE,MAAM,CAAC,YAAY,CAAC,CAAC;AACxB,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;KACxB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;KACnC,MAAM,CAAC,OAAO,EAAE,wBAAwB,CAAC;KACzC,WAAW,CAAC,sEAAsE,CAAC;KACnF,MAAM,CAAC,CAAC,IAAwB,EAAE,IAAuB,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAC3F,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;KACxB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;KACnC,WAAW,CAAC,2EAA2E,CAAC;KACxF,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAElC,8DAA8D;AAC9D,KAAK,UAAU,QAAQ;IACrB,CAAC,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,aAAa,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,yBAAyB,EAAE;QACxD,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,yBAAyB,EAAE;QACnE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,oCAAoC,EAAE;QACzF,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,kCAAkC,EAAE;QAC9E,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,aAAa,EAAE;QACrG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,4BAA4B,EAAE;QACxE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,mCAAmC,EAAE;QACrF,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,gCAAgC,EAAE;QACxF,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;YACjB,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,gBAAgB,EAAE;YACnD,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,6BAA6B,EAAE;SAC9F,CAAC,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;IACH,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO,EAAE,OAAO,YAAY,EAAE,CAAC;QACpC,KAAK,QAAQ,EAAE,OAAO,aAAa,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACnD,KAAK,QAAQ,EAAE,OAAO,aAAa,EAAE,CAAC;QACtC,KAAK,OAAO,EAAE,OAAO,YAAY,CAAC,SAAS,CAAC,CAAC;QAC7C,KAAK,QAAQ,EAAE,OAAO,aAAa,CAAC,EAAE,CAAC,CAAC;QACxC,KAAK,OAAO,EAAE,OAAO,YAAY,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACjD,KAAK,cAAc,EAAE,OAAO,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACrE,KAAK,eAAe,EAAE,OAAO,mBAAmB,EAAE,CAAC;QACnD,KAAK,kBAAkB,EAAE,OAAO,sBAAsB,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,QAAQ,EAAE,CAAC;QACjB,OAAO;IACT,CAAC;IACD,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli/instances.d.ts

@@ -0,0 +1,19 @@
+export interface Instance {
+    name: string;
+    dir: string;
+    /** Legacy .env path — may not exist. */
+    envFile: string;
+    configFile: string;
+    port: number | null;
+}
+export declare function listInstances(): Instance[];
+export declare function getInstance(name: string): Instance | undefined;
+/** Next free port: max of existing instance ports + 1, or 3001. */
+export declare function suggestPort(instances: Instance[]): number;
+/**
+ * Create instances/<name>/{d365fo-mcp.json,data,metadata} with the port and the
+ * instance-local index paths pre-filled; the remaining settings are asked for
+ * by the caller. Throws when the instance already exists.
+ */
+export declare function createInstance(name: string, port: number): Instance;
+//# sourceMappingURL=instances.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../src/cli/instances.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,wBAAgB,aAAa,IAAI,QAAQ,EAAE,CAc1C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAE9D;AAED,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAGzD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAoBnE"}

package/dist/cli/instances.js

@@ -0,0 +1,60 @@
+/**
+ * Multi-instance helpers — TypeScript counterpart of instances/*.ps1.
+ * An instance is any directory under instances/ holding a d365fo-mcp.json
+ * (or a legacy .env from before the setup wizard wrote JSON).
+ */
+import * as fs from 'node:fs';
+import { join } from 'node:path';
+import { settingByPath } from '../config/settings.js';
+import { paths } from './context.js';
+import { openInstanceStore, readSetting, saveStore, writeSetting } from './settingsStore.js';
+const portSetting = settingByPath('server.port');
+export function listInstances() {
+    if (!fs.existsSync(paths.instancesDir))
+        return [];
+    return fs.readdirSync(paths.instancesDir, { withFileTypes: true })
+        .filter(e => e.isDirectory())
+        .map(e => {
+        const dir = join(paths.instancesDir, e.name);
+        return { name: e.name, dir, envFile: join(dir, '.env'), configFile: join(dir, 'd365fo-mcp.json') };
+    })
+        .filter(i => fs.existsSync(i.configFile) || fs.existsSync(i.envFile))
+        .map(i => {
+        const value = readSetting(openInstanceStore(i.dir), portSetting);
+        return { ...i, port: typeof value === 'number' ? value : null };
+    })
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+export function getInstance(name) {
+    return listInstances().find(i => i.name === name);
+}
+/** Next free port: max of existing instance ports + 1, or 3001. */
+export function suggestPort(instances) {
+    const used = instances.map(i => i.port).filter((p) => p !== null);
+    return used.length > 0 ? Math.max(...used) + 1 : 3001;
+}
+/**
+ * Create instances/<name>/{d365fo-mcp.json,data,metadata} with the port and the
+ * instance-local index paths pre-filled; the remaining settings are asked for
+ * by the caller. Throws when the instance already exists.
+ */
+export function createInstance(name, port) {
+    const dir = join(paths.instancesDir, name);
+    const envFile = join(dir, '.env');
+    const configFile = join(dir, 'd365fo-mcp.json');
+    if (fs.existsSync(configFile) || fs.existsSync(envFile)) {
+        throw new Error(`Instance '${name}' already exists.`);
+    }
+    fs.mkdirSync(join(dir, 'data'), { recursive: true });
+    fs.mkdirSync(join(dir, 'metadata'), { recursive: true });
+    // Relative paths resolve from the config file's directory, so an instance
+    // folder can be moved or renamed without touching its configuration.
+    const store = openInstanceStore(dir);
+    writeSetting(store, portSetting, port);
+    writeSetting(store, settingByPath('index.dbPath'), './data/xpp-metadata.db');
+    writeSetting(store, settingByPath('index.labelsDbPath'), './data/xpp-metadata-labels.db');
+    writeSetting(store, settingByPath('index.metadataPath'), './metadata');
+    saveStore(store);
+    return { name, dir, envFile, configFile, port };
+}
+//# sourceMappingURL=instances.js.map

package/dist/cli/instances.js.map

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

package/dist/cli/mcpJson.d.ts

@@ -0,0 +1,15 @@
+import type { SettingsStore } from './settingsStore.js';
+export declare const distEntryWin: () => string;
+/**
+ * A stdio server entry.
+ *
+ * D365FO_CONFIG is passed explicitly rather than left to discovery: the IDE
+ * spawns node from an arbitrary working directory, and one clone can serve
+ * several configurations. Anything else added to this `env` block still wins
+ * over the config file, which is how a per-solution override (a different
+ * D365FO_MODEL_NAME, say) is expressed.
+ */
+export declare function stdioServer(store: SettingsStore, extraEnv?: Record<string, string>): Record<string, unknown>;
+export declare function mcpJsonNote(servers: Record<string, unknown>, title?: string): void;
+export declare function placementNote(): void;
+//# sourceMappingURL=mcpJson.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcpJson.d.ts","sourceRoot":"","sources":["../../src/cli/mcpJson.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,eAAO,MAAM,YAAY,QAAO,MAA+C,CAAC;AAEhF;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM5G;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,SAAc,GAAG,IAAI,CAOvF;AAED,wBAAgB,aAAa,IAAI,IAAI,CAUpC"}

package/dist/cli/mcpJson.js

@@ -0,0 +1,44 @@
+/**
+ * The `.mcp.json` block printed at the end of setup / instance add.
+ *
+ * Shared by both commands so a single-server install and an instance produce
+ * the same shape — only the config path differs.
+ */
+import * as fs from 'node:fs';
+import { resolve } from 'node:path';
+import { repoRoot } from './context.js';
+import { p } from './ui.js';
+export const distEntryWin = () => resolve(repoRoot, 'dist', 'index.js');
+/**
+ * A stdio server entry.
+ *
+ * D365FO_CONFIG is passed explicitly rather than left to discovery: the IDE
+ * spawns node from an arbitrary working directory, and one clone can serve
+ * several configurations. Anything else added to this `env` block still wins
+ * over the config file, which is how a per-solution override (a different
+ * D365FO_MODEL_NAME, say) is expressed.
+ */
+export function stdioServer(store, extraEnv) {
+    return {
+        command: 'node',
+        args: [distEntryWin()],
+        env: { D365FO_CONFIG: store.configPath, ...extraEnv },
+    };
+}
+export function mcpJsonNote(servers, title = '.mcp.json') {
+    const json = JSON.stringify({ servers }, null, 2);
+    p.note(json, title);
+    // Also write the raw JSON to a file so it can be copied without terminal box characters.
+    const outPath = resolve(repoRoot, 'mcp-config-suggestion.json');
+    fs.writeFileSync(outPath, json + '\n', 'utf8');
+    p.log.info(`Raw JSON written to: ${outPath}`);
+}
+export function placementNote() {
+    p.note('Place the block above in:\n' +
+        '  %USERPROFILE%\\.mcp.json          — all solutions (recommended)\n' +
+        '  next to the .sln                 — that solution only\n\n' +
+        'Also copy .github\\copilot-instructions.md into a parent of your\n' +
+        'solution folders (mandatory for Copilot — see docs/SETUP.md).\n' +
+        'Restart Visual Studio after editing .mcp.json.', 'Where it goes');
+}
+//# sourceMappingURL=mcpJson.js.map

package/dist/cli/mcpJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpJson.js","sourceRoot":"","sources":["../../src/cli/mcpJson.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,CAAC,EAAE,MAAM,SAAS,CAAC;AAE5B,MAAM,CAAC,MAAM,YAAY,GAAG,GAAW,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AAEhF;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,KAAoB,EAAE,QAAiC;IACjF,OAAO;QACL,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,YAAY,EAAE,CAAC;QACtB,GAAG,EAAE,EAAE,aAAa,EAAE,KAAK,CAAC,UAAU,EAAE,GAAG,QAAQ,EAAE;KACtD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAgC,EAAE,KAAK,GAAG,WAAW;IAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpB,yFAAyF;IACzF,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,4BAA4B,CAAC,CAAC;IAChE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,CAAC,CAAC,IAAI,CACJ,6BAA6B;QAC7B,qEAAqE;QACrE,6DAA6D;QAC7D,oEAAoE;QACpE,iEAAiE;QACjE,gDAAgD,EAChD,eAAe,CAChB,CAAC;AACJ,CAAC"}

package/dist/cli/settingsPrompt.d.ts

@@ -0,0 +1,20 @@
+import type { Setting, SectionId } from '../config/settings.js';
+import { type SettingsStore } from './settingsStore.js';
+/**
+ * Ask for one setting and persist the answer.
+ * Returns the value that ended up in the store (or undefined when skipped).
+ */
+export declare function askSetting(store: SettingsStore, setting: Setting, opts?: {
+    required?: boolean;
+    initial?: string;
+}): Promise<unknown>;
+/** Ask a whole list of settings in order. */
+export declare function askSettings(store: SettingsStore, settings: Setting[]): Promise<void>;
+/**
+ * Optional deep-dive: pick sections, then walk their advanced settings.
+ * Everything here has a working default, so skipping is always safe.
+ */
+export declare function askAdvanced(store: SettingsStore, sections: SectionId[]): Promise<void>;
+/** Ask for the secrets of the given sections, skipping any already set. */
+export declare function askSecrets(store: SettingsStore, sections: SectionId[]): Promise<void>;
+//# sourceMappingURL=settingsPrompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settingsPrompt.d.ts","sourceRoot":"","sources":["../../src/cli/settingsPrompt.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,EAAgE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAyBtH;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,OAAO,CAAC,CA2ElB;AAED,6CAA6C;AAC7C,wBAAsB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1F;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB5F;AAED,2EAA2E;AAC3E,wBAAsB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAM3F"}