d365fo-mcp 1.0.0

package/dist/workspace/contextRanker.js

@@ -0,0 +1,216 @@
+/**
+ * Context Ranker — Phase 2 of the context pipeline.
+ *
+ * Given a free-text intent (e.g. a prepare `goal`) and an optional active
+ * object, rank the most relevant symbols from the codebase and return a
+ * token-budgeted neighborhood that grounds the next generation step.
+ *
+ * Index-only and deterministic: candidates come from the FTS5 index, scoring
+ * uses precomputed xref/usage signals (no bridge call needed), and each item
+ * carries explainable `reasons`. Every index access is guarded so a
+ * missing/empty index yields an empty ranking rather than an error.
+ */
+import { isCustomModel } from '../utils/modelClassifier.js';
+const DEFAULT_LIMIT = 12;
+const DEFAULT_TOKEN_BUDGET = 700;
+const CANDIDATE_POOL = 40;
+// Small stoplist — generic verbs/nouns that carry no grounding signal.
+const STOPWORDS = new Set([
+    'add', 'new', 'the', 'and', 'for', 'with', 'this', 'that', 'from', 'into',
+    'use', 'using', 'create', 'change', 'modify', 'update', 'make', 'set', 'get',
+    'method', 'field', 'class', 'table', 'form', 'when', 'should', 'will', 'have',
+    'custom', 'object', 'value', 'code', 'logic', 'rule', 'enforce', 'extend',
+]);
+/** Split free text into meaningful lowercase tokens (≥3 chars, no stopwords). */
+export function tokenizeIntent(intent) {
+    const seen = new Set();
+    const out = [];
+    for (const raw of intent.toLowerCase().split(/[^a-z0-9]+/)) {
+        if (raw.length < 3 || STOPWORDS.has(raw) || seen.has(raw))
+            continue;
+        seen.add(raw);
+        out.push(raw);
+    }
+    return out;
+}
+/** Approximate token cost of a string (~4 chars/token). */
+function approxTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+function keyOf(s) {
+    return `${s.type}::${s.parentName ?? ''}::${s.name}`.toLowerCase();
+}
+/** Pull comma-separated index field into a lowercase token set. */
+function csvSet(value) {
+    const set = new Set();
+    if (!value)
+        return set;
+    for (const part of value.split(',')) {
+        const t = part.trim().toLowerCase();
+        if (t)
+            set.add(t);
+    }
+    return set;
+}
+/**
+ * Rank relevant symbols for an intent + optional active object.
+ * Returns a token-budgeted, explainable neighborhood. Never throws.
+ */
+export function rankContext(context, input) {
+    const limit = input.limit ?? DEFAULT_LIMIT;
+    const tokenBudget = input.tokenBudget ?? DEFAULT_TOKEN_BUDGET;
+    const tokens = tokenizeIntent(input.intent);
+    const activeName = input.activeObject?.name?.toLowerCase();
+    // Gather candidates from FTS (intent terms + active object name)
+    const pool = new Map();
+    const ftsRank = new Map(); // key -> best normalized FTS score
+    const addList = (list) => {
+        const n = list.length || 1;
+        list.forEach((sym, idx) => {
+            const k = keyOf(sym);
+            if (!pool.has(k))
+                pool.set(k, sym);
+            const norm = (n - idx) / n; // earlier hit → higher
+            ftsRank.set(k, Math.max(ftsRank.get(k) ?? 0, norm));
+        });
+    };
+    try {
+        if (tokens.length > 0) {
+            addList(context.symbolIndex.searchSymbols(tokens.join(' '), CANDIDATE_POOL, input.types));
+        }
+        if (input.activeObject?.name) {
+            addList(context.symbolIndex.searchSymbols(input.activeObject.name, 20, input.types));
+        }
+    }
+    catch {
+        // Index unavailable — return an empty, well-formed result.
+        return {
+            intent: input.intent,
+            activeObject: input.activeObject,
+            items: [],
+            truncated: false,
+            approxTokens: 0,
+        };
+    }
+    // Relationship anchors from the active object's own symbol.
+    let anchorRelated = new Set();
+    let anchorUsedTypes = new Set();
+    if (input.activeObject?.name) {
+        try {
+            const anchor = context.symbolIndex.getSymbolByName(input.activeObject.name, input.activeObject.type ?? 'class') ??
+                pool.get(keyOf({ name: input.activeObject.name, type: input.activeObject.type ?? 'class' }));
+            if (anchor) {
+                anchorRelated = csvSet(anchor.relatedMethods);
+                anchorUsedTypes = csvSet(anchor.usedTypes);
+            }
+        }
+        catch {
+            /* anchor optional */
+        }
+    }
+    // Score
+    const scored = [];
+    for (const [k, sym] of pool) {
+        // Drop the active object itself — it is the anchor, not its own neighbor.
+        if (activeName && sym.name.toLowerCase() === activeName && !sym.parentName)
+            continue;
+        const reasons = [];
+        let score = 0;
+        const fts = ftsRank.get(k) ?? 0;
+        if (fts > 0) {
+            score += fts * 3;
+            reasons.push('keyword match');
+        }
+        // Term overlap against name/signature/description/tags.
+        const haystack = `${sym.name} ${sym.signature ?? ''} ${sym.description ?? ''} ${sym.tags ?? ''}`.toLowerCase();
+        let overlap = 0;
+        for (const t of tokens)
+            if (haystack.includes(t))
+                overlap++;
+        if (overlap > 0) {
+            score += overlap * 1.5;
+            reasons.push(`${overlap} intent term${overlap > 1 ? 's' : ''}`);
+        }
+        // Popularity — well-used objects are better grounding anchors.
+        const popularity = Math.max(sym.usageFrequency ?? 0, sym.calledByCount ?? 0);
+        if (popularity > 0) {
+            score += Math.log10(1 + popularity);
+            reasons.push(`used ${popularity}×`);
+        }
+        // Prefer the developer's own code over Microsoft standard.
+        if (isCustomModel(sym.model)) {
+            score += 1;
+            reasons.push('custom model');
+        }
+        // Relationship to the active object.
+        const nameLc = sym.name.toLowerCase();
+        if (activeName) {
+            if (sym.parentName?.toLowerCase() === activeName) {
+                score += 2;
+                reasons.push(`member of ${input.activeObject.name}`);
+            }
+            if (anchorRelated.has(nameLc)) {
+                score += 1.5;
+                reasons.push('related method');
+            }
+            if (anchorUsedTypes.has(nameLc)) {
+                score += 1;
+                reasons.push('used by anchor');
+            }
+        }
+        if (score <= 0)
+            continue;
+        scored.push({
+            name: sym.name,
+            type: sym.type,
+            model: sym.model,
+            parentName: sym.parentName,
+            signature: sym.signature,
+            score: Math.round(score * 100) / 100,
+            reasons,
+        });
+    }
+    scored.sort((a, b) => b.score - a.score || a.name.localeCompare(b.name));
+    // Apply token budget + limit
+    const items = [];
+    let used = 0;
+    let truncated = false;
+    for (const item of scored) {
+        if (items.length >= limit) {
+            truncated = true;
+            break;
+        }
+        const cost = approxTokens(`${item.parentName ?? ''}.${item.name} ${item.signature ?? ''}`) + 6;
+        if (used + cost > tokenBudget && items.length > 0) {
+            truncated = true;
+            break;
+        }
+        items.push(item);
+        used += cost;
+    }
+    return {
+        intent: input.intent,
+        activeObject: input.activeObject,
+        items,
+        truncated,
+        approxTokens: used,
+    };
+}
+/** Render a ranked neighborhood as markdown lines for tool output. */
+export function renderRankedContext(ranked) {
+    if (ranked.items.length === 0) {
+        return ['### Related context _(ranked)_', '(no related objects found in the index)'];
+    }
+    const lines = ['### Related context _(ranked: FTS + xref signals)_'];
+    for (const item of ranked.items) {
+        const owner = item.parentName ? `${item.parentName}.` : '';
+        const sig = item.signature ? ` — ${item.signature}` : '';
+        lines.push(`  • ${owner}${item.name} [${item.type}, ${item.model}]${sig}`);
+        lines.push(`      ↳ ${item.reasons.join(', ')} (score ${item.score})`);
+    }
+    if (ranked.truncated) {
+        lines.push('  … (more candidates omitted to fit the context budget)');
+    }
+    return lines;
+}
+//# sourceMappingURL=contextRanker.js.map

package/dist/workspace/contextRanker.js.map

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

package/dist/workspace/contextSnapshot.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Workspace Context Snapshot
+ *
+ * Phase 1 of the "context pipeline": a single, curated snapshot of what the
+ * developer is currently working on. Assembled from the pieces the server
+ * already knows about — the config manager (model/project/env/roots), the
+ * symbol index (stats + freshness), the workspace scanner (recently edited
+ * objects by mtime) and git (uncommitted X++ changes).
+ *
+ * This module is the shared source of truth consumed by BOTH:
+ *   • the MCP resource layer (workspace://context, workspace://stats, …), and
+ *   • the get_workspace_info tool (its "Context Snapshot" section).
+ *
+ * It is deliberately pull-based and best-effort: every external call is guarded
+ * so a missing git binary, a non-repo workspace or an unbuilt index can never
+ * break the caller. MCP cannot push context into the model's prompt, so the
+ * value here is making a high-signal default context one cheap call away.
+ */
+import type { XppServerContext } from '../types/context.js';
+import type { WorkspaceFile } from './workspaceScanner.js';
+export interface RecentObject {
+    name: string;
+    type: WorkspaceFile['type'];
+    path: string;
+    modifiedAt: string;
+}
+/**
+ * Best-effort "what the developer is working on now". MCP exposes workspace
+ * roots, not editor focus, so this is the most-recently-modified X++ object —
+ * a good proxy for the active file, not a guarantee of editor cursor state.
+ */
+export type ActiveObject = RecentObject;
+export interface ContextSnapshot {
+    model: string | null;
+    modelSource: string;
+    projectPath: string | null;
+    workspacePath: string | null;
+    envType: string;
+    roots: string[];
+    index: {
+        totalSymbols: number;
+        byType: Record<string, number>;
+        indexedModels: string[];
+        lastIndexedAt: string | null;
+    };
+    /**
+     * Most-recently modified X++ object — proxy for the active file. Null when no
+     * workspace/files are detected. See ActiveObject for the editor-focus caveat.
+     */
+    activeObject: ActiveObject | null;
+    /** Most-recently edited X++ objects in the workspace (mtime desc). */
+    recentObjects: RecentObject[];
+    /** X++ files changed vs HEAD (uncommitted), relative to the repo root. */
+    uncommittedFiles: string[];
+    generatedAt: string;
+}
+/**
+ * Build the curated workspace context snapshot. Every section degrades
+ * gracefully — a failure in one source leaves the others intact.
+ */
+export declare function buildContextSnapshot(context: XppServerContext): Promise<ContextSnapshot>;
+/**
+ * Render the snapshot's "live" portion (recent objects + uncommitted changes)
+ * as markdown lines for embedding in get_workspace_info. Identity/prefix/index
+ * sections are already covered by that tool, so this only adds what is new.
+ */
+export declare function renderContextSnapshotSection(snapshot: ContextSnapshot): string[];
+//# sourceMappingURL=contextSnapshot.d.ts.map

package/dist/workspace/contextSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextSnapshot.d.ts","sourceRoot":"","sources":["../../src/workspace/contextSnapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAS3D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,CAAC;AAExC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC;IACF;;;OAGG;IACH,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,sEAAsE;IACtE,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AA8CD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAsF1B;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,EAAE,CAkChF"}

package/dist/workspace/contextSnapshot.js

@@ -0,0 +1,193 @@
+/**
+ * Workspace Context Snapshot
+ *
+ * Phase 1 of the "context pipeline": a single, curated snapshot of what the
+ * developer is currently working on. Assembled from the pieces the server
+ * already knows about — the config manager (model/project/env/roots), the
+ * symbol index (stats + freshness), the workspace scanner (recently edited
+ * objects by mtime) and git (uncommitted X++ changes).
+ *
+ * This module is the shared source of truth consumed by BOTH:
+ *   • the MCP resource layer (workspace://context, workspace://stats, …), and
+ *   • the get_workspace_info tool (its "Context Snapshot" section).
+ *
+ * It is deliberately pull-based and best-effort: every external call is guarded
+ * so a missing git binary, a non-repo workspace or an unbuilt index can never
+ * break the caller. MCP cannot push context into the model's prompt, so the
+ * value here is making a high-signal default context one cheap call away.
+ */
+import { execFile } from 'child_process';
+import util from 'util';
+import { getConfigManager } from '../utils/configManager.js';
+import { getStdioSessionInfo } from '../utils/stdioSessionInfo.js';
+const execFileAsync = util.promisify(execFile);
+/** How many recently-modified workspace objects to surface. */
+const RECENT_OBJECTS_LIMIT = 10;
+/** How many uncommitted files to surface. */
+const UNCOMMITTED_LIMIT = 25;
+/**
+ * Run a git command, returning trimmed stdout or null on any failure
+ * (git missing, not a repo, timeout). Never throws.
+ */
+async function gitSafe(args, cwd) {
+    try {
+        const { stdout } = await execFileAsync('git', args, {
+            cwd,
+            windowsHide: true,
+            maxBuffer: 1024 * 1024 * 10,
+            timeout: 15_000,
+        });
+        return stdout.trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List uncommitted X++ metadata files (.xml) relative to the repo containing
+ * `workspacePath`. Best-effort: returns [] when git is unavailable or the
+ * workspace is not a git repo.
+ */
+async function getUncommittedXppFiles(workspacePath) {
+    if (!workspacePath)
+        return [];
+    // diff HEAD covers staged+unstaged tracked changes; ls-files -o adds untracked files.
+    const tracked = await gitSafe(['diff', 'HEAD', '--name-only'], workspacePath);
+    const untracked = await gitSafe(['ls-files', '--others', '--exclude-standard'], workspacePath);
+    if (tracked === null && untracked === null)
+        return [];
+    const files = new Set();
+    for (const block of [tracked, untracked]) {
+        if (!block)
+            continue;
+        for (const line of block.split('\n')) {
+            const rel = line.trim();
+            if (rel && rel.toLowerCase().endsWith('.xml'))
+                files.add(rel);
+        }
+    }
+    return Array.from(files).slice(0, UNCOMMITTED_LIMIT);
+}
+/**
+ * Build the curated workspace context snapshot. Every section degrades
+ * gracefully — a failure in one source leaves the others intact.
+ */
+export async function buildContextSnapshot(context) {
+    const configManager = getConfigManager();
+    const { symbolIndex, workspaceScanner } = context;
+    // Identity (model / project / env)
+    let model = null;
+    let modelSource = 'unknown';
+    let projectPath = null;
+    let envType = 'unknown';
+    try {
+        const diag = await configManager.getWorkspaceInfoDiagnostics();
+        model = diag.modelName;
+        modelSource = diag.modelSource;
+        projectPath = diag.projectPath;
+    }
+    catch {
+        /* diagnostics best-effort */
+    }
+    try {
+        envType = await configManager.getDevEnvironmentType();
+    }
+    catch {
+        /* env type best-effort */
+    }
+    const workspacePath = configManager.getWorkspacePath() ||
+        process.env.D365FO_WORKSPACE_PATH ||
+        null;
+    const roots = getStdioSessionInfo().lastRoots ?? [];
+    // Index stats + freshness
+    const index = {
+        totalSymbols: 0,
+        byType: {},
+        indexedModels: [],
+        lastIndexedAt: null,
+    };
+    try {
+        // Off-thread + memoized — the synchronous count getters block the event
+        // loop for 30-60 s on a cold 2 GB DB, which would starve the MCP transport
+        // during the very first get_workspace_info call.
+        const counts = await symbolIndex.getSymbolCounts();
+        index.totalSymbols = counts.total;
+        index.byType = counts.byType;
+        index.indexedModels = Array.from(symbolIndex.getIndexedModels()).sort();
+        index.lastIndexedAt = symbolIndex.getLastIndexedAt?.() ?? null;
+    }
+    catch {
+        /* index may not be built yet */
+    }
+    // Recently-edited objects (mtime desc)
+    let recentObjects = [];
+    if (workspacePath) {
+        try {
+            const files = await workspaceScanner.scanWorkspace(workspacePath);
+            recentObjects = files
+                .slice()
+                .sort((a, b) => b.lastModified.getTime() - a.lastModified.getTime())
+                .slice(0, RECENT_OBJECTS_LIMIT)
+                .map((f) => ({
+                name: f.name,
+                type: f.type,
+                path: f.path,
+                modifiedAt: f.lastModified.toISOString(),
+            }));
+        }
+        catch {
+            /* scanning best-effort */
+        }
+    }
+    // Uncommitted X++ changes
+    const uncommittedFiles = await getUncommittedXppFiles(workspacePath);
+    return {
+        model,
+        modelSource,
+        projectPath,
+        workspacePath,
+        envType,
+        roots,
+        index,
+        activeObject: recentObjects[0] ?? null,
+        recentObjects,
+        uncommittedFiles,
+        generatedAt: new Date().toISOString(),
+    };
+}
+/**
+ * Render the snapshot's "live" portion (recent objects + uncommitted changes)
+ * as markdown lines for embedding in get_workspace_info. Identity/prefix/index
+ * sections are already covered by that tool, so this only adds what is new.
+ */
+export function renderContextSnapshotSection(snapshot) {
+    const lines = ['## Context Snapshot', ''];
+    if (snapshot.activeObject) {
+        const a = snapshot.activeObject;
+        lines.push(`Active object (most recently modified): ${a.name} [${a.type}] — ${a.modifiedAt.replace('T', ' ').slice(0, 16)}`, '');
+    }
+    if (snapshot.recentObjects.length === 0) {
+        lines.push('Recently edited objects: _none detected in the workspace_');
+    }
+    else {
+        lines.push('Recently edited objects (most recent first):');
+        for (const obj of snapshot.recentObjects) {
+            const when = obj.modifiedAt.replace('T', ' ').slice(0, 16);
+            lines.push(`  • ${obj.name.padEnd(40)} ${obj.type.padEnd(8)} ${when}`);
+        }
+    }
+    lines.push('');
+    if (snapshot.uncommittedFiles.length === 0) {
+        lines.push('Uncommitted X++ changes: _none (or workspace is not a git repo)_');
+    }
+    else {
+        lines.push(`Uncommitted X++ changes (${snapshot.uncommittedFiles.length}):`);
+        for (const f of snapshot.uncommittedFiles) {
+            lines.push(`  • ${f}`);
+        }
+        lines.push('');
+        lines.push('Review them with: review_workspace_changes');
+    }
+    return lines;
+}
+//# sourceMappingURL=contextSnapshot.js.map

package/dist/workspace/contextSnapshot.js.map

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

package/dist/workspace/hybridSearch.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Hybrid Search
+ * Combines external D365FO metadata index with local workspace files
+ */
+import type { XppSymbolIndex } from '../metadata/symbolIndex.js';
+import type { WorkspaceScanner, WorkspaceFile } from './workspaceScanner.js';
+import type { XppSymbol } from '../metadata/types.js';
+export interface HybridSearchResult {
+    source: 'external' | 'workspace';
+    symbol?: XppSymbol;
+    file?: WorkspaceFile;
+    relevance: number;
+}
+export declare class HybridSearch {
+    private symbolIndex;
+    private workspaceScanner;
+    constructor(symbolIndex: XppSymbolIndex, workspaceScanner: WorkspaceScanner);
+    /**
+     * Search in both external metadata and workspace
+     */
+    search(query: string, options?: {
+        types?: Array<'class' | 'table' | 'form' | 'method' | 'field' | 'enum' | 'query' | 'view'>;
+        limit?: number;
+        workspacePath?: string;
+        includeWorkspace?: boolean;
+    }): Promise<HybridSearchResult[]>;
+    /**
+     * Search patterns in workspace code
+     */
+    searchPatterns(scenario: string, workspacePath: string): Promise<{
+        externalPatterns: any[];
+        workspaceMatches: WorkspaceFile[];
+    }>;
+    /**
+     * Calculate relevance score
+     */
+    private calculateRelevance;
+}
+//# sourceMappingURL=hybridSearch.d.ts.map

package/dist/workspace/hybridSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybridSearch.d.ts","sourceRoot":"","sources":["../../src/workspace/hybridSearch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;IACjC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,YAAY;IAErB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,gBAAgB;IAF1B,YACU,WAAW,EAAE,cAAc,EAC3B,gBAAgB,EAAE,gBAAgB,EACxC;IAEJ;;OAEG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;QAC3F,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;KACvB,GACL,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA2D/B;IAED;;OAEG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC;QACT,gBAAgB,EAAE,GAAG,EAAE,CAAC;QACxB,gBAAgB,EAAE,aAAa,EAAE,CAAC;KACnC,CAAC,CAcD;IAED;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAoB3B"}

package/dist/workspace/hybridSearch.js

@@ -0,0 +1,96 @@
+/**
+ * Hybrid Search
+ * Combines external D365FO metadata index with local workspace files
+ */
+import { levenshteinDistance } from '../utils/fuzzyMatching.js';
+export class HybridSearch {
+    symbolIndex;
+    workspaceScanner;
+    constructor(symbolIndex, workspaceScanner) {
+        this.symbolIndex = symbolIndex;
+        this.workspaceScanner = workspaceScanner;
+    }
+    /**
+     * Search in both external metadata and workspace
+     */
+    async search(query, options = {}) {
+        const results = [];
+        // External metadata (D365FO PackagesLocalDirectory)
+        const externalSymbols = this.symbolIndex.searchSymbols(query, options.limit || 20, options.types);
+        for (const symbol of externalSymbols) {
+            results.push({
+                source: 'external',
+                symbol,
+                relevance: this.calculateRelevance(query, symbol.name),
+            });
+        }
+        // Workspace files, if a workspace path was provided
+        if (options.includeWorkspace && options.workspacePath) {
+            const workspaceFiles = await this.workspaceScanner.searchInWorkspace(options.workspacePath, query, options.types?.[0] // Use first type for workspace filter
+            );
+            for (const file of workspaceFiles) {
+                results.push({
+                    source: 'workspace',
+                    file,
+                    relevance: this.calculateRelevance(query, file.name),
+                });
+            }
+        }
+        results.sort((a, b) => b.relevance - a.relevance);
+        // Deduplicate by name, preferring workspace over external.
+        const seen = new Set();
+        const deduplicated = [];
+        for (const result of results) {
+            const name = result.symbol?.name || result.file?.name;
+            if (!name)
+                continue;
+            if (!seen.has(name)) {
+                seen.add(name);
+                deduplicated.push(result);
+            }
+            else if (result.source === 'workspace') {
+                const idx = deduplicated.findIndex((r) => (r.symbol?.name || r.file?.name) === name);
+                if (idx !== -1) {
+                    deduplicated[idx] = result;
+                }
+            }
+        }
+        return deduplicated.slice(0, options.limit || 20);
+    }
+    /**
+     * Search patterns in workspace code
+     */
+    async searchPatterns(scenario, workspacePath) {
+        // Get patterns from external metadata
+        const externalPatterns = this.symbolIndex.analyzeCodePatterns(scenario);
+        // Search workspace for matching files
+        const workspaceMatches = await this.workspaceScanner.searchInWorkspace(workspacePath, scenario);
+        return {
+            externalPatterns,
+            workspaceMatches,
+        };
+    }
+    /**
+     * Calculate relevance score
+     */
+    calculateRelevance(query, name) {
+        const q = query.toLowerCase();
+        const n = name.toLowerCase();
+        // Exact match = 100
+        if (n === q)
+            return 100;
+        // Starts with = 80
+        if (n.startsWith(q))
+            return 80;
+        // Contains = 50
+        if (n.includes(q))
+            return 50;
+        // Fuzzy match: scale continuously by similarity instead of a flat 30
+        const distance = levenshteinDistance(q, n);
+        const similarity = 1 - distance / Math.max(q.length, n.length);
+        if (similarity >= 0.65)
+            return Math.round(20 + similarity * 30); // 40–50 range
+        return 10;
+    }
+}
+//# sourceMappingURL=hybridSearch.js.map

package/dist/workspace/hybridSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybridSearch.js","sourceRoot":"","sources":["../../src/workspace/hybridSearch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAShE,MAAM,OAAO,YAAY;IAEb,WAAW;IACX,gBAAgB;IAF1B,YACU,WAA2B,EAC3B,gBAAkC;2BADlC,WAAW;gCACX,gBAAgB;IACvB,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,KAAa,EACb,OAAO,GAKH,EAAE;QAEN,MAAM,OAAO,GAAyB,EAAE,CAAC;QAEzC,oDAAoD;QACpD,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,CAAC,aAAa,CACpD,KAAK,EACL,OAAO,CAAC,KAAK,IAAI,EAAE,EACnB,OAAO,CAAC,KAAK,CACd,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM,EAAE,UAAU;gBAClB,MAAM;gBACN,SAAS,EAAE,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC;aACvD,CAAC,CAAC;QACL,CAAC;QAED,oDAAoD;QACpD,IAAI,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YACtD,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAClE,OAAO,CAAC,aAAa,EACrB,KAAK,EACL,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAQ,CAAC,sCAAsC;aACjE,CAAC;YAEF,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;gBAClC,OAAO,CAAC,IAAI,CAAC;oBACX,MAAM,EAAE,WAAW;oBACnB,IAAI;oBACJ,SAAS,EAAE,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC;iBACrD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;QAElD,2DAA2D;QAC3D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,YAAY,GAAyB,EAAE,CAAC;QAE9C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC;YACtD,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACf,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;iBAAM,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBACzC,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,CACjD,CAAC;gBACF,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;oBACf,YAAY,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,QAAgB,EAChB,aAAqB;QAKrB,sCAAsC;QACtC,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAExE,sCAAsC;QACtC,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CACpE,aAAa,EACb,QAAQ,CACT,CAAC;QAEF,OAAO;YACL,gBAAgB;YAChB,gBAAgB;SACjB,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,KAAa,EAAE,IAAY;QACpD,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAE7B,oBAAoB;QACpB,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QAExB,mBAAmB;QACnB,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QAE/B,gBAAgB;QAChB,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QAE7B,qEAAqE;QACrE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QAC/D,IAAI,UAAU,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC,cAAc;QAE/E,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}