d365fo-mcp 1.0.0

package/dist/tools/getFormPatternSpec.js

@@ -0,0 +1,290 @@
+/**
+ * get_form_pattern_spec — expose the curated form-pattern catalog to AI
+ * clients: structure tree (required containers, ordering, allowed
+ * sub-patterns), when to use, reference forms, lifecycle guidance.
+ */
+import { z } from 'zod';
+import { FORM_PATTERN_CATALOG, resolvePattern, resolveSubPattern, } from '../knowledge/formPatterns/index.js';
+import { hasMinedPatternData } from '../knowledge/formPatterns/crossCheck.js';
+import { methodStubsForPattern } from '../knowledge/formPatterns/methodStubs.js';
+export const getFormPatternSpecArgsSchema = z.object({
+    pattern: z.string().describe('Pattern name (id, xmlName, or alias) — e.g. "SimpleList", "DetailsMaster", "Dialog", ' +
+        'or a sub-pattern like "FieldsFieldGroups". Aliases like "master", "transaction" work too.'),
+});
+// Tool registration (name, description, inputSchema) lives inline in
+// src/server/mcpServer.ts - the single source of truth for tool instructions.
+function occurrenceLabel(occ) {
+    switch (occ) {
+        case 'required': return 'required';
+        case 'optional': return 'optional';
+        case 'oneOrMore': return '1..n required';
+        case 'zeroOrMore': return '0..n';
+    }
+}
+function renderNode(node, indent, lines) {
+    const types = node.controlTypes.join('|');
+    const parts = [`${indent}${types} "${node.id}" (${occurrenceLabel(node.occurrence)})`];
+    if (node.nameHint)
+        parts.push(`name≈${node.nameHint}`);
+    if (node.properties) {
+        parts.push(Object.entries(node.properties).map(([k, v]) => `${k}=${v}`).join(' '));
+    }
+    if (node.requiresSubPattern) {
+        parts.push(node.allowedSubPatterns?.length
+            ? `sub-pattern: ${node.allowedSubPatterns.join('/')}`
+            : 'sub-pattern required');
+    }
+    if (node.extraChildren === 'none')
+        parts.push('[no extra children]');
+    else if (Array.isArray(node.extraChildren))
+        parts.push(`[extras: ${node.extraChildren.join(', ')}]`);
+    lines.push(parts.join('  — '));
+    for (const child of node.children ?? [])
+        renderNode(child, indent + '  ', lines);
+}
+/**
+ * Inverse of normalizeControlType (src/metadata/formPatternMiner.ts): a
+ * normalized container type maps back to its serialized i:type as
+ * `AxForm<Type>Control`. Returns null for the wildcard slot, where no single
+ * concrete control can be emitted.
+ */
+function axIType(normalized) {
+    if (!normalized || normalized === '*')
+        return null;
+    return `AxForm${normalized}Control`;
+}
+function renderSkeletonNode(node, indent, lines) {
+    const primary = node.controlTypes.find((t) => t !== '*') ?? node.controlTypes[0];
+    const iType = axIType(primary);
+    if (!iType) {
+        lines.push(`${indent}<!-- "${node.id}": ${node.controlTypes.join('|')} (${occurrenceLabel(node.occurrence)}) -->`);
+        return;
+    }
+    lines.push(`${indent}<AxFormControl xmlns="" i:type="${iType}">`);
+    lines.push(`${indent}  <Name>${node.nameHint ?? node.id}</Name>`);
+    for (const [k, v] of Object.entries(node.properties ?? {})) {
+        lines.push(`${indent}  <${k}>${v}</${k}>`);
+    }
+    if (node.requiresSubPattern) {
+        const sp = node.allowedSubPatterns?.[0];
+        if (sp) {
+            lines.push(`${indent}  <Pattern>${sp}</Pattern>`);
+            lines.push(`${indent}  <!-- set <PatternVersion> from object_patterns(action="spec", pattern="${sp}") -->`);
+        }
+        else {
+            lines.push(`${indent}  <!-- this container requires a sub-pattern: declare <Pattern>…</Pattern> -->`);
+        }
+    }
+    lines.push(`${indent}  <FormControlExtension i:nil="true" />`);
+    if (node.children?.length) {
+        lines.push(`${indent}  <Controls>`);
+        for (const child of node.children)
+            renderSkeletonNode(child, indent + '    ', lines);
+        lines.push(`${indent}  </Controls>`);
+    }
+    else {
+        lines.push(`${indent}  <Controls><!-- add child controls / field bindings here --></Controls>`);
+    }
+    lines.push(`${indent}</AxFormControl>`);
+}
+/**
+ * A copy-pasteable Design subtree with the required containers, types, order,
+ * Style properties and sub-patterns already in place — the exact shape FP003
+ * (missing container), FP004 (wrong control under a slot) and FP007 (wrong
+ * sub-pattern) enforce. Lets a generator get the structure right on the first
+ * attempt instead of translating the abstract tree above into XML by hand.
+ */
+function renderXmlSkeleton(spec) {
+    const lines = [];
+    lines.push('');
+    lines.push('## Copy-paste XML skeleton (Design subtree — structurally pattern-valid)');
+    lines.push('```xml');
+    lines.push('<Design>');
+    lines.push(`  <Pattern xmlns="">${spec.xmlName}</Pattern>`);
+    lines.push(`  <PatternVersion xmlns="">${spec.versions[0]}</PatternVersion>`);
+    for (const [k, v] of Object.entries(spec.designProperties ?? {})) {
+        lines.push(`  <${k} xmlns="">${v}</${k}>`);
+    }
+    lines.push('  <Controls xmlns="">');
+    for (const node of spec.root)
+        renderSkeletonNode(node, '    ', lines);
+    lines.push('  </Controls>');
+    lines.push('</Design>');
+    lines.push('```');
+    lines.push('> Fill in datasource bindings and field/grid child controls. The container types, order, `Style` and sub-patterns above are what the pattern validator enforces.');
+    return lines;
+}
+function renderTopLevel(spec, db) {
+    const lines = [];
+    lines.push(`# Form Pattern: ${spec.displayName}`);
+    lines.push('');
+    lines.push(`**xmlName:** \`${spec.xmlName}\`   **Versions:** ${spec.versions.join(', ')} (current: ${spec.versions[0]})`);
+    if (spec.variantOf)
+        lines.push(`**Variant of:** ${spec.variantOf}`);
+    lines.push('');
+    lines.push(spec.purpose);
+    lines.push('');
+    lines.push('## When to use');
+    for (const w of spec.whenToUse)
+        lines.push(`- ${w}`);
+    if (spec.whenNotToUse?.length) {
+        lines.push('');
+        lines.push('## When NOT to use');
+        for (const w of spec.whenNotToUse)
+            lines.push(`- ${w}`);
+    }
+    lines.push('');
+    lines.push('## Structure (required order under Design)');
+    lines.push('```');
+    for (const node of spec.root)
+        renderNode(node, '', lines);
+    if (spec.extraRootChildren === 'none')
+        lines.push('(no other root controls allowed)');
+    else if (Array.isArray(spec.extraRootChildren))
+        lines.push(`(extra root controls allowed: ${spec.extraRootChildren.join(', ')})`);
+    else
+        lines.push('(additional root controls tolerated)');
+    lines.push('```');
+    lines.push(...renderXmlSkeleton(spec));
+    if (spec.designProperties) {
+        lines.push('');
+        lines.push('**Design properties:** ' + Object.entries(spec.designProperties).map(([k, v]) => `${k}="${v}"`).join(', '));
+    }
+    if (spec.requiresDataSource && spec.requiresDataSource !== 'none') {
+        lines.push(`**Datasources:** ${spec.requiresDataSource === 'headerLines'
+            ? 'header + lines (≥2, linked via JoinSource)'
+            : 'at least one primary datasource'}`);
+    }
+    lines.push('');
+    lines.push(`**Reference forms (clone these):** ${spec.referenceForms.map((f) => `\`${f}\``).join(', ')}`);
+    try {
+        if (db && hasMinedPatternData(db)) {
+            const mined = db.prepare(`
+        SELECT form_name FROM form_patterns
+        WHERE node_path = 'Design' AND pattern = ? ORDER BY form_name LIMIT 8
+      `).all(spec.xmlName);
+            if (mined.length > 0) {
+                lines.push(`**Mined usage in this environment:** ${mined.map((m) => `\`${m.form_name}\``).join(', ')}`);
+            }
+        }
+    }
+    catch { /* older index */ }
+    if (spec.lifecycleGuidance?.length) {
+        lines.push('');
+        lines.push('## Lifecycle methods');
+        for (const g of spec.lifecycleGuidance)
+            lines.push(`- ${g}`);
+        const stubs = methodStubsForPattern(spec.id, '<PrimaryDS>');
+        const stubNames = [
+            ...stubs.formMethods.map((s) => s.name),
+            ...stubs.dataSourceMethods.map((s) => `<PrimaryDS>.${s.name}`),
+        ];
+        if (stubNames.length > 0) {
+            lines.push(`- \`generate_object(mode="scaffold", objectType="form", includeMethodStubs=true)\` injects: ${stubNames.join(', ')}`);
+        }
+    }
+    if (spec.notes?.length) {
+        lines.push('');
+        lines.push('## Notes');
+        for (const n of spec.notes)
+            lines.push(`- ${n}`);
+    }
+    lines.push('');
+    lines.push('## Workflow');
+    lines.push(`1. \`generate_object(mode="scaffold", objectType="form", name=..., cloneFrom="${spec.referenceForms[0]}", tableMapping={...}, includeMethodStubs=true)\``);
+    lines.push('2. `object_patterns(domain="form", action="validate", xml=...)` — fix any FP errors');
+    lines.push('3. `d365fo_file(action="create", objectType="form", ...)` — structural errors block while FORM_PATTERN_ENFORCE=true');
+    return lines.join('\n');
+}
+function renderSubPattern(sp) {
+    const lines = [];
+    lines.push(`# Container Sub-Pattern: ${sp.displayName}`);
+    lines.push('');
+    lines.push(`**xmlName:** \`${sp.xmlName}\`   **Versions:** ${sp.versions.join(', ')}`);
+    lines.push(`**Applies to container types:** ${sp.appliesToControlTypes.join(', ')}`);
+    if (sp.parentPatterns?.length)
+        lines.push(`**Only inside patterns:** ${sp.parentPatterns.join(', ')}`);
+    lines.push('');
+    lines.push(sp.purpose);
+    lines.push('');
+    lines.push('## Structure (inside the container)');
+    lines.push('```');
+    for (const node of sp.root)
+        renderNode(node, '', lines);
+    if (sp.extraRootChildren === 'none')
+        lines.push('(no other children allowed)');
+    else if (Array.isArray(sp.extraRootChildren))
+        lines.push(`(allowed children: ${sp.extraRootChildren.join(', ')})`);
+    else
+        lines.push('(additional children tolerated)');
+    lines.push('```');
+    if (sp.referenceForms?.length) {
+        lines.push('');
+        lines.push(`**Reference usage:** ${sp.referenceForms.map((f) => `\`${f}\``).join(', ')}`);
+    }
+    if (sp.notes?.length) {
+        lines.push('');
+        for (const n of sp.notes)
+            lines.push(`- ${n}`);
+    }
+    return lines.join('\n');
+}
+export async function getFormPatternSpecTool(request, context) {
+    const raw = request?.params?.arguments ?? request;
+    const parsed = getFormPatternSpecArgsSchema.safeParse(raw);
+    if (!parsed.success) {
+        return {
+            isError: true,
+            content: [{ type: 'text', text: `❌ Invalid parameters: ${parsed.error.message}` }],
+        };
+    }
+    const name = parsed.data.pattern;
+    const db = context?.symbolIndex?.getReadDb?.();
+    const spec = resolvePattern(name);
+    if (spec) {
+        return { content: [{ type: 'text', text: renderTopLevel(spec, db) }] };
+    }
+    const sub = resolveSubPattern(name);
+    if (sub) {
+        return { content: [{ type: 'text', text: renderSubPattern(sub) }] };
+    }
+    const allNames = [
+        ...FORM_PATTERN_CATALOG.patterns.map((p) => p.xmlName),
+        ...FORM_PATTERN_CATALOG.subPatterns.map((p) => p.xmlName),
+    ];
+    // Redirect common knowledge topics that resemble pattern names
+    const KNOWLEDGE_TOPIC_REDIRECTS = {
+        'number-sequence': 'number-sequences',
+        'number-sequences': 'number-sequences',
+        'numbersequence': 'number-sequences',
+        'security': 'security',
+        'security-access': 'security',
+        'coc': 'coc-authoring',
+        'coc-authoring': 'coc-authoring',
+        'sysoperation': 'sysoperation',
+        'data-entity': 'data-entities',
+        'data-entities': 'data-entities',
+        'workflow': 'workflow',
+        'select-statement': 'select-statement',
+    };
+    const knowledgeTopic = KNOWLEDGE_TOPIC_REDIRECTS[name.toLowerCase()];
+    if (knowledgeTopic) {
+        return {
+            isError: true,
+            content: [{
+                    type: 'text',
+                    text: `❌ "${name}" is not a form pattern — it is a knowledge topic.\n\n` +
+                        `Use get_knowledge instead:\n` +
+                        `  get_knowledge(kind="knowledge", topic="${knowledgeTopic}")`,
+                }],
+        };
+    }
+    return {
+        isError: true,
+        content: [{
+                type: 'text',
+                text: `❌ Unknown pattern "${name}".\n\nKnown patterns and sub-patterns:\n${allNames.map((n) => `  - ${n}`).join('\n')}`,
+            }],
+    };
+}
+//# sourceMappingURL=getFormPatternSpec.js.map

package/dist/tools/getFormPatternSpec.js.map

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

package/dist/tools/getFormPatterns.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Get Form Patterns Tool
+ * Analyzes common datasource configurations, control hierarchies, and form patterns
+ * Used for smart form generation
+ */
+import type { CallToolRequest } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import type { XppServerContext } from '../types/context.js';
+import { type FormPatternSpec } from '../knowledge/formPatterns/index.js';
+declare const RecommendSchema: z.ZodObject<{
+    entityKind: z.ZodOptional<z.ZodEnum<{
+        dialogTask: "dialogTask";
+        inquiry: "inquiry";
+        lookup: "lookup";
+        master: "master";
+        parameters: "parameters";
+        setup: "setup";
+        transaction: "transaction";
+        workspace: "workspace";
+    }>>;
+    hasHeaderLines: z.ZodOptional<z.ZodBoolean>;
+    fieldCount: z.ZodOptional<z.ZodNumber>;
+    usageIntent: z.ZodOptional<z.ZodEnum<{
+        dashboard: "dashboard";
+        maintain: "maintain";
+        pickValue: "pickValue";
+        quickCreate: "quickCreate";
+        viewOnly: "viewOnly";
+        wizard: "wizard";
+    }>>;
+    tableName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RecommendInput = z.infer<typeof RecommendSchema>;
+export interface PatternRecommendation {
+    spec: FormPatternSpec;
+    reasons: string[];
+    /** Lower-ranked alternatives worth considering */
+    alternatives: Array<{
+        spec: FormPatternSpec;
+        why: string;
+    }>;
+}
+/**
+ * Microsoft form-pattern decision tree (select-form-pattern guidance) over the
+ * curated catalog. Pure function — index evidence is attached by the caller.
+ */
+export declare function recommendPattern(input: RecommendInput): PatternRecommendation;
+export declare function handleGetFormPatterns(args: {
+    formPattern?: string;
+    dataSource?: string;
+    tableName?: string;
+    limit?: number;
+}, symbolIndex: any): Promise<any>;
+export declare function getFormPatternsTool(request: CallToolRequest, context: XppServerContext): Promise<{
+    isError?: undefined;
+    content: {
+        type: string;
+        text: string;
+    }[];
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+export {};
+//# sourceMappingURL=getFormPatterns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getFormPatterns.d.ts","sourceRoot":"","sources":["../../src/tools/getFormPatterns.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAI1F,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;iBAYnB,CAAC;AAeH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kDAAkD;IAClD,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,eAAe,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,qBAAqB,CA6E7E;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EACvF,WAAW,EAAE,GAAG,GACf,OAAO,CAAC,GAAG,CAAC,CAuBd;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB;;;;;;;;;;;;GA2C5F"}