@enokdev/springdocs-mcp 1.2.7 → 1.4.1

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"}