d365fo-mcp 1.0.0

package/dist/tools/renameLabel.js

@@ -0,0 +1,377 @@
+/**
+ * Rename Label Tool
+ *
+ * Renames a label ID across ALL places where it appears:
+ *  1. Every .label.txt file in the model (the label entry itself)
+ *  2. Every X++ source file (.xpp) referencing @LabelFileId:OldId
+ *  3. Every XML metadata file referencing @LabelFileId:OldId in properties
+ *     such as <Label>, <HelpText>, <Caption>, <Description>, <Tooltip>, etc.
+ *  4. Updates the MCP SQLite label index
+ *
+ * The search covers only the model's own package directory by default, but can be
+ * extended to additional directories via the `searchPaths` parameter.
+ */
+import { z } from 'zod';
+import { promises as fs } from 'fs';
+import * as path from 'path';
+import { getConfigManager } from '../utils/configManager.js';
+import { PackageResolver } from '../utils/packageResolver.js';
+import { detectEol } from '../utils/eolUtils.js';
+import { isExtensionLabelFile } from '../metadata/labelParser.js';
+const UTF8_BOM = '\uFEFF';
+const RenameLabelArgsSchema = z.object({
+    oldLabelId: z
+        .string()
+        .describe('Current label ID to rename, e.g. MyOldField'),
+    newLabelId: z
+        .string()
+        .regex(/^[A-Za-z][A-Za-z0-9_]*$/, 'New label ID must be alphanumeric (no spaces)')
+        .describe('New label ID, e.g. MyRenamedField'),
+    labelFileId: z
+        .string()
+        .describe('Label file ID that owns the label (e.g. ContosoExt, ContosoCore)'),
+    model: z
+        .string()
+        .describe('Model name that owns the label file (e.g. ContosoExt)'),
+    packageName: z
+        .string()
+        .optional()
+        .describe('Package name for the model. Auto-resolved if omitted.'),
+    packagePath: z
+        .string()
+        .optional()
+        .describe('Root PackagesLocalDirectory path. Auto-detected if omitted.'),
+    searchPaths: z
+        .array(z.string())
+        .optional()
+        .describe('Additional absolute directory paths to scan for X++ / XML references. ' +
+        'The model package directory is always included automatically.'),
+    allowExtensionLabelFile: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Escape hatch to allow operating on a label file EXTENSION (a labelFileId ' +
+        'carrying the "_Extension" marker). Off by default: labels belong in the ' +
+        "model's own ORIGINAL label file, not in an extension."),
+    dryRun: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('If true, report all files that would be changed without writing anything. ' +
+        'Use this first to preview the impact.'),
+    updateIndex: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe('Update the MCP label index after renaming (default: true)'),
+});
+/** Strip UTF-8 BOM from string */
+function stripBom(s) {
+    return s.startsWith(UTF8_BOM) ? s.slice(1) : s;
+}
+/** Escape string for use in a regex */
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Rename a label entry inside a single .label.txt file.
+ * Returns the new file content, or null if the label was not found.
+ */
+function renameLabelInTxt(content, oldId, newId) {
+    // Preserve the original line-ending style — D365FO .label.txt files are CRLF
+    // in TFVC/Git, and silently rewriting them as LF makes every line look modified.
+    const eol = detectEol(content);
+    const lines = stripBom(content).replace(/\r\n/g, '\n').replace(/\r/g, '\n').split('\n');
+    let found = false;
+    const out = [];
+    for (const line of lines) {
+        const eqIdx = line.indexOf('=');
+        if (eqIdx > 0) {
+            const id = line.substring(0, eqIdx).trim();
+            if (id === oldId) {
+                found = true;
+                out.push(newId + line.substring(eqIdx)); // replace only the ID part
+                continue;
+            }
+        }
+        out.push(line);
+    }
+    if (!found)
+        return null;
+    return UTF8_BOM + out.join(eol);
+}
+/**
+ * Replace all occurrences of @LabelFileId:OldId with @LabelFileId:NewId in arbitrary text.
+ * Handles both quoted and unquoted occurrences (X++ literalStr and XML properties).
+ * Returns { newContent, count } — count = 0 means no replacements.
+ */
+function replaceReferences(content, labelFileId, oldId, newId) {
+    const pattern = new RegExp(`@${escapeRegex(labelFileId)}:${escapeRegex(oldId)}(?=[^A-Za-z0-9_]|$)`, 'g');
+    let count = 0;
+    const newContent = content.replace(pattern, () => {
+        count++;
+        return `@${labelFileId}:${newId}`;
+    });
+    return { newContent, count };
+}
+/** Recursively collect all files with given extensions under a directory */
+async function collectFiles(dir, extensions) {
+    const results = [];
+    let entries;
+    try {
+        entries = await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return results;
+    }
+    for (const entry of entries) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...(await collectFiles(full, extensions)));
+        }
+        else if (extensions.some(ext => entry.name.endsWith(ext))) {
+            results.push(full);
+        }
+    }
+    return results;
+}
+export async function renameLabelTool(request, context) {
+    try {
+        const args = RenameLabelArgsSchema.parse(request.params.arguments);
+        const { oldLabelId, newLabelId, labelFileId, model, dryRun, updateIndex } = args;
+        const { symbolIndex } = context;
+        if (oldLabelId === newLabelId) {
+            return {
+                content: [{ type: 'text', text: `⚠️ Old and new label IDs are identical ("${oldLabelId}"). Nothing to do.` }],
+                isError: true,
+            };
+        }
+        // Labels belong in the model's own original label file, not an extension; opt out with allowExtensionLabelFile=true.
+        if (isExtensionLabelFile(labelFileId) && !args.allowExtensionLabelFile) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `❌ "${labelFileId}" is a label file EXTENSION, not an original label file.\n\n` +
+                            `Labels belong in the model's own (original) label file — extensions (…_Extension…) ` +
+                            `only extend a base label file owned by another model.\n\n` +
+                            `➡️  List the model's label files with labels(action="info", model="${model}") ` +
+                            `and re-run with the original labelFileId.\n\n` +
+                            `If you really must operate on this extension, pass allowExtensionLabelFile=true.`,
+                    }],
+                isError: true,
+            };
+        }
+        // Resolve package path
+        const configManager = getConfigManager();
+        const envType = await configManager.getDevEnvironmentType();
+        let resolvedPackagePath;
+        let resolvedPackageName;
+        if (args.packageName) {
+            resolvedPackageName = args.packageName;
+            if (envType === 'ude') {
+                const customPath = await configManager.getCustomPackagesPath();
+                resolvedPackagePath = args.packagePath || customPath || configManager.getPackagePath() || 'K:\\AosService\\PackagesLocalDirectory';
+            }
+            else {
+                resolvedPackagePath = args.packagePath || configManager.getPackagePath() || 'K:\\AosService\\PackagesLocalDirectory';
+            }
+        }
+        else if (envType === 'ude') {
+            const customPath = await configManager.getCustomPackagesPath();
+            const msPath = await configManager.getMicrosoftPackagesPath();
+            const roots = [customPath, msPath].filter(Boolean);
+            resolvedPackagePath = args.packagePath || customPath || 'K:\\AosService\\PackagesLocalDirectory';
+            const resolver = new PackageResolver(roots);
+            const resolved = await resolver.resolve(model);
+            resolvedPackageName = resolved?.packageName || model;
+            if (resolved?.rootPath)
+                resolvedPackagePath = resolved.rootPath;
+        }
+        else {
+            resolvedPackagePath = args.packagePath || configManager.getPackagePath() || 'K:\\AosService\\PackagesLocalDirectory';
+            resolvedPackageName = model;
+        }
+        const modelDir = path.join(resolvedPackagePath, resolvedPackageName, model);
+        const labelResourcesDir = path.join(modelDir, 'AxLabelFile', 'LabelResources');
+        // Check old label exists in at least one .label.txt
+        let existingLanguages = [];
+        try {
+            existingLanguages = await fs.readdir(labelResourcesDir);
+        }
+        catch {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `❌ AxLabelFile LabelResources directory not found:\n  ${labelResourcesDir}\n\nCheck that labelFileId, model and packagePath are correct.`,
+                    }],
+                isError: true,
+            };
+        }
+        // Verify old label exists
+        let foundInAny = false;
+        for (const lang of existingLanguages) {
+            const txtPath = path.join(labelResourcesDir, lang, `${labelFileId}.${lang}.label.txt`);
+            try {
+                const content = await fs.readFile(txtPath, 'utf-8');
+                if (content.includes(`\n${oldLabelId}=`) || content.includes(`${UTF8_BOM}${oldLabelId}=`)) {
+                    foundInAny = true;
+                    break;
+                }
+            }
+            catch { /* skip missing files */ }
+        }
+        if (!foundInAny) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `❌ Label "${oldLabelId}" not found in any .label.txt file of ` +
+                            `label file "${labelFileId}" in model "${model}".\n\n` +
+                            `Use labels(action="search") or labels(action="info") to verify the label ID and label file.`,
+                    }],
+                isError: true,
+            };
+        }
+        // Check new label ID doesn't already exist
+        for (const lang of existingLanguages) {
+            const txtPath = path.join(labelResourcesDir, lang, `${labelFileId}.${lang}.label.txt`);
+            try {
+                const content = await fs.readFile(txtPath, 'utf-8');
+                if (content.includes(`\n${newLabelId}=`) || content.includes(`${UTF8_BOM}${newLabelId}=`)) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: `❌ Target label ID "${newLabelId}" already exists in ` +
+                                    `"${labelFileId}.${lang}.label.txt". Choose a different new label ID.`,
+                            }],
+                        isError: true,
+                    };
+                }
+            }
+            catch { /* skip */ }
+        }
+        // Collect all files to scan for references
+        const scanRoots = [modelDir, ...(args.searchPaths ?? [])];
+        const allXppFiles = (await Promise.all(scanRoots.map(d => collectFiles(d, ['.xpp'])))).flat();
+        const allXmlFiles = (await Promise.all(scanRoots.map(d => collectFiles(d, ['.xml'])))).flat();
+        const labelTxtChanges = [];
+        const xppChanges = [];
+        const xmlChanges = [];
+        for (const lang of existingLanguages) {
+            const txtPath = path.join(labelResourcesDir, lang, `${labelFileId}.${lang}.label.txt`);
+            let content;
+            try {
+                content = await fs.readFile(txtPath, 'utf-8');
+            }
+            catch {
+                continue;
+            }
+            const newContent = renameLabelInTxt(content, oldLabelId, newLabelId);
+            if (newContent === null)
+                continue;
+            labelTxtChanges.push({ file: txtPath, replacements: 1 });
+            if (!dryRun) {
+                await fs.writeFile(txtPath, newContent, 'utf-8');
+            }
+        }
+        // Phase: replace @LabelFileId:OldId references in .xpp files
+        for (const xppFile of allXppFiles) {
+            let content;
+            try {
+                content = await fs.readFile(xppFile, 'utf-8');
+            }
+            catch {
+                continue;
+            }
+            const { newContent, count } = replaceReferences(content, labelFileId, oldLabelId, newLabelId);
+            if (count === 0)
+                continue;
+            xppChanges.push({ file: xppFile, replacements: count });
+            if (!dryRun) {
+                await fs.writeFile(xppFile, newContent, 'utf-8');
+            }
+        }
+        // Phase: replace references in XML metadata files
+        for (const xmlFile of allXmlFiles) {
+            // AxLabelFile XML descriptors don't contain label refs
+            if (xmlFile.includes('AxLabelFile'))
+                continue;
+            let content;
+            try {
+                content = await fs.readFile(xmlFile, 'utf-8');
+            }
+            catch {
+                continue;
+            }
+            const { newContent, count } = replaceReferences(content, labelFileId, oldLabelId, newLabelId);
+            if (count === 0)
+                continue;
+            xmlChanges.push({ file: xmlFile, replacements: count });
+            if (!dryRun) {
+                await fs.writeFile(xmlFile, newContent, 'utf-8');
+            }
+        }
+        // Update SQLite index
+        if (!dryRun && updateIndex && labelTxtChanges.length > 0) {
+            symbolIndex.renameLabelInIndex(oldLabelId, newLabelId, labelFileId, model);
+        }
+        // Build result summary
+        const totalFiles = labelTxtChanges.length + xppChanges.length + xmlChanges.length;
+        const totalReplacements = labelTxtChanges.reduce((s, c) => s + c.replacements, 0) +
+            xppChanges.reduce((s, c) => s + c.replacements, 0) +
+            xmlChanges.reduce((s, c) => s + c.replacements, 0);
+        const oldRef = `@${labelFileId}:${oldLabelId}`;
+        const newRef = `@${labelFileId}:${newLabelId}`;
+        const lines = [];
+        if (dryRun) {
+            lines.push(`🔍 DRY RUN — no files were modified`);
+            lines.push(`   "${oldRef}" → "${newRef}"`);
+        }
+        else {
+            lines.push(`✅ Label renamed: "${oldRef}" → "${newRef}"`);
+        }
+        lines.push('');
+        lines.push(`📊 Summary: ${totalFiles} file(s) ${dryRun ? 'would be' : ''} changed, ${totalReplacements} replacement(s)`);
+        lines.push('');
+        if (labelTxtChanges.length > 0) {
+            lines.push(`🏷️  .label.txt files (${labelTxtChanges.length}):`);
+            for (const c of labelTxtChanges) {
+                const lang = path.basename(path.dirname(c.file));
+                lines.push(`   ${dryRun ? '○' : '✔'} [${lang}] ${path.basename(c.file)}`);
+            }
+            lines.push('');
+        }
+        if (xppChanges.length > 0) {
+            lines.push(`📄 X++ source files (${xppChanges.length} file(s), ${xppChanges.reduce((s, c) => s + c.replacements, 0)} occurrence(s)):`);
+            for (const c of xppChanges) {
+                lines.push(`   ${dryRun ? '○' : '✔'} ${c.file}  (${c.replacements}×)`);
+            }
+            lines.push('');
+        }
+        if (xmlChanges.length > 0) {
+            lines.push(`📋 XML metadata files (${xmlChanges.length} file(s), ${xmlChanges.reduce((s, c) => s + c.replacements, 0)} occurrence(s)):`);
+            for (const c of xmlChanges) {
+                lines.push(`   ${dryRun ? '○' : '✔'} ${c.file}  (${c.replacements}×)`);
+            }
+            lines.push('');
+        }
+        if (xppChanges.length === 0 && xmlChanges.length === 0) {
+            lines.push(`ℹ️  No X++ or XML references to "${oldRef}" found in scanned directories.`);
+            lines.push(`   If the label is used in code, add its directory to the searchPaths parameter.`);
+            lines.push('');
+        }
+        if (!dryRun) {
+            lines.push('💡 Rebuild your D365FO project to verify no compile errors.');
+        }
+        if (dryRun && totalFiles > 0) {
+            lines.push(`💡 Remove dryRun=true to apply the rename.`);
+        }
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: `Error renaming label: ${err.message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=renameLabel.js.map

package/dist/tools/renameLabel.js.map

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

package/dist/tools/repairFormControls.d.ts

@@ -0,0 +1,21 @@
+/**
+ * object_patterns(domain="form", action="repair") — auto-fill the missing
+ * required top-level controls of an existing form from its declared pattern.
+ *
+ * The "fill an existing form" counterpart to TRUDUtils' Form Template Control
+ * Builder. Loads a form (xml / formName / filePath), reads its <Pattern>,
+ * generates the absent required controls from the catalog and splices them in
+ * (existing controls preserved verbatim — see formControlRepair). Re-validates
+ * and returns the repaired XML; it does NOT write — hand the XML to
+ * d365fo_file(action="create", overwrite=true) after reviewing it.
+ */
+import type { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';
+import type { XppServerContext } from '../types/context.js';
+export declare function repairFormControlsTool(request: CallToolRequest, context: XppServerContext): Promise<{
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError?: boolean | undefined;
+}>;
+//# sourceMappingURL=repairFormControls.d.ts.map

package/dist/tools/repairFormControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repairFormControls.d.ts","sourceRoot":"","sources":["../../src/tools/repairFormControls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA4B5D,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,gBAAgB;;cAfE,MAAM;;;;GAoJlC"}

package/dist/tools/repairFormControls.js

@@ -0,0 +1,151 @@
+/**
+ * object_patterns(domain="form", action="repair") — auto-fill the missing
+ * required top-level controls of an existing form from its declared pattern.
+ *
+ * The "fill an existing form" counterpart to TRUDUtils' Form Template Control
+ * Builder. Loads a form (xml / formName / filePath), reads its <Pattern>,
+ * generates the absent required controls from the catalog and splices them in
+ * (existing controls preserved verbatim — see formControlRepair). Re-validates
+ * and returns the repaired XML; it does NOT write — hand the XML to
+ * d365fo_file(action="create", overwrite=true) after reviewing it.
+ */
+import * as fs from 'fs/promises';
+import { z } from 'zod';
+import { Parser } from 'xml2js';
+import { walkFormDesign } from '../metadata/formPatternMiner.js';
+import { resolvePatternExact } from '../knowledge/formPatterns/index.js';
+import { validateFormPatternXml } from '../validation/formPatternValidator.js';
+import { repairFormXml } from '../utils/formControlRepair.js';
+import { lookupSymbolNocase } from '../utils/symbolLookup.js';
+const RepairArgsSchema = z.object({
+    xml: z.string().optional().describe('Complete AxForm XML to repair. Provide this OR formName/filePath.'),
+    formName: z.string().optional().describe('Name of an indexed form — loaded from the metadata store.'),
+    filePath: z.string().optional().describe('Explicit path to an AxForm XML file.'),
+});
+function text(s, isError = false) {
+    return { content: [{ type: 'text', text: s }], ...(isError ? { isError: true } : {}) };
+}
+/** First datasource (name + table) declared on the form, for grid generation. */
+function firstDataSource(xml) {
+    const block = xml.match(/<AxFormDataSource[^>]*>([\s\S]*?)<\/AxFormDataSource>/)?.[1];
+    if (!block)
+        return {};
+    return {
+        name: block.match(/<Name>([^<]+)<\/Name>/)?.[1]?.trim(),
+        table: block.match(/<Table>([^<]+)<\/Table>/)?.[1]?.trim(),
+    };
+}
+export async function repairFormControlsTool(request, context) {
+    const parsed = RepairArgsSchema.safeParse(request.params?.arguments ?? {});
+    if (!parsed.success) {
+        return text(`❌ Invalid parameters: ${parsed.error.message}`, true);
+    }
+    const { xml, formName, filePath } = parsed.data;
+    // Load the form XML (same precedence as validate)
+    let formXml = xml;
+    let source = 'provided XML';
+    try {
+        if (!formXml && filePath) {
+            formXml = await fs.readFile(filePath, 'utf-8');
+            source = filePath;
+        }
+        else if (!formXml && formName) {
+            const db = context.symbolIndex?.getReadDb?.();
+            const row = db
+                ?.prepare(`SELECT file_path FROM symbols WHERE type = 'form' AND name = ? LIMIT 1`)
+                ?.get(formName);
+            if (!row?.file_path) {
+                return text(`❌ Form "${formName}" not found in the symbol index. Pass filePath or xml directly.`, true);
+            }
+            formXml = await fs.readFile(row.file_path, 'utf-8');
+            source = `${formName} (${row.file_path})`;
+        }
+    }
+    catch (e) {
+        return text(`❌ Could not read form XML: ${e instanceof Error ? e.message : String(e)}`, true);
+    }
+    if (!formXml) {
+        return text('❌ Provide one of: xml, formName, or filePath.', true);
+    }
+    // Resolve the declared pattern
+    let design;
+    try {
+        const xmlParser = new Parser({ explicitArray: false, mergeAttrs: true, trim: true });
+        const tree = await xmlParser.parseStringPromise(formXml);
+        if (!tree?.AxForm?.Design) {
+            return text('❌ Not an AxForm document, or it has no <Design>.', true);
+        }
+        design = walkFormDesign(tree.AxForm.Design);
+    }
+    catch (e) {
+        return text(`❌ XML parse error: ${e instanceof Error ? e.message.split('\n')[0] : 'invalid XML'}`, true);
+    }
+    if (!design.pattern) {
+        return text(`ℹ️ ${source} declares no <Pattern> on Design — nothing to repair against.\n\n` +
+            `Assign a pattern first (object_patterns(domain="form", action="analyze") to pick one), then repair.`);
+    }
+    const spec = resolvePatternExact(design.pattern);
+    if (!spec) {
+        return text(`❌ Form declares an unknown pattern "${design.pattern}" — cannot repair. ` +
+            `Fix the <Pattern> value first (object_patterns(domain="form", action="validate")).`, true);
+    }
+    // Build generation options from the form's own datasource
+    const formNameInXml = formXml.match(/<AxForm[^>]*>[\s\S]*?<Name>([^<]+)<\/Name>/)?.[1]?.trim();
+    const ds = firstDataSource(formXml);
+    let gridFields;
+    if (ds.table) {
+        try {
+            const db = context.symbolIndex.getReadDb();
+            // Canonicalize first — `parent_name = ? COLLATE NOCASE` cannot use
+            // idx_parent_type_name and scans all 360k field rows (180 s cold).
+            const canonical = lookupSymbolNocase(db, ds.table)?.name ?? ds.table;
+            const rows = db
+                .prepare(`SELECT name FROM symbols WHERE type = 'field' AND parent_name = ? ORDER BY name`)
+                .all(canonical);
+            gridFields = rows
+                .map((r) => r.name)
+                .filter((n) => !['RecId', 'RecVersion', 'DataAreaId', 'Partition'].includes(n))
+                .slice(0, 8);
+        }
+        catch {
+            /* index unavailable — grids will be emitted empty */
+        }
+    }
+    const opt = {
+        formName: formNameInXml ?? formName ?? 'Form',
+        dsName: ds.name,
+        dsTable: ds.table,
+        gridFields,
+    };
+    // Before / after validation around the splice
+    const before = await validateFormPatternXml(formXml);
+    const beforeErrors = before.violations.filter((v) => v.severity === 'error').length;
+    const result = repairFormXml(formXml, spec, opt);
+    if (!result.changed) {
+        const unfixNote = result.unfixable.length > 0
+            ? `\n\nCould not auto-add:\n` + result.unfixable.map((u) => `  • ${u.id} — ${u.reason}`).join('\n')
+            : '';
+        return text(`✅ ${source} — no missing required top-level controls for pattern **${spec.xmlName}**. Nothing to repair.` +
+            (beforeErrors > 0
+                ? `\n\n⚠️ ${beforeErrors} pattern error(s) remain, but they are deeper than the top level (sub-pattern/order/child issues). Use action="validate" to see them.`
+                : '') +
+            unfixNote);
+    }
+    const after = await validateFormPatternXml(result.xml);
+    const afterErrors = after.violations.filter((v) => v.severity === 'error').length;
+    const lines = [
+        `🛠️ Repaired **${spec.xmlName}** form (${source})`,
+        ``,
+        `Added ${result.added.length} required control(s):`,
+        ...result.added.map((a) => `  • ${a.type} ("${a.id}")`),
+        ``,
+        `Pattern errors: ${beforeErrors} → ${afterErrors}.`,
+    ];
+    if (result.unfixable.length > 0) {
+        lines.push('', 'Still needs manual attention:', ...result.unfixable.map((u) => `  • ${u.id} — ${u.reason}`));
+    }
+    lines.push('', `**Next step:** review the XML, then write it with ` +
+        `\`d365fo_file(action="create", objectType="form", objectName="${opt.formName}", overwrite=true, xmlContent="…")\`.`, '', '```xml', result.xml, '```');
+    return text(lines.join('\n'), afterErrors > beforeErrors);
+}
+//# sourceMappingURL=repairFormControls.js.map

package/dist/tools/repairFormControls.js.map

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

package/dist/tools/reportInfo.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Get Report Info Tool
+ * Reads an AxReport and returns structured information:
+ * datasets (fields, query), designs (RDL summary or full RDL), data methods.
+ *
+ * PRIMARY: C# bridge (IMetadataProvider) — 100% reliable, always available on VM.
+ * FALLBACK: explicit XML file path for newly-created reports not yet in bridge.
+ *
+ * Eliminates the need for Copilot to run PowerShell Get-Content on report XML files.
+ */
+import type { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';
+import type { XppServerContext } from '../types/context.js';
+export declare function getReportInfoTool(request: CallToolRequest, context: XppServerContext): Promise<any>;
+//# sourceMappingURL=reportInfo.d.ts.map

package/dist/tools/reportInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportInfo.d.ts","sourceRoot":"","sources":["../../src/tools/reportInfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAoD5D,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB,gBAyF1F"}