d365fo-mcp 1.0.0

package/dist/utils/provenanceStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenanceStore.d.ts","sourceRoot":"","sources":["../../src/utils/provenanceStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,iBAAiB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAwDD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CA0BxE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAY/E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,EACxB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAWT;AAaD,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,oBAAoB,EAAE,MAAM,EAC5B,gBAAgB,CAAC,EAAE,MAAM,GACxB;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,CAyDrE"}

package/dist/utils/provenanceStore.js

@@ -0,0 +1,203 @@
+/**
+ * In-memory provenance store for grounding tokens.
+ *
+ * A grounding token proves that the model queried the real D365FO codebase
+ * (via prepare_change) before generating extension code. Tokens expire after
+ * TTL_MS to prevent stale context being reused across sessions.
+ *
+ * Enforcement: when GROUNDING_ENFORCE=true, extension patterns in generate_object(mode="pattern")
+ * and extension objectTypes in create_d365fo_file will reject calls without a
+ * valid token.
+ */
+import crypto from 'crypto';
+import { SERVER_MODE } from '../server/serverMode.js';
+const TTL_MS = 30 * 60 * 1000; // 30 minutes
+const store = new Map();
+function prune() {
+    const now = Date.now();
+    for (const [key, bundle] of store.entries()) {
+        if (bundle.expiresAt < now)
+            store.delete(key);
+    }
+}
+// Signed (portable) tokens: the in-memory store only works when the SAME
+// process issues and validates a token, which breaks in hybrid deployments
+// (separate read-only/write-only instances) or scaled-out App Service. When
+// GROUNDING_SECRET is set on all instances, tokens are HMAC-signed and carry
+// their own object binding + expiry, so any process holding the secret can
+// validate them statelessly.
+const SIGNED_PREFIX = 'g1.';
+function getGroundingSecret() {
+    return process.env.GROUNDING_SECRET?.trim() || null;
+}
+function signPayload(payload, secret) {
+    return crypto.createHmac('sha256', secret).update(payload).digest('base64url').slice(0, 24);
+}
+/** Verify a signed token and reconstruct a minimal bundle from its payload. */
+function verifySignedToken(token) {
+    const secret = getGroundingSecret();
+    if (!secret || !token.startsWith(SIGNED_PREFIX))
+        return undefined;
+    const parts = token.slice(SIGNED_PREFIX.length).split('.');
+    if (parts.length !== 2)
+        return undefined;
+    const [payload, mac] = parts;
+    const expected = signPayload(payload, secret);
+    const macBuf = Buffer.from(mac);
+    const expectedBuf = Buffer.from(expected);
+    if (macBuf.length !== expectedBuf.length || !crypto.timingSafeEqual(macBuf, expectedBuf)) {
+        return undefined;
+    }
+    let decoded;
+    try {
+        decoded = JSON.parse(Buffer.from(payload, 'base64url').toString('utf8'));
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof decoded.e !== 'number' || decoded.e < Date.now())
+        return undefined;
+    return {
+        token,
+        context: { goal: '(signed token)', objectName: decoded.o ?? '', proposedName: decoded.p },
+        timestamp: decoded.e - TTL_MS,
+        expiresAt: decoded.e,
+    };
+}
+export function createProvenanceToken(context) {
+    prune();
+    const now = Date.now();
+    const expiresAt = now + TTL_MS;
+    const secret = getGroundingSecret();
+    let token;
+    if (secret) {
+        // Portable HMAC token: payload carries object binding + expiry so another
+        // process can validate it.
+        const payload = Buffer.from(JSON.stringify({
+            o: context.objectName,
+            ...(context.proposedName ? { p: context.proposedName } : {}),
+            e: expiresAt,
+        }), 'utf8').toString('base64url');
+        token = `${SIGNED_PREFIX}${payload}.${signPayload(payload, secret)}`;
+    }
+    else {
+        const payload = `${context.goal}:${context.objectName}:${context.methodName ?? ''}:${now}`;
+        token = crypto.createHash('sha256').update(payload).digest('hex').slice(0, 32);
+    }
+    store.set(token, {
+        token,
+        context,
+        timestamp: now,
+        expiresAt,
+    });
+    return token;
+}
+export function getProvenanceBundle(token) {
+    prune();
+    const bundle = store.get(token);
+    if (bundle) {
+        if (bundle.expiresAt < Date.now()) {
+            store.delete(token);
+            return undefined;
+        }
+        return bundle;
+    }
+    // Not issued by this process — try stateless validation of a signed token.
+    return verifySignedToken(token);
+}
+export function isValidToken(token) {
+    return getProvenanceBundle(token) !== undefined;
+}
+/**
+ * Check that a token was issued for the object actually being written.
+ *
+ * A token issued for `CustTable` is accepted for targets that EMBED that name
+ * at the start (`CustTable.ContosoExtension`, `CustTableContoso_Extension`, …)
+ * and for the proposedName recorded by prepare_change. D365FO extension naming
+ * always leads with the base object name, so a prefix match is used rather
+ * than a bare substring match. Names shorter than 4 chars are compared exactly
+ * to avoid trivial matches.
+ */
+export function tokenMatchesTarget(bundle, targetObjectName) {
+    const target = targetObjectName.trim().toLowerCase();
+    if (!target)
+        return true;
+    const candidates = [bundle.context.objectName, bundle.context.proposedName]
+        .filter((c) => !!c)
+        .map(c => c.trim().toLowerCase());
+    return candidates.some(c => {
+        if (c === target)
+            return true;
+        if (c.length < 4 || target.length < 4)
+            return false;
+        return target.startsWith(c) || c.startsWith(target);
+    });
+}
+/**
+ * Enforce grounding for extension write operations.
+ *
+ * Returns an error result if GROUNDING_ENFORCE=true is set in the environment AND:
+ *   - no valid grounding token was provided, OR
+ *   - the token was issued for a different object than `targetObjectName`.
+ *
+ * Returns null when enforcement passes (either disabled or token is valid).
+ */
+let warnedWriteOnlyBypass = false;
+export function enforceGrounding(groundingToken, operationDescription, targetObjectName) {
+    if (process.env.GROUNDING_ENFORCE !== 'true')
+        return null;
+    // Hybrid-deployment guard: in write-only mode prepare_change runs on a
+    // separate read-only instance. Without a shared GROUNDING_SECRET, no token
+    // issued there can ever validate here, so enforcing would dead-loop the
+    // agent between the two servers. With a shared secret, tokens are verified
+    // statelessly and this bypass is unnecessary.
+    if (SERVER_MODE === 'write-only' && !getGroundingSecret()) {
+        if (!warnedWriteOnlyBypass) {
+            warnedWriteOnlyBypass = true;
+            console.error('[provenance] ⚠️ GROUNDING_ENFORCE=true is ignored in write-only mode — ' +
+                'prepare(mode="change") tokens are issued by the read-only instance and cannot be ' +
+                'validated in this process. To enforce grounding in hybrid deployments, set the ' +
+                'same GROUNDING_SECRET on both instances; otherwise remove GROUNDING_ENFORCE ' +
+                'from the local companion .env.');
+        }
+        return null;
+    }
+    if (groundingToken && isValidToken(groundingToken)) {
+        if (!targetObjectName)
+            return null;
+        const bundle = getProvenanceBundle(groundingToken);
+        if (tokenMatchesTarget(bundle, targetObjectName))
+            return null;
+        return {
+            isError: true,
+            content: [{
+                    type: 'text',
+                    text: `❌ Grounding token mismatch for ${operationDescription} (GROUNDING_ENFORCE=true).\n\n` +
+                        `The provided token was issued for object \`${bundle.context.objectName}\`` +
+                        (bundle.context.proposedName ? ` (proposed: \`${bundle.context.proposedName}\`)` : '') +
+                        `, but this call targets \`${targetObjectName}\`.\n\n` +
+                        `**Required workflow:**\n` +
+                        `1. Call \`prepare(mode="change", goal="...", objectName="${targetObjectName}")\` for THIS object.\n` +
+                        `2. Pass the returned \`groundingToken\` to this tool.\n\n` +
+                        `Tokens are object-bound — one token cannot authorize writes to a different object.`,
+                }],
+        };
+    }
+    const reason = groundingToken
+        ? 'the provided groundingToken has expired or is invalid'
+        : 'no groundingToken was provided';
+    return {
+        isError: true,
+        content: [{
+                type: 'text',
+                text: `❌ Grounding required for ${operationDescription} (GROUNDING_ENFORCE=true).\n\n` +
+                    `Reason: ${reason}.\n\n` +
+                    `**Required workflow:**\n` +
+                    `1. Call \`prepare(mode="change", goal="...", objectName="...")\` to gather facts from the D365FO index.\n` +
+                    `2. Pass the returned \`groundingToken\` as a parameter to this tool.\n\n` +
+                    `This ensures generated extension code is grounded in your actual codebase, not AI training data.\n\n` +
+                    `To disable enforcement (direct API / human use): set \`GROUNDING_ENFORCE=false\` in the server .env.`,
+            }],
+    };
+}
+//# sourceMappingURL=provenanceStore.js.map

package/dist/utils/provenanceStore.js.map

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

package/dist/utils/richContext.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Rich Context Utilities
+ * Enhance tool responses with related suggestions, patterns, and tips
+ */
+import type { XppSymbol } from '../metadata/types.js';
+export interface RichContextOptions {
+    includeRelated?: boolean;
+    includePatterns?: boolean;
+    includeTips?: boolean;
+    maxSuggestions?: number;
+}
+export interface RelatedSearch {
+    query: string;
+    reason: string;
+}
+export interface CommonPattern {
+    pattern: string;
+    frequency?: number;
+}
+export interface ContextualTip {
+    tip: string;
+    tool?: string;
+}
+export interface RichContext {
+    relatedSearches?: RelatedSearch[];
+    commonPatterns?: CommonPattern[];
+    tips?: ContextualTip[];
+}
+/**
+ * Generate related search suggestions based on query and results
+ */
+export declare function generateRelatedSearches(query: string, results: XppSymbol[], maxSuggestions?: number): RelatedSearch[];
+/**
+ * Detect common patterns in search results
+ */
+export declare function detectCommonPatterns(results: XppSymbol[]): CommonPattern[];
+/**
+ * Generate contextual tips based on query and results
+ */
+export declare function generateContextualTips(query: string, results: XppSymbol[], searchType?: string): ContextualTip[];
+/**
+ * Format rich context as markdown text
+ */
+export declare function formatRichContext(_query: string, results: XppSymbol[], richContext: RichContext, options?: RichContextOptions): string;
+//# sourceMappingURL=richContext.d.ts.map

package/dist/utils/richContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"richContext.d.ts","sourceRoot":"","sources":["../../src/utils/richContext.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;IAClC,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,EAAE,EACpB,cAAc,GAAE,MAAU,GACzB,aAAa,EAAE,CAoGjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,aAAa,EAAE,CAwF1E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,EAAE,EACpB,UAAU,CAAC,EAAE,MAAM,GAClB,aAAa,EAAE,CAmEjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,SAAS,EAAE,EACpB,WAAW,EAAE,WAAW,EACxB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CA2CR"}

package/dist/utils/richContext.js

@@ -0,0 +1,316 @@
+/**
+ * Rich Context Utilities
+ * Enhance tool responses with related suggestions, patterns, and tips
+ */
+/**
+ * Generate related search suggestions based on query and results
+ */
+export function generateRelatedSearches(query, results, maxSuggestions = 5) {
+    const suggestions = [];
+    const queryLower = query.toLowerCase();
+    const classResults = results.filter(r => r.type === 'class');
+    const tableResults = results.filter(r => r.type === 'table');
+    if (classResults.length > 0) {
+        const firstClass = classResults[0];
+        if (firstClass.extendsClass && firstClass.extendsClass !== 'Object') {
+            suggestions.push({
+                query: firstClass.extendsClass,
+                reason: `Base class of ${firstClass.name}`
+            });
+        }
+        if (!queryLower.includes('helper') && firstClass.name.includes('Table')) {
+            const helperQuery = firstClass.name.replace('Table', 'Helper');
+            suggestions.push({
+                query: helperQuery,
+                reason: 'Helper class for common operations'
+            });
+        }
+        if (!queryLower.includes('service')) {
+            suggestions.push({
+                query: `${query} service`,
+                reason: 'Service classes for business logic'
+            });
+        }
+    }
+    if (tableResults.length > 0 && !queryLower.includes('line')) {
+        suggestions.push({
+            query: `${query}Line`,
+            reason: 'Related line table'
+        });
+    }
+    if (queryLower.includes('dimension')) {
+        if (!queryLower.includes('helper')) {
+            suggestions.push({
+                query: 'dimension helper',
+                reason: 'Helper classes for dimension operations'
+            });
+        }
+        if (!queryLower.includes('validation')) {
+            suggestions.push({
+                query: 'dimension validation',
+                reason: 'Validation patterns for dimensions'
+            });
+        }
+        if (!queryLower.includes('ledger') && !queryLower.includes('financial')) {
+            suggestions.push({
+                query: 'ledger dimension',
+                reason: 'Ledger-specific dimension classes'
+            });
+        }
+    }
+    if (queryLower.includes('cust') && !queryLower.includes('vend')) {
+        suggestions.push({
+            query: query.replace(/cust/gi, 'Vend'),
+            reason: 'Vendor equivalent'
+        });
+    }
+    if (queryLower.includes('sales') && !queryLower.includes('purch')) {
+        suggestions.push({
+            query: query.replace(/sales/gi, 'Purch'),
+            reason: 'Purchase equivalent'
+        });
+    }
+    if (results.length > 15) {
+        suggestions.push({
+            query: `${query} helper`,
+            reason: 'Narrow down to helper classes'
+        });
+    }
+    if (results.length === 0 || results.length < 3) {
+        const broaderQuery = queryLower.split(/\s+/)[0]; // first word only
+        if (broaderQuery !== queryLower) {
+            suggestions.push({
+                query: broaderQuery,
+                reason: 'Broader search term'
+            });
+        }
+    }
+    if (results.length > 0 && !queryLower.includes('custom')) {
+        suggestions.push({
+            query: `search(scope="extensions") for "${query}"`,
+            reason: 'Find custom/ISV extensions'
+        });
+    }
+    return suggestions.slice(0, maxSuggestions);
+}
+/**
+ * Detect common patterns in search results
+ */
+export function detectCommonPatterns(results) {
+    const patterns = [];
+    if (results.length === 0)
+        return patterns;
+    const baseClasses = new Map();
+    results.forEach(r => {
+        if (r.extendsClass && r.extendsClass !== 'Object') {
+            baseClasses.set(r.extendsClass, (baseClasses.get(r.extendsClass) || 0) + 1);
+        }
+    });
+    const mostCommonBase = Array.from(baseClasses.entries())
+        .sort((a, b) => b[1] - a[1])[0];
+    if (mostCommonBase && mostCommonBase[1] > 1) {
+        patterns.push({
+            pattern: `${mostCommonBase[1]} classes extend ${mostCommonBase[0]}`,
+            frequency: mostCommonBase[1]
+        });
+    }
+    const hasHelperClasses = results.some(r => r.name.includes('Helper'));
+    const hasServiceClasses = results.some(r => r.name.includes('Service'));
+    const hasControllerClasses = results.some(r => r.name.includes('Controller'));
+    if (hasHelperClasses) {
+        patterns.push({
+            pattern: 'Helper classes found - typically contain reusable utility methods'
+        });
+    }
+    if (hasServiceClasses) {
+        patterns.push({
+            pattern: 'Service classes found - typically contain business logic'
+        });
+    }
+    if (hasControllerClasses) {
+        patterns.push({
+            pattern: 'Controller classes found - typically handle UI/form logic'
+        });
+    }
+    const apiPatterns = results
+        .filter(r => r.apiPatterns)
+        .map(r => r.apiPatterns)
+        .filter(Boolean);
+    if (apiPatterns.length > 0) {
+        const initPatterns = apiPatterns
+            .flatMap(p => {
+            try {
+                const parsed = JSON.parse(p);
+                return parsed.initialization || [];
+            }
+            catch {
+                return [];
+            }
+        })
+            .filter(Boolean);
+        if (initPatterns.length > 0) {
+            const mostCommon = initPatterns[0];
+            patterns.push({
+                pattern: `Common initialization: ${mostCommon}`
+            });
+        }
+    }
+    const typicalUsages = results
+        .filter(r => r.typicalUsages)
+        .map(r => r.typicalUsages)
+        .filter(Boolean);
+    if (typicalUsages.length > 0) {
+        try {
+            const usages = JSON.parse(typicalUsages[0]);
+            if (Array.isArray(usages) && usages.length > 0) {
+                patterns.push({
+                    pattern: `Typical usage: ${usages[0]}`
+                });
+            }
+        }
+        catch {
+            // Ignore parse errors
+        }
+    }
+    return patterns;
+}
+/**
+ * Generate contextual tips based on query and results
+ */
+export function generateContextualTips(query, results, searchType) {
+    const tips = [];
+    const queryLower = query.toLowerCase();
+    if (results.length === 0) {
+        tips.push({
+            tip: 'Try a broader search term or use wildcard patterns (e.g., "Dim*" for all classes starting with Dim)'
+        });
+        tips.push({
+            tip: 'Use search(scope="extensions") to search only in custom/ISV code',
+            tool: 'search'
+        });
+        if (queryLower.length < 3) {
+            tips.push({
+                tip: 'Search terms shorter than 3 characters may not yield results. Try a longer term.'
+            });
+        }
+        return tips;
+    }
+    const classResults = results.filter(r => r.type === 'class');
+    const methodResults = results.filter(r => r.type === 'method');
+    if (classResults.length > 0) {
+        const firstClass = classResults[0];
+        tips.push({
+            tip: `Use get_object_info(objectType="class", name="${firstClass.name}") for full method signatures and inheritance chain`,
+            tool: 'get_object_info'
+        });
+        tips.push({
+            tip: `Use get_object_info(objectType="class", name="${firstClass.name}", options={members:"names"}) for an IntelliSense-style method/field list`,
+            tool: 'get_object_info'
+        });
+        if (firstClass.usageFrequency && firstClass.usageFrequency > 10) {
+            tips.push({
+                tip: `Use analyze_code(mode="api-usage", apiName="${firstClass.name}") to see how this frequently-used class is initialized and used`,
+                tool: 'analyze_code'
+            });
+        }
+    }
+    if (methodResults.length > 0) {
+        tips.push({
+            tip: 'Use get_object_info(objectType="class", name=...) to see full method implementation and parameters'
+        });
+    }
+    if (searchType === 'all' && results.length > 15) {
+        tips.push({
+            tip: 'Too many results? Use type parameter to filter: type="class", type="table", type="method"'
+        });
+    }
+    const hasHelpers = results.some(r => r.name.includes('Helper'));
+    if (hasHelpers) {
+        tips.push({
+            tip: 'Helper classes often have validate(), find(), and create() methods. Use analyze_code(mode="completeness", className=...) to check for missing patterns',
+            tool: 'analyze_code'
+        });
+    }
+    return tips;
+}
+/**
+ * Format rich context as markdown text
+ */
+export function formatRichContext(_query, results, richContext, options = {}) {
+    let output = '';
+    const resultGroups = groupResultsByType(results);
+    for (const [type, items] of Object.entries(resultGroups)) {
+        if (items.length === 0)
+            continue;
+        output += `\n## ${type.toUpperCase()} (${items.length})\n\n`;
+        items.slice(0, 10).forEach(item => {
+            output += formatSymbolWithMetadata(item);
+        });
+        if (items.length > 10) {
+            output += `\n... and ${items.length - 10} more. Use larger limit to see all.\n`;
+        }
+    }
+    if (options.includeRelated !== false && richContext.relatedSearches && richContext.relatedSearches.length > 0) {
+        output += '\n\n## 🔍 Related Searches\n';
+        richContext.relatedSearches.forEach(rel => {
+            output += `\n• **"${rel.query}"** - ${rel.reason}`;
+        });
+    }
+    if (options.includePatterns !== false && richContext.commonPatterns && richContext.commonPatterns.length > 0) {
+        output += '\n\n## 💡 Common Patterns\n';
+        richContext.commonPatterns.forEach(pattern => {
+            const freq = pattern.frequency ? ` (found ${pattern.frequency}×)` : '';
+            output += `\n• ${pattern.pattern}${freq}`;
+        });
+    }
+    if (options.includeTips !== false && richContext.tips && richContext.tips.length > 0) {
+        output += '\n\n## 📌 Tips\n';
+        richContext.tips.forEach(tip => {
+            const toolHint = tip.tool ? ` → Use \`${tip.tool}()\`` : '';
+            output += `\n• ${tip.tip}${toolHint}`;
+        });
+    }
+    return output;
+}
+/**
+ * Group results by type.
+ *
+ * Groups are built dynamically from the types actually present — a hardcoded
+ * group list silently dropped every other type (form, query, view, report,
+ * security-*, menu-item-*, *-extension) from the rendered output while the
+ * header still claimed the full match count.
+ */
+const TYPE_DISPLAY_ORDER = ['class', 'table', 'method', 'field', 'enum', 'edt'];
+function groupResultsByType(results) {
+    const groups = {};
+    for (const type of TYPE_DISPLAY_ORDER)
+        groups[type] = [];
+    results.forEach(r => {
+        (groups[r.type] ??= []).push(r);
+    });
+    return groups;
+}
+/**
+ * Format a single symbol with rich metadata
+ */
+function formatSymbolWithMetadata(symbol) {
+    let output = `📦 **${symbol.name}**\n`;
+    if (symbol.parentName) {
+        output += `   └─ Parent: ${symbol.parentName}\n`;
+    }
+    if (symbol.extendsClass && symbol.extendsClass !== 'Object') {
+        output += `   └─ Extends: ${symbol.extendsClass}\n`;
+    }
+    if (symbol.signature) {
+        output += `   └─ Signature: ${symbol.signature}\n`;
+    }
+    if (symbol.description) {
+        output += `   └─ ${symbol.description}\n`;
+    }
+    if (symbol.usageFrequency && symbol.usageFrequency > 5) {
+        output += `   └─ ⭐ Frequently used (${symbol.usageFrequency} references)\n`;
+    }
+    output += '\n';
+    return output;
+}
+//# sourceMappingURL=richContext.js.map

package/dist/utils/richContext.js.map

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