d365fo-mcp 1.0.0

package/dist/tools/prepareChange.js

@@ -0,0 +1,327 @@
+/**
+ * prepare_change — single-round context aggregator for D365FO extension work.
+ *
+ * Gathers in one call everything an AI needs to safely extend an existing
+ * D365FO object:
+ *   - exact method signature from the symbol index
+ *   - existing CoC wrappers (bridge-first via DYNAMICSXREFDB, index fallback)
+ *   - CoC/event-handler eligibility
+ *   - recommended extension strategy
+ *   - object naming validation for the proposed new name
+ *   - relevant code patterns
+ *
+ * Internally runs up to 5 index/bridge queries in parallel. Returns a
+ * provenance token (SHA-256, 30-min TTL) that proves the model looked at
+ * the real codebase before writing code.
+ *
+ * Fail-closed enforcement: when GROUNDING_ENFORCE=true, extension patterns
+ * in generate_object(mode="pattern") and d365fo_file(action="create") require this token.
+ */
+import { z } from 'zod';
+import { createProvenanceToken } from '../utils/provenanceStore.js';
+import { tryBridgeCocExtensions } from '../bridge/bridgeAdapter.js';
+import { getConfigManager } from '../utils/configManager.js';
+import { lookupSymbolNocase } from '../utils/symbolLookup.js';
+import { rankContext, renderRankedContext } from '../workspace/contextRanker.js';
+// Schema
+export const prepareChangeArgsSchema = z.object({
+    goal: z.string().describe('One-sentence description of the intended change. ' +
+        'Example: "Add CoC on CustTable.validateWrite to enforce a custom rule."'),
+    objectName: z.string().describe('Name of the D365FO object to extend or modify (class, table, form, etc.). ' +
+        'Example: "CustTable", "SalesFormLetter", "CustPostInvoice".'),
+    methodName: z.string().optional().describe('Target method name when the change involves a specific method (CoC or event handlers). ' +
+        'Example: "validateWrite", "insert", "post".'),
+    objectType: z.enum([
+        'class', 'table', 'form', 'query', 'view', 'enum', 'edt',
+        'data-entity', 'map', 'report', 'security-duty', 'security-role',
+    ]).optional().describe('D365FO object type. Auto-detected from the symbol index when omitted.'),
+    proposedName: z.string().optional().describe('Proposed name for the new extension class/object. ' +
+        'When provided, naming validation runs and the result is included in the bundle.'),
+});
+// Helpers
+/** Case-insensitive top-level object lookup — see src/utils/symbolLookup.ts. */
+function lookupObjectNocase(objectName, context) {
+    return lookupSymbolNocase(context.symbolIndex.getReadDb(), objectName);
+}
+/** Resolve an object's canonical name + type from the symbol index. */
+async function resolveObject(objectName, context) {
+    try {
+        return lookupObjectNocase(objectName, context);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Look up method signature directly from the symbol index. */
+async function fetchMethodSignature(objectName, methodName, context) {
+    try {
+        const db = context.symbolIndex.getReadDb();
+        // parent_name stays BINARY (canonical casing resolved upstream) so the
+        // probe uses idx_parent_type_name; NOCASE applies only to the method name
+        // within that object's few hundred method rows.
+        const row = db.prepare(`SELECT signature, tags FROM symbols
+       WHERE parent_name = ? AND type = 'method' AND name = ? COLLATE NOCASE
+       LIMIT 1`).get(objectName, methodName);
+        if (row) {
+            const lines = [`Signature : ${row.signature ?? '(unavailable)'}`];
+            const tags = row.tags ?? '';
+            if (tags.includes('hookable:false'))
+                lines.push('⛔ [Hookable(false)] — CoC is blocked.');
+            if (tags.includes('wrappable:false'))
+                lines.push('⛔ [Wrappable(false)] — wrapping is blocked.');
+            if (/\bfinal\b/i.test(row.signature ?? '')) {
+                lines.push('⚠️  Method is final — requires [Wrappable(true)] to enable CoC.');
+            }
+            return lines.join('\n');
+        }
+    }
+    catch {
+        // ignore DB errors
+    }
+    return '(not found in symbol index)';
+}
+/** Fetch existing CoC extensions — bridge-first, index fallback. */
+async function fetchCocExtensions(objectName, methodName, context) {
+    // Bridge first (DYNAMICSXREFDB — authoritative)
+    if (context.bridge) {
+        try {
+            const result = await tryBridgeCocExtensions(context.bridge, objectName, methodName);
+            if (result) {
+                const text = result.content
+                    .filter((i) => i?.type === 'text')
+                    .map((i) => i.text)
+                    .join('\n');
+                if (text)
+                    return text;
+            }
+        }
+        catch {
+            // Fall through to index
+        }
+    }
+    // Symbol index fallback
+    try {
+        const db = context.symbolIndex.getReadDb();
+        const rows = db.prepare(`SELECT name, model FROM symbols
+       WHERE type IN ('class', 'class-extension')
+         AND (name LIKE ? OR name LIKE ?)
+       LIMIT 20`).all(`${objectName}%Extension`, `${objectName}%_Extension`);
+        if (rows.length > 0) {
+            return rows.map(r => `  ${r.name} (${r.model})`).join('\n') +
+                '\n_(source: symbol index — bridge unavailable for exact cross-reference)_';
+        }
+    }
+    catch {
+        // ignore
+    }
+    return 'None found.';
+}
+/** Determine CoC eligibility from the symbol index. */
+async function fetchEligibility(objectName, methodName, context) {
+    if (!methodName)
+        return 'No specific method targeted — check base class documentation.';
+    try {
+        const db = context.symbolIndex.getReadDb();
+        const row = db.prepare(`SELECT signature, tags FROM symbols
+       WHERE parent_name = ? AND type = 'method' AND name = ? COLLATE NOCASE
+       LIMIT 1`).get(objectName, methodName);
+        if (row) {
+            const tags = row.tags ?? '';
+            if (tags.includes('hookable:false'))
+                return '⛔ [Hookable(false)] — CoC is blocked on this method.';
+            if (tags.includes('wrappable:false'))
+                return '⛔ [Wrappable(false)] — wrapping is blocked on this method.';
+            if (/\bfinal\b/i.test(row.signature ?? '')) {
+                return '⚠️  Method is final — requires [Wrappable(true)] attribute to enable CoC.';
+            }
+            return '✅ Method appears CoC-eligible.';
+        }
+    }
+    catch {
+        // ignore
+    }
+    return '(could not determine — method not found in symbol index)';
+}
+/** Suggest relevant extension strategies based on object type. */
+function fetchStrategy(objectType) {
+    const strategies = [];
+    if (objectType === 'table') {
+        strategies.push('• Table extension (AxTableExtension) — add fields, indexes, relations, field groups');
+        strategies.push('• Table extension class [ExtensionOf(tableStr(...))] — CoC on table methods');
+        strategies.push('• Event handler [DataEventHandler(tableStr(X), DataEventType::...)] — subscribe to data events');
+    }
+    else if (objectType === 'class') {
+        strategies.push('• Class extension [ExtensionOf(classStr(...))] — CoC on class methods');
+        strategies.push('• Event handler [SubscribesTo(...)] — subscribe to delegate events');
+    }
+    else if (objectType === 'form') {
+        strategies.push('• Form extension (AxFormExtension) — add controls, data sources, menu items');
+        strategies.push('• Form extension class [ExtensionOf(formStr(...))] — CoC on form methods');
+        strategies.push('• Form datasource extension [ExtensionOf(formDataSourceStr(...))] — CoC on DS methods');
+    }
+    else if (objectType === 'map') {
+        strategies.push('• Map extension class [ExtensionOf(mapStr(...))] — add/wrap map methods');
+    }
+    else if (objectType === 'security-duty') {
+        strategies.push('• security-duty-extension (AxSecurityDutyExtension) — add privileges to this EXISTING duty without overlaying it');
+        strategies.push('• New standalone security-duty — only if this duty is not a fit for the new privilege at all');
+    }
+    else if (objectType === 'security-role') {
+        strategies.push('• security-role-extension (AxSecurityRoleExtension) — add duties/privileges to this EXISTING role without overlaying it');
+        strategies.push('• New standalone security-role — only if this role is not a fit for the new duty at all');
+    }
+    else {
+        strategies.push('• Extension class via [ExtensionOf] — check the object type for supported extension mechanisms');
+    }
+    strategies.push('• New standalone class — if no suitable extension point exists');
+    return strategies.join('\n');
+}
+/** Validate proposed object name. */
+async function fetchNamingValidation(proposedName, context) {
+    const issues = [];
+    if (proposedName.length > 81) {
+        issues.push(`❌ Name exceeds 81-char AOT limit (${proposedName.length} chars). Shorten it.`);
+    }
+    if (!/^[A-Z]/.test(proposedName)) {
+        issues.push('❌ Name must start with an uppercase letter (PascalCase).');
+    }
+    try {
+        const existing = lookupObjectNocase(proposedName, context);
+        if (existing) {
+            issues.push(`⚠️  Name "${existing.name}" already exists in model "${existing.model}".`);
+        }
+    }
+    catch {
+        // ignore
+    }
+    const modelName = getConfigManager().getModelName();
+    if (modelName && !proposedName.includes(modelName) && !proposedName.endsWith('_Extension')) {
+        issues.push(`ℹ️  Confirm naming follows your convention (active model: ${modelName}).`);
+    }
+    return issues.length > 0 ? issues.join('\n') : `✅ "${proposedName}" looks valid.`;
+}
+/** Fetch relevant patterns from the index. */
+async function fetchPatterns(objectName, objectType, context) {
+    try {
+        const db = context.symbolIndex.getReadDb();
+        // INDEXED BY: with `description != ''` alone the planner scans and fetches
+        // every row of the type (77 s cold on a production DB). Forcing
+        // idx_type_name evaluates the LIKE against the index, so only name
+        // matches ever touch the table.
+        const rows = db.prepare(`SELECT name, description FROM symbols INDEXED BY idx_type_name
+       WHERE type = ? AND name LIKE ? AND description != ''
+       ORDER BY LENGTH(name)
+       LIMIT 3`).all(objectType ?? 'class', `%${objectName}%`);
+        if (rows.length > 0) {
+            return rows.map(r => `  ${r.name}: ${r.description}`).join('\n');
+        }
+    }
+    catch {
+        // ignore
+    }
+    return '(no similar patterns found in index)';
+}
+// Tool handler
+export async function prepareChangeTool(request, context) {
+    const raw = request?.params?.arguments ?? request;
+    const parsed = prepareChangeArgsSchema.safeParse(raw);
+    if (!parsed.success) {
+        return {
+            isError: true,
+            content: [{ type: 'text', text: `❌ Invalid parameters: ${parsed.error.message}` }],
+        };
+    }
+    const { goal, objectName: rawObjectName, methodName, objectType: explicitType, proposedName } = parsed.data;
+    // Resolve canonical casing + type from the index; downstream lookups use the
+    // canonical name so they can stay on BINARY-collated indexes.
+    const resolved = await resolveObject(rawObjectName, context);
+    const objectName = resolved?.name ?? rawObjectName;
+    const resolvedType = explicitType ?? resolved?.type;
+    // Run all fact-gathering queries in parallel
+    const [sigText, cocText, eligText, patternText, namingText] = await Promise.all([
+        methodName
+            ? fetchMethodSignature(objectName, methodName, context)
+            : Promise.resolve(null),
+        fetchCocExtensions(objectName, methodName, context),
+        fetchEligibility(objectName, methodName, context),
+        fetchPatterns(objectName, resolvedType, context),
+        proposedName
+            ? fetchNamingValidation(proposedName, context)
+            : Promise.resolve(null),
+    ]);
+    // Build provenance bundle
+    const token = createProvenanceToken({
+        goal,
+        objectName,
+        methodName,
+        objectType: resolvedType,
+        proposedName,
+        methodSignature: sigText ?? undefined,
+        cocExtensions: cocText,
+        extensionEligibility: eligText,
+        recommendedStrategy: fetchStrategy(resolvedType),
+        namingValidation: namingText ?? undefined,
+        patterns: patternText,
+    });
+    const strategy = fetchStrategy(resolvedType);
+    // Format output
+    const lines = [];
+    lines.push(`## prepare(mode="change"): context for \`${objectName}\`${methodName ? `::${methodName}` : ''}`);
+    lines.push('');
+    lines.push(`**Goal:** ${goal}`);
+    if (resolvedType)
+        lines.push(`**Object type (resolved):** ${resolvedType}`);
+    lines.push('');
+    if (sigText !== null) {
+        lines.push('### Method signature _(symbol index)_');
+        lines.push(sigText);
+        lines.push('');
+    }
+    lines.push('### Existing CoC extensions');
+    lines.push(cocText);
+    lines.push('');
+    if (methodName) {
+        lines.push('### CoC eligibility');
+        lines.push(eligText);
+        lines.push('');
+    }
+    lines.push('### Recommended extension strategies');
+    lines.push(strategy);
+    lines.push('');
+    lines.push('### Related patterns _(symbol index)_');
+    lines.push(patternText);
+    lines.push('');
+    // Ranked neighborhood, anchored on the target object; additive, best-effort.
+    try {
+        const ranked = rankContext(context, {
+            intent: `${goal} ${objectName} ${methodName ?? ''}`,
+            activeObject: { name: objectName, type: resolvedType },
+        });
+        lines.push(...renderRankedContext(ranked));
+        lines.push('');
+    }
+    catch {
+        // omit on failure
+    }
+    if (namingText !== null) {
+        lines.push(`### Naming validation for \`${proposedName}\``);
+        lines.push(namingText);
+        lines.push('');
+    }
+    lines.push('---');
+    lines.push(`**Grounding token:** \`${token}\``);
+    lines.push('');
+    lines.push(process.env.GROUNDING_ENFORCE === 'true'
+        ? '⚠️  **GROUNDING_ENFORCE=true** — pass `groundingToken` to `generate_object(mode="pattern")` ' +
+            '(extension patterns), `d365fo_file(action="create")` and `d365fo_file(action="modify")` (extension objectTypes). ' +
+            `The token is bound to \`${objectName}\` — it does not authorize writes to other objects. ` +
+            'Token expires in 30 minutes.'
+        : 'ℹ️  Pass `groundingToken` to `generate_object(mode="pattern")`, `d365fo_file(action="create")` or `d365fo_file(action="modify")` ' +
+            'to confirm this context was used. Set `GROUNDING_ENFORCE=true` to require it.');
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+    };
+}
+// Tool registration (name, description, inputSchema) lives inline in
+// src/server/mcpServer.ts - the single source of truth for tool instructions.
+//# sourceMappingURL=prepareChange.js.map

package/dist/tools/prepareChange.js.map

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

package/dist/tools/prepareCreate.d.ts

@@ -0,0 +1,45 @@
+/**
+ * prepare_create — single-round context aggregator for NEW D365FO objects.
+ *
+ * Mirror of prepare_change for object creation: one call replaces the
+ * search → validate_object_naming → suggest_edt → labels → patterns
+ * sequence (4–6 agentic rounds) with a single parallel query bundle:
+ *   - name collision check (exact + prefix variants) against the symbol index
+ *   - naming validation incl. the prefix the write tool will actually apply
+ *   - similar existing objects to copy patterns from
+ *   - EDT suggestions for planned table fields (edt_metadata + symbols)
+ *   - reusable existing labels matching the object name
+ *   - mined property defaults from property_stats (what standard models set)
+ *   - grounding token (object-bound, 30-min TTL)
+ */
+import { z } from 'zod';
+import type { XppServerContext } from '../types/context.js';
+export declare const prepareCreateArgsSchema: z.ZodObject<{
+    goal: z.ZodString;
+    objectName: z.ZodString;
+    objectType: z.ZodEnum<{
+        "business-event": "business-event";
+        class: "class";
+        "data-entity": "data-entity";
+        edt: "edt";
+        enum: "enum";
+        form: "form";
+        kpi: "kpi";
+        map: "map";
+        menu: "menu";
+        "menu-item-action": "menu-item-action";
+        "menu-item-display": "menu-item-display";
+        "menu-item-output": "menu-item-output";
+        query: "query";
+        report: "report";
+        "security-duty": "security-duty";
+        "security-privilege": "security-privilege";
+        "security-role": "security-role";
+        table: "table";
+        tile: "tile";
+        view: "view";
+    }>;
+    fieldsHint: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare function prepareCreateTool(request: any, context: XppServerContext): Promise<any>;
+//# sourceMappingURL=prepareCreate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prepareCreate.d.ts","sourceRoot":"","sources":["../../src/tools/prepareCreate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAQ5D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuBlC,CAAC;AAmLH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CA8E7F"}

package/dist/tools/prepareCreate.js

@@ -0,0 +1,263 @@
+/**
+ * prepare_create — single-round context aggregator for NEW D365FO objects.
+ *
+ * Mirror of prepare_change for object creation: one call replaces the
+ * search → validate_object_naming → suggest_edt → labels → patterns
+ * sequence (4–6 agentic rounds) with a single parallel query bundle:
+ *   - name collision check (exact + prefix variants) against the symbol index
+ *   - naming validation incl. the prefix the write tool will actually apply
+ *   - similar existing objects to copy patterns from
+ *   - EDT suggestions for planned table fields (edt_metadata + symbols)
+ *   - reusable existing labels matching the object name
+ *   - mined property defaults from property_stats (what standard models set)
+ *   - grounding token (object-bound, 30-min TTL)
+ */
+import { z } from 'zod';
+import { createProvenanceToken } from '../utils/provenanceStore.js';
+import { getConfigManager } from '../utils/configManager.js';
+import { resolveObjectPrefix, applyObjectPrefix } from '../utils/modelClassifier.js';
+import { rankContext, renderRankedContext } from '../workspace/contextRanker.js';
+import { lookupSymbolsNocase } from '../utils/symbolLookup.js';
+import { RESERVED_SYSTEM_FIELD_NAMES } from './generateSmartTable.js';
+export const prepareCreateArgsSchema = z.object({
+    goal: z.string().describe('One-sentence description of what the new object is for. ' +
+        'Example: "Parameter table for the Contoso import feature."'),
+    objectName: z.string().describe('Proposed BASE name of the new object WITHOUT model prefix ' +
+        '(the same value you would pass to d365fo_file(action="create")). Example: "ImportParameters".'),
+    objectType: z.enum([
+        'class', 'table', 'form', 'enum', 'edt', 'query', 'view',
+        'data-entity', 'report', 'menu-item-display', 'menu-item-action',
+        'menu-item-output', 'menu', 'security-privilege', 'security-duty', 'security-role',
+        'business-event', 'tile', 'kpi', 'map',
+    ]).describe('Type of the new D365FO object. Wholly new standalone objects only — for ' +
+        'extending an EXISTING object (table-extension, form-extension, CoC class-extension, ' +
+        'etc.) use prepare(mode="change") instead, which auto-detects the base object\'s type.'),
+    fieldsHint: z.array(z.string()).optional().describe('For tables/views: planned field names (e.g. ["CustAccount", "ImportDate", "Qty"]). ' +
+        'Each gets EDT suggestions from the index.'),
+});
+// Lookups below are all index-only, run in parallel.
+/** Exact + prefixed collision check. */
+function checkCollisions(finalName, baseName, context) {
+    try {
+        const db = context.symbolIndex.getReadDb();
+        // `name IN (?, ?) COLLATE NOCASE` silently compared case-SENSITIVELY (the
+        // COLLATE binds to the IN expression, not the column), so differently-cased
+        // collisions were missed. The nocase helper also stays on the indexes.
+        const rows = [];
+        const seen = new Set();
+        for (const n of new Set([finalName, baseName])) {
+            for (const r of lookupSymbolsNocase(db, n, { limit: 5 })) {
+                const key = `${r.name} ${r.type} ${r.model ?? ''}`;
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    rows.push(r);
+                }
+            }
+        }
+        if (rows.length > 0) {
+            return rows
+                .map(r => `⚠️  "${r.name}" already exists as ${r.type} in model "${r.model}" — pick a different name or extend it instead.`)
+                .join('\n');
+        }
+        return `✅ No collision — neither "${finalName}" nor "${baseName}" exists in the index.`;
+    }
+    catch {
+        return '(collision check unavailable — index not ready)';
+    }
+}
+/** Naming validation incl. the prefix create_d365fo_file will apply. */
+function validateNaming(baseName, finalName, modelName) {
+    const issues = [];
+    if (finalName.length > 81) {
+        issues.push(`❌ Final name "${finalName}" exceeds the 81-char AOT limit (${finalName.length}).`);
+    }
+    if (!/^[A-Za-z][A-Za-z0-9_]*$/.test(baseName)) {
+        issues.push('❌ Name may contain only letters, digits and underscores, and must not start with a digit.');
+    }
+    if (!/^[A-Z]/.test(baseName)) {
+        issues.push('❌ Name must start with an uppercase letter (PascalCase).');
+    }
+    const lines = [
+        `Base name   : ${baseName}`,
+        `Final name  : ${finalName}${finalName !== baseName ? ' _(prefix auto-applied by d365fo_file(action="create"))_' : ''}`,
+        `Model       : ${modelName ?? '(not configured — set modelName or .mcp.json)'}`,
+    ];
+    if (issues.length > 0)
+        lines.push(...issues);
+    else
+        lines.push('✅ Naming looks valid.');
+    return lines.join('\n');
+}
+/** Similar existing objects worth copying patterns from. */
+function findSimilarObjects(baseName, objectType, context) {
+    try {
+        const db = context.symbolIndex.getReadDb();
+        // Split CamelCase into tokens and search for the most specific ones
+        const tokens = baseName.split(/(?=[A-Z])/).filter(t => t.length >= 4);
+        const needle = tokens.length > 0 ? tokens[tokens.length - 1] : baseName;
+        // INDEXED BY: without it the planner picks idx_symbols_parent_name for
+        // `parent_name IS NULL` and fetches every top-level row (4.6 min cold on a
+        // production DB, blocking the event loop until the MCP client kills the
+        // server). idx_type_name evaluates the LIKE against the index, so only
+        // name matches ever touch the table (~10 ms).
+        const rows = db.prepare(`SELECT name, model FROM symbols INDEXED BY idx_type_name
+       WHERE type = ? AND name LIKE ? AND parent_name IS NULL
+       ORDER BY LENGTH(name) LIMIT 5`).all(objectType, `%${needle}%`);
+        if (rows.length > 0) {
+            return rows.map(r => `  ${r.name} (${r.model})`).join('\n') +
+                `\n_Use get_${objectType === 'table' ? 'table' : 'class'}_info or copyFrom in generate_object(mode="scaffold") to reuse their structure._`;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return '(no similar objects found — greenfield)';
+}
+/** EDT suggestions for planned table fields. */
+function suggestEdtsForFields(fieldsHint, context) {
+    const lines = [];
+    // Custom fields using reserved system field names fail compilation
+    const reservedHits = fieldsHint.filter(f => RESERVED_SYSTEM_FIELD_NAMES.has(f.toLowerCase()));
+    if (reservedHits.length > 0) {
+        lines.push(`⛔ **Reserved system field names — do NOT use as custom fields:**`, ...reservedHits.map(f => `  • \`${f}\` — reserved by the platform (auto-tracked). Rename to a non-reserved name (e.g. "NoteDateTime" instead of "CreatedDateTime").`), `  The platform auto-provides: CreatedDateTime, ModifiedDateTime, CreatedBy, ModifiedBy, RecId, RecVersion, DataAreaId, Partition.`, ``);
+    }
+    try {
+        const db = context.symbolIndex.getReadDb();
+        // INDEXED BY keeps the LIKE on the index (runs once per hinted field).
+        const stmt = db.prepare(`SELECT name, signature FROM symbols INDEXED BY idx_type_name
+       WHERE type = 'edt' AND name LIKE ? ORDER BY LENGTH(name) LIMIT 3`);
+        for (const field of fieldsHint.slice(0, 10)) {
+            if (RESERVED_SYSTEM_FIELD_NAMES.has(field.toLowerCase()))
+                continue;
+            const tokens = field.split(/(?=[A-Z])/).filter(t => t.length >= 3);
+            const needle = tokens.length > 0 ? tokens[tokens.length - 1] : field;
+            const rows = stmt.all(`%${needle}%`);
+            lines.push(rows.length > 0
+                ? `  ${field} → ${rows.map(r => r.name + (r.signature ? ` (extends ${r.signature})` : '')).join(', ')}`
+                : `  ${field} → (no EDT match — use suggest_edt("${field}") or base it on a primitive + label)`);
+        }
+    }
+    catch {
+        return '(EDT lookup unavailable)';
+    }
+    return lines.join('\n');
+}
+/** Existing labels that could be reused for the new object. */
+function findReusableLabels(baseName, context) {
+    try {
+        const words = baseName.replace(/([A-Z])/g, ' $1').trim();
+        const rows = context.symbolIndex.searchLabels(words, { language: 'en-US', limit: 5 });
+        if (rows.length > 0) {
+            return rows
+                .map(r => `  @${r.labelFileId}:${r.labelId} = "${r.text}" (${r.model})`)
+                .join('\n') + '\n_Reuse instead of creating duplicates (rule: labels before labels)._';
+        }
+    }
+    catch {
+        // ignore
+    }
+    return '(no matching labels — create new ones via labels)';
+}
+/** Mined property defaults for the object type (tables only for now). */
+function minedPropertyDefaults(objectType, context) {
+    if (objectType !== 'table')
+        return '';
+    try {
+        const idx = context.symbolIndex;
+        if (typeof idx.getPropertyPresenceRatio !== 'function')
+            return '';
+        const lines = [];
+        for (const prop of ['Label', 'TableGroup', 'PrimaryIndex', 'ClusteredIndex', 'AlternateKeyIndex']) {
+            const r = idx.getPropertyPresenceRatio('AxTable', prop);
+            if (r.total === 0)
+                continue;
+            lines.push(`  ${prop}: set by ${Math.round(r.ratio * 100)}% of standard tables${r.ratio >= 0.8 ? ' → REQUIRED' : ''}`);
+        }
+        const dist = idx.getPropertyValueDistribution('AxTable', 'TableGroup', 4);
+        if (dist.length > 0) {
+            const total = dist.reduce((s, d) => s + d.count, 0);
+            lines.push(`  TableGroup values: ${dist.map(d => `${d.value} (${Math.round((d.count / total) * 100)}%)`).join(', ')}`);
+        }
+        if (lines.length > 0) {
+            return lines.join('\n');
+        }
+    }
+    catch {
+        // ignore
+    }
+    return '(no mined statistics — run build-database to mine standard models)';
+}
+export async function prepareCreateTool(request, context) {
+    const raw = request?.params?.arguments ?? request;
+    const parsed = prepareCreateArgsSchema.safeParse(raw);
+    if (!parsed.success) {
+        return {
+            isError: true,
+            content: [{ type: 'text', text: `❌ Invalid parameters: ${parsed.error.message}` }],
+        };
+    }
+    const { goal, objectName, objectType, fieldsHint } = parsed.data;
+    const modelName = getConfigManager().getModelName() ?? undefined;
+    const prefix = resolveObjectPrefix(modelName ?? '');
+    const finalName = prefix ? applyObjectPrefix(objectName, prefix) : objectName;
+    // All lookups are synchronous index queries — run them in one tick.
+    const [collisions, naming, similar, edts, labels, propertyDefaults] = [
+        checkCollisions(finalName, objectName, context),
+        validateNaming(objectName, finalName, modelName),
+        findSimilarObjects(objectName, objectType, context),
+        fieldsHint && fieldsHint.length > 0 ? suggestEdtsForFields(fieldsHint, context) : '',
+        findReusableLabels(objectName, context),
+        minedPropertyDefaults(objectType, context),
+    ];
+    const token = createProvenanceToken({
+        goal,
+        objectName,
+        objectType,
+        proposedName: finalName,
+    });
+    const lines = [
+        `# prepare(mode="create") — ${objectType} \`${finalName}\``,
+        '',
+        `**Goal:** ${goal}`,
+        '',
+        '### Collision check _(symbol index)_',
+        collisions,
+        '',
+        '### Naming',
+        naming,
+        '',
+        '### Similar existing objects _(copy patterns from these)_',
+        similar,
+        '',
+    ];
+    if (edts) {
+        lines.push('### EDT suggestions for planned fields _(edt index)_', edts, '');
+    }
+    lines.push('### Reusable labels _(labels index)_', labels, '');
+    if (propertyDefaults) {
+        lines.push('### Property defaults _(mined from standard models)_', propertyDefaults, '');
+    }
+    // Surface existing code relevant to the goal; best-effort, omit on failure
+    try {
+        const ranked = rankContext(context, {
+            intent: `${goal} ${objectName} ${(fieldsHint ?? []).join(' ')}`,
+            activeObject: { name: objectName, type: objectType },
+        });
+        lines.push(...renderRankedContext(ranked), '');
+    }
+    catch {
+        // Additive — omit on failure.
+    }
+    lines.push('---');
+    lines.push(`**Grounding token:** \`${token}\``);
+    lines.push('');
+    lines.push('Next: generate the object, run `validate_code(mode="references")` + `validate_code(mode="syntax")` on the result, ' +
+        `then call \`d365fo_file(action="create", objectType="${objectType}", objectName="${objectName}", groundingToken=...)\`. ` +
+        'The token is bound to this object and expires in 30 minutes.');
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+    };
+}
+// Tool registration (name, description, inputSchema) lives inline in
+// src/server/mcpServer.ts - the single source of truth for tool instructions.
+//# sourceMappingURL=prepareCreate.js.map