@enokdev/springdocs-mcp 1.2.8 → 1.4.1

package/build/services/boot-wiki.d.ts

@@ -0,0 +1,25 @@
+export type WikiDocument = 'migration-guide' | 'release-notes';
+/** `auto` picks the migration guide for x.0 versions and the release notes otherwise. */
+export declare function resolveWikiDocument(version: string, document: 'auto' | WikiDocument): WikiDocument;
+export declare function wikiPageName(version: string, document: WikiDocument): string;
+export declare function wikiPageUrl(pageName: string): string;
+export declare function expectedWikiTitle(version: string, document: WikiDocument): string;
+/**
+ * Convert the wiki page HTML to markdown.
+ *
+ * GitHub answers a missing wiki page with a redirect to the wiki home page,
+ * which is followed transparently and returns 200. The page <title> must
+ * therefore match the expected title EXACTLY, otherwise the page is considered
+ * absent and the home page content is never returned as a guide.
+ */
+export declare function extractWikiMarkdown(html: string, expectedTitle: string, url: string): {
+    markdown: string;
+    title: string;
+};
+/**
+ * Keep the sections whose heading contains the keyword (case-insensitive),
+ * each with its sub-sections. Matches nested in an already selected range are
+ * skipped; ranges are joined by a blank line.
+ */
+export declare function selectSections(markdown: string, keyword: string, title: string): string;
+//# sourceMappingURL=boot-wiki.d.ts.map

package/build/services/boot-wiki.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot-wiki.d.ts","sourceRoot":"","sources":["../../src/services/boot-wiki.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAK/D,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,CAGlG;AAMD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,MAAM,CAE5E;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,MAAM,CAEjF;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,GACV;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAmCrC;AAmBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAsBvF"}

package/build/services/boot-wiki.js

@@ -0,0 +1,103 @@
+import * as cheerio from 'cheerio';
+import { scanFences, turndownService } from './markdown.js';
+const WIKI_BASE_URL = 'https://github.com/spring-projects/spring-boot/wiki/';
+const MAX_LISTED_SECTIONS = 80;
+/** `auto` picks the migration guide for x.0 versions and the release notes otherwise. */
+export function resolveWikiDocument(version, document) {
+    if (document !== 'auto')
+        return document;
+    return version.endsWith('.0') ? 'migration-guide' : 'release-notes';
+}
+function documentLabel(document) {
+    return document === 'migration-guide' ? 'Migration Guide' : 'Release Notes';
+}
+export function wikiPageName(version, document) {
+    return `Spring-Boot-${version}-${documentLabel(document).replace(' ', '-')}`;
+}
+export function wikiPageUrl(pageName) {
+    return `${WIKI_BASE_URL}${pageName}`;
+}
+export function expectedWikiTitle(version, document) {
+    return `Spring Boot ${version} ${documentLabel(document)}`;
+}
+/**
+ * Convert the wiki page HTML to markdown.
+ *
+ * GitHub answers a missing wiki page with a redirect to the wiki home page,
+ * which is followed transparently and returns 200. The page <title> must
+ * therefore match the expected title EXACTLY, otherwise the page is considered
+ * absent and the home page content is never returned as a guide.
+ */
+export function extractWikiMarkdown(html, expectedTitle, url) {
+    const $ = cheerio.load(html);
+    const title = $('title').first().text().split(' · spring-projects')[0].trim();
+    if (title !== expectedTitle) {
+        const pageName = decodeURIComponent(url.split('/').pop() ?? url);
+        throw new Error(`Spring Boot wiki page not found: ${pageName} (${url})`);
+    }
+    const body = $('#wiki-body .markdown-body').first();
+    if (body.length === 0) {
+        throw new Error(`Unable to extract content from ${url}`);
+    }
+    // Heading permalinks and icons would otherwise leak as "[](#...)" links.
+    body.find('a.anchor, svg, .octicon').remove();
+    body.find('a[href^="#"]').each((_, el) => {
+        if ($(el).text().trim() === '')
+            $(el).remove();
+    });
+    // GitHub renders highlighted blocks as <pre> without <code>, which turndown
+    // would not fence: normalise them to <pre><code>.
+    body.find('pre').each((_, el) => {
+        const pre = $(el);
+        if (pre.children('code').length === 0) {
+            const code = $('<code></code>').text(pre.text());
+            pre.empty().append(code);
+        }
+    });
+    const markdown = turndownService.turndown(body.html() ?? '').trim();
+    if (!markdown) {
+        throw new Error(`Unable to extract content from ${url}`);
+    }
+    return { markdown, title };
+}
+function findHeadings(lines) {
+    const headings = [];
+    const scan = scanFences(lines);
+    lines.forEach((line, index) => {
+        if (scan[index].inCode || scan[index].isFence)
+            return;
+        const match = /^(#{1,6})\s+(.+?)\s*$/.exec(line);
+        if (match)
+            headings.push({ line: index, level: match[1].length, text: match[2] });
+    });
+    return headings;
+}
+/**
+ * Keep the sections whose heading contains the keyword (case-insensitive),
+ * each with its sub-sections. Matches nested in an already selected range are
+ * skipped; ranges are joined by a blank line.
+ */
+export function selectSections(markdown, keyword, title) {
+    const lines = markdown.split(/\r?\n/);
+    const headings = findHeadings(lines);
+    const needle = keyword.toLowerCase();
+    const ranges = [];
+    let coveredUntil = 0;
+    headings.forEach((heading, i) => {
+        if (heading.line < coveredUntil)
+            return;
+        if (!heading.text.toLowerCase().includes(needle))
+            return;
+        const next = headings.slice(i + 1).find((h) => h.level <= heading.level);
+        const end = next ? next.line : lines.length;
+        ranges.push(lines.slice(heading.line, end).join('\n').trimEnd());
+        coveredUntil = end;
+    });
+    if (ranges.length === 0) {
+        const titles = headings.slice(0, MAX_LISTED_SECTIONS).map((h) => h.text).join(', ');
+        const more = headings.length > MAX_LISTED_SECTIONS ? '…' : '';
+        throw new Error(`No section matching "${keyword}" in ${title}. Available sections: ${titles}${more}`);
+    }
+    return ranges.join('\n\n');
+}
+//# sourceMappingURL=boot-wiki.js.map

package/build/services/boot-wiki.js.map

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

package/build/services/cache.d.ts

@@ -1,10 +1,14 @@
-/**
- * Intelligent caching service for Spring documentation
- */
+export interface CacheOptions {
+    /** Memory budget in bytes (estimated size of keys and values); default 64 MiB or MCP_CACHE_MAX_MB */
+    maxBytes?: number;
+}
 export declare class CacheService {
     private cache;
+    private totalBytes;
+    private readonly maxBytes;
     private readonly DEFAULT_TTL;
     private readonly LONG_TTL;
+    constructor(options?: CacheOptions);
     /**
      * Get cached data if available and not expired
      */
@@ -13,6 +17,7 @@ export declare class CacheService {
      * Store data in cache with optional custom TTL
      */
     set<T>(key: string, data: T, ttl?: number): void;
+    private remove;
     /**
      * Store data with long TTL for stable content
      */
@@ -27,10 +32,20 @@ export declare class CacheService {
     getStats(): {
         size: number;
         expired: number;
+        bytes: number;
+        maxBytes: number;
     };
     /**
      * Clear all cache
      */
     clear(): void;
+    /**
+     * Remove expired entries or everything; returns how many entries were removed
+     */
+    purge(mode: "expired" | "all"): number;
+    /**
+     * Markdown report of the cache state, optionally purging first
+     */
+    statsReport(purge?: "none" | "expired" | "all"): string;
 }
 //# sourceMappingURL=cache.d.ts.map

package/build/services/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/services/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAoE;IACjF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAEhD;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAY7B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAQhD;;OAEG;IACH,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAI1C;;OAEG;IACH,OAAO,IAAI,IAAI;IASf;;OAEG;IACH,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAa7C;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/services/cache.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,qGAAqG;IACrG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAmBD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAmF;IAChG,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;gBAEpC,OAAO,GAAE,YAAiB;IAMtC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAgB7B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAkBhD,OAAO,CAAC,MAAM;IAOd;;OAEG;IACH,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAI1C;;OAEG;IACH,OAAO,IAAI,IAAI;IASf;;OAEG;IACH,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAa9E;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM;IAUtC;;OAEG;IACH,WAAW,CAAC,KAAK,GAAE,MAAM,GAAG,SAAS,GAAG,KAAc,GAAG,MAAM;CAgBhE"}

package/build/services/cache.js

@@ -1,10 +1,36 @@
 /**
  * Intelligent caching service for Spring documentation
  */
+const MIB = 1024 * 1024;
+const DEFAULT_MAX_MB = 64;
+function defaultMaxBytes() {
+    const mb = Number(process.env.MCP_CACHE_MAX_MB);
+    return Number.isFinite(mb) && mb > 0 ? Math.floor(mb * MIB) : DEFAULT_MAX_MB * MIB;
+}
+/** Estimated size in bytes: UTF-8 length for strings, of the JSON form otherwise */
+function estimateBytes(key, data) {
+    let size = Buffer.byteLength(key);
+    if (typeof data === "string")
+        return size + Buffer.byteLength(data);
+    try {
+        size += Buffer.byteLength(JSON.stringify(data) ?? "");
+    }
+    catch {
+        size += 1024; // not serialisable (cycles, BigInt): flat estimate
+    }
+    return size;
+}
 export class CacheService {
     cache = new Map();
+    totalBytes = 0;
+    maxBytes;
     DEFAULT_TTL = 30 * 60 * 1000; // 30 minutes
     LONG_TTL = 24 * 60 * 60 * 1000; // 24 hours for stable content
+    constructor(options = {}) {
+        this.maxBytes = options.maxBytes && options.maxBytes > 0 ? options.maxBytes : defaultMaxBytes();
+        // Drop expired entries every hour; unref so the timer never keeps the process alive
+        setInterval(() => this.cleanup(), 60 * 60 * 1000).unref();
+    }
     /**
      * Get cached data if available and not expired
      */
@@ -13,20 +39,42 @@ export class CacheService {
         if (!entry)
             return null;
         if (Date.now() - entry.timestamp > entry.ttl) {
-            this.cache.delete(key);
+            this.remove(key);
             return null;
         }
+        // Refresh recency: Map iterates in insertion order, so re-insert at the end
+        this.cache.delete(key);
+        this.cache.set(key, entry);
         return entry.data;
     }
     /**
      * Store data in cache with optional custom TTL
      */
     set(key, data, ttl) {
+        this.remove(key);
+        const bytes = estimateBytes(key, data);
+        if (bytes > this.maxBytes)
+            return; // larger than the whole budget: never cached
+        while (this.totalBytes + bytes > this.maxBytes) {
+            const oldest = this.cache.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.remove(oldest);
+        }
         this.cache.set(key, {
             data,
             timestamp: Date.now(),
             ttl: ttl || this.DEFAULT_TTL,
+            bytes,
         });
+        this.totalBytes += bytes;
+    }
+    remove(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return;
+        this.totalBytes -= entry.bytes;
+        this.cache.delete(key);
     }
     /**
      * Store data with long TTL for stable content
@@ -41,7 +89,7 @@ export class CacheService {
         const now = Date.now();
         for (const [key, entry] of this.cache.entries()) {
             if (now - entry.timestamp > entry.ttl) {
-                this.cache.delete(key);
+                this.remove(key);
             }
         }
     }
@@ -56,13 +104,46 @@ export class CacheService {
                 expired++;
             }
         }
-        return { size: this.cache.size, expired };
+        return { size: this.cache.size, expired, bytes: this.totalBytes, maxBytes: this.maxBytes };
     }
     /**
      * Clear all cache
      */
     clear() {
         this.cache.clear();
+        this.totalBytes = 0;
+    }
+    /**
+     * Remove expired entries or everything; returns how many entries were removed
+     */
+    purge(mode) {
+        const before = this.cache.size;
+        if (mode === "all") {
+            this.clear();
+        }
+        else {
+            this.cleanup();
+        }
+        return before - this.cache.size;
+    }
+    /**
+     * Markdown report of the cache state, optionally purging first
+     */
+    statsReport(purge = "none") {
+        const removed = purge === "none" ? null : this.purge(purge);
+        const { size, expired, bytes, maxBytes } = this.getStats();
+        const mib = (n) => (n / MIB).toFixed(1);
+        const lines = [
+            "# Cache statistics",
+            "",
+            `- Entries: ${size}`,
+            `- Memory (estimated): ${mib(bytes)} MiB / ${mib(maxBytes)} MiB`,
+            `- Expired (awaiting cleanup): ${expired}`,
+        ];
+        if (removed !== null) {
+            lines.push(`- Removed by purge (${purge}): ${removed}`);
+        }
+        return lines.join("\n");
     }
 }
 //# sourceMappingURL=cache.js.map

package/build/services/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/services/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,GAAG,IAAI,GAAG,EAAyD,CAAC;IAChE,WAAW,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;IAC3C,QAAQ,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,8BAA8B;IAE/E;;OAEG;IACH,GAAG,CAAI,GAAW;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;YAC7C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC,IAAS,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,GAAG,CAAI,GAAW,EAAE,IAAO,EAAE,GAAY;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,WAAW;SAC7B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,WAAW,CAAI,GAAW,EAAE,IAAO;QACjC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,OAAO;QACL,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAChD,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;gBACtC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACxC,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;gBACtC,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/services/cache.ts"],"names":[],"mappings":"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"}

package/build/services/dependency-finder.d.ts

@@ -0,0 +1,46 @@
+import type { InitializrMetadata } from './initializr.js';
+export type BuildChoice = 'maven' | 'gradle' | 'both';
+export interface CatalogEntry {
+    id: string;
+    name: string;
+    description: string;
+}
+export interface Coordinates {
+    groupId: string;
+    artifactId: string;
+    scope: string;
+    bom?: string;
+    version?: string;
+    repository?: string;
+}
+export interface DependencyData {
+    bootVersion?: string;
+    dependencies: Record<string, Coordinates>;
+    boms?: Record<string, {
+        groupId: string;
+        artifactId: string;
+        version: string;
+    }>;
+    repositories?: Record<string, {
+        name: string;
+        url: string;
+    }>;
+}
+export interface Snippets {
+    kind: 'dependency' | 'plugin' | 'unavailable';
+    coordinates?: string;
+    scope?: string;
+    notes: string[];
+    maven?: string;
+    gradle?: string;
+}
+/** Lowercase alphanumeric words of the need, without stop words or duplicates. */
+export declare function searchWords(need: string): string[];
+export declare function flattenCatalog(meta: InitializrMetadata): CatalogEntry[];
+/** One line of plain text, with the markdown specials neutralised (for titles built from user input). */
+export declare function escapeInline(text: string): string;
+/** Entries matching at least one word, best first (score, then shortest id, then alphabetical). */
+export declare function rankDependencies(catalog: CatalogEntry[], words: string[]): CatalogEntry[];
+export declare function buildSnippets(id: string, data: DependencyData, build: BuildChoice): Snippets;
+export declare function formatDependencyMatches(need: string, ranked: CatalogEntry[], data: DependencyData, build: BuildChoice): string;
+//# sourceMappingURL=dependency-finder.d.ts.map

package/build/services/dependency-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-finder.d.ts","sourceRoot":"","sources":["../../src/services/dependency-finder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAK1D,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,YAAY;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AAE/E,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAUD,kFAAkF;AAClF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAIlD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,YAAY,EAAE,CAUvE;AAED,yGAAyG;AACzG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAwBD,mGAAmG;AACnG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAUzF;AAOD,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,GAAG,QAAQ,CAyF5F;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,EAAE,EACtB,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,WAAW,GACjB,MAAM,CAoBR"}

package/build/services/dependency-finder.js

@@ -0,0 +1,181 @@
+const MAX_RESULTS = 5;
+const MIN_WORD_LENGTH = 2;
+const DEVELOPMENT_ONLY = new Set(['spring-boot-devtools', 'spring-boot-docker-compose']);
+const SAFE_VALUE = /^[A-Za-z0-9_.-]+$/;
+const STOP_WORDS = new Set([
+    'a', 'an', 'the', 'for', 'with', 'to', 'and', 'of', 'in', 'on', 'my', 'i', 'want', 'need', 'use', 'using', 'spring',
+]);
+/** Lowercase alphanumeric words of the need, without stop words or duplicates. */
+export function searchWords(need) {
+    const words = need.toLowerCase().split(/[^a-z0-9]+/)
+        .filter(word => word.length >= MIN_WORD_LENGTH && !STOP_WORDS.has(word));
+    return [...new Set(words)];
+}
+export function flattenCatalog(meta) {
+    const groups = meta.dependencies?.values;
+    if (!Array.isArray(groups)) {
+        throw new Error('Spring Initializr returned an unexpected response (missing dependencies)');
+    }
+    return groups.flatMap(group => group.values.map(dep => ({
+        id: dep.id,
+        name: dep.name,
+        description: dep.description ?? '',
+    })));
+}
+/** One line of plain text, with the markdown specials neutralised (for titles built from user input). */
+export function escapeInline(text) {
+    return text.replace(/\s+/g, ' ').trim().replace(/[\\`*_[\]<>#|~]/g, '\\$&');
+}
+const SHORT_WORD_LENGTH = 3;
+/** Substring match, except that short words (2-3 characters) must be whole words ("ai" is not in "mail"). */
+function contains(text, word) {
+    if (word.length > SHORT_WORD_LENGTH)
+        return text.includes(word);
+    return new RegExp(`(?<![a-z0-9])${word}(?![a-z0-9])`).test(text);
+}
+function score(entry, words) {
+    const id = entry.id.toLowerCase();
+    const name = entry.name.toLowerCase();
+    const description = entry.description.toLowerCase();
+    let total = 0;
+    for (const word of words) {
+        if (id === word)
+            total += 10;
+        else if (contains(id, word))
+            total += 5;
+        if (contains(name, word))
+            total += 4;
+        if (contains(description, word))
+            total += 1;
+    }
+    return total;
+}
+/** Entries matching at least one word, best first (score, then shortest id, then alphabetical). */
+export function rankDependencies(catalog, words) {
+    if (words.length === 0)
+        return [];
+    return catalog
+        .map(entry => ({ entry, score: score(entry, words) }))
+        .filter(item => item.score > 0)
+        .sort((a, b) => b.score - a.score ||
+        a.entry.id.length - b.entry.id.length ||
+        a.entry.id.localeCompare(b.entry.id))
+        .map(item => item.entry);
+}
+function mavenBlock(groupId, artifactId, extra) {
+    return ['<dependency>', `    <groupId>${groupId}</groupId>`, `    <artifactId>${artifactId}</artifactId>`,
+        ...extra.map(line => `    ${line}`), '</dependency>'].join('\n');
+}
+export function buildSnippets(id, data, build) {
+    const c = data.dependencies[id];
+    if (!c) {
+        return { kind: 'unavailable', notes: ['No Maven coordinates published by Initializr for this id.'] };
+    }
+    const bom = c.bom ? data.boms?.[c.bom] : undefined;
+    const values = [c.groupId, c.artifactId, c.scope, c.version, bom?.groupId, bom?.artifactId, bom?.version]
+        .filter((value) => value !== undefined);
+    if (!values.every(value => SAFE_VALUE.test(value))) {
+        return { kind: 'unavailable', notes: ['The coordinates published by Initializr contain unexpected characters: no snippet generated.'] };
+    }
+    const coordinates = `${c.groupId}:${c.artifactId}`;
+    if (c.groupId === 'org.springframework.boot' && c.artifactId === 'spring-boot') {
+        // Initializr publishes the "native" entry with the spring-boot coordinates, but it generates the GraalVM plugin.
+        return {
+            kind: 'plugin',
+            coordinates: id === 'native' ? undefined : coordinates,
+            notes: [
+                'Build plugin, not a dependency: enable it in the build configuration.',
+                ...(id === 'native'
+                    ? ['GraalVM Native Build Tools: Gradle plugin `org.graalvm.buildtools.native`, Maven plugin `org.graalvm.buildtools:native-maven-plugin`.']
+                    : []),
+            ],
+        };
+    }
+    const notes = [];
+    if (c.bom && !bom) {
+        notes.push(`Needs the BOM "${c.bom}", which Initializr does not describe: add its version manually.`);
+    }
+    if (c.repository) {
+        const repo = data.repositories?.[c.repository];
+        notes.push(`Requires the Maven repository ${repo ? `${repo.name} (${repo.url})` : c.repository}.`);
+    }
+    let scope = c.scope;
+    if (!['compile', 'runtime', 'test', 'provided', 'annotationProcessor'].includes(scope)) {
+        notes.push(`Unknown scope "${scope}": shown as a regular (compile) dependency.`);
+        scope = 'compile';
+    }
+    // Initializr publishes these as "runtime" but generates optional (Maven) / developmentOnly (Gradle).
+    const developmentOnly = scope === 'runtime' && c.groupId === 'org.springframework.boot' && DEVELOPMENT_ONLY.has(c.artifactId);
+    if (developmentOnly)
+        notes.push('Development-only: not packaged in the production artifact.');
+    const gav = c.version ? `${coordinates}:${c.version}` : coordinates;
+    const mavenExtra = [
+        ...(c.version ? [`<version>${c.version}</version>`] : []),
+        ...(scope === 'runtime' || scope === 'test' || scope === 'provided' ? [`<scope>${scope}</scope>`] : []),
+        ...(scope === 'annotationProcessor' || developmentOnly ? ['<optional>true</optional>'] : []),
+    ];
+    const mavenParts = [];
+    if (bom) {
+        mavenParts.push([
+            '<dependencyManagement>',
+            '    <dependencies>',
+            '        <dependency>',
+            `            <groupId>${bom.groupId}</groupId>`,
+            `            <artifactId>${bom.artifactId}</artifactId>`,
+            `            <version>${bom.version}</version>`,
+            '            <type>pom</type>',
+            '            <scope>import</scope>',
+            '        </dependency>',
+            '    </dependencies>',
+            '</dependencyManagement>',
+        ].join('\n'));
+    }
+    mavenParts.push(mavenBlock(c.groupId, c.artifactId, mavenExtra));
+    const gradleConfig = {
+        compile: ['implementation'],
+        runtime: ['runtimeOnly'],
+        test: ['testImplementation'],
+        provided: ['compileOnly'],
+        annotationProcessor: ['compileOnly', 'annotationProcessor'],
+    };
+    const gradleLines = [
+        ...(bom ? [`implementation(platform("${bom.groupId}:${bom.artifactId}:${bom.version}"))`] : []),
+        ...(developmentOnly ? ['developmentOnly'] : gradleConfig[scope]).map(config => `${config}("${gav}")`),
+    ];
+    return {
+        kind: 'dependency',
+        coordinates,
+        scope: c.scope,
+        notes,
+        maven: build === 'gradle' ? undefined : mavenParts.join('\n\n'),
+        gradle: build === 'maven' ? undefined : gradleLines.join('\n'),
+    };
+}
+export function formatDependencyMatches(need, ranked, data, build) {
+    if (ranked.length === 0) {
+        return `No dependency matches "${escapeInline(need)}". Try other English keywords, or list everything with get_spring_initializr (section "dependencies").`;
+    }
+    const lines = [`# Dependencies for "${escapeInline(need)}"${data.bootVersion ? ` (Spring Boot ${data.bootVersion})` : ''}`];
+    for (const entry of ranked.slice(0, MAX_RESULTS)) {
+        const snippets = buildSnippets(entry.id, data, build);
+        lines.push('', `## \`${entry.id}\` — ${entry.name}`);
+        if (entry.description)
+            lines.push('', entry.description);
+        lines.push('');
+        if (snippets.coordinates)
+            lines.push(`- Coordinates: \`${snippets.coordinates}\``);
+        if (snippets.scope)
+            lines.push(`- Scope: ${snippets.scope}`);
+        for (const note of snippets.notes)
+            lines.push(`- ${note}`);
+        if (snippets.maven)
+            lines.push('', '**Maven**', '', '```xml', snippets.maven, '```');
+        if (snippets.gradle)
+            lines.push('', '**Gradle** (Groovy and Kotlin DSL)', '', '```gradle', snippets.gradle, '```');
+    }
+    if (ranked.length > MAX_RESULTS) {
+        lines.push('', `${ranked.length - MAX_RESULTS} more matches, refine the query.`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=dependency-finder.js.map

package/build/services/dependency-finder.js.map

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

package/build/services/diagnosis.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Local, deterministic and bounded analysis of Spring error messages and stack traces.
+ *
+ * The input is untrusted user text: every cap is applied BEFORE any processing, and the
+ * parsing is line based (startsWith / indexOf / slice). No backtracking regex is used;
+ * the only regexes are anchored, linear and without nested quantifiers.
+ */
+import { SpringProjectsConfig } from './spring-projects-config.js';
+export interface ExceptionLink {
+    type: string;
+    message: string;
+}
+export interface TraceAnalysis {
+    chain: ExceptionLink[];
+    top?: ExceptionLink;
+    root?: ExceptionLink;
+    /** Trimmed first application frame, e.g. "at com.acme.Foo.bar(Foo.java:42)" */
+    applicationFrame?: string;
+    /** One of startup | web | data | security | actuator | configuration */
+    inferredComponent?: string;
+}
+export interface DiagnosisReference {
+    project: string;
+    section: string;
+    subsection?: string;
+}
+export interface DiagnosisRule {
+    id: string;
+    needles: string[];
+    title: string;
+    checks: string[];
+    references: DiagnosisReference[];
+}
+export declare function analyzeStackTrace(stackTrace?: string): TraceAnalysis;
+export declare const DIAGNOSIS_RULES: DiagnosisRule[];
+/**
+ * Returns the rules whose needles appear (lower-cased) in the analyzed text:
+ * the error message plus the exception header lines of the trace. Order = table order.
+ */
+export declare function matchRules(errorMessage: string, analysis: TraceAnalysis, stackTrace?: string): DiagnosisRule[];
+export declare function renderDiagnosis(input: {
+    errorMessage: string;
+    component?: string;
+    stackTrace?: string;
+}, config?: SpringProjectsConfig): string;
+//# sourceMappingURL=diagnosis.d.ts.map

package/build/services/diagnosis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosis.d.ts","sourceRoot":"","sources":["../../src/services/diagnosis.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAwB,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEzF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,kBAAkB,EAAE,CAAC;CAClC;AAiJD,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAYpE;AAMD,eAAO,MAAM,eAAe,EAAE,aAAa,EA2K1C,CAAC;AAqDF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAqB9G;AA+BD,wBAAgB,eAAe,CAC7B,KAAK,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EACxE,MAAM,GAAE,oBAA2C,GAClD,MAAM,CA4DR"}