d365fo-mcp 1.0.0

package/dist/metadata/formPatternMiner.js

@@ -0,0 +1,220 @@
+/**
+ * Form Design tree walker shared by the XML parser (extraction), the form
+ * pattern validator, and the pattern mining pipeline.
+ *
+ * Input is the <Design> node of an AxForm parsed with xml2js options
+ * { explicitArray: false, mergeAttrs: true, trim: true } — i.e. single
+ * children are plain objects, repeated children are arrays, and attributes
+ * (notably i:type) are merged as keys.
+ *
+ * Real AxForm XML nests controls as:
+ *   <Design>
+ *     <Pattern>SimpleList</Pattern>
+ *     <PatternVersion>1.1</PatternVersion>
+ *     <Controls>
+ *       <AxFormControl i:type="AxFormActionPaneControl">
+ *         <Name>ActionPane</Name>
+ *         <Type>ActionPane</Type>
+ *         <Controls>...</Controls>
+ *       </AxFormControl>
+ *     </Controls>
+ *   </Design>
+ *
+ * Container controls carry their own <Pattern>/<PatternVersion> (sub-patterns).
+ * Extension controls (QuickFilter etc.) are plain <AxFormControl> without an
+ * i:type, identified by <FormControlExtension><Name>.
+ */
+/** Control/Design properties surfaced into `properties` (when present as simple values) */
+const PROPERTY_KEYS = [
+    'Caption',
+    'Visible',
+    'Enabled',
+    'AutoDeclaration',
+    'DataSource',
+    'DataField',
+    'DataMethod',
+    'HelpText',
+    'Label',
+    'Width',
+    'Height',
+    'AllowEdit',
+    'Mandatory',
+    'Style',
+    'TitleDataSource',
+    'ArrangeMethod',
+    'MultiSelect',
+    'ShowRowLabels',
+    'WidthMode',
+    'HeightMode',
+];
+function asString(value) {
+    if (typeof value === 'string' && value.length > 0)
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    // Elements that carry attributes (e.g. <Pattern xmlns="">SimpleList</Pattern>)
+    // parse with mergeAttrs into { _: 'SimpleList', xmlns: '' } — text is under '_'.
+    if (value && typeof value === 'object' && typeof value._ === 'string') {
+        const text = value._;
+        return text.length > 0 ? text : undefined;
+    }
+    return undefined;
+}
+/** Wrap single xml2js children (explicitArray:false) into arrays; drop empty-string placeholders from empty elements. */
+function asArray(value) {
+    if (value === undefined || value === null)
+        return [];
+    if (Array.isArray(value))
+        return value;
+    if (typeof value === 'string' && value === '')
+        return [];
+    return [value];
+}
+/**
+ * Extension control type names that end in 'Control' and must NOT have the suffix stripped,
+ * because they are identified by that full name via FormControlExtension.Name in the validator.
+ */
+const EXTENSION_CONTROL_NAMES = new Set(['QuickFilterControl', 'SegmentedEntryControl']);
+/**
+ * 'AxFormGridControl' → 'Grid', 'AxFormActionPaneControl' → 'ActionPane', 'AxFormControl' → ''
+ * Exception: extension controls like 'QuickFilterControl' keep their full suffix so they
+ * match FormControlExtension.Name lookups used by the form pattern validator.
+ */
+export function normalizeControlType(axType) {
+    if (!axType)
+        return '';
+    let t = axType;
+    if (t.startsWith('AxForm'))
+        t = t.slice('AxForm'.length);
+    if (t.endsWith('Control') && !EXTENSION_CONTROL_NAMES.has(t))
+        t = t.slice(0, -'Control'.length);
+    return t;
+}
+/** Resolve the display type of a control node: i:type → <Type> element → extension name → 'Control'. */
+function resolveControlType(node) {
+    const axType = asString(node['i:type']);
+    const fromAxType = normalizeControlType(axType);
+    if (fromAxType)
+        return { type: fromAxType, axType };
+    const typeElement = asString(node.Type);
+    if (typeElement)
+        return { type: typeElement, axType };
+    const extension = node.FormControlExtension;
+    if (extension && typeof extension === 'object' && extension['i:nil'] !== 'true') {
+        const extName = asString(extension.Name);
+        if (extName)
+            return { type: extName, axType };
+    }
+    return { type: 'Control', axType };
+}
+function extractControlNode(node) {
+    if (!node || typeof node !== 'object')
+        return null;
+    const { type, axType } = resolveControlType(node);
+    const control = {
+        name: asString(node.Name) ?? 'Unknown',
+        type,
+        properties: {},
+        children: [],
+    };
+    if (axType)
+        control.axType = axType;
+    const pattern = asString(node.Pattern);
+    if (pattern)
+        control.pattern = pattern;
+    const patternVersion = asString(node.PatternVersion);
+    if (patternVersion)
+        control.patternVersion = patternVersion;
+    for (const prop of PROPERTY_KEYS) {
+        const value = asString(node[prop]);
+        if (value !== undefined)
+            control.properties[prop] = value;
+    }
+    // Child controls live under <Controls><AxFormControl>…
+    const controlsNode = node.Controls;
+    if (controlsNode && typeof controlsNode === 'object') {
+        for (const childNode of asArray(controlsNode.AxFormControl)) {
+            const child = extractControlNode(childNode);
+            if (child)
+                control.children.push(child);
+        }
+    }
+    return control;
+}
+/**
+ * Walk a parsed <Design> node into a normalized tree.
+ * Tolerates both Design > Controls > AxFormControl and a bare Design > AxForm* shape.
+ */
+export function walkFormDesign(designNode) {
+    const design = { properties: {}, controls: [] };
+    if (!designNode || typeof designNode !== 'object')
+        return design;
+    design.pattern = asString(designNode.Pattern);
+    design.patternVersion = asString(designNode.PatternVersion);
+    design.style = asString(designNode.Style);
+    for (const prop of PROPERTY_KEYS) {
+        const value = asString(designNode[prop]);
+        if (value !== undefined)
+            design.properties[prop] = value;
+    }
+    const controlsNode = designNode.Controls;
+    if (controlsNode && typeof controlsNode === 'object') {
+        for (const node of asArray(controlsNode.AxFormControl)) {
+            const control = extractControlNode(node);
+            if (control)
+                design.controls.push(control);
+        }
+    }
+    else {
+        // Fallback: direct AxForm*-keyed children (no Controls wrapper)
+        for (const key of Object.keys(designNode).filter((k) => k.startsWith('AxForm'))) {
+            for (const node of asArray(designNode[key])) {
+                const control = extractControlNode(node);
+                if (control) {
+                    if (!control.axType)
+                        control.axType = key;
+                    if (control.type === 'Control')
+                        control.type = normalizeControlType(key) || control.type;
+                    design.controls.push(control);
+                }
+            }
+        }
+    }
+    return design;
+}
+/**
+ * Flatten a design tree into records of every node that declares a pattern
+ * (the Design root plus sub-patterned containers) — mining input.
+ */
+export function collectPatternNodes(design) {
+    const records = [];
+    if (design.pattern) {
+        records.push({
+            nodePath: 'Design',
+            controlName: '',
+            controlType: '',
+            pattern: design.pattern,
+            patternVersion: design.patternVersion,
+            childSequence: design.controls.map((c) => c.type),
+        });
+    }
+    const visit = (node, parentPath) => {
+        const nodePath = `${parentPath}/${node.type}[${node.name}]`;
+        if (node.pattern) {
+            records.push({
+                nodePath,
+                controlName: node.name,
+                controlType: node.type,
+                pattern: node.pattern,
+                patternVersion: node.patternVersion,
+                childSequence: node.children.map((c) => c.type),
+            });
+        }
+        for (const child of node.children)
+            visit(child, nodePath);
+    };
+    for (const control of design.controls)
+        visit(control, 'Design');
+    return records;
+}
+//# sourceMappingURL=formPatternMiner.js.map

package/dist/metadata/formPatternMiner.js.map

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

package/dist/metadata/labelParser.d.ts

@@ -0,0 +1,71 @@
+/**
+ * AxLabelFile Parser
+ * Parses D365FO .label.txt files from PackagesLocalDirectory
+ * and indexes them into the SQLite labels table.
+ *
+ * Label file format (one per line):
+ *   LabelId=Label text
+ *    ;Optional comment line (leading space + semicolon)
+ *
+ * File locations on K: drive:
+ *   {pkg}\{Model}\{Model}\AxLabelFile\LabelResources\{locale}\{LabelFileId}.{locale}.label.txt
+ *   {pkg}\{Model}\{Model}\AxLabelFile\{LabelFileId}_{locale}.xml  (metadata descriptor)
+ */
+import type { XppSymbolIndex } from './symbolIndex.js';
+export interface ParsedLabel {
+    labelId: string;
+    text: string;
+    comment?: string;
+    labelFileId: string;
+    model: string;
+    language: string;
+    filePath: string;
+}
+/**
+ * True when a label file ID refers to a label file EXTENSION rather than an
+ * original (base) label file owned by the model.
+ *
+ * D365FO names label file extensions with an `_Extension` marker, optionally
+ * followed by a model prefix — e.g. `Base_Extension` or `Base_ExtensionContoso`.
+ * On disk the content file is `${labelFileId}.${locale}.label.txt`, so the
+ * `_Extension` marker is carried in the label file ID itself.
+ *
+ * New labels must always be created in the model's own ORIGINAL label file.
+ * An extension only extends a base label file owned by another model; adding
+ * brand-new labels there is almost always a mistake (and is what leads clients
+ * to wrongly prefix the label IDs).
+ */
+export declare function isExtensionLabelFile(labelFileId: string): boolean;
+/**
+ * Parse a single .label.txt file into ParsedLabel records.
+ */
+export declare function parseLabelFile(content: string, labelFileId: string, model: string, language: string, filePath: string): ParsedLabel[];
+/**
+ * Discover all AxLabelFile resources for a model.
+ * Returns an array of { labelFileId, language, filePath }.
+ */
+export declare function discoverLabelFiles(modelDir: string): Promise<Array<{
+    labelFileId: string;
+    language: string;
+    filePath: string;
+}>>;
+/**
+ * Index all label files for a single model into the symbol index.
+ * Returns the number of label entries inserted.
+ *
+ * Pass `{ skipFtsRebuild: true }` when calling in a loop over many models;
+ * the caller is responsible for calling `symbolIndex.rebuildLabelsFts()` once
+ * after all models have been indexed.
+ */
+export declare function indexModelLabels(symbolIndex: XppSymbolIndex, modelDir: string, model: string, opts?: {
+    skipFtsRebuild?: boolean;
+}): Promise<number>;
+/**
+ * Index ALL labels from PackagesLocalDirectory into the symbol index.
+ * Scans all model folders.
+ */
+export declare function indexAllLabels(symbolIndex: XppSymbolIndex, packagesPath: string, modelFilter?: (modelName: string) => boolean): Promise<{
+    totalLabels: number;
+    modelsIndexed: number;
+}>;
+//# sourceMappingURL=labelParser.d.ts.map

package/dist/metadata/labelParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labelParser.d.ts","sourceRoot":"","sources":["../../src/metadata/labelParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,WAAW,EAAE,CAwCf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAkE7E;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,cAAc,EAC3B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GAClC,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,cAAc,EAC3B,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,GAC3C,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAsFzD"}

package/dist/metadata/labelParser.js

@@ -0,0 +1,258 @@
+/**
+ * AxLabelFile Parser
+ * Parses D365FO .label.txt files from PackagesLocalDirectory
+ * and indexes them into the SQLite labels table.
+ *
+ * Label file format (one per line):
+ *   LabelId=Label text
+ *    ;Optional comment line (leading space + semicolon)
+ *
+ * File locations on K: drive:
+ *   {pkg}\{Model}\{Model}\AxLabelFile\LabelResources\{locale}\{LabelFileId}.{locale}.label.txt
+ *   {pkg}\{Model}\{Model}\AxLabelFile\{LabelFileId}_{locale}.xml  (metadata descriptor)
+ */
+import * as fs from 'fs/promises';
+import * as fsSync from 'fs';
+import * as path from 'path';
+/**
+ * True when a label file ID refers to a label file EXTENSION rather than an
+ * original (base) label file owned by the model.
+ *
+ * D365FO names label file extensions with an `_Extension` marker, optionally
+ * followed by a model prefix — e.g. `Base_Extension` or `Base_ExtensionContoso`.
+ * On disk the content file is `${labelFileId}.${locale}.label.txt`, so the
+ * `_Extension` marker is carried in the label file ID itself.
+ *
+ * New labels must always be created in the model's own ORIGINAL label file.
+ * An extension only extends a base label file owned by another model; adding
+ * brand-new labels there is almost always a mistake (and is what leads clients
+ * to wrongly prefix the label IDs).
+ */
+export function isExtensionLabelFile(labelFileId) {
+    return /_Extension/i.test(labelFileId);
+}
+/**
+ * Parse a single .label.txt file into ParsedLabel records.
+ */
+export function parseLabelFile(content, labelFileId, model, language, filePath) {
+    const labels = [];
+    // Normalise line endings
+    const lines = content.replace(/\r\n/g, '\n').replace(/\r/g, '\n').split('\n');
+    let current = null;
+    for (const line of lines) {
+        if (line === '')
+            continue;
+        if (line.startsWith(' ;') || line.startsWith('\t;')) {
+            // Comment line for the previous label
+            if (current) {
+                const commentText = line.replace(/^[ \t];/, '').trim();
+                current.comment = current.comment ? `${current.comment} ${commentText}` : commentText;
+            }
+            continue;
+        }
+        const eqIdx = line.indexOf('=');
+        if (eqIdx > 0) {
+            // Flush previous label
+            if (current)
+                labels.push(current);
+            const labelId = line.substring(0, eqIdx).trim();
+            const text = line.substring(eqIdx + 1);
+            // Skip empty or obviously malformed ids
+            if (!labelId || /\s/.test(labelId)) {
+                current = null;
+                continue;
+            }
+            current = { labelId, text, comment: undefined, labelFileId, model, language, filePath };
+        }
+        // Any other line (continuation) — ignore; D365FO labels are single-line
+    }
+    if (current)
+        labels.push(current);
+    return labels;
+}
+/**
+ * Discover all AxLabelFile resources for a model.
+ * Returns an array of { labelFileId, language, filePath }.
+ */
+export async function discoverLabelFiles(modelDir) {
+    const results = [];
+    // Directory casing varies: Windows uses AxLabelFile/LabelResources, Linux unzip may lowercase either segment.
+    let axLabelDir = path.join(modelDir, 'AxLabelFile', 'LabelResources');
+    if (!fsSync.existsSync(axLabelDir)) {
+        axLabelDir = path.join(modelDir, 'axlabelfile', 'LabelResources');
+        if (!fsSync.existsSync(axLabelDir)) {
+            axLabelDir = path.join(modelDir, 'axlabelfile', 'labelresources');
+        }
+    }
+    // Restrict indexing to configured languages to keep the label table small; LABEL_LANGUAGES=all indexes everything.
+    const langConfig = process.env.LABEL_LANGUAGES || 'en-US,cs,sk,de';
+    const SUPPORTED_LANGUAGES = langConfig.toLowerCase() === 'all'
+        ? null // null = index all languages
+        : new Set(langConfig.split(',').map(l => l.trim()));
+    let locales;
+    try {
+        locales = await fs.readdir(axLabelDir);
+    }
+    catch {
+        return results; // No AxLabelFile folder
+    }
+    for (const locale of locales) {
+        // Locale directory names may be lowercased on Linux, so compare case-insensitively.
+        if (SUPPORTED_LANGUAGES) {
+            const normalizedLocale = locale.toLowerCase();
+            const isSupported = Array.from(SUPPORTED_LANGUAGES).some(supported => supported.toLowerCase() === normalizedLocale);
+            if (!isSupported) {
+                continue;
+            }
+        }
+        const localeDir = path.join(axLabelDir, locale);
+        let files;
+        try {
+            files = await fs.readdir(localeDir);
+        }
+        catch {
+            continue;
+        }
+        for (const file of files) {
+            if (!file.endsWith('.label.txt'))
+                continue;
+            // Filename pattern: {LabelFileId}.{locale}.label.txt
+            const withoutSuffix = file.replace(/\.label\.txt$/, '');
+            const dotIdx = withoutSuffix.lastIndexOf('.');
+            if (dotIdx < 0)
+                continue;
+            const labelFileId = withoutSuffix.substring(0, dotIdx);
+            const fileLang = withoutSuffix.substring(dotIdx + 1);
+            if (fileLang.toLowerCase() !== locale.toLowerCase())
+                continue;
+            results.push({
+                labelFileId,
+                // Normalize to BCP-47 canonical casing (e.g. 'en-us' -> 'en-US').
+                language: locale.split('-').map((part, i) => i === 0 ? part.toLowerCase() : part.toUpperCase()).join('-'),
+                filePath: path.join(localeDir, file),
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Index all label files for a single model into the symbol index.
+ * Returns the number of label entries inserted.
+ *
+ * Pass `{ skipFtsRebuild: true }` when calling in a loop over many models;
+ * the caller is responsible for calling `symbolIndex.rebuildLabelsFts()` once
+ * after all models have been indexed.
+ */
+export async function indexModelLabels(symbolIndex, modelDir, model, opts) {
+    const labelFiles = await discoverLabelFiles(modelDir);
+    if (labelFiles.length === 0)
+        return 0;
+    const allEntries = [];
+    for (const { labelFileId, language, filePath } of labelFiles) {
+        let content;
+        try {
+            content = await fs.readFile(filePath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const labels = parseLabelFile(content, labelFileId, model, language, filePath);
+        for (const lbl of labels) {
+            allEntries.push({
+                labelId: lbl.labelId,
+                labelFileId: lbl.labelFileId,
+                model: lbl.model,
+                language: lbl.language,
+                text: lbl.text,
+                comment: lbl.comment,
+                filePath: lbl.filePath,
+            });
+        }
+    }
+    if (allEntries.length > 0) {
+        symbolIndex.bulkAddLabels(allEntries, opts);
+    }
+    return allEntries.length;
+}
+/**
+ * Index ALL labels from PackagesLocalDirectory into the symbol index.
+ * Scans all model folders.
+ */
+export async function indexAllLabels(symbolIndex, packagesPath, modelFilter) {
+    let totalLabels = 0;
+    let modelsIndexed = 0;
+    let models;
+    try {
+        const entries = fsSync.readdirSync(packagesPath, { withFileTypes: true });
+        // Model folders are often NTFS junction points, reported as isSymbolicLink() not isDirectory().
+        models = entries.filter(e => e.isDirectory() || e.isSymbolicLink()).map(e => e.name);
+    }
+    catch {
+        console.error(`[LabelParser] Cannot read packages path: ${packagesPath}`);
+        return { totalLabels, modelsIndexed };
+    }
+    let skippedByFilter = 0;
+    let skippedMissingDir = 0;
+    let skippedNoLabels = 0;
+    for (const packageOrModel of models) {
+        if (modelFilter && !modelFilter(packageOrModel)) {
+            skippedByFilter++;
+            continue;
+        }
+        const packageDir = path.join(packagesPath, packageOrModel);
+        // A package dir can contain multiple model subdirectories, each with its own AxLabelFile.
+        const modelDirs = [];
+        try {
+            const subDirs = fsSync.readdirSync(packageDir, { withFileTypes: true })
+                .filter(e => e.isDirectory() || e.isSymbolicLink())
+                .map(e => e.name)
+                .filter(n => n !== 'Descriptor' && n !== 'bin' && !n.startsWith('.'));
+            for (const subDir of subDirs) {
+                const candidateDir = path.join(packageDir, subDir);
+                const axLabelDirOriginal = path.join(candidateDir, 'AxLabelFile');
+                const axLabelDirLower = path.join(candidateDir, 'axlabelfile');
+                if (fsSync.existsSync(axLabelDirOriginal) || fsSync.existsSync(axLabelDirLower)) {
+                    modelDirs.push({ modelDir: candidateDir, modelName: subDir });
+                }
+            }
+        }
+        catch {
+            // Directory not readable
+        }
+        // Fallback: flat structure where AxLabelFile sits directly under the package dir.
+        if (modelDirs.length === 0) {
+            const flatAxLabel = path.join(packageDir, 'AxLabelFile');
+            const flatAxLabelLower = path.join(packageDir, 'axlabelfile');
+            if (fsSync.existsSync(flatAxLabel) || fsSync.existsSync(flatAxLabelLower)) {
+                modelDirs.push({ modelDir: packageDir, modelName: packageOrModel });
+            }
+        }
+        if (modelDirs.length === 0) {
+            skippedMissingDir++;
+            continue;
+        }
+        for (const { modelDir, modelName } of modelDirs) {
+            const count = await indexModelLabels(symbolIndex, modelDir, modelName, { skipFtsRebuild: true });
+            if (count > 0) {
+                totalLabels += count;
+                modelsIndexed++;
+            }
+            else {
+                skippedNoLabels++;
+            }
+        }
+    }
+    // Rebuild FTS once for all models rather than per-model (avoids O(n^2) rebuild cost).
+    if (totalLabels > 0) {
+        symbolIndex.rebuildLabelsFts();
+    }
+    if (modelsIndexed === 0) {
+        console.log(`   ℹ️  No labels indexed:`);
+        console.log(`      - Models skipped by filter: ${skippedByFilter}`);
+        console.log(`      - Models with missing directory: ${skippedMissingDir}`);
+        console.log(`      - Models with no labels: ${skippedNoLabels}`);
+        console.log(`      - Total models found: ${models.length}`);
+    }
+    return { totalLabels, modelsIndexed };
+}
+//# sourceMappingURL=labelParser.js.map

package/dist/metadata/labelParser.js.map

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

package/dist/metadata/symbolCountsWorker.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Symbol-counts worker thread.
+ *
+ * COUNT(*) / GROUP BY over the symbols table is a full index scan — on a
+ * 2 GB production database with a cold OS file cache it takes 30-60+ seconds.
+ * better-sqlite3 is synchronous, so running it on the main thread blocks the
+ * event loop and the MCP server cannot answer tools/list or the first tool
+ * call; the client (VS Code Copilot) times out after 60 s and kills the
+ * server. Running the scan here, on a separate thread with its own read-only
+ * connection, keeps the main thread free (WAL mode allows concurrent readers).
+ *
+ * Spawned by XppSymbolIndex.getSymbolCounts(); posts a single message:
+ *   { ok: true, total, byType } | { ok: false, error }
+ */
+export {};
+//# sourceMappingURL=symbolCountsWorker.d.ts.map

package/dist/metadata/symbolCountsWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbolCountsWorker.d.ts","sourceRoot":"","sources":["../../src/metadata/symbolCountsWorker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/metadata/symbolCountsWorker.js

@@ -0,0 +1,42 @@
+/**
+ * Symbol-counts worker thread.
+ *
+ * COUNT(*) / GROUP BY over the symbols table is a full index scan — on a
+ * 2 GB production database with a cold OS file cache it takes 30-60+ seconds.
+ * better-sqlite3 is synchronous, so running it on the main thread blocks the
+ * event loop and the MCP server cannot answer tools/list or the first tool
+ * call; the client (VS Code Copilot) times out after 60 s and kills the
+ * server. Running the scan here, on a separate thread with its own read-only
+ * connection, keeps the main thread free (WAL mode allows concurrent readers).
+ *
+ * Spawned by XppSymbolIndex.getSymbolCounts(); posts a single message:
+ *   { ok: true, total, byType } | { ok: false, error }
+ */
+import { parentPort, workerData } from 'node:worker_threads';
+import Database from 'better-sqlite3';
+const { dbPath } = workerData;
+try {
+    const db = new Database(dbPath, { readonly: true });
+    try {
+        db.pragma('busy_timeout = 5000');
+        // One GROUP BY scan yields both the per-type breakdown and (summed) the
+        // total — half the work of separate COUNT(*) + GROUP BY queries.
+        const rows = db
+            .prepare(`SELECT type, COUNT(*) as count FROM symbols GROUP BY type`)
+            .all();
+        const byType = {};
+        let total = 0;
+        for (const row of rows) {
+            byType[row.type] = row.count;
+            total += row.count;
+        }
+        parentPort.postMessage({ ok: true, total, byType });
+    }
+    finally {
+        db.close();
+    }
+}
+catch (e) {
+    parentPort.postMessage({ ok: false, error: String(e) });
+}
+//# sourceMappingURL=symbolCountsWorker.js.map

package/dist/metadata/symbolCountsWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbolCountsWorker.js","sourceRoot":"","sources":["../../src/metadata/symbolCountsWorker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAgC,CAAC;AAEpD,IAAI,CAAC;IACH,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACjC,wEAAwE;QACxE,iEAAiE;QACjE,MAAM,IAAI,GAAG,EAAE;aACZ,OAAO,CAAC,2DAA2D,CAAC;aACpE,GAAG,EAA4C,CAAC;QACnD,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC;YAC7B,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC;QACrB,CAAC;QACD,UAAW,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAAC,OAAO,CAAC,EAAE,CAAC;IACX,UAAW,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC3D,CAAC"}