d365fo-mcp 1.0.0

package/dist/tools/reportInfo.js

@@ -0,0 +1,302 @@
+/**
+ * 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 { z } from 'zod';
+import { promises as fs } from 'fs';
+import { parseStringPromise } from 'xml2js';
+import { tryBridgeReport } from '../bridge/bridgeAdapter.js';
+import { assertWritePathAllowed } from '../utils/pathContainment.js';
+const GetReportInfoArgsSchema = z.object({
+    reportName: z.string().describe('Name of the AxReport object (without .xml extension)'),
+    modelName: z.string().optional().describe('Model name — auto-detected from .mcp.json if not provided'),
+    filePath: z.string().optional().describe('Absolute path to the AxReport XML file on disk. ' +
+        'Use this for newly-created reports not yet in bridge metadata.'),
+    includeFields: z.boolean().optional().default(true).describe('Include AxReportDataSetField entries per dataset'),
+    includeRdl: z.boolean().optional().default(false).describe('Include full embedded RDL content inside <Text><![CDATA[…]]> — can be large, default false'),
+});
+export async function getReportInfoTool(request, context) {
+    try {
+        const args = GetReportInfoArgsSchema.parse(request.params.arguments);
+        const { reportName, filePath: explicitFilePath, includeFields, includeRdl } = args;
+        console.error(`[reportInfo] Looking up report "${reportName}"...`);
+        // 1. C# bridge (IMetadataProvider — live D365FO metadata, always available)
+        const bridgeResult = await tryBridgeReport(context.bridge, reportName);
+        if (bridgeResult)
+            return bridgeResult;
+        // 2. Explicit file path fallback for newly-created reports
+        if (explicitFilePath) {
+            // Must fall within a configured D365FO package root before reading any file content.
+            const containment = await assertWritePathAllowed(explicitFilePath);
+            if (!containment.ok) {
+                return {
+                    content: [{ type: 'text', text: `❌ get_object_info(report): filePath rejected — ${containment.reason}` }],
+                    isError: true,
+                };
+            }
+            let xmlContent = null;
+            try {
+                const raw = await fs.readFile(explicitFilePath, 'utf-8');
+                const trimmed = raw.trimStart();
+                if (trimmed.startsWith('{')) {
+                    const meta = JSON.parse(raw);
+                    if (meta.sourcePath) {
+                        const srcContainment = await assertWritePathAllowed(meta.sourcePath);
+                        if (!srcContainment.ok) {
+                            return {
+                                content: [{ type: 'text', text: `❌ get_object_info(report): sourcePath rejected — ${srcContainment.reason}` }],
+                                isError: true,
+                            };
+                        }
+                        try {
+                            xmlContent = await fs.readFile(meta.sourcePath, 'utf-8');
+                        }
+                        catch { /* not accessible */ }
+                    }
+                }
+                else {
+                    xmlContent = raw;
+                }
+            }
+            catch { /* file not readable */ }
+            if (!xmlContent) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `❌ File at \`${explicitFilePath}\` could not be read.`,
+                        }],
+                    isError: true,
+                };
+            }
+            const xmlObj = await parseStringPromise(xmlContent, { explicitArray: true, mergeAttrs: false, trim: true });
+            const axReport = xmlObj?.AxReport;
+            if (!axReport) {
+                return { content: [{ type: 'text', text: `❌ File does not contain a valid <AxReport> root element.` }], isError: true };
+            }
+            const info = {
+                name: first(axReport.Name) ?? reportName,
+                model: 'Unknown',
+                filePath: explicitFilePath,
+                hasDataMethods: !!axReport.DataMethods && axReport.DataMethods[0] !== '',
+                embeddedImageCount: countItems(axReport.EmbeddedImages?.[0], 'AxReportEmbeddedImage'),
+                dataSets: extractDataSets(axReport, includeFields ?? true),
+                designs: extractDesigns(axReport, includeRdl ?? false),
+            };
+            return formatOutput(info, includeFields ?? true, includeRdl ?? false);
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: `❌ Report "${reportName}" not found via bridge.\n\n` +
+                        `If this is a newly-created report, pass the explicit \`filePath\` parameter:\n` +
+                        `  get_object_info(objectType="report", name="${reportName}", options={filePath:"<absolute path to .xml>"})`,
+                }],
+            isError: true,
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `❌ Error reading report info: ${error instanceof Error ? error.message : String(error)}`,
+                }],
+            isError: true,
+        };
+    }
+}
+function first(arr) {
+    if (!arr)
+        return undefined;
+    if (Array.isArray(arr))
+        return arr[0] ?? undefined;
+    return arr ?? undefined;
+}
+function countItems(node, key) {
+    if (!node)
+        return 0;
+    return Array.isArray(node[key]) ? node[key].length : 0;
+}
+function extractDataSets(axReport, includeFields) {
+    const result = [];
+    const dataSetsNode = axReport.DataSets?.[0];
+    if (!dataSetsNode)
+        return result;
+    // DataSets node may use 'AxReportDataSet' (correct) or 'AxReportDataSource' (legacy/wrong)
+    const dsArray = dataSetsNode.AxReportDataSet ?? dataSetsNode.AxReportDataSource ?? [];
+    for (const ds of dsArray) {
+        const fields = [];
+        if (includeFields) {
+            const fieldsNode = ds.Fields?.[0];
+            if (fieldsNode && typeof fieldsNode === 'object') {
+                const fieldArray = fieldsNode.AxReportDataSetField ?? [];
+                for (const f of fieldArray) {
+                    fields.push({
+                        name: first(f.Name) ?? '',
+                        alias: first(f.Alias) ?? '',
+                        dataType: first(f.DataType) ?? undefined,
+                        caption: first(f.Caption) ?? undefined,
+                    });
+                }
+            }
+        }
+        const fgNode = ds.FieldGroups?.[0];
+        const fieldGroups = [];
+        if (fgNode && typeof fgNode === 'object') {
+            const fgArray = fgNode.AxReportDataSetFieldGroup ?? [];
+            for (const fg of fgArray) {
+                fieldGroups.push(first(fg.Name) ?? '');
+            }
+        }
+        result.push({
+            name: first(ds.Name) ?? 'Unknown',
+            dataSourceType: first(ds.DataSourceType) ?? '',
+            query: first(ds.Query) ?? '',
+            fields,
+            fieldGroups,
+        });
+    }
+    return result;
+}
+function extractDesigns(axReport, includeRdl) {
+    const result = [];
+    const designsNode = axReport.Designs?.[0];
+    if (!designsNode)
+        return result;
+    const designArray = designsNode.AxReportDesign ?? [];
+    for (const d of designArray) {
+        const rawText = first(d.Text); // CDATA string or undefined
+        const hasRdl = !!rawText && rawText.trim().length > 0;
+        let rdlSummary;
+        if (hasRdl && !includeRdl) {
+            rdlSummary = summarizeRdl(rawText);
+        }
+        result.push({
+            name: first(d.Name) ?? 'Unknown',
+            caption: first(d.Caption) ?? undefined,
+            dataSet: first(d.DataSet) ?? undefined,
+            style: first(d.Style) ?? undefined,
+            hasRdl,
+            rdlContent: includeRdl && hasRdl ? rawText : undefined,
+            rdlSummary: !includeRdl ? rdlSummary : undefined,
+        });
+    }
+    return result;
+}
+/**
+ * Parse the RDL XML string and return a bullet-point summary of top-level elements
+ * (DataSources, DataSets, ReportParameters, Page, PageHeader, PageFooter, Body).
+ * Never throws — falls back to char count only.
+ */
+function summarizeRdl(rdl) {
+    const lines = [`Length: ${rdl.length.toLocaleString()} chars`];
+    try {
+        // Regex-based extraction avoids a full parse of potentially huge XML
+        const topElements = [
+            'DataSources', 'DataSets', 'ReportParameters', 'Page',
+            'PageHeader', 'PageFooter', 'Body',
+        ];
+        for (const el of topElements) {
+            const present = rdl.includes(`<${el}>`);
+            if (present)
+                lines.push(`  • <${el}> present`);
+        }
+        const dsCount = (rdl.match(/<DataSet\b/g) ?? []).length;
+        if (dsCount > 0)
+            lines.push(`  • ${dsCount} DataSet(s) in RDL`);
+        const rp = (rdl.match(/<ReportParameter\b/g) ?? []).length;
+        if (rp > 0)
+            lines.push(`  • ${rp} ReportParameter(s)`);
+        const tablix = (rdl.match(/<Tablix\b/g) ?? []).length;
+        const chart = (rdl.match(/<Chart\b/g) ?? []).length;
+        if (tablix > 0)
+            lines.push(`  • ${tablix} Tablix region(s)`);
+        if (chart > 0)
+            lines.push(`  • ${chart} Chart(s)`);
+        const groups = (rdl.match(/<Group\b/g) ?? []).length;
+        if (groups > 0)
+            lines.push(`  • ${groups} Group expression(s)`);
+        const langMatch = rdl.match(/<Language>(.*?)<\/Language>/);
+        if (langMatch)
+            lines.push(`  • Language: ${langMatch[1]}`);
+    }
+    catch {
+        // ignore parse errors
+    }
+    return lines.join('\n');
+}
+function formatOutput(info, includeFields, includeRdl) {
+    const lines = [];
+    lines.push(`# AxReport: \`${info.name}\``);
+    lines.push('');
+    lines.push(`**Model:** ${info.model}`);
+    lines.push(`**File:** \`${info.filePath}\``);
+    lines.push(`**DataMethods:** ${info.hasDataMethods ? '✅ present' : '— none'}`);
+    lines.push(`**EmbeddedImages:** ${info.embeddedImageCount}`);
+    lines.push('');
+    // DataSets
+    lines.push(`## 📊 DataSets (${info.dataSets.length})`);
+    lines.push('');
+    for (const ds of info.dataSets) {
+        lines.push(`### DataSet: \`${ds.name}\``);
+        lines.push(`- **DataSourceType:** ${ds.dataSourceType}`);
+        lines.push(`- **Query:** \`${ds.query}\``);
+        if (ds.fieldGroups.length > 0) {
+            lines.push(`- **FieldGroups:** ${ds.fieldGroups.join(', ')}`);
+        }
+        if (includeFields) {
+            if (ds.fields.length === 0) {
+                lines.push('- **Fields:** *(none — empty `<Fields />` element)*');
+            }
+            else {
+                lines.push(`- **Fields (${ds.fields.length}):**`);
+                lines.push('');
+                lines.push('  | Name | Alias | DataType | Caption |');
+                lines.push('  |------|-------|----------|---------|');
+                for (const f of ds.fields) {
+                    lines.push(`  | \`${f.name}\` | ${f.alias} | ${f.dataType ?? '—'} | ${f.caption ?? '—'} |`);
+                }
+            }
+        }
+        lines.push('');
+    }
+    // Designs
+    lines.push(`## 🎨 Designs (${info.designs.length})`);
+    lines.push('');
+    for (const d of info.designs) {
+        lines.push(`### Design: \`${d.name}\``);
+        if (d.caption)
+            lines.push(`- **Caption:** ${d.caption}`);
+        if (d.dataSet)
+            lines.push(`- **DataSet:** \`${d.dataSet}\``);
+        if (d.style)
+            lines.push(`- **Style:** ${d.style}`);
+        lines.push(`- **Embedded RDL:** ${d.hasRdl ? '✅ present' : '❌ empty'}`);
+        if (d.hasRdl && !includeRdl && d.rdlSummary) {
+            lines.push(`- **RDL summary:**`);
+            lines.push('');
+            lines.push('  ```');
+            lines.push(d.rdlSummary.split('\n').map(l => `  ${l}`).join('\n'));
+            lines.push('  ```');
+            lines.push('');
+            lines.push('  > Use `includeRdl: true` to retrieve the full RDL content.');
+        }
+        if (includeRdl && d.rdlContent) {
+            lines.push('');
+            lines.push('<details><summary>Full RDL</summary>');
+            lines.push('');
+            lines.push('```xml');
+            lines.push(d.rdlContent);
+            lines.push('```');
+            lines.push('</details>');
+        }
+        lines.push('');
+    }
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+//# sourceMappingURL=reportInfo.js.map

package/dist/tools/reportInfo.js.map

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

package/dist/tools/resolveReferences.d.ts

@@ -0,0 +1,89 @@
+/**
+ * resolve_references — semantic reference resolver for generated X++ code.
+ *
+ * Anti-hallucination gate: extracts every external identifier from an X++
+ * snippet and verifies it against the indexed codebase (symbols DB, labels DB,
+ * extension_metadata, menu_item_targets). Nothing is assumed from training
+ * data — a reference is either proven by the index or reported.
+ *
+ * Verified reference kinds:
+ *   - Intrinsic functions: classStr/tableStr/fieldStr/enumStr/extendedTypeStr/
+ *     formStr/queryStr/methodStr/menuItem*Str(...) — args are compile-time
+ *     checked by the real X++ compiler, so they must exist in the index
+ *   - Static member access  Type::member  (incl. arity check from signature)
+ *   - Variable declarations TypeName varName — type must exist
+ *   - Bound buffer access   buffer.Field / buffer.method() when the variable
+ *     was declared in the snippet with a table/view type from the index
+ *   - Label references      "@File:Id" and legacy "@SYS12345"
+ *
+ * Severity model (conservative — false blocks are worse than misses):
+ *   error   — intrinsic target missing, static type/method missing,
+ *             field missing on a confidently-bound table, arity mismatch,
+ *             modern label id missing in a known label file
+ *   warning — unknown declared type (kernel classes are not in metadata XML),
+ *             instance method missing, legacy label not found,
+ *             label file unknown (may be created later in the same task)
+ */
+import { z } from 'zod';
+import type { XppServerContext } from '../types/context.js';
+export declare const resolveReferencesArgsSchema: z.ZodObject<{
+    code: z.ZodString;
+    context: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export interface ReferenceViolation {
+    kind: 'unknown-type' | 'unknown-static-member' | 'unknown-method' | 'unknown-field' | 'unknown-label' | 'unknown-intrinsic-target' | 'arity-mismatch';
+    severity: 'error' | 'warning';
+    line: number;
+    identifier: string;
+    detail: string;
+}
+export interface ResolveResult {
+    violations: ReferenceViolation[];
+    /** Count of references that were positively verified against the index */
+    verifiedCount: number;
+}
+/** Minimal DB surface the resolver needs — satisfied by better-sqlite3. */
+export interface ResolverDeps {
+    db: {
+        prepare(sql: string): {
+            get(...params: unknown[]): unknown;
+            all(...params: unknown[]): unknown[];
+        };
+    };
+    getLabelById(labelId: string, labelFileId?: string): Array<{
+        labelId: string;
+        labelFileId: string;
+    }>;
+    getLabelFileIds(): Array<{
+        labelFileId: string;
+    }>;
+}
+export declare function resolveXppReferences(code: string, deps: ResolverDeps): ResolveResult;
+/**
+ * When GROUNDING_ENFORCE=true, run the resolver over X++ source about to be
+ * written and reject the write if any ERROR-severity violation is found.
+ * Returns null when the gate passes (disabled, no code, or clean).
+ */
+export declare function gateOnReferenceErrors(code: string | undefined, symbolIndex: {
+    getReadDb(): ResolverDeps['db'];
+    getLabelById: ResolverDeps['getLabelById'];
+    getLabelFileIds: ResolverDeps['getLabelFileIds'];
+} | undefined, operationDescription: string): {
+    isError: true;
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+} | null;
+export declare function resolveReferencesTool(request: {
+    params: {
+        arguments?: unknown;
+    };
+}, context: XppServerContext): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=resolveReferences.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveReferences.d.ts","sourceRoot":"","sources":["../../src/tools/resolveReferences.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,eAAO,MAAM,2BAA2B;;;iBAOtC,CAAC;AAKH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EACA,cAAc,GACd,uBAAuB,GACvB,gBAAgB,GAChB,eAAe,GACf,eAAe,GACf,0BAA0B,GAC1B,gBAAgB,CAAC;IACrB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,0EAA0E;IAC1E,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE;QACF,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG;YACpB,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;YACnC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;SACtC,CAAC;KACH,CAAC;IACF,YAAY,CACV,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,eAAe,IAAI,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAyZD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,aAAa,CAqQpF;AAYD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,WAAW,EAAE;IACX,SAAS,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;IAC3C,eAAe,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAC;CAClD,GAAG,SAAS,EACb,oBAAoB,EAAE,MAAM,GAC3B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,IAAI,CA8BrE;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE;IAAE,MAAM,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,EAC5C,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAkEhF"}